tspace-spear 1.2.5 → 1.2.6-beta.2

package/dist/lib/core/compiler/generator.js

@@ -0,0 +1,365 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRoutes = generateRoutes;
+const ts_morph_1 = require("ts-morph");
+const typescript_1 = __importDefault(require("typescript"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const HTTP_METHODS = {
+    Get: "GET",
+    Post: "POST",
+    Put: "PUT",
+    Patch: "PATCH",
+    Delete: "DELETE",
+    Options: "OPTIONS",
+    Head: "HEAD",
+};
+function normalizePath(p) {
+    return ("/" +
+        p
+            .replace(/['"`]/g, "")
+            .replace(/\/+/g, "/")
+            .replace(/\/$/, "")
+            .replace(/^\//, ""));
+}
+function splitTopLevel(input) {
+    const parts = [];
+    let current = "";
+    let depth = 0;
+    for (const char of input) {
+        if (char === "{")
+            depth++;
+        if (char === "}")
+            depth--;
+        if (char === ";" && depth === 0) {
+            parts.push(current.trim());
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        parts.push(current.trim());
+    }
+    return parts;
+}
+function parseType(type) {
+    type = type.trim();
+    if (type === "never") {
+        return null;
+    }
+    if (type.startsWith("Record<")) {
+        return {};
+    }
+    if (type.startsWith("Partial<")) {
+        const inner = type
+            .replace(/^Partial</, "")
+            .replace(/>$/, "");
+        const parsed = parseType(inner);
+        if (parsed &&
+            typeof parsed === "object" &&
+            !Array.isArray(parsed)) {
+            for (const key in parsed) {
+                parsed[key] =
+                    parsed[key] + " | null";
+            }
+        }
+        return parsed;
+    }
+    if (type.startsWith("Promise<")) {
+        const inner = type
+            .replace(/^Promise</, "")
+            .replace(/>$/, "");
+        return parseType(inner);
+    }
+    if (type.endsWith("[]")) {
+        return [parseType(type.slice(0, -2))];
+    }
+    if (type.startsWith("{") &&
+        type.endsWith("}")) {
+        const result = {};
+        const content = type.slice(1, -1);
+        const fields = splitTopLevel(content)
+            .map((x) => x.trim())
+            .filter(Boolean);
+        for (const field of fields) {
+            const match = field.match(/^(\w+)(\??):\s*(.+)$/);
+            if (!match)
+                continue;
+            const [, key, optional, value] = match;
+            let parsed;
+            if (value === "string") {
+                parsed = optional
+                    ? "string | null"
+                    : "string";
+            }
+            else if (value === "number") {
+                parsed = optional
+                    ? "number | null"
+                    : "number";
+            }
+            else if (value === "boolean") {
+                parsed = optional
+                    ? "boolean | null"
+                    : "boolean";
+            }
+            else {
+                parsed = parseType(value);
+            }
+            result[key] = parsed;
+        }
+        return result;
+    }
+    if (type === "string")
+        return "string";
+    if (type === "number")
+        return "number";
+    if (type === "boolean")
+        return "boolean";
+    if (type === "date")
+        return "date";
+    if (type === "string | undefined")
+        return "string";
+    if (type === "number | undefined")
+        return "number";
+    if (type === "boolean | undefined")
+        return "boolean";
+    if (type === "date | undefined")
+        return "date";
+    if (type.includes("| undefined")) {
+        return type;
+    }
+    if (type.includes("| null")) {
+        return type;
+    }
+    if (type.includes(" | ") && !type.startsWith("{")) {
+        return type.replace(/"/g, "");
+    }
+    // fallback
+    return {
+        $ref: type
+    };
+}
+function resolveType(type) {
+    if (type.getSymbol()?.getName() === "Promise") {
+        type = type.getTypeArguments()[0];
+    }
+    if (type.isString())
+        return "string";
+    if (type.isNumber())
+        return "number";
+    if (type.isBoolean())
+        return "boolean";
+    if (type.isNull())
+        return "null";
+    if (type.isUndefined())
+        return "undefined";
+    if (type.isAny())
+        return "any";
+    if (type.isUnknown())
+        return "unknown";
+    if (type.isUnion())
+        return type.getText();
+    if (type.isArray()) {
+        const el = type.getArrayElementTypeOrThrow();
+        return `${resolveType(el)}[]`;
+    }
+    const props = type.getProperties();
+    if (props.length) {
+        const obj = [];
+        for (const prop of props) {
+            const decl = prop.getDeclarations()[0];
+            if (!decl)
+                continue;
+            const propType = prop.getTypeAtLocation(decl);
+            const text = propType.getText(decl);
+            const key = prop.getName();
+            let value = resolveType(propType);
+            if (/^\s*(\(.*\)\s*=>|function\b)/.test(value)) {
+                continue;
+            }
+            if (text.includes('[x: string]')) {
+                value = text;
+            }
+            ;
+            let colon = ":";
+            const maybeOptional = value.includes(" | undefined");
+            if (maybeOptional) {
+                value = value.replace(" | undefined", "");
+                colon = "?:";
+            }
+            obj.push(`${key}${colon} ${value}`);
+        }
+        return `{ ${obj.join("; ")} }`;
+    }
+    return type.getText();
+}
+function extractPropertyType(type, key, node) {
+    const prop = type.getProperty(key);
+    if (!prop)
+        return "never";
+    const t = prop.getTypeAtLocation(node);
+    const text = t.getText(node);
+    if (text.includes('[x: string]'))
+        return text;
+    if (!text || text.includes("undefined"))
+        return "never";
+    return resolveType(t) ?? "never";
+}
+async function generateRoutes(options) {
+    const project = new ts_morph_1.Project({
+        tsConfigFilePath: path_1.default.resolve(process.cwd(), "tsconfig.json"),
+    });
+    project.addSourceFilesAtPaths(path_1.default.join(options.controllers.folder, "**/*"));
+    const files = project.getSourceFiles();
+    if (!files.length) {
+        console.log("No controller files found");
+        return;
+    }
+    const routes = [];
+    for (const file of files) {
+        const filename = file.getBaseName();
+        if (!options.controllers.name.test(filename))
+            continue;
+        for (const cls of file.getClasses()) {
+            const controller = cls.getDecorator("Controller");
+            if (!controller)
+                continue;
+            const basePath = controller.getArguments()[0]
+                ?.getText()
+                .replace(/['"`]/g, "") || "";
+            for (const method of cls.getMethods()) {
+                for (const [decName, http] of Object.entries(HTTP_METHODS)) {
+                    const decorator = method.getDecorator(decName);
+                    if (!decorator)
+                        continue;
+                    const methodPath = decorator
+                        .getArguments()[0]
+                        ?.getText()
+                        .replace(/['"`]/g, "") || "";
+                    const fullPath = normalizePath(`${basePath}/${methodPath}`);
+                    const response = resolveType(method.getReturnType());
+                    let body = "never";
+                    let params = "never";
+                    let query = "never";
+                    let files = "never";
+                    const firstParam = method.getParameters()[0];
+                    if (firstParam) {
+                        const type = firstParam.getType();
+                        body = extractPropertyType(type, "body", firstParam);
+                        params = extractPropertyType(type, "params", firstParam);
+                        query = extractPropertyType(type, "query", firstParam);
+                        files = extractPropertyType(type, "files", firstParam);
+                    }
+                    routes.push({
+                        method: http,
+                        path: fullPath,
+                        response,
+                        body,
+                        params,
+                        query,
+                        files,
+                    });
+                }
+            }
+        }
+    }
+    const groupedTypes = routes.reduce((acc, r) => {
+        acc[r.path] ??= {};
+        acc[r.path][r.method] = {
+            response: r.response,
+            body: r.body,
+            params: r.params,
+            query: r.query,
+            files: r.files,
+        };
+        return acc;
+    }, {});
+    const routeMapTypes = Object.entries(groupedTypes)
+        .map(([path, methods]) => {
+        const methodBlock = Object.entries(methods)
+            .map(([method, c]) => `
+    ${method}: {
+      params: ${c.params}
+      query: ${c.query}
+      body: ${c.body}
+      files: ${c.files}
+      response: ${c.response}
+    }`).join("\n");
+        return `
+  "${path}": {
+  ${methodBlock}
+  }`;
+    })
+        .join("\n");
+    const formatValue = (v) => {
+        if (typeof v === "string")
+            return v;
+        return JSON.stringify(v);
+    };
+    const groupedValues = routes.reduce((acc, route) => {
+        if (!acc[route.path]) {
+            acc[route.path] = {};
+        }
+        acc[route.path][route.method] = {
+            params: parseType(route.params),
+            query: parseType(route.query),
+            body: parseType(route.body),
+            files: parseType(route.files),
+            response: parseType(route.response),
+        };
+        return acc;
+    }, {});
+    const routerMapValues = Object.entries(groupedValues)
+        .map(([path, methods]) => {
+        const methodBlock = Object.entries(methods)
+            .map(([method, c]) => `
+    ${method}: {
+      params: ${formatValue(c.params)},
+      query: ${formatValue(c.query)},
+      body: ${formatValue(c.body)},
+      files: ${formatValue(c.files)},
+      response: ${formatValue(c.response)}
+    }`).join(",\n");
+        return `
+  "${path}": {
+  ${methodBlock}
+  }`;
+    })
+        .join(",\n");
+    const output = `
+// @ts-nocheck
+// AUTO GENERATED FILE
+// DO NOT EDIT
+
+export const appRoutes = {
+${routerMapValues}
+}
+
+export interface AppRoutes {
+${routeMapTypes}
+}
+
+export type AppRoute = keyof AppRoutes
+`;
+    const outPath = options.output
+        ? `${__dirname}/${options.output}/pre-routes.ts`
+        : `${__dirname}/pre-routes.ts`;
+    await fs_1.default.promises.mkdir(path_1.default.dirname(outPath), {
+        recursive: true,
+    });
+    await fs_1.default.promises.writeFile(outPath, output);
+    const compiled = typescript_1.default.transpileModule(output, {
+        compilerOptions: {
+            module: typescript_1.default.ModuleKind.CommonJS,
+            target: typescript_1.default.ScriptTarget.ES2020,
+        },
+    });
+    const jsPath = outPath.replace(/\.ts$/, ".js");
+    await fs_1.default.promises.writeFile(jsPath, compiled.outputText, "utf8");
+    return routes;
+}
+//# sourceMappingURL=generator.js.map

package/dist/lib/core/compiler/generator.js.map

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

package/dist/lib/core/compiler/index.d.ts

@@ -0,0 +1,14 @@
+export declare class Compiler {
+    generateRoutes(options: {
+        folder: string;
+        name: RegExp;
+    }): Promise<void | {
+        method: string;
+        path: string;
+        response: string;
+        body: string;
+        params: string;
+        query: string;
+        files: string;
+    }[] | undefined>;
+}

package/dist/lib/core/compiler/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Compiler = void 0;
+const generator_1 = require("./generator");
+class Compiler {
+    async generateRoutes(options) {
+        return await (0, generator_1.generateRoutes)({ controllers: options })
+            .catch(err => console.log(err));
+    }
+}
+exports.Compiler = Compiler;
+//# sourceMappingURL=index.js.map

package/dist/lib/core/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/core/compiler/index.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,MAAa,QAAQ;IACV,KAAK,CAAC,cAAc,CAAE,OAG5B;QACG,OAAO,MAAM,IAAA,0BAAc,EAAC,EAAE,WAAW,EAAG,OAAO,EAAE,CAAC;aACrD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;CACJ;AARD,4BAQC"}

package/dist/lib/core/compiler/pre-routes.d.ts

@@ -0,0 +1,61 @@
+export declare const appRoutes: {
+    "/cats": {
+        POST: {
+            params: null;
+            query: {
+                v: string;
+            };
+            body: {
+                name: string;
+                age: string;
+            };
+            files: null;
+            response: {
+                cat: string;
+                body: {
+                    name: string;
+                    age: string;
+                };
+                query: {
+                    v: string;
+                };
+                cats: {
+                    id: string;
+                    name: string;
+                    age: string;
+                }[];
+            };
+        };
+    };
+};
+export interface AppRoutes {
+    "/cats": {
+        POST: {
+            params: never;
+            query: {
+                v: string;
+            };
+            body: {
+                name: string;
+                age: number;
+            };
+            files: never;
+            response: {
+                cat: "cat1" | "cat2" | "cat3";
+                body: {
+                    name: string;
+                    age: number;
+                };
+                query: {
+                    v: string;
+                };
+                cats: {
+                    id: number;
+                    name: string;
+                    age: number;
+                }[];
+            };
+        };
+    };
+}
+export type AppRoute = keyof AppRoutes;

package/dist/lib/core/compiler/pre-routes.js

@@ -0,0 +1,18 @@
+"use strict";
+// @ts-nocheck
+// AUTO GENERATED FILE
+// DO NOT EDIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appRoutes = void 0;
+exports.appRoutes = {
+    "/cats": {
+        POST: {
+            params: null,
+            query: { "v": "string" },
+            body: { "name": "string", "age": "number" },
+            files: null,
+            response: { "cat": "cat1 | cat2 | cat3", "body": { "name": "string", "age": "number" }, "query": { "v": "string" }, "cats": [{ "id": "number", "name": "string", "age": "number" }] }
+        }
+    }
+};
+//# sourceMappingURL=pre-routes.js.map

package/dist/lib/core/compiler/pre-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-routes.js","sourceRoot":"","sources":["../../../../src/lib/core/compiler/pre-routes.ts"],"names":[],"mappings":";AACA,cAAc;AACd,sBAAsB;AACtB,cAAc;;;AAED,QAAA,SAAS,GAAG;IAEvB,OAAO,EAAE;QAEP,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,EAAC,GAAG,EAAC,QAAQ,EAAC;YACrB,IAAI,EAAE,EAAC,MAAM,EAAC,QAAQ,EAAC,KAAK,EAAC,QAAQ,EAAC;YACtC,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,EAAC,KAAK,EAAC,oBAAoB,EAAC,MAAM,EAAC,EAAC,MAAM,EAAC,QAAQ,EAAC,KAAK,EAAC,QAAQ,EAAC,EAAC,OAAO,EAAC,EAAC,GAAG,EAAC,QAAQ,EAAC,EAAC,MAAM,EAAC,CAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,MAAM,EAAC,QAAQ,EAAC,KAAK,EAAC,QAAQ,EAAC,CAAC,EAAC;SAC9J;KACF;CACF,CAAA"}

package/dist/lib/core/compiler/types.d.ts

@@ -0,0 +1,14 @@
+export type AnyRoutes = {
+    [key: string]: any;
+};
+export type RoutesWithMethod<TRoutes extends AnyRoutes, TMethod extends string> = {
+    [K in keyof TRoutes]: TMethod extends keyof TRoutes[K] ? K : never;
+}[keyof TRoutes];
+export type ExtractFrom<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath], Key extends string> = TRoutes[TPath][TMethod] extends Record<Key, infer R> ? R : never;
+export type RequestBody<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = ExtractFrom<TRoutes, TPath, TMethod, "body">;
+export type RequestQuery<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = ExtractFrom<TRoutes, TPath, TMethod, "query">;
+export type RequestParams<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = ExtractFrom<TRoutes, TPath, TMethod, "params">;
+export type RequestFiles<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = ExtractFrom<TRoutes, TPath, TMethod, "files">;
+export type ResponseType<TRoutes extends AnyRoutes, TPath extends keyof TRoutes, TMethod extends keyof TRoutes[TPath]> = TRoutes[TPath][TMethod] extends {
+    response: infer R;
+} ? Awaited<R> : never;

package/dist/lib/core/compiler/types.js

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

package/dist/lib/core/compiler/types.js.map

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

package/dist/lib/core/decorators/context.d.ts

@@ -20,7 +20,7 @@ export declare function createContextDecorator(hook: (ctx: T.Context, next: T.Ne
  * }
  * ```
  *
- * @param {...string} bodyParms - Body field names to extract.
+ * @param {...string} keys - Body field names to extract.
  * @returns {MethodDecorator}
  */
 export declare const Body: (...keys: string[]) => MethodDecorator;
@@ -96,3 +96,52 @@ export declare const Query: (...keys: string[]) => MethodDecorator;
  * @returns {MethodDecorator}
  */
 export declare const Cookies: (...keys: string[]) => MethodDecorator;
+/**
+ * Validates required fields from a request target.
+ *
+ * @param keys - List of required field names.
+ * @param options - Validation options.
+ * @param options.target - Request source to validate.
+ * Defaults to `"body"`.
+ *
+ * @param options.required - Enables required-value validation.
+ *
+ * - `true`
+ *   - Rejects `null`
+ *   - Rejects empty strings (`""`)
+ *
+ * - `object`
+ *   - Allows customizing required rules.
+ *
+ * @param options.required.allowNull - Allow `null` values.
+ * Default: `false`
+ *
+ * @param options.required.allowEmptyString - Allow empty string values.
+ * Default: `false`
+ * @returns {MethodDecorator}
+ *
+ * @throws {Object} Throws a validation error object when
+ * one or more required fields are missing.
+ *
+ * @example
+ * ```ts
+ * \@Validate(["email", "password"], {
+ *   required: {
+ *     allowEmptyString : true,
+ *     allowNull        : false
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * \@Validate(["id"], { target: "query" });
+ * ```
+ */
+export declare const Validate: (keys: string[], { target, required }?: {
+    target?: "params" | "query" | "body" | "files";
+    required?: boolean | {
+        allowNull?: boolean;
+        allowEmptyString?: boolean;
+    };
+}) => MethodDecorator;