@xtr-dev/rondevu-client 0.21.3 → 0.21.5

package/dist/api/client.d.ts

@@ -153,8 +153,11 @@ export declare class RondevuAPI {
     }>;
     /**
      * Answer an offer
+     * @param offerId The offer ID to answer
+     * @param sdp The SDP answer
+     * @param matchedTags Optional tags that were used to discover this offer
      */
-    answerOffer(offerId: string, sdp: string): Promise<void>;
+    answerOffer(offerId: string, sdp: string, matchedTags?: string[]): Promise<void>;
     /**
      * Get answer for a specific offer (offerer polls this)
      */
@@ -163,6 +166,7 @@ export declare class RondevuAPI {
         offerId: string;
         answererId: string;
         answeredAt: number;
+        matchedTags?: string[];
     } | null>;
     /**
      * Combined polling for answers and ICE candidates
@@ -173,6 +177,7 @@ export declare class RondevuAPI {
             answererId: string;
             sdp: string;
             answeredAt: number;
+            matchedTags?: string[];
         }>;
         iceCandidates: Record<string, Array<{
             candidate: RTCIceCandidateInit | null;

package/dist/api/client.js

@@ -325,11 +325,14 @@ export class RondevuAPI {
     // ============================================
     /**
      * Answer an offer
+     * @param offerId The offer ID to answer
+     * @param sdp The SDP answer
+     * @param matchedTags Optional tags that were used to discover this offer
      */
