@ifc-lite/collab 0.2.0

package/dist/branch/branch-tree.js.map

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

package/dist/branch/branch.d.ts

@@ -0,0 +1,44 @@
+import { type CollabSession, type CollabSessionOptions } from '../session.js';
+export interface ForkOptions {
+    /** New room id for the branch. Defaults to `<parent.roomId>/branches/<name>`. */
+    roomId?: string;
+    /** Branch name; stored in branch's meta for UI. */
+    name: string;
+    /** Override the user identity on the branch session. Defaults to parent's. */
+    user?: CollabSessionOptions['user'];
+    /** Provider for the branch (default: parent's provider). */
+    provider?: CollabSessionOptions['provider'];
+    /** Forwarded to the new session. */
+    serverUrl?: CollabSessionOptions['serverUrl'];
+    token?: CollabSessionOptions['token'];
+    WebSocketPolyfill?: CollabSessionOptions['WebSocketPolyfill'];
+}
+export interface BranchSession {
+    readonly session: CollabSession;
+    readonly parentRoomId: string;
+    readonly branchName: string;
+}
+export declare function forkSession(parent: CollabSession, opts: ForkOptions): Promise<BranchSession>;
+export type MergeStrategy = 'ops' | 'layer';
+export interface MergeReport {
+    strategy: MergeStrategy;
+    /** Bytes of the merged update payload. */
+    bytes: number;
+    /** ISO timestamp of when the merge transaction landed on `parent`. */
+    mergedAt: string;
+}
+/**
+ * Merge `branch` back into `parent`. Returns a small report.
+ *
+ * The branch session is NOT disposed by this call — the caller decides
+ * whether to keep it around (e.g. for diff inspection) or `dispose()`
+ * it after merge.
+ */
+export declare function mergeBranch(parent: CollabSession, branch: BranchSession, strategy?: MergeStrategy): MergeReport;
+/** Read branch metadata back off a session's Y.Doc. */
+export declare function readBranchMeta(session: CollabSession): {
+    parentRoomId?: string;
+    branchName?: string;
+    forkedAt?: string;
+};
+//# sourceMappingURL=branch.d.ts.map

package/dist/branch/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/branch/branch.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAKvB,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC5C,oCAAoC;IACpC,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAMD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAiCxB;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,aAAqB,GAC9B,WAAW,CA2Bb;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,GACrB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAOnE"}

package/dist/branch/branch.js

