@warp-drive-mirror/experiments 0.2.8 → 5.9.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 (103) hide show
  1. package/README.md +2 -1
  2. package/dist/data-worker.d.ts +35 -0
  3. package/dist/data-worker.d.ts.map +1 -0
  4. package/dist/data-worker.js +235 -339
  5. package/dist/data-worker.js.map +1 -0
  6. package/dist/document-storage-CwwTQ49-.d.ts +91 -0
  7. package/dist/document-storage-CwwTQ49-.d.ts.map +1 -0
  8. package/dist/document-storage-LM925Stz.js +270 -0
  9. package/dist/document-storage-LM925Stz.js.map +1 -0
  10. package/dist/document-storage.d.ts +2 -0
  11. package/dist/document-storage.js +3 -1
  12. package/dist/image-fetch.d.ts +60 -0
  13. package/dist/image-fetch.d.ts.map +1 -0
  14. package/dist/image-fetch.js +108 -79
  15. package/dist/image-fetch.js.map +1 -0
  16. package/dist/image-worker.d.ts +40 -0
  17. package/dist/image-worker.d.ts.map +1 -0
  18. package/dist/image-worker.js +95 -95
  19. package/dist/image-worker.js.map +1 -0
  20. package/dist/pagination.d.ts +2 -0
  21. package/dist/pagination.js +3 -0
  22. package/dist/storage.d.ts +354 -0
  23. package/dist/storage.d.ts.map +1 -0
  24. package/dist/storage.js +914 -0
  25. package/dist/storage.js.map +1 -0
  26. package/dist/types-CRs-Qww6.d.ts +17 -0
  27. package/dist/types-CRs-Qww6.d.ts.map +1 -0
  28. package/dist/unpkg/dev/data-worker.js +231 -338
  29. package/dist/unpkg/dev/data-worker.js.map +1 -0
  30. package/dist/unpkg/dev/document-storage-DkiEg9rY.js +268 -0
  31. package/dist/unpkg/dev/document-storage-DkiEg9rY.js.map +1 -0
  32. package/dist/unpkg/dev/document-storage.js +2 -348
  33. package/dist/unpkg/dev/image-fetch.js +104 -71
  34. package/dist/unpkg/dev/image-fetch.js.map +1 -0
  35. package/dist/unpkg/dev/image-worker.js +93 -94
  36. package/dist/unpkg/dev/image-worker.js.map +1 -0
  37. package/dist/unpkg/dev/pagination.js +3 -0
  38. package/dist/unpkg/dev/storage.js +913 -0
  39. package/dist/unpkg/dev/storage.js.map +1 -0
  40. package/dist/unpkg/dev/worker-fetch.js +112 -145
  41. package/dist/unpkg/dev/worker-fetch.js.map +1 -0
  42. package/dist/unpkg/dev-deprecated/data-worker.js +231 -338
  43. package/dist/unpkg/dev-deprecated/data-worker.js.map +1 -0
  44. package/dist/unpkg/dev-deprecated/document-storage-DkiEg9rY.js +268 -0
  45. package/dist/unpkg/dev-deprecated/document-storage-DkiEg9rY.js.map +1 -0
  46. package/dist/unpkg/dev-deprecated/document-storage.js +2 -348
  47. package/dist/unpkg/dev-deprecated/image-fetch.js +104 -71
  48. package/dist/unpkg/dev-deprecated/image-fetch.js.map +1 -0
  49. package/dist/unpkg/dev-deprecated/image-worker.js +93 -94
  50. package/dist/unpkg/dev-deprecated/image-worker.js.map +1 -0
  51. package/dist/unpkg/dev-deprecated/pagination.js +3 -0
  52. package/dist/unpkg/dev-deprecated/storage.js +913 -0
  53. package/dist/unpkg/dev-deprecated/storage.js.map +1 -0
  54. package/dist/unpkg/dev-deprecated/worker-fetch.js +112 -145
  55. package/dist/unpkg/dev-deprecated/worker-fetch.js.map +1 -0
  56. package/dist/unpkg/prod/data-worker.js +224 -324
  57. package/dist/unpkg/prod/data-worker.js.map +1 -0
  58. package/dist/unpkg/prod/document-storage-D0k_6GM9.js +262 -0
  59. package/dist/unpkg/prod/document-storage-D0k_6GM9.js.map +1 -0
  60. package/dist/unpkg/prod/document-storage.js +2 -338
  61. package/dist/unpkg/prod/image-fetch.js +101 -71
  62. package/dist/unpkg/prod/image-fetch.js.map +1 -0
  63. package/dist/unpkg/prod/image-worker.js +93 -94
  64. package/dist/unpkg/prod/image-worker.js.map +1 -0
  65. package/dist/unpkg/prod/pagination.js +3 -0
  66. package/dist/unpkg/prod/storage.js +844 -0
  67. package/dist/unpkg/prod/storage.js.map +1 -0
  68. package/dist/unpkg/prod/worker-fetch.js +109 -145
  69. package/dist/unpkg/prod/worker-fetch.js.map +1 -0
  70. package/dist/unpkg/prod-deprecated/data-worker.js +224 -324
  71. package/dist/unpkg/prod-deprecated/data-worker.js.map +1 -0
  72. package/dist/unpkg/prod-deprecated/document-storage-D0k_6GM9.js +262 -0
  73. package/dist/unpkg/prod-deprecated/document-storage-D0k_6GM9.js.map +1 -0
  74. package/dist/unpkg/prod-deprecated/document-storage.js +2 -338
  75. package/dist/unpkg/prod-deprecated/image-fetch.js +101 -71
  76. package/dist/unpkg/prod-deprecated/image-fetch.js.map +1 -0
  77. package/dist/unpkg/prod-deprecated/image-worker.js +93 -94
  78. package/dist/unpkg/prod-deprecated/image-worker.js.map +1 -0
  79. package/dist/unpkg/prod-deprecated/pagination.js +3 -0
  80. package/dist/unpkg/prod-deprecated/storage.js +844 -0
  81. package/dist/unpkg/prod-deprecated/storage.js.map +1 -0
  82. package/dist/unpkg/prod-deprecated/worker-fetch.js +109 -145
  83. package/dist/unpkg/prod-deprecated/worker-fetch.js.map +1 -0
  84. package/dist/worker-fetch.d.ts +23 -0
  85. package/dist/worker-fetch.d.ts.map +1 -0
  86. package/dist/worker-fetch.js +116 -153
  87. package/dist/worker-fetch.js.map +1 -0
  88. package/package.json +27 -23
  89. package/declarations/data-worker/cache-handler.d.ts +0 -7
  90. package/declarations/data-worker/fetch.d.ts +0 -21
  91. package/declarations/data-worker/types.d.ts +0 -31
  92. package/declarations/data-worker/utils.d.ts +0 -12
  93. package/declarations/data-worker/worker.d.ts +0 -23
  94. package/declarations/data-worker.d.ts +0 -2
  95. package/declarations/document-storage/index.d.ts +0 -90
  96. package/declarations/document-storage.d.ts +0 -1
  97. package/declarations/image-fetch.d.ts +0 -1
  98. package/declarations/image-worker/fetch.d.ts +0 -18
  99. package/declarations/image-worker/types.d.ts +0 -21
  100. package/declarations/image-worker/worker.d.ts +0 -14
  101. package/declarations/image-worker.d.ts +0 -1
  102. package/declarations/worker-fetch.d.ts +0 -1
  103. package/dist/index-CGCX7hY2.js +0 -349
