@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/yjs/registry/document-registry.js

@@ -0,0 +1,281 @@
+/**
+ * In-memory Y.Doc refs plus identity inventory. list() freezes a cut so
+ * pagination does not see later creates; watchers get those as change/gap
+ * events instead. getLoaded never touches disk.
+ */
+import { trace } from "@inhuman.tools/harness-diagnostics";
+import { documentKeysEqual, } from "../../protocol/document/index.js";
+import { documentImagePath, identifyStoredImage } from "./identity.js";
+import { createFsImageSource } from "./images.js";
+function keyId(key) {
+    return `${key.kind}\0${key.id}`;
+}
+export class DocumentRegistry {
+    root;
+    #images;
+    #pageSize;
+    #watchBound;
+    #epoch;
+    #nextCut = 1;
+    #loaded = new Map();
+    #catalog = new Map();
+    #errors = new Map();
+    #cuts = new Map();
+    #watchers = new Set();
+    #extracting = new Map();
+    constructor(options) {
+        this.root = options.root;
+        this.#images = createFsImageSource(options.root);
+        this.#pageSize = options.pageSize ?? 32;
+        this.#watchBound = options.watchBound ?? 64;
+        this.#epoch = options.serverEpoch ?? 1;
+    }
+    get serverEpoch() {
+        return this.#epoch;
+    }
+    getLoaded(key) {
+        const loaded = this.#loaded.get(keyId(key));
+        return loaded == null ? undefined : toRef(loaded);
+    }
+    intern(key, doc) {
+        const id = keyId(key);
+        const existing = this.#loaded.get(id);
+        if (existing != null) {
+            existing.pins += 1;
+            return toRef(existing);
+        }
+        const loaded = { key, doc, revision: 0, pins: 1 };
+        this.#loaded.set(id, loaded);
+        this.#emitChange(key, loaded.revision);
+        return toRef(loaded);
+    }
+    /** Successful persist upserts the catalog row and the live revision. */
+    upsertCatalog(key, durableRevision) {
+        const storagePath = documentImagePath(this.root, key.kind, key.id);
+        const id = keyId(key);
+        this.#catalog.set(id, { key, durableRevision, storagePath });
+        this.#errors.delete(storagePath);
+        const loaded = this.#loaded.get(id);
+        if (loaded != null)
+            loaded.revision = durableRevision;
+        this.#emitChange(key, durableRevision);
+    }
+    release(key) {
+        const id = keyId(key);
+        const loaded = this.#loaded.get(id);
+        if (loaded == null)
+            return;
+        loaded.pins -= 1;
+        if (loaded.pins > 0)
+            return;
+        this.#loaded.delete(id);
+    }
+    inventoryErrors() {
+        return [...this.#errors.values()];
+    }
+    bumpServerEpoch() {
+        this.#epoch += 1;
+        this.#cuts.clear();
+        for (const watcher of this.#watchers) {
+            watcher.gapped = true;
+            watcher.queue = [{ type: "gap", reason: "epoch-change", serverEpoch: this.#epoch }];
+        }
+    }
+    watchChanges(kind, checkpoint) {
+        const watcher = { kind, gapped: false, queue: [] };
+        if (checkpoint.serverEpoch !== this.#epoch) {
+            watcher.gapped = true;
+            watcher.queue = [{ type: "gap", reason: "epoch-change", serverEpoch: this.#epoch }];
+        }
+        else if (!this.#cuts.has(checkpoint.cut)) {
+            watcher.gapped = true;
+            watcher.queue = [
+                {
+                    type: "gap",
+                    reason: "missing-checkpoint",
+                    serverEpoch: this.#epoch,
+                },
+            ];
+        }
+        this.#watchers.add(watcher);
+        return {
+            pull: () => {
+                const events = watcher.queue;
+                watcher.queue = [];
+                return events;
+            },
+            close: () => {
+                this.#watchers.delete(watcher);
+            },
+        };
+    }
+    async list(query) {
+        if (query.cursor == null) {
+            const entries = await this.#snapshot(query.kind);
+            const cut = this.#nextCut;
+            this.#nextCut += 1;
+            this.#cuts.set(cut, { epoch: this.#epoch, kind: query.kind, entries });
+            return this.#page(cut, 0, entries);
+        }
+        const parsed = parseCursor(query.cursor);
+        if (parsed == null) {
+            return {
+                entries: [],
+                cursor: null,
+                checkpoint: { serverEpoch: this.#epoch, cut: 0 },
+            };
+        }
+        const snapshot = this.#cuts.get(parsed.cut);
+        if (snapshot?.epoch !== this.#epoch || snapshot.kind !== query.kind) {
+            return {
+                entries: [],
+                cursor: null,
+                checkpoint: { serverEpoch: this.#epoch, cut: parsed.cut },
+            };
+        }
+        return this.#page(parsed.cut, parsed.offset, snapshot.entries);
+    }
+    #page(cut, offset, entries) {
+        const slice = entries.slice(offset, offset + this.#pageSize);
+        const next = offset + this.#pageSize;
+        return {
+            entries: slice,
+            cursor: next < entries.length ? formatCursor(cut, next) : null,
+            checkpoint: { serverEpoch: this.#epoch, cut },
+        };
+    }
+    async #snapshot(kind) {
+        const byId = new Map();
+        const seenPaths = new Set();
+        for (const loaded of this.#loaded.values()) {
+            if (loaded.key.kind !== kind)
+                continue;
+            const entry = entryOf(this.root, loaded.key, loaded.revision);
+            byId.set(loaded.key.id, entry);
+            seenPaths.add(entry.storagePath);
+        }
+        const paths = new Set();
+        for (const entry of this.#catalog.values()) {
+            if (entry.key.kind === kind)
+                paths.add(entry.storagePath);
+        }
+        for (const storagePath of await this.#images.list(kind)) {
+            paths.add(storagePath);
+        }
+        for (const storagePath of paths) {
+            if (seenPaths.has(storagePath))
+                continue;
+            await this.#extract(kind, storagePath);
+            const cataloged = this.#catalogByPath(storagePath);
+            if (cataloged == null || byId.has(cataloged.key.id))
+                continue;
+            byId.set(cataloged.key.id, cataloged);
+        }
+        return [...byId.values()].sort((a, b) => a.key.id.localeCompare(b.key.id));
+    }
+    #catalogByPath(storagePath) {
+        for (const entry of this.#catalog.values()) {
+            if (entry.storagePath === storagePath)
+                return entry;
+        }
+        return undefined;
+    }
+    async #extract(kind, storagePath) {
+        const pending = this.#extracting.get(storagePath);
+        if (pending != null) {
+            await pending;
+            return;
+        }
+        const run = this.#extractOne(kind, storagePath).finally(() => {
+            this.#extracting.delete(storagePath);
+        });
+        this.#extracting.set(storagePath, run);
+        await run;
+    }
+    async #extractOne(kind, storagePath) {
+        const previous = this.#catalogByPath(storagePath);
+        const bytes = await this.#images.read(storagePath);
+        if (bytes == null) {
+            this.#dropCatalogPath(storagePath);
+            this.#recordError(storagePath, "empty");
+            return;
+        }
+        const decoded = identifyStoredImage(this.root, kind, storagePath, bytes);
+        if (!decoded.ok) {
+            this.#dropCatalogPath(storagePath);
+            this.#recordError(storagePath, decoded.reason);
+            return;
+        }
+        const key = { kind, id: decoded.id };
+        const unchanged = previous?.key.kind === kind && previous.key.id === decoded.id && previous.storagePath === storagePath;
+        this.#dropCatalogPath(storagePath);
+        const entry = {
+            key,
+            durableRevision: unchanged ? previous.durableRevision : 0,
+            storagePath,
+        };
+        this.#catalog.set(keyId(key), entry);
+        this.#errors.delete(storagePath);
+        if (!unchanged)
+            this.#emitChange(key, entry.durableRevision);
+    }
+    #dropCatalogPath(storagePath) {
+        for (const [id, entry] of this.#catalog) {
+            if (entry.storagePath === storagePath)
+                this.#catalog.delete(id);
+        }
+    }
+    #recordError(storagePath, reason) {
+        this.#errors.set(storagePath, { storagePath, reason });
+        trace("yjs-server:inventory", `${reason} ${storagePath}`);
+    }
+    #emitChange(key, revision) {
+        const event = { type: "change", key, revision };
+        for (const watcher of this.#watchers) {
+            if (watcher.kind !== key.kind || watcher.gapped)
+                continue;
+            coalesceChange(watcher.queue, event);
+            if (watcher.queue.length > this.#watchBound) {
+                watcher.gapped = true;
+                watcher.queue = [{ type: "gap", reason: "overflow", serverEpoch: this.#epoch }];
+            }
+        }
+    }
+}
+function toRef(loaded) {
+    return { key: loaded.key, doc: loaded.doc, revision: loaded.revision };
+}
+function entryOf(root, key, revision) {
+    return {
+        key,
+        durableRevision: revision,
+        storagePath: documentImagePath(root, key.kind, key.id),
+    };
+}
+function coalesceChange(queue, event) {
+    for (let i = 0; i < queue.length; i += 1) {
+        const pending = queue[i];
+        if (pending.type !== "change")
+            continue;
+        if (!documentKeysEqual(pending.key, event.key))
+            continue;
+        queue[i] = event;
+        return;
+    }
+    queue.push(event);
+}
+function formatCursor(cut, offset) {
+    return `${cut}.${offset}`;
+}
+function parseCursor(cursor) {
+    const sep = cursor.indexOf(".");
+    if (sep === -1)
+        return null;
+    const cut = Number(cursor.slice(0, sep));
+    const offset = Number(cursor.slice(sep + 1));
+    if (!Number.isInteger(cut) || !Number.isInteger(offset) || cut < 1 || offset < 0) {
+        return null;
+    }
+    return { cut, offset };
+}
+//# sourceMappingURL=document-registry.js.map

package/dist/yjs/registry/document-registry.js.map

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

package/dist/yjs/registry/identity.d.ts

@@ -0,0 +1,18 @@
+import { type DocumentKey, type DocumentKind, type InventoryErrorReason } from "../../protocol/document/index.js";
+/** Matches SessionRoot @syncing tag. */
+export declare const SESSION_ROOT_TYPE = "harness:session:root";
+/** Matches ProjectRoot @syncing tag. */
+export declare const PROJECT_ROOT_TYPE = "harness:project:root";
+export type IdentityDecode = {
+    readonly ok: true;
+    readonly id: string;
+} | {
+    readonly ok: false;
+    readonly reason: InventoryErrorReason;
+};
+export declare function documentImagePath(root: string, kind: DocumentKind, id: string): string;
+/** Live replica guid. Restore uses the kind prefix, not a minted project id. */
+export declare function documentGuid(key: DocumentKey): string;
+export declare function decodeImageIdentity(kind: DocumentKind, bytes: Uint8Array): IdentityDecode;
+export declare function identifyStoredImage(root: string, kind: DocumentKind, storagePath: string, bytes: Uint8Array): IdentityDecode;
+//# sourceMappingURL=identity.d.ts.map

package/dist/yjs/registry/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/yjs/registry/identity.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAI7B,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AACxD,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAIxD,MAAM,MAAM,cAAc,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAE7G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,cAAc,CAsBzF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAChB,cAAc,CAOhB"}

package/dist/yjs/registry/identity.js

@@ -0,0 +1,85 @@
+/**
+ * Stored image identity: filenames are sha256(id); identity lives in the
+ * Y.Doc. Kernel is fixed. Session/project read one root field off a
+ * throwaway doc — not domain models, not a live room.
+ */
+import { join } from "node:path";
+import * as Y from "yjs";
+import { documentImageSegments, KERNEL_DOCUMENT_GUID, KERNEL_DOCUMENT_KEY, PROJECT_DOCUMENT_GUID_PREFIX, sessionDocumentGuid, } from "../../protocol/document/index.js";
+import { readUpdateLog } from "../update-log.js";
+/** Matches SessionRoot @syncing tag. */
+export const SESSION_ROOT_TYPE = "harness:session:root";
+/** Matches ProjectRoot @syncing tag. */
+export const PROJECT_ROOT_TYPE = "harness:project:root";
+const EXTRACT_GUID = "inventory-extract";
+export function documentImagePath(root, kind, id) {
+    return join(root, ...documentImageSegments(kind, id));
+}
+/** Live replica guid. Restore uses the kind prefix, not a minted project id. */
+export function documentGuid(key) {
+    switch (key.kind) {
+        case "kernel":
+            return KERNEL_DOCUMENT_GUID;
+        case "sessions":
+            return sessionDocumentGuid(key.id);
+        case "projects":
+            return PROJECT_DOCUMENT_GUID_PREFIX;
+    }
+}
+export function decodeImageIdentity(kind, bytes) {
+    if (bytes.byteLength === 0)
+        return { ok: false, reason: "empty" };
+    const updates = readUpdateLog(bytes);
+    const first = updates?.[0];
+    if (first == null)
+        return { ok: false, reason: "corrupt" };
+    const doc = new Y.Doc({ guid: EXTRACT_GUID });
+    try {
+        Y.applyUpdate(doc, first);
+    }
+    catch {
+        doc.destroy();
+        return { ok: false, reason: "corrupt" };
+    }
+    try {
+        if (kind === "kernel")
+            return { ok: true, id: KERNEL_DOCUMENT_KEY.id };
+        const typeName = kind === "sessions" ? SESSION_ROOT_TYPE : PROJECT_ROOT_TYPE;
+        const field = kind === "sessions" ? "sessionId" : "path";
+        const id = readRootField(doc, typeName, field);
+        if (id == null)
+            return { ok: false, reason: "decode-failure" };
+        return { ok: true, id };
+    }
+    finally {
+        doc.destroy();
+    }
+}
+export function identifyStoredImage(root, kind, storagePath, bytes) {
+    const decoded = decodeImageIdentity(kind, bytes);
+    if (!decoded.ok)
+        return decoded;
+    if (documentImagePath(root, kind, decoded.id) !== storagePath) {
+        return { ok: false, reason: "mismatch" };
+    }
+    return decoded;
+}
+function readRootField(doc, typeName, field) {
+    const meta = doc.getMap("meta");
+    const types = doc.getMap("types");
+    const rootUuid = meta.get("root");
+    if (typeof rootUuid !== "string" || rootUuid === "")
+        return null;
+    const typeMap = types.get(typeName);
+    if (!(typeMap instanceof Y.Map))
+        return null;
+    const node = typeMap.get(rootUuid);
+    if (!(node instanceof Y.XmlElement))
+        return null;
+    const value = node.getAttribute(field);
+    if (typeof value !== "string")
+        return null;
+    const id = value.trim();
+    return id === "" ? null : id;
+}
+//# sourceMappingURL=identity.js.map

package/dist/yjs/registry/identity.js.map

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

package/dist/yjs/registry/images.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentKind } from "../../protocol/document/index.js";
+export type ImageSource = {
+    readonly root: string;
+    list(kind: DocumentKind): Promise<readonly string[]>;
+    read(storagePath: string): Promise<Uint8Array | null>;
+};
+export declare function createFsImageSource(root: string): ImageSource;
+//# sourceMappingURL=images.d.ts.map

