@minca/core 0.1.7 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/elements/auth-styles.d.ts +1 -1
- package/dist/elements/auth-styles.d.ts.map +1 -1
- package/dist/elements/auth-styles.js +16 -8
- package/dist/elements/auth-styles.js.map +1 -1
- package/dist/elements/minca-auth.d.ts +7 -0
- package/dist/elements/minca-auth.d.ts.map +1 -1
- package/dist/elements/minca-auth.js +107 -49
- package/dist/elements/minca-auth.js.map +1 -1
- package/dist/files/file-id.d.ts +51 -0
- package/dist/files/file-id.d.ts.map +1 -0
- package/dist/files/file-id.js +97 -0
- package/dist/files/file-id.js.map +1 -0
- package/dist/files/seal.d.ts +20 -0
- package/dist/files/seal.d.ts.map +1 -0
- package/dist/files/seal.js +77 -0
- package/dist/files/seal.js.map +1 -0
- package/dist/files/space-files.d.ts +51 -0
- package/dist/files/space-files.d.ts.map +1 -0
- package/dist/files/space-files.js +476 -0
- package/dist/files/space-files.js.map +1 -0
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/node/api.d.ts +6 -1
- package/dist/node/api.d.ts.map +1 -1
- package/dist/node/api.js +17 -3
- package/dist/node/api.js.map +1 -1
- package/dist/node/carrier.d.ts +17 -2
- package/dist/node/carrier.d.ts.map +1 -1
- package/dist/node/carrier.js +26 -4
- package/dist/node/carrier.js.map +1 -1
- package/dist/node/copy.d.ts +0 -4
- package/dist/node/copy.d.ts.map +1 -1
- package/dist/node/copy.js +26 -0
- package/dist/node/copy.js.map +1 -1
- package/dist/node/host.d.ts +66 -1
- package/dist/node/host.d.ts.map +1 -1
- package/dist/node/host.js +571 -5
- package/dist/node/host.js.map +1 -1
- package/dist/node/index.d.ts +2 -2
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +1 -1
- package/dist/node/index.js.map +1 -1
- package/dist/node/node.d.ts.map +1 -1
- package/dist/node/node.js +235 -75
- package/dist/node/node.js.map +1 -1
- package/dist/node/space-runtime.d.ts +9 -0
- package/dist/node/space-runtime.d.ts.map +1 -1
- package/dist/node/space-runtime.js +125 -16
- package/dist/node/space-runtime.js.map +1 -1
- package/dist/node/stores.d.ts +44 -8
- package/dist/node/stores.d.ts.map +1 -1
- package/dist/node/stores.js +44 -7
- package/dist/node/stores.js.map +1 -1
- package/dist/node/types.d.ts +73 -6
- package/dist/node/types.d.ts.map +1 -1
- package/dist/node/usage.d.ts +54 -0
- package/dist/node/usage.d.ts.map +1 -0
- package/dist/node/usage.js +201 -0
- package/dist/node/usage.js.map +1 -0
- package/dist/node/writer-keys.d.ts +4 -1
- package/dist/node/writer-keys.d.ts.map +1 -1
- package/dist/node/writer-keys.js +25 -6
- package/dist/node/writer-keys.js.map +1 -1
- package/dist/node/writers.d.ts.map +1 -1
- package/dist/node/writers.js +10 -3
- package/dist/node/writers.js.map +1 -1
- package/dist/react/minca-auth.d.ts +3 -1
- package/dist/react/minca-auth.d.ts.map +1 -1
- package/dist/react/minca-auth.js +5 -3
- package/dist/react/minca-auth.js.map +1 -1
- package/dist/schema/version.d.ts +5 -0
- package/dist/schema/version.d.ts.map +1 -1
- package/dist/schema/version.js +1 -0
- package/dist/schema/version.js.map +1 -1
- package/dist/schemas/fragments.d.ts +23 -2
- package/dist/schemas/fragments.d.ts.map +1 -1
- package/dist/schemas/fragments.js +5 -2
- package/dist/schemas/fragments.js.map +1 -1
- package/dist/schemas/library/annotations.d.ts +24 -0
- package/dist/schemas/library/annotations.d.ts.map +1 -1
- package/dist/schemas/library/community.d.ts +24 -0
- package/dist/schemas/library/community.d.ts.map +1 -1
- package/dist/schemas/library/life.d.ts +72 -0
- package/dist/schemas/library/life.d.ts.map +1 -1
- package/dist/schemas/library/media.d.ts +144 -0
- package/dist/schemas/library/media.d.ts.map +1 -1
- package/dist/schemas/library/money.d.ts +24 -0
- package/dist/schemas/library/money.d.ts.map +1 -1
- package/dist/schemas/library/publishing.d.ts +96 -0
- package/dist/schemas/library/publishing.d.ts.map +1 -1
- package/dist/schemas/library/social.d.ts +72 -0
- package/dist/schemas/library/social.d.ts.map +1 -1
- package/dist/session/account-hint.d.ts +13 -0
- package/dist/session/account-hint.d.ts.map +1 -0
- package/dist/session/account-hint.js +51 -0
- package/dist/session/account-hint.js.map +1 -0
- package/dist/session/auth.d.ts +51 -3
- package/dist/session/auth.d.ts.map +1 -1
- package/dist/session/auth.js +262 -36
- package/dist/session/auth.js.map +1 -1
- package/dist/session/connect.d.ts.map +1 -1
- package/dist/session/connect.js +6 -2
- package/dist/session/connect.js.map +1 -1
- package/dist/session/hosting.d.ts +73 -28
- package/dist/session/hosting.d.ts.map +1 -1
- package/dist/session/hosting.js +85 -5
- package/dist/session/hosting.js.map +1 -1
- package/dist/session/index.d.ts +1 -0
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +1 -0
- package/dist/session/index.js.map +1 -1
- package/dist/session/pairing.d.ts +2 -0
- package/dist/session/pairing.d.ts.map +1 -1
- package/dist/session/pairing.js +8 -0
- package/dist/session/pairing.js.map +1 -1
- package/dist/session/places.d.ts +7 -0
- package/dist/session/places.d.ts.map +1 -1
- package/dist/session/places.js +20 -2
- package/dist/session/places.js.map +1 -1
- package/dist/space/account-registry.d.ts +13 -0
- package/dist/space/account-registry.d.ts.map +1 -1
- package/dist/space/account-registry.js +13 -0
- package/dist/space/account-registry.js.map +1 -1
- package/dist/storage/blob/directory.d.ts +14 -0
- package/dist/storage/blob/directory.d.ts.map +1 -0
- package/dist/storage/blob/directory.js +80 -0
- package/dist/storage/blob/directory.js.map +1 -0
- package/dist/storage/folder-adapter.d.ts +22 -0
- package/dist/storage/folder-adapter.d.ts.map +1 -1
- package/dist/storage/folder-adapter.js +5 -5
- package/dist/storage/folder-adapter.js.map +1 -1
- package/dist/storage/mirror.d.ts +9 -2
- package/dist/storage/mirror.d.ts.map +1 -1
- package/dist/storage/mirror.js +60 -35
- package/dist/storage/mirror.js.map +1 -1
- package/dist/storage/segment.d.ts +7 -2
- package/dist/storage/segment.d.ts.map +1 -1
- package/dist/storage/segment.js +25 -3
- package/dist/storage/segment.js.map +1 -1
- package/dist/sync/sync-engine.d.ts +2 -0
- package/dist/sync/sync-engine.d.ts.map +1 -1
- package/dist/sync/sync-engine.js +5 -0
- package/dist/sync/sync-engine.js.map +1 -1
- package/dist/sync/sync-messages.d.ts +24 -0
- package/dist/sync/sync-messages.d.ts.map +1 -1
- package/dist/sync/sync-messages.js.map +1 -1
- package/docs/node.md +63 -24
- package/docs/sign-in.md +123 -24
- package/docs/spaces.md +18 -10
- package/docs/standard-library.md +16 -20
- package/docs/storage.md +120 -15
- package/package.json +1 -1
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { sha256 } from '../utils/hash.js';
|
|
2
|
+
import { bytesToHex, concatBytes } from '../utils/encoding.js';
|
|
3
|
+
import { isRecord } from '../utils/guards.js';
|
|
4
|
+
/** A chunk, and the record size of the files' encryption: one record is one chunk */
|
|
5
|
+
export const CHUNK = 262_144;
|
|
6
|
+
/** The largest file, in bytes as stored */
|
|
7
|
+
export const MAX_FILE_SIZE = 2 ** 31;
|
|
8
|
+
/** Files a version names that peers take */
|
|
9
|
+
export const MAX_FILES = 16;
|
|
10
|
+
const HASH = /^[0-9a-f]{64}$/;
|
|
11
|
+
const isFileName = (value) => isRecord(value) &&
|
|
12
|
+
typeof value.hash === 'string' &&
|
|
13
|
+
HASH.test(value.hash) &&
|
|
14
|
+
typeof value.size === 'number' &&
|
|
15
|
+
Number.isSafeInteger(value.size) &&
|
|
16
|
+
value.size >= 1 &&
|
|
17
|
+
value.size <= MAX_FILE_SIZE;
|
|
18
|
+
/**
|
|
19
|
+
* The files a version names, as every peer takes them: in order, the first
|
|
20
|
+
* 16 well-formed entries with distinct ids; none on a delete. Never a reason
|
|
21
|
+
* to refuse the version.
|
|
22
|
+
*/
|
|
23
|
+
export function filesOf(version) {
|
|
24
|
+
if (version.deleted || !Array.isArray(version.files))
|
|
25
|
+
return [];
|
|
26
|
+
const taken = [];
|
|
27
|
+
const seen = new Set();
|
|
28
|
+
for (const entry of version.files) {
|
|
29
|
+
if (taken.length === MAX_FILES)
|
|
30
|
+
break;
|
|
31
|
+
if (!isFileName(entry) || seen.has(entry.hash))
|
|
32
|
+
continue;
|
|
33
|
+
seen.add(entry.hash);
|
|
34
|
+
taken.push({ hash: entry.hash, size: entry.size });
|
|
35
|
+
}
|
|
36
|
+
return taken;
|
|
37
|
+
}
|
|
38
|
+
/** How many chunks a file of this size has */
|
|
39
|
+
export const chunkCount = (size) => Math.ceil(size / CHUNK);
|
|
40
|
+
/** How long chunk `index` of a file of this size is */
|
|
41
|
+
export const chunkLength = (size, index) => index < chunkCount(size) - 1 ? CHUNK : size - (chunkCount(size) - 1) * CHUNK;
|
|
42
|
+
/** The SHA-256 of each chunk, in order, concatenated */
|
|
43
|
+
export async function chunkListOf(bytes) {
|
|
44
|
+
const hashes = [];
|
|
45
|
+
for (let at = 0; at < bytes.length; at += CHUNK)
|
|
46
|
+
hashes.push(await sha256(bytes.subarray(at, at + CHUNK)));
|
|
47
|
+
return concatBytes(...hashes);
|
|
48
|
+
}
|
|
49
|
+
/** A file's id: SHA-256 of its size, as 8 bytes big-endian, and its chunk list */
|
|
50
|
+
export async function fileIdOf(size, list) {
|
|
51
|
+
const length = new Uint8Array(8);
|
|
52
|
+
new DataView(length.buffer).setBigUint64(0, BigInt(size));
|
|
53
|
+
return bytesToHex(await sha256(concatBytes(length, list)));
|
|
54
|
+
}
|
|
55
|
+
/** Whether a chunk list is the one this file's id names: exactly its length, and giving the id */
|
|
56
|
+
export async function listFits(file, list) {
|
|
57
|
+
return list.length === 32 * chunkCount(file.size) && (await fileIdOf(file.size, list)) === file.hash;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Whether these are the bytes of chunk `index`: its length, and the hash the
|
|
61
|
+
* list gives it. Without a list, only a file of one chunk can be checked: by
|
|
62
|
+
* its id.
|
|
63
|
+
*/
|
|
64
|
+
export async function chunkFits(file, list, index, bytes) {
|
|
65
|
+
if (index < 0 || index >= chunkCount(file.size) || bytes.length !== chunkLength(file.size, index))
|
|
66
|
+
return false;
|
|
67
|
+
const hash = await sha256(bytes);
|
|
68
|
+
if (list)
|
|
69
|
+
return bytesToHex(hash) === bytesToHex(list.subarray(32 * index, 32 * index + 32));
|
|
70
|
+
return chunkCount(file.size) === 1 && (await fileIdOf(file.size, hash)) === file.hash;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The files a body refers to: every object in it shaped as a file reference
|
|
74
|
+
* (`hash`, `size`, `key` and `salt`, as `addFile` gives one). What the node
|
|
75
|
+
* names on a version it writes, so the envelope and the body agree.
|
|
76
|
+
*/
|
|
77
|
+
export function fileRefsIn(body) {
|
|
78
|
+
const found = new Map();
|
|
79
|
+
const walk = (value, depth) => {
|
|
80
|
+
if (depth > 32)
|
|
81
|
+
return;
|
|
82
|
+
if (Array.isArray(value)) {
|
|
83
|
+
for (const item of value)
|
|
84
|
+
walk(item, depth + 1);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
if (!isRecord(value))
|
|
88
|
+
return;
|
|
89
|
+
if (isFileName(value) && typeof value.key === 'string' && typeof value.salt === 'string')
|
|
90
|
+
found.set(value.hash, { hash: value.hash, size: value.size });
|
|
91
|
+
for (const item of Object.values(value))
|
|
92
|
+
walk(item, depth + 1);
|
|
93
|
+
};
|
|
94
|
+
walk(body, 0);
|
|
95
|
+
return [...found.values()];
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=file-id.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-id.js","sourceRoot":"","sources":["../../src/files/file-id.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/** What opens a sealed file: carried in the body, never on the outside */
|
|
2
|
+
export interface FileKey {
|
|
3
|
+
/** 16 random bytes, base64url: RFC 8188's input keying material */
|
|
4
|
+
readonly key: string;
|
|
5
|
+
/** 16 random bytes, base64url */
|
|
6
|
+
readonly salt: string;
|
|
7
|
+
}
|
|
8
|
+
/** Seals a file under a fresh key and salt. `rs` is RFC 8188's record size; files use `CHUNK`. */
|
|
9
|
+
export declare function sealFile(plain: Uint8Array, rs?: number, key?: FileKey): Promise<{
|
|
10
|
+
readonly bytes: Uint8Array;
|
|
11
|
+
readonly key: FileKey;
|
|
12
|
+
}>;
|
|
13
|
+
/**
|
|
14
|
+
* Opens records of a sealed file, one at a time, in any order: what a reader
|
|
15
|
+
* seeking in a video needs. Throws for a record that is not that one, whole.
|
|
16
|
+
*/
|
|
17
|
+
export declare function fileOpener(key: FileKey): (record: Uint8Array, index: number, last: boolean) => Promise<Uint8Array>;
|
|
18
|
+
/** Opens a whole sealed file */
|
|
19
|
+
export declare function openFile(bytes: Uint8Array, key: FileKey, rs?: number): Promise<Uint8Array>;
|
|
20
|
+
//# sourceMappingURL=seal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"seal.d.ts","sourceRoot":"","sources":["../../src/files/seal.ts"],"names":[],"mappings":"AAWA,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAoCD,kGAAkG;AAClG,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,UAAU,EACjB,EAAE,GAAE,MAAc,EAClB,GAAG,GAAE,OAGJ,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAehE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,OAAO,GACX,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAa3E;AAED,gCAAgC;AAChC,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAE,MAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAOvG"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A file's bytes, sealed: the records of RFC 8188's `aes128gcm` content
|
|
3
|
+
* coding, without its header (spec 05 §16.6). The key and salt it would carry
|
|
4
|
+
* are in the body instead, so records line up with chunks: record `i` is
|
|
5
|
+
* chunk `i`. Every file is sealed, in a public space too, under a key of its
|
|
6
|
+
* own.
|
|
7
|
+
*/
|
|
8
|
+
import { CHUNK } from './file-id.js';
|
|
9
|
+
import { bufferSource } from '../utils/guards.js';
|
|
10
|
+
import { base64UrlDecode, base64UrlEncode, concatBytes, utf8Encode } from '../utils/encoding.js';
|
|
11
|
+
const subtle = () => globalThis.crypto.subtle;
|
|
12
|
+
/** RFC 8188 §2.2 and §2.3: the content-encryption key and the base nonce, by HKDF-SHA-256 */
|
|
13
|
+
async function derive(key) {
|
|
14
|
+
const ikm = await subtle().importKey('raw', bufferSource(base64UrlDecode(key.key)), 'HKDF', false, [
|
|
15
|
+
'deriveBits',
|
|
16
|
+
]);
|
|
17
|
+
const salt = bufferSource(base64UrlDecode(key.salt));
|
|
18
|
+
const bits = (info, length) => subtle().deriveBits({ name: 'HKDF', hash: 'SHA-256', salt, info: utf8Encode(info) }, ikm, length);
|
|
19
|
+
const cek = await subtle().importKey('raw', await bits('Content-Encoding: aes128gcm\0', 128), 'AES-GCM', false, ['encrypt', 'decrypt']);
|
|
20
|
+
return { cek, nonce: new Uint8Array(await bits('Content-Encoding: nonce\0', 96)) };
|
|
21
|
+
}
|
|
22
|
+
/** The nonce of record `index`: the base nonce XOR the index, big-endian */
|
|
23
|
+
function nonceFor(base, index) {
|
|
24
|
+
const nonce = new Uint8Array(base);
|
|
25
|
+
let rest = index;
|
|
26
|
+
for (let i = nonce.length - 1; i >= 0 && rest > 0; i--) {
|
|
27
|
+
nonce[i] ^= rest & 0xff;
|
|
28
|
+
rest = Math.floor(rest / 256);
|
|
29
|
+
}
|
|
30
|
+
return nonce;
|
|
31
|
+
}
|
|
32
|
+
/** Plaintext bytes in a full record: the record, less the tag and the delimiter */
|
|
33
|
+
const plainPerRecord = (rs) => rs - 17;
|
|
34
|
+
/** Seals a file under a fresh key and salt. `rs` is RFC 8188's record size; files use `CHUNK`. */
|
|
35
|
+
export async function sealFile(plain, rs = CHUNK, key = {
|
|
36
|
+
key: base64UrlEncode(globalThis.crypto.getRandomValues(new Uint8Array(16))),
|
|
37
|
+
salt: base64UrlEncode(globalThis.crypto.getRandomValues(new Uint8Array(16))),
|
|
38
|
+
}) {
|
|
39
|
+
const { cek, nonce } = await derive(key);
|
|
40
|
+
const per = plainPerRecord(rs);
|
|
41
|
+
const count = Math.max(1, Math.ceil(plain.length / per));
|
|
42
|
+
const records = [];
|
|
43
|
+
for (let i = 0; i < count; i++) {
|
|
44
|
+
const last = i === count - 1;
|
|
45
|
+
const piece = concatBytes(plain.subarray(i * per, (i + 1) * per), new Uint8Array([last ? 2 : 1]));
|
|
46
|
+
records.push(new Uint8Array(await subtle().encrypt({ name: 'AES-GCM', iv: nonceFor(nonce, i) }, cek, bufferSource(piece))));
|
|
47
|
+
}
|
|
48
|
+
return { bytes: concatBytes(...records), key };
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Opens records of a sealed file, one at a time, in any order: what a reader
|
|
52
|
+
* seeking in a video needs. Throws for a record that is not that one, whole.
|
|
53
|
+
*/
|
|
54
|
+
export function fileOpener(key) {
|
|
55
|
+
const derived = derive(key);
|
|
56
|
+
return async (record, index, last) => {
|
|
57
|
+
const { cek, nonce } = await derived;
|
|
58
|
+
const piece = new Uint8Array(await subtle().decrypt({ name: 'AES-GCM', iv: nonceFor(nonce, index) }, cek, bufferSource(record)));
|
|
59
|
+
// The delimiter: 2 on the last record, 1 on every other, with only zeros (padding) after it.
|
|
60
|
+
let end = piece.length - 1;
|
|
61
|
+
while (end >= 0 && piece[end] === 0)
|
|
62
|
+
end--;
|
|
63
|
+
if (end < 0 || piece[end] !== (last ? 2 : 1))
|
|
64
|
+
throw new Error('Not this file’s record');
|
|
65
|
+
return piece.subarray(0, end);
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
/** Opens a whole sealed file */
|
|
69
|
+
export async function openFile(bytes, key, rs = CHUNK) {
|
|
70
|
+
const open = fileOpener(key);
|
|
71
|
+
const count = Math.max(1, Math.ceil(bytes.length / rs));
|
|
72
|
+
const pieces = [];
|
|
73
|
+
for (let i = 0; i < count; i++)
|
|
74
|
+
pieces.push(await open(bytes.subarray(i * rs, (i + 1) * rs), i, i === count - 1));
|
|
75
|
+
return concatBytes(...pieces);
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=seal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"seal.js","sourceRoot":"","sources":["../../src/files/seal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A space's files on this node (spec 05 §16.6): kept as entries in the
|
|
3
|
+
* space's own store, fetched from peers or mirrors chunk by chunk and checked
|
|
4
|
+
* as they come, served to peers, and dropped with the bodies that name them.
|
|
5
|
+
*
|
|
6
|
+
* ```
|
|
7
|
+
* f/<id>/list the chunk list
|
|
8
|
+
* f/<id>/<n> chunk n
|
|
9
|
+
* f/<id>/own added here and not yet named: the time it was added
|
|
10
|
+
* ```
|
|
11
|
+
*/
|
|
12
|
+
import type { StorageAdapter, Version } from '../types.js';
|
|
13
|
+
import type { StorageProvider } from '../storage/storage-provider.js';
|
|
14
|
+
import type { BlobStore } from '../storage/blob-store.js';
|
|
15
|
+
import type { SyncMessageBody } from '../sync/sync-messages.js';
|
|
16
|
+
import { type FileName } from './file-id.js';
|
|
17
|
+
import { type FileKey } from './seal.js';
|
|
18
|
+
/** What `addFile` gives back: what names the file on a version, and what opens it, for the body */
|
|
19
|
+
export type SealedFile = FileName & FileKey;
|
|
20
|
+
/** A mirror a space's files are kept in, as its store writer */
|
|
21
|
+
export interface FileMirror {
|
|
22
|
+
readonly store: BlobStore;
|
|
23
|
+
readonly writer: string;
|
|
24
|
+
}
|
|
25
|
+
export interface SpaceFilesConfig {
|
|
26
|
+
readonly space: string;
|
|
27
|
+
readonly adapter: StorageAdapter;
|
|
28
|
+
readonly storage: StorageProvider;
|
|
29
|
+
/** Sends a sync message to a peer */
|
|
30
|
+
readonly send: (peer: string, message: SyncMessageBody) => void;
|
|
31
|
+
/** The peers connected now */
|
|
32
|
+
readonly peers: () => ReadonlyArray<string>;
|
|
33
|
+
/** Mirrors the space is kept in */
|
|
34
|
+
readonly mirrors?: () => ReadonlyArray<FileMirror>;
|
|
35
|
+
/** Whether a version stands: a version that doesn't, though kept whole, keeps no files here */
|
|
36
|
+
readonly stands?: (version: Version) => Promise<boolean>;
|
|
37
|
+
}
|
|
38
|
+
export type SpaceFiles = ReturnType<typeof createSpaceFiles>;
|
|
39
|
+
export declare function createSpaceFiles(config: SpaceFilesConfig): Readonly<{
|
|
40
|
+
add: (plain: Uint8Array) => Promise<SealedFile>;
|
|
41
|
+
read: (file: FileName) => Promise<Uint8Array>;
|
|
42
|
+
/** Opens a file a body refers to */
|
|
43
|
+
open: (ref: SealedFile) => Promise<Uint8Array>;
|
|
44
|
+
onMessage: (peer: string, message: unknown) => Promise<void>;
|
|
45
|
+
/** Something changed in the store: which files are named is worked out again */
|
|
46
|
+
changed(): void;
|
|
47
|
+
tidy: () => Promise<void>;
|
|
48
|
+
fetchAll: () => Promise<void>;
|
|
49
|
+
close(): void;
|
|
50
|
+
}>;
|
|
51
|
+
//# sourceMappingURL=space-files.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"space-files.d.ts","sourceRoot":"","sources":["../../src/files/space-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAUL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAI7D,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAChE,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IACnD,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAsCD,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;iBAoF7B,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC;iBAuJhC,QAAQ,KAAG,OAAO,CAAC,UAAU,CAAC;IA0LtD,oCAAoC;gBAClB,UAAU,KAAG,OAAO,CAAC,UAAU,CAAC;sBAxErB,MAAM,WAAW,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;IA0ErE,gFAAgF;;gBAhE3D,OAAO,CAAC,IAAI,CAAC;oBAqCT,OAAO,CAAC,IAAI,CAAC;;GAqCzC"}
|