@streamr/dht 103.3.1 → 103.7.0-rc.2

package/dist/exports-nodejs.d.ts

@@ -367,18 +367,17 @@ declare class Timestamp$Type extends MessageType<Timestamp> {
  */
 interface Timestamp {
     /**
-     * Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must
-     * be between -315576000000 and 315576000000 inclusive (which corresponds to
-     * 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
+     * Represents seconds of UTC time since Unix epoch
+     * 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+     * 9999-12-31T23:59:59Z inclusive.
      *
      * @generated from protobuf field: int64 seconds = 1
      */
     seconds: number;
     /**
-     * Non-negative fractions of a second at nanosecond resolution. This field is
-     * the nanosecond portion of the duration, not an alternative to seconds.
-     * Negative second values with fractions must still have non-negative nanos
-     * values that count forward in time. Must be between 0 and 999,999,999
+     * Non-negative fractions of a second at nanosecond resolution. Negative
+     * second values with fractions must still have non-negative nanos values
+     * that count forward in time. Must be from 0 to 999,999,999
      * inclusive.
      *
      * @generated from protobuf field: int32 nanos = 2
@@ -1317,5 +1316,16 @@ declare class Handshaker extends EventEmitter<HandshakerEvents> {
     stop(): void;
 }
 
-export { ConnectionManager, ConnectionType, DataEntry, DefaultConnectorFacade, DhtCallContext, DhtNode, EXISTING_CONNECTION_TIMEOUT, LatencyType, ListeningRpcCommunicator, ManagedConnection, Message, NodeType, PeerDescriptor, PendingConnection, RoutingRpcCommunicator, RpcRemote, Simulator, SimulatorTransport, WebsocketClientConnection, areEqualPeerDescriptors, createOutgoingHandshaker, getRandomRegion, getRegionDelayMatrix, randomDhtAddress, toDhtAddress, toDhtAddressRaw, toNodeId };
+/**
+ * Stub for the Node.js build — `installWebrtcBridge` is a browser-only API.
+ */
+declare function installWebrtcBridge(_worker: unknown): void;
+
+declare function setGapDiagnosticsEnabled(val: boolean): void;
+declare function logGapDiagnosticSampled(layer: string, opts?: {
+    detail?: Record<string, unknown>;
+    outlierThresholdMs?: number;
+}): void;
+
+export { ConnectionManager, ConnectionType, DataEntry, DefaultConnectorFacade, DhtCallContext, DhtNode, EXISTING_CONNECTION_TIMEOUT, LatencyType, ListeningRpcCommunicator, ManagedConnection, Message, NodeType, PeerDescriptor, PendingConnection, RoutingRpcCommunicator, RpcRemote, Simulator, SimulatorTransport, WebsocketClientConnection, areEqualPeerDescriptors, createOutgoingHandshaker, getRandomRegion, getRegionDelayMatrix, installWebrtcBridge, logGapDiagnosticSampled, randomDhtAddress, setGapDiagnosticsEnabled, toDhtAddress, toDhtAddressRaw, toNodeId };
 export type { ConnectionLocker, ConnectionsView, DhtAddress, DhtAddressRaw, DhtNodeEvents, DhtNodeOptions, DhtRpcOptions, IConnection, ITransport, IceServer, LockID, PortRange, RingContacts, ServiceID, TlsCertificate, TransportEvents };

package/dist/exports-nodejs.js

@@ -249,6 +249,65 @@ class SendFailed extends Err {
     constructor(message, originalError) { super(ErrorCode.SEND_FAILED, message, originalError); }
 }
 
+let enabled = false;
+function setGapDiagnosticsEnabled(val) {
+    enabled = val;
+    globalThis.__dhtGapDiagEnabled = 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;
+    }
+}
+
 // @generated message type with reflection information, may provide speed optimized methods
 class Empty$Type extends MessageType {
     constructor() {
@@ -2293,6 +2352,7 @@ class ConnectionManager extends EventEmitter {
         if ((this.state === ConnectionManagerState.STOPPED || this.state === ConnectionManagerState.STOPPING) && !opts.sendIfStopped) {
             return;
         }
+        logGapDiagnosticSampled('dht.connMgr.send');
         const peerDescriptor = message.targetDescriptor;
         if (this.isConnectionToSelf(peerDescriptor)) {
             throw new CannotConnectToSelf('Cannot send to self');
@@ -2368,6 +2428,7 @@ class ConnectionManager extends EventEmitter {
             this.rpcCommunicator?.handleMessageFromPeer(message);
         }
         else {
+            logGapDiagnosticSampled('dht.connMgr.emitMessage');
             logger$B.trace('emit "message" ' + toNodeId(message.sourceDescriptor)
                 + ' ' + message.serviceId + ' ' + message.messageId);
             this.emit('message', message);
@@ -2377,6 +2438,7 @@ class ConnectionManager extends EventEmitter {
         if (this.state === ConnectionManagerState.STOPPED) {
             return;
         }
+        logGapDiagnosticSampled('dht.connMgr.onData');
         this.metrics.receiveBytesPerSecond.record(data.byteLength);
         this.metrics.receiveMessagesPerSecond.record(1);
         let message;
@@ -2810,7 +2872,7 @@ const parseVersion = (version) => {
     }
 };
 
-var version = "103.3.1";
+var version = "103.7.0-rc.2";
 
 const logger$z = new Logger('Handshaker');
 // Optimally the Outgoing and Incoming Handshakers could be their own separate classes
@@ -5714,7 +5776,7 @@ class PeerDiscovery {
             logger$d.debug(`Ring join on ${this.options.serviceId} timed out`);
         }
         finally {
-            sessions.forEach((session) => this.ongoingDiscoverySessions.delete(session.id));
+            sessions.forEach((session) => this.ongoingRingDiscoverySessions.delete(session.id));
         }
     }
     async rejoinDht(entryPoint, contactedPeers = new Set(), distantJoinContactPeers = new Set()) {
@@ -7805,5 +7867,12 @@ class SimulatorTransport extends ConnectionManager {
     }
 }
 
-export { ConnectionManager, ConnectionType, DataEntry, DefaultConnectorFacade, DhtCallContext, DhtNode, EXISTING_CONNECTION_TIMEOUT, LatencyType, ListeningRpcCommunicator, ManagedConnection, Message, NodeType, PeerDescriptor, PendingConnection, RoutingRpcCommunicator, RpcRemote, Simulator, SimulatorTransport, WebsocketClientConnection, areEqualPeerDescriptors, createOutgoingHandshaker, getRandomRegion, getRegionDelayMatrix, randomDhtAddress, toDhtAddress, toDhtAddressRaw, toNodeId };
+/**
+ * Stub for the Node.js build — `installWebrtcBridge` is a browser-only API.
+ */
+function installWebrtcBridge(_worker) {
+    throw new Error('installWebrtcBridge is only supported in browser environments');
+}
+
+export { ConnectionManager, ConnectionType, DataEntry, DefaultConnectorFacade, DhtCallContext, DhtNode, EXISTING_CONNECTION_TIMEOUT, LatencyType, ListeningRpcCommunicator, ManagedConnection, Message, NodeType, PeerDescriptor, PendingConnection, RoutingRpcCommunicator, RpcRemote, Simulator, SimulatorTransport, WebsocketClientConnection, areEqualPeerDescriptors, createOutgoingHandshaker, getRandomRegion, getRegionDelayMatrix, installWebrtcBridge, logGapDiagnosticSampled, randomDhtAddress, setGapDiagnosticsEnabled, toDhtAddress, toDhtAddressRaw, toNodeId };
 //# sourceMappingURL=exports-nodejs.js.map