@minca/core 0.3.1 → 0.4.0
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/README.md +2 -2
- package/dist/{session → hosting}/hosting.d.ts +1 -1
- package/dist/{session → hosting}/hosting.d.ts.map +1 -1
- package/dist/{session → hosting}/hosting.js.map +1 -1
- package/dist/index.d.ts +20 -28
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +16 -19
- package/dist/index.js.map +1 -1
- package/dist/network/mesh.d.ts.map +1 -1
- package/dist/network/mesh.js +13 -3
- package/dist/network/mesh.js.map +1 -1
- package/dist/network/network-manager.d.ts +5 -0
- package/dist/network/network-manager.d.ts.map +1 -1
- package/dist/network/network-manager.js +3 -0
- package/dist/network/network-manager.js.map +1 -1
- package/dist/network/peer-auth.d.ts +17 -5
- package/dist/network/peer-auth.d.ts.map +1 -1
- package/dist/network/peer-auth.js +19 -9
- package/dist/network/peer-auth.js.map +1 -1
- package/dist/network/rtc-transport.d.ts.map +1 -1
- package/dist/network/rtc-transport.js +1 -0
- package/dist/network/rtc-transport.js.map +1 -1
- package/dist/network/transport.d.ts +12 -0
- package/dist/network/transport.d.ts.map +1 -1
- package/dist/network/ws-transport.d.ts +1 -1
- package/dist/network/ws-transport.d.ts.map +1 -1
- package/dist/network/ws-transport.js +14 -4
- package/dist/network/ws-transport.js.map +1 -1
- package/dist/node/index.d.ts +1 -5
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +0 -3
- package/dist/node/index.js.map +1 -1
- package/dist/node/node-hosting.js +1 -1
- package/dist/node/node-records.js +1 -1
- package/dist/node/node-records.js.map +1 -1
- package/dist/node/node.d.ts.map +1 -1
- package/dist/node/node.js +18 -0
- package/dist/node/node.js.map +1 -1
- package/dist/node/space-mirrors.d.ts +1 -1
- package/dist/node/space-mirrors.d.ts.map +1 -1
- package/dist/node/space-mirrors.js +17 -5
- package/dist/node/space-mirrors.js.map +1 -1
- package/dist/node/space-peers.d.ts +2 -0
- package/dist/node/space-peers.d.ts.map +1 -1
- package/dist/node/space-peers.js +41 -8
- package/dist/node/space-peers.js.map +1 -1
- package/dist/node/space-runtime.d.ts +4 -2
- package/dist/node/space-runtime.d.ts.map +1 -1
- package/dist/node/space-runtime.js +3 -2
- package/dist/node/space-runtime.js.map +1 -1
- package/dist/node/space-standing.d.ts.map +1 -1
- package/dist/node/space-standing.js +12 -38
- package/dist/node/space-standing.js.map +1 -1
- package/dist/node/space-warrants.js +1 -1
- package/dist/node/space-warrants.js.map +1 -1
- package/dist/node/space-writing.d.ts.map +1 -1
- package/dist/node/space-writing.js +12 -32
- package/dist/node/space-writing.js.map +1 -1
- package/dist/node/stores.d.ts +2 -58
- package/dist/node/stores.d.ts.map +1 -1
- package/dist/node/stores.js +1 -74
- package/dist/node/stores.js.map +1 -1
- package/dist/node/types.d.ts +3 -3
- package/dist/node/types.d.ts.map +1 -1
- package/dist/node/writer-keys.d.ts +15 -14
- package/dist/node/writer-keys.d.ts.map +1 -1
- package/dist/node/writer-keys.js +3 -113
- package/dist/node/writer-keys.js.map +1 -1
- package/dist/records/key.d.ts +16 -19
- package/dist/records/key.d.ts.map +1 -1
- package/dist/records/key.js +53 -45
- package/dist/records/key.js.map +1 -1
- package/dist/records/rules.d.ts +1 -1
- package/dist/records/rules.d.ts.map +1 -1
- package/dist/records/rules.js +6 -4
- package/dist/records/rules.js.map +1 -1
- package/dist/storage/body-cache.d.ts +6 -3
- package/dist/storage/body-cache.d.ts.map +1 -1
- package/dist/storage/body-cache.js +37 -14
- package/dist/storage/body-cache.js.map +1 -1
- package/dist/storage/mirror.d.ts.map +1 -1
- package/dist/storage/mirror.js +35 -16
- package/dist/storage/mirror.js.map +1 -1
- package/dist/storage/segment.d.ts +6 -2
- package/dist/storage/segment.d.ts.map +1 -1
- package/dist/storage/segment.js +8 -4
- package/dist/storage/segment.js.map +1 -1
- package/dist/storage/shared-store.d.ts +32 -0
- package/dist/storage/shared-store.d.ts.map +1 -0
- package/dist/storage/{folder-reconcile.js → shared-store.js} +15 -15
- package/dist/storage/shared-store.js.map +1 -0
- package/dist/storage/storage-provider.d.ts +0 -9
- package/dist/storage/storage-provider.d.ts.map +1 -1
- package/dist/storage/storage-provider.js +8 -8
- package/dist/storage/storage-provider.js.map +1 -1
- package/dist/sync/sync-engine.d.ts +7 -0
- package/dist/sync/sync-engine.d.ts.map +1 -1
- package/dist/sync/sync-engine.js +179 -47
- package/dist/sync/sync-engine.js.map +1 -1
- package/dist/sync/sync-messages.d.ts +1 -1
- package/dist/sync/sync-messages.js +1 -1
- package/dist/types.d.ts +19 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +4 -0
- package/dist/types.js.map +1 -1
- package/dist/utils/index.d.ts +5 -5
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/index.js +5 -5
- package/dist/utils/index.js.map +1 -1
- package/docs/README.md +3 -2
- package/docs/building-an-app.md +2 -2
- package/docs/node.md +24 -20
- package/docs/query-format.md +6 -5
- package/docs/records-and-queries.md +12 -13
- package/docs/storage.md +41 -15
- package/package.json +10 -19
- package/dist/identity/account-store.d.ts +0 -83
- package/dist/identity/account-store.d.ts.map +0 -1
- package/dist/identity/account-store.js +0 -234
- package/dist/identity/account-store.js.map +0 -1
- package/dist/identity/device-key.d.ts +0 -26
- package/dist/identity/device-key.d.ts.map +0 -1
- package/dist/identity/device-key.js +0 -48
- package/dist/identity/device-key.js.map +0 -1
- package/dist/identity/idb.d.ts +0 -19
- package/dist/identity/idb.d.ts.map +0 -1
- package/dist/identity/idb.js +0 -56
- package/dist/identity/idb.js.map +0 -1
- package/dist/node/worker.d.ts +0 -91
- package/dist/node/worker.d.ts.map +0 -1
- package/dist/node/worker.js +0 -344
- package/dist/node/worker.js.map +0 -1
- package/dist/node-worker.d.ts +0 -2
- package/dist/node-worker.d.ts.map +0 -1
- package/dist/node-worker.js +0 -16
- package/dist/node-worker.js.map +0 -1
- package/dist/session/account-hint.d.ts +0 -13
- package/dist/session/account-hint.d.ts.map +0 -1
- package/dist/session/account-hint.js +0 -54
- package/dist/session/account-hint.js.map +0 -1
- package/dist/session/channel-room.d.ts +0 -26
- package/dist/session/channel-room.d.ts.map +0 -1
- package/dist/session/channel-room.js +0 -56
- package/dist/session/channel-room.js.map +0 -1
- package/dist/session/connect-code.d.ts +0 -127
- package/dist/session/connect-code.d.ts.map +0 -1
- package/dist/session/connect-code.js +0 -408
- package/dist/session/connect-code.js.map +0 -1
- package/dist/session/connect.d.ts +0 -393
- package/dist/session/connect.d.ts.map +0 -1
- package/dist/session/connect.js +0 -587
- package/dist/session/connect.js.map +0 -1
- package/dist/session/connection.d.ts +0 -141
- package/dist/session/connection.d.ts.map +0 -1
- package/dist/session/connection.js +0 -344
- package/dist/session/connection.js.map +0 -1
- package/dist/session/index.d.ts +0 -24
- package/dist/session/index.d.ts.map +0 -1
- package/dist/session/index.js +0 -18
- package/dist/session/index.js.map +0 -1
- package/dist/session/pairing.d.ts +0 -97
- package/dist/session/pairing.d.ts.map +0 -1
- package/dist/session/pairing.js +0 -251
- package/dist/session/pairing.js.map +0 -1
- package/dist/session/places.d.ts +0 -71
- package/dist/session/places.d.ts.map +0 -1
- package/dist/session/places.js +0 -130
- package/dist/session/places.js.map +0 -1
- package/dist/session/popup.d.ts +0 -13
- package/dist/session/popup.d.ts.map +0 -1
- package/dist/session/popup.js +0 -23
- package/dist/session/popup.js.map +0 -1
- package/dist/session/stay-signed-in.d.ts +0 -48
- package/dist/session/stay-signed-in.d.ts.map +0 -1
- package/dist/session/stay-signed-in.js +0 -141
- package/dist/session/stay-signed-in.js.map +0 -1
- package/dist/storage/blob/directory.d.ts +0 -14
- package/dist/storage/blob/directory.d.ts.map +0 -1
- package/dist/storage/blob/directory.js +0 -87
- package/dist/storage/blob/directory.js.map +0 -1
- package/dist/storage/blob/memory.d.ts +0 -6
- package/dist/storage/blob/memory.d.ts.map +0 -1
- package/dist/storage/blob/memory.js +0 -20
- package/dist/storage/blob/memory.js.map +0 -1
- package/dist/storage/blob/s3.d.ts +0 -16
- package/dist/storage/blob/s3.d.ts.map +0 -1
- package/dist/storage/blob/s3.js +0 -91
- package/dist/storage/blob/s3.js.map +0 -1
- package/dist/storage/directory-access.d.ts +0 -36
- package/dist/storage/directory-access.d.ts.map +0 -1
- package/dist/storage/directory-access.js +0 -89
- package/dist/storage/directory-access.js.map +0 -1
- package/dist/storage/folder-adapter.d.ts +0 -100
- package/dist/storage/folder-adapter.d.ts.map +0 -1
- package/dist/storage/folder-adapter.js +0 -232
- package/dist/storage/folder-adapter.js.map +0 -1
- package/dist/storage/folder-reconcile.d.ts +0 -33
- package/dist/storage/folder-reconcile.d.ts.map +0 -1
- package/dist/storage/folder-reconcile.js.map +0 -1
- package/dist/storage/index.d.ts +0 -6
- package/dist/storage/index.d.ts.map +0 -1
- package/dist/storage/index.js +0 -5
- package/dist/storage/index.js.map +0 -1
- package/dist/storage/indexeddb-adapter.d.ts +0 -8
- package/dist/storage/indexeddb-adapter.d.ts.map +0 -1
- package/dist/storage/indexeddb-adapter.js +0 -128
- package/dist/storage/indexeddb-adapter.js.map +0 -1
- package/dist/storage/sqlite-adapter.d.ts +0 -57
- package/dist/storage/sqlite-adapter.d.ts.map +0 -1
- package/dist/storage/sqlite-adapter.js +0 -213
- package/dist/storage/sqlite-adapter.js.map +0 -1
- /package/dist/{session → hosting}/hosting.js +0 -0
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* A StorageAdapter over a directory the user picked on their own disk.
|
|
3
|
-
*
|
|
4
|
-
* Unlike IndexedDB or OPFS it is not keyed by origin: every app given the
|
|
5
|
-
* folder reads the same files, so an app is a view on the user's data rather
|
|
6
|
-
* than the owner of a copy. The layout is legible, since the folder is theirs:
|
|
7
|
-
*
|
|
8
|
-
* ```
|
|
9
|
-
* <folder>/
|
|
10
|
-
* accounts.json who has an account here
|
|
11
|
-
* accounts/<id>/account.json that account's keys, locked
|
|
12
|
-
* accounts/<id>/stores/<name>/
|
|
13
|
-
* kv/<key> which version is current, what sync compares, space records
|
|
14
|
-
* versions/<cid>.json
|
|
15
|
-
* ```
|
|
16
|
-
*
|
|
17
|
-
* **Versions are the truth; the entries are an index over them.** Version
|
|
18
|
-
* files are immutable and named by their content hash, so two origins can
|
|
19
|
-
* share a folder without locking; which version is current is derived, and
|
|
20
|
-
* {@link reconcileFolder} puts it right.
|
|
21
|
-
*/
|
|
22
|
-
import type { StorageAdapter } from '../types.js';
|
|
23
|
-
export interface WritableFileLike {
|
|
24
|
-
write(data: Uint8Array | string): Promise<void>;
|
|
25
|
-
close(): Promise<void>;
|
|
26
|
-
}
|
|
27
|
-
export interface FileHandleLike {
|
|
28
|
-
getFile(): Promise<{
|
|
29
|
-
arrayBuffer(): Promise<ArrayBuffer>;
|
|
30
|
-
}>;
|
|
31
|
-
createWritable(): Promise<WritableFileLike>;
|
|
32
|
-
}
|
|
33
|
-
export interface DirectoryHandleLike {
|
|
34
|
-
readonly name: string;
|
|
35
|
-
getFileHandle(name: string, options?: {
|
|
36
|
-
create?: boolean;
|
|
37
|
-
}): Promise<FileHandleLike>;
|
|
38
|
-
getDirectoryHandle(name: string, options?: {
|
|
39
|
-
create?: boolean;
|
|
40
|
-
}): Promise<DirectoryHandleLike>;
|
|
41
|
-
removeEntry(name: string, options?: {
|
|
42
|
-
recursive?: boolean;
|
|
43
|
-
}): Promise<void>;
|
|
44
|
-
keys(): AsyncIterableIterator<string>;
|
|
45
|
-
/** Each entry, and whether it is a file or a directory */
|
|
46
|
-
values(): AsyncIterableIterator<{
|
|
47
|
-
readonly kind: 'file' | 'directory';
|
|
48
|
-
readonly name: string;
|
|
49
|
-
}>;
|
|
50
|
-
}
|
|
51
|
-
/** What changed on disk since the last pass */
|
|
52
|
-
export interface FolderReload {
|
|
53
|
-
/** Version ids that appeared — written by another origin, or another device */
|
|
54
|
-
readonly added: ReadonlyArray<string>;
|
|
55
|
-
/** Version ids whose files are gone */
|
|
56
|
-
readonly removed: ReadonlyArray<string>;
|
|
57
|
-
}
|
|
58
|
-
export interface FolderAdapter extends StorageAdapter {
|
|
59
|
-
/** Where inside the folder this adapter keeps its files */
|
|
60
|
-
readonly namespace: string;
|
|
61
|
-
/**
|
|
62
|
-
* Re-reads the directory, picking up writes made by another origin or
|
|
63
|
-
* device; the web has no change notification. Pair it with {@link reconcileFolder}.
|
|
64
|
-
*/
|
|
65
|
-
reload(): Promise<FolderReload>;
|
|
66
|
-
/** Every version id currently on disk, whatever the entries believe */
|
|
67
|
-
listVersionIds(): Promise<ReadonlyArray<string>>;
|
|
68
|
-
}
|
|
69
|
-
/**
|
|
70
|
-
* Percent-encodes a storage key into a filename. Upper case is escaped too:
|
|
71
|
-
* on a case-insensitive filesystem `space:Abc` and `space:abc` would be one file.
|
|
72
|
-
*/
|
|
73
|
-
export declare function encodeKey(key: string): string;
|
|
74
|
-
/** Reverses {@link encodeKey}. */
|
|
75
|
-
export declare function decodeKey(name: string): string;
|
|
76
|
-
/** Whether a rejection means "that file isn't there", which is usually not an error. */
|
|
77
|
-
export declare function isNotFound(error: unknown): boolean;
|
|
78
|
-
/** Walks — and creates — a chain of subdirectories. */
|
|
79
|
-
export declare function resolvePath(root: DirectoryHandleLike, segments: ReadonlyArray<string>): Promise<DirectoryHandleLike>;
|
|
80
|
-
/** Reads a file, treating absence as null rather than as a failure. */
|
|
81
|
-
export declare function readFolderFile(dir: DirectoryHandleLike, name: string): Promise<Uint8Array | null>;
|
|
82
|
-
/** Writes a file, replacing whatever was there. */
|
|
83
|
-
export declare function writeFolderFile(dir: DirectoryHandleLike, name: string, bytes: Uint8Array): Promise<void>;
|
|
84
|
-
/** Deletes a file, ignoring one that is already gone. */
|
|
85
|
-
export declare function removeFile(dir: DirectoryHandleLike, name: string): Promise<void>;
|
|
86
|
-
/**
|
|
87
|
-
* Opens a storage adapter backed by a directory on the user's disk. Versions
|
|
88
|
-
* are held in memory too, or a query would read one file per record; so are
|
|
89
|
-
* the entries' keys, or every listing would read the whole directory. Their
|
|
90
|
-
* values are not: they include file chunks, and the disk's cache holds them.
|
|
91
|
-
*
|
|
92
|
-
* @param path Where to keep these files from the folder root, `/` separating
|
|
93
|
-
* subdirectories, so several accounts can each have a subtree.
|
|
94
|
-
* @param options.shared Others write these entries as this reads them, and
|
|
95
|
-
* nothing reloads it: every read of an entry goes to the disk.
|
|
96
|
-
*/
|
|
97
|
-
export declare function createFolderAdapter(root: DirectoryHandleLike, path: string, options?: {
|
|
98
|
-
readonly shared?: boolean;
|
|
99
|
-
}): Promise<FolderAdapter>;
|
|
100
|
-
//# sourceMappingURL=folder-adapter.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"folder-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/folder-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,232 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* A StorageAdapter over a directory the user picked on their own disk.
|
|
3
|
-
*
|
|
4
|
-
* Unlike IndexedDB or OPFS it is not keyed by origin: every app given the
|
|
5
|
-
* folder reads the same files, so an app is a view on the user's data rather
|
|
6
|
-
* than the owner of a copy. The layout is legible, since the folder is theirs:
|
|
7
|
-
*
|
|
8
|
-
* ```
|
|
9
|
-
* <folder>/
|
|
10
|
-
* accounts.json who has an account here
|
|
11
|
-
* accounts/<id>/account.json that account's keys, locked
|
|
12
|
-
* accounts/<id>/stores/<name>/
|
|
13
|
-
* kv/<key> which version is current, what sync compares, space records
|
|
14
|
-
* versions/<cid>.json
|
|
15
|
-
* ```
|
|
16
|
-
*
|
|
17
|
-
* **Versions are the truth; the entries are an index over them.** Version
|
|
18
|
-
* files are immutable and named by their content hash, so two origins can
|
|
19
|
-
* share a folder without locking; which version is current is derived, and
|
|
20
|
-
* {@link reconcileFolder} puts it right.
|
|
21
|
-
*/
|
|
22
|
-
import { utf8Encode, utf8Decode } from '../utils/encoding.js';
|
|
23
|
-
import { isStoredVersion } from '../utils/guards.js';
|
|
24
|
-
const VERSION_SUFFIX = '.json';
|
|
25
|
-
const versionFile = (id) => encodeKey(id) + VERSION_SUFFIX;
|
|
26
|
-
/**
|
|
27
|
-
* Percent-encodes a storage key into a filename. Upper case is escaped too:
|
|
28
|
-
* on a case-insensitive filesystem `space:Abc` and `space:abc` would be one file.
|
|
29
|
-
*/
|
|
30
|
-
export function encodeKey(key) {
|
|
31
|
-
return Array.from(utf8Encode(key), encodeByte).join('');
|
|
32
|
-
}
|
|
33
|
-
function encodeByte(byte) {
|
|
34
|
-
const char = String.fromCharCode(byte);
|
|
35
|
-
return /[a-z0-9._-]/.test(char) ? char : `%${byte.toString(16).padStart(2, '0').toUpperCase()}`;
|
|
36
|
-
}
|
|
37
|
-
/** Reverses {@link encodeKey}. */
|
|
38
|
-
export function decodeKey(name) {
|
|
39
|
-
const bytes = [];
|
|
40
|
-
for (let i = 0; i < name.length; i++) {
|
|
41
|
-
if (name[i] === '%') {
|
|
42
|
-
bytes.push(Number.parseInt(name.slice(i + 1, i + 3), 16));
|
|
43
|
-
i += 2;
|
|
44
|
-
}
|
|
45
|
-
else {
|
|
46
|
-
bytes.push(name.charCodeAt(i));
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
return utf8Decode(new Uint8Array(bytes));
|
|
50
|
-
}
|
|
51
|
-
/** Whether a rejection means "that file isn't there", which is usually not an error. */
|
|
52
|
-
export function isNotFound(error) {
|
|
53
|
-
return error instanceof Error && error.name === 'NotFoundError';
|
|
54
|
-
}
|
|
55
|
-
/** Walks — and creates — a chain of subdirectories. */
|
|
56
|
-
export async function resolvePath(root, segments) {
|
|
57
|
-
let current = root;
|
|
58
|
-
for (const segment of segments) {
|
|
59
|
-
current = await current.getDirectoryHandle(segment, { create: true });
|
|
60
|
-
}
|
|
61
|
-
return current;
|
|
62
|
-
}
|
|
63
|
-
/** Reads a file, treating absence as null rather than as a failure. */
|
|
64
|
-
export async function readFolderFile(dir, name) {
|
|
65
|
-
try {
|
|
66
|
-
const handle = await dir.getFileHandle(name);
|
|
67
|
-
const file = await handle.getFile();
|
|
68
|
-
return new Uint8Array(await file.arrayBuffer());
|
|
69
|
-
}
|
|
70
|
-
catch (error) {
|
|
71
|
-
if (isNotFound(error))
|
|
72
|
-
return null;
|
|
73
|
-
throw error;
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
/** Writes a file, replacing whatever was there. */
|
|
77
|
-
export async function writeFolderFile(dir, name, bytes) {
|
|
78
|
-
const handle = await dir.getFileHandle(name, { create: true });
|
|
79
|
-
const writable = await handle.createWritable();
|
|
80
|
-
await writable.write(bytes);
|
|
81
|
-
await writable.close();
|
|
82
|
-
}
|
|
83
|
-
/** Deletes a file, ignoring one that is already gone. */
|
|
84
|
-
export async function removeFile(dir, name) {
|
|
85
|
-
try {
|
|
86
|
-
await dir.removeEntry(name);
|
|
87
|
-
}
|
|
88
|
-
catch (error) {
|
|
89
|
-
if (!isNotFound(error))
|
|
90
|
-
throw error;
|
|
91
|
-
}
|
|
92
|
-
}
|
|
93
|
-
/**
|
|
94
|
-
* Opens a storage adapter backed by a directory on the user's disk. Versions
|
|
95
|
-
* are held in memory too, or a query would read one file per record; so are
|
|
96
|
-
* the entries' keys, or every listing would read the whole directory. Their
|
|
97
|
-
* values are not: they include file chunks, and the disk's cache holds them.
|
|
98
|
-
*
|
|
99
|
-
* @param path Where to keep these files from the folder root, `/` separating
|
|
100
|
-
* subdirectories, so several accounts can each have a subtree.
|
|
101
|
-
* @param options.shared Others write these entries as this reads them, and
|
|
102
|
-
* nothing reloads it: every read of an entry goes to the disk.
|
|
103
|
-
*/
|
|
104
|
-
export async function createFolderAdapter(root, path, options = {}) {
|
|
105
|
-
const segments = path.split('/').filter(Boolean).map(encodeKey);
|
|
106
|
-
if (segments.length === 0)
|
|
107
|
-
throw new Error('A folder adapter needs a path to live in.');
|
|
108
|
-
const base = await resolvePath(root, segments);
|
|
109
|
-
const kvDir = await base.getDirectoryHandle('kv', { create: true });
|
|
110
|
-
const versionsDir = await base.getDirectoryHandle('versions', { create: true });
|
|
111
|
-
const versions = new Map();
|
|
112
|
-
/** The entries' keys, as of the last `reload` and this adapter's own writes since; none kept when shared */
|
|
113
|
-
let keys = options.shared ? null : new Set();
|
|
114
|
-
/** Writes made while a reload lists the directory, which its listing may have missed: whether each key is there */
|
|
115
|
-
let writtenDuringReload = null;
|
|
116
|
-
async function listKeys() {
|
|
117
|
-
const found = [];
|
|
118
|
-
for await (const name of kvDir.keys())
|
|
119
|
-
found.push(decodeKey(name));
|
|
120
|
-
return found;
|
|
121
|
-
}
|
|
122
|
-
async function readVersionFile(name) {
|
|
123
|
-
const bytes = await readFolderFile(versionsDir, name);
|
|
124
|
-
if (!bytes)
|
|
125
|
-
return null;
|
|
126
|
-
try {
|
|
127
|
-
const parsed = JSON.parse(utf8Decode(bytes));
|
|
128
|
-
return isStoredVersion(parsed) ? parsed : null;
|
|
129
|
-
}
|
|
130
|
-
catch {
|
|
131
|
-
// Half written by a writer that died mid-flush: not ours to repair.
|
|
132
|
-
return null;
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
async function put(key, value) {
|
|
136
|
-
await writeFolderFile(kvDir, encodeKey(key), value);
|
|
137
|
-
keys?.add(key);
|
|
138
|
-
writtenDuringReload?.set(key, true);
|
|
139
|
-
}
|
|
140
|
-
async function remove(key) {
|
|
141
|
-
await removeFile(kvDir, encodeKey(key));
|
|
142
|
-
keys?.delete(key);
|
|
143
|
-
writtenDuringReload?.set(key, false);
|
|
144
|
-
}
|
|
145
|
-
/** The reload running now: one at a time, so writes made during it are kept by exactly one */
|
|
146
|
-
let reloading = null;
|
|
147
|
-
const reload = () => (reloading ??= reloadOnce().finally(() => {
|
|
148
|
-
reloading = null;
|
|
149
|
-
}));
|
|
150
|
-
async function reloadOnce() {
|
|
151
|
-
const seen = new Set();
|
|
152
|
-
const added = [];
|
|
153
|
-
for await (const name of versionsDir.keys()) {
|
|
154
|
-
if (!name.endsWith(VERSION_SUFFIX))
|
|
155
|
-
continue;
|
|
156
|
-
const id = decodeKey(name.slice(0, -VERSION_SUFFIX.length));
|
|
157
|
-
seen.add(id);
|
|
158
|
-
if (versions.has(id))
|
|
159
|
-
continue;
|
|
160
|
-
const version = await readVersionFile(name);
|
|
161
|
-
if (!version)
|
|
162
|
-
continue;
|
|
163
|
-
versions.set(id, version);
|
|
164
|
-
added.push(id);
|
|
165
|
-
}
|
|
166
|
-
const removed = [...versions.keys()].filter((id) => !seen.has(id));
|
|
167
|
-
for (const id of removed)
|
|
168
|
-
versions.delete(id);
|
|
169
|
-
// Built aside and swapped in whole: an entry must never read as missing while the directory is listed.
|
|
170
|
-
if (keys) {
|
|
171
|
-
writtenDuringReload = new Map();
|
|
172
|
-
const listed = new Set(await listKeys());
|
|
173
|
-
for (const [key, there] of writtenDuringReload) {
|
|
174
|
-
if (there)
|
|
175
|
-
listed.add(key);
|
|
176
|
-
else
|
|
177
|
-
listed.delete(key);
|
|
178
|
-
}
|
|
179
|
-
keys = listed;
|
|
180
|
-
writtenDuringReload = null;
|
|
181
|
-
}
|
|
182
|
-
return { added, removed };
|
|
183
|
-
}
|
|
184
|
-
await reload();
|
|
185
|
-
return Object.freeze({
|
|
186
|
-
namespace: path,
|
|
187
|
-
reload,
|
|
188
|
-
async listVersionIds() {
|
|
189
|
-
return [...versions.keys()];
|
|
190
|
-
},
|
|
191
|
-
async get(key) {
|
|
192
|
-
return !keys || keys.has(key) ? readFolderFile(kvDir, encodeKey(key)) : null;
|
|
193
|
-
},
|
|
194
|
-
put,
|
|
195
|
-
delete: remove,
|
|
196
|
-
async list(prefix = '') {
|
|
197
|
-
return [...(keys ?? (await listKeys()))].filter((key) => key.startsWith(prefix));
|
|
198
|
-
},
|
|
199
|
-
async putVersion(version) {
|
|
200
|
-
await writeFolderFile(versionsDir, versionFile(version.id), utf8Encode(JSON.stringify(version)));
|
|
201
|
-
versions.set(version.id, version);
|
|
202
|
-
},
|
|
203
|
-
async getVersion(id) {
|
|
204
|
-
const known = versions.get(id);
|
|
205
|
-
if (known)
|
|
206
|
-
return known;
|
|
207
|
-
// Not in memory: another origin may have written it since the last reload.
|
|
208
|
-
const version = await readVersionFile(versionFile(id));
|
|
209
|
-
if (version)
|
|
210
|
-
versions.set(id, version);
|
|
211
|
-
return version;
|
|
212
|
-
},
|
|
213
|
-
async deleteVersion(id) {
|
|
214
|
-
await removeFile(versionsDir, versionFile(id));
|
|
215
|
-
versions.delete(id);
|
|
216
|
-
},
|
|
217
|
-
async batch(ops) {
|
|
218
|
-
for (const op of ops) {
|
|
219
|
-
if (op.type === 'put')
|
|
220
|
-
await put(op.key, op.value);
|
|
221
|
-
else
|
|
222
|
-
await remove(op.key);
|
|
223
|
-
}
|
|
224
|
-
},
|
|
225
|
-
async close() {
|
|
226
|
-
versions.clear();
|
|
227
|
-
// Anything still in flight reads the disk again, never an empty index.
|
|
228
|
-
keys = null;
|
|
229
|
-
},
|
|
230
|
-
});
|
|
231
|
-
}
|
|
232
|
-
//# sourceMappingURL=folder-adapter.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"folder-adapter.js","sourceRoot":"","sources":["../../src/storage/folder-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Making a shared folder converge without anybody taking a lock.
|
|
3
|
-
*
|
|
4
|
-
* Two origins, or two devices behind a sync service, can write one folder at
|
|
5
|
-
* once. Version files are named by their content hash, so they never
|
|
6
|
-
* conflict; the entries saying which version is current can be lost to a
|
|
7
|
-
* race, but they are derived from the files. So **the set of version files
|
|
8
|
-
* wins**: reconciling places every file that turned up and drops entries
|
|
9
|
-
* whose file went away.
|
|
10
|
-
*/
|
|
11
|
-
import type { StorageProvider } from './storage-provider.js';
|
|
12
|
-
import type { FolderAdapter } from './folder-adapter.js';
|
|
13
|
-
import type { Version } from '../types.js';
|
|
14
|
-
/** What a pass over the folder found */
|
|
15
|
-
export interface FolderReconciliation {
|
|
16
|
-
/** Version files that appeared since the last pass — another origin's writes */
|
|
17
|
-
readonly added: ReadonlyArray<string>;
|
|
18
|
-
/** Version files that are gone */
|
|
19
|
-
readonly removed: ReadonlyArray<string>;
|
|
20
|
-
/** Versions placed or unplaced to match the directory */
|
|
21
|
-
readonly repaired: ReadonlyArray<string>;
|
|
22
|
-
/** Whether anything moved at all — worth a re-render when true */
|
|
23
|
-
readonly changed: boolean;
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Re-reads the folder and brings the entries back in line with it. With
|
|
27
|
-
* nothing new on disk it is two listings and no writes.
|
|
28
|
-
*
|
|
29
|
-
* @param accept Whether a version found on disk may be placed: anyone who can
|
|
30
|
-
* write the folder can drop a file in it. One refused now is asked about again.
|
|
31
|
-
*/
|
|
32
|
-
export declare function reconcileFolder(storage: StorageProvider, adapter: FolderAdapter, accept?: (version: Version) => Promise<boolean>): Promise<FolderReconciliation>;
|
|
33
|
-
//# sourceMappingURL=folder-reconcile.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"folder-reconcile.d.ts","sourceRoot":"","sources":["../../src/storage/folder-reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAoB,GAChE,OAAO,CAAC,oBAAoB,CAAC,CAY/B"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"folder-reconcile.js","sourceRoot":"","sources":["../../src/storage/folder-reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkBH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB,EACxB,OAAsB,EACtB,MAAM,GAA2C,KAAK,IAAI,EAAE,CAAC,IAAI;IAEjE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,mEAAmE;IACnE,IAAI,KAAK;QAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AACvG,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,QAAQ,CACrB,OAAwB,EACxB,OAAsB,EACtB,MAAmB,EACnB,QAAqB,EACrB,MAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QACnD,uEAAuE;QACvE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YAAE,SAAS;QACnD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qEAAqE;AACrE,KAAK,UAAU,QAAQ,CACrB,OAAwB,EACxB,OAAsB,EACtB,MAAmB;IAEnB,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
|
package/dist/storage/index.d.ts
DELETED
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
/** Exports all storage related functionality. */
|
|
2
|
-
export * from './indexeddb-adapter.js';
|
|
3
|
-
export * from './storage-provider.js';
|
|
4
|
-
export * from './directory-access.js';
|
|
5
|
-
export type { DirectoryHandleLike } from './folder-adapter.js';
|
|
6
|
-
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
|
package/dist/storage/index.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module indexeddb-adapter
|
|
3
|
-
* The browser's StorageAdapter: a key-value store and a store of versions by id.
|
|
4
|
-
*/
|
|
5
|
-
import type { StorageAdapter } from '../types.js';
|
|
6
|
-
/** Creates an IndexedDB backed storage adapter */
|
|
7
|
-
export declare function createIndexedDBAdapter(dbName?: string): Promise<StorageAdapter>;
|
|
8
|
-
//# sourceMappingURL=indexeddb-adapter.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"indexeddb-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/indexeddb-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAUpE,kDAAkD;AAClD,wBAAsB,sBAAsB,CAAC,MAAM,SAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2E9F"}
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module indexeddb-adapter
|
|
3
|
-
* The browser's StorageAdapter: a key-value store and a store of versions by id.
|
|
4
|
-
*/
|
|
5
|
-
import { isStoredVersion } from '../utils/guards.js';
|
|
6
|
-
import { requestResult, transactionDone } from '../identity/idb.js';
|
|
7
|
-
/**
|
|
8
|
-
* Bumped whenever the object stores change. Opening a database made at an
|
|
9
|
-
* earlier one wipes it: it is a local copy, rebuilt by syncing with peers.
|
|
10
|
-
*/
|
|
11
|
-
const DB_VERSION = 4;
|
|
12
|
-
/** Creates an IndexedDB backed storage adapter */
|
|
13
|
-
export async function createIndexedDBAdapter(dbName = 'minca-storage') {
|
|
14
|
-
const db = await openDatabase(dbName);
|
|
15
|
-
const reading = (name) => db.transaction([name], 'readonly').objectStore(name);
|
|
16
|
-
/** Runs `work` in one read-write transaction, settling once it commits */
|
|
17
|
-
async function writing(names, work) {
|
|
18
|
-
const tx = db.transaction(names, 'readwrite');
|
|
19
|
-
const complete = transactionDone(tx);
|
|
20
|
-
work(tx);
|
|
21
|
-
await complete;
|
|
22
|
-
}
|
|
23
|
-
return Object.freeze({
|
|
24
|
-
async get(key) {
|
|
25
|
-
const result = await requestResult(reading('kv').get(key));
|
|
26
|
-
return result instanceof ArrayBuffer ? new Uint8Array(result) : null;
|
|
27
|
-
},
|
|
28
|
-
put: (key, value) => writing(['kv'], (tx) => tx.objectStore('kv').put(value.buffer, key)),
|
|
29
|
-
delete: (key) => writing(['kv'], (tx) => tx.objectStore('kv').delete(key)),
|
|
30
|
-
async list(prefix = '') {
|
|
31
|
-
const store = reading('kv');
|
|
32
|
-
const keys = await requestResult(prefix ? store.getAllKeys(under(prefix)) : store.getAllKeys());
|
|
33
|
-
return keys.filter((key) => typeof key === 'string');
|
|
34
|
-
},
|
|
35
|
-
async entries(prefix) {
|
|
36
|
-
const store = reading('kv');
|
|
37
|
-
// Both in key order, from one transaction: they line up.
|
|
38
|
-
const [keys, values] = await Promise.all([
|
|
39
|
-
requestResult(store.getAllKeys(under(prefix))),
|
|
40
|
-
requestResult(store.getAll(under(prefix))),
|
|
41
|
-
]);
|
|
42
|
-
return keys.flatMap((key, i) => {
|
|
43
|
-
const value = values[i];
|
|
44
|
-
return typeof key === 'string' && value instanceof ArrayBuffer
|
|
45
|
-
? [[key, new Uint8Array(value)]]
|
|
46
|
-
: [];
|
|
47
|
-
});
|
|
48
|
-
},
|
|
49
|
-
commit: (write) => writing(['kv', 'versions'], (tx) => {
|
|
50
|
-
const versions = tx.objectStore('versions');
|
|
51
|
-
for (const version of write.store)
|
|
52
|
-
versions.put(version);
|
|
53
|
-
applyOps(tx.objectStore('kv'), write.ops);
|
|
54
|
-
for (const id of write.remove)
|
|
55
|
-
versions.delete(id);
|
|
56
|
-
}),
|
|
57
|
-
async getVersions(ids) {
|
|
58
|
-
if (ids.length === 0)
|
|
59
|
-
return [];
|
|
60
|
-
const store = reading('versions');
|
|
61
|
-
return Promise.all(ids.map((id) => readVersion(store.get(id))));
|
|
62
|
-
},
|
|
63
|
-
putVersion: (version) => writing(['versions'], (tx) => tx.objectStore('versions').put(version)),
|
|
64
|
-
getVersion: (id) => readVersion(reading('versions').get(id)),
|
|
65
|
-
deleteVersion: (id) => writing(['versions'], (tx) => tx.objectStore('versions').delete(id)),
|
|
66
|
-
batch: (ops) => writing(['kv'], (tx) => applyOps(tx.objectStore('kv'), ops)),
|
|
67
|
-
async close() {
|
|
68
|
-
db.close();
|
|
69
|
-
},
|
|
70
|
-
});
|
|
71
|
-
}
|
|
72
|
-
/**
|
|
73
|
-
* How long opening a database may take. It takes milliseconds, unless
|
|
74
|
-
* another tab or worker holds it in a way that makes this one wait, which
|
|
75
|
-
* otherwise waits for ever, saying nothing.
|
|
76
|
-
*/
|
|
77
|
-
const OPEN_WITHIN_MS = 15_000;
|
|
78
|
-
/** Why a database won't open, in words a person can act on */
|
|
79
|
-
const NOT_ANSWERING = "This browser's storage for Minca isn't answering. Another Minca tab or window may be holding it: close the others, then reload this page.";
|
|
80
|
-
/** Opens the database, wiping one made at an earlier version */
|
|
81
|
-
function openDatabase(dbName) {
|
|
82
|
-
return new Promise((resolve, reject) => {
|
|
83
|
-
let gaveUp = false;
|
|
84
|
-
const timer = setTimeout(() => {
|
|
85
|
-
gaveUp = true;
|
|
86
|
-
reject(new Error(NOT_ANSWERING));
|
|
87
|
-
}, OPEN_WITHIN_MS);
|
|
88
|
-
const request = globalThis.indexedDB.open(dbName, DB_VERSION);
|
|
89
|
-
request.onupgradeneeded = () => {
|
|
90
|
-
const db = request.result;
|
|
91
|
-
for (const name of Array.from(db.objectStoreNames))
|
|
92
|
-
db.deleteObjectStore(name);
|
|
93
|
-
// Which version is current, what sync compares, space records
|
|
94
|
-
db.createObjectStore('kv');
|
|
95
|
-
db.createObjectStore('versions', { keyPath: 'id' });
|
|
96
|
-
};
|
|
97
|
-
request.onsuccess = () => {
|
|
98
|
-
clearTimeout(timer);
|
|
99
|
-
const db = request.result;
|
|
100
|
-
// Opened after this gave up: closed, or it would hold the database from every later upgrade.
|
|
101
|
-
if (gaveUp)
|
|
102
|
-
return db.close();
|
|
103
|
-
// Another tab upgrading waits on every connection open: this one lets go.
|
|
104
|
-
db.onversionchange = () => db.close();
|
|
105
|
-
resolve(db);
|
|
106
|
-
};
|
|
107
|
-
request.onerror = () => {
|
|
108
|
-
clearTimeout(timer);
|
|
109
|
-
reject(new Error(`This browser's storage for Minca wouldn't open (${request.error?.message ?? dbName}).`));
|
|
110
|
-
};
|
|
111
|
-
});
|
|
112
|
-
}
|
|
113
|
-
/** Every key starting with `prefix` */
|
|
114
|
-
const under = (prefix) => IDBKeyRange.bound(prefix, prefix + '', false, false);
|
|
115
|
-
function applyOps(kv, ops) {
|
|
116
|
-
for (const op of ops) {
|
|
117
|
-
if (op.type === 'put')
|
|
118
|
-
kv.put(op.value.buffer, op.key);
|
|
119
|
-
else
|
|
120
|
-
kv.delete(op.key);
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
/** A stored version, or null for a miss */
|
|
124
|
-
async function readVersion(request) {
|
|
125
|
-
const value = await requestResult(request);
|
|
126
|
-
return isStoredVersion(value) ? value : null;
|
|
127
|
-
}
|
|
128
|
-
//# sourceMappingURL=indexeddb-adapter.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"indexeddb-adapter.js","sourceRoot":"","sources":["../../src/storage/indexeddb-adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @module sqlite-adapter
|
|
3
|
-
* A node's stores in one SQLite database: every store's entries and version
|
|
4
|
-
* bodies, each store a path, every write one transaction.
|
|
5
|
-
*
|
|
6
|
-
* The connection is passed in, so this module never imports a driver and runs
|
|
7
|
-
* wherever one does: Node's `node:sqlite` (`DatabaseSync`), Bun's `bun:sqlite`
|
|
8
|
-
* (`Database`), or another with the same four methods.
|
|
9
|
-
*
|
|
10
|
-
* ```
|
|
11
|
-
* stores (id, path) one row per store a node opened
|
|
12
|
-
* entries (store, key, value) which version is current, what sync compares, space records
|
|
13
|
-
* versions (store, id, body) version bodies, as UTF-8 JSON
|
|
14
|
-
* ```
|
|
15
|
-
*
|
|
16
|
-
* One process writes the database. Unlike a directory store it keeps nothing
|
|
17
|
-
* in memory between calls, so there is nothing to reload and nothing polls it.
|
|
18
|
-
*/
|
|
19
|
-
import type { StoreFactory } from '../node/stores.js';
|
|
20
|
-
/** A value SQLite binds or returns here */
|
|
21
|
-
export type SqliteValue = string | number | bigint | Uint8Array | null;
|
|
22
|
-
/** One prepared statement, as Node's `StatementSync` and Bun's `Statement` both give */
|
|
23
|
-
export interface SqliteStatement {
|
|
24
|
-
run(...params: SqliteValue[]): unknown;
|
|
25
|
-
/** The first row, or undefined (Node) or null (Bun) for none */
|
|
26
|
-
get(...params: SqliteValue[]): unknown;
|
|
27
|
-
all(...params: SqliteValue[]): unknown[];
|
|
28
|
-
}
|
|
29
|
-
/** The slice of a SQLite connection the stores use */
|
|
30
|
-
export interface SqliteDatabase {
|
|
31
|
-
exec(sql: string): void;
|
|
32
|
-
prepare(sql: string): SqliteStatement;
|
|
33
|
-
}
|
|
34
|
-
/** A node's stores in one database, and what they take */
|
|
35
|
-
export type SqliteStores = StoreFactory & {
|
|
36
|
-
/** What a store keeps, in bytes: its keys, values and version bodies */
|
|
37
|
-
size(path: string): number;
|
|
38
|
-
/** Every store path that holds anything */
|
|
39
|
-
paths(): string[];
|
|
40
|
-
};
|
|
41
|
-
/**
|
|
42
|
-
* A node's stores in one SQLite database, for a node on a server or a
|
|
43
|
-
* computer. Opening a store again gives the same data; closing one leaves the
|
|
44
|
-
* database open, since the others share it: close the connection yourself
|
|
45
|
-
* when the node is done.
|
|
46
|
-
* @param options.localKey Seals the registry. Without it nothing is sealed.
|
|
47
|
-
*/
|
|
48
|
-
export declare function sqliteStores(db: SqliteDatabase, options?: {
|
|
49
|
-
readonly localKey?: CryptoKey | null;
|
|
50
|
-
}): SqliteStores;
|
|
51
|
-
/**
|
|
52
|
-
* The first string after every string starting with `prefix`, or null when
|
|
53
|
-
* there is none. SQLite compares text as UTF-8 bytes, which sort as code
|
|
54
|
-
* points do, so `[prefix, after(prefix))` is exactly the strings it starts.
|
|
55
|
-
*/
|
|
56
|
-
export declare function after(prefix: string): string | null;
|
|
57
|
-
//# sourceMappingURL=sqlite-adapter.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../src/storage/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAMpE,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAEvE,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACvC,gEAAgE;IAChE,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACvC,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;CAC1C;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CACvC;AAyBD,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IACxC,wEAAwE;IACxE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,KAAK,IAAI,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;CAAO,GACrD,YAAY,CAsJd;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUnD"}
|