@ifc-lite/collab 0.2.0

package/dist/federation/session.js

@@ -0,0 +1,126 @@
+/* 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 { createCollabSession, } from '../session.js';
+import { createPresence } from '../awareness/presence.js';
+import { createCollabDoc } from '../doc/schema.js';
+import { federationRoomId, roomIdFor } from '../sync/room.js';
+const RECORDS_KEY = 'records';
+/** Build a federation session and pre-load `models`. */
+export async function createFederationSession(opts) {
+    // The federation Y.Doc holds cross-model state and acts as the host
+    // for project-scoped presence (§10.2).
+    const federationDoc = createCollabDoc({ gc: true });
+    const fedRoomId = federationRoomId(opts.projectId);
+    const presence = createPresence(federationDoc, opts.presence ?? {});
+    presence.setUser(opts.user);
+    presence.setStatus('active');
+    const recordsMap = federationDoc.getMap(RECORDS_KEY);
+    const models = new Map();
+    async function loadModel(modelId) {
+        const existing = models.get(modelId);
+        if (existing)
+            return existing;
+        const session = await createCollabSession({
+            roomId: roomIdFor({ projectId: opts.projectId, modelId }),
+            user: opts.user,
+            provider: opts.provider,
+            serverUrl: opts.serverUrl,
+            token: opts.token,
+            WebSocketPolyfill: opts.WebSocketPolyfill,
+            presence: opts.presence,
+        });
+        models.set(modelId, session);
+        return session;
+    }
+    // Bootstrap the federation room itself if a websocket provider was
+    // requested — share the same provider stack as model rooms.
+    let federationCarrier = null;
+    if (opts.provider && opts.provider !== 'memory') {
+        federationCarrier = await createCollabSession({
+            roomId: fedRoomId,
+            user: opts.user,
+            provider: opts.provider,
+            serverUrl: opts.serverUrl,
+            token: opts.token,
+            WebSocketPolyfill: opts.WebSocketPolyfill,
+            doc: federationDoc,
+            presence: opts.presence,
+        });
+    }
+    function listRecords() {
+        const out = [];
+        recordsMap.forEach((v) => out.push(cloneRecord(v)));
+        return out;
+    }
+    await Promise.all(opts.models.map(loadModel));
+    return {
+        projectId: opts.projectId,
+        federationDoc,
+        federationRoomId: fedRoomId,
+        presence,
+        user: opts.user,
+        models,
+        async addModel(modelId) {
+            return loadModel(modelId);
+        },
+        async removeModel(modelId) {
+            const session = models.get(modelId);
+            if (!session)
+                return;
+            session.dispose();
+            models.delete(modelId);
+        },
+        modelIds: () => Array.from(models.keys()),
+        upsertRecord(record) {
+            federationDoc.transact(() => {
+                recordsMap.set(record.recordId, sanitiseRecord(record));
+            });
+        },
+        getRecord(recordId) {
+            const v = recordsMap.get(recordId);
+            return v ? cloneRecord(v) : undefined;
+        },
+        removeRecord(recordId) {
+            if (!recordsMap.has(recordId))
+                return false;
+            recordsMap.delete(recordId);
+            return true;
+        },
+        listRecords: listRecords,
+        observeRecords(listener) {
+            const fn = () => listener(listRecords());
+            recordsMap.observeDeep(fn);
+            return () => recordsMap.unobserveDeep(fn);
+        },
+        async whenSynced() {
+            const synced = Array.from(models.values()).map((s) => s.whenSynced);
+            if (federationCarrier)
+                synced.push(federationCarrier.whenSynced);
+            await Promise.all(synced);
+        },
+        async dispose() {
+            for (const session of models.values())
+                session.dispose();
+            models.clear();
+            if (federationCarrier)
+                federationCarrier.dispose();
+            else
+                presence.dispose();
+        },
+    };
+}
+function sanitiseRecord(r) {
+    return {
+        recordId: r.recordId,
+        type: r.type,
+        refs: r.refs.map((ref) => ({ modelId: ref.modelId, globalId: ref.globalId })),
+        resolution: r.resolution,
+        bcfTopicId: r.bcfTopicId,
+        meta: r.meta ? { ...r.meta } : undefined,
+    };
+}
+function cloneRecord(r) {
+    return sanitiseRecord(r);
+}
+//# sourceMappingURL=session.js.map

