@actuallab/rpc 13.0.163 → 13.0.167

package/dist/index.cjs

@@ -1077,6 +1077,7 @@ var import_core5 = require("@actuallab/core");
 var { warnLog: warnLog3 } = getLogs("RpcSharedStream");
 var DEFAULT_ACK_PERIOD = 256;
 var DEFAULT_ACK_ADVANCE = 128;
+var RTT_WINDOW_MS = 2e4;
 var RpcStreamSender = class _RpcStreamSender {
   static _emptyGuid = "00000000-0000-0000-0000-000000000000";
   id;
@@ -1118,6 +1119,9 @@ var RpcStreamSender = class _RpcStreamSender {
   _lastAckedIndex = 0;
   _abortController = new AbortController();
   _iterator = null;
+  // -- RTT sampling (send → matching ack round trips, windowed minimum) --
+  _pendingSendTimes = [];
+  _rttSamples = [];
   // -- Recorder-controller metrics (Step 9.1) --
   /** Total items skipped via real-time `canSkipTo` compaction. */
   _skipCount = 0;
@@ -1142,6 +1146,21 @@ var RpcStreamSender = class _RpcStreamSender {
   get skipCount() {
     return this._skipCount;
   }
+  // Windowed-MIN ack round trip (ms, -1 until sampled): converges on propagation
+  // RTT — unlike a mean/EMA it is not inflated by self-induced queuing.
+  get minRttMs() {
+    const cutoffMs = Date.now() - RTT_WINDOW_MS;
+    while (this._rttSamples.length > 0 && this._rttSamples[0].atMs < cutoffMs)
+      this._rttSamples.shift();
+    if (this._rttSamples.length === 0)
+      return -1;
+    let min = this._rttSamples[0].rttMs;
+    for (const s of this._rttSamples) {
+      if (s.rttMs < min)
+        min = s.rttMs;
+    }
+    return min;
+  }
   // -- ACK queue (analog of .NET's Channel<(long, bool)>) --
   _acks = [];
   _whenAckReady = null;
@@ -1195,6 +1214,7 @@ var RpcStreamSender = class _RpcStreamSender {
       this._sendDisconnect();
       return;
     }
+    this._sampleRtt(nextIndex, mustReset);
     this._acks.push({ nextIndex, mustReset });
     if (this._whenAckReady) {
       this._whenAckReady.resolve();
@@ -1233,6 +1253,7 @@ var RpcStreamSender = class _RpcStreamSender {
         this._nextIndex,
         item
       );
+      this._pendingSendTimes.push({ index: this._nextIndex, sentAtMs: Date.now() });
     }
     this._nextIndex++;
   }
@@ -1475,6 +1496,26 @@ var RpcStreamSender = class _RpcStreamSender {
     await this._whenAckReady;
     this._whenAckReady = null;
   }
+  // One RTT sample per ack: time from sending the newest acked item to the
+  // ack's arrival (a slight upper bound — includes the server's ack cadence).
+  _sampleRtt(ackNextIndex, mustReset) {
+    if (mustReset) {
+      this._pendingSendTimes.length = 0;
+      return;
+    }
+    let sentAtMs = -1;
+    while (this._pendingSendTimes.length > 0 && this._pendingSendTimes[0].index < ackNextIndex) {
+      sentAtMs = this._pendingSendTimes[0].sentAtMs;
+      this._pendingSendTimes.shift();
+    }
+    if (sentAtMs < 0)
+      return;
+    const nowMs = Date.now();
+    const cutoffMs = nowMs - RTT_WINDOW_MS;
+    while (this._rttSamples.length > 0 && this._rttSamples[0].atMs < cutoffMs)
+      this._rttSamples.shift();
+    this._rttSamples.push({ atMs: nowMs, rttMs: nowMs - sentAtMs });
+  }
   // -- IRpcObject --
   reconnect() {
   }