@nestia/sdk 14.0.1 → 14.0.2

package/assets/bundle/distribute/build-sdk.cjs

@@ -0,0 +1,28 @@
+const cp = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+// Resolve the generated package's data against its own location, so invoking
+// the build from another directory cannot redirect deletion or generation.
+const { nestia } = require("./package.json");
+const root = path.resolve(__dirname, nestia.root);
+const output = path.resolve(__dirname, nestia.output);
+fs.rmSync(path.join(output, "functional"), { recursive: true, force: true });
+
+const args = ["nestia", "sdk"];
+if (process.platform !== "win32")
+  cp.execFileSync("npx", args, { cwd: root, stdio: "inherit" });
+else {
+  // Node cannot start a .cmd shim directly. The npm installation beside the
+  // shim provides the same entry point without interpreting a shell string.
+  const directory = (process.env.PATH ?? "")
+    .split(path.delimiter)
+    .find((entry) => fs.existsSync(path.join(entry, "npx.cmd")));
+  const cli = directory === undefined ? undefined : [
+    path.join(directory, "node_modules/npm/bin/npx-cli.js"),
+    path.resolve(directory, "../npm/bin/npx-cli.js"),
+  ].find((entry) => fs.existsSync(entry));
+  if (cli === undefined)
+    throw new Error("Unable to locate npx's JavaScript entry point beside npx.cmd on PATH.");
+  cp.execFileSync(process.execPath, [cli, ...args], { cwd: root, stdio: "inherit" });
+}

package/assets/bundle/distribute/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@ORGANIZATION/PROJECT-api",
-  "version": "14.0.1",
+  "version": "14.0.2",
   "description": "SDK library generated by Nestia",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "scripts": {
     "build": "npm run build:sdk && npm run compile",
-    "build:sdk": "rimraf ${output}/functional && cd ${root} && npx nestia sdk && cd ${current}",
+    "build:sdk": "node build-sdk.cjs",
     "compile": "rimraf lib && ttsc",
     "deploy": "npm run build && npm publish"
   },
@@ -20,6 +20,10 @@
     "url": "https://github.com/samchon/nestia/issues"
   },
   "homepage": "https://nestia.io",
