react-websocket 4.22.0 → 4.22.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +1 -1
  2. package/dist/ag-ui.cjs +7 -7
  3. package/dist/ag-ui.cjs.map +1 -1
  4. package/dist/ag-ui.d.cts +3 -2
  5. package/dist/ag-ui.js +7 -7
  6. package/dist/ag-ui.js.map +1 -1
  7. package/dist/chaos.cjs +59 -11
  8. package/dist/chaos.cjs.map +1 -1
  9. package/dist/chaos.d.cts +1 -0
  10. package/dist/chaos.d.ts +1 -0
  11. package/dist/chaos.js +59 -11
  12. package/dist/chaos.js.map +1 -1
  13. package/dist/core.cjs +82 -43
  14. package/dist/core.cjs.map +1 -1
  15. package/dist/core.d.cts +4 -3
  16. package/dist/core.d.ts +4 -3
  17. package/dist/core.js +82 -43
  18. package/dist/core.js.map +1 -1
  19. package/dist/index.d.cts +4 -3
  20. package/dist/index.d.ts +3 -2
  21. package/dist/outbox.cjs +14 -8
  22. package/dist/outbox.cjs.map +1 -1
  23. package/dist/outbox.d.cts +1 -1
  24. package/dist/outbox.js +14 -8
  25. package/dist/outbox.js.map +1 -1
  26. package/dist/replay.cjs +12 -7
  27. package/dist/replay.cjs.map +1 -1
  28. package/dist/replay.d.cts +8 -2
  29. package/dist/replay.d.ts +8 -2
  30. package/dist/replay.js +12 -7
  31. package/dist/replay.js.map +1 -1
  32. package/dist/tabs.cjs +11 -14
  33. package/dist/tabs.cjs.map +1 -1
  34. package/dist/tabs.js +11 -14
  35. package/dist/tabs.js.map +1 -1
  36. package/dist/timeline.cjs +3 -1
  37. package/dist/timeline.cjs.map +1 -1
  38. package/dist/timeline.d.cts +3 -3
  39. package/dist/timeline.d.ts +2 -2
  40. package/dist/timeline.js +3 -1
  41. package/dist/timeline.js.map +1 -1
  42. package/dist/{types-paLT8yQF.d.cts → types-Bb3sBG8L.d.cts} +4 -3
  43. package/dist/webtransport.cjs +12 -10
  44. package/dist/webtransport.cjs.map +1 -1
  45. package/dist/webtransport.js +12 -10
  46. package/dist/webtransport.js.map +1 -1
  47. package/package.json +9 -9
