@webpieces/http-server 0.2.15 → 0.2.17

package/src/filters/LogApiFilter.d.ts

@@ -0,0 +1,40 @@
+import { MethodMeta } from '@webpieces/http-routing';
+import { Filter, WpResponse, Service } from '@webpieces/http-filters';
+/**
+ * LogApiFilter - Structured API logging for all requests/responses.
+ * Priority: 130 (just below ContextFilter at 140, with gap for custom context filters)
+ *
+ * Logging patterns:
+ * - [API-SVR-req] 'Class.method / url' request=jsonStringOfRequest
+ * - [API-SVR-resp-SUCCESS] 'Class.method / url' response=jsonStringOfResponse
+ * - [API-SVR-resp-FAIL] 'Class.method / url' error=... (server errors: 500, 502, 504)
+ * - [API-SVR-resp-OTHER] 'Class.method / url' errorType=... (user errors: 400, 401, 403, 404, 266)
+ *
+ * User errors (HttpBadRequestError, etc.) are logged as OTHER, not FAIL,
+ * because they are expected behavior from the server's perspective.
+ */
+export declare class LogApiFilter extends Filter<MethodMeta, WpResponse<unknown>> {
+    filter(meta: MethodMeta, nextFilter: Service<MethodMeta, WpResponse<unknown>>): Promise<WpResponse<unknown>>;
+    /**
+     * Get formatted class.method string for logging.
+     */
+    private getClassMethod;
+    /**
+     * Log incoming request.
+     */
+    private logRequest;
+    /**
+     * Log successful response.
+     */
+    private logSuccessResponse;
+    /**
+     * Log exception based on error type.
+     * User errors get OTHER (no stack trace), server errors get FAIL.
+     */
+    private logException;
+    /**
+     * Check if error is a user error (expected behavior from server perspective).
+     * These are NOT failures - just users making mistakes or validation issues.
+     */
+    private isUserError;
+}

package/src/filters/LogApiFilter.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogApiFilter = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const http_routing_1 = require("@webpieces/http-routing");
+const http_filters_1 = require("@webpieces/http-filters");
+const http_api_1 = require("@webpieces/http-api");
+/**
+ * LogApiFilter - Structured API logging for all requests/responses.
+ * Priority: 130 (just below ContextFilter at 140, with gap for custom context filters)
+ *
+ * Logging patterns:
+ * - [API-SVR-req] 'Class.method / url' request=jsonStringOfRequest
+ * - [API-SVR-resp-SUCCESS] 'Class.method / url' response=jsonStringOfResponse
+ * - [API-SVR-resp-FAIL] 'Class.method / url' error=... (server errors: 500, 502, 504)
+ * - [API-SVR-resp-OTHER] 'Class.method / url' errorType=... (user errors: 400, 401, 403, 404, 266)
+ *
+ * User errors (HttpBadRequestError, etc.) are logged as OTHER, not FAIL,
+ * because they are expected behavior from the server's perspective.
+ */
+let LogApiFilter = class LogApiFilter extends http_filters_1.Filter {
+    async filter(meta, nextFilter) {
+        const classMethod = this.getClassMethod(meta);
+        const url = meta.path;
+        // Log request
+        this.logRequest(classMethod, url, meta.requestDto);
+        try {
+            const response = await nextFilter.invoke(meta);
+            // Log success response
+            this.logSuccessResponse(classMethod, url, response);
+            return response;
+        }
+        catch (error) {
+            // Log error and re-throw (jsonTranslator will handle serialization)
+            this.logException(classMethod, url, error);
+            throw error;
+        }
+    }
+    /**
+     * Get formatted class.method string for logging.
+     */
+    getClassMethod(meta) {
+        const className = meta.routeMeta.controllerClassName ?? 'Unknown';
+        return `${className}.${meta.methodName}`;
+    }
+    /**
+     * Log incoming request.
+     */
+    logRequest(classMethod, url, request) {
+        console.log(`[API-SVR-req] '${classMethod} ${url}' request=${JSON.stringify(request)}`);
+    }
+    /**
+     * Log successful response.
+     */
+    logSuccessResponse(classMethod, url, response) {
+        console.log(`[API-SVR-resp-SUCCESS] '${classMethod} ${url}' response=${JSON.stringify(response.response)}`);
+    }
+    /**
+     * Log exception based on error type.
+     * User errors get OTHER (no stack trace), server errors get FAIL.
+     */
+    logException(classMethod, url, error) {
+        if (this.isUserError(error)) {
+            // User errors (400, 401, 403, 404, 266) - no stack trace needed
+            const errorType = error?.constructor.name ?? 'UnknownError';
+            console.log(`[API-SVR-resp-OTHER] '${classMethod} ${url}' errorType=${errorType}`);
+        }
+        else {
+            // Server errors (500, 502, etc.) - log full details
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`[API-SVR-resp-FAIL] '${classMethod} ${url}' error=${errorMessage}`);
+        }
+    }
+    /**
+     * Check if error is a user error (expected behavior from server perspective).
+     * These are NOT failures - just users making mistakes or validation issues.
+     */
+    isUserError(error) {
+        return (error instanceof http_api_1.HttpBadRequestError ||
+            error instanceof http_api_1.HttpUnauthorizedError ||
+            error instanceof http_api_1.HttpForbiddenError ||
+            error instanceof http_api_1.HttpNotFoundError ||
+            error instanceof http_api_1.HttpUserError);
+    }
+};
+exports.LogApiFilter = LogApiFilter;
+exports.LogApiFilter = LogApiFilter = tslib_1.__decorate([
+    (0, http_routing_1.provideSingleton)(),
+    (0, inversify_1.injectable)()
+], LogApiFilter);
+//# sourceMappingURL=LogApiFilter.js.map

