nestia 2.1.0-dev.20220413 → 2.1.0-dev.20220430

package/src/generates/FunctionGenerator.ts

@@ -1,201 +0,0 @@
-import type 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 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,113 +0,0 @@
-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
-{   
-    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);
-    }
-}

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 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 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));
-}

package/tsconfig.json

@@ -1,82 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig.json to read more about this file */
-
-    /* Basic Options */
-    // "incremental": true,                   /* Enable incremental compilation */
-    "target": "es5",                          /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */
-    "module": "commonjs",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */
-    "lib": [
-      "DOM",
-      "ES2015"
-    ],                             /* Specify library files to be included in the compilation. */
-    // "allowJs": true,                       /* Allow javascript files to be compiled. */
-    // "checkJs": true,                       /* Report errors in .js files. */
-    // "jsx": "preserve",                     /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */
-    // "declaration": true,                   /* Generates corresponding '.d.ts' file. */
-    // "declarationMap": true,                /* Generates a sourcemap for each corresponding '.d.ts' file. */
-    // "sourceMap": true,                     /* Generates corresponding '.map' file. */
-    // "outFile": "./",                       /* Concatenate and emit output to single file. */
-    // "outDir": "./lib",                        /* Redirect output structure to the directory. */
-    // "rootDir": "./",                       /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
-    // "composite": true,                     /* Enable project compilation */
-    // "tsBuildInfoFile": "./",               /* Specify file to store incremental compilation information */
-    // "removeComments": true,                /* Do not emit comments to output. */
-    "noEmit": true,                        /* Do not emit outputs. */
-    // "importHelpers": true,                 /* Import emit helpers from 'tslib'. */
-    "downlevelIteration": true,            /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
-    // "isolatedModules": true,               /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
-
-    /* Strict Type-Checking Options */
-    "strict": true,                           /* Enable all strict type-checking options. */
-    // "noImplicitAny": true,                 /* Raise error on expressions and declarations with an implied 'any' type. */
-    // "strictNullChecks": true,              /* Enable strict null checks. */
-    // "strictFunctionTypes": true,           /* Enable strict checking of function types. */
-    // "strictBindCallApply": true,           /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
-    // "strictPropertyInitialization": true,  /* Enable strict checking of property initialization in classes. */
-    // "noImplicitThis": true,                /* Raise error on 'this' expressions with an implied 'any' type. */
-    // "alwaysStrict": true,                  /* Parse in strict mode and emit "use strict" for each source file. */
-
-    /* Additional Checks */
-    "noUnusedLocals": true,                /* Report errors on unused locals. */
-    "noUnusedParameters": true,            /* Report errors on unused parameters. */
-    "noImplicitReturns": true,             /* Report error when not all code paths in function return a value. */
-    "noFallthroughCasesInSwitch": true,    /* Report errors for fallthrough cases in switch statement. */
-    // "noUncheckedIndexedAccess": true,      /* Include 'undefined' in index signature results */
-
-    /* Module Resolution Options */
-    // "moduleResolution": "node",            /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
-    // "baseUrl": "./",                       /* Base directory to resolve non-absolute module names. */
-    // "paths": {},                           /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
-    // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
-    // "typeRoots": [],                       /* List of folders to include type definitions from. */
-    "types": [
-      "node",
-      "reflect-metadata"
-    ],                           /* Type declaration files to be included in compilation. */
-    // "allowSyntheticDefaultImports": true,  /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
-    "esModuleInterop": true,                  /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
-    // "preserveSymlinks": true,              /* Do not resolve the real path of symlinks. */
-    // "allowUmdGlobalAccess": true,          /* Allow accessing UMD globals from modules. */
-
-    /* Source Map Options */
-    // "sourceRoot": "",                      /* Specify the location where debugger should locate TypeScript files instead of source locations. */
-    // "mapRoot": "",                         /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSourceMap": true,               /* Emit a single file with source maps instead of having a separate file. */
-    // "inlineSources": true,                 /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
-
-    /* Experimental Options */
-    "experimentalDecorators": true,        /* Enables experimental support for ES7 decorators. */
-    "emitDecoratorMetadata": true,         /* Enables experimental support for emitting type metadata for decorators. */
-    "stripInternal": true,
-
-    /* Advanced Options */
-    "skipLibCheck": true,                     /* Skip type checking of declaration files. */
-    "forceConsistentCasingInFileNames": true,  /* Disallow inconsistently-cased references to the same file. */
-    "plugins": [
-      { "transform": "typescript-is/lib/transform-inline/transformer" },
-      { "transform": "typescript-transform-paths" }
-    ]
-  },
-  "include": ["src"]
-}