@nestia/migrate 0.12.0 → 0.13.0-dev.20240411

package/src/structures/IMigrateProgram.ts

@@ -1,13 +1,13 @@
+import { OpenApi } from "@samchon/openapi";
+
 import { IMigrateController } from "./IMigrateController";
 import { IMigrateRoute } from "./IMigrateRoute";
-import { ISwagger } from "./ISwagger";
-import { ISwaggerRoute } from "./ISwaggerRoute";
 
 export interface IMigrateProgram extends IMigrateProgram.IProps {
   controllers: IMigrateController[];
 }
 export namespace IMigrateProgram {
-  export type Dictionary = Map<ISwaggerRoute, IEntry>;
+  export type Dictionary = Map<OpenApi.IOperation, IEntry>;
   export interface IEntry {
     controller: IMigrateController;
     route: IMigrateRoute;
@@ -16,7 +16,7 @@ export namespace IMigrateProgram {
     mode: "nest" | "sdk";
     simulate: boolean;
     e2e: boolean;
-    swagger: ISwagger;
+    document: OpenApi.IDocument;
     dictionary: Dictionary;
   }
   export interface IConfig {

package/src/structures/IMigrateRoute.ts

@@ -1,4 +1,4 @@
-import { ISwaggerSchema } from "./ISwaggerSchema";
+import { OpenApi } from "@samchon/openapi";
 
 export interface IMigrateRoute {
   name: string;
@@ -20,18 +20,18 @@ export namespace IMigrateRoute {
   export interface IParameter {
     name: string;
     key: string;
-    schema: ISwaggerSchema;
+    schema: OpenApi.IJsonSchema;
     description?: string;
   }
   export interface IHeaders {
     name: string;
     key: string;
-    schema: ISwaggerSchema;
+    schema: OpenApi.IJsonSchema;
   }
   export interface IQuery {
     name: string;
     key: string;
-    schema: ISwaggerSchema;
+    schema: OpenApi.IJsonSchema;
   }
   export interface IBody {
     name: string;
@@ -41,11 +41,11 @@ export namespace IMigrateRoute {
       | "application/json"
       | "application/x-www-form-urlencoded"
       | "multipart/form-data";
-    schema: ISwaggerSchema;
+    schema: OpenApi.IJsonSchema;
     "x-nestia-encrypted"?: boolean;
   }
   export interface IException {
     description?: string;
-    schema: ISwaggerSchema;
+    schema: OpenApi.IJsonSchema;
   }
 }

package/src/utils/OpenApiTypeChecker.ts

@@ -0,0 +1,73 @@
+import { OpenApi } from "@samchon/openapi";
+
+export namespace OpenApiTypeChecker {
+  export const isOneOf = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IOneOf =>
+    (schema as any).oneOf !== undefined;
+
+  export const isNull = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.INull =>
+    (schema as OpenApi.IJsonSchema.INull).type === "null";
+
+  export const isConstant = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IConstant =>
+    (schema as OpenApi.IJsonSchema.IConstant).const !== undefined;
+
+  export const isBoolean = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IBoolean =>
+    (schema as OpenApi.IJsonSchema.IBoolean).type === "boolean";
+
+  export const isInteger = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IInteger =>
+    (schema as OpenApi.IJsonSchema.IInteger).type === "integer";
+
+  export const isNumber = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.INumber =>
+    (schema as OpenApi.IJsonSchema.INumber).type === "number";
+
+  export const isString = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IString =>
+    (schema as OpenApi.IJsonSchema.IString).type === "string";
+
+  export const isArray = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IArray =>
+    (schema as OpenApi.IJsonSchema.IArray).type === "array" &&
+    (schema as OpenApi.IJsonSchema.IArray).items !== undefined;
+
+  export const isTuple = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.ITuple =>
+    (schema as OpenApi.IJsonSchema.ITuple).type === "array" &&
+    (schema as OpenApi.IJsonSchema.ITuple).prefixItems !== undefined;
+
+  export const isObject = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IObject =>
+    (schema as OpenApi.IJsonSchema.IObject).type === "object";
+
+  export const isReference = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IReference =>
+    (schema as OpenApi.IJsonSchema.IReference).$ref !== undefined;
+
+  export const isUnknown = (
+    schema: OpenApi.IJsonSchema,
+  ): schema is OpenApi.IJsonSchema.IUnknown =>
+    (schema as OpenApi.IJsonSchema.__ISignificant<any>).type === undefined &&
+    !isOneOf(schema) &&
+    !isReference(schema) &&
+    !isConstant(schema);
+
+  // export const isNullable = (schema: OpenApi.IJsonSchema): boolean =>
+  //   SwaggerTypeChecker.isOneOf(schema)
+  //     ? schema.oneOf.some(isNullable)
+  //     : (schema as OpenApi.IJsonSchema.INullOnly).type === "null";
+}

package/lib/structures/ISwagger.d.ts

@@ -1,18 +0,0 @@
-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 declare namespace ISwagger {
-    interface IServer {
-        url: string;
-        description?: string;
-    }
-    type IPath = Record<"get" | "post" | "patch" | "put" | "delete", ISwaggerRoute | undefined>;
-}

package/lib/structures/ISwagger.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwagger.js.map

package/lib/structures/ISwagger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwagger.js","sourceRoot":"","sources":["../../src/structures/ISwagger.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerComponents.d.ts

@@ -1,12 +0,0 @@
-import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
-import { ISwaggerRouteRequestBody } from "./ISwaggerRouteRequestBody";
-import { ISwaggerRouteResponse } from "./ISwaggerRouteResponse";
-import { ISwaggerSchema } from "./ISwaggerSchema";
-import { ISwaggerSecurityScheme } from "./ISwaggerSecurityScheme";
-export interface ISwaggerComponents {
-    parameters?: Record<string, ISwaggerRouteParameter>;
-    requestBodies?: Record<string, ISwaggerRouteRequestBody>;
-    responses?: Record<string, ISwaggerRouteResponse>;
-    schemas?: Record<string, ISwaggerSchema>;
-    securitySchemes?: Record<string, ISwaggerSecurityScheme>;
-}

package/lib/structures/ISwaggerComponents.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerComponents.js.map

package/lib/structures/ISwaggerComponents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerComponents.js","sourceRoot":"","sources":["../../src/structures/ISwaggerComponents.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerInfo.d.ts

@@ -1,71 +0,0 @@
-/**
- * Information about the API.
- *
- * @author Samchon
- */
-export interface ISwaggerInfo {
-    /**
-     * The title of the API.
-     */
-    title: string;
-    /**
-     * A short description of the API.
-     */
-    description?: string;
-    /**
-     * A URL to the Terms of Service for the API.
-     *
-     * @format uri
-     */
-    termsOfService?: string;
-    /**
-     * The contact information for the exposed API.
-     */
-    contact?: ISwaggerInfo.IContact;
-    /**
-     * The license information for the exposed API.
-     */
-    license?: ISwaggerInfo.ILicense;
-    /**
-     * Version of the API.
-     */
-    version: string;
-}
-export declare namespace ISwaggerInfo {
-    /**
-     * Contact information for the exposed API.
-     */
-    interface IContact {
-        /**
-         * The identifying name of the contact person/organization.
-         */
-        name?: string;
-        /**
-         * The URL pointing to the contact information.
-         *
-         * @format uri
-         */
-        url?: string;
-        /**
-         * The email address of the contact person/organization.
-         *
-         * @format email
-         */
-        email?: string;
-    }
-    /**
-     * License information for the exposed API.
-     */
-    interface ILicense {
-        /**
-         * The license name used for the API.
-         */
-        name: string;
-        /**
-         * A URL to the license used for the API.
-         *
-         * @format uri
-         */
-        url?: string;
-    }
-}

package/lib/structures/ISwaggerInfo.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerInfo.js.map

package/lib/structures/ISwaggerInfo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerInfo.js","sourceRoot":"","sources":["../../src/structures/ISwaggerInfo.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRoute.d.ts

@@ -1,15 +0,0 @@
-import { IJsDocTagInfo } from "typia/lib/schemas/metadata/IJsDocTagInfo";
-import { ISwaggerRouteParameter } from "./ISwaggerRouteParameter";
-import { ISwaggerRouteRequestBody } from "./ISwaggerRouteRequestBody";
-import { ISwaggerRouteResponse } from "./ISwaggerRouteResponse";
-export interface ISwaggerRoute {
-    parameters?: (ISwaggerRouteParameter | ISwaggerRouteParameter.IReference)[];
-    requestBody?: ISwaggerRouteRequestBody;
-    responses?: Record<string, ISwaggerRouteResponse | ISwaggerRouteResponse.IReference>;
-    summary?: string;
-    description?: string;
-    deprecated?: boolean;
-    security?: Record<string, string[]>[];
-    tags?: string[];
-    "x-nestia-jsDocTags"?: IJsDocTagInfo[];
-}

package/lib/structures/ISwaggerRoute.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerRoute.js.map

package/lib/structures/ISwaggerRoute.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRoute.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRoute.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRouteBodyContent.d.ts

@@ -1,14 +0,0 @@
-import { ISwaggerSchema } from "./ISwaggerSchema";
-export interface ISwaggerRouteBodyContent {
-    "text/plain"?: ISwaggerRouteBodyContent.IMediaType;
-    "application/json"?: ISwaggerRouteBodyContent.IMediaType;
-    "application/x-www-form-urlencoded"?: ISwaggerRouteBodyContent.IMediaType;
-    "multipart/form-data"?: ISwaggerRouteBodyContent.IMediaType;
-    "*/*"?: ISwaggerRouteBodyContent.IMediaType;
-}
-export declare namespace ISwaggerRouteBodyContent {
-    interface IMediaType {
-        schema?: ISwaggerSchema;
-        "x-nestia-encrypted"?: boolean;
-    }
-}

package/lib/structures/ISwaggerRouteBodyContent.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerRouteBodyContent.js.map

package/lib/structures/ISwaggerRouteBodyContent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRouteBodyContent.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteBodyContent.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRouteHeader.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=ISwaggerRouteHeader.js.map

package/lib/structures/ISwaggerRouteHeader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRouteHeader.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteHeader.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRouteParameter.d.ts

@@ -1,13 +0,0 @@
-import { ISwaggerSchema } from "./ISwaggerSchema";
-export interface ISwaggerRouteParameter {
-    name?: string;
-    in: "path" | "query" | "header" | "cookie";
-    schema: ISwaggerSchema;
-    required?: boolean;
-    description?: string;
-}
-export declare namespace ISwaggerRouteParameter {
-    interface IReference {
-        $ref: `#/components/parameters/${string}`;
-    }
-}

package/lib/structures/ISwaggerRouteParameter.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerRouteParameter.js.map

package/lib/structures/ISwaggerRouteParameter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRouteParameter.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteParameter.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRouteRequestBody.d.ts

@@ -1,11 +0,0 @@
-import { ISwaggerRouteBodyContent } from "./ISwaggerRouteBodyContent";
-export interface ISwaggerRouteRequestBody {
-    description?: string;
-    required?: boolean;
-    content?: ISwaggerRouteBodyContent;
-}
-export declare namespace ISwaggerRouteRequestBody {
-    interface IReference {
-        $ref: `#/components/requestBodies/${string}`;
-    }
-}

package/lib/structures/ISwaggerRouteRequestBody.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerRouteRequestBody.js.map

package/lib/structures/ISwaggerRouteRequestBody.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRouteRequestBody.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteRequestBody.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerRouteResponse.d.ts

@@ -1,10 +0,0 @@
-import { ISwaggerRouteBodyContent } from "./ISwaggerRouteBodyContent";
-export interface ISwaggerRouteResponse {
-    description?: string;
-    content?: ISwaggerRouteBodyContent;
-}
-export declare namespace ISwaggerRouteResponse {
-    interface IReference {
-        $ref: `#/components/responses/${string}`;
-    }
-}

package/lib/structures/ISwaggerRouteResponse.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerRouteResponse.js.map

package/lib/structures/ISwaggerRouteResponse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerRouteResponse.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRouteResponse.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerSchema.d.ts

@@ -1,75 +0,0 @@
-export type ISwaggerSchema = ISwaggerSchema.IUnknown | ISwaggerSchema.INullOnly | ISwaggerSchema.IAnyOf | ISwaggerSchema.IOneOf | ISwaggerSchema.IBoolean | ISwaggerSchema.IInteger | ISwaggerSchema.INumber | ISwaggerSchema.IString | ISwaggerSchema.IArray | ISwaggerSchema.IObject | ISwaggerSchema.IReference;
-export declare namespace ISwaggerSchema {
-    export interface IUnknown extends IAttribute {
-        type?: undefined;
-    }
-    export interface INullOnly extends IAttribute {
-        type: "null";
-    }
-    export interface IAnyOf extends IAttribute {
-        anyOf: ISwaggerSchema[];
-    }
-    export interface IOneOf extends IAttribute {
-        oneOf: ISwaggerSchema[];
-    }
-    export interface IBoolean extends ISignificant<"boolean"> {
-        default?: boolean;
-        enum?: boolean[];
-    }
-    export interface IInteger extends ISignificant<"integer"> {
-        /** @type int */ default?: number;
-        /** @type int */ enum?: number[];
-        /** @type int */ minimum?: number;
-        /** @type int */ maximum?: number;
-        /** @type int */ exclusiveMinimum?: boolean;
-        /** @type int */ exclusiveMaximum?: boolean;
-        /** @type uint */ multipleOf?: number;
-    }
-    export interface INumber extends ISignificant<"number"> {
-        default?: number;
-        enum?: number[];
-        minimum?: number;
-        maximum?: number;
-        exclusiveMinimum?: boolean;
-        exclusiveMaximum?: boolean;
-        multipleOf?: number;
-    }
-    export interface IString extends ISignificant<"string"> {
-        default?: string;
-        enum?: string[];
-        format?: string;
-        pattern?: string;
-        /** @type uint */ minLength?: number;
-        /** @type uint */ maxLength?: number;
-    }
-    export interface IArray extends ISignificant<"array"> {
-        items: ISwaggerSchema;
-        /** @type uint */ minItems?: number;
-        /** @type uint */ maxItems?: number;
-        "x-typia-tuple"?: ITuple;
-    }
-    export interface ITuple extends ISignificant<"array"> {
-        items: ISwaggerSchema[];
-    }
-    export interface IObject extends ISignificant<"object"> {
-        properties?: Record<string, ISwaggerSchema>;
-        required?: string[];
-        additionalProperties?: ISwaggerSchema | boolean;
-        "x-typia-patternProperties"?: Record<string, ISwaggerSchema>;
-    }
-    export interface IReference extends IAttribute {
-        $ref: string;
-    }
-    interface ISignificant<Type extends string> extends IAttribute {
-        type: Type;
-        nullable?: boolean;
-    }
-    interface IAttribute {
-        title?: string;
-        description?: string;
-        deprecated?: boolean;
-        "x-typia-optional"?: boolean;
-        "x-typia-rest"?: boolean;
-    }
-    export {};
-}

package/lib/structures/ISwaggerSchema.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerSchema.js.map

package/lib/structures/ISwaggerSchema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerSchema.js","sourceRoot":"","sources":["../../src/structures/ISwaggerSchema.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerSecurityScheme.d.ts

@@ -1,40 +0,0 @@
-export type ISwaggerSecurityScheme = ISwaggerSecurityScheme.IHttpBasic | ISwaggerSecurityScheme.IHttpBearer | ISwaggerSecurityScheme.IApiKey | ISwaggerSecurityScheme.IOpenId | ISwaggerSecurityScheme.IOAuth2;
-export declare namespace ISwaggerSecurityScheme {
-    interface IHttpBasic {
-        type: "http";
-        scheme: "basic";
-    }
-    interface IHttpBearer {
-        type: "http";
-        scheme: "bearer";
-        bearerFormat?: string;
-    }
-    interface IApiKey {
-        type: "apiKey";
-        in?: "header" | "query" | "cookie";
-        name?: string;
-    }
-    interface IOpenId {
-        type: "openIdConnect";
-        openIdConnectUrl: string;
-    }
-    interface IOAuth2 {
-        type: "oauth2";
-        flows: IOAuth2.IFlowSet;
-        description?: string;
-    }
-    namespace IOAuth2 {
-        interface IFlowSet {
-            authorizationCode?: IFlow;
-            implicit?: Omit<IFlow, "tokenUrl">;
-            password?: Omit<IFlow, "authorizationUrl">;
-            clientCredentials?: Omit<IFlow, "authorizationUrl">;
-        }
-        interface IFlow {
-            authorizationUrl: string;
-            tokenUrl?: string;
-            refreshUrl?: string;
-            scopes?: Record<string, string>;
-        }
-    }
-}

package/lib/structures/ISwaggerSecurityScheme.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerSecurityScheme.js.map

package/lib/structures/ISwaggerSecurityScheme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerSecurityScheme.js","sourceRoot":"","sources":["../../src/structures/ISwaggerSecurityScheme.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerV20.d.ts

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

package/lib/structures/ISwaggerV20.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerV20.js.map

package/lib/structures/ISwaggerV20.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerV20.js","sourceRoot":"","sources":["../../src/structures/ISwaggerV20.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerV31.d.ts

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

package/lib/structures/ISwaggerV31.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ISwaggerV31.js.map

package/lib/structures/ISwaggerV31.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ISwaggerV31.js","sourceRoot":"","sources":["../../src/structures/ISwaggerV31.ts"],"names":[],"mappings":""}

package/lib/utils/OpenApiConverter.d.ts

@@ -1,5 +0,0 @@
-import { ISwagger } from "../structures/ISwagger";
-import { ISwaggerV31 } from "../structures/ISwaggerV31";
-export declare namespace OpenApiConverter {
-    const v3_1: (swagger: ISwaggerV31) => ISwagger;
-}