@dudousxd/nestjs-codegen 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @dudousxd/nestjs-codegen
 
+## 0.7.0
+
+### Minor Changes
+
+- ff8ad8b: Jsonify-by-default serialized response types, with an opt-out `serialization` config option.
+
+  The generated `api.ts` now reflects the **JSON wire shape** of each route's response rather than the in-process server return type. A controller returning `{ createdAt: Date }` now generates `response: Jsonify<{ createdAt: string }>` — because `Date.prototype.toJSON()` emits an ISO string. `Jsonify<T>` recurses arrays/objects, follows any `toJSON()` holder to its returned shape, drops non-serializable properties (functions/symbols), keeps optional properties optional, and passes `any`/`unknown` through untouched. It is a hand-rolled, type-only utility with no runtime footprint.
+
+  - **`@dudousxd/nestjs-client`** exports the new `Jsonify<T>` type.
+  - **`@dudousxd/nestjs-codegen`** wraps each route `response` field in `Jsonify<...>` by default and emits `import type { Jsonify } from '<runtime>'` (tracking `fetcher.importPath`) when at least one route is wrapped. Only the `response` field is wrapped — never `error`, `body`, or `query`.
+  - New config option `serialization?: 'json' | 'superjson'` (default `'json'`). In `'superjson'` mode the raw controller return type is emitted unchanged (Dates/Maps/Sets are revived on the client), and no `Jsonify` import is emitted.
+
 ## 0.6.1
 
 ### Patch Changes

package/dist/cli/main.cjs

@@ -156,6 +156,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",
@@ -739,7 +740,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;
@@ -762,7 +767,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) {
@@ -775,7 +780,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);
@@ -787,7 +792,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}};`);
     }
   }
@@ -992,6 +997,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);
@@ -1048,6 +1054,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();
@@ -1107,7 +1116,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());
@@ -2125,6 +2134,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
     });
@@ -4466,7 +4476,7 @@ async function watch(config, onChange) {
 }
 
 // src/index.ts
-var VERSION = "0.6.1";
+var VERSION = "0.7.0";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {