@peerbit/shared-log 13.2.33 → 13.2.34

package/dist/src/replication-info-v2-receive.d.ts

@@ -4,6 +4,7 @@ type LegacyReplicationInfoMessage = AllReplicatingSegmentsMessage | AddedReplica
 export type ReplicationInfoV2ReceivePhase = "awaiting-full" | "active" | "resync";
 type LocalCapabilityReady = {
     peerHash: string;
+    receiveEpoch: object | null;
     receiverTransportSession: bigint;
     /**
      * The local capability envelope and the later RequestV2 envelope use the
@@ -11,6 +12,41 @@ type LocalCapabilityReady = {
      * be strictly newer, so never construct it in this captured millisecond.
      */
     requestNotBeforeMs: number;
+    advertisement?: ReplicationInfoV2LocalCapabilityAdvertisement;
+};
+type LocalCapabilityReadyProperties = {
+    peerHash: string;
+    peerSession: object;
+    receiveEpoch: object | null;
+    receiverTransportSession: bigint;
+    requestNotBeforeMs: number;
+};
+export type ReplicationInfoV2LocalCapabilityAdvertisementHandle = {
+    firstAttempt: Promise<void>;
+    releaseLegacyBarrier(): void;
+};
+export type ReplicationInfoV2LocalCapabilityContext = {
+    peerHash: string;
+    target: PublicSignKey;
+    lifecycleSignal: AbortSignal;
+    legacyBarrierReleased: boolean;
+};
+export type ReplicationInfoV2LocalCapabilityAdvertisement = {
+    peerHash: string;
+    target: PublicSignKey;
+    peerSession: object;
+    receiveEpoch: object | null;
+    lifecycleSignal: AbortSignal;
+    onLifecycleAbort: () => void;
+    controller: AbortController;
+    context: ReplicationInfoV2LocalCapabilityContext;
+    attempts: number;
+    ready: boolean;
+    acknowledgedReady?: LocalCapabilityReady;
+    receiverTransportSession?: bigint;
+    timer?: ReturnType<typeof setTimeout>;
+    inFlight?: Promise<void>;
+    firstAttempt?: Promise<void>;
 };
 export type ReplicationInfoV2LocalCapabilityRefresh = {
     receiverTransportSession: bigint;
@@ -67,6 +103,8 @@ export type ReplicationInfoV2ReceiveDeps = {
     getSelfKey: () => PublicSignKey;
     getReceiverTransportSession: () => bigint;
     isClosed: () => boolean;
+    isPeerSessionCurrent: (peerHash: string, peerSession: object) => boolean;
+    isReceiveEpochCurrent: (peerHash: string, receiveEpoch: object | null) => boolean;
     isPeerStateCurrent: (peerHash: string, peerSession: object, receiveEpoch: object | null) => boolean;
     isSenderTransportSessionCurrent: (peerHash: string, senderTransportSession: bigint) => boolean;
     sendRequest: (request: RequestReplicationInfoV2Message, target: PublicSignKey, signal: AbortSignal) => Promise<void>;
@@ -78,6 +116,7 @@ export type ReplicationInfoV2ReceiveDeps = {
         signal: AbortSignal;
     }) => Promise<ReplicationInfoV2LocalCapabilityRefresh | undefined>;
     onRequestError?: (error: unknown) => void;
+    onLocalCapabilityError?: (error: unknown) => void;
     now?: () => number;
     requestRetryMs?: number;
     maxRequestRetryMs?: number;
@@ -94,6 +133,8 @@ export declare class ReplicationInfoV2ReceiveCoordinator {
     _receiveStates: Map<string, ReplicationInfoV2ReceiveState>;
     _cutoverPeerSessions: WeakSet<object>;
     _localCapabilityReadyBySession: WeakMap<object, LocalCapabilityReady>;
+    _localCapabilityContextBySession: WeakMap<object, ReplicationInfoV2LocalCapabilityContext>;
+    _localCapabilityAdvertisementsByPeer: Map<string, ReplicationInfoV2LocalCapabilityAdvertisement>;
     _reservedAdmissionsByPeer: Map<string, ReplicationInfoV2ReceiveAdmission>;
     private readonly now;
     private readonly requestRetryMs;
@@ -107,14 +148,42 @@ export declare class ReplicationInfoV2ReceiveCoordinator {
     /** Revoke an unauthenticated or downgraded capability generation. */
     revokePeerCapability(peerHash: string, reopenLegacy?: boolean): void;
     private clearState;
-    /** Record success of this session's ACKed local APPLY advertisement. */
-    markLocalCapabilityReady(properties: {
+    private clearLocalCapabilityAdvertisement;
+    private isLocalCapabilityAdvertisementOwnerCurrent;
+    private isLocalCapabilityAdvertisementGenerationCurrent;
+    private isLocalCapabilityAdvertisementReadyOpen;
+    private localCapabilityRetryDelay;
+    private armLocalCapabilityAdvertisement;
+    private runLocalCapabilityAdvertisement;
+    /**
+     * Start local authenticated-apply advertisement independently of the legacy
+     * join path. ACK and legacy publication are a two-phase barrier: the first
+     * attempt always settles independently, while readiness is promoted only
+     * after the host releases the legacy barrier. Failed attempts leave one
+     * exact-session worker retrying with capped exponential backoff.
+     */
+    advertiseLocalCapability(properties: {
+        target: PublicSignKey;
+        peerSession: object;
+        receiveEpoch: object | null;
+        signal: AbortSignal;
+    }): ReplicationInfoV2LocalCapabilityAdvertisementHandle;
+    private releaseLocalCapabilityLegacyBarrier;
+    private promoteLocalCapabilityAdvertisement;
+    /**
+     * Re-advertise one exact current recovery epoch from the stable membership
+     * context captured during opening. The opening handle owns barrier release;
+     * recovery never bypasses a legacy snapshot or role publication still in
+     * progress.
+     */
+    reAdvertiseLocalCapabilityForRecovery(properties: {
         peerHash: string;
         peerSession: object;
         receiveEpoch: object | null;
-        receiverTransportSession: bigint;
-        requestNotBeforeMs: number;
     }): boolean;
+    /** Record success of this session's ACKed local APPLY advertisement. */
+    markLocalCapabilityReady(properties: LocalCapabilityReadyProperties): boolean;
+    private recordLocalCapabilityReady;
     /**
      * Promote one signed capability generation after the opening barrier has
      * committed. Repeated same-session advertisements refresh freshness only;

package/dist/src/replication-info-v2-receive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replication-info-v2-receive.d.ts","sourceRoot":"","sources":["../../src/replication-info-v2-receive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replication-info-v2-receive.d.ts","sourceRoot":"","sources":["../../src/replication-info-v2-receive.ts"],"names":[],"mappings":"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"}

package/dist/src/replication-info-v2-receive.js

@@ -10,6 +10,7 @@ const DEFAULT_MAX_REQUEST_RETRY_MS = 30_000;
 const DEFAULT_REQUEST_MAX_ATTEMPTS = 7;
 const DEFAULT_LEGACY_FALLBACK_DELAY_MS = 5_000;
 const MAX_U64 = (1n << 64n) - 1n;
+const MAX_BACKOFF_EXPONENT = 20;
 const bytesEqual = (left, right) => {
     if (left.byteLength !== right.byteLength) {
         return false;
@@ -41,6 +42,8 @@ export class ReplicationInfoV2ReceiveCoordinator {
     _receiveStates;
     _cutoverPeerSessions;
     _localCapabilityReadyBySession;
+    _localCapabilityContextBySession;
+    _localCapabilityAdvertisementsByPeer;
     _reservedAdmissionsByPeer;
     now;
     requestRetryMs;
@@ -57,6 +60,8 @@ export class ReplicationInfoV2ReceiveCoordinator {
         this._receiveStates = new Map();
         this._cutoverPeerSessions = new WeakSet();
         this._localCapabilityReadyBySession = new WeakMap();
+        this._localCapabilityContextBySession = new WeakMap();
+        this._localCapabilityAdvertisementsByPeer = new Map();
         this._reservedAdmissionsByPeer = new Map();
     }
     resetForOpen() {
@@ -64,25 +69,41 @@ export class ReplicationInfoV2ReceiveCoordinator {
         this._receiveStates = new Map();
         this._cutoverPeerSessions = new WeakSet();
         this._localCapabilityReadyBySession = new WeakMap();
+        this._localCapabilityContextBySession = new WeakMap();
+        this._localCapabilityAdvertisementsByPeer = new Map();
         this._reservedAdmissionsByPeer = new Map();
     }
     clearForClose() {
+        for (const advertisement of [
+            ...(this._localCapabilityAdvertisementsByPeer?.values() ?? []),
+        ]) {
+            this.clearLocalCapabilityAdvertisement(advertisement);
+        }
+        this._localCapabilityAdvertisementsByPeer?.clear();
         for (const state of this._receiveStates?.values() ?? []) {
             this.clearState(state);
         }
         this._receiveStates?.clear();
         this._cutoverPeerSessions = new WeakSet();
         this._localCapabilityReadyBySession = new WeakMap();
+        this._localCapabilityContextBySession = new WeakMap();
     }
     clearPeer(peerHash, expectedSession) {
+        const advertisement = this._localCapabilityAdvertisementsByPeer.get(peerHash);
+        if (advertisement &&
+            (!expectedSession || advertisement.peerSession === expectedSession)) {
+            this.clearLocalCapabilityAdvertisement(advertisement);
+        }
         const state = this._receiveStates.get(peerHash);
         if (state && (!expectedSession || state.peerSession === expectedSession)) {
             this.clearState(state);
             this._localCapabilityReadyBySession.delete(state.peerSession);
+            this._localCapabilityContextBySession.delete(state.peerSession);
             this._cutoverPeerSessions.delete(state.peerSession);
         }
         if (expectedSession) {
             this._localCapabilityReadyBySession.delete(expectedSession);
+            this._localCapabilityContextBySession.delete(expectedSession);
             this._cutoverPeerSessions.delete(expectedSession);
         }
     }
@@ -112,8 +133,345 @@ export class ReplicationInfoV2ReceiveCoordinator {
             this._receiveStates.delete(state.peerHash);
         }
     }
+    clearLocalCapabilityAdvertisement(state, options) {
+        if (state.timer) {
+            clearTimeout(state.timer);
+            state.timer = undefined;
+        }
+        state.lifecycleSignal.removeEventListener("abort", state.onLifecycleAbort);
+        state.controller.abort();
+        const wasMapped = this._localCapabilityAdvertisementsByPeer.get(state.peerHash) === state;
+        if (wasMapped) {
+            this._localCapabilityAdvertisementsByPeer.delete(state.peerHash);
+        }
+        const ready = this._localCapabilityReadyBySession.get(state.peerSession);
+        if (ready?.advertisement === state) {
+            this._localCapabilityReadyBySession.delete(state.peerSession);
+        }
+        if (wasMapped &&
+            !options?.preserveContext &&
+            this._localCapabilityContextBySession.get(state.peerSession) ===
+                state.context) {
+            this._localCapabilityContextBySession.delete(state.peerSession);
+        }
+    }
+    isLocalCapabilityAdvertisementOwnerCurrent(state) {
+        return (this._localCapabilityAdvertisementsByPeer.get(state.peerHash) === state &&
+            this._localCapabilityContextBySession.get(state.peerSession) ===
+                state.context &&
+            state.context.peerHash === state.peerHash &&
+            state.context.lifecycleSignal === state.lifecycleSignal &&
+            state.context.target.equals(state.target) &&
+            !state.controller.signal.aborted &&
+            !state.lifecycleSignal.aborted &&
+            !this.deps.isClosed() &&
+            this.deps.isPeerSessionCurrent(state.peerHash, state.peerSession) &&
+            (state.receiverTransportSession === undefined ||
+                this.deps.getReceiverTransportSession() ===
+                    state.receiverTransportSession));
+    }
+    isLocalCapabilityAdvertisementGenerationCurrent(state) {
+        return (this.isLocalCapabilityAdvertisementOwnerCurrent(state) &&
+            this.deps.isReceiveEpochCurrent(state.peerHash, state.receiveEpoch));
+    }
+    isLocalCapabilityAdvertisementReadyOpen(state) {
+        return (this.isLocalCapabilityAdvertisementGenerationCurrent(state) &&
+            this.deps.isPeerStateCurrent(state.peerHash, state.peerSession, state.receiveEpoch));
+    }
+    localCapabilityRetryDelay(state) {
+        const exponent = Math.max(0, state.attempts - 1);
+        return Math.min(this.maxRequestRetryMs, this.requestRetryMs * 2 ** Math.min(exponent, MAX_BACKOFF_EXPONENT));
+    }
+    armLocalCapabilityAdvertisement(state) {
+        if (state.timer || state.inFlight || state.ready) {
+            return;
+        }
+        if (state.acknowledgedReady && !state.context.legacyBarrierReleased) {
+            return;
+        }
+        if (!this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+            this.clearLocalCapabilityAdvertisement(state);
+            return;
+        }
+        if (!this.isLocalCapabilityAdvertisementGenerationCurrent(state)) {
+            return;
+        }
+        state.timer = setTimeout(() => {
+            state.timer = undefined;
+            if (!this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+                this.clearLocalCapabilityAdvertisement(state);
+                return;
+            }
+            if (!this.isLocalCapabilityAdvertisementGenerationCurrent(state)) {
+                return;
+            }
+            if (!this.isLocalCapabilityAdvertisementReadyOpen(state)) {
+                this.armLocalCapabilityAdvertisement(state);
+                return;
+            }
+            void this.runLocalCapabilityAdvertisement(state);
+        }, this.localCapabilityRetryDelay(state));
+        state.timer.unref?.();
+    }
+    async runLocalCapabilityAdvertisement(state) {
+        if (state.inFlight) {
+            await state.inFlight;
+            return;
+        }
+        if (state.ready) {
+            return;
+        }
+        if (!this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+            this.clearLocalCapabilityAdvertisement(state);
+            return;
+        }
+        if (!this.isLocalCapabilityAdvertisementGenerationCurrent(state)) {
+            return;
+        }
+        if (state.acknowledgedReady) {
+            if (state.context.legacyBarrierReleased) {
+                this.promoteLocalCapabilityAdvertisement(state);
+            }
+            return;
+        }
+        if (!this.isLocalCapabilityAdvertisementReadyOpen(state)) {
+            this.armLocalCapabilityAdvertisement(state);
+            return;
+        }
+        state.attempts = Math.min(state.attempts + 1, MAX_BACKOFF_EXPONENT + 1);
+        let operation;
+        operation = (async () => {
+            const refreshed = await this.deps.refreshLocalCapability({
+                peerHash: state.peerHash,
+                target: state.target,
+                peerSession: state.peerSession,
+                receiveEpoch: state.receiveEpoch,
+                signal: AbortSignal.any([
+                    state.controller.signal,
+                    state.lifecycleSignal,
+                ]),
+            });
+            if (!refreshed ||
+                !this.isLocalCapabilityAdvertisementGenerationCurrent(state) ||
+                this.deps.getReceiverTransportSession() !==
+                    refreshed.receiverTransportSession) {
+                return;
+            }
+            state.receiverTransportSession = refreshed.receiverTransportSession;
+            state.acknowledgedReady = {
+                peerHash: state.peerHash,
+                receiveEpoch: state.receiveEpoch,
+                receiverTransportSession: refreshed.receiverTransportSession,
+                requestNotBeforeMs: refreshed.requestNotBeforeMs,
+                advertisement: state,
+            };
+            state.attempts = 0;
+            this.promoteLocalCapabilityAdvertisement(state);
+        })()
+            .catch((error) => {
+            if (!state.controller.signal.aborted &&
+                !state.lifecycleSignal.aborted &&
+                !this.deps.isClosed()) {
+                this.deps.onLocalCapabilityError?.(error);
+            }
+        })
+            .finally(() => {
+            if (state.inFlight === operation) {
+                state.inFlight = undefined;
+            }
+            if (!this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+                this.clearLocalCapabilityAdvertisement(state);
+            }
+            else if (this.isLocalCapabilityAdvertisementGenerationCurrent(state) &&
+                !state.ready) {
+                if (!state.acknowledgedReady || state.context.legacyBarrierReleased) {
+                    this.armLocalCapabilityAdvertisement(state);
+                }
+            }
+        });
+        state.inFlight = operation;
+        await operation;
+    }
+    /**
+     * Start local authenticated-apply advertisement independently of the legacy
+     * join path. ACK and legacy publication are a two-phase barrier: the first
+     * attempt always settles independently, while readiness is promoted only
+     * after the host releases the legacy barrier. Failed attempts leave one
+     * exact-session worker retrying with capped exponential backoff.
+     */
+    advertiseLocalCapability(properties) {
+        const peerHash = properties.target.hashcode();
+        if (properties.signal.aborted ||
+            this.deps.isClosed() ||
+            !this.deps.isPeerSessionCurrent(peerHash, properties.peerSession) ||
+            !this.deps.isReceiveEpochCurrent(peerHash, properties.receiveEpoch)) {
+            return {
+                firstAttempt: Promise.resolve(),
+                releaseLegacyBarrier: () => { },
+            };
+        }
+        let context = this._localCapabilityContextBySession.get(properties.peerSession);
+        if (context &&
+            (context.peerHash !== peerHash ||
+                !context.target.equals(properties.target) ||
+                context.lifecycleSignal !== properties.signal)) {
+            return {
+                firstAttempt: Promise.resolve(),
+                releaseLegacyBarrier: () => { },
+            };
+        }
+        if (!context) {
+            context = {
+                peerHash,
+                target: properties.target,
+                lifecycleSignal: properties.signal,
+                legacyBarrierReleased: false,
+            };
+            this._localCapabilityContextBySession.set(properties.peerSession, context);
+        }
+        let state = this._localCapabilityAdvertisementsByPeer.get(peerHash);
+        if (state &&
+            (state.peerSession !== properties.peerSession ||
+                state.context !== context ||
+                state.lifecycleSignal !== properties.signal ||
+                !state.target.equals(properties.target))) {
+            this.clearLocalCapabilityAdvertisement(state);
+            state = undefined;
+        }
+        if (state && state.receiveEpoch !== properties.receiveEpoch) {
+            this.clearLocalCapabilityAdvertisement(state, { preserveContext: true });
+            state = undefined;
+        }
+        if (state && !this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+            this.clearLocalCapabilityAdvertisement(state);
+            state = undefined;
+        }
+        if (this._localCapabilityContextBySession.get(properties.peerSession) !==
+            context) {
+            return {
+                firstAttempt: Promise.resolve(),
+                releaseLegacyBarrier: () => { },
+            };
+        }
+        if (!state) {
+            const controller = new AbortController();
+            const advertisement = {
+                peerHash,
+                target: properties.target,
+                peerSession: properties.peerSession,
+                receiveEpoch: properties.receiveEpoch,
+                lifecycleSignal: properties.signal,
+                onLifecycleAbort: () => { },
+                controller,
+                context,
+                attempts: 0,
+                ready: false,
+                receiverTransportSession: this.deps.getReceiverTransportSession(),
+            };
+            advertisement.onLifecycleAbort = () => this.clearLocalCapabilityAdvertisement(advertisement);
+            properties.signal.addEventListener("abort", advertisement.onLifecycleAbort, {
+                once: true,
+            });
+            this._localCapabilityAdvertisementsByPeer.set(peerHash, advertisement);
+            state = advertisement;
+        }
+        const firstAttempt = state.firstAttempt ??
+            (state.firstAttempt = this.runLocalCapabilityAdvertisement(state));
+        const advertisement = state;
+        return {
+            firstAttempt,
+            releaseLegacyBarrier: () => this.releaseLocalCapabilityLegacyBarrier(advertisement.peerSession, context),
+        };
+    }
+    releaseLocalCapabilityLegacyBarrier(peerSession, context) {
+        if (context.legacyBarrierReleased) {
+            return;
+        }
+        if (this._localCapabilityContextBySession.get(peerSession) !== context ||
+            context.lifecycleSignal.aborted ||
+            this.deps.isClosed() ||
+            !this.deps.isPeerSessionCurrent(context.peerHash, peerSession)) {
+            return;
+        }
+        context.legacyBarrierReleased = true;
+        const state = this._localCapabilityAdvertisementsByPeer.get(context.peerHash);
+        if (state?.peerSession === peerSession && state.context === context) {
+            if (!this.isLocalCapabilityAdvertisementOwnerCurrent(state)) {
+                this.clearLocalCapabilityAdvertisement(state);
+                return;
+            }
+            this.promoteLocalCapabilityAdvertisement(state);
+        }
+    }
+    promoteLocalCapabilityAdvertisement(state) {
+        const ready = state.acknowledgedReady;
+        if (state.ready ||
+            !state.context.legacyBarrierReleased ||
+            !ready ||
+            ready.receiveEpoch !== state.receiveEpoch ||
+            ready.advertisement !== state ||
+            !this.isLocalCapabilityAdvertisementOwnerCurrent(state) ||
+            !this.isLocalCapabilityAdvertisementGenerationCurrent(state) ||
+            this.deps.getReceiverTransportSession() !== ready.receiverTransportSession) {
+            return state.ready;
+        }
+        if (!this.isLocalCapabilityAdvertisementReadyOpen(state)) {
+            this.armLocalCapabilityAdvertisement(state);
+            return false;
+        }
+        if (!this.recordLocalCapabilityReady({
+            peerHash: state.peerHash,
+            peerSession: state.peerSession,
+            receiveEpoch: state.receiveEpoch,
+            receiverTransportSession: ready.receiverTransportSession,
+            requestNotBeforeMs: ready.requestNotBeforeMs,
+        }, state)) {
+            return false;
+        }
+        state.ready = true;
+        return true;
+    }
+    /**
+     * Re-advertise one exact current recovery epoch from the stable membership
+     * context captured during opening. The opening handle owns barrier release;
+     * recovery never bypasses a legacy snapshot or role publication still in
+     * progress.
+     */
+    reAdvertiseLocalCapabilityForRecovery(properties) {
+        const context = this._localCapabilityContextBySession.get(properties.peerSession);
+        if (!context ||
+            context.peerHash !== properties.peerHash ||
+            context.lifecycleSignal.aborted ||
+            this.deps.isClosed() ||
+            !this.deps.isPeerSessionCurrent(properties.peerHash, properties.peerSession) ||
+            !this.deps.isReceiveEpochCurrent(properties.peerHash, properties.receiveEpoch)) {
+            return false;
+        }
+        const state = this._receiveStates.get(properties.peerHash);
+        if (state?.peerSession === properties.peerSession &&
+            state.receiveEpoch === properties.receiveEpoch &&
+            state.receiverBinding !== undefined) {
+            return false;
+        }
+        const ready = this._localCapabilityReadyBySession.get(properties.peerSession);
+        if (ready?.peerHash === properties.peerHash &&
+            ready.receiveEpoch === properties.receiveEpoch &&
+            ready.receiverTransportSession === this.deps.getReceiverTransportSession()) {
+            return false;
+        }
+        this.advertiseLocalCapability({
+            target: context.target,
+            peerSession: properties.peerSession,
+            receiveEpoch: properties.receiveEpoch,
+            signal: context.lifecycleSignal,
+        });
+        return true;
+    }
     /** Record success of this session's ACKed local APPLY advertisement. */
     markLocalCapabilityReady(properties) {
+        return this.recordLocalCapabilityReady(properties);
+    }
+    recordLocalCapabilityReady(properties, advertisement) {
         const { peerHash, peerSession, receiverTransportSession } = properties;
         const state = this._receiveStates.get(peerHash);
         if (this.deps.isClosed() ||
@@ -123,8 +481,10 @@ export class ReplicationInfoV2ReceiveCoordinator {
         }
         const ready = {
             peerHash,
+            receiveEpoch: properties.receiveEpoch,
             receiverTransportSession,
             requestNotBeforeMs: properties.requestNotBeforeMs,
+            advertisement,
         };
         this._localCapabilityReadyBySession.set(peerSession, ready);
         if (state?.peerSession === peerSession &&
@@ -198,7 +558,9 @@ export class ReplicationInfoV2ReceiveCoordinator {
                 });
             }
             const ready = this._localCapabilityReadyBySession.get(peerSession);
-            if (ready?.peerHash === peerHash && state.receiverBinding === undefined) {
+            if (ready?.peerHash === peerHash &&
+                ready.receiveEpoch === receiveEpoch &&
+                state.receiverBinding === undefined) {
                 this.bindLocalCapability(state, ready);
             }
             if (state.phase !== "active") {
@@ -231,7 +593,7 @@ export class ReplicationInfoV2ReceiveCoordinator {
         };
         this._receiveStates.set(peerHash, state);
         const ready = this._localCapabilityReadyBySession.get(peerSession);
-        if (ready?.peerHash === peerHash) {
+        if (ready?.peerHash === peerHash && ready.receiveEpoch === receiveEpoch) {
             this.bindLocalCapability(state, ready);
             this.armRequest(state, 0);
         }
@@ -629,6 +991,7 @@ export class ReplicationInfoV2ReceiveCoordinator {
         }
         const ready = {
             peerHash: state.peerHash,
+            receiveEpoch: state.receiveEpoch,
             receiverTransportSession: refreshed.receiverTransportSession,
             requestNotBeforeMs: refreshed.requestNotBeforeMs,
         };
@@ -673,6 +1036,7 @@ export class ReplicationInfoV2ReceiveCoordinator {
             const ready = this._localCapabilityReadyBySession.get(state.peerSession);
             if (!ready ||
                 ready.peerHash !== state.peerHash ||
+                ready.receiveEpoch !== state.receiveEpoch ||
                 ready.receiverTransportSession !== state.receiverTransportSession) {
                 return;
             }