@streamr/trackerless-network 103.6.0-rc.0 → 103.8.0-rc.3

package/dist/exports.cjs

@@ -29,7 +29,7 @@ class ExternalNetworkRpc {
     }
 }
 
-var version = "103.6.0-rc.0";
+var version = "103.8.0-rc.3";
 
 // @generated message type with reflection information, may provide speed optimized methods
 class Any$Type extends runtime.MessageType {
@@ -2404,12 +2404,72 @@ class NeighborUpdateManager {
     }
 }
 
+let enabled = false;
+function setGapDiagnosticsEnabled(val) {
+    enabled = val;
+    globalThis.__trackerlessGapDiagEnabled = val;
+}
+const SUMMARY_INTERVAL_MS = 2000;
+const accumulators = new Map();
+function logGapDiagnosticSampled(layer, opts = {}) {
+    if (!enabled)
+        return;
+    const now = performance.now();
+    const threshold = opts.outlierThresholdMs ?? 30;
+    let acc = accumulators.get(layer);
+    if (acc === undefined) {
+        acc = { count: 0, sumDeltaMs: 0, maxDeltaMs: 0, outlierCount: 0, lastReportMs: now, lastEventMs: now };
+        accumulators.set(layer, acc);
+        return;
+    }
+    const deltaMs = now - acc.lastEventMs;
+    acc.lastEventMs = now;
+    acc.count++;
+    if (deltaMs > acc.maxDeltaMs)
+        acc.maxDeltaMs = deltaMs;
+    acc.sumDeltaMs += deltaMs;
+    if (deltaMs > threshold)
+        acc.outlierCount++;
+    if (deltaMs > threshold) {
+        const payload = {
+            layer,
+            timestampMs: now,
+            deltaMs: +deltaMs.toFixed(2),
+            detail: opts.detail,
+        };
+        // eslint-disable-next-line no-console
+        console.log('[gap-diagnostics]', JSON.stringify(payload));
+    }
+    if (now - acc.lastReportMs >= SUMMARY_INTERVAL_MS) {
+        const summaryDetail = {
+            count: acc.count,
+            meanDeltaMs: acc.count > 0 ? +(acc.sumDeltaMs / acc.count).toFixed(2) : 0,
+            maxDeltaMs: +acc.maxDeltaMs.toFixed(2),
+            outlierCount: acc.outlierCount,
+            periodMs: +(now - acc.lastReportMs).toFixed(1),
+        };
+        const summary = {
+            layer: `${layer}.summary`,
+            timestampMs: now,
+            detail: summaryDetail,
+        };
+        // eslint-disable-next-line no-console
+        console.log('[gap-diagnostics]', JSON.stringify(summary));
+        acc.count = 0;
+        acc.sumDeltaMs = 0;
+        acc.maxDeltaMs = 0;
+        acc.outlierCount = 0;
+        acc.lastReportMs = now;
+    }
+}
+
 class ContentDeliveryRpcLocal {
     options;
     constructor(options) {
         this.options = options;
     }
     async sendStreamMessage(message, context) {
+        logGapDiagnosticSampled('trackerless.rpcLocal.sendStreamMessage');
         const previousNode = context.incomingSourceDescriptor;
         const previousNodeId = dht.toNodeId(previousNode);
         this.options.markForInspection(previousNodeId, message.messageId);
@@ -2770,12 +2830,23 @@ class ContentDeliveryLayerNode extends eventemitter3.EventEmitter {
         this.options.neighborFinder.stop();
         this.options.neighborUpdateManager.stop();
         this.options.inspector.stop();
+        this.duplicateDetectors.clear();
     }
     broadcast(msg, previousNode) {
         if (!previousNode) {
+            logGapDiagnosticSampled('trackerless.cdNode.broadcastOut');
             markAndCheckDuplicate(this.duplicateDetectors, msg.messageId, msg.previousMessageRef);
         }
-        this.emit('message', msg);
+        else {
+            logGapDiagnosticSampled('trackerless.cdNode.broadcastIn');
+        }
+        // Deliver to local listeners — except own publishes (no previousNode)
+        // when loopback is suppressed: nothing local consumes them and they
+        // would otherwise be re-serialized across a worker boundary just to be
+        // discarded. Propagation + duplicate detection below are unaffected.
+        if (previousNode !== undefined || !this.options.suppressOwnMessageLoopback) {
+            this.emit('message', msg);
+        }
         const skipBackPropagation = previousNode !== undefined && !this.options.temporaryConnectionRpcLocal.hasNode(previousNode);
         this.options.propagation.feedUnseenMessage(msg, this.getPropagationTargets(msg), skipBackPropagation ? previousNode : null);
         this.messagesPropagated += 1;
@@ -3072,6 +3143,7 @@ class Propagation {
     }
     sendAndAwaitThenMark({ message, source, handledNeighbors }, neighborId) {
         if (!handledNeighbors.has(neighborId) && neighborId !== source) {
+            logGapDiagnosticSampled('trackerless.propagation.sendToNeighbor');
             (async () => {
                 try {
                     await this.sendToNeighbor(neighborId, message);
@@ -3629,6 +3701,9 @@ class PlumtreeManager extends eventemitter3.EventEmitter {
     stop() {
         this.abortController.abort();
         this.neighbors.off('nodeRemoved', this.onNeighborRemoved);
+        this.latestMessages.clear();
+        this.recoveryState.clear();
+        this.recoveryCooldownUntil.clear();
     }
 }
 
@@ -4151,6 +4226,7 @@ class ContentDeliveryManager extends eventemitter3.EventEmitter {
             neighborUpdateInterval: this.options.neighborUpdateInterval,
             isLocalNodeEntryPoint,
             bufferWhileConnecting: this.options.bufferWhileConnecting,
+            suppressOwnMessageLoopback: this.options.suppressOwnMessageLoopback,
             plumtreeOptimization: streamPartDeliveryOptions?.plumtreeOptimization?.enabled,
             plumtreeMaxPausedNeighbors: streamPartDeliveryOptions?.plumtreeOptimization?.enabled === true ?
                 streamPartDeliveryOptions?.plumtreeOptimization?.maxPausedNeighbors : undefined
@@ -4580,5 +4656,7 @@ exports.NetworkNode = NetworkNode;
 exports.NetworkStack = NetworkStack;
 exports.StreamMessage = StreamMessage;
 exports.createNetworkNode = createNetworkNode;
+exports.logGapDiagnosticSampled = logGapDiagnosticSampled;
+exports.setTrackerlessGapDiagnosticsEnabled = setGapDiagnosticsEnabled;
 exports.streamPartIdToDataKey = streamPartIdToDataKey;
 //# sourceMappingURL=exports.cjs.map