@bram-dc/fastify-type-provider-zod 5.0.0 → 5.0.3

package/dist/cjs/zod-to-json.cjs

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("zod/v4/core");
+const getSchemaId = (id, io) => {
+  return io === "input" ? `${id}Input` : id;
+};
+const getReferenceUri = (id, io) => {
+  return `#/components/schemas/${getSchemaId(id, io)}`;
+};
+function isZodDate(entity) {
+  return entity instanceof core.$ZodType && entity._zod.def.type === "date";
+}
+function isZodUnion(entity) {
+  return entity instanceof core.$ZodType && entity._zod.def.type === "union";
+}
+function isZodUndefined(entity) {
+  return entity instanceof core.$ZodType && entity._zod.def.type === "undefined";
+}
+const getOverride = (ctx, io) => {
+  if (isZodUnion(ctx.zodSchema)) {
+    ctx.jsonSchema.anyOf = ctx.jsonSchema.anyOf?.filter((schema) => Object.keys(schema).length > 0);
+  }
+  if (isZodDate(ctx.zodSchema)) {
+    if (io === "output") {
+      ctx.jsonSchema.type = "string";
+      ctx.jsonSchema.format = "date-time";
+    }
+  }
+  if (isZodUndefined(ctx.zodSchema)) {
+    if (io === "output") {
+      ctx.jsonSchema.type = "null";
+    }
+  }
+};
+const zodSchemaToJson = (zodSchema, registry, io) => {
+  const schemaRegistryEntry = registry.get(zodSchema);
+  if (schemaRegistryEntry?.id) {
+    return {
+      $ref: getReferenceUri(schemaRegistryEntry.id, io)
+    };
+  }
+  const tempID = "GEN";
+  const tempRegistry = new core.$ZodRegistry();
+  tempRegistry.add(zodSchema, { id: tempID });
+  const {
+    schemas: { [tempID]: result }
+  } = core.toJSONSchema(tempRegistry, {
+    target: "draft-2020-12",
+    metadata: registry,
+    io,
+    unrepresentable: "any",
+    cycles: "ref",
+    reused: "inline",
+    /**
+     * The uri option only allows customizing the base path of the `$ref`, and it automatically appends a path to it.
+     * As a workaround, we set a placeholder that looks something like this:
+     *
+     * |       marker          | always added by zod | meta.id |
+     * |__SCHEMA__PLACEHOLDER__|      #/$defs/       | User    |
+     *
+     * @example `__SCHEMA__PLACEHOLDER__#/$defs/User"`
+     * @example `__SCHEMA__PLACEHOLDER__#/$defs/Group"`
+     *
+     * @see jsonSchemaReplaceRef
+     * @see https://github.com/colinhacks/zod/issues/4750
+     */
+    uri: () => `__SCHEMA__PLACEHOLDER__`,
+    override: (ctx) => getOverride(ctx, io)
+  });
+  const jsonSchema = { ...result };
+  delete jsonSchema.id;
+  const jsonSchemaReplaceRef = JSON.stringify(jsonSchema).replaceAll(
+    /"__SCHEMA__PLACEHOLDER__#\/\$defs\/(.+?)"/g,
+    (_, id) => `"${getReferenceUri(id, io)}"`
+  );
+  return JSON.parse(jsonSchemaReplaceRef);
+};
+const zodRegistryToJson = (registry, io) => {
+  const result = core.toJSONSchema(registry, {
+    target: "draft-2020-12",
+    io,
+    unrepresentable: "any",
+    cycles: "ref",
+    reused: "inline",
+    uri: (id) => getReferenceUri(id, io),
+    override: (ctx) => getOverride(ctx, io)
+  }).schemas;
+  const jsonSchemas = {};
+  for (const id in result) {
+    const jsonSchema = { ...result[id] };
+    delete jsonSchema.id;
+    jsonSchemas[getSchemaId(id, io)] = jsonSchema;
+  }
+  return jsonSchemas;
+};
+exports.zodRegistryToJson = zodRegistryToJson;
+exports.zodSchemaToJson = zodSchemaToJson;
+//# sourceMappingURL=zod-to-json.cjs.map

