tempest-react-sdk 0.78.0 → 0.80.0

package/dist/webrtc/peer-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"peer-link.js","names":[],"sources":["../../src/webrtc/peer-link.ts"],"sourcesContent":["import type { MeshSlot } from \"./mesh-types\";\n\n/** One remote peer's connection and everything the mesh tracks about it. */\nexport interface PeerLink {\n    peerId: string;\n    pc: RTCPeerConnection;\n    /**\n     * Transceivers in slot order.\n     *\n     * Held explicitly rather than re-read from `getTransceivers()` so slot\n     * lookup stays O(1) and cannot drift if a browser reorders.\n     */\n    transceivers: RTCRtpTransceiver[];\n    /** Candidates that arrived before the remote description they belong to. */\n    pendingCandidates: RTCIceCandidateInit[];\n    /** Whether `setRemoteDescription` has landed, which gates the queue. */\n    remoteReady: boolean;\n    /** Whether an offer is in flight, so a re-entrant call does not stack one. */\n    makingOffer: boolean;\n    /** Whether this side offers. Exactly one side of a link does. */\n    isOfferer: boolean;\n}\n\n/** Open a connection with the policies a mesh needs. */\nexport function createPeerConnection(iceServers: RTCIceServer[]): RTCPeerConnection {\n    return new RTCPeerConnection({\n        iceServers,\n        bundlePolicy: \"max-bundle\",\n        rtcpMuxPolicy: \"require\",\n    });\n}\n\n/**\n * Resolve which slot a transceiver carries.\n *\n * The offerer allocates the m-lines in slot order, so a transceiver's `mid` is\n * its ordinal and both ends read the same one. That makes `mid` the slot's wire\n * identity, and the **only** identifier correct on both sides of a link.\n *\n * Position in the link's own array is a fallback for a `mid` that is not a plain\n * ordinal, and never the primary: a browser answering an offer appends the\n * negotiated transceivers *after* any it already held, so positional lookup\n * silently resolves to the wrong slot — the camera arriving in the screen tile —\n * or to none at all, dropping the track.\n *\n * @param transceiver - The transceiver a track arrived on.\n * @param link - The link it belongs to.\n * @param slots - The mesh's slot list.\n * @returns The slot, or `null` when neither route names one.\n */\nexport function slotOf(\n    transceiver: RTCRtpTransceiver,\n    link: PeerLink,\n    slots: readonly MeshSlot[],\n): MeshSlot | null {\n    const ordinal = Number(transceiver.mid);\n    if (transceiver.mid !== null && Number.isInteger(ordinal) && slots[ordinal]) {\n        return slots[ordinal];\n    }\n    const index = link.transceivers.indexOf(transceiver);\n    return index >= 0 ? (slots[index] ?? null) : null;\n}\n\n/**\n * Feed a link every candidate that arrived before its remote description.\n *\n * `addIceCandidate` throws while `remoteDescription` is `null`, and candidates\n * routinely beat the offer or answer they belong to. Without the queue the\n * connection loses them and sits in `checking` until it times out — a failure\n * with no error anywhere.\n *\n * @param link - The link whose queue is drained.\n */\nexport async function drainCandidates(link: PeerLink): Promise<void> {\n    const queued = link.pendingCandidates.splice(0, link.pendingCandidates.length);\n    for (const candidate of queued) {\n        try {\n            await link.pc.addIceCandidate(candidate);\n        } catch {\n            /* a candidate the browser rejects is not fatal to the connection */\n        }\n    }\n}\n\n/**\n * Hand a candidate to the connection, or park it until the description lands.\n *\n * @param link - The link the candidate belongs to.\n * @param init - The candidate, already in `RTCIceCandidateInit` shape.\n */\nexport async function acceptCandidate(link: PeerLink, init: RTCIceCandidateInit): Promise<void> {\n    if (!link.remoteReady) {\n        link.pendingCandidates.push(init);\n        return;\n    }\n    try {\n        await link.pc.addIceCandidate(init);\n    } catch {\n        /* a candidate the browser rejects is not fatal to the connection */\n    }\n}\n\n/**\n * Adopt the transceivers a remote offer created, in `mid` order.\n *\n * The answering side allocates **nothing** up front, and that is the whole\n * subtlety: applying a remote offer creates one transceiver per m-line, in\n * m-line order, and browsers do not reuse transceivers the answerer made\n * beforehand. Pre-allocating leaves dead, never-negotiated transceivers sitting\n * in front of the live ones, which is how slot lookup ends up pointing at the\n * wrong media or at nothing.\n *\n * Each adopted transceiver is switched to `sendrecv` so this side may publish on\n * it too; without that a peer that answered could hear but never be heard.\n *\n * @param link - The link that just applied a remote offer.\n */\nexport function adoptTransceivers(link: PeerLink): void {\n    link.transceivers = link.pc\n        .getTransceivers()\n        .filter((transceiver) => transceiver.mid !== null)\n        .sort((a, b) => Number(a.mid) - Number(b.mid));\n    for (const transceiver of link.transceivers) {\n        if (transceiver.direction !== \"sendrecv\") transceiver.direction = \"sendrecv\";\n    }\n}\n"],"mappings":";AAwBA,SAAgB,EAAqB,GAA+C;CAChF,OAAO,IAAI,kBAAkB;EACzB;EACA,cAAc;EACd,eAAe;CACnB,CAAC;AACL;AAoBA,SAAgB,EACZ,GACA,GACA,GACe;CACf,IAAM,IAAU,OAAO,EAAY,GAAG;CACtC,IAAI,EAAY,QAAQ,QAAQ,OAAO,UAAU,CAAO,KAAK,EAAM,IAC/D,OAAO,EAAM;CAEjB,IAAM,IAAQ,EAAK,aAAa,QAAQ,CAAW;CACnD,OAAO,KAAS,IAAK,EAAM,MAAU,OAAQ;AACjD;AAYA,eAAsB,EAAgB,GAA+B;CACjE,IAAM,IAAS,EAAK,kBAAkB,OAAO,GAAG,EAAK,kBAAkB,MAAM;CAC7E,KAAK,IAAM,KAAa,GACpB,IAAI;EACA,MAAM,EAAK,GAAG,gBAAgB,CAAS;CAC3C,QAAQ,CAER;AAER;AAQA,eAAsB,EAAgB,GAAgB,GAA0C;CAC5F,IAAI,CAAC,EAAK,aAAa;EACnB,EAAK,kBAAkB,KAAK,CAAI;EAChC;CACJ;CACA,IAAI;EACA,MAAM,EAAK,GAAG,gBAAgB,CAAI;CACtC,QAAQ,CAER;AACJ;AAiBA,SAAgB,EAAkB,GAAsB;CACpD,EAAK,eAAe,EAAK,GACpB,gBAAgB,CAAC,CACjB,QAAQ,MAAgB,EAAY,QAAQ,IAAI,CAAC,CACjD,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,GAAG,CAAC;CACjD,KAAK,IAAM,KAAe,EAAK,cAC3B,AAAI,EAAY,cAAc,eAAY,EAAY,YAAY;AAE1E"}
+{"version":3,"file":"peer-link.js","names":["createPeerConnection","slotOf","ordinal","transceiver","slots","index","link","drainCandidates","queued","candidate","acceptCandidate","init","adoptTransceivers","a","b"],"sources":["../../src/webrtc/peer-link.ts"],"sourcesContent":["import type { MeshSlot } from \"./mesh-types\";\n\n/** One remote peer's connection and everything the mesh tracks about it. */\nexport interface PeerLink {\n    peerId: string;\n    pc: RTCPeerConnection;\n    /**\n     * Transceivers in slot order.\n     *\n     * Held explicitly rather than re-read from `getTransceivers()` so slot\n     * lookup stays O(1) and cannot drift if a browser reorders.\n     */\n    transceivers: RTCRtpTransceiver[];\n    /** Candidates that arrived before the remote description they belong to. */\n    pendingCandidates: RTCIceCandidateInit[];\n    /** Whether `setRemoteDescription` has landed, which gates the queue. */\n    remoteReady: boolean;\n    /** Whether an offer is in flight, so a re-entrant call does not stack one. */\n    makingOffer: boolean;\n    /** Whether this side offers. Exactly one side of a link does. */\n    isOfferer: boolean;\n}\n\n/** Open a connection with the policies a mesh needs. */\nexport function createPeerConnection(iceServers: RTCIceServer[]): RTCPeerConnection {\n    return new RTCPeerConnection({\n        iceServers,\n        bundlePolicy: \"max-bundle\",\n        rtcpMuxPolicy: \"require\",\n    });\n}\n\n/**\n * Resolve which slot a transceiver carries.\n *\n * The offerer allocates the m-lines in slot order, so a transceiver's `mid` is\n * its ordinal and both ends read the same one. That makes `mid` the slot's wire\n * identity, and the **only** identifier correct on both sides of a link.\n *\n * Position in the link's own array is a fallback for a `mid` that is not a plain\n * ordinal, and never the primary: a browser answering an offer appends the\n * negotiated transceivers *after* any it already held, so positional lookup\n * silently resolves to the wrong slot — the camera arriving in the screen tile —\n * or to none at all, dropping the track.\n *\n * @param transceiver - The transceiver a track arrived on.\n * @param link - The link it belongs to.\n * @param slots - The mesh's slot list.\n * @returns The slot, or `null` when neither route names one.\n */\nexport function slotOf(\n    transceiver: RTCRtpTransceiver,\n    link: PeerLink,\n    slots: readonly MeshSlot[],\n): MeshSlot | null {\n    const ordinal = Number(transceiver.mid);\n    if (transceiver.mid !== null && Number.isInteger(ordinal) && slots[ordinal]) {\n        return slots[ordinal];\n    }\n    const index = link.transceivers.indexOf(transceiver);\n    return index >= 0 ? (slots[index] ?? null) : null;\n}\n\n/**\n * Feed a link every candidate that arrived before its remote description.\n *\n * `addIceCandidate` throws while `remoteDescription` is `null`, and candidates\n * routinely beat the offer or answer they belong to. Without the queue the\n * connection loses them and sits in `checking` until it times out — a failure\n * with no error anywhere.\n *\n * @param link - The link whose queue is drained.\n */\nexport async function drainCandidates(link: PeerLink): Promise<void> {\n    const queued = link.pendingCandidates.splice(0, link.pendingCandidates.length);\n    for (const candidate of queued) {\n        try {\n            await link.pc.addIceCandidate(candidate);\n        } catch {\n            /* a candidate the browser rejects is not fatal to the connection */\n        }\n    }\n}\n\n/**\n * Hand a candidate to the connection, or park it until the description lands.\n *\n * @param link - The link the candidate belongs to.\n * @param init - The candidate, already in `RTCIceCandidateInit` shape.\n */\nexport async function acceptCandidate(link: PeerLink, init: RTCIceCandidateInit): Promise<void> {\n    if (!link.remoteReady) {\n        link.pendingCandidates.push(init);\n        return;\n    }\n    try {\n        await link.pc.addIceCandidate(init);\n    } catch {\n        /* a candidate the browser rejects is not fatal to the connection */\n    }\n}\n\n/**\n * Adopt the transceivers a remote offer created, in `mid` order.\n *\n * The answering side allocates **nothing** up front, and that is the whole\n * subtlety: applying a remote offer creates one transceiver per m-line, in\n * m-line order, and browsers do not reuse transceivers the answerer made\n * beforehand. Pre-allocating leaves dead, never-negotiated transceivers sitting\n * in front of the live ones, which is how slot lookup ends up pointing at the\n * wrong media or at nothing.\n *\n * Each adopted transceiver is switched to `sendrecv` so this side may publish on\n * it too; without that a peer that answered could hear but never be heard.\n *\n * @param link - The link that just applied a remote offer.\n */\nexport function adoptTransceivers(link: PeerLink): void {\n    link.transceivers = link.pc\n        .getTransceivers()\n        .filter((transceiver) => transceiver.mid !== null)\n        .sort((a, b) => Number(a.mid) - Number(b.mid));\n    for (const transceiver of link.transceivers) {\n        if (transceiver.direction !== \"sendrecv\") transceiver.direction = \"sendrecv\";\n    }\n}\n"],"mappings":";AAwBA,SAAgBA,EAAqB,GAA+C;CAChF,OAAO,IAAI,kBAAkB;EACzB;EACA,cAAc;EACd,eAAe;CACnB,CAAC;AACL;AAoBA,SAAgBC,EACZ,GACA,GACA,GACe;CACf,IAAMC,IAAU,OAAOC,EAAY,GAAG;CACtC,IAAIA,EAAY,QAAQ,QAAQ,OAAO,UAAUD,CAAO,KAAKE,EAAMF,IAC/D,OAAOE,EAAMF;CAEjB,IAAMG,IAAQC,EAAK,aAAa,QAAQH,CAAW;CACnD,OAAOE,KAAS,IAAKD,EAAMC,MAAU,OAAQ;AACjD;AAYA,eAAsBE,EAAgB,GAA+B;CACjE,IAAMC,IAASF,EAAK,kBAAkB,OAAO,GAAGA,EAAK,kBAAkB,MAAM;CAC7E,KAAK,IAAMG,KAAaD,GACpB,IAAI;EACA,MAAMF,EAAK,GAAG,gBAAgBG,CAAS;CAC3C,QAAQ,CAER;AAER;AAQA,eAAsBC,EAAgB,GAAgB,GAA0C;CAC5F,IAAI,CAACJ,EAAK,aACN,EAAK,kBAAkB,KAAKK,CAAI;MAGpC,IAAI;EACA,MAAML,EAAK,GAAG,gBAAgBK,CAAI;CACtC,QAAQ,CAER;AACJ;AAiBA,SAAgBC,EAAkB,GAAsB;CACpD,EAAK,eAAeN,EAAK,GACpB,gBAAgB,CAAC,CACjB,QAAQ,MAAgBH,EAAY,QAAQ,IAAI,CAAC,CACjD,MAAM,GAAG,MAAM,OAAOU,EAAE,GAAG,IAAI,OAAOC,EAAE,GAAG,CAAC;CACjD,KAAK,IAAMX,KAAeG,EAAK,cAC3B,AAAIH,EAAY,cAAc,eAAY,EAAY,YAAY;AAE1E"}

package/dist/webrtc/peer-mesh.cjs

