nestia 2.1.0-dev.20220414 → 2.1.0-dev.20220430

package/src/generates/FunctionGenerator.ts

@@ -1,201 +0,0 @@
-import * as tsc from "typescript";
-import { Pair } from "tstl/utility/Pair";
-import { Vector } from "tstl/container/Vector";
-
-import { IRoute } from "../structures/IRoute";
-
-export namespace FunctionGenerator
-{
-    export function generate(assert: boolean, route: IRoute): string
-    {
-        const query: IRoute.IParameter | undefined = route.parameters.find(param => param.category === "query");
-        const input: IRoute.IParameter | undefined = route.parameters.find(param => param.category === "body");
-
-        return [head, body, tail]
-            .map(closure => closure(route, query, input, assert))
-            .filter(str => !!str)
-            .join("\n");
-    }
-
-    /* ---------------------------------------------------------
-        BODY
-    --------------------------------------------------------- */
-    function body
-        (
-            route: IRoute, 
-            query: IRoute.IParameter | undefined, 
-            input: IRoute.IParameter | undefined,
-            assert: boolean
-        ): string
-    {
-        // FETCH ARGUMENTS WITH REQUST BODY
-        const parameters = filter_parameters(route, query);
-        const fetchArguments: string[] = 
-        [
-            "connection",
-            `${route.name}.ENCRYPTED`,
-            `${route.name}.METHOD`,
-            `${route.name}.path(${parameters.map(p => p.name).join(", ")})`
-        ];
-        if (input !== undefined)
-            fetchArguments.push(input.name);
-
-        const assertions: string = assert === true && route.parameters.length !== 0
-            ? route.parameters
-                .map(param => `    assertType<typeof ${param.name}>(${param.name});`)
-                .join("\n") + "\n\n"
-            : "";
-
-        // RETURNS WITH FINALIZATION
-        return "{\n"
-            + assertions
-            + "    return Fetcher.fetch\n"
-            + "    (\n"
-            + fetchArguments.map(param => `        ${param}`).join(",\n") + "\n"
-            + "    );\n"
-            + "}";
-    }
-
-    function filter_parameters(route: IRoute, query: IRoute.IParameter | undefined): IRoute.IParameter[]
-    {
-        const parameters = route.parameters.filter(param => param.category === "param");
-        if (query)
-            parameters.push(query);
-        return parameters;
-    }
-
-    /* ---------------------------------------------------------
-        HEAD & TAIL
-    --------------------------------------------------------- */
-    function head
-        (
-            route: IRoute, 
-            query: IRoute.IParameter | undefined, 
-            input: IRoute.IParameter | undefined
-        ): string
-    {
-        //----
-        // CONSTRUCT COMMENT
-        //----
-        // MAIN DESCRIPTION
-        let comment: string = route.comments.map(comment => `${comment.kind === "linkText" ? " " : ""}${comment.text}`).join("");
-        if (comment !== "")
-            comment += "\n\n";
-
-        // FILTER TAGS (VULNERABLE PARAMETERS WOULD BE REMOVED)
-        const tagList: tsc.JSDocTagInfo[] = route.tags.filter(tag => tag.text !== undefined);
-        if (tagList.length !== 0)
-        {
-            const index: number = tagList.findIndex(t => t.name === "param");
-            if (index !== -1)
-            {
-                const capsule: Vector<tsc.JSDocTagInfo> = Vector.wrap(tagList);
-                capsule.insert(capsule.nth(index), {
-                    name: "param",
-                    text: [
-                        {
-                            kind: "parameterName",
-                            text: "connection"
-                        },
-                        {
-                            kind: "space",
-                            text: " "
-                        },
-                        { 
-                            kind: "text",
-                            text: "connection Information of the remote HTTP(s) server with headers (+encryption password)" 
-                        }
-                    ]
-                });
-            }
-            comment += tagList
-                .map(tag => `@${tag.name} ${tag.text!.map(elem => elem.text).join("")}`)
-                .join("\n") + "\n\n";
-        }
-        
-        // COMPLETE THE COMMENT
-        comment += `@nestia Generated by Nestia - https://github.com/samchon/nestia\n`;
-        comment += `@controller ${route.symbol}\n`;
-        comment += `@path ${route.method} ${route.path}`;
-
-        //----
-        // FINALIZATION
-        //----
-        // REFORM PARAMETERS TEXT
-        const parameters: string[] = 
-        [
-            "connection: IConnection",
-            ...route.parameters.map(param => 
-            {
-                const type: string = (param === query || param === input)
-                    ? `Primitive<${route.name}.${param === query ? "Query" : "Input"}>`
-                    : param.type
-                return `${param.name}: ${type}`;
-            })
-        ];
-
-        // OUTPUT TYPE
-        const output: string = route.output === "void"
-            ? "void"
-            : `${route.name}.Output`;
-
-        // RETURNS WITH CONSTRUCTION
-        return ""
-            + "/**\n"
-            + comment.split("\r\n").join("\n").split("\n").map(str => ` * ${str}`).join("\n") + "\n"
-            + " */\n"
-            + `export function ${route.name}\n` 
-            + `    (\n` 
-            + `${parameters.map(str => `        ${str}`).join(",\n")}\n`
-            + `    ): Promise<${output}>`;
-    }
-
-    function tail
-        (
-            route: IRoute, 
-            query: IRoute.IParameter | undefined, 
-            input: IRoute.IParameter | undefined
-        ): string | null
-    {
-        // LIST UP TYPES
-        const types: Pair<string, string>[] = [];
-        if (query !== undefined)
-            types.push(new Pair("Query", query.type));
-        if (input !== undefined)
-            types.push(new Pair("Input", input.type));
-        if (route.output !== "void")
-            types.push(new Pair("Output", route.output));
-        
-        // PATH WITH PARAMETERS
-        const parameters = filter_parameters(route, query);
-        let path: string = route.path;
-        for (const param of parameters)
-            if (param.category === "param")
-                path = path.replace(`:${param.field}`, `\${${param.name}}`);
-        path = (query !== undefined)
-            ? `\`${path}?\${new URLSearchParams(${query.name} as any).toString()}\``
-            : `\`${path}\``;
-
-        return `export namespace ${route.name}\n`
-            + "{\n"
-            + 
-            (
-                types.length !== 0
-                    ? types.map(tuple => `    export type ${tuple.first} = Primitive<${tuple.second}>;`).join("\n") + "\n"
-                    : ""
-            )
-            + "\n"
-            + `    export const METHOD = "${route.method}" as const;\n`
-            + `    export const PATH: string = "${route.path}";\n`
-            + `    export const ENCRYPTED: Fetcher.IEncrypted = {\n`
-            + `        request: ${input !== undefined && input.encrypted},\n`
-            + `        response: ${route.encrypted},\n`
-            + `    };\n`
-            + "\n"
-            + `    export function path(${parameters.map(param => `${param.name}: ${param.type}`).join(", ")}): string\n`
-            + `    {\n`
-            + `        return ${path};\n`
-            + `    }\n`
-            + "}";
-    }
-}

