@webpieces/http-server 0.2.11 → 0.2.13

package/src/WebpiecesServer.js

@@ -1,15 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebpiecesServer = void 0;
-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 WebpiecesCoreServer_1 = require("./WebpiecesCoreServer");
 /**
  * WebpiecesServer - Main bootstrap class for WebPieces applications.
  *
@@ -44,247 +38,34 @@ const FilterMatcher_1 = require("./FilterMatcher");
  */
 class WebpiecesServer {
     constructor(meta) {
-        /**
-         * Routes registry: Maps "METHOD:path" -> RegisteredRoute
-         * Example: "POST:/search/item" -> { method: "POST", path: "/search/item", handler: ... }
-         *
-         * We use unknown instead of any for type safety - each route has its own return type,
-         * but we can't have different generic types in the same Map.
-         */
-        this.routes = new Map();
-        /**
-         * Registered filters with their definitions.
-         * Used by FilterMatcher to match filters to routes based on filepath patterns.
-         */
-        this.filterRegistry = [];
-        this.initialized = false;
-        this.port = 8080;
         this.meta = meta;
         // Create WebPieces container for framework-level bindings
         this.webpiecesContainer = new inversify_1.Container();
-        // Create application container as a child of WebPieces container
-        // This allows app container to access framework bindings
-        this.appContainer = new inversify_1.Container({ parent: this.webpiecesContainer });
+        // Load buildProviderModule to auto-scan for @provideSingleton decorators
+        // This registers framework classes (WebpiecesCoreServer, RouteBuilderImpl)
+        this.webpiecesContainer.load((0, binding_decorators_1.buildProviderModule)());
+        // Resolve WebpiecesCoreServer from DI container (proper DI - no 'new'!)
+        this.coreService = this.webpiecesContainer.get(WebpiecesCoreServer_1.WebpiecesCoreServer);
     }
     /**
      * Initialize the server (DI container, routes, filters).
      * This is called automatically by start() or can be called manually for testing.
      */
     initialize() {
-        if (this.initialized) {
-            return;
-        }
-        // 1. Load DI modules
-        this.loadDIModules();
-        // 2. Register routes and filters
-        this.registerRoutes();
-        this.initialized = true;
-    }
-    /**
-     * Load DI modules from WebAppMeta.
-     *
-     * Currently, all user modules are loaded into the application container.
-     * In the future, we could separate:
-     * - WebPieces framework modules -> webpiecesContainer
-     * - Application modules -> appContainer
-     *
-     * For now, everything goes into appContainer which has access to webpiecesContainer.
-     */
-    loadDIModules() {
-        const modules = this.meta.getDIModules();
-        // Load buildProviderModule to auto-scan for @provideSingleton decorators
-        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);
-        }
-    }
-    /**
-     * Register routes from WebAppMeta.
-     *
-     * Creates an explicit RouteBuilderImpl instead of an anonymous object.
-     * This improves:
-     * - Traceability: Can Cmd+Click on addRoute to see implementation
-     * - Debugging: Explicit class shows up in stack traces
-     * - Understanding: Clear class name vs anonymous object
-     */
-    registerRoutes() {
-        const routeConfigs = this.meta.getRoutes();
-        // Create explicit RouteBuilder implementation
-        // Filters are resolved from appContainer (which has access to platformContainer too)
-        const routeBuilder = new RouteBuilderImpl_1.RouteBuilderImpl(this.routes, this.filterRegistry, this.appContainer);
-        // Configure routes using the explicit RouteBuilder
-        for (const routeConfig of routeConfigs) {
-            routeConfig.configure(routeBuilder);
-        }
+        this.coreService.initialize(this.webpiecesContainer, this.meta);
     }
     /**
      * Start the HTTP server with Express.
      */
     start(port = 8080) {
-        this.port = port;
         this.initialize();
-        // Create Express app
-        this.app = (0, express_1.default)();
-        // Middleware
-        this.app.use(express_1.default.json());
-        this.app.use(express_1.default.urlencoded({ extended: true }));
-        // Register routes
-        this.registerExpressRoutes();
-        // Start listening
-        this.server = this.app.listen(this.port, () => {
-            console.log(`[WebpiecesServer] Server listening on http://localhost:${this.port}`);
-            console.log(`[WebpiecesServer] Registered ${this.routes.size} routes`);
-            console.log(`[WebpiecesServer] Registered ${this.filterRegistry.length} filters`);
-        });
-    }
-    /**
-     * Register all routes with Express.
-     */
-    registerExpressRoutes() {
-        if (!this.app) {
-            throw new Error('Express app not initialized');
-        }
-        for (const [key, route] of this.routes.entries()) {
-            const method = route.method.toLowerCase();
-            const path = route.path;
-            console.log(`[WebpiecesServer] Registering route: ${method.toUpperCase()} ${path}`);
-            // Find matching filters for this route
-            const matchingFilters = FilterMatcher_1.FilterMatcher.findMatchingFilters(route.controllerFilepath, this.filterRegistry);
-            // Create Express route handler
-            const handler = async (req, res, next) => {
-                try {
-                    // Create method metadata
-                    const meta = new http_filters_1.MethodMeta(route.method, route.path, key, [req.body], new core_meta_1.RouteRequest(req.body, req.query, req.params, req.headers), undefined, new Map());
-                    // Create filter chain with matched filters
-                    const filterChain = new http_filters_1.FilterChain(matchingFilters);
-                    // Execute the filter chain
-                    const action = await filterChain.execute(meta, async () => {
-                        // Create typed route context
-                        // Use appContainer which has access to both app and framework bindings
-                        const routeContext = new core_meta_1.RouteContext(this.appContainer, [req.body], meta.request);
-                        // Final handler: invoke the controller method via route handler
-                        const result = await route.handler.execute(routeContext);
-                        // Wrap result in a JSON action
-                        return (0, http_filters_1.jsonAction)(result);
-                    });
-                    // Send response
-                    if (action.type === 'json') {
-                        res.json(action.data);
-                    }
-                    else if (action.type === 'error') {
-                        res.status(500).json({ error: action.data });
-                    }
-                }
-                catch (error) {
-                    console.error('[WebpiecesServer] Error handling request:', error);
-                    res.status(500).json({ error: error.message });
-                }
-            };
-            // Register with Express
-            switch (method) {
-                case 'get':
-                    this.app.get(path, handler);
-                    break;
-                case 'post':
-                    this.app.post(path, handler);
-                    break;
-                case 'put':
-                    this.app.put(path, handler);
-                    break;
-                case 'delete':
-                    this.app.delete(path, handler);
-                    break;
-                case 'patch':
-                    this.app.patch(path, handler);
-                    break;
-                default:
-                    console.warn(`[WebpiecesServer] Unknown HTTP method: ${method}`);
-            }
-        }
+        this.coreService.start(port);
     }
     /**
      * Stop the HTTP server.
      */
     stop() {
-        if (this.server) {
-            this.server.close(() => {
-                console.log('[WebpiecesServer] Server stopped');
-            });
-        }
-    }
-    /**
-     * Create an API client proxy for testing (no HTTP).
-     *
-     * This creates a proxy object that implements the API interface
-     * and routes method calls through the full filter chain to the controller.
-     *
-     * @param apiMetaClass - The API interface class with decorators
-     * @returns Proxy object implementing the API interface
-     */
-    createApiClient(apiMetaClass) {
-        this.initialize();
-        // Get routes from the API metadata
-        const routes = (0, http_routing_1.getRoutes)(apiMetaClass);
-        // Create a proxy object
-        const proxy = {};
-        for (const route of routes) {
-            const methodName = route.methodName;
-            // Create a function that routes through the filter chain
-            proxy[methodName] = async (...args) => {
-                return this.invokeRoute(route, args);
-            };
-        }
-        return proxy;
-    }
-    /**
-     * Invoke a route through the filter chain.
-     */
-    async invokeRoute(route, args) {
-        // Find the registered route
-        const key = `${route.httpMethod}:${route.path}`;
-        const registeredRoute = this.routes.get(key);
-        if (!registeredRoute) {
-            throw new Error(`Route not found: ${key}`);
-        }
-        // Find matching filters for this route
-        const matchingFilters = FilterMatcher_1.FilterMatcher.findMatchingFilters(registeredRoute.controllerFilepath, this.filterRegistry);
-        // Create method metadata
-        const meta = new http_filters_1.MethodMeta(route.httpMethod, route.path, route.methodName, [...args], new core_meta_1.RouteRequest(args[0]), // Assume first arg is the request body
-        undefined, new Map());
-        // Create filter chain with matched filters
-        const filterChain = new http_filters_1.FilterChain(matchingFilters);
-        // Execute the filter chain
-        const action = await filterChain.execute(meta, async () => {
-            // Create typed route context
-            // Use appContainer which has access to both app and framework bindings
-            const routeContext = new core_meta_1.RouteContext(this.appContainer, meta.params, meta.request);
-            // Final handler: invoke the controller method via route handler
-            const result = await registeredRoute.handler.execute(routeContext);
-            // Wrap result in a JSON action
-            return (0, http_filters_1.jsonAction)(result);
-        });
-        // Return the data from the action
-        if (action.type === 'error') {
-            throw new Error(JSON.stringify(action.data));
-        }
-        return action.data;
-    }
-    /**
-     * Get the application DI container (for testing).
-     * Returns appContainer which has access to both app and framework bindings.
-     */
-    getContainer() {
-        this.initialize();
-        return this.appContainer;
-    }
-    /**
-     * Get the WebPieces framework container (for advanced testing/debugging).
-     */
-    getWebpiecesContainer() {
-        this.initialize();
-        return this.webpiecesContainer;
+        this.coreService.stop();
     }
 }
 exports.WebpiecesServer = WebpiecesServer;