package/dist/cjs/zod-to-json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.cjs","sources":["../../src/zod-to-json.ts"],"sourcesContent":["import type { $ZodDate, $ZodUndefined, $ZodUnion, JSONSchema } from 'zod/v4/core'\nimport { $ZodRegistry, $ZodType, toJSONSchema } from 'zod/v4/core'\n\nconst getSchemaId = (id: string, io: 'input' | 'output') => {\n  return io === 'input' ? `${id}Input` : id\n}\n\nconst getReferenceUri = (id: string, io: 'input' | 'output') => {\n  return `#/components/schemas/${getSchemaId(id, io)}`\n}\n\nfunction isZodDate(entity: unknown): entity is $ZodDate {\n  return entity instanceof $ZodType && entity._zod.def.type === 'date'\n}\n\nfunction isZodUnion(entity: unknown): entity is $ZodUnion {\n  return entity instanceof $ZodType && entity._zod.def.type === 'union'\n}\n\nfunction isZodUndefined(entity: unknown): entity is $ZodUndefined {\n  return entity instanceof $ZodType && entity._zod.def.type === 'undefined'\n}\n\nconst getOverride = (\n  ctx: {\n    zodSchema: $ZodType\n    jsonSchema: JSONSchema.BaseSchema\n  },\n  io: 'input' | 'output',\n) => {\n  if (isZodUnion(ctx.zodSchema)) {\n    // Filter unrepresentable types in unions\n    // TODO: Should be fixed upstream and not merged in this plugin.\n    // Remove when passed: https://github.com/colinhacks/zod/pull/5013\n    ctx.jsonSchema.anyOf = ctx.jsonSchema.anyOf?.filter((schema) => Object.keys(schema).length > 0)\n  }\n\n  if (isZodDate(ctx.zodSchema)) {\n    // Allow dates to be represented as strings in output schemas\n    if (io === 'output') {\n      ctx.jsonSchema.type = 'string'\n      ctx.jsonSchema.format = 'date-time'\n    }\n  }\n\n  if (isZodUndefined(ctx.zodSchema)) {\n    // Allow undefined to be represented as null in output schemas\n    if (io === 'output') {\n      ctx.jsonSchema.type = 'null'\n    }\n  }\n}\n\nexport const zodSchemaToJson: (\n  zodSchema: $ZodType,\n  registry: $ZodRegistry<{ id?: string }>,\n  io: 'input' | 'output',\n) => JSONSchema.BaseSchema = (zodSchema, registry, io) => {\n  const schemaRegistryEntry = registry.get(zodSchema)\n\n  /**\n   * Checks whether the provided schema is registered in the given registry.\n   * If it is present and has an `id`, it can be referenced as component.\n   *\n   * @see https://github.com/turkerdev/fastify-type-provider-zod/issues/173\n   */\n  if (schemaRegistryEntry?.id) {\n    return {\n      $ref: getReferenceUri(schemaRegistryEntry.id, io),\n    }\n  }\n\n  /**\n   * Unfortunately, at the time of writing, there is no way to generate a schema with `$ref`\n   * using `toJSONSchema` and a zod schema.\n   *\n   * As a workaround, we create a zod registry containing only the specific schema we want to convert.\n   *\n   * @see https://github.com/colinhacks/zod/issues/4281\n   */\n  const tempID = 'GEN'\n  const tempRegistry = new $ZodRegistry<{ id?: string }>()\n  tempRegistry.add(zodSchema, { id: tempID })\n\n  const {\n    schemas: { [tempID]: result },\n  } = toJSONSchema(tempRegistry, {\n    target: 'draft-2020-12',\n    metadata: registry,\n    io,\n    unrepresentable: 'any',\n    cycles: 'ref',\n    reused: 'inline',\n\n    /**\n     * The uri option only allows customizing the base path of the `$ref`, and it automatically appends a path to it.\n     * As a workaround, we set a placeholder that looks something like this:\n     *\n     * |       marker          | always added by zod | meta.id |\n     * |__SCHEMA__PLACEHOLDER__|      #/$defs/       | User    |\n     *\n     * @example `__SCHEMA__PLACEHOLDER__#/$defs/User\"`\n     * @example `__SCHEMA__PLACEHOLDER__#/$defs/Group\"`\n     *\n     * @see jsonSchemaReplaceRef\n     * @see https://github.com/colinhacks/zod/issues/4750\n     */\n    uri: () => `__SCHEMA__PLACEHOLDER__`,\n    override: (ctx) => getOverride(ctx, io),\n  })\n\n  const jsonSchema = { ...result }\n  delete jsonSchema.id\n\n  /**\n   * Replace the previous generated placeholders with the final `$ref` value\n   */\n  const jsonSchemaReplaceRef = JSON.stringify(jsonSchema).replaceAll(\n    /\"__SCHEMA__PLACEHOLDER__#\\/\\$defs\\/(.+?)\"/g,\n    (_, id) => `\"${getReferenceUri(id, io)}\"`,\n  )\n\n  return JSON.parse(jsonSchemaReplaceRef) as typeof result\n}\n\nexport const zodRegistryToJson: (\n  registry: $ZodRegistry<{ id?: string }>,\n  io: 'input' | 'output',\n) => Record<string, JSONSchema.BaseSchema> = (registry, io) => {\n  const result = toJSONSchema(registry, {\n    target: 'draft-2020-12',\n    io,\n    unrepresentable: 'any',\n    cycles: 'ref',\n    reused: 'inline',\n    uri: (id) => getReferenceUri(id, io),\n    override: (ctx) => getOverride(ctx, io),\n  }).schemas\n\n  const jsonSchemas: Record<string, JSONSchema.BaseSchema> = {}\n  for (const id in result) {\n    const jsonSchema = { ...result[id] }\n\n    delete jsonSchema.id\n\n    jsonSchemas[getSchemaId(id, io)] = jsonSchema\n  }\n\n  return jsonSchemas\n}\n"],"names":["$ZodType","$ZodRegistry","toJSONSchema"],"mappings":";;;AAGA,MAAM,cAAc,CAAC,IAAY,OAA2B;AAC1D,SAAO,OAAO,UAAU,GAAG,EAAE,UAAU;AACzC;AAEA,MAAM,kBAAkB,CAAC,IAAY,OAA2B;AAC9D,SAAO,wBAAwB,YAAY,IAAI,EAAE,CAAC;AACpD;AAEA,SAAS,UAAU,QAAqC;AACtD,SAAO,kBAAkBA,KAAAA,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,SAAS,WAAW,QAAsC;AACxD,SAAO,kBAAkBA,KAAAA,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,SAAS,eAAe,QAA0C;AAChE,SAAO,kBAAkBA,KAAAA,YAAY,OAAO,KAAK,IAAI,SAAS;AAChE;AAEA,MAAM,cAAc,CAClB,KAIA,OACG;AACH,MAAI,WAAW,IAAI,SAAS,GAAG;AAI7B,QAAI,WAAW,QAAQ,IAAI,WAAW,OAAO,OAAO,CAAC,WAAW,OAAO,KAAK,MAAM,EAAE,SAAS,CAAC;AAAA,EAChG;AAEA,MAAI,UAAU,IAAI,SAAS,GAAG;AAE5B,QAAI,OAAO,UAAU;AACnB,UAAI,WAAW,OAAO;AACtB,UAAI,WAAW,SAAS;AAAA,IAC1B;AAAA,EACF;AAEA,MAAI,eAAe,IAAI,SAAS,GAAG;AAEjC,QAAI,OAAO,UAAU;AACnB,UAAI,WAAW,OAAO;AAAA,IACxB;AAAA,EACF;AACF;AAEO,MAAM,kBAIgB,CAAC,WAAW,UAAU,OAAO;AACxD,QAAM,sBAAsB,SAAS,IAAI,SAAS;AAQlD,MAAI,qBAAqB,IAAI;AAC3B,WAAO;AAAA,MACL,MAAM,gBAAgB,oBAAoB,IAAI,EAAE;AAAA,IAAA;AAAA,EAEpD;AAUA,QAAM,SAAS;AACf,QAAM,eAAe,IAAIC,kBAAA;AACzB,eAAa,IAAI,WAAW,EAAE,IAAI,QAAQ;AAE1C,QAAM;AAAA,IACJ,SAAS,EAAE,CAAC,MAAM,GAAG,OAAA;AAAA,EAAO,IAC1BC,KAAAA,aAAa,cAAc;AAAA,IAC7B,QAAQ;AAAA,IACR,UAAU;AAAA,IACV;AAAA,IACA,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAeR,KAAK,MAAM;AAAA,IACX,UAAU,CAAC,QAAQ,YAAY,KAAK,EAAE;AAAA,EAAA,CACvC;AAED,QAAM,aAAa,EAAE,GAAG,OAAA;AACxB,SAAO,WAAW;AAKlB,QAAM,uBAAuB,KAAK,UAAU,UAAU,EAAE;AAAA,IACtD;AAAA,IACA,CAAC,GAAG,OAAO,IAAI,gBAAgB,IAAI,EAAE,CAAC;AAAA,EAAA;AAGxC,SAAO,KAAK,MAAM,oBAAoB;AACxC;AAEO,MAAM,oBAGgC,CAAC,UAAU,OAAO;AAC7D,QAAM,SAASA,KAAAA,aAAa,UAAU;AAAA,IACpC,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB;AAAA,IACjB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,KAAK,CAAC,OAAO,gBAAgB,IAAI,EAAE;AAAA,IACnC,UAAU,CAAC,QAAQ,YAAY,KAAK,EAAE;AAAA,EAAA,CACvC,EAAE;AAEH,QAAM,cAAqD,CAAA;AAC3D,aAAW,MAAM,QAAQ;AACvB,UAAM,aAAa,EAAE,GAAG,OAAO,EAAE,EAAA;AAEjC,WAAO,WAAW;AAElB,gBAAY,YAAY,IAAI,EAAE,CAAC,IAAI;AAAA,EACrC;AAEA,SAAO;AACT;;;"}

package/dist/cjs/zod-to-json.d.cts

@@ -0,0 +1,8 @@
+import type { JSONSchema } from "zod/v4/core";
+import { $ZodRegistry, $ZodType } from "zod/v4/core";
+export declare const zodSchemaToJson: (zodSchema: $ZodType, registry: $ZodRegistry<{
+	id?: string;
+}>, io: "input" | "output") => JSONSchema.BaseSchema;
+export declare const zodRegistryToJson: (registry: $ZodRegistry<{
+	id?: string;
+}>, io: "input" | "output") => Record<string, JSONSchema.BaseSchema>;

package/dist/esm/core.d.ts

@@ -0,0 +1,68 @@
+import type { SwaggerTransform, SwaggerTransformObject } from "@fastify/swagger";
+import type { FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions, FastifySchema, FastifySchemaCompiler, FastifyTypeProvider, RawServerBase, RawServerDefault } from "fastify";
+import type { FastifySerializerCompiler } from "fastify/types/schema";
+import type { $ZodRegistry, input, output } from "zod/v4/core";
+import { $ZodType } from "zod/v4/core";
+export interface ZodTypeProvider extends FastifyTypeProvider {
+	validator: this["schema"] extends $ZodType ? output<this["schema"]> : unknown;
+	serializer: this["schema"] extends $ZodType ? input<this["schema"]> : unknown;
+}
+interface Schema extends FastifySchema {
+	hide?: boolean;
+}
+type CreateJsonSchemaTransformOptions = {
+	skipList?: readonly string[];
+	schemaRegistry?: $ZodRegistry<{
+		id?: string | undefined;
+	}>;
+};
+export declare const createJsonSchemaTransform: ({ skipList, schemaRegistry }: CreateJsonSchemaTransformOptions) => SwaggerTransform<Schema>;
+export declare const jsonSchemaTransform: SwaggerTransform<Schema>;
+type CreateJsonSchemaTransformObjectOptions = {
+	schemaRegistry?: $ZodRegistry<{
+		id?: string | undefined;
+	}>;
+};
+export declare const createJsonSchemaTransformObject: ({ schemaRegistry }: CreateJsonSchemaTransformObjectOptions) => SwaggerTransformObject;
+export declare const jsonSchemaTransformObject: SwaggerTransformObject;
+export declare const validatorCompiler: FastifySchemaCompiler<$ZodType>;
+type ReplacerFunction = (this: any, key: string, value: any) => any;
+export type ZodSerializerCompilerOptions = {
+	replacer?: ReplacerFunction;
+};
+export declare const createSerializerCompiler: (options?: ZodSerializerCompilerOptions) => FastifySerializerCompiler<$ZodType | {
+	properties: $ZodType;
+}>;
+export declare const serializerCompiler: ReturnType<typeof createSerializerCompiler>;
+/**
+* FastifyPluginCallbackZod with Zod automatic type inference
+*
+* @example
+* ```typescript
+* import { FastifyPluginCallbackZod } from "fastify-type-provider-zod"
+*
+* const plugin: FastifyPluginCallbackZod = (fastify, options, done) => {
+*   done()
+* }
+* ```
+*/
+export type FastifyPluginCallbackZod<
+	Options extends FastifyPluginOptions = Record<never, never>,
+	Server extends RawServerBase = RawServerDefault
+> = FastifyPluginCallback<Options, Server, ZodTypeProvider>;
+/**
+* FastifyPluginAsyncZod with Zod automatic type inference
+*
+* @example
+* ```typescript
+* import { FastifyPluginAsyncZod } from "fastify-type-provider-zod"
+*
+* const plugin: FastifyPluginAsyncZod = async (fastify, options) => {
+* }
+* ```
+*/
+export type FastifyPluginAsyncZod<
+	Options extends FastifyPluginOptions = Record<never, never>,
+	Server extends RawServerBase = RawServerDefault
+> = FastifyPluginAsync<Options, Server, ZodTypeProvider>;
+export {};

package/dist/esm/core.js

@@ -0,0 +1,137 @@
+import { globalRegistry, safeParse, $ZodType } from "zod/v4/core";
+import { ResponseSerializationError, createValidationError, InvalidSchemaError } from "./errors.js";
+import { getOASVersion, jsonSchemaToOAS } from "./json-to-oas.js";
+import { zodSchemaToJson, zodRegistryToJson } from "./zod-to-json.js";
+const defaultSkipList = [
+  "/documentation/",
+  "/documentation/initOAuth",
+  "/documentation/json",
+  "/documentation/uiConfig",
+  "/documentation/yaml",
+  "/documentation/*",
+  "/documentation/static/*"
+];
+const createJsonSchemaTransform = ({
+  skipList = defaultSkipList,
+  schemaRegistry = globalRegistry
+}) => {
+  return (input) => {
+    if ("swaggerObject" in input) {
+      throw new Error("OpenAPI 2.0 is not supported");
+    }
+    const { schema, url } = input;
+    if (!schema) {
+      return {
+        schema,
+        url
+      };
+    }
+    const { response, headers, querystring, body, params, hide, ...rest } = schema;
+    const transformed = {};
+    if (skipList.includes(url) || hide) {
+      transformed.hide = true;
+      return { schema: transformed, url };
+    }
+    const zodSchemas = { headers, querystring, body, params };
+    const oasVersion = getOASVersion(input);
+    for (const prop in zodSchemas) {
+      const zodSchema = zodSchemas[prop];
+      if (zodSchema) {
+        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, "input");
+        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion);
+        transformed[prop] = oasSchema;
+      }
+    }
+    if (response) {
+      transformed.response = {};
+      for (const prop in response) {
+        const zodSchema = resolveSchema(response[prop]);
+        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, "output");
+        if (jsonSchema.type === "null") {
+          transformed.response[prop] = jsonSchema;
+          continue;
+        }
+        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion);
+        transformed.response[prop] = oasSchema;
+      }
+    }
+    for (const prop in rest) {
+      const meta = rest[prop];
+      if (meta) {
+        transformed[prop] = meta;
+      }
+    }
+    return { schema: transformed, url };
+  };
+};
+const jsonSchemaTransform = createJsonSchemaTransform({});
+const createJsonSchemaTransformObject = ({
+  schemaRegistry = globalRegistry
+}) => (input) => {
+  if ("swaggerObject" in input) {
+    throw new Error("OpenAPI 2.0 is not supported");
+  }
+  const oasVersion = getOASVersion(input);
+  const inputSchemas = zodRegistryToJson(schemaRegistry, "input");
+  const outputSchemas = zodRegistryToJson(schemaRegistry, "output");
+  for (const key in outputSchemas) {
+    if (inputSchemas[key]) {
+      throw new Error(
+        `Collision detected for schema "${key}". The is already an input schema with the same name.`
+      );
+    }
+  }
+  const jsonSchemas = {
+    ...inputSchemas,
+    ...outputSchemas
+  };
+  const oasSchemas = Object.fromEntries(
+    Object.entries(jsonSchemas).map(([key, value]) => [key, jsonSchemaToOAS(value, oasVersion)])
+  );
+  return {
+    ...input.openapiObject,
+    components: {
+      ...input.openapiObject.components,
+      schemas: {
+        ...input.openapiObject.components?.schemas,
+        ...oasSchemas
+      }
+    }
+  };
+};
+const jsonSchemaTransformObject = createJsonSchemaTransformObject({});
+const validatorCompiler = ({ schema }) => (data) => {
+  const result = safeParse(schema, data);
+  if (result.error) {
+    return { error: createValidationError(result.error) };
+  }
+  return { value: result.data };
+};
+function resolveSchema(maybeSchema) {
+  if (maybeSchema instanceof $ZodType) {
+    return maybeSchema;
+  }
+  if ("properties" in maybeSchema && maybeSchema.properties instanceof $ZodType) {
+    return maybeSchema.properties;
+  }
+  throw new InvalidSchemaError(JSON.stringify(maybeSchema));
+}
+const createSerializerCompiler = (options) => ({ schema: maybeSchema, method, url }) => (data) => {
+  const schema = resolveSchema(maybeSchema);
+  const result = safeParse(schema, data);
+  if (result.error) {
+    throw new ResponseSerializationError(method, url, { cause: result.error });
+  }
+  return JSON.stringify(result.data, options?.replacer);
+};
+const serializerCompiler = createSerializerCompiler({});
+export {
+  createJsonSchemaTransform,
+  createJsonSchemaTransformObject,
+  createSerializerCompiler,
+  jsonSchemaTransform,
+  jsonSchemaTransformObject,
+  serializerCompiler,
+  validatorCompiler
+};
+//# sourceMappingURL=core.js.map

