@prabhask5/stellar-engine 1.1.17 → 1.2.0

package/dist/crdt/provider.js

@@ -0,0 +1,543 @@
+/**
+ * @fileoverview CRDT Document Provider — Per-Document Lifecycle Manager
+ *
+ * The `CRDTProvider` is the central orchestrator for a single collaborative
+ * document. It manages:
+ *   - Yjs `Y.Doc` creation and state loading (from IndexedDB or Supabase)
+ *   - Wiring `doc.on('update')` to persistence, broadcast, and crash recovery
+ *   - Supabase Broadcast channel for real-time update distribution
+ *   - Periodic Supabase persistence timer
+ *   - Local IndexedDB full-state saves (debounced)
+ *   - Document lifecycle (open → edit → close → destroy)
+ *
+ * Module-level `Map<string, CRDTProvider>` tracks all active providers.
+ * Factory functions {@link openDocument} / {@link closeDocument} manage the lifecycle.
+ *
+ * @see {@link ./channel.ts} for Broadcast channel management
+ * @see {@link ./store.ts} for IndexedDB persistence
+ * @see {@link ./persistence.ts} for Supabase persistence
+ * @see {@link ./awareness.ts} for cursor/presence management
+ *
+ * @example
+ * import { openDocument, closeDocument } from '@prabhask5/stellar-engine/crdt';
+ *
+ * const provider = await openDocument('doc-1', 'page-1', { offlineEnabled: true });
+ * // provider.doc is a Y.Doc — use with your editor
+ * // ...
+ * await closeDocument('doc-1');
+ */
+import * as Y from 'yjs';
+import { debugLog, debugWarn } from '../debug';
+import { isOnline } from '../stores/network';
+import { getCRDTConfig } from './config';
+import { CRDTChannel } from './channel';
+import { loadDocumentState, saveDocumentState, appendPendingUpdate, loadPendingUpdates, clearPendingUpdates } from './store';
+import { fetchRemoteState, persistDocument } from './persistence';
+import { joinPresence, leavePresence } from './awareness';
+// =============================================================================
+//  Active Provider Registry
+// =============================================================================
+/**
+ * Tracks all currently active CRDT providers, keyed by `documentId`.
+ *
+ * This ensures:
+ *   1. `openDocument()` is idempotent — returns existing provider if already open
+ *   2. `closeAllDocuments()` can tear down everything on sign-out
+ *   3. Reconnection logic can iterate active providers
+ */
+const activeProviders = new Map();
+// =============================================================================
+//  CRDTProvider Implementation (internal)
+// =============================================================================
+/**
+ * Internal implementation of the CRDT provider.
+ *
+ * Manages the full lifecycle of a collaborative document: loading initial
+ * state, wiring update handlers, managing the Broadcast channel, and
+ * coordinating persistence.
+ *
+ * @internal
+ */
+class CRDTProviderImpl {
+    constructor(documentId, pageId, offlineEnabled) {
+        this._connectionState = 'disconnected';
+        this._isDirty = false;
+        /** Broadcast channel for this document. */
+        this.channel = null;
+        /** Timer for periodic Supabase persistence. */
+        this.persistTimer = null;
+        /** Timer for debounced local IndexedDB full-state saves. */
+        this.localSaveTimer = null;
+        /** Yjs update handler reference (for cleanup). */
+        this.updateHandler = null;
+        /** Whether this provider has been destroyed. */
+        this.destroyed = false;
+        /** Last state vector at the time of last Supabase persist (for dirty detection). */
+        this.lastPersistedStateVector = null;
+        /** Guard against concurrent persist operations. */
+        this.persistInProgress = false;
+        /** Whether the current online state is true. */
+        this._isOnline = true;
+        /** Store subscription cleanup function. */
+        this.onlineUnsubscribe = null;
+        this.documentId = documentId;
+        this.pageId = pageId;
+        this.offlineEnabled = offlineEnabled;
+        this.doc = new Y.Doc();
+    }
+    get connectionState() {
+        return this._connectionState;
+    }
+    get isDirty() {
+        return this._isDirty;
+    }
+    // ===========================================================================
+    //  Initialization
+    // ===========================================================================
+    /**
+     * Initialize the provider: load state, wire handlers, join channel.
+     *
+     * Called by {@link openDocument} after construction.
+     */
+    async init(options) {
+        /* Subscribe to online status. */
+        this.onlineUnsubscribe = isOnline.subscribe((online) => {
+            const wasOffline = !this._isOnline;
+            this._isOnline = online;
+            /* Reconnect on online transition. */
+            if (online && wasOffline && !this.destroyed) {
+                this.handleReconnect();
+            }
+        });
+        /* Step 1: Load initial state. */
+        await this.loadInitialState();
+        /* Step 2: Wire the update handler. */
+        this.wireUpdateHandler();
+        /* Step 3: Join the Broadcast channel (if online). */
+        if (this._isOnline) {
+            await this.joinChannel();
+            /* Step 4: Run sync protocol. */
+            if (this.channel) {
+                const peersResponded = await this.channel.waitForSync();
+                if (!peersResponded) {
+                    /* No peers online — fetch latest state from Supabase if available. */
+                    await this.fetchAndMergeRemoteState();
+                }
+            }
+        }
+        /* Step 5: Join presence if initial presence was provided. */
+        if (options.initialPresence) {
+            joinPresence(this.documentId, this.channel?.connectionState === 'connected', {
+                name: options.initialPresence.name,
+                avatarUrl: options.initialPresence.avatarUrl
+            });
+            /* Set presence info on the channel so Supabase Presence tracks this user. */
+            this.channel?.setPresenceInfo({
+                name: options.initialPresence.name,
+                avatarUrl: options.initialPresence.avatarUrl
+            });
+        }
+        /* Step 6: Start periodic Supabase persist timer. */
+        this.startPersistTimer();
+        /* Record initial state vector for dirty detection. */
+        this.lastPersistedStateVector = Y.encodeStateVector(this.doc);
+        debugLog(`[CRDT] Opening document ${this.documentId} (pageId=${this.pageId}, offlineEnabled=${this.offlineEnabled})`);
+    }
+    // ===========================================================================
+    //  State Loading
+    // ===========================================================================
+    /**
+     * Load the initial document state from IndexedDB or Supabase.
+     *
+     * Priority:
+     *   1. IndexedDB (if offline-enabled and has stored state)
+     *   2. Supabase (if online and no local state)
+     *   3. Empty doc (if offline and no local state)
+     */
+    async loadInitialState() {
+        /* Try IndexedDB first. */
+        const localRecord = await loadDocumentState(this.documentId);
+        if (localRecord) {
+            /* Apply stored full state. */
+            Y.applyUpdate(this.doc, localRecord.state);
+            /* Replay any pending updates that weren't captured in the last full save. */
+            const pendingUpdates = await loadPendingUpdates(this.documentId);
+            if (pendingUpdates.length > 0) {
+                for (const pending of pendingUpdates) {
+                    Y.applyUpdate(this.doc, pending.update);
+                }
+                debugLog(`[CRDT] Document ${this.documentId} loaded from IndexedDB (${localRecord.stateSize} bytes, ${pendingUpdates.length} pending updates)`);
+            }
+            else {
+                debugLog(`[CRDT] Document ${this.documentId} loaded from IndexedDB (${localRecord.stateSize} bytes, 0 pending updates)`);
+            }
+            return;
+        }
+        /* No local state — try Supabase if online. */
+        if (this._isOnline) {
+            await this.fetchAndMergeRemoteState();
+            return;
+        }
+        /* Offline with no local state — start with empty doc. */
+        debugLog(`[CRDT] Document ${this.documentId} started with empty state (offline, no local cache)`);
+    }
+    /**
+     * Fetch the latest document state from Supabase and merge into local doc.
+     */
+    async fetchAndMergeRemoteState() {
+        try {
+            const remoteState = await fetchRemoteState(this.pageId);
+            if (remoteState) {
+                Y.applyUpdate(this.doc, remoteState);
+                debugLog(`[CRDT] Document ${this.documentId} loaded from Supabase (${remoteState.byteLength} bytes)`);
+            }
+        }
+        catch (e) {
+            debugWarn(`[CRDT] Document ${this.documentId}: failed to fetch remote state:`, e);
+        }
+    }
+    // ===========================================================================
+    //  Update Handler
+    // ===========================================================================
+    /**
+     * Wire the `doc.on('update')` handler that drives all downstream effects.
+     *
+     * On each Yjs update:
+     *   1. Queue incremental update to IndexedDB (crash safety)
+     *   2. Broadcast to remote peers (debounced 100ms)
+     *   3. Broadcast to same-device tabs (immediate)
+     *   4. Schedule debounced full-state save to IndexedDB (5s)
+     */
+    wireUpdateHandler() {
+        this.updateHandler = (update, origin) => {
+            /* Skip updates that originated from remote peers (already persisted by them). */
+            if (origin === 'remote')
+                return;
+            this._isDirty = true;
+            /* 1. Crash-safe: append incremental update to IndexedDB. */
+            if (this.offlineEnabled) {
+                appendPendingUpdate(this.documentId, update).catch(() => {
+                    /* Non-critical — full state save will capture it. */
+                });
+            }
+            /* 2. Broadcast to remote peers (debounced). */
+            this.channel?.broadcastUpdate(update);
+            /* 3. Schedule debounced local full-state save. */
+            if (this.offlineEnabled) {
+                this.scheduleLocalSave();
+            }
+        };
+        this.doc.on('update', this.updateHandler);
+    }
+    // ===========================================================================
+    //  Local Persistence (IndexedDB)
+    // ===========================================================================
+    /**
+     * Schedule a debounced full-state save to IndexedDB.
+     *
+     * Resets the timer on each call so rapid edits don't cause excessive writes.
+     */
+    scheduleLocalSave() {
+        if (this.localSaveTimer) {
+            clearTimeout(this.localSaveTimer);
+        }
+        const config = getCRDTConfig();
+        this.localSaveTimer = setTimeout(() => {
+            this.localSaveTimer = null;
+            this.saveToIndexedDB();
+        }, config.localSaveDebounceMs);
+    }
+    /**
+     * Save the current full document state to IndexedDB.
+     *
+     * Also clears pending updates since they're now captured in the full state.
+     */
+    async saveToIndexedDB() {
+        if (this.destroyed)
+            return;
+        const state = Y.encodeStateAsUpdate(this.doc);
+        const stateVector = Y.encodeStateVector(this.doc);
+        const record = {
+            documentId: this.documentId,
+            pageId: this.pageId,
+            state,
+            stateVector,
+            offlineEnabled: this.offlineEnabled ? 1 : 0,
+            localUpdatedAt: new Date().toISOString(),
+            lastPersistedAt: null, // Will be set by Supabase persist
+            stateSize: state.byteLength
+        };
+        /* Preserve existing lastPersistedAt if we're just doing a local save. */
+        const existing = await loadDocumentState(this.documentId);
+        if (existing?.lastPersistedAt) {
+            record.lastPersistedAt = existing.lastPersistedAt;
+        }
+        await saveDocumentState(record);
+        await clearPendingUpdates(this.documentId);
+    }
+    // ===========================================================================
+    //  Supabase Persistence Timer
+    // ===========================================================================
+    /**
+     * Start the periodic timer that persists dirty documents to Supabase.
+     */
+    startPersistTimer() {
+        const config = getCRDTConfig();
+        this.persistTimer = setInterval(() => {
+            this.tryPersistToSupabase();
+        }, config.persistIntervalMs);
+    }
+    /**
+     * Attempt to persist the document to Supabase if it's dirty and online.
+     */
+    async tryPersistToSupabase() {
+        if (this.destroyed || !this._isOnline || !this._isDirty)
+            return;
+        /* Check if state has actually changed since last persist. */
+        const currentStateVector = Y.encodeStateVector(this.doc);
+        if (this.lastPersistedStateVector &&
+            arraysEqual(currentStateVector, this.lastPersistedStateVector)) {
+            debugLog(`[CRDT] Document ${this.documentId}: Supabase persist skipped (not dirty)`);
+            return;
+        }
+        /* Guard against concurrent persists. */
+        if (this.persistInProgress) {
+            debugLog(`[CRDT] Document ${this.documentId}: persist already in progress, skipping`);
+            return;
+        }
+        this.persistInProgress = true;
+        try {
+            await persistDocument(this.documentId, this.doc);
+            this.lastPersistedStateVector = currentStateVector;
+            this._isDirty = false;
+            /* Update local record's lastPersistedAt. */
+            if (this.offlineEnabled) {
+                const existing = await loadDocumentState(this.documentId);
+                if (existing) {
+                    existing.lastPersistedAt = new Date().toISOString();
+                    await saveDocumentState(existing);
+                }
+            }
+        }
+        catch (e) {
+            debugWarn(`[CRDT] Document ${this.documentId}: Supabase persist failed:`, e);
+        }
+        finally {
+            this.persistInProgress = false;
+        }
+    }
+    // ===========================================================================
+    //  Channel Management
+    // ===========================================================================
+    /**
+     * Join the Supabase Broadcast channel for this document.
+     */
+    async joinChannel() {
+        this.channel = new CRDTChannel(this.documentId, this.doc, (state) => {
+            this._connectionState = state;
+        });
+        await this.channel.join();
+    }
+    // ===========================================================================
+    //  Reconnection
+    // ===========================================================================
+    /**
+     * Handle offline → online transition.
+     *
+     * Merges pending updates, rejoins the Broadcast channel, runs sync protocol,
+     * and persists the merged state to Supabase.
+     */
+    async handleReconnect() {
+        debugLog(`[CRDT] Document ${this.documentId}: reconnecting after coming online`);
+        /* Merge any pending updates accumulated while offline. */
+        const pendingUpdates = await loadPendingUpdates(this.documentId);
+        if (pendingUpdates.length > 0) {
+            debugLog(`[CRDT] Document ${this.documentId}: merging ${pendingUpdates.length} pending updates after reconnect`);
+            for (const pending of pendingUpdates) {
+                Y.applyUpdate(this.doc, pending.update);
+            }
+        }
+        /* Rejoin Broadcast channel. */
+        if (this.channel) {
+            await this.channel.leave();
+        }
+        await this.joinChannel();
+        /* Run sync protocol. */
+        if (this.channel) {
+            const peersResponded = await this.channel.waitForSync();
+            if (!peersResponded) {
+                await this.fetchAndMergeRemoteState();
+            }
+        }
+        /* Broadcast our pending updates to peers. */
+        const state = Y.encodeStateAsUpdate(this.doc);
+        this.channel?.broadcastUpdate(state);
+        /* Immediately persist merged state to Supabase. */
+        this._isDirty = true;
+        await this.tryPersistToSupabase();
+        /* Clear pending updates (now captured in full state). */
+        await clearPendingUpdates(this.documentId);
+        debugLog(`[CRDT] Document ${this.documentId}: reconnection sync complete, state size ${state.byteLength} bytes`);
+    }
+    // ===========================================================================
+    //  Destruction
+    // ===========================================================================
+    /**
+     * Destroy this provider: save final state, leave channel, clean up.
+     */
+    async destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        debugLog(`[CRDT] Closing document ${this.documentId} (dirty=${this._isDirty}, online=${this._isOnline})`);
+        /* Stop timers. */
+        if (this.persistTimer) {
+            clearInterval(this.persistTimer);
+            this.persistTimer = null;
+        }
+        if (this.localSaveTimer) {
+            clearTimeout(this.localSaveTimer);
+            this.localSaveTimer = null;
+        }
+        /* Unwire update handler. */
+        if (this.updateHandler) {
+            this.doc.off('update', this.updateHandler);
+            this.updateHandler = null;
+        }
+        /* Unsubscribe from online store. */
+        if (this.onlineUnsubscribe) {
+            this.onlineUnsubscribe();
+            this.onlineUnsubscribe = null;
+        }
+        /* Save final state to IndexedDB. */
+        if (this.offlineEnabled) {
+            await this.saveToIndexedDB();
+        }
+        /* Persist to Supabase if online and dirty. */
+        if (this._isOnline && this._isDirty) {
+            await this.tryPersistToSupabase();
+        }
+        /* Leave presence. */
+        leavePresence(this.documentId);
+        /* Leave Broadcast channel. */
+        if (this.channel) {
+            await this.channel.leave();
+            this.channel = null;
+        }
+        /* Destroy Y.Doc. */
+        this.doc.destroy();
+        /* Remove from active providers. */
+        activeProviders.delete(this.documentId);
+    }
+}
+// =============================================================================
+//  Utility
+// =============================================================================
+/** Compare two Uint8Arrays for equality. */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+// =============================================================================
+//  Public Factory Functions
+// =============================================================================
+/**
+ * Open a collaborative CRDT document.
+ *
+ * Creates a new `CRDTProvider` for the document, loads its initial state
+ * (from IndexedDB or Supabase), wires update handlers, joins the Broadcast
+ * channel, and starts the periodic persist timer.
+ *
+ * **Idempotent:** If the document is already open, returns the existing provider.
+ *
+ * @param documentId - Unique identifier for the document.
+ * @param pageId - The page/entity this document belongs to.
+ * @param options - Optional configuration (offline mode, initial presence).
+ * @returns The active `CRDTProvider` for this document.
+ *
+ * @throws {Error} If CRDT is not configured in `initEngine()`.
+ *
+ * @example
+ * const provider = await openDocument('doc-1', 'page-1', {
+ *   offlineEnabled: true,
+ *   initialPresence: { name: 'Alice' },
+ * });
+ * const text = provider.doc.getText('content');
+ */
+export async function openDocument(documentId, pageId, options = {}) {
+    /* Ensure CRDT is configured (getCRDTConfig throws if not). */
+    getCRDTConfig();
+    /* Return existing provider if already open (idempotent). */
+    const existing = activeProviders.get(documentId);
+    if (existing)
+        return existing;
+    /* Create and initialize a new provider. */
+    const provider = new CRDTProviderImpl(documentId, pageId, options.offlineEnabled ?? false);
+    activeProviders.set(documentId, provider);
+    try {
+        await provider.init(options);
+    }
+    catch (e) {
+        /* Clean up on initialization failure. */
+        activeProviders.delete(documentId);
+        provider.doc.destroy();
+        throw e;
+    }
+    return provider;
+}
+/**
+ * Close a specific CRDT document.
+ *
+ * Saves final state, persists to Supabase if dirty, leaves the Broadcast
+ * channel, and destroys the Y.Doc.
+ *
+ * @param documentId - The document to close.
+ */
+export async function closeDocument(documentId) {
+    const provider = activeProviders.get(documentId);
+    if (!provider)
+        return;
+    await provider.destroy();
+}
+/**
+ * Close all active CRDT documents.
+ *
+ * Called during sign-out to ensure all documents are properly saved and
+ * all channels are cleaned up. Each document is closed in parallel.
+ */
+export async function closeAllDocuments() {
+    const count = activeProviders.size;
+    if (count === 0)
+        return;
+    debugLog(`[CRDT] All documents closed (count=${count})`);
+    const promises = Array.from(activeProviders.values()).map((p) => p.destroy());
+    await Promise.allSettled(promises);
+}
+/**
+ * Get the active provider for a document, if open.
+ *
+ * @param documentId - The document to look up.
+ * @returns The active provider, or `undefined` if not open.
+ * @internal
+ */
+export function getActiveProvider(documentId) {
+    return activeProviders.get(documentId);
+}
+/**
+ * Get all active provider entries for iteration.
+ *
+ * Used by {@link persistence.ts#persistAllDirty} to iterate and persist
+ * all dirty documents. Returns `[documentId, provider]` pairs.
+ *
+ * @returns Iterator of `[documentId, CRDTProvider]` entries.
+ * @internal
+ */
+export function getActiveProviderEntries() {
+    return activeProviders.entries();
+}
+//# sourceMappingURL=provider.js.map