package/dist/yjs/registry/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/yjs/registry/images.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACvD,CAAC;AAMF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAuB7D"}

package/dist/yjs/registry/images.js

@@ -0,0 +1,42 @@
+/**
+ * Read side of the F2 image layout `{root}/documents/{kind}/{sha256(id)}.yjs`.
+ * The writer lives in storage; inventory only lists and reads.
+ */
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+const IMAGE_FILE = /^[0-9a-f]{64}\.yjs$/;
+function isImageFileName(name) {
+    return IMAGE_FILE.test(name);
+}
+export function createFsImageSource(root) {
+    return {
+        root,
+        async list(kind) {
+            const dir = join(root, "documents", kind);
+            let names;
+            try {
+                names = await readdir(dir);
+            }
+            catch (error) {
+                if (isEnoent(error))
+                    return [];
+                throw error;
+            }
+            return names.filter((name) => isImageFileName(name)).map((name) => join(dir, name));
+        },
+        async read(storagePath) {
+            try {
+                return await readFile(storagePath);
+            }
+            catch (error) {
+                if (isEnoent(error))
+                    return null;
+                throw error;
+            }
+        },
+    };
+}
+function isEnoent(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=images.js.map

package/dist/yjs/registry/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../src/yjs/registry/images.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAQzC,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAe,CAAC;YACpB,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,QAAQ,CAAC,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,WAAW;YACpB,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,QAAQ,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC"}

package/dist/yjs/registry/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./identity.js";
+export * from "./document-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/yjs/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/yjs/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC"}

package/dist/yjs/registry/index.js

@@ -0,0 +1,3 @@
+export * from "./identity.js";
+export * from "./document-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/yjs/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/yjs/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC"}

package/dist/yjs/relay.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Public-plane sync and awareness. Every client plane is a lens; clients
+ * change state through RPC. Room lifetime is independent of execution:
+ * park() must not close a room another consumer still holds.
+ */
+import { PlexusAwareness } from "@here.build/plexus";
+import * as Y from "yjs";
+export interface PlaneSocket {
+    send(frame: Uint8Array): void;
+    sendText(text: string): void;
+    close(code: number, reason: string): void;
+    onBinary(handler: (frame: Uint8Array) => void): void;
+    onText(handler: (text: string) => void): void;
+    onClose(handler: () => void): void;
+}
+export declare class AwarenessReplay {
+    #private;
+    apply(frame: Uint8Array): void;
+    snapshot(): Uint8Array | null;
+    destroy(): void;
+}
+export declare class AwarenessRoom {
+    #private;
+    constructor(hub?: PlexusAwareness);
+    join(socket: PlaneSocket): void;
+    receive(from: PlaneSocket, frame: Uint8Array): void;
+    broadcast(frame: Uint8Array): void;
+    close(code: number, reason: string): void;
+    snapshot(): Uint8Array | null;
+}
+/** Server-authoritative plane: reply STEP1 with our STEP2; drop inbound STEP2/UPDATE. */
+export declare function attachLens(doc: Y.Doc, socket: PlaneSocket, room?: AwarenessRoom, hub?: PlexusAwareness): void;
+//# sourceMappingURL=relay.d.ts.map

