zod-nest 3.2.0 → 3.2.1

package/dist/chunk-4RXGLSPP.js

@@ -0,0 +1,73 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/schema/singleton.ts
+var SINGLETONS = /* @__PURE__ */ Symbol.for("zod-nest.singletons");
+var host = globalThis;
+var store = /* @__PURE__ */ __name(() => {
+  const existing = host[SINGLETONS];
+  if (existing !== void 0) {
+    return existing;
+  }
+  const created = /* @__PURE__ */ new Map();
+  host[SINGLETONS] = created;
+  return created;
+}, "store");
+var singleton = /* @__PURE__ */ __name((key, create) => {
+  const values = store();
+  const existing = values.get(key);
+  if (existing !== void 0) {
+    return existing;
+  }
+  const created = create();
+  values.set(key, created);
+  return created;
+}, "singleton");
+
+// src/schema/custom-override.ts
+var customOverrideMap = singleton("custom-override-map", () => /* @__PURE__ */ new WeakMap());
+var isWrapper = /* @__PURE__ */ __name((arg) => "input" in arg || "output" in arg, "isWrapper");
+var overrideJSONSchema = /* @__PURE__ */ __name((schema, arg) => {
+  const overrideSchema = isWrapper(arg) ? {
+    ...arg
+  } : {
+    input: arg,
+    output: arg
+  };
+  const schemaDescription = schema.description;
+  if (typeof schemaDescription === "string") {
+    overrideSchema.description = schemaDescription;
+  }
+  customOverrideMap.set(schema, overrideSchema);
+  return schema;
+}, "overrideJSONSchema");
+var peekRegistration = /* @__PURE__ */ __name((schema) => customOverrideMap.get(schema), "peekRegistration");
+var createCustomOverride = /* @__PURE__ */ __name((io) => {
+  return ({ zodSchema, jsonSchema }) => {
+    const record = customOverrideMap.get(zodSchema);
+    if (record === void 0) {
+      return;
+    }
+    const fragment = record[io];
+    if (fragment === void 0) {
+      return;
+    }
+    for (const key of Object.keys(jsonSchema)) {
+      Reflect.deleteProperty(jsonSchema, key);
+    }
+    Object.assign(jsonSchema, fragment);
+    if (fragment.description === void 0 && record.description !== void 0) {
+      jsonSchema.description = record.description;
+    }
+  };
+}, "createCustomOverride");
+
+exports.__name = __name;
+exports.createCustomOverride = createCustomOverride;
+exports.overrideJSONSchema = overrideJSONSchema;
+exports.peekRegistration = peekRegistration;
+exports.singleton = singleton;
+//# sourceMappingURL=chunk-4RXGLSPP.js.map
+//# sourceMappingURL=chunk-4RXGLSPP.js.map

