@venizia/ignis-helpers 0.4.8 → 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.
- package/dist/esm/common/constants/http.d.ts +17 -1
- package/dist/esm/common/constants/http.js +17 -0
- package/dist/esm/common/constants/http.js.map +1 -1
- package/dist/esm/common/redact.js +2 -0
- package/dist/esm/common/redact.js.map +1 -1
- package/dist/esm/core.d.ts +5 -2
- package/dist/esm/core.js +5 -2
- package/dist/esm/core.js.map +1 -1
- package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +5 -0
- package/dist/esm/modules/network/http-request/base-network-request.helper.js +14 -17
- package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
- package/dist/esm/modules/network/http-request/common/constants.d.ts +2 -1
- package/dist/esm/modules/network/http-request/common/constants.js +2 -1
- package/dist/esm/modules/network/http-request/common/constants.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +37 -11
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +181 -38
- package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +204 -18
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +433 -13
- package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/common/body-limit.d.ts +36 -0
- package/dist/esm/modules/network/http-request/fetcher/common/body-limit.js +119 -0
- package/dist/esm/modules/network/http-request/fetcher/common/body-limit.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/common/errors.d.ts +40 -0
- package/dist/esm/modules/network/http-request/fetcher/common/errors.js +37 -0
- package/dist/esm/modules/network/http-request/fetcher/common/errors.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/common/guard.d.ts +27 -0
- package/dist/esm/modules/network/http-request/fetcher/common/guard.js +2 -0
- package/dist/esm/modules/network/http-request/fetcher/common/guard.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts +6 -0
- package/dist/esm/modules/network/http-request/fetcher/common/index.js +6 -0
- package/dist/esm/modules/network/http-request/fetcher/common/index.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/common/request-context.d.ts +15 -0
- package/dist/esm/modules/network/http-request/fetcher/common/request-context.js +11 -0
- package/dist/esm/modules/network/http-request/fetcher/common/request-context.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/common/response-reader.d.ts +133 -0
- package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js +264 -0
- package/dist/esm/modules/network/http-request/fetcher/common/response-reader.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +65 -1
- package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/common/utilities.d.ts +68 -0
- package/dist/esm/modules/network/http-request/fetcher/common/utilities.js +143 -0
- package/dist/esm/modules/network/http-request/fetcher/common/utilities.js.map +1 -0
- package/dist/esm/modules/network/http-request/fetcher/index.d.ts +2 -1
- package/dist/esm/modules/network/http-request/fetcher/index.js +2 -1
- package/dist/esm/modules/network/http-request/fetcher/index.js.map +1 -1
- package/dist/esm/modules/network/http-request/fetcher/native-fetcher.d.ts +85 -0
- package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js +221 -0
- package/dist/esm/modules/network/http-request/fetcher/native-fetcher.js.map +1 -0
- package/dist/esm/modules/network/utilities/index.d.ts +1 -0
- package/dist/esm/modules/network/utilities/index.js +1 -0
- package/dist/esm/modules/network/utilities/index.js.map +1 -1
- package/dist/esm/modules/network/utilities/query-string.d.ts +6 -23
- package/dist/esm/modules/network/utilities/query-string.js +3 -17
- package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-builder.d.ts +39 -0
- package/dist/esm/modules/network/utilities/url-builder.js +102 -0
- package/dist/esm/modules/network/utilities/url-builder.js.map +1 -0
- package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +0 -3
- package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts +38 -0
- package/dist/esm/modules/network/utilities/url-safety/common/errors.js +33 -1
- package/dist/esm/modules/network/utilities/url-safety/common/errors.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +26 -3
- package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/guard.d.ts +46 -0
- package/dist/esm/modules/network/utilities/url-safety/guard.js +145 -0
- package/dist/esm/modules/network/utilities/url-safety/guard.js.map +1 -0
- package/dist/esm/modules/network/utilities/url-safety/index.d.ts +1 -1
- package/dist/esm/modules/network/utilities/url-safety/index.js +1 -1
- package/dist/esm/modules/network/utilities/url-safety/index.js.map +1 -1
- package/dist/esm/modules/network/utilities/url-safety/policy.d.ts +52 -2
- package/dist/esm/modules/network/utilities/url-safety/policy.js +161 -14
- package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
- package/dist/esm/modules/queue/bullmq/helper.d.ts +43 -7
- package/dist/esm/modules/queue/bullmq/helper.js +70 -2
- package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
- package/dist/esm/modules/retry/helper.d.ts +3 -1
- package/dist/esm/modules/retry/helper.js +8 -4
- package/dist/esm/modules/retry/helper.js.map +1 -1
- package/dist/esm/utilities/request.utility.d.ts +1 -25
- package/dist/esm/utilities/request.utility.js +0 -46
- package/dist/esm/utilities/request.utility.js.map +1 -1
- package/package.json +4 -4
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +0 -41
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +0 -111
- package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +0 -1
- package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts +0 -95
- package/dist/esm/modules/network/utilities/url-safety/ingest.js +0 -328
- package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +0 -1
|
@@ -1,13 +1,436 @@
|
|
|
1
|
+
import { RedactUtility } from '../../../../common/redact.js';
|
|
1
2
|
import { HTTP } from '../../../../common/constants/http.js';
|
|
2
|
-
|
|
3
|
+
import { getError } from '../../../error/index.js';
|
|
4
|
+
import { UrlSafetyDefaults } from '../../utilities/url-safety/common/constants.js';
|
|
5
|
+
import { UrlFetchError, UrlSafetyErrors, } from '../../utilities/url-safety/common/errors.js';
|
|
6
|
+
import { RetryHelper } from '../../../retry/helper.js';
|
|
7
|
+
import { BodyLimit } from './common/body-limit.js';
|
|
8
|
+
import { FetchSchemaError } from './common/errors.js';
|
|
9
|
+
import { FetchRequestContext } from './common/request-context.js';
|
|
10
|
+
import { HttpHeaders, HttpRedirects, HttpRetry, HttpStatus } from './common/utilities.js';
|
|
11
|
+
/** The attempts a call makes when its `retry` names no `maxAttempts` (the retry helper's own default). */
|
|
12
|
+
const DEFAULT_MAX_ATTEMPTS = 3;
|
|
13
|
+
/**
|
|
14
|
+
* The pipeline every fetcher shares: defaults, hooks, the url guard, redirects, the status check, the body cap, the
|
|
15
|
+
* schema, retries. A concrete fetcher supplies the exchange with one client (`exchange`) and the shape of its urls and
|
|
16
|
+
* bodies; `W` defaults to `unknown` so this stays free of `axios`.
|
|
17
|
+
*/
|
|
3
18
|
export class AbstractNetworkFetchableHelper {
|
|
4
19
|
constructor(opts) {
|
|
5
20
|
this.name = opts.name;
|
|
6
21
|
this.variant = opts.variant;
|
|
22
|
+
this.defaults = opts.defaults ?? {};
|
|
23
|
+
this.hooks = opts.hooks ?? {};
|
|
24
|
+
this.guardEngine = opts.guardEngine;
|
|
7
25
|
if (opts.worker !== undefined) {
|
|
8
26
|
this.worker = opts.worker;
|
|
9
27
|
}
|
|
10
28
|
}
|
|
29
|
+
/** Whether `body` can be sent again to a redirect target. */
|
|
30
|
+
isReplayable(opts) {
|
|
31
|
+
const { body } = opts;
|
|
32
|
+
return (body === undefined ||
|
|
33
|
+
body === null ||
|
|
34
|
+
typeof body === 'string' ||
|
|
35
|
+
ArrayBuffer.isView(body) ||
|
|
36
|
+
body instanceof ArrayBuffer ||
|
|
37
|
+
(typeof Blob !== 'undefined' && body instanceof Blob) ||
|
|
38
|
+
(typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams) ||
|
|
39
|
+
Array.isArray(body) ||
|
|
40
|
+
(typeof body === 'object' && Object.getPrototypeOf(body) === Object.prototype));
|
|
41
|
+
}
|
|
42
|
+
/** What the request log says about a body: its size or its presence, never its content. */
|
|
43
|
+
describeBody(opts) {
|
|
44
|
+
const { body } = opts;
|
|
45
|
+
if (body === undefined || body === null) {
|
|
46
|
+
return undefined;
|
|
47
|
+
}
|
|
48
|
+
return typeof body === 'string' ? `[body ${body.length} chars]` : '[body]';
|
|
49
|
+
}
|
|
50
|
+
/** Refuses a call the client cannot honour; `AxiosFetcher` refuses a guard it cannot pin. */
|
|
51
|
+
assertCallSupported(_opts) {
|
|
52
|
+
// Every call is supported by default.
|
|
53
|
+
}
|
|
54
|
+
/** What each attempt needs to know of the call. */
|
|
55
|
+
resolveCall(opts) {
|
|
56
|
+
const { request, extra } = opts;
|
|
57
|
+
const guard = request.guard ?? this.defaults.guard;
|
|
58
|
+
if (guard !== undefined && this.guardEngine === undefined) {
|
|
59
|
+
throw getError({
|
|
60
|
+
statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
|
|
61
|
+
message: `[${this.name}] A call with a guard needs the guard engine | pass guardEngine: UrlGuard (from @venizia/ignis-helpers) to the fetcher`,
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
this.assertCallSupported({ guard, extra });
|
|
65
|
+
const method = (request.method ?? HTTP.Methods.GET).toUpperCase();
|
|
66
|
+
if (request.body !== undefined && (method === 'GET' || method === 'HEAD')) {
|
|
67
|
+
throw getError({
|
|
68
|
+
message: `[${this.name}] A ${method} request cannot carry a body | url: ${request.url}`,
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
const retry = request.retry ?? this.defaults.retry;
|
|
72
|
+
if (retry !== undefined &&
|
|
73
|
+
(retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS) > 1 &&
|
|
74
|
+
!this.isReplayable({ body: request.body })) {
|
|
75
|
+
throw getError({
|
|
76
|
+
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}`,
|
|
77
|
+
});
|
|
78
|
+
}
|
|
79
|
+
return {
|
|
80
|
+
method,
|
|
81
|
+
url: this.buildUrl({ url: request.url, params: request.params }),
|
|
82
|
+
headers: HttpHeaders.merge({ layers: [this.defaults.headers, request.headers] }),
|
|
83
|
+
body: request.body,
|
|
84
|
+
signal: request.signal,
|
|
85
|
+
timeout: request.timeout,
|
|
86
|
+
defaultTimeout: this.defaults.timeout,
|
|
87
|
+
retry,
|
|
88
|
+
guard,
|
|
89
|
+
// A guarded call always caps what it reads: the fetcher reads the body itself on the schema path.
|
|
90
|
+
maxBytes: request.maxBytes ??
|
|
91
|
+
guard?.maxBytes ??
|
|
92
|
+
this.defaults.maxBytes ??
|
|
93
|
+
(guard === undefined ? undefined : UrlSafetyDefaults.MAX_BYTES),
|
|
94
|
+
maxRedirects: request.maxRedirects ?? guard?.maxRedirects,
|
|
95
|
+
acceptStatus: HttpStatus.toPredicate({ accept: request.acceptStatus }),
|
|
96
|
+
schema: request.schema,
|
|
97
|
+
extra,
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
/** `AbortSignal` of one attempt: the caller's own, and the attempt's deadline. */
|
|
101
|
+
attemptSignal(opts) {
|
|
102
|
+
const { call, timeout } = opts;
|
|
103
|
+
const signals = [];
|
|
104
|
+
if (call.signal) {
|
|
105
|
+
signals.push(call.signal);
|
|
106
|
+
}
|
|
107
|
+
if (timeout !== undefined && timeout > 0) {
|
|
108
|
+
signals.push(AbortSignal.timeout(timeout));
|
|
109
|
+
}
|
|
110
|
+
if (signals.length === 0) {
|
|
111
|
+
return undefined;
|
|
112
|
+
}
|
|
113
|
+
return signals.length === 1 ? signals[0] : AbortSignal.any(signals);
|
|
114
|
+
}
|
|
115
|
+
/** The body of a refused status or a mismatch is gone; the typed error carries what is left of the answer. */
|
|
116
|
+
async refuseStatus(opts) {
|
|
117
|
+
const { exchange, url } = opts;
|
|
118
|
+
const response = await exchange.keepBody({ maxBytes: UrlFetchError.MAX_BODY_BYTES });
|
|
119
|
+
return new UrlFetchError({
|
|
120
|
+
message: `[fetch] Request failed | status: ${exchange.status} | url: ${url}`,
|
|
121
|
+
status: exchange.status,
|
|
122
|
+
url,
|
|
123
|
+
headers: exchange.headers,
|
|
124
|
+
response,
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
/** The guard's verdict on one hop: the url to send and the addresses to pin; with no guard, the target as it is. */
|
|
128
|
+
async vetTarget(opts) {
|
|
129
|
+
const { route, target, signal } = opts;
|
|
130
|
+
if (!route) {
|
|
131
|
+
return { url: target, addresses: [] };
|
|
132
|
+
}
|
|
133
|
+
const vetted = await route.vet({ url: target.toString(), signal });
|
|
134
|
+
return vetted;
|
|
135
|
+
}
|
|
136
|
+
/** One attempt: hook, guard, exchange (redirects walked by hand when asked), status, cap, schema. */
|
|
137
|
+
async runAttempt(opts) {
|
|
138
|
+
const { call, attempt, logger } = opts;
|
|
139
|
+
const startedAt = Date.now();
|
|
140
|
+
const request = new FetchRequestContext({
|
|
141
|
+
method: call.method,
|
|
142
|
+
url: call.url,
|
|
143
|
+
headers: new Headers(call.headers),
|
|
144
|
+
attempt,
|
|
145
|
+
});
|
|
146
|
+
opts.onRequest(request);
|
|
147
|
+
await this.hooks.onRequest?.(request);
|
|
148
|
+
const route = call.guard === undefined ? undefined : this.guardEngine?.createRoute({ policy: call.guard });
|
|
149
|
+
// The call's own, else the guard policy's, else the fetcher's default; a guarded call always has one.
|
|
150
|
+
const timeout = call.timeout ??
|
|
151
|
+
route?.timeoutMs ??
|
|
152
|
+
call.defaultTimeout ??
|
|
153
|
+
(route === undefined ? undefined : UrlSafetyDefaults.TIMEOUT_MILLISECONDS);
|
|
154
|
+
const signal = this.attemptSignal({ call, timeout });
|
|
155
|
+
const isManual = route !== undefined || call.maxRedirects !== undefined;
|
|
156
|
+
const maxRedirects = call.maxRedirects ?? UrlSafetyDefaults.MAX_REDIRECTS;
|
|
157
|
+
let method = call.method;
|
|
158
|
+
let body = call.body;
|
|
159
|
+
let headers = request.headers;
|
|
160
|
+
let target = this.parseUrl({ url: request.url });
|
|
161
|
+
let exchange;
|
|
162
|
+
logger?.debug('[%s] URL: %s | Props: %s | Timeout: %s', 'send', request.url, RedactUtility.redactSecrets({
|
|
163
|
+
value: {
|
|
164
|
+
method,
|
|
165
|
+
headers: Object.fromEntries(headers),
|
|
166
|
+
body: this.describeBody({ body }),
|
|
167
|
+
},
|
|
168
|
+
}), timeout);
|
|
169
|
+
try {
|
|
170
|
+
for (let hop = 0; hop <= (isManual ? maxRedirects : 0); hop += 1) {
|
|
171
|
+
const vetted = await this.vetTarget({ route, target, signal });
|
|
172
|
+
const sent = await this.exchange({
|
|
173
|
+
method,
|
|
174
|
+
url: vetted.url,
|
|
175
|
+
headers,
|
|
176
|
+
body,
|
|
177
|
+
signal,
|
|
178
|
+
addresses: vetted.addresses,
|
|
179
|
+
tlsServerName: vetted.tlsServerName,
|
|
180
|
+
proxy: call.guard?.proxy,
|
|
181
|
+
isManualRedirect: isManual,
|
|
182
|
+
maxBytes: call.maxBytes,
|
|
183
|
+
extra: call.extra,
|
|
184
|
+
}, logger);
|
|
185
|
+
exchange = sent;
|
|
186
|
+
if (!isManual || !HttpRedirects.isRedirect({ status: exchange.status })) {
|
|
187
|
+
break;
|
|
188
|
+
}
|
|
189
|
+
const location = exchange.headers.get(HTTP.Headers.LOCATION);
|
|
190
|
+
// No redirect budget: the 3xx is the answer, unless the caller accepts that status as one.
|
|
191
|
+
if (hop === maxRedirects && maxRedirects === 0) {
|
|
192
|
+
if (call.acceptStatus(exchange.status)) {
|
|
193
|
+
break;
|
|
194
|
+
}
|
|
195
|
+
await exchange.discard();
|
|
196
|
+
throw new UrlFetchError({
|
|
197
|
+
message: `[fetch] Redirect not followed | status: ${exchange.status} | maxRedirects: 0 | url: ${request.url}`,
|
|
198
|
+
status: exchange.status,
|
|
199
|
+
url: request.url,
|
|
200
|
+
headers: exchange.headers,
|
|
201
|
+
response: exchange.response,
|
|
202
|
+
location: location ?? undefined,
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
await exchange.discard();
|
|
206
|
+
if (!location) {
|
|
207
|
+
throw getError({
|
|
208
|
+
error: UrlSafetyErrors.URL_REFUSED,
|
|
209
|
+
message: `[fetch] Redirect carried no location | url: ${request.url}`,
|
|
210
|
+
});
|
|
211
|
+
}
|
|
212
|
+
if (hop === maxRedirects) {
|
|
213
|
+
throw getError({
|
|
214
|
+
error: UrlSafetyErrors.URL_REFUSED,
|
|
215
|
+
message: `[fetch] Too many redirects | max: ${maxRedirects} | url: ${request.url}`,
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
const next = this.resolveLocation({
|
|
219
|
+
location,
|
|
220
|
+
from: target,
|
|
221
|
+
status: exchange.status,
|
|
222
|
+
url: request.url,
|
|
223
|
+
headers: exchange.headers,
|
|
224
|
+
response: exchange.response,
|
|
225
|
+
});
|
|
226
|
+
const isSameOrigin = next.origin === target.origin;
|
|
227
|
+
if (HttpRedirects.becomesGet({ status: exchange.status, method })) {
|
|
228
|
+
method = 'GET';
|
|
229
|
+
body = undefined;
|
|
230
|
+
headers = HttpHeaders.without({ headers, names: HttpRedirects.BODY_HEADERS });
|
|
231
|
+
}
|
|
232
|
+
else if (body !== undefined && !isSameOrigin) {
|
|
233
|
+
throw getError({
|
|
234
|
+
error: UrlSafetyErrors.URL_REFUSED,
|
|
235
|
+
message: `[fetch] Redirect would replay the request body to another origin | from: ${target.origin} | to: ${next.origin}`,
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
else if (body !== undefined && !this.isReplayable({ body })) {
|
|
239
|
+
throw getError({
|
|
240
|
+
error: UrlSafetyErrors.URL_REFUSED,
|
|
241
|
+
message: `[fetch] Redirect would replay a body that cannot be sent twice | url: ${request.url}`,
|
|
242
|
+
});
|
|
243
|
+
}
|
|
244
|
+
if (!isSameOrigin) {
|
|
245
|
+
headers = HttpHeaders.only({ headers, names: HttpRedirects.CROSS_ORIGIN_HEADERS });
|
|
246
|
+
}
|
|
247
|
+
target = next;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
catch (error) {
|
|
251
|
+
// A deadline or an abort wins over whatever the client made of it: a caller tells a timeout from its own cancel.
|
|
252
|
+
if (signal?.aborted) {
|
|
253
|
+
throw signal.reason;
|
|
254
|
+
}
|
|
255
|
+
throw error;
|
|
256
|
+
}
|
|
257
|
+
if (exchange === undefined) {
|
|
258
|
+
throw getError({ message: `[fetch] No exchange was made | url: ${request.url}` });
|
|
259
|
+
}
|
|
260
|
+
try {
|
|
261
|
+
await this.hooks.onResponse?.({
|
|
262
|
+
request,
|
|
263
|
+
status: exchange.status,
|
|
264
|
+
headers: exchange.headers,
|
|
265
|
+
durationMs: Date.now() - startedAt,
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
catch (hookError) {
|
|
269
|
+
// The hook failed the call; the body that was never read is released before the error goes on.
|
|
270
|
+
await exchange.discard();
|
|
271
|
+
throw hookError;
|
|
272
|
+
}
|
|
273
|
+
if (!call.acceptStatus(exchange.status)) {
|
|
274
|
+
const refusal = await this.refuseStatus({ exchange, url: request.url });
|
|
275
|
+
throw refusal;
|
|
276
|
+
}
|
|
277
|
+
return this.finish({ call, exchange, url: request.url });
|
|
278
|
+
}
|
|
279
|
+
/** The cap and the schema, once the status is accepted. */
|
|
280
|
+
async finish(opts) {
|
|
281
|
+
const { call, exchange, url } = opts;
|
|
282
|
+
const { maxBytes, schema } = call;
|
|
283
|
+
if (maxBytes !== undefined) {
|
|
284
|
+
const declaredLength = BodyLimit.readDeclaredLength({ headers: exchange.headers });
|
|
285
|
+
if (declaredLength > maxBytes) {
|
|
286
|
+
await exchange.discard();
|
|
287
|
+
throw BodyLimit.refuse({ detail: `declared: ${declaredLength} | max: ${maxBytes}` });
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
if (schema === undefined) {
|
|
291
|
+
return maxBytes === undefined ? exchange.response : exchange.capped({ maxBytes });
|
|
292
|
+
}
|
|
293
|
+
let value;
|
|
294
|
+
try {
|
|
295
|
+
const parsed = await exchange.readJson({ maxBytes });
|
|
296
|
+
value = parsed;
|
|
297
|
+
}
|
|
298
|
+
catch (error) {
|
|
299
|
+
if (!(error instanceof SyntaxError)) {
|
|
300
|
+
throw error;
|
|
301
|
+
}
|
|
302
|
+
throw new FetchSchemaError({
|
|
303
|
+
status: exchange.status,
|
|
304
|
+
url,
|
|
305
|
+
issues: [{ path: [], code: 'invalid_json' }],
|
|
306
|
+
});
|
|
307
|
+
}
|
|
308
|
+
const parsed = schema.safeParse(value);
|
|
309
|
+
if (!parsed.success) {
|
|
310
|
+
const issues = parsed.error.issues.map((issue) => ({
|
|
311
|
+
path: issue.path.map((part) => (typeof part === 'symbol' ? String(part) : part)),
|
|
312
|
+
code: issue.code,
|
|
313
|
+
}));
|
|
314
|
+
throw new FetchSchemaError({ status: exchange.status, url, issues });
|
|
315
|
+
}
|
|
316
|
+
return {
|
|
317
|
+
data: parsed.data,
|
|
318
|
+
status: exchange.status,
|
|
319
|
+
headers: exchange.headers,
|
|
320
|
+
response: exchange.response,
|
|
321
|
+
};
|
|
322
|
+
}
|
|
323
|
+
parseUrl(opts) {
|
|
324
|
+
try {
|
|
325
|
+
return new URL(opts.url);
|
|
326
|
+
// eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed refusal that names the url
|
|
327
|
+
}
|
|
328
|
+
catch {
|
|
329
|
+
throw getError({
|
|
330
|
+
error: UrlSafetyErrors.URL_REFUSED,
|
|
331
|
+
message: `[fetch] Malformed url | url: ${opts.url}`,
|
|
332
|
+
});
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
/** The absolute target of a redirect; a `Location` that is not a url is a typed error, never a bare `TypeError`. */
|
|
336
|
+
resolveLocation(opts) {
|
|
337
|
+
try {
|
|
338
|
+
return new URL(opts.location, opts.from);
|
|
339
|
+
// eslint-disable-next-line venizia/no-silent-catch -- rethrown below as a typed error that carries the raw Location
|
|
340
|
+
}
|
|
341
|
+
catch {
|
|
342
|
+
throw new UrlFetchError({
|
|
343
|
+
message: `[fetch] Redirect location is not a valid url | status: ${opts.status} | url: ${opts.url}`,
|
|
344
|
+
status: opts.status,
|
|
345
|
+
url: opts.url,
|
|
346
|
+
headers: opts.headers,
|
|
347
|
+
response: opts.response,
|
|
348
|
+
location: opts.location,
|
|
349
|
+
});
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
/** The whole call: retries around the attempts, and the one `onError` for the failure that ends it. */
|
|
353
|
+
async perform(opts, logger) {
|
|
354
|
+
const { url, method, params, headers, body, signal, timeout, retry, guard, maxBytes, maxRedirects, acceptStatus, schema, ...extra } = opts;
|
|
355
|
+
const call = this.resolveCall({
|
|
356
|
+
request: {
|
|
357
|
+
url,
|
|
358
|
+
method,
|
|
359
|
+
params,
|
|
360
|
+
headers,
|
|
361
|
+
body,
|
|
362
|
+
signal,
|
|
363
|
+
timeout,
|
|
364
|
+
retry,
|
|
365
|
+
guard,
|
|
366
|
+
maxBytes,
|
|
367
|
+
maxRedirects,
|
|
368
|
+
acceptStatus,
|
|
369
|
+
schema,
|
|
370
|
+
},
|
|
371
|
+
extra,
|
|
372
|
+
});
|
|
373
|
+
let lastRequest;
|
|
374
|
+
let lastAttempt = 0;
|
|
375
|
+
const run = (attempt) => {
|
|
376
|
+
lastAttempt = attempt;
|
|
377
|
+
return this.runAttempt({
|
|
378
|
+
call,
|
|
379
|
+
attempt,
|
|
380
|
+
logger,
|
|
381
|
+
onRequest: (request) => {
|
|
382
|
+
lastRequest = request;
|
|
383
|
+
},
|
|
384
|
+
});
|
|
385
|
+
};
|
|
386
|
+
try {
|
|
387
|
+
if (call.retry === undefined) {
|
|
388
|
+
const single = await run(1);
|
|
389
|
+
return single;
|
|
390
|
+
}
|
|
391
|
+
const { maxAttempts, maxTotalMs, backoff, shouldRetry, onRetry } = call.retry;
|
|
392
|
+
const retried = await RetryHelper.executeWithRetry({
|
|
393
|
+
operation: `${this.name}.${call.method}`,
|
|
394
|
+
signal: call.signal,
|
|
395
|
+
maxAttempts,
|
|
396
|
+
maxTotalMs,
|
|
397
|
+
backoff,
|
|
398
|
+
shouldRetry: async (context) => {
|
|
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 = HttpRetry.readRetryAfterMs({ error: context.error });
|
|
401
|
+
if (asked !== undefined &&
|
|
402
|
+
asked > (backoff?.maxDelayMs ?? HttpRetry.DEFAULT_MAX_DELAY_MS)) {
|
|
403
|
+
return false;
|
|
404
|
+
}
|
|
405
|
+
if (shouldRetry) {
|
|
406
|
+
const isAllowed = await shouldRetry(context);
|
|
407
|
+
return isAllowed;
|
|
408
|
+
}
|
|
409
|
+
return HttpRetry.isRetryable({ error: context.error, signal: call.signal });
|
|
410
|
+
},
|
|
411
|
+
getDelayMs: ({ error }) => HttpRetry.readRetryAfterMs({ error }),
|
|
412
|
+
onRetry,
|
|
413
|
+
execution: ({ attempt }) => run(attempt),
|
|
414
|
+
});
|
|
415
|
+
return retried;
|
|
416
|
+
}
|
|
417
|
+
catch (caught) {
|
|
418
|
+
// The retry helper reports its own abort in its own words; the caller gets the reason it aborted with.
|
|
419
|
+
const error = call.signal?.aborted ? call.signal.reason : caught;
|
|
420
|
+
await this.hooks.onError?.({
|
|
421
|
+
request: lastRequest ??
|
|
422
|
+
new FetchRequestContext({
|
|
423
|
+
method: call.method,
|
|
424
|
+
url: call.url,
|
|
425
|
+
headers: new Headers(call.headers),
|
|
426
|
+
attempt: lastAttempt,
|
|
427
|
+
}),
|
|
428
|
+
error,
|
|
429
|
+
attempt: lastAttempt,
|
|
430
|
+
});
|
|
431
|
+
throw error;
|
|
432
|
+
}
|
|
433
|
+
}
|
|
11
434
|
getProtocol(url) {
|
|
12
435
|
return url.startsWith('http:') ? HTTP.Protocols.HTTP : HTTP.Protocols.HTTPS;
|
|
13
436
|
}
|
|
@@ -17,29 +440,26 @@ export class AbstractNetworkFetchableHelper {
|
|
|
17
440
|
getWorker() {
|
|
18
441
|
return this.worker;
|
|
19
442
|
}
|
|
443
|
+
send(opts, logger) {
|
|
444
|
+
return this.perform(opts, logger);
|
|
445
|
+
}
|
|
20
446
|
get(opts, logger) {
|
|
21
|
-
|
|
22
|
-
return this.send({ ...rest, method: HTTP.Methods.GET }, logger);
|
|
447
|
+
return this.perform({ ...opts, method: HTTP.Methods.GET }, logger);
|
|
23
448
|
}
|
|
24
449
|
post(opts, logger) {
|
|
25
|
-
|
|
26
|
-
return this.send({ ...rest, method: HTTP.Methods.POST }, logger);
|
|
450
|
+
return this.perform({ ...opts, method: HTTP.Methods.POST }, logger);
|
|
27
451
|
}
|
|
28
452
|
put(opts, logger) {
|
|
29
|
-
|
|
30
|
-
return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);
|
|
453
|
+
return this.perform({ ...opts, method: HTTP.Methods.PUT }, logger);
|
|
31
454
|
}
|
|
32
455
|
patch(opts, logger) {
|
|
33
|
-
|
|
34
|
-
return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);
|
|
456
|
+
return this.perform({ ...opts, method: HTTP.Methods.PATCH }, logger);
|
|
35
457
|
}
|
|
36
458
|
delete(opts, logger) {
|
|
37
|
-
|
|
38
|
-
return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);
|
|
459
|
+
return this.perform({ ...opts, method: HTTP.Methods.DELETE }, logger);
|
|
39
460
|
}
|
|
40
461
|
query(opts, logger) {
|
|
41
|
-
|
|
42
|
-
return this.send({ ...rest, method: HTTP.Methods.QUERY }, logger);
|
|
462
|
+
return this.perform({ ...opts, method: HTTP.Methods.QUERY }, logger);
|
|
43
463
|
}
|
|
44
464
|
}
|
|
45
465
|
//# sourceMappingURL=base-fetcher.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base-fetcher.js","sourceRoot":"","sources":["../../../../../../src/modules/network/http-request/fetcher/base-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,yBAAyB,CAAC;AAqCjE,yNAAyN;AACzN,MAAM,OAAgB,8BAA8B;IAUlD,YAAY,IAA8C;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAID,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;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,IAAQ,EAAE,MAAuB;QACpC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,IAAQ,EAAE,MAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAQ,EAAE,MAAuB;QACtC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,IAAQ,EAAE,MAAuB;QACrC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF","sourcesContent":["import { HTTP, type THttpMethod } from '@/common/constants/http';\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 { type TFetcherVariant } from '../common';\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; other keys pass through to the underlying client. */\nexport interface IRequestOptions {\n url: string;\n method?: THttpMethod;\n params?: Record<string, unknown>;\n timeout?: number;\n [extra: symbol | string]: 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`). */\nexport interface IFetchable<\n V extends TFetcherVariant,\n RQ extends IRequestOptions,\n RS,\n W = unknown,\n> {\n send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n get(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n post(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n put(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n patch(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n delete(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n query(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\n\n getVariant(): V;\n getWorker(): W;\n}\n\n/** `W` defaults to `unknown` so this stays free of `axios` - a concrete fetcher binds it to its real worker type (`AxiosInstance`, `typeof fetch`), which is then inherited on `this.worker` with no override needed. */\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\n constructor(opts: { name: string; variant: V; worker?: W }) {\n this.name = opts.name;\n this.variant = opts.variant;\n\n if (opts.worker !== undefined) {\n this.worker = opts.worker;\n }\n }\n\n abstract send(opts: RQ, logger?: TFetcherLogger): Promise<RS>;\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 get(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.GET }, logger);\n }\n\n post(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.POST }, logger);\n }\n\n put(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PUT }, logger);\n }\n\n patch(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.PATCH }, logger);\n }\n\n delete(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, method: HTTP.Methods.DELETE }, logger);\n }\n\n query(opts: RQ, logger?: TFetcherLogger) {\n const { ...rest } = opts;\n\n return this.send({ ...rest, 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":"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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 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"]}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { ApplicationError } from '@venizia/ignis-inversion';
|
|
2
|
+
/** A cap on a body, for a stream piped onward or a body read into memory. Browser-pure: streams and typed arrays only. */
|
|
3
|
+
export declare class BodyLimit {
|
|
4
|
+
/** The one refusal of a body over the cap; `detail` says how it was found (declared, received, a client's own words). */
|
|
5
|
+
static refuse(opts: {
|
|
6
|
+
detail: string;
|
|
7
|
+
}): ApplicationError;
|
|
8
|
+
/** Enforces `maxBytes` on a stream nothing reads into this process: the cap fails the stream the moment the bytes cross it. */
|
|
9
|
+
static capStream(opts: {
|
|
10
|
+
source: ReadableStream<Uint8Array>;
|
|
11
|
+
maxBytes?: number;
|
|
12
|
+
}): ReadableStream<Uint8Array>;
|
|
13
|
+
/** The size a response declares, or `0` when it declares none or an unreadable one. */
|
|
14
|
+
static readDeclaredLength(opts: {
|
|
15
|
+
headers: Headers;
|
|
16
|
+
}): number;
|
|
17
|
+
/** At most `maxBytes` of the body, then the rest released; a body that fails halfway answers what arrived. Never throws on size: a refused status must still say what it was. */
|
|
18
|
+
static readPrefix(opts: {
|
|
19
|
+
response: Response;
|
|
20
|
+
maxBytes: number;
|
|
21
|
+
}): Promise<Uint8Array>;
|
|
22
|
+
/** `readBytes`, decoded as UTF-8 text. */
|
|
23
|
+
static readText(opts: {
|
|
24
|
+
response: Response;
|
|
25
|
+
maxBytes?: number;
|
|
26
|
+
}): Promise<string>;
|
|
27
|
+
/**
|
|
28
|
+
* Reads a body that must not exceed `maxBytes`, cancelling the moment it does. `content-length` is checked first
|
|
29
|
+
* because it is free, and counted anyway because it may be absent or lie.
|
|
30
|
+
*/
|
|
31
|
+
static readBytes(opts: {
|
|
32
|
+
response: Response;
|
|
33
|
+
maxBytes?: number;
|
|
34
|
+
}): Promise<Uint8Array>;
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=body-limit.d.ts.map
|