coinbase-api 0.3.2 → 0.5.0

package/dist/mjs/lib/BaseWSClient.js

@@ -0,0 +1,631 @@
+import EventEmitter from 'events';
+import WebSocket from 'isomorphic-ws';
+import { WS_LOGGER_CATEGORY } from '../WebsocketClient.js';
+import { DefaultLogger } from './websocket/logger.js';
+import { isMessageEvent, } from './websocket/websocket-util.js';
+import { WsStore } from './websocket/WsStore.js';
+import { WsConnectionStateEnum, } from './websocket/WsStore.types.js';
+/**
+ * Users can conveniently pass topics as strings or objects (object has topic name + optional params).
+ *
+ * This method normalises topics into objects (object has topic name + optional params).
+ */
+function getNormalisedTopicRequests(wsTopicRequests) {
+    const normalisedTopicRequests = [];
+    for (const wsTopicRequest of wsTopicRequests) {
+        // passed as string, convert to object
+        if (typeof wsTopicRequest === 'string') {
+            const topicRequest = {
+                topic: wsTopicRequest,
+                payload: undefined,
+            };
+            normalisedTopicRequests.push(topicRequest);
+            continue;
+        }
+        // already a normalised object, thanks to user
+        normalisedTopicRequests.push(wsTopicRequest);
+    }
+    return normalisedTopicRequests;
+}
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
+export class BaseWebsocketClient extends EventEmitter {
+    wsStore;
+    logger;
+    options;
+    wsApiRequestId = 0;
+    constructor(options, logger) {
+        super();
+        this.logger = logger || DefaultLogger;
+        this.wsStore = new WsStore(this.logger);
+        this.options = {
+            pongTimeout: 1000,
+            pingInterval: 10000,
+            reconnectTimeout: 500,
+            useSandbox: false,
+            recvWindow: 0,
+            // Requires a confirmation "response" from the ws connection before assuming it is ready
+            requireConnectionReadyConfirmation: false,
+            // Automatically auth after opening a connection?
+            authPrivateConnectionsOnConnect: false,
+            // Automatically include auth/sign with every WS request
+            authPrivateRequests: true,
+            // Automatically re-auth WS API, if we were auth'd before and get reconnected
+            reauthWSAPIOnReconnect: false,
+            ...options,
+        };
+    }
+    isPrivateWsKey(wsKey) {
+        return this.getPrivateWSKeys().includes(wsKey);
+    }
+    /** Returns auto-incrementing request ID, used to track promise references for async requests */
+    getNewRequestId() {
+        return `${++this.wsApiRequestId}`;
+    }
+    /**
+     * Subscribe to one or more topics on a WS connection (identified by WS Key).
+     *
+     * - Topics are automatically cached
+     * - Connections are automatically opened, if not yet connected
+     * - Authentication is automatically handled
+     * - Topics are automatically resubscribed to, if something happens to the connection, unless you call unsubsribeTopicsForWsKey(topics, key).
+     *
+     * @param wsTopicRequests array of topics to subscribe to
+     * @param wsKey ws key referring to the ws connection these topics should be subscribed on
+     */
+    subscribeTopicsForWsKey(wsTopicRequests, wsKey) {
+        const normalisedTopicRequests = getNormalisedTopicRequests(wsTopicRequests);
+        // Store topics, so future automation (post-auth, post-reconnect) has everything needed to resubscribe automatically
+        for (const topic of normalisedTopicRequests) {
+            this.wsStore.addTopic(wsKey, topic);
+        }
+        const isConnected = this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED);
+        const isConnectionInProgress = this.wsStore.isConnectionAttemptInProgress(wsKey);
+        // start connection process if it hasn't yet begun. Topics are automatically subscribed to on-connect
+        if (!isConnected && !isConnectionInProgress) {
+            return this.connect(wsKey);
+        }
+        // Subscribe should happen automatically once connected, nothing to do here after topics are added to wsStore.
+        if (!isConnected) {
+            /**
+             * Are we in the process of connection? Nothing to send yet.
+             */
+            this.logger.trace(`WS not connected - requests queued for retry once connected.`, {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+                wsTopicRequests,
+            });
+            return;
+        }
+        // We're connected. Check if auth is needed and if already authenticated
+        const isPrivateConnection = this.isPrivateWsKey(wsKey);
+        const isAuthenticated = this.wsStore.get(wsKey)?.isAuthenticated;
+        if (isPrivateConnection && !isAuthenticated) {
+            /**
+             * If not authenticated yet and auth is required, don't request topics yet.
+             *
+             * Auth should already automatically be in progress, so no action needed from here. Topics will automatically subscribe post-auth success.
+             */
+            this.logger.trace(`WS connected but not authenticated yet - awaiting auth before subscribing`);
+            return false;
+        }
+        // Finally, request subscription to topics if the connection is healthy and ready
+        this.requestSubscribeTopics(wsKey, normalisedTopicRequests);
+    }
+    unsubscribeTopicsForWsKey(wsTopicRequests, wsKey) {
+        const normalisedTopicRequests = getNormalisedTopicRequests(wsTopicRequests);
+        // Store topics, so future automation (post-auth, post-reconnect) has everything needed to resubscribe automatically
+        for (const topic of normalisedTopicRequests) {
+            this.wsStore.addTopic(wsKey, topic);
+        }
+        const isConnected = this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED);
+        // If not connected, don't need to do anything.
+        // Removing the topic from the store is enough to stop it from being resubscribed to on reconnect.
+        if (!isConnected) {
+            return;
+        }
+        // We're connected. Check if auth is needed and if already authenticated
+        const isPrivateConnection = this.isPrivateWsKey(wsKey);
+        const isAuthenticated = this.wsStore.get(wsKey)?.isAuthenticated;
+        if (isPrivateConnection && !isAuthenticated) {
+            /**
+             * If not authenticated yet and auth is required, don't need to do anything.
+             * We don't subscribe to topics until auth is complete anyway.
+             */
+            return;
+        }
+        // Finally, request subscription to topics if the connection is healthy and ready
+        this.requestUnsubscribeTopics(wsKey, normalisedTopicRequests);
+    }
+    /**
+     * Splits topic requests into two groups, public & private topic requests
+     */
+    sortTopicRequestsIntoPublicPrivate(wsTopicRequests, wsKey) {
+        const publicTopicRequests = [];
+        const privateTopicRequests = [];
+        for (const topic of wsTopicRequests) {
+            if (this.isPrivateTopicRequest(topic, wsKey)) {
+                privateTopicRequests.push(topic);
+            }
+            else {
+                publicTopicRequests.push(topic);
+            }
+        }
+        return {
+            publicReqs: publicTopicRequests,
+            privateReqs: privateTopicRequests,
+        };
+    }
+    /** Get the WsStore that tracks websockets & topics */
+    getWsStore() {
+        return this.wsStore;
+    }
+    close(wsKey, force) {
+        this.logger.info('Closing connection', { ...WS_LOGGER_CATEGORY, wsKey });
+        this.setWsState(wsKey, WsConnectionStateEnum.CLOSING);
+        this.clearTimers(wsKey);
+        const ws = this.getWs(wsKey);
+        ws?.close();
+        if (force) {
+            ws?.terminate();
+        }
+    }
+    closeAll(force) {
+        this.wsStore.getKeys().forEach((key) => {
+            this.close(key, force);
+        });
+    }
+    isConnected(wsKey) {
+        return this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED);
+    }
+    /**
+     * Request connection to a specific websocket, instead of waiting for automatic connection.
+     */
+    async connect(wsKey) {
+        try {
+            if (this.wsStore.isWsOpen(wsKey)) {
+                this.logger.error('Refused to connect to ws with existing active connection', { ...WS_LOGGER_CATEGORY, wsKey });
+                return { wsKey };
+            }
+            if (this.wsStore.isConnectionAttemptInProgress(wsKey)) {
+                this.logger.error('Refused to connect to ws, connection attempt already active', { ...WS_LOGGER_CATEGORY, wsKey });
+                return;
+            }
+            if (!this.wsStore.getConnectionState(wsKey) ||
+                this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.INITIAL)) {
+                this.setWsState(wsKey, WsConnectionStateEnum.CONNECTING);
+            }
+            if (!this.wsStore.getConnectionInProgressPromise(wsKey)) {
+                this.wsStore.createConnectionInProgressPromise(wsKey, false);
+            }
+            try {
+                const url = await this.getWsUrl(wsKey);
+                const ws = this.connectToWsUrl(url, wsKey);
+                this.wsStore.setWs(wsKey, ws);
+            }
+            catch (e) {
+                this.logger.error(`Exception fetching WS URL`, e);
+                throw e;
+            }
+            return this.wsStore.getConnectionInProgressPromise(wsKey)?.promise;
+        }
+        catch (err) {
+            this.parseWsError('Connection failed', err, wsKey);
+            this.reconnectWithDelay(wsKey, this.options.reconnectTimeout);
+        }
+    }
+    connectToWsUrl(url, wsKey) {
+        this.logger.trace(`Opening WS connection to URL: ${url}`, {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+        });
+        const ws = new WebSocket(url, undefined);
+        ws.onopen = (event) => this.onWsOpen(event, wsKey);
+        ws.onmessage = (event) => this.onWsMessage(event, wsKey, ws);
+        ws.onerror = (event) => this.parseWsError('websocket error', event, wsKey);
+        ws.onclose = (event) => this.onWsClose(event, wsKey);
+        if (typeof ws.on === 'function') {
+            ws.on('ping', (event) => this.onWsPing(event, wsKey, ws, 'event'));
+            ws.on('pong', (event) => this.onWsPong(event, wsKey, 'event'));
+        }
+        return ws;
+    }
+    parseWsError(context, error, wsKey) {
+        if (this.wsStore.isConnectionAttemptInProgress(wsKey)) {
+            this.setWsState(wsKey, WsConnectionStateEnum.ERROR_RECONNECTING);
+        }
+        if (!error.message) {
+            this.logger.error(`${context} due to unexpected error: `, error);
+            this.emit('response', { ...error, wsKey });
+            this.emit('exception', { ...error, wsKey });
+            return;
+        }
+        switch (error.message) {
+            case 'Unexpected server response: 401':
+                this.logger.error(`${context} due to 401 authorization failure.`, {
+                    ...WS_LOGGER_CATEGORY,
+                    wsKey,
+                });
+                break;
+            default:
+                if (error?.code === 'ENOTFOUND') {
+                    this.logger.error(`${context} due to lookup exception: "${error?.msg || error?.message || error}"`, {
+                        ...WS_LOGGER_CATEGORY,
+                        wsKey,
+                        error,
+                        connectionState: this.wsStore.getConnectionState(wsKey),
+                    });
+                    break;
+                }
+                this.logger.error(`${context} due to unexpected response error: "${error?.msg || error?.message || error}"`, { ...WS_LOGGER_CATEGORY, wsKey, error });
+                break;
+        }
+        this.emit('exception', { ...error, wsKey });
+    }
+    /** Get a signature, build the auth request and send it */
+    async sendAuthRequest(wsKey) {
+        try {
+            this.logger.info(`Sending auth request...`, {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            const request = await this.getWsAuthRequestEvent(wsKey);
+            return this.tryWsSend(wsKey, JSON.stringify(request));
+        }
+        catch (e) {
+            this.logger.trace(e, { ...WS_LOGGER_CATEGORY, wsKey });
+        }
+    }
+    reconnectWithDelay(wsKey, connectionDelayMs) {
+        this.clearTimers(wsKey);
+        this.wsStore.get(wsKey, true).activeReconnectTimer = setTimeout(() => {
+            this.logger.info('Reconnecting to websocket', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            this.connect(wsKey);
+        }, connectionDelayMs);
+    }
+    ping(wsKey) {
+        if (this.wsStore.get(wsKey, true).activePongTimer) {
+            return;
+        }
+        this.clearPongTimer(wsKey);
+        this.logger.trace('Sending ping', { ...WS_LOGGER_CATEGORY, wsKey });
+        const ws = this.wsStore.get(wsKey, true).ws;
+        if (!ws) {
+            this.logger.error(`Unable to send ping for wsKey "${wsKey}" - no connection found`);
+            return;
+        }
+        this.sendPingEvent(wsKey, ws);
+        this.wsStore.get(wsKey, true).activePongTimer = setTimeout(() => {
+            this.logger.info('Pong timeout - closing socket to reconnect', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            this.clearPongTimer(wsKey);
+            this.getWs(wsKey)?.terminate();
+        }, this.options.pongTimeout);
+    }
+    clearTimers(wsKey) {
+        this.clearPingTimer(wsKey);
+        this.clearPongTimer(wsKey);
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activeReconnectTimer) {
+            clearTimeout(wsState.activeReconnectTimer);
+        }
+    }
+    // Send a ping at intervals
+    clearPingTimer(wsKey) {
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activePingTimer) {
+            clearInterval(wsState.activePingTimer);
+            wsState.activePingTimer = undefined;
+        }
+    }
+    // Expect a pong within a time limit
+    clearPongTimer(wsKey) {
+        const wsState = this.wsStore.get(wsKey);
+        if (wsState?.activePongTimer) {
+            clearTimeout(wsState.activePongTimer);
+            wsState.activePongTimer = undefined;
+            // this.logger.trace(`Cleared pong timeout for "${wsKey}"`);
+        }
+        else {
+            // this.logger.trace(`No active pong timer for "${wsKey}"`);
+        }
+    }
+    /**
+     * Simply builds and sends subscribe events for a list of topics for a ws key
+     *
+     * @private Use the `subscribe(topics)` or `subscribeTopicsForWsKey(topics, wsKey)` method to subscribe to topics. Send WS message to subscribe to topics.
+     */
+    async requestSubscribeTopics(wsKey, topics) {
+        if (!topics.length) {
+            return;
+        }
+        // Automatically splits requests into smaller batches, if needed
+        const subscribeWsMessages = await this.getWsOperationEventsForTopics(topics, wsKey, 'subscribe');
+        this.logger.trace(`Subscribing to ${topics.length} "${wsKey}" topics in ${subscribeWsMessages.length} batches. Events: "${JSON.stringify(topics)}"`);
+        for (const wsMessage of subscribeWsMessages) {
+            this.logger.trace(`Sending batch via message: "${wsMessage}"`);
+            this.tryWsSend(wsKey, wsMessage);
+        }
+        this.logger.trace(`Finished subscribing to ${topics.length} "${wsKey}" topics in ${subscribeWsMessages.length} batches.`);
+    }
+    /**
+     * Simply builds and sends unsubscribe events for a list of topics for a ws key
+     *
+     * @private Use the `unsubscribe(topics)` method to unsubscribe from topics. Send WS message to unsubscribe from topics.
+     */
+    async requestUnsubscribeTopics(wsKey, wsTopicRequests) {
+        if (!wsTopicRequests.length) {
+            return;
+        }
+        const subscribeWsMessages = await this.getWsOperationEventsForTopics(wsTopicRequests, wsKey, 'unsubscribe');
+        this.logger.trace(`Unsubscribing to ${wsTopicRequests.length} "${wsKey}" topics in ${subscribeWsMessages.length} batches. Events: "${JSON.stringify(wsTopicRequests)}"`);
+        for (const wsMessage of subscribeWsMessages) {
+            this.logger.trace(`Sending batch via message: "${wsMessage}"`);
+            this.tryWsSend(wsKey, wsMessage);
+        }
+        this.logger.trace(`Finished unsubscribing to ${wsTopicRequests.length} "${wsKey}" topics in ${subscribeWsMessages.length} batches.`);
+    }
+    /**
+     * Try sending a string event on a WS connection (identified by the WS Key)
+     */
+    tryWsSend(wsKey, wsMessage) {
+        try {
+            this.logger.trace(`Sending upstream ws message: `, {
+                ...WS_LOGGER_CATEGORY,
+                wsMessage,
+                wsKey,
+            });
+            if (!wsKey) {
+                throw new Error('Cannot send message due to no known websocket for this wsKey');
+            }
+            const ws = this.getWs(wsKey);
+            if (!ws) {
+                throw new Error(`${wsKey} socket not connected yet, call "connectAll()" first then try again when the "open" event arrives`);
+            }
+            ws.send(wsMessage);
+        }
+        catch (e) {
+            this.logger.error(`Failed to send WS message`, {
+                ...WS_LOGGER_CATEGORY,
+                wsMessage,
+                wsKey,
+                exception: e,
+            });
+        }
+    }
+    async onWsOpen(event, wsKey) {
+        const didReconnectSuccessfully = this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.RECONNECTING) ||
+            this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.ERROR_RECONNECTING);
+        if (this.wsStore.isConnectionState(wsKey, WsConnectionStateEnum.CONNECTING)) {
+            this.logger.info('Websocket connected', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+            });
+            this.emit('open', { wsKey, event });
+        }
+        else {
+            this.logger.info('Websocket reconnected', {
+                ...WS_LOGGER_CATEGORY,
+                wsKey,
+                didReconnectSuccessfully,
+            });
+            this.emit('reconnected', {
+                wsKey,
+                event,
+                didReconnectSuccessfully,
+            });
+        }
+        this.setWsState(wsKey, WsConnectionStateEnum.CONNECTED);
+        this.logger.trace(`Enabled ping timer`, { ...WS_LOGGER_CATEGORY, wsKey });
+        this.wsStore.get(wsKey, true).activePingTimer = setInterval(() => this.ping(wsKey), this.options.pingInterval);
+        if (!this.options.requireConnectionReadyConfirmation) {
+            await this.onWsReadyForEvents(wsKey);
+        }
+    }
+    onWsPing(_event, wsKey, ws, source) {
+        this.logger.trace('Received ping, sending pong frame', {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+            source,
+        });
+        ws.pong();
+    }
+    onWsPong(_event, wsKey, source) {
+        this.logger.trace('Received pong, clearing pong timer', {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+            source,
+        });
+        this.clearPongTimer(wsKey);
+    }
+    /**
+     * Called automatically once a connection is ready.
+     * - Some exchanges are ready immediately after the connections open.
+     * - Some exchanges send an event to confirm the connection is ready for us.
+     *
+     * This method is called to act when the connection is ready. Use `requireConnectionReadyConfirmation` to control how this is called.
+     */
+    async onWsReadyForEvents(wsKey) {
+        try {
+            // Resolve & cleanup deferred "connection attempt in progress" promise
+            const connectionInProgressPromise = this.wsStore.getConnectionInProgressPromise(wsKey);
+            if (connectionInProgressPromise?.resolve) {
+                connectionInProgressPromise.resolve({
+                    wsKey,
+                });
+            }
+        }
+        catch (e) {
+            this.logger.error(`Exception trying to resolve "connectionInProgress" promise`);
+        }
+        // Remove before resolving, in case there's more requests queued
+        this.wsStore.removeConnectingInProgressPromise(wsKey);
+        // Some websockets require an auth packet to be sent after opening the connection
+        if (this.isPrivateWsKey(wsKey) &&
+            this.options.authPrivateConnectionsOnConnect) {
+            await this.sendAuthRequest(wsKey);
+        }
+        // Reconnect to topics known before it connected
+        const { privateReqs, publicReqs } = this.sortTopicRequestsIntoPublicPrivate([...this.wsStore.getTopics(wsKey)], wsKey);
+        // Request sub to public topics, if any
+        this.requestSubscribeTopics(wsKey, publicReqs);
+        // Request sub to private topics, if auth on connect isn't needed
+        if (!this.options.authPrivateConnectionsOnConnect) {
+            this.requestSubscribeTopics(wsKey, privateReqs);
+        }
+    }
+    /**
+     * Handle subscription to private topics _after_ authentication successfully completes asynchronously.
+     *
+     * Only used for exchanges that require auth before sending private topic subscription requests
+     */
+    onWsAuthenticated(wsKey, event) {
+        const wsState = this.wsStore.get(wsKey, true);
+        wsState.isAuthenticated = true;
+        if (this.options.authPrivateConnectionsOnConnect) {
+            const topics = [...this.wsStore.getTopics(wsKey)];
+            const privateTopics = topics.filter((topic) => this.isPrivateTopicRequest(topic, wsKey));
+            if (privateTopics.length) {
+                this.subscribeTopicsForWsKey(privateTopics, wsKey);
+            }
+        }
+        if (event?.isWSAPI && event?.WSAPIAuthChannel) {
+            wsState.didAuthWSAPI = true;
+            wsState.WSAPIAuthChannel = event.WSAPIAuthChannel;
+        }
+    }
+    onWsMessage(event, wsKey, ws) {
+        try {
+            // any message can clear the pong timer - wouldn't get a message if the ws wasn't working
+            this.clearPongTimer(wsKey);
+            if (this.isWsPong(event)) {
+                return this.onWsPong(event, wsKey, 'onWsMessage');
+            }
+            if (this.isWsPing(event)) {
+                this.logger.trace('Received ping', {
+                    ...WS_LOGGER_CATEGORY,
+                    wsKey,
+                    event,
+                });
+                this.sendPongEvent(wsKey, ws);
+                return;
+            }
+            if (isMessageEvent(event)) {
+                const data = event.data;
+                const dataType = event.type;
+                const emittableEvents = this.resolveEmittableEvents(wsKey, event);
+                if (!emittableEvents.length) {
+                    // console.log(`raw event: `, { data, dataType, emittableEvents });
+                    this.logger.error('Unhandled/unrecognised ws event message - returned no emittable data', {
+                        ...WS_LOGGER_CATEGORY,
+                        message: data || 'no message',
+                        dataType,
+                        event,
+                        wsKey,
+                    });
+                    return this.emit('update', { ...event, wsKey });
+                }
+                for (const emittable of emittableEvents) {
+                    if (this.isWsPong(emittable)) {
+                        this.logger.trace('Received pong', {
+                            ...WS_LOGGER_CATEGORY,
+                            wsKey,
+                            data,
+                        });
+                        continue;
+                    }
+                    if (emittable.eventType === 'connectionReady') {
+                        this.logger.trace(`Successfully connected - connection ready for events`, {
+                            ...WS_LOGGER_CATEGORY,
+                            wsKey,
+                        });
+                        const wsState = this.wsStore.get(wsKey);
+                        if (this.isPrivateWsKey(wsKey) &&
+                            wsState &&
+                            !this.options.authPrivateConnectionsOnConnect) {
+                            wsState.isAuthenticated = true;
+                        }
+                        this.emit('response', { ...emittable.event, wsKey });
+                        this.onWsReadyForEvents(wsKey);
+                        continue;
+                    }
+                    if (emittable.eventType === 'authenticated') {
+                        this.logger.trace(`Successfully authenticated`, {
+                            ...WS_LOGGER_CATEGORY,
+                            wsKey,
+                        });
+                        this.emit(emittable.eventType, { ...emittable.event, wsKey });
+                        this.onWsAuthenticated(wsKey, emittable.event);
+                        continue;
+                    }
+                    this.emit(emittable.eventType, { ...emittable.event, wsKey });
+                }
+                return;
+            }
+            this.logger.error('Unhandled/unrecognised ws event message - unexpected message format', {
+                ...WS_LOGGER_CATEGORY,
+                message: event || 'no message',
+                event,
+                wsKey,
+            });
+        }
+        catch (e) {
+            this.logger.error('Failed to parse ws event message', {
+                ...WS_LOGGER_CATEGORY,
+                error: e,
+                event,
+                wsKey,
+            });
+        }
+    }
+    onWsClose(event, wsKey) {
+        this.logger.info('Websocket connection closed', {
+            ...WS_LOGGER_CATEGORY,
+            wsKey,
+        });
+        if (this.wsStore.getConnectionState(wsKey) !== WsConnectionStateEnum.CLOSING) {
+            // clean up any pending promises for this connection
+            this.getWsStore().rejectAllDeferredPromises(wsKey, 'connection lost, reconnecting');
+            this.setWsState(wsKey, WsConnectionStateEnum.INITIAL);
+            this.reconnectWithDelay(wsKey, this.options.reconnectTimeout);
+            this.emit('reconnect', { wsKey, event });
+        }
+        else {
+            // clean up any pending promises for this connection
+            this.getWsStore().rejectAllDeferredPromises(wsKey, 'disconnected');
+            this.setWsState(wsKey, WsConnectionStateEnum.INITIAL);
+            this.emit('close', { wsKey, event });
+        }
+    }
+    getWs(wsKey) {
+        return this.wsStore.getWs(wsKey);
+    }
+    setWsState(wsKey, state) {
+        this.wsStore.setConnectionState(wsKey, state);
+    }
+    /**
+     * Promise-driven method to assert that a ws has successfully connected (will await until connection is open)
+     */
+    async assertIsConnected(wsKey) {
+        const isConnected = this.getWsStore().isConnectionState(wsKey, WsConnectionStateEnum.CONNECTED);
+        if (!isConnected) {
+            const inProgressPromise = this.getWsStore().getConnectionInProgressPromise(wsKey);
+            // Already in progress? Await shared promise and retry
+            if (inProgressPromise) {
+                this.logger.trace(`sendWSAPIRequest(): Awaiting EXISTING connection promise...`);
+                await inProgressPromise.promise;
+                this.logger.trace(`sendWSAPIRequest(): EXISTING connection promise resolved!`);
+                return;
+            }
+            // Start connection, it should automatically store/return a promise.
+            this.logger.trace(`sendWSAPIRequest(): Not connected yet...queue await connection...`);
+            await this.connect(wsKey);
+            this.logger.trace(`sendWSAPIRequest(): New connection promise resolved! `);
+        }
+    }
+}
+//# sourceMappingURL=BaseWSClient.js.map

package/dist/mjs/lib/BaseWSClient.js.map

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