agentic-qe 2.7.4 → 2.8.0

package/dist/edge/p2p/webrtc/PeerConnectionManager.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Peer Connection Manager for WebRTC
+ *
+ * Manages multiple WebRTC peer connections with automatic reconnection,
+ * data channel management, and connection state tracking.
+ *
+ * @module edge/p2p/webrtc/PeerConnectionManager
+ * @version 1.0.0
+ */
+import { PeerId, PeerConnection, ConnectionState, ConnectionQuality, DataChannelConfig, DataChannelMessage, DataChannelState, PeerConnectionManagerConfig, ConnectOptions, DisconnectOptions, WebRTCEventType, WebRTCEventHandler } from './types';
+import { SignalingClient } from './SignalingClient';
+/**
+ * Peer Connection Manager - Manages WebRTC peer connections
+ *
+ * @example
+ * ```typescript
+ * const signaling = new SignalingClient({ serverUrl: 'wss://signal.example.com', peerId: 'local' });
+ * const manager = new PeerConnectionManager({
+ *   localPeerId: 'local',
+ *   autoReconnect: true,
+ * });
+ *
+ * // Set up signaling integration
+ * manager.setSignaling(signaling);
+ *
+ * // Connect to a peer
+ * const connection = await manager.connect('remote-peer');
+ *
+ * // Send message
+ * manager.send('remote-peer', 'reliable', { type: 'hello', data: 'world' });
+ *
+ * // Listen for messages
+ * manager.on(WebRTCEventType.DATA_CHANNEL_MESSAGE, (event) => {
+ *   console.log('Message from', event.peerId, ':', event.data);
+ * });
+ * ```
+ */
+export declare class PeerConnectionManager {
+    private readonly config;
+    private readonly peers;
+    private readonly eventHandlers;
+    private signaling;
+    private isDestroyed;
+    /**
+     * Create a new PeerConnectionManager instance
+     *
+     * @param config - Manager configuration
+     */
+    constructor(config: PeerConnectionManagerConfig);
+    /**
+     * Set the signaling client for connection establishment
+     *
+     * @param signaling - SignalingClient instance
+     */
+    setSignaling(signaling: SignalingClient): void;
+    /**
+     * Get local peer ID
+     */
+    getLocalPeerId(): PeerId;
+    /**
+     * Connect to a remote peer
+     *
+     * @param peerId - Remote peer identifier
+     * @param options - Connection options
+     * @returns Promise resolving to the peer connection
+     */
+    connect(peerId: PeerId, options?: ConnectOptions): Promise<PeerConnection>;
+    /**
+     * Disconnect from a peer
+     *
+     * @param peerId - Peer to disconnect from
+     * @param options - Disconnect options
+     */
+    disconnect(peerId: PeerId, options?: DisconnectOptions): Promise<void>;
+    /**
+     * Send data to a peer through a data channel
+     *
+     * @param peerId - Target peer ID
+     * @param channel - Data channel label
+     * @param message - Message to send
+     */
+    send<T = unknown>(peerId: PeerId, channel: string, message: DataChannelMessage<T>): void;
+    /**
+     * Send raw data to a peer
+     *
+     * @param peerId - Target peer ID
+     * @param channel - Data channel label
+     * @param data - Raw data (string, ArrayBuffer, etc.)
+     */
+    sendRaw(peerId: PeerId, channel: string, data: string | ArrayBuffer | Blob): void;
+    /**
+     * Get connection state for a peer
+     *
+     * @param peerId - Peer ID
+     * @returns Connection state or null if not found
+     */
+    getConnectionState(peerId: PeerId): ConnectionState | null;
+    /**
+     * Get peer connection object
+     *
+     * @param peerId - Peer ID
+     * @returns Peer connection or undefined if not found
+     */
+    getPeerConnection(peerId: PeerId): PeerConnection | undefined;
+    /**
+     * Get all connected peer IDs
+     */
+    getConnectedPeers(): PeerId[];
+    /**
+     * Get data channel state
+     *
+     * @param peerId - Peer ID
+     * @param label - Channel label
+     * @returns Data channel state or undefined
+     */
+    getDataChannelState(peerId: PeerId, label: string): DataChannelState | undefined;
+    /**
+     * Get connection quality for a peer
+     *
+     * @param peerId - Peer ID
+     * @returns Connection quality or undefined
+     */
+    getConnectionQuality(peerId: PeerId): Promise<ConnectionQuality | undefined>;
+    /**
+     * Register event handler
+     *
+     * @param event - Event type
+     * @param handler - Handler function
+     * @returns Unsubscribe function
+     */
+    on<T = unknown>(event: WebRTCEventType, handler: WebRTCEventHandler<T>): () => void;
+    /**
+     * Create additional data channel on existing connection
+     *
+     * @param peerId - Peer ID
+     * @param config - Data channel configuration
+     */
+    createDataChannel(peerId: PeerId, config: DataChannelConfig): void;
+    /**
+     * Destroy the manager and close all connections
+     */
+    destroy(): Promise<void>;
+    private setupPeerConnectionHandlers;
+    private setupDataChannel;
+    private getChannelState;
+    private initiateConnection;
+    private handleRemoteOffer;
+    private handleRemoteAnswer;
+    private handleRemoteIceCandidate;
+    private handlePeerLeft;
+    private handleRenegotiationRequest;
+    private sendIceCandidate;
+    private scheduleReconnect;
+    private calculateReconnectDelay;
+    private mapConnectionState;
+    private emitEvent;
+}
+export default PeerConnectionManager;
+//# sourceMappingURL=PeerConnectionManager.d.ts.map

package/dist/edge/p2p/webrtc/PeerConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerConnectionManager.d.ts","sourceRoot":"","sources":["../../../../src/edge/p2p/webrtc/PeerConnectionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,MAAM,EACN,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAE3B,cAAc,EACd,iBAAiB,EACjB,eAAe,EAEf,kBAAkB,EAOnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAqCpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4D;IAC1F,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,WAAW,CAAkB;IAErC;;;;OAIG;gBACS,MAAM,EAAE,2BAA2B;IAU/C;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IA4BrD;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;;;OAMG;IACU,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAkF3F;;;;;OAKG;IACU,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CvF;;;;;;OAMG;IACI,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAyB/F;;;;;;OAMG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI;IAmBxF;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAKjE;;;;;OAKG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpE;;OAEG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAUpC;;;;;;OAMG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAmBvF;;;;;OAKG;IACU,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IASzF;;;;;;OAMG;IACI,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAY1F;;;;;OAKG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAuBzE;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrC,OAAO,CAAC,2BAA2B;IAgDnC,OAAO,CAAC,gBAAgB;IAgExB,OAAO,CAAC,eAAe;YAYT,kBAAkB;YA2BlB,iBAAiB;YA8CjB,kBAAkB;YAyBlB,wBAAwB;IAoBtC,OAAO,CAAC,cAAc;YAcR,0BAA0B;IAkBxC,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,SAAS;CAiBlB;AAED,eAAe,qBAAqB,CAAC"}