@venizia/ignis-helpers 0.5.0-0 → 0.5.0-1

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.
Files changed (23) hide show
  1. package/dist/esm/common/constants/http.d.ts +14 -1
  2. package/dist/esm/common/constants/http.js +14 -0
  3. package/dist/esm/common/constants/http.js.map +1 -1
  4. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -2
  5. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  6. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +3 -3
  7. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +11 -11
  8. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  9. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.d.ts +126 -2
  10. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js +252 -2
  11. package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js.map +1 -1
  12. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +5 -5
  13. package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
  14. package/dist/esm/modules/network/http-request/fetcher/common/utilities.d.ts +7 -7
  15. package/dist/esm/modules/network/http-request/fetcher/common/utilities.js +8 -8
  16. package/dist/esm/modules/network/http-request/fetcher/common/utilities.js.map +1 -1
  17. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.d.ts +2 -0
  18. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js +15 -15
  19. package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js.map +1 -1
  20. package/dist/esm/utilities/request.utility.d.ts +1 -25
  21. package/dist/esm/utilities/request.utility.js +0 -46
  22. package/dist/esm/utilities/request.utility.js.map +1 -1
  23. package/package.json +3 -3
@@ -1,4 +1,4 @@
1
- import { type ValueOf } from '../types/index.js';
1
+ import { type TConstValue, type ValueOf } from '../types/index.js';
2
2
  /** HTTP constants: header names, CORS headers, header values, methods, protocols and status codes. Header names, methods and protocols are lowercase. */
3
3
  export declare class HTTP {
4
4
  /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */
@@ -62,6 +62,10 @@ export declare class HTTP {
62
62
  readonly RESPONSE_COUNT_DATA: "x-response-count";
63
63
  readonly RESPONSE_FORMAT: "x-response-format";
64
64
  readonly RESPONSE_EXTRA: "x-response-extra";
65
+ readonly AUTH_PROVIDER: "x-auth-provider";
66
+ readonly LOCALE: "x-locale";
67
+ readonly TIMEZONE: "timezone";
68
+ readonly TIMEZONE_OFFSET: "timezone-offset";
65
69
  };
66
70
  /**
67
71
  * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them
@@ -194,4 +198,13 @@ export type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeo
194
198
  export type THttpProtocol = ValueOf<typeof HTTP.Protocols> | Uppercase<ValueOf<typeof HTTP.Protocols>>;
195
199
  /** A numeric HTTP status code from any class in `HTTP.ResultCodes`. */
196
200
  export type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;
201
+ /** How a client treats a download: ATTACHMENT saves it, INLINE shows it. */
202
+ export declare class ContentDispositionTypes {
203
+ static readonly ATTACHMENT = "attachment";
204
+ static readonly INLINE = "inline";
205
+ static readonly SCHEME_SET: Set<string>;
206
+ static isValid(value: string): boolean;
207
+ }
208
+ /** Valid Content-Disposition type values. */
209
+ export type TContentDispositionType = TConstValue<typeof ContentDispositionTypes>;
197
210
  //# sourceMappingURL=http.d.ts.map
@@ -70,6 +70,11 @@ export class HTTP {
70
70
  RESPONSE_COUNT_DATA: 'x-response-count',
71
71
  RESPONSE_FORMAT: 'x-response-format',
72
72
  RESPONSE_EXTRA: 'x-response-extra',
73
+ // Client context
74
+ AUTH_PROVIDER: 'x-auth-provider',
75
+ LOCALE: 'x-locale',
76
+ TIMEZONE: 'timezone',
77
+ TIMEZONE_OFFSET: 'timezone-offset',
73
78
  }; }
