@swal/edge-mesh 0.0.0-stage → 0.1.1

package/dist/web/exchange.js

@@ -0,0 +1,54 @@
+import { topic } from "./rooms.js";
+export const HEALTH_SCHEMA_PREFIX = "swal.health/v1";
+export function isHealthRecord(r) {
+    return (typeof r === "object" &&
+        r !== null &&
+        typeof r.schema === "string" &&
+        r.schema.startsWith(HEALTH_SCHEMA_PREFIX));
+}
+/** Topic carrying cross-app health records for one subject (`subj_<ULID>`). */
+export const exchangeTopic = (subject) => topic("health", "exchange", subject);
+/**
+ * Cross-app exchange over a dedicated mesh (created with topic = exchangeTopic(subject)).
+ * Records live in an append-only Y.Array 'records'; receivers see only entries added remotely
+ * (or by any writer after subscription), de-duplicated by record id.
+ */
+export function exchange(mesh, doc, subject) {
+    const arr = doc.getArray("records");
+    const cbs = new Set();
+    const seen = new Set();
+    const obs = (ev) => {
+        if (ev.transaction.local)
+            return;
+        for (const item of ev.changes.added) {
+            for (const e of item.content.getContent()) {
+                if (seen.has(e.id) || !isHealthRecord(e.record))
+                    continue;
+                seen.add(e.id);
+                for (const cb of cbs)
+                    cb(e.record);
+            }
+        }
+    };
+    arr.observe(obs);
+    return {
+        topic: exchangeTopic(subject),
+        send(record) {
+            if (!isHealthRecord(record))
+                throw new Error(`record.schema must start with "${HEALTH_SCHEMA_PREFIX}"`);
+            const id = crypto.randomUUID();
+            seen.add(id);
+            arr.push([{ id, record }]);
+            return id;
+        },
+        onReceive(cb) {
+            cbs.add(cb);
+            return () => void cbs.delete(cb);
+        },
+        destroy() {
+            arr.unobserve(obs);
+            cbs.clear();
+        },
+    };
+}
+//# sourceMappingURL=exchange.js.map

package/dist/web/exchange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../src/web/exchange.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAQrD,MAAM,UAAU,cAAc,CAAC,CAAU;IACxC,OAAO,CACN,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,OAAQ,CAAkB,CAAC,MAAM,KAAK,QAAQ;QAC7C,CAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAC3D,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE,CAChD,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAStC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACvB,IAAU,EACV,GAAsB,EACtB,OAAe;IAEf,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAuC,SAAS,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CACX,EAAmE,EAClE,EAAE;QACH,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK;YAAE,OAAO;QACjC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAGrC,EAAE,CAAC;gBACJ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAC1D,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,MAAM,EAAE,IAAI,GAAG;oBAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IACF,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACN,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,MAAM;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACd,kCAAkC,oBAAoB,GAAG,CACzD,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3B,OAAO,EAAE,CAAC;QACX,CAAC;QACD,SAAS,CAAC,EAAE;YACX,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,OAAO;YACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/web/fragment.d.ts

@@ -0,0 +1,58 @@
+export declare const F_FRAG = 4;
+export declare const FRAG_HEADER: number;
+export declare const DEFAULT_MAX_FRAME: number;
+export declare const DEFAULT_MAX_MESSAGE: number;
+/** Split `msg` into frames of at most `maxFrame` bytes; a message that already fits is returned as is. */
+export declare function fragment(msg: Uint8Array, maxFrame?: number): Promise<Uint8Array[]>;
+/** A byte budget shared by several reassemblers (e.g. every not-yet-authenticated link of a mesh). */
+export interface ByteBudget {
+    used: number;
+    readonly max: number;
+}
+export interface ReassemblerOptions {
+    /** Largest message accepted (declared length). Default 64 MiB. */
+    maxMessageBytes?: number;
+    /** Sum of declared lengths of all partial messages; the oldest partials are evicted beyond it. Default = maxMessageBytes. */
+    maxPendingBytes?: number;
+    /** A partial message older than this is dropped. Default 30 s. */
+    timeoutMs?: number;
+    now?: () => number;
+    onDrop?: (reason: string) => void;
+    /** Also charge every partial message to this shared budget (dropped when it would overflow). */
+    shared?: ByteBudget;
+}
+/** Reassembles fragments arriving on ONE link. Not shared between links (a peer cannot complete another's message). */
+export declare class Reassembler {
+    private o;
+    private partials;
+    private declared;
+    private timer;
+    private maxMessage;
+    private maxPendingBytes;
+    private shared?;
+    private readonly timeoutMs;
+    private readonly now;
+    constructor(o?: ReassemblerOptions);
+    /**
+     * Change the limits (e.g. once the link is authenticated). `shared: null` stops charging NEW partials to the
+     * shared budget; partials already charged release it when they complete or are dropped.
+     */
+    setLimits(o: {
+        maxMessageBytes?: number;
+        maxPendingBytes?: number;
+        shared?: ByteBudget | null;
+    }): void;
+    get pending(): number;
+    get pendingBytes(): number;
+    /** Returns the whole message once its last fragment arrives and the hash matches; null otherwise. */
+    push(frame: Uint8Array): Promise<Uint8Array | null>;
+    /** Drop partial messages older than the timeout. */
+    sweep(): void;
+    clear(): void;
+    private evictOldest;
+    private remove;
+    private drop;
+    /** Free memory of stalled partials even if no further fragment ever arrives. */
+    private arm;
+}
+//# sourceMappingURL=fragment.d.ts.map

