@deepfates/lync 0.3.0

package/dist/store.d.ts

@@ -0,0 +1,97 @@
+import type { LyncEventBody } from "./events.js";
+export interface StoredEvent {
+    body: LyncEventBody;
+    bytes: string;
+    root: string;
+}
+export type AppendResult = {
+    status: "added";
+    event: StoredEvent;
+} | {
+    status: "duplicate";
+    event: StoredEvent;
+} | {
+    status: "buffered";
+    missingParent: string;
+    bytes: string;
+} | {
+    status: "conflict";
+    event: StoredEvent;
+    conflictWith: StoredEvent;
+} | {
+    status: "garbage";
+    reason: string;
+    bytes: string;
+};
+export interface EventStore {
+    append(ev: LyncEventBody): Promise<AppendResult>;
+    union(line: string): Promise<AppendResult>;
+    byId(id: string): Promise<StoredEvent | null>;
+    byRoot(rootId: string): Promise<StoredEvent[]>;
+    subscribe(rootId: string, listener: (ev: StoredEvent) => void): () => void;
+    roots(kind?: "lync/loom" | "lync/index"): Promise<StoredEvent[]>;
+    exportRootBytes?(rootId: string): Promise<string>;
+    diagnostics?(): Promise<EventStoreDiagnostics>;
+}
+export interface EventStoreDiagnostics {
+    events: number;
+    conflicts: number;
+    pending: number;
+    garbage: number;
+}
+export interface StoreRecord {
+    id: string;
+    root: string;
+    kind: string;
+    at: string;
+    bytes: string;
+}
+export interface ConflictRecord {
+    id: string;
+    digest: string;
+    root: string;
+    bytes: string;
+}
+export interface PendingRecord {
+    missingParent: string;
+    digest: string;
+    bytes: string;
+}
+export interface GarbageRecord {
+    reason: string;
+    bytes: string;
+}
+export declare abstract class BaseEventStore implements EventStore {
+    protected readonly events: Map<string, StoredEvent>;
+    protected readonly conflicts: Map<string, ConflictRecord>;
+    protected readonly pending: Map<string, PendingRecord>;
+    protected readonly garbage: GarbageRecord[];
+    private readonly listeners;
+    append(ev: LyncEventBody): Promise<AppendResult>;
+    union(line: string): Promise<AppendResult>;
+    byId(id: string): Promise<StoredEvent | null>;
+    byRoot(rootId: string): Promise<StoredEvent[]>;
+    subscribe(rootId: string, listener: (ev: StoredEvent) => void): () => void;
+    roots(kind?: "lync/loom" | "lync/index"): Promise<StoredEvent[]>;
+    exportRootBytes(rootId: string): Promise<string>;
+    diagnostics(): Promise<EventStoreDiagnostics>;
+    protected loadRecords(records: {
+        events?: StoreRecord[];
+        conflicts?: ConflictRecord[];
+        pending?: PendingRecord[];
+        garbage?: GarbageRecord[];
+    }): Promise<void>;
+    protected dumpRecords(): {
+        events: StoreRecord[];
+        conflicts: ConflictRecord[];
+        pending: PendingRecord[];
+        garbage: GarbageRecord[];
+    };
+    protected persist(): Promise<void>;
+    private ingest;
+    private drain;
+    private emit;
+    private isConflicted;
+}
+export declare function serializeLyncEvent(ev: LyncEventBody): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,250 @@
+import { parseLyncFiles } from "./events.js";
+import { sha256Hex } from "./sha256.js";
+export class BaseEventStore {
+    events = new Map();
+    conflicts = new Map();
+    pending = new Map();
+    garbage = [];
+    listeners = new Map();
+    async append(ev) {
+        return this.ingest(serializeLyncEvent(ev), false);
+    }
+    async union(line) {
+        return this.ingest(line, true);
+    }
+    async byId(id) {
+        return this.isConflicted(id) ? null : (this.events.get(id) ?? null);
+    }
+    async byRoot(rootId) {
+        return [...this.events.values()]
+            .filter((event) => event.root === rootId && !this.isConflicted(event.body.id))
+            .sort(compareStored);
+    }
+    subscribe(rootId, listener) {
+        const set = this.listeners.get(rootId) ?? new Set();
+        set.add(listener);
+        this.listeners.set(rootId, set);
+        return () => set.delete(listener);
+    }
+    async roots(kind) {
+        return [...this.events.values()]
+            .filter((event) => !this.isConflicted(event.body.id))
+            .filter((event) => event.body.id === event.root)
+            .filter((event) => event.body.kind === "lync/loom" || event.body.kind === "lync/index")
+            .filter((event) => kind === undefined || event.body.kind === kind)
+            .sort(compareStored);
+    }
+    async exportRootBytes(rootId) {
+        const events = await this.byRoot(rootId);
+        return events.map((event) => event.bytes).join("\n") + (events.length ? "\n" : "");
+    }
+    async diagnostics() {
+        return {
+            events: this.events.size,
+            conflicts: this.conflicts.size,
+            pending: this.pending.size,
+            garbage: this.garbage.length,
+        };
+    }
+    async loadRecords(records) {
+        for (const record of records.events ?? []) {
+            const parsed = parseStoredLine(record.bytes);
+            if (parsed.ok)
+                this.events.set(parsed.event.body.id, { ...parsed.event, root: record.root });
+        }
+        for (const record of records.conflicts ?? []) {
+            this.conflicts.set(conflictKey(record.id, record.digest), record);
+        }
+        for (const record of records.pending ?? []) {
+            this.pending.set(pendingKey(record.missingParent, record.digest), record);
+        }
+        this.garbage.push(...(records.garbage ?? []));
+    }
+    dumpRecords() {
+        return {
+            events: [...this.events.values()].map((event) => ({
+                id: event.body.id,
+                root: event.root,
+                kind: event.body.kind,
+                at: event.body.at,
+                bytes: event.bytes,
+            })),
+            conflicts: [...this.conflicts.values()],
+            pending: [...this.pending.values()],
+            garbage: [...this.garbage],
+        };
+    }
+    async persist() { }
+    async ingest(line, allowBuffer) {
+        const parsed = parseStoredLine(line);
+        if (!parsed.ok) {
+            const result = { status: "garbage", reason: parsed.reason, bytes: line };
+            this.garbage.push({ reason: parsed.reason, bytes: line });
+            await this.persist();
+            return result;
+        }
+        const body = parsed.event.body;
+        const known = validateKnownLyncEvent(body);
+        if (known !== null) {
+            const result = { status: "garbage", reason: known, bytes: line };
+            this.garbage.push({ reason: known, bytes: line });
+            await this.persist();
+            return result;
+        }
+        const parent = body.parents[0];
+        const root = body.parents.length === 0
+            ? body.id
+            : this.events.get(parent)?.root;
+        if (root === undefined) {
+            if (!allowBuffer) {
+                const result = { status: "garbage", reason: `missing parent: ${parent}`, bytes: line };
+                this.garbage.push({ reason: result.reason, bytes: line });
+                await this.persist();
+                return result;
+            }
+            const record = { missingParent: parent, digest: bodyDigest(parsed.bodyBytes), bytes: line };
+            this.pending.set(pendingKey(record.missingParent, record.digest), record);
+            await this.persist();
+            return { status: "buffered", missingParent: parent, bytes: line };
+        }
+        const event = { ...parsed.event, root };
+        const existing = this.events.get(body.id);
+        if (existing) {
+            if (stripSplice(existing.bytes) === stripSplice(line)) {
+                if (isRicherLine(line, existing.bytes)) {
+                    this.events.set(body.id, event);
+                    await this.persist();
+                }
+                return { status: "duplicate", event: this.events.get(body.id) };
+            }
+            const digest = bodyDigest(parsed.bodyBytes);
+            const existingDigest = bodyDigest(new TextEncoder().encode(stripSplice(existing.bytes)));
+            this.conflicts.set(conflictKey(existing.body.id, existingDigest), {
+                id: existing.body.id,
+                digest: existingDigest,
+                root: existing.root,
+                bytes: existing.bytes,
+            });
+            this.conflicts.set(conflictKey(body.id, digest), { id: body.id, digest, root, bytes: line });
+            await this.persist();
+            return { status: "conflict", event, conflictWith: existing };
+        }
+        this.events.set(body.id, event);
+        await this.persist();
+        this.emit(event);
+        await this.drain(body.id);
+        return { status: "added", event };
+    }
+    async drain(parentId) {
+        let progressed = true;
+        while (progressed) {
+            progressed = false;
+            for (const record of [...this.pending.values()].filter((item) => item.missingParent === parentId)) {
+                this.pending.delete(pendingKey(record.missingParent, record.digest));
+                await this.ingest(record.bytes, true);
+                progressed = true;
+            }
+        }
+    }
+    emit(event) {
+        for (const listener of this.listeners.get(event.root) ?? [])
+            listener(event);
+    }
+    isConflicted(id) {
+        for (const conflict of this.conflicts.values())
+            if (conflict.id === id)
+                return true;
+        return false;
+    }
+}
+export function serializeLyncEvent(ev) {
+    const fields = [
+        ["v", ev.v],
+        ["id", ev.id],
+        ["kind", ev.kind],
+        ["at", ev.at],
+        ["author", ev.author],
+        ["parents", ev.parents],
+        ["payload", ev.payload],
+    ];
+    if (ev.marked !== undefined)
+        fields.push(["marked", ev.marked]);
+    if (ev.critical !== undefined)
+        fields.push(["critical", ev.critical]);
+    return `{${fields.map(([key, value]) => `${JSON.stringify(key)}:${JSON.stringify(value)}`).join(",")}}`;
+}
+function parseStoredLine(line) {
+    const normalized = line.endsWith("\n") ? line.slice(0, -1) : line;
+    const parsed = parseLyncFiles([{ file: "<store>", bytes: `${normalized}\n` }]);
+    const diagnostic = parsed.lines[0];
+    if (!diagnostic?.event || (diagnostic.class !== "accepted" && diagnostic.class !== "nonconforming")) {
+        return { ok: false, reason: diagnostic?.reason ?? "unparseable lync line" };
+    }
+    return {
+        ok: true,
+        event: { body: diagnostic.event, bytes: normalized, root: diagnostic.event.id },
+        bodyBytes: diagnostic.bodyBytes ?? new TextEncoder().encode(stripSplice(normalized)),
+    };
+}
+function validateKnownLyncEvent(body) {
+    if (!body.kind.startsWith("lync/"))
+        return null;
+    if (body.kind === "lync/loom" || body.kind === "lync/index") {
+        return body.parents.length === 0 ? null : `${body.kind} must not have parents`;
+    }
+    if (body.kind === "lync/turn") {
+        if (body.parents.length !== 1)
+            return "lync/turn must have exactly one parent";
+        if (!Number.isInteger(body.payload.ordinal) || body.payload.ordinal < 0) {
+            return "lync/turn payload.ordinal must be a non-negative integer";
+        }
+        if (!("payload" in body.payload))
+            return "lync/turn payload.payload is required";
+        return null;
+    }
+    if (body.kind === "lync/loom-meta") {
+        if (body.parents.length !== 1)
+            return "lync/loom-meta must have exactly one parent";
+        if (!("meta" in body.payload))
+            return "lync/loom-meta payload.meta is required";
+        return null;
+    }
+    if (body.kind === "lync/index-meta") {
+        if (body.parents.length !== 1)
+            return "lync/index-meta must have exactly one parent";
+        if (!("meta" in body.payload))
+            return "lync/index-meta payload.meta is required";
+        return null;
+    }
+    if (body.kind === "lync/index-entry") {
+        if (body.parents.length !== 1)
+            return "lync/index-entry must have exactly one parent";
+        if (typeof body.payload.loomId !== "string")
+            return "lync/index-entry payload.loomId is required";
+        if ("ordinal" in body.payload && (!Number.isInteger(body.payload.ordinal) || body.payload.ordinal < 0)) {
+            return "lync/index-entry payload.ordinal must be a non-negative integer";
+        }
+        return null;
+    }
+    return null;
+}
+function compareStored(a, b) {
+    return a.body.at.localeCompare(b.body.at) || a.body.id.localeCompare(b.body.id);
+}
+function stripSplice(line) {
+    return line.replace(/,"digest":"sha256:[0-9a-f]{64}"(?:,"sig":"[A-Za-z0-9+/]+={0,2}")?}$/, "}");
+}
+function bodyDigest(bytes) {
+    return sha256Hex(bytes);
+}
+function conflictKey(id, digest) {
+    return `${id}\0${digest}`;
+}
+function pendingKey(missingParent, digest) {
+    return `${missingParent}\0${digest}`;
+}
+function isRicherLine(candidate, current) {
+    const score = (line) => (line.includes(',"digest"') ? 1 : 0) + (line.includes(',"sig"') ? 1 : 0);
+    return score(candidate) > score(current);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/sync-protocol.d.ts

@@ -0,0 +1,80 @@
+/**
+ * The lync line-sync protocol: a dumb event-union relay.
+ *
+ * Events are immutable and merge is union by id, so the protocol has no
+ * merge logic at all — it moves canonical line bytes between peers and lets
+ * union make redundancy harmless. Five frame kinds:
+ *
+ *   client → server   {"t":"sub",  "root": string, "since": number}
+ *   server → client   {"t":"ev",   "root": string, "seq": number, "line": string, "gen"?: string}
+ *   server → client   {"t":"live", "root": string, "seq": number, "gen"?: string}
+ *   client → server   {"t":"ev",   "root": string, "line": string}
+ *   either direction  {"t":"presence", "root": string, "data"?: unknown}
+ *   either direction  {"t":"err",  "root"?: string, "reason": string, "detail"?: string}
+ *
+ * `seq` is the server's own per-root arrival counter — a resume cursor, not
+ * event order. The server echoes accepted events to every subscriber of the
+ * root, sender included; echoes are duplicate no-ops under union and still
+ * advance the cursor. This module is pure: frame codecs and guards only.
+ *
+ * `gen` is the server's log GENERATION: a random id minted every time a room
+ * is recovered from disk (so every server restart is a new generation). A
+ * cursor is only meaningful inside the generation that issued it — a broadcast
+ * whose disk write failed still consumes a seq, so after a restart the
+ * recovered log can sit BEHIND a client's saved cursor and the client would
+ * silently skip the next persisted event forever. A client that sees `gen`
+ * change from what its cursor was saved under must reset to 0 and resync from
+ * scratch; union makes the re-download a harmless set of duplicate no-ops.
+ * The field is additive: frames without it (old servers) decode fine, and old
+ * clients ignore it.
+ */
+export interface SubFrame {
+    t: "sub";
+    root: string;
+    since: number;
+}
+export interface EvFrame {
+    t: "ev";
+    root: string;
+    line: string;
+    seq?: number;
+    /** Server log generation (see module doc). Absent from old servers and client→server frames. */
+    gen?: string;
+}
+export interface LiveFrame {
+    t: "live";
+    root: string;
+    seq: number;
+    /** Server log generation (see module doc). Absent from old servers. */
+    gen?: string;
+}
+export interface PresenceFrame {
+    t: "presence";
+    root: string;
+    data?: unknown;
+}
+export interface ErrFrame {
+    t: "err";
+    root?: string;
+    reason: string;
+    detail?: string;
+}
+export type SyncFrame = SubFrame | EvFrame | LiveFrame | PresenceFrame | ErrFrame;
+/**
+ * A resume cursor / sequence number: a nonnegative integer. Fractional or
+ * non-finite values must never pass — they index into backlogs downstream.
+ */
+export declare function isCursor(value: unknown): value is number;
+export declare function encodeFrame(frame: SyncFrame): string;
+/**
+ * Decode one frame. Returns an ErrFrame (never throws) on anything
+ * malformed, so transport code stays loud without try/catch pyramids.
+ */
+export declare function decodeFrame(raw: string | Uint8Array): SyncFrame;
+/**
+ * Extract the event id from a canonical line without trusting anything else
+ * in it. The relay never parses beyond this. Returns undefined when no id
+ * can be extracted — callers surface that loudly, never drop it silently.
+ */
+export declare function extractLineId(line: string): string | undefined;
+//# sourceMappingURL=sync-protocol.d.ts.map

package/dist/sync-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-protocol.d.ts","sourceRoot":"","sources":["../src/sync-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,KAAK,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,IAAI,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,UAAU,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,KAAK,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;AAIlF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAsE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU9D"}

package/dist/sync-protocol.js

@@ -0,0 +1,135 @@
+/**
+ * The lync line-sync protocol: a dumb event-union relay.
+ *
+ * Events are immutable and merge is union by id, so the protocol has no
+ * merge logic at all — it moves canonical line bytes between peers and lets
+ * union make redundancy harmless. Five frame kinds:
+ *
+ *   client → server   {"t":"sub",  "root": string, "since": number}
+ *   server → client   {"t":"ev",   "root": string, "seq": number, "line": string, "gen"?: string}
+ *   server → client   {"t":"live", "root": string, "seq": number, "gen"?: string}
+ *   client → server   {"t":"ev",   "root": string, "line": string}
+ *   either direction  {"t":"presence", "root": string, "data"?: unknown}
+ *   either direction  {"t":"err",  "root"?: string, "reason": string, "detail"?: string}
+ *
+ * `seq` is the server's own per-root arrival counter — a resume cursor, not
+ * event order. The server echoes accepted events to every subscriber of the
+ * root, sender included; echoes are duplicate no-ops under union and still
+ * advance the cursor. This module is pure: frame codecs and guards only.
+ *
+ * `gen` is the server's log GENERATION: a random id minted every time a room
+ * is recovered from disk (so every server restart is a new generation). A
+ * cursor is only meaningful inside the generation that issued it — a broadcast
+ * whose disk write failed still consumes a seq, so after a restart the
+ * recovered log can sit BEHIND a client's saved cursor and the client would
+ * silently skip the next persisted event forever. A client that sees `gen`
+ * change from what its cursor was saved under must reset to 0 and resync from
+ * scratch; union makes the re-download a harmless set of duplicate no-ops.
+ * The field is additive: frames without it (old servers) decode fine, and old
+ * clients ignore it.
+ */
+const FRAME_KINDS = new Set(["sub", "ev", "live", "presence", "err"]);
+/**
+ * A resume cursor / sequence number: a nonnegative integer. Fractional or
+ * non-finite values must never pass — they index into backlogs downstream.
+ */
+export function isCursor(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+export function encodeFrame(frame) {
+    return JSON.stringify(frame);
+}
+/**
+ * Decode one frame. Returns an ErrFrame (never throws) on anything
+ * malformed, so transport code stays loud without try/catch pyramids.
+ */
+export function decodeFrame(raw) {
+    const text = typeof raw === "string" ? raw : new TextDecoder().decode(raw);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        return { t: "err", reason: "malformed-frame", detail: String(error) };
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { t: "err", reason: "malformed-frame", detail: "frame is not an object" };
+    }
+    const frame = value;
+    if (typeof frame.t !== "string" || !FRAME_KINDS.has(frame.t)) {
+        return { t: "err", reason: "unknown-frame-kind", detail: String(frame.t) };
+    }
+    switch (frame.t) {
+        case "sub":
+            // Cursors are array indices and resume positions: a fractional or
+            // non-finite `since` silently skips the backlog downstream (lines[0.5]
+            // is undefined), so anything but a nonnegative integer is malformed.
+            if (typeof frame.root !== "string" || !isCursor(frame.since)) {
+                return { t: "err", reason: "malformed-sub" };
+            }
+            return { t: "sub", root: frame.root, since: frame.since };
+        case "ev":
+            if (typeof frame.root !== "string" || typeof frame.line !== "string") {
+                return { t: "err", reason: "malformed-ev" };
+            }
+            if (frame.seq !== undefined && !isCursor(frame.seq)) {
+                return { t: "err", reason: "malformed-ev", detail: "seq must be a nonnegative integer" };
+            }
+            // gen is additive: absence is fine (old peers). Present-but-not-a-string
+            // is malformed — a client resetting its cursor over garbage would be
+            // acting on noise.
+            if (frame.gen !== undefined && typeof frame.gen !== "string") {
+                return { t: "err", reason: "malformed-ev", detail: "gen must be a string" };
+            }
+            return {
+                t: "ev",
+                root: frame.root,
+                line: frame.line,
+                ...(frame.seq !== undefined ? { seq: frame.seq } : {}),
+                ...(frame.gen !== undefined ? { gen: frame.gen } : {}),
+            };
+        case "live":
+            if (typeof frame.root !== "string" || !isCursor(frame.seq)) {
+                return { t: "err", reason: "malformed-live" };
+            }
+            if (frame.gen !== undefined && typeof frame.gen !== "string") {
+                return { t: "err", reason: "malformed-live", detail: "gen must be a string" };
+            }
+            return {
+                t: "live",
+                root: frame.root,
+                seq: frame.seq,
+                ...(frame.gen !== undefined ? { gen: frame.gen } : {}),
+            };
+        case "presence":
+            if (typeof frame.root !== "string") {
+                return { t: "err", reason: "malformed-presence" };
+            }
+            return { t: "presence", root: frame.root, data: frame.data };
+        default:
+            return {
+                t: "err",
+                reason: typeof frame.reason === "string" ? frame.reason : "unspecified",
+                ...(typeof frame.root === "string" ? { root: frame.root } : {}),
+                ...(typeof frame.detail === "string" ? { detail: frame.detail } : {}),
+            };
+    }
+}
+/**
+ * Extract the event id from a canonical line without trusting anything else
+ * in it. The relay never parses beyond this. Returns undefined when no id
+ * can be extracted — callers surface that loudly, never drop it silently.
+ */
+export function extractLineId(line) {
+    try {
+        const value = JSON.parse(line);
+        if (typeof value === "object" && value !== null && typeof value.id === "string") {
+            return value.id;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=sync-protocol.js.map

package/dist/sync-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-protocol.js","sourceRoot":"","sources":["../src/sync-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAwCH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAwB;IAClD,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3E,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnF,CAAC;IACD,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,IAAI,OAAO,KAAK,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,CAAC;IACD,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QAChB,KAAK,KAAK;YACR,kEAAkE;YAClE,uEAAuE;YACvE,qEAAqE;YACrE,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAe,EAAE,CAAC;QACtE,KAAK,IAAI;YACP,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;YAC3F,CAAC;YACD,yEAAyE;YACzE,qEAAqE;YACrE,mBAAmB;YACnB,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC7D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;YAC9E,CAAC;YACD,OAAO;gBACL,CAAC,EAAE,IAAI;gBACP,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;QACJ,KAAK,MAAM;YACT,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YAChD,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC7D,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;YAChF,CAAC;YACD,OAAO;gBACL,CAAC,EAAE,MAAM;gBACT,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAa;gBACxB,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;QACJ,KAAK,UAAU;YACb,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/D;YACE,OAAO;gBACL,CAAC,EAAE,KAAK;gBACR,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;gBACvE,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA0B,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACtG,OAAQ,KAAwB,CAAC,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}