@fairfox/polly 0.55.0 → 0.56.0

package/dist/src/mesh.d.ts

@@ -29,7 +29,7 @@ export type { MeshSignalingClientOptions, SignalingMessage as MeshSignalingMessa
 export { MeshSignalingClient } from "./shared/lib/mesh-signaling-client";
 export type { MeshStateOptions } from "./shared/lib/mesh-state";
 export { $meshCounter, $meshList, $meshState, $meshText, configureMeshState, resetMeshState, } from "./shared/lib/mesh-state";
-export type { MeshWebRTCAdapterOptions } from "./shared/lib/mesh-webrtc-adapter";
+export type { InFlightSyncSnapshot, MeshWebRTCAdapterOptions, SlotInitiationDecision, SlotInitiationRejectionReason, SweepSnapshot, SyncHandshakeAttemptSnapshot, SyncProgressEvent, TransportSnapshot, } from "./shared/lib/mesh-webrtc-adapter";
 export { DEFAULT_ICE_SERVERS, MeshWebRTCAdapter } from "./shared/lib/mesh-webrtc-adapter";
 export type { CreatePairingTokenOptions, PairingToken, } from "./shared/lib/pairing";
 export { applyPairingToken, createPairingToken, createPairingTokenWithFreshIdentity, DEFAULT_PAIRING_TTL_MS, decodePairingToken, encodePairingToken, isPairingTokenExpired, PAIRING_NONCE_BYTES, PAIRING_TOKEN_VERSION, PairingError, parsePairingToken, serialisePairingToken, } from "./shared/lib/pairing";

package/dist/src/mesh.js

@@ -2044,7 +2044,16 @@ function serialiseSlotView(slot) {
     transport: slot.transport ? {
       ...slot.transport,
       selectedCandidatePair: slot.transport.selectedCandidatePair ? { ...slot.transport.selectedCandidatePair } : undefined
-    } : undefined
+    } : undefined,
+    lastSyncHandshakeAttempt: { ...slot.lastSyncHandshakeAttempt }
+  };
+}
+function emptySyncHandshakeAttempt() {
+  return {
+    dataChannelOpenedAt: undefined,
+    peerCandidateEmittedAt: undefined,
+    firstOutboundSendAt: undefined,
+    firstInboundMessageAt: undefined
   };
 }
 function buildCandidatePairView(pair, localCands, remoteCands) {
@@ -2082,6 +2091,9 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
   slots = new Map;
   ready = false;
   readyResolver;
+  lastSlotInitiationDecisions = new Map;
+  sweepRunCount = 0;
+  lastSweepAt;
   get knownPeerIds() {
     if (this.keyringSource !== undefined) {
       return [...this.keyringSource().knownPeers.keys()].filter((id) => id !== this.localPeerId);
@@ -2134,10 +2146,13 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     const peers = [];
     for (const peerId of allPeers) {
       const slot = this.slots.get(peerId);
+      const decision = this.snapshotInitiationDecision(peerId);
       peers.push({
         peerId,
         knownInKeyring: knownPeerSet.has(peerId),
         presentInSignalling: this.presentPeers.has(peerId),
+        slotInitiationRejectionReason: decision.reason,
+        slotInitiationDecision: decision,
         slot: slot ? serialiseSlotView(slot) : undefined
       });
     }
@@ -2145,6 +2160,12 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       localPeerId: this.localPeerId,
       knownPeerIds,
       presentPeerIds,
+      sweep: {
+        enabled: this.knownPeersRefreshTimer !== undefined,
+        intervalMs: this.knownPeersRefreshIntervalMs,
+        runCount: this.sweepRunCount,
+        lastRunAt: this.lastSweepAt
+      },
       peers
     };
   }
@@ -2152,14 +2173,27 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     this.presentPeers.add(remotePeerId);
     if (!this.shouldInitiateTo(remotePeerId))
       return;
-    this.createInitiatingSlot(remotePeerId);
+    this.tryCreateInitiatingSlot(remotePeerId);
   }
   handlePeersPresent(peerIds) {
     for (const remotePeerId of peerIds) {
       this.presentPeers.add(remotePeerId);
       if (!this.shouldInitiateTo(remotePeerId))
         continue;
+      this.tryCreateInitiatingSlot(remotePeerId);
+    }
+  }
+  tryCreateInitiatingSlot(remotePeerId) {
+    try {
       this.createInitiatingSlot(remotePeerId);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      this.lastSlotInitiationDecisions.set(remotePeerId, {
+        decision: "rejected",
+        reason: "fatal-error",
+        error: message,
+        at: performance.now()
+      });
     }
   }
   handlePeerLeft(remotePeerId) {
@@ -2183,25 +2217,49 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       return;
     if (!this.shouldInitiateTo(remotePeerId))
       return;
-    this.createInitiatingSlot(remotePeerId);
+    this.tryCreateInitiatingSlot(remotePeerId);
   }
   refreshKnownPeers() {
     for (const remotePeerId of this.presentPeers) {
       if (!this.shouldInitiateTo(remotePeerId))
         continue;
-      this.createInitiatingSlot(remotePeerId);
+      this.tryCreateInitiatingSlot(remotePeerId);
     }
   }
   shouldInitiateTo(remotePeerId) {
+    const reason = this.evaluateInitiation(remotePeerId);
+    this.lastSlotInitiationDecisions.set(remotePeerId, {
+      decision: reason === undefined ? "accepted" : "rejected",
+      reason,
+      error: undefined,
+      at: performance.now()
+    });
+    return reason === undefined;
+  }
+  evaluateInitiation(remotePeerId) {
     if (remotePeerId === this.localPeerId)
-      return false;
+      return "self";
     if (!this.hasKnownPeer(remotePeerId))
-      return false;
+      return "not-in-keyring";
+    if (!this.presentPeers.has(remotePeerId))
+      return "not-present";
     if (this.slots.has(remotePeerId))
-      return false;
+      return "slot-already-exists";
     if (this.localPeerId <= remotePeerId)
-      return false;
-    return true;
+      return "tie-break-other-side";
+    return;
+  }
+  snapshotInitiationDecision(remotePeerId) {
+    const cached = this.lastSlotInitiationDecisions.get(remotePeerId);
+    if (cached?.reason === "fatal-error")
+      return cached;
+    const reason = this.evaluateInitiation(remotePeerId);
+    return {
+      decision: reason === undefined ? "accepted" : "rejected",
+      reason,
+      error: undefined,
+      at: performance.now()
+    };
   }
   whenReady() {
     if (this.ready)
@@ -2238,7 +2296,11 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     if (this.knownPeersRefreshTimer !== undefined)
       return;
     this.knownPeersRefreshTimer = setInterval(() => {
-      this.refreshKnownPeers();
+      this.sweepRunCount += 1;
+      this.lastSweepAt = performance.now();
+      try {
+        this.refreshKnownPeers();
+      } catch {}
     }, this.knownPeersRefreshIntervalMs);
   }
   stopKnownPeersSweep() {
@@ -2254,6 +2316,9 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     if (!slot) {
       slot = this.createInitiatingSlot(targetId);
     }
+    if (slot.lastSyncHandshakeAttempt.firstOutboundSendAt === undefined) {
+      slot.lastSyncHandshakeAttempt.firstOutboundSendAt = performance.now();
+    }
     if (slot.channel && slot.channel.readyState === "open") {
       this.sendBytesMaybeFragmented(slot.channel, bytes);
     } else {
@@ -2366,7 +2431,8 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       pendingRemoteIce: [],
       inFlightSync: undefined,
       transport: undefined,
-      lastDataChannelError: undefined
+      lastDataChannelError: undefined,
+      lastSyncHandshakeAttempt: emptySyncHandshakeAttempt()
     };
     this.slots.set(targetId, slot);
     this.wireConnection(targetId, connection);
@@ -2407,7 +2473,8 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       pendingRemoteIce: [],
       inFlightSync: undefined,
       transport: undefined,
-      lastDataChannelError: undefined
+      lastDataChannelError: undefined,
+      lastSyncHandshakeAttempt: emptySyncHandshakeAttempt()
     };
     this.slots.set(fromPeerId, slot);
     this.wireConnection(fromPeerId, connection);
