@webpieces/http-filters 0.2.9 → 0.2.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/http-filters",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "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.9"
+    "@webpieces/core-context": "0.2.11"
   }
 }

package/src/Filter.d.ts

@@ -2,7 +2,7 @@
  * Metadata about the method being invoked.
  * Passed to filters and contains request information.
  */
-export interface MethodMeta {
+export declare class MethodMeta {
     /**
      * The HTTP method (GET, POST, etc.)
      */
@@ -32,16 +32,18 @@ export interface MethodMeta {
      * 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 interface Action {
+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>);
 }
 /**
  * Next filter class.

package/src/Filter.js

@@ -1,8 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NextFilter = void 0;
+exports.NextFilter = exports.Action = exports.MethodMeta = void 0;
 exports.jsonAction = jsonAction;
 exports.errorAction = errorAction;
+/**
+ * Metadata about the method being invoked.
+ * Passed to filters and contains request information.
+ */
+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;
+        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;
+    }
+}
+exports.Action = Action;
 /**
  * Next filter class.
  * This is a class instead of a function type to make it easier to trace
@@ -15,22 +44,14 @@ exports.NextFilter = NextFilter;
  * Helper to create a JSON action response.
  */
 function jsonAction(data, statusCode = 200) {
-    return {
-        type: 'json',
-        data,
-        statusCode,
-    };
+    return new Action('json', data, statusCode);
 }
 /**
  * Helper to create an error action response.
  */
 function errorAction(error, statusCode = 500) {
-    return {
-        type: 'error',
-        data: {
-            error: typeof error === 'string' ? error : error.message,
-        },
-        statusCode,
-    };
+    return new Action('error', {
+        error: typeof error === 'string' ? error : error.message,
+    }, statusCode);
 }
 //# 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":";;;AAoHA,gCAMC;AAKD,kCAWC;AArFD;;;;GAIG;AACH,MAAsB,UAAU;CAM/B;AAND,gCAMC;AAiDD;;GAEG;AACH,SAAgB,UAAU,CAAC,IAAS,EAAE,aAAqB,GAAG;IAC5D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,KAAqB,EACrB,aAAqB,GAAG;IAExB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;SACzD;QACD,UAAU;KACX,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Metadata about the method being invoked.\n * Passed to filters and contains request information.\n */\nexport interface 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\n/**\n * Action returned by filters and controllers.\n * Can represent different types of responses.\n */\nexport interface Action {\n  type: 'json' | 'html' | 'redirect' | 'error';\n  data?: any;\n  statusCode?: number;\n  headers?: Record<string, string>;\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 {\n    type: 'json',\n    data,\n    statusCode,\n  };\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 {\n    type: 'error',\n    data: {\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":";;;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"]}

package/src/filters/ContextFilter.js

