lemon-model 1.2.1 → 1.2.3

package/dist/esm/progress/progress.js

@@ -0,0 +1,256 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { createFilteredNetwork } from '../socket/websocket.js';
+/** default serialized packet size limit (same family as `src/socket`) */
+export const DEFAULT_MAX_PACKET_BYTES = 64 * 1024;
+/** time-flow gauge - elapsed ratio against expectedMs, capped at 99% (only done() declares completion) */
+export const createTimeProgressGauge = (expectedMs, now = Date.now) => {
+    const startedAt = now();
+    return () => {
+        if (!(expectedMs > 0))
+            return { percent: 99 };
+        const percent = Math.floor(((now() - startedAt) / expectedMs) * 100);
+        return { percent: Math.min(99, Math.max(0, percent)) };
+    };
+};
+/** buffer-fill gauge - reads percent/bufferPercent from a GenAIStreamProgress-compatible source (structural type, no src/buffer dependency) */
+export const createBufferProgressGauge = (source) => {
+    return () => {
+        var _a;
+        const snapshot = source();
+        const percent = (_a = snapshot === null || snapshot === void 0 ? void 0 : snapshot.percent) !== null && _a !== void 0 ? _a : snapshot === null || snapshot === void 0 ? void 0 : snapshot.bufferPercent;
+        return percent === undefined ? {} : { percent };
+    };
+};
+const GAUGE_KEYS = ['percent', 'step', 'totalSteps', 'label'];
+const textEncoder = new TextEncoder();
+const byteLength = (value) => textEncoder.encode(value).length;
+/** assign only defined values so a partial patch never erases fields */
+const assignDefined = (target, patch) => {
+    if (!patch)
+        return;
+    for (const key of Object.keys(patch)) {
+        if (patch[key] !== undefined)
+            target[key] = patch[key];
+    }
+};
+/** create a server-side progress reporter over an injected sink */
+export const createProgressReporter = (sink, options) => {
+    var _a, _b, _c, _d;
+    const type = (_a = options === null || options === void 0 ? void 0 : options.type) !== null && _a !== void 0 ? _a : 'progress:update';
+    const throttleMs = (_b = options === null || options === void 0 ? void 0 : options.throttleMs) !== null && _b !== void 0 ? _b : 0;
+    const heartbeatMs = (_c = options === null || options === void 0 ? void 0 : options.heartbeatMs) !== null && _c !== void 0 ? _c : 0;
+    const maxPacketBytes = (_d = options === null || options === void 0 ? void 0 : options.maxPacketBytes) !== null && _d !== void 0 ? _d : DEFAULT_MAX_PACKET_BYTES;
+    const tasks = new Map();
+    let seq = 0;
+    let mid = 0;
+    const notifyError = (error, state) => { var _a; return (_a = options === null || options === void 0 ? void 0 : options.onError) === null || _a === void 0 ? void 0 : _a.call(options, error, state); };
+    /** the reporter never interrupts task code: sink throw/reject only reaches onError */
+    const dispatch = (message) => {
+        try {
+            const result = sink(message);
+            if (result && typeof result.then === 'function') {
+                result.then(undefined, error => notifyError(error, message.data));
+            }
+        }
+        catch (error) {
+            notifyError(error, message.data);
+        }
+    };
+    const emit = (task) => {
+        task.dirty = false;
+        const snapshot = Object.assign(Object.assign({}, task.local), { ts: Date.now(), seq: ++seq });
+        if (task.gauge) {
+            try {
+                const measure = task.gauge();
+                for (const key of GAUGE_KEYS) {
+                    if (snapshot[key] === undefined && measure[key] !== undefined)
+                        snapshot[key] = measure[key];
+                }
+            }
+            catch (error) {
+                notifyError(error, snapshot);
+            }
+        }
+        let message = { type, data: snapshot, mid: `p${++mid}` };
+        if (snapshot.meta !== undefined && byteLength(JSON.stringify(message)) > maxPacketBytes) {
+            const { meta: _meta } = snapshot, stripped = __rest(snapshot, ["meta"]);
+            message = Object.assign(Object.assign({}, message), { data: stripped });
+            notifyError(new Error(`progress packet exceeds maxPacketBytes:${maxPacketBytes}`), snapshot);
+        }
+        task.last = message.data;
+        dispatch(message);
+    };
+    /** trailing edge: emit the latest snapshot once per window while updates keep arriving */
+    const openWindow = (task) => {
+        task.timer = setTimeout(() => {
+            task.timer = undefined;
+            if (!task.dirty || task.closed)
+                return;
+            emit(task);
+            openWindow(task);
+        }, throttleMs);
+    };
+    const cancelWindow = (task) => {
+        if (!task.timer)
+            return;
+        clearTimeout(task.timer);
+        task.timer = undefined;
+    };
+    const finish = (task, status, patch) => {
+        if (task.closed)
+            return;
+        task.closed = true;
+        cancelWindow(task);
+        assignDefined(task.local, patch);
+        task.local.status = status;
+        emit(task);
+    };
+    const heartbeatTimer = heartbeatMs > 0
+        ? setInterval(() => {
+            tasks.forEach(task => {
+                if (!task.closed && task.local.status === 'running')
+                    emit(task);
+            });
+        }, heartbeatMs)
+        : undefined;
+    return {
+        start: (id, initial, taskOptions) => {
+            const existing = tasks.get(id);
+            if (existing)
+                return existing.handle;
+            const local = { id, status: 'pending', ts: 0, seq: 0 };
+            assignDefined(local, initial);
+            const task = {
+                local,
+                last: local,
+                gauge: taskOptions === null || taskOptions === void 0 ? void 0 : taskOptions.gauge,
+                dirty: false,
+                closed: false,
+                handle: {
+                    id,
+                    get state() {
+                        return task.last;
+                    },
+                    update: patch => {
+                        if (task.closed)
+                            return;
+                        const _a = patch !== null && patch !== void 0 ? patch : {}, { status } = _a, rest = __rest(_a, ["status"]);
+                        if (status && !(status === 'pending' && task.local.status === 'running')) {
+                            task.local.status = status;
+                        }
+                        assignDefined(task.local, rest);
+                        if (throttleMs <= 0)
+                            return emit(task);
+                        if (task.timer) {
+                            task.dirty = true;
+                            return;
+                        }
+                        emit(task);
+                        openWindow(task);
+                    },
+                    done: patch => finish(task, 'done', patch),
+                    error: (error, patch) => {
+                        var _a;
+                        task.local.error = typeof error === 'string' ? error : `${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`;
+                        finish(task, 'error', patch);
+                    },
+                },
+            };
+            tasks.set(id, task);
+            emit(task);
+            return task.handle;
+        },
+        close: () => {
+            if (heartbeatTimer)
+                clearInterval(heartbeatTimer);
+            tasks.forEach(task => {
+                cancelWindow(task);
+                if (task.dirty && !task.closed)
+                    emit(task);
+            });
+        },
+    };
+};
+/** create a client-side progress consumer on a shared network */
+export const createProgressConsumer = (network, options) => {
+    var _a, _b;
+    const typePrefix = (_a = options === null || options === void 0 ? void 0 : options.typePrefix) !== null && _a !== void 0 ? _a : 'progress:';
+    const maxTasks = Math.max(1, (_b = options === null || options === void 0 ? void 0 : options.maxTasks) !== null && _b !== void 0 ? _b : 100);
+    const rawKey = `"type":"${typePrefix}`;
+    /** two-stage filter: raw substring check (no parse) then parsed type re-check */
+    const filtered = createFilteredNetwork(network, raw => raw.includes(rawKey));
+    const store = new Map();
+    const handlers = new Set();
+    const evict = (keepId) => {
+        if (store.size <= maxTasks)
+            return;
+        let evictId;
+        for (const [id, state] of store) {
+            if (id !== keepId && (state.status === 'done' || state.status === 'error')) {
+                evictId = id;
+                break;
+            }
+        }
+        if (evictId === undefined) {
+            for (const id of store.keys()) {
+                if (id !== keepId) {
+                    evictId = id;
+                    break;
+                }
+            }
+        }
+        if (evictId !== undefined)
+            store.delete(evictId);
+    };
+    const unsubscribe = filtered.onMessage(raw => {
+        let message;
+        try {
+            message = JSON.parse(raw);
+        }
+        catch (_a) {
+            return;
+        }
+        if (typeof (message === null || message === void 0 ? void 0 : message.type) !== 'string' || !message.type.startsWith(typePrefix))
+            return;
+        const state = message.data;
+        if (!state || typeof state.id !== 'string' || typeof state.seq !== 'number')
+            return;
+        const existing = store.get(state.id);
+        if (existing && state.seq <= existing.seq)
+            return;
+        store.set(state.id, state);
+        if (!existing)
+            evict(state.id);
+        for (const handler of [...handlers]) {
+            try {
+                handler({ state, created: !existing });
+            }
+            catch (_b) {
+                // a subscriber error must not break other subscribers or the shared network
+            }
+        }
+    });
+    return {
+        get: id => store.get(id),
+        list: () => [...store.values()],
+        onChange: handler => {
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        close: () => {
+            unsubscribe();
+            handlers.clear();
+        },
+    };
+};
+//# sourceMappingURL=progress.js.map

package/dist/esm/progress/progress.js.map

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

package/dist/esm/progress/testing.js

@@ -0,0 +1,98 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+/**
+ * `progress/testing.ts`
+ * - isolated entry for the progress end-to-end loop harness.
+ * - kept OUT of the package root barrel so production bundles do not include the in-memory socket simulator.
+ *
+ * Usage (tests / dev only):
+ *   import { runProgressLoop } from 'lemon-model/progress/testing';
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { createNetwork } from '../socket/socket.js';
+import { createProgressConsumer, createProgressReporter, } from './progress.js';
+/**
+ * Run an end-to-end loop: script -> ProgressReporter -> NetworkSupportable -> ProgressConsumer,
+ * and return numeric metrics for assertion (same pattern as `buffer/testing.runGenAIStreamNetworkLoop`).
+ */
+export const runProgressLoop = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const startedAt = Date.now();
+    const network = createNetwork(Object.assign({}, options.networkOptions));
+    const typePrefix = (_b = (_a = options.consumerOptions) === null || _a === void 0 ? void 0 : _a.typePrefix) !== null && _b !== void 0 ? _b : 'progress:';
+    // Keep wire packets so specs can compare emitted, applied, and stale counts.
+    const rawPackets = [];
+    const unsubscribeRaw = network.onMessage(raw => rawPackets.push(raw));
+    const consumer = createProgressConsumer(network, options.consumerOptions);
+    let applied = 0;
+    const unsubscribeChange = consumer.onChange(() => (applied += 1));
+    let emitted = 0;
+    const reporter = createProgressReporter(message => {
+        emitted += 1;
+        network.send(JSON.stringify(message));
+    }, options.reporterOptions);
+    try {
+        const tasks = new Map();
+        // Reuse task handles by id so each script patch models a real task update.
+        const taskOf = (id) => {
+            const existing = tasks.get(id);
+            if (existing)
+                return existing;
+            const started = reporter.start(id);
+            tasks.set(id, started);
+            return started;
+        };
+        for (const patch of options.script) {
+            const { id, ts: _ts, seq: _seq, status, error } = patch, rest = __rest(patch, ["id", "ts", "seq", "status", "error"]);
+            const task = taskOf(id !== null && id !== void 0 ? id : 'task');
+            if (status === 'done')
+                task.done(rest);
+            else if (status === 'error')
+                task.error(error !== null && error !== void 0 ? error : 'error', rest);
+            else
+                task.update(Object.assign(Object.assign({}, rest), { error, status }));
+        }
+        reporter.close();
+        yield new Promise(resolve => { var _a; return setTimeout(resolve, (_a = options.settleMs) !== null && _a !== void 0 ? _a : 50); });
+        // Only matching progress envelopes can become stale drops on a shared network.
+        const arrived = rawPackets.filter(raw => raw.includes(`"type":"${typePrefix}`)).length;
+        return {
+            elapsedMs: Date.now() - startedAt,
+            packets: rawPackets.length,
+            packetBytes: rawPackets.reduce((sum, raw) => sum + byteLength(raw), 0),
+            maxPacketBytes: rawPackets.reduce((max, raw) => Math.max(max, byteLength(raw)), 0),
+            emitted,
+            applied,
+            staleDropped: arrived - applied,
+            finalStates: consumer.list(),
+        };
+    }
+    finally {
+        unsubscribeRaw();
+        unsubscribeChange();
+        consumer.close();
+        network.close();
+    }
+});
+const textEncoder = new TextEncoder();
+const byteLength = (value) => textEncoder.encode(value).length;
+//# sourceMappingURL=testing.js.map

