Home/Tools/@tpmjs/tools-json-schema-validate

jsonSchemaValidateTool

@tpmjs/tools-json-schema-validate

Validates JSON data against a JSON Schema specification using the ajv validator. Returns validation status, detailed errors, and error count. Supports JSON Schema Draft 7 and common formats (email, uri, date-time, etc.).

Official
data
v0.2.0
MIT

Interactive Playground

Test @tpmjs/tools-json-schema-validate (jsonSchemaValidateTool) with AI-powered execution

0/2000 characters

Installation & Usage

Install this tool and use it with the AI SDK

1. Install the package

npm install @tpmjs/tools-json-schema-validate
pnpm add @tpmjs/tools-json-schema-validate
yarn add @tpmjs/tools-json-schema-validate
bun add @tpmjs/tools-json-schema-validate
deno add npm:@tpmjs/tools-json-schema-validate

2. Import the tool

import { jsonSchemaValidateTool } from '@tpmjs/tools-json-schema-validate';

3. Use with AI SDK

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { jsonSchemaValidateTool } from '@tpmjs/tools-json-schema-validate';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { jsonSchemaValidateTool },
  prompt: 'Your prompt here...',
});

console.log(result.text);

Parameters

Available configuration options

Auto-extracted
data
Required
Type: object

The data to validate (can be any JSON value: object, array, string, etc.)

schema
Required
Type: object

JSON Schema object defining the expected structure and validation rules (Draft 7 compatible)

Schema extracted: 1/1/2026, 8:18:32 AM

README

@tpmjs/tools-json-schema-validate

Validates JSON data against JSON Schema using the ajv validator.

Installation

npm install @tpmjs/tools-json-schema-validate

Usage

import { jsonSchemaValidateTool } from '@tpmjs/tools-json-schema-validate';

const result = await jsonSchemaValidateTool.execute({
  data: {
    name: 'John Doe',
    email: 'john@example.com',
    age: 30,
  },
  schema: {
    type: 'object',
    properties: {
      name: { type: 'string', minLength: 1 },
      email: { type: 'string', format: 'email' },
      age: { type: 'number', minimum: 0, maximum: 120 },
    },
    required: ['name', 'email'],
    additionalProperties: false,
  },
});

console.log(result);
// {
//   valid: true,
//   errors: [],
//   errorCount: 0
// }

Validation Failure Example

const result = await jsonSchemaValidateTool.execute({
  data: {
    name: '',
    email: 'invalid-email',
    age: 150,
  },
  schema: {
    type: 'object',
    properties: {
      name: { type: 'string', minLength: 1 },
      email: { type: 'string', format: 'email' },
      age: { type: 'number', minimum: 0, maximum: 120 },
    },
    required: ['name', 'email'],
  },
});

console.log(result);
// {
//   valid: false,
//   errors: [
//     {
//       path: '/name',
//       message: 'String length must be >= 1',
//       keyword: 'minLength',
//       params: { limit: 1 }
//     },
//     {
//       path: '/email',
//       message: 'Invalid email format',
//       keyword: 'format',
//       params: { format: 'email' }
//     },
//     {
//       path: '/age',
//       message: 'Value must be <= 120',
//       keyword: 'maximum',
//       params: { limit: 120 }
//     }
//   ],
//   errorCount: 3
// }

Parameters

  • data (required): The JSON data to validate (any valid JSON type)
  • schema (required): JSON Schema object defining validation rules

Supported JSON Schema Features

  • Type validation: string, number, integer, boolean, object, array, null
  • String validation: minLength, maxLength, pattern, format
  • Number validation: minimum, maximum, multipleOf
  • Object validation: properties, required, additionalProperties
  • Array validation: items, minItems, maxItems, uniqueItems
  • Common formats: email, uri, date-time, date, time, ipv4, ipv6, uuid

Output Format

Returns a ValidationResult object with:

  • valid: true if data passes validation, false otherwise
  • errors: Array of validation errors (empty if valid)
  • errorCount: Number of validation errors

Each error includes:

  • path: JSON pointer to the invalid field (e.g., /user/email)
  • message: Human-readable error message
  • keyword: JSON Schema keyword that failed (e.g., required, type)
  • params: Additional error parameters

Advanced Examples

Validating Arrays

const result = await jsonSchemaValidateTool.execute({
  data: [1, 2, 3, 4, 5],
  schema: {
    type: 'array',
    items: { type: 'number' },
    minItems: 1,
    maxItems: 10,
  },
});

Nested Objects

const result = await jsonSchemaValidateTool.execute({
  data: {
    user: {
      name: 'Alice',
      address: {
        city: 'New York',
        zip: '10001',
      },
    },
  },
  schema: {
    type: 'object',
    properties: {
      user: {
        type: 'object',
        properties: {
          name: { type: 'string' },
          address: {
            type: 'object',
            properties: {
              city: { type: 'string' },
              zip: { type: 'string', pattern: '^[0-9]{5}$' },
            },
            required: ['city', 'zip'],
          },
        },
        required: ['name', 'address'],
      },
    },
    required: ['user'],
  },
});

Enum Validation

const result = await jsonSchemaValidateTool.execute({
  data: { status: 'active' },
  schema: {
    type: 'object',
    properties: {
      status: {
        type: 'string',
        enum: ['active', 'inactive', 'pending'],
      },
    },
  },
});

Features

  • Powered by ajv - the fastest JSON Schema validator
  • Supports JSON Schema Draft 7
  • Built-in format validators (email, uri, date-time, etc.)
  • Detailed error messages with path information
  • Type-safe with TypeScript
  • All errors collected (not just first failure)

Error Handling

If the schema itself is invalid, the tool throws an error:

try {
  const result = await jsonSchemaValidateTool.execute({
    data: {},
    schema: { type: 'invalid-type' }, // Invalid schema
  });
} catch (error) {
  console.error(error.message);
  // "Invalid JSON Schema: ..."
}

License

MIT

Statistics

Downloads/month

0

Quality Score

0%

Bundle Size

NPM Keywords

tpmjs
data
validation
json-schema
ajv

Maintainers

thomasdavis(thomasalwyndavis@gmail.com)

Frameworks

vercel-ai
jsonSchemaValidateTool | TPMJS | TPMJS