zod-nest 1.7.1 → 1.8.1

package/dist/index.d.mts

@@ -496,6 +496,15 @@ interface ZodBodyOptions {
     readonly description?: string;
     /** Whether the body is required. Defaults to `true`. */
     readonly required?: boolean;
+    /**
+     * Merge an intersection of `z.object` arms into a single flat object body
+     * emitted inline (no `$ref`, no `components.schemas` entry). Use when
+     * Swagger UI's `multipart/form-data` `try-it-out` form needs to render the
+     * body — the UI doesn't follow `$ref` or unwrap `allOf`. Throws
+     * `ZodNestError` if the schema isn't an object or an intersection of
+     * objects. No-op for a bare `z.object`. Defaults to `false`.
+     */
+    readonly flatten?: boolean;
 }
 /**
  * Method-level decorator that wires the OpenAPI `requestBody` for a handler

package/dist/index.d.ts

@@ -496,6 +496,15 @@ interface ZodBodyOptions {
     readonly description?: string;
     /** Whether the body is required. Defaults to `true`. */
     readonly required?: boolean;
+    /**
+     * Merge an intersection of `z.object` arms into a single flat object body
+     * emitted inline (no `$ref`, no `components.schemas` entry). Use when
+     * Swagger UI's `multipart/form-data` `try-it-out` form needs to render the
+     * body — the UI doesn't follow `$ref` or unwrap `allOf`. Throws
+     * `ZodNestError` if the schema isn't an object or an intersection of
+     * objects. No-op for a bare `z.object`. Defaults to `false`.
+     */
+    readonly flatten?: boolean;
 }
 /**
  * Method-level decorator that wires the OpenAPI `requestBody` for a handler

package/dist/index.js

@@ -1157,22 +1157,6 @@ var resolveSchemaRef = /* @__PURE__ */ __name((schema, options) => {
   };
 }, "resolveSchemaRef");
 
-// src/decorators/zod-body.decorator.ts
-var ZodBody = /* @__PURE__ */ __name((schema, options) => {
-  const resolution = resolveSchemaRef(schema, {
-    id: options?.id,
-    registry: options?.registry
-  });
-  const apiBodySchema = resolution.kind === "ref" ? resolution.ref : resolution.schema;
-  return swagger.ApiBody({
-    schema: apiBodySchema,
-    ...options?.description !== void 0 ? {
-      description: options.description
-    } : {},
-    required: options?.required ?? true
-  });
-}, "ZodBody");
-
 // src/decorators/internal/zod-param-expand.ts
 var isZodObject = /* @__PURE__ */ __name((schema) => schema._zod.def.type === "object", "isZodObject");
 var expandObjectSchema = /* @__PURE__ */ __name((schema, options) => {
@@ -1199,7 +1183,117 @@ var expandObjectSchema = /* @__PURE__ */ __name((schema, options) => {
 }, "expandObjectSchema");
 var paramSchemaBody = /* @__PURE__ */ __name((resolution) => resolution.kind === "ref" ? resolution.ref : resolution.schema, "paramSchemaBody");
 
-// src/decorators/zod-query.decorator.ts
+// src/decorators/internal/flatten-intersection.ts
+var intersectionArms = /* @__PURE__ */ __name((schema) => {
+  if (schema._zod.def.type !== "intersection") {
+    return null;
+  }
+  const def = schema._zod.def;
+  return {
+    left: def.left,
+    right: def.right
+  };
+}, "intersectionArms");
+var unionOptions = /* @__PURE__ */ __name((schema) => {
+  if (schema._zod.def.type !== "union") {
+    return null;
+  }
+  const def = schema._zod.def;
+  return def.options;
+}, "unionOptions");
+var collectObjectShapes = /* @__PURE__ */ __name((schema) => {
+  if (isZodObject(schema)) {
+    return {
+      shapes: [
+        schema.shape
+      ],
+      unionCrossed: false
+    };
+  }
+  const options = unionOptions(schema);
+  if (options !== null) {
+    const allShapes = [];
+    for (const variant of options) {
+      const variantResult = collectObjectShapes(variant);
+      if (variantResult === null) {
+        return null;
+      }
+      allShapes.push(...variantResult.shapes);
+    }
+    return {
+      shapes: allShapes,
+      unionCrossed: true
+    };
+  }
+  const arms = intersectionArms(schema);
+  if (arms === null) {
+    return null;
+  }
+  const left = collectObjectShapes(arms.left);
+  if (left === null) {
+    return null;
+  }
+  const right = collectObjectShapes(arms.right);
+  if (right === null) {
+    return null;
+  }
+  return {
+    shapes: [
+      ...left.shapes,
+      ...right.shapes
+    ],
+    unionCrossed: left.unionCrossed || right.unionCrossed
+  };
+}, "collectObjectShapes");
+var flattenObjectIntersection = /* @__PURE__ */ __name((schema, registry, decoratorName) => {
+  const collected = collectObjectShapes(schema);
+  if (collected === null) {
+    throw new ZodNestError(`${decoratorName} \`flatten: true\` requires every leaf of the schema to be a \`z.object({...})\` \u2014 intersections and unions of objects are supported, but primitives, tuples, transforms, and other non-object leaves are not. Drop \`flatten: true\` to emit the original schema with its composition intact.`);
+  }
+  const mergedShape = {};
+  for (const shape of collected.shapes) {
+    Object.assign(mergedShape, shape);
+  }
+  if (collected.unionCrossed) {
+    for (const key of Object.keys(mergedShape)) {
+      const value = mergedShape[key];
+      if (value !== void 0) {
+        mergedShape[key] = value.optional();
+      }
+    }
+  }
+  const merged = zod.z.object(mergedShape);
+  for (const [child, childId] of discoverDependents(schema)) {
+    registry.register(child, childId);
+  }
+  const { schema: body } = toOpenApi(merged, {
+    io: "input",
+    registry
+  });
+  return body;
+}, "flattenObjectIntersection");
+
+// src/decorators/zod-body.decorator.ts
+var ZodBody = /* @__PURE__ */ __name((schema, options) => {
+  const apiBodySchema = resolveBodySchema(schema, options);
+  return swagger.ApiBody({
+    schema: apiBodySchema,
+    ...options?.description !== void 0 ? {
+      description: options.description
+    } : {},
+    required: options?.required ?? true
+  });
+}, "ZodBody");
+var resolveBodySchema = /* @__PURE__ */ __name((schema, options) => {
+  if (options?.flatten === true) {
+    return flattenObjectIntersection(schema, options.registry ?? defaultRegistry, "@ZodBody");
+  }
+  const resolution = resolveSchemaRef(schema, {
+    id: options?.id,
+    registry: options?.registry
+  });
+  return resolution.kind === "ref" ? resolution.ref : resolution.schema;
+}, "resolveBodySchema");
 var ZodQuery = /* @__PURE__ */ __name((schema, options) => {
   const expanded = expandObjectSchema(schema, {
     id: options?.id,
@@ -1458,6 +1552,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) => {
@@ -1561,19 +1680,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();
@@ -1635,31 +1754,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;