@rookdaemon/agora 0.1.2 → 0.1.5

package/dist/peer/manager.js

@@ -0,0 +1,153 @@
+import { EventEmitter } from 'node:events';
+import { PeerServer } from './server.js';
+import { PeerClient } from './client.js';
+/**
+ * Manages both server (incoming connections) and client (outbound connections)
+ */
+export class PeerManager extends EventEmitter {
+    server = null;
+    clients = new Map();
+    identity;
+    announcePayload;
+    constructor(identity, announcePayload) {
+        super();
+        this.identity = identity;
+        this.announcePayload = announcePayload;
+    }
+    /**
+     * Start listening for incoming peer connections
+     * @param port - Port to listen on
+     */
+    async start(port) {
+        if (this.server) {
+            throw new Error('Server already started');
+        }
+        this.server = new PeerServer(this.identity, this.announcePayload);
+        // Forward server events
+        this.server.on('peer-connected', (publicKey, _peer) => {
+            this.emit('peer-connected', publicKey);
+        });
+        this.server.on('peer-disconnected', (publicKey) => {
+            this.emit('peer-disconnected', publicKey);
+        });
+        this.server.on('message-received', (envelope, fromPublicKey) => {
+            this.emit('message-received', envelope, fromPublicKey);
+        });
+        this.server.on('error', (error) => {
+            this.emit('error', error);
+        });
+        await this.server.start(port);
+    }
+    /**
+     * Stop the server and disconnect all clients
+     */
+    async stop() {
+        // Disconnect all clients
+        for (const client of this.clients.values()) {
+            client.disconnect();
+        }
+        this.clients.clear();
+        // Stop server
+        if (this.server) {
+            await this.server.stop();
+            this.server = null;
+        }
+    }
+    /**
+     * Connect to a peer at the given URL
+     * @param url - WebSocket URL of the peer (e.g., ws://localhost:8080)
+     */
+    connect(url) {
+        // Check if already connected to this URL
+        if (this.clients.has(url)) {
+            return;
+        }
+        const client = new PeerClient(url, this.identity, this.announcePayload);
+        // Forward client events
+        client.on('connected', (publicKey) => {
+            this.emit('peer-connected', publicKey);
+        });
+        client.on('disconnected', () => {
+            const publicKey = client.getPeerPublicKey();
+            if (publicKey) {
+                this.emit('peer-disconnected', publicKey);
+            }
+        });
+        client.on('message-received', (envelope) => {
+            const publicKey = client.getPeerPublicKey();
+            if (publicKey) {
+                this.emit('message-received', envelope, publicKey);
+            }
+        });
+        client.on('error', (error) => {
+            this.emit('error', error);
+        });
+        this.clients.set(url, client);
+        client.connect();
+    }
+    /**
+     * Broadcast a message to all connected peers (both incoming and outgoing)
+     * @param envelope - The envelope to broadcast
+     */
+    broadcast(envelope) {
+        // Broadcast to server peers
+        if (this.server) {
+            this.server.broadcast(envelope);
+        }
+        // Broadcast to client peers
+        for (const client of this.clients.values()) {
+            if (client.isConnected()) {
+                client.send(envelope);
+            }
+        }
+    }
+    /**
+     * Get list of all connected peers with their public keys
+     * @returns Array of peer information
+     */
+    getPeers() {
+        const peers = [];
+        // Get server peers
+        if (this.server) {
+            for (const [publicKey, peer] of this.server.getPeers()) {
+                peers.push({
+                    publicKey,
+                    metadata: peer.metadata,
+                });
+            }
+        }
+        // Get client peers
+        for (const client of this.clients.values()) {
+            if (client.isConnected()) {
+                const publicKey = client.getPeerPublicKey();
+                if (publicKey) {
+                    // Avoid duplicates (same peer might be connected via both server and client)
+                    if (!peers.find(p => p.publicKey === publicKey)) {
+                        peers.push({ publicKey });
+                    }
+                }
+            }
+        }
+        return peers;
+    }
+    /**
+     * Send a message to a specific peer by public key
+     * @param publicKey - The peer's public key
+     * @param envelope - The envelope to send
+     * @returns true if sent successfully, false otherwise
+     */
+    send(publicKey, envelope) {
+        // Try to send via server
+        if (this.server && this.server.send(publicKey, envelope)) {
+            return true;
+        }
+        // Try to send via clients
+        for (const client of this.clients.values()) {
+            if (client.getPeerPublicKey() === publicKey && client.isConnected()) {
+                return client.send(envelope);
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/peer/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/peer/manager.ts"],"names":[],"mappings":"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"}

package/dist/peer/server.d.ts

@@ -0,0 +1,65 @@
+import { EventEmitter } from 'node:events';
+import { WebSocket } from 'ws';
+import type { KeyPair } from '../identity/keypair.js';
+import type { Envelope } from '../message/envelope.js';
+import type { AnnouncePayload } from '../registry/messages.js';
+/**
+ * Represents a connected peer
+ */
+export interface ConnectedPeer {
+    /** Peer's public key */
+    publicKey: string;
+    /** WebSocket connection */
+    socket: WebSocket;
+    /** Whether the peer has been announced */
+    announced: boolean;
+    /** Peer metadata from announce message */
+    metadata?: {
+        name?: string;
+        version?: string;
+    };
+}
+/**
+ * Events emitted by PeerServer
+ */
+export interface PeerServerEvents {
+    'peer-connected': (publicKey: string, peer: ConnectedPeer) => void;
+    'peer-disconnected': (publicKey: string) => void;
+    'message-received': (envelope: Envelope, fromPublicKey: string) => void;
+    'error': (error: Error) => void;
+}
+/**
+ * WebSocket server for accepting peer connections
+ */
+export declare class PeerServer extends EventEmitter {
+    private wss;
+    private peers;
+    private identity;
+    private announcePayload;
+    constructor(identity: KeyPair, announcePayload: AnnouncePayload);
+    /**
+     * Start the WebSocket server
+     */
+    start(port: number): Promise<void>;
+    /**
+     * Stop the WebSocket server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get all connected peers
+     */
+    getPeers(): Map<string, ConnectedPeer>;
+    /**
+     * Send a message to a specific peer
+     */
+    send(publicKey: string, envelope: Envelope): boolean;
+    /**
+     * Broadcast a message to all connected peers
+     */
+    broadcast(envelope: Envelope): void;
+    /**
+     * Handle incoming connection
+     */
+    private handleConnection;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/peer/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/peer/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACnE,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAkB;gBAE7B,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe;IAM/D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;OAEG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAItC;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAepD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkEzB"}

package/dist/peer/server.js

@@ -0,0 +1,154 @@
+import { EventEmitter } from 'node:events';
+import { WebSocketServer, WebSocket } from 'ws';
+import { createEnvelope, verifyEnvelope } from '../message/envelope.js';
+/**
+ * WebSocket server for accepting peer connections
+ */
+export class PeerServer extends EventEmitter {
+    wss = null;
+    peers = new Map();
+    identity;
+    announcePayload;
+    constructor(identity, announcePayload) {
+        super();
+        this.identity = identity;
+        this.announcePayload = announcePayload;
+    }
+    /**
+     * Start the WebSocket server
+     */
+    start(port) {
+        return new Promise((resolve, reject) => {
+            try {
+                this.wss = new WebSocketServer({ port });
+                this.wss.on('error', (error) => {
+                    this.emit('error', error);
+                    reject(error);
+                });
+                this.wss.on('listening', () => {
+                    resolve();
+                });
+                this.wss.on('connection', (socket) => {
+                    this.handleConnection(socket);
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Stop the WebSocket server
+     */
+    async stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.wss) {
+                resolve();
+                return;
+            }
+            // Close all peer connections
+            for (const peer of this.peers.values()) {
+                peer.socket.close();
+            }
+            this.peers.clear();
+            this.wss.close((err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.wss = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Get all connected peers
+     */
+    getPeers() {
+        return new Map(this.peers);
+    }
+    /**
+     * Send a message to a specific peer
+     */
+    send(publicKey, envelope) {
+        const peer = this.peers.get(publicKey);
+        if (!peer || peer.socket.readyState !== WebSocket.OPEN) {
+            return false;
+        }
+        try {
+            peer.socket.send(JSON.stringify(envelope));
+            return true;
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+    }
+    /**
+     * Broadcast a message to all connected peers
+     */
+    broadcast(envelope) {
+        for (const [publicKey, peer] of this.peers) {
+            if (peer.socket.readyState === WebSocket.OPEN) {
+                this.send(publicKey, envelope);
+            }
+        }
+    }
+    /**
+     * Handle incoming connection
+     */
+    handleConnection(socket) {
+        let peerPublicKey = null;
+        // Send announce message immediately
+        const announceEnvelope = createEnvelope('announce', this.identity.publicKey, this.identity.privateKey, this.announcePayload);
+        socket.send(JSON.stringify(announceEnvelope));
+        socket.on('message', (data) => {
+            try {
+                const envelope = JSON.parse(data.toString());
+                // Verify envelope signature
+                const verification = verifyEnvelope(envelope);
+                if (!verification.valid) {
+                    // Drop invalid messages
+                    return;
+                }
+                // First message should be an announce
+                if (!peerPublicKey) {
+                    if (envelope.type === 'announce') {
+                        peerPublicKey = envelope.sender;
+                        const payload = envelope.payload;
+                        const peer = {
+                            publicKey: peerPublicKey,
+                            socket,
+                            announced: true,
+                            metadata: payload.metadata,
+                        };
+                        this.peers.set(peerPublicKey, peer);
+                        this.emit('peer-connected', peerPublicKey, peer);
+                    }
+                    return;
+                }
+                // Verify the message is from the announced peer
+                if (envelope.sender !== peerPublicKey) {
+                    // Drop messages from wrong sender
+                    return;
+                }
+                // Emit message-received event
+                this.emit('message-received', envelope, peerPublicKey);
+            }
+            catch {
+                // Invalid JSON or other parsing errors - drop the message
+            }
+        });
+        socket.on('close', () => {
+            if (peerPublicKey) {
+                this.peers.delete(peerPublicKey);
+                this.emit('peer-disconnected', peerPublicKey);
+            }
+        });
+        socket.on('error', (error) => {
+            this.emit('error', error);
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/peer/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/peer/server.ts"],"names":[],"mappings":"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"}

package/dist/relay/client.d.ts

@@ -0,0 +1,112 @@
+import { EventEmitter } from 'node:events';
+import { type Envelope } from '../message/envelope.js';
+import type { RelayPeer } from './types.js';
+/**
+ * Configuration for RelayClient
+ */
+export interface RelayClientConfig {
+    /** WebSocket URL of the relay server */
+    relayUrl: string;
+    /** Agent's public key */
+    publicKey: string;
+    /** Agent's private key (for signing) */
+    privateKey: string;
+    /** Optional name for this agent */
+    name?: string;
+    /** Keepalive ping interval in milliseconds (default: 30000) */
+    pingInterval?: number;
+    /** Maximum reconnection delay in milliseconds (default: 60000) */
+    maxReconnectDelay?: number;
+}
+/**
+ * Events emitted by RelayClient
+ */
+export interface RelayClientEvents {
+    /** Emitted when successfully connected and registered */
+    'connected': () => void;
+    /** Emitted when disconnected from relay */
+    'disconnected': () => void;
+    /** Emitted when a verified message is received */
+    'message': (envelope: Envelope, from: string, fromName?: string) => void;
+    /** Emitted when a peer comes online */
+    'peer_online': (peer: RelayPeer) => void;
+    /** Emitted when a peer goes offline */
+    'peer_offline': (peer: RelayPeer) => void;
+    /** Emitted on errors */
+    'error': (error: Error) => void;
+}
+/**
+ * Persistent WebSocket client for the Agora relay server.
+ * Maintains a long-lived connection, handles reconnection, and routes messages.
+ */
+export declare class RelayClient extends EventEmitter {
+    private ws;
+    private config;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private pingInterval;
+    private isConnected;
+    private isRegistered;
+    private shouldReconnect;
+    private onlinePeers;
+    constructor(config: RelayClientConfig);
+    /**
+     * Connect to the relay server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the relay server
+     */
+    disconnect(): void;
+    /**
+     * Check if currently connected and registered
+     */
+    connected(): boolean;
+    /**
+     * Send a message to a specific peer
+     */
+    send(to: string, envelope: Envelope): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Broadcast a message to all connected peers
+     */
+    broadcast(envelope: Envelope): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get list of currently online peers
+     */
+    getOnlinePeers(): RelayPeer[];
+    /**
+     * Check if a specific peer is online
+     */
+    isPeerOnline(publicKey: string): boolean;
+    /**
+     * Internal: Perform connection
+     */
+    private doConnect;
+    /**
+     * Handle incoming message from relay
+     */
+    private handleMessage;
+    /**
+     * Schedule reconnection with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Start periodic ping messages
+     */
+    private startPingInterval;
+    /**
+     * Stop ping interval
+     */
+    private stopPingInterval;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/relay/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAA0C,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,kDAAkD;IAClD,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,uCAAuC;IACvC,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,uCAAuC;IACvC,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,wBAAwB;IACxB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,WAAW,CAAgC;gBAEvC,MAAM,EAAE,iBAAiB;IASrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,UAAU,IAAI,IAAI;IASlB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBpF;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkB7E;;OAEG;IACH,cAAc,IAAI,SAAS,EAAE;IAI7B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;YACW,SAAS;IAoEvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoErB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,OAAO;CAQhB"}