tspace-spear 1.2.7 → 1.2.9-beta.1

package/dist/lib/core/server/fast-router.js

@@ -5,6 +5,20 @@ const METHODS = [
     "GET", "POST", "PUT", "PATCH",
     "DELETE", "OPTIONS", "HEAD"
 ];
+const parseValue = (value) => {
+    if (/^-?\d+(\.\d+)?$/.test(value)) {
+        const num = Number(value);
+        if (Number.isFinite(num) &&
+            Number.isSafeInteger(num)) {
+            return num;
+        }
+        if (Number.isFinite(num) &&
+            !Number.isInteger(num)) {
+            return num;
+        }
+    }
+    return value;
+};
 class FastRouter {
     trees = Object.create(null);
     _routes = [];
@@ -146,8 +160,8 @@ class FastRouter {
      * It supports parameterized routes, static routes, and (optionally)
      * wildcard matching depending on router implementation.
      *
-     * @param req Incoming HTTP request object
-     * @param res Server response object used to send output
+     * @param {IncomingMessage} req Incoming HTTP request object
+     * @param {ServerResponse} res Server response object used to send output
      *
      * @returns void
      *
@@ -189,7 +203,7 @@ class FastRouter {
                     continue;
                 }
                 if (node.param) {
-                    params[node.param.paramName] = part;
+                    params[node.param.paramName] = parseValue(part);
                     node = node.param;
                     start = i + 1;
                     continue;

package/dist/lib/core/server/fast-router.js.map

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

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

@@ -84,13 +84,38 @@ 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,
      * such as the native Node.js HTTP server or uWebSockets.js (uWS).
@@ -299,6 +324,7 @@ declare class Spear {
     private _import;
     private _scan;
     private _registerControllers;
+    private _createController;
     private _registerMiddlewares;
     private _wrapHandlers;
     private _wrapResponse;
@@ -308,6 +334,7 @@ declare class Spear {
     private _createContext;
     private _normalizePath;
     private _swaggerHandler;
+    private _resolveGlobalPrefix;
 }
 export declare class Application extends Spear {
 }

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

@@ -15,13 +15,23 @@ 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 };
 };
@@ -43,6 +53,7 @@ const response_1 = require("./response");
 const compiler_1 = require("../compiler");
 const uWS_1 = require("./uWS");
 const net_2 = require("./net");
+const metadata_1 = require("../metadata");
 /**
  *
  * The 'Spear' class is used to create a server and handle HTTP requests.
@@ -64,7 +75,12 @@ class Spear {
     _middlewares;
     _router = new fast_router_1.FastRouter();
     _parser = new parser_factory_1.ParserFactory();
-    _globalPrefix = '';
+    _globalPrefix = {
+        path: '',
+        options: {
+            exclude: []
+        }
+    };
     _adapter = { kind: 'http', server: http_1.default };
     _cluster;
     _cors;
@@ -190,14 +206,45 @@ 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} 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.
      *
-     * @param {string | null} globalPrefix - The base path prefix to apply to all routes.
-     * @returns {this} Returns the current instance for method chaining.
+     * @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) {
-        this._globalPrefix = globalPrefix == null ? '' : globalPrefix;
+    useGlobalPrefix(path, options) {
+        this._globalPrefix.path = path == null
+            ? ''
+            : path.replace(/^\/+|\/+$/g, '');
+        this._globalPrefix.options.exclude = (options?.exclude ?? []).map(route => {
+            const method = route.methods == null || route.methods === '*'
+                ? '*'
+                : route.methods.map(m => m.toUpperCase());
+            return {
+                path: route.path.replace(/^\/+|\/+$/g, ''),
+                method
+            };
+        });
         return this;
     }
     /**
@@ -382,7 +429,7 @@ class Spear {
     useRouter(router) {
         const routes = router.routes;
         for (const { path, method, handlers } of routes) {
-            this[method](this._normalizePath(this._globalPrefix, path), ...handlers);
+            this[method](this._normalizePath(this._resolveGlobalPrefix({ path, method }), path), ...handlers);
         }
         return this;
     }
@@ -417,7 +464,7 @@ class Spear {
         }
         const server = await this._createServer();
         if (this._generatePreRouteTypes) {
-            await new compiler_1.Compiler().generateRoutes(this._generatePreRouteTypes);
+            await new compiler_1.Compiler().generateRoutes(this._globalPrefix.path, this._generatePreRouteTypes);
         }
         if (this._cluster != null &&
             this._cluster || typeof this._cluster === 'number') {
@@ -542,7 +589,7 @@ class Spear {
      */
     get(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.get(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.get(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'get' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -557,7 +604,7 @@ class Spear {
      */
     post(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.post(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.post(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'post' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -572,7 +619,7 @@ class Spear {
      */
     put(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.put(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.put(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'put' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -587,7 +634,7 @@ class Spear {
      */
     patch(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.patch(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.patch(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'patch' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -602,7 +649,7 @@ class Spear {
      */
     delete(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.delete(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.delete(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'delete' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -617,7 +664,7 @@ class Spear {
      */
     head(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.head(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.head(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'head' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -632,7 +679,7 @@ class Spear {
      */
     options(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.options(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.options(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'options' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -647,7 +694,7 @@ class Spear {
      */
     all(path, ...handlers) {
         this._onListeners.push(() => {
-            return this._router.all(this._normalizePath(this._globalPrefix, path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
+            return this._router.all(this._normalizePath(this._resolveGlobalPrefix({ path, method: 'all' }), path), this._wrapHandlers(...this._globalMiddlewares, ...handlers));
         });
         return this;
     }
@@ -717,52 +764,100 @@ class Spear {
                     console.log(`\x1b[31m[ControllerLoader ERROR]\x1b[0m \x1b[36m${file}\x1b[0m must export a controller class`);
                     continue;
                 }
-                const controllerInstance = new controller();
-                const prefixPath = Reflect.getMetadata("controllers", controller) ?? '';
-                const routers = Reflect.getMetadata("routers", controller) ?? [];
-                const swaggers = Reflect.getMetadata("swaggers", controller) ?? [];
-                if (prefixPath == null)
-                    continue;
+                const controllerInstance = this._createController(controller);
+                const prefixPath = Reflect.getMetadata(metadata_1.CONTROLLER_METADATA, controller) ?? '';
+                const routers = Reflect.getMetadata(metadata_1.ROUTE_METADATA, controller) ?? [];
+                const swaggers = Reflect.getMetadata(metadata_1.SWAGGER_METADATA, controller) ?? [];
                 for (const { method, path, handler } of Array.from(routers)) {
                     const find = Array.from(swaggers).find(s => s.handler === handler);
                     if (find != null) {
+                        const globalPrefix = this._resolveGlobalPrefix({
+                            path: this._normalizePath(prefixPath, path),
+                            method
+                        });
                         this._swaggerSpecs = [
                             ...this._swaggerSpecs,
                             {
                                 ...find,
-                                path: this._normalizePath(this._globalPrefix, prefixPath, path),
+                                path: this._normalizePath(globalPrefix, prefixPath, path),
                                 method
                             }
                         ];
                     }
-                    this[method](this._normalizePath(this._globalPrefix, prefixPath, path), controllerInstance[String(handler)].bind(controllerInstance));
+                    this[method](this._normalizePath(prefixPath, path), controllerInstance[String(handler)].bind(controllerInstance));
                 }
             }
             return;
         }
         for (const controller of this._controllers) {
-            const controllerInstance = new controller();
-            const prefixPath = Reflect.getMetadata("controllers", controller) ?? '';
-            const routers = Reflect.getMetadata("routers", controller) ?? [];
-            const swaggers = Reflect.getMetadata("swaggers", controller) ?? [];
-            if (prefixPath == null)
-                continue;
+            const controllerInstance = this._createController(controller);
+            const prefixPath = Reflect.getMetadata(metadata_1.CONTROLLER_METADATA, controller) ?? '';
+            const routers = Reflect.getMetadata(metadata_1.ROUTE_METADATA, controller) ?? [];
+            const swaggers = Reflect.getMetadata(metadata_1.SWAGGER_METADATA, controller) ?? [];
             for (const { method, path, handler } of Array.from(routers)) {
                 const find = Array.from(swaggers).find(s => s.handler === handler);
                 if (find != null) {
+                    const globalPrefix = this._resolveGlobalPrefix({
+                        path: this._normalizePath(prefixPath, path),
+                        method
+                    });
                     this._swaggerSpecs = [
                         ...this._swaggerSpecs,
                         {
                             ...find,
-                            path: this._normalizePath(this._globalPrefix, prefixPath, path),
+                            path: this._normalizePath(globalPrefix, prefixPath, path),
                             method
                         }
                     ];
                 }
-                this[method](this._normalizePath(this._globalPrefix, prefixPath, path), controllerInstance[String(handler)].bind(controllerInstance));
+                this[method](this._normalizePath(prefixPath, path), controllerInstance[String(handler)].bind(controllerInstance));
             }
         }
     }
+    _createController(ControllerClass) {
+        const services = Reflect.getMetadata(metadata_1.SERVICE_METADATA, ControllerClass) ?? [];
+        const constructorTypes = Reflect.getMetadata(metadata_1.PARAMTYPES_METADATA, ControllerClass) ?? [];
+        if (!constructorTypes.length) {
+            return new ControllerClass();
+        }
+        if (!services.length) {
+            throw new Error(`\x1b[31m[ServiceLoader ERROR]\x1b[0m \x1b[36m${ControllerClass.name}\x1b[0m requires dependencies but no @Service() decorator was found`);
+        }
+        const serviceMap = new Map();
+        for (const ServiceClass of services) {
+            if (typeof ServiceClass !== 'function') {
+                throw new Error(`\x1b[31m[ServiceLoader ERROR]\x1b[0m Invalid service in @Service() of ${ControllerClass.name}`);
+            }
+            serviceMap.set(ServiceClass, new ServiceClass());
+        }
+        const injections = [];
+        const available = services.length
+            ? services
+                .map((s) => s.name)
+            : 'None';
+        for (const DependencyClass of constructorTypes) {
+            const service = serviceMap.get(DependencyClass);
+            if (!service) {
+                throw new Error([
+                    '\x1b[31m[ServiceLoader ERROR]\x1b[0m',
+                    '',
+                    `\x1b[36mController\x1b[0m : ${ControllerClass.name}`,
+                    `\x1b[36mDependency\x1b[0m : ${DependencyClass.name}`,
+                    `\x1b[36mAvailable \x1b[0m : ${available.join(', ')}`,
+                    '',
+                    '\x1b[33mHint\x1b[0m',
+                    '@Service([',
+                    `    ${available.join(',\n    ')},`,
+                    `    ${DependencyClass.name}`,
+                    '])',
+                    '',
+                    `Register '${DependencyClass.name}' in @Service()`
+                ].join('\n'));
+            }
+            injections.push(service);
+        }
+        return new ControllerClass(...injections);
+    }
     async _registerMiddlewares() {
         if (this._middlewares == null)
             return;
@@ -865,6 +960,10 @@ class Spear {
     _nextError(ctx) {
         const NEXT_MESSAGE = "The 'next' function does not have any subsequent function.";
         return (err) => {
+            const status = typeof err?.statusCode === 'number' &&
+                Number.isFinite(err.statusCode)
+                ? err.statusCode
+                : 500;
             if (ctx.res.writableEnded)
                 return;
             const errorMessage = err?.message || NEXT_MESSAGE;
@@ -872,7 +971,7 @@ class Spear {
                 return this._errorHandler(err, ctx);
             }
             if (!ctx.res.headersSent) {
-                ctx.res.writeHead(500, const_1.HEADER_CONTENT_TYPES['json']);
+                ctx.res.writeHead(status, const_1.HEADER_CONTENT_TYPES['json']);
             }
             if (this._formatResponse != null) {
                 ctx.res.end(JSON.stringify(this._formatResponse({
@@ -1069,13 +1168,25 @@ class Spear {
     }
     _normalizePath(...paths) {
         const path = paths
+            .filter(Boolean)
             .join('/')
             .replace(/\/+/g, '/')
             .replace(/\/+$/, '');
-        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
-        return /\/api\/api/.test(normalizedPath)
-            ? normalizedPath.replace(/\/api\/api\//, "/api/")
-            : normalizedPath;
+        let normalizedPath = path.startsWith('/')
+            ? path
+            : `/${path}`;
+        const globalPrefix = this._globalPrefix.path
+            .replace(/^\/+|\/+$/g, '');
+        if (globalPrefix) {
+            const duplicatedPrefix = `/${globalPrefix}/${globalPrefix}/`;
+            normalizedPath =
+                normalizedPath.replace(duplicatedPrefix, `/${globalPrefix}/`);
+            if (normalizedPath ===
+                `/${globalPrefix}/${globalPrefix}`) {
+                normalizedPath = `/${globalPrefix}`;
+            }
+        }
+        return normalizedPath || '/';
     }
     async _swaggerHandler() {
         const routes = this.routers
@@ -1102,6 +1213,38 @@ class Spear {
         });
         return;
     }
+    _resolveGlobalPrefix({ path, method }) {
+        const globalPrefix = this._globalPrefix.path;
+        if (!globalPrefix) {
+            return '';
+        }
+        if (path === '*') {
+            return `/${globalPrefix}`;
+        }
+        const cleanPath = path.replace(/^\/+|\/+$/g, '');
+        const upperMethod = method.toUpperCase();
+        const exclude = this._globalPrefix.options.exclude;
+        const isExcluded = exclude.some(route => {
+            const methods = route.method ?? '*';
+            if (methods !== '*' &&
+                !methods.includes(upperMethod)) {
+                return false;
+            }
+            const routePath = route.path.replace(/^\/+|\/+$/g, '');
+            if (routePath === cleanPath) {
+                return true;
+            }
+            if (routePath.endsWith('/*')) {
+                const basePath = routePath.slice(0, -2);
+                return (cleanPath === basePath ||
+                    cleanPath.startsWith(basePath + '/'));
+            }
+            return false;
+        });
+        return isExcluded
+            ? ''
+            : `/${globalPrefix}`;
+    }
 }
 exports.Spear = Spear;
 class Application extends Spear {