@dudousxd/nestjs-codegen 0.8.0 → 0.10.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-CxkGbILp.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-CxkGbILp.js';
 import 'ts-morph';

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

@@ -189,21 +189,40 @@ interface ValidationAdapter {
     inferType(schemaConst: string): string;
 }
 
-/** A built-in adapter name or a custom adapter instance. */
-type ValidationOption = 'zod' | 'valibot' | 'arktype' | ValidationAdapter;
+/**
+ * A validation adapter instance. No adapter is bundled in core — import one from
+ * its own package (`zodAdapter`/`valibotAdapter`/`arktypeAdapter`) or pass a custom
+ * object. String shortcuts (`'zod'` etc.) are intentionally not part of this type:
+ * they always threw at runtime, so the type guides you to an imported instance.
+ */
+type ValidationOption = ValidationAdapter;
 /**
  * Resolve a `validation` config value to a {@link ValidationAdapter}. No adapter is
  * bundled in core — the zod/valibot/arktype adapters ship as their own packages.
  * Import the adapter instance and pass it directly (it passes through here). A
  * custom adapter object also passes through.
  *
+ * The parameter also accepts a `string` so the runtime guard still fires for JS
+ * callers / untyped configs that pass a removed string shortcut (e.g. `'zod'`):
+ * those throw a helpful error pointing at the adapter package. TypeScript users
+ * are steered away from strings by the narrowed {@link ValidationOption} type.
+ *
  * @example
  * import { zodAdapter } from '@dudousxd/nestjs-codegen-zod';
  * defineConfig({ validation: zodAdapter });
  */
-declare function resolveAdapter(option: ValidationOption): ValidationAdapter;
+declare function resolveAdapter(option: ValidationOption | string): 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 +375,7 @@ interface ResolvedMocksConfig {
     baseUrl: string;
 }
 interface ResolvedConfig {
+    debug: boolean;
     extensions: CodegenExtension[];
     validation: ValidationAdapter;
     pages: ResolvedPagesConfig | null;

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

@@ -189,21 +189,40 @@ interface ValidationAdapter {
     inferType(schemaConst: string): string;
 }
 
-/** A built-in adapter name or a custom adapter instance. */
-type ValidationOption = 'zod' | 'valibot' | 'arktype' | ValidationAdapter;
+/**
+ * A validation adapter instance. No adapter is bundled in core — import one from
+ * its own package (`zodAdapter`/`valibotAdapter`/`arktypeAdapter`) or pass a custom
+ * object. String shortcuts (`'zod'` etc.) are intentionally not part of this type:
+ * they always threw at runtime, so the type guides you to an imported instance.
+ */
+type ValidationOption = ValidationAdapter;
 /**
  * Resolve a `validation` config value to a {@link ValidationAdapter}. No adapter is
  * bundled in core — the zod/valibot/arktype adapters ship as their own packages.
  * Import the adapter instance and pass it directly (it passes through here). A
  * custom adapter object also passes through.
  *
+ * The parameter also accepts a `string` so the runtime guard still fires for JS
+ * callers / untyped configs that pass a removed string shortcut (e.g. `'zod'`):
+ * those throw a helpful error pointing at the adapter package. TypeScript users
+ * are steered away from strings by the narrowed {@link ValidationOption} type.
+ *
  * @example
  * import { zodAdapter } from '@dudousxd/nestjs-codegen-zod';
  * defineConfig({ validation: zodAdapter });
  */
-declare function resolveAdapter(option: ValidationOption): ValidationAdapter;
+declare function resolveAdapter(option: ValidationOption | string): 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 +375,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` };
   }
@@ -4617,7 +4628,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.8.0";
+var VERSION = "0.10.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,