@nestia/sdk 2.0.0-dev.20230831-5 → 2.0.0-dev.20230901

package/lib/generates/internal/SwaggerSchemaGenerator.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerSchemaGenerator = void 0;
+const tstl_1 = require("tstl");
+const MetadataCollection_1 = require("typia/lib/factories/MetadataCollection");
+const MetadataFactory_1 = require("typia/lib/factories/MetadataFactory");
+const Metadata_1 = require("typia/lib/schemas/metadata/Metadata");
+const SwaggerSchemaValidator_1 = require("./SwaggerSchemaValidator");
+var SwaggerSchemaGenerator;
+(function (SwaggerSchemaGenerator) {
+    SwaggerSchemaGenerator.response = (props) => (route) => {
+        var _a, _b, _c, _d;
+        const output = {};
+        //----
+        // EXCEPTION STATUSES
+        //----
+        // FROM DECORATOR
+        for (const [status, exp] of Object.entries(route.exceptions)) {
+            const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+                escape: true,
+                constant: true,
+                absorb: false,
+                validate: (meta) => {
+                    const bigint = meta.atomics.some((a) => a.type === "bigint") ||
+                        meta.constants.some((a) => a.type === "bigint");
+                    return bigint ? ["bigint type is not allowed."] : [];
+                },
+            })(props.collection)(exp.type);
+            if (result.success === false)
+                props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `response body (status: ${status})` }))));
+            output[status] = {
+                description: (_a = exp.description) !== null && _a !== void 0 ? _a : "",
+                content: {
+                    "application/json": {
+                        schema: coalesceSchema(props)(result),
+                    },
+                },
+            };
+        }
+        // FROM COMMENT TAGS -> ANY
+        for (const tag of route.tags) {
+            if (tag.name !== "throw" && tag.name !== "throws")
+                continue;
+            const text = (_c = (_b = tag.text) === null || _b === void 0 ? void 0 : _b.find((elem) => elem.kind === "text")) === null || _c === void 0 ? void 0 : _c.text;
+            if (text === undefined)
+                continue;
+            const elements = text
+                .split(" ")
+                .map((str) => str.trim());
+            const status = elements[0];
+            if (isNaN(Number(status)) &&
+                status !== "2XX" &&
+                status !== "3XX" &&
+                status !== "4XX" &&
+                status !== "5XX")
+                continue;
+            const description = elements.length === 1
+                ? undefined
+                : elements.slice(1).join(" ");
+            const oldbie = output[status];
+            if (description && oldbie !== undefined)
+                oldbie.description = description;
+            else if (oldbie === undefined)
+                output[status] = {
+                    description: description !== null && description !== void 0 ? description : "",
+                    content: {
+                        "application/json": {
+                            schema: {},
+                        },
+                    },
+                };
+        }
+        //----
+        // SUCCESS
+        //----
+        // STATUS
+        const status = route.status !== undefined
+            ? String(route.status)
+            : route.method === "GET" ||
+                route.method === "HEAD" ||
+                route.method === "DELETE"
+                ? "200"
+                : "201";
+        // SCHEMA
+        const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+            escape: true,
+            constant: true,
+            absorb: false,
+            validate: (meta) => {
+                const bigint = meta.atomics.some((a) => a.type === "bigint") ||
+                    meta.constants.some((a) => a.type === "bigint");
+                return bigint ? ["bigint type is not allowed."] : [];
+            },
+        })(props.collection)(route.output.type);
+        if (result.success === false)
+            props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `response body (status: ${status})` }))));
+        // DO ASSIGN
+        const description = (_d = describe(route, "return")) !== null && _d !== void 0 ? _d : describe(route, "returns");
+        output[status] = {
+            description: route.encrypted
+                ? `${warning
+                    .get(!!description)
+                    .get("response", route.method)}${description !== null && description !== void 0 ? description : ""}`
+                : description !== null && description !== void 0 ? description : "",
+            content: route.output.typeName === "void"
+                ? undefined
+                : {
+                    [route.output.contentType]: {
+                        schema: coalesceSchema(props)(result),
+                    },
+                },
+            "x-nestia-encrypted": route.encrypted,
+        };
+        return output;
+    };
+    SwaggerSchemaGenerator.body = (props) => (route) => (param) => {
+        // ANALZE TYPE WITH VALIDATION
+        const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+            escape: true,
+            constant: true,
+            absorb: true,
+            validate: (meta) => {
+                const bigint = meta.atomics.some((a) => a.type === "bigint") ||
+                    meta.constants.some((a) => a.type === "bigint");
+                return bigint ? ["bigint type is not allowed."] : [];
+            },
+        })(props.collection)(param.type);
+        if (result.success === false)
+            props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `body parameter ${param.name}` }))));
+        // LIST UP PROPERTIES
+        const contentType = param.custom && param.category === "body"
+            ? param.contentType
+            : "application/json";
+        const encrypted = param.custom && param.category === "body" && param.encrypted;
+        const description = describe(route, "param", param.name);
+        // RETURNS WITH LAZY CONSTRUCTION
+        const schema = coalesceSchema(props)(result);
+        return {
+            description: encrypted
+                ? `${warning.get(!!description).get("request")}${description !== null && description !== void 0 ? description : ""}`
+                : description,
+            content: {
+                [contentType]: {
+                    schema,
+                },
+            },
+            required: true,
+            "x-nestia-encrypted": encrypted,
+        };
+    };
+    SwaggerSchemaGenerator.parameter = (props) => (route) => (param) => param.category === "headers"
+        ? headers(props)(route)(param)
+        : param.category === "param"
+            ? path(props)(route)(param)
+            : query(props)(route)(param);
+    const headers = (props) => (route) => (param) => {
+        // ANALYZE TYPE WITH VALIDATIONS
+        const result = (() => {
+            const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+                escape: false,
+                constant: true,
+                absorb: true,
+            })(props.collection)(param.type);
+            if (result.success === false)
+                props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `header parameter ${param.name}` }))));
+            else if (result.data.objects.length === 1) {
+                // WHEN OBJECT CASE, VALIDATE IT MORE DETAILY
+                const again = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+                    escape: false,
+                    constant: true,
+                    absorb: true,
+                    validate: SwaggerSchemaValidator_1.SwaggerSchemaValidator.headers,
+                })(new MetadataCollection_1.MetadataCollection())(param.type);
+                if (again.success === false)
+                    return again;
+            }
+            return result;
+        })();
+        // RETURNS WITH LAZY CONSTRUCTION
+        return lazyParameterReturns(props)(route)("header")(param, result);
+    };
+    const path = (props) => (route) => (param) => {
+        // ANALZE TYPE WITH VALIDATION
+        const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+            escape: false,
+            constant: true,
+            absorb: true,
+            validate: SwaggerSchemaValidator_1.SwaggerSchemaValidator.path,
+        })(props.collection)(param.type);
+        if (result.success === false)
+            props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `path parameter ${param.name}` }))));
+        // RETURNS WITH LAZY CONSTRUCTION
+        return lazyParameterReturns(props)(route)("path")(param, result);
+    };
+    const query = (props) => (route) => (param) => {
+        // ANALYZE TYPE WITH VALIDATIONS
+        const result = (() => {
+            const result = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+                escape: false,
+                constant: true,
+                absorb: true,
+            })(props.collection)(param.type);
+            if (result.success === false) {
+                props.errors.push(...result.errors.map((e) => (Object.assign(Object.assign({}, e), { route, from: `query parameter ${param.name}` }))));
+            }
+            else if (result.data.objects.length === 1) {
+                // WHEN OBJECT CASE, VALIDATE IT MORE DETAILY
+                const again = MetadataFactory_1.MetadataFactory.analyze(props.checker)({
+                    escape: false,
+                    constant: true,
+                    absorb: true,
+                    validate: SwaggerSchemaValidator_1.SwaggerSchemaValidator.query,
+                })(new MetadataCollection_1.MetadataCollection())(param.type);
+                if (again.success === false)
+                    return again;
+            }
+            return result;
+        })();
+        // RETURNS WITH LAZY CONSTRUCTION
+        return lazyParameterReturns(props)(route)("query")(param, result);
+    };
+    const coalesceSchema = (props) => (result) => {
+        const schema = {};
+        props.tuples.push({
+            metadata: result.success ? result.data : any.get(),
+            schema,
+        });
+        return schema;
+    };
+    const lazyParameterReturns = (props) => (route) => (inKeyword) => (param, result) => {
+        var _a, _b;
+        const schema = coalesceSchema(props)(result);
+        return {
+            name: (_a = param.field) !== null && _a !== void 0 ? _a : param.name,
+            in: inKeyword,
+            schema,
+            description: (_b = describe(route, "param", param.name)) !== null && _b !== void 0 ? _b : "",
+            required: result.success ? result.data.isRequired() : true,
+        };
+    };
+    function describe(route, tagName, parameterName) {
+        var _a;
+        const parametric = parameterName
+            ? (tag) => tag.text.find((elem) => elem.kind === "parameterName" &&
+                elem.text === parameterName) !== undefined
+            : () => true;
+        const tag = route.tags.find((tag) => tag.name === tagName && tag.text && parametric(tag));
+        return tag && tag.text
+            ? (_a = tag.text.find((elem) => elem.kind === "text")) === null || _a === void 0 ? void 0 : _a.text
+            : undefined;
+    }
+})(SwaggerSchemaGenerator || (exports.SwaggerSchemaGenerator = SwaggerSchemaGenerator = {}));
+const warning = new tstl_1.Singleton((described) => {
+    return new tstl_1.Singleton((type, method) => {
+        const summary = type === "request"
+            ? "Request body must be encrypted."
+            : "Response data have been encrypted.";
+        const component = type === "request"
+            ? "[EncryptedBody](https://github.com/samchon/@nestia/core#encryptedbody)"
+            : `[EncryptedRoute.${method[0].toUpperCase()}.${method
+                .substring(1)
+                .toLowerCase()}](https://github.com/samchon/@nestia/core#encryptedroute)`;
+        const content = [
+            "## Warning",
+            "",
+            summary,
+            "",
+            `The ${type} body data would be encrypted as "AES-128(256) / CBC mode / PKCS#5 Padding / Base64 Encoding", through the ${component} component.`,
+            "",
+            `Therefore, just utilize this swagger editor only for referencing. If you need to call the real API, using [SDK](https://github.com/samchon/nestia#software-development-kit) would be much better.`,
+        ];
+        if (described === true)
+            content.push("----------------", "");
+        return content.join("\n");
+    });
+});
+const any = new tstl_1.Singleton(() => Metadata_1.Metadata.from({
+    any: true,
+    required: true,
+    optional: false,
+    nullable: false,
+    functional: false,
+    atomics: [],
+    constants: [],
+    templates: [],
+    escaped: null,
+    rest: null,
+    arrays: [],
+    tuples: [],
+    objects: [],
+    aliases: [],
+    natives: [],
+    sets: [],
+    maps: [],
+}, {
+    aliases: [],
+    arrays: [],
+    tuples: [],
+    objects: [],
+}));
+//# sourceMappingURL=SwaggerSchemaGenerator.js.map

