@webpieces/http-server 0.3.233 → 0.3.235

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} from 'express';\nimport {Container, ContainerModule, inject, injectable} from 'inversify';\nimport {buildProviderModule} from '@inversifyjs/binding-decorators';\nimport {\n    ExpressRouteHandler,\n    getApiPath,\n    getAuthMeta,\n    getEndpoints,\n    MethodMeta,\n    provideSingleton,\n    RouteBuilderImpl, RouteMetadata,\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n    WebpiecesConfig,\n} from '@webpieces/http-routing';\nimport {WebpiecesServer} from './WebpiecesServer';\nimport {WebpiecesMiddleware} from './WebpiecesMiddleware';\nimport {RequestContext} from '@webpieces/core-context';\nimport {Service, WpResponse} from \"@webpieces/http-filters\";\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 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(WEBAPP_META_TOKEN) private meta: WebAppMeta,\n        @inject(RouteBuilderImpl) private routeBuilder: RouteBuilderImpl,\n        @inject(WebpiecesMiddleware) private middleware: WebpiecesMiddleware,\n    ) {}\n\n    /**\n     * Initialize the server asynchronously.\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 appOverrides - Optional ContainerModule for app test overrides (loaded LAST)\n     */\n    async initialize(\n        webpiecesContainer: Container,\n        appOverrides?: ContainerModule\n    ): Promise<void> {\n        if (this.initialized) {\n            return;\n        }\n\n        this.webpiecesContainer = webpiecesContainer;\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(appOverrides);\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 appOverrides - Optional ContainerModule for app test overrides (loaded LAST to override bindings)\n     */\n    private async loadDIModules(appOverrides?: 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 appOverrides LAST so they can override existing bindings\n        if (appOverrides) {\n            await this.appContainer.load(appOverrides);\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: CORS for localhost development\n        this.app.use(this.middleware.corsForLocalhost());\n\n        // Layer 3: 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>(SaveApi);\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 endpoints from the API prototype using @ApiPath/@Endpoint decorators\n        const basePath = getApiPath(apiPrototype) || '';\n        const endpoints = getEndpoints(apiPrototype) || {};\n\n        // Create proxy object\n        const proxy: Record<string, unknown> = {};\n\n        // Loop over API endpoints and create proxy functions\n        for (const [methodName, endpointPath] of Object.entries(endpoints)) {\n            const httpMethod = 'POST';\n            const path = basePath + endpointPath;\n\n            const authMeta = getAuthMeta(apiPrototype, methodName);\n            const routeMeta = new RouteMetadata(httpMethod, path, methodName, apiPrototype.name, authMeta);\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            // IMPORTANT: Tests MUST wrap calls in RequestContext.run() themselves\n            // This forces explicit context setup in tests, matching production behavior\n            proxy[methodName] = async (requestDto: unknown): Promise<unknown> => {\n                // Verify we're inside an active RequestContext\n                // This helps test authors know they need to wrap their test in RequestContext.run()\n                if (!RequestContext.isActive()) {\n                    //Many devs may not activate headers\n                    return RequestContext.run(async () => {\n                        return await this.runMethod(routeMeta, requestDto, service);\n                    });\n                }\n                return await this.runMethod(routeMeta, requestDto, service);\n            };\n        }\n\n        return proxy as T;\n    }\n\n    private async runMethod(routeMeta: RouteMetadata, requestDto: unknown, service: Service<MethodMeta, WpResponse<unknown>>) {\n        // Create MethodMeta without headers (test mode - no HTTP involved)\n        // requestHeaders is optional, so we can omit it\n        const meta = new MethodMeta(routeMeta, undefined, requestDto);\n        const responseWrapper = await service.invoke(meta);\n        return responseWrapper.response;\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} from 'express';\nimport {Container, ContainerModule, inject, injectable} from 'inversify';\nimport {buildProviderModule} from '@inversifyjs/binding-decorators';\nimport {\n    provideSingleton,\n    RouteBuilderImpl,\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n} from '@webpieces/http-routing';\nimport {WebpiecesServer} from './WebpiecesServer';\nimport {WebpiecesMiddleware} from './WebpiecesMiddleware';\nimport {WebpiecesRouteCreator} from './WebpiecesRouteCreator';\nimport {InProcessApiClientFactory} from './InProcessApiClientFactory';\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 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(WEBAPP_META_TOKEN) private meta: WebAppMeta,\n        @inject(RouteBuilderImpl) private routeBuilder: RouteBuilderImpl,\n        @inject(WebpiecesMiddleware) private middleware: WebpiecesMiddleware,\n    ) {}\n\n    /**\n     * Initialize the server asynchronously.\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 appOverrides - Optional ContainerModule for app test overrides (loaded LAST)\n     */\n    async initialize(\n        webpiecesContainer: Container,\n        appOverrides?: ContainerModule\n    ): Promise<void> {\n        if (this.initialized) {\n            return;\n        }\n\n        this.webpiecesContainer = webpiecesContainer;\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(appOverrides);\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 appOverrides - Optional ContainerModule for app test overrides (loaded LAST to override bindings)\n     */\n    private async loadDIModules(appOverrides?: 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 appOverrides LAST so they can override existing bindings\n        if (appOverrides) {\n            await this.appContainer.load(appOverrides);\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: CORS for localhost development\n        this.app.use(this.middleware.corsForLocalhost());\n\n        // Layer 3: Request/Response Logging\n        this.app.use(this.middleware.logNextLayer.bind(this.middleware));\n\n        // Register routes via the shared adapter (same code path as the\n        // embeddable WebpiecesRouteCreator used by legacy Express apps)\n        const routeCreator = new WebpiecesRouteCreator(\n            this.app,\n            this.appContainer,\n            this.routeBuilder,\n            this.middleware,\n        );\n        const routeCount = routeCreator.mountRegisteredRoutes();\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     * 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>(SaveApi);\n     * const response = await saveApi.save(request);\n     * ```\n     */\n    // webpieces-disable no-any-unknown -- abstract constructor signature requires any[] args\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        // Delegates to the shared factory (same code path as WebpiecesRouteCreator.createApiClient)\n        if (!this.clientFactory) {\n            this.clientFactory = new InProcessApiClientFactory(this.routeBuilder);\n        }\n        return this.clientFactory.createApiClient(apiPrototype);\n    }\n\n    private clientFactory?: InProcessApiClientFactory;\n}\n"]}

package/src/filters/ContextFilter.d.ts

@@ -1,6 +1,6 @@
 import { MethodMeta } from '@webpieces/http-routing';
 import { Filter, WpResponse, Service } from '@webpieces/http-filters';
