@bool-ts/core 1.0.10 → 1.1.0

package/dist/hooks/factory.d.ts

@@ -1,8 +1,18 @@
 import "reflect-metadata";
 import "colors";
+export type TBoolFactoryOptions = Partial<{
+    debug: boolean;
+    log: Partial<{
+        methods: Array<"GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS">;
+    }>;
+    queryParser: Partial<{
+        depth: 10;
+        arrayLimit: 50;
+    }>;
+}>;
 /**
  *
  * @param target
  */
-export declare const BoolFactory: (target: new (...args: any[]) => unknown) => import("express-serve-static-core").Express;
+export declare const BoolFactory: (target: new (...args: any[]) => unknown, options?: TBoolFactoryOptions) => import("express-serve-static-core").Express;
 export default BoolFactory;

package/dist/hooks/factory.js

@@ -5,6 +5,7 @@ import * as ResponseTime from "response-time";
 import { controllerKey, controllerRoutesKey, moduleKey } from "../decorators";
 import { default as ExpressApp, Router, json, urlencoded } from "express";
 import { Injector } from "./injector";
+import { errorInfer } from "../http";
 /**
  *
  * @param target
@@ -46,7 +47,7 @@ const controllerCreator = (target, router = Router()) => {
  *
  * @param target
  */
