@dudousxd/nestjs-codegen 0.13.2 → 0.14.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, f as SerializationMode } from './index-D8RIMVpU.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-D8RIMVpU.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-DT8SgPxp.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-DT8SgPxp.cjs';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -31,6 +31,52 @@ declare class CodegenError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
 
+/**
+ * Which entry point produced a generate pass: the one-shot/`--watch` CLI
+ * (reads `nestjs-codegen.config.ts` from disk), or the Nest module
+ * (`NestjsCodegenModule.forRoot()`, options passed in-process). Recorded in
+ * the manifest so {@link CodegenManifest.configHash} drift between the two can
+ * be detected — see {@link DriftGuardError}.
+ */
+type EntryPoint = 'cli' | 'module';
+/**
+ * Thrown by `generate()` when the drift guard (see `driftGuard` in
+ * {@link import('./config/types.js').UserConfig}) detects that the CLI and the
+ * Nest module are writing the same `outDir` from two different resolved
+ * configs. Distinguished from a generic `Error` so callers (the watcher's
+ * initial-pass fallback) can single it out instead of treating it as a
+ * transient discovery failure to retry.
+ */
+declare class DriftGuardError extends Error {
+    constructor(message: string);
+}
+/**
+ * Persisted record of the last successful generate, written to
+ * `<outDir>/.codegen-manifest.json`. Used to skip regeneration when nothing
+ * relevant changed (see {@link isManifestFresh}), and to detect CLI↔module
+ * config drift (see {@link DriftGuardError}).
+ */
+interface CodegenManifest {
+    /** Lib version that produced the output. A lib upgrade invalidates the manifest. */
+    version: string;
+    /** Content hash over all generate inputs (source files + resolved config + version). */
+    hash: string;
+    /**
+     * Which entry point produced this manifest. Absent on manifests written before
+     * this field existed — treated as "unknown", which never trips the drift guard.
+     */
+    entryPoint?: EntryPoint;
+    /**
+     * Hash of ONLY the serialized resolved config (not source files / version) —
+     * a narrower signal than {@link hash}, used to tell "same config, different
+     * entry point" (fine) apart from "different config" (drift) regardless of
+     * unrelated source-file changes. Absent on pre-drift-guard manifests.
+     */
+    configHash?: string;
+    /** Generated output files, relative to `outDir`, recorded after the last run. */
+    files: string[];
+}
+
 /**
  * Run one full codegen pass: discover pages, emit pages.d.ts, components.json, index.d.ts.
  * Route discovery is deliberately skipped — it requires spawning a Nest app and is
@@ -39,8 +85,11 @@ declare class CodegenError extends Error {
  * Optionally accepts pre-discovered routes (e.g. from a full generate + route-discovery pass).
  * When routes are present, emits routes.ts.
  * When routes with contracts are present, also emits api.ts.
+ *
+ * `entryPoint` identifies which caller is running — the CLI or the Nest module — and is
+ * recorded in the manifest for the {@link DriftGuardError} check below.
  */
