Guardian

Data guard and validation library. Validate user input with Guardian.

Install

1npm i @olton/guardian

Using

1import {parse, string, required, email, object} from "@olton/guardian"
2
3const schema = string()
4let value = parse(schema, "123")
5
6console.log(value); // -> 123
7
8let value = parse(schema, 123) // -> throw error
9
10
11let value = safeParse(schema, 123) // -> return obj with error
12if (!value.ok) {
13    console.log(value.error)
14}
15
16let value = safeParse(schema, "123") // -> return obj with data
17if (value.ok) {
18    console.log(value.output)
19}
20
21let schema = object({
22    name: pipe(required("Name Required"), string()),
23    email: pipe(string(), email("Please enter a valid email address"))
24})
25
26const res0 = parse(schema, {
27    name: "Vasya Pupkin",
28    email: "vasya@pupkin.com"
29}) // -> Ok
30
31const res1 = parse(schema, {
32    name: "",
33    email: "vasya@pupkin.com"
34}) // -> Error "Name Required"
35
36const res2 = parse(schema, {
37    name: "Serhii Pimenov",
38    email: "vasya_pupkin.com"
39}) // -> Error "Please enter a valid email address"
40
41

Parsing

• parse - Throw error when invalid data
• safeParse - Return special object with .output when all ok, and .error when invalid data

Pipes

• pipe - run guarders left to right
• compose - run guarders right to left

1import {pipe, string, email} from "@olton/guardian"
2
3const scheme1 = pipe(string(), email()) // left to right
4const scheme2 = compose(email(), string()) // right to left

Create a simple schema

1import {parse, object, visa, mastercard, string, email} from "@olton/guardian"
2
3const schema1 = string()
4const data1 = parse(schema1, "123")
5
6const schema2 = pipe(required(), email())
7const data2 = parse(schema2, "vasya@pupkin.com")

Create complex schema

1import {parse, object, visa, mastercard, string, email} from "@olton/guardian"
2
3const schema = object({
4    name: string(),
5    email: email(),
6    cards: object({
7        visa: visa(),
8        mastercard: mastercard()
9    })
10})
11
12const data = parse(schema, {...})

Guardians

• array
• base64
• between
• bigint
• boolean
• bytes
• creditCard (visa, mastercard, discover, jbc, diners, unionPay, americanExpress)
• date
• digits
• domain
• email
• empty
• endsWith
• finite
• float
• func
• hexColor
• imei
• instance
• integer
• ip (ipv4, ipv6)
• length
• maxValue
• minValue
• notNull
• notNumber
• number
• pattern
• promise
• required
• safeInteger
• startsWith
• string
• symbol
• unknown
• url