@@ -1,2 +1,2 @@
-const e=require("./link-stats.cjs"),t=require("./mesh-quality.cjs"),n=require("./peer-link.cjs");var r=Symbol(`gone`);function i(i){let{slots:a,send:o}=i,s=new Map,c=new Map,l=new Map,u=new Map,d=i.iceServers??[],f=i.setLocalDescription??((e,t)=>e.setLocalDescription(t)),p=i.quality??{},m=!1,h=new Map,g=null,_=()=>Object.fromEntries(a.map(e=>[e.name,null])),v=()=>{i.onPeers?.([...c.values()].map(e=>({...e})))},y=e=>!m&&s.get(e.peerId)===e,b=async(e,t)=>{try{let n=await t;return y(e)?n:r}catch(t){if(!y(e))return r;throw t}},x=async t=>{if(m)return;let n=!1;for(let r of[...s.values()]){if(r.pc.connectionState!==`connected`)continue;let i=h.get(r.peerId);i===void 0&&(i=e.createLinkStatsSampler(t.kind===void 0?{}:{kind:t.kind}),h.set(r.peerId,i));let a;try{a=await i.sample(r.pc)}catch{continue}let o=c.get(r.peerId);y(r)&&o!==void 0&&(o.stats=a,n=!0,t.onStats?.(r.peerId,a))}n&&v()},S=()=>{let e=i.stats;if(e===void 0)return;let t=!m&&s.size>0;if(t&&g===null){g=setInterval(()=>void x(e),e.intervalMs??2e3);return}!t&&g!==null&&(clearInterval(g),g=null)},C=()=>{if(m)return;let e=[...s.values()].map(e=>e.pc.connectionState);e.some(e=>e===`connected`)?i.onState?.(`connected`):e.length>0?i.onState?.(`connecting`,`negotiating`):i.onState?.(`connected`,`alone`)},w=async e=>{if(m)return;p=e;let n=t.scaleForRoom(e,s.size),r=t.resolveDegradation(e,n);for(let e of s.values())await t.applyQualityToLink(e.transceivers,a,n,r)},T=async e=>{if(!e.makingOffer){e.makingOffer=!0;try{let t=await e.pc.createOffer();if(!y(e))return;if(!t.sdp){i.onNotice?.(`empty_local_offer_sdp`);return}if(await f(e.pc,t),!y(e))return;o({type:`offer`,to:e.peerId,sdp:e.pc.localDescription?.sdp??t.sdp})}catch{y(e)&&i.onNotice?.(`offer_failed`)}finally{e.makingOffer=!1}}},E=e=>e.streams?.[0]||(typeof MediaStream>`u`?null:new MediaStream([e.track])),D=(e,t)=>{let r=n.slotOf(t.transceiver,e,a),i=c.get(e.peerId);r&&i&&(i.streams={...i.streams,[r.name]:E(t)},t.track.onended=()=>{let t=c.get(e.peerId);t&&(t.streams={...t.streams,[r.name]:null},v())},v())},O=(e,t)=>{let n=(u.get(e)??Promise.resolve()).then(t);return u.set(e,n),n},k=async(e,t,n)=>{let r=e.transceivers[n];if(r&&y(e))try{await r.sender.replaceTrack(l.get(t)??null)}catch{return}},A=e=>Promise.all(a.map((t,n)=>O(t.name,()=>k(e,t.name,n)))),j=e=>{if(m)return;let t=s.get(e);t&&(t.pc.close(),s.delete(e)),c.delete(e),h.delete(e),w(p),S(),v(),C()},M=async(e,{offerer:t})=>{if(m||s.has(e))return;let r=n.createPeerConnection(d),i=[];if(t)try{i=a.map(e=>r.addTransceiver(e.kind,{direction:`sendrecv`}))}catch(e){throw r.close(),e}let l={peerId:e,pc:r,transceivers:i,pendingCandidates:[],remoteReady:!1,makingOffer:!1,isOfferer:t};s.set(e,l),c.set(e,{peerId:e,connection:r.connectionState,streams:c.get(e)?.streams??_()}),!(t&&(await A(l),!y(l)))&&(r.onicecandidate=t=>{o({type:`ice`,to:e,candidate:t.candidate?.candidate??null,sdpMid:t.candidate?.sdpMid??null,sdpMLineIndex:t.candidate?.sdpMLineIndex??null})},r.ontrack=e=>D(l,e),r.onconnectionstatechange=()=>{if(!y(l))return;let t=c.get(e);if(t&&(t.connection=r.connectionState),r.connectionState===`failed`||r.connectionState===`closed`){j(e);return}v(),C()},r.onnegotiationneeded=()=>{l.isOfferer&&T(l)},S(),v(),C(),t&&await T(l))},N=async(e,t)=>{s.has(e)||await M(e,{offerer:!1});let a=s.get(e);if(!a||!y(a)||await b(a,a.pc.setRemoteDescription({type:`offer`,sdp:t}))===r||(a.remoteReady=!0,await n.drainCandidates(a),a.isOfferer||(n.adoptTransceivers(a),await A(a)),!y(a)))return;let c=await b(a,a.pc.createAnswer());if(c!==r){if(!c.sdp){i.onNotice?.(`empty_local_answer_sdp`);return}await b(a,f(a.pc,c))!==r&&(o({type:`answer`,to:e,sdp:a.pc.localDescription?.sdp??c.sdp}),await w(p))}};return i.onState?.(`connecting`,`signaling`),{addPeer:M,removePeer:j,accept:async e=>{if(m)return;if(e.type===`offer`){await N(e.from,e.sdp);return}let t=s.get(e.from);if(t){if(e.type===`answer`){let i=t.pc.setRemoteDescription({type:`answer`,sdp:e.sdp});if(await b(t,i)===r)return;t.remoteReady=!0,await n.drainCandidates(t),await w(p);return}e.candidate!==null&&await n.acceptCandidate(t,{candidate:e.candidate,sdpMid:e.sdpMid??void 0,sdpMLineIndex:e.sdpMLineIndex??void 0})}},setLocalTrack:async(e,t)=>{if(m)return;l.set(e,t);let n=a.findIndex(t=>t.name===e);n<0||(await O(e,async()=>{for(let t of[...s.values()])await k(t,e,n)}),await w(p))},applyQuality:w,setIceServers:e=>{d=e},stop:()=>{if(!m){m=!0;for(let e of s.values())e.pc.close();s.clear(),c.clear(),h.clear(),l.clear(),S(),v(),i.onState?.(`closed`)}},getConnection:e=>s.get(e)?.pc??null,get peers(){return[...c.values()].map(e=>({...e}))}}}exports.createPeerMesh=i;
+const e=require("./link-stats.cjs"),t=require("./mesh-quality.cjs"),n=require("./peer-link.cjs");var r=Symbol(`gone`);function i(i){let{slots:a,send:o}=i,s=new Map,c=new Map,l=new Map,u=new Map,d=i.iceServers??[],f=i.setLocalDescription??((e,t)=>e.setLocalDescription(t)),p=i.quality??{},m=!1,h=new Map,g=null,_=()=>Object.fromEntries(a.map(e=>[e.name,null])),v=()=>{i.onPeers?.([...c.values()].map(e=>({...e})))},y=e=>!m&&s.get(e.peerId)===e,b=async(e,t)=>{try{let n=await t;return y(e)?n:r}catch(t){if(!y(e))return r;throw t}},x=async t=>{if(m)return;let n=!1;for(let r of[...s.values()]){if(r.pc.connectionState!==`connected`)continue;let i=h.get(r.peerId);i===void 0&&(i=e.createLinkStatsSampler(t.kind===void 0?{}:{kind:t.kind}),h.set(r.peerId,i));let a;try{a=await i.sample(r.pc)}catch{continue}let o=c.get(r.peerId);y(r)&&o!==void 0&&(o.stats=a,n=!0,t.onStats?.(r.peerId,a))}n&&v()},S=()=>{let e=i.stats;if(e===void 0)return;let t=!m&&s.size>0;t&&g===null?g=setInterval(()=>void x(e),e.intervalMs??2e3):!t&&g!==null&&(clearInterval(g),g=null)},C=()=>{if(m)return;let e=[...s.values()].map(e=>e.pc.connectionState);e.some(e=>e===`connected`)?i.onState?.(`connected`):e.length>0?i.onState?.(`connecting`,`negotiating`):i.onState?.(`connected`,`alone`)},w=async e=>{if(m)return;p=e;let n=t.scaleForRoom(e,s.size),r=t.resolveDegradation(e,n);for(let e of s.values())await t.applyQualityToLink(e.transceivers,a,n,r)},T=async e=>{if(!e.makingOffer){e.makingOffer=!0;try{let t=await e.pc.createOffer();if(!y(e))return;if(!t.sdp){i.onNotice?.(`empty_local_offer_sdp`);return}if(await f(e.pc,t),!y(e))return;o({type:`offer`,to:e.peerId,sdp:e.pc.localDescription?.sdp??t.sdp})}catch{y(e)&&i.onNotice?.(`offer_failed`)}finally{e.makingOffer=!1}}},E=e=>e.streams?.[0]||(typeof MediaStream>`u`?null:new MediaStream([e.track])),D=(e,t)=>{let r=n.slotOf(t.transceiver,e,a),i=c.get(e.peerId);r&&i&&(i.streams={...i.streams,[r.name]:E(t)},t.track.onended=()=>{let t=c.get(e.peerId);t&&(t.streams={...t.streams,[r.name]:null},v())},v())},O=(e,t)=>{let n=(u.get(e)??Promise.resolve()).then(t);return u.set(e,n),n},k=async(e,t,n)=>{let r=e.transceivers[n];if(r&&y(e))try{await r.sender.replaceTrack(l.get(t)??null)}catch{return}},A=e=>Promise.all(a.map((t,n)=>O(t.name,()=>k(e,t.name,n)))),j=e=>{if(m)return;let t=s.get(e);t&&(t.pc.close(),s.delete(e)),c.delete(e),h.delete(e),w(p),S(),v(),C()},M=async(e,{offerer:t})=>{if(m||s.has(e))return;let r=n.createPeerConnection(d),i=[];if(t)try{i=a.map(e=>r.addTransceiver(e.kind,{direction:`sendrecv`}))}catch(e){throw r.close(),e}let l={peerId:e,pc:r,transceivers:i,pendingCandidates:[],remoteReady:!1,makingOffer:!1,isOfferer:t};s.set(e,l),c.set(e,{peerId:e,connection:r.connectionState,streams:c.get(e)?.streams??_()}),!(t&&(await A(l),!y(l)))&&(r.onicecandidate=t=>{o({type:`ice`,to:e,candidate:t.candidate?.candidate??null,sdpMid:t.candidate?.sdpMid??null,sdpMLineIndex:t.candidate?.sdpMLineIndex??null})},r.ontrack=e=>D(l,e),r.onconnectionstatechange=()=>{if(!y(l))return;let t=c.get(e);t&&(t.connection=r.connectionState),r.connectionState===`failed`||r.connectionState===`closed`?j(e):(v(),C())},r.onnegotiationneeded=()=>{l.isOfferer&&T(l)},S(),v(),C(),t&&await T(l))},N=async(e,t)=>{s.has(e)||await M(e,{offerer:!1});let a=s.get(e);if(!a||!y(a)||await b(a,a.pc.setRemoteDescription({type:`offer`,sdp:t}))===r||(a.remoteReady=!0,await n.drainCandidates(a),a.isOfferer||(n.adoptTransceivers(a),await A(a)),!y(a)))return;let c=await b(a,a.pc.createAnswer());c!==r&&(c.sdp?await b(a,f(a.pc,c))!==r&&(o({type:`answer`,to:e,sdp:a.pc.localDescription?.sdp??c.sdp}),await w(p)):i.onNotice?.(`empty_local_answer_sdp`))};return i.onState?.(`connecting`,`signaling`),{addPeer:M,removePeer:j,accept:async e=>{if(m)return;if(e.type===`offer`){await N(e.from,e.sdp);return}let t=s.get(e.from);if(t){if(e.type===`answer`){let i=t.pc.setRemoteDescription({type:`answer`,sdp:e.sdp});if(await b(t,i)===r)return;t.remoteReady=!0,await n.drainCandidates(t),await w(p)}else e.candidate!==null&&await n.acceptCandidate(t,{candidate:e.candidate,sdpMid:e.sdpMid??void 0,sdpMLineIndex:e.sdpMLineIndex??void 0})}},setLocalTrack:async(e,t)=>{if(m)return;l.set(e,t);let n=a.findIndex(t=>t.name===e);n<0||(await O(e,async()=>{for(let t of[...s.values()])await k(t,e,n)}),await w(p))},applyQuality:w,setIceServers:e=>{d=e},stop:()=>{if(!m){m=!0;for(let e of s.values())e.pc.close();s.clear(),c.clear(),h.clear(),l.clear(),S(),v(),i.onState?.(`closed`)}},getConnection:e=>s.get(e)?.pc??null,get peers(){return[...c.values()].map(e=>({...e}))}}}exports.createPeerMesh=i;
 //# sourceMappingURL=peer-mesh.cjs.map

