@webpieces/http-filters 0.2.12 → 0.2.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-filters",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Filter chain infrastructure for cross-cutting concerns",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -21,6 +21,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/core-context": "0.2.12"
+    "@webpieces/core-context": "0.2.14"
   }
 }

package/src/Filter.d.ts

@@ -1,112 +1,85 @@
 /**
- * Metadata about the method being invoked.
- * Passed to filters and contains request information.
+ * WpResponse - Wraps controller responses for the filter chain.
+ *
+ * Generic type parameter TResult represents the controller's return type.
+ * The filter chain uses WpResponse<unknown> because it handles all response types uniformly.
+ *
+ * JsonFilter is responsible for:
+ * 1. Serializing WpResponse.response to JSON
+ * 2. Writing the JSON to the HTTP response body
  */
-export declare class MethodMeta {
-    /**
-     * The HTTP method (GET, POST, etc.)
-     */
-    httpMethod: string;
-    /**
-     * The request path
-     */
-    path: string;
-    /**
-     * The method name being invoked on the controller
-     */
-    methodName: string;
+export declare class WpResponse<TResult = unknown> {
+    response?: TResult;
+    statusCode: number;
+    headers: Map<string, string>;
+    constructor(response?: TResult, statusCode?: number);
     /**
-     * Parameters to pass to the controller method.
-     * Filters can modify this array (e.g., JsonFilter deserializes request body into params[0])
+     * Set a response header.
      */
-    params: any[];
+    setHeader(name: string, value: string): WpResponse<TResult>;
     /**
-     * The original request object (if applicable)
+     * Create an error response wrapper.
      */
-    request?: any;
-    /**
-     * The response object (if applicable)
-     */
-    response?: any;
-    /**
-     * Additional metadata
-     */
-    metadata?: Map<string, any>;
-    constructor(httpMethod: string, path: string, methodName: string, params: any[], request?: any, response?: any, metadata?: Map<string, any>);
-}
-/**
- * Action returned by filters and controllers.
- * Can represent different types of responses.
- */
-export declare class Action {
-    type: 'json' | 'html' | 'redirect' | 'error';
-    data?: any;
-    statusCode?: number;
-    headers?: Record<string, string>;
-    constructor(type: 'json' | 'html' | 'redirect' | 'error', data?: any, statusCode?: number, headers?: Record<string, string>);
+    static error<T = unknown>(message: string, statusCode?: number): WpResponse<T>;
 }
 /**
- * Next filter class.
- * This is a class instead of a function type to make it easier to trace
- * who is calling what in the debugger/IDE.
+ * Service interface - Similar to Java WebPieces Service<REQ, RESP>.
+ * Represents any component that can process a request and return a response.
+ *
+ * Used for:
+ * - Final controller invocation
+ * - Wrapping filters as services in the chain
+ * - Functional composition of filters
  */
-export declare abstract class NextFilter {
+export interface Service<REQ, RESP> {
     /**
-     * Execute the next filter in the chain.
-     * @returns Promise of the action
+     * Invoke the service with the given metadata.
+     * @param meta - Request metadata
+     * @returns Promise of the response
      */
-    abstract execute(): Promise<Action>;
+    invoke(meta: REQ): Promise<RESP>;
 }
 /**
- * Filter interface.
- * Similar to Java WebPieces RouteFilter.
+ * Filter abstract class - Similar to Java WebPieces Filter<REQ, RESP>.
  *
- * Filters are executed in priority order (higher priority first)
- * and can wrap the execution of subsequent filters and the controller.
+ * Filters are STATELESS and can handle N concurrent requests.
+ * They wrap the execution of subsequent filters and the controller.
  *
- * Example:
- * ```typescript
- * @injectable()
- * export class LoggingFilter implements Filter {
- *   priority = 100;
+ * Key principles:
+ * - STATELESS: No instance variables for request data
+ * - COMPOSABLE: Use chain() methods for functional composition
  *
- *   async filter(meta: MethodMeta, next: NextFilter): Promise<Action> {
- *     console.log(`Request: ${meta.httpMethod} ${meta.path}`);
- *     const action = await next.execute();
- *     console.log(`Response: ${action.statusCode}`);
- *     return action;
- *   }
- * }
- * ```
+ * For HTTP filters, use Filter<MethodMeta, WpResponse<unknown>>:
+ * - MethodMeta: Standardized request metadata (defined in http-server)
+ * - WpResponse<unknown>: Wraps any controller response
  */
-export interface Filter {
-    /**
-     * Priority of this filter.
-     * Higher numbers execute first.
-     * Typical values:
-     * - 140: Context setup
-     * - 120: Request attributes
-     * - 90: Metrics
-     * - 80: Logging
-     * - 60: JSON serialization
-     * - 40: Transactions
-     * - 0: Controller
-     */
-    priority: number;
+export declare abstract class Filter<REQ, RESP> {
     /**
      * Filter method that wraps the next filter/controller.
      *
      * @param meta - Metadata about the method being invoked
-     * @param next - NextFilter instance to invoke the next filter in the chain
-     * @returns Promise of the action to return
+     * @param nextFilter - Next filter/controller as a Service
+     * @returns Promise of the response
+     */
+    abstract filter(meta: REQ, nextFilter: Service<REQ, RESP>): Promise<RESP>;
+    /**
+     * Chain this filter with another filter.
+     * Returns a new Filter that composes both filters.
+     *
+     * Similar to Java: filter1.chain(filter2)
+     *
+     * @param nextFilter - The filter to execute after this one
+     * @returns Composed filter
      */
-    filter(meta: MethodMeta, next: NextFilter): Promise<Action>;
+    chain(nextFilter: Filter<REQ, RESP>): Filter<REQ, RESP>;
+    /**
+     * Chain this filter with a final service (controller).
+     * Returns a Service that can be invoked.
+     *
+     * Similar to Java: filter.chain(service)
+     *
+     * @param svc - The final service (controller) to execute
+     * @returns Service wrapping the entire filter chain
+     */
+    chainService(svc: Service<REQ, RESP>): Service<REQ, RESP>;
 }
-/**
- * Helper to create a JSON action response.
- */
-export declare function jsonAction(data: any, statusCode?: number): Action;
-/**
- * Helper to create an error action response.
- */
-export declare function errorAction(error: Error | string, statusCode?: number): Action;

package/src/Filter.js

@@ -1,57 +1,89 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NextFilter = exports.Action = exports.MethodMeta = void 0;
-exports.jsonAction = jsonAction;
-exports.errorAction = errorAction;
+exports.Filter = exports.WpResponse = void 0;
 /**
- * Metadata about the method being invoked.
- * Passed to filters and contains request information.
+ * WpResponse - Wraps controller responses for the filter chain.
+ *
+ * Generic type parameter TResult represents the controller's return type.
+ * The filter chain uses WpResponse<unknown> because it handles all response types uniformly.
+ *
+ * JsonFilter is responsible for:
+ * 1. Serializing WpResponse.response to JSON
+ * 2. Writing the JSON to the HTTP response body
  */
-class MethodMeta {
-    constructor(httpMethod, path, methodName, params, request, response, metadata) {
-        this.httpMethod = httpMethod;
-        this.path = path;
-        this.methodName = methodName;
-        this.params = params;
-        this.request = request;
+class WpResponse {
+    constructor(response, statusCode = 200) {
         this.response = response;
-        this.metadata = metadata;
-    }
-}
-exports.MethodMeta = MethodMeta;
-/**
- * Action returned by filters and controllers.
- * Can represent different types of responses.
- */
-class Action {
-    constructor(type, data, statusCode, headers) {
-        this.type = type;
-        this.data = data;
         this.statusCode = statusCode;
-        this.headers = headers;
+        this.headers = new Map();
+    }
+    /**
+     * Set a response header.
+     */
+    setHeader(name, value) {
+        this.headers.set(name, value);
+        return this;
+    }
+    /**
+     * Create an error response wrapper.
+     */
+    static error(message, statusCode = 500) {
+        const wrapper = new WpResponse(undefined, statusCode);
+        wrapper.setHeader('X-Error', message);
+        return wrapper;
     }
 }
-exports.Action = Action;
-/**
- * Next filter class.
- * This is a class instead of a function type to make it easier to trace
- * who is calling what in the debugger/IDE.
- */
-class NextFilter {
-}
-exports.NextFilter = NextFilter;
-/**
- * Helper to create a JSON action response.
- */
-function jsonAction(data, statusCode = 200) {
-    return new Action('json', data, statusCode);
-}
+exports.WpResponse = WpResponse;
 /**
- * Helper to create an error action response.
+ * Filter abstract class - Similar to Java WebPieces Filter<REQ, RESP>.
+ *
+ * Filters are STATELESS and can handle N concurrent requests.
+ * They wrap the execution of subsequent filters and the controller.
+ *
+ * Key principles:
+ * - STATELESS: No instance variables for request data
+ * - COMPOSABLE: Use chain() methods for functional composition
+ *
+ * For HTTP filters, use Filter<MethodMeta, WpResponse<unknown>>:
+ * - MethodMeta: Standardized request metadata (defined in http-server)
+ * - WpResponse<unknown>: Wraps any controller response
  */
-function errorAction(error, statusCode = 500) {
-    return new Action('error', {
-        error: typeof error === 'string' ? error : error.message,
-    }, statusCode);
+class Filter {
+    /**
+     * Chain this filter with another filter.
+     * Returns a new Filter that composes both filters.
+     *
+     * Similar to Java: filter1.chain(filter2)
+     *
+     * @param nextFilter - The filter to execute after this one
+     * @returns Composed filter
+     */
+    chain(nextFilter) {
+        const self = this;
+        return new class extends Filter {
+            async filter(meta, nextService) {
+                // Call outer filter, passing next filter wrapped as a Service
+                return self.filter(meta, {
+                    invoke: (m) => nextFilter.filter(m, nextService)
+                });
+            }
+        };
+    }
+    /**
+     * Chain this filter with a final service (controller).
+     * Returns a Service that can be invoked.
+     *
+     * Similar to Java: filter.chain(service)
+     *
+     * @param svc - The final service (controller) to execute
+     * @returns Service wrapping the entire filter chain
+     */
+    chainService(svc) {
+        const self = this;
+        return {
+            invoke: (meta) => self.filter(meta, svc)
+        };
+    }
 }
+exports.Filter = Filter;
 //# sourceMappingURL=Filter.js.map

package/src/Filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Filter.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/Filter.ts"],"names":[],"mappings":";;;AAkJA,gCAEC;AAKD,kCAWC;AApKD;;;GAGG;AACH,MAAa,UAAU;IAqCrB,YACE,UAAkB,EAClB,IAAY,EACZ,UAAkB,EAClB,MAAa,EACb,OAAa,EACb,QAAc,EACd,QAA2B;QAE3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAtDD,gCAsDC;AAED;;;GAGG;AACH,MAAa,MAAM;IAMjB,YACE,IAA4C,EAC5C,IAAU,EACV,UAAmB,EACnB,OAAgC;QAEhC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAjBD,wBAiBC;AAED;;;;GAIG;AACH,MAAsB,UAAU;CAM/B;AAND,gCAMC;AAiDD;;GAEG;AACH,SAAgB,UAAU,CAAC,IAAS,EAAE,aAAqB,GAAG;IAC5D,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,KAAqB,EACrB,aAAqB,GAAG;IAExB,OAAO,IAAI,MAAM,CACf,OAAO,EACP;QACE,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;KACzD,EACD,UAAU,CACX,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n */\nexport class MethodMeta {\n  /**\n   * The HTTP method (GET, POST, etc.)\n   */\n  httpMethod: string;\n\n  /**\n   * The request path\n   */\n  path: string;\n\n  /**\n   * The method name being invoked on the controller\n   */\n  methodName: string;\n\n  /**\n   * Parameters to pass to the controller method.\n   * Filters can modify this array (e.g., JsonFilter deserializes request body into params[0])\n   */\n  params: any[];\n\n  /**\n   * The original request object (if applicable)\n   */\n  request?: any;\n\n  /**\n   * The response object (if applicable)\n   */\n  response?: any;\n\n  /**\n   * Additional metadata\n   */\n  metadata?: Map<string, any>;\n\n  constructor(\n    httpMethod: string,\n    path: string,\n    methodName: string,\n    params: any[],\n    request?: any,\n    response?: any,\n    metadata?: Map<string, any>\n  ) {\n    this.httpMethod = httpMethod;\n    this.path = path;\n    this.methodName = methodName;\n    this.params = params;\n    this.request = request;\n    this.response = response;\n    this.metadata = metadata;\n  }\n}\n\n/**\n * Action returned by filters and controllers.\n * Can represent different types of responses.\n */\nexport class Action {\n  type: 'json' | 'html' | 'redirect' | 'error';\n  data?: any;\n  statusCode?: number;\n  headers?: Record<string, string>;\n\n  constructor(\n    type: 'json' | 'html' | 'redirect' | 'error',\n    data?: any,\n    statusCode?: number,\n    headers?: Record<string, string>\n  ) {\n    this.type = type;\n    this.data = data;\n    this.statusCode = statusCode;\n    this.headers = headers;\n  }\n}\n\n/**\n * Next filter class.\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 NextFilter {\n  /**\n   * Execute the next filter in the chain.\n   * @returns Promise of the action\n   */\n  abstract execute(): Promise<Action>;\n}\n\n/**\n * Filter interface.\n * Similar to Java WebPieces RouteFilter.\n *\n * Filters are executed in priority order (higher priority first)\n * and can wrap the execution of subsequent filters and the controller.\n *\n * Example:\n * ```typescript\n * @injectable()\n * export class LoggingFilter implements Filter {\n *   priority = 100;\n *\n *   async filter(meta: MethodMeta, next: NextFilter): Promise<Action> {\n *     console.log(`Request: ${meta.httpMethod} ${meta.path}`);\n *     const action = await next.execute();\n *     console.log(`Response: ${action.statusCode}`);\n *     return action;\n *   }\n * }\n * ```\n */\nexport interface Filter {\n  /**\n   * Priority of this filter.\n   * Higher numbers execute first.\n   * Typical values:\n   * - 140: Context setup\n   * - 120: Request attributes\n   * - 90: Metrics\n   * - 80: Logging\n   * - 60: JSON serialization\n   * - 40: Transactions\n   * - 0: Controller\n   */\n  priority: number;\n\n  /**\n   * Filter method that wraps the next filter/controller.\n   *\n   * @param meta - Metadata about the method being invoked\n   * @param next - NextFilter instance to invoke the next filter in the chain\n   * @returns Promise of the action to return\n   */\n  filter(meta: MethodMeta, next: NextFilter): Promise<Action>;\n}\n\n/**\n * Helper to create a JSON action response.\n */\nexport function jsonAction(data: any, statusCode: number = 200): Action {\n  return new Action('json', data, statusCode);\n}\n\n/**\n * Helper to create an error action response.\n */\nexport function errorAction(\n  error: Error | string,\n  statusCode: number = 500\n): Action {\n  return new Action(\n    'error',\n    {\n      error: typeof error === 'string' ? error : error.message,\n    },\n    statusCode\n  );\n}\n"]}
+{"version":3,"file":"Filter.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/Filter.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,MAAa,UAAU;IAKrB,YAAY,QAAkB,EAAE,aAAqB,GAAG;QACtD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAY,EAAE,KAAa;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAc,OAAe,EAAE,aAAqB,GAAG;QACjE,MAAM,OAAO,GAAG,IAAI,UAAU,CAAI,SAAS,EAAE,UAAU,CAAC,CAAC;QACzD,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA3BD,gCA2BC;AAoBD;;;;;;;;;;;;;GAaG;AACH,MAAsB,MAAM;IAiB1B;;;;;;;;OAQG;IACH,KAAK,CAAC,UAA6B;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,OAAO,IAAI,KAAM,SAAQ,MAAiB;YACxC,KAAK,CAAC,MAAM,CACV,IAAS,EACT,WAA+B;gBAE/B,8DAA8D;gBAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;oBACvB,MAAM,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,GAAuB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,OAAO;YACL,MAAM,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF;AA1DD,wBA0DC","sourcesContent":["/**\n * WpResponse - Wraps controller responses for the filter chain.\n *\n * Generic type parameter TResult represents the controller's return type.\n * The filter chain uses WpResponse<unknown> because it handles all response types uniformly.\n *\n * JsonFilter is responsible for:\n * 1. Serializing WpResponse.response to JSON\n * 2. Writing the JSON to the HTTP response body\n */\nexport class WpResponse<TResult = unknown> {\n  response?: TResult;\n  statusCode: number;\n  headers: Map<string, string>;\n\n  constructor(response?: TResult, statusCode: number = 200) {\n    this.response = response;\n    this.statusCode = statusCode;\n    this.headers = new Map();\n  }\n\n  /**\n   * Set a response header.\n   */\n  setHeader(name: string, value: string): WpResponse<TResult> {\n    this.headers.set(name, value);\n    return this;\n  }\n\n  /**\n   * Create an error response wrapper.\n   */\n  static error<T = unknown>(message: string, statusCode: number = 500): WpResponse<T> {\n    const wrapper = new WpResponse<T>(undefined, statusCode);\n    wrapper.setHeader('X-Error', message);\n    return wrapper;\n  }\n}\n\n/**\n * Service interface - Similar to Java WebPieces Service<REQ, RESP>.\n * Represents any component that can process a request and return a response.\n *\n * Used for:\n * - Final controller invocation\n * - Wrapping filters as services in the chain\n * - Functional composition of filters\n */\nexport interface Service<REQ, RESP> {\n  /**\n   * Invoke the service with the given metadata.\n   * @param meta - Request metadata\n   * @returns Promise of the response\n   */\n  invoke(meta: REQ): Promise<RESP>;\n}\n\n/**\n * Filter abstract class - Similar to Java WebPieces Filter<REQ, RESP>.\n *\n * Filters are STATELESS and can handle N concurrent requests.\n * They wrap the execution of subsequent filters and the controller.\n *\n * Key principles:\n * - STATELESS: No instance variables for request data\n * - COMPOSABLE: Use chain() methods for functional composition\n *\n * For HTTP filters, use Filter<MethodMeta, WpResponse<unknown>>:\n * - MethodMeta: Standardized request metadata (defined in http-server)\n * - WpResponse<unknown>: Wraps any controller response\n */\nexport abstract class Filter<REQ, RESP> {\n\n  //priority is determined by how it is chained only here\n  //DO NOT add priority here\n\n  /**\n   * Filter method that wraps the next filter/controller.\n   *\n   * @param meta - Metadata about the method being invoked\n   * @param nextFilter - Next filter/controller as a Service\n   * @returns Promise of the response\n   */\n  abstract filter(\n    meta: REQ,\n    nextFilter: Service<REQ, RESP>\n  ): Promise<RESP>;\n\n  /**\n   * Chain this filter with another filter.\n   * Returns a new Filter that composes both filters.\n   *\n   * Similar to Java: filter1.chain(filter2)\n   *\n   * @param nextFilter - The filter to execute after this one\n   * @returns Composed filter\n   */\n  chain(nextFilter: Filter<REQ, RESP>): Filter<REQ, RESP> {\n    const self = this;\n\n    return new class extends Filter<REQ, RESP> {\n      async filter(\n        meta: REQ,\n        nextService: Service<REQ, RESP>\n      ): Promise<RESP> {\n        // Call outer filter, passing next filter wrapped as a Service\n        return self.filter(meta, {\n          invoke: (m: REQ) => nextFilter.filter(m, nextService)\n        });\n      }\n    };\n  }\n\n  /**\n   * Chain this filter with a final service (controller).\n   * Returns a Service that can be invoked.\n   *\n   * Similar to Java: filter.chain(service)\n   *\n   * @param svc - The final service (controller) to execute\n   * @returns Service wrapping the entire filter chain\n   */\n  chainService(svc: Service<REQ, RESP>): Service<REQ, RESP> {\n    const self = this;\n\n    return {\n      invoke: (meta: REQ) => self.filter(meta, svc)\n    };\n  }\n}\n"]}

package/src/FilterChain.d.ts

@@ -1,28 +1,28 @@
-import { Filter, MethodMeta, Action } from './Filter';
+import { Filter } from './Filter';
 /**
  * FilterChain - Manages execution of filters in priority order.
  * Similar to Java servlet filter chains.
  *
  * Filters are sorted by priority (highest first) and each filter
- * calls next() to invoke the next filter in the chain.
+ * calls nextFilter.invoke() to invoke the next filter in the chain.
  *
  * The final "filter" in the chain is the controller method itself.
  */
-export declare class FilterChain {
+export declare class FilterChain<REQ, RESP> {
     private filters;
-    constructor(filters: Filter[]);
+    constructor(filters: Filter<REQ, RESP>[]);
     /**
      * Execute the filter chain.
      *
-     * @param meta - Method metadata
+     * @param meta - Request metadata
      * @param finalHandler - The controller method to execute at the end
-     * @returns Promise of the action
+     * @returns Promise of the response
      */
-    execute(meta: MethodMeta, finalHandler: () => Promise<Action>): Promise<Action>;
+    execute(meta: REQ, finalHandler: () => Promise<RESP>): Promise<RESP>;
     /**
      * Get all filters in the chain (sorted by priority).
      */
-    getFilters(): Filter[];
+    getFilters(): Filter<REQ, RESP>[];
     /**
      * Get the number of filters in the chain.
      */

package/src/FilterChain.js

@@ -1,44 +1,49 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilterChain = void 0;
-const Filter_1 = require("./Filter");
 /**
  * FilterChain - Manages execution of filters in priority order.
  * Similar to Java servlet filter chains.
  *
  * Filters are sorted by priority (highest first) and each filter
- * calls next() to invoke the next filter in the chain.
+ * calls nextFilter.invoke() to invoke the next filter in the chain.
  *
  * The final "filter" in the chain is the controller method itself.
  */
 class FilterChain {
     constructor(filters) {
-        // Sort filters by priority (highest first)
-        this.filters = [...filters].sort((a, b) => b.priority - a.priority);
+        // Filters are already sorted by priority from FilterMatcher
+        // No need to sort again (priority is in FilterDefinition, not Filter)
+        this.filters = filters;
     }
     /**
      * Execute the filter chain.
      *
-     * @param meta - Method metadata
+     * @param meta - Request metadata
      * @param finalHandler - The controller method to execute at the end
-     * @returns Promise of the action
+     * @returns Promise of the response
      */
     async execute(meta, finalHandler) {
-        let index = 0;
         const filters = this.filters;
-        const next = new class extends Filter_1.NextFilter {
-            async execute() {
-                if (index < filters.length) {
-                    const filter = filters[index++];
-                    return filter.filter(meta, next);
+        // Create Service adapter that recursively calls filters
+        const createServiceForIndex = (currentIndex) => {
+            return {
+                invoke: async (m) => {
+                    if (currentIndex < filters.length) {
+                        const filter = filters[currentIndex];
+                        const nextService = createServiceForIndex(currentIndex + 1);
+                        return filter.filter(m, nextService);
+                    }
+                    else {
+                        // All filters executed, now execute the controller
+                        return finalHandler();
+                    }
                 }
-                else {
-                    // All filters have been executed, now execute the controller
-                    return finalHandler();
-                }
-            }
+            };
         };
-        return next.execute();
+        // Start execution with first filter
+        const service = createServiceForIndex(0);
+        return service.invoke(meta);
     }
     /**
      * Get all filters in the chain (sorted by priority).

package/src/FilterChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterChain.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/FilterChain.ts"],"names":[],"mappings":";;;AAAA,qCAAkE;AAElE;;;;;;;;GAQG;AACH,MAAa,WAAW;IAGtB,YAAY,OAAiB;QAC3B,2CAA2C;QAC3C,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CACX,IAAgB,EAChB,YAAmC;QAEnC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,MAAM,IAAI,GAAe,IAAI,KAAM,SAAQ,mBAAU;YACnD,KAAK,CAAC,OAAO;gBACX,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;oBAChC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,6DAA6D;oBAC7D,OAAO,YAAY,EAAE,CAAC;gBACxB,CAAC;YACH,CAAC;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF;AAlDD,kCAkDC","sourcesContent":["import { Filter, MethodMeta, Action, NextFilter } from './Filter';\n\n/**\n * FilterChain - Manages execution of filters in priority order.\n * Similar to Java servlet filter chains.\n *\n * Filters are sorted by priority (highest first) and each filter\n * calls next() to invoke the next filter in the chain.\n *\n * The final \"filter\" in the chain is the controller method itself.\n */\nexport class FilterChain {\n  private filters: Filter[];\n\n  constructor(filters: Filter[]) {\n    // Sort filters by priority (highest first)\n    this.filters = [...filters].sort((a, b) => b.priority - a.priority);\n  }\n\n  /**\n   * Execute the filter chain.\n   *\n   * @param meta - Method metadata\n   * @param finalHandler - The controller method to execute at the end\n   * @returns Promise of the action\n   */\n  async execute(\n    meta: MethodMeta,\n    finalHandler: () => Promise<Action>\n  ): Promise<Action> {\n    let index = 0;\n    const filters = this.filters;\n\n    const next: NextFilter = new class extends NextFilter {\n      async execute(): Promise<Action> {\n        if (index < filters.length) {\n          const filter = filters[index++];\n          return filter.filter(meta, next);\n        } else {\n          // All filters have been executed, now execute the controller\n          return finalHandler();\n        }\n      }\n    };\n\n    return next.execute();\n  }\n\n  /**\n   * Get all filters in the chain (sorted by priority).\n   */\n  getFilters(): Filter[] {\n    return [...this.filters];\n  }\n\n  /**\n   * Get the number of filters in the chain.\n   */\n  size(): number {\n    return this.filters.length;\n  }\n}\n"]}
+{"version":3,"file":"FilterChain.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/FilterChain.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACH,MAAa,WAAW;IAGtB,YAAY,OAA4B;QACtC,4DAA4D;QAC5D,sEAAsE;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CACX,IAAS,EACT,YAAiC;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,wDAAwD;QACxD,MAAM,qBAAqB,GAAG,CAAC,YAAoB,EAAsB,EAAE;YACzE,OAAO;gBACL,MAAM,EAAE,KAAK,EAAE,CAAM,EAAiB,EAAE;oBACtC,IAAI,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;wBAClC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;wBACrC,MAAM,WAAW,GAAG,qBAAqB,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;wBAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;oBACvC,CAAC;yBAAM,CAAC;wBACN,mDAAmD;wBACnD,OAAO,YAAY,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC,CAAC;QAEF,oCAAoC;QACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF;AAxDD,kCAwDC","sourcesContent":["import { Filter, Service } from './Filter';\n\n/**\n * FilterChain - Manages execution of filters in priority order.\n * Similar to Java servlet filter chains.\n *\n * Filters are sorted by priority (highest first) and each filter\n * calls nextFilter.invoke() to invoke the next filter in the chain.\n *\n * The final \"filter\" in the chain is the controller method itself.\n */\nexport class FilterChain<REQ, RESP> {\n  private filters: Filter<REQ, RESP>[];\n\n  constructor(filters: Filter<REQ, RESP>[]) {\n    // Filters are already sorted by priority from FilterMatcher\n    // No need to sort again (priority is in FilterDefinition, not Filter)\n    this.filters = filters;\n  }\n\n  /**\n   * Execute the filter chain.\n   *\n   * @param meta - Request metadata\n   * @param finalHandler - The controller method to execute at the end\n   * @returns Promise of the response\n   */\n  async execute(\n    meta: REQ,\n    finalHandler: () => Promise<RESP>\n  ): Promise<RESP> {\n    const filters = this.filters;\n\n    // Create Service adapter that recursively calls filters\n    const createServiceForIndex = (currentIndex: number): Service<REQ, RESP> => {\n      return {\n        invoke: async (m: REQ): Promise<RESP> => {\n          if (currentIndex < filters.length) {\n            const filter = filters[currentIndex];\n            const nextService = createServiceForIndex(currentIndex + 1);\n            return filter.filter(m, nextService);\n          } else {\n            // All filters executed, now execute the controller\n            return finalHandler();\n          }\n        }\n      };\n    };\n\n    // Start execution with first filter\n    const service = createServiceForIndex(0);\n    return service.invoke(meta);\n  }\n\n  /**\n   * Get all filters in the chain (sorted by priority).\n   */\n  getFilters(): Filter<REQ, RESP>[] {\n    return [...this.filters];\n  }\n\n  /**\n   * Get the number of filters in the chain.\n   */\n  size(): number {\n    return this.filters.length;\n  }\n}\n"]}

package/src/index.d.ts

@@ -1,4 +1,2 @@
-export { Filter, MethodMeta, Action, NextFilter, jsonAction, errorAction, } from './Filter';
+export { Filter, WpResponse, Service, } from './Filter';
 export { FilterChain } from './FilterChain';
-export { ContextFilter } from './filters/ContextFilter';
-export { JsonFilter, JsonFilterConfig, FILTER_TYPES, ValidationException, HttpException, } from './filters/JsonFilter';

package/src/index.js

@@ -1,20 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpException = exports.ValidationException = exports.FILTER_TYPES = exports.JsonFilterConfig = exports.JsonFilter = exports.ContextFilter = exports.FilterChain = exports.errorAction = exports.jsonAction = exports.NextFilter = exports.Action = exports.MethodMeta = void 0;
+exports.FilterChain = exports.WpResponse = exports.Filter = void 0;
 var Filter_1 = require("./Filter");
-Object.defineProperty(exports, "MethodMeta", { enumerable: true, get: function () { return Filter_1.MethodMeta; } });
-Object.defineProperty(exports, "Action", { enumerable: true, get: function () { return Filter_1.Action; } });
-Object.defineProperty(exports, "NextFilter", { enumerable: true, get: function () { return Filter_1.NextFilter; } });
-Object.defineProperty(exports, "jsonAction", { enumerable: true, get: function () { return Filter_1.jsonAction; } });
-Object.defineProperty(exports, "errorAction", { enumerable: true, get: function () { return Filter_1.errorAction; } });
+Object.defineProperty(exports, "Filter", { enumerable: true, get: function () { return Filter_1.Filter; } });
+Object.defineProperty(exports, "WpResponse", { enumerable: true, get: function () { return Filter_1.WpResponse; } });
 var FilterChain_1 = require("./FilterChain");
 Object.defineProperty(exports, "FilterChain", { enumerable: true, get: function () { return FilterChain_1.FilterChain; } });
-var ContextFilter_1 = require("./filters/ContextFilter");
-Object.defineProperty(exports, "ContextFilter", { enumerable: true, get: function () { return ContextFilter_1.ContextFilter; } });
-var JsonFilter_1 = require("./filters/JsonFilter");
-Object.defineProperty(exports, "JsonFilter", { enumerable: true, get: function () { return JsonFilter_1.JsonFilter; } });
-Object.defineProperty(exports, "JsonFilterConfig", { enumerable: true, get: function () { return JsonFilter_1.JsonFilterConfig; } });
-Object.defineProperty(exports, "FILTER_TYPES", { enumerable: true, get: function () { return JsonFilter_1.FILTER_TYPES; } });
-Object.defineProperty(exports, "ValidationException", { enumerable: true, get: function () { return JsonFilter_1.ValidationException; } });
-Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return JsonFilter_1.HttpException; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/index.ts"],"names":[],"mappings":";;;AAAA,mCAOkB;AALhB,oGAAA,UAAU,OAAA;AACV,gGAAA,MAAM,OAAA;AACN,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AACV,qGAAA,WAAW,OAAA;AAGb,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAEpB,yDAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,mDAM8B;AAL5B,wGAAA,UAAU,OAAA;AACV,8GAAA,gBAAgB,OAAA;AAChB,0GAAA,YAAY,OAAA;AACZ,iHAAA,mBAAmB,OAAA;AACnB,2GAAA,aAAa,OAAA","sourcesContent":["export {\n  Filter,\n  MethodMeta,\n  Action,\n  NextFilter,\n  jsonAction,\n  errorAction,\n} from './Filter';\n\nexport { FilterChain } from './FilterChain';\n\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-filters/src/index.ts"],"names":[],"mappings":";;;AAAA,mCAIkB;AAHhB,gGAAA,MAAM,OAAA;AACN,oGAAA,UAAU,OAAA;AAIZ,6CAA4C;AAAnC,0GAAA,WAAW,OAAA","sourcesContent":["export {\n  Filter,\n  WpResponse,\n  Service,\n} from './Filter';\n\nexport { FilterChain } from './FilterChain';\n"]}

package/src/filters/ContextFilter.d.ts

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

package/src/filters/ContextFilter.js

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

package/src/filters/ContextFilter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContextFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-filters/src/filters/ContextFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0DAA2D;AAC3D,0DAAyD;AAGzD;;;;;;GAMG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAa;IAAnB;QACL,aAAQ,GAAG,GAAG,CAAC;IAcjB,CAAC;IAZC,KAAK,CAAC,MAAM,CAAC,IAAgB,EAAE,IAAgB;QAC7C,wDAAwD;QACxD,OAAO,6BAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACnC,gEAAgE;YAChE,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACxC,6BAAc,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,6BAAc,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAEnD,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,2CAA2C;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAfY,sCAAa;wBAAb,aAAa;IAFzB,IAAA,+BAAgB,GAAE;IAClB,IAAA,sBAAU,GAAE;GACA,aAAa,CAezB","sourcesContent":["import { injectable } from 'inversify';\nimport { provideSingleton } from '@webpieces/http-routing';\nimport { RequestContext } from '@webpieces/core-context';\nimport { Filter, MethodMeta, Action, NextFilter } from '../Filter';\n\n/**\n * ContextFilter - Sets up AsyncLocalStorage context for each request.\n * Priority: 140 (executes first)\n *\n * This filter ensures that all subsequent filters and the controller\n * execute within a context that can store request-scoped data.\n */\n@provideSingleton()\n@injectable()\nexport class ContextFilter implements Filter {\n  priority = 140;\n\n  async filter(meta: MethodMeta, next: NextFilter): Promise<Action> {\n    // Run the rest of the filter chain within a new context\n    return RequestContext.run(async () => {\n      // Store request metadata in context for other filters to access\n      RequestContext.put('METHOD_META', meta);\n      RequestContext.put('REQUEST_PATH', meta.path);\n      RequestContext.put('HTTP_METHOD', meta.httpMethod);\n\n      return await next.execute();\n      //RequestContext is auto cleared when done.\n    });\n  }\n}\n"]}

package/src/filters/JsonFilter.d.ts

@@ -1,95 +0,0 @@
-import { Filter, MethodMeta, Action, NextFilter } from '../Filter';
-/**
- * DI tokens for http-filters.
- */
-export declare const FILTER_TYPES: {
-    JsonFilterConfig: symbol;
-};
-/**
- * Configuration for JsonFilter.
- * Register this in your DI container to customize JsonFilter behavior.
- *
- * Example:
- * ```typescript
- * export const MyModule = new ContainerModule((bind) => {
- *   bind(FILTER_TYPES.JsonFilterConfig).toConstantValue(
- *     new JsonFilterConfig(true, true) // validation enabled, logging enabled
- *   );
- * });
- * ```
- */
-export declare class JsonFilterConfig {
-    /**
-     * Whether to enable validation using class-validator.
-     * Default: true
-     */
-    validationEnabled: boolean;
-    /**
-     * Whether to log requests and responses.
-     * Default: false
-     */
-    loggingEnabled: boolean;
-    constructor(validationEnabled?: boolean, loggingEnabled?: boolean);
-}
-/**
- * JsonFilter - Handles JSON deserialization and serialization.
- * Priority: 60
- *
- * Similar to Java WebPieces JacksonCatchAllFilter.
- *
- * Responsibilities:
- * 1. Deserialize request body to DTO (if request has body)
- * 2. Validate DTO using class-validator (if enabled)
- * 3. Execute next filter/controller
- * 4. Serialize response to JSON
- * 5. Handle errors and translate to JSON error responses
- *
- * Configuration:
- * JsonFilter uses constructor injection to receive JsonFilterConfig.
- * The default config has validation enabled and logging disabled.
- * To customize, bind JsonFilterConfig in your DI module.
- */
-export declare class JsonFilter implements Filter {
-    private config;
-    priority: number;
-    constructor(config: JsonFilterConfig);
-    filter(meta: MethodMeta, next: NextFilter): Promise<Action>;
-    /**
-     * Process the request: deserialize and validate.
-     */
-    private processRequest;
-    /**
-     * Validate a DTO using class-validator.
-     */
-    private validateDto;
-    /**
-     * Format validation errors into a readable format.
-     */
-    private formatValidationErrors;
-    /**
-     * Handle errors and translate to JSON error responses.
-     */
-    private handleError;
-    /**
-     * Log the incoming request.
-     */
-    private logRequest;
-    /**
-     * Log the outgoing response.
-     */
-    private logResponse;
-}
-/**
- * Exception thrown when validation fails.
- */
-export declare class ValidationException extends Error {
-    violations: string[];
-    constructor(violations: string[]);
-}
-/**
- * HTTP exception with status code.
- */
-export declare class HttpException extends Error {
-    statusCode: number;
-    constructor(message: string, statusCode: number);
-}

package/src/filters/JsonFilter.js

@@ -1,202 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpException = exports.ValidationException = exports.JsonFilter = exports.JsonFilterConfig = exports.FILTER_TYPES = void 0;
-const tslib_1 = require("tslib");
-const inversify_1 = require("inversify");
-const http_routing_1 = require("@webpieces/http-routing");
-const class_validator_1 = require("class-validator");
-const Filter_1 = require("../Filter");
-const core_util_1 = require("@webpieces/core-util");
-/**
- * DI tokens for http-filters.
- */
-exports.FILTER_TYPES = {
-    JsonFilterConfig: Symbol.for('JsonFilterConfig'),
-};
-/**
- * Configuration for JsonFilter.
- * Register this in your DI container to customize JsonFilter behavior.
- *
- * Example:
- * ```typescript
- * export const MyModule = new ContainerModule((bind) => {
- *   bind(FILTER_TYPES.JsonFilterConfig).toConstantValue(
- *     new JsonFilterConfig(true, true) // validation enabled, logging enabled
- *   );
- * });
- * ```
- */
-let JsonFilterConfig = class JsonFilterConfig {
-    constructor(validationEnabled = true, loggingEnabled = false) {
-        this.validationEnabled = validationEnabled;
-        this.loggingEnabled = loggingEnabled;
-    }
-};
-exports.JsonFilterConfig = JsonFilterConfig;
-exports.JsonFilterConfig = JsonFilterConfig = tslib_1.__decorate([
-    (0, inversify_1.injectable)(),
-    tslib_1.__metadata("design:paramtypes", [Boolean, Boolean])
-], JsonFilterConfig);
-/**
- * JsonFilter - Handles JSON deserialization and serialization.
- * Priority: 60
- *
- * Similar to Java WebPieces JacksonCatchAllFilter.
- *
- * Responsibilities:
- * 1. Deserialize request body to DTO (if request has body)
- * 2. Validate DTO using class-validator (if enabled)
- * 3. Execute next filter/controller
- * 4. Serialize response to JSON
- * 5. Handle errors and translate to JSON error responses
- *
- * Configuration:
- * JsonFilter uses constructor injection to receive JsonFilterConfig.
- * The default config has validation enabled and logging disabled.
- * To customize, bind JsonFilterConfig in your DI module.
- */
-let JsonFilter = class JsonFilter {
-    constructor(config) {
-        this.config = config;
-        this.priority = 60;
-        // Config is injected from DI container
-    }
-    async filter(meta, next) {
-        try {
-            // Deserialize and validate request if there's a body
-            await this.processRequest(meta);
-            if (this.config.loggingEnabled) {
-                this.logRequest(meta);
-            }
-            // Execute next filter/controller
-            const action = await next.execute();
-            if (this.config.loggingEnabled) {
-                this.logResponse(action);
-            }
-            // Ensure response is JSON
-            if (action.type !== 'json' && action.type !== 'error') {
-                return (0, Filter_1.jsonAction)(action.data);
-            }
-            return action;
-        }
-        catch (err) {
-            const error = (0, core_util_1.toError)(err);
-            // Translate error to JSON response
-            return this.handleError(error, meta);
-        }
-    }
-    /**
-     * Process the request: deserialize and validate.
-     */
-    async processRequest(meta) {
-        // If there's request data and a parameter type, deserialize it
-        if (meta.request?.body && meta.params.length === 0) {
-            const body = meta.request.body;
-            // For now, we'll just pass the body as-is
-            // In a real implementation, we'd use the parameter type from decorators
-            // to properly deserialize and validate
-            // If we have type information, we can do proper transformation
-            // For this MVP, we'll store the body in params[0]
-            meta.params[0] = body;
-            // If validation is enabled and we have a class instance, validate it
-            if (this.config.validationEnabled && body.constructor !== Object) {
-                await this.validateDto(body);
-            }
-        }
-    }
-    /**
-     * Validate a DTO using class-validator.
-     */
-    async validateDto(dto) {
-        const errors = await (0, class_validator_1.validate)(dto);
-        if (errors.length > 0) {
-            const messages = this.formatValidationErrors(errors);
-            throw new ValidationException(messages);
-        }
-    }
-    /**
-     * Format validation errors into a readable format.
-     */
-    formatValidationErrors(errors) {
-        const messages = [];
-        for (const error of errors) {
-            if (error.constraints) {
-                const constraints = Object.values(error.constraints);
-                messages.push(...constraints);
-            }
-            if (error.children && error.children.length > 0) {
-                const childMessages = this.formatValidationErrors(error.children);
-                messages.push(...childMessages);
-            }
-        }
-        return messages;
-    }
-    /**
-     * Handle errors and translate to JSON error responses.
-     */
-    handleError(error, meta) {
-        if (error instanceof ValidationException) {
-            return (0, Filter_1.errorAction)({
-                error: 'Validation failed',
-                violations: error.violations,
-            }, 400);
-        }
-        if (error instanceof HttpException) {
-            return (0, Filter_1.errorAction)({
-                error: error.message,
-                code: error.statusCode,
-            }, error.statusCode);
-        }
-        // Log unexpected errors
-        console.error('Unexpected error in filter chain:', error);
-        return (0, Filter_1.errorAction)('Internal server error', 500);
-    }
-    /**
-     * Log the incoming request.
-     */
-    logRequest(meta) {
-        console.log(`[JsonFilter] ${meta.httpMethod} ${meta.path}`);
-        if (meta.params.length > 0) {
-            console.log('[JsonFilter] Request body:', JSON.stringify(meta.params[0], null, 2));
-        }
-    }
-    /**
-     * Log the outgoing response.
-     */
-    logResponse(action) {
-        console.log(`[JsonFilter] Response: ${action.statusCode}`);
-        if (action.data) {
-            console.log('[JsonFilter] Response body:', JSON.stringify(action.data, null, 2));
-        }
-    }
-};
-exports.JsonFilter = JsonFilter;
-exports.JsonFilter = JsonFilter = tslib_1.__decorate([
-    (0, http_routing_1.provideSingleton)(),
-    (0, inversify_1.injectable)(),
-    tslib_1.__param(0, (0, inversify_1.inject)(exports.FILTER_TYPES.JsonFilterConfig)),
-    tslib_1.__metadata("design:paramtypes", [JsonFilterConfig])
-], JsonFilter);
-/**
- * Exception thrown when validation fails.
- */
-class ValidationException extends Error {
-    constructor(violations) {
-        super('Validation failed');
-        this.violations = violations;
-        this.name = 'ValidationException';
-    }
-}
-exports.ValidationException = ValidationException;
-/**
- * HTTP exception with status code.
- */
-class HttpException extends Error {
-    constructor(message, statusCode) {
-        super(message);
-        this.statusCode = statusCode;
-        this.name = 'HttpException';
-    }
-}
-exports.HttpException = HttpException;
-//# sourceMappingURL=JsonFilter.js.map

package/src/filters/JsonFilter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JsonFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-filters/src/filters/JsonFilter.ts"],"names":[],"mappings":"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","sourcesContent":["import { injectable, inject } from 'inversify';\nimport { provideSingleton } from '@webpieces/http-routing';\nimport { plainToInstance } from 'class-transformer';\nimport { validate, ValidationError } from 'class-validator';\nimport { Filter, MethodMeta, Action, NextFilter, jsonAction, errorAction } from '../Filter';\nimport { RequestContext } from '@webpieces/core-context';\nimport { toError } from '@webpieces/core-util';\n\n/**\n * DI tokens for http-filters.\n */\nexport const FILTER_TYPES = {\n  JsonFilterConfig: Symbol.for('JsonFilterConfig'),\n};\n\n/**\n * Configuration for JsonFilter.\n * Register this in your DI container to customize JsonFilter behavior.\n *\n * Example:\n * ```typescript\n * export const MyModule = new ContainerModule((bind) => {\n *   bind(FILTER_TYPES.JsonFilterConfig).toConstantValue(\n *     new JsonFilterConfig(true, true) // validation enabled, logging enabled\n *   );\n * });\n * ```\n */\n@injectable()\nexport class JsonFilterConfig {\n  /**\n   * Whether to enable validation using class-validator.\n   * Default: true\n   */\n  validationEnabled: boolean;\n\n  /**\n   * Whether to log requests and responses.\n   * Default: false\n   */\n  loggingEnabled: boolean;\n\n  constructor(\n    validationEnabled: boolean = true,\n    loggingEnabled: boolean = false\n  ) {\n    this.validationEnabled = validationEnabled;\n    this.loggingEnabled = loggingEnabled;\n  }\n}\n\n/**\n * JsonFilter - Handles JSON deserialization and serialization.\n * Priority: 60\n *\n * Similar to Java WebPieces JacksonCatchAllFilter.\n *\n * Responsibilities:\n * 1. Deserialize request body to DTO (if request has body)\n * 2. Validate DTO using class-validator (if enabled)\n * 3. Execute next filter/controller\n * 4. Serialize response to JSON\n * 5. Handle errors and translate to JSON error responses\n *\n * Configuration:\n * JsonFilter uses constructor injection to receive JsonFilterConfig.\n * The default config has validation enabled and logging disabled.\n * To customize, bind JsonFilterConfig in your DI module.\n */\n@provideSingleton()\n@injectable()\nexport class JsonFilter implements Filter {\n  priority = 60;\n\n  constructor(@inject(FILTER_TYPES.JsonFilterConfig) private config: JsonFilterConfig) {\n    // Config is injected from DI container\n  }\n\n  async filter(meta: MethodMeta, next: NextFilter): Promise<Action> {\n    try {\n      // Deserialize and validate request if there's a body\n      await this.processRequest(meta);\n\n      if (this.config.loggingEnabled) {\n        this.logRequest(meta);\n      }\n\n      // Execute next filter/controller\n      const action = await next.execute();\n\n      if (this.config.loggingEnabled) {\n        this.logResponse(action);\n      }\n\n      // Ensure response is JSON\n      if (action.type !== 'json' && action.type !== 'error') {\n        return jsonAction(action.data);\n      }\n\n      return action;\n    } catch (err: any) {\n      const error = toError(err);\n      // Translate error to JSON response\n      return this.handleError(error, meta);\n    }\n  }\n\n  /**\n   * Process the request: deserialize and validate.\n   */\n  private async processRequest(meta: MethodMeta): Promise<void> {\n    // If there's request data and a parameter type, deserialize it\n    if (meta.request?.body && meta.params.length === 0) {\n      const body = meta.request.body;\n\n      // For now, we'll just pass the body as-is\n      // In a real implementation, we'd use the parameter type from decorators\n      // to properly deserialize and validate\n\n      // If we have type information, we can do proper transformation\n      // For this MVP, we'll store the body in params[0]\n      meta.params[0] = body;\n\n      // If validation is enabled and we have a class instance, validate it\n      if (this.config.validationEnabled && body.constructor !== Object) {\n        await this.validateDto(body);\n      }\n    }\n  }\n\n  /**\n   * Validate a DTO using class-validator.\n   */\n  private async validateDto(dto: any): Promise<void> {\n    const errors = await validate(dto);\n\n    if (errors.length > 0) {\n      const messages = this.formatValidationErrors(errors);\n      throw new ValidationException(messages);\n    }\n  }\n\n  /**\n   * Format validation errors into a readable format.\n   */\n  private formatValidationErrors(errors: ValidationError[]): string[] {\n    const messages: string[] = [];\n\n    for (const error of errors) {\n      if (error.constraints) {\n        const constraints = Object.values(error.constraints);\n        messages.push(...constraints);\n      }\n\n      if (error.children && error.children.length > 0) {\n        const childMessages = this.formatValidationErrors(error.children);\n        messages.push(...childMessages);\n      }\n    }\n\n    return messages;\n  }\n\n  /**\n   * Handle errors and translate to JSON error responses.\n   */\n  private handleError(error: any, meta: MethodMeta): Action {\n    if (error instanceof ValidationException) {\n      return errorAction(\n        {\n          error: 'Validation failed',\n          violations: error.violations,\n        } as any,\n        400\n      );\n    }\n\n    if (error instanceof HttpException) {\n      return errorAction(\n        {\n          error: error.message,\n          code: error.statusCode,\n        } as any,\n        error.statusCode\n      );\n    }\n\n    // Log unexpected errors\n    console.error('Unexpected error in filter chain:', error);\n\n    return errorAction(\n      'Internal server error',\n      500\n    );\n  }\n\n  /**\n   * Log the incoming request.\n   */\n  private logRequest(meta: MethodMeta): void {\n    console.log(`[JsonFilter] ${meta.httpMethod} ${meta.path}`);\n    if (meta.params.length > 0) {\n      console.log('[JsonFilter] Request body:', JSON.stringify(meta.params[0], null, 2));\n    }\n  }\n\n  /**\n   * Log the outgoing response.\n   */\n  private logResponse(action: Action): void {\n    console.log(`[JsonFilter] Response: ${action.statusCode}`);\n    if (action.data) {\n      console.log('[JsonFilter] Response body:', JSON.stringify(action.data, null, 2));\n    }\n  }\n}\n\n/**\n * Exception thrown when validation fails.\n */\nexport class ValidationException extends Error {\n  constructor(public violations: string[]) {\n    super('Validation failed');\n    this.name = 'ValidationException';\n  }\n}\n\n/**\n * HTTP exception with status code.\n */\nexport class HttpException extends Error {\n  constructor(message: string, public statusCode: number) {\n    super(message);\n    this.name = 'HttpException';\n  }\n}\n"]}