@agentshouse/mdruntime 0.1.0-c8e110144a30a → 0.1.0-c8f07dbee1c62

package/dist/shown.js

@@ -0,0 +1,294 @@
+import { listingNow, list, patchedListing, shownRooms } from './listing.js';
+import { emitPresentation, publishRoomDrafts } from './room-drafts.js';
+import { same } from './status.js';
+export const ROOMS_TOPIC = 'rooms';
+export const STATUS_TOPIC = 'sync-status';
+export const REFUSAL_TOPIC = 'connection-refusal';
+export const STORAGE_LOSS_TOPIC = 'storage-loss';
+export const SERVICE_MODE_TOPIC = 'service-mode';
+export const MEMBER_TOPIC = 'member';
+export const AUTHORITY_TOPIC = 'authority-changes';
+export const LOCKS_TOPIC = 'locks';
+export const queueTopic = (locator) => `queue\u0000${locator}`;
+async function attended({ store, localSaves }) {
+    const isFenced = store.fences.has;
+    const held = await (await store.open()).status();
+    const attentionRequired = held.returned.flatMap((record) => record.returned === null || isFenced(record.locator)
+        ? []
+        : [{ room: record.locator, path: record.path, returned: structuredClone(record.returned) }]);
+    attentionRequired.sort((left, right) => {
+        if (left.room !== right.room)
+            return left.room < right.room ? -1 : 1;
+        if (left.path !== right.path)
+            return left.path < right.path ? -1 : 1;
+        return 0;
+    });
+    const changed = new Map();
+    if (!localSaves) {
+        for (const change of held.unsent) {
+            if (!isFenced(change.room))
+                changed.set(`${change.room}\u0000${change.path}`, change);
+        }
+    }
+    const unsent = [...changed]
+        .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+        .map(([, change]) => change);
+    return {
+        queued: !localSaves && held.queued.some((locator) => !isFenced(locator)),
+        lastCompleted: held.lastCompleted,
+        attentionRequired,
+        unsent,
+        reset: held.resets.reduce((earliest, { locator, reset }) => isFenced(locator) || (earliest !== null && earliest <= reset) ? earliest : reset, null),
+    };
+}
+async function queuedWork({ store, localSaves }) {
+    const held = await (await store.open()).queued();
+    return !localSaves && held.some((locator) => !store.fences.has(locator));
+}
+export function recoverReads({ liveQueries, figures }) {
+    liveQueries.recover();
+    figures.recover();
+}
+export function emitRooms(runtime, changed) {
+    recoverReads(runtime);
+    runtime.store.readiness.queue();
+    return changed === undefined
+        ? publishRooms(runtime, 'all')
+        : publishRooms(runtime, 'changed', changed);
+}
+export function emitKnownRooms(runtime) {
+    runtime.conversations.learned();
+    if (runtime.store.watching(ROOMS_TOPIC, 'waiting').length === 0)
+        return;
+    void publishRooms(runtime, 'known');
+}
+function roomsOwedWith(held, mode, touched) {
+    if (held === undefined) {
+        return {
+            all: mode === 'all',
+            changed: new Set(mode === 'changed' ? touched : []),
+            counted: new Set(mode === 'changed' ? [] : touched),
+        };
+    }
+    held.all ||= mode === 'all';
+    for (const locator of touched) {
+        (mode === 'changed' ? held.changed : held.counted).add(locator);
+    }
+    return held;
+}
+async function deliverRooms(runtime, owed) {
+    const { store, socket } = runtime;
+    const waiting = () => store.watching(ROOMS_TOPIC, 'waiting');
+    if (socket.closed() || store.watching(ROOMS_TOPIC).length === 0)
+        return;
+    const patched = owed.all || owed.changed.size === 0 || waiting().length > 0
+        ? null
+        : await patchedListing(runtime, new Set([...owed.changed, ...owed.counted]));
+    if (patched === null && owed.changed.size > 0)
+        owed.all = true;
+    if (patched === null && !owed.all && owed.counted.size > 0) {
+        const held = await store.covering().catch(() => null);
+        if (held === null)
+            return;
+        const { roomsShown } = store.device.now();
+        owed.all = [...owed.counted].some((locator) => held.rooms.has(locator) &&
+            roomsShown?.get(locator)?.documents !== held.rooms.get(locator).documents);
+        if (owed.all) {
+            recoverReads(runtime);
+            store.readiness.queue();
+        }
+        else if (waiting().length === 0)
+            return;
+    }
+    const listing = patched ?? (await listingNow(runtime).catch(() => null));
+    if (listing === null || socket.closed())
+        return;
+    const value = shownRooms(runtime, listing);
+    const { roomsListed, refusal, moving } = socket.session.now();
+    const joining = waiting().length > 0 &&
+        (roomsListed || listing.size > 0 || refusal !== null || moving.providerUnreachable);
+    if (!owed.all && patched === null && !joining)
+        return;
+    const { roomsShown } = store.device.now();
+    const moved = owed.all ||
+        patched !== null ||
+        (roomsShown !== null &&
+            JSON.stringify(shownRooms(runtime, roomsShown)) !== JSON.stringify(value));
+    if (moved)
+        for (const watcher of store.watching(ROOMS_TOPIC, 'ready'))
+            watcher.answer(value);
+    if (joining)
+        for (const watcher of waiting())
+            watcher.answer(value);
+    store.device.set({
+        roomsShown: store.watching(ROOMS_TOPIC, 'ready').length === 0 ? null : listing,
+    });
+}
+function publishRooms(runtime, mode, touched = []) {
+    if (runtime.socket.closed())
+        return Promise.resolve();
+    return runtime.store.owing(ROOMS_TOPIC, (held) => roomsOwedWith(held, mode, touched), (owed) => deliverRooms(runtime, owed));
+}
+export function emitRefusal(runtime) {
+    const { store, socket } = runtime;
+    store.readiness.queue();
+    store.tell(REFUSAL_TOPIC, socket.session.now().refusal);
+    emitKnownRooms(runtime);
+}
+export function emitStorageLoss({ store }) {
+    store.readiness.queue();
+    store.tell(STORAGE_LOSS_TOPIC, store.device.now().storageLoss);
+}
+export function emitMember({ store }, member) {
+    store.tell(MEMBER_TOPIC, member);
+}
+async function deliverStatus(runtime, owed) {
+    const { store, socket } = runtime;
+    const held = await attended(runtime);
+    if (socket.closed())
+        return;
+    for (const { moving, current } of owed) {
+        const state = moving.resting && held.queued ? 'pending' : moving.state;
+        const next = {
+            state: state === 'synced' && !current ? 'syncing' : state,
+            lastCompleted: held.lastCompleted,
+            providerUnreachable: moving.providerUnreachable,
+            attentionRequired: held.attentionRequired,
+            unsent: held.unsent,
+            reset: held.reset,
+        };
+        if (same(store.device.now().status, next))
+            continue;
+        store.device.set({ status: next });
+        store.tell(STATUS_TOPIC, next);
+    }
+}
+export function show(runtime) {
+    const { store, socket, conversations } = runtime;
+    if (socket.closed())
+        return Promise.resolve();
+    store.readiness.queue();
+    emitKnownRooms(runtime);
+    const moved = { moving: socket.session.now().moving, current: conversations.current() };
+    return store.owing(STATUS_TOPIC, (held) => {
+        if (held === undefined)
+            return [moved];
+        held.push(moved);
+        return held;
+    }, (owed) => deliverStatus(runtime, owed));
+}
+export function moveTo(runtime, next) {
+    if (runtime.socket.closed())
+        return Promise.resolve();
+    runtime.socket.session.set({ moving: next });
+    return show(runtime);
+}
+export function statusShown(runtime) {
+    return moveTo(runtime, runtime.socket.session.now().moving);
+}
+export function transferring({ socket }) {
+    return { ...socket.session.now().moving, state: 'syncing', resting: false };
+}
+export function pendingShown(runtime) {
+    const { socket, localSaves } = runtime;
+    if (!localSaves)
+        socket.session.set({ recorded: false });
+    const { moving } = socket.session.now();
+    return moveTo(runtime, localSaves ? moving : { ...moving, state: 'pending', resting: false });
+}
+function entryOf({ localSaves }, states, batch) {
+    if (localSaves)
+        return Object.freeze({ batch, state: 'local' });
+    const state = states.get(batch.id);
+    return Object.freeze({ batch, ...(state?.submission ?? { state: 'waiting' }) });
+}
+export async function entriesOf(runtime, locator) {
+    const { store } = runtime;
+    if (store.fences.has(locator))
+        return [];
+    const { queue, states } = await store.work(locator);
+    return queue.map((batch) => entryOf(runtime, states, batch));
+}
+function emitQueue(runtime, locator) {
+    const { store, socket } = runtime;
+    const listening = () => store.watching(queueTopic(locator));
+    if (socket.closed() || listening().length === 0)
+        return Promise.resolve();
+    return store.publication(async () => {
+        if (socket.closed() || listening().length === 0)
+            return;
+        const entries = await entriesOf(runtime, locator);
+        if (socket.closed())
+            return;
+        for (const watcher of listening())
+            watcher.answer(entries);
+    });
+}
+export function publishChangeSet(runtime, set) {
+    const { store, liveQueries, figures, conversations } = runtime;
+    liveQueries.touched(set);
+    figures.touched(set);
+    for (const { locator, path } of set.documents) {
+        if (path !== null)
+            store.attached.drop(locator, path);
+    }
+    const shownNow = [];
+    if (set.queues.length > 0 || set.drafts.length > 0)
+        shownNow.push(show(runtime));
+    if (set.rooms.length > 0)
+        shownNow.push(emitRooms(runtime, set.rooms));
+    else if (set.documents.length > 0) {
+        shownNow.push(publishRooms(runtime, 'counted', [...new Set(set.documents.map(({ locator }) => locator))]));
+    }
+    for (const locator of set.queues)
+        shownNow.push(emitQueue(runtime, locator));
+    if (set.drafts.length > 0)
+        shownNow.push(publishRoomDrafts(runtime, false));
+    else if (set.documents.length > 0) {
+        shownNow.push(publishRoomDrafts(runtime, false, set.documents));
+    }
+    for (const app of set.presentations)
+        shownNow.push(emitPresentation(runtime, app));
+    conversations.changed(set);
+    return Promise.all(shownNow).then(() => undefined);
+}
+export function roomUnreadable(runtime, room) {
+    runtime.socket.rooms.stand(room.locator, { unreadable: true });
+    list(runtime, room, false);
+    emitRooms(runtime);
+}
+export async function rest(runtime, progress, live = () => !runtime.socket.closed()) {
+    const { store, socket } = runtime;
+    const { session, lanes, rooms } = socket;
+    if (!live())
+        return;
+    const settled = () => session.now().complete &&
+        lanes.roomWork() === 0 &&
+        !socket.naming() &&
+        rooms.standingWhere(({ stale }) => stale).length === 0;
+    let synced = settled();
+    if (synced && !session.now().recorded) {
+        const queued = await queuedWork(runtime).catch(() => true);
+        if (!live())
+            return;
+        synced = !queued && settled();
+    }
+    if (synced && !session.now().recorded) {
+        const completedAt = new Date().toISOString();
+        try {
+            await (await store.open()).fact('lastCompleted', completedAt);
+            if (!live())
+                return;
+            session.set({ recorded: true });
+        }
+        catch {
+            synced = false;
+        }
+    }
+    const { complete, moving } = session.now();
+    moveTo(runtime, {
+        state: synced && complete && lanes.roomWork() === 0 && !socket.naming() ? 'synced' : 'syncing',
+        providerUnreachable: progress === null ? moving.providerUnreachable : !progress.reachable,
+        resting: true,
+    });
+}

package/dist/socket/admission.d.ts

@@ -0,0 +1,7 @@
+export type Admission = {
+    heldStream(): Promise<() => void>;
+    unqueued(): Promise<void>;
+    queued(text: number): () => void;
+};
+export declare function createAdmission(): Admission;
+//# sourceMappingURL=admission.d.ts.map

package/dist/socket/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/socket/admission.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IACtB,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,eAAe,IAAI,SAAS,CAmC3C"}

package/dist/socket/admission.js

@@ -0,0 +1,39 @@
+const STREAMS_HELD = 4;
+const QUEUED_TEXT = 1 << 23;
+export function createAdmission() {
+    let streamsFree = STREAMS_HELD;
+    let queuedText = 0;
+    const installWaiters = [];
+    function once(release) {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            release();
+            for (const admit of installWaiters.splice(0))
+                admit();
+        };
+    }
+    return {
+        async heldStream() {
+            while (streamsFree === 0)
+                await new Promise((admit) => installWaiters.push(admit));
+            streamsFree -= 1;
+            return once(() => {
+                streamsFree += 1;
+            });
+        },
+        async unqueued() {
+            while (queuedText >= QUEUED_TEXT) {
+                await new Promise((admit) => installWaiters.push(admit));
+            }
+        },
+        queued(text) {
+            queuedText += text;
+            return once(() => {
+                queuedText -= text;
+            });
+        },
+    };
+}

