zod-nest 3.1.0 → 3.2.0

package/dist/{zod-multipart.decorator-CjiQkmkR.d.ts → param-decorators-CX1cUqfY.d.ts}

@@ -1,6 +1,55 @@
-import * as _nestjs_common from '@nestjs/common';
-import { Z as ZodNestRegistry } from './registry-C9xStKa6.js';
 import { z } from 'zod';
+import { Z as ZodNestRegistry } from './registry-C9xStKa6.js';
+import * as _nestjs_common from '@nestjs/common';
+
+/**
+ * Where the multipart parser puts uploaded files. Multer leaves them on the
+ * request (`req.file` / `req.files`) with only text fields in `req.body`;
+ * `@fastify/multipart` with `attachFieldsToBody: true` puts everything in
+ * `req.body`.
+ */
+declare const MultipartFilesIn: {
+    readonly Request: "request";
+    readonly Body: "body";
+};
+type MultipartFilesIn = (typeof MultipartFilesIn)[keyof typeof MultipartFilesIn];
+/** Shape accepted by `@ZodMultipart` — one Zod schema per form field. */
+type MultipartShape = Readonly<Record<string, z.ZodType>>;
+
+declare const MULTIPART_CONTENT_TYPE = "multipart/form-data";
+/**
+ * Body declaration accepted by `@ZodMultipart`: a flat shape record, or any
+ * Zod schema. A record is the common case; a schema covers named bodies
+ * (`.meta({ id })` → `$ref`) and composites an object literal can't express.
+ */
+type MultipartBody = MultipartShape | z.ZodType;
+interface ZodMultipartOptions {
+    /**
+     * Where the parser puts uploaded files. Defaults to the platform entry
+     * point's convention — `'request'` from `zod-nest/express`, `'body'` from
+     * `zod-nest/fastify`.
+     */
+    readonly filesIn?: MultipartFilesIn;
+    /**
+     * Forces this id, overriding any `.meta({ id })` on the schema. A named body
+     * is emitted as a `$ref` to `components.schemas`, which keeps a stable name
+     * for client generators — at the cost of Swagger UI's `try-it-out` form,
+     * which doesn't follow `$ref` for `multipart/form-data`.
+     */
+    readonly id?: string;
+    /**
+     * Merge an intersection / union of `z.object` arms into one flat inline
+     * object. Needed for composite bodies whose `try-it-out` form must render.
+     * All merged properties become optional. See `@ZodBody`'s `flatten`.
+     */
+    readonly flatten?: boolean;
+    /** Registry to register named descendants into. Defaults to `defaultRegistry`. */
+    readonly registry?: ZodNestRegistry;
+    /** OpenAPI `description` for the request body. */
+    readonly description?: string;
+    /** Whether the body is required. Defaults to `true`. */
+    readonly required?: boolean;
+}
 
 interface BaseFileOptions {
     /**
@@ -40,34 +89,4 @@ declare const ZodUploadedFiles: (...dataOrPipes: (string | _nestjs_common.PipeTr
  */
 declare const ZodMultipartBody: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
-/**
- * Where the multipart parser puts uploaded files. Multer leaves them on the
- * request (`req.file` / `req.files`) with only text fields in `req.body`;
- * `@fastify/multipart` with `attachFieldsToBody: true` puts everything in
- * `req.body`.
- */
-declare const MultipartFilesIn: {
-    readonly Request: "request";
-    readonly Body: "body";
-};
-type MultipartFilesIn = (typeof MultipartFilesIn)[keyof typeof MultipartFilesIn];
-/** Shape accepted by `@ZodMultipart` — one Zod schema per form field. */
-type MultipartShape = Readonly<Record<string, z.ZodType>>;
-
-declare const MULTIPART_CONTENT_TYPE = "multipart/form-data";
-interface ZodMultipartOptions {
-    /**
-     * Where the parser puts uploaded files. Defaults to the platform entry
-     * point's convention — `'request'` from `zod-nest/express`, `'body'` from
-     * `zod-nest/fastify`.
-     */
-    readonly filesIn?: MultipartFilesIn;
-    /** Registry to register named descendants into. Defaults to `defaultRegistry`. */
-    readonly registry?: ZodNestRegistry;
-    /** OpenAPI `description` for the request body. */
-    readonly description?: string;
-    /** Whether the body is required. Defaults to `true`. */
-    readonly required?: boolean;
-}
-
-export { type BaseFileOptions as B, MULTIPART_CONTENT_TYPE as M, ZodMultipartBody as Z, type MultipartShape as a, type ZodMultipartOptions as b, ZodUploadedFile as c, ZodUploadedFiles as d };
+export { type BaseFileOptions as B, MULTIPART_CONTENT_TYPE as M, ZodMultipartBody as Z, type MultipartBody as a, type MultipartShape as b, type ZodMultipartOptions as c, ZodUploadedFile as d, ZodUploadedFiles as e };

package/dist/{zod-multipart.decorator-CxS2KuSv.d.mts → param-decorators-DbgygRVn.d.mts}

@@ -1,6 +1,55 @@
-import * as _nestjs_common from '@nestjs/common';
-import { Z as ZodNestRegistry } from './registry-C9xStKa6.mjs';
 import { z } from 'zod';
+import { Z as ZodNestRegistry } from './registry-C9xStKa6.mjs';
+import * as _nestjs_common from '@nestjs/common';
+
+/**
+ * Where the multipart parser puts uploaded files. Multer leaves them on the
+ * request (`req.file` / `req.files`) with only text fields in `req.body`;
+ * `@fastify/multipart` with `attachFieldsToBody: true` puts everything in
+ * `req.body`.
+ */
+declare const MultipartFilesIn: {
+    readonly Request: "request";
+    readonly Body: "body";
+};
+type MultipartFilesIn = (typeof MultipartFilesIn)[keyof typeof MultipartFilesIn];
+/** Shape accepted by `@ZodMultipart` — one Zod schema per form field. */
+type MultipartShape = Readonly<Record<string, z.ZodType>>;
+
+declare const MULTIPART_CONTENT_TYPE = "multipart/form-data";
+/**
+ * Body declaration accepted by `@ZodMultipart`: a flat shape record, or any
+ * Zod schema. A record is the common case; a schema covers named bodies
+ * (`.meta({ id })` → `$ref`) and composites an object literal can't express.
+ */
+type MultipartBody = MultipartShape | z.ZodType;
+interface ZodMultipartOptions {
+    /**
+     * Where the parser puts uploaded files. Defaults to the platform entry
+     * point's convention — `'request'` from `zod-nest/express`, `'body'` from
+     * `zod-nest/fastify`.
+     */
+    readonly filesIn?: MultipartFilesIn;
+    /**
+     * Forces this id, overriding any `.meta({ id })` on the schema. A named body
+     * is emitted as a `$ref` to `components.schemas`, which keeps a stable name
+     * for client generators — at the cost of Swagger UI's `try-it-out` form,
+     * which doesn't follow `$ref` for `multipart/form-data`.
+     */
+    readonly id?: string;
+    /**
+     * Merge an intersection / union of `z.object` arms into one flat inline
+     * object. Needed for composite bodies whose `try-it-out` form must render.
+     * All merged properties become optional. See `@ZodBody`'s `flatten`.
+     */
+    readonly flatten?: boolean;
+    /** Registry to register named descendants into. Defaults to `defaultRegistry`. */
+    readonly registry?: ZodNestRegistry;
+    /** OpenAPI `description` for the request body. */
+    readonly description?: string;
+    /** Whether the body is required. Defaults to `true`. */
+    readonly required?: boolean;
+}
 
 interface BaseFileOptions {
     /**
@@ -40,34 +89,4 @@ declare const ZodUploadedFiles: (...dataOrPipes: (string | _nestjs_common.PipeTr
  */
 declare const ZodMultipartBody: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
-/**
- * Where the multipart parser puts uploaded files. Multer leaves them on the
- * request (`req.file` / `req.files`) with only text fields in `req.body`;
- * `@fastify/multipart` with `attachFieldsToBody: true` puts everything in
- * `req.body`.
- */
-declare const MultipartFilesIn: {
-    readonly Request: "request";
-    readonly Body: "body";
-};
-type MultipartFilesIn = (typeof MultipartFilesIn)[keyof typeof MultipartFilesIn];
-/** Shape accepted by `@ZodMultipart` — one Zod schema per form field. */
-type MultipartShape = Readonly<Record<string, z.ZodType>>;
-
-declare const MULTIPART_CONTENT_TYPE = "multipart/form-data";
-interface ZodMultipartOptions {
-    /**
-     * Where the parser puts uploaded files. Defaults to the platform entry
-     * point's convention — `'request'` from `zod-nest/express`, `'body'` from
-     * `zod-nest/fastify`.
-     */
-    readonly filesIn?: MultipartFilesIn;
-    /** Registry to register named descendants into. Defaults to `defaultRegistry`. */
-    readonly registry?: ZodNestRegistry;
-    /** OpenAPI `description` for the request body. */
-    readonly description?: string;
-    /** Whether the body is required. Defaults to `true`. */
-    readonly required?: boolean;
-}
-
-export { type BaseFileOptions as B, MULTIPART_CONTENT_TYPE as M, ZodMultipartBody as Z, type MultipartShape as a, type ZodMultipartOptions as b, ZodUploadedFile as c, ZodUploadedFiles as d };
+export { type BaseFileOptions as B, MULTIPART_CONTENT_TYPE as M, ZodMultipartBody as Z, type MultipartBody as a, type MultipartShape as b, type ZodMultipartOptions as c, ZodUploadedFile as d, ZodUploadedFiles as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod-nest",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Modern Zod v4-only NestJS + OpenAPI 3.1 integration. Successor to nestjs-zod.",
   "license": "MIT",
   "author": "Rodrigo Azevedo",