package/dist/webrtc/peer-mesh.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"peer-mesh.cjs","names":[],"sources":["../../src/webrtc/peer-mesh.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the mesh is one object's lifetime: a link's\n * transceivers, the offer it owes, the tracks published on it and the share of\n * the uplink it costs all change together, and every method here reads or writes\n * the same two maps. The pieces that *could* stand alone already do —\n * `peer-link.ts` for the per-connection mechanics and `mesh-quality.ts` for the\n * division — and what is left is the coordination between them.\n */\nimport { applyQualityToLink, resolveDegradation, scaleForRoom } from \"./mesh-quality\";\nimport {\n    acceptCandidate,\n    adoptTransceivers,\n    createPeerConnection,\n    drainCandidates,\n    slotOf,\n    type PeerLink,\n} from \"./peer-link\";\nimport { createLinkStatsSampler, type LinkStats, type LinkStatsSampler } from \"./link-stats\";\nimport type {\n    MeshMessage,\n    MeshPeer,\n    MeshQuality,\n    MeshStatsOptions,\n    PeerMeshOptions,\n} from \"./mesh-types\";\n\n/** What {@link createPeerMesh}'s negotiation steps return once their link is gone. */\nconst GONE = Symbol(\"gone\");\n\n/** A running mesh. */\nexport interface PeerMesh {\n    /**\n     * Open a link to a peer.\n     *\n     * `offerer` decides which side sends the offer, and exactly one side of each\n     * link must say `true`. Drive it from the arrival order your server already\n     * imposes — the peer that joined **later** offers, the one already in the\n     * room answers. That avoids glare by construction, without the rollback\n     * dance of perfect negotiation and without depending on a browser\n     * implementing argument-less `setLocalDescription`.\n     */\n    addPeer: (peerId: string, options: { offerer: boolean }) => Promise<void>;\n    /** Close one link and give its share of the uplink back to the others. */\n    removePeer: (peerId: string) => void;\n    /** Feed the mesh an `offer`, `answer` or `ice` message from `from`. */\n    accept: (message: MeshMessage & { from: string }) => Promise<void>;\n    /**\n     * Publish or retract one slot across every live link.\n     *\n     * `null` retracts: the sender keeps its negotiated transceiver and stops\n     * producing, which is what mutes a microphone without disturbing the other\n     * slots or the connection. Nothing renegotiates — the m-lines were allocated\n     * before any track existed, which is what makes a mesh survive toggling: a\n     * renegotiation per toggle is N-1 simultaneous offer/answer rounds every time\n     * somebody unmutes.\n     */\n    setLocalTrack: (slot: string, track: MediaStreamTrack | null) => Promise<void>;\n    /** Apply encoder limits, divided by the current size of the room. */\n    applyQuality: (quality: MeshQuality) => Promise<void>;\n    /** Replace the ICE servers used for links opened from now on. */\n    setIceServers: (servers: RTCIceServer[]) => void;\n    /**\n     * Close every link, forget the local tracks and report `closed` — for good.\n     *\n     * Stopping is terminal. The signalling socket usually outlives the call, so\n     * an offer still in flight from a former participant, or from anyone the\n     * server relays to this user, keeps reaching {@link PeerMesh.accept} after\n     * the hang-up. A stopped mesh drops it: no connection is opened, nothing is\n     * answered and no track is published, so a call that reports `closed` never\n     * sends the microphone or camera again. The same holds for `addPeer`,\n     * `setLocalTrack` and `applyQuality`, and for every negotiation that was\n     * already awaiting the browser when `stop()` ran. Calling it twice is a\n     * no-op.\n     *\n     * The tracks themselves are not stopped: they belong to the caller, who may\n     * still be showing them in a preview or reusing them on the next call. To\n     * join again, create a new mesh.\n     */\n    stop: () => void;\n    /** The peers as the mesh currently sees them. */\n    readonly peers: MeshPeer[];\n    /**\n     * The connection carrying one peer's link, or `null`.\n     *\n     * The escape hatch for everything this mesh does not model. `getStats()`,\n     * `getSenders()`, an `RTCDataChannel`, an encoding tweak the `quality`\n     * shape has no field for — all of it lives on the connection, and a mesh\n     * that keeps it private turns adopting the mesh into losing a feature.\n     *\n     * {@link MeshPeer.connection} is the *state*, which is what a view needs;\n     * this is the object, which is what a measurement needs. For the common\n     * case of measuring, {@link PeerMeshOptions.stats} spares you the loop —\n     * including the one-sampler-per-connection rule that a hand-rolled version\n     * gets wrong.\n     *\n     * @param peerId - The id the peer was added under.\n     * @returns The connection, or `null` when there is no link for that id.\n     */\n    getConnection: (peerId: string) => RTCPeerConnection | null;\n}\n\n/**\n * One `RTCPeerConnection` per peer, with the slots negotiated up front.\n *\n * The signalling protocol stays yours: this produces and accepts three message\n * shapes (`offer`, `answer`, `ice`) and leaves delivery, room membership and\n * identity to your server. What it owns is the part that is the same in every\n * mesh and wrong in most of them — see {@link PeerMesh} for the traps each\n * method exists to avoid.\n *\n * @param options - See {@link PeerMeshOptions}.\n * @returns The mesh.\n *\n * @example\n * const mesh = createPeerMesh({\n *     slots: [\n *         { name: \"mic\", kind: \"audio\" },\n *         { name: \"cam\", kind: \"video\" },\n *     ],\n *     send: (message) => socket.send(message),\n *     onPeers: setPeers,\n * });\n * socket.onMessage = (message) => void mesh.accept(message);\n * await mesh.addPeer(\"peer-2\", { offerer: true });\n * await mesh.setLocalTrack(\"mic\", micTrack);\n */\nexport function createPeerMesh(options: PeerMeshOptions): PeerMesh {\n    const { slots, send } = options;\n    const links = new Map<string, PeerLink>();\n    const peers = new Map<string, MeshPeer>();\n    const localTracks = new Map<string, MediaStreamTrack | null>();\n    const slotWrites = new Map<string, Promise<void>>();\n    let iceServers = options.iceServers ?? [];\n    const describe =\n        options.setLocalDescription ??\n        ((connection: RTCPeerConnection, description: RTCSessionDescriptionInit) =>\n            connection.setLocalDescription(description));\n    let quality: MeshQuality = options.quality ?? {};\n    let stopped = false;\n    const samplers = new Map<string, LinkStatsSampler>();\n    let statsTimer: ReturnType<typeof setInterval> | null = null;\n\n    const emptyStreams = (): Record<string, MediaStream | null> =>\n        Object.fromEntries(slots.map((slot) => [slot.name, null]));\n\n    const emitPeers = (): void => {\n        options.onPeers?.([...peers.values()].map((peer) => ({ ...peer })));\n    };\n\n    /**\n     * Whether a link is still the one the mesh holds for its peer.\n     *\n     * Every negotiation step awaits the browser, and `stop()` or `removePeer()`\n     * can close the link inside any of those awaits. A continuation that does\n     * not re-check keeps negotiating on a closed connection — which a browser\n     * answers with `InvalidStateError` — or, worse, signals an answer for a call\n     * that already hung up.\n     *\n     * @param link - The link a continuation is about to touch.\n     * @returns `false` once the mesh stopped or the link was removed or replaced.\n     */\n    const isLive = (link: PeerLink): boolean => !stopped && links.get(link.peerId) === link;\n\n    /**\n     * Await one negotiation step, and tell the caller whether to go on.\n     *\n     * A browser settles a call that `close()` ran under in one of two ways:\n     * it rejects with `InvalidStateError`, or — what Chromium was measured\n     * doing — it never settles at all. The second needs nothing here; the\n     * first would surface as a rejected `accept()`, which the documented\n     * `void mesh.accept(message)` wiring turns into an unhandled rejection\n     * for a call that already hung up. So a rejection on a link that is no\n     * longer live is swallowed, and one on a live link is rethrown untouched.\n     *\n     * @param link - The link the step negotiates on.\n     * @param step - The pending browser call.\n     * @returns The step's value, or {@link GONE} when the link stopped being live.\n     */\n    const whileLive = async <T>(link: PeerLink, step: Promise<T>): Promise<T | typeof GONE> => {\n        try {\n            const value = await step;\n            return isLive(link) ? value : GONE;\n        } catch (error) {\n            if (!isLive(link)) return GONE;\n            throw error;\n        }\n    };\n\n    /**\n     * Sample every connected link once.\n     *\n     * Only `connected` links are asked. A link still gathering candidates has\n     * no traffic to measure, and asking anyway spends a `getStats()` round trip\n     * to learn that — per link, on every tick.\n     *\n     * `settings` arrives as an argument rather than being read from `options`\n     * here: the timer is only ever armed past the check that they exist, so\n     * reading them again would add a branch that nothing can reach.\n     *\n     * Each link is sampled on its own: a `getStats()` that rejects — a link\n     * closing under the call does that — skips that link for this tick and\n     * leaves the others measured. Across the await the link is re-checked by\n     * identity, not by id: a peer removed and re-added under the same id holds\n     * a new connection, and the old one's sample must not land on it.\n     *\n     * @param settings - The measuring options, already known to be present.\n     */\n    const sampleLinks = async (settings: MeshStatsOptions): Promise<void> => {\n        if (stopped) return;\n        let changed = false;\n\n        for (const link of [...links.values()]) {\n            if (link.pc.connectionState !== \"connected\") continue;\n            let sampler = samplers.get(link.peerId);\n            if (sampler === undefined) {\n                sampler = createLinkStatsSampler(\n                    settings.kind === undefined ? {} : { kind: settings.kind },\n                );\n                samplers.set(link.peerId, sampler);\n            }\n            let stats: LinkStats;\n            try {\n                stats = await sampler.sample(link.pc);\n            } catch {\n                continue;\n            }\n            const peer = peers.get(link.peerId);\n            if (!isLive(link) || peer === undefined) continue;\n            peer.stats = stats;\n            changed = true;\n            settings.onStats?.(link.peerId, stats);\n        }\n\n        if (changed) emitPeers();\n    };\n\n    /**\n     * Keep the timer alive exactly while there is something to measure.\n     *\n     * One timer for the whole mesh, not one per peer — and none at all in an\n     * empty room, which is where a call sits for as long as the first person is\n     * early.\n     */\n    const syncStatsTimer = (): void => {\n        const settings = options.stats;\n        if (settings === undefined) return;\n        const wanted = !stopped && links.size > 0;\n        if (wanted && statsTimer === null) {\n            statsTimer = setInterval(() => void sampleLinks(settings), settings.intervalMs ?? 2000);\n            return;\n        }\n        if (!wanted && statsTimer !== null) {\n            clearInterval(statsTimer);\n            statsTimer = null;\n        }\n    };\n\n    /**\n     * Collapse the per-link states into the one badge a call shows.\n     *\n     * No links at all is `connected`, not a failure: it means nobody else is in\n     * the room yet, which is a legitimate state a call sits in for as long as the\n     * first person is early.\n     */\n    const refreshState = (): void => {\n        if (stopped) return;\n        const states = [...links.values()].map((link) => link.pc.connectionState);\n        if (states.some((state) => state === \"connected\")) options.onState?.(\"connected\");\n        else if (states.length > 0) options.onState?.(\"connecting\", \"negotiating\");\n        else options.onState?.(\"connected\", \"alone\");\n    };\n\n    const applyQuality = async (next: MeshQuality): Promise<void> => {\n        if (stopped) return;\n        quality = next;\n        const effective = scaleForRoom(next, links.size);\n        const degradation = resolveDegradation(next, effective);\n        for (const link of links.values()) {\n            await applyQualityToLink(link.transceivers, slots, effective, degradation);\n        }\n    };\n\n    const makeOffer = async (link: PeerLink): Promise<void> => {\n        if (link.makingOffer) return;\n        link.makingOffer = true;\n        try {\n            const offer = await link.pc.createOffer();\n            if (!isLive(link)) return;\n            if (!offer.sdp) {\n                options.onNotice?.(\"empty_local_offer_sdp\");\n                return;\n            }\n            await describe(link.pc, offer);\n            if (!isLive(link)) return;\n            send({\n                type: \"offer\",\n                to: link.peerId,\n                sdp: link.pc.localDescription?.sdp ?? offer.sdp,\n            });\n        } catch {\n            if (isLive(link)) options.onNotice?.(\"offer_failed\");\n        } finally {\n            link.makingOffer = false;\n        }\n    };\n\n    /**\n     * Wrap an inbound track in the stream the caller renders.\n     *\n     * The event's own stream is preferred: it is the one the sending side\n     * grouped the track into, so a caller that reads `stream.id` sees what the\n     * peer published rather than a wrapper invented here. Browsers only fill it\n     * when the offer named a stream, hence the fallback — and the guard after\n     * that is for a runtime with no `MediaStream` at all, where routing still\n     * has to not throw.\n     */\n    const streamFor = (event: RTCTrackEvent): MediaStream | null => {\n        const provided = event.streams?.[0];\n        if (provided) return provided;\n        return typeof MediaStream === \"undefined\" ? null : new MediaStream([event.track]);\n    };\n\n    const attachRemoteTrack = (link: PeerLink, event: RTCTrackEvent): void => {\n        const slot = slotOf(event.transceiver, link, slots);\n        const peer = peers.get(link.peerId);\n        if (!slot || !peer) return;\n\n        peer.streams = { ...peer.streams, [slot.name]: streamFor(event) };\n        event.track.onended = (): void => {\n            const current = peers.get(link.peerId);\n            if (!current) return;\n            current.streams = { ...current.streams, [slot.name]: null };\n            emitPeers();\n        };\n        emitPeers();\n    };\n\n    /**\n     * Queue one write behind every earlier write to the same slot.\n     *\n     * Every write that puts a local track on a sender goes through here — the\n     * fan-out of `setLocalTrack` and the first write onto a link that just\n     * got its transceivers alike. Two writes to one slot therefore never run\n     * at once, and a write queued later always finishes later.\n     *\n     * @param slot - The slot name.\n     * @param write - The write to run once the earlier ones have finished.\n     * @returns The queued write.\n     */\n    const enqueueWrite = (slot: string, write: () => Promise<void>): Promise<void> => {\n        const queued = (slotWrites.get(slot) ?? Promise.resolve()).then(write);\n        slotWrites.set(slot, queued);\n        return queued;\n    };\n\n    /**\n     * Put a slot's current track on one link's sender.\n     *\n     * The track is read when the write runs, not when it was queued, so the\n     * last `setLocalTrack` wins whichever write lands last. A refusal\n     * belongs to a link that is tearing down, whose state handler removes it,\n     * so it is not an error here.\n     *\n     * @param link - The link to write onto.\n     * @param slot - The slot name.\n     * @param index - The slot's position in `slots`, which is its transceiver.\n     */\n    const writeSlot = async (link: PeerLink, slot: string, index: number): Promise<void> => {\n        const transceiver = link.transceivers[index];\n        if (!transceiver || !isLive(link)) return;\n        try {\n            await transceiver.sender.replaceTrack(localTracks.get(slot) ?? null);\n        } catch {\n            return;\n        }\n    };\n\n    /**\n     * Publish every held local track onto a link whose transceivers now exist.\n     *\n     * Up front for the offerer, after the offer lands for the answerer, so a\n     * microphone that was already live when the peer joined starts flowing\n     * without waiting for a toggle. Each slot's write joins that slot's queue,\n     * so a mute issued while it is in flight still has the last word.\n     *\n     * @param link - The link to publish onto.\n     */\n    const attachLocalTracks = (link: PeerLink): Promise<unknown> =>\n        Promise.all(\n            slots.map((slot, index) =>\n                enqueueWrite(slot.name, () => writeSlot(link, slot.name, index)),\n            ),\n        );\n\n    const removePeer = (peerId: string): void => {\n        if (stopped) return;\n        const link = links.get(peerId);\n        if (link) {\n            link.pc.close();\n            links.delete(peerId);\n        }\n        peers.delete(peerId);\n        samplers.delete(peerId);\n        void applyQuality(quality);\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n    };\n\n    const addPeer = async (peerId: string, { offerer }: { offerer: boolean }): Promise<void> => {\n        if (stopped || links.has(peerId)) return;\n\n        const pc = createPeerConnection(iceServers);\n        let transceivers: RTCRtpTransceiver[] = [];\n        if (offerer) {\n            try {\n                transceivers = slots.map((slot) =>\n                    pc.addTransceiver(slot.kind, { direction: \"sendrecv\" }),\n                );\n            } catch (error) {\n                pc.close();\n                throw error;\n            }\n        }\n        const link: PeerLink = {\n            peerId,\n            pc,\n            transceivers,\n            pendingCandidates: [],\n            remoteReady: false,\n            makingOffer: false,\n            isOfferer: offerer,\n        };\n        links.set(peerId, link);\n        peers.set(peerId, {\n            peerId,\n            connection: pc.connectionState,\n            streams: peers.get(peerId)?.streams ?? emptyStreams(),\n        });\n\n        if (offerer) {\n            await attachLocalTracks(link);\n            if (!isLive(link)) return;\n        }\n\n        pc.onicecandidate = (event): void => {\n            send({\n                type: \"ice\",\n                to: peerId,\n                candidate: event.candidate?.candidate ?? null,\n                sdpMid: event.candidate?.sdpMid ?? null,\n                sdpMLineIndex: event.candidate?.sdpMLineIndex ?? null,\n            });\n        };\n\n        pc.ontrack = (event): void => attachRemoteTrack(link, event);\n\n        pc.onconnectionstatechange = (): void => {\n            if (!isLive(link)) return;\n            const peer = peers.get(peerId);\n            if (peer) peer.connection = pc.connectionState;\n            if (pc.connectionState === \"failed\" || pc.connectionState === \"closed\") {\n                removePeer(peerId);\n                return;\n            }\n            emitPeers();\n            refreshState();\n        };\n\n        pc.onnegotiationneeded = (): void => {\n            if (link.isOfferer) void makeOffer(link);\n        };\n\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n        if (offerer) await makeOffer(link);\n    };\n\n    const acceptOffer = async (from: string, sdp: string): Promise<void> => {\n        if (!links.has(from)) await addPeer(from, { offerer: false });\n        const link = links.get(from);\n        if (!link || !isLive(link)) return;\n\n        if (\n            (await whileLive(link, link.pc.setRemoteDescription({ type: \"offer\", sdp }))) === GONE\n        ) {\n            return;\n        }\n        link.remoteReady = true;\n        await drainCandidates(link);\n\n        if (!link.isOfferer) {\n            adoptTransceivers(link);\n            await attachLocalTracks(link);\n        }\n        if (!isLive(link)) return;\n\n        const answer = await whileLive(link, link.pc.createAnswer());\n        if (answer === GONE) return;\n        if (!answer.sdp) {\n            options.onNotice?.(\"empty_local_answer_sdp\");\n            return;\n        }\n        if ((await whileLive(link, describe(link.pc, answer))) === GONE) return;\n        send({ type: \"answer\", to: from, sdp: link.pc.localDescription?.sdp ?? answer.sdp });\n        await applyQuality(quality);\n    };\n\n    const accept = async (message: MeshMessage & { from: string }): Promise<void> => {\n        if (stopped) return;\n        if (message.type === \"offer\") {\n            await acceptOffer(message.from, message.sdp);\n            return;\n        }\n\n        const link = links.get(message.from);\n        if (!link) return;\n\n        if (message.type === \"answer\") {\n            const applied = link.pc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n            if ((await whileLive(link, applied)) === GONE) return;\n            link.remoteReady = true;\n            await drainCandidates(link);\n            await applyQuality(quality);\n            return;\n        }\n\n        if (message.candidate === null) return;\n        await acceptCandidate(link, {\n            candidate: message.candidate,\n            sdpMid: message.sdpMid ?? undefined,\n            sdpMLineIndex: message.sdpMLineIndex ?? undefined,\n        });\n    };\n\n    /**\n     * Publish or retract one slot, one write at a time per slot.\n     *\n     * Writes to a slot are chained, and each publishes whatever the slot holds\n     * when it runs. Without the chain, an unmute whose `replaceTrack` is still\n     * in flight could finish after the mute that followed it, leaving the\n     * sender on the microphone while the mesh believes the slot is empty.\n     */\n    const setLocalTrack = async (slot: string, track: MediaStreamTrack | null): Promise<void> => {\n        if (stopped) return;\n        localTracks.set(slot, track);\n        const index = slots.findIndex((entry) => entry.name === slot);\n        if (index < 0) return;\n\n        await enqueueWrite(slot, async () => {\n            for (const link of [...links.values()]) await writeSlot(link, slot, index);\n        });\n        await applyQuality(quality);\n    };\n\n    const stop = (): void => {\n        if (stopped) return;\n        stopped = true;\n        for (const link of links.values()) link.pc.close();\n        links.clear();\n        peers.clear();\n        samplers.clear();\n        localTracks.clear();\n        syncStatsTimer();\n        emitPeers();\n        options.onState?.(\"closed\");\n    };\n\n    options.onState?.(\"connecting\", \"signaling\");\n\n    return {\n        addPeer,\n        removePeer,\n        accept,\n        setLocalTrack,\n        applyQuality,\n        setIceServers: (servers): void => {\n            iceServers = servers;\n        },\n        stop,\n        getConnection: (peerId: string): RTCPeerConnection | null => links.get(peerId)?.pc ?? null,\n        get peers(): MeshPeer[] {\n            return [...peers.values()].map((peer) => ({ ...peer }));\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"peer-mesh.cjs","names":["createLinkStatsSampler","scaleForRoom","resolveDegradation","applyQualityToLink","slotOf","createPeerConnection","drainCandidates","acceptCandidate","require_link_stats","require_mesh_quality","require_peer_link","GONE","createPeerMesh","options","links","peers","localTracks","slotWrites","iceServers","describe","connection","description","quality","stopped","samplers","statsTimer","emptyStreams","slots","slot","emitPeers","peer","isLive","link","whileLive","value","step","error","sampleLinks","changed","sampler","settings","stats","syncStatsTimer","wanted","refreshState","states","state","applyQuality","next","effective","degradation","makeOffer","offer","send","streamFor","event","attachRemoteTrack","current","enqueueWrite","queued","write","writeSlot","transceiver","index","attachLocalTracks","removePeer","peerId","addPeer","pc","transceivers","offerer","acceptOffer","from","answer","message","applied","track","entry","servers"],"sources":["../../src/webrtc/peer-mesh.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the mesh is one object's lifetime: a link's\n * transceivers, the offer it owes, the tracks published on it and the share of\n * the uplink it costs all change together, and every method here reads or writes\n * the same two maps. The pieces that *could* stand alone already do —\n * `peer-link.ts` for the per-connection mechanics and `mesh-quality.ts` for the\n * division — and what is left is the coordination between them.\n */\nimport { applyQualityToLink, resolveDegradation, scaleForRoom } from \"./mesh-quality\";\nimport {\n    acceptCandidate,\n    adoptTransceivers,\n    createPeerConnection,\n    drainCandidates,\n    slotOf,\n    type PeerLink,\n} from \"./peer-link\";\nimport { createLinkStatsSampler, type LinkStats, type LinkStatsSampler } from \"./link-stats\";\nimport type {\n    MeshMessage,\n    MeshPeer,\n    MeshQuality,\n    MeshStatsOptions,\n    PeerMeshOptions,\n} from \"./mesh-types\";\n\n/** What {@link createPeerMesh}'s negotiation steps return once their link is gone. */\nconst GONE = Symbol(\"gone\");\n\n/** A running mesh. */\nexport interface PeerMesh {\n    /**\n     * Open a link to a peer.\n     *\n     * `offerer` decides which side sends the offer, and exactly one side of each\n     * link must say `true`. Drive it from the arrival order your server already\n     * imposes — the peer that joined **later** offers, the one already in the\n     * room answers. That avoids glare by construction, without the rollback\n     * dance of perfect negotiation and without depending on a browser\n     * implementing argument-less `setLocalDescription`.\n     */\n    addPeer: (peerId: string, options: { offerer: boolean }) => Promise<void>;\n    /** Close one link and give its share of the uplink back to the others. */\n    removePeer: (peerId: string) => void;\n    /** Feed the mesh an `offer`, `answer` or `ice` message from `from`. */\n    accept: (message: MeshMessage & { from: string }) => Promise<void>;\n    /**\n     * Publish or retract one slot across every live link.\n     *\n     * `null` retracts: the sender keeps its negotiated transceiver and stops\n     * producing, which is what mutes a microphone without disturbing the other\n     * slots or the connection. Nothing renegotiates — the m-lines were allocated\n     * before any track existed, which is what makes a mesh survive toggling: a\n     * renegotiation per toggle is N-1 simultaneous offer/answer rounds every time\n     * somebody unmutes.\n     */\n    setLocalTrack: (slot: string, track: MediaStreamTrack | null) => Promise<void>;\n    /** Apply encoder limits, divided by the current size of the room. */\n    applyQuality: (quality: MeshQuality) => Promise<void>;\n    /** Replace the ICE servers used for links opened from now on. */\n    setIceServers: (servers: RTCIceServer[]) => void;\n    /**\n     * Close every link, forget the local tracks and report `closed` — for good.\n     *\n     * Stopping is terminal. The signalling socket usually outlives the call, so\n     * an offer still in flight from a former participant, or from anyone the\n     * server relays to this user, keeps reaching {@link PeerMesh.accept} after\n     * the hang-up. A stopped mesh drops it: no connection is opened, nothing is\n     * answered and no track is published, so a call that reports `closed` never\n     * sends the microphone or camera again. The same holds for `addPeer`,\n     * `setLocalTrack` and `applyQuality`, and for every negotiation that was\n     * already awaiting the browser when `stop()` ran. Calling it twice is a\n     * no-op.\n     *\n     * The tracks themselves are not stopped: they belong to the caller, who may\n     * still be showing them in a preview or reusing them on the next call. To\n     * join again, create a new mesh.\n     */\n    stop: () => void;\n    /** The peers as the mesh currently sees them. */\n    readonly peers: MeshPeer[];\n    /**\n     * The connection carrying one peer's link, or `null`.\n     *\n     * The escape hatch for everything this mesh does not model. `getStats()`,\n     * `getSenders()`, an `RTCDataChannel`, an encoding tweak the `quality`\n     * shape has no field for — all of it lives on the connection, and a mesh\n     * that keeps it private turns adopting the mesh into losing a feature.\n     *\n     * {@link MeshPeer.connection} is the *state*, which is what a view needs;\n     * this is the object, which is what a measurement needs. For the common\n     * case of measuring, {@link PeerMeshOptions.stats} spares you the loop —\n     * including the one-sampler-per-connection rule that a hand-rolled version\n     * gets wrong.\n     *\n     * @param peerId - The id the peer was added under.\n     * @returns The connection, or `null` when there is no link for that id.\n     */\n    getConnection: (peerId: string) => RTCPeerConnection | null;\n}\n\n/**\n * One `RTCPeerConnection` per peer, with the slots negotiated up front.\n *\n * The signalling protocol stays yours: this produces and accepts three message\n * shapes (`offer`, `answer`, `ice`) and leaves delivery, room membership and\n * identity to your server. What it owns is the part that is the same in every\n * mesh and wrong in most of them — see {@link PeerMesh} for the traps each\n * method exists to avoid.\n *\n * @param options - See {@link PeerMeshOptions}.\n * @returns The mesh.\n *\n * @example\n * const mesh = createPeerMesh({\n *     slots: [\n *         { name: \"mic\", kind: \"audio\" },\n *         { name: \"cam\", kind: \"video\" },\n *     ],\n *     send: (message) => socket.send(message),\n *     onPeers: setPeers,\n * });\n * socket.onMessage = (message) => void mesh.accept(message);\n * await mesh.addPeer(\"peer-2\", { offerer: true });\n * await mesh.setLocalTrack(\"mic\", micTrack);\n */\nexport function createPeerMesh(options: PeerMeshOptions): PeerMesh {\n    const { slots, send } = options;\n    const links = new Map<string, PeerLink>();\n    const peers = new Map<string, MeshPeer>();\n    const localTracks = new Map<string, MediaStreamTrack | null>();\n    const slotWrites = new Map<string, Promise<void>>();\n    let iceServers = options.iceServers ?? [];\n    const describe =\n        options.setLocalDescription ??\n        ((connection: RTCPeerConnection, description: RTCSessionDescriptionInit) =>\n            connection.setLocalDescription(description));\n    let quality: MeshQuality = options.quality ?? {};\n    let stopped = false;\n    const samplers = new Map<string, LinkStatsSampler>();\n    let statsTimer: ReturnType<typeof setInterval> | null = null;\n\n    const emptyStreams = (): Record<string, MediaStream | null> =>\n        Object.fromEntries(slots.map((slot) => [slot.name, null]));\n\n    const emitPeers = (): void => {\n        options.onPeers?.([...peers.values()].map((peer) => ({ ...peer })));\n    };\n\n    /**\n     * Whether a link is still the one the mesh holds for its peer.\n     *\n     * Every negotiation step awaits the browser, and `stop()` or `removePeer()`\n     * can close the link inside any of those awaits. A continuation that does\n     * not re-check keeps negotiating on a closed connection — which a browser\n     * answers with `InvalidStateError` — or, worse, signals an answer for a call\n     * that already hung up.\n     *\n     * @param link - The link a continuation is about to touch.\n     * @returns `false` once the mesh stopped or the link was removed or replaced.\n     */\n    const isLive = (link: PeerLink): boolean => !stopped && links.get(link.peerId) === link;\n\n    /**\n     * Await one negotiation step, and tell the caller whether to go on.\n     *\n     * A browser settles a call that `close()` ran under in one of two ways:\n     * it rejects with `InvalidStateError`, or — what Chromium was measured\n     * doing — it never settles at all. The second needs nothing here; the\n     * first would surface as a rejected `accept()`, which the documented\n     * `void mesh.accept(message)` wiring turns into an unhandled rejection\n     * for a call that already hung up. So a rejection on a link that is no\n     * longer live is swallowed, and one on a live link is rethrown untouched.\n     *\n     * @param link - The link the step negotiates on.\n     * @param step - The pending browser call.\n     * @returns The step's value, or {@link GONE} when the link stopped being live.\n     */\n    const whileLive = async <T>(link: PeerLink, step: Promise<T>): Promise<T | typeof GONE> => {\n        try {\n            const value = await step;\n            return isLive(link) ? value : GONE;\n        } catch (error) {\n            if (!isLive(link)) return GONE;\n            throw error;\n        }\n    };\n\n    /**\n     * Sample every connected link once.\n     *\n     * Only `connected` links are asked. A link still gathering candidates has\n     * no traffic to measure, and asking anyway spends a `getStats()` round trip\n     * to learn that — per link, on every tick.\n     *\n     * `settings` arrives as an argument rather than being read from `options`\n     * here: the timer is only ever armed past the check that they exist, so\n     * reading them again would add a branch that nothing can reach.\n     *\n     * Each link is sampled on its own: a `getStats()` that rejects — a link\n     * closing under the call does that — skips that link for this tick and\n     * leaves the others measured. Across the await the link is re-checked by\n     * identity, not by id: a peer removed and re-added under the same id holds\n     * a new connection, and the old one's sample must not land on it.\n     *\n     * @param settings - The measuring options, already known to be present.\n     */\n    const sampleLinks = async (settings: MeshStatsOptions): Promise<void> => {\n        if (stopped) return;\n        let changed = false;\n\n        for (const link of [...links.values()]) {\n            if (link.pc.connectionState !== \"connected\") continue;\n            let sampler = samplers.get(link.peerId);\n            if (sampler === undefined) {\n                sampler = createLinkStatsSampler(\n                    settings.kind === undefined ? {} : { kind: settings.kind },\n                );\n                samplers.set(link.peerId, sampler);\n            }\n            let stats: LinkStats;\n            try {\n                stats = await sampler.sample(link.pc);\n            } catch {\n                continue;\n            }\n            const peer = peers.get(link.peerId);\n            if (!isLive(link) || peer === undefined) continue;\n            peer.stats = stats;\n            changed = true;\n            settings.onStats?.(link.peerId, stats);\n        }\n\n        if (changed) emitPeers();\n    };\n\n    /**\n     * Keep the timer alive exactly while there is something to measure.\n     *\n     * One timer for the whole mesh, not one per peer — and none at all in an\n     * empty room, which is where a call sits for as long as the first person is\n     * early.\n     */\n    const syncStatsTimer = (): void => {\n        const settings = options.stats;\n        if (settings === undefined) return;\n        const wanted = !stopped && links.size > 0;\n        if (wanted && statsTimer === null) {\n            statsTimer = setInterval(() => void sampleLinks(settings), settings.intervalMs ?? 2000);\n            return;\n        }\n        if (!wanted && statsTimer !== null) {\n            clearInterval(statsTimer);\n            statsTimer = null;\n        }\n    };\n\n    /**\n     * Collapse the per-link states into the one badge a call shows.\n     *\n     * No links at all is `connected`, not a failure: it means nobody else is in\n     * the room yet, which is a legitimate state a call sits in for as long as the\n     * first person is early.\n     */\n    const refreshState = (): void => {\n        if (stopped) return;\n        const states = [...links.values()].map((link) => link.pc.connectionState);\n        if (states.some((state) => state === \"connected\")) options.onState?.(\"connected\");\n        else if (states.length > 0) options.onState?.(\"connecting\", \"negotiating\");\n        else options.onState?.(\"connected\", \"alone\");\n    };\n\n    const applyQuality = async (next: MeshQuality): Promise<void> => {\n        if (stopped) return;\n        quality = next;\n        const effective = scaleForRoom(next, links.size);\n        const degradation = resolveDegradation(next, effective);\n        for (const link of links.values()) {\n            await applyQualityToLink(link.transceivers, slots, effective, degradation);\n        }\n    };\n\n    const makeOffer = async (link: PeerLink): Promise<void> => {\n        if (link.makingOffer) return;\n        link.makingOffer = true;\n        try {\n            const offer = await link.pc.createOffer();\n            if (!isLive(link)) return;\n            if (!offer.sdp) {\n                options.onNotice?.(\"empty_local_offer_sdp\");\n                return;\n            }\n            await describe(link.pc, offer);\n            if (!isLive(link)) return;\n            send({\n                type: \"offer\",\n                to: link.peerId,\n                sdp: link.pc.localDescription?.sdp ?? offer.sdp,\n            });\n        } catch {\n            if (isLive(link)) options.onNotice?.(\"offer_failed\");\n        } finally {\n            link.makingOffer = false;\n        }\n    };\n\n    /**\n     * Wrap an inbound track in the stream the caller renders.\n     *\n     * The event's own stream is preferred: it is the one the sending side\n     * grouped the track into, so a caller that reads `stream.id` sees what the\n     * peer published rather than a wrapper invented here. Browsers only fill it\n     * when the offer named a stream, hence the fallback — and the guard after\n     * that is for a runtime with no `MediaStream` at all, where routing still\n     * has to not throw.\n     */\n    const streamFor = (event: RTCTrackEvent): MediaStream | null => {\n        const provided = event.streams?.[0];\n        if (provided) return provided;\n        return typeof MediaStream === \"undefined\" ? null : new MediaStream([event.track]);\n    };\n\n    const attachRemoteTrack = (link: PeerLink, event: RTCTrackEvent): void => {\n        const slot = slotOf(event.transceiver, link, slots);\n        const peer = peers.get(link.peerId);\n        if (!slot || !peer) return;\n\n        peer.streams = { ...peer.streams, [slot.name]: streamFor(event) };\n        event.track.onended = (): void => {\n            const current = peers.get(link.peerId);\n            if (!current) return;\n            current.streams = { ...current.streams, [slot.name]: null };\n            emitPeers();\n        };\n        emitPeers();\n    };\n\n    /**\n     * Queue one write behind every earlier write to the same slot.\n     *\n     * Every write that puts a local track on a sender goes through here — the\n     * fan-out of `setLocalTrack` and the first write onto a link that just\n     * got its transceivers alike. Two writes to one slot therefore never run\n     * at once, and a write queued later always finishes later.\n     *\n     * @param slot - The slot name.\n     * @param write - The write to run once the earlier ones have finished.\n     * @returns The queued write.\n     */\n    const enqueueWrite = (slot: string, write: () => Promise<void>): Promise<void> => {\n        const queued = (slotWrites.get(slot) ?? Promise.resolve()).then(write);\n        slotWrites.set(slot, queued);\n        return queued;\n    };\n\n    /**\n     * Put a slot's current track on one link's sender.\n     *\n     * The track is read when the write runs, not when it was queued, so the\n     * last `setLocalTrack` wins whichever write lands last. A refusal\n     * belongs to a link that is tearing down, whose state handler removes it,\n     * so it is not an error here.\n     *\n     * @param link - The link to write onto.\n     * @param slot - The slot name.\n     * @param index - The slot's position in `slots`, which is its transceiver.\n     */\n    const writeSlot = async (link: PeerLink, slot: string, index: number): Promise<void> => {\n        const transceiver = link.transceivers[index];\n        if (!transceiver || !isLive(link)) return;\n        try {\n            await transceiver.sender.replaceTrack(localTracks.get(slot) ?? null);\n        } catch {\n            return;\n        }\n    };\n\n    /**\n     * Publish every held local track onto a link whose transceivers now exist.\n     *\n     * Up front for the offerer, after the offer lands for the answerer, so a\n     * microphone that was already live when the peer joined starts flowing\n     * without waiting for a toggle. Each slot's write joins that slot's queue,\n     * so a mute issued while it is in flight still has the last word.\n     *\n     * @param link - The link to publish onto.\n     */\n    const attachLocalTracks = (link: PeerLink): Promise<unknown> =>\n        Promise.all(\n            slots.map((slot, index) =>\n                enqueueWrite(slot.name, () => writeSlot(link, slot.name, index)),\n            ),\n        );\n\n    const removePeer = (peerId: string): void => {\n        if (stopped) return;\n        const link = links.get(peerId);\n        if (link) {\n            link.pc.close();\n            links.delete(peerId);\n        }\n        peers.delete(peerId);\n        samplers.delete(peerId);\n        void applyQuality(quality);\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n    };\n\n    const addPeer = async (peerId: string, { offerer }: { offerer: boolean }): Promise<void> => {\n        if (stopped || links.has(peerId)) return;\n\n        const pc = createPeerConnection(iceServers);\n        let transceivers: RTCRtpTransceiver[] = [];\n        if (offerer) {\n            try {\n                transceivers = slots.map((slot) =>\n                    pc.addTransceiver(slot.kind, { direction: \"sendrecv\" }),\n                );\n            } catch (error) {\n                pc.close();\n                throw error;\n            }\n        }\n        const link: PeerLink = {\n            peerId,\n            pc,\n            transceivers,\n            pendingCandidates: [],\n            remoteReady: false,\n            makingOffer: false,\n            isOfferer: offerer,\n        };\n        links.set(peerId, link);\n        peers.set(peerId, {\n            peerId,\n            connection: pc.connectionState,\n            streams: peers.get(peerId)?.streams ?? emptyStreams(),\n        });\n\n        if (offerer) {\n            await attachLocalTracks(link);\n            if (!isLive(link)) return;\n        }\n\n        pc.onicecandidate = (event): void => {\n            send({\n                type: \"ice\",\n                to: peerId,\n                candidate: event.candidate?.candidate ?? null,\n                sdpMid: event.candidate?.sdpMid ?? null,\n                sdpMLineIndex: event.candidate?.sdpMLineIndex ?? null,\n            });\n        };\n\n        pc.ontrack = (event): void => attachRemoteTrack(link, event);\n\n        pc.onconnectionstatechange = (): void => {\n            if (!isLive(link)) return;\n            const peer = peers.get(peerId);\n            if (peer) peer.connection = pc.connectionState;\n            if (pc.connectionState === \"failed\" || pc.connectionState === \"closed\") {\n                removePeer(peerId);\n                return;\n            }\n            emitPeers();\n            refreshState();\n        };\n\n        pc.onnegotiationneeded = (): void => {\n            if (link.isOfferer) void makeOffer(link);\n        };\n\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n        if (offerer) await makeOffer(link);\n    };\n\n    const acceptOffer = async (from: string, sdp: string): Promise<void> => {\n        if (!links.has(from)) await addPeer(from, { offerer: false });\n        const link = links.get(from);\n        if (!link || !isLive(link)) return;\n\n        if (\n            (await whileLive(link, link.pc.setRemoteDescription({ type: \"offer\", sdp }))) === GONE\n        ) {\n            return;\n        }\n        link.remoteReady = true;\n        await drainCandidates(link);\n\n        if (!link.isOfferer) {\n            adoptTransceivers(link);\n            await attachLocalTracks(link);\n        }\n        if (!isLive(link)) return;\n\n        const answer = await whileLive(link, link.pc.createAnswer());\n        if (answer === GONE) return;\n        if (!answer.sdp) {\n            options.onNotice?.(\"empty_local_answer_sdp\");\n            return;\n        }\n        if ((await whileLive(link, describe(link.pc, answer))) === GONE) return;\n        send({ type: \"answer\", to: from, sdp: link.pc.localDescription?.sdp ?? answer.sdp });\n        await applyQuality(quality);\n    };\n\n    const accept = async (message: MeshMessage & { from: string }): Promise<void> => {\n        if (stopped) return;\n        if (message.type === \"offer\") {\n            await acceptOffer(message.from, message.sdp);\n            return;\n        }\n\n        const link = links.get(message.from);\n        if (!link) return;\n\n        if (message.type === \"answer\") {\n            const applied = link.pc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n            if ((await whileLive(link, applied)) === GONE) return;\n            link.remoteReady = true;\n            await drainCandidates(link);\n            await applyQuality(quality);\n            return;\n        }\n\n        if (message.candidate === null) return;\n        await acceptCandidate(link, {\n            candidate: message.candidate,\n            sdpMid: message.sdpMid ?? undefined,\n            sdpMLineIndex: message.sdpMLineIndex ?? undefined,\n        });\n    };\n\n    /**\n     * Publish or retract one slot, one write at a time per slot.\n     *\n     * Writes to a slot are chained, and each publishes whatever the slot holds\n     * when it runs. Without the chain, an unmute whose `replaceTrack` is still\n     * in flight could finish after the mute that followed it, leaving the\n     * sender on the microphone while the mesh believes the slot is empty.\n     */\n    const setLocalTrack = async (slot: string, track: MediaStreamTrack | null): Promise<void> => {\n        if (stopped) return;\n        localTracks.set(slot, track);\n        const index = slots.findIndex((entry) => entry.name === slot);\n        if (index < 0) return;\n\n        await enqueueWrite(slot, async () => {\n            for (const link of [...links.values()]) await writeSlot(link, slot, index);\n        });\n        await applyQuality(quality);\n    };\n\n    const stop = (): void => {\n        if (stopped) return;\n        stopped = true;\n        for (const link of links.values()) link.pc.close();\n        links.clear();\n        peers.clear();\n        samplers.clear();\n        localTracks.clear();\n        syncStatsTimer();\n        emitPeers();\n        options.onState?.(\"closed\");\n    };\n\n    options.onState?.(\"connecting\", \"signaling\");\n\n    return {\n        addPeer,\n        removePeer,\n        accept,\n        setLocalTrack,\n        applyQuality,\n        setIceServers: (servers): void => {\n            iceServers = servers;\n        },\n        stop,\n        getConnection: (peerId: string): RTCPeerConnection | null => links.get(peerId)?.pc ?? null,\n        get peers(): MeshPeer[] {\n            return [...peers.values()].map((peer) => ({ ...peer }));\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/webrtc/peer-mesh.js

@@ -35,11 +35,7 @@ function u(u) {
 		let e = u.stats;
 		if (e === void 0) return;
 		let t = !b && p.size > 0;
-		if (t && S === null) {
-			S = setInterval(() => void D(e), e.intervalMs ?? 2e3);
-			return;
-		}
-		!t && S !== null && (clearInterval(S), S = null);
+		t && S === null ? S = setInterval(() => void D(e), e.intervalMs ?? 2e3) : !t && S !== null && (clearInterval(S), S = null);
 	}, k = () => {
 		if (b) return;
 		let e = [...p.values()].map((e) => e.pc.connectionState);
@@ -129,11 +125,7 @@ function u(u) {
 		}, n.ontrack = (e) => N(i, e), n.onconnectionstatechange = () => {
 			if (!T(i)) return;
 			let t = m.get(e);
-			if (t && (t.connection = n.connectionState), n.connectionState === "failed" || n.connectionState === "closed") {
-				L(e);
-				return;
-			}
-			w(), k();
+			t && (t.connection = n.connectionState), n.connectionState === "failed" || n.connectionState === "closed" ? L(e) : (w(), k());
 		}, n.onnegotiationneeded = () => {
 			i.isOfferer && j(i);
 		}, O(), w(), k(), t && await j(i));
@@ -145,17 +137,11 @@ function u(u) {
 			sdp: t
 		})) === l || (n.remoteReady = !0, await s(n), n.isOfferer || (a(n), await I(n)), !T(n))) return;
 		let r = await E(n, n.pc.createAnswer());
