@peerbit/any-store 2.0.2 → 2.1.0-55cebfe

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 (49) hide show
  1. package/dist/src/index.d.ts +4 -0
  2. package/dist/src/index.d.ts.map +1 -0
  3. package/dist/src/index.js +2 -0
  4. package/dist/src/index.js.map +1 -0
  5. package/{lib/esm → dist/src}/level.d.ts +4 -2
  6. package/dist/src/level.d.ts.map +1 -0
  7. package/{lib/esm → dist/src}/level.js +15 -10
  8. package/dist/src/level.js.map +1 -0
  9. package/{lib/esm → dist/src}/memory.d.ts +4 -2
  10. package/dist/src/memory.d.ts.map +1 -0
  11. package/{lib/esm → dist/src}/memory.js +6 -2
  12. package/dist/src/memory.js.map +1 -0
  13. package/{lib/esm → dist/src}/store.browser.d.ts +2 -1
  14. package/dist/src/store.browser.d.ts.map +1 -0
  15. package/{lib/esm → dist/src}/store.browser.js +1 -1
  16. package/dist/src/store.browser.js.map +1 -0
  17. package/{lib/esm → dist/src}/store.d.ts +1 -0
  18. package/dist/src/store.d.ts.map +1 -0
  19. package/{lib/esm → dist/src}/store.js +1 -1
  20. package/{lib/esm → dist/src}/store.js.map +1 -1
  21. package/package.json +80 -50
  22. package/src/index.ts +4 -2
  23. package/src/level.ts +17 -14
  24. package/src/memory.ts +7 -3
  25. package/src/store.browser.ts +1 -1
  26. package/src/store.ts +2 -1
  27. package/LICENSE +0 -202
  28. package/lib/esm/index.d.ts +0 -3
  29. package/lib/esm/index.js +0 -4
  30. package/lib/esm/index.js.map +0 -1
  31. package/lib/esm/interface.d.ts +0 -18
  32. package/lib/esm/interface.js +0 -2
  33. package/lib/esm/interface.js.map +0 -1
  34. package/lib/esm/level.js.map +0 -1
  35. package/lib/esm/memory.js.map +0 -1
  36. package/lib/esm/opfs-worker-messages.d.ts +0 -122
  37. package/lib/esm/opfs-worker-messages.js +0 -325
  38. package/lib/esm/opfs-worker-messages.js.map +0 -1
  39. package/lib/esm/opfs-worker.d.ts +0 -8
  40. package/lib/esm/opfs-worker.js +0 -276
  41. package/lib/esm/opfs-worker.js.map +0 -1
  42. package/lib/esm/opfs.d.ts +0 -27
  43. package/lib/esm/opfs.js +0 -148
  44. package/lib/esm/opfs.js.map +0 -1
  45. package/lib/esm/store.browser.js.map +0 -1
  46. package/src/interface.ts +0 -20
  47. package/src/opfs-worker-messages.ts +0 -210
  48. package/src/opfs-worker.ts +0 -347
  49. package/src/opfs.ts +0 -205
