@dudousxd/nestjs-codegen 0.16.0 → 0.17.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-LQNP7Ms3.cjs';
-export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-LQNP7Ms3.cjs';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-DCF9QSPY.cjs';
+export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-DCF9QSPY.cjs';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -81,6 +81,15 @@ interface CodegenManifest {
     configKeyHashes?: Record<string, string>;
     /** Generated output files, relative to `outDir`, recorded after the last run. */
     files: string[];
+    /**
+     * Extra input files an extension read that the host's globs don't cover
+     * (`ExtensionContext.trackInput`), relative to `codegen.cwd`. Recorded like a
+     * compiler depfile: this run's dependencies become the next run's hash
+     * inputs, so editing one of them invalidates the manifest. Absent on
+     * manifests written before this field existed — treated as "none", which is
+     * the pre-existing (under-invalidating) behavior.
+     */
+    extraInputs?: string[];
 }
 
 /**
@@ -373,6 +382,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.16.0";
+declare const VERSION = "0.17.0";
 
 export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, ConfigError, DriftGuardError, type EntryPoint, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type WatchOptions, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-LQNP7Ms3.js';
-export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-LQNP7Ms3.js';
+import { U as UserConfig, R as ResolvedConfig, a as RouteDescriptor, S as SchemaNode, b as RenderContext, c as SchemaModule, d as RenderedModule, e as ResolvedFormsConfig, V as ValidationAdapter, C as CodegenExtension, E as ExtensionContext, f as SerializationMode } from './index-DCF9QSPY.js';
+export { A as AdapterUsage, g as ContractDescriptor, h as ContractSource, i as ControllerRef, N as NumberCheck, j as ScopeConfig, k as StringCheck, T as TypeRef, l as ValidationOption, r as resolveAdapter } from './index-DCF9QSPY.js';
 import { ClassDeclaration, SourceFile, Project } from 'ts-morph';
 
 declare function defineConfig(c: UserConfig): UserConfig;
@@ -81,6 +81,15 @@ interface CodegenManifest {
     configKeyHashes?: Record<string, string>;
     /** Generated output files, relative to `outDir`, recorded after the last run. */
     files: string[];
