npm - zod-nest - Versions diffs - 0.0.0-alpha.0 → 0.1.5 - Mend

zod-nest 0.0.0-alpha.0 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -1,2 +1,49 @@
+import { z } from 'zod';
+import { JSONSchema, $ZodTypes } from 'zod/v4/core';
-export {  }
+/** OpenAPI 3.1 `$ref` prefix for entries in `components.schemas`. */
+declare const COMPONENTS_SCHEMAS_PREFIX = "#/components/schemas/";
+/** OpenAPI extension key zod-nest uses to surface engine errors inside emitted schemas. */
+declare const ZOD_NEST_ERROR_EXTENSION = "x-zod-nest-error";
+/** Value of `x-zod-nest-error` when a registry id is claimed by more than one schema. */
+declare const ZOD_NEST_ERROR_DUPLICATE_ID = "duplicate-id";
+type SchemaObject = JSONSchema.BaseSchema;
+interface OverrideContext {
+    zodSchema: $ZodTypes;
+    jsonSchema: SchemaObject;
+    path: (string | number)[];
+}
+type Override = (ctx: OverrideContext) => void;
+interface ZodNestRegistry {
+    readonly zodRegistry: typeof z.globalRegistry;
+    register(schema: z.ZodType, id: string): void;
+    hasCollision(id: string): boolean;
+    getCollisions(): ReadonlyMap<string, ReadonlySet<z.ZodType>>;
+}
+declare const createRegistry: () => ZodNestRegistry;
+interface ToOpenApiOptions {
+    io: 'input' | 'output';
+    registry: ZodNestRegistry;
+    override?: Override;
+    strict?: boolean;
+}
+interface ToOpenApiResult {
+    schema: SchemaObject;
+    refs: Map<string, SchemaObject>;
+}
+declare const toOpenApi: (schema: z.ZodType, opts: ToOpenApiOptions) => ToOpenApiResult;
+declare class ZodNestError extends Error {
+    constructor(message: string);
+}
+declare class ZodNestUnrepresentableError extends ZodNestError {
+    readonly path: ReadonlyArray<string | number>;
+    readonly zodType: string;
+    constructor(path: ReadonlyArray<string | number>, zodType: string);
+}
+export { COMPONENTS_SCHEMAS_PREFIX, type Override, type OverrideContext, type SchemaObject, type ToOpenApiOptions, type ToOpenApiResult, ZOD_NEST_ERROR_DUPLICATE_ID, ZOD_NEST_ERROR_EXTENSION, ZodNestError, type ZodNestRegistry, ZodNestUnrepresentableError, createRegistry, toOpenApi };

package/dist/index.d.ts CHANGED Viewed

@@ -1,2 +1,49 @@
+import { z } from 'zod';
+import { JSONSchema, $ZodTypes } from 'zod/v4/core';
-export {  }
+/** OpenAPI 3.1 `$ref` prefix for entries in `components.schemas`. */
+declare const COMPONENTS_SCHEMAS_PREFIX = "#/components/schemas/";
+/** OpenAPI extension key zod-nest uses to surface engine errors inside emitted schemas. */
+declare const ZOD_NEST_ERROR_EXTENSION = "x-zod-nest-error";
+/** Value of `x-zod-nest-error` when a registry id is claimed by more than one schema. */
+declare const ZOD_NEST_ERROR_DUPLICATE_ID = "duplicate-id";
+type SchemaObject = JSONSchema.BaseSchema;
+interface OverrideContext {
+    zodSchema: $ZodTypes;
+    jsonSchema: SchemaObject;
+    path: (string | number)[];
+}
+type Override = (ctx: OverrideContext) => void;
+interface ZodNestRegistry {
+    readonly zodRegistry: typeof z.globalRegistry;
+    register(schema: z.ZodType, id: string): void;
+    hasCollision(id: string): boolean;
+    getCollisions(): ReadonlyMap<string, ReadonlySet<z.ZodType>>;
+}
+declare const createRegistry: () => ZodNestRegistry;
+interface ToOpenApiOptions {
+    io: 'input' | 'output';
+    registry: ZodNestRegistry;
+    override?: Override;
+    strict?: boolean;
+}
+interface ToOpenApiResult {
+    schema: SchemaObject;
+    refs: Map<string, SchemaObject>;
+}
+declare const toOpenApi: (schema: z.ZodType, opts: ToOpenApiOptions) => ToOpenApiResult;
+declare class ZodNestError extends Error {
+    constructor(message: string);
+}
+declare class ZodNestUnrepresentableError extends ZodNestError {
+    readonly path: ReadonlyArray<string | number>;
+    readonly zodType: string;
+    constructor(path: ReadonlyArray<string | number>, zodType: string);
+}
+export { COMPONENTS_SCHEMAS_PREFIX, type Override, type OverrideContext, type SchemaObject, type ToOpenApiOptions, type ToOpenApiResult, ZOD_NEST_ERROR_DUPLICATE_ID, ZOD_NEST_ERROR_EXTENSION, ZodNestError, type ZodNestRegistry, ZodNestUnrepresentableError, createRegistry, toOpenApi };

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,204 @@
 'use strict';
