tempest-react-sdk 0.52.0 → 0.54.0

package/dist/webrtc/opus-sdp.js

@@ -0,0 +1,94 @@
+//#region src/webrtc/opus-sdp.ts
+var e = /* @__PURE__ */ new Set([
+	"maxAverageBitrate",
+	"maxPlaybackRate",
+	"stereo",
+	"fec",
+	"dtx",
+	"cbr",
+	"extra"
+]);
+function t(t) {
+	let n = Object.keys(t);
+	return n.length === 0 || n.some((t) => e.has(t));
+}
+function n(e) {
+	let t = {};
+	return e.maxAverageBitrate !== void 0 && (t.maxaveragebitrate = String(e.maxAverageBitrate)), e.maxPlaybackRate !== void 0 && (t.maxplaybackrate = String(e.maxPlaybackRate)), e.stereo !== void 0 && (t.stereo = e.stereo ? "1" : "0", t["sprop-stereo"] = e.stereo ? "1" : "0"), e.fec !== void 0 && (t.useinbandfec = e.fec ? "1" : "0"), e.dtx !== void 0 && (t.usedtx = e.dtx ? "1" : "0"), e.cbr !== void 0 && (t.cbr = e.cbr ? "1" : "0"), {
+		...t,
+		...e.extra
+	};
+}
+function r(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	for (let t of e.split(";")) {
+		let e = t.trim();
+		if (!e) continue;
+		let r = e.indexOf("=");
+		r < 0 ? n.set(e, "") : n.set(e.slice(0, r), e.slice(r + 1));
+	}
+	for (let [e, r] of Object.entries(t)) n.set(e, r);
+	return [...n.entries()].map(([e, t]) => t === "" ? e : `${e}=${t}`).join(";");
+}
+function i(e) {
+	let t = [];
+	for (let n of e) {
+		let e = /^a=rtpmap:(\d+)\s+opus\/48000/i.exec(n);
+		e && t.push(e[1]);
+	}
+	return t;
+}
+function a(e) {
+	for (let t of e) {
+		let e = /^a=mid:(.+)$/.exec(t);
+		if (e) return e[1].trim();
+	}
+	return null;
+}
+function o(e, t) {
+	let a = n(t), o = i(e);
+	if (o.length === 0 || Object.keys(a).length === 0) return [...e];
+	let s = [];
+	for (let t of e) {
+		let n = /^a=fmtp:(\d+)\s+(.*)$/.exec(t);
+		if (n && o.includes(n[1])) {
+			s.push(`a=fmtp:${n[1]} ${r(n[2], a)}`);
+			continue;
+		}
+		s.push(t);
+		let i = /^a=rtpmap:(\d+)\s+opus\/48000/i.exec(t);
+		i && !e.some((e) => e.startsWith(`a=fmtp:${i[1]} `)) && s.push(`a=fmtp:${i[1]} ${r("", a)}`);
+	}
+	return s;
+}
+function s(e) {
+	let t = [], n = [];
+	for (let r of e.split(/\r\n|\n/)) r.startsWith("m=") && n.length > 0 && (t.push(n), n = []), n.push(r);
+	return n.length > 0 && t.push(n), t;
+}
+function c(e, n) {
+	let r = t(n) ? n : null, i = r ? null : n, c = 0;
+	return s(e).map((e) => {
+		if (!e[0]?.startsWith("m=audio")) return e;
+		let t = c;
+		if (c += 1, r) return o(e, r);
+		let n = a(e), s = i?.[t] ?? (n === null ? void 0 : i?.[n]);
+		return s ? o(e, s) : e;
+	}).flat().join("\r\n");
+}
+async function l(e, t, n) {
+	if (t.sdp) {
+		let r = c(t.sdp, n);
+		if (r !== t.sdp) try {
+			return await e.setLocalDescription({
+				...t,
+				sdp: r
+			}), "tuned";
+		} catch {}
+	}
+	return await e.setLocalDescription(t), "original";
+}
+//#endregion
+export { l as setTunedLocalDescription, c as tuneOpus };
+
+//# sourceMappingURL=opus-sdp.js.map

