@dudousxd/nestjs-codegen 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @dudousxd/nestjs-codegen
 
+## 0.10.0
+
+### Minor Changes
+
+- 152a2ab: Narrow the public `ValidationOption` type to `ValidationAdapter` only. The string
+  shortcuts (`'zod'` / `'valibot'` / `'arktype'`) were advertised by the type but
+  `resolveAdapter` always threw a `ConfigError` for any string, so they never worked
+  at runtime. The type now guides TypeScript users to import and pass an adapter
+  instance (e.g. `zodAdapter` from `@dudousxd/nestjs-codegen-zod`).
+
+  The runtime guard is retained: `resolveAdapter` still accepts a `string` and throws
+  the helpful "install + import the adapter package" error, so JS callers and untyped
+  configs that pass a removed string shortcut get the same actionable message.
+
+  This is a compile-time-only breaking change for anyone still typing `validation:
+'zod'` — it never produced working output at runtime, so the bump is minor.
+
+### Patch Changes
+
+- 81ba774: Ship TanStack Intent agent skills (SKILL.md) inside the package.
+
+## 0.9.0
+
+### Minor Changes
+
+- ff9e27b: feat(core): gate schema-translation advisories behind a new `debug` config flag (default off).
+
+  On every codegen pass the discovery layer logged a `[nestjs-codegen]` line to the
+  terminal for each schema-translation advisory — `@X is not translatable to a client
+validation schema and was skipped`, `T is a recursive type; ... lazy self-reference`,
+  over-deep nesting, and unresolvable `@IsEnum`. On a real project these fire dozens of
+  times per run and are pure noise.
+
+  These advisories are already preserved where they matter: in the returned
+  `SchemaModule.warnings` array and as `// warning:` comments in the generated output.
+  The terminal copy is now opt-in: add `debug: true` to `nestjs-codegen.config.ts`
+  (or `NestjsCodegenModule.forRoot({ debug: true })`) to print them again. Default is
+  `false`, so a normal run is quiet. No effect on generated artifacts.
+
 ## 0.8.0
 
 ### Minor Changes

package/README.md

@@ -15,6 +15,8 @@ layer.
 
 ```bash
 pnpm add -D @dudousxd/nestjs-codegen
+# a validation adapter (no adapter is bundled in core) — zod shown; or -valibot / -arktype:
+pnpm add -D @dudousxd/nestjs-codegen-zod
 # the runtime the generated client imports its Fetcher type from:
 pnpm add @dudousxd/nestjs-client
 ```
@@ -33,6 +35,7 @@ The watcher is a dev/CI concern, so the module skips itself automatically when
 ```ts title="src/app.module.ts"
 import { Module } from '@nestjs/common';
 import { NestjsCodegenModule } from '@dudousxd/nestjs-codegen/nest';
+import { zodAdapter } from '@dudousxd/nestjs-codegen-zod';
 
 @Module({
   imports: [
@@ -42,7 +45,7 @@ import { NestjsCodegenModule } from '@dudousxd/nestjs-codegen/nest';
       // output directory for the generated files
       codegen: { outDir: 'src/generated' },
 
-      validation: 'zod', // 'zod' (bundled) | valibotAdapter | arktypeAdapter
+      validation: zodAdapter, // zodAdapter | valibotAdapter | arktypeAdapter
     }),
   ],
 })
@@ -87,7 +90,7 @@ import { arktypeAdapter } from '@dudousxd/nestjs-codegen-arktype';
 NestjsCodegenModule.forRoot({
   contracts: { glob: 'src/**/*.controller.ts' },
   codegen: { outDir: 'src/generated' },
-  validation: arktypeAdapter, // render the IR as arktype instead of the bundled zod
+  validation: arktypeAdapter, // render the IR as arktype instead of zod
   extensions: [tanstackQuery(), nestjsFilterCodegen(), nestjsInertiaCodegen()],
 });
 ```
@@ -136,11 +139,12 @@ with `defineConfig` and importing them into `forRoot()`:
 
 ```ts title="nestjs-codegen.config.ts"
 import { defineConfig } from '@dudousxd/nestjs-codegen';
+import { zodAdapter } from '@dudousxd/nestjs-codegen-zod';
 
 export default defineConfig({
   contracts: { glob: 'src/**/*.controller.ts' },
   codegen: { outDir: 'src/generated' },
-  validation: 'zod',
+  validation: zodAdapter,
 });
 ```
 

package/dist/cli/main.cjs

@@ -142,6 +142,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),
@@ -2108,8 +2109,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);
@@ -2705,7 +2716,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);
       }
     }
   }
@@ -2756,7 +2767,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 };
   }
@@ -2765,7 +2776,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" };
   }
@@ -2906,7 +2917,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` };
   }
@@ -4500,7 +4511,7 @@ async function watch(config, onChange) {
 }
 
 // src/index.ts
-var VERSION = "0.8.0";
+var VERSION = "0.10.0";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {