@dudousxd/nestjs-codegen 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @dudousxd/nestjs-codegen
 
+## 0.13.0
+
+### Minor Changes
+
+- a044e73: feat: typed `multipart/form-data` upload routes (`@UploadedFile()` / Multer interceptors).
+
+  The codegen now understands handlers that accept uploaded files, so multipart uploads
+  become first-class typed routes (`api.X({ body: { ...fields, file } })`) instead of
+  needing the `fetchRaw` escape hatch.
+
+  **core (`@dudousxd/nestjs-codegen`):**
+
+  - Discovery detects `@UploadedFile()` / `@UploadedFiles()` handlers and reads the HTTP
+    field name(s) + arity from the Multer interceptor in `@UseInterceptors(...)`:
+    - `FileInterceptor('file')` → `file: File | Blob`
+    - `FilesInterceptor('files')` → `files: Array<File | Blob>`
+    - `FileFieldsInterceptor([{ name: 'a' }, { name: 'b' }])` → `a: Array<File | Blob>; b: Array<File | Blob>`
+    - `AnyFilesInterceptor()` → flagged multipart (no statically known field names)
+  - The uploaded-file field(s) are merged into the route `body` as an intersection with the
+    `@Body` DTO (`SomeDto & { file: File | Blob }`), typed for the browser as `File | Blob`
+    (never the server-side `Express.Multer.File`).
+  - The route carries a new `multipart` flag, emitted into the generated client so the call
+    passes `multipart: true` to the fetcher.
+
+  **client (`@dudousxd/nestjs-client`):**
+
+  - `RequestOpts` gains `multipart?: boolean`. When set, the fetcher serializes the body
+    object to a `FormData` (scalars as strings, `Date` as ISO, `File`/`Blob` as file parts,
+    arrays as repeated parts) instead of JSON, letting the runtime set the multipart
+    boundary. `onUploadProgress` already rides the same path.
+
 ## 0.12.0
 
 ### Minor Changes

package/dist/cli/main.cjs

@@ -820,6 +820,7 @@ function buildRequestModel(c) {
   const optsParts = [];
   if (hasQuery) optsParts.push("query: input?.query as Record<string, unknown> | undefined");
   if (hasBody) optsParts.push("body: input?.body");
+  if (hasBody && c.contractSource.multipart) optsParts.push("multipart: true");
   const optsExpr = optsParts.length ? `{ ${optsParts.join(", ")} }` : "{}";
   return {
     routeName: c.name,
@@ -3700,6 +3701,55 @@ function extractParamsType(method, sourceFile, project) {
   }
   return entries.length > 0 ? `{ ${entries.join("; ")} }` : null;
 }
+function extractUploadedFiles(method) {
+  const FILE = "File | Blob";
+  const entries = [];
+  let multipart = false;
+  const hasUploadedFileParam = method.getParameters().some(
+    (p) => p.getDecorators().some((d) => {
+      const name = d.getName();
+      return name === "UploadedFile" || name === "UploadedFiles";
+    })
+  );
+  for (const decorator of method.getDecorators()) {
+    if (decorator.getName() !== "UseInterceptors") continue;
+    for (const arg of decorator.getArguments()) {
+      if (!import_ts_morph7.Node.isCallExpression(arg)) continue;
+      const interceptor = arg.getExpression().getText();
+      const callArgs = arg.getArguments();
+      const firstArg2 = callArgs[0];
+      if (interceptor === "FileInterceptor") {
+        if (firstArg2 && import_ts_morph7.Node.isStringLiteral(firstArg2)) {
+          entries.push(`${firstArg2.getLiteralValue()}: ${FILE}`);
+          multipart = true;
+        }
+      } else if (interceptor === "FilesInterceptor") {
+        if (firstArg2 && import_ts_morph7.Node.isStringLiteral(firstArg2)) {
+          entries.push(`${firstArg2.getLiteralValue()}: Array<${FILE}>`);
+          multipart = true;
+        }
+      } else if (interceptor === "FileFieldsInterceptor") {
+        if (firstArg2 && import_ts_morph7.Node.isArrayLiteralExpression(firstArg2)) {
+          for (const el of firstArg2.getElements()) {
+            if (!import_ts_morph7.Node.isObjectLiteralExpression(el)) continue;
+            const nameProp = el.getProperty("name");
+            if (nameProp && import_ts_morph7.Node.isPropertyAssignment(nameProp)) {
+              const init = nameProp.getInitializer();
+              if (init && import_ts_morph7.Node.isStringLiteral(init)) {
+                entries.push(`${init.getLiteralValue()}: Array<${FILE}>`);
+              }
+            }
+          }
+          multipart = true;
+        }
+      } else if (interceptor === "AnyFilesInterceptor") {
+        multipart = true;
+      }
+    }
+  }
+  if (hasUploadedFileParam) multipart = true;
+  return { fields: entries.length > 0 ? entries.join("; ") : null, multipart };
+}
 function extractResponseType(method, sourceFile, project) {
   const apiResponseDecorator = method.getDecorators().find((d) => d.getName() === "ApiResponse" && (apiResponseStatus(d) ?? 0) < 400);
   if (apiResponseDecorator) {
@@ -3834,6 +3884,11 @@ function extractDtoContract(method, sourceFile, project) {
   let body = extractBodyType(method, sourceFile, project);
   const filterInfo = extractApplyFilterInfo(method, sourceFile, project);
   const query = extractQueryType(method, sourceFile, project);
+  const uploads = extractUploadedFiles(method);
+  if (uploads.fields) {
+    const fileObject = `{ ${uploads.fields} }`;
+    body = body ? `(${body}) & ${fileObject}` : fileObject;
+  }
   const streamElement = detectStreamElement(method);
   const isStream = streamElement !== null;
   if (filterInfo && filterInfo.source === "body") {
@@ -3843,7 +3898,7 @@ function extractDtoContract(method, sourceFile, project) {
   const paramsType = extractParamsType(method, sourceFile, project);
   const response = isStream ? resolveTypeNodeToString(streamElement, sourceFile, project, 3) : extractResponseType(method, sourceFile, project);
   const errorInfo = extractErrorType(method, sourceFile, project);
-  if (body === null && query === null && paramsType === null && response === "unknown" && errorInfo === null && filterInfo === null && !isStream) {
+  if (body === null && query === null && paramsType === null && response === "unknown" && errorInfo === null && filterInfo === null && !isStream && !uploads.multipart) {
     return null;
   }
   let bodyRef = null;
@@ -3916,7 +3971,8 @@ function extractDtoContract(method, sourceFile, project) {
     formWarnings,
     bodySchema,
     querySchema,
-    stream: isStream
+    stream: isStream,
+    multipart: uploads.multipart
   };
 }
 function resolveParamClass(method, decoratorName, sourceFile, project) {
@@ -4401,7 +4457,8 @@ function extractDtoRoute(args) {
       formWarnings: dtoContract?.formWarnings ?? [],
       bodySchema: dtoContract?.bodySchema ?? null,
       querySchema: dtoContract?.querySchema ?? null,
-      stream: dtoContract?.stream ?? false
+      stream: dtoContract?.stream ?? false,
+      multipart: dtoContract?.multipart ?? false
     }
   });
 }
@@ -4631,7 +4688,7 @@ async function watch(config, onChange, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.12.0";
+var VERSION = "0.13.0";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {