zod-nest 1.7.1 → 1.8.0

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,