dev.jaide.valhalla.core — dev.jaide/valhalla 2025.7.3

-> cljs

Creates a validator that applies multiple validators in sequence.

Arguments:

• validators - A sequence of validator functions to apply in order

Returns a validator function that accepts a context and returns a result. Each validator is applied to the result of the previous validator. If any validator fails, the chain stops and returns the error.

assert cljs

(assert pred?)

(assert pred? opts)

Validates if a value satisfies a predicate function.

Arguments:

• pred? - A predicate function that returns true for valid values

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original value if the predicate returns true.

assert-valid cljs

(assert-valid validator input & {:keys [message]})

Validates input and throws an error if invalid.

Options:

• :message - Custom error message function or string

Returns the validation result if valid

boolean cljs

(boolean)

(boolean opts)

Validates if a value is a boolean.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

chain cljs

(chain & validators)

Creates a validator that applies multiple validators in sequence.

Arguments:

• validators - A sequence of validator functions to apply in order

Returns a validator function that accepts a context and returns a result. Each validator is applied to the result of the previous validator. If any validator fails, the chain stops and returns the error.

date cljs

(date & [opts])

Validates if a value is a valid JavaScript Date object.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original Date object if valid.

date->number cljs

(date->number)

(date->number {:keys [accept-numbers] :as opts})

Converts a JavaScript Date object to a timestamp number.

Options:

• :message - Custom error message function or string
• :accept-numbers - Boolean to accept pre-transformed numbers

Returns a validator function that accepts a context and returns a result with the timestamp (milliseconds since epoch) of the date.

date->string cljs

(date->string)

(date->string {:keys [accept-strings] :as opts})

Converts a JavaScript Date object to an ISO string.

Options:

• :message - Custom error message function or string
• :accept-strings - Boolean to accept pre-transformed, pattern-tested stings.

Returns a validator function that accepts a context and returns a result with the ISO string representation of the date.

default cljs

(default validator default-value-or-fn)

Creates a validator that provides a default value for nil inputs.

Arguments:

• validator - A validator function to apply to non-nil values
• default-value-or-fn - A value or function to use as default for nil values

Returns a validator function that accepts a context and returns a result. If the input is nil, returns the default value or the result of calling the default function with the context.

enum cljs

(enum kws)

(enum kws opts)

Validates if a value is one of a set of keywords.

Arguments:

• kws - A collection of keywords representing valid enum values

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original keyword if it's one of the specified enum values.

error cljs

(error message)

Creates an error result with the given message.

Returns a vector with :v/error status and the error message.

errors cljs

(errors errors)

Creates a result containing multiple errors.

Returns a vector with :v/errors status and a collection of error messages.

errors->string cljs

(errors->string errors)

Formats a list of error hash-maps into a line-separated string

Arguments:

• errors - Sequence of error hash-maps with :path vectors and :message str

Returns a string of all error messages

fail cljs

(fail & {:keys [input errors]})

Creates a failed validation result.

Returns a map with :v/fail status, the input value, and error messages.

hash-map cljs

(hash-map value-validator)

(hash-map key-validator value-validator)

(hash-map key-validator value-validator opts)

Validates if a value is a hash-map with a key and value type.

Arguments:

• key - A key validator function
• value - A value validator function

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a hash-map of unknown size.

instance cljs

(instance class-fn)

(instance class-fn opts)

Validates if a value is an instance of a specific class.

Arguments:

• class-fn - A JavaScript constructor function or class

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original value if it's an instance of the specified class.

keyword cljs

(keyword)

(keyword opts)

Validates if a value is a keyword.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

lazy cljs

(lazy validator-fn & [opts])

Creates a validator that lazily evaluates a validator function.

Arguments:

• validator-fn - A function that returns a validator function

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result. The validator-fn is called to get the actual validator only when needed, which allows for recursive validator definitions.

list cljs

(list validator & [opts])

Validates if a value is a list and validates each element.

Arguments:

• validator - A validator function to apply to each element

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a sequence of validated elements if successful.

list-tuple cljs

(list-tuple validators & [opts])

Validates if a value is a list with specific validators for each position.

Arguments:

• validators - A sequence of validator functions, one for each position

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a sequence of validated elements if successful. The input list must have the same length as the validators sequence.

literal cljs

(literal expected)

(literal expected opts)

Validates if a value equals an expected literal value.

Arguments:

• expected - The exact value to match against

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original value if it equals the expected value.

nil-value cljs

(nil-value)

(nil-value opts)

Validates if a value is nil.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

nilable cljs

(nilable validator)

Creates a validator that allows nil values or validates non-nil values.

Arguments:

• validator - A validator function to apply to non-nil values

Returns a validator function that accepts a context and returns a result with nil for nil values or the result of applying the validator to non-nil values.

number cljs

(number)

(number opts)

Validates if a value is a number.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

number->date cljs

(number->date)

(number->date {:keys [accept-dates] :as opts})