package/dist/federation/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/federation/session.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAqB/D,OAAO,EACL,mBAAmB,GAIpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAoC,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA8D9D,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAA8B;IAE9B,oEAAoE;IACpE,uCAAuC;IACvC,MAAM,aAAa,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAmB,WAAW,CAAC,CAAC;IAEvE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEhD,KAAK,UAAU,SAAS,CAAC,OAAe;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC;YACxC,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;YACzD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mEAAmE;IACnE,4DAA4D;IAC5D,IAAI,iBAAiB,GAAyB,IAAI,CAAC;IACnD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChD,iBAAiB,GAAG,MAAM,mBAAmB,CAAC;YAC5C,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,GAAG,EAAE,aAAa;YAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,WAAW;QAClB,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9C,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa;QACb,gBAAgB,EAAE,SAAS;QAC3B,QAAQ;QACR,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM;QAEN,KAAK,CAAC,QAAQ,CAAC,OAAe;YAC5B,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,OAAe;YAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAED,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEzC,YAAY,CAAC,MAAwB;YACnC,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAC1B,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;QACL,CAAC;QAED,SAAS,CAAC,QAAgB;YACxB,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxC,CAAC;QAED,YAAY,CAAC,QAAgB;YAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC5C,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,WAAW,EAAE,WAAW;QAExB,cAAc,CAAC,QAAQ;YACrB,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YACzC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3B,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,UAAU;YACd,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACpE,IAAI,iBAAiB;gBAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YACjE,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,OAAO;YACX,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE;gBAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACzD,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,iBAAiB;gBAAE,iBAAiB,CAAC,OAAO,EAAE,CAAC;;gBAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,CAAmB;IACzC,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7E,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,CAAmB;IACtC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/geometry/blob-store.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Content-addressed blob store (spec §11.1).
+ *
+ * Mesh / opaque blobs live OUTSIDE the Y.Doc — the Y.Doc only carries
+ * `blobHash` references (see `doc/geometry.ts`). The blob store is
+ * pluggable so apps can mix:
+ *   - `MemoryBlobStore`   — tests, ephemeral rooms
+ *   - `IndexedDbBlobStore` — browsers, local-first
+ *   - `HttpBlobStore`     — `@ifc-lite/collab-server` blob route
+ *   - composition: `LayeredBlobStore(local, remote)`
+ *
+ * Hashing is FNV-1a × 4 rounds → 32 hex chars. Cheap, dependency-free,
+ * collision properties good enough to identify ~10^9 blobs without
+ * coincidence in practice. For high-assurance deployments, swap to
+ * SHA-256 by registering a different `BlobHasher`.
+ */
+export type BlobHash = string;
+export interface BlobMeta {
+    hash: BlobHash;
+    byteLength: number;
+    contentType?: string;
+    uploadedAt?: string;
+}
+export interface BlobStore {
+    put(bytes: Uint8Array, contentType?: string): Promise<BlobMeta>;
+    get(hash: BlobHash): Promise<Uint8Array | null>;
+    has(hash: BlobHash): Promise<boolean>;
+    delete(hash: BlobHash): Promise<boolean>;
+    /** List currently-known blob hashes; ordering is implementation-defined. */
+    list(): Promise<BlobHash[]>;
+    /**
+     * Return the blob's metadata (size, contentType, uploadedAt) without
+     * downloading the bytes. Backends that can't cheaply compute this
+     * may return `null` and force callers to fall back to `get`.
+     */
+    stat?(hash: BlobHash): Promise<BlobMeta | null>;
+}
+export type BlobHasher = (bytes: Uint8Array) => BlobHash;
+/**
+ * 128-bit hash (4 rounds of 32-bit FNV-1a with different seeds), encoded
+ * as 32 lowercase hex chars. Deterministic, dependency-free.
+ */
+export declare const fnv128: BlobHasher;
+export declare class MemoryBlobStore implements BlobStore {
+    private readonly hasher;
+    private readonly blobs;
+    constructor(hasher?: BlobHasher);
+    put(bytes: Uint8Array, contentType?: string): Promise<BlobMeta>;
+    get(hash: BlobHash): Promise<Uint8Array | null>;
+    has(hash: BlobHash): Promise<boolean>;
+    delete(hash: BlobHash): Promise<boolean>;
+    list(): Promise<BlobHash[]>;
+    stat(hash: BlobHash): Promise<BlobMeta | null>;
+}
+export interface IndexedDbBlobStoreOptions {
+    dbName?: string;
+    storeName?: string;
+}
+/**
+ * Browser-only IndexedDB-backed store. Loaded lazily so Node bundle
+ * paths don't trip on the missing global.
+ */
+export declare function createIndexedDbBlobStore(opts?: IndexedDbBlobStoreOptions, hasher?: BlobHasher): Promise<BlobStore>;
+export interface HttpBlobStoreOptions {
+    /** Base URL like `https://collab.ifclite.com`; we append `/blobs/<hash>`. */
+    baseUrl: string;
+    /** Bearer token forwarded as `Authorization: Bearer …`. */
+    token?: string;
+    /** Hasher used when deduping client-side before PUT. */
+    hasher?: BlobHasher;
+    /** Override fetch (mainly for tests). */
+    fetch?: typeof fetch;
+}
+export declare class HttpBlobStore implements BlobStore {
+    private readonly opts;
+    private readonly hasher;
+    private readonly fetchImpl;
+    constructor(opts: HttpBlobStoreOptions);
+    private url;
+    private headers;
+    put(bytes: Uint8Array, contentType?: string): Promise<BlobMeta>;
+    get(hash: BlobHash): Promise<Uint8Array | null>;
+    has(hash: BlobHash): Promise<boolean>;
+    delete(hash: BlobHash): Promise<boolean>;
+    list(): Promise<BlobHash[]>;
+    stat(hash: BlobHash): Promise<BlobMeta | null>;
+}
+/**
+ * Read-through / write-through layering: writes go to `local` and `remote`
+ * in parallel; reads check `local` first and fall back to `remote`,
+ * caching the result locally on hit.
+ *
+ * This is what we recommend for browser apps: instant local reads, durable
+ * remote storage, and offline-first semantics for already-fetched blobs.
+ */
+export declare class LayeredBlobStore implements BlobStore {
+    private readonly local;
+    private readonly remote;
+    constructor(local: BlobStore, remote: BlobStore);
+    put(bytes: Uint8Array, contentType?: string): Promise<BlobMeta>;
+    get(hash: BlobHash): Promise<Uint8Array | null>;
+    has(hash: BlobHash): Promise<boolean>;
+    delete(hash: BlobHash): Promise<boolean>;
+    list(): Promise<BlobHash[]>;
+}
+//# sourceMappingURL=blob-store.d.ts.map

