@agentshouse/mdruntime 0.1.0-cebcd51f70ed1 → 0.1.0-cede5a74284be

package/dist/store.js

@@ -1,9 +1,10 @@
-import { sameChange } from './overlay.js';
+import { sameBinary, sameChange } from './overlay.js';
 const DATABASE = 'mdruntime';
+const AUTHORED = 'mdruntime-authored';
 const ROOMS = 'rooms';
 const DOCUMENTS = 'documents';
-const BINARY_TARGETS = 'binaryTargets';
-const ATTACHMENTS = 'attachments';
+const BINARY_FILES = 'binaryFiles';
+const TRANSFERS = 'transfers';
 const PENDING_CHANGES = 'pendingChanges';
 const DECLARATIONS = 'declarations';
 const ROOM_DRAFTS = 'roomDrafts';
@@ -11,8 +12,21 @@ const PRESENTATION = 'presentation';
 const CONVERSATIONS = 'conversations';
 const MESSAGES = 'messages';
 const CHAT_DRAFTS = 'chatDrafts';
+const QUEUES = 'queues';
+const FACTS = 'facts';
 const CURRENT = 'current';
-const SCHEMA = 20;
+const MEMBER = 'member';
+const GENERATION = 'generation';
+export const STORE_SCHEMA = 23;
+export const AUTHORED_SCHEMA = 1;
+const AUTHORED_STORES = [
+    [QUEUES, { keyPath: 'locator' }],
+    [PENDING_CHANGES, { keyPath: ['locator', 'id'] }],
+    [ROOM_DRAFTS, { keyPath: ['locator', 'path'] }],
+    [CHAT_DRAFTS, { keyPath: 'conversation' }],
+    [FACTS, undefined],
+];
+const READ_BATCH = 256;
 function settled(request) {
     return new Promise((resolve, reject) => {
         request.onsuccess = () => resolve(request.result);
@@ -28,7 +42,6 @@ function completed(transaction) {
 }
 const EMPTY_DECLARATIONS = {
     lastCompleted: null,
-    generation: null,
     providerLimits: [],
     capabilities: [],
 };
@@ -56,9 +69,102 @@ function amendPending(database, locator, id, amendment) {
     };
     return completed(transaction);
 }
-function roomRecord(record, queue) {
-    const { documents, binaryTargets, revisions, changes, written, attachments, ...room } = record;
-    return { ...room, order: queue.map((batch) => batch.id) };
+function roomRecord(record) {
+    const { documents, binaries, revisions, changes, written, ...room } = record;
+    return room;
+}
+function chatDraftRecord(record) {
+    return { ...record, revision: record.revision ?? '' };
+}
+function underTransfer(locator, transfer, after) {
+    return after === undefined
+        ? IDBKeyRange.bound([locator, transfer], [locator, transfer, []])
+        : IDBKeyRange.bound([locator, transfer, after], [locator, transfer, []], true);
+}
+function underRoom(locator) {
+    return IDBKeyRange.bound([locator], [locator, []]);
+}
+async function readTransfer(store, locator, transfer, receive) {
+    let range = underTransfer(locator, transfer);
+    for (;;) {
+        const batch = await settled(store.getAll(range, READ_BATCH));
+        for (const record of batch)
+            receive(record);
+        if (batch.length < READ_BATCH)
+            return;
+        range = underTransfer(locator, transfer, batch[batch.length - 1].path);
+    }
+}
+function emptyLayer() {
+    return { documents: {}, binaries: {}, revisions: {}, changes: {}, written: {} };
+}
+async function readLayer(transaction, locator, transfer) {
+    const layer = emptyLayer();
+    const head = (held) => {
+        if (held.revision !== null)
+            layer.revisions[held.path] = held.revision;
+        if (held.change !== null)
+            layer.changes[held.path] = held.change;
+    };
+    await readTransfer(transaction.objectStore(DOCUMENTS), locator, transfer, (document) => {
+        layer.documents[document.path] = document.content;
+        if (document.written !== null)
+            layer.written[document.path] = document.written;
+        head(document);
+    });
+    await readTransfer(transaction.objectStore(BINARY_FILES), locator, transfer, (file) => {
+        layer.binaries[file.path] = file.binary;
+        head(file);
+    });
+    return layer;
+}
+function documentRecord(locator, transfer, layer, path) {
+    return {
+        locator,
+        transfer,
+        path,
+        content: layer.documents[path],
+        revision: layer.revisions[path] ?? null,
+        change: layer.changes[path] ?? null,
+        written: layer.written[path] ?? null,
+    };
+}
+function binaryFileRecord(locator, transfer, layer, path) {
+    return {
+        locator,
+        transfer,
+        path,
+        revision: layer.revisions[path] ?? null,
+        change: layer.changes[path] ?? null,
+        binary: layer.binaries[path],
+    };
+}
+function writeLayer(transaction, locator, transfer, next, base) {
+    const documents = transaction.objectStore(DOCUMENTS);
+    for (const path of Object.keys(base?.documents ?? {})) {
+        if (next.documents[path] === undefined)
+            documents.delete([locator, transfer, path]);
+    }
+    for (const [path, content] of Object.entries(next.documents)) {
+        if (base?.documents[path] === content &&
+            base.revisions[path] === next.revisions[path] &&
+            base.written[path] === next.written[path] &&
+            sameChange(base.changes[path], next.changes[path]))
+            continue;
+        documents.put(documentRecord(locator, transfer, next, path));
+    }
+    const files = transaction.objectStore(BINARY_FILES);
+    for (const path of Object.keys(base?.binaries ?? {})) {
+        if (next.binaries[path] === undefined)
+            files.delete([locator, transfer, path]);
+    }
+    for (const path of Object.keys(next.binaries)) {
+        if (!sameBinary(base?.binaries[path], next.binaries[path]) ||
+            base?.revisions[path] !== next.revisions[path] ||
+            !sameChange(base?.changes[path], next.changes[path])) {
+            files.put(binaryFileRecord(locator, transfer, next, path));
+        }
+    }
 }
 function removeRoomEntries(store, locator) {
     const keys = store.getAllKeys();
@@ -69,177 +175,121 @@ function removeRoomEntries(store, locator) {
         }
     };
 }
-export function removeRuntimeStore() {
+function removeDatabase(name) {
     return new Promise((resolve, reject) => {
-        const removal = indexedDB.deleteDatabase(DATABASE);
+        const removal = indexedDB.deleteDatabase(name);
         removal.onsuccess = () => resolve();
         removal.onerror = () => reject(removal.error);
     });
 }
-export async function openRuntimeStore() {
-    const opening = indexedDB.open(DATABASE, SCHEMA);
+export async function removeRuntimeStore() {
+    await Promise.all([removeDatabase(DATABASE), removeDatabase(AUTHORED)]);
+}
+function openReplica() {
+    const opening = indexedDB.open(DATABASE, STORE_SCHEMA);
     opening.onupgradeneeded = () => {
         const database = opening.result;
         for (const name of [...database.objectStoreNames])
             database.deleteObjectStore(name);
         database.createObjectStore(ROOMS, { keyPath: 'locator' });
-        database.createObjectStore(DOCUMENTS, { keyPath: ['locator', 'path'] });
-        database.createObjectStore(BINARY_TARGETS, { keyPath: ['locator', 'path'] });
-        database.createObjectStore(ATTACHMENTS, { keyPath: ['locator', 'reference'] });
-        database.createObjectStore(PENDING_CHANGES, { keyPath: ['locator', 'id'] });
+        database.createObjectStore(DOCUMENTS, { keyPath: ['locator', 'transfer', 'path'] });
+        database.createObjectStore(BINARY_FILES, { keyPath: ['locator', 'transfer', 'path'] });
+        database.createObjectStore(TRANSFERS, { keyPath: 'locator' });
         database.createObjectStore(DECLARATIONS);
-        database.createObjectStore(ROOM_DRAFTS, { keyPath: ['locator', 'path'] });
         database.createObjectStore(PRESENTATION, { keyPath: 'app' });
         database.createObjectStore(CONVERSATIONS, { keyPath: 'conversation' });
         const messages = database.createObjectStore(MESSAGES, {
             keyPath: ['conversation', 'identity'],
         });
         messages.createIndex('conversation', 'conversation');
-        database.createObjectStore(CHAT_DRAFTS, { keyPath: 'conversation' });
     };
-    const database = await settled(opening);
+    return settled(opening);
+}
+function openAuthored() {
+    const opening = indexedDB.open(AUTHORED, AUTHORED_SCHEMA);
+    opening.onupgradeneeded = () => {
+        const database = opening.result;
+        for (const [name, parameters] of AUTHORED_STORES) {
+            if (!database.objectStoreNames.contains(name))
+                database.createObjectStore(name, parameters);
+        }
+    };
+    return settled(opening);
+}
+export async function openRuntimeStore() {
+    const authored = await openAuthored();
+    const database = await openReplica().catch((error) => {
+        authored.close();
+        throw error;
+    });
     return {
         async all() {
-            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_TARGETS, ATTACHMENTS], 'readonly');
-            const [rooms, documents, targets, attachments] = await Promise.all([
-                settled(transaction.objectStore(ROOMS).getAll()),
-                settled(transaction.objectStore(DOCUMENTS).getAll()),
-                settled(transaction.objectStore(BINARY_TARGETS).getAll()),
-                settled(transaction.objectStore(ATTACHMENTS).getAll()),
-            ]);
-            const byRoom = new Map();
-            for (const { order, ...room } of rooms) {
-                byRoom.set(room.locator, {
-                    ...room,
-                    documents: {},
-                    revisions: {},
-                    changes: {},
-                    written: {},
-                    binaryTargets: [],
-                    attachments: [],
-                });
-            }
-            const head = (room, held) => {
-                if (held.revision !== null) {
-                    room.revisions[held.path] = held.revision;
-                }
-                if (held.change !== null) {
-                    room.changes[held.path] = held.change;
-                }
-            };
-            for (const document of documents) {
-                const room = byRoom.get(document.locator);
-                if (room === undefined)
-                    continue;
-                room.documents[document.path] = document.content;
-                if (document.written !== null) {
-                    room.written[document.path] = document.written;
-                }
-                head(room, document);
-            }
-            for (const target of targets) {
-                const room = byRoom.get(target.locator);
-                if (room === undefined)
-                    continue;
-                room.binaryTargets.push(target.path);
-                head(room, target);
-            }
-            for (const { locator, ...attachment } of attachments) {
-                const room = byRoom.get(locator);
-                if (room === undefined)
-                    continue;
-                room.attachments.push(attachment);
-            }
-            return [...byRoom.values()];
-        },
-        async write({ next, previous, queue, previousQueue, saved, roomDrafts, consumedRoomDrafts }) {
-            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_TARGETS, ATTACHMENTS, PENDING_CHANGES, ROOM_DRAFTS], 'readwrite');
-            transaction.objectStore(ROOMS).put(roomRecord(next, queue));
-            const documents = transaction.objectStore(DOCUMENTS);
-            for (const path of Object.keys(previous?.documents ?? {})) {
-                if (next.documents[path] === undefined)
-                    documents.delete([next.locator, path]);
-            }
-            for (const [path, content] of Object.entries(next.documents)) {
-                if (previous?.documents[path] === content &&
-                    previous.revisions[path] === next.revisions[path] &&
-                    previous.written[path] === next.written[path] &&
-                    sameChange(previous.changes[path], next.changes[path]))
-                    continue;
-                documents.put({
-                    locator: next.locator,
-                    path,
-                    content,
-                    revision: next.revisions[path] ?? null,
-                    change: next.changes[path] ?? null,
-                    written: next.written[path] ?? null,
-                });
-            }
-            const targets = transaction.objectStore(BINARY_TARGETS);
-            const beforeTargets = new Set(previous?.binaryTargets ?? []);
-            const afterTargets = new Set(next.binaryTargets);
-            for (const path of beforeTargets) {
-                if (!afterTargets.has(path))
-                    targets.delete([next.locator, path]);
-            }
-            for (const path of afterTargets) {
-                if (!beforeTargets.has(path) ||
-                    previous?.revisions[path] !== next.revisions[path] ||
-                    !sameChange(previous?.changes[path], next.changes[path])) {
-                    targets.put({
-                        locator: next.locator,
-                        path,
-                        revision: next.revisions[path] ?? null,
-                        change: next.changes[path] ?? null,
-                    });
-                }
+            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_FILES], 'readonly');
+            const rooms = await settled(transaction.objectStore(ROOMS).getAll());
+            const records = [];
+            for (const room of rooms) {
+                records.push({ ...room, ...(await readLayer(transaction, room.locator, room.transfer)) });
             }
-            const attachments = transaction.objectStore(ATTACHMENTS);
-            const held = new Map((previous?.attachments ?? []).map((attachment) => [attachment.reference, attachment]));
-            const declared = new Set(next.attachments.map((attachment) => attachment.reference));
-            for (const reference of held.keys()) {
-                if (!declared.has(reference))
-                    attachments.delete([next.locator, reference]);
-            }
-            for (const attachment of next.attachments) {
-                if (held.get(attachment.reference) === attachment)
-                    continue;
-                attachments.put({ ...attachment, locator: next.locator });
-            }
-            if (previousQueue !== undefined) {
-                const pending = transaction.objectStore(PENDING_CHANGES);
-                const before = new Set(previousQueue.map((batch) => batch.id));
+            return records;
+        },
+        async keepAuthored({ locator, queue, saved, roomDrafts, consumedRoomDrafts }) {
+            const transaction = authored.transaction([QUEUES, PENDING_CHANGES, ROOM_DRAFTS], 'readwrite');
+            const order = transaction.objectStore(QUEUES);
+            const pending = transaction.objectStore(PENDING_CHANGES);
+            const held = order.get(locator);
+            held.onsuccess = () => {
+                const before = new Set(held.result?.order ?? []);
                 const after = new Set(queue.map((batch) => batch.id));
+                if (queue.length === 0)
+                    order.delete(locator);
+                else
+                    order.put({ locator, order: [...after] });
                 for (const id of before) {
                     if (!after.has(id))
-                        pending.delete([next.locator, id]);
+                        pending.delete([locator, id]);
                 }
                 for (const batch of queue) {
                     if (!before.has(batch.id)) {
                         pending.put({
-                            locator: next.locator,
+                            locator,
                             id: batch.id,
                             batch,
-                            drafts: saved ?? [],
+                            drafts: saved?.get(batch.id) ?? [],
                             submission: { state: 'waiting' },
                             lost: false,
                         });
                     }
                 }
-            }
+            };
             const draftStore = transaction.objectStore(ROOM_DRAFTS);
             for (const path of consumedRoomDrafts ?? [])
-                draftStore.delete([next.locator, path]);
+                draftStore.delete([locator, path]);
             for (const record of roomDrafts ?? [])
                 draftStore.put(record);
             await completed(transaction);
         },
+        async write({ next, previous, stored }) {
+            if (next === previous)
+                return;
+            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_FILES, TRANSFERS], 'readwrite');
+            transaction.objectStore(ROOMS).put(roomRecord(next));
+            const moved = previous?.transfer !== next.transfer;
+            if (moved && previous !== null) {
+                const range = underTransfer(previous.locator, previous.transfer);
+                transaction.objectStore(DOCUMENTS).delete(range);
+                transaction.objectStore(BINARY_FILES).delete(range);
+            }
+            if (moved)
+                transaction.objectStore(TRANSFERS).delete(next.locator);
+            writeLayer(transaction, next.locator, next.transfer, next, moved ? (stored ?? null) : previous);
+            await completed(transaction);
+        },
         async revokeModels(records) {
             const transaction = database.transaction(ROOMS, 'readwrite');
             const rooms = transaction.objectStore(ROOMS);
             const revoked = { status: 'unavailable', reason: 'revoked' };
-            for (const { record, queue } of records) {
-                rooms.put(roomRecord({ ...record, model: revoked, selectionModel: revoked }, queue));
+            for (const record of records) {
+                rooms.put(roomRecord({ ...record, model: revoked, selectionModel: revoked }));
             }
             await completed(transaction);
         },
@@ -262,35 +312,45 @@ export async function openRuntimeStore() {
                 capabilities,
             }));
         },