package/dist/esm/progress/testing.js.map

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

package/dist/esm/socket/websocket.js

@@ -7,6 +7,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+/**
+ * `scope` values these WebSocket adapters put on `SocketErrorContext`.
+ *
+ * Consumers that branch on the scope (e.g. distinguishing a close from a real error) should import
+ * these instead of hardcoding the string, so the contract is compiler-checked across packages.
+ */
+export const WEBSOCKET_NETWORK_SCOPE = {
+    browser: 'browserWebSocket',
+    browserClose: 'browserWebSocket.close',
+    owned: 'ownedWebSocket',
+    ownedClose: 'ownedWebSocket.close',
+};
 /** extract a connection id from known API Gateway/WebSocket handshake response shapes */
 export const extractWebSocketConnectionId = (message) => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -109,13 +121,13 @@ export class BrowserWebSocketNetwork {
             if (this.detached)
                 return;
             for (const handler of [...this.errorHandlers])
-                handler(event, { scope: 'browserWebSocket', network: this });
+                handler(event, { scope: WEBSOCKET_NETWORK_SCOPE.browser, network: this });
         };
         this.handleClose = (event) => {
             if (this.detached)
                 return;
             for (const handler of [...this.errorHandlers])
-                handler(event, { scope: 'browserWebSocket.close', network: this });
+                handler(event, { scope: WEBSOCKET_NETWORK_SCOPE.browserClose, network: this });
         };
         this.opened = this.isOpen()
             ? Promise.resolve()
