@nestia/sdk 0.1.0

package/lib/generates/SwaggerGenerator.js

@@ -0,0 +1,244 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerGenerator = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const Singleton_1 = require("tstl/thread/Singleton");
+const VariadicSingleton_1 = require("tstl/thread/VariadicSingleton");
+const CommentFactory_1 = require("typia/lib/factories/CommentFactory");
+const MetadataCollection_1 = require("typia/lib/factories/MetadataCollection");
+const MetadataFactory_1 = require("typia/lib/factories/MetadataFactory");
+const ApplicationProgrammer_1 = require("typia/lib/programmers/ApplicationProgrammer");
+const MapUtil_1 = require("../utils/MapUtil");
+var SwaggerGenerator;
+(function (SwaggerGenerator) {
+    function generate(checker, config, routeList) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // PREPARE ASSETS
+            const parsed = path_1.default.parse(config.output);
+            const location = !!parsed.ext
+                ? path_1.default.resolve(config.output)
+                : path_1.default.join(path_1.default.resolve(config.output), "swagger.json");
+            const collection = new MetadataCollection_1.MetadataCollection({
+                replace: MetadataCollection_1.MetadataCollection.replace,
+            });
+            // CONSTRUCT SWAGGER DOCUMENTS
+            const tupleList = [];
+            const swagger = yield initialize(location);
+            const pathDict = new Map();
+            for (const route of routeList) {
+                const path = MapUtil_1.MapUtil.take(pathDict, get_path(route.path, route.parameters), () => ({}));
+                path[route.method.toLowerCase()] = generate_route(checker, collection, tupleList, route);
+            }
+            swagger.paths = {};
+            for (const [path, routes] of pathDict) {
+                swagger.paths[path] = routes;
+            }
+            // FILL JSON-SCHEMAS
+            const application = ApplicationProgrammer_1.ApplicationProgrammer.generate(tupleList.map(({ metadata }) => metadata), {
+                purpose: "swagger",
+            });
+            swagger.components = Object.assign(Object.assign({}, (swagger.components || {})), { schemas: application.components.schemas });
+            tupleList.forEach(({ schema }, index) => {
+                Object.assign(schema, application.schemas[index]);
+            });
+            // ERASE IJsonComponents.IObject.$id
+            for (const obj of Object.values(swagger.components.schemas))
+                if (obj.$id)
+                    delete obj.$id;
+            // DO GENERATE
+            yield fs_1.default.promises.writeFile(location, JSON.stringify(swagger, null, 2), "utf8");
+        });
+    }
+    SwaggerGenerator.generate = generate;
+    /* ---------------------------------------------------------
+        INITIALIZERS
+    --------------------------------------------------------- */
+    function initialize(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // LOAD OR CREATE NEW SWAGGER DATA
+            const swagger = fs_1.default.existsSync(path)
+                ? JSON.parse(yield fs_1.default.promises.readFile(path, "utf8"))
+                : {
+                    openapi: "3.0.1",
+                    servers: [
+                        {
+                            url: "https://github.com/samchon/nestia",
+                            description: "insert your server url",
+                        },
+                    ],
+                    info: {
+                        version: "0.1.0",
+                        title: "Generated by nestia - https://github.com/samchon/nestia",
+                    },
+                    paths: {},
+                    components: {},
+                };
+            // RETURNS
+            return swagger;
+        });
+    }
+    function get_path(path, parameters) {
+        const filtered = parameters.filter((param) => param.category === "param" && !!param.field);
+        for (const param of filtered)
+            path = path.replace(`:${param.field}`, `{${param.field}}`);
+        return path;
+    }
+    function generate_route(checker, collection, tupleList, route) {
+        const bodyParam = route.parameters.find((param) => param.category === "body");
+        const tags = route.tags
+            .filter((tag) => tag.name === "tag" &&
+            tag.text &&
+            tag.text.find((elem) => elem.kind === "text" && elem.text.length) !== undefined)
+            .map((tag) => tag.text.find((elem) => elem.kind === "text").text);
+        const encrypted = route.encrypted === true ||
+            !!route.parameters.find((param) => param.encrypted === true);
+        return {
+            tags,
+            summary: encrypted ? "encrypted" : undefined,
+            parameters: route.parameters
+                .filter((param) => param.category !== "body")
+                .map((param) => generate_parameter(checker, collection, tupleList, route, param)),
+            requestBody: bodyParam
+                ? generate_request_body(checker, collection, tupleList, route, bodyParam)
+                : undefined,
+            responses: generate_response_body(checker, collection, tupleList, route),
+            description: CommentFactory_1.CommentFactory.generate(route.comments),
+        };
+    }
+    /* ---------------------------------------------------------
+        REQUEST & RESPONSE
+    --------------------------------------------------------- */
+    function generate_parameter(checker, collection, tupleList, route, parameter) {
+        const schema = generate_schema(checker, collection, tupleList, parameter.type.type);
+        if (schema === null)
+            throw new Error(`Error on NestiaApplication.sdk(): invalid parameter type on ${route.symbol}#${parameter.name}`);
+        return {
+            name: parameter.field || parameter.name,
+            in: parameter.category === "param" ? "path" : parameter.category,
+            description: get_parametric_description(route, "param", parameter.name) ||
+                "",
+            schema,
+            required: true,
+        };
+    }
+    function generate_request_body(checker, collection, tupleList, route, parameter) {
+        const schema = generate_schema(checker, collection, tupleList, parameter.type.type);
+        if (schema === null)
+            throw new Error(`Error on NestiaApplication.sdk(): invalid request body type on ${route.symbol}.`);
+        return {
+            description: warning.get(parameter.encrypted).get("request") +
+                (get_parametric_description(route, "param", parameter.name) ||
+                    ""),
+            content: {
+                "application/json": {
+                    schema,
+                },
+            },
+            required: true,
+        };
+    }
+    function generate_response_body(checker, collection, tupleList, route) {
+        // OUTPUT WITH SUCCESS STATUS
+        const status = route.method === "GET" || route.method === "DELETE" ? "200" : "201";
+        const schema = generate_schema(checker, collection, tupleList, route.output.type);
+        const success = {
+            [status]: {
+                description: warning.get(route.encrypted).get("response", route.method) +
+                    (get_parametric_description(route, "return") ||
+                        get_parametric_description(route, "returns") ||
+                        ""),
+                content: schema === null || route.output.name === "void"
+                    ? undefined
+                    : {
+                        "application/json": {
+                            schema,
+                        },
+                    },
+            },
+        };
+        // EXCEPTION STATUSES
+        const exceptions = Object.fromEntries(route.tags
+            .filter((tag) => tag.name === "throw" &&
+            tag.text &&
+            tag.text.find((elem) => elem.kind === "text" &&
+                isNaN(Number(elem.text
+                    .split(" ")
+                    .map((str) => str.trim())[0])) === false) !== undefined)
+            .map((tag) => {
+            const text = tag.text.find((elem) => elem.kind === "text").text;
+            const elements = text
+                .split(" ")
+                .map((str) => str.trim());
+            return [
+                elements[0],
+                {
+                    description: elements.slice(1).join(" "),
+                },
+            ];
+        }));
+        return Object.assign(Object.assign({}, exceptions), success);
+    }
+    /* ---------------------------------------------------------
+        UTILS
+    --------------------------------------------------------- */
+    function generate_schema(checker, collection, tupleList, type) {
+        const metadata = MetadataFactory_1.MetadataFactory.generate(checker, collection, type, {
+            resolve: false,
+            constant: true,
+        });
+        if (metadata.empty() && metadata.nullable === false)
+            return null;
+        const schema = {};
+        tupleList.push({ metadata, schema });
+        return schema;
+    }
+    function get_parametric_description(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;
+    }
+})(SwaggerGenerator = exports.SwaggerGenerator || (exports.SwaggerGenerator = {}));
+const warning = new VariadicSingleton_1.VariadicSingleton((encrypted) => {
+    if (encrypted === false)
+        return new Singleton_1.Singleton(() => "");
+    return new VariadicSingleton_1.VariadicSingleton((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)`;
+        return `## 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.
+
+-----------------
+
+`;
+    });
+});
+//# sourceMappingURL=SwaggerGenerator.js.map

package/lib/generates/SwaggerGenerator.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+import * as nestia from "./module";
+export default nestia;

package/lib/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const nestia = __importStar(require("./module"));
+exports.default = nestia;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAmC;AAEnC,kBAAe,MAAM,CAAC"}

package/lib/module.d.ts

@@ -0,0 +1,2 @@
+export * from "./INestiaConfig";
+export * from "./NestiaSdkApplication";

package/lib/module.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./INestiaConfig"), exports);
+__exportStar(require("./NestiaSdkApplication"), exports);
+//# sourceMappingURL=module.js.map

package/lib/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,yDAAuC"}

package/lib/structures/IController.d.ts

@@ -0,0 +1,23 @@
+import { ParamCategory } from "./ParamCategory";
+export interface IController {
+    file: string;
+    name: string;
+    paths: string[];
+    functions: IController.IFunction[];
+}
+export declare namespace IController {
+    interface IFunction {
+        name: string;
+        method: string;
+        paths: string[];
+        encrypted: boolean;
+        parameters: IParameter[];
+    }
+    interface IParameter {
+        name: string;
+        index: number;
+        field: string | undefined;
+        category: ParamCategory;
+        encrypted: boolean;
+    }
+}

package/lib/structures/IController.js

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

package/lib/structures/IController.js.map

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

package/lib/structures/IRoute.d.ts

@@ -0,0 +1,24 @@
+import ts from "typescript";
+import { ITypeTuple } from "./ITypeTuple";
+import { ParamCategory } from "./ParamCategory";
+export interface IRoute {
+    name: string;
+    method: string;
+    path: string;
+    encrypted: boolean;
+    parameters: IRoute.IParameter[];
+    imports: [string, string[]][];
+    output: ITypeTuple;
+    symbol: string;
+    comments: ts.SymbolDisplayPart[];
+    tags: ts.JSDocTagInfo[];
+}
+export declare namespace IRoute {
+    interface IParameter {
+        name: string;
+        field: string | undefined;
+        category: ParamCategory;
+        encrypted: boolean;
+        type: ITypeTuple;
+    }
+}

package/lib/structures/IRoute.js

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

package/lib/structures/IRoute.js.map

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

package/lib/structures/ISwagger.d.ts

@@ -0,0 +1,48 @@
+import { IJsonComponents, IJsonSchema } from "typia";
+export interface ISwagger {
+    openapi: "3.0";
+    servers: ISwagger.IServer[];
+    info: ISwagger.IInfo;
+    paths: Record<string, ISwagger.IPath>;
+    components: IJsonComponents;
+}
+export declare namespace ISwagger {
+    type IPath = Record<string, IRoute>;
+    interface IRoute {
+        description: string;
+        tags: string[];
+        parameters: IParameter[];
+        responses: IResponseBody;
+        requestBody?: IRequestBody;
+        summary?: string;
+    }
+    interface IInfo {
+        version: string;
+        title: string;
+    }
+    interface IParameter {
+        name: string;
+        in: string;
+        schema: IJsonSchema;
+        required: true;
+        description: string;
+    }
+    interface IRequestBody {
+        description: string;
+        content: IJsonContent;
+        required: true;
+    }
+    type IResponseBody = Record<string, {
+        description: string;
+        content?: IJsonContent;
+    }>;
+    interface IServer {
+        url: string;
+        description?: string;
+    }
+    interface IJsonContent {
+        "application/json": {
+            schema: IJsonSchema;
+        };
+    }
+}

package/lib/structures/ISwagger.js

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

package/lib/structures/ISwagger.js.map

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

package/lib/structures/ITypeTuple.d.ts

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

package/lib/structures/ITypeTuple.js

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

package/lib/structures/ITypeTuple.js.map

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

package/lib/structures/MethodType.d.ts

@@ -0,0 +1,4 @@
+export type MethodType = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export declare namespace MethodType {
+    const VALUES: MethodType[];
+}

package/lib/structures/MethodType.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodType = void 0;
+var MethodType;
+(function (MethodType) {
+    MethodType.VALUES = [
+        "GET",
+        "POST",
+        "PUT",
+        "PATCH",
+        "DELETE",
+    ];
+})(MethodType = exports.MethodType || (exports.MethodType = {}));
+//# sourceMappingURL=MethodType.js.map

package/lib/structures/MethodType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodType.js","sourceRoot":"","sources":["../../src/structures/MethodType.ts"],"names":[],"mappings":";;;AAEA,IAAiB,UAAU,CAQ1B;AARD,WAAiB,UAAU;IACV,iBAAM,GAAiB;QAChC,KAAK;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,QAAQ;KACX,CAAC;AACN,CAAC,EARgB,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAQ1B"}

package/lib/structures/ParamCategory.d.ts

@@ -0,0 +1 @@
+export type ParamCategory = "param" | "query" | "body";

package/lib/structures/ParamCategory.js

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

package/lib/structures/ParamCategory.js.map

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

package/lib/structures/TypeEntry.d.ts

@@ -0,0 +1,9 @@
+import ts from "typescript";
+export declare class TypeEntry {
+    readonly type: ts.Type;
+    readonly nullable: boolean;
+    readonly required: boolean;
+    constructor(type: ts.Type, nullable: boolean, required: boolean);
+    equals(obj: TypeEntry): boolean;
+    hashCode(): number;
+}

package/lib/structures/TypeEntry.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeEntry = void 0;
+const hash_1 = require("tstl/functional/hash");
+class TypeEntry {
+    constructor(type, nullable, required) {
+        this.type = type;
+        this.nullable = nullable;
+        this.required = required;
+    }
+    equals(obj) {
+        return (this.type === obj.type &&
+            this.nullable === obj.nullable &&
+            this.required === obj.required);
+    }
+    hashCode() {
+        return (0, hash_1.hash)(this.type, this.nullable, this.required);
+    }
+}
+exports.TypeEntry = TypeEntry;
+//# sourceMappingURL=TypeEntry.js.map

package/lib/structures/TypeEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeEntry.js","sourceRoot":"","sources":["../../src/structures/TypeEntry.ts"],"names":[],"mappings":";;;AAAA,+CAA4C;AAG5C,MAAa,SAAS;IAClB,YACoB,IAAa,EACb,QAAiB,EACjB,QAAiB;QAFjB,SAAI,GAAJ,IAAI,CAAS;QACb,aAAQ,GAAR,QAAQ,CAAS;QACjB,aAAQ,GAAR,QAAQ,CAAS;IAClC,CAAC;IAEG,MAAM,CAAC,GAAc;QACxB,OAAO,CACH,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;YACtB,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ;YAC9B,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,CACjC,CAAC;IACN,CAAC;IAEM,QAAQ;QACX,OAAO,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;CACJ;AAlBD,8BAkBC"}

package/lib/test/TestBuilder.d.ts

@@ -0,0 +1,4 @@
+export declare namespace TestBuilder {
+    function generate(name: string, job: "sdk" | "swagger", argv: string[]): Promise<void>;
+    function test(name: string): Promise<void>;
+}

package/lib/test/TestBuilder.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestBuilder = void 0;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const NestiaSdkCommand_1 = require("../executable/internal/NestiaSdkCommand");
+var TestBuilder;
+(function (TestBuilder) {
+    function generate(name, job, argv) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const task = job === "sdk"
+                ? {
+                    generate: NestiaSdkCommand_1.NestiaSdkCommand.sdk,
+                    file: "src/api/functional/index.ts",
+                }
+                : {
+                    generate: NestiaSdkCommand_1.NestiaSdkCommand.swagger,
+                    file: "swagger.json",
+                };
+            process.chdir(`${PATH}/../../demo/${name}`);
+            if (fs_1.default.existsSync(task.file))
+                yield fs_1.default.promises.unlink(task.file);
+            try {
+                yield task.generate(argv, false);
+                if (fs_1.default.existsSync(task.file) === false)
+                    throw new Error(`Bug on NestiaCommand.${job}(): failed to generate file(s).`);
+            }
+            catch (exp) {
+                console.log(exp);
+                throw exp;
+            }
+        });
+    }
+    TestBuilder.generate = generate;
+    function test(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            process.chdir(`${PATH}/../../demo/${name}`);
+            try {
+                child_process_1.default.execSync("npx ts-node -C ttypescript src/test", {
+                    stdio: "inherit",
+                });
+            }
+            catch (exp) {
+                console.log(exp);
+                throw exp;
+            }
+        });
+    }
+    TestBuilder.test = test;
+    const PATH = __dirname;
+})(TestBuilder = exports.TestBuilder || (exports.TestBuilder = {}));
+//# sourceMappingURL=TestBuilder.js.map

package/lib/test/TestBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestBuilder.js","sourceRoot":"","sources":["../../src/test/TestBuilder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAA+B;AAC/B,4CAAoB;AAEpB,8EAA2E;AAE3E,IAAiB,WAAW,CA8C3B;AA9CD,WAAiB,WAAW;IACxB,SAAsB,QAAQ,CAC1B,IAAY,EACZ,GAAsB,EACtB,IAAc;;YAEd,MAAM,IAAI,GACN,GAAG,KAAK,KAAK;gBACT,CAAC,CAAC;oBACI,QAAQ,EAAE,mCAAgB,CAAC,GAAG;oBAC9B,IAAI,EAAE,6BAA6B;iBACtC;gBACH,CAAC,CAAC;oBACI,QAAQ,EAAE,mCAAgB,CAAC,OAAO;oBAClC,IAAI,EAAE,cAAc;iBACvB,CAAC;YAEZ,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,eAAe,IAAI,EAAE,CAAC,CAAC;YAC5C,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,YAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAElE,IAAI;gBACA,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACjC,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK;oBAClC,MAAM,IAAI,KAAK,CACX,wBAAwB,GAAG,iCAAiC,CAC/D,CAAC;aACT;YAAC,OAAO,GAAG,EAAE;gBACV,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,GAAG,CAAC;aACb;QACL,CAAC;KAAA;IA7BqB,oBAAQ,WA6B7B,CAAA;IAED,SAAsB,IAAI,CAAC,IAAY;;YACnC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,eAAe,IAAI,EAAE,CAAC,CAAC;YAE5C,IAAI;gBACA,uBAAE,CAAC,QAAQ,CAAC,qCAAqC,EAAE;oBAC/C,KAAK,EAAE,SAAS;iBACnB,CAAC,CAAC;aACN;YAAC,OAAO,GAAG,EAAE;gBACV,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,GAAG,CAAC;aACb;QACL,CAAC;KAAA;IAXqB,gBAAI,OAWzB,CAAA;IAED,MAAM,IAAI,GAAG,SAAS,CAAC;AAC3B,CAAC,EA9CgB,WAAW,GAAX,mBAAW,KAAX,mBAAW,QA8C3B"}

package/lib/test/index.d.ts

@@ -0,0 +1 @@
+export {};