package/dist/crdt/provider.js.map

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

package/dist/crdt/store.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview CRDT IndexedDB Persistence Layer
+ *
+ * Provides CRUD operations for the two CRDT-specific IndexedDB tables:
+ *   - `crdtDocuments` — Full Yjs document state snapshots
+ *   - `crdtPendingUpdates` — Incremental Yjs update deltas for crash recovery
+ *
+ * These tables are conditionally created by {@link ../database.ts#buildDexie}
+ * only when `crdt` config is provided to `initEngine()`.
+ *
+ * This module also exposes offline management query functions:
+ *   - {@link isOfflineEnabled} — check if a document is stored for offline
+ *   - {@link getOfflineDocuments} — list all offline-enabled documents
+ *   - {@link getOfflineDocumentCount} — count for limit enforcement
+ *
+ * All functions access Dexie via the engine-managed instance from
+ * {@link ../database.ts#getDb}. Binary Yjs state is stored directly as
+ * `Uint8Array` — Dexie/IndexedDB handles binary data natively.
+ *
+ * @see {@link ./types.ts} for record shapes (CRDTDocumentRecord, CRDTPendingUpdate)
+ * @see {@link ./provider.ts} for the orchestrator that calls these functions
+ * @see {@link ../database.ts} for conditional CRDT table creation
+ */
+import type { CRDTDocumentRecord, CRDTPendingUpdate } from './types';
+/**
+ * Load a CRDT document record from IndexedDB.
+ *
+ * @param documentId - The unique document identifier.
+ * @returns The document record, or `undefined` if not found.
+ */
+export declare function loadDocumentState(documentId: string): Promise<CRDTDocumentRecord | undefined>;
+/**
+ * Save a full CRDT document state snapshot to IndexedDB.
+ *
+ * Uses Dexie's `put()` for upsert semantics — creates a new record if the
+ * document doesn't exist, or overwrites the existing one.
+ *
+ * @param record - The full document record to persist.
+ */
+export declare function saveDocumentState(record: CRDTDocumentRecord): Promise<void>;
+/**
+ * Delete a CRDT document record from IndexedDB.
+ *
+ * Also clears all associated pending updates for the document.
+ *
+ * @param documentId - The document to delete.
+ */
+export declare function deleteDocumentState(documentId: string): Promise<void>;
+/**
+ * Load a CRDT document record by page ID.
+ *
+ * Pages may have at most one CRDT document. Returns the first match.
+ *
+ * @param pageId - The page/entity ID to look up.
+ * @returns The document record, or `undefined` if not found.
+ */
+export declare function loadDocumentByPageId(pageId: string): Promise<CRDTDocumentRecord | undefined>;
+/**
+ * Append an incremental Yjs update to the pending updates table.
+ *
+ * Called on every `doc.on('update')` event for crash safety. If the browser
+ * crashes between full-state saves (every 5s), these deltas can be replayed
+ * to recover the document.
+ *
+ * @param documentId - The document this update belongs to.
+ * @param update - The incremental Yjs update delta.
+ */
+export declare function appendPendingUpdate(documentId: string, update: Uint8Array): Promise<void>;
+/**
+ * Load all pending updates for a specific document, ordered by ID (insertion order).
+ *
+ * Used during document opening to replay any updates that weren't captured
+ * in the last full-state save.
+ *
+ * @param documentId - The document to load updates for.
+ * @returns Array of pending update records, oldest first.
+ */
+export declare function loadPendingUpdates(documentId: string): Promise<CRDTPendingUpdate[]>;
+/**
+ * Clear all pending updates for a document.
+ *
+ * Called after a successful full-state save to IndexedDB or Supabase persist,
+ * since the updates have been captured in the full state snapshot.
+ *
+ * @param documentId - The document to clear updates for.
+ * @returns The number of updates cleared.
+ */
+export declare function clearPendingUpdates(documentId: string): Promise<number>;
+/**
+ * Check whether a specific document is stored for offline access.
+ *
+ * @param documentId - The document to check.
+ * @returns `true` if the document has `offlineEnabled: 1` in IndexedDB.
+ */
+export declare function isOfflineEnabled(documentId: string): Promise<boolean>;
+/**
+ * Get all documents that are stored for offline access.
+ *
+ * @returns Array of document records with `offlineEnabled: 1`.
+ */
+export declare function getOfflineDocuments(): Promise<CRDTDocumentRecord[]>;
+/**
+ * Count the number of documents currently stored for offline access.
+ *
+ * Used by {@link ./offline.ts#enableOffline} to enforce the
+ * `maxOfflineDocuments` limit.
+ *
+ * @returns The number of offline-enabled documents.
+ */
+export declare function getOfflineDocumentCount(): Promise<number>;
+//# sourceMappingURL=store.d.ts.map

package/dist/crdt/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/crdt/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMrE;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAGzC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAGzC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/F;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAGzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7E;AAMD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAGzE;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG/D"}