@@ -1,349 +1,3 @@
1
- const WARP_DRIVE_STORAGE_FILE_NAME = 'warp-drive_document-storage';
2
- const WARP_DRIVE_STORAGE_VERSION = 1;
1
+ import { t as DocumentStorage } from "./document-storage-DkiEg9rY.js";
3
2
 
4
- /**
5
- * DocumentStorage is specifically designed around WarpDrive Cache and Request concepts.
6
- *
7
- * CacheFileDocument is a StructuredDocument (request response) whose `content` is
8
- * the ResourceDocument returned by inserting the request into a Store's Cache.
9
- */
10
-
11
- /**
12
- * A CacheDocument is a reconstructed request response that rehydrates ResourceDocument
13
- * with the associated resources based on their identifiers.
14
- */
15
-
16
- class InternalDocumentStorage {
17
- constructor(options) {
18
- this.options = options;
19
- this._lastModified = 0;
20
- this._invalidated = true;
21
- this._fileHandle = this._open(options.scope);
22
- this._channel = Object.assign(new BroadcastChannel(options.scope), {
23
- onmessage: this._onMessage.bind(this)
24
- });
25
- }
26
- _onMessage(_event) {
27
- this._invalidated = true;
28
- }
29
- async _open(scope) {
30
- const directoryHandle = await navigator.storage.getDirectory();
31
- const fileHandle = await directoryHandle.getFileHandle(scope, {
32
- create: true
33
- });
34
- return fileHandle;
35
- }
36
- async _read() {
37
- if (this._filePromise) {
38
- return this._filePromise;
39
- }
40
- if (this._invalidated) {
41
- const updateFile = async () => {
42
- const fileHandle = await this._fileHandle;
43
- const file = await fileHandle.getFile();
44
- const lastModified = file.lastModified;
45
- if (lastModified === this._lastModified && this._cache) {
46
- return this._cache;
47
- }
48
- const contents = await file.text();
49
- const cache = contents ? JSON.parse(contents) : {
50
- documents: [],
51
- resources: []
52
- };
53
- const documents = new Map(cache.documents);
54
- const resources = new Map(cache.resources);
55
- const cacheMap = {
56
- documents,
57
- resources
58
- };
59
- this._cache = cacheMap;
60
- this._invalidated = false;
61
- this._lastModified = lastModified;
62
- return cacheMap;
63
- };
64
- this._filePromise = updateFile();
65
- await this._filePromise;
66
- this._filePromise = null;
67
- }
68
- return this._cache;
69
- }
70
- async _patch(documentKey, document, updatedResources) {
71
- const fileHandle = await this._fileHandle;
72
- // secure a lock before getting latest state
73
- const writable = await fileHandle.createWritable();
74
- const cache = await this._read();
75
- cache.documents.set(documentKey, document);
76
- updatedResources.forEach((resource, key) => {
77
- cache.resources.set(key, resource);
78
- });
79
- const documents = [...cache.documents.entries()];
80
- const resources = [...cache.resources.entries()];
81
- const cacheFile = {
82
- documents,
83
- resources
84
- };
85
- await writable.write(JSON.stringify(cacheFile));
86
- await writable.close();
87
- this._channel.postMessage({
88
- type: 'patch',
89
- key: documentKey,
90
- resources: [...updatedResources.keys()]
91
- });
92
- }
93
- async getDocument(key) {
94
- const cache = await this._read();
95
- // clone the document to avoid leaking the internal cache
96
- const document = safeDocumentHydrate(cache.documents.get(key.lid));
97
- if (!document) {
98
- return null;
99
- }
100
-
101
- // expand the document with the resources
102
- if (document.content) {
103
- if (docHasData(document.content)) {
104
- let data = null;
105
- if (Array.isArray(document.content.data)) {
106
- data = document.content.data.map(resourceIdentifier => {
107
- const resource = cache.resources.get(resourceIdentifier.lid);
108
- if (!resource) {
109
- throw new Error(`Resource not found for ${resourceIdentifier.lid}`);
110
- }
111
-
112
- // clone the resource to avoid leaking the internal cache
113
- return structuredClone(resource);
114
- });
115
- } else if (document.content.data) {
116
- const resource = cache.resources.get(document.content.data.lid);
117
- if (!resource) {
118
- throw new Error(`Resource not found for ${document.content.data.lid}`);
119
- }
120
-
121
- // clone the resource to avoid leaking the internal cache
122
- data = structuredClone(resource);
123
- }
124
- if (document.content.included) {
125
- const included = document.content.included.map(resourceIdentifier => {
126
- const resource = cache.resources.get(resourceIdentifier.lid);
127
- if (!resource) {
128
- throw new Error(`Resource not found for ${resourceIdentifier.lid}`);
129
- }
130
-
131
- // clone the resource to avoid leaking the internal cache
132
- return structuredClone(resource);
133
- });
134
- document.content.included = included;
135
- }
136
- document.content.data = data;
137
- }
138
- }
139
- return document;
140
- }
141
- async putDocument(document, resourceCollector) {
142
- const resources = new Map();
143
- if (!document.content) {
144
- throw new Error(`Document content is missing, only finalized documents can be stored`);
145
- }
146
- if (!document.content.lid) {
147
- throw new Error(`Document content is missing a lid, only documents with a cache-key can be stored`);
148
- }
149
- if (docHasData(document.content)) {
150
- this._getResources(document.content, resourceCollector, resources);
151
- }
152
- await this._patch(document.content.lid, safeDocumentSerialize(document), resources);
153
- }
154
- _getResources(document, resourceCollector, resources = new Map()) {
155
- if (Array.isArray(document.data)) {
156
- document.data.forEach(resourceIdentifier => {
157
- const resource = resourceCollector(resourceIdentifier);
158
- resources.set(resourceIdentifier.lid, structuredClone(resource));
159
- });
160
- } else if (document.data) {
161
- const resource = resourceCollector(document.data);
162
- resources.set(document.data.lid, structuredClone(resource));
163
- }
164
- if (document.included) {
165
- document.included.forEach(resourceIdentifier => {
166
- const resource = resourceCollector(resourceIdentifier);
167
- resources.set(resourceIdentifier.lid, structuredClone(resource));
168
- });
169
- }
170
- return resources;
171
- }
172
- async putResources(document, resourceCollector) {
173
- const fileHandle = await this._fileHandle;
174
- // secure a lock before getting latest state
175
- const writable = await fileHandle.createWritable();
176
- const cache = await this._read();
177
- const updatedResources = this._getResources(document, resourceCollector);
178
- updatedResources.forEach((resource, key) => {
179
- cache.resources.set(key, resource);
180
- });
181
- const documents = [...cache.documents.entries()];
182
- const resources = [...cache.resources.entries()];
183
- const cacheFile = {
184
- documents,
185
- resources
186
- };
187
- await writable.write(JSON.stringify(cacheFile));
188
- await writable.close();
189
- this._channel.postMessage({
190
- type: 'patch',
191
- key: null,
192
- resources: [...updatedResources.keys()]
193
- });
194
- }
195
- async clear(reset) {
196
- const fileHandle = await this._fileHandle;
197
- const writable = await fileHandle.createWritable();
198
- await writable.write('');
199
- await writable.close();
200
- this._invalidated = true;
201
- this._lastModified = 0;
202
- this._cache = null;
203
- this._filePromise = null;
204
- this._channel.postMessage({
205
- type: 'clear'
206
- });
207
- if (!reset) {
208
- this._channel.close();
209
- this._channel = null;
210
- if (!this.options.isolated) {
211
- Storages.delete(this.options.scope);
212
- }
213
- }
214
- }
215
- }
216
- function safeDocumentSerialize(document) {
217
- (test => {
218
- if (!test) {
219
- throw new Error(`Expected to receive a document`);
220
- }
221
- })(document && typeof document === 'object');
222
- const doc = document;
223
- const newDoc = {};
224
- if ('request' in doc) {
225
- newDoc.request = prepareRequest(doc.request);
226
- }
227
- if ('response' in doc) {
228
- newDoc.response = prepareResponse(doc.response);
229
- }
230
- if ('content' in doc) {
231
- newDoc.content = structuredClone(doc.content);
232
- }
233
- return newDoc;
234
- }
235
- function prepareRequest(request) {
236
- const {
237
- signal,
238
- headers
239
- } = request;
240
- const requestCopy = Object.assign({}, request);
241
- delete requestCopy.store;
242
- if (signal instanceof AbortSignal) {
243
- delete requestCopy.signal;
244
- }
245
- if (headers instanceof Headers) {
246
- requestCopy.headers = Array.from(headers);
247
- }
248
- return requestCopy;
249
- }
250
- function prepareResponse(response) {
251
- if (!response) return null;
252
- const clone = {};
253
- if (response.headers) {
254
- clone.headers = Array.from(response.headers);
255
- }
256
- clone.ok = response.ok;
257
- clone.redirected = response.redirected;
258
- clone.status = response.status;
259
- clone.statusText = response.statusText;
260
- clone.type = response.type;
261
- clone.url = response.url;
262
- return clone;
263
- }
264
- function safeDocumentHydrate(document) {
265
- (test => {
266
- if (!test) {
267
- throw new Error(`Expected to receive a document`);
268
- }
269
- })(document && typeof document === 'object');
270
- const doc = document;
271
- const newDoc = {};
272
- if ('request' in doc) {
273
- const headers = new Headers(doc.request.headers);
274
- const req = Object.assign({}, doc.request, {
275
- headers
276
- });
277
- newDoc.request = new Request(doc.request.url ?? '', req);
278
- }
279
- if ('response' in doc) {
280
- const headers = new Headers(doc.response.headers);
281
- const resp = Object.assign({}, doc.response, {
282
- headers
283
- });
284
- newDoc.response = new Response(null, resp);
285
- }
286
- if ('content' in doc) {
287
- newDoc.content = structuredClone(doc.content);
288
- }
289
- return newDoc;
290
- }
291
- function docHasData(doc) {
292
- return 'data' in doc;
293
- }
294
- const Storages = new Map();
295
-
296
- /**
297
- * DocumentStorage is a wrapper around the StorageManager API that provides
298
- * a simple interface for reading and updating documents and requests.
299
- *
300
- * Some goals for this experiment:
301
- *
302
- * - optimize for storing requests/documents
303
- * - optimize for storing resources
304
- * - optimize for looking up resources associated to a document
305
- * - optimize for notifying cross-tab when data is updated
306
- *
307
- * optional features:
308
- *
309
- * - support for offline mode
310
- * - ?? support for relationship based cache traversal
311
- * - a way to index records by type + another field (e.g updatedAt/createAt/name)
312
- * such that simple queries can be done without having to scan all records
313
- */
314
- class DocumentStorage {
315
- constructor(options = {}) {
316
- options.isolated = options.isolated ?? false;
317
- options.scope = options.scope ?? 'default';
318
- const fileName = `${WARP_DRIVE_STORAGE_FILE_NAME}@version_${WARP_DRIVE_STORAGE_VERSION}:${options.scope}`;
319
- if (!options.isolated && Storages.has(fileName)) {
320
- const storage = Storages.get(fileName);
321
- if (storage) {
322
- this._storage = storage.deref();
323
- return;
324
- }
325
- }
326
- const storage = new InternalDocumentStorage({
327
- scope: fileName,
328
- isolated: options.isolated
329
- });
330
- this._storage = storage;
331
- if (!options.isolated) {
332
- Storages.set(fileName, new WeakRef(storage));
333
- }
334
- }
335
- getDocument(key) {
336
- return this._storage.getDocument(key);
337
- }
338
- putDocument(document, resourceCollector) {
339
- return this._storage.putDocument(document, resourceCollector);
340
- }
341
- putResources(document, resourceCollector) {
342
- return this._storage.putResources(document, resourceCollector);
343
- }
344
- clear(reset) {
345
- return this._storage.clear(reset);
346
- }
347
- }
348
-
349
- export { DocumentStorage };
3
+ export { DocumentStorage };
@@ -1,74 +1,107 @@
1
- import { createDeferred } from '@warp-drive-mirror/core/request';
1
+ import { createDeferred } from "@warp-drive-mirror/core/request";
2
2
 
