@dudousxd/nestjs-codegen 0.20.0 → 0.21.1

package/dist/cli/main.js

@@ -185,7 +185,7 @@ Run \`nestjs-codegen init\` to create a starter config.`
 
 // src/generate.ts
 import { mkdir as mkdir9, writeFile as writeFile10 } from "fs/promises";
-import { dirname as dirname2, join as join13 } from "path";
+import { dirname as dirname4, join as join14 } from "path";
 
 // src/discovery/pages.ts
 import { readFile } from "fs/promises";
@@ -2172,275 +2172,17 @@ function buildEmpty() {
 // src/generate-manifest.ts
 import { createHash } from "crypto";
 import { readFile as readFile2, readdir, writeFile as writeFile9 } from "fs/promises";
-import { join as join12, relative as relative7 } 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 (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] = 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 fg2(globs, { cwd, absolute: true, onlyFiles: true });
-  return [...new Set(matched)].sort();
-}
-async function computeInputsHash(config, extraInputs = []) {
-  const hash = 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) => relative7(cwd, file)));
-  const extra = [...new Set(extraInputs)].filter((file) => !globbedRelative.has(file)).sort();
-  for (const file of globbed) {
-    const contents = await readFile2(file, "utf8");
-    hash.update(`file:${relative7(cwd, file)}
-`);
-    hash.update(contents);
-    hash.update("\n");
-  }
-  for (const file of extra) {
-    const contents = await readFile2(join12(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 readFile2(join12(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 createHash("sha256").update(serializeConfig(config)).digest("hex");
-}
-async function writeManifest(outDir, manifest) {
-  await writeFile9(join12(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
-`, "utf8");
-}
-async function listOutputFiles(outDir) {
-  const found = [];
-  async function walk(dir) {
-    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-      const abs = join12(dir, entry.name);
-      if (entry.isDirectory()) {
-        await walk(abs);
-      } else if (entry.isFile()) {
-        const rel = relative7(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/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 = join13(config.codegen.outDir, file.path);
-      await mkdir9(dirname2(dest), { recursive: true });
-      await writeFile10(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
-import { readFile as readFile4 } from "fs/promises";
-import { join as join16 } from "path";
-import chokidar from "chokidar";
+import { join as join13, relative as relative7 } from "path";
+import fg3 from "fast-glob";
 
 // src/discovery/contracts-fast.ts
-import { join as join14, resolve as resolve4 } from "path";
-import fg3 from "fast-glob";
+import { existsSync } from "fs";
+import { dirname as dirname3, join as join12, resolve as resolve4 } from "path";
+import fg2 from "fast-glob";
 import {
   Node as Node9,
-  Project as Project4
+  Project as Project4,
+  ts
 } from "ts-morph";
 
 // src/discovery/dto-type-resolver.ts
@@ -2454,9 +2196,17 @@ import {
   Node as Node3
 } from "ts-morph";
 
+// src/util/debug-log.ts
+var debugEnabled = false;
+function setCodegenDebug(enabled) {
+  debugEnabled = enabled;
+}
+function debugWarn(message) {
+  if (debugEnabled) console.warn(`[nestjs-codegen] ${message}`);
+}
+
 // src/discovery/type-ref-resolution.ts
-import { readFileSync } from "fs";
-import { dirname as dirname3, resolve as resolve3 } from "path";
+import { dirname as dirname2, resolve as resolve3 } from "path";
 import {
   Node as Node2
 } from "ts-morph";
@@ -2472,16 +2222,6 @@ var _debug = process.env.NESTJS_INERTIA_DEBUG === "1";
 function dbg(...args) {
   if (_debug) console.log("[codegen:debug]", ...args);
 }
-function loadTsconfigPaths(tsconfigPath) {
-  try {
-    const raw = 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 };
@@ -2510,7 +2250,7 @@ function findTypeInFile(name, file) {
 }
 function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   if (moduleSpecifier.startsWith(".")) {
-    const dir = dirname3(sourceFile.getFilePath());
+    const dir = dirname2(sourceFile.getFilePath());
     const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
     return [
       resolve3(dir, `${noExt}.ts`),
@@ -2519,7 +2259,7 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
     ];
   }
   const ctx = _ctxFor(project);
-  const baseUrl = ctx.projectRoot;
+  const baseUrl = ctx.pathsBase ?? ctx.projectRoot;
   const tsconfigPaths = ctx.tsconfigPaths;
   dbg(
     "resolveModuleSpecifier",
@@ -3717,7 +3457,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()) {
@@ -3743,7 +3483,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 && Node6.isIdentifier(filterClassArg) ? declaredClass : void 0;
     for (const candidate of orderFilterCandidates({
       namedByRoute,
@@ -4334,9 +4074,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;
@@ -4573,43 +4313,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 fg3(glob, { cwd, absolute: true, onlyFiles: true });
+  const loaded = loadDiscoveryTsconfig(tsconfigPath);
+  const project = createDiscoveryProject(tsconfigPath, loaded);
+  const files = await fg2(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 ? resolve4(tsconfig) : join14(cwd, "tsconfig.json");
+  return tsconfig ? resolve4(tsconfig) : join12(cwd, "tsconfig.json");
 }
-function createDiscoveryProject(tsconfigPath) {
-  try {
-    return new Project4({
-      tsConfigFilePath: tsconfigPath,
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true
-    });
-  } catch {
-    return new Project4({
-      skipAddingFilesFromTsConfig: true,
-      skipLoadingLibFiles: true,
-      skipFileDependencyResolution: true,
-      compilerOptions: {
-        allowJs: true,
-        resolveJsonModule: false,
-        strict: false
-      }
-    });
+var NO_TSCONFIG_OPTIONS = {
+  allowJs: true,
+  resolveJsonModule: false,
+  strict: false
+};
+function loadDiscoveryTsconfig(tsconfigPath) {
+  if (!existsSync(tsconfigPath)) return { options: null, files: [] };
+  const read = ts.readConfigFile(tsconfigPath, (path) => ts.sys.readFile(path));
+  if (read.error) {
+    return {
+      options: null,
+      files: [tsconfigPath],
+      error: ts.flattenDiagnosticMessageText(read.error.messageText, " ")
+    };
+  }
+  const host = {
+    useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+    // The one line that keeps a tsconfig from being a filesystem walk.
+    readDirectory: () => [],
+    fileExists: (path) => ts.sys.fileExists(path),
+    // `extends` is resolved through the host, so a consumer whose `paths` live
+    // in a base tsconfig keeps working.
+    readFile: (path) => ts.sys.readFile(path)
+  };
+  const sourceFile = ts.readJsonConfigFile(tsconfigPath, (path) => ts.sys.readFile(path));
+  const parsed = ts.parseJsonSourceFileConfigFileContent(
+    sourceFile,
+    host,
+    dirname3(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, 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 Project4({
+    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) {
@@ -4645,10 +4422,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 fg3(glob, { cwd, absolute: true, onlyFiles: true });
+    const files = await fg2(glob, { cwd, absolute: true, onlyFiles: true });
     for (const f of files) {
       project.addSourceFileAtPath(f);
       instance.controllerPaths.add(f);
@@ -4677,7 +4455,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
       }
     }
     const globbed = new Set(
-      await fg3(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
+      await fg2(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
     );
     for (const f of globbed) {
       if (!this.controllerPaths.has(f)) {
@@ -4899,7 +4677,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,
@@ -4987,6 +4765,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] = 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 fg3(globs, { cwd, absolute: true, onlyFiles: true });
+  return [...new Set(matched)].sort();
+}
+async function computeInputsHash(config, extraInputs = []) {
+  const hash = 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 readFile2(file, "utf8").catch(() => null);
+    hash.update(`tsconfig:${relative7(cwd, file)}
+`);
+    hash.update(contents ?? " missing");
+    hash.update("\n");
+  }
+  const globbed = await discoverInputFiles(config);
+  const globbedRelative = new Set(globbed.map((file) => relative7(cwd, file)));
+  const extra = [...new Set(extraInputs)].filter((file) => !globbedRelative.has(file)).sort();
+  for (const file of globbed) {
+    const contents = await readFile2(file, "utf8");
+    hash.update(`file:${relative7(cwd, file)}
+`);
+    hash.update(contents);
+    hash.update("\n");
+  }
+  for (const file of extra) {
+    const contents = await readFile2(join13(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 readFile2(join13(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 createHash("sha256").update(serializeConfig(config)).digest("hex");
+}
+async function writeManifest(outDir, manifest) {
+  await writeFile9(join13(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
+`, "utf8");
+}
+async function listOutputFiles(outDir) {
+  const found = [];
+  async function walk(dir) {
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+      const abs = join13(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(abs);
+      } else if (entry.isFile()) {
+        const rel = relative7(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 = join14(config.codegen.outDir, file.path);
+      await mkdir9(dirname4(dest), { recursive: true });
+      await writeFile10(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
+import { readFile as readFile4 } from "fs/promises";
+import { join as join16 } from "path";
+import chokidar from "chokidar";
+
 // src/watch/lock-file.ts
 import { open } from "fs/promises";
 import { mkdir as mkdir10, readFile as readFile3, unlink } from "fs/promises";
@@ -5180,7 +5220,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 = {}) {
@@ -5208,22 +5248,22 @@ async function runCodegen(opts = {}) {
 
 // src/cli/doctor.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { appendFileSync, existsSync, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { appendFileSync, existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join18 } from "path";
 
 // src/cli/init.ts
 import { execFileSync } from "child_process";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { access as access2, mkdir as mkdir11, readFile as readFile5, writeFile as writeFile11 } from "fs/promises";
 import { join as join17 } from "path";
 import { createInterface } from "readline";
 
 // src/cli/patch-utils.ts
-import { readFileSync as readFileSync2, writeFileSync } from "fs";
+import { readFileSync, writeFileSync } from "fs";
 function patchJsonFile(filePath, mutator, parse = (raw) => raw) {
   let raw;
   try {
-    raw = readFileSync2(filePath, "utf8");
+    raw = readFileSync(filePath, "utf8");
   } catch {
     return "skipped";
   }
@@ -5441,7 +5481,7 @@ async function patchPackageJsonScripts(cwd, scripts) {
 function patchAppModule(filePath, rootView) {
   let content;
   try {
-    content = readFileSync3(filePath, "utf8");
+    content = readFileSync2(filePath, "utf8");
   } catch {
     return "skipped";
   }
@@ -5482,7 +5522,7 @@ ${indent}HomeController,${content.slice(bracketPos)}`;
 function patchMainTs(filePath) {
   let content;
   try {
-    content = readFileSync3(filePath, "utf8");
+    content = readFileSync2(filePath, "utf8");
   } catch {
     return "skipped";
   }
@@ -5962,18 +6002,18 @@ ${green("\u2713")} Setup complete! Run: ${bold("nest start --watch")}
 
 // src/cli/doctor.ts
 function checkFileExists(cwd, file) {
-  return existsSync(join18(cwd, file));
+  return existsSync2(join18(cwd, file));
 }
 function readJson(path) {
   try {
-    const raw = readFileSync4(path, "utf8").replace(/\/\/.*$/gm, "");
+    const raw = readFileSync3(path, "utf8").replace(/\/\/.*$/gm, "");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
 function writeJsonField(filePath, dotPath, value) {
-  const raw = readFileSync4(filePath, "utf8");
+  const raw = readFileSync3(filePath, "utf8");
   const stripped = raw.replace(/\/\/.*$/gm, "");
   const obj = JSON.parse(stripped);
   let target = obj;
@@ -6005,8 +6045,8 @@ function getPackageVersion(cwd, pkg) {
   }
 }
 function detectPkgManager(cwd) {
-  if (existsSync(join18(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync(join18(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync2(join18(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync2(join18(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
 async function runDoctor(opts) {
@@ -6175,14 +6215,14 @@ async function runDoctor(opts) {
   const innerTsconfigPath = join18(cwd, "inertia", "tsconfig.json");
   checks.push({
     name: "inertia/tsconfig.json exists (VSCode picks up ~codegen alias)",
-    pass: existsSync(innerTsconfigPath),
+    pass: existsSync2(innerTsconfigPath),
     fix: "Create inertia/tsconfig.json that extends ../tsconfig.inertia.json",
     autoFix: () => {
       writeFileSync3(innerTsconfigPath, INERTIA_TSCONFIG_TEMPLATE, "utf8");
     }
   });
   if (checkFileExists(cwd, "vite.config.ts")) {
-    const viteContent = readFileSync4(join18(cwd, "vite.config.ts"), "utf8");
+    const viteContent = readFileSync3(join18(cwd, "vite.config.ts"), "utf8");
     checks.push({
       name: "vite.config.ts has resolve.alias",
       pass: viteContent.includes("resolve") && viteContent.includes("alias"),
@@ -6248,7 +6288,7 @@ async function runDoctor(opts) {
   }
   if (checkFileExists(cwd, ".gitignore")) {
     const gitignorePath = join18(cwd, ".gitignore");
-    const gitignore = readFileSync4(gitignorePath, "utf8");
+    const gitignore = readFileSync3(gitignorePath, "utf8");
     checks.push({
       name: ".gitignore includes .nestjs-inertia/",
       pass: gitignore.includes(".nestjs-inertia"),