package/dist/geometry/blob-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../../src/geometry/blob-store.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,4EAA4E;IAC5E,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACjD;AAMD,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,QAAQ,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,UAYpB,CAAC;AAMF,qBAAa,eAAgB,YAAW,SAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8D;gBACvD,MAAM,GAAE,UAAmB;IAElD,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAc/D,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI/C,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAGrC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAGxC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAG3B,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAIrD;AAMD,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,GAAE,yBAA8B,EACpC,MAAM,GAAE,UAAmB,GAC1B,OAAO,CAAC,SAAS,CAAC,CAgEpB;AAMD,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,qBAAa,aAAc,YAAW,SAAS;IAIjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEZ,IAAI,EAAE,oBAAoB;IAKvD,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAMT,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB/D,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAO/C,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAS3B,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAYrD;AAMD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAa,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAzC,KAAK,EAAE,SAAS,EAAmB,MAAM,EAAE,SAAS;IAE3E,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAO/D,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAY/C,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAOxC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAIlC"}

package/dist/geometry/blob-store.js

@@ -0,0 +1,266 @@
+/* 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/. */
+/**
+ * 128-bit hash (4 rounds of 32-bit FNV-1a with different seeds), encoded
+ * as 32 lowercase hex chars. Deterministic, dependency-free.
+ */
+export const fnv128 = (bytes) => {
+    const seeds = [0x811c9dc5, 0x84222325, 0xcbf29ce4, 0x100000001];
+    const out = [];
+    for (let s = 0; s < 4; s++) {
+        let h = seeds[s] >>> 0;
+        for (let i = 0; i < bytes.length; i++) {
+            h ^= bytes[i] ^ ((s + 1) << ((i & 3) * 8));
+            h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;
+        }
+        out.push(h >>> 0);
+    }
+    return out.map((n) => n.toString(16).padStart(8, '0')).join('');
+};
+/* ------------------------------------------------------------------ */
+/* Memory backend                                                       */
+/* ------------------------------------------------------------------ */
+export class MemoryBlobStore {
+    hasher;
+    blobs = new Map();
+    constructor(hasher = fnv128) {
+        this.hasher = hasher;
+    }
+    async put(bytes, contentType) {
+        const hash = this.hasher(bytes);
+        const meta = {
+            hash,
+            byteLength: bytes.byteLength,
+            contentType,
+            uploadedAt: new Date().toISOString(),
+        };
+        if (!this.blobs.has(hash)) {
+            // Defensive copy so callers can mutate `bytes` after put().
+            this.blobs.set(hash, { bytes: new Uint8Array(bytes), meta });
+        }
+        return meta;
+    }
+    async get(hash) {
+        const entry = this.blobs.get(hash);
+        return entry ? new Uint8Array(entry.bytes) : null;
+    }
+    async has(hash) {
+        return this.blobs.has(hash);
+    }
+    async delete(hash) {
+        return this.blobs.delete(hash);
+    }
+    async list() {
+        return Array.from(this.blobs.keys());
+    }
+    async stat(hash) {
+        const entry = this.blobs.get(hash);
+        return entry ? { ...entry.meta } : null;
+    }
+}
+/**
+ * Browser-only IndexedDB-backed store. Loaded lazily so Node bundle
+ * paths don't trip on the missing global.
+ */
+export async function createIndexedDbBlobStore(opts = {}, hasher = fnv128) {
+    if (typeof indexedDB === 'undefined') {
+        throw new Error('@ifc-lite/collab: indexedDB is unavailable; createIndexedDbBlobStore requires a browser environment');
+    }
+    const dbName = opts.dbName ?? 'ifc-lite/collab/blobs';
+    const storeName = opts.storeName ?? 'blobs';
+    const db = await new Promise((resolve, reject) => {
+        const open = indexedDB.open(dbName, 1);
+        open.onupgradeneeded = () => {
+            open.result.createObjectStore(storeName, { keyPath: 'hash' });
+        };
+        open.onsuccess = () => resolve(open.result);
+        open.onerror = () => reject(open.error);
+    });
+    const tx = (mode) => db.transaction(storeName, mode).objectStore(storeName);
+    const promisify = (req) => new Promise((res, rej) => {
+        req.onsuccess = () => res(req.result);
+        req.onerror = () => rej(req.error);
+    });
+    return {
+        async put(bytes, contentType) {
+            const hash = hasher(bytes);
+            const meta = {
+                hash,
+                byteLength: bytes.byteLength,
+                contentType,
+                uploadedAt: new Date().toISOString(),
+            };
+            await promisify(tx('readwrite').put({ hash, bytes, meta }));
+            return meta;
+        },
+        async get(hash) {
+            const entry = await promisify(tx('readonly').get(hash));
+            if (!entry)
+                return null;
+            const bytes = entry.bytes;
+            return bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+        },
+        async has(hash) {
+            const count = await promisify(tx('readonly').count(hash));
+            return count > 0;
+        },
+        async delete(hash) {
+            const had = await this.has(hash);
+            if (!had)
+                return false;
+            await promisify(tx('readwrite').delete(hash));
+            return true;
+        },
+        async list() {
+            const keys = await promisify(tx('readonly').getAllKeys());
+            return keys;
+        },
+        async stat(hash) {
+            const entry = await promisify(tx('readonly').get(hash));
+            if (!entry)
+                return null;
+            return (entry.meta) ?? null;
+        },
+    };
+}
+export class HttpBlobStore {
+    opts;
+    hasher;
+    fetchImpl;
+    constructor(opts) {
+        this.opts = opts;
+        this.hasher = opts.hasher ?? fnv128;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    url(hash) {
+        return `${this.opts.baseUrl.replace(/\/$/, '')}/blobs/${hash}`;
+    }
+    headers(extra) {
+        const h = { ...(extra ?? {}) };
+        if (this.opts.token)
+            h['authorization'] = `Bearer ${this.opts.token}`;
+        return h;
+    }
+    async put(bytes, contentType) {
+        const hash = this.hasher(bytes);
+        const res = await this.fetchImpl(this.url(hash), {
+            method: 'PUT',
+            headers: this.headers({ 'content-type': contentType ?? 'application/octet-stream' }),
+            // TS 5.7's tightened `Uint8Array<ArrayBufferLike>` typing doesn't
+            // satisfy `BodyInit` directly; the runtime accepts Uint8Array fine.
+            body: bytes,
+        });
+        if (!res.ok) {
+            throw new Error(`@ifc-lite/collab: blob PUT failed: ${res.status} ${res.statusText}`);
+        }
+        return {
+            hash,
+            byteLength: bytes.byteLength,
+            contentType,
+            uploadedAt: new Date().toISOString(),
+        };
+    }
+    async get(hash) {
+        const res = await this.fetchImpl(this.url(hash), { headers: this.headers() });
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`@ifc-lite/collab: blob GET failed: ${res.status}`);
+        const buf = await res.arrayBuffer();
+        return new Uint8Array(buf);
+    }
+    async has(hash) {
+        const res = await this.fetchImpl(this.url(hash), { method: 'HEAD', headers: this.headers() });
+        return res.ok;
+    }
+    async delete(hash) {
+        const res = await this.fetchImpl(this.url(hash), { method: 'DELETE', headers: this.headers() });
+        if (res.status === 404)
+            return false;
+        if (!res.ok)
+            throw new Error(`@ifc-lite/collab: blob DELETE failed: ${res.status}`);
+        return true;
+    }
+    async list() {
+        const res = await this.fetchImpl(`${this.opts.baseUrl.replace(/\/$/, '')}/blobs`, {
+            headers: this.headers({ accept: 'application/json' }),
+        });
+        if (!res.ok)
+            throw new Error(`@ifc-lite/collab: blob list failed: ${res.status}`);
+        const json = (await res.json());
+        if (Array.isArray(json))
+            return json;
+        return json.hashes ?? [];
+    }
+    async stat(hash) {
+        const res = await this.fetchImpl(this.url(hash), { method: 'HEAD', headers: this.headers() });
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`@ifc-lite/collab: blob HEAD failed: ${res.status}`);
+        const len = res.headers.get('content-length');
+        return {
+            hash,
+            byteLength: len ? Number(len) : 0,
+            contentType: res.headers.get('content-type') ?? undefined,
+            uploadedAt: res.headers.get('last-modified') ?? undefined,
+        };
+    }
+}
+/* ------------------------------------------------------------------ */
+/* Layered (local-first) backend                                        */
+/* ------------------------------------------------------------------ */
+/**
+ * Read-through / write-through layering: writes go to `local` and `remote`
+ * in parallel; reads check `local` first and fall back to `remote`,
+ * caching the result locally on hit.
+ *
+ * This is what we recommend for browser apps: instant local reads, durable
+ * remote storage, and offline-first semantics for already-fetched blobs.
+ */
+export class LayeredBlobStore {
+    local;
+    remote;
+    constructor(local, remote) {
+        this.local = local;
+        this.remote = remote;
+    }
+    async put(bytes, contentType) {
+        const [meta] = await Promise.all([
+            this.local.put(bytes, contentType),
+            this.remote.put(bytes, contentType).catch(() => null),
+        ]);
+        return meta;
+    }
+    async get(hash) {
+        const local = await this.local.get(hash);
+        if (local)
+            return local;
+        const remote = await this.remote.get(hash);
+        if (remote) {
+            // Cache locally for next time. Best-effort.
+            this.local.put(remote).catch(() => {
+                /* writes to a full IDB store can fail; non-fatal */
+            });
+        }
+        return remote;
+    }
+    async has(hash) {
+        if (await this.local.has(hash))
+            return true;
+        return this.remote.has(hash);
+    }
+    async delete(hash) {
+        const [a, b] = await Promise.all([
+            this.local.delete(hash),
+            this.remote.delete(hash).catch(() => false),
+        ]);
+        return a || b;
+    }
+    async list() {
+        const [a, b] = await Promise.all([this.local.list(), this.remote.list().catch(() => [])]);
+        return Array.from(new Set([...a, ...b]));
+    }
+}
+//# sourceMappingURL=blob-store.js.map