package/dist/webrtc/opus-sdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opus-sdp.js","names":[],"sources":["../../src/webrtc/opus-sdp.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — parsing a session description, merging one\n * `fmtp` line and inserting a missing one are the same pass over the same\n * grammar; split apart, each half is a parser of half an SDP.\n */\n\n/** What an Opus `fmtp` line can be asked to carry. Every field is optional. */\nexport interface OpusProfile {\n    /**\n     * Ceiling the encoder is asked to respect, in bits per second.\n     *\n     * This describes what we want **to receive**. To cap what we *send*, use\n     * `setSenderBitrate` — in a mesh that is the one that matters, because the\n     * uplink carries one copy per participant.\n     */\n    maxAverageBitrate?: number;\n    /** Highest sample rate worth decoding, in Hz. `48000` for full band. */\n    maxPlaybackRate?: number;\n    /**\n     * Two channels instead of one.\n     *\n     * Sets `stereo` **and** `sprop-stereo`, which point in opposite directions:\n     * `stereo=1` asks the *remote* to send two channels, `sprop-stereo=1`\n     * announces that *we* will. Setting only one leaves the link asymmetric,\n     * which is the recurring reason \"I asked for stereo and got mono\".\n     */\n    stereo?: boolean;\n    /**\n     * In-band forward error correction (`useinbandfec`).\n     *\n     * Rebuilds a lost packet from the next one, which keeps speech intelligible\n     * on a lossy link — and smears music, since it spends bitrate on redundancy\n     * instead of detail.\n     */\n    fec?: boolean;\n    /**\n     * Discontinuous transmission (`usedtx`): stop sending during silence.\n     *\n     * Saves uplink in a mesh, at the cost of clipping the first instant after a\n     * pause. Wrong for music and for a shared screen, where the quiet passages\n     * are content.\n     */\n    dtx?: boolean;\n    /** Constant bitrate (`cbr`). Off by default, as Opus intends. */\n    cbr?: boolean;\n    /**\n     * Any other `fmtp` key, merged verbatim.\n     *\n     * The escape hatch for a parameter this type does not model. Values are\n     * written as given; a key with an empty string is emitted as a bare flag.\n     */\n    extra?: Record<string, string>;\n}\n\n/**\n * Profiles to apply, keyed by audio m-line index (`0`, `1`, …) or by `mid`.\n *\n * Position and `mid` can be mixed in one object. A key that matches nothing is\n * ignored rather than an error — an SDP is negotiated, and a slot that was not\n * offered this time is normal.\n */\nexport type OpusProfileMap = Record<string | number, OpusProfile>;\n\n/** Keys that identify a bare {@link OpusProfile} rather than a map of them. */\nconst PROFILE_KEYS: ReadonlySet<string> = new Set([\n    \"maxAverageBitrate\",\n    \"maxPlaybackRate\",\n    \"stereo\",\n    \"fec\",\n    \"dtx\",\n    \"cbr\",\n    \"extra\",\n]);\n\n/**\n * Whether the caller passed one profile for every audio m-line, or a map.\n *\n * An empty object is read as a profile, which makes `tuneOpus(sdp, {})` a no-op\n * instead of a silent surprise.\n */\nfunction isSingleProfile(value: OpusProfile | OpusProfileMap): value is OpusProfile {\n    const keys = Object.keys(value);\n    return keys.length === 0 || keys.some((key) => PROFILE_KEYS.has(key));\n}\n\n/** The `fmtp` parameters a profile asks for, in the order Opus documents them. */\nfunction fmtpParams(profile: OpusProfile): Record<string, string> {\n    const params: Record<string, string> = {};\n    if (profile.maxAverageBitrate !== undefined) {\n        params.maxaveragebitrate = String(profile.maxAverageBitrate);\n    }\n    if (profile.maxPlaybackRate !== undefined) {\n        params.maxplaybackrate = String(profile.maxPlaybackRate);\n    }\n    if (profile.stereo !== undefined) {\n        params.stereo = profile.stereo ? \"1\" : \"0\";\n        params[\"sprop-stereo\"] = profile.stereo ? \"1\" : \"0\";\n    }\n    if (profile.fec !== undefined) params.useinbandfec = profile.fec ? \"1\" : \"0\";\n    if (profile.dtx !== undefined) params.usedtx = profile.dtx ? \"1\" : \"0\";\n    if (profile.cbr !== undefined) params.cbr = profile.cbr ? \"1\" : \"0\";\n    return { ...params, ...profile.extra };\n}\n\n/**\n * Merge parameters into an existing `fmtp` payload, key by key.\n *\n * Replacing the whole line is the obvious move and it is wrong: the browser\n * emits `minptime=10;useinbandfec=1` on its own, and overwriting drops the\n * `minptime` — a packetization decision nobody meant to change.\n */\nfunction mergeFmtp(existing: string, params: Record<string, string>): string {\n    const merged = new Map<string, string>();\n    for (const entry of existing.split(\";\")) {\n        const trimmed = entry.trim();\n        if (!trimmed) continue;\n        const eq = trimmed.indexOf(\"=\");\n        if (eq < 0) merged.set(trimmed, \"\");\n        else merged.set(trimmed.slice(0, eq), trimmed.slice(eq + 1));\n    }\n    for (const [key, value] of Object.entries(params)) merged.set(key, value);\n    return [...merged.entries()]\n        .map(([key, value]) => (value === \"\" ? key : `${key}=${value}`))\n        .join(\";\");\n}\n\n/** Payload types this media block maps to Opus. There can be more than one. */\nfunction opusPayloads(block: readonly string[]): string[] {\n    const payloads: string[] = [];\n    for (const line of block) {\n        const match = /^a=rtpmap:(\\d+)\\s+opus\\/48000/i.exec(line);\n        if (match) payloads.push(match[1]);\n    }\n    return payloads;\n}\n\n/** The block's `mid`, when it declares one. */\nfunction blockMid(block: readonly string[]): string | null {\n    for (const line of block) {\n        const match = /^a=mid:(.+)$/.exec(line);\n        if (match) return match[1].trim();\n    }\n    return null;\n}\n\n/**\n * Rewrite one media block's Opus `fmtp` lines to carry a profile.\n *\n * A payload type with no `fmtp` of its own gets one inserted right after its\n * `rtpmap`, because \"the parameter is missing\" and \"the parameter is empty\" are\n * the same request from the caller's side.\n */\nfunction tuneBlock(block: readonly string[], profile: OpusProfile): string[] {\n    const params = fmtpParams(profile);\n    const payloads = opusPayloads(block);\n    if (payloads.length === 0 || Object.keys(params).length === 0) return [...block];\n\n    const out: string[] = [];\n    for (const line of block) {\n        const fmtp = /^a=fmtp:(\\d+)\\s+(.*)$/.exec(line);\n        if (fmtp && payloads.includes(fmtp[1])) {\n            out.push(`a=fmtp:${fmtp[1]} ${mergeFmtp(fmtp[2], params)}`);\n            continue;\n        }\n        out.push(line);\n\n        const rtpmap = /^a=rtpmap:(\\d+)\\s+opus\\/48000/i.exec(line);\n        if (rtpmap && !block.some((other) => other.startsWith(`a=fmtp:${rtpmap[1]} `))) {\n            out.push(`a=fmtp:${rtpmap[1]} ${mergeFmtp(\"\", params)}`);\n        }\n    }\n    return out;\n}\n\n/** Split a session description into its session part plus one block per m-line. */\nfunction mediaBlocks(sdp: string): string[][] {\n    const blocks: string[][] = [];\n    let current: string[] = [];\n    for (const line of sdp.split(/\\r\\n|\\n/)) {\n        if (line.startsWith(\"m=\") && current.length > 0) {\n            blocks.push(current);\n            current = [];\n        }\n        current.push(line);\n    }\n    if (current.length > 0) blocks.push(current);\n    return blocks;\n}\n\n/**\n * Apply Opus profiles to the audio m-lines of a session description.\n *\n * Audio over WebRTC is mono and narrow by default, and the only place that is\n * corrected is the SDP — which is why shared-screen audio famously sounds like a\n * telephone: music and video inherit the speech profile (mono, ~32 kbps, FEC on,\n * DTX gating the quiet passages) and no high-level API lets you change it.\n *\n * Deliberately **without** built-in presets: which values to use is the\n * consumer's call — voice in a mesh does not want what system audio wants — and\n * a preset table is the kind of thing that has no business inside a dependency.\n * What lives here is the parsing, merging and insertion, which is where the long\n * tail is. Getting any of it wrong degrades silently: nobody sees an exception,\n * the audio is just worse.\n *\n * @param sdp - The description from `createOffer` or `createAnswer`.\n * @param profiles - One {@link OpusProfile} for every audio m-line, or an\n *   {@link OpusProfileMap} keyed by audio m-line index or by `mid`.\n * @returns The rewritten SDP, with CRLF line endings as RFC 4566 requires.\n *   Untouched when there is no Opus, when no profile matches, or when a profile\n *   asks for nothing.\n *\n * @example\n * const tuned = tuneOpus(offer.sdp, {\n *   0: { maxAverageBitrate: 48_000, stereo: false, fec: true, dtx: true },\n *   1: { maxAverageBitrate: 192_000, stereo: true, fec: false, dtx: false },\n * });\n *\n * @example\n * const tuned = tuneOpus(offer.sdp, { stereo: true, dtx: false });\n */\nexport function tuneOpus(sdp: string, profiles: OpusProfile | OpusProfileMap): string {\n    const single = isSingleProfile(profiles) ? profiles : null;\n    const map = single ? null : (profiles as OpusProfileMap);\n\n    let audioIndex = 0;\n    const tuned = mediaBlocks(sdp).map((block) => {\n        if (!block[0]?.startsWith(\"m=audio\")) return block;\n\n        const index = audioIndex;\n        audioIndex += 1;\n        if (single) return tuneBlock(block, single);\n\n        const mid = blockMid(block);\n        const profile = map?.[index] ?? (mid !== null ? map?.[mid] : undefined);\n        return profile ? tuneBlock(block, profile) : block;\n    });\n\n    return tuned.flat().join(\"\\r\\n\");\n}\n\n/** Which description a peer connection actually accepted. */\nexport type TunedDescriptionResult = \"tuned\" | \"original\";\n\n/**\n * Set a local description, falling back to the untouched one if it is refused.\n *\n * Chrome has been tightening what `setLocalDescription` accepts from edited SDP,\n * and there is no way to know in advance. Without a fallback the call dies\n * instead of merely losing the profile — which is the wrong trade by a wide\n * margin: worse audio beats no audio.\n *\n * @param connection - The peer connection.\n * @param description - The description from `createOffer` / `createAnswer`.\n * @param profiles - Passed straight to {@link tuneOpus}.\n * @returns `\"tuned\"` when the rewritten SDP was accepted, `\"original\"` when the\n *   fallback was used — worth reporting, because it means the profile silently\n *   did not apply.\n * @throws Whatever `setLocalDescription` throws for the original description: at\n *   that point the failure is not about the rewrite and the caller has to know.\n *\n * @example\n * const applied = await setTunedLocalDescription(pc, await pc.createOffer(), profiles);\n * if (applied === \"original\") logger.warn(\"opus profile refused by the browser\");\n */\nexport async function setTunedLocalDescription(\n    connection: RTCPeerConnection,\n    description: RTCSessionDescriptionInit,\n    profiles: OpusProfile | OpusProfileMap,\n): Promise<TunedDescriptionResult> {\n    if (description.sdp) {\n        const sdp = tuneOpus(description.sdp, profiles);\n        if (sdp !== description.sdp) {\n            try {\n                await connection.setLocalDescription({ ...description, sdp });\n                return \"tuned\";\n            } catch {\n                /* the browser refused the edit; the untouched offer still works */\n            }\n        }\n    }\n    await connection.setLocalDescription(description);\n    return \"original\";\n}\n"],"mappings":"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"}

package/dist/webrtc/sender-bitrate.cjs

@@ -0,0 +1,2 @@
+async function e(e,t){try{let n=e.getParameters();(!n.encodings||n.encodings.length===0)&&(n.encodings=[{}]);for(let e of n.encodings)t===null?delete e.maxBitrate:e.maxBitrate=t;return await e.setParameters(n),!0}catch{return!1}}exports.setSenderBitrate=e;
+//# sourceMappingURL=sender-bitrate.cjs.map

package/dist/webrtc/sender-bitrate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-bitrate.cjs","names":[],"sources":["../../src/webrtc/sender-bitrate.ts"],"sourcesContent":["/**\n * Cap what one sender transmits, in bits per second.\n *\n * This is the other half of the pair that confuses people: an Opus `fmtp` line\n * describes what we want **to receive**, while this is what limits what we\n * **send**. Both are needed, and in a mesh topology this one matters more,\n * because the uplink carries one copy of the stream per participant.\n *\n * The read-modify-write is not ceremony. `setParameters` only accepts the very\n * object `getParameters` handed back — a freshly built one is rejected — and a\n * sender that has not negotiated yet reports **no** encodings at all, so writing\n * to `encodings[0]` without checking throws on exactly the call that sets the\n * cap before the first offer.\n *\n * @param sender - The `RTCRtpSender` to cap, from `pc.getSenders()` or\n *   `transceiver.sender`.\n * @param maxBitrate - Ceiling in bits per second, or `null` to lift the cap.\n * @returns `false` when the browser refused the change, which happens when the\n *   sender has no track or the transceiver is gone. Playback continues\n *   uncapped — a call that keeps running beats one that throws over a bitrate.\n *\n * @example\n * const sender = pc.getSenders().find((s) => s.track?.kind === \"audio\");\n * if (sender) await setSenderBitrate(sender, 48_000);\n */\nexport async function setSenderBitrate(\n    sender: RTCRtpSender,\n    maxBitrate: number | null,\n): Promise<boolean> {\n    try {\n        const parameters = sender.getParameters();\n        if (!parameters.encodings || parameters.encodings.length === 0) {\n            parameters.encodings = [{}];\n        }\n        for (const encoding of parameters.encodings) {\n            if (maxBitrate === null) delete encoding.maxBitrate;\n            else encoding.maxBitrate = maxBitrate;\n        }\n        await sender.setParameters(parameters);\n        return true;\n    } catch {\n        return false;\n    }\n}\n"],"mappings":"AAyBA,eAAsB,EAClB,EACA,EACgB,CAChB,GAAI,CACA,IAAM,EAAa,EAAO,cAAc,GACpC,CAAC,EAAW,WAAa,EAAW,UAAU,SAAW,KACzD,EAAW,UAAY,CAAC,CAAC,CAAC,GAE9B,IAAK,IAAM,KAAY,EAAW,UAC1B,IAAe,KAAM,OAAO,EAAS,WACpC,EAAS,WAAa,EAG/B,OADA,MAAM,EAAO,cAAc,CAAU,EAC9B,EACX,MAAQ,CACJ,MAAO,EACX,CACJ"}

