@dudousxd/nestjs-codegen 0.7.1 → 0.9.0

package/dist/extension/index.d.cts

@@ -1,2 +1,2 @@
-export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-DgIAN5k5.cjs';
+export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-SJc0gya_.cjs';
 import 'ts-morph';

package/dist/extension/index.d.ts

@@ -1,2 +1,2 @@
-export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-DgIAN5k5.js';
+export { m as ApiClientLayer, n as ApiHeaderContribution, o as ApiModuleDeps, C as CodegenExtension, p as EmittedFile, E as ExtensionContext, L as LeafModel, q as RequestModel, s as RequestShape, t as defineExtension, u as requestShape } from '../index-SJc0gya_.js';
 import 'ts-morph';

package/dist/{index-DgIAN5k5.d.cts → index-SJc0gya_.d.cts}

@@ -204,6 +204,15 @@ type ValidationOption = 'zod' | 'valibot' | 'arktype' | ValidationAdapter;
 declare function resolveAdapter(option: ValidationOption): ValidationAdapter;
 
 interface UserConfig {
+    /**
+     * Print schema-translation advisories to the terminal (e.g. "@X is not
+     * translatable to a client validation schema", "T is a recursive type"). These
+     * are always preserved in generated output as `// warning:` comments regardless;
+     * this only controls the duplicate terminal chatter, which is off by default.
+     *
+     * @default false
+     */
+    debug?: boolean;
     /**
      * Codegen extensions, applied in order. Each may augment the route IR
      * (`transformRoutes`), contribute extra output files (`emitFiles`), and — once a
@@ -356,6 +365,7 @@ interface ResolvedMocksConfig {
     baseUrl: string;
 }
 interface ResolvedConfig {
+    debug: boolean;
     extensions: CodegenExtension[];
     validation: ValidationAdapter;
     pages: ResolvedPagesConfig | null;

package/dist/{index-DgIAN5k5.d.ts → index-SJc0gya_.d.ts}

@@ -204,6 +204,15 @@ type ValidationOption = 'zod' | 'valibot' | 'arktype' | ValidationAdapter;
 declare function resolveAdapter(option: ValidationOption): ValidationAdapter;
 
 interface UserConfig {
+    /**
+     * Print schema-translation advisories to the terminal (e.g. "@X is not
+     * translatable to a client validation schema", "T is a recursive type"). These
+     * are always preserved in generated output as `// warning:` comments regardless;
+     * this only controls the duplicate terminal chatter, which is off by default.
+     *
+     * @default false
+     */
+    debug?: boolean;
     /**
      * Codegen extensions, applied in order. Each may augment the route IR
      * (`transformRoutes`), contribute extra output files (`emitFiles`), and — once a
@@ -356,6 +365,7 @@ interface ResolvedMocksConfig {
     baseUrl: string;
 }
 interface ResolvedConfig {
+    debug: boolean;
     extensions: CodegenExtension[];
     validation: ValidationAdapter;
     pages: ResolvedPagesConfig | null;

package/dist/index.cjs

@@ -173,6 +173,7 @@ function applyDefaults(userConfig, cwd) {
     };
   }
   return {
+    debug: userConfig.debug ?? false,
     extensions: userConfig.extensions ?? [],
     // Non-null: validateUserConfig() above throws when `validation` is absent.
     validation: resolveAdapter(userConfig.validation),
@@ -2142,8 +2143,18 @@ function buildEmpty() {
   ].join("\n");
 }
 
+// src/util/debug-log.ts
+var debugEnabled = false;
+function setCodegenDebug(enabled) {
+  debugEnabled = enabled;
+}
+function debugWarn(message) {
+  if (debugEnabled) console.warn(`[nestjs-codegen] ${message}`);
+}
+
 // src/generate.ts
 async function generate(config, inputRoutes = []) {
+  setCodegenDebug(config.debug);
   const extensions = config.extensions ?? [];
   let routes = inputRoutes;
   const ctx = createExtensionContext(config, () => routes);
@@ -2739,7 +2750,7 @@ function buildProperty(prop, classFile, ctx) {
         ctx.warnedDecorators.add(name);
         const msg = `@${name} is not translatable to a client validation schema and was skipped (server-only validation).`;
         ctx.warnings.push(msg);
-        console.warn(`[nestjs-codegen] ${msg}`);
+        debugWarn(msg);
       }
     }
   }
@@ -2790,7 +2801,7 @@ function buildNestedReference(className, fromFile, ctx, typeArgs = []) {
       ctx.warnedDecorators.add(`recursive:${reserved}`);
       const msg = `${className} is a recursive type; the generated schema validates it via a lazy self-reference.`;
       ctx.warnings.push(msg);
-      console.warn(`[nestjs-codegen] ${msg}`);
+      debugWarn(msg);
     }
     return { kind: "lazyRef", name: reserved };
   }
@@ -2799,7 +2810,7 @@ function buildNestedReference(className, fromFile, ctx, typeArgs = []) {
       ctx.warnedDecorators.add(`deep:${className}`);
       const msg = `${className} nesting is too deep to expand; the generated schema uses unknown for it.`;
       ctx.warnings.push(msg);
-      console.warn(`[nestjs-codegen] ${msg}`);
+      debugWarn(msg);
     }
     return { kind: "unknown", note: "nesting too deep \u2014 not expanded" };
   }
@@ -2940,7 +2951,7 @@ function enumSchemaFromDecorator(decorator, classFile, ctx) {
     if (!ctx.warnedDecorators.has(`IsEnum:${name}`)) {
       ctx.warnedDecorators.add(`IsEnum:${name}`);
       ctx.warnings.push(msg);
-      console.warn(`[nestjs-codegen] ${msg}`);
+      debugWarn(msg);
     }
     return { kind: "unknown", note: `@IsEnum(${name}): enum not resolvable to literals` };
   }
@@ -3570,14 +3581,33 @@ function extractQueryType(method, sourceFile, project) {
   for (const param of method.getParameters()) {
     const queryDecorator = param.getDecorators().find((d) => d.getName() === "Query");
     if (!queryDecorator) continue;
-    const queryArgs = queryDecorator.getArguments();
-    if (queryArgs.length > 0) continue;
+    if (queryDecorator.getArguments().length > 0) continue;
     const typeNode = param.getTypeNode();
     if (typeNode) {
       return resolveTypeNodeToString(typeNode, sourceFile, project, 3);
     }
   }
-  return null;
+  const entries = [];
+  for (const param of method.getParameters()) {
+    const queryDecorator = param.getDecorators().find((d) => d.getName() === "Query");
+    if (!queryDecorator) continue;
+    const queryArgs = queryDecorator.getArguments();
+    const nameArg = queryArgs[0];
+    if (!nameArg || !import_ts_morph7.Node.isStringLiteral(nameArg)) continue;
+    const queryName = nameArg.getLiteralValue();
+    const typeNode = param.getTypeNode();
+    const queryType = typeNode ? resolveTypeNodeToString(typeNode, sourceFile, project, 3) : "string";
+    entries.push(`${queryName}${isParamOptional(param) ? "?" : ""}: ${queryType}`);
+  }
+  return entries.length > 0 ? `{ ${entries.join("; ")} }` : null;
+}
+function isParamOptional(param) {
+  if (param.hasQuestionToken() || param.hasInitializer()) return true;
+  const typeNode = param.getTypeNode();
+  if (typeNode && import_ts_morph7.Node.isUnionTypeNode(typeNode)) {
+    return typeNode.getTypeNodes().some((t) => t.getKind() === import_ts_morph7.SyntaxKind.UndefinedKeyword);
+  }
+  return false;
 }
 function extractParamsType(method, sourceFile, project) {
   const entries = [];
@@ -4598,7 +4628,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.7.1";
+var VERSION = "0.9.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,