+    /**
+     * Extra input files an extension read that the host's globs don't cover
+     * (`ExtensionContext.trackInput`), relative to `codegen.cwd`. Recorded like a
+     * compiler depfile: this run's dependencies become the next run's hash
+     * inputs, so editing one of them invalidates the manifest. Absent on
+     * manifests written before this field existed — treated as "none", which is
+     * the pre-existing (under-invalidating) behavior.
+     */
+    extraInputs?: string[];
 }
 
 /**
@@ -373,6 +382,6 @@ interface FastDiscoveryOptions {
 }
 declare function discoverContractsFast(opts: FastDiscoveryOptions): Promise<RouteDescriptor[]>;
 
-declare const VERSION = "0.16.0";
+declare const VERSION = "0.17.0";
 
 export { type ChainModuleRendererOptions, CodegenError, type CodegenManifest, ConfigError, DriftGuardError, type EntryPoint, type FastDiscoveryOptions, type JsonSchema, type MocksEmitOptions, type OpenApiDocument, type OpenApiEmitOptions, type OpenApiInfo, RenderContext, RenderedModule, ResolvedConfig, RouteDescriptor, SchemaModule, SchemaNode, type TsTypeContext, UserConfig, VERSION, ValidationAdapter, type WatchOptions, type Watcher, acquireLock, buildMocksFile, buildOpenApiSpec, createChainModuleRenderer, defineConfig, discoverContractsFast, emitApi, emitForms, emitMocks, emitOpenApi, emitRoutes, extractSchemaFromDto, generate, loadConfig, renderTsType, resolveConfig, schemaModuleToJsonSchema, schemaNodeToJsonSchema, toObjectKey, typeNameFor, watch };

package/dist/index.js

@@ -519,9 +519,10 @@ function inferExpressionType(node) {
 
 // src/emit/emit-api.ts
 import { mkdir, writeFile } from "fs/promises";
-import { isAbsolute as isAbsolute2, join as join4, relative as relative3 } from "path";
+import { isAbsolute as isAbsolute2, join as join4, relative as relative4 } from "path";
 
 // src/extension/registry.ts
+import { relative as relative3, resolve as resolve2 } from "path";
 import { Project as Project2 } from "ts-morph";
 function resolveApiSlots(extensions) {
   let layer;
@@ -554,7 +555,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,
@@ -563,6 +564,13 @@ function createExtensionContext(config, getRoutes) {
     get routes() {
       return getRoutes();
     },
+    trackInput(...paths) {
+      if (!trackedInputs) return;
+      for (const path of paths) {
+        if (!path) continue;
+        trackedInputs.add(relative3(config.codegen.cwd, resolve2(config.codegen.cwd, path)));
+      }
+    },
     project() {
       if (!project) {
         project = new Project2({
@@ -730,7 +738,7 @@ function rawResponseType(c, outDir) {
     return c.contractSource.response;
   }
   if (c.controllerRef) {
-    let relPath = relative3(outDir, c.controllerRef.filePath).replace(/\.ts$/, "");
+    let relPath = relative4(outDir, c.controllerRef.filePath).replace(/\.ts$/, "");
     if (!relPath.startsWith(".")) relPath = `./${relPath}`;
     return `Awaited<ReturnType<import('${relPath}').${c.controllerRef.className}['${c.controllerRef.methodName}']>>`;
   }
@@ -1056,6 +1064,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();
@@ -1112,7 +1125,7 @@ function buildApiFile(routes, outDir, opts = {}) {
     for (const [filePath, names] of importsByFile) {
       let relPath;
       if (isAbsolute2(filePath)) {
-        relPath = relative3(outDir, filePath).replace(/\.ts$/, "");
+        relPath = relative4(outDir, filePath).replace(/\.ts$/, "");
         if (!relPath.startsWith(".")) relPath = `./${relPath}`;
       } else {
         relPath = filePath;
@@ -1226,7 +1239,7 @@ async function emitCache(pages, outDir) {
 
 // src/emit/emit-forms.ts
 import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
-import { join as join6, relative as relative4 } from "path";
+import { join as join6, relative as relative5 } from "path";
 async function emitForms(routes, outDir, config, adapter) {
   if (config && config.enabled === false) return false;
   const content = buildFormsFileWithAdapter(routes, outDir, adapter, config);
@@ -1245,7 +1258,7 @@ function deriveBaseName(routeName) {
   return { method, full };
 }
 function relImport(outDir, filePath) {
-  let relPath = relative4(outDir, filePath).replace(/\.ts$/, "");
+  let relPath = relative5(outDir, filePath).replace(/\.ts$/, "");
   if (!relPath.startsWith(".")) relPath = `./${relPath}`;
   return relPath;
 }
@@ -1996,7 +2009,7 @@ async function emitOpenApi(routes, outDir, opts = {}) {
 
 // src/emit/emit-pages.ts
 import { mkdir as mkdir7, writeFile as writeFile7 } from "fs/promises";
-import { join as join10, relative as relative5 } from "path";
+import { join as join10, relative as relative6 } from "path";
 async function emitPages(pages, outDir, _options = {}) {
   await mkdir7(outDir, { recursive: true });
   const pageNameUnion = pages.length > 0 ? pages.map((p) => JSON.stringify(p.name)).join(" | ") : "never";
@@ -2036,7 +2049,7 @@ ${propsBody}
 `;
 }
 function buildAugmentationType(page, outDir) {
-  let importPath = relative5(outDir, page.absolutePath).replace(/\.(tsx?|vue|svelte)$/, "");
+  let importPath = relative6(outDir, page.absolutePath).replace(/\.(tsx?|vue|svelte)$/, "");
   if (!importPath.startsWith(".")) {
     importPath = `./${importPath}`;
   }
@@ -2167,7 +2180,7 @@ 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 relative6 } from "path";
+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";
@@ -2190,6 +2203,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");
 }
@@ -2229,21 +2245,30 @@ async function discoverInputFiles(config) {
   const matched = await fg2(globs, { cwd, absolute: true, onlyFiles: true });
   return [...new Set(matched)].sort();
 }
-async function computeInputsHash(config) {
+async function computeInputsHash(config, extraInputs = []) {
   const hash = 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) => 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:${relative6(cwd, file)}
+    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) {
@@ -2257,6 +2282,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 {
@@ -2279,7 +2305,7 @@ async function listOutputFiles(outDir) {
       if (entry.isDirectory()) {
         await walk(abs);
       } else if (entry.isFile()) {
-        const rel = relative6(outDir, abs);
+        const rel = relative7(outDir, abs);
         if (rel === MANIFEST_FILE || rel === LOCK_FILE) continue;
         found.push(rel);
       }
@@ -2316,8 +2342,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;
@@ -2338,7 +2364,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);
   }
@@ -2398,13 +2425,16 @@ async function generate(config, inputRoutes = [], entryPoint = "cli") {
     }
   }
   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 } : {}
   });
 }
 
@@ -2414,7 +2444,7 @@ import { join as join16 } from "path";
 import chokidar from "chokidar";
 
 // src/discovery/contracts-fast.ts
-import { join as join14, resolve as resolve3 } from "path";
+import { join as join14, resolve as resolve4 } from "path";
 import fg3 from "fast-glob";
 import {
   Node as Node9,
@@ -2434,7 +2464,7 @@ import {
 
 // src/discovery/type-ref-resolution.ts
 import { readFileSync } from "fs";
-import { dirname as dirname3, resolve as resolve2 } from "path";
+import { dirname as dirname3, resolve as resolve3 } from "path";
 import {
   Node as Node2
 } from "ts-morph";
@@ -2491,9 +2521,9 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
     const dir = dirname3(sourceFile.getFilePath());
     const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
     return [
-      resolve2(dir, `${noExt}.ts`),
-      resolve2(dir, `${moduleSpecifier}.ts`),
-      resolve2(dir, moduleSpecifier, "index.ts")
+      resolve3(dir, `${noExt}.ts`),
+      resolve3(dir, `${moduleSpecifier}.ts`),
+      resolve3(dir, moduleSpecifier, "index.ts")
     ];
   }
   const ctx = _ctxFor(project);
@@ -2514,8 +2544,8 @@ function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
         const rest = moduleSpecifier.slice(prefix.length);
         const candidates = [];
         for (const mapping of mappings) {
-          const resolved = resolve2(baseUrl, mapping.replace("*", rest));
-          candidates.push(`${resolved}.ts`, resolve2(resolved, "index.ts"));
+          const resolved = resolve3(baseUrl, mapping.replace("*", rest));
+          candidates.push(`${resolved}.ts`, resolve3(resolved, "index.ts"));
         }
         dbg("  resolved candidates:", candidates);
         return candidates;
@@ -4379,7 +4409,7 @@ async function discoverContractsFast(opts) {
   return extractAllRoutes(project);
 }
 function resolveTsconfigPath(cwd, tsconfig) {
-  return tsconfig ? resolve3(tsconfig) : join14(cwd, "tsconfig.json");
+  return tsconfig ? resolve4(tsconfig) : join14(cwd, "tsconfig.json");
 }
 function createDiscoveryProject(tsconfigPath) {
   try {
@@ -4465,7 +4495,7 @@ var PersistentDiscovery = class _PersistentDiscovery {
   async rediscover(changedPaths) {
     if (changedPaths) {
       for (const p of changedPaths) {
-        const abs = resolve3(p);
+        const abs = resolve4(p);
         const sf = this.project.getSourceFile(abs);
         if (sf) {
           await sf.refreshFromFileSystem();
@@ -5056,7 +5086,7 @@ function createChainModuleRenderer(opts) {
 }
 
 // src/index.ts
-var VERSION = "0.16.0";
+var VERSION = "0.17.0";
 export {
   CodegenError,
   ConfigError,