package/src/generates/SdkGenerator.ts

@@ -1,39 +0,0 @@
-import * as fs from "fs";
-import { DirectoryUtil } from "../utils/DirectoryUtil";
-
-import { IRoute } from "../structures/IRoute";
-import { FileGenerator } from "./FileGenerator";
-import { IConfiguration } from "../IConfiguration";
-
-export namespace SdkGenerator
-{
-    export async function generate
-        (
-            config: IConfiguration,
-            routeList: IRoute[],
-        ): Promise<void>
-    {
-        // PREPARE NEW DIRECTORIES
-        try { await fs.promises.mkdir(config.output); } catch {}
-
-        // BUNDLING
-        const bundle: string[] = await fs.promises.readdir(BUNDLE);
-        for (const file of bundle)
-        {
-            const current: string = `${BUNDLE}/${file}`;
-            const stats: fs.Stats = await fs.promises.stat(current);
-
-            if (stats.isFile() === true)
-            {
-                const content: string = await fs.promises.readFile(current, "utf8");
-                await fs.promises.writeFile(`${config.output}/${file}`, content, "utf8");
-            }
-        }
-        await DirectoryUtil.copy(BUNDLE + "/__internal", config.output + "/__internal");
-        
-        // FUNCTIONAL
-        await FileGenerator.generate(config, routeList);
-    }
-}
-
-const BUNDLE = __dirname + "/../bundle";

