@webpieces/http-server 0.2.15 → 0.2.17

package/src/WebpiecesServerImpl.d.ts

@@ -1,7 +1,7 @@
-import { Container } from 'inversify';
-import { WebAppMeta } from '@webpieces/core-meta';
-import { RouteBuilderImpl } from './RouteBuilderImpl';
+import { Container, ContainerModule } from 'inversify';
+import { ExpressRouteHandler, RouteBuilderImpl, WebAppMeta } from '@webpieces/http-routing';
 import { WebpiecesServer } from './WebpiecesServer';
+import { WebpiecesMiddleware } from './WebpiecesMiddleware';
 /**
  * WebpiecesServerImpl - Internal server implementation.
  *
@@ -28,6 +28,7 @@ import { WebpiecesServer } from './WebpiecesServer';
  */
 export declare class WebpiecesServerImpl implements WebpiecesServer {
     private routeBuilder;
+    private middleware;
     private meta;
     private webpiecesContainer;
     /**
@@ -40,7 +41,7 @@ export declare class WebpiecesServerImpl implements WebpiecesServer {
     private app?;
     private server?;
     private port;
-    constructor(routeBuilder: RouteBuilderImpl);
+    constructor(routeBuilder: RouteBuilderImpl, middleware: WebpiecesMiddleware);
     /**
      * Initialize the server (DI container, routes, filters).
      * This is called by WebpiecesFactory.create() after resolving this class from DI.
@@ -48,8 +49,17 @@ export declare class WebpiecesServerImpl implements WebpiecesServer {
      *
      * @param webpiecesContainer - The framework container
      * @param meta - User-provided WebAppMeta with DI modules and routes
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)
      */
-    initialize(webpiecesContainer: Container, meta: WebAppMeta): void;
+    /**
+     * Initialize the server asynchronously.
+     * Use this when overrides module contains async operations (e.g., rebind() in new Inversify).
+     *
+     * @param webpiecesContainer - The framework container
+     * @param meta - User-provided WebAppMeta with DI modules and routes
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)
+     */
+    initialize(webpiecesContainer: Container, meta: WebAppMeta, overrides?: ContainerModule): Promise<void>;
     /**
      * Load DI modules from WebAppMeta.
      *
@@ -59,6 +69,8 @@ export declare class WebpiecesServerImpl implements WebpiecesServer {
      * - Application modules -> appContainer
      *
      * For now, everything goes into appContainer which has access to webpiecesContainer.
+     *
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST to override bindings)
      */
     private loadDIModules;
     /**
@@ -71,19 +83,6 @@ export declare class WebpiecesServerImpl implements WebpiecesServer {
      * - Understanding: Clear class name vs anonymous object
      */
     private registerRoutes;
-    /**
-     * Global error handler middleware - catches ALL unhandled errors.
-     * Returns HTML 500 error page for any errors that escape the filter chain.
-     *
-     * This is the outermost safety net - JsonFilter catches JSON API errors,
-     * this catches everything else.
-     */
-    private globalErrorHandler;
-    /**
-     * Logging middleware - logs request/response flow.
-     * Demonstrates middleware execution order.
-     */
-    private logNextLayer;
     /**
      * Start the HTTP server with Express.
      * Returns a Promise that resolves when the server is listening,
@@ -92,22 +91,52 @@ export declare class WebpiecesServerImpl implements WebpiecesServer {
      * @param port - The port to listen on (default: 8080)
      * @returns Promise that resolves when server is ready
      */
-    start(port?: number): Promise<void>;
+    start(port?: number, testMode?: boolean): Promise<void>;
     /**
-     * Register all routes with Express.
+     * Register Express routes - the SINGLE loop over routes.
+     * For each route: createHandler (sets up filter chain) → wrapExpress → registerHandler.
+     *
+     * @returns Number of routes registered
      */
     private registerExpressRoutes;
+    registerHandler(httpMethod: string, path: string, expressHandler: ExpressRouteHandler): void;
     /**
-     * Setup a single route with Express.
-     * Finds matching filters, creates handler, and registers with Express.
+     * Stop the HTTP server.
+     * Returns a Promise that resolves when the server is stopped,
+     * or rejects if there's an error stopping the server.
      *
-     * @param key - Route key (method:path)
-     * @param routeWithMeta - The route handler paired with its definition
-     * @param filtersWithMeta - All filters with their definitions
+     * @returns Promise that resolves when server is stopped
      */
-    private setupRoute;
+    stop(): Promise<void>;
     /**
-     * Stop the HTTP server.
+     * Get the application DI container.
+     *
+     * Useful for testing to verify state or access services directly.
+     *
+     * @returns The application Container
+     */
+    getContainer(): Container;
+    /**
+     * Create an API client proxy for testing.
+     *
+     * This creates a client that routes calls through the full filter chain
+     * and controller, but WITHOUT any HTTP overhead. Perfect for testing!
+     *
+     * The client uses the ApiPrototype class to discover routes via decorators,
+     * then creates pre-configured invoker functions for each API method.
+     *
+     * IMPORTANT: This loops over the API methods (from decorators), NOT all routes.
+     * For each API method, it sets up the filter chain ONCE during proxy creation,
+     * so subsequent calls reuse the same filter chain (efficient!).
+     *
+     * @param apiPrototype - The API prototype class with routing decorators (can be abstract)
+     * @returns A proxy that implements the API interface
+     *
+     * Example:
+     * ```typescript
+     * const saveApi = server.createApiClient<SaveApi>(SaveApiPrototype);
+     * const response = await saveApi.save(request);
+     * ```
      */
-    stop(): void;
+    createApiClient<T>(apiPrototype: abstract new (...args: any[]) => T): T;
 }

package/src/WebpiecesServerImpl.js

@@ -5,13 +5,8 @@ const tslib_1 = require("tslib");
 const express_1 = tslib_1.__importDefault(require("express"));
 const inversify_1 = require("inversify");
 const binding_decorators_1 = require("@inversifyjs/binding-decorators");
-const core_meta_1 = require("@webpieces/core-meta");
-const http_filters_1 = require("@webpieces/http-filters");
 const http_routing_1 = require("@webpieces/http-routing");