package/lib/generates/internal/SwaggerSchemaGenerator.js.map

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

package/lib/generates/internal/SwaggerSchemaValidator.d.ts

@@ -0,0 +1,7 @@
+import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+export declare namespace SwaggerSchemaValidator {
+    const path: (meta: Metadata) => string[];
+    const query: (meta: Metadata, explore: MetadataFactory.IExplore) => string[];
+    const headers: (meta: Metadata, explore: MetadataFactory.IExplore) => string[];
+}

package/lib/generates/internal/SwaggerSchemaValidator.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerSchemaValidator = void 0;
+const MetadataArray_1 = require("typia/lib/schemas/metadata/MetadataArray");
+var SwaggerSchemaValidator;
+(function (SwaggerSchemaValidator) {
+    SwaggerSchemaValidator.path = (meta) => {
+        const errors = [];
+        const insert = (msg) => errors.push(msg);
+        if (meta.any)
+            insert("do not allow any type");
+        if (meta.isRequired() === false)
+            insert("do not allow undefindable type");
+        const atomics = CoreMetadataUtil.atomics(meta);
+        const expected = meta.atomics.length +
+            meta.templates.length +
+            meta.constants
+                .map((c) => c.values.length)
+                .reduce((a, b) => a + b, 0);
+        if (meta.size() !== expected || atomics.size === 0)
+            insert("only atomic or constant types are allowed");
+        if (atomics.size > 1)
+            insert("do not allow union type");
+        return errors;
+    };
+    SwaggerSchemaValidator.query = (meta, explore) => {
+        const errors = [];
+        const insert = (msg) => errors.push(msg);
+        if (explore.top === true) {
+            // TOP MUST BE ONLY OBJECT
+            if (meta.objects.length !== 1 || meta.bucket() !== 1)
+                insert("only one object type is allowed.");
+            if (meta.nullable === true)
+                insert("query parameters cannot be null.");
+            if (meta.isRequired() === false)
+                insert("query parameters cannot be undefined.");
+        }
+        else if (explore.nested !== null &&
+            explore.nested instanceof MetadataArray_1.MetadataArray) {
+            const atomics = CoreMetadataUtil.atomics(meta);
+            const expected = meta.atomics.length +
+                meta.templates.length +
+                meta.constants
+                    .map((c) => c.values.length)
+                    .reduce((a, b) => a + b, 0);
+            if (atomics.size > 1)
+                insert("union type is not allowed in array.");
+            if (meta.nullable)
+                insert("nullable type is not allowed in array.");
+            if (meta.isRequired() === false)
+                insert("optional type is not allowed in array.");
+            if (meta.size() !== expected)
+                insert("only atomic or constant types are allowed in array.");
+        }
+        else if (explore.object && explore.property !== null) {
+            //----
+            // COMMON
+            //----
+            // PROPERTY MUST BE SOLE
+            if (typeof explore.property === "object")
+                insert("dynamic property is not allowed.");
+            // MUST BE LOWER-CASE
+            if (typeof explore.property === "string" &&
+                explore.property !== explore.property.toLowerCase())
+                insert("property name must be lower-case.");
+            // DO NOT ALLOW TUPLE TYPE
+            if (meta.tuples.length)
+                insert("tuple type is not allowed.");
+            // DO NOT ALLOW UNION TYPE
+            if (CoreMetadataUtil.isUnion(meta))
+                insert("union type is not allowed.");
+            // DO NOT ALLOW NESTED OBJECT
+            if (meta.objects.length ||
+                meta.sets.length ||
+                meta.maps.length ||
+                meta.natives.length)
+                insert("nested object type is not allowed.");
+            //----
+            // ARRAY CASES
+            //----
+            const isArray = meta.arrays.length > 1 || meta.tuples.length > 1;
+            // ARRAY TYPE MUST BE REQUIRED
+            if (isArray && meta.isRequired() === false)
+                insert("optional type is not allowed when array.");
+            // SET-COOKIE MUST BE ARRAY
+            if (explore.property === "set-cookie" && !isArray)
+                insert("set-cookie property must be array.");
+        }
+        return errors;
+    };
+    SwaggerSchemaValidator.headers = (meta, explore) => {
+        const errors = [];
+        const insert = (msg) => errors.push(msg);
+        if (explore.top === true) {
+            // TOP MUST BE ONLY OBJECT
+            if (meta.objects.length !== 1 || meta.bucket() !== 1)
+                insert("only one object type is allowed.");
+            if (meta.nullable === true)
+                insert("headers cannot be null.");
+            if (meta.isRequired() === false)
+                insert("headers cannot be null.");
+        }
+        else if (explore.nested !== null &&
+            explore.nested instanceof MetadataArray_1.MetadataArray) {
+            const atomics = CoreMetadataUtil.atomics(meta);
+            const expected = meta.atomics.length +
+                meta.templates.length +
+                meta.constants
+                    .map((c) => c.values.length)
+                    .reduce((a, b) => a + b, 0);
+            if (atomics.size > 1)
+                insert("union type is not allowed in array.");
+            if (meta.nullable)
+                insert("nullable type is not allowed in array.");
+            if (meta.isRequired() === false)
+                insert("optional type is not allowed.");
+            if (meta.size() !== expected)
+                insert("only atomic or constant types are allowed in array.");
+        }
+        else if (explore.object && explore.property !== null) {
+            //----
+            // COMMON
+            //----
+            // PROPERTY MUST BE SOLE
+            if (typeof explore.property === "object")
+                insert("dynamic property is not allowed.");
+            // MUST BE LOWER-CASE
+            if (typeof explore.property === "string" &&
+                explore.property !== explore.property.toLowerCase())
+                insert("property name must be lower-case.");
+            // DO NOT ALLOW TUPLE TYPE
+            if (meta.tuples.length)
+                insert("tuple type is not allowed.");
+            // DO NOT ALLOW UNION TYPE
+            if (CoreMetadataUtil.isUnion(meta))
+                insert("union type is not allowed.");
+            // DO NOT ALLOW NESTED OBJECT
+            if (meta.objects.length ||
+                meta.sets.length ||
+                meta.maps.length ||
+                meta.natives.length)
+                insert("nested object type is not allowed.");
+            // DO NOT ALLOW NULLABLE
+            if (meta.nullable)
+                insert("nullable type is not allowed.");
+            //----
+            // ARRAY CASES
+            //----
+            const isArray = meta.arrays.length > 1;
+            // ARRAY TYPE MUST BE REQUIRED
+            if (isArray && meta.isRequired() === false)
+                insert("optional type is not allowed when array.");
+            // SET-COOKIE MUST BE ARRAY
+            if (explore.property === "set-cookie" && !isArray)
+                insert("set-cookie property must be array.");
+            // MUST BE SINGULAR CASE
+            if (typeof explore.property === "string" &&
+                SINGULAR.has(explore.property) &&
+                isArray)
+                insert("property cannot be array.");
+        }
+        return errors;
+    };
+})(SwaggerSchemaValidator || (exports.SwaggerSchemaValidator = SwaggerSchemaValidator = {}));
+var CoreMetadataUtil;
+(function (CoreMetadataUtil) {
+    CoreMetadataUtil.atomics = (meta) => new Set([
+        ...meta.atomics.map((a) => a.type),
+        ...meta.constants.map((c) => c.type),
+        ...(meta.templates.length ? ["string"] : []),
+    ]);
+    CoreMetadataUtil.isUnion = (meta) => CoreMetadataUtil.atomics(meta).size +
+        meta.arrays.length +
+        meta.tuples.length +
+        meta.natives.length +
+        meta.maps.length +
+        meta.objects.length >
+        1;
+})(CoreMetadataUtil || (CoreMetadataUtil = {}));
+const SINGULAR = new Set([
+    "age",
+    "authorization",
+    "content-length",
+    "content-type",
+    "etag",
+    "expires",
+    "from",
+    "host",
+    "if-modified-since",
+    "if-unmodified-since",
+    "last-modified",
+    "location",
+    "max-forwards",
+    "proxy-authorization",
+    "referer",
+    "retry-after",
+    "server",
+    "user-agent",
+]);
+//# sourceMappingURL=SwaggerSchemaValidator.js.map