package/dist/webrtc/sender-bitrate.js

@@ -0,0 +1,15 @@
+//#region src/webrtc/sender-bitrate.ts
+async function e(e, t) {
+	try {
+		let n = e.getParameters();
+		(!n.encodings || n.encodings.length === 0) && (n.encodings = [{}]);
+		for (let e of n.encodings) t === null ? delete e.maxBitrate : e.maxBitrate = t;
+		return await e.setParameters(n), !0;
+	} catch {
+		return !1;
+	}
+}
+//#endregion
+export { e as setSenderBitrate };
+
+//# sourceMappingURL=sender-bitrate.js.map

package/dist/webrtc/sender-bitrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-bitrate.js","names":[],"sources":["../../src/webrtc/sender-bitrate.ts"],"sourcesContent":["/**\n * Cap what one sender transmits, in bits per second.\n *\n * This is the other half of the pair that confuses people: an Opus `fmtp` line\n * describes what we want **to receive**, while this is what limits what we\n * **send**. Both are needed, and in a mesh topology this one matters more,\n * because the uplink carries one copy of the stream per participant.\n *\n * The read-modify-write is not ceremony. `setParameters` only accepts the very\n * object `getParameters` handed back — a freshly built one is rejected — and a\n * sender that has not negotiated yet reports **no** encodings at all, so writing\n * to `encodings[0]` without checking throws on exactly the call that sets the\n * cap before the first offer.\n *\n * @param sender - The `RTCRtpSender` to cap, from `pc.getSenders()` or\n *   `transceiver.sender`.\n * @param maxBitrate - Ceiling in bits per second, or `null` to lift the cap.\n * @returns `false` when the browser refused the change, which happens when the\n *   sender has no track or the transceiver is gone. Playback continues\n *   uncapped — a call that keeps running beats one that throws over a bitrate.\n *\n * @example\n * const sender = pc.getSenders().find((s) => s.track?.kind === \"audio\");\n * if (sender) await setSenderBitrate(sender, 48_000);\n */\nexport async function setSenderBitrate(\n    sender: RTCRtpSender,\n    maxBitrate: number | null,\n): Promise<boolean> {\n    try {\n        const parameters = sender.getParameters();\n        if (!parameters.encodings || parameters.encodings.length === 0) {\n            parameters.encodings = [{}];\n        }\n        for (const encoding of parameters.encodings) {\n            if (maxBitrate === null) delete encoding.maxBitrate;\n            else encoding.maxBitrate = maxBitrate;\n        }\n        await sender.setParameters(parameters);\n        return true;\n    } catch {\n        return false;\n    }\n}\n"],"mappings":";AAyBA,eAAsB,EAClB,GACA,GACgB;CAChB,IAAI;EACA,IAAM,IAAa,EAAO,cAAc;EACxC,CAAI,CAAC,EAAW,aAAa,EAAW,UAAU,WAAW,OACzD,EAAW,YAAY,CAAC,CAAC,CAAC;EAE9B,KAAK,IAAM,KAAY,EAAW,WAC9B,AAAI,MAAe,OAAM,OAAO,EAAS,aACpC,EAAS,aAAa;EAG/B,OADA,MAAM,EAAO,cAAc,CAAU,GAC9B;CACX,QAAQ;EACJ,OAAO;CACX;AACJ"}

package/dist/webrtc/use-link-stats.cjs

@@ -0,0 +1,2 @@
+const e=require("../hooks/use-document-visibility.cjs"),t=require("../hooks/use-interval.cjs"),n=require("./link-stats.cjs");let r=require("react");function i(i,a={}){let{intervalMs:o=2e3,pauseWhenHidden:s=!0,kind:c}=a,[l,u]=(0,r.useState)(null),d=(0,r.useRef)(null),f=(0,r.useRef)(!1),p=e.useDocumentVisibility(),m=s&&p===`hidden`;return(0,r.useEffect)(()=>{d.current=n.createLinkStatsSampler(c===void 0?{}:{kind:c}),u(null)},[i,c]),(0,r.useEffect)(()=>{m||d.current?.reset()},[m]),t.useInterval(()=>{let e=d.current;i!==null&&e!==null&&i.connectionState===`connected`&&(f.current||(f.current=!0,e.sample(i).then(e=>u(e)).catch(()=>void 0).finally(()=>{f.current=!1})))},i===null||m?null:o),l}exports.useLinkStats=i;
+//# sourceMappingURL=use-link-stats.cjs.map

package/dist/webrtc/use-link-stats.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-link-stats.cjs","names":[],"sources":["../../src/webrtc/use-link-stats.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nimport { useDocumentVisibility } from \"../hooks/use-document-visibility\";\nimport { useInterval } from \"../hooks/use-interval\";\nimport {\n    createLinkStatsSampler,\n    type LinkStats,\n    type LinkStatsKind,\n    type LinkStatsSampler,\n} from \"./link-stats\";\n\n/** Options for {@link useLinkStats}. */\nexport interface UseLinkStatsOptions {\n    /**\n     * How often to sample, in milliseconds. Default `2000`.\n     *\n     * `getStats()` walks every report a connection holds, and a mesh runs one\n     * per participant — on the device least able to pay for it. The numbers feed\n     * a latency badge and a throughput figure nobody reads at 1 Hz, so the\n     * default is deliberately slower than a frame budget suggests.\n     */\n    intervalMs?: number;\n    /**\n     * Stop sampling while the tab is in the background. Default `true`.\n     *\n     * The audio path is untouched by this — people in a backgrounded call still\n     * expect to hear it. What stops is the measuring, which nobody can see.\n     */\n    pauseWhenHidden?: boolean;\n    /** Which media the throughput counts. Default `\"video\"`. */\n    kind?: LinkStatsKind;\n}\n\n/**\n * Poll one connection's throughput, resolution and round trip.\n *\n * Sampling runs only while the connection is `\"connected\"`, so a link that is\n * still negotiating or already gone costs nothing. The last reading is kept\n * across pauses rather than cleared, because a badge that blanks every time the\n * tab loses focus reads as a broken connection.\n *\n * Coming back from a pause resets the baseline first. Without that, the sample\n * after a five-minute background stretch divides five minutes of bytes by five\n * minutes and reports the average of a period the person is not asking about.\n *\n * @param connection - The connection to watch, or `null` before one exists.\n * @param options - See {@link UseLinkStatsOptions}.\n * @returns The latest reading, or `null` before the first sample lands.\n *\n * @example\n * const stats = useLinkStats(pc);\n *\n * return <span>{stats ? `${stats.kbps} kbps · ${stats.rttMs ?? \"—\"} ms` : \"medindo…\"}</span>;\n */\nexport function useLinkStats(\n    connection: RTCPeerConnection | null,\n    options: UseLinkStatsOptions = {},\n): LinkStats | null {\n    const { intervalMs = 2000, pauseWhenHidden = true, kind } = options;\n    const [stats, setStats] = useState<LinkStats | null>(null);\n    const samplerRef = useRef<LinkStatsSampler | null>(null);\n    const inFlightRef = useRef(false);\n    const visibility = useDocumentVisibility();\n    const hidden = pauseWhenHidden && visibility === \"hidden\";\n\n    useEffect(() => {\n        samplerRef.current = createLinkStatsSampler(kind === undefined ? {} : { kind });\n        setStats(null);\n    }, [connection, kind]);\n\n    useEffect(() => {\n        if (!hidden) samplerRef.current?.reset();\n    }, [hidden]);\n\n    const paused = connection === null || hidden;\n\n    useInterval(\n        () => {\n            const sampler = samplerRef.current;\n            if (connection === null || sampler === null) return;\n            if (connection.connectionState !== \"connected\") return;\n            if (inFlightRef.current) return;\n            inFlightRef.current = true;\n            void sampler\n                .sample(connection)\n                .then((next) => setStats(next))\n                .catch(() => undefined)\n                .finally(() => {\n                    inFlightRef.current = false;\n                });\n        },\n        paused ? null : intervalMs,\n    );\n\n    return stats;\n}\n"],"mappings":"oJAsDA,SAAgB,EACZ,EACA,EAA+B,CAAC,EAChB,CAChB,GAAM,CAAE,aAAa,IAAM,kBAAkB,GAAM,QAAS,EACtD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAA2B,IAAI,EACnD,GAAA,EAAa,EAAA,OAAA,CAAgC,IAAI,EACjD,GAAA,EAAc,EAAA,OAAA,CAAO,EAAK,EAC1B,EAAa,EAAA,sBAAsB,EACnC,EAAS,GAAmB,IAAe,SA+BjD,OA7BA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,EAAA,uBAAuB,IAAS,IAAA,GAAY,CAAC,EAAI,CAAE,MAAK,CAAC,EAC9E,EAAS,IAAI,CACjB,EAAG,CAAC,EAAY,CAAI,CAAC,GAErB,EAAA,EAAA,UAAA,KAAgB,CACP,GAAQ,EAAW,SAAS,MAAM,CAC3C,EAAG,CAAC,CAAM,CAAC,EAIX,EAAA,gBACU,CACF,IAAM,EAAU,EAAW,QACvB,IAAe,MAAQ,IAAY,MACnC,EAAW,kBAAoB,cAC/B,EAAY,UAChB,EAAY,QAAU,GACtB,EACK,OAAO,CAAU,CAAC,CAClB,KAAM,GAAS,EAAS,CAAI,CAAC,CAAC,CAC9B,UAAY,IAAA,EAAS,CAAC,CACtB,YAAc,CACX,EAAY,QAAU,EAC1B,CAAC,GACT,EAhBW,IAAe,MAAQ,EAiBzB,KAAO,CACpB,EAEO,CACX"}

