@dudousxd/nestjs-codegen 0.10.0 → 0.12.0

package/dist/index.cjs

@@ -248,8 +248,8 @@ Run \`nestjs-codegen init\` to create a starter config.`
 }
 
 // src/generate.ts
-var import_promises11 = require("fs/promises");
-var import_node_path12 = require("path");
+var import_promises12 = require("fs/promises");
+var import_node_path13 = require("path");
 
 // src/discovery/pages.ts
 var import_promises2 = require("fs/promises");
@@ -863,7 +863,11 @@ function buildRequestModel(c) {
     urlExpr,
     optsExpr,
     responseType: `${TA}['response']`,
-    queryKeyExpr: `[${flat}, input] as const`
+    // When no input is supplied the key omits the trailing element entirely
+    // (`[name]` rather than `[name, undefined]`) so the bare `.queryKey()` is a
+    // clean prefix that partial-matches every parametrized variant — making it
+    // directly usable for `invalidateQueries`.
+    queryKeyExpr: `(input === undefined ? [${flat}] as const : [${flat}, input] as const)`
   };
 }
 function renderFetcherRequest(req) {
@@ -2143,6 +2147,99 @@ function buildEmpty() {
   ].join("\n");
 }
 
+// src/generate-manifest.ts
+var import_node_crypto = require("crypto");
+var import_promises11 = require("fs/promises");
+var import_node_path12 = require("path");
+var import_fast_glob2 = __toESM(require("fast-glob"), 1);
+var MANIFEST_FILE = ".codegen-manifest.json";
+var LOCK_FILE = ".watcher.lock";
+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 (!Array.isArray(candidate.files)) return false;
+  return candidate.files.every((entry) => typeof entry === "string");
+}
+function serializeConfig(config) {
+  try {
+    return JSON.stringify(config, (_key, value) => {
+      if (typeof value === "function") return `[fn:${value.name}]${value.toString()}`;
+      return value;
+    });
+  } catch {
+    return `unserializable:${config.codegen.outDir}:${config.contracts.glob}`;
+  }
+}
+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) {
+  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 contents = await (0, import_promises11.readFile)(file, "utf8");
+    hash.update(`file:${(0, import_node_path12.relative)(cwd, file)}
+`);
+    hash.update(contents);
+    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 parsed = JSON.parse(raw);
+    if (!isManifestShape(parsed)) return null;
+    return { version: parsed.version, hash: parsed.hash, files: parsed.files };
+  } catch {
+    return null;
+  }
+}
+async function writeManifest(outDir, manifest) {
+  await (0, import_promises11.writeFile)((0, import_node_path12.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_path12.join)(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(abs);
+      } else if (entry.isFile()) {
+        const rel = (0, import_node_path12.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/util/debug-log.ts
 var debugEnabled = false;
 function setCodegenDebug(enabled) {
@@ -2155,6 +2252,12 @@ function debugWarn(message) {
 // src/generate.ts
 async function generate(config, inputRoutes = []) {
   setCodegenDebug(config.debug);
+  const inputsHash = await computeInputsHash(config);
+  const manifest = await readManifest(config.codegen.outDir);
+  if (await isManifestFresh(config.codegen.outDir, manifest, inputsHash)) {
+    console.log(`[nestjs-codegen] ${config.codegen.outDir} up to date, skipped`);
+    return;
+  }
   const extensions = config.extensions ?? [];
   let routes = inputRoutes;
   const ctx = createExtensionContext(config, () => routes);
@@ -2211,21 +2314,27 @@ async function generate(config, inputRoutes = []) {
   if (extensions.length > 0) {
     const extraFiles = await collectEmittedFiles(extensions, ctx);
     for (const file of extraFiles) {
-      const dest = (0, import_node_path12.join)(config.codegen.outDir, file.path);
-      await (0, import_promises11.mkdir)((0, import_node_path12.dirname)(dest), { recursive: true });
-      await (0, import_promises11.writeFile)(dest, file.contents, "utf8");
+      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 });
+      await (0, import_promises12.writeFile)(dest, file.contents, "utf8");
     }
   }
+  const outputFiles = await listOutputFiles(config.codegen.outDir);
+  await writeManifest(config.codegen.outDir, {
+    version: VERSION,
+    hash: inputsHash,
+    files: outputFiles
+  });
 }
 
 // src/watch/watcher.ts
-var import_promises14 = require("fs/promises");
-var import_node_path16 = require("path");
+var import_promises15 = require("fs/promises");
+var import_node_path17 = require("path");
 var import_chokidar = __toESM(require("chokidar"), 1);
 
 // src/discovery/contracts-fast.ts
-var import_node_path14 = require("path");
-var import_fast_glob2 = __toESM(require("fast-glob"), 1);
+var import_node_path15 = require("path");
+var import_fast_glob3 = __toESM(require("fast-glob"), 1);
 var import_ts_morph9 = require("ts-morph");
 
 // src/discovery/dto-type-resolver.ts
@@ -2236,7 +2345,7 @@ var import_ts_morph4 = require("ts-morph");
 
 // src/discovery/type-ref-resolution.ts
 var import_node_fs = require("fs");
-var import_node_path13 = require("path");
+var import_node_path14 = require("path");
 var import_ts_morph3 = require("ts-morph");
 var _EMPTY_CTX = { projectRoot: "", tsconfigPaths: null };
 var _ctxByProject = /* @__PURE__ */ new WeakMap();
@@ -2288,12 +2397,12 @@ function findTypeInFile(name, file) {
 }
 function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   if (moduleSpecifier.startsWith(".")) {
-    const dir = (0, import_node_path13.dirname)(sourceFile.getFilePath());
+    const dir = (0, import_node_path14.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")
+      (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")
     ];
   }
   const ctx = _ctxFor(project);
@@ -2314,8 +2423,8 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
         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"));
+          const resolved = (0, import_node_path14.resolve)(baseUrl, mapping.replace("*", rest));
+          candidates.push(`${resolved}.ts`, (0, import_node_path14.resolve)(resolved, "index.ts"));
         }
         dbg("  resolved candidates:", candidates);
         return candidates;
@@ -3987,7 +4096,7 @@ async function discoverContractsFast(opts) {
   const { cwd, glob, tsconfig } = opts;
   const tsconfigPath = resolveTsconfigPath(cwd, tsconfig);
   const project = createDiscoveryProject(tsconfigPath);
-  const files = await (0, import_fast_glob2.default)(glob, { cwd, absolute: true, onlyFiles: true });
+  const files = await (0, import_fast_glob3.default)(glob, { cwd, absolute: true, onlyFiles: true });
   for (const f of files) {
     project.addSourceFileAtPath(f);
   }
@@ -3995,7 +4104,7 @@ async function discoverContractsFast(opts) {
   return extractAllRoutes(project);
 }
 function resolveTsconfigPath(cwd, tsconfig) {
-  return tsconfig ? (0, import_node_path14.resolve)(tsconfig) : (0, import_node_path14.join)(cwd, "tsconfig.json");
+  return tsconfig ? (0, import_node_path15.resolve)(tsconfig) : (0, import_node_path15.join)(cwd, "tsconfig.json");
 }
 function createDiscoveryProject(tsconfigPath) {
   try {
@@ -4060,7 +4169,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
     const project = createDiscoveryProject(tsconfigPath);
     bindDiscoveryContext(project, cwd, tsconfigPath);
     const instance = new _PersistentDiscovery(project, cwd, glob);
-    const files = await (0, import_fast_glob2.default)(glob, { cwd, absolute: true, onlyFiles: true });
+    const files = await (0, import_fast_glob3.default)(glob, { cwd, absolute: true, onlyFiles: true });
     for (const f of files) {
       project.addSourceFileAtPath(f);
       instance.controllerPaths.add(f);
@@ -4081,7 +4190,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
   async rediscover(changedPaths) {
     if (changedPaths) {
       for (const p of changedPaths) {
-        const abs = (0, import_node_path14.resolve)(p);
+        const abs = (0, import_node_path15.resolve)(p);
         const sf = this.project.getSourceFile(abs);
         if (sf) {
           await sf.refreshFromFileSystem();
@@ -4089,7 +4198,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
       }
     }
     const globbed = new Set(
-      await (0, import_fast_glob2.default)(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
+      await (0, import_fast_glob3.default)(this.glob, { cwd: this.cwd, absolute: true, onlyFiles: true })
     );
     for (const f of globbed) {
       if (!this.controllerPaths.has(f)) {
@@ -4369,10 +4478,10 @@ function extractFromSourceFile(sourceFile, project) {
 }
 
 // src/watch/lock-file.ts
-var import_promises12 = require("fs/promises");
 var import_promises13 = require("fs/promises");
-var import_node_path15 = require("path");
-var LOCK_FILE = ".watcher.lock";
+var import_promises14 = require("fs/promises");
+var import_node_path16 = require("path");
+var LOCK_FILE2 = ".watcher.lock";
 function isProcessAlive(pid) {
   try {
     process.kill(pid, 0);
@@ -4382,21 +4491,21 @@ function isProcessAlive(pid) {
   }
 }
 async function acquireLock(outDir) {
-  await (0, import_promises13.mkdir)(outDir, { recursive: true });
-  const lockPath = (0, import_node_path15.join)(outDir, LOCK_FILE);
+  await (0, import_promises14.mkdir)(outDir, { recursive: true });
+  const lockPath = (0, import_node_path16.join)(outDir, LOCK_FILE2);
   const lockData = { pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() };
   try {
-    const fd = await (0, import_promises12.open)(lockPath, "wx");
+    const fd = await (0, import_promises13.open)(lockPath, "wx");
     await fd.writeFile(`${JSON.stringify(lockData, null, 2)}
 `, "utf8");
     await fd.close();
   } catch (err) {
     if (err.code === "EEXIST") {
       try {
-        const raw = await (0, import_promises13.readFile)(lockPath, "utf8");
+        const raw = await (0, import_promises14.readFile)(lockPath, "utf8");
         const existing = JSON.parse(raw);
         if (isProcessAlive(existing.pid)) return null;
-        await (0, import_promises13.unlink)(lockPath);
+        await (0, import_promises14.unlink)(lockPath);
         return acquireLock(outDir);
       } catch {
         return null;
@@ -4407,7 +4516,7 @@ async function acquireLock(outDir) {
   return {
     release: async () => {
       try {
-        await (0, import_promises13.unlink)(lockPath);
+        await (0, import_promises14.unlink)(lockPath);
       } catch {
       }
     }
@@ -4418,12 +4527,12 @@ async function acquireLock(outDir) {
 var PAGES_DEBOUNCE_MS = 150;
 var NO_OP_WATCHER = { close: async () => {
 } };
-async function watch(config, onChange) {
+async function watch(config, onChange, options = {}) {
   const lock = await acquireLock(config.codegen.outDir);
   if (lock === null) {
     let holderPid = "unknown";
     try {
-      const raw = await (0, import_promises14.readFile)((0, import_node_path16.join)(config.codegen.outDir, ".watcher.lock"), "utf8");
+      const raw = await (0, import_promises15.readFile)((0, import_node_path17.join)(config.codegen.outDir, ".watcher.lock"), "utf8");
       const data = JSON.parse(raw);
       if (data.pid !== void 0) holderPid = String(data.pid);
     } catch {
@@ -4446,22 +4555,33 @@ async function watch(config, onChange) {
     }
     return discovery;
   }
-  try {
-    const initialRoutes = (await getDiscovery()).discover();
-    lastRoutes = initialRoutes;
-    await generate(config, initialRoutes);
-  } catch (err) {
-    console.warn(
-      `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
-    );
+  async function runInitialPass() {
     try {
-      await generate(config, lastRoutes);
-    } catch {
+      const initialRoutes = (await getDiscovery()).discover();
+      lastRoutes = initialRoutes;
+      await generate(config, initialRoutes);
+    } catch (err) {
+      console.warn(
+        `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
+      );
+      try {
+        await generate(config, lastRoutes);
+      } catch {
+      }
     }
   }
+  if (options.deferInitialGenerate) {
+    void runInitialPass().catch((err) => {
+      console.warn(
+        `[nestjs-codegen] Background initial generate failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    });
+  } else {
+    await runInitialPass();
+  }
   let pagesDebounceTimer;
   const pagesGlob = config.pages?.glob ?? ".nestjs-codegen-no-pages";
-  const pagesWatcher = import_chokidar.default.watch((0, import_node_path16.join)(config.codegen.cwd, pagesGlob), {
+  const pagesWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, pagesGlob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4488,7 +4608,7 @@ async function watch(config, onChange) {
   pagesWatcher.on("unlink", schedulePagesRegenerate);
   let contractsDebounceTimer;
   const pendingChangedPaths = /* @__PURE__ */ new Set();
-  const contractsWatcher = import_chokidar.default.watch((0, import_node_path16.join)(config.codegen.cwd, config.contracts.glob), {
+  const contractsWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, config.contracts.glob), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4518,7 +4638,7 @@ async function watch(config, onChange) {
   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_path16.join)(config.codegen.cwd, config.forms.watch), {
+  const formsWatcher = import_chokidar.default.watch((0, import_node_path17.join)(config.codegen.cwd, config.forms.watch), {
     ignoreInitial: true,
     persistent: true,
     awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
@@ -4628,7 +4748,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.10.0";
+var VERSION = "0.12.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,