@nestia/migrate 14.0.1 → 14.0.3

package/lib/NestiaMigrateApplication.d.ts

@@ -1,13 +1,124 @@
 import { IHttpMigrateApplication, OpenApi, OpenApiV3, OpenApiV3_1, OpenApiV3_2, SwaggerV2 } from "@typia/interface";
 import type { IValidation } from "@typia/interface";
 import { INestiaMigrateConfig } from "./structures/INestiaMigrateConfig";
+/**
+ * Converts an OpenAPI document into a NestJS project or an SDK project, as a
+ * map from file path to file content.
+ *
+ * The constructor analyzes an emended OpenAPI document once; `assert` and
+ * `validate` upgrade a document of any supported version to that form first.
+ * `nest` and `sdk` then compose the files of the bundled template with the
+ * generated ones.
+ *
+ * The constructor analyzes the document once; generation walks templates and
+ * delegates per-route/schema emission, with the context builder’s accessor trie
+ * indexing strict prefixes.
+ *
+ * The instance shares its analyzed application between nest and sdk calls.
+ * Generation creates fresh context/accessor copies because its mode and config
+ * can differ.
+ *
+ * One instance retains its original document and analysis until callers release
+ * it; generated file maps are returned to callers rather than accumulated on
+ * the instance.
+ *
+ * @evidence contracts/common.md#principled-implementation The constructor analyzes the emended document into routes with `HttpMigration`, and the two generators start from the bundled template files, drop the paths the generators own (structures, functional API, controllers, feature tests), and add the generated files, so the result is the template with those trees replaced.
+ * @evidence contracts/common.md#clear-and-simple-design One class with two generators sharing one context builder; the accessor conflict escape and the package renaming are module-private functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Route analysis and the OpenAPI upgrade come from `@typia/utils`, and no document, path, or type name is special-cased; QUERY-method routes are left out because the SDK has no representation for them.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the class produces, when the document is analyzed, and how the two generators use the template.
+ */
 export declare class NestiaMigrateApplication {
     readonly document: OpenApi.IDocument;
     private readonly data_;
     constructor(document: OpenApi.IDocument);
+    /**
+     * Creates the application from a document of any supported OpenAPI or Swagger
+     * version, and throws when the document cannot be upgraded.
+     *
+     * Version conversion and route analysis scale with the document’s routes and
+     * schemas; this wrapper delegates each once.
+     *
+     * @evidence contracts/common.md#principled-implementation The document is upgraded by `OpenApiConverter.upgradeDocument`, which owns the version differences, so this function only wraps a successful result.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not repair or guess invalid documents.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the accepted versions and the throwing behavior.
+     */
     static assert(document: SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApiV3_2.IDocument | OpenApi.IDocument): NestiaMigrateApplication;
+    /**
+     * Creates the application, or returns the failure as an `IValidation` instead
+     * of throwing.
+     *
+     * Version conversion and route analysis scale with the document’s routes and
+     * schemas; validation delegates once and formats one caught failure.
+     *
+     * @evidence contracts/common.md#principled-implementation The upgrade runs inside a `try`, and an error becomes one validation error whose path is the input and whose value is the message, so a caller can report it.
+     * @evidence contracts/common.md#clear-and-simple-design The non-throwing twin of `assert`, sharing its constructor call.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The failure is reported, not hidden, and the message is the original one.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result shape.
+     */
     static validate(document: SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApiV3_2.IDocument | OpenApi.IDocument): IValidation<NestiaMigrateApplication>;
+    /**
+     * Returns the analyzed application: the routes and the operations that could
+     * not be migrated.
+     *
+     * Returning the existing analysis reference uses constant work.
+     *
+     * The constructor’s analysis is returned directly to every caller; callers
+     * receive mutable shared state rather than an independently refreshed view.
+     *
+     * @evidence contracts/common.md#principled-implementation The analysis is done once in the constructor and returned by reference.
+     * @evidence contracts/common.md#clear-and-simple-design One accessor.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It exposes what the analysis produced.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is returned.
+     */
     getData(): IHttpMigrateApplication;
+    /**
+     * Generates a NestJS monorepo project from the document.
+     *
+     * The files are the template, the controllers, the module, the DTO
+     * structures, the functional API, and, when requested, the e2e tests. A
+     * package name replaces the placeholder in every file.
+     *
+     * Template filtering and renaming scale with template/output bytes;
+     * programmers traverse routes and schemas. Accessor conflict escape indexes R
+     * routes with at most D segments in a trie. Ordered terminal sets preserve
+     * first-route precedence with logarithmic updates, and each escape probes
+     * only the current D-segment path rather than scanning R routes. Trie state
+     * holds original/final prefixes only and is local to generation.
+     *
+     * The instance’s route analysis is reused. Each call recomputes
+     * mode/config-dependent output and copies accessors because conflict escaping
+     * mutates them; returned maps remain caller-owned.
+     *
+     * @evidence contracts/common.md#principled-implementation The context copies the routes and escapes accessors that would collide with a shorter accessor, the template entries of the generated trees are removed, the programmers write the replacements, and `keyword: false` rewrites the one template setting that selects keyword parameters.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators; each generator owns its own files.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and the only textual edit of it is the documented keyword setting.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+     */
     nest(config: INestiaMigrateConfig): Record<string, string>;
+    /**
+     * Generates an SDK project from the document.
+     *
+     * The files are the template, the DTO structures, the functional API, the
+     * start script, the swagger document in its emended form, and, when
+     * requested, the e2e tests. A package name replaces the placeholder in every
+     * file.
+     *
+     * Template filtering and renaming scale with template/output bytes;
+     * programmers traverse routes and schemas. Accessor conflict escape indexes R
+     * routes with at most D segments in a trie. Ordered terminal sets preserve
+     * first-route precedence with logarithmic updates, and each escape probes
+     * only the current D-segment path rather than scanning R routes. Trie state
+     * holds original/final prefixes only and is local to generation.
+     *
+     * The instance’s route analysis is reused; mode/config-dependent output is
+     * recomputed with fresh accessor copies, and returned maps remain
+     * caller-owned.
+     *
+     * @evidence contracts/common.md#principled-implementation The context is built as for `nest`, the template entries of the generated trees are removed, the programmers write the replacements, and the emended document the application was built from, which is the input after any upgrade, is written beside them as `swagger.json`.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators, sharing the context builder with `nest`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and no document is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+     */
     sdk(config: INestiaMigrateConfig): Record<string, string>;
 }