@@ -1 +1 @@
1
- {"version":3,"file":"chaos.cjs","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/** A duration in ms, or `[min, max]` for a uniformly random one each time it's used. */\nexport type ChaosRange = number | readonly [min: number, max: number];\n\n/** Faults to inject. All are off by default. Change them on a running class with `configure()`. */\nexport interface ChaosFaults {\n /**\n * Turn the random faults off without forgetting them. The controls (`drop()`, `stall()`,\n * `inject()`) work either way.\n * @default true\n */\n enabled?: boolean;\n /**\n * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every\n * send. Order is preserved, as on a real connection. A round trip takes about twice this.\n * @default 0\n * @example\n * ```ts\n * latency: [50, 400]\n * ```\n */\n latency?: ChaosRange;\n /**\n * Probability (0–1) that a message is lost. A number applies to both directions.\n * @default 0\n * @example\n * ```ts\n * loss: { in: 0.05 } // lose 5% of incoming messages, none of the sends\n * ```\n */\n loss?: number | { in?: number; out?: number };\n /**\n * Probability (0–1) that a connection attempt fails before opening: `error`, then `close`\n * with code `1006`. The server never sees the attempt.\n * @default 0\n */\n refuse?: number;\n /**\n * Each open connection drops after a lifetime in this range, in ms: `error`, then `close` with\n * code `1006`, as when the network goes away.\n * @default false\n * @example\n * ```ts\n * drop: [10_000, 30_000]\n * ```\n */\n drop?: ChaosRange | false;\n /**\n * Each open connection goes silent after a lifetime in this range, in ms, like a socket left\n * half-open by a sleeping laptop: nothing arrives, sends vanish, `readyState` stays `OPEN`, and\n * no `close` event fires. Only a heartbeat timeout (or `close()`) gets out of it.\n * @default false\n */\n stall?: ChaosRange | false;\n /**\n * Probability (0–1) that an incoming message is cut short at a random point. Text also gets a\n * U+FFFD appended, so it never parses as JSON.\n * @default 0\n */\n corrupt?: number;\n}\n\n/** Options for {@link createChaosWebSocket}. */\nexport interface ChaosOptions extends ChaosFaults {\n /**\n * The `WebSocket` implementation to wrap, e.g. a mock in tests or the `ws` package in Node.\n * @default the global `WebSocket`, in browsers only\n */\n WebSocket?: typeof WebSocket;\n /**\n * Seed the random faults, so a run can be repeated. Each connection gets its own sequence, so\n * \"the 3rd connection is refused\" holds however much traffic the others carried.\n * @default unseeded (`Math.random`)\n */\n seed?: number;\n /**\n * Receives a message for every injected fault.\n * @example\n * ```ts\n * logger: console.warn\n * ```\n */\n logger?: (message: string, ...details: unknown[]) => void;\n}\n\n/**\n * Inject faults by hand into every connection made by one chaos class: from a dev panel, a\n * keyboard shortcut, the console or a test.\n */\nexport interface ChaosControls {\n /** Change faults while running, merged into the current ones. Open connections restart their `drop` and `stall` timers. */\n configure(faults: ChaosFaults): void;\n /**\n * Drop every connection now: `error`, then `close` with code `1006`. Pass a code to simulate the\n * server closing instead, e.g. `drop(4001, 'unauthorized')`: a clean close with no `error`.\n */\n drop(code?: number, reason?: string): void;\n /** Make every open connection go silent (see the `stall` option). */\n stall(): void;\n /**\n * Deliver `data` to every open connection as if the server had sent it, after any `latency`.\n * It is never lost or corrupted. Use it to try messages your server doesn't send.\n */\n inject(data: unknown): void;\n}\n\n/** A `WebSocket` class to pass as the `WebSocket` option, with {@link ChaosControls} as static methods. */\nexport type ChaosWebSocket = typeof WebSocket & ChaosControls;\n\ntype Data = Parameters<WebSocket['send']>[0];\ntype Timer = ReturnType<typeof setTimeout>;\n\nconst CONNECTING = 0;\nconst OPEN = 1;\nconst CLOSING = 2;\nconst CLOSED = 3;\n\nfunction mulberry32(seed: number) {\n return () => {\n seed = (seed + 0x6d2b79f5) | 0;\n let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);\n t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n };\n}\n\nfunction pick(range: ChaosRange, random: () => number) {\n return typeof range === 'number' ? range : range[0] + (range[1] - range[0]) * random();\n}\n\nfunction size(data: Data) {\n return new Blob([data as BlobPart]).size;\n}\n\n/** Cut `data` short at a random point. Text also gets U+FFFD, which no JSON document ends with. */\nfunction garble(data: unknown, random: () => number): unknown {\n if (typeof data === 'string') return data.slice(0, Math.floor(random() * data.length)) + '�';\n const binary = data as { slice?: (start: number, end: number) => unknown } & Partial<Blob>;\n if (typeof binary?.slice !== 'function') return '�';\n const length = binary.size ?? (data as ArrayBuffer).byteLength;\n return binary.slice(0, Math.floor(random() * length));\n}\n\nfunction closeEvent(code: number, reason: string, wasClean: boolean): Event {\n const init = { code, reason, wasClean };\n // Node 22 has no CloseEvent.\n return typeof CloseEvent === 'function'\n ? new CloseEvent('close', init)\n : Object.assign(new Event('close'), init);\n}\n\n/**\n * Events delayed in order: each runs in its own task, no earlier than the one before it,\n * because a WebSocket never reorders. With no delay and nothing waiting, it runs right away.\n */\nfunction createQueue() {\n let items: { at: number; run: () => void; data?: Data }[] = [];\n let timer: Timer | undefined;\n function next() {\n const head = items[0];\n if (timer !== undefined || !head) return;\n timer = setTimeout(() => {\n timer = undefined;\n try {\n items.shift()!.run();\n } finally {\n next();\n }\n }, head.at - Date.now());\n }\n return {\n push(delay: number, run: () => void, data?: Data) {\n if (delay <= 0 && !items.length) return run();\n items.push({ at: Math.max(Date.now() + delay, items.at(-1)?.at ?? 0), run, data });\n next();\n },\n clear() {\n items = [];\n clearTimeout(timer);\n timer = undefined;\n },\n bytes: () =>\n items.reduce((sum, item) => sum + (item.data === undefined ? 0 : size(item.data)), 0)\n };\n}\n\n/**\n * Create a `WebSocket` class that injects network faults: latency, lost and corrupt messages,\n * refused, dropped and silently stalled connections. Pass it as the `WebSocket` option in\n * development to see how your app behaves on a bad network.\n *\n * Each call returns a new class with its own faults, controls and random sequence.\n *\n * @example\n * ```ts\n * import { createWebSocket } from 'react-websocket';\n * import { createChaosWebSocket } from 'react-websocket/chaos';\n *\n * export const Chaos = createChaosWebSocket({ latency: [50, 400], drop: [10_000, 30_000] });\n *\n * export const live = createWebSocket('wss://api.example.com/live', {\n * WebSocket: import.meta.env.DEV ? Chaos : undefined\n * });\n *\n * Chaos.stall(); // later, from a dev panel or the console\n * ```\n */\nexport function createChaosWebSocket(options: ChaosOptions = {}): ChaosWebSocket {\n const { WebSocket: wrapped, seed, logger, ...initial } = options;\n const log = logger ?? (() => {});\n let faults: ChaosFaults = initial;\n const live = new Set<ChaosSocket>();\n let count = 0;\n\n const enabled = () => faults.enabled !== false;\n const chance = (probability: number | undefined, random: () => number) =>\n enabled() && !!probability && random() < probability;\n const delay = (random: () => number) =>\n enabled() && faults.latency ? pick(faults.latency, random) : 0;\n const loss = (direction: 'in' | 'out') =>\n typeof faults.loss === 'object' ? faults.loss[direction] : faults.loss;\n // Independent sequences per connection and purpose, so one connection's traffic doesn't shift\n // the faults of the next.\n const stream = (n: number, k: number) =>\n seed === undefined ? Math.random : mulberry32(seed + Math.imul(3 * n + k, 0x9e3779b9));\n\n class ChaosSocket extends EventTarget implements WebSocket {\n static readonly CONNECTING = CONNECTING;\n static readonly OPEN = OPEN;\n static readonly CLOSING = CLOSING;\n static readonly CLOSED = CLOSED;\n readonly CONNECTING = CONNECTING;\n readonly OPEN = OPEN;\n readonly CLOSING = CLOSING;\n readonly CLOSED = CLOSED;\n\n readonly url: string;\n onopen: WebSocket['onopen'] = null;\n onmessage: WebSocket['onmessage'] = null;\n onerror: WebSocket['onerror'] = null;\n onclose: WebSocket['onclose'] = null;\n\n #state: WebSocket['readyState'] = CONNECTING;\n #inner: WebSocket | undefined;\n #binaryType: BinaryType = 'blob';\n #stalled = false;\n // Bytes sent into a stall: they never leave, like data stuck in a dead connection's buffer.\n #unsent = 0;\n #life: () => number;\n #in: () => number;\n #out: () => number;\n #incoming = createQueue();\n #outgoing = createQueue();\n #timers: Timer[] = [];\n\n static configure(next: ChaosFaults) {\n faults = { ...faults, ...next };\n if (!('drop' in next || 'stall' in next || 'enabled' in next)) return;\n for (const socket of [...live]) if (socket.#state === OPEN) socket.#arm();\n }\n\n static drop(code = 1006, reason = '') {\n // A copy: a close listener may connect again, and the new socket must survive.\n for (const socket of [...live]) socket.#drop(code, reason);\n }\n\n static stall() {\n for (const socket of [...live]) socket.#stall();\n }\n\n static inject(data: unknown) {\n for (const socket of [...live]) {\n if (socket.#state === OPEN) socket.#receive(() => socket.#message(data));\n }\n }\n\n constructor(url: string | URL, protocols?: string | string[]) {\n super();\n const Impl = wrapped ?? (typeof window === 'undefined' ? undefined : globalThis.WebSocket);\n if (!Impl) {\n throw new Error('react-websocket/chaos: no WebSocket to wrap here (server render?)');\n }\n for (const type of ['open', 'message', 'error', 'close'] as const) {\n this.addEventListener(type, event =>\n (this[`on${type}`] as ((event: Event) => void) | null)?.call(this, event)\n );\n }\n const n = ++count;\n this.#life = stream(n, 0);\n this.#in = stream(n, 1);\n this.#out = stream(n, 2);\n\n if (chance(faults.refuse, this.#life)) {\n log('chaos: refused', String(url));\n this.url = String(url);\n live.add(this);\n // Never synchronously: the caller attaches its handlers after construction.\n setTimeout(() => this.#end(1006, '', false, true), delay(this.#life));\n return;\n }\n\n const inner = new Impl(url, protocols);\n this.#inner = inner;\n this.url = inner.url;\n live.add(this);\n // Never set back to null: the `ws` package throws an unhandled error without an error handler.\n inner.onopen = () =>\n this.#receive(() => {\n if (this.#state !== CONNECTING) return;\n this.#state = OPEN;\n this.#arm();\n this.dispatchEvent(new Event('open'));\n }, this.#life);\n inner.onmessage = event => {\n if (this.#state === CLOSED || this.#stalled) return;\n if (chance(loss('in'), this.#in)) return log('chaos: lost an incoming message', event.data);\n let data: unknown = event.data;\n if (chance(faults.corrupt, this.#in)) {\n data = garble(data, this.#in);\n log('chaos: corrupted a message', event.data);\n }\n this.#receive(() => this.#message(data));\n };\n inner.onerror = () => this.#receive(() => this.dispatchEvent(new Event('error')));\n inner.onclose = event =>\n this.#receive(() => this.#end(event.code, event.reason, event.wasClean));\n }\n\n get readyState() {\n return this.#state;\n }\n\n get binaryType() {\n return this.#inner?.binaryType ?? this.#binaryType;\n }\n\n set binaryType(value) {\n this.#binaryType = value;\n if (this.#inner) this.#inner.binaryType = value;\n }\n\n get bufferedAmount() {\n return (this.#inner?.bufferedAmount ?? 0) + this.#outgoing.bytes() + this.#unsent;\n }\n\n get protocol() {\n return this.#inner?.protocol ?? '';\n }\n\n get extensions() {\n return this.#inner?.extensions ?? '';\n }\n\n send(data: Data) {\n if (this.#state === CONNECTING) {\n throw new DOMException('WebSocket is still in CONNECTING state', 'InvalidStateError');\n }\n if (this.#state !== OPEN) return;\n if (this.#stalled) {\n this.#unsent += size(data);\n return;\n }\n if (chance(loss('out'), this.#out)) return log('chaos: lost an outgoing message', data);\n const inner = this.#inner!;\n this.#outgoing.push(\n delay(this.#out),\n () => {\n if (inner.readyState === OPEN) inner.send(data);\n },\n data\n );\n }\n\n close(code?: number, reason?: string) {\n if (code !== undefined && code !== 1000 && !(code >= 3000 && code <= 4999)) {\n throw new DOMException(`Invalid close code ${code}`, 'InvalidAccessError');\n }\n if (this.#state >= CLOSING) return;\n const connecting = this.#state === CONNECTING;\n this.#state = CLOSING;\n const inner = this.#inner;\n if (inner && !this.#stalled) {\n // After anything still being sent, like a real close frame.\n this.#outgoing.push(delay(this.#out), () => inner.close(code, reason));\n return;\n }\n // Refused or stalled: the server can't answer, so the close handshake never completes.\n inner?.close(code, reason);\n setTimeout(() => this.#end(1006, '', false, connecting), 0);\n }\n\n /** Queue an event from the server, unless the connection is gone or silent. */\n #receive(run: () => void, random = this.#in) {\n if (this.#state === CLOSED || this.#stalled) return;\n this.#incoming.push(delay(random), () => {\n if (!this.#stalled) run();\n });\n }\n\n #message(data: unknown) {\n // Browsers don't deliver messages after `close()`.\n if (this.#state === OPEN) this.dispatchEvent(new MessageEvent('message', { data }));\n }\n\n /** (Re)start the `drop` and `stall` timers. */\n #arm() {\n for (const timer of this.#timers) clearTimeout(timer);\n this.#timers = [];\n if (!enabled()) return;\n const { drop, stall } = faults;\n if (drop !== undefined && drop !== false) {\n this.#timers.push(setTimeout(() => this.#drop(1006, ''), pick(drop, this.#life)));\n }\n if (stall !== undefined && stall !== false) {\n this.#timers.push(setTimeout(() => this.#stall(), pick(stall, this.#life)));\n }\n }\n\n #drop(code: number, reason: string) {\n log('chaos: dropped', this.url);\n this.#end(code, reason, code !== 1006, code === 1006);\n }\n\n #stall() {\n if (this.#state !== OPEN || this.#stalled) return;\n this.#stalled = true;\n log('chaos: stalled', this.url);\n }\n\n /** The only way to CLOSED, so it happens once. */\n #end(code: number, reason: string, wasClean: boolean, error = false) {\n if (this.#state === CLOSED) return;\n this.#state = CLOSED;\n live.delete(this);\n this.#incoming.clear();\n this.#outgoing.clear();\n for (const timer of this.#timers) clearTimeout(timer);\n // Free the server side of a connection we dropped, and say why in its logs.\n const inner = this.#inner;\n if (inner && inner.readyState < CLOSING) inner.close(4999, 'chaos');\n if (error) this.dispatchEvent(new Event('error'));\n this.dispatchEvent(closeEvent(code, reason, wasClean));\n }\n }\n\n return ChaosSocket;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"chaos.cjs","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/** A duration in ms, or `[min, max]` for a uniformly random one each time it's used. */\nexport type ChaosRange = number | readonly [min: number, max: number];\n\n/** Faults to inject. All are off by default. Change them on a running class with `configure()`. */\nexport interface ChaosFaults {\n /**\n * Turn the random faults off without forgetting them. The controls (`drop()`, `stall()`,\n * `inject()`) work either way.\n * @default true\n */\n enabled?: boolean;\n /**\n * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every\n * send. Order is preserved, as on a real connection. A round trip takes about twice this.\n * Paused while the tab is hidden, where browsers hold timers back by up to a minute.\n * @default 0\n * @example\n * ```ts\n * latency: [50, 400]\n * ```\n */\n latency?: ChaosRange;\n /**\n * Probability (0–1) that a message is lost. A number applies to both directions.\n * @default 0\n * @example\n * ```ts\n * loss: { in: 0.05 } // lose 5% of incoming messages, none of the sends\n * ```\n */\n loss?: number | { in?: number; out?: number };\n /**\n * Probability (0–1) that a connection attempt fails before opening: `error`, then `close`\n * with code `1006`. The server never sees the attempt.\n * @default 0\n */\n refuse?: number;\n /**\n * Each open connection drops after a lifetime in this range, in ms: `error`, then `close` with\n * code `1006`, as when the network goes away.\n * @default false\n * @example\n * ```ts\n * drop: [10_000, 30_000]\n * ```\n */\n drop?: ChaosRange | false;\n /**\n * Each open connection goes silent after a lifetime in this range, in ms, like a socket left\n * half-open by a sleeping laptop: nothing arrives, sends vanish, `readyState` stays `OPEN`, and\n * no `close` event fires. Only a heartbeat timeout (or `close()`) gets out of it.\n * @default false\n */\n stall?: ChaosRange | false;\n /**\n * Probability (0–1) that an incoming message is cut short at a random point. Text also gets a\n * U+FFFD appended, so it never parses as JSON.\n * @default 0\n */\n corrupt?: number;\n}\n\n/** Options for {@link createChaosWebSocket}. */\nexport interface ChaosOptions extends ChaosFaults {\n /**\n * The `WebSocket` implementation to wrap, e.g. a mock in tests or the `ws` package in Node.\n * @default the global `WebSocket`, in browsers only\n */\n WebSocket?: typeof WebSocket;\n /**\n * Seed the random faults, so a run can be repeated. Each connection gets its own sequence, so\n * \"the 3rd connection is refused\" holds however much traffic the others carried.\n * @default unseeded (`Math.random`)\n */\n seed?: number;\n /**\n * Receives a message for every injected fault.\n * @example\n * ```ts\n * logger: console.warn\n * ```\n */\n logger?: (message: string, ...details: unknown[]) => void;\n}\n\n/**\n * Inject faults by hand into every connection made by one chaos class: from a dev panel, a\n * keyboard shortcut, the console or a test.\n */\nexport interface ChaosControls {\n /** Change faults while running, merged into the current ones. Open connections restart their `drop` and `stall` timers. */\n configure(faults: ChaosFaults): void;\n /**\n * Drop every connection now: `error`, then `close` with code `1006`. Pass a code to simulate the\n * server closing instead, e.g. `drop(4001, 'unauthorized')`: a clean close with no `error`.\n */\n drop(code?: number, reason?: string): void;\n /** Make every open connection go silent (see the `stall` option). */\n stall(): void;\n /**\n * Deliver `data` to every open connection as if the server had sent it, after any `latency`.\n * It is never lost or corrupted. Use it to try messages your server doesn't send.\n */\n inject(data: unknown): void;\n}\n\n/** A `WebSocket` class to pass as the `WebSocket` option, with {@link ChaosControls} as static methods. */\nexport type ChaosWebSocket = typeof WebSocket & ChaosControls;\n\ntype Data = Parameters<WebSocket['send']>[0];\ntype Timer = ReturnType<typeof setTimeout>;\n\nconst CONNECTING = 0;\nconst OPEN = 1;\nconst CLOSING = 2;\nconst CLOSED = 3;\n\nfunction mulberry32(seed: number) {\n return () => {\n seed = (seed + 0x6d2b79f5) | 0;\n let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);\n t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n };\n}\n\nfunction pick(range: ChaosRange, random: () => number) {\n return typeof range === 'number' ? range : range[0] + (range[1] - range[0]) * random();\n}\n\nfunction size(data: Data) {\n return new Blob([data as BlobPart]).size;\n}\n\n/** Cut `data` short at a random point. Text also gets U+FFFD, which no JSON document ends with. */\nfunction garble(data: unknown, random: () => number): unknown {\n if (typeof data === 'string') return data.slice(0, Math.floor(random() * data.length)) + '�';\n const binary = data as { slice?: (start: number, end: number) => unknown } & Partial<Blob>;\n if (typeof binary?.slice !== 'function') return '�';\n const length = binary.size ?? (data as ArrayBuffer).byteLength;\n return binary.slice(0, Math.floor(random() * length));\n}\n\nfunction closeEvent(code: number, reason: string, wasClean: boolean): Event {\n const init = { code, reason, wasClean };\n // Node 22 has no CloseEvent.\n return typeof CloseEvent === 'function'\n ? new CloseEvent('close', init)\n : Object.assign(new Event('close'), init);\n}\n\n// Tasks a hidden tab doesn't hold back, as it does timers.\nlet channel: MessageChannel | undefined;\nconst posted: (() => void)[] = [];\nfunction post(run: () => void) {\n if (!channel) {\n channel = new MessageChannel();\n channel.port1.onmessage = () => posted.shift()?.();\n // Node: the port mustn't keep the process alive.\n (channel.port1 as { unref?: () => void }).unref?.();\n }\n posted.push(run);\n channel.port2.postMessage(null);\n}\n\nconst hidden = () =>\n typeof document === 'object' &&\n document.visibilityState === 'hidden' &&\n typeof MessageChannel === 'function';\n\n// Queues waiting on a timer: when the tab is hidden, they go on without it.\nconst timed = new Set<() => void>();\nlet watching = false;\nfunction watch() {\n if (watching || typeof document !== 'object') return;\n watching = true;\n document.addEventListener('visibilitychange', () => {\n if (hidden()) for (const hurry of [...timed]) hurry();\n });\n}\n\n/**\n * Events delayed in order: each runs in its own task, no earlier than the one before it,\n * because a WebSocket never reorders. With no delay and nothing waiting, it runs right away.\n *\n * A hidden tab holds timers back by a second to a minute, so a delay would last that long and\n * a heartbeat would give up. There, events run in order without the delay.\n */\nfunction createQueue() {\n let items: { at: number; run: () => void; data?: Data }[] = [];\n let timer: Timer | undefined;\n // Bumped by `clear()`, so a task already posted does nothing.\n let turn = 0;\n let waiting = false;\n function stopTimer() {\n clearTimeout(timer);\n timer = undefined;\n timed.delete(hurry);\n }\n function run(mine: number) {\n if (mine !== turn) return;\n waiting = false;\n stopTimer();\n try {\n items.shift()!.run();\n } finally {\n next();\n }\n }\n function hurry() {\n stopTimer();\n const mine = turn;\n post(() => run(mine));\n }\n function next() {\n const head = items[0];\n if (waiting || !head) return;\n waiting = true;\n const mine = turn;\n if (hidden()) return post(() => run(mine));\n timer = setTimeout(run, head.at - Date.now(), mine);\n timed.add(hurry);\n watch();\n }\n return {\n push(delay: number, run: () => void, data?: Data) {\n if (delay <= 0 && !items.length) return run();\n items.push({ at: Math.max(Date.now() + delay, items.at(-1)?.at ?? 0), run, data });\n next();\n },\n clear() {\n items = [];\n stopTimer();\n waiting = false;\n turn++;\n },\n bytes: () =>\n items.reduce((sum, item) => sum + (item.data === undefined ? 0 : size(item.data)), 0)\n };\n}\n\n/**\n * Create a `WebSocket` class that injects network faults: latency, lost and corrupt messages,\n * refused, dropped and silently stalled connections. Pass it as the `WebSocket` option in\n * development to see how your app behaves on a bad network.\n *\n * Each call returns a new class with its own faults, controls and random sequence.\n *\n * @example\n * ```ts\n * import { createWebSocket } from 'react-websocket';\n * import { createChaosWebSocket } from 'react-websocket/chaos';\n *\n * export const Chaos = createChaosWebSocket({ latency: [50, 400], drop: [10_000, 30_000] });\n *\n * export const live = createWebSocket('wss://api.example.com/live', {\n * WebSocket: import.meta.env.DEV ? Chaos : undefined\n * });\n *\n * Chaos.stall(); // later, from a dev panel or the console\n * ```\n */\nexport function createChaosWebSocket(options: ChaosOptions = {}): ChaosWebSocket {\n const { WebSocket: wrapped, seed, logger, ...initial } = options;\n const log = logger ?? (() => {});\n let faults: ChaosFaults = initial;\n const live = new Set<ChaosSocket>();\n let count = 0;\n\n const enabled = () => faults.enabled !== false;\n const chance = (probability: number | undefined, random: () => number) =>\n enabled() && !!probability && random() < probability;\n const delay = (random: () => number) =>\n enabled() && faults.latency ? pick(faults.latency, random) : 0;\n const loss = (direction: 'in' | 'out') =>\n typeof faults.loss === 'object' ? faults.loss[direction] : faults.loss;\n // Independent sequences per connection and purpose, so one connection's traffic doesn't shift\n // the faults of the next.\n const stream = (n: number, k: number) =>\n seed === undefined ? Math.random : mulberry32(seed + Math.imul(3 * n + k, 0x9e3779b9));\n\n class ChaosSocket extends EventTarget implements WebSocket {\n static readonly CONNECTING = CONNECTING;\n static readonly OPEN = OPEN;\n static readonly CLOSING = CLOSING;\n static readonly CLOSED = CLOSED;\n readonly CONNECTING = CONNECTING;\n readonly OPEN = OPEN;\n readonly CLOSING = CLOSING;\n readonly CLOSED = CLOSED;\n\n readonly url: string;\n onopen: WebSocket['onopen'] = null;\n onmessage: WebSocket['onmessage'] = null;\n onerror: WebSocket['onerror'] = null;\n onclose: WebSocket['onclose'] = null;\n\n #state: WebSocket['readyState'] = CONNECTING;\n #inner: WebSocket | undefined;\n #binaryType: BinaryType = 'blob';\n #stalled = false;\n // Bytes sent into a stall: they never leave, like data stuck in a dead connection's buffer.\n #unsent = 0;\n #life: () => number;\n #in: () => number;\n #out: () => number;\n #incoming = createQueue();\n #outgoing = createQueue();\n #timers: Timer[] = [];\n\n static configure(next: ChaosFaults) {\n faults = { ...faults, ...next };\n if (!('drop' in next || 'stall' in next || 'enabled' in next)) return;\n for (const socket of [...live]) if (socket.#state === OPEN) socket.#arm();\n }\n\n static drop(code = 1006, reason = '') {\n // A copy: a close listener may connect again, and the new socket must survive.\n for (const socket of [...live]) socket.#drop(code, reason);\n }\n\n static stall() {\n for (const socket of [...live]) socket.#stall();\n }\n\n static inject(data: unknown) {\n for (const socket of [...live]) {\n if (socket.#state === OPEN) socket.#receive(() => socket.#message(data));\n }\n }\n\n constructor(url: string | URL, protocols?: string | string[]) {\n super();\n const Impl = wrapped ?? (typeof window === 'undefined' ? undefined : globalThis.WebSocket);\n if (!Impl) {\n throw new Error('react-websocket/chaos: no WebSocket to wrap here (server render?)');\n }\n for (const type of ['open', 'message', 'error', 'close'] as const) {\n this.addEventListener(type, event =>\n (this[`on${type}`] as ((event: Event) => void) | null)?.call(this, event)\n );\n }\n const n = ++count;\n this.#life = stream(n, 0);\n this.#in = stream(n, 1);\n this.#out = stream(n, 2);\n\n if (chance(faults.refuse, this.#life)) {\n log('chaos: refused', String(url));\n this.url = String(url);\n live.add(this);\n // Never synchronously: the caller attaches its handlers after construction.\n setTimeout(() => this.#end(1006, '', false, true), delay(this.#life));\n return;\n }\n\n const inner = new Impl(url, protocols);\n this.#inner = inner;\n this.url = inner.url;\n live.add(this);\n // Never set back to null: the `ws` package throws an unhandled error without an error handler.\n inner.onopen = () =>\n this.#receive(() => {\n if (this.#state !== CONNECTING) return;\n this.#state = OPEN;\n this.#arm();\n this.dispatchEvent(new Event('open'));\n }, this.#life);\n inner.onmessage = event => {\n if (this.#state === CLOSED || this.#stalled) return;\n if (chance(loss('in'), this.#in)) return log('chaos: lost an incoming message', event.data);\n let data: unknown = event.data;\n if (chance(faults.corrupt, this.#in)) {\n data = garble(data, this.#in);\n log('chaos: corrupted a message', event.data);\n }\n this.#receive(() => this.#message(data));\n };\n inner.onerror = () => this.#receive(() => this.dispatchEvent(new Event('error')));\n inner.onclose = event =>\n this.#receive(() => this.#end(event.code, event.reason, event.wasClean));\n }\n\n get readyState() {\n return this.#state;\n }\n\n get binaryType() {\n return this.#inner?.binaryType ?? this.#binaryType;\n }\n\n set binaryType(value) {\n this.#binaryType = value;\n if (this.#inner) this.#inner.binaryType = value;\n }\n\n get bufferedAmount() {\n return (this.#inner?.bufferedAmount ?? 0) + this.#outgoing.bytes() + this.#unsent;\n }\n\n get protocol() {\n return this.#inner?.protocol ?? '';\n }\n\n get extensions() {\n return this.#inner?.extensions ?? '';\n }\n\n send(data: Data) {\n if (this.#state === CONNECTING) {\n throw new DOMException('WebSocket is still in CONNECTING state', 'InvalidStateError');\n }\n if (this.#state !== OPEN) return;\n if (this.#stalled) {\n this.#unsent += size(data);\n return;\n }\n if (chance(loss('out'), this.#out)) return log('chaos: lost an outgoing message', data);\n const inner = this.#inner!;\n this.#outgoing.push(\n delay(this.#out),\n () => {\n if (inner.readyState === OPEN) inner.send(data);\n },\n data\n );\n }\n\n close(code?: number, reason?: string) {\n if (code !== undefined && code !== 1000 && !(code >= 3000 && code <= 4999)) {\n throw new DOMException(`Invalid close code ${code}`, 'InvalidAccessError');\n }\n // Checked here: the wrapped socket would throw only later, with this one left CLOSING.\n if (new TextEncoder().encode(reason).length > 123) {\n throw new DOMException('Close reason longer than 123 bytes', 'SyntaxError');\n }\n if (this.#state >= CLOSING) return;\n const connecting = this.#state === CONNECTING;\n this.#state = CLOSING;\n const inner = this.#inner;\n if (inner && !this.#stalled) {\n // After anything still being sent, like a real close frame.\n this.#outgoing.push(delay(this.#out), () => inner.close(code, reason));\n return;\n }\n // Refused or stalled: the server can't answer, so the close handshake never completes.\n inner?.close(code, reason);\n setTimeout(() => this.#end(1006, '', false, connecting), 0);\n }\n\n /** Queue an event from the server, unless the connection is gone or silent. */\n #receive(run: () => void, random = this.#in) {\n if (this.#state === CLOSED || this.#stalled) return;\n this.#incoming.push(delay(random), () => {\n if (!this.#stalled) run();\n });\n }\n\n #message(data: unknown) {\n // Browsers don't deliver messages after `close()`.\n if (this.#state === OPEN) this.dispatchEvent(new MessageEvent('message', { data }));\n }\n\n /** (Re)start the `drop` and `stall` timers. */\n #arm() {\n for (const timer of this.#timers) clearTimeout(timer);\n this.#timers = [];\n if (!enabled()) return;\n const { drop, stall } = faults;\n if (drop !== undefined && drop !== false) {\n this.#timers.push(setTimeout(() => this.#drop(1006, ''), pick(drop, this.#life)));\n }\n if (stall !== undefined && stall !== false) {\n this.#timers.push(setTimeout(() => this.#stall(), pick(stall, this.#life)));\n }\n }\n\n #drop(code: number, reason: string) {\n log('chaos: dropped', this.url);\n this.#end(code, reason, code !== 1006, code === 1006);\n }\n\n #stall() {\n if (this.#state !== OPEN || this.#stalled) return;\n this.#stalled = true;\n // Sends still on the way never leave either.\n this.#unsent += this.#outgoing.bytes();\n this.#outgoing.clear();\n log('chaos: stalled', this.url);\n }\n\n /** The only way to CLOSED, so it happens once. */\n #end(code: number, reason: string, wasClean: boolean, error = false) {\n if (this.#state === CLOSED) return;\n this.#state = CLOSED;\n live.delete(this);\n this.#incoming.clear();\n this.#outgoing.clear();\n for (const timer of this.#timers) clearTimeout(timer);\n // Free the server side of a connection we dropped, and say why in its logs.\n const inner = this.#inner;\n if (inner && inner.readyState < CLOSING) inner.close(4999, 'chaos');\n if (error) this.dispatchEvent(new Event('error'));\n this.dispatchEvent(closeEvent(code, reason, wasClean));\n }\n }\n\n return ChaosSocket;\n}\n"],"mappings":"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"}
package/dist/chaos.d.cts CHANGED
@@ -12,6 +12,7 @@ export interface ChaosFaults {
12
12
  /**
13
13
  * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every
14
14
  * send. Order is preserved, as on a real connection. A round trip takes about twice this.
15
+ * Paused while the tab is hidden, where browsers hold timers back by up to a minute.
15
16
  * @default 0
16
17
  * @example
17
18
  * ```ts
package/dist/chaos.d.ts CHANGED
@@ -12,6 +12,7 @@ export interface ChaosFaults {
12
12
  /**
13
13
  * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every
14
14
  * send. Order is preserved, as on a real connection. A round trip takes about twice this.
15
+ * Paused while the tab is hidden, where browsers hold timers back by up to a minute.
15
16
  * @default 0
16
17
  * @example
17
18
  * ```ts
package/dist/chaos.js CHANGED
@@ -33,24 +33,68 @@ function closeEvent(code, reason, wasClean) {
33
33
  };
34
34
  return typeof CloseEvent === "function" ? new CloseEvent("close", init) : Object.assign(new Event("close"), init);
35
35
  }
36
+ let channel;
37
+ const posted = [];
38
+ function post(run) {
39
+ if (!channel) {
40
+ channel = new MessageChannel();
41
+ channel.port1.onmessage = () => posted.shift()?.();
42
+ channel.port1.unref?.();
43
+ }
44
+ posted.push(run);
45
+ channel.port2.postMessage(null);
46
+ }
47
+ const hidden = () => typeof document === "object" && document.visibilityState === "hidden" && typeof MessageChannel === "function";
48
+ const timed = /* @__PURE__ */ new Set();
49
+ let watching = false;
50
+ function watch() {
51
+ if (watching || typeof document !== "object") return;
52
+ watching = true;
53
+ document.addEventListener("visibilitychange", () => {
54
+ if (hidden()) for (const hurry of [...timed]) hurry();
55
+ });
56
+ }
36
57
  /**
37
58
  * Events delayed in order: each runs in its own task, no earlier than the one before it,
38
59
  * because a WebSocket never reorders. With no delay and nothing waiting, it runs right away.
60
+ *
61
+ * A hidden tab holds timers back by a second to a minute, so a delay would last that long and
62
+ * a heartbeat would give up. There, events run in order without the delay.
39
63
  */
40
64
  function createQueue() {
41
65
  let items = [];
42
66
  let timer;
67
+ let turn = 0;
68
+ let waiting = false;
69
+ function stopTimer() {
70
+ clearTimeout(timer);
71
+ timer = void 0;
72
+ timed.delete(hurry);
73
+ }
74
+ function run(mine) {
75
+ if (mine !== turn) return;
76
+ waiting = false;
77
+ stopTimer();
78
+ try {
79
+ items.shift().run();
80
+ } finally {
81
+ next();
82
+ }
83
+ }
84
+ function hurry() {
85
+ stopTimer();
86
+ const mine = turn;
87
+ post(() => run(mine));
88
+ }
43
89
  function next() {
44
90
  const head = items[0];
45
- if (timer !== void 0 || !head) return;
46
- timer = setTimeout(() => {
47
- timer = void 0;
48
- try {
49
- items.shift().run();
50
- } finally {
51
- next();
52
- }
53
- }, head.at - Date.now());
91
+ if (waiting || !head) return;
92
+ waiting = true;
93
+ const mine = turn;
94
+ if (hidden()) return post(() => run(mine));
95
+ timer = setTimeout(run, head.at - Date.now(), mine);
96
+ timed.add(hurry);
97
+ watch();
54
98
  }
55
99
  return {
56
100
  push(delay, run, data) {
@@ -64,8 +108,9 @@ function createQueue() {
64
108
  },
65
109
  clear() {
66
110
  items = [];
67
- clearTimeout(timer);
68
- timer = void 0;
111
+ stopTimer();
112
+ waiting = false;
113
+ turn++;
69
114
  },
70
115
  bytes: () => items.reduce((sum, item) => sum + (item.data === void 0 ? 0 : size(item.data)), 0)
71
116
  };
@@ -222,6 +267,7 @@ function createChaosWebSocket(options = {}) {
222
267
  }
223
268
  close(code, reason) {
224
269
  if (code !== void 0 && code !== 1e3 && !(code >= 3e3 && code <= 4999)) throw new DOMException(`Invalid close code ${code}`, "InvalidAccessError");
270
+ if (new TextEncoder().encode(reason).length > 123) throw new DOMException("Close reason longer than 123 bytes", "SyntaxError");
225
271
  if (this.#state >= CLOSING) return;
226
272
  const connecting = this.#state === CONNECTING;
227
273
  this.#state = CLOSING;
@@ -259,6 +305,8 @@ function createChaosWebSocket(options = {}) {
259
305
  #stall() {
260
306
  if (this.#state !== OPEN || this.#stalled) return;
261
307
  this.#stalled = true;
308
+ this.#unsent += this.#outgoing.bytes();
309
+ this.#outgoing.clear();
262
310
  log("chaos: stalled", this.url);
263
311
  }
264
312
  /** The only way to CLOSED, so it happens once. */
package/dist/chaos.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"chaos.js","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/** A duration in ms, or `[min, max]` for a uniformly random one each time it's used. */\nexport type ChaosRange = number | readonly [min: number, max: number];\n\n/** Faults to inject. All are off by default. Change them on a running class with `configure()`. */\nexport interface ChaosFaults {\n /**\n * Turn the random faults off without forgetting them. The controls (`drop()`, `stall()`,\n * `inject()`) work either way.\n * @default true\n */\n enabled?: boolean;\n /**\n * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every\n * send. Order is preserved, as on a real connection. A round trip takes about twice this.\n * @default 0\n * @example\n * ```ts\n * latency: [50, 400]\n * ```\n */\n latency?: ChaosRange;\n /**\n * Probability (0–1) that a message is lost. A number applies to both directions.\n * @default 0\n * @example\n * ```ts\n * loss: { in: 0.05 } // lose 5% of incoming messages, none of the sends\n * ```\n */\n loss?: number | { in?: number; out?: number };\n /**\n * Probability (0–1) that a connection attempt fails before opening: `error`, then `close`\n * with code `1006`. The server never sees the attempt.\n * @default 0\n */\n refuse?: number;\n /**\n * Each open connection drops after a lifetime in this range, in ms: `error`, then `close` with\n * code `1006`, as when the network goes away.\n * @default false\n * @example\n * ```ts\n * drop: [10_000, 30_000]\n * ```\n */\n drop?: ChaosRange | false;\n /**\n * Each open connection goes silent after a lifetime in this range, in ms, like a socket left\n * half-open by a sleeping laptop: nothing arrives, sends vanish, `readyState` stays `OPEN`, and\n * no `close` event fires. Only a heartbeat timeout (or `close()`) gets out of it.\n * @default false\n */\n stall?: ChaosRange | false;\n /**\n * Probability (0–1) that an incoming message is cut short at a random point. Text also gets a\n * U+FFFD appended, so it never parses as JSON.\n * @default 0\n */\n corrupt?: number;\n}\n\n/** Options for {@link createChaosWebSocket}. */\nexport interface ChaosOptions extends ChaosFaults {\n /**\n * The `WebSocket` implementation to wrap, e.g. a mock in tests or the `ws` package in Node.\n * @default the global `WebSocket`, in browsers only\n */\n WebSocket?: typeof WebSocket;\n /**\n * Seed the random faults, so a run can be repeated. Each connection gets its own sequence, so\n * \"the 3rd connection is refused\" holds however much traffic the others carried.\n * @default unseeded (`Math.random`)\n */\n seed?: number;\n /**\n * Receives a message for every injected fault.\n * @example\n * ```ts\n * logger: console.warn\n * ```\n */\n logger?: (message: string, ...details: unknown[]) => void;\n}\n\n/**\n * Inject faults by hand into every connection made by one chaos class: from a dev panel, a\n * keyboard shortcut, the console or a test.\n */\nexport interface ChaosControls {\n /** Change faults while running, merged into the current ones. Open connections restart their `drop` and `stall` timers. */\n configure(faults: ChaosFaults): void;\n /**\n * Drop every connection now: `error`, then `close` with code `1006`. Pass a code to simulate the\n * server closing instead, e.g. `drop(4001, 'unauthorized')`: a clean close with no `error`.\n */\n drop(code?: number, reason?: string): void;\n /** Make every open connection go silent (see the `stall` option). */\n stall(): void;\n /**\n * Deliver `data` to every open connection as if the server had sent it, after any `latency`.\n * It is never lost or corrupted. Use it to try messages your server doesn't send.\n */\n inject(data: unknown): void;\n}\n\n/** A `WebSocket` class to pass as the `WebSocket` option, with {@link ChaosControls} as static methods. */\nexport type ChaosWebSocket = typeof WebSocket & ChaosControls;\n\ntype Data = Parameters<WebSocket['send']>[0];\ntype Timer = ReturnType<typeof setTimeout>;\n\nconst CONNECTING = 0;\nconst OPEN = 1;\nconst CLOSING = 2;\nconst CLOSED = 3;\n\nfunction mulberry32(seed: number) {\n return () => {\n seed = (seed + 0x6d2b79f5) | 0;\n let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);\n t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n };\n}\n\nfunction pick(range: ChaosRange, random: () => number) {\n return typeof range === 'number' ? range : range[0] + (range[1] - range[0]) * random();\n}\n\nfunction size(data: Data) {\n return new Blob([data as BlobPart]).size;\n}\n\n/** Cut `data` short at a random point. Text also gets U+FFFD, which no JSON document ends with. */\nfunction garble(data: unknown, random: () => number): unknown {\n if (typeof data === 'string') return data.slice(0, Math.floor(random() * data.length)) + '�';\n const binary = data as { slice?: (start: number, end: number) => unknown } & Partial<Blob>;\n if (typeof binary?.slice !== 'function') return '�';\n const length = binary.size ?? (data as ArrayBuffer).byteLength;\n return binary.slice(0, Math.floor(random() * length));\n}\n\nfunction closeEvent(code: number, reason: string, wasClean: boolean): Event {\n const init = { code, reason, wasClean };\n // Node 22 has no CloseEvent.\n return typeof CloseEvent === 'function'\n ? new CloseEvent('close', init)\n : Object.assign(new Event('close'), init);\n}\n\n/**\n * Events delayed in order: each runs in its own task, no earlier than the one before it,\n * because a WebSocket never reorders. With no delay and nothing waiting, it runs right away.\n */\nfunction createQueue() {\n let items: { at: number; run: () => void; data?: Data }[] = [];\n let timer: Timer | undefined;\n function next() {\n const head = items[0];\n if (timer !== undefined || !head) return;\n timer = setTimeout(() => {\n timer = undefined;\n try {\n items.shift()!.run();\n } finally {\n next();\n }\n }, head.at - Date.now());\n }\n return {\n push(delay: number, run: () => void, data?: Data) {\n if (delay <= 0 && !items.length) return run();\n items.push({ at: Math.max(Date.now() + delay, items.at(-1)?.at ?? 0), run, data });\n next();\n },\n clear() {\n items = [];\n clearTimeout(timer);\n timer = undefined;\n },\n bytes: () =>\n items.reduce((sum, item) => sum + (item.data === undefined ? 0 : size(item.data)), 0)\n };\n}\n\n/**\n * Create a `WebSocket` class that injects network faults: latency, lost and corrupt messages,\n * refused, dropped and silently stalled connections. Pass it as the `WebSocket` option in\n * development to see how your app behaves on a bad network.\n *\n * Each call returns a new class with its own faults, controls and random sequence.\n *\n * @example\n * ```ts\n * import { createWebSocket } from 'react-websocket';\n * import { createChaosWebSocket } from 'react-websocket/chaos';\n *\n * export const Chaos = createChaosWebSocket({ latency: [50, 400], drop: [10_000, 30_000] });\n *\n * export const live = createWebSocket('wss://api.example.com/live', {\n * WebSocket: import.meta.env.DEV ? Chaos : undefined\n * });\n *\n * Chaos.stall(); // later, from a dev panel or the console\n * ```\n */\nexport function createChaosWebSocket(options: ChaosOptions = {}): ChaosWebSocket {\n const { WebSocket: wrapped, seed, logger, ...initial } = options;\n const log = logger ?? (() => {});\n let faults: ChaosFaults = initial;\n const live = new Set<ChaosSocket>();\n let count = 0;\n\n const enabled = () => faults.enabled !== false;\n const chance = (probability: number | undefined, random: () => number) =>\n enabled() && !!probability && random() < probability;\n const delay = (random: () => number) =>\n enabled() && faults.latency ? pick(faults.latency, random) : 0;\n const loss = (direction: 'in' | 'out') =>\n typeof faults.loss === 'object' ? faults.loss[direction] : faults.loss;\n // Independent sequences per connection and purpose, so one connection's traffic doesn't shift\n // the faults of the next.\n const stream = (n: number, k: number) =>\n seed === undefined ? Math.random : mulberry32(seed + Math.imul(3 * n + k, 0x9e3779b9));\n\n class ChaosSocket extends EventTarget implements WebSocket {\n static readonly CONNECTING = CONNECTING;\n static readonly OPEN = OPEN;\n static readonly CLOSING = CLOSING;\n static readonly CLOSED = CLOSED;\n readonly CONNECTING = CONNECTING;\n readonly OPEN = OPEN;\n readonly CLOSING = CLOSING;\n readonly CLOSED = CLOSED;\n\n readonly url: string;\n onopen: WebSocket['onopen'] = null;\n onmessage: WebSocket['onmessage'] = null;\n onerror: WebSocket['onerror'] = null;\n onclose: WebSocket['onclose'] = null;\n\n #state: WebSocket['readyState'] = CONNECTING;\n #inner: WebSocket | undefined;\n #binaryType: BinaryType = 'blob';\n #stalled = false;\n // Bytes sent into a stall: they never leave, like data stuck in a dead connection's buffer.\n #unsent = 0;\n #life: () => number;\n #in: () => number;\n #out: () => number;\n #incoming = createQueue();\n #outgoing = createQueue();\n #timers: Timer[] = [];\n\n static configure(next: ChaosFaults) {\n faults = { ...faults, ...next };\n if (!('drop' in next || 'stall' in next || 'enabled' in next)) return;\n for (const socket of [...live]) if (socket.#state === OPEN) socket.#arm();\n }\n\n static drop(code = 1006, reason = '') {\n // A copy: a close listener may connect again, and the new socket must survive.\n for (const socket of [...live]) socket.#drop(code, reason);\n }\n\n static stall() {\n for (const socket of [...live]) socket.#stall();\n }\n\n static inject(data: unknown) {\n for (const socket of [...live]) {\n if (socket.#state === OPEN) socket.#receive(() => socket.#message(data));\n }\n }\n\n constructor(url: string | URL, protocols?: string | string[]) {\n super();\n const Impl = wrapped ?? (typeof window === 'undefined' ? undefined : globalThis.WebSocket);\n if (!Impl) {\n throw new Error('react-websocket/chaos: no WebSocket to wrap here (server render?)');\n }\n for (const type of ['open', 'message', 'error', 'close'] as const) {\n this.addEventListener(type, event =>\n (this[`on${type}`] as ((event: Event) => void) | null)?.call(this, event)\n );\n }\n const n = ++count;\n this.#life = stream(n, 0);\n this.#in = stream(n, 1);\n this.#out = stream(n, 2);\n\n if (chance(faults.refuse, this.#life)) {\n log('chaos: refused', String(url));\n this.url = String(url);\n live.add(this);\n // Never synchronously: the caller attaches its handlers after construction.\n setTimeout(() => this.#end(1006, '', false, true), delay(this.#life));\n return;\n }\n\n const inner = new Impl(url, protocols);\n this.#inner = inner;\n this.url = inner.url;\n live.add(this);\n // Never set back to null: the `ws` package throws an unhandled error without an error handler.\n inner.onopen = () =>\n this.#receive(() => {\n if (this.#state !== CONNECTING) return;\n this.#state = OPEN;\n this.#arm();\n this.dispatchEvent(new Event('open'));\n }, this.#life);\n inner.onmessage = event => {\n if (this.#state === CLOSED || this.#stalled) return;\n if (chance(loss('in'), this.#in)) return log('chaos: lost an incoming message', event.data);\n let data: unknown = event.data;\n if (chance(faults.corrupt, this.#in)) {\n data = garble(data, this.#in);\n log('chaos: corrupted a message', event.data);\n }\n this.#receive(() => this.#message(data));\n };\n inner.onerror = () => this.#receive(() => this.dispatchEvent(new Event('error')));\n inner.onclose = event =>\n this.#receive(() => this.#end(event.code, event.reason, event.wasClean));\n }\n\n get readyState() {\n return this.#state;\n }\n\n get binaryType() {\n return this.#inner?.binaryType ?? this.#binaryType;\n }\n\n set binaryType(value) {\n this.#binaryType = value;\n if (this.#inner) this.#inner.binaryType = value;\n }\n\n get bufferedAmount() {\n return (this.#inner?.bufferedAmount ?? 0) + this.#outgoing.bytes() + this.#unsent;\n }\n\n get protocol() {\n return this.#inner?.protocol ?? '';\n }\n\n get extensions() {\n return this.#inner?.extensions ?? '';\n }\n\n send(data: Data) {\n if (this.#state === CONNECTING) {\n throw new DOMException('WebSocket is still in CONNECTING state', 'InvalidStateError');\n }\n if (this.#state !== OPEN) return;\n if (this.#stalled) {\n this.#unsent += size(data);\n return;\n }\n if (chance(loss('out'), this.#out)) return log('chaos: lost an outgoing message', data);\n const inner = this.#inner!;\n this.#outgoing.push(\n delay(this.#out),\n () => {\n if (inner.readyState === OPEN) inner.send(data);\n },\n data\n );\n }\n\n close(code?: number, reason?: string) {\n if (code !== undefined && code !== 1000 && !(code >= 3000 && code <= 4999)) {\n throw new DOMException(`Invalid close code ${code}`, 'InvalidAccessError');\n }\n if (this.#state >= CLOSING) return;\n const connecting = this.#state === CONNECTING;\n this.#state = CLOSING;\n const inner = this.#inner;\n if (inner && !this.#stalled) {\n // After anything still being sent, like a real close frame.\n this.#outgoing.push(delay(this.#out), () => inner.close(code, reason));\n return;\n }\n // Refused or stalled: the server can't answer, so the close handshake never completes.\n inner?.close(code, reason);\n setTimeout(() => this.#end(1006, '', false, connecting), 0);\n }\n\n /** Queue an event from the server, unless the connection is gone or silent. */\n #receive(run: () => void, random = this.#in) {\n if (this.#state === CLOSED || this.#stalled) return;\n this.#incoming.push(delay(random), () => {\n if (!this.#stalled) run();\n });\n }\n\n #message(data: unknown) {\n // Browsers don't deliver messages after `close()`.\n if (this.#state === OPEN) this.dispatchEvent(new MessageEvent('message', { data }));\n }\n\n /** (Re)start the `drop` and `stall` timers. */\n #arm() {\n for (const timer of this.#timers) clearTimeout(timer);\n this.#timers = [];\n if (!enabled()) return;\n const { drop, stall } = faults;\n if (drop !== undefined && drop !== false) {\n this.#timers.push(setTimeout(() => this.#drop(1006, ''), pick(drop, this.#life)));\n }\n if (stall !== undefined && stall !== false) {\n this.#timers.push(setTimeout(() => this.#stall(), pick(stall, this.#life)));\n }\n }\n\n #drop(code: number, reason: string) {\n log('chaos: dropped', this.url);\n this.#end(code, reason, code !== 1006, code === 1006);\n }\n\n #stall() {\n if (this.#state !== OPEN || this.#stalled) return;\n this.#stalled = true;\n log('chaos: stalled', this.url);\n }\n\n /** The only way to CLOSED, so it happens once. */\n #end(code: number, reason: string, wasClean: boolean, error = false) {\n if (this.#state === CLOSED) return;\n this.#state = CLOSED;\n live.delete(this);\n this.#incoming.clear();\n this.#outgoing.clear();\n for (const timer of this.#timers) clearTimeout(timer);\n // Free the server side of a connection we dropped, and say why in its logs.\n const inner = this.#inner;\n if (inner && inner.readyState < CLOSING) inner.close(4999, 'chaos');\n if (error) this.dispatchEvent(new Event('error'));\n this.dispatchEvent(closeEvent(code, reason, wasClean));\n }\n }\n\n return ChaosSocket;\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"chaos.js","names":[],"sources":["../src/chaos.ts"],"sourcesContent":["/** A duration in ms, or `[min, max]` for a uniformly random one each time it's used. */\nexport type ChaosRange = number | readonly [min: number, max: number];\n\n/** Faults to inject. All are off by default. Change them on a running class with `configure()`. */\nexport interface ChaosFaults {\n /**\n * Turn the random faults off without forgetting them. The controls (`drop()`, `stall()`,\n * `inject()`) work either way.\n * @default true\n */\n enabled?: boolean;\n /**\n * One-way delay in ms, added to the handshake (`open`), to every incoming message and to every\n * send. Order is preserved, as on a real connection. A round trip takes about twice this.\n * Paused while the tab is hidden, where browsers hold timers back by up to a minute.\n * @default 0\n * @example\n * ```ts\n * latency: [50, 400]\n * ```\n */\n latency?: ChaosRange;\n /**\n * Probability (0–1) that a message is lost. A number applies to both directions.\n * @default 0\n * @example\n * ```ts\n * loss: { in: 0.05 } // lose 5% of incoming messages, none of the sends\n * ```\n */\n loss?: number | { in?: number; out?: number };\n /**\n * Probability (0–1) that a connection attempt fails before opening: `error`, then `close`\n * with code `1006`. The server never sees the attempt.\n * @default 0\n */\n refuse?: number;\n /**\n * Each open connection drops after a lifetime in this range, in ms: `error`, then `close` with\n * code `1006`, as when the network goes away.\n * @default false\n * @example\n * ```ts\n * drop: [10_000, 30_000]\n * ```\n */\n drop?: ChaosRange | false;\n /**\n * Each open connection goes silent after a lifetime in this range, in ms, like a socket left\n * half-open by a sleeping laptop: nothing arrives, sends vanish, `readyState` stays `OPEN`, and\n * no `close` event fires. Only a heartbeat timeout (or `close()`) gets out of it.\n * @default false\n */\n stall?: ChaosRange | false;\n /**\n * Probability (0–1) that an incoming message is cut short at a random point. Text also gets a\n * U+FFFD appended, so it never parses as JSON.\n * @default 0\n */\n corrupt?: number;\n}\n\n/** Options for {@link createChaosWebSocket}. */\nexport interface ChaosOptions extends ChaosFaults {\n /**\n * The `WebSocket` implementation to wrap, e.g. a mock in tests or the `ws` package in Node.\n * @default the global `WebSocket`, in browsers only\n */\n WebSocket?: typeof WebSocket;\n /**\n * Seed the random faults, so a run can be repeated. Each connection gets its own sequence, so\n * \"the 3rd connection is refused\" holds however much traffic the others carried.\n * @default unseeded (`Math.random`)\n */\n seed?: number;\n /**\n * Receives a message for every injected fault.\n * @example\n * ```ts\n * logger: console.warn\n * ```\n */\n logger?: (message: string, ...details: unknown[]) => void;\n}\n\n/**\n * Inject faults by hand into every connection made by one chaos class: from a dev panel, a\n * keyboard shortcut, the console or a test.\n */\nexport interface ChaosControls {\n /** Change faults while running, merged into the current ones. Open connections restart their `drop` and `stall` timers. */\n configure(faults: ChaosFaults): void;\n /**\n * Drop every connection now: `error`, then `close` with code `1006`. Pass a code to simulate the\n * server closing instead, e.g. `drop(4001, 'unauthorized')`: a clean close with no `error`.\n */\n drop(code?: number, reason?: string): void;\n /** Make every open connection go silent (see the `stall` option). */\n stall(): void;\n /**\n * Deliver `data` to every open connection as if the server had sent it, after any `latency`.\n * It is never lost or corrupted. Use it to try messages your server doesn't send.\n */\n inject(data: unknown): void;\n}\n\n/** A `WebSocket` class to pass as the `WebSocket` option, with {@link ChaosControls} as static methods. */\nexport type ChaosWebSocket = typeof WebSocket & ChaosControls;\n\ntype Data = Parameters<WebSocket['send']>[0];\ntype Timer = ReturnType<typeof setTimeout>;\n\nconst CONNECTING = 0;\nconst OPEN = 1;\nconst CLOSING = 2;\nconst CLOSED = 3;\n\nfunction mulberry32(seed: number) {\n return () => {\n seed = (seed + 0x6d2b79f5) | 0;\n let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);\n t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n };\n}\n\nfunction pick(range: ChaosRange, random: () => number) {\n return typeof range === 'number' ? range : range[0] + (range[1] - range[0]) * random();\n}\n\nfunction size(data: Data) {\n return new Blob([data as BlobPart]).size;\n}\n\n/** Cut `data` short at a random point. Text also gets U+FFFD, which no JSON document ends with. */\nfunction garble(data: unknown, random: () => number): unknown {\n if (typeof data === 'string') return data.slice(0, Math.floor(random() * data.length)) + '�';\n const binary = data as { slice?: (start: number, end: number) => unknown } & Partial<Blob>;\n if (typeof binary?.slice !== 'function') return '�';\n const length = binary.size ?? (data as ArrayBuffer).byteLength;\n return binary.slice(0, Math.floor(random() * length));\n}\n\nfunction closeEvent(code: number, reason: string, wasClean: boolean): Event {\n const init = { code, reason, wasClean };\n // Node 22 has no CloseEvent.\n return typeof CloseEvent === 'function'\n ? new CloseEvent('close', init)\n : Object.assign(new Event('close'), init);\n}\n\n// Tasks a hidden tab doesn't hold back, as it does timers.\nlet channel: MessageChannel | undefined;\nconst posted: (() => void)[] = [];\nfunction post(run: () => void) {\n if (!channel) {\n channel = new MessageChannel();\n channel.port1.onmessage = () => posted.shift()?.();\n // Node: the port mustn't keep the process alive.\n (channel.port1 as { unref?: () => void }).unref?.();\n }\n posted.push(run);\n channel.port2.postMessage(null);\n}\n\nconst hidden = () =>\n typeof document === 'object' &&\n document.visibilityState === 'hidden' &&\n typeof MessageChannel === 'function';\n\n// Queues waiting on a timer: when the tab is hidden, they go on without it.\nconst timed = new Set<() => void>();\nlet watching = false;\nfunction watch() {\n if (watching || typeof document !== 'object') return;\n watching = true;\n document.addEventListener('visibilitychange', () => {\n if (hidden()) for (const hurry of [...timed]) hurry();\n });\n}\n\n/**\n * Events delayed in order: each runs in its own task, no earlier than the one before it,\n * because a WebSocket never reorders. With no delay and nothing waiting, it runs right away.\n *\n * A hidden tab holds timers back by a second to a minute, so a delay would last that long and\n * a heartbeat would give up. There, events run in order without the delay.\n */\nfunction createQueue() {\n let items: { at: number; run: () => void; data?: Data }[] = [];\n let timer: Timer | undefined;\n // Bumped by `clear()`, so a task already posted does nothing.\n let turn = 0;\n let waiting = false;\n function stopTimer() {\n clearTimeout(timer);\n timer = undefined;\n timed.delete(hurry);\n }\n function run(mine: number) {\n if (mine !== turn) return;\n waiting = false;\n stopTimer();\n try {\n items.shift()!.run();\n } finally {\n next();\n }\n }\n function hurry() {\n stopTimer();\n const mine = turn;\n post(() => run(mine));\n }\n function next() {\n const head = items[0];\n if (waiting || !head) return;\n waiting = true;\n const mine = turn;\n if (hidden()) return post(() => run(mine));\n timer = setTimeout(run, head.at - Date.now(), mine);\n timed.add(hurry);\n watch();\n }\n return {\n push(delay: number, run: () => void, data?: Data) {\n if (delay <= 0 && !items.length) return run();\n items.push({ at: Math.max(Date.now() + delay, items.at(-1)?.at ?? 0), run, data });\n next();\n },\n clear() {\n items = [];\n stopTimer();\n waiting = false;\n turn++;\n },\n bytes: () =>\n items.reduce((sum, item) => sum + (item.data === undefined ? 0 : size(item.data)), 0)\n };\n}\n\n/**\n * Create a `WebSocket` class that injects network faults: latency, lost and corrupt messages,\n * refused, dropped and silently stalled connections. Pass it as the `WebSocket` option in\n * development to see how your app behaves on a bad network.\n *\n * Each call returns a new class with its own faults, controls and random sequence.\n *\n * @example\n * ```ts\n * import { createWebSocket } from 'react-websocket';\n * import { createChaosWebSocket } from 'react-websocket/chaos';\n *\n * export const Chaos = createChaosWebSocket({ latency: [50, 400], drop: [10_000, 30_000] });\n *\n * export const live = createWebSocket('wss://api.example.com/live', {\n * WebSocket: import.meta.env.DEV ? Chaos : undefined\n * });\n *\n * Chaos.stall(); // later, from a dev panel or the console\n * ```\n */\nexport function createChaosWebSocket(options: ChaosOptions = {}): ChaosWebSocket {\n const { WebSocket: wrapped, seed, logger, ...initial } = options;\n const log = logger ?? (() => {});\n let faults: ChaosFaults = initial;\n const live = new Set<ChaosSocket>();\n let count = 0;\n\n const enabled = () => faults.enabled !== false;\n const chance = (probability: number | undefined, random: () => number) =>\n enabled() && !!probability && random() < probability;\n const delay = (random: () => number) =>\n enabled() && faults.latency ? pick(faults.latency, random) : 0;\n const loss = (direction: 'in' | 'out') =>\n typeof faults.loss === 'object' ? faults.loss[direction] : faults.loss;\n // Independent sequences per connection and purpose, so one connection's traffic doesn't shift\n // the faults of the next.\n const stream = (n: number, k: number) =>\n seed === undefined ? Math.random : mulberry32(seed + Math.imul(3 * n + k, 0x9e3779b9));\n\n class ChaosSocket extends EventTarget implements WebSocket {\n static readonly CONNECTING = CONNECTING;\n static readonly OPEN = OPEN;\n static readonly CLOSING = CLOSING;\n static readonly CLOSED = CLOSED;\n readonly CONNECTING = CONNECTING;\n readonly OPEN = OPEN;\n readonly CLOSING = CLOSING;\n readonly CLOSED = CLOSED;\n\n readonly url: string;\n onopen: WebSocket['onopen'] = null;\n onmessage: WebSocket['onmessage'] = null;\n onerror: WebSocket['onerror'] = null;\n onclose: WebSocket['onclose'] = null;\n\n #state: WebSocket['readyState'] = CONNECTING;\n #inner: WebSocket | undefined;\n #binaryType: BinaryType = 'blob';\n #stalled = false;\n // Bytes sent into a stall: they never leave, like data stuck in a dead connection's buffer.\n #unsent = 0;\n #life: () => number;\n #in: () => number;\n #out: () => number;\n #incoming = createQueue();\n #outgoing = createQueue();\n #timers: Timer[] = [];\n\n static configure(next: ChaosFaults) {\n faults = { ...faults, ...next };\n if (!('drop' in next || 'stall' in next || 'enabled' in next)) return;\n for (const socket of [...live]) if (socket.#state === OPEN) socket.#arm();\n }\n\n static drop(code = 1006, reason = '') {\n // A copy: a close listener may connect again, and the new socket must survive.\n for (const socket of [...live]) socket.#drop(code, reason);\n }\n\n static stall() {\n for (const socket of [...live]) socket.#stall();\n }\n\n static inject(data: unknown) {\n for (const socket of [...live]) {\n if (socket.#state === OPEN) socket.#receive(() => socket.#message(data));\n }\n }\n\n constructor(url: string | URL, protocols?: string | string[]) {\n super();\n const Impl = wrapped ?? (typeof window === 'undefined' ? undefined : globalThis.WebSocket);\n if (!Impl) {\n throw new Error('react-websocket/chaos: no WebSocket to wrap here (server render?)');\n }\n for (const type of ['open', 'message', 'error', 'close'] as const) {\n this.addEventListener(type, event =>\n (this[`on${type}`] as ((event: Event) => void) | null)?.call(this, event)\n );\n }\n const n = ++count;\n this.#life = stream(n, 0);\n this.#in = stream(n, 1);\n this.#out = stream(n, 2);\n\n if (chance(faults.refuse, this.#life)) {\n log('chaos: refused', String(url));\n this.url = String(url);\n live.add(this);\n // Never synchronously: the caller attaches its handlers after construction.\n setTimeout(() => this.#end(1006, '', false, true), delay(this.#life));\n return;\n }\n\n const inner = new Impl(url, protocols);\n this.#inner = inner;\n this.url = inner.url;\n live.add(this);\n // Never set back to null: the `ws` package throws an unhandled error without an error handler.\n inner.onopen = () =>\n this.#receive(() => {\n if (this.#state !== CONNECTING) return;\n this.#state = OPEN;\n this.#arm();\n this.dispatchEvent(new Event('open'));\n }, this.#life);\n inner.onmessage = event => {\n if (this.#state === CLOSED || this.#stalled) return;\n if (chance(loss('in'), this.#in)) return log('chaos: lost an incoming message', event.data);\n let data: unknown = event.data;\n if (chance(faults.corrupt, this.#in)) {\n data = garble(data, this.#in);\n log('chaos: corrupted a message', event.data);\n }\n this.#receive(() => this.#message(data));\n };\n inner.onerror = () => this.#receive(() => this.dispatchEvent(new Event('error')));\n inner.onclose = event =>\n this.#receive(() => this.#end(event.code, event.reason, event.wasClean));\n }\n\n get readyState() {\n return this.#state;\n }\n\n get binaryType() {\n return this.#inner?.binaryType ?? this.#binaryType;\n }\n\n set binaryType(value) {\n this.#binaryType = value;\n if (this.#inner) this.#inner.binaryType = value;\n }\n\n get bufferedAmount() {\n return (this.#inner?.bufferedAmount ?? 0) + this.#outgoing.bytes() + this.#unsent;\n }\n\n get protocol() {\n return this.#inner?.protocol ?? '';\n }\n\n get extensions() {\n return this.#inner?.extensions ?? '';\n }\n\n send(data: Data) {\n if (this.#state === CONNECTING) {\n throw new DOMException('WebSocket is still in CONNECTING state', 'InvalidStateError');\n }\n if (this.#state !== OPEN) return;\n if (this.#stalled) {\n this.#unsent += size(data);\n return;\n }\n if (chance(loss('out'), this.#out)) return log('chaos: lost an outgoing message', data);\n const inner = this.#inner!;\n this.#outgoing.push(\n delay(this.#out),\n () => {\n if (inner.readyState === OPEN) inner.send(data);\n },\n data\n );\n }\n\n close(code?: number, reason?: string) {\n if (code !== undefined && code !== 1000 && !(code >= 3000 && code <= 4999)) {\n throw new DOMException(`Invalid close code ${code}`, 'InvalidAccessError');\n }\n // Checked here: the wrapped socket would throw only later, with this one left CLOSING.\n if (new TextEncoder().encode(reason).length > 123) {\n throw new DOMException('Close reason longer than 123 bytes', 'SyntaxError');\n }\n if (this.#state >= CLOSING) return;\n const connecting = this.#state === CONNECTING;\n this.#state = CLOSING;\n const inner = this.#inner;\n if (inner && !this.#stalled) {\n // After anything still being sent, like a real close frame.\n this.#outgoing.push(delay(this.#out), () => inner.close(code, reason));\n return;\n }\n // Refused or stalled: the server can't answer, so the close handshake never completes.\n inner?.close(code, reason);\n setTimeout(() => this.#end(1006, '', false, connecting), 0);\n }\n\n /** Queue an event from the server, unless the connection is gone or silent. */\n #receive(run: () => void, random = this.#in) {\n if (this.#state === CLOSED || this.#stalled) return;\n this.#incoming.push(delay(random), () => {\n if (!this.#stalled) run();\n });\n }\n\n #message(data: unknown) {\n // Browsers don't deliver messages after `close()`.\n if (this.#state === OPEN) this.dispatchEvent(new MessageEvent('message', { data }));\n }\n\n /** (Re)start the `drop` and `stall` timers. */\n #arm() {\n for (const timer of this.#timers) clearTimeout(timer);\n this.#timers = [];\n if (!enabled()) return;\n const { drop, stall } = faults;\n if (drop !== undefined && drop !== false) {\n this.#timers.push(setTimeout(() => this.#drop(1006, ''), pick(drop, this.#life)));\n }\n if (stall !== undefined && stall !== false) {\n this.#timers.push(setTimeout(() => this.#stall(), pick(stall, this.#life)));\n }\n }\n\n #drop(code: number, reason: string) {\n log('chaos: dropped', this.url);\n this.#end(code, reason, code !== 1006, code === 1006);\n }\n\n #stall() {\n if (this.#state !== OPEN || this.#stalled) return;\n this.#stalled = true;\n // Sends still on the way never leave either.\n this.#unsent += this.#outgoing.bytes();\n this.#outgoing.clear();\n log('chaos: stalled', this.url);\n }\n\n /** The only way to CLOSED, so it happens once. */\n #end(code: number, reason: string, wasClean: boolean, error = false) {\n if (this.#state === CLOSED) return;\n this.#state = CLOSED;\n live.delete(this);\n this.#incoming.clear();\n this.#outgoing.clear();\n for (const timer of this.#timers) clearTimeout(timer);\n // Free the server side of a connection we dropped, and say why in its logs.\n const inner = this.#inner;\n if (inner && inner.readyState < CLOSING) inner.close(4999, 'chaos');\n if (error) this.dispatchEvent(new Event('error'));\n this.dispatchEvent(closeEvent(code, reason, wasClean));\n }\n }\n\n return ChaosSocket;\n}\n"],"mappings":"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"}