package/src/filters/LogApiFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogApiFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-server/src/filters/LogApiFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0DAAuE;AACvE,0DAAsE;AACtE,kDAM6B;AAE7B;;;;;;;;;;;;GAYG;AAGI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,qBAAuC;IACrE,KAAK,CAAC,MAAM,CACR,IAAgB,EAChB,UAAoD;QAEpD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QAEtB,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/C,uBAAuB;YACvB,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YAEpD,OAAO,QAAQ,CAAC;QACpB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,oEAAoE;YACpE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAgB;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,IAAI,SAAS,CAAC;QAClE,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,WAAmB,EAAE,GAAW,EAAE,OAAgB;QACjE,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,IAAI,GAAG,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,WAAmB,EAAE,GAAW,EAAE,QAA6B;QACtF,OAAO,CAAC,GAAG,CACP,2BAA2B,WAAW,IAAI,GAAG,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CACjG,CAAC;IACN,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,WAAmB,EAAE,GAAW,EAAE,KAAc;QACjE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,gEAAgE;YAChE,MAAM,SAAS,GAAI,KAAe,EAAE,WAAW,CAAC,IAAI,IAAI,cAAc,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,yBAAyB,WAAW,IAAI,GAAG,eAAe,SAAS,EAAE,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACJ,oDAAoD;YACpD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,CAAC,KAAK,CAAC,wBAAwB,WAAW,IAAI,GAAG,WAAW,YAAY,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,WAAW,CAAC,KAAc;QAC9B,OAAO,CACH,KAAK,YAAY,8BAAmB;YACpC,KAAK,YAAY,gCAAqB;YACtC,KAAK,YAAY,6BAAkB;YACnC,KAAK,YAAY,4BAAiB;YAClC,KAAK,YAAY,wBAAa,CACjC,CAAC;IACN,CAAC;CACJ,CAAA;AA9EY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,YAAY,CA8ExB","sourcesContent":["import { injectable } from 'inversify';\nimport { provideSingleton, MethodMeta } from '@webpieces/http-routing';\nimport { Filter, WpResponse, Service } from '@webpieces/http-filters';\nimport {\n    HttpBadRequestError,\n    HttpUnauthorizedError,\n    HttpForbiddenError,\n    HttpNotFoundError,\n    HttpUserError,\n} from '@webpieces/http-api';\n\n/**\n * LogApiFilter - Structured API logging for all requests/responses.\n * Priority: 130 (just below ContextFilter at 140, with gap for custom context filters)\n *\n * Logging patterns:\n * - [API-SVR-req] 'Class.method / url' request=jsonStringOfRequest\n * - [API-SVR-resp-SUCCESS] 'Class.method / url' response=jsonStringOfResponse\n * - [API-SVR-resp-FAIL] 'Class.method / url' error=... (server errors: 500, 502, 504)\n * - [API-SVR-resp-OTHER] 'Class.method / url' errorType=... (user errors: 400, 401, 403, 404, 266)\n *\n * User errors (HttpBadRequestError, etc.) are logged as OTHER, not FAIL,\n * because they are expected behavior from the server's perspective.\n */\n@provideSingleton()\n@injectable()\nexport class LogApiFilter extends Filter<MethodMeta, WpResponse<unknown>> {\n    async filter(\n        meta: MethodMeta,\n        nextFilter: Service<MethodMeta, WpResponse<unknown>>,\n    ): Promise<WpResponse<unknown>> {\n        const classMethod = this.getClassMethod(meta);\n        const url = meta.path;\n\n        // Log request\n        this.logRequest(classMethod, url, meta.requestDto);\n\n        try {\n            const response = await nextFilter.invoke(meta);\n\n            // Log success response\n            this.logSuccessResponse(classMethod, url, response);\n\n            return response;\n        } catch (error: unknown) {\n            // Log error and re-throw (jsonTranslator will handle serialization)\n            this.logException(classMethod, url, error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get formatted class.method string for logging.\n     */\n    private getClassMethod(meta: MethodMeta): string {\n        const className = meta.routeMeta.controllerClassName ?? 'Unknown';\n        return `${className}.${meta.methodName}`;\n    }\n\n    /**\n     * Log incoming request.\n     */\n    private logRequest(classMethod: string, url: string, request: unknown): void {\n        console.log(`[API-SVR-req] '${classMethod} ${url}' request=${JSON.stringify(request)}`);\n    }\n\n    /**\n     * Log successful response.\n     */\n    private logSuccessResponse(classMethod: string, url: string, response: WpResponse<unknown>): void {\n        console.log(\n            `[API-SVR-resp-SUCCESS] '${classMethod} ${url}' response=${JSON.stringify(response.response)}`,\n        );\n    }\n\n    /**\n     * Log exception based on error type.\n     * User errors get OTHER (no stack trace), server errors get FAIL.\n     */\n    private logException(classMethod: string, url: string, error: unknown): void {\n        if (this.isUserError(error)) {\n            // User errors (400, 401, 403, 404, 266) - no stack trace needed\n            const errorType = (error as Error)?.constructor.name ?? 'UnknownError';\n            console.log(`[API-SVR-resp-OTHER] '${classMethod} ${url}' errorType=${errorType}`);\n        } else {\n            // Server errors (500, 502, etc.) - log full details\n            const errorMessage = error instanceof Error ? error.message : String(error);\n            console.error(`[API-SVR-resp-FAIL] '${classMethod} ${url}' error=${errorMessage}`);\n        }\n    }\n\n    /**\n     * Check if error is a user error (expected behavior from server perspective).\n     * These are NOT failures - just users making mistakes or validation issues.\n     */\n    private isUserError(error: unknown): boolean {\n        return (\n            error instanceof HttpBadRequestError ||\n            error instanceof HttpUnauthorizedError ||\n            error instanceof HttpForbiddenError ||\n            error instanceof HttpNotFoundError ||\n            error instanceof HttpUserError\n        );\n    }\n}\n"]}

package/src/index.d.ts

@@ -1,7 +1,6 @@
 export { WebpiecesServer } from './WebpiecesServer';
 export { WebpiecesFactory } from './WebpiecesFactory';
-export { RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, HttpFilter, } from './RouteBuilderImpl';
-export { RouteHandler } from './RouteHandler';
-export { MethodMeta } from './MethodMeta';
+export { WebpiecesMiddleware } from './WebpiecesMiddleware';
 export { ContextFilter } from './filters/ContextFilter';
-export { JsonFilter, JsonFilterConfig, FILTER_TYPES, ValidationException, HttpException, } from './filters/JsonFilter';
+export { LogApiFilter } from './filters/LogApiFilter';
+export { RouteHandler, ExpressRouteHandler, MethodMeta, RouteBuilderImpl, RouteHandlerWithMeta, FilterWithMeta, HttpFilter, FilterMatcher, } from '@webpieces/http-routing';

package/src/index.js

@@ -1,22 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpException = exports.ValidationException = exports.FILTER_TYPES = exports.JsonFilterConfig = exports.JsonFilter = exports.ContextFilter = exports.MethodMeta = exports.RouteHandler = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.WebpiecesFactory = void 0;
+exports.FilterMatcher = exports.FilterWithMeta = exports.RouteHandlerWithMeta = exports.RouteBuilderImpl = exports.MethodMeta = exports.RouteHandler = exports.LogApiFilter = exports.ContextFilter = exports.WebpiecesMiddleware = exports.WebpiecesFactory = void 0;
 var WebpiecesFactory_1 = require("./WebpiecesFactory");
 Object.defineProperty(exports, "WebpiecesFactory", { enumerable: true, get: function () { return WebpiecesFactory_1.WebpiecesFactory; } });
-var RouteBuilderImpl_1 = require("./RouteBuilderImpl");
-Object.defineProperty(exports, "RouteBuilderImpl", { enumerable: true, get: function () { return RouteBuilderImpl_1.RouteBuilderImpl; } });
-Object.defineProperty(exports, "RouteHandlerWithMeta", { enumerable: true, get: function () { return RouteBuilderImpl_1.RouteHandlerWithMeta; } });
-Object.defineProperty(exports, "FilterWithMeta", { enumerable: true, get: function () { return RouteBuilderImpl_1.FilterWithMeta; } });
-var RouteHandler_1 = require("./RouteHandler");
-Object.defineProperty(exports, "RouteHandler", { enumerable: true, get: function () { return RouteHandler_1.RouteHandler; } });
-var MethodMeta_1 = require("./MethodMeta");
-Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return MethodMeta_1.MethodMeta; } });
+var WebpiecesMiddleware_1 = require("./WebpiecesMiddleware");
+Object.defineProperty(exports, "WebpiecesMiddleware", { enumerable: true, get: function () { return WebpiecesMiddleware_1.WebpiecesMiddleware; } });
 var ContextFilter_1 = require("./filters/ContextFilter");
 Object.defineProperty(exports, "ContextFilter", { enumerable: true, get: function () { return ContextFilter_1.ContextFilter; } });