package/lib/NestiaMigrateApplication.js

@@ -2,12 +2,39 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaMigrateApplication = void 0;
 const utils_1 = require("@typia/utils");
+const tstl_1 = require("tstl");
 const NEST_TEMPLATE_1 = require("./bundles/NEST_TEMPLATE");
 const SDK_TEMPLATE_1 = require("./bundles/SDK_TEMPLATE");
 const NestiaMigrateApiProgrammer_1 = require("./programmers/NestiaMigrateApiProgrammer");
 const NestiaMigrateApiStartProgrammer_1 = require("./programmers/NestiaMigrateApiStartProgrammer");
 const NestiaMigrateE2eProgrammer_1 = require("./programmers/NestiaMigrateE2eProgrammer");
 const NestiaMigrateNestProgrammer_1 = require("./programmers/NestiaMigrateNestProgrammer");
+/**
+ * Converts an OpenAPI document into a NestJS project or an SDK project, as a
+ * map from file path to file content.
+ *
+ * The constructor analyzes an emended OpenAPI document once; `assert` and
+ * `validate` upgrade a document of any supported version to that form first.
+ * `nest` and `sdk` then compose the files of the bundled template with the
+ * generated ones.
+ *
+ * The constructor analyzes the document once; generation walks templates and
+ * delegates per-route/schema emission, with the context builder’s accessor trie
+ * indexing strict prefixes.
+ *
+ * The instance shares its analyzed application between nest and sdk calls.
+ * Generation creates fresh context/accessor copies because its mode and config
+ * can differ.
+ *
+ * One instance retains its original document and analysis until callers release
+ * it; generated file maps are returned to callers rather than accumulated on
+ * the instance.
+ *
+ * @evidence contracts/common.md#principled-implementation The constructor analyzes the emended document into routes with `HttpMigration`, and the two generators start from the bundled template files, drop the paths the generators own (structures, functional API, controllers, feature tests), and add the generated files, so the result is the template with those trees replaced.
+ * @evidence contracts/common.md#clear-and-simple-design One class with two generators sharing one context builder; the accessor conflict escape and the package renaming are module-private functions.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Route analysis and the OpenAPI upgrade come from `@typia/utils`, and no document, path, or type name is special-cased; QUERY-method routes are left out because the SDK has no representation for them.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the class produces, when the document is analyzed, and how the two generators use the template.
+ */
 class NestiaMigrateApplication {
     /* -----------------------------------------------------------
       CONSTRUCTORS
@@ -16,9 +43,33 @@ class NestiaMigrateApplication {
         this.document = document;
         this.data_ = utils_1.HttpMigration.application(document);
     }
+    /**
+     * Creates the application from a document of any supported OpenAPI or Swagger
+     * version, and throws when the document cannot be upgraded.
+     *
+     * Version conversion and route analysis scale with the document’s routes and
+     * schemas; this wrapper delegates each once.
+     *
+     * @evidence contracts/common.md#principled-implementation The document is upgraded by `OpenApiConverter.upgradeDocument`, which owns the version differences, so this function only wraps a successful result.
+     * @evidence contracts/common.md#clear-and-simple-design One expression.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It does not repair or guess invalid documents.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the accepted versions and the throwing behavior.
+     */
     static assert(document) {
         return new NestiaMigrateApplication(utils_1.OpenApiConverter.upgradeDocument(document));
     }
+    /**
+     * Creates the application, or returns the failure as an `IValidation` instead
+     * of throwing.
+     *
+     * Version conversion and route analysis scale with the document’s routes and
+     * schemas; validation delegates once and formats one caught failure.
+     *
+     * @evidence contracts/common.md#principled-implementation The upgrade runs inside a `try`, and an error becomes one validation error whose path is the input and whose value is the message, so a caller can report it.
+     * @evidence contracts/common.md#clear-and-simple-design The non-throwing twin of `assert`, sharing its constructor call.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The failure is reported, not hidden, and the message is the original one.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the result shape.
+     */
     static validate(document) {
         try {
             return {
@@ -44,9 +95,46 @@ class NestiaMigrateApplication {
     /* -----------------------------------------------------------
       ACCESSORS
     ----------------------------------------------------------- */
+    /**
+     * Returns the analyzed application: the routes and the operations that could
+     * not be migrated.
+     *
+     * Returning the existing analysis reference uses constant work.
+     *
+     * The constructor’s analysis is returned directly to every caller; callers
+     * receive mutable shared state rather than an independently refreshed view.
+     *
+     * @evidence contracts/common.md#principled-implementation The analysis is done once in the constructor and returned by reference.
+     * @evidence contracts/common.md#clear-and-simple-design One accessor.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It exposes what the analysis produced.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is returned.
+     */
     getData() {
         return this.data_;
     }
+    /**
+     * Generates a NestJS monorepo project from the document.
+     *
+     * The files are the template, the controllers, the module, the DTO
+     * structures, the functional API, and, when requested, the e2e tests. A
+     * package name replaces the placeholder in every file.
+     *
+     * Template filtering and renaming scale with template/output bytes;
+     * programmers traverse routes and schemas. Accessor conflict escape indexes R
+     * routes with at most D segments in a trie. Ordered terminal sets preserve
+     * first-route precedence with logarithmic updates, and each escape probes
+     * only the current D-segment path rather than scanning R routes. Trie state
+     * holds original/final prefixes only and is local to generation.
+     *
+     * The instance’s route analysis is reused. Each call recomputes
+     * mode/config-dependent output and copies accessors because conflict escaping
+     * mutates them; returned maps remain caller-owned.
+     *
+     * @evidence contracts/common.md#principled-implementation The context copies the routes and escapes accessors that would collide with a shorter accessor, the template entries of the generated trees are removed, the programmers write the replacements, and `keyword: false` rewrites the one template setting that selects keyword parameters.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators; each generator owns its own files.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and the only textual edit of it is the documented keyword setting.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+     */
     nest(config) {
         const context = createContext("nest", this.data_, config);
         const files = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, Object.fromEntries(Object.entries(NEST_TEMPLATE_1.NEST_TEMPLATE).filter(([key]) => key.startsWith("packages/api/src/structures") === false &&
@@ -59,6 +147,30 @@ class NestiaMigrateApplication {
             : {}));
         return config.package ? renameSlug(config.package, files) : files;
     }
+    /**
+     * Generates an SDK project from the document.
+     *
+     * The files are the template, the DTO structures, the functional API, the
+     * start script, the swagger document in its emended form, and, when
+     * requested, the e2e tests. A package name replaces the placeholder in every
+     * file.
+     *
+     * Template filtering and renaming scale with template/output bytes;
+     * programmers traverse routes and schemas. Accessor conflict escape indexes R
+     * routes with at most D segments in a trie. Ordered terminal sets preserve
+     * first-route precedence with logarithmic updates, and each escape probes
+     * only the current D-segment path rather than scanning R routes. Trie state
+     * holds original/final prefixes only and is local to generation.
+     *
+     * The instance’s route analysis is reused; mode/config-dependent output is
+     * recomputed with fresh accessor copies, and returned maps remain
+     * caller-owned.
+     *
+     * @evidence contracts/common.md#principled-implementation The context is built as for `nest`, the template entries of the generated trees are removed, the programmers write the replacements, and the emended document the application was built from, which is the input after any upgrade, is written beside them as `swagger.json`.
+     * @evidence contracts/common.md#clear-and-simple-design One method that composes the generators, sharing the context builder with `nest`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and no document is special-cased.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+     */
     sdk(config) {
         const context = createContext("sdk", this.data_, config);
         const files = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, Object.fromEntries(Object.entries(SDK_TEMPLATE_1.SDK_TEMPLATE).filter(([key]) => key.startsWith("src/structures") === false &&
@@ -79,18 +191,45 @@ const createContext = (mode, application, config) => {
     };
 };
 const escapeConflictingAccessors = (routes) => {
-    for (const route of routes)
+    const create = () => ({
+        children: new Map(),
+        terminal: new tstl_1.TreeSet(),
+    });
+    const root = create();
+    const insert = (accessor, index) => {
+        let node = root;
+        for (const segment of accessor) {
+            let child = node.children.get(segment);
+            if (child === undefined) {
+                child = create();
+                node.children.set(segment, child);
+            }
+            node = child;
+        }
+        node.terminal.insert(index);
+        return node;
+    };
+    const terminals = routes.map((route, index) => insert(route.accessor, index));
+    for (const [routeIndex, route] of routes.entries()) {
         while (true) {
-            const neighbor = routes.find((candidate) => candidate !== route &&
-                candidate.accessor.length < route.accessor.length &&
-                route.accessor
-                    .slice(0, candidate.accessor.length)
-                    .every((value, index) => value === candidate.accessor[index]));
-            if (neighbor === undefined)
+            let node = root;
+            let neighborIndex = Infinity;
+            for (let depth = 0; depth < route.accessor.length - 1; ++depth) {
+                const child = node.children.get(route.accessor[depth]);
+                if (child === undefined)
+                    break;
+                node = child;
+                if (!node.terminal.empty())
+                    neighborIndex = Math.min(neighborIndex, node.terminal.begin().value);
+            }
+            if (neighborIndex === Infinity)
                 break;
-            const index = neighbor.accessor.length - 1;
-            route.accessor[index] = `_${route.accessor[index]}`;
+            const conflict = routes[neighborIndex].accessor.length - 1;
+            route.accessor[conflict] = `_${route.accessor[conflict]}`;
         }
+        terminals[routeIndex].terminal.erase(routeIndex);
+        insert(route.accessor, routeIndex);
+    }
     return routes;
 };
 const renameSlug = (slug, files) => {

package/lib/NestiaMigrateApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaMigrateApplication.js","sourceRoot":"","sources":["../src/NestiaMigrateApplication.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NestiaMigrateApplication.js","sourceRoot":"","sources":["../src/NestiaMigrateApplication.ts"],"names":[],"mappings":";;;AAUA,wCAA+D;AAC/D,+BAA+B;AAE/B,2DAAwD;AACxD,yDAAsD;AACtD,yFAAsF;AACtF,mGAAgG;AAChG,yFAAsF;AACtF,2FAAwF;AAIxF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH;IAGE;;kEAE8D;IAC9D,YAAmC,QAA2B;wBAA3B,QAAQ;QACzC,IAAI,CAAC,KAAK,GAAG,qBAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,MAAM,CAClB,QAKqB;QAErB,OAAO,IAAI,wBAAwB,CACjC,wBAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAC3C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,QAAQ,CACpB,QAKqB;QAErB,IAAI,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAI,wBAAwB,CAChC,wBAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAC3C;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAW,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,QAAQ;wBACd,QAAQ,EACN,+GAA+G;wBACjH,KAAK,EAAE,OAAO;qBACf;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;kEAE8D;IAC9D;;;;;;;;;;;;;OAaG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,IAAI,CAAC,MAA4B;QACtC,MAAM,OAAO,GAA0B,aAAa,CAClD,MAAM,EACN,IAAI,CAAC,KAAK,EACV,MAAM,CACP,CAAC;QACF,MAAM,KAAK,6EACN,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,6BAAa,CAAC,CAAC,MAAM,CAClC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CACR,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,KAAK,KAAK;YACvD,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,KAAK,KAAK;YACvD,GAAG,CAAC,UAAU,CAAC,kCAAkC,CAAC,KAAK,KAAK;YAC5D,GAAG,CAAC,UAAU,CAAC,gCAAgC,CAAC,KAAK,KAAK,CAC7D,CACF,GACE,yDAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,GAC1C,uDAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,GACzC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,uDAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAC7D,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK;YAC1B,CAAC,CAAC;gBACE,mCAAmC,EAAE,6BAAa,CAChD,mCAAmC,CACnC,CAAC,OAAO,CAAC,eAAe,EAAE,gBAAgB,CAAC;aAC9C;YACH,CAAC,CAAC,EAAE,CAAC,CACR,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,GAAG,CAAC,MAA4B;QACrC,MAAM,OAAO,GAA0B,aAAa,CAClD,KAAK,EACL,IAAI,CAAC,KAAK,EACV,MAAM,CACP,CAAC;QACF,MAAM,KAAK,6EACN,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,2BAAY,CAAC,CAAC,MAAM,CACjC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CACR,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,KAAK;YAC1C,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,KAAK;YAC1C,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,KAAK,KAAK,CAC5C,CACF,GACE,uDAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,GACzC,iEAA+B,CAAC,KAAK,CAAC,OAAO,CAAC,GAC9C,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,uDAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAChE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GACvD,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,CAAC;CACF;;AAED,MAAM,aAAa,GAAG,CACpB,IAAoB,EACpB,WAAoC,EACpC,MAA4B,EACL,EAAE;IACzB,MAAM,MAAM,GAAwB,0BAA0B,CAC5D,WAAW,CAAC,MAAM;SACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iCACP,CAAC,KACJ,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IACzB,CAAC,CACN,CAAC;IACF,OAAO;QACL,IAAI;QACJ,WAAW,kCACN,WAAW,KACd,MAAM,GACP;QACD,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CACjC,MAA2B,EACN,EAAE;IAKvB,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,CAAC;QAC5B,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,QAAQ,EAAE,IAAI,cAAO,EAAE;KACxB,CAAC,CAAC;IACH,MAAM,IAAI,GAAW,MAAM,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,QAAkB,EAAE,KAAa,EAAU,EAAE;QAC3D,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,GAAG,IAAI,CAAC;YAChB,IAAI,aAAa,GAAG,QAAQ,CAAC;YAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;gBAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAE,CAAC,CAAC;gBACxD,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM;gBAC/B,IAAI,GAAG,KAAK,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;oBACxB,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,aAAa,KAAK,QAAQ;gBAAE,MAAM;YACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5D,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,SAAS,CAAC,UAAU,CAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CACjB,IAAY,EACZ,KAA6B,EACL,EAAE;IAC1B,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC1C,GAAG;QACH,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAChD,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/lib/NestiaMigrateApplication.mjs

@@ -5,15 +5,66 @@ import { NestiaMigrateApiStartProgrammer } from "./programmers/NestiaMigrateApiS
 import { NestiaMigrateE2eProgrammer } from "./programmers/NestiaMigrateE2eProgrammer.mjs";
 import { NestiaMigrateNestProgrammer } from "./programmers/NestiaMigrateNestProgrammer.mjs";
 import { HttpMigration, OpenApiConverter } from "@typia/utils";
+import { TreeSet } from "tstl";
 //#region src/NestiaMigrateApplication.ts
+/**
+* Converts an OpenAPI document into a NestJS project or an SDK project, as a
+* map from file path to file content.
+*
+* The constructor analyzes an emended OpenAPI document once; `assert` and
+* `validate` upgrade a document of any supported version to that form first.
+* `nest` and `sdk` then compose the files of the bundled template with the
+* generated ones.
+*
+* The constructor analyzes the document once; generation walks templates and
+* delegates per-route/schema emission, with the context builder’s accessor trie
+* indexing strict prefixes.
+*
+* The instance shares its analyzed application between nest and sdk calls.
+* Generation creates fresh context/accessor copies because its mode and config
+* can differ.
+*
+* One instance retains its original document and analysis until callers release
+* it; generated file maps are returned to callers rather than accumulated on
+* the instance.
+*
+* @evidence contracts/common.md#principled-implementation The constructor analyzes the emended document into routes with `HttpMigration`, and the two generators start from the bundled template files, drop the paths the generators own (structures, functional API, controllers, feature tests), and add the generated files, so the result is the template with those trees replaced.
+* @evidence contracts/common.md#clear-and-simple-design One class with two generators sharing one context builder; the accessor conflict escape and the package renaming are module-private functions.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts Route analysis and the OpenAPI upgrade come from `@typia/utils`, and no document, path, or type name is special-cased; QUERY-method routes are left out because the SDK has no representation for them.
+* @evidence contracts/common.md#meaningful-documentation The comment states what the class produces, when the document is analyzed, and how the two generators use the template.
+*/
 var NestiaMigrateApplication = class NestiaMigrateApplication {
 	constructor(document) {
 		this.document = document;
 		this.data_ = HttpMigration.application(document);
 	}
+	/**
+	* Creates the application from a document of any supported OpenAPI or Swagger
+	* version, and throws when the document cannot be upgraded.
+	*
+	* Version conversion and route analysis scale with the document’s routes and
+	* schemas; this wrapper delegates each once.
+	*
+	* @evidence contracts/common.md#principled-implementation The document is upgraded by `OpenApiConverter.upgradeDocument`, which owns the version differences, so this function only wraps a successful result.
+	* @evidence contracts/common.md#clear-and-simple-design One expression.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts It does not repair or guess invalid documents.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the accepted versions and the throwing behavior.
+	*/
 	static assert(document) {
 		return new NestiaMigrateApplication(OpenApiConverter.upgradeDocument(document));
 	}
+	/**
+	* Creates the application, or returns the failure as an `IValidation` instead
+	* of throwing.
+	*
+	* Version conversion and route analysis scale with the document’s routes and
+	* schemas; validation delegates once and formats one caught failure.
+	*
+	* @evidence contracts/common.md#principled-implementation The upgrade runs inside a `try`, and an error becomes one validation error whose path is the input and whose value is the message, so a caller can report it.
+	* @evidence contracts/common.md#clear-and-simple-design The non-throwing twin of `assert`, sharing its constructor call.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The failure is reported, not hidden, and the message is the original one.
+	* @evidence contracts/common.md#meaningful-documentation The comment states the result shape.
+	*/
 	static validate(document) {
 		try {
 			return {
@@ -32,9 +83,46 @@ var NestiaMigrateApplication = class NestiaMigrateApplication {
 			};
 		}
 	}
+	/**
+	* Returns the analyzed application: the routes and the operations that could
+	* not be migrated.
+	*
+	* Returning the existing analysis reference uses constant work.
+	*
+	* The constructor’s analysis is returned directly to every caller; callers
+	* receive mutable shared state rather than an independently refreshed view.
+	*
+	* @evidence contracts/common.md#principled-implementation The analysis is done once in the constructor and returned by reference.
+	* @evidence contracts/common.md#clear-and-simple-design One accessor.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts It exposes what the analysis produced.
+	* @evidence contracts/common.md#meaningful-documentation The comment states what is returned.
+	*/
 	getData() {
 		return this.data_;
 	}
+	/**
+	* Generates a NestJS monorepo project from the document.
+	*
+	* The files are the template, the controllers, the module, the DTO
+	* structures, the functional API, and, when requested, the e2e tests. A
+	* package name replaces the placeholder in every file.
+	*
+	* Template filtering and renaming scale with template/output bytes;
+	* programmers traverse routes and schemas. Accessor conflict escape indexes R
+	* routes with at most D segments in a trie. Ordered terminal sets preserve
+	* first-route precedence with logarithmic updates, and each escape probes
+	* only the current D-segment path rather than scanning R routes. Trie state
+	* holds original/final prefixes only and is local to generation.
+	*
+	* The instance’s route analysis is reused. Each call recomputes
+	* mode/config-dependent output and copies accessors because conflict escaping
+	* mutates them; returned maps remain caller-owned.
+	*
+	* @evidence contracts/common.md#principled-implementation The context copies the routes and escapes accessors that would collide with a shorter accessor, the template entries of the generated trees are removed, the programmers write the replacements, and `keyword: false` rewrites the one template setting that selects keyword parameters.
+	* @evidence contracts/common.md#clear-and-simple-design One method that composes the generators; each generator owns its own files.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and the only textual edit of it is the documented keyword setting.
+	* @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+	*/
 	nest(config) {
 		const context = createContext("nest", this.data_, config);
 		const files = {
@@ -46,6 +134,30 @@ var NestiaMigrateApplication = class NestiaMigrateApplication {
 		};
 		return config.package ? renameSlug(config.package, files) : files;
 	}
+	/**
+	* Generates an SDK project from the document.
+	*
+	* The files are the template, the DTO structures, the functional API, the
+	* start script, the swagger document in its emended form, and, when
+	* requested, the e2e tests. A package name replaces the placeholder in every
+	* file.
+	*
+	* Template filtering and renaming scale with template/output bytes;
+	* programmers traverse routes and schemas. Accessor conflict escape indexes R
+	* routes with at most D segments in a trie. Ordered terminal sets preserve
+	* first-route precedence with logarithmic updates, and each escape probes
+	* only the current D-segment path rather than scanning R routes. Trie state
+	* holds original/final prefixes only and is local to generation.
+	*
+	* The instance’s route analysis is reused; mode/config-dependent output is
+	* recomputed with fresh accessor copies, and returned maps remain
+	* caller-owned.
+	*
+	* @evidence contracts/common.md#principled-implementation The context is built as for `nest`, the template entries of the generated trees are removed, the programmers write the replacements, and the emended document the application was built from, which is the input after any upgrade, is written beside them as `swagger.json`.
+	* @evidence contracts/common.md#clear-and-simple-design One method that composes the generators, sharing the context builder with `nest`.
+	* @evidence contracts/common.md#prohibited-implementation-shortcuts The template is the published starter, and no document is special-cased.
+	* @evidence contracts/common.md#meaningful-documentation The comment states what is generated and the package renaming.
+	*/
 	sdk(config) {
 		const context = createContext("sdk", this.data_, config);
 		const files = {
@@ -73,11 +185,41 @@ const createContext = (mode, application, config) => {
 	};
 };
 const escapeConflictingAccessors = (routes) => {
-	for (const route of routes) while (true) {
-		const neighbor = routes.find((candidate) => candidate !== route && candidate.accessor.length < route.accessor.length && route.accessor.slice(0, candidate.accessor.length).every((value, index) => value === candidate.accessor[index]));
-		if (neighbor === void 0) break;
-		const index = neighbor.accessor.length - 1;
-		route.accessor[index] = `_${route.accessor[index]}`;
+	const create = () => ({
+		children: /* @__PURE__ */ new Map(),
+		terminal: new TreeSet()
+	});
+	const root = create();
+	const insert = (accessor, index) => {
+		let node = root;
+		for (const segment of accessor) {
+			let child = node.children.get(segment);
+			if (child === void 0) {
+				child = create();
+				node.children.set(segment, child);
+			}
+			node = child;
+		}
+		node.terminal.insert(index);
+		return node;
+	};
+	const terminals = routes.map((route, index) => insert(route.accessor, index));
+	for (const [routeIndex, route] of routes.entries()) {
+		while (true) {
+			let node = root;
+			let neighborIndex = Infinity;
+			for (let depth = 0; depth < route.accessor.length - 1; ++depth) {
+				const child = node.children.get(route.accessor[depth]);
+				if (child === void 0) break;
+				node = child;
+				if (!node.terminal.empty()) neighborIndex = Math.min(neighborIndex, node.terminal.begin().value);
+			}
+			if (neighborIndex === Infinity) break;
+			const conflict = routes[neighborIndex].accessor.length - 1;
+			route.accessor[conflict] = `_${route.accessor[conflict]}`;
+		}
+		terminals[routeIndex].terminal.erase(routeIndex);
+		insert(route.accessor, routeIndex);
 	}
 	return routes;
 };

package/lib/_virtual/_rolldown/runtime.mjs

@@ -1,5 +1,6 @@
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {
@@ -9,5 +10,9 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+});
 //#endregion
-export { __exportAll };
+export { __commonJSMin, __exportAll, __require };

package/lib/analyzers/NestiaMigrateControllerAnalyzer.d.ts

@@ -1,6 +1,43 @@
 import { IHttpMigrateRoute } from "@typia/interface";
 import { INestiaMigrateController } from "../structures/INestiaMigrateController";
+/**
+ * Groups the routes of an application into NestJS controllers.
+ *
+ * Generated controller locations use portable slash spelling and directoryName
+ * applies Windows filename constraints on every host: invalid/control
+ * characters and trailing dots/spaces become underscores, and device names,
+ * including extension and superscript-digit forms, receive a prefix. Router
+ * paths retain their original URL meaning. Directory normalization is
+ * intentionally many-to-one; distinct controllers retain their own filenames.
+ * Host filesystem case policy is not inferred.
+ *
+ * @evidence contracts/common.md#principled-implementation Routes are grouped by the controller name from the operation, or by the capitalized accessor prefix, and each controller path is the longest path prefix shared by all of its routes, so one controller covers one resource path.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with the grouping and the path formatting, and small private helpers for the shared-prefix computation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Names and paths derive from the document, with no route or controller name special-cased.
+ * @evidence contracts/common.md#meaningful-documentation The comment states its purpose.
+ */
 export declare namespace NestiaMigrateControllerAnalyzer {
+    /**
+     * Returns the controllers of the routes, each with its name, its path, its
+     * source location, and its routes.
+     *
+     * The name is the `x-samchon-controller` extension of the operation when
+     * present, and otherwise the capitalized accessor prefix followed by
+     * `Controller`.
+     *
+     * Generated controller locations use portable slash spelling and
+     * directoryName applies Windows filename constraints on every host:
+     * invalid/control characters and trailing dots/spaces become underscores, and
+     * device names, including extension and superscript-digit forms, receive a
+     * prefix. Router paths retain their original URL meaning. Directory
+     * normalization is intentionally many-to-one; distinct controllers retain
+     * their own filenames. Host filesystem case policy is not inferred.
+     *
+     * @evidence contracts/common.md#principled-implementation Grouping uses a map keyed by controller name, and the common path prefix and the directory prefix are found by removing every segment after the first difference across the routes, so a controller path is a prefix of every route it owns.
+     * @evidence contracts/common.md#clear-and-simple-design One function with two phases: grouping, then prefix computation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The extension name is part of the generated document contract; no other name is assumed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states how the name and the path are chosen.
+     */
     const analyze: (routes: IHttpMigrateRoute[]) => INestiaMigrateController[];
     /**
      * The route's path as NestJS reads it: each path parameter under the key its
@@ -13,6 +50,14 @@ export declare namespace NestiaMigrateControllerAnalyzer {
      * A literal character the router reserves is escaped, so an AIP custom
      * method's `/items:batchGet` stays a literal rather than a parameter
      * `batchGet`, and `(` or `*` no syntax error.
+     *
+     * This operation emits router protocol spelling and does not select native
+     * filenames or filesystem identities.
+     *
+     * @evidence contracts/common.md#principled-implementation The path template is split into literal and parameter segments, and every character that path-to-regexp treats specially in a literal is escaped with a backslash, so a literal never changes the route's meaning.
+     * @evidence contracts/common.md#clear-and-simple-design One expression over the shared path segmenter.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The reserved set is the router's syntax and is applied to every literal.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the escaping and the parameter form.
      */
     const routePath: (route: IHttpMigrateRoute) => string;
 }