@prabhask5/stellar-engine 1.1.18 → 1.2.0

package/dist/crdt/channel.js

@@ -0,0 +1,522 @@
+/**
+ * @fileoverview CRDT Broadcast Channel — Supabase Realtime Transport
+ *
+ * Manages one Supabase Broadcast + Presence channel per open CRDT document.
+ * Responsible for:
+ *   - Distributing Yjs updates to remote peers via Broadcast
+ *   - Receiving and applying remote updates (with echo suppression)
+ *   - Debouncing outbound updates and merging via `Y.mergeUpdates()`
+ *   - Chunking payloads that exceed the Broadcast size limit
+ *   - Running the sync protocol on join (exchange state vectors, send deltas)
+ *   - Cross-tab sync via browser `BroadcastChannel` API (avoids Supabase for same-device)
+ *   - Reconnection with exponential backoff
+ *
+ * Channel naming convention: `crdt:${prefix}:${documentId}`
+ *
+ * @see {@link ./provider.ts} for the orchestrator that creates channels
+ * @see {@link ./types.ts} for message type definitions
+ * @see {@link ./awareness.ts} for Presence management (separate concern)
+ */
+import * as Y from 'yjs';
+import { supabase } from '../supabase/client';
+import { getDeviceId } from '../deviceId';
+import { debugLog, debugWarn } from '../debug';
+import { getCRDTConfig, getCRDTPrefix } from './config';
+import { handlePresenceJoin, handlePresenceLeave, assignColor } from './awareness';
+// =============================================================================
+//  Binary ↔ Base64 Encoding Utilities
+// =============================================================================
+/**
+ * Encode a `Uint8Array` to a base64 string for JSON transport.
+ *
+ * Uses the browser's built-in `btoa()` via a binary string intermediary.
+ * This is necessary because Supabase Broadcast payloads are JSON — binary
+ * data must be string-encoded.
+ */
+function uint8ToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Decode a base64 string back to a `Uint8Array`.
+ */
+function base64ToUint8(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+// =============================================================================
+//  CRDTChannel Class
+// =============================================================================
+/**
+ * Manages the Supabase Broadcast channel for a single CRDT document.
+ *
+ * Handles update distribution, echo suppression, debouncing, chunking,
+ * the sync protocol, cross-tab sync, and reconnection.
+ *
+ * @internal — consumers interact via {@link ./provider.ts}, not this class directly.
+ */
+export class CRDTChannel {
+    constructor(documentId, doc, onConnectionStateChange) {
+        /** Supabase Realtime channel instance. */
+        this.channel = null;
+        /** Browser BroadcastChannel for cross-tab sync (same device). */
+        this.localChannel = null;
+        /** Current connection state. */
+        this._connectionState = 'disconnected';
+        /** Callback invoked when connection state changes. */
+        this.onConnectionStateChange = null;
+        /** Initial presence info for Supabase Presence tracking. */
+        this.presenceInfo = null;
+        // --- Debounce state ---
+        this.pendingUpdates = [];
+        this.debounceTimer = null;
+        // --- Chunk reassembly state ---
+        this.chunkBuffers = new Map();
+        // --- Reconnection state ---
+        this.reconnectAttempts = 0;
+        this.reconnectTimer = null;
+        this.destroyed = false;
+        // --- Sync protocol state ---
+        this.syncResolvers = new Map();
+        this.documentId = documentId;
+        this.doc = doc;
+        this.deviceId = getDeviceId();
+        this.channelName = `crdt:${getCRDTPrefix()}:${documentId}`;
+        this.onConnectionStateChange = onConnectionStateChange ?? null;
+    }
+    // ===========================================================================
+    //  Public API
+    // ===========================================================================
+    /** Current connection state of the channel. */
+    get connectionState() {
+        return this._connectionState;
+    }
+    /**
+     * Set the local user's presence info for Supabase Presence tracking.
+     *
+     * Call this before `join()` to announce presence immediately on channel subscribe,
+     * or after join to update the tracked presence.
+     */
+    setPresenceInfo(info) {
+        this.presenceInfo = info;
+        /* If already connected, track immediately. */
+        if (this.channel && this._connectionState === 'connected') {
+            this.trackPresence();
+        }
+    }
+    /**
+     * Join the Broadcast channel and start receiving messages.
+     *
+     * After subscribing, initiates the sync protocol by sending a sync-step-1
+     * message with the local state vector so peers can respond with deltas.
+     */
+    async join() {
+        if (this.destroyed)
+            return;
+        this.setConnectionState('connecting');
+        debugLog(`[CRDT] Channel ${this.channelName} joining`);
+        /* Create Supabase Broadcast channel. */
+        this.channel = supabase.channel(this.channelName, {
+            config: { broadcast: { self: false } }
+        });
+        /* Listen for Broadcast messages. */
+        this.channel.on('broadcast', { event: 'crdt' }, (payload) => {
+            this.handleBroadcastMessage(payload.payload);
+        });
+        /* Listen for Presence events (join/leave). */
+        this.channel.on('presence', { event: 'join' }, ({ newPresences }) => {
+            for (const presence of newPresences) {
+                const state = presence;
+                if (state.deviceId !== this.deviceId) {
+                    handlePresenceJoin(this.documentId, state);
+                }
+            }
+        });
+        this.channel.on('presence', { event: 'leave' }, ({ leftPresences }) => {
+            for (const presence of leftPresences) {
+                const state = presence;
+                handlePresenceLeave(this.documentId, state.userId, state.deviceId);
+            }
+        });
+        /* Subscribe to the channel. */
+        this.channel.subscribe((status) => {
+            if (status === 'SUBSCRIBED') {
+                this.setConnectionState('connected');
+                this.reconnectAttempts = 0;
+                debugLog(`[CRDT] Channel ${this.channelName} subscribed`);
+                /* Track presence if info is available. */
+                this.trackPresence();
+                /* Initiate sync protocol — request missing updates from peers. */
+                this.sendSyncStep1();
+            }
+            else if (status === 'CHANNEL_ERROR') {
+                debugWarn(`[CRDT] Channel ${this.channelName} error`);
+                this.handleDisconnect();
+            }
+            else if (status === 'CLOSED') {
+                this.setConnectionState('disconnected');
+            }
+        });
+        /* Set up cross-tab sync via browser BroadcastChannel API. */
+        this.setupLocalChannel();
+    }
+    /**
+     * Leave the channel and clean up all resources.
+     */
+    async leave() {
+        this.destroyed = true;
+        debugLog(`[CRDT] Channel ${this.channelName} leaving`);
+        /* Clear debounce timer. */
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        /* Clear reconnect timer. */
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        /* Flush any pending updates before leaving. */
+        if (this.pendingUpdates.length > 0) {
+            this.flushUpdates();
+        }
+        /* Unsubscribe from Supabase channel. */
+        if (this.channel) {
+            await supabase.removeChannel(this.channel);
+            this.channel = null;
+        }
+        /* Close browser BroadcastChannel. */
+        if (this.localChannel) {
+            this.localChannel.close();
+            this.localChannel = null;
+        }
+        this.setConnectionState('disconnected');
+        this.chunkBuffers.clear();
+        this.syncResolvers.clear();
+    }
+    /**
+     * Queue a Yjs update for broadcasting to remote peers.
+     *
+     * Updates are debounced for `broadcastDebounceMs` (default 100ms) and merged
+     * via `Y.mergeUpdates()` before sending. This reduces network traffic for
+     * rapid keystrokes while keeping latency under 100ms.
+     *
+     * @param update - The Yjs update delta from `doc.on('update')`.
+     */
+    broadcastUpdate(update) {
+        if (this.destroyed || this._connectionState !== 'connected')
+            return;
+        this.pendingUpdates.push(update);
+        /* Also broadcast to same-device tabs immediately (no debounce). */
+        this.localChannel?.postMessage({
+            type: 'update',
+            data: uint8ToBase64(update),
+            deviceId: this.deviceId
+        });
+        /* Debounce the Supabase Broadcast send. */
+        if (!this.debounceTimer) {
+            const config = getCRDTConfig();
+            this.debounceTimer = setTimeout(() => {
+                this.debounceTimer = null;
+                this.flushUpdates();
+            }, config.broadcastDebounceMs);
+        }
+    }
+    /**
+     * Wait for the sync protocol to complete after joining.
+     *
+     * Resolves when at least one peer responds with sync-step-2, or times out
+     * after `syncPeerTimeoutMs` (default 3s) if no peers are available.
+     *
+     * @returns `true` if a peer responded, `false` if timed out (no peers).
+     */
+    waitForSync() {
+        const config = getCRDTConfig();
+        return new Promise((resolve) => {
+            const key = `sync-${Date.now()}`;
+            let resolved = false;
+            this.syncResolvers.set(key, () => {
+                if (!resolved) {
+                    resolved = true;
+                    resolve(true);
+                }
+            });
+            setTimeout(() => {
+                this.syncResolvers.delete(key);
+                if (!resolved) {
+                    resolved = true;
+                    debugLog(`[CRDT] Document ${this.documentId}: no peers responded within ${config.syncPeerTimeoutMs}ms, fetching from Supabase`);
+                    resolve(false);
+                }
+            }, config.syncPeerTimeoutMs);
+        });
+    }
+    // ===========================================================================
+    //  Message Handling
+    // ===========================================================================
+    /**
+     * Handle an incoming Broadcast message from a remote peer.
+     *
+     * Dispatches to type-specific handlers and performs echo suppression
+     * (skip messages from our own device).
+     */
+    handleBroadcastMessage(message) {
+        /* Echo suppression — skip messages from our own device. */
+        if (message.deviceId === this.deviceId) {
+            debugLog(`[CRDT] Document ${this.documentId}: skipped own-device echo (deviceId=${this.deviceId})`);
+            return;
+        }
+        switch (message.type) {
+            case 'update':
+                this.handleRemoteUpdate(message);
+                break;
+            case 'sync-step-1':
+                this.handleSyncStep1(message);
+                break;
+            case 'sync-step-2':
+                this.handleSyncStep2(message);
+                break;
+            case 'chunk':
+                this.handleChunk(message);
+                break;
+        }
+    }
+    /**
+     * Apply a remote Yjs update to the local document.
+     */
+    handleRemoteUpdate(message) {
+        const update = base64ToUint8(message.data);
+        debugLog(`[CRDT] Document ${this.documentId}: received remote update from device ${message.deviceId} (${update.byteLength} bytes)`);
+        Y.applyUpdate(this.doc, update);
+    }
+    /**
+     * Handle sync-step-1: a peer is requesting missing updates.
+     *
+     * We compute the delta between our state and their state vector,
+     * then send it back as sync-step-2.
+     */
+    handleSyncStep1(message) {
+        const remoteStateVector = base64ToUint8(message.stateVector);
+        const update = Y.encodeStateAsUpdate(this.doc, remoteStateVector);
+        if (update.byteLength > 0) {
+            debugLog(`[CRDT] Document ${this.documentId}: sync-step-2 sent to ${message.deviceId} (${update.byteLength} bytes)`);
+            this.sendMessage({
+                type: 'sync-step-2',
+                update: uint8ToBase64(update),
+                deviceId: this.deviceId
+            });
+        }
+    }
+    /**
+     * Handle sync-step-2: a peer responded to our sync-step-1 with a delta.
+     */
+    handleSyncStep2(message) {
+        const update = base64ToUint8(message.update);
+        debugLog(`[CRDT] Document ${this.documentId}: sync-step-2 received from ${message.deviceId} (${update.byteLength} bytes)`);
+        Y.applyUpdate(this.doc, update);
+        /* Resolve any pending sync waiters. */
+        for (const resolver of this.syncResolvers.values()) {
+            resolver();
+        }
+        this.syncResolvers.clear();
+    }
+    /**
+     * Handle a chunk message — part of a large payload that was split.
+     *
+     * Buffers chunks until all parts arrive, then reassembles and processes
+     * the full payload as a regular message.
+     */
+    handleChunk(message) {
+        const { chunkId, index, total, data } = message;
+        let buffer = this.chunkBuffers.get(chunkId);
+        if (!buffer) {
+            buffer = { total, chunks: new Map() };
+            this.chunkBuffers.set(chunkId, buffer);
+        }
+        buffer.chunks.set(index, data);
+        /* Check if all chunks have arrived. */
+        if (buffer.chunks.size === buffer.total) {
+            /* Reassemble in order. */
+            let fullBase64 = '';
+            for (let i = 0; i < buffer.total; i++) {
+                fullBase64 += buffer.chunks.get(i) ?? '';
+            }
+            this.chunkBuffers.delete(chunkId);
+            /* Process as an update message. */
+            const update = base64ToUint8(fullBase64);
+            debugLog(`[CRDT] Document ${this.documentId}: reassembled ${buffer.total} chunks (${update.byteLength} bytes)`);
+            Y.applyUpdate(this.doc, update);
+        }
+    }
+    // ===========================================================================
+    //  Outbound Message Sending
+    // ===========================================================================
+    /**
+     * Flush all pending updates: merge, encode, and send via Broadcast.
+     *
+     * If the merged payload exceeds the max size, it is chunked.
+     */
+    flushUpdates() {
+        if (this.pendingUpdates.length === 0)
+            return;
+        const updates = this.pendingUpdates;
+        this.pendingUpdates = [];
+        /* Merge all buffered updates into a single binary payload. */
+        const merged = updates.length === 1 ? updates[0] : Y.mergeUpdates(updates);
+        const config = getCRDTConfig();
+        debugLog(`[CRDT] Document ${this.documentId}: ${updates.length} updates buffered (${merged.byteLength} bytes), broadcasting`);
+        const base64Data = uint8ToBase64(merged);
+        if (base64Data.length > config.maxBroadcastPayloadBytes) {
+            /* Payload too large — chunk it. */
+            this.sendChunked(base64Data);
+        }
+        else {
+            this.sendMessage({
+                type: 'update',
+                data: base64Data,
+                deviceId: this.deviceId
+            });
+        }
+    }
+    /**
+     * Send sync-step-1 to request missing updates from connected peers.
+     */
+    sendSyncStep1() {
+        const stateVector = Y.encodeStateVector(this.doc);
+        debugLog(`[CRDT] Document ${this.documentId}: sync-step-1 sent (stateVector ${stateVector.byteLength} bytes)`);
+        this.sendMessage({
+            type: 'sync-step-1',
+            stateVector: uint8ToBase64(stateVector),
+            deviceId: this.deviceId
+        });
+    }
+    /**
+     * Send a message via the Supabase Broadcast channel.
+     */
+    sendMessage(message) {
+        if (!this.channel || this._connectionState !== 'connected')
+            return;
+        this.channel.send({
+            type: 'broadcast',
+            event: 'crdt',
+            payload: message
+        });
+    }
+    /**
+     * Split a large base64 payload into chunks and send each one.
+     */
+    sendChunked(base64Data) {
+        const config = getCRDTConfig();
+        /* Use ~200KB per chunk to stay safely below the limit. */
+        const chunkSize = Math.floor(config.maxBroadcastPayloadBytes * 0.8);
+        const totalChunks = Math.ceil(base64Data.length / chunkSize);
+        const chunkId = `${this.deviceId}-${Date.now()}`;
+        debugWarn(`[CRDT] Document ${this.documentId}: chunking broadcast payload (${base64Data.length} bytes > ${config.maxBroadcastPayloadBytes} bytes, ${totalChunks} chunks)`);
+        for (let i = 0; i < totalChunks; i++) {
+            const start = i * chunkSize;
+            const end = Math.min(start + chunkSize, base64Data.length);
+            this.sendMessage({
+                type: 'chunk',
+                chunkId,
+                index: i,
+                total: totalChunks,
+                data: base64Data.slice(start, end),
+                deviceId: this.deviceId
+            });
+        }
+    }
+    // ===========================================================================
+    //  Cross-Tab Sync (Browser BroadcastChannel)
+    // ===========================================================================
+    /**
+     * Set up the browser BroadcastChannel for same-device tab sync.
+     *
+     * This avoids Supabase Broadcast for updates between tabs on the same device,
+     * which is faster and doesn't consume any network bandwidth.
+     */
+    setupLocalChannel() {
+        if (typeof BroadcastChannel === 'undefined')
+            return;
+        this.localChannel = new BroadcastChannel(this.channelName);
+        this.localChannel.onmessage = (event) => {
+            const message = event.data;
+            /* Skip our own messages (same tab). */
+            if (message.deviceId === this.deviceId)
+                return;
+            /* Apply update from another tab on the same device. */
+            if (message.type === 'update') {
+                const update = base64ToUint8(message.data);
+                Y.applyUpdate(this.doc, update);
+            }
+        };
+    }
+    // ===========================================================================
+    //  Reconnection
+    // ===========================================================================
+    /**
+     * Handle a channel disconnect — attempt reconnection with exponential backoff.
+     */
+    handleDisconnect() {
+        if (this.destroyed)
+            return;
+        this.setConnectionState('disconnected');
+        const config = getCRDTConfig();
+        if (this.reconnectAttempts >= config.maxReconnectAttempts) {
+            debugWarn(`[CRDT] Channel ${this.channelName} max reconnect attempts reached (${config.maxReconnectAttempts})`);
+            return;
+        }
+        this.reconnectAttempts++;
+        const delay = config.reconnectBaseDelayMs * Math.pow(2, this.reconnectAttempts - 1);
+        debugLog(`[CRDT] Channel ${this.channelName} reconnecting (attempt ${this.reconnectAttempts}/${config.maxReconnectAttempts}, delay ${delay}ms)`);
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            if (this.destroyed)
+                return;
+            /* Clean up old channel before rejoining. */
+            if (this.channel) {
+                await supabase.removeChannel(this.channel);
+                this.channel = null;
+            }
+            await this.join();
+        }, delay);
+    }
+    // ===========================================================================
+    //  State Management
+    // ===========================================================================
+    /**
+     * Track the local user's presence on the Supabase Presence channel.
+     *
+     * Sends the user's name, avatar, color, and device ID so other collaborators
+     * can display cursor badges and avatar lists.
+     */
+    trackPresence() {
+        if (!this.channel || !this.presenceInfo || this._connectionState !== 'connected')
+            return;
+        const presenceState = {
+            userId: this.deviceId, // Will be replaced with actual userId when auth is available
+            name: this.presenceInfo.name,
+            avatarUrl: this.presenceInfo.avatarUrl,
+            color: assignColor(this.deviceId),
+            deviceId: this.deviceId,
+            lastActiveAt: new Date().toISOString()
+        };
+        this.channel.track(presenceState);
+    }
+    /**
+     * Update the connection state and notify the listener.
+     */
+    setConnectionState(state) {
+        if (this._connectionState === state)
+            return;
+        this._connectionState = state;
+        this.onConnectionStateChange?.(state);
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/crdt/channel.js.map

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

package/dist/crdt/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview CRDT Configuration Singleton
+ *
+ * Manages the resolved CRDT configuration singleton. The raw {@link CRDTConfig}
+ * (with optional fields) is provided by the consumer via `initEngine({ crdt: ... })`.
+ * This module applies sensible defaults and stores the result as a
+ * {@link ResolvedCRDTConfig} singleton, accessible to all other CRDT modules
+ * via {@link getCRDTConfig}.
+ *
+ * Initialization flow:
+ *   1. Consumer calls `initEngine({ crdt: { ... } })`
+ *   2. `config.ts#initEngine` calls `_initCRDT(rawConfig, prefix)`
+ *   3. This module merges defaults → stores singleton
+ *   4. Other CRDT modules call `getCRDTConfig()` to read the resolved config
+ *
+ * If `initEngine()` is called without a `crdt` field, the singleton remains
+ * `null` and `getCRDTConfig()` throws with a descriptive error message.
+ *
+ * @see {@link ../config.ts} for the `initEngine()` entry point
+ * @see {@link ./types.ts} for the config interfaces
+ */
+import type { CRDTConfig, ResolvedCRDTConfig } from './types';
+/**
+ * Initialize the CRDT configuration singleton.
+ *
+ * Called internally by {@link ../config.ts#initEngine} when `config.crdt` is
+ * provided. Merges user-provided values with defaults and stores the result.
+ *
+ * @param rawConfig - The user-provided CRDT config (with optional fields).
+ * @param prefix - The application prefix from `SyncEngineConfig.prefix`.
+ * @internal
+ */
+export declare function _initCRDT(rawConfig: CRDTConfig, prefix: string): void;
+/**
+ * Get the resolved CRDT configuration.
+ *
+ * @throws {Error} If CRDT was not configured in `initEngine()`.
+ * @returns The fully resolved {@link ResolvedCRDTConfig} with all defaults applied.
+ */
+export declare function getCRDTConfig(): ResolvedCRDTConfig;
+/**
+ * Get the application prefix for use in channel naming and storage keys.
+ *
+ * @throws {Error} If CRDT was not configured in `initEngine()`.
+ * @returns The prefix string (e.g., `'myapp'`).
+ */
+export declare function getCRDTPrefix(): string;
+/**
+ * Check whether the CRDT subsystem has been initialized.
+ *
+ * Unlike {@link getCRDTConfig}, this does not throw — it returns a boolean.
+ * Used by conditional code paths that need to check CRDT availability
+ * without triggering an error (e.g., sign-out cleanup).
+ *
+ * @returns `true` if `_initCRDT()` has been called.
+ */
+export declare function isCRDTEnabled(): boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/crdt/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA4C9D;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgBrE;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAKlD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}