@agentuity/frontend 0.1.14 → 0.1.16

package/dist/websocket-manager.js

@@ -0,0 +1,163 @@
+import { createReconnectManager } from './reconnect';
+import { deserializeData } from './serialization';
+/**
+ * Serialize data for WebSocket transmission
+ */
+const serializeWSData = (data) => {
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (typeof data === 'object') {
+        if (data instanceof ArrayBuffer || ArrayBuffer.isView(data) || data instanceof Blob) {
+            return data;
+        }
+        return JSON.stringify(data);
+    }
+    throw new Error('unsupported data type for websocket: ' + typeof data);
+};
+/**
+ * Generic WebSocket connection manager with automatic reconnection,
+ * message queuing, and handler management.
+ *
+ * Framework-agnostic - can be used with React, Svelte, Vue, or vanilla JS.
+ */
+export class WebSocketManager {
+    ws;
+    manualClose = false;
+    pendingMessages = [];
+    queuedMessages = [];
+    messageHandler;
+    reconnectManager;
+    callbacks;
+    url;
+    reconnectConfig;
+    constructor(options) {
+        this.url = options.url;
+        this.callbacks = options.callbacks || {};
+        this.reconnectConfig = {
+            threshold: options.reconnect?.threshold ?? 0,
+            baseDelay: options.reconnect?.baseDelay ?? 500,
+            factor: options.reconnect?.factor ?? 2,
+            maxDelay: options.reconnect?.maxDelay ?? 30000,
+            jitter: options.reconnect?.jitter ?? 500,
+        };
+    }
+    /**
+     * Connect to the WebSocket server
+     */
+    connect() {
+        if (this.manualClose)
+            return;
+        this.ws = new WebSocket(this.url);
+        this.ws.onopen = () => {
+            this.reconnectManager?.recordSuccess();
+            this.callbacks.onConnect?.();
+            // Flush queued messages
+            if (this.queuedMessages.length > 0) {
+                this.queuedMessages.forEach((msg) => this.ws.send(serializeWSData(msg)));
+                this.queuedMessages = [];
+            }
+        };
+        this.ws.onerror = () => {
+            const error = new Error('WebSocket error');
+            this.callbacks.onError?.(error);
+        };
+        this.ws.onclose = (evt) => {
+            this.ws = undefined;
+            this.callbacks.onDisconnect?.();
+            if (this.manualClose) {
+                this.queuedMessages = [];
+                return;
+            }
+            if (evt.code !== 1000) {
+                const error = new Error(`WebSocket closed: ${evt.code} ${evt.reason || ''}`);
+                this.callbacks.onError?.(error);
+            }
+            this.reconnectManager?.recordFailure();
+        };
+        this.ws.onmessage = (event) => {
+            const payload = deserializeData(event.data);
+            // Call the registered message handler
+            if (this.messageHandler) {
+                this.messageHandler(payload);
+            }
+            else {
+                // Buffer messages until a handler is set
+                this.pendingMessages.push(payload);
+            }
+            // Also call the callback if provided
+            this.callbacks.onMessage?.(payload);
+        };
+        // Setup reconnect manager
+        if (!this.reconnectManager) {
+            this.reconnectManager = createReconnectManager({
+                onReconnect: () => this.connect(),
+                threshold: this.reconnectConfig.threshold,
+                baseDelay: this.reconnectConfig.baseDelay,
+                factor: this.reconnectConfig.factor,
+                maxDelay: this.reconnectConfig.maxDelay,
+                jitter: this.reconnectConfig.jitter,
+                enabled: () => !this.manualClose,
+            });
+        }
+    }
+    /**
+     * Send data through the WebSocket.
+     * Messages are queued if not currently connected.
+     */
+    send(data) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(serializeWSData(data));
+        }
+        else {
+            this.queuedMessages.push(data);
+        }
+    }
+    /**
+     * Set the message handler.
+     * Any buffered messages will be delivered immediately.
+     */
+    setMessageHandler(handler) {
+        this.messageHandler = handler;
+        // Flush pending messages
+        this.pendingMessages.forEach(handler);
+        this.pendingMessages = [];
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            isConnected: this.ws?.readyState === WebSocket.OPEN,
+            error: null, // Error state managed externally via callbacks
+            readyState: this.ws?.readyState ?? WebSocket.CLOSED,
+        };
+    }
+    /**
+     * Close the WebSocket connection and cleanup
+     */
+    close() {
+        this.manualClose = true;
+        this.reconnectManager?.dispose();
+        if (this.ws) {
+            this.ws.onopen = null;
+            this.ws.onerror = null;
+            this.ws.onclose = null;
+            this.ws.onmessage = null;
+            this.ws.close();
+        }
+        this.ws = undefined;
+        this.messageHandler = undefined;
+        this.pendingMessages = [];
+        this.queuedMessages = [];
+        // Notify disconnect callback
+        this.callbacks.onDisconnect?.();
+    }
+    /**
+     * Dispose of the manager (alias for close)
+     */
+    dispose() {
+        this.close();
+    }
+}
+//# sourceMappingURL=websocket-manager.js.map

package/dist/websocket-manager.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/frontend",
-	"version": "0.1.14",
+	"version": "0.1.16",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -19,17 +19,17 @@
 		"src"
 	],
 	"scripts": {
-		"clean": "rm -rf dist",
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
 		"build": "bunx tsc --build && bun scripts/build-beacon.ts",
 		"typecheck": "bunx tsc --noEmit",
 		"test": "bun test",
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.1.14"
+		"@agentuity/core": "0.1.16"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.14",
+		"@agentuity/test-utils": "0.1.16",
 		"@types/bun": "latest",
 		"bun-types": "latest",
 		"typescript": "^5.9.0"