package/dist/webrtc/use-link-stats.js

@@ -0,0 +1,22 @@
+import { useDocumentVisibility as e } from "../hooks/use-document-visibility.js";
+import { useInterval as t } from "../hooks/use-interval.js";
+import { createLinkStatsSampler as n } from "./link-stats.js";
+import { useEffect as r, useRef as i, useState as a } from "react";
+//#region src/webrtc/use-link-stats.ts
+function o(o, s = {}) {
+	let { intervalMs: c = 2e3, pauseWhenHidden: l = !0, kind: u } = s, [d, f] = a(null), p = i(null), m = i(!1), h = e(), g = l && h === "hidden";
+	return r(() => {
+		p.current = n(u === void 0 ? {} : { kind: u }), f(null);
+	}, [o, u]), r(() => {
+		g || p.current?.reset();
+	}, [g]), t(() => {
+		let e = p.current;
+		o !== null && e !== null && o.connectionState === "connected" && (m.current || (m.current = !0, e.sample(o).then((e) => f(e)).catch(() => void 0).finally(() => {
+			m.current = !1;
+		})));
+	}, o === null || g ? null : c), d;
+}
+//#endregion
+export { o as useLinkStats };
+
+//# sourceMappingURL=use-link-stats.js.map

package/dist/webrtc/use-link-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-link-stats.js","names":[],"sources":["../../src/webrtc/use-link-stats.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nimport { useDocumentVisibility } from \"../hooks/use-document-visibility\";\nimport { useInterval } from \"../hooks/use-interval\";\nimport {\n    createLinkStatsSampler,\n    type LinkStats,\n    type LinkStatsKind,\n    type LinkStatsSampler,\n} from \"./link-stats\";\n\n/** Options for {@link useLinkStats}. */\nexport interface UseLinkStatsOptions {\n    /**\n     * How often to sample, in milliseconds. Default `2000`.\n     *\n     * `getStats()` walks every report a connection holds, and a mesh runs one\n     * per participant — on the device least able to pay for it. The numbers feed\n     * a latency badge and a throughput figure nobody reads at 1 Hz, so the\n     * default is deliberately slower than a frame budget suggests.\n     */\n    intervalMs?: number;\n    /**\n     * Stop sampling while the tab is in the background. Default `true`.\n     *\n     * The audio path is untouched by this — people in a backgrounded call still\n     * expect to hear it. What stops is the measuring, which nobody can see.\n     */\n    pauseWhenHidden?: boolean;\n    /** Which media the throughput counts. Default `\"video\"`. */\n    kind?: LinkStatsKind;\n}\n\n/**\n * Poll one connection's throughput, resolution and round trip.\n *\n * Sampling runs only while the connection is `\"connected\"`, so a link that is\n * still negotiating or already gone costs nothing. The last reading is kept\n * across pauses rather than cleared, because a badge that blanks every time the\n * tab loses focus reads as a broken connection.\n *\n * Coming back from a pause resets the baseline first. Without that, the sample\n * after a five-minute background stretch divides five minutes of bytes by five\n * minutes and reports the average of a period the person is not asking about.\n *\n * @param connection - The connection to watch, or `null` before one exists.\n * @param options - See {@link UseLinkStatsOptions}.\n * @returns The latest reading, or `null` before the first sample lands.\n *\n * @example\n * const stats = useLinkStats(pc);\n *\n * return <span>{stats ? `${stats.kbps} kbps · ${stats.rttMs ?? \"—\"} ms` : \"medindo…\"}</span>;\n */\nexport function useLinkStats(\n    connection: RTCPeerConnection | null,\n    options: UseLinkStatsOptions = {},\n): LinkStats | null {\n    const { intervalMs = 2000, pauseWhenHidden = true, kind } = options;\n    const [stats, setStats] = useState<LinkStats | null>(null);\n    const samplerRef = useRef<LinkStatsSampler | null>(null);\n    const inFlightRef = useRef(false);\n    const visibility = useDocumentVisibility();\n    const hidden = pauseWhenHidden && visibility === \"hidden\";\n\n    useEffect(() => {\n        samplerRef.current = createLinkStatsSampler(kind === undefined ? {} : { kind });\n        setStats(null);\n    }, [connection, kind]);\n\n    useEffect(() => {\n        if (!hidden) samplerRef.current?.reset();\n    }, [hidden]);\n\n    const paused = connection === null || hidden;\n\n    useInterval(\n        () => {\n            const sampler = samplerRef.current;\n            if (connection === null || sampler === null) return;\n            if (connection.connectionState !== \"connected\") return;\n            if (inFlightRef.current) return;\n            inFlightRef.current = true;\n            void sampler\n                .sample(connection)\n                .then((next) => setStats(next))\n                .catch(() => undefined)\n                .finally(() => {\n                    inFlightRef.current = false;\n                });\n        },\n        paused ? null : intervalMs,\n    );\n\n    return stats;\n}\n"],"mappings":";;;;;AAsDA,SAAgB,EACZ,GACA,IAA+B,CAAC,GAChB;CAChB,IAAM,EAAE,gBAAa,KAAM,qBAAkB,IAAM,YAAS,GACtD,CAAC,GAAO,KAAY,EAA2B,IAAI,GACnD,IAAa,EAAgC,IAAI,GACjD,IAAc,EAAO,EAAK,GAC1B,IAAa,EAAsB,GACnC,IAAS,KAAmB,MAAe;CA+BjD,OA7BA,QAAgB;EAEZ,AADA,EAAW,UAAU,EAAuB,MAAS,KAAA,IAAY,CAAC,IAAI,EAAE,QAAK,CAAC,GAC9E,EAAS,IAAI;CACjB,GAAG,CAAC,GAAY,CAAI,CAAC,GAErB,QAAgB;EACZ,AAAK,KAAQ,EAAW,SAAS,MAAM;CAC3C,GAAG,CAAC,CAAM,CAAC,GAIX,QACU;EACF,IAAM,IAAU,EAAW;EACvB,MAAe,QAAQ,MAAY,QACnC,EAAW,oBAAoB,gBAC/B,EAAY,YAChB,EAAY,UAAU,IACtB,EACK,OAAO,CAAU,CAAC,CAClB,MAAM,MAAS,EAAS,CAAI,CAAC,CAAC,CAC9B,YAAY,KAAA,CAAS,CAAC,CACtB,cAAc;GACX,EAAY,UAAU;EAC1B,CAAC;CACT,GAhBW,MAAe,QAAQ,IAiBzB,OAAO,CACpB,GAEO;AACX"}

package/dist/ws/create-web-socket.cjs