package/dist/web/fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.d.ts","sourceRoot":"","sources":["../../src/web/fragment.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,eAAO,MAAM,WAAW,QAAyB,CAAC;AAClD,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAmB,CAAC;AAMpD,0GAA0G;AAC1G,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,UAAU,EACf,QAAQ,SAAoB,GAC1B,OAAO,CAAC,UAAU,EAAE,CAAC,CAsBvB;AAED,sGAAsG;AACtG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6HAA6H;IAC7H,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gGAAgG;IAChG,MAAM,CAAC,EAAE,UAAU,CAAC;CACpB;AAaD,uHAAuH;AACvH,qBAAa,WAAW;IAUX,OAAO,CAAC,CAAC;IATrB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,YAAoB,CAAC,GAAE,kBAAuB,EAM7C;IAED;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAC3B,GAAG,IAAI,CAKP;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,qGAAqG;IAC/F,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA8DxD;IAED,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAIZ;IAED,KAAK,IAAI,IAAI,CAOZ;IAED,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,IAAI;IAMZ,gFAAgF;IAChF,OAAO,CAAC,GAAG;CASX"}

package/dist/web/fragment.js

@@ -0,0 +1,198 @@
+// Transport-independent fragmentation of mesh messages (H5). Browsers cap a DataChannel message
+// (RTCSctpTransport.maxMessageSize, ~256 KiB in Chrome) and other link transports may cap lower, while an
+// initial sync or a pairing grant can be megabytes. Messages above `maxFrame` are split into self-describing
+// fragments and reassembled with integrity (sequence + total + length + SHA-256), bounded memory and a timeout.
+//
+// Fragment: F_FRAG | msgId(8) | seq(u32) | total(u32) | len(u32) | sha256(32) | chunk
+import { bs, concat, equalBytes, randomBytes } from "./util.js";
+export const F_FRAG = 4;
+export const FRAG_HEADER = 1 + 8 + 4 + 4 + 4 + 32;
+export const DEFAULT_MAX_FRAME = 64 * 1024;
+export const DEFAULT_MAX_MESSAGE = 64 * 1024 * 1024;
+const MAX_FRAGMENTS = 1 << 20;
+const sha256 = async (b) => new Uint8Array(await crypto.subtle.digest("SHA-256", bs(b)));
+/** Split `msg` into frames of at most `maxFrame` bytes; a message that already fits is returned as is. */
+export async function fragment(msg, maxFrame = DEFAULT_MAX_FRAME) {
+    if (msg.length <= maxFrame)
+        return [msg];
+    const chunk = maxFrame - FRAG_HEADER;
+    if (chunk < 1)
+        throw new Error("maxFrame too small");
+    const total = Math.ceil(msg.length / chunk);
+    const id = randomBytes(8);
+    const hash = await sha256(msg);
+    const out = [];
+    for (let seq = 0; seq < total; seq++) {
+        const body = msg.subarray(seq * chunk, (seq + 1) * chunk);
+        const f = new Uint8Array(FRAG_HEADER + body.length);
+        const dv = new DataView(f.buffer);
+        f[0] = F_FRAG;
+        f.set(id, 1);
+        dv.setUint32(9, seq);
+        dv.setUint32(13, total);
+        dv.setUint32(17, msg.length);
+        f.set(hash, 21);
+        f.set(body, FRAG_HEADER);
+        out.push(f);
+    }
+    return out;
+}
+/** Reassembles fragments arriving on ONE link. Not shared between links (a peer cannot complete another's message). */
+export class Reassembler {
+    o;
+    partials = new Map();
+    declared = 0;
+    timer = null;
+    maxMessage;
+    maxPendingBytes;
+    shared;
+    timeoutMs;
+    now;
+    constructor(o = {}) {
+        this.o = o;
+        this.maxMessage = o.maxMessageBytes ?? DEFAULT_MAX_MESSAGE;
+        this.maxPendingBytes = o.maxPendingBytes ?? this.maxMessage;
+        this.shared = o.shared;
+        this.timeoutMs = o.timeoutMs ?? 30_000;
+        this.now = o.now ?? (() => Date.now());
+    }
+    /**
+     * Change the limits (e.g. once the link is authenticated). `shared: null` stops charging NEW partials to the
+     * shared budget; partials already charged release it when they complete or are dropped.
+     */
+    setLimits(o) {
+        if (o.maxMessageBytes !== undefined)
+            this.maxMessage = o.maxMessageBytes;
+        if (o.maxPendingBytes !== undefined)
+            this.maxPendingBytes = o.maxPendingBytes;
+        if (o.shared !== undefined)
+            this.shared = o.shared ?? undefined;
+    }
+    get pending() {
+        return this.partials.size;
+    }
+    get pendingBytes() {
+        return this.declared;
+    }
+    /** Returns the whole message once its last fragment arrives and the hash matches; null otherwise. */
+    async push(frame) {
+        this.sweep();
+        if (frame.length <= FRAG_HEADER || frame[0] !== F_FRAG)
+            return this.drop(null, "malformed fragment");
+        const dv = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);
+        const key = Array.from(frame.subarray(1, 9)).join(",");
+        const seq = dv.getUint32(9);
+        const total = dv.getUint32(13);
+        const len = dv.getUint32(17);
+        const hash = frame.subarray(21, FRAG_HEADER);
+        const body = frame.subarray(FRAG_HEADER);
+        let p = this.partials.get(key);
+        if (!p) {
+            if (len > this.maxMessage)
+                return this.drop(null, "message too large");
+            if (total < 2 || total > MAX_FRAGMENTS || total > len || seq >= total)
+                return this.drop(null, "malformed fragment");
+            while (this.partials.size > 0 &&
+                this.declared + len > this.maxPendingBytes)
+                this.evictOldest();
+            const shared = this.shared;
+            if (shared) {
+                while (this.partials.size > 0 && shared.used + len > shared.max)
+                    this.evictOldest();
+                if (shared.used + len > shared.max)
+                    return this.drop(null, "shared budget exhausted");
+                shared.used += len;
+            }
+            p = {
+                total,
+                len,
+                hash: hash.slice(),
+                parts: new Map(),
+                got: 0,
+                started: this.now(),
+                shared,
+            };
+            this.partials.set(key, p);
+            this.declared += len;
+            this.arm();
+        }
+        else if (p.total !== total ||
+            p.len !== len ||
+            !equalBytes(p.hash, hash) ||
+            seq >= total) {
+            return this.drop(key, "inconsistent fragment");
+        }
+        if (p.parts.has(seq))
+            return null; // duplicate
+        if (p.got + body.length > p.len)
+            return this.drop(key, "fragment overflow");
+        p.parts.set(seq, body.slice());
+        p.got += body.length;
+        if (p.parts.size < p.total)
+            return null;
+        this.remove(key);
+        if (p.got !== p.len)
+            return this.drop(null, "length mismatch");
+        const parts = [];
+        for (let i = 0; i < p.total; i++)
+            parts.push(p.parts.get(i));
+        const msg = concat(...parts);
+        if (!equalBytes(await sha256(msg), p.hash))
+            return this.drop(null, "hash mismatch");
+        return msg;
+    }
+    /** Drop partial messages older than the timeout. */
+    sweep() {
+        const limit = this.now() - this.timeoutMs;
+        for (const [k, p] of this.partials)
+            if (p.started <= limit)
+                this.drop(k, "timeout");
+    }
+    clear() {
+        for (const p of this.partials.values())
+            if (p.shared)
+                p.shared.used -= p.len;
+        this.partials.clear();
+        this.declared = 0;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    evictOldest() {
+        const first = this.partials.keys().next();
+        if (!first.done)
+            this.drop(first.value, "evicted");
+    }
+    remove(key) {
+        const p = this.partials.get(key);
+        if (!p)
+            return;
+        this.partials.delete(key);
+        this.declared -= p.len;
+        if (p.shared)
+            p.shared.used -= p.len;
+        if (this.partials.size === 0 && this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    drop(key, reason) {
+        if (key !== null)
+            this.remove(key);
+        this.o.onDrop?.(reason);
+        return null;
+    }
+    /** Free memory of stalled partials even if no further fragment ever arrives. */
+    arm() {
+        if (this.timer || this.o.now)
+            return; // an injected clock means the caller sweeps
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.sweep();
+            if (this.partials.size > 0)
+                this.arm();
+        }, this.timeoutMs);
+        this.timer.unref?.();
+    }
+}
+//# sourceMappingURL=fragment.js.map

