tspace-spear 1.2.9 → 1.3.0

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

@@ -0,0 +1,220 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpfiles = exports.httpBody = exports.httpAdaptRequestResponse = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const mime_types_1 = __importDefault(require("mime-types"));
+const crypto_1 = __importDefault(require("crypto"));
+const string_decoder_1 = require("string_decoder");
+const busboy_1 = __importDefault(require("busboy"));
+const utils_1 = require("../../utils");
+const httpAdaptRequestResponse = (req, res) => {
+    const headers = req.headers || {};
+    const request = {
+        http: req,
+        method: req.method?.toUpperCase() || "GET",
+        url: req.url || "/",
+        headers,
+        on(event, cb) {
+            return req.on(event, cb);
+        },
+        pipe(cb) {
+            return req.pipe(cb);
+        }
+    };
+    const response = {
+        http: res,
+        writableEnded: false,
+        aborted: false,
+        writeHeaders: Object.create(null),
+        headersSent: false,
+        statusCode: 200,
+        setHeader(key, value) {
+            if (!response.headersSent && !response.writableEnded) {
+                res.setHeader(key, value);
+            }
+            return response;
+        },
+        writeHeader(key, value) {
+            return response.setHeader(key, value);
+        },
+        writeHead(status, context) {
+            response.statusCode = status;
+            if (!response.headersSent) {
+                res.writeHead(status, context);
+                response.headersSent = true;
+            }
+            return response;
+        },
+        writeStatus(status) {
+            response.statusCode = status;
+            if (!response.headersSent) {
+                res.statusCode = status;
+            }
+            return response;
+        },
+        end(chunk) {
+            if (response.writableEnded)
+                return;
+            if (chunk == null) {
+                res.end();
+                return;
+            }
+            response.writableEnded = true;
+            if (!response.headersSent) {
+                res.statusCode = response.statusCode;
+            }
+            if (typeof chunk === 'string' ||
+                Buffer.isBuffer(chunk) ||
+                chunk instanceof Uint8Array) {
+                res.end(chunk);
+                return;
+            }
+            res.end(JSON.stringify(chunk));
+            return;
+        },
+    };
+    return {
+        req: request,
+        res: response,
+    };
+};
+exports.httpAdaptRequestResponse = httpAdaptRequestResponse;
+const httpBody = (req, res) => {
+    return new Promise((resolve, reject) => {
+        const decoder = new string_decoder_1.StringDecoder("utf-8");
+        let payload = "";
+        req.on("data", (data) => {
+            payload += decoder.write(data);
+        });
+        req.on("end", async () => {
+            payload += decoder.end();
+            const contentType = req.headers["content-type"]?.toLowerCase() || null;
+            try {
+                const body = await (0, utils_1.normalizeRequestBody)({ contentType, payload });
+                return resolve(body);
+            }
+            catch (err) {
+                return reject(err);
+            }
+        });
+        req.on("error", (err) => {
+            return reject(err);
+        });
+    });
+};
+exports.httpBody = httpBody;
+const httpfiles = async ({ req, res, options, }) => {
+    const temp = options.tempFileDir;
+    if (!fs_1.default.existsSync(temp)) {
+        try {
+            fs_1.default.mkdirSync(temp, { recursive: true });
+        }
+        catch (err) { }
+    }
+    return new Promise((resolve, reject) => {
+        const body = {};
+        const files = {};
+        const fileWritePromises = [];
+        const bb = (0, busboy_1.default)({ headers: req.headers, defParamCharset: "utf8" });
+        const removeTemp = (fileTemp, ms) => {
+            const remove = () => {
+                try {
+                    fs_1.default.unlinkSync(fileTemp);
+                }
+                catch (err) { }
+            };
+            setTimeout(remove, ms);
+        };
+        bb.on("file", (fieldName, fileData, info) => {
+            const { filename, mimeType } = info;
+            const extension = mime_types_1.default.extension(mimeType) ||
+                path_1.default.extname(filename).replace(".", "") ||
+                "bin";
+            const tempFilename = crypto_1.default.randomBytes(16).toString("hex");
+            const filePath = path_1.default.join(path_1.default.resolve(), `${temp}/${tempFilename}`);
+            const writeStream = fs_1.default.createWriteStream(filePath);
+            let fileSize = 0;
+            fileData.on("data", (data) => {
+                fileSize += data.length;
+                if (fileSize > options.limit) {
+                    fileData.unpipe(writeStream);
+                    writeStream.destroy();
+                    return reject(new Error(`The file '${fieldName}' is too large to be uploaded. The limit is '${options.limit}' bytes.`));
+                }
+            });
+            const fileWritePromise = new Promise((resolve, reject) => {
+                fileData.pipe(writeStream);
+                writeStream.on("finish", () => {
+                    const file = {
+                        name: filename,
+                        tempFilePath: filePath,
+                        tempFileName: tempFilename,
+                        mimetype: mimeType,
+                        extension: extension,
+                        size: fileSize,
+                        sizes: {
+                            bytes: fileSize,
+                            kb: fileSize / 1024,
+                            mb: fileSize / 1024 / 1024,
+                            gb: fileSize / 1024 / 1024 / 1024,
+                        },
+                        write: (to) => {
+                            return new Promise((resolve, reject) => {
+                                fs_1.default
+                                    .createReadStream(filePath)
+                                    .pipe(fs_1.default.createWriteStream(to))
+                                    .on("finish", () => {
+                                    return resolve(null);
+                                })
+                                    .on("error", (err) => {
+                                    return reject(err);
+                                });
+                            });
+                        },
+                        remove: () => {
+                            return new Promise((resolve) => setTimeout(() => {
+                                fs_1.default.unlinkSync(filePath);
+                                return resolve(null);
+                            }, 100));
+                        },
+                    };
+                    if (files[fieldName] == null) {
+                        files[fieldName] = [];
+                    }
+                    files[fieldName].push(file);
+                    if (options.removeTempFile.remove) {
+                        removeTemp(filePath, options.removeTempFile.ms);
+                    }
+                    return resolve(null);
+                });
+                writeStream.on("error", reject);
+            });
+            fileWritePromises.push(fileWritePromise);
+        });
+        bb.on("field", (name, value) => {
+            body[name] = value;
+        });
+        bb.on("finish", () => {
+            Promise.all(fileWritePromises)
+                .then(() => {
+                return resolve({
+                    files,
+                    body,
+                });
+            })
+                .catch((err) => {
+                return reject(err);
+            });
+        });
+        bb.on("error", (err) => {
+            return reject(err);
+        });
+        req.pipe(bb);
+    });
+};
+exports.httpfiles = httpfiles;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/core/server/http/index.ts"],"names":[],"mappings":";;;;;;AACA,4CAAmC;AACnC,gDAAqC;AACrC,4DAA2C;AAC3C,oDAAuC;AACvC,mDAA+C;AAO/C,oDAEgB;AAGhB,uCAAmD;AAE5C,MAAM,wBAAwB,GAAG,CACtC,GAAoB,EACpB,GAAmB,EACnB,EAAE;IAEF,MAAM,OAAO,GAAwB,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAEvD,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK;QAC1C,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG;QACnB,OAAO;QACP,EAAE,CAAC,KAAa,EAAE,EAAO;YACvB,OAAO,GAAG,CAAC,EAAE,CAAC,KAAK,EAAC,EAAE,CAAC,CAAA;QACzB,CAAC;QACD,IAAI,CAAC,EAAM;YACT,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrB,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,GAAG;QACf,SAAS,CAAC,GAAW,EAAE,KAAa;YAClC,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;gBACrD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,WAAW,CAAC,GAAW,EAAE,KAAa;YAEpC,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAExC,CAAC;QACD,SAAS,CAAC,MAAc,EAAE,OAA+B;YAEvD,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;YAI7B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAE1B,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;YAE9B,CAAC;YAID,OAAO,QAAQ,CAAC;QAElB,CAAC;QACD,WAAW,CAAC,MAAc;YAExB,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;YAI7B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAE1B,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;YAE1B,CAAC;YAID,OAAO,QAAQ,CAAC;QAElB,CAAC;QACD,GAAG,CAAC,KAAe;YAEjB,IAAI,QAAQ,CAAC,aAAa;gBAAE,OAAO;YAEnC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;YAE9B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;YACvC,CAAC;YAED,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACtB,KAAK,YAAY,UAAU,EAC3B,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAE/B,OAAO;QAET,CAAC;KACF,CAAC;IACF,OAAO;QACL,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,QAAQ;KAId,CAAC;AAEJ,CAAC,CAAC;AAhHW,QAAA,wBAAwB,4BAgHnC;AAEK,MAAM,QAAQ,GAAG,CAAC,GAAc,EAAE,GAAe,EAAE,EAAE;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,IAAI,8BAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC9B,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;YACvB,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAEzB,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;YAEvE,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAA,4BAAoB,EAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;gBAElE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAQ,EAAE,EAAE;YAC3B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AA3BW,QAAA,QAAQ,YA2BnB;AAEK,MAAM,SAAS,GAAG,KAAK,EAAE,EAC9B,GAAG,EACH,GAAG,EACH,OAAO,GAYR,EAAE,EAAE;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjC,IAAI,CAAC,YAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,YAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC,CAAA,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,OAAO,CAChB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClB,MAAM,IAAI,GAAwB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAwB,EAAE,CAAC;QAEtC,MAAM,iBAAiB,GAAU,EAAE,CAAC;QAEpC,MAAM,EAAE,GAAG,IAAA,gBAAM,EAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAU,EAAE,EAAE;YAClD,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,CAAC;oBACH,YAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC,CAAA,CAAC;YAClB,CAAC,CAAC;YACF,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,EAAE,CAAC,EAAE,CACH,MAAM,EACN,CAAC,SAAiB,EAAE,QAAkB,EAAE,IAAc,EAAE,EAAE;YACxD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;YAEpC,MAAM,SAAS,GACb,oBAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;gBACxB,cAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC7C,KAAK,CAAC;YAER,MAAM,YAAY,GAAG,gBAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE5D,MAAM,QAAQ,GAAG,cAAU,CAAC,IAAI,CAC9B,cAAU,CAAC,OAAO,EAAE,EACpB,GAAG,IAAI,IAAI,YAAY,EAAE,CAC1B,CAAC;YAEF,MAAM,WAAW,GAAG,YAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAEzD,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACnC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;gBAExB,IAAI,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC7B,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAE7B,WAAW,CAAC,OAAO,EAAE,CAAC;oBAEtB,OAAO,MAAM,CACX,IAAI,KAAK,CACP,aAAa,SAAS,gDAAgD,OAAO,CAAC,KAAK,UAAU,CAC9F,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACvD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAE3B,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;oBAC5B,MAAM,IAAI,GAAG;wBACX,IAAI,EAAE,QAAQ;wBACd,YAAY,EAAE,QAAQ;wBACtB,YAAY,EAAE,YAAY;wBAC1B,QAAQ,EAAE,QAAQ;wBAClB,SAAS,EAAE,SAAS;wBACpB,IAAI,EAAE,QAAQ;wBACd,KAAK,EAAE;4BACL,KAAK,EAAE,QAAQ;4BACf,EAAE,EAAE,QAAQ,GAAG,IAAI;4BACnB,EAAE,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;4BAC1B,EAAE,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI;yBAClC;wBACD,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE;4BACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gCACrC,YAAQ;qCACL,gBAAgB,CAAC,QAAQ,CAAC;qCAC1B,IAAI,CAAC,YAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;qCACpC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;oCACjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;gCACvB,CAAC,CAAC;qCACD,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oCACnB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gCACrB,CAAC,CAAC,CAAC;4BACP,CAAC,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM,EAAE,GAAG,EAAE;4BACX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7B,UAAU,CAAC,GAAG,EAAE;gCACd,YAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gCAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;4BACvB,CAAC,EAAE,GAAG,CAAC,CACR,CAAC;wBACJ,CAAC;qBACF,CAAC;oBAEF,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;wBAC7B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;oBACxB,CAAC;oBAED,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAE5B,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;wBAClC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBAClD,CAAC;oBAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC,CAAC,CAAC;gBAEH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YAEH,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3C,CAAC,CACF,CAAC;QAEF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;YAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;iBAC3B,IAAI,CAAC,GAAG,EAAE;gBACT,OAAO,OAAO,CAAC;oBACb,KAAK;oBACL,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAQ,EAAE,EAAE;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AApKW,QAAA,SAAS,aAoKpB"}

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