package/dist/yjs/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/yjs/relay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAyB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAgBzB,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACpC;AAED,qBAAa,eAAe;;IAI1B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI9B,QAAQ,IAAI,UAAU,GAAG,IAAI;IAM7B,OAAO,IAAI,IAAI;CAIhB;AAED,qBAAa,aAAa;;gBAMZ,GAAG,CAAC,EAAE,eAAe;IAOjC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAS/B,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAKnD,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKlC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQzC,QAAQ,IAAI,UAAU,GAAG,IAAI;CAY9B;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,CAE7G"}

package/dist/yjs/relay.js

@@ -0,0 +1,123 @@
+/**
+ * Public-plane sync and awareness. Every client plane is a lens; clients
+ * change state through RPC. Room lifetime is independent of execution:
+ * park() must not close a room another consumer still holds.
+ */
+import { encodeAwarenessUpdate, PlexusAwareness } from "@here.build/plexus";
+import * as Y from "yjs";
+import { MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, encodeSyncStep1, forwardPlexusAwareness, ingestPlexusAwareness, peekMessageType, replyLensSyncFrame, } from "../protocol/document/index.js";
+export class AwarenessReplay {
+    #doc = new Y.Doc();
+    #hub = new PlexusAwareness(this.#doc);
+    apply(frame) {
+        ingestPlexusAwareness(this.#hub, frame);
+    }
+    snapshot() {
+        const clients = [...this.#hub.meta.keys()];
+        if (clients.length === 0)
+            return null;
+        return encodeAwarenessFrame(encodeAwarenessUpdate(this.#hub, clients));
+    }
+    destroy() {
+        this.#hub.destroy();
+        this.#doc.destroy();
+    }
+}
+export class AwarenessRoom {
+    #replay = new AwarenessReplay();
+    #sockets = new Set();
+    #hub;
+    #stopForward;
+    constructor(hub) {
+        this.#hub = hub;
+        // Local actor.report() writes the hub in-process — not a socket frame.
+        // Broadcast those writes so TUI replicas see live speech.
+        this.#stopForward = hub === undefined ? null : forwardPlexusAwareness(hub, (frame) => this.broadcast(frame));
+    }
+    join(socket) {
+        this.#sockets.add(socket);
+        socket.onClose(() => {
+            this.#sockets.delete(socket);
+        });
+        const dump = this.snapshot();
+        if (dump !== null)
+            socket.send(dump);
+    }
+    receive(from, frame) {
+        this.#replay.apply(frame);
+        for (const peer of this.#sockets)
+            if (peer !== from)
+                peer.send(frame);
+    }
+    broadcast(frame) {
+        this.#replay.apply(frame);
+        for (const peer of this.#sockets)
+            peer.send(frame);
+    }
+    close(code, reason) {
+        this.#stopForward?.();
+        const sockets = [...this.#sockets];
+        this.#sockets.clear();
+        for (const socket of sockets)
+            socket.close(code, reason);
+        this.#replay.destroy();
+    }
+    snapshot() {
+        if (this.#hub !== undefined) {
+            const clients = [...this.#hub.meta.keys()];
+            if (clients.length === 0)
+                return null;
+            try {
+                return encodeAwarenessFrame(encodeAwarenessUpdate(this.#hub, clients));
+            }
+            catch {
+                return null;
+            }
+        }
+        return this.#replay.snapshot();
+    }
+}
+/** Server-authoritative plane: reply STEP1 with our STEP2; drop inbound STEP2/UPDATE. */
+export function attachLens(doc, socket, room, hub) {
+    attachSync(doc, socket, room, hub, (frame, live) => replyLensSyncFrame(frame, live));
+}
+function attachSync(doc, socket, room, hub, inbound) {
+    const onDocUpdate = (update, origin) => {
+        if (origin === socket)
+            return;
+        socket.send(encodeDocUpdate(update));
+    };
+    socket.onBinary((frame) => {
+        try {
+            const messageType = peekMessageType(frame);
+            if (messageType === MESSAGE_QUERY_AWARENESS) {
+                socket.send(room?.snapshot() ?? encodeQueryAwareness());
+                return;
+            }
+            if (messageType === MESSAGE_AWARENESS) {
+                if (hub !== undefined)
+                    ingestPlexusAwareness(hub, frame);
+                room?.receive(socket, frame);
+                return;
+            }
+            if (messageType !== MESSAGE_SYNC)
+                return;
+            const reply = inbound(frame, doc, socket);
+            if (reply !== null)
+                socket.send(reply);
+        }
+        catch {
+            /* malformed peer frame */
+        }
+    });
+    socket.onClose(() => {
+        doc.off("update", onDocUpdate);
+    });
+    doc.on("update", onDocUpdate);
+    // Say what this replica holds, as y-websocket's own server does. A client that kept
+    // a cache compares it to this vector and drops what the replica no longer has.
+    // Its STEP2 answer is dropped like any inbound document write.
+    socket.send(encodeSyncStep1(doc));
+    room?.join(socket);
+}
+//# sourceMappingURL=relay.js.map