package/dist/web/fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.js","sourceRoot":"","sources":["../../src/web/fragment.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,0GAA0G;AAC1G,6GAA6G;AAC7G,gHAAgH;AAChH,EAAE;AACF,sFAAsF;AACtF,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC;AACxB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACpD,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,CAAC;AAE9B,MAAM,MAAM,GAAG,KAAK,EAAE,CAAa,EAAE,EAAE,CACtC,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,GAAe,EACf,QAAQ,GAAG,iBAAiB;IAE5B,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrC,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;QACd,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACb,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrB,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAgCD,uHAAuH;AACvH,MAAM,OAAO,WAAW;IAUH,CAAC;IATb,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,QAAQ,GAAG,CAAC,CAAC;IACb,KAAK,GAAyC,IAAI,CAAC;IACnD,UAAU,CAAS;IACnB,eAAe,CAAS;IACxB,MAAM,CAAc;IACX,SAAS,CAAS;IAClB,GAAG,CAAe;IAEnC,YAAoB,CAAC,GAAuB,EAAE;iBAA1B,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,eAAe,IAAI,mBAAmB,CAAC;QAC3D,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,CAIT;QACA,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,eAAe,CAAC;QACzE,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS;YAClC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC;QAC1C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;IACjE,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,CAAC,MAAM,IAAI,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;YACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;YACR,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;YACvE,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,aAAa,IAAI,KAAK,GAAG,GAAG,IAAI,GAAG,IAAI,KAAK;gBACpE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;YAC9C,OACC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;gBACtB,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,eAAe;gBAE1C,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG;oBAC9D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACpB,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG;oBACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;gBACnD,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;YACpB,CAAC;YACD,CAAC,GAAG;gBACH,KAAK;gBACL,GAAG;gBACH,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;gBAClB,KAAK,EAAE,IAAI,GAAG,EAAE;gBAChB,GAAG,EAAE,CAAC;gBACN,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;gBACnB,MAAM;aACN,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;YACrB,IAAI,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;aAAM,IACN,CAAC,CAAC,KAAK,KAAK,KAAK;YACjB,CAAC,CAAC,GAAG,KAAK,GAAG;YACb,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;YACzB,GAAG,IAAI,KAAK,EACX,CAAC;YACF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,YAAY;QAC/C,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAC5E,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;YACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,oDAAoD;IACpD,KAAK;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ;YACjC,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,KAAK;QACJ,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YACrC,IAAI,CAAC,CAAC,MAAM;gBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,WAAW;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAEO,MAAM,CAAC,GAAW;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,CAAC,MAAM;YAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,CAAC;IACF,CAAC;IAEO,IAAI,CAAC,GAAkB,EAAE,MAAc;QAC9C,IAAI,GAAG,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,gFAAgF;IACxE,GAAG;QACV,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,OAAO,CAAC,4CAA4C;QAClF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAClB,IAAI,CAAC,KAAgC,CAAC,KAAK,EAAE,EAAE,CAAC;IAClD,CAAC;CACD"}

