@fairfox/polly 0.54.0 → 0.55.0

package/dist/src/mesh.js

@@ -1933,6 +1933,132 @@ function findSubarray2(haystack, needle) {
 }
 
 // src/shared/lib/mesh-webrtc-adapter.ts
+async function collectTransportSnapshot(connection, lastDataChannelError) {
+  const at = performance.now();
+  let report;
+  try {
+    report = await connection.getStats();
+  } catch {
+    return emptyTransportSnapshot(lastDataChannelError, at);
+  }
+  const parsed = partitionStats(report);
+  const selectedPair = selectActivePair(parsed);
+  const selectedCandidatePair = selectedPair ? buildCandidatePairView(selectedPair, parsed.localCands, parsed.remoteCands) : undefined;
+  return {
+    selectedCandidatePair,
+    retransmittedPacketsSent: parsed.retransmittedPacketsSent,
+    retransmittedBytesSent: parsed.retransmittedBytesSent,
+    lastDataChannelError,
+    at
+  };
+}
+function emptyTransportSnapshot(lastDataChannelError, at) {
+  return {
+    selectedCandidatePair: undefined,
+    retransmittedPacketsSent: undefined,
+    retransmittedBytesSent: undefined,
+    lastDataChannelError,
+    at
+  };
+}
+function partitionStats(report) {
+  const out = {
+    localCands: new Map,
+    remoteCands: new Map,
+    pairs: new Map,
+    selectedPairId: undefined,
+    retransmittedPacketsSent: undefined,
+    retransmittedBytesSent: undefined
+  };
+  const iter = report.values?.() ?? [];
+  for (const raw of iter) {
+    if (!raw || typeof raw !== "object")
+      continue;
+    const stat = raw;
+    ingestStat(stat, out);
+  }
+  return out;
+}
+function ingestStat(stat, out) {
+  const id = String(stat["id"]);
+  switch (stat["type"]) {
+    case "local-candidate":
+      out.localCands.set(id, stat);
+      return;
+    case "remote-candidate":
+      out.remoteCands.set(id, stat);
+      return;
+    case "candidate-pair":
+      out.pairs.set(id, stat);
+      return;
+    case "transport":
+      ingestTransport(stat, out);
+      return;
+    case "data-channel":
+      ingestDataChannel(stat, out);
+      return;
+  }
+}
+function ingestTransport(stat, out) {
+  const selectedId = stat["selectedCandidatePairId"];
+  if (typeof selectedId === "string")
+    out.selectedPairId = selectedId;
+  const rp = stat["retransmittedPacketsSent"];
+  const rb = stat["retransmittedBytesSent"];
+  if (typeof rp === "number")
+    out.retransmittedPacketsSent = rp;
+  if (typeof rb === "number")
+    out.retransmittedBytesSent = rb;
+}
+function ingestDataChannel(stat, out) {
+  const rp = stat["retransmittedPacketsSent"];
+  const rb = stat["retransmittedBytesSent"];
+  if (out.retransmittedPacketsSent === undefined && typeof rp === "number") {
+    out.retransmittedPacketsSent = rp;
+  }
+  if (out.retransmittedBytesSent === undefined && typeof rb === "number") {
+    out.retransmittedBytesSent = rb;
+  }
+}
+function selectActivePair(parsed) {
+  if (parsed.selectedPairId) {
+    const named = parsed.pairs.get(parsed.selectedPairId);
+    if (named)
+      return named;
+  }
+  for (const pair of parsed.pairs.values()) {
+    if (pair["nominated"])
+      return pair;
+  }
+  return;
+}
+function serialiseSlotView(slot) {
+  return {
+    signalingState: slot.connection.signalingState,
+    iceConnectionState: slot.connection.iceConnectionState,
+    connectionState: slot.connection.connectionState,
+    dataChannelState: slot.channel?.readyState ?? "no-channel",
+    pendingSendCount: slot.pendingSends.length,
+    pendingRemoteIceCount: slot.pendingRemoteIce.length,
+    inFlightSync: slot.inFlightSync ? { ...slot.inFlightSync } : undefined,
+    transport: slot.transport ? {
+      ...slot.transport,
+      selectedCandidatePair: slot.transport.selectedCandidatePair ? { ...slot.transport.selectedCandidatePair } : undefined
+    } : undefined
+  };
+}
+function buildCandidatePairView(pair, localCands, remoteCands) {
+  const local = localCands.get(String(pair["localCandidateId"]));
+  const remote = remoteCands.get(String(pair["remoteCandidateId"]));
+  return {
+    localCandidateType: String(local?.["candidateType"] ?? "?"),
+    remoteCandidateType: String(remote?.["candidateType"] ?? "?"),
+    state: String(pair["state"] ?? ""),
+    nominated: Boolean(pair["nominated"]),
+    bytesSent: Number(pair["bytesSent"] ?? 0),
+    bytesReceived: Number(pair["bytesReceived"] ?? 0)
+  };
+}
 var DEFAULT_ICE_SERVERS = [
   { urls: "stun:stun.l.google.com:19302" },
   { urls: "stun:stun1.l.google.com:19302" }
@@ -1941,6 +2067,8 @@ var DEFAULT_ICE_SERVERS = [
 class MeshWebRTCAdapter extends NetworkAdapter2 {
   signaling;
   iceServers;
+  iceTransportPolicy;
+  iceRelayEnforcement;
   dataChannelLabel;
   knownPeers;
   keyringSource;
@@ -1971,6 +2099,8 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     super();
     this.signaling = options.signaling;
     this.iceServers = options.iceServers ?? DEFAULT_ICE_SERVERS;
+    this.iceTransportPolicy = options.iceTransportPolicy;
+    this.iceRelayEnforcement = options.iceRelayEnforcement ?? true;
     this.dataChannelLabel = options.dataChannelLabel ?? "polly-mesh";
     this.knownPeers = new Set(options.knownPeerIds ?? []);
     this.keyringSource = options.keyringSource;
@@ -2008,15 +2138,7 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
         peerId,
         knownInKeyring: knownPeerSet.has(peerId),
         presentInSignalling: this.presentPeers.has(peerId),
-        slot: slot ? {
-          signalingState: slot.connection.signalingState,
-          iceConnectionState: slot.connection.iceConnectionState,
-          connectionState: slot.connection.connectionState,
-          dataChannelState: slot.channel?.readyState ?? "no-channel",
-          pendingSendCount: slot.pendingSends.length,
-          pendingRemoteIceCount: slot.pendingRemoteIce.length,
-          inFlightSync: slot.inFlightSync ? { ...slot.inFlightSync } : undefined
-        } : undefined
+        slot: slot ? serialiseSlotView(slot) : undefined
       });
     }
     return {
@@ -2180,8 +2302,61 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
         return;
     }
   }
