@dudousxd/nestjs-codegen 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, V as ValidationAdapter, S as SchemaModule, b as ResolvedFormsConfig, C as CodegenExtension, E as ExtensionContext } from './index-BwIRjOQA.cjs';
-export { A as AdapterUsage, c as ContractDescriptor, d as ContractSource, e as ControllerRef, N as NumberCheck, f as RenderContext, g as RenderedModule, h as SchemaNode, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-BwIRjOQA.cjs';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaModule, b as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-oH5t7x4G.cjs';
+export { A as AdapterUsage, c as ContractDescriptor, d as ContractSource, e as ControllerRef, N as NumberCheck, f as RenderContext, g as RenderedModule, h as SchemaNode, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-oH5t7x4G.cjs';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -12,7 +12,16 @@ declare function defineConfig(c: UserConfig): UserConfig;
  * @param userConfig the raw user config (forRoot options minus module-only fields)
  * @param cwd project root used to resolve globs / outDir. Defaults to `process.cwd()`.
  */
-declare function resolveConfig(userConfig: UserConfig, cwd?: string): ResolvedConfig;
+declare function resolveConfig(userConfig: UserConfigInput, cwd?: string): ResolvedConfig;
+/**
+ * Loosened {@link UserConfig} where `validation` may be absent. Both config entry
+ * points accept this shape and enforce `validation` at runtime (it throws a clear
+ * {@link ConfigError} when missing) — letting callers like the Nest module pass
+ * partial options without a compile-time `validation` requirement.
+ */
+type UserConfigInput = Omit<UserConfig, 'validation'> & {
+    validation?: UserConfig['validation'];
+};
 declare function loadConfig(cwd?: string): Promise<ResolvedConfig>;
 
 declare class ConfigError extends Error {
@@ -64,36 +73,43 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-declare const zodAdapter: ValidationAdapter;
-
 /**
  * Pure-AST translation of class-validator-decorated DTO classes into the neutral
  * {@link SchemaModule} IR. Reads decorator names + literal args via ts-morph — it
  * never imports class-validator at runtime. A `ValidationAdapter` renders the IR.
  *
- * This is the structural successor of `dto-to-zod.ts`: same control flow,
- * recursion guard, and warnings, but it emits `SchemaNode` values instead of zod
- * text. The zod adapter reproduces the previous output byte-for-byte.
+ * This is the sole DTO translator: it emits neutral `SchemaNode` IR (replacing
+ * the former `dto-to-zod.ts` text path). A `ValidationAdapter` renders the IR;
+ * the bundled zod adapter reproduces the original zod-text output byte-for-byte.
  */
 
 declare function extractSchemaFromDto(classDecl: ClassDeclaration, sourceFile: SourceFile, project: Project): SchemaModule;
 
 /**
- * Emits `forms.ts` into `outDir` — re-exported (Path A) or inlined/synthesized
- * (Path A inline / Path B) zod schemas per validatable route, plus a
- * `formSchemas` name→schema map.
+ * Emits `forms.ts` into `outDir`. Every validatable route is rendered through a
+ * single {@link ValidationAdapter} path (IR → `adapter.renderModule`). The adapter
+ * is required — `validation` is a mandatory config field.
+ *
+ * Two schema sources exist per route:
+ *  - Neutral IR (`bodySchema`/`querySchema`) synthesized from class-validator
+ *    DTOs — renderable through ANY adapter.
+ *  - Hand-written zod from `defineContract` (`bodyZodText`/`queryZodText` raw
+ *    source, or `bodyZodRef`/`queryZodRef` re-exports). This is genuine zod
+ *    source with no IR; it passes through verbatim only when the adapter sets
+ *    `acceptsRawZodSource` (the zod adapter), and is skipped with a warning
+ *    under any other adapter.
  *
  * Returns `true` when a `forms.ts` was written (drives the index export).
  */
-declare function emitForms(routes: RouteDescriptor[], outDir: string, config?: ResolvedFormsConfig, adapter?: ValidationAdapter): Promise<boolean>;
+declare function emitForms(routes: RouteDescriptor[], outDir: string, config: ResolvedFormsConfig | undefined, adapter: ValidationAdapter): Promise<boolean>;
 
 /**
  * Emits `api.ts` into `outDir` for all routes that carry a `.contract`.
  *
  * By default each leaf is a bare typed-fetch callable. Registered extensions shape the
  * output: an `apiClientLayer` (e.g. `@dudousxd/nestjs-codegen-tanstack`) turns leaves into
- * handles; an `apiTransport` changes how requests are issued; `apiMembers` add handle
- * members; `apiHeader` contributes top-level imports/statements.
+ * handles wrapping the neutral fetcher request; `apiMembers` add handle members; `apiHeader`
+ * contributes top-level imports/statements.
  */
 interface ApiEmitOptions {
     fetcherImportPath?: string;
@@ -123,6 +139,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
 
-export { CodegenError, ConfigError, type FastDiscoveryOptions, ResolvedConfig, RouteDescriptor, SchemaModule, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, resolveConfig, watch, zodAdapter };
+export { CodegenError, ConfigError, type FastDiscoveryOptions, ResolvedConfig, RouteDescriptor, SchemaModule, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, resolveConfig, watch };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, V as ValidationAdapter, S as SchemaModule, b as ResolvedFormsConfig, C as CodegenExtension, E as ExtensionContext } from './index-BwIRjOQA.js';
-export { A as AdapterUsage, c as ContractDescriptor, d as ContractSource, e as ControllerRef, N as NumberCheck, f as RenderContext, g as RenderedModule, h as SchemaNode, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-BwIRjOQA.js';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaModule, b as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-oH5t7x4G.js';
+export { A as AdapterUsage, c as ContractDescriptor, d as ContractSource, e as ControllerRef, N as NumberCheck, f as RenderContext, g as RenderedModule, h as SchemaNode, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-oH5t7x4G.js';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -12,7 +12,16 @@ declare function defineConfig(c: UserConfig): UserConfig;
  * @param userConfig the raw user config (forRoot options minus module-only fields)
  * @param cwd project root used to resolve globs / outDir. Defaults to `process.cwd()`.
  */
-declare function resolveConfig(userConfig: UserConfig, cwd?: string): ResolvedConfig;
+declare function resolveConfig(userConfig: UserConfigInput, cwd?: string): ResolvedConfig;
+/**
+ * Loosened {@link UserConfig} where `validation` may be absent. Both config entry
+ * points accept this shape and enforce `validation` at runtime (it throws a clear
+ * {@link ConfigError} when missing) — letting callers like the Nest module pass
+ * partial options without a compile-time `validation` requirement.
+ */
+type UserConfigInput = Omit<UserConfig, 'validation'> & {
+    validation?: UserConfig['validation'];
+};
 declare function loadConfig(cwd?: string): Promise<ResolvedConfig>;
 
 declare class ConfigError extends Error {
@@ -64,36 +73,43 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-declare const zodAdapter: ValidationAdapter;
-
 /**
  * Pure-AST translation of class-validator-decorated DTO classes into the neutral
  * {@link SchemaModule} IR. Reads decorator names + literal args via ts-morph — it
  * never imports class-validator at runtime. A `ValidationAdapter` renders the IR.
  *
- * This is the structural successor of `dto-to-zod.ts`: same control flow,
- * recursion guard, and warnings, but it emits `SchemaNode` values instead of zod
- * text. The zod adapter reproduces the previous output byte-for-byte.
+ * This is the sole DTO translator: it emits neutral `SchemaNode` IR (replacing
+ * the former `dto-to-zod.ts` text path). A `ValidationAdapter` renders the IR;
+ * the bundled zod adapter reproduces the original zod-text output byte-for-byte.
  */
 
 declare function extractSchemaFromDto(classDecl: ClassDeclaration, sourceFile: SourceFile, project: Project): SchemaModule;
 
 /**
- * Emits `forms.ts` into `outDir` — re-exported (Path A) or inlined/synthesized
- * (Path A inline / Path B) zod schemas per validatable route, plus a
- * `formSchemas` name→schema map.
+ * Emits `forms.ts` into `outDir`. Every validatable route is rendered through a
+ * single {@link ValidationAdapter} path (IR → `adapter.renderModule`). The adapter
+ * is required — `validation` is a mandatory config field.
+ *
+ * Two schema sources exist per route:
+ *  - Neutral IR (`bodySchema`/`querySchema`) synthesized from class-validator
+ *    DTOs — renderable through ANY adapter.
+ *  - Hand-written zod from `defineContract` (`bodyZodText`/`queryZodText` raw
+ *    source, or `bodyZodRef`/`queryZodRef` re-exports). This is genuine zod
+ *    source with no IR; it passes through verbatim only when the adapter sets
+ *    `acceptsRawZodSource` (the zod adapter), and is skipped with a warning
+ *    under any other adapter.
  *
  * Returns `true` when a `forms.ts` was written (drives the index export).
  */
-declare function emitForms(routes: RouteDescriptor[], outDir: string, config?: ResolvedFormsConfig, adapter?: ValidationAdapter): Promise<boolean>;
+declare function emitForms(routes: RouteDescriptor[], outDir: string, config: ResolvedFormsConfig | undefined, adapter: ValidationAdapter): Promise<boolean>;
 
 /**
  * Emits `api.ts` into `outDir` for all routes that carry a `.contract`.
  *
  * By default each leaf is a bare typed-fetch callable. Registered extensions shape the
  * output: an `apiClientLayer` (e.g. `@dudousxd/nestjs-codegen-tanstack`) turns leaves into
- * handles; an `apiTransport` changes how requests are issued; `apiMembers` add handle
- * members; `apiHeader` contributes top-level imports/statements.
+ * handles wrapping the neutral fetcher request; `apiMembers` add handle members; `apiHeader`
+ * contributes top-level imports/statements.
  */
 interface ApiEmitOptions {
     fetcherImportPath?: string;
@@ -123,6 +139,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
 
-export { CodegenError, ConfigError, type FastDiscoveryOptions, ResolvedConfig, RouteDescriptor, SchemaModule, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, resolveConfig, watch, zodAdapter };
+export { CodegenError, ConfigError, type FastDiscoveryOptions, ResolvedConfig, RouteDescriptor, SchemaModule, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, resolveConfig, watch };