zod-nest 1.8.0 → 1.9.0

package/README.md

@@ -148,6 +148,8 @@ Every DTO is one Zod schema wrapped in a class. The class exists so NestJS' intr
 
 The class returned by `createZodDto(schema)` carries `schema`, `id`, `io: 'input'`, and a lazy `Output` sibling. `parse` / `safeParse` are static methods on the class. The class is tagged with `Symbol.for('zod-nest.dto')` so `ZodValidationPipe` and `ZodSerializerInterceptor` can discriminate it from plain constructors. The id comes from `schema.meta({ id })` when present (preferred) or from the second-argument options.
 
+**Naming is exposing.** Every schema put through `registerSchema()` — directly, or transitively via `createZodDto` / `@ZodBody` / `extend` / descendant discovery — lands in `components.schemas` when `applyZodNest` runs, regardless of whether any `$ref` in the doc points at it. If you give a schema `.meta({ id })`, you're declaring it documented. Anonymous schemas without an id stay inlined where used.
+
 See [`docs/dto.md`](docs/dto.md) for the full surface.
 
 ### Schemas that don't fit a class

package/dist/index.js

@@ -1263,6 +1263,7 @@ var flattenObjectIntersection = /* @__PURE__ */ __name((schema, registry, decora
     }
   }
   const merged = zod.z.object(mergedShape);
+  registerSchema(schema, registry);
   for (const [child, childId] of discoverDependents(schema)) {
     registry.register(child, childId);
   }
@@ -1552,6 +1553,31 @@ var forEachOperation = /* @__PURE__ */ __name((doc, fn) => {
   }
 }, "forEachOperation");
 
+// src/document/walk-refs.ts
+var walkRefs = /* @__PURE__ */ __name((node, visit) => {
+  if (node === null || typeof node !== "object") {
+    return;
+  }
+  if (Array.isArray(node)) {
+    for (const item of node) {
+      walkRefs(item, visit);
+    }
+    return;
+  }
+  const obj = node;
+  for (const key of Object.keys(obj)) {
+    const value = obj[key];
+    if (key === "$ref" && typeof value === "string") {
+      const next = visit(value);
+      if (next !== void 0) {
+        obj[key] = next;
+      }
+      continue;
+    }
+    walkRefs(value, visit);
+  }
+}, "walkRefs");
+
 // src/document/collect-usage.ts
 var isPlainRecord2 = /* @__PURE__ */ __name((value) => value !== null && typeof value === "object" && !Array.isArray(value), "isPlainRecord");
 var collectUsage = /* @__PURE__ */ __name((doc, app, registry) => {
@@ -1655,19 +1681,19 @@ var collectRefFromSchema = /* @__PURE__ */ __name((schema, classToDtoId, knownId
   if (!isPlainRecord2(schema)) {
     return;
   }
-  const ref = schema.$ref;
-  if (typeof ref !== "string" || !ref.startsWith(COMPONENTS_SCHEMAS_PREFIX)) {
-    return;
-  }
-  const className = ref.slice(COMPONENTS_SCHEMAS_PREFIX.length);
-  const renamed = classToDtoId.get(className);
-  if (renamed !== void 0) {
-    ids.add(renamed);
-    return;
-  }
-  if (knownIds.has(className)) {
-    ids.add(className);
-  }
+  walkRefs(schema, (ref) => {
+    if (!ref.startsWith(COMPONENTS_SCHEMAS_PREFIX)) {
+      return void 0;
+    }
+    const className = ref.slice(COMPONENTS_SCHEMAS_PREFIX.length);
+    const renamed = classToDtoId.get(className);
+    if (renamed !== void 0) {
+      ids.add(renamed);
+    } else if (knownIds.has(className)) {
+      ids.add(className);
+    }
+    return void 0;
+  });
 }, "collectRefFromSchema");
 var collectOutputExposedIds = /* @__PURE__ */ __name((app) => {
   const ids = /* @__PURE__ */ new Set();
@@ -1729,31 +1755,6 @@ var ZodNestDocumentError = class extends ZodNestError {
   }
 };
 
-// src/document/walk-refs.ts
-var walkRefs = /* @__PURE__ */ __name((node, visit) => {
-  if (node === null || typeof node !== "object") {
-    return;
-  }
-  if (Array.isArray(node)) {
-    for (const item of node) {
-      walkRefs(item, visit);
-    }
-    return;
-  }
-  const obj = node;
-  for (const key of Object.keys(obj)) {
-    const value = obj[key];
-    if (key === "$ref" && typeof value === "string") {
-      const next = visit(value);
-      if (next !== void 0) {
-        obj[key] = next;
-      }
-      continue;
-    }
-    walkRefs(value, visit);
-  }
-}, "walkRefs");
-
 // src/document/dangling-refs.ts
 var assertNoDanglingRefs = /* @__PURE__ */ __name((params) => {
   const { doc, collected } = params;
@@ -2147,16 +2148,35 @@ var stripMarkerFromSchema = /* @__PURE__ */ __name((schema) => {
 }, "stripMarkerFromSchema");
 
 // src/document/apply-zod-nest.ts
+var withRegistryExposure = /* @__PURE__ */ __name((collected, registry) => {
+  const alreadyExposed = /* @__PURE__ */ new Set([
+    ...collected.inputExposedIds,
+    ...collected.outputExposedIds
+  ]);
+  const extras = registry.ids().filter((id) => !alreadyExposed.has(id));
+  if (extras.length === 0) {
+    return collected;
+  }
+  return {
+    inputExposedIds: /* @__PURE__ */ new Set([
+      ...collected.inputExposedIds,
+      ...extras
+    ]),
+    outputExposedIds: collected.outputExposedIds,
+    classToDtoId: collected.classToDtoId
+  };
+}, "withRegistryExposure");
 var OPENAPI_VERSION = "3.1.0";
 var applyZodNest = /* @__PURE__ */ __name((doc, opts) => {
   const registry = opts.registry ?? defaultRegistry;
   const collected = collectUsage(doc, opts.app, registry);
+  const exposed = withRegistryExposure(collected, registry);
   const { inputSchemas, outputSchemas } = bulkEmit({
     registry,
     override: opts.override,
     strict: opts.strict
   });
-  const extended = extendExposureViaRefs(collected, inputSchemas, outputSchemas);
+  const extended = extendExposureViaRefs(exposed, inputSchemas, outputSchemas);
   const { divergentOutputIds, renames } = mergeSchemas({
     doc,
     inputSchemas,