3
- // @ts-expect-error untyped global
4
- const isServerEnv = typeof FastBoot !== 'undefined';
5
- class ImageFetch {
6
- constructor(worker) {
7
- this.threadId = isServerEnv ? '' : crypto.randomUUID();
8
- this.pending = new Map();
9
- this.cache = new Map();
10
- this.worker = worker;
11
- if (!isServerEnv) {
12
- const fn = event => {
13
- const {
14
- type,
15
- url
16
- } = event.data;
17
- const deferred = this.cleanupRequest(url);
18
- if (!deferred) {
19
- return;
20
- }
21
- if (type === 'success-response') {
22
- deferred.resolve(url);
23
- return;
24
- }
25
- if (type === 'error-response') {
26
- deferred.reject(null);
27
- return;
28
- }
29
- };
30
- if (worker instanceof SharedWorker) {
31
- worker.port.postMessage({
32
- type: 'connect',
33
- thread: this.threadId
34
- });
35
- worker.port.onmessage = fn;
36
- } else if (worker) {
37
- this.channel = new MessageChannel();
38
- worker.postMessage({
39
- type: 'connect',
40
- thread: this.threadId
41
- }, [this.channel.port2]);
42
- this.channel.port1.onmessage = fn;
43
- }
44
- }
45
- }
46
- cleanupRequest(url) {
47
- const deferred = this.pending.get(url);
48
- this.pending.delete(url);
49
- return deferred;
50
- }
51
- _send(event) {
52
- // eslint-disable-next-line @typescript-eslint/no-unused-expressions
53
- this.worker instanceof SharedWorker ? this.worker.port.postMessage(event) : this.channel.port1.postMessage(event);
54
- }
55
- load(url) {
56
- if (isServerEnv) {
57
- return Promise.resolve(url);
58
- }
59
- const objectUrl = this.cache.get(url);
60
- if (objectUrl) {
61
- return Promise.resolve(objectUrl);
62
- }
63
- const deferred = createDeferred();
64
- this.pending.set(url, deferred);
65
- this._send({
66
- type: 'load',
67
- thread: this.threadId,
68
- url
69
- });
70
- return deferred.promise;
71
- }
72
- }
3
+ //#region src/image-worker/fetch.ts
4
+ const isServerEnv = typeof FastBoot !== "undefined";
5
+ /**
6
+ * Main-thread client for an {@link ImageWorker}. Sends image `load`
7
+ * requests to a `Worker` or `SharedWorker` running an `ImageWorker`.
8
+ *
9
+ * In FastBoot/SSR, or when constructed with a `null` worker, `ImageFetch`
10
+ * skips worker communication entirely: {@link ImageFetch.load} resolves
11
+ * immediately with the given url.
12
+ *
13
+ * A plain `Worker` is only accepted when running in a `TESTING` build;
14
+ * production usage requires a `SharedWorker`.
15
+ *
16
+ * @public
17
+ */
18
+ var ImageFetch = class {
19
+ /**
20
+ * @param worker - the `Worker` or `SharedWorker` running an
21
+ * {@link ImageWorker}, or `null` to disable worker communication (e.g.
22
+ * in FastBoot/SSR).
23
+ */
24
+ constructor(worker) {
25
+ this.threadId = isServerEnv ? "" : crypto.randomUUID();
26
+ this.pending = /* @__PURE__ */ new Map();
27
+ this.cache = /* @__PURE__ */ new Map();
28
+ ((test) => {
29
+ if (!test) throw new Error(`Expected a SharedWorker instance`);
30
+ })(true);
31
+ this.worker = worker;
32
+ if (!isServerEnv) {
33
+ const fn = (event) => {
34
+ const { type, url } = event.data;
35
+ const deferred = this.cleanupRequest(url);
36
+ if (!deferred) return;
37
+ if (type === "success-response") {
38
+ const { objectUrl } = event.data;
39
+ this.cache.set(url, objectUrl);
40
+ deferred.resolve(objectUrl);
41
+ return;
42
+ }
43
+ if (type === "error-response") {
44
+ deferred.reject(null);
45
+ return;
46
+ }
47
+ };
48
+ if (worker instanceof SharedWorker) {
49
+ worker.port.postMessage({
50
+ type: "connect",
51
+ thread: this.threadId
52
+ });
53
+ worker.port.onmessage = fn;
54
+ } else if (worker) {
55
+ this.channel = new MessageChannel();
56
+ worker.postMessage({
57
+ type: "connect",
58
+ thread: this.threadId
59
+ }, [this.channel.port2]);
60
+ this.channel.port1.onmessage = fn;
61
+ }
62
+ }
63
+ }
64
+ cleanupRequest(url) {
65
+ const deferred = this.pending.get(url);
66
+ this.pending.delete(url);
67
+ return deferred;
68
+ }
69
+ _send(event) {
70
+ this.worker instanceof SharedWorker ? this.worker.port.postMessage(event) : this.channel.port1.postMessage(event);
71
+ }
72
+ /**
73
+ * Requests that the given image url be loaded by the connected
74
+ * {@link ImageWorker}, resolving with an object url for the fetched
75
+ * image's blob once the worker responds (or immediately with the
76
+ * original `url`, in SSR/FastBoot or when this instance was constructed
77
+ * with a `null` worker).
78
+ *
79
+ * The resolved object url is cached in-memory by source url on this
80
+ * instance, so subsequent calls for the same url resolve immediately
81
+ * without another round-trip to the worker.
82
+ *
83
+ * Calling `load` again for a url that is already in-flight (not yet
84
+ * cached) on this instance replaces the pending request rather than
85
+ * joining it — only the most recently issued call for a given url will
86
+ * resolve.
87
+ *
88
+ * @public
89
+ */
90
+ load(url) {
91
+ if (isServerEnv) return Promise.resolve(url);
92
+ const objectUrl = this.cache.get(url);
93
+ if (objectUrl) return Promise.resolve(objectUrl);
94
+ const deferred = createDeferred();
95
+ this.pending.set(url, deferred);
96
+ this._send({
97
+ type: "load",
98
+ thread: this.threadId,
99
+ url
100
+ });
101
+ return deferred.promise;
102
+ }
103
+ };
73
104
 