Converts a number (timestamp) to a JavaScript Date object.

Options:

• :message - Custom error message function or string
• :accept-dates - Boolean to accept pre-transformed, valid dates

Returns a validator function that accepts a context and returns a result with a Date object if the number represents a valid timestamp.

numeric cljs

(numeric)

(numeric opts)

Validates if a value can be parsed as a number.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result. The original string value is returned if valid.

ok cljs

(ok value)

Creates a success result with the given value.

Returns a vector with :v/ok status and the value.

ok? cljs

(ok? [status _value])

Checks if a result is successful.

Returns true if the result has :v/ok status, false otherwise.

parse cljs

(parse validator input & {:keys [_message] :as opts})

Validates input and throws an error if invalid.

Options:

• :message - Custom error message function or string

Returns the parsed result if valid

pass cljs

(pass & {:keys [input output]})

Creates a successful validation result.

Returns a map with :v/pass status and the input and output values.

record cljs

(record validators-map & [opts])

Validates if a value is a hash-map and validates specific keys.

Arguments:

• validators-map - A hash-map of keys to validator functions

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a map of validated key-value pairs if successful.

regex cljs

(regex regex-str)

(regex regex-str opts)

Validates if a string matches a regular expression pattern.

Arguments:

• regex-str - The regular expression pattern as a string

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original string if it matches the pattern.

result-case cljs

(result-case [status val-or-msg]
             &
             {:keys [ok err errs ctx]
              :or {ok identity err identity errs identity ctx identity}})

Pattern matches on a validation result and applies the appropriate handler function.

Takes a result vector [status value] and handler functions for each possible status. Returns the result of applying the matching handler to the value.

set cljs

(set validator & [opts])

Validates if a value is a set and validates each element.

Arguments:

• validator - A validator function to apply to each element

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a set of validated elements if successful.

string cljs

(string)

(string opts)

Validates if a value is a string.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

string->boolean cljs

(string->boolean)

(string->boolean {:keys [accept-booleans] :as opts})

Converts a string ('true' or 'false') to a boolean.

Options:

• :message - Custom error message function or string
• :accept-booleans - Boolean to accept pre-transformed values

Returns a validator function that accepts a context and returns a result with the parsed boolean value if successful.

string->date cljs

(string->date)

(string->date {:keys [accept-dates] :as opts})

Converts a string to a JavaScript Date object.

Options:

• :message - Custom error message function or string
• :accept-dates - Boolean to accept pre-transformed, valid dates

Returns a validator function that accepts a context and returns a result with a Date object if the string can be parsed as a valid date.

string->keyword cljs

(string->keyword)

(string->keyword {:keys [accept-keywords] :as opts})

Converts a string to a keyword.

Options:

• :message - Custom error message function or string
• :accept-keywords - Boolean to accept pre-transformed keywords

Returns a validator function that accepts a context and returns a result with the converted keyword if successful.

string->number cljs

(string->number)

(string->number {:keys [accept-numbers] :as opts})

Converts a string to a number.

Options:

• :message - Custom error message function or string
• :accept-numbers - Boolean to accept pre-transformed numbers

Returns a validator function that accepts a context and returns a result with the parsed number value if successful.

string->symbol cljs

(string->symbol)

(string->symbol {:keys [accept-symbols] :as opts})

Converts a string to a symbol.

Options:

• :message - Custom error message function or string
• :accept-symbols - Boolean to accept pre-transformed symbols

Returns a validator function that accepts a context and returns a result with the converted symbol if successful. The string must match the pattern for valid symbols (starting with a letter followed by valid characters).

symbol cljs

(symbol)

(symbol opts)

Validates if a value is a symbol.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result.

union cljs

(union & validators)

Creates a validator that tries multiple validators and succeeds if any one succeeds.

Arguments:

• validators - A sequence of validator functions to try

Returns a validator function that accepts a context and returns a result. Each validator is tried in order until one succeeds. If all validators fail, returns the errors from the last validator.

uuid cljs

(uuid)

(uuid opts)

Validates if a string is a valid UUID.

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with the original UUID string if valid.

valid? cljs

(valid? result)

Checks if a validation result is successful.

Returns true if the result has :v/pass status, false otherwise.

validate cljs

(validate validator-fn input & [opts])

Validates an input value using the provided validator function.

Creates a validation context with the input, applies the validator, and returns a validation result map (pass or fail).

vector cljs

(vector validator & [opts])

Applies a validator to every item in a vector

Arguments:

• validator - A validator function to apply to each element

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a vector of validated elements if successful.

vector-tuple cljs

(vector-tuple validators & [opts])

Validates if a value is a vector with specific validators for each position.

Arguments:

• validators - A vector of validator functions, one for each position

Options:

• :message - Custom error message function or string

Returns a validator function that accepts a context and returns a result with a vector of validated elements if successful. The input vector must have the same length as the validators vector.