@deepfates/lync 0.3.0

package/dist/synced-store.d.ts

@@ -0,0 +1,68 @@
+import type { EventStore } from "./store.js";
+import { type SyncFrame } from "./sync-protocol.js";
+/**
+ * Live sync for an EventStore, built on the dumb line-union protocol.
+ *
+ * A synced store is an ordinary EventStore: looms and indexes built over it
+ * recompute reactively through its existing `subscribe`, whether an event
+ * arrived from a local append or a remote peer. The decorator adds exactly
+ * two behaviors — local appends are pushed to the relay, and remote lines are
+ * ingested through the same `union` path — because immutable events plus
+ * union-by-id make redundancy harmless and merge logic unnecessary.
+ *
+ * The transport is abstract so this is testable without a socket. A
+ * browser-and-Node WebSocket transport is provided below with zero
+ * dependencies (global `WebSocket`, present in browsers and Node ≥ 21).
+ */
+export type SyncConnectionState = "connecting" | "online" | "offline";
+export interface SyncStatus {
+    connection: SyncConnectionState;
+    /** Roots that have received their backlog and are live. */
+    liveRoots: string[];
+    /** Ids that arrived as same-id-different-body conflicts, surfaced never resolved. */
+    conflicts: string[];
+    /**
+     * Every ingest failure, surfaced never swallowed: a remote line the local
+     * store could not durably accept (store write threw) or rejected as
+     * garbage. A store-write failure also freezes the root's resume cursor so
+     * the line is re-fetched on the next resubscribe instead of being skipped.
+     */
+    failures: string[];
+}
+export interface SyncTransport {
+    send(frame: SyncFrame): void;
+    /** Register a frame handler; returns an unsubscribe. */
+    onFrame(handler: (frame: SyncFrame) => void): () => void;
+    /** Fires on every (re)connection, so callers can re-subscribe. */
+    onOpen(handler: () => void): () => void;
+    onStateChange(handler: (state: SyncConnectionState) => void): () => void;
+    readonly state: SyncConnectionState;
+    close(): void;
+}
+export interface SyncedStoreOptions {
+    onStatus?: (status: SyncStatus) => void;
+    onPresence?: (root: string, data: unknown) => void;
+}
+export interface SyncedStore extends EventStore {
+    /** Begin syncing a root: push local backlog, then subscribe from the cursor. */
+    syncRoot(rootId: string): void;
+    /** Relay an ephemeral presence frame for a root; never stored. */
+    presence(root: string, data: unknown): void;
+    status(): SyncStatus;
+    close(): void;
+}
+export declare function createSyncedStore(inner: EventStore, transport: SyncTransport, options?: SyncedStoreOptions): SyncedStore;
+export interface WebSocketTransportOptions {
+    /** Override the WebSocket constructor (e.g. `ws` in Node < 21, or a fake in tests). */
+    WebSocketImpl?: typeof WebSocket;
+    /** Reconnect backoff in ms. Default 1500. Set 0 to disable auto-reconnect. */
+    reconnectMs?: number;
+}
+/**
+ * A reconnecting WebSocket transport. Sends while offline are queued and
+ * flushed on connect; a dropped socket schedules a reconnect and the synced
+ * store re-subscribes via `onOpen`. Nothing is silently dropped: an unsent
+ * frame waits in the queue rather than vanishing.
+ */
+export declare function createWebSocketTransport(url: string, options?: WebSocketTransportOptions): SyncTransport;
+//# sourceMappingURL=synced-store.d.ts.map

package/dist/synced-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synced-store.d.ts","sourceRoot":"","sources":["../src/synced-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAC;AAExE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,mBAAmB,CAAC;IAChC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qFAAqF;IACrF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD,kEAAkE;IAClE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACxC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,MAAM,IAAI,UAAU,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,aAAa,EACxB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CA8Nb;AAED,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,aAAa,CAmG5G"}

package/dist/synced-store.js

@@ -0,0 +1,340 @@
+import { decodeFrame, encodeFrame } from "./sync-protocol.js";
+export function createSyncedStore(inner, transport, options = {}) {
+    const syncedRoots = new Set();
+    const liveRoots = new Set();
+    const cursors = new Map();
+    const conflicts = new Set();
+    const failures = [];
+    // Server log generation per root. A cursor is only meaningful inside the
+    // generation that issued it (a failed relay disk write still consumes a
+    // seq, so a restarted server's recovered log can sit BEHIND our cursor).
+    // On a generation change the cursor resets to 0 and we resubscribe; union
+    // makes the re-download duplicate no-ops.
+    const generations = new Map();
+    // Roots whose cursor is frozen because a union failed (store write threw):
+    // the cursor must not advance past the hole, or the line would be skipped
+    // forever. Cleared on resync — the resubscribe re-fetches from the frozen
+    // cursor and each refetched line advances it again as its union succeeds.
+    const stalledRoots = new Set();
+    // Outstanding `sub` frames per root: each sub is answered by exactly one
+    // `live`, in order. While a generation-reset sub is stacked behind an
+    // earlier one (count > 1), cursor advances are suppressed — frames from the
+    // superseded sub carry seqs the reset backlog has not re-covered yet, and
+    // trusting them would re-poison the freshly reset cursor.
+    const pendingLives = new Map();
+    let connection = transport.state;
+    const emitStatus = () => {
+        options.onStatus?.({
+            connection,
+            liveRoots: [...liveRoots],
+            conflicts: [...conflicts],
+            failures: [...failures],
+        });
+    };
+    const pushLine = (root, line) => {
+        transport.send({ t: "ev", root, line });
+    };
+    const ensureSynced = (rootId) => {
+        if (syncedRoots.has(rootId))
+            return;
+        syncedRoots.add(rootId);
+        void resync(rootId);
+    };
+    // Push a locally-added event. If its root isn't synced yet, begin syncing —
+    // resync re-pushes the whole local backlog (this event included), so we must
+    // not also push it here, or the relay sees it twice.
+    const pushAdded = (event) => {
+        if (syncedRoots.has(event.root)) {
+            pushLine(event.root, event.bytes);
+        }
+        else {
+            ensureSynced(event.root);
+        }
+    };
+    async function resync(rootId) {
+        if (transport.state !== "online")
+            return; // resumes on the next onOpen
+        // Push any local events the relay may not have (offline appends included);
+        // duplicates are no-ops under union on the server.
+        for (const event of await inner.byRoot(rootId)) {
+            pushLine(rootId, event.bytes);
+        }
+        // A frozen cursor thaws here: the sub below re-fetches from it, and each
+        // refetched line advances it again as its union succeeds.
+        stalledRoots.delete(rootId);
+        // A fresh connection: any lives owed by subs on the dead connection will
+        // never arrive, so the count restarts at this sub's one.
+        pendingLives.set(rootId, 1);
+        transport.send({ t: "sub", root: rootId, since: cursors.get(rootId) ?? 0 });
+    }
+    transport.onOpen(() => {
+        for (const rootId of syncedRoots)
+            void resync(rootId);
+    });
+    transport.onStateChange((state) => {
+        connection = state;
+        if (state !== "online")
+            liveRoots.clear();
+        emitStatus();
+    });
+    /**
+     * Returns true when the server's generation differs from the one this root's
+     * cursor belongs to — 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
+     * servers) never trigger a reset.
+     */
+    const generationChanged = (root, gen) => {
+        if (gen === undefined)
+            return false;
+        const known = generations.get(root);
+        if (known === gen)
+            return false;
+        generations.set(root, gen);
+        if (known === undefined)
+            return false; // first sighting: adopt
+        failures.push(`generation changed for ${root} (${known} -> ${gen}); resyncing from 0`);
+        cursors.set(root, 0);
+        stalledRoots.delete(root);
+        pendingLives.set(root, (pendingLives.get(root) ?? 0) + 1);
+        emitStatus();
+        transport.send({ t: "sub", root, since: 0 });
+        return true;
+    };
+    const advanceCursor = (root, seq) => {
+        if (stalledRoots.has(root))
+            return; // frozen behind a failed union
+        if ((pendingLives.get(root) ?? 0) > 1)
+            return; // a reset-sub's backlog is still owed
+        cursors.set(root, Math.max(cursors.get(root) ?? 0, seq));
+    };
+    async function handleFrame(frame) {
+        switch (frame.t) {
+            case "ev": {
+                // Remote line: ingest through union WITHOUT re-pushing (the relay has
+                // already fanned it out). Subscribers fire via the inner store. The
+                // union is awaited and inspected BEFORE the cursor advances — a line
+                // the local store failed to accept must be re-fetched, never skipped.
+                generationChanged(frame.root, frame.gen);
+                let outcome;
+                try {
+                    outcome = await inner.union(frame.line);
+                }
+                catch (error) {
+                    // Store write failed: the line is NOT durable locally. Freeze the
+                    // cursor so the next resubscribe re-fetches it, and scream.
+                    failures.push(`store failed to ingest a synced line for ${frame.root}: ${String(error)}`);
+                    stalledRoots.add(frame.root);
+                    emitStatus();
+                    return;
+                }
+                switch (outcome.status) {
+                    case "conflict":
+                        conflicts.add(outcome.event.body.id);
+                        emitStatus();
+                        break;
+                    case "garbage":
+                        // Unusable bytes stay unusable on any re-fetch: surfaced loudly,
+                        // and the cursor may advance past them.
+                        failures.push(`synced line rejected as garbage for ${frame.root}: ${outcome.reason}`);
+                        emitStatus();
+                        break;
+                    default:
+                        break; // added / duplicate / buffered: durably in the store's hands
+                }
+                if (typeof frame.seq === "number")
+                    advanceCursor(frame.root, frame.seq);
+                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 a
+                // generation reset has since superseded. Wait for the real one.
+                const changed = generationChanged(frame.root, frame.gen);
+                const outstanding = Math.max(0, (pendingLives.get(frame.root) ?? 1) - 1);
+                pendingLives.set(frame.root, outstanding);
+                if (changed || outstanding > 0)
+                    return;
+                advanceCursor(frame.root, frame.seq);
+                liveRoots.add(frame.root);
+                emitStatus();
+                return;
+            }
+            case "presence": {
+                options.onPresence?.(frame.root, frame.data);
+                return;
+            }
+            case "err": {
+                if (frame.reason === "same-id-conflict" && frame.detail) {
+                    conflicts.add(frame.detail);
+                }
+                else {
+                    // Every other relay-side failure — persist-failed, conflict-persist-failed,
+                    // recovered-damaged-tail, line-without-id, unexpected-live-from-client,
+                    // server-error — is a failure the client must see, never a silent drop.
+                    // A durability failure on the relay reaches the client's status channel.
+                    const where = frame.root ? ` for ${frame.root}` : "";
+                    const detail = frame.detail ? ` (${frame.detail})` : "";
+                    failures.push(`relay error${where}: ${frame.reason}${detail}`);
+                }
+                emitStatus();
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    // Frames apply strictly in arrival order: each union is awaited before the
+    // next frame is touched, so a slow union can never let a later frame (or a
+    // `live` cursor jump) leapfrog a failure. handleFrame never rejects — the
+    // catch above is the only throw path and it returns — but the chain guards
+    // anyway so one surprise cannot wedge sync forever.
+    let frameChain = Promise.resolve();
+    transport.onFrame((frame) => {
+        frameChain = frameChain.then(() => handleFrame(frame), () => handleFrame(frame));
+    });
+    return {
+        async append(ev) {
+            const result = await inner.append(ev);
+            if (result.status === "added")
+                pushAdded(result.event);
+            return result;
+        },
+        async union(line) {
+            const result = await inner.union(line);
+            if (result.status === "added")
+                pushAdded(result.event);
+            return result;
+        },
+        byId: (id) => inner.byId(id),
+        byRoot: (rootId) => {
+            ensureSynced(rootId);
+            return inner.byRoot(rootId);
+        },
+        subscribe: (rootId, listener) => {
+            ensureSynced(rootId);
+            return inner.subscribe(rootId, listener);
+        },
+        roots: (kind) => inner.roots(kind),
+        ...(inner.exportRootBytes ? { exportRootBytes: (rootId) => inner.exportRootBytes(rootId) } : {}),
+        ...(inner.diagnostics ? { diagnostics: () => inner.diagnostics() } : {}),
+        syncRoot: ensureSynced,
+        presence: (root, data) => transport.send({ t: "presence", root, data }),
+        status: () => ({ connection, liveRoots: [...liveRoots], conflicts: [...conflicts], failures: [...failures] }),
+        close: () => transport.close(),
+    };
+}
+/**
+ * A reconnecting WebSocket transport. Sends while offline are queued and
+ * flushed on connect; a dropped socket schedules a reconnect and the synced
+ * store re-subscribes via `onOpen`. Nothing is silently dropped: an unsent
+ * frame waits in the queue rather than vanishing.
+ */
+export function createWebSocketTransport(url, options = {}) {
+    const WS = options.WebSocketImpl ?? globalThis.WebSocket;
+    if (!WS) {
+        throw new Error("createWebSocketTransport: no WebSocket implementation available; pass options.WebSocketImpl");
+    }
+    const reconnectMs = options.reconnectMs ?? 1500;
+    const frameHandlers = new Set();
+    const openHandlers = new Set();
+    const stateHandlers = new Set();
+    const queue = [];
+    let socket;
+    let state = "connecting";
+    let closed = false;
+    let reconnectTimer;
+    const setState = (next) => {
+        if (state === next)
+            return;
+        state = next;
+        for (const handler of stateHandlers)
+            handler(next);
+    };
+    const connect = () => {
+        if (closed)
+            return;
+        setState("connecting");
+        const ws = new WS(url);
+        socket = ws;
+        ws.addEventListener("open", () => {
+            if (socket !== ws)
+                return;
+            setState("online");
+            while (queue.length > 0)
+                ws.send(encodeFrame(queue.shift()));
+            for (const handler of openHandlers)
+                handler();
+        });
+        ws.addEventListener("message", (event) => {
+            if (socket !== ws)
+                return;
+            const raw = typeof event.data === "string" ? event.data : String(event.data);
+            const frame = decodeFrame(raw);
+            for (const handler of frameHandlers)
+                handler(frame);
+        });
+        ws.addEventListener("close", () => {
+            if (socket !== ws)
+                return;
+            socket = undefined;
+            setState("offline");
+            scheduleReconnect();
+        });
+        ws.addEventListener("error", () => {
+            if (socket !== ws)
+                return;
+            // A failed connection surfaces as a close on most stacks; force it.
+            try {
+                ws.close();
+            }
+            catch {
+                socket = undefined;
+                setState("offline");
+                scheduleReconnect();
+            }
+        });
+    };
+    const scheduleReconnect = () => {
+        if (closed || reconnectMs <= 0 || reconnectTimer)
+            return;
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = undefined;
+            connect();
+        }, reconnectMs);
+    };
+    connect();
+    return {
+        send(frame) {
+            if (socket && state === "online" && socket.readyState === socket.OPEN) {
+                socket.send(encodeFrame(frame));
+            }
+            else {
+                queue.push(frame);
+            }
+        },
+        onFrame(handler) {
+            frameHandlers.add(handler);
+            return () => frameHandlers.delete(handler);
+        },
+        onOpen(handler) {
+            openHandlers.add(handler);
+            return () => openHandlers.delete(handler);
+        },
+        onStateChange(handler) {
+            stateHandlers.add(handler);
+            return () => stateHandlers.delete(handler);
+        },
+        get state() {
+            return state;
+        },
+        close() {
+            closed = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            socket?.close();
+            socket = undefined;
+            setState("offline");
+        },
+    };
+}
+//# sourceMappingURL=synced-store.js.map

package/dist/synced-store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export type LoomId = string;
+export type TurnId = string;
+export type IndexId = string;
+export interface LoomInfo<TMeta = unknown> {
+    id: LoomId;
+    meta?: TMeta;
+    createdAt: number;
+}
+export interface Turn<TPayload = unknown, TMeta = unknown> {
+    id: TurnId;
+    loomId: LoomId;
+    parentId: TurnId | null;
+    payload: TPayload;
+    meta?: TMeta;
+    createdAt: number;
+}
+export interface LoomSnapshot<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown> {
+    loom: LoomInfo<TLoomMeta>;
+    turns: Turn<TPayload, TTurnMeta>[];
+}
+export type LoomReference = {
+    v: 1;
+    kind: "loom";
+    loomId: LoomId;
+} | {
+    v: 1;
+    kind: "turn";
+    loomId: LoomId;
+    turnId: TurnId;
+} | {
+    v: 1;
+    kind: "thread";
+    loomId: LoomId;
+    turnId: TurnId;
+} | {
+    v: 1;
+    kind: "index";
+    indexId: IndexId;
+};
+export type LoomEvent<TPayload, TLoomMeta, TTurnMeta> = {
+    type: "turn-added";
+    loomId: LoomId;
+    turn: Turn<TPayload, TTurnMeta>;
+} | {
+    type: "loom-updated";
+    loom: LoomInfo<TLoomMeta>;
+} | {
+    type: "sync-state";
+    loomId: LoomId;
+    online: boolean;
+    syncing: boolean;
+};
+export type LoomListener<TPayload, TLoomMeta, TTurnMeta> = (event: LoomEvent<TPayload, TLoomMeta, TTurnMeta>) => void;
+export interface Loom<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown> {
+    id: LoomId;
+    info(): Promise<LoomInfo<TLoomMeta>>;
+    updateMeta(meta: TLoomMeta): Promise<LoomInfo<TLoomMeta>>;
+    appendTurn(parentId: TurnId | null, payload: TPayload, meta?: TTurnMeta): Promise<Turn<TPayload, TTurnMeta>>;
+    getTurn(turnId: TurnId): Promise<Turn<TPayload, TTurnMeta> | null>;
+    hasTurn(turnId: TurnId): Promise<boolean>;
+    childrenOf(parentId: TurnId | null): Promise<Turn<TPayload, TTurnMeta>[]>;
+    threadTo(turnId: TurnId): Promise<Turn<TPayload, TTurnMeta>[]>;
+    leaves(): Promise<Turn<TPayload, TTurnMeta>[]>;
+    subscribe(listener: LoomListener<TPayload, TLoomMeta, TTurnMeta>): () => void;
+    export(): Promise<LoomSnapshot<TPayload, TLoomMeta, TTurnMeta>>;
+    close(): void;
+}
+export interface Looms<TPayload = unknown, TLoomMeta = unknown, TTurnMeta = unknown> {
+    create(meta?: TLoomMeta): Promise<LoomInfo<TLoomMeta>>;
+    get(loomId: LoomId): Promise<LoomInfo<TLoomMeta> | null>;
+    open(loomId: LoomId): Promise<Loom<TPayload, TLoomMeta, TTurnMeta>>;
+    import(snapshot: LoomSnapshot<TPayload, TLoomMeta, TTurnMeta>): Promise<LoomInfo<TLoomMeta>>;
+}
+export interface MemoryLoomsOptions {
+    createId?: () => string;
+    now?: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/uuid.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UUIDv7 minting for lync writers. FORMAT.md makes UUID ids a writer
+ * obligation: generators mint UUIDv7 (time-ordered, unique per generation);
+ * importers transcribing pre-existing events may instead derive deterministic
+ * UUIDv8 from source identity. Zero dependencies; uses the Web Crypto global
+ * available in browsers and Node.
+ */
+export declare function uuidv7(now?: number): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,MAAM,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAgBvD"}

package/dist/uuid.js

@@ -0,0 +1,25 @@
+/**
+ * UUIDv7 minting for lync writers. FORMAT.md makes UUID ids a writer
+ * obligation: generators mint UUIDv7 (time-ordered, unique per generation);
+ * importers transcribing pre-existing events may instead derive deterministic
+ * UUIDv8 from source identity. Zero dependencies; uses the Web Crypto global
+ * available in browsers and Node.
+ */
+export function uuidv7(now = Date.now()) {
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    // 48-bit big-endian unix-ms timestamp.
+    const ms = BigInt(now);
+    bytes[0] = Number((ms >> 40n) & 0xffn);
+    bytes[1] = Number((ms >> 32n) & 0xffn);
+    bytes[2] = Number((ms >> 24n) & 0xffn);
+    bytes[3] = Number((ms >> 16n) & 0xffn);
+    bytes[4] = Number((ms >> 8n) & 0xffn);
+    bytes[5] = Number(ms & 0xffn);
+    // Version 7 in the high nibble of byte 6; RFC 4122 variant in byte 8.
+    bytes[6] = (bytes[6] & 0x0f) | 0x70;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+//# sourceMappingURL=uuid.js.map

package/dist/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,MAAM,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IAC7C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,uCAAuC;IACvC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;IACtC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IAC9B,sEAAsE;IACtE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC"}

package/dist/views.d.ts

@@ -0,0 +1,78 @@
+import { type LyncEventBody, type LyncLineDiagnostic, type LyncObstacle, type LyncParseResult } from "./events.js";
+export interface LyncViewEvent {
+    id: string;
+    event: LyncEventBody;
+    line: LyncLineDiagnostic;
+    payloadSuppressed: boolean;
+}
+export interface LyncBranchTreeNode extends LyncViewEvent {
+    parents: string[];
+    children: string[];
+    missingParents: string[];
+    conflictedParents: string[];
+}
+export interface LyncBranchTreeView {
+    nodes: LyncBranchTreeNode[];
+    roots: string[];
+    leaves: string[];
+    obstacles: LyncObstacle[];
+    partial: boolean;
+}
+export interface LyncTranscriptEntry extends LyncViewEvent {
+    depth: number;
+}
+export interface LyncTranscriptView {
+    head: string;
+    entries: LyncTranscriptEntry[];
+    downsetIds: string[];
+    obstacles: LyncObstacle[];
+    partial: boolean;
+}
+export interface LyncMemoryView {
+    events: LyncViewEvent[];
+    frontierIds: string[];
+    suppressedPayloadIds: string[];
+    conflictIds: string[];
+    obstacles: LyncObstacle[];
+    partial: boolean;
+}
+export interface LyncScoreReference {
+    annotationId: string;
+    value: number;
+    author: LyncEventBody["author"];
+    at: string;
+    basis?: unknown;
+}
+export interface LyncSelectionReference {
+    annotationId: string;
+    selected: boolean;
+    chosen: string[];
+    shown: string[];
+    author: LyncEventBody["author"];
+    at: string;
+    basis?: unknown;
+}
+export interface LyncLeaderboardEntry {
+    targetId: string;
+    event?: LyncViewEvent;
+    scoreTotal: number;
+    scoreCount: number;
+    scoreMean: number | null;
+    selectedCount: number;
+    selectionCount: number;
+    scores: LyncScoreReference[];
+    selections: LyncSelectionReference[];
+    rank: number;
+}
+export interface LyncLeaderboardView {
+    entries: LyncLeaderboardEntry[];
+    ignoredAnnotationIds: string[];
+}
+export interface LyncTranscriptOptions {
+    chooseParent?: (event: LyncEventBody, candidates: string[]) => string | undefined;
+}
+export declare function lyncBranchTreeView(result: LyncParseResult): LyncBranchTreeView;
+export declare function lyncTranscriptView(result: LyncParseResult, head: string, options?: LyncTranscriptOptions): LyncTranscriptView;
+export declare function lyncMemoryView(result: LyncParseResult): LyncMemoryView;
+export declare function lyncLeaderboardView(result: LyncParseResult): LyncLeaderboardView;
+//# sourceMappingURL=views.d.ts.map

package/dist/views.d.ts.map

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