-export const BoolFactory = (target) => {
+export const BoolFactory = (target, options) => {
     if (!Reflect.getOwnMetadataKeys(target).includes(moduleKey)) {
         throw Error(`${target.name} is not a module.`);
     }
@@ -58,19 +59,13 @@ export const BoolFactory = (target) => {
     const allowMethods = !metadata?.allowMethods ?
         ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"] : metadata.allowMethods;
     const app = ExpressApp();
-    const configs = Object.freeze({
-        allowLogsMethods: [
-            "GET",
-            "POST",
-            "PUT",
-            "PATCH",
-            "DELETE"
-        ]
+    const factoryOptions = Object.freeze({
+        allowLogsMethods: !options?.log?.methods ? ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"] : options.log.methods
     });
     app.set("etag", "strong");
     app.set("query parser", (query) => Qs.parse(query, {
-        ["depth"]: 10,
-        ["arrayLimit"]: 50
+        depth: !options?.queryParser?.depth || options.queryParser.depth < 0 ? 10 : options.queryParser.depth,
+        arrayLimit: !options?.queryParser?.arrayLimit || options.queryParser.arrayLimit < 0 ? 50 : options.queryParser.arrayLimit
     }));
     app.use(urlencoded({
         extended: true,
@@ -103,13 +98,16 @@ export const BoolFactory = (target) => {
     }, 
     // Error catcher
     (err, req, res, next) => {
-        console.error(err);
-        next();
+        errorInfer(res, err);
+        if (!options?.debug) {
+            return;
+        }
+        console.error("Headers:", JSON.stringify(req.headers), "\nBody:", JSON.stringify(req.body), "\nError:", JSON.stringify(err));
     }, 
     // Response time log
     ResponseTime.default((req, res, time) => {
         const requestMethod = req.method.toUpperCase();
-        if (!configs.allowLogsMethods.includes(requestMethod)) {
+        if (!factoryOptions.allowLogsMethods.includes(requestMethod)) {
             return;
         }
         const convertedMethod = `${requestMethod.yellow}`.bgBlue;
@@ -122,8 +120,13 @@ export const BoolFactory = (target) => {
         if (!allowOrigins.includes("*")) {
             if (!allowOrigins.includes(req.headers.origin || "*")) {
                 return res.status(403).json({
-                    ["httpCode"]: 403,
-                    ["data"]: "Invalid origin."
+                    httpCode: 403,
+                    data: {
+                        origin: {
+                            code: "origin:invalid:0x00001",
+                            message: "Invalid origin."
+                        }
+                    }
                 });
             }
         }
@@ -133,7 +136,9 @@ export const BoolFactory = (target) => {
         res.header("Access-Control-Allow-Methods", allowMethods.join(", "));
         next();
     });
-    app.use(routers);
+    if (routers.length > 0) {
+        app.use(routers);
+    }
     return app;
 };
 export default BoolFactory;

package/dist/http/clientError.d.ts

@@ -0,0 +1,40 @@
+export declare const httpClientErrors: Readonly<{
+    400: "BAD_REQUEST";
+    401: "UNAUTHORIZED";
+    402: "PAYMENT_REQUIRED";
+    403: "FORBIDDEN";
+    404: "NOT_FOUND";
+    405: "METHOD_NOT_ALLOWED";
+    406: "NOT_ACCEPTABLE";
+    407: "PROXY_AUTHENCATION_REQUIRED";
+    408: "REQUEST_TIMEOUT";
+    409: "CONFLICT";
+    410: "GONE";
+    411: "LENGTH_REQUIRED";
+    412: "PRECONDITION_FAILED";
+    413: "PAYLOAD_TOO_LARGE";
+    414: "URI_TOO_LONG";
+    415: "UNSUPPORTED_MEDIA_TYPE";
+    416: "RANGE_NOT_SATISFIABLE";
+    417: "EXPECTATION_FAILED";
+    418: "IM_A_TEAPOT";
+    421: "MISDIRECTED_REQUEST";
+    422: "UNPROCESSABLE_ENTITY";
+    423: "LOCKED";
+    424: "FAILED_DEPENDENCY";
+    425: "TOO_EARLY_";
+    426: "UPGRAGE_REQUIRED";
+    428: "PRECONDITION_REQUIRED";
+    429: "TOO_MANY_REQUESTS";
+    431: "REQUEST_HEADER_FIELDS_TOO_LARGE";
+    451: "UNAVAILABLE_FOR_LEGAL_REASONS";
+}>;
+export declare class HttpClientError<T extends keyof typeof httpClientErrors = keyof typeof httpClientErrors, K = any> extends Error {
+    readonly httpCode: T;
+    readonly message: typeof httpClientErrors[T];
+    readonly data: K;
+    constructor({ httpCode, data }: {
+        ["httpCode"]: T;
+        ["data"]: K;
+    });
+}

package/dist/http/clientError.js

@@ -0,0 +1,42 @@
+export const httpClientErrors = Object.freeze({
+    400: "BAD_REQUEST",
+    401: "UNAUTHORIZED",
+    402: "PAYMENT_REQUIRED",
+    403: "FORBIDDEN",
+    404: "NOT_FOUND",
+    405: "METHOD_NOT_ALLOWED",
+    406: "NOT_ACCEPTABLE",
+    407: "PROXY_AUTHENCATION_REQUIRED",
+    408: "REQUEST_TIMEOUT",
+    409: "CONFLICT",
+    410: "GONE",
+    411: "LENGTH_REQUIRED",
+    412: "PRECONDITION_FAILED",
+    413: "PAYLOAD_TOO_LARGE",
+    414: "URI_TOO_LONG",
+    415: "UNSUPPORTED_MEDIA_TYPE",
+    416: "RANGE_NOT_SATISFIABLE",
+    417: "EXPECTATION_FAILED",
+    418: "IM_A_TEAPOT",
+    421: "MISDIRECTED_REQUEST",
+    422: "UNPROCESSABLE_ENTITY",
+    423: "LOCKED",
+    424: "FAILED_DEPENDENCY",
+    425: "TOO_EARLY_",
+    426: "UPGRAGE_REQUIRED",
+    428: "PRECONDITION_REQUIRED",
+    429: "TOO_MANY_REQUESTS",
+    431: "REQUEST_HEADER_FIELDS_TOO_LARGE",
+    451: "UNAVAILABLE_FOR_LEGAL_REASONS"
+});
+export class HttpClientError extends Error {
+    httpCode;
+    message;
+    data;
+    constructor({ httpCode, data }) {
+        super();
+        this.httpCode = httpCode;
+        this.message = httpClientErrors[httpCode];
+        this.data = data;
+    }
+}

package/dist/http/index.d.ts

@@ -0,0 +1,4 @@
+import { Response } from "express";
+export declare const errorInfer: (res: Response, data: any) => void;
+export * from "./clientError";
+export * from "./serverError";

package/dist/http/index.js

@@ -0,0 +1,58 @@
+import { HttpClientError } from "./clientError";
+import { HttpServerError } from "./serverError";
+export const errorInfer = (res, data) => {
+    if (res.headersSent) {
+        return;
+    }
+    try {
+        if (data instanceof HttpClientError) {
+            res.status(data.httpCode).json(data);
+            return;
+        }
+        if (data instanceof HttpServerError) {
+            res.status(data.httpCode).json(data);
+            return;
+        }
+        if (typeof data === "object") {
+            res.status(500).json({
+                httpCode: 500,
+                message: "INTERNAL SERVER ERROR",
+                data: data
+            });
+            return;
+        }
+        switch (typeof data) {
+            case "string":
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: {
+                        message: data
+                    }
+                });
+                return;
+            case "number":
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: {
+                        code: data
+                    }
+                });
+                return;
+            default:
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: undefined
+                });
+                return;
+        }
+    }
+    catch (error) {
+        console.error(error);
+        res.end();
+    }
+};
+export * from "./clientError";
+export * from "./serverError";

package/dist/http/serverError.d.ts

@@ -0,0 +1,22 @@
+export declare const httpServerErrors: Readonly<{
+    500: "INTERNAL_SERVER_ERROR";
+    501: "NOT_IMPLEMENTED";
+    502: "BAD_GATEWAY";
+    503: "SERVICE_UNAVAILABLE";
+    504: "GATEWAY_TIMEOUT";
+    505: "HTTP_VERSION_NOT_SUPPORTED";
+    506: "VARIANT_ALSO_NEGOTIATES";
+    507: "INSUFFICIENT_STORAGE";
+    508: "LOOP_DETECTED";
+    510: "NOT_EXTENDED";
+    511: "NETWORK_AUTHENTICATION_REQUIRED";
+}>;
+export declare class HttpServerError<T extends keyof typeof httpServerErrors = keyof typeof httpServerErrors, K = any> extends Error {
+    readonly httpCode: T;
+    readonly message: typeof httpServerErrors[T];
+    readonly data: K;
+    constructor({ httpCode, data }: {
+        ["httpCode"]: T;
+        ["data"]: K;
+    });
+}

package/dist/http/serverError.js

@@ -0,0 +1,24 @@
+export const httpServerErrors = Object.freeze({
+    500: "INTERNAL_SERVER_ERROR",
+    501: "NOT_IMPLEMENTED",
+    502: "BAD_GATEWAY",
+    503: "SERVICE_UNAVAILABLE",
+    504: "GATEWAY_TIMEOUT",
+    505: "HTTP_VERSION_NOT_SUPPORTED",
+    506: "VARIANT_ALSO_NEGOTIATES",
+    507: "INSUFFICIENT_STORAGE",
+    508: "LOOP_DETECTED",
+    510: "NOT_EXTENDED",
+    511: "NETWORK_AUTHENTICATION_REQUIRED"
+});
+export class HttpServerError extends Error {
+    httpCode;
+    message;
+    data;
+    constructor({ httpCode, data }) {
+        super();
+        this.httpCode = httpCode;
+        this.message = httpServerErrors[httpCode];
+        this.data = data;
+    }
+}

package/dist/index.d.ts

@@ -2,3 +2,4 @@ import "reflect-metadata";
 export * from "./interfaces";
 export * from "./hooks";
 export * from "./decorators";
+export * from "./http";

package/dist/index.js

@@ -2,3 +2,4 @@ import "reflect-metadata";
 export * from "./interfaces";
 export * from "./hooks";
 export * from "./decorators";
+export * from "./http";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bool-ts/core",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "description": "",
   "main": "dist/index.js",
   "scripts": {

package/src/hooks/factory.ts

@@ -7,6 +7,19 @@ import * as ResponseTime from "response-time";
 import { type IControllerRoute, type TModuleOptions, controllerKey, controllerRoutesKey, moduleKey } from "../decorators";
 import { default as ExpressApp, Router, json, urlencoded, Request, Response, NextFunction, Errback } from "express";
 import { Injector } from "./injector";
+import { errorInfer } from "../http";
+
+
+export type TBoolFactoryOptions = Partial<{
+    debug: boolean;
+    log: Partial<{
+        methods: Array<"GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS">;
+    }>;
+    queryParser: Partial<{
+        depth: 10,
+        arrayLimit: 50
+    }>;
+}>;
 
 
 /**
@@ -62,7 +75,8 @@ const controllerCreator = (
  * @param target 
  */
 export const BoolFactory = (
-    target: new (...args: any[]) => unknown
+    target: new (...args: any[]) => unknown,
+    options?: TBoolFactoryOptions
 ) => {
     if (!Reflect.getOwnMetadataKeys(target).includes(moduleKey)) {
         throw Error(`${target.name} is not a module.`);
@@ -76,20 +90,14 @@ export const BoolFactory = (
     const allowMethods = !metadata?.allowMethods ?
         ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"] : metadata.allowMethods;
     const app = ExpressApp();
-    const configs = Object.freeze({
-        allowLogsMethods: [
-            "GET",
-            "POST",
-            "PUT",
-            "PATCH",
-            "DELETE"
-        ]
+    const factoryOptions = Object.freeze({
+        allowLogsMethods: !options?.log?.methods ? ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"] : options.log.methods
     });
 
     app.set("etag", "strong");
     app.set("query parser", (query: string) => Qs.parse(query, {
-        ["depth"]: 10,
-        ["arrayLimit"]: 50
+        depth: !options?.queryParser?.depth || options.queryParser.depth < 0 ? 10 : options.queryParser.depth,
+        arrayLimit: !options?.queryParser?.arrayLimit || options.queryParser.arrayLimit < 0 ? 50 : options.queryParser.arrayLimit
     }));
 
     app.use(
@@ -127,15 +135,19 @@ export const BoolFactory = (
         },
         // Error catcher
         (err: Errback, req: Request, res: Response, next: NextFunction) => {
-            console.error(err);
+            errorInfer(res, err);
 
-            next();
+            if (!options?.debug) {
+                return;
+            }
+
+            console.error("Headers:", JSON.stringify(req.headers), "\nBody:", JSON.stringify(req.body), "\nError:", JSON.stringify(err));
         },
         // Response time log
         ResponseTime.default((req: Request, res: Response, time: number) => {
             const requestMethod = req.method.toUpperCase();
 
-            if (!configs.allowLogsMethods.includes(requestMethod)) {
+            if (!factoryOptions.allowLogsMethods.includes(requestMethod)) {
                 return;
             }
 
@@ -152,8 +164,13 @@ export const BoolFactory = (
         if (!allowOrigins.includes("*")) {
             if (!allowOrigins.includes(req.headers.origin || "*")) {
                 return res.status(403).json({
-                    ["httpCode"]: 403,
-                    ["data"]: "Invalid origin."
+                    httpCode: 403,
+                    data: {
+                        origin: {
+                            code: "origin:invalid:0x00001",
+                            message: "Invalid origin."
+                        }
+                    }
                 });
             }
         }
@@ -166,7 +183,9 @@ export const BoolFactory = (
         next();
     });
 
-    app.use(routers);
+    if (routers.length > 0) {
+        app.use(routers);
+    }
 
     return app;
 }

package/src/http/clientError.ts

@@ -0,0 +1,57 @@
+import * as ExpressJS from "express";
+
+
+export const httpClientErrors = Object.freeze({
+    400: "BAD_REQUEST",
+    401: "UNAUTHORIZED",
+    402: "PAYMENT_REQUIRED",
+    403: "FORBIDDEN",
+    404: "NOT_FOUND",
+    405: "METHOD_NOT_ALLOWED",
+    406: "NOT_ACCEPTABLE",
+    407: "PROXY_AUTHENCATION_REQUIRED",
+    408: "REQUEST_TIMEOUT",
+    409: "CONFLICT",
+    410: "GONE",
+    411: "LENGTH_REQUIRED",
+    412: "PRECONDITION_FAILED",
+    413: "PAYLOAD_TOO_LARGE",
+    414: "URI_TOO_LONG",
+    415: "UNSUPPORTED_MEDIA_TYPE",
+    416: "RANGE_NOT_SATISFIABLE",
+    417: "EXPECTATION_FAILED",
+    418: "IM_A_TEAPOT",
+    421: "MISDIRECTED_REQUEST",
+    422: "UNPROCESSABLE_ENTITY",
+    423: "LOCKED",
+    424: "FAILED_DEPENDENCY",
+    425: "TOO_EARLY_",
+    426: "UPGRAGE_REQUIRED",
+    428: "PRECONDITION_REQUIRED",
+    429: "TOO_MANY_REQUESTS",
+    431: "REQUEST_HEADER_FIELDS_TOO_LARGE",
+    451: "UNAVAILABLE_FOR_LEGAL_REASONS"
+});
+
+export class HttpClientError<
+    T extends keyof typeof httpClientErrors = keyof typeof httpClientErrors,
+    K = any
+> extends Error {
+    public readonly httpCode: T;
+    public readonly message: typeof httpClientErrors[T];
+    public readonly data: K;
+
+    constructor({
+        httpCode,
+        data
+    }: {
+        ["httpCode"]: T;
+        ["data"]: K;
+    }) {
+        super();
+
+        this.httpCode = httpCode;
+        this.message = httpClientErrors[httpCode];
+        this.data = data;
+    }
+}

package/src/http/index.ts

@@ -0,0 +1,68 @@
+import { Response } from "express";
+import { HttpClientError } from "./clientError";
+import { HttpServerError } from "./serverError";
+
+
+export const errorInfer = (res: Response, data: any) => {
+    if (res.headersSent) {
+        return;
+    }
+
+    try {
+        if (data instanceof HttpClientError) {
+            res.status(data.httpCode).json(data);
+            return;
+        }
+
+        if (data instanceof HttpServerError) {
+            res.status(data.httpCode).json(data);
+            return;
+        }
+
+        if (typeof data === "object") {
+            res.status(500).json({
+                httpCode: 500,
+                message: "INTERNAL SERVER ERROR",
+                data: data
+            });
+            return;
+        }
+
+        switch (typeof data) {
+            case "string":
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: {
+                        message: data
+                    }
+                });
+                return;
+
+            case "number":
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: {
+                        code: data
+                    }
+                });
+                return;
+
+            default:
+                res.status(500).json({
+                    httpCode: 500,
+                    message: "INTERNAL SERVER ERROR",
+                    data: undefined
+                });
+                return;
+        }
+    }
+    catch (error) {
+        console.error(error);
+        res.end();
+    }
+}
+
+export * from "./clientError";
+export * from "./serverError";

package/src/http/serverError.ts

@@ -0,0 +1,39 @@
+import * as ExpressJS from "express";
+
+
+export const httpServerErrors = Object.freeze({
+    500: "INTERNAL_SERVER_ERROR",
+    501: "NOT_IMPLEMENTED",
+    502: "BAD_GATEWAY",
+    503: "SERVICE_UNAVAILABLE",
+    504: "GATEWAY_TIMEOUT",
+    505: "HTTP_VERSION_NOT_SUPPORTED",
+    506: "VARIANT_ALSO_NEGOTIATES",
+    507: "INSUFFICIENT_STORAGE",
+    508: "LOOP_DETECTED",
+    510: "NOT_EXTENDED",
+    511: "NETWORK_AUTHENTICATION_REQUIRED"
+});
+
+export class HttpServerError<
+    T extends keyof typeof httpServerErrors = keyof typeof httpServerErrors,
+    K = any
+> extends Error {
+    public readonly httpCode: T;
+    public readonly message: typeof httpServerErrors[T];
+    public readonly data: K;
+
+    constructor({
+        httpCode,
+        data
+    }: {
+        ["httpCode"]: T;
+        ["data"]: K;
+    }) {
+        super();
+
+        this.httpCode = httpCode;
+        this.message = httpServerErrors[httpCode];
+        this.data = data;
+    }
+}

package/src/index.ts

@@ -3,3 +3,4 @@ import "reflect-metadata";
 export * from "./interfaces";
 export * from "./hooks";
 export * from "./decorators";
+export * from "./http";