+  "nestia": {
+    "root": "${root}",
+    "output": "${output}"
+  },
   "files": [
     "lib",
     "package.json",

package/lib/INestiaConfig.d.ts

@@ -4,6 +4,11 @@ import type { OpenApi } from "typia";
  * Definition for the `nestia.config.ts` file.
  *
  * @author Jeongho Nam - https://github.com/samchon
+ * @evidence contracts/common.md#principled-implementation The input names the controllers to analyze and every optional property enables or refines one output (SDK, distribution, e2e, Swagger), so one configuration file drives every generator.
+ * @evidence contracts/common.md#clear-and-simple-design A flat record whose nested types describe the input and the Swagger options.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a type and adds no runtime behavior.
+ * @evidence contracts/common.md#meaningful-documentation Every property documents its meaning and default, which are the public contract of the configuration file.
+ * @evidence contracts/portability.md#os-neutral-implementation Source inputs and output/distribution/e2e destinations carry native pathname strings interpreted by their owning Node filesystem operations; the application callback bypasses source compilation. Swagger route paths are distinct protocol values, not native file identities.
  */
 export interface INestiaConfig {
     /**
@@ -40,10 +45,15 @@ export interface INestiaConfig {
      * Recommend to use `"packages/api"` value.
      */
     distribute?: string;
-    /** @default false */
+    /**
+     * Groups HTTP and WebSocket SDK call arguments in one props object after the
+     * connection. MCP wrappers retain their client and arguments parameters.
+     *
+     * @default false
+     */
     keyword?: boolean;
     /**
-     * Allow simulation mode.
+     * Allow simulation mode for HTTP SDK calls.
      *
      * If you configure this property to be `true`, the SDK library would be
      * contain simulation mode. In the simulation mode, the SDK library would not
@@ -61,7 +71,8 @@ export interface INestiaConfig {
      *
      * If you configure this property and runs `npx nestia e2e` command,
      * `@nestia/sdk` will analyze your NestJS backend server code, and generates
-     * e2e test functions for every API endpoints.
+     * e2e test functions for the analyzed HTTP endpoints. WebSocket and MCP
+     * operations have no generated HTTP test function.
      *
      * If not configured, you can't run `npx nestia e2e` command.
      */
@@ -70,10 +81,10 @@ export interface INestiaConfig {
      * Whether to use propagation mode or not.
      *
      * If being configured, interaction functions of the SDK library would perform
-     * the propagation mode. The propagation mode means that never throwing
-     * exception even when status code is not 200 (or 201), but just returning the
+     * propagation mode. HTTP failure statuses are returned through the
      * {@link IPropagation} typed instance, which can specify its body type through
-     * discriminated union determined by status code.
+     * discriminated union determined by status code. Transport, decoding and
+     * configured assertion failures can still throw.
      *
      * @default false
      */
@@ -81,9 +92,10 @@ export interface INestiaConfig {
     /**
      * Whether to clone DTO structures or not.
      *
-     * If being configured, all of DTOs used in the backend server would be cloned
-     * into the `structures` directory, and the SDK library would be refer to the
-     * cloned DTOs instead of the original.
+     * If enabled, named DTOs reachable from analyzed routes are emitted into
+     * `structures`, with anonymous forms written inline. HTTP and MCP DTOs use
+     * their wire metadata; supported WebSocket declarations are copied from local
+     * sources, while external or unsupported imports retain source links.
      *
      * @default false
      */
@@ -91,8 +103,10 @@ export interface INestiaConfig {
     /**
      * Whether to wrap DTO by primitive type.
      *
-     * If you don't configure this property as `false`, all of DTOs in the SDK
-     * library would be automatically wrapped by {@link Primitive} type.
+     * Unless false, source DTO aliases use Primitive for JSON bodies and
+     * responses, and Resolved for query, headers and other resolved wire forms.
+     * Clone mode writes the analyzed metadata directly; multipart bodies use
+     * FormDataInput and binary responses use ReadableStream.
      *
      * For refenrece, if a DTO type be capsuled by the {@link Primitive} type, all
      * of methods in the DTO type would be automatically erased. Also, if the DTO
@@ -105,9 +119,10 @@ export interface INestiaConfig {
     /**
      * Whether to assert parameter types or not.
      *
-     * If you configure this property to be `true`, all of the function parameters
-     * of SDK library would be checked through [`typia.assert<T>()`
-     * function](https://typia.io/docs/validators/assert/).
+     * If true, HTTP path, query and body arguments are checked through
+     * [`typia.assert<T>()` function](https://typia.io/docs/validators/assert/).
+     * The connection, connection headers, WebSocket and MCP arguments are outside
+     * this option.
      *
      * This option would make your SDK library compilation time a little bit
      * slower, but would enahcne the type safety even in the runtime level.
@@ -116,16 +131,13 @@ export interface INestiaConfig {
      */
     assert?: boolean;
     /**
-     * Whether to optimize JSON string conversion 10x faster or not.
-     *
-     * If you configure this property to be `true`, the SDK library would utilize
-     * the [`typia.assertStringify<T>()
-     * function`](https://github.com/samchon/typia#enhanced-json) to boost up JSON
-     * serialization speed and ensure type safety.
+     * Generates specialized JSON serialization for JSON and encrypted request
+     * bodies.
      *
-     * This option would make your SDK library compilation time a little bit
-     * slower, but would enhance JSON serialization speed 10x faster. Also, it can
-     * ensure type safety even in the runtime level.
+     * When enabled, the SDK emits a `typia.json.assertStringify` function for the
+     * body type. With `assert` enabled, argument validation runs separately and
+     * serialization uses `typia.json.stringify` without repeating the assertion.
+     * Compilation and runtime costs depend on the body type and workload.
      *
      * @default false
      */
@@ -135,6 +147,12 @@ export declare namespace INestiaConfig {
     /**
      * List of files or directories to include or exclude to specifying the NestJS
      * controllers.
+     *
+     * @evidence contracts/common.md#principled-implementation Include lists select controller files or directories and exclude lists remove files from that selection.
+     * @evidence contracts/common.md#clear-and-simple-design A two-member record.
+     * @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.
+     * @evidence contracts/portability.md#os-neutral-implementation Include and exclude strings represent native files, directories or glob patterns. SourceFinder owns resolving them against the current working directory and distinguishing literal existing paths from wildcard suffixes.
      */
     interface IInput {
         /** List of files or directories containing the NestJS controller classes. */
@@ -142,7 +160,15 @@ export declare namespace INestiaConfig {
         /** List of files or directories to be excluded. */
         exclude?: string[];
     }
-    /** Building `swagger.json` is also possible. */
+    /**
+     * Building `swagger.json` is also possible.
+     *
+     * @evidence contracts/common.md#principled-implementation The output path is required and every other option refines the composed OpenAPI document before it is written.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record of options with one callback.
+     * @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.
+     * @evidence contracts/portability.md#os-neutral-implementation output is a native destination interpreted by path.parse/resolve in SwaggerGenerator; a nonempty extension denotes a file and otherwise the destination is a directory. Server URLs and operation paths retain protocol spelling independently of that filesystem boundary.
+     */
     interface ISwaggerConfig {
         /**
          * Response path of the `swagger.json`.
@@ -238,6 +264,11 @@ export declare namespace INestiaConfig {
          *
          * @param props Properties of the API endpoint.
          * @returns Operation ID.
+         * @evidence contracts/common.md#principled-implementation An explicit @operationId tag takes precedence; otherwise this callback receives the four identifying facts once for the composed operation and supplies its identifier.
+         * @evidence contracts/common.md#clear-and-simple-design One optional callback with a single argument object.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts It is a caller-supplied function and nothing about a particular naming scheme is built in.
+         * @evidence contracts/common.md#meaningful-documentation The comment documents the arguments and the result.
+         * @evidenceExclude contracts/portability.md#os-neutral-implementation This callback receives HTTP endpoint identity and returns an OpenAPI identifier; it owns no native pathname or process boundary.
          */
         operationId?(props: {
             class: string;

package/lib/NestiaSdkApplication.d.ts

@@ -1,10 +1,70 @@
 import { INestiaConfig } from "./INestiaConfig";
+/**
+ * Runs the generators of `@nestia/sdk` over one configuration.
+ *
+ * Each method validates the configuration for the output it needs, analyzes the
+ * controllers and the TypeScript metadata, reports every error at once, and
+ * then generates.
+ *
+ * @evidence contracts/common.md#principled-implementation The shared pipeline reflects controllers, types routes from transform metadata, assigns accessors and rejects collected analysis errors before writing. SDK-specific representability checks are attached by sdk and SDK-producing all; e2e currently invokes the SDK writer without that additional validation callback.
+ * @evidence contracts/common.md#clear-and-simple-design One class with four public generators over one private pipeline; directory assertion, title, and error report are module-private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts No controller or route name is special-cased; the same pipeline serves the CLI and programmatic callers.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the four generators and that the errors of an analysis are reported together.
+ * @evidence contracts/portability.md#os-neutral-implementation Output checks and diagnostic locations use Node fs.stat and path operations; controller compilation and output writes remain owned by ConfigAnalyzer and the generators. Filesystem errors distinguish missing/non-directory locations from other native failures.
+ */
 export declare class NestiaSdkApplication {
     private readonly config;
     constructor(config: INestiaConfig);
+    /**
+     * Generates everything the configuration asks for: the SDK and its e2e tests
+     * when `output` is set, and the Swagger document when `swagger` is set.
+     *
+     * It throws when neither `output` nor `swagger.output` is configured.
+     *
+     * @evidence contracts/common.md#principled-implementation The SDK validation is attached only when an SDK is generated, so a Swagger-only run does not fail on SDK rules, and the e2e tests are generated after the SDK they import.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators inside the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The error names the properties a caller can configure; none is stale.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the failure.
+     * @evidence contracts/portability.md#os-neutral-implementation all delegates configured output creation to the native writers and does not apply the explicit parent-directory checks used by sdk/e2e/swagger. Diagnostic source paths are rendered relative to the current native working directory.
+     */
     all(): Promise<void>;
+    /**
+     * Generates the SDK and the automatic e2e test functions.
+     *
+     * It throws when `output` or `e2e` is missing, or when the parent directory
+     * of either does not exist.
+     *
+     * @evidence contracts/common.md#principled-implementation The e2e functions import the generated SDK, so the SDK is generated first, and both parent directories are asserted before any analysis runs.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory check follows the configuration and no path is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirements and the failures.
+     * @evidence contracts/portability.md#os-neutral-implementation path.resolve obtains each native parent and fs.stat follows symlinks to verify a directory before analysis. ENOENT/ENOTDIR become configuration diagnostics; permission and other filesystem errors propagate without a platform-specific shell fallback.
+     */
     e2e(): Promise<void>;
+    /**
+     * Generates the SDK library.
+     *
+     * It throws when `output` is missing or its parent directory does not exist.
+     *
+     * @evidence contracts/common.md#principled-implementation The SDK validation runs after route typing and before the generator, so a route the SDK cannot express is reported instead of written.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory check follows the configuration.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirement and the failures.
+     * @evidence contracts/portability.md#os-neutral-implementation The configured output parent is resolved through Node path and verified by fs.stat, including linked directories. Generator writes use their own native boundaries; this entry does not infer case identity from an OS name.
+     */
     sdk(): Promise<void>;
+    /**
+     * Generates the Swagger document.
+     *
+     * It throws when `swagger.output` is missing or the directory that will hold
+     * the document does not exist; the output may be a file or a directory.
+     *
+     * @evidence contracts/common.md#principled-implementation The directory to check is the parent of a file path with an extension and the path itself otherwise, which is how the generator decides where to write.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is the generator's own output rule.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirement and the two output forms.
+     * @evidence contracts/portability.md#os-neutral-implementation path.parse/resolve decide the native containing directory from whether the output has an extension, matching SwaggerGenerator's destination rule. The common directory check distinguishes missing paths from non-directory entries and propagates other filesystem errors.
+     */
     swagger(): Promise<void>;
     private generate;
 }

package/lib/NestiaSdkApplication.js

@@ -29,10 +29,35 @@ const SwaggerGenerator_1 = require("./generates/SwaggerGenerator");
 const IReflectOperationError_1 = require("./structures/IReflectOperationError");
 const StringUtil_1 = require("./utils/StringUtil");
 const VersioningStrategy_1 = require("./utils/VersioningStrategy");
+/**
+ * Runs the generators of `@nestia/sdk` over one configuration.
+ *
+ * Each method validates the configuration for the output it needs, analyzes the
+ * controllers and the TypeScript metadata, reports every error at once, and
+ * then generates.
+ *
+ * @evidence contracts/common.md#principled-implementation The shared pipeline reflects controllers, types routes from transform metadata, assigns accessors and rejects collected analysis errors before writing. SDK-specific representability checks are attached by sdk and SDK-producing all; e2e currently invokes the SDK writer without that additional validation callback.
+ * @evidence contracts/common.md#clear-and-simple-design One class with four public generators over one private pipeline; directory assertion, title, and error report are module-private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts No controller or route name is special-cased; the same pipeline serves the CLI and programmatic callers.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the four generators and that the errors of an analysis are reported together.
+ * @evidence contracts/portability.md#os-neutral-implementation Output checks and diagnostic locations use Node fs.stat and path operations; controller compilation and output writes remain owned by ConfigAnalyzer and the generators. Filesystem errors distinguish missing/non-directory locations from other native failures.
+ */
 class NestiaSdkApplication {
     constructor(config) {
         this.config = config;
     }
+    /**
+     * Generates everything the configuration asks for: the SDK and its e2e tests
+     * when `output` is set, and the Swagger document when `swagger` is set.
+     *
+     * It throws when neither `output` nor `swagger.output` is configured.
+     *
+     * @evidence contracts/common.md#principled-implementation The SDK validation is attached only when an SDK is generated, so a Swagger-only run does not fail on SDK rules, and the e2e tests are generated after the SDK they import.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators inside the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The error names the properties a caller can configure; none is stale.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the failure.
+     * @evidence contracts/portability.md#os-neutral-implementation all delegates configured output creation to the native writers and does not apply the explicit parent-directory checks used by sdk/e2e/swagger. Diagnostic source paths are rendered relative to the current native working directory.
+     */
     all() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -42,7 +67,6 @@ class NestiaSdkApplication {
                     "",
                     "  - INestiaConfig.output",
                     "  - INestiaConfig.swagger.output",
-                    "  - INestiaConfig.openai.output",
                 ].join("\n"));
             print_title("Nestia All Generator");
             yield this.generate({
@@ -59,6 +83,18 @@ class NestiaSdkApplication {
             });
         });
     }
+    /**
+     * Generates the SDK and the automatic e2e test functions.
+     *
+     * It throws when `output` or `e2e` is missing, or when the parent directory
+     * of either does not exist.
+     *
+     * @evidence contracts/common.md#principled-implementation The e2e functions import the generated SDK, so the SDK is generated first, and both parent directories are asserted before any analysis runs.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory check follows the configuration and no path is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirements and the failures.
+     * @evidence contracts/portability.md#os-neutral-implementation path.resolve obtains each native parent and fs.stat follows symlinks to verify a directory before analysis. ENOENT/ENOTDIR become configuration diagnostics; permission and other filesystem errors propagate without a platform-specific shell fallback.
+     */
     e2e() {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.config.output)
@@ -86,6 +122,17 @@ class NestiaSdkApplication {
             });
         });
     }
+    /**
+     * Generates the SDK library.
+     *
+     * It throws when `output` is missing or its parent directory does not exist.
+     *
+     * @evidence contracts/common.md#principled-implementation The SDK validation runs after route typing and before the generator, so a route the SDK cannot express is reported instead of written.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The directory check follows the configuration.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirement and the failures.
+     * @evidence contracts/portability.md#os-neutral-implementation The configured output parent is resolved through Node path and verified by fs.stat, including linked directories. Generator writes use their own native boundaries; this entry does not infer case identity from an OS name.
+     */
     sdk() {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.config.output)
@@ -103,6 +150,18 @@ class NestiaSdkApplication {
             });
         });
     }