@@ -204,6 +216,220 @@ export class BrowserWebSocketNetwork {
         this.readyErrorHandler = undefined;
     }
 }
+/**
+ * Adapter that owns the WebSocket it creates.
+ *
+ * Unlike `BrowserWebSocketNetwork`, `close()` performs an actual socket close. The adapter only
+ * handles raw string send/receive, connect timeout, and event mapping; it knows nothing about
+ * message parsing, pending settlement, or routing.
+ */
+export class OwnedWebSocketNetwork {
+    constructor(options) {
+        var _a;
+        this.openHandlers = new Set();
+        this.messageHandlers = new Set();
+        this.errorHandlers = new Set();
+        this.closed = false;
+        this.hasOpened = false;
+        this.handleOpen = () => {
+            if (this.closed || this.hasOpened)
+                return;
+            this.hasOpened = true;
+            for (const handler of [...this.openHandlers])
+                handler();
+            this.openHandlers.clear();
+        };
+        this.handleMessage = (event) => {
+            if (this.closed || typeof event.data !== 'string')
+                return;
+            for (const handler of [...this.messageHandlers])
+                handler(event.data);
+        };
+        this.handleError = (event) => {
+            if (this.closed)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: WEBSOCKET_NETWORK_SCOPE.owned, network: this });
+        };
+        this.handleClose = (event) => {
+            if (this.closed)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: WEBSOCKET_NETWORK_SCOPE.ownedClose, network: this });
+        };
+        this.ws = options.socketFactory
+            ? options.socketFactory({ url: options.url, protocols: options.protocols })
+            : createDefaultWebSocket(options);
+        this.opened = this.buildOpened((_a = options.connectTimeoutMs) !== null && _a !== void 0 ? _a : 15000);
+        /** swallow the orphan rejection for onOpen-only consumers; ready() callers still observe it (same promise) */
+        this.opened.catch(() => undefined);
+        this.ws.addEventListener('open', this.handleOpen);
+        this.ws.addEventListener('message', this.handleMessage);
+        this.ws.addEventListener('error', this.handleError);
+        this.ws.addEventListener('close', this.handleClose);
+    }
+    /** subscribe to the open transition; fires once, immediately if already open */
+    onOpen(handler) {
+        if (this.closed)
+            throw new Error(`@network connection error: closed - ownedWebSocket.onOpen`);
+        if (this.hasOpened || this.isOpen()) {
+            handler();
+            return () => undefined;
+        }
+        this.openHandlers.add(handler);
+        return () => this.openHandlers.delete(handler);
+    }
+    get readyState() {
+        if (this.closed)
+            return 'closed';
+        if (this.isOpen())
+            return 'open';
+        if (this.ws.readyState === stateValue(this.ws, 'CLOSING', 2))
+            return 'closing';
+        if (this.ws.readyState === stateValue(this.ws, 'CLOSED', 3))
+            return 'closed';
+        return 'connecting';
+    }
+    ready() {
+        if (this.closed)
+            return Promise.reject(new Error(`@network connection error: closed - ownedWebSocket.ready`));
+        return this.opened;
+    }
+    send(data) {
+        if (this.closed || !this.isOpen()) {
+            throw new Error(`@network connection error: ${this.readyState} - ownedWebSocket.send`);
+        }
+        this.ws.send(data);
+    }
+    onMessage(handler) {
+        if (this.closed)
+            throw new Error(`@network connection error: closed - ownedWebSocket.onMessage`);
+        this.messageHandlers.add(handler);
+        return () => this.messageHandlers.delete(handler);
+    }
+    configure(_options) {
+        // Owned WebSocket transport options are controlled by the runtime.
+    }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        return () => this.errorHandlers.delete(handler);
+    }
+    close(code, reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.openHandlers.clear();
+        this.messageHandlers.clear();
+        this.errorHandlers.clear();
+        this.ws.removeEventListener('open', this.handleOpen);
+        this.ws.removeEventListener('message', this.handleMessage);
+        this.ws.removeEventListener('error', this.handleError);
+        this.ws.removeEventListener('close', this.handleClose);
+        try {
+            this.ws.close(code, reason);
+        }
+        catch (_a) {
+            // ignore close errors; the adapter is already detached
+        }
+    }
+    buildOpened(timeoutMs) {
+        if (this.isOpen())
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const timer = timeoutMs > 0
+                ? setTimeout(() => {
+                    rejectOnce(new Error(`timeout waiting for WebSocket open: ${timeoutMs}ms`));
+                    this.close();
+                }, timeoutMs)
+                : undefined;
+            const cleanup = () => {
+                if (timer)
+                    clearTimeout(timer);
+                this.ws.removeEventListener('open', onOpen);
+                this.ws.removeEventListener('error', onError);
+                this.ws.removeEventListener('close', onClose);
+            };
+            const resolveOnce = () => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve();
+            };
+            const rejectOnce = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(error);
+            };
+            const onOpen = () => resolveOnce();
+            const onError = (event) => rejectOnce(event);
+            const onClose = () => rejectOnce(new Error(`WebSocket closed before open`));
+            this.ws.addEventListener('open', onOpen, { once: true });
+            this.ws.addEventListener('error', onError, { once: true });
+            this.ws.addEventListener('close', onClose, { once: true });
+        });
+    }
+    isOpen() {
+        return this.ws.readyState === stateValue(this.ws, 'OPEN', 1);
+    }
+}
+/** create an owned WebSocket network adapter */
+export const createOwnedWebSocketNetwork = (options) => new OwnedWebSocketNetwork(options);
+/**
+ * Wrap a `NetworkSupportable` so subscribers only see inbound raw strings accepted by `shouldHandleRaw`.
+ *
+ * Both chatic and proxy share this single boundary mechanism. The predicate only filters inbound
+ * `onMessage`; outbound `send` and every other member delegate to the source unchanged.
+ */
+export const createFilteredNetwork = (source, shouldHandleRaw) => new FilteredNetwork(source, shouldHandleRaw);
+/** `NetworkSupportable` decorator that filters inbound raw strings by ownership predicate */
+class FilteredNetwork {
+    constructor(source, shouldHandleRaw) {
+        this.source = source;
+        this.shouldHandleRaw = shouldHandleRaw;
+    }
+    get readyState() {
+        return this.source.readyState;
+    }
+    ready() {
+        var _a, _b, _c;
+        return (_c = (_b = (_a = this.source).ready) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : Promise.resolve();
+    }
+    onOpen(handler) {
+        var _a, _b, _c;
+        return (_c = (_b = (_a = this.source).onOpen) === null || _b === void 0 ? void 0 : _b.call(_a, handler)) !== null && _c !== void 0 ? _c : (() => undefined);
+    }
+    send(data) {
+        this.source.send(data);
+    }
+    onMessage(handler) {
+        return this.source.onMessage(raw => {
+            if (!this.shouldHandleRaw(raw))
+                return;
+            handler(raw);
+        });
+    }
+    configure(options) {
+        var _a, _b;
+        (_b = (_a = this.source).configure) === null || _b === void 0 ? void 0 : _b.call(_a, options);
+    }
+    onError(handler) {
+        return this.source.onError(handler);
+    }
+    close(code, reason) {
+        this.source.close(code, reason);
+    }
+}
+const createDefaultWebSocket = (options) => {
+    const WS = globalThis.WebSocket;
+    if (typeof WS !== 'function') {
+        throw new Error(`global WebSocket is not available; provide options.socketFactory`);
+    }
+    return new WS(options.url, options.protocols);
+};
 const waitWebSocketOpen = (ws, timeoutMs) => {
     if (ws.readyState === stateValue(ws, 'OPEN', 1))
         return Promise.resolve();