@asteby/metacore-websocket 0.4.0 → 0.5.0

package/dist/channels.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Multi-channel WebSocket client.
+ *
+ * Complements the single-socket `WebSocketProvider`: some backends (hubs
+ * that route by logical channel — notifications, chat, live TV) expect ONE
+ * connection PER channel, addressed by query params:
+ *
+ *   wss://api.example.com/ws?channel=chat&token=<jwt>&with=42
+ *
+ * This client manages that pool imperatively and framework-agnostically:
+ * auto-reconnect with exponential backoff, React StrictMode-safe
+ * subscription (100ms close debounce so double-mount doesn't drop the
+ * socket), and lazy connection per channel.
+ *
+ * Origin: battle-tested client contributed upstream from doctores.lat.
+ */
+/** Handler for incoming messages on a channel. */
+export type ChannelMessageHandler = (event: MessageEvent) => void;
+export interface ChannelClientOptions {
+    /** WS base URL, e.g. `wss://api.example.com/ws`. */
+    baseUrl: string;
+    /** Returns the current JWT; `null` suppresses the connection. */
+    getToken: () => string | null;
+    /** Max reconnection attempts per channel (default: 5). */
+    maxReconnectAttempts?: number;
+    /** Base reconnect delay in ms, doubled per attempt (default: 1000). */
+    reconnectBaseDelay?: number;
+}
+export type ChannelConnectionState = 'connected' | 'connecting' | 'disconnected' | 'reconnecting';
+export interface ChannelClient {
+    /**
+     * Subscribe a handler to a logical channel. Returns `unsubscribe`.
+     * StrictMode-safe: unsubscribing debounces the actual close by 100ms so a
+     * double-mount resubscription reuses the live socket.
+     */
+    subscribe: (channel: string, handler: ChannelMessageHandler, extraParams?: Record<string, string | number>) => () => void;
+    /** Send a string or JSON-serializable payload over a channel. */
+    send: (channel: string, payload: unknown, extraParams?: Record<string, string | number>) => void;
+    /** Close every open connection (e.g. on app teardown). */
+    disconnectAll: () => void;
+    /** Connection state for a channel. */
+    getConnectionState: (channel: string) => ChannelConnectionState;
+}
+export declare function createChannelClient(options: ChannelClientOptions): ChannelClient;
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,kDAAkD;AAClD,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;AAEjE,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC7B,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,YAAY,GACZ,cAAc,GACd,cAAc,CAAA;AAYlB,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,EAAE,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAC1C,MAAM,IAAI,CAAA;IACf,iEAAiE;IACjE,IAAI,EAAE,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAC1C,IAAI,CAAA;IACT,0DAA0D;IAC1D,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,sCAAsC;IACtC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,sBAAsB,CAAA;CAChE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA+MhF"}

package/dist/channels.js