+    /**
+     * Generates the Swagger document.
+     *
+     * It throws when `swagger.output` is missing or the directory that will hold
+     * the document does not exist; the output may be a file or a directory.
+     *
+     * @evidence contracts/common.md#principled-implementation The directory to check is the parent of a file path with an extension and the path itself otherwise, which is how the generator decides where to write.
+     * @evidence contracts/common.md#clear-and-simple-design One method over the shared pipeline.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule is the generator's own output rule.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the requirement and the two output forms.
+     * @evidence contracts/portability.md#os-neutral-implementation path.parse/resolve decide the native containing directory from whether the output has an extension, matching SwaggerGenerator's destination rule. The common directory check distinguishes missing paths from non-directory entries and propagates other filesystem errors.
+     */
     swagger() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -177,8 +236,6 @@ class NestiaSdkApplication {
             // ANALYZE TYPESCRIPT CODE
             //----
             console.log("Analyzing source codes");
-            // METADATA COMPONENTS
-            const sourceCollection = TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.dictionary(controllers);
             // CONVERT TO TYPED OPERATIONS
             const routes = [];
             for (const c of controllers)
@@ -187,6 +244,8 @@ class NestiaSdkApplication {
                         routes.push(...TypedMcpRouteAnalyzer_1.TypedMcpRouteAnalyzer.analyze({
                             controller: c,
                             operation: o,
+                            clone: project.config.clone,
+                            errors: project.errors,
                         }));
                         continue;
                     }
@@ -212,7 +271,6 @@ class NestiaSdkApplication {
                         routes.push(...TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.analyze({
                             controller: c,
                             errors: project.errors,
-                            dictionary: sourceCollection,
                             operation: o,
                             paths: Array.from(pathList),
                         }));
@@ -224,7 +282,7 @@ class NestiaSdkApplication {
                         }));
                 }
             AccessorAnalyzer_1.AccessorAnalyzer.analyze(routes);
