@equinor/fusion-framework-module-http 6.1.0 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,150 @@
 # Change Log
 
+## 6.2.0
+
+### Minor Changes
+
+-   [#2491](https://github.com/equinor/fusion-framework/pull/2491) [`73af73e`](https://github.com/equinor/fusion-framework/commit/73af73e5582ca27b132210af8ba308b80e036d51) Thanks [@odinr](https://github.com/odinr)! - Added a new operator `capitalizeRequestMethodOperator` to ensure that the HTTP method of a given request is in uppercase.
+
+    -   Introduced `capitalizeRequestMethodOperator` which processes an HTTP request object and converts its method to uppercase.
+    -   Logs a warning if the HTTP method was converted, providing information about the change and a reference to RFC 7231 Section 4.1.
+
+    **Example usage:**
+
+    ```typescript
+    import { capitalizeRequestMethodOperator } from '@equinor/fusion-query';
+
+    const operator = capitalizeRequestMethodOperator();
+    const request = { method: 'get' };
+    const updatedRequest = operator(request);
+    console.log(updatedRequest.method); // Outputs: 'GET'
+    ```
+
+    Adding the operator to the `HttpClient`:
+
+    ```typescript
+    const httpClient = new HttpClient();
+    httpClient.requestHandler.add('capatalize-method', capitalizeRequestMethodOperator());
+
+    // transforms `method` to uppercase and logs a warning.
+    httpClient.get('https://example.com', { method: 'get' });
+    ```
+
+-   [#2491](https://github.com/equinor/fusion-framework/pull/2491) [`73af73e`](https://github.com/equinor/fusion-framework/commit/73af73e5582ca27b132210af8ba308b80e036d51) Thanks [@odinr](https://github.com/odinr)! - The `HttpClientConfigurator` now has by default the `capitalizeRequestMethodOperator` and `requestValidationOperator` enabled.
+
+    **CapitalizeRequestMethodOperator**
+
+    This operator will capitalize the HTTP method name before sending the request. This is useful when you are using a client that requires the HTTP method to be capitalized. If you want to disable this operator, you can do so by removing it from the `HttpClientConfigurator`:
+
+    ```typescript
+    httpConfig.defaultHttpRequestHandler.remove('capitalize-method');
+    ```
+
+    > [!NOTE]
+    > This operator is enabled by default and will log to the console if the method is not capitalized.
+
+    **RequestValidationOperator**
+
+    This operator will parse and validate the request before sending it. If the request is invalid, the error will be logged to the console. If you want to disable this operator, you can do so by removing it from the `HttpClientConfigurator`:
+
+    ```typescript
+    httpConfig.defaultHttpRequestHandler.remove('validate-request');
+    ```
+
+    > [!NOTE]
+    > This operator is enabled by default and will log to the console if the request parameters are invalid.
+
+    If you wish stricter validation, you can enable the `strict` mode by setting the `strict` property to `true`:
+
+    ```typescript
+    import { requestValidationOperator } from '@equinor/fusion-framework-module-http/operators';
+
+    httpConfig.defaultHttpRequestHandler.set(
+      'validate-request'
+      requestValidationOperator({
+        strict: true, // will throw error if schema is not valid
+        parse: true // will not allow additional properties
+      })
+    );
+    ```
+
+-   [#2491](https://github.com/equinor/fusion-framework/pull/2491) [`73af73e`](https://github.com/equinor/fusion-framework/commit/73af73e5582ca27b132210af8ba308b80e036d51) Thanks [@odinr](https://github.com/odinr)! - Added `remove` to the `ProcessOperators` to allow for the removal of a specific operator. This is useful for removing operators that are not desired, example default operators included in initial configuration.
+
+    example:
+
+    ```typescript
+    httpClient.requestHandler.remove('capitalize-method');
+    ```
+
+    > [!NOTE]
+    > There are currently no code completion for the `remove` method, so you will need to know the name of the operator you want to remove. We assume this is so low level that if you are removing operators you know what the name of the operator is.
+
+    > [!TIP]
+    > If you only wish to replace the operator with another operator, you can use the `set` method instead of `remove` and `add`.
+
+-   [#2491](https://github.com/equinor/fusion-framework/pull/2491) [`73af73e`](https://github.com/equinor/fusion-framework/commit/73af73e5582ca27b132210af8ba308b80e036d51) Thanks [@odinr](https://github.com/odinr)! - **New Feature: Enhanced `requestValidationOperator`**
+
+    The `requestValidationOperator` is a utility function that validates incoming requests against a Zod schema. This function has two options: `strict` and `parse`. The `strict` option allows you to enforce strict validation, while the `parse` option enables you to return the parsed request object if it passes validation.
+
+    The `requestValidationOperator` is meant to be used as a request operator in the Fusion API framework. It is a higher-order function that takes a Zod schema as an argument and returns a function that validates incoming requests against that schema.
+
+    | Option                | Description                                                                                                                      | Usage                                                                                                                                 |
+    | --------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+    | **Strict Validation** | When `strict` is set to `true`, the validation will fail if there are additional properties not defined in the schema.           | If `strict` is set to `false` or omitted, additional properties will be allowed and passed through without causing validation errors. |
+    | **Parse Option**      | When `parse` is enabled, the function will return the parsed and potentially transformed request object if it passes validation. | If `parse` is not enabled, the function will not return anything even if the request object is valid.                                 |
+
+    To use the new `strict` and `parse` options, update your code as follows:
+
+    Example usage with strict validation:
+
+    ```typescript
+    const operator = requestValidationOperator({ strict: true });
+
+    // This will throw an error because of invalid method and extra property.
+    operator({
+        method: 'post',
+        body: 'foo',
+        extraProperty: 'This should not be here',
+    });
+    ```
+
+    Example usage with parsing enabled:
+
+    ```typescript
+    // Example usage with parsing enabled
+    const operator = requestValidationOperator({ parse: true });
+
+    // will return { method: 'GET' }
+    const parsedRequest = operator({
+        method: 'GET',
+        extraProperty: 'This should not be here',
+    });
+    ```
+
+    Example usage with both strict validation and parsing enabled:
+
+    ```typescript
+    const operator = requestValidationOperator({ strict: true, parse: true });
+
+    // will throw an error because of extra property.
+    const parsedStrictRequest = operator({
+        method: 'GET',
+        extraProperty: 'This should not be here',
+    });
+    ```
+
+    Example usage with the `HttpClient`:
+
+    ```typescript
+    const httpClient = new HttpClient();
+
+    // Add the request validation operator to the HttpClient.
+    httpClient.requestHandler.add('validate-init', requestValidationOperator({ parse: true }));
+
+    // will throw an error because of invalid method.
+    httpClient.get('https://example.com', { method: 'get' });
+    ```
+
 ## 6.1.0
 
 ### Minor Changes

package/README.md

@@ -703,6 +703,55 @@ client.requestHandler.add(
 );
 ```
 
+##### Available Request Handlers
+
+__`capitalizeRequestMethodOperator`__
+
+operator to ensure that the HTTP method of a given request is in uppercase.
+
+> [!NOTE]
+> by default this plugin will log a warning if the method was not in uppercase.
+> This can be disabled by setting the `silent` option to `true`.
+
+```typescript
+import { capitalizeRequestMethodOperator } from '@equinor/fusion-framework-module-http/operators';
+client.requestHandler.add(
+  'capatalize-method', 
+  capitalizeRequestMethodOperator()
+);
+
+// transforms `method` to uppercase and logs a warning.
+client.get('https://example.com', { method: 'get' });
+```
+
+__`requestValidationOperator`__
+
+operator to validate the request before it is sent.
+
+> [!NOTE]
+> By default this plugin will only log a warning if the request is invalid.
+> To allow the plugin to modify `FetchRequest` set the `parse` option to `true`. 
+> __NOTE__ this will also throw an error if the request is invalid.
+
+```typescript
+import { requestValidationOperator } from '@equinor/fusion-framework-module-http/operators';
+client.requestHandler.add(
+  'validate-request', 
+  requestValidationOperator(
+    {
+      // use parsed schema values for request
+      parse: true,
+      // only allow defined defined options
+      strict: false,
+    }
+  )
+);
+```
+
+> [!WARNING]
+> Validating `RequestInit` should not be necessary, but a helpful tool for development.
+
+
 #### Response Handlers
 
 > [!IMPORTANT]

package/dist/esm/configurator.js

@@ -1,4 +1,4 @@
-import { HttpRequestHandler } from './lib/operators';
+import { capitalizeRequestMethodOperator, requestValidationOperator, HttpRequestHandler, } from './lib/operators';
 /** @inheritdoc */
 export class HttpClientConfigurator {
     /** Get a clone of all configured clients */
@@ -12,7 +12,12 @@ export class HttpClientConfigurator {
     constructor(client) {
         this._clients = {};
         /** default request handler for http clients, applied on creation */
-        this.defaultHttpRequestHandler = new HttpRequestHandler();
+        this.defaultHttpRequestHandler = new HttpRequestHandler({
+            // convert all request methods to uppercase
+            ['capitalize-method']: capitalizeRequestMethodOperator(),
+            // validate the request object
+            ['request-validation']: requestValidationOperator(),
+        });
         this.defaultHttpClientCtor = client;
     }
     /** @inheritdoc */

package/dist/esm/configurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../src/configurator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAuHrD,kBAAkB;AAClB,MAAM,OAAO,sBAAsB;IAK/B,4CAA4C;IAC5C,IAAW,OAAO;QACd,yBAAY,IAAI,CAAC,QAAQ,EAAG;IAChC,CAAC;IAUD;;;OAGG;IACH,YAAY,MAAsC;QAnBxC,aAAQ,GAA+C,EAAE,CAAC;QAUpE,oEAAoE;QAC3D,8BAAyB,GAAG,IAAI,kBAAkB,EAExD,CAAC;QAOA,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC;IACxC,CAAC;IAED,kBAAkB;IAClB,SAAS,CAAC,IAAY;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,kBAAkB;IAClB,eAAe,CACX,IAAY,EACZ,IAAsE;QAEtE,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5F,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mCACZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAClB,OAAiD,CACxD,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../src/configurator.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,+BAA+B,EAC/B,yBAAyB,EACzB,kBAAkB,GACrB,MAAM,iBAAiB,CAAC;AAuHzB,kBAAkB;AAClB,MAAM,OAAO,sBAAsB;IAK/B,4CAA4C;IAC5C,IAAW,OAAO;QACd,yBAAY,IAAI,CAAC,QAAQ,EAAG;IAChC,CAAC;IAeD;;;OAGG;IACH,YAAY,MAAsC;QAxBxC,aAAQ,GAA+C,EAAE,CAAC;QAUpE,oEAAoE;QAC3D,8BAAyB,GAAG,IAAI,kBAAkB,CACvD;YACI,2CAA2C;YAC3C,CAAC,mBAAmB,CAAC,EAAE,+BAA+B,EAAE;YACxD,8BAA8B;YAC9B,CAAC,oBAAoB,CAAC,EAAE,yBAAyB,EAAE;SACtD,CACJ,CAAC;QAOE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAAC;IACxC,CAAC;IAED,kBAAkB;IAClB,SAAS,CAAC,IAAY;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,kBAAkB;IAClB,eAAe,CACX,IAAY,EACZ,IAAsE;QAEtE,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,EAAE,OAAO,EAAE,IAAI,EAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5F,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mCACZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAClB,OAAiD,CACxD,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED,eAAe,sBAAsB,CAAC"}

package/dist/esm/lib/operators/capitalize-request-method.operator.js

@@ -0,0 +1,17 @@
+import { requestMethodCasing } from './fetch-request.schema';
+/**
+ * Ensures that the HTTP method of the given request is in uppercase.
+ *
+ * @param request - The HTTP request object to process.
+ * @returns A new request object with the HTTP method in uppercase.
+ */
+export const capitalizeRequestMethodOperator = (options) => (request) => {
+    var _a;
+    const { error, success, data } = requestMethodCasing().safeParse(request.method);
+    request.method = success ? data : (_a = request.method) === null || _a === void 0 ? void 0 : _a.toUpperCase();
+    if (error && !(options === null || options === void 0 ? void 0 : options.silent)) {
+        error.errors.forEach((e) => console.warn(e.message));
+    }
+    return request;
+};
+//# sourceMappingURL=capitalize-request-method.operator.js.map

package/dist/esm/lib/operators/capitalize-request-method.operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize-request-method.operator.js","sourceRoot":"","sources":["../../../../src/lib/operators/capitalize-request-method.operator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GACxC,CAAwB,OAA8B,EAAsB,EAAE,CAC9E,CAAC,OAAO,EAAK,EAAE;;IACX,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,mBAAmB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjF,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAA,OAAO,CAAC,MAAM,0CAAE,WAAW,EAAE,CAAC;IAEhE,IAAI,KAAK,IAAI,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAA,EAAE,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC"}

package/dist/esm/lib/operators/fetch-request.schema.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+/**
+ * Validates that the provided HTTP method string is in uppercase.
+ *
+ * @link https://www.rfc-editor.org/rfc/rfc7231#section-4.1
+ */
+export const requestMethodCasing = () => {
+    return z.custom((value) => value === (value === null || value === void 0 ? void 0 : value.toUpperCase()), (value) => ({
+        code: z.ZodIssueCode.custom,
+        validation: 'uppercase',
+        path: ['method'],
+        message: [
+            `Provided HTTP method '${value}' must be in uppercase.`,
+            'See RFC 7231 Section 4.1 for more information',
+            'https://www.rfc-editor.org/rfc/rfc7231#section-4.1',
+        ].join(' '),
+    }));
+};
+/**
+ * Creates a Zod enum schema for HTTP request methods.
+ *
+ * The schema validates that the value is one of the standard HTTP methods:
+ * 'GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'CONNECT', 'TRACE'.
+ *
+ * If the validation fails, a custom error message is returned, indicating the
+ * expected methods and the received value. The error message also references
+ * RFC 2616 for more information.
+ *
+ * @link https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
+ */
+export const requestMethodVerb = () => {
+    return z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'CONNECT', 'TRACE'], {
+        errorMap: (error) => {
+            const { received, options } = error;
+            return {
+                message: [
+                    'Invalid request method.',
+                    `Expected '${options.join(' | ')}', but received '${received}'.`,
+                    'See RFC 2615 Section 9 for more information',
+                    'https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html',
+                ].join(' '),
+            };
+        },
+    });
+};
+export const requestMethod = () => requestMethodCasing().pipe(requestMethodVerb());
+/**
+ * Schema for validating the initialization options of a request.
+ *
+ * @link https://developer.mozilla.org/en-US/docs/Web/API/Request/Request
+ *
+ * This schema is used to ensure that the request options conform to the expected structure and types.
+ */
+export const requestInitSchema = z.object({
+    attributionReporting: z
+        .object({
+        eventSourceEligible: z.boolean().optional(),
+        triggerEligible: z.boolean().optional(),
+    })
+        .optional(),
+    body: z
+        .union([
+        z.string(),
+        z.instanceof(Blob),
+        z.instanceof(ArrayBuffer),
+        z.instanceof(FormData),
+        z.instanceof(URLSearchParams),
+        z.instanceof(ReadableStream),
+    ])
+        .optional(),
+    browsingTopics: z.boolean().optional(),
+    cache: z
+        .enum(['default', 'no-store', 'reload', 'no-cache', 'force-cache', 'only-if-cached'])
+        .optional(),
+    credentials: z.enum(['omit', 'same-origin', 'include']).optional(),
+    headers: z.record(z.string(), z.string()).optional().or(z.instanceof(Headers)),
+    integrity: z.string().optional(),
+    keepalive: z.boolean().optional(),
+    method: requestMethod().optional(),
+    mode: z.enum(['same-origin', 'cors', 'no-cors', 'navigate', 'websocket']).optional(),
+    priority: z.enum(['low', 'high', 'auto']).optional(),
+    redirect: z.enum(['follow', 'error', 'manual']).optional(),
+    referrer: z.string().optional(),
+    referrerPolicy: z
+        .enum([
+        'no-referrer',
+        'no-referrer-when-downgrade',
+        'origin',
+        'origin-when-cross-origin',
+        'same-origin',
+        'strict-origin',
+        'strict-origin-when-cross-origin',
+        'unsafe-url',
+    ])
+        .optional(),
+    signal: z.instanceof(AbortSignal).optional(),
+});
+/**
+ * Schema for validating fetch request configurations.
+ *
+ * This schema extends the `requestInitSchema` and adds additional properties:
+ * - `uri`: A required string representing the URI of the request.
+ * - `path`: An optional string representing the path of the request.
+ */
+export const fetchRequestSchema = requestInitSchema.extend({
+    uri: z.string(),
+    path: z.string().optional(),
+});
+//# sourceMappingURL=fetch-request.schema.js.map

package/dist/esm/lib/operators/fetch-request.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-request.schema.js","sourceRoot":"","sources":["../../../../src/lib/operators/fetch-request.schema.ts"],"names":[],"mappings":"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"}

package/dist/esm/lib/operators/index.js

@@ -1,5 +1,7 @@
 export { HttpRequestHandler } from './http-request-handler';
 export { HttpResponseHandler } from './http-response-handler';
 export { ProcessOperators } from './process-operators';
+export { capitalizeRequestMethodOperator } from './capitalize-request-method.operator';
+export { requestValidationOperator } from './request-validation.operator';
 export * from './types';
 //# sourceMappingURL=index.js.map

package/dist/esm/lib/operators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/operators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/operators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,cAAc,SAAS,CAAC"}

package/dist/esm/lib/operators/process-operators.js

@@ -50,6 +50,16 @@ export class ProcessOperators {
         this._operators[key] = operator;
         return this;
     }
+    /**
+     * Removes an operator from the collection by its key.
+     *
+     * @param key - The key of the operator to remove.
+     * @returns The current instance of `ProcessOperators` for method chaining.
+     */
+    remove(key) {
+        delete this._operators[key];
+        return this;
+    }
     /**
      * Retrieves an operator from the collection by its key.
      * @param key The key of the operator to retrieve.

package/dist/esm/lib/operators/process-operators.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-operators.js","sourceRoot":"","sources":["../../../../src/lib/operators/process-operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAQzB;;;OAGG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAqE;QAC7E,IAAI,SAAS,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,UAAU,qBAAQ,SAAS,CAAC,SAAS,CAAE,CAAC;QACjD,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;QACtC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW,EAAE,QAA4B;QACzC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1C,MAAM,KAAK,CAAC,aAAa,GAAG,mBAAmB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW,EAAE,QAA4B;QACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAU;QACd,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,mEAAmE;QACnE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAC5C,SAAS;QACL,iEAAiE;QACjE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAD,CAAC,cAAD,CAAC,GAAI,KAAK,CAAC;QAC7E,gBAAgB;QAChB,OAAO;QACP,yCAAyC;QACzC,CAAC,CACJ;QACD,iCAAiC;QACjC,IAAI,EAAE,CACT,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"process-operators.js","sourceRoot":"","sources":["../../../../src/lib/operators/process-operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAQzB;;;OAGG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAqE;QAC7E,IAAI,SAAS,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,UAAU,qBAAQ,SAAS,CAAC,SAAS,CAAE,CAAC;QACjD,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;QACtC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW,EAAE,QAA4B;QACzC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1C,MAAM,KAAK,CAAC,aAAa,GAAG,mBAAmB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW,EAAE,QAA4B;QACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAW;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAU;QACd,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,mEAAmE;QACnE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAC5C,SAAS;QACL,iEAAiE;QACjE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAD,CAAC,cAAD,CAAC,GAAI,KAAK,CAAC;QAC7E,gBAAgB;QAChB,OAAO;QACP,yCAAyC;QACzC,CAAC,CACJ;QACD,iCAAiC;QACjC,IAAI,EAAE,CACT,CAAC;IACN,CAAC;CACJ"}

package/dist/esm/lib/operators/request-validation.operator.js

@@ -0,0 +1,29 @@
+import { fetchRequestSchema } from './fetch-request.schema';
+/**
+ * Validates the given request using the `requestInitSchema`.
+ *
+ * By default, the validation is not strict, meaning that additional properties
+ * not defined in the schema will be allowed and passed through without causing validation errors.
+ * Also the operator will not modify the request object, it will only log an error message if the validation fails.
+ *
+ * @link https://developer.mozilla.org/en-US/docs/Web/API/Request/Request
+ *
+ * @param request - The request object to be validated.
+ * @returns The validated request object if validation is successful.
+ * @throws Will log an error message if the request validation fails.
+ */
+export const requestValidationOperator = (options) => (request) => {
+    const { strict, parse } = options !== null && options !== void 0 ? options : {};
+    const schema = strict ? fetchRequestSchema : fetchRequestSchema.passthrough();
+    try {
+        const result = schema.parse(request);
+        return parse ? result : void 0;
+    }
+    catch (error) {
+        if (parse) {
+            throw error;
+        }
+        console.error('Invalid request options', error.message);
+    }
+};
+//# sourceMappingURL=request-validation.operator.js.map

package/dist/esm/lib/operators/request-validation.operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-validation.operator.js","sourceRoot":"","sources":["../../../../src/lib/operators/request-validation.operator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAClC,CAAyB,OAiBxB,EAAsB,EAAE,CACzB,CAAC,OAAO,EAAE,EAAE;IACR,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC;IAC9E,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,KAAK,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAG,KAAoB,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '6.1.0';
+export const version = '6.2.0';
 //# sourceMappingURL=version.js.map