@xtr-dev/rondevu-client 0.10.2 → 0.11.0

package/README.md

@@ -17,10 +17,12 @@ TypeScript/JavaScript client for Rondevu, providing easy-to-use WebRTC connectio
 
 - **High-Level Wrappers**: ServiceHost and ServiceClient eliminate WebRTC boilerplate
 - **Username-Based Discovery**: Connect to peers by username, not complex offer/answer exchange
+- **Semver-Compatible Matching**: Requesting chat@1.0.0 matches any compatible 1.x.x version
+- **Privacy-First Design**: Services are hidden by default - no enumeration possible
 - **Automatic Reconnection**: Built-in retry logic with exponential backoff
 - **Message Queuing**: Messages sent while disconnected are queued and flushed on reconnect
 - **Cryptographic Username Claiming**: Secure ownership with Ed25519 signatures
-- **Service Publishing**: Package-style naming (chat.app@1.0.0)
+- **Service Publishing**: Package-style naming (chat.app@1.0.0) with multiple simultaneous offers
 - **TypeScript**: Full type safety and autocomplete
 - **Configurable Polling**: Exponential backoff with jitter to reduce server load
 
@@ -373,7 +375,7 @@ await conn.queueMessage('This will be sent when connected', {
 
 ## Migration from v0.9.x
 
-v0.11.0 introduces high-level wrappers and RESTful API changes:
+v0.11.0+ introduces high-level wrappers, RESTful API changes, and semver-compatible discovery:
 
 **API Changes:**
 - Server endpoints restructured (`/usernames/*` → `/users/*`)
@@ -381,6 +383,10 @@ v0.11.0 introduces high-level wrappers and RESTful API changes:
 - Message queue fully implemented
 - Configurable polling with exponential backoff
 - Removed deprecated `cleanup()` methods (use `dispose()`)
+- **v0.11.0+**: Services use `offers` array instead of single `sdp`
+- **v0.11.0+**: Semver-compatible service discovery (chat@1.0.0 matches 1.x.x)
+- **v0.11.0+**: All services are hidden - no listing endpoint
+- **v0.11.0+**: Services support multiple simultaneous offers for connection pooling
 
 **Migration Guide:**
 

package/dist/api.d.ts

@@ -25,20 +25,29 @@ export interface Offer {
     expiresAt: number;
     answererPeerId?: string;
 }
+export interface OfferRequest {
+    sdp: string;
+}
 export interface ServiceRequest {
     username: string;
     serviceFqn: string;
-    sdp: string;
+    offers: OfferRequest[];
     ttl?: number;
     isPublic?: boolean;
     metadata?: Record<string, any>;
     signature: string;
     message: string;
 }
+export interface ServiceOffer {
+    offerId: string;
+    sdp: string;
+    createdAt: number;
+    expiresAt: number;
+}
 export interface Service {
     serviceId: string;
     uuid: string;
-    offerId: string;
+    offers: ServiceOffer[];
     username: string;
     serviceFqn: string;
     isPublic: boolean;

package/dist/rondevu-service.d.ts

@@ -7,7 +7,9 @@ export interface RondevuServiceOptions {
 }
 export interface PublishServiceOptions {
     serviceFqn: string;
-    sdp: string;
+    offers: Array<{
+        sdp: string;
+    }>;
     ttl?: number;
     isPublic?: boolean;
     metadata?: Record<string, any>;
@@ -36,7 +38,7 @@ export interface PublishServiceOptions {
  * // Publish a service
  * const publishedService = await service.publishService({
  *   serviceFqn: 'chat.app@1.0.0',
- *   sdp: offerSdp,
+ *   offers: [{ sdp: offerSdp }],
  *   ttl: 300000,
  *   isPublic: true,
  * })

package/dist/rondevu-service.js

@@ -23,7 +23,7 @@ import { RondevuAPI } from './api.js';
  * // Publish a service
  * const publishedService = await service.publishService({
  *   serviceFqn: 'chat.app@1.0.0',
- *   sdp: offerSdp,
+ *   offers: [{ sdp: offerSdp }],
  *   ttl: 300000,
  *   isPublic: true,
  * })
@@ -86,7 +86,7 @@ export class RondevuService {
         if (!this.usernameClaimed) {
             throw new Error('Username not claimed. Call claimUsername() first or the server will reject the service.');
         }
-        const { serviceFqn, sdp, ttl, isPublic, metadata } = options;
+        const { serviceFqn, offers, ttl, isPublic, metadata } = options;
         // Generate signature for service publication
         const message = `publish:${this.username}:${serviceFqn}:${Date.now()}`;
         const signature = await RondevuAPI.signMessage(message, this.keypair.privateKey);
@@ -94,7 +94,7 @@ export class RondevuService {
         const serviceRequest = {
             username: this.username,
             serviceFqn,
-            sdp,
+            offers,
             signature,
             message,
             ttl,

package/dist/rondevu-signaler.js

@@ -62,11 +62,15 @@ export class RondevuSignaler {
         // Publish service with the offer SDP
         const publishedService = await this.rondevu.publishService({
             serviceFqn: this.service,
-            sdp: offer.sdp,
+            offers: [{ sdp: offer.sdp }],
             ttl: 300000, // 5 minutes
             isPublic: true,
         });
-        this.offerId = publishedService.offerId;
+        // Get the first offer from the published service
+        if (!publishedService.offers || publishedService.offers.length === 0) {
+            throw new Error('No offers returned from service publication');
+        }
+        this.offerId = publishedService.offers[0].offerId;
         this.serviceUuid = publishedService.uuid;
         // Start polling for answer
         this.startAnswerPolling();
@@ -173,12 +177,19 @@ export class RondevuSignaler {
             }
             // Get the first available service (already has full details from searchServices)
             const service = services[0];
-            this.offerId = service.offerId;
+            // Get the first available offer from the service
+            if (!service.offers || service.offers.length === 0) {
+                console.warn(`No offers available for service ${this.host}/${this.service}`);
+                this.isPolling = false;
+                return;
+            }
+            const firstOffer = service.offers[0];
+            this.offerId = firstOffer.offerId;
             this.serviceUuid = service.uuid;
             // Notify offer listeners
             const offer = {
                 type: 'offer',
-                sdp: service.sdp,
+                sdp: firstOffer.sdp,
             };
             this.offerListeners.forEach(listener => {
                 try {

package/package.json

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