zod-nest 1.7.0 → 1.8.0

package/README.md

@@ -493,15 +493,15 @@ See [`docs/recipes/custom-openapi-overrides.md`](docs/recipes/custom-openapi-ove
 
 ## Compatibility matrix
 
-`zod-nest` declares explicit min + max peer-dep ranges in `package.json`: `zod >=4.4.0 <5.0.0`, `@nestjs/common >=11.0.1 <12.0.0`, `@nestjs/core >=11.0.1 <12.0.0`, `@nestjs/swagger >=11.0.0 <12.0.0`, `rxjs >=7.1.0 <8.0.0`, `reflect-metadata >=0.2.0 <0.3.0`, Node `>=22`. CI validates those claims by running the full test suite against the cells below; a red cell is a real blocker. Upper bounds are deliberate — a new peer major has to land in a real PR with a `/check-upstream-updates` audit before consumers can install it against this library.
+`zod-nest` declares explicit min + max peer-dep ranges in `package.json`: `zod >=4.4.0 <5.0.0`, `@nestjs/common >=11.0.1 <12.0.0`, `@nestjs/core >=11.0.1 <12.0.0`, `@nestjs/swagger >=11.0.0 <12.0.0`, `rxjs >=7.6.0 <8.0.0`, `reflect-metadata >=0.2.0 <0.3.0`, Node `>=22`. CI validates those claims by running the full test suite against the cells below; a red cell is a real blocker. Upper bounds are deliberate — a new peer major has to land in a real PR with a `/check-upstream-updates` audit before consumers can install it against this library.
 
 | Cell | `zod` | `@nestjs/common` | `@nestjs/core` | `@nestjs/swagger` | `rxjs` | `reflect-metadata` |
 |---|---|---|---|---|---|---|
-| `floor` | 4.4.0 | 11.0.1 | 11.0.1 | 11.0.0 | 7.1.0 | 0.2.0 |
-| `zod-latest` | latest | 11.0.1 | 11.0.1 | 11.0.0 | 7.1.0 | 0.2.0 |
-| `nest-latest` | 4.4.0 | latest | latest | latest | 7.1.0 | 0.2.0 |
+| `floor` | 4.4.0 | 11.0.1 | 11.0.1 | 11.0.0 | 7.6.0 | 0.2.0 |
+| `zod-latest` | latest | 11.0.1 | 11.0.1 | 11.0.0 | 7.6.0 | 0.2.0 |
+| `nest-latest` | 4.4.0 | latest | latest | latest | 7.6.0 | 0.2.0 |
 | `rxjs-latest` | 4.4.0 | 11.0.1 | 11.0.1 | 11.0.0 | latest | 0.2.0 |
-| `reflect-metadata-latest` | 4.4.0 | 11.0.1 | 11.0.1 | 11.0.0 | 7.1.0 | latest |
+| `reflect-metadata-latest` | 4.4.0 | 11.0.1 | 11.0.1 | 11.0.0 | 7.6.0 | latest |
 | `all-latest` | latest | latest | latest | latest | latest | latest |
 
 Cell definitions live in [`.github/compat-matrix.json`](.github/compat-matrix.json). The CI workflow ([`.github/workflows/compat-matrix.yml`](.github/workflows/compat-matrix.yml)) runs on every push to `main` and weekly on Monday — when a cell fails, the workflow opens (or comments on) a GitHub issue labelled `compat-matrix-failure` so the regression is tracked outside the Actions UI. Editing the JSON is the formal way to extend or shrink supported ranges. Node is not matrixed — the `>=22` floor is enforced by `engines`.

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,
@@ -1419,9 +1513,9 @@ var runPass = /* @__PURE__ */ __name((opts, io, knownIds) => {
   const raw = zod.z.toJSONSchema(opts.registry.zodRegistry, built.options);
   built.consumeUnrepresentable();
   const filtered = /* @__PURE__ */ new Map();
-  for (const id of knownIds) {
-    if (Object.prototype.hasOwnProperty.call(raw.schemas, id)) {
-      filtered.set(id, raw.schemas[id]);
+  for (const [id, schema] of Object.entries(raw.schemas)) {
+    if (knownIds.has(id)) {
+      filtered.set(id, schema);
     }
   }
   return filtered;