package/lib/generates/internal/SwaggerSchemaValidator.js.map

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

package/lib/structures/IController.d.ts

@@ -56,10 +56,6 @@ export declare namespace IController {
         index: number;
         name: string;
         field: string | undefined;
-        meta?: {
-            type: string;
-            nullable: boolean;
-        };
     }
     interface IException {
         type: string;

package/lib/structures/IRoute.d.ts

@@ -1,6 +1,5 @@
 import ts from "typescript";
 import { IController } from "./IController";
-import { ITypeTuple } from "./ITypeTuple";
 export interface IRoute {
     name: string;
     method: string;
@@ -14,6 +13,7 @@ export interface IRoute {
     location: string;
     symbol: string;
     description?: string;
+    operationId?: string;
     tags: ts.JSDocTagInfo[];
     setHeaders: Array<{
         type: "setter";
@@ -29,9 +29,12 @@ export interface IRoute {
 export declare namespace IRoute {
     type IParameter = IController.IParameter & {
         optional: boolean;
-        type: ITypeTuple;
+        type: ts.Type;
+        typeName: string;
     };
-    interface IOutput extends ITypeTuple {
+    interface IOutput {
+        type: ts.Type;
+        typeName: string;
         description?: string;
         contentType: "application/json" | "text/plain";
     }

package/lib/structures/ISwaggerError.d.ts

@@ -0,0 +1,6 @@
+import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
+import { IRoute } from "./IRoute";
+export interface ISwaggerError extends MetadataFactory.IError {
+    route: IRoute;
+    from: string;
+}

package/lib/structures/ISwaggerError.js

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

package/lib/structures/ISwaggerError.js.map

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

package/lib/structures/ISwaggerRoute.d.ts

@@ -1,8 +1,9 @@
 import { IJsonSchema } from "typia";
-import { IJsDocTagInfo } from "typia/lib/metadata/IJsDocTagInfo";
+import { IJsDocTagInfo } from "typia/lib/schemas/metadata/IJsDocTagInfo";
 export interface ISwaggerRoute {
     deprecated?: boolean;
     security?: Record<string, string[]>[];
+    operationId?: string;
     tags: string[];
     parameters: ISwaggerRoute.IParameter[];
     requestBody?: ISwaggerRoute.IRequestBody;

package/lib/structures/ISwaggerSchemaTuple.d.ts

@@ -0,0 +1,6 @@
+import { IJsonSchema } from "typia";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+export interface ISwaggerSchemaTuple {
+    metadata: Metadata;
+    schema: IJsonSchema;
+}

package/lib/structures/ISwaggerSchemaTuple.js

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

package/lib/structures/ISwaggerSchemaTuple.js.map

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

package/lib/structures/ITypeTuple.d.ts

@@ -1,5 +1,5 @@
 import ts from "typescript";
 export interface ITypeTuple {
     type: ts.Type;
-    name: string;
+    typeName: string;
 }