package/dist/socket/answers.d.ts

@@ -0,0 +1,6 @@
+export type Answers = {
+    awaitingAnswer(locator: string): () => void;
+    answered(locator: string): Promise<void> | undefined;
+};
+export declare function createAnswers(): Answers;
+//# sourceMappingURL=answers.d.ts.map

package/dist/socket/answers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../src/socket/answers.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG;IACpB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD,CAAC;AAEF,wBAAgB,aAAa,IAAI,OAAO,CAkBvC"}

package/dist/socket/answers.js

@@ -0,0 +1,20 @@
+export function createAnswers() {
+    const answering = new Map();
+    return {
+        awaitingAnswer(locator) {
+            answering.get(locator)?.release();
+            let release = () => { };
+            const answered = new Promise((resolve) => {
+                release = resolve;
+            });
+            const awaited = { answered, release };
+            answering.set(locator, awaited);
+            return () => {
+                if (answering.get(locator) === awaited)
+                    answering.delete(locator);
+                release();
+            };
+        },
+        answered: (locator) => answering.get(locator)?.answered,
+    };
+}

package/dist/socket/lanes.d.ts

@@ -0,0 +1,20 @@
+export type Live = () => boolean;
+type LaneRules = {
+    generation(): number;
+    continuing(): boolean;
+    stopping(): boolean;
+};
+export type Lanes = {
+    task(lane: string, work: (live: Live) => Promise<void>): Promise<void>;
+    inRoom<T>(locator: string, work: (live: Live) => Promise<T>): Promise<T>;
+    roomTask(locator: string, work: (live: Live) => Promise<void>): Promise<void>;
+    roomWork(): number;
+    current(): Promise<unknown>;
+    finished(): Promise<unknown>;
+    calling(operation: string): boolean;
+    call(operation: string): void;
+    called(operation: string): void;
+};
+export declare function createLanes({ generation, continuing, stopping }: LaneRules): Lanes;
+export {};
+//# sourceMappingURL=lanes.d.ts.map

package/dist/socket/lanes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lanes.d.ts","sourceRoot":"","sources":["../../src/socket/lanes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;AAIjC,KAAK,SAAS,GAAG;IACf,UAAU,IAAI,MAAM,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAIF,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,KAAK,CAgFlF"}

package/dist/socket/lanes.js

@@ -0,0 +1,77 @@
+const ROOM_READS = 256;
+export function createLanes({ generation, continuing, stopping }) {
+    const lanes = new Map();
+    const roomLanes = new Map();
+    const roomReads = { free: ROOM_READS, waiting: [] };
+    const working = new Set();
+    const calling = new Set();
+    let roomWork = 0;
+    async function admittedRead(work) {
+        while (roomReads.free === 0) {
+            await new Promise((admit) => roomReads.waiting.push(admit));
+        }
+        roomReads.free -= 1;
+        try {
+            await work();
+        }
+        finally {
+            roomReads.free += 1;
+            roomReads.waiting.shift()?.();
+        }
+    }
+    function inRoom(locator, work) {
+        roomWork += 1;
+        const ran = (roomLanes.get(locator) ?? Promise.resolve()).then(async () => {
+            try {
+                return await work(continuing);
+            }
+            finally {
+                roomWork -= 1;
+            }
+        });
+        const chain = ran.then(() => undefined, () => undefined);
+        roomLanes.set(locator, chain);
+        working.add(chain);
+        void chain.finally(() => {
+            working.delete(chain);
+            if (roomLanes.get(locator) === chain)
+                roomLanes.delete(locator);
+        });
+        return ran;
+    }
+    return {
+        task(lane, work) {
+            if (stopping())
+                return Promise.resolve();
+            const held = lanes.get(lane);
+            const opened = generation();
+            const current = held?.generation === opened ? held : { generation: opened, chain: Promise.resolve() };
+            const turn = current.generation;
+            const live = () => turn === generation() && continuing();
+            const run = current.chain.then(() => work(live)).catch(() => undefined);
+            current.chain = run;
+            lanes.set(lane, current);
+            working.add(run);
+            void run.finally(() => working.delete(run));
+            return run;
+        },
+        inRoom,
+        roomTask(locator, work) {
+            if (stopping())
+                return Promise.resolve();
+            return inRoom(locator, (live) => admittedRead(() => work(live))).catch(() => undefined);
+        },
+        roomWork: () => roomWork,
+        current: () => Promise.all([...lanes.values()]
+            .filter((held) => held.generation === generation())
+            .map((held) => held.chain)),
+        finished: () => Promise.all(working),
+        calling: (operation) => calling.has(operation),
+        call(operation) {
+            calling.add(operation);
+        },
+        called(operation) {
+            calling.delete(operation);
+        },
+    };
+}

