@dudousxd/nestjs-codegen 0.6.0 → 0.7.0

package/dist/extension/index.d.cts

@@ -1,2 +1,2 @@
-export { l as ApiClientLayer, m as ApiHeaderContribution, n as ApiModuleDeps, C as CodegenExtension, o as EmittedFile, E as ExtensionContext, L as LeafModel, p as RequestModel, q as RequestShape, s as defineExtension, t as requestShape } from '../index-_qRai4M3.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-DgIAN5k5.cjs';
 import 'ts-morph';

package/dist/extension/index.d.ts

@@ -1,2 +1,2 @@
-export { l as ApiClientLayer, m as ApiHeaderContribution, n as ApiModuleDeps, C as CodegenExtension, o as EmittedFile, E as ExtensionContext, L as LeafModel, p as RequestModel, q as RequestShape, s as defineExtension, t as requestShape } from '../index-_qRai4M3.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-DgIAN5k5.js';
 import 'ts-morph';

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

@@ -254,6 +254,18 @@ interface UserConfig {
     fetcher?: {
         importPath: string;
     };
+    /**
+     * How response payloads are deserialized on the client, which determines the
+     * generated `response` type shape.
+     *
+     * - `'json'` (default): responses cross the wire as plain JSON, so the
+     *   generated type is wrapped in `Jsonify<...>` (e.g. `Date` → `string`).
+     * - `'superjson'`: responses are revived (Dates/Maps/Sets restored), so the
+     *   raw controller return type is emitted unchanged.
+     *
+     * @default 'json'
+     */
+    serialization?: 'json' | 'superjson';
     /**
      * Typed-form schema emit (`forms.ts`). Re-exports / translates contract and
      * class-validator-decorated DTO schemas into zod schemas for client-side
@@ -319,6 +331,8 @@ interface ResolvedCodegenConfig {
     outDir: string;
     cwd: string;
 }
+/** How response payloads are deserialized on the client. */
+type SerializationMode = 'json' | 'superjson';
 interface ResolvedAppConfig {
     moduleEntry: string;
     tsconfig: string | null;
@@ -352,6 +366,7 @@ interface ResolvedConfig {
     fetcher: {
         importPath: string;
     } | null;
+    serialization: SerializationMode;
     forms: ResolvedFormsConfig;
     openapi: ResolvedOpenApiConfig;
     mocks: ResolvedMocksConfig;
@@ -631,4 +646,4 @@ declare function requestShape(route: RouteDescriptor): RequestShape;
 /** Identity helper for authoring extensions with full type inference. */
 declare function defineExtension(ext: CodegenExtension): CodegenExtension;
 
-export { type AdapterUsage as A, type CodegenExtension as C, type ExtensionContext as E, type LeafModel as L, type NumberCheck as N, type ResolvedConfig as R, type SchemaNode as S, type TypeRef as T, type UserConfig as U, type ValidationAdapter as V, type RouteDescriptor as a, type RenderContext as b, type SchemaModule as c, type RenderedModule as d, type ResolvedFormsConfig as e, type ContractDescriptor as f, type ContractSource as g, type ControllerRef as h, type ScopeConfig as i, type StringCheck as j, type ValidationOption as k, type ApiClientLayer as l, type ApiHeaderContribution as m, type ApiModuleDeps as n, type EmittedFile as o, type RequestModel as p, type RequestShape as q, resolveAdapter as r, defineExtension as s, requestShape as t };
+export { type AdapterUsage as A, type CodegenExtension as C, type ExtensionContext as E, type LeafModel as L, type NumberCheck as N, type ResolvedConfig as R, type SchemaNode as S, type TypeRef as T, type UserConfig as U, type ValidationAdapter as V, type RouteDescriptor as a, type RenderContext as b, type SchemaModule as c, type RenderedModule as d, type ResolvedFormsConfig as e, type SerializationMode as f, type ContractDescriptor as g, type ContractSource as h, type ControllerRef as i, type ScopeConfig as j, type StringCheck as k, type ValidationOption as l, type ApiClientLayer as m, type ApiHeaderContribution as n, type ApiModuleDeps as o, type EmittedFile as p, type RequestModel as q, resolveAdapter as r, type RequestShape as s, defineExtension as t, requestShape as u };

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

@@ -254,6 +254,18 @@ interface UserConfig {
     fetcher?: {
         importPath: string;
     };
+    /**
+     * How response payloads are deserialized on the client, which determines the
+     * generated `response` type shape.
+     *
+     * - `'json'` (default): responses cross the wire as plain JSON, so the
+     *   generated type is wrapped in `Jsonify<...>` (e.g. `Date` → `string`).
+     * - `'superjson'`: responses are revived (Dates/Maps/Sets restored), so the
+     *   raw controller return type is emitted unchanged.
+     *
+     * @default 'json'
+     */
+    serialization?: 'json' | 'superjson';
     /**
      * Typed-form schema emit (`forms.ts`). Re-exports / translates contract and
      * class-validator-decorated DTO schemas into zod schemas for client-side
@@ -319,6 +331,8 @@ interface ResolvedCodegenConfig {
     outDir: string;
     cwd: string;
 }
+/** How response payloads are deserialized on the client. */
+type SerializationMode = 'json' | 'superjson';
 interface ResolvedAppConfig {
     moduleEntry: string;
     tsconfig: string | null;
@@ -352,6 +366,7 @@ interface ResolvedConfig {
     fetcher: {
         importPath: string;
     } | null;
+    serialization: SerializationMode;
     forms: ResolvedFormsConfig;
     openapi: ResolvedOpenApiConfig;
     mocks: ResolvedMocksConfig;
@@ -631,4 +646,4 @@ declare function requestShape(route: RouteDescriptor): RequestShape;
 /** Identity helper for authoring extensions with full type inference. */
 declare function defineExtension(ext: CodegenExtension): CodegenExtension;
 
-export { type AdapterUsage as A, type CodegenExtension as C, type ExtensionContext as E, type LeafModel as L, type NumberCheck as N, type ResolvedConfig as R, type SchemaNode as S, type TypeRef as T, type UserConfig as U, type ValidationAdapter as V, type RouteDescriptor as a, type RenderContext as b, type SchemaModule as c, type RenderedModule as d, type ResolvedFormsConfig as e, type ContractDescriptor as f, type ContractSource as g, type ControllerRef as h, type ScopeConfig as i, type StringCheck as j, type ValidationOption as k, type ApiClientLayer as l, type ApiHeaderContribution as m, type ApiModuleDeps as n, type EmittedFile as o, type RequestModel as p, type RequestShape as q, resolveAdapter as r, defineExtension as s, requestShape as t };
+export { type AdapterUsage as A, type CodegenExtension as C, type ExtensionContext as E, type LeafModel as L, type NumberCheck as N, type ResolvedConfig as R, type SchemaNode as S, type TypeRef as T, type UserConfig as U, type ValidationAdapter as V, type RouteDescriptor as a, type RenderContext as b, type SchemaModule as c, type RenderedModule as d, type ResolvedFormsConfig as e, type SerializationMode as f, type ContractDescriptor as g, type ContractSource as h, type ControllerRef as i, type ScopeConfig as j, type StringCheck as k, type ValidationOption as l, type ApiClientLayer as m, type ApiHeaderContribution as n, type ApiModuleDeps as o, type EmittedFile as p, type RequestModel as q, resolveAdapter as r, type RequestShape as s, defineExtension as t, requestShape as u };

package/dist/index.cjs

@@ -187,6 +187,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",
@@ -770,7 +771,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;
@@ -793,7 +798,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) {
@@ -806,7 +811,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);
@@ -818,7 +823,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}};`);
     }
   }
@@ -1023,6 +1028,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);
@@ -1079,6 +1085,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();
@@ -1138,7 +1147,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());
@@ -2159,6 +2168,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
     });
@@ -4389,6 +4399,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({
@@ -4402,13 +4413,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 {
     }
   }
@@ -4426,7 +4438,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:",
@@ -4457,6 +4469,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(
@@ -4580,7 +4593,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.6.0";
+var VERSION = "0.7.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,