@ember-data-mirror/request 5.3.4

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.
@@ -0,0 +1,614 @@
1
+ import { getOrSetUniversal, getOrSetGlobal } from '@warp-drive/core-types/-private';
2
+ import { STRUCTURED, IS_FUTURE, SkipCache } from '@warp-drive/core-types/request';
3
+ import { macroCondition, getGlobalConfig } from '@embroider/macros';
4
+ const PromiseCache = getOrSetUniversal('PromiseCache', new WeakMap());
5
+ const RequestMap = getOrSetUniversal('RequestMap', new Map());
6
+ function setRequestResult(requestId, result) {
7
+ RequestMap.set(requestId, result);
8
+ }
9
+ function clearRequestResult(requestId) {
10
+ RequestMap.delete(requestId);
11
+ }
12
+ function getRequestResult(requestId) {
13
+ return RequestMap.get(requestId);
14
+ }
15
+ function setPromiseResult(promise, result) {
16
+ PromiseCache.set(promise, result);
17
+ }
18
+ function getPromiseResult(promise) {
19
+ return PromiseCache.get(promise);
20
+ }
21
+ const IS_CACHE_HANDLER = getOrSetGlobal('IS_CACHE_HANDLER', Symbol('IS_CACHE_HANDLER'));
22
+ function curryFuture(owner, inbound, outbound) {
23
+ owner.setStream(inbound.getStream());
24
+ inbound.then(doc => {
25
+ const document = {
26
+ [STRUCTURED]: true,
27
+ request: owner.request,
28
+ response: doc.response,
29
+ content: doc.content
30
+ };
31
+ outbound.resolve(document);
32
+ }, error => {
33
+ if (isDoc(error)) {
34
+ owner.setStream(owner.god.stream);
35
+ }
36
+ if (!error || !(error instanceof Error)) {
37
+ try {
38
+ throw new Error(error ? error : `Request Rejected with an Unknown Error`);
39
+ } catch (e) {
40
+ if (error && typeof error === 'object') {
41
+ Object.assign(e, error);
42
+ e.message = error.message || `Request Rejected with an Unknown Error`;
43
+ }
44
+ error = e;
45
+ }
46
+ }
47
+ error[STRUCTURED] = true;
48
+ error.request = owner.request;
49
+ error.response = owner.getResponse();
50
+ error.error = error.error || error.message;
51
+ outbound.reject(error);
52
+ });
53
+ return outbound.promise;
54
+ }
55
+ function isDoc(doc) {
56
+ return doc && doc[STRUCTURED] === true;
57
+ }
58
+ function ensureDoc(owner, content, isError) {
59
+ if (isDoc(content)) {
60
+ return content;
61
+ }
62
+ if (isError) {
63
+ return {
64
+ [STRUCTURED]: true,
65
+ request: owner.request,
66
+ response: owner.getResponse(),
67
+ error: content
68
+ };
69
+ }
70
+ return {
71
+ [STRUCTURED]: true,
72
+ request: owner.request,
73
+ response: owner.getResponse(),
74
+ content: content
75
+ };
76
+ }
77
+ function enhanceReason(reason) {
78
+ return new DOMException(reason || 'The user aborted a request.', 'AbortError');
79
+ }
80
+ function handleOutcome(owner, inbound, outbound) {
81
+ inbound.then(content => {
82
+ if (owner.controller.signal.aborted) {
83
+ // the next function did not respect the signal, we handle it here
84
+ outbound.reject(enhanceReason(owner.controller.signal.reason));
85
+ return;
86
+ }
87
+ if (isDoc(content)) {
88
+ owner.setStream(owner.god.stream);
89
+ content = content.content;
90
+ }
91
+ const document = {
92
+ [STRUCTURED]: true,
93
+ request: owner.request,
94
+ response: owner.getResponse(),
95
+ content
96
+ };
97
+ outbound.resolve(document);
98
+ }, error => {
99
+ if (isDoc(error)) {
100
+ owner.setStream(owner.god.stream);
101
+ }
102
+ if (!error || !(error instanceof Error)) {
103
+ try {
104
+ throw new Error(error ? error : `Request Rejected with an Unknown Error`);
105
+ } catch (e) {
106
+ if (error && typeof error === 'object') {
107
+ Object.assign(e, error);
108
+ e.message = error.message || `Request Rejected with an Unknown Error`;
109
+ }
110
+ error = e;
111
+ }
112
+ }
113
+ error[STRUCTURED] = true;
114
+ error.request = owner.request;
115
+ error.response = owner.getResponse();
116
+ error.error = error.error || error.message;
117
+ outbound.reject(error);
118
+ });
119
+ return outbound.promise;
120
+ }
121
+ function isCacheHandler(handler, index) {
122
+ return index === 0 && Boolean(handler[IS_CACHE_HANDLER]);
123
+ }
124
+ function executeNextHandler(wares, request, i, god) {
125
+ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
126
+ if (i === wares.length) {
127
+ throw new Error(`No handler was able to handle this request.`);
128
+ }
129
+ assertValidRequest(request, false);
130
+ }
131
+ const owner = new ContextOwner(request, god, i === 0);
132
+ function next(r) {
133
+ owner.nextCalled++;
134
+ return executeNextHandler(wares, r, i + 1, god);
135
+ }
136
+ const context = new Context(owner);
137
+ let outcome;
138
+ try {
139
+ outcome = wares[i].request(context, next);
140
+ if (!!outcome && isCacheHandler(wares[i], i)) {
141
+ if (!(outcome instanceof Promise)) {
142
+ setRequestResult(owner.requestId, {
143
+ isError: false,
144
+ result: ensureDoc(owner, outcome, false)
145
+ });
146
+ outcome = Promise.resolve(outcome);
147
+ }
148
+ } else if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
149
+ if (!outcome || !(outcome instanceof Promise) && !(typeof outcome === 'object' && 'then' in outcome)) {
150
+ // eslint-disable-next-line no-console
151
+ console.log({
152
+ request,
153
+ handler: wares[i],
154
+ outcome
155
+ });
156
+ if (outcome === undefined) {
157
+ throw new Error(`Expected handler.request to return a promise, instead received undefined.`);
158
+ }
159
+ throw new Error(`Expected handler.request to return a promise, instead received a synchronous value.`);
160
+ }
161
+ }
162
+ } catch (e) {
163
+ if (isCacheHandler(wares[i], i)) {
164
+ setRequestResult(owner.requestId, {
165
+ isError: true,
166
+ result: ensureDoc(owner, e, true)
167
+ });
168
+ }
169
+ outcome = Promise.reject(e);
170
+ }
171
+ const future = createFuture(owner);
172
+ if (isFuture(outcome)) {
173
+ return curryFuture(owner, outcome, future);
174
+ }
175
+ return handleOutcome(owner, outcome, future);
176
+ }
177
+ function isFuture(maybe) {
178
+ return Boolean(maybe && maybe instanceof Promise && maybe[IS_FUTURE] === true);
179
+ }
180
+ function createDeferred() {
181
+ let resolve;
182
+ let reject;
183
+ const promise = new Promise((res, rej) => {
184
+ resolve = res;
185
+ reject = rej;
186
+ });
187
+ return {
188
+ resolve,
189
+ reject,
190
+ promise
191
+ };
192
+ }
193
+ function upgradePromise(promise, future) {
194
+ promise[IS_FUTURE] = true;
195
+ // eslint-disable-next-line @typescript-eslint/unbound-method
196
+ promise.getStream = future.getStream;
197
+ // eslint-disable-next-line @typescript-eslint/unbound-method
198
+ promise.abort = future.abort;
199
+ // eslint-disable-next-line @typescript-eslint/unbound-method
200
+ promise.onFinalize = future.onFinalize;
201
+ return promise;
202
+ }
203
+ function createFuture(owner) {
204
+ const deferred = createDeferred();
205
+ let {
206
+ promise
207
+ } = deferred;
208
+ let cbs;
209
+ promise = promise.finally(() => {
210
+ owner.resolveStream();
211
+ if (cbs) {
212
+ cbs.forEach(cb => cb());
213
+ }
214
+ });
215
+ promise.onFinalize = fn => {
216
+ cbs = cbs || [];
217
+ cbs.push(fn);
218
+ };
219
+ promise[IS_FUTURE] = true;
220
+ promise.getStream = () => {
221
+ return owner.getStream();
222
+ };
223
+ promise.abort = reason => {
224
+ owner.abort(enhanceReason(reason));
225
+ };
226
+ deferred.promise = promise;
227
+ return deferred;
228
+ }
229
+ function upgradeHeaders(headers) {
230
+ headers.clone = () => {
231
+ return new Headers(headers);
232
+ };
233
+ headers.toJSON = () => {
234
+ return Array.from(headers);
235
+ };
236
+ return headers;
237
+ }
238
+ function cloneResponseProperties(response) {
239
+ const {
240
+ headers,
241
+ ok,
242
+ redirected,
243
+ status,
244
+ statusText,
245
+ type,
246
+ url
247
+ } = response;
248
+ upgradeHeaders(headers);
249
+ return {
250
+ headers: headers,
251
+ ok,
252
+ redirected,
253
+ status,
254
+ statusText,
255
+ type,
256
+ url
257
+ };
258
+ }
259
+ class ContextOwner {
260
+ hasSetStream = false;
261
+ hasSetResponse = false;
262
+ hasSubscribers = false;
263
+ stream = createDeferred();
264
+ response = null;
265
+ nextCalled = 0;
266
+ constructor(request, god, isRoot = false) {
267
+ this.isRoot = isRoot;
268
+ this.requestId = god.id;
269
+ this.controller = request.controller || god.controller;
270
+ this.stream.promise.sizeHint = 0;
271
+ if (request.controller) {
272
+ if (request.controller !== god.controller) {
273
+ god.controller.signal.addEventListener('abort', () => {
274
+ this.controller.abort(god.controller.signal.reason);
275
+ });
276
+ }
277
+ delete request.controller;
278
+ }
279
+ let enhancedRequest = Object.assign({
280
+ signal: this.controller.signal
281
+ }, request);
282
+ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
283
+ if (!request?.cacheOptions?.[SkipCache]) {
284
+ request = deepFreeze(request);
285
+ enhancedRequest = deepFreeze(enhancedRequest);
286
+ }
287
+ } else {
288
+ if (request.headers) {
289
+ upgradeHeaders(request.headers);
290
+ }
291
+ }
292
+ this.enhancedRequest = enhancedRequest;
293
+ this.request = request;
294
+ this.god = god;
295
+ this.stream.promise = this.stream.promise.then(stream => {
296
+ if (this.god.stream === stream && this.hasSubscribers) {
297
+ this.god.stream = null;
298
+ }
299
+ return stream;
300
+ });
301
+ }
302
+ get hasRequestedStream() {
303
+ return this.god.hasRequestedStream;
304
+ }
305
+ getResponse() {
306
+ if (this.hasSetResponse) {
307
+ return this.response;
308
+ }
309
+ if (this.nextCalled === 1) {
310
+ return this.god.response;
311
+ }
312
+ return null;
313
+ }
314
+ getStream() {
315
+ if (this.isRoot) {
316
+ this.god.hasRequestedStream = true;
317
+ }
318
+ if (!this.hasSetResponse) {
319
+ const hint = this.god.response?.headers?.get('content-length');
320
+ this.stream.promise.sizeHint = hint ? parseInt(hint, 10) : 0;
321
+ }
322
+ this.hasSubscribers = true;
323
+ return this.stream.promise;
324
+ }
325
+ abort(reason) {
326
+ this.controller.abort(reason);
327
+ }
328
+ setStream(stream) {
329
+ if (!this.hasSetStream) {
330
+ this.hasSetStream = true;
331
+ if (!(stream instanceof Promise)) {
332
+ this.god.stream = stream;
333
+ }
334
+ // @ts-expect-error
335
+ this.stream.resolve(stream);
336
+ }
337
+ }
338
+ resolveStream() {
339
+ this.setStream(this.nextCalled === 1 ? this.god.stream : null);
340
+ }
341
+ setResponse(response) {
342
+ if (this.hasSetResponse) {
343
+ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
344
+ throw new Error(`Cannot setResponse when a response has already been set`);
345
+ }
346
+ return;
347
+ }
348
+ this.hasSetResponse = true;
349
+ if (response instanceof Response) {
350
+ // TODO potentially avoid cloning in prod
351
+ let responseData = cloneResponseProperties(response);
352
+ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
353
+ responseData = deepFreeze(responseData);
354
+ }
355
+ this.response = responseData;
356
+ this.god.response = responseData;
357
+ const sizeHint = response.headers?.get('content-length');
358
+ this.stream.promise.sizeHint = sizeHint ? parseInt(sizeHint, 10) : 0;
359
+ } else {
360
+ this.response = response;
361
+ this.god.response = response;
362
+ }
363
+ }
364
+ }
365
+ class Context {
366
+ #owner;
367
+ constructor(owner) {
368
+ this.id = owner.requestId;
369
+ this.#owner = owner;
370
+ this.request = owner.enhancedRequest;
371
+ }
372
+ setStream(stream) {
373
+ this.#owner.setStream(stream);
374
+ }
375
+ setResponse(response) {
376
+ this.#owner.setResponse(response);
377
+ }
378
+ get hasRequestedStream() {
379
+ return this.#owner.hasRequestedStream;
380
+ }
381
+ }
382
+ const BODY_TYPES = {
383
+ type: 'string',
384
+ klass: ['Blob', 'ArrayBuffer', 'TypedArray', 'DataView', 'FormData', 'URLSearchParams', 'ReadableStream']
385
+ };
386
+ const ValidKeys = new Map([['records', 'array'], ['data', 'json'], ['body', BODY_TYPES], ['disableTestWaiter', 'boolean'], ['options', 'object'], ['cacheOptions', 'object'], ['op', 'string'], ['store', 'object'], ['url', 'string'], ['cache', ['default', 'force-cache', 'no-cache', 'no-store', 'only-if-cached', 'reload']], ['credentials', ['include', 'omit', 'same-origin']], ['destination', ['', 'object', 'audio', 'audioworklet', 'document', 'embed', 'font', 'frame', 'iframe', 'image', 'manifest', 'paintworklet', 'report', 'script', 'sharedworker', 'style', 'track', 'video', 'worker', 'xslt']], ['headers', 'headers'], ['integrity', 'string'], ['keepalive', 'boolean'], ['method', ['GET', 'PUT', 'PATCH', 'DELETE', 'POST', 'OPTIONS']], ['mode', ['same-origin', 'cors', 'navigate', 'no-cors']], ['redirect', ['error', 'follow', 'manual']], ['referrer', 'string'], ['signal', 'AbortSignal'], ['controller', 'AbortController'], ['referrerPolicy', ['', 'same-origin', 'no-referrer', 'no-referrer-when-downgrade', 'origin', 'origin-when-cross-origin', 'strict-origin', 'strict-origin-when-cross-origin', 'unsafe-url']]]);
387
+ const IS_FROZEN = getOrSetGlobal('IS_FROZEN', Symbol('FROZEN'));
388
+ const IS_COLLECTION = getOrSetGlobal('IS_COLLECTION', Symbol.for('Collection'));
389
+ function freezeHeaders(headers) {
390
+ headers.delete = headers.set = headers.append = () => {
391
+ throw new Error(`Cannot Mutate Immutatable Headers, use headers.clone to get a copy`);
392
+ };
393
+ upgradeHeaders(headers);
394
+ return headers;
395
+ }
396
+ function deepFreeze(value) {
397
+ if (value && value[IS_FROZEN]) {
398
+ return value;
399
+ }
400
+ const _type = typeof value;
401
+ switch (_type) {
402
+ case 'boolean':
403
+ case 'string':
404
+ case 'number':
405
+ case 'symbol':
406
+ case 'undefined':
407
+ case 'bigint':
408
+ return value;
409
+ case 'function':
410
+ throw new Error(`Cannot deep-freeze a function`);
411
+ case 'object':
412
+ {
413
+ const _niceType = niceTypeOf(value);
414
+ switch (_niceType) {
415
+ case 'array':
416
+ {
417
+ if (value[IS_COLLECTION]) {
418
+ return value;
419
+ }
420
+ const arr = value.map(deepFreeze);
421
+ arr[IS_FROZEN] = true;
422
+ return Object.freeze(arr);
423
+ }
424
+ case 'null':
425
+ return value;
426
+ case 'object':
427
+ Object.keys(value).forEach(key => {
428
+ try {
429
+ value[key] = deepFreeze(value[key]);
430
+ } catch {
431
+ // continue
432
+ }
433
+ });
434
+ value[IS_FROZEN] = true;
435
+ return Object.freeze(value);
436
+ case 'headers':
437
+ return freezeHeaders(value);
438
+ case 'Collection':
439
+ case 'Store':
440
+ case 'AbortSignal':
441
+ return value;
442
+ case 'date':
443
+ case 'map':
444
+ case 'set':
445
+ case 'error':
446
+ case 'stream':
447
+ default:
448
+ // console.log(`Cannot deep-freeze ${_niceType}`);
449
+ return value;
450
+ }
451
+ }
452
+ }
453
+ }
454
+ function isMaybeContext(request) {
455
+ if (request && typeof request === 'object') {
456
+ const keys = Object.keys(request);
457
+ if (keys.length === 1 && keys[0] === 'request') {
458
+ return true;
459
+ }
460
+ }
461
+ return false;
462
+ }
463
+ function niceTypeOf(v) {
464
+ if (v === null) {
465
+ return 'null';
466
+ }
467
+ if (typeof v === 'string') {
468
+ return v ? 'non-empty-string' : 'empty-string';
469
+ }
470
+ if (!v) {
471
+ return typeof v;
472
+ }
473
+ if (Array.isArray(v)) {
474
+ return 'array';
475
+ }
476
+ if (v instanceof Date) {
477
+ return 'date';
478
+ }
479
+ if (v instanceof Map) {
480
+ return 'map';
481
+ }
482
+ if (v instanceof Set) {
483
+ return 'set';
484
+ }
485
+ if (v instanceof Error) {
486
+ return 'error';
487
+ }
488
+ if (v instanceof ReadableStream || v instanceof WritableStream || v instanceof TransformStream) {
489
+ return 'stream';
490
+ }
491
+ if (v instanceof Headers) {
492
+ return 'headers';
493
+ }
494
+ if (typeof v === 'object' && v.constructor && v.constructor.name !== 'Object') {
495
+ return v.constructor.name;
496
+ }
497
+ return typeof v;
498
+ }
499
+ function validateKey(key, value, errors) {
500
+ const schema = ValidKeys.get(key);
501
+ if (!schema && !IgnoredKeys.has(key)) {
502
+ errors.push(`InvalidKey: '${key}'`);
503
+ return;
504
+ }
505
+ if (schema) {
506
+ if (schema === BODY_TYPES) {
507
+ if (typeof value === 'string' || value instanceof ReadableStream) {
508
+ return;
509
+ }
510
+ const type = niceTypeOf(value);
511
+ if (schema.klass.includes(type)) {
512
+ return;
513
+ }
514
+ errors.push(`InvalidValue: key 'body' should be a string or one of '${schema.klass.join("', '")}', received ${'<a value of type ' + niceTypeOf(value) + '>'}`);
515
+ return;
516
+ }
517
+ if (Array.isArray(schema)) {
518
+ if (!schema.includes(value)) {
519
+ errors.push(`InvalidValue: key ${key} should be a one of '${schema.join("', '")}', received ${typeof value === 'string' ? value : '<a value of type ' + niceTypeOf(value) + '>'}`);
520
+ }
521
+ return;
522
+ } else if (schema === 'json') {
523
+ try {
524
+ JSON.stringify(value);
525
+ } catch (e) {
526
+ errors.push(`InvalidValue: key ${key} should be a JSON serializable value, but failed to serialize with Error - ${e.message}`);
527
+ }
528
+ return;
529
+ } else if (schema === 'headers') {
530
+ if (!(value instanceof Headers)) {
531
+ errors.push(`InvalidValue: key ${key} should be an instance of Headers, received ${niceTypeOf(value)}`);
532
+ }
533
+ return;
534
+ } else if (schema === 'record') {
535
+ const _type = typeof value;
536
+ // record must extend plain object or Object.create(null)
537
+ if (!value || _type !== 'object' || value.constructor && value.constructor !== Object) {
538
+ errors.push(`InvalidValue: key ${key} should be a dictionary of string keys to string values, received ${niceTypeOf(value)}`);
539
+ return;
540
+ }
541
+ const keys = Object.keys(value);
542
+ keys.forEach(k => {
543
+ const v = value[k];
544
+ if (typeof k !== 'string') {
545
+ errors.push(`\tThe key ${String(k)} on ${key} should be a string key`);
546
+ } else if (typeof v !== 'string') {
547
+ errors.push(`\tThe value of ${key}.${k} should be a string not ${niceTypeOf(v)}`);
548
+ }
549
+ });
550
+ return;
551
+ } else if (schema === 'string') {
552
+ if (typeof value !== 'string' || value.length === 0) {
553
+ errors.push(`InvalidValue: key ${key} should be a non-empty string, received ${typeof value === 'string' ? "''" : typeof value}`);
554
+ }
555
+ return;
556
+ } else if (schema === 'object') {
557
+ if (!value || Array.isArray(value) || typeof value !== 'object') {
558
+ errors.push(`InvalidValue: key ${key} should be an object`);
559
+ }
560
+ return;
561
+ } else if (schema === 'boolean') {
562
+ if (typeof value !== 'boolean') {
563
+ errors.push(`InvalidValue: key ${key} should be a boolean, received ${typeof value}`);
564
+ }
565
+ return;
566
+ } else if (schema === 'array') {
567
+ if (!Array.isArray(value)) {
568
+ errors.push(`InvalidValue: key ${key} should be an array, received ${typeof value}`);
569
+ }
570
+ return;
571
+ }
572
+ }
573
+ }
574
+ const IgnoredKeys = new Set([]);
575
+ function assertValidRequest(request, isTopLevel) {
576
+ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
577
+ // handle basic shape
578
+ if (!request) {
579
+ throw new Error(`Expected ${isTopLevel ? 'RequestManager.request' : 'next'}(<request>) to be called with a request, but none was provided.`);
580
+ }
581
+ if (Array.isArray(request) || typeof request !== 'object') {
582
+ throw new Error(`The \`request\` passed to \`${isTopLevel ? 'RequestManager.request' : 'next'}(<request>)\` should be an object, received \`${niceTypeOf(request)}\``);
583
+ }
584
+ if (Object.keys(request).length === 0) {
585
+ throw new Error(`The \`request\` passed to \`${isTopLevel ? 'RequestManager.request' : 'next'}(<request>)\` was empty (\`{}\`). Requests need at least one valid key.`);
586
+ }
587
+
588
+ // handle accidentally passing context entirely
589
+ if (request instanceof Context) {
590
+ throw new Error(`Expected a request passed to \`${isTopLevel ? 'RequestManager.request' : 'next'}(<request>)\` but received the previous handler's context instead`);
591
+ }
592
+ // handle Object.assign({}, context);
593
+ if (isMaybeContext(request)) {
594
+ throw new Error(`Expected a request passed to \`${isTopLevel ? 'RequestManager.request' : 'next'}(<request>)\` but received an object with a request key instead.`);
595
+ }
596
+
597
+ // handle schema
598
+ const keys = Object.keys(request);
599
+ const validationErrors = [];
600
+ const isLegacyRequest = Boolean('op' in request && !request.url);
601
+ keys.forEach(key => {
602
+ if (isLegacyRequest && key === 'data') {
603
+ return;
604
+ }
605
+ validateKey(key, request[key], validationErrors);
606
+ });
607
+ if (validationErrors.length) {
608
+ const error = new Error(`Invalid Request passed to \`${isTopLevel ? 'RequestManager.request' : 'next'}(<request>)\`.\n\nThe following issues were found:\n\n\t${validationErrors.join('\n\t')}`);
609
+ error.errors = validationErrors;
610
+ throw error;
611
+ }
612
+ }
613
+ }
614
+ export { IS_CACHE_HANDLER as I, assertValidRequest as a, createDeferred as b, clearRequestResult as c, getPromiseResult as d, executeNextHandler as e, cloneResponseProperties as f, getRequestResult as g, setPromiseResult as s, upgradePromise as u };