Extract valbridge-compatible schema data from existing Zod schemas for high-fidelity Pydantic generation.

Installation

npm install @vectorfyco/valbridge-zod-extractor zod
# or
pnpm add @vectorfyco/valbridge-zod-extractor zod

CLI usage

valbridge-zod-extractor \
  --module-path ./schema/user.js \
  --export-name UserSchema

Output is JSON with:

• schema -- the extracted JSON Schema document
• diagnostics -- compatibility diagnostics for unsupported Zod features or versions

Programmatic usage

import { extractSchema } from "@vectorfyco/valbridge-zod-extractor";
import { z } from "zod";

const UserSchema = z.object({
  id: z.string(),
  email: z.string().email()
});

const result = extractSchema(UserSchema);
console.log(result.schema);

Key behaviors

• Validates the supported Zod version before extraction
• Preserves x-valbridge annotations needed by downstream adapters (Pydantic, future targets)
• Emits diagnostics for Zod features that cannot be represented in JSON Schema

Related packages

| Package | Purpose | | --- | --- | | @vectorfyco/valbridge-zod | Zod adapter (JSON Schema to Zod) | | @vectorfyco/valbridge-core | Core IR and JSON Schema parser | | valbridge-pydantic-extractor | Python equivalent for Pydantic models |

Learn more

• GitHub repository
• Full documentation