@dudousxd/nestjs-codegen 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-_qRai4M3.cjs';
-export { A as AdapterUsage, f as ContractDescriptor, g as ContractSource, h as ControllerRef, N as NumberCheck, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-_qRai4M3.cjs';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-DgIAN5k5.cjs';
+export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-DgIAN5k5.cjs';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -160,13 +160,20 @@ declare function emitForms(routes: RouteDescriptor[], outDir: string, config: Re
  * output: an `apiClientLayer` (e.g. `@dudousxd/nestjs-codegen-tanstack`) turns leaves into
  * handles wrapping the neutral fetcher request; `apiMembers` add handle members; `apiHeader`
  * contributes top-level imports/statements.
+ *
+ * `serialization` controls how response types are emitted (default `'json'`):
+ * in `'json'` mode each `response` type is wrapped in `Jsonify<...>` (so the
+ * generated type reflects the JSON wire shape, e.g. `Date` → `string`); in
+ * `'superjson'` mode the raw controller return type is emitted unchanged.
  */
 interface ApiEmitOptions {
-    fetcherImportPath?: string;
+    fetcherImportPath?: string | undefined;
     /** Registered extensions. Their api.ts hooks (transport/layer/members/header) are applied. */
-    extensions?: CodegenExtension[];
+    extensions?: CodegenExtension[] | undefined;
     /** Shared extension context (from `generate()`). When omitted, a minimal one is built from routes. */
-    ctx?: ExtensionContext;
+    ctx?: ExtensionContext | undefined;
+    /** How response payloads deserialize on the client. Default `'json'`. */
+    serialization?: SerializationMode | undefined;
 }
 declare function emitApi(routes: RouteDescriptor[], outDir: string, opts?: ApiEmitOptions): Promise<void>;
 
@@ -289,6 +296,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.6.0";
+declare const VERSION = "0.7.0";
 
 export { type ChainModuleRendererOptions, CodegenError, ConfigError, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext } from './index-_qRai4M3.js';
-export { A as AdapterUsage, f as ContractDescriptor, g as ContractSource, h as ControllerRef, N as NumberCheck, i as ScopeConfig, j as StringCheck, T as TypeRef, k as ValidationOption, r as resolveAdapter } from './index-_qRai4M3.js';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-DgIAN5k5.js';
+export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-DgIAN5k5.js';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -160,13 +160,20 @@ declare function emitForms(routes: RouteDescriptor[], outDir: string, config: Re
  * output: an `apiClientLayer` (e.g. `@dudousxd/nestjs-codegen-tanstack`) turns leaves into
  * handles wrapping the neutral fetcher request; `apiMembers` add handle members; `apiHeader`
  * contributes top-level imports/statements.
+ *
+ * `serialization` controls how response types are emitted (default `'json'`):
+ * in `'json'` mode each `response` type is wrapped in `Jsonify<...>` (so the
+ * generated type reflects the JSON wire shape, e.g. `Date` → `string`); in
+ * `'superjson'` mode the raw controller return type is emitted unchanged.
  */
 interface ApiEmitOptions {
-    fetcherImportPath?: string;
+    fetcherImportPath?: string | undefined;
     /** Registered extensions. Their api.ts hooks (transport/layer/members/header) are applied. */
-    extensions?: CodegenExtension[];
+    extensions?: CodegenExtension[] | undefined;
     /** Shared extension context (from `generate()`). When omitted, a minimal one is built from routes. */
-    ctx?: ExtensionContext;
+    ctx?: ExtensionContext | undefined;
+    /** How response payloads deserialize on the client. Default `'json'`. */
+    serialization?: SerializationMode | undefined;
 }
 declare function emitApi(routes: RouteDescriptor[], outDir: string, opts?: ApiEmitOptions): Promise<void>;
 
@@ -289,6 +296,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.6.0";
+declare const VERSION = "0.7.0";
 
 export { type ChainModuleRendererOptions, CodegenError, ConfigError, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };

package/dist/index.js

@@ -127,6 +127,7 @@ function applyDefaults(userConfig, cwd) {
     },
     app,
     fetcher: userConfig.fetcher ?? null,
+    serialization: userConfig.serialization ?? "json",
     forms: {
       enabled: userConfig.forms?.enabled ?? true,
       watch: userConfig.forms?.watch ?? "src/**/*.dto.ts",
@@ -710,7 +711,11 @@ function emitFilterQueryTypeArgs(c) {
 function emitFilterQueryType(c) {
   return `import('@dudousxd/nestjs-filter-client').TypedFilterQuery<${emitFilterQueryTypeArgs(c)}>`;
 }
-function buildResponseType(c, outDir) {
+function buildResponseType(c, outDir, serialization) {
+  const raw = rawResponseType(c, outDir);
+  return serialization === "json" ? `Jsonify<${raw}>` : raw;
+}
+function rawResponseType(c, outDir) {
   const respRef = c.contractSource.responseRef;
   if (c.contractSource.stream) {
     if (respRef) return respRef.isArray ? `Array<${respRef.name}>` : respRef.name;
@@ -733,7 +738,7 @@ function buildErrorType(c) {
   }
   return c.contractSource.error ?? "unknown";
 }
-function emitRouterTypeBlock(tree, indent, outDir) {
+function emitRouterTypeBlock(tree, indent, outDir, serialization) {
   const pad = " ".repeat(indent);
   const lines = [];
   for (const [key, node] of tree) {
@@ -746,7 +751,7 @@ function emitRouterTypeBlock(tree, indent, outDir) {
       const query = queryRef ? queryRef.isArray ? `Array<${queryRef.name}>` : queryRef.name : isFilterQuery ? emitFilterQueryType(c) : c.contractSource.query ?? "never";
       const bodyRef = c.contractSource.bodyRef;
       const body = method === "GET" ? "never" : bodyRef ? bodyRef.isArray ? `Array<${bodyRef.name}>` : bodyRef.name : c.contractSource.body ?? "never";
-      const response = buildResponseType(c, outDir);
+      const response = buildResponseType(c, outDir, serialization);
       const error = buildErrorType(c);
       const params = buildParamsType(c.params);
       const safeMethod = JSON.stringify(method);
@@ -758,7 +763,7 @@ function emitRouterTypeBlock(tree, indent, outDir) {
       );
     } else {
       lines.push(`${pad}${objKey}: {`);
-      lines.push(...emitRouterTypeBlock(node.children, indent + 2, outDir));
+      lines.push(...emitRouterTypeBlock(node.children, indent + 2, outDir, serialization));
       lines.push(`${pad}};`);
     }
   }
@@ -963,6 +968,7 @@ var EMPTY_PATH_NAMESPACE = [
 ];
 function buildApiFile(routes, outDir, opts = {}) {
   const fetcherImportPath = opts.fetcherImportPath;
+  const serialization = opts.serialization ?? "json";
   const extensions = opts.extensions ?? [];
   const { layer } = resolveApiSlots(extensions);
   const memberExts = extensions.filter((e) => e.apiMembers);
@@ -1019,6 +1025,9 @@ function buildApiFile(routes, outDir, opts = {}) {
   );
   const runtimeImport = fetcherImportPath ?? "@dudousxd/nestjs-client";
   lines.push(`import type { Fetcher } from '${runtimeImport}';`);
+  if (serialization === "json" && contracted.length > 0) {
+    lines.push(`import type { Jsonify } from '${runtimeImport}';`);
+  }
   if (importsByFile.size > 0 && outDir) {
     lines.push("");
     const emittedNames = /* @__PURE__ */ new Set();
@@ -1078,7 +1087,7 @@ function buildApiFile(routes, outDir, opts = {}) {
     insertIntoTree(tree, segments, leaf, name);
   }
   lines.push("export type ApiRouter = {");
-  lines.push(...emitRouterTypeBlock(tree, 2, outDir ?? ""));
+  lines.push(...emitRouterTypeBlock(tree, 2, outDir ?? "", serialization));
   lines.push("};");
   lines.push("");
   lines.push(...emitReqHelper());
@@ -2099,6 +2108,7 @@ async function generate(config, inputRoutes = []) {
   if (hasContracts) {
     await emitApi(routes, config.codegen.outDir, {
       ...config.fetcher?.importPath ? { fetcherImportPath: config.fetcher.importPath } : {},
+      serialization: config.serialization,
       extensions,
       ctx
     });
@@ -4344,6 +4354,7 @@ async function watch(config, onChange) {
     return NO_OP_WATCHER;
   }
   let discovery = null;
+  let lastRoutes = [];
   async function getDiscovery() {
     if (discovery === null) {
       discovery = await PersistentDiscovery.create({
@@ -4357,13 +4368,14 @@ async function watch(config, onChange) {
   }
   try {
     const initialRoutes = (await getDiscovery()).discover();
+    lastRoutes = initialRoutes;
     await generate(config, initialRoutes);
   } catch (err) {
     console.warn(
       `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
     );
     try {
-      await generate(config);
+      await generate(config, lastRoutes);
     } catch {
     }
   }
@@ -4381,7 +4393,7 @@ async function watch(config, onChange) {
     pagesDebounceTimer = setTimeout(async () => {
       pagesDebounceTimer = void 0;
       try {
-        await generate(config);
+        await generate(config, lastRoutes);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Pages generation failed:",
@@ -4412,6 +4424,7 @@ async function watch(config, onChange) {
       pendingChangedPaths.clear();
       try {
         const routes = await (await getDiscovery()).rediscover(changed);
+        lastRoutes = routes;
         await generate(config, routes);
       } catch (err) {
         console.error(
@@ -4535,7 +4548,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.6.0";
+var VERSION = "0.7.0";
 export {
   CodegenError,
   ConfigError,