@dudousxd/nestjs-codegen 0.2.1 → 0.4.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 SchemaNode, b as SchemaModule, c as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-DA4uySjo.cjs';
+export { A as AdapterUsage, d as ContractDescriptor, e as ContractSource, f as ControllerRef, N as NumberCheck, g as RenderContext, h as RenderedModule, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-DA4uySjo.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,68 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-declare const zodAdapter: ValidationAdapter;
+/**
+ * Renders the neutral {@link SchemaNode} IR to a TypeScript *type* expression
+ * (not a validation-lib schema). Used to synthesize the hoisted structural type
+ * that annotates a recursive zod/valibot const, breaking the implicit-any
+ * inference cycle (`type X = {...}` + `const XSchema: z.ZodType<X> = ...`).
+ *
+ * References to other named schemas resolve two ways:
+ *   - a `ref`/`lazyRef` to a *recursive* schema → its type-alias name (so the
+ *     emitted `type` aliases reference each other, terminating the recursion);
+ *   - a `ref` to a *non-recursive* schema → inlined structurally (keeps the set
+ *     of emitted `type` aliases limited to exactly the recursive cluster).
+ * Inlining always terminates: every reference cycle passes through a recursive
+ * name, which is rendered by alias rather than expanded.
+ */
+
+interface TsTypeContext {
+    /** All hoisted named schemas (for inlining non-recursive refs). */
+    named: Map<string, SchemaNode>;
+    /** Names that are genuinely recursive (rendered by alias, never inlined). */
+    recursive: Set<string>;
+    /** schema const name (e.g. `ColumnFilterSchema`) → TS type-alias name. */
+    typeNameFor: (schemaName: string) => string;
+}
+declare function renderTsType(node: SchemaNode, ctx: TsTypeContext): string;
 
 /**
  * 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 +164,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.4.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, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, 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 SchemaNode, b as SchemaModule, c as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-DA4uySjo.js';
+export { A as AdapterUsage, d as ContractDescriptor, e as ContractSource, f as ControllerRef, N as NumberCheck, g as RenderContext, h as RenderedModule, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-DA4uySjo.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,68 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-declare const zodAdapter: ValidationAdapter;
+/**
+ * Renders the neutral {@link SchemaNode} IR to a TypeScript *type* expression
+ * (not a validation-lib schema). Used to synthesize the hoisted structural type
+ * that annotates a recursive zod/valibot const, breaking the implicit-any
+ * inference cycle (`type X = {...}` + `const XSchema: z.ZodType<X> = ...`).
+ *
+ * References to other named schemas resolve two ways:
+ *   - a `ref`/`lazyRef` to a *recursive* schema → its type-alias name (so the
+ *     emitted `type` aliases reference each other, terminating the recursion);
+ *   - a `ref` to a *non-recursive* schema → inlined structurally (keeps the set
+ *     of emitted `type` aliases limited to exactly the recursive cluster).
+ * Inlining always terminates: every reference cycle passes through a recursive
+ * name, which is rendered by alias rather than expanded.
+ */
+
+interface TsTypeContext {
+    /** All hoisted named schemas (for inlining non-recursive refs). */
+    named: Map<string, SchemaNode>;
+    /** Names that are genuinely recursive (rendered by alias, never inlined). */
+    recursive: Set<string>;
+    /** schema const name (e.g. `ColumnFilterSchema`) → TS type-alias name. */
+    typeNameFor: (schemaName: string) => string;
+}
+declare function renderTsType(node: SchemaNode, ctx: TsTypeContext): string;
 
 /**
  * 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 +164,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.4.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, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, defineConfig, discoverContractsFast, emitApi, emitForms, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, watch };