-		if (r !== l) {
-			if (!r.sdp) {
-				u.onNotice?.("empty_local_answer_sdp");
-				return;
-			}
-			await E(n, v(n.pc, r)) !== l && (f({
-				type: "answer",
-				to: e,
-				sdp: n.pc.localDescription?.sdp ?? r.sdp
-			}), await A(y));
-		}
+		r !== l && (r.sdp ? await E(n, v(n.pc, r)) !== l && (f({
+			type: "answer",
+			to: e,
+			sdp: n.pc.localDescription?.sdp ?? r.sdp
+		}), await A(y)) : u.onNotice?.("empty_local_answer_sdp"));
 	};
 	return u.onState?.("connecting", "signaling"), {
 		addPeer: R,
@@ -175,9 +161,7 @@ function u(u) {
 					});
 					if (await E(t, n) === l) return;
 					t.remoteReady = !0, await s(t), await A(y);
-					return;
-				}
-				e.candidate !== null && await i(t, {
+				} else e.candidate !== null && await i(t, {
 					candidate: e.candidate,
 					sdpMid: e.sdpMid ?? void 0,
 					sdpMLineIndex: e.sdpMLineIndex ?? void 0

package/dist/webrtc/peer-mesh.js.map

@@ -1 +1 @@
-{"version":3,"file":"peer-mesh.js","names":[],"sources":["../../src/webrtc/peer-mesh.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the mesh is one object's lifetime: a link's\n * transceivers, the offer it owes, the tracks published on it and the share of\n * the uplink it costs all change together, and every method here reads or writes\n * the same two maps. The pieces that *could* stand alone already do —\n * `peer-link.ts` for the per-connection mechanics and `mesh-quality.ts` for the\n * division — and what is left is the coordination between them.\n */\nimport { applyQualityToLink, resolveDegradation, scaleForRoom } from \"./mesh-quality\";\nimport {\n    acceptCandidate,\n    adoptTransceivers,\n    createPeerConnection,\n    drainCandidates,\n    slotOf,\n    type PeerLink,\n} from \"./peer-link\";\nimport { createLinkStatsSampler, type LinkStats, type LinkStatsSampler } from \"./link-stats\";\nimport type {\n    MeshMessage,\n    MeshPeer,\n    MeshQuality,\n    MeshStatsOptions,\n    PeerMeshOptions,\n} from \"./mesh-types\";\n\n/** What {@link createPeerMesh}'s negotiation steps return once their link is gone. */\nconst GONE = Symbol(\"gone\");\n\n/** A running mesh. */\nexport interface PeerMesh {\n    /**\n     * Open a link to a peer.\n     *\n     * `offerer` decides which side sends the offer, and exactly one side of each\n     * link must say `true`. Drive it from the arrival order your server already\n     * imposes — the peer that joined **later** offers, the one already in the\n     * room answers. That avoids glare by construction, without the rollback\n     * dance of perfect negotiation and without depending on a browser\n     * implementing argument-less `setLocalDescription`.\n     */\n    addPeer: (peerId: string, options: { offerer: boolean }) => Promise<void>;\n    /** Close one link and give its share of the uplink back to the others. */\n    removePeer: (peerId: string) => void;\n    /** Feed the mesh an `offer`, `answer` or `ice` message from `from`. */\n    accept: (message: MeshMessage & { from: string }) => Promise<void>;\n    /**\n     * Publish or retract one slot across every live link.\n     *\n     * `null` retracts: the sender keeps its negotiated transceiver and stops\n     * producing, which is what mutes a microphone without disturbing the other\n     * slots or the connection. Nothing renegotiates — the m-lines were allocated\n     * before any track existed, which is what makes a mesh survive toggling: a\n     * renegotiation per toggle is N-1 simultaneous offer/answer rounds every time\n     * somebody unmutes.\n     */\n    setLocalTrack: (slot: string, track: MediaStreamTrack | null) => Promise<void>;\n    /** Apply encoder limits, divided by the current size of the room. */\n    applyQuality: (quality: MeshQuality) => Promise<void>;\n    /** Replace the ICE servers used for links opened from now on. */\n    setIceServers: (servers: RTCIceServer[]) => void;\n    /**\n     * Close every link, forget the local tracks and report `closed` — for good.\n     *\n     * Stopping is terminal. The signalling socket usually outlives the call, so\n     * an offer still in flight from a former participant, or from anyone the\n     * server relays to this user, keeps reaching {@link PeerMesh.accept} after\n     * the hang-up. A stopped mesh drops it: no connection is opened, nothing is\n     * answered and no track is published, so a call that reports `closed` never\n     * sends the microphone or camera again. The same holds for `addPeer`,\n     * `setLocalTrack` and `applyQuality`, and for every negotiation that was\n     * already awaiting the browser when `stop()` ran. Calling it twice is a\n     * no-op.\n     *\n     * The tracks themselves are not stopped: they belong to the caller, who may\n     * still be showing them in a preview or reusing them on the next call. To\n     * join again, create a new mesh.\n     */\n    stop: () => void;\n    /** The peers as the mesh currently sees them. */\n    readonly peers: MeshPeer[];\n    /**\n     * The connection carrying one peer's link, or `null`.\n     *\n     * The escape hatch for everything this mesh does not model. `getStats()`,\n     * `getSenders()`, an `RTCDataChannel`, an encoding tweak the `quality`\n     * shape has no field for — all of it lives on the connection, and a mesh\n     * that keeps it private turns adopting the mesh into losing a feature.\n     *\n     * {@link MeshPeer.connection} is the *state*, which is what a view needs;\n     * this is the object, which is what a measurement needs. For the common\n     * case of measuring, {@link PeerMeshOptions.stats} spares you the loop —\n     * including the one-sampler-per-connection rule that a hand-rolled version\n     * gets wrong.\n     *\n     * @param peerId - The id the peer was added under.\n     * @returns The connection, or `null` when there is no link for that id.\n     */\n    getConnection: (peerId: string) => RTCPeerConnection | null;\n}\n\n/**\n * One `RTCPeerConnection` per peer, with the slots negotiated up front.\n *\n * The signalling protocol stays yours: this produces and accepts three message\n * shapes (`offer`, `answer`, `ice`) and leaves delivery, room membership and\n * identity to your server. What it owns is the part that is the same in every\n * mesh and wrong in most of them — see {@link PeerMesh} for the traps each\n * method exists to avoid.\n *\n * @param options - See {@link PeerMeshOptions}.\n * @returns The mesh.\n *\n * @example\n * const mesh = createPeerMesh({\n *     slots: [\n *         { name: \"mic\", kind: \"audio\" },\n *         { name: \"cam\", kind: \"video\" },\n *     ],\n *     send: (message) => socket.send(message),\n *     onPeers: setPeers,\n * });\n * socket.onMessage = (message) => void mesh.accept(message);\n * await mesh.addPeer(\"peer-2\", { offerer: true });\n * await mesh.setLocalTrack(\"mic\", micTrack);\n */\nexport function createPeerMesh(options: PeerMeshOptions): PeerMesh {\n    const { slots, send } = options;\n    const links = new Map<string, PeerLink>();\n    const peers = new Map<string, MeshPeer>();\n    const localTracks = new Map<string, MediaStreamTrack | null>();\n    const slotWrites = new Map<string, Promise<void>>();\n    let iceServers = options.iceServers ?? [];\n    const describe =\n        options.setLocalDescription ??\n        ((connection: RTCPeerConnection, description: RTCSessionDescriptionInit) =>\n            connection.setLocalDescription(description));\n    let quality: MeshQuality = options.quality ?? {};\n    let stopped = false;\n    const samplers = new Map<string, LinkStatsSampler>();\n    let statsTimer: ReturnType<typeof setInterval> | null = null;\n\n    const emptyStreams = (): Record<string, MediaStream | null> =>\n        Object.fromEntries(slots.map((slot) => [slot.name, null]));\n\n    const emitPeers = (): void => {\n        options.onPeers?.([...peers.values()].map((peer) => ({ ...peer })));\n    };\n\n    /**\n     * Whether a link is still the one the mesh holds for its peer.\n     *\n     * Every negotiation step awaits the browser, and `stop()` or `removePeer()`\n     * can close the link inside any of those awaits. A continuation that does\n     * not re-check keeps negotiating on a closed connection — which a browser\n     * answers with `InvalidStateError` — or, worse, signals an answer for a call\n     * that already hung up.\n     *\n     * @param link - The link a continuation is about to touch.\n     * @returns `false` once the mesh stopped or the link was removed or replaced.\n     */\n    const isLive = (link: PeerLink): boolean => !stopped && links.get(link.peerId) === link;\n\n    /**\n     * Await one negotiation step, and tell the caller whether to go on.\n     *\n     * A browser settles a call that `close()` ran under in one of two ways:\n     * it rejects with `InvalidStateError`, or — what Chromium was measured\n     * doing — it never settles at all. The second needs nothing here; the\n     * first would surface as a rejected `accept()`, which the documented\n     * `void mesh.accept(message)` wiring turns into an unhandled rejection\n     * for a call that already hung up. So a rejection on a link that is no\n     * longer live is swallowed, and one on a live link is rethrown untouched.\n     *\n     * @param link - The link the step negotiates on.\n     * @param step - The pending browser call.\n     * @returns The step's value, or {@link GONE} when the link stopped being live.\n     */\n    const whileLive = async <T>(link: PeerLink, step: Promise<T>): Promise<T | typeof GONE> => {\n        try {\n            const value = await step;\n            return isLive(link) ? value : GONE;\n        } catch (error) {\n            if (!isLive(link)) return GONE;\n            throw error;\n        }\n    };\n\n    /**\n     * Sample every connected link once.\n     *\n     * Only `connected` links are asked. A link still gathering candidates has\n     * no traffic to measure, and asking anyway spends a `getStats()` round trip\n     * to learn that — per link, on every tick.\n     *\n     * `settings` arrives as an argument rather than being read from `options`\n     * here: the timer is only ever armed past the check that they exist, so\n     * reading them again would add a branch that nothing can reach.\n     *\n     * Each link is sampled on its own: a `getStats()` that rejects — a link\n     * closing under the call does that — skips that link for this tick and\n     * leaves the others measured. Across the await the link is re-checked by\n     * identity, not by id: a peer removed and re-added under the same id holds\n     * a new connection, and the old one's sample must not land on it.\n     *\n     * @param settings - The measuring options, already known to be present.\n     */\n    const sampleLinks = async (settings: MeshStatsOptions): Promise<void> => {\n        if (stopped) return;\n        let changed = false;\n\n        for (const link of [...links.values()]) {\n            if (link.pc.connectionState !== \"connected\") continue;\n            let sampler = samplers.get(link.peerId);\n            if (sampler === undefined) {\n                sampler = createLinkStatsSampler(\n                    settings.kind === undefined ? {} : { kind: settings.kind },\n                );\n                samplers.set(link.peerId, sampler);\n            }\n            let stats: LinkStats;\n            try {\n                stats = await sampler.sample(link.pc);\n            } catch {\n                continue;\n            }\n            const peer = peers.get(link.peerId);\n            if (!isLive(link) || peer === undefined) continue;\n            peer.stats = stats;\n            changed = true;\n            settings.onStats?.(link.peerId, stats);\n        }\n\n        if (changed) emitPeers();\n    };\n\n    /**\n     * Keep the timer alive exactly while there is something to measure.\n     *\n     * One timer for the whole mesh, not one per peer — and none at all in an\n     * empty room, which is where a call sits for as long as the first person is\n     * early.\n     */\n    const syncStatsTimer = (): void => {\n        const settings = options.stats;\n        if (settings === undefined) return;\n        const wanted = !stopped && links.size > 0;\n        if (wanted && statsTimer === null) {\n            statsTimer = setInterval(() => void sampleLinks(settings), settings.intervalMs ?? 2000);\n            return;\n        }\n        if (!wanted && statsTimer !== null) {\n            clearInterval(statsTimer);\n            statsTimer = null;\n        }\n    };\n\n    /**\n     * Collapse the per-link states into the one badge a call shows.\n     *\n     * No links at all is `connected`, not a failure: it means nobody else is in\n     * the room yet, which is a legitimate state a call sits in for as long as the\n     * first person is early.\n     */\n    const refreshState = (): void => {\n        if (stopped) return;\n        const states = [...links.values()].map((link) => link.pc.connectionState);\n        if (states.some((state) => state === \"connected\")) options.onState?.(\"connected\");\n        else if (states.length > 0) options.onState?.(\"connecting\", \"negotiating\");\n        else options.onState?.(\"connected\", \"alone\");\n    };\n\n    const applyQuality = async (next: MeshQuality): Promise<void> => {\n        if (stopped) return;\n        quality = next;\n        const effective = scaleForRoom(next, links.size);\n        const degradation = resolveDegradation(next, effective);\n        for (const link of links.values()) {\n            await applyQualityToLink(link.transceivers, slots, effective, degradation);\n        }\n    };\n\n    const makeOffer = async (link: PeerLink): Promise<void> => {\n        if (link.makingOffer) return;\n        link.makingOffer = true;\n        try {\n            const offer = await link.pc.createOffer();\n            if (!isLive(link)) return;\n            if (!offer.sdp) {\n                options.onNotice?.(\"empty_local_offer_sdp\");\n                return;\n            }\n            await describe(link.pc, offer);\n            if (!isLive(link)) return;\n            send({\n                type: \"offer\",\n                to: link.peerId,\n                sdp: link.pc.localDescription?.sdp ?? offer.sdp,\n            });\n        } catch {\n            if (isLive(link)) options.onNotice?.(\"offer_failed\");\n        } finally {\n            link.makingOffer = false;\n        }\n    };\n\n    /**\n     * Wrap an inbound track in the stream the caller renders.\n     *\n     * The event's own stream is preferred: it is the one the sending side\n     * grouped the track into, so a caller that reads `stream.id` sees what the\n     * peer published rather than a wrapper invented here. Browsers only fill it\n     * when the offer named a stream, hence the fallback — and the guard after\n     * that is for a runtime with no `MediaStream` at all, where routing still\n     * has to not throw.\n     */\n    const streamFor = (event: RTCTrackEvent): MediaStream | null => {\n        const provided = event.streams?.[0];\n        if (provided) return provided;\n        return typeof MediaStream === \"undefined\" ? null : new MediaStream([event.track]);\n    };\n\n    const attachRemoteTrack = (link: PeerLink, event: RTCTrackEvent): void => {\n        const slot = slotOf(event.transceiver, link, slots);\n        const peer = peers.get(link.peerId);\n        if (!slot || !peer) return;\n\n        peer.streams = { ...peer.streams, [slot.name]: streamFor(event) };\n        event.track.onended = (): void => {\n            const current = peers.get(link.peerId);\n            if (!current) return;\n            current.streams = { ...current.streams, [slot.name]: null };\n            emitPeers();\n        };\n        emitPeers();\n    };\n\n    /**\n     * Queue one write behind every earlier write to the same slot.\n     *\n     * Every write that puts a local track on a sender goes through here — the\n     * fan-out of `setLocalTrack` and the first write onto a link that just\n     * got its transceivers alike. Two writes to one slot therefore never run\n     * at once, and a write queued later always finishes later.\n     *\n     * @param slot - The slot name.\n     * @param write - The write to run once the earlier ones have finished.\n     * @returns The queued write.\n     */\n    const enqueueWrite = (slot: string, write: () => Promise<void>): Promise<void> => {\n        const queued = (slotWrites.get(slot) ?? Promise.resolve()).then(write);\n        slotWrites.set(slot, queued);\n        return queued;\n    };\n\n    /**\n     * Put a slot's current track on one link's sender.\n     *\n     * The track is read when the write runs, not when it was queued, so the\n     * last `setLocalTrack` wins whichever write lands last. A refusal\n     * belongs to a link that is tearing down, whose state handler removes it,\n     * so it is not an error here.\n     *\n     * @param link - The link to write onto.\n     * @param slot - The slot name.\n     * @param index - The slot's position in `slots`, which is its transceiver.\n     */\n    const writeSlot = async (link: PeerLink, slot: string, index: number): Promise<void> => {\n        const transceiver = link.transceivers[index];\n        if (!transceiver || !isLive(link)) return;\n        try {\n            await transceiver.sender.replaceTrack(localTracks.get(slot) ?? null);\n        } catch {\n            return;\n        }\n    };\n\n    /**\n     * Publish every held local track onto a link whose transceivers now exist.\n     *\n     * Up front for the offerer, after the offer lands for the answerer, so a\n     * microphone that was already live when the peer joined starts flowing\n     * without waiting for a toggle. Each slot's write joins that slot's queue,\n     * so a mute issued while it is in flight still has the last word.\n     *\n     * @param link - The link to publish onto.\n     */\n    const attachLocalTracks = (link: PeerLink): Promise<unknown> =>\n        Promise.all(\n            slots.map((slot, index) =>\n                enqueueWrite(slot.name, () => writeSlot(link, slot.name, index)),\n            ),\n        );\n\n    const removePeer = (peerId: string): void => {\n        if (stopped) return;\n        const link = links.get(peerId);\n        if (link) {\n            link.pc.close();\n            links.delete(peerId);\n        }\n        peers.delete(peerId);\n        samplers.delete(peerId);\n        void applyQuality(quality);\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n    };\n\n    const addPeer = async (peerId: string, { offerer }: { offerer: boolean }): Promise<void> => {\n        if (stopped || links.has(peerId)) return;\n\n        const pc = createPeerConnection(iceServers);\n        let transceivers: RTCRtpTransceiver[] = [];\n        if (offerer) {\n            try {\n                transceivers = slots.map((slot) =>\n                    pc.addTransceiver(slot.kind, { direction: \"sendrecv\" }),\n                );\n            } catch (error) {\n                pc.close();\n                throw error;\n            }\n        }\n        const link: PeerLink = {\n            peerId,\n            pc,\n            transceivers,\n            pendingCandidates: [],\n            remoteReady: false,\n            makingOffer: false,\n            isOfferer: offerer,\n        };\n        links.set(peerId, link);\n        peers.set(peerId, {\n            peerId,\n            connection: pc.connectionState,\n            streams: peers.get(peerId)?.streams ?? emptyStreams(),\n        });\n\n        if (offerer) {\n            await attachLocalTracks(link);\n            if (!isLive(link)) return;\n        }\n\n        pc.onicecandidate = (event): void => {\n            send({\n                type: \"ice\",\n                to: peerId,\n                candidate: event.candidate?.candidate ?? null,\n                sdpMid: event.candidate?.sdpMid ?? null,\n                sdpMLineIndex: event.candidate?.sdpMLineIndex ?? null,\n            });\n        };\n\n        pc.ontrack = (event): void => attachRemoteTrack(link, event);\n\n        pc.onconnectionstatechange = (): void => {\n            if (!isLive(link)) return;\n            const peer = peers.get(peerId);\n            if (peer) peer.connection = pc.connectionState;\n            if (pc.connectionState === \"failed\" || pc.connectionState === \"closed\") {\n                removePeer(peerId);\n                return;\n            }\n            emitPeers();\n            refreshState();\n        };\n\n        pc.onnegotiationneeded = (): void => {\n            if (link.isOfferer) void makeOffer(link);\n        };\n\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n        if (offerer) await makeOffer(link);\n    };\n\n    const acceptOffer = async (from: string, sdp: string): Promise<void> => {\n        if (!links.has(from)) await addPeer(from, { offerer: false });\n        const link = links.get(from);\n        if (!link || !isLive(link)) return;\n\n        if (\n            (await whileLive(link, link.pc.setRemoteDescription({ type: \"offer\", sdp }))) === GONE\n        ) {\n            return;\n        }\n        link.remoteReady = true;\n        await drainCandidates(link);\n\n        if (!link.isOfferer) {\n            adoptTransceivers(link);\n            await attachLocalTracks(link);\n        }\n        if (!isLive(link)) return;\n\n        const answer = await whileLive(link, link.pc.createAnswer());\n        if (answer === GONE) return;\n        if (!answer.sdp) {\n            options.onNotice?.(\"empty_local_answer_sdp\");\n            return;\n        }\n        if ((await whileLive(link, describe(link.pc, answer))) === GONE) return;\n        send({ type: \"answer\", to: from, sdp: link.pc.localDescription?.sdp ?? answer.sdp });\n        await applyQuality(quality);\n    };\n\n    const accept = async (message: MeshMessage & { from: string }): Promise<void> => {\n        if (stopped) return;\n        if (message.type === \"offer\") {\n            await acceptOffer(message.from, message.sdp);\n            return;\n        }\n\n        const link = links.get(message.from);\n        if (!link) return;\n\n        if (message.type === \"answer\") {\n            const applied = link.pc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n            if ((await whileLive(link, applied)) === GONE) return;\n            link.remoteReady = true;\n            await drainCandidates(link);\n            await applyQuality(quality);\n            return;\n        }\n\n        if (message.candidate === null) return;\n        await acceptCandidate(link, {\n            candidate: message.candidate,\n            sdpMid: message.sdpMid ?? undefined,\n            sdpMLineIndex: message.sdpMLineIndex ?? undefined,\n        });\n    };\n\n    /**\n     * Publish or retract one slot, one write at a time per slot.\n     *\n     * Writes to a slot are chained, and each publishes whatever the slot holds\n     * when it runs. Without the chain, an unmute whose `replaceTrack` is still\n     * in flight could finish after the mute that followed it, leaving the\n     * sender on the microphone while the mesh believes the slot is empty.\n     */\n    const setLocalTrack = async (slot: string, track: MediaStreamTrack | null): Promise<void> => {\n        if (stopped) return;\n        localTracks.set(slot, track);\n        const index = slots.findIndex((entry) => entry.name === slot);\n        if (index < 0) return;\n\n        await enqueueWrite(slot, async () => {\n            for (const link of [...links.values()]) await writeSlot(link, slot, index);\n        });\n        await applyQuality(quality);\n    };\n\n    const stop = (): void => {\n        if (stopped) return;\n        stopped = true;\n        for (const link of links.values()) link.pc.close();\n        links.clear();\n        peers.clear();\n        samplers.clear();\n        localTracks.clear();\n        syncStatsTimer();\n        emitPeers();\n        options.onState?.(\"closed\");\n    };\n\n    options.onState?.(\"connecting\", \"signaling\");\n\n    return {\n        addPeer,\n        removePeer,\n        accept,\n        setLocalTrack,\n        applyQuality,\n        setIceServers: (servers): void => {\n            iceServers = servers;\n        },\n        stop,\n        getConnection: (peerId: string): RTCPeerConnection | null => links.get(peerId)?.pc ?? null,\n        get peers(): MeshPeer[] {\n            return [...peers.values()].map((peer) => ({ ...peer }));\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"peer-mesh.js","names":["GONE","createPeerMesh","options","links","peers","localTracks","slotWrites","iceServers","describe","connection","description","quality","stopped","samplers","statsTimer","emptyStreams","slots","slot","emitPeers","peer","isLive","link","whileLive","value","step","error","sampleLinks","changed","sampler","createLinkStatsSampler","settings","stats","syncStatsTimer","wanted","refreshState","states","state","applyQuality","next","effective","scaleForRoom","degradation","resolveDegradation","applyQualityToLink","makeOffer","offer","streamFor","event","attachRemoteTrack","slotOf","current","enqueueWrite","queued","write","writeSlot","transceiver","index","attachLocalTracks","removePeer","peerId","addPeer","pc","createPeerConnection","transceivers","offerer","acceptOffer","from","drainCandidates","adoptTransceivers","answer","send","message","applied","acceptCandidate","track","entry","servers"],"sources":["../../src/webrtc/peer-mesh.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — the mesh is one object's lifetime: a link's\n * transceivers, the offer it owes, the tracks published on it and the share of\n * the uplink it costs all change together, and every method here reads or writes\n * the same two maps. The pieces that *could* stand alone already do —\n * `peer-link.ts` for the per-connection mechanics and `mesh-quality.ts` for the\n * division — and what is left is the coordination between them.\n */\nimport { applyQualityToLink, resolveDegradation, scaleForRoom } from \"./mesh-quality\";\nimport {\n    acceptCandidate,\n    adoptTransceivers,\n    createPeerConnection,\n    drainCandidates,\n    slotOf,\n    type PeerLink,\n} from \"./peer-link\";\nimport { createLinkStatsSampler, type LinkStats, type LinkStatsSampler } from \"./link-stats\";\nimport type {\n    MeshMessage,\n    MeshPeer,\n    MeshQuality,\n    MeshStatsOptions,\n    PeerMeshOptions,\n} from \"./mesh-types\";\n\n/** What {@link createPeerMesh}'s negotiation steps return once their link is gone. */\nconst GONE = Symbol(\"gone\");\n\n/** A running mesh. */\nexport interface PeerMesh {\n    /**\n     * Open a link to a peer.\n     *\n     * `offerer` decides which side sends the offer, and exactly one side of each\n     * link must say `true`. Drive it from the arrival order your server already\n     * imposes — the peer that joined **later** offers, the one already in the\n     * room answers. That avoids glare by construction, without the rollback\n     * dance of perfect negotiation and without depending on a browser\n     * implementing argument-less `setLocalDescription`.\n     */\n    addPeer: (peerId: string, options: { offerer: boolean }) => Promise<void>;\n    /** Close one link and give its share of the uplink back to the others. */\n    removePeer: (peerId: string) => void;\n    /** Feed the mesh an `offer`, `answer` or `ice` message from `from`. */\n    accept: (message: MeshMessage & { from: string }) => Promise<void>;\n    /**\n     * Publish or retract one slot across every live link.\n     *\n     * `null` retracts: the sender keeps its negotiated transceiver and stops\n     * producing, which is what mutes a microphone without disturbing the other\n     * slots or the connection. Nothing renegotiates — the m-lines were allocated\n     * before any track existed, which is what makes a mesh survive toggling: a\n     * renegotiation per toggle is N-1 simultaneous offer/answer rounds every time\n     * somebody unmutes.\n     */\n    setLocalTrack: (slot: string, track: MediaStreamTrack | null) => Promise<void>;\n    /** Apply encoder limits, divided by the current size of the room. */\n    applyQuality: (quality: MeshQuality) => Promise<void>;\n    /** Replace the ICE servers used for links opened from now on. */\n    setIceServers: (servers: RTCIceServer[]) => void;\n    /**\n     * Close every link, forget the local tracks and report `closed` — for good.\n     *\n     * Stopping is terminal. The signalling socket usually outlives the call, so\n     * an offer still in flight from a former participant, or from anyone the\n     * server relays to this user, keeps reaching {@link PeerMesh.accept} after\n     * the hang-up. A stopped mesh drops it: no connection is opened, nothing is\n     * answered and no track is published, so a call that reports `closed` never\n     * sends the microphone or camera again. The same holds for `addPeer`,\n     * `setLocalTrack` and `applyQuality`, and for every negotiation that was\n     * already awaiting the browser when `stop()` ran. Calling it twice is a\n     * no-op.\n     *\n     * The tracks themselves are not stopped: they belong to the caller, who may\n     * still be showing them in a preview or reusing them on the next call. To\n     * join again, create a new mesh.\n     */\n    stop: () => void;\n    /** The peers as the mesh currently sees them. */\n    readonly peers: MeshPeer[];\n    /**\n     * The connection carrying one peer's link, or `null`.\n     *\n     * The escape hatch for everything this mesh does not model. `getStats()`,\n     * `getSenders()`, an `RTCDataChannel`, an encoding tweak the `quality`\n     * shape has no field for — all of it lives on the connection, and a mesh\n     * that keeps it private turns adopting the mesh into losing a feature.\n     *\n     * {@link MeshPeer.connection} is the *state*, which is what a view needs;\n     * this is the object, which is what a measurement needs. For the common\n     * case of measuring, {@link PeerMeshOptions.stats} spares you the loop —\n     * including the one-sampler-per-connection rule that a hand-rolled version\n     * gets wrong.\n     *\n     * @param peerId - The id the peer was added under.\n     * @returns The connection, or `null` when there is no link for that id.\n     */\n    getConnection: (peerId: string) => RTCPeerConnection | null;\n}\n\n/**\n * One `RTCPeerConnection` per peer, with the slots negotiated up front.\n *\n * The signalling protocol stays yours: this produces and accepts three message\n * shapes (`offer`, `answer`, `ice`) and leaves delivery, room membership and\n * identity to your server. What it owns is the part that is the same in every\n * mesh and wrong in most of them — see {@link PeerMesh} for the traps each\n * method exists to avoid.\n *\n * @param options - See {@link PeerMeshOptions}.\n * @returns The mesh.\n *\n * @example\n * const mesh = createPeerMesh({\n *     slots: [\n *         { name: \"mic\", kind: \"audio\" },\n *         { name: \"cam\", kind: \"video\" },\n *     ],\n *     send: (message) => socket.send(message),\n *     onPeers: setPeers,\n * });\n * socket.onMessage = (message) => void mesh.accept(message);\n * await mesh.addPeer(\"peer-2\", { offerer: true });\n * await mesh.setLocalTrack(\"mic\", micTrack);\n */\nexport function createPeerMesh(options: PeerMeshOptions): PeerMesh {\n    const { slots, send } = options;\n    const links = new Map<string, PeerLink>();\n    const peers = new Map<string, MeshPeer>();\n    const localTracks = new Map<string, MediaStreamTrack | null>();\n    const slotWrites = new Map<string, Promise<void>>();\n    let iceServers = options.iceServers ?? [];\n    const describe =\n        options.setLocalDescription ??\n        ((connection: RTCPeerConnection, description: RTCSessionDescriptionInit) =>\n            connection.setLocalDescription(description));\n    let quality: MeshQuality = options.quality ?? {};\n    let stopped = false;\n    const samplers = new Map<string, LinkStatsSampler>();\n    let statsTimer: ReturnType<typeof setInterval> | null = null;\n\n    const emptyStreams = (): Record<string, MediaStream | null> =>\n        Object.fromEntries(slots.map((slot) => [slot.name, null]));\n\n    const emitPeers = (): void => {\n        options.onPeers?.([...peers.values()].map((peer) => ({ ...peer })));\n    };\n\n    /**\n     * Whether a link is still the one the mesh holds for its peer.\n     *\n     * Every negotiation step awaits the browser, and `stop()` or `removePeer()`\n     * can close the link inside any of those awaits. A continuation that does\n     * not re-check keeps negotiating on a closed connection — which a browser\n     * answers with `InvalidStateError` — or, worse, signals an answer for a call\n     * that already hung up.\n     *\n     * @param link - The link a continuation is about to touch.\n     * @returns `false` once the mesh stopped or the link was removed or replaced.\n     */\n    const isLive = (link: PeerLink): boolean => !stopped && links.get(link.peerId) === link;\n\n    /**\n     * Await one negotiation step, and tell the caller whether to go on.\n     *\n     * A browser settles a call that `close()` ran under in one of two ways:\n     * it rejects with `InvalidStateError`, or — what Chromium was measured\n     * doing — it never settles at all. The second needs nothing here; the\n     * first would surface as a rejected `accept()`, which the documented\n     * `void mesh.accept(message)` wiring turns into an unhandled rejection\n     * for a call that already hung up. So a rejection on a link that is no\n     * longer live is swallowed, and one on a live link is rethrown untouched.\n     *\n     * @param link - The link the step negotiates on.\n     * @param step - The pending browser call.\n     * @returns The step's value, or {@link GONE} when the link stopped being live.\n     */\n    const whileLive = async <T>(link: PeerLink, step: Promise<T>): Promise<T | typeof GONE> => {\n        try {\n            const value = await step;\n            return isLive(link) ? value : GONE;\n        } catch (error) {\n            if (!isLive(link)) return GONE;\n            throw error;\n        }\n    };\n\n    /**\n     * Sample every connected link once.\n     *\n     * Only `connected` links are asked. A link still gathering candidates has\n     * no traffic to measure, and asking anyway spends a `getStats()` round trip\n     * to learn that — per link, on every tick.\n     *\n     * `settings` arrives as an argument rather than being read from `options`\n     * here: the timer is only ever armed past the check that they exist, so\n     * reading them again would add a branch that nothing can reach.\n     *\n     * Each link is sampled on its own: a `getStats()` that rejects — a link\n     * closing under the call does that — skips that link for this tick and\n     * leaves the others measured. Across the await the link is re-checked by\n     * identity, not by id: a peer removed and re-added under the same id holds\n     * a new connection, and the old one's sample must not land on it.\n     *\n     * @param settings - The measuring options, already known to be present.\n     */\n    const sampleLinks = async (settings: MeshStatsOptions): Promise<void> => {\n        if (stopped) return;\n        let changed = false;\n\n        for (const link of [...links.values()]) {\n            if (link.pc.connectionState !== \"connected\") continue;\n            let sampler = samplers.get(link.peerId);\n            if (sampler === undefined) {\n                sampler = createLinkStatsSampler(\n                    settings.kind === undefined ? {} : { kind: settings.kind },\n                );\n                samplers.set(link.peerId, sampler);\n            }\n            let stats: LinkStats;\n            try {\n                stats = await sampler.sample(link.pc);\n            } catch {\n                continue;\n            }\n            const peer = peers.get(link.peerId);\n            if (!isLive(link) || peer === undefined) continue;\n            peer.stats = stats;\n            changed = true;\n            settings.onStats?.(link.peerId, stats);\n        }\n\n        if (changed) emitPeers();\n    };\n\n    /**\n     * Keep the timer alive exactly while there is something to measure.\n     *\n     * One timer for the whole mesh, not one per peer — and none at all in an\n     * empty room, which is where a call sits for as long as the first person is\n     * early.\n     */\n    const syncStatsTimer = (): void => {\n        const settings = options.stats;\n        if (settings === undefined) return;\n        const wanted = !stopped && links.size > 0;\n        if (wanted && statsTimer === null) {\n            statsTimer = setInterval(() => void sampleLinks(settings), settings.intervalMs ?? 2000);\n            return;\n        }\n        if (!wanted && statsTimer !== null) {\n            clearInterval(statsTimer);\n            statsTimer = null;\n        }\n    };\n\n    /**\n     * Collapse the per-link states into the one badge a call shows.\n     *\n     * No links at all is `connected`, not a failure: it means nobody else is in\n     * the room yet, which is a legitimate state a call sits in for as long as the\n     * first person is early.\n     */\n    const refreshState = (): void => {\n        if (stopped) return;\n        const states = [...links.values()].map((link) => link.pc.connectionState);\n        if (states.some((state) => state === \"connected\")) options.onState?.(\"connected\");\n        else if (states.length > 0) options.onState?.(\"connecting\", \"negotiating\");\n        else options.onState?.(\"connected\", \"alone\");\n    };\n\n    const applyQuality = async (next: MeshQuality): Promise<void> => {\n        if (stopped) return;\n        quality = next;\n        const effective = scaleForRoom(next, links.size);\n        const degradation = resolveDegradation(next, effective);\n        for (const link of links.values()) {\n            await applyQualityToLink(link.transceivers, slots, effective, degradation);\n        }\n    };\n\n    const makeOffer = async (link: PeerLink): Promise<void> => {\n        if (link.makingOffer) return;\n        link.makingOffer = true;\n        try {\n            const offer = await link.pc.createOffer();\n            if (!isLive(link)) return;\n            if (!offer.sdp) {\n                options.onNotice?.(\"empty_local_offer_sdp\");\n                return;\n            }\n            await describe(link.pc, offer);\n            if (!isLive(link)) return;\n            send({\n                type: \"offer\",\n                to: link.peerId,\n                sdp: link.pc.localDescription?.sdp ?? offer.sdp,\n            });\n        } catch {\n            if (isLive(link)) options.onNotice?.(\"offer_failed\");\n        } finally {\n            link.makingOffer = false;\n        }\n    };\n\n    /**\n     * Wrap an inbound track in the stream the caller renders.\n     *\n     * The event's own stream is preferred: it is the one the sending side\n     * grouped the track into, so a caller that reads `stream.id` sees what the\n     * peer published rather than a wrapper invented here. Browsers only fill it\n     * when the offer named a stream, hence the fallback — and the guard after\n     * that is for a runtime with no `MediaStream` at all, where routing still\n     * has to not throw.\n     */\n    const streamFor = (event: RTCTrackEvent): MediaStream | null => {\n        const provided = event.streams?.[0];\n        if (provided) return provided;\n        return typeof MediaStream === \"undefined\" ? null : new MediaStream([event.track]);\n    };\n\n    const attachRemoteTrack = (link: PeerLink, event: RTCTrackEvent): void => {\n        const slot = slotOf(event.transceiver, link, slots);\n        const peer = peers.get(link.peerId);\n        if (!slot || !peer) return;\n\n        peer.streams = { ...peer.streams, [slot.name]: streamFor(event) };\n        event.track.onended = (): void => {\n            const current = peers.get(link.peerId);\n            if (!current) return;\n            current.streams = { ...current.streams, [slot.name]: null };\n            emitPeers();\n        };\n        emitPeers();\n    };\n\n    /**\n     * Queue one write behind every earlier write to the same slot.\n     *\n     * Every write that puts a local track on a sender goes through here — the\n     * fan-out of `setLocalTrack` and the first write onto a link that just\n     * got its transceivers alike. Two writes to one slot therefore never run\n     * at once, and a write queued later always finishes later.\n     *\n     * @param slot - The slot name.\n     * @param write - The write to run once the earlier ones have finished.\n     * @returns The queued write.\n     */\n    const enqueueWrite = (slot: string, write: () => Promise<void>): Promise<void> => {\n        const queued = (slotWrites.get(slot) ?? Promise.resolve()).then(write);\n        slotWrites.set(slot, queued);\n        return queued;\n    };\n\n    /**\n     * Put a slot's current track on one link's sender.\n     *\n     * The track is read when the write runs, not when it was queued, so the\n     * last `setLocalTrack` wins whichever write lands last. A refusal\n     * belongs to a link that is tearing down, whose state handler removes it,\n     * so it is not an error here.\n     *\n     * @param link - The link to write onto.\n     * @param slot - The slot name.\n     * @param index - The slot's position in `slots`, which is its transceiver.\n     */\n    const writeSlot = async (link: PeerLink, slot: string, index: number): Promise<void> => {\n        const transceiver = link.transceivers[index];\n        if (!transceiver || !isLive(link)) return;\n        try {\n            await transceiver.sender.replaceTrack(localTracks.get(slot) ?? null);\n        } catch {\n            return;\n        }\n    };\n\n    /**\n     * Publish every held local track onto a link whose transceivers now exist.\n     *\n     * Up front for the offerer, after the offer lands for the answerer, so a\n     * microphone that was already live when the peer joined starts flowing\n     * without waiting for a toggle. Each slot's write joins that slot's queue,\n     * so a mute issued while it is in flight still has the last word.\n     *\n     * @param link - The link to publish onto.\n     */\n    const attachLocalTracks = (link: PeerLink): Promise<unknown> =>\n        Promise.all(\n            slots.map((slot, index) =>\n                enqueueWrite(slot.name, () => writeSlot(link, slot.name, index)),\n            ),\n        );\n\n    const removePeer = (peerId: string): void => {\n        if (stopped) return;\n        const link = links.get(peerId);\n        if (link) {\n            link.pc.close();\n            links.delete(peerId);\n        }\n        peers.delete(peerId);\n        samplers.delete(peerId);\n        void applyQuality(quality);\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n    };\n\n    const addPeer = async (peerId: string, { offerer }: { offerer: boolean }): Promise<void> => {\n        if (stopped || links.has(peerId)) return;\n\n        const pc = createPeerConnection(iceServers);\n        let transceivers: RTCRtpTransceiver[] = [];\n        if (offerer) {\n            try {\n                transceivers = slots.map((slot) =>\n                    pc.addTransceiver(slot.kind, { direction: \"sendrecv\" }),\n                );\n            } catch (error) {\n                pc.close();\n                throw error;\n            }\n        }\n        const link: PeerLink = {\n            peerId,\n            pc,\n            transceivers,\n            pendingCandidates: [],\n            remoteReady: false,\n            makingOffer: false,\n            isOfferer: offerer,\n        };\n        links.set(peerId, link);\n        peers.set(peerId, {\n            peerId,\n            connection: pc.connectionState,\n            streams: peers.get(peerId)?.streams ?? emptyStreams(),\n        });\n\n        if (offerer) {\n            await attachLocalTracks(link);\n            if (!isLive(link)) return;\n        }\n\n        pc.onicecandidate = (event): void => {\n            send({\n                type: \"ice\",\n                to: peerId,\n                candidate: event.candidate?.candidate ?? null,\n                sdpMid: event.candidate?.sdpMid ?? null,\n                sdpMLineIndex: event.candidate?.sdpMLineIndex ?? null,\n            });\n        };\n\n        pc.ontrack = (event): void => attachRemoteTrack(link, event);\n\n        pc.onconnectionstatechange = (): void => {\n            if (!isLive(link)) return;\n            const peer = peers.get(peerId);\n            if (peer) peer.connection = pc.connectionState;\n            if (pc.connectionState === \"failed\" || pc.connectionState === \"closed\") {\n                removePeer(peerId);\n                return;\n            }\n            emitPeers();\n            refreshState();\n        };\n\n        pc.onnegotiationneeded = (): void => {\n            if (link.isOfferer) void makeOffer(link);\n        };\n\n        syncStatsTimer();\n        emitPeers();\n        refreshState();\n        if (offerer) await makeOffer(link);\n    };\n\n    const acceptOffer = async (from: string, sdp: string): Promise<void> => {\n        if (!links.has(from)) await addPeer(from, { offerer: false });\n        const link = links.get(from);\n        if (!link || !isLive(link)) return;\n\n        if (\n            (await whileLive(link, link.pc.setRemoteDescription({ type: \"offer\", sdp }))) === GONE\n        ) {\n            return;\n        }\n        link.remoteReady = true;\n        await drainCandidates(link);\n\n        if (!link.isOfferer) {\n            adoptTransceivers(link);\n            await attachLocalTracks(link);\n        }\n        if (!isLive(link)) return;\n\n        const answer = await whileLive(link, link.pc.createAnswer());\n        if (answer === GONE) return;\n        if (!answer.sdp) {\n            options.onNotice?.(\"empty_local_answer_sdp\");\n            return;\n        }\n        if ((await whileLive(link, describe(link.pc, answer))) === GONE) return;\n        send({ type: \"answer\", to: from, sdp: link.pc.localDescription?.sdp ?? answer.sdp });\n        await applyQuality(quality);\n    };\n\n    const accept = async (message: MeshMessage & { from: string }): Promise<void> => {\n        if (stopped) return;\n        if (message.type === \"offer\") {\n            await acceptOffer(message.from, message.sdp);\n            return;\n        }\n\n        const link = links.get(message.from);\n        if (!link) return;\n\n        if (message.type === \"answer\") {\n            const applied = link.pc.setRemoteDescription({ type: \"answer\", sdp: message.sdp });\n            if ((await whileLive(link, applied)) === GONE) return;\n            link.remoteReady = true;\n            await drainCandidates(link);\n            await applyQuality(quality);\n            return;\n        }\n\n        if (message.candidate === null) return;\n        await acceptCandidate(link, {\n            candidate: message.candidate,\n            sdpMid: message.sdpMid ?? undefined,\n            sdpMLineIndex: message.sdpMLineIndex ?? undefined,\n        });\n    };\n\n    /**\n     * Publish or retract one slot, one write at a time per slot.\n     *\n     * Writes to a slot are chained, and each publishes whatever the slot holds\n     * when it runs. Without the chain, an unmute whose `replaceTrack` is still\n     * in flight could finish after the mute that followed it, leaving the\n     * sender on the microphone while the mesh believes the slot is empty.\n     */\n    const setLocalTrack = async (slot: string, track: MediaStreamTrack | null): Promise<void> => {\n        if (stopped) return;\n        localTracks.set(slot, track);\n        const index = slots.findIndex((entry) => entry.name === slot);\n        if (index < 0) return;\n\n        await enqueueWrite(slot, async () => {\n            for (const link of [...links.values()]) await writeSlot(link, slot, index);\n        });\n        await applyQuality(quality);\n    };\n\n    const stop = (): void => {\n        if (stopped) return;\n        stopped = true;\n        for (const link of links.values()) link.pc.close();\n        links.clear();\n        peers.clear();\n        samplers.clear();\n        localTracks.clear();\n        syncStatsTimer();\n        emitPeers();\n        options.onState?.(\"closed\");\n    };\n\n    options.onState?.(\"connecting\", \"signaling\");\n\n    return {\n        addPeer,\n        removePeer,\n        accept,\n        setLocalTrack,\n        applyQuality,\n        setIceServers: (servers): void => {\n            iceServers = servers;\n        },\n        stop,\n        getConnection: (peerId: string): RTCPeerConnection | null => links.get(peerId)?.pc ?? null,\n        get peers(): MeshPeer[] {\n            return [...peers.values()].map((peer) => ({ ...peer }));\n        },\n    };\n}\n"],"mappings":"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"}

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

@@ -1 +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"}
+{"version":3,"file":"sender-bitrate.cjs","names":["setSenderBitrate","parameters","sender","encoding","maxBitrate"],"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,eAAsBA,EAClB,EACA,EACgB,CAChB,GAAI,CACA,IAAMC,EAAaC,EAAO,cAAc,GACpC,CAACD,EAAW,WAAaA,EAAW,UAAU,SAAW,KACzD,EAAW,UAAY,CAAC,CAAC,CAAC,GAE9B,IAAK,IAAME,KAAYF,EAAW,UAC1BG,IAAe,KAAM,OAAOD,EAAS,WACpC,EAAS,WAAaC,EAG/B,OADA,MAAMF,EAAO,cAAcD,CAAU,EAC9B,EACX,MAAQ,CACJ,MAAO,EACX,CACJ,C"}

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

@@ -1 +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"}
+{"version":3,"file":"sender-bitrate.js","names":["setSenderBitrate","parameters","sender","encoding","maxBitrate"],"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,eAAsBA,EAClB,GACA,GACgB;CAChB,IAAI;EACA,IAAMC,IAAaC,EAAO,cAAc;EACxC,CAAI,CAACD,EAAW,aAAaA,EAAW,UAAU,WAAW,OACzD,EAAW,YAAY,CAAC,CAAC,CAAC;EAE9B,KAAK,IAAME,KAAYF,EAAW,WAC9B,AAAIG,MAAe,OAAM,OAAOD,EAAS,aACpC,EAAS,aAAaC;EAG/B,OADA,MAAMF,EAAO,cAAcD,CAAU,GAC9B;CACX,QAAQ;EACJ,OAAO;CACX;AACJ"}

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

@@ -1 +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"}
+{"version":3,"file":"use-link-stats.cjs","names":["useState","useRef","useDocumentVisibility","createLinkStatsSampler","require_use_document_visibility","require_use_interval","require_link_stats","react","useLinkStats","options","stats","setStats","samplerRef","inFlightRef","visibility","hidden","pauseWhenHidden","kind","connection","sampler","next","intervalMs"],"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":"A,oJAsDA,SAAgBQ,EACZ,EACA,EAA+B,CAAC,EAChB,CAChB,GAAM,CAAE,aAAa,IAAM,kBAAkB,GAAM,QAASC,EACtD,CAACC,EAAOC,IAAA,EAAYX,EAAAA,SAAAA,CAA2B,IAAI,EACnDY,GAAA,EAAaX,EAAAA,OAAAA,CAAgC,IAAI,EACjDY,GAAA,EAAcZ,EAAAA,OAAAA,CAAO,EAAK,EAC1Ba,EAAaZ,EAAAA,sBAAsB,EACnCa,EAASC,GAAmBF,IAAe,SA+BjD,OA7BA,EAAAP,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAUJ,EAAAA,uBAAuBc,IAAS,IAAA,GAAY,CAAC,EAAI,CAAE,MAAK,CAAC,EAC9EN,EAAS,IAAI,CACjB,EAAG,CAACO,EAAYD,CAAI,CAAC,GAErB,EAAAV,EAAA,UAAA,KAAgB,CACPQ,GAAQH,EAAW,SAAS,MAAM,CAC3C,EAAG,CAACG,CAAM,CAAC,EAIXV,EAAA,gBACU,CACF,IAAMc,EAAUP,EAAW,QACvBM,IAAe,MAAQC,IAAY,MACnCD,EAAW,kBAAoB,cAC/BL,EAAY,UAChB,EAAY,QAAU,GACtBM,EACK,OAAOD,CAAU,CAAC,CAClB,KAAM,GAASP,EAASS,CAAI,CAAC,CAAC,CAC9B,UAAY,IAAA,EAAS,CAAC,CACtB,YAAc,CACX,EAAY,QAAU,EAC1B,CAAC,GACT,EAhBWF,IAAe,MAAQH,EAiBzB,KAAOM,CACpB,EAEOX,CACX,C"}

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

@@ -1 +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"}
+{"version":3,"file":"use-link-stats.js","names":["useLinkStats","options","stats","setStats","useState","samplerRef","useRef","inFlightRef","visibility","useDocumentVisibility","hidden","pauseWhenHidden","useEffect","createLinkStatsSampler","kind","connection","useInterval","sampler","next","intervalMs"],"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,SAAgBA,EACZ,GACA,IAA+B,CAAC,GAChB;CAChB,IAAM,EAAE,gBAAa,KAAM,qBAAkB,IAAM,YAASC,GACtD,CAACC,GAAOC,KAAYC,EAA2B,IAAI,GACnDC,IAAaC,EAAgC,IAAI,GACjDC,IAAcD,EAAO,EAAK,GAC1BE,IAAaC,EAAsB,GACnCC,IAASC,KAAmBH,MAAe;CA+BjD,OA7BAI,QAAgB;EAEZ,AADA,EAAW,UAAUC,EAAuBC,MAAS,KAAA,IAAY,CAAC,IAAI,EAAE,QAAK,CAAC,GAC9EX,EAAS,IAAI;CACjB,GAAG,CAACY,GAAYD,CAAI,CAAC,GAErBF,QAAgB;EACZ,AAAKF,KAAQL,EAAW,SAAS,MAAM;CAC3C,GAAG,CAACK,CAAM,CAAC,GAIXM,QACU;EACF,IAAMC,IAAUZ,EAAW;EAC3B,AAAIU,MAAe,QAAQE,MAAY,QACnCF,EAAW,oBAAoB,gBAC/BR,EAAY,YAChB,EAAY,UAAU,IACtBU,EACK,OAAOF,CAAU,CAAC,CAClB,MAAM,MAASZ,EAASe,CAAI,CAAC,CAAC,CAC9B,YAAY,KAAA,CAAS,CAAC,CACtB,cAAc;GACX,EAAY,UAAU;EAC1B,CAAC;CACT,GAhBWH,MAAe,QAAQL,IAiBzB,OAAOS,CACpB,GAEOjB;AACX"}

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

@@ -1,2 +1,2 @@
-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,schema:re,onValidationError:ie,onStatusChange:ae,onReconnecting:x,onReconnected:S,onLost:C}=r,w=null,T=null,E=null,D=null,O=null,k=null,A=l,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 B(e){if(!e.includes(`"ping"`))return!1;try{return z(JSON.parse(e))}catch{return!1}}function V(e){for(;F.length>0&&e.readyState===WebSocket.OPEN;)e.send(F.shift())}function H(e){M!==e&&(M=e,ae?.(e))}function U(){E&&=(clearInterval(E),null)}function W(){D&&=(clearTimeout(D),null)}function G(){O&&=(clearTimeout(O),null)}function K(){!d||d<=0||(U(),E=setInterval(()=>{w?.readyState===WebSocket.OPEN&&w.send(f)},d))}function q(){G(),!(N||A<=0)&&(O=setTimeout(oe,A))}function oe(){G(),!N&&w&&(J(w),w=null,H(`closed`),X())}function se(e){W(),!(N||e.readyState!==WebSocket.CONNECTING)&&(J(e),w===e&&(w=null),H(`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(G(),W(),Z(),e===`rejected`&&(N=!0),H(`error`),!P&&L){let t=L;L=null,I=null,t(Error(`websocket_${e}`))}C?.(e)}function X(){if(N)return;if(j>=a){Y(`exhausted`);return}let e=t.backoffDelay(j,{initialBackoff:o,maxBackoff:s,jitter:ee});if(j+=1,x?.(j,a),u&&typeof navigator<`u`&&navigator.onLine===!1){ce();return}T=setTimeout(Q,e)}function ce(){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,W(),w){let e=w;e.onmessage=null,e.onclose=null,e.onerror=null,e.readyState!==WebSocket.CONNECTING&&(e.onopen=null),$(e)}H(`connecting`);let r=new WebSocket(n,i);w=r,c>0&&(D=setTimeout(()=>se(r),c)),r.onopen=e=>{W();let t=j>0;if(j=0,P=!0,H(`open`),K(),q(),V(r),I){let e=I;I=null,L=null,e()}g?.(e),t&&S?.()},r.onmessage=t=>{q();let n=typeof t.data==`string`?t.data:``,i=e.decodeFrame(n,`createWebSocket`,{parser:ne,onParseError:b,schema:re,onValidationError:ie});if(!i.delivered){p&&r.readyState===WebSocket.OPEN&&B(n)&&r.send(m);return}let a=i.data;p&&z(a)&&r.readyState===WebSocket.OPEN&&r.send(m),_?.({data:a,raw:t})},r.onerror=e=>{y?.(e)},r.onclose=e=>{if(W(),U(),G(),v?.(e),w=null,H(`closed`),!N){if(t.isRejectionCloseCode(e.code)){Y(`rejected`);return}if(t.shouldRetryClose(e.code,e.wasClean)){X();return}P||Y(`rejected`)}}}function le(e){return w?.readyState===WebSocket.OPEN?(w.send(e),!0):!h||N?!1:(F.length>=te&&F.shift(),F.push(e),!0)}function ue(e,t){if(N=!0,T&&=(clearTimeout(T),null),U(),W(),G(),Z(),j=0,F.length=0,L){let e=L;L=null,I=null,e(Error(`websocket_closed`))}w&&=(H(`closing`),$(w,e,t),null),H(`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 de(){T&&=(clearTimeout(T),null),Z(),j=0,N=!1,Q()}function fe(e){A=Number.isFinite(e)&&e>0?e:0,w?.readyState===WebSocket.OPEN?q():G()}return Q(),{send:le,close:ue,reconnect:de,setSilenceTimeout:fe,opened:R,get status(){return M}}}exports.createWebSocket=n;
+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,schema:re,onValidationError:ie,onStatusChange:ae,onReconnecting:x,onReconnected:S,onLost:C}=r,w=null,T=null,E=null,D=null,O=null,k=null,A=l,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 B(e){if(!e.includes(`"ping"`))return!1;try{return z(JSON.parse(e))}catch{return!1}}function V(e){for(;F.length>0&&e.readyState===WebSocket.OPEN;)e.send(F.shift())}function H(e){M!==e&&(M=e,ae?.(e))}function U(){E&&=(clearInterval(E),null)}function W(){D&&=(clearTimeout(D),null)}function G(){O&&=(clearTimeout(O),null)}function K(){!d||d<=0||(U(),E=setInterval(()=>{w?.readyState===WebSocket.OPEN&&w.send(f)},d))}function q(){G(),!(N||A<=0)&&(O=setTimeout(oe,A))}function oe(){G(),!N&&w&&(J(w),w=null,H(`closed`),X())}function se(e){W(),!(N||e.readyState!==WebSocket.CONNECTING)&&(J(e),w===e&&(w=null),H(`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(G(),W(),Z(),e===`rejected`&&(N=!0),H(`error`),!P&&L){let t=L;L=null,I=null,t(Error(`websocket_${e}`))}C?.(e)}function X(){if(N)return;if(j>=a){Y(`exhausted`);return}let e=t.backoffDelay(j,{initialBackoff:o,maxBackoff:s,jitter:ee});j+=1,x?.(j,a),u&&typeof navigator<`u`&&navigator.onLine===!1?ce():T=setTimeout(Q,e)}function ce(){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,W(),w){let e=w;e.onmessage=null,e.onclose=null,e.onerror=null,e.readyState!==WebSocket.CONNECTING&&(e.onopen=null),$(e)}H(`connecting`);let r=new WebSocket(n,i);w=r,c>0&&(D=setTimeout(()=>se(r),c)),r.onopen=e=>{W();let t=j>0;if(j=0,P=!0,H(`open`),K(),q(),V(r),I){let e=I;I=null,L=null,e()}g?.(e),t&&S?.()},r.onmessage=t=>{q();let n=typeof t.data==`string`?t.data:``,i=e.decodeFrame(n,`createWebSocket`,{parser:ne,onParseError:b,schema:re,onValidationError:ie});if(!i.delivered){p&&r.readyState===WebSocket.OPEN&&B(n)&&r.send(m);return}let a=i.data;p&&z(a)&&r.readyState===WebSocket.OPEN&&r.send(m),_?.({data:a,raw:t})},r.onerror=e=>{y?.(e)},r.onclose=e=>{W(),U(),G(),v?.(e),w=null,H(`closed`),!N&&(t.isRejectionCloseCode(e.code)?Y(`rejected`):t.shouldRetryClose(e.code,e.wasClean)?X():P||Y(`rejected`))}}function le(e){return w?.readyState===WebSocket.OPEN?(w.send(e),!0):!h||N?!1:(F.length>=te&&F.shift(),F.push(e),!0)}function ue(e,t){if(N=!0,T&&=(clearTimeout(T),null),U(),W(),G(),Z(),j=0,F.length=0,L){let e=L;L=null,I=null,e(Error(`websocket_closed`))}w&&=(H(`closing`),$(w,e,t),null),H(`closed`)}function $(e,t,n){e.readyState===WebSocket.CONNECTING?(e.onopen=()=>e.close(t,n),e.onmessage=null,e.onerror=null,e.onclose=null):e.close(t,n)}function de(){T&&=(clearTimeout(T),null),Z(),j=0,N=!1,Q()}function fe(e){A=Number.isFinite(e)&&e>0?e:0,w?.readyState===WebSocket.OPEN?q():G()}return Q(),{send:le,close:ue,reconnect:de,setSilenceTimeout:fe,opened:R,get status(){return M}}}exports.createWebSocket=n;
 //# sourceMappingURL=create-web-socket.cjs.map