@@ -0,0 +1,109 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Branching (spec §12.4 — v0.7 starter).
+ *
+ * `forkSession(parent, opts)` — snapshot the parent Y.Doc, seed a new
+ * Y.Doc with the snapshot, and wrap it as a fresh `CollabSession`. The
+ * branch carries `meta.parentRoomId` + `meta.branchName` for round-trip
+ * tooling.
+ *
+ * `mergeBranch(parent, branch, strategy)` — bring the branch's edits
+ * back. Two strategies ship in v0.7:
+ *   - `'ops'`   : encode the branch's full state as a Y update and
+ *                 `applyUpdate` it into the parent. Works for any pair
+ *                 of CRDT docs; concurrent parent edits LWW-merge with
+ *                 the branch's edits per Yjs semantics.
+ *   - `'layer'` : extract the branch contents as an IFCX layer and
+ *                 re-seed the parent with parent + branch composed.
+ *                 Useful when the branch was edited by tools that only
+ *                 speak IFCX, not the live Y.Doc.
+ *
+ * The proper differential layer composer lands later in v0.7 — for now
+ * `'layer'` produces a snapshot-of-branch layer, which is the same
+ * trade-off documented in `snapshot/layers.ts`.
+ */
+import * as Y from 'yjs';
+import { createCollabSession, } from '../session.js';
+import { metaMap } from '../doc/schema.js';
+import { snapshotToIfcx } from '../snapshot/to-ifcx.js';
+import { seedFromIfcx } from '../snapshot/from-ifcx.js';
+const META_PARENT = 'branch.parentRoomId';
+const META_NAME = 'branch.name';
+const META_FORKED_AT = 'branch.forkedAt';
+export async function forkSession(parent, opts) {
+    // 1. Snapshot the parent Y.Doc as a binary update.
+    const update = Y.encodeStateAsUpdate(parent.doc);
+    // 2. Build the branch session.
+    const branchRoomId = opts.roomId ?? `${parent.roomId}/branches/${opts.name}`;
+    const branchUser = opts.user ?? parent.presence.getSelf()?.user ?? {
+        id: 'forker',
+        name: 'forker',
+    };
+    const branch = await createCollabSession({
+        roomId: branchRoomId,
+        user: branchUser,
+        provider: opts.provider ?? parent.provider,
+        serverUrl: opts.serverUrl,
+        token: opts.token,
+        WebSocketPolyfill: opts.WebSocketPolyfill,
+    });
+    // 3. Seed the branch doc with the parent state, then stamp branch metadata.
+    Y.applyUpdate(branch.doc, update, { source: 'fork', parentRoomId: parent.roomId });
+    branch.transact(() => {
+        const meta = metaMap(branch.doc);
+        meta.set(META_PARENT, parent.roomId);
+        meta.set(META_NAME, opts.name);
+        meta.set(META_FORKED_AT, new Date().toISOString());
+    });
+    return {
+        session: branch,
+        parentRoomId: parent.roomId,
+        branchName: opts.name,
+    };
+}
+/**
+ * Merge `branch` back into `parent`. Returns a small report.
+ *
+ * The branch session is NOT disposed by this call — the caller decides
+ * whether to keep it around (e.g. for diff inspection) or `dispose()`
+ * it after merge.
+ */
+export function mergeBranch(parent, branch, strategy = 'ops') {
+    if (strategy === 'ops') {
+        const update = Y.encodeStateAsUpdate(branch.session.doc);
+        Y.applyUpdate(parent.doc, update, {
+            source: 'merge-branch',
+            branchName: branch.branchName,
+        });
+        return {
+            strategy,
+            bytes: update.byteLength,
+            mergedAt: new Date().toISOString(),
+        };
+    }
+    // 'layer' strategy: snapshot the branch as IFCX, then re-seed the
+    // parent with reset:false so existing parent state is preserved and
+    // branch nodes overlay (composition is left to the caller's IFCX
+    // layer stack — for now we fall back to "set everything we have").
+    const ifcx = snapshotToIfcx(branch.session.doc);
+    const before = Y.encodeStateAsUpdate(parent.doc);
+    seedFromIfcx(parent.doc, ifcx, { reset: false });
+    const after = Y.encodeStateAsUpdate(parent.doc);
+    return {
+        strategy,
+        bytes: Math.max(0, after.byteLength - before.byteLength),
+        mergedAt: new Date().toISOString(),
+    };
+}
+/** Read branch metadata back off a session's Y.Doc. */
+export function readBranchMeta(session) {
+    const meta = metaMap(session.doc);
+    return {
+        parentRoomId: meta.get(META_PARENT),
+        branchName: meta.get(META_NAME),
+        forkedAt: meta.get(META_FORKED_AT),
+    };
+}
+//# sourceMappingURL=branch.js.map

package/dist/branch/branch.js.map

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

package/dist/branch/history-automerge.d.ts

