Class NumberSchema

A base class for validation state. Provides methods for chaining.

Subclasses should not override constructors.

Hierarchy (View Summary)

ValueSchema<number>
- NumberSchema

Index

Constructors

constructor

new NumberSchema(currentValidator: Validator<any, any>): NumberSchema
Constructs the first link in a schema chain.
Parameters
- currentValidator: Validator<any, any>
Returns NumberSchema
Inherited from ValueSchema.constructor
- Defined in SchemaBase.ts:51
new NumberSchema(
    currentValidator: Validator<any, any>,
    previousSchema: SchemaBase<any>,
    operation: (
        validatorA: Validator<any>,
        validatorB: Validator<any, any>,
    ) => Validator<number>,
): NumberSchema
Constructs linking to the given previous schema.
Parameters
- currentValidator: Validator<any, any>
- previousSchema: SchemaBase<any>
- operation: (
  validatorA: Validator<any>,
  validatorB: Validator<any, any>,
  ) => Validator<number>
Returns NumberSchema
Inherited from ValueSchema.constructor
- Defined in SchemaBase.ts:60

Properties

__type

__type: Invariant<number> = ...

Enforces T is in an invariant position. This prevents a validator with more strict rules is assigned to a less strict type, which can cause unexpected validation errors.

`Readonly`assert

assert: (
    input: unknown,
    origin?: string,
    path?: readonly string[],
) => asserts input is number = ...

Validates the given input, asserting that the input is type T. If the input is not valid, a ValidationError will be thrown.

Type Declaration

- (
      input: unknown,
      origin?: string,
      path?: readonly string[],
  ): asserts input is number
- Parameters
  - input: unknown
    The input to validate.
  - Optionalorigin: string
    The error origin. ErrorOrigin.API by default.
  - Optionalpath: readonly string[]
    The current field path to this validator.
  Returns asserts input is number
  Returns the input, cast as the validated type T

`Readonly`isValid

isValid: (input: unknown) => input is number = ...

Returns true if the input is valid according to this validator.

Accessors

description

get description(): string
A short description of the validator.

Returns string
Inherited from ValueSchema.description
- Defined in SchemaBase.ts:85

jsonSchema

get jsonSchema(): JsonSchema | undefined
The composed JSON Schema fragment for this schema, including any describe description. Composes through chaining the same way description does; serialize a complete definition with toJsonSchema.

Returns JsonSchema | undefined
Inherited from ValueSchema.jsonSchema
- Defined in SchemaBase.ts:94

options

get options(): { optional: false }
Returns { optional: false }
Inherited from ValueSchema.options
- Defined in SchemaBase.ts:42

`Static`base

get base(): NumberSchema
The base Object validator validating that the input is an object.

Returns NumberSchema
- Defined in NumberSchema.ts:125

Methods

and

and<U>(nextValidator: Validator<U>): ValueSchema<number & U>
Returns a validator that asserts if this validator and the next passes.
Type Parameters
- U
Parameters
- nextValidator: Validator<U>
  The validator to run after the current.
Returns ValueSchema<number & U>
Returns a new ValueSchema intersecting this validator and the next.

See
andValidators
Inherited from ValueSchema.and
- Defined in ValueSchema.ts:91

`Protected`chain

chain(nextValidator: Validator<any, any>): any
Constructs a new schema with a validator chaining the current validator with the provided next in an AND operation.
Parameters
- nextValidator: Validator<any, any>
  The validator to run after the current.
Returns any
Returns a new Schema instance the same class with a new validator chaining the current validator with the given next in an AND operation.
Inherited from ValueSchema.chain
- Defined in SchemaBase.ts:202

`Protected`clone

clone(transform?: (validator: Validator<any>) => Validator<any>): any
Clones this schema, transforming all validators with the given mutator.
Parameters
- transform: (validator: Validator<any>) => Validator<any> = ...
  A transformer which takes an existing validator in the chain and returns a new one. Validators should be considered to be immutable; transform should not change the input but instead return a new validator.
Returns any
Inherited from ValueSchema.clone
- Defined in SchemaBase.ts:150

describe

describe(description: string): this
Attaches a human-readable description to this schema, akin to zod's describe. The description is metadata only; it does not affect validation, and surfaces in the output of toJsonSchema.
Parameters
- description: string
  The description to attach.
Returns this
A clone of this schema carrying the description.
Inherited from ValueSchema.describe
- Defined in SchemaBase.ts:110

finite

finite(): this
Creates a validator that asserts that the input number is finite.

Returns this
- Defined in NumberSchema.ts:185

gt

gt(min: number): this
Creates a validator that asserts that the input number is greater than the provided minimum value.
Parameters
- min: number
  The minimum (exclusive) the value may be.
Returns this
- Defined in NumberSchema.ts:147

gte

gte(min: number): this
Creates a validator that asserts that the input number is at least the provided minimum value.
Parameters
- min: number
  The minimum (inclusive) the value may be.
Returns this
- Defined in NumberSchema.ts:137

lt

lt(max: number): this
Creates a validator that asserts that the input number is less than the provided maximum value.
Parameters
- max: number
  The maximum (exclusive) the value may be.
Returns this
- Defined in NumberSchema.ts:167

lte

lte(max: number): this
Creates a validator that asserts that the input number is at most the provided maximum value.
Parameters
- max: number
  The maximum (inclusive) the value may be.