@@ -0,0 +1,192 @@
+/**
+ * Multi-channel WebSocket client.
+ *
+ * Complements the single-socket `WebSocketProvider`: some backends (hubs
+ * that route by logical channel — notifications, chat, live TV) expect ONE
+ * connection PER channel, addressed by query params:
+ *
+ *   wss://api.example.com/ws?channel=chat&token=<jwt>&with=42
+ *
+ * This client manages that pool imperatively and framework-agnostically:
+ * auto-reconnect with exponential backoff, React StrictMode-safe
+ * subscription (100ms close debounce so double-mount doesn't drop the
+ * socket), and lazy connection per channel.
+ *
+ * Origin: battle-tested client contributed upstream from doctores.lat.
+ */
+export function createChannelClient(options) {
+    const connections = new Map();
+    const maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
+    const reconnectBaseDelay = options.reconnectBaseDelay ?? 1000;
+    function buildUrl(channel, token, extraParams) {
+        const url = new URL(options.baseUrl);
+        url.searchParams.set('channel', channel);
+        url.searchParams.set('token', token);
+        if (extraParams) {
+            Object.entries(extraParams).forEach(([key, value]) => {
+                url.searchParams.set(key, String(value));
+            });
+        }
+        return url.toString();
+    }
+    function createConnection(channel, existingHandlers, extraParams) {
+        const token = options.getToken();
+        if (!token) {
+            console.warn('[ws:channels] No token available for channel', channel);
+            return null;
+        }
+        const socket = new WebSocket(buildUrl(channel, token, extraParams));
+        const handlers = existingHandlers ?? new Set();
+        const connection = {
+            socket,
+            handlers,
+            reconnectAttempts: 0,
+            reconnectTimeout: null,
+            closeTimeout: null,
+            isClosed: false,
+            extraParams,
+        };
+        socket.onopen = () => {
+            connection.reconnectAttempts = 0;
+        };
+        socket.onmessage = (event) => {
+            handlers.forEach((handler) => handler(event));
+        };
+        socket.onclose = (event) => {
+            // Reconnect only when: not intentionally closed, someone is still
+            // listening, attempts remain, and the closure wasn't clean (1000).
+            if (!connection.isClosed &&
+                handlers.size > 0 &&
+                connection.reconnectAttempts < maxReconnectAttempts &&
+                event.code !== 1000) {
+                const delay = reconnectBaseDelay * Math.pow(2, connection.reconnectAttempts);
+                connection.reconnectTimeout = setTimeout(() => {
+                    connection.reconnectAttempts++;
+                    const newConn = createConnection(channel, handlers, extraParams);
+                    if (newConn) {
+                        // Preserve the attempt counter across the replacement socket so
+                        // the backoff caps at maxReconnectAttempts overall.
+                        newConn.reconnectAttempts = connection.reconnectAttempts;
+                        connections.set(channel, newConn);
+                    }
+                    else {
+                        connections.delete(channel);
+                    }
+                }, delay);
+            }
+            else {
+                connections.delete(channel);
+            }
+        };
+        socket.onerror = (event) => {
+            console.error('[ws:channels] Error on channel', channel, event);
+        };
+        connections.set(channel, connection);
+        return connection;
+    }
+    function ensureConnection(channel, extraParams) {
+        const existing = connections.get(channel);
+        if (existing &&
+            existing.socket.readyState !== WebSocket.CLOSED &&
+            existing.socket.readyState !== WebSocket.CLOSING) {
+            return existing;
+        }
+        if (existing) {
+            if (existing.reconnectTimeout)
+                clearTimeout(existing.reconnectTimeout);
+            connections.delete(channel);
+        }
+        return createConnection(channel, undefined, extraParams);
+    }
+    function subscribe(channel, handler, extraParams) {
+        const conn = ensureConnection(channel, extraParams);
+        if (!conn)
+            return () => { };
+        // Cancel a pending close (StrictMode resubscription).
+        if (conn.closeTimeout) {
+            clearTimeout(conn.closeTimeout);
+            conn.closeTimeout = null;
+            conn.isClosed = false;
+        }
+        conn.handlers.add(handler);
+        return () => {
+            const current = connections.get(channel);
+            if (!current)
+                return;
+            current.handlers.delete(handler);
+            if (current.handlers.size > 0)
+                return;
+            if (current.closeTimeout)
+                clearTimeout(current.closeTimeout);
+            // 100ms debounce lets StrictMode resubscribe before the real close.
+            current.closeTimeout = setTimeout(() => {
+                if (current.handlers.size > 0)
+                    return;
+                current.isClosed = true;
+                if (current.reconnectTimeout) {
+                    clearTimeout(current.reconnectTimeout);
+                    current.reconnectTimeout = null;
+                }
+                if (current.socket.readyState === WebSocket.OPEN) {
+                    current.socket.close(1000, 'No more handlers');
+                }
+                else if (current.socket.readyState === WebSocket.CONNECTING) {
+                    current.socket.addEventListener('open', () => {
+                        if (current.handlers.size === 0) {
+                            current.socket.close(1000, 'No more handlers');
+                        }
+                    }, { once: true });
+                }
+                connections.delete(channel);
+            }, 100);
+        };
+    }
+    function send(channel, payload, extraParams) {
+        const conn = ensureConnection(channel, extraParams);
+        if (!conn)
+            return;
+        const data = typeof payload === 'string' ? payload : JSON.stringify(payload);
+        if (conn.socket.readyState === WebSocket.OPEN) {
+            conn.socket.send(data);
+        }
+        else if (conn.socket.readyState === WebSocket.CONNECTING) {
+            conn.socket.addEventListener('open', () => conn.socket.send(data), {
+                once: true,
+            });
+        }
+        else {
+            console.warn('[ws:channels] Cannot send, socket not open for channel', channel);
+        }
+    }
+    function disconnectAll() {
+        connections.forEach((conn) => {
+            conn.isClosed = true;
+            if (conn.reconnectTimeout)
+                clearTimeout(conn.reconnectTimeout);
+            if (conn.closeTimeout)
+                clearTimeout(conn.closeTimeout);
+            if (conn.socket.readyState === WebSocket.OPEN ||
+                conn.socket.readyState === WebSocket.CONNECTING) {
+                conn.socket.close(1000, 'Disconnect all');
+            }
+        });
+        connections.clear();
+    }
+    function getConnectionState(channel) {
+        const conn = connections.get(channel);
+        if (!conn)
+            return 'disconnected';
+        if (conn.reconnectTimeout)
+            return 'reconnecting';
+        switch (conn.socket.readyState) {
+            case WebSocket.CONNECTING:
+                return 'connecting';
+            case WebSocket.OPEN:
+                return 'connected';
+            default:
+                return 'disconnected';
+        }
+    }
+    return { subscribe, send, disconnectAll, getConnectionState };
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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

package/dist/index.d.ts

@@ -2,4 +2,6 @@ export { WebSocketProvider, WebSocketContext } from './provider';
 export { useWebSocket, useWebSocketMessage } from './hooks';
 export { WebSocketStatus } from './types';
 export type { WebSocketMessage, WebSocketContextValue, WebSocketProviderProps, SendPayload, TokenGetter, } from './types';
+export { createChannelClient } from './channels';
+export type { ChannelClient, ChannelClientOptions, ChannelMessageHandler, ChannelConnectionState, } from './channels';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,4 +1,7 @@
 export { WebSocketProvider, WebSocketContext } from './provider';
 export { useWebSocket, useWebSocketMessage } from './hooks';
 export { WebSocketStatus } from './types';
+// Multi-channel imperative client (one socket per logical channel, routed
+// by query params). Complements the single-socket WebSocketProvider.
+export { createChannelClient } from './channels';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AASzC,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/provider.d.ts

@@ -5,5 +5,5 @@ export declare const WebSocketContext: import("react").Context<WebSocketContextV
  * auto-reconnect (exponential backoff), optional heartbeat, typed message
  * dispatch, and a pub/sub registry consumed by `useWebSocketMessage`.
  */
-export declare function WebSocketProvider<TMessage extends WebSocketMessage = WebSocketMessage>(props: WebSocketProviderProps<TMessage>): import("react/jsx-runtime").JSX.Element;
+export declare function WebSocketProvider<TMessage extends WebSocketMessage = WebSocketMessage>(props: WebSocketProviderProps<TMessage>): import("react").JSX.Element;
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAIhB,eAAO,MAAM,gBAAgB,iEAE5B,CAAA;AAwBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,EACpF,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,2CA+RxC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAIhB,eAAO,MAAM,gBAAgB,iEAE5B,CAAA;AAwBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,EACpF,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,+BA+RxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-websocket",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Metacore WebSocket provider — auto-reconnect, typed messages, channel subscriptions",
   "license": "Apache-2.0",
   "repository": {