package/dist/esm/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sources":["../../src/core.ts"],"sourcesContent":["import type { SwaggerTransform, SwaggerTransformObject } from '@fastify/swagger'\nimport type {\n  FastifyPluginAsync,\n  FastifyPluginCallback,\n  FastifyPluginOptions,\n  FastifySchema,\n  FastifySchemaCompiler,\n  FastifyTypeProvider,\n  RawServerBase,\n  RawServerDefault,\n} from 'fastify'\nimport type { FastifySerializerCompiler } from 'fastify/types/schema'\nimport type { $ZodRegistry, input, output } from 'zod/v4/core'\nimport { $ZodType, globalRegistry, safeParse } from 'zod/v4/core'\nimport { createValidationError, InvalidSchemaError, ResponseSerializationError } from './errors'\nimport { getOASVersion, jsonSchemaToOAS } from './json-to-oas'\nimport { zodRegistryToJson, zodSchemaToJson } from './zod-to-json'\n\ntype FreeformRecord = Record<string, any>\n\nconst defaultSkipList = [\n  '/documentation/',\n  '/documentation/initOAuth',\n  '/documentation/json',\n  '/documentation/uiConfig',\n  '/documentation/yaml',\n  '/documentation/*',\n  '/documentation/static/*',\n]\n\nexport interface ZodTypeProvider extends FastifyTypeProvider {\n  validator: this['schema'] extends $ZodType ? output<this['schema']> : unknown\n  serializer: this['schema'] extends $ZodType ? input<this['schema']> : unknown\n}\n\ninterface Schema extends FastifySchema {\n  hide?: boolean\n}\n\ntype CreateJsonSchemaTransformOptions = {\n  skipList?: readonly string[]\n  schemaRegistry?: $ZodRegistry<{ id?: string | undefined }>\n}\n\nexport const createJsonSchemaTransform = ({\n  skipList = defaultSkipList,\n  schemaRegistry = globalRegistry,\n}: CreateJsonSchemaTransformOptions): SwaggerTransform<Schema> => {\n  return (input) => {\n    if ('swaggerObject' in input) {\n      throw new Error('OpenAPI 2.0 is not supported')\n    }\n\n    const { schema, url } = input\n\n    if (!schema) {\n      return {\n        schema,\n        url,\n      }\n    }\n\n    const { response, headers, querystring, body, params, hide, ...rest } = schema\n\n    const transformed: FreeformRecord = {}\n\n    if (skipList.includes(url) || hide) {\n      transformed.hide = true\n      return { schema: transformed, url }\n    }\n\n    const zodSchemas: FreeformRecord = { headers, querystring, body, params }\n\n    const oasVersion = getOASVersion(input)\n\n    for (const prop in zodSchemas) {\n      const zodSchema = zodSchemas[prop]\n      if (zodSchema) {\n        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, 'input')\n        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion)\n\n        transformed[prop] = oasSchema\n      }\n    }\n\n    if (response) {\n      transformed.response = {}\n\n      for (const prop in response as any) {\n        const zodSchema = resolveSchema((response as any)[prop])\n        const jsonSchema = zodSchemaToJson(zodSchema, schemaRegistry, 'output')\n\n        // Check is the JSON schema is null then return as it is since fastify-swagger will handle it\n        if (jsonSchema.type === 'null') {\n          transformed.response[prop] = jsonSchema\n          continue\n        }\n\n        const oasSchema = jsonSchemaToOAS(jsonSchema, oasVersion)\n\n        transformed.response[prop] = oasSchema\n      }\n    }\n\n    for (const prop in rest) {\n      const meta = rest[prop as keyof typeof rest]\n      if (meta) {\n        transformed[prop] = meta\n      }\n    }\n\n    return { schema: transformed, url }\n  }\n}\n\nexport const jsonSchemaTransform: SwaggerTransform<Schema> = createJsonSchemaTransform({})\n\ntype CreateJsonSchemaTransformObjectOptions = {\n  schemaRegistry?: $ZodRegistry<{ id?: string | undefined }>\n}\n\nexport const createJsonSchemaTransformObject =\n  ({\n    schemaRegistry = globalRegistry,\n  }: CreateJsonSchemaTransformObjectOptions): SwaggerTransformObject =>\n  (input) => {\n    if ('swaggerObject' in input) {\n      throw new Error('OpenAPI 2.0 is not supported')\n    }\n\n    const oasVersion = getOASVersion(input)\n\n    const inputSchemas = zodRegistryToJson(schemaRegistry, 'input')\n    const outputSchemas = zodRegistryToJson(schemaRegistry, 'output')\n\n    for (const key in outputSchemas) {\n      if (inputSchemas[key]) {\n        throw new Error(\n          `Collision detected for schema \"${key}\". The is already an input schema with the same name.`,\n        )\n      }\n    }\n\n    const jsonSchemas = {\n      ...inputSchemas,\n      ...outputSchemas,\n    }\n\n    const oasSchemas = Object.fromEntries(\n      Object.entries(jsonSchemas).map(([key, value]) => [key, jsonSchemaToOAS(value, oasVersion)]),\n    )\n\n    return {\n      ...input.openapiObject,\n      components: {\n        ...input.openapiObject.components,\n        schemas: {\n          ...input.openapiObject.components?.schemas,\n          ...oasSchemas,\n        },\n      },\n    } as ReturnType<SwaggerTransformObject>\n  }\n\nexport const jsonSchemaTransformObject: SwaggerTransformObject = createJsonSchemaTransformObject({})\n\nexport const validatorCompiler: FastifySchemaCompiler<$ZodType> =\n  ({ schema }) =>\n  (data) => {\n    const result = safeParse(schema, data)\n    if (result.error) {\n      return { error: createValidationError(result.error) as unknown as Error }\n    }\n\n    return { value: result.data }\n  }\n\nfunction resolveSchema(maybeSchema: $ZodType | { properties: $ZodType }): $ZodType {\n  if (maybeSchema instanceof $ZodType) {\n    return maybeSchema\n  }\n  if ('properties' in maybeSchema && maybeSchema.properties instanceof $ZodType) {\n    return maybeSchema.properties\n  }\n  throw new InvalidSchemaError(JSON.stringify(maybeSchema))\n}\n\ntype ReplacerFunction = (this: any, key: string, value: any) => any\n\nexport type ZodSerializerCompilerOptions = {\n  replacer?: ReplacerFunction\n}\n\nexport const createSerializerCompiler =\n  (\n    options?: ZodSerializerCompilerOptions,\n  ): FastifySerializerCompiler<$ZodType | { properties: $ZodType }> =>\n  ({ schema: maybeSchema, method, url }) =>\n  (data) => {\n    const schema = resolveSchema(maybeSchema)\n\n    const result = safeParse(schema, data)\n    if (result.error) {\n      throw new ResponseSerializationError(method, url, { cause: result.error })\n    }\n\n    return JSON.stringify(result.data, options?.replacer)\n  }\n\nexport const serializerCompiler: ReturnType<typeof createSerializerCompiler> =\n  createSerializerCompiler({})\n\n/**\n * FastifyPluginCallbackZod with Zod automatic type inference\n *\n * @example\n * ```typescript\n * import { FastifyPluginCallbackZod } from \"fastify-type-provider-zod\"\n *\n * const plugin: FastifyPluginCallbackZod = (fastify, options, done) => {\n *   done()\n * }\n * ```\n */\nexport type FastifyPluginCallbackZod<\n  Options extends FastifyPluginOptions = Record<never, never>,\n  Server extends RawServerBase = RawServerDefault,\n> = FastifyPluginCallback<Options, Server, ZodTypeProvider>\n\n/**\n * FastifyPluginAsyncZod with Zod automatic type inference\n *\n * @example\n * ```typescript\n * import { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\"\n *\n * const plugin: FastifyPluginAsyncZod = async (fastify, options) => {\n * }\n * ```\n */\nexport type FastifyPluginAsyncZod<\n  Options extends FastifyPluginOptions = Record<never, never>,\n  Server extends RawServerBase = RawServerDefault,\n> = FastifyPluginAsync<Options, Server, ZodTypeProvider>\n"],"names":[],"mappings":"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"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,30 @@
+import { type FastifyErrorConstructor } from "@fastify/error";
+import type { FastifyError } from "fastify";
+import type { FastifySchemaValidationError } from "fastify/types/schema";
+import type { $ZodError } from "zod/v4/core";
+export declare const InvalidSchemaError: FastifyErrorConstructor<{
+	code: string;
+}, [string]>;
+declare const ZodFastifySchemaValidationErrorSymbol: symbol;
+export type ZodFastifySchemaValidationError = FastifySchemaValidationError & {
+	[ZodFastifySchemaValidationErrorSymbol]: true;
+};
+declare const ResponseSerializationBase: FastifyErrorConstructor<{
+	code: string;
+}, [{
+	cause: $ZodError;
+}]>;
+export declare class ResponseSerializationError extends ResponseSerializationBase {
+	method: string;
+	url: string;
+	cause: $ZodError;
+	constructor(method: string, url: string, options: {
+		cause: $ZodError;
+	});
+}
+export declare function isResponseSerializationError(value: unknown): value is ResponseSerializationError;
+export declare function hasZodFastifySchemaValidationErrors(error: unknown): error is Omit<FastifyError, "validation"> & {
+	validation: ZodFastifySchemaValidationError[];
+};
+export declare function createValidationError(error: $ZodError): ZodFastifySchemaValidationError[];
+export {};

package/dist/esm/errors.js

@@ -0,0 +1,57 @@
+import createError from "@fastify/error";
+const InvalidSchemaError = createError("FST_ERR_INVALID_SCHEMA", "Invalid schema passed: %s", 500);
+const ZodFastifySchemaValidationErrorSymbol = Symbol.for("ZodFastifySchemaValidationError");
+const ResponseSerializationBase = createError(
+  "FST_ERR_RESPONSE_SERIALIZATION",
+  "Response doesn't match the schema",
+  500
+);
+class ResponseSerializationError extends ResponseSerializationBase {
+  constructor(method, url, options) {
+    super({ cause: options.cause });
+    this.method = method;
+    this.url = url;
+    this.cause = options.cause;
+  }
+  cause;
+}
+function isResponseSerializationError(value) {
+  return "method" in value;
+}
+function isZodFastifySchemaValidationError(error) {
+  return typeof error === "object" && error !== null && error[ZodFastifySchemaValidationErrorSymbol] === true;
+}
+function hasZodFastifySchemaValidationErrors(error) {
+  return typeof error === "object" && error !== null && "validation" in error && Array.isArray(error.validation) && error.validation.length > 0 && isZodFastifySchemaValidationError(error.validation[0]);
+}
+function omit(obj, keys) {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    if (!keys.includes(key)) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function createValidationError(error) {
+  return error.issues.map((issue) => {
+    return {
+      [ZodFastifySchemaValidationErrorSymbol]: true,
+      keyword: issue.code,
+      instancePath: `/${issue.path.join("/")}`,
+      schemaPath: `#/${issue.path.join("/")}/${issue.code}`,
+      message: issue.message,
+      params: {
+        ...omit(issue, ["path", "code", "message"])
+      }
+    };
+  });
+}
+export {
+  InvalidSchemaError,
+  ResponseSerializationError,
+  createValidationError,
+  hasZodFastifySchemaValidationErrors,
+  isResponseSerializationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../../src/errors.ts"],"sourcesContent":["import createError, { type FastifyErrorConstructor } from '@fastify/error'\nimport type { FastifyError } from 'fastify'\nimport type { FastifySchemaValidationError } from 'fastify/types/schema'\nimport type { $ZodError } from 'zod/v4/core'\n\nexport const InvalidSchemaError: FastifyErrorConstructor<\n  {\n    code: string\n  },\n  [string]\n> = createError<[string]>('FST_ERR_INVALID_SCHEMA', 'Invalid schema passed: %s', 500)\n\nconst ZodFastifySchemaValidationErrorSymbol: symbol = Symbol.for('ZodFastifySchemaValidationError')\n\nexport type ZodFastifySchemaValidationError = FastifySchemaValidationError & {\n  [ZodFastifySchemaValidationErrorSymbol]: true\n}\n\nconst ResponseSerializationBase: FastifyErrorConstructor<\n  {\n    code: string\n  },\n  [\n    {\n      cause: $ZodError\n    },\n  ]\n> = createError<[{ cause: $ZodError }]>(\n  'FST_ERR_RESPONSE_SERIALIZATION',\n  \"Response doesn't match the schema\",\n  500,\n)\n\nexport class ResponseSerializationError extends ResponseSerializationBase {\n  cause!: $ZodError\n\n  constructor(\n    public method: string,\n    public url: string,\n    options: { cause: $ZodError },\n  ) {\n    super({ cause: options.cause })\n\n    this.cause = options.cause\n  }\n}\n\nexport function isResponseSerializationError(value: unknown): value is ResponseSerializationError {\n  return 'method' in (value as ResponseSerializationError)\n}\n\nfunction isZodFastifySchemaValidationError(\n  error: unknown,\n): error is ZodFastifySchemaValidationError {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    (error as ZodFastifySchemaValidationError)[ZodFastifySchemaValidationErrorSymbol] === true\n  )\n}\n\nexport function hasZodFastifySchemaValidationErrors(\n  error: unknown,\n): error is Omit<FastifyError, 'validation'> & { validation: ZodFastifySchemaValidationError[] } {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    'validation' in error &&\n    Array.isArray(error.validation) &&\n    error.validation.length > 0 &&\n    isZodFastifySchemaValidationError(error.validation[0])\n  )\n}\n\nfunction omit<T extends object, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K> {\n  const result = {} as Omit<T, K>\n  for (const key of Object.keys(obj) as Array<keyof T>) {\n    if (!keys.includes(key as K)) {\n      // @ts-expect-error\n      result[key] = obj[key]\n    }\n  }\n  return result\n}\n\nexport function createValidationError(error: $ZodError): ZodFastifySchemaValidationError[] {\n  return error.issues.map((issue) => {\n    return {\n      [ZodFastifySchemaValidationErrorSymbol]: true,\n      keyword: issue.code,\n      instancePath: `/${issue.path.join('/')}`,\n      schemaPath: `#/${issue.path.join('/')}/${issue.code}`,\n      message: issue.message,\n      params: {\n        ...omit(issue, ['path', 'code', 'message']),\n      },\n    }\n  })\n}\n"],"names":[],"mappings":";AAKO,MAAM,qBAKT,YAAsB,0BAA0B,6BAA6B,GAAG;AAEpF,MAAM,wCAAgD,OAAO,IAAI,iCAAiC;AAMlG,MAAM,4BASF;AAAA,EACF;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,mCAAmC,0BAA0B;AAAA,EAGxE,YACS,QACA,KACP,SACA;AACA,UAAM,EAAE,OAAO,QAAQ,MAAA,CAAO;AAJvB,SAAA,SAAA;AACA,SAAA,MAAA;AAKP,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAVA;AAWF;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SAAO,YAAa;AACtB;AAEA,SAAS,kCACP,OAC0C;AAC1C,SACE,OAAO,UAAU,YACjB,UAAU,QACT,MAA0C,qCAAqC,MAAM;AAE1F;AAEO,SAAS,oCACd,OAC+F;AAC/F,SACE,OAAO,UAAU,YACjB,UAAU,QACV,gBAAgB,SAChB,MAAM,QAAQ,MAAM,UAAU,KAC9B,MAAM,WAAW,SAAS,KAC1B,kCAAkC,MAAM,WAAW,CAAC,CAAC;AAEzD;AAEA,SAAS,KAA0C,KAAQ,MAAgC;AACzF,QAAM,SAAS,CAAA;AACf,aAAW,OAAO,OAAO,KAAK,GAAG,GAAqB;AACpD,QAAI,CAAC,KAAK,SAAS,GAAQ,GAAG;AAE5B,aAAO,GAAG,IAAI,IAAI,GAAG;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,OAAqD;AACzF,SAAO,MAAM,OAAO,IAAI,CAAC,UAAU;AACjC,WAAO;AAAA,MACL,CAAC,qCAAqC,GAAG;AAAA,MACzC,SAAS,MAAM;AAAA,MACf,cAAc,IAAI,MAAM,KAAK,KAAK,GAAG,CAAC;AAAA,MACtC,YAAY,KAAK,MAAM,KAAK,KAAK,GAAG,CAAC,IAAI,MAAM,IAAI;AAAA,MACnD,SAAS,MAAM;AAAA,MACf,QAAQ;AAAA,QACN,GAAG,KAAK,OAAO,CAAC,QAAQ,QAAQ,SAAS,CAAC;AAAA,MAAA;AAAA,IAC5C;AAAA,EAEJ,CAAC;AACH;"}

package/dist/esm/index.d.ts

@@ -0,0 +1,2 @@
+export { createJsonSchemaTransform, createJsonSchemaTransformObject, createSerializerCompiler, type FastifyPluginAsyncZod, type FastifyPluginCallbackZod, jsonSchemaTransform, jsonSchemaTransformObject, serializerCompiler, validatorCompiler, type ZodSerializerCompilerOptions, type ZodTypeProvider } from "../esm/core.js";
+export { hasZodFastifySchemaValidationErrors, InvalidSchemaError, isResponseSerializationError, ResponseSerializationError, type ZodFastifySchemaValidationError } from "../esm/errors.js";

package/dist/esm/index.js

@@ -0,0 +1,16 @@
+import { createJsonSchemaTransform, createJsonSchemaTransformObject, createSerializerCompiler, jsonSchemaTransform, jsonSchemaTransformObject, serializerCompiler, validatorCompiler } from "./core.js";
+import { InvalidSchemaError, ResponseSerializationError, hasZodFastifySchemaValidationErrors, isResponseSerializationError } from "./errors.js";
+export {
+  InvalidSchemaError,
+  ResponseSerializationError,
+  createJsonSchemaTransform,
+  createJsonSchemaTransformObject,
+  createSerializerCompiler,
+  hasZodFastifySchemaValidationErrors,
+  isResponseSerializationError,
+  jsonSchemaTransform,
+  jsonSchemaTransformObject,
+  serializerCompiler,
+  validatorCompiler
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/json-to-oas.d.ts

@@ -0,0 +1,9 @@
+import type { OpenAPIV3, OpenAPIV3_1 } from "openapi-types";
+import type { JSONSchema } from "zod/v4/core";
+type OASVersion = "3.0" | "3.1";
+export declare const getOASVersion: (documentObject: {
+	openapiObject: Partial<OpenAPIV3.Document | OpenAPIV3_1.Document>;
+}) => OASVersion;
+export declare const jsonSchemaToOAS_3_0: (jsonSchema: JSONSchema.BaseSchema) => OpenAPIV3.SchemaObject;
+export declare const jsonSchemaToOAS: (jsonSchema: JSONSchema.BaseSchema, oasVersion: OASVersion) => OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;
+export {};

package/dist/esm/json-to-oas.js

@@ -0,0 +1,85 @@
+const getOASVersion = (documentObject) => {
+  const openapiVersion = documentObject.openapiObject.openapi || "3.0.3";
+  if (openapiVersion.startsWith("3.1")) {
+    return "3.1";
+  }
+  if (openapiVersion.startsWith("3.0")) {
+    return "3.0";
+  }
+  throw new Error("Unsupported OpenAPI document object");
+};
+const jsonSchemaToOAS_3_0 = (jsonSchema) => {
+  const clone = { ...jsonSchema };
+  if (clone.type === "null") {
+    clone.nullable = true;
+    delete clone.type;
+    clone.enum = [null];
+  }
+  if (Array.isArray(clone.prefixItems)) {
+    const tuple = clone.prefixItems;
+    clone.minItems ??= tuple.length;
+    clone.maxItems ??= tuple.length;
+    clone.items = {
+      oneOf: tuple.map(jsonSchemaToOAS_3_0)
+    };
+    delete clone.prefixItems;
+  }
+  if ("const" in clone && clone.const !== void 0) {
+    clone.enum = [clone.const];
+    delete clone.const;
+  }
+  if (typeof clone.exclusiveMinimum === "number") {
+    clone.minimum = clone.exclusiveMinimum;
+    clone.exclusiveMinimum = true;
+  }
+  if (typeof clone.exclusiveMaximum === "number") {
+    clone.maximum = clone.exclusiveMaximum;
+    clone.exclusiveMaximum = true;
+  }
+  for (const key of [
+    "$schema",
+    "$id",
+    "unevaluatedProperties",
+    "dependentSchemas",
+    "patternProperties",
+    "propertyNames",
+    "contentEncoding",
+    "contentMediaType"
+  ]) {
+    delete clone[key];
+  }
+  const recursive = (v) => Array.isArray(v) ? v.map(jsonSchemaToOAS_3_0) : jsonSchemaToOAS_3_0(v);
+  if (clone.properties) {
+    for (const [k, v] of Object.entries(clone.properties)) {
+      clone.properties[k] = jsonSchemaToOAS_3_0(v);
+    }
+  }
+  if (clone.items && !Array.isArray(clone.items)) {
+    clone.items = recursive(clone.items);
+  }
+  for (const key of ["allOf", "anyOf", "oneOf", "not", "then", "else", "if", "contains"]) {
+    if (clone[key]) {
+      clone[key] = recursive(clone[key]);
+    }
+  }
+  return clone;
+};
+const jsonSchemaToOAS_3_1 = (jsonSchema) => {
+  return jsonSchema;
+};
+const jsonSchemaToOAS = (jsonSchema, oasVersion) => {
+  switch (oasVersion) {
+    case "3.0":
+      return jsonSchemaToOAS_3_0(jsonSchema);
+    case "3.1":
+      return jsonSchemaToOAS_3_1(jsonSchema);
+    default:
+      throw new Error(`Unsupported OpenAPI version: ${oasVersion}`);
+  }
+};
+export {
+  getOASVersion,
+  jsonSchemaToOAS,
+  jsonSchemaToOAS_3_0
+};
+//# sourceMappingURL=json-to-oas.js.map

package/dist/esm/json-to-oas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-to-oas.js","sources":["../../src/json-to-oas.ts"],"sourcesContent":["import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\nimport type { JSONSchema } from 'zod/v4/core'\n\ntype OASVersion = '3.0' | '3.1'\n\nexport const getOASVersion = (documentObject: {\n  openapiObject: Partial<OpenAPIV3.Document | OpenAPIV3_1.Document>\n}): OASVersion => {\n  const openapiVersion = documentObject.openapiObject.openapi || '3.0.3'\n\n  if (openapiVersion.startsWith('3.1')) {\n    return '3.1'\n  }\n\n  if (openapiVersion.startsWith('3.0')) {\n    return '3.0'\n  }\n\n  throw new Error('Unsupported OpenAPI document object')\n}\n\nexport const jsonSchemaToOAS_3_0 = (jsonSchema: JSONSchema.BaseSchema): OpenAPIV3.SchemaObject => {\n  const clone: any = { ...jsonSchema }\n\n  if (clone.type === 'null') {\n    clone.nullable = true\n    delete clone.type\n    clone.enum = [null]\n  }\n\n  if (Array.isArray(clone.prefixItems)) {\n    const tuple = clone.prefixItems as JSONSchema.BaseSchema[]\n\n    clone.minItems ??= tuple.length\n    clone.maxItems ??= tuple.length\n\n    clone.items = {\n      oneOf: tuple.map(jsonSchemaToOAS_3_0),\n    }\n\n    delete clone.prefixItems\n  }\n\n  if ('const' in clone && clone.const !== undefined) {\n    clone.enum = [clone.const]\n    delete clone.const\n  }\n\n  if (typeof clone.exclusiveMinimum === 'number') {\n    clone.minimum = clone.exclusiveMinimum\n    clone.exclusiveMinimum = true\n  }\n  if (typeof clone.exclusiveMaximum === 'number') {\n    clone.maximum = clone.exclusiveMaximum\n    clone.exclusiveMaximum = true\n  }\n\n  for (const key of [\n    '$schema',\n    '$id',\n    'unevaluatedProperties',\n    'dependentSchemas',\n    'patternProperties',\n    'propertyNames',\n    'contentEncoding',\n    'contentMediaType',\n  ]) {\n    delete clone[key]\n  }\n\n  const recursive = (v: any): any =>\n    Array.isArray(v) ? v.map(jsonSchemaToOAS_3_0) : jsonSchemaToOAS_3_0(v)\n\n  if (clone.properties) {\n    for (const [k, v] of Object.entries(clone.properties)) {\n      clone.properties![k] = jsonSchemaToOAS_3_0(v as any)\n    }\n  }\n\n  if (clone.items && !Array.isArray(clone.items)) {\n    clone.items = recursive(clone.items)\n  }\n\n  for (const key of ['allOf', 'anyOf', 'oneOf', 'not', 'then', 'else', 'if', 'contains']) {\n    if (clone[key]) {\n      clone[key] = recursive(clone[key])\n    }\n  }\n\n  return clone as OpenAPIV3.SchemaObject\n}\n\nconst jsonSchemaToOAS_3_1 = (jsonSchema: JSONSchema.BaseSchema): OpenAPIV3_1.SchemaObject => {\n  return jsonSchema as OpenAPIV3_1.SchemaObject\n}\n\nexport const jsonSchemaToOAS = (\n  jsonSchema: JSONSchema.BaseSchema,\n  oasVersion: OASVersion,\n): OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject => {\n  switch (oasVersion) {\n    case '3.0':\n      return jsonSchemaToOAS_3_0(jsonSchema)\n    case '3.1':\n      return jsonSchemaToOAS_3_1(jsonSchema)\n    default:\n      throw new Error(`Unsupported OpenAPI version: ${oasVersion}`)\n  }\n}\n"],"names":[],"mappings":"AAKO,MAAM,gBAAgB,CAAC,mBAEZ;AAChB,QAAM,iBAAiB,eAAe,cAAc,WAAW;AAE/D,MAAI,eAAe,WAAW,KAAK,GAAG;AACpC,WAAO;AAAA,EACT;AAEA,MAAI,eAAe,WAAW,KAAK,GAAG;AACpC,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,qCAAqC;AACvD;AAEO,MAAM,sBAAsB,CAAC,eAA8D;AAChG,QAAM,QAAa,EAAE,GAAG,WAAA;AAExB,MAAI,MAAM,SAAS,QAAQ;AACzB,UAAM,WAAW;AACjB,WAAO,MAAM;AACb,UAAM,OAAO,CAAC,IAAI;AAAA,EACpB;AAEA,MAAI,MAAM,QAAQ,MAAM,WAAW,GAAG;AACpC,UAAM,QAAQ,MAAM;AAEpB,UAAM,aAAa,MAAM;AACzB,UAAM,aAAa,MAAM;AAEzB,UAAM,QAAQ;AAAA,MACZ,OAAO,MAAM,IAAI,mBAAmB;AAAA,IAAA;AAGtC,WAAO,MAAM;AAAA,EACf;AAEA,MAAI,WAAW,SAAS,MAAM,UAAU,QAAW;AACjD,UAAM,OAAO,CAAC,MAAM,KAAK;AACzB,WAAO,MAAM;AAAA,EACf;AAEA,MAAI,OAAO,MAAM,qBAAqB,UAAU;AAC9C,UAAM,UAAU,MAAM;AACtB,UAAM,mBAAmB;AAAA,EAC3B;AACA,MAAI,OAAO,MAAM,qBAAqB,UAAU;AAC9C,UAAM,UAAU,MAAM;AACtB,UAAM,mBAAmB;AAAA,EAC3B;AAEA,aAAW,OAAO;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GACC;AACD,WAAO,MAAM,GAAG;AAAA,EAClB;AAEA,QAAM,YAAY,CAAC,MACjB,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,mBAAmB,IAAI,oBAAoB,CAAC;AAEvE,MAAI,MAAM,YAAY;AACpB,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,UAAU,GAAG;AACrD,YAAM,WAAY,CAAC,IAAI,oBAAoB,CAAQ;AAAA,IACrD;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,CAAC,MAAM,QAAQ,MAAM,KAAK,GAAG;AAC9C,UAAM,QAAQ,UAAU,MAAM,KAAK;AAAA,EACrC;AAEA,aAAW,OAAO,CAAC,SAAS,SAAS,SAAS,OAAO,QAAQ,QAAQ,MAAM,UAAU,GAAG;AACtF,QAAI,MAAM,GAAG,GAAG;AACd,YAAM,GAAG,IAAI,UAAU,MAAM,GAAG,CAAC;AAAA,IACnC;AAAA,EACF;AAEA,SAAO;AACT;AAEA,MAAM,sBAAsB,CAAC,eAAgE;AAC3F,SAAO;AACT;AAEO,MAAM,kBAAkB,CAC7B,YACA,eACsD;AACtD,UAAQ,YAAA;AAAA,IACN,KAAK;AACH,aAAO,oBAAoB,UAAU;AAAA,IACvC,KAAK;AACH,aAAO,oBAAoB,UAAU;AAAA,IACvC;AACE,YAAM,IAAI,MAAM,gCAAgC,UAAU,EAAE;AAAA,EAAA;AAElE;"}

package/dist/esm/zod-to-json.d.ts

@@ -0,0 +1,8 @@
+import type { JSONSchema } from "zod/v4/core";
+import { $ZodRegistry, $ZodType } from "zod/v4/core";
+export declare const zodSchemaToJson: (zodSchema: $ZodType, registry: $ZodRegistry<{
+	id?: string;
+}>, io: "input" | "output") => JSONSchema.BaseSchema;
+export declare const zodRegistryToJson: (registry: $ZodRegistry<{
+	id?: string;
+}>, io: "input" | "output") => Record<string, JSONSchema.BaseSchema>;