json-schema-to-zod-openai

A TypeScript library that converts JSON Schema to Zod schema with OpenAI compatibility.

Installation

1npm install json-schema-to-zod-openai

Usage

1import { convertToZodSchema } from 'json-schema-to-zod-openai';
2
3const jsonSchema = {
4  type: 'object',
5  properties: {
6    name: { type: 'string' },
7    age: { type: 'number' },
8    roles: {
9      type: 'array',
10      items: {
11        type: 'string',
12        enum: ['admin', 'user', 'guest']
13      }
14    }
15  },
16  required: ['name']
17};
18
19const zodSchema = convertToZodSchema(jsonSchema);
20
21// Use the schema for validation
22try {
23  const validated = zodSchema.parse({
24    name: 'John Doe',
25    age: 30,
26    roles: ['admin', 'user']
27  });
28  console.log('Valid data:', validated);
29} catch (error) {
30  console.error('Validation error:', error);
31}

Features

• Converts JSON Schema to Zod schema
• Supports OpenAI's schema limitations
• Handles:
  • Basic types (string, number, boolean)
  • Arrays
  • Enums
  • Nullable fields
  • Required fields
  • Object properties
  • Nested objects
  • Additional properties control