105
+ //#endregion
74
106
  export { ImageFetch };
107
+ //# sourceMappingURL=image-fetch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-fetch.js","names":["createDeferred","isServerEnv","FastBoot","ImageFetch","constructor","worker","threadId","crypto","randomUUID","pending","Map","cache","isTesting","test","Error","SharedWorker","fn","event","type","url","data","deferred","cleanupRequest","objectUrl","set","resolve","reject","port","postMessage","thread","onmessage","channel","MessageChannel","port2","port1","get","delete","_send","load","Promise","promise"],"sources":["../../../src/image-worker/fetch.ts"],"sourcesContent":["import { TESTING } from '@warp-drive-mirror/core/build-config/env';\nimport { assert } from '@warp-drive-mirror/core/build-config/macros';\nimport type { Deferred } from '@warp-drive-mirror/core/request';\nimport { createDeferred } from '@warp-drive-mirror/core/request';\n\nimport type { MainThreadEvent, RequestEventData } from './types';\n// oxlint-disable-next-line no-unused-vars\nimport type { ImageWorker } from './worker';\n\nexport interface FastBoot {\n require(moduleName: string): unknown;\n isFastBoot: boolean;\n request: Request;\n}\n\n// @ts-expect-error untyped global\nconst isServerEnv = typeof FastBoot !== 'undefined';\n\n/**\n * Main-thread client for an {@link ImageWorker}. Sends image `load`\n * requests to a `Worker` or `SharedWorker` running an `ImageWorker`.\n *\n * In FastBoot/SSR, or when constructed with a `null` worker, `ImageFetch`\n * skips worker communication entirely: {@link ImageFetch.load} resolves\n * immediately with the given url.\n *\n * A plain `Worker` is only accepted when running in a `TESTING` build;\n * production usage requires a `SharedWorker`.\n *\n * @public\n */\nexport class ImageFetch {\n declare worker: Worker | SharedWorker;\n declare threadId: string;\n declare pending: Map<string, Deferred<string>>;\n declare channel: MessageChannel;\n declare cache: Map<string, string>;\n\n /**\n * @param worker - the `Worker` or `SharedWorker` running an\n * {@link ImageWorker}, or `null` to disable worker communication (e.g.\n * in FastBoot/SSR).\n */\n constructor(worker: Worker | SharedWorker | null) {\n this.threadId = isServerEnv ? '' : crypto.randomUUID();\n this.pending = new Map();\n this.cache = new Map();\n\n const isTesting = TESTING ? true : false;\n assert(`Expected a SharedWorker instance`, isTesting || isServerEnv || worker instanceof SharedWorker);\n this.worker = worker as SharedWorker;\n\n if (!isServerEnv) {\n const fn = (event: MainThreadEvent) => {\n const { type, url } = event.data;\n const deferred = this.cleanupRequest(url);\n if (!deferred) {\n return;\n }\n\n if (type === 'success-response') {\n const { objectUrl } = event.data;\n this.cache.set(url, objectUrl);\n deferred.resolve(objectUrl);\n return;\n }\n\n if (type === 'error-response') {\n deferred.reject(null);\n return;\n }\n };\n\n if (worker instanceof SharedWorker) {\n worker.port.postMessage({ type: 'connect', thread: this.threadId });\n worker.port.onmessage = fn;\n } else if (worker) {\n this.channel = new MessageChannel();\n worker.postMessage({ type: 'connect', thread: this.threadId }, [this.channel.port2]);\n\n this.channel.port1.onmessage = fn;\n }\n }\n }\n\n cleanupRequest(url: string): Deferred<string> | undefined {\n const deferred = this.pending.get(url);\n this.pending.delete(url);\n\n return deferred;\n }\n\n _send(event: RequestEventData): void {\n // oxlint-disable-next-line no-unused-expressions\n this.worker instanceof SharedWorker ? this.worker.port.postMessage(event) : this.channel.port1.postMessage(event);\n }\n\n /**\n * Requests that the given image url be loaded by the connected\n * {@link ImageWorker}, resolving with an object url for the fetched\n * image's blob once the worker responds (or immediately with the\n * original `url`, in SSR/FastBoot or when this instance was constructed\n * with a `null` worker).\n *\n * The resolved object url is cached in-memory by source url on this\n * instance, so subsequent calls for the same url resolve immediately\n * without another round-trip to the worker.\n *\n * Calling `load` again for a url that is already in-flight (not yet\n * cached) on this instance replaces the pending request rather than\n * joining it — only the most recently issued call for a given url will\n * resolve.\n *\n * @public\n */\n load(url: string): Promise<string> {\n if (isServerEnv) {\n return Promise.resolve(url);\n }\n\n const objectUrl = this.cache.get(url);\n if (objectUrl) {\n return Promise.resolve(objectUrl);\n }\n\n const deferred = createDeferred<string>();\n this.pending.set(url, deferred);\n this._send({ type: 'load', thread: this.threadId, url });\n return deferred.promise;\n }\n}\n"],"mappings":";;;AAgBA,MAAMC,cAAc,OAAOC,aAAa;;;;;;;;;;;;;;AAexC,IAAaC,aAAb,MAAwB;;;;;;CAYtBC,YAAYC,QAAsC;EAChD,KAAKC,WAAWL,cAAc,KAAKM,OAAOC,WAAW;EACrD,KAAKC,0BAAU,IAAIC,IAAI;EACvB,KAAKC,wBAAQ,IAAID,IAAI;EAGrB,EAAAG,SAAA;GAAA,IAAA,CAAAA,MAAA,MAAA,IAAAC,MAAO,kCAAkC;EAAA,EAAA,CAAEF,IAA0D;EACrG,KAAKP,SAASA;EAEd,IAAI,CAACJ,aAAa;GAChB,MAAMe,MAAMC,UAA2B;IACrC,MAAM,EAAEC,MAAMC,QAAQF,MAAMG;IAC5B,MAAMC,WAAW,KAAKC,eAAeH,GAAG;IACxC,IAAI,CAACE,UACH;IAGF,IAAIH,SAAS,oBAAoB;KAC/B,MAAM,EAAEK,cAAcN,MAAMG;KAC5B,KAAKT,MAAMa,IAAIL,KAAKI,SAAS;KAC7BF,SAASI,QAAQF,SAAS;KAC1B;IACF;IAEA,IAAIL,SAAS,kBAAkB;KAC7BG,SAASK,OAAO,IAAI;KACpB;IACF;GACF;GAEA,IAAIrB,kBAAkBU,cAAc;IAClCV,OAAOsB,KAAKC,YAAY;KAAEV,MAAM;KAAWW,QAAQ,KAAKvB;IAAS,CAAC;IAClED,OAAOsB,KAAKG,YAAYd;GAC1B,OAAO,IAAIX,QAAQ;IACjB,KAAK0B,UAAU,IAAIC,eAAe;IAClC3B,OAAOuB,YAAY;KAAEV,MAAM;KAAWW,QAAQ,KAAKvB;IAAS,GAAG,CAAC,KAAKyB,QAAQE,KAAK,CAAC;IAEnF,KAAKF,QAAQG,MAAMJ,YAAYd;GACjC;EACF;CACF;CAEAM,eAAeH,KAA2C;EACxD,MAAME,WAAW,KAAKZ,QAAQ0B,IAAIhB,GAAG;EACrC,KAAKV,QAAQ2B,OAAOjB,GAAG;EAEvB,OAAOE;CACT;CAEAgB,MAAMpB,OAA+B;EAEnC,KAAKZ,kBAAkBU,eAAe,KAAKV,OAAOsB,KAAKC,YAAYX,KAAK,IAAI,KAAKc,QAAQG,MAAMN,YAAYX,KAAK;CAClH;;;;;;;;;;;;;;;;;;;CAoBAqB,KAAKnB,KAA8B;EACjC,IAAIlB,aACF,OAAOsC,QAAQd,QAAQN,GAAG;EAG5B,MAAMI,YAAY,KAAKZ,MAAMwB,IAAIhB,GAAG;EACpC,IAAII,WACF,OAAOgB,QAAQd,QAAQF,SAAS;EAGlC,MAAMF,WAAWrB,eAAuB;EACxC,KAAKS,QAAQe,IAAIL,KAAKE,QAAQ;EAC9B,KAAKgB,MAAM;GAAEnB,MAAM;GAAQW,QAAQ,KAAKvB;GAAUa;EAAI,CAAC;EACvD,OAAOE,SAASmB;CAClB;AACF"}