Class AjvValidator

Example

import { DIContainer } from '@famir/common'
import {
  VALIDATOR,
  Validator,
  AjvValidator,
  ValidatorError,
  JSONSchemaType,
} from '@famir/validator'

// Get the container singleton.
const container = DIContainer.getInstance()

// Register dependency in container
AjvValidator.register(container)

// Resolve dependency from container
const validator = container.resolve<Validator>(VALIDATOR)

// Define your user interface
interface User {
  name: string
  age: number
}

// Define your user schema
const userSchema: JSONSchemaType<User> = {
  type: 'object',
  required: ['name', 'age'],
  properties: {
    name: { type: 'string' },
    age: { type: 'number', minimum: 0 }
  },
  additionalProperties: false,
} as const

// Add schema to validator
validator.addSchema('user', userSchema)

// Any data to validate
const data: unknown = { name: 'John', age: 30 }

// Type-safe guard validation
if (validator.guardSchema<User>('user', data)) {
  // TypeScript knows this is User
  console.log(data.name)
} else {
  console.warn('Invalid user data')
}

// Type-safe assert validation with exception filter
try {
  validator.assertSchema<User>('user', data)
  // TypeScript knows this is User
  console.log(data.age)
} catch (error) {
  if (error instanceof ValidatorError) {
    console.warn(error.validateErrors)
  } else {
    console.error(error)
  }
}
Copy