-    async answerOffer(offerId, sdp) {
+    async answerOffer(offerId, sdp, matchedTags) {
         const request = {
             method: 'answerOffer',
-            params: { offerId, sdp },
+            params: { offerId, sdp, matchedTags },
         };
         const authHeaders = await this.generateAuthHeaders(request);
         await this.rpc(request, authHeaders);

package/dist/connections/answerer.d.ts

@@ -14,6 +14,7 @@ export interface AnswererOptions {
     rtcConfig?: RTCConfiguration;
     webrtcAdapter?: WebRTCAdapter;
     config?: Partial<ConnectionConfig>;
+    matchedTags?: string[];
 }
 /**
  * Answerer connection - processes offers and creates answers
@@ -24,6 +25,7 @@ export declare class AnswererConnection extends RondevuConnection {
     private tags;
     private offerId;
     private offerSdp;
+    private matchedTags?;
     constructor(options: AnswererOptions);
     /**
      * Initialize the connection by processing offer and creating answer

package/dist/connections/answerer.js

@@ -14,6 +14,7 @@ export class AnswererConnection extends RondevuConnection {
         this.tags = options.tags;
         this.offerId = options.offerId;
         this.offerSdp = options.offerSdp;
+        this.matchedTags = options.matchedTags;
     }
     /**
      * Initialize the connection by processing offer and creating answer
@@ -43,8 +44,8 @@ export class AnswererConnection extends RondevuConnection {
         const answer = await this.pc.createAnswer();
         await this.pc.setLocalDescription(answer);
         this.debug('Answer created, sending to server');
-        // Send answer to server
-        await this.api.answerOffer(this.offerId, answer.sdp);
+        // Send answer to server (including matched tags so offerer knows which tags we searched for)
+        await this.api.answerOffer(this.offerId, answer.sdp, this.matchedTags);
         // Note: ICE candidate polling is handled by PollingManager
         // Candidates are received via handleRemoteIceCandidates()
         this.debug('Answer sent successfully');

package/dist/core/offer-pool.d.ts

@@ -22,7 +22,7 @@ export interface OfferPoolOptions {
     debugEnabled?: boolean;
 }
 interface OfferPoolEvents {
-    'connection:opened': (offerId: string, connection: OffererConnection) => void;
+    'connection:opened': (offerId: string, connection: OffererConnection, matchedTags?: string[]) => void;
     'offer:created': (offerId: string, tags: string[]) => void;
     'offer:failed': (offerId: string, error: Error) => void;
     'connection:rotated': (oldOfferId: string, newOfferId: string, connection: OffererConnection) => void;
@@ -34,7 +34,7 @@ interface OfferPoolEvents {
  */
 export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
     private readonly api;
-    private readonly tags;
+    private tags;
     private readonly ownerUsername;
     private readonly maxOffers;
     private readonly offerFactory;
@@ -45,6 +45,7 @@ export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
     private readonly connectionConfig?;
     private readonly debugEnabled;
     private readonly activeConnections;
+    private readonly matchedTagsByOffer;
     private readonly fillLock;
     private running;
     constructor(options: OfferPoolOptions);
@@ -62,6 +63,16 @@ export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
      * Get count of active offers
      */
     getOfferCount(): number;
+    /**
+     * Update tags for new offers
+     * Existing offers keep their old tags until they expire/rotate
+     * New offers created during fill will use the updated tags
+     */
+    updateTags(newTags: string[]): void;
+    /**
+     * Get current tags
+     */
+    getTags(): string[];
     /**
      * Get all active connections
      */

package/dist/core/offer-pool.js

@@ -11,6 +11,7 @@ export class OfferPool extends EventEmitter {
         super();
         // State
         this.activeConnections = new Map();
+        this.matchedTagsByOffer = new Map(); // Track matchedTags from answers
         this.fillLock = new AsyncLock();
         this.running = false;
         this.api = options.api;
@@ -62,6 +63,21 @@ export class OfferPool extends EventEmitter {
     getOfferCount() {
         return this.activeConnections.size;
     }
+    /**
+     * Update tags for new offers
+     * Existing offers keep their old tags until they expire/rotate
+     * New offers created during fill will use the updated tags
+     */
+    updateTags(newTags) {
+        this.debug(`Updating tags: ${newTags.join(', ')}`);
+        this.tags = newTags;
+    }
+    /**
+     * Get current tags
+     */
+    getTags() {
+        return [...this.tags];
+    }
     /**
      * Get all active connections
      */
@@ -191,8 +207,13 @@ export class OfferPool extends EventEmitter {
         });
         // Setup connection event handlers
         connection.on('connected', () => {
-            this.debug(`Connection established for offer ${offerId}`);
-            this.emit('connection:opened', offerId, connection);
+            // Use getOfferId() to get current ID after potential rotations
+            const currentOfferId = connection.getOfferId();
+            this.debug(`Connection established for offer ${currentOfferId}`);
+            // Get and clean up matchedTags
+            const matchedTags = this.matchedTagsByOffer.get(currentOfferId);
+            this.matchedTagsByOffer.delete(currentOfferId);
+            this.emit('connection:opened', currentOfferId, connection, matchedTags);
         });
         connection.on('failed', async (error) => {
             const currentOfferId = connection.getOfferId();
@@ -245,6 +266,10 @@ export class OfferPool extends EventEmitter {
         const connection = this.activeConnections.get(data.offerId);
         if (connection) {
             this.debug(`Processing answer for offer ${data.offerId}`);
+            // Store matchedTags for when connection opens
+            if (data.matchedTags) {
+                this.matchedTagsByOffer.set(data.offerId, data.matchedTags);
+            }
             try {
                 await connection.processAnswer(data.sdp, data.answererId);
                 // Create replacement offer

package/dist/core/peer.js

@@ -94,6 +94,7 @@ export class Peer extends EventEmitter {
                 ...this.connectionConfig,
                 debug: this.debugEnabled,
             },
+            matchedTags: this.tags, // Pass the tags we used to discover this offer
         });
         // Wire up events
         this.setupEventHandlers();

package/dist/core/polling-manager.d.ts

@@ -14,6 +14,7 @@ export interface PollAnswerEvent {
     answererId: string;
     sdp: string;
     answeredAt: number;
+    matchedTags?: string[];
 }
 export interface PollIceEvent {
     offerId: string;

package/dist/core/polling-manager.js

@@ -82,6 +82,7 @@ export class PollingManager extends EventEmitter {
                     answererId: answer.answererId,
                     sdp: answer.sdp,
                     answeredAt: answer.answeredAt,
+                    matchedTags: answer.matchedTags,
                 });
                 // Update last poll timestamp
                 if (answer.answeredAt > this.lastPollTimestamp) {

package/dist/core/rondevu.d.ts

@@ -173,6 +173,13 @@ export declare class Rondevu extends EventEmitter {
      * Similar to stopFilling() but doesn't stop the polling/filling process
      */
     disconnectAll(): void;
+    /**
+     * Update tags for new offers
+     * Existing offers keep their old tags until they expire/rotate
+     * New offers created during fill will use the updated tags
+     * @param newTags - The new tags to use for future offers
+     */
+    updateOfferTags(newTags: string[]): void;
     /**
      * Get the current publishing status
      * @returns Object with publishing state information

package/dist/core/rondevu.js

@@ -222,8 +222,8 @@ export class Rondevu extends EventEmitter {
             debugEnabled: this.debugEnabled,
         });
         // Forward events from OfferPool
-        this.offerPool.on('connection:opened', (offerId, connection) => {
-            this.emit('connection:opened', offerId, connection);
+        this.offerPool.on('connection:opened', (offerId, connection, matchedTags) => {
+            this.emit('connection:opened', offerId, connection, matchedTags);
         });
         this.offerPool.on('offer:created', (offerId, tags) => {
             this.emit('offer:created', offerId, tags);
@@ -314,6 +314,17 @@ export class Rondevu extends EventEmitter {
         this.debug('Disconnecting all offers');
         this.offerPool?.disconnectAll();
     }
+    /**
+     * Update tags for new offers
+     * Existing offers keep their old tags until they expire/rotate
+     * New offers created during fill will use the updated tags
+     * @param newTags - The new tags to use for future offers
+     */
+    updateOfferTags(newTags) {
+        this.debug(`Updating offer tags: ${newTags.join(', ')}`);
+        this.currentTags = newTags;
+        this.offerPool?.updateTags(newTags);
+    }
     /**
      * Get the current publishing status
      * @returns Object with publishing state information

package/package.json

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