@xtr-dev/rondevu-client 0.13.0 → 0.17.0

package/dist/api.d.ts

@@ -1,30 +1,10 @@
 /**
- * Rondevu API Client - Single class for all API endpoints
+ * Rondevu API Client - RPC interface
  */
-export interface Credentials {
-    peerId: string;
-    secret: string;
-}
-export interface Keypair {
-    publicKey: string;
-    privateKey: string;
-}
-export interface OfferRequest {
-    sdp: string;
-    topics?: string[];
-    ttl?: number;
-    secret?: string;
-}
-export interface Offer {
-    id: string;
-    peerId: string;
-    sdp: string;
-    topics: string[];
-    ttl: number;
-    createdAt: number;
-    expiresAt: number;
-    answererPeerId?: string;
-}
+import { CryptoAdapter, Keypair } from './crypto-adapter.js';
+import { BatcherOptions } from './rpc-batcher.js';
+export type { Keypair } from './crypto-adapter.js';
+export type { BatcherOptions } from './rpc-batcher.js';
 export interface OfferRequest {
     sdp: string;
 }
@@ -50,55 +30,77 @@ export interface Service {
     expiresAt: number;
 }
 export interface IceCandidate {
-    candidate: RTCIceCandidateInit;
+    candidate: RTCIceCandidateInit | null;
     createdAt: number;
 }
 /**
- * RondevuAPI - Complete API client for Rondevu signaling server
+ * RondevuAPI - RPC-based API client for Rondevu signaling server
  */
 export declare class RondevuAPI {
     private baseUrl;
-    private credentials?;
-    constructor(baseUrl: string, credentials?: Credentials | undefined);
+    private username;
+    private keypair;
+    private crypto;
+    private batcher;
+    constructor(baseUrl: string, username: string, keypair: Keypair, cryptoAdapter?: CryptoAdapter, batcherOptions?: BatcherOptions | false);
+    /**
+     * Generate authentication parameters for RPC calls
+     */
+    private generateAuth;
+    /**
+     * Execute RPC call with optional batching
+     */
+    private rpc;
     /**
-     * Set credentials for authentication
+     * Execute single RPC call directly (bypasses batcher)
      */
-    setCredentials(credentials: Credentials): void;
+    private rpcDirect;
     /**
-     * Authentication header
+     * Execute batch RPC calls directly (bypasses batcher)
      */
-    private getAuthHeader;
+    private rpcBatchDirect;
     /**
      * Generate an Ed25519 keypair for username claiming and service publishing
+     * @param cryptoAdapter - Optional crypto adapter (defaults to WebCryptoAdapter)
      */
-    static generateKeypair(): Promise<Keypair>;
+    static generateKeypair(cryptoAdapter?: CryptoAdapter): Promise<Keypair>;
     /**
      * Sign a message with an Ed25519 private key
+     * @param cryptoAdapter - Optional crypto adapter (defaults to WebCryptoAdapter)
      */
-    static signMessage(message: string, privateKeyBase64: string): Promise<string>;
+    static signMessage(message: string, privateKeyBase64: string, cryptoAdapter?: CryptoAdapter): Promise<string>;
     /**
-     * Verify a signature
+     * Verify an Ed25519 signature
+     * @param cryptoAdapter - Optional crypto adapter (defaults to WebCryptoAdapter)
      */
-    static verifySignature(message: string, signatureBase64: string, publicKeyBase64: string): Promise<boolean>;
+    static verifySignature(message: string, signatureBase64: string, publicKeyBase64: string, cryptoAdapter?: CryptoAdapter): Promise<boolean>;
     /**
-     * Register a new peer and get credentials
+     * Check if a username is available
      */
-    register(): Promise<Credentials>;
+    isUsernameAvailable(username: string): Promise<boolean>;
     /**
-     * Create one or more offers
+     * Check if current username is claimed
      */
-    createOffers(offers: OfferRequest[]): Promise<Offer[]>;
+    isUsernameClaimed(): Promise<boolean>;
     /**
-     * Get offer by ID
+     * Publish a service
      */
-    getOffer(offerId: string): Promise<Offer>;
+    publishService(service: ServiceRequest): Promise<Service>;
     /**
-     * Answer a specific offer from a service
+     * Get service by FQN (direct lookup, random, or paginated)
      */
-    postOfferAnswer(serviceFqn: string, offerId: string, sdp: string): Promise<{
-        success: boolean;
-        offerId: string;
-    }>;
+    getService(serviceFqn: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    /**
+     * Delete a service
+     */
+    deleteService(serviceFqn: string): Promise<void>;
+    /**
+     * Answer an offer
+     */
+    answerOffer(serviceFqn: string, offerId: string, sdp: string): Promise<void>;
     /**
      * Get answer for a specific offer (offerer polls this)
      */
@@ -109,9 +111,23 @@ export declare class RondevuAPI {
         answeredAt: number;
     } | null>;
     /**
-     * Search offers by topic
+     * Combined polling for answers and ICE candidates
      */
-    searchOffers(topic: string): Promise<Offer[]>;
+    poll(since?: number): Promise<{
+        answers: Array<{
+            offerId: string;
+            serviceId?: string;
+            answererId: string;
+            sdp: string;
+            answeredAt: number;
+        }>;
+        iceCandidates: Record<string, Array<{
+            candidate: RTCIceCandidateInit | null;
+            role: 'offerer' | 'answerer';
+            peerId: string;
+            createdAt: number;
+        }>>;
+    }>;
     /**
      * Add ICE candidates to a specific offer
      */
@@ -120,75 +136,10 @@ export declare class RondevuAPI {
         offerId: string;
     }>;
     /**
-     * Get ICE candidates for a specific offer (with polling support)
+     * Get ICE candidates for a specific offer
      */
     getOfferIceCandidates(serviceFqn: string, offerId: string, since?: number): Promise<{
         candidates: IceCandidate[];
         offerId: string;
     }>;
-    /**
-     * Publish a service
-     * Service FQN must include username: service:version@username
-     */
-    publishService(service: ServiceRequest): Promise<Service>;
-    /**
-     * Get service by FQN (with username) - Direct lookup
-     * Example: chat:1.0.0@alice
-     */
-    getService(serviceFqn: string): Promise<{
-        serviceId: string;
-        username: string;
-        serviceFqn: string;
-        offerId: string;
-        sdp: string;
-        createdAt: number;
-        expiresAt: number;
-    }>;
-    /**
-     * Discover a random available service without knowing the username
-     * Example: chat:1.0.0 (without @username)
-     */
-    discoverService(serviceVersion: string): Promise<{
-        serviceId: string;
-        username: string;
-        serviceFqn: string;
-        offerId: string;
-        sdp: string;
-        createdAt: number;
-        expiresAt: number;
-    }>;
-    /**
-     * Discover multiple available services with pagination
-     * Example: chat:1.0.0 (without @username)
-     */
-    discoverServices(serviceVersion: string, limit?: number, offset?: number): Promise<{
-        services: Array<{
-            serviceId: string;
-            username: string;
-            serviceFqn: string;
-            offerId: string;
-            sdp: string;
-            createdAt: number;
-            expiresAt: number;
-        }>;
-        count: number;
-        limit: number;
-        offset: number;
-    }>;
-    /**
-     * Check if username is available
-     */
-    checkUsername(username: string): Promise<{
-        available: boolean;
-        publicKey?: string;
-        claimedAt?: number;
-        expiresAt?: number;
-    }>;
-    /**
-     * Claim a username (requires Ed25519 signature)
-     */
-    claimUsername(username: string, publicKey: string, signature: string, message: string): Promise<{
-        success: boolean;
-        username: string;
-    }>;
 }