package/src/internal/CompilerOptions.ts

@@ -1,142 +0,0 @@
-import * as fs from "fs";
-
-export interface CompilerOptions
-{
-    target: string;
-    module: string;
-    lib: string[];
-    strict: boolean;
-    downlevelIteration: boolean;
-    esModuleInterop?: boolean;
-    plugins?: Array<{ 
-        transform?: string 
-    }>;
-    types?: string[];
-    experimentalDecorators?: boolean;
-    emitDecoratorMetadata?: boolean;
-}
-export namespace CompilerOptions
-{
-    /* -----------------------------------------------------------
-        DEFAULT VALUES
-    ----------------------------------------------------------- */
-    export const DEPENDENCIES: string[] = [
-        "nestia-fetcher", 
-        "typescript-is"
-    ];
-
-    export const TRANSFORMERS: string[] = [
-        "typescript-is/lib/transform-inline/transformer", 
-        "typescript-transform-paths"
-    ];
-
-    export const TYPES: string[] = []
-
-    export const DEFAULT = {
-        target: "es5",
-        module: "commonjs",
-        lib: [
-            "DOM", 
-            "ES2015"
-        ],
-        strict: true,
-        downlevelIteration: true,
-        esModuleInterop: true,
-        plugins: TRANSFORMERS.map(transform => ({ transform })),
-        types: [
-            "node",
-            "reflect-metadata"
-        ],
-        experimentalDecorators: true,
-        emitDecoratorMetadata: true,
-    };
-
-    export function emend(options: CompilerOptions): boolean
-    {
-        // FILL ARRAY DATA
-        if (!options.plugins)
-            options.plugins = [];
-        if (!options.types)
-            options.types = [];
-        
-        // CONSTRUCT CHECKERS
-        const emended: Required<CompilerOptions> = options as Required<CompilerOptions>;
-        const checkers: Array<() => boolean> = [
-            () => 
-            {
-                let changed: boolean = false;
-                for (const transform of CompilerOptions.TRANSFORMERS)
-                {
-                    if (emended.plugins.find(elem => elem.transform === transform) !== undefined)
-                        continue;
-    
-                    changed = true;
-                    emended.plugins.push({ transform });
-                }
-                return changed;
-            },
-            () =>
-            {
-                let changed: boolean = false;
-                for (const type of CompilerOptions.TYPES)
-                {
-                    if (emended.types.find(elem => elem === type) !== undefined)
-                        continue;
-    
-                    changed = true;
-                    emended.types.push(type);
-                }
-                return changed;
-            },
-            () =>
-            {
-                const changed: boolean = emended.experimentalDecorators !== true;
-                if (changed)
-                    emended.experimentalDecorators = true;
-                return changed;
-            },
-            () =>
-            {
-                const changed: boolean = emended.emitDecoratorMetadata !== true;
-                if (changed)
-                    emended.emitDecoratorMetadata = true;
-                return changed;
-            },
-            () =>
-            {
-                const changed: boolean = emended.esModuleInterop !== true;
-                if (changed)
-                    emended.esModuleInterop = true;
-                return changed;
-            }
-        ];
-
-        // DO CHECK IT
-        const checks: boolean[] = checkers.map(func => func());
-        return checks.some(flag => flag);
-    }
-
-    /* -----------------------------------------------------------
-        PROCEDURES
-    ----------------------------------------------------------- */
-    export function temporary(config: IConfig): () => Promise<[string, () => Promise<void>]>
-    {
-        return async () =>
-        {
-            const file: string = `nestia.temporary.tsconfig.${Math.random().toString().substr(2)}.json`;
-            
-            await fs.promises.writeFile
-            (
-                file,
-                JSON.stringify(config, null, 2),
-                "utf8" 
-            );
-            return [file, () => fs.promises.unlink(file)];
-        };
-    }
-}
-
-interface IConfig
-{
-    compilerOptions?: CompilerOptions;
-}