+  buildRtcConfiguration() {
+    const config = { iceServers: this.iceServers };
+    if (this.iceTransportPolicy !== undefined) {
+      config.iceTransportPolicy = this.iceTransportPolicy;
+    }
+    return config;
+  }
+  isRelayCandidateInit(init) {
+    const candidateStr = init.candidate ?? "";
+    const m = candidateStr.match(/\btyp\s+(\S+)/i);
+    return m?.[1]?.toLowerCase() === "relay";
+  }
+  shouldSendCandidate(candidate) {
+    if (!this.iceRelayEnforcement)
+      return true;
+    if (this.iceTransportPolicy !== "relay")
+      return true;
+    const typed = candidate.type;
+    const match = candidate.candidate.match(/\btyp\s+(\S+)/i);
+    const candidateType = (typed ?? match?.[1] ?? "").toLowerCase();
+    return candidateType === "relay";
+  }
+  filterSdpCandidatesByPolicy(sdp) {
+    if (!this.iceRelayEnforcement)
+      return sdp;
+    if (this.iceTransportPolicy !== "relay")
+      return sdp;
+    if (!sdp)
+      return sdp;
+    const lines = sdp.split(/\r?\n/);
+    const filtered = [];
+    for (const line of lines) {
+      if (!line.startsWith("a=candidate:")) {
+        filtered.push(line);
+        continue;
+      }
+      const m = line.match(/\btyp\s+(\S+)/i);
+      if (m?.[1]?.toLowerCase() === "relay")
+        filtered.push(line);
+    }
+    return filtered.join(`\r
+`);
+  }
+  applySdpPolicyFilter(description) {
+    if (!this.iceRelayEnforcement)
+      return description;
+    if (this.iceTransportPolicy !== "relay")
+      return description;
+    const filtered = this.filterSdpCandidatesByPolicy(description.sdp);
+    if (filtered === description.sdp)
+      return description;
+    return { ...description, sdp: filtered };
+  }
   createInitiatingSlot(targetId) {
-    const connection = new this.RTCPeerConnectionCtor({ iceServers: this.iceServers });
+    const connection = new this.RTCPeerConnectionCtor(this.buildRtcConfiguration());
     const channel = connection.createDataChannel(this.dataChannelLabel, { ordered: true });
     const slot = {
       connection,
@@ -2189,7 +2364,9 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       pendingSends: [],
       pendingFragments: new Map,
       pendingRemoteIce: [],
-      inFlightSync: undefined
+      inFlightSync: undefined,
+      transport: undefined,
+      lastDataChannelError: undefined
     };
     this.slots.set(targetId, slot);
     this.wireConnection(targetId, connection);
@@ -2200,7 +2377,15 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
   async initiateOffer(targetId, connection) {
     const offer = await connection.createOffer();
     await connection.setLocalDescription(offer);
-    this.signaling.sendSignal(targetId, { kind: "offer", sdp: offer });
+    const localOffer = connection.localDescription ?? offer;
+    const sdpToSend = this.applySdpPolicyFilter({
+      type: localOffer.type,
+      sdp: localOffer.sdp ?? offer.sdp
+    });
+    this.signaling.sendSignal(targetId, {
+      kind: "offer",
+      sdp: sdpToSend
+    });
   }
   async handleOffer(fromPeerId, sdp) {
     const existing = this.slots.get(fromPeerId);
@@ -2213,14 +2398,16 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       existing.connection.close();
       this.slots.delete(fromPeerId);
     }
-    const connection = new this.RTCPeerConnectionCtor({ iceServers: this.iceServers });
+    const connection = new this.RTCPeerConnectionCtor(this.buildRtcConfiguration());
     const slot = {
       connection,
       channel: undefined,
       pendingSends: [],
       pendingFragments: new Map,
       pendingRemoteIce: [],
-      inFlightSync: undefined
+      inFlightSync: undefined,
+      transport: undefined,
+      lastDataChannelError: undefined
     };
     this.slots.set(fromPeerId, slot);
     this.wireConnection(fromPeerId, connection);
@@ -2228,13 +2415,18 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       slot.channel = event.channel;
       this.wireDataChannel(fromPeerId, event.channel);
     };
