tspace-spear 1.2.3 → 1.2.5-beta.1

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

@@ -9,7 +9,7 @@
  * }
  * ```
  */
-export declare const Get: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Get: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP POST route.
  *
@@ -21,7 +21,7 @@ export declare const Get: (path: `/${string}`) => (target: any, propertyKey: any
  * }
  * ```
  */
-export declare const Post: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Post: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP PUT route.
  *
@@ -33,7 +33,7 @@ export declare const Post: (path: `/${string}`) => (target: any, propertyKey: an
  * async update(ctx: T.Context) {}
  * ```
  */
-export declare const Put: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Put: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP PATCH route.
  *
@@ -45,7 +45,7 @@ export declare const Put: (path: `/${string}`) => (target: any, propertyKey: any
  * async patch(ctx: T.Context) {}
  * ```
  */
-export declare const Patch: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Patch: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP DELETE route.
  *
@@ -55,7 +55,7 @@ export declare const Patch: (path: `/${string}`) => (target: any, propertyKey: a
  * async remove(ctx: T.Context) {}
  * ```
  */
-export declare const Delete: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Delete: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP HEAD route.
  *
@@ -67,7 +67,7 @@ export declare const Delete: (path: `/${string}`) => (target: any, propertyKey:
  * async health(ctx: T.Context) {}
  * ```
  */
-export declare const Head: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Head: (path: `/${string}`) => MethodDecorator;
 /**
  * Maps a controller method to an HTTP OPTIONS route.
  *
@@ -79,4 +79,4 @@ export declare const Head: (path: `/${string}`) => (target: any, propertyKey: an
  * async options(ctx: T.Context) {}
  * ```
  */
-export declare const Options: (path: `/${string}`) => (target: any, propertyKey: any) => void;
+export declare const Options: (path: `/${string}`) => MethodDecorator;

package/dist/lib/core/decorators/methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/methods.ts"],"names":[],"mappings":";;;AAEA,MAAM,eAAe,GAAG,CAAC,MAAgB,EAAE,EAAE;IAC3C,OAAO,CAAC,IAAkB,EAAE,EAAE;QAC5B,OAAO,CAAC,MAAU,EAAE,WAAe,EAAE,EAAE;YACrC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;YAEtC,MAAM,OAAO,GAAe,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBACpE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBAC5C,CAAC,CAAC,EAAE,CAAC;YAEP,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,IAAI;gBACJ,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAE9C;;;;;;;;GAQG;AACU,QAAA,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/methods.ts"],"names":[],"mappings":";;;AAEA,MAAM,eAAe,GAAG,CAAC,MAAgB,EAAE,EAAE;IAC3C,OAAO,CAAC,IAAkB,EAAmB,EAAE;QAC7C,OAAO,CAAC,MAAU,EAAE,WAAe,EAAE,EAAE;YACrC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;YAEtC,MAAM,OAAO,GAAe,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBACpE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC;gBAC5C,CAAC,CAAC,EAAE,CAAC;YAEP,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,IAAI;gBACJ,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,CAAA;IACH,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACU,QAAA,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAE9C;;;;;;;;GAQG;AACU,QAAA,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEhD;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACU,QAAA,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC"}

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

@@ -25,7 +25,7 @@ import { T } from '../types';
  * Example middleware:
  *
  * ```ts
- * const authMiddleware: T.RequestFunction = (ctx, next) => {
+ * const authMiddleware: T.ContextHandler = (ctx, next) => {
  *   if (!ctx.user) {
  *     return next(new Error("Unauthorized"));
  *   }
@@ -33,7 +33,7 @@ import { T } from '../types';
  * };
  * ```
  *
- * @param {T.RequestFunction} middleware - Middleware function to execute before the route handler.
+ * @param {T.ContextHandler} middleware - Middleware function to execute before the route handler.
  * @returns {MethodDecorator}
  */
-export declare const Middleware: (middleware: T.RequestFunction) => Function;
+export declare const Middleware: (middleware: T.ContextHandler) => MethodDecorator;

package/dist/lib/core/decorators/middleware.js

@@ -27,7 +27,7 @@ exports.Middleware = void 0;
  * Example middleware:
  *
  * ```ts
- * const authMiddleware: T.RequestFunction = (ctx, next) => {
+ * const authMiddleware: T.ContextHandler = (ctx, next) => {
  *   if (!ctx.user) {
  *     return next(new Error("Unauthorized"));
  *   }
@@ -35,7 +35,7 @@ exports.Middleware = void 0;
  * };
  * ```
  *
- * @param {T.RequestFunction} middleware - Middleware function to execute before the route handler.
+ * @param {T.ContextHandler} middleware - Middleware function to execute before the route handler.
  * @returns {MethodDecorator}
  */
 const Middleware = (middleware) => {

package/dist/lib/core/decorators/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/middleware.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACI,MAAM,UAAU,GAAG,CAAC,UAA6B,EAAY,EAAE;IAEpE,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,UAA8B,EAAE,EAAE;QAClE,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,UAAU,GAAc,EAAE,IAAoB;YAC/D,IAAI,CAAC;gBAEH,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAE1D,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;oBACnC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;wBAChB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnB,CAAC;oBAED,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;YAEL,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,UAAU,cAuBrB"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/middleware.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACI,MAAM,UAAU,GAAG,CAAC,UAA4B,EAAmB,EAAE;IAE1E,OAAO,CAAC,MAAW,EAAE,GAAQ,EAAE,UAA8B,EAAE,EAAE;QAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,UAAU,GAAc,EAAE,IAAoB;YAC/D,IAAI,CAAC;gBAEH,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;gBAE1D,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;oBACnC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;wBAChB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnB,CAAC;oBAED,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;YAEL,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAvBW,QAAA,UAAU,cAuBrB"}

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

@@ -23,4 +23,4 @@ import { type T } from '../types';
  * @param {T.StatusCode} statusCode - HTTP status code to send with the response.
  * @returns {MethodDecorator}
  */
-export declare const StatusCode: (statusCode: T.StatusCode) => Function;
+export declare const StatusCode: (statusCode: T.StatusCode) => MethodDecorator;

package/dist/lib/core/decorators/statusCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"statusCode.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/statusCode.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,UAAU,GAAG,CAAC,UAAwB,EAAY,EAAE;IAC7D,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,UAA8B,EAAE,EAAE;QAChE,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;QAE1E,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAc,EAAE,IAAoB;YACnE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAChE,OAAO,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC,CAAC;AAbW,QAAA,UAAU,cAarB"}
+{"version":3,"file":"statusCode.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/statusCode.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,UAAU,GAAG,CAAC,UAAwB,EAAmB,EAAE;IACpE,OAAO,CAAC,MAAW,EAAE,GAAQ,EAAE,UAA8B,EAAE,EAAE;QAC7D,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,MAAM,IAAI,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;QAE1E,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAc,EAAE,IAAoB;YACnE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAChE,OAAO,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC,CAAC;AAbW,QAAA,UAAU,cAarB"}

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

@@ -33,4 +33,4 @@ import { type T } from "../types";
  * @param {T.Swagger.Spec} data - Swagger/OpenAPI specification for the route.
  * @returns {MethodDecorator}
  */
-export declare const Swagger: (data: T.Swagger.Spec) => (target: any, propertyKey: any) => void;
+export declare const Swagger: (data: T.Swagger.Spec) => MethodDecorator;

package/dist/lib/core/decorators/swagger.js.map

@@ -1 +1 @@
-{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/swagger.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACI,MAAM,OAAO,GAAG,CAAC,IAAoB,EAAE,EAAE;IAC9C,OAAO,CAAC,MAAW,EAAE,WAAgB,EAAE,EAAE;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;QAEtC,MAAM,QAAQ,GAAU,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YAC7C,CAAC,CAAC,EAAE,CAAC;QAEP,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,WAAW;YACpB,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,OAAO,WAelB"}
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../../../src/lib/core/decorators/swagger.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACI,MAAM,OAAO,GAAG,CAAC,IAAoB,EAAmB,EAAE;IAC/D,OAAO,CAAC,MAAW,EAAE,WAAgB,EAAE,EAAE;QACvC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;QAEtC,MAAM,QAAQ,GAAU,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC;YAC7C,CAAC,CAAC,EAAE,CAAC;QAEP,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,WAAW;YACpB,GAAG,IAAI;SACR,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,OAAO,WAelB"}

package/dist/lib/core/server/fast-router.d.ts

@@ -0,0 +1,133 @@
+import { IncomingMessage, ServerResponse } from "http";
+type Handler = (req: IncomingMessage, res: ServerResponse, params: Record<string, string>) => any;
+export declare class FastRouter {
+    private trees;
+    private _routes;
+    constructor();
+    /**
+     * Get all registered routes in the router.
+     *
+     * Returns the internal route registry used for debugging,
+     * inspection, or serialization of the router tree.
+     *
+     * @returns Internal routes structure
+     */
+    get routes(): {
+        path: string;
+        method: string;
+        params: string[];
+    }[];
+    /**
+     * Register a GET route.
+     *
+     * Handles HTTP GET requests for the specified path.
+     *
+     * @param path Route path (e.g. "/users/:id")
+     * @param handler Function executed when route matches
+     * @returns Router instance for chaining
+     *
+     * @example
+     * router.get("/users", (req, res) => {});
+     */
+    get(path: string, handler: Handler): this;
+    /**
+     * Register a POST route.
+     *
+     * Used for creating resources or submitting data.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    post(path: string, handler: Handler): this;
+    /**
+     * Register a PUT route.
+     *
+     * Typically used for full resource replacement.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    put(path: string, handler: Handler): this;
+    /**
+     * Register a PATCH route.
+     *
+     * Used for partial updates to a resource.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    patch(path: string, handler: Handler): this;
+    /**
+     * Register a DELETE route.
+     *
+     * Used for removing a resource.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    delete(path: string, handler: Handler): this;
+    /**
+     * Register an OPTIONS route.
+     *
+     * Used for CORS preflight requests or capability discovery.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    options(path: string, handler: Handler): this;
+    /**
+     * Register a HEAD route.
+     *
+     * Same as GET but returns headers only (no body).
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    head(path: string, handler: Handler): this;
+    /**
+     * Register a route for all HTTP methods.
+     *
+     * This registers the same handler for every supported HTTP method.
+     * Useful for middleware-like or catch-all behavior.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     *
+     * @example
+     * router.all("/health", (req, res) => res.send("OK"));
+     */
+    all(path: string, handler: Handler): this;
+    /**
+     * Lookup a route handler based on the incoming request.
+     *
+     * This method is responsible for resolving the correct route
+     * from the registered router tree and executing the matched handler.
+     *
+     * 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
+     *
+     * @returns void
+     *
+     * @example
+     * router.lookup(req, res);
+     *
+     * @internal
+     * This is typically called by the HTTP server layer and should not
+     * be invoked directly in most application code.
+     */
+    lookup(req: IncomingMessage, res: ServerResponse): any;
+    private _createNode;
+    private _add;
+    private _extractParams;
+}
+export {};

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

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FastRouter = void 0;
+const METHODS = [
+    "GET", "POST", "PUT", "PATCH",
+    "DELETE", "OPTIONS", "HEAD"
+];
+class FastRouter {
+    trees = Object.create(null);
+    _routes = [];
+    constructor() {
+        for (const m of METHODS) {
+            this.trees[m] = this._createNode();
+        }
+    }
+    /**
+     * Get all registered routes in the router.
+     *
+     * Returns the internal route registry used for debugging,
+     * inspection, or serialization of the router tree.
+     *
+     * @returns Internal routes structure
+     */
+    get routes() {
+        return this._routes;
+    }
+    /**
+     * Register a GET route.
+     *
+     * Handles HTTP GET requests for the specified path.
+     *
+     * @param path Route path (e.g. "/users/:id")
+     * @param handler Function executed when route matches
+     * @returns Router instance for chaining
+     *
+     * @example
+     * router.get("/users", (req, res) => {});
+     */
+    get(path, handler) {
+        this._add("GET", path, handler);
+        return this;
+    }
+    /**
+     * Register a POST route.
+     *
+     * Used for creating resources or submitting data.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    post(path, handler) {
+        this._add("POST", path, handler);
+        return this;
+    }
+    /**
+     * Register a PUT route.
+     *
+     * Typically used for full resource replacement.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    put(path, handler) {
+        this._add("PUT", path, handler);
+        return this;
+    }
+    /**
+     * Register a PATCH route.
+     *
+     * Used for partial updates to a resource.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    patch(path, handler) {
+        this._add("PATCH", path, handler);
+        return this;
+    }
+    /**
+     * Register a DELETE route.
+     *
+     * Used for removing a resource.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    delete(path, handler) {
+        this._add("DELETE", path, handler);
+        return this;
+    }
+    /**
+     * Register an OPTIONS route.
+     *
+     * Used for CORS preflight requests or capability discovery.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    options(path, handler) {
+        this._add("OPTIONS", path, handler);
+        return this;
+    }
+    /**
+     * Register a HEAD route.
+     *
+     * Same as GET but returns headers only (no body).
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     */
+    head(path, handler) {
+        this._add("HEAD", path, handler);
+        return this;
+    }
+    /**
+     * Register a route for all HTTP methods.
+     *
+     * This registers the same handler for every supported HTTP method.
+     * Useful for middleware-like or catch-all behavior.
+     *
+     * @param path Route path
+     * @param handler Route handler function
+     * @returns Router instance for chaining
+     *
+     * @example
+     * router.all("/health", (req, res) => res.send("OK"));
+     */
+    all(path, handler) {
+        for (const method of METHODS) {
+            this._add(method, path, handler);
+        }
+        return this;
+    }
+    /**
+     * Lookup a route handler based on the incoming request.
+     *
+     * This method is responsible for resolving the correct route
+     * from the registered router tree and executing the matched handler.
+     *
+     * 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
+     *
+     * @returns void
+     *
+     * @example
+     * router.lookup(req, res);
+     *
+     * @internal
+     * This is typically called by the HTTP server layer and should not
+     * be invoked directly in most application code.
+     */
+    lookup(req, res) {
+        const method = req.method;
+        let node = this.trees[method];
+        if (!node) {
+            res.statusCode = 405;
+            console.log({ method });
+            return res.end("Method Not Allowed");
+        }
+        let url = req.url || "/";
+        let q = url.indexOf("?");
+        if (q !== -1)
+            url = url.slice(0, q);
+        const params = Object.create(null);
+        const rootWildcard = node.wildcard;
+        let start = 1;
+        for (let i = 1; i <= url.length; i++) {
+            if (url[i] === "/" || i === url.length) {
+                const part = url.slice(start, i);
+                if (!part) {
+                    start = i + 1;
+                    continue;
+                }
+                let next = node.static[part];
+                if (next) {
+                    node = next;
+                    start = i + 1;
+                    continue;
+                }
+                if (node.param) {
+                    params[node.param.paramName] = part;
+                    node = node.param;
+                    start = i + 1;
+                    continue;
+                }
+                if (node.wildcard) {
+                    params["*"] = url.slice(start);
+                    node = node.wildcard;
+                    break;
+                }
+                if (rootWildcard?.handler) {
+                    return rootWildcard.handler(req, res, params);
+                }
+                res.statusCode = 404;
+                res.end("Not Found");
+                return;
+            }
+        }
+        if (!node.handler) {
+            if (rootWildcard?.handler) {
+                return rootWildcard.handler(req, res, params);
+            }
+            res.statusCode = 404;
+            return res.end("Not Found");
+        }
+        return node.handler(req, res, params);
+    }
+    _createNode() {
+        return { static: Object.create(null) };
+    }
+    _add(method, path, handler) {
+        let node = this.trees[method];
+        let start = 1;
+        for (let i = 1; i <= path.length; i++) {
+            if (path[i] === "/" || i === path.length) {
+                const part = path.slice(start, i);
+                if (!part) {
+                    start = i + 1;
+                    continue;
+                }
+                if (part[0] === ":") {
+                    if (!node.param) {
+                        node.param = this._createNode();
+                        node.param.paramName = part.slice(1);
+                    }
+                    node = node.param;
+                }
+                else if (part === "*") {
+                    if (!node.wildcard) {
+                        node.wildcard = this._createNode();
+                    }
+                    node = node.wildcard;
+                    break;
+                }
+                else {
+                    if (!node.static[part]) {
+                        node.static[part] = this._createNode();
+                    }
+                    node = node.static[part];
+                }
+                start = i + 1;
+            }
+        }
+        node.handler = handler;
+        this._routes.push({
+            path,
+            method,
+            params: this._extractParams(path)
+        });
+        return;
+    }
+    _extractParams(path) {
+        const params = [];
+        let start = 1;
+        for (let i = 1; i <= path.length; i++) {
+            if (path[i] === "/" || i === path.length) {
+                const part = path.slice(start, i);
+                if (part && part[0] === ":") {
+                    params.push(part.slice(1));
+                }
+                start = i + 1;
+            }
+        }
+        return params;
+    }
+}
+exports.FastRouter = FastRouter;
+//# sourceMappingURL=fast-router.js.map

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

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