package/src/structures/MethodType.ts

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

package/src/structures/ParamCategory.ts

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

package/src/utils/ArrayUtil.ts

@@ -1,26 +0,0 @@
-export namespace ArrayUtil
-{
-    export function has<T>(array: T[], ...items: T[]): boolean
-    {
-        return items.every(elem => array.find(org => org === elem) !== undefined);
-    }
-
-    export async function asyncMap<Input, Output>
-        (array: Input[], closure: (input: Input) => Promise<Output>): Promise<Output[]>
-    {
-        const ret: Output[] = [];
-        for (const elem of array)
-            ret.push(await closure(elem));
-        return ret;
-    }
-
-    export async function asyncFilter<Input>
-        (array: Input[], closure: (input: Input) => Promise<boolean>): Promise<Input[]>
-    {
-        const ret: Input[] = [];
-        for (const elem of array)
-            if (await closure(elem) === true)
-                ret.push(elem);
-        return ret;
-    }
-}

package/src/utils/DirectoryUtil.ts

@@ -1,48 +0,0 @@
-import del from "del";
-import * as fs from "fs";
-
-export namespace DirectoryUtil
-{
-    export async function remove(path: string): Promise<void>
-    {
-        try 
-        { 
-            await del(path);
-        }
-        catch {}
-    }
-
-    export async function remake(path: string): Promise<void>
-    {
-        await remove(path);
-        await fs.promises.mkdir(path);
-    }
-
-    export async function copy(from: string, to: string): Promise<void>
-    {
-        await remake(to);
-        await _Copy(from, to);
-    }
-
-    async function _Copy(from: string, to: string): Promise<void>
-    {
-        const directory: string[] = await fs.promises.readdir(from);
-        for (const file of directory)
-        {
-            const fromPath: string = `${from}/${file}`;
-            const toPath: string = `${to}/${file}`;
-            const stats: fs.Stats = await fs.promises.stat(fromPath);
-
-            if (stats.isDirectory() === true)
-            {
-                await fs.promises.mkdir(toPath);
-                await _Copy(fromPath, toPath);
-            }
-            else
-            {
-                const content: string = await fs.promises.readFile(fromPath, "utf8");
-                await fs.promises.writeFile(toPath, content.split("\r\n").join("\n"), "utf8");
-            }
-        }
-    }
-}

package/src/utils/ImportDictionary.ts

@@ -1,44 +0,0 @@
-import * as path from "path";
-
-import { HashMap } from "tstl/container/HashMap";
-import { HashSet } from "tstl/container/HashSet";
-import { Pair } from "tstl/utility/Pair";
-
-export class ImportDictionary
-{
-    private readonly dict_: HashMap<string, Pair<boolean, HashSet<string>>> = new HashMap();
-
-    public empty(): boolean
-    {
-        return this.dict_.empty();
-    }
-
-    public emplace(file: string, realistic: boolean, instance: string): void
-    {
-        if (file.substr(-5) === ".d.ts")
-            file = file.substr(0, file.length - 5);
-        else if (file.substr(-3) === ".ts")
-            file = file.substr(0, file.length - 3);
-        else
-            throw new Error(`Error on ImportDictionary.emplace(): extension of the target file "${file}" is not "ts".`);
-
-        let it = this.dict_.find(file);
-        if (it.equals(this.dict_.end()) === true)
-            it = this.dict_.emplace(file, new Pair(realistic, new HashSet())).first;
-        it.second.second.insert(instance);
-    }
-
-    public toScript(outDir: string): string
-    {
-        const statements: string[] = [];
-        for (const it of this.dict_)
-        {
-            const file: string = path.relative(outDir, it.first).split("\\").join("/");
-            const realistic: boolean = it.second.first;
-            const instances: string[] = it.second.second.toJSON();
-
-            statements.push(`import ${!realistic ? "type " : ""}{ ${instances.join(", ")} } from "./${file}";`);
-        }
-        return statements.join("\n");
-    }
-}