@@ -1,347 +0,0 @@
1
- import { deserialize, serialize } from "@dao-xyz/borsh";
2
- import { AnyStore } from "./interface.js";
3
- import * as memory from "./opfs-worker-messages.js";
4
- import { fromBase64URL, toBase64URL, ready } from "@peerbit/crypto";
5
- import { BinaryReader, BinaryWriter } from "@dao-xyz/borsh";
6
- import { waitForResolved } from "@peerbit/time";
7
-
8
- const directory = location.hash.split("#")?.[1];
9
-
10
- const encodeName = (name: string): string => {
11
- // since "/" and perhaps other characters might not be allowed we do encode
12
- const writer = new BinaryWriter();
13
- writer.string(name);
14
- return toBase64URL(writer.finalize());
15
- };
16
-
17
- const decodeName = (name: string): string => {
18
- // since "/" and perhaps other characters might not be allowed we do encode
19
- const writer = new BinaryReader(fromBase64URL(name));
20
- return writer.string();
21
- };
22
-
23
- const waitForSyncAcccess = async (
24
- fileHandle: FileSystemFileHandle
25
- ): Promise<FileSystemSyncAccessHandle> => {
26
- try {
27
- const handle = await fileHandle.createSyncAccessHandle();
28
- return handle;
29
- } catch (error) {
30
- const handle = await waitForResolved(() =>
31
- fileHandle.createSyncAccessHandle()
32
- );
33
- if (!handle) {
34
- throw error;
35
- }
36
- return handle;
37
- }
38
- };
39
-
40
- const createWriteHandle = async (fileHandle: FileSystemFileHandle) => {
41
- // In Chrome on GET DOMException: Failed to execute 'createWritable' on 'FileSystemFileHandle': Failed to create swap file
42
- // hence below is not used for now
43
- /*
44
- if (fileHandle.createWritable != null) {
45
- return fileHandle.createWritable({ keepExistingData: false });
46
- } */
47
- return waitForSyncAcccess(fileHandle);
48
- };
49
-
50
- export class OPFSStoreWorker {
51
- private _levels: Map<string, AnyStore>;
52
- private _rootStore: AnyStore;
53
-
54
- private _memoryIterator: Map<
55
- string,
56
- AsyncIterator<[string, ArrayBuffer], void, void>
57
- >;
58
-
59
- constructor() {
60
- const postMessageFn = postMessage;
61
- this._memoryIterator = new Map();
62
- this._levels = new Map();
63
- let isOpen = false;
64
-
65
- const createMemory = (
66
- root?: FileSystemDirectoryHandle,
67
- levels: string[] = []
68
- ): AnyStore => {
69
- let m: FileSystemDirectoryHandle = root!;
70
- let sizeCache: number = 0;
71
- const sizeMap: Map<string, number> = new Map(); // files size per key
72
-
73
- const calculateSize = async () => {
74
- sizeCache = 0;
75
- for await (const value of m.values()) {
76
- if (value.kind === "file") {
77
- try {
78
- const handle = await waitForSyncAcccess(value);
79
- const handleSize = handle.getSize();
80
- sizeMap.set(value.name, handleSize);
81
- sizeCache += handleSize;
82
- handle.close();
83
- } catch (error) {
84
- // TODO better error handling.
85
- // most commonly error can be thrown when we are invoking getSize and files does not exist (anymore)
86
- }
87
- }
88
- }
89
- };
90
- // 'open' | 'closed' is just a virtual thing since OPFS is always open as soone as we get the FileSystemDirectoryHandle
91
- // TODO remove status? or assume not storage adapters can be closed?
92
- const open = async () => {
93
- await ready;
94
-
95
- if (!m) {
96
- m = await navigator.storage.getDirectory();
97
- if (directory) {
98
- m = await m.getDirectoryHandle(encodeName(directory), {
99
- create: true
100
- });
101
- }
102
- await calculateSize();
103
- }
104
- };
105
- return {
106
- clear: async () => {
107
- for await (const key of m.keys()) {
108
- m.removeEntry(key, { recursive: true });
109
- }
110
- sizeCache = 0;
111
- sizeMap.clear();
112
- },
113
-
114
- del: async (key: string) => {
115
- const encodedKey = encodeName(key);
116
- try {
117
- await m.removeEntry(encodedKey, { recursive: true });
118
- } catch (error) {
119
- if (error instanceof DOMException) {
120
- return;
121
- } else {
122
- throw error;
123
- }
124
- }
125
- const prevSize = sizeMap.get(encodedKey);
126
- if (prevSize != null) {
127
- sizeCache -= prevSize;
128
- sizeMap.delete(encodedKey);
129
- }
130
- },
131
-
132
- get: async (key: string) => {
133
- try {
134
- const fileHandle = await m.getFileHandle(encodeName(key));
135
- const file = await fileHandle.getFile();
136
- const buffer = await file.arrayBuffer();
137
- return new Uint8Array(buffer);
138
- } catch (error) {
139
- if (
140
- error instanceof DOMException &&
141
- error.name === "NotFoundError"
142
- ) {
143
- return undefined;
144
- } else if (error) {
145
- return undefined;
146
- } else {
147
- throw error;
148
- }
149
- }
150
- },
151
- put: async (key: string, value: Uint8Array) => {
152
- const encodedKey = encodeName(key);
153
-
154
- const fileHandle = await m.getFileHandle(encodedKey, {
155
- create: true
156
- });
157
- const writeFileHandle = await createWriteHandle(fileHandle);
158
- writeFileHandle.write(value);
159
- writeFileHandle.flush();
160
- writeFileHandle.close();
161
-
162
- const prevSize = sizeMap.get(encodedKey);
163
- if (prevSize) {
164
- sizeCache -= prevSize;
165
- }
166
- sizeCache += value.byteLength;
167
- sizeMap.set(encodedKey, value.byteLength);
168
- },
169
-
170
- size: async () => {
171
- return sizeCache;
172
- },
173
- status: () => (isOpen ? "open" : "closed"),
174
-
175
- sublevel: async (name) => {
176
- const encodedName = encodeName(name);
177
- const fileHandle = await m.getDirectoryHandle(encodedName, {
178
- create: true
179
- });
180
- const sublevel = [...levels, name];
181
- const subMemory = createMemory(fileHandle, sublevel);
182
- this._levels.set(memory.levelKey(sublevel), subMemory);
183
- await subMemory.open();
184
- return subMemory;
185
- },
186
-
187
- async *iterator(): AsyncGenerator<[string, Uint8Array], void, void> {
188
- for await (const v of m.values()) {
189
- if (v.kind == "file") {
190
- yield [
191
- decodeName(v.name),
192
- new Uint8Array(await (await v.getFile()).arrayBuffer())
193
- ];
194
- }
195
- }
196
- },
197
- close: async () => {
198
- sizeCache = undefined as any; // TODO types
199
- isOpen = false;
200
- this._memoryIterator.clear();
201
- },
202
- open
203
- };
204
- };
205
-
206
- this._rootStore = createMemory();
207
-
208
- self.addEventListener("message", async (ev) => {
209
- const message = deserialize(ev["data"], memory.MemoryRequest);
210
- try {
211
- if (message instanceof memory.MemoryMessage) {
212
- if (message instanceof memory.REQ_Open) {
213
- if (!isOpen) {
214
- await this._rootStore.open();
215
- isOpen = true;
216
- }
217
- await this.respond(
218
- message,
219
- new memory.RESP_Open({ level: message.level }),
220
- postMessageFn
221
- );
222
- return;
223
- }
224
-
225
- const m =
226
- message.level.length === 0
227
- ? this._rootStore
228
- : this._levels.get(memory.levelKey(message.level));
229
- if (!m) {
230
- throw new Error("Recieved memory message for an undefined level");
231
- } else if (message instanceof memory.REQ_Clear) {
232
- await m.clear();
233
- await this.respond(
234
- message,
235
- new memory.RESP_Clear({ level: message.level }),
236
- postMessageFn
237
- );
238
- } else if (message instanceof memory.REQ_Close) {
239
- await m.close();
240
- await this.respond(
241
- message,
242
- new memory.RESP_Close({ level: message.level }),
243
- postMessageFn
244
- );
245
- } else if (message instanceof memory.REQ_Del) {
246
- await m.del(message.key);
247
- await this.respond(
248
- message,
249
- new memory.RESP_Del({ level: message.level }),
250
- postMessageFn
251
- );
252
- } else if (message instanceof memory.REQ_Iterator_Next) {
253
- let iterator = this._memoryIterator.get(message.id);
254
- if (!iterator) {
255
- iterator = m.iterator()[Symbol.asyncIterator]();
256
- this._memoryIterator.set(message.id, iterator);
257
- }
258
- const next = await iterator.next();
259
- await this.respond(
260
- message,
261
- new memory.RESP_Iterator_Next({
262
- keys: next.done ? [] : [next.value[0]],
263
- values: next.done ? [] : [new Uint8Array(next.value[1])],
264
- level: message.level
265
- }),
266
- postMessageFn
267
- );
268
- if (next.done) {
269
- this._memoryIterator.delete(message.id);
270
- }
271
- } else if (message instanceof memory.REQ_Iterator_Stop) {
272
- this._memoryIterator.delete(message.id);
273
- await this.respond(
274
- message,
275
- new memory.RESP_Iterator_Stop({ level: message.level }),
276
- postMessageFn
277
- );
278
- } else if (message instanceof memory.REQ_Get) {
279
- const value = await m.get(message.key);
280
- await this.respond(
281
- message,
282
- new memory.RESP_Get({
283
- bytes: value ? new Uint8Array(value) : undefined,
284
- level: message.level
285
- }),
286
- postMessageFn
287
- );
288
- } else if (message instanceof memory.REQ_Put) {
289
- await m.put(message.key, message.bytes);
290
- await this.respond(
291
- message,
292
- new memory.RESP_Put({ level: message.level }),
293
- postMessageFn
294
- );
295
- } else if (message instanceof memory.REQ_Size) {
296
- await this.respond(
297
- message,
298
- new memory.RESP_Size({
299
- size: await m.size(),
300
- level: message.level
301
- }),
302
- postMessageFn
303
- );
304
- } else if (message instanceof memory.REQ_Status) {
305
- await this.respond(
306
- message,
307
- new memory.RESP_Status({
308
- status: await m.status(),
309
- level: message.level
310
- }),
311
- postMessageFn
312
- );
313
- } else if (message instanceof memory.REQ_Sublevel) {
314
- await m.sublevel(message.name);
315
-
316
- await this.respond(
317
- message,
318
- new memory.RESP_Sublevel({ level: message.level }),
319
- postMessageFn
320
- );
321
- }
322
- }
323
- } catch (error) {
324
- await this.respond(
325
- message,
326
- new memory.RESP_Error({
327
- error: error?.["message"] || error?.constructor.name,
328
- level: message["level"] || []
329
- }),
330
- postMessageFn
331
- );
332
- }
333
- });
334
- }
335
-
336
- async respond(
337
- request: memory.MemoryRequest,
338
- response: memory.MemoryRequest,
339
- postMessageFn = postMessage
340
- ) {
341
- response.messageId = request.messageId;
342
- const bytes = serialize(response);
343
- postMessageFn(bytes, { transfer: [bytes.buffer] });
344
- }
345
- }
346
-
347
- new OPFSStoreWorker();
package/src/opfs.ts DELETED
@@ -1,205 +0,0 @@
1
- import { AnyStore, MaybePromise } from "./interface.js";
2
- import * as memory from "./opfs-worker-messages.js";
3
- import { v4 as uuid } from "uuid";
4
- import { serialize, deserialize } from "@dao-xyz/borsh";
5
- import workerUrl from "./opfs-worker?worker&url";
6
-
7
- function memoryIterator(
8
- client: {
9
- request<T extends memory.MemoryRequest>(
10
- request: memory.MemoryRequest
11
- ): Promise<T>;
12
- },
13
- level: string[]
14
- ): {
15
- [Symbol.asyncIterator]: () => AsyncIterator<[string, Uint8Array], void, void>;
16
- } {
17
- return {
18
- [Symbol.asyncIterator]() {
19
- const iteratorId = uuid();
20
- return {
21
- next: async () => {
22
- const resp = await client.request<memory.RESP_Iterator_Next>(
23
- new memory.REQ_Iterator_Next({ id: iteratorId, level })
24
- );
25
- if (resp.keys.length > 1) {
26
- throw new Error("Unsupported iteration response");
27
- }
28
- // Will only have 0 or 1 element for now
29
- for (let i = 0; i < resp.keys.length; i++) {
30
- return {
31
- done: false,
32
- value: [resp.keys[i], resp.values[i]] as [string, Uint8Array]
33
- } as { done: false; value: [string, Uint8Array] };
34
- }
35
- return { done: true, value: undefined } as {
36
- done: true;
37
- value: undefined;
38
- };
39
- },
40
- async return() {
41
- await client.request<memory.RESP_Iterator_Next>(
42
- new memory.REQ_Iterator_Stop({ id: iteratorId, level })
43
- );
44
- return { done: true, value: undefined } as {
45
- done: true;
46
- value: undefined;
47
- };
48
- }
49
- };
50
- }
51
- };
52
- }
53
-
54
- const createWorker = (directory) => {
55
- const workerURL = workerUrl + "#" + directory;
56
- return new Worker(workerURL, { type: "module" });
57
- };
58
-
59
- export class OPFSStore implements AnyStore {
60
- worker: Worker;
61
- levelMap: Map<string, AnyStore>;
62
- root: AnyStore;
63
-
64
- private _responseCallbacks: Map<
65
- string,
66
- { fn: (message: memory.MemoryRequest) => any; once: boolean }
67
- > = new Map();
68
-
69
- private _createStorage: (level: string[]) => AnyStore;
70
- constructor(readonly directory?: string) {
71
- this.levelMap = new Map();
72
- this._createStorage = (level: string[] = []): AnyStore => {
73
- return {
74
- clear: async () => {
75
- await this.request<memory.RESP_Clear>(
76
- new memory.REQ_Clear({ level })
77
- );
78
- },
79
- del: async (key) => {
80
- await this.request<memory.RESP_Del>(
81
- new memory.REQ_Del({ level, key })
82
- );
83
- },
84
- get: async (key) => {
85
- return (
86
- await this.request<memory.RESP_Get>(
87
- new memory.REQ_Get({ level, key })
88
- )
89
- ).bytes;
90
- },
91
- put: async (key, value) => {
92
- await this.request<memory.RESP_Put>(
93
- new memory.REQ_Put({ level, key, bytes: value })
94
- );
95
- },
96
- status: async () =>
97
- (
98
- await this.request<memory.RESP_Status>(
99
- new memory.REQ_Status({ level })
100
- )
101
- ).status,
102
- sublevel: async (name) => {
103
- await this.request(new memory.REQ_Sublevel({ level, name }));
104
- const newLevels = [...level, name];
105
- const sublevel = this._createStorage(newLevels);
106
- this.levelMap.set(memory.levelKey(newLevels), sublevel);
107
- return sublevel;
108
- },
109
-
110
- iterator: () => memoryIterator(this, level),
111
- close: async () => {
112
- await this.request<memory.RESP_Close>(
113
- new memory.REQ_Close({ level })
114
- );
115
- /* this.levelMap.delete(memory.levelKey(level)); */
116
- },
117
- open: async () => {
118
- await this.request<memory.RESP_Open>(new memory.REQ_Open({ level }));
119
- },
120
-
121
- size: async () => {
122
- const size = await this.request<memory.RESP_Size>(
123
- new memory.REQ_Size({ level })
124
- );
125
- return size.size;
126
- }
127
- };
128
- };
129
- }
130
- status() {
131
- return this.worker ? this.root.status() : "closed";
132
- }
133
- async close(): Promise<void> {
134
- this.worker.terminate();
135
- this.worker = undefined!;
136
- this._responseCallbacks.clear();
137
- this.levelMap.clear();
138
- }
139
- async open(): Promise<void> {
140
- if (!this.worker) {
141
- if (
142
- !globalThis["__playwright_test__"] &&
143
- (await navigator.storage.persist()) === false
144
- ) {
145
- throw new Error("OPFS not allowed to persist data");
146
- }
147
- this.worker = createWorker(this.directory);
148
- this.root = this._createStorage([]);
149
- this.worker.addEventListener("message", async (ev) => {
150
- const message = deserialize(ev.data, memory.MemoryMessage);
151
- this._responseCallbacks.get(message.messageId)!.fn(message);
152
- });
153
- await this.root.open();
154
- }
155
- }
156
- get(key: string): MaybePromise<Uint8Array | undefined> {
157
- return this.root.get(key);
158
- }
159
- put(key: string, value: Uint8Array) {
160
- return this.root.put(key, value);
161
- }
162
- del(key: any): MaybePromise<void> {
163
- return this.root.del(key);
164
- }
165
- sublevel(name: string): AnyStore | MaybePromise<AnyStore> {
166
- return this.root.sublevel(name);
167
- }
168
- iterator(): {
169
- [Symbol.asyncIterator]: () => AsyncIterator<
170
- [string, Uint8Array],
171
- void,
172
- void
173
- >;
174
- } {
175
- return this.root.iterator();
176
- }
177
- clear(): MaybePromise<void> {
178
- return this.root.clear();
179
- }
180
-
181
- size(): MaybePromise<number> {
182
- return this.root.size();
183
- }
184
-
185
- async request<T extends memory.MemoryRequest>(
186
- request: memory.MemoryRequest
187
- ): Promise<T> {
188
- return new Promise<T>((resolve, reject) => {
189
- const onResponse = (message: memory.MemoryRequest) => {
190
- this._responseCallbacks.delete(request.messageId);
191
- if (message instanceof memory.RESP_Error) {
192
- reject(new Error(message.error));
193
- } else {
194
- resolve(message as T);
195
- }
196
- };
197
- this._responseCallbacks.set(request.messageId, {
198
- fn: onResponse,
199
- once: true
200
- });
201
- const bytes = serialize(request);
202
- this.worker.postMessage(bytes, [bytes.buffer]);
203
- });
204
- }
205
- }