package/dist/web/index.d.ts

@@ -0,0 +1,25 @@
+export type { Role, TrustRoot } from "./admission.js";
+export { canIssue, idMatchesPub, isDeviceId } from "./admission.js";
+export { deriveDocKey, openUpdate, sealUpdate } from "./crypto.js";
+export type { Exchange, HealthRecord } from "./exchange.js";
+export { exchange, exchangeTopic, HEALTH_SCHEMA_PREFIX, isHealthRecord, } from "./exchange.js";
+export type { PairPayload } from "./pairing.js";
+export { decodePairPayload } from "./pairing.js";
+export { deviceIdOf, IDENTITY_ALG, identityKeygen, identitySign, identityVerify, KEM_ALG, kemKeygen, ML_DSA_PUBLIC_KEY_BYTES, ML_DSA_SIGNATURE_BYTES, ML_KEM_CIPHERTEXT_BYTES, ML_KEM_PUBLIC_KEY_BYTES, } from "./pq.js";
+export type { Mesh, MeshChannel, MeshEvent, MeshOptions, MeshSecurity, MeshStatus, PairHostOptions, PairJoinResult, PairOffer, } from "./provider.js";
+export { createMesh } from "./provider.js";
+export type { TopicScope } from "./rooms.js";
+export { derivePairRoomId, deriveRoomId, fingerprint, legacyNamespace, meshNamespace, topic, } from "./rooms.js";
+export type { RotDoc } from "./rotation.js";
+export { isRotDoc, MAX_ROT_MEMBERS } from "./rotation.js";
+export type { KexDoc, SecDoc } from "./secstate.js";
+export { MAX_MEMBERS_PER_ADMIN, MESH_MODULE, MESH_SCHEMA, SecurityState, } from "./secstate.js";
+export type { MeshStore } from "./store.js";
+export { idbStore, memoryStore } from "./store.js";
+export type { LoopbackHub } from "./transports/loopback.js";
+export { createLoopbackHub } from "./transports/loopback.js";
+export type { QrSdpTransport } from "./transports/qr-sdp.js";
+export { qrSdpTransport } from "./transports/qr-sdp.js";
+export { wsTransport } from "./transports/ws.js";
+export type { Device, LinkTransport, PeerLink, RtcOptions, SigMessage, SignalingChannel, SigTransport, VaultClient, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACN,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACN,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,OAAO,EACP,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,SAAS,CAAC;AACjB,YAAY,EACX,IAAI,EACJ,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,SAAS,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,KAAK,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACN,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EACX,MAAM,EACN,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACX,MAAM,YAAY,CAAC"}

package/dist/web/index.js

@@ -0,0 +1,14 @@
+export { canIssue, idMatchesPub, isDeviceId } from "./admission.js";
+export { deriveDocKey, openUpdate, sealUpdate } from "./crypto.js";
+export { exchange, exchangeTopic, HEALTH_SCHEMA_PREFIX, isHealthRecord, } from "./exchange.js";
+export { decodePairPayload } from "./pairing.js";
+export { deviceIdOf, IDENTITY_ALG, identityKeygen, identitySign, identityVerify, KEM_ALG, kemKeygen, ML_DSA_PUBLIC_KEY_BYTES, ML_DSA_SIGNATURE_BYTES, ML_KEM_CIPHERTEXT_BYTES, ML_KEM_PUBLIC_KEY_BYTES, } from "./pq.js";
+export { createMesh } from "./provider.js";
+export { derivePairRoomId, deriveRoomId, fingerprint, legacyNamespace, meshNamespace, topic, } from "./rooms.js";
+export { isRotDoc, MAX_ROT_MEMBERS } from "./rotation.js";
+export { MAX_MEMBERS_PER_ADMIN, MESH_MODULE, MESH_SCHEMA, SecurityState, } from "./secstate.js";
+export { idbStore, memoryStore } from "./store.js";
+export { createLoopbackHub } from "./transports/loopback.js";
+export { qrSdpTransport } from "./transports/qr-sdp.js";
+export { wsTransport } from "./transports/ws.js";
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EACN,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,cAAc,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACN,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,OAAO,EACP,SAAS,EACT,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,SAAS,CAAC;AAYjB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EACN,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,KAAK,GACL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EACN,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,aAAa,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/web/merge/index.d.ts

@@ -0,0 +1,104 @@
+import type { StoredOp } from "../oplog/types.js";
+/** Minimal op shape the strategies need (an accepted web/oplog op maps 1:1 via `toMergeOp`). */
+export interface MergeOp {
+    id: string;
+    author: string;
+    seq: number;
+    hlc: string;
+    entityId: string;
+    action: string;
+    payload?: unknown;
+    base?: string;
+}
+export declare const toMergeOp: (s: StoredOp) => MergeOp;
+export interface MergeStrategy<S> {
+    readonly kind: string;
+    project(ops: readonly MergeOp[]): S;
+}
+export declare const compareMergeOps: (a: MergeOp, b: MergeOp) => number;
+/** Payload of an lww-field op. */
+export interface LwwPayload {
+    set?: Record<string, unknown>;
+    unset?: string[];
+    /** tombstone the entity */
+    delete?: true;
+    /** undo every delete this op causally saw (gate who may restore with TrustSchema.actionLevel) */
+    restore?: true;
+}
+export interface LwwEntity {
+    id: string;
+    fields: Record<string, unknown>;
+    deleted: boolean;
+    /** field -> id of the winning op */
+    winners: Record<string, string>;
+    /** id of the last op in total order: use it as `base` for the next edit of this entity */
+    latest: string;
+}
+export interface LwwOptions {
+    /**
+     * Precedence for CONCURRENT edits of a field (neither saw the other via `base`/own history): higher rank wins,
+     * then HLC. Typical: owner 3 > admin 2 > staff 1 (derive it from web/trust grants). Without it: plain LWW by HLC.
+     */
+    rank?: (author: string) => number;
+}
+/**
+ * Per-field last-writer-wins. Causality comes from `base` (id of the latest op on the entity the author had seen)
+ * plus the author's own earlier ops: a causally later write always beats an earlier one; concurrent writes are
+ * resolved by `rank` then (hlc, author, seq). Delete = tombstone that wins over concurrent edits; only a `restore`
+ * that saw the delete brings the entity back.
+ */
+export declare function lwwField(opts?: LwwOptions): MergeStrategy<Map<string, LwwEntity>>;
+export type EventResult<S> = {
+    state: S;
+} | {
+    reject: string;
+};
+export interface EventReducer<S> {
+    init(entityId: string): S;
+    /** pure transition (e.g. an order state machine); `{ reject }` = invalid transition, state unchanged */
+    apply(state: S, op: MergeOp): EventResult<S>;
+}
+export interface EventEntity<S> {
+    id: string;
+    state: S;
+    /** ids of ops that changed the state, in fold order */
+    applied: string[];
+    /** rejected transitions (shown as "conflict" in the UI) */
+    conflicts: {
+        opId: string;
+        author: string;
+        reason: string;
+    }[];
+}
+/** Append-only events folded per entity by an app reducer, in (hlc, author, seq) order. */
+export declare function eventLog<S>(reducer: EventReducer<S>): MergeStrategy<Map<string, EventEntity<S>>>;
+export interface LedgerAccount {
+    id: string;
+    balance: number;
+    /** accepted movement ids, in fold order */
+    movements: string[];
+    rejected: {
+        opId: string;
+        author: string;
+        reason: string;
+    }[];
+    /** "flag" mode: the balance went below zero at some point (alert) */
+    wentNegative: boolean;
+}
+export interface LedgerOptions {
+    /**
+     * reject (default): a movement that would leave the account below zero is rejected (deterministic: in total order).
+     * flag: applied, account marked `wentNegative` (alert). allow: no check. A function decides per account.
+     */
+    negative?: "reject" | "flag" | "allow" | ((account: string) => "reject" | "flag" | "allow");
+    /** amount of a movement; default `payload.amount`. Use integers (minor units / grams) for exact sums. */
+    amount?: (op: MergeOp) => number | null | undefined;
+}
+/** Signed movements summed per account (entityId). No conflicts: stock/balance = sum. */
+export declare function ledger(opts?: LedgerOptions): MergeStrategy<Map<string, LedgerAccount>>;
+/** module -> strategy. `project(module, ops)` folds accepted ops of that module. */
+export declare function createProjector<M extends Record<string, MergeStrategy<unknown>>>(modules: M): {
+    modules: M;
+    project<K extends keyof M & string>(module: K, ops: readonly (MergeOp | StoredOp)[]): ReturnType<M[K]["project"]>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/web/merge/index.d.ts.map

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