@deepfates/lync 0.3.0

package/dist/cli/sync.js

@@ -0,0 +1,232 @@
+import { appendFile, readFile, writeFile } from "node:fs/promises";
+import { existsSync, watch } from "node:fs";
+import { basename } from "node:path";
+import { decodeFrame, encodeFrame, extractLineId, isCursor } from "../sync-protocol.js";
+export async function syncOnce(options) {
+    const root = options.root ?? defaultRoot(options.file);
+    const cursorPath = `${options.file}.sync.json`;
+    const cursor = await readCursor(cursorPath, options.url, root);
+    let text = existsSync(options.file) ? await readFile(options.file, "utf8") : "";
+    if (text.length > 0 && !text.endsWith("\n")) {
+        options.err.write(`lync sync: ${options.file} has a truncated final line; sealing it as damaged\n`);
+        await appendFile(options.file, "\n");
+        text += "\n";
+    }
+    const localLines = text.split("\n").filter((line) => line.length > 0);
+    const localIds = new Set();
+    for (const line of localLines) {
+        const id = extractLineId(line);
+        if (id !== undefined)
+            localIds.add(id);
+    }
+    const socket = new WebSocket(options.url);
+    // Never a Blob: a binary frame arrives as an ArrayBuffer we can decode
+    // synchronously. Text frames (the relay's native tongue) arrive as strings.
+    socket.binaryType = "arraybuffer";
+    const result = { sent: 0, received: 0, duplicates: 0, surfaced: 0, conflicts: 0, seq: cursor.seq };
+    let appendChain = Promise.resolve();
+    let following = false;
+    // Byte offset of everything we've already offered the server, so follow
+    // mode can push only newly appended complete lines.
+    let localOffset = Buffer.byteLength(text, "utf8");
+    let watcher;
+    let pushChain = Promise.resolve();
+    // The generation our cursor belongs to. Adopted from the first gen-bearing
+    // frame; a later mismatch (server restarted) resets the cursor to 0 and
+    // resubscribes — duplicates are no-ops, silent skips are not.
+    let generation = cursor.generation;
+    // Every `sub` we send is answered by exactly one `live`, in order. After a
+    // generation reset re-subscribes, the earlier sub's live is stale — treating
+    // it as "live" would end a one-shot sync before the re-fetched backlog
+    // arrives. Count outstanding subs; only the last live counts.
+    let awaitedLives = 1; // the initial sub, sent on open
+    const persistCursor = () => writeFile(cursorPath, `${JSON.stringify({ url: options.url, root, seq: result.seq, ...(generation !== undefined ? { generation } : {}) }, null, 2)}\n`);
+    /**
+     * Returns true when the server's generation differs from the one our cursor
+     * was saved under — in which case the cursor has been reset to 0 and a fresh
+     * `sub` from 0 is already on the wire. Frames without gen (old server) never
+     * trigger a reset.
+     */
+    const generationChanged = (gen) => {
+        if (gen === undefined || gen === generation)
+            return false;
+        if (generation === undefined) {
+            generation = gen; // first sighting: adopt, nothing to reset
+            return false;
+        }
+        options.err.write(`lync sync: server log generation changed (${generation} -> ${gen}); resyncing ${root} from 0\n`);
+        generation = gen;
+        result.seq = 0;
+        awaitedLives += 1;
+        socket.send(encodeFrame({ t: "sub", root, since: 0 }));
+        return true;
+    };
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            // The rejection is the hard abort — it settles the promise no matter
+            // what the socket does next. close() then aborts the handshake (if
+            // still connecting) or starts teardown; there is no terminate() here.
+            reject(new Error(`lync sync: no 'live' from ${options.url} within ${options.timeoutMs ?? 15_000}ms`));
+            socket.close();
+        }, options.timeoutMs ?? 15_000);
+        const stop = () => {
+            watcher?.close();
+            resolve();
+        };
+        options.stopSignal?.addEventListener("abort", stop, { once: true });
+        function startFollowingLocalAppends() {
+            watcher = watch(options.file, () => {
+                pushChain = pushChain.then(async () => {
+                    const current = await readFile(options.file, "utf8");
+                    const fresh = current.slice(localOffset);
+                    const upto = fresh.lastIndexOf("\n");
+                    if (upto < 0)
+                        return; // no complete new line yet
+                    for (const line of fresh.slice(0, upto).split("\n")) {
+                        if (line.length === 0)
+                            continue;
+                        const id = extractLineId(line);
+                        if (id !== undefined && localIds.has(id))
+                            continue; // our own echo, already appended
+                        if (id !== undefined)
+                            localIds.add(id);
+                        socket.send(encodeFrame({ t: "ev", root, line }));
+                        result.sent += 1;
+                    }
+                    localOffset += Buffer.byteLength(fresh.slice(0, upto + 1), "utf8");
+                });
+            });
+        }
+        socket.addEventListener("close", () => {
+            clearTimeout(timeout);
+            watcher?.close();
+            if (following)
+                resolve();
+        });
+        socket.addEventListener("error", (event) => {
+            clearTimeout(timeout);
+            watcher?.close();
+            const detail = event.message;
+            reject(new Error(`lync sync: socket error from ${options.url}${typeof detail === "string" ? `: ${detail}` : ""}`));
+        });
+        socket.addEventListener("open", () => {
+            // Push before subscribing: the server handles our frames in order, so
+            // every conflict or rejection for our own lines arrives before the
+            // backlog and `live`, and the backlog then covers our accepted lines
+            // (duplicate no-ops that settle the resume cursor in one pass).
+            for (const line of localLines) {
+                socket.send(encodeFrame({ t: "ev", root, line }));
+                result.sent += 1;
+            }
+            socket.send(encodeFrame({ t: "sub", root, since: cursor.seq }));
+        });
+        socket.addEventListener("message", (event) => {
+            const raw = event.data;
+            const frame = decodeFrame(typeof raw === "string" ? raw : new TextDecoder().decode(raw));
+            switch (frame.t) {
+                case "ev": {
+                    // A generation change resets the cursor and resubscribes; this
+                    // frame's line is still ingested below (it is from the live
+                    // generation), and the resubscribe re-covers everything else.
+                    generationChanged(frame.gen);
+                    const id = extractLineId(frame.line);
+                    if (id === undefined) {
+                        options.err.write(`lync sync: server sent a line without an id; surfaced, not appended\n`);
+                        result.surfaced += 1;
+                    }
+                    else if (localIds.has(id)) {
+                        result.duplicates += 1;
+                    }
+                    else {
+                        localIds.add(id);
+                        result.received += 1;
+                        const line = frame.line;
+                        appendChain = appendChain.then(async () => {
+                            await appendFile(options.file, `${line}\n`);
+                            // Appends of our own making must not be re-pushed by the watcher.
+                            localOffset += Buffer.byteLength(`${line}\n`, "utf8");
+                        });
+                    }
+                    if (typeof frame.seq === "number")
+                        result.seq = Math.max(result.seq, frame.seq);
+                    if (following)
+                        appendChain = appendChain.then(() => persistCursor());
+                    return;
+                }
+                case "live": {
+                    // A stale live is not live: either its generation is dead (the
+                    // resubscribe from 0 is already on the wire) or it answers a sub
+                    // that a generation reset has since superseded. Wait for the real
+                    // one — the backlog, then live, follows.
+                    const changed = generationChanged(frame.gen);
+                    awaitedLives -= 1;
+                    if (changed || awaitedLives > 0)
+                        return;
+                    clearTimeout(timeout);
+                    result.seq = Math.max(result.seq, frame.seq);
+                    if (!options.follow) {
+                        resolve();
+                        return;
+                    }
+                    if (!following) {
+                        following = true;
+                        options.out.write(`lync sync: live at seq ${result.seq}; following (Ctrl-C to stop)\n`);
+                        void persistCursor();
+                        startFollowingLocalAppends();
+                    }
+                    return;
+                }
+                case "err": {
+                    if (frame.reason === "same-id-conflict") {
+                        result.conflicts += 1;
+                        options.err.write(`lync sync: same-id conflict surfaced by server: ${frame.detail ?? "?"}\n`);
+                    }
+                    else if (frame.reason === "recovered-damaged-tail") {
+                        options.err.write(`lync sync: server note: ${frame.detail ?? frame.reason}\n`);
+                    }
+                    else {
+                        options.err.write(`lync sync: server error: ${frame.reason}${frame.detail ? ` (${frame.detail})` : ""}\n`);
+                    }
+                    return;
+                }
+                default:
+                    return;
+            }
+        });
+    }).finally(() => {
+        watcher?.close();
+        socket.close();
+    });
+    await appendChain;
+    await pushChain;
+    await persistCursor();
+    return result;
+}
+function defaultRoot(file) {
+    return basename(file).replace(/\.lync$/, "");
+}
+async function readCursor(path, url, root) {
+    if (!existsSync(path))
+        return { url, root, seq: 0 };
+    try {
+        const stored = JSON.parse(await readFile(path, "utf8"));
+        // seq must be a nonnegative INTEGER: a fractional cursor (corrupt or
+        // hand-edited file) would make the relay skip the whole backlog and then
+        // get persisted as live — a permanent silent miss. Reset to 0 instead;
+        // re-receiving the backlog is a harmless union no-op.
+        if (stored.url === url && stored.root === root && isCursor(stored.seq)) {
+            // A non-string generation is noise from a hand-edited file: drop just
+            // the generation (the first gen-bearing frame re-adopts), keep the seq.
+            if (stored.generation !== undefined && typeof stored.generation !== "string") {
+                return { url, root, seq: stored.seq };
+            }
+            return stored;
+        }
+        // Different server/root, or an unusable cursor: start from 0.
+        return { url, root, seq: 0 };
+    }
+    catch {
+        return { url, root, seq: 0 };
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

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

package/dist/client/create.d.ts

@@ -0,0 +1,10 @@
+import { type Looms } from "../index.js";
+import type { LoomIndexes } from "../indexes/index.js";
+import type { LoomClient } from "./types.js";
+export interface CreateLoomClientOptions<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown, TEntryMeta = unknown, TIndexMeta = unknown> {
+    looms: Looms<TPayload, TLoomMeta, TTurnMeta>;
+    indexes: LoomIndexes<TEntryMeta, TIndexMeta>;
+    close?: () => Promise<void> | void;
+}
+export declare function createLoomClient<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown, TEntryMeta = unknown, TIndexMeta = unknown>(options: CreateLoomClientOptions<TPayload, TLoomMeta, TTurnMeta, TEntryMeta, TIndexMeta>): LoomClient<TPayload, TLoomMeta, TTurnMeta, TEntryMeta, TIndexMeta>;
+//# sourceMappingURL=create.d.ts.map

package/dist/client/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/client/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,uBAAuB,CACtC,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO;IAEpB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO,EAEpB,OAAO,EAAE,uBAAuB,CAC9B,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,CACX,GACA,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CA8CpE"}

package/dist/client/create.js

@@ -0,0 +1,50 @@
+import { brokenTopology, decodeReference, encodeReference, indexRef, loomRef, parseReference, referenceFromUrl, referenceToUrl, threadRef, turnRef, } from "../index.js";
+export function createLoomClient(options) {
+    const { looms, indexes } = options;
+    return {
+        looms,
+        indexes,
+        references: {
+            loom: loomRef,
+            turn: turnRef,
+            thread: threadRef,
+            index: indexRef,
+            encode: encodeReference,
+            decode: decodeReference,
+            parse: parseReference,
+            toUrl: referenceToUrl,
+            fromUrl: referenceFromUrl,
+        },
+        async openReference(ref) {
+            switch (ref.kind) {
+                case "loom": {
+                    const loom = await looms.open(ref.loomId);
+                    return { kind: "loom", ref, loom };
+                }
+                case "turn": {
+                    const loom = await looms.open(ref.loomId);
+                    const turn = await loom.getTurn(ref.turnId);
+                    if (!turn)
+                        throw brokenTopology(`Reference target turn not found: ${ref.turnId}`);
+                    return { kind: "turn", ref, loom, turn };
+                }
+                case "thread": {
+                    const loom = await looms.open(ref.loomId);
+                    const thread = await loom.threadTo(ref.turnId);
+                    const target = thread.at(-1);
+                    if (!target)
+                        throw brokenTopology(`Reference target thread is empty: ${ref.turnId}`);
+                    return { kind: "thread", ref, loom, thread, target };
+                }
+                case "index": {
+                    const index = await indexes.open(ref.indexId);
+                    return { kind: "index", ref, index };
+                }
+            }
+        },
+        async close() {
+            await options.close?.();
+        },
+    };
+}
+//# sourceMappingURL=create.js.map

package/dist/client/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/client/create.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,QAAQ,EACR,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,OAAO,GAGR,MAAM,aAAa,CAAC;AAgBrB,MAAM,UAAU,gBAAgB,CAO9B,OAMC;IAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEnC,OAAO;QACL,KAAK;QACL,OAAO;QACP,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,gBAAgB;SAC1B;QACD,KAAK,CAAC,aAAa,CAAC,GAAkB;YACpC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;gBACrC,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC5C,IAAI,CAAC,IAAI;wBAAE,MAAM,cAAc,CAAC,oCAAoC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;oBAClF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC3C,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC7B,IAAI,CAAC,MAAM;wBAAE,MAAM,cAAc,CAAC,qCAAqC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;oBACrF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;gBACvD,CAAC;gBACD,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/index.d.ts

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

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/client/index.js

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

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/client/testing.d.ts

@@ -0,0 +1,14 @@
+import { type LyncAuthor } from "../looms.js";
+import type { LoomClient } from "./types.js";
+/**
+ * A fully in-memory loom client for tests and embedded experiments: looms and
+ * an index over memory event stores, no network. Deterministic when you pass
+ * `createId` and `now`.
+ */
+export interface TestLoomClientOptions {
+    author?: LyncAuthor;
+    createId?: () => string;
+    now?: () => number;
+}
+export declare function createTestLoomClient<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown, TEntryMeta = unknown, TIndexMeta = unknown>(options?: TestLoomClientOptions): LoomClient<TPayload, TLoomMeta, TTurnMeta, TEntryMeta, TIndexMeta>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/client/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/client/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO,EACpB,OAAO,GAAE,qBAA0B,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAazG"}

package/dist/client/testing.js

@@ -0,0 +1,19 @@
+import { createMemoryEventStore } from "../memory-log.js";
+import { createLyncLooms } from "../looms.js";
+import { createMemoryLoomIndexes } from "../indexes/memory.js";
+import { createLoomClient } from "./create.js";
+export function createTestLoomClient(options = {}) {
+    const store = createMemoryEventStore();
+    const looms = createLyncLooms({
+        store,
+        author: options.author ?? { actor: "test" },
+        createId: options.createId,
+        now: options.now,
+    });
+    const indexes = createMemoryLoomIndexes({
+        createId: options.createId,
+        now: options.now,
+    });
+    return createLoomClient({ looms, indexes });
+}
+//# sourceMappingURL=testing.js.map

package/dist/client/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/client/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAmB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAc/C,MAAM,UAAU,oBAAoB,CAMlC,UAAiC,EAAE;IACnC,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,eAAe,CAAiC;QAC5D,KAAK;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;QAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,uBAAuB,CAAyB;QAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO,gBAAgB,CAAyD,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACtG,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,49 @@
+import type { Loom, LoomReference, Looms, Turn, indexRef, loomRef, referenceFromUrl, referenceToUrl, threadRef, turnRef, encodeReference, decodeReference, parseReference } from "../index.js";
+import type { LoomIndex, LoomIndexes } from "../indexes/index.js";
+export type ReferenceHelpers = {
+    loom: typeof loomRef;
+    turn: typeof turnRef;
+    thread: typeof threadRef;
+    index: typeof indexRef;
+    encode: typeof encodeReference;
+    decode: typeof decodeReference;
+    parse: typeof parseReference;
+    toUrl: typeof referenceToUrl;
+    fromUrl: typeof referenceFromUrl;
+};
+export type OpenedReference<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown, TEntryMeta = unknown, TIndexMeta = unknown> = {
+    kind: "loom";
+    ref: Extract<LoomReference, {
+        kind: "loom";
+    }>;
+    loom: Loom<TPayload, TLoomMeta, TTurnMeta>;
+} | {
+    kind: "turn";
+    ref: Extract<LoomReference, {
+        kind: "turn";
+    }>;
+    loom: Loom<TPayload, TLoomMeta, TTurnMeta>;
+    turn: Turn<TPayload, TTurnMeta>;
+} | {
+    kind: "thread";
+    ref: Extract<LoomReference, {
+        kind: "thread";
+    }>;
+    loom: Loom<TPayload, TLoomMeta, TTurnMeta>;
+    thread: Turn<TPayload, TTurnMeta>[];
+    target: Turn<TPayload, TTurnMeta>;
+} | {
+    kind: "index";
+    ref: Extract<LoomReference, {
+        kind: "index";
+    }>;
+    index: LoomIndex<TEntryMeta, TIndexMeta>;
+};
+export interface LoomClient<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown, TEntryMeta = unknown, TIndexMeta = unknown> {
+    looms: Looms<TPayload, TLoomMeta, TTurnMeta>;
+    indexes: LoomIndexes<TEntryMeta, TIndexMeta>;
+    references: ReferenceHelpers;
+    openReference(ref: LoomReference): Promise<OpenedReference<TPayload, TLoomMeta, TTurnMeta, TEntryMeta, TIndexMeta>>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,OAAO,EACP,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,SAAS,CAAC;IACzB,KAAK,EAAE,OAAO,QAAQ,CAAC;IACvB,MAAM,EAAE,OAAO,eAAe,CAAC;IAC/B,MAAM,EAAE,OAAO,eAAe,CAAC;IAC/B,KAAK,EAAE,OAAO,cAAc,CAAC;IAC7B,KAAK,EAAE,OAAO,cAAc,CAAC;IAC7B,OAAO,EAAE,OAAO,gBAAgB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,CACzB,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO,IAElB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;CAC5C,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;CACjC,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IAChD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IACpC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;CACnC,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/C,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEN,MAAM,WAAW,UAAU,CACzB,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,OAAO,EACpB,UAAU,GAAG,OAAO;IAEpB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,CACX,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export type LoomErrorCode = "UNKNOWN_LOOM" | "UNKNOWN_INDEX" | "MISSING_PARENT" | "DUPLICATE_TURN_ID" | "DUPLICATE_LOOM_ID" | "INVALID_REFERENCE" | "INVALID_SNAPSHOT" | "CYCLE_DETECTED" | "BROKEN_TOPOLOGY" | "CLOSED_HANDLE";
+export declare class LoomError extends Error {
+    readonly code: LoomErrorCode;
+    constructor(code: LoomErrorCode, message: string);
+}
+export declare function unknownLoom(loomId: string): LoomError;
+export declare function unknownIndex(indexId: string): LoomError;
+export declare function missingParent(parentId: string): LoomError;
+export declare function duplicateTurnId(turnId: string): LoomError;
+export declare function duplicateLoomId(loomId: string): LoomError;
+export declare function invalidReference(message: string): LoomError;
+export declare function invalidSnapshot(message: string): LoomError;
+export declare function cycleDetected(turnId: string): LoomError;
+export declare function brokenTopology(message: string): LoomError;
+export declare function closedHandle(): LoomError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,CAAC;AAEpB,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAKjD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAErD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAEzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEzD;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/dist/errors.js

@@ -0,0 +1,39 @@
+export class LoomError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "LoomError";
+        this.code = code;
+    }
+}
+export function unknownLoom(loomId) {
+    return new LoomError("UNKNOWN_LOOM", `Unknown loom: ${loomId}`);
+}
+export function unknownIndex(indexId) {
+    return new LoomError("UNKNOWN_INDEX", `Unknown index: ${indexId}`);
+}
+export function missingParent(parentId) {
+    return new LoomError("MISSING_PARENT", `Missing parent turn: ${parentId}`);
+}
+export function duplicateTurnId(turnId) {
+    return new LoomError("DUPLICATE_TURN_ID", `Duplicate turn ID: ${turnId}`);
+}
+export function duplicateLoomId(loomId) {
+    return new LoomError("DUPLICATE_LOOM_ID", `Duplicate loom ID: ${loomId}`);
+}
+export function invalidReference(message) {
+    return new LoomError("INVALID_REFERENCE", message);
+}
+export function invalidSnapshot(message) {
+    return new LoomError("INVALID_SNAPSHOT", message);
+}
+export function cycleDetected(turnId) {
+    return new LoomError("CYCLE_DETECTED", `Cycle detected at turn: ${turnId}`);
+}
+export function brokenTopology(message) {
+    return new LoomError("BROKEN_TOPOLOGY", message);
+}
+export function closedHandle() {
+    return new LoomError("CLOSED_HANDLE", "This loom handle is closed");
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,SAAS,CAAC,cAAc,EAAE,iBAAiB,MAAM,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,SAAS,CAAC,eAAe,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,IAAI,SAAS,CAAC,gBAAgB,EAAE,wBAAwB,QAAQ,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,SAAS,CAAC,mBAAmB,EAAE,sBAAsB,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,SAAS,CAAC,mBAAmB,EAAE,sBAAsB,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,IAAI,SAAS,CAAC,gBAAgB,EAAE,2BAA2B,MAAM,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,SAAS,CAAC,eAAe,EAAE,4BAA4B,CAAC,CAAC;AACtE,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,119 @@
+export type LyncLineClass = "accepted" | "nonconforming" | "garbage" | "damaged" | "conflict-variant";
+export interface LyncEventBody {
+    v: number;
+    id: string;
+    kind: string;
+    at: string;
+    author: {
+        actor: string;
+        operator?: string;
+        imported_by?: string;
+        [key: string]: unknown;
+    };
+    parents: string[];
+    payload: Record<string, unknown>;
+    marked?: string;
+    critical?: boolean;
+    [key: string]: unknown;
+}
+export interface LyncLineDiagnostic {
+    file: string;
+    line: number;
+    class: LyncLineClass;
+    reason: string;
+    id?: string;
+    hasDigest?: boolean;
+    hasSig?: boolean;
+    duplicateSighting?: boolean;
+    metadataDisagreement?: boolean;
+    event?: LyncEventBody;
+    bytes: Uint8Array;
+    terminator: "" | "\n";
+    bodyBytes?: Uint8Array;
+    bodyDigest?: string;
+    digest?: string;
+    sig?: string;
+    nonconformingReasons?: string[];
+}
+export interface LyncConflictVariant {
+    id: string;
+    digest: string;
+    file: string;
+    line: number;
+    bytes: Uint8Array;
+    bodyBytes: Uint8Array;
+    event: LyncEventBody;
+}
+export interface LyncPendingDiagnostic {
+    missingParent: string;
+    digest: string;
+    file: string;
+    line: number;
+    id: string;
+    bytes: Uint8Array;
+}
+export interface LyncObstacle {
+    class: "cycle" | "dangling" | "unavailable-due-to-conflict";
+    ids?: string[];
+    missing?: string;
+    id?: string;
+}
+export interface LyncParseResult {
+    lines: LyncLineDiagnostic[];
+    unionEventIds: string[];
+    viewEligibleIds: string[];
+    conflictIds: string[];
+    conflictVariants: LyncConflictVariant[];
+    pending: LyncPendingDiagnostic[];
+    pendingOverflowCount: number;
+    suppression: {
+        suppressedPayloadIds: string[];
+        notSuppressedIds: string[];
+        danglingTargetNoEffectUntilUnion: string[];
+    };
+    graphDiagnostics: LyncObstacle[];
+}
+export type LyncUnionStatus = "added" | "duplicate" | "conflict" | "buffered" | "damaged" | "garbage";
+export interface LyncUnionIngestResult {
+    status: LyncUnionStatus;
+    line: LyncLineDiagnostic;
+    conflictVariants?: LyncConflictVariant[];
+    missingParent?: string;
+    drained?: LyncUnionIngestResult[];
+}
+export interface LyncUnionOptions {
+    pendingLimit?: number;
+}
+export declare class LyncUnion {
+    private readonly pendingLimit;
+    private readonly lines;
+    private readonly acceptedById;
+    private readonly conflictIds;
+    private readonly conflictVariants;
+    private readonly pendingByParent;
+    private pendingCount;
+    private pendingOverflowCount;
+    constructor(options?: LyncUnionOptions);
+    union(input: {
+        file: string;
+        bytes: Uint8Array | string;
+    }): LyncUnionIngestResult[];
+    result(): LyncParseResult;
+    private ingestParsedLine;
+    private acceptLine;
+    private markConflictVariant;
+    private bufferPending;
+    private drain;
+    private pending;
+}
+export declare function parseLyncFiles(inputs: {
+    file: string;
+    bytes: Uint8Array | string;
+}[]): LyncParseResult;
+export declare function exportCarriedLyncBytes(result: LyncParseResult): Uint8Array;
+export declare function lyncDownset(result: LyncParseResult, id: string): {
+    ids: string[];
+    partial: boolean;
+    obstacles: LyncObstacle[];
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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