@@ -0,0 +1,31 @@
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import type { BranchInfo, HistoryDiff, HistoryEntry, HistorySidecar } from './history.js';
+export interface AutomergeHistorySidecarOptions {
+    /** Restore from a previously-saved binary doc. */
+    serialised?: Uint8Array;
+}
+export declare class AutomergeHistorySidecar implements HistorySidecar {
+    private doc;
+    private counter;
+    constructor(opts?: AutomergeHistorySidecarOptions);
+    /** Serialise the entire history doc. Use to persist across restarts. */
+    save(): Uint8Array;
+    /** Replace the internal doc. Used by tests + restore flows. */
+    load(serialised: Uint8Array): void;
+    private nextEntryId;
+    record(input: {
+        branch?: string;
+        label?: string;
+        snapshot: IfcxFile;
+        diff?: IfcxFile;
+        authorClientId?: number;
+    }): Promise<HistoryEntry>;
+    entries(branch?: string): Promise<HistoryEntry[]>;
+    at(at: Date | string, branch?: string): Promise<HistoryEntry | null>;
+    diff(fromEntryId: string, toEntryId: string): Promise<HistoryDiff>;
+    branches(): Promise<BranchInfo[]>;
+    branch(name: string, fromEntryId?: string): Promise<BranchInfo>;
+    merge(branch: string, into: string, mergedSnapshot: IfcxFile): Promise<HistoryEntry>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=history-automerge.d.ts.map

package/dist/branch/history-automerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-automerge.d.ts","sourceRoot":"","sources":["../../src/branch/history-automerge.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACf,MAAM,cAAc,CAAC;AA0BtB,MAAM,WAAW,8BAA8B;IAC7C,kDAAkD;IAClD,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,GAAE,8BAAmC;IAiBrD,wEAAwE;IACxE,IAAI,IAAI,UAAU;IAIlB,+DAA+D;IAC/D,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIlC,OAAO,CAAC,WAAW;IAKb,MAAM,CAAC,KAAK,EAAE;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgCnB,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAcjD,EAAE,CAAC,EAAE,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAWpE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoClE,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAOjC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B/D,KAAK,CACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,QAAQ,GACvB,OAAO,CAAC,YAAY,CAAC;IAwClB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/branch/history-automerge.js

@@ -0,0 +1,237 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Automerge-backed `HistorySidecar` (spec §4 + §12.4).
+ *
+ * Same interface as `MemoryHistorySidecar`, but every entry lives
+ * inside an Automerge document. That gives us:
+ *   - first-class branching / merging at the storage layer
+ *   - a binary `save()` representation we can persist
+ *   - cheap time-travel via Automerge `view(heads)` and `getHistory()`
+ *
+ * The trade-off (per spec §4) is bundle size: Automerge is Rust+WASM.
+ * For deployments where that's unacceptable, `MemoryHistorySidecar`
+ * remains the default. Both satisfy `HistorySidecar`.
+ */
+import * as A from '@automerge/automerge';
+export class AutomergeHistorySidecar {
+    doc;
+    counter = 0;
+    constructor(opts = {}) {
+        if (opts.serialised && opts.serialised.byteLength > 0) {
+            this.doc = A.load(opts.serialised);
+            // Recompute counter so newly-recorded ids don't collide.
+            const ids = Object.keys(this.doc.entries ?? {});
+            this.counter = ids.length;
+        }
+        else {
+            this.doc = A.from({
+                entries: {},
+                branches: {
+                    main: { name: 'main', createdAt: new Date().toISOString() },
+                },
+                byBranch: { main: [] },
+            });
+        }
+    }
+    /** Serialise the entire history doc. Use to persist across restarts. */
+    save() {
+        return A.save(this.doc);
+    }
+    /** Replace the internal doc. Used by tests + restore flows. */
+    load(serialised) {
+        this.doc = A.load(serialised);
+    }
+    nextEntryId() {
+        this.counter += 1;
+        return `e${this.counter}-${Date.now().toString(36)}`;
+    }
+    async record(input) {
+        const branch = input.branch ?? 'main';
+        const entryId = this.nextEntryId();
+        const at = new Date().toISOString();
+        const snapshotJson = JSON.stringify(input.snapshot);
+        const diffJson = input.diff ? JSON.stringify(input.diff) : undefined;
+        this.doc = A.change(this.doc, `record ${entryId}`, (d) => {
+            if (!d.branches[branch]) {
+                d.branches[branch] = { name: branch, createdAt: at };
+                d.byBranch[branch] = [];
+            }
+            // Automerge rejects `undefined` — only set defined fields.
+            const entry = { entryId, at, branch, snapshotJson };
+            if (input.authorClientId !== undefined)
+                entry.authorClientId = input.authorClientId;
+            if (input.label !== undefined)
+                entry.label = input.label;
+            if (diffJson !== undefined)
+                entry.diffJson = diffJson;
+            d.entries[entryId] = entry;
+            d.byBranch[branch].push(entryId);
+        });
+        return revive({
+            entryId,
+            at,
+            branch,
+            authorClientId: input.authorClientId,
+            label: input.label,
+            snapshotJson,
+            diffJson,
+        });
+    }
+    async entries(branch) {
+        const shape = this.doc;
+        if (branch) {
+            const ids = shape.byBranch[branch] ?? [];
+            return ids
+                .map((id) => shape.entries[id])
+                .filter((e) => Boolean(e))
+                .map(revive);
+        }
+        return Object.values(shape.entries)
+            .map(revive)
+            .sort((a, b) => a.at.localeCompare(b.at));
+    }
+    async at(at, branch) {
+        const target = at instanceof Date ? at.toISOString() : at;
+        const list = await this.entries(branch);
+        let best = null;
+        for (const e of list) {
+            if (e.at <= target)
+                best = e;
+            else
+                break;
+        }
+        return best;
+    }
+    async diff(fromEntryId, toEntryId) {
+        const shape = this.doc;
+        const from = shape.entries[fromEntryId];
+        const to = shape.entries[toEntryId];
+        if (!from || !to) {
+            return { from: fromEntryId, to: toEntryId, added: [], removed: [], changed: [] };
+        }
+        const fromIfcx = JSON.parse(from.snapshotJson);
+        const toIfcx = JSON.parse(to.snapshotJson);
+        const fromPaths = new Map();
+        const toPaths = new Map();
+        for (const n of fromIfcx.data ?? [])
+            fromPaths.set(n.path, n);
+        for (const n of toIfcx.data ?? [])
+            toPaths.set(n.path, n);
+        const added = [];
+        const removed = [];
+        const changed = [];
+        for (const path of toPaths.keys()) {
+            if (!fromPaths.has(path))
+                added.push(path);
+            else if (JSON.stringify(toPaths.get(path)) !== JSON.stringify(fromPaths.get(path))) {
+                changed.push(path);
+            }
+        }
+        for (const path of fromPaths.keys()) {
+            if (!toPaths.has(path))
+                removed.push(path);
+        }
+        return {
+            from: fromEntryId,
+            to: toEntryId,
+            added: added.sort(),
+            removed: removed.sort(),
+            changed: changed.sort(),
+        };
+    }
+    async branches() {
+        const shape = this.doc;
+        return Object.values(shape.branches).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async branch(name, fromEntryId) {
+        const shape = this.doc;
+        if (shape.branches[name]) {
+            throw new Error(`@ifc-lite/collab: branch "${name}" already exists`);
+        }
+        // Default fork point = current head of main when no explicit
+        // entry is supplied, matching `MemoryHistorySidecar` + the documented
+        // interface.
+        let resolvedFork = fromEntryId;
+        if (!resolvedFork) {
+            const mainIds = shape.byBranch.main ?? [];
+            resolvedFork = mainIds[mainIds.length - 1];
+        }
+        const info = {
+            name,
+            forkedFromEntryId: resolvedFork,
+            createdAt: new Date().toISOString(),
+        };
+        this.doc = A.change(this.doc, `branch ${name}`, (d) => {
+            const stored = { name, createdAt: info.createdAt };
+            if (resolvedFork !== undefined)
+                stored.forkedFromEntryId = resolvedFork;
+            d.branches[name] = stored;
+            d.byBranch[name] = [];
+        });
+        return info;
+    }
+    async merge(branch, into, mergedSnapshot) {
+        const shape = this.doc;
+        // Validate the source branch up front (matches MemoryHistorySidecar).
+        if (!shape.branches[branch]) {
+            throw new Error(`@ifc-lite/collab: source branch "${branch}" not found`);
+        }
+        if (!shape.branches[into]) {
+            throw new Error(`@ifc-lite/collab: target branch "${into}" not found`);
+        }
+        const sourceIds = shape.byBranch[branch] ?? [];
+        const sourceTipId = sourceIds[sourceIds.length - 1];
+        const entryId = this.nextEntryId();
+        const at = new Date().toISOString();
+        const snapshotJson = JSON.stringify(mergedSnapshot);
+        const label = `merge ${branch} → ${into}`;
+        this.doc = A.change(this.doc, `merge ${branch} → ${into}`, (d) => {
+            // Automerge rejects `undefined` — only set defined fields.
+            const entry = {
+                entryId,
+                at,
+                branch: into,
+                label,
+                snapshotJson,
+                mergedFromBranch: branch,
+            };
+            if (sourceTipId !== undefined)
+                entry.mergedFromEntryId = sourceTipId;
+            d.entries[entryId] = entry;
+            d.byBranch[into].push(entryId);
+        });
+        return revive({
+            entryId,
+            at,
+            branch: into,
+            label,
+            snapshotJson,
+            mergedFromBranch: branch,
+            mergedFromEntryId: sourceTipId,
+        });
+    }
+    async clear() {
+        this.doc = A.from({
+            entries: {},
+            branches: { main: { name: 'main', createdAt: new Date().toISOString() } },
+            byBranch: { main: [] },
+        });
+        this.counter = 0;
+    }
+}
+function revive(entry) {
+    return {
+        entryId: entry.entryId,
+        at: entry.at,
+        branch: entry.branch,
+        authorClientId: entry.authorClientId,
+        label: entry.label,
+        snapshot: JSON.parse(entry.snapshotJson),
+        diff: entry.diffJson ? JSON.parse(entry.diffJson) : undefined,
+        mergedFromBranch: entry.mergedFromBranch,
+        mergedFromEntryId: entry.mergedFromEntryId,
+    };
+}
+//# sourceMappingURL=history-automerge.js.map

package/dist/branch/history-automerge.js.map

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

package/dist/branch/history.d.ts

@@ -0,0 +1,147 @@
+/**
+ * History sidecar (spec §4 + §12.4).
+ *
+ * The Yjs runtime is optimized for live editing — it doesn't ship a
+ * first-class history / branch / time-travel UI. Per spec §4, we run an
+ * Automerge-shaped sidecar that records periodic snapshots of the live
+ * doc so apps can navigate `(branch, timestamp)` space.
+ *
+ * To avoid forcing every consumer to take the heavy `@automerge/automerge`
+ * Rust+WASM dep, this module ships:
+ *
+ *   - `HistorySidecar` interface — `record(snapshot)`, `entries()`,
+ *     `at(t)`, `diff(a, b)`, `branches()`, `branch(name, fromEntryId)`,
+ *     `merge(branch, into)`.
+ *   - `MemoryHistorySidecar` — keeps every snapshot + per-entry diff
+ *     in RAM. Good for tests and short-lived sessions.
+ *   - `IndexedDbHistorySidecar` — same shape, persisted to IDB.
+ *   - `attachHistorySidecar(session, sidecar, opts)` — drives a sidecar
+ *     from a `CollabSession` by snapshotting on a timer and on demand.
+ *
+ * A future `AutomergeHistorySidecar` (pending the heavy dep) will
+ * satisfy the same interface.
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import type { CollabSession } from '../session.js';
+import { type SnapshotOptions } from '../snapshot/to-ifcx.js';
+export interface HistoryEntry {
+    /** Stable id (UUIDv4-like or timestamp-based). */
+    entryId: string;
+    /** ISO timestamp. */
+    at: string;
+    /** Branch this entry belongs to. */
+    branch: string;
+    /** clientID of the author at snapshot time, if known. */
+    authorClientId?: number;
+    /** Free-form label (commit-message-style). */
+    label?: string;
+    /** Composed IFCX snapshot — full state at this entry. */
+    snapshot: IfcxFile;
+    /** Optional minimal layer relative to the previous entry on this branch. */
+    diff?: IfcxFile;
+    /**
+     * Immutable merge metadata. Set ONLY by `merge()` — never by
+     * `record()`. UI layers (e.g. `branch-tree`) rely on these instead of
+     * parsing `label` so user-authored labels can't be misclassified as
+     * structural metadata, and so the merge edge always points at the
+     * commit that was actually merged (not the source branch's current tip).
+     */
+    mergedFromBranch?: string;
+    mergedFromEntryId?: string;
+}
+export interface HistoryDiff {
+    /** Entry IDs of `from` and `to`. */
+    from: string;
+    to: string;
+    /**
+     * Per-entity differences as observed by walking IFCX nodes:
+     *   - `added`     — entity exists in `to` but not in `from`
+     *   - `removed`   — entity exists in `from` but not in `to`
+     *   - `changed`   — both, with at least one attribute / child differing
+     */
+    added: string[];
+    removed: string[];
+    changed: string[];
+}
+export interface BranchInfo {
+    name: string;
+    /** entryId on the parent branch where this branch forked. */
+    forkedFromEntryId?: string;
+    /** Wall-clock time of branch creation. */
+    createdAt: string;
+}
+export interface HistorySidecar {
+    /** Append a new entry to a branch (default `'main'`). */
+    record(input: {
+        branch?: string;
+        label?: string;
+        snapshot: IfcxFile;
+        diff?: IfcxFile;
+        authorClientId?: number;
+    }): Promise<HistoryEntry>;
+    /** All entries, oldest first, optionally filtered to one branch. */
+    entries(branch?: string): Promise<HistoryEntry[]>;
+    /** The entry whose `at` is closest to (and not after) `at`. */
+    at(at: Date | string, branch?: string): Promise<HistoryEntry | null>;
+    /** Per-entity-id diff between two entries. */
+    diff(fromEntryId: string, toEntryId: string): Promise<HistoryDiff>;
+    /** All known branches, in creation order. */
+    branches(): Promise<BranchInfo[]>;
+    /** Create a new branch off `fromEntryId` (defaults to head of `main`). */
+    branch(name: string, fromEntryId?: string): Promise<BranchInfo>;
+    /**
+     * Merge `branch` into `into`. Returns a synthetic merge entry — apps
+     * compute the merged snapshot themselves (typically by replaying
+     * Y-update logs through `mergeBranch`).
+     */
+    merge(branch: string, into: string, mergedSnapshot: IfcxFile): Promise<HistoryEntry>;
+    /** Remove all entries / branches. */
+    clear(): Promise<void>;
+}
+export declare class MemoryHistorySidecar implements HistorySidecar {
+    private readonly entriesByBranch;
+    private readonly branchInfo;
+    private counter;
+    constructor();
+    private nextEntryId;
+    record(input: {
+        branch?: string;
+        label?: string;
+        snapshot: IfcxFile;
+        diff?: IfcxFile;
+        authorClientId?: number;
+    }): Promise<HistoryEntry>;
+    entries(branch?: string): Promise<HistoryEntry[]>;
+    at(at: Date | string, branch?: string): Promise<HistoryEntry | null>;
+    diff(fromEntryId: string, toEntryId: string): Promise<HistoryDiff>;
+    branches(): Promise<BranchInfo[]>;
+    branch(name: string, fromEntryId?: string): Promise<BranchInfo>;
+    merge(branch: string, into: string, mergedSnapshot: IfcxFile): Promise<HistoryEntry>;
+    clear(): Promise<void>;
+}
+export interface AttachHistoryOptions {
+    /** How often to record a snapshot, ms. Default 60_000. */
+    intervalMs?: number;
+    /** Branch to record on. Default 'main'. */
+    branch?: string;
+    /** Forwarded to `snapshotToIfcx`. */
+    snapshot?: SnapshotOptions;
+    /**
+     * If true (default), include a minimal-layer diff against the
+     * previous entry on the same branch. Diffs make `historySidecar.diff(a, b)`
+     * cheaper to compute.
+     */
+    includeDiff?: boolean;
+}
+export interface HistoryDriver {
+    /** Force a snapshot now. */
+    capture(label?: string): Promise<HistoryEntry>;
+    /** Stop the timer. */
+    detach(): void;
+}
+/**
+ * Drive a `HistorySidecar` from a live `CollabSession`. Records a
+ * snapshot every `intervalMs`, plus on-demand via `capture(label)`.
+ */
+export declare function attachHistorySidecar(session: CollabSession, sidecar: HistorySidecar, options?: AttachHistoryOptions): HistoryDriver;
+//# sourceMappingURL=history.d.ts.map

package/dist/branch/history.d.ts.map

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