-import { PlatformHeadersExtension, HeaderMethods } from '@webpieces/http-api';
+import { HeaderRegistry } from '@webpieces/http-api';
 /**
  * ContextFilter - Transfers platform headers and stores request metadata in RequestContext.
  * Priority: 2000 (executes first in filter chain)
@@ -21,8 +21,8 @@ import { PlatformHeadersExtension, HeaderMethods } from '@webpieces/http-api';
  * 7. Context auto-clears when RequestContext.run() completes
  */
 export declare class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {
-    private headerMethods;
-    constructor(extensions: PlatformHeadersExtension[] | undefined, headerMethods: HeaderMethods);
+    private transferredHeaders;
+    constructor(registry: HeaderRegistry);
     filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
     /**
      * Transfer platform headers from MethodMeta.requestHeaders to RequestContext.

package/src/filters/ContextFilter.js

@@ -29,17 +29,13 @@ const ContextKeys_1 = require("../headers/ContextKeys");
  * 7. Context auto-clears when RequestContext.run() completes
  */
 let ContextFilter = class ContextFilter extends http_filters_1.Filter {
-    headerMethods;
-    constructor(extensions = [], headerMethods) {
+    transferredHeaders;
+    constructor(registry) {
         super();
-        // Flatten all headers from all extensions
-        const allHeaders = [];
-        for (const extension of extensions) {
-            allHeaders.push(...extension.getHeaders());
-        }
-        // Create HeaderMethods helper with flattened headers
-        this.headerMethods = headerMethods.findTransferHeaders(allHeaders);
-        console.log(`[ContextFilter] Collected ${allHeaders.length} platform headers from ${extensions.length} extensions`);
+        // The registry is the single source of truth (all modules' extensions,
+        // duplicate-validated at startup)
+        this.transferredHeaders = registry.getTransferredHeaders();
+        console.log(`[ContextFilter] Using ${registry.getHeaders().length} platform headers from HeaderRegistry (${this.transferredHeaders.length} transferred)`);
     }
     async filter(meta, nextFilter) {
         // Transfer platform headers from MethodMeta.requestHeaders to RequestContext
@@ -63,7 +59,7 @@ let ContextFilter = class ContextFilter extends http_filters_1.Filter {
             return;
         }
         // Transfer each header to RequestContext using RequestContext.putHeader()
-        for (const header of this.headerMethods) {
+        for (const header of this.transferredHeaders) {
             // Get values from requestHeaders (case-insensitive lookup)
             const values = meta.requestHeaders.get(header.headerName.toLowerCase());
             if (values && values.length > 0) {
@@ -98,9 +94,7 @@ exports.ContextFilter = ContextFilter;
 exports.ContextFilter = ContextFilter = tslib_1.__decorate([
     (0, http_routing_1.provideSingleton)(),
     (0, inversify_1.injectable)(),
-    tslib_1.__param(0, (0, inversify_1.multiInject)(http_api_1.HEADER_TYPES.PlatformHeadersExtension)),
-    tslib_1.__param(0, (0, inversify_1.optional)()),
-    tslib_1.__param(1, (0, inversify_1.inject)(http_api_1.HeaderMethods)),
-    tslib_1.__metadata("design:paramtypes", [Array, http_api_1.HeaderMethods])
+    tslib_1.__param(0, (0, inversify_1.inject)(http_api_1.HeaderRegistry)),
+    tslib_1.__metadata("design:paramtypes", [http_api_1.HeaderRegistry])
 ], ContextFilter);
 //# sourceMappingURL=ContextFilter.js.map

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":"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","sourcesContent":["import {inject, injectable, multiInject, optional} from 'inversify';\nimport { provideSingleton, MethodMeta } from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport { PlatformHeader, PlatformHeadersExtension, HeaderMethods, HEADER_TYPES } from '@webpieces/http-api';\nimport {WebpiecesCoreHeaders} from \"../headers/WebpiecesCoreHeaders\";\nimport {ContextKeys} from \"../headers/ContextKeys\";\n\n/**\n * ContextFilter - Transfers platform headers and stores request metadata in RequestContext.\n * Priority: 2000 (executes first in filter chain)\n *\n * NEW: Now handles header transfer from RouterRequest to RequestContext\n * - Injects PlatformHeadersExtension instances via @multiInject (safe because filter created after modules load)\n * - Reads headers from RouterRequest (Express-independent)\n * - Transfers only headers marked with isWantTransferred=true\n * - Generates REQUEST_ID if not present\n *\n * RequestContext lifecycle:\n * 1. ExpressWrapper.execute() calls RequestContext.run() (establishes context)\n * 2. ExpressWrapper creates RouterReqResp and MethodMeta\n * 3. Filter chain executes, starting with ContextFilter\n * 4. ContextFilter transfers headers from RouterRequest to RequestContext\n * 5. ContextFilter stores metadata (METHOD_META, REQUEST_PATH, HTTP_METHOD)\n * 6. Downstream filters and controller can access headers + metadata\n * 7. Context auto-clears when RequestContext.run() completes\n */\n@provideSingleton()\n@injectable()\nexport class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    private headerMethods: PlatformHeader[];\n\n    constructor(\n        @multiInject(HEADER_TYPES.PlatformHeadersExtension) @optional()\n        extensions: PlatformHeadersExtension[] = [],\n        @inject(HeaderMethods) headerMethods: HeaderMethods\n    ) {\n        super();\n\n        // Flatten all headers from all extensions\n        const allHeaders: PlatformHeader[] = [];\n        for (const extension of extensions) {\n            allHeaders.push(...extension.getHeaders());\n        }\n\n        // Create HeaderMethods helper with flattened headers\n        this.headerMethods = headerMethods.findTransferHeaders(allHeaders);\n\n        console.log(`[ContextFilter] Collected ${allHeaders.length} platform headers from ${extensions.length} extensions`);\n    }\n\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Transfer platform headers from MethodMeta.requestHeaders to RequestContext\n        this.transferHeaders(meta);\n\n        // Store request metadata in context for other filters/controllers to access\n        RequestContext.putHeader(ContextKeys.METHOD_META, meta);\n        RequestContext.putHeader(ContextKeys.REQUEST_PATH, meta.path);\n        RequestContext.putHeader(ContextKeys.HTTP_METHOD, meta.httpMethod);\n\n        // Execute next filter/controller\n        return await nextFilter.invoke(meta);\n        // RequestContext is auto-cleared by ExpressWrapper when request completes\n    }\n\n    /**\n     * Transfer platform headers from MethodMeta.requestHeaders to RequestContext.\n     * Uses HeaderMethods.findTransferHeaders() to filter by isWantTransferred=true.\n     */\n    private transferHeaders(meta: MethodMeta): void {\n        if (!meta.requestHeaders) {\n            // No headers in test mode (createApiClient creates context but not headers)\n            this.ensureRequestId();\n            return;\n        }\n\n        // Transfer each header to RequestContext using RequestContext.putHeader()\n        for (const header of this.headerMethods) {\n            // Get values from requestHeaders (case-insensitive lookup)\n            const values = meta.requestHeaders.get(header.headerName.toLowerCase());\n            if (values && values.length > 0) {\n                // Use RequestContext.putHeader() which calls header.getHeaderName()\n                RequestContext.putHeader(header, values[0]);\n            }\n        }\n\n        // Clear request headers from MethodMeta - MUST FORCE USAGE of RequestContext!!!\n        meta.requestHeaders = undefined;\n\n        // Generate REQUEST_ID if not present (first service in chain)\n        this.ensureRequestId();\n    }\n\n    /**\n     * Ensure REQUEST_ID is set in RequestContext.\n     * Generates one if not present.\n     */\n    private ensureRequestId(): void {\n        if (!RequestContext.hasHeader(WebpiecesCoreHeaders.REQUEST_ID)) {\n            const requestId = this.generateRequestId();\n            RequestContext.putHeader(WebpiecesCoreHeaders.REQUEST_ID, requestId);\n        }\n    }\n\n    /**\n     * Generate a unique request ID.\n     * Format: req-{timestamp}-{random}\n     */\n    private generateRequestId(): string {\n        return `svrGenReqId-${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;\n    }\n}\n\n"]}
+{"version":3,"file":"ContextFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/ContextFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAA6C;AAC7C,0DAAuE;AACvE,0DAAyD;AACzD,0DAAsE;AACtE,kDAAqE;AACrE,0EAAqE;AACrE,wDAAmD;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,qBAAuC;IAC9D,kBAAkB,CAAmB;IAE7C,YAC4B,QAAwB;QAEhD,KAAK,EAAE,CAAC;QAER,uEAAuE;QACvE,kCAAkC;QAClC,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QAE3D,OAAO,CAAC,GAAG,CAAC,yBAAyB,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,0CAA0C,IAAI,CAAC,kBAAkB,CAAC,MAAM,eAAe,CAAC,CAAC;IAC9J,CAAC;IAED,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,6EAA6E;QAC7E,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3B,4EAA4E;QAC5E,6BAAc,CAAC,SAAS,CAAC,yBAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACxD,6BAAc,CAAC,SAAS,CAAC,yBAAW,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,6BAAc,CAAC,SAAS,CAAC,yBAAW,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnE,iCAAiC;QACjC,OAAO,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,0EAA0E;IAC9E,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,IAAgB;QACpC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvB,4EAA4E;YAC5E,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO;QACX,CAAC;QAED,0EAA0E;QAC1E,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC3C,2DAA2D;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YACxE,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,oEAAoE;gBACpE,6BAAc,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;QACL,CAAC;QAED,gFAAgF;QAChF,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,8DAA8D;QAC9D,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACK,eAAe;QACnB,IAAI,CAAC,6BAAc,CAAC,SAAS,CAAC,2CAAoB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3C,6BAAc,CAAC,SAAS,CAAC,2CAAoB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACzE,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,iBAAiB;QACrB,OAAO,eAAe,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACtF,CAAC;CACJ,CAAA;AA9EY,sCAAa;wBAAb,aAAa;IAFzB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;IAKJ,mBAAA,IAAA,kBAAM,EAAC,yBAAc,CAAC,CAAA;6CAAW,yBAAc;GAJ3C,aAAa,CA8EzB","sourcesContent":["import {inject, injectable} from 'inversify';\nimport { provideSingleton, MethodMeta } from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport { PlatformHeader, HeaderRegistry } from '@webpieces/http-api';\nimport {WebpiecesCoreHeaders} from \"../headers/WebpiecesCoreHeaders\";\nimport {ContextKeys} from \"../headers/ContextKeys\";\n\n/**\n * ContextFilter - Transfers platform headers and stores request metadata in RequestContext.\n * Priority: 2000 (executes first in filter chain)\n *\n * NEW: Now handles header transfer from RouterRequest to RequestContext\n * - Injects PlatformHeadersExtension instances via @multiInject (safe because filter created after modules load)\n * - Reads headers from RouterRequest (Express-independent)\n * - Transfers only headers marked with isWantTransferred=true\n * - Generates REQUEST_ID if not present\n *\n * RequestContext lifecycle:\n * 1. ExpressWrapper.execute() calls RequestContext.run() (establishes context)\n * 2. ExpressWrapper creates RouterReqResp and MethodMeta\n * 3. Filter chain executes, starting with ContextFilter\n * 4. ContextFilter transfers headers from RouterRequest to RequestContext\n * 5. ContextFilter stores metadata (METHOD_META, REQUEST_PATH, HTTP_METHOD)\n * 6. Downstream filters and controller can access headers + metadata\n * 7. Context auto-clears when RequestContext.run() completes\n */\n@provideSingleton()\n@injectable()\nexport class ContextFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    private transferredHeaders: PlatformHeader[];\n\n    constructor(\n        @inject(HeaderRegistry) registry: HeaderRegistry\n    ) {\n        super();\n\n        // The registry is the single source of truth (all modules' extensions,\n        // duplicate-validated at startup)\n        this.transferredHeaders = registry.getTransferredHeaders();\n\n        console.log(`[ContextFilter] Using ${registry.getHeaders().length} platform headers from HeaderRegistry (${this.transferredHeaders.length} transferred)`);\n    }\n\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Transfer platform headers from MethodMeta.requestHeaders to RequestContext\n        this.transferHeaders(meta);\n\n        // Store request metadata in context for other filters/controllers to access\n        RequestContext.putHeader(ContextKeys.METHOD_META, meta);\n        RequestContext.putHeader(ContextKeys.REQUEST_PATH, meta.path);\n        RequestContext.putHeader(ContextKeys.HTTP_METHOD, meta.httpMethod);\n\n        // Execute next filter/controller\n        return await nextFilter.invoke(meta);\n        // RequestContext is auto-cleared by ExpressWrapper when request completes\n    }\n\n    /**\n     * Transfer platform headers from MethodMeta.requestHeaders to RequestContext.\n     * Uses HeaderMethods.findTransferHeaders() to filter by isWantTransferred=true.\n     */\n    private transferHeaders(meta: MethodMeta): void {\n        if (!meta.requestHeaders) {\n            // No headers in test mode (createApiClient creates context but not headers)\n            this.ensureRequestId();\n            return;\n        }\n\n        // Transfer each header to RequestContext using RequestContext.putHeader()\n        for (const header of this.transferredHeaders) {\n            // Get values from requestHeaders (case-insensitive lookup)\n            const values = meta.requestHeaders.get(header.headerName.toLowerCase());\n            if (values && values.length > 0) {\n                // Use RequestContext.putHeader() which calls header.getHeaderName()\n                RequestContext.putHeader(header, values[0]);\n            }\n        }\n\n        // Clear request headers from MethodMeta - MUST FORCE USAGE of RequestContext!!!\n        meta.requestHeaders = undefined;\n\n        // Generate REQUEST_ID if not present (first service in chain)\n        this.ensureRequestId();\n    }\n\n    /**\n     * Ensure REQUEST_ID is set in RequestContext.\n     * Generates one if not present.\n     */\n    private ensureRequestId(): void {\n        if (!RequestContext.hasHeader(WebpiecesCoreHeaders.REQUEST_ID)) {\n            const requestId = this.generateRequestId();\n            RequestContext.putHeader(WebpiecesCoreHeaders.REQUEST_ID, requestId);\n        }\n    }\n\n    /**\n     * Generate a unique request ID.\n     * Format: req-{timestamp}-{random}\n     */\n    private generateRequestId(): string {\n        return `svrGenReqId-${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;\n    }\n}\n\n"]}

package/src/filters/LogApiFilter.d.ts

@@ -1,6 +1,6 @@
 import { MethodMeta } from '@webpieces/http-routing';
 import { Filter, WpResponse, Service } from '@webpieces/http-filters';
-import { PlatformHeadersExtension, HeaderMethods } from '@webpieces/http-api';
+import { HeaderMethods, HeaderRegistry } from '@webpieces/http-api';
 /**
  * LogApiFilter - Structured API logging for all requests/responses.
  * Priority: 1800 (after ContextFilter at 2000, before custom filters)
@@ -21,6 +21,6 @@ export declare class LogApiFilter extends Filter<MethodMeta, WpResponse<unknown>
     private headerMethods;
     private logApiCall;
     private allHeaders;
-    constructor(extensions: PlatformHeadersExtension[] | undefined, headerMethods: HeaderMethods);
+    constructor(registry: HeaderRegistry, headerMethods: HeaderMethods);
     filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
 }

package/src/filters/LogApiFilter.js

@@ -26,15 +26,13 @@ let LogApiFilter = class LogApiFilter extends http_filters_1.Filter {
     headerMethods;
     logApiCall;
     allHeaders;
-    constructor(extensions = [], headerMethods) {
+    constructor(registry, headerMethods) {
         super();
         this.headerMethods = headerMethods;
-        // Flatten all headers from all extensions
-        this.allHeaders = [];
-        for (const extension of extensions) {
-            this.allHeaders.push(...extension.getHeaders());
-        }
-        console.log(`[LogApiFilter] Collected ${this.allHeaders.length} platform headers from ${extensions.length} extensions`);
+        // The registry is the single source of truth (all modules' extensions,
+        // duplicate-validated at startup). Log map keys use loggerMdcKey when set.
+        this.allHeaders = registry.getHeaders();
+        console.log(`[LogApiFilter] Using ${this.allHeaders.length} platform headers from HeaderRegistry`);
         this.logApiCall = new http_api_1.LogApiCall();
     }
     async filter(meta, nextFilter) {
@@ -54,9 +52,9 @@ exports.LogApiFilter = LogApiFilter;
 exports.LogApiFilter = LogApiFilter = tslib_1.__decorate([
     (0, http_routing_1.provideSingleton)(),
     (0, inversify_1.injectable)(),
-    tslib_1.__param(0, (0, inversify_1.multiInject)(http_api_1.HEADER_TYPES.PlatformHeadersExtension)),
-    tslib_1.__param(0, (0, inversify_1.optional)()),
+    tslib_1.__param(0, (0, inversify_1.inject)(http_api_1.HeaderRegistry)),
     tslib_1.__param(1, (0, inversify_1.inject)(http_api_1.HeaderMethods)),
-    tslib_1.__metadata("design:paramtypes", [Array, http_api_1.HeaderMethods])
+    tslib_1.__metadata("design:paramtypes", [http_api_1.HeaderRegistry,
+        http_api_1.HeaderMethods])
 ], LogApiFilter);
 //# sourceMappingURL=LogApiFilter.js.map

package/src/filters/LogApiFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"LogApiFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/LogApiFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAoE;AACpE,0DAA2F;AAC3F,0DAAsE;AACtE,kDAM6B;AAE7B;;;;;;;;;;;;;;;GAeG;AAGI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,qBAAuC;IAOlC;IAN3B,UAAU,CAAa;IACvB,UAAU,CAAmB;IAErC,YAEI,aAAyC,EAAE,EACZ,aAA4B;QAE3D,KAAK,EAAE,CAAC;QAFuB,kBAAa,GAAb,aAAa,CAAe;QAI3D,0CAA0C;QAC1C,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,UAAU,CAAC,MAAM,0BAA0B,UAAU,CAAC,MAAM,aAAa,CAAC,CAAC;QAExH,IAAI,CAAC,UAAU,GAAG,IAAI,qBAAU,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,0FAA0F;QAC1F,MAAM,aAAa,GAAG,IAAI,mCAAoB,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAEzF,+DAA+D;QAC/D,MAAM,MAAM,GAAG,KAAK,IAAsB,EAAE;YACxC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACxG,OAAO,IAAI,yBAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACJ,CAAA;AAvCY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;IAMJ,mBAAA,IAAA,uBAAW,EAAC,uBAAY,CAAC,wBAAwB,CAAC,CAAA;IAAE,mBAAA,IAAA,oBAAQ,GAAE,CAAA;IAE9D,mBAAA,IAAA,kBAAM,EAAC,wBAAa,CAAC,CAAA;oDAAwB,wBAAa;GAPtD,YAAY,CAuCxB","sourcesContent":["import {inject, injectable, multiInject, optional} from 'inversify';\nimport {provideSingleton, MethodMeta, RequestContextReader} from '@webpieces/http-routing';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport {\n    PlatformHeader,\n    PlatformHeadersExtension,\n    HeaderMethods,\n    HEADER_TYPES,\n    LogApiCall,\n} from '@webpieces/http-api';\n\n/**\n * LogApiFilter - Structured API logging for all requests/responses.\n * Priority: 1800 (after ContextFilter at 2000, before custom filters)\n *\n * Logging patterns (via LogApiCall):\n * - [API-SVR-req] Class.method /url request={...} headers={...}\n * - [API-SVR-resp-SUCCESS] Class.method response={...}\n * - [API-SVR-resp-FAIL] Class.method error=... (server errors: 500, 502, 504)\n * - [API-SVR-resp-OTHER] Class.method errorType=... (user errors: 400, 401, 403, 404, 266)\n *\n * Headers are read from RequestContext (NOT from meta.requestHeaders which is undefined\n * after ContextFilter runs at priority 2000).\n *\n * User errors (HttpBadRequestError, etc.) are logged as OTHER, not FAIL,\n * because they are expected behavior from the server's perspective.\n */\n@provideSingleton()\n@injectable()\nexport class LogApiFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    private logApiCall: LogApiCall;\n    private allHeaders: PlatformHeader[];\n\n    constructor(\n        @multiInject(HEADER_TYPES.PlatformHeadersExtension) @optional()\n        extensions: PlatformHeadersExtension[] = [],\n        @inject(HeaderMethods) private headerMethods: HeaderMethods\n    ) {\n        super();\n\n        // Flatten all headers from all extensions\n        this.allHeaders = [];\n        for (const extension of extensions) {\n            this.allHeaders.push(...extension.getHeaders());\n        }\n\n        console.log(`[LogApiFilter] Collected ${this.allHeaders.length} platform headers from ${extensions.length} extensions`);\n\n        this.logApiCall = new LogApiCall();\n    }\n\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Build header map from RequestContext (headers are already transferred by ContextFilter)\n        const contextReader = new RequestContextReader();\n        const headers = this.headerMethods.buildSecureMapForLogs(this.allHeaders, contextReader);\n\n        // Wrap nextFilter.invoke in a method that returns the response\n        const method = async (): Promise<unknown> => {\n            const wpResponse = await nextFilter.invoke(meta);\n            return wpResponse.response;\n        };\n\n        const response = await this.logApiCall.execute(\"SVR\", meta.routeMeta, meta.requestDto, headers, method);\n        return new WpResponse(response);\n    }\n}\n"]}
+{"version":3,"file":"LogApiFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/LogApiFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAA6C;AAC7C,0DAA2F;AAC3F,0DAAsE;AACtE,kDAK6B;AAE7B;;;;;;;;;;;;;;;GAeG;AAGI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,qBAAuC;IAMlC;IAL3B,UAAU,CAAa;IACvB,UAAU,CAAmB;IAErC,YAC4B,QAAwB,EACjB,aAA4B;QAE3D,KAAK,EAAE,CAAC;QAFuB,kBAAa,GAAb,aAAa,CAAe;QAI3D,uEAAuE;QACvE,2EAA2E;QAC3E,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;QAExC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,UAAU,CAAC,MAAM,uCAAuC,CAAC,CAAC;QAEnG,IAAI,CAAC,UAAU,GAAG,IAAI,qBAAU,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,0FAA0F;QAC1F,MAAM,aAAa,GAAG,IAAI,mCAAoB,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAEzF,+DAA+D;QAC/D,MAAM,MAAM,GAAG,KAAK,IAAsB,EAAE;YACxC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACxG,OAAO,IAAI,yBAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACJ,CAAA;AApCY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;IAMJ,mBAAA,IAAA,kBAAM,EAAC,yBAAc,CAAC,CAAA;IACtB,mBAAA,IAAA,kBAAM,EAAC,wBAAa,CAAC,CAAA;6CADY,yBAAc;QACF,wBAAa;GANtD,YAAY,CAoCxB","sourcesContent":["import {inject, injectable} from 'inversify';\nimport {provideSingleton, MethodMeta, RequestContextReader} from '@webpieces/http-routing';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport {\n    PlatformHeader,\n    HeaderMethods,\n    HeaderRegistry,\n    LogApiCall,\n} from '@webpieces/http-api';\n\n/**\n * LogApiFilter - Structured API logging for all requests/responses.\n * Priority: 1800 (after ContextFilter at 2000, before custom filters)\n *\n * Logging patterns (via LogApiCall):\n * - [API-SVR-req] Class.method /url request={...} headers={...}\n * - [API-SVR-resp-SUCCESS] Class.method response={...}\n * - [API-SVR-resp-FAIL] Class.method error=... (server errors: 500, 502, 504)\n * - [API-SVR-resp-OTHER] Class.method errorType=... (user errors: 400, 401, 403, 404, 266)\n *\n * Headers are read from RequestContext (NOT from meta.requestHeaders which is undefined\n * after ContextFilter runs at priority 2000).\n *\n * User errors (HttpBadRequestError, etc.) are logged as OTHER, not FAIL,\n * because they are expected behavior from the server's perspective.\n */\n@provideSingleton()\n@injectable()\nexport class LogApiFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    private logApiCall: LogApiCall;\n    private allHeaders: PlatformHeader[];\n\n    constructor(\n        @inject(HeaderRegistry) registry: HeaderRegistry,\n        @inject(HeaderMethods) private headerMethods: HeaderMethods\n    ) {\n        super();\n\n        // The registry is the single source of truth (all modules' extensions,\n        // duplicate-validated at startup). Log map keys use loggerMdcKey when set.\n        this.allHeaders = registry.getHeaders();\n\n        console.log(`[LogApiFilter] Using ${this.allHeaders.length} platform headers from HeaderRegistry`);\n\n        this.logApiCall = new LogApiCall();\n    }\n\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        // Build header map from RequestContext (headers are already transferred by ContextFilter)\n        const contextReader = new RequestContextReader();\n        const headers = this.headerMethods.buildSecureMapForLogs(this.allHeaders, contextReader);\n\n        // Wrap nextFilter.invoke in a method that returns the response\n        const method = async (): Promise<unknown> => {\n            const wpResponse = await nextFilter.invoke(meta);\n            return wpResponse.response;\n        };\n\n        const response = await this.logApiCall.execute(\"SVR\", meta.routeMeta, meta.requestDto, headers, method);\n        return new WpResponse(response);\n    }\n}\n"]}

package/src/filters/RecordingFilter.d.ts

@@ -0,0 +1,30 @@
+import { MethodMeta, WebpiecesConfig } from '@webpieces/http-routing';
+import { Filter, WpResponse, Service } from '@webpieces/http-filters';
+import { HeaderRegistry } from '@webpieces/http-api';
+/**
+ * RecordingFilter - Records a request as a replayable test case (port of Java
+ * RecordingFilter).
+ *
+ * Suggested priority: 1850 (after ContextFilter 2000 so the RECORDING header
+ * has been transferred to the context, after AuthFilter 1900 so only real
+ * authorized flows are recorded, before LogApiFilter 1800).
+ *
+ * Activates when WebpiecesConfig.recordingAlwaysOn is set OR the request
+ * carries WebpiecesCoreHeaders.RECORDING (x-webpieces-recording). While
+ * active, a TestCaseRecorderImpl travels in the RequestContext under
+ * RecorderKeys.RECORDER; the http-client proxy and recordable() wrappers add
+ * every downstream call. On completion the fixture + generated spec are
+ * logged (and written to config.recordingDir when set).
+ *
+ * Recording NEVER alters the response - failures inside the recorder are
+ * caught and logged.
+ */
+export declare class RecordingFilter extends Filter<MethodMeta, WpResponse<unknown>> {
+    private config;
+    private registry;
+    private headerMethods;
+    constructor(config: WebpiecesConfig, registry: HeaderRegistry);
+    filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
+    private isRecordingRequested;
+    private buildServerEndpoint;
+}

package/src/filters/RecordingFilter.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecordingFilter = 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");
+const http_api_1 = require("@webpieces/http-api");
+const TestCaseRecorderImpl_1 = require("../recorder/TestCaseRecorderImpl");
+/**
+ * RecordingFilter - Records a request as a replayable test case (port of Java
+ * RecordingFilter).
+ *
+ * Suggested priority: 1850 (after ContextFilter 2000 so the RECORDING header
+ * has been transferred to the context, after AuthFilter 1900 so only real
+ * authorized flows are recorded, before LogApiFilter 1800).
+ *
+ * Activates when WebpiecesConfig.recordingAlwaysOn is set OR the request
+ * carries WebpiecesCoreHeaders.RECORDING (x-webpieces-recording). While
+ * active, a TestCaseRecorderImpl travels in the RequestContext under
+ * RecorderKeys.RECORDER; the http-client proxy and recordable() wrappers add
+ * every downstream call. On completion the fixture + generated spec are
+ * logged (and written to config.recordingDir when set).
+ *
+ * Recording NEVER alters the response - failures inside the recorder are
+ * caught and logged.
+ */
+let RecordingFilter = class RecordingFilter extends http_filters_1.Filter {
+    config;
+    registry;
+    headerMethods = new http_api_1.HeaderMethods();
+    constructor(config, registry) {
+        super();
+        this.config = config;
+        this.registry = registry;
+    }
+    // webpieces-disable no-any-unknown -- Filter generic params use unknown for response type flexibility
+    async filter(meta, nextFilter) {
+        if (!this.isRecordingRequested()) {
+            return await nextFilter.invoke(meta);
+        }
+        const recorder = new TestCaseRecorderImpl_1.TestCaseRecorderImpl();
+        core_context_1.RequestContext.putHeader(http_api_1.RecorderKeys.RECORDER, recorder);
+        const serverEndpoint = this.buildServerEndpoint(meta);
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- capture failure into the recording, then rethrow unchanged
+        try {
+            const response = await nextFilter.invoke(meta);
+            serverEndpoint.successResponse = response.response;
+            return response;
+        }
+        catch (err) {
+            const error = (0, http_api_1.toError)(err);
+            serverEndpoint.failureResponse = new http_api_1.RecordedError(error.name, error.message);
+            throw err;
+        }
+        finally {
+            core_context_1.RequestContext.remove(http_api_1.RecorderKeys.RECORDER.getHeaderName());
+            recorder.spitOutTestCase(serverEndpoint, this.config.recordingDir);
+        }
+    }
+    isRecordingRequested() {
+        if (this.config.recordingAlwaysOn) {
+            return true;
+        }
+        // ContextFilter (priority 2000) already transferred the header into context
+        return core_context_1.RequestContext.hasHeader(http_api_1.WebpiecesCoreHeaders.RECORDING);
+    }
+    buildServerEndpoint(meta) {
+        // Masked snapshot of the magic context (secured values masked, MDC keys)
+        const logMap = this.headerMethods.buildSecureMapForLogs(this.registry.getHeaders(), new http_routing_1.RequestContextReader());
+        const ctxSnapshot = {};
+        for (const entry of logMap.entries()) {
+            ctxSnapshot[entry[0]] = entry[1];
+        }
+        const apiName = meta.routeMeta.controllerClassName ?? 'UnknownController';
+        return new http_api_1.RecordedEndpoint(apiName, meta.methodName, [meta.requestDto], ctxSnapshot);
+    }
+};
+exports.RecordingFilter = RecordingFilter;
+exports.RecordingFilter = RecordingFilter = tslib_1.__decorate([
+    (0, http_routing_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+    // webpieces-disable no-any-unknown -- Filter generic params use unknown for response type flexibility
+    ,
+    tslib_1.__param(0, (0, inversify_1.inject)(http_routing_1.WEBPIECES_CONFIG_TOKEN)),
+    tslib_1.__param(1, (0, inversify_1.inject)(http_api_1.HeaderRegistry)),
+    tslib_1.__metadata("design:paramtypes", [http_routing_1.WebpiecesConfig,
+        http_api_1.HeaderRegistry])
+], RecordingFilter);
+//# sourceMappingURL=RecordingFilter.js.map

package/src/filters/RecordingFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/RecordingFilter.ts"],"names":[],"mappings":"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","sourcesContent":["import { inject, injectable } from 'inversify';\nimport {\n    provideSingleton,\n    MethodMeta,\n    RequestContextReader,\n    WebpiecesConfig,\n    WEBPIECES_CONFIG_TOKEN,\n} from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport {\n    HeaderMethods,\n    HeaderRegistry,\n    RecordedEndpoint,\n    RecordedError,\n    RecorderKeys,\n    WebpiecesCoreHeaders,\n    toError,\n} from '@webpieces/http-api';\nimport { TestCaseRecorderImpl } from '../recorder/TestCaseRecorderImpl';\n\n/**\n * RecordingFilter - Records a request as a replayable test case (port of Java\n * RecordingFilter).\n *\n * Suggested priority: 1850 (after ContextFilter 2000 so the RECORDING header\n * has been transferred to the context, after AuthFilter 1900 so only real\n * authorized flows are recorded, before LogApiFilter 1800).\n *\n * Activates when WebpiecesConfig.recordingAlwaysOn is set OR the request\n * carries WebpiecesCoreHeaders.RECORDING (x-webpieces-recording). While\n * active, a TestCaseRecorderImpl travels in the RequestContext under\n * RecorderKeys.RECORDER; the http-client proxy and recordable() wrappers add\n * every downstream call. On completion the fixture + generated spec are\n * logged (and written to config.recordingDir when set).\n *\n * Recording NEVER alters the response - failures inside the recorder are\n * caught and logged.\n */\n@provideSingleton()\n@injectable()\n// webpieces-disable no-any-unknown -- Filter generic params use unknown for response type flexibility\nexport class RecordingFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    private headerMethods = new HeaderMethods();\n\n    constructor(\n        @inject(WEBPIECES_CONFIG_TOKEN) private config: WebpiecesConfig,\n        @inject(HeaderRegistry) private registry: HeaderRegistry,\n    ) {\n        super();\n    }\n\n    // webpieces-disable no-any-unknown -- Filter generic params use unknown for response type flexibility\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        if (!this.isRecordingRequested()) {\n            return await nextFilter.invoke(meta);\n        }\n\n        const recorder = new TestCaseRecorderImpl();\n        RequestContext.putHeader(RecorderKeys.RECORDER, recorder);\n\n        const serverEndpoint = this.buildServerEndpoint(meta);\n\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- capture failure into the recording, then rethrow unchanged\n        try {\n            const response = await nextFilter.invoke(meta);\n            serverEndpoint.successResponse = response.response;\n            return response;\n        } catch (err: unknown) {\n            const error = toError(err);\n            serverEndpoint.failureResponse = new RecordedError(error.name, error.message);\n            throw err;\n        } finally {\n            RequestContext.remove(RecorderKeys.RECORDER.getHeaderName());\n            recorder.spitOutTestCase(serverEndpoint, this.config.recordingDir);\n        }\n    }\n\n    private isRecordingRequested(): boolean {\n        if (this.config.recordingAlwaysOn) {\n            return true;\n        }\n        // ContextFilter (priority 2000) already transferred the header into context\n        return RequestContext.hasHeader(WebpiecesCoreHeaders.RECORDING);\n    }\n\n    private buildServerEndpoint(meta: MethodMeta): RecordedEndpoint {\n        // Masked snapshot of the magic context (secured values masked, MDC keys)\n        const logMap = this.headerMethods.buildSecureMapForLogs(this.registry.getHeaders(), new RequestContextReader());\n        const ctxSnapshot: Record<string, string> = {};\n        for (const entry of logMap.entries()) {\n            ctxSnapshot[entry[0]] = entry[1];\n        }\n\n        const apiName = meta.routeMeta.controllerClassName ?? 'UnknownController';\n        return new RecordedEndpoint(apiName, meta.methodName, [meta.requestDto], ctxSnapshot);\n    }\n}\n"]}

package/src/headers/WebpiecesCoreHeaders.d.ts

@@ -1,39 +1,6 @@
-import { PlatformHeader } from '@webpieces/http-api';
 /**
- * Core framework headers for distributed tracing and request correlation.
- *
- * These are the minimal headers needed by the WebPieces framework for:
- * - Request tracking across services
- * - Distributed tracing
- * - Request correlation
- * - Metrics and monitoring
- *
- * Pattern inspired by Java MicroSvcHeader enum.
+ * WebpiecesCoreHeaders moved to @webpieces/http-api (browser-safe) so the
+ * http-client can reference REQUEST_ID/PREVIOUS_REQUEST_ID for request-id
+ * chaining. Re-exported here for backward compatibility with existing imports.
  */
-export declare class WebpiecesCoreHeaders {
-    /**
-     * Unique ID for this request.
-     * Generated by the server if not provided.
-     * Used for distributed tracing and log correlation.
-     */
-    static readonly REQUEST_ID: PlatformHeader;
-    /**
-     * ID of the previous request in the call chain.
-     * When service A calls service B, B receives A's REQUEST_ID as PREVIOUS_REQUEST_ID.
-     * Used for building distributed trace trees.
-     */
-    static readonly PREVIOUS_REQUEST_ID: PlatformHeader;
-    /**
-     * Correlation ID that spans multiple related requests.
-     * Typically set by the API gateway or first service in the chain.
-     * All services in the call chain use the same CORRELATION_ID.
-     */
-    static readonly CORRELATION_ID: PlatformHeader;
-    /**
-     * Get all core headers as an array.
-     * Used by WebpiecesModule to bind headers to DI container.
-     *
-     * @returns Array of all core platform headers
-     */
-    static getAllHeaders(): PlatformHeader[];
-}
+export { WebpiecesCoreHeaders } from '@webpieces/http-api';

package/src/headers/WebpiecesCoreHeaders.js

@@ -1,54 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebpiecesCoreHeaders = void 0;
-const http_api_1 = require("@webpieces/http-api");
 /**
- * Core framework headers for distributed tracing and request correlation.
- *
- * These are the minimal headers needed by the WebPieces framework for:
- * - Request tracking across services
- * - Distributed tracing
- * - Request correlation
- * - Metrics and monitoring
- *
- * Pattern inspired by Java MicroSvcHeader enum.
+ * WebpiecesCoreHeaders moved to @webpieces/http-api (browser-safe) so the
+ * http-client can reference REQUEST_ID/PREVIOUS_REQUEST_ID for request-id
+ * chaining. Re-exported here for backward compatibility with existing imports.
  */
-class WebpiecesCoreHeaders {
-    /**
-     * Unique ID for this request.
-     * Generated by the server if not provided.
-     * Used for distributed tracing and log correlation.
-     */
-    static REQUEST_ID = new http_api_1.PlatformHeader('x-request-id', true, // transfer (propagate to downstream services)
-    false, // not secured (it's just an ID)
-    true // use for metrics dimensions
-    );
-    /**
-     * ID of the previous request in the call chain.
-     * When service A calls service B, B receives A's REQUEST_ID as PREVIOUS_REQUEST_ID.
-     * Used for building distributed trace trees.
-     */
-    static PREVIOUS_REQUEST_ID = new http_api_1.PlatformHeader('x-previous-request-id', true, false, false);
-    /**
-     * Correlation ID that spans multiple related requests.
-     * Typically set by the API gateway or first service in the chain.
-     * All services in the call chain use the same CORRELATION_ID.
-     */
-    static CORRELATION_ID = new http_api_1.PlatformHeader('x-correlation-id', true, false, true // use for metrics dimensions
-    );
-    /**
-     * Get all core headers as an array.
-     * Used by WebpiecesModule to bind headers to DI container.
-     *
-     * @returns Array of all core platform headers
-     */
-    static getAllHeaders() {
-        return [
-            WebpiecesCoreHeaders.REQUEST_ID,
-            WebpiecesCoreHeaders.PREVIOUS_REQUEST_ID,
-            WebpiecesCoreHeaders.CORRELATION_ID,
-        ];
-    }
-}
-exports.WebpiecesCoreHeaders = WebpiecesCoreHeaders;
+var http_api_1 = require("@webpieces/http-api");
+Object.defineProperty(exports, "WebpiecesCoreHeaders", { enumerable: true, get: function () { return http_api_1.WebpiecesCoreHeaders; } });
 //# sourceMappingURL=WebpiecesCoreHeaders.js.map

package/src/headers/WebpiecesCoreHeaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebpiecesCoreHeaders.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/headers/WebpiecesCoreHeaders.ts"],"names":[],"mappings":";;;AAAA,kDAAqD;AAErD;;;;;;;;;;GAUG;AACH,MAAa,oBAAoB;IAC7B;;;;OAIG;IACH,MAAM,CAAU,UAAU,GAAG,IAAI,yBAAc,CAC3C,cAAc,EACd,IAAI,EAAG,8CAA8C;IACrD,KAAK,EAAE,gCAAgC;IACvC,IAAI,CAAG,6BAA6B;KACvC,CAAC;IAEF;;;;OAIG;IACH,MAAM,CAAU,mBAAmB,GAAG,IAAI,yBAAc,CACpD,uBAAuB,EACvB,IAAI,EACJ,KAAK,EACL,KAAK,CACR,CAAC;IAEF;;;;OAIG;IACH,MAAM,CAAU,cAAc,GAAG,IAAI,yBAAc,CAC/C,kBAAkB,EAClB,IAAI,EACJ,KAAK,EACL,IAAI,CAAG,6BAA6B;KACvC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,CAAC,aAAa;QAChB,OAAO;YACH,oBAAoB,CAAC,UAAU;YAC/B,oBAAoB,CAAC,mBAAmB;YACxC,oBAAoB,CAAC,cAAc;SACtC,CAAC;IACN,CAAC;;AAjDL,oDAkDC","sourcesContent":["import { PlatformHeader } from '@webpieces/http-api';\n\n/**\n * Core framework headers for distributed tracing and request correlation.\n *\n * These are the minimal headers needed by the WebPieces framework for:\n * - Request tracking across services\n * - Distributed tracing\n * - Request correlation\n * - Metrics and monitoring\n *\n * Pattern inspired by Java MicroSvcHeader enum.\n */\nexport class WebpiecesCoreHeaders {\n    /**\n     * Unique ID for this request.\n     * Generated by the server if not provided.\n     * Used for distributed tracing and log correlation.\n     */\n    static readonly REQUEST_ID = new PlatformHeader(\n        'x-request-id',\n        true,  // transfer (propagate to downstream services)\n        false, // not secured (it's just an ID)\n        true   // use for metrics dimensions\n    );\n\n    /**\n     * ID of the previous request in the call chain.\n     * When service A calls service B, B receives A's REQUEST_ID as PREVIOUS_REQUEST_ID.\n     * Used for building distributed trace trees.\n     */\n    static readonly PREVIOUS_REQUEST_ID = new PlatformHeader(\n        'x-previous-request-id',\n        true,\n        false,\n        false\n    );\n\n    /**\n     * Correlation ID that spans multiple related requests.\n     * Typically set by the API gateway or first service in the chain.\n     * All services in the call chain use the same CORRELATION_ID.\n     */\n    static readonly CORRELATION_ID = new PlatformHeader(\n        'x-correlation-id',\n        true,\n        false,\n        true   // use for metrics dimensions\n    );\n\n    /**\n     * Get all core headers as an array.\n     * Used by WebpiecesModule to bind headers to DI container.\n     *\n     * @returns Array of all core platform headers\n     */\n    static getAllHeaders(): PlatformHeader[] {\n        return [\n            WebpiecesCoreHeaders.REQUEST_ID,\n            WebpiecesCoreHeaders.PREVIOUS_REQUEST_ID,\n            WebpiecesCoreHeaders.CORRELATION_ID,\n        ];\n    }\n}\n"]}
+{"version":3,"file":"WebpiecesCoreHeaders.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/headers/WebpiecesCoreHeaders.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,gDAA2D;AAAlD,gHAAA,oBAAoB,OAAA","sourcesContent":["/**\n * WebpiecesCoreHeaders moved to @webpieces/http-api (browser-safe) so the\n * http-client can reference REQUEST_ID/PREVIOUS_REQUEST_ID for request-id\n * chaining. Re-exported here for backward compatibility with existing imports.\n */\nexport { WebpiecesCoreHeaders } from '@webpieces/http-api';\n"]}

package/src/index.d.ts

@@ -1,8 +1,15 @@
 export { WebpiecesServer } from './WebpiecesServer';
 export { WebpiecesFactory } from './WebpiecesFactory';
 export { WebpiecesMiddleware } from './WebpiecesMiddleware';
+export { WebpiecesRouteCreator } from './WebpiecesRouteCreator';
+export { InProcessApiClientFactory } from './InProcessApiClientFactory';
 export { ContextFilter } from './filters/ContextFilter';
 export { LogApiFilter } from './filters/LogApiFilter';
+export { RecordingFilter } from './filters/RecordingFilter';
+export { TestCaseRecorderImpl } from './recorder/TestCaseRecorderImpl';
+export { SpecGenerator } from './recorder/SpecGenerator';
+export { recordable } from './recorder/recordable';
 export { WebpiecesModule } from './modules/WebpiecesModule';
 export { WebpiecesCoreHeaders } from './headers/WebpiecesCoreHeaders';
-export { RouteHandler, ExpressRouteHandler, MethodMeta, RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, HttpFilter, FilterMatcher, } from '@webpieces/http-routing';
+export { HeaderRegistry } from '@webpieces/http-api';
+export { RouteHandler, ExpressRouteHandler, MethodMeta, RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, HttpFilter, FilterMatcher, FilterDefinition, } from '@webpieces/http-routing';

package/src/index.js

@@ -1,20 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.MethodMeta = exports.RouteHandler = exports.WebpiecesCoreHeaders = exports.WebpiecesModule = exports.LogApiFilter = exports.ContextFilter = exports.WebpiecesMiddleware = exports.WebpiecesFactory = void 0;
+exports.FilterDefinition = exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.MethodMeta = exports.RouteHandler = exports.HeaderRegistry = exports.WebpiecesCoreHeaders = exports.WebpiecesModule = exports.recordable = exports.SpecGenerator = exports.TestCaseRecorderImpl = exports.RecordingFilter = exports.LogApiFilter = exports.ContextFilter = exports.InProcessApiClientFactory = exports.WebpiecesRouteCreator = exports.WebpiecesMiddleware = exports.WebpiecesFactory = void 0;
 var WebpiecesFactory_1 = require("./WebpiecesFactory");
 Object.defineProperty(exports, "WebpiecesFactory", { enumerable: true, get: function () { return WebpiecesFactory_1.WebpiecesFactory; } });
 var WebpiecesMiddleware_1 = require("./WebpiecesMiddleware");
 Object.defineProperty(exports, "WebpiecesMiddleware", { enumerable: true, get: function () { return WebpiecesMiddleware_1.WebpiecesMiddleware; } });
+var WebpiecesRouteCreator_1 = require("./WebpiecesRouteCreator");
+Object.defineProperty(exports, "WebpiecesRouteCreator", { enumerable: true, get: function () { return WebpiecesRouteCreator_1.WebpiecesRouteCreator; } });
+var InProcessApiClientFactory_1 = require("./InProcessApiClientFactory");
+Object.defineProperty(exports, "InProcessApiClientFactory", { enumerable: true, get: function () { return InProcessApiClientFactory_1.InProcessApiClientFactory; } });
 var ContextFilter_1 = require("./filters/ContextFilter");
 Object.defineProperty(exports, "ContextFilter", { enumerable: true, get: function () { return ContextFilter_1.ContextFilter; } });
 var LogApiFilter_1 = require("./filters/LogApiFilter");
 Object.defineProperty(exports, "LogApiFilter", { enumerable: true, get: function () { return LogApiFilter_1.LogApiFilter; } });
+var RecordingFilter_1 = require("./filters/RecordingFilter");
+Object.defineProperty(exports, "RecordingFilter", { enumerable: true, get: function () { return RecordingFilter_1.RecordingFilter; } });
+// Test-case recording (contract lives in @webpieces/http-api)
+var TestCaseRecorderImpl_1 = require("./recorder/TestCaseRecorderImpl");
+Object.defineProperty(exports, "TestCaseRecorderImpl", { enumerable: true, get: function () { return TestCaseRecorderImpl_1.TestCaseRecorderImpl; } });
+var SpecGenerator_1 = require("./recorder/SpecGenerator");
+Object.defineProperty(exports, "SpecGenerator", { enumerable: true, get: function () { return SpecGenerator_1.SpecGenerator; } });
+var recordable_1 = require("./recorder/recordable");
+Object.defineProperty(exports, "recordable", { enumerable: true, get: function () { return recordable_1.recordable; } });
 // Platform Headers
 var WebpiecesModule_1 = require("./modules/WebpiecesModule");
 Object.defineProperty(exports, "WebpiecesModule", { enumerable: true, get: function () { return WebpiecesModule_1.WebpiecesModule; } });
 var WebpiecesCoreHeaders_1 = require("./headers/WebpiecesCoreHeaders");
 Object.defineProperty(exports, "WebpiecesCoreHeaders", { enumerable: true, get: function () { return WebpiecesCoreHeaders_1.WebpiecesCoreHeaders; } });
+var http_api_1 = require("@webpieces/http-api");
+Object.defineProperty(exports, "HeaderRegistry", { enumerable: true, get: function () { return http_api_1.HeaderRegistry; } });
 // Re-export from http-routing for backward compatibility
+// (FilterDefinition re-exported for one-import adapter ergonomics)
 var http_routing_1 = require("@webpieces/http-routing");
 Object.defineProperty(exports, "RouteHandler", { enumerable: true, get: function () { return http_routing_1.RouteHandler; } });
 Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return http_routing_1.MethodMeta; } });
@@ -22,4 +38,5 @@ Object.defineProperty(exports, "RouteBuilderImpl", { enumerable: true, get: func
 Object.defineProperty(exports, "RouteHandlerWithMeta", { enumerable: true, get: function () { return http_routing_1.RouteHandlerWithMeta; } });
 Object.defineProperty(exports, "FilterWithMeta", { enumerable: true, get: function () { return http_routing_1.FilterWithMeta; } });
 Object.defineProperty(exports, "FilterMatcher", { enumerable: true, get: function () { return http_routing_1.FilterMatcher; } });
+Object.defineProperty(exports, "FilterDefinition", { enumerable: true, get: function () { return http_routing_1.FilterDefinition; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AAErB,mBAAmB;AACnB,6DAA4D;AAAnD,kHAAA,eAAe,OAAA;AACxB,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAE7B,yDAAyD;AACzD,wDASiC;AAR7B,4GAAA,YAAY,OAAA;AAEZ,0GAAA,UAAU,OAAA;AACV,gHAAA,gBAAgB,OAAA;AAChB,oHAAA,oBAAoB,OAAA;AACpB,8GAAA,cAAc,OAAA;AAEd,6GAAA,aAAa,OAAA","sourcesContent":["export { WebpiecesServer } from './WebpiecesServer';\nexport { WebpiecesFactory } from './WebpiecesFactory';\nexport { WebpiecesMiddleware } from './WebpiecesMiddleware';\nexport { ContextFilter } from './filters/ContextFilter';\nexport { LogApiFilter } from './filters/LogApiFilter';\n\n// Platform Headers\nexport { WebpiecesModule } from './modules/WebpiecesModule';\nexport { WebpiecesCoreHeaders } from './headers/WebpiecesCoreHeaders';\n\n// Re-export from http-routing for backward compatibility\nexport {\n    RouteHandler,\n    ExpressRouteHandler,\n    MethodMeta,\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    HttpFilter,\n    FilterMatcher,\n} from '@webpieces/http-routing';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAClC,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,kHAAA,eAAe,OAAA;AAExB,8DAA8D;AAC9D,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA;AAC7B,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AACtB,oDAAmD;AAA1C,wGAAA,UAAU,OAAA;AAEnB,mBAAmB;AACnB,6DAA4D;AAAnD,kHAAA,eAAe,OAAA;AACxB,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAC7B,gDAAqD;AAA5C,0GAAA,cAAc,OAAA;AAEvB,yDAAyD;AACzD,mEAAmE;AACnE,wDAUiC;AAT7B,4GAAA,YAAY,OAAA;AAEZ,0GAAA,UAAU,OAAA;AACV,gHAAA,gBAAgB,OAAA;AAChB,oHAAA,oBAAoB,OAAA;AACpB,8GAAA,cAAc,OAAA;AAEd,6GAAA,aAAa,OAAA;AACb,gHAAA,gBAAgB,OAAA","sourcesContent":["export { WebpiecesServer } from './WebpiecesServer';\nexport { WebpiecesFactory } from './WebpiecesFactory';\nexport { WebpiecesMiddleware } from './WebpiecesMiddleware';\nexport { WebpiecesRouteCreator } from './WebpiecesRouteCreator';\nexport { InProcessApiClientFactory } from './InProcessApiClientFactory';\nexport { ContextFilter } from './filters/ContextFilter';\nexport { LogApiFilter } from './filters/LogApiFilter';\nexport { RecordingFilter } from './filters/RecordingFilter';\n\n// Test-case recording (contract lives in @webpieces/http-api)\nexport { TestCaseRecorderImpl } from './recorder/TestCaseRecorderImpl';\nexport { SpecGenerator } from './recorder/SpecGenerator';\nexport { recordable } from './recorder/recordable';\n\n// Platform Headers\nexport { WebpiecesModule } from './modules/WebpiecesModule';\nexport { WebpiecesCoreHeaders } from './headers/WebpiecesCoreHeaders';\nexport { HeaderRegistry } from '@webpieces/http-api';\n\n// Re-export from http-routing for backward compatibility\n// (FilterDefinition re-exported for one-import adapter ergonomics)\nexport {\n    RouteHandler,\n    ExpressRouteHandler,\n    MethodMeta,\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    HttpFilter,\n    FilterMatcher,\n    FilterDefinition,\n} from '@webpieces/http-routing';\n"]}