@xtr-dev/rondevu-client 0.21.12 → 0.21.13

package/dist/connections/answerer.d.ts

@@ -32,9 +32,9 @@ export declare class AnswererConnection extends RondevuConnection {
      */
     initialize(): Promise<void>;
     /**
-     * Handle local ICE candidate generation
+     * Send buffered ICE candidates to the server in a single batch
      */
-    protected onLocalIceCandidate(candidate: RTCIceCandidate): void;
+    protected sendBufferedIceCandidates(candidates: RTCIceCandidate[]): void;
     /**
      * Get the API instance
      */

package/dist/connections/answerer.js

@@ -51,22 +51,21 @@ export class AnswererConnection extends RondevuConnection {
         this.debug('Answer sent successfully');
     }
     /**
-     * Handle local ICE candidate generation
+     * Send buffered ICE candidates to the server in a single batch
      */
-    onLocalIceCandidate(candidate) {
-        this.debug('Generated local ICE candidate');
+    sendBufferedIceCandidates(candidates) {
+        if (candidates.length === 0)
+            return;
+        this.debug(`Sending ${candidates.length} ICE candidates in batch`);
         // For answerer, we add ICE candidates to the offer
         // The server will make them available for the offerer to poll
-        this.api
-            .addOfferIceCandidates(this.offerId, [
-            {
-                candidate: candidate.candidate,
-                sdpMLineIndex: candidate.sdpMLineIndex,
-                sdpMid: candidate.sdpMid,
-            },
-        ])
-            .catch(error => {
-            this.debug('Failed to send ICE candidate:', error);
+        const apiCandidates = candidates.map(c => ({
+            candidate: c.candidate,
+            sdpMLineIndex: c.sdpMLineIndex,
+            sdpMid: c.sdpMid,
+        }));
+        this.api.addOfferIceCandidates(this.offerId, apiCandidates).catch(error => {
+            this.debug('Failed to send ICE candidates:', error);
         });
     }
     /**

package/dist/connections/base.d.ts

@@ -27,6 +27,9 @@ export declare abstract class RondevuConnection extends EventEmitter<ConnectionE
     protected lastIcePollTime: number;
     protected answerProcessed: boolean;
     protected answerSdpFingerprint: string | null;
+    protected iceCandidateBuffer: RTCIceCandidate[];
+    protected iceCandidateFlushTimer: ReturnType<typeof setTimeout> | null;
+    protected static readonly ICE_BUFFER_DELAY_MS = 20;
     constructor(rtcConfig?: RTCConfiguration | undefined, userConfig?: Partial<ConnectionConfig>, webrtcAdapter?: WebRTCAdapter);
     /**
      * Transition to a new state and emit events
@@ -42,8 +45,17 @@ export declare abstract class RondevuConnection extends EventEmitter<ConnectionE
     protected setupDataChannelHandlers(dc: RTCDataChannel): void;
     /**
      * Handle local ICE candidate generation
+     * Buffers candidates for batched sending to reduce server requests
      */
     protected handleIceCandidate(event: RTCPeerConnectionIceEvent): void;
+    /**
+     * Buffer an ICE candidate for batched sending
+     */
+    protected bufferIceCandidate(candidate: RTCIceCandidate): void;
+    /**
+     * Flush buffered ICE candidates to the server
+     */
+    protected flushIceCandidates(): void;
     /**
      * Handle ICE connection state changes (primary state driver)
      */
@@ -166,6 +178,6 @@ export declare abstract class RondevuConnection extends EventEmitter<ConnectionE
      * Debug logging helper
      */
     protected debug(...args: unknown[]): void;
-    protected abstract onLocalIceCandidate(candidate: RTCIceCandidate): void;
+    protected abstract sendBufferedIceCandidates(candidates: RTCIceCandidate[]): void;
     protected abstract attemptReconnect(): void;
 }

package/dist/connections/base.js

@@ -32,6 +32,9 @@ export class RondevuConnection extends EventEmitter {
         // Answer fingerprinting (for offerer)
         this.answerProcessed = false;
         this.answerSdpFingerprint = null;
+        // ICE candidate buffering for batched sending
+        this.iceCandidateBuffer = [];
+        this.iceCandidateFlushTimer = null;
         this.config = mergeConnectionConfig(userConfig);
         this.webrtcAdapter = webrtcAdapter || new BrowserWebRTCAdapter();
         // Initialize message buffer if enabled
@@ -102,12 +105,45 @@ export class RondevuConnection extends EventEmitter {
     }
     /**
      * Handle local ICE candidate generation
+     * Buffers candidates for batched sending to reduce server requests
      */
     handleIceCandidate(event) {
         this.emit('ice:candidate:local', event.candidate);
         if (event.candidate) {
-            this.onLocalIceCandidate(event.candidate);
+            this.bufferIceCandidate(event.candidate);
         }
+        else {
+            // null candidate means ICE gathering complete - flush any remaining
+            this.flushIceCandidates();
+        }
+    }
+    /**
+     * Buffer an ICE candidate for batched sending
+     */
+    bufferIceCandidate(candidate) {
+        this.iceCandidateBuffer.push(candidate);
+        // Reset flush timer
+        if (this.iceCandidateFlushTimer) {
+            clearTimeout(this.iceCandidateFlushTimer);
+        }
+        this.iceCandidateFlushTimer = setTimeout(() => {
+            this.flushIceCandidates();
+        }, RondevuConnection.ICE_BUFFER_DELAY_MS);
+    }
+    /**
+     * Flush buffered ICE candidates to the server
+     */
+    flushIceCandidates() {
+        if (this.iceCandidateFlushTimer) {
+            clearTimeout(this.iceCandidateFlushTimer);
+            this.iceCandidateFlushTimer = null;
+        }
+        if (this.iceCandidateBuffer.length === 0)
+            return;
+        const candidates = [...this.iceCandidateBuffer];
+        this.iceCandidateBuffer = [];
+        this.debug(`Flushing ${candidates.length} buffered ICE candidates`);
+        this.sendBufferedIceCandidates(candidates);
     }
     /**
      * Handle ICE connection state changes (primary state driver)
@@ -496,6 +532,12 @@ export class RondevuConnection extends EventEmitter {
         this.cancelReconnect();
         // Stop ICE polling
         this.stopIcePolling();
+        // Clear ICE candidate buffer
+        if (this.iceCandidateFlushTimer) {
+            clearTimeout(this.iceCandidateFlushTimer);
+            this.iceCandidateFlushTimer = null;
+        }
+        this.iceCandidateBuffer = [];
         // Close data channel
         if (this.dc) {
             this.dc.onopen = null;
@@ -533,3 +575,4 @@ export class RondevuConnection extends EventEmitter {
         }
     }
 }
+RondevuConnection.ICE_BUFFER_DELAY_MS = 20; // Buffer for 20ms before sending

package/dist/connections/offerer.d.ts

@@ -54,9 +54,9 @@ export declare class OffererConnection extends RondevuConnection {
      */
     private hashSdp;
     /**
-     * Handle local ICE candidate generation
+     * Send buffered ICE candidates to the server in a single batch
      */
-    protected onLocalIceCandidate(candidate: RTCIceCandidate): void;
+    protected sendBufferedIceCandidates(candidates: RTCIceCandidate[]): void;
     /**
      * Get the API instance
      */

package/dist/connections/offerer.js

@@ -193,21 +193,20 @@ export class OffererConnection extends RondevuConnection {
         }
     }
     /**
-     * Handle local ICE candidate generation
+     * Send buffered ICE candidates to the server in a single batch
      */
-    onLocalIceCandidate(candidate) {
-        this.debug('Generated local ICE candidate');
-        // Send ICE candidate to server
-        this.api
-            .addOfferIceCandidates(this.offerId, [
-            {
-                candidate: candidate.candidate,
-                sdpMLineIndex: candidate.sdpMLineIndex,
-                sdpMid: candidate.sdpMid,
-            },
-        ])
-            .catch(error => {
-            this.debug('Failed to send ICE candidate:', error);
+    sendBufferedIceCandidates(candidates) {
+        if (candidates.length === 0)
+            return;
+        this.debug(`Sending ${candidates.length} ICE candidates in batch`);
+        // Convert to API format and send in single request
+        const apiCandidates = candidates.map(c => ({
+            candidate: c.candidate,
+            sdpMLineIndex: c.sdpMLineIndex,
+            sdpMid: c.sdpMid,
+        }));
+        this.api.addOfferIceCandidates(this.offerId, apiCandidates).catch(error => {
+            this.debug('Failed to send ICE candidates:', error);
         });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/rondevu-client",
-  "version": "0.21.12",
+  "version": "0.21.13",
   "description": "TypeScript client for Rondevu with durable WebRTC connections, automatic reconnection, and message queuing",
   "type": "module",
   "main": "dist/core/index.js",