@webpieces/http-filters 0.2.14 → 0.2.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +2 -2
- package/src/Filter.d.ts +3 -12
- package/src/Filter.js +7 -23
- package/src/Filter.js.map +1 -1
- package/src/FilterChain.js +1 -1
- package/src/FilterChain.js.map +1 -1
- package/src/index.d.ts +1 -1
- package/src/index.js.map +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@webpieces/http-filters",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.16",
|
|
4
4
|
"description": "Filter chain infrastructure for cross-cutting concerns",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"main": "./src/index.js",
|
|
@@ -21,6 +21,6 @@
|
|
|
21
21
|
"access": "public"
|
|
22
22
|
},
|
|
23
23
|
"dependencies": {
|
|
24
|
-
"@webpieces/core-context": "0.2.
|
|
24
|
+
"@webpieces/core-context": "0.2.16"
|
|
25
25
|
}
|
|
26
26
|
}
|
package/src/Filter.d.ts
CHANGED
|
@@ -4,23 +4,14 @@
|
|
|
4
4
|
* Generic type parameter TResult represents the controller's return type.
|
|
5
5
|
* The filter chain uses WpResponse<unknown> because it handles all response types uniformly.
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* The jsonTranslator middleware is responsible for:
|
|
8
8
|
* 1. Serializing WpResponse.response to JSON
|
|
9
9
|
* 2. Writing the JSON to the HTTP response body
|
|
10
|
+
* 3. Setting the HTTP status code from WpResponse.statusCode
|
|
10
11
|
*/
|
|
11
12
|
export declare class WpResponse<TResult = unknown> {
|
|
12
13
|
response?: TResult;
|
|
13
|
-
|
|
14
|
-
headers: Map<string, string>;
|
|
15
|
-
constructor(response?: TResult, statusCode?: number);
|
|
16
|
-
/**
|
|
17
|
-
* Set a response header.
|
|
18
|
-
*/
|
|
19
|
-
setHeader(name: string, value: string): WpResponse<TResult>;
|
|
20
|
-
/**
|
|
21
|
-
* Create an error response wrapper.
|
|
22
|
-
*/
|
|
23
|
-
static error<T = unknown>(message: string, statusCode?: number): WpResponse<T>;
|
|
14
|
+
constructor(response?: TResult);
|
|
24
15
|
}
|
|
25
16
|
/**
|
|
26
17
|
* Service interface - Similar to Java WebPieces Service<REQ, RESP>.
|
package/src/Filter.js
CHANGED
|
@@ -7,30 +7,14 @@ exports.Filter = exports.WpResponse = void 0;
|
|
|
7
7
|
* Generic type parameter TResult represents the controller's return type.
|
|
8
8
|
* The filter chain uses WpResponse<unknown> because it handles all response types uniformly.
|
|
9
9
|
*
|
|
10
|
-
*
|
|
10
|
+
* The jsonTranslator middleware is responsible for:
|
|
11
11
|
* 1. Serializing WpResponse.response to JSON
|
|
12
12
|
* 2. Writing the JSON to the HTTP response body
|
|
13
|
+
* 3. Setting the HTTP status code from WpResponse.statusCode
|
|
13
14
|
*/
|
|
14
15
|
class WpResponse {
|
|
15
|
-
constructor(response
|
|
16
|
+
constructor(response) {
|
|
16
17
|
this.response = response;
|
|
17
|
-
this.statusCode = statusCode;
|
|
18
|
-
this.headers = new Map();
|
|
19
|
-
}
|
|
20
|
-
/**
|
|
21
|
-
* Set a response header.
|
|
22
|
-
*/
|
|
23
|
-
setHeader(name, value) {
|
|
24
|
-
this.headers.set(name, value);
|
|
25
|
-
return this;
|
|
26
|
-
}
|
|
27
|
-
/**
|
|
28
|
-
* Create an error response wrapper.
|
|
29
|
-
*/
|
|
30
|
-
static error(message, statusCode = 500) {
|
|
31
|
-
const wrapper = new WpResponse(undefined, statusCode);
|
|
32
|
-
wrapper.setHeader('X-Error', message);
|
|
33
|
-
return wrapper;
|
|
34
18
|
}
|
|
35
19
|
}
|
|
36
20
|
exports.WpResponse = WpResponse;
|
|
@@ -60,14 +44,14 @@ class Filter {
|
|
|
60
44
|
*/
|
|
61
45
|
chain(nextFilter) {
|
|
62
46
|
const self = this;
|
|
63
|
-
return new class extends Filter {
|
|
47
|
+
return new (class extends Filter {
|
|
64
48
|
async filter(meta, nextService) {
|
|
65
49
|
// Call outer filter, passing next filter wrapped as a Service
|
|
66
50
|
return self.filter(meta, {
|
|
67
|
-
invoke: (m) => nextFilter.filter(m, nextService)
|
|
51
|
+
invoke: (m) => nextFilter.filter(m, nextService),
|
|
68
52
|
});
|
|
69
53
|
}
|
|
70
|
-
};
|
|
54
|
+
})();
|
|
71
55
|
}
|
|
72
56
|
/**
|
|
73
57
|
* Chain this filter with a final service (controller).
|
|
@@ -81,7 +65,7 @@ class Filter {
|
|
|
81
65
|
chainService(svc) {
|
|
82
66
|
const self = this;
|
|
83
67
|
return {
|
|
84
|
-
invoke: (meta) => self.filter(meta, svc)
|
|
68
|
+
invoke: (meta) => self.filter(meta, svc),
|
|
85
69
|
};
|
|
86
70
|
}
|
|
87
71
|
}
|
package/src/Filter.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Filter.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/Filter.ts"],"names":[],"mappings":";;;AAAA
|
|
1
|
+
{"version":3,"file":"Filter.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/Filter.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,MAAa,UAAU;IAGnB,YAAY,QAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAND,gCAMC;AAoBD;;;;;;;;;;;;;GAaG;AACH,MAAsB,MAAM;IAaxB;;;;;;;;OAQG;IACH,KAAK,CAAC,UAA6B;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,OAAO,IAAI,CAAC,KAAM,SAAQ,MAAiB;YACvC,KAAK,CAAC,MAAM,CAAC,IAAS,EAAE,WAA+B;gBACnD,8DAA8D;gBAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;oBACrB,MAAM,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC;iBACxD,CAAC,CAAC;YACP,CAAC;SACJ,CAAC,EAAE,CAAC;IACT,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,GAAuB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,OAAO;YACH,MAAM,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;SAChD,CAAC;IACN,CAAC;CACJ;AAnDD,wBAmDC","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 * The jsonTranslator middleware is responsible for:\n * 1. Serializing WpResponse.response to JSON\n * 2. Writing the JSON to the HTTP response body\n * 3. Setting the HTTP status code from WpResponse.statusCode\n */\nexport class WpResponse<TResult = unknown> {\n response?: TResult;\n\n constructor(response?: TResult) {\n this.response = response;\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 //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(meta: REQ, nextFilter: Service<REQ, RESP>): 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(meta: REQ, nextService: Service<REQ, RESP>): 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.js
CHANGED
package/src/FilterChain.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"FilterChain.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/FilterChain.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACH,MAAa,WAAW;
|
|
1
|
+
{"version":3,"file":"FilterChain.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/FilterChain.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACH,MAAa,WAAW;IAGpB,YAAY,OAA4B;QACpC,4DAA4D;QAC5D,sEAAsE;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,IAAS,EAAE,YAAiC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,wDAAwD;QACxD,MAAM,qBAAqB,GAAG,CAAC,YAAoB,EAAsB,EAAE;YACvE,OAAO;gBACH,MAAM,EAAE,KAAK,EAAE,CAAM,EAAiB,EAAE;oBACpC,IAAI,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;wBAChC,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;oBACzC,CAAC;yBAAM,CAAC;wBACJ,mDAAmD;wBACnD,OAAO,YAAY,EAAE,CAAC;oBAC1B,CAAC;gBACL,CAAC;aACJ,CAAC;QACN,CAAC,CAAC;QAEF,oCAAoC;QACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,UAAU;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACJ;AArDD,kCAqDC","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(meta: REQ, finalHandler: () => Promise<RESP>): 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
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { Filter, WpResponse, Service
|
|
1
|
+
export { Filter, WpResponse, Service } from './Filter';
|
|
2
2
|
export { FilterChain } from './FilterChain';
|
package/src/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/index.ts"],"names":[],"mappings":";;;AAAA,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/http/http-filters/src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAuD;AAA9C,gGAAA,MAAM,OAAA;AAAE,oGAAA,UAAU,OAAA;AAE3B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA","sourcesContent":["export { Filter, WpResponse, Service } from './Filter';\n\nexport { FilterChain } from './FilterChain';\n"]}
|