@principal-ai/control-tower-core 0.1.25 → 0.2.0

package/dist/adapters/mock/MockTransportAdapter.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MockTransportAdapter = void 0;
 class MockTransportAdapter {
     constructor(options) {
-        this.state = 'disconnected';
+        this.state = "disconnected";
         this.messageHandlers = new Set();
         this.errorHandlers = new Set();
         this.closeHandlers = new Set();
@@ -18,39 +18,39 @@ class MockTransportAdapter {
     async connect(url, _options) {
         this.connectionAttempts++;
         if (this.shouldFailConnection) {
-            this.state = 'disconnected';
-            const error = new Error('Mock connection failed');
-            this.errorHandlers.forEach(handler => handler(error));
+            this.state = "disconnected";
+            const error = new Error("Mock connection failed");
+            this.errorHandlers.forEach((handler) => handler(error));
             throw error;
         }
-        this.state = 'connecting';
+        this.state = "connecting";
         this.connectedUrl = url;
         // Simulate connection delay
         if (this.simulateLatency > 0) {
-            await new Promise(resolve => setTimeout(resolve, this.simulateLatency));
+            await new Promise((resolve) => setTimeout(resolve, this.simulateLatency));
         }
-        this.state = 'connected';
+        this.state = "connected";
     }
     async disconnect() {
-        if (this.state === 'disconnected')
+        if (this.state === "disconnected")
             return;
-        this.state = 'disconnecting';
+        this.state = "disconnecting";
         // Simulate disconnect delay
         if (this.simulateLatency > 0) {
-            await new Promise(resolve => setTimeout(resolve, this.simulateLatency / 2));
+            await new Promise((resolve) => setTimeout(resolve, this.simulateLatency / 2));
         }
-        this.state = 'disconnected';
+        this.state = "disconnected";
         this.connectedUrl = null;
-        this.closeHandlers.forEach(handler => handler(1000, 'Normal closure'));
+        this.closeHandlers.forEach((handler) => handler(1000, "Normal closure"));
         this.messageQueue = [];
     }
     async send(message) {
-        if (this.state !== 'connected') {
-            throw new Error('Not connected');
+        if (this.state !== "connected") {
+            throw new Error("Not connected");
         }
         // Simulate send latency
         if (this.simulateLatency > 0) {
-            await new Promise(resolve => setTimeout(resolve, this.simulateLatency));
+            await new Promise((resolve) => setTimeout(resolve, this.simulateLatency));
         }
         this.messageQueue.push(message);
     }
@@ -67,21 +67,21 @@ class MockTransportAdapter {
         return this.state;
     }
     isConnected() {
-        return this.state === 'connected';
+        return this.state === "connected";
     }
     // Test helper methods
     simulateMessage(message, bypassConnectionCheck = false) {
-        if (!bypassConnectionCheck && this.state !== 'connected') {
-            throw new Error('Cannot simulate message when not connected');
+        if (!bypassConnectionCheck && this.state !== "connected") {
+            throw new Error("Cannot simulate message when not connected");
         }
-        this.messageHandlers.forEach(handler => handler(message));
+        this.messageHandlers.forEach((handler) => handler(message));
     }
     simulateError(error) {
-        this.errorHandlers.forEach(handler => handler(error));
+        this.errorHandlers.forEach((handler) => handler(error));
     }
     simulateClose(code, reason) {
-        this.state = 'disconnected';
-        this.closeHandlers.forEach(handler => handler(code, reason));
+        this.state = "disconnected";
+        this.closeHandlers.forEach((handler) => handler(code, reason));
     }
     getMessageQueue() {
         return [...this.messageQueue];
@@ -105,19 +105,19 @@ class MockTransportAdapter {
      */
     async simulateConnection(clientId, options = {}) {
         // Set transport to connected state if not already
-        if (this.state !== 'connected') {
-            this.state = 'connected';
+        if (this.state !== "connected") {
+            this.state = "connected";
         }
         const message = {
             id: `conn-${clientId}`,
-            type: 'connection',
+            type: "connection",
             payload: {
                 clientId,
                 authenticated: options.authenticated ?? false,
                 userId: options.userId,
-                metadata: options.metadata
+                metadata: options.metadata,
             },
-            timestamp: Date.now()
+            timestamp: Date.now(),
         };
         // Use simulateMessage with bypass flag
         this.simulateMessage(message, true);
@@ -125,16 +125,16 @@ class MockTransportAdapter {
     /**
      * Simulate a client disconnection
      */
-    async simulateDisconnect(clientId, reason = 'Normal closure') {
+    async simulateDisconnect(clientId, reason = "Normal closure") {
         // Send a disconnect message to the server for this specific client
         const message = {
             id: `disconnect-${clientId}`,
-            type: 'disconnect',
+            type: "disconnect",
             payload: {
                 clientId,
-                reason
+                reason,
             },
-            timestamp: Date.now()
+            timestamp: Date.now(),
         };
         this.simulateMessage(message, true);
     }
@@ -149,13 +149,13 @@ class MockTransportAdapter {
     async simulateClientMessage(clientId, messageType, messagePayload = {}) {
         const message = {
             id: `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-            type: 'server_message',
+            type: "server_message",
             payload: {
                 clientId,
                 type: messageType,
-                ...messagePayload
+                ...messagePayload,
             },
-            timestamp: Date.now()
+            timestamp: Date.now(),
         };
         this.simulateMessage(message, true);
     }
@@ -165,11 +165,11 @@ class MockTransportAdapter {
      */
     getSentMessages(clientId) {
         return this.messageQueue
-            .filter(msg => {
+            .filter((msg) => {
             const payload = msg.payload;
             return payload?.clientId === clientId;
         })
-            .map(msg => {
+            .map((msg) => {
             const { clientId: _, ...rest } = msg.payload;
             return rest;
         });
@@ -185,9 +185,9 @@ class MockTransportAdapter {
             id: message.id || `msg-${Date.now()}`,
             type: message.type,
             payload: message.payload || {},
-            timestamp: message.timestamp || Date.now()
+            timestamp: message.timestamp || Date.now(),
         };
-        this.messageHandlers.forEach(handler => handler(fullMessage));
+        this.messageHandlers.forEach((handler) => handler(fullMessage));
     }
 }
 exports.MockTransportAdapter = MockTransportAdapter;

package/dist/adapters/mock/index.d.ts

@@ -1,4 +1,6 @@
-export { MockTransportAdapter } from './MockTransportAdapter.js';
-export { MockStorageAdapter } from './MockStorageAdapter.js';
-export { MockAuthAdapter } from './MockAuthAdapter.js';
+export { MockAuthAdapter } from "./MockAuthAdapter.js";
+export { MockRTCDataChannel, type MockRTCDataChannelConfig, type RTCDataChannelState, } from "./MockRTCDataChannel.js";
+export { type MockICECandidate, MockRTCPeerConnection, type MockRTCPeerConnectionConfig, type MockSessionDescription, type RTCIceConnectionState, type RTCIceGatheringState, type RTCPeerConnectionState, type RTCSignalingState, } from "./MockRTCPeerConnection.js";
+export { MockStorageAdapter } from "./MockStorageAdapter.js";
+export { MockTransportAdapter } from "./MockTransportAdapter.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/mock/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EACN,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/adapters/mock/index.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockAuthAdapter = exports.MockStorageAdapter = exports.MockTransportAdapter = void 0;
-var MockTransportAdapter_js_1 = require("./MockTransportAdapter.js");
-Object.defineProperty(exports, "MockTransportAdapter", { enumerable: true, get: function () { return MockTransportAdapter_js_1.MockTransportAdapter; } });
-var MockStorageAdapter_js_1 = require("./MockStorageAdapter.js");
-Object.defineProperty(exports, "MockStorageAdapter", { enumerable: true, get: function () { return MockStorageAdapter_js_1.MockStorageAdapter; } });
+exports.MockTransportAdapter = exports.MockStorageAdapter = exports.MockRTCPeerConnection = exports.MockRTCDataChannel = exports.MockAuthAdapter = void 0;
 var MockAuthAdapter_js_1 = require("./MockAuthAdapter.js");
 Object.defineProperty(exports, "MockAuthAdapter", { enumerable: true, get: function () { return MockAuthAdapter_js_1.MockAuthAdapter; } });
+// WebRTC mocks for simulation testing
+var MockRTCDataChannel_js_1 = require("./MockRTCDataChannel.js");
+Object.defineProperty(exports, "MockRTCDataChannel", { enumerable: true, get: function () { return MockRTCDataChannel_js_1.MockRTCDataChannel; } });
+var MockRTCPeerConnection_js_1 = require("./MockRTCPeerConnection.js");
+Object.defineProperty(exports, "MockRTCPeerConnection", { enumerable: true, get: function () { return MockRTCPeerConnection_js_1.MockRTCPeerConnection; } });
+var MockStorageAdapter_js_1 = require("./MockStorageAdapter.js");
+Object.defineProperty(exports, "MockStorageAdapter", { enumerable: true, get: function () { return MockStorageAdapter_js_1.MockStorageAdapter; } });
+var MockTransportAdapter_js_1 = require("./MockTransportAdapter.js");
+Object.defineProperty(exports, "MockTransportAdapter", { enumerable: true, get: function () { return MockTransportAdapter_js_1.MockTransportAdapter; } });

package/dist/adapters/webrtc/WebRTCSignalingAdapter.d.ts

@@ -0,0 +1,135 @@
+/**
+ * WebRTC Signaling Adapter
+ *
+ * Manages WebRTC peer connections using Control Tower for signaling.
+ * Supports both mock connections (for testing) and real WebRTC.
+ */
+import type { BaseClient } from "../../client/BaseClient.js";
+import type { MockRTCDataChannel } from "../mock/MockRTCDataChannel.js";
+import { MockRTCPeerConnection, type MockRTCPeerConnectionConfig } from "../mock/MockRTCPeerConnection.js";
+export interface WebRTCSignalingConfig {
+    /**
+     * Use mock WebRTC (for testing) or real WebRTC (for production)
+     * @default true
+     */
+    useMock?: boolean;
+    /**
+     * ICE servers configuration (for real WebRTC)
+     */
+    iceServers?: Array<{
+        urls: string | string[];
+    }>;
+    /**
+     * Mock configuration (for testing)
+     */
+    mockConfig?: MockRTCPeerConnectionConfig;
+    /**
+     * Data channel label for peer connections
+     * @default 'data'
+     */
+    dataChannelLabel?: string;
+    /**
+     * Enable ordered delivery for data channels
+     * @default true
+     */
+    orderedDelivery?: boolean;
+}
+export type PeerConnectionState = "new" | "connecting" | "connected" | "disconnected" | "failed";
+export interface PeerConnection {
+    peerId: string;
+    connection: MockRTCPeerConnection;
+    dataChannel: MockRTCDataChannel | null;
+    state: PeerConnectionState;
+    createdAt: number;
+    connectedAt?: number;
+}
+export interface WebRTCSignalingEvents {
+    peerConnected: {
+        peerId: string;
+        dataChannel: MockRTCDataChannel;
+    };
+    peerDisconnected: {
+        peerId: string;
+    };
+    peerMessage: {
+        peerId: string;
+        data: string | ArrayBuffer;
+    };
+    peerError: {
+        peerId: string;
+        error: Error;
+    };
+    signalingStateChange: {
+        peerId: string;
+        state: PeerConnectionState;
+    };
+}
+/**
+ * WebRTC Signaling Adapter
+ *
+ * Manages WebRTC peer connections using Control Tower for signaling.
+ */
+export declare class WebRTCSignalingAdapter {
+    private client;
+    private config;
+    private peers;
+    private eventUnsubscribers;
+    onPeerConnected: ((peerId: string, dataChannel: MockRTCDataChannel) => void) | null;
+    onPeerDisconnected: ((peerId: string) => void) | null;
+    onPeerMessage: ((peerId: string, data: string | ArrayBuffer) => void) | null;
+    onError: ((peerId: string, error: Error) => void) | null;
+    onStateChange: ((peerId: string, state: PeerConnectionState) => void) | null;
+    constructor(client: BaseClient, config?: WebRTCSignalingConfig);
+    /**
+     * Initiate a WebRTC connection to a peer
+     */
+    connectToPeer(peerId: string): Promise<void>;
+    /**
+     * Disconnect from a peer
+     */
+    disconnectFromPeer(peerId: string): void;
+    /**
+     * Send data to a peer via DataChannel
+     */
+    sendToPeer(peerId: string, data: string | ArrayBuffer): void;
+    /**
+     * Broadcast data to all connected peers
+     */
+    broadcastToPeers(data: string | ArrayBuffer): void;
+    /**
+     * Get connected peer IDs
+     */
+    getConnectedPeers(): string[];
+    /**
+     * Get all peer IDs (including connecting/disconnected)
+     */
+    getAllPeers(): string[];
+    /**
+     * Get peer connection state
+     */
+    getPeerState(peerId: string): PeerConnectionState | null;
+    /**
+     * Get peer connection info
+     */
+    getPeerInfo(peerId: string): PeerConnection | null;
+    /**
+     * Check if connected to a peer
+     */
+    isConnectedToPeer(peerId: string): boolean;
+    /**
+     * Disconnect from all peers and clean up
+     */
+    dispose(): void;
+    private createPeerConnection;
+    private setupSignalingListeners;
+    private handleSignalingMessage;
+    private handleOffer;
+    private handleAnswer;
+    private handleIceCandidate;
+    private handlePeerDisconnect;
+    private setupConnectionHandlers;
+    private setupDataChannelHandlers;
+    private updatePeerState;
+    private sendSignal;
+}
+//# sourceMappingURL=WebRTCSignalingAdapter.d.ts.map

package/dist/adapters/webrtc/WebRTCSignalingAdapter.d.ts.map

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