@xtr-dev/rondevu-client 0.21.3 → 0.21.6

package/dist/connections/offerer.d.ts

@@ -7,7 +7,7 @@ import { ConnectionConfig } from './config.js';
 import { WebRTCAdapter } from '../webrtc/adapter.js';
 export interface OffererOptions {
     api: RondevuAPI;
-    ownerUsername: string;
+    ownerPublicKey: string;
     offerId: string;
     pc: RTCPeerConnection;
     dc?: RTCDataChannel;
@@ -19,9 +19,9 @@ export interface OffererOptions {
  */
 export declare class OffererConnection extends RondevuConnection {
     private api;
-    private ownerUsername;
+    private ownerPublicKey;
     private offerId;
-    private _peerUsername;
+    private _peerPublicKey;
     private rotationLock;
     private rotating;
     private rotationAttempts;
@@ -35,7 +35,7 @@ export declare class OffererConnection extends RondevuConnection {
     /**
      * Process an answer from the answerer
      */
-    processAnswer(sdp: string, answererId: string): Promise<void>;
+    processAnswer(sdp: string, answererPublicKey: string): Promise<void>;
     /**
      * Rebind this connection to a new offer (when previous offer failed)
      * Keeps the same connection object alive but with new underlying WebRTC
@@ -62,9 +62,9 @@ export declare class OffererConnection extends RondevuConnection {
      */
     protected getApi(): any;
     /**
-     * Get the owner username
+     * Get the owner public key
      */
-    protected getOwnerUsername(): string;
+    protected getOwnerPublicKey(): string;
     /**
      * Offerers accept all ICE candidates (no filtering)
      */
@@ -92,10 +92,10 @@ export declare class OffererConnection extends RondevuConnection {
      */
     getOfferId(): string;
     /**
-     * Get the peer username (who answered this offer)
+     * Get the peer public key (who answered this offer)
      * Returns null if no answer has been processed yet
      */
-    get peerUsername(): string | null;
+    get peerPublicKey(): string | null;
     /**
      * Handle remote ICE candidates received from polling
      * Called by OfferPool when poll:ice event is received

package/dist/connections/offerer.js

@@ -11,7 +11,7 @@ export class OffererConnection extends RondevuConnection {
     constructor(options) {
         // Force reconnectEnabled: false for offerer connections (offers are ephemeral)
         super(undefined, { ...options.config, reconnectEnabled: false }, options.webrtcAdapter);
-        this._peerUsername = null;
+        this._peerPublicKey = null;
         // Rotation tracking
         this.rotationLock = new AsyncLock();
         this.rotating = false;
@@ -19,7 +19,7 @@ export class OffererConnection extends RondevuConnection {
         // ICE candidate buffering (for candidates received before answer is processed)
         this.pendingIceCandidates = [];
         this.api = options.api;
-        this.ownerUsername = options.ownerUsername;
+        this.ownerPublicKey = options.ownerPublicKey;
         this.offerId = options.offerId;
         // Use the already-created peer connection and data channel
         this.pc = options.pc;
@@ -49,7 +49,7 @@ export class OffererConnection extends RondevuConnection {
     /**
      * Process an answer from the answerer
      */
-    async processAnswer(sdp, answererId) {
+    async processAnswer(sdp, answererPublicKey) {
         if (!this.pc) {
             this.debug('Cannot process answer: peer connection not initialized');
             return;
@@ -82,10 +82,10 @@ export class OffererConnection extends RondevuConnection {
                 type: 'answer',
                 sdp,
             });
-            // Store the peer username
-            this._peerUsername = answererId;
-            this.debug(`Answer processed successfully from ${answererId}`);
-            this.emit('answer:processed', this.offerId, answererId);
+            // Store the peer public key
+            this._peerPublicKey = answererPublicKey;
+            this.debug(`Answer processed successfully from ${answererPublicKey}`);
+            this.emit('answer:processed', this.offerId, answererPublicKey);
             // Apply any buffered ICE candidates that arrived before the answer
             if (this.pendingIceCandidates.length > 0) {
                 this.debug(`Applying ${this.pendingIceCandidates.length} buffered ICE candidates`);
@@ -129,10 +129,10 @@ export class OffererConnection extends RondevuConnection {
                 this.offerId = newOfferId;
                 this.pc = newPc;
                 this.dc = newDc || null;
-                // 3. Reset answer processing flags, peer username, and pending candidates
+                // 3. Reset answer processing flags, peer public key, and pending candidates
                 this.answerProcessed = false;
                 this.answerSdpFingerprint = null;
-                this._peerUsername = null;
+                this._peerPublicKey = null;
                 this.pendingIceCandidates = [];
                 // 4. Setup event handlers for new peer connection
                 this.pc.onicecandidate = event => this.handleIceCandidate(event);
@@ -217,10 +217,10 @@ export class OffererConnection extends RondevuConnection {
         return this.api;
     }
     /**
-     * Get the owner username
+     * Get the owner public key
      */
-    getOwnerUsername() {
-        return this.ownerUsername;
+    getOwnerPublicKey() {
+        return this.ownerPublicKey;
     }
     /**
      * Offerers accept all ICE candidates (no filtering)
@@ -256,11 +256,11 @@ export class OffererConnection extends RondevuConnection {
         return this.offerId;
     }
     /**
-     * Get the peer username (who answered this offer)
+     * Get the peer public key (who answered this offer)
      * Returns null if no answer has been processed yet
      */
-    get peerUsername() {
-        return this._peerUsername;
+    get peerPublicKey() {
+        return this._peerPublicKey;
     }
     /**
      * Handle remote ICE candidates received from polling

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

@@ -11,7 +11,7 @@ export type OfferFactory = (pc: RTCPeerConnection) => Promise<{
 export interface OfferPoolOptions {
     api: RondevuAPI;
     tags: string[];
-    ownerUsername: string;
+    ownerPublicKey: string;
     maxOffers: number;
     offerFactory: OfferFactory;
     ttl: number;
@@ -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,8 +34,8 @@ interface OfferPoolEvents {
  */
 export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
     private readonly api;
-    private readonly tags;
-    private readonly ownerUsername;
+    private tags;
+    private readonly ownerPublicKey;
     private readonly maxOffers;
     private readonly offerFactory;
     private readonly ttl;
@@ -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,11 +11,12 @@ 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;
         this.tags = options.tags;
-        this.ownerUsername = options.ownerUsername;
+        this.ownerPublicKey = options.ownerPublicKey;
         this.webrtcAdapter = options.webrtcAdapter;
         this.maxOffers = options.maxOffers;
         this.offerFactory = options.offerFactory;
@@ -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
      */
@@ -179,7 +195,7 @@ export class OfferPool extends EventEmitter {
         // Create OffererConnection instance
         const connection = new OffererConnection({
             api: this.api,
-            ownerUsername: this.ownerUsername,
+            ownerPublicKey: this.ownerPublicKey,
             offerId,
             pc,
             dc,
@@ -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,8 +266,12 @@ 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);
+                await connection.processAnswer(data.sdp, data.answererPublicKey);
                 // Create replacement offer
                 this.fillOffers();
             }

package/dist/core/peer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Peer - Clean DX wrapper for peer-to-peer connections
  *
- * Provides a simple interface for connecting to a peer by tags/username,
+ * Provides a simple interface for connecting to a peer by tags/publicKey,
  * with automatic reconnection and message buffering.
  */
 import { EventEmitter } from 'eventemitter3';
@@ -37,8 +37,8 @@ export type PeerEventName = keyof PeerEventMap;
 export interface PeerOptions {
     /** Tags to match for peer discovery */
     tags: string[];
-    /** Optional: connect to specific username */
-    username?: string;
+    /** Optional: connect to specific public key */
+    publicKey?: string;
     /** Optional: custom RTC configuration */
     rtcConfig?: RTCConfiguration;
     /** Optional: connection behavior configuration */
@@ -60,12 +60,12 @@ export interface PeerInternalOptions extends PeerOptions {
  * @example
  * ```typescript
  * const peer = await rondevu.peer({
- *   username: 'alice',
+ *   publicKey: 'abc123...',
  *   tags: ['chat']
  * })
  *
  * peer.on('open', () => {
- *   console.log('Connected to', peer.peerUsername)
+ *   console.log('Connected to', peer.peerPublicKey)
  *   peer.send('Hello!')
  * })
  *
@@ -86,14 +86,14 @@ export declare class Peer extends EventEmitter<PeerEventMap> {
     private connection;
     private api;
     private tags;
-    private targetUsername?;
+    private targetPublicKey?;
     private iceServers;
     private iceTransportPolicy?;
     private webrtcAdapter?;
     private connectionConfig?;
     private debugEnabled;
     private _state;
-    private _peerUsername;
+    private _peerPublicKey;
     private _offerId;
     constructor(options: PeerInternalOptions);
     /**
@@ -113,9 +113,9 @@ export declare class Peer extends EventEmitter<PeerEventMap> {
      */
     get state(): PeerState;
     /**
-     * Username of the connected peer
+     * Public key of the connected peer
      */
-    get peerUsername(): string;
+    get peerPublicKey(): string;
     /**
      * The offer ID being used for this connection
      */

package/dist/core/peer.js

@@ -1,7 +1,7 @@
 /**
  * Peer - Clean DX wrapper for peer-to-peer connections
  *
- * Provides a simple interface for connecting to a peer by tags/username,
+ * Provides a simple interface for connecting to a peer by tags/publicKey,
  * with automatic reconnection and message buffering.
  */
 import { EventEmitter } from 'eventemitter3';
@@ -13,12 +13,12 @@ import { ConnectionState } from '../connections/events.js';
  * @example
  * ```typescript
  * const peer = await rondevu.peer({
- *   username: 'alice',
+ *   publicKey: 'abc123...',
  *   tags: ['chat']
  * })
  *
  * peer.on('open', () => {
- *   console.log('Connected to', peer.peerUsername)
+ *   console.log('Connected to', peer.peerPublicKey)
  *   peer.send('Hello!')
  * })
  *
@@ -40,11 +40,11 @@ export class Peer extends EventEmitter {
         super();
         this.connection = null;
         this._state = 'connecting';
-        this._peerUsername = '';
+        this._peerPublicKey = '';
         this._offerId = '';
         this.api = options.api;
         this.tags = options.tags;
-        this.targetUsername = options.username;
+        this.targetPublicKey = options.publicKey;
         this.iceServers = options.iceServers;
         this.iceTransportPolicy = options.iceTransportPolicy;
         this.webrtcAdapter = options.webrtcAdapter;
@@ -56,7 +56,7 @@ export class Peer extends EventEmitter {
      */
     async initialize() {
         this.debug('Initializing peer connection');
-        this.debug(`Tags: ${this.tags.join(', ')}${this.targetUsername ? `, username: ${this.targetUsername}` : ''}`);
+        this.debug(`Tags: ${this.tags.join(', ')}${this.targetPublicKey ? `, publicKey: ${this.targetPublicKey}` : ''}`);
         // Discover offers
         const result = (await this.api.discover({
             tags: this.tags,
@@ -65,23 +65,23 @@ export class Peer extends EventEmitter {
         if (!result.offers || result.offers.length === 0) {
             throw new Error(`No peers found for tags: ${this.tags.join(', ')}`);
         }
-        // Filter by username if specified
+        // Filter by publicKey if specified
         let availableOffers = result.offers;
-        if (this.targetUsername) {
-            availableOffers = result.offers.filter((o) => o.username === this.targetUsername);
+        if (this.targetPublicKey) {
+            availableOffers = result.offers.filter((o) => o.publicKey === this.targetPublicKey);
             if (availableOffers.length === 0) {
-                throw new Error(`No peers found for tags: ${this.tags.join(', ')} from @${this.targetUsername}`);
+                throw new Error(`No peers found for tags: ${this.tags.join(', ')} from ${this.targetPublicKey}`);
             }
         }
         // Pick a random offer
         const offer = availableOffers[Math.floor(Math.random() * availableOffers.length)];
-        this._peerUsername = offer.username;
+        this._peerPublicKey = offer.publicKey;
         this._offerId = offer.offerId;
-        this.debug(`Selected offer ${offer.offerId} from @${offer.username}`);
+        this.debug(`Selected offer ${offer.offerId} from ${offer.publicKey}`);
         // Create the underlying AnswererConnection
         this.connection = new AnswererConnection({
             api: this.api,
-            ownerUsername: offer.username,
+            ownerPublicKey: offer.publicKey,
             tags: offer.tags,
             offerId: offer.offerId,
             offerSdp: offer.sdp,
@@ -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();
@@ -179,10 +180,10 @@ export class Peer extends EventEmitter {
         return this._state;
     }
     /**
-     * Username of the connected peer
+     * Public key of the connected peer
      */
-    get peerUsername() {
-        return this._peerUsername;
+    get peerPublicKey() {
+        return this._peerPublicKey;
     }
     /**
      * The offer ID being used for this connection

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

@@ -11,9 +11,10 @@ import { EventEmitter } from 'eventemitter3';
 import { RondevuAPI, IceCandidate } from '../api/client.js';
 export interface PollAnswerEvent {
     offerId: string;
-    answererId: string;
+    answererPublicKey: string;
     sdp: string;
     answeredAt: number;
+    matchedTags?: string[];
 }
 export interface PollIceEvent {
     offerId: string;

package/dist/core/polling-manager.js

@@ -79,9 +79,10 @@ export class PollingManager extends EventEmitter {
                 this.debug(`Poll: answer for ${answer.offerId}`);
                 this.emit('poll:answer', {
                     offerId: answer.offerId,
-                    answererId: answer.answererId,
+                    answererPublicKey: answer.answererPublicKey,
                     sdp: answer.sdp,
                     answeredAt: answer.answeredAt,
+                    matchedTags: answer.matchedTags,
                 });
                 // Update last poll timestamp
                 if (answer.answeredAt > this.lastPollTimestamp) {

package/dist/core/rondevu-types.d.ts

@@ -3,7 +3,7 @@
  *
  * Contains all public interfaces and types for the Rondevu client.
  */
-import { Credential } from '../api/client.js';
+import { KeyPair } from '../api/client.js';
 import { CryptoAdapter } from '../crypto/adapter.js';
 import { WebRTCAdapter } from '../webrtc/adapter.js';
 import { ConnectionConfig } from '../connections/config.js';
@@ -14,10 +14,8 @@ import { IceServerPreset } from './ice-config.js';
 export interface RondevuOptions {
     /** API URL (defaults to 'https://api.ronde.vu') */
     apiUrl?: string;
-    /** Pre-existing credential (will generate if not provided) */
-    credential?: Credential;
-    /** Claim specific username (4-32 chars, alphanumeric + dashes + periods) */
-    username?: string;
+    /** Pre-existing keypair (will generate if not provided) */
+    keyPair?: KeyPair;
     /** Crypto adapter (defaults to WebCryptoAdapter) */
     cryptoAdapter?: CryptoAdapter;
     /** WebRTC adapter (defaults to BrowserWebRTCAdapter, use NodeWebRTCAdapter for Node.js) */
@@ -81,8 +79,8 @@ export interface ConnectionContext {
     tags: string[];
     /** The offer ID for this connection */
     offerId: string;
-    /** Username of the connected peer */
-    peerUsername: string;
+    /** Public key of the connected peer */
+    peerPublicKey: string;
 }
 /**
  * Options for rondevu.discover() - discovering available offers
@@ -99,8 +97,8 @@ export interface DiscoverOptions {
 export interface DiscoveredOffer {
     /** Unique offer identifier */
     offerId: string;
-    /** Username of the offer publisher */
-    username: string;
+    /** Public key of the offer publisher */
+    publicKey: string;
     /** Tags associated with this offer */
     tags: string[];
     /** The WebRTC offer SDP */

package/dist/core/rondevu.d.ts

@@ -1,4 +1,4 @@
-import { Credential, IceCandidate } from '../api/client.js';
+import { KeyPair, IceCandidate } from '../api/client.js';
 import { WebRTCAdapter } from '../webrtc/adapter.js';
 import { EventEmitter } from 'eventemitter3';
 import { OffererConnection } from '../connections/offerer.js';
@@ -12,6 +12,7 @@ export type { PollAnswerEvent, PollIceEvent } from './polling-manager.js';
  * Rondevu - Complete WebRTC signaling client with durable connections
  *
  * Uses a tags-based discovery system where offers have 1+ tags for matching.
+ * Authentication uses Ed25519 public key cryptography - your public key IS your identity.
  *
  * @example
  * ```typescript
@@ -62,7 +63,7 @@ export declare class Rondevu extends EventEmitter {
     private static readonly POLLING_INTERVAL_MS;
     private api;
     private readonly apiUrl;
-    private credential;
+    private keyPair;
     private cryptoAdapter?;
     private webrtcAdapter;
     private iceServers;
@@ -91,20 +92,20 @@ export declare class Rondevu extends EventEmitter {
      */
     static connect(options?: RondevuOptions): Promise<Rondevu>;
     /**
-     * Get the current credential name
+     * Get the current public key (identity)
      */
-    getName(): string;
+    getPublicKey(): string;
     /**
-     * Get the full credential (name + secret)
-     * Use this to persist credentials for future sessions
+     * Get the full keypair (publicKey + privateKey)
+     * Use this to persist keypair for future sessions
      *
      * ⚠️ SECURITY WARNING:
-     * - The secret grants full access to this identity
-     * - Store credentials securely (encrypted storage, never in logs)
-     * - Never expose credentials in URLs, console output, or error messages
-     * - Treat the secret like a password or API key
+     * - The private key grants full access to this identity
+     * - Store keypair securely (encrypted storage, never in logs)
+     * - Never expose private key in URLs, console output, or error messages
+     * - Treat the private key like a password or API key
      */
-    getCredential(): Credential;
+    getKeyPair(): KeyPair;
     /**
      * Get the WebRTC adapter for creating peer connections
      * Used internally by offer pool and connections
@@ -173,6 +174,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
@@ -191,14 +199,14 @@ export declare class Rondevu extends EventEmitter {
      * // Connect to any peer matching tags
      * const peer = await rondevu.peer({ tags: ['chat'] })
      *
-     * // Connect to specific user
+     * // Connect to specific peer by public key
      * const peer = await rondevu.peer({
-     *   username: 'alice',
+     *   publicKey: 'abc123...',
      *   tags: ['chat']
      * })
      *
      * peer.on('open', () => {
-     *   console.log('Connected to', peer.peerUsername)
+     *   console.log('Connected to', peer.peerPublicKey)
      *   peer.send('Hello!')
      * })
      *
@@ -236,7 +244,7 @@ export declare class Rondevu extends EventEmitter {
      *
      * // Access offers
      * for (const offer of result.offers) {
-     *   console.log(offer.username, offer.tags)
+     *   console.log(offer.publicKey, offer.tags)
      * }
      * ```
      */
@@ -254,7 +262,7 @@ export declare class Rondevu extends EventEmitter {
     getOfferAnswer(offerId: string): Promise<{
         sdp: string;
         offerId: string;
-        answererId: string;
+        answererPublicKey: string;
         answeredAt: number;
     } | null>;
     /**
@@ -264,14 +272,14 @@ export declare class Rondevu extends EventEmitter {
     poll(since?: number): Promise<{
         answers: Array<{
             offerId: string;
-            answererId: string;
+            answererPublicKey: string;
             sdp: string;
             answeredAt: number;
         }>;
         iceCandidates: Record<string, Array<{
             candidate: RTCIceCandidateInit | null;
             role: 'offerer' | 'answerer';
-            peerId: string;
+            peerPublicKey: string;
             createdAt: number;
         }>>;
     }>;