package/dist/geometry/blob-store.js.map

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

package/dist/geometry/csg.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CSG (constructive solid geometry) operation tree as a Y.Array<CSGOp>.
+ *
+ * Spec §9.4 / §11 + open problem #4: full CRDT-tree merging of CSG ops is
+ * a v1.x topic. v0.1 stores ops as an ordered Y.Array — concurrent
+ * additions from two peers interleave preserving each peer's relative
+ * order, and a UI can drag-to-reorder via explicit moves. The CSG result
+ * is order-dependent; that's exposed honestly in the README.
+ *
+ * The geometry node referenced here is one of the Y.Doc's
+ * `geometry` top-level entries with `type: 'csg-tree'`. The tree's ops
+ * live as a Y.Array on `params.ops` so they ride the same CRDT machinery
+ * as parametric params.
+ */
+import * as Y from 'yjs';
+export type CSGBoolean = 'union' | 'difference' | 'intersection' | 'xor';
+export interface CSGOp {
+    /** Stable per-op UUID. We push (op) records, not (op, payload) pairs. */
+    opId: string;
+    /** Boolean operator applied between the previous accumulator and `operandGeomId`. */
+    op: CSGBoolean;
+    /** geomId of the operand — points into the same Y.Doc geometry map. */
+    operandGeomId: string;
+    /** Optional transform applied to the operand before the boolean. */
+    transform?: number[];
+    /** Authoring metadata (which user added this op). */
+    author?: string;
+    /** Wall-clock authoring time. */
+    at?: string;
+}
+export interface CreateCSGTreeOptions {
+    /** Optional initial op list. */
+    ops?: CSGOp[];
+    /** Initial bounding box estimate. */
+    bbox?: [number, number, number, number, number, number];
+}
+/**
+ * Get-or-create a CSG-tree geometry node and return its `ops` Y.Array.
+ *
+ * Idempotent: if the geometry already exists with `type==='csg-tree'`,
+ * returns the existing ops Y.Array.
+ */
+export declare function ensureCSGTree(doc: Y.Doc, geomId: string, options?: CreateCSGTreeOptions): Y.Array<CSGOp>;
+export declare function getCSGOps(doc: Y.Doc, geomId: string): CSGOp[];
+/** Append one CSG op. Concurrent appends interleave per Y.Array semantics. */
+export declare function appendCSGOp(doc: Y.Doc, geomId: string, op: CSGOp): number;
+/** Insert a CSG op at a specific index. */
+export declare function insertCSGOp(doc: Y.Doc, geomId: string, index: number, op: CSGOp): void;
+/**
+ * Remove a CSG op by `opId`. Returns true if found and removed.
+ *
+ * We search by opId rather than index so concurrent inserts elsewhere
+ * don't shift the target.
+ */
+export declare function removeCSGOp(doc: Y.Doc, geomId: string, opId: string): boolean;
+/**
+ * Reorder a CSG op (move by opId to a new index). Implemented as
+ * delete-then-insert; the underlying CRDT semantics keep concurrent
+ * reorder + reorder visible as the last-applied wins (ordering is what
+ * the user is *for sure* fighting over).
+ */
+export declare function moveCSGOp(doc: Y.Doc, geomId: string, opId: string, toIndex: number): boolean;
+//# sourceMappingURL=csg.d.ts.map

package/dist/geometry/csg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csg.d.ts","sourceRoot":"","sources":["../../src/geometry/csg.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,GAAG,KAAK,CAAC;AAEzE,MAAM,WAAW,KAAK;IACpB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,EAAE,EAAE,UAAU,CAAC;IACf,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAkBhB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAK7D;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,CAIzE;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,IAAI,CAGtF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU7E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAW5F"}