websocket-ts 2.3.0 → 3.0.0

package/dist/cjs/websocket.js

@@ -0,0 +1,588 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Websocket = void 0;
+const websocket_event_js_1 = require("./websocket_event.js");
+/**
+ * A websocket wrapper that can be configured to reconnect automatically and buffer messages when the websocket is not connected.
+ */
+class Websocket {
+    /**
+     * Creates a new websocket.
+     *
+     * @param url to connect to, or a function that returns a URL.
+     * @param protocols optional protocols to use.
+     * @param options optional options to use.
+     * @throws Error if retry options (maxRetries, instantReconnect) are set without a backoff.
+     * @throws Error if maxRetries is neither Infinity nor a non-negative integer.
+     */
+    constructor(url, protocols, options) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        this._closedByUser = false; // whether the websocket was closed by the user
+        // incremented by close() and reconnect() to invalidate in-flight lifecycle
+        // work: event handlers and retry timers belonging to an older generation
+        // must not commit further state transitions or create sockets
+        this._connectionGeneration = 0;
+        // for each listener-registration made with an AbortSignal, the function that
+        // unhooks the 'abort'-handler again; used to avoid piling up dead handlers on
+        // long-lived signals when listeners are removed by other means
+        this.abortHandlerCleanups = new WeakMap();
+        /**
+         * Handles the 'open' event of the browser-native websocket.
+         * @param event to handle.
+         */
+        this.handleOpenEvent = (event) => this.handleEvent(websocket_event_js_1.WebsocketEvent.open, event);
+        /**
+         * Handles the 'error' event of the browser-native websocket.
+         * @param event to handle.
+         */
+        this.handleErrorEvent = (event) => this.handleEvent(websocket_event_js_1.WebsocketEvent.error, event);
+        /**
+         * Handles the 'close' event of the browser-native websocket.
+         * @param event to handle.
+         */
+        this.handleCloseEvent = (event) => this.handleEvent(websocket_event_js_1.WebsocketEvent.close, event);
+        /**
+         * Handles the 'message' event of the browser-native websocket.
+         * @param event to handle.
+         */
+        this.handleMessageEvent = (event) => this.handleEvent(websocket_event_js_1.WebsocketEvent.message, event);
+        if (((_a = options === null || options === void 0 ? void 0 : options.retry) === null || _a === void 0 ? void 0 : _a.backoff) === undefined &&
+            (((_b = options === null || options === void 0 ? void 0 : options.retry) === null || _b === void 0 ? void 0 : _b.maxRetries) !== undefined ||
+                ((_c = options === null || options === void 0 ? void 0 : options.retry) === null || _c === void 0 ? void 0 : _c.instantReconnect) !== undefined)) {
+            // retrying is driven by the backoff; without one, the other retry options would silently do nothing
+            throw new Error("Retry options (maxRetries, instantReconnect) require a backoff to be configured");
+        }
+        const maxRetries = (_d = options === null || options === void 0 ? void 0 : options.retry) === null || _d === void 0 ? void 0 : _d.maxRetries;
+        if (maxRetries !== undefined &&
+            maxRetries !== Infinity &&
+            (!Number.isInteger(maxRetries) || maxRetries < 0)) {
+            // NaN would silently never exhaust, negative values exhaust before any
+            // retry, and fractions break the promise that the exhausted-detail
+            // retries equal the configured limit; fail fast like the backoffs do.
+            // Infinity is accepted as an explicit 'no limit', like undefined
+            throw new Error("MaxRetries must be undefined, Infinity or a non-negative integer");
+        }
+        this._urlProvider = url;
+        this._protocols = protocols;
+        // make a copy of the options to prevent the user from changing them
+        this._options = {
+            buffer: options === null || options === void 0 ? void 0 : options.buffer,
+            retry: {
+                maxRetries: (_e = options === null || options === void 0 ? void 0 : options.retry) === null || _e === void 0 ? void 0 : _e.maxRetries,
+                instantReconnect: (_f = options === null || options === void 0 ? void 0 : options.retry) === null || _f === void 0 ? void 0 : _f.instantReconnect,
+                backoff: (_g = options === null || options === void 0 ? void 0 : options.retry) === null || _g === void 0 ? void 0 : _g.backoff,
+            },
+            listeners: {
+                open: [],
+                close: [],
+                error: [],
+                message: [],
+                retry: [],
+                reconnect: [],
+                exhausted: [],
+            },
+        };
+        try {
+            // register the initial listeners through addEventListener so that
+            // listener options (e.g. 'signal') are honored for them as well; the
+            // generic helper keeps each event's listeners typed for that event
+            const register = (type) => {
+                var _a, _b;
+                return (_b = (_a = options === null || options === void 0 ? void 0 : options.listeners) === null || _a === void 0 ? void 0 : _a[type]) === null || _b === void 0 ? void 0 : _b.forEach((l) => this.addEventListener(type, l.listener, l.options));
+            };
+            Object.values(websocket_event_js_1.WebsocketEvent).forEach(register);
+            // this first attempt always assigns the underlying websocket: the URL
+            // provider is called without the instance as 'this', so it cannot reach
+            // close() or reconnect() to supersede it
+            this.tryConnect();
+        }
+        catch (error) {
+            // the caller never receives this instance and cannot remove its
+            // listeners, so unhook their abort-handlers; otherwise a long-lived
+            // signal would retain the failed instance and everything it references
+            Object.values(this._options.listeners).forEach((listeners) => listeners.forEach((l) => this.cleanupAbortHandler(l)));
+            throw error;
+        }
+    }
+    /**
+     * Getter for the url of the most recently constructed underlying websocket. This is not
+     * necessarily the URL of the last successful connection, and a URL that the WebSocket
+     * constructor rejected, or whose connection attempt was superseded, is not recorded.
+     *
+     * @return the url.
+     */
+    get url() {
+        return this._url;
+    }
+    /**
+     * Getter for the protocols.
+     *
+     * @return the protocols, or undefined if none were provided.
+     */
+    get protocols() {
+        return this._protocols;
+    }
+    /**
+     * Getter for the buffer.
+     *
+     * @return the buffer, or undefined if none was provided.
+     */
+    get buffer() {
+        return this._options.buffer;
+    }
+    /**
+     * Getter for the maxRetries.
+     *
+     * @return the maxRetries, or undefined if none was provided (no limit).
+     */
+    get maxRetries() {
+        return this._options.retry.maxRetries;
+    }
+    /**
+     * Getter for the instantReconnect.
+     *
+     * @return the instantReconnect, or undefined if none was provided.
+     */
+    get instantReconnect() {
+        return this._options.retry.instantReconnect;
+    }
+    /**
+     * Getter for the backoff.
+     *
+     * @return the backoff, or undefined if none was provided.
+     */
+    get backoff() {
+        return this._options.retry.backoff;
+    }
+    /**
+     * Whether the websocket was closed by the user. A websocket is closed by the user by calling close().
+     *
+     * @return true if the websocket was closed by the user, false otherwise.
+     */
+    get closedByUser() {
+        return this._closedByUser;
+    }
+    /**
+     * Getter for the time of the last 'open' event, i.e. the last time the websocket was connected.
+     *
+     * @return the time of the last 'open' event, or undefined if the websocket was never connected.
+     */
+    get lastConnection() {
+        // defensive copy: retry/reconnect/exhausted event details are derived
+        // from the internal timestamp, so callers must not be able to mutate it
+        return this._lastConnection && new Date(this._lastConnection);
+    }
+    /**
+     * Getter for the underlying websocket. This can be used to access the browser's native websocket directly.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket
+     * @return the underlying websocket.
+     */
+    get underlyingWebsocket() {
+        return this._underlyingWebsocket;
+    }
+    /**
+     * Getter for the readyState of the underlying websocket.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/readyState
+     * @return the readyState of the underlying websocket.
+     */
+    get readyState() {
+        return this._underlyingWebsocket.readyState;
+    }
+    /**
+     * Getter for the bufferedAmount of the underlying websocket.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/bufferedAmount
+     * @return the bufferedAmount of the underlying websocket.
+     */
+    get bufferedAmount() {
+        return this._underlyingWebsocket.bufferedAmount;
+    }
+    /**
+     * Getter for the extensions of the underlying websocket.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/extensions
+     * @return the extensions of the underlying websocket.
+     */
+    get extensions() {
+        return this._underlyingWebsocket.extensions;
+    }
+    /**
+     * Getter for the binaryType of the underlying websocket.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/binaryType
+     * @return the binaryType of the underlying websocket.
+     */
+    get binaryType() {
+        return this._underlyingWebsocket.binaryType;
+    }
+    /**
+     * Setter for the binaryType of the underlying websocket. The value is remembered
+     * and re-applied whenever a new underlying websocket is created after a reconnect.
+     *
+     * @param value to set, 'blob' or 'arraybuffer'.
+     */
+    set binaryType(value) {
+        this._binaryType = value;
+        this._underlyingWebsocket.binaryType = value;
+    }
+    /**
+     * Sends data over the websocket.
+     *
+     * If the websocket is not connected and a buffer was provided on creation, the data will be added to the buffer.
+     * If no buffer was provided or the websocket was closed by the user, the data will be dropped.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send
+     * @param data to send.
+     */
+    send(data) {
+        if (this.closedByUser)
+            return; // no-op if closed by user
+        if (this._underlyingWebsocket.readyState === this._underlyingWebsocket.OPEN) {
+            this._underlyingWebsocket.send(data); // websocket is connected, send data
+        }
+        else if (this.buffer !== undefined) {
+            this.buffer.add(data); // websocket is not connected, add data to buffer
+        }
+    }
+    /**
+     * Close the websocket. No automatic connection-retry will be attempted after this,
+     * until reconnect() is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close
+     * @param code optional close code.
+     * @param reason optional close reason.
+     */
+    close(code, reason) {
+        this._connectionGeneration++; // invalidate in-flight lifecycle work and pending retries
+        this.cancelScheduledConnectionRetry(); // cancel any scheduled retries
+        this._closedByUser = true; // mark websocket as closed by user
+        this._underlyingWebsocket.close(code, reason); // close underlying websocket with provided code and reason
+    }
+    /**
+     * (Re-)connects the websocket immediately, regardless of its current state:
+     * any scheduled retry is cancelled, the backoff and its retry-counter are
+     * reset, the URL provider is resolved again and a new connection is opened.
+     * This also revives a websocket that was closed by the user or that gave up
+     * after exceeding maxRetries (see the 'exhausted' event).
+     *
+     * Typical uses: a "reconnect" button after the 'exhausted' event, reacting to
+     * the browser's 'online' event, or forcing the URL provider to pick up a new
+     * auth token without waiting for the connection to drop.
+     *
+     * @throws whatever the URL provider or the WebSocket constructor throws.
+     */
+    reconnect() {
+        var _a;
+        this._connectionGeneration++; // invalidate in-flight lifecycle work and pending retries
+        this.cancelScheduledConnectionRetry(); // cancel any scheduled retries
+        this._closedByUser = false; // revive if the websocket was closed by the user
+        (_a = this.backoff) === null || _a === void 0 ? void 0 : _a.reset(); // start the next disconnection episode with a fresh retry budget
+        this.clearWebsocket(); // detach and close the current underlying websocket
+        this.tryConnect();
+    }
+    /**
+     * Adds an event listener for the given event-type. When an AbortSignal is
+     * provided in the options, aborting it removes exactly this registration;
+     * a listener whose signal is already aborted is never registered, mirroring
+     * the native EventTarget.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener
+     * @param type of the event to add the listener for.
+     * @param listener to add.
+     * @param options to use when adding the listener.
+     */
+    addEventListener(type, listener, options) {
+        const signal = options === null || options === void 0 ? void 0 : options.signal;
+        if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+            return; // the signal is already aborted, never register the listener
+        }
+        const entry = { listener, options };
+        if (signal !== undefined) {
+            // aborting the signal removes exactly this registration; the same
+            // listener-function may be registered again with a different signal
+            const removeOnAbort = () => {
+                this.abortHandlerCleanups.delete(entry);
+                this._options.listeners[type] = this._options.listeners[type].filter((l) => l !== entry);
+            };
+            signal.addEventListener("abort", removeOnAbort, { once: true });
+            this.abortHandlerCleanups.set(entry, () => signal.removeEventListener("abort", removeOnAbort));
+        }
+        this._options.listeners[type].push(entry); // add listener to list of listeners
+    }
+    /**
+     * Removes all event listeners for the given event-type that match the given listener.
+     *
+     * Matching is done by listener identity only, mirroring the native EventTarget:
+     * the options a listener was added with are ignored when matching.
+     *
+     * @param type of the event to remove the listener for.
+     * @param listener to remove.
+     * @param options ignored when matching, present for backward compatibility.
+     */
+    removeEventListener(type, listener, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    options) {
+        const isListenerNotToBeRemoved = (l) => l.listener !== listener;
+        this._options.listeners[type]
+            .filter((l) => !isListenerNotToBeRemoved(l))
+            .forEach((l) => this.cleanupAbortHandler(l)); // unhook abort-handlers of removed listeners
+        this._options.listeners[type] =
+            this._options.listeners[type].filter(isListenerNotToBeRemoved); // only keep listeners that are not to be removed
+    }
+    /**
+     * Creates a new browser-native websocket and connects it to the given URL with the given protocols
+     * and adds all event listeners to the browser-native websocket. The new websocket is stored in the
+     * '_underlyingWebsocket' property, unless the URL provider superseded this attempt by calling close()
+     * or reconnect().
+     */
+    tryConnect() {
+        const generation = this._connectionGeneration;
+        const urlProvider = this._urlProvider; // call the provider without the wrapper as receiver
+        const url = typeof urlProvider === "function" ? urlProvider() : urlProvider;
+        // the URL provider is user code and may have re-entered close() or
+        // reconnect(); that call now owns the lifecycle, so this attempt must
+        // neither open a socket after close() nor overwrite (and thereby orphan)
+        // the socket a nested reconnect() already committed
+        if (generation !== this._connectionGeneration)
+            return;
+        const socket = new WebSocket(url, this.protocols); // create new browser-native websocket and add all event listeners
+        this._url = url;
+        this._underlyingWebsocket = socket;
+        if (this._binaryType !== undefined) {
+            this._underlyingWebsocket.binaryType = this._binaryType; // re-apply the user-chosen binaryType
+        }
+        this._underlyingWebsocket.addEventListener(websocket_event_js_1.WebsocketEvent.open, this.handleOpenEvent);
+        this._underlyingWebsocket.addEventListener(websocket_event_js_1.WebsocketEvent.close, this.handleCloseEvent);
+        this._underlyingWebsocket.addEventListener(websocket_event_js_1.WebsocketEvent.error, this.handleErrorEvent);
+        this._underlyingWebsocket.addEventListener(websocket_event_js_1.WebsocketEvent.message, this.handleMessageEvent);
+    }
+    /**
+     * Removes all event listeners from the browser-native websocket and closes it.
+     */
+    clearWebsocket() {
+        this._underlyingWebsocket.removeEventListener(websocket_event_js_1.WebsocketEvent.open, this.handleOpenEvent);
+        this._underlyingWebsocket.removeEventListener(websocket_event_js_1.WebsocketEvent.close, this.handleCloseEvent);
+        this._underlyingWebsocket.removeEventListener(websocket_event_js_1.WebsocketEvent.error, this.handleErrorEvent);
+        this._underlyingWebsocket.removeEventListener(websocket_event_js_1.WebsocketEvent.message, this.handleMessageEvent);
+        this._underlyingWebsocket.close();
+    }
+    /**
+     * Dispatch an event to all listeners of the given event-type.
+     *
+     * @param type of the event to dispatch.
+     * @param event to dispatch.
+     */
+    dispatchEvent(type, event) {
+        // iterate over a snapshot so that listeners registered during dispatch are
+        // not invoked in this round, while mutations of the live list persist
+        const snapshot = [
+            ...this._options.listeners[type],
+        ];
+        snapshot.forEach((listenerWithOptions) => {
+            var _a;
+            // re-read the live list on every invocation: a listener may have
+            // added/removed listeners of this type, or replaced the list entirely
+            const listeners = this._options.listeners[type];
+            const index = listeners.indexOf(listenerWithOptions);
+            if (index === -1) {
+                return; // listener was removed during dispatch, don't invoke it
+            }
+            if ((_a = listenerWithOptions.options) === null || _a === void 0 ? void 0 : _a.once) {
+                listeners.splice(index, 1); // remove once-listener before invoking it
+                this.cleanupAbortHandler(listenerWithOptions); // unhook its abort-handler, if any
+            }
+            try {
+                listenerWithOptions.listener(this, event); // invoke listener with event
+            }
+            catch (error) {
+                // a throwing listener must neither stop the remaining listeners nor the
+                // lifecycle work that follows dispatch (retry scheduling, reconnection),
+                // mirroring how the native EventTarget isolates listener exceptions
+                this.reportListenerError(error);
+            }
+        });
+    }
+    /**
+     * Reports an exception thrown by a user-provided event listener. Uses
+     * globalThis.reportError where available (browsers); otherwise the exception
+     * is rethrown asynchronously so it still reaches the runtime's global
+     * error handling (e.g. 'uncaughtException' in Node.js) without breaking
+     * the dispatch it escaped from.
+     *
+     * @param error the exception thrown by the listener.
+     */
+    reportListenerError(error) {
+        if (typeof globalThis.reportError === "function") {
+            globalThis.reportError(error);
+        }
+        else {
+            globalThis.setTimeout(() => {
+                throw error;
+            }, 0);
+        }
+    }
+    /**
+     * Handles the given event by dispatching it to all listeners of the given event-type.
+     *
+     * @param type of the event to handle.
+     * @param event to handle.
+     */
+    handleEvent(type, event) {
+        // a listener may re-enter close() or reconnect() during dispatch; both bump
+        // the generation, in which case the transitions below must not be committed
+        const generation = this._connectionGeneration;
+        switch (type) {
+            case websocket_event_js_1.WebsocketEvent.close:
+                this.dispatchEvent(type, event);
+                if (generation !== this._connectionGeneration)
+                    break; // a listener already closed/reconnected
+                this.scheduleConnectionRetryIfNeeded(); // schedule a new connection retry if the websocket was closed by the server
+                break;
+            case websocket_event_js_1.WebsocketEvent.open: {
+                if (this.backoff !== undefined && this.backoff.retries > 0) {
+                    // a retry preceded this open, so the websocket was reconnected; this
+                    // includes recovery from a server that was unavailable at construction,
+                    // where no previous connection exists yet
+                    const detail = {
+                        retries: this.backoff.retries,
+                        lastConnection: this._lastConnection && new Date(this._lastConnection),
+                    };
+                    this.backoff.reset(); // reset before dispatch, so listeners observe a fresh retry budget
+                    const event = new CustomEvent(websocket_event_js_1.WebsocketEvent.reconnect, {
+                        detail,
+                    });
+                    this.dispatchEvent(websocket_event_js_1.WebsocketEvent.reconnect, event);
+                    if (generation !== this._connectionGeneration)
+                        break;
+                }
+                this._lastConnection = new Date();
+                this.dispatchEvent(type, event); // dispatch open event and send buffered data
+                if (generation !== this._connectionGeneration)
+                    break;
+                this.sendBufferedData();
+                break;
+            }
+            case websocket_event_js_1.WebsocketEvent.retry:
+                this.dispatchEvent(type, event); // dispatch retry event and try to connect
+                if (generation !== this._connectionGeneration)
+                    break; // this attempt was superseded during dispatch
+                this.clearWebsocket(); // clear the old websocket
+                try {
+                    this.tryConnect();
+                }
+                catch (error) {
+                    // the url provider or websocket-construction threw; surface the thrown
+                    // value as an 'error' event and keep the retry chain alive under the
+                    // usual rules. Native error events are plain Events, so listeners can
+                    // tell this case apart with 'instanceof ErrorEvent'
+                    this.dispatchEvent(websocket_event_js_1.WebsocketEvent.error, new ErrorEvent(websocket_event_js_1.WebsocketEvent.error, {
+                        error,
+                        message: error instanceof Error ? error.message : "",
+                    }));
+                    if (generation !== this._connectionGeneration)
+                        break;
+                    this.scheduleConnectionRetryIfNeeded();
+                }
+                break;
+            default:
+                this.dispatchEvent(type, event); // dispatch event to all listeners of the given event-type
+                break;
+        }
+    }
+    /**
+     * Sends buffered data if there is a buffer defined. Draining stops as soon as the
+     * websocket is no longer open, e.g. when a listener closed it during the drain;
+     * remaining elements stay buffered for the next successful connection. Without
+     * this guard, send() would re-add each read element to the buffer, cycling forever.
+     */
+    sendBufferedData() {
+        if (this.buffer === undefined) {
+            return; // no buffer defined, nothing to send
+        }
+        while (!this.closedByUser &&
+            this._underlyingWebsocket.readyState === this._underlyingWebsocket.OPEN) {
+            const ele = this.buffer.read();
+            if (ele === undefined) {
+                return; // buffer is empty
+            }
+            this.send(ele); // send buffered data
+        }
+    }
+    /**
+     * Schedules a connection-retry if there is a backoff defined and the websocket was not closed by the user.
+     */
+    scheduleConnectionRetryIfNeeded() {
+        if (this.closedByUser) {
+            return; // user closed the websocket, no retry
+        }
+        if (this.backoff === undefined) {
+            return; // no backoff defined, no retry
+        }
+        // handler dispatches the retry event to all listeners of the retry event-type
+        const handleRetryEvent = (detail) => {
+            const event = new CustomEvent(websocket_event_js_1.WebsocketEvent.retry, { detail });
+            this.handleEvent(websocket_event_js_1.WebsocketEvent.retry, event);
+        };
+        // when the maximum number of retries is exceeded, give up and dispatch the
+        // exhausted event; checked before advancing the backoff so that the counter
+        // equals the number of retries actually performed
+        if (this._options.retry.maxRetries !== undefined &&
+            this.backoff.retries >= this._options.retry.maxRetries) {
+            const detail = {
+                retries: this.backoff.retries,
+                lastConnection: this._lastConnection && new Date(this._lastConnection),
+            };
+            const event = new CustomEvent(websocket_event_js_1.WebsocketEvent.exhausted, {
+                detail,
+            });
+            this.dispatchEvent(websocket_event_js_1.WebsocketEvent.exhausted, event);
+            return;
+        }
+        // the backoff is reset on every successful reconnect, so a retry-count of
+        // zero means this is the first retry of the current disconnection episode
+        const isFirstRetryOfEpisode = this.backoff.retries === 0;
+        // advance the backoff so the retry-count is accurate and maxRetries applies;
+        // with 'instantReconnect' only the episode's first retry is instant. Browsers
+        // store timer delays as signed 32-bit integers, so longer delays would
+        // overflow and fire (almost) immediately; cap them at the maximum instead
+        const backoff = Math.min(this.backoff.next(), 2 ** 31 - 1);
+        const retryEventDetail = {
+            backoff: this._options.retry.instantReconnect === true && isFirstRetryOfEpisode
+                ? 0
+                : backoff,
+            retries: this.backoff.retries,
+            lastConnection: this._lastConnection && new Date(this._lastConnection), // copy so listeners can't mutate our state
+        };
+        // no generation check is needed here: close() and reconnect() bump the
+        // generation and synchronously cancel this timeout, so a superseded
+        // attempt can never fire
+        this.retryTimeout = globalThis.setTimeout(() => {
+            this.retryTimeout = undefined;
+            handleRetryEvent(retryEventDetail);
+        }, retryEventDetail.backoff);
+    }
+    /**
+     * Cancels the scheduled connection-retry, if there is one.
+     */
+    cancelScheduledConnectionRetry() {
+        globalThis.clearTimeout(this.retryTimeout);
+        this.retryTimeout = undefined;
+    }
+    /**
+     * Unhooks the 'abort'-handler that was registered on the AbortSignal of the
+     * given listener-registration, if there is one.
+     *
+     * @param entry the listener-registration to unhook the abort-handler for.
+     */
+    cleanupAbortHandler(entry) {
+        const cleanup = this.abortHandlerCleanups.get(entry);
+        if (cleanup !== undefined) {
+            cleanup();
+            this.abortHandlerCleanups.delete(entry);
+        }
+    }
+}
+exports.Websocket = Websocket;
+//# sourceMappingURL=websocket.js.map

package/dist/cjs/websocket.js.map

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

package/dist/cjs/{src/websocket_buffer.d.ts → websocket_buffer.d.ts}

@@ -1,7 +1,7 @@
 /**
  * A WebsocketBuffer is used to store messages temporarily until they can be sent.
  */
-export interface WebsocketBuffer<E = string | ArrayBufferLike | Blob | ArrayBufferView> {
+export interface WebsocketBuffer<E = string | Blob | BufferSource> {
     /**
      * Adds an element to the buffer.
      * @param element the element to add

package/dist/cjs/websocket_buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket_buffer.d.ts","sourceRoot":"","sources":["../../src/websocket_buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,YAAY;IAC/D;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC;CACvB"}

package/dist/cjs/websocket_buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket_buffer.js","sourceRoot":"","sources":["../../src/websocket_buffer.ts"],"names":[],"mappings":""}

package/dist/{esm/src → cjs}/websocket_builder.d.ts

@@ -1,7 +1,7 @@
-import { Backoff } from "./backoff/backoff";
-import { WebsocketEvent, WebsocketEventListener, WebsocketEventListenerOptions } from "./websocket_event";
-import { UrlProvider, Websocket } from "./websocket";
-import { WebsocketBuffer } from "./websocket_buffer";
+import { Backoff } from "./backoff/backoff.js";
+import { WebsocketEvent, WebsocketEventListener, WebsocketEventListenerOptions } from "./websocket_event.js";
+import { UrlProvider, Websocket } from "./websocket.js";
+import { WebsocketBuffer } from "./websocket_buffer.js";
 /**
  * Builder for websockets.
  */
@@ -34,7 +34,8 @@ export declare class WebsocketBuilder {
      */
     get protocols(): string | string[] | undefined;
     /**
-     * Sets the maximum number of retries before giving up. No limit if undefined.
+     * Sets the maximum number of retries before giving up. No limit if undefined or Infinity.
+     * Must be Infinity or a non-negative integer, otherwise build() will throw.
      *
      * @param maxRetries the maximum number of retries before giving up
      */
@@ -129,6 +130,14 @@ export declare class WebsocketBuilder {
      * @param options the listener options
      */
     onReconnect(listener: WebsocketEventListener<WebsocketEvent.reconnect>, options?: WebsocketEventListenerOptions): WebsocketBuilder;
+    /**
+     * Adds an 'exhausted' event listener to the websocket. Subsequent calls to this method will add additional listeners that will be
+     * called in the order they were added.
+     *
+     * @param listener the listener to add
+     * @param options the listener options
+     */
+    onExhausted(listener: WebsocketEventListener<WebsocketEvent.exhausted>, options?: WebsocketEventListenerOptions): WebsocketBuilder;
     /**
      * Builds the websocket.
      *