-const RouteBuilderImpl_1 = require("./RouteBuilderImpl");
-const FilterMatcher_1 = require("./FilterMatcher");
-const core_util_1 = require("@webpieces/core-util");
-const MethodMeta_1 = require("./MethodMeta");
+const WebpiecesMiddleware_1 = require("./WebpiecesMiddleware");
 /**
  * WebpiecesServerImpl - Internal server implementation.
  *
@@ -37,10 +32,11 @@ const MethodMeta_1 = require("./MethodMeta");
  * and resolved by WebpiecesFactory. It receives RouteBuilder via constructor injection.
  */
 let WebpiecesServerImpl = class WebpiecesServerImpl {
-    constructor(routeBuilder) {
+    constructor(routeBuilder, middleware) {
         this.routeBuilder = routeBuilder;
+        this.middleware = middleware;
         this.initialized = false;
-        this.port = 8080;
+        this.port = 8200;
     }
     /**
      * Initialize the server (DI container, routes, filters).
@@ -49,8 +45,17 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
      *
      * @param webpiecesContainer - The framework container
      * @param meta - User-provided WebAppMeta with DI modules and routes
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)
      */
-    initialize(webpiecesContainer, meta) {
+    /**
+     * Initialize the server asynchronously.
+     * Use this when overrides module contains async operations (e.g., rebind() in new Inversify).
+     *
+     * @param webpiecesContainer - The framework container
+     * @param meta - User-provided WebAppMeta with DI modules and routes
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)
+     */
+    async initialize(webpiecesContainer, meta, overrides) {
         if (this.initialized) {
             return;
         }
@@ -60,8 +65,8 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
         this.appContainer = new inversify_1.Container({ parent: this.webpiecesContainer });
         // Set container on RouteBuilder (late binding - appContainer didn't exist in constructor)
         this.routeBuilder.setContainer(this.appContainer);
-        // 1. Load DI modules
-        this.loadDIModules();
+        // 1. Load DI modules asynchronously
+        await this.loadDIModules(overrides);
         // 2. Register routes and filters
         this.registerRoutes();
         this.initialized = true;
@@ -75,15 +80,21 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
      * - Application modules -> appContainer
      *
      * For now, everything goes into appContainer which has access to webpiecesContainer.
+     *
+     * @param overrides - Optional ContainerModule for test overrides (loaded LAST to override bindings)
      */
-    loadDIModules() {
+    async loadDIModules(overrides) {
         const modules = this.meta.getDIModules();
         // Load buildProviderModule to auto-scan for @provideSingleton decorators
-        this.appContainer.load((0, binding_decorators_1.buildProviderModule)());
+        await this.appContainer.load((0, binding_decorators_1.buildProviderModule)());
         // Load all modules into application container
         // (webpiecesContainer is currently empty, reserved for future framework bindings)
         for (const module of modules) {
-            this.appContainer.load(module);
+            await this.appContainer.load(module);
+        }
+        // Load overrides LAST so they can override existing bindings
+        if (overrides) {
+            await this.appContainer.load(overrides);
         }
     }
     /**
@@ -102,51 +113,6 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
             routeConfig.configure(this.routeBuilder);
         }
     }
-    /**
-     * Global error handler middleware - catches ALL unhandled errors.
-     * Returns HTML 500 error page for any errors that escape the filter chain.
-     *
-     * This is the outermost safety net - JsonFilter catches JSON API errors,
-     * this catches everything else.
-     */
-    async globalErrorHandler(req, res, next) {
-        console.log('🔴 [Layer 1: GlobalErrorHandler] Request START:', req.method, req.path);
-        try {
-            // await next() catches BOTH:
-            // 1. Synchronous throws from next() itself
-            // 2. Rejected promises from downstream async middleware
-            await next();
-            console.log('🔴 [Layer 1: GlobalErrorHandler] Request END (success):', req.method, req.path);
-        }
-        catch (err) {
-            const error = (0, core_util_1.toError)(err);
-            console.error('🔴 [Layer 1: GlobalErrorHandler] Caught unhandled error:', error);
-            if (!res.headersSent) {
-                // Return HTML error page (not JSON - JsonFilter handles JSON errors)
-                res.status(500).send(`
-          <!DOCTYPE html>
-          <html>
-          <head><title>Server Error</title></head>
-          <body>
-            <h1>You hit a server error</h1>
-            <p>An unexpected error occurred while processing your request.</p>
-            <pre>${error.message}</pre>
-          </body>
-          </html>
-        `);
-            }
-            console.log('🔴 [Layer 1: GlobalErrorHandler] Request END (error):', req.method, req.path);
-        }
-    }
-    /**
-     * Logging middleware - logs request/response flow.
-     * Demonstrates middleware execution order.
-     */
-    logNextLayer(req, res, next) {
-        console.log('🟡 [Layer 2: LogNextLayer] Before next() -', req.method, req.path);
-        next();
-        console.log('🟡 [Layer 2: LogNextLayer] After next() -', req.method, req.path);
-    }
     /**
      * Start the HTTP server with Express.
      * Returns a Promise that resolves when the server is listening,
@@ -155,25 +121,27 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
      * @param port - The port to listen on (default: 8080)
      * @returns Promise that resolves when server is ready
      */
-    start(port = 8080) {
+    async start(port = 8200, testMode) {
         if (!this.initialized) {
-            return Promise.reject(new Error('Server not initialized. Call initialize() before start().'));
+            throw new Error('Server not initialized. Call initialize() before start().');
         }
         this.port = port;
+        if (testMode) {
+            //In testMode, we eliminate express ENTIRELY and use
+            //Router, method filters and controllers so that we can test full stack
+            return;
+        }
         // Create Express app
         this.app = (0, express_1.default)();
-        // Parse JSON request bodies
-        this.app.use(express_1.default.json());
         // Layer 1: Global Error Handler (OUTERMOST - runs FIRST)
         // Catches all unhandled errors and returns HTML 500 page
-        this.app.use(this.globalErrorHandler.bind(this));
+        this.app.use(this.middleware.globalErrorHandler.bind(this.middleware));
         // Layer 2: Request/Response Logging
-        this.app.use(this.logNextLayer.bind(this));
-        // Register routes (these become the innermost handlers)
-        this.registerExpressRoutes();
-        const routes = this.routeBuilder.getRoutes();
+        this.app.use(this.middleware.logNextLayer.bind(this.middleware));
+        // Register routes
+        const routeCount = this.registerExpressRoutes();
         // Start listening - wrap in Promise
-        return new Promise((resolve, reject) => {
+        const promise = new Promise((resolve, reject) => {
             this.server = this.app.listen(this.port, (error) => {
                 if (error) {
                     console.error(`[WebpiecesServer] Failed to start server:`, error);
@@ -181,112 +149,145 @@ let WebpiecesServerImpl = class WebpiecesServerImpl {
                     return;
                 }
                 console.log(`[WebpiecesServer] Server listening on http://localhost:${this.port}`);
-                console.log(`[WebpiecesServer] Registered ${routes.size} routes`);
+                console.log(`[WebpiecesServer] Registered ${routeCount} routes`);
                 resolve();
             });
         });
+        await promise;
     }
     /**
-     * Register all routes with Express.
+     * Register Express routes - the SINGLE loop over routes.
+     * For each route: createHandler (sets up filter chain) → wrapExpress → registerHandler.
+     *
+     * @returns Number of routes registered
      */
     registerExpressRoutes() {
         if (!this.app) {
             throw new Error('Express app not initialized');
         }
         const routes = this.routeBuilder.getRoutes();
-        const sortedFilters = this.routeBuilder.getSortedFilters();
-        for (const [key, routeWithMeta] of routes.entries()) {
-            this.setupRoute(key, routeWithMeta, sortedFilters);
+        let count = 0;
+        for (const routeWithMeta of routes) {
+            const service = this.routeBuilder.createRouteHandler(routeWithMeta);
+            const routeMeta = routeWithMeta.definition.routeMeta;
+            // Create ExpressWrapper directly (handles full request/response cycle)
+            const wrapper = this.middleware.createExpressWrapper(service, routeMeta);
+            this.registerHandler(routeMeta.httpMethod, routeMeta.path, wrapper.execute.bind(wrapper));
+            count++;
         }
+        return count;
     }
-    /**
-     * Setup a single route with Express.
-     * Finds matching filters, creates handler, and registers with Express.
-     *
-     * @param key - Route key (method:path)
-     * @param routeWithMeta - The route handler paired with its definition
-     * @param filtersWithMeta - All filters with their definitions
-     */
-    setupRoute(key, routeWithMeta, filtersWithMeta) {
+    registerHandler(httpMethod, path, expressHandler) {
         if (!this.app) {
             throw new Error('Express app not initialized');
         }
-        const route = routeWithMeta.definition;
-        const routeMeta = route.routeMeta;
-        const method = routeMeta.httpMethod.toLowerCase();
-        const path = routeMeta.path;
-        console.log(`[WebpiecesServer] Registering route: ${method.toUpperCase()} ${path}`);
-        // Find matching filters for this route - FilterMatcher returns Filter[] not FilterWithMeta[]
-        // So we need to convert our FilterWithMeta[] to what FilterMatcher expects
-        const filterDefinitions = filtersWithMeta.map((fwm) => {
-            // Set the filter instance on the definition for FilterMatcher
-            const def = fwm.definition;
-            def.filter = fwm.filter;
-            return def;
-        });
-        const matchingFilters = FilterMatcher_1.FilterMatcher.findMatchingFilters(route.controllerFilepath, filterDefinitions);
-        // Create service that wraps the controller execution
-        const controllerService = {
-            invoke: async (meta) => {
-                // Invoke the controller method via route handler
-                const result = await routeWithMeta.handler.execute(meta);
-                const responseWrapper = new http_filters_1.WpResponse(result);
-                return responseWrapper;
-            },
-        };
-        // Chain filters with the controller service (reverse order for correct execution)
-        // IMPORTANT: MUST USE Filter.chain(filter) and Filter.chainService(svc);
-        let filterChain = matchingFilters[matchingFilters.length - 1];
-        for (let i = matchingFilters.length - 2; i >= 0; i--) {
-            filterChain = filterChain.chain(matchingFilters[i]);
-        }
-        const svc = filterChain.chainService(controllerService);
-        // Create Express route handler - delegates to filter chain
-        const handler = async (req, res, next) => {
-            // Create RouteRequest with Express Request/Response
-            const routeRequest = new core_meta_1.RouteRequest(req, res);
-            // Create MethodMeta with route info and Express Request/Response
-            const meta = new MethodMeta_1.MethodMeta(routeMeta, routeRequest);
-            // Response is written by JsonFilter - we just await completion
-            await svc.invoke(meta);
-        };
-        // Register with Express
-        switch (method) {
+        switch (httpMethod.toLowerCase()) {
             case 'get':
-                this.app.get(path, handler);
+                this.app.get(path, expressHandler);
                 break;
             case 'post':
-                this.app.post(path, handler);
+                this.app.post(path, expressHandler);
                 break;
             case 'put':
-                this.app.put(path, handler);
+                this.app.put(path, expressHandler);
                 break;
             case 'delete':
-                this.app.delete(path, handler);
+                this.app.delete(path, expressHandler);
                 break;
             case 'patch':
-                this.app.patch(path, handler);
+                this.app.patch(path, expressHandler);
                 break;
             default:
-                console.warn(`[WebpiecesServer] Unknown HTTP method: ${method}`);
+                console.warn(`[WebpiecesServer] Unknown HTTP method: ${httpMethod}`);
         }
     }
     /**
      * Stop the HTTP server.
+     * Returns a Promise that resolves when the server is stopped,
+     * or rejects if there's an error stopping the server.
+     *
+     * @returns Promise that resolves when server is stopped
      */
-    stop() {
-        if (this.server) {
-            this.server.close(() => {
+    async stop() {
+        if (!this.server) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            this.server.close((err) => {
+                if (err) {
+                    console.error('[WebpiecesServer] Error stopping server:', err);
+                    reject(err);
+                    return;
+                }
                 console.log('[WebpiecesServer] Server stopped');
+                resolve();
             });
+        });
+    }
+    /**
+     * Get the application DI container.
+     *
+     * Useful for testing to verify state or access services directly.
+     *
+     * @returns The application Container
+     */
+    getContainer() {
+        return this.appContainer;
+    }
+    /**
+     * Create an API client proxy for testing.
+     *
+     * This creates a client that routes calls through the full filter chain
+     * and controller, but WITHOUT any HTTP overhead. Perfect for testing!
+     *
+     * The client uses the ApiPrototype class to discover routes via decorators,
+     * then creates pre-configured invoker functions for each API method.
+     *
+     * IMPORTANT: This loops over the API methods (from decorators), NOT all routes.
+     * For each API method, it sets up the filter chain ONCE during proxy creation,
+     * so subsequent calls reuse the same filter chain (efficient!).
+     *
+     * @param apiPrototype - The API prototype class with routing decorators (can be abstract)
+     * @returns A proxy that implements the API interface
+     *
+     * Example:
+     * ```typescript
+     * const saveApi = server.createApiClient<SaveApi>(SaveApiPrototype);
+     * const response = await saveApi.save(request);
+     * ```
+     */
+    createApiClient(apiPrototype) {
+        if (!this.initialized) {
+            throw new Error('Server not initialized. Call initialize() before createApiClient().');
+        }
+        // Get routes from the API prototype using decorators (loops over API methods, NOT all routes)
+        const apiMethods = (0, http_routing_1.getRoutes)(apiPrototype);
+        // Create proxy object
+        const proxy = {};
+        // Loop over API methods and create proxy functions
+        for (const routeMeta of apiMethods) {
+            const methodName = routeMeta.methodName;
+            const httpMethod = routeMeta.httpMethod.toUpperCase();
+            const path = routeMeta.path;
+            // Create invoker service ONCE (sets up filter chain once, not on every call!)
+            const service = this.routeBuilder.createRouteInvoker(httpMethod, path);
+            // Proxy method creates MethodMeta and calls the pre-configured service
+            proxy[methodName] = async (requestDto) => {
+                const meta = new http_routing_1.MethodMeta(routeMeta, requestDto);
+                const responseWrapper = await service.invoke(meta);
+                return responseWrapper.response;
+            };
         }
+        return proxy;
     }
 };
 exports.WebpiecesServerImpl = WebpiecesServerImpl;
 exports.WebpiecesServerImpl = WebpiecesServerImpl = tslib_1.__decorate([
     (0, http_routing_1.provideSingleton)(),
     (0, inversify_1.injectable)(),
-    tslib_1.__param(0, (0, inversify_1.inject)(RouteBuilderImpl_1.RouteBuilderImpl)),
-    tslib_1.__metadata("design:paramtypes", [RouteBuilderImpl_1.RouteBuilderImpl])
+    tslib_1.__param(0, (0, inversify_1.inject)(http_routing_1.RouteBuilderImpl)),
+    tslib_1.__param(1, (0, inversify_1.inject)(WebpiecesMiddleware_1.WebpiecesMiddleware)),
+    tslib_1.__metadata("design:paramtypes", [http_routing_1.RouteBuilderImpl,
+        WebpiecesMiddleware_1.WebpiecesMiddleware])
 ], WebpiecesServerImpl);
 //# sourceMappingURL=WebpiecesServerImpl.js.map

package/src/WebpiecesServerImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebpiecesServerImpl.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/WebpiecesServerImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import express, { Express, NextFunction, Request, Response } from 'express';\nimport { Container, inject, injectable } from 'inversify';\nimport { buildProviderModule } from '@inversifyjs/binding-decorators';\nimport { RouteRequest, WebAppMeta } from '@webpieces/core-meta';\nimport { WpResponse, Service } from '@webpieces/http-filters';\nimport { provideSingleton } from '@webpieces/http-routing';\nimport { RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta } from './RouteBuilderImpl';\nimport { FilterMatcher } from './FilterMatcher';\nimport { toError } from '@webpieces/core-util';\nimport { MethodMeta } from './MethodMeta';\nimport { WebpiecesServer } from './WebpiecesServer';\n\n/**\n * WebpiecesServerImpl - Internal server implementation.\n *\n * This class implements the WebpiecesServer interface and contains\n * all the actual server logic. It is created by WebpiecesFactory.create().\n *\n * This class uses a two-container pattern similar to Java WebPieces:\n * 1. webpiecesContainer: Core WebPieces framework bindings\n * 2. appContainer: User's application bindings (child of webpiecesContainer)\n *\n * This separation allows:\n * - Clean separation of concerns\n * - Better testability\n * - Ability to override framework bindings in tests\n *\n * The server:\n * 1. Initializes both DI containers from WebAppMeta.getDIModules()\n * 2. Registers routes using explicit RouteBuilderImpl\n * 3. Creates filter chains\n * 4. Supports both HTTP server mode and testing mode (no HTTP)\n *\n * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()\n * and resolved by WebpiecesFactory. It receives RouteBuilder via constructor injection.\n */\n@provideSingleton()\n@injectable()\nexport class WebpiecesServerImpl implements WebpiecesServer {\n    private meta!: WebAppMeta;\n    private webpiecesContainer!: Container;\n\n    /**\n     * Application container: User's application bindings.\n     * This is a child container of webpiecesContainer, so it can access\n     * framework bindings while keeping app bindings separate.\n     */\n    private appContainer!: Container;\n\n    private initialized = false;\n    private app?: Express;\n    private server?: ReturnType<Express['listen']>;\n    private port: number = 8080;\n\n    constructor(@inject(RouteBuilderImpl) private routeBuilder: RouteBuilderImpl) {}\n\n    /**\n     * Initialize the server (DI container, routes, filters).\n     * This is called by WebpiecesFactory.create() after resolving this class from DI.\n     * This method is internal and not exposed on the WebpiecesServer interface.\n     *\n     * @param webpiecesContainer - The framework container\n     * @param meta - User-provided WebAppMeta with DI modules and routes\n     */\n    initialize(webpiecesContainer: Container, meta: WebAppMeta): void {\n        if (this.initialized) {\n            return;\n        }\n\n        this.webpiecesContainer = webpiecesContainer;\n        this.meta = meta;\n\n        // Create application container as child of framework container\n        this.appContainer = new Container({ parent: this.webpiecesContainer });\n\n        // Set container on RouteBuilder (late binding - appContainer didn't exist in constructor)\n        this.routeBuilder.setContainer(this.appContainer);\n\n        // 1. Load DI modules\n        this.loadDIModules();\n\n        // 2. Register routes and filters\n        this.registerRoutes();\n\n        this.initialized = true;\n    }\n\n    /**\n     * Load DI modules from WebAppMeta.\n     *\n     * Currently, all user modules are loaded into the application container.\n     * In the future, we could separate:\n     * - WebPieces framework modules -> webpiecesContainer\n     * - Application modules -> appContainer\n     *\n     * For now, everything goes into appContainer which has access to webpiecesContainer.\n     */\n    private loadDIModules(): void {\n        const modules = this.meta.getDIModules();\n\n        // Load buildProviderModule to auto-scan for @provideSingleton decorators\n        this.appContainer.load(buildProviderModule());\n\n        // Load all modules into application container\n        // (webpiecesContainer is currently empty, reserved for future framework bindings)\n        for (const module of modules) {\n            this.appContainer.load(module);\n        }\n    }\n\n    /**\n     * Register routes from WebAppMeta.\n     *\n     * Creates an explicit RouteBuilderImpl instead of an anonymous object.\n     * This improves:\n     * - Traceability: Can Cmd+Click on addRoute to see implementation\n     * - Debugging: Explicit class shows up in stack traces\n     * - Understanding: Clear class name vs anonymous object\n     */\n    private registerRoutes(): void {\n        const routeConfigs = this.meta.getRoutes();\n\n        // Configure routes using the explicit RouteBuilder\n        for (const routeConfig of routeConfigs) {\n            routeConfig.configure(this.routeBuilder);\n        }\n    }\n\n    /**\n     * Global error handler middleware - catches ALL unhandled errors.\n     * Returns HTML 500 error page for any errors that escape the filter chain.\n     *\n     * This is the outermost safety net - JsonFilter catches JSON API errors,\n     * this catches everything else.\n     */\n    private async globalErrorHandler(\n        req: Request,\n        res: Response,\n        next: NextFunction,\n    ): Promise<void> {\n        console.log('🔴 [Layer 1: GlobalErrorHandler] Request START:', req.method, req.path);\n\n        try {\n            // await next() catches BOTH:\n            // 1. Synchronous throws from next() itself\n            // 2. Rejected promises from downstream async middleware\n            await next();\n            console.log(\n                '🔴 [Layer 1: GlobalErrorHandler] Request END (success):',\n                req.method,\n                req.path,\n            );\n        } catch (err: unknown) {\n            const error = toError(err);\n            console.error('🔴 [Layer 1: GlobalErrorHandler] Caught unhandled error:', error);\n            if (!res.headersSent) {\n                // Return HTML error page (not JSON - JsonFilter handles JSON errors)\n                res.status(500).send(`\n          <!DOCTYPE html>\n          <html>\n          <head><title>Server Error</title></head>\n          <body>\n            <h1>You hit a server error</h1>\n            <p>An unexpected error occurred while processing your request.</p>\n            <pre>${error.message}</pre>\n          </body>\n          </html>\n        `);\n            }\n            console.log(\n                '🔴 [Layer 1: GlobalErrorHandler] Request END (error):',\n                req.method,\n                req.path,\n            );\n        }\n    }\n\n    /**\n     * Logging middleware - logs request/response flow.\n     * Demonstrates middleware execution order.\n     */\n    private logNextLayer(req: Request, res: Response, next: NextFunction): void {\n        console.log('🟡 [Layer 2: LogNextLayer] Before next() -', req.method, req.path);\n        next();\n        console.log('🟡 [Layer 2: LogNextLayer] After next() -', req.method, req.path);\n    }\n\n    /**\n     * Start the HTTP server with Express.\n     * Returns a Promise that resolves when the server is listening,\n     * or rejects if the server fails to start.\n     *\n     * @param port - The port to listen on (default: 8080)\n     * @returns Promise that resolves when server is ready\n     */\n    start(port: number = 8080): Promise<void> {\n        if (!this.initialized) {\n            return Promise.reject(\n                new Error('Server not initialized. Call initialize() before start().'),\n            );\n        }\n\n        this.port = port;\n\n        // Create Express app\n        this.app = express();\n\n        // Parse JSON request bodies\n        this.app.use(express.json());\n\n        // Layer 1: Global Error Handler (OUTERMOST - runs FIRST)\n        // Catches all unhandled errors and returns HTML 500 page\n        this.app.use(this.globalErrorHandler.bind(this));\n\n        // Layer 2: Request/Response Logging\n        this.app.use(this.logNextLayer.bind(this));\n\n        // Register routes (these become the innermost handlers)\n        this.registerExpressRoutes();\n\n        const routes = this.routeBuilder.getRoutes();\n\n        // Start listening - wrap in Promise\n        return new Promise((resolve, reject) => {\n            this.server = this.app!.listen(this.port, (error?: Error) => {\n                if (error) {\n                    console.error(`[WebpiecesServer] Failed to start server:`, error);\n                    reject(error);\n                    return;\n                }\n                console.log(`[WebpiecesServer] Server listening on http://localhost:${this.port}`);\n                console.log(`[WebpiecesServer] Registered ${routes.size} routes`);\n                resolve();\n            });\n        });\n    }\n\n    /**\n     * Register all routes with Express.\n     */\n    private registerExpressRoutes(): void {\n        if (!this.app) {\n            throw new Error('Express app not initialized');\n        }\n\n        const routes = this.routeBuilder.getRoutes();\n        const sortedFilters = this.routeBuilder.getSortedFilters();\n        for (const [key, routeWithMeta] of routes.entries()) {\n            this.setupRoute(key, routeWithMeta, sortedFilters);\n        }\n    }\n\n    /**\n     * Setup a single route with Express.\n     * Finds matching filters, creates handler, and registers with Express.\n     *\n     * @param key - Route key (method:path)\n     * @param routeWithMeta - The route handler paired with its definition\n     * @param filtersWithMeta - All filters with their definitions\n     */\n    private setupRoute(\n        key: string,\n        routeWithMeta: RouteHandlerWithMeta,\n        filtersWithMeta: Array<FilterWithMeta>,\n    ): void {\n        if (!this.app) {\n            throw new Error('Express app not initialized');\n        }\n\n        const route = routeWithMeta.definition;\n        const routeMeta = route.routeMeta;\n        const method = routeMeta.httpMethod.toLowerCase();\n        const path = routeMeta.path;\n\n        console.log(`[WebpiecesServer] Registering route: ${method.toUpperCase()} ${path}`);\n\n        // Find matching filters for this route - FilterMatcher returns Filter[] not FilterWithMeta[]\n        // So we need to convert our FilterWithMeta[] to what FilterMatcher expects\n        const filterDefinitions = filtersWithMeta.map((fwm) => {\n            // Set the filter instance on the definition for FilterMatcher\n            const def = fwm.definition;\n            def.filter = fwm.filter;\n            return def;\n        });\n\n        const matchingFilters = FilterMatcher.findMatchingFilters(\n            route.controllerFilepath,\n            filterDefinitions,\n        );\n\n        // Create service that wraps the controller execution\n        const controllerService: Service<MethodMeta, WpResponse> = {\n            invoke: async (meta: MethodMeta): Promise<WpResponse> => {\n                // Invoke the controller method via route handler\n                const result = await routeWithMeta.handler.execute(meta);\n                const responseWrapper = new WpResponse(result);\n                return responseWrapper;\n            },\n        };\n\n        // Chain filters with the controller service (reverse order for correct execution)\n        // IMPORTANT: MUST USE Filter.chain(filter) and Filter.chainService(svc);\n        let filterChain = matchingFilters[matchingFilters.length - 1];\n        for (let i = matchingFilters.length - 2; i >= 0; i--) {\n            filterChain = filterChain.chain(matchingFilters[i]);\n        }\n        const svc = filterChain.chainService(controllerService);\n\n        // Create Express route handler - delegates to filter chain\n        const handler = async (req: Request, res: Response, next: NextFunction) => {\n            // Create RouteRequest with Express Request/Response\n            const routeRequest = new RouteRequest(req, res);\n\n            // Create MethodMeta with route info and Express Request/Response\n            const meta = new MethodMeta(routeMeta, routeRequest);\n\n            // Response is written by JsonFilter - we just await completion\n            await svc.invoke(meta);\n        };\n\n        // Register with Express\n        switch (method) {\n            case 'get':\n                this.app.get(path, handler);\n                break;\n            case 'post':\n                this.app.post(path, handler);\n                break;\n            case 'put':\n                this.app.put(path, handler);\n                break;\n            case 'delete':\n                this.app.delete(path, handler);\n                break;\n            case 'patch':\n                this.app.patch(path, handler);\n                break;\n            default:\n                console.warn(`[WebpiecesServer] Unknown HTTP method: ${method}`);\n        }\n    }\n\n    /**\n     * Stop the HTTP server.\n     */\n    stop(): void {\n        if (this.server) {\n            this.server.close(() => {\n                console.log('[WebpiecesServer] Server stopped');\n            });\n        }\n    }\n}\n"]}
+{"version":3,"file":"WebpiecesServerImpl.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/WebpiecesServerImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import express, {Express, NextFunction, Request, Response} from 'express';\nimport {Container, ContainerModule, inject, injectable} from 'inversify';\nimport {buildProviderModule} from '@inversifyjs/binding-decorators';\nimport {\n    ExpressRouteHandler,\n    getRoutes,\n    MethodMeta,\n    provideSingleton,\n    RouteBuilderImpl,\n    WebAppMeta,\n} from '@webpieces/http-routing';\nimport {WebpiecesServer} from './WebpiecesServer';\nimport {WebpiecesMiddleware} from './WebpiecesMiddleware';\n\n/**\n * WebpiecesServerImpl - Internal server implementation.\n *\n * This class implements the WebpiecesServer interface and contains\n * all the actual server logic. It is created by WebpiecesFactory.create().\n *\n * This class uses a two-container pattern similar to Java WebPieces:\n * 1. webpiecesContainer: Core WebPieces framework bindings\n * 2. appContainer: User's application bindings (child of webpiecesContainer)\n *\n * This separation allows:\n * - Clean separation of concerns\n * - Better testability\n * - Ability to override framework bindings in tests\n *\n * The server:\n * 1. Initializes both DI containers from WebAppMeta.getDIModules()\n * 2. Registers routes using explicit RouteBuilderImpl\n * 3. Creates filter chains\n * 4. Supports both HTTP server mode and testing mode (no HTTP)\n *\n * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()\n * and resolved by WebpiecesFactory. It receives RouteBuilder via constructor injection.\n */\n@provideSingleton()\n@injectable()\nexport class WebpiecesServerImpl implements WebpiecesServer {\n    private meta!: WebAppMeta;\n    private webpiecesContainer!: Container;\n\n    /**\n     * Application container: User's application bindings.\n     * This is a child container of webpiecesContainer, so it can access\n     * framework bindings while keeping app bindings separate.\n     */\n    private appContainer!: Container;\n\n    private initialized = false;\n    private app?: Express;\n    private server?: ReturnType<Express['listen']>;\n    private port: number = 8200;\n\n    constructor(\n        @inject(RouteBuilderImpl) private routeBuilder: RouteBuilderImpl,\n        @inject(WebpiecesMiddleware) private middleware: WebpiecesMiddleware,\n    ) {}\n\n    /**\n     * Initialize the server (DI container, routes, filters).\n     * This is called by WebpiecesFactory.create() after resolving this class from DI.\n     * This method is internal and not exposed on the WebpiecesServer interface.\n     *\n     * @param webpiecesContainer - The framework container\n     * @param meta - User-provided WebAppMeta with DI modules and routes\n     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)\n     */\n    /**\n     * Initialize the server asynchronously.\n     * Use this when overrides module contains async operations (e.g., rebind() in new Inversify).\n     *\n     * @param webpiecesContainer - The framework container\n     * @param meta - User-provided WebAppMeta with DI modules and routes\n     * @param overrides - Optional ContainerModule for test overrides (loaded LAST)\n     */\n    async initialize(\n        webpiecesContainer: Container,\n        meta: WebAppMeta,\n        overrides?: ContainerModule\n    ): Promise<void> {\n        if (this.initialized) {\n            return;\n        }\n\n        this.webpiecesContainer = webpiecesContainer;\n        this.meta = meta;\n\n        // Create application container as child of framework container\n        this.appContainer = new Container({ parent: this.webpiecesContainer });\n\n        // Set container on RouteBuilder (late binding - appContainer didn't exist in constructor)\n        this.routeBuilder.setContainer(this.appContainer);\n\n        // 1. Load DI modules asynchronously\n        await this.loadDIModules(overrides);\n\n        // 2. Register routes and filters\n        this.registerRoutes();\n\n        this.initialized = true;\n    }\n\n    /**\n     * Load DI modules from WebAppMeta.\n     *\n     * Currently, all user modules are loaded into the application container.\n     * In the future, we could separate:\n     * - WebPieces framework modules -> webpiecesContainer\n     * - Application modules -> appContainer\n     *\n     * For now, everything goes into appContainer which has access to webpiecesContainer.\n     *\n     * @param overrides - Optional ContainerModule for test overrides (loaded LAST to override bindings)\n     */\n    private async loadDIModules(overrides?: ContainerModule): Promise<void> {\n        const modules = this.meta.getDIModules();\n\n        // Load buildProviderModule to auto-scan for @provideSingleton decorators\n        await this.appContainer.load(buildProviderModule());\n\n        // Load all modules into application container\n        // (webpiecesContainer is currently empty, reserved for future framework bindings)\n        for (const module of modules) {\n            await this.appContainer.load(module);\n        }\n\n        // Load overrides LAST so they can override existing bindings\n        if (overrides) {\n            await this.appContainer.load(overrides);\n        }\n    }\n\n    /**\n     * Register routes from WebAppMeta.\n     *\n     * Creates an explicit RouteBuilderImpl instead of an anonymous object.\n     * This improves:\n     * - Traceability: Can Cmd+Click on addRoute to see implementation\n     * - Debugging: Explicit class shows up in stack traces\n     * - Understanding: Clear class name vs anonymous object\n     */\n    private registerRoutes(): void {\n        const routeConfigs = this.meta.getRoutes();\n\n        // Configure routes using the explicit RouteBuilder\n        for (const routeConfig of routeConfigs) {\n            routeConfig.configure(this.routeBuilder);\n        }\n    }\n\n    /**\n     * Start the HTTP server with Express.\n     * Returns a Promise that resolves when the server is listening,\n     * or rejects if the server fails to start.\n     *\n     * @param port - The port to listen on (default: 8080)\n     * @returns Promise that resolves when server is ready\n     */\n    async start(port: number = 8200, testMode?: boolean): Promise<void> {\n        if (!this.initialized) {\n            throw new Error('Server not initialized. Call initialize() before start().');\n        }\n\n        this.port = port;\n\n        if(testMode) {\n            //In testMode, we eliminate express ENTIRELY and use\n            //Router, method filters and controllers so that we can test full stack\n            return;\n        }\n\n        // Create Express app\n        this.app = express();\n\n        // Layer 1: Global Error Handler (OUTERMOST - runs FIRST)\n        // Catches all unhandled errors and returns HTML 500 page\n        this.app.use(this.middleware.globalErrorHandler.bind(this.middleware));\n\n        // Layer 2: Request/Response Logging\n        this.app.use(this.middleware.logNextLayer.bind(this.middleware));\n\n        // Register routes\n        const routeCount = this.registerExpressRoutes();\n\n        // Start listening - wrap in Promise\n        const promise = new Promise<void>((resolve, reject) => {\n            this.server = this.app!.listen(this.port, (error?: Error) => {\n                if (error) {\n                    console.error(`[WebpiecesServer] Failed to start server:`, error);\n                    reject(error);\n                    return;\n                }\n                console.log(`[WebpiecesServer] Server listening on http://localhost:${this.port}`);\n                console.log(`[WebpiecesServer] Registered ${routeCount} routes`);\n                resolve();\n            });\n        });\n\n        await promise;\n    }\n\n    /**\n     * Register Express routes - the SINGLE loop over routes.\n     * For each route: createHandler (sets up filter chain) → wrapExpress → registerHandler.\n     *\n     * @returns Number of routes registered\n     */\n    private registerExpressRoutes(): number {\n        if (!this.app) {\n            throw new Error('Express app not initialized');\n        }\n\n        const routes = this.routeBuilder.getRoutes();\n        let count = 0;\n\n        for (const routeWithMeta of routes) {\n            const service = this.routeBuilder.createRouteHandler(routeWithMeta);\n            const routeMeta = routeWithMeta.definition.routeMeta;\n\n            // Create ExpressWrapper directly (handles full request/response cycle)\n            const wrapper = this.middleware.createExpressWrapper(service, routeMeta);\n\n            this.registerHandler(\n                routeMeta.httpMethod,\n                routeMeta.path,\n                wrapper.execute.bind(wrapper),\n            );\n            count++;\n        }\n\n        return count;\n    }\n\n    registerHandler(httpMethod: string, path: string, expressHandler: ExpressRouteHandler) {\n        if (!this.app) {\n            throw new Error('Express app not initialized');\n        }\n\n        switch (httpMethod.toLowerCase()) {\n            case 'get':\n                this.app.get(path, expressHandler);\n                break;\n            case 'post':\n                this.app.post(path, expressHandler);\n                break;\n            case 'put':\n                this.app.put(path, expressHandler);\n                break;\n            case 'delete':\n                this.app.delete(path, expressHandler);\n                break;\n            case 'patch':\n                this.app.patch(path, expressHandler);\n                break;\n            default:\n                console.warn(`[WebpiecesServer] Unknown HTTP method: ${httpMethod}`);\n        }\n    }\n\n    /**\n     * Stop the HTTP server.\n     * Returns a Promise that resolves when the server is stopped,\n     * or rejects if there's an error stopping the server.\n     *\n     * @returns Promise that resolves when server is stopped\n     */\n    async stop(): Promise<void> {\n        if (!this.server) {\n            return;\n        }\n\n        return new Promise<void>((resolve, reject) => {\n            this.server!.close((err?: Error) => {\n                if (err) {\n                    console.error('[WebpiecesServer] Error stopping server:', err);\n                    reject(err);\n                    return;\n                }\n                console.log('[WebpiecesServer] Server stopped');\n                resolve();\n            });\n        });\n    }\n\n    /**\n     * Get the application DI container.\n     *\n     * Useful for testing to verify state or access services directly.\n     *\n     * @returns The application Container\n     */\n    getContainer(): Container {\n        return this.appContainer;\n    }\n\n    /**\n     * Create an API client proxy for testing.\n     *\n     * This creates a client that routes calls through the full filter chain\n     * and controller, but WITHOUT any HTTP overhead. Perfect for testing!\n     *\n     * The client uses the ApiPrototype class to discover routes via decorators,\n     * then creates pre-configured invoker functions for each API method.\n     *\n     * IMPORTANT: This loops over the API methods (from decorators), NOT all routes.\n     * For each API method, it sets up the filter chain ONCE during proxy creation,\n     * so subsequent calls reuse the same filter chain (efficient!).\n     *\n     * @param apiPrototype - The API prototype class with routing decorators (can be abstract)\n     * @returns A proxy that implements the API interface\n     *\n     * Example:\n     * ```typescript\n     * const saveApi = server.createApiClient<SaveApi>(SaveApiPrototype);\n     * const response = await saveApi.save(request);\n     * ```\n     */\n    createApiClient<T>(apiPrototype: abstract new (...args: any[]) => T): T {\n        if (!this.initialized) {\n            throw new Error('Server not initialized. Call initialize() before createApiClient().');\n        }\n\n        // Get routes from the API prototype using decorators (loops over API methods, NOT all routes)\n        const apiMethods = getRoutes(apiPrototype);\n\n        // Create proxy object\n        const proxy: Record<string, unknown> = {};\n\n        // Loop over API methods and create proxy functions\n        for (const routeMeta of apiMethods) {\n            const methodName = routeMeta.methodName;\n            const httpMethod = routeMeta.httpMethod.toUpperCase();\n            const path = routeMeta.path;\n\n            // Create invoker service ONCE (sets up filter chain once, not on every call!)\n            const service = this.routeBuilder.createRouteInvoker(httpMethod, path);\n\n            // Proxy method creates MethodMeta and calls the pre-configured service\n            proxy[methodName] = async (requestDto: unknown): Promise<unknown> => {\n                const meta = new MethodMeta(routeMeta, requestDto);\n                const responseWrapper = await service.invoke(meta);\n                return responseWrapper.response;\n            };\n        }\n\n        return proxy as T;\n    }\n}\n"]}

package/src/filters/ContextFilter.d.ts

@@ -1,5 +1,5 @@
+import { MethodMeta } from '@webpieces/http-routing';
 import { Filter, WpResponse, Service } from '@webpieces/http-filters';
-import { MethodMeta } from '../MethodMeta';
 /**
  * ContextFilter - Sets up AsyncLocalStorage context for each request.
  * Priority: 140 (executes first)

package/src/filters/ContextFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContextFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/ContextFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0DAA2D;AAC3D,0DAAyD;AACzD,0DAAsE;AAGtE;;;;;;GAMG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,qBAAuC;IACtE,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,wDAAwD;QACxD,OAAO,6BAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACjC,gEAAgE;YAChE,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACxC,6BAAc,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAEnD,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,2CAA2C;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AAhBY,sCAAa;wBAAb,aAAa;IAFzB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,aAAa,CAgBzB","sourcesContent":["import { injectable } from 'inversify';\nimport { provideSingleton } from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport { MethodMeta } from '../MethodMeta';\n\n/**\n * ContextFilter - Sets up AsyncLocalStorage context for each request.\n * Priority: 140 (executes first)\n *\n * This filter ensures that all subsequent filters and the controller\n * execute within a context that can store request-scoped data.\n */\n@provideSingleton()\n@injectable()\nexport class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Run the rest of the filter chain within a new context\n        return RequestContext.run(async () => {\n            // Store request metadata in context for other filters to access\n            RequestContext.put('METHOD_META', meta);\n            RequestContext.put('REQUEST_PATH', meta.path);\n            RequestContext.put('HTTP_METHOD', meta.httpMethod);\n\n            return await nextFilter.invoke(meta);\n            //RequestContext is auto cleared when done.\n        });\n    }\n}\n"]}
+{"version":3,"file":"ContextFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/ContextFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0DAAuE;AACvE,0DAAyD;AACzD,0DAAsE;AAEtE;;;;;;GAMG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,qBAAuC;IACtE,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,wDAAwD;QACxD,OAAO,6BAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACjC,gEAAgE;YAChE,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACxC,6BAAc,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAEnD,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,2CAA2C;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AAhBY,sCAAa;wBAAb,aAAa;IAFzB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,aAAa,CAgBzB","sourcesContent":["import { injectable } from 'inversify';\nimport { provideSingleton, MethodMeta } from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\n\n/**\n * ContextFilter - Sets up AsyncLocalStorage context for each request.\n * Priority: 140 (executes first)\n *\n * This filter ensures that all subsequent filters and the controller\n * execute within a context that can store request-scoped data.\n */\n@provideSingleton()\n@injectable()\nexport class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Run the rest of the filter chain within a new context\n        return RequestContext.run(async () => {\n            // Store request metadata in context for other filters to access\n            RequestContext.put('METHOD_META', meta);\n            RequestContext.put('REQUEST_PATH', meta.path);\n            RequestContext.put('HTTP_METHOD', meta.httpMethod);\n\n            return await nextFilter.invoke(meta);\n            //RequestContext is auto cleared when done.\n        });\n    }\n}\n"]}