package/src/WebpiecesServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebpiecesServer.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/WebpiecesServer.ts"],"names":[],"mappings":"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","sourcesContent":["import express, { Express, Request, Response, NextFunction } from 'express';\nimport { Container } from 'inversify';\nimport { buildProviderModule } from '@inversifyjs/binding-decorators';\nimport { WebAppMeta, RouteContext, RouteRequest, FilterDefinition } from '@webpieces/core-meta';\nimport { FilterChain, Filter, MethodMeta, jsonAction } from '@webpieces/http-filters';\nimport { getRoutes, RouteMetadata } from '@webpieces/http-routing';\nimport { RouteBuilderImpl, RegisteredRoute } from './RouteBuilderImpl';\nimport { FilterMatcher } from './FilterMatcher';\n\n/**\n * WebpiecesServer - Main bootstrap class for WebPieces applications.\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 * Usage for testing (no HTTP):\n * ```typescript\n * const server = new WebpiecesServer(new ProdServerMeta());\n * server.initialize();\n * const saveApi = server.createApiClient<SaveApi>(SaveApiPrototype);\n * const response = await saveApi.save(request);\n * ```\n *\n * Usage for production (HTTP server):\n * ```typescript\n * const server = new WebpiecesServer(new ProdServerMeta());\n * server.start(); // Starts Express server\n * ```\n */\nexport class WebpiecesServer {\n  private meta: WebAppMeta;\n\n  /**\n   * WebPieces container: Core WebPieces framework bindings.\n   * This includes framework-level services like filters, routing infrastructure,\n   * logging, metrics, etc. Similar to Java WebPieces platform container.\n   */\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  /**\n   * Routes registry: Maps \"METHOD:path\" -> RegisteredRoute\n   * Example: \"POST:/search/item\" -> { method: \"POST\", path: \"/search/item\", handler: ... }\n   *\n   * We use unknown instead of any for type safety - each route has its own return type,\n   * but we can't have different generic types in the same Map.\n   */\n  private routes: Map<string, RegisteredRoute<unknown>> = new Map();\n\n  /**\n   * Registered filters with their definitions.\n   * Used by FilterMatcher to match filters to routes based on filepath patterns.\n   */\n  private filterRegistry: Array<{ filter: Filter; definition: FilterDefinition }> = [];\n\n  private initialized = false;\n  private app?: Express;\n  private server?: any;\n  private port: number = 8080;\n\n  constructor(meta: WebAppMeta) {\n    this.meta = meta;\n\n    // Create WebPieces container for framework-level bindings\n    this.webpiecesContainer = new Container();\n\n    // Create application container as a child of WebPieces container\n    // This allows app container to access framework bindings\n    this.appContainer = new Container({ parent: this.webpiecesContainer });\n  }\n\n  /**\n   * Initialize the server (DI container, routes, filters).\n   * This is called automatically by start() or can be called manually for testing.\n   */\n  initialize(): void {\n    if (this.initialized) {\n      return;\n    }\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    // Create explicit RouteBuilder implementation\n    // Filters are resolved from appContainer (which has access to platformContainer too)\n    const routeBuilder = new RouteBuilderImpl(\n      this.routes,\n      this.filterRegistry,\n      this.appContainer\n    );\n\n    // Configure routes using the explicit RouteBuilder\n    for (const routeConfig of routeConfigs) {\n      routeConfig.configure(routeBuilder);\n    }\n  }\n\n  /**\n   * Start the HTTP server with Express.\n   */\n  start(port: number = 8080): void {\n    this.port = port;\n    this.initialize();\n\n    // Create Express app\n    this.app = express();\n\n    // Middleware\n    this.app.use(express.json());\n    this.app.use(express.urlencoded({ extended: true }));\n\n    // Register routes\n    this.registerExpressRoutes();\n\n    // Start listening\n    this.server = this.app.listen(this.port, () => {\n      console.log(`[WebpiecesServer] Server listening on http://localhost:${this.port}`);\n      console.log(`[WebpiecesServer] Registered ${this.routes.size} routes`);\n      console.log(`[WebpiecesServer] Registered ${this.filterRegistry.length} filters`);\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    for (const [key, route] of this.routes.entries()) {\n      const method = route.method.toLowerCase();\n      const path = route.path;\n\n      console.log(`[WebpiecesServer] Registering route: ${method.toUpperCase()} ${path}`);\n\n      // Find matching filters for this route\n      const matchingFilters = FilterMatcher.findMatchingFilters(\n        route.controllerFilepath,\n        this.filterRegistry\n      );\n\n      // Create Express route handler\n      const handler = async (req: Request, res: Response, next: NextFunction) => {\n        try {\n          // Create method metadata\n          const meta = new MethodMeta(\n            route.method,\n            route.path,\n            key,\n            [req.body],\n            new RouteRequest(req.body, req.query, req.params, req.headers),\n            undefined,\n            new Map()\n          );\n\n          // Create filter chain with matched filters\n          const filterChain = new FilterChain(matchingFilters);\n\n          // Execute the filter chain\n          const action = await filterChain.execute(meta, async () => {\n            // Create typed route context\n            // Use appContainer which has access to both app and framework bindings\n            const routeContext = new RouteContext(\n              this.appContainer,\n              [req.body],\n              meta.request\n            );\n\n            // Final handler: invoke the controller method via route handler\n            const result = await route.handler.execute(routeContext);\n\n            // Wrap result in a JSON action\n            return jsonAction(result);\n          });\n\n          // Send response\n          if (action.type === 'json') {\n            res.json(action.data);\n          } else if (action.type === 'error') {\n            res.status(500).json({ error: action.data });\n          }\n        } catch (error: any) {\n          console.error('[WebpiecesServer] Error handling request:', error);\n          res.status(500).json({ error: error.message });\n        }\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  /**\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  /**\n   * Create an API client proxy for testing (no HTTP).\n   *\n   * This creates a proxy object that implements the API interface\n   * and routes method calls through the full filter chain to the controller.\n   *\n   * @param apiMetaClass - The API interface class with decorators\n   * @returns Proxy object implementing the API interface\n   */\n  createApiClient<T>(apiMetaClass: any): T {\n    this.initialize();\n\n    // Get routes from the API metadata\n    const routes = getRoutes(apiMetaClass);\n\n    // Create a proxy object\n    const proxy: any = {};\n\n    for (const route of routes) {\n      const methodName = route.methodName;\n\n      // Create a function that routes through the filter chain\n      proxy[methodName] = async (...args: any[]) => {\n        return this.invokeRoute(route, args);\n      };\n    }\n\n    return proxy as T;\n  }\n\n  /**\n   * Invoke a route through the filter chain.\n   */\n  private async invokeRoute(route: RouteMetadata, args: any[]): Promise<any> {\n    // Find the registered route\n    const key = `${route.httpMethod}:${route.path}`;\n    const registeredRoute = this.routes.get(key);\n\n    if (!registeredRoute) {\n      throw new Error(`Route not found: ${key}`);\n    }\n\n    // Find matching filters for this route\n    const matchingFilters = FilterMatcher.findMatchingFilters(\n      registeredRoute.controllerFilepath,\n      this.filterRegistry\n    );\n\n    // Create method metadata\n    const meta = new MethodMeta(\n      route.httpMethod,\n      route.path,\n      route.methodName,\n      [...args],\n      new RouteRequest(args[0]), // Assume first arg is the request body\n      undefined,\n      new Map()\n    );\n\n    // Create filter chain with matched filters\n    const filterChain = new FilterChain(matchingFilters);\n\n    // Execute the filter chain\n    const action = await filterChain.execute(meta, async () => {\n      // Create typed route context\n      // Use appContainer which has access to both app and framework bindings\n      const routeContext = new RouteContext(\n        this.appContainer,\n        meta.params,\n        meta.request\n      );\n\n      // Final handler: invoke the controller method via route handler\n      const result = await registeredRoute.handler.execute(routeContext);\n\n      // Wrap result in a JSON action\n      return jsonAction(result);\n    });\n\n    // Return the data from the action\n    if (action.type === 'error') {\n      throw new Error(JSON.stringify(action.data));\n    }\n\n    return action.data;\n  }\n\n  /**\n   * Get the application DI container (for testing).\n   * Returns appContainer which has access to both app and framework bindings.\n   */\n  getContainer(): Container {\n    this.initialize();\n    return this.appContainer;\n  }\n\n  /**\n   * Get the WebPieces framework container (for advanced testing/debugging).\n   */\n  getWebpiecesContainer(): Container {\n    this.initialize();\n    return this.webpiecesContainer;\n  }\n\n\n}\n"]}
+{"version":3,"file":"WebpiecesServer.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/WebpiecesServer.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AACtC,wEAAsE;AAEtE,+DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,eAAe;IAY1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,0DAA0D;QAC1D,IAAI,CAAC,kBAAkB,GAAG,IAAI,qBAAS,EAAE,CAAC;QAE1C,yEAAyE;QACzE,2EAA2E;QAC3E,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAA,wCAAmB,GAAE,CAAC,CAAC;QAEpD,wEAAwE;QACxE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,yCAAmB,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,IAAI;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CAEF;AAjDD,0CAiDC","sourcesContent":["import { Container } from 'inversify';\nimport { buildProviderModule } from '@inversifyjs/binding-decorators';\nimport { WebAppMeta } from '@webpieces/core-meta';\nimport { WebpiecesCoreServer } from \"./WebpiecesCoreServer\";\n\n/**\n * WebpiecesServer - Main bootstrap class for WebPieces applications.\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 * Usage for testing (no HTTP):\n * ```typescript\n * const server = new WebpiecesServer(new ProdServerMeta());\n * server.initialize();\n * const saveApi = server.createApiClient<SaveApi>(SaveApiPrototype);\n * const response = await saveApi.save(request);\n * ```\n *\n * Usage for production (HTTP server):\n * ```typescript\n * const server = new WebpiecesServer(new ProdServerMeta());\n * server.start(); // Starts Express server\n * ```\n */\nexport class WebpiecesServer {\n  private meta: WebAppMeta;\n\n  /**\n   * WebPieces container: Core WebPieces framework bindings.\n   * This includes framework-level services like filters, routing infrastructure,\n   * logging, metrics, etc. Similar to Java WebPieces platform container.\n   */\n  private webpiecesContainer: Container;\n\n  private coreService: WebpiecesCoreServer;\n\n  constructor(meta: WebAppMeta) {\n    this.meta = meta;\n\n    // Create WebPieces container for framework-level bindings\n    this.webpiecesContainer = new Container();\n\n    // Load buildProviderModule to auto-scan for @provideSingleton decorators\n    // This registers framework classes (WebpiecesCoreServer, RouteBuilderImpl)\n    this.webpiecesContainer.load(buildProviderModule());\n\n    // Resolve WebpiecesCoreServer from DI container (proper DI - no 'new'!)\n    this.coreService = this.webpiecesContainer.get(WebpiecesCoreServer);\n  }\n\n  /**\n   * Initialize the server (DI container, routes, filters).\n   * This is called automatically by start() or can be called manually for testing.\n   */\n  initialize(): void {\n    this.coreService.initialize(this.webpiecesContainer, this.meta);\n  }\n\n  /**\n   * Start the HTTP server with Express.\n   */\n  start(port: number = 8080): void {\n    this.initialize();\n    this.coreService.start(port);\n  }\n\n  /**\n   * Stop the HTTP server.\n   */\n  stop(): void {\n    this.coreService.stop();\n  }\n\n}\n"]}

package/src/filters/ContextFilter.d.ts

@@ -0,0 +1,12 @@
+import { Filter, WpResponse, Service } from '@webpieces/http-filters';
+import { MethodMeta } from '../MethodMeta';
+/**
+ * ContextFilter - Sets up AsyncLocalStorage context for each request.
+ * Priority: 140 (executes first)
+ *
+ * This filter ensures that all subsequent filters and the controller
+ * execute within a context that can store request-scoped data.
+ */
+export declare class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {
+    filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
+}

package/src/filters/ContextFilter.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextFilter = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const http_routing_1 = require("@webpieces/http-routing");
+const core_context_1 = require("@webpieces/core-context");
+const http_filters_1 = require("@webpieces/http-filters");
+/**
+ * ContextFilter - Sets up AsyncLocalStorage context for each request.
+ * Priority: 140 (executes first)
+ *
+ * This filter ensures that all subsequent filters and the controller
+ * execute within a context that can store request-scoped data.
+ */
+let ContextFilter = class ContextFilter extends http_filters_1.Filter {
+    async filter(meta, nextFilter) {
+        // Run the rest of the filter chain within a new context
+        return core_context_1.RequestContext.run(async () => {
+            // Store request metadata in context for other filters to access
+            core_context_1.RequestContext.put('METHOD_META', meta);
+            core_context_1.RequestContext.put('REQUEST_PATH', meta.path);
+            core_context_1.RequestContext.put('HTTP_METHOD', meta.httpMethod);
+            return await nextFilter.invoke(meta);
+            //RequestContext is auto cleared when done.
+        });
+    }
+};
+exports.ContextFilter = ContextFilter;
+exports.ContextFilter = ContextFilter = tslib_1.__decorate([
+    (0, http_routing_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+], ContextFilter);
+//# sourceMappingURL=ContextFilter.js.map

package/src/filters/ContextFilter.js.map

@@ -0,0 +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;IAExE,KAAK,CAAC,MAAM,CACV,IAAgB,EAChB,UAAoD;QAEpD,wDAAwD;QACxD,OAAO,6BAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACnC,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;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAjBY,sCAAa;wBAAb,aAAa;IAFzB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,aAAa,CAiBzB","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\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"]}

package/src/filters/JsonFilter.d.ts

@@ -0,0 +1,62 @@
+import { Filter, WpResponse, Service } from '@webpieces/http-filters';
+import { MethodMeta } from '../MethodMeta';
+/**
+ * DI tokens for JsonFilter.
+ */
+export declare const FILTER_TYPES: {
+    JsonFilterConfig: symbol;
+};
+/**
+ * Configuration for JsonFilter.
+ * Register this in your DI container to customize JsonFilter behavior.
+ */
+export declare class JsonFilterConfig {
+}
+/**
+ * JsonFilter - Handles JSON serialization/deserialization and writes response to HTTP body.
+ *
+ * Similar to Java WebPieces JacksonCatchAllFilter.
+ *
+ * Flow:
+ * 1. Log request
+ * 2. Deserialize request body to DTO and set on meta.requestDto
+ * 3. Call next filter/controller
+ * 4. Get response (WpResponse)
+ * 5. Write response to Express response
+ * 6. On ANY exception, send 500
+ */
+export declare class JsonFilter extends Filter<MethodMeta, WpResponse<unknown>> {
+    private config;
+    constructor(config: JsonFilterConfig);
+    filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
+    /**
+     * Deserialize request body to DTO and set on meta.requestDto.
+     */
+    private deserializeRequest;
+    /**
+     * Write WpResponse to HTTP response body as JSON.
+     */
+    private writeResponse;
+    /**
+     * Log the incoming request.
+     */
+    private logRequest;
+    /**
+     * Log the outgoing response.
+     */
+    private logResponse;
+}
+/**
+ * Exception thrown when validation fails.
+ */
+export declare class ValidationException extends Error {
+    violations: string[];
+    constructor(violations: string[]);
+}
+/**
+ * HTTP exception with status code.
+ */
+export declare class HttpException extends Error {
+    statusCode: number;
+    constructor(message: string, statusCode: number);
+}

package/src/filters/JsonFilter.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpException = exports.ValidationException = exports.JsonFilter = exports.JsonFilterConfig = exports.FILTER_TYPES = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const http_routing_1 = require("@webpieces/http-routing");
+const http_filters_1 = require("@webpieces/http-filters");
+const core_util_1 = require("@webpieces/core-util");
+/**
+ * DI tokens for JsonFilter.
+ */
+exports.FILTER_TYPES = {
+    JsonFilterConfig: Symbol.for('JsonFilterConfig'),
+};
+/**
+ * Configuration for JsonFilter.
+ * Register this in your DI container to customize JsonFilter behavior.
+ */
+let JsonFilterConfig = class JsonFilterConfig {
+};
+exports.JsonFilterConfig = JsonFilterConfig;
+exports.JsonFilterConfig = JsonFilterConfig = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], JsonFilterConfig);
+/**
+ * JsonFilter - Handles JSON serialization/deserialization and writes response to HTTP body.
+ *
+ * Similar to Java WebPieces JacksonCatchAllFilter.
+ *
+ * Flow:
+ * 1. Log request
+ * 2. Deserialize request body to DTO and set on meta.requestDto
+ * 3. Call next filter/controller
+ * 4. Get response (WpResponse)
+ * 5. Write response to Express response
+ * 6. On ANY exception, send 500
+ */
+let JsonFilter = class JsonFilter extends http_filters_1.Filter {
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    async filter(meta, nextFilter) {
+        // Get Express Request/Response from routeRequest
+        const expressRequest = meta.routeRequest.request;
+        const expressResponse = meta.routeRequest.response;
+        try {
+            // 1. Log request
+            this.logRequest(meta, expressRequest);
+            // 2. Deserialize request body to DTO
+            this.deserializeRequest(meta, expressRequest);
+            // 3. Call next filter/controller
+            const responseWrapper = await nextFilter.invoke(meta);
+            // 4. Log response
+            this.logResponse(responseWrapper);
+            // 5. Write response to Express response
+            this.writeResponse(expressResponse, responseWrapper);
+            return responseWrapper;
+        }
+        catch (err) {
+            const error = (0, core_util_1.toError)(err);
+            // 6. On ANY exception, send 500
+            console.error('[JsonFilter] Error:', error);
+            const errorResponse = new http_filters_1.WpResponse({ error: 'Internal server error' }, 500);
+            this.writeResponse(expressResponse, errorResponse);
+            return errorResponse;
+        }
+    }
+    /**
+     * Deserialize request body to DTO and set on meta.requestDto.
+     */
+    deserializeRequest(meta, expressRequest) {
+        if (expressRequest.body) {
+            // Set the deserialized body as requestDto
+            meta.requestDto = expressRequest.body;
+        }
+    }
+    /**
+     * Write WpResponse to HTTP response body as JSON.
+     */
+    writeResponse(expressResponse, responseWrapper) {
+        // Set status code
+        expressResponse.status(responseWrapper.statusCode);
+        // Set headers from wrapper
+        responseWrapper.headers.forEach((value, name) => {
+            expressResponse.setHeader(name, value);
+        });
+        // Set content type to JSON
+        expressResponse.setHeader('Content-Type', 'application/json');
+        // Serialize and write response body
+        if (responseWrapper.response !== undefined) {
+            expressResponse.json(responseWrapper.response);
+        }
+        else {
+            expressResponse.end();
+        }
+    }
+    /**
+     * Log the incoming request.
+     */
+    logRequest(meta, expressRequest) {
+        console.log(`[JsonFilter] ${meta.httpMethod} ${meta.path}`);
+        if (expressRequest.body) {
+            console.log('[JsonFilter] Request body:', JSON.stringify(expressRequest.body, null, 2));
+        }
+    }
+    /**
+     * Log the outgoing response.
+     */
+    logResponse(responseWrapper) {
+        console.log(`[JsonFilter] Response: ${responseWrapper.statusCode}`);
+        if (responseWrapper.response) {
+            console.log('[JsonFilter] Response body:', JSON.stringify(responseWrapper.response, null, 2));
+        }
+    }
+};
+exports.JsonFilter = JsonFilter;
+exports.JsonFilter = JsonFilter = tslib_1.__decorate([
+    (0, http_routing_1.provideSingleton)(),
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(exports.FILTER_TYPES.JsonFilterConfig)),
+    tslib_1.__metadata("design:paramtypes", [JsonFilterConfig])
+], JsonFilter);
+/**
+ * Exception thrown when validation fails.
+ */
+class ValidationException extends Error {
+    constructor(violations) {
+        super('Validation failed');
+        this.violations = violations;
+        this.name = 'ValidationException';
+    }
+}
+exports.ValidationException = ValidationException;
+/**
+ * HTTP exception with status code.
+ */
+class HttpException extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'HttpException';
+    }
+}
+exports.HttpException = HttpException;
+//# sourceMappingURL=JsonFilter.js.map

