@dudousxd/nestjs-codegen 0.20.0 → 0.21.1

package/dist/cli/main.cjs

@@ -219,7 +219,7 @@ Run \`nestjs-codegen init\` to create a starter config.`
 
 // src/generate.ts
 var import_promises12 = require("fs/promises");
-var import_node_path14 = require("path");
+var import_node_path16 = require("path");
 
 // src/discovery/pages.ts
 var import_promises2 = require("fs/promises");
@@ -2206,438 +2206,177 @@ function buildEmpty() {
 // src/generate-manifest.ts
 var import_node_crypto = require("crypto");
 var import_promises11 = require("fs/promises");
-var import_node_path13 = require("path");
+var import_node_path15 = require("path");
+var import_fast_glob3 = __toESM(require("fast-glob"), 1);
+
+// src/discovery/contracts-fast.ts
+var import_node_fs = require("fs");
+var import_node_path14 = require("path");
 var import_fast_glob2 = __toESM(require("fast-glob"), 1);
-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";
+var import_ts_morph10 = require("ts-morph");
+
+// src/discovery/dto-type-resolver.ts
+var import_ts_morph8 = require("ts-morph");
+
+// src/discovery/dto-to-ir.ts
+var import_ts_morph4 = require("ts-morph");
+
+// src/util/debug-log.ts
+var debugEnabled = false;
+function setCodegenDebug(enabled) {
+  debugEnabled = enabled;
 }
-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 (candidate.configKeyHashes !== void 0 && !isStringRecord(candidate.configKeyHashes)) {
-    return false;
-  }
-  if (candidate.extraInputs !== void 0 && (!Array.isArray(candidate.extraInputs) || !candidate.extraInputs.every((entry) => typeof entry === "string"))) {
-    return false;
-  }
-  if (!Array.isArray(candidate.files)) return false;
-  return candidate.files.every((entry) => typeof entry === "string");
+function debugWarn(message) {
+  if (debugEnabled) console.warn(`[nestjs-codegen] ${message}`);
 }
-function isStringRecord(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
-  return Object.values(value).every((entry) => typeof entry === "string");
+
+// src/discovery/type-ref-resolution.ts
+var import_node_path13 = require("path");
+var import_ts_morph3 = require("ts-morph");
+var _EMPTY_CTX = { projectRoot: "", tsconfigPaths: null };
+var _ctxByProject = /* @__PURE__ */ new WeakMap();
+function setDiscoveryContext(project, ctx) {
+  _ctxByProject.set(project, ctx);
 }
-function serializeConfig(config) {
-  return serializeConfigValue(config, `unserializable:${config.codegen.outDir}`);
+function _ctxFor(project) {
+  return _ctxByProject.get(project) ?? _EMPTY_CTX;
 }
-function serializeConfigValue(value, unserializableMarker) {
-  try {
-    return JSON.stringify(value, (_key, entry) => {
-      if (typeof entry === "function") return `[fn:${entry.name}]`;
-      return entry;
+var _debug = process.env.NESTJS_INERTIA_DEBUG === "1";
+function dbg(...args) {
+  if (_debug) console.log("[codegen:debug]", ...args);
+}
+function findTypeInFile(name, file) {
+  const cls = file.getClass(name);
+  if (cls) return { kind: "class", decl: cls, file };
+  const iface = file.getInterface(name);
+  if (iface) return { kind: "interface", decl: iface, file };
+  const alias = file.getTypeAlias(name);
+  if (alias) {
+    const typeNode = alias.getTypeNode();
+    return {
+      kind: "typeAlias",
+      typeNode,
+      file,
+      text: typeNode ? typeNode.getText() : "unknown"
+    };
+  }
+  const enumDecl = file.getEnum(name);
+  if (enumDecl) {
+    const members = enumDecl.getMembers().map((m) => {
+      const val = m.getValue();
+      if (typeof val === "string" || typeof val === "number") return JSON.stringify(val);
+      return JSON.stringify(m.getName());
     });
-  } catch {
-    return unserializableMarker;
+    return { kind: "enum", members };
   }
+  return null;
 }
-function computeConfigKeyHashes(config) {
-  const hashes = {};
-  for (const [key, value] of Object.entries(config)) {
-    if (value === void 0) continue;
-    hashes[key] = (0, import_node_crypto.createHash)("sha256").update(serializeConfigValue(value, `unserializable:${key}`)).digest("hex");
+function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
+  if (moduleSpecifier.startsWith(".")) {
+    const dir = (0, import_node_path13.dirname)(sourceFile.getFilePath());
+    const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
+    return [
+      (0, import_node_path13.resolve)(dir, `${noExt}.ts`),
+      (0, import_node_path13.resolve)(dir, `${moduleSpecifier}.ts`),
+      (0, import_node_path13.resolve)(dir, moduleSpecifier, "index.ts")
+    ];
   }
-  return hashes;
-}
-function diffConfigKeyHashes(previous, current) {
-  const keys = /* @__PURE__ */ new Set([...Object.keys(previous), ...Object.keys(current)]);
-  return [...keys].filter((key) => previous[key] !== current[key]).sort();
-}
-async function discoverInputFiles(config) {
-  const globs = [config.contracts.glob, config.forms.watch];
-  if (config.pages) globs.push(config.pages.glob);
-  const cwd = config.codegen.cwd;
-  const matched = await (0, import_fast_glob2.default)(globs, { cwd, absolute: true, onlyFiles: true });
-  return [...new Set(matched)].sort();
-}
-async function computeInputsHash(config, extraInputs = []) {
-  const hash = (0, import_node_crypto.createHash)("sha256");
-  hash.update(`version:${VERSION}
-`);
-  hash.update(`config:${serializeConfig(config)}
-`);
-  const cwd = config.codegen.cwd;
-  const globbed = await discoverInputFiles(config);
-  const globbedRelative = new Set(globbed.map((file) => (0, import_node_path13.relative)(cwd, file)));
-  const extra = [...new Set(extraInputs)].filter((file) => !globbedRelative.has(file)).sort();
-  for (const file of globbed) {
-    const contents = await (0, import_promises11.readFile)(file, "utf8");
-    hash.update(`file:${(0, import_node_path13.relative)(cwd, file)}
-`);
-    hash.update(contents);
-    hash.update("\n");
+  const ctx = _ctxFor(project);
+  const baseUrl = ctx.pathsBase ?? ctx.projectRoot;
+  const tsconfigPaths = ctx.tsconfigPaths;
+  dbg(
+    "resolveModuleSpecifier",
+    moduleSpecifier,
+    "paths:",
+    JSON.stringify(tsconfigPaths),
+    "baseUrl:",
+    baseUrl
+  );
+  if (tsconfigPaths) {
+    for (const [pattern, mappings] of Object.entries(tsconfigPaths)) {
+      const prefix = pattern.replace("*", "");
+      if (moduleSpecifier.startsWith(prefix)) {
+        const rest = moduleSpecifier.slice(prefix.length);
+        const candidates = [];
+        for (const mapping of mappings) {
+          const resolved = (0, import_node_path13.resolve)(baseUrl, mapping.replace("*", rest));
+          candidates.push(`${resolved}.ts`, (0, import_node_path13.resolve)(resolved, "index.ts"));
+        }
+        dbg("  resolved candidates:", candidates);
+        return candidates;
+      }
+    }
   }
-  for (const file of extra) {
-    const contents = await (0, import_promises11.readFile)((0, import_node_path13.join)(cwd, file), "utf8").catch(() => null);
-    hash.update(`extra:${file}
-`);
-    hash.update(contents ?? "\0missing");
-    hash.update("\n");
+  return [];
+}
+function resolveImportedType(name, sourceFile, project) {
+  for (const importDecl of sourceFile.getImportDeclarations()) {
+    const namedImport = importDecl.getNamedImports().find((n) => n.getName() === name);
+    if (!namedImport) continue;
+    const moduleSpecifier = importDecl.getModuleSpecifierValue();
+    const candidates = resolveModuleSpecifier(moduleSpecifier, sourceFile, project);
+    for (const candidate of candidates) {
+      let importedFile = project.getSourceFile(candidate);
+      if (!importedFile) {
+        try {
+          importedFile = project.addSourceFileAtPath(candidate);
+        } catch {
+          continue;
+        }
+      }
+      const result = findTypeInFile(name, importedFile);
+      if (result) return result;
+      const viaReExport = resolveReExportedType(name, importedFile, project, /* @__PURE__ */ new Set());
+      if (viaReExport) return viaReExport;
+    }
+    if (candidates.length === 0) {
+      const viaCompiler = resolveBareSpecifierType(name, importDecl, project);
+      if (viaCompiler) return viaCompiler;
+    }
   }
-  return hash.digest("hex");
+  return resolveReExportedType(name, sourceFile, project, /* @__PURE__ */ new Set());
 }
-async function readManifest(outDir) {
+function resolveBareSpecifierType(name, importDecl, project) {
+  let target;
   try {
-    const raw = await (0, import_promises11.readFile)((0, import_node_path13.join)(outDir, MANIFEST_FILE), "utf8");
-    const parsed = JSON.parse(raw);
-    if (!isManifestShape(parsed)) return null;
-    return {
-      version: parsed.version,
-      hash: parsed.hash,
-      ...parsed.entryPoint ? { entryPoint: parsed.entryPoint } : {},
-      ...parsed.configHash ? { configHash: parsed.configHash } : {},
-      ...parsed.configKeyHashes ? { configKeyHashes: parsed.configKeyHashes } : {},
-      ...parsed.extraInputs ? { extraInputs: parsed.extraInputs } : {},
-      files: parsed.files
-    };
+    target = importDecl.getModuleSpecifierSourceFile();
   } catch {
     return null;
   }
+  if (!target) return null;
+  const direct = findTypeInFile(name, target);
+  if (direct) return direct;
+  return resolveReExportedType(name, target, project, /* @__PURE__ */ new Set());
 }
-function computeConfigHash(config) {
-  return (0, import_node_crypto.createHash)("sha256").update(serializeConfig(config)).digest("hex");
-}
-async function writeManifest(outDir, manifest) {
-  await (0, import_promises11.writeFile)((0, import_node_path13.join)(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
-`, "utf8");
-}
-async function listOutputFiles(outDir) {
-  const found = [];
-  async function walk(dir) {
-    const entries = await (0, import_promises11.readdir)(dir, { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-      const abs = (0, import_node_path13.join)(dir, entry.name);
-      if (entry.isDirectory()) {
-        await walk(abs);
-      } else if (entry.isFile()) {
-        const rel = (0, import_node_path13.relative)(outDir, abs);
-        if (rel === MANIFEST_FILE || rel === LOCK_FILE) continue;
-        found.push(rel);
-      }
+function resolveReExportedType(name, file, project, seen) {
+  const filePath = file.getFilePath();
+  if (seen.has(filePath)) return null;
+  seen.add(filePath);
+  for (const exportDecl of file.getExportDeclarations()) {
+    const moduleSpecifier = exportDecl.getModuleSpecifierValue();
+    const namedExports = exportDecl.getNamedExports();
+    if (moduleSpecifier) {
+      const hasStar = namedExports.length === 0;
+      const reExportsName2 = namedExports.some(
+        (n) => (n.getAliasNode()?.getText() ?? n.getName()) === name
+      );
+      if (!hasStar && !reExportsName2) continue;
+      const sourceName2 = hasStar ? name : namedExports.find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name)?.getName() ?? name;
+      const target = followModuleForType(sourceName2, moduleSpecifier, file, project, seen);
+      if (target) return target;
+      continue;
     }
+    const reExportsName = namedExports.some(
+      (n) => (n.getAliasNode()?.getText() ?? n.getName()) === name
+    );
+    if (!reExportsName) continue;
+    const sourceName = namedExports.find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name)?.getName() ?? name;
+    const local = findTypeInFile(sourceName, file);
+    if (local) return local;
+    const imported = resolveImportedType(sourceName, file, project);
+    if (imported) return imported;
   }
-  await walk(outDir);
-  return found.sort();
-}
-async function allOutputsExist(outDir, files) {
-  const present = new Set(await listOutputFiles(outDir));
-  return files.every((file) => present.has(file));
-}
-async function isManifestFresh(outDir, manifest, inputsHash) {
-  if (manifest === null) return false;
-  if (manifest.version !== VERSION) return false;
-  if (manifest.hash !== inputsHash) return false;
-  if (manifest.files.length === 0) return false;
-  return allOutputsExist(outDir, manifest.files);
-}
-
-// src/util/debug-log.ts
-var debugEnabled = false;
-function setCodegenDebug(enabled) {
-  debugEnabled = enabled;
-}
-function debugWarn(message) {
-  if (debugEnabled) console.warn(`[nestjs-codegen] ${message}`);
-}
-
-// src/generate.ts
-function driftGuardMessage(outDir, previousEntryPoint, currentEntryPoint, differingKeys) {
-  const differ = differingKeys.length > 0 ? `their resolved configs differ at: ${differingKeys.map((key) => `\`${key}\``).join(", ")}` : "their resolved configs differ (re-run after this generate records per-key hashes to see which keys)";
-  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 ${differ}. 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 manifest = await readManifest(config.codegen.outDir);
-  const inputsHash = await computeInputsHash(config, manifest?.extraInputs ?? []);
-  if (await isManifestFresh(config.codegen.outDir, manifest, inputsHash)) {
-    console.log(`[nestjs-codegen] ${config.codegen.outDir} up to date, skipped`);
-    return;
-  }
-  const configHash = computeConfigHash(config);
-  const configKeyHashes = computeConfigKeyHashes(config);
-  if (config.driftGuard && manifest?.entryPoint && manifest.entryPoint !== entryPoint && manifest.configHash && manifest.configHash !== configHash) {
-    throw new DriftGuardError(
-      driftGuardMessage(
-        config.codegen.outDir,
-        manifest.entryPoint,
-        entryPoint,
-        // A pre-key-hash manifest can't tell us WHICH keys differ — pass none
-        // rather than diffing against {} (which would name every key).
-        manifest.configKeyHashes ? diffConfigKeyHashes(manifest.configKeyHashes, configKeyHashes) : []
-      )
-    );
-  }
-  const extensions = config.extensions ?? [];
-  let routes = inputRoutes;
-  const trackedInputs = /* @__PURE__ */ new Set();
-  const ctx = createExtensionContext(config, () => routes, trackedInputs);
-  if (extensions.length > 0) {
-    routes = await applyTransformRoutes(routes, extensions, ctx);
-  }
-  if (config.pages) {
-    const pagesConfig = config.pages;
-    const pages = await discoverPages({
-      glob: pagesConfig.glob,
-      cwd: config.codegen.cwd,
-      propsExport: pagesConfig.propsExport,
-      componentNameStrategy: pagesConfig.componentNameStrategy
-    });
-    const sharedProps = discoverSharedPropsFromConfig(config);
-    await emitPages(pages, config.codegen.outDir, {
-      propsExport: pagesConfig.propsExport,
-      sharedProps
-    });
-    await emitCache(pages, config.codegen.outDir);
-  }
-  const hasRoutes = routes.length > 0;
-  const hasContracts = routes.some((r) => r.contract);
-  if (hasRoutes) {
-    await emitRoutes(routes, config.codegen.outDir);
-  }
-  if (hasContracts) {
-    await emitApi(routes, config.codegen.outDir, {
-      ...config.fetcher?.importPath ? { fetcherImportPath: config.fetcher.importPath } : {},
-      serialization: config.serialization,
-      extensions,
-      ctx
-    });
-  }
-  const hasForms = await emitForms(routes, config.codegen.outDir, config.forms, config.validation);
-  if (hasContracts && config.openapi.enabled) {
-    await emitOpenApi(routes, config.codegen.outDir, {
-      fileName: config.openapi.fileName,
-      info: {
-        title: config.openapi.title,
-        version: config.openapi.version,
-        ...config.openapi.description ? { description: config.openapi.description } : {}
-      }
-    });
-  }
-  if (hasContracts && config.mocks.enabled) {
-    await emitMocks(routes, config.codegen.outDir, {
-      fileName: config.mocks.fileName,
-      seed: config.mocks.seed,
-      baseUrl: config.mocks.baseUrl
-    });
-  }
-  await emitIndex(config.codegen.outDir, hasContracts, hasForms);
-  if (extensions.length > 0) {
-    const extraFiles = await collectEmittedFiles(extensions, ctx);
-    for (const file of extraFiles) {
-      const dest = (0, import_node_path14.join)(config.codegen.outDir, file.path);
-      await (0, import_promises12.mkdir)((0, import_node_path14.dirname)(dest), { recursive: true });
-      await (0, import_promises12.writeFile)(dest, file.contents, "utf8");
-    }
-  }
-  const outputFiles = await listOutputFiles(config.codegen.outDir);
-  const extraInputs = [...trackedInputs].sort();
-  const recordedHash = extraInputs.length > 0 ? await computeInputsHash(config, extraInputs) : inputsHash;
-  await writeManifest(config.codegen.outDir, {
-    version: VERSION,
-    hash: recordedHash,
-    entryPoint,
-    configHash,
-    configKeyHashes,
-    files: outputFiles,
-    ...extraInputs.length > 0 ? { extraInputs } : {}
-  });
-}
-
-// src/watch/watcher.ts
-var import_promises15 = require("fs/promises");
-var import_node_path18 = require("path");
-var import_chokidar = __toESM(require("chokidar"), 1);
-
-// src/discovery/contracts-fast.ts
-var import_node_path16 = require("path");
-var import_fast_glob3 = __toESM(require("fast-glob"), 1);
-var import_ts_morph10 = require("ts-morph");
-
-// src/discovery/dto-type-resolver.ts
-var import_ts_morph8 = require("ts-morph");
-
-// src/discovery/dto-to-ir.ts
-var import_ts_morph4 = require("ts-morph");
-
-// src/discovery/type-ref-resolution.ts
-var import_node_fs = require("fs");
-var import_node_path15 = require("path");
-var import_ts_morph3 = require("ts-morph");
-var _EMPTY_CTX = { projectRoot: "", tsconfigPaths: null };
-var _ctxByProject = /* @__PURE__ */ new WeakMap();
-function setDiscoveryContext(project, ctx) {
-  _ctxByProject.set(project, ctx);
-}
-function _ctxFor(project) {
-  return _ctxByProject.get(project) ?? _EMPTY_CTX;
-}
-var _debug = process.env.NESTJS_INERTIA_DEBUG === "1";
-function dbg(...args) {
-  if (_debug) console.log("[codegen:debug]", ...args);
-}
-function loadTsconfigPaths(tsconfigPath) {
-  try {
-    const raw = (0, import_node_fs.readFileSync)(tsconfigPath, "utf8");
-    const stripped = raw.replace(/\/\/.*$/gm, "");
-    const parsed = JSON.parse(stripped);
-    return parsed.compilerOptions?.paths ?? null;
-  } catch {
-    return null;
-  }
-}
-function findTypeInFile(name, file) {
-  const cls = file.getClass(name);
-  if (cls) return { kind: "class", decl: cls, file };
-  const iface = file.getInterface(name);
-  if (iface) return { kind: "interface", decl: iface, file };
-  const alias = file.getTypeAlias(name);
-  if (alias) {
-    const typeNode = alias.getTypeNode();
-    return {
-      kind: "typeAlias",
-      typeNode,
-      file,
-      text: typeNode ? typeNode.getText() : "unknown"
-    };
-  }
-  const enumDecl = file.getEnum(name);
-  if (enumDecl) {
-    const members = enumDecl.getMembers().map((m) => {
-      const val = m.getValue();
-      if (typeof val === "string" || typeof val === "number") return JSON.stringify(val);
-      return JSON.stringify(m.getName());
-    });
-    return { kind: "enum", members };
-  }
-  return null;
-}
-function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
-  if (moduleSpecifier.startsWith(".")) {
-    const dir = (0, import_node_path15.dirname)(sourceFile.getFilePath());
-    const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
-    return [
-      (0, import_node_path15.resolve)(dir, `${noExt}.ts`),
-      (0, import_node_path15.resolve)(dir, `${moduleSpecifier}.ts`),
-      (0, import_node_path15.resolve)(dir, moduleSpecifier, "index.ts")
-    ];
-  }
-  const ctx = _ctxFor(project);
-  const baseUrl = ctx.projectRoot;
-  const tsconfigPaths = ctx.tsconfigPaths;
-  dbg(
-    "resolveModuleSpecifier",
-    moduleSpecifier,
-    "paths:",
-    JSON.stringify(tsconfigPaths),
-    "baseUrl:",
-    baseUrl
-  );
-  if (tsconfigPaths) {
-    for (const [pattern, mappings] of Object.entries(tsconfigPaths)) {
-      const prefix = pattern.replace("*", "");
-      if (moduleSpecifier.startsWith(prefix)) {
-        const rest = moduleSpecifier.slice(prefix.length);
-        const candidates = [];
-        for (const mapping of mappings) {
-          const resolved = (0, import_node_path15.resolve)(baseUrl, mapping.replace("*", rest));
-          candidates.push(`${resolved}.ts`, (0, import_node_path15.resolve)(resolved, "index.ts"));
-        }
-        dbg("  resolved candidates:", candidates);
-        return candidates;
-      }
-    }
-  }
-  return [];
-}
-function resolveImportedType(name, sourceFile, project) {
-  for (const importDecl of sourceFile.getImportDeclarations()) {
-    const namedImport = importDecl.getNamedImports().find((n) => n.getName() === name);
-    if (!namedImport) continue;
-    const moduleSpecifier = importDecl.getModuleSpecifierValue();
-    const candidates = resolveModuleSpecifier(moduleSpecifier, sourceFile, project);
-    for (const candidate of candidates) {
-      let importedFile = project.getSourceFile(candidate);
-      if (!importedFile) {
-        try {
-          importedFile = project.addSourceFileAtPath(candidate);
-        } catch {
-          continue;
-        }
-      }
-      const result = findTypeInFile(name, importedFile);
-      if (result) return result;
-      const viaReExport = resolveReExportedType(name, importedFile, project, /* @__PURE__ */ new Set());
-      if (viaReExport) return viaReExport;
-    }
-    if (candidates.length === 0) {
-      const viaCompiler = resolveBareSpecifierType(name, importDecl, project);
-      if (viaCompiler) return viaCompiler;
-    }
-  }
-  return resolveReExportedType(name, sourceFile, project, /* @__PURE__ */ new Set());
-}
-function resolveBareSpecifierType(name, importDecl, project) {
-  let target;
-  try {
-    target = importDecl.getModuleSpecifierSourceFile();
-  } catch {
-    return null;
-  }
-  if (!target) return null;
-  const direct = findTypeInFile(name, target);
-  if (direct) return direct;
-  return resolveReExportedType(name, target, project, /* @__PURE__ */ new Set());
-}
-function resolveReExportedType(name, file, project, seen) {
-  const filePath = file.getFilePath();
-  if (seen.has(filePath)) return null;
-  seen.add(filePath);
-  for (const exportDecl of file.getExportDeclarations()) {
-    const moduleSpecifier = exportDecl.getModuleSpecifierValue();
-    const namedExports = exportDecl.getNamedExports();
-    if (moduleSpecifier) {
-      const hasStar = namedExports.length === 0;
-      const reExportsName2 = namedExports.some(
-        (n) => (n.getAliasNode()?.getText() ?? n.getName()) === name
-      );
-      if (!hasStar && !reExportsName2) continue;
-      const sourceName2 = hasStar ? name : namedExports.find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name)?.getName() ?? name;
-      const target = followModuleForType(sourceName2, moduleSpecifier, file, project, seen);
-      if (target) return target;
-      continue;
-    }
-    const reExportsName = namedExports.some(
-      (n) => (n.getAliasNode()?.getText() ?? n.getName()) === name
-    );
-    if (!reExportsName) continue;
-    const sourceName = namedExports.find((n) => (n.getAliasNode()?.getText() ?? n.getName()) === name)?.getName() ?? name;
-    const local = findTypeInFile(sourceName, file);
-    if (local) return local;
-    const imported = resolveImportedType(sourceName, file, project);
-    if (imported) return imported;
-  }
-  return null;
+  return null;
 }
 function followModuleForType(name, moduleSpecifier, fromFile, project, seen) {
   const candidates = resolveModuleSpecifier(moduleSpecifier, fromFile, project);
@@ -3736,7 +3475,7 @@ function extractFilterForHints(classDecl, project) {
   }
   return hints;
 }
-function extractApplyFilterInfo(method, sourceFile, project, mixin) {
+function extractApplyFilterInfo(method, sourceFile, project, mixin, controllerClass) {
   const declFile = method.getSourceFile();
   const mixinEntity = resolveMixinEntityClass(mixin, project);
   for (const param of method.getParameters()) {
@@ -3762,7 +3501,7 @@ function extractApplyFilterInfo(method, sourceFile, project, mixin) {
     const filterClassName = filterClassArg.getText();
     const resolved = factoryStaticClass ? void 0 : findType(filterClassName, declFile, project);
     const declaredClass = factoryStaticClass ?? (resolved?.kind === "class" ? resolved.decl : resolveLocalClassDeclaration(filterClassArg));
-    const ownRoute = !mixin || declFile.getFilePath() !== mixin.factoryFilePath;
+    const ownRoute = !mixin || (controllerClass ? method.getParent() === controllerClass : declFile.getFilePath() !== mixin.factoryFilePath);
     const namedByRoute = ownRoute && import_ts_morph7.Node.isIdentifier(filterClassArg) ? declaredClass : void 0;
     for (const candidate of orderFilterCandidates({
       namedByRoute,
@@ -4353,9 +4092,9 @@ function unwrapNamedContainer(node, names) {
   }
   return node;
 }
-function extractDtoContract(method, sourceFile, project, mixin) {
+function extractDtoContract(method, sourceFile, project, mixin, controllerClass) {
   let body = extractBodyType(method, sourceFile, project);
-  const filterInfo = extractApplyFilterInfo(method, sourceFile, project, mixin);
+  const filterInfo = extractApplyFilterInfo(method, sourceFile, project, mixin, controllerClass);
   const query = extractQueryType(method, sourceFile, project);
   const uploads = extractUploadedFiles(method);
   const multipartBody = uploads.fields ? `{ ${uploads.fields} }` : null;
@@ -4592,43 +4331,80 @@ function parseDefineContractCall(callExpr) {
 async function discoverContractsFast(opts) {
   const { cwd, glob, tsconfig } = opts;
   const tsconfigPath = resolveTsconfigPath(cwd, tsconfig);
-  const project = createDiscoveryProject(tsconfigPath);
-  const files = await (0, import_fast_glob3.default)(glob, { cwd, absolute: true, onlyFiles: true });
+  const loaded = loadDiscoveryTsconfig(tsconfigPath);
+  const project = createDiscoveryProject(tsconfigPath, loaded);
+  const files = await (0, import_fast_glob2.default)(glob, { cwd, absolute: true, onlyFiles: true });
   for (const f of files) {
     project.addSourceFileAtPath(f);
   }
-  bindDiscoveryContext(project, cwd, tsconfigPath);
+  bindDiscoveryContext(project, cwd, tsconfigPath, loaded);
   clearMixinTypeProject();
   return extractAllRoutes(project);
 }
-function resolveTsconfigPath(cwd, tsconfig) {
-  return tsconfig ? (0, import_node_path16.resolve)(tsconfig) : (0, import_node_path16.join)(cwd, "tsconfig.json");
+function resolveTsconfigPath(cwd, tsconfig) {
+  return tsconfig ? (0, import_node_path14.resolve)(tsconfig) : (0, import_node_path14.join)(cwd, "tsconfig.json");
+}
+var NO_TSCONFIG_OPTIONS = {
+  allowJs: true,
+  resolveJsonModule: false,
+  strict: false
+};
+function loadDiscoveryTsconfig(tsconfigPath) {
+  if (!(0, import_node_fs.existsSync)(tsconfigPath)) return { options: null, files: [] };
+  const read = import_ts_morph10.ts.readConfigFile(tsconfigPath, (path) => import_ts_morph10.ts.sys.readFile(path));
+  if (read.error) {
+    return {
+      options: null,
+      files: [tsconfigPath],
+      error: import_ts_morph10.ts.flattenDiagnosticMessageText(read.error.messageText, " ")
+    };
+  }
+  const host = {
+    useCaseSensitiveFileNames: import_ts_morph10.ts.sys.useCaseSensitiveFileNames,
+    // The one line that keeps a tsconfig from being a filesystem walk.
+    readDirectory: () => [],
+    fileExists: (path) => import_ts_morph10.ts.sys.fileExists(path),
+    // `extends` is resolved through the host, so a consumer whose `paths` live
+    // in a base tsconfig keeps working.
+    readFile: (path) => import_ts_morph10.ts.sys.readFile(path)
+  };
+  const sourceFile = import_ts_morph10.ts.readJsonConfigFile(tsconfigPath, (path) => import_ts_morph10.ts.sys.readFile(path));
+  const parsed = import_ts_morph10.ts.parseJsonSourceFileConfigFileContent(
+    sourceFile,
+    host,
+    (0, import_node_path14.dirname)(tsconfigPath),
+    void 0,
+    tsconfigPath
+  );
+  return {
+    options: parsed.options,
+    files: [tsconfigPath, ...sourceFile.extendedSourceFiles ?? []]
+  };
+}
+function pathsBaseDir(options, fallback) {
+  if (typeof options.baseUrl === "string") return options.baseUrl;
+  if (typeof options.pathsBasePath === "string") return options.pathsBasePath;
+  return fallback;
 }
-function createDiscoveryProject(tsconfigPath) {
-  try {
-    return new import_ts_morph10.Project({
-      tsConfigFilePath: tsconfigPath,
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true
-    });
-  } catch {
-    return new import_ts_morph10.Project({
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true,
-      compilerOptions: {
-        allowJs: true,
-        resolveJsonModule: false,
-        strict: false
-      }
-    });
+function createDiscoveryProject(tsconfigPath, tsconfig = loadDiscoveryTsconfig(tsconfigPath)) {
+  if (tsconfig.error) {
+    console.warn(
+      `[nestjs-codegen/fast] Could not load ${tsconfigPath}: ${tsconfig.error} \u2014 continuing WITHOUT its compiler options, so path alias imports (e.g. '@/...') will not resolve and controllers extending an alias-imported factory will contribute NO routes to the generated client.`
+    );
   }
+  return new import_ts_morph10.Project({
+    compilerOptions: tsconfig.options ?? { ...NO_TSCONFIG_OPTIONS },
+    skipAddingFilesFromTsConfig: true,
+    skipLoadingLibFiles: true,
+    skipFileDependencyResolution: true
+  });
 }
-function bindDiscoveryContext(project, cwd, tsconfigPath) {
+function bindDiscoveryContext(project, cwd, tsconfigPath, tsconfig = loadDiscoveryTsconfig(tsconfigPath)) {
+  const { options } = tsconfig;
   setDiscoveryContext(project, {
     projectRoot: cwd,
-    tsconfigPaths: loadTsconfigPaths(tsconfigPath)
+    tsconfigPaths: options?.paths ?? null,
+    pathsBase: options ? pathsBaseDir(options, cwd) : cwd
   });
 }
 function extractRoutesFrom(project, controllerPaths) {
@@ -4664,10 +4440,11 @@ var PersistentDiscovery = class _PersistentDiscovery {
   static async create(opts) {
     const { cwd, glob, tsconfig } = opts;
     const tsconfigPath = resolveTsconfigPath(cwd, tsconfig);
-    const project = createDiscoveryProject(tsconfigPath);
-    bindDiscoveryContext(project, cwd, tsconfigPath);
+    const loaded = loadDiscoveryTsconfig(tsconfigPath);
+    const project = createDiscoveryProject(tsconfigPath, loaded);
+    bindDiscoveryContext(project, cwd, tsconfigPath, loaded);
     const instance = new _PersistentDiscovery(project, cwd, glob);
-    const files = await (0, import_fast_glob3.default)(glob, { cwd, absolute: true, onlyFiles: true });
+    const files = await (0, import_fast_glob2.default)(glob, { cwd, absolute: true, onlyFiles: true });
     for (const f of files) {
       project.addSourceFileAtPath(f);
       instance.controllerPaths.add(f);
@@ -4688,7 +4465,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
   async rediscover(changedPaths) {
     if (changedPaths) {
       for (const p of changedPaths) {
-        const abs = (0, import_node_path16.resolve)(p);
+        const abs = (0, import_node_path14.resolve)(p);
         const sf = this.project.getSourceFile(abs);
         if (sf) {
           await sf.refreshFromFileSystem();
@@ -4696,7 +4473,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
       }
     }
     const globbed = new Set(
-      await (0, import_fast_glob3.default)(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
+      await (0, import_fast_glob2.default)(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
     );
     for (const f of globbed) {
       if (!this.controllerPaths.has(f)) {
@@ -4918,7 +4695,7 @@ function extractDtoRoute(args) {
   const methodName = method.getName();
   const classAs = readAsDecorator(cls, `class ${className}`);
   const methodAs = readAsDecorator(method, `${className}.${methodName}`);
-  const dtoContract = extractDtoContract(method, sourceFile, project, mixin);
+  const dtoContract = extractDtoContract(method, sourceFile, project, mixin, cls);
   const mixinResponse = mixin ? resolveInstantiatedReturnType(cls, methodName) : void 0;
   return buildRoute({
     className,
@@ -5006,6 +4783,268 @@ function extractFromSourceFile(sourceFile, project) {
   return routes;
 }
 
+// src/generate-manifest.ts
+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 (candidate.configKeyHashes !== void 0 && !isStringRecord(candidate.configKeyHashes)) {
+    return false;
+  }
+  if (candidate.extraInputs !== void 0 && (!Array.isArray(candidate.extraInputs) || !candidate.extraInputs.every((entry) => typeof entry === "string"))) {
+    return false;
+  }
+  if (!Array.isArray(candidate.files)) return false;
+  return candidate.files.every((entry) => typeof entry === "string");
+}
+function isStringRecord(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  return Object.values(value).every((entry) => typeof entry === "string");
+}
+function serializeConfig(config) {
+  return serializeConfigValue(config, `unserializable:${config.codegen.outDir}`);
+}
+function serializeConfigValue(value, unserializableMarker) {
+  try {
+    return JSON.stringify(value, (_key, entry) => {
+      if (typeof entry === "function") return `[fn:${entry.name}]`;
+      return entry;
+    });
+  } catch {
+    return unserializableMarker;
+  }
+}
+function computeConfigKeyHashes(config) {
+  const hashes = {};
+  for (const [key, value] of Object.entries(config)) {
+    if (value === void 0) continue;
+    hashes[key] = (0, import_node_crypto.createHash)("sha256").update(serializeConfigValue(value, `unserializable:${key}`)).digest("hex");
+  }
+  return hashes;
+}
+function diffConfigKeyHashes(previous, current) {
+  const keys = /* @__PURE__ */ new Set([...Object.keys(previous), ...Object.keys(current)]);
+  return [...keys].filter((key) => previous[key] !== current[key]).sort();
+}
+async function discoverInputFiles(config) {
+  const globs = [config.contracts.glob, config.forms.watch];
+  if (config.pages) globs.push(config.pages.glob);
+  const cwd = config.codegen.cwd;
+  const matched = await (0, import_fast_glob3.default)(globs, { cwd, absolute: true, onlyFiles: true });
+  return [...new Set(matched)].sort();
+}
+async function computeInputsHash(config, extraInputs = []) {
+  const hash = (0, import_node_crypto.createHash)("sha256");
+  hash.update(`version:${VERSION}
+`);
+  hash.update(`config:${serializeConfig(config)}
+`);
+  const cwd = config.codegen.cwd;
+  const tsconfigPath = resolveTsconfigPath(cwd, config.app?.tsconfig ?? void 0);
+  const tsconfigFiles = loadDiscoveryTsconfig(tsconfigPath).files;
+  for (const file of tsconfigFiles.length > 0 ? tsconfigFiles : [tsconfigPath]) {
+    const contents = await (0, import_promises11.readFile)(file, "utf8").catch(() => null);
+    hash.update(`tsconfig:${(0, import_node_path15.relative)(cwd, file)}
+`);
+    hash.update(contents ?? " missing");
+    hash.update("\n");
+  }
+  const globbed = await discoverInputFiles(config);
+  const globbedRelative = new Set(globbed.map((file) => (0, import_node_path15.relative)(cwd, file)));
+  const extra = [...new Set(extraInputs)].filter((file) => !globbedRelative.has(file)).sort();
+  for (const file of globbed) {
+    const contents = await (0, import_promises11.readFile)(file, "utf8");
+    hash.update(`file:${(0, import_node_path15.relative)(cwd, file)}
+`);
+    hash.update(contents);
+    hash.update("\n");
+  }
+  for (const file of extra) {
+    const contents = await (0, import_promises11.readFile)((0, import_node_path15.join)(cwd, file), "utf8").catch(() => null);
+    hash.update(`extra:${file}
+`);
+    hash.update(contents ?? "\0missing");
+    hash.update("\n");
+  }
+  return hash.digest("hex");
+}
+async function readManifest(outDir) {
+  try {
+    const raw = await (0, import_promises11.readFile)((0, import_node_path15.join)(outDir, MANIFEST_FILE), "utf8");
+    const parsed = JSON.parse(raw);
+    if (!isManifestShape(parsed)) return null;
+    return {
+      version: parsed.version,
+      hash: parsed.hash,
+      ...parsed.entryPoint ? { entryPoint: parsed.entryPoint } : {},
+      ...parsed.configHash ? { configHash: parsed.configHash } : {},
+      ...parsed.configKeyHashes ? { configKeyHashes: parsed.configKeyHashes } : {},
+      ...parsed.extraInputs ? { extraInputs: parsed.extraInputs } : {},
+      files: parsed.files
+    };
+  } catch {
+    return null;
+  }
+}
+function computeConfigHash(config) {
+  return (0, import_node_crypto.createHash)("sha256").update(serializeConfig(config)).digest("hex");
+}
+async function writeManifest(outDir, manifest) {
+  await (0, import_promises11.writeFile)((0, import_node_path15.join)(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
+`, "utf8");
+}
+async function listOutputFiles(outDir) {
+  const found = [];
+  async function walk(dir) {
+    const entries = await (0, import_promises11.readdir)(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+      const abs = (0, import_node_path15.join)(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(abs);
+      } else if (entry.isFile()) {
+        const rel = (0, import_node_path15.relative)(outDir, abs);
+        if (rel === MANIFEST_FILE || rel === LOCK_FILE) continue;
+        found.push(rel);
+      }
+    }
+  }
+  await walk(outDir);
+  return found.sort();
+}
+async function allOutputsExist(outDir, files) {
+  const present = new Set(await listOutputFiles(outDir));
+  return files.every((file) => present.has(file));
+}
+async function isManifestFresh(outDir, manifest, inputsHash) {
+  if (manifest === null) return false;
+  if (manifest.version !== VERSION) return false;
+  if (manifest.hash !== inputsHash) return false;
+  if (manifest.files.length === 0) return false;
+  return allOutputsExist(outDir, manifest.files);
+}
+
+// src/generate.ts
+function driftGuardMessage(outDir, previousEntryPoint, currentEntryPoint, differingKeys) {
+  const differ = differingKeys.length > 0 ? `their resolved configs differ at: ${differingKeys.map((key) => `\`${key}\``).join(", ")}` : "their resolved configs differ (re-run after this generate records per-key hashes to see which keys)";
+  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 ${differ}. 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 manifest = await readManifest(config.codegen.outDir);
+  const inputsHash = await computeInputsHash(config, manifest?.extraInputs ?? []);
+  if (await isManifestFresh(config.codegen.outDir, manifest, inputsHash)) {
+    console.log(`[nestjs-codegen] ${config.codegen.outDir} up to date, skipped`);
+    return;
+  }
+  const configHash = computeConfigHash(config);
+  const configKeyHashes = computeConfigKeyHashes(config);
+  if (config.driftGuard && manifest?.entryPoint && manifest.entryPoint !== entryPoint && manifest.configHash && manifest.configHash !== configHash) {
+    throw new DriftGuardError(
+      driftGuardMessage(
+        config.codegen.outDir,
+        manifest.entryPoint,
+        entryPoint,
+        // A pre-key-hash manifest can't tell us WHICH keys differ — pass none
+        // rather than diffing against {} (which would name every key).
+        manifest.configKeyHashes ? diffConfigKeyHashes(manifest.configKeyHashes, configKeyHashes) : []
+      )
+    );
+  }
+  const extensions = config.extensions ?? [];
+  let routes = inputRoutes;
+  const trackedInputs = /* @__PURE__ */ new Set();
+  const ctx = createExtensionContext(config, () => routes, trackedInputs);
+  if (extensions.length > 0) {
+    routes = await applyTransformRoutes(routes, extensions, ctx);
+  }
+  if (config.pages) {
+    const pagesConfig = config.pages;
+    const pages = await discoverPages({
+      glob: pagesConfig.glob,
+      cwd: config.codegen.cwd,
+      propsExport: pagesConfig.propsExport,
+      componentNameStrategy: pagesConfig.componentNameStrategy
+    });
+    const sharedProps = discoverSharedPropsFromConfig(config);
+    await emitPages(pages, config.codegen.outDir, {
+      propsExport: pagesConfig.propsExport,
+      sharedProps
+    });
+    await emitCache(pages, config.codegen.outDir);
+  }
+  const hasRoutes = routes.length > 0;
+  const hasContracts = routes.some((r) => r.contract);
+  if (hasRoutes) {
+    await emitRoutes(routes, config.codegen.outDir);
+  }
+  if (hasContracts) {
+    await emitApi(routes, config.codegen.outDir, {
+      ...config.fetcher?.importPath ? { fetcherImportPath: config.fetcher.importPath } : {},
+      serialization: config.serialization,
+      extensions,
+      ctx
+    });
+  }
+  const hasForms = await emitForms(routes, config.codegen.outDir, config.forms, config.validation);
+  if (hasContracts && config.openapi.enabled) {
+    await emitOpenApi(routes, config.codegen.outDir, {
+      fileName: config.openapi.fileName,
+      info: {
+        title: config.openapi.title,
+        version: config.openapi.version,
+        ...config.openapi.description ? { description: config.openapi.description } : {}
+      }
+    });
+  }
+  if (hasContracts && config.mocks.enabled) {
+    await emitMocks(routes, config.codegen.outDir, {
+      fileName: config.mocks.fileName,
+      seed: config.mocks.seed,
+      baseUrl: config.mocks.baseUrl
+    });
+  }
+  await emitIndex(config.codegen.outDir, hasContracts, hasForms);
+  if (extensions.length > 0) {
+    const extraFiles = await collectEmittedFiles(extensions, ctx);
+    for (const file of extraFiles) {
+      const dest = (0, import_node_path16.join)(config.codegen.outDir, file.path);
+      await (0, import_promises12.mkdir)((0, import_node_path16.dirname)(dest), { recursive: true });
+      await (0, import_promises12.writeFile)(dest, file.contents, "utf8");
+    }
+  }
+  const outputFiles = await listOutputFiles(config.codegen.outDir);
+  const extraInputs = [...trackedInputs].sort();
+  const recordedHash = extraInputs.length > 0 ? await computeInputsHash(config, extraInputs) : inputsHash;
+  await writeManifest(config.codegen.outDir, {
+    version: VERSION,
+    hash: recordedHash,
+    entryPoint,
+    configHash,
+    configKeyHashes,
+    files: outputFiles,
+    ...extraInputs.length > 0 ? { extraInputs } : {}
+  });
+}
+
+// src/watch/watcher.ts
+var import_promises15 = require("fs/promises");
+var import_node_path18 = require("path");
+var import_chokidar = __toESM(require("chokidar"), 1);
+
 // src/watch/lock-file.ts
 var import_promises13 = require("fs/promises");
 var import_promises14 = require("fs/promises");
@@ -5199,7 +5238,7 @@ async function watch(config, onChange, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.20.0";
+var VERSION = "0.21.1";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {