@webpieces/http-routing 0.3.262 → 0.3.271

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-routing",
-  "version": "0.3.262",
+  "version": "0.3.271",
   "description": "Decorator-based routing with auto-wiring for WebPieces",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -21,9 +21,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/http-api": "0.3.262",
-    "@webpieces/http-filters": "0.3.262",
-    "@webpieces/wp-logging": "0.3.262",
+    "@webpieces/core-context": "0.3.271",
+    "@webpieces/core-util": "0.3.271",
+    "@webpieces/http-filters": "0.3.271",
     "inversify": "7.10.4",
     "minimatch": "10.0.1"
   }

package/src/ApiRoutingFactory.d.ts

@@ -1,5 +1,5 @@
 import { Routes, RouteBuilder } from './WebAppMeta';
-import { AuthMeta } from '@webpieces/http-api';
+import { AuthMeta } from '@webpieces/core-util';
 import 'reflect-metadata';
 /**
  * Type representing a class constructor (abstract or concrete).

package/src/ApiRoutingFactory.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiRoutingFactory = void 0;
 const WebAppMeta_1 = require("./WebAppMeta");
-const http_api_1 = require("@webpieces/http-api");
+const core_util_1 = require("@webpieces/core-util");
 require("reflect-metadata");
 const decorators_1 = require("./decorators");
 /**
@@ -34,7 +34,7 @@ class ApiRoutingFactory {
         this.apiMetaClass = apiMetaClass;
         this.controllerClass = controllerClass;
         // Validate that apiMetaClass is marked with @ApiPath
-        if (!(0, http_api_1.isApiPath)(apiMetaClass)) {
+        if (!(0, core_util_1.isApiPath)(apiMetaClass)) {
             const className = apiMetaClass.name || 'Unknown';
             throw new Error(`Class ${className} must be decorated with @ApiPath()`);
         }
@@ -56,8 +56,8 @@ class ApiRoutingFactory {
      * Validates controller methods and auth decorators in single loop.
      */
     configure(routeBuilder) {
-        const basePath = (0, http_api_1.getApiPath)(this.apiMetaClass);
-        const endpoints = (0, http_api_1.getEndpoints)(this.apiMetaClass) || {};
+        const basePath = (0, core_util_1.getApiPath)(this.apiMetaClass);
+        const endpoints = (0, core_util_1.getEndpoints)(this.apiMetaClass) || {};
         const controllerFilepath = this.getControllerFilepath();
         const apiName = this.apiMetaClass.name || 'Unknown';
         const controllerName = this.controllerClass.name || 'Unknown';
@@ -67,13 +67,13 @@ class ApiRoutingFactory {
                 throw new Error(`Controller ${controllerName} must implement method ${methodName} from API ${apiName}`);
             }
             // Validate auth decorator exists (class-level or method-level)
-            const authMeta = (0, http_api_1.getAuthMeta)(this.apiMetaClass, methodName);
+            const authMeta = (0, core_util_1.getAuthMeta)(this.apiMetaClass, methodName);
             if (!authMeta) {
                 throw new Error(`Endpoint '${methodName}' in ${apiName} has no @Authentication decorator. ` +
                     `Add @Authentication(new AuthenticationConfig(...)) to the class or method.`);
             }
             const fullPath = basePath + endpointPath;
-            const routeMeta = new http_api_1.RouteMetadata('POST', fullPath, methodName, controllerName, authMeta);
+            const routeMeta = new core_util_1.RouteMetadata('POST', fullPath, methodName, controllerName, authMeta);
             routeBuilder.addRoute(new WebAppMeta_1.RouteDefinition(routeMeta, this.controllerClass, controllerFilepath));
         }
     }
@@ -95,7 +95,7 @@ class ApiRoutingFactory {
      * Get auth metadata for a specific method, falling back to class-level.
      */
     getAuthMetaForMethod(methodName) {
-        return (0, http_api_1.getAuthMeta)(this.apiMetaClass, methodName);
+        return (0, core_util_1.getAuthMeta)(this.apiMetaClass, methodName);
     }
     /**
      * Get the API interface class.

package/src/ApiRoutingFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiRoutingFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/ApiRoutingFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import { Routes, RouteBuilder, RouteDefinition } from './WebAppMeta';\nimport { isApiPath, getApiPath, getEndpoints, getAuthMeta, RouteMetadata, AuthMeta } from '@webpieces/http-api';\nimport 'reflect-metadata';\nimport { ROUTING_METADATA_KEYS } from './decorators';\n\n/**\n * Type representing a class constructor (abstract or concrete).\n */\n// webpieces-disable no-any-unknown -- generic type alias requires unconstrained default\nexport type ClassType<T = unknown> = Function & { prototype: T };\n\n/**\n * ApiRoutingFactory - Automatically wire API interfaces to controllers.\n * Reads @ApiPath/@Endpoint decorators from an API prototype class and\n * registers POST routes for each endpoint.\n *\n * Replaces the old RESTApiRoutes class.\n *\n * Usage:\n * ```typescript\n * // In your ServerMeta:\n * getRoutes(): Routes[] {\n *   return [\n *     new ApiRoutingFactory(SaveApi, SaveController),\n *   ];\n * }\n * ```\n */\n// webpieces-disable no-any-unknown -- generic class requires unconstrained default type params\nexport class ApiRoutingFactory<TApi = unknown, TController extends TApi = TApi> implements Routes {\n    private apiMetaClass: ClassType<TApi>;\n    private controllerClass: ClassType<TController>;\n\n    /**\n     * @param apiMetaClass - The API prototype class with @ApiPath/@Endpoint decorators\n     * @param controllerClass - The controller class that implements the API\n     */\n    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>) {\n        this.apiMetaClass = apiMetaClass;\n        this.controllerClass = controllerClass;\n\n        // Validate that apiMetaClass is marked with @ApiPath\n        if (!isApiPath(apiMetaClass)) {\n            const className = apiMetaClass.name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiPath()`);\n        }\n\n        // Validate that controllerClass actually extends apiMetaClass.\n        // TypeScript's structural typing won't catch a missing `extends` here, so we check\n        // the runtime prototype chain. Without this, a controller can silently drift from\n        // the API contract (wrong method names, wrong signatures) and only fail later as a\n        // confusing routing or method-not-found error.\n        const apiName = apiMetaClass.name || 'Unknown';\n        const controllerName = controllerClass.name || 'Unknown';\n        if (!(apiMetaClass.prototype as object).isPrototypeOf(controllerClass.prototype as object)) {\n            throw new Error(\n                `Controller ${controllerName} must extend ${apiName}. ` +\n                `Change the class declaration to: ` +\n                `'export class ${controllerName} extends ${apiName} { ... }'`,\n            );\n        }\n\n    }\n\n    /**\n     * Configure routes by reading @ApiPath + @Endpoint metadata.\n     * Validates controller methods and auth decorators in single loop.\n     */\n    configure(routeBuilder: RouteBuilder): void {\n        const basePath = getApiPath(this.apiMetaClass)!;\n        const endpoints = getEndpoints(this.apiMetaClass) || {};\n        const controllerFilepath = this.getControllerFilepath();\n        const apiName = this.apiMetaClass.name || 'Unknown';\n        const controllerName = this.controllerClass.name || 'Unknown';\n\n        for (const [methodName, endpointPath] of Object.entries(endpoints)) {\n            // Validate controller implements this method\n            if (typeof this.controllerClass.prototype[methodName] !== 'function') {\n                throw new Error(\n                    `Controller ${controllerName} must implement method ${methodName} from API ${apiName}`,\n                );\n            }\n\n            // Validate auth decorator exists (class-level or method-level)\n            const authMeta = getAuthMeta(this.apiMetaClass, methodName);\n            if (!authMeta) {\n                throw new Error(\n                    `Endpoint '${methodName}' in ${apiName} has no @Authentication decorator. ` +\n                    `Add @Authentication(new AuthenticationConfig(...)) to the class or method.`,\n                );\n            }\n\n            const fullPath = basePath + endpointPath;\n            const routeMeta = new RouteMetadata(\n                'POST',\n                fullPath,\n                methodName,\n                controllerName,\n                authMeta,\n            );\n\n            routeBuilder.addRoute(new RouteDefinition(routeMeta, this.controllerClass, controllerFilepath));\n        }\n    }\n\n    /**\n     * Get the filepath of the controller source file.\n     * Uses a heuristic based on the controller class name.\n     */\n    private getControllerFilepath(): string | undefined {\n        // Check for explicit @SourceFile decorator metadata\n        const filepath = Reflect.getMetadata(\n            ROUTING_METADATA_KEYS.SOURCE_FILEPATH,\n            this.controllerClass,\n        );\n        if (filepath) {\n            return filepath;\n        }\n\n        // Fallback to class name pattern\n        const className = this.controllerClass.name;\n        return className ? `**/${className}.ts` : undefined;\n    }\n\n    /**\n     * Get auth metadata for a specific method, falling back to class-level.\n     */\n    getAuthMetaForMethod(methodName: string): AuthMeta | undefined {\n        return getAuthMeta(this.apiMetaClass, methodName);\n    }\n\n    /**\n     * Get the API interface class.\n     */\n    getApiClass(): ClassType<TApi> {\n        return this.apiMetaClass;\n    }\n\n    /**\n     * Get the controller class.\n     */\n    getControllerClass(): ClassType<TController> {\n        return this.controllerClass;\n    }\n}\n"]}
+{"version":3,"file":"ApiRoutingFactory.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/ApiRoutingFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import { Routes, RouteBuilder, RouteDefinition } from './WebAppMeta';\nimport { isApiPath, getApiPath, getEndpoints, getAuthMeta, RouteMetadata, AuthMeta } from '@webpieces/core-util';\nimport 'reflect-metadata';\nimport { ROUTING_METADATA_KEYS } from './decorators';\n\n/**\n * Type representing a class constructor (abstract or concrete).\n */\n// webpieces-disable no-any-unknown -- generic type alias requires unconstrained default\nexport type ClassType<T = unknown> = Function & { prototype: T };\n\n/**\n * ApiRoutingFactory - Automatically wire API interfaces to controllers.\n * Reads @ApiPath/@Endpoint decorators from an API prototype class and\n * registers POST routes for each endpoint.\n *\n * Replaces the old RESTApiRoutes class.\n *\n * Usage:\n * ```typescript\n * // In your ServerMeta:\n * getRoutes(): Routes[] {\n *   return [\n *     new ApiRoutingFactory(SaveApi, SaveController),\n *   ];\n * }\n * ```\n */\n// webpieces-disable no-any-unknown -- generic class requires unconstrained default type params\nexport class ApiRoutingFactory<TApi = unknown, TController extends TApi = TApi> implements Routes {\n    private apiMetaClass: ClassType<TApi>;\n    private controllerClass: ClassType<TController>;\n\n    /**\n     * @param apiMetaClass - The API prototype class with @ApiPath/@Endpoint decorators\n     * @param controllerClass - The controller class that implements the API\n     */\n    constructor(apiMetaClass: ClassType<TApi>, controllerClass: ClassType<TController>) {\n        this.apiMetaClass = apiMetaClass;\n        this.controllerClass = controllerClass;\n\n        // Validate that apiMetaClass is marked with @ApiPath\n        if (!isApiPath(apiMetaClass)) {\n            const className = apiMetaClass.name || 'Unknown';\n            throw new Error(`Class ${className} must be decorated with @ApiPath()`);\n        }\n\n        // Validate that controllerClass actually extends apiMetaClass.\n        // TypeScript's structural typing won't catch a missing `extends` here, so we check\n        // the runtime prototype chain. Without this, a controller can silently drift from\n        // the API contract (wrong method names, wrong signatures) and only fail later as a\n        // confusing routing or method-not-found error.\n        const apiName = apiMetaClass.name || 'Unknown';\n        const controllerName = controllerClass.name || 'Unknown';\n        if (!(apiMetaClass.prototype as object).isPrototypeOf(controllerClass.prototype as object)) {\n            throw new Error(\n                `Controller ${controllerName} must extend ${apiName}. ` +\n                `Change the class declaration to: ` +\n                `'export class ${controllerName} extends ${apiName} { ... }'`,\n            );\n        }\n\n    }\n\n    /**\n     * Configure routes by reading @ApiPath + @Endpoint metadata.\n     * Validates controller methods and auth decorators in single loop.\n     */\n    configure(routeBuilder: RouteBuilder): void {\n        const basePath = getApiPath(this.apiMetaClass)!;\n        const endpoints = getEndpoints(this.apiMetaClass) || {};\n        const controllerFilepath = this.getControllerFilepath();\n        const apiName = this.apiMetaClass.name || 'Unknown';\n        const controllerName = this.controllerClass.name || 'Unknown';\n\n        for (const [methodName, endpointPath] of Object.entries(endpoints)) {\n            // Validate controller implements this method\n            if (typeof this.controllerClass.prototype[methodName] !== 'function') {\n                throw new Error(\n                    `Controller ${controllerName} must implement method ${methodName} from API ${apiName}`,\n                );\n            }\n\n            // Validate auth decorator exists (class-level or method-level)\n            const authMeta = getAuthMeta(this.apiMetaClass, methodName);\n            if (!authMeta) {\n                throw new Error(\n                    `Endpoint '${methodName}' in ${apiName} has no @Authentication decorator. ` +\n                    `Add @Authentication(new AuthenticationConfig(...)) to the class or method.`,\n                );\n            }\n\n            const fullPath = basePath + endpointPath;\n            const routeMeta = new RouteMetadata(\n                'POST',\n                fullPath,\n                methodName,\n                controllerName,\n                authMeta,\n            );\n\n            routeBuilder.addRoute(new RouteDefinition(routeMeta, this.controllerClass, controllerFilepath));\n        }\n    }\n\n    /**\n     * Get the filepath of the controller source file.\n     * Uses a heuristic based on the controller class name.\n     */\n    private getControllerFilepath(): string | undefined {\n        // Check for explicit @SourceFile decorator metadata\n        const filepath = Reflect.getMetadata(\n            ROUTING_METADATA_KEYS.SOURCE_FILEPATH,\n            this.controllerClass,\n        );\n        if (filepath) {\n            return filepath;\n        }\n\n        // Fallback to class name pattern\n        const className = this.controllerClass.name;\n        return className ? `**/${className}.ts` : undefined;\n    }\n\n    /**\n     * Get auth metadata for a specific method, falling back to class-level.\n     */\n    getAuthMetaForMethod(methodName: string): AuthMeta | undefined {\n        return getAuthMeta(this.apiMetaClass, methodName);\n    }\n\n    /**\n     * Get the API interface class.\n     */\n    getApiClass(): ClassType<TApi> {\n        return this.apiMetaClass;\n    }\n\n    /**\n     * Get the controller class.\n     */\n    getControllerClass(): ClassType<TController> {\n        return this.controllerClass;\n    }\n}\n"]}

package/src/FilterMatcher.d.ts

@@ -1,5 +1,5 @@
 import { Filter, WpResponse } from '@webpieces/http-filters';
-import { MethodMeta } from './MethodMeta';
+import { MethodMeta } from '@webpieces/http-filters';
 import { FilterDefinition } from './WebAppMeta';
 /**
  * Type alias for HTTP filters that work with MethodMeta and ResponseWrapper.

package/src/FilterMatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterMatcher.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/FilterMatcher.ts"],"names":[],"mappings":";;;AAGA,yCAAsC;AAOtC;;;;;;;;;;;;GAYG;AACH,MAAa,aAAa;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CACtB,kBAAsC,EACtC,UAAmC;QAEnC,MAAM,eAAe,GAAoD,EAAE,CAAC;QAE5E,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC;YAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAoB,CAAC;YAE/C,4DAA4D;YAC5D,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBAClB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAChE,SAAS;YACb,CAAC;YAED,yDAAyD;YACzD,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACtB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;oBACrB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACpE,CAAC;gBACD,SAAS;YACb,CAAC;YAED,6CAA6C;YAC7C,MAAM,cAAc,GAAG,aAAa,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;YAE3E,wBAAwB;YACxB,IAAI,IAAA,qBAAS,EAAC,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC;gBACrC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAExD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACrC,OAAO,QAAQ;aACV,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,yCAAyC;aAC7D,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;IACrD,CAAC;CACJ;AA5DD,sCA4DC","sourcesContent":["import { Filter, WpResponse } from '@webpieces/http-filters';\nimport { MethodMeta } from './MethodMeta';\nimport { FilterDefinition } from './WebAppMeta';\nimport { minimatch } from 'minimatch';\n\n/**\n * Type alias for HTTP filters that work with MethodMeta and ResponseWrapper.\n */\nexport type HttpFilter = Filter<MethodMeta, WpResponse<unknown>>;\n\n/**\n * FilterMatcher - Matches filters to routes based on filepath patterns.\n * Similar to Java SharedMatchUtil.findMatchingFilters().\n *\n * Responsibilities:\n * 1. Filter based on filepath glob pattern matching\n * 2. Sort matching filters by priority (higher first)\n *\n * Differences from Java:\n * - Uses glob patterns instead of regex\n * - Only matches filepaths (no URL path or HTTPS filtering yet)\n * - Simpler API focused on one responsibility\n */\nexport class FilterMatcher {\n    /**\n     * Find filters that match the given controller filepath.\n     *\n     * @param controllerFilepath - The filepath of the controller source file\n     * @param allFilters - All registered filters with their definitions\n     * @returns Array of matching filters, sorted by priority (highest first)\n     */\n    static findMatchingFilters(\n        controllerFilepath: string | undefined,\n        allFilters: Array<FilterDefinition>,\n    ): HttpFilter[] {\n        const matchingFilters: Array<{ filter: HttpFilter; priority: number }> = [];\n\n        for (const definition of allFilters) {\n            const pattern = definition.filepathPattern;\n            const filter = definition.filter as HttpFilter;\n\n            // Special case: '*' matches all controllers (global filter)\n            if (pattern === '*') {\n                matchingFilters.push({ filter, priority: definition.priority });\n                continue;\n            }\n\n            // If no filepath available, only match wildcard patterns\n            if (!controllerFilepath) {\n                if (pattern === '**/*') {\n                    matchingFilters.push({ filter, priority: definition.priority });\n                }\n                continue;\n            }\n\n            // Normalize filepath for consistent matching\n            const normalizedPath = FilterMatcher.normalizeFilepath(controllerFilepath);\n\n            // Match using minimatch\n            if (minimatch(normalizedPath, pattern)) {\n                matchingFilters.push({ filter, priority: definition.priority });\n            }\n        }\n\n        // Sort by priority (highest first)\n        matchingFilters.sort((a, b) => b.priority - a.priority);\n\n        return matchingFilters.map((item) => item.filter);\n    }\n\n    /**\n     * Normalize a controller filepath for consistent matching.\n     * - Converts backslashes to forward slashes (Windows compatibility)\n     * - Removes leading './'\n     *\n     * @param filepath - Raw filepath\n     * @returns Normalized filepath\n     */\n    static normalizeFilepath(filepath: string): string {\n        return filepath\n            .replace(/\\\\/g, '/') // Windows backslashes to forward slashes\n            .replace(/^\\.\\//, ''); // Remove leading './'\n    }\n}\n"]}
+{"version":3,"file":"FilterMatcher.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/FilterMatcher.ts"],"names":[],"mappings":";;;AAGA,yCAAsC;AAOtC;;;;;;;;;;;;GAYG;AACH,MAAa,aAAa;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CACtB,kBAAsC,EACtC,UAAmC;QAEnC,MAAM,eAAe,GAAoD,EAAE,CAAC;QAE5E,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC;YAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAoB,CAAC;YAE/C,4DAA4D;YAC5D,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBAClB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAChE,SAAS;YACb,CAAC;YAED,yDAAyD;YACzD,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACtB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;oBACrB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACpE,CAAC;gBACD,SAAS;YACb,CAAC;YAED,6CAA6C;YAC7C,MAAM,cAAc,GAAG,aAAa,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;YAE3E,wBAAwB;YACxB,IAAI,IAAA,qBAAS,EAAC,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC;gBACrC,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAExD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACrC,OAAO,QAAQ;aACV,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,yCAAyC;aAC7D,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;IACrD,CAAC;CACJ;AA5DD,sCA4DC","sourcesContent":["import { Filter, WpResponse } from '@webpieces/http-filters';\nimport { MethodMeta } from '@webpieces/http-filters';\nimport { FilterDefinition } from './WebAppMeta';\nimport { minimatch } from 'minimatch';\n\n/**\n * Type alias for HTTP filters that work with MethodMeta and ResponseWrapper.\n */\nexport type HttpFilter = Filter<MethodMeta, WpResponse<unknown>>;\n\n/**\n * FilterMatcher - Matches filters to routes based on filepath patterns.\n * Similar to Java SharedMatchUtil.findMatchingFilters().\n *\n * Responsibilities:\n * 1. Filter based on filepath glob pattern matching\n * 2. Sort matching filters by priority (higher first)\n *\n * Differences from Java:\n * - Uses glob patterns instead of regex\n * - Only matches filepaths (no URL path or HTTPS filtering yet)\n * - Simpler API focused on one responsibility\n */\nexport class FilterMatcher {\n    /**\n     * Find filters that match the given controller filepath.\n     *\n     * @param controllerFilepath - The filepath of the controller source file\n     * @param allFilters - All registered filters with their definitions\n     * @returns Array of matching filters, sorted by priority (highest first)\n     */\n    static findMatchingFilters(\n        controllerFilepath: string | undefined,\n        allFilters: Array<FilterDefinition>,\n    ): HttpFilter[] {\n        const matchingFilters: Array<{ filter: HttpFilter; priority: number }> = [];\n\n        for (const definition of allFilters) {\n            const pattern = definition.filepathPattern;\n            const filter = definition.filter as HttpFilter;\n\n            // Special case: '*' matches all controllers (global filter)\n            if (pattern === '*') {\n                matchingFilters.push({ filter, priority: definition.priority });\n                continue;\n            }\n\n            // If no filepath available, only match wildcard patterns\n            if (!controllerFilepath) {\n                if (pattern === '**/*') {\n                    matchingFilters.push({ filter, priority: definition.priority });\n                }\n                continue;\n            }\n\n            // Normalize filepath for consistent matching\n            const normalizedPath = FilterMatcher.normalizeFilepath(controllerFilepath);\n\n            // Match using minimatch\n            if (minimatch(normalizedPath, pattern)) {\n                matchingFilters.push({ filter, priority: definition.priority });\n            }\n        }\n\n        // Sort by priority (highest first)\n        matchingFilters.sort((a, b) => b.priority - a.priority);\n\n        return matchingFilters.map((item) => item.filter);\n    }\n\n    /**\n     * Normalize a controller filepath for consistent matching.\n     * - Converts backslashes to forward slashes (Windows compatibility)\n     * - Removes leading './'\n     *\n     * @param filepath - Raw filepath\n     * @returns Normalized filepath\n     */\n    static normalizeFilepath(filepath: string): string {\n        return filepath\n            .replace(/\\\\/g, '/') // Windows backslashes to forward slashes\n            .replace(/^\\.\\//, ''); // Remove leading './'\n    }\n}\n"]}

package/src/RouteBuilderImpl.d.ts

@@ -2,8 +2,8 @@ import { Container } from 'inversify';
 import { Request, Response, NextFunction } from 'express';
 import { RouteBuilder, RouteDefinition, FilterDefinition } from './WebAppMeta';
 import { RouteHandler } from './RouteHandler';
-import { MethodMeta } from './MethodMeta';
-import { RouteMetadata } from '@webpieces/http-api';
+import { MethodMeta } from '@webpieces/http-filters';
+import { RouteMetadata } from '@webpieces/core-util';
 import { WpResponse, Service } from '@webpieces/http-filters';
 import { HttpFilter } from './FilterMatcher';
 /**

package/src/RouteBuilderImpl.js

@@ -3,11 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RouteBuilderImpl = exports.RouteHandlerWithMeta = exports.RouteHandlerImpl = exports.FilterWithMeta = void 0;
 const tslib_1 = require("tslib");
 const inversify_1 = require("inversify");
-const decorators_1 = require("./decorators");
+const core_context_1 = require("@webpieces/core-context");
 const http_filters_1 = require("@webpieces/http-filters");
 const FilterMatcher_1 = require("./FilterMatcher");
-const wp_logging_1 = require("@webpieces/wp-logging");
-const log = wp_logging_1.LogManager.getLogger('RouteBuilder');
+const core_util_1 = require("@webpieces/core-util");
+const log = core_util_1.LogManager.getLogger('RouteBuilder');
 /**
  * FilterWithMeta - Pairs a resolved filter instance with its definition.
  * Stores both the DI-resolved filter and the metadata needed for matching.
@@ -272,7 +272,7 @@ let RouteBuilderImpl = class RouteBuilderImpl {
 };
 exports.RouteBuilderImpl = RouteBuilderImpl;
 exports.RouteBuilderImpl = RouteBuilderImpl = tslib_1.__decorate([
-    (0, decorators_1.provideSingleton)(),
+    (0, core_context_1.provideSingleton)(),
     (0, inversify_1.injectable)()
 ], RouteBuilderImpl);
 //# sourceMappingURL=RouteBuilderImpl.js.map

package/src/RouteBuilderImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouteBuilderImpl.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RouteBuilderImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container, injectable } from 'inversify';\nimport { Request, Response, NextFunction } from 'express';\nimport { RouteBuilder, RouteDefinition, FilterDefinition } from './WebAppMeta';\nimport { provideSingleton } from './decorators';\nimport { RouteHandler } from './RouteHandler';\nimport { MethodMeta } from './MethodMeta';\nimport { RouteMetadata } from '@webpieces/http-api';\nimport { WpResponse, Service } from '@webpieces/http-filters';\nimport { FilterMatcher, HttpFilter } from './FilterMatcher';\nimport { LogManager } from '@webpieces/wp-logging';\n\nconst log = LogManager.getLogger('RouteBuilder');\n\n/**\n * Express route handler function type.\n * Used by wrapExpress to create handlers that Express can call.\n */\nexport type ExpressRouteHandler = (\n    req: Request,\n    res: Response,\n    next: NextFunction,\n) => Promise<void>;\n\n/**\n * FilterWithMeta - Pairs a resolved filter instance with its definition.\n * Stores both the DI-resolved filter and the metadata needed for matching.\n */\nexport class FilterWithMeta {\n    constructor(\n        public filter: HttpFilter,\n        public definition: FilterDefinition,\n    ) {}\n}\n\n/**\n * RouteHandlerImpl - Concrete implementation of RouteHandler.\n * Wraps a resolved controller and method to invoke on each request.\n */\nexport class RouteHandlerImpl<TResult> implements RouteHandler<TResult> {\n    constructor(\n        private controller: Record<string, unknown>,\n        private method: (this: unknown, requestDto?: unknown) => Promise<TResult>,\n    ) {}\n\n    async execute(meta: MethodMeta): Promise<TResult> {\n        // Invoke the method with requestDto from meta\n        // The controller is already resolved - no DI lookup on every request!\n        const result: TResult = await this.method.call(this.controller, meta.requestDto);\n        return result;\n    }\n}\n/**\n * RouteHandlerWithMeta - Pairs a route handler with its definition.\n * Stores both the handler (which wraps the DI-resolved controller) and the route metadata.\n *\n * We use unknown for the generic type since we store different TResult types in the same Map.\n * Type safety is maintained through the generic on RouteDefinition at registration time.\n */\nexport class RouteHandlerWithMeta {\n    constructor(\n        public invokeControllerHandler: RouteHandler<unknown>,\n        public definition: RouteDefinition,\n    ) {}\n}\n\n/**\n * RouteBuilderImpl - Concrete implementation of RouteBuilder interface.\n *\n * Similar to Java WebPieces RouteBuilder, this class is responsible for:\n * 1. Registering routes with their handlers\n * 2. Registering filters with priority\n *\n * This class is explicit (not anonymous) to:\n * - Improve traceability and debugging\n * - Make the code easier to understand\n * - Enable better IDE navigation (Cmd+Click on addRoute works!)\n *\n * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()\n * but needs appContainer to resolve filters/controllers. The container is set via\n * setContainer() after appContainer is created (late binding pattern).\n */\n@provideSingleton()\n@injectable()\nexport class RouteBuilderImpl implements RouteBuilder {\n    private routes: RouteHandlerWithMeta[] = [];\n    private filterRegistry: Array<FilterWithMeta> = [];\n    private container?: Container;\n\n    /**\n     * Map for O(1) route lookup by method:path.\n     * Used by both addRoute() and createRouteInvoker() for fast route access.\n     */\n    private routeMap: Map<string, RouteHandlerWithMeta> = new Map();\n\n    /**\n     * Create route key for consistent lookup.\n     * Key format: \"${METHOD}:${path}\" (e.g., \"POST:/search/item\")\n     */\n    private createRouteKey(method: string, path: string): string {\n        return `${method.toUpperCase()}:${path}`;\n    }\n\n    /**\n     * Set the DI container used for resolving filters and controllers.\n     * Called by WebpiecesCoreServer after appContainer is created.\n     *\n     * @param container - The application DI container (appContainer)\n     */\n    setContainer(container: Container): void {\n        this.container = container;\n    }\n\n    /**\n     * Register a route with the router.\n     *\n     * Uses createRouteHandlerWithMeta() to create the handler, then stores it\n     * in both the routes array and the routeMap for O(1) lookup.\n     *\n     * @param route - Route definition with controller class and method name\n     */\n    addRoute(route: RouteDefinition): void {\n        const routeWithMeta = this.createRouteHandlerWithMeta(route);\n        this.routes.push(routeWithMeta);\n\n        // Also add to map for O(1) lookup by method:path\n        const key = this.createRouteKey(\n            route.routeMeta.httpMethod,\n            route.routeMeta.path\n        );\n        this.routeMap.set(key, routeWithMeta);\n    }\n\n    /**\n     * Create RouteHandlerWithMeta from a RouteDefinition.\n     *\n     * Resolves controller from DI container ONCE and creates a handler that\n     * invokes the controller method with the request DTO.\n     *\n     * This method is used by:\n     * - addRoute() for production route registration\n     * - createRouteInvoker() for test clients (via createApiClient)\n     *\n     * @param route - Route definition with controller class and method name\n     * @returns RouteHandlerWithMeta containing the handler and route definition\n     */\n    private createRouteHandlerWithMeta<TResult = unknown>(\n        route: RouteDefinition,\n    ): RouteHandlerWithMeta {\n        if (!this.container) {\n            throw new Error('Container not set. Call setContainer() before registering routes.');\n        }\n\n        const routeMeta = route.routeMeta;\n\n        // Resolve controller instance from DI container ONCE (not on every request!)\n        const controller = this.container.get(route.controllerClass) as Record<string, unknown>;\n\n        // Get the controller method\n        const method = controller[routeMeta.methodName];\n        if (typeof method !== 'function') {\n            const controllerName = (route.controllerClass as { name?: string }).name || 'Unknown';\n            throw new Error(\n                `Method ${routeMeta.methodName} not found on controller ${controllerName}`,\n            );\n        }\n\n        const handler = new RouteHandlerImpl<TResult>(\n            controller,\n            method as (this: unknown, requestDto?: unknown) => Promise<TResult>\n        );\n\n        // Return handler with route definition\n        return new RouteHandlerWithMeta(\n            handler as RouteHandler<unknown>,\n            route,\n        );\n    }\n\n    /**\n     * Register a filter with the filter chain.\n     *\n     * Resolves the filter from DI container and pairs it with the filter definition.\n     * The definition includes pattern information used for route-specific filtering.\n     *\n     * @param filterDef - Filter definition with priority, filter class, and optional filepath pattern\n     */\n    addFilter(filterDef: FilterDefinition): void {\n        if (!this.container) {\n            throw new Error('Container not set. Call setContainer() before registering filters.');\n        }\n\n        // Resolve filter instance from DI container\n        const filter = this.container.get<HttpFilter>(filterDef.filterClass);\n\n        // Store filter with its definition\n        const filterWithMeta = new FilterWithMeta(filter, filterDef);\n        this.filterRegistry.push(filterWithMeta);\n    }\n\n    /**\n     * Get all registered routes.\n     *\n     * @returns Map of routes with handlers and definitions, keyed by \"METHOD:path\"\n     */\n    getRoutes(): RouteHandlerWithMeta[] {\n        return this.routes;\n    }\n\n    /**\n     * Get all filters sorted by priority (highest priority first).\n     *\n     * @returns Array of FilterWithMeta sorted by priority\n     */\n    getSortedFilters(): Array<FilterWithMeta> {\n        return [...this.filterRegistry].sort(\n            (a, b) => b.definition.priority - a.definition.priority,\n        );\n    }\n\n    /**\n     * Cached filter definitions for lazy route setup.\n     */\n    private cachedFilterDefinitions?: FilterDefinition[];\n\n    /**\n     * Get filter definitions, computing once and caching.\n     */\n    private getFilterDefinitions(): FilterDefinition[] {\n        if (!this.cachedFilterDefinitions) {\n            const sortedFilters = this.getSortedFilters();\n            this.cachedFilterDefinitions = sortedFilters.map((fwm) => {\n                const def = fwm.definition;\n                def.filter = fwm.filter;\n                return def;\n            });\n        }\n        return this.cachedFilterDefinitions;\n    }\n\n    /**\n     * Setup a single route by creating its filter chain.\n     * This is called lazily by createHandler() and getRouteService().\n     *\n     * Creates a Service that wraps the filter chain and controller invocation.\n     * The service is DTO-only and has no Express dependency.\n     *\n     * @param key - Route key in format \"METHOD:path\"\n     * @param routeWithMeta - Route handler with metadata\n     * @returns The service for this route\n     */\n    public createRouteHandler(\n        routeWithMeta: RouteHandlerWithMeta,\n    ): Service<MethodMeta, WpResponse<unknown>> {\n        const route = routeWithMeta.definition;\n        const routeMeta = route.routeMeta;\n\n        log.info(`[RouteBuilder] Setting up route: ${routeMeta.httpMethod} ${routeMeta.path}`);\n\n        // Get cached filter definitions\n        const filterDefinitions = this.getFilterDefinitions();\n\n        // Find matching filters for this route\n        const matchingFilters = FilterMatcher.findMatchingFilters(\n            route.controllerFilepath,\n            filterDefinitions,\n        );\n\n        // Create service that wraps the controller execution\n        const controllerService: Service<MethodMeta, WpResponse<unknown>> = {\n            invoke: async (meta: MethodMeta): Promise<WpResponse<unknown>> => {\n                const result = await routeWithMeta.invokeControllerHandler.execute(meta);\n                // A void endpoint (e.g. a @PubSub cloud-task handler returning Promise<void>)\n                // yields undefined; coerce to {} so the response is a non-null JSON body\n                // (downstream LogApiCall/serialization require one), mirroring `result ?? {}`.\n                return new WpResponse(result ?? {});\n            },\n        };\n\n        if (matchingFilters.length === 0) {\n            throw new Error(\"No filters found for route. Check filter definitions as you must have at least ContextFilter\");\n        }\n\n        // Chain filters: highest priority (first in array) should run first (be outermost)\n        // Build from innermost (lowest priority) to outermost (highest priority)\n        // Start with controller, then wrap with filters in reverse priority order\n        let service: Service<MethodMeta, WpResponse<unknown>> = controllerService;\n        for (let i = matchingFilters.length - 1; i >= 0; i--) {\n            service = matchingFilters[i].chainService(service);\n        }\n\n        return service;\n    }\n\n    /**\n     * Create an invoker function for a route (for testing via createApiClient).\n     * Uses routeMap for O(1) lookup, sets up the filter chain ONCE,\n     * and returns a Service that can be called multiple times without\n     * recreating the filter chain.\n     *\n     * This method is called by WebpiecesServer.createApiClient() during proxy setup.\n     * The returned Service is stored as the proxy method and invoked on each call.\n     *\n     * @param method - HTTP method (GET, POST, etc.)\n     * @param path - URL path\n     * @returns A Service that invokes the route\n     */\n    createRouteInvoker(method: string, path: string): Service<MethodMeta, WpResponse<unknown>> {\n        // Use routeMap for O(1) lookup (not linear search!)\n        const key = this.createRouteKey(method, path);\n        const routeWithMeta = this.routeMap.get(key);\n\n        if (!routeWithMeta) {\n            throw new Error(`Route not found: ${method} ${path}`);\n        }\n\n        // Setup filter chain ONCE (not on every invocation!)\n        return this.createRouteHandler(routeWithMeta);\n    }\n\n    /**\n     * Look up the RouteMetadata (incl. authMeta) for a registered route by method+path.\n     * Used to build a MethodMeta for an in-process dispatch (e.g. a delivered cloud\n     * task) so the filter chain sees the same routeMeta production HTTP would.\n     *\n     * @returns the route's RouteMetadata, or undefined if no route is registered.\n     */\n    getRouteMeta(method: string, path: string): RouteMetadata | undefined {\n        const key = this.createRouteKey(method, path);\n        return this.routeMap.get(key)?.definition.routeMeta;\n    }\n}\n"]}
+{"version":3,"file":"RouteBuilderImpl.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RouteBuilderImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container, injectable } from 'inversify';\nimport { Request, Response, NextFunction } from 'express';\nimport { RouteBuilder, RouteDefinition, FilterDefinition } from './WebAppMeta';\nimport { provideSingleton } from '@webpieces/core-context';\nimport { RouteHandler } from './RouteHandler';\nimport { MethodMeta } from '@webpieces/http-filters';\nimport { RouteMetadata } from '@webpieces/core-util';\nimport { WpResponse, Service } from '@webpieces/http-filters';\nimport { FilterMatcher, HttpFilter } from './FilterMatcher';\nimport { LogManager } from '@webpieces/core-util';\n\nconst log = LogManager.getLogger('RouteBuilder');\n\n/**\n * Express route handler function type.\n * Used by wrapExpress to create handlers that Express can call.\n */\nexport type ExpressRouteHandler = (\n    req: Request,\n    res: Response,\n    next: NextFunction,\n) => Promise<void>;\n\n/**\n * FilterWithMeta - Pairs a resolved filter instance with its definition.\n * Stores both the DI-resolved filter and the metadata needed for matching.\n */\nexport class FilterWithMeta {\n    constructor(\n        public filter: HttpFilter,\n        public definition: FilterDefinition,\n    ) {}\n}\n\n/**\n * RouteHandlerImpl - Concrete implementation of RouteHandler.\n * Wraps a resolved controller and method to invoke on each request.\n */\nexport class RouteHandlerImpl<TResult> implements RouteHandler<TResult> {\n    constructor(\n        private controller: Record<string, unknown>,\n        private method: (this: unknown, requestDto?: unknown) => Promise<TResult>,\n    ) {}\n\n    async execute(meta: MethodMeta): Promise<TResult> {\n        // Invoke the method with requestDto from meta\n        // The controller is already resolved - no DI lookup on every request!\n        const result: TResult = await this.method.call(this.controller, meta.requestDto);\n        return result;\n    }\n}\n/**\n * RouteHandlerWithMeta - Pairs a route handler with its definition.\n * Stores both the handler (which wraps the DI-resolved controller) and the route metadata.\n *\n * We use unknown for the generic type since we store different TResult types in the same Map.\n * Type safety is maintained through the generic on RouteDefinition at registration time.\n */\nexport class RouteHandlerWithMeta {\n    constructor(\n        public invokeControllerHandler: RouteHandler<unknown>,\n        public definition: RouteDefinition,\n    ) {}\n}\n\n/**\n * RouteBuilderImpl - Concrete implementation of RouteBuilder interface.\n *\n * Similar to Java WebPieces RouteBuilder, this class is responsible for:\n * 1. Registering routes with their handlers\n * 2. Registering filters with priority\n *\n * This class is explicit (not anonymous) to:\n * - Improve traceability and debugging\n * - Make the code easier to understand\n * - Enable better IDE navigation (Cmd+Click on addRoute works!)\n *\n * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()\n * but needs appContainer to resolve filters/controllers. The container is set via\n * setContainer() after appContainer is created (late binding pattern).\n */\n@provideSingleton()\n@injectable()\nexport class RouteBuilderImpl implements RouteBuilder {\n    private routes: RouteHandlerWithMeta[] = [];\n    private filterRegistry: Array<FilterWithMeta> = [];\n    private container?: Container;\n\n    /**\n     * Map for O(1) route lookup by method:path.\n     * Used by both addRoute() and createRouteInvoker() for fast route access.\n     */\n    private routeMap: Map<string, RouteHandlerWithMeta> = new Map();\n\n    /**\n     * Create route key for consistent lookup.\n     * Key format: \"${METHOD}:${path}\" (e.g., \"POST:/search/item\")\n     */\n    private createRouteKey(method: string, path: string): string {\n        return `${method.toUpperCase()}:${path}`;\n    }\n\n    /**\n     * Set the DI container used for resolving filters and controllers.\n     * Called by WebpiecesCoreServer after appContainer is created.\n     *\n     * @param container - The application DI container (appContainer)\n     */\n    setContainer(container: Container): void {\n        this.container = container;\n    }\n\n    /**\n     * Register a route with the router.\n     *\n     * Uses createRouteHandlerWithMeta() to create the handler, then stores it\n     * in both the routes array and the routeMap for O(1) lookup.\n     *\n     * @param route - Route definition with controller class and method name\n     */\n    addRoute(route: RouteDefinition): void {\n        const routeWithMeta = this.createRouteHandlerWithMeta(route);\n        this.routes.push(routeWithMeta);\n\n        // Also add to map for O(1) lookup by method:path\n        const key = this.createRouteKey(\n            route.routeMeta.httpMethod,\n            route.routeMeta.path\n        );\n        this.routeMap.set(key, routeWithMeta);\n    }\n\n    /**\n     * Create RouteHandlerWithMeta from a RouteDefinition.\n     *\n     * Resolves controller from DI container ONCE and creates a handler that\n     * invokes the controller method with the request DTO.\n     *\n     * This method is used by:\n     * - addRoute() for production route registration\n     * - createRouteInvoker() for test clients (via createApiClient)\n     *\n     * @param route - Route definition with controller class and method name\n     * @returns RouteHandlerWithMeta containing the handler and route definition\n     */\n    private createRouteHandlerWithMeta<TResult = unknown>(\n        route: RouteDefinition,\n    ): RouteHandlerWithMeta {\n        if (!this.container) {\n            throw new Error('Container not set. Call setContainer() before registering routes.');\n        }\n\n        const routeMeta = route.routeMeta;\n\n        // Resolve controller instance from DI container ONCE (not on every request!)\n        const controller = this.container.get(route.controllerClass) as Record<string, unknown>;\n\n        // Get the controller method\n        const method = controller[routeMeta.methodName];\n        if (typeof method !== 'function') {\n            const controllerName = (route.controllerClass as { name?: string }).name || 'Unknown';\n            throw new Error(\n                `Method ${routeMeta.methodName} not found on controller ${controllerName}`,\n            );\n        }\n\n        const handler = new RouteHandlerImpl<TResult>(\n            controller,\n            method as (this: unknown, requestDto?: unknown) => Promise<TResult>\n        );\n\n        // Return handler with route definition\n        return new RouteHandlerWithMeta(\n            handler as RouteHandler<unknown>,\n            route,\n        );\n    }\n\n    /**\n     * Register a filter with the filter chain.\n     *\n     * Resolves the filter from DI container and pairs it with the filter definition.\n     * The definition includes pattern information used for route-specific filtering.\n     *\n     * @param filterDef - Filter definition with priority, filter class, and optional filepath pattern\n     */\n    addFilter(filterDef: FilterDefinition): void {\n        if (!this.container) {\n            throw new Error('Container not set. Call setContainer() before registering filters.');\n        }\n\n        // Resolve filter instance from DI container\n        const filter = this.container.get<HttpFilter>(filterDef.filterClass);\n\n        // Store filter with its definition\n        const filterWithMeta = new FilterWithMeta(filter, filterDef);\n        this.filterRegistry.push(filterWithMeta);\n    }\n\n    /**\n     * Get all registered routes.\n     *\n     * @returns Map of routes with handlers and definitions, keyed by \"METHOD:path\"\n     */\n    getRoutes(): RouteHandlerWithMeta[] {\n        return this.routes;\n    }\n\n    /**\n     * Get all filters sorted by priority (highest priority first).\n     *\n     * @returns Array of FilterWithMeta sorted by priority\n     */\n    getSortedFilters(): Array<FilterWithMeta> {\n        return [...this.filterRegistry].sort(\n            (a, b) => b.definition.priority - a.definition.priority,\n        );\n    }\n\n    /**\n     * Cached filter definitions for lazy route setup.\n     */\n    private cachedFilterDefinitions?: FilterDefinition[];\n\n    /**\n     * Get filter definitions, computing once and caching.\n     */\n    private getFilterDefinitions(): FilterDefinition[] {\n        if (!this.cachedFilterDefinitions) {\n            const sortedFilters = this.getSortedFilters();\n            this.cachedFilterDefinitions = sortedFilters.map((fwm) => {\n                const def = fwm.definition;\n                def.filter = fwm.filter;\n                return def;\n            });\n        }\n        return this.cachedFilterDefinitions;\n    }\n\n    /**\n     * Setup a single route by creating its filter chain.\n     * This is called lazily by createHandler() and getRouteService().\n     *\n     * Creates a Service that wraps the filter chain and controller invocation.\n     * The service is DTO-only and has no Express dependency.\n     *\n     * @param key - Route key in format \"METHOD:path\"\n     * @param routeWithMeta - Route handler with metadata\n     * @returns The service for this route\n     */\n    public createRouteHandler(\n        routeWithMeta: RouteHandlerWithMeta,\n    ): Service<MethodMeta, WpResponse<unknown>> {\n        const route = routeWithMeta.definition;\n        const routeMeta = route.routeMeta;\n\n        log.info(`[RouteBuilder] Setting up route: ${routeMeta.httpMethod} ${routeMeta.path}`);\n\n        // Get cached filter definitions\n        const filterDefinitions = this.getFilterDefinitions();\n\n        // Find matching filters for this route\n        const matchingFilters = FilterMatcher.findMatchingFilters(\n            route.controllerFilepath,\n            filterDefinitions,\n        );\n\n        // Create service that wraps the controller execution\n        const controllerService: Service<MethodMeta, WpResponse<unknown>> = {\n            invoke: async (meta: MethodMeta): Promise<WpResponse<unknown>> => {\n                const result = await routeWithMeta.invokeControllerHandler.execute(meta);\n                // A void endpoint (e.g. a @PubSub cloud-task handler returning Promise<void>)\n                // yields undefined; coerce to {} so the response is a non-null JSON body\n                // (downstream LogApiCall/serialization require one), mirroring `result ?? {}`.\n                return new WpResponse(result ?? {});\n            },\n        };\n\n        if (matchingFilters.length === 0) {\n            throw new Error(\"No filters found for route. Check filter definitions as you must have at least ContextFilter\");\n        }\n\n        // Chain filters: highest priority (first in array) should run first (be outermost)\n        // Build from innermost (lowest priority) to outermost (highest priority)\n        // Start with controller, then wrap with filters in reverse priority order\n        let service: Service<MethodMeta, WpResponse<unknown>> = controllerService;\n        for (let i = matchingFilters.length - 1; i >= 0; i--) {\n            service = matchingFilters[i].chainService(service);\n        }\n\n        return service;\n    }\n\n    /**\n     * Create an invoker function for a route (for testing via createApiClient).\n     * Uses routeMap for O(1) lookup, sets up the filter chain ONCE,\n     * and returns a Service that can be called multiple times without\n     * recreating the filter chain.\n     *\n     * This method is called by WebpiecesServer.createApiClient() during proxy setup.\n     * The returned Service is stored as the proxy method and invoked on each call.\n     *\n     * @param method - HTTP method (GET, POST, etc.)\n     * @param path - URL path\n     * @returns A Service that invokes the route\n     */\n    createRouteInvoker(method: string, path: string): Service<MethodMeta, WpResponse<unknown>> {\n        // Use routeMap for O(1) lookup (not linear search!)\n        const key = this.createRouteKey(method, path);\n        const routeWithMeta = this.routeMap.get(key);\n\n        if (!routeWithMeta) {\n            throw new Error(`Route not found: ${method} ${path}`);\n        }\n\n        // Setup filter chain ONCE (not on every invocation!)\n        return this.createRouteHandler(routeWithMeta);\n    }\n\n    /**\n     * Look up the RouteMetadata (incl. authMeta) for a registered route by method+path.\n     * Used to build a MethodMeta for an in-process dispatch (e.g. a delivered cloud\n     * task) so the filter chain sees the same routeMeta production HTTP would.\n     *\n     * @returns the route's RouteMetadata, or undefined if no route is registered.\n     */\n    getRouteMeta(method: string, path: string): RouteMetadata | undefined {\n        const key = this.createRouteKey(method, path);\n        return this.routeMap.get(key)?.definition.routeMeta;\n    }\n}\n"]}

package/src/RouteHandler.d.ts

@@ -1,4 +1,4 @@
-import { MethodMeta } from './MethodMeta';
+import { MethodMeta } from '@webpieces/http-filters';
 /**
  * Handler class for routes.
  * Takes a MethodMeta and returns the controller method result.

package/src/RouteHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouteHandler.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RouteHandler.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACH,MAAsB,YAAY;CAOjC;AAPD,oCAOC","sourcesContent":["import { MethodMeta } from './MethodMeta';\n\n/**\n * Handler class for routes.\n * Takes a MethodMeta and returns the controller method result.\n *\n * Generic type parameter TResult represents the return type of the controller method.\n * Example: RouteHandler<SaveResponse> for a method that returns Promise<SaveResponse>\n *\n * Using unknown as default instead of any forces type safety - consumers must\n * handle the result appropriately rather than assuming any type.\n *\n * This is a class instead of a function type to make it easier to trace\n * who is calling what in the debugger/IDE.\n */\nexport abstract class RouteHandler<TResult = unknown> {\n    /**\n     * Execute the route handler.\n     * @param meta - The method metadata containing request info and params\n     * @returns Promise of the controller method result\n     */\n    abstract execute(meta: MethodMeta): Promise<TResult>;\n}\n"]}
+{"version":3,"file":"RouteHandler.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RouteHandler.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACH,MAAsB,YAAY;CAOjC;AAPD,oCAOC","sourcesContent":["import { MethodMeta } from '@webpieces/http-filters';\n\n/**\n * Handler class for routes.\n * Takes a MethodMeta and returns the controller method result.\n *\n * Generic type parameter TResult represents the return type of the controller method.\n * Example: RouteHandler<SaveResponse> for a method that returns Promise<SaveResponse>\n *\n * Using unknown as default instead of any forces type safety - consumers must\n * handle the result appropriately rather than assuming any type.\n *\n * This is a class instead of a function type to make it easier to trace\n * who is calling what in the debugger/IDE.\n */\nexport abstract class RouteHandler<TResult = unknown> {\n    /**\n     * Execute the route handler.\n     * @param meta - The method metadata containing request info and params\n     * @returns Promise of the controller method result\n     */\n    abstract execute(meta: MethodMeta): Promise<TResult>;\n}\n"]}

package/src/WebAppMeta.d.ts

@@ -1,5 +1,5 @@
 import { ContainerModule } from 'inversify';
-import { RouteMetadata } from "@webpieces/http-api";
+import { RouteMetadata } from "@webpieces/core-util";
 /**
  * Represents a route configuration that can be registered with the router.
  * Similar to Java WebPieces Routes interface.

package/src/WebAppMeta.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebAppMeta.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/WebAppMeta.ts"],"names":[],"mappings":";;;AAuBA;;;;;GAKG;AACH,MAAa,eAAe;IAEb;IACA;IACA;IAHX,YACW,SAAwB,EACxB,eAAoB,EACpB,kBAA2B;QAF3B,cAAS,GAAT,SAAS,CAAe;QACxB,oBAAe,GAAf,eAAe,CAAK;QACpB,uBAAkB,GAAlB,kBAAkB,CAAS;IACnC,CAAC;CACP;AAND,0CAMC;AAED;;;;;;;;;GASG;AACH,MAAa,gBAAgB;IACzB,QAAQ,CAAS;IACjB,WAAW,CAAM;IACjB,MAAM,CAAO,CAAC,+DAA+D;IAE7E;;;OAGG;IACH,eAAe,CAAS;IAExB,YAAY,QAAgB,EAAE,WAAgB,EAAE,eAAuB;QACnE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,4BAA4B;IACzD,CAAC;CACJ;AAjBD,4CAiBC;AAuBD;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC","sourcesContent":["import { ContainerModule } from 'inversify';\nimport {RouteMetadata} from \"@webpieces/http-api\";\n\n/**\n * Represents a route configuration that can be registered with the router.\n * Similar to Java WebPieces Routes interface.\n */\nexport interface Routes {\n    /**\n     * Configure routes using the provided RouteBuilder.\n     */\n    configure(routeBuilder: RouteBuilder): void;\n}\n\n/**\n * Builder for registering routes.\n * Will be implemented in http-server package.\n */\nexport interface RouteBuilder {\n    addRoute(route: RouteDefinition): void;\n    addFilter(filter: FilterDefinition): void;\n}\n\n/**\n * Definition of a single route.\n *\n * Generic type parameter TResult represents the return type of the route handler.\n * This provides type safety for the entire request/response cycle.\n */\nexport class RouteDefinition {\n    constructor(\n        public routeMeta: RouteMetadata,\n        public controllerClass: any,\n        public controllerFilepath?: string,\n    ) {}\n}\n\n/**\n * Definition of a filter with priority.\n *\n * Use filepathPattern to scope filters to specific controllers:\n *   - 'src/controllers/admin/**' + '/*.ts' - All admin controllers\n *   - '**' + '/admin/**' - Any file in admin directories\n *   - '**' + '/UserController.ts' - Specific controller file\n *\n * If filepathPattern is not specified, the filter matches all controllers.\n */\nexport class FilterDefinition {\n    priority: number;\n    filterClass: any;\n    filter?: any; // Filter instance (set by RouteBuilder when resolving from DI)\n\n    /**\n     * Glob pattern to match controller file paths.\n     * If not specified, defaults to matching all controllers.\n     */\n    filepathPattern: string;\n\n    constructor(priority: number, filterClass: any, filepathPattern: string) {\n        this.priority = priority;\n        this.filterClass = filterClass;\n        this.filepathPattern = filepathPattern;\n        this.filter = undefined; // Set later by RouteBuilder\n    }\n}\n\n\n/**\n * Main application metadata interface.\n * Similar to Java WebPieces WebAppMeta.\n *\n * This is the entry point that WebpiecesServer calls to configure your application.\n */\nexport interface WebAppMeta {\n    /**\n     * Returns the list of Inversify container modules for dependency injection.\n     * Similar to getGuiceModules() in Java.\n     */\n    getDIModules(): ContainerModule[];\n\n    /**\n     * Returns the list of route configurations.\n     * Similar to getRouteModules() in Java.\n     */\n    getRoutes(): Routes[];\n}\n\n/**\n * DI token for WebAppMeta injection.\n */\nexport const WEBAPP_META_TOKEN = Symbol.for('WebAppMeta');\n"]}
+{"version":3,"file":"WebAppMeta.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/WebAppMeta.ts"],"names":[],"mappings":";;;AAuBA;;;;;GAKG;AACH,MAAa,eAAe;IAEb;IACA;IACA;IAHX,YACW,SAAwB,EACxB,eAAoB,EACpB,kBAA2B;QAF3B,cAAS,GAAT,SAAS,CAAe;QACxB,oBAAe,GAAf,eAAe,CAAK;QACpB,uBAAkB,GAAlB,kBAAkB,CAAS;IACnC,CAAC;CACP;AAND,0CAMC;AAED;;;;;;;;;GASG;AACH,MAAa,gBAAgB;IACzB,QAAQ,CAAS;IACjB,WAAW,CAAM;IACjB,MAAM,CAAO,CAAC,+DAA+D;IAE7E;;;OAGG;IACH,eAAe,CAAS;IAExB,YAAY,QAAgB,EAAE,WAAgB,EAAE,eAAuB;QACnE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,4BAA4B;IACzD,CAAC;CACJ;AAjBD,4CAiBC;AAuBD;;GAEG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC","sourcesContent":["import { ContainerModule } from 'inversify';\nimport {RouteMetadata} from \"@webpieces/core-util\";\n\n/**\n * Represents a route configuration that can be registered with the router.\n * Similar to Java WebPieces Routes interface.\n */\nexport interface Routes {\n    /**\n     * Configure routes using the provided RouteBuilder.\n     */\n    configure(routeBuilder: RouteBuilder): void;\n}\n\n/**\n * Builder for registering routes.\n * Will be implemented in http-server package.\n */\nexport interface RouteBuilder {\n    addRoute(route: RouteDefinition): void;\n    addFilter(filter: FilterDefinition): void;\n}\n\n/**\n * Definition of a single route.\n *\n * Generic type parameter TResult represents the return type of the route handler.\n * This provides type safety for the entire request/response cycle.\n */\nexport class RouteDefinition {\n    constructor(\n        public routeMeta: RouteMetadata,\n        public controllerClass: any,\n        public controllerFilepath?: string,\n    ) {}\n}\n\n/**\n * Definition of a filter with priority.\n *\n * Use filepathPattern to scope filters to specific controllers:\n *   - 'src/controllers/admin/**' + '/*.ts' - All admin controllers\n *   - '**' + '/admin/**' - Any file in admin directories\n *   - '**' + '/UserController.ts' - Specific controller file\n *\n * If filepathPattern is not specified, the filter matches all controllers.\n */\nexport class FilterDefinition {\n    priority: number;\n    filterClass: any;\n    filter?: any; // Filter instance (set by RouteBuilder when resolving from DI)\n\n    /**\n     * Glob pattern to match controller file paths.\n     * If not specified, defaults to matching all controllers.\n     */\n    filepathPattern: string;\n\n    constructor(priority: number, filterClass: any, filepathPattern: string) {\n        this.priority = priority;\n        this.filterClass = filterClass;\n        this.filepathPattern = filepathPattern;\n        this.filter = undefined; // Set later by RouteBuilder\n    }\n}\n\n\n/**\n * Main application metadata interface.\n * Similar to Java WebPieces WebAppMeta.\n *\n * This is the entry point that WebpiecesServer calls to configure your application.\n */\nexport interface WebAppMeta {\n    /**\n     * Returns the list of Inversify container modules for dependency injection.\n     * Similar to getGuiceModules() in Java.\n     */\n    getDIModules(): ContainerModule[];\n\n    /**\n     * Returns the list of route configurations.\n     * Similar to getRouteModules() in Java.\n     */\n    getRoutes(): Routes[];\n}\n\n/**\n * DI token for WebAppMeta injection.\n */\nexport const WEBAPP_META_TOKEN = Symbol.for('WebAppMeta');\n"]}

package/src/decorators.d.ts

@@ -1,80 +1,41 @@
 import 'reflect-metadata';
-import type { ServiceIdentifier } from 'inversify';
 /**
  * Metadata keys for server-side routing.
  * These are specific to the routing package (server-side only).
  */
 export declare const ROUTING_METADATA_KEYS: {
-    CONTROLLER: string;
-    NOT_CONTROLLER: string;
-    API_IMPLEMENTATION: string;
+    DOCUMENT_DESIGN: string;
     SOURCE_FILEPATH: string;
 };
 /**
- * @Controller decorator — marks a controller (server-side only).
+ * @DocumentDesign decorator — marks a class as a DI-design ROOT: the top-of-DAG class whose
+ * dependency-injection tree the design-doc generator walks and renders into that project's
+ * `design.json` / `design.md` / `design.html`.
  *
- * Usage:
- * ```typescript
- * @Controller()
- * export class SaveController {
- *   // ...
- * }
- * ```
- */
-export declare function Controller(): ClassDecorator;
-/**
- * Helper function to check if a class is a controller.
- * Server-side only.
- */
-export declare function isController(controllerClass: any): boolean;
-/**
- * @NotController decorator — explicitly marks a class that implements/extends an `*Api` contract
- * as deliberately NOT a controller (e.g. a simulator, an in-process client, a test double).
+ * It is the single marker for every kind of design root — server controllers (the class an
+ * `ApiRoutingFactory(Api, Controller)` binds) and library implementation classes (the top class a
+ * `role:designed-lib` project exports and binds in its `ContainerModule`). A `role:designed-lib`
+ * project is REQUIRED to have at least one `@DocumentDesign` class — otherwise the DI-graph
+ * generator has no root and fails.
  *
- * The `enforce-controller-naming` rule requires every class whose heritage ends in `*Api` to declare
- * its intent: either `@Controller` (then it must be named `{Something}Controller` and live in a
- * `{something}-controller.ts` file) OR `@NotController` (then it is exempt from those naming rules).
- * This is a pure marker — it registers no route and only records intent for the lint rule.
+ * This is a pure marker read STATICALLY by the DI-graph analyzer (by decorator name); nothing reads
+ * its runtime metadata. Routing does NOT depend on it — routes are wired explicitly by
+ * `ApiRoutingFactory(Api, Controller)`, which reads `@ApiPath`/`@Endpoint` off the API class and
+ * `@SourceFile` off the controller. The metadata below exists only for symmetry/debuggability.
  *
  * Usage:
  * ```typescript
- * @NotController()
- * export class Server2Simulator { ... }
- * ```
- */
-export declare function NotController(): ClassDecorator;
-/**
- * Helper function to check if a class is explicitly marked as NOT a controller.
- * Server-side only.
- */
-export declare function isNotController(controllerClass: object): boolean;
-/**
- * @ApiImplementation decorator — marks the top-of-DAG implementation class in a LIBRARY
- * (a `role:designed-lib` project) whose DI design should be generated.
- *
- * It is the library-side analog of `@Controller`: where a server's design roots on its
- * `@Controller` classes, a designed-lib's design roots on its `@ApiImplementation` classes.
- * A `role:designed-lib` project is REQUIRED to have at least one such class — otherwise the
- * DI-graph generator has no root and fails.
- *
- * Put it on the top implementation class a library exports and binds in its `ContainerModule`
- * (e.g. the class an app injects to drive the library). Like `@Controller`, this is a pure
- * marker read by the static DI-graph analyzer (by decorator name); it registers nothing at
- * runtime on its own.
- *
- * Usage:
- * ```typescript
- * @ApiImplementation()
+ * @DocumentDesign()
  * @injectable()
- * export class AgentHandler { ... }
+ * export class SaveController extends SaveApi { ... }
  * ```
  */
-export declare function ApiImplementation(): ClassDecorator;
+export declare function DocumentDesign(): ClassDecorator;
 /**
- * Helper function to check if a class is marked as an API implementation (designed-lib root).
+ * Helper function to check if a class is marked as a DI-design root.
  * Server/library side only.
  */
-export declare function isApiImplementation(implClass: object): boolean;
+export declare function isDocumentDesign(designClass: object): boolean;
 /**
  * SourceFile decorator to explicitly set the source filepath for a controller.
  * This is used by filter matching to determine which filters apply to the controller.
@@ -83,54 +44,9 @@ export declare function isApiImplementation(implClass: object): boolean;
  *
  * Usage:
  * @SourceFile('src/controllers/admin/UserController.ts')
- * @Controller()
+ * @DocumentDesign()
  * export class UserController { ... }
  *
  * @param filepath - The source filepath of the controller
  */
 export declare function SourceFile(filepath: string): ClassDecorator;
-/**
- * Provides a singleton-scoped dependency.
- * When called without arguments, the decorated class binds to itself.
- *
- * Server-side only - registers classes in the DI container.
- *
- * Usage:
- * ```typescript
- * @provideSingleton()
- * @Controller()
- * export class SaveController {
- *   // ...
- * }
- * ```
- */
-export declare function provideSingleton(): (target: any) => any;
-/**
- * Provides a singleton-scoped dependency bound to a specific token (Symbol or abstract class).
- * Use this in libraries/apis-external/** to bind an impl to the Symbol defined in libraries/apis/**.
- *
- * Usage:
- * ```typescript
- * import { SOME_API_TOKEN } from '@myorg/some-api';
- *
- * @provideSingletonAs(SOME_API_TOKEN)
- * export class SomeApiImpl { ... }
- * ```
- */
-export declare function provideSingletonAs<T>(serviceIdentifier: ServiceIdentifier<T>): ClassDecorator;
-/**
- * Provides a transient-scoped dependency (new instance every time).
- * When called without arguments, the decorated class binds to itself.
- *
- * Server-side only - registers classes in the DI container.
- *
- * Usage:
- * ```typescript
- * @provideTransient()
- * @Controller()
- * export class TransientController {
- *   // ...
- * }
- * ```
- */
-export declare function provideTransient(): (target: any) => any;

package/src/decorators.js

@@ -1,110 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ROUTING_METADATA_KEYS = void 0;
-exports.Controller = Controller;
-exports.isController = isController;
-exports.NotController = NotController;
-exports.isNotController = isNotController;
-exports.ApiImplementation = ApiImplementation;
-exports.isApiImplementation = isApiImplementation;
+exports.DocumentDesign = DocumentDesign;
+exports.isDocumentDesign = isDocumentDesign;
 exports.SourceFile = SourceFile;
-exports.provideSingleton = provideSingleton;
-exports.provideSingletonAs = provideSingletonAs;
-exports.provideTransient = provideTransient;
 require("reflect-metadata");
-const binding_decorators_1 = require("@inversifyjs/binding-decorators");
 /**
  * Metadata keys for server-side routing.
  * These are specific to the routing package (server-side only).
  */
 exports.ROUTING_METADATA_KEYS = {
-    CONTROLLER: 'webpieces:controller',
-    NOT_CONTROLLER: 'webpieces:not-controller',
-    API_IMPLEMENTATION: 'webpieces:api-implementation',
+    DOCUMENT_DESIGN: 'webpieces:document-design',
     SOURCE_FILEPATH: 'webpieces:source-filepath',
 };
 /**
- * @Controller decorator — marks a controller (server-side only).
+ * @DocumentDesign decorator — marks a class as a DI-design ROOT: the top-of-DAG class whose
+ * dependency-injection tree the design-doc generator walks and renders into that project's
+ * `design.json` / `design.md` / `design.html`.
  *
- * Usage:
- * ```typescript
- * @Controller()
- * export class SaveController {
- *   // ...
- * }
- * ```
- */
-function Controller() {
-    return (target) => {
-        Reflect.defineMetadata(exports.ROUTING_METADATA_KEYS.CONTROLLER, true, target);
-    };
-}
-/**
- * Helper function to check if a class is a controller.
- * Server-side only.
- */
-function isController(controllerClass) {
-    return Reflect.getMetadata(exports.ROUTING_METADATA_KEYS.CONTROLLER, controllerClass) === true;
-}
-/**
- * @NotController decorator — explicitly marks a class that implements/extends an `*Api` contract
- * as deliberately NOT a controller (e.g. a simulator, an in-process client, a test double).
+ * It is the single marker for every kind of design root — server controllers (the class an
+ * `ApiRoutingFactory(Api, Controller)` binds) and library implementation classes (the top class a
+ * `role:designed-lib` project exports and binds in its `ContainerModule`). A `role:designed-lib`
+ * project is REQUIRED to have at least one `@DocumentDesign` class — otherwise the DI-graph
+ * generator has no root and fails.
  *
- * The `enforce-controller-naming` rule requires every class whose heritage ends in `*Api` to declare
- * its intent: either `@Controller` (then it must be named `{Something}Controller` and live in a
- * `{something}-controller.ts` file) OR `@NotController` (then it is exempt from those naming rules).
- * This is a pure marker — it registers no route and only records intent for the lint rule.
+ * This is a pure marker read STATICALLY by the DI-graph analyzer (by decorator name); nothing reads
+ * its runtime metadata. Routing does NOT depend on it — routes are wired explicitly by
+ * `ApiRoutingFactory(Api, Controller)`, which reads `@ApiPath`/`@Endpoint` off the API class and
+ * `@SourceFile` off the controller. The metadata below exists only for symmetry/debuggability.
  *
  * Usage:
  * ```typescript
- * @NotController()
- * export class Server2Simulator { ... }
- * ```
- */
-function NotController() {
-    return (target) => {
-        Reflect.defineMetadata(exports.ROUTING_METADATA_KEYS.NOT_CONTROLLER, true, target);
-    };
-}
-/**
- * Helper function to check if a class is explicitly marked as NOT a controller.
- * Server-side only.
- */
-function isNotController(controllerClass) {
-    return Reflect.getMetadata(exports.ROUTING_METADATA_KEYS.NOT_CONTROLLER, controllerClass) === true;
-}
-/**
- * @ApiImplementation decorator — marks the top-of-DAG implementation class in a LIBRARY
- * (a `role:designed-lib` project) whose DI design should be generated.
- *
- * It is the library-side analog of `@Controller`: where a server's design roots on its
- * `@Controller` classes, a designed-lib's design roots on its `@ApiImplementation` classes.
- * A `role:designed-lib` project is REQUIRED to have at least one such class — otherwise the
- * DI-graph generator has no root and fails.
- *
- * Put it on the top implementation class a library exports and binds in its `ContainerModule`
- * (e.g. the class an app injects to drive the library). Like `@Controller`, this is a pure
- * marker read by the static DI-graph analyzer (by decorator name); it registers nothing at
- * runtime on its own.
- *
- * Usage:
- * ```typescript
- * @ApiImplementation()
+ * @DocumentDesign()
  * @injectable()
- * export class AgentHandler { ... }
+ * export class SaveController extends SaveApi { ... }
  * ```
  */
-function ApiImplementation() {
+function DocumentDesign() {
     return (target) => {
-        Reflect.defineMetadata(exports.ROUTING_METADATA_KEYS.API_IMPLEMENTATION, true, target);
+        Reflect.defineMetadata(exports.ROUTING_METADATA_KEYS.DOCUMENT_DESIGN, true, target);
     };
 }
 /**
- * Helper function to check if a class is marked as an API implementation (designed-lib root).
+ * Helper function to check if a class is marked as a DI-design root.
  * Server/library side only.
  */
-function isApiImplementation(implClass) {
-    return Reflect.getMetadata(exports.ROUTING_METADATA_KEYS.API_IMPLEMENTATION, implClass) === true;
+function isDocumentDesign(designClass) {
+    return Reflect.getMetadata(exports.ROUTING_METADATA_KEYS.DOCUMENT_DESIGN, designClass) === true;
 }
 /**
  * SourceFile decorator to explicitly set the source filepath for a controller.
@@ -114,7 +56,7 @@ function isApiImplementation(implClass) {
  *
  * Usage:
  * @SourceFile('src/controllers/admin/UserController.ts')
- * @Controller()
+ * @DocumentDesign()
  * export class UserController { ... }
  *
  * @param filepath - The source filepath of the controller
@@ -124,59 +66,7 @@ function SourceFile(filepath) {
         Reflect.defineMetadata(exports.ROUTING_METADATA_KEYS.SOURCE_FILEPATH, filepath, target);
     };
 }
-/**
- * Provides a singleton-scoped dependency.
- * When called without arguments, the decorated class binds to itself.
- *
- * Server-side only - registers classes in the DI container.
- *
- * Usage:
- * ```typescript
- * @provideSingleton()
- * @Controller()
- * export class SaveController {
- *   // ...
- * }
- * ```
- */
-function provideSingleton() {
-    return (target) => {
-        return (0, binding_decorators_1.provide)(target, (bind) => bind.inSingletonScope())(target);
-    };
-}
-/**
- * Provides a singleton-scoped dependency bound to a specific token (Symbol or abstract class).
- * Use this in libraries/apis-external/** to bind an impl to the Symbol defined in libraries/apis/**.
- *
- * Usage:
- * ```typescript
- * import { SOME_API_TOKEN } from '@myorg/some-api';
- *
- * @provideSingletonAs(SOME_API_TOKEN)
- * export class SomeApiImpl { ... }
- * ```
- */
-function provideSingletonAs(serviceIdentifier) {
-    return (0, binding_decorators_1.provide)(serviceIdentifier, (bind) => bind.inSingletonScope());
-}
-/**
- * Provides a transient-scoped dependency (new instance every time).
- * When called without arguments, the decorated class binds to itself.
- *
- * Server-side only - registers classes in the DI container.
- *
- * Usage:
- * ```typescript
- * @provideTransient()
- * @Controller()
- * export class TransientController {
- *   // ...
- * }
- * ```
- */
-function provideTransient() {
-    return (target) => {
-        return (0, binding_decorators_1.provide)(target)(target);
-    };
-}
+// NOTE: provideSingleton / provideSingletonAs / provideTransient moved to
+// @webpieces/core-context (the shared DI seam). http-routing re-exports them
+// from there in index.ts for back-compat.
 //# sourceMappingURL=decorators.js.map

package/src/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/decorators.ts"],"names":[],"mappings":";;;AA0BA,gCAIC;AAMD,oCAEC;AAiBD,sCAIC;AAMD,0CAEC;AAuBD,8CAIC;AAMD,kDAEC;AAeD,gCAIC;AAiBD,4CAIC;AAcD,gDAEC;AAiBD,4CAIC;AAnLD,4BAA0B;AAC1B,wEAA0D;AAG1D;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACjC,UAAU,EAAE,sBAAsB;IAClC,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,eAAe,EAAE,2BAA2B;CAC/C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAgB,UAAU;IACtB,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,eAAoB;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,IAAI,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,aAAa;IACzB,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,eAAuB;IACnD,OAAO,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,cAAc,EAAE,eAAe,CAAC,KAAK,IAAI,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,iBAAiB;IAC7B,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,kBAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,SAAiB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,kBAAkB,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;AAC7F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,UAAU,CAAC,QAAgB;IACvC,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB;IAC5B,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,OAAO,IAAA,4BAAO,EAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,kBAAkB,CAAI,iBAAuC;IACzE,OAAO,IAAA,4BAAO,EAAC,iBAAiB,EAAE,CAAC,IAAiC,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACtG,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB;IAC5B,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,OAAO,IAAA,4BAAO,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC;AACN,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { provide } from '@inversifyjs/binding-decorators';\nimport type { BindInWhenOnFluentSyntax, ServiceIdentifier } from 'inversify';\n\n/**\n * Metadata keys for server-side routing.\n * These are specific to the routing package (server-side only).\n */\nexport const ROUTING_METADATA_KEYS = {\n    CONTROLLER: 'webpieces:controller',\n    NOT_CONTROLLER: 'webpieces:not-controller',\n    API_IMPLEMENTATION: 'webpieces:api-implementation',\n    SOURCE_FILEPATH: 'webpieces:source-filepath',\n};\n\n/**\n * @Controller decorator — marks a controller (server-side only).\n *\n * Usage:\n * ```typescript\n * @Controller()\n * export class SaveController {\n *   // ...\n * }\n * ```\n */\nexport function Controller(): ClassDecorator {\n    return (target: any) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.CONTROLLER, true, target);\n    };\n}\n\n/**\n * Helper function to check if a class is a controller.\n * Server-side only.\n */\nexport function isController(controllerClass: any): boolean {\n    return Reflect.getMetadata(ROUTING_METADATA_KEYS.CONTROLLER, controllerClass) === true;\n}\n\n/**\n * @NotController decorator — explicitly marks a class that implements/extends an `*Api` contract\n * as deliberately NOT a controller (e.g. a simulator, an in-process client, a test double).\n *\n * The `enforce-controller-naming` rule requires every class whose heritage ends in `*Api` to declare\n * its intent: either `@Controller` (then it must be named `{Something}Controller` and live in a\n * `{something}-controller.ts` file) OR `@NotController` (then it is exempt from those naming rules).\n * This is a pure marker — it registers no route and only records intent for the lint rule.\n *\n * Usage:\n * ```typescript\n * @NotController()\n * export class Server2Simulator { ... }\n * ```\n */\nexport function NotController(): ClassDecorator {\n    return (target: object) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.NOT_CONTROLLER, true, target);\n    };\n}\n\n/**\n * Helper function to check if a class is explicitly marked as NOT a controller.\n * Server-side only.\n */\nexport function isNotController(controllerClass: object): boolean {\n    return Reflect.getMetadata(ROUTING_METADATA_KEYS.NOT_CONTROLLER, controllerClass) === true;\n}\n\n/**\n * @ApiImplementation decorator — marks the top-of-DAG implementation class in a LIBRARY\n * (a `role:designed-lib` project) whose DI design should be generated.\n *\n * It is the library-side analog of `@Controller`: where a server's design roots on its\n * `@Controller` classes, a designed-lib's design roots on its `@ApiImplementation` classes.\n * A `role:designed-lib` project is REQUIRED to have at least one such class — otherwise the\n * DI-graph generator has no root and fails.\n *\n * Put it on the top implementation class a library exports and binds in its `ContainerModule`\n * (e.g. the class an app injects to drive the library). Like `@Controller`, this is a pure\n * marker read by the static DI-graph analyzer (by decorator name); it registers nothing at\n * runtime on its own.\n *\n * Usage:\n * ```typescript\n * @ApiImplementation()\n * @injectable()\n * export class AgentHandler { ... }\n * ```\n */\nexport function ApiImplementation(): ClassDecorator {\n    return (target: object) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.API_IMPLEMENTATION, true, target);\n    };\n}\n\n/**\n * Helper function to check if a class is marked as an API implementation (designed-lib root).\n * Server/library side only.\n */\nexport function isApiImplementation(implClass: object): boolean {\n    return Reflect.getMetadata(ROUTING_METADATA_KEYS.API_IMPLEMENTATION, implClass) === true;\n}\n\n/**\n * SourceFile decorator to explicitly set the source filepath for a controller.\n * This is used by filter matching to determine which filters apply to the controller.\n *\n * If not specified, the system will use a heuristic based on the controller's name.\n *\n * Usage:\n * @SourceFile('src/controllers/admin/UserController.ts')\n * @Controller()\n * export class UserController { ... }\n *\n * @param filepath - The source filepath of the controller\n */\nexport function SourceFile(filepath: string): ClassDecorator {\n    return (target: any) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.SOURCE_FILEPATH, filepath, target);\n    };\n}\n\n/**\n * Provides a singleton-scoped dependency.\n * When called without arguments, the decorated class binds to itself.\n *\n * Server-side only - registers classes in the DI container.\n *\n * Usage:\n * ```typescript\n * @provideSingleton()\n * @Controller()\n * export class SaveController {\n *   // ...\n * }\n * ```\n */\nexport function provideSingleton() {\n    return (target: any) => {\n        return provide(target, (bind) => bind.inSingletonScope())(target);\n    };\n}\n\n/**\n * Provides a singleton-scoped dependency bound to a specific token (Symbol or abstract class).\n * Use this in libraries/apis-external/** to bind an impl to the Symbol defined in libraries/apis/**.\n *\n * Usage:\n * ```typescript\n * import { SOME_API_TOKEN } from '@myorg/some-api';\n *\n * @provideSingletonAs(SOME_API_TOKEN)\n * export class SomeApiImpl { ... }\n * ```\n */\nexport function provideSingletonAs<T>(serviceIdentifier: ServiceIdentifier<T>): ClassDecorator {\n    return provide(serviceIdentifier, (bind: BindInWhenOnFluentSyntax<T>) => bind.inSingletonScope());\n}\n\n/**\n * Provides a transient-scoped dependency (new instance every time).\n * When called without arguments, the decorated class binds to itself.\n *\n * Server-side only - registers classes in the DI container.\n *\n * Usage:\n * ```typescript\n * @provideTransient()\n * @Controller()\n * export class TransientController {\n *   // ...\n * }\n * ```\n */\nexport function provideTransient() {\n    return (target: any) => {\n        return provide(target)(target);\n    };\n}\n"]}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/decorators.ts"],"names":[],"mappings":";;;AAkCA,wCAIC;AAMD,4CAEC;AAeD,gCAIC;AAjED,4BAA0B;AAE1B;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACjC,eAAe,EAAE,2BAA2B;IAC5C,eAAe,EAAE,2BAA2B;CAC/C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,cAAc;IAC1B,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAChD,OAAO,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,eAAe,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,UAAU,CAAC,QAAgB;IACvC,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,OAAO,CAAC,cAAc,CAAC,6BAAqB,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC,CAAC;AACN,CAAC;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,0CAA0C","sourcesContent":["import 'reflect-metadata';\n\n/**\n * Metadata keys for server-side routing.\n * These are specific to the routing package (server-side only).\n */\nexport const ROUTING_METADATA_KEYS = {\n    DOCUMENT_DESIGN: 'webpieces:document-design',\n    SOURCE_FILEPATH: 'webpieces:source-filepath',\n};\n\n/**\n * @DocumentDesign decorator — marks a class as a DI-design ROOT: the top-of-DAG class whose\n * dependency-injection tree the design-doc generator walks and renders into that project's\n * `design.json` / `design.md` / `design.html`.\n *\n * It is the single marker for every kind of design root — server controllers (the class an\n * `ApiRoutingFactory(Api, Controller)` binds) and library implementation classes (the top class a\n * `role:designed-lib` project exports and binds in its `ContainerModule`). A `role:designed-lib`\n * project is REQUIRED to have at least one `@DocumentDesign` class — otherwise the DI-graph\n * generator has no root and fails.\n *\n * This is a pure marker read STATICALLY by the DI-graph analyzer (by decorator name); nothing reads\n * its runtime metadata. Routing does NOT depend on it — routes are wired explicitly by\n * `ApiRoutingFactory(Api, Controller)`, which reads `@ApiPath`/`@Endpoint` off the API class and\n * `@SourceFile` off the controller. The metadata below exists only for symmetry/debuggability.\n *\n * Usage:\n * ```typescript\n * @DocumentDesign()\n * @injectable()\n * export class SaveController extends SaveApi { ... }\n * ```\n */\nexport function DocumentDesign(): ClassDecorator {\n    return (target: object) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.DOCUMENT_DESIGN, true, target);\n    };\n}\n\n/**\n * Helper function to check if a class is marked as a DI-design root.\n * Server/library side only.\n */\nexport function isDocumentDesign(designClass: object): boolean {\n    return Reflect.getMetadata(ROUTING_METADATA_KEYS.DOCUMENT_DESIGN, designClass) === true;\n}\n\n/**\n * SourceFile decorator to explicitly set the source filepath for a controller.\n * This is used by filter matching to determine which filters apply to the controller.\n *\n * If not specified, the system will use a heuristic based on the controller's name.\n *\n * Usage:\n * @SourceFile('src/controllers/admin/UserController.ts')\n * @DocumentDesign()\n * export class UserController { ... }\n *\n * @param filepath - The source filepath of the controller\n */\nexport function SourceFile(filepath: string): ClassDecorator {\n    return (target: any) => {\n        Reflect.defineMetadata(ROUTING_METADATA_KEYS.SOURCE_FILEPATH, filepath, target);\n    };\n}\n\n// NOTE: provideSingleton / provideSingletonAs / provideTransient moved to\n// @webpieces/core-context (the shared DI seam). http-routing re-exports them\n// from there in index.ts for back-compat.\n"]}

package/src/index.d.ts

@@ -1,11 +1,12 @@
-export { ApiPath, Endpoint, Authentication, AuthenticationConfig, Public, AuthJwt, AuthOidc, AuthSharedSecret, Rpc, PubSub, Queue, getApiPath, getEndpoints, isApiPath, getAuthMeta, getAuthMode, assertEveryEndpointHasAuthMode, getApiKind, assertApiKind, assertPubSubConventions, getQueueName, AuthMeta, RouteMetadata, METADATA_KEYS, ValidateImplementation, } from '@webpieces/http-api';
-export type { AuthMode, ApiKind } from '@webpieces/http-api';
-export { Controller, isController, NotController, isNotController, ApiImplementation, isApiImplementation, provideSingleton, provideSingletonAs, provideTransient, ROUTING_METADATA_KEYS, } from './decorators';
+export { ApiPath, Endpoint, Authentication, AuthenticationConfig, Public, AuthJwt, AuthOidc, AuthSharedSecret, Rpc, PubSub, Queue, getApiPath, getEndpoints, isApiPath, getAuthMeta, getAuthMode, assertEveryEndpointHasAuthMode, getApiKind, assertApiKind, assertPubSubConventions, getQueueName, AuthMeta, RouteMetadata, METADATA_KEYS, ValidateImplementation, } from '@webpieces/core-util';
+export type { AuthMode, ApiKind } from '@webpieces/core-util';
+export { DocumentDesign, isDocumentDesign, SourceFile, ROUTING_METADATA_KEYS, } from './decorators';
+export { provideSingleton, provideSingletonAs, provideTransient } from '@webpieces/core-context';
 export { ApiRoutingFactory, ClassType } from './ApiRoutingFactory';
 export { WebAppMeta, WEBAPP_META_TOKEN, Routes, RouteBuilder, RouteDefinition, FilterDefinition, } from './WebAppMeta';
-export { MethodMeta } from './MethodMeta';
+export { MethodMeta } from '@webpieces/http-filters';
 export { RouteHandler } from './RouteHandler';
 export { RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, ExpressRouteHandler, } from './RouteBuilderImpl';
 export { FilterMatcher, HttpFilter } from './FilterMatcher';
-export { RequestContextReader } from './RequestContextReader';
+export { RequestContextReader } from '@webpieces/core-context';
 export { WebpiecesConfig, WEBPIECES_CONFIG_TOKEN } from './WebpiecesConfig';

package/src/index.js

@@ -1,44 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WEBPIECES_CONFIG_TOKEN = exports.WebpiecesConfig = exports.RequestContextReader = exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.RouteHandler = exports.MethodMeta = exports.FilterDefinition = exports.RouteDefinition = exports.WEBAPP_META_TOKEN = exports.ApiRoutingFactory = exports.ROUTING_METADATA_KEYS = exports.provideTransient = exports.provideSingletonAs = exports.provideSingleton = exports.isApiImplementation = exports.ApiImplementation = exports.isNotController = exports.NotController = exports.isController = exports.Controller = exports.METADATA_KEYS = exports.RouteMetadata = exports.AuthMeta = exports.getQueueName = exports.assertPubSubConventions = exports.assertApiKind = exports.getApiKind = exports.assertEveryEndpointHasAuthMode = exports.getAuthMode = exports.getAuthMeta = exports.isApiPath = exports.getEndpoints = exports.getApiPath = exports.Queue = exports.PubSub = exports.Rpc = exports.AuthSharedSecret = exports.AuthOidc = exports.AuthJwt = exports.Public = exports.AuthenticationConfig = exports.Authentication = exports.Endpoint = exports.ApiPath = void 0;
-// Re-export API decorators from http-api for convenience
-var http_api_1 = require("@webpieces/http-api");
-Object.defineProperty(exports, "ApiPath", { enumerable: true, get: function () { return http_api_1.ApiPath; } });
-Object.defineProperty(exports, "Endpoint", { enumerable: true, get: function () { return http_api_1.Endpoint; } });
-Object.defineProperty(exports, "Authentication", { enumerable: true, get: function () { return http_api_1.Authentication; } });
-Object.defineProperty(exports, "AuthenticationConfig", { enumerable: true, get: function () { return http_api_1.AuthenticationConfig; } });
-Object.defineProperty(exports, "Public", { enumerable: true, get: function () { return http_api_1.Public; } });
-Object.defineProperty(exports, "AuthJwt", { enumerable: true, get: function () { return http_api_1.AuthJwt; } });
-Object.defineProperty(exports, "AuthOidc", { enumerable: true, get: function () { return http_api_1.AuthOidc; } });
-Object.defineProperty(exports, "AuthSharedSecret", { enumerable: true, get: function () { return http_api_1.AuthSharedSecret; } });
-Object.defineProperty(exports, "Rpc", { enumerable: true, get: function () { return http_api_1.Rpc; } });
-Object.defineProperty(exports, "PubSub", { enumerable: true, get: function () { return http_api_1.PubSub; } });
-Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return http_api_1.Queue; } });
-Object.defineProperty(exports, "getApiPath", { enumerable: true, get: function () { return http_api_1.getApiPath; } });
-Object.defineProperty(exports, "getEndpoints", { enumerable: true, get: function () { return http_api_1.getEndpoints; } });
-Object.defineProperty(exports, "isApiPath", { enumerable: true, get: function () { return http_api_1.isApiPath; } });
-Object.defineProperty(exports, "getAuthMeta", { enumerable: true, get: function () { return http_api_1.getAuthMeta; } });
-Object.defineProperty(exports, "getAuthMode", { enumerable: true, get: function () { return http_api_1.getAuthMode; } });
-Object.defineProperty(exports, "assertEveryEndpointHasAuthMode", { enumerable: true, get: function () { return http_api_1.assertEveryEndpointHasAuthMode; } });
-Object.defineProperty(exports, "getApiKind", { enumerable: true, get: function () { return http_api_1.getApiKind; } });
-Object.defineProperty(exports, "assertApiKind", { enumerable: true, get: function () { return http_api_1.assertApiKind; } });
-Object.defineProperty(exports, "assertPubSubConventions", { enumerable: true, get: function () { return http_api_1.assertPubSubConventions; } });
-Object.defineProperty(exports, "getQueueName", { enumerable: true, get: function () { return http_api_1.getQueueName; } });
-Object.defineProperty(exports, "AuthMeta", { enumerable: true, get: function () { return http_api_1.AuthMeta; } });
-Object.defineProperty(exports, "RouteMetadata", { enumerable: true, get: function () { return http_api_1.RouteMetadata; } });
-Object.defineProperty(exports, "METADATA_KEYS", { enumerable: true, get: function () { return http_api_1.METADATA_KEYS; } });
+exports.WEBPIECES_CONFIG_TOKEN = exports.WebpiecesConfig = exports.RequestContextReader = exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.RouteHandler = exports.MethodMeta = exports.FilterDefinition = exports.RouteDefinition = exports.WEBAPP_META_TOKEN = exports.ApiRoutingFactory = exports.provideTransient = exports.provideSingletonAs = exports.provideSingleton = exports.ROUTING_METADATA_KEYS = exports.SourceFile = exports.isDocumentDesign = exports.DocumentDesign = exports.METADATA_KEYS = exports.RouteMetadata = exports.AuthMeta = exports.getQueueName = exports.assertPubSubConventions = exports.assertApiKind = exports.getApiKind = exports.assertEveryEndpointHasAuthMode = exports.getAuthMode = exports.getAuthMeta = exports.isApiPath = exports.getEndpoints = exports.getApiPath = exports.Queue = exports.PubSub = exports.Rpc = exports.AuthSharedSecret = exports.AuthOidc = exports.AuthJwt = exports.Public = exports.AuthenticationConfig = exports.Authentication = exports.Endpoint = exports.ApiPath = void 0;
+// Re-export API decorators from core-util for convenience
+var core_util_1 = require("@webpieces/core-util");
+Object.defineProperty(exports, "ApiPath", { enumerable: true, get: function () { return core_util_1.ApiPath; } });
+Object.defineProperty(exports, "Endpoint", { enumerable: true, get: function () { return core_util_1.Endpoint; } });
+Object.defineProperty(exports, "Authentication", { enumerable: true, get: function () { return core_util_1.Authentication; } });
+Object.defineProperty(exports, "AuthenticationConfig", { enumerable: true, get: function () { return core_util_1.AuthenticationConfig; } });
+Object.defineProperty(exports, "Public", { enumerable: true, get: function () { return core_util_1.Public; } });
+Object.defineProperty(exports, "AuthJwt", { enumerable: true, get: function () { return core_util_1.AuthJwt; } });
+Object.defineProperty(exports, "AuthOidc", { enumerable: true, get: function () { return core_util_1.AuthOidc; } });
+Object.defineProperty(exports, "AuthSharedSecret", { enumerable: true, get: function () { return core_util_1.AuthSharedSecret; } });
+Object.defineProperty(exports, "Rpc", { enumerable: true, get: function () { return core_util_1.Rpc; } });
+Object.defineProperty(exports, "PubSub", { enumerable: true, get: function () { return core_util_1.PubSub; } });
+Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return core_util_1.Queue; } });
+Object.defineProperty(exports, "getApiPath", { enumerable: true, get: function () { return core_util_1.getApiPath; } });
+Object.defineProperty(exports, "getEndpoints", { enumerable: true, get: function () { return core_util_1.getEndpoints; } });
+Object.defineProperty(exports, "isApiPath", { enumerable: true, get: function () { return core_util_1.isApiPath; } });
+Object.defineProperty(exports, "getAuthMeta", { enumerable: true, get: function () { return core_util_1.getAuthMeta; } });
+Object.defineProperty(exports, "getAuthMode", { enumerable: true, get: function () { return core_util_1.getAuthMode; } });
+Object.defineProperty(exports, "assertEveryEndpointHasAuthMode", { enumerable: true, get: function () { return core_util_1.assertEveryEndpointHasAuthMode; } });
+Object.defineProperty(exports, "getApiKind", { enumerable: true, get: function () { return core_util_1.getApiKind; } });
+Object.defineProperty(exports, "assertApiKind", { enumerable: true, get: function () { return core_util_1.assertApiKind; } });
+Object.defineProperty(exports, "assertPubSubConventions", { enumerable: true, get: function () { return core_util_1.assertPubSubConventions; } });
+Object.defineProperty(exports, "getQueueName", { enumerable: true, get: function () { return core_util_1.getQueueName; } });
+Object.defineProperty(exports, "AuthMeta", { enumerable: true, get: function () { return core_util_1.AuthMeta; } });
+Object.defineProperty(exports, "RouteMetadata", { enumerable: true, get: function () { return core_util_1.RouteMetadata; } });
+Object.defineProperty(exports, "METADATA_KEYS", { enumerable: true, get: function () { return core_util_1.METADATA_KEYS; } });
 // Server-side routing decorators and utilities
 var decorators_1 = require("./decorators");
-Object.defineProperty(exports, "Controller", { enumerable: true, get: function () { return decorators_1.Controller; } });
-Object.defineProperty(exports, "isController", { enumerable: true, get: function () { return decorators_1.isController; } });
-Object.defineProperty(exports, "NotController", { enumerable: true, get: function () { return decorators_1.NotController; } });
-Object.defineProperty(exports, "isNotController", { enumerable: true, get: function () { return decorators_1.isNotController; } });
-Object.defineProperty(exports, "ApiImplementation", { enumerable: true, get: function () { return decorators_1.ApiImplementation; } });
-Object.defineProperty(exports, "isApiImplementation", { enumerable: true, get: function () { return decorators_1.isApiImplementation; } });
-Object.defineProperty(exports, "provideSingleton", { enumerable: true, get: function () { return decorators_1.provideSingleton; } });
-Object.defineProperty(exports, "provideSingletonAs", { enumerable: true, get: function () { return decorators_1.provideSingletonAs; } });
-Object.defineProperty(exports, "provideTransient", { enumerable: true, get: function () { return decorators_1.provideTransient; } });
+Object.defineProperty(exports, "DocumentDesign", { enumerable: true, get: function () { return decorators_1.DocumentDesign; } });
+Object.defineProperty(exports, "isDocumentDesign", { enumerable: true, get: function () { return decorators_1.isDocumentDesign; } });
+Object.defineProperty(exports, "SourceFile", { enumerable: true, get: function () { return decorators_1.SourceFile; } });
 Object.defineProperty(exports, "ROUTING_METADATA_KEYS", { enumerable: true, get: function () { return decorators_1.ROUTING_METADATA_KEYS; } });
+// DI provider decorators moved to core-context; re-exported here for back-compat
+var core_context_1 = require("@webpieces/core-context");
+Object.defineProperty(exports, "provideSingleton", { enumerable: true, get: function () { return core_context_1.provideSingleton; } });
+Object.defineProperty(exports, "provideSingletonAs", { enumerable: true, get: function () { return core_context_1.provideSingletonAs; } });
+Object.defineProperty(exports, "provideTransient", { enumerable: true, get: function () { return core_context_1.provideTransient; } });
 var ApiRoutingFactory_1 = require("./ApiRoutingFactory");
 Object.defineProperty(exports, "ApiRoutingFactory", { enumerable: true, get: function () { return ApiRoutingFactory_1.ApiRoutingFactory; } });
 // Core routing types (moved from core-meta)
@@ -46,9 +45,9 @@ var WebAppMeta_1 = require("./WebAppMeta");
 Object.defineProperty(exports, "WEBAPP_META_TOKEN", { enumerable: true, get: function () { return WebAppMeta_1.WEBAPP_META_TOKEN; } });
 Object.defineProperty(exports, "RouteDefinition", { enumerable: true, get: function () { return WebAppMeta_1.RouteDefinition; } });
 Object.defineProperty(exports, "FilterDefinition", { enumerable: true, get: function () { return WebAppMeta_1.FilterDefinition; } });
-// Method metadata and route handler
-var MethodMeta_1 = require("./MethodMeta");
-Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return MethodMeta_1.MethodMeta; } });
+// Method metadata (moved to http-filters) re-exported for back-compat; route handler
+var http_filters_1 = require("@webpieces/http-filters");
+Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return http_filters_1.MethodMeta; } });
 var RouteHandler_1 = require("./RouteHandler");
 Object.defineProperty(exports, "RouteHandler", { enumerable: true, get: function () { return RouteHandler_1.RouteHandler; } });
 // Route builder implementation
@@ -59,9 +58,9 @@ Object.defineProperty(exports, "FilterWithMeta", { enumerable: true, get: functi
 // Filter matching
 var FilterMatcher_1 = require("./FilterMatcher");
 Object.defineProperty(exports, "FilterMatcher", { enumerable: true, get: function () { return FilterMatcher_1.FilterMatcher; } });
-// Context readers (Node.js only)
-var RequestContextReader_1 = require("./RequestContextReader");
-Object.defineProperty(exports, "RequestContextReader", { enumerable: true, get: function () { return RequestContextReader_1.RequestContextReader; } });
+// Context readers (Node.js only) moved to core-context; re-exported for back-compat
+var core_context_2 = require("@webpieces/core-context");
+Object.defineProperty(exports, "RequestContextReader", { enumerable: true, get: function () { return core_context_2.RequestContextReader; } });
 // Server configuration
 var WebpiecesConfig_1 = require("./WebpiecesConfig");
 Object.defineProperty(exports, "WebpiecesConfig", { enumerable: true, get: function () { return WebpiecesConfig_1.WebpiecesConfig; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/index.ts"],"names":[],"mappings":";;;AAAA,yDAAyD;AACzD,gDA0B6B;AAzBzB,mGAAA,OAAO,OAAA;AACP,oGAAA,QAAQ,OAAA;AACR,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,kGAAA,MAAM,OAAA;AACN,mGAAA,OAAO,OAAA;AACP,oGAAA,QAAQ,OAAA;AACR,4GAAA,gBAAgB,OAAA;AAChB,+FAAA,GAAG,OAAA;AACH,kGAAA,MAAM,OAAA;AACN,iGAAA,KAAK,OAAA;AACL,sGAAA,UAAU,OAAA;AACV,wGAAA,YAAY,OAAA;AACZ,qGAAA,SAAS,OAAA;AACT,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,0HAAA,8BAA8B,OAAA;AAC9B,sGAAA,UAAU,OAAA;AACV,yGAAA,aAAa,OAAA;AACb,mHAAA,uBAAuB,OAAA;AACvB,wGAAA,YAAY,OAAA;AACZ,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AAKjB,+CAA+C;AAC/C,2CAWsB;AAVlB,wGAAA,UAAU,OAAA;AACV,0GAAA,YAAY,OAAA;AACZ,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AACnB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAChB,mHAAA,qBAAqB,OAAA;AAGzB,yDAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAE1B,4CAA4C;AAC5C,2CAOsB;AALlB,+GAAA,iBAAiB,OAAA;AAGjB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAGpB,oCAAoC;AACpC,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,+BAA+B;AAC/B,uDAK4B;AAJxB,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA;AAIlB,kBAAkB;AAClB,iDAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,iCAAiC;AACjC,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,uBAAuB;AACvB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AAAE,yHAAA,sBAAsB,OAAA","sourcesContent":["// Re-export API decorators from http-api for convenience\nexport {\n    ApiPath,\n    Endpoint,\n    Authentication,\n    AuthenticationConfig,\n    Public,\n    AuthJwt,\n    AuthOidc,\n    AuthSharedSecret,\n    Rpc,\n    PubSub,\n    Queue,\n    getApiPath,\n    getEndpoints,\n    isApiPath,\n    getAuthMeta,\n    getAuthMode,\n    assertEveryEndpointHasAuthMode,\n    getApiKind,\n    assertApiKind,\n    assertPubSubConventions,\n    getQueueName,\n    AuthMeta,\n    RouteMetadata,\n    METADATA_KEYS,\n    ValidateImplementation,\n} from '@webpieces/http-api';\nexport type { AuthMode, ApiKind } from '@webpieces/http-api';\n\n// Server-side routing decorators and utilities\nexport {\n    Controller,\n    isController,\n    NotController,\n    isNotController,\n    ApiImplementation,\n    isApiImplementation,\n    provideSingleton,\n    provideSingletonAs,\n    provideTransient,\n    ROUTING_METADATA_KEYS,\n} from './decorators';\n\nexport { ApiRoutingFactory, ClassType } from './ApiRoutingFactory';\n\n// Core routing types (moved from core-meta)\nexport {\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n    Routes,\n    RouteBuilder,\n    RouteDefinition,\n    FilterDefinition,\n} from './WebAppMeta';\n\n// Method metadata and route handler\nexport { MethodMeta } from './MethodMeta';\nexport { RouteHandler } from './RouteHandler';\n\n// Route builder implementation\nexport {\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    ExpressRouteHandler,\n} from './RouteBuilderImpl';\n\n// Filter matching\nexport { FilterMatcher, HttpFilter } from './FilterMatcher';\n\n// Context readers (Node.js only)\nexport { RequestContextReader } from './RequestContextReader';\n\n// Server configuration\nexport { WebpiecesConfig, WEBPIECES_CONFIG_TOKEN } from './WebpiecesConfig';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,kDA0B8B;AAzB1B,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,mGAAA,MAAM,OAAA;AACN,oGAAA,OAAO,OAAA;AACP,qGAAA,QAAQ,OAAA;AACR,6GAAA,gBAAgB,OAAA;AAChB,gGAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAA;AACN,kGAAA,KAAK,OAAA;AACL,uGAAA,UAAU,OAAA;AACV,yGAAA,YAAY,OAAA;AACZ,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,wGAAA,WAAW,OAAA;AACX,2HAAA,8BAA8B,OAAA;AAC9B,uGAAA,UAAU,OAAA;AACV,0GAAA,aAAa,OAAA;AACb,oHAAA,uBAAuB,OAAA;AACvB,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,0GAAA,aAAa,OAAA;AACb,0GAAA,aAAa,OAAA;AAKjB,+CAA+C;AAC/C,2CAKsB;AAJlB,4GAAA,cAAc,OAAA;AACd,8GAAA,gBAAgB,OAAA;AAChB,wGAAA,UAAU,OAAA;AACV,mHAAA,qBAAqB,OAAA;AAGzB,iFAAiF;AACjF,wDAAiG;AAAxF,gHAAA,gBAAgB,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAAE,gHAAA,gBAAgB,OAAA;AAE/D,yDAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAE1B,4CAA4C;AAC5C,2CAOsB;AALlB,+GAAA,iBAAiB,OAAA;AAGjB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAGpB,qFAAqF;AACrF,wDAAqD;AAA5C,0GAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,+BAA+B;AAC/B,uDAK4B;AAJxB,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA;AAIlB,kBAAkB;AAClB,iDAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,oFAAoF;AACpF,wDAA+D;AAAtD,oHAAA,oBAAoB,OAAA;AAE7B,uBAAuB;AACvB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AAAE,yHAAA,sBAAsB,OAAA","sourcesContent":["// Re-export API decorators from core-util for convenience\nexport {\n    ApiPath,\n    Endpoint,\n    Authentication,\n    AuthenticationConfig,\n    Public,\n    AuthJwt,\n    AuthOidc,\n    AuthSharedSecret,\n    Rpc,\n    PubSub,\n    Queue,\n    getApiPath,\n    getEndpoints,\n    isApiPath,\n    getAuthMeta,\n    getAuthMode,\n    assertEveryEndpointHasAuthMode,\n    getApiKind,\n    assertApiKind,\n    assertPubSubConventions,\n    getQueueName,\n    AuthMeta,\n    RouteMetadata,\n    METADATA_KEYS,\n    ValidateImplementation,\n} from '@webpieces/core-util';\nexport type { AuthMode, ApiKind } from '@webpieces/core-util';\n\n// Server-side routing decorators and utilities\nexport {\n    DocumentDesign,\n    isDocumentDesign,\n    SourceFile,\n    ROUTING_METADATA_KEYS,\n} from './decorators';\n\n// DI provider decorators moved to core-context; re-exported here for back-compat\nexport { provideSingleton, provideSingletonAs, provideTransient } from '@webpieces/core-context';\n\nexport { ApiRoutingFactory, ClassType } from './ApiRoutingFactory';\n\n// Core routing types (moved from core-meta)\nexport {\n    WebAppMeta,\n    WEBAPP_META_TOKEN,\n    Routes,\n    RouteBuilder,\n    RouteDefinition,\n    FilterDefinition,\n} from './WebAppMeta';\n\n// Method metadata (moved to http-filters) re-exported for back-compat; route handler\nexport { MethodMeta } from '@webpieces/http-filters';\nexport { RouteHandler } from './RouteHandler';\n\n// Route builder implementation\nexport {\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    ExpressRouteHandler,\n} from './RouteBuilderImpl';\n\n// Filter matching\nexport { FilterMatcher, HttpFilter } from './FilterMatcher';\n\n// Context readers (Node.js only) moved to core-context; re-exported for back-compat\nexport { RequestContextReader } from '@webpieces/core-context';\n\n// Server configuration\nexport { WebpiecesConfig, WEBPIECES_CONFIG_TOKEN } from './WebpiecesConfig';\n"]}

package/src/MethodMeta.d.ts

@@ -1,68 +0,0 @@
-import { RouteMetadata, AuthMeta } from '@webpieces/http-api';
-/**
- * Metadata about the method being invoked.
- * Passed to filters and contains request information.
- *
- * MethodMeta is DTO-only - it does NOT contain Express req/res directly.
- *
- * Fields:
- * - routeMeta: Static route information (httpMethod, path, methodName)
- * - requestHeaders: HTTP headers from the request (NEW)
- * - requestDto: The deserialized request body
- * - metadata: Request-scoped data for filters to communicate
- */
-export declare class MethodMeta {
-    /**
-     * Route metadata (httpMethod, path, methodName, parameterTypes)
-     */
-    routeMeta: RouteMetadata;
-    /**
-     * HTTP headers from the request.
-     * Map of header name (lowercase) -> array of values.
-     *
-     * HTTP spec allows multiple values for same header name,
-     * so we store as string[] (even though most headers have single value).
-     *
-     * LIFECYCLE:
-     * 1. Set by ExpressWrapper BEFORE filter chain executes
-     * 2. ContextFilter (priority 2000) transfers headers to RequestContext
-     * 3. ContextFilter CLEARS this field (sets to undefined) after transfer
-     * 4. ALL FILTERS AFTER ContextFilter will see this as UNDEFINED
-     *
-     * IMPORTANT: Downstream filters should NOT read from requestHeaders!
-     * Instead, use RequestContext.getHeader() to read headers after ContextFilter.
-     *
-     * Example (correct usage in downstream filters):
-     * ```typescript
-     * const requestId = RequestContext.getHeader(WebpiecesCoreHeaders.REQUEST_ID);
-     * ```
-     */
-    requestHeaders?: Map<string, string[]>;
-    /**
-     * The deserialized request DTO.
-     */
-    requestDto?: unknown;
-    /**
-     * Auth metadata from @Public/@Authenticated/@Roles decorators.
-     * Populated by ApiRoutingFactory so filters can read auth requirements.
-     */
-    authMeta?: AuthMeta;
-    /**
-     * Additional metadata for storing request-scoped data.
-     * Used by filters to pass data to other filters/controllers.
-     */
-    metadata: Map<string, unknown>;
-    constructor(routeMeta: RouteMetadata, requestHeaders?: Map<string, string[]>, requestDto?: unknown, metadata?: Map<string, unknown>, authMeta?: AuthMeta);
-    /**
-     * Get the HTTP method (convenience accessor).
-     */
-    get httpMethod(): string;
-    /**
-     * Get the request path (convenience accessor).
-     */
-    get path(): string;
-    /**
-     * Get the method name (convenience accessor).
-     */
-    get methodName(): string;
-}

package/src/MethodMeta.js

@@ -1,84 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MethodMeta = void 0;
-/**
- * Metadata about the method being invoked.
- * Passed to filters and contains request information.
- *
- * MethodMeta is DTO-only - it does NOT contain Express req/res directly.
- *
- * Fields:
- * - routeMeta: Static route information (httpMethod, path, methodName)
- * - requestHeaders: HTTP headers from the request (NEW)
- * - requestDto: The deserialized request body
- * - metadata: Request-scoped data for filters to communicate
- */
-class MethodMeta {
-    /**
-     * Route metadata (httpMethod, path, methodName, parameterTypes)
-     */
-    routeMeta;
-    /**
-     * HTTP headers from the request.
-     * Map of header name (lowercase) -> array of values.
-     *
-     * HTTP spec allows multiple values for same header name,
-     * so we store as string[] (even though most headers have single value).
-     *
-     * LIFECYCLE:
-     * 1. Set by ExpressWrapper BEFORE filter chain executes
-     * 2. ContextFilter (priority 2000) transfers headers to RequestContext
-     * 3. ContextFilter CLEARS this field (sets to undefined) after transfer
-     * 4. ALL FILTERS AFTER ContextFilter will see this as UNDEFINED
-     *
-     * IMPORTANT: Downstream filters should NOT read from requestHeaders!
-     * Instead, use RequestContext.getHeader() to read headers after ContextFilter.
-     *
-     * Example (correct usage in downstream filters):
-     * ```typescript
-     * const requestId = RequestContext.getHeader(WebpiecesCoreHeaders.REQUEST_ID);
-     * ```
-     */
-    requestHeaders;
-    /**
-     * The deserialized request DTO.
-     */
-    requestDto;
-    /**
-     * Auth metadata from @Public/@Authenticated/@Roles decorators.
-     * Populated by ApiRoutingFactory so filters can read auth requirements.
-     */
-    authMeta;
-    /**
-     * Additional metadata for storing request-scoped data.
-     * Used by filters to pass data to other filters/controllers.
-     */
-    metadata;
-    constructor(routeMeta, requestHeaders, requestDto, metadata, authMeta) {
-        this.routeMeta = routeMeta;
-        this.requestHeaders = requestHeaders;
-        this.requestDto = requestDto;
-        this.metadata = metadata ?? new Map();
-        this.authMeta = authMeta ?? routeMeta.authMeta;
-    }
-    /**
-     * Get the HTTP method (convenience accessor).
-     */
-    get httpMethod() {
-        return this.routeMeta.httpMethod;
-    }
-    /**
-     * Get the request path (convenience accessor).
-     */
-    get path() {
-        return this.routeMeta.path;
-    }
-    /**
-     * Get the method name (convenience accessor).
-     */
-    get methodName() {
-        return this.routeMeta.methodName;
-    }
-}
-exports.MethodMeta = MethodMeta;
-//# sourceMappingURL=MethodMeta.js.map

package/src/MethodMeta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MethodMeta.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/MethodMeta.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,UAAU;IACnB;;OAEG;IACH,SAAS,CAAgB;IAEzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,cAAc,CAAyB;IAE9C;;OAEG;IACH,UAAU,CAAW;IAErB;;;OAGG;IACH,QAAQ,CAAY;IAEpB;;;OAGG;IACH,QAAQ,CAAuB;IAE/B,YACI,SAAwB,EACxB,cAAsC,EACtC,UAAoB,EACpB,QAA+B,EAC/B,QAAmB;QAEnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,GAAG,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;IACrC,CAAC;CACJ;AAhFD,gCAgFC","sourcesContent":["import { RouteMetadata, AuthMeta } from '@webpieces/http-api';\n\n/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n *\n * MethodMeta is DTO-only - it does NOT contain Express req/res directly.\n *\n * Fields:\n * - routeMeta: Static route information (httpMethod, path, methodName)\n * - requestHeaders: HTTP headers from the request (NEW)\n * - requestDto: The deserialized request body\n * - metadata: Request-scoped data for filters to communicate\n */\nexport class MethodMeta {\n    /**\n     * Route metadata (httpMethod, path, methodName, parameterTypes)\n     */\n    routeMeta: RouteMetadata;\n\n    /**\n     * HTTP headers from the request.\n     * Map of header name (lowercase) -> array of values.\n     *\n     * HTTP spec allows multiple values for same header name,\n     * so we store as string[] (even though most headers have single value).\n     *\n     * LIFECYCLE:\n     * 1. Set by ExpressWrapper BEFORE filter chain executes\n     * 2. ContextFilter (priority 2000) transfers headers to RequestContext\n     * 3. ContextFilter CLEARS this field (sets to undefined) after transfer\n     * 4. ALL FILTERS AFTER ContextFilter will see this as UNDEFINED\n     *\n     * IMPORTANT: Downstream filters should NOT read from requestHeaders!\n     * Instead, use RequestContext.getHeader() to read headers after ContextFilter.\n     *\n     * Example (correct usage in downstream filters):\n     * ```typescript\n     * const requestId = RequestContext.getHeader(WebpiecesCoreHeaders.REQUEST_ID);\n     * ```\n     */\n    public requestHeaders?: Map<string, string[]>;\n\n    /**\n     * The deserialized request DTO.\n     */\n    requestDto?: unknown;\n\n    /**\n     * Auth metadata from @Public/@Authenticated/@Roles decorators.\n     * Populated by ApiRoutingFactory so filters can read auth requirements.\n     */\n    authMeta?: AuthMeta;\n\n    /**\n     * Additional metadata for storing request-scoped data.\n     * Used by filters to pass data to other filters/controllers.\n     */\n    metadata: Map<string, unknown>;\n\n    constructor(\n        routeMeta: RouteMetadata,\n        requestHeaders?: Map<string, string[]>,\n        requestDto?: unknown,\n        metadata?: Map<string, unknown>,\n        authMeta?: AuthMeta,\n    ) {\n        this.routeMeta = routeMeta;\n        this.requestHeaders = requestHeaders;\n        this.requestDto = requestDto;\n        this.metadata = metadata ?? new Map();\n        this.authMeta = authMeta ?? routeMeta.authMeta;\n    }\n\n    /**\n     * Get the HTTP method (convenience accessor).\n     */\n    get httpMethod(): string {\n        return this.routeMeta.httpMethod;\n    }\n\n    /**\n     * Get the request path (convenience accessor).\n     */\n    get path(): string {\n        return this.routeMeta.path;\n    }\n\n    /**\n     * Get the method name (convenience accessor).\n     */\n    get methodName(): string {\n        return this.routeMeta.methodName;\n    }\n}\n"]}

package/src/RequestContextReader.d.ts

@@ -1,29 +0,0 @@
-import { PlatformHeader, ContextReader } from '@webpieces/http-api';
-import { ContextKey } from '@webpieces/core-util';
-/**
- * RequestContextReader - Reads headers from Node.js RequestContext.
- *
- * Only works in Node.js with active AsyncLocalStorage context.
- * This is a server-side only implementation.
- *
- * NOTE: This class is in @webpieces/http-routing (Node.js only) instead of
- * @webpieces/http-client (cross-platform) because it has a hard dependency
- * on @webpieces/core-context which uses Node.js AsyncLocalStorage.
- *
- * For browser environments, use StaticContextReader from @webpieces/http-client.
- */
-export declare class RequestContextReader implements ContextReader {
-    /**
-     * Read a header value from the active RequestContext.
-     *
-     * @param header - The platform header to read
-     * @returns The header value, or undefined if not in context
-     */
-    read(header: PlatformHeader): string | undefined;
-    /**
-     * Read a non-header context value (e.g. the active TestCaseRecorder under
-     * RecorderKeys.RECORDER). Lets the isomorphic http-client find server-side
-     * context without importing core-context itself.
-     */
-    readValue(key: ContextKey): unknown;
-}

package/src/RequestContextReader.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequestContextReader = void 0;
-const core_context_1 = require("@webpieces/core-context");
-/**
- * RequestContextReader - Reads headers from Node.js RequestContext.
- *
- * Only works in Node.js with active AsyncLocalStorage context.
- * This is a server-side only implementation.
- *
- * NOTE: This class is in @webpieces/http-routing (Node.js only) instead of
- * @webpieces/http-client (cross-platform) because it has a hard dependency
- * on @webpieces/core-context which uses Node.js AsyncLocalStorage.
- *
- * For browser environments, use StaticContextReader from @webpieces/http-client.
- */
-class RequestContextReader {
-    /**
-     * Read a header value from the active RequestContext.
-     *
-     * @param header - The platform header to read
-     * @returns The header value, or undefined if not in context
-     */
-    read(header) {
-        // Use RequestContext.getHeader() which calls header.getHeaderName()
-        return core_context_1.RequestContext.getHeader(header);
-    }
-    /**
-     * Read a non-header context value (e.g. the active TestCaseRecorder under
-     * RecorderKeys.RECORDER). Lets the isomorphic http-client find server-side
-     * context without importing core-context itself.
-     */
-    // webpieces-disable no-any-unknown -- context values are heterogeneous (recorder, meta objects)
-    readValue(key) {
-        return core_context_1.RequestContext.getHeader(key);
-    }
-}
-exports.RequestContextReader = RequestContextReader;
-//# sourceMappingURL=RequestContextReader.js.map

package/src/RequestContextReader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RequestContextReader.js","sourceRoot":"","sources":["../../../../../packages/http/http-routing/src/RequestContextReader.ts"],"names":[],"mappings":";;;AAEA,0DAAyD;AAEzD;;;;;;;;;;;GAWG;AACH,MAAa,oBAAoB;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,MAAsB;QACvB,oEAAoE;QACpE,OAAO,6BAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,gGAAgG;IAChG,SAAS,CAAC,GAAe;QACrB,OAAO,6BAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;CACJ;AArBD,oDAqBC","sourcesContent":["import { PlatformHeader, ContextReader } from '@webpieces/http-api';\nimport { ContextKey } from '@webpieces/core-util';\nimport { RequestContext } from '@webpieces/core-context';\n\n/**\n * RequestContextReader - Reads headers from Node.js RequestContext.\n *\n * Only works in Node.js with active AsyncLocalStorage context.\n * This is a server-side only implementation.\n *\n * NOTE: This class is in @webpieces/http-routing (Node.js only) instead of\n * @webpieces/http-client (cross-platform) because it has a hard dependency\n * on @webpieces/core-context which uses Node.js AsyncLocalStorage.\n *\n * For browser environments, use StaticContextReader from @webpieces/http-client.\n */\nexport class RequestContextReader implements ContextReader {\n    /**\n     * Read a header value from the active RequestContext.\n     *\n     * @param header - The platform header to read\n     * @returns The header value, or undefined if not in context\n     */\n    read(header: PlatformHeader): string | undefined {\n        // Use RequestContext.getHeader() which calls header.getHeaderName()\n        return RequestContext.getHeader(header);\n    }\n\n    /**\n     * Read a non-header context value (e.g. the active TestCaseRecorder under\n     * RecorderKeys.RECORDER). Lets the isomorphic http-client find server-side\n     * context without importing core-context itself.\n     */\n    // webpieces-disable no-any-unknown -- context values are heterogeneous (recorder, meta objects)\n    readValue(key: ContextKey): unknown {\n        return RequestContext.getHeader(key);\n    }\n}\n"]}