@affectively/dash 5.3.0 → 5.4.0

package/dist/src/sync/hybrid-provider.d.ts

@@ -11,26 +11,103 @@ export declare class HybridProvider extends Observable<string> {
     private wt;
     private connected;
     private url;
+    private activeRelayUrl;
     private roomName;
     awareness: awarenessProtocol.Awareness;
     private writer;
     private highFrequencyMode;
+    private connectionState;
+    private reconnectAttempts;
+    private readonly maxReconnectDelay;
+    private readonly baseReconnectDelay;
+    private reconnectTimeout;
+    private relayDiscovery;
+    private discoveredRelayUrls;
+    private relayDiscoveryCursor;
+    private lastRelayDiscoveryAt;
+    private relayHealth;
+    private relayPerformance;
+    private compressionEngine;
+    private adaptiveCompression;
+    private batchTiming;
+    private outboundQueue;
+    private outboundQueueBytes;
+    private batchFlushTimeout;
+    private flushingBatch;
+    private lastCompressionRatio;
+    private relayPrivacy;
+    private roomCryptoKey;
+    private roomCryptoKeyReady;
+    private localCapabilitiesBitmask;
+    private peerCapabilities;
+    private protocolVersion;
+    private lastCapabilityAdvertisedAt;
     private aeonConfig;
     private deltaAdapter;
     private presenceAdapter;
     private offlineAdapter;
-    constructor(url: string, roomName: string, doc: Y.Doc, { awareness, aeonConfig, }?: {
+    constructor(url: string, roomName: string, doc: Y.Doc, { awareness, aeonConfig, relayDiscovery, relayPerformance, relayPrivacy, }?: {
         awareness?: awarenessProtocol.Awareness;
         aeonConfig?: AeonConfig;
+        relayDiscovery?: RelayDiscoveryConfig;
+        relayPerformance?: RelayPerformanceConfig;
+        relayPrivacy?: RelayPrivacyConfig;
     });
     private connect;
     private connectWebSocket;
+    /**
+     * Schedule reconnection with exponential backoff + jitter
+     * Prevents thundering herd on network flapping
+     */
+    private scheduleReconnect;
+    private seedAdaptiveNetworkProfile;
+    private initializeRoomCryptoKey;
+    private getRoomCryptoKey;
+    private computeLocalCapabilities;
+    private getKnownRemoteClientIds;
+    private isCapabilityEnabled;
+    private capabilityListFromBitmask;
+    private sendCapabilitiesAdvertisement;
+    private reconcilePeerCapabilities;
     private getAuthToken;
+    private resolveRelayUrl;
+    private discoverRelayUrls;
+    private fetchRelayCandidates;
+    private rankRelayUrls;
+    private scoreRelay;
+    private recordRelaySuccess;
+    private recordRelayFailure;
     enterHighFrequencyMode(): Promise<void>;
     private sendSyncStep1;
+    /**
+     * Read loop for WebTransport with dynamic buffer sizing
+     * Handles payloads larger than initial buffer
+     */
     private readLoop;
+    /**
+     * Handle incoming message with protocol validation
+     * Never silently ignores malformed messages
+     */
     private handleMessage;
+    /**
+     * Send message with error handling and offline queue fallback
+     * Never fails silently - either sends, queues, or throws
+     */
     private send;
+    private enqueueOutbound;
+    private scheduleBatchFlush;
+    private flushOutboundQueue;
+    private encodeBatchFrame;
+    private applyOutboundPipeline;
+    private maybeCompressPayload;
+    private decompressPayload;
+    private maybeEncryptPayload;
+    private decryptPayload;
+    private sendSingleFrame;
+    /**
+     * Queue message for offline sync
+     */
+    private queueForOffline;
     private onDocUpdate;
     private onAwarenessUpdate;
     destroy(): void;
@@ -61,6 +138,11 @@ export declare class HybridProvider extends Observable<string> {
      * Get comprehensive connection status
      */
     getConnectionStatus(): ConnectionStatus;
+    /**
+     * Force immediate reconnection (resets backoff)
+     * Use when user explicitly requests reconnect
+     */
+    forceReconnect(): void;
     /**
      * Get all awareness states from connected peers
      */
@@ -96,18 +178,66 @@ export declare class HybridProvider extends Observable<string> {
 }
 export interface ConnectionStatus {
     connected: boolean;
+    connectionState: 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
     roomName: string;
     url: string;
+    reconnectAttempts: number;
     websocket: {
         state: 'connecting' | 'open' | 'closing' | 'closed';
         connected: boolean;
+        bufferedAmount: number;
     };
     webTransport: {
         connected: boolean;
         highFrequencyMode: boolean;
     };
+    discovery: {
+        enabled: boolean;
+        knownRelays: number;
+        lastDiscoveryAt: number | null;
+        targetPeerId: string;
+    };
+    performance: {
+        batching: boolean;
+        adaptiveCompression: boolean;
+        activeBatching: boolean;
+        activeCompression: boolean;
+        queuedFrames: number;
+        lastCompressionRatio: number | null;
+    };
+    privacy: {
+        enabled: boolean;
+        keyLoaded: boolean;
+        activeEncryption: boolean;
+    };
+    protocol: {
+        version: number;
+        localCapabilities: string[];
+        knownPeers: number;
+    };
     transport: 'WebSocket' | 'WebTransport';
 }
+export interface RelayDiscoveryConfig {
+    enabled?: boolean;
+    bootstrapUrls?: string[];
+    discoveryPath?: string;
+    refreshIntervalMs?: number;
+    requestTimeoutMs?: number;
+    maxCandidates?: number;
+    dhtQueryEnabled?: boolean;
+    targetPeerId?: string;
+}
+export interface RelayPerformanceConfig {
+    enableAdaptiveCompression?: boolean;
+    enableBatching?: boolean;
+    compressionThresholdBytes?: number;
+    maxBatchDelayMs?: number;
+    maxBatchSizeBytes?: number;
+}
+export interface RelayPrivacyConfig {
+    enabled?: boolean;
+    roomKey?: string | Uint8Array;
+}
 export interface AwarenessState {
     clientId: number;
     state: Record<string, unknown>;
@@ -169,4 +299,9 @@ export interface AeonStatus {
         away: number;
         offline: number;
     } | null;
+    compression: {
+        averageCompressionMs: number;
+        averageRatio: number;
+        networkCondition: 'fast' | 'normal' | 'slow' | 'offline';
+    } | null;
 }