package/dist/chunk-4RXGLSPP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/singleton.ts","../src/schema/custom-override.ts"],"names":["SINGLETONS","Symbol","for","host","globalThis","store","existing","undefined","created","Map","singleton","key","create","values","get","set","customOverrideMap","WeakMap","isWrapper","arg","overrideJSONSchema","schema","overrideSchema","input","output","schemaDescription","description","peekRegistration","createCustomOverride","io","zodSchema","jsonSchema","record","fragment","Object","keys","Reflect","deleteProperty","assign"],"mappings":"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","file":"chunk-4RXGLSPP.js","sourcesContent":["// Process-wide module state: each entry point is its own bundle, so a\n// module-level WeakMap would exist once per bundle, and once per copy of\n// the package in a consumer's tree.\nconst SINGLETONS = Symbol.for('zod-nest.singletons');\n\ninterface SingletonHost {\n  [SINGLETONS]?: Map<string, unknown>;\n}\n\n// `globalThis` has no type for symbol keys and a Map's values are `unknown`.\n// Both assertions live here so every call site stays cast-free.\nconst host = globalThis as SingletonHost;\n\nconst store = (): Map<string, unknown> => {\n  const existing = host[SINGLETONS];\n  if (existing !== undefined) {\n    return existing;\n  }\n  const created = new Map<string, unknown>();\n  host[SINGLETONS] = created;\n  return created;\n};\n\n// Callers own the key namespace and are the only writers, so the stored\n// type is theirs by construction. `create` must not return `undefined`.\nexport const singleton = <T>(key: string, create: () => T): T => {\n  const values = store();\n  const existing = values.get(key);\n  if (existing !== undefined) {\n    return existing as T;\n  }\n  const created = create();\n  values.set(key, created);\n  return created;\n};\n","import type { z } from 'zod';\nimport type { $ZodType } from 'zod/v4/core';\nimport type { SchemaObject } from './openapi.types.js';\nimport type { Override } from './override.js';\n\nimport { singleton } from './singleton.js';\n\n/**\n * Argument shape for {@link overrideJSONSchema}. Two forms:\n *\n * - A raw `SchemaObject` — applied to both input and output emission.\n * - A `{ input?, output? }` wrapper — distinct fragments per emission side,\n *   for coercion shapes where input and output diverge (e.g.\n *   `z.union([z.array(item), item.transform((v) => [v])])` accepts\n *   `T | T[]` on input but always emits `T[]` on output).\n *\n * The wrapper form is detected by the presence of an `input` or `output`\n * key. Neither is a JSON Schema / OpenAPI 3.1 keyword, so the discriminator\n * is unambiguous in practice.\n */\nexport type OverrideJSONSchemaArg = SchemaObject | { input?: SchemaObject; output?: SchemaObject };\n\nexport interface StoredFragments {\n  input?: SchemaObject;\n  output?: SchemaObject;\n  /**\n   * Description captured from the Zod schema at `overrideJSONSchema(...)` call\n   * time (`.describe(...)` / `.meta({ description })` both write to\n   * `z.globalRegistry`). Applied as a fallback at emission time when the\n   * per-direction fragment doesn't supply its own `description`. Fragment-\n   * supplied descriptions still win.\n   */\n  description?: string;\n}\n\n/**\n * Per-instance JSON Schema registration store. Keyed by the Zod core type\n * (`$ZodType`) because that's what the override sees on `ctx.zodSchema`;\n * `z.ZodType` widens to `$ZodType` without a cast at the public API boundary.\n * Same WeakMap pattern as `composition.ts`'s `lineageMap`\n * (CLAUDE.md: \"transient, per-instance → WeakMap\").\n *\n * Value holds the per-direction fragments separately so the override factory\n * can pick the right one without surfacing `io` on `OverrideContext`.\n */\nconst customOverrideMap = singleton(\n  'custom-override-map',\n  () => new WeakMap<$ZodType, StoredFragments>(),\n);\n\nconst isWrapper = (\n  arg: OverrideJSONSchemaArg,\n): arg is { input?: SchemaObject; output?: SchemaObject } => 'input' in arg || 'output' in arg;\n\n/**\n * Register a fixed JSON Schema fragment for a specific Zod schema instance.\n *\n * Designed for shapes JSON Schema can't model directly — `z.custom<T>()` and\n * `z.instanceof(...)` (e.g. multipart `File` fields) — which Zod emits as `{}`,\n * tripping `ZodNestUnrepresentableError` in strict mode. Also useful for\n * coercion shapes where input and output diverge (`singleOrArray`-style\n * helpers).\n *\n * Two call shapes:\n *\n * ```ts\n * // 1. Single fragment — applied verbatim to both input and output emission.\n * overrideJSONSchema(FileSchema, { type: 'string', format: 'binary' });\n *\n * // 2. Divergent fragments — separate fragments per emission side. Omit a\n * //    side to leave Zod's default emission untouched on that side.\n * overrideJSONSchema(arrayOrItem, {\n *   input:  { anyOf: [arrFrag, itemFrag] },\n *   output: arrFrag,\n * });\n * ```\n *\n * Idempotent: subsequent calls for the same schema overwrite the prior\n * registration (last-write-wins).\n */\nexport const overrideJSONSchema = <T extends z.ZodType>(\n  schema: T,\n  arg: OverrideJSONSchemaArg,\n): T => {\n  const overrideSchema: StoredFragments = isWrapper(arg) ? { ...arg } : { input: arg, output: arg };\n\n  const schemaDescription = schema.description;\n  if (typeof schemaDescription === 'string') {\n    overrideSchema.description = schemaDescription;\n  }\n\n  customOverrideMap.set(schema, overrideSchema);\n\n  return schema;\n};\n\n/**\n * Read-only lookup into the registration store. Used by the engine to detect\n * when a pipe-typed schema covers its inner descent target with a relevant-io\n * fragment — see `buildToJsonSchemaOptions` in `engine.ts`. Returning a\n * possibly-`undefined` `StoredFragments` keeps the engine ignorant of the\n * underlying WeakMap.\n */\nexport const peekRegistration = (schema: $ZodType): StoredFragments | undefined =>\n  customOverrideMap.get(schema);\n\n/**\n * Internal override factory consulted by the engine. Closes over the current\n * emission direction so the lookup can pick the right registered fragment\n * without surfacing `io` on the `OverrideContext` public contract. Mirrors\n * `createCompositionOverride` at `engine.ts:98`.\n *\n * Mutates `ctx.jsonSchema` in-place (clears existing keys, then assigns the\n * fragment) because Zod's override pipeline doesn't propagate\n * `ctx.jsonSchema = newObj` reassignments — only mutations on the existing\n * object reach the caller (see `composition.ts` for the same constraint).\n *\n * Falls back to the schema's captured `description` (from `.describe(...)` /\n * `.meta({ description })`) when the per-direction fragment doesn't supply\n * one. Captured at `overrideJSONSchema(...)` call time so the inheritance\n * doesn't depend on Zod's emission-time metadata pass. `title` is\n * deliberately not inherited.\n *\n * No-ops if the schema isn't registered, or if the registered record has no\n * fragment for the current `io` direction.\n */\nexport const createCustomOverride = (io: 'input' | 'output'): Override => {\n  return ({ zodSchema, jsonSchema }) => {\n    const record = customOverrideMap.get(zodSchema);\n    if (record === undefined) {\n      return;\n    }\n    const fragment = record[io];\n    if (fragment === undefined) {\n      return;\n    }\n    for (const key of Object.keys(jsonSchema)) {\n      Reflect.deleteProperty(jsonSchema, key);\n    }\n    Object.assign(jsonSchema, fragment);\n    if (fragment.description === undefined && record.description !== undefined) {\n      jsonSchema.description = record.description;\n    }\n  };\n};\n"]}