@spaceandtimelabs/makeinfinite-ui 0.50.0 → 0.51.0

package/dist/index.d.ts

@@ -1372,12 +1372,50 @@ declare const useVariants: () => {
     setVariants: any;
 };
 
+/**
+ * Hook for managing a WebSocket connection with automatic reconnection
+ *
+ * @param url WebSocket URL to connect to (set to null to prevent connection)
+ * @param onMessageReceived Callback function to handle received messages
+ * @param options Connection options
+ */
+export declare const useWebSocketManager: (url: string | null, onMessageReceived: (data: any) => void, options?: WebSocketOptions) => UseWebSocketManagerReturn;
+
+/**
+ * Return type for useWebSocketManager hook
+ */
+declare interface UseWebSocketManagerReturn {
+    /** Current connection status */
+    connectionStatus: WebSocketStatus;
+    /** Function to send messages over the WebSocket */
+    sendMessage: (message: object) => boolean;
+    /** Most recent error during connection or message handling */
+    lastError: Error | null;
+}
+
 export declare namespace Variants {
     export {
         DEFAULT
     }
 }
 
+/**
+ * Options for WebSocket connection management
+ */
+declare interface WebSocketOptions {
+    /** Maximum number of reconnection attempts (default: 5) */
+    maxReconnectAttempts?: number;
+    /** Initial delay in ms before first reconnection attempt (default: 1000) */
+    reconnectInitialDelay?: number;
+    /** Exponential backoff factor for subsequent reconnect attempts (default: 2) */
+    reconnectBackoffFactor?: number;
+}
+
+/**
+ * WebSocket connection status
+ */
+declare type WebSocketStatus = "idle" | "connecting" | "open" | "closing" | "closed";
+
 export { }