package/dist/socket/reads.d.ts

@@ -0,0 +1,10 @@
+import type { Adapter } from '../adapter.js';
+import type { Reads } from '../bootstrap.js';
+type HeldReads = {
+    readonly reads: Reads;
+    abort(): void;
+    stop(): void;
+};
+export declare function createReads(adapter: Adapter): HeldReads;
+export {};
+//# sourceMappingURL=reads.d.ts.map

package/dist/socket/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../src/socket/reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiD,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;CACd,CAAC;AAWF,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAuBvD"}

package/dist/socket/reads.js

@@ -0,0 +1,31 @@
+function readUntil(read, signal) {
+    if (signal.aborted)
+        return Promise.resolve({ kind: 'transport-uncertainty' });
+    return new Promise((resolve, reject) => {
+        const stop = () => resolve({ kind: 'transport-uncertainty' });
+        signal.addEventListener('abort', stop, { once: true });
+        read.then(resolve, reject).finally(() => signal.removeEventListener('abort', stop));
+    });
+}
+export function createReads(adapter) {
+    let inFlight = new AbortController();
+    const refreshed = adapter.refresh?.bind(adapter);
+    return {
+        reads: {
+            bootstrap: (authorized, request) => readUntil(adapter.bootstrap(authorized, request), inFlight.signal),
+            ...(refreshed === undefined
+                ? {}
+                : {
+                    refresh: (authorized, request) => readUntil(refreshed(authorized, request), inFlight.signal),
+                }),
+            reached: (locator, roomVersion, target) => adapter.reached(locator, roomVersion, target),
+        },
+        abort() {
+            inFlight.abort();
+            inFlight = new AbortController();
+        },
+        stop() {
+            inFlight.abort();
+        },
+    };
+}

package/dist/socket/rooms.d.ts

@@ -0,0 +1,43 @@
+import type { DiscoveredRoom, ProviderRefusal, TypedSelection } from '../adapter.js';
+import type { ModelState } from '../model.js';
+export type RoomDeclaration = Omit<DiscoveredRoom, 'roomVersion' | 'typedSelection'> & {
+    typedSelection?: TypedSelection | null;
+};
+export type Declared = {
+    readonly room: RoomDeclaration | null;
+    readonly available: boolean;
+};
+export type RoomStanding = {
+    readonly unreadable: boolean;
+    readonly refusal: ProviderRefusal | null;
+    readonly unheldModel: ModelState | null;
+    readonly stale: boolean;
+    readonly repairable: {
+        readonly reset: string | undefined;
+    } | null;
+    readonly repairing: boolean;
+    readonly reloadDue: boolean;
+    readonly confirmed: boolean;
+    readonly unpreparable: boolean;
+};
+export type Rooms = {
+    declare(locator: string, declared: Declared): void;
+    declared(locator: string): Declared | undefined;
+    declarations(): ReadonlyMap<string, Declared>;
+    discover(room: DiscoveredRoom): void;
+    discovered(locator: string): DiscoveredRoom | undefined;
+    discoveredRooms(): readonly DiscoveredRoom[];
+    undiscoverAll(): void;
+    standing(locator: string): RoomStanding;
+    stand(locator: string, change: Partial<RoomStanding>): void;
+    standingWhere(held: (room: RoomStanding) => boolean): readonly string[];
+    standAll(change: Partial<RoomStanding>): void;
+    forget(locator: string): void;
+    askAgain(locator: string, ask: () => void): void;
+    readied(locator: string): void;
+    unreadied(): void;
+    connectionLost(lapsed: () => void): void;
+    connectionLive(): void;
+};
+export declare function createRooms(): Rooms;
+//# sourceMappingURL=rooms.d.ts.map

