@typia/utils 13.0.0-dev.20260427-3 → 13.0.0-dev.20260430

package/lib/http/internal/HttpMigrateRouteComposer2.mjs

@@ -1,384 +1,379 @@
-import { __exports as HttpMigrateRouteComposer } from '../../_virtual/HttpMigrateRouteComposer.mjs';
-import { __require as requireNamingConvention } from '../../utils/NamingConvention2.mjs';
-import { __require as requireEndpointUtil } from '../../utils/internal/EndpointUtil2.mjs';
-import { __require as requireOpenApiTypeChecker } from '../../validators/OpenApiTypeChecker2.mjs';
+import { __exports as HttpMigrateRouteComposer$1 } from '../../_virtual/HttpMigrateRouteComposer.mjs';
+import '../../utils/NamingConvention2.mjs';
+import '../../utils/internal/EndpointUtil2.mjs';
+import '../../validators/OpenApiTypeChecker2.mjs';
+import { __exports as EndpointUtil } from '../../_virtual/EndpointUtil.mjs';
+import { __exports as OpenApiTypeChecker } from '../../_virtual/OpenApiTypeChecker.mjs';
+import { __exports as NamingConvention } from '../../_virtual/NamingConvention.mjs';
 
-var hasRequiredHttpMigrateRouteComposer;
+Object.defineProperty(HttpMigrateRouteComposer$1, "__esModule", { value: true });
+var HttpMigrateRouteComposer_2 = HttpMigrateRouteComposer$1.HttpMigrateRouteComposer = void 0;
+const NamingConvention_1 = NamingConvention;
+const EndpointUtil_1 = EndpointUtil;
+const OpenApiTypeChecker_1 = OpenApiTypeChecker;
+var HttpMigrateRouteComposer;
+(function (HttpMigrateRouteComposer) {
+    HttpMigrateRouteComposer.compose = (props) => {
+        var _a, _b, _c, _d, _e;
+        //----
+        // REQUEST AND RESPONSE BODY
+        //----
+        const body = emplaceBodySchema("request")((schema) => emplaceReference({
+            document: props.document,
+            name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
+                "." +
+                EndpointUtil_1.EndpointUtil.pascal(`${props.method}/Body`),
+            schema,
+        }))(props.operation.requestBody);
+        const success = (() => {
+            var _a, _b, _c, _d, _e;
+            var _f, _g;
+            const body = emplaceBodySchema("response")((schema) => emplaceReference({
+                document: props.document,
+                name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
+                    "." +
+                    EndpointUtil_1.EndpointUtil.pascal(`${props.method}/Response`),
+                schema,
+            }))((_g = (_f = (_a = props.operation.responses) === null || _a === void 0 ? void 0 : _a["201"]) !== null && _f !== void 0 ? _f : (_b = props.operation.responses) === null || _b === void 0 ? void 0 : _b["200"]) !== null && _g !== void 0 ? _g : (_c = props.operation.responses) === null || _c === void 0 ? void 0 : _c.default);
+            return body
+                ? Object.assign(Object.assign({}, body), { status: ((_d = props.operation.responses) === null || _d === void 0 ? void 0 : _d["201"])
+                        ? "201"
+                        : ((_e = props.operation.responses) === null || _e === void 0 ? void 0 : _e["200"])
+                            ? "200"
+                            : "default" }) : body;
+        })();
+        const failures = [];
+        if (body === false)
+            failures.push(`supports only "application/json", "application/x-www-form-urlencoded", "multipart/form-data" and "text/plain" content type in the request body.`);
+        if (success === false)
+            failures.push(`supports only "application/json", "application/x-www-form-urlencoded" and "text/plain" content type in the response body.`);
+        //----
+        // HEADERS AND QUERY
+        //---
+        const [headers, query] = ["header", "query"].map((type) => {
+            var _a, _b, _c, _d;
+            // FIND TARGET PARAMETERS
+            const parameters = ((_a = props.operation.parameters) !== null && _a !== void 0 ? _a : []).filter((p) => p.in === type);
+            if (parameters.length === 0)
+                return null;
+            // CHECK PARAMETER TYPES -> TO BE OBJECT
+            const objects = parameters
+                .map((p) => { var _a; var _b; return OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(p.schema)
+                ? p.schema
+                : OpenApiTypeChecker_1.OpenApiTypeChecker.isReference(p.schema) &&
+                    OpenApiTypeChecker_1.OpenApiTypeChecker.isObject((_b = (_a = props.document.components.schemas) === null || _a === void 0 ? void 0 : _a[p.schema.$ref.replace(`#/components/schemas/`, ``)]) !== null && _b !== void 0 ? _b : {})
+                    ? p.schema
+                    : null; })
+                .filter((s) => !!s);
+            const primitives = parameters.filter((p) => OpenApiTypeChecker_1.OpenApiTypeChecker.isBoolean(p.schema) ||
+                OpenApiTypeChecker_1.OpenApiTypeChecker.isInteger(p.schema) ||
+                OpenApiTypeChecker_1.OpenApiTypeChecker.isNumber(p.schema) ||
+                OpenApiTypeChecker_1.OpenApiTypeChecker.isString(p.schema) ||
+                OpenApiTypeChecker_1.OpenApiTypeChecker.isArray(p.schema) ||
+                OpenApiTypeChecker_1.OpenApiTypeChecker.isTuple(p.schema));
+            const out = (elem) => (Object.assign(Object.assign({}, elem), { name: type, key: type, title: () => elem.title, description: () => elem.description, example: () => elem.example, examples: () => elem.examples }));
+            if (objects.length === 1 && primitives.length === 0)
+                return out(parameters[0]);
+            else if (objects.length > 1) {
+                failures.push(`${type} typed parameters must be only one object type`);
+                return false;
+            }
+            // GATHER TO OBJECT TYPE
+            const dto = objects[0]
+                ? OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(objects[0])
+                    ? objects[0]
+                    : ((_b = props.document.components.schemas) !== null && _b !== void 0 ? _b : {})[objects[0].$ref.replace(`#/components/schemas/`, ``)]
+                : null;
+            const entire = [
+                ...objects.map((o) => { var _a; return OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(o)
+                    ? o
+                    : (_a = props.document.components.schemas) === null || _a === void 0 ? void 0 : _a[o.$ref.replace(`#/components/schemas/`, ``)]; }),
+                {
+                    type: "object",
+                    properties: Object.fromEntries([
+                        ...primitives.map((p) => { var _a; return [
+                            p.name,
+                            Object.assign(Object.assign({}, p.schema), { description: (_a = p.schema.description) !== null && _a !== void 0 ? _a : p.description }),
+                        ]; }),
+                        ...(dto ? Object.entries((_c = dto.properties) !== null && _c !== void 0 ? _c : {}) : []),
+                    ]),
+                    required: [
+                        ...new Set([
+                            ...primitives.filter((p) => p.required).map((p) => p.name),
+                            ...((_d = dto === null || dto === void 0 ? void 0 : dto.required) !== null && _d !== void 0 ? _d : []),
+                        ]),
+                    ],
+                },
+            ];
+            return parameters.length === 0
+                ? null
+                : out({
+                    schema: emplaceReference({
+                        document: props.document,
+                        name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
+                            "." +
+                            EndpointUtil_1.EndpointUtil.pascal(`${props.method}/${type}`),
+                        schema: {
+                            type: "object",
+                            properties: Object.fromEntries([
+                                ...new Map(entire
+                                    .map((o) => { var _a; return Object.entries((_a = o.properties) !== null && _a !== void 0 ? _a : {}).map(([name, schema]) => { var _a; return [
+                                    name,
+                                    Object.assign(Object.assign({}, schema), { description: (_a = schema.description) !== null && _a !== void 0 ? _a : schema.description }),
+                                ]; }); })
+                                    .flat()),
+                            ]),
+                            required: [
+                                ...new Set(entire.map((o) => { var _a; return (_a = o.required) !== null && _a !== void 0 ? _a : []; }).flat()),
+                            ],
+                        },
+                    }),
+                });
+        });
+        //----
+        // PATH PARAMETERS
+        //----
+        const parameterNames = EndpointUtil_1.EndpointUtil.splitWithNormalization(props.emendedPath)
+            .filter((str) => str[0] === ":")
+            .map((str) => str.substring(1));
+        const pathParameters = ((_a = props.operation.parameters) !== null && _a !== void 0 ? _a : []).filter((p) => p.in === "path");
+        if (parameterNames.length !== pathParameters.length)
+            if (pathParameters.length < parameterNames.length &&
+                pathParameters.every((p) => p.name !== undefined && parameterNames.includes(p.name))) {
+                for (const name of parameterNames)
+                    if (pathParameters.find((p) => p.name === name) === undefined)
+                        pathParameters.push({
+                            name,
+                            in: "path",
+                            schema: { type: "string" },
+                        });
+                pathParameters.sort((a, b) => parameterNames.indexOf(a.name) - parameterNames.indexOf(b.name));
+                props.operation.parameters = [
+                    ...pathParameters,
+                    ...((_b = props.operation.parameters) !== null && _b !== void 0 ? _b : []).filter((p) => p.in !== "path"),
+                ];
+            }
+            else
+                failures.push("number of path parameters are not matched with its full path.");
+        if (failures.length)
+            return failures;
+        const parameters = ((_c = props.operation.parameters) !== null && _c !== void 0 ? _c : [])
+            .filter((p) => p.in === "path")
+            .map((p, i) => ({
+            // FILL KEY NAME IF NOT EXISTS
+            name: parameterNames[i],
+            key: (() => {
+                let key = EndpointUtil_1.EndpointUtil.normalize(parameterNames[i]);
+                if (NamingConvention_1.NamingConvention.variable(key))
+                    return key;
+                while (true) {
+                    key = "_" + key;
+                    if (!parameterNames.some((s) => s === key))
+                        return key;
+                }
+            })(),
+            schema: p.schema,
+            parameter: () => p,
+        }));
+        return {
+            method: props.method,
+            path: props.path,
+            emendedPath: props.emendedPath,
+            accessor: ["@lazy"],
+            parameters: ((_d = props.operation.parameters) !== null && _d !== void 0 ? _d : [])
+                .filter((p) => p.in === "path")
+                .map((p, i) => ({
+                // FILL KEY NAME IF NOT EXISTS
+                name: parameterNames[i],
+                key: (() => {
+                    let key = EndpointUtil_1.EndpointUtil.normalize(parameterNames[i]);
+                    if (NamingConvention_1.NamingConvention.variable(key))
+                        return key;
+                    while (true) {
+                        key = "_" + key;
+                        if (!parameterNames.some((s) => s === key))
+                            return key;
+                    }
+                })(),
+                schema: p.schema,
+                parameter: () => p,
+            })),
+            headers: headers || null,
+            query: query || null,
+            body: body || null,
+            success: success || null,
+            exceptions: Object.fromEntries(Object.entries((_e = props.operation.responses) !== null && _e !== void 0 ? _e : {})
+                .filter(([key]) => key !== "200" && key !== "201" && key !== "default")
+                .map(([status, response]) => { var _a, _b; var _c; return [
+                status,
+                {
+                    schema: ((_c = (_b = (_a = response.content) === null || _a === void 0 ? void 0 : _a["application/json"]) === null || _b === void 0 ? void 0 : _b.schema) !== null && _c !== void 0 ? _c : {}),
+                    response: () => response,
+                    media: () => { var _a; var _b; return ((_b = (_a = response.content) === null || _a === void 0 ? void 0 : _a["application/json"]) !== null && _b !== void 0 ? _b : {}); },
+                },
+            ]; })),
+            comment: () => writeRouteComment({
+                operation: props.operation,
+                parameters,
+                body: body || null,
+            }),
+            operation: () => props.operation,
+        };
+    };
+    const writeRouteComment = (props) => {
+        var _a, _b, _c;
+        var _d, _e, _f;
+        // write basic description combining with summary
+        let description = (_d = props.operation.description) !== null && _d !== void 0 ? _d : "";
+        if (!!((_a = props.operation.summary) === null || _a === void 0 ? void 0 : _a.length)) {
+            const summary = props.operation.summary.endsWith(".")
+                ? props.operation.summary
+                : props.operation.summary + ".";
+            if (!!description.length &&
+                !description.startsWith(props.operation.summary))
+                description = `${summary}\n\n${description}`;
+        }
+        description = description
+            .split("\n")
+            .map((s) => s.trim())
+            .join("\n");
+        //----
+        // compose jsdoc comment tags
+        //----
+        const commentTags = [];
+        const add = (text) => {
+            if (commentTags.every((line) => line !== text))
+                commentTags.push(text);
+        };
+        // parameters
+        add("@param connection");
+        for (const p of (_e = props.parameters) !== null && _e !== void 0 ? _e : []) {
+            const param = p.parameter();
+            if (param.description) {
+                const text = param.description;
+                add(`@param ${p.name} ${writeIndented(text, p.name.length + 8)}`);
+            }
+        }
+        if ((_c = (_b = props.body) === null || _b === void 0 ? void 0 : _b.description()) === null || _c === void 0 ? void 0 : _c.length)
+            add(`@param body ${writeIndented(props.body.description(), 12)}`);
+        // security
+        for (const security of (_f = props.operation.security) !== null && _f !== void 0 ? _f : [])
+            for (const [name, scopes] of Object.entries(security))
+                add(`@security ${[name, ...scopes].join("")}`);
+        // categorizing tags
+        if (props.operation.tags)
+            props.operation.tags.forEach((name) => add(`@tag ${name}`));
+        // deprecated
+        if (props.operation.deprecated)
+            add("@deprecated");
+        // plugin properties
+        for (const [key, value] of Object.entries(props.operation)) {
+            if (key.startsWith("x-") === false)
+                continue;
+            else if (value !== null &&
+                typeof value !== "boolean" &&
+                typeof value !== "number" &&
+                typeof value !== "string")
+                continue;
+            add(`@${key} ${value}`);
+        }
+        // finalize description
+        description = description.length
+            ? commentTags.length
+                ? `${description}\n\n${commentTags.join("\n")}`
+                : description
+            : commentTags.join("\n");
+        description = description.split("*/").join("*\\/");
+        return description;
+    };
+    const writeIndented = (text, spaces) => text
+        .split("\n")
+        .map((s) => s.trim())
+        .map((s, i) => (i === 0 ? s : `${" ".repeat(spaces)}${s}`))
+        .join("\n");
+    const emplaceBodySchema = (from) => (emplacer) => (meta) => {
+        if (!(meta === null || meta === void 0 ? void 0 : meta.content))
+            return null;
+        const entries = Object.entries(meta.content).filter(([_, v]) => !!v);
+        const json = entries.find((e) => meta["x-nestia-encrypted"] === true
+            ? e[0].includes("text/plain") || e[0].includes("application/json")
+            : e[0].includes("application/json") || e[0].includes("*/*"));
+        if (json) {
+            const { schema } = json[1];
+            return schema
+                ? {
+                    type: "application/json",
+                    name: "body",
+                    key: "body",
+                    schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+                    description: () => meta.description,
+                    media: () => json[1],
+                    "x-nestia-encrypted": meta["x-nestia-encrypted"],
+                }
+                : null;
+        }
+        const query = entries.find((e) => e[0].includes("application/x-www-form-urlencoded"));
+        if (query) {
+            const { schema } = query[1];
+            return schema
+                ? {
+                    type: "application/x-www-form-urlencoded",
+                    name: "body",
+                    key: "body",
+                    schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
+                    description: () => meta.description,
+                    media: () => query[1],
+                }
+                : null;
+        }
+        const text = entries.find((e) => e[0].includes("text/plain"));
+        if (text)
+            return {
+                type: "text/plain",
+                name: "body",
+                key: "body",
+                schema: { type: "string" },
+                description: () => meta.description,
+                media: () => text[1],
+            };
+        if (from === "request") {
+            const multipart = entries.find((e) => e[0].includes("multipart/form-data"));
+            if (multipart) {
+                const { schema } = multipart[1];
+                return {
+                    type: "multipart/form-data",
+                    name: "body",
+                    key: "body",
+                    schema: schema
+                        ? isNotObjectLiteral(schema)
+                            ? schema
+                            : emplacer(schema)
+                        : {},
+                    description: () => meta.description,
+                    media: () => multipart[1],
+                };
+            }
+        }
+        return false;
+    };
+    const emplaceReference = (props) => {
+        var _a;
+        var _b;
+        (_a = (_b = props.document.components).schemas) !== null && _a !== void 0 ? _a : (_b.schemas = {});
+        props.document.components.schemas[props.name] = props.schema;
+        return {
+            $ref: `#/components/schemas/${props.name}`,
+        };
+    };
+    const isNotObjectLiteral = (schema) => OpenApiTypeChecker_1.OpenApiTypeChecker.isReference(schema) ||
+        OpenApiTypeChecker_1.OpenApiTypeChecker.isBoolean(schema) ||
+        OpenApiTypeChecker_1.OpenApiTypeChecker.isNumber(schema) ||
+        OpenApiTypeChecker_1.OpenApiTypeChecker.isString(schema) ||
+        OpenApiTypeChecker_1.OpenApiTypeChecker.isUnknown(schema) ||
+        (OpenApiTypeChecker_1.OpenApiTypeChecker.isOneOf(schema) &&
+            schema.oneOf.every(isNotObjectLiteral)) ||
+        (OpenApiTypeChecker_1.OpenApiTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
+})(HttpMigrateRouteComposer || (HttpMigrateRouteComposer_2 = HttpMigrateRouteComposer$1.HttpMigrateRouteComposer = HttpMigrateRouteComposer = {}));
 
-function requireHttpMigrateRouteComposer () {
-	if (hasRequiredHttpMigrateRouteComposer) return HttpMigrateRouteComposer;
-	hasRequiredHttpMigrateRouteComposer = 1;
-	Object.defineProperty(HttpMigrateRouteComposer, "__esModule", { value: true });
-	HttpMigrateRouteComposer.HttpMigrateRouteComposer = void 0;
-	const NamingConvention_1 = requireNamingConvention();
-	const EndpointUtil_1 = requireEndpointUtil();
-	const OpenApiTypeChecker_1 = requireOpenApiTypeChecker();
-	var HttpMigrateRouteComposer$1;
-	(function (HttpMigrateRouteComposer) {
-	    HttpMigrateRouteComposer.compose = (props) => {
-	        var _a, _b, _c, _d, _e;
-	        //----
-	        // REQUEST AND RESPONSE BODY
-	        //----
-	        const body = emplaceBodySchema("request")((schema) => emplaceReference({
-	            document: props.document,
-	            name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
-	                "." +
-	                EndpointUtil_1.EndpointUtil.pascal(`${props.method}/Body`),
-	            schema,
-	        }))(props.operation.requestBody);
-	        const success = (() => {
-	            var _a, _b, _c, _d, _e;
-	            var _f, _g;
-	            const body = emplaceBodySchema("response")((schema) => emplaceReference({
-	                document: props.document,
-	                name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
-	                    "." +
-	                    EndpointUtil_1.EndpointUtil.pascal(`${props.method}/Response`),
-	                schema,
-	            }))((_g = (_f = (_a = props.operation.responses) === null || _a === void 0 ? void 0 : _a["201"]) !== null && _f !== void 0 ? _f : (_b = props.operation.responses) === null || _b === void 0 ? void 0 : _b["200"]) !== null && _g !== void 0 ? _g : (_c = props.operation.responses) === null || _c === void 0 ? void 0 : _c.default);
-	            return body
-	                ? Object.assign(Object.assign({}, body), { status: ((_d = props.operation.responses) === null || _d === void 0 ? void 0 : _d["201"])
-	                        ? "201"
-	                        : ((_e = props.operation.responses) === null || _e === void 0 ? void 0 : _e["200"])
-	                            ? "200"
-	                            : "default" }) : body;
-	        })();
-	        const failures = [];
-	        if (body === false)
-	            failures.push(`supports only "application/json", "application/x-www-form-urlencoded", "multipart/form-data" and "text/plain" content type in the request body.`);
-	        if (success === false)
-	            failures.push(`supports only "application/json", "application/x-www-form-urlencoded" and "text/plain" content type in the response body.`);
-	        //----
-	        // HEADERS AND QUERY
-	        //---
-	        const [headers, query] = ["header", "query"].map((type) => {
-	            var _a, _b, _c, _d;
-	            // FIND TARGET PARAMETERS
-	            const parameters = ((_a = props.operation.parameters) !== null && _a !== void 0 ? _a : []).filter((p) => p.in === type);
-	            if (parameters.length === 0)
-	                return null;
-	            // CHECK PARAMETER TYPES -> TO BE OBJECT
-	            const objects = parameters
-	                .map((p) => { var _a; var _b; return OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(p.schema)
-	                ? p.schema
-	                : OpenApiTypeChecker_1.OpenApiTypeChecker.isReference(p.schema) &&
-	                    OpenApiTypeChecker_1.OpenApiTypeChecker.isObject((_b = (_a = props.document.components.schemas) === null || _a === void 0 ? void 0 : _a[p.schema.$ref.replace(`#/components/schemas/`, ``)]) !== null && _b !== void 0 ? _b : {})
-	                    ? p.schema
-	                    : null; })
-	                .filter((s) => !!s);
-	            const primitives = parameters.filter((p) => OpenApiTypeChecker_1.OpenApiTypeChecker.isBoolean(p.schema) ||
-	                OpenApiTypeChecker_1.OpenApiTypeChecker.isInteger(p.schema) ||
-	                OpenApiTypeChecker_1.OpenApiTypeChecker.isNumber(p.schema) ||
-	                OpenApiTypeChecker_1.OpenApiTypeChecker.isString(p.schema) ||
-	                OpenApiTypeChecker_1.OpenApiTypeChecker.isArray(p.schema) ||
-	                OpenApiTypeChecker_1.OpenApiTypeChecker.isTuple(p.schema));
-	            const out = (elem) => (Object.assign(Object.assign({}, elem), { name: type, key: type, title: () => elem.title, description: () => elem.description, example: () => elem.example, examples: () => elem.examples }));
-	            if (objects.length === 1 && primitives.length === 0)
-	                return out(parameters[0]);
-	            else if (objects.length > 1) {
-	                failures.push(`${type} typed parameters must be only one object type`);
-	                return false;
-	            }
-	            // GATHER TO OBJECT TYPE
-	            const dto = objects[0]
-	                ? OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(objects[0])
-	                    ? objects[0]
-	                    : ((_b = props.document.components.schemas) !== null && _b !== void 0 ? _b : {})[objects[0].$ref.replace(`#/components/schemas/`, ``)]
-	                : null;
-	            const entire = [
-	                ...objects.map((o) => { var _a; return OpenApiTypeChecker_1.OpenApiTypeChecker.isObject(o)
-	                    ? o
-	                    : (_a = props.document.components.schemas) === null || _a === void 0 ? void 0 : _a[o.$ref.replace(`#/components/schemas/`, ``)]; }),
-	                {
-	                    type: "object",
-	                    properties: Object.fromEntries([
-	                        ...primitives.map((p) => { var _a; return [
-	                            p.name,
-	                            Object.assign(Object.assign({}, p.schema), { description: (_a = p.schema.description) !== null && _a !== void 0 ? _a : p.description }),
-	                        ]; }),
-	                        ...(dto ? Object.entries((_c = dto.properties) !== null && _c !== void 0 ? _c : {}) : []),
-	                    ]),
-	                    required: [
-	                        ...new Set([
-	                            ...primitives.filter((p) => p.required).map((p) => p.name),
-	                            ...((_d = dto === null || dto === void 0 ? void 0 : dto.required) !== null && _d !== void 0 ? _d : []),
-	                        ]),
-	                    ],
-	                },
-	            ];
-	            return parameters.length === 0
-	                ? null
-	                : out({
-	                    schema: emplaceReference({
-	                        document: props.document,
-	                        name: EndpointUtil_1.EndpointUtil.pascal(`I/Api/${props.path}`) +
-	                            "." +
-	                            EndpointUtil_1.EndpointUtil.pascal(`${props.method}/${type}`),
-	                        schema: {
-	                            type: "object",
-	                            properties: Object.fromEntries([
-	                                ...new Map(entire
-	                                    .map((o) => { var _a; return Object.entries((_a = o.properties) !== null && _a !== void 0 ? _a : {}).map(([name, schema]) => { var _a; return [
-	                                    name,
-	                                    Object.assign(Object.assign({}, schema), { description: (_a = schema.description) !== null && _a !== void 0 ? _a : schema.description }),
-	                                ]; }); })
-	                                    .flat()),
-	                            ]),
-	                            required: [
-	                                ...new Set(entire.map((o) => { var _a; return (_a = o.required) !== null && _a !== void 0 ? _a : []; }).flat()),
-	                            ],
-	                        },
-	                    }),
-	                });
-	        });
-	        //----
-	        // PATH PARAMETERS
-	        //----
-	        const parameterNames = EndpointUtil_1.EndpointUtil.splitWithNormalization(props.emendedPath)
-	            .filter((str) => str[0] === ":")
-	            .map((str) => str.substring(1));
-	        const pathParameters = ((_a = props.operation.parameters) !== null && _a !== void 0 ? _a : []).filter((p) => p.in === "path");
-	        if (parameterNames.length !== pathParameters.length)
-	            if (pathParameters.length < parameterNames.length &&
-	                pathParameters.every((p) => p.name !== undefined && parameterNames.includes(p.name))) {
-	                for (const name of parameterNames)
-	                    if (pathParameters.find((p) => p.name === name) === undefined)
-	                        pathParameters.push({
-	                            name,
-	                            in: "path",
-	                            schema: { type: "string" },
-	                        });
-	                pathParameters.sort((a, b) => parameterNames.indexOf(a.name) - parameterNames.indexOf(b.name));
-	                props.operation.parameters = [
-	                    ...pathParameters,
-	                    ...((_b = props.operation.parameters) !== null && _b !== void 0 ? _b : []).filter((p) => p.in !== "path"),
-	                ];
-	            }
-	            else
-	                failures.push("number of path parameters are not matched with its full path.");
-	        if (failures.length)
-	            return failures;
-	        const parameters = ((_c = props.operation.parameters) !== null && _c !== void 0 ? _c : [])
-	            .filter((p) => p.in === "path")
-	            .map((p, i) => ({
-	            // FILL KEY NAME IF NOT EXISTS
-	            name: parameterNames[i],
-	            key: (() => {
-	                let key = EndpointUtil_1.EndpointUtil.normalize(parameterNames[i]);
-	                if (NamingConvention_1.NamingConvention.variable(key))
-	                    return key;
-	                while (true) {
-	                    key = "_" + key;
-	                    if (!parameterNames.some((s) => s === key))
-	                        return key;
-	                }
-	            })(),
-	            schema: p.schema,
-	            parameter: () => p,
-	        }));
-	        return {
-	            method: props.method,
-	            path: props.path,
-	            emendedPath: props.emendedPath,
-	            accessor: ["@lazy"],
-	            parameters: ((_d = props.operation.parameters) !== null && _d !== void 0 ? _d : [])
-	                .filter((p) => p.in === "path")
-	                .map((p, i) => ({
-	                // FILL KEY NAME IF NOT EXISTS
-	                name: parameterNames[i],
-	                key: (() => {
-	                    let key = EndpointUtil_1.EndpointUtil.normalize(parameterNames[i]);
-	                    if (NamingConvention_1.NamingConvention.variable(key))
-	                        return key;
-	                    while (true) {
-	                        key = "_" + key;
-	                        if (!parameterNames.some((s) => s === key))
-	                            return key;
-	                    }
-	                })(),
-	                schema: p.schema,
-	                parameter: () => p,
-	            })),
-	            headers: headers || null,
-	            query: query || null,
-	            body: body || null,
-	            success: success || null,
-	            exceptions: Object.fromEntries(Object.entries((_e = props.operation.responses) !== null && _e !== void 0 ? _e : {})
-	                .filter(([key]) => key !== "200" && key !== "201" && key !== "default")
-	                .map(([status, response]) => { var _a, _b; var _c; return [
-	                status,
-	                {
-	                    schema: ((_c = (_b = (_a = response.content) === null || _a === void 0 ? void 0 : _a["application/json"]) === null || _b === void 0 ? void 0 : _b.schema) !== null && _c !== void 0 ? _c : {}),
-	                    response: () => response,
-	                    media: () => { var _a; var _b; return ((_b = (_a = response.content) === null || _a === void 0 ? void 0 : _a["application/json"]) !== null && _b !== void 0 ? _b : {}); },
-	                },
-	            ]; })),
-	            comment: () => writeRouteComment({
-	                operation: props.operation,
-	                parameters,
-	                body: body || null,
-	            }),
-	            operation: () => props.operation,
-	        };
-	    };
-	    const writeRouteComment = (props) => {
-	        var _a, _b, _c;
-	        var _d, _e, _f;
-	        // write basic description combining with summary
-	        let description = (_d = props.operation.description) !== null && _d !== void 0 ? _d : "";
-	        if (!!((_a = props.operation.summary) === null || _a === void 0 ? void 0 : _a.length)) {
-	            const summary = props.operation.summary.endsWith(".")
-	                ? props.operation.summary
-	                : props.operation.summary + ".";
-	            if (!!description.length &&
-	                !description.startsWith(props.operation.summary))
-	                description = `${summary}\n\n${description}`;
-	        }
-	        description = description
-	            .split("\n")
-	            .map((s) => s.trim())
-	            .join("\n");
-	        //----
-	        // compose jsdoc comment tags
-	        //----
-	        const commentTags = [];
-	        const add = (text) => {
-	            if (commentTags.every((line) => line !== text))
-	                commentTags.push(text);
-	        };
-	        // parameters
-	        add("@param connection");
-	        for (const p of (_e = props.parameters) !== null && _e !== void 0 ? _e : []) {
-	            const param = p.parameter();
-	            if (param.description) {
-	                const text = param.description;
-	                add(`@param ${p.name} ${writeIndented(text, p.name.length + 8)}`);
-	            }
-	        }
-	        if ((_c = (_b = props.body) === null || _b === void 0 ? void 0 : _b.description()) === null || _c === void 0 ? void 0 : _c.length)
-	            add(`@param body ${writeIndented(props.body.description(), 12)}`);
-	        // security
-	        for (const security of (_f = props.operation.security) !== null && _f !== void 0 ? _f : [])
-	            for (const [name, scopes] of Object.entries(security))
-	                add(`@security ${[name, ...scopes].join("")}`);
-	        // categorizing tags
-	        if (props.operation.tags)
-	            props.operation.tags.forEach((name) => add(`@tag ${name}`));
-	        // deprecated
-	        if (props.operation.deprecated)
-	            add("@deprecated");
-	        // plugin properties
-	        for (const [key, value] of Object.entries(props.operation)) {
-	            if (key.startsWith("x-") === false)
-	                continue;
-	            else if (value !== null &&
-	                typeof value !== "boolean" &&
-	                typeof value !== "number" &&
-	                typeof value !== "string")
-	                continue;
-	            add(`@${key} ${value}`);
-	        }
-	        // finalize description
-	        description = description.length
-	            ? commentTags.length
-	                ? `${description}\n\n${commentTags.join("\n")}`
-	                : description
-	            : commentTags.join("\n");
-	        description = description.split("*/").join("*\\/");
-	        return description;
-	    };
-	    const writeIndented = (text, spaces) => text
-	        .split("\n")
-	        .map((s) => s.trim())
-	        .map((s, i) => (i === 0 ? s : `${" ".repeat(spaces)}${s}`))
-	        .join("\n");
-	    const emplaceBodySchema = (from) => (emplacer) => (meta) => {
-	        if (!(meta === null || meta === void 0 ? void 0 : meta.content))
-	            return null;
-	        const entries = Object.entries(meta.content).filter(([_, v]) => !!v);
-	        const json = entries.find((e) => meta["x-nestia-encrypted"] === true
-	            ? e[0].includes("text/plain") || e[0].includes("application/json")
-	            : e[0].includes("application/json") || e[0].includes("*/*"));
-	        if (json) {
-	            const { schema } = json[1];
-	            return schema
-	                ? {
-	                    type: "application/json",
-	                    name: "body",
-	                    key: "body",
-	                    schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
-	                    description: () => meta.description,
-	                    media: () => json[1],
-	                    "x-nestia-encrypted": meta["x-nestia-encrypted"],
-	                }
-	                : null;
-	        }
-	        const query = entries.find((e) => e[0].includes("application/x-www-form-urlencoded"));
-	        if (query) {
-	            const { schema } = query[1];
-	            return schema
-	                ? {
-	                    type: "application/x-www-form-urlencoded",
-	                    name: "body",
-	                    key: "body",
-	                    schema: isNotObjectLiteral(schema) ? schema : emplacer(schema),
-	                    description: () => meta.description,
-	                    media: () => query[1],
-	                }
-	                : null;
-	        }
-	        const text = entries.find((e) => e[0].includes("text/plain"));
-	        if (text)
-	            return {
-	                type: "text/plain",
-	                name: "body",
-	                key: "body",
-	                schema: { type: "string" },
-	                description: () => meta.description,
-	                media: () => text[1],
-	            };
-	        if (from === "request") {
-	            const multipart = entries.find((e) => e[0].includes("multipart/form-data"));
-	            if (multipart) {
-	                const { schema } = multipart[1];
-	                return {
-	                    type: "multipart/form-data",
-	                    name: "body",
-	                    key: "body",
-	                    schema: schema
-	                        ? isNotObjectLiteral(schema)
-	                            ? schema
-	                            : emplacer(schema)
-	                        : {},
-	                    description: () => meta.description,
-	                    media: () => multipart[1],
-	                };
-	            }
-	        }
-	        return false;
-	    };
-	    const emplaceReference = (props) => {
-	        var _a;
-	        var _b;
-	        (_a = (_b = props.document.components).schemas) !== null && _a !== void 0 ? _a : (_b.schemas = {});
-	        props.document.components.schemas[props.name] = props.schema;
-	        return {
-	            $ref: `#/components/schemas/${props.name}`,
-	        };
-	    };
-	    const isNotObjectLiteral = (schema) => OpenApiTypeChecker_1.OpenApiTypeChecker.isReference(schema) ||
-	        OpenApiTypeChecker_1.OpenApiTypeChecker.isBoolean(schema) ||
-	        OpenApiTypeChecker_1.OpenApiTypeChecker.isNumber(schema) ||
-	        OpenApiTypeChecker_1.OpenApiTypeChecker.isString(schema) ||
-	        OpenApiTypeChecker_1.OpenApiTypeChecker.isUnknown(schema) ||
-	        (OpenApiTypeChecker_1.OpenApiTypeChecker.isOneOf(schema) &&
-	            schema.oneOf.every(isNotObjectLiteral)) ||
-	        (OpenApiTypeChecker_1.OpenApiTypeChecker.isArray(schema) && isNotObjectLiteral(schema.items));
-	})(HttpMigrateRouteComposer$1 || (HttpMigrateRouteComposer.HttpMigrateRouteComposer = HttpMigrateRouteComposer$1 = {}));
-	
-	return HttpMigrateRouteComposer;
-}
-
-export { requireHttpMigrateRouteComposer as __require };
+export { HttpMigrateRouteComposer_2 as HttpMigrateRouteComposer, HttpMigrateRouteComposer$1 as default };
 //# sourceMappingURL=HttpMigrateRouteComposer2.mjs.map