Core intermediate-representation types, diagnostics, and parsing utilities for the valbridge toolchain.

Installation

npm install @vectorfyco/valbridge-core
# or
pnpm add @vectorfyco/valbridge-core

What it provides

• JSON Schema parser -- entry points parse, parseSchema, and parseEnriched convert JSON Schema into the valbridge IR
• Cross-language conversion core -- shared parsing and IR utilities that power Zod <-> Pydantic generation
• IR node types -- shared intermediate-representation types used by all adapters (Zod, Pydantic, and future targets)
• Diagnostics -- structured diagnostic codes for cross-runtime fidelity reporting
• Adapter CLI helpers -- stdin/stdout protocol utilities for adapter processes

Usage

import { parseSchema } from "@vectorfyco/valbridge-core";

const schema = {
  type: "object",
  properties: {
    id: { type: "string", format: "uuid" },
    enabled: { type: "boolean" }
  },
  required: ["id"]
};

const node = parseSchema(schema);

Enriched parsing (with x-valbridge metadata)

import { parseEnriched } from "@vectorfyco/valbridge-core";

const schema = {
  type: "string",
  "x-valbridge": {
    version: "1.0",
    coercionMode: "strict",
    transforms: ["trim"]
  }
};

const node = parseEnriched(schema);

Related packages

| Package | Purpose | | --- | --- | | @vectorfyco/valbridge | Runtime client for generated TypeScript validators | | @vectorfyco/valbridge-zod | Render valbridge IR into Zod validators | | @vectorfyco/valbridge-zod-extractor | Extract JSON Schema from existing Zod schemas |

Learn more

• GitHub repository
• Full documentation