-var JsonFilter_1 = require("./filters/JsonFilter");
-Object.defineProperty(exports, "JsonFilter", { enumerable: true, get: function () { return JsonFilter_1.JsonFilter; } });
-Object.defineProperty(exports, "JsonFilterConfig", { enumerable: true, get: function () { return JsonFilter_1.JsonFilterConfig; } });
-Object.defineProperty(exports, "FILTER_TYPES", { enumerable: true, get: function () { return JsonFilter_1.FILTER_TYPES; } });
-Object.defineProperty(exports, "ValidationException", { enumerable: true, get: function () { return JsonFilter_1.ValidationException; } });
-Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return JsonFilter_1.HttpException; } });
+var LogApiFilter_1 = require("./filters/LogApiFilter");
+Object.defineProperty(exports, "LogApiFilter", { enumerable: true, get: function () { return LogApiFilter_1.LogApiFilter; } });
+// Re-export from http-routing for backward compatibility
+var http_routing_1 = require("@webpieces/http-routing");
+Object.defineProperty(exports, "RouteHandler", { enumerable: true, get: function () { return http_routing_1.RouteHandler; } });
+Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return http_routing_1.MethodMeta; } });
+Object.defineProperty(exports, "RouteBuilderImpl", { enumerable: true, get: function () { return http_routing_1.RouteBuilderImpl; } });
+Object.defineProperty(exports, "RouteHandlerWithMeta", { enumerable: true, get: function () { return http_routing_1.RouteHandlerWithMeta; } });
+Object.defineProperty(exports, "FilterWithMeta", { enumerable: true, get: function () { return http_routing_1.FilterWithMeta; } });
+Object.defineProperty(exports, "FilterMatcher", { enumerable: true, get: function () { return http_routing_1.FilterMatcher; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,uDAK4B;AAJxB,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,kHAAA,cAAc,OAAA;AAGlB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,mDAM8B;AAL1B,wGAAA,UAAU,OAAA;AACV,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AACZ,iHAAA,mBAAmB,OAAA;AACnB,2GAAA,aAAa,OAAA","sourcesContent":["export { WebpiecesServer } from './WebpiecesServer';\nexport { WebpiecesFactory } from './WebpiecesFactory';\nexport {\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    HttpFilter,\n} from './RouteBuilderImpl';\nexport { RouteHandler } from './RouteHandler';\nexport { MethodMeta } from './MethodMeta';\nexport { ContextFilter } from './filters/ContextFilter';\nexport {\n    JsonFilter,\n    JsonFilterConfig,\n    FILTER_TYPES,\n    ValidationException,\n    HttpException,\n} from './filters/JsonFilter';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/src/index.ts"],"names":[],"mappings":";;;AACA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AAErB,yDAAyD;AACzD,wDASiC;AAR7B,4GAAA,YAAY,OAAA;AAEZ,0GAAA,UAAU,OAAA;AACV,gHAAA,gBAAgB,OAAA;AAChB,oHAAA,oBAAoB,OAAA;AACpB,8GAAA,cAAc,OAAA;AAEd,6GAAA,aAAa,OAAA","sourcesContent":["export { WebpiecesServer } from './WebpiecesServer';\nexport { WebpiecesFactory } from './WebpiecesFactory';\nexport { WebpiecesMiddleware } from './WebpiecesMiddleware';\nexport { ContextFilter } from './filters/ContextFilter';\nexport { LogApiFilter } from './filters/LogApiFilter';\n\n// Re-export from http-routing for backward compatibility\nexport {\n    RouteHandler,\n    ExpressRouteHandler,\n    MethodMeta,\n    RouteBuilderImpl,\n    RouteHandlerWithMeta,\n    FilterWithMeta,\n    HttpFilter,\n    FilterMatcher,\n} from '@webpieces/http-routing';\n"]}

package/src/FilterMatcher.d.ts

@@ -1,39 +0,0 @@
-import { Filter, WpResponse } from '@webpieces/http-filters';
-import { MethodMeta } from './MethodMeta';
-import { FilterDefinition } from '@webpieces/core-meta';
-/**
- * Type alias for HTTP filters that work with MethodMeta and ResponseWrapper.
- */
-export type HttpFilter = Filter<MethodMeta, WpResponse<unknown>>;
-/**
- * FilterMatcher - Matches filters to routes based on filepath patterns.
- * Similar to Java SharedMatchUtil.findMatchingFilters().
- *
- * Responsibilities:
- * 1. Filter based on filepath glob pattern matching
- * 2. Sort matching filters by priority (higher first)
- *
- * Differences from Java:
- * - Uses glob patterns instead of regex
- * - Only matches filepaths (no URL path or HTTPS filtering yet)
- * - Simpler API focused on one responsibility
- */
-export declare class FilterMatcher {
-    /**
-     * Find filters that match the given controller filepath.
-     *
-     * @param controllerFilepath - The filepath of the controller source file
-     * @param allFilters - All registered filters with their definitions
-     * @returns Array of matching filters, sorted by priority (highest first)
-     */
-    static findMatchingFilters(controllerFilepath: string | undefined, allFilters: Array<FilterDefinition>): HttpFilter[];
-    /**
-     * Normalize a controller filepath for consistent matching.
-     * - Converts backslashes to forward slashes (Windows compatibility)
-     * - Removes leading './'
-     *
-     * @param filepath - Raw filepath
-     * @returns Normalized filepath
-     */
-    static normalizeFilepath(filepath: string): string;
-}

package/src/FilterMatcher.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilterMatcher = void 0;
-const minimatch_1 = require("minimatch");
-/**
- * FilterMatcher - Matches filters to routes based on filepath patterns.
- * Similar to Java SharedMatchUtil.findMatchingFilters().
- *
- * Responsibilities:
- * 1. Filter based on filepath glob pattern matching
- * 2. Sort matching filters by priority (higher first)
- *
- * Differences from Java:
- * - Uses glob patterns instead of regex
- * - Only matches filepaths (no URL path or HTTPS filtering yet)
- * - Simpler API focused on one responsibility
- */
-class FilterMatcher {
-    /**
-     * Find filters that match the given controller filepath.
-     *
-     * @param controllerFilepath - The filepath of the controller source file
-     * @param allFilters - All registered filters with their definitions
-     * @returns Array of matching filters, sorted by priority (highest first)
-     */
-    static findMatchingFilters(controllerFilepath, allFilters) {
-        const matchingFilters = [];
-        for (const definition of allFilters) {
-            const pattern = definition.filepathPattern;
-            const filter = definition.filter;
-            // Special case: '*' matches all controllers (global filter)
-            if (pattern === '*') {
-                matchingFilters.push({ filter, priority: definition.priority });
-                continue;
-            }
-            // If no filepath available, only match wildcard patterns
-            if (!controllerFilepath) {
-                if (pattern === '**/*') {
-                    matchingFilters.push({ filter, priority: definition.priority });
-                }
-                continue;
-            }
-            // Normalize filepath for consistent matching
-            const normalizedPath = FilterMatcher.normalizeFilepath(controllerFilepath);
-            // Match using minimatch
-            if ((0, minimatch_1.minimatch)(normalizedPath, pattern)) {
-                matchingFilters.push({ filter, priority: definition.priority });
-            }
-        }
-        // Sort by priority (highest first)
-        matchingFilters.sort((a, b) => b.priority - a.priority);
-        return matchingFilters.map((item) => item.filter);
-    }
-    /**
-     * Normalize a controller filepath for consistent matching.
-     * - Converts backslashes to forward slashes (Windows compatibility)
-     * - Removes leading './'
-     *
-     * @param filepath - Raw filepath
-     * @returns Normalized filepath
-     */
-    static normalizeFilepath(filepath) {
-        return filepath
-            .replace(/\\/g, '/') // Windows backslashes to forward slashes
-            .replace(/^\.\//, ''); // Remove leading './'
-    }
-}
-exports.FilterMatcher = FilterMatcher;
-//# sourceMappingURL=FilterMatcher.js.map

package/src/FilterMatcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FilterMatcher.js","sourceRoot":"","sources":["../../../../../packages/http/http-server/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 '@webpieces/core-meta';\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/MethodMeta.d.ts

@@ -1,42 +0,0 @@
-import { RouteMetadata2, RouteRequest } from '@webpieces/core-meta';
-/**
- * Metadata about the method being invoked.
- * Passed to filters and contains request information.
- *
- * MethodMeta is created by WebpiecesServerImpl when handling a request:
- * - routeMeta: Static route information (httpMethod, path, methodName)
- * - routeRequest: Express Request/Response objects
- * - requestDto: Set by JsonFilter after deserializing the request body
- */
-export declare class MethodMeta {
-    /**
-     * Route metadata (httpMethod, path, methodName, parameterTypes)
-     */
-    routeMeta: RouteMetadata2;
-    /**
-     * Express Request and Response objects
-     */
-    routeRequest: RouteRequest;
-    /**
-     * The deserialized request DTO.
-     * Set by JsonFilter after deserializing the request body.
-     */
-    requestDto?: unknown;
-    /**
-     * Additional metadata for storing request-scoped data.
-     */
-    metadata: Map<string, unknown>;
-    constructor(routeMeta: RouteMetadata2, routeRequest: RouteRequest, requestDto?: unknown, metadata?: Map<string, unknown>);
-    /**
-     * 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,40 +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 created by WebpiecesServerImpl when handling a request:
- * - routeMeta: Static route information (httpMethod, path, methodName)
- * - routeRequest: Express Request/Response objects
- * - requestDto: Set by JsonFilter after deserializing the request body
- */
-class MethodMeta {
-    constructor(routeMeta, routeRequest, requestDto, metadata) {
-        this.routeMeta = routeMeta;
-        this.routeRequest = routeRequest;
-        this.requestDto = requestDto;
-        this.metadata = metadata ?? new Map();
-    }
-    /**
-     * 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-server/src/MethodMeta.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACH,MAAa,UAAU;IAsBnB,YACI,SAAyB,EACzB,YAA0B,EAC1B,UAAoB,EACpB,QAA+B;QAE/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,GAAG,EAAE,CAAC;IAC1C,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;AAtDD,gCAsDC","sourcesContent":["import { RouteMetadata2, RouteRequest } from '@webpieces/core-meta';\n\n/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n *\n * MethodMeta is created by WebpiecesServerImpl when handling a request:\n * - routeMeta: Static route information (httpMethod, path, methodName)\n * - routeRequest: Express Request/Response objects\n * - requestDto: Set by JsonFilter after deserializing the request body\n */\nexport class MethodMeta {\n    /**\n     * Route metadata (httpMethod, path, methodName, parameterTypes)\n     */\n    routeMeta: RouteMetadata2;\n\n    /**\n     * Express Request and Response objects\n     */\n    routeRequest: RouteRequest;\n\n    /**\n     * The deserialized request DTO.\n     * Set by JsonFilter after deserializing the request body.\n     */\n    requestDto?: unknown;\n\n    /**\n     * Additional metadata for storing request-scoped data.\n     */\n    metadata: Map<string, unknown>;\n\n    constructor(\n        routeMeta: RouteMetadata2,\n        routeRequest: RouteRequest,\n        requestDto?: unknown,\n        metadata?: Map<string, unknown>,\n    ) {\n        this.routeMeta = routeMeta;\n        this.routeRequest = routeRequest;\n        this.requestDto = requestDto;\n        this.metadata = metadata ?? new Map();\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/RouteBuilderImpl.d.ts

@@ -1,90 +0,0 @@
-import { Container } from 'inversify';
-import { RouteBuilder, RouteDefinition, FilterDefinition } from '@webpieces/core-meta';
-import { Filter, WpResponse } from '@webpieces/http-filters';
-import { RouteHandler } from './RouteHandler';
-import { MethodMeta } from './MethodMeta';
-/**
- * Type alias for HTTP filters that work with MethodMeta and ResponseWrapper.
- */
-export type HttpFilter = Filter<MethodMeta, WpResponse<unknown>>;
-/**
- * FilterWithMeta - Pairs a resolved filter instance with its definition.
- * Stores both the DI-resolved filter and the metadata needed for matching.
- */
-export declare class FilterWithMeta {
-    filter: HttpFilter;
-    definition: FilterDefinition;
-    constructor(filter: HttpFilter, definition: FilterDefinition);
-}
-/**
- * RouteHandlerWithMeta - Pairs a route handler with its definition.
- * Stores both the handler (which wraps the DI-resolved controller) and the route metadata.
- *
- * We use unknown for the generic type since we store different TResult types in the same Map.
- * Type safety is maintained through the generic on RouteDefinition at registration time.
- */
-export declare class RouteHandlerWithMeta {
-    handler: RouteHandler<unknown>;
-    definition: RouteDefinition<unknown>;
-    constructor(handler: RouteHandler<unknown>, definition: RouteDefinition<unknown>);
-}
-/**
- * RouteBuilderImpl - Concrete implementation of RouteBuilder interface.
- *
- * Similar to Java WebPieces RouteBuilder, this class is responsible for:
- * 1. Registering routes with their handlers
- * 2. Registering filters with priority
- *
- * This class is explicit (not anonymous) to:
- * - Improve traceability and debugging
- * - Make the code easier to understand
- * - Enable better IDE navigation (Cmd+Click on addRoute works!)
- *
- * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()
- * but needs appContainer to resolve filters/controllers. The container is set via
- * setContainer() after appContainer is created (late binding pattern).
- */
-export declare class RouteBuilderImpl implements RouteBuilder {
-    private routes;
-    private filterRegistry;
-    private container?;
-    /**
-     * Set the DI container used for resolving filters and controllers.
-     * Called by WebpiecesCoreServer after appContainer is created.
-     *
-     * @param container - The application DI container (appContainer)
-     */
-    setContainer(container: Container): void;
-    /**
-     * Register a route with the router.
-     *
-     * Resolves the controller from DI container ONCE and creates a handler that uses
-     * the resolved controller instance. This is more efficient than resolving on every request.
-     *
-     * The route is stored with a key of "METHOD:path" (e.g., "POST:/search/item").
-     *
-     * @param route - Route definition with controller class and method name
-     */
-    addRoute<TResult = unknown>(route: RouteDefinition<TResult>): void;
-    /**
-     * Register a filter with the filter chain.
-     *
-     * Resolves the filter from DI container and pairs it with the filter definition.
-     * The definition includes pattern information used for route-specific filtering.
-     *
-     * @param filterDef - Filter definition with priority, filter class, and optional filepath pattern
-     */
-    addFilter(filterDef: FilterDefinition): void;
-    /**
-     * Get all registered routes.
-     *
-     * @returns Map of routes with handlers and definitions, keyed by "METHOD:path"
-     */
-    getRoutes(): Map<string, RouteHandlerWithMeta>;
-    /**
-     * Get all filters sorted by priority (highest priority first).
-     *
-     * @returns Array of FilterWithMeta sorted by priority
-     */
-    getSortedFilters(): Array<FilterWithMeta>;
-}

package/src/RouteBuilderImpl.js

@@ -1,141 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RouteBuilderImpl = exports.RouteHandlerWithMeta = exports.FilterWithMeta = void 0;
-const tslib_1 = require("tslib");
-const inversify_1 = require("inversify");
-const http_routing_1 = require("@webpieces/http-routing");
-const RouteHandler_1 = require("./RouteHandler");
-/**
- * FilterWithMeta - Pairs a resolved filter instance with its definition.
- * Stores both the DI-resolved filter and the metadata needed for matching.
- */
-class FilterWithMeta {
-    constructor(filter, definition) {
-        this.filter = filter;
-        this.definition = definition;
-    }
-}
-exports.FilterWithMeta = FilterWithMeta;
-/**
- * RouteHandlerWithMeta - Pairs a route handler with its definition.
- * Stores both the handler (which wraps the DI-resolved controller) and the route metadata.
- *
- * We use unknown for the generic type since we store different TResult types in the same Map.
- * Type safety is maintained through the generic on RouteDefinition at registration time.
- */
-class RouteHandlerWithMeta {
-    constructor(handler, definition) {
-        this.handler = handler;
-        this.definition = definition;
-    }
-}
-exports.RouteHandlerWithMeta = RouteHandlerWithMeta;
-/**
- * RouteBuilderImpl - Concrete implementation of RouteBuilder interface.
- *
- * Similar to Java WebPieces RouteBuilder, this class is responsible for:
- * 1. Registering routes with their handlers
- * 2. Registering filters with priority
- *
- * This class is explicit (not anonymous) to:
- * - Improve traceability and debugging
- * - Make the code easier to understand
- * - Enable better IDE navigation (Cmd+Click on addRoute works!)
- *
- * DI Pattern: This class is registered in webpiecesContainer via @provideSingleton()
- * but needs appContainer to resolve filters/controllers. The container is set via
- * setContainer() after appContainer is created (late binding pattern).
- */
-let RouteBuilderImpl = class RouteBuilderImpl {
-    constructor() {
-        this.routes = new Map();
-        this.filterRegistry = [];
-    }
-    /**
-     * Set the DI container used for resolving filters and controllers.
-     * Called by WebpiecesCoreServer after appContainer is created.
-     *
-     * @param container - The application DI container (appContainer)
-     */
-    setContainer(container) {
-        this.container = container;
-    }
-    /**
-     * Register a route with the router.
-     *
-     * Resolves the controller from DI container ONCE and creates a handler that uses
-     * the resolved controller instance. This is more efficient than resolving on every request.
-     *
-     * The route is stored with a key of "METHOD:path" (e.g., "POST:/search/item").
-     *
-     * @param route - Route definition with controller class and method name
-     */
-    addRoute(route) {
-        if (!this.container) {
-            throw new Error('Container not set. Call setContainer() before registering routes.');
-        }
-        const routeMeta = route.routeMeta;
-        const key = `${routeMeta.httpMethod}:${routeMeta.path}`;
-        // Resolve controller instance from DI container ONCE (not on every request!)
-        const controller = this.container.get(route.controllerClass);
-        // Get the controller method
-        const method = controller[routeMeta.methodName];
-        if (typeof method !== 'function') {
-            const controllerName = route.controllerClass.name || 'Unknown';
-            throw new Error(`Method ${routeMeta.methodName} not found on controller ${controllerName}`);
-        }
-        // Create handler that uses the resolved controller instance
-        const handler = new (class extends RouteHandler_1.RouteHandler {
-            async execute(meta) {
-                // Invoke the method with requestDto from meta
-                // The controller is already resolved - no DI lookup on every request!
-                // Pass requestDto as the single argument to the controller method
-                const result = await method.call(controller, meta.requestDto);
-                return result;
-            }
-        })();
-        // Store handler with route definition
-        const routeWithMeta = new RouteHandlerWithMeta(handler, route);
-        this.routes.set(key, routeWithMeta);
-    }
-    /**
-     * Register a filter with the filter chain.
-     *
-     * Resolves the filter from DI container and pairs it with the filter definition.
-     * The definition includes pattern information used for route-specific filtering.
-     *
-     * @param filterDef - Filter definition with priority, filter class, and optional filepath pattern
-     */
-    addFilter(filterDef) {
-        if (!this.container) {
-            throw new Error('Container not set. Call setContainer() before registering filters.');
-        }
-        // Resolve filter instance from DI container
-        const filter = this.container.get(filterDef.filterClass);
-        // Store filter with its definition
-        const filterWithMeta = new FilterWithMeta(filter, filterDef);
-        this.filterRegistry.push(filterWithMeta);
-    }
-    /**
-     * Get all registered routes.
-     *
-     * @returns Map of routes with handlers and definitions, keyed by "METHOD:path"
-     */
-    getRoutes() {
-        return this.routes;
-    }
-    /**
-     * Get all filters sorted by priority (highest priority first).
-     *
-     * @returns Array of FilterWithMeta sorted by priority
-     */
-    getSortedFilters() {
-        return [...this.filterRegistry].sort((a, b) => b.definition.priority - a.definition.priority);
-    }
-};
-exports.RouteBuilderImpl = RouteBuilderImpl;
-exports.RouteBuilderImpl = RouteBuilderImpl = tslib_1.__decorate([
-    (0, http_routing_1.provideSingleton)(),
-    (0, inversify_1.injectable)()
-], RouteBuilderImpl);
-//# sourceMappingURL=RouteBuilderImpl.js.map