@@ -1,2 +1,2 @@
-function e(e){try{return JSON.parse(e)}catch{return e}}function t(t,n={}){let{protocols:r,maxRetries:i=10,initialBackoff:a=1e3,maxBackoff:o=3e4,pingInterval:s=0,pingPayload:c=JSON.stringify({type:`ping`}),respondToPing:l=!0,pongPayload:u=JSON.stringify({type:`pong`}),queueWhileClosed:d=!1,maxQueuedMessages:f=100,parser:p=e,onOpen:m,onMessage:h,onClose:g,onError:_,onStatusChange:v}=n,y=null,b=null,x=null,S=0,C=`idle`,w=!1,T=[];function E(e){return typeof e==`object`&&!!e&&e.type===`ping`}function D(e){for(;T.length>0&&e.readyState===WebSocket.OPEN;)e.send(T.shift())}function O(e){C!==e&&(C=e,v?.(e))}function k(){x&&=(clearInterval(x),null)}function A(){!s||s<=0||(k(),x=setInterval(()=>{y?.readyState===WebSocket.OPEN&&y.send(c)},s))}function j(){if(w)return;if(S>=i){O(`error`);return}let e=Math.min(a*2**S,o);S+=1,b=setTimeout(M,e)}function M(){if(w)return;if(y){let e=y;e.onmessage=null,e.onclose=null,e.onerror=null,e.readyState!==WebSocket.CONNECTING&&(e.onopen=null),F(e)}O(`connecting`);let e=new WebSocket(t,r);y=e,e.onopen=t=>{S=0,O(`open`),A(),D(e),m?.(t)},e.onmessage=t=>{let n=typeof t.data==`string`?t.data:``,r=p(n);l&&E(r)&&e.readyState===WebSocket.OPEN&&e.send(u),h?.({data:r,raw:t})},e.onerror=e=>{_?.(e)},e.onclose=e=>{k(),g?.(e),y=null,O(`closed`),!w&&!e.wasClean&&j()}}function N(e){return y?.readyState===WebSocket.OPEN?(y.send(e),!0):!d||w?!1:(T.length>=f&&T.shift(),T.push(e),!0)}function P(e,t){w=!0,b&&=(clearTimeout(b),null),k(),S=0,T.length=0,y&&=(O(`closing`),F(y,e,t),null),O(`closed`)}function F(e,t,n){if(e.readyState===WebSocket.CONNECTING){e.onopen=()=>e.close(t,n),e.onmessage=null,e.onerror=null,e.onclose=null;return}e.close(t,n)}function I(){b&&=(clearTimeout(b),null),S=0,w=!1,M()}return M(),{send:N,close:P,reconnect:I,get status(){return C}}}exports.createWebSocket=t;
+const e=require("../utils/json-frame.cjs"),t=require("./resilience.cjs");function n(n,r={}){let{protocols:i,maxRetries:a=10,initialBackoff:o=1e3,maxBackoff:s=3e4,jitter:ee=.3,handshakeTimeout:c=8e3,silenceTimeout:l=0,waitForOnline:u=!0,pingInterval:d=0,pingPayload:f=JSON.stringify({type:`ping`}),respondToPing:p=!0,pongPayload:m=JSON.stringify({type:`pong`}),queueWhileClosed:h=!1,maxQueuedMessages:te=100,parser:ne,onOpen:g,onMessage:_,onClose:v,onError:y,onParseError:b,onStatusChange:re,onReconnecting:ie,onReconnected:x,onLost:S}=r,C=null,w=null,T=null,E=null,D=null,O=null,k=l,A=0,j=`idle`,M=!1,N=!1,P=[],F=null,I=null,L=new Promise((e,t)=>{F=e,I=t});L.catch(()=>void 0);function R(e){return typeof e==`object`&&!!e&&e.type===`ping`}function z(e){for(;P.length>0&&e.readyState===WebSocket.OPEN;)e.send(P.shift())}function B(e){j!==e&&(j=e,re?.(e))}function V(){T&&=(clearInterval(T),null)}function H(){E&&=(clearTimeout(E),null)}function U(){D&&=(clearTimeout(D),null)}function W(){!d||d<=0||(V(),T=setInterval(()=>{C?.readyState===WebSocket.OPEN&&C.send(f)},d))}function G(){U(),!(M||k<=0)&&(D=setTimeout(K,k))}function K(){U(),!(M||!C)&&(J(C),C=null,B(`closed`),X())}function q(e){H(),!(M||e.readyState!==WebSocket.CONNECTING)&&(J(e),C===e&&(C=null),B(`closed`),X())}function J(e){e.onopen=null,e.onmessage=null,e.onerror=null,e.onclose=null;try{e.close()}catch{}}function Y(e){if(U(),H(),Z(),e===`rejected`&&(M=!0),B(`error`),!N&&I){let t=I;I=null,F=null,t(Error(`websocket_${e}`))}S?.(e)}function X(){if(M)return;if(A>=a){Y(`exhausted`);return}let e=t.backoffDelay(A,{initialBackoff:o,maxBackoff:s,jitter:ee});if(A+=1,ie?.(A,a),u&&typeof navigator<`u`&&navigator.onLine===!1){ae();return}w=setTimeout(Q,e)}function ae(){if(O||typeof window>`u`)return;let e=()=>{Z(),M||Q()};O=e,window.addEventListener(`online`,e)}function Z(){!O||typeof window>`u`||(window.removeEventListener(`online`,O),O=null)}function Q(){if(M)return;if(w=null,H(),C){let e=C;e.onmessage=null,e.onclose=null,e.onerror=null,e.readyState!==WebSocket.CONNECTING&&(e.onopen=null),$(e)}B(`connecting`);let r=new WebSocket(n,i);C=r,c>0&&(E=setTimeout(()=>q(r),c)),r.onopen=e=>{H();let t=A>0;if(A=0,N=!0,B(`open`),W(),G(),z(r),F){let e=F;F=null,I=null,e()}g?.(e),t&&x?.()},r.onmessage=t=>{G();let n=typeof t.data==`string`?t.data:``,i=e.decodeFrame(n,ne,b,`createWebSocket`);if(!i.delivered)return;let a=i.data;p&&R(a)&&r.readyState===WebSocket.OPEN&&r.send(m),_?.({data:a,raw:t})},r.onerror=e=>{y?.(e)},r.onclose=e=>{if(H(),V(),U(),v?.(e),C=null,B(`closed`),!M){if(t.isRejectionCloseCode(e.code)){Y(`rejected`);return}if(t.shouldRetryClose(e.code,e.wasClean)){X();return}N||Y(`rejected`)}}}function oe(e){return C?.readyState===WebSocket.OPEN?(C.send(e),!0):!h||M?!1:(P.length>=te&&P.shift(),P.push(e),!0)}function se(e,t){if(M=!0,w&&=(clearTimeout(w),null),V(),H(),U(),Z(),A=0,P.length=0,I){let e=I;I=null,F=null,e(Error(`websocket_closed`))}C&&=(B(`closing`),$(C,e,t),null),B(`closed`)}function $(e,t,n){if(e.readyState===WebSocket.CONNECTING){e.onopen=()=>e.close(t,n),e.onmessage=null,e.onerror=null,e.onclose=null;return}e.close(t,n)}function ce(){w&&=(clearTimeout(w),null),Z(),A=0,M=!1,Q()}function le(e){k=Number.isFinite(e)&&e>0?e:0,C?.readyState===WebSocket.OPEN?G():U()}return Q(),{send:oe,close:se,reconnect:ce,setSilenceTimeout:le,opened:L,get status(){return j}}}exports.createWebSocket=n;
 //# sourceMappingURL=create-web-socket.cjs.map

