@dudousxd/nestjs-codegen 0.16.0 → 0.17.0

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_path13 = require("path");
+var import_node_path14 = require("path");
 
 // src/discovery/pages.ts
 var import_promises2 = require("fs/promises");
@@ -548,9 +548,10 @@ function inferExpressionType(node) {
 
 // src/emit/emit-api.ts
 var import_promises3 = require("fs/promises");
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 
 // src/extension/registry.ts
+var import_node_path4 = require("path");
 var import_ts_morph2 = require("ts-morph");
 function resolveApiSlots(extensions) {
   let layer;
@@ -583,7 +584,7 @@ function mergeExclusive(target, incoming, {
     target.set(key, { value, owner });
   }
 }
-function createExtensionContext(config, getRoutes) {
+function createExtensionContext(config, getRoutes, trackedInputs) {
   let project;
   return {
     cwd: config.codegen.cwd,
@@ -592,6 +593,13 @@ function createExtensionContext(config, getRoutes) {
     get routes() {
       return getRoutes();
     },
+    trackInput(...paths) {
+      if (!trackedInputs) return;
+      for (const path of paths) {
+        if (!path) continue;
+        trackedInputs.add((0, import_node_path4.relative)(config.codegen.cwd, (0, import_node_path4.resolve)(config.codegen.cwd, path)));
+      }
+    },
     project() {
       if (!project) {
         project = new import_ts_morph2.Project({
@@ -651,7 +659,7 @@ function requestShape(route) {
 async function emitApi(routes, outDir, opts = {}) {
   await (0, import_promises3.mkdir)(outDir, { recursive: true });
   const content = buildApiFile(routes, outDir, opts);
-  await (0, import_promises3.writeFile)((0, import_node_path4.join)(outDir, "api.ts"), content, "utf8");
+  await (0, import_promises3.writeFile)((0, import_node_path5.join)(outDir, "api.ts"), content, "utf8");
 }
 function splitName(name) {
   return name.split(".");
@@ -759,7 +767,7 @@ function rawResponseType(c, outDir) {
     return c.contractSource.response;
   }
   if (c.controllerRef) {
-    let relPath = (0, import_node_path4.relative)(outDir, c.controllerRef.filePath).replace(/\.ts$/, "");
+    let relPath = (0, import_node_path5.relative)(outDir, c.controllerRef.filePath).replace(/\.ts$/, "");
     if (!relPath.startsWith(".")) relPath = `./${relPath}`;
     return `Awaited<ReturnType<import('${relPath}').${c.controllerRef.className}['${c.controllerRef.methodName}']>>`;
   }
@@ -1085,6 +1093,11 @@ function buildApiFile(routes, outDir, opts = {}) {
     config: {},
     project: () => {
       throw new Error("ExtensionContext.project() is unavailable in standalone emitApi.");
+    },
+    // No manifest is written on the standalone path, so there is nothing for
+    // tracked dependencies to be recorded into — accept and discard them
+    // rather than making every caller supply a sink.
+    trackInput: () => {
     }
   };
   const importsByFile = /* @__PURE__ */ new Map();
@@ -1140,8 +1153,8 @@ function buildApiFile(routes, outDir, opts = {}) {
     const emittedNames = /* @__PURE__ */ new Set();
     for (const [filePath, names] of importsByFile) {
       let relPath;
-      if ((0, import_node_path4.isAbsolute)(filePath)) {
-        relPath = (0, import_node_path4.relative)(outDir, filePath).replace(/\.ts$/, "");
+      if ((0, import_node_path5.isAbsolute)(filePath)) {
+        relPath = (0, import_node_path5.relative)(outDir, filePath).replace(/\.ts$/, "");
         if (!relPath.startsWith(".")) relPath = `./${relPath}`;
       } else {
         relPath = filePath;
@@ -1235,7 +1248,7 @@ function buildApiFile(routes, outDir, opts = {}) {
 
 // src/emit/emit-cache.ts
 var import_promises4 = require("fs/promises");
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 async function emitCache(pages, outDir) {
   await (0, import_promises4.mkdir)(outDir, { recursive: true });
   const entries = await Promise.all(
@@ -1249,19 +1262,19 @@ async function emitCache(pages, outDir) {
     })
   );
   const cache = { pages: entries };
-  await (0, import_promises4.writeFile)((0, import_node_path5.join)(outDir, "components.json"), `${JSON.stringify(cache, null, 2)}
+  await (0, import_promises4.writeFile)((0, import_node_path6.join)(outDir, "components.json"), `${JSON.stringify(cache, null, 2)}
 `, "utf8");
 }
 
 // src/emit/emit-forms.ts
 var import_promises5 = require("fs/promises");
-var import_node_path6 = require("path");
+var import_node_path7 = require("path");
 async function emitForms(routes, outDir, config, adapter) {
   if (config && config.enabled === false) return false;
   const content = buildFormsFileWithAdapter(routes, outDir, adapter, config);
   if (content === null) return false;
   await (0, import_promises5.mkdir)(outDir, { recursive: true });
-  await (0, import_promises5.writeFile)((0, import_node_path6.join)(outDir, "forms.ts"), content, "utf8");
+  await (0, import_promises5.writeFile)((0, import_node_path7.join)(outDir, "forms.ts"), content, "utf8");
   return true;
 }
 function pascal(segment) {
@@ -1274,7 +1287,7 @@ function deriveBaseName(routeName) {
   return { method, full };
 }
 function relImport(outDir, filePath) {
-  let relPath = (0, import_node_path6.relative)(outDir, filePath).replace(/\.ts$/, "");
+  let relPath = (0, import_node_path7.relative)(outDir, filePath).replace(/\.ts$/, "");
   if (!relPath.startsWith(".")) relPath = `./${relPath}`;
   return relPath;
 }
@@ -1548,7 +1561,7 @@ function buildFormsFileWithAdapter(routes, outDir, adapter, config) {
 
 // src/emit/emit-index.ts
 var import_promises6 = require("fs/promises");
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 async function emitIndex(outDir, hasContracts = false, hasForms = false) {
   await (0, import_promises6.mkdir)(outDir, { recursive: true });
   const exports2 = ["export * from './pages.js';", "export * from './routes.js';"];
@@ -1561,12 +1574,12 @@ async function emitIndex(outDir, hasContracts = false, hasForms = false) {
   const content = ["// Generated by @dudousxd/nestjs-codegen. Do not edit.", ...exports2, ""].join(
     "\n"
   );
-  await (0, import_promises6.writeFile)((0, import_node_path7.join)(outDir, "index.d.ts"), content, "utf8");
+  await (0, import_promises6.writeFile)((0, import_node_path8.join)(outDir, "index.d.ts"), content, "utf8");
 }
 
 // src/emit/emit-mocks.ts
 var import_promises7 = require("fs/promises");
-var import_node_path8 = require("path");
+var import_node_path9 = require("path");
 
 // src/ir/schema-node-to-json-schema.ts
 var DEFAULT_CTX = { refPrefix: "#/components/schemas/" };
@@ -1890,12 +1903,12 @@ async function emitMocks(routes, outDir, opts = {}) {
   await (0, import_promises7.mkdir)(outDir, { recursive: true });
   const content = buildMocksFile(routes, opts);
   const fileName = opts.fileName ?? "mocks.ts";
-  await (0, import_promises7.writeFile)((0, import_node_path8.join)(outDir, fileName), content, "utf8");
+  await (0, import_promises7.writeFile)((0, import_node_path9.join)(outDir, fileName), content, "utf8");
 }
 
 // src/emit/emit-openapi.ts
 var import_promises8 = require("fs/promises");
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 var REF_PREFIX2 = "#/components/schemas/";
 function toOpenApiPath(path) {
   return path.replace(/:([^/]+)/g, "{$1}");
@@ -2016,13 +2029,13 @@ async function emitOpenApi(routes, outDir, opts = {}) {
   await (0, import_promises8.mkdir)(outDir, { recursive: true });
   const doc = buildOpenApiSpec(routes, opts);
   const fileName = opts.fileName ?? "openapi.json";
-  await (0, import_promises8.writeFile)((0, import_node_path9.join)(outDir, fileName), `${JSON.stringify(doc, null, 2)}
+  await (0, import_promises8.writeFile)((0, import_node_path10.join)(outDir, fileName), `${JSON.stringify(doc, null, 2)}
 `, "utf8");
 }
 
 // src/emit/emit-pages.ts
 var import_promises9 = require("fs/promises");
-var import_node_path10 = require("path");
+var import_node_path11 = require("path");
 async function emitPages(pages, outDir, _options = {}) {
   await (0, import_promises9.mkdir)(outDir, { recursive: true });
   const pageNameUnion = pages.length > 0 ? pages.map((p) => JSON.stringify(p.name)).join(" | ") : "never";
@@ -2043,7 +2056,7 @@ ${augBody}
   }
 ${sharedPropsBlock}}
 `;
-  await (0, import_promises9.writeFile)((0, import_node_path10.join)(outDir, "pages.d.ts"), content, "utf8");
+  await (0, import_promises9.writeFile)((0, import_node_path11.join)(outDir, "pages.d.ts"), content, "utf8");
 }
 function buildSharedPropsBlock(sharedProps) {
   if (!sharedProps) return "";
@@ -2062,7 +2075,7 @@ ${propsBody}
 `;
 }
 function buildAugmentationType(page, outDir) {
-  let importPath = (0, import_node_path10.relative)(outDir, page.absolutePath).replace(/\.(tsx?|vue|svelte)$/, "");
+  let importPath = (0, import_node_path11.relative)(outDir, page.absolutePath).replace(/\.(tsx?|vue|svelte)$/, "");
   if (!importPath.startsWith(".")) {
     importPath = `./${importPath}`;
   }
@@ -2074,11 +2087,11 @@ function needsQuotes(name) {
 
 // src/emit/emit-routes.ts
 var import_promises10 = require("fs/promises");
-var import_node_path11 = require("path");
+var import_node_path12 = require("path");
 async function emitRoutes(routes, outDir) {
   await (0, import_promises10.mkdir)(outDir, { recursive: true });
   const content = buildRoutesFile(routes);
-  await (0, import_promises10.writeFile)((0, import_node_path11.join)(outDir, "routes.ts"), content, "utf8");
+  await (0, import_promises10.writeFile)((0, import_node_path12.join)(outDir, "routes.ts"), content, "utf8");
 }
 function buildRoutesFile(routes) {
   if (routes.length === 0) {
@@ -2193,7 +2206,7 @@ function buildEmpty() {
 // src/generate-manifest.ts
 var import_node_crypto = require("crypto");
 var import_promises11 = require("fs/promises");
-var import_node_path12 = require("path");
+var import_node_path13 = require("path");
 var import_fast_glob2 = __toESM(require("fast-glob"), 1);
 var MANIFEST_FILE = ".codegen-manifest.json";
 var LOCK_FILE = ".watcher.lock";
@@ -2216,6 +2229,9 @@ function isManifestShape(value) {
   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");
 }
@@ -2255,26 +2271,35 @@ async function discoverInputFiles(config) {
   const matched = await (0, import_fast_glob2.default)(globs, { cwd, absolute: true, onlyFiles: true });
   return [...new Set(matched)].sort();
 }
-async function computeInputsHash(config) {
+async function computeInputsHash(config, extraInputs = []) {
   const hash = (0, import_node_crypto.createHash)("sha256");
   hash.update(`version:${VERSION}
 `);
   hash.update(`config:${serializeConfig(config)}
 `);
-  const inputFiles = await discoverInputFiles(config);
   const cwd = config.codegen.cwd;
-  for (const file of inputFiles) {
+  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_path12.relative)(cwd, file)}
+    hash.update(`file:${(0, import_node_path13.relative)(cwd, file)}
 `);
     hash.update(contents);
     hash.update("\n");
   }
+  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 hash.digest("hex");
 }
 async function readManifest(outDir) {
   try {
-    const raw = await (0, import_promises11.readFile)((0, import_node_path12.join)(outDir, MANIFEST_FILE), "utf8");
+    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 {
@@ -2283,6 +2308,7 @@ async function readManifest(outDir) {
       ...parsed.entryPoint ? { entryPoint: parsed.entryPoint } : {},
       ...parsed.configHash ? { configHash: parsed.configHash } : {},
       ...parsed.configKeyHashes ? { configKeyHashes: parsed.configKeyHashes } : {},
+      ...parsed.extraInputs ? { extraInputs: parsed.extraInputs } : {},
       files: parsed.files
     };
   } catch {
@@ -2293,7 +2319,7 @@ 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_path12.join)(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
+  await (0, import_promises11.writeFile)((0, import_node_path13.join)(outDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
 }
 async function listOutputFiles(outDir) {
@@ -2301,11 +2327,11 @@ async function listOutputFiles(outDir) {
   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_path12.join)(dir, entry.name);
+      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_path12.relative)(outDir, abs);
+        const rel = (0, import_node_path13.relative)(outDir, abs);
         if (rel === MANIFEST_FILE || rel === LOCK_FILE) continue;
         found.push(rel);
       }
@@ -2342,8 +2368,8 @@ function driftGuardMessage(outDir, previousEntryPoint, currentEntryPoint, differ
 }
 async function generate(config, inputRoutes = [], entryPoint = "cli") {
   setCodegenDebug(config.debug);
-  const inputsHash = await computeInputsHash(config);
   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;
@@ -2364,7 +2390,8 @@ async function generate(config, inputRoutes = [], entryPoint = "cli") {
   }
   const extensions = config.extensions ?? [];
   let routes = inputRoutes;
-  const ctx = createExtensionContext(config, () => routes);
+  const trackedInputs = /* @__PURE__ */ new Set();
+  const ctx = createExtensionContext(config, () => routes, trackedInputs);
   if (extensions.length > 0) {
     routes = await applyTransformRoutes(routes, extensions, ctx);
   }
@@ -2418,29 +2445,32 @@ async function generate(config, inputRoutes = [], entryPoint = "cli") {
   if (extensions.length > 0) {
     const extraFiles = await collectEmittedFiles(extensions, ctx);
     for (const file of extraFiles) {
-      const dest = (0, import_node_path13.join)(config.codegen.outDir, file.path);
-      await (0, import_promises12.mkdir)((0, import_node_path13.dirname)(dest), { recursive: true });
+      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: inputsHash,
+    hash: recordedHash,
     entryPoint,
     configHash,
     configKeyHashes,
-    files: outputFiles
+    files: outputFiles,
+    ...extraInputs.length > 0 ? { extraInputs } : {}
   });
 }
 
 // src/watch/watcher.ts
 var import_promises15 = require("fs/promises");
-var import_node_path17 = require("path");
+var import_node_path18 = require("path");
 var import_chokidar = __toESM(require("chokidar"), 1);
 
 // src/discovery/contracts-fast.ts
-var import_node_path15 = require("path");
+var import_node_path16 = require("path");
 var import_fast_glob3 = __toESM(require("fast-glob"), 1);
 var import_ts_morph10 = require("ts-morph");
 
@@ -2452,7 +2482,7 @@ var import_ts_morph4 = require("ts-morph");
 
 // src/discovery/type-ref-resolution.ts
 var import_node_fs = require("fs");
-var import_node_path14 = require("path");
+var import_node_path15 = require("path");
 var import_ts_morph3 = require("ts-morph");
 var _EMPTY_CTX = { projectRoot: "", tsconfigPaths: null };
 var _ctxByProject = /* @__PURE__ */ new WeakMap();
@@ -2504,12 +2534,12 @@ function findTypeInFile(name, file) {
 }
 function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   if (moduleSpecifier.startsWith(".")) {
-    const dir = (0, import_node_path14.dirname)(sourceFile.getFilePath());
+    const dir = (0, import_node_path15.dirname)(sourceFile.getFilePath());
     const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
     return [
-      (0, import_node_path14.resolve)(dir, `${noExt}.ts`),
-      (0, import_node_path14.resolve)(dir, `${moduleSpecifier}.ts`),
-      (0, import_node_path14.resolve)(dir, moduleSpecifier, "index.ts")
+      (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);
@@ -2530,8 +2560,8 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
         const rest = moduleSpecifier.slice(prefix.length);
         const candidates = [];
         for (const mapping of mappings) {
-          const resolved = (0, import_node_path14.resolve)(baseUrl, mapping.replace("*", rest));
-          candidates.push(`${resolved}.ts`, (0, import_node_path14.resolve)(resolved, "index.ts"));
+          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;
@@ -4390,7 +4420,7 @@ async function discoverContractsFast(opts) {
   return extractAllRoutes(project);
 }
 function resolveTsconfigPath(cwd, tsconfig) {
-  return tsconfig ? (0, import_node_path15.resolve)(tsconfig) : (0, import_node_path15.join)(cwd, "tsconfig.json");
+  return tsconfig ? (0, import_node_path16.resolve)(tsconfig) : (0, import_node_path16.join)(cwd, "tsconfig.json");
 }
 function createDiscoveryProject(tsconfigPath) {
   try {
@@ -4476,7 +4506,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
   async rediscover(changedPaths) {
     if (changedPaths) {
       for (const p of changedPaths) {
-        const abs = (0, import_node_path15.resolve)(p);
+        const abs = (0, import_node_path16.resolve)(p);
         const sf = this.project.getSourceFile(abs);
         if (sf) {
           await sf.refreshFromFileSystem();
@@ -4794,7 +4824,7 @@ function extractFromSourceFile(sourceFile, project) {
 // src/watch/lock-file.ts
 var import_promises13 = require("fs/promises");
 var import_promises14 = require("fs/promises");
-var import_node_path16 = require("path");
+var import_node_path17 = require("path");
 var LOCK_FILE2 = ".watcher.lock";
 function isProcessAlive(pid) {
   try {
@@ -4806,7 +4836,7 @@ function isProcessAlive(pid) {
 }
 async function acquireLock(outDir) {
   await (0, import_promises14.mkdir)(outDir, { recursive: true });
-  const lockPath = (0, import_node_path16.join)(outDir, LOCK_FILE2);
+  const lockPath = (0, import_node_path17.join)(outDir, LOCK_FILE2);
   const lockData = { pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
   try {
     const fd = await (0, import_promises13.open)(lockPath, "wx");
@@ -4847,7 +4877,7 @@ async function watch(config, onChange, options = {}) {
   if (lock === null) {
     let holderPid = "unknown";
     try {
-      const raw = await (0, import_promises15.readFile)((0, import_node_path17.join)(config.codegen.outDir, ".watcher.lock"), "utf8");
+      const raw = await (0, import_promises15.readFile)((0, import_node_path18.join)(config.codegen.outDir, ".watcher.lock"), "utf8");
       const data = JSON.parse(raw);
       if (data.pid !== void 0) holderPid = String(data.pid);
     } catch {
@@ -4900,7 +4930,7 @@ async function watch(config, onChange, options = {}) {
   }
   let pagesDebounceTimer;
   const pagesGlob = config.pages?.glob ?? ".nestjs-codegen-no-pages";
-  const pagesWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, pagesGlob), {
+  const pagesWatcher = import_chokidar.default.watch((0, import_node_path18.join)(config.codegen.cwd, pagesGlob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4927,7 +4957,7 @@ async function watch(config, onChange, options = {}) {
   pagesWatcher.on("unlink", schedulePagesRegenerate);
   let contractsDebounceTimer;
   const pendingChangedPaths = /* @__PURE__ */ new Set();
-  const contractsWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, config.contracts.glob), {
+  const contractsWatcher = import_chokidar.default.watch((0, import_node_path18.join)(config.codegen.cwd, config.contracts.glob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4957,7 +4987,7 @@ async function watch(config, onChange, options = {}) {
   contractsWatcher.on("add", (p) => scheduleContractsRegenerate(p));
   contractsWatcher.on("change", (p) => scheduleContractsRegenerate(p));
   contractsWatcher.on("unlink", (p) => scheduleContractsRegenerate(p));
-  const formsWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, config.forms.watch), {
+  const formsWatcher = import_chokidar.default.watch((0, import_node_path18.join)(config.codegen.cwd, config.forms.watch), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4984,7 +5014,7 @@ async function watch(config, onChange, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "0.16.0";
+var VERSION = "0.17.0";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {
@@ -4992,9 +5022,9 @@ async function runCodegen(opts = {}) {
   const config = await loadConfig(cwd);
   if (opts.watch) {
     const watcher = await watch(config, void 0, { entryPoint: "cli" });
-    await new Promise((resolve4) => {
+    await new Promise((resolve5) => {
       function onSignal() {
-        watcher.close().then(resolve4).catch(resolve4);
+        watcher.close().then(resolve5).catch(resolve5);
       }
       process.once("SIGINT", onSignal);
       process.once("SIGTERM", onSignal);
@@ -5013,13 +5043,13 @@ async function runCodegen(opts = {}) {
 // src/cli/doctor.ts
 var import_node_child_process2 = require("child_process");
 var import_node_fs4 = require("fs");
-var import_node_path19 = require("path");
+var import_node_path20 = require("path");
 
 // src/cli/init.ts
 var import_node_child_process = require("child_process");
 var import_node_fs3 = require("fs");
 var import_promises16 = require("fs/promises");
-var import_node_path18 = require("path");
+var import_node_path19 = require("path");
 var import_node_readline = require("readline");
 
 // src/cli/patch-utils.ts
@@ -5081,7 +5111,7 @@ ${bold(title)}`);
 }
 async function readPackageJson(cwd) {
   try {
-    const raw = await (0, import_promises16.readFile)((0, import_node_path18.join)(cwd, "package.json"), "utf8");
+    const raw = await (0, import_promises16.readFile)((0, import_node_path19.join)(cwd, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -5112,7 +5142,7 @@ async function detectTemplateEngine(cwd) {
 async function detectPackageManager(cwd) {
   async function exists(file) {
     try {
-      await (0, import_promises16.access)((0, import_node_path18.join)(cwd, file));
+      await (0, import_promises16.access)((0, import_node_path19.join)(cwd, file));
       return true;
     } catch {
       return false;
@@ -5124,16 +5154,16 @@ async function detectPackageManager(cwd) {
 }
 async function promptFramework() {
   if (!process.stdin.isTTY) return "react";
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
     rl.question(
       "[nestjs-codegen] Which frontend framework? (react/vue/svelte) [react]: ",
       (answer) => {
         rl.close();
         const trimmed = answer.trim().toLowerCase();
-        if (trimmed === "vue") resolve4("vue");
-        else if (trimmed === "svelte") resolve4("svelte");
-        else resolve4("react");
+        if (trimmed === "vue") resolve5("vue");
+        else if (trimmed === "svelte") resolve5("svelte");
+        else resolve5("react");
       }
     );
   });
@@ -5159,7 +5189,7 @@ async function writeIfNotExists(filePath, content, label) {
   logCreated(label);
 }
 async function handleViteConfig(cwd, framework) {
-  const filePath = (0, import_node_path18.join)(cwd, "vite.config.ts");
+  const filePath = (0, import_node_path19.join)(cwd, "vite.config.ts");
   if (await fileExists2(filePath)) {
     const existing = await (0, import_promises16.readFile)(filePath, "utf8");
     const hasPlugin = existing.includes("nestInertia") || existing.includes("nestjs-inertia-vite/plugin");
@@ -5217,7 +5247,7 @@ function installDeps(pkgManager, deps, dev) {
   }
 }
 async function patchPackageJsonScripts(cwd, scripts) {
-  const pkgPath = (0, import_node_path18.join)(cwd, "package.json");
+  const pkgPath = (0, import_node_path19.join)(cwd, "package.json");
   let pkg = {};
   try {
     pkg = JSON.parse(await (0, import_promises16.readFile)(pkgPath, "utf8"));
@@ -5534,7 +5564,7 @@ export class HomeController {
 }
 `;
 function patchTsconfigExclude(cwd, dir, filename = "tsconfig.json") {
-  const filePath = (0, import_node_path18.join)(cwd, filename);
+  const filePath = (0, import_node_path19.join)(cwd, filename);
   return patchJsonFile(
     filePath,
     (json) => {
@@ -5549,7 +5579,7 @@ function patchTsconfigExclude(cwd, dir, filename = "tsconfig.json") {
   );
 }
 function patchNestCliJson(cwd, shellDir) {
-  const filePath = (0, import_node_path18.join)(cwd, "nest-cli.json");
+  const filePath = (0, import_node_path19.join)(cwd, "nest-cli.json");
   return patchJsonFile(filePath, (json) => {
     const compiler = json.compilerOptions ?? {};
     const assets = compiler.assets ?? [];
@@ -5572,46 +5602,46 @@ async function scaffoldFiles(ctx) {
   const { cwd, framework, engine, shellFileName, entryExt, pageExt } = ctx;
   logSection("Scaffold files");
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "nestjs-inertia.config.ts"),
+    (0, import_node_path19.join)(cwd, "nestjs-inertia.config.ts"),
     configTemplate(framework),
     "nestjs-inertia.config.ts"
   );
-  await writeIfNotExists((0, import_node_path18.join)(cwd, "nestjs-inertia.d.ts"), DTS_TEMPLATE, "nestjs-inertia.d.ts");
+  await writeIfNotExists((0, import_node_path19.join)(cwd, "nestjs-inertia.d.ts"), DTS_TEMPLATE, "nestjs-inertia.d.ts");
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "tsconfig.inertia.json"),
+    (0, import_node_path19.join)(cwd, "tsconfig.inertia.json"),
     TSCONFIG_INERTIA_TEMPLATE,
     "tsconfig.inertia.json"
   );
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "inertia", "tsconfig.json"),
+    (0, import_node_path19.join)(cwd, "inertia", "tsconfig.json"),
     INERTIA_TSCONFIG_TEMPLATE,
     "inertia/tsconfig.json"
   );
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "inertia", shellFileName),
+    (0, import_node_path19.join)(cwd, "inertia", shellFileName),
     htmlShellTemplate(framework, engine),
     `inertia/${shellFileName}`
   );
   await handleViteConfig(cwd, framework);
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "inertia", "app", `client.${entryExt}`),
+    (0, import_node_path19.join)(cwd, "inertia", "app", `client.${entryExt}`),
     entryPointTemplate(framework),
     `inertia/app/client.${entryExt}`
   );
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "inertia", "pages", `Home.${pageExt}`),
+    (0, import_node_path19.join)(cwd, "inertia", "pages", `Home.${pageExt}`),
     samplePageTemplate(framework),
     `inertia/pages/Home.${pageExt}`
   );
   await writeIfNotExists(
-    (0, import_node_path18.join)(cwd, "src", "home.controller.ts"),
+    (0, import_node_path19.join)(cwd, "src", "home.controller.ts"),
     SAMPLE_CONTROLLER,
     "src/home.controller.ts"
   );
 }
 function patchServerAppModule(ctx) {
   const { cwd, rootView } = ctx;
-  const appModulePath = (0, import_node_path18.join)(cwd, "src", "app.module.ts");
+  const appModulePath = (0, import_node_path19.join)(cwd, "src", "app.module.ts");
   const appModuleResult = patchAppModule(appModulePath, rootView);
   if (appModuleResult === "patched") {
     logPatched("src/app.module.ts", "added InertiaModule.forRoot");
@@ -5625,7 +5655,7 @@ function patchServerAppModule(ctx) {
   }
 }
 function patchServerMainTs(ctx) {
-  const mainTsPath = (0, import_node_path18.join)(ctx.cwd, "src", "main.ts");
+  const mainTsPath = (0, import_node_path19.join)(ctx.cwd, "src", "main.ts");
   const mainTsResult = patchMainTs(mainTsPath);
   if (mainTsResult === "patched") {
     logPatched("src/main.ts", "added setupInertiaVite after NestFactory.create");
@@ -5660,7 +5690,7 @@ function patchBuildConfigs(ctx) {
 }
 async function patchGitignoreAndDist(ctx) {
   const { cwd } = ctx;
-  await patchGitignore((0, import_node_path18.join)(cwd, ".gitignore"));
+  await patchGitignore((0, import_node_path19.join)(cwd, ".gitignore"));
   const tsconfigDistResult = patchTsconfigExclude(cwd, "dist", "tsconfig.json");
   if (tsconfigDistResult === "patched") {
     logPatched("tsconfig.json", "excluded dist/ from server compilation");
@@ -5766,7 +5796,7 @@ ${green("\u2713")} Setup complete! Run: ${bold("nest start --watch")}
 
 // src/cli/doctor.ts
 function checkFileExists(cwd, file) {
-  return (0, import_node_fs4.existsSync)((0, import_node_path19.join)(cwd, file));
+  return (0, import_node_fs4.existsSync)((0, import_node_path20.join)(cwd, file));
 }
 function readJson(path) {
   try {
@@ -5802,15 +5832,15 @@ function writeJsonField(filePath, dotPath, value) {
 }
 function getPackageVersion(cwd, pkg) {
   try {
-    const pkgJson = readJson((0, import_node_path19.join)(cwd, "node_modules", pkg, "package.json"));
+    const pkgJson = readJson((0, import_node_path20.join)(cwd, "node_modules", pkg, "package.json"));
     return pkgJson?.version ?? null;
   } catch {
     return null;
   }
 }
 function detectPkgManager(cwd) {
-  if ((0, import_node_fs4.existsSync)((0, import_node_path19.join)(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if ((0, import_node_fs4.existsSync)((0, import_node_path19.join)(cwd, "yarn.lock"))) return "yarn";
+  if ((0, import_node_fs4.existsSync)((0, import_node_path20.join)(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if ((0, import_node_fs4.existsSync)((0, import_node_path20.join)(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
 async function runDoctor(opts) {
@@ -5848,7 +5878,7 @@ async function runDoctor(opts) {
     autoFix: () => runInit({ cwd })
   });
   if (foundShellDir) {
-    const nestCliPath = (0, import_node_path19.join)(cwd, "nest-cli.json");
+    const nestCliPath = (0, import_node_path20.join)(cwd, "nest-cli.json");
     const nestCli = readJson(nestCliPath);
     const compiler = nestCli?.compilerOptions ?? {};
     const assets = compiler.assets ?? [];
@@ -5887,7 +5917,7 @@ async function runDoctor(opts) {
     fix: "Run: nestjs-codegen codegen",
     autoFix: () => runCodegen({ cwd })
   });
-  const tsconfigPath = (0, import_node_path19.join)(cwd, "tsconfig.json");
+  const tsconfigPath = (0, import_node_path20.join)(cwd, "tsconfig.json");
   const tsconfig = readJson(tsconfigPath);
   const paths = tsconfig?.compilerOptions?.paths;
   checks.push({
@@ -5898,7 +5928,7 @@ async function runDoctor(opts) {
   });
   const inertiaDir = foundShellDir ?? "inertia";
   for (const tsconfigFile of ["tsconfig.json", "tsconfig.build.json"]) {
-    const tsc = readJson((0, import_node_path19.join)(cwd, tsconfigFile));
+    const tsc = readJson((0, import_node_path20.join)(cwd, tsconfigFile));
     if (!tsc) continue;
     const excl = tsc.exclude ?? [];
     const excludesIt = excl.includes(inertiaDir);
@@ -5924,7 +5954,7 @@ async function runDoctor(opts) {
       }
     });
   }
-  const inertiaTsconfigPath = (0, import_node_path19.join)(cwd, "tsconfig.inertia.json");
+  const inertiaTsconfigPath = (0, import_node_path20.join)(cwd, "tsconfig.inertia.json");
   const inertiaTsconfig = readJson(inertiaTsconfigPath);
   checks.push({
     name: "tsconfig.inertia.json exists",
@@ -5976,7 +6006,7 @@ async function runDoctor(opts) {
       fix: 'Add "nestjs-inertia.d.ts" to include array (resolves InertiaRegistry augmentation)'
     });
   }
-  const innerTsconfigPath = (0, import_node_path19.join)(cwd, "inertia", "tsconfig.json");
+  const innerTsconfigPath = (0, import_node_path20.join)(cwd, "inertia", "tsconfig.json");
   checks.push({
     name: "inertia/tsconfig.json exists (VSCode picks up ~codegen alias)",
     pass: (0, import_node_fs4.existsSync)(innerTsconfigPath),
@@ -5986,7 +6016,7 @@ async function runDoctor(opts) {
     }
   });
   if (checkFileExists(cwd, "vite.config.ts")) {
-    const viteContent = (0, import_node_fs4.readFileSync)((0, import_node_path19.join)(cwd, "vite.config.ts"), "utf8");
+    const viteContent = (0, import_node_fs4.readFileSync)((0, import_node_path20.join)(cwd, "vite.config.ts"), "utf8");
     checks.push({
       name: "vite.config.ts has resolve.alias",
       pass: viteContent.includes("resolve") && viteContent.includes("alias"),
@@ -6051,7 +6081,7 @@ async function runDoctor(opts) {
     });
   }
   if (checkFileExists(cwd, ".gitignore")) {
-    const gitignorePath = (0, import_node_path19.join)(cwd, ".gitignore");
+    const gitignorePath = (0, import_node_path20.join)(cwd, ".gitignore");
     const gitignore = (0, import_node_fs4.readFileSync)(gitignorePath, "utf8");
     checks.push({
       name: ".gitignore includes .nestjs-inertia/",
@@ -6060,7 +6090,7 @@ async function runDoctor(opts) {
       autoFix: () => (0, import_node_fs4.appendFileSync)(gitignorePath, "\n.nestjs-inertia/\n")
     });
   }
-  const pkgJsonPath = (0, import_node_path19.join)(cwd, "package.json");
+  const pkgJsonPath = (0, import_node_path20.join)(cwd, "package.json");
   const pkgJson = readJson(pkgJsonPath);
   const scripts = pkgJson?.scripts ?? {};
   checks.push({