tspace-spear 1.2.1-beta.1 → 1.2.2

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

@@ -15,18 +15,30 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Spear = exports.Application = void 0;
+const http_1 = __importStar(require("http"));
+const find_my_way_1 = __importDefault(require("find-my-way"));
 const cluster_1 = __importDefault(require("cluster"));
 const os_1 = __importDefault(require("os"));
 const fs_1 = __importDefault(require("fs"));
@@ -34,8 +46,6 @@ const path_1 = __importDefault(require("path"));
 const url_1 = require("url");
 const on_finished_1 = __importDefault(require("on-finished"));
 const ws_1 = __importDefault(require("ws"));
-const http_1 = __importStar(require("http"));
-const find_my_way_1 = __importDefault(require("find-my-way"));
 const parser_factory_1 = require("./parser-factory");
 /**
  *
@@ -76,10 +86,10 @@ class Spear {
             version: "1.0.0"
         }
     };
+    _swaggerSpecs = [];
     _wss;
     _ws;
     _wsOptions;
-    _swaggerAdditional = [];
     _errorHandler = null;
     _globalMiddlewares = [];
     _formatResponse = null;
@@ -97,7 +107,6 @@ class Spear {
             this.useLogger();
         if (cluster)
             this.useCluster(cluster);
-        this._cluster = cluster;
         this._controllers = controllers;
         this._middlewares = middlewares;
         this._globalPrefix = globalPrefix == null ? '' : globalPrefix;
@@ -260,11 +269,11 @@ class Spear {
         }
         this._globalMiddlewares.push((ctx, next) => {
             const { req } = ctx;
-            const contentType = req?.headers['content-type'];
-            const isFileUpload = contentType && contentType.startsWith('multipart/form-data');
             if (req.method === 'GET') {
                 return next();
             }
+            const contentType = req?.headers['content-type'];
+            const isFileUpload = contentType && contentType.startsWith('multipart/form-data');
             if (!isFileUpload)
                 return next();
             if (req?.files != null)
@@ -379,7 +388,7 @@ class Spear {
             const origin = req.headers?.origin ?? null;
             if (origin == null)
                 return;
-            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, OPTIONS');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS');
             res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
             if (Array.isArray(origins) && origins.length) {
                 for (const o of origins) {
@@ -404,27 +413,6 @@ class Spear {
         });
         return this;
     }
-    /**
-     * The 'enableCors' is used to enable the cors origins on the server.
-     *
-     * @params {Object}
-     * @property {(string | RegExp)[]} origins
-     * @property {boolean} credentials
-     * @returns
-     */
-    enableCors({ origins, credentials } = {}) {
-        return this.cors({ origins, credentials });
-    }
-    /**
-     * The 'formaT.Response' method is used to format the response
-     *
-     * @param {function} format
-     * @returns
-     */
-    formatResponse(format) {
-        this._formatResponse = format;
-        return this;
-    }
     /**
      * The 'response' method is used to format the response
      *
@@ -435,18 +423,6 @@ class Spear {
         this._formatResponse = format;
         return this;
     }
-    /**
-     * The 'errorHandler' method is middleware that is specifically designed to handle errors.
-     *
-     * that occur during the processing of requests
-     *
-     * @param {function} error
-     * @returns
-     */
-    errorHandler(error) {
-        this._errorHandler = error;
-        return this;
-    }
     /**
      * The 'catch' method is middleware that is specifically designed to handle errors.
      *
@@ -459,34 +435,10 @@ class Spear {
         this._errorHandler = error;
         return this;
     }
-    /**
-     * The 'notFoundHandler' method is middleware that is specifically designed to handle errors notfound that occur during the processing of requests
-     *
-     * @param {function} notfound
-     * @returns
-     */
-    notFoundHandler(fn) {
-        const handler = ({ req, res }) => {
-            return fn({
-                req,
-                res: this._customizeResponse(req, res),
-                headers: {},
-                query: {},
-                files: {},
-                body: {},
-                params: {},
-                cookies: {}
-            });
-        };
-        this._onListeners.push(() => {
-            return this.all('*', ...this._globalMiddlewares, handler);
-        });
-        return this;
-    }
     /**
      * The 'notfound' method is middleware that is specifically designed to handle errors notfound that occur during the processing of requests
      *
-     * @param {function} notfound
+     * @param {function} fn
      * @returns
      */
     notfound(fn) {
@@ -583,7 +535,7 @@ class Spear {
         return this;
     }
     /**
-     * The 'all' method is used to add the request handler to the router for 'GET' 'POST' 'PUT' 'PATCH' 'DELETE' methods.
+     * The 'head' method is used to add the request handler to the router for 'HEAD' methods.
      *
      * @param {string} path
      * @callback {...Function[]} handlers of the middlewares
@@ -591,14 +543,29 @@ class Spear {
      * @property  {function} next  - go to next function
      * @returns {this}
      */
-    all(path, ...handlers) {
+    head(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.all(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.head(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
     /**
-     * The 'any' method is used to add the request handler to the router for 'GET' 'POST' 'PUT' 'PATCH' 'DELETE' methods.
+     * The 'head' method is used to add the request handler to the router for 'HEAD' methods.
+     *
+     * @param {string} path
+     * @callback {...Function[]} handlers of the middlewares
+     * @property  {object} ctx - context { req , res , query , params , cookies , files , body}
+     * @property  {function} next  - go to next function
+     * @returns {this}
+     */
+    options(path, ...handlers) {
+        this._onListeners.push(() => {
+            return this._router.options(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+        });
+        return this;
+    }
+    /**
+     * The 'any' method is used to add the request handler to the router for 'GET' 'POST' 'PUT' 'PATCH' 'DELETE' 'HEAD' 'OPTIONS' methods.
      *
      * @param {string} path
      * @callback {...Function[]} handlers of the middlewares
@@ -612,6 +579,21 @@ class Spear {
         });
         return this;
     }
+    /**
+    * The 'all' method is used to add the request handler to the router for 'GET' 'POST' 'PUT' 'PATCH' 'DELETE' 'HEAD' 'OPTIONS' methods.
+    *
+    * @param {string} path
+    * @callback {...Function[]} handlers of the middlewares
+    * @property  {object} ctx - context { req , res , query , params , cookies , files , body}
+    * @property  {function} next  - go to next function
+    * @returns {this}
+    */
+    all(path, ...handlers) {
+        this._onListeners.push(() => {
+            return this._router.all(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+        });
+        return this;
+    }
     _clusterMode({ server, port, hostname, callback }) {
         if (cluster_1.default.isPrimary) {
             const numCPUs = os_1.default.cpus().length;
@@ -688,8 +670,8 @@ class Spear {
                 for (const { method, path, handler } of Array.from(routers)) {
                     const find = Array.from(swaggers).find(s => s.handler === handler);
                     if (find != null) {
-                        this._swaggerAdditional = [
-                            ...this._swaggerAdditional,
+                        this._swaggerSpecs = [
+                            ...this._swaggerSpecs,
                             {
                                 ...find,
                                 path: this._normalizePath(this._globalPrefix, prefixPath, path),
@@ -712,8 +694,8 @@ class Spear {
             for (const { method, path, handler } of Array.from(routers)) {
                 const find = Array.from(swaggers).find(s => s.handler === handler);
                 if (find != null) {
-                    this._swaggerAdditional = [
-                        ...this._swaggerAdditional,
+                    this._swaggerSpecs = [
+                        ...this._swaggerSpecs,
                         {
                             ...find,
                             path: this._normalizePath(this._globalPrefix, prefixPath, path),
@@ -743,7 +725,7 @@ class Spear {
                 }
                 const middleware = maybeMiddleware;
                 if (typeof middleware !== "function") {
-                    console.log(`\x1b[31m[ControllerLoader ERROR]\x1b[0m \x1b[36m${file}\x1b[0m must export a controller class`);
+                    console.log(`\x1b[31m[MiddlewareLoader ERROR]\x1b[0m \x1b[36m${file}\x1b[0m must export a middleware`);
                     continue;
                 }
                 this.use(middleware);
@@ -758,296 +740,276 @@ class Spear {
     }
     _customizeResponse(req, res) {
         const response = res;
-        // response.json = (results ?: Record<string,any>) => {
-        //     if (res.writableEnded) return;
-        //     if(typeof results === 'string') {
-        //         if(!res.headersSent) {
-        //             res.writeHead(200, { 'Content-Type': 'text/plain' })
-        //         }
-        //         return res.end(results)
-        //     }
-        //     if(!res.headersSent) {
-        //         res.writeHead(200, { 'Content-Type': 'application/json' })
-        //     }
-        //     if(results == null) {
-        //         if(this._formatResponse != null) {
-        //             return res.end(JSON.stringify(this._formatResponse(null, res.statusCode),null,2))
-        //         }
-        //         return res.end()
-        //     }
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(
-        //             this._formatResponse({ 
-        //                 ...results
-        //             }, res.statusCode) ,null, 2)
-        //         )
-        //     }
-        //     return res.end(JSON.stringify({
-        //         ...results,
-        //     },null,2))
-        // }
-        // response.send = (results : string) => {
-        //     if (res.writableEnded) return;
-        //     res.writeHead(res.statusCode, { 'Content-Type': 'text/plain' })
-        //     return res.end(results)
-        // }
-        // response.html = (results : string) => {
-        //     if (res.writableEnded) return;
-        //     res.writeHead(res.statusCode, {'Content-Type': 'text/html'})
-        //     return res.end(results)
-        // }
-        // response.error = (err ) => {
-        //     let code =
-        //         +err.response?.data?.code ||
-        //         +err.code ||
-        //         +err.status ||
-        //         +err.statusCode ||
-        //         +err.response?.data?.statusCode ||
-        //         500;
-        //     code = (code == null || typeof code !== 'number') ? 500 : Number.isNaN(code) ? 500 : code < 400 ? 500 : code
-        //     const message =
-        //         err.response?.data?.errorMessage ||
-        //         err.response?.data?.message ||
-        //         err.message ||
-        //         `The url '${req.url}' resulted in a server error. Please investigate.`
-        //         ;
-        //     response.status(code as any)
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, code) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message : message 
-        //     },null,2))
-        // }
-        // response.ok = (results ?: Record<string,any> ) => {
-        //     return response.json(results == null ? {} : results)
-        // }
-        // response.created = (results ?: Record<string,any>) => {
-        //     response.status(201)
-        //     return response.json(results == null ? {} : results)
-        // }
-        // response.accepted = (results ?: Record<string,any>) => {
-        //     response.status(202)
-        //     return response.json(results == null ? {} : results)
-        // }
-        // response.noContent = () => {
-        //     response.status(204)
-        //     return res.end()
-        // }
-        // response.badRequest = (message ?: string) => {
-        //     if (res.writableEnded) return;
-        //     response.status(400)
-        //     message = message ?? `The url '${req.url}' resulted in a bad request. Please review the data and try again.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 400) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message : message 
-        //     },null,2))
-        // }
-        // response.unauthorized = (message ?: string) => {
-        //     response.status(401)
-        //     message = message ?? `The url '${req.url}' is unauthorized. Please verify.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 401) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message
-        //     },null,2))
-        // }
-        // response.paymentRequired = (message ?: string) => {
-        //     response.status(402)
-        //     message = message ?? `The url '${req.url}' requires payment. Please proceed with payment.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 402) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message
-        //     },null,2))
-        // }
-        // response.forbidden = (message ?: string) => {
-        //     response.status(403)
-        //     message = message ?? `The url '${req.url}' is forbidden. Please check the permissions or access rights.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 403) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message
-        //     },null,2))
-        // }
-        // response.notFound = (message ?: string) => {
-        //     response.status(404)
-        //     message = message ?? `The url '${req.url}' was not found. Please re-check the your url again.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 404) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message
-        //     },null,2))
-        // }
-        // response.tooManyRequests = (message ?: string) => {
-        //     response.status(429)
-        //     message = message ?? `The url '${req.url}' is too many request. Please wait and try agian.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 404) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message
-        //     },null,2))
-        // }
-        // response.serverError = (message ?: string) => {
-        //     response.status(500)
-        //     message = message ?? `The url '${req.url}' resulted in a server error. Please investigate.`
-        //     if(this._formatResponse != null) {
-        //         return res.end(JSON.stringify(this._formatResponse({ message }, 500) ,null,2))
-        //     }
-        //     return res.end(JSON.stringify({
-        //         message 
-        //     },null,2))
-        // }
-        // response.status = (code : number) => {
-        //     res.writeHead(code, { 'Content-Type': 'application/json' })
-        //     return res as unknown as {
-        //         json : (data?: { [key: string]: any }) => void;
-        //         send : (message : string) => void;
-        //     }
-        // }
-        // response.setCookies = (cookies : Record<string,string | { 
-        //     value      : string
-        //     sameSite   ?: 'Strict' | 'Lax' | 'None'
-        //     domain     ?: string
-        //     secure     ?: boolean
-        //     httpOnly   ?: boolean
-        //     expires    ?: Date
-        // }> ) => {
-        //     for(const [key,v] of Object.entries(cookies)) {
-        //         if(typeof v === 'string') {
-        //             res.setHeader('Set-Cookie', `${key}=${v}`);
-        //             continue
-        //         }
-        //         if(v.value === '' || v.value ==  null) continue
-        //         let str = `${key}=${v.value}`
-        //         if(v.sameSite != null) {
-        //             str += ` ;SameSite=${v.sameSite}`
-        //         }
-        //         if(v.domain != null) {
-        //             str += ` ;Domain=${v.domain}`
-        //         }
-        //         if(v.httpOnly != null) {
-        //             str += ` ;HttpOnly`
-        //         }
-        //         if(v.secure != null) {
-        //             str += ` ;Secure`
-        //         }
-        //         if(v.expires != null) {
-        //             str += ` ;Expires=${v.expires.toUTCString()}`
-        //         }
-        //         res.setHeader('Set-Cookie', str);
-        //     }
-        // }
-        return response;
-    }
-    _nextFunction(ctx) {
-        const NEXT_MESSAGE = "The 'next' function does not have any subsequent function.";
-        return (err) => {
-            if (err != null) {
-                if (this._errorHandler != null) {
-                    return this._errorHandler(err, ctx);
+        response.json = (results) => {
+            if (res.writableEnded)
+                return;
+            if (typeof results === 'string') {
+                if (!res.headersSent) {
+                    res.writeHead(200, { 'Content-Type': 'text/plain' });
                 }
-                ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
+                return res.end(results);
+            }
+            if (!res.headersSent) {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+            }
+            if (results == null) {
                 if (this._formatResponse != null) {
-                    return ctx.res.end(JSON.stringify(this._formatResponse({
-                        message: err?.message,
-                    }, ctx.res.statusCode), null, 2));
+                    return res.end(JSON.stringify(this._formatResponse(null, res.statusCode), null, 2));
                 }
-                return ctx.res.end(JSON.stringify({
-                    message: err?.message,
-                }, null, 2));
+                return res.end();
             }
-            if (this._errorHandler != null) {
-                return this._errorHandler(new Error(NEXT_MESSAGE), ctx);
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({
+                    ...results
+                }, res.statusCode), null, 2));
             }
-            ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
+            return res.end(JSON.stringify({
+                ...results,
+            }, null, 2));
+        };
+        response.send = (results) => {
+            if (res.writableEnded)
+                return;
+            res.writeHead(res.statusCode, { 'Content-Type': 'text/plain' });
+            return res.end(results);
+        };
+        response.html = (results) => {
+            if (res.writableEnded)
+                return;
+            res.writeHead(res.statusCode, { 'Content-Type': 'text/html' });
+            return res.end(results);
+        };
+        response.error = (err) => {
+            const statusCandidates = [
+                err?.response?.data?.code,
+                err?.code,
+                err?.status,
+                err?.statusCode,
+                err?.response?.data?.statusCode
+            ];
+            let code = statusCandidates
+                .map(v => Number(v))
+                .find(v => Number.isFinite(v) && v >= 400) ?? 500;
+            const message = err?.response?.data?.errorMessage ??
+                err?.response?.data?.message ??
+                err?.message ??
+                `The request '${req.url}' resulted in a server error.`;
+            response.status(code);
+            const payload = { message };
+            if (this._formatResponse) {
+                return res.end(JSON.stringify(this._formatResponse(payload, code)));
+            }
+            return res.end(JSON.stringify(payload));
+        };
+        response.ok = (results) => {
+            return response.json(results == null ? {} : results);
+        };
+        response.created = (results) => {
+            response.status(201);
+            return response.json(results == null ? {} : results);
+        };
+        response.accepted = (results) => {
+            response.status(202);
+            return response.json(results == null ? {} : results);
+        };
+        response.noContent = () => {
+            response.status(204);
+            return res.end();
+        };
+        response.badRequest = (message) => {
+            if (res.writableEnded)
+                return;
+            response.status(400);
+            message = message ?? `The request '${req.url}' resulted in a bad request. Please review the data and try again.`;
             if (this._formatResponse != null) {
-                return ctx.res.end(JSON.stringify(this._formatResponse({
-                    message: NEXT_MESSAGE
-                }, ctx.res.statusCode), null, 2));
+                return res.end(JSON.stringify(this._formatResponse({ message }, 400), null, 2));
             }
-            return ctx.res.end(JSON.stringify({
-                message: NEXT_MESSAGE
+            return res.end(JSON.stringify({
+                message: message
             }, null, 2));
         };
+        response.unauthorized = (message) => {
+            response.status(401);
+            message = message ?? `The request '${req.url}' is unauthorized. Please verify.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 401), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.paymentRequired = (message) => {
+            response.status(402);
+            message = message ?? `The request '${req.url}' requires payment. Please proceed with payment.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 402), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.forbidden = (message) => {
+            response.status(403);
+            message = message ?? `The request '${req.url}' is forbidden. Please check the permissions or access rights.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 403), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.notFound = (message) => {
+            response.status(404);
+            message = message ?? `The request '${req.url}' was not found. Please re-check the your url again.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 404), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.unprocessable = (message) => {
+            response.status(422);
+            message = message ?? `The request to '${req.url}' failed validation.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 422), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.tooManyRequests = (message) => {
+            response.status(429);
+            message = message ?? `The request '${req.url}' is too many request. Please wait and try agian.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 429), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.serverError = (message) => {
+            response.status(500);
+            message = message ?? `The request '${req.url}' resulted in a server error. Please investigate.`;
+            if (this._formatResponse != null) {
+                return res.end(JSON.stringify(this._formatResponse({ message }, 500), null, 2));
+            }
+            return res.end(JSON.stringify({
+                message
+            }, null, 2));
+        };
+        response.status = (code) => {
+            res.writeHead(code, { 'Content-Type': 'application/json' });
+            return res;
+        };
+        response.setCookies = (cookies) => {
+            for (const [key, v] of Object.entries(cookies)) {
+                if (typeof v === 'string') {
+                    res.setHeader('Set-Cookie', `${key}=${v}`);
+                    continue;
+                }
+                if (v.value === '' || v.value == null)
+                    continue;
+                let str = `${key}=${v.value}`;
+                if (v.sameSite != null) {
+                    str += ` ;SameSite=${v.sameSite}`;
+                }
+                if (v.domain != null) {
+                    str += ` ;Domain=${v.domain}`;
+                }
+                if (v.httpOnly != null) {
+                    str += ` ;HttpOnly`;
+                }
+                if (v.secure != null) {
+                    str += ` ;Secure`;
+                }
+                if (v.expires != null) {
+                    str += ` ;Expires=${v.expires.toUTCString()}`;
+                }
+                res.setHeader('Set-Cookie', str);
+            }
+        };
+        return response;
     }
-    _wrapHandlers = (...handlers) => {
+    _wrapHandlers(...handlers) {
         return (req, res, params) => {
             const nextHandler = (index = 0) => {
-                const response = this._customizeResponse(req, res);
-                const request = req;
-                request.params = params;
-                const body = request.body;
-                const files = request.files;
-                const cookies = request.cookies;
-                const headers = request.headers;
-                const url = new url_1.URL(req.url, "http://localhost");
-                const query = Object.fromEntries(url.searchParams);
-                const RecordOrEmptyRecord = (data) => {
-                    if (data == null)
-                        return {};
-                    return Object.keys(data).length ? data : {};
-                };
-                const ctx = {
-                    req: request,
-                    res: response,
-                    headers: RecordOrEmptyRecord(headers),
-                    params: RecordOrEmptyRecord(params),
-                    query: RecordOrEmptyRecord(query),
-                    body: RecordOrEmptyRecord(body),
-                    files: RecordOrEmptyRecord(files),
-                    cookies: RecordOrEmptyRecord(cookies)
-                };
-                if (index === handlers.length - 1) {
-                    return this._wrapResponse(handlers[index]
-                        .bind(handlers[index]))(ctx, this._nextFunction(ctx));
+                try {
+                    const response = this._customizeResponse(req, res);
+                    const request = req;
+                    request.params = params;
+                    const body = request.body;
+                    const files = request.files;
+                    const cookies = request.cookies;
+                    const headers = request.headers;
+                    const url = new url_1.URL(req.url, "http://localhost");
+                    const query = Object.fromEntries(url.searchParams);
+                    const RecordOrEmptyRecord = (data) => {
+                        if (data == null)
+                            return {};
+                        return Object.keys(data).length ? data : {};
+                    };
+                    const ctx = {
+                        req: request,
+                        res: response,
+                        headers: RecordOrEmptyRecord(headers),
+                        params: RecordOrEmptyRecord(params),
+                        query: RecordOrEmptyRecord(query),
+                        body: RecordOrEmptyRecord(body),
+                        files: RecordOrEmptyRecord(files),
+                        cookies: RecordOrEmptyRecord(cookies)
+                    };
+                    if (index === handlers.length - 1) {
+                        return this._wrapResponse(handlers[index]
+                            .bind(handlers[index]))(ctx, this._nextFunction(ctx));
+                    }
+                    return handlers[index](ctx, () => {
+                        return nextHandler(index + 1);
+                    });
+                }
+                catch (err) {
+                    const ctx = {
+                        req,
+                        res: this._customizeResponse(req, res),
+                        params: Object.keys(params).length ? params : {},
+                        headers: {},
+                        query: {},
+                        body: {},
+                        files: {},
+                        cookies: {}
+                    };
+                    return this._nextFunction(ctx)(err);
                 }
-                return handlers[index](ctx, () => {
-                    return nextHandler(index + 1);
-                });
             };
-            try {
-                if (res.writableEnded)
-                    return;
-                return nextHandler();
-            }
-            catch (err) {
-                const ctx = {
-                    req,
-                    res: this._customizeResponse(req, res),
-                    params: Object.keys(params).length ? params : {},
-                    headers: {},
-                    query: {},
-                    body: {},
-                    files: {},
-                    cookies: {}
-                };
-                return this._nextFunction(ctx)(err);
-            }
+            if (res.writableEnded)
+                return;
+            return nextHandler();
         };
-    };
+    }
     _wrapResponse(handler) {
         return (ctx, next) => {
             Promise.resolve(handler(ctx, next))
                 .then(result => {
                 if (ctx.res.writableEnded)
                     return;
-                if (result instanceof http_1.ServerResponse)
+                if (result instanceof http_1.ServerResponse) {
+                    if (result?.end) {
+                        result.end();
+                    }
                     return;
-                if (result == null)
+                }
+                if (result == null) {
+                    if (!ctx.res.headersSent) {
+                        ctx.res.writeHead(204, { 'Content-Type': 'text/plain' });
+                    }
+                    ctx.res.end();
                     return;
+                }
                 if (typeof result === 'string') {
                     if (!ctx.res.headersSent) {
                         ctx.res.writeHead(200, { 'Content-Type': 'text/plain' });
                     }
-                    ctx.res.end(result);
+                    ctx.res.end(result ?? '');
                     return;
                 }
                 if (this._formatResponse != null) {
@@ -1062,26 +1024,58 @@ class Spear {
                     if (!ctx.res.headersSent) {
                         ctx.res.writeHead(200, { 'Content-Type': 'application/json' });
                     }
-                    ctx.res.end(JSON.stringify(formattedResult, null, 2));
+                    ctx.res.end(JSON.stringify(formattedResult));
                     return;
                 }
                 if (!ctx.res.headersSent) {
                     ctx.res.writeHead(200, { 'Content-Type': 'application/json' });
                 }
-                ctx.res.end(result == null ? undefined : JSON.stringify(result, null, 2));
+                ctx.res.end(JSON.stringify(result));
                 return;
             })
                 .catch(err => {
-                if (ctx.res.writableEnded)
-                    return;
-                if (!ctx.res.headersSent) {
-                    ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
-                }
-                ctx.res.end(JSON.stringify({ message: err?.message || 'Internal Server Error' }));
-                return;
+                return this._nextFunction(ctx)(err);
             });
         };
     }
+    _nextFunction(ctx) {
+        const NEXT_MESSAGE = "The 'next' function does not have any subsequent function.";
+        return (err) => {
+            if (err != null) {
+                if (this._errorHandler != null) {
+                    const callback = this._errorHandler(err, ctx);
+                    if (callback == null || !(callback instanceof http_1.ServerResponse)) {
+                        ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
+                        return ctx.res.end(JSON.stringify({
+                            message: err?.message
+                        }, null, 2));
+                    }
+                    return callback;
+                }
+                ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
+                if (this._formatResponse != null) {
+                    return ctx.res.end(JSON.stringify(this._formatResponse({
+                        message: err?.message,
+                    }, ctx.res.statusCode), null, 2));
+                }
+                return ctx.res.end(JSON.stringify({
+                    message: err?.message
+                }, null, 2));
+            }
+            if (this._errorHandler != null) {
+                return this._errorHandler(new Error(NEXT_MESSAGE), ctx);
+            }
+            ctx.res.writeHead(500, { 'Content-Type': 'application/json' });
+            if (this._formatResponse != null) {
+                return ctx.res.end(JSON.stringify(this._formatResponse({
+                    message: NEXT_MESSAGE
+                }, ctx.res.statusCode), null, 2));
+            }
+            return ctx.res.end(JSON.stringify({
+                message: NEXT_MESSAGE
+            }, null, 2));
+        };
+    }
     async _createServer() {
         await this._registerMiddlewares();
         await this._registerControllers();
@@ -1090,10 +1084,10 @@ class Spear {
         const server = http_1.default.createServer({ maxHeaderSize: 1024 * 1024 }, cors
             ? (req, res) => {
                 cors(req, res);
-                lookup(req, res);
+                return lookup(req, res);
             }
             : (req, res) => {
-                lookup(req, res);
+                return lookup(req, res);
             });
         if (this._ws) {
             this._wss = new ws_1.default.Server({ server, ...this._wsOptions });
@@ -1126,18 +1120,28 @@ class Spear {
             .replace(/\/+/g, '/')
             .replace(/\/+$/, '');
         const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-        return /\/api\/api/.test(normalizedPath) ? normalizedPath.replace(/\/api\/api\//, "/api/") : normalizedPath;
+        return /\/api\/api/.test(normalizedPath)
+            ? normalizedPath.replace(/\/api\/api\//, "/api/")
+            : normalizedPath;
     }
     _swaggerHandler() {
         const routes = this.routers
-            .routes.filter(r => ["GET", "POST", "PUT", "PATCH", "DELETE"].includes(r.method));
+            .routes
+            .filter(r => {
+            return [
+                "GET", "POST",
+                "PUT", "PATCH",
+                "DELETE",
+                "HEAD", "OPTIONS"
+            ].includes(r.method);
+        });
         const { path, html, staticSwaggerHandler, staticUrl } = this._parser.swagger({
             ...this._swagger,
-            specs: this._swaggerAdditional,
+            specs: this._swaggerSpecs,
             routes
         });
         this._router.get(staticUrl, staticSwaggerHandler);
-        this._router.get(String(path), (req, res) => {
+        this._router.get(path, (_, res) => {
             res.writeHead(200, { 'Content-Type': 'text/html' });
             res.write(html);
             return res.end();