@vielzeug/mesh 26.11.11 → 26.11.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/guest.cjs +1 -1
- package/dist/guest.cjs.map +1 -1
- package/dist/guest.d.ts.map +1 -1
- package/dist/guest.js +55 -54
- package/dist/guest.js.map +1 -1
- package/dist/mesh.cjs +1 -1
- package/dist/mesh.cjs.map +1 -1
- package/dist/mesh.iife.js +1 -1
- package/dist/mesh.iife.js.map +1 -1
- package/dist/mesh.js +72 -72
- package/dist/mesh.js.map +1 -1
- package/package.json +2 -2
package/dist/guest.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
require("./_defaults.cjs");const e=require("./_node.cjs"),t=require("./_proof.cjs"),n=require("./_random.cjs"),r=require("./_rtc.cjs"),i=require("./errors.cjs");function createMeshGuest(
|
|
1
|
+
require("./_defaults.cjs");const e=require("./_node.cjs"),t=require("./_proof.cjs"),n=require("./_random.cjs"),r=require("./_rtc.cjs"),i=require("./errors.cjs");let a=require("@vielzeug/arsenal");function createMeshGuest(o={}){let s=o.rtc??r.nativeRtcFactory,c=o.clock??(()=>Date.now()),l=o.maxMessageBytes??65536,u=o.channelOpenTimeoutMs??6e4,d=o.iceGatheringTimeoutMs??5e3,f=e.createNodeCore(o.signal),p=e.createMessenger({clock:c,emitTap:f.emitTap,maxMessageBytes:l,random:o.random}),m=null,h=(0,a.timer)(()=>{m?.status===`connecting`&&failPeer(m,openTimeoutError())}),openTimeoutError=()=>new i.MeshTimeoutError(`Timed out waiting ${u}ms for the data channel to open`);function failPeer(e,t){f.disposed||e!==m||e.status===`failed`||(e.status=`failed`,h.cancel(),setTimeout(()=>{e.dc?.close(),e.pc?.close()},0),f.emitTap({peerId:e.id,status:`failed`,type:`peer-status-change`}),f.emitTap({error:t,type:`error`}),f.emitTap({peer:e.publicPeer,reason:t.message,type:`peer-left`}),f.setStatus(`failed`))}function disconnectPeer(e,t){f.disposed||e!==m||e.status!==`disconnected`&&e.status!==`failed`&&(e.status=`disconnected`,e.pc?.close(),f.emitTap({peerId:e.id,status:`disconnected`,type:`peer-status-change`}),f.emitTap({peer:e.publicPeer,reason:t,type:`peer-left`}),f.setStatus(`disconnected`))}function wireChannel(e,t,n){e.dc=n,n.addEventListener(`open`,()=>{f.disposed||(h.cancel(),e.status=`connected`,f.emitTap({peerId:e.id,status:`connected`,type:`peer-status-change`}),f.emitTap({peer:e.publicPeer,type:`peer-joined`}),f.setStatus(`connected`))}),n.addEventListener(`message`,t=>{f.disposed||p.handleInbound(e,t.data)}),n.addEventListener(`close`,()=>{f.disposed||(e.status===`connecting`?failPeer(e,h.pending?openTimeoutError():new i.MeshConnectionError(`channel closed before opening`,e.id)):disconnectPeer(e,`channel closed`))}),n.addEventListener(`error`,()=>{f.disposed||failPeer(e,new i.MeshConnectionError(`channel error`,e.id))}),t.addEventListener(`iceconnectionstatechange`,()=>{if(f.disposed)return;let n=t.iceConnectionState;n===`failed`||n===`closed`?failPeer(e,new i.MeshConnectionError(`ice ${n}`,e.id)):n===`disconnected`&&e.status===`connected`&&disconnectPeer(e,`ice disconnected`)})}return{async acceptInvitation(a,l){if(f.ensureLive(),m&&m.status!==`failed`&&m.status!==`disconnected`)throw new i.MeshPairingError(`Guest is already paired`);if(a?.v!==1)throw new i.MeshPairingError(`Unsupported invitation version`);if(c()>=a.expiresAt)throw new i.MeshPairingError(`Invitation expired`);m&&=(h.cancel(),m.pc?.close(),null),f.setStatus(`pairing`);let p;try{p=s.createPeerConnection({iceServers:[...o.iceServers??[]]})}catch(e){throw f.setStatus(`idle`),e}let g=e.createPeerRecord(a.sessionId,a.hostName,`host`);g.pc=p,m=g,p.addEventListener(`datachannel`,e=>{wireChannel(g,p,e.channel)}),p.addEventListener(`iceconnectionstatechange`,()=>{f.disposed||f.emitTap({peerId:g.id,state:p.iceConnectionState,type:`ice-state`})});try{await p.setRemoteDescription({sdp:r.normalizeSdp(a.sdp),type:`offer`})}catch(e){throw m=null,f.setStatus(`idle`),new i.MeshPairingError(`Invalid invitation SDP`,{cause:e})}let _;try{await p.setLocalDescription(await p.createAnswer()),await r.waitIceGathering(p,d),_=p.localDescription?.sdp??``}catch(e){throw m=null,p.close(),f.setStatus(`idle`),new i.MeshConnectionError(`Failed to create answer`,null,{cause:e})}if(f.disposed)throw p.close(),new i.MeshDisposedError;if(!_)throw m=null,p.close(),f.setStatus(`idle`),new i.MeshConnectionError(`Local description has no SDP`);let v=n.randomId(o.random),y;try{y=await t.createProof(a.secret,_)}catch(e){throw m=null,p.close(),f.setStatus(`idle`),e}return f.setStatus(`connecting`),h.arm(u),{peer:l?.name===void 0?{id:v}:{id:v,name:l.name},proof:y,sdp:_,sessionId:a.sessionId,v:1}},get disposalSignal(){return f.disposalCtrl.signal},dispose(){f.disposed||(f.markDisposed(),h.cancel(),m&&(m.dc?.close(),m.pc?.close()),p.clear())},get disposed(){return f.disposed},get host(){return m?.publicPeer??null},on(e,t){return f.ensureLive(),p.on(e,t)},send(e,t){if(f.ensureLive(),!m)throw new i.MeshConnectionError(`Guest is not paired`);p.sendTo(m,e,t)},get status(){return f.status},tap(e,t){return f.tap(e,t)},[Symbol.dispose](){this.dispose()}}}exports.createMeshGuest=createMeshGuest;
|
|
2
2
|
//# sourceMappingURL=guest.cjs.map
|
package/dist/guest.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guest.cjs","names":["nativeRtcFactory","createNodeCore","createMessenger","MeshTimeoutError","MeshConnectionError","MeshPairingError","createPeerRecord","normalizeSdp","waitIceGathering","MeshDisposedError","randomId","createProof","require__node","require__proof","require__random","require__rtc","require_errors","rtc","options","clock","maxMessageBytes","channelOpenTimeoutMs","iceGatheringTimeoutMs","core","messenger","hostPeer","openTimer","peer","error","dc","event","pc","state","invitation","cause","answerSdp","peerId","proof","meta","type","handler","payload","tapOptions"],"sources":["../src/guest.ts"],"sourcesContent":["import {\n DEFAULT_CHANNEL_OPEN_TIMEOUT_MS,\n DEFAULT_ICE_GATHERING_TIMEOUT_MS,\n DEFAULT_MAX_MESSAGE_BYTES,\n} from './_defaults';\nimport { createMessenger, createNodeCore, createPeerRecord, type PeerRecord } from './_node';\nimport { createProof } from './_proof';\nimport { randomId } from './_random';\nimport { nativeRtcFactory, normalizeSdp, waitIceGathering } from './_rtc';\nimport { MeshConnectionError, MeshDisposedError, type MeshError, MeshPairingError, MeshTimeoutError } from './errors';\nimport type {\n MeshGuest,\n MeshGuestOptions,\n MeshInbound,\n MeshPeer,\n MeshProtocol,\n RTCDataChannelLike,\n RTCPeerConnectionLike,\n} from './types';\n\n/**\n * Create a guest mesh node. The guest pairs with one host by consuming an\n * out-of-band invitation and returning an answer.\n */\nexport function createMeshGuest<P extends MeshProtocol>(options: MeshGuestOptions = {}): MeshGuest<P> {\n const rtc = options.rtc ?? nativeRtcFactory;\n const clock = options.clock ?? (() => Date.now());\n const maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n const channelOpenTimeoutMs = options.channelOpenTimeoutMs ?? DEFAULT_CHANNEL_OPEN_TIMEOUT_MS;\n const iceGatheringTimeoutMs = options.iceGatheringTimeoutMs ?? DEFAULT_ICE_GATHERING_TIMEOUT_MS;\n\n const core = createNodeCore(options.signal);\n const messenger = createMessenger({\n clock,\n emitTap: core.emitTap,\n maxMessageBytes,\n random: options.random,\n });\n\n let hostPeer: PeerRecord | null = null;\n let openTimer: ReturnType<typeof setTimeout> | null = null;\n\n const openTimeoutError = (): MeshTimeoutError =>\n new MeshTimeoutError(`Timed out waiting ${channelOpenTimeoutMs}ms for the data channel to open`);\n\n function failPeer(peer: PeerRecord, error: MeshError): void {\n // Ignore events from a superseded peer after re-pairing replaced hostPeer.\n if (core.disposed || peer !== hostPeer || peer.status === 'failed') return;\n peer.status = 'failed';\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n // Teardown is deferred a macrotask so a peer racing its own open\n // deadline reports its timeout rather than this hangup.\n setTimeout(() => {\n peer.dc?.close();\n peer.pc?.close();\n }, 0);\n core.emitTap({ peerId: peer.id, status: 'failed', type: 'peer-status-change' });\n core.emitTap({ error, type: 'error' });\n core.emitTap({ peer: peer.publicPeer, reason: error.message, type: 'peer-left' });\n core.setStatus('failed');\n }\n\n function disconnectPeer(peer: PeerRecord, reason: string): void {\n if (core.disposed || peer !== hostPeer) return;\n if (peer.status === 'disconnected' || peer.status === 'failed') return;\n peer.status = 'disconnected';\n peer.pc?.close();\n core.emitTap({ peerId: peer.id, status: 'disconnected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, reason, type: 'peer-left' });\n core.setStatus('disconnected');\n }\n\n function wireChannel(peer: PeerRecord, pc: RTCPeerConnectionLike, dc: RTCDataChannelLike): void {\n peer.dc = dc;\n\n dc.addEventListener('open', () => {\n if (core.disposed) return;\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n peer.status = 'connected';\n core.emitTap({ peerId: peer.id, status: 'connected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, type: 'peer-joined' });\n core.setStatus('connected');\n });\n dc.addEventListener('message', (event) => {\n if (core.disposed) return;\n messenger.handleInbound(peer, event.data);\n });\n dc.addEventListener('close', () => {\n if (core.disposed) return;\n if (peer.status === 'connecting')\n failPeer(\n peer,\n openTimer ? openTimeoutError() : new MeshConnectionError('channel closed before opening', peer.id),\n );\n else disconnectPeer(peer, 'channel closed');\n });\n dc.addEventListener('error', () => {\n if (core.disposed) return;\n failPeer(peer, new MeshConnectionError('channel error', peer.id));\n });\n\n // The ice-state emission lives on the pairing-scoped listener above; this\n // one owns channel-lifecycle transitions only, so each ICE change emits\n // exactly one ice-state event.\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n const state = pc.iceConnectionState;\n if (state === 'failed' || state === 'closed') {\n failPeer(peer, new MeshConnectionError(`ice ${state}`, peer.id));\n } else if (state === 'disconnected' && peer.status === 'connected') {\n disconnectPeer(peer, 'ice disconnected');\n }\n });\n }\n\n const guest: MeshGuest<P> = {\n async acceptInvitation(invitation, meta) {\n core.ensureLive();\n // A terminal host peer (failed/disconnected) may be replaced by a fresh\n // pairing on the same node: listeners stay attached and keep working.\n if (hostPeer && hostPeer.status !== 'failed' && hostPeer.status !== 'disconnected') {\n throw new MeshPairingError('Guest is already paired');\n }\n if (invitation?.v !== 1) throw new MeshPairingError('Unsupported invitation version');\n if (clock() >= invitation.expiresAt) throw new MeshPairingError('Invitation expired');\n\n if (hostPeer) {\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n hostPeer.pc?.close();\n hostPeer = null;\n }\n\n core.setStatus('pairing');\n let pc: RTCPeerConnectionLike;\n try {\n pc = rtc.createPeerConnection({ iceServers: [...(options.iceServers ?? [])] });\n } catch (error) {\n core.setStatus('idle');\n throw error;\n }\n\n // The invitation carries no host identity beyond an optional display\n // name: the session id doubles as the host-side peer id for inbound\n // metadata and tap events.\n const peer = createPeerRecord(invitation.sessionId, invitation.hostName, 'host');\n peer.pc = pc;\n hostPeer = peer;\n\n pc.addEventListener('datachannel', (event) => {\n wireChannel(peer, pc, event.channel);\n });\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n core.emitTap({ peerId: peer.id, state: pc.iceConnectionState, type: 'ice-state' });\n });\n\n try {\n await pc.setRemoteDescription({ sdp: normalizeSdp(invitation.sdp), type: 'offer' });\n } catch (cause) {\n hostPeer = null;\n core.setStatus('idle');\n throw new MeshPairingError('Invalid invitation SDP', { cause });\n }\n\n let answerSdp: string;\n try {\n await pc.setLocalDescription(await pc.createAnswer());\n await waitIceGathering(pc, iceGatheringTimeoutMs);\n answerSdp = pc.localDescription?.sdp ?? '';\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Failed to create answer', null, { cause });\n }\n if (core.disposed) {\n pc.close();\n throw new MeshDisposedError();\n }\n if (!answerSdp) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Local description has no SDP');\n }\n\n const peerId = randomId(options.random);\n let proof: string;\n try {\n proof = await createProof(invitation.secret, answerSdp);\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw cause;\n }\n core.setStatus('connecting');\n\n // If the channel never opens (host never accepts the answer), fail loudly\n // instead of hanging in 'connecting' forever. The deadline must cover\n // the human carry-back of the answer, not just machine negotiation.\n openTimer = setTimeout(() => {\n if (hostPeer?.status === 'connecting') {\n failPeer(hostPeer, openTimeoutError());\n }\n }, channelOpenTimeoutMs);\n\n return {\n peer: meta?.name === undefined ? { id: peerId } : { id: peerId, name: meta.name },\n proof,\n sdp: answerSdp,\n sessionId: invitation.sessionId,\n v: 1,\n };\n },\n get disposalSignal() {\n return core.disposalCtrl.signal;\n },\n\n dispose() {\n if (core.disposed) return;\n core.markDisposed();\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n if (hostPeer) {\n hostPeer.dc?.close();\n hostPeer.pc?.close();\n }\n messenger.clear();\n },\n get disposed() {\n return core.disposed;\n },\n get host(): MeshPeer | null {\n return hostPeer?.publicPeer ?? null;\n },\n\n on(type, handler) {\n core.ensureLive();\n return messenger.on(type, handler as (message: MeshInbound<unknown>) => void);\n },\n\n send(type, payload) {\n core.ensureLive();\n if (!hostPeer) throw new MeshConnectionError('Guest is not paired');\n messenger.sendTo(hostPeer, type, payload);\n },\n get status() {\n return core.status;\n },\n\n tap(handler, tapOptions) {\n return core.tap(handler, tapOptions);\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n };\n\n return guest;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"guest.cjs","names":["nativeRtcFactory","createNodeCore","createMessenger","timer","MeshTimeoutError","MeshConnectionError","MeshPairingError","createPeerRecord","normalizeSdp","waitIceGathering","MeshDisposedError","randomId","createProof","require__node","require__proof","require__random","require__rtc","require_errors","_vielzeug_arsenal","rtc","options","clock","maxMessageBytes","channelOpenTimeoutMs","iceGatheringTimeoutMs","core","messenger","hostPeer","openTimer","peer","error","dc","event","pc","state","invitation","cause","answerSdp","peerId","proof","meta","type","handler","payload","tapOptions"],"sources":["../src/guest.ts"],"sourcesContent":["import { timer } from '@vielzeug/arsenal';\nimport {\n DEFAULT_CHANNEL_OPEN_TIMEOUT_MS,\n DEFAULT_ICE_GATHERING_TIMEOUT_MS,\n DEFAULT_MAX_MESSAGE_BYTES,\n} from './_defaults';\nimport { createMessenger, createNodeCore, createPeerRecord, type PeerRecord } from './_node';\nimport { createProof } from './_proof';\nimport { randomId } from './_random';\nimport { nativeRtcFactory, normalizeSdp, waitIceGathering } from './_rtc';\nimport { MeshConnectionError, MeshDisposedError, type MeshError, MeshPairingError, MeshTimeoutError } from './errors';\nimport type {\n MeshGuest,\n MeshGuestOptions,\n MeshInbound,\n MeshPeer,\n MeshProtocol,\n RTCDataChannelLike,\n RTCPeerConnectionLike,\n} from './types';\n\n/**\n * Create a guest mesh node. The guest pairs with one host by consuming an\n * out-of-band invitation and returning an answer.\n */\nexport function createMeshGuest<P extends MeshProtocol>(options: MeshGuestOptions = {}): MeshGuest<P> {\n const rtc = options.rtc ?? nativeRtcFactory;\n const clock = options.clock ?? (() => Date.now());\n const maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n const channelOpenTimeoutMs = options.channelOpenTimeoutMs ?? DEFAULT_CHANNEL_OPEN_TIMEOUT_MS;\n const iceGatheringTimeoutMs = options.iceGatheringTimeoutMs ?? DEFAULT_ICE_GATHERING_TIMEOUT_MS;\n\n const core = createNodeCore(options.signal);\n const messenger = createMessenger({\n clock,\n emitTap: core.emitTap,\n maxMessageBytes,\n random: options.random,\n });\n\n let hostPeer: PeerRecord | null = null;\n const openTimer = timer(() => {\n if (hostPeer?.status === 'connecting') {\n failPeer(hostPeer, openTimeoutError());\n }\n });\n\n const openTimeoutError = (): MeshTimeoutError =>\n new MeshTimeoutError(`Timed out waiting ${channelOpenTimeoutMs}ms for the data channel to open`);\n\n function failPeer(peer: PeerRecord, error: MeshError): void {\n // Ignore events from a superseded peer after re-pairing replaced hostPeer.\n if (core.disposed || peer !== hostPeer || peer.status === 'failed') return;\n peer.status = 'failed';\n openTimer.cancel();\n // Teardown is deferred a macrotask so a peer racing its own open\n // deadline reports its timeout rather than this hangup.\n setTimeout(() => {\n peer.dc?.close();\n peer.pc?.close();\n }, 0);\n core.emitTap({ peerId: peer.id, status: 'failed', type: 'peer-status-change' });\n core.emitTap({ error, type: 'error' });\n core.emitTap({ peer: peer.publicPeer, reason: error.message, type: 'peer-left' });\n core.setStatus('failed');\n }\n\n function disconnectPeer(peer: PeerRecord, reason: string): void {\n if (core.disposed || peer !== hostPeer) return;\n if (peer.status === 'disconnected' || peer.status === 'failed') return;\n peer.status = 'disconnected';\n peer.pc?.close();\n core.emitTap({ peerId: peer.id, status: 'disconnected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, reason, type: 'peer-left' });\n core.setStatus('disconnected');\n }\n\n function wireChannel(peer: PeerRecord, pc: RTCPeerConnectionLike, dc: RTCDataChannelLike): void {\n peer.dc = dc;\n\n dc.addEventListener('open', () => {\n if (core.disposed) return;\n openTimer.cancel();\n peer.status = 'connected';\n core.emitTap({ peerId: peer.id, status: 'connected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, type: 'peer-joined' });\n core.setStatus('connected');\n });\n dc.addEventListener('message', (event) => {\n if (core.disposed) return;\n messenger.handleInbound(peer, event.data);\n });\n dc.addEventListener('close', () => {\n if (core.disposed) return;\n if (peer.status === 'connecting')\n failPeer(\n peer,\n openTimer.pending ? openTimeoutError() : new MeshConnectionError('channel closed before opening', peer.id),\n );\n else disconnectPeer(peer, 'channel closed');\n });\n dc.addEventListener('error', () => {\n if (core.disposed) return;\n failPeer(peer, new MeshConnectionError('channel error', peer.id));\n });\n\n // The ice-state emission lives on the pairing-scoped listener above; this\n // one owns channel-lifecycle transitions only, so each ICE change emits\n // exactly one ice-state event.\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n const state = pc.iceConnectionState;\n if (state === 'failed' || state === 'closed') {\n failPeer(peer, new MeshConnectionError(`ice ${state}`, peer.id));\n } else if (state === 'disconnected' && peer.status === 'connected') {\n disconnectPeer(peer, 'ice disconnected');\n }\n });\n }\n\n const guest: MeshGuest<P> = {\n async acceptInvitation(invitation, meta) {\n core.ensureLive();\n // A terminal host peer (failed/disconnected) may be replaced by a fresh\n // pairing on the same node: listeners stay attached and keep working.\n if (hostPeer && hostPeer.status !== 'failed' && hostPeer.status !== 'disconnected') {\n throw new MeshPairingError('Guest is already paired');\n }\n if (invitation?.v !== 1) throw new MeshPairingError('Unsupported invitation version');\n if (clock() >= invitation.expiresAt) throw new MeshPairingError('Invitation expired');\n\n if (hostPeer) {\n openTimer.cancel();\n hostPeer.pc?.close();\n hostPeer = null;\n }\n\n core.setStatus('pairing');\n let pc: RTCPeerConnectionLike;\n try {\n pc = rtc.createPeerConnection({ iceServers: [...(options.iceServers ?? [])] });\n } catch (error) {\n core.setStatus('idle');\n throw error;\n }\n\n // The invitation carries no host identity beyond an optional display\n // name: the session id doubles as the host-side peer id for inbound\n // metadata and tap events.\n const peer = createPeerRecord(invitation.sessionId, invitation.hostName, 'host');\n peer.pc = pc;\n hostPeer = peer;\n\n pc.addEventListener('datachannel', (event) => {\n wireChannel(peer, pc, event.channel);\n });\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n core.emitTap({ peerId: peer.id, state: pc.iceConnectionState, type: 'ice-state' });\n });\n\n try {\n await pc.setRemoteDescription({ sdp: normalizeSdp(invitation.sdp), type: 'offer' });\n } catch (cause) {\n hostPeer = null;\n core.setStatus('idle');\n throw new MeshPairingError('Invalid invitation SDP', { cause });\n }\n\n let answerSdp: string;\n try {\n await pc.setLocalDescription(await pc.createAnswer());\n await waitIceGathering(pc, iceGatheringTimeoutMs);\n answerSdp = pc.localDescription?.sdp ?? '';\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Failed to create answer', null, { cause });\n }\n if (core.disposed) {\n pc.close();\n throw new MeshDisposedError();\n }\n if (!answerSdp) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Local description has no SDP');\n }\n\n const peerId = randomId(options.random);\n let proof: string;\n try {\n proof = await createProof(invitation.secret, answerSdp);\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw cause;\n }\n core.setStatus('connecting');\n\n // If the channel never opens (host never accepts the answer), fail loudly\n // instead of hanging in 'connecting' forever. The deadline must cover\n // the human carry-back of the answer, not just machine negotiation.\n openTimer.arm(channelOpenTimeoutMs);\n\n return {\n peer: meta?.name === undefined ? { id: peerId } : { id: peerId, name: meta.name },\n proof,\n sdp: answerSdp,\n sessionId: invitation.sessionId,\n v: 1,\n };\n },\n get disposalSignal() {\n return core.disposalCtrl.signal;\n },\n\n dispose() {\n if (core.disposed) return;\n core.markDisposed();\n openTimer.cancel();\n if (hostPeer) {\n hostPeer.dc?.close();\n hostPeer.pc?.close();\n }\n messenger.clear();\n },\n get disposed() {\n return core.disposed;\n },\n get host(): MeshPeer | null {\n return hostPeer?.publicPeer ?? null;\n },\n\n on(type, handler) {\n core.ensureLive();\n return messenger.on(type, handler as (message: MeshInbound<unknown>) => void);\n },\n\n send(type, payload) {\n core.ensureLive();\n if (!hostPeer) throw new MeshConnectionError('Guest is not paired');\n messenger.sendTo(hostPeer, type, payload);\n },\n get status() {\n return core.status;\n },\n\n tap(handler, tapOptions) {\n return core.tap(handler, tapOptions);\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n };\n\n return guest;\n}\n"],"mappings":"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"}
|
package/dist/guest.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guest.d.ts","sourceRoot":"","sources":["../src/guest.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"guest.d.ts","sourceRoot":"","sources":["../src/guest.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAGhB,YAAY,EAGb,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAAC,CAAC,CAAC,CA4OpG"}
|
package/dist/guest.js
CHANGED
|
@@ -4,80 +4,83 @@ import { createProof as r } from "./_proof.js";
|
|
|
4
4
|
import { randomId as i } from "./_random.js";
|
|
5
5
|
import { nativeRtcFactory as a, normalizeSdp as o, waitIceGathering as s } from "./_rtc.js";
|
|
6
6
|
import { MeshConnectionError as c, MeshDisposedError as l, MeshPairingError as u, MeshTimeoutError as d } from "./errors.js";
|
|
7
|
+
import { timer as f } from "@vielzeug/arsenal";
|
|
7
8
|
// src/guest.ts
|
|
8
|
-
function createMeshGuest(
|
|
9
|
-
let
|
|
10
|
-
clock:
|
|
11
|
-
emitTap:
|
|
12
|
-
maxMessageBytes:
|
|
13
|
-
random:
|
|
14
|
-
}),
|
|
9
|
+
function createMeshGuest(p = {}) {
|
|
10
|
+
let m = p.rtc ?? a, h = p.clock ?? (() => Date.now()), g = p.maxMessageBytes ?? 65536, _ = p.channelOpenTimeoutMs ?? 6e4, v = p.iceGatheringTimeoutMs ?? 5e3, y = t(p.signal), b = e({
|
|
11
|
+
clock: h,
|
|
12
|
+
emitTap: y.emitTap,
|
|
13
|
+
maxMessageBytes: g,
|
|
14
|
+
random: p.random
|
|
15
|
+
}), x = null, S = f(() => {
|
|
16
|
+
x?.status === "connecting" && failPeer(x, openTimeoutError());
|
|
17
|
+
}), openTimeoutError = () => new d(`Timed out waiting ${_}ms for the data channel to open`);
|
|
15
18
|
function failPeer(e, t) {
|
|
16
|
-
|
|
19
|
+
y.disposed || e !== x || e.status === "failed" || (e.status = "failed", S.cancel(), setTimeout(() => {
|
|
17
20
|
e.dc?.close(), e.pc?.close();
|
|
18
|
-
}, 0),
|
|
21
|
+
}, 0), y.emitTap({
|
|
19
22
|
peerId: e.id,
|
|
20
23
|
status: "failed",
|
|
21
24
|
type: "peer-status-change"
|
|
22
|
-
}),
|
|
25
|
+
}), y.emitTap({
|
|
23
26
|
error: t,
|
|
24
27
|
type: "error"
|
|
25
|
-
}),
|
|
28
|
+
}), y.emitTap({
|
|
26
29
|
peer: e.publicPeer,
|
|
27
30
|
reason: t.message,
|
|
28
31
|
type: "peer-left"
|
|
29
|
-
}),
|
|
32
|
+
}), y.setStatus("failed"));
|
|
30
33
|
}
|
|
31
34
|
function disconnectPeer(e, t) {
|
|
32
|
-
|
|
35
|
+
y.disposed || e !== x || e.status !== "disconnected" && e.status !== "failed" && (e.status = "disconnected", e.pc?.close(), y.emitTap({
|
|
33
36
|
peerId: e.id,
|
|
34
37
|
status: "disconnected",
|
|
35
38
|
type: "peer-status-change"
|
|
36
|
-
}),
|
|
39
|
+
}), y.emitTap({
|
|
37
40
|
peer: e.publicPeer,
|
|
38
41
|
reason: t,
|
|
39
42
|
type: "peer-left"
|
|
40
|
-
}),
|
|
43
|
+
}), y.setStatus("disconnected"));
|
|
41
44
|
}
|
|
42
45
|
function wireChannel(e, t, n) {
|
|
43
46
|
e.dc = n, n.addEventListener("open", () => {
|
|
44
|
-
|
|
47
|
+
y.disposed || (S.cancel(), e.status = "connected", y.emitTap({
|
|
45
48
|
peerId: e.id,
|
|
46
49
|
status: "connected",
|
|
47
50
|
type: "peer-status-change"
|
|
48
|
-
}),
|
|
51
|
+
}), y.emitTap({
|
|
49
52
|
peer: e.publicPeer,
|
|
50
53
|
type: "peer-joined"
|
|
51
|
-
}),
|
|
54
|
+
}), y.setStatus("connected"));
|
|
52
55
|
}), n.addEventListener("message", (t) => {
|
|
53
|
-
|
|
56
|
+
y.disposed || b.handleInbound(e, t.data);
|
|
54
57
|
}), n.addEventListener("close", () => {
|
|
55
|
-
|
|
58
|
+
y.disposed || (e.status === "connecting" ? failPeer(e, S.pending ? openTimeoutError() : new c("channel closed before opening", e.id)) : disconnectPeer(e, "channel closed"));
|
|
56
59
|
}), n.addEventListener("error", () => {
|
|
57
|
-
|
|
60
|
+
y.disposed || failPeer(e, new c("channel error", e.id));
|
|
58
61
|
}), t.addEventListener("iceconnectionstatechange", () => {
|
|
59
|
-
if (
|
|
62
|
+
if (y.disposed) return;
|
|
60
63
|
let n = t.iceConnectionState;
|
|
61
64
|
n === "failed" || n === "closed" ? failPeer(e, new c(`ice ${n}`, e.id)) : n === "disconnected" && e.status === "connected" && disconnectPeer(e, "ice disconnected");
|
|
62
65
|
});
|
|
63
66
|
}
|
|
64
67
|
return {
|
|
65
68
|
async acceptInvitation(e, t) {
|
|
66
|
-
if (
|
|
69
|
+
if (y.ensureLive(), x && x.status !== "failed" && x.status !== "disconnected") throw new u("Guest is already paired");
|
|
67
70
|
if (e?.v !== 1) throw new u("Unsupported invitation version");
|
|
68
|
-
if (
|
|
69
|
-
|
|
71
|
+
if (h() >= e.expiresAt) throw new u("Invitation expired");
|
|
72
|
+
x &&= (S.cancel(), x.pc?.close(), null), y.setStatus("pairing");
|
|
70
73
|
let a;
|
|
71
74
|
try {
|
|
72
|
-
a =
|
|
75
|
+
a = m.createPeerConnection({ iceServers: [...p.iceServers ?? []] });
|
|
73
76
|
} catch (e) {
|
|
74
|
-
throw
|
|
77
|
+
throw y.setStatus("idle"), e;
|
|
75
78
|
}
|
|
76
79
|
let d = n(e.sessionId, e.hostName, "host");
|
|
77
|
-
d.pc = a,
|
|
80
|
+
d.pc = a, x = d, a.addEventListener("datachannel", (e) => {
|
|
78
81
|
wireChannel(d, a, e.channel);
|
|
79
82
|
}), a.addEventListener("iceconnectionstatechange", () => {
|
|
80
|
-
|
|
83
|
+
y.disposed || y.emitTap({
|
|
81
84
|
peerId: d.id,
|
|
82
85
|
state: a.iceConnectionState,
|
|
83
86
|
type: "ice-state"
|
|
@@ -89,59 +92,57 @@ function createMeshGuest(f = {}) {
|
|
|
89
92
|
type: "offer"
|
|
90
93
|
});
|
|
91
94
|
} catch (e) {
|
|
92
|
-
throw
|
|
95
|
+
throw x = null, y.setStatus("idle"), new u("Invalid invitation SDP", { cause: e });
|
|
93
96
|
}
|
|
94
|
-
let
|
|
97
|
+
let f;
|
|
95
98
|
try {
|
|
96
|
-
await a.setLocalDescription(await a.createAnswer()), await s(a,
|
|
99
|
+
await a.setLocalDescription(await a.createAnswer()), await s(a, v), f = a.localDescription?.sdp ?? "";
|
|
97
100
|
} catch (e) {
|
|
98
|
-
throw
|
|
101
|
+
throw x = null, a.close(), y.setStatus("idle"), new c("Failed to create answer", null, { cause: e });
|
|
99
102
|
}
|
|
100
|
-
if (
|
|
101
|
-
if (!
|
|
102
|
-
let
|
|
103
|
+
if (y.disposed) throw a.close(), new l();
|
|
104
|
+
if (!f) throw x = null, a.close(), y.setStatus("idle"), new c("Local description has no SDP");
|
|
105
|
+
let g = i(p.random), b;
|
|
103
106
|
try {
|
|
104
|
-
|
|
107
|
+
b = await r(e.secret, f);
|
|
105
108
|
} catch (e) {
|
|
106
|
-
throw
|
|
109
|
+
throw x = null, a.close(), y.setStatus("idle"), e;
|
|
107
110
|
}
|
|
108
|
-
return
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
peer: t?.name === void 0 ? { id: y } : {
|
|
112
|
-
id: y,
|
|
111
|
+
return y.setStatus("connecting"), S.arm(_), {
|
|
112
|
+
peer: t?.name === void 0 ? { id: g } : {
|
|
113
|
+
id: g,
|
|
113
114
|
name: t.name
|
|
114
115
|
},
|
|
115
|
-
proof:
|
|
116
|
-
sdp:
|
|
116
|
+
proof: b,
|
|
117
|
+
sdp: f,
|
|
117
118
|
sessionId: e.sessionId,
|
|
118
119
|
v: 1
|
|
119
120
|
};
|
|
120
121
|
},
|
|
121
122
|
get disposalSignal() {
|
|
122
|
-
return
|
|
123
|
+
return y.disposalCtrl.signal;
|
|
123
124
|
},
|
|
124
125
|
dispose() {
|
|
125
|
-
|
|
126
|
+
y.disposed || (y.markDisposed(), S.cancel(), x && (x.dc?.close(), x.pc?.close()), b.clear());
|
|
126
127
|
},
|
|
127
128
|
get disposed() {
|
|
128
|
-
return
|
|
129
|
+
return y.disposed;
|
|
129
130
|
},
|
|
130
131
|
get host() {
|
|
131
|
-
return
|
|
132
|
+
return x?.publicPeer ?? null;
|
|
132
133
|
},
|
|
133
134
|
on(e, t) {
|
|
134
|
-
return
|
|
135
|
+
return y.ensureLive(), b.on(e, t);
|
|
135
136
|
},
|
|
136
137
|
send(e, t) {
|
|
137
|
-
if (
|
|
138
|
-
|
|
138
|
+
if (y.ensureLive(), !x) throw new c("Guest is not paired");
|
|
139
|
+
b.sendTo(x, e, t);
|
|
139
140
|
},
|
|
140
141
|
get status() {
|
|
141
|
-
return
|
|
142
|
+
return y.status;
|
|
142
143
|
},
|
|
143
144
|
tap(e, t) {
|
|
144
|
-
return
|
|
145
|
+
return y.tap(e, t);
|
|
145
146
|
},
|
|
146
147
|
[Symbol.dispose]() {
|
|
147
148
|
this.dispose();
|
package/dist/guest.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guest.js","names":["rtc","options","nativeRtcFactory","clock","maxMessageBytes","channelOpenTimeoutMs","iceGatheringTimeoutMs","core","createNodeCore","messenger","createMessenger","hostPeer","openTimer","MeshTimeoutError","peer","error","dc","event","MeshConnectionError","pc","state","MeshPairingError","invitation","createPeerRecord","normalizeSdp","cause","answerSdp","waitIceGathering","MeshDisposedError","peerId","randomId","proof","createProof","meta","type","handler","payload","tapOptions"],"sources":["../src/guest.ts"],"sourcesContent":["import {\n DEFAULT_CHANNEL_OPEN_TIMEOUT_MS,\n DEFAULT_ICE_GATHERING_TIMEOUT_MS,\n DEFAULT_MAX_MESSAGE_BYTES,\n} from './_defaults';\nimport { createMessenger, createNodeCore, createPeerRecord, type PeerRecord } from './_node';\nimport { createProof } from './_proof';\nimport { randomId } from './_random';\nimport { nativeRtcFactory, normalizeSdp, waitIceGathering } from './_rtc';\nimport { MeshConnectionError, MeshDisposedError, type MeshError, MeshPairingError, MeshTimeoutError } from './errors';\nimport type {\n MeshGuest,\n MeshGuestOptions,\n MeshInbound,\n MeshPeer,\n MeshProtocol,\n RTCDataChannelLike,\n RTCPeerConnectionLike,\n} from './types';\n\n/**\n * Create a guest mesh node. The guest pairs with one host by consuming an\n * out-of-band invitation and returning an answer.\n */\nexport function createMeshGuest<P extends MeshProtocol>(options: MeshGuestOptions = {}): MeshGuest<P> {\n const rtc = options.rtc ?? nativeRtcFactory;\n const clock = options.clock ?? (() => Date.now());\n const maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n const channelOpenTimeoutMs = options.channelOpenTimeoutMs ?? DEFAULT_CHANNEL_OPEN_TIMEOUT_MS;\n const iceGatheringTimeoutMs = options.iceGatheringTimeoutMs ?? DEFAULT_ICE_GATHERING_TIMEOUT_MS;\n\n const core = createNodeCore(options.signal);\n const messenger = createMessenger({\n clock,\n emitTap: core.emitTap,\n maxMessageBytes,\n random: options.random,\n });\n\n let hostPeer: PeerRecord | null = null;\n let openTimer: ReturnType<typeof setTimeout> | null = null;\n\n const openTimeoutError = (): MeshTimeoutError =>\n new MeshTimeoutError(`Timed out waiting ${channelOpenTimeoutMs}ms for the data channel to open`);\n\n function failPeer(peer: PeerRecord, error: MeshError): void {\n // Ignore events from a superseded peer after re-pairing replaced hostPeer.\n if (core.disposed || peer !== hostPeer || peer.status === 'failed') return;\n peer.status = 'failed';\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n // Teardown is deferred a macrotask so a peer racing its own open\n // deadline reports its timeout rather than this hangup.\n setTimeout(() => {\n peer.dc?.close();\n peer.pc?.close();\n }, 0);\n core.emitTap({ peerId: peer.id, status: 'failed', type: 'peer-status-change' });\n core.emitTap({ error, type: 'error' });\n core.emitTap({ peer: peer.publicPeer, reason: error.message, type: 'peer-left' });\n core.setStatus('failed');\n }\n\n function disconnectPeer(peer: PeerRecord, reason: string): void {\n if (core.disposed || peer !== hostPeer) return;\n if (peer.status === 'disconnected' || peer.status === 'failed') return;\n peer.status = 'disconnected';\n peer.pc?.close();\n core.emitTap({ peerId: peer.id, status: 'disconnected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, reason, type: 'peer-left' });\n core.setStatus('disconnected');\n }\n\n function wireChannel(peer: PeerRecord, pc: RTCPeerConnectionLike, dc: RTCDataChannelLike): void {\n peer.dc = dc;\n\n dc.addEventListener('open', () => {\n if (core.disposed) return;\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n peer.status = 'connected';\n core.emitTap({ peerId: peer.id, status: 'connected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, type: 'peer-joined' });\n core.setStatus('connected');\n });\n dc.addEventListener('message', (event) => {\n if (core.disposed) return;\n messenger.handleInbound(peer, event.data);\n });\n dc.addEventListener('close', () => {\n if (core.disposed) return;\n if (peer.status === 'connecting')\n failPeer(\n peer,\n openTimer ? openTimeoutError() : new MeshConnectionError('channel closed before opening', peer.id),\n );\n else disconnectPeer(peer, 'channel closed');\n });\n dc.addEventListener('error', () => {\n if (core.disposed) return;\n failPeer(peer, new MeshConnectionError('channel error', peer.id));\n });\n\n // The ice-state emission lives on the pairing-scoped listener above; this\n // one owns channel-lifecycle transitions only, so each ICE change emits\n // exactly one ice-state event.\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n const state = pc.iceConnectionState;\n if (state === 'failed' || state === 'closed') {\n failPeer(peer, new MeshConnectionError(`ice ${state}`, peer.id));\n } else if (state === 'disconnected' && peer.status === 'connected') {\n disconnectPeer(peer, 'ice disconnected');\n }\n });\n }\n\n const guest: MeshGuest<P> = {\n async acceptInvitation(invitation, meta) {\n core.ensureLive();\n // A terminal host peer (failed/disconnected) may be replaced by a fresh\n // pairing on the same node: listeners stay attached and keep working.\n if (hostPeer && hostPeer.status !== 'failed' && hostPeer.status !== 'disconnected') {\n throw new MeshPairingError('Guest is already paired');\n }\n if (invitation?.v !== 1) throw new MeshPairingError('Unsupported invitation version');\n if (clock() >= invitation.expiresAt) throw new MeshPairingError('Invitation expired');\n\n if (hostPeer) {\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n hostPeer.pc?.close();\n hostPeer = null;\n }\n\n core.setStatus('pairing');\n let pc: RTCPeerConnectionLike;\n try {\n pc = rtc.createPeerConnection({ iceServers: [...(options.iceServers ?? [])] });\n } catch (error) {\n core.setStatus('idle');\n throw error;\n }\n\n // The invitation carries no host identity beyond an optional display\n // name: the session id doubles as the host-side peer id for inbound\n // metadata and tap events.\n const peer = createPeerRecord(invitation.sessionId, invitation.hostName, 'host');\n peer.pc = pc;\n hostPeer = peer;\n\n pc.addEventListener('datachannel', (event) => {\n wireChannel(peer, pc, event.channel);\n });\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n core.emitTap({ peerId: peer.id, state: pc.iceConnectionState, type: 'ice-state' });\n });\n\n try {\n await pc.setRemoteDescription({ sdp: normalizeSdp(invitation.sdp), type: 'offer' });\n } catch (cause) {\n hostPeer = null;\n core.setStatus('idle');\n throw new MeshPairingError('Invalid invitation SDP', { cause });\n }\n\n let answerSdp: string;\n try {\n await pc.setLocalDescription(await pc.createAnswer());\n await waitIceGathering(pc, iceGatheringTimeoutMs);\n answerSdp = pc.localDescription?.sdp ?? '';\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Failed to create answer', null, { cause });\n }\n if (core.disposed) {\n pc.close();\n throw new MeshDisposedError();\n }\n if (!answerSdp) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Local description has no SDP');\n }\n\n const peerId = randomId(options.random);\n let proof: string;\n try {\n proof = await createProof(invitation.secret, answerSdp);\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw cause;\n }\n core.setStatus('connecting');\n\n // If the channel never opens (host never accepts the answer), fail loudly\n // instead of hanging in 'connecting' forever. The deadline must cover\n // the human carry-back of the answer, not just machine negotiation.\n openTimer = setTimeout(() => {\n if (hostPeer?.status === 'connecting') {\n failPeer(hostPeer, openTimeoutError());\n }\n }, channelOpenTimeoutMs);\n\n return {\n peer: meta?.name === undefined ? { id: peerId } : { id: peerId, name: meta.name },\n proof,\n sdp: answerSdp,\n sessionId: invitation.sessionId,\n v: 1,\n };\n },\n get disposalSignal() {\n return core.disposalCtrl.signal;\n },\n\n dispose() {\n if (core.disposed) return;\n core.markDisposed();\n if (openTimer) {\n clearTimeout(openTimer);\n openTimer = null;\n }\n if (hostPeer) {\n hostPeer.dc?.close();\n hostPeer.pc?.close();\n }\n messenger.clear();\n },\n get disposed() {\n return core.disposed;\n },\n get host(): MeshPeer | null {\n return hostPeer?.publicPeer ?? null;\n },\n\n on(type, handler) {\n core.ensureLive();\n return messenger.on(type, handler as (message: MeshInbound<unknown>) => void);\n },\n\n send(type, payload) {\n core.ensureLive();\n if (!hostPeer) throw new MeshConnectionError('Guest is not paired');\n messenger.sendTo(hostPeer, type, payload);\n },\n get status() {\n return core.status;\n },\n\n tap(handler, tapOptions) {\n return core.tap(handler, tapOptions);\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n };\n\n return guest;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"guest.js","names":["rtc","options","nativeRtcFactory","clock","maxMessageBytes","channelOpenTimeoutMs","iceGatheringTimeoutMs","core","createNodeCore","messenger","createMessenger","hostPeer","openTimer","timer","MeshTimeoutError","peer","error","dc","event","MeshConnectionError","pc","state","MeshPairingError","invitation","createPeerRecord","normalizeSdp","cause","answerSdp","waitIceGathering","MeshDisposedError","peerId","randomId","proof","createProof","meta","type","handler","payload","tapOptions"],"sources":["../src/guest.ts"],"sourcesContent":["import { timer } from '@vielzeug/arsenal';\nimport {\n DEFAULT_CHANNEL_OPEN_TIMEOUT_MS,\n DEFAULT_ICE_GATHERING_TIMEOUT_MS,\n DEFAULT_MAX_MESSAGE_BYTES,\n} from './_defaults';\nimport { createMessenger, createNodeCore, createPeerRecord, type PeerRecord } from './_node';\nimport { createProof } from './_proof';\nimport { randomId } from './_random';\nimport { nativeRtcFactory, normalizeSdp, waitIceGathering } from './_rtc';\nimport { MeshConnectionError, MeshDisposedError, type MeshError, MeshPairingError, MeshTimeoutError } from './errors';\nimport type {\n MeshGuest,\n MeshGuestOptions,\n MeshInbound,\n MeshPeer,\n MeshProtocol,\n RTCDataChannelLike,\n RTCPeerConnectionLike,\n} from './types';\n\n/**\n * Create a guest mesh node. The guest pairs with one host by consuming an\n * out-of-band invitation and returning an answer.\n */\nexport function createMeshGuest<P extends MeshProtocol>(options: MeshGuestOptions = {}): MeshGuest<P> {\n const rtc = options.rtc ?? nativeRtcFactory;\n const clock = options.clock ?? (() => Date.now());\n const maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;\n const channelOpenTimeoutMs = options.channelOpenTimeoutMs ?? DEFAULT_CHANNEL_OPEN_TIMEOUT_MS;\n const iceGatheringTimeoutMs = options.iceGatheringTimeoutMs ?? DEFAULT_ICE_GATHERING_TIMEOUT_MS;\n\n const core = createNodeCore(options.signal);\n const messenger = createMessenger({\n clock,\n emitTap: core.emitTap,\n maxMessageBytes,\n random: options.random,\n });\n\n let hostPeer: PeerRecord | null = null;\n const openTimer = timer(() => {\n if (hostPeer?.status === 'connecting') {\n failPeer(hostPeer, openTimeoutError());\n }\n });\n\n const openTimeoutError = (): MeshTimeoutError =>\n new MeshTimeoutError(`Timed out waiting ${channelOpenTimeoutMs}ms for the data channel to open`);\n\n function failPeer(peer: PeerRecord, error: MeshError): void {\n // Ignore events from a superseded peer after re-pairing replaced hostPeer.\n if (core.disposed || peer !== hostPeer || peer.status === 'failed') return;\n peer.status = 'failed';\n openTimer.cancel();\n // Teardown is deferred a macrotask so a peer racing its own open\n // deadline reports its timeout rather than this hangup.\n setTimeout(() => {\n peer.dc?.close();\n peer.pc?.close();\n }, 0);\n core.emitTap({ peerId: peer.id, status: 'failed', type: 'peer-status-change' });\n core.emitTap({ error, type: 'error' });\n core.emitTap({ peer: peer.publicPeer, reason: error.message, type: 'peer-left' });\n core.setStatus('failed');\n }\n\n function disconnectPeer(peer: PeerRecord, reason: string): void {\n if (core.disposed || peer !== hostPeer) return;\n if (peer.status === 'disconnected' || peer.status === 'failed') return;\n peer.status = 'disconnected';\n peer.pc?.close();\n core.emitTap({ peerId: peer.id, status: 'disconnected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, reason, type: 'peer-left' });\n core.setStatus('disconnected');\n }\n\n function wireChannel(peer: PeerRecord, pc: RTCPeerConnectionLike, dc: RTCDataChannelLike): void {\n peer.dc = dc;\n\n dc.addEventListener('open', () => {\n if (core.disposed) return;\n openTimer.cancel();\n peer.status = 'connected';\n core.emitTap({ peerId: peer.id, status: 'connected', type: 'peer-status-change' });\n core.emitTap({ peer: peer.publicPeer, type: 'peer-joined' });\n core.setStatus('connected');\n });\n dc.addEventListener('message', (event) => {\n if (core.disposed) return;\n messenger.handleInbound(peer, event.data);\n });\n dc.addEventListener('close', () => {\n if (core.disposed) return;\n if (peer.status === 'connecting')\n failPeer(\n peer,\n openTimer.pending ? openTimeoutError() : new MeshConnectionError('channel closed before opening', peer.id),\n );\n else disconnectPeer(peer, 'channel closed');\n });\n dc.addEventListener('error', () => {\n if (core.disposed) return;\n failPeer(peer, new MeshConnectionError('channel error', peer.id));\n });\n\n // The ice-state emission lives on the pairing-scoped listener above; this\n // one owns channel-lifecycle transitions only, so each ICE change emits\n // exactly one ice-state event.\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n const state = pc.iceConnectionState;\n if (state === 'failed' || state === 'closed') {\n failPeer(peer, new MeshConnectionError(`ice ${state}`, peer.id));\n } else if (state === 'disconnected' && peer.status === 'connected') {\n disconnectPeer(peer, 'ice disconnected');\n }\n });\n }\n\n const guest: MeshGuest<P> = {\n async acceptInvitation(invitation, meta) {\n core.ensureLive();\n // A terminal host peer (failed/disconnected) may be replaced by a fresh\n // pairing on the same node: listeners stay attached and keep working.\n if (hostPeer && hostPeer.status !== 'failed' && hostPeer.status !== 'disconnected') {\n throw new MeshPairingError('Guest is already paired');\n }\n if (invitation?.v !== 1) throw new MeshPairingError('Unsupported invitation version');\n if (clock() >= invitation.expiresAt) throw new MeshPairingError('Invitation expired');\n\n if (hostPeer) {\n openTimer.cancel();\n hostPeer.pc?.close();\n hostPeer = null;\n }\n\n core.setStatus('pairing');\n let pc: RTCPeerConnectionLike;\n try {\n pc = rtc.createPeerConnection({ iceServers: [...(options.iceServers ?? [])] });\n } catch (error) {\n core.setStatus('idle');\n throw error;\n }\n\n // The invitation carries no host identity beyond an optional display\n // name: the session id doubles as the host-side peer id for inbound\n // metadata and tap events.\n const peer = createPeerRecord(invitation.sessionId, invitation.hostName, 'host');\n peer.pc = pc;\n hostPeer = peer;\n\n pc.addEventListener('datachannel', (event) => {\n wireChannel(peer, pc, event.channel);\n });\n pc.addEventListener('iceconnectionstatechange', () => {\n if (core.disposed) return;\n core.emitTap({ peerId: peer.id, state: pc.iceConnectionState, type: 'ice-state' });\n });\n\n try {\n await pc.setRemoteDescription({ sdp: normalizeSdp(invitation.sdp), type: 'offer' });\n } catch (cause) {\n hostPeer = null;\n core.setStatus('idle');\n throw new MeshPairingError('Invalid invitation SDP', { cause });\n }\n\n let answerSdp: string;\n try {\n await pc.setLocalDescription(await pc.createAnswer());\n await waitIceGathering(pc, iceGatheringTimeoutMs);\n answerSdp = pc.localDescription?.sdp ?? '';\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Failed to create answer', null, { cause });\n }\n if (core.disposed) {\n pc.close();\n throw new MeshDisposedError();\n }\n if (!answerSdp) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw new MeshConnectionError('Local description has no SDP');\n }\n\n const peerId = randomId(options.random);\n let proof: string;\n try {\n proof = await createProof(invitation.secret, answerSdp);\n } catch (cause) {\n hostPeer = null;\n pc.close();\n core.setStatus('idle');\n throw cause;\n }\n core.setStatus('connecting');\n\n // If the channel never opens (host never accepts the answer), fail loudly\n // instead of hanging in 'connecting' forever. The deadline must cover\n // the human carry-back of the answer, not just machine negotiation.\n openTimer.arm(channelOpenTimeoutMs);\n\n return {\n peer: meta?.name === undefined ? { id: peerId } : { id: peerId, name: meta.name },\n proof,\n sdp: answerSdp,\n sessionId: invitation.sessionId,\n v: 1,\n };\n },\n get disposalSignal() {\n return core.disposalCtrl.signal;\n },\n\n dispose() {\n if (core.disposed) return;\n core.markDisposed();\n openTimer.cancel();\n if (hostPeer) {\n hostPeer.dc?.close();\n hostPeer.pc?.close();\n }\n messenger.clear();\n },\n get disposed() {\n return core.disposed;\n },\n get host(): MeshPeer | null {\n return hostPeer?.publicPeer ?? null;\n },\n\n on(type, handler) {\n core.ensureLive();\n return messenger.on(type, handler as (message: MeshInbound<unknown>) => void);\n },\n\n send(type, payload) {\n core.ensureLive();\n if (!hostPeer) throw new MeshConnectionError('Guest is not paired');\n messenger.sendTo(hostPeer, type, payload);\n },\n get status() {\n return core.status;\n },\n\n tap(handler, tapOptions) {\n return core.tap(handler, tapOptions);\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n };\n\n return guest;\n}\n"],"mappings":"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"}
|
package/dist/mesh.cjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@vielzeug/arsenal");var MeshError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},MeshPairingError=class extends MeshError{},MeshConnectionError=class extends MeshError{peerId;constructor(e,t=null,n){super(e,n),this.peerId=t}},MeshPayloadError=class extends MeshError{},MeshTimeoutError=class extends MeshError{},MeshDisposedError=class extends MeshError{constructor(e=`Mesh node`,t){super(`${e} is disposed`,t)}},MeshUnsupportedError=class extends MeshError{};function isRecord(e){return typeof e==`object`&&!!e}function isInvitation(e){return e.v===1&&typeof e.sessionId==`string`&&typeof e.secret==`string`&&typeof e.expiresAt==`number`&&typeof e.sdp==`string`}function isAnswer(e){return e.v===1&&typeof e.sessionId==`string`&&typeof e.proof==`string`&&isRecord(e.peer)&&typeof e.peer.id==`string`&&e.peer.id!==``&&(e.peer.name===void 0||typeof e.peer.name==`string`)&&typeof e.sdp==`string`}function parsePairingPayload(e){if(!isRecord(e)||e.v!==1)throw new MeshPairingError(`Unsupported pairing payload version`);if(isInvitation(e)||isAnswer(e))return e;throw new MeshPairingError(`Unrecognized pairing payload shape`)}var t={decode(t){let n;try{n=JSON.parse((0,e.base64UrlToText)(t.trim()))}catch(e){throw new MeshPairingError(`Malformed pairing payload`,{cause:e})}return parsePairingPayload(n)},encode(t){return(0,e.textToBase64Url)(JSON.stringify(t))}};function randomBytes(t,n){let r=new Uint8Array(t);if(n)for(let i=0;i<t;i++)r[i]=Math.floor((0,e.randomFloat)(n)*256);else crypto.getRandomValues(r);return r}function randomId(t){return(0,e.bytesToBase64Url)(randomBytes(16,t))}function toEnvelope(e){if(typeof e!=`object`||!e)return null;let t=e;return t.v!==1||typeof t.id!=`string`||typeof t.t!=`string`||typeof t.ts!=`number`?null:e}var MessageDedupe=class{seen=new Set;order=[];capacity;constructor(e=256){this.capacity=e}check(e){return!this.seen.has(e)&&(this.seen.add(e),this.order.push(e),this.order.length>this.capacity&&this.seen.delete(this.order.shift()),!0)}};function createNodeCore(t){let n=(0,e.tapper)(),r=new AbortController,i={disposalCtrl:r,disposed:!1,emitTap(e){n.emit(e)},ensureLive(){if(i.disposed)throw new MeshDisposedError},markDisposed(){i.disposed||(i.disposed=!0,i.status=`disposed`,i.emitTap({status:`disposed`,type:`status-change`}),i.emitTap({type:`dispose`}),n.clear(),r.abort())},setStatus(e){i.disposed||i.status===e||(i.status=e,i.emitTap({status:e,type:`status-change`}))},status:`idle`,tap(e,t){return i.disposed?()=>{}:n.tap(e,t)}};return t&&(t.aborted?i.markDisposed():t.addEventListener(`abort`,()=>i.markDisposed(),{once:!0})),i}function createPeerRecord(e,t,n){let r={dc:null,dedupe:new MessageDedupe,id:e,name:t,pc:null,publicPeer:{get id(){return r.id},get name(){return r.name},get role(){return r.role},get status(){return r.status}},role:n,status:`connecting`};return r}function createMessenger(t){let n=new Map;function reject(e,n){t.emitTap({peerId:e,reason:n,type:`message-rejected`})}return{clear(){n.clear()},handleInbound(r,i){let a=r.id;if(typeof i!=`string`){reject(a,`malformed`);return}let o=(0,e.utf8Bytes)(i);if(o>t.maxMessageBytes){reject(a,`too-large`);return}let s;try{s=JSON.parse(i)}catch{reject(a,`malformed`);return}let c=toEnvelope(s);if(!c){reject(a,`malformed`);return}if(!r.dedupe.check(c.id)){reject(a,`duplicate`);return}let l=n.get(c.t);if(!l||l.size===0){reject(a,`unknown-type`);return}t.emitTap({bytes:o,messageType:c.t,peerId:a,type:`message-received`});let u={messageId:c.id,payload:c.p,peerId:a,sentAt:c.ts};for(let e of l)try{e(u)}catch(e){t.emitTap({error:new MeshError(`Message handler threw`,{cause:e}),type:`error`})}},on(e,t){let r=n.get(e);return r||(r=new Set,n.set(e,r)),r.add(t),()=>{r.delete(t),r.size===0&&n.delete(e)}},sendTo(n,r,i){let a=n.dc;if(!a||a.readyState!==`open`||n.status!==`connected`)throw new MeshConnectionError(`Peer "${n.id}" is not connected`,n.id);let o={id:randomId(t.random),p:i,t:r,ts:t.clock(),v:1},s;try{s=JSON.stringify(o)}catch(e){throw new MeshPayloadError(`Failed to serialize message "${r}"`,{cause:e})}let c=(0,e.utf8Bytes)(s);if(c>t.maxMessageBytes)throw new MeshPayloadError(`Message "${r}" is ${c} bytes (max ${t.maxMessageBytes})`);try{a.send(s)}catch(e){throw new MeshConnectionError(`Failed to send message "${r}"`,n.id,{cause:e})}t.emitTap({bytes:c,messageType:r,peerId:n.id,type:`message-sent`})}}}function isCompactSdp(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.u==`string`&&typeof t.p==`string`&&typeof t.f==`string`&&typeof t.s==`string`&&typeof t.m==`string`&&Array.isArray(t.c)&&t.c.every(e=>typeof e==`string`)}function restoreSdp(e){if(typeof e==`string`)return e;if(isCompactSdp(e))return expandSdp(e);throw new MeshPairingError(`Malformed pairing payload`)}function compactSdp(e){let t=``,n=``,r=``,i=``,a=`0`,o,s,c=[],l=0;for(let u of e.split(/\r?\n/))u.startsWith(`m=`)?l+=1:u.startsWith(`a=ice-ufrag:`)?t=u.slice(12):u.startsWith(`a=ice-pwd:`)?n=u.slice(10):u.startsWith(`a=fingerprint:sha-256 `)?r=u.slice(22).replaceAll(`:`,``).toUpperCase():u.startsWith(`a=setup:`)?i=u.slice(8):u.startsWith(`a=mid:`)?a=u.slice(6):u.startsWith(`a=sctp-port:`)?o=Number(u.slice(12)):u.startsWith(`a=max-message-size:`)?s=Number(u.slice(19)):u.startsWith(`a=candidate:`)&&c.push(u.slice(12));return l!==1||!t||!n||!r?null:{c,f:r,m:a,p:n,s:i||`actpass`,...s?{mm:s}:{},...o?{sp:o}:{},u:t}}function canonicalSdp(e){let t=compactSdp(e);return t?JSON.stringify(t):e}function expandSdp(e){let t=e.f.replace(/(..)/g,`$1:`).slice(0,-1);return`${[`v=0`,`o=- 0 2 IN IP4 0.0.0.0`,`s=-`,`t=0 0`,`a=group:BUNDLE ${e.m}`,`m=application 9 UDP/DTLS/SCTP webrtc-datachannel`,`c=IN IP4 0.0.0.0`,`a=ice-ufrag:${e.u}`,`a=ice-pwd:${e.p}`,`a=fingerprint:sha-256 ${t}`,`a=setup:${e.s}`,`a=mid:${e.m}`,`a=sctp-port:${e.sp??5e3}`,...e.mm?[`a=max-message-size:${e.mm}`]:[],...e.c.map(e=>`a=candidate:${e}`),``].join(`\r
|
|
2
2
|
`)}`}async function createProof(t,n){let r=globalThis.crypto?.subtle;if(!r)throw new MeshUnsupportedError(`WebCrypto is unavailable: pairing requires a secure context`);let i=new TextEncoder,a=await r.importKey(`raw`,i.encode(t),{hash:`SHA-256`,name:`HMAC`},!1,[`sign`]),o=await r.sign(`HMAC`,a,i.encode(canonicalSdp(n)));return(0,e.bytesToBase64Url)(new Uint8Array(o))}var n={createPeerConnection(e){let t=globalThis.RTCPeerConnection;if(!t)throw new MeshUnsupportedError("WebRTC is unavailable in this environment: inject an `rtc` factory");return new t(e)}};function normalizeSdp(e){let t=e.replace(/\r?\n/g,`\r
|
|
3
3
|
`);return t.endsWith(`\r
|
|
4
|
-
`)?t:`${t}\r\n`}function waitIceGathering(e,t){return e.iceGatheringState===`complete`?Promise.resolve():new Promise(n=>{let cleanup=()=>{clearTimeout(r),e.removeEventListener(`icegatheringstatechange`,onChange)},onChange=()=>{e.iceGatheringState===`complete`&&(cleanup(),n())},r=setTimeout(()=>{cleanup(),n()},t);e.addEventListener(`icegatheringstatechange`,onChange)})}function waitChannelOpen(e,t,n,r,i){return e.readyState===`open`?Promise.resolve():new Promise((a,o)=>{let s=null,timeout=()=>new MeshTimeoutError(`Timed out waiting ${n}ms for the data channel to open`),fail=e=>{cleanup(),o(e)},cleanup=()=>{s&&clearTimeout(s),s=null,e.removeEventListener(`open`,onOpen),e.removeEventListener(`close`,onClose),t.removeEventListener(`iceconnectionstatechange`,onIce),i.removeEventListener(`abort`,onDispose)},onOpen=()=>{cleanup(),a()},onClose=()=>fail(timeout()),onIce=()=>{let e=t.iceConnectionState;(e===`failed`||e===`closed`||e===`disconnected`)&&fail(new MeshConnectionError(`ICE connection ${e} before channel open`,r))},onDispose=()=>fail(new MeshDisposedError);s=setTimeout(()=>fail(timeout()),n),e.addEventListener(`open`,onOpen),e.addEventListener(`close`,onClose),t.addEventListener(`iceconnectionstatechange`,onIce),i.addEventListener(`abort`,onDispose,{once:!0})})}function createMeshGuest(e={}){let t=e.rtc??n,r=e.clock??(()=>Date.now()),i=e.maxMessageBytes??65536,a=e.channelOpenTimeoutMs??6e4,o=e.iceGatheringTimeoutMs??5e3,s=createNodeCore(e.signal),c=createMessenger({clock:r,emitTap:s.emitTap,maxMessageBytes:i,random:e.random}),l=null,u=null,openTimeoutError=()=>new MeshTimeoutError(`Timed out waiting ${a}ms for the data channel to open`);function failPeer(e,t){s.disposed||e!==l||e.status===`failed`||(e.status=`failed`,u&&=(clearTimeout(u),null),setTimeout(()=>{e.dc?.close(),e.pc?.close()},0),s.emitTap({peerId:e.id,status:`failed`,type:`peer-status-change`}),s.emitTap({error:t,type:`error`}),s.emitTap({peer:e.publicPeer,reason:t.message,type:`peer-left`}),s.setStatus(`failed`))}function disconnectPeer(e,t){s.disposed||e!==l||e.status!==`disconnected`&&e.status!==`failed`&&(e.status=`disconnected`,e.pc?.close(),s.emitTap({peerId:e.id,status:`disconnected`,type:`peer-status-change`}),s.emitTap({peer:e.publicPeer,reason:t,type:`peer-left`}),s.setStatus(`disconnected`))}function wireChannel(e,t,n){e.dc=n,n.addEventListener(`open`,()=>{s.disposed||(u&&=(clearTimeout(u),null),e.status=`connected`,s.emitTap({peerId:e.id,status:`connected`,type:`peer-status-change`}),s.emitTap({peer:e.publicPeer,type:`peer-joined`}),s.setStatus(`connected`))}),n.addEventListener(`message`,t=>{s.disposed||c.handleInbound(e,t.data)}),n.addEventListener(`close`,()=>{s.disposed||(e.status===`connecting`?failPeer(e,u?openTimeoutError():new MeshConnectionError(`channel closed before opening`,e.id)):disconnectPeer(e,`channel closed`))}),n.addEventListener(`error`,()=>{s.disposed||failPeer(e,new MeshConnectionError(`channel error`,e.id))}),t.addEventListener(`iceconnectionstatechange`,()=>{if(s.disposed)return;let n=t.iceConnectionState;n===`failed`||n===`closed`?failPeer(e,new MeshConnectionError(`ice ${n}`,e.id)):n===`disconnected`&&e.status===`connected`&&disconnectPeer(e,`ice disconnected`)})}return{async acceptInvitation(n,i){if(s.ensureLive(),l&&l.status!==`failed`&&l.status!==`disconnected`)throw new MeshPairingError(`Guest is already paired`);if(n?.v!==1)throw new MeshPairingError(`Unsupported invitation version`);if(r()>=n.expiresAt)throw new MeshPairingError(`Invitation expired`);l&&=(u&&=(clearTimeout(u),null),l.pc?.close(),null),s.setStatus(`pairing`);let c;try{c=t.createPeerConnection({iceServers:[...e.iceServers??[]]})}catch(e){throw s.setStatus(`idle`),e}let d=createPeerRecord(n.sessionId,n.hostName,`host`);d.pc=c,l=d,c.addEventListener(`datachannel`,e=>{wireChannel(d,c,e.channel)}),c.addEventListener(`iceconnectionstatechange`,()=>{s.disposed||s.emitTap({peerId:d.id,state:c.iceConnectionState,type:`ice-state`})});try{await c.setRemoteDescription({sdp:normalizeSdp(n.sdp),type:`offer`})}catch(e){throw l=null,s.setStatus(`idle`),new MeshPairingError(`Invalid invitation SDP`,{cause:e})}let f;try{await c.setLocalDescription(await c.createAnswer()),await waitIceGathering(c,o),f=c.localDescription?.sdp??``}catch(e){throw l=null,c.close(),s.setStatus(`idle`),new MeshConnectionError(`Failed to create answer`,null,{cause:e})}if(s.disposed)throw c.close(),new MeshDisposedError;if(!f)throw l=null,c.close(),s.setStatus(`idle`),new MeshConnectionError(`Local description has no SDP`);let p=randomId(e.random),m;try{m=await createProof(n.secret,f)}catch(e){throw l=null,c.close(),s.setStatus(`idle`),e}return s.setStatus(`connecting`),u=setTimeout(()=>{l?.status===`connecting`&&failPeer(l,openTimeoutError())},a),{peer:i?.name===void 0?{id:p}:{id:p,name:i.name},proof:m,sdp:f,sessionId:n.sessionId,v:1}},get disposalSignal(){return s.disposalCtrl.signal},dispose(){s.disposed||(s.markDisposed(),u&&=(clearTimeout(u),null),l&&(l.dc?.close(),l.pc?.close()),c.clear())},get disposed(){return s.disposed},get host(){return l?.publicPeer??null},on(e,t){return s.ensureLive(),c.on(e,t)},send(e,t){if(s.ensureLive(),!l)throw new MeshConnectionError(`Guest is not paired`);c.sendTo(l,e,t)},get status(){return s.status},tap(e,t){return s.tap(e,t)},[Symbol.dispose](){this.dispose()}}}function createMeshHost(t={}){let r=t.rtc??n,i=t.clock??(()=>Date.now()),a=t.maxMessageBytes??65536,o=t.invitationTtlMs??3e5,s=t.channelOpenTimeoutMs??6e4,c=t.iceGatheringTimeoutMs??5e3,l={label:`mesh`,ordered:!0,...t.channel},u=createNodeCore(t.signal),d=createMessenger({clock:i,emitTap:u.emitTap,maxMessageBytes:a,random:t.random}),f=new Map,p=new Map,m=!1,h=!1;function recomputeStatus(){let e=p.size>0?`pairing`:m?`disconnected`:h?`failed`:`idle`;for(let t of f.values()){if(t.status===`connected`){e=`connected`;break}t.status===`connecting`&&(e=`connecting`)}u.setStatus(e)}function expireInvitation(e){let t=p.get(e);t&&(p.delete(e),clearTimeout(t.expiryTimer),t.pc.close(),u.emitTap({sessionId:e,type:`invitation-expired`}),recomputeStatus())}function setPeerStatus(e,t){e.status!==t&&(e.status=t,u.emitTap({peerId:e.id,status:t,type:`peer-status-change`}),recomputeStatus())}function leavePeer(e,t,n=!1){f.has(e.id)&&(f.delete(e.id),e.status=n?`failed`:`disconnected`,e.pc?.close(),e.dc?.close(),u.emitTap({peerId:e.id,status:e.status,type:`peer-status-change`}),u.emitTap({peer:e.publicPeer,reason:t,type:`peer-left`}),n||(m=!0),h||=n,recomputeStatus())}function wirePeerTransport(e,t,n){e.pc=t,e.dc=n,n.addEventListener(`message`,t=>{u.disposed||d.handleInbound(e,t.data)}),n.addEventListener(`close`,()=>{u.disposed||leavePeer(e,`channel closed`)}),n.addEventListener(`error`,()=>{u.disposed||leavePeer(e,`channel error`,!0)}),t.addEventListener(`iceconnectionstatechange`,()=>{if(u.disposed)return;let n=t.iceConnectionState;u.emitTap({peerId:e.id,state:n,type:`ice-state`}),n===`failed`||n===`closed`?leavePeer(e,`ice ${n}`,n===`failed`):n===`disconnected`&&e.status===`connected`&&setPeerStatus(e,`disconnected`)})}function markPeerConnected(e){m=!0,f.set(e.id,e),setPeerStatus(e,`connected`),u.emitTap({peer:e,type:`peer-joined`})}return{async acceptAnswer(e){if(u.ensureLive(),e?.v!==1)throw new MeshPairingError(`Unsupported answer version`);if(!e.peer?.id)throw new MeshPairingError(`Answer is missing a peer id`);let n=p.get(e.sessionId);if(!n)throw new MeshPairingError(`Unknown or expired session`);if(n.answered)throw new MeshPairingError(`Invitation already answered`);if(f.has(e.peer.id))throw new MeshPairingError(`Peer "${e.peer.id}" is already connected`);if(i()>=n.expiresAt)throw expireInvitation(e.sessionId),new MeshPairingError(`Invitation expired`);let r=await createProof(n.secret,e.sdp);if(e.proof!==r)throw new MeshPairingError(`Proof mismatch`);if(!(await t.approvePeer?.(e.peer)??!0))throw u.emitTap({peerId:e.peer.id,type:`peer-rejected`}),new MeshPairingError(`Peer "${e.peer.id}" rejected by host`);if(u.emitTap({peerId:e.peer.id,type:`peer-approved`}),f.has(e.peer.id))throw new MeshPairingError(`Peer "${e.peer.id}" is already connected`);n.answered=!0,p.delete(e.sessionId),clearTimeout(n.expiryTimer);let a=createPeerRecord(e.peer.id,e.peer.name,`guest`),o=waitChannelOpen(n.dc,n.pc,s,a.id,u.disposalCtrl.signal);wirePeerTransport(a,n.pc,n.dc),f.set(a.id,a),recomputeStatus();try{await n.pc.setRemoteDescription({sdp:normalizeSdp(e.sdp),type:`answer`})}catch(e){throw leavePeer(a,`invalid answer sdp`,!0),new MeshPairingError(`Invalid answer SDP`,{cause:e})}try{await o}catch(e){let t=!(e instanceof MeshDisposedError);throw leavePeer(a,e instanceof Error?e.message:`open failed`,t),e}return markPeerConnected(a),a.publicPeer},broadcast(e,t,n){u.ensureLive();for(let r of f.values())r.status!==`connected`||n?.except?.includes(r.id)||d.sendTo(r,e,t)},async createInvitation(n){u.ensureLive();let a=r.createPeerConnection({iceServers:[...t.iceServers??[]]}),s=a.createDataChannel(l.label,{maxRetransmits:l.maxRetransmits,ordered:l.ordered}),d=randomId(t.random),f=(0,e.bytesToBase64Url)(randomBytes(32,t.random)),m=i()+o;try{await a.setLocalDescription(await a.createOffer()),await waitIceGathering(a,c)}catch(e){throw a.close(),new MeshConnectionError(`Failed to create offer`,null,{cause:e})}if(u.disposed)throw a.close(),new MeshDisposedError;let h=a.localDescription?.sdp;if(!h)throw a.close(),new MeshConnectionError(`Local description has no SDP`);let g=setTimeout(()=>expireInvitation(d),o);return p.set(d,{answered:!1,dc:s,expiresAt:m,expiryTimer:g,pc:a,secret:f,sessionId:d}),u.emitTap({sessionId:d,type:`invitation-created`}),recomputeStatus(),{expiresAt:m,sdp:h,secret:f,sessionId:d,v:1,...n?.name===void 0?{}:{hostName:n.name}}},get disposalSignal(){return u.disposalCtrl.signal},dispose(){if(!u.disposed){u.markDisposed();for(let e of p.values())clearTimeout(e.expiryTimer),e.pc.close();p.clear();for(let e of f.values())e.dc?.close(),e.pc?.close();f.clear(),d.clear()}},get disposed(){return u.disposed},kick(e,t){u.ensureLive();let n=f.get(e);if(!n)throw new MeshConnectionError(`Unknown peer "${e}"`,e);leavePeer(n,t??`kicked`)},on(e,t){return u.ensureLive(),d.on(e,t)},get peers(){return f},send(e,t,n){u.ensureLive();let r=f.get(e);if(!r)throw new MeshConnectionError(`Unknown peer "${e}"`,e);d.sendTo(r,t,n)},get status(){return u.status},tap(e,t){return u.tap(e,t)},[Symbol.dispose](){this.dispose()}}}var r=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:`,i=new Map([...r].map((e,t)=>[e,t]));function bytesToBase45(e){let t=``;for(let n=0;n+1<e.length;n+=2){let i=e[n]*256+e[n+1];t+=r[i%45]+r[Math.floor(i/45)%45]+r[Math.floor(i/2025)]}if(e.length%2){let n=e[e.length-1];t+=r[n%45]+r[Math.floor(n/45)]}return t}function base45ToBytes(e){let t=[],n=0;for(;n+2<e.length;){let r=digit(e,n)+45*digit(e,n+1)+2025*digit(e,n+2);if(r>65535)throw new MeshPairingError(`Malformed base45 payload`);t.push(r>>8,r&255),n+=3}if(e.length-n===2){let r=digit(e,n)+45*digit(e,n+1);if(r>255)throw new MeshPairingError(`Malformed base45 payload`);t.push(r)}else if(e.length-n===1)throw new MeshPairingError(`Malformed base45 payload`);return new Uint8Array(t)}function digit(e,t){let n=i.get(e[t]);if(n===void 0)throw new MeshPairingError(`Malformed base45 payload`);return n}var a=`mq2.`,o=1048576,s=new TextEncoder,c=new TextDecoder;function decompressionStream(e){if(typeof globalThis.DecompressionStream!=`function`)throw new MeshUnsupportedError(`DecompressionStream is not available in this environment`);return new globalThis.DecompressionStream(e)}async function pump(e,t,n){let r=t.writable.getWriter(),i=r.write(e).then(()=>r.close()).catch(()=>{}),a=[],o=t.readable.getReader(),s=0;for(;;){let{done:e,value:t}=await o.read();if(e)break;if(s+=t.length,n!==void 0&&s>n)throw await o.cancel().catch(()=>{}),new MeshPairingError(`Pairing payload decompresses beyond the size limit`);a.push(t)}await i;let c=new Uint8Array(a.reduce((e,t)=>e+t.length,0)),l=0;for(let e of a)c.set(e,l),l+=e.length;return c}var l={async decode(e){let n=e.trim();if(n.startsWith(a)){let e;try{let t=base45ToBytes(n.slice(4));e=JSON.parse(c.decode(await pump(t,decompressionStream(`deflate-raw`),o)))}catch(e){throw e instanceof MeshUnsupportedError||e instanceof MeshPairingError?e:new MeshPairingError(`Malformed pairing payload`,{cause:e})}return isRecord(e)&&(e={...e,sdp:restoreSdp(e.sdp)}),parsePairingPayload(e)}return t.decode(n)},async encode(e){if(typeof globalThis.CompressionStream!=`function`)return t.encode(e);let n=compactSdp(e.sdp);return a+bytesToBase45(await pump(s.encode(JSON.stringify(n?{...e,sdp:n}:e)),new globalThis.CompressionStream(`deflate-raw`)))}};exports.MeshConnectionError=MeshConnectionError,exports.MeshDisposedError=MeshDisposedError,exports.MeshError=MeshError,exports.MeshPairingError=MeshPairingError,exports.MeshPayloadError=MeshPayloadError,exports.MeshTimeoutError=MeshTimeoutError,exports.MeshUnsupportedError=MeshUnsupportedError,exports.createMeshGuest=createMeshGuest,exports.createMeshHost=createMeshHost,exports.meshCodec=t,exports.meshQrCodec=l;
|
|
4
|
+
`)?t:`${t}\r\n`}function waitIceGathering(e,t){return e.iceGatheringState===`complete`?Promise.resolve():new Promise(n=>{let cleanup=()=>{clearTimeout(r),e.removeEventListener(`icegatheringstatechange`,onChange)},onChange=()=>{e.iceGatheringState===`complete`&&(cleanup(),n())},r=setTimeout(()=>{cleanup(),n()},t);e.addEventListener(`icegatheringstatechange`,onChange)})}function waitChannelOpen(e,t,n,r,i){return e.readyState===`open`?Promise.resolve():new Promise((a,o)=>{let s=null,timeout=()=>new MeshTimeoutError(`Timed out waiting ${n}ms for the data channel to open`),fail=e=>{cleanup(),o(e)},cleanup=()=>{s&&clearTimeout(s),s=null,e.removeEventListener(`open`,onOpen),e.removeEventListener(`close`,onClose),t.removeEventListener(`iceconnectionstatechange`,onIce),i.removeEventListener(`abort`,onDispose)},onOpen=()=>{cleanup(),a()},onClose=()=>fail(timeout()),onIce=()=>{let e=t.iceConnectionState;(e===`failed`||e===`closed`||e===`disconnected`)&&fail(new MeshConnectionError(`ICE connection ${e} before channel open`,r))},onDispose=()=>fail(new MeshDisposedError);s=setTimeout(()=>fail(timeout()),n),e.addEventListener(`open`,onOpen),e.addEventListener(`close`,onClose),t.addEventListener(`iceconnectionstatechange`,onIce),i.addEventListener(`abort`,onDispose,{once:!0})})}function createMeshGuest(t={}){let r=t.rtc??n,i=t.clock??(()=>Date.now()),a=t.maxMessageBytes??65536,o=t.channelOpenTimeoutMs??6e4,s=t.iceGatheringTimeoutMs??5e3,c=createNodeCore(t.signal),l=createMessenger({clock:i,emitTap:c.emitTap,maxMessageBytes:a,random:t.random}),u=null,d=(0,e.timer)(()=>{u?.status===`connecting`&&failPeer(u,openTimeoutError())}),openTimeoutError=()=>new MeshTimeoutError(`Timed out waiting ${o}ms for the data channel to open`);function failPeer(e,t){c.disposed||e!==u||e.status===`failed`||(e.status=`failed`,d.cancel(),setTimeout(()=>{e.dc?.close(),e.pc?.close()},0),c.emitTap({peerId:e.id,status:`failed`,type:`peer-status-change`}),c.emitTap({error:t,type:`error`}),c.emitTap({peer:e.publicPeer,reason:t.message,type:`peer-left`}),c.setStatus(`failed`))}function disconnectPeer(e,t){c.disposed||e!==u||e.status!==`disconnected`&&e.status!==`failed`&&(e.status=`disconnected`,e.pc?.close(),c.emitTap({peerId:e.id,status:`disconnected`,type:`peer-status-change`}),c.emitTap({peer:e.publicPeer,reason:t,type:`peer-left`}),c.setStatus(`disconnected`))}function wireChannel(e,t,n){e.dc=n,n.addEventListener(`open`,()=>{c.disposed||(d.cancel(),e.status=`connected`,c.emitTap({peerId:e.id,status:`connected`,type:`peer-status-change`}),c.emitTap({peer:e.publicPeer,type:`peer-joined`}),c.setStatus(`connected`))}),n.addEventListener(`message`,t=>{c.disposed||l.handleInbound(e,t.data)}),n.addEventListener(`close`,()=>{c.disposed||(e.status===`connecting`?failPeer(e,d.pending?openTimeoutError():new MeshConnectionError(`channel closed before opening`,e.id)):disconnectPeer(e,`channel closed`))}),n.addEventListener(`error`,()=>{c.disposed||failPeer(e,new MeshConnectionError(`channel error`,e.id))}),t.addEventListener(`iceconnectionstatechange`,()=>{if(c.disposed)return;let n=t.iceConnectionState;n===`failed`||n===`closed`?failPeer(e,new MeshConnectionError(`ice ${n}`,e.id)):n===`disconnected`&&e.status===`connected`&&disconnectPeer(e,`ice disconnected`)})}return{async acceptInvitation(e,n){if(c.ensureLive(),u&&u.status!==`failed`&&u.status!==`disconnected`)throw new MeshPairingError(`Guest is already paired`);if(e?.v!==1)throw new MeshPairingError(`Unsupported invitation version`);if(i()>=e.expiresAt)throw new MeshPairingError(`Invitation expired`);u&&=(d.cancel(),u.pc?.close(),null),c.setStatus(`pairing`);let a;try{a=r.createPeerConnection({iceServers:[...t.iceServers??[]]})}catch(e){throw c.setStatus(`idle`),e}let l=createPeerRecord(e.sessionId,e.hostName,`host`);l.pc=a,u=l,a.addEventListener(`datachannel`,e=>{wireChannel(l,a,e.channel)}),a.addEventListener(`iceconnectionstatechange`,()=>{c.disposed||c.emitTap({peerId:l.id,state:a.iceConnectionState,type:`ice-state`})});try{await a.setRemoteDescription({sdp:normalizeSdp(e.sdp),type:`offer`})}catch(e){throw u=null,c.setStatus(`idle`),new MeshPairingError(`Invalid invitation SDP`,{cause:e})}let f;try{await a.setLocalDescription(await a.createAnswer()),await waitIceGathering(a,s),f=a.localDescription?.sdp??``}catch(e){throw u=null,a.close(),c.setStatus(`idle`),new MeshConnectionError(`Failed to create answer`,null,{cause:e})}if(c.disposed)throw a.close(),new MeshDisposedError;if(!f)throw u=null,a.close(),c.setStatus(`idle`),new MeshConnectionError(`Local description has no SDP`);let p=randomId(t.random),m;try{m=await createProof(e.secret,f)}catch(e){throw u=null,a.close(),c.setStatus(`idle`),e}return c.setStatus(`connecting`),d.arm(o),{peer:n?.name===void 0?{id:p}:{id:p,name:n.name},proof:m,sdp:f,sessionId:e.sessionId,v:1}},get disposalSignal(){return c.disposalCtrl.signal},dispose(){c.disposed||(c.markDisposed(),d.cancel(),u&&(u.dc?.close(),u.pc?.close()),l.clear())},get disposed(){return c.disposed},get host(){return u?.publicPeer??null},on(e,t){return c.ensureLive(),l.on(e,t)},send(e,t){if(c.ensureLive(),!u)throw new MeshConnectionError(`Guest is not paired`);l.sendTo(u,e,t)},get status(){return c.status},tap(e,t){return c.tap(e,t)},[Symbol.dispose](){this.dispose()}}}function createMeshHost(t={}){let r=t.rtc??n,i=t.clock??(()=>Date.now()),a=t.maxMessageBytes??65536,o=t.invitationTtlMs??3e5,s=t.channelOpenTimeoutMs??6e4,c=t.iceGatheringTimeoutMs??5e3,l={label:`mesh`,ordered:!0,...t.channel},u=createNodeCore(t.signal),d=createMessenger({clock:i,emitTap:u.emitTap,maxMessageBytes:a,random:t.random}),f=new Map,p=new Map,m=!1,h=!1;function recomputeStatus(){let e=p.size>0?`pairing`:m?`disconnected`:h?`failed`:`idle`;for(let t of f.values()){if(t.status===`connected`){e=`connected`;break}t.status===`connecting`&&(e=`connecting`)}u.setStatus(e)}function expireInvitation(e){let t=p.get(e);t&&(p.delete(e),clearTimeout(t.expiryTimer),t.pc.close(),u.emitTap({sessionId:e,type:`invitation-expired`}),recomputeStatus())}function setPeerStatus(e,t){e.status!==t&&(e.status=t,u.emitTap({peerId:e.id,status:t,type:`peer-status-change`}),recomputeStatus())}function leavePeer(e,t,n=!1){f.has(e.id)&&(f.delete(e.id),e.status=n?`failed`:`disconnected`,e.pc?.close(),e.dc?.close(),u.emitTap({peerId:e.id,status:e.status,type:`peer-status-change`}),u.emitTap({peer:e.publicPeer,reason:t,type:`peer-left`}),n||(m=!0),h||=n,recomputeStatus())}function wirePeerTransport(e,t,n){e.pc=t,e.dc=n,n.addEventListener(`message`,t=>{u.disposed||d.handleInbound(e,t.data)}),n.addEventListener(`close`,()=>{u.disposed||leavePeer(e,`channel closed`)}),n.addEventListener(`error`,()=>{u.disposed||leavePeer(e,`channel error`,!0)}),t.addEventListener(`iceconnectionstatechange`,()=>{if(u.disposed)return;let n=t.iceConnectionState;u.emitTap({peerId:e.id,state:n,type:`ice-state`}),n===`failed`||n===`closed`?leavePeer(e,`ice ${n}`,n===`failed`):n===`disconnected`&&e.status===`connected`&&setPeerStatus(e,`disconnected`)})}function markPeerConnected(e){m=!0,f.set(e.id,e),setPeerStatus(e,`connected`),u.emitTap({peer:e,type:`peer-joined`})}return{async acceptAnswer(e){if(u.ensureLive(),e?.v!==1)throw new MeshPairingError(`Unsupported answer version`);if(!e.peer?.id)throw new MeshPairingError(`Answer is missing a peer id`);let n=p.get(e.sessionId);if(!n)throw new MeshPairingError(`Unknown or expired session`);if(n.answered)throw new MeshPairingError(`Invitation already answered`);if(f.has(e.peer.id))throw new MeshPairingError(`Peer "${e.peer.id}" is already connected`);if(i()>=n.expiresAt)throw expireInvitation(e.sessionId),new MeshPairingError(`Invitation expired`);let r=await createProof(n.secret,e.sdp);if(e.proof!==r)throw new MeshPairingError(`Proof mismatch`);if(!(await t.approvePeer?.(e.peer)??!0))throw u.emitTap({peerId:e.peer.id,type:`peer-rejected`}),new MeshPairingError(`Peer "${e.peer.id}" rejected by host`);if(u.emitTap({peerId:e.peer.id,type:`peer-approved`}),f.has(e.peer.id))throw new MeshPairingError(`Peer "${e.peer.id}" is already connected`);n.answered=!0,p.delete(e.sessionId),clearTimeout(n.expiryTimer);let a=createPeerRecord(e.peer.id,e.peer.name,`guest`),o=waitChannelOpen(n.dc,n.pc,s,a.id,u.disposalCtrl.signal);wirePeerTransport(a,n.pc,n.dc),f.set(a.id,a),recomputeStatus();try{await n.pc.setRemoteDescription({sdp:normalizeSdp(e.sdp),type:`answer`})}catch(e){throw leavePeer(a,`invalid answer sdp`,!0),new MeshPairingError(`Invalid answer SDP`,{cause:e})}try{await o}catch(e){let t=!(e instanceof MeshDisposedError);throw leavePeer(a,e instanceof Error?e.message:`open failed`,t),e}return markPeerConnected(a),a.publicPeer},broadcast(e,t,n){u.ensureLive();for(let r of f.values())r.status!==`connected`||n?.except?.includes(r.id)||d.sendTo(r,e,t)},async createInvitation(n){u.ensureLive();let a=r.createPeerConnection({iceServers:[...t.iceServers??[]]}),s=a.createDataChannel(l.label,{maxRetransmits:l.maxRetransmits,ordered:l.ordered}),d=randomId(t.random),f=(0,e.bytesToBase64Url)(randomBytes(32,t.random)),m=i()+o;try{await a.setLocalDescription(await a.createOffer()),await waitIceGathering(a,c)}catch(e){throw a.close(),new MeshConnectionError(`Failed to create offer`,null,{cause:e})}if(u.disposed)throw a.close(),new MeshDisposedError;let h=a.localDescription?.sdp;if(!h)throw a.close(),new MeshConnectionError(`Local description has no SDP`);let g=setTimeout(()=>expireInvitation(d),o);return p.set(d,{answered:!1,dc:s,expiresAt:m,expiryTimer:g,pc:a,secret:f,sessionId:d}),u.emitTap({sessionId:d,type:`invitation-created`}),recomputeStatus(),{expiresAt:m,sdp:h,secret:f,sessionId:d,v:1,...n?.name===void 0?{}:{hostName:n.name}}},get disposalSignal(){return u.disposalCtrl.signal},dispose(){if(!u.disposed){u.markDisposed();for(let e of p.values())clearTimeout(e.expiryTimer),e.pc.close();p.clear();for(let e of f.values())e.dc?.close(),e.pc?.close();f.clear(),d.clear()}},get disposed(){return u.disposed},kick(e,t){u.ensureLive();let n=f.get(e);if(!n)throw new MeshConnectionError(`Unknown peer "${e}"`,e);leavePeer(n,t??`kicked`)},on(e,t){return u.ensureLive(),d.on(e,t)},get peers(){return f},send(e,t,n){u.ensureLive();let r=f.get(e);if(!r)throw new MeshConnectionError(`Unknown peer "${e}"`,e);d.sendTo(r,t,n)},get status(){return u.status},tap(e,t){return u.tap(e,t)},[Symbol.dispose](){this.dispose()}}}var r=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:`,i=new Map([...r].map((e,t)=>[e,t]));function bytesToBase45(e){let t=``;for(let n=0;n+1<e.length;n+=2){let i=e[n]*256+e[n+1];t+=r[i%45]+r[Math.floor(i/45)%45]+r[Math.floor(i/2025)]}if(e.length%2){let n=e[e.length-1];t+=r[n%45]+r[Math.floor(n/45)]}return t}function base45ToBytes(e){let t=[],n=0;for(;n+2<e.length;){let r=digit(e,n)+45*digit(e,n+1)+2025*digit(e,n+2);if(r>65535)throw new MeshPairingError(`Malformed base45 payload`);t.push(r>>8,r&255),n+=3}if(e.length-n===2){let r=digit(e,n)+45*digit(e,n+1);if(r>255)throw new MeshPairingError(`Malformed base45 payload`);t.push(r)}else if(e.length-n===1)throw new MeshPairingError(`Malformed base45 payload`);return new Uint8Array(t)}function digit(e,t){let n=i.get(e[t]);if(n===void 0)throw new MeshPairingError(`Malformed base45 payload`);return n}var a=`mq2.`,o=1048576,s=new TextEncoder,c=new TextDecoder;function decompressionStream(e){if(typeof globalThis.DecompressionStream!=`function`)throw new MeshUnsupportedError(`DecompressionStream is not available in this environment`);return new globalThis.DecompressionStream(e)}async function pump(e,t,n){let r=t.writable.getWriter(),i=r.write(e).then(()=>r.close()).catch(()=>{}),a=[],o=t.readable.getReader(),s=0;for(;;){let{done:e,value:t}=await o.read();if(e)break;if(s+=t.length,n!==void 0&&s>n)throw await o.cancel().catch(()=>{}),new MeshPairingError(`Pairing payload decompresses beyond the size limit`);a.push(t)}await i;let c=new Uint8Array(a.reduce((e,t)=>e+t.length,0)),l=0;for(let e of a)c.set(e,l),l+=e.length;return c}var l={async decode(e){let n=e.trim();if(n.startsWith(a)){let e;try{let t=base45ToBytes(n.slice(4));e=JSON.parse(c.decode(await pump(t,decompressionStream(`deflate-raw`),o)))}catch(e){throw e instanceof MeshUnsupportedError||e instanceof MeshPairingError?e:new MeshPairingError(`Malformed pairing payload`,{cause:e})}return isRecord(e)&&(e={...e,sdp:restoreSdp(e.sdp)}),parsePairingPayload(e)}return t.decode(n)},async encode(e){if(typeof globalThis.CompressionStream!=`function`)return t.encode(e);let n=compactSdp(e.sdp);return a+bytesToBase45(await pump(s.encode(JSON.stringify(n?{...e,sdp:n}:e)),new globalThis.CompressionStream(`deflate-raw`)))}};exports.MeshConnectionError=MeshConnectionError,exports.MeshDisposedError=MeshDisposedError,exports.MeshError=MeshError,exports.MeshPairingError=MeshPairingError,exports.MeshPayloadError=MeshPayloadError,exports.MeshTimeoutError=MeshTimeoutError,exports.MeshUnsupportedError=MeshUnsupportedError,exports.createMeshGuest=createMeshGuest,exports.createMeshHost=createMeshHost,exports.meshCodec=t,exports.meshQrCodec=l;
|
|
5
5
|
//# sourceMappingURL=mesh.cjs.map
|