-declare function generate(config: ResolvedConfig, inputRoutes?: RouteDescriptor[]): Promise<void>;
+declare function generate(config: ResolvedConfig, inputRoutes?: RouteDescriptor[], entryPoint?: EntryPoint): Promise<void>;
 
 interface Watcher {
     close(): Promise<void>;
@@ -56,6 +105,16 @@ interface WatchOptions {
      * @default false
      */
     deferInitialGenerate?: boolean;
+    /**
+     * Which entry point is running the watcher — threaded through to every
+     * `generate()` call so the drift guard (see `driftGuard` in
+     * {@link import('../config/types.js').UserConfig}) can tell the CLI and the
+     * Nest module apart. The one-shot/`--watch` CLI passes `'cli'` (the
+     * default); `NestjsCodegenModule` passes `'module'`.
+     *
+     * @default 'cli'
+     */
+    entryPoint?: EntryPoint;
 }
 /**
  * Start two chokidar watchers:
@@ -85,20 +144,6 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-/**
- * Persisted record of the last successful generate, written to
- * `<outDir>/.codegen-manifest.json`. Used to skip regeneration when nothing
- * relevant changed (see {@link isManifestFresh}).
- */
-interface CodegenManifest {
-    /** Lib version that produced the output. A lib upgrade invalidates the manifest. */
-    version: string;
-    /** Content hash over all generate inputs (source files + resolved config + version). */
-    hash: string;
-    /** Generated output files, relative to `outDir`, recorded after the last run. */
-    files: string[];
-}
-
 /**
  * Renders the neutral {@link SchemaNode} IR to a TypeScript *type* expression
  * (not a validation-lib schema). Used to synthesize the hoisted structural type
@@ -322,6 +367,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.13.2";
+declare const VERSION = "0.14.0";
 
-export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, 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 WatchOptions, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };
+export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, ConfigError, DriftGuardError, type EntryPoint, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type WatchOptions, 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, f as SerializationMode } from './index-D8RIMVpU.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-D8RIMVpU.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-DT8SgPxp.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-DT8SgPxp.js';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -31,6 +31,52 @@ declare class CodegenError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
 
+/**
+ * Which entry point produced a generate pass: the one-shot/`--watch` CLI
+ * (reads `nestjs-codegen.config.ts` from disk), or the Nest module
+ * (`NestjsCodegenModule.forRoot()`, options passed in-process). Recorded in
+ * the manifest so {@link CodegenManifest.configHash} drift between the two can
+ * be detected — see {@link DriftGuardError}.
+ */
+type EntryPoint = 'cli' | 'module';
+/**
+ * Thrown by `generate()` when the drift guard (see `driftGuard` in
+ * {@link import('./config/types.js').UserConfig}) detects that the CLI and the
+ * Nest module are writing the same `outDir` from two different resolved
+ * configs. Distinguished from a generic `Error` so callers (the watcher's
+ * initial-pass fallback) can single it out instead of treating it as a
+ * transient discovery failure to retry.
+ */
+declare class DriftGuardError extends Error {
+    constructor(message: string);
+}
+/**
+ * Persisted record of the last successful generate, written to
+ * `<outDir>/.codegen-manifest.json`. Used to skip regeneration when nothing
+ * relevant changed (see {@link isManifestFresh}), and to detect CLI↔module
+ * config drift (see {@link DriftGuardError}).
+ */
+interface CodegenManifest {
+    /** Lib version that produced the output. A lib upgrade invalidates the manifest. */
+    version: string;
+    /** Content hash over all generate inputs (source files + resolved config + version). */
+    hash: string;
+    /**
+     * Which entry point produced this manifest. Absent on manifests written before
+     * this field existed — treated as "unknown", which never trips the drift guard.
+     */
+    entryPoint?: EntryPoint;
+    /**
+     * Hash of ONLY the serialized resolved config (not source files / version) —
+     * a narrower signal than {@link hash}, used to tell "same config, different
+     * entry point" (fine) apart from "different config" (drift) regardless of
+     * unrelated source-file changes. Absent on pre-drift-guard manifests.
+     */
+    configHash?: string;
+    /** Generated output files, relative to `outDir`, recorded after the last run. */
+    files: string[];
+}
+
 /**
  * Run one full codegen pass: discover pages, emit pages.d.ts, components.json, index.d.ts.
  * Route discovery is deliberately skipped — it requires spawning a Nest app and is
@@ -39,8 +85,11 @@ declare class CodegenError extends Error {
  * Optionally accepts pre-discovered routes (e.g. from a full generate + route-discovery pass).
  * When routes are present, emits routes.ts.
  * When routes with contracts are present, also emits api.ts.
+ *
+ * `entryPoint` identifies which caller is running — the CLI or the Nest module — and is
+ * recorded in the manifest for the {@link DriftGuardError} check below.
  */
-declare function generate(config: ResolvedConfig, inputRoutes?: RouteDescriptor[]): Promise<void>;
+declare function generate(config: ResolvedConfig, inputRoutes?: RouteDescriptor[], entryPoint?: EntryPoint): Promise<void>;
 
 interface Watcher {
     close(): Promise<void>;
@@ -56,6 +105,16 @@ interface WatchOptions {
      * @default false
      */
     deferInitialGenerate?: boolean;
+    /**
+     * Which entry point is running the watcher — threaded through to every
+     * `generate()` call so the drift guard (see `driftGuard` in
+     * {@link import('../config/types.js').UserConfig}) can tell the CLI and the
+     * Nest module apart. The one-shot/`--watch` CLI passes `'cli'` (the
+     * default); `NestjsCodegenModule` passes `'module'`.
+     *
+     * @default 'cli'
+     */
+    entryPoint?: EntryPoint;
 }
 /**
  * Start two chokidar watchers:
@@ -85,20 +144,6 @@ declare function acquireLock(outDir: string): Promise<{
     release: () => Promise<void>;
 } | null>;
 
-/**
- * Persisted record of the last successful generate, written to
- * `<outDir>/.codegen-manifest.json`. Used to skip regeneration when nothing
- * relevant changed (see {@link isManifestFresh}).
- */
-interface CodegenManifest {
-    /** Lib version that produced the output. A lib upgrade invalidates the manifest. */
-    version: string;
-    /** Content hash over all generate inputs (source files + resolved config + version). */
-    hash: string;
-    /** Generated output files, relative to `outDir`, recorded after the last run. */
-    files: string[];
-}
-
 /**
  * Renders the neutral {@link SchemaNode} IR to a TypeScript *type* expression
  * (not a validation-lib schema). Used to synthesize the hoisted structural type
@@ -322,6 +367,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.13.2";
+declare const VERSION = "0.14.0";
 
-export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, 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 WatchOptions, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };
+export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, ConfigError, DriftGuardError, type EntryPoint, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type WatchOptions, 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

@@ -151,7 +151,8 @@ function applyDefaults(userConfig, cwd) {
       fileName: userConfig.mocks?.fileName ?? "mocks.ts",
       seed: userConfig.mocks?.seed ?? 1,
       baseUrl: userConfig.mocks?.baseUrl ?? ""
-    }
+    },
+    driftGuard: userConfig.driftGuard ?? true
   };
 }
 async function loadConfig(cwd) {
@@ -611,7 +612,7 @@ async function collectEmittedFiles(extensions, ctx) {
 function requestShape(route) {
   const cs = route.contract?.contractSource;
   const isGet = route.method.toUpperCase() === "GET";
-  const isQuery = isGet || !!cs?.filterFields?.length;
+  const isQuery = isGet || !!cs?.filterFields?.length || !!cs?.asQuery;
   const hasBody = !!cs?.bodyRef || cs?.body != null && cs.body !== "never";
   const hasQuery = isGet || !!cs?.queryRef || cs?.query != null && cs.query !== "never";
   return { isGet, isQuery, hasBody, hasQuery };
@@ -718,6 +719,7 @@ function emitFilterQueryType(c) {
   return `import('@dudousxd/nestjs-filter-client').TypedFilterQuery<${emitFilterQueryTypeArgs(c)}>`;
 }
 function buildResponseType(c, outDir, serialization) {
+  if (c.contractSource.binaryResponse) return "RawResponse<Blob>";
   const raw = rawResponseType(c, outDir);
   return serialization === "json" ? `Jsonify<${raw}>` : raw;
 }
@@ -772,8 +774,9 @@ function emitRouterTypeBlock(tree, indent, outDir, serialization) {
       const safeUrl = JSON.stringify(c.path);
       const filterFields = c.contractSource.filterFields?.length ? c.contractSource.filterFields.map((f) => JSON.stringify(f)).join(" | ") : "never";
       const stream = c.contractSource.stream ? "true" : "false";
+      const binary = c.contractSource.binaryResponse ? "true" : "false";
       lines.push(
-        `${pad}${objKey}: { method: ${safeMethod}; url: ${safeUrl}; params: ${params}; query: ${query}; body: ${body}; response: ${response}; error: ${error}; filterFields: ${filterFields}; stream: ${stream} };`
+        `${pad}${objKey}: { method: ${safeMethod}; url: ${safeUrl}; params: ${params}; query: ${query}; body: ${body}; response: ${response}; error: ${error}; filterFields: ${filterFields}; stream: ${stream}; binary: ${binary} };`
       );
     } else {
       lines.push(`${pad}${objKey}: {`);
@@ -819,6 +822,9 @@ function buildRequestModel(c) {
   if (hasQuery) optsParts.push("query: input?.query as Record<string, unknown> | undefined");
   if (hasBody) optsParts.push("body: input?.body");
   if (hasBody && c.contractSource.multipart) optsParts.push("multipart: true");
+  if (c.contractSource.binaryResponse && m !== "get") {
+    optsParts.unshift(`method: ${JSON.stringify(m.toUpperCase())}`);
+  }
   const optsExpr = optsParts.length ? `{ ${optsParts.join(", ")} }` : "{}";
   return {
     routeName: c.name,
@@ -838,7 +844,8 @@ function buildRequestModel(c) {
     queryKeyExpr: `(input === undefined ? [${flat}] as const : [${flat}, input] as const)`
   };
 }
-function renderFetcherRequest(req) {
+function renderFetcherRequest(req, binaryResponse) {
+  if (binaryResponse) return `fetcher.fetchBlob(${req.urlExpr}, ${req.optsExpr})`;
   return `fetcher.${req.method}<${req.responseType}>(${req.urlExpr}, ${req.optsExpr})`;
 }
 function emitReqHelper() {
@@ -899,7 +906,7 @@ function emitApiObjectBlock(tree, indent, p) {
     const leaf = {
       route: node.route,
       request: req,
-      requestExpr: renderFetcherRequest(req)
+      requestExpr: renderFetcherRequest(req, node.contractSource.binaryResponse === true)
     };
     const owned = /* @__PURE__ */ new Map();
     if (p.layer) {
@@ -959,6 +966,8 @@ var ROUTE_NAMESPACE = [
   '  export type FilterFields<K extends string> = ResolveByName<K, "filterFields">;',
   "  /** The streamed element type of an `@Sse()`/streaming route \u2014 the type yielded by its `stream()` AsyncIterable. */",
   '  export type Stream<K extends string> = ResolveByName<K, "response">;',
+  "  /** True for a binary/blob route (`StreamableFile`/`Buffer` handler return type). */",
+  '  export type Binary<K extends string> = ResolveByName<K, "binary">;',
   "  export type Request<K extends string> = {",
   "    body: Body<K>;",
   "    query: Query<K>;",
@@ -976,6 +985,7 @@ var PATH_NAMESPACE = [
   '  export type Error<M extends string, U extends string> = ResolveByPath<M, U, "error">;',
   '  export type FilterFields<M extends string, U extends string> = ResolveByPath<M, U, "filterFields">;',
   '  export type Stream<M extends string, U extends string> = ResolveByPath<M, U, "response">;',
+  '  export type Binary<M extends string, U extends string> = ResolveByPath<M, U, "binary">;',
   "}",
   ""
 ];
@@ -988,6 +998,7 @@ var EMPTY_ROUTE_NAMESPACE = [
   "  export type Error<K extends string> = never;",
   "  export type FilterFields<K extends string> = never;",
   "  export type Stream<K extends string> = never;",
+  "  export type Binary<K extends string> = never;",
   "  export type Request<K extends string> = { body: never; query: never; params: never };",
   "}",
   ""
@@ -1001,6 +1012,7 @@ var EMPTY_PATH_NAMESPACE = [
   "  export type Error<M extends string, U extends string> = never;",
   "  export type FilterFields<M extends string, U extends string> = never;",
   "  export type Stream<M extends string, U extends string> = never;",
+  "  export type Binary<M extends string, U extends string> = never;",
   "}",
   ""
 ];
@@ -1066,6 +1078,9 @@ function buildApiFile(routes, outDir, opts = {}) {
   if (serialization === "json" && contracted.length > 0) {
     lines.push(`import type { Jsonify } from '${runtimeImport}';`);
   }
+  if (contracted.some((r) => r.contract?.contractSource.binaryResponse)) {
+    lines.push(`import type { RawResponse } from '${runtimeImport}';`);
+  }
   if (importsByFile.size > 0 && outDir) {
     lines.push("");
     const emittedNames = /* @__PURE__ */ new Set();
@@ -1102,6 +1117,12 @@ function buildApiFile(routes, outDir, opts = {}) {
     lines.push("");
     lines.push(...EMPTY_ROUTE_NAMESPACE);
     lines.push(...EMPTY_PATH_NAMESPACE);
+    for (const ext of headerExts) {
+      const statements = ext.apiHeader?.(ctx)?.statements;
+      if (statements?.length) {
+        lines.push(...statements, "");
+      }
+    }
     return lines.join("\n");
   }
   const tree = /* @__PURE__ */ new Map();
@@ -2122,11 +2143,22 @@ import { join as join12, relative as relative6 } from "path";
 import fg2 from "fast-glob";
 var MANIFEST_FILE = ".codegen-manifest.json";
 var LOCK_FILE = ".watcher.lock";
+var DriftGuardError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DriftGuardError";
+  }
+};
+function isEntryPoint(value) {
+  return value === "cli" || value === "module";
+}
 function isManifestShape(value) {
   if (typeof value !== "object" || value === null) return false;
   const candidate = value;
   if (typeof candidate.version !== "string") return false;
   if (typeof candidate.hash !== "string") return false;
+  if (candidate.entryPoint !== void 0 && !isEntryPoint(candidate.entryPoint)) return false;
+  if (candidate.configHash !== void 0 && typeof candidate.configHash !== "string") return false;
   if (!Array.isArray(candidate.files)) return false;
   return candidate.files.every((entry) => typeof entry === "string");
 }
@@ -2169,11 +2201,20 @@ async function readManifest(outDir) {
     const raw = await readFile2(join12(outDir, MANIFEST_FILE), "utf8");
     const parsed = JSON.parse(raw);
     if (!isManifestShape(parsed)) return null;
-    return { version: parsed.version, hash: parsed.hash, files: parsed.files };
+    return {
+      version: parsed.version,
+      hash: parsed.hash,
+      ...parsed.entryPoint ? { entryPoint: parsed.entryPoint } : {},
+      ...parsed.configHash ? { configHash: parsed.configHash } : {},
+      files: parsed.files
+    };
   } catch {
     return null;
   }
 }
+function computeConfigHash(config) {
+  return createHash("sha256").update(serializeConfig(config)).digest("hex");
+}
 async function writeManifest(outDir, manifest) {
   await writeFile9(join12(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
@@ -2218,7 +2259,10 @@ function debugWarn(message) {
 }
 
 // src/generate.ts
-async function generate(config, inputRoutes = []) {
+function driftGuardMessage(outDir, previousEntryPoint, currentEntryPoint) {
+  return `[nestjs-codegen] Config drift detected in "${outDir}": the last generate ran from the "${previousEntryPoint}" entry point, this run is from the "${currentEntryPoint}" entry point, and their resolved configs differ (e.g. \`serialization: "json"\` vs \`"superjson"\`). Both entry points must read the SAME config \u2014 export a shared config object (e.g. codegen.config.ts) and import it from BOTH nestjs-codegen.config.ts (CLI) and NestjsCodegenModule.forRoot() (Nest module), or set \`driftGuard: false\` on either config to opt out of this check.`;
+}
+async function generate(config, inputRoutes = [], entryPoint = "cli") {
   setCodegenDebug(config.debug);
   const inputsHash = await computeInputsHash(config);
   const manifest = await readManifest(config.codegen.outDir);
@@ -2226,6 +2270,12 @@ async function generate(config, inputRoutes = []) {
     console.log(`[nestjs-codegen] ${config.codegen.outDir} up to date, skipped`);
     return;
   }
+  const configHash = computeConfigHash(config);
+  if (config.driftGuard && manifest?.entryPoint && manifest.entryPoint !== entryPoint && manifest.configHash && manifest.configHash !== configHash) {
+    throw new DriftGuardError(
+      driftGuardMessage(config.codegen.outDir, manifest.entryPoint, entryPoint)
+    );
+  }
   const extensions = config.extensions ?? [];
   let routes = inputRoutes;
   const ctx = createExtensionContext(config, () => routes);
@@ -2291,6 +2341,8 @@ async function generate(config, inputRoutes = []) {
   await writeManifest(config.codegen.outDir, {
     version: VERSION,
     hash: inputsHash,
+    entryPoint,
+    configHash,
     files: outputFiles
   });
 }
@@ -3880,6 +3932,14 @@ function resolveBodyQueryResponseRef(typeNode, sourceFile, project) {
 var STREAM_CONTAINERS = /* @__PURE__ */ new Set(["Observable", "AsyncIterable", "AsyncIterableIterator"]);
 var STREAM_CONTAINERS_GENERATOR = /* @__PURE__ */ new Set(["AsyncGenerator"]);
 var STREAM_ENVELOPES = /* @__PURE__ */ new Set(["MessageEvent", "MessageEventLike"]);
+var BINARY_RESPONSE_TYPES = /* @__PURE__ */ new Set(["StreamableFile", "Buffer"]);
+function detectBinaryResponse(method) {
+  const node = unwrapNamedContainer(method.getReturnTypeNode(), /* @__PURE__ */ new Set(["Promise"]));
+  if (!node || !Node6.isTypeReference(node)) return false;
+  const typeName = node.getTypeName();
+  const name = Node6.isIdentifier(typeName) ? typeName.getText() : "";
+  return BINARY_RESPONSE_TYPES.has(name);
+}
 function detectStreamElement(method) {
   const hasSse = method.getDecorators().some((d) => d.getName() === "Sse");
   let node = method.getReturnTypeNode();
@@ -3900,6 +3960,9 @@ function streamContainerElement(node) {
   }
   return null;
 }
+function hasAsQueryDecorator(method) {
+  return method.getDecorators().some((d) => d.getName() === "AsQuery");
+}
 function unwrapNamedContainer(node, names) {
   if (!node || !Node6.isTypeReference(node)) return node;
   const typeName = node.getTypeName();
@@ -3917,6 +3980,8 @@ function extractDtoContract(method, sourceFile, project) {
   const multipartBody = uploads.fields ? `{ ${uploads.fields} }` : null;
   const streamElement = detectStreamElement(method);
   const isStream = streamElement !== null;
+  const binaryResponse = detectBinaryResponse(method);
+  const asQuery = hasAsQueryDecorator(method);
   if (filterInfo && filterInfo.source === "body") {
     const bodyType = "import('@dudousxd/nestjs-filter-client').FilterQueryResult";
     body = body ?? bodyType;
@@ -3924,7 +3989,7 @@ function extractDtoContract(method, sourceFile, project) {
   const paramsType = extractParamsType(method, sourceFile, project);
   const response = isStream ? resolveTypeNodeToString(streamElement, sourceFile, project, 3) : extractResponseType(method, sourceFile, project);
   const errorInfo = extractErrorType(method, sourceFile, project);
-  if (body === null && query === null && paramsType === null && response === "unknown" && errorInfo === null && filterInfo === null && !isStream && !uploads.multipart) {
+  if (body === null && query === null && paramsType === null && response === "unknown" && errorInfo === null && filterInfo === null && !isStream && !uploads.multipart && !binaryResponse && !asQuery) {
     return null;
   }
   let bodyRef = null;
@@ -3999,7 +4064,9 @@ function extractDtoContract(method, sourceFile, project) {
     querySchema,
     stream: isStream,
     multipart: uploads.multipart,
-    multipartBody
+    multipartBody,
+    binaryResponse,
+    asQuery
   };
 }
 function resolveParamClass(method, decoratorName, sourceFile, project) {
@@ -4486,7 +4553,9 @@ function extractDtoRoute(args) {
       querySchema: dtoContract?.querySchema ?? null,
       stream: dtoContract?.stream ?? false,
       multipart: dtoContract?.multipart ?? false,
-      multipartBody: dtoContract?.multipartBody ?? null
+      multipartBody: dtoContract?.multipartBody ?? null,
+      binaryResponse: dtoContract?.binaryResponse ?? false,
+      asQuery: dtoContract?.asQuery ?? false
     }
   });
 }
@@ -4579,6 +4648,7 @@ var PAGES_DEBOUNCE_MS = 150;
 var NO_OP_WATCHER = { close: async () => {
 } };
 async function watch(config, onChange, options = {}) {
+  const entryPoint = options.entryPoint ?? "cli";
   const lock = await acquireLock(config.codegen.outDir);
   if (lock === null) {
     let holderPid = "unknown";
@@ -4610,13 +4680,17 @@ async function watch(config, onChange, options = {}) {
     try {
       const initialRoutes = (await getDiscovery()).discover();
       lastRoutes = initialRoutes;
-      await generate(config, initialRoutes);
+      await generate(config, initialRoutes, entryPoint);
     } catch (err) {
+      if (err instanceof DriftGuardError) {
+        console.error(err.message);
+        return;
+      }
       console.warn(
         `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
       );
       try {
-        await generate(config, lastRoutes);
+        await generate(config, lastRoutes, entryPoint);
       } catch {
       }
     }
@@ -4644,7 +4718,7 @@ async function watch(config, onChange, options = {}) {
     pagesDebounceTimer = setTimeout(async () => {
       pagesDebounceTimer = void 0;
       try {
-        await generate(config, lastRoutes);
+        await generate(config, lastRoutes, entryPoint);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Pages generation failed:",
@@ -4676,7 +4750,7 @@ async function watch(config, onChange, options = {}) {
       try {
         const routes = await (await getDiscovery()).rediscover(changed);
         lastRoutes = routes;
-        await generate(config, routes);
+        await generate(config, routes, entryPoint);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Contracts generation failed:",
@@ -4799,10 +4873,11 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.13.2";
+var VERSION = "0.14.0";
 export {
   CodegenError,
   ConfigError,
+  DriftGuardError,
   VERSION,
   acquireLock,
   buildMocksFile,