@xtr-dev/rondevu-client 0.2.2 → 0.3.0

package/README.md

@@ -24,10 +24,12 @@ npm install @xtr-dev/rondevu-client
 
 ### Usage
 
+#### Browser
+
 ```typescript
 import { Rondevu } from '@xtr-dev/rondevu-client';
 
-const rdv = new Rondevu({ 
+const rdv = new Rondevu({
   baseUrl: 'https://server.com',
   rtcConfig: {
     iceServers: [
@@ -56,6 +58,44 @@ conn.on('connect', () => {
 });
 ```
 
+#### Node.js
+
+In Node.js, you need to provide a WebRTC polyfill since WebRTC APIs are not natively available:
+
+```bash
+npm install @roamhq/wrtc
+# or
+npm install wrtc
+```
+
+```typescript
+import { Rondevu } from '@xtr-dev/rondevu-client';
+import wrtc from '@roamhq/wrtc';
+import fetch from 'node-fetch';
+
+const rdv = new Rondevu({
+  baseUrl: 'https://server.com',
+  fetch: fetch as any,
+  wrtc: {
+    RTCPeerConnection: wrtc.RTCPeerConnection,
+    RTCSessionDescription: wrtc.RTCSessionDescription,
+    RTCIceCandidate: wrtc.RTCIceCandidate,
+  },
+  rtcConfig: {
+    iceServers: [
+      { urls: 'stun:stun.l.google.com:19302' }
+    ]
+  }
+});
+
+// Rest is the same as browser usage
+const conn = await rdv.join('room');
+conn.on('connect', () => {
+  const channel = conn.dataChannel('chat');
+  channel.send('Hello from Node.js!');
+});
+```
+
 ### API
 
 **Main Methods:**

package/dist/connection.d.ts