-            const collection = TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.routeDictionary(routes.filter((r) => r.protocol === "http"));
+            const collection = TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.routeDictionary(routes.filter((r) => r.protocol !== "websocket"));
             if (props.validate !== undefined)
                 project.errors.push(...props.validate({
                     project,

package/lib/NestiaSdkApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaSdkApplication.js","sourceRoot":"","sources":["../src/NestiaSdkApplication.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,+BAA8C;AAG9C,kEAA+D;AAC/D,8DAA2D;AAC3D,0DAAuD;AACvD,oFAAiF;AACjF,8EAA2E;AAC3E,4EAAyE;AACzE,wFAAqF;AACrF,2DAAwD;AACxD,2DAAwD;AACxD,mEAAgE;AAKhE,gFAA6E;AAK7E,mDAAgD;AAChD,mEAAgE;AAEhE;IACE,YAAoC,MAAqB;sBAArB,MAAM;IAAkB,CAAC;IAEhD,GAAG;;;YACd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAC,MAAA,IAAI,CAAC,MAAM,CAAC,OAAO,0CAAE,MAAM,CAAA;gBACrD,MAAM,IAAI,KAAK,CACb;oBACE,kGAAkG;oBAClG,EAAE;oBACF,0BAA0B;oBAC1B,kCAAkC;oBAClC,iCAAiC;iBAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YACJ,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClB,QAAQ,EAAE,CAAO,GAAG,EAAE,EAAE;oBACtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;wBACvB,MAAM,2BAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;wBACjC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG;4BAAE,MAAM,2BAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACxD,CAAC;oBACD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;wBAAE,MAAM,mCAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAChE,CAAC,CAAA;gBACD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,2BAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;aACjE,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,GAAG;;YACd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;gBACrB,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;iBACC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;gBACvB,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;YAEJ,MAAM,eAAe,CAAC;gBACpB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC5B,SAAS,EAAE,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;aACpD,CAAC,CAAC;YACH,MAAM,eAAe,CAAC;gBACpB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;gBACzB,SAAS,EAAE,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC;aACjD,CAAC,CAAC;YAEH,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClB,QAAQ,EAAE,CAAO,GAAG,EAAE,EAAE;oBACtB,MAAM,2BAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACjC,MAAM,2BAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACnC,CAAC,CAAA;aACF,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,GAAG;;YACd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;gBACrB,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;YAEJ,MAAM,eAAe,CAAC;gBACpB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC5B,SAAS,EAAE,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;aACpD,CAAC,CAAC;YAEH,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClB,QAAQ,EAAE,2BAAY,CAAC,QAAQ;gBAC/B,QAAQ,EAAE,2BAAY,CAAC,QAAQ;aAChC,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,OAAO;;;YAClB,IAAI,EAAC,MAAA,IAAI,CAAC,MAAM,CAAC,OAAO,0CAAE,MAAM,CAAA;gBAC9B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;YAEJ,MAAM,MAAM,GAAoB,cAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvE,MAAM,eAAe,CAAC;gBACpB,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,gBAAgB;gBAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;gBACpC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG;oBACrB,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;oBAC1B,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aAC7C,CAAC,CAAC;YAEH,WAAW,CAAC,0BAA0B,CAAC,CAAC;YACxC,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClB,QAAQ,EAAE,mCAAgB,CAAC,QAAQ;aACpC,CAAC,CAAC;QACL,CAAC;KAAA;IAEa,QAAQ,CAAC,KAGtB;;;;YACC,MAAM;YACN,mBAAmB;YACnB,MAAM;YACN,MAAM,MAAM,GAAiB,IAAI,OAAO,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAmB;gBAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,MAAM,+BAAc,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC9C,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,EAAE;aACb,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,MAAM,WAAW,GAAyB,OAAO,CAAC,KAAK,CAAC,WAAW;iBAChE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,qDAAyB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CACtE;iBACA,MAAM,CAAC,CAAC,CAAC,EAA2B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAEtD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM;gBACzB,MAAM,CAAC;oBACL,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,OAAO,CAAC,QAAQ;iBACzB,CAAC,CAAC;YACL,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM;gBACvB,OAAO,MAAM,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;YAEL,MAAM,GAAG,GAAW,CAAC,GAAG,EAAE;gBACxB,MAAM,GAAG,GAAkC,IAAI,cAAO,EAAE,CAAC;gBACzD,KAAK,MAAM,UAAU,IAAI,WAAW;oBAClC,KAAK,MAAM,cAAc,IAAI,UAAU,CAAC,KAAK;wBAC3C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;4BAC9C,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gCACjC,GAAG,CAAC,MAAM,CAAC,IAAI,WAAI,CAAC,OAAO,SAAS,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;gCACzD,SAAS;4BACX,CAAC;4BACD,KAAK,MAAM,aAAa,IAAI,SAAS,CAAC,KAAK;gCACzC,GAAG,CAAC,MAAM,CACR,IAAI,WAAI,CACN,GAAG,cAAc,IAAI,aAAa,EAAE,EACpC,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACtD,CACF,CAAC;wBACN,CAAC;gBACL,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC,CAAC,EAAE,CAAC;YAEL,OAAO,CAAC,GAAG,CAAC,qBAAqB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CACT,gBAAgB,WAAW;iBACxB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,CAAC,MAAM;gBACd,CAAC,CAAC,UAAU;qBACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;qBACvD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAChC;iBACA,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAChC,CAAC;YAEF,MAAM;YACN,0BAA0B;YAC1B,MAAM;YACN,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YAEtC,sBAAsB;YACtB,MAAM,gBAAgB,GACpB,+CAAsB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAEjD,8BAA8B;YAC9B,MAAM,MAAM,GAER,EAAE,CAAC;YACP,KAAK,MAAM,CAAC,IAAI,WAAW;gBACzB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;oBAC7B,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;wBACzB,MAAM,CAAC,IAAI,CACT,GAAG,6CAAqB,CAAC,OAAO,CAAC;4BAC/B,UAAU,EAAE,CAAC;4BACb,SAAS,EAAE,CAAC;yBACb,CAAC,CACH,CAAC;wBACF,SAAS;oBACX,CAAC;oBACD,MAAM,QAAQ,GAAgB,IAAI,GAAG,EAAE,CAAC;oBACxC,MAAM,QAAQ,GAAa,uCAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBAC3D,UAAU,EAAE,CAAC,CAAC,QAAQ;wBACtB,MAAM,EAAE,CAAC,CAAC,QAAQ;qBACnB,CAAC,CAAC;oBACH,KAAK,MAAM,CAAC,IAAI,QAAQ;wBACtB,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;4BACxC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;gCACpC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oCAC1C,MAAM,SAAS,GAAW,2BAAY,CAAC,IAAI,CACzC,MAAM,EACN,KAAK,EACL,QAAQ,CACT,CAAC;oCACF,QAAQ,CAAC,GAAG,CACV,2BAAY,CAAC,oBAAoB,CAAC;wCAChC,YAAY,QAAE,MAAA,OAAO,CAAC,KAAK,CAAC,YAAY,0CAAE,MAAM,mCAAI,EAAE;wCACtD,OAAO,EAAE,MAAA,OAAO,CAAC,KAAK,CAAC,YAAY,0CAAE,OAAO;wCAC5C,WAAW,EAAE,SAAS;wCACtB,MAAM,EAAE,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;wCAC7C,IAAI,EAAE,2BAAY,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC;qCACtC,CAAC,CACH,CAAC;gCACJ,CAAC;oBACP,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;wBACvB,MAAM,CAAC,IAAI,CACT,GAAG,+CAAsB,CAAC,OAAO,CAAC;4BAChC,UAAU,EAAE,CAAC;4BACb,MAAM,EAAE,OAAO,CAAC,MAAM;4BACtB,UAAU,EAAE,gBAAgB;4BAC5B,SAAS,EAAE,CAAC;4BACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;yBAC5B,CAAC,CACH,CAAC;yBACC,IAAI,CAAC,CAAC,QAAQ,KAAK,WAAW;wBACjC,MAAM,CAAC,IAAI,CACT,GAAG,yDAA2B,CAAC,OAAO,CAAC;4BACrC,UAAU,EAAE,CAAC;4BACb,SAAS,EAAE,CAAC;4BACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;yBAC5B,CAAC,CACH,CAAC;gBACN,CAAC;YACH,mCAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEjC,MAAM,UAAU,GACd,+CAAsB,CAAC,eAAe,CACpC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAClE,CAAC;YAEJ,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,GAAG,KAAK,CAAC,QAAQ,CAAC;oBAChB,OAAO;oBACP,UAAU;oBACV,MAAM;iBACP,CAAC,CACH,CAAC;YACJ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM;gBACvB,OAAO,MAAM,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;YACL,MAAM,KAAK,CAAC,QAAQ,CAAC;gBACnB,OAAO;gBACP,UAAU;gBACV,MAAM;aACP,CAAC,CAAC;QACL,CAAC;KAAA;CACF;;AAED;;;;;GAKG;AACH,MAAM,eAAe,GAAG,CAAO,KAK9B,EAAiB,EAAE;IAClB,MAAM,KAAK,GAAoB,MAAM,YAAE,CAAC,QAAQ;SAC7C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,CAAC,KAA4B,EAAQ,EAAE;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACL,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK;QACjD,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,CAAC,MAAM,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,GAAG,CAC/N,CAAC;AACN,CAAC,CAAA,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,GAAW,EAAQ,EAAE;IACxC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,KAGf,EAAQ,EAAE;IACT,MAAM,GAAG,GAGL,IAAI,cAAO,EAAE,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM;QAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,+CAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,WAAW,CAAC,UAAU,uBAAU,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAElE,6DAA6D;IAC7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,EACT,KAAK,EAAE,EAAE,KAAK,EAAE,EAChB,MAAM,EAAE,QAAQ,GACjB,IAAI,GAAG,EAAE,CAAC;QACT,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC1C,MAAM,QAAQ,GAAW,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,OAAO,GAAW;YACtB,GAAG,QAAQ,KAAK;YAChB,KAAK,CAAC,KAAK;YACX,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9D,gDAAgD;YAChD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChD,KAAK;YACL,QAAQ;iBACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,OAAO,CAAC,EAAE,CAAC;;oBAE3C,OAAO;wBACL,wDAAwD;wBACxD,CAAC,CAAC,QAAQ;4BACR,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK;4BACnC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI;wBACrB,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC;qBAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC;SACd,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;YAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,KAAe,EAAY,EAAE,CAC9C,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC"}
+{"version":3,"file":"NestiaSdkApplication.js","sourceRoot":"","sources":["../src/NestiaSdkApplication.ts"],"names":[],"mappings":"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"}

package/lib/NestiaSwaggerComposer.d.ts

@@ -2,6 +2,27 @@ import { INestApplication } from "@nestjs/common";
 import { OpenApiV3, OpenApiV3_1, SwaggerV2 } from "@typia/interface";
 import { OpenApi } from "typia";
 import { INestiaConfig } from "./INestiaConfig";
+/**
+ * Composes the Swagger document of a running NestJS application, without files.
+ *
+ * @evidence contracts/common.md#principled-implementation The controllers are taken from the application's module graph and analyzed like the CLI does, and only the HTTP routes are composed.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with a private analysis pipeline.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the same analyzers and composer as the CLI, so both produce one document.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidence contracts/portability.md#os-neutral-implementation Controller source lookup is delegated to ConfigAnalyzer.application; diagnostic filenames use Node path.relative from process.cwd. Route paths and versions remain protocol text rather than native filesystem identity.
+ */
 export declare namespace NestiaSwaggerComposer {
+    /**
+     * Returns the OpenAPI document of the application in the requested version.
+     *
+     * The document is composed as OpenAPI 3.2 and converted to the configured
+     * older version; every analysis error is collected and thrown together.
+     *
+     * @evidence contracts/common.md#principled-implementation Composition runs at the newest version and `OpenApiConverter.downgradeDocument` produces the older ones, so version differences live in one converter, and a failure of the analysis throws one error that lists every problem.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the shared analyzers and the Swagger generator.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No route is special-cased; the module graph is read through `ConfigAnalyzer.application`.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the returned versions and the error behavior.
+     * @evidence contracts/portability.md#os-neutral-implementation The composer receives an existing application and writes no output file. Its delegated controller discovery obtains native source locations, and its report renders those locations through path.relative; initialize may read package metadata for default info.
+     */
     const document: (app: INestApplication, config: Omit<INestiaConfig.ISwaggerConfig, "output">) => Promise<OpenApi.IDocument | OpenApiV3_1.IDocument | OpenApiV3.IDocument | SwaggerV2.IDocument>;
 }

package/lib/NestiaSwaggerComposer.js

@@ -24,8 +24,29 @@ const TypedHttpRouteAnalyzer_1 = require("./analyses/TypedHttpRouteAnalyzer");
 const SwaggerGenerator_1 = require("./generates/SwaggerGenerator");
 const IReflectOperationError_1 = require("./structures/IReflectOperationError");
 const VersioningStrategy_1 = require("./utils/VersioningStrategy");
+/**
+ * Composes the Swagger document of a running NestJS application, without files.
+ *
+ * @evidence contracts/common.md#principled-implementation The controllers are taken from the application's module graph and analyzed like the CLI does, and only the HTTP routes are composed.
+ * @evidence contracts/common.md#clear-and-simple-design One public function with a private analysis pipeline.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the same analyzers and composer as the CLI, so both produce one document.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * @evidence contracts/portability.md#os-neutral-implementation Controller source lookup is delegated to ConfigAnalyzer.application; diagnostic filenames use Node path.relative from process.cwd. Route paths and versions remain protocol text rather than native filesystem identity.
+ */
 var NestiaSwaggerComposer;
 (function (NestiaSwaggerComposer) {
+    /**
+     * Returns the OpenAPI document of the application in the requested version.
+     *
+     * The document is composed as OpenAPI 3.2 and converted to the configured
+     * older version; every analysis error is collected and thrown together.
+     *
+     * @evidence contracts/common.md#principled-implementation Composition runs at the newest version and `OpenApiConverter.downgradeDocument` produces the older ones, so version differences live in one converter, and a failure of the analysis throws one error that lists every problem.
+     * @evidence contracts/common.md#clear-and-simple-design One function over the shared analyzers and the Swagger generator.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No route is special-cased; the module graph is read through `ConfigAnalyzer.application`.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the returned versions and the error behavior.
+     * @evidence contracts/portability.md#os-neutral-implementation The composer receives an existing application and writes no output file. Its delegated controller discovery obtains native source locations, and its report renders those locations through path.relative; initialize may read package metadata for default info.
+     */
     NestiaSwaggerComposer.document = (app, config) => __awaiter(this, void 0, void 0, function* () {
         var _a;
         const input = yield ConfigAnalyzer_1.ConfigAnalyzer.application(app);
@@ -53,8 +74,6 @@ var NestiaSwaggerComposer;
             .filter((c) => c !== null);
         if (project.errors.length)
             throw report({ type: "error", errors: project.errors });
-        // METADATA COMPONENTS
-        const collection = TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.dictionary(controllers);
         // CONVERT TO TYPED OPERATIONS
         const routes = [];
         for (const c of controllers)
@@ -82,7 +101,6 @@ var NestiaSwaggerComposer;
                 routes.push(...TypedHttpRouteAnalyzer_1.TypedHttpRouteAnalyzer.analyze({
                     controller: c,
                     errors: project.errors,
-                    dictionary: collection,
                     operation: o,
                     paths: Array.from(pathList),
                 }));

package/lib/NestiaSwaggerComposer.js.map

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

package/lib/analyses/AccessorAnalyzer.d.ts

@@ -2,7 +2,33 @@ import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
 import { ITypedMcpRoute } from "../structures/ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "../structures/ITypedWebSocketRoute";
 type AnyRoute = ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute;
+/**
+ * Assigns each route the accessor path under which the generated SDK exposes
+ * it.
+ *
+ * @evidence contracts/common.md#principled-implementation The accessors are shrunk where a name repeats, escaped into valid unique identifiers, shrunk again, and each route is renamed to its last accessor segment.
+ * @evidence contracts/common.md#clear-and-simple-design One public function over three private passes.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The passes follow the accessor structure and no route or controller name is special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ * efficient algorithms: For R routes of at most D accessor segments, the prefix maps avoid repeated route-to-route searches. Prefix slicing and joining costs O(R D²) character work before collision escapes; collisions add probes and longer names. Two shrink passes are required around escaping because escaping changes the names being shrunk.
+ * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+ * bound retention and release resources: This operation owns only invocation-local values, with no retained cache, handle or background task.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation AccessorAnalyzer 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 AccessorAnalyzer {
+    /**
+     * Rewrites the accessor of every route in place so that accessors are valid,
+     * unique, and as short as they can be.
+     *
+     * @evidence contracts/common.md#principled-implementation Segments that repeat their parent are removed when no sibling shares the parent, non-identifier characters become underscores, a segment that collides with an existing accessor gets an underscore prefix, and the route name becomes the last segment.
+     * @evidence contracts/common.md#clear-and-simple-design One function that runs the passes in a fixed order.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rules apply to every route, and reserved names are computed from the routes themselves.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the passes and the in-place rewrite.
+     * efficient algorithms: For R routes of at most D accessor segments, the prefix maps avoid repeated route-to-route searches. Prefix slicing and joining costs O(R D²) character work before collision escapes; collisions add probes and longer names. Two shrink passes are required around escaping because escaping changes the names being shrunk.
+     * reuse equivalent work: This invocation computes its own result and coordinates no completed or in-flight computation across requests.
+     * bound retention and release resources: This operation owns only invocation-local values, with no retained cache, handle or background task.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation AccessorAnalyzer.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: (routes: Array<AnyRoute>) => void;
 }
 export {};