+        async member() {
+            const transaction = database.transaction(DECLARATIONS, 'readonly');
+            const held = await settled(transaction.objectStore(DECLARATIONS).get(MEMBER));
+            return held ?? null;
+        },
+        async keepMember(member) {
+            const transaction = database.transaction(DECLARATIONS, 'readwrite');
+            transaction.objectStore(DECLARATIONS).put(member, MEMBER);
+            await completed(transaction);
+        },
         async queues() {
-            const transaction = database.transaction([ROOMS, PENDING_CHANGES], 'readonly');
-            const [rooms, pending] = await Promise.all([
-                settled(transaction.objectStore(ROOMS).getAll()),
+            const transaction = authored.transaction([QUEUES, PENDING_CHANGES], 'readonly');
+            const [queues, pending] = await Promise.all([
+                settled(transaction.objectStore(QUEUES).getAll()),
                 settled(transaction.objectStore(PENDING_CHANGES).getAll()),
             ]);
             const byId = new Map(pending.map((record) => [`${record.locator}\0${record.id}`, record]));
-            return rooms.map((room) => ({
-                locator: room.locator,
-                pending: room.order.map((id) => {
-                    const record = byId.get(`${room.locator}\0${id}`);
+            return queues.map((queue) => ({
+                locator: queue.locator,
+                pending: queue.order.map((id) => {
+                    const record = byId.get(`${queue.locator}\0${id}`);
                     if (record === undefined)
-                        throw new Error(`Missing Pending Change ${room.locator}/${id}`);
+                        throw new Error(`Missing Pending Change ${queue.locator}/${id}`);
                     const { batch, drafts, submission, lost, upload, accepted } = record;
                     return { batch, state: { drafts, submission, lost, upload, accepted } };
                 }),
             }));
         },
         submit(locator, id, submission, lost) {
-            return amendPending(database, locator, id, { submission, lost });
+            return amendPending(authored, locator, id, { submission, lost });
         },
         accept(locator, id, roomVersion) {
-            return amendPending(database, locator, id, { accepted: roomVersion });
+            return amendPending(authored, locator, id, { accepted: roomVersion });
         },
         keepUpload(locator, id, upload) {
-            return amendPending(database, locator, id, { upload });
+            return amendPending(authored, locator, id, { upload });
         },
         async roomDrafts() {
-            const transaction = database.transaction(ROOM_DRAFTS, 'readonly');
+            const transaction = authored.transaction(ROOM_DRAFTS, 'readonly');
             return settled(transaction.objectStore(ROOM_DRAFTS).getAll());
         },
         async presentation() {
@@ -320,7 +380,12 @@ export async function openRuntimeStore() {
             return [...held.values()];
         },
         async keepMessages({ conversation, messages, read, sealed }) {
-            const transaction = database.transaction([CONVERSATIONS, MESSAGES, CHAT_DRAFTS], 'readwrite');
+            if (sealed === true) {
+                const sealing = authored.transaction(CHAT_DRAFTS, 'readwrite');
+                sealing.objectStore(CHAT_DRAFTS).delete(conversation);
+                await completed(sealing);
+            }
+            const transaction = database.transaction([CONVERSATIONS, MESSAGES], 'readwrite');
             const stored = transaction.objectStore(MESSAGES);
             for (const message of messages) {
                 stored.put({ ...message, conversation });
@@ -330,16 +395,17 @@ export async function openRuntimeStore() {
                     .objectStore(CONVERSATIONS)
                     .put({ conversation, read });
             }
-            if (sealed === true)
-                transaction.objectStore(CHAT_DRAFTS).delete(conversation);
             await completed(transaction);
         },
         async dropConversations(conversations) {
-            const transaction = database.transaction([CONVERSATIONS, MESSAGES, CHAT_DRAFTS], 'readwrite');
+            const drafts = authored.transaction(CHAT_DRAFTS, 'readwrite');
+            for (const conversation of conversations)
+                drafts.objectStore(CHAT_DRAFTS).delete(conversation);
+            await completed(drafts);
+            const transaction = database.transaction([CONVERSATIONS, MESSAGES], 'readwrite');
             const messages = transaction.objectStore(MESSAGES);
             for (const conversation of conversations) {
                 transaction.objectStore(CONVERSATIONS).delete(conversation);
-                transaction.objectStore(CHAT_DRAFTS).delete(conversation);
                 const keys = messages.index('conversation').getAllKeys(conversation);
                 keys.onsuccess = () => {
                     for (const key of keys.result)
@@ -349,46 +415,89 @@ export async function openRuntimeStore() {
             await completed(transaction);
         },
         async chatDrafts() {
-            const transaction = database.transaction(CHAT_DRAFTS, 'readonly');
-            return settled(transaction.objectStore(CHAT_DRAFTS).getAll());
+            const transaction = authored.transaction(CHAT_DRAFTS, 'readonly');
+            const held = await settled(transaction.objectStore(CHAT_DRAFTS).getAll());
+            return held.map(chatDraftRecord);
         },
         async keepChatDraft(record) {
-            const transaction = database.transaction(CHAT_DRAFTS, 'readwrite');
+            const transaction = authored.transaction(CHAT_DRAFTS, 'readwrite');
             transaction.objectStore(CHAT_DRAFTS).put(record);
             await completed(transaction);
         },
         async dropChatDraft(conversation) {
-            const transaction = database.transaction(CHAT_DRAFTS, 'readwrite');
+            const transaction = authored.transaction(CHAT_DRAFTS, 'readwrite');
             transaction.objectStore(CHAT_DRAFTS).delete(conversation);
             await completed(transaction);
         },
         async keepRoomDraft(record) {
-            const transaction = database.transaction(ROOM_DRAFTS, 'readwrite');
+            const transaction = authored.transaction(ROOM_DRAFTS, 'readwrite');
             transaction.objectStore(ROOM_DRAFTS).put(record);
             await completed(transaction);
         },
         async discardRoomDraft(locator, path) {
-            const transaction = database.transaction(ROOM_DRAFTS, 'readwrite');
+            const transaction = authored.transaction(ROOM_DRAFTS, 'readwrite');
             transaction.objectStore(ROOM_DRAFTS).delete([locator, path]);
             await completed(transaction);
         },
         async dropRooms(locators) {
-            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_TARGETS, ATTACHMENTS, PENDING_CHANGES, ROOM_DRAFTS], 'readwrite');
+            const work = authored.transaction([QUEUES, PENDING_CHANGES, ROOM_DRAFTS], 'readwrite');
             for (const locator of locators) {
-                transaction.objectStore(ROOMS).delete(locator);
-                for (const name of [DOCUMENTS, BINARY_TARGETS, ATTACHMENTS, PENDING_CHANGES, ROOM_DRAFTS]) {
-                    removeRoomEntries(transaction.objectStore(name), locator);
+                work.objectStore(QUEUES).delete(locator);
+                for (const name of [PENDING_CHANGES, ROOM_DRAFTS]) {
+                    removeRoomEntries(work.objectStore(name), locator);
                 }
             }
+            await completed(work);
+            const transaction = database.transaction([ROOMS, DOCUMENTS, BINARY_FILES, TRANSFERS], 'readwrite');
+            for (const locator of locators) {
+                transaction.objectStore(ROOMS).delete(locator);
+                transaction.objectStore(TRANSFERS).delete(locator);
+                transaction.objectStore(DOCUMENTS).delete(underRoom(locator));
+                transaction.objectStore(BINARY_FILES).delete(underRoom(locator));
+            }
+            await completed(transaction);
+        },
+        async transfers() {
+            const transaction = database.transaction(TRANSFERS, 'readonly');
+            return settled(transaction.objectStore(TRANSFERS).getAll());
+        },
+        staged(record) {
+            const transaction = database.transaction([DOCUMENTS, BINARY_FILES], 'readonly');
+            return readLayer(transaction, record.locator, record.transfer);
+        },
+        async stage(record, page) {
+            const transaction = database.transaction([TRANSFERS, DOCUMENTS, BINARY_FILES], 'readwrite');
+            writeLayer(transaction, record.locator, record.transfer, page, null);
+            transaction.objectStore(TRANSFERS).put(record);
+            await completed(transaction);
+        },
+        async abandon(locator) {
+            const transaction = database.transaction([TRANSFERS, DOCUMENTS, BINARY_FILES], 'readwrite');
+            const transfers = transaction.objectStore(TRANSFERS);
+            const held = transfers.get(locator);
+            held.onsuccess = () => {
+                const record = held.result;
+                if (record === undefined)
+                    return;
+                transfers.delete(locator);
+                const range = underTransfer(locator, record.transfer);
+                transaction.objectStore(DOCUMENTS).delete(range);
+                transaction.objectStore(BINARY_FILES).delete(range);
+            };
             await completed(transaction);
         },
         async generation() {
-            return (await declaration(database)).generation;
+            const transaction = authored.transaction(FACTS, 'readonly');
+            const held = await settled(transaction.objectStore(FACTS).get(GENERATION));
+            return held ?? null;
         },
-        rememberGeneration(value) {
-            return updateDeclaration(database, (record) => ({ ...record, generation: value }));
+        async rememberGeneration(value) {
+            const transaction = authored.transaction(FACTS, 'readwrite');
+            transaction.objectStore(FACTS).put(value, GENERATION);
+            await completed(transaction);
         },
         close() {
+            authored.close();
             database.close();
         },
     };

package/dist/wire.d.ts

@@ -1,4 +1,5 @@
 import type { ConnectionRefusal } from './connection.js';
+import type { Described } from './failure.js';
 export type RuntimePort = {
     postMessage(message: unknown): void;
     addEventListener(type: 'message' | 'close', listener: (event: {
@@ -14,6 +15,8 @@ declare const MEMBERS: {
     readonly types: 'within';
     readonly save: 'within';
     readonly history: 'within';
+    readonly 'binaryFile.read': 'within';
+    readonly 'binaryFile.readReference': 'within';
     readonly call: 'actions';
     readonly reached: 'within';
     readonly log: 'whole';
@@ -44,12 +47,14 @@ declare const TOPICS: {
     readonly 'deployment-facts': 'runtime';
     readonly 'sync-status': 'within';
     readonly 'service-mode': 'runtime';
+    readonly member: 'runtime';
     readonly query: 'within';
     readonly queue: 'within';
     readonly 'room-drafts': 'within';
     readonly presentation: 'app';
     readonly conversation: 'within';
     readonly conversations: 'within';
+    readonly agents: 'within';
 };
 export declare const WIRE_REACH: {
     readonly members: Readonly<Record<string, WireReach>>;
@@ -77,11 +82,10 @@ export type WireAnswer = {
     kind: 'result';
     id: number;
     value: unknown;
-} | {
+} | ({
     kind: 'failure';
     id: number;
-    message: string;
-} | {
+} & Described) | {
     kind: 'event';
     id: number;
     value: unknown;

package/dist/wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}