@xtr-dev/rondevu-client 0.17.0 → 0.18.1

package/dist/rondevu.d.ts

@@ -10,6 +10,8 @@ export interface RondevuOptions {
     batching?: BatcherOptions | false;
     iceServers?: IceServerPreset | RTCIceServer[];
     debug?: boolean;
+    rtcPeerConnection?: typeof RTCPeerConnection;
+    rtcIceCandidate?: typeof RTCIceCandidate;
 }
 export interface OfferContext {
     pc: RTCPeerConnection;
@@ -103,6 +105,8 @@ export declare class Rondevu {
     private batchingOptions?;
     private iceServers;
     private debugEnabled;
+    private rtcPeerConnection?;
+    private rtcIceCandidate?;
     private currentService;
     private maxOffers;
     private offerFactory;

package/dist/rondevu.js

@@ -98,7 +98,7 @@ export const ICE_SERVER_PRESETS = {
  * ```
  */
 export class Rondevu {
-    constructor(apiUrl, username, keypair, api, iceServers, cryptoAdapter, batchingOptions, debugEnabled = false) {
+    constructor(apiUrl, username, keypair, api, iceServers, cryptoAdapter, batchingOptions, debugEnabled = false, rtcPeerConnection, rtcIceCandidate) {
         this.usernameClaimed = false;
         // Service management
         this.currentService = null;
@@ -118,6 +118,8 @@ export class Rondevu {
         this.cryptoAdapter = cryptoAdapter;
         this.batchingOptions = batchingOptions;
         this.debugEnabled = debugEnabled;
+        this.rtcPeerConnection = rtcPeerConnection;
+        this.rtcIceCandidate = rtcIceCandidate;
         this.debug('Instance created:', {
             username: this.username,
             publicKey: this.keypair.publicKey,
@@ -146,6 +148,13 @@ export class Rondevu {
      */
     static async connect(options) {
         const username = options.username || Rondevu.generateAnonymousUsername();
+        // Apply WebRTC polyfills to global scope if provided (Node.js environments)
+        if (options.rtcPeerConnection) {
+            globalThis.RTCPeerConnection = options.rtcPeerConnection;
+        }
+        if (options.rtcIceCandidate) {
+            globalThis.RTCIceCandidate = options.rtcIceCandidate;
+        }
         // Handle preset string or custom array
         let iceServers;
         if (typeof options.iceServers === 'string') {
@@ -181,7 +190,7 @@ export class Rondevu {
         const api = new RondevuAPI(options.apiUrl, username, keypair, options.cryptoAdapter, options.batching);
         if (options.debug)
             console.log('[Rondevu] Created API instance');
-        return new Rondevu(options.apiUrl, username, keypair, api, iceServers, options.cryptoAdapter, options.batching, options.debug || false);
+        return new Rondevu(options.apiUrl, username, keypair, api, iceServers, options.cryptoAdapter, options.batching, options.debug || false, options.rtcPeerConnection, options.rtcIceCandidate);
     }
     /**
      * Generate an anonymous username with timestamp and random component
@@ -252,7 +261,13 @@ export class Rondevu {
         pc.onicecandidate = async (event) => {
             if (event.candidate) {
                 try {
-                    await this.api.addOfferIceCandidates(serviceFqn, offerId, [event.candidate.toJSON()]);
+                    // Handle both browser and Node.js (wrtc) environments
+                    // Browser: candidate.toJSON() exists
+                    // Node.js wrtc: candidate is already a plain object
+                    const candidateData = typeof event.candidate.toJSON === 'function'
+                        ? event.candidate.toJSON()
+                        : event.candidate;
+                    await this.api.addOfferIceCandidates(serviceFqn, offerId, [candidateData]);
                 }
                 catch (err) {
                     console.error('[Rondevu] Failed to send ICE candidate:', err);
@@ -272,9 +287,39 @@ export class Rondevu {
         };
         this.debug('Creating new offer...');
         // Create the offer using the factory
+        // Note: The factory may call setLocalDescription() which triggers ICE gathering
         const { pc, dc, offer } = await this.offerFactory(rtcConfig);
         // Auto-append username to service
         const serviceFqn = `${this.currentService}@${this.username}`;
+        // Queue to buffer ICE candidates generated before we have the offerId
+        // This fixes the race condition where ICE candidates are lost because
+        // they're generated before we can set up the handler with the offerId
+        const earlyIceCandidates = [];
+        let offerId = null;
+        // Set up a queuing ICE candidate handler immediately after getting the pc
+        // This captures any candidates that fire before we have the offerId
+        pc.onicecandidate = async (event) => {
+            if (event.candidate) {
+                // Handle both browser and Node.js (wrtc) environments
+                const candidateData = typeof event.candidate.toJSON === 'function'
+                    ? event.candidate.toJSON()
+                    : event.candidate;
+                if (offerId) {
+                    // We have the offerId, send directly
+                    try {
+                        await this.api.addOfferIceCandidates(serviceFqn, offerId, [candidateData]);
+                    }
+                    catch (err) {
+                        console.error('[Rondevu] Failed to send ICE candidate:', err);
+                    }
+                }
+                else {
+                    // Queue for later - we don't have the offerId yet
+                    this.debug('Queuing early ICE candidate');
+                    earlyIceCandidates.push(candidateData);
+                }
+            }
+        };
         // Publish to server
         const result = await this.api.publishService({
             serviceFqn,
@@ -283,7 +328,7 @@ export class Rondevu {
             signature: '',
             message: '',
         });
-        const offerId = result.offers[0].offerId;
+        offerId = result.offers[0].offerId;
         // Store active offer
         this.activeOffers.set(offerId, {
             offerId,
@@ -294,8 +339,16 @@ export class Rondevu {
             createdAt: Date.now()
         });
         this.debug(`Offer created: ${offerId}`);
-        // Set up ICE candidate handler
-        this.setupIceCandidateHandler(pc, serviceFqn, offerId);
+        // Send any queued early ICE candidates
+        if (earlyIceCandidates.length > 0) {
+            this.debug(`Sending ${earlyIceCandidates.length} early ICE candidates`);
+            try {
+                await this.api.addOfferIceCandidates(serviceFqn, offerId, earlyIceCandidates);
+            }
+            catch (err) {
+                console.error('[Rondevu] Failed to send early ICE candidates:', err);
+            }
+        }
         // Monitor connection state
         pc.onconnectionstatechange = () => {
             this.debug(`Offer ${offerId} connection state: ${pc.connectionState}`);

package/package.json

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