@dudousxd/nestjs-codegen 0.27.2 → 0.28.0

package/dist/index.cjs

@@ -32,6 +32,7 @@ var src_exports = {};
 __export(src_exports, {
   CodegenError: () => CodegenError,
   ConfigError: () => ConfigError,
+  DEFAULT_SANDBOX_KIT_OUTPUT: () => DEFAULT_SANDBOX_KIT_OUTPUT,
   DriftGuardError: () => DriftGuardError,
   VERSION: () => VERSION,
   acquireLock: () => acquireLock,
@@ -47,6 +48,7 @@ __export(src_exports, {
   emitRoutes: () => emitRoutes,
   extractSchemaFromDto: () => extractSchemaFromDto,
   generate: () => generate,
+  genuiSandboxKit: () => genuiSandboxKit,
   loadConfig: () => loadConfig,
   renderTsType: () => renderTsType,
   resolveAdapter: () => resolveAdapter,
@@ -5698,14 +5700,26 @@ async function computeInputsHash(config, extraInputs = []) {
     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(await readTrackedInput((0, import_node_path15.join)(cwd, file)));
     hash.update("\n");
   }
   return hash.digest("hex");
 }
+async function readTrackedInput(path) {
+  try {
+    return await (0, import_promises11.readFile)(path, "utf8");
+  } catch (err) {
+    if (err.code !== "EISDIR") return "\0missing";
+  }
+  try {
+    const entries = await (0, import_promises11.readdir)(path);
+    return `\0dir:${entries.sort().join("\n")}`;
+  } catch {
+    return "\0missing";
+  }
+}
 async function readManifest(outDir) {
   try {
     const raw = await (0, import_promises11.readFile)((0, import_node_path15.join)(outDir, MANIFEST_FILE), "utf8");
@@ -5943,11 +5957,36 @@ async function watch(config, onChange, options = {}) {
     }
     return discovery;
   }
+  const trackedWatcher = import_chokidar.default.watch([], {
+    ignoreInitial: true,
+    persistent: true,
+    awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
+  });
+  const trackedPaths = /* @__PURE__ */ new Set();
+  async function syncTrackedInputs() {
+    const manifest = await readManifest(config.codegen.outDir);
+    const fresh = [];
+    for (const path of manifest?.extraInputs ?? []) {
+      const abs = (0, import_node_path18.resolve)(config.codegen.cwd, path);
+      if (trackedPaths.has(abs)) continue;
+      trackedPaths.add(abs);
+      fresh.push(abs);
+    }
+    if (fresh.length > 0) trackedWatcher.add(fresh);
+  }
+  async function generateAndTrack(routes) {
+    try {
+      await generate(config, routes, entryPoint);
+    } finally {
+      await syncTrackedInputs().catch(() => {
+      });
+    }
+  }
   async function runInitialPass() {
     try {
       const initialRoutes = (await getDiscovery()).discover();
       lastRoutes = initialRoutes;
-      await generate(config, initialRoutes, entryPoint);
+      await generateAndTrack(initialRoutes);
     } catch (err) {
       if (err instanceof DriftGuardError) {
         console.error(err.message);
@@ -5957,7 +5996,7 @@ async function watch(config, onChange, options = {}) {
         `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
       );
       try {
-        await generate(config, lastRoutes, entryPoint);
+        await generateAndTrack(lastRoutes);
       } catch {
       }
     }
@@ -5990,7 +6029,7 @@ async function watch(config, onChange, options = {}) {
     pagesDebounceTimer = setTimeout(async () => {
       pagesDebounceTimer = void 0;
       try {
-        await generate(config, lastRoutes, entryPoint);
+        await generateAndTrack(lastRoutes);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Pages generation failed:",
@@ -6022,7 +6061,7 @@ async function watch(config, onChange, options = {}) {
       try {
         const routes = await (await getDiscovery()).rediscover(changed);
         lastRoutes = routes;
-        await generate(config, routes, entryPoint);
+        await generateAndTrack(routes);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Contracts generation failed:",
@@ -6043,6 +6082,9 @@ async function watch(config, onChange, options = {}) {
   formsWatcher.on("add", (p) => scheduleContractsRegenerate(p));
   formsWatcher.on("change", (p) => scheduleContractsRegenerate(p));
   formsWatcher.on("unlink", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("add", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("change", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("unlink", (p) => scheduleContractsRegenerate(p));
   return {
     close: async () => {
       if (pagesDebounceTimer !== void 0) {
@@ -6056,6 +6098,7 @@ async function watch(config, onChange, options = {}) {
       await pagesWatcher.close();
       await contractsWatcher.close();
       await formsWatcher.close();
+      await trackedWatcher.close();
       await lock.release();
     }
   };
@@ -6144,12 +6187,114 @@ function createChainModuleRenderer(opts) {
   };
 }
 
+// src/extension/genui-sandbox-kit.ts
+var import_node_fs2 = require("fs");
+var import_node_path19 = require("path");
+var import_fast_glob4 = __toESM(require("fast-glob"), 1);
+var GENUI_KIT_MODULE = "@dudousxd/nestjs-agent-core/genui/kit";
+var DEFAULT_SANDBOX_KIT_OUTPUT = ".genui/sandbox-kit.json";
+var DEFAULT_KIT_DIRS = [
+  "inertia/components/ui",
+  "resources/js/components/ui",
+  "src/components/ui",
+  "app/components/ui",
+  "components/ui"
+];
+async function loadKitModule(specifier = GENUI_KIT_MODULE) {
+  let mod;
+  try {
+    mod = await import(specifier);
+  } catch (err) {
+    const code = err.code;
+    if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
+      throw new CodegenError(
+        `genuiSandboxKit() needs "${GENUI_KIT_MODULE}" \u2014 install @dudousxd/nestjs-agent-core@>=0.52.0, or pass \`generate\` to genuiSandboxKit().`
+      );
+    }
+    if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
+      throw new CodegenError(
+        `genuiSandboxKit() needs "${GENUI_KIT_MODULE}", which the installed @dudousxd/nestjs-agent-core does not export \u2014 upgrade it to >=0.52.0.`
+      );
+    }
+    throw err;
+  }
+  if (typeof mod.writeSandboxKitDocs !== "function") {
+    throw new CodegenError(
+      `"${GENUI_KIT_MODULE}" has no writeSandboxKitDocs export \u2014 upgrade @dudousxd/nestjs-agent-core to >=0.52.0.`
+    );
+  }
+  return mod;
+}
+function globBase(glob) {
+  const base = [];
+  for (const part of glob.replace(/\\/g, "/").split("/")) {
+    if (/[*?{[]/.test(part)) break;
+    base.push(part);
+  }
+  return base.join("/");
+}
+function resolveKitFilesLocally(root, options) {
+  if (options.entry !== void 0) {
+    const entry = (0, import_node_path19.isAbsolute)(options.entry) ? options.entry : (0, import_node_path19.resolve)(root, options.entry);
+    return { entry, files: [entry], dirs: [(0, import_node_path19.dirname)(entry)] };
+  }
+  const include = options.include ?? DEFAULT_KIT_DIRS.filter((dir) => (0, import_node_fs2.existsSync)((0, import_node_path19.resolve)(root, dir))).map(
+    (dir) => `${dir}/*.{tsx,jsx,ts,js}`
+  )[0];
+  if (include === void 0) return null;
+  const globs = typeof include === "string" ? [include] : [...include];
+  const files = import_fast_glob4.default.sync(globs, { cwd: root, absolute: true, onlyFiles: true }).sort();
+  return { files, dirs: [...new Set(globs.map((glob) => (0, import_node_path19.resolve)(root, globBase(glob))))] };
+}
+function genuiSandboxKit(options = {}) {
+  const output = options.output ?? DEFAULT_SANDBOX_KIT_OUTPUT;
+  const source = {
+    ...options.entry !== void 0 ? { entry: options.entry } : {},
+    ...options.include !== void 0 ? { include: options.include } : {}
+  };
+  const extension = {
+    name: "genui-sandbox-kit",
+    // Not read by the host: serialized into the config hash, so changing an option
+    // invalidates skip-when-unchanged.
+    options: { ...source, css: options.css, tsconfig: options.tsconfig, output },
+    async emitFiles(ctx) {
+      const root = ctx.cwd;
+      let generate2 = options.generate;
+      let resolveFiles = resolveKitFilesLocally;
+      if (!generate2) {
+        const mod = await loadKitModule(options.kitModule);
+        generate2 = mod.writeSandboxKitDocs;
+        if (typeof mod.resolveSandboxKitFiles === "function") {
+          resolveFiles = mod.resolveSandboxKitFiles;
+        }
+      }
+      const kit = resolveFiles(root, source);
+      if (kit) ctx.trackInput(...kit.files, ...kit.dirs);
+      if (options.css !== void 0) {
+        const css = typeof options.css === "string" ? [options.css] : [...options.css];
+        ctx.trackInput(...import_fast_glob4.default.sync(css, { cwd: root, absolute: true, onlyFiles: true }));
+      }
+      ctx.trackInput((0, import_node_path19.isAbsolute)(output) ? output : (0, import_node_path19.resolve)(root, output));
+      await generate2({
+        root,
+        output,
+        ...source,
+        ...options.css !== void 0 ? { css: options.css } : {},
+        ...options.tsconfig !== void 0 ? { tsconfig: options.tsconfig } : {}
+      });
+      return [];
+    }
+  };
+  return extension;
+}
+
 // src/index.ts
-var VERSION = "0.27.2";
+var VERSION = "0.28.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodegenError,
   ConfigError,
+  DEFAULT_SANDBOX_KIT_OUTPUT,
   DriftGuardError,
   VERSION,
   acquireLock,
@@ -6165,6 +6310,7 @@ var VERSION = "0.27.2";
   emitRoutes,
   extractSchemaFromDto,
   generate,
+  genuiSandboxKit,
   loadConfig,
   renderTsType,
   resolveAdapter,