@@ -2477,21 +2544,32 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     connection.onconnectionstatechange = () => {
       const state = connection.connectionState;
       if (state === "connected") {
-        this.emit("peer-candidate", {
-          peerId,
-          peerMetadata: {}
-        });
+        this.emitPeerCandidateOnce(peerId);
       } else if (state === "disconnected" || state === "failed" || state === "closed") {
         this.slots.delete(peerId);
         this.emit("peer-disconnected", { peerId });
       }
     };
   }
+  emitPeerCandidateOnce(peerId) {
+    const slot = this.slots.get(peerId);
+    if (!slot)
+      return;
+    if (slot.lastSyncHandshakeAttempt.peerCandidateEmittedAt !== undefined)
+      return;
+    slot.lastSyncHandshakeAttempt.peerCandidateEmittedAt = performance.now();
+    this.emit("peer-candidate", {
+      peerId,
+      peerMetadata: {}
+    });
+  }
   wireDataChannel(peerId, channel) {
     channel.onopen = () => {
       const slot = this.slots.get(peerId);
       if (!slot)
         return;
+      slot.lastSyncHandshakeAttempt.dataChannelOpenedAt = performance.now();
+      this.emitPeerCandidateOnce(peerId);
       for (const bytes of slot.pendingSends) {
         this.sendBytesMaybeFragmented(channel, bytes);
       }
@@ -2559,6 +2637,7 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
     } catch {}
   }
   scheduleEmitMessage(fromPeerId, message, viaFragmentPath) {
+    this.stampFirstInboundMessage(fromPeerId);
     if (!this.syncYieldEnabled) {
       this.emit("message", message);
       if (viaFragmentPath) {
@@ -2582,6 +2661,14 @@ class MeshWebRTCAdapter extends NetworkAdapter2 {
       }
     }, 0);
   }
+  stampFirstInboundMessage(fromPeerId) {
+    const slot = this.slots.get(fromPeerId);
+    if (!slot)
+      return;
+    if (slot.lastSyncHandshakeAttempt.firstInboundMessageAt !== undefined)
+      return;
+    slot.lastSyncHandshakeAttempt.firstInboundMessageAt = performance.now();
+  }
   finishInFlightSyncApply(fromPeerId) {
     const slot = this.slots.get(fromPeerId);
     if (!slot?.inFlightSync)
@@ -2813,6 +2900,12 @@ async function createMeshClient(options) {
           localPeerId: options.signaling.peerId,
           knownPeerIds: [],
           presentPeerIds: [],
+          sweep: {
+            enabled: false,
+            intervalMs: 0,
+            runCount: 0,
+            lastRunAt: undefined
+          },
           peers: []
         };
       }
@@ -3237,4 +3330,4 @@ export {
   $meshCounter
 };
 
-//# debugId=15751E988ED47F0264756E2164756E21
+//# debugId=27D9577FC215E14564756E2164756E21