@nestia/sdk 14.0.0 → 14.0.2

package/lib/analyses/ConfigAnalyzer.d.ts

@@ -1,7 +1,48 @@
 import { INestApplication } from "@nestjs/common";
 import { INestiaConfig } from "../INestiaConfig";
 import { INestiaSdkInput } from "../structures/INestiaSdkInput";
+/**
+ * Finds the controllers a configuration names, either by compiling and
+ * importing sources or by reading a running application.
+ *
+ * @evidence contracts/common.md#principled-implementation Sources are compiled once through ttsc into a temporary directory, imported, and the exports that carry the Nest `path` metadata are the controllers; an application is read from its module container; results are memoized per configuration object in a weakly keyed map, so a configuration the watcher reloads releases its entry with the object.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and a private runtime compiler; the output-specific bundle filter comes from SdkInputFilter and configuration/runtime materializations share the owned-child cleanup registry.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated SDK's own files are excluded from the input by the bundle list of the SDK, not by name, and the container is read through internals, as noted at `application`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+ * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+ * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+ * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+ */
 export declare namespace ConfigAnalyzer {
+    /**
+     * Returns the analyzed input of a configuration: the controllers with their
+     * files and the global prefix and versioning options.
+     *
+     * The result is cached per configuration object.
+     *
+     * @evidence contracts/common.md#principled-implementation A function input is asked for the application and read as a running app; otherwise the matched TypeScript sources are compiled and imported, and the memo stores the promise so concurrent callers share one compilation.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating to `application` or to the runtime compiler.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cache is keyed by the identity of the configuration object, so a different or reloaded configuration object is never served another's result; one object keeps its first result, which is the contract of a configuration that is not mutated between generations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the two input forms and the caching.
+     * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+     * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+     * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     const input: (config: INestiaConfig) => Promise<INestiaSdkInput>;
+    /**
+     * Reads the controllers, the global prefix, and the versioning options of a
+     * running NestJS application.
+     *
+     * @evidence contracts/common.md#principled-implementation The controllers come from the module container with their module paths, their files from the location of each class, decoded from the `file:` URL, and the prefix and versioning options from the application's configuration.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public accessor for the container or the configuration, so the function reads `app.container` and `app.config`; this is the one foreign-internal read of the package and stays a stated limit.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is read.
+     * efficient algorithms: The container is traversed once and a hash map groups each class with its module prefixes, so location lookup occurs once per unique controller class.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: The invocation retains local module/controller collections until it returns. The running application and its controllers remain caller-owned; this reader neither starts nor closes the app.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     const application: (app: INestApplication) => Promise<INestiaSdkInput>;
 }

package/lib/analyses/ConfigAnalyzer.js

@@ -21,15 +21,44 @@ const get_function_location_1 = __importDefault(require("get-function-location")
 const path_1 = __importDefault(require("path"));
 const tstl_1 = require("tstl");
 const url_1 = require("url");
-const SdkGenerator_1 = require("../generates/SdkGenerator");
-const ArrayUtil_1 = require("../utils/ArrayUtil");
 const EmittedJavaScriptPatcher_1 = require("../utils/EmittedJavaScriptPatcher");
 const MapUtil_1 = require("../utils/MapUtil");
+const PathUtil_1 = require("../utils/PathUtil");
+const SdkInputFilter_1 = require("../utils/SdkInputFilter");
 const SourceFinder_1 = require("../utils/SourceFinder");
+const TemporaryDirectory_1 = require("../utils/TemporaryDirectory");
 const TsConfigReader_1 = require("../utils/TsConfigReader");
 const TtscExecutor_1 = require("../utils/TtscExecutor");
+/**
+ * Finds the controllers a configuration names, either by compiling and
+ * importing sources or by reading a running application.
+ *
+ * @evidence contracts/common.md#principled-implementation Sources are compiled once through ttsc into a temporary directory, imported, and the exports that carry the Nest `path` metadata are the controllers; an application is read from its module container; results are memoized per configuration object in a weakly keyed map, so a configuration the watcher reloads releases its entry with the object.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions and a private runtime compiler; the output-specific bundle filter comes from SdkInputFilter and configuration/runtime materializations share the owned-child cleanup registry.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated SDK's own files are excluded from the input by the bundle list of the SDK, not by name, and the container is read through internals, as noted at `application`.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+ * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+ * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+ * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+ */
 var ConfigAnalyzer;
 (function (ConfigAnalyzer) {
+    /**
+     * Returns the analyzed input of a configuration: the controllers with their
+     * files and the global prefix and versioning options.
+     *
+     * The result is cached per configuration object.
+     *
+     * @evidence contracts/common.md#principled-implementation A function input is asked for the application and read as a running app; otherwise the matched TypeScript sources are compiled and imported, and the memo stores the promise so concurrent callers share one compilation.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating to `application` or to the runtime compiler.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cache is keyed by the identity of the configuration object, so a different or reloaded configuration object is never served another's result; one object keeps its first result, which is the contract of a configuration that is not mutated between generations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the two input forms and the caching.
+     * efficient algorithms: Discovery traverses candidate files once, compiles one runtime project and inspects every exported value; work scales with source/compiler input and export population. Application input instead traverses container controllers and resolves each unique class location.
+     * reuse equivalent work: The promise cache shares concurrent and completed analyses for the same config object. It assumes that object, its input sources and application state remain unchanged during its lifetime; callers must supply a fresh config object after changes. Bundle exclusion shares only installed asset descriptions and derives native/realpath roots separately for each output; distinct outputs never reuse one captured prefix.
+     * bound retention and release resources: The weakly keyed input map does not retain released config objects, but emitted directories are registered until owned generation cleanup or process exit. Imported CommonJS/ESM modules remain in the hosting Node loader; direct programmatic callers have no per-generation unload guarantee. CLI watch generations isolate this state in a short-lived child.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     ConfigAnalyzer.input = (config) => __awaiter(this, void 0, void 0, function* () {
         return MapUtil_1.MapUtil.take(memory, config, () => __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -44,7 +73,7 @@ var ConfigAnalyzer;
                 exclude: typeof config.input === "object" && !Array.isArray(config.input)
                     ? ((_a = config.input.exclude) !== null && _a !== void 0 ? _a : [])
                     : [],
-                filter: filter(config),
+                filter: yield SdkInputFilter_1.SdkInputFilter.create(config.output),
             });
             const runtime = yield RuntimeCompiler.compile(sources);
             const controllers = [];
@@ -67,9 +96,22 @@ var ConfigAnalyzer;
             };
         }));
     });
+    /**
+     * Reads the controllers, the global prefix, and the versioning options of a
+     * running NestJS application.
+     *
+     * @evidence contracts/common.md#principled-implementation The controllers come from the module container with their module paths, their files from the location of each class, decoded from the `file:` URL, and the prefix and versioning options from the application's configuration.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts NestJS exposes no public accessor for the container or the configuration, so the function reads `app.container` and `app.config`; this is the one foreign-internal read of the package and stays a stated limit.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is read.
+     * efficient algorithms: The container is traversed once and a hash map groups each class with its module prefixes, so location lookup occurs once per unique controller class.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: The invocation retains local module/controller collections until it returns. The running application and its controllers remain caller-owned; this reader neither starts nor closes the app.
+     * @evidence contracts/portability.md#os-neutral-implementation Source/controller identity is obtained from Node path/file-URL conversion, module resolution and native fs. Compiler projects use explicit cwd and native paths; emitted module imports use file URLs. Route prefix/version spelling is kept as protocol text, not treated as filesystem identity.
+     */
     ConfigAnalyzer.application = (app) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d;
-        var _e, _f, _g, _h;
+        var _e, _f, _g, _h, _j;
         const container = app.container;
         const modules = [...container.getModules().values()].filter((m) => !!m.controllers.size);
         const unique = new tstl_1.HashMap();
@@ -84,7 +126,7 @@ var ConfigAnalyzer;
             const file = (_g = (_a = (yield (0, get_function_location_1.default)(it.first))) === null || _a === void 0 ? void 0 : _a.source) !== null && _g !== void 0 ? _g : null;
             if (file === null)
                 continue;
-            const location = normalize_file(file);
+            const location = PathUtil_1.PathUtil.location(file);
             if (location.length === 0)
                 continue;
             controllers.push({
@@ -105,15 +147,15 @@ var ConfigAnalyzer;
             versioning: versioning === undefined || versioning.type !== common_1.VersioningType.URI
                 ? undefined
                 : {
-                    prefix: versioning.prefix === undefined || versioning.prefix === false
-                        ? "v"
-                        : versioning.prefix,
+                    // as NestJS's RoutePathFactory.getVersionPrefix(): `false` is no
+                    // prefix at all, and only an absent one is the default "v"
+                    prefix: versioning.prefix === false ? "" : ((_j = versioning.prefix) !== null && _j !== void 0 ? _j : "v"),
                     defaultVersion: versioning.defaultVersion,
                 },
         };
     });
 })(ConfigAnalyzer || (exports.ConfigAnalyzer = ConfigAnalyzer = {}));
