@peerbit/shared-log 16.0.24 → 16.0.25

package/dist/src/index.js

@@ -55,7 +55,7 @@ import { CoordinatePersistenceCoordinator, combineCoordinateDeleteHashes, isProm
 import { CPUUsageIntervalLag } from "./cpu.js";
 import { debouncedAccumulatorMap, } from "./debounce.js";
 import { CompatibilityModeRetiredError, NativeDurableCommitError, NoPeersError, PersistedDeliveryError, isNotStartedError, } from "./errors.js";
-import { EXCHANGE_HEADS_REPAIR_HINT, EntryWithRefs, ExchangeHeadsMessage, MAX_RAW_EXCHANGE_MESSAGE_SIZE, RawEntryWithRefs, RawExchangeHeadsMessage, RequestIPrune, RequestIPruneV2, ResponseIPrune, ResponseIPruneV2, SYNC_CAPABILITY_PERSISTED_ENTRY_RECEIPTS, SYNC_CAPABILITY_RAW_EXCHANGE_HEADS, SYNC_CAPABILITY_REPLICATION_INFO_V2_APPLY, SYNC_CAPABILITY_REPLICATION_INFO_V2_CONFIRM, SYNC_CAPABILITY_REPLICATION_INFO_V2_DECODE, SYNC_CAPABILITY_REPLICATION_INFO_V2_SEND, StashBackedRawExchangeHeadsMessage, SyncCapabilitiesMessage, collectRawExchangeHeadSendPlan, createExchangeHeadsMessages, createRawExchangeHeadsMessages, getExchangeHeadHash, getPreparedRawExchangeGid, getPreparedRawExchangeHashNumber, getPreparedRawExchangeHeadAppendFacts, getPreparedRawExchangeHeadGid, getPreparedRawExchangeHeadRequestedReplicas, getPreparedRawExchangeHeadShallowEntry, getPreparedRawExchangeHeadSignatureVerified, getPreparedRawExchangeNext, getPreparedRawExchangeRequestedReplicas, getPreparedRawExchangeTimestamp, getRawExchangeHeadByteLength, getRawExchangeHeadStashIndexes, initExchangeHeadEntry, isPreparedRawEntryWithRefs, isStashBackedRawExchangeHeadsMessage, materializeVerifiedRawExchangeHeadsMessage, } from "./exchange-heads.js";
+import { EXCHANGE_HEADS_REPAIR_HINT, EntryWithRefs, ExchangeHeadsMessage, MAX_RAW_EXCHANGE_MESSAGE_SIZE, RawEntryWithRefs, RawExchangeHeadsMessage, RequestIPrune, RequestIPruneV2, ResponseIPrune, ResponseIPruneV2, SYNC_CAPABILITY_PERSISTED_ENTRY_RECEIPTS, SYNC_CAPABILITY_RAW_EXCHANGE_HEADS, SYNC_CAPABILITY_REPLICATION_INFO_V2_APPLY, SYNC_CAPABILITY_REPLICATION_INFO_V2_CONFIRM, SYNC_CAPABILITY_REPLICATION_INFO_V2_DECODE, SYNC_CAPABILITY_REPLICATION_INFO_V2_REARM, SYNC_CAPABILITY_REPLICATION_INFO_V2_SEND, StashBackedRawExchangeHeadsMessage, SyncCapabilitiesMessage, collectRawExchangeHeadSendPlan, createExchangeHeadsMessages, createRawExchangeHeadsMessages, getExchangeHeadHash, getPreparedRawExchangeGid, getPreparedRawExchangeHashNumber, getPreparedRawExchangeHeadAppendFacts, getPreparedRawExchangeHeadGid, getPreparedRawExchangeHeadRequestedReplicas, getPreparedRawExchangeHeadShallowEntry, getPreparedRawExchangeHeadSignatureVerified, getPreparedRawExchangeNext, getPreparedRawExchangeRequestedReplicas, getPreparedRawExchangeTimestamp, getRawExchangeHeadByteLength, getRawExchangeHeadStashIndexes, initExchangeHeadEntry, isPreparedRawEntryWithRefs, isStashBackedRawExchangeHeadsMessage, materializeVerifiedRawExchangeHeadsMessage, } from "./exchange-heads.js";
 import { FanoutEnvelope } from "./fanout-envelope.js";
 import { InstanceLifecycle } from "./instance-lifecycle.js";
 import { MAX_U32, MAX_U64, createNumbers, } from "./integers.js";
@@ -2024,7 +2024,10 @@ let SharedLog = (() => {
             const peerHash = properties.target.hashcode();
             const receiverTransportSession = this.ownTransportSession();
             await this.rpc.send(new SyncCapabilitiesMessage({
-                capabilities: this.replicationInfoV2ReceiveCapabilities(),
+                capabilities: this.replicationInfoV2ReceiveCapabilities() |
+                    (properties.requestRemoteFullRearm
+                        ? SYNC_CAPABILITY_REPLICATION_INFO_V2_REARM
+                        : 0),
             }), {
                 mode: new AcknowledgeDelivery({
                     redundancy: 1,
@@ -2078,6 +2081,7 @@ let SharedLog = (() => {
                     peerSession: properties.peerSession,
                     receiveEpoch: properties.receiveEpoch,
                     signal: properties.signal,
+                    requestRemoteFullRearm: properties.requestRemoteFullRearm,
                 }),
                 onRequestError: (error) => {
                     if (isNotStartedError(error) ||
@@ -3447,7 +3451,7 @@ let SharedLog = (() => {
                 })) {
                 return undefined;
             }
-            return { capabilitySession, peerSession };
+            return { capabilitySession, peerSession, receiveEpoch };
         }
         async waitPersistedReceiptRetry(signal, ms) {
             try {
@@ -15966,6 +15970,13 @@ let SharedLog = (() => {
                         if (!context.from.equals(this.node.identity.publicKey)) {
                             const capabilityTransportSession = context.message?.header?.session;
                             const capabilityTimestamp = context.message?.header?.timestamp;
+                            const previousCapabilitySession = this._peerSyncCapabilitySessions.get(receiveFromHash);
+                            const previousCapabilityTimestamp = this._peerSyncCapabilityTimestamps.get(receiveFromHash);
+                            const requestsRemoteFullRearm = (msg.capabilities & SYNC_CAPABILITY_REPLICATION_INFO_V2_REARM) !==
+                                0;
+                            // The rearm bit is a one-shot authenticated command, not a sticky
+                            // negotiated capability. Store and promote only the steady bits.
+                            const steadyCapabilities = msg.capabilities & ~SYNC_CAPABILITY_REPLICATION_INFO_V2_REARM;
                             // No await separates this from the capture above, so the captured
                             // window state is exact: the legacy re-read of the opening map here
                             // could never observe a different value.
@@ -15976,7 +15987,7 @@ let SharedLog = (() => {
                                 // cleanup cannot erase it before the opening transition commits.
                                 this.observePeerSyncCapabilities({
                                     peerHash: receiveFromHash,
-                                    capabilities: msg.capabilities,
+                                    capabilities: steadyCapabilities,
                                     transportSession: capabilityTransportSession,
                                     timestamp: capabilityTimestamp,
                                     openingSession: receiveSession,
@@ -15985,12 +15996,34 @@ let SharedLog = (() => {
                             else {
                                 const observed = this.observePeerSyncCapabilities({
                                     peerHash: receiveFromHash,
-                                    capabilities: msg.capabilities,
+                                    capabilities: steadyCapabilities,
                                     transportSession: capabilityTransportSession,
                                     timestamp: capabilityTimestamp,
                                 });
                                 if (observed && receiveSession?.phase === "open") {
                                     this.promoteReplicationInfoV2ReceiveCapability(context.from, receiveSession);
+                                    const freshExactRearm = requestsRemoteFullRearm &&
+                                        capabilityTransportSession !== undefined &&
+                                        capabilityTimestamp !== undefined &&
+                                        previousCapabilitySession === capabilityTransportSession &&
+                                        previousCapabilityTimestamp !== undefined &&
+                                        capabilityTimestamp > previousCapabilityTimestamp;
+                                    if (freshExactRearm &&
+                                        this._v2Receive.isCurrentActive({
+                                            peerHash: receiveFromHash,
+                                            peerSession: receiveSession,
+                                            receiveEpoch: this._peerSessions.receiveEpoch(receiveFromHash),
+                                            senderTransportSession: capabilityTransportSession,
+                                        })) {
+                                        // Rotate the receiver grant/challenge before requesting Full. A
+                                        // sender rebuilt from no state starts at sequence one, which an
+                                        // active receiver's old sequence fence must otherwise reject.
+                                        this._v2Receive.advanceRecovery({
+                                            peerHash: receiveFromHash,
+                                            peerSession: receiveSession,
+                                            receiveEpoch: this._peerSessions.receiveEpoch(receiveFromHash),
+                                        });
+                                    }
                                 }
                                 else if (observed && receiveSession === null) {
                                     // A capability can arrive before the sender's topic Subscribe after
@@ -16855,8 +16888,8 @@ let SharedLog = (() => {
             }
             throwIfInactive();
         }
-        nudgePersistedReceiptPeerReadiness(publicKey) {
-            if (this.closed)
+        nudgePersistedReceiptPeerReadiness(publicKey, signal) {
+            if (this.closed || signal.aborted)
                 return;
             const peerHash = publicKey.hashcode();
             const peerSession = this._peerSessions.current(peerHash);
@@ -16886,6 +16919,20 @@ let SharedLog = (() => {
                 peerSession,
                 receiveEpoch,
             });
+            const receiptTarget = this.persistedReceiptPeerSession(peerHash);
+            if (receiptTarget &&
+                !this._v2Send.hasCurrentStateForPeer({
+                    peerHash,
+                    peerSession: receiptTarget.peerSession,
+                    receiverTransportSession: receiptTarget.capabilitySession,
+                })) {
+                this._v2Receive.reAdvertiseLocalCapabilityForRemoteFull({
+                    peerHash,
+                    peerSession: receiptTarget.peerSession,
+                    receiveEpoch: receiptTarget.receiveEpoch,
+                    signal,
+                });
+            }
             this.scheduleReplicationInfoV2Recovery(publicKey);
         }
         /**
@@ -17079,17 +17126,25 @@ let SharedLog = (() => {
                     throw new AbortError("Persisted-receipt readiness wait settled");
                 }
             };
+            const recoveryDelayMs = Math.max(50, Math.min(1_000, this.waitForReplicatorRequestIntervalMs));
             const armRecoveryTick = () => {
                 if (settled || recoveryTimer)
                     return;
-                const delayMs = Math.max(50, Math.min(1_000, this.waitForReplicatorRequestIntervalMs));
                 recoveryTimer = setTimeout(() => {
                     recoveryTimer = undefined;
                     if (!continueWait())
                         return;
-                    this.nudgePersistedReceiptPeerReadiness(key);
+                    this.nudgePersistedReceiptPeerReadiness(key, operationSignal);
+                    if (checkInFlight) {
+                        // Confirmation can legitimately span several recovery intervals.
+                        // Keep repairing the exact current generation without aborting its
+                        // one application-confirmation waiter on every tick.
+                        rerun = true;
+                        armRecoveryTick();
+                        return;
+                    }
                     scheduleCheck();
-                }, delayMs);
+                }, recoveryDelayMs);
                 recoveryTimer.unref?.();
             };
             const runCheck = async () => {
@@ -17119,6 +17174,11 @@ let SharedLog = (() => {
                         snapshot.reason === "replication-confirmation-pending") {
                         const target = this.persistedReceiptPeerSession(peerHash);
                         if (target) {
+                            // A confirmation waiter cannot create an outbound V2 stream when
+                            // that exact session state is missing. Nudge first, then keep the
+                            // recovery tick alive while the single confirmation wait remains.
+                            this.nudgePersistedReceiptPeerReadiness(key, operationSignal);
+                            armRecoveryTick();
                             const currentConfirmationController = new AbortController();
                             confirmationController = currentConfirmationController;
                             try {
@@ -17163,7 +17223,7 @@ let SharedLog = (() => {
                     }
                     if (!continueWait())
                         return;
-                    this.nudgePersistedReceiptPeerReadiness(key);
+                    this.nudgePersistedReceiptPeerReadiness(key, operationSignal);
                 }
                 catch (error) {
                     if (!settled)