@@ -84,21 +84,46 @@ declare class Spear {
     /**
      * The 'useGlobalPrefix' method is used to sets a global prefix for all routes in the router.
      *
-     * If `globalPrefix` is `null` or `undefined`, it will default to an empty string,
-     * meaning no prefix will be applied.
+     * This prefix will be prepended to every route path in the application.
+     * If `path` is `null`, `undefined`, or an empty string, no global prefix
+     * will be applied.
      *
-     * @param {string | null} globalPrefix - The base path prefix to apply to all routes.
-     * @returns {this} Returns the current instance for method chaining.
+     * @param {string} path - The global route prefix.
+     *
+     * @param {Object} [options] - Additional configuration options.
+     * @param {Array<{ path: string; method?: TMethod | TMethod[] }>} [options.exclude]
+     * Routes to exclude from the global prefix.
+     *
+     * @returns {this} Returns the current router instance for chaining.
+     *
+     * @example
+     * import Spear from "tspace-spear";
+     * const app = new Spear()
+     *
+     * app.useGlobalPrefix('/api');
+     *
+     * @example
+     * app.useGlobalPrefix('/api', {
+     *   exclude: [
+     *     { path: '/health' },
+     *     { path: '/auth/login', method: 'POST' }
+     *   ]
+     * });
      */
-    useGlobalPrefix(globalPrefix: string | null): this;
+    useGlobalPrefix(path: string | null, options?: {
+        exclude?: {
+            path: string;
+            methods?: T.MethodInput[] | '*';
+        }[];
+    }): this;
     /**
-     * The 'useAdater' method is used to switch between different server implementations,
+     * The 'useAdapter' method is used to switch between different server implementations,
      * such as the native Node.js HTTP server or uWebSockets.js (uWS).
      *
      * @param {T.AdapterServer} adapter - The adapter instance (e.g., HTTP or uWS).
      * @returns {this} Returns the current instance for chaining
      */
-    useAdater(adapter: T.AdapterServer): this;
+    useAdapter(adapter: T.AdapterServer): this;
     /**
      * The 'useCluster' method is used cluster run the server
      *
@@ -299,6 +324,8 @@ declare class Spear {
     private _import;
     private _scan;
     private _registerControllers;
+    private _createController;
+    private _normalizeMiddlewares;
     private _registerMiddlewares;
     private _wrapHandlers;
     private _wrapResponse;
@@ -308,6 +335,7 @@ declare class Spear {
     private _createContext;
     private _normalizePath;
     private _swaggerHandler;
+    private _resolveGlobalPrefix;
 }
 export declare class Application extends Spear {
 }