package/src/filters/JsonFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/JsonFilter.ts"],"names":[],"mappings":"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","sourcesContent":["import { injectable, inject } from 'inversify';\nimport { provideSingleton } from '@webpieces/http-routing';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport { toError } from '@webpieces/core-util';\nimport { Request, Response } from 'express';\nimport { MethodMeta } from '../MethodMeta';\n\n/**\n * DI tokens for JsonFilter.\n */\nexport const FILTER_TYPES = {\n  JsonFilterConfig: Symbol.for('JsonFilterConfig'),\n};\n\n/**\n * Configuration for JsonFilter.\n * Register this in your DI container to customize JsonFilter behavior.\n */\n@injectable()\nexport class JsonFilterConfig {\n  // Configuration options can be added here\n}\n\n/**\n * JsonFilter - Handles JSON serialization/deserialization and writes response to HTTP body.\n *\n * Similar to Java WebPieces JacksonCatchAllFilter.\n *\n * Flow:\n * 1. Log request\n * 2. Deserialize request body to DTO and set on meta.requestDto\n * 3. Call next filter/controller\n * 4. Get response (WpResponse)\n * 5. Write response to Express response\n * 6. On ANY exception, send 500\n */\n@provideSingleton()\n@injectable()\nexport class JsonFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n\n  constructor(@inject(FILTER_TYPES.JsonFilterConfig) private config: JsonFilterConfig) {\n    super();\n  }\n\n  async filter(\n    meta: MethodMeta,\n    nextFilter: Service<MethodMeta, WpResponse<unknown>>\n  ): Promise<WpResponse<unknown>> {\n    // Get Express Request/Response from routeRequest\n    const expressRequest = meta.routeRequest.request as Request;\n    const expressResponse = meta.routeRequest.response as Response;\n\n    try {\n      // 1. Log request\n      this.logRequest(meta, expressRequest);\n\n      // 2. Deserialize request body to DTO\n      this.deserializeRequest(meta, expressRequest);\n\n      // 3. Call next filter/controller\n      const responseWrapper = await nextFilter.invoke(meta);\n\n      // 4. Log response\n      this.logResponse(responseWrapper);\n\n      // 5. Write response to Express response\n      this.writeResponse(expressResponse, responseWrapper);\n\n      return responseWrapper;\n    } catch (err: unknown) {\n      const error = toError(err);\n      // 6. On ANY exception, send 500\n      console.error('[JsonFilter] Error:', error);\n      const errorResponse = new WpResponse({ error: 'Internal server error' }, 500);\n      this.writeResponse(expressResponse, errorResponse);\n      return errorResponse;\n    }\n  }\n\n  /**\n   * Deserialize request body to DTO and set on meta.requestDto.\n   */\n  private deserializeRequest(meta: MethodMeta, expressRequest: Request): void {\n    if (expressRequest.body) {\n      // Set the deserialized body as requestDto\n      meta.requestDto = expressRequest.body;\n    }\n  }\n\n  /**\n   * Write WpResponse to HTTP response body as JSON.\n   */\n  private writeResponse(\n    expressResponse: Response,\n    responseWrapper: WpResponse<unknown>\n  ): void {\n    // Set status code\n    expressResponse.status(responseWrapper.statusCode);\n\n    // Set headers from wrapper\n    responseWrapper.headers.forEach((value, name) => {\n      expressResponse.setHeader(name, value);\n    });\n\n    // Set content type to JSON\n    expressResponse.setHeader('Content-Type', 'application/json');\n\n    // Serialize and write response body\n    if (responseWrapper.response !== undefined) {\n      expressResponse.json(responseWrapper.response);\n    } else {\n      expressResponse.end();\n    }\n  }\n\n  /**\n   * Log the incoming request.\n   */\n  private logRequest(meta: MethodMeta, expressRequest: Request): void {\n    console.log(`[JsonFilter] ${meta.httpMethod} ${meta.path}`);\n    if (expressRequest.body) {\n      console.log('[JsonFilter] Request body:', JSON.stringify(expressRequest.body, null, 2));\n    }\n  }\n\n  /**\n   * Log the outgoing response.\n   */\n  private logResponse(responseWrapper: WpResponse<unknown>): void {\n    console.log(`[JsonFilter] Response: ${responseWrapper.statusCode}`);\n    if (responseWrapper.response) {\n      console.log('[JsonFilter] Response body:', JSON.stringify(responseWrapper.response, null, 2));\n    }\n  }\n}\n\n/**\n * Exception thrown when validation fails.\n */\nexport class ValidationException extends Error {\n  constructor(public violations: string[]) {\n    super('Validation failed');\n    this.name = 'ValidationException';\n  }\n}\n\n/**\n * HTTP exception with status code.\n */\nexport class HttpException extends Error {\n  constructor(message: string, public statusCode: number) {\n    super(message);\n    this.name = 'HttpException';\n  }\n}\n"]}

package/src/index.d.ts

@@ -1,2 +1,7 @@
 export { WebpiecesServer } from './WebpiecesServer';
-export { RouteBuilderImpl, RegisteredRoute } from './RouteBuilderImpl';
+export { RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, HttpFilter } from './RouteBuilderImpl';
+export { WebpiecesCoreServer } from './WebpiecesCoreServer';
+export { RouteHandler } from './RouteHandler';
+export { MethodMeta } from './MethodMeta';
+export { ContextFilter } from './filters/ContextFilter';
+export { JsonFilter, JsonFilterConfig, FILTER_TYPES, ValidationException, HttpException, } from './filters/JsonFilter';

package/src/index.js

@@ -1,9 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RegisteredRoute = exports.RouteBuilderImpl = exports.WebpiecesServer = void 0;
+exports.HttpException = exports.ValidationException = exports.FILTER_TYPES = exports.JsonFilterConfig = exports.JsonFilter = exports.ContextFilter = exports.MethodMeta = exports.RouteHandler = exports.WebpiecesCoreServer = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.WebpiecesServer = void 0;
 var WebpiecesServer_1 = require("./WebpiecesServer");
 Object.defineProperty(exports, "WebpiecesServer", { enumerable: true, get: function () { return WebpiecesServer_1.WebpiecesServer; } });
 var RouteBuilderImpl_1 = require("./RouteBuilderImpl");
 Object.defineProperty(exports, "RouteBuilderImpl", { enumerable: true, get: function () { return RouteBuilderImpl_1.RouteBuilderImpl; } });
-Object.defineProperty(exports, "RegisteredRoute", { enumerable: true, get: function () { return RouteBuilderImpl_1.RegisteredRoute; } });
+Object.defineProperty(exports, "RouteHandlerWithMeta", { enumerable: true, get: function () { return RouteBuilderImpl_1.RouteHandlerWithMeta; } });
+Object.defineProperty(exports, "FilterWithMeta", { enumerable: true, get: function () { return RouteBuilderImpl_1.FilterWithMeta; } });
+var WebpiecesCoreServer_1 = require("./WebpiecesCoreServer");
+Object.defineProperty(exports, "WebpiecesCoreServer", { enumerable: true, get: function () { return WebpiecesCoreServer_1.WebpiecesCoreServer; } });
+var RouteHandler_1 = require("./RouteHandler");
+Object.defineProperty(exports, "RouteHandler", { enumerable: true, get: function () { return RouteHandler_1.RouteHandler; } });
+var MethodMeta_1 = require("./MethodMeta");
+Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return MethodMeta_1.MethodMeta; } });
+var ContextFilter_1 = require("./filters/ContextFilter");
+Object.defineProperty(exports, "ContextFilter", { enumerable: true, get: function () { return ContextFilter_1.ContextFilter; } });
+var JsonFilter_1 = require("./filters/JsonFilter");
+Object.defineProperty(exports, "JsonFilter", { enumerable: true, get: function () { return JsonFilter_1.JsonFilter; } });
+Object.defineProperty(exports, "JsonFilterConfig", { enumerable: true, get: function () { return JsonFilter_1.JsonFilterConfig; } });
+Object.defineProperty(exports, "FILTER_TYPES", { enumerable: true, get: function () { return JsonFilter_1.FILTER_TYPES; } });
+Object.defineProperty(exports, "ValidationException", { enumerable: true, get: function () { return JsonFilter_1.ValidationException; } });
+Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return JsonFilter_1.HttpException; } });
 //# sourceMappingURL=index.js.map