74
79
  /**
75
80
  * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them
@@ -213,4 +218,13 @@ export class HTTP {
213
218
  },
214
219
  }; }
215
220
  }
221
+ /** How a client treats a download: ATTACHMENT saves it, INLINE shows it. */
222
+ export class ContentDispositionTypes {
223
+ static { this.ATTACHMENT = 'attachment'; }
224
+ static { this.INLINE = 'inline'; }
225
+ static { this.SCHEME_SET = new Set([this.ATTACHMENT, this.INLINE]); }
226
+ static isValid(value) {
227
+ return this.SCHEME_SET.has(value);
228
+ }
229
+ }
216
230
  //# sourceMappingURL=http.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/common/constants/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOf } from '../types';\n\n/** HTTP constants: header names, CORS headers, header values, methods, protocols and status codes. Header names, methods and protocols are lowercase. */\nexport class HTTP {\n /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */\n static readonly Headers = {\n // Content\n CONTENT_DISPOSITION: 'content-disposition',\n CONTENT_ENCODING: 'content-encoding',\n CONTENT_LENGTH: 'content-length',\n CONTENT_TYPE: 'content-type',\n CONTENT_RANGE: 'content-range',\n CONTENT_SECURITY_POLICY: 'content-security-policy',\n ACCEPT_RANGES: 'accept-ranges',\n RANGE: 'range',\n\n // Request - content negotiation & conditionals\n ACCEPT: 'accept',\n ACCEPT_ENCODING: 'accept-encoding',\n ACCEPT_LANGUAGE: 'accept-language',\n AUTHORIZATION: 'authorization',\n COOKIE: 'cookie',\n HOST: 'host',\n IF_MATCH: 'if-match',\n IF_MODIFIED_SINCE: 'if-modified-since',\n IF_NONE_MATCH: 'if-none-match',\n ORIGIN: 'origin',\n REFERER: 'referer',\n USER_AGENT: 'user-agent',\n\n // Response - caching, auth challenges & redirects\n ALLOW: 'allow',\n CACHE_CONTROL: 'cache-control',\n ETAG: 'etag',\n LAST_MODIFIED: 'last-modified',\n LOCATION: 'location',\n RETRY_AFTER: 'retry-after',\n SET_COOKIE: 'set-cookie',\n VARY: 'vary',\n WWW_AUTHENTICATE: 'www-authenticate',\n\n // CORS (RFC 6454 / Fetch spec)\n ACCESS_CONTROL_ALLOW_CREDENTIALS: 'access-control-allow-credentials',\n ACCESS_CONTROL_ALLOW_HEADERS: 'access-control-allow-headers',\n ACCESS_CONTROL_ALLOW_METHODS: 'access-control-allow-methods',\n ACCESS_CONTROL_ALLOW_ORIGIN: 'access-control-allow-origin',\n ACCESS_CONTROL_EXPOSE_HEADERS: 'access-control-expose-headers',\n ACCESS_CONTROL_MAX_AGE: 'access-control-max-age',\n ACCESS_CONTROL_REQUEST_HEADERS: 'access-control-request-headers',\n ACCESS_CONTROL_REQUEST_METHOD: 'access-control-request-method',\n\n // Transport\n CONNECTION: 'connection',\n TRANSFER_ENCODING: 'transfer-encoding',\n UPGRADE: 'upgrade',\n\n // Security\n STRICT_TRANSPORT_SECURITY: 'strict-transport-security',\n X_CONTENT_TYPE_OPTIONS: 'x-content-type-options',\n X_FRAME_OPTIONS: 'x-frame-options',\n\n // Proxy / forwarding (de facto standard)\n FORWARDED: 'forwarded',\n X_FORWARDED_FOR: 'x-forwarded-for',\n X_FORWARDED_HOST: 'x-forwarded-host',\n X_FORWARDED_PROTO: 'x-forwarded-proto',\n X_REAL_IP: 'x-real-ip',\n\n // Rate limiting (de facto standard)\n X_RATELIMIT_LIMIT: 'x-ratelimit-limit',\n X_RATELIMIT_REMAINING: 'x-ratelimit-remaining',\n X_RATELIMIT_RESET: 'x-ratelimit-reset',\n\n // IGNIS custom\n REQUEST_TRACING_ID: 'x-request-id',\n REQUEST_DEVICE_INFO: 'x-device-info',\n REQUEST_CHANNEL: 'x-request-channel',\n REQUEST_COUNT_DATA: 'x-request-count',\n REQUEST_EXTRA: 'x-request-extra',\n RESPONSE_COUNT_DATA: 'x-response-count',\n RESPONSE_FORMAT: 'x-response-format',\n RESPONSE_EXTRA: 'x-response-extra',\n } as const;\n\n /**\n * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them\n * by hand: spread `ALLOW` into the allowed request headers and `EXPOSE` into the exposed ones, so\n * a header IGNIS adds later needs no change there.\n */\n static readonly CorsHeaders = {\n ALLOW: [\n 'x-request-id',\n 'x-request-count',\n 'x-request-extra',\n 'x-request-channel',\n 'x-device-info',\n ],\n EXPOSE: [\n 'content-range',\n 'x-request-id',\n 'x-response-count',\n 'x-response-format',\n 'x-response-extra',\n ],\n } as const;\n\n /** Common MIME / Content-Type values. */\n static readonly HeaderValues = {\n // Application\n APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',\n APPLICATION_GRAPHQL_JSON: 'application/graphql+json',\n APPLICATION_GZIP: 'application/gzip',\n APPLICATION_JAVASCRIPT: 'application/javascript',\n APPLICATION_JSON: 'application/json',\n /** A JSON body with its charset named, the value a client sends by default. */\n APPLICATION_JSON_UTF8: 'application/json; charset=utf-8',\n APPLICATION_MSGPACK: 'application/msgpack',\n APPLICATION_NDJSON: 'application/x-ndjson',\n APPLICATION_OCTET_STREAM: 'application/octet-stream',\n APPLICATION_PDF: 'application/pdf',\n APPLICATION_PROTOBUF: 'application/x-protobuf',\n APPLICATION_XML: 'application/xml',\n APPLICATION_ZIP: 'application/zip',\n\n // Multipart\n MULTIPART_FORM_DATA: 'multipart/form-data',\n\n // Text\n TEXT_CSS: 'text/css',\n TEXT_CSV: 'text/csv',\n TEXT_EVENT_STREAM: 'text/event-stream',\n TEXT_HTML: 'text/html',\n TEXT_PLAIN: 'text/plain',\n TEXT_XML: 'text/xml',\n\n // Image\n IMAGE_GIF: 'image/gif',\n IMAGE_JPEG: 'image/jpeg',\n IMAGE_PNG: 'image/png',\n IMAGE_SVG: 'image/svg+xml',\n IMAGE_WEBP: 'image/webp',\n\n // Range units\n RANGE_UNIT_BYTES: 'bytes',\n } as const;\n\n /** Standard HTTP methods (lowercase). */\n static readonly Methods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n QUERY: 'query',\n } as const;\n\n /** Standard HTTP protocols (lowercase). */\n static readonly Protocols = {\n HTTP: 'http',\n HTTPS: 'https',\n } as const;\n\n /** HTTP status codes grouped by class (1xx - 5xx). */\n static readonly ResultCodes = {\n /** 1xx - Informational. */\n RS_1: {\n Continue: 100,\n SwitchingProtocols: 101,\n EarlyHints: 103,\n },\n\n /** 2xx - Success. */\n RS_2: {\n Ok: 200,\n Created: 201,\n Accepted: 202,\n NonAuthoritativeInformation: 203,\n NoContent: 204,\n ResetContent: 205,\n PartialContent: 206,\n MultiStatus: 207,\n },\n\n /** 3xx - Redirection. */\n RS_3: {\n MovedPermanently: 301,\n Found: 302,\n NotModified: 304,\n TemporaryRedirect: 307,\n PermanentRedirect: 308,\n },\n\n /** 4xx - Client error. */\n RS_4: {\n BadRequest: 400,\n Unauthorized: 401,\n PaymentRequired: 402,\n Forbidden: 403,\n NotFound: 404,\n MethodNotAllowed: 405,\n NotAcceptable: 406,\n RequestTimeout: 408,\n Conflict: 409,\n Gone: 410,\n LengthRequired: 411,\n PreconditionFailed: 412,\n ContentTooLarge: 413,\n URITooLong: 414,\n UnsupportedMediaType: 415,\n RangeNotSatisfiable: 416,\n ExpectationFailed: 417,\n UnprocessableEntity: 422,\n Locked: 423,\n FailedDependency: 424,\n TooEarly: 425,\n UpgradeRequired: 426,\n PreconditionRequired: 428,\n TooManyRequests: 429,\n RequestHeaderFieldsTooLarge: 431,\n UnavailableForLegalReasons: 451,\n },\n\n /** 5xx - Server error. */\n RS_5: {\n InternalServerError: 500,\n NotImplemented: 501,\n BadGateway: 502,\n ServiceUnavailable: 503,\n GatewayTimeout: 504,\n HTTPVersionNotSupported: 505,\n InsufficientStorage: 507,\n LoopDetected: 508,\n NetworkAuthenticationRequired: 511,\n },\n } as const;\n}\n\n/** An HTTP method from `HTTP.Methods`, in lowercase or uppercase. */\nexport type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeof HTTP.Methods>>;\n/** An HTTP protocol from `HTTP.Protocols`, in lowercase or uppercase. */\nexport type THttpProtocol =\n | ValueOf<typeof HTTP.Protocols>\n | Uppercase<ValueOf<typeof HTTP.Protocols>>;\n/** A numeric HTTP status code from any class in `HTTP.ResultCodes`. */\nexport type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;\n"]}
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/common/constants/http.ts"],"names":[],"mappings":"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","sourcesContent":["import { type TConstValue, type ValueOf } from '../types';\n\n/** HTTP constants: header names, CORS headers, header values, methods, protocols and status codes. Header names, methods and protocols are lowercase. */\nexport class HTTP {\n /** Standard and common HTTP headers (lowercase per HTTP/2 convention). */\n static readonly Headers = {\n // Content\n CONTENT_DISPOSITION: 'content-disposition',\n CONTENT_ENCODING: 'content-encoding',\n CONTENT_LENGTH: 'content-length',\n CONTENT_TYPE: 'content-type',\n CONTENT_RANGE: 'content-range',\n CONTENT_SECURITY_POLICY: 'content-security-policy',\n ACCEPT_RANGES: 'accept-ranges',\n RANGE: 'range',\n\n // Request - content negotiation & conditionals\n ACCEPT: 'accept',\n ACCEPT_ENCODING: 'accept-encoding',\n ACCEPT_LANGUAGE: 'accept-language',\n AUTHORIZATION: 'authorization',\n COOKIE: 'cookie',\n HOST: 'host',\n IF_MATCH: 'if-match',\n IF_MODIFIED_SINCE: 'if-modified-since',\n IF_NONE_MATCH: 'if-none-match',\n ORIGIN: 'origin',\n REFERER: 'referer',\n USER_AGENT: 'user-agent',\n\n // Response - caching, auth challenges & redirects\n ALLOW: 'allow',\n CACHE_CONTROL: 'cache-control',\n ETAG: 'etag',\n LAST_MODIFIED: 'last-modified',\n LOCATION: 'location',\n RETRY_AFTER: 'retry-after',\n SET_COOKIE: 'set-cookie',\n VARY: 'vary',\n WWW_AUTHENTICATE: 'www-authenticate',\n\n // CORS (RFC 6454 / Fetch spec)\n ACCESS_CONTROL_ALLOW_CREDENTIALS: 'access-control-allow-credentials',\n ACCESS_CONTROL_ALLOW_HEADERS: 'access-control-allow-headers',\n ACCESS_CONTROL_ALLOW_METHODS: 'access-control-allow-methods',\n ACCESS_CONTROL_ALLOW_ORIGIN: 'access-control-allow-origin',\n ACCESS_CONTROL_EXPOSE_HEADERS: 'access-control-expose-headers',\n ACCESS_CONTROL_MAX_AGE: 'access-control-max-age',\n ACCESS_CONTROL_REQUEST_HEADERS: 'access-control-request-headers',\n ACCESS_CONTROL_REQUEST_METHOD: 'access-control-request-method',\n\n // Transport\n CONNECTION: 'connection',\n TRANSFER_ENCODING: 'transfer-encoding',\n UPGRADE: 'upgrade',\n\n // Security\n STRICT_TRANSPORT_SECURITY: 'strict-transport-security',\n X_CONTENT_TYPE_OPTIONS: 'x-content-type-options',\n X_FRAME_OPTIONS: 'x-frame-options',\n\n // Proxy / forwarding (de facto standard)\n FORWARDED: 'forwarded',\n X_FORWARDED_FOR: 'x-forwarded-for',\n X_FORWARDED_HOST: 'x-forwarded-host',\n X_FORWARDED_PROTO: 'x-forwarded-proto',\n X_REAL_IP: 'x-real-ip',\n\n // Rate limiting (de facto standard)\n X_RATELIMIT_LIMIT: 'x-ratelimit-limit',\n X_RATELIMIT_REMAINING: 'x-ratelimit-remaining',\n X_RATELIMIT_RESET: 'x-ratelimit-reset',\n\n // IGNIS custom\n REQUEST_TRACING_ID: 'x-request-id',\n REQUEST_DEVICE_INFO: 'x-device-info',\n REQUEST_CHANNEL: 'x-request-channel',\n REQUEST_COUNT_DATA: 'x-request-count',\n REQUEST_EXTRA: 'x-request-extra',\n RESPONSE_COUNT_DATA: 'x-response-count',\n RESPONSE_FORMAT: 'x-response-format',\n RESPONSE_EXTRA: 'x-response-extra',\n\n // Client context\n AUTH_PROVIDER: 'x-auth-provider',\n LOCALE: 'x-locale',\n TIMEZONE: 'timezone',\n TIMEZONE_OFFSET: 'timezone-offset',\n } as const;\n\n /**\n * The headers IGNIS adds to a request and to a response, for a CORS configuration that lists them\n * by hand: spread `ALLOW` into the allowed request headers and `EXPOSE` into the exposed ones, so\n * a header IGNIS adds later needs no change there.\n */\n static readonly CorsHeaders = {\n ALLOW: [\n 'x-request-id',\n 'x-request-count',\n 'x-request-extra',\n 'x-request-channel',\n 'x-device-info',\n ],\n EXPOSE: [\n 'content-range',\n 'x-request-id',\n 'x-response-count',\n 'x-response-format',\n 'x-response-extra',\n ],\n } as const;\n\n /** Common MIME / Content-Type values. */\n static readonly HeaderValues = {\n // Application\n APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',\n APPLICATION_GRAPHQL_JSON: 'application/graphql+json',\n APPLICATION_GZIP: 'application/gzip',\n APPLICATION_JAVASCRIPT: 'application/javascript',\n APPLICATION_JSON: 'application/json',\n /** A JSON body with its charset named, the value a client sends by default. */\n APPLICATION_JSON_UTF8: 'application/json; charset=utf-8',\n APPLICATION_MSGPACK: 'application/msgpack',\n APPLICATION_NDJSON: 'application/x-ndjson',\n APPLICATION_OCTET_STREAM: 'application/octet-stream',\n APPLICATION_PDF: 'application/pdf',\n APPLICATION_PROTOBUF: 'application/x-protobuf',\n APPLICATION_XML: 'application/xml',\n APPLICATION_ZIP: 'application/zip',\n\n // Multipart\n MULTIPART_FORM_DATA: 'multipart/form-data',\n\n // Text\n TEXT_CSS: 'text/css',\n TEXT_CSV: 'text/csv',\n TEXT_EVENT_STREAM: 'text/event-stream',\n TEXT_HTML: 'text/html',\n TEXT_PLAIN: 'text/plain',\n TEXT_XML: 'text/xml',\n\n // Image\n IMAGE_GIF: 'image/gif',\n IMAGE_JPEG: 'image/jpeg',\n IMAGE_PNG: 'image/png',\n IMAGE_SVG: 'image/svg+xml',\n IMAGE_WEBP: 'image/webp',\n\n // Range units\n RANGE_UNIT_BYTES: 'bytes',\n } as const;\n\n /** Standard HTTP methods (lowercase). */\n static readonly Methods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n QUERY: 'query',\n } as const;\n\n /** Standard HTTP protocols (lowercase). */\n static readonly Protocols = {\n HTTP: 'http',\n HTTPS: 'https',\n } as const;\n\n /** HTTP status codes grouped by class (1xx - 5xx). */\n static readonly ResultCodes = {\n /** 1xx - Informational. */\n RS_1: {\n Continue: 100,\n SwitchingProtocols: 101,\n EarlyHints: 103,\n },\n\n /** 2xx - Success. */\n RS_2: {\n Ok: 200,\n Created: 201,\n Accepted: 202,\n NonAuthoritativeInformation: 203,\n NoContent: 204,\n ResetContent: 205,\n PartialContent: 206,\n MultiStatus: 207,\n },\n\n /** 3xx - Redirection. */\n RS_3: {\n MovedPermanently: 301,\n Found: 302,\n NotModified: 304,\n TemporaryRedirect: 307,\n PermanentRedirect: 308,\n },\n\n /** 4xx - Client error. */\n RS_4: {\n BadRequest: 400,\n Unauthorized: 401,\n PaymentRequired: 402,\n Forbidden: 403,\n NotFound: 404,\n MethodNotAllowed: 405,\n NotAcceptable: 406,\n RequestTimeout: 408,\n Conflict: 409,\n Gone: 410,\n LengthRequired: 411,\n PreconditionFailed: 412,\n ContentTooLarge: 413,\n URITooLong: 414,\n UnsupportedMediaType: 415,\n RangeNotSatisfiable: 416,\n ExpectationFailed: 417,\n UnprocessableEntity: 422,\n Locked: 423,\n FailedDependency: 424,\n TooEarly: 425,\n UpgradeRequired: 426,\n PreconditionRequired: 428,\n TooManyRequests: 429,\n RequestHeaderFieldsTooLarge: 431,\n UnavailableForLegalReasons: 451,\n },\n\n /** 5xx - Server error. */\n RS_5: {\n InternalServerError: 500,\n NotImplemented: 501,\n BadGateway: 502,\n ServiceUnavailable: 503,\n GatewayTimeout: 504,\n HTTPVersionNotSupported: 505,\n InsufficientStorage: 507,\n LoopDetected: 508,\n NetworkAuthenticationRequired: 511,\n },\n } as const;\n}\n\n/** An HTTP method from `HTTP.Methods`, in lowercase or uppercase. */\nexport type THttpMethod = ValueOf<typeof HTTP.Methods> | Uppercase<ValueOf<typeof HTTP.Methods>>;\n/** An HTTP protocol from `HTTP.Protocols`, in lowercase or uppercase. */\nexport type THttpProtocol =\n | ValueOf<typeof HTTP.Protocols>\n | Uppercase<ValueOf<typeof HTTP.Protocols>>;\n/** A numeric HTTP status code from any class in `HTTP.ResultCodes`. */\nexport type THttpResultCode = ValueOf<typeof HTTP.ResultCodes>;\n\n/** How a client treats a download: ATTACHMENT saves it, INLINE shows it. */\nexport class ContentDispositionTypes {\n static readonly ATTACHMENT = 'attachment';\n static readonly INLINE = 'inline';\n\n static readonly SCHEME_SET = new Set<string>([this.ATTACHMENT, this.INLINE]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Valid Content-Disposition type values. */\nexport type TContentDispositionType = TConstValue<typeof ContentDispositionTypes>;\n"]}
@@ -8,7 +8,7 @@ import { getError } from '../../../error/index.js';
8
8
  import { BaseNetworkRequest } from '../base-network-request.helper.js';
9
9
  import { AbstractNetworkFetchableHelper, } from './base-fetcher.js';
10
10
  import { BodyLimit } from './common/body-limit.js';
11
- import { FetchHeaders } from './common/utilities.js';
11
+ import { HttpHeaders } from './common/utilities.js';
12
12
  /**
13
13
  * The request options a guarded call accepts, besides the ones the pipeline owns. An allowlist, not a denylist: axios keeps
14
14
  * adding transport knobs (`httpVersion`, `http2Options`, ...) that connect on their own and ignore the pinned agent, so
@@ -204,7 +204,7 @@ export class AxiosNetworkRequest extends BaseNetworkRequest {
204
204
  defaults: {
205
205
  timeout: timeout ?? 60 * 1000,
206
206
  ...opts.defaults,
207
- headers: FetchHeaders.withJsonDefault({ layers: [headers, opts.defaults?.headers] }),
207
+ headers: HttpHeaders.withJsonDefault({ layers: [headers, opts.defaults?.headers] }),
208
208
  },
209
209
  hooks: opts.hooks,
210
210
  guardEngine: opts.guardEngine,
@@ -1 +1 @@
1
- {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport http from 'node:http';\nimport https from 'node:https';\nimport { isIP } from 'node:net';\nimport { QueryStringUtility } from '../../utilities/query-string';\nimport { getError } from '@/modules/error';\nimport type { IUrlSafetyPolicy } from '@/modules/network/utilities/url-safety/common/types';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport {\n AbstractNetworkFetchableHelper,\n type IFetchExchange,\n type IFetchExchangeRequest,\n type IRequestOptions,\n} from './base-fetcher';\nimport type { IFetchGuard } from './common/guard';\nimport type { IFetcherDefaults, IFetcherHooks } from './common/types';\nimport { BodyLimit } from './common/body-limit';\nimport { FetchHeaders } from './common/utilities';\n\n/**\n * The request options a guarded call accepts, besides the ones the pipeline owns. An allowlist, not a denylist: axios keeps\n * adding transport knobs (`httpVersion`, `http2Options`, ...) that connect on their own and ignore the pinned agent, so\n * anything not listed here is refused, per call and in `defaultConfigs`. Plain data only: a function runs with the axios\n * config as `this` (`transformRequest` can rewrite `url` or `socketPath`), `auth` is re-applied after the cross-origin\n * header strip, and `baseURL` makes axios combine urls, so none of them is listed. A caller sets `Authorization` through\n * `headers`, transforms the body before the call and the answer after it.\n */\nconst GUARDED_OPTIONS = new Set([\n 'withCredentials',\n 'responseType',\n 'responseEncoding',\n 'xsrfCookieName',\n 'xsrfHeaderName',\n 'withXSRFToken',\n 'maxContentLength',\n 'maxBodyLength',\n 'maxRate',\n 'decompress',\n 'transitional',\n 'rejectUnauthorized',\n]);\n\n/** The fields of an axios config the pipeline owns. */\ntype TOwnedAxiosFields =\n | 'url'\n | 'method'\n | 'params'\n | 'data'\n | 'headers'\n | 'signal'\n | 'timeout'\n | 'maxRedirects'\n | 'validateStatus';\n\n/** Request accepted by `AxiosFetcher`: an axios config where `body` is sent as the axios `data`. `rejectUnauthorized` set here overrides the instance setting for this call. */\nexport interface IAxiosRequestOptions\n extends Omit<AxiosRequestConfig, TOwnedAxiosFields>, IRequestOptions {\n url: string;\n params?: Record<string, unknown>;\n body?: Record<string, unknown>;\n /** Whether this call rejects an HTTPS server whose certificate fails verification; `false` turns verification off for this call. */\n rejectUnauthorized?: boolean;\n}\n\n/** A `lookup` for `net`/`tls` that answers the vetted addresses and nothing else: the client never resolves the name. */\nconst pinnedLookup = (addresses: string[]) => {\n const answers = addresses.map((address) => ({ address, family: isIP(address) === 6 ? 6 : 4 }));\n\n return (\n _hostname: string,\n options: unknown,\n callback: (\n error: Error | null,\n address: string | Array<{ address: string; family: number }>,\n family?: number,\n ) => void,\n ) => {\n const wantsAll =\n typeof options === 'object' && options !== null && Reflect.get(options, 'all') === true;\n\n if (wantsAll) {\n callback(null, answers);\n\n return;\n }\n\n const [first] = answers;\n callback(null, first.address, first.family);\n };\n};\n\n/** Fetcher over an axios instance (`getWorker()`): the pipeline of `AbstractNetworkFetchableHelper` with axios as the client. HTTPS calls share one keep-alive agent that verifies certificates unless `rejectUnauthorized` is `false`; an `httpsAgent` passed in the request wins - and is refused together with a `guard`, because an agent of the caller's could connect elsewhere than the vetted address. */\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<unknown>,\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1). A guarded call never uses it: it gets an agent of its own that answers one vetted address and is dropped with the call, so no pin outlives it.\n */\n private readonly httpsAgent: https.Agent;\n private readonly isRejectingUnauthorized: boolean;\n /** What the caller put in `defaultConfigs`: a guarded call checks it like its own options. */\n private readonly configured: Record<string, unknown>;\n\n constructor(opts: {\n name: string;\n defaultConfigs?: AxiosRequestConfig;\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n /** The server half of the url guard (`UrlGuard`); a call that passes `guard` needs it. */\n guardEngine?: IFetchGuard;\n logger?: ILogger;\n /**\n * Whether this instance rejects an HTTPS server whose certificate fails verification.\n * `false` turns verification off.\n * @default true\n */\n rejectUnauthorized?: boolean;\n }) {\n super({\n name: opts.name,\n variant: 'axios',\n defaults: opts.defaults,\n hooks: opts.hooks,\n guardEngine: opts.guardEngine,\n });\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.isRejectingUnauthorized = opts.rejectUnauthorized ?? true;\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: this.isRejectingUnauthorized,\n });\n\n this.configured = { ...opts.defaultConfigs };\n this.worker = axios.create({ ...opts.defaultConfigs });\n }\n\n protected override assertCallSupported(opts: {\n guard?: IUrlSafetyPolicy;\n extra: Record<string | symbol, unknown>;\n }): void {\n const { guard, extra } = opts;\n\n if (guard === undefined) {\n return;\n }\n\n if (guard.proxy !== undefined) {\n throw getError({\n message: `[${this.name}] A guarded call cannot use guard.proxy with axios | the request would go direct and unpinned; use a NativeFetcher for a proxied call`,\n });\n }\n\n const source: Record<string, unknown> = { ...this.configured, ...extra };\n const found = Object.keys(source).filter(\n (name) =>\n source[name] !== undefined &&\n (!GUARDED_OPTIONS.has(name) || typeof source[name] === 'function'),\n );\n\n if (found.includes('baseURL') || found.includes('allowAbsoluteUrls')) {\n throw getError({\n message: `[${this.name}] A guarded call needs one absolute url | use an AxiosFetcher without baseUrl, or a NativeFetcher (found: ${found.join(', ')})`,\n });\n }\n\n if (found.length > 0) {\n throw getError({\n message: `[${this.name}] A guarded call cannot set ${found.join(', ')} | only ${[...GUARDED_OPTIONS].join(', ')} are accepted with a guard: any other option could connect to an address the guard did not vet`,\n });\n }\n\n if (source.rejectUnauthorized === false || !this.isRejectingUnauthorized) {\n throw getError({\n message: `[${this.name}] A guarded call cannot turn TLS verification off | rejectUnauthorized: false has no use on an untrusted url`,\n });\n }\n\n if (source.responseType === 'stream') {\n throw getError({\n message: `[${this.name}] A guarded call cannot ask for a stream with axios | the pinned agent is gone when the call returns and a stream is not capped; use a NativeFetcher to stream`,\n });\n }\n }\n\n protected override buildUrl(opts: { url: string; params?: Record<string, unknown> }): string {\n const { url, params } = opts;\n const query = params ? QueryStringUtility.toQueryString({ params }) : '';\n\n return query ? `${url}${url.includes('?') ? '&' : '?'}${query}` : url;\n }\n\n /** An axios body-size overflow is the cap's refusal (permanent), not a transport error the retry would repeat. */\n private refineError(opts: { error: unknown; url: string }): unknown {\n const { error, url } = opts;\n\n if (axios.isAxiosError(error) && /maxContentLength/.test(error.message)) {\n return BodyLimit.refuse({ detail: `${error.message} | url: ${url}` });\n }\n\n return error;\n }\n\n protected override async exchange(\n opts: IFetchExchangeRequest,\n ): Promise<IFetchExchange<AxiosResponse<unknown>>> {\n const {\n method,\n url,\n headers,\n body,\n signal,\n addresses,\n proxy,\n isManualRedirect,\n maxBytes,\n extra,\n } = opts;\n const { rejectUnauthorized, httpAgent, httpsAgent, ...axiosExtra } = extra;\n const props: AxiosRequestConfig = {\n ...axiosExtra,\n url: url.toString(),\n method,\n data: body,\n headers: Object.fromEntries(headers),\n signal,\n // The pipeline owns the status check, the redirects and the deadline; axios only carries the bytes.\n validateStatus: () => true,\n ...(isManualRedirect ? { maxRedirects: 0 } : {}),\n ...(maxBytes === undefined ? {} : { maxContentLength: maxBytes }),\n };\n const isPinned = addresses.length > 0 && !proxy;\n const protocol = this.getProtocol(url.toString());\n const isUnauthorizedAllowed = rejectUnauthorized === false;\n\n if (isPinned) {\n // The agent of THIS exchange: it answers the vetted addresses, keeps nothing alive, and is destroyed with the answer.\n const lookup = pinnedLookup(addresses);\n\n props.proxy = false;\n props.httpAgent = new http.Agent({ keepAlive: false, lookup });\n props.httpsAgent = new https.Agent({\n keepAlive: false,\n lookup,\n rejectUnauthorized: !isUnauthorizedAllowed && this.isRejectingUnauthorized,\n });\n } else if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was unreachable through the public seam.\n props.httpsAgent =\n httpsAgent instanceof https.Agent\n ? httpsAgent\n : rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({\n keepAlive: true,\n rejectUnauthorized: rejectUnauthorized !== false,\n });\n } else if (httpAgent instanceof http.Agent) {\n props.httpAgent = httpAgent;\n }\n\n try {\n let response: AxiosResponse<unknown>;\n\n try {\n const result = await this.worker.request(props);\n response = result;\n } catch (error) {\n throw this.refineError({ error, url: url.toString() });\n }\n\n return {\n response,\n status: response.status,\n statusText: response.statusText,\n headers: new Headers(\n Object.entries(response.headers).map(([name, value]) => [name, String(value)]),\n ),\n // axios has read the body already: nothing is left to free.\n discard: async () => undefined,\n // axios has read the body already: the answer is as it came.\n keepBody: async () => response,\n readJson: async () => response.data,\n // `maxContentLength` stopped an oversized body while it was read; the answer is as it came.\n capped: () => response,\n };\n } finally {\n if (isPinned) {\n props.httpAgent?.destroy();\n props.httpsAgent?.destroy();\n }\n }\n }\n}\n\n/** Options of `AxiosNetworkRequest`: an axios config with `baseUrl` in place of `baseURL`. */\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL' | 'headers' | 'timeout'> & {\n baseUrl?: string;\n headers?: Record<string, string>;\n /** Per attempt, in milliseconds. @default 60000 */\n timeout?: number;\n };\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n guardEngine?: IFetchGuard;\n}\n\n/** `BaseNetworkRequest` over an `AxiosFetcher`. Defaults: JSON content type and a 60000 ms `timeout`; a status outside 2xx throws a `UrlFetchError`. */\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n ...rest,\n baseURL: baseUrl,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({\n name,\n defaultConfigs,\n defaults: {\n timeout: timeout ?? 60 * 1000,\n ...opts.defaults,\n headers: FetchHeaders.withJsonDefault({ layers: [headers, opts.defaults?.headers] }),\n },\n hooks: opts.hooks,\n guardEngine: opts.guardEngine,\n }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"axios-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/axios-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common';\nimport axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse } from 'axios';\nimport http from 'node:http';\nimport https from 'node:https';\nimport { isIP } from 'node:net';\nimport { QueryStringUtility } from '../../utilities/query-string';\nimport { getError } from '@/modules/error';\nimport type { IUrlSafetyPolicy } from '@/modules/network/utilities/url-safety/common/types';\nimport { BaseNetworkRequest } from '../base-network-request.helper';\nimport type { ILogger } from '@/modules/logger/common/types';\nimport {\n AbstractNetworkFetchableHelper,\n type IFetchExchange,\n type IFetchExchangeRequest,\n type IRequestOptions,\n} from './base-fetcher';\nimport type { IFetchGuard } from './common/guard';\nimport type { IFetcherDefaults, IFetcherHooks } from './common/types';\nimport { BodyLimit } from './common/body-limit';\nimport { HttpHeaders } from './common/utilities';\n\n/**\n * The request options a guarded call accepts, besides the ones the pipeline owns. An allowlist, not a denylist: axios keeps\n * adding transport knobs (`httpVersion`, `http2Options`, ...) that connect on their own and ignore the pinned agent, so\n * anything not listed here is refused, per call and in `defaultConfigs`. Plain data only: a function runs with the axios\n * config as `this` (`transformRequest` can rewrite `url` or `socketPath`), `auth` is re-applied after the cross-origin\n * header strip, and `baseURL` makes axios combine urls, so none of them is listed. A caller sets `Authorization` through\n * `headers`, transforms the body before the call and the answer after it.\n */\nconst GUARDED_OPTIONS = new Set([\n 'withCredentials',\n 'responseType',\n 'responseEncoding',\n 'xsrfCookieName',\n 'xsrfHeaderName',\n 'withXSRFToken',\n 'maxContentLength',\n 'maxBodyLength',\n 'maxRate',\n 'decompress',\n 'transitional',\n 'rejectUnauthorized',\n]);\n\n/** The fields of an axios config the pipeline owns. */\ntype TOwnedAxiosFields =\n | 'url'\n | 'method'\n | 'params'\n | 'data'\n | 'headers'\n | 'signal'\n | 'timeout'\n | 'maxRedirects'\n | 'validateStatus';\n\n/** Request accepted by `AxiosFetcher`: an axios config where `body` is sent as the axios `data`. `rejectUnauthorized` set here overrides the instance setting for this call. */\nexport interface IAxiosRequestOptions\n extends Omit<AxiosRequestConfig, TOwnedAxiosFields>, IRequestOptions {\n url: string;\n params?: Record<string, unknown>;\n body?: Record<string, unknown>;\n /** Whether this call rejects an HTTPS server whose certificate fails verification; `false` turns verification off for this call. */\n rejectUnauthorized?: boolean;\n}\n\n/** A `lookup` for `net`/`tls` that answers the vetted addresses and nothing else: the client never resolves the name. */\nconst pinnedLookup = (addresses: string[]) => {\n const answers = addresses.map((address) => ({ address, family: isIP(address) === 6 ? 6 : 4 }));\n\n return (\n _hostname: string,\n options: unknown,\n callback: (\n error: Error | null,\n address: string | Array<{ address: string; family: number }>,\n family?: number,\n ) => void,\n ) => {\n const wantsAll =\n typeof options === 'object' && options !== null && Reflect.get(options, 'all') === true;\n\n if (wantsAll) {\n callback(null, answers);\n\n return;\n }\n\n const [first] = answers;\n callback(null, first.address, first.family);\n };\n};\n\n/** Fetcher over an axios instance (`getWorker()`): the pipeline of `AbstractNetworkFetchableHelper` with axios as the client. HTTPS calls share one keep-alive agent that verifies certificates unless `rejectUnauthorized` is `false`; an `httpsAgent` passed in the request wins - and is refused together with a `guard`, because an agent of the caller's could connect elsewhere than the vetted address. */\nexport class AxiosFetcher extends AbstractNetworkFetchableHelper<\n 'axios',\n IAxiosRequestOptions,\n // The named type, not the `axios.` NAMESPACE: the namespace form resolves only under node16\n // module resolution, and this package also emits an ESM build under `bundler` resolution.\n AxiosResponse<unknown>,\n AxiosInstance\n> {\n /**\n * One agent for the instance, not one per request. Built here so TLS verification is decided\n * ONCE, at construction, rather than per call - and so connections are actually reused: a fresh\n * agent per request forces a new TCP and TLS handshake every time (measured: 10 handshakes for 10\n * requests, versus 1). A guarded call never uses it: it gets an agent of its own that answers one vetted address and is dropped with the call, so no pin outlives it.\n */\n private readonly httpsAgent: https.Agent;\n private readonly isRejectingUnauthorized: boolean;\n /** What the caller put in `defaultConfigs`: a guarded call checks it like its own options. */\n private readonly configured: Record<string, unknown>;\n\n constructor(opts: {\n name: string;\n defaultConfigs?: AxiosRequestConfig;\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n /** The server half of the url guard (`UrlGuard`); a call that passes `guard` needs it. */\n guardEngine?: IFetchGuard;\n logger?: ILogger;\n /**\n * Whether this instance rejects an HTTPS server whose certificate fails verification.\n * `false` turns verification off.\n * @default true\n */\n rejectUnauthorized?: boolean;\n }) {\n super({\n name: opts.name,\n variant: 'axios',\n defaults: opts.defaults,\n hooks: opts.hooks,\n guardEngine: opts.guardEngine,\n });\n opts?.logger?.info('Creating new network request worker instance! Name: %s', this.name);\n\n this.isRejectingUnauthorized = opts.rejectUnauthorized ?? true;\n this.httpsAgent = new https.Agent({\n keepAlive: true,\n rejectUnauthorized: this.isRejectingUnauthorized,\n });\n\n this.configured = { ...opts.defaultConfigs };\n this.worker = axios.create({ ...opts.defaultConfigs });\n }\n\n protected override assertCallSupported(opts: {\n guard?: IUrlSafetyPolicy;\n extra: Record<string | symbol, unknown>;\n }): void {\n const { guard, extra } = opts;\n\n if (guard === undefined) {\n return;\n }\n\n if (guard.proxy !== undefined) {\n throw getError({\n message: `[${this.name}] A guarded call cannot use guard.proxy with axios | the request would go direct and unpinned; use a NativeFetcher for a proxied call`,\n });\n }\n\n const source: Record<string, unknown> = { ...this.configured, ...extra };\n const found = Object.keys(source).filter(\n (name) =>\n source[name] !== undefined &&\n (!GUARDED_OPTIONS.has(name) || typeof source[name] === 'function'),\n );\n\n if (found.includes('baseURL') || found.includes('allowAbsoluteUrls')) {\n throw getError({\n message: `[${this.name}] A guarded call needs one absolute url | use an AxiosFetcher without baseUrl, or a NativeFetcher (found: ${found.join(', ')})`,\n });\n }\n\n if (found.length > 0) {\n throw getError({\n message: `[${this.name}] A guarded call cannot set ${found.join(', ')} | only ${[...GUARDED_OPTIONS].join(', ')} are accepted with a guard: any other option could connect to an address the guard did not vet`,\n });\n }\n\n if (source.rejectUnauthorized === false || !this.isRejectingUnauthorized) {\n throw getError({\n message: `[${this.name}] A guarded call cannot turn TLS verification off | rejectUnauthorized: false has no use on an untrusted url`,\n });\n }\n\n if (source.responseType === 'stream') {\n throw getError({\n message: `[${this.name}] A guarded call cannot ask for a stream with axios | the pinned agent is gone when the call returns and a stream is not capped; use a NativeFetcher to stream`,\n });\n }\n }\n\n protected override buildUrl(opts: { url: string; params?: Record<string, unknown> }): string {\n const { url, params } = opts;\n const query = params ? QueryStringUtility.toQueryString({ params }) : '';\n\n return query ? `${url}${url.includes('?') ? '&' : '?'}${query}` : url;\n }\n\n /** An axios body-size overflow is the cap's refusal (permanent), not a transport error the retry would repeat. */\n private refineError(opts: { error: unknown; url: string }): unknown {\n const { error, url } = opts;\n\n if (axios.isAxiosError(error) && /maxContentLength/.test(error.message)) {\n return BodyLimit.refuse({ detail: `${error.message} | url: ${url}` });\n }\n\n return error;\n }\n\n protected override async exchange(\n opts: IFetchExchangeRequest,\n ): Promise<IFetchExchange<AxiosResponse<unknown>>> {\n const {\n method,\n url,\n headers,\n body,\n signal,\n addresses,\n proxy,\n isManualRedirect,\n maxBytes,\n extra,\n } = opts;\n const { rejectUnauthorized, httpAgent, httpsAgent, ...axiosExtra } = extra;\n const props: AxiosRequestConfig = {\n ...axiosExtra,\n url: url.toString(),\n method,\n data: body,\n headers: Object.fromEntries(headers),\n signal,\n // The pipeline owns the status check, the redirects and the deadline; axios only carries the bytes.\n validateStatus: () => true,\n ...(isManualRedirect ? { maxRedirects: 0 } : {}),\n ...(maxBytes === undefined ? {} : { maxContentLength: maxBytes }),\n };\n const isPinned = addresses.length > 0 && !proxy;\n const protocol = this.getProtocol(url.toString());\n const isUnauthorizedAllowed = rejectUnauthorized === false;\n\n if (isPinned) {\n // The agent of THIS exchange: it answers the vetted addresses, keeps nothing alive, and is destroyed with the answer.\n const lookup = pinnedLookup(addresses);\n\n props.proxy = false;\n props.httpAgent = new http.Agent({ keepAlive: false, lookup });\n props.httpsAgent = new https.Agent({\n keepAlive: false,\n lookup,\n rejectUnauthorized: !isUnauthorizedAllowed && this.isRejectingUnauthorized,\n });\n } else if (protocol === HTTP.Protocols.HTTPS) {\n // A caller's own agent WINS. The previous code assigned after the `...rest` spread, so a hardened agent - custom CA, pinning, mTLS - was overwritten and the secure path was unreachable through the public seam.\n props.httpsAgent =\n httpsAgent instanceof https.Agent\n ? httpsAgent\n : rejectUnauthorized === undefined\n ? this.httpsAgent\n : new https.Agent({\n keepAlive: true,\n rejectUnauthorized: rejectUnauthorized !== false,\n });\n } else if (httpAgent instanceof http.Agent) {\n props.httpAgent = httpAgent;\n }\n\n try {\n let response: AxiosResponse<unknown>;\n\n try {\n const result = await this.worker.request(props);\n response = result;\n } catch (error) {\n throw this.refineError({ error, url: url.toString() });\n }\n\n return {\n response,\n status: response.status,\n statusText: response.statusText,\n headers: new Headers(\n Object.entries(response.headers).map(([name, value]) => [name, String(value)]),\n ),\n // axios has read the body already: nothing is left to free.\n discard: async () => undefined,\n // axios has read the body already: the answer is as it came.\n keepBody: async () => response,\n readJson: async () => response.data,\n // `maxContentLength` stopped an oversized body while it was read; the answer is as it came.\n capped: () => response,\n };\n } finally {\n if (isPinned) {\n props.httpAgent?.destroy();\n props.httpsAgent?.destroy();\n }\n }\n }\n}\n\n/** Options of `AxiosNetworkRequest`: an axios config with `baseUrl` in place of `baseURL`. */\nexport interface IAxiosNetworkRequestOptions {\n name: string;\n networkOptions: Omit<AxiosRequestConfig, 'baseURL' | 'headers' | 'timeout'> & {\n baseUrl?: string;\n headers?: Record<string, string>;\n /** Per attempt, in milliseconds. @default 60000 */\n timeout?: number;\n };\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n guardEngine?: IFetchGuard;\n}\n\n/** `BaseNetworkRequest` over an `AxiosFetcher`. Defaults: JSON content type and a 60000 ms `timeout`; a status outside 2xx throws a `UrlFetchError`. */\nexport class AxiosNetworkRequest extends BaseNetworkRequest<'axios'> {\n constructor(opts: IAxiosNetworkRequestOptions) {\n const { name, networkOptions } = opts;\n const { headers, baseUrl, timeout, ...rest } = networkOptions;\n\n const defaultConfigs: AxiosRequestConfig = {\n withCredentials: true,\n ...rest,\n baseURL: baseUrl,\n };\n\n super({\n name,\n baseUrl,\n fetcher: new AxiosFetcher({\n name,\n defaultConfigs,\n defaults: {\n timeout: timeout ?? 60 * 1000,\n ...opts.defaults,\n headers: HttpHeaders.withJsonDefault({ layers: [headers, opts.defaults?.headers] }),\n },\n hooks: opts.hooks,\n guardEngine: opts.guardEngine,\n }),\n });\n }\n}\n"]}
@@ -4,7 +4,7 @@ import type { IUrlSafetyPolicy } from '../../utilities/url-safety/common/types.j
4
4
  import type { z } from 'zod';
5
5
  import { type TFetcherVariant } from '../common/index.js';
6
6
  import type { IFetchGuard } from './common/guard.js';
7
- import type { IFetchParsed, IFetchRetryOptions, IFetcherDefaults, IFetcherHooks, TFetchHeaders } from './common/types.js';
7
+ import type { IFetchParsed, IHttpRetryOptions, IFetcherDefaults, IFetcherHooks, THttpHeaders } from './common/types.js';
8
8
  /** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */
9
9
  export type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;
10
10
  /** Options every fetcher accepts. `timeout` is in milliseconds and counts per attempt; other keys pass through to the underlying client. */
@@ -13,12 +13,12 @@ export interface IRequestOptions {
13
13
  method?: THttpMethod | (string & Record<never, never>);
14
14
  params?: Record<string, unknown>;
15
15
  /** Merged over the fetcher's default headers, header by header; a `null` or `undefined` value removes a default. */
16
- headers?: TFetchHeaders;
16
+ headers?: THttpHeaders;
17
17
  body?: unknown;
18
18
  signal?: AbortSignal;
19
19
  timeout?: number;
20
20
  /** Presence turns retrying on; replaces the fetcher's default retry whole. `{ maxAttempts: 1 }` stops it. */
21
- retry?: IFetchRetryOptions;
21
+ retry?: IHttpRetryOptions;
22
22
  /** Presence turns the url guard on (`{}` is the default policy). A fetcher default guard can be replaced here, never removed. */
23
23
  guard?: IUrlSafetyPolicy;
24
24
  /** The body is cut off, and the call fails, once it crosses this many bytes. */
@@ -7,7 +7,7 @@ import { RetryHelper } from '../../../retry/helper.js';
7
7
  import { BodyLimit } from './common/body-limit.js';
8
8
  import { FetchSchemaError } from './common/errors.js';
9
9
  import { FetchRequestContext } from './common/request-context.js';
10
- import { FetchHeaders, FetchRedirects, FetchRetry, FetchStatus } from './common/utilities.js';
10
+ import { HttpHeaders, HttpRedirects, HttpRetry, HttpStatus } from './common/utilities.js';
11
11
  /** The attempts a call makes when its `retry` names no `maxAttempts` (the retry helper's own default). */
12
12
  const DEFAULT_MAX_ATTEMPTS = 3;
13
13
  /**
@@ -79,7 +79,7 @@ export class AbstractNetworkFetchableHelper {
79
79
  return {
80
80
  method,
81
81
  url: this.buildUrl({ url: request.url, params: request.params }),
82
- headers: FetchHeaders.merge({ layers: [this.defaults.headers, request.headers] }),
82
+ headers: HttpHeaders.merge({ layers: [this.defaults.headers, request.headers] }),
83
83
  body: request.body,
84
84
  signal: request.signal,
85
85
  timeout: request.timeout,
@@ -92,7 +92,7 @@ export class AbstractNetworkFetchableHelper {
92
92
  this.defaults.maxBytes ??
93
93
  (guard === undefined ? undefined : UrlSafetyDefaults.MAX_BYTES),
94
94
  maxRedirects: request.maxRedirects ?? guard?.maxRedirects,
95
- acceptStatus: FetchStatus.toPredicate({ accept: request.acceptStatus }),
95
+ acceptStatus: HttpStatus.toPredicate({ accept: request.acceptStatus }),
96
96
  schema: request.schema,
97
97
  extra,
98
98
  };
@@ -183,7 +183,7 @@ export class AbstractNetworkFetchableHelper {
183
183
  extra: call.extra,
184
184
  }, logger);
185
185
  exchange = sent;
186
- if (!isManual || !FetchRedirects.isRedirect({ status: exchange.status })) {
186
+ if (!isManual || !HttpRedirects.isRedirect({ status: exchange.status })) {
187
187
  break;
188
188
  }
189
189
  const location = exchange.headers.get(HTTP.Headers.LOCATION);
@@ -224,10 +224,10 @@ export class AbstractNetworkFetchableHelper {
224
224
  response: exchange.response,
225
225
  });
226
226
  const isSameOrigin = next.origin === target.origin;
227
- if (FetchRedirects.becomesGet({ status: exchange.status, method })) {
227
+ if (HttpRedirects.becomesGet({ status: exchange.status, method })) {
228
228
  method = 'GET';
229
229
  body = undefined;
230
- headers = FetchHeaders.without({ headers, names: FetchRedirects.BODY_HEADERS });
230
+ headers = HttpHeaders.without({ headers, names: HttpRedirects.BODY_HEADERS });
231
231
  }
232
232
  else if (body !== undefined && !isSameOrigin) {
233
233
  throw getError({
@@ -242,7 +242,7 @@ export class AbstractNetworkFetchableHelper {
242
242
  });
243
243
  }
244
244
  if (!isSameOrigin) {
245
- headers = FetchHeaders.only({ headers, names: FetchRedirects.CROSS_ORIGIN_HEADERS });
245
+ headers = HttpHeaders.only({ headers, names: HttpRedirects.CROSS_ORIGIN_HEADERS });
246
246
  }
247
247
  target = next;
248
248
  }
@@ -397,18 +397,18 @@ export class AbstractNetworkFetchableHelper {
397
397
  backoff,
398
398
  shouldRetry: async (context) => {
399
399
  // A server that asks for a longer wait than the backoff allows ends the retries: the last error is the answer.
400
- const asked = FetchRetry.readRetryAfterMs({ error: context.error });
400
+ const asked = HttpRetry.readRetryAfterMs({ error: context.error });
401
401
  if (asked !== undefined &&
402
- asked > (backoff?.maxDelayMs ?? FetchRetry.DEFAULT_MAX_DELAY_MS)) {
402
+ asked > (backoff?.maxDelayMs ?? HttpRetry.DEFAULT_MAX_DELAY_MS)) {
403
403
  return false;
404
404
  }
405
405
  if (shouldRetry) {
406
406
  const isAllowed = await shouldRetry(context);
407
407
  return isAllowed;
408
408
  }
409
- return FetchRetry.isRetryable({ error: context.error, signal: call.signal });
409
+ return HttpRetry.isRetryable({ error: context.error, signal: call.signal });
410
410
  },
411
- getDelayMs: ({ error }) => FetchRetry.readRetryAfterMs({ error }),
411
+ getDelayMs: ({ error }) => HttpRetry.readRetryAfterMs({ error }),
412
412
  onRetry,
413
413
  execution: ({ attempt }) => run(attempt),
414
414
  });
@@ -1 +1 @@
1
- {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { RedactUtility } from '@/common/redact';\nimport { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { UrlSafetyDefaults } from '@/modules/network/utilities/url-safety/common/constants';\nimport {\n UrlFetchError,\n UrlSafetyErrors,\n} from '@/modules/network/utilities/url-safety/common/errors';\nimport type { IUrlSafetyPolicy } from '@/modules/network/utilities/url-safety/common/types';\nimport { RetryHelper } from '@/modules/retry/helper';\nimport type { z } from 'zod';\nimport { type TFetcherVariant } from '../common';\nimport { BodyLimit } from './common/body-limit';\nimport { FetchSchemaError, type IFetchSchemaIssue } from './common/errors';\nimport type { IFetchGuard, IFetchGuardHop, IFetchGuardRoute } from './common/guard';\nimport { FetchRequestContext } from './common/request-context';\nimport type {\n IFetchParsed,\n IFetchRetryOptions,\n IFetcherDefaults,\n IFetcherHooks,\n TFetchHeaders,\n} from './common/types';\nimport { FetchHeaders, FetchRedirects, FetchRetry, FetchStatus } from './common/utilities';\n\n/** The attempts a call makes when its `retry` names no `maxAttempts` (the retry helper's own default). */\nconst DEFAULT_MAX_ATTEMPTS = 3;\n\n/** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */\nexport type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;\n\n/** Options every fetcher accepts. `timeout` is in milliseconds and counts per attempt; other keys pass through to the underlying client. */\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod | (string & Record<never, never>);\n params?: Record<string, unknown>;\n /** Merged over the fetcher's default headers, header by header; a `null` or `undefined` value removes a default. */\n headers?: TFetchHeaders;\n body?: unknown;\n signal?: AbortSignal;\n timeout?: number;\n /** Presence turns retrying on; replaces the fetcher's default retry whole. `{ maxAttempts: 1 }` stops it. */\n retry?: IFetchRetryOptions;\n /** Presence turns the url guard on (`{}` is the default policy). A fetcher default guard can be replaced here, never removed. */\n guard?: IUrlSafetyPolicy;\n /** The body is cut off, and the call fails, once it crosses this many bytes. */\n maxBytes?: number;\n /** Redirects followed by hand; `0` hands back the 3xx as a `UrlFetchError`. Unset: the client follows (a guard follows 3). */\n maxRedirects?: number;\n /**\n * Which statuses are an answer; any other throws a `UrlFetchError`. A list ADDS to 2xx (`[HTTP.ResultCodes.RS_4.NotFound]`\n * is 2xx or 404); a function decides alone. Unset, only 2xx.\n */\n acceptStatus?: ReadonlyArray<number> | ((status: number) => boolean);\n /** The body is parsed with it, and the call answers `{ data, status, headers, response }`. */\n schema?: z.ZodType;\n [extra: symbol | string]: unknown;\n}\n\n/** The answer one exchange with the server gave, in the terms the pipeline needs, whichever client made it. */\nexport interface IFetchExchange<RS> {\n response: RS;\n status: number;\n statusText: string;\n headers: Headers;\n /** Frees the socket of a body nobody will read (a redirect). */\n discard(): Promise<void>;\n /** The same answer with at most `maxBytes` of its body kept readable, the rest released: what a refused status hands back. */\n keepBody(opts: { maxBytes: number }): Promise<RS>;\n /** The body as JSON; throws a `SyntaxError` when it is not. */\n readJson(opts: { maxBytes?: number }): Promise<unknown>;\n /** The same answer with its body cut off at `maxBytes`. */\n capped(opts: { maxBytes: number }): RS;\n}\n\n/** One request to the network, after the hooks and the guard have had their say. */\nexport interface IFetchExchangeRequest {\n method: string;\n url: URL;\n headers: Headers;\n body: unknown;\n signal?: AbortSignal;\n /** The addresses the guard vetted: connect to these and no other. Empty: connect as the client would. */\n addresses: string[];\n /** The host name the certificate is verified for when the connection goes to an address; unset for a literal address or a plain http url. */\n tlsServerName?: string;\n /** A proxy the guard policy chose. */\n proxy?: string;\n /** Do not follow a redirect: the pipeline reads the 3xx and walks it. */\n isManualRedirect: boolean;\n maxBytes?: number;\n /** What the call carried that is the client's own (`credentials`, `httpsAgent`, ...). */\n extra: Record<string | symbol, unknown>;\n}\n\n/** Contract of an HTTP fetcher: `send` takes the method from the options, the verb methods fix it, and `getWorker` returns the underlying client (`W`). Without a `schema` a call answers the raw response `RS`; with one, `IFetchParsed`. */\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n send<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n get(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n get<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n post(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n post<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n put(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n put<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n patch(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n patch<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n delete(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n delete<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n query(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n query<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** What one call settled to, before the verb overloads give it their types. */\ntype TFetchSettled<RS> = RS | IFetchParsed<unknown, RS>;\n\n/** A call after the fetcher's defaults are applied. */\ninterface IResolvedCall {\n method: string;\n url: string;\n headers: Headers;\n body: unknown;\n signal?: AbortSignal;\n /** The call's own `timeout`. When unset, each attempt takes the guard policy's, then `defaultTimeout`, then (guarded) the 10 s default. */\n timeout?: number;\n defaultTimeout?: number;\n retry?: IFetchRetryOptions;\n guard?: IUrlSafetyPolicy;\n maxBytes?: number;\n maxRedirects?: number;\n acceptStatus: (status: number) => boolean;\n schema?: z.ZodType;\n extra: Record<string | symbol, unknown>;\n}\n\n/**\n * The pipeline every fetcher shares: defaults, hooks, the url guard, redirects, the status check, the body cap, the\n * schema, retries. A concrete fetcher supplies the exchange with one client (`exchange`) and the shape of its urls and\n * bodies; `W` defaults to `unknown` so this stays free of `axios`.\n */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n protected defaults: IFetcherDefaults;\n protected hooks: IFetcherHooks;\n protected guardEngine?: IFetchGuard;\n\n constructor(opts: {\n name: string;\n variant: V;\n worker?: W;\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n /** The server half of the url guard (`UrlGuard`); a call that passes `guard` needs it. */\n guardEngine?: IFetchGuard;\n }) {\n this.name = opts.name;\n this.variant = opts.variant;\n this.defaults = opts.defaults ?? {};\n this.hooks = opts.hooks ?? {};\n this.guardEngine = opts.guardEngine;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n /** One exchange with the server: the request as the pipeline decided it, the answer in the pipeline's terms. */\n protected abstract exchange(\n opts: IFetchExchangeRequest,\n logger?: TFetcherLogger,\n ): Promise<IFetchExchange<RS>>;\n\n /** The url of a call with its `params` written into the query string. */\n protected abstract buildUrl(opts: { url: string; params?: Record<string, unknown> }): string;\n\n /** Whether `body` can be sent again to a redirect target. */\n protected isReplayable(opts: { body: unknown }): boolean {\n const { body } = opts;\n\n return (\n body === undefined ||\n body === null ||\n typeof body === 'string' ||\n ArrayBuffer.isView(body) ||\n body instanceof ArrayBuffer ||\n (typeof Blob !== 'undefined' && body instanceof Blob) ||\n (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams) ||\n Array.isArray(body) ||\n (typeof body === 'object' && Object.getPrototypeOf(body) === Object.prototype)\n );\n }\n\n /** What the request log says about a body: its size or its presence, never its content. */\n protected describeBody(opts: { body: unknown }): string | undefined {\n const { body } = opts;\n\n if (body === undefined || body === null) {\n return undefined;\n }\n\n return typeof body === 'string' ? `[body ${body.length} chars]` : '[body]';\n }\n\n /** Refuses a call the client cannot honour; `AxiosFetcher` refuses a guard it cannot pin. */\n protected assertCallSupported(_opts: {\n guard?: IUrlSafetyPolicy;\n extra: Record<string | symbol, unknown>;\n }): void {\n // Every call is supported by default.\n }\n\n /** What each attempt needs to know of the call. */\n private resolveCall(opts: {\n request: IRequestOptions;\n extra: Record<string | symbol, unknown>;\n }): IResolvedCall {\n const { request, extra } = opts;\n const guard = request.guard ?? this.defaults.guard;\n\n if (guard !== undefined && this.guardEngine === undefined) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.name}] A call with a guard needs the guard engine | pass guardEngine: UrlGuard (from @venizia/ignis-helpers) to the fetcher`,\n });\n }\n\n this.assertCallSupported({ guard, extra });\n\n const method = (request.method ?? HTTP.Methods.GET).toUpperCase();\n\n if (request.body !== undefined && (method === 'GET' || method === 'HEAD')) {\n throw getError({\n message: `[${this.name}] A ${method} request cannot carry a body | url: ${request.url}`,\n });\n }\n\n const retry = request.retry ?? this.defaults.retry;\n\n if (\n retry !== undefined &&\n (retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS) > 1 &&\n !this.isReplayable({ body: request.body })\n ) {\n throw getError({\n message: `[${this.name}] A call with retry cannot carry a body that is sent once (a stream, a FormData) unless maxAttempts is 1 | url: ${request.url}`,\n });\n }\n\n return {\n method,\n url: this.buildUrl({ url: request.url, params: request.params }),\n headers: FetchHeaders.merge({ layers: [this.defaults.headers, request.headers] }),\n body: request.body,\n signal: request.signal,\n timeout: request.timeout,\n defaultTimeout: this.defaults.timeout,\n retry,\n guard,\n // A guarded call always caps what it reads: the fetcher reads the body itself on the schema path.\n maxBytes:\n request.maxBytes ??\n guard?.maxBytes ??\n this.defaults.maxBytes ??\n (guard === undefined ? undefined : UrlSafetyDefaults.MAX_BYTES),\n maxRedirects: request.maxRedirects ?? guard?.maxRedirects,\n acceptStatus: FetchStatus.toPredicate({ accept: request.acceptStatus }),\n schema: request.schema,\n extra,\n };\n }\n\n /** `AbortSignal` of one attempt: the caller's own, and the attempt's deadline. */\n private attemptSignal(opts: {\n call: IResolvedCall;\n timeout: number | undefined;\n }): AbortSignal | undefined {\n const { call, timeout } = opts;\n const signals: AbortSignal[] = [];\n\n if (call.signal) {\n signals.push(call.signal);\n }\n\n if (timeout !== undefined && timeout > 0) {\n signals.push(AbortSignal.timeout(timeout));\n }\n\n if (signals.length === 0) {\n return undefined;\n }\n\n return signals.length === 1 ? signals[0] : AbortSignal.any(signals);\n }\n\n /** The body of a refused status or a mismatch is gone; the typed error carries what is left of the answer. */\n private async refuseStatus<R>(opts: {\n exchange: IFetchExchange<R>;\n url: string;\n }): Promise<UrlFetchError<R>> {\n const { exchange, url } = opts;\n const response = await exchange.keepBody({ maxBytes: UrlFetchError.MAX_BODY_BYTES });\n\n return new UrlFetchError<R>({\n message: `[fetch] Request failed | status: ${exchange.status} | url: ${url}`,\n status: exchange.status,\n url,\n headers: exchange.headers,\n response,\n });\n }\n\n /** The guard's verdict on one hop: the url to send and the addresses to pin; with no guard, the target as it is. */\n private async vetTarget(opts: {\n route: IFetchGuardRoute | undefined;\n target: URL;\n signal: AbortSignal | undefined;\n }): Promise<IFetchGuardHop> {\n const { route, target, signal } = opts;\n\n if (!route) {\n return { url: target, addresses: [] };\n }\n\n const vetted = await route.vet({ url: target.toString(), signal });\n\n return vetted;\n }\n\n /** One attempt: hook, guard, exchange (redirects walked by hand when asked), status, cap, schema. */\n private async runAttempt(opts: {\n call: IResolvedCall;\n attempt: number;\n logger?: TFetcherLogger;\n onRequest: (request: FetchRequestContext) => void;\n }): Promise<TFetchSettled<RS>> {\n const { call, attempt, logger } = opts;\n const startedAt = Date.now();\n const request = new FetchRequestContext({\n method: call.method,\n url: call.url,\n headers: new Headers(call.headers),\n attempt,\n });\n\n opts.onRequest(request);\n await this.hooks.onRequest?.(request);\n\n const route: IFetchGuardRoute | undefined =\n call.guard === undefined ? undefined : this.guardEngine?.createRoute({ policy: call.guard });\n // The call's own, else the guard policy's, else the fetcher's default; a guarded call always has one.\n const timeout =\n call.timeout ??\n route?.timeoutMs ??\n call.defaultTimeout ??\n (route === undefined ? undefined : UrlSafetyDefaults.TIMEOUT_MILLISECONDS);\n const signal = this.attemptSignal({ call, timeout });\n const isManual = route !== undefined || call.maxRedirects !== undefined;\n const maxRedirects = call.maxRedirects ?? UrlSafetyDefaults.MAX_REDIRECTS;\n\n let method = call.method;\n let body = call.body;\n let headers = request.headers;\n let target = this.parseUrl({ url: request.url });\n let exchange: IFetchExchange<RS> | undefined;\n\n logger?.debug(\n '[%s] URL: %s | Props: %s | Timeout: %s',\n 'send',\n request.url,\n RedactUtility.redactSecrets({\n value: {\n method,\n headers: Object.fromEntries(headers),\n body: this.describeBody({ body }),\n },\n }),\n timeout,\n );\n\n try {\n for (let hop = 0; hop <= (isManual ? maxRedirects : 0); hop += 1) {\n const vetted = await this.vetTarget({ route, target, signal });\n\n const sent = await this.exchange(\n {\n method,\n url: vetted.url,\n headers,\n body,\n signal,\n addresses: vetted.addresses,\n tlsServerName: vetted.tlsServerName,\n proxy: call.guard?.proxy,\n isManualRedirect: isManual,\n maxBytes: call.maxBytes,\n extra: call.extra,\n },\n logger,\n );\n\n exchange = sent;\n\n if (!isManual || !FetchRedirects.isRedirect({ status: exchange.status })) {\n break;\n }\n\n const location = exchange.headers.get(HTTP.Headers.LOCATION);\n\n // No redirect budget: the 3xx is the answer, unless the caller accepts that status as one.\n if (hop === maxRedirects && maxRedirects === 0) {\n if (call.acceptStatus(exchange.status)) {\n break;\n }\n\n await exchange.discard();\n throw new UrlFetchError<RS>({\n message: `[fetch] Redirect not followed | status: ${exchange.status} | maxRedirects: 0 | url: ${request.url}`,\n status: exchange.status,\n url: request.url,\n headers: exchange.headers,\n response: exchange.response,\n location: location ?? undefined,\n });\n }\n\n await exchange.discard();\n\n if (!location) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect carried no location | url: ${request.url}`,\n });\n }\n\n if (hop === maxRedirects) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Too many redirects | max: ${maxRedirects} | url: ${request.url}`,\n });\n }\n\n const next = this.resolveLocation({\n location,\n from: target,\n status: exchange.status,\n url: request.url,\n headers: exchange.headers,\n response: exchange.response,\n });\n const isSameOrigin = next.origin === target.origin;\n\n if (FetchRedirects.becomesGet({ status: exchange.status, method })) {\n method = 'GET';\n body = undefined;\n headers = FetchHeaders.without({ headers, names: FetchRedirects.BODY_HEADERS });\n } else if (body !== undefined && !isSameOrigin) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect would replay the request body to another origin | from: ${target.origin} | to: ${next.origin}`,\n });\n } else if (body !== undefined && !this.isReplayable({ body })) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect would replay a body that cannot be sent twice | url: ${request.url}`,\n });\n }\n\n if (!isSameOrigin) {\n headers = FetchHeaders.only({ headers, names: FetchRedirects.CROSS_ORIGIN_HEADERS });\n }\n\n target = next;\n }\n } catch (error) {\n // A deadline or an abort wins over whatever the client made of it: a caller tells a timeout from its own cancel.\n if (signal?.aborted) {\n throw signal.reason;\n }\n\n throw error;\n }\n\n if (exchange === undefined) {\n throw getError({ message: `[fetch] No exchange was made | url: ${request.url}` });\n }\n\n try {\n await this.hooks.onResponse?.({\n request,\n status: exchange.status,\n headers: exchange.headers,\n durationMs: Date.now() - startedAt,\n });\n } catch (hookError) {\n // The hook failed the call; the body that was never read is released before the error goes on.\n await exchange.discard();\n throw hookError;\n }\n\n if (!call.acceptStatus(exchange.status)) {\n const refusal = await this.refuseStatus({ exchange, url: request.url });\n\n throw refusal;\n }\n\n return this.finish({ call, exchange, url: request.url });\n }\n\n /** The cap and the schema, once the status is accepted. */\n private async finish(opts: {\n call: IResolvedCall;\n exchange: IFetchExchange<RS>;\n url: string;\n }): Promise<TFetchSettled<RS>> {\n const { call, exchange, url } = opts;\n const { maxBytes, schema } = call;\n\n if (maxBytes !== undefined) {\n const declaredLength = BodyLimit.readDeclaredLength({ headers: exchange.headers });\n\n if (declaredLength > maxBytes) {\n await exchange.discard();\n throw BodyLimit.refuse({ detail: `declared: ${declaredLength} | max: ${maxBytes}` });\n }\n }\n\n if (schema === undefined) {\n return maxBytes === undefined ? exchange.response : exchange.capped({ maxBytes });\n }\n\n let value: unknown;\n\n try {\n const parsed = await exchange.readJson({ maxBytes });\n\n value = parsed;\n } catch (error) {\n if (!(error instanceof SyntaxError)) {\n throw error;\n }\n\n throw new FetchSchemaError({\n status: exchange.status,\n url,\n issues: [{ path: [], code: 'invalid_json' }],\n });\n }\n\n const parsed = schema.safeParse(value);\n\n if (!parsed.success) {\n const issues: IFetchSchemaIssue[] = parsed.error.issues.map((issue) => ({\n path: issue.path.map((part) => (typeof part === 'symbol' ? String(part) : part)),\n code: issue.code,\n }));\n\n throw new FetchSchemaError({ status: exchange.status, url, issues });\n }\n\n return {\n data: parsed.data,\n status: exchange.status,\n headers: exchange.headers,\n response: exchange.response,\n };\n }\n\n private parseUrl(opts: { url: string }): URL {\n try {\n return new URL(opts.url);\n // eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed refusal that names the url\n } catch {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Malformed url | url: ${opts.url}`,\n });\n }\n }\n\n /** The absolute target of a redirect; a `Location` that is not a url is a typed error, never a bare `TypeError`. */\n private resolveLocation(opts: {\n location: string;\n from: URL;\n status: number;\n url: string;\n headers: Headers;\n response: RS;\n }): URL {\n try {\n return new URL(opts.location, opts.from);\n // eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed error that carries the raw Location\n } catch {\n throw new UrlFetchError<RS>({\n message: `[fetch] Redirect location is not a valid url | status: ${opts.status} | url: ${opts.url}`,\n status: opts.status,\n url: opts.url,\n headers: opts.headers,\n response: opts.response,\n location: opts.location,\n });\n }\n }\n\n /** The whole call: retries around the attempts, and the one `onError` for the failure that ends it. */\n protected async perform(\n opts: RQ & { schema?: z.ZodType },\n logger?: TFetcherLogger,\n ): Promise<TFetchSettled<RS>> {\n const {\n url,\n method,\n params,\n headers,\n body,\n signal,\n timeout,\n retry,\n guard,\n maxBytes,\n maxRedirects,\n acceptStatus,\n schema,\n ...extra\n } = opts;\n const call = this.resolveCall({\n request: {\n url,\n method,\n params,\n headers,\n body,\n signal,\n timeout,\n retry,\n guard,\n maxBytes,\n maxRedirects,\n acceptStatus,\n schema,\n },\n extra,\n });\n let lastRequest: FetchRequestContext | undefined;\n let lastAttempt = 0;\n\n const run = (attempt: number) => {\n lastAttempt = attempt;\n\n return this.runAttempt({\n call,\n attempt,\n logger,\n onRequest: (request) => {\n lastRequest = request;\n },\n });\n };\n\n try {\n if (call.retry === undefined) {\n const single = await run(1);\n\n return single;\n }\n\n const { maxAttempts, maxTotalMs, backoff, shouldRetry, onRetry } = call.retry;\n\n const retried = await RetryHelper.executeWithRetry({\n operation: `${this.name}.${call.method}`,\n signal: call.signal,\n maxAttempts,\n maxTotalMs,\n backoff,\n shouldRetry: async (context) => {\n // A server that asks for a longer wait than the backoff allows ends the retries: the last error is the answer.\n const asked = FetchRetry.readRetryAfterMs({ error: context.error });\n\n if (\n asked !== undefined &&\n asked > (backoff?.maxDelayMs ?? FetchRetry.DEFAULT_MAX_DELAY_MS)\n ) {\n return false;\n }\n\n if (shouldRetry) {\n const isAllowed = await shouldRetry(context);\n\n return isAllowed;\n }\n\n return FetchRetry.isRetryable({ error: context.error, signal: call.signal });\n },\n getDelayMs: ({ error }) => FetchRetry.readRetryAfterMs({ error }),\n onRetry,\n execution: ({ attempt }) => run(attempt),\n });\n\n return retried;\n } catch (caught) {\n // The retry helper reports its own abort in its own words; the caller gets the reason it aborted with.\n const error = call.signal?.aborted ? call.signal.reason : caught;\n\n await this.hooks.onError?.({\n request:\n lastRequest ??\n new FetchRequestContext({\n method: call.method,\n url: call.url,\n headers: new Headers(call.headers),\n attempt: lastAttempt,\n }),\n error,\n attempt: lastAttempt,\n });\n\n throw error;\n }\n }\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n send(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n send<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n send(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform(opts, logger);\n }\n\n get(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n get<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n get(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n post<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n post(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n put<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n put(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n patch<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n patch(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n delete<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n delete(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n query<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n query(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}
1
+ {"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAC;AAC5F,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,sDAAsD,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEvF,0GAA0G;AAC1G,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAgJ/B;;;;GAIG;AACH,MAAM,OAAgB,8BAA8B;IAalD,YAAY,IAQX;QACC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAWD,6DAA6D;IACnD,YAAY,CAAC,IAAuB;QAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,OAAO,CACL,IAAI,KAAK,SAAS;YAClB,IAAI,KAAK,IAAI;YACb,OAAO,IAAI,KAAK,QAAQ;YACxB,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;YACxB,IAAI,YAAY,WAAW;YAC3B,CAAC,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,CAAC;YACrD,CAAC,OAAO,eAAe,KAAK,WAAW,IAAI,IAAI,YAAY,eAAe,CAAC;YAC3E,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,CAC/E,CAAC;IACJ,CAAC;IAED,2FAA2F;IACjF,YAAY,CAAC,IAAuB;QAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,CAAC;IAED,6FAA6F;IACnF,mBAAmB,CAAC,KAG7B;QACC,sCAAsC;IACxC,CAAC;IAED,mDAAmD;IAC3C,WAAW,CAAC,IAGnB;QACC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEnD,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC1D,MAAM,QAAQ,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,wHAAwH;aAC/I,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAElE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,OAAO,MAAM,uCAAuC,OAAO,CAAC,GAAG,EAAE;aACxF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEnD,IACE,KAAK,KAAK,SAAS;YACnB,CAAC,KAAK,CAAC,WAAW,IAAI,oBAAoB,CAAC,GAAG,CAAC;YAC/C,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAC1C,CAAC;YACD,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,mHAAmH,OAAO,CAAC,GAAG,EAAE;aACvJ,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM;YACN,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YAChE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAChF,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YACrC,KAAK;YACL,KAAK;YACL,kGAAkG;YAClG,QAAQ,EACN,OAAO,CAAC,QAAQ;gBAChB,KAAK,EAAE,QAAQ;gBACf,IAAI,CAAC,QAAQ,CAAC,QAAQ;gBACtB,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACjE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,EAAE,YAAY;YACzD,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YACtE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK;SACN,CAAC;IACJ,CAAC;IAED,kFAAkF;IAC1E,aAAa,CAAC,IAGrB;QACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,8GAA8G;IACtG,KAAK,CAAC,YAAY,CAAI,IAG7B;QACC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC;QAErF,OAAO,IAAI,aAAa,CAAI;YAC1B,OAAO,EAAE,oCAAoC,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE;YAC5E,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG;YACH,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,oHAAoH;IAC5G,KAAK,CAAC,SAAS,CAAC,IAIvB;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qGAAqG;IAC7F,KAAK,CAAC,UAAU,CAAC,IAKxB;QACC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAClC,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,KAAK,GACT,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/F,sGAAsG;QACtG,MAAM,OAAO,GACX,IAAI,CAAC,OAAO;YACZ,KAAK,EAAE,SAAS;YAChB,IAAI,CAAC,cAAc;YACnB,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;QACxE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAE1E,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC9B,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,IAAI,QAAwC,CAAC;QAE7C,MAAM,EAAE,KAAK,CACX,wCAAwC,EACxC,MAAM,EACN,OAAO,CAAC,GAAG,EACX,aAAa,CAAC,aAAa,CAAC;YAC1B,KAAK,EAAE;gBACL,MAAM;gBACN,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;gBACpC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;aAClC;SACF,CAAC,EACF,OAAO,CACR,CAAC;QAEF,IAAI,CAAC;YACH,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;gBACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAE/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC9B;oBACE,MAAM;oBACN,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,OAAO;oBACP,IAAI;oBACJ,MAAM;oBACN,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK;oBACxB,gBAAgB,EAAE,QAAQ;oBAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,EACD,MAAM,CACP,CAAC;gBAEF,QAAQ,GAAG,IAAI,CAAC;gBAEhB,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;oBACxE,MAAM;gBACR,CAAC;gBAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAE7D,2FAA2F;gBAC3F,IAAI,GAAG,KAAK,YAAY,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;oBAC/C,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBACvC,MAAM;oBACR,CAAC;oBAED,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACzB,MAAM,IAAI,aAAa,CAAK;wBAC1B,OAAO,EAAE,2CAA2C,QAAQ,CAAC,MAAM,6BAA6B,OAAO,CAAC,GAAG,EAAE;wBAC7G,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,QAAQ,EAAE,QAAQ,IAAI,SAAS;qBAChC,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAEzB,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,QAAQ,CAAC;wBACb,KAAK,EAAE,eAAe,CAAC,WAAW;wBAClC,OAAO,EAAE,+CAA+C,OAAO,CAAC,GAAG,EAAE;qBACtE,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;oBACzB,MAAM,QAAQ,CAAC;wBACb,KAAK,EAAE,eAAe,CAAC,WAAW;wBAClC,OAAO,EAAE,qCAAqC,YAAY,WAAW,OAAO,CAAC,GAAG,EAAE;qBACnF,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC;oBAChC,QAAQ;oBACR,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;iBAC5B,CAAC,CAAC;gBACH,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC;gBAEnD,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;oBAClE,MAAM,GAAG,KAAK,CAAC;oBACf,IAAI,GAAG,SAAS,CAAC;oBACjB,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC;gBAChF,CAAC;qBAAM,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;oBAC/C,MAAM,QAAQ,CAAC;wBACb,KAAK,EAAE,eAAe,CAAC,WAAW;wBAClC,OAAO,EAAE,4EAA4E,MAAM,CAAC,MAAM,UAAU,IAAI,CAAC,MAAM,EAAE;qBAC1H,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC9D,MAAM,QAAQ,CAAC;wBACb,KAAK,EAAE,eAAe,CAAC,WAAW;wBAClC,OAAO,EAAE,yEAAyE,OAAO,CAAC,GAAG,EAAE;qBAChG,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,oBAAoB,EAAE,CAAC,CAAC;gBACrF,CAAC;gBAED,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iHAAiH;YACjH,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,MAAM,CAAC;YACtB,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,uCAAuC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC5B,OAAO;gBACP,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,+FAA+F;YAC/F,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAExE,MAAM,OAAO,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,2DAA2D;IACnD,KAAK,CAAC,MAAM,CAAC,IAIpB;QACC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,cAAc,GAAG,SAAS,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnF,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;gBAC9B,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,cAAc,WAAW,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,KAAc,CAAC;QAEnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAErD,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC,EAAE,CAAC;gBACpC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,gBAAgB,CAAC;gBACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG;gBACH,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAwB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAChF,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC,CAAC;YAEJ,MAAM,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,IAAqB;QACpC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,2GAA2G;QAC7G,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,QAAQ,CAAC;gBACb,KAAK,EAAE,eAAe,CAAC,WAAW;gBAClC,OAAO,EAAE,gCAAgC,IAAI,CAAC,GAAG,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oHAAoH;IAC5G,eAAe,CAAC,IAOvB;QACC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,oHAAoH;QACtH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,aAAa,CAAK;gBAC1B,OAAO,EAAE,0DAA0D,IAAI,CAAC,MAAM,WAAW,IAAI,CAAC,GAAG,EAAE;gBACnG,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,uGAAuG;IAC7F,KAAK,CAAC,OAAO,CACrB,IAAiC,EACjC,MAAuB;QAEvB,MAAM,EACJ,GAAG,EACH,MAAM,EACN,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,EACP,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,GAAG,KAAK,EACT,GAAG,IAAI,CAAC;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;YAC5B,OAAO,EAAE;gBACP,GAAG;gBACH,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,IAAI;gBACJ,MAAM;gBACN,OAAO;gBACP,KAAK;gBACL,KAAK;gBACL,QAAQ;gBACR,YAAY;gBACZ,YAAY;gBACZ,MAAM;aACP;YACD,KAAK;SACN,CAAC,CAAC;QACH,IAAI,WAA4C,CAAC;QACjD,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE;YAC9B,WAAW,GAAG,OAAO,CAAC;YAEtB,OAAO,IAAI,CAAC,UAAU,CAAC;gBACrB,IAAI;gBACJ,OAAO;gBACP,MAAM;gBACN,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;oBACrB,WAAW,GAAG,OAAO,CAAC;gBACxB,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBAE5B,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAE9E,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,gBAAgB,CAAC;gBACjD,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE;gBACxC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,WAAW;gBACX,UAAU;gBACV,OAAO;gBACP,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBAC7B,+GAA+G;oBAC/G,MAAM,KAAK,GAAG,SAAS,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;oBAEnE,IACE,KAAK,KAAK,SAAS;wBACnB,KAAK,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,SAAS,CAAC,oBAAoB,CAAC,EAC/D,CAAC;wBACD,OAAO,KAAK,CAAC;oBACf,CAAC;oBAED,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;wBAE7C,OAAO,SAAS,CAAC;oBACnB,CAAC;oBAED,OAAO,SAAS,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9E,CAAC;gBACD,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC;gBAChE,OAAO;gBACP,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;aACzC,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,uGAAuG;YACvG,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YAEjE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,EACL,WAAW;oBACX,IAAI,mBAAmB,CAAC;wBACtB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,GAAG,EAAE,IAAI,CAAC,GAAG;wBACb,OAAO,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;wBAClC,OAAO,EAAE,WAAW;qBACrB,CAAC;gBACJ,KAAK;gBACL,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC9E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAOD,IAAI,CAAC,IAAiC,EAAE,MAAuB;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAOD,GAAG,CAAC,IAAiC,EAAE,MAAuB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAOD,IAAI,CAAC,IAAiC,EAAE,MAAuB;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAOD,GAAG,CAAC,IAAiC,EAAE,MAAuB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAOD,KAAK,CAAC,IAAiC,EAAE,MAAuB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;IAOD,MAAM,CAAC,IAAiC,EAAE,MAAuB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAOD,KAAK,CAAC,IAAiC,EAAE,MAAuB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;CACF","sourcesContent":["import { RedactUtility } from '@/common/redact';\nimport { HTTP, type THttpMethod } from '@/common/constants/http';\nimport { getError } from '@/modules/error';\n// The leaf file, never the logger BARREL: that barrel reaches `node:module` and would drag this\n// browser-pure fetcher contract with it.\nimport type { ILogger } from '@/modules/logger/common/types';\nimport { UrlSafetyDefaults } from '@/modules/network/utilities/url-safety/common/constants';\nimport {\n UrlFetchError,\n UrlSafetyErrors,\n} from '@/modules/network/utilities/url-safety/common/errors';\nimport type { IUrlSafetyPolicy } from '@/modules/network/utilities/url-safety/common/types';\nimport { RetryHelper } from '@/modules/retry/helper';\nimport type { z } from 'zod';\nimport { type TFetcherVariant } from '../common';\nimport { BodyLimit } from './common/body-limit';\nimport { FetchSchemaError, type IFetchSchemaIssue } from './common/errors';\nimport type { IFetchGuard, IFetchGuardHop, IFetchGuardRoute } from './common/guard';\nimport { FetchRequestContext } from './common/request-context';\nimport type {\n IFetchParsed,\n IHttpRetryOptions,\n IFetcherDefaults,\n IFetcherHooks,\n THttpHeaders,\n} from './common/types';\nimport { HttpHeaders, HttpRedirects, HttpRetry, HttpStatus } from './common/utilities';\n\n/** The attempts a call makes when its `retry` names no `maxAttempts` (the retry helper's own default). */\nconst DEFAULT_MAX_ATTEMPTS = 3;\n\n/** What a fetcher calls on the logger it is handed, so a host logger with only these two (a browser app's) is accepted as is. */\nexport type TFetcherLogger = Pick<ILogger, 'debug' | 'info'>;\n\n/** Options every fetcher accepts. `timeout` is in milliseconds and counts per attempt; other keys pass through to the underlying client. */\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod | (string & Record<never, never>);\n params?: Record<string, unknown>;\n /** Merged over the fetcher's default headers, header by header; a `null` or `undefined` value removes a default. */\n headers?: THttpHeaders;\n body?: unknown;\n signal?: AbortSignal;\n timeout?: number;\n /** Presence turns retrying on; replaces the fetcher's default retry whole. `{ maxAttempts: 1 }` stops it. */\n retry?: IHttpRetryOptions;\n /** Presence turns the url guard on (`{}` is the default policy). A fetcher default guard can be replaced here, never removed. */\n guard?: IUrlSafetyPolicy;\n /** The body is cut off, and the call fails, once it crosses this many bytes. */\n maxBytes?: number;\n /** Redirects followed by hand; `0` hands back the 3xx as a `UrlFetchError`. Unset: the client follows (a guard follows 3). */\n maxRedirects?: number;\n /**\n * Which statuses are an answer; any other throws a `UrlFetchError`. A list ADDS to 2xx (`[HTTP.ResultCodes.RS_4.NotFound]`\n * is 2xx or 404); a function decides alone. Unset, only 2xx.\n */\n acceptStatus?: ReadonlyArray<number> | ((status: number) => boolean);\n /** The body is parsed with it, and the call answers `{ data, status, headers, response }`. */\n schema?: z.ZodType;\n [extra: symbol | string]: unknown;\n}\n\n/** The answer one exchange with the server gave, in the terms the pipeline needs, whichever client made it. */\nexport interface IFetchExchange<RS> {\n response: RS;\n status: number;\n statusText: string;\n headers: Headers;\n /** Frees the socket of a body nobody will read (a redirect). */\n discard(): Promise<void>;\n /** The same answer with at most `maxBytes` of its body kept readable, the rest released: what a refused status hands back. */\n keepBody(opts: { maxBytes: number }): Promise<RS>;\n /** The body as JSON; throws a `SyntaxError` when it is not. */\n readJson(opts: { maxBytes?: number }): Promise<unknown>;\n /** The same answer with its body cut off at `maxBytes`. */\n capped(opts: { maxBytes: number }): RS;\n}\n\n/** One request to the network, after the hooks and the guard have had their say. */\nexport interface IFetchExchangeRequest {\n method: string;\n url: URL;\n headers: Headers;\n body: unknown;\n signal?: AbortSignal;\n /** The addresses the guard vetted: connect to these and no other. Empty: connect as the client would. */\n addresses: string[];\n /** The host name the certificate is verified for when the connection goes to an address; unset for a literal address or a plain http url. */\n tlsServerName?: string;\n /** A proxy the guard policy chose. */\n proxy?: string;\n /** Do not follow a redirect: the pipeline reads the 3xx and walks it. */\n isManualRedirect: boolean;\n maxBytes?: number;\n /** What the call carried that is the client's own (`credentials`, `httpsAgent`, ...). */\n extra: Record<string | symbol, unknown>;\n}\n\n/** Contract of an HTTP fetcher: `send` takes the method from the options, the verb methods fix it, and `getWorker` returns the underlying client (`W`). Without a `schema` a call answers the raw response `RS`; with one, `IFetchParsed`. */\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n send<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n get(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n get<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n post(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n post<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n put(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n put<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n patch(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n patch<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n delete(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n delete<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n query(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n query<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** What one call settled to, before the verb overloads give it their types. */\ntype TFetchSettled<RS> = RS | IFetchParsed<unknown, RS>;\n\n/** A call after the fetcher's defaults are applied. */\ninterface IResolvedCall {\n method: string;\n url: string;\n headers: Headers;\n body: unknown;\n signal?: AbortSignal;\n /** The call's own `timeout`. When unset, each attempt takes the guard policy's, then `defaultTimeout`, then (guarded) the 10 s default. */\n timeout?: number;\n defaultTimeout?: number;\n retry?: IHttpRetryOptions;\n guard?: IUrlSafetyPolicy;\n maxBytes?: number;\n maxRedirects?: number;\n acceptStatus: (status: number) => boolean;\n schema?: z.ZodType;\n extra: Record<string | symbol, unknown>;\n}\n\n/**\n * The pipeline every fetcher shares: defaults, hooks, the url guard, redirects, the status check, the body cap, the\n * schema, retries. A concrete fetcher supplies the exchange with one client (`exchange`) and the shape of its urls and\n * bodies; `W` defaults to `unknown` so this stays free of `axios`.\n */\nexport abstract class AbstractNetworkFetchableHelper<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> implements IFetchable<V, RQ, RS, W> {\n protected name: string;\n protected variant: V;\n protected worker: W;\n protected defaults: IFetcherDefaults;\n protected hooks: IFetcherHooks;\n protected guardEngine?: IFetchGuard;\n\n constructor(opts: {\n name: string;\n variant: V;\n worker?: W;\n defaults?: IFetcherDefaults;\n hooks?: IFetcherHooks;\n /** The server half of the url guard (`UrlGuard`); a call that passes `guard` needs it. */\n guardEngine?: IFetchGuard;\n }) {\n this.name = opts.name;\n this.variant = opts.variant;\n this.defaults = opts.defaults ?? {};\n this.hooks = opts.hooks ?? {};\n this.guardEngine = opts.guardEngine;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n /** One exchange with the server: the request as the pipeline decided it, the answer in the pipeline's terms. */\n protected abstract exchange(\n opts: IFetchExchangeRequest,\n logger?: TFetcherLogger,\n ): Promise<IFetchExchange<RS>>;\n\n /** The url of a call with its `params` written into the query string. */\n protected abstract buildUrl(opts: { url: string; params?: Record<string, unknown> }): string;\n\n /** Whether `body` can be sent again to a redirect target. */\n protected isReplayable(opts: { body: unknown }): boolean {\n const { body } = opts;\n\n return (\n body === undefined ||\n body === null ||\n typeof body === 'string' ||\n ArrayBuffer.isView(body) ||\n body instanceof ArrayBuffer ||\n (typeof Blob !== 'undefined' && body instanceof Blob) ||\n (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams) ||\n Array.isArray(body) ||\n (typeof body === 'object' && Object.getPrototypeOf(body) === Object.prototype)\n );\n }\n\n /** What the request log says about a body: its size or its presence, never its content. */\n protected describeBody(opts: { body: unknown }): string | undefined {\n const { body } = opts;\n\n if (body === undefined || body === null) {\n return undefined;\n }\n\n return typeof body === 'string' ? `[body ${body.length} chars]` : '[body]';\n }\n\n /** Refuses a call the client cannot honour; `AxiosFetcher` refuses a guard it cannot pin. */\n protected assertCallSupported(_opts: {\n guard?: IUrlSafetyPolicy;\n extra: Record<string | symbol, unknown>;\n }): void {\n // Every call is supported by default.\n }\n\n /** What each attempt needs to know of the call. */\n private resolveCall(opts: {\n request: IRequestOptions;\n extra: Record<string | symbol, unknown>;\n }): IResolvedCall {\n const { request, extra } = opts;\n const guard = request.guard ?? this.defaults.guard;\n\n if (guard !== undefined && this.guardEngine === undefined) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.name}] A call with a guard needs the guard engine | pass guardEngine: UrlGuard (from @venizia/ignis-helpers) to the fetcher`,\n });\n }\n\n this.assertCallSupported({ guard, extra });\n\n const method = (request.method ?? HTTP.Methods.GET).toUpperCase();\n\n if (request.body !== undefined && (method === 'GET' || method === 'HEAD')) {\n throw getError({\n message: `[${this.name}] A ${method} request cannot carry a body | url: ${request.url}`,\n });\n }\n\n const retry = request.retry ?? this.defaults.retry;\n\n if (\n retry !== undefined &&\n (retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS) > 1 &&\n !this.isReplayable({ body: request.body })\n ) {\n throw getError({\n message: `[${this.name}] A call with retry cannot carry a body that is sent once (a stream, a FormData) unless maxAttempts is 1 | url: ${request.url}`,\n });\n }\n\n return {\n method,\n url: this.buildUrl({ url: request.url, params: request.params }),\n headers: HttpHeaders.merge({ layers: [this.defaults.headers, request.headers] }),\n body: request.body,\n signal: request.signal,\n timeout: request.timeout,\n defaultTimeout: this.defaults.timeout,\n retry,\n guard,\n // A guarded call always caps what it reads: the fetcher reads the body itself on the schema path.\n maxBytes:\n request.maxBytes ??\n guard?.maxBytes ??\n this.defaults.maxBytes ??\n (guard === undefined ? undefined : UrlSafetyDefaults.MAX_BYTES),\n maxRedirects: request.maxRedirects ?? guard?.maxRedirects,\n acceptStatus: HttpStatus.toPredicate({ accept: request.acceptStatus }),\n schema: request.schema,\n extra,\n };\n }\n\n /** `AbortSignal` of one attempt: the caller's own, and the attempt's deadline. */\n private attemptSignal(opts: {\n call: IResolvedCall;\n timeout: number | undefined;\n }): AbortSignal | undefined {\n const { call, timeout } = opts;\n const signals: AbortSignal[] = [];\n\n if (call.signal) {\n signals.push(call.signal);\n }\n\n if (timeout !== undefined && timeout > 0) {\n signals.push(AbortSignal.timeout(timeout));\n }\n\n if (signals.length === 0) {\n return undefined;\n }\n\n return signals.length === 1 ? signals[0] : AbortSignal.any(signals);\n }\n\n /** The body of a refused status or a mismatch is gone; the typed error carries what is left of the answer. */\n private async refuseStatus<R>(opts: {\n exchange: IFetchExchange<R>;\n url: string;\n }): Promise<UrlFetchError<R>> {\n const { exchange, url } = opts;\n const response = await exchange.keepBody({ maxBytes: UrlFetchError.MAX_BODY_BYTES });\n\n return new UrlFetchError<R>({\n message: `[fetch] Request failed | status: ${exchange.status} | url: ${url}`,\n status: exchange.status,\n url,\n headers: exchange.headers,\n response,\n });\n }\n\n /** The guard's verdict on one hop: the url to send and the addresses to pin; with no guard, the target as it is. */\n private async vetTarget(opts: {\n route: IFetchGuardRoute | undefined;\n target: URL;\n signal: AbortSignal | undefined;\n }): Promise<IFetchGuardHop> {\n const { route, target, signal } = opts;\n\n if (!route) {\n return { url: target, addresses: [] };\n }\n\n const vetted = await route.vet({ url: target.toString(), signal });\n\n return vetted;\n }\n\n /** One attempt: hook, guard, exchange (redirects walked by hand when asked), status, cap, schema. */\n private async runAttempt(opts: {\n call: IResolvedCall;\n attempt: number;\n logger?: TFetcherLogger;\n onRequest: (request: FetchRequestContext) => void;\n }): Promise<TFetchSettled<RS>> {\n const { call, attempt, logger } = opts;\n const startedAt = Date.now();\n const request = new FetchRequestContext({\n method: call.method,\n url: call.url,\n headers: new Headers(call.headers),\n attempt,\n });\n\n opts.onRequest(request);\n await this.hooks.onRequest?.(request);\n\n const route: IFetchGuardRoute | undefined =\n call.guard === undefined ? undefined : this.guardEngine?.createRoute({ policy: call.guard });\n // The call's own, else the guard policy's, else the fetcher's default; a guarded call always has one.\n const timeout =\n call.timeout ??\n route?.timeoutMs ??\n call.defaultTimeout ??\n (route === undefined ? undefined : UrlSafetyDefaults.TIMEOUT_MILLISECONDS);\n const signal = this.attemptSignal({ call, timeout });\n const isManual = route !== undefined || call.maxRedirects !== undefined;\n const maxRedirects = call.maxRedirects ?? UrlSafetyDefaults.MAX_REDIRECTS;\n\n let method = call.method;\n let body = call.body;\n let headers = request.headers;\n let target = this.parseUrl({ url: request.url });\n let exchange: IFetchExchange<RS> | undefined;\n\n logger?.debug(\n '[%s] URL: %s | Props: %s | Timeout: %s',\n 'send',\n request.url,\n RedactUtility.redactSecrets({\n value: {\n method,\n headers: Object.fromEntries(headers),\n body: this.describeBody({ body }),\n },\n }),\n timeout,\n );\n\n try {\n for (let hop = 0; hop <= (isManual ? maxRedirects : 0); hop += 1) {\n const vetted = await this.vetTarget({ route, target, signal });\n\n const sent = await this.exchange(\n {\n method,\n url: vetted.url,\n headers,\n body,\n signal,\n addresses: vetted.addresses,\n tlsServerName: vetted.tlsServerName,\n proxy: call.guard?.proxy,\n isManualRedirect: isManual,\n maxBytes: call.maxBytes,\n extra: call.extra,\n },\n logger,\n );\n\n exchange = sent;\n\n if (!isManual || !HttpRedirects.isRedirect({ status: exchange.status })) {\n break;\n }\n\n const location = exchange.headers.get(HTTP.Headers.LOCATION);\n\n // No redirect budget: the 3xx is the answer, unless the caller accepts that status as one.\n if (hop === maxRedirects && maxRedirects === 0) {\n if (call.acceptStatus(exchange.status)) {\n break;\n }\n\n await exchange.discard();\n throw new UrlFetchError<RS>({\n message: `[fetch] Redirect not followed | status: ${exchange.status} | maxRedirects: 0 | url: ${request.url}`,\n status: exchange.status,\n url: request.url,\n headers: exchange.headers,\n response: exchange.response,\n location: location ?? undefined,\n });\n }\n\n await exchange.discard();\n\n if (!location) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect carried no location | url: ${request.url}`,\n });\n }\n\n if (hop === maxRedirects) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Too many redirects | max: ${maxRedirects} | url: ${request.url}`,\n });\n }\n\n const next = this.resolveLocation({\n location,\n from: target,\n status: exchange.status,\n url: request.url,\n headers: exchange.headers,\n response: exchange.response,\n });\n const isSameOrigin = next.origin === target.origin;\n\n if (HttpRedirects.becomesGet({ status: exchange.status, method })) {\n method = 'GET';\n body = undefined;\n headers = HttpHeaders.without({ headers, names: HttpRedirects.BODY_HEADERS });\n } else if (body !== undefined && !isSameOrigin) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect would replay the request body to another origin | from: ${target.origin} | to: ${next.origin}`,\n });\n } else if (body !== undefined && !this.isReplayable({ body })) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Redirect would replay a body that cannot be sent twice | url: ${request.url}`,\n });\n }\n\n if (!isSameOrigin) {\n headers = HttpHeaders.only({ headers, names: HttpRedirects.CROSS_ORIGIN_HEADERS });\n }\n\n target = next;\n }\n } catch (error) {\n // A deadline or an abort wins over whatever the client made of it: a caller tells a timeout from its own cancel.\n if (signal?.aborted) {\n throw signal.reason;\n }\n\n throw error;\n }\n\n if (exchange === undefined) {\n throw getError({ message: `[fetch] No exchange was made | url: ${request.url}` });\n }\n\n try {\n await this.hooks.onResponse?.({\n request,\n status: exchange.status,\n headers: exchange.headers,\n durationMs: Date.now() - startedAt,\n });\n } catch (hookError) {\n // The hook failed the call; the body that was never read is released before the error goes on.\n await exchange.discard();\n throw hookError;\n }\n\n if (!call.acceptStatus(exchange.status)) {\n const refusal = await this.refuseStatus({ exchange, url: request.url });\n\n throw refusal;\n }\n\n return this.finish({ call, exchange, url: request.url });\n }\n\n /** The cap and the schema, once the status is accepted. */\n private async finish(opts: {\n call: IResolvedCall;\n exchange: IFetchExchange<RS>;\n url: string;\n }): Promise<TFetchSettled<RS>> {\n const { call, exchange, url } = opts;\n const { maxBytes, schema } = call;\n\n if (maxBytes !== undefined) {\n const declaredLength = BodyLimit.readDeclaredLength({ headers: exchange.headers });\n\n if (declaredLength > maxBytes) {\n await exchange.discard();\n throw BodyLimit.refuse({ detail: `declared: ${declaredLength} | max: ${maxBytes}` });\n }\n }\n\n if (schema === undefined) {\n return maxBytes === undefined ? exchange.response : exchange.capped({ maxBytes });\n }\n\n let value: unknown;\n\n try {\n const parsed = await exchange.readJson({ maxBytes });\n\n value = parsed;\n } catch (error) {\n if (!(error instanceof SyntaxError)) {\n throw error;\n }\n\n throw new FetchSchemaError({\n status: exchange.status,\n url,\n issues: [{ path: [], code: 'invalid_json' }],\n });\n }\n\n const parsed = schema.safeParse(value);\n\n if (!parsed.success) {\n const issues: IFetchSchemaIssue[] = parsed.error.issues.map((issue) => ({\n path: issue.path.map((part) => (typeof part === 'symbol' ? String(part) : part)),\n code: issue.code,\n }));\n\n throw new FetchSchemaError({ status: exchange.status, url, issues });\n }\n\n return {\n data: parsed.data,\n status: exchange.status,\n headers: exchange.headers,\n response: exchange.response,\n };\n }\n\n private parseUrl(opts: { url: string }): URL {\n try {\n return new URL(opts.url);\n // eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed refusal that names the url\n } catch {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetch] Malformed url | url: ${opts.url}`,\n });\n }\n }\n\n /** The absolute target of a redirect; a `Location` that is not a url is a typed error, never a bare `TypeError`. */\n private resolveLocation(opts: {\n location: string;\n from: URL;\n status: number;\n url: string;\n headers: Headers;\n response: RS;\n }): URL {\n try {\n return new URL(opts.location, opts.from);\n // eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed error that carries the raw Location\n } catch {\n throw new UrlFetchError<RS>({\n message: `[fetch] Redirect location is not a valid url | status: ${opts.status} | url: ${opts.url}`,\n status: opts.status,\n url: opts.url,\n headers: opts.headers,\n response: opts.response,\n location: opts.location,\n });\n }\n }\n\n /** The whole call: retries around the attempts, and the one `onError` for the failure that ends it. */\n protected async perform(\n opts: RQ & { schema?: z.ZodType },\n logger?: TFetcherLogger,\n ): Promise<TFetchSettled<RS>> {\n const {\n url,\n method,\n params,\n headers,\n body,\n signal,\n timeout,\n retry,\n guard,\n maxBytes,\n maxRedirects,\n acceptStatus,\n schema,\n ...extra\n } = opts;\n const call = this.resolveCall({\n request: {\n url,\n method,\n params,\n headers,\n body,\n signal,\n timeout,\n retry,\n guard,\n maxBytes,\n maxRedirects,\n acceptStatus,\n schema,\n },\n extra,\n });\n let lastRequest: FetchRequestContext | undefined;\n let lastAttempt = 0;\n\n const run = (attempt: number) => {\n lastAttempt = attempt;\n\n return this.runAttempt({\n call,\n attempt,\n logger,\n onRequest: (request) => {\n lastRequest = request;\n },\n });\n };\n\n try {\n if (call.retry === undefined) {\n const single = await run(1);\n\n return single;\n }\n\n const { maxAttempts, maxTotalMs, backoff, shouldRetry, onRetry } = call.retry;\n\n const retried = await RetryHelper.executeWithRetry({\n operation: `${this.name}.${call.method}`,\n signal: call.signal,\n maxAttempts,\n maxTotalMs,\n backoff,\n shouldRetry: async (context) => {\n // A server that asks for a longer wait than the backoff allows ends the retries: the last error is the answer.\n const asked = HttpRetry.readRetryAfterMs({ error: context.error });\n\n if (\n asked !== undefined &&\n asked > (backoff?.maxDelayMs ?? HttpRetry.DEFAULT_MAX_DELAY_MS)\n ) {\n return false;\n }\n\n if (shouldRetry) {\n const isAllowed = await shouldRetry(context);\n\n return isAllowed;\n }\n\n return HttpRetry.isRetryable({ error: context.error, signal: call.signal });\n },\n getDelayMs: ({ error }) => HttpRetry.readRetryAfterMs({ error }),\n onRetry,\n execution: ({ attempt }) => run(attempt),\n });\n\n return retried;\n } catch (caught) {\n // The retry helper reports its own abort in its own words; the caller gets the reason it aborted with.\n const error = call.signal?.aborted ? call.signal.reason : caught;\n\n await this.hooks.onError?.({\n request:\n lastRequest ??\n new FetchRequestContext({\n method: call.method,\n url: call.url,\n headers: new Headers(call.headers),\n attempt: lastAttempt,\n }),\n error,\n attempt: lastAttempt,\n });\n\n throw error;\n }\n }\n\n getProtocol(url: string) {\n return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;\n }\n\n getVariant() {\n return this.variant;\n }\n\n getWorker(): W {\n return this.worker;\n }\n\n send(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n send<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n send(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform(opts, logger);\n }\n\n get(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n get<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n get(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n post<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n post(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n put<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n put(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n patch<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n patch(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n delete<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n delete(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ & { schema?: undefined }, logger?: TFetcherLogger): Promise<RS>;\n query<S extends z.ZodType>(\n opts: RQ & { schema: S },\n logger?: TFetcherLogger,\n ): Promise<IFetchParsed<z.infer<S>, RS>>;\n query(opts: RQ & { schema?: z.ZodType }, logger?: TFetcherLogger): Promise<TFetchSettled<RS>> {\n return this.perform({ ...opts, method: HTTP.Methods.QUERY }, logger);\n }\n}\n"]}