Returns this
- Defined in NumberSchema.ts:157

maybe

maybe(): ValueSchema<number | null | undefined>
Prepends this validator allowing for null or undefined.

Returns ValueSchema<number | null | undefined>
Inherited from ValueSchema.maybe
- Defined in ValueSchema.ts:65

optional

optional(): PropertyValidatorWithOptions<
    NumberSchema,
    number,
    { optional: true },
>
Returns PropertyValidatorWithOptions<NumberSchema, number, { optional: true }>
Inherited from ValueSchema.optional
- Defined in SchemaBase.ts:206

or

or<U>(nextValidator: Validator<U, any>): ValueSchema<number | U>
Returns a validator that asserts if this validator or the next passes.

Implementation note: subclasses should not change the schema instance returned unless all chainable validators accept input type 'unknown'.
Type Parameters
- U
Parameters
- nextValidator: Validator<U, any>
  The validator to run after the current.
Returns ValueSchema<number | U>
Returns a new ValueSchema providing the union of this validator and the next.
Inherited from ValueSchema.or
- Defined in ValueSchema.ts:105

orNull

orNull(): ValueSchema<number | null>
Prepends this validator allowing for null.

Returns ValueSchema<number | null>
Inherited from ValueSchema.orNull
- Defined in ValueSchema.ts:72

orUndefined

orUndefined(): ValueSchema<number | undefined>
Prepends this validator allowing for undefined.

Returns ValueSchema<number | undefined>
Inherited from ValueSchema.orUndefined
- Defined in ValueSchema.ts:79

required

required(): PropertyValidatorWithOptions<
    NumberSchema,
    number,
    { optional: false },
>
Returns PropertyValidatorWithOptions<NumberSchema, number, { optional: false }>
Inherited from ValueSchema.required
- Defined in SchemaBase.ts:219

safeInteger

safeInteger(): this
Creates a validator that asserts that the input number is a safe integer.

Returns this
- Defined in NumberSchema.ts:192

`Protected`self

self(current: Validator<any, any>): any
Parameters
- current: Validator<any, any>
Returns any
Inherited from ValueSchema.self
- Defined in SchemaBase.ts:165
self(
    currentValidator: Validator<any, any>,
    previousSchema: SchemaBase<any> | undefined,
    operation:
        | (
            (
                validatorA: Validator<any>,
                validatorB: Validator<any, any>,
            ) => Validator<number>
        )
        | undefined,
): any
Parameters
- currentValidator: Validator<any, any>
- previousSchema: SchemaBase<any> | undefined
- operation:
      | (
          (
              validatorA: Validator<any>,
              validatorB: Validator<any, any>,
          ) => Validator<number>
      )
      | undefined
Returns any
Inherited from ValueSchema.self
- Defined in SchemaBase.ts:167

toJsonSchema

toJsonSchema(): JsonSchema
Serializes this schema to a JSON Schema definition, suitable for describing the shape to an LLM or other consumer. Works similarly to zod-to-json-schema.

Returns JsonSchema
Inherited from ValueSchema.toJsonSchema
- Defined in SchemaBase.ts:120

`Readonly`validate

validate(
    input: unknown,
    options?: ValidationOptions,
    path?: readonly string[],
): readonly ValidationErrorMessage[]
Parameters
- input: unknown
  The input to validate.
- Optionaloptions: ValidationOptions
  Validation options.
- Optionalpath: readonly string[]
  The current field path to this validator.
Returns readonly ValidationErrorMessage[]
Returns an array of validation failures. If options.all is not true, only the first error will be returned.
Inherited from ValueSchema.validate
- Defined in SchemaBase.ts:136

within

within(min: number, max: number): this
Creates a validator that asserts that the input number is at least the provided minimum and at most the provided maximum values.
Parameters
- min: number
  The minimum (inclusive) value the input may be.
- max: number
  The maximum (inclusive) value the input may be.
Returns this
- Defined in NumberSchema.ts:178

Class NumberSchema

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns NumberSchema

Parameters

Returns NumberSchema

Properties

__type

Readonlyassert

Type Declaration

Parameters

Returns asserts input is number

ReadonlyisValid

Accessors

description

Returns string

jsonSchema

Returns JsonSchema | undefined

options

Returns { optional: false }

Staticbase

Returns NumberSchema

Methods

and

Type Parameters

Parameters

Returns ValueSchema<number & U>

See

Protectedchain

Parameters

Returns any

Protectedclone

Parameters

Returns any

describe

Parameters

Returns this

finite

Returns this

gt

Parameters

Returns this

gte

Parameters

Returns this

lt

Parameters

Returns this

lte

Parameters

Returns this

maybe

Returns ValueSchema<number | null | undefined>

optional

Returns PropertyValidatorWithOptions<NumberSchema, number, { optional: true }>

or

Type Parameters

Parameters

Returns ValueSchema<number | U>

orNull

Returns ValueSchema<number | null>

orUndefined

Returns ValueSchema<number | undefined>

required

Returns PropertyValidatorWithOptions<NumberSchema, number, { optional: false }>

safeInteger

Returns this

Protectedself

Parameters

Returns any

Parameters

Returns any

toJsonSchema

`Readonly`assert

`Readonly`isValid

`Static`base

`Protected`chain

`Protected`clone

`Protected`self

`Readonly`validate