@dudousxd/nestjs-codegen 0.6.1 → 0.7.1

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.1";
+declare const VERSION = "0.7.1";
 
 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.1";
+declare const VERSION = "0.7.1";
 
 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

@@ -46,18 +46,23 @@ async function fileExists(filePath) {
   }
 }
 async function importTs(filePath) {
-  let tsImport;
+  const fileUrl = 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 = pathToFileURL(`${filePath}__parent__`).href;
+    return tsImport(fileUrl, { parentURL });
   }
-  const parentURL = pathToFileURL(`${filePath}__parent__`).href;
-  const fileUrl = pathToFileURL(filePath).href;
-  return tsImport(fileUrl, { parentURL });
 }
 function resolveAbsolute(cwd, p) {
   if (isAbsolute(p)) return p;
@@ -127,6 +132,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 +716,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 +743,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 +756,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 +768,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 +973,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 +1030,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 +1092,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 +2113,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
     });
@@ -4538,7 +4553,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.6.1";
+var VERSION = "0.7.1";
 export {
   CodegenError,
   ConfigError,