+var zod = require('zod');
+// src/schema/constants.ts
+var COMPONENTS_SCHEMAS_PREFIX = "#/components/schemas/";
+var ZOD_NEST_ERROR_EXTENSION = "x-zod-nest-error";
+var ZOD_NEST_ERROR_DUPLICATE_ID = "duplicate-id";
+// src/schema/errors.ts
+var ZodNestError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ZodNestError";
+  }
+};
+var ZodNestUnrepresentableError = class extends ZodNestError {
+  path;
+  zodType;
+  constructor(path, zodType) {
+    super(
+      `Unrepresentable Zod schema \`${zodType}\` at ${formatPath(path)}: no override produced a JSON Schema body. Set strict: false to emit \`{}\` instead, or supply an \`override\` that handles this Zod type.`
+    );
+    this.name = "ZodNestUnrepresentableError";
+    this.path = path;
+    this.zodType = zodType;
+  }
+};
+var formatPath = (path) => {
+  if (path.length === 0) {
+    return "<root>";
+  }
+  return "/" + path.map(String).join("/");
+};
+// src/schema/override.ts
+var builtInOverride = ({ zodSchema, jsonSchema }) => {
+  const type = zodSchema._zod.def.type;
+  if (type === "bigint") {
+    jsonSchema.type = "integer";
+    return;
+  }
+  if (type === "date") {
+    jsonSchema.type = "string";
+    jsonSchema.format = "date-time";
+    return;
+  }
+};
+var STRICT_REQUIRES_OVERRIDE = /* @__PURE__ */ new Set([
+  "bigint",
+  "date",
+  "symbol",
+  "undefined",
+  "void",
+  "map",
+  "set",
+  "transform",
+  "nan",
+  "custom"
+]);
+var isStrictlyUnrepresentable = (jsonSchema, zodSchema) => {
+  if (!STRICT_REQUIRES_OVERRIDE.has(zodSchema._zod.def.type)) {
+    return false;
+  }
+  return Object.keys(jsonSchema).length === 0;
+};
+var combine = (...overrides) => {
+  const list = [];
+  for (const candidate of overrides) {
+    if (typeof candidate !== "function") {
+      continue;
+    }
+    list.push(candidate);
+  }
+  if (list.length === 0) {
+    return () => void 0;
+  }
+  return (ctx) => {
+    for (const o of list) {
+      o(ctx);
+    }
+  };
+};
+// src/schema/post-process.ts
+var DEFS_PREFIX = "#/$defs/";
+var rewriteRefs = (node, selfRef) => {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      rewriteRefs(item, selfRef);
+    }
+    return;
+  }
+  if (node === null || typeof node !== "object") {
+    return;
+  }
+  const obj = node;
+  const ref = obj.$ref;
+  if (typeof ref === "string" && ref.startsWith(DEFS_PREFIX)) {
+    obj.$ref = COMPONENTS_SCHEMAS_PREFIX + ref.slice(DEFS_PREFIX.length);
+  } else if (ref === "#" && selfRef !== void 0) {
+    obj.$ref = selfRef;
+  }
+  for (const value of Object.values(obj)) {
+    rewriteRefs(value, selfRef);
+  }
+};
+var postProcess = (raw) => {
+  const refs = /* @__PURE__ */ new Map();
+  const rawDefs = raw.$defs;
+  if (rawDefs !== void 0) {
+    for (const [id, body] of Object.entries(rawDefs)) {
+      refs.set(id, body);
+    }
+  }
+  const root = { ...raw };
+  delete root.$schema;
+  delete root.$defs;
+  rewriteRefs(root, void 0);
+  for (const [id, body] of refs) {
+    rewriteRefs(body, `${COMPONENTS_SCHEMAS_PREFIX}${id}`);
+  }
+  return { schema: root, refs };
+};
+// src/schema/engine.ts
+var toOpenApi = (schema, opts) => {
+  const strict = opts.strict ?? true;
+  const merged = combine(builtInOverride, opts.override);
+  const unrepresentableHits = [];
+  const wrapped = (ctx) => {
+    merged(ctx);
+    if (!strict || !isStrictlyUnrepresentable(ctx.jsonSchema, ctx.zodSchema)) {
+      return;
+    }
+    unrepresentableHits.push({
+      path: [...ctx.path],
+      zodType: ctx.zodSchema._zod.def.type
+    });
+  };
+  const raw = zod.z.toJSONSchema(schema, {
+    target: "draft-2020-12",
+    io: opts.io,
+    unrepresentable: "any",
+    metadata: opts.registry.zodRegistry,
+    override: wrapped,
+    cycles: "ref",
+    reused: "inline"
+  });
+  const firstHit = unrepresentableHits[0];
+  if (firstHit !== void 0) {
+    throw new ZodNestUnrepresentableError(firstHit.path, firstHit.zodType);
+  }
+  const result = postProcess(raw);
+  for (const [id] of opts.registry.getCollisions()) {
+    if (!result.refs.has(id)) {
+      continue;
+    }
+    result.refs.set(id, {
+      description: `ERROR: duplicate zod-nest id <${id}>`,
+      [ZOD_NEST_ERROR_EXTENSION]: ZOD_NEST_ERROR_DUPLICATE_ID
+    });
+  }
+  return result;
+};
+var createRegistry = () => {
+  const seen = /* @__PURE__ */ new Map();
+  return {
+    zodRegistry: zod.z.globalRegistry,
+    register: (schema, id) => {
+      zod.z.globalRegistry.add(schema, { id });
+      let set = seen.get(id);
+      if (set === void 0) {
+        set = /* @__PURE__ */ new Set();
+        seen.set(id, set);
+      }
+      set.add(schema);
+    },
+    hasCollision: (id) => {
+      const set = seen.get(id);
+      return set !== void 0 && set.size > 1;
+    },
+    getCollisions: () => {
+      const out = /* @__PURE__ */ new Map();
+      for (const [id, set] of seen) {
+        if (set.size <= 1) {
+          continue;
+        }
+        out.set(id, set);
+      }
+      return out;
+    }
+  };
+};
+exports.COMPONENTS_SCHEMAS_PREFIX = COMPONENTS_SCHEMAS_PREFIX;
+exports.ZOD_NEST_ERROR_DUPLICATE_ID = ZOD_NEST_ERROR_DUPLICATE_ID;
+exports.ZOD_NEST_ERROR_EXTENSION = ZOD_NEST_ERROR_EXTENSION;
+exports.ZodNestError = ZodNestError;
+exports.ZodNestUnrepresentableError = ZodNestUnrepresentableError;
+exports.createRegistry = createRegistry;
+exports.toOpenApi = toOpenApi;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
1	+ {"version":3,"sources":["../src/schema/constants.ts","../src/schema/errors.ts","../src/schema/override.ts","../src/schema/post-process.ts","../src/schema/engine.ts","../src/schema/registry.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/** OpenAPI 3.1 `$ref` prefix for entries in `components.schemas`. /\nexport const COMPONENTS_SCHEMAS_PREFIX = '#/components/schemas/';\n\n/* OpenAPI extension key zod-nest uses to surface engine errors inside emitted schemas. /\nexport const ZOD_NEST_ERROR_EXTENSION = 'x-zod-nest-error';\n\n/* Value of `x-zod-nest-error` when a registry id is claimed by more than one schema. */\nexport const ZOD_NEST_ERROR_DUPLICATE_ID = 'duplicate-id';\n","export class ZodNestError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'ZodNestError';\n }\n}\n\nexport class ZodNestUnrepresentableError extends ZodNestError {\n readonly path: ReadonlyArray<string \| number>;\n readonly zodType: string;\n\n constructor(path: ReadonlyArray<string \| number>, zodType: string) {\n super(\n `Unrepresentable Zod schema \\`${zodType}\\` at ${formatPath(path)}: no override produced ` +\n `a JSON Schema body. Set strict: false to emit \\`{}\\` instead, or supply an \\`override\\` ` +\n `that handles this Zod type.`,\n );\n this.name = 'ZodNestUnrepresentableError';\n this.path = path;\n this.zodType = zodType;\n }\n}\n\nconst formatPath = (path: ReadonlyArray<string \| number>): string => {\n if (path.length === 0) {\n return '<root>';\n }\n return '/' + path.map(String).join('/');\n};\n","import type { $ZodTypes } from 'zod/v4/core';\nimport type { SchemaObject } from './openapi.types.js';\n\nexport interface OverrideContext {\n zodSchema: $ZodTypes;\n jsonSchema: SchemaObject;\n path: (string \| number)[];\n}\n\nexport type Override = (ctx: OverrideContext) => void;\n\nexport const builtInOverride: Override = ({ zodSchema, jsonSchema }) => {\n const type = zodSchema._zod.def.type;\n if (type === 'bigint') {\n jsonSchema.type = 'integer';\n return;\n }\n if (type === 'date') {\n jsonSchema.type = 'string';\n jsonSchema.format = 'date-time';\n return;\n }\n};\n\nconst STRICT_REQUIRES_OVERRIDE: ReadonlySet<string> = new Set([\n 'bigint',\n 'date',\n 'symbol',\n 'undefined',\n 'void',\n 'map',\n 'set',\n 'transform',\n 'nan',\n 'custom',\n]);\n\nexport const isStrictlyUnrepresentable = (\n jsonSchema: SchemaObject,\n zodSchema: $ZodTypes,\n): boolean => {\n if (!STRICT_REQUIRES_OVERRIDE.has(zodSchema._zod.def.type)) {\n return false;\n }\n return Object.keys(jsonSchema).length === 0;\n};\n\nexport const combine = (...overrides: ReadonlyArray<Override \| undefined>): Override => {\n const list: Override[] = [];\n for (const candidate of overrides) {\n if (typeof candidate !== 'function') {\n continue;\n }\n list.push(candidate);\n }\n if (list.length === 0) {\n return () => undefined;\n }\n return (ctx) => {\n for (const o of list) {\n o(ctx);\n }\n };\n};\n","import type { SchemaObject } from './openapi.types.js';\n\nimport { COMPONENTS_SCHEMAS_PREFIX } from './constants.js';\n\nexport interface PostProcessResult {\n schema: SchemaObject;\n refs: Map<string, SchemaObject>;\n}\n\nconst DEFS_PREFIX = '#/$defs/';\n\nconst rewriteRefs = (node: unknown, selfRef: string \| undefined): void => {\n if (Array.isArray(node)) {\n for (const item of node) {\n rewriteRefs(item, selfRef);\n }\n return;\n }\n if (node === null \|\| typeof node !== 'object') {\n return;\n }\n const obj = node as Record<string, unknown>;\n const ref = obj.$ref;\n if (typeof ref === 'string' && ref.startsWith(DEFS_PREFIX)) {\n obj.$ref = COMPONENTS_SCHEMAS_PREFIX + ref.slice(DEFS_PREFIX.length);\n } else if (ref === '#' && selfRef !== undefined) {\n // Zod emits '#' for cycle refs back to the document root. When we lift a\n // named schema into its own components.schemas entry, '#' should resolve\n // to that entry's own URI.\n obj.$ref = selfRef;\n }\n for (const value of Object.values(obj)) {\n rewriteRefs(value, selfRef);\n }\n};\n\nexport const postProcess = (raw: SchemaObject): PostProcessResult => {\n const refs = new Map<string, SchemaObject>();\n const rawDefs = raw.$defs;\n if (rawDefs !== undefined) {\n for (const [id, body] of Object.entries(rawDefs)) {\n refs.set(id, body);\n }\n }\n\n const root: SchemaObject = { ...raw };\n delete root.$schema;\n delete root.$defs;\n\n // Root has no own self-uri at the 2a level. If the root is a bare `$ref` to a\n // lifted named schema (the common case when input itself has `.meta({ id })`),\n // we'll have already rewritten it to '#/components/schemas/<id>'.\n rewriteRefs(root, undefined);\n\n for (const [id, body] of refs) {\n rewriteRefs(body, `${COMPONENTS_SCHEMAS_PREFIX}${id}`);\n }\n\n return { schema: root, refs };\n};\n","import { z } from 'zod';\n\nimport type { SchemaObject } from './openapi.types.js';\nimport type { Override } from './override.js';\nimport type { ZodNestRegistry } from './registry.js';\n\nimport { ZOD_NEST_ERROR_DUPLICATE_ID, ZOD_NEST_ERROR_EXTENSION } from './constants.js';\nimport { ZodNestUnrepresentableError } from './errors.js';\nimport { builtInOverride, combine, isStrictlyUnrepresentable } from './override.js';\nimport { postProcess } from './post-process.js';\n\nexport interface ToOpenApiOptions {\n io: 'input' \| 'output';\n registry: ZodNestRegistry;\n override?: Override;\n strict?: boolean;\n}\n\nexport interface ToOpenApiResult {\n schema: SchemaObject;\n refs: Map<string, SchemaObject>;\n}\n\ninterface UnrepresentableHit {\n path: (string \| number)[];\n zodType: string;\n}\n\nexport const toOpenApi = (schema: z.ZodType, opts: ToOpenApiOptions): ToOpenApiResult => {\n const strict = opts.strict ?? true;\n const merged = combine(builtInOverride, opts.override);\n const unrepresentableHits: UnrepresentableHit[] = [];\n\n const wrapped: Override = (ctx) => {\n merged(ctx);\n if (!strict \|\| !isStrictlyUnrepresentable(ctx.jsonSchema, ctx.zodSchema)) {\n return;\n }\n unrepresentableHits.push({\n path: [...ctx.path],\n zodType: ctx.zodSchema._zod.def.type,\n });\n };\n\n const raw = z.toJSONSchema(schema, {\n target: 'draft-2020-12',\n io: opts.io,\n unrepresentable: 'any',\n metadata: opts.registry.zodRegistry,\n override: wrapped,\n cycles: 'ref',\n reused: 'inline',\n });\n\n const firstHit = unrepresentableHits[0];\n if (firstHit !== undefined) {\n throw new ZodNestUnrepresentableError(firstHit.path, firstHit.zodType);\n }\n\n const result = postProcess(raw);\n\n for (const [id] of opts.registry.getCollisions()) {\n if (!result.refs.has(id)) {\n continue;\n }\n result.refs.set(id, {\n description: `ERROR: duplicate zod-nest id <${id}>`,\n [ZOD_NEST_ERROR_EXTENSION]: ZOD_NEST_ERROR_DUPLICATE_ID,\n });\n }\n\n return result;\n};\n","import { z } from 'zod';\n\nexport interface ZodNestRegistry {\n readonly zodRegistry: typeof z.globalRegistry;\n register(schema: z.ZodType, id: string): void;\n hasCollision(id: string): boolean;\n getCollisions(): ReadonlyMap<string, ReadonlySet<z.ZodType>>;\n}\n\nexport const createRegistry = (): ZodNestRegistry => {\n const seen = new Map<string, Set<z.ZodType>>();\n\n return {\n zodRegistry: z.globalRegistry,\n register: (schema, id) => {\n z.globalRegistry.add(schema, { id });\n let set = seen.get(id);\n if (set === undefined) {\n set = new Set<z.ZodType>();\n seen.set(id, set);\n }\n set.add(schema);\n },\n hasCollision: (id) => {\n const set = seen.get(id);\n return set !== undefined && set.size > 1;\n },\n getCollisions: () => {\n const out = new Map<string, Set<z.ZodType>>();\n for (const [id, set] of seen) {\n if (set.size <= 1) {\n continue;\n }\n out.set(id, set);\n }\n return out;\n },\n };\n};\n"]}

package/dist/index.mjs CHANGED Viewed

@@ -1,3 +1,196 @@
+import { z } from 'zod';
+// src/schema/constants.ts
+var COMPONENTS_SCHEMAS_PREFIX = "#/components/schemas/";
+var ZOD_NEST_ERROR_EXTENSION = "x-zod-nest-error";
+var ZOD_NEST_ERROR_DUPLICATE_ID = "duplicate-id";
+// src/schema/errors.ts
+var ZodNestError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ZodNestError";
+  }
+};
+var ZodNestUnrepresentableError = class extends ZodNestError {
+  path;
+  zodType;
+  constructor(path, zodType) {
+    super(
+      `Unrepresentable Zod schema \`${zodType}\` at ${formatPath(path)}: no override produced a JSON Schema body. Set strict: false to emit \`{}\` instead, or supply an \`override\` that handles this Zod type.`
+    );
+    this.name = "ZodNestUnrepresentableError";
+    this.path = path;
+    this.zodType = zodType;
+  }
+};
+var formatPath = (path) => {
+  if (path.length === 0) {
+    return "<root>";
+  }
+  return "/" + path.map(String).join("/");
+};
+// src/schema/override.ts
+var builtInOverride = ({ zodSchema, jsonSchema }) => {
+  const type = zodSchema._zod.def.type;
+  if (type === "bigint") {
+    jsonSchema.type = "integer";
+    return;
+  }
+  if (type === "date") {
+    jsonSchema.type = "string";
+    jsonSchema.format = "date-time";
+    return;
+  }
+};
+var STRICT_REQUIRES_OVERRIDE = /* @__PURE__ */ new Set([
+  "bigint",
+  "date",
+  "symbol",
+  "undefined",
+  "void",
+  "map",
+  "set",
+  "transform",
+  "nan",
+  "custom"
+]);
+var isStrictlyUnrepresentable = (jsonSchema, zodSchema) => {
+  if (!STRICT_REQUIRES_OVERRIDE.has(zodSchema._zod.def.type)) {
+    return false;
+  }
+  return Object.keys(jsonSchema).length === 0;
+};
+var combine = (...overrides) => {
+  const list = [];
+  for (const candidate of overrides) {
+    if (typeof candidate !== "function") {
+      continue;
+    }
+    list.push(candidate);
+  }
+  if (list.length === 0) {
+    return () => void 0;
+  }
+  return (ctx) => {
+    for (const o of list) {
+      o(ctx);
+    }
+  };
+};
+// src/schema/post-process.ts
+var DEFS_PREFIX = "#/$defs/";
+var rewriteRefs = (node, selfRef) => {
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      rewriteRefs(item, selfRef);
+    }
+    return;
+  }
+  if (node === null || typeof node !== "object") {
+    return;
+  }
+  const obj = node;
+  const ref = obj.$ref;
+  if (typeof ref === "string" && ref.startsWith(DEFS_PREFIX)) {
+    obj.$ref = COMPONENTS_SCHEMAS_PREFIX + ref.slice(DEFS_PREFIX.length);
+  } else if (ref === "#" && selfRef !== void 0) {
+    obj.$ref = selfRef;
+  }
+  for (const value of Object.values(obj)) {
+    rewriteRefs(value, selfRef);
+  }
+};
+var postProcess = (raw) => {
+  const refs = /* @__PURE__ */ new Map();
+  const rawDefs = raw.$defs;
+  if (rawDefs !== void 0) {
+    for (const [id, body] of Object.entries(rawDefs)) {
+      refs.set(id, body);
+    }
+  }
+  const root = { ...raw };
+  delete root.$schema;
+  delete root.$defs;
+  rewriteRefs(root, void 0);
+  for (const [id, body] of refs) {
+    rewriteRefs(body, `${COMPONENTS_SCHEMAS_PREFIX}${id}`);
+  }
+  return { schema: root, refs };
+};
+// src/schema/engine.ts
+var toOpenApi = (schema, opts) => {
+  const strict = opts.strict ?? true;
+  const merged = combine(builtInOverride, opts.override);
+  const unrepresentableHits = [];
+  const wrapped = (ctx) => {
+    merged(ctx);
+    if (!strict || !isStrictlyUnrepresentable(ctx.jsonSchema, ctx.zodSchema)) {
+      return;
+    }
+    unrepresentableHits.push({
+      path: [...ctx.path],
+      zodType: ctx.zodSchema._zod.def.type
+    });
+  };
+  const raw = z.toJSONSchema(schema, {
+    target: "draft-2020-12",
+    io: opts.io,
+    unrepresentable: "any",
+    metadata: opts.registry.zodRegistry,
+    override: wrapped,
+    cycles: "ref",
+    reused: "inline"
+  });
+  const firstHit = unrepresentableHits[0];
+  if (firstHit !== void 0) {
+    throw new ZodNestUnrepresentableError(firstHit.path, firstHit.zodType);
+  }
+  const result = postProcess(raw);
+  for (const [id] of opts.registry.getCollisions()) {
+    if (!result.refs.has(id)) {
+      continue;
+    }
+    result.refs.set(id, {
+      description: `ERROR: duplicate zod-nest id <${id}>`,
+      [ZOD_NEST_ERROR_EXTENSION]: ZOD_NEST_ERROR_DUPLICATE_ID
+    });
+  }
+  return result;
+};
+var createRegistry = () => {
+  const seen = /* @__PURE__ */ new Map();
+  return {
+    zodRegistry: z.globalRegistry,
+    register: (schema, id) => {
+      z.globalRegistry.add(schema, { id });
+      let set = seen.get(id);
+      if (set === void 0) {
+        set = /* @__PURE__ */ new Set();
+        seen.set(id, set);
+      }
+      set.add(schema);
+    },
+    hasCollision: (id) => {
+      const set = seen.get(id);
+      return set !== void 0 && set.size > 1;
+    },
+    getCollisions: () => {
+      const out = /* @__PURE__ */ new Map();
+      for (const [id, set] of seen) {
+        if (set.size <= 1) {
+          continue;
+        }
+        out.set(id, set);
+      }
+      return out;
+    }
+  };
+};
+export { COMPONENTS_SCHEMAS_PREFIX, ZOD_NEST_ERROR_DUPLICATE_ID, ZOD_NEST_ERROR_EXTENSION, ZodNestError, ZodNestUnrepresentableError, createRegistry, toOpenApi };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
1	+ {"version":3,"sources":["../src/schema/constants.ts","../src/schema/errors.ts","../src/schema/override.ts","../src/schema/post-process.ts","../src/schema/engine.ts","../src/schema/registry.ts"],"names":["z"],"mappings":"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","file":"index.mjs","sourcesContent":["/** OpenAPI 3.1 `$ref` prefix for entries in `components.schemas`. /\nexport const COMPONENTS_SCHEMAS_PREFIX = '#/components/schemas/';\n\n/* OpenAPI extension key zod-nest uses to surface engine errors inside emitted schemas. /\nexport const ZOD_NEST_ERROR_EXTENSION = 'x-zod-nest-error';\n\n/* Value of `x-zod-nest-error` when a registry id is claimed by more than one schema. */\nexport const ZOD_NEST_ERROR_DUPLICATE_ID = 'duplicate-id';\n","export class ZodNestError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'ZodNestError';\n }\n}\n\nexport class ZodNestUnrepresentableError extends ZodNestError {\n readonly path: ReadonlyArray<string \| number>;\n readonly zodType: string;\n\n constructor(path: ReadonlyArray<string \| number>, zodType: string) {\n super(\n `Unrepresentable Zod schema \\`${zodType}\\` at ${formatPath(path)}: no override produced ` +\n `a JSON Schema body. Set strict: false to emit \\`{}\\` instead, or supply an \\`override\\` ` +\n `that handles this Zod type.`,\n );\n this.name = 'ZodNestUnrepresentableError';\n this.path = path;\n this.zodType = zodType;\n }\n}\n\nconst formatPath = (path: ReadonlyArray<string \| number>): string => {\n if (path.length === 0) {\n return '<root>';\n }\n return '/' + path.map(String).join('/');\n};\n","import type { $ZodTypes } from 'zod/v4/core';\nimport type { SchemaObject } from './openapi.types.js';\n\nexport interface OverrideContext {\n zodSchema: $ZodTypes;\n jsonSchema: SchemaObject;\n path: (string \| number)[];\n}\n\nexport type Override = (ctx: OverrideContext) => void;\n\nexport const builtInOverride: Override = ({ zodSchema, jsonSchema }) => {\n const type = zodSchema._zod.def.type;\n if (type === 'bigint') {\n jsonSchema.type = 'integer';\n return;\n }\n if (type === 'date') {\n jsonSchema.type = 'string';\n jsonSchema.format = 'date-time';\n return;\n }\n};\n\nconst STRICT_REQUIRES_OVERRIDE: ReadonlySet<string> = new Set([\n 'bigint',\n 'date',\n 'symbol',\n 'undefined',\n 'void',\n 'map',\n 'set',\n 'transform',\n 'nan',\n 'custom',\n]);\n\nexport const isStrictlyUnrepresentable = (\n jsonSchema: SchemaObject,\n zodSchema: $ZodTypes,\n): boolean => {\n if (!STRICT_REQUIRES_OVERRIDE.has(zodSchema._zod.def.type)) {\n return false;\n }\n return Object.keys(jsonSchema).length === 0;\n};\n\nexport const combine = (...overrides: ReadonlyArray<Override \| undefined>): Override => {\n const list: Override[] = [];\n for (const candidate of overrides) {\n if (typeof candidate !== 'function') {\n continue;\n }\n list.push(candidate);\n }\n if (list.length === 0) {\n return () => undefined;\n }\n return (ctx) => {\n for (const o of list) {\n o(ctx);\n }\n };\n};\n","import type { SchemaObject } from './openapi.types.js';\n\nimport { COMPONENTS_SCHEMAS_PREFIX } from './constants.js';\n\nexport interface PostProcessResult {\n schema: SchemaObject;\n refs: Map<string, SchemaObject>;\n}\n\nconst DEFS_PREFIX = '#/$defs/';\n\nconst rewriteRefs = (node: unknown, selfRef: string \| undefined): void => {\n if (Array.isArray(node)) {\n for (const item of node) {\n rewriteRefs(item, selfRef);\n }\n return;\n }\n if (node === null \|\| typeof node !== 'object') {\n return;\n }\n const obj = node as Record<string, unknown>;\n const ref = obj.$ref;\n if (typeof ref === 'string' && ref.startsWith(DEFS_PREFIX)) {\n obj.$ref = COMPONENTS_SCHEMAS_PREFIX + ref.slice(DEFS_PREFIX.length);\n } else if (ref === '#' && selfRef !== undefined) {\n // Zod emits '#' for cycle refs back to the document root. When we lift a\n // named schema into its own components.schemas entry, '#' should resolve\n // to that entry's own URI.\n obj.$ref = selfRef;\n }\n for (const value of Object.values(obj)) {\n rewriteRefs(value, selfRef);\n }\n};\n\nexport const postProcess = (raw: SchemaObject): PostProcessResult => {\n const refs = new Map<string, SchemaObject>();\n const rawDefs = raw.$defs;\n if (rawDefs !== undefined) {\n for (const [id, body] of Object.entries(rawDefs)) {\n refs.set(id, body);\n }\n }\n\n const root: SchemaObject = { ...raw };\n delete root.$schema;\n delete root.$defs;\n\n // Root has no own self-uri at the 2a level. If the root is a bare `$ref` to a\n // lifted named schema (the common case when input itself has `.meta({ id })`),\n // we'll have already rewritten it to '#/components/schemas/<id>'.\n rewriteRefs(root, undefined);\n\n for (const [id, body] of refs) {\n rewriteRefs(body, `${COMPONENTS_SCHEMAS_PREFIX}${id}`);\n }\n\n return { schema: root, refs };\n};\n","import { z } from 'zod';\n\nimport type { SchemaObject } from './openapi.types.js';\nimport type { Override } from './override.js';\nimport type { ZodNestRegistry } from './registry.js';\n\nimport { ZOD_NEST_ERROR_DUPLICATE_ID, ZOD_NEST_ERROR_EXTENSION } from './constants.js';\nimport { ZodNestUnrepresentableError } from './errors.js';\nimport { builtInOverride, combine, isStrictlyUnrepresentable } from './override.js';\nimport { postProcess } from './post-process.js';\n\nexport interface ToOpenApiOptions {\n io: 'input' \| 'output';\n registry: ZodNestRegistry;\n override?: Override;\n strict?: boolean;\n}\n\nexport interface ToOpenApiResult {\n schema: SchemaObject;\n refs: Map<string, SchemaObject>;\n}\n\ninterface UnrepresentableHit {\n path: (string \| number)[];\n zodType: string;\n}\n\nexport const toOpenApi = (schema: z.ZodType, opts: ToOpenApiOptions): ToOpenApiResult => {\n const strict = opts.strict ?? true;\n const merged = combine(builtInOverride, opts.override);\n const unrepresentableHits: UnrepresentableHit[] = [];\n\n const wrapped: Override = (ctx) => {\n merged(ctx);\n if (!strict \|\| !isStrictlyUnrepresentable(ctx.jsonSchema, ctx.zodSchema)) {\n return;\n }\n unrepresentableHits.push({\n path: [...ctx.path],\n zodType: ctx.zodSchema._zod.def.type,\n });\n };\n\n const raw = z.toJSONSchema(schema, {\n target: 'draft-2020-12',\n io: opts.io,\n unrepresentable: 'any',\n metadata: opts.registry.zodRegistry,\n override: wrapped,\n cycles: 'ref',\n reused: 'inline',\n });\n\n const firstHit = unrepresentableHits[0];\n if (firstHit !== undefined) {\n throw new ZodNestUnrepresentableError(firstHit.path, firstHit.zodType);\n }\n\n const result = postProcess(raw);\n\n for (const [id] of opts.registry.getCollisions()) {\n if (!result.refs.has(id)) {\n continue;\n }\n result.refs.set(id, {\n description: `ERROR: duplicate zod-nest id <${id}>`,\n [ZOD_NEST_ERROR_EXTENSION]: ZOD_NEST_ERROR_DUPLICATE_ID,\n });\n }\n\n return result;\n};\n","import { z } from 'zod';\n\nexport interface ZodNestRegistry {\n readonly zodRegistry: typeof z.globalRegistry;\n register(schema: z.ZodType, id: string): void;\n hasCollision(id: string): boolean;\n getCollisions(): ReadonlyMap<string, ReadonlySet<z.ZodType>>;\n}\n\nexport const createRegistry = (): ZodNestRegistry => {\n const seen = new Map<string, Set<z.ZodType>>();\n\n return {\n zodRegistry: z.globalRegistry,\n register: (schema, id) => {\n z.globalRegistry.add(schema, { id });\n let set = seen.get(id);\n if (set === undefined) {\n set = new Set<z.ZodType>();\n seen.set(id, set);\n }\n set.add(schema);\n },\n hasCollision: (id) => {\n const set = seen.get(id);\n return set !== undefined && set.size > 1;\n },\n getCollisions: () => {\n const out = new Map<string, Set<z.ZodType>>();\n for (const [id, set] of seen) {\n if (set.size <= 1) {\n continue;\n }\n out.set(id, set);\n }\n return out;\n },\n };\n};\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "zod-nest",
-  "version": "0.0.0-alpha.0",
+  "version": "0.1.5",
   "description": "Modern Zod v4-only NestJS + OpenAPI 3.1 integration. Successor to nestjs-zod.",
   "license": "MIT",
   "author": "Rodrigo Azevedo",
@@ -22,7 +22,7 @@
     "typescript"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -64,7 +64,7 @@
     "@nestjs/core": ">=10",
     "@nestjs/swagger": ">=8",
     "rxjs": ">=7",
-    "zod": ">=4.0.0"
+    "zod": ">=4.4.0"
   },
   "devDependencies": {
     "@ianvs/prettier-plugin-sort-imports": "^4.4.0",
@@ -72,11 +72,12 @@
     "@nestjs/core": "^11.0.0",
     "@nestjs/swagger": "^11.0.0",
     "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.0",
     "@semantic-release/npm": "^12.0.0",
     "@types/jest": "^29.5.14",
-    "@types/node": "^20.17.0",
+    "@types/node": "^22.10.0",
     "eslint": "^9.16.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-jest": "^28.10.0",
@@ -95,7 +96,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.18.0",
-    "zod": "^4.0.0"
+    "zod": "^4.4.0"
   },
   "lint-staged": {
     "*.ts": [