package/src/utils/StringUtil.ts

@@ -1,10 +0,0 @@
-export namespace StringUtil
-{
-    export function betweens(str: string, start: string, end: string): string[]
-    {
-        const ret: string[] = str.split(start);
-        ret.splice(0, 1);
-
-        return ret.map(str => str.split(end)[0]);
-    }
-}

package/src/utils/stripJsonComments.ts

@@ -1,79 +0,0 @@
-// https://github.com/sindresorhus/strip-json-comments
-
-const singleComment: any = Symbol('singleComment');
-const multiComment: any = Symbol('multiComment');
-
-const stripWithoutWhitespace = () => '';
-const stripWithWhitespace = (string: string, start: number, end: number) => string.slice(start, end).replace(/\S/g, ' ');
-
-const isEscaped = (jsonString: string, quotePosition: number) => {
-    let index = quotePosition - 1;
-    let backslashCount = 0;
-
-    while (jsonString[index] === '\\') {
-        index -= 1;
-        backslashCount += 1;
-    }
-
-    return Boolean(backslashCount % 2);
-};
-
-export function stripJsonComments(jsonString: string, {whitespace = true} = {}) {
-    if (typeof jsonString !== 'string') {
-        throw new TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof jsonString}\``);
-    }
-
-    const strip = whitespace ? stripWithWhitespace : stripWithoutWhitespace;
-
-    let isInsideString = false;
-    let isInsideComment = false;
-    let offset = 0;
-    let result = '';
-
-    for (let index = 0; index < jsonString.length; index++) {
-        const currentCharacter = jsonString[index];
-        const nextCharacter = jsonString[index + 1];
-
-        if (!isInsideComment && currentCharacter === '"') {
-            const escaped = isEscaped(jsonString, index);
-            if (!escaped) {
-                isInsideString = !isInsideString;
-            }
-        }
-
-        if (isInsideString) {
-            continue;
-        }
-
-        if (!isInsideComment && currentCharacter + nextCharacter === '//') {
-            result += jsonString.slice(offset, index);
-            offset = index;
-            isInsideComment = singleComment;
-            index++;
-        } else if (isInsideComment === singleComment && currentCharacter + nextCharacter === '\r\n') {
-            index++;
-            isInsideComment = false;
-            result += strip(jsonString, offset, index);
-            offset = index;
-            continue;
-        } else if (isInsideComment === singleComment && currentCharacter === '\n') {
-            isInsideComment = false;
-            result += strip(jsonString, offset, index);
-            offset = index;
-        } else if (!isInsideComment && currentCharacter + nextCharacter === '/*') {
-            result += jsonString.slice(offset, index);
-            offset = index;
-            isInsideComment = multiComment;
-            index++;
-            continue;
-        } else if (isInsideComment === multiComment && currentCharacter + nextCharacter === '*/') {
-            index++;
-            isInsideComment = false;
-            result += strip(jsonString, offset, index + 1);
-            offset = index + 1;
-            continue;
-        }
-    }
-
-    return result + (isInsideComment ? (strip as any)(jsonString.slice(offset)) : jsonString.slice(offset));
-}