@@ -3,6 +3,7 @@ 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.
@@ -17,24 +18,19 @@ let ContextFilter = class ContextFilter {
     }
     async filter(meta, next) {
         // Run the rest of the filter chain within a new context
-        return core_context_1.Context.run(async () => {
+        return core_context_1.RequestContext.run(async () => {
             // Store request metadata in context for other filters to access
-            core_context_1.Context.put('METHOD_META', meta);
-            core_context_1.Context.put('REQUEST_PATH', meta.path);
-            core_context_1.Context.put('HTTP_METHOD', meta.httpMethod);
-            try {
-                return await next.execute();
-            }
-            finally {
-                // Clean up context (AsyncLocalStorage handles this automatically,
-                // but we can explicitly clear if needed)
-                core_context_1.Context.clear();
-            }
+            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 +1 @@
-{"version":3,"file":"ContextFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-filters/src/filters/ContextFilter.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0DAAkD;AAGlD;;;;;;GAMG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IAAnB;QACL,aAAQ,GAAG,GAAG,CAAC;IAmBjB,CAAC;IAjBC,KAAK,CAAC,MAAM,CAAC,IAAgB,EAAE,IAAgB;QAC7C,wDAAwD;QACxD,OAAO,sBAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,gEAAgE;YAChE,sBAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACjC,sBAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,sBAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,CAAC;oBAAS,CAAC;gBACT,kEAAkE;gBAClE,yCAAyC;gBACzC,sBAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AApBY,sCAAa;wBAAb,aAAa;IADzB,IAAA,sBAAU,GAAE;GACA,aAAa,CAoBzB","sourcesContent":["import { injectable } from 'inversify';\nimport { Context } 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@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 Context.run(async () => {\n      // Store request metadata in context for other filters to access\n      Context.put('METHOD_META', meta);\n      Context.put('REQUEST_PATH', meta.path);\n      Context.put('HTTP_METHOD', meta.httpMethod);\n\n      try {\n        return await next.execute();\n      } finally {\n        // Clean up context (AsyncLocalStorage handles this automatically,\n        // but we can explicitly clear if needed)\n        Context.clear();\n      }\n    });\n  }\n}\n"]}
+{"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;YAEjD,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,2CAA2C;QAC/C,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,18 +1,35 @@
 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 interface JsonFilterConfig {
+export declare class JsonFilterConfig {
     /**
      * Whether to enable validation using class-validator.
      * Default: true
      */
-    validationEnabled?: boolean;
+    validationEnabled: boolean;
     /**
      * Whether to log requests and responses.
      * Default: false
      */
-    loggingEnabled?: boolean;
+    loggingEnabled: boolean;
+    constructor(validationEnabled?: boolean, loggingEnabled?: boolean);
 }
 /**
  * JsonFilter - Handles JSON deserialization and serialization.
@@ -26,11 +43,16 @@ export interface JsonFilterConfig {
  * 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);
+    constructor(config: JsonFilterConfig);
     filter(meta: MethodMeta, next: NextFilter): Promise<Action>;
     /**
      * Process the request: deserialize and validate.

package/src/filters/JsonFilter.js

@@ -1,10 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpException = exports.ValidationException = exports.JsonFilter = void 0;
+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");
+/**
+ * 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
@@ -17,16 +48,17 @@ const Filter_1 = require("../Filter");
  * 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 = {}) {
+    constructor(config) {
         this.config = config;
         this.priority = 60;
-        this.config = {
-            validationEnabled: true,
-            loggingEnabled: false,
-            ...config,
-        };
+        // Config is injected from DI container
     }
     async filter(meta, next) {
         try {
@@ -138,9 +170,10 @@ let JsonFilter = class JsonFilter {
 };
 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.unmanaged)()),
-    tslib_1.__metadata("design:paramtypes", [Object])
+    tslib_1.__param(0, (0, inversify_1.inject)(exports.FILTER_TYPES.JsonFilterConfig)),
+    tslib_1.__metadata("design:paramtypes", [JsonFilterConfig])
 ], JsonFilter);
 /**
  * Exception thrown when validation fails.

package/src/filters/JsonFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonFilter.js","sourceRoot":"","sources":["../../../../../../packages/http/http-filters/src/filters/JsonFilter.ts"],"names":[],"mappings":"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","sourcesContent":["import { injectable, unmanaged } from 'inversify';\nimport { plainToInstance } from 'class-transformer';\nimport { validate, ValidationError } from 'class-validator';\nimport { Filter, MethodMeta, Action, NextFilter, jsonAction, errorAction } from '../Filter';\nimport { Context } from '@webpieces/core-context';\n\n/**\n * Configuration for JsonFilter.\n */\nexport interface 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\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@injectable()\nexport class JsonFilter implements Filter {\n  priority = 60;\n\n  constructor(@unmanaged() private config: JsonFilterConfig = {}) {\n    this.config = {\n      validationEnabled: true,\n      loggingEnabled: false,\n      ...config,\n    };\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 (error) {\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"]}
+{"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';\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 (error) {\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"]}

package/src/index.d.ts

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

package/src/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpException = exports.ValidationException = exports.JsonFilter = exports.ContextFilter = exports.FilterChain = exports.errorAction = exports.jsonAction = exports.NextFilter = void 0;
+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;
 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; } });
@@ -11,6 +13,8 @@ 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;AAHhB,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,mDAK8B;AAJ5B,wGAAA,UAAU,OAAA;AAEV,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  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,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"]}