package/dist/ws/create-web-socket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-web-socket.cjs","names":[],"sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, function-lines — reconnect with backoff, heartbeat,\n * the send queue that survives a disconnect and the listener set that must be re-\n * attached to each new socket — one connection's lifetime, one closure. The queue\n * and the reconnect timer are the same decision seen twice.\n */\nexport type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     *\n     * Leave it off against a `tempest-fastapi-sdk` server: that server pings on\n     * its own and answers a client-sent `{\"type\":\"ping\"}` with nothing, while a\n     * strict handler rejects the unknown frame. What it needs from the client\n     * is the `pong` reply, which `respondToPing` sends for you.\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | Blob | BufferSource;\n    /**\n     * Reply to a server `{\"type\":\"ping\"}` with `pongPayload`. Default: true.\n     *\n     * `tempest-fastapi-sdk` closes a socket with code `4408` when no `pong`\n     * arrives within `WS_HEARTBEAT_TIMEOUT_SECONDS`, so a client that stays\n     * silent is dropped once per timeout. The ping is still forwarded to\n     * `onMessage` — the reply is sent before your handler runs.\n     */\n    respondToPing?: boolean;\n    /** Payload sent in reply to a server ping. Default: `JSON.stringify({ type: \"pong\" })`. */\n    pongPayload?: string | Blob | BufferSource;\n    /**\n     * Buffer payloads sent while the socket is not open and flush them on the\n     * next `open`. Default: false — `send()` returns false and drops.\n     *\n     * Without it, an action fired during reconnect backoff vanishes and the UI\n     * cannot tell \"never sent\" from \"sent and ignored\".\n     */\n    queueWhileClosed?: boolean;\n    /** Cap on buffered payloads when `queueWhileClosed` is on. Default: 100. */\n    maxQueuedMessages?: number;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        respondToPing = true,\n        pongPayload = JSON.stringify({ type: \"pong\" }),\n        queueWhileClosed = false,\n        maxQueuedMessages = 100,\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n    const outbox: Array<string | Blob | BufferSource> = [];\n\n    /** True for a decoded frame that is the server's heartbeat ping. */\n    function isServerPing(data: unknown): boolean {\n        return (\n            typeof data === \"object\" &&\n            data !== null &&\n            (data as { type?: unknown }).type === \"ping\"\n        );\n    }\n\n    /** Send everything buffered while the socket was down, oldest first. */\n    function flushOutbox(ws: WebSocket): void {\n        while (outbox.length > 0 && ws.readyState === WebSocket.OPEN) {\n            ws.send(outbox.shift()!);\n        }\n    }\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            const previous = socket;\n            previous.onmessage = null;\n            previous.onclose = null;\n            previous.onerror = null;\n            if (previous.readyState !== WebSocket.CONNECTING) previous.onopen = null;\n            closeSocket(previous);\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            flushOutbox(ws);\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            const data = parser(raw);\n            if (respondToPing && isServerPing(data) && ws.readyState === WebSocket.OPEN) {\n                ws.send(pongPayload);\n            }\n            onMessage?.({ data, raw: event });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | Blob | BufferSource): boolean {\n        if (socket?.readyState === WebSocket.OPEN) {\n            socket.send(payload);\n            return true;\n        }\n        if (!queueWhileClosed || closed) return false;\n        if (outbox.length >= maxQueuedMessages) outbox.shift();\n        outbox.push(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        outbox.length = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            closeSocket(socket, code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    /**\n     * Close a socket without the \"closed before the connection is established\"\n     * console warning.\n     *\n     * A socket still in `CONNECTING` cannot be closed cleanly — the browser\n     * logs that warning on every attempt. React's StrictMode mounts, unmounts\n     * and remounts each component in development, so the first socket is\n     * always torn down mid-handshake and the message shows up in every dev\n     * session of every app using the hook. Deferring the close to `onopen`\n     * costs one round trip and keeps the console usable.\n     */\n    function closeSocket(ws: WebSocket, code?: number, reason?: string): void {\n        if (ws.readyState === WebSocket.CONNECTING) {\n            ws.onopen = () => ws.close(code, reason);\n            ws.onmessage = null;\n            ws.onerror = null;\n            ws.onclose = null;\n            return;\n        }\n        ws.close(code, reason);\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-web-socket.cjs","names":[],"sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, function-lines — reconnect with backoff, heartbeat,\n * the handshake and silence timers that detect a link which never fails out loud,\n * the send queue that survives a disconnect and the listener set that must be re-\n * attached to each new socket — one connection's lifetime, one closure. The queue\n * and the reconnect timer are the same decision seen twice.\n */\nimport {\n    backoffDelay,\n    isRejectionCloseCode,\n    shouldRetryClose,\n    type WebSocketLostReason,\n} from \"./resilience\";\nimport { decodeFrame } from \"../utils/json-frame\";\n\nexport type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Fraction of each backoff delay added at random, 0–1. Default: 0.3.\n     *\n     * Matters when the *server* is what went down: every client retries on the\n     * same schedule, so the box comes back up into a synchronized stampede. Pass\n     * `0` for a fixed schedule.\n     */\n    jitter?: number;\n    /**\n     * How long one handshake may stay in `CONNECTING` before the attempt is\n     * abandoned and retried (ms). Default: 8000. Pass 0 to disable.\n     *\n     * A `WebSocket` that cannot reach its server does not necessarily fail: it\n     * sits in `CONNECTING` firing neither `open` nor `close` nor `error`. A retry\n     * chain built only on those events stops on its first hung attempt and never\n     * moves again — and hung, rather than refused, is precisely how a bad mobile\n     * link behaves, which is the case reconnection exists for.\n     */\n    handshakeTimeout?: number;\n    /**\n     * Silence tolerated on an open socket before the link is treated as dead (ms).\n     * Default: 0 (off).\n     *\n     * The socket only reports a connection that closes cleanly. A link that dies\n     * mid-flight leaves `readyState` at `OPEN` on this side with nothing ever\n     * arriving again, so silence is the only symptom available. The timer is\n     * re-armed by **any** inbound frame, not just by pings — traffic is traffic.\n     *\n     * Set it to a comfortable multiple of the server's ping interval (2.5× is a\n     * good default) so one dropped ping is not mistaken for an outage. When the\n     * server announces its own interval in the handshake, feed that back with\n     * {@link WebSocketController.setSilenceTimeout} instead of hard-coding the\n     * value on both ends.\n     */\n    silenceTimeout?: number;\n    /**\n     * Suspend the retry schedule while `navigator.onLine` is false, and resume on\n     * the `online` event. Default: true.\n     *\n     * Burning retries against a radio that is switched off is how a phone\n     * exhausts its budget inside a tunnel and gives up exactly when it comes out\n     * the other side.\n     */\n    waitForOnline?: boolean;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     *\n     * Leave it off against a `tempest-fastapi-sdk` server: that server pings on\n     * its own and answers a client-sent `{\"type\":\"ping\"}` with nothing, while a\n     * strict handler rejects the unknown frame. What it needs from the client\n     * is the `pong` reply, which `respondToPing` sends for you.\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | Blob | BufferSource;\n    /**\n     * Reply to a server `{\"type\":\"ping\"}` with `pongPayload`. Default: true.\n     *\n     * `tempest-fastapi-sdk` closes a socket with code `4408` when no `pong`\n     * arrives within `WS_HEARTBEAT_TIMEOUT_SECONDS`, so a client that stays\n     * silent is dropped once per timeout. The ping is still forwarded to\n     * `onMessage` — the reply is sent before your handler runs.\n     */\n    respondToPing?: boolean;\n    /** Payload sent in reply to a server ping. Default: `JSON.stringify({ type: \"pong\" })`. */\n    pongPayload?: string | Blob | BufferSource;\n    /**\n     * Buffer payloads sent while the socket is not open and flush them on the\n     * next `open`. Default: false — `send()` returns false and drops.\n     *\n     * Without it, an action fired during reconnect backoff vanishes and the UI\n     * cannot tell \"never sent\" from \"sent and ignored\".\n     */\n    queueWhileClosed?: boolean;\n    /** Cap on buffered payloads when `queueWhileClosed` is on. Default: 100. */\n    maxQueuedMessages?: number;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    /**\n     * A frame arrived that is not valid JSON, and no `parser` was supplied.\n     *\n     * Registering this drops the frame instead of delivering it: the previous\n     * behaviour handed `onMessage` the raw `string` announced as your message\n     * type, so the failure surfaced later, at the first property access, with\n     * nothing left pointing at the parse. Leave it out and that behaviour is\n     * kept, with a one-time warning in development builds.\n     */\n    onParseError?: (error: unknown, raw: string) => void;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n    /**\n     * A retry has been scheduled. `attempt` is 1-based, `total` is `maxRetries`.\n     *\n     * Reconnecting is not an error and reads badly as one: announcing every\n     * attempt puts a fresh \"the connection dropped\" in front of someone whose\n     * session is in the middle of coming back on its own. Show a quiet\n     * reconnecting state here and treat {@link CreateWebSocketOptions.onLost} as\n     * the failure.\n     */\n    onReconnecting?: (attempt: number, total: number) => void;\n    /**\n     * The socket is back up after at least one retry.\n     *\n     * Nothing is resumed for you: a server that keys state by connection sees a\n     * brand-new client, so this is where the caller re-subscribes, re-joins or\n     * refetches whatever the gap invalidated.\n     */\n    onReconnected?: () => void;\n    /**\n     * No further attempt will be made — `\"rejected\"` when the server refused the\n     * client outright (close code 4400–4499, minus the 4408 heartbeat timeout),\n     * `\"exhausted\"` when the schedule ran out.\n     *\n     * This is the one that deserves UI, because it is the only state the caller\n     * can act on: offer a \"try again\" that calls\n     * {@link WebSocketController.reconnect}.\n     */\n    onLost?: (reason: WebSocketLostReason) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For the common case where the server announces its heartbeat interval in\n     * the first frame, so the tolerated silence is not hard-coded on both ends:\n     *\n     * ```ts\n     * onMessage: ({ data }) => {\n     *   if (data.type === \"welcome\") socket.setSilenceTimeout(data.heartbeat_seconds * 2500);\n     * }\n     * ```\n     */\n    setSilenceTimeout: (ms: number) => void;\n    /**\n     * Resolves on the first successful open, rejects when the socket is lost\n     * before ever opening.\n     *\n     * Joining and dropping are different events: a call that never connected has\n     * to be reported, while one that dropped mid-session should reconnect\n     * quietly. Await this for the join, handle\n     * {@link CreateWebSocketOptions.onLost} for the drop. Pair it with\n     * `maxRetries: 0` when the first attempt should fail fast instead of\n     * spending the whole schedule on a server that is not there.\n     */\n    opened: Promise<void>;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\n/**\n * Open a WebSocket that survives a bad network: exponential backoff with jitter,\n * a handshake timeout, a silence watchdog, optional heartbeat pings and typed\n * JSON parsing.\n *\n * Three failure modes are covered that an event-driven retry loop misses on its\n * own, because none of them fire an event: a handshake that hangs instead of\n * failing, an open socket whose link died mid-flight, and a device with its\n * radio off burning the retry budget. See `handshakeTimeout`, `silenceTimeout`\n * and `waitForOnline`.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, `setSilenceTimeout`,\n *   `opened` and `status`.\n *\n * @example\n * const socket = createWebSocket(url, {\n *   silenceTimeout: 75_000,\n *   onReconnecting: (n, total) => setBanner(`Reconectando ${n}/${total}…`),\n *   onReconnected: () => refetchEverything(),\n *   onLost: (reason) => setBanner(reason === \"rejected\" ? \"Acesso negado\" : \"Sem conexão\"),\n * });\n * await socket.opened;\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        jitter = 0.3,\n        handshakeTimeout = 8000,\n        silenceTimeout = 0,\n        waitForOnline = true,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        respondToPing = true,\n        pongPayload = JSON.stringify({ type: \"pong\" }),\n        queueWhileClosed = false,\n        maxQueuedMessages = 100,\n        parser,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onParseError,\n        onStatusChange,\n        onReconnecting,\n        onReconnected,\n        onLost,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let handshakeTimer: ReturnType<typeof setTimeout> | null = null;\n    let silenceTimer: ReturnType<typeof setTimeout> | null = null;\n    let onlineListener: (() => void) | null = null;\n    let silenceWindow = silenceTimeout;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n    let everOpened = false;\n    const outbox: Array<string | Blob | BufferSource> = [];\n\n    let settleOpen: (() => void) | null = null;\n    let failOpen: ((error: Error) => void) | null = null;\n    const opened = new Promise<void>((resolve, reject) => {\n        settleOpen = resolve;\n        failOpen = reject;\n    });\n    opened.catch(() => undefined);\n\n    /** True for a decoded frame that is the server's heartbeat ping. */\n    function isServerPing(data: unknown): boolean {\n        return (\n            typeof data === \"object\" &&\n            data !== null &&\n            (data as { type?: unknown }).type === \"ping\"\n        );\n    }\n\n    /** Send everything buffered while the socket was down, oldest first. */\n    function flushOutbox(ws: WebSocket): void {\n        while (outbox.length > 0 && ws.readyState === WebSocket.OPEN) {\n            ws.send(outbox.shift()!);\n        }\n    }\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function clearHandshake(): void {\n        if (handshakeTimer) {\n            clearTimeout(handshakeTimer);\n            handshakeTimer = null;\n        }\n    }\n\n    function clearSilence(): void {\n        if (silenceTimer) {\n            clearTimeout(silenceTimer);\n            silenceTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    /**\n     * Restart the silence timer, because something just arrived.\n     *\n     * Armed off any inbound frame rather than off pongs alone: a busy exchange\n     * already proves the link is carrying data, and a protocol whose pings the\n     * client never sees would otherwise reconnect in the middle of working\n     * traffic.\n     */\n    function armSilence(): void {\n        clearSilence();\n        if (closed || silenceWindow <= 0) return;\n        silenceTimer = setTimeout(onSilence, silenceWindow);\n    }\n\n    /**\n     * Treat a socket that went quiet as dead and start reconnecting.\n     *\n     * Handlers are detached before closing so the synthetic `close` does not also\n     * schedule a retry — that would advance the backoff twice for one failure and\n     * halve the time the connection is given to recover.\n     */\n    function onSilence(): void {\n        clearSilence();\n        if (closed || !socket) return;\n        detach(socket);\n        socket = null;\n        setStatus(\"closed\");\n        scheduleReconnect();\n    }\n\n    /**\n     * Abandon a handshake that never resolved either way.\n     *\n     * The socket is closed while still `CONNECTING`, which is the one case the\n     * console warns about — and the right trade here, because the alternative is\n     * deferring the close to an `open` event that by definition is not coming.\n     */\n    function abandonHandshake(ws: WebSocket): void {\n        clearHandshake();\n        if (closed || ws.readyState !== WebSocket.CONNECTING) return;\n        detach(ws);\n        if (socket === ws) socket = null;\n        setStatus(\"closed\");\n        scheduleReconnect();\n    }\n\n    /** Drop every handler and close, so the socket can die without being heard. */\n    function detach(ws: WebSocket): void {\n        ws.onopen = null;\n        ws.onmessage = null;\n        ws.onerror = null;\n        ws.onclose = null;\n        try {\n            ws.close();\n        } catch {\n            /* already unusable — nothing to release and nothing to report */\n        }\n    }\n\n    /** Stop for good, telling the caller which of the two dead ends it is. */\n    function lose(reason: WebSocketLostReason): void {\n        clearSilence();\n        clearHandshake();\n        clearNetworkWait();\n        if (reason === \"rejected\") closed = true;\n        setStatus(\"error\");\n        if (!everOpened && failOpen) {\n            const reject = failOpen;\n            failOpen = null;\n            settleOpen = null;\n            reject(new Error(`websocket_${reason}`));\n        }\n        onLost?.(reason);\n    }\n\n    /**\n     * Queue the next attempt, or wait for the network when there is none.\n     *\n     * While the browser reports no connectivity the schedule is suspended and the\n     * `online` event drives the next attempt instead, so a device in a tunnel\n     * does not spend its whole budget before coming out the other side.\n     */\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            lose(\"exhausted\");\n            return;\n        }\n        const delay = backoffDelay(retries, { initialBackoff, maxBackoff, jitter });\n        retries += 1;\n        onReconnecting?.(retries, maxRetries);\n\n        if (waitForOnline && typeof navigator !== \"undefined\" && navigator.onLine === false) {\n            waitForNetwork();\n            return;\n        }\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function waitForNetwork(): void {\n        if (onlineListener || typeof window === \"undefined\") return;\n        const listener = (): void => {\n            clearNetworkWait();\n            if (!closed) connect();\n        };\n        onlineListener = listener;\n        window.addEventListener(\"online\", listener);\n    }\n\n    function clearNetworkWait(): void {\n        if (!onlineListener || typeof window === \"undefined\") return;\n        window.removeEventListener(\"online\", onlineListener);\n        onlineListener = null;\n    }\n\n    /**\n     * Open a socket, replacing whatever is there.\n     *\n     * The handshake timer is cleared first because it belongs to the socket\n     * being replaced, and it holds a reference to it: left armed, it fires later\n     * against a connection nobody is waiting for, clears the *new* socket's\n     * timer on its way through, and schedules a retry that drops a connection\n     * still in flight. `reconnect()` on a hung socket is the path that reaches\n     * it.\n     */\n    function connect(): void {\n        if (closed) return;\n        retryTimer = null;\n        clearHandshake();\n        if (socket) {\n            const previous = socket;\n            previous.onmessage = null;\n            previous.onclose = null;\n            previous.onerror = null;\n            if (previous.readyState !== WebSocket.CONNECTING) previous.onopen = null;\n            closeSocket(previous);\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        if (handshakeTimeout > 0) {\n            handshakeTimer = setTimeout(() => abandonHandshake(ws), handshakeTimeout);\n        }\n\n        ws.onopen = (event) => {\n            clearHandshake();\n            const recovered = retries > 0;\n            retries = 0;\n            everOpened = true;\n            setStatus(\"open\");\n            startPing();\n            armSilence();\n            flushOutbox(ws);\n            if (settleOpen) {\n                const resolve = settleOpen;\n                settleOpen = null;\n                failOpen = null;\n                resolve();\n            }\n            onOpen?.(event);\n            if (recovered) onReconnected?.();\n        };\n\n        ws.onmessage = (event) => {\n            armSilence();\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            const decoded = decodeFrame<T>(raw, parser, onParseError, \"createWebSocket\");\n            if (!decoded.delivered) return;\n            const data = decoded.data;\n            if (respondToPing && isServerPing(data) && ws.readyState === WebSocket.OPEN) {\n                ws.send(pongPayload);\n            }\n            onMessage?.({ data, raw: event });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        /**\n         * Classify the close before deciding anything.\n         *\n         * Three outcomes, in order: a refusal never gets better by trying again;\n         * a died-in-flight or temporarily-unavailable close is retried; an\n         * ordinary goodbye (a clean 1000) is the session ending on purpose and\n         * deserves no error. The one exception is a goodbye on a socket that\n         * never opened — the server hung up during the handshake, which the\n         * caller awaiting `opened` has to hear about.\n         */\n        ws.onclose = (event) => {\n            clearHandshake();\n            clearPing();\n            clearSilence();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (closed) return;\n            if (isRejectionCloseCode(event.code)) {\n                lose(\"rejected\");\n                return;\n            }\n            if (shouldRetryClose(event.code, event.wasClean)) {\n                scheduleReconnect();\n                return;\n            }\n            if (!everOpened) lose(\"rejected\");\n        };\n    }\n\n    function send(payload: string | Blob | BufferSource): boolean {\n        if (socket?.readyState === WebSocket.OPEN) {\n            socket.send(payload);\n            return true;\n        }\n        if (!queueWhileClosed || closed) return false;\n        if (outbox.length >= maxQueuedMessages) outbox.shift();\n        outbox.push(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        clearHandshake();\n        clearSilence();\n        clearNetworkWait();\n        retries = 0;\n        outbox.length = 0;\n        if (failOpen) {\n            const reject = failOpen;\n            failOpen = null;\n            settleOpen = null;\n            reject(new Error(\"websocket_closed\"));\n        }\n        if (socket) {\n            setStatus(\"closing\");\n            closeSocket(socket, code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    /**\n     * Close a socket without the \"closed before the connection is established\"\n     * console warning.\n     *\n     * A socket still in `CONNECTING` cannot be closed cleanly — the browser\n     * logs that warning on every attempt. React's StrictMode mounts, unmounts\n     * and remounts each component in development, so the first socket is\n     * always torn down mid-handshake and the message shows up in every dev\n     * session of every app using the hook. Deferring the close to `onopen`\n     * costs one round trip and keeps the console usable.\n     */\n    function closeSocket(ws: WebSocket, code?: number, reason?: string): void {\n        if (ws.readyState === WebSocket.CONNECTING) {\n            ws.onopen = () => ws.close(code, reason);\n            ws.onmessage = null;\n            ws.onerror = null;\n            ws.onclose = null;\n            return;\n        }\n        ws.close(code, reason);\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearNetworkWait();\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    function setSilenceTimeout(ms: number): void {\n        silenceWindow = Number.isFinite(ms) && ms > 0 ? ms : 0;\n        if (socket?.readyState === WebSocket.OPEN) armSilence();\n        else clearSilence();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        setSilenceTimeout,\n        opened,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/ws/create-web-socket.js

@@ -1,87 +1,159 @@
+import { decodeFrame as e } from "../utils/json-frame.js";
+import { backoffDelay as t, isRejectionCloseCode as n, shouldRetryClose as r } from "./resilience.js";
 //#region src/ws/create-web-socket.ts
-function e(e) {
-	try {
-		return JSON.parse(e);
-	} catch {
-		return e;
-	}
-}
-function t(t, n = {}) {
-	let { protocols: r, maxRetries: i = 10, initialBackoff: a = 1e3, maxBackoff: o = 3e4, pingInterval: s = 0, pingPayload: c = JSON.stringify({ type: "ping" }), respondToPing: l = !0, pongPayload: u = JSON.stringify({ type: "pong" }), queueWhileClosed: d = !1, maxQueuedMessages: f = 100, parser: p = e, onOpen: m, onMessage: h, onClose: g, onError: _, onStatusChange: v } = n, y = null, b = null, x = null, S = 0, C = "idle", w = !1, T = [];
-	function E(e) {
+function i(i, a = {}) {
+	let { protocols: ee, maxRetries: o = 10, initialBackoff: s = 1e3, maxBackoff: c = 3e4, jitter: l = .3, handshakeTimeout: u = 8e3, silenceTimeout: d = 0, waitForOnline: f = !0, pingInterval: p = 0, pingPayload: te = JSON.stringify({ type: "ping" }), respondToPing: ne = !0, pongPayload: re = JSON.stringify({ type: "pong" }), queueWhileClosed: m = !1, maxQueuedMessages: h = 100, parser: g, onOpen: _, onMessage: v, onClose: y, onError: ie, onParseError: ae, onStatusChange: b, onReconnecting: x, onReconnected: S, onLost: C } = a, w = null, T = null, E = null, D = null, O = null, k = null, A = d, j = 0, M = "idle", N = !1, P = !1, F = [], I = null, L = null, R = new Promise((e, t) => {
+		I = e, L = t;
+	});
+	R.catch(() => void 0);
+	function z(e) {
 		return typeof e == "object" && !!e && e.type === "ping";
 	}
-	function D(e) {
-		for (; T.length > 0 && e.readyState === WebSocket.OPEN;) e.send(T.shift());
+	function B(e) {
+		for (; F.length > 0 && e.readyState === WebSocket.OPEN;) e.send(F.shift());
+	}
+	function V(e) {
+		M !== e && (M = e, b?.(e));
+	}
+	function H() {
+		E &&= (clearInterval(E), null);
+	}
+	function U() {
+		D &&= (clearTimeout(D), null);
+	}
+	function W() {
+		O &&= (clearTimeout(O), null);
+	}
+	function G() {
+		!p || p <= 0 || (H(), E = setInterval(() => {
+			w?.readyState === WebSocket.OPEN && w.send(te);
+		}, p));
+	}
+	function K() {
+		W(), !(N || A <= 0) && (O = setTimeout(q, A));
+	}
+	function q() {
+		W(), !(N || !w) && (J(w), w = null, V("closed"), X());
 	}
-	function O(e) {
-		C !== e && (C = e, v?.(e));
+	function oe(e) {
+		U(), !(N || e.readyState !== WebSocket.CONNECTING) && (J(e), w === e && (w = null), V("closed"), X());
 	}
-	function k() {
-		x &&= (clearInterval(x), null);
+	function J(e) {
+		e.onopen = null, e.onmessage = null, e.onerror = null, e.onclose = null;
+		try {
+			e.close();
+		} catch {}
 	}
-	function A() {
-		!s || s <= 0 || (k(), x = setInterval(() => {
-			y?.readyState === WebSocket.OPEN && y.send(c);
-		}, s));
+	function Y(e) {
+		if (W(), U(), Z(), e === "rejected" && (N = !0), V("error"), !P && L) {
+			let t = L;
+			L = null, I = null, t(/* @__PURE__ */ Error(`websocket_${e}`));
+		}
+		C?.(e);
 	}
-	function j() {
-		if (w) return;
-		if (S >= i) {
-			O("error");
+	function X() {
+		if (N) return;
+		if (j >= o) {
+			Y("exhausted");
 			return;
 		}
-		let e = Math.min(a * 2 ** S, o);
-		S += 1, b = setTimeout(M, e);
-	}
-	function M() {
-		if (w) return;
-		if (y) {
-			let e = y;
-			e.onmessage = null, e.onclose = null, e.onerror = null, e.readyState !== WebSocket.CONNECTING && (e.onopen = null), F(e);
+		let e = t(j, {
+			initialBackoff: s,
+			maxBackoff: c,
+			jitter: l
+		});
+		if (j += 1, x?.(j, o), f && typeof navigator < "u" && navigator.onLine === !1) {
+			se();
+			return;
 		}
-		O("connecting");
-		let e = new WebSocket(t, r);
-		y = e, e.onopen = (t) => {
-			S = 0, O("open"), A(), D(e), m?.(t);
-		}, e.onmessage = (t) => {
-			let n = typeof t.data == "string" ? t.data : "", r = p(n);
-			l && E(r) && e.readyState === WebSocket.OPEN && e.send(u), h?.({
-				data: r,
-				raw: t
+		T = setTimeout(Q, e);
+	}
+	function se() {
+		if (k || typeof window > "u") return;
+		let e = () => {
+			Z(), N || Q();
+		};
+		k = e, window.addEventListener("online", e);
+	}
+	function Z() {
+		!k || typeof window > "u" || (window.removeEventListener("online", k), k = null);
+	}
+	function Q() {
+		if (N) return;
+		if (T = null, U(), w) {
+			let e = w;
+			e.onmessage = null, e.onclose = null, e.onerror = null, e.readyState !== WebSocket.CONNECTING && (e.onopen = null), $(e);
+		}
+		V("connecting");
+		let t = new WebSocket(i, ee);
+		w = t, u > 0 && (D = setTimeout(() => oe(t), u)), t.onopen = (e) => {
+			U();
+			let n = j > 0;
+			if (j = 0, P = !0, V("open"), G(), K(), B(t), I) {
+				let e = I;
+				I = null, L = null, e();
+			}
+			_?.(e), n && S?.();
+		}, t.onmessage = (n) => {
+			K();
+			let r = typeof n.data == "string" ? n.data : "", i = e(r, g, ae, "createWebSocket");
+			if (!i.delivered) return;
+			let a = i.data;
+			ne && z(a) && t.readyState === WebSocket.OPEN && t.send(re), v?.({
+				data: a,
+				raw: n
 			});
-		}, e.onerror = (e) => {
-			_?.(e);
-		}, e.onclose = (e) => {
-			k(), g?.(e), y = null, O("closed"), !w && !e.wasClean && j();
+		}, t.onerror = (e) => {
+			ie?.(e);
+		}, t.onclose = (e) => {
+			if (U(), H(), W(), y?.(e), w = null, V("closed"), !N) {
+				if (n(e.code)) {
+					Y("rejected");
+					return;
+				}
+				if (r(e.code, e.wasClean)) {
+					X();
+					return;
+				}
+				P || Y("rejected");
+			}
 		};
 	}
-	function N(e) {
-		return y?.readyState === WebSocket.OPEN ? (y.send(e), !0) : !d || w ? !1 : (T.length >= f && T.shift(), T.push(e), !0);
+	function ce(e) {
+		return w?.readyState === WebSocket.OPEN ? (w.send(e), !0) : !m || N ? !1 : (F.length >= h && F.shift(), F.push(e), !0);
 	}
-	function P(e, t) {
-		w = !0, b &&= (clearTimeout(b), null), k(), S = 0, T.length = 0, y &&= (O("closing"), F(y, e, t), null), O("closed");
+	function le(e, t) {
+		if (N = !0, T &&= (clearTimeout(T), null), H(), U(), W(), Z(), j = 0, F.length = 0, L) {
+			let e = L;
+			L = null, I = null, e(/* @__PURE__ */ Error("websocket_closed"));
+		}
+		w &&= (V("closing"), $(w, e, t), null), V("closed");
 	}
-	function F(e, t, n) {
+	function $(e, t, n) {
 		if (e.readyState === WebSocket.CONNECTING) {
 			e.onopen = () => e.close(t, n), e.onmessage = null, e.onerror = null, e.onclose = null;
 			return;
 		}
 		e.close(t, n);
 	}
-	function I() {
-		b &&= (clearTimeout(b), null), S = 0, w = !1, M();
+	function ue() {
+		T &&= (clearTimeout(T), null), Z(), j = 0, N = !1, Q();
+	}
+	function de(e) {
+		A = Number.isFinite(e) && e > 0 ? e : 0, w?.readyState === WebSocket.OPEN ? K() : W();
 	}
-	return M(), {
-		send: N,
-		close: P,
-		reconnect: I,
+	return Q(), {
+		send: ce,
+		close: le,
+		reconnect: ue,
+		setSilenceTimeout: de,
+		opened: R,
 		get status() {
-			return C;
+			return M;
 		}
 	};
 }
 //#endregion
-export { t as createWebSocket };
+export { i as createWebSocket };
 
 //# sourceMappingURL=create-web-socket.js.map