@xtr-dev/rondevu-client 0.21.5 → 0.21.8

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/index.d.ts

@@ -20,3 +20,4 @@ export { ICE_SERVER_PRESETS } from './ice-config.js';
 export type { RondevuOptions, OfferOptions, OfferHandle, DiscoverOptions, DiscoverResult, } from './rondevu.js';
 export type { PeerState, PeerOptions } from './peer.js';
 export type { IceServerPreset } from './ice-config.js';
+export type { KeyPair, CryptoAdapter } from '../crypto/adapter.js';

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;
@@ -20,6 +20,12 @@ export interface OfferPoolOptions {
     webrtcAdapter: WebRTCAdapter;
     connectionConfig?: Partial<ConnectionConfig>;
     debugEnabled?: boolean;
+    /**
+     * Delay in milliseconds between creating each offer during pool filling.
+     * Helps avoid rate limiting when creating multiple offers.
+     * Default: 100ms
+     */
+    offerCreationThrottleMs?: number;
 }
 interface OfferPoolEvents {
     'connection:opened': (offerId: string, connection: OffererConnection, matchedTags?: string[]) => void;
@@ -35,7 +41,7 @@ interface OfferPoolEvents {
 export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
     private readonly api;
     private tags;
-    private readonly ownerUsername;
+    private readonly ownerPublicKey;
     private readonly maxOffers;
     private readonly offerFactory;
     private readonly ttl;
@@ -44,6 +50,7 @@ export declare class OfferPool extends EventEmitter<OfferPoolEvents> {
     private readonly webrtcAdapter;
     private readonly connectionConfig?;
     private readonly debugEnabled;
+    private readonly offerCreationThrottleMs;
     private readonly activeConnections;
     private readonly matchedTagsByOffer;
     private readonly fillLock;

package/dist/core/offer-pool.js

@@ -16,7 +16,7 @@ export class OfferPool extends EventEmitter {
         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;
@@ -25,6 +25,7 @@ export class OfferPool extends EventEmitter {
         this.iceTransportPolicy = options.iceTransportPolicy;
         this.connectionConfig = options.connectionConfig;
         this.debugEnabled = options.debugEnabled || false;
+        this.offerCreationThrottleMs = options.offerCreationThrottleMs ?? 100;
     }
     /**
      * Start filling offers
@@ -116,6 +117,10 @@ export class OfferPool extends EventEmitter {
             for (let i = 0; i < needed; i++) {
                 try {
                     await this.createOffer();
+                    // Throttle between offer creations to avoid rate limiting
+                    if (i < needed - 1 && this.offerCreationThrottleMs > 0) {
+                        await new Promise(resolve => setTimeout(resolve, this.offerCreationThrottleMs));
+                    }
                 }
                 catch (err) {
                     console.error('[OfferPool] Failed to create offer:', err);
@@ -195,7 +200,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,
@@ -271,7 +276,7 @@ export class OfferPool extends EventEmitter {
                 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,
@@ -180,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,7 +11,7 @@ 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[];

package/dist/core/polling-manager.js

@@ -79,7 +79,7 @@ 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,

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) */
@@ -61,6 +59,8 @@ export interface OfferOptions {
     connectionConfig?: Partial<ConnectionConfig>;
     /** Auto-start filling offers (default: true). Set to false to manually call startFilling() */
     autoStart?: boolean;
+    /** Delay in ms between creating each offer during pool filling (default: 100). Helps avoid rate limiting. */
+    offerCreationThrottleMs?: number;
 }
 /**
  * Handle returned by rondevu.offer() for controlling the offer lifecycle
@@ -81,8 +81,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 +99,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,5 @@
-import { Credential, IceCandidate } from '../api/client.js';
+import { KeyPair, IceCandidate } from '../api/client.js';
+import { CryptoAdapter } from '../crypto/adapter.js';
 import { WebRTCAdapter } from '../webrtc/adapter.js';
 import { EventEmitter } from 'eventemitter3';
 import { OffererConnection } from '../connections/offerer.js';
@@ -12,6 +13,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 +64,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,25 +93,30 @@ 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
      */
     getWebRTCAdapter(): WebRTCAdapter;
+    /**
+     * Get the crypto adapter for signing/verification operations
+     * Used for meta.json signing and other crypto operations
+     */
+    getCryptoAdapter(): CryptoAdapter;
     /**
      * Default offer factory - creates a simple data channel connection
      * The RTCPeerConnection is created by Rondevu and passed in
@@ -198,14 +205,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!')
      * })
      *
@@ -243,7 +250,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)
      * }
      * ```
      */
@@ -261,7 +268,7 @@ export declare class Rondevu extends EventEmitter {
     getOfferAnswer(offerId: string): Promise<{
         sdp: string;
         offerId: string;
-        answererId: string;
+        answererPublicKey: string;
         answeredAt: number;
     } | null>;
     /**
@@ -271,14 +278,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;
         }>>;
     }>;