@ifc-lite/collab 0.2.0

package/dist/security/e2e.js

@@ -0,0 +1,147 @@
+/* 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/. */
+/**
+ * End-to-end encryption (spec §14, v1.0).
+ *
+ * Optional: clients in a room share a symmetric per-room key; Y.Doc
+ * updates are encrypted with AES-GCM-256 before they hit the
+ * websocket. The server only routes ciphertext — it cannot read or
+ * mutate the document.
+ *
+ * Trade-off (documented in the spec): server-side IFCX export is
+ * unavailable without key escrow, because the server never sees
+ * plaintext. Apps that want escrow can ship the key to a controlled
+ * snapshot worker.
+ *
+ * Wire in:
+ *   - Key derivation: PBKDF2(password, salt) → AES-GCM-256 key.
+ *   - Frame format: `[1B version][12B IV][N B ciphertext]`. v1 only.
+ *   - Key rotation: a new key is derived; both peers are notified;
+ *     old keys are kept around for `gracePeriodMs` so in-flight frames
+ *     don't fail.
+ *   - Member-add: a member is rewrapped — existing members re-derive
+ *     the room key with the new salt and post the new key envelope to
+ *     the new member out of band (e.g. via app-level invite link).
+ *
+ * Implemented against the WebCrypto API so it works in the browser
+ * and on Node 22+ without pulling in a crypto dep.
+ */
+const VERSION = 1;
+const IV_LEN = 12;
+/** Cross-runtime crypto handle. */
+const subtle = (() => {
+    if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.subtle) {
+        return globalThis.crypto.subtle;
+    }
+    // Node before 19 needs explicit import.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const nodeCrypto = globalThis.require?.('node:crypto');
+    if (nodeCrypto?.webcrypto?.subtle)
+        return nodeCrypto.webcrypto.subtle;
+    throw new Error('@ifc-lite/collab: WebCrypto not available in this runtime');
+})();
+const randomBytes = (n) => {
+    const out = new Uint8Array(n);
+    if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.getRandomValues) {
+        globalThis.crypto.getRandomValues(out);
+        return out;
+    }
+    throw new Error('@ifc-lite/collab: secure RNG not available in this runtime');
+};
+/**
+ * Derive a room key from a shared password + salt. Salt is typically
+ * the room ID hashed; never reuse the same `(password, salt)` pair
+ * across rooms.
+ */
+export async function deriveRoomKey(password, salt, options = {}) {
+    const iterations = options.iterations ?? 200_000;
+    const hash = options.hash ?? 'SHA-256';
+    const passwordKey = await subtle.importKey('raw', new TextEncoder().encode(password), { name: 'PBKDF2' }, false, ['deriveKey']);
+    const key = await subtle.deriveKey({ name: 'PBKDF2', salt: salt, iterations, hash }, passwordKey, { name: 'AES-GCM', length: 256 }, 
+    /* extractable */ true, ['encrypt', 'decrypt']);
+    return { version: 1, key, createdAt: Date.now() };
+}
+/** Generate a random AES-GCM-256 room key (no password). */
+export async function generateRoomKey() {
+    const key = await subtle.generateKey({ name: 'AES-GCM', length: 256 }, 
+    /* extractable */ true, ['encrypt', 'decrypt']);
+    return { version: 1, key, createdAt: Date.now() };
+}
+/** Export the raw key bytes so apps can persist or rewrap them. */
+export async function exportRoomKey(key) {
+    const raw = await subtle.exportKey('raw', key.key);
+    return { version: key.version, bytes: new Uint8Array(raw) };
+}
+/** Re-import a previously exported key. */
+export async function importRoomKey(version, bytes) {
+    const key = await subtle.importKey('raw', bytes, { name: 'AES-GCM' }, 
+    /* extractable */ true, ['encrypt', 'decrypt']);
+    return { version, key, createdAt: Date.now() };
+}
+/** Encrypt a plaintext frame. Adds a 13-byte header (`[ver][iv]`). */
+export async function encryptFrame(plaintext, key) {
+    const iv = randomBytes(IV_LEN);
+    const ct = await subtle.encrypt({ name: 'AES-GCM', iv: iv }, key.key, plaintext);
+    const ctBytes = new Uint8Array(ct);
+    const frame = new Uint8Array(1 + IV_LEN + ctBytes.byteLength);
+    frame[0] = VERSION;
+    frame.set(iv, 1);
+    frame.set(ctBytes, 1 + IV_LEN);
+    return frame;
+}
+/**
+ * Decrypt a frame using `keys`. Tries each key in order so callers can
+ * pass `[currentKey, ...recentKeys]` to gracefully decode in-flight
+ * frames around a rotation.
+ */
+export async function decryptFrame(frame, keys) {
+    if (frame.byteLength < 1 + IV_LEN) {
+        throw new Error('@ifc-lite/collab: frame too small');
+    }
+    if (frame[0] !== VERSION) {
+        throw new Error(`@ifc-lite/collab: unsupported frame version ${frame[0]}`);
+    }
+    const iv = frame.slice(1, 1 + IV_LEN);
+    const ct = frame.slice(1 + IV_LEN);
+    let lastErr;
+    for (const key of keys) {
+        try {
+            const pt = await subtle.decrypt({ name: 'AES-GCM', iv: iv }, key.key, ct);
+            return new Uint8Array(pt);
+        }
+        catch (err) {
+            lastErr = err;
+        }
+    }
+    throw new Error(`@ifc-lite/collab: decryption failed against ${keys.length} key(s): ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+}
+export function createKeyRing(initial, options = {}) {
+    const grace = options.gracePeriodMs ?? 30_000;
+    const now = options.now ?? Date.now;
+    let cur = initial;
+    const retired = [];
+    const prune = () => {
+        const cutoff = now() - grace;
+        let dropped = 0;
+        while (retired.length > 0 && retired[0].retiredAt < cutoff) {
+            retired.shift();
+            dropped += 1;
+        }
+        return dropped;
+    };
+    return {
+        current: () => cur,
+        rotate(next) {
+            retired.push({ key: cur, retiredAt: now() });
+            cur = next;
+            prune();
+        },
+        active() {
+            prune();
+            return [cur, ...retired.map((r) => r.key)];
+        },
+        prune,
+    };
+}
+//# sourceMappingURL=e2e.js.map

package/dist/security/e2e.js.map

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

package/dist/security/index.d.ts

@@ -0,0 +1,2 @@
+export * from './e2e.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC"}

package/dist/security/index.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export * from './e2e.js';
+//# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,cAAc,UAAU,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CollabSession — the public façade documented in spec §16.2.
+ *
+ * Glues the Y.Doc, providers, presence, undo, and conflict detector into
+ * a single object. Callers don't touch the underlying libraries unless
+ * they want to.
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import * as Y from 'yjs';
+import { type ConflictDetector, type ConflictListener } from './conflicts/detector.js';
+import { type Presence, type UserIdentity } from './awareness/presence.js';
+import { type WebSocketStatus } from './providers/websocket.js';
+import { type SnapshotOptions } from './snapshot/to-ifcx.js';
+import { type IfcxInput, type SeedOptions } from './snapshot/from-ifcx.js';
+import { type UndoController } from './undo.js';
+export type ProviderKind = 'memory' | 'indexeddb' | 'websocket' | 'indexeddb+websocket';
+export interface CollabSessionOptions {
+    roomId: string;
+    user: UserIdentity;
+    /**
+     * Choice of network/persistence stack. `'indexeddb+websocket'` runs both
+     * (recommended for browser deployments). `'memory'` is for tests and
+     * ephemeral rooms.
+     */
+    provider?: ProviderKind;
+    /** Required when `provider` involves websocket. */
+    serverUrl?: string;
+    /** Bearer token forwarded to the websocket server. */
+    token?: string;
+    /** Override the IDB database name. */
+    dbName?: string;
+    /** Auto-connect the websocket on construction (default true). */
+    connect?: boolean;
+    /** Existing Y.Doc to bind to. Defaults to a fresh `createCollabDoc()`. */
+    doc?: Y.Doc;
+    /** Ws polyfill (e.g. `ws` package in Node tests). */
+    WebSocketPolyfill?: unknown;
+    /**
+     * Disable BroadcastChannel intra-browser sync — every edit goes
+     * through the websocket. Forwarded to the websocket provider; ignored
+     * for memory / indexeddb-only sessions. Default `false`.
+     */
+    disableBc?: boolean;
+    /** Presence config knobs. */
+    presence?: {
+        updateRateHz?: number;
+        staleAfterMs?: number;
+    };
+}
+export interface CollabSession {
+    readonly roomId: string;
+    readonly doc: Y.Doc;
+    readonly clientId: number;
+    readonly presence: Presence;
+    readonly undoController: UndoController;
+    readonly conflicts: ConflictDetector;
+    readonly provider: ProviderKind;
+    /** Resolves once both persistence and (if applicable) websocket sync have completed. */
+    readonly whenSynced: Promise<void>;
+    status(): WebSocketStatus | 'memory' | 'indexeddb';
+    onStatus(listener: (s: WebSocketStatus | 'memory' | 'indexeddb') => void): () => void;
+    /** Seed this session's Y.Doc from an IFCX file. */
+    seed(input: IfcxInput, options?: SeedOptions): IfcxFile;
+    /** Snapshot the current state to an IFCX object. */
+    snapshot(options?: SnapshotOptions): IfcxFile;
+    /** Capture a baseline state vector for later layer extraction. */
+    captureBaseline(): Uint8Array;
+    /** Extract a per-user layer (defaults to *this* peer). */
+    extractUserLayer(baseline: Uint8Array, clientId?: number, snapshot?: SnapshotOptions): IfcxFile;
+    /** Wrap edits in a Yjs transaction tagged with our local origin. */
+    transact<T>(fn: () => T): T;
+    /** Local-origin undo via Y.UndoManager. */
+    undo(): boolean;
+    redo(): boolean;
+    onConflict(listener: ConflictListener): () => void;
+    dispose(): void;
+}
+export declare function createCollabSession(opts: CollabSessionOptions): Promise<CollabSession>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,112 @@
+/* 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/. */
+import { createCollabDoc, LOCAL_ORIGIN } from './doc/schema.js';
+import { createConflictDetector, } from './conflicts/detector.js';
+import { createPresence } from './awareness/presence.js';
+import { createIndexedDbProvider, createMemoryProvider, } from './providers/indexeddb.js';
+import { createWebSocketProvider, } from './providers/websocket.js';
+import { snapshotToIfcx } from './snapshot/to-ifcx.js';
+import { seedFromIfcx } from './snapshot/from-ifcx.js';
+import { captureBaseline as captureBaselineSV, extractUserLayer as extractLayerForClient, } from './snapshot/layers.js';
+import { createUndoManager } from './undo.js';
+export async function createCollabSession(opts) {
+    const doc = opts.doc ?? createCollabDoc();
+    const presence = createPresence(doc, opts.presence ?? {});
+    presence.setUser(opts.user);
+    presence.setStatus('active');
+    const undoController = createUndoManager(doc);
+    const conflicts = createConflictDetector(doc);
+    const providerKind = opts.provider ?? 'memory';
+    let idb;
+    let ws;
+    let currentStatus = providerKind === 'memory' ? 'memory' : 'indexeddb';
+    const statusListeners = new Set();
+    const setStatus = (s) => {
+        if (s === currentStatus)
+            return;
+        currentStatus = s;
+        statusListeners.forEach((l) => l(s));
+    };
+    const synced = [];
+    if (providerKind === 'indexeddb' || providerKind === 'indexeddb+websocket') {
+        idb = await createIndexedDbProvider(doc, opts.roomId, { dbName: opts.dbName });
+        synced.push(idb.whenSynced);
+    }
+    else if (providerKind === 'memory') {
+        idb = createMemoryProvider(doc, opts.roomId);
+        synced.push(idb.whenSynced);
+    }
+    if (providerKind === 'websocket' || providerKind === 'indexeddb+websocket') {
+        if (!opts.serverUrl) {
+            throw new Error('@ifc-lite/collab: serverUrl is required for websocket providers');
+        }
+        ws = await createWebSocketProvider(doc, opts.roomId, opts.serverUrl, {
+            WebSocketPolyfill: opts.WebSocketPolyfill,
+            token: opts.token,
+            awareness: presence.awareness,
+            connect: opts.connect ?? true,
+            disableBc: opts.disableBc,
+        });
+        ws.onStatus(setStatus);
+        synced.push(ws.whenSynced);
+    }
+    const session = {
+        roomId: opts.roomId,
+        doc,
+        clientId: doc.clientID,
+        presence,
+        undoController,
+        conflicts,
+        provider: providerKind,
+        whenSynced: Promise.all(synced).then(() => undefined),
+        status: () => currentStatus,
+        onStatus(listener) {
+            statusListeners.add(listener);
+            listener(currentStatus);
+            return () => statusListeners.delete(listener);
+        },
+        seed(input, options) {
+            return seedFromIfcx(doc, input, options);
+        },
+        snapshot(options) {
+            return snapshotToIfcx(doc, options);
+        },
+        captureBaseline() {
+            return captureBaselineSV(doc);
+        },
+        extractUserLayer(baseline, clientId, snapshot) {
+            return extractLayerForClient(doc, baseline, {
+                clientId: clientId ?? doc.clientID,
+                snapshot,
+            });
+        },
+        transact(fn) {
+            let result;
+            doc.transact(() => {
+                result = fn();
+            }, LOCAL_ORIGIN);
+            return result;
+        },
+        undo() {
+            return undoController.undo();
+        },
+        redo() {
+            return undoController.redo();
+        },
+        onConflict(listener) {
+            return conflicts.onConflict(listener);
+        },
+        dispose() {
+            conflicts.destroy();
+            undoController.destroy();
+            presence.dispose();
+            if (ws)
+                ws.destroy();
+            if (idb)
+                idb.destroy();
+        },
+    };
+    return session;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAY/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAoC,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,GAGxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAoC,MAAM,yBAAyB,CAAC;AACzF,OAAO,EACL,eAAe,IAAI,iBAAiB,EACpC,gBAAgB,IAAI,qBAAqB,GAC1C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAuB,MAAM,WAAW,CAAC;AAgEnE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA0B;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAE1C,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE9C,MAAM,YAAY,GAAiB,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAC7D,IAAI,GAAkC,CAAC;IACvC,IAAI,EAAiC,CAAC;IAEtC,IAAI,aAAa,GACf,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyD,CAAC;IACzF,MAAM,SAAS,GAAG,CAAC,CAA2C,EAAE,EAAE;QAChE,IAAI,CAAC,KAAK,aAAa;YAAE,OAAO;QAChC,aAAa,GAAG,CAAC,CAAC;QAClB,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,IAAI,YAAY,KAAK,WAAW,IAAI,YAAY,KAAK,qBAAqB,EAAE,CAAC;QAC3E,GAAG,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,YAAY,KAAK,WAAW,IAAI,YAAY,KAAK,qBAAqB,EAAE,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,EAAE,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;YACnE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG;QACH,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ;QACR,cAAc;QACd,SAAS;QACT,QAAQ,EAAE,YAAY;QACtB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QACrD,MAAM,EAAE,GAAG,EAAE,CAAC,aAAa;QAC3B,QAAQ,CAAC,QAAQ;YACf,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,QAAQ,CAAC,aAAa,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,OAAO;YACjB,OAAO,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,QAAQ,CAAC,OAAO;YACd,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,eAAe;YACb,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ;YAC3C,OAAO,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE;gBAC1C,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,QAAQ;gBAClC,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,EAAE;YACT,IAAI,MAA8B,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAChB,MAAM,GAAG,EAAE,EAAE,CAAC;YAChB,CAAC,EAAE,YAAY,CAAC,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI;YACF,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI;YACF,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,UAAU,CAAC,QAAQ;YACjB,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QACD,OAAO;YACL,SAAS,CAAC,OAAO,EAAE,CAAC;YACpB,cAAc,CAAC,OAAO,EAAE,CAAC;YACzB,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,EAAE;gBAAE,EAAE,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,GAAG;gBAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/snapshot/from-ifcx.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IFCX → Y.Doc seeding.
+ *
+ * Idempotent: seeding the same buffer into a fresh Y.Doc twice produces
+ * the same state. Used both at session start and when resetting from a
+ * snapshot.
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import * as Y from 'yjs';
+export interface SeedOptions {
+    /** Origin tag for the seeding transaction. Defaults to SEED_ORIGIN. */
+    origin?: unknown;
+    /** If true, clear any existing top-level state before seeding. */
+    reset?: boolean;
+}
+export type IfcxInput = ArrayBuffer | Uint8Array | string | IfcxFile;
+/** Decode whatever the caller hands us into a parsed IfcxFile. */
+export declare function parseIfcxInput(input: IfcxInput): IfcxFile;
+/**
+ * Seed `doc` with the contents of an IFCX file. Returns the parsed file
+ * for callers that want to inspect headers / schemas.
+ */
+export declare function seedFromIfcx(doc: Y.Doc, input: IfcxInput, opts?: SeedOptions): IfcxFile;
+//# sourceMappingURL=from-ifcx.d.ts.map

package/dist/snapshot/from-ifcx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-ifcx.d.ts","sourceRoot":"","sources":["../../src/snapshot/from-ifcx.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErE,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAazD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,WAAgB,GAAG,QAAQ,CAuD3F"}

package/dist/snapshot/from-ifcx.js

@@ -0,0 +1,93 @@
+/* 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/. */
+import { createEntity } from '../doc/entity.js';
+import { SEED_ORIGIN, assertSchemaInvariants, metaMap } from '../doc/schema.js';
+/** Decode whatever the caller hands us into a parsed IfcxFile. */
+export function parseIfcxInput(input) {
+    if (typeof input === 'string') {
+        return JSON.parse(input);
+    }
+    if (input instanceof ArrayBuffer) {
+        const text = new TextDecoder().decode(new Uint8Array(input));
+        return JSON.parse(text);
+    }
+    if (input instanceof Uint8Array) {
+        const text = new TextDecoder().decode(input);
+        return JSON.parse(text);
+    }
+    return input;
+}
+/**
+ * Seed `doc` with the contents of an IFCX file. Returns the parsed file
+ * for callers that want to inspect headers / schemas.
+ */
+export function seedFromIfcx(doc, input, opts = {}) {
+    const file = parseIfcxInput(input);
+    assertSchemaInvariants(doc);
+    doc.transact(() => {
+        if (opts.reset) {
+            const ents = doc.getMap('entities');
+            const rels = doc.getMap('relationships');
+            const geom = doc.getMap('geometry');
+            ents.clear();
+            rels.clear();
+            geom.clear();
+        }
+        // Stash file-level metadata so we can re-emit it during snapshotting.
+        const meta = metaMap(doc);
+        if (file.header)
+            meta.set('header', file.header);
+        if (file.imports)
+            meta.set('imports', file.imports);
+        if (file.schemas)
+            meta.set('schemas', file.schemas);
+        for (const node of file.data ?? []) {
+            const path = node.path;
+            if (!path)
+                continue;
+            const attributes = node.attributes ? { ...node.attributes } : {};
+            const children = {};
+            if (node.children) {
+                for (const [role, target] of Object.entries(node.children)) {
+                    if (typeof target === 'string')
+                        children[role] = target;
+                }
+            }
+            const inherits = {};
+            if (node.inherits) {
+                for (const [role, target] of Object.entries(node.inherits)) {
+                    if (typeof target === 'string')
+                        inherits[role] = target;
+                }
+            }
+            const ifcClass = readIfcClass(node.attributes);
+            createEntity(doc, path, {
+                ifcClass,
+                attributes,
+                children,
+                inherits,
+                meta: {
+                    ifcClass,
+                    schemaVersion: 'ifc5',
+                    createdAt: file.header?.timestamp ?? new Date().toISOString(),
+                    createdBy: file.header?.author,
+                },
+            });
+        }
+    }, opts.origin ?? SEED_ORIGIN);
+    return file;
+}
+/** Read the IfcClass code out of the well-known `bsi::ifc::class` attribute. */
+function readIfcClass(attributes) {
+    if (!attributes)
+        return undefined;
+    const cls = attributes['bsi::ifc::class'];
+    if (cls && typeof cls === 'object' && 'code' in cls) {
+        const code = cls.code;
+        if (typeof code === 'string')
+            return code;
+    }
+    return undefined;
+}
+//# sourceMappingURL=from-ifcx.js.map

package/dist/snapshot/from-ifcx.js.map

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

package/dist/snapshot/index.d.ts

@@ -0,0 +1,6 @@
+export { seedFromIfcx, parseIfcxInput, type SeedOptions, type IfcxInput, } from './from-ifcx.js';
+export { snapshotToIfcx, serializeIfcx, type SnapshotOptions } from './to-ifcx.js';
+export { captureBaseline, extractUserLayer, filterUpdateByClient, } from './layers.js';
+export { extractMinimalLayer, type ExtractMinimalLayerOptions, } from './minimal-layer.js';
+export { runSnapshotWorker, type WorkerRequest, type WorkerResponse, type WorkerScopeLike, } from './worker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/snapshot/index.js

@@ -0,0 +1,9 @@
+/* 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/. */
+export { seedFromIfcx, parseIfcxInput, } from './from-ifcx.js';
+export { snapshotToIfcx, serializeIfcx } from './to-ifcx.js';
+export { captureBaseline, extractUserLayer, filterUpdateByClient, } from './layers.js';
+export { extractMinimalLayer, } from './minimal-layer.js';
+export { runSnapshotWorker, } from './worker.js';
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EACL,YAAY,EACZ,cAAc,GAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAwB,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iBAAiB,GAIlB,MAAM,aAAa,CAAC"}

package/dist/snapshot/layers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Per-user layer extraction.
+ *
+ * Composed with the baseline they fork from, these layers reproduce the
+ * full live state — that's the IFCX layer composition contract from spec
+ * §2 / §10.
+ *
+ * v0.1 strategy: "snapshot of current state, scoped to one client" by
+ * applying the *full* update history to a fresh replay doc, not just the
+ * post-baseline diff. The diff-only approach can't render IFCX nodes for
+ * entities created before the baseline (their parent struct isn't in the
+ * filtered update). The full-history approach correctly renders any
+ * entity the client has touched, with all of that client's writes
+ * reflected — at the cost of also including their pre-baseline writes.
+ *
+ * v0.7 (branching) introduces a proper layer composer that produces
+ * minimal-diff layers; the v0.1 implementation is the foundation.
+ */
+import type { IfcxFile } from '@ifc-lite/ifcx';
+import * as Y from 'yjs';
+import { type SnapshotOptions } from './to-ifcx.js';
+export interface LayerExtractionOptions {
+    /** clientID to filter to. If omitted, all clients are included. */
+    clientId?: number;
+    /** Forwarded to `snapshotToIfcx` for header/timestamp control. */
+    snapshot?: SnapshotOptions;
+}
+/**
+ * Capture a baseline state vector. Composed-with-baseline IFCX layer
+ * composition is the v0.7 mode; for v0.1 we still expose this so callers
+ * can pin a "before" point for downstream tooling.
+ */
+export declare function captureBaseline(doc: Y.Doc): Uint8Array;
+/**
+ * Extract a per-user IFCX layer from `doc`.
+ *
+ * Replays `doc`'s full state filtered by `clientId` onto a fresh doc and
+ * snapshots that. The resulting IFCX is a complete description of every
+ * entity the chosen client touched, with that client's view of the
+ * attributes.
+ *
+ * `baseline` is currently unused at the per-write level (the v0.1
+ * limitation noted above) but kept in the signature so callers don't have
+ * to refactor when the v0.7 differential mode lands.
+ */
+export declare function extractUserLayer(doc: Y.Doc, baseline: Uint8Array | undefined, options?: LayerExtractionOptions): IfcxFile;
+/**
+ * Filter a Y update so it only contains operations from `clientId`.
+ *
+ * We use Yjs's diff-against-state-vector machinery: build a state
+ * vector that has every client *except* `clientId` advanced past the
+ * end of the input update, then `diffUpdate` returns just `clientId`'s
+ * structs.
+ */
+export declare function filterUpdateByClient(update: Uint8Array, clientId: number): Uint8Array;
+//# sourceMappingURL=layers.d.ts.map

package/dist/snapshot/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/snapshot/layers.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,UAAU,CAEtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,OAAO,GAAE,sBAA2B,GACnC,QAAQ,CAcV;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAUrF"}