-const memory = new Map();
+const memory = new WeakMap();
 class RuntimeCompiler {
     constructor(cwd, outDir) {
         this.cwd = cwd;
@@ -124,9 +166,7 @@ class RuntimeCompiler {
             var _a;
             const cwd = process.cwd();
             const runtimeRoot = path_1.default.join(cwd, "node_modules", ".nestia", "runtime");
-            yield fs_1.default.promises.mkdir(runtimeRoot, { recursive: true });
-            ensureRuntimeCleanup(runtimeRoot);
-            const outDir = yield fs_1.default.promises.mkdtemp(path_1.default.join(runtimeRoot, "run-"));
+            const outDir = TemporaryDirectory_1.TemporaryDirectory.create(runtimeRoot, "run-");
             const project = path_1.default.join(cwd, `.nestia.runtime.${process.pid}.${Date.now()}.json`);
             const relative = (file) => path_1.default.relative(cwd, file).split("\\").join("/");
             yield fs_1.default.promises.writeFile(project, JSON.stringify({
@@ -167,41 +207,6 @@ class RuntimeCompiler {
         return emitted;
     }
 }
-const RUNTIME_ROOTS = new Set();
-let RUNTIME_CLEANUP_REGISTERED = false;
-const ensureRuntimeCleanup = (runtimeRoot) => {
-    RUNTIME_ROOTS.add(runtimeRoot);
-    if (RUNTIME_CLEANUP_REGISTERED === true)
-        return;
-    RUNTIME_CLEANUP_REGISTERED = true;
-    const sweep = () => {
-        for (const location of RUNTIME_ROOTS)
-            fs_1.default.rmSync(location, { force: true, recursive: true });
-    };
-    process.once("exit", sweep);
-    // process.once("exit", …) does not fire on SIGINT/SIGTERM. Without these
-    // handlers a Ctrl-C during codegen leaves `run-*` mkdtemp directories
-    // behind under node_modules/.nestia/runtime/ until a subsequent clean exit.
-    // The module-level RUNTIME_CLEANUP_REGISTERED flag above guards against
-    // re-entrancy within this module; we deliberately do NOT gate on
-    // `process.listenerCount(signal) > 0` because NestiaConfigLoader's parallel
-    // sweep registers first, and that gate would skip our registration —
-    // leaving RUNTIME_ROOTS unswept on Ctrl-C while config-loader cleans up.
-    // Windows note: `process.kill(pid, "SIGINT")` calls TerminateProcess
-    // rather than re-raising through the listener queue, so the handler
-    // cascade documented above only holds on POSIX. On Windows, whichever
-    // module registers FIRST runs its sweep and the second is skipped —
-    // RUNTIME_ROOTS cleanup is best-effort there. SIGHUP is a no-op for
-    // most common code paths on Windows (Node fires it on console-close
-    // and exits within seconds).
-    const onSignal = (signal) => {
-        sweep();
-        process.kill(process.pid, signal);
-    };
-    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
-        process.once(signal, onSignal);
-    }
-};
 const sdkTransformEnv = () => process.env.NESTIA_SDK_TRANSFORM === undefined
     ? { NESTIA_SDK_TRANSFORM: "1" }
     : {};
@@ -243,35 +248,5 @@ const normalizeProjectPath = (project) => {
     const next = project !== null && project !== void 0 ? project : "tsconfig.json";
     return path_1.default.isAbsolute(next) || next.startsWith(".") ? next : `./${next}`;
 };
-const normalize_file = (str) => str.substring(str.startsWith("file:///")
-    ? process.cwd()[0] === "/"
-        ? 7
-        : 8
-    : str.startsWith("file://")
-        ? 7
-        : 0);
-const filter = (config) => (location) => __awaiter(void 0, void 0, void 0, function* () {
-    return SourceFinder_1.SourceFinder.isTypeScriptSource(location) &&
-        (config.output === undefined ||
-            (location.indexOf(path_1.default.join(config.output, "functional")) === -1 &&
-                (yield (yield bundler.get(config.output))(location))) === false);
-});
 const dynamicImport = Function("specifier", "return import(specifier);");
-const bundler = new tstl_1.Singleton((output) => __awaiter(void 0, void 0, void 0, function* () {
-    const assets = yield fs_1.default.promises.readdir(SdkGenerator_1.SdkGenerator.BUNDLE_PATH);
-    const tuples = yield ArrayUtil_1.ArrayUtil.asyncMap(assets, (file) => __awaiter(void 0, void 0, void 0, function* () {
-        const relative = path_1.default.join(output, file);
-        const location = path_1.default.join(SdkGenerator_1.SdkGenerator.BUNDLE_PATH, file);
-        const stats = yield fs_1.default.promises.stat(location);
-        return new tstl_1.Pair(relative, stats.isDirectory());
-    }));
-    return (file) => __awaiter(void 0, void 0, void 0, function* () {
-        for (const it of tuples)
-            if (it.second === false && file === it.first)
-                return true;
-            else if (it.second === true && file.indexOf(it.first) === 0)
-                return true;
-        return false;
-    });
-}));
 //# sourceMappingURL=ConfigAnalyzer.js.map

package/lib/analyses/ConfigAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ConfigAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConfigAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ConfigAnalyzer.ts"],"names":[],"mappings":"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"}

package/lib/analyses/ImportAnalyzer.d.ts

@@ -1,4 +1,13 @@
 import { IReflectImport } from "../structures/IReflectImport";
+/**
+ * Helpers for the import lists of routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges the imports collected for one route and keeps a removal notice for the old analysis entry.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace ImportAnalyzer {
     /**
      * @deprecated Removed in the Go-migration cycle. Import metadata is now
@@ -8,7 +17,23 @@ export declare namespace ImportAnalyzer {
      *   `ts.SourceFile` to derive imports should read the metadata delivered
      *   through `Reflect.getMetadata("nestia/OperationMetadata", …)` instead. See
      *   `packages/core/MIGRATION.md`.
+     * @evidence contracts/common.md#principled-implementation The function exists only to give an actionable error to a caller of the removed API, and always throws.
+     * @evidence contracts/common.md#clear-and-simple-design One statement.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reports the removal instead of failing later with a missing function.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the replacement.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     const analyze: () => never;
+    /**
+     * Merges import records by file: namespace imports and default imports are
+     * deduplicated and sorted, and the named elements of every import of a file
+     * are combined with their aliases.
+     *
+     * @evidence contracts/common.md#principled-implementation Imports are grouped by file, each group emits its namespace imports, default imports, and one element list with an alias map for renamed elements, so the same file is imported once per kind.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one group merger.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge follows the import records, with no file special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the grouping and the merging.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.merge analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const merge: (imports: IReflectImport[]) => IReflectImport[];
 }

package/lib/analyses/ImportAnalyzer.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImportAnalyzer = void 0;
 const MapUtil_1 = require("../utils/MapUtil");
+/**
+ * Helpers for the import lists of routes.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace merges the imports collected for one route and keeps a removal notice for the old analysis entry.
+ * @evidence contracts/common.md#clear-and-simple-design Two functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var ImportAnalyzer;
 (function (ImportAnalyzer) {
     /**
@@ -12,12 +21,28 @@ var ImportAnalyzer;
      *   `ts.SourceFile` to derive imports should read the metadata delivered
      *   through `Reflect.getMetadata("nestia/OperationMetadata", …)` instead. See
      *   `packages/core/MIGRATION.md`.
+     * @evidence contracts/common.md#principled-implementation The function exists only to give an actionable error to a caller of the removed API, and always throws.
+     * @evidence contracts/common.md#clear-and-simple-design One statement.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It reports the removal instead of failing later with a missing function.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the replacement.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.analyze analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
      */
     ImportAnalyzer.analyze = () => {
         throw new Error("ImportAnalyzer.analyze was removed in @nestia/sdk@next. " +
             "Imports are now attached by the native transformer; read them from " +
             "IOperationMetadata.imports (see packages/core/MIGRATION.md).");
     };
+    /**
+     * Merges import records by file: namespace imports and default imports are
+     * deduplicated and sorted, and the named elements of every import of a file
+     * are combined with their aliases.
+     *
+     * @evidence contracts/common.md#principled-implementation Imports are grouped by file, each group emits its namespace imports, default imports, and one element list with an alias map for renamed elements, so the same file is imported once per kind.
+     * @evidence contracts/common.md#clear-and-simple-design One function over one group merger.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The merge follows the import records, with no file special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the grouping and the merging.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ImportAnalyzer.merge analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     ImportAnalyzer.merge = (imports) => {
         // group by files
         const fileGroups = new Map();

package/lib/analyses/ImportAnalyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImportAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ImportAnalyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ImportAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ImportAnalyzer.ts"],"names":[],"mappings":"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"}

package/lib/analyses/ParameterNameAnalyzer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Gives names to parameters that declare none, such as destructured ones.
+ *
+ * @evidence contracts/common.md#principled-implementation A missing name is derived from the field, camel-cased when it is not an identifier, or from the category, and then made unique against the names already taken.
+ * @evidence contracts/common.md#clear-and-simple-design One function, one record type, and one private candidate rule.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
+export declare namespace ParameterNameAnalyzer {
+    /**
+     * A parameter to name: its current name, its category, and an optional field.
+     *
+     * @evidence contracts/common.md#principled-implementation The three members are the inputs of the naming rule.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the type describes and the meaning of its members.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.IParameter analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    interface IParameter {
+        name: string;
+        category: string;
+        field?: string | null;
+    }
+    /**
+     * Names every parameter that declares no name of its own.
+     *
+     * A destructured parameter, `@TypedBody() { title }: IBody`, binds names but
+     * is not one, so the SDK's metadata carries it with an empty name. Its source
+     * text is no identifier the SDK could declare, and passing it as one would
+     * send `{ title }` alone. It is named after what it carries instead: its
+     * field when that is an identifier, or reads as one with its separators
+     * dropped in camel case, otherwise its category, such as `body` or `query`.
+     * The name yields to every other parameter's, which are the user's and are
+     * kept.
+     *
+     * @evidence contracts/common.md#principled-implementation The names in use are collected first, and each new name is escaped against them with underscores and added, so the result has no duplicates.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Existing names are never changed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the rule.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.name analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    const name: <T extends IParameter>(parameters: T[]) => T[];
+}

package/lib/analyses/ParameterNameAnalyzer.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterNameAnalyzer = void 0;
+const utils_1 = require("@typia/utils");
+const StringUtil_1 = require("../utils/StringUtil");
+/**
+ * Gives names to parameters that declare none, such as destructured ones.
+ *
+ * @evidence contracts/common.md#principled-implementation A missing name is derived from the field, camel-cased when it is not an identifier, or from the category, and then made unique against the names already taken.
+ * @evidence contracts/common.md#clear-and-simple-design One function, one record type, and one private candidate rule.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is generic.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
+var ParameterNameAnalyzer;
+(function (ParameterNameAnalyzer) {
+    /**
+     * Names every parameter that declares no name of its own.
+     *
+     * A destructured parameter, `@TypedBody() { title }: IBody`, binds names but
+     * is not one, so the SDK's metadata carries it with an empty name. Its source
+     * text is no identifier the SDK could declare, and passing it as one would
+     * send `{ title }` alone. It is named after what it carries instead: its
+     * field when that is an identifier, or reads as one with its separators
+     * dropped in camel case, otherwise its category, such as `body` or `query`.
+     * The name yields to every other parameter's, which are the user's and are
+     * kept.
+     *
+     * @evidence contracts/common.md#principled-implementation The names in use are collected first, and each new name is escaped against them with underscores and added, so the result has no duplicates.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Existing names are never changed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the rule.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation ParameterNameAnalyzer.name analyzes reflected route metadata; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    ParameterNameAnalyzer.name = (parameters) => {
+        const taken = parameters
+            .map((p) => p.name)
+            .filter((name) => name.length !== 0);
+        return parameters.map((p) => {
+            if (p.name.length !== 0)
+                return p;
+            const name = StringUtil_1.StringUtil.escapeDuplicate(taken)(candidate(p));
+            taken.push(name);
+            return Object.assign(Object.assign({}, p), { name });
+        });
+    };
+    const candidate = (p) => {
+        if (p.field !== undefined && p.field !== null && p.field.length !== 0) {
+            if (utils_1.NamingConvention.variable(p.field))
+                return p.field;
+            // `x-tenant` as `xTenant`
+            const camel = p.field
+                .split(/[^A-Za-z0-9_$]+/)
+                .filter((word) => word.length !== 0)
+                .map((word, i) => i === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1))
+                .join("");
+            if (utils_1.NamingConvention.variable(camel))
+                return camel;
+        }
+        return p.category;
+    };
+})(ParameterNameAnalyzer || (exports.ParameterNameAnalyzer = ParameterNameAnalyzer = {}));
+//# sourceMappingURL=ParameterNameAnalyzer.js.map

package/lib/analyses/ParameterNameAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterNameAnalyzer.js","sourceRoot":"","sources":["../../src/analyses/ParameterNameAnalyzer.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAEhD,oDAAiD;AAEjD;;;;;;;;GAQG;AACH,IAAiB,qBAAqB,CA6DrC;AA7DD,WAAiB,qBAAqB;IAgBpC;;;;;;;;;;;;;;;;;OAiBG;IACU,0BAAI,GAAG,CAAuB,UAAe,EAAO,EAAE;QACjE,MAAM,KAAK,GAAa,UAAU;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QACvC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAClC,MAAM,IAAI,GAAW,uBAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,uCAAY,CAAC,KAAE,IAAI,IAAG;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAa,EAAU,EAAE;QAC1C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,wBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,KAAK,CAAC;YACvD,0BAA0B;YAC1B,MAAM,KAAK,GAAW,CAAC,CAAC,KAAK;iBAC1B,KAAK,CAAC,iBAAiB,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;iBACnC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9D;iBACA,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI,wBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC,EA7DgB,qBAAqB,aAArB,qBAAqB,GAArB,qBAAqB,QA6DrC"}

package/lib/analyses/PathAnalyzer.d.ts

@@ -1,6 +1,37 @@
 import { RequestMethod } from "@nestjs/common";
+/**
+ * Helpers for route paths: joining, prefixing, and reading their parameters the
+ * way the router does.
+ *
+ * @evidence contracts/common.md#principled-implementation Paths are parsed by `path-to-regexp` after Fastify colon escapes are converted, so the parameters and literals are those the server reads.
+ * @evidence contracts/common.md#clear-and-simple-design Several small functions over one tokenizer and one parser.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The router's own grammar decides, and no path is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace PathAnalyzer {
+    /**
+     * The route paths joined as the router joins them: one `/` between them, and
+     * none doubled. A route path is router syntax, never a file path, so a
+     * backslash stays the escape of the character after it (`items\\:batchGet`).
+     *
+     * @evidence contracts/common.md#principled-implementation The parts are joined, split on slashes, and empty segments are dropped, so any number of slashes at the boundaries collapses.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It applies to every input.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result form.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.join interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const join: (...args: string[]) => string;
+    /**
+     * Joins a path with the global prefix, unless the route is excluded from the
+     * prefix.
+     *
+     * @evidence contracts/common.md#principled-implementation The exclusion list is matched by method and by exact path or pattern, as NestJS does, and an excluded route is joined with an empty prefix.
+     * @evidence contracts/common.md#clear-and-simple-design One function delegating the exclusion test to a private helper.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exclusion rule is NestJS's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the exclusion.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.joinWithGlobalPrefix interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const joinWithGlobalPrefix: (props: {
         globalPrefix: string;
         exclude: IGlobalPrefixExclude[] | undefined;
@@ -8,7 +39,68 @@ export declare namespace PathAnalyzer {
         method: string;
         path: string;
     }) => string;
-    export const escape: (str: string) => string | null;
+    /**
+     * Whether a route path holds a wildcard: a `*` not escaped as the literal
+     * character (`\\*`), which a route path may hold since #1713.
+     *
+     * @evidence contracts/common.md#principled-implementation A star preceded by a backslash is a literal, so the test looks for a star at the start or after a non-backslash character.
+     * @evidence contracts/common.md#clear-and-simple-design One regular expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It follows the router's escaping rule.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the escaped case.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.wildcard interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    export const wildcard: (str: string) => boolean;
+    /**
+     * The literal text and parameters of a path, in order, as path-to-regexp
+     * reads it: `/files/:id.json` is `/files/`, the parameter `id`, then `.json`,
+     * and `/range/:from-:to` holds two parameters parted by `-`. Every generator
+     * that writes a path with its parameters filled in reads it from here, never
+     * by splitting the text at `:` or `/`. `null` for a path it cannot parse.
+     *
+     * @evidence contracts/common.md#principled-implementation Tokens come from `path-to-regexp`, so text next to a parameter in one segment, such as `/files/:id.json`, is kept in place, adjacent literals merge, and an unnamed parameter makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the tokenizer.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result and why generators use it.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.segments interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    export const segments: (str: string) => ISegment[] | null;
+    /**
+     * The path in OpenAPI's template syntax, each parameter written `{name}`:
+     * `/files/:id.json` is `/files/{id}.json`.
+     *
+     * @evidence contracts/common.md#principled-implementation The segments are joined with literals verbatim and parameters in braces.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over `segments`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the same segmenter as the SDK generator.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the fallback.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.toOpenApi interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    export const toOpenApi: (str: string) => string;
+    /**
+     * A segment of a path: literal text or a named parameter.
+     *
+     * @evidence contracts/common.md#principled-implementation The union is discriminated by `type`, so a consumer handles each case once.
+     * @evidence contracts/common.md#clear-and-simple-design A two-member union.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the two cases.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.ISegment interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    export type ISegment = {
+        type: "literal";
+        value: string;
+    } | {
+        type: "param";
+        name: string;
+    };
+    /**
+     * Returns the names of the parameters of a path, or `null` when the path
+     * cannot be parsed.
+     *
+     * @evidence contracts/common.md#principled-implementation The parsed arguments are filtered to the parameters, and an empty parameter name makes the path unreadable.
+     * @evidence contracts/common.md#clear-and-simple-design One filter over the private parser.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The grammar is the router's.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation PathAnalyzer.parameters interprets router protocol paths; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     export const parameters: (str: string) => string[] | null;
     interface IGlobalPrefixExclude {
         path: string;