@dudousxd/nestjs-codegen 0.27.2 → 0.29.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,165 @@ 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"
+];
+var LEGACY_OPTIONS = {
+  entry: "`entry: X` is now `components: X`",
+  include: "`include: G` is now `components: G` (globs, files, directories or packages)",
+  css: "`css: G` is now `styles: G` (the app's style entry files)"
+};
+var MIN_CORE = "0.53.0";
+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@>=${MIN_CORE}, 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 >=${MIN_CORE}.`
+      );
+    }
+    throw err;
+  }
+  if (typeof mod.writeSandboxKitDocs !== "function") {
+    throw new CodegenError(
+      `"${GENUI_KIT_MODULE}" has no writeSandboxKitDocs export \u2014 upgrade @dudousxd/nestjs-agent-core to >=${MIN_CORE}.`
+    );
+  }
+  if (typeof mod.resolveStyleEntries !== "function") {
+    throw new CodegenError(
+      `The installed @dudousxd/nestjs-agent-core predates genuiSandboxKit({ components, styles, wrapper }) \u2014 upgrade it to >=${MIN_CORE}.`
+    );
+  }
+  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) {
+  const specs = options.components === void 0 ? DEFAULT_KIT_DIRS.filter((dir) => (0, import_node_fs2.existsSync)((0, import_node_path19.resolve)(root, dir))).slice(0, 1) : typeof options.components === "string" ? [options.components] : [...options.components];
+  const files = [];
+  const dirs = /* @__PURE__ */ new Set();
+  for (const spec of specs) {
+    if (/[*?{]/.test(spec)) {
+      files.push(...import_fast_glob4.default.sync(spec, { cwd: root, absolute: true, onlyFiles: true }));
+      dirs.add((0, import_node_path19.resolve)(root, globBase(spec)));
+      continue;
+    }
+    const path = (0, import_node_path19.isAbsolute)(spec) ? spec : (0, import_node_path19.resolve)(root, spec);
+    if ((0, import_node_fs2.existsSync)(path) && (0, import_node_fs2.statSync)(path).isDirectory()) {
+      files.push(...import_fast_glob4.default.sync("*.{tsx,jsx,ts,js}", { cwd: path, absolute: true, onlyFiles: true }));
+      dirs.add(path);
+    } else if ((0, import_node_fs2.existsSync)(path)) {
+      files.push(path);
+      dirs.add((0, import_node_path19.dirname)(path));
+    }
+  }
+  if (options.wrapper !== void 0) {
+    const wrapper = (0, import_node_path19.isAbsolute)(options.wrapper) ? options.wrapper : (0, import_node_path19.resolve)(root, options.wrapper);
+    if ((0, import_node_fs2.existsSync)(wrapper)) files.push(wrapper);
+  }
+  if (files.length === 0 && dirs.size === 0) return null;
+  return { files: [...new Set(files)].sort(), dirs: [...dirs] };
+}
+function genuiSandboxKit(options = {}) {
+  const legacy = Object.keys(LEGACY_OPTIONS).filter(
+    (key) => options[key] !== void 0
+  );
+  if (legacy.length > 0) {
+    throw new CodegenError(
+      `genuiSandboxKit(): ${legacy.map((key) => `\`${key}\``).join(", ")} ${legacy.length > 1 ? "were" : "was"} removed \u2014 ${legacy.map((key) => LEGACY_OPTIONS[key]).join("; ")}. The options are now the agent's Vite plugin's: components, styles, wrapper, stylesDocs.`
+    );
+  }
+  const output = options.output ?? DEFAULT_SANDBOX_KIT_OUTPUT;
+  const source = {
+    ...options.components !== void 0 ? { components: options.components } : {},
+    ...options.wrapper !== void 0 ? { wrapper: options.wrapper } : {}
+  };
+  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,
+      styles: options.styles,
+      stylesDocs: options.stylesDocs,
+      tsconfig: options.tsconfig,
+      output
+    },
+    async emitFiles(ctx) {
+      const root = ctx.cwd;
+      let generate2 = options.generate;
+      let mod;
+      if (!generate2) {
+        mod = await loadKitModule(options.kitModule);
+        generate2 = mod.writeSandboxKitDocs;
+      }
+      const resolveFiles = mod?.resolveSandboxKitFiles ?? resolveKitFilesLocally;
+      let kit = null;
+      try {
+        kit = resolveFiles(root, source);
+      } catch {
+        kit = null;
+      }
+      if (kit) ctx.trackInput(...kit.files, ...kit.dirs);
+      if (options.styles !== void 0) {
+        const entries = mod?.resolveStyleEntries ? mod.resolveStyleEntries(root, options.styles).files : import_fast_glob4.default.sync(typeof options.styles === "string" ? [options.styles] : [...options.styles], {
+          cwd: root,
+          absolute: true,
+          onlyFiles: true
+        });
+        const files = mod?.collectStyleSources ? mod.collectStyleSources(entries).map((source2) => source2.file) : entries;
+        ctx.trackInput(.../* @__PURE__ */ new Set([...entries, ...files]));
+      }
+      if (options.stylesDocs !== void 0 && !options.stylesDocs.includes("\n")) {
+        const guide = (0, import_node_path19.isAbsolute)(options.stylesDocs) ? options.stylesDocs : (0, import_node_path19.resolve)(root, options.stylesDocs);
+        if ((0, import_node_fs2.existsSync)(guide)) ctx.trackInput(guide);
+      }
+      ctx.trackInput((0, import_node_path19.isAbsolute)(output) ? output : (0, import_node_path19.resolve)(root, output));
+      await generate2({
+        root,
+        output,
+        ...source,
+        ...options.styles !== void 0 ? { styles: options.styles } : {},
+        ...options.stylesDocs !== void 0 ? { stylesDocs: options.stylesDocs } : {},
+        ...options.tsconfig !== void 0 ? { tsconfig: options.tsconfig } : {}
+      });
+      return [];
+    }
+  };
+  return extension;
+}
+
 // src/index.ts
-var VERSION = "0.27.2";
+var VERSION = "0.29.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 +6361,7 @@ var VERSION = "0.27.2";
   emitRoutes,
   extractSchemaFromDto,
   generate,
+  genuiSandboxKit,
   loadConfig,
   renderTsType,
   resolveAdapter,