package/dist/socket/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/socket/rooms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,gBAAgB,CAAC,GAAG;IACrF,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAcF,MAAM,MAAM,KAAK,GAAG;IAClB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACxD,eAAe,IAAI,SAAS,cAAc,EAAE,CAAC;IAC7C,aAAa,IAAI,IAAI,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC5D,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,IAAI,IAAI,CAAC;IAClB,cAAc,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzC,cAAc,IAAI,IAAI,CAAC;CACxB,CAAC;AAQF,wBAAgB,WAAW,IAAI,KAAK,CAsEnC"}

package/dist/socket/rooms.js

@@ -0,0 +1,90 @@
+const STANDING = {
+    unreadable: false,
+    refusal: null,
+    unheldModel: null,
+    stale: false,
+    repairable: null,
+    repairing: false,
+    reloadDue: false,
+    confirmed: false,
+    unpreparable: false,
+};
+// A Room the Provider answers not ready is asked again after these waits, the last repeating, so a chunk build that catches up within seconds installs at once and a long one is asked every 15 seconds.
+const NOT_READY_MS = [1_000, 2_000, 3_000, 5_000, 8_000, 11_000, 15_000];
+// A Room that locks offline stays readable this long after the connection drops, so a laptop waking or changing network keeps working while a disconnected device locks soon after.
+const LOCK_GRACE_MS = 120_000;
+export function createRooms() {
+    const declared = new Map();
+    const discovered = new Map();
+    const standings = new Map();
+    const unready = new Map();
+    let lockGrace = null;
+    function readied(locator) {
+        const held = unready.get(locator);
+        if (held === undefined)
+            return;
+        if (held.timer !== null)
+            clearTimeout(held.timer);
+        unready.delete(locator);
+    }
+    return {
+        declare(locator, room) {
+            declared.set(locator, room);
+        },
+        declared: (locator) => declared.get(locator),
+        declarations: () => declared,
+        discover(room) {
+            discovered.set(room.locator, room);
+        },
+        discovered: (locator) => discovered.get(locator),
+        discoveredRooms: () => [...discovered.values()],
+        undiscoverAll() {
+            discovered.clear();
+        },
+        standing: (locator) => standings.get(locator) ?? STANDING,
+        stand(locator, change) {
+            standings.set(locator, { ...(standings.get(locator) ?? STANDING), ...change });
+        },
+        standingWhere: (held) => [...standings].filter(([, room]) => held(room)).map(([locator]) => locator),
+        standAll(change) {
+            for (const [locator, room] of standings)
+                standings.set(locator, { ...room, ...change });
+        },
+        forget(locator) {
+            declared.delete(locator);
+            discovered.delete(locator);
+            const { repairing, reloadDue } = standings.get(locator) ?? STANDING;
+            standings.set(locator, { ...STANDING, repairing, reloadDue });
+        },
+        askAgain(locator, ask) {
+            const held = unready.get(locator) ?? { tries: 0, timer: null };
+            unready.set(locator, held);
+            if (held.timer !== null)
+                return;
+            const wait = NOT_READY_MS[Math.min(held.tries, NOT_READY_MS.length - 1)];
+            held.tries += 1;
+            held.timer = setTimeout(() => {
+                held.timer = null;
+                ask();
+            }, wait);
+        },
+        readied,
+        unreadied() {
+            for (const locator of [...unready.keys()])
+                readied(locator);
+        },
+        connectionLost(lapsed) {
+            if (lockGrace !== null)
+                return;
+            lockGrace = setTimeout(() => {
+                lockGrace = null;
+                lapsed();
+            }, LOCK_GRACE_MS);
+        },
+        connectionLive() {
+            if (lockGrace !== null)
+                clearTimeout(lockGrace);
+            lockGrace = null;
+        },
+    };
+}