-    await connection.setRemoteDescription(sdp);
+    await connection.setRemoteDescription(this.applySdpPolicyFilter(sdp));
     await this.flushPendingRemoteIce(slot);
     const answer = await connection.createAnswer();
     await connection.setLocalDescription(answer);
+    const localAnswer = connection.localDescription ?? answer;
+    const sdpToSend = this.applySdpPolicyFilter({
+      type: localAnswer.type,
+      sdp: localAnswer.sdp ?? answer.sdp
+    });
     this.signaling.sendSignal(fromPeerId, {
       kind: "answer",
-      sdp: answer
+      sdp: sdpToSend
     });
   }
   async handleAnswer(fromPeerId, sdp) {
@@ -2243,13 +2435,15 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       return;
     if (slot.connection.signalingState !== "have-local-offer")
       return;
-    await slot.connection.setRemoteDescription(sdp);
+    await slot.connection.setRemoteDescription(this.applySdpPolicyFilter(sdp));
     await this.flushPendingRemoteIce(slot);
   }
   async handleIceCandidate(fromPeerId, candidate) {
     const slot = this.slots.get(fromPeerId);
     if (!slot)
       return;
+    if (this.iceRelayEnforcement && this.iceTransportPolicy === "relay" && !this.isRelayCandidateInit(candidate))
+      return;
     if (slot.connection.remoteDescription === null) {
       slot.pendingRemoteIce.push(candidate);
       return;
@@ -2271,12 +2465,14 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
   }
   wireConnection(peerId, connection) {
     connection.onicecandidate = (event) => {
-      if (event.candidate) {
-        this.signaling.sendSignal(peerId, {
-          kind: "ice",
-          candidate: event.candidate.toJSON()
-        });
-      }
+      if (!event.candidate)
+        return;
+      if (!this.shouldSendCandidate(event.candidate))
+        return;
+      this.signaling.sendSignal(peerId, {
+        kind: "ice",
+        candidate: event.candidate.toJSON()
+      });
     };
     connection.onconnectionstatechange = () => {
       const state = connection.connectionState;
@@ -2315,6 +2511,34 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
         slot.channel = undefined;
       }
     };
+    channel.onerror = (event) => {
+      const slot = this.slots.get(peerId);
+      if (!slot)
+        return;
+      const ev = event;
+      const message = typeof ev.error?.message === "string" ? ev.error.message : typeof ev.message === "string" ? ev.message : "unknown data channel error";
+      slot.lastDataChannelError = message;
+    };
+  }
+  async refreshTransportStats(peerId) {
+    const slot = this.slots.get(peerId);
+    if (!slot)
+      return;
+    const snapshot = await collectTransportSnapshot(slot.connection, slot.lastDataChannelError);
+    slot.transport = snapshot;
+    return snapshot;
+  }
+  async refreshAllTransportStats() {
+    const out = new Map;
+    const peerIds = [...this.slots.keys()];
+    const results = await Promise.all(peerIds.map((id) => this.refreshTransportStats(id)));
+    for (let i = 0;i < peerIds.length; i += 1) {
+      const r = results[i];
+      const id = peerIds[i];
+      if (r && id !== undefined)
+        out.set(id, r);
+    }
+    return out;
   }
   dispatchMessage(fromPeerId, bytes) {
     try {
@@ -2514,6 +2738,12 @@ async function createMeshClient(options) {
     knownPeerIds,
     keyringSource,
     ...resolvedIceServers !== undefined && { iceServers: resolvedIceServers },
+    ...options.rtc?.iceTransportPolicy !== undefined && {
+      iceTransportPolicy: options.rtc.iceTransportPolicy
+    },
+    ...options.rtc?.iceRelayEnforcement !== undefined && {
+      iceRelayEnforcement: options.rtc.iceRelayEnforcement
+    },
     ...options.rtc?.dataChannelLabel !== undefined && {
       dataChannelLabel: options.rtc.dataChannelLabel
     },
@@ -2588,6 +2818,11 @@ async function createMeshClient(options) {
       }
       return webrtcAdapter.getPeerStateSnapshot();
     },
+    refreshTransportStats: async () => {
+      if (!webrtcAdapter)
+        return;
+      await webrtcAdapter.refreshAllTransportStats();
+    },
     close: async () => {
       signaling.close();
       webrtcAdapter?.disconnect();
@@ -3002,4 +3237,4 @@ export {
   $meshCounter
 };
 
-//# debugId=18409B674B254AA864756E2164756E21
+//# debugId=15751E988ED47F0264756E2164756E21