@@ -19,6 +19,8 @@ export declare class RondevuConnection extends EventEmitter {
     private connectionTimer?;
     private isPolling;
     private isClosed;
+    private wrtc?;
+    private RTCIceCandidate;
     constructor(params: RondevuConnectionParams, client: RondevuAPI);
     /**
      * Setup RTCPeerConnection event handlers

package/dist/connection.js

@@ -17,6 +17,9 @@ export class RondevuConnection extends EventEmitter {
         this.dataChannels = new Map();
         this.pollingIntervalMs = params.pollingInterval;
         this.connectionTimeoutMs = params.connectionTimeout;
+        this.wrtc = params.wrtc;
+        // Use injected WebRTC polyfill or fall back to global
+        this.RTCIceCandidate = params.wrtc?.RTCIceCandidate || globalThis.RTCIceCandidate;
         this.setupEventHandlers();
         this.startConnectionTimeout();
     }
@@ -148,7 +151,7 @@ export class RondevuConnection extends EventEmitter {
                     for (const candidateStr of offererResponse.answerCandidates) {
                         try {
                             const candidate = JSON.parse(candidateStr);
-                            await this.pc.addIceCandidate(new RTCIceCandidate(candidate));
+                            await this.pc.addIceCandidate(new this.RTCIceCandidate(candidate));
                         }
                         catch (err) {
                             console.warn('Failed to add ICE candidate:', err);
@@ -164,7 +167,7 @@ export class RondevuConnection extends EventEmitter {
                     for (const candidateStr of answererResponse.offerCandidates) {
                         try {
                             const candidate = JSON.parse(candidateStr);
-                            await this.pc.addIceCandidate(new RTCIceCandidate(candidate));
+                            await this.pc.addIceCandidate(new this.RTCIceCandidate(candidate));
                         }
                         catch (err) {
                             console.warn('Failed to add ICE candidate:', err);

package/dist/index.d.ts

@@ -5,4 +5,4 @@
 export { Rondevu } from './rondevu.js';
 export { RondevuConnection } from './connection.js';
 export { RondevuAPI } from './client.js';
-export type { RondevuOptions, JoinOptions, ConnectionRole, RondevuConnectionParams, RondevuConnectionEvents, Side, Session, TopicInfo, Pagination, ListTopicsResponse, ListSessionsResponse, CreateOfferRequest, CreateOfferResponse, AnswerRequest, AnswerResponse, PollRequest, PollOffererResponse, PollAnswererResponse, PollResponse, VersionResponse, HealthResponse, ErrorResponse, RondevuClientOptions, } from './types.js';
+export type { RondevuOptions, JoinOptions, ConnectionRole, RondevuConnectionParams, RondevuConnectionEvents, WebRTCPolyfill, Side, Session, TopicInfo, Pagination, ListTopicsResponse, ListSessionsResponse, CreateOfferRequest, CreateOfferResponse, AnswerRequest, AnswerResponse, PollRequest, PollOffererResponse, PollAnswererResponse, PollResponse, VersionResponse, HealthResponse, ErrorResponse, RondevuClientOptions, } from './types.js';

package/dist/rondevu.d.ts

@@ -12,6 +12,9 @@ export declare class Rondevu {
     private rtcConfig?;
     private pollingInterval;
     private connectionTimeout;
+    private wrtc?;
+    private RTCPeerConnection;
+    private RTCIceCandidate;
     /**
      * Creates a new Rondevu client instance
      * @param options - Client configuration options

package/dist/rondevu.js

@@ -11,6 +11,7 @@ export class Rondevu {
     constructor(options = {}) {
         this.baseUrl = options.baseUrl || 'https://rondevu.xtrdev.workers.dev';
         this.fetchImpl = options.fetch;
+        this.wrtc = options.wrtc;
         this.api = new RondevuAPI({
             baseUrl: this.baseUrl,
             fetch: options.fetch,
@@ -20,6 +21,14 @@ export class Rondevu {
         this.rtcConfig = options.rtcConfig;
         this.pollingInterval = options.pollingInterval || 1000;
         this.connectionTimeout = options.connectionTimeout || 30000;
+        // Use injected WebRTC polyfill or fall back to global
+        this.RTCPeerConnection = options.wrtc?.RTCPeerConnection || globalThis.RTCPeerConnection;
+        this.RTCIceCandidate = options.wrtc?.RTCIceCandidate || globalThis.RTCIceCandidate;
+        if (!this.RTCPeerConnection) {
+            throw new Error('RTCPeerConnection not available. ' +
+                'In Node.js, provide a WebRTC polyfill via the wrtc option. ' +
+                'Install: npm install @roamhq/wrtc or npm install wrtc');
+        }
     }
     /**
      * Generate a unique peer ID
@@ -41,7 +50,7 @@ export class Rondevu {
      */
     async create(id, topic) {
         // Create peer connection
-        const pc = new RTCPeerConnection(this.rtcConfig);
+        const pc = new this.RTCPeerConnection(this.rtcConfig);
         // Create initial data channel for negotiation (required for offer creation)
         pc.createDataChannel('_negotiation');
         // Generate offer
@@ -65,6 +74,7 @@ export class Rondevu {
             remotePeerId: '', // Will be populated when answer is received
             pollingInterval: this.pollingInterval,
             connectionTimeout: this.connectionTimeout,
+            wrtc: this.wrtc,
         };
         const connection = new RondevuConnection(connectionParams, this.api);
         // Start polling for answer
@@ -83,7 +93,7 @@ export class Rondevu {
             throw new Error(`Connection ${id} not found or expired`);
         }
         // Create peer connection
-        const pc = new RTCPeerConnection(this.rtcConfig);
+        const pc = new this.RTCPeerConnection(this.rtcConfig);
         // Set remote offer
         await pc.setRemoteDescription({
             type: 'offer',
@@ -110,6 +120,7 @@ export class Rondevu {
             remotePeerId: sessionData.peerId,
             pollingInterval: this.pollingInterval,
             connectionTimeout: this.connectionTimeout,
+            wrtc: this.wrtc,
         };
         const connection = new RondevuConnection(connectionParams, this.api);
         // Start polling for ICE candidates

package/dist/types.d.ts

@@ -151,6 +151,14 @@ export interface RondevuClientOptions {
     /** Optional fetch implementation (for Node.js environments) */
     fetch?: typeof fetch;
 }
+/**
+ * WebRTC polyfill for Node.js and other non-browser platforms
+ */
+export interface WebRTCPolyfill {
+    RTCPeerConnection: typeof RTCPeerConnection;
+    RTCSessionDescription: typeof RTCSessionDescription;
+    RTCIceCandidate: typeof RTCIceCandidate;
+}
 /**
  * Configuration options for Rondevu WebRTC client
  */
@@ -167,6 +175,8 @@ export interface RondevuOptions {
     pollingInterval?: number;
     /** Connection timeout in milliseconds (default: 30000) */
     connectionTimeout?: number;
+    /** WebRTC polyfill for Node.js (e.g., wrtc or @roamhq/wrtc) */
+    wrtc?: WebRTCPolyfill;
 }
 /**
  * Options for joining a topic
@@ -196,6 +206,7 @@ export interface RondevuConnectionParams {
     remotePeerId: string;
     pollingInterval: number;
     connectionTimeout: number;
+    wrtc?: WebRTCPolyfill;
 }
 /**
  * Event map for RondevuConnection events

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtr-dev/rondevu-client",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "TypeScript client for Rondevu peer signaling and discovery server",
   "type": "module",
   "main": "dist/index.js",