@dudousxd/nestjs-codegen 0.6.1 → 0.7.1

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

@@ -106,18 +106,23 @@ async function fileExists(filePath) {
   }
 }
 async function importTs(filePath) {
-  let tsImport;
+  const fileUrl = (0, import_node_url.pathToFileURL)(filePath).href;
   try {
-    const tsxEsm = await import("tsx/esm/api");
-    tsImport = tsxEsm.tsImport;
-  } catch {
-    throw new ConfigError(
-      "Failed to load config: `tsx` is required for loading TypeScript config files. Install it as a dev dependency: pnpm add -D tsx"
-    );
+    return await import(fileUrl);
+  } catch (nativeError) {
+    let tsImport;
+    try {
+      const tsxEsm = await import("tsx/esm/api");
+      tsImport = tsxEsm.tsImport;
+    } catch {
+      throw new ConfigError(
+        "Failed to load config: `tsx` is required for loading TypeScript config files. Install it as a dev dependency: pnpm add -D tsx",
+        { cause: nativeError }
+      );
+    }
+    const parentURL = (0, import_node_url.pathToFileURL)(`${filePath}__parent__`).href;
+    return tsImport(fileUrl, { parentURL });
   }
-  const parentURL = (0, import_node_url.pathToFileURL)(`${filePath}__parent__`).href;
-  const fileUrl = (0, import_node_url.pathToFileURL)(filePath).href;
-  return tsImport(fileUrl, { parentURL });
 }
 function resolveAbsolute(cwd, p) {
   if ((0, import_node_path.isAbsolute)(p)) return p;
@@ -187,6 +192,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 +776,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 +803,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 +816,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 +828,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 +1033,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 +1090,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 +1152,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 +2173,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
     });
@@ -4583,7 +4598,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.6.1";
+var VERSION = "0.7.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,