@nestia/migrate 0.10.0 → 0.11.1

package/lib/utils/openapi-down-convert/converter.js

@@ -0,0 +1,431 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Converter = void 0;
+/** OpenAPI Down Converted - convert an OAS document from OAS 3.1 to OAS 3.0 */
+const RefVisitor_1 = require("./RefVisitor");
+class Converter {
+    /**
+     * Construct a new Converter
+     * @throws Error if the scopeDescriptionFile (if specified) cannot be read or parsed as YAML/JSON
+     */
+    constructor(openapiDocument, options) {
+        this.verbose = false;
+        this.deleteExampleWithId = false;
+        this.allOfTransform = false;
+        this.scopeDescriptions = undefined;
+        this.convertSchemaComments = false;
+        this.returnCode = 0;
+        this.openapi30 = Converter.deepClone(openapiDocument);
+        this.verbose = Boolean(options === null || options === void 0 ? void 0 : options.verbose);
+        this.deleteExampleWithId = Boolean(options === null || options === void 0 ? void 0 : options.deleteExampleWithId);
+        this.allOfTransform = Boolean(options === null || options === void 0 ? void 0 : options.allOfTransform);
+        this.authorizationUrl =
+            (options === null || options === void 0 ? void 0 : options.authorizationUrl) || "https://www.example.com/oauth2/authorize";
+        this.tokenUrl = (options === null || options === void 0 ? void 0 : options.tokenUrl) || "https://www.example.com/oauth2/token";
+        this.loadScopeDescriptions(options === null || options === void 0 ? void 0 : options.scopeDescriptionFile);
+        this.convertSchemaComments = !!(options === null || options === void 0 ? void 0 : options.convertSchemaComments);
+    }
+    /** Load the scopes.yaml file and save in this.scopeDescriptions
+     * @throws Error if the file cannot be read or parsed as YAML/JSON
+     */
+    loadScopeDescriptions(scopeDescriptionFile) {
+        if (!scopeDescriptionFile) {
+            return;
+        }
+    }
+    /**
+     * Log a message  to console.warn stream if verbose is true
+     * @param message parameters for console.warn
+     */
+    log(...message) {
+        if (this.verbose) {
+            this.warn(...message);
+        }
+    }
+    /**
+     * Log a message  to console.warn stream. Prefix the message string with `Warning: `
+     * if it does not already have that text.
+     * @param message parameters for console.warn
+     */
+    warn(...message) {
+        if (!message[0].startsWith("Warning")) {
+            message[0] = `Warning: ${message[0]}`;
+        }
+        console.warn(...message);
+    }
+    /**
+     * Log an error message to `console.error` stream. Prefix the message string with `Error: `
+     * if it does not already start with `'Error'`. Increments the `returnCode`, causing
+     * the CLI to throw an Error when done.
+     * @param message parameters for `console.error`
+     */
+    error(...message) {
+        if (!message[0].startsWith("Error")) {
+            message[0] = `Error: ${message[0]}`;
+        }
+        this.returnCode++;
+        console.error(...message);
+    }
+    /**
+     * Convert the OpenAPI document to 3.0
+     * @returns the converted document. The input is not modified.
+     */
+    convert() {
+        this.log("Converting from OpenAPI 3.1 to 3.0");
+        this.openapi30.openapi = "3.0.3";
+        this.removeLicenseIdentifier();
+        this.convertSchemaRef();
+        this.simplifyNonSchemaRef();
+        if (this.scopeDescriptions) {
+            this.convertSecuritySchemes();
+        }
+        this.convertJsonSchemaExamples();
+        this.convertJsonSchemaContentEncoding();
+        this.convertJsonSchemaContentMediaType();
+        this.convertConstToEnum();
+        this.convertNullableTypeArray();
+        this.removeWebhooksObject();
+        this.removeUnsupportedSchemaKeywords();
+        if (this.convertSchemaComments) {
+            this.renameSchema$comment();
+        }
+        else {
+            this.deleteSchema$comment();
+        }
+        if (this.returnCode > 0) {
+            throw new Error("Cannot down convert this OpenAPI definition.");
+        }
+        return this.openapi30;
+    }
+    /**
+     * OpenAPI 3.1 uses JSON Schema 2020-12 which allows schema `examples`;
+     * OpenAPI 3.0 uses JSON Scheme Draft 7 which only allows `example`.
+     * Replace all `examples` with `example`, using `examples[0]`
+     */
+    convertJsonSchemaExamples() {
+        const schemaVisitor = (schema) => {
+            for (const key in schema) {
+                const subSchema = schema[key];
+                if (subSchema !== null && typeof subSchema === "object") {
+                    if (key === "examples") {
+                        const examples = schema["examples"];
+                        if (Array.isArray(examples) && examples.length > 0) {
+                            delete schema["examples"];
+                            const first = examples[0];
+                            if (this.deleteExampleWithId &&
+                                first != null &&
+                                typeof first === "object" &&
+                                first.hasOwnProperty("id")) {
+                                this.log(`Deleted schema example with \`id\` property:\n${this.json(examples)}`);
+                            }
+                            else {
+                                schema["example"] = first;
+                                this.log(`Replaces examples with examples[0]. Old examples:\n${this.json(examples)}`);
+                            }
+                            // TODO: Add an else here to check example for `id` and delete the example if this.deleteExampleWithId
+                            // We've put most of those in `examples` so this is probably not needed, but it would be more robust.
+                        }
+                    }
+                    else {
+                        schema[key] = (0, RefVisitor_1.walkObject)(subSchema, schemaVisitor);
+                    }
+                }
+            }
+            return schema;
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    walkNestedSchemaObjects(schema, schemaVisitor) {
+        for (const key in schema) {
+            const subSchema = schema[key];
+            if (subSchema !== null && typeof subSchema === "object") {
+                schema[key] = (0, RefVisitor_1.walkObject)(subSchema, schemaVisitor);
+            }
+        }
+        return schema;
+    }
+    /**
+     * OpenAPI 3.1 uses JSON Schema 2020-12 which allows `const`
+     * OpenAPI 3.0 uses JSON Scheme Draft 7 which only allows `enum`.
+     * Replace all `const: value` with `enum: [ value ]`
+     */
+    convertConstToEnum() {
+        const schemaVisitor = (schema) => {
+            if (schema["const"]) {
+                const constant = schema["const"];
+                delete schema["const"];
+                schema["enum"] = [constant];
+                this.log(`Converted const: ${constant} to enum`);
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    /**
+     * Convert 2-element type arrays containing 'null' to
+     * string type and `nullable: true`
+     */
+    convertNullableTypeArray() {
+        const schemaVisitor = (schema) => {
+            if (schema.hasOwnProperty("type")) {
+                const schemaType = schema["type"];
+                if (Array.isArray(schemaType) &&
+                    schemaType.length === 2 &&
+                    schemaType.includes("null")) {
+                    const nonNull = schemaType.filter((_) => _ !== "null")[0];
+                    schema["type"] = nonNull;
+                    schema["nullable"] = true;
+                    this.log(`Converted schema type array to nullable`);
+                }
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    removeWebhooksObject() {
+        if (Object.hasOwnProperty.call(this.openapi30, "webhooks")) {
+            this.log(`Deleted webhooks object`);
+            delete this.openapi30["webhooks"];
+        }
+    }
+    removeUnsupportedSchemaKeywords() {
+        const keywordsToRemove = [
+            "$id",
+            "$schema",
+            "unevaluatedProperties",
+            "contentMediaType",
+            "patternProperties",
+        ];
+        const schemaVisitor = (schema) => {
+            keywordsToRemove.forEach((key) => {
+                if (schema.hasOwnProperty(key)) {
+                    delete schema[key];
+                    this.log(`Removed unsupported schema keyword ${key}`);
+                }
+            });
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    renameSchema$comment() {
+        const schemaVisitor = (schema) => {
+            if (schema.hasOwnProperty("$comment")) {
+                schema["x-comment"] = schema["$comment"];
+                delete schema["$comment"];
+                this.log(`schema $comment renamed to x-comment`);
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    deleteSchema$comment() {
+        const schemaVisitor = (schema) => {
+            if (schema.hasOwnProperty("$comment")) {
+                const comment = schema["$comment"];
+                delete schema["$comment"];
+                this.log(`schema $comment deleted: ${comment}`);
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    /**
+     * Convert
+     * ```
+     * contentMediaType: 'application/octet-stream'
+     * ```
+     * to
+     * ```
+     * format: binary
+     * ```
+     * in `type: string` schemas.
+     * Warn if schema has a `format` already and it is not `binary`.
+     */
+    convertJsonSchemaContentMediaType() {
+        const schemaVisitor = (schema) => {
+            if (schema.hasOwnProperty("type") &&
+                schema["type"] === "string" &&
+                schema.hasOwnProperty("contentMediaType") &&
+                schema["contentMediaType"] === "application/octet-stream") {
+                if (schema.hasOwnProperty("format")) {
+                    if (schema["format"] === "binary") {
+                        this.log(`Deleted schema contentMediaType: application/octet-stream (leaving format: binary)`);
+                        delete schema["contentMediaType"];
+                    }
+                    else {
+                        this.error(`Unable to down-convert schema with contentMediaType: application/octet-stream to format: binary because the schema already has a format (${schema["format"]})`);
+                    }
+                }
+                else {
+                    delete schema["contentMediaType"];
+                    schema["format"] = "binary";
+                    this.log(`Converted schema contentMediaType: application/octet-stream to format: binary`);
+                }
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    /**
+     * Convert
+     * ```
+     * contentEncoding: base64
+     * ```
+     * to
+     * ```
+     * format: byte
+     * ```
+     * in `type: string` schemas. It is an error if the schema has a `format` already
+     * and it is not `byte`.
+     */
+    convertJsonSchemaContentEncoding() {
+        const schemaVisitor = (schema) => {
+            if (schema.hasOwnProperty("type") &&
+                schema["type"] === "string" &&
+                schema.hasOwnProperty("contentEncoding")) {
+                if (schema["contentEncoding"] === "base64") {
+                    if (schema.hasOwnProperty("format")) {
+                        if (schema["format"] === "byte") {
+                            this.log(`Deleted schema contentEncoding: base64 (leaving format: byte)`);
+                            delete schema["contentEncoding"];
+                        }
+                        else {
+                            this.error(`Unable to down-convert schema contentEncoding: base64 to format: byte because the schema already has a format (${schema["format"]})`);
+                        }
+                    }
+                    else {
+                        delete schema["contentEncoding"];
+                        schema["format"] = "byte";
+                        this.log(`Converted schema: 'contentEncoding: base64' to 'format: byte'`);
+                    }
+                }
+                else {
+                    this.error(`Unable to down-convert contentEncoding: ${schema["contentEncoding"]}`);
+                }
+            }
+            return this.walkNestedSchemaObjects(schema, schemaVisitor);
+        };
+        (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, schemaVisitor);
+    }
+    json(x) {
+        return JSON.stringify(x, null, 2);
+    }
+    /**
+     * OpenAPI 3.1 defines a new `openIdConnect` security scheme.
+     * Down-convert the scheme to `oauth2` / authorization code flow.
+     * Collect all the scopes used in any security requirements within
+     * operations and add them to the scheme. Also define the
+     * URLs to the `authorizationUrl` and `tokenUrl` of `oauth2`.
+     */
+    convertSecuritySchemes() {
+        var _a, _b, _c;
+        const oauth2Scopes = (schemeName) => {
+            var _a, _b;
+            const scopes = {};
+            const paths = (_b = (_a = this.openapi30) === null || _a === void 0 ? void 0 : _a.paths) !== null && _b !== void 0 ? _b : {};
+            for (const path in paths) {
+                for (const op in paths[path]) {
+                    if (op === "parameters") {
+                        continue;
+                    }
+                    const operation = paths[path][op];
+                    const sec = operation === null || operation === void 0 ? void 0 : operation.security;
+                    sec.forEach((s) => {
+                        const requirement = s === null || s === void 0 ? void 0 : s[schemeName];
+                        if (requirement) {
+                            requirement.forEach((scope) => {
+                                var _a, _b;
+                                scopes[scope] =
+                                    (_b = (_a = this.scopeDescriptions) === null || _a === void 0 ? void 0 : _a[scope]) !== null && _b !== void 0 ? _b : `TODO: describe the '${scope}' scope`;
+                            });
+                        }
+                    });
+                }
+            }
+            return scopes;
+        };
+        const schemes = (_c = (_b = (_a = this.openapi30) === null || _a === void 0 ? void 0 : _a.components) === null || _b === void 0 ? void 0 : _b["securitySchemes"]) !== null && _c !== void 0 ? _c : {};
+        for (const schemeName in schemes) {
+            const scheme = schemes[schemeName];
+            const type = scheme.type;
+            if (type === "openIdConnect") {
+                this.log(`Converting openIdConnect security scheme to oauth2/authorizationCode`);
+                scheme.type = "oauth2";
+                const openIdConnectUrl = scheme.openIdConnectUrl;
+                scheme.description = `OAuth2 Authorization Code Flow. The client may
+          GET the OpenID Connect configuration JSON from \`${openIdConnectUrl}\`
+          to get the correct \`authorizationUrl\` and \`tokenUrl\`.`;
+                delete scheme.openIdConnectUrl;
+                const scopes = oauth2Scopes(schemeName);
+                scheme.flows = {
+                    authorizationCode: {
+                        // TODO: add options for these URLs
+                        authorizationUrl: this.authorizationUrl,
+                        tokenUrl: this.tokenUrl,
+                        scopes: scopes,
+                    },
+                };
+            }
+        }
+    }
+    /**
+     * Find remaining OpenAPI 3.0 [Reference Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#referenceObject)
+     * and down convert them to [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03) objects
+     * with _only_ a `$ref` property.
+     */
+    simplifyNonSchemaRef() {
+        (0, RefVisitor_1.visitRefObjects)(this.openapi30, (node) => {
+            if (Object.keys(node).length === 1) {
+                return node;
+            }
+            else {
+                this.log(`Down convert reference object to JSON Reference:\n${JSON.stringify(node, null, 3)}`);
+                Object.keys(node)
+                    .filter((key) => key !== "$ref")
+                    .forEach((key) => delete node[key]);
+                return node;
+            }
+        });
+    }
+    removeLicenseIdentifier() {
+        var _a, _b, _c;
+        if ((_c = (_b = (_a = this.openapi30) === null || _a === void 0 ? void 0 : _a["info"]) === null || _b === void 0 ? void 0 : _b["license"]) === null || _c === void 0 ? void 0 : _c["identifier"]) {
+            this.log(`Removed info.license.identifier: ${this.openapi30["info"]["license"]["identifier"]}`);
+            delete this.openapi30["info"]["license"]["identifier"];
+        }
+    }
+    // This transformation ends up breaking openapi-generator
+    // SDK gen (typescript-axios, typescript-angular)
+    // so it is disabled unless the `allOfTransform` option is `true`.
+    convertSchemaRef() {
+        /**
+         * In a JSON Schema, replace `{ blah blah, $ref: "uri"}`
+         * with `{ blah blah, allOf: [ $ref: "uri" ]}`
+         * @param object an object that may contain JSON schemas (directly
+         * or in sub-objects)
+         */
+        const simplifyRefObjectsInSchemas = (object) => {
+            return (0, RefVisitor_1.visitRefObjects)(object, (node) => {
+                if (Object.keys(node).length === 1) {
+                    return node;
+                }
+                else {
+                    this.log(`Converting JSON Schema $ref ${this.json(node)} to allOf: [ $ref ]`);
+                    node["allOf"] = [{ $ref: node.$ref }];
+                    delete node.$ref;
+                    return node;
+                }
+            });
+        };
+        if (this.allOfTransform) {
+            (0, RefVisitor_1.visitSchemaObjects)(this.openapi30, (schema) => {
+                return simplifyRefObjectsInSchemas(schema);
+            });
+        }
+    }
+    static deepClone(obj) {
+        return JSON.parse(JSON.stringify(obj)); // kinda simple way to clone, but it works...
+    }
+}
+exports.Converter = Converter;
+//# sourceMappingURL=converter.js.map

package/lib/utils/openapi-down-convert/converter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/migrate",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Migration program from swagger to NestJS",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -34,17 +34,18 @@
   },
   "homepage": "https://nestia.io",
   "devDependencies": {
-    "@nestia/core": "^2.5.15",
+    "@nestia/core": "^2.6.0",
     "@nestia/e2e": "^0.4.1",
-    "@nestia/fetcher": "^2.5.15",
-    "@nestjs/common": "^10.3.3",
-    "@nestjs/core": "^10.3.3",
-    "@nestjs/platform-express": "^10.3.3",
-    "@nestjs/platform-fastify": "^10.3.3",
+    "@nestia/fetcher": "^2.6.0",
+    "@nestjs/common": "^10.3.5",
+    "@nestjs/core": "^10.3.5",
+    "@nestjs/platform-express": "^10.3.5",
+    "@nestjs/platform-fastify": "^10.3.5",
     "@trivago/prettier-plugin-sort-imports": "^4.3.0",
     "@types/express": "^4.17.21",
     "@types/inquirer": "^9.0.7",
     "@types/node": "^20.3.3",
+    "@types/swagger2openapi": "^7.0.4",
     "dotenv": "^16.3.1",
     "dotenv-expand": "^10.0.0",
     "rimraf": "^5.0.1",
@@ -55,9 +56,12 @@
     "typescript-transform-paths": "^3.4.6"
   },
   "dependencies": {
+    "@apiture/openapi-down-convert": "^0.13.0",
     "commander": "10.0.0",
     "inquirer": "8.2.5",
+    "openapi-types": "^12.1.3",
     "prettier": "^3.2.5",
+    "swagger2openapi": "^7.0.8",
     "tstl": "^2.5.13",
     "typescript": "^5.4.2",
     "typia": "^5.5.7"

package/src/MigrateApplication.ts

@@ -10,19 +10,28 @@ import { MigrateNestProgrammer } from "./programmers/MigrateNestProgrammer";
 import { IMigrateFile } from "./structures/IMigrateFile";
 import { IMigrateProgram } from "./structures/IMigrateProgram";
 import { ISwagger } from "./structures/ISwagger";
+import { ISwaggerV20 } from "./structures/ISwaggerV20";
+import { ISwaggerV31 } from "./structures/ISwaggerV31";
+import { OpenApiConverter } from "./utils/OpenApiConverter";
 
 export class MigrateApplication {
   private constructor(public readonly swagger: ISwagger) {}
 
-  public static create(swagger: ISwagger): IValidation<MigrateApplication> {
+  public static async create(
+    swagger: ISwagger | ISwaggerV20 | ISwaggerV31,
+  ): Promise<IValidation<MigrateApplication>> {
+    swagger = typia.is<ISwaggerV20.IVersion>(swagger)
+      ? await OpenApiConverter.v2_0(swagger)
+      : typia.is<ISwaggerV31.IVersion>(swagger)
+        ? OpenApiConverter.v3_1(swagger)
+        : swagger;
     const result = typia.validate<ISwagger>(swagger);
-    if (result.success)
-      return {
-        success: true,
-        data: new MigrateApplication(swagger),
-        errors: [],
-      };
-    return result;
+    if (result.success === false) return result;
+    return {
+      success: true,
+      data: new MigrateApplication(swagger),
+      errors: [],
+    };
   }
 
   public nest(config: MigrateApplication.IConfig): MigrateApplication.IOutput {

package/src/internal/MigrateCommander.ts

@@ -35,7 +35,7 @@ export namespace MigrateCommander {
     })();
 
     const result: IValidation<MigrateApplication> =
-      MigrateApplication.create(swagger);
+      await MigrateApplication.create(swagger);
     if (result.success === false) {
       console.log(result.errors);
       throw new Error(

package/src/structures/ISwagger.ts

@@ -1,23 +1,23 @@
-import { ISwaggerComponents } from "./ISwaggerComponents";
-import { ISwaggerInfo } from "./ISwaggerInfo";
-import { ISwaggerRoute } from "./ISwaggerRoute";
-
-export interface ISwagger {
-  openapi: `3.0.${number}`;
-  info: ISwaggerInfo;
-  servers: ISwagger.IServer[];
-
-  components: ISwaggerComponents;
-  paths: Record<string, ISwagger.IPath>;
-  security?: Record<string, string[]>[];
-}
-export namespace ISwagger {
-  export interface IServer {
-    url: string;
-    description?: string;
-  }
-  export type IPath = Record<
-    "get" | "post" | "patch" | "put" | "delete",
-    ISwaggerRoute | undefined
-  >;
-}
+import { ISwaggerComponents } from "./ISwaggerComponents";
+import { ISwaggerInfo } from "./ISwaggerInfo";
+import { ISwaggerRoute } from "./ISwaggerRoute";
+
+export interface ISwagger {
+  openapi: `3.0.${number}`;
+  info: ISwaggerInfo;
+  servers: ISwagger.IServer[];
+
+  components: ISwaggerComponents;
+  paths: Record<string, ISwagger.IPath>;
+  security?: Record<string, string[]>[];
+}
+export namespace ISwagger {
+  export interface IServer {
+    url: string;
+    description?: string;
+  }
+  export type IPath = Record<
+    "get" | "post" | "patch" | "put" | "delete",
+    ISwaggerRoute | undefined
+  >;
+}

package/src/structures/ISwaggerV20.ts

@@ -0,0 +1,10 @@
+import { OpenAPIV2 } from "openapi-types";
+
+export interface ISwaggerV20
+  extends Omit<OpenAPIV2.Document, "swagger">,
+    ISwaggerV20.IVersion {}
+export namespace ISwaggerV20 {
+  export interface IVersion {
+    swagger: "2.0";
+  }
+}

package/src/structures/ISwaggerV31.ts

@@ -0,0 +1,10 @@
+import { OpenAPIV3_1 } from "openapi-types";
+
+export interface ISwaggerV31 extends Omit<OpenAPIV3_1.Document, "openapi"> {
+  openapi: `3.1.${number}`;
+}
+export namespace ISwaggerV31 {
+  export interface IVersion {
+    openapi: `3.1.${number}`;
+  }
+}

package/src/utils/OpenApiConverter.ts

@@ -0,0 +1,19 @@
+import V2_0Converter from "swagger2openapi";
+import typia from "typia";
+
+import { ISwagger } from "../structures/ISwagger";
+import { ISwaggerV20 } from "../structures/ISwaggerV20";
+import { ISwaggerV31 } from "../structures/ISwaggerV31";
+import { Converter as V3_1Converter } from "./openapi-down-convert/converter";
+
+export namespace OpenApiConverter {
+  export const v2_0 = async (swagger: ISwaggerV20): Promise<ISwagger> => {
+    const output = await V2_0Converter.convertObj(swagger, {});
+    return typia.assert<ISwagger>(output.openapi);
+  };
+
+  export const v3_1 = (swagger: ISwaggerV31): ISwagger => {
+    const converter = new V3_1Converter(swagger);
+    return typia.assert<ISwagger>(converter.convert() as ISwagger);
+  };
+}