@peerbit/pubsub 5.3.9 → 5.3.11

package/dist/src/index.d.ts

@@ -4,7 +4,7 @@ import { type PubSub, type PubSubEvents, SubscriptionData } from "@peerbit/pubsu
 import { DirectStream, type DirectStreamComponents, type DirectStreamOptions, type PeerStreams } from "@peerbit/stream";
 import { AcknowledgeDelivery, DataMessage, type ExpiresAtOptions, type IdOptions, type PriorityOptions, type ResponsePriorityOptions, type RouteHint, SilentDelivery, type WithExtraSigners } from "@peerbit/stream-interface";
 import type { FanoutTree, FanoutTreeChannelOptions, FanoutTreeJoinOptions } from "./fanout-tree.js";
-import { TopicRootControlPlane } from "./topic-root-control-plane.js";
+import { TopicRootControlPlane, type TopicRootResolutionOptions } from "./topic-root-control-plane.js";
 export * from "./fanout-tree.js";
 export * as fanoutWire from "./fanout-tree-codec.js";
 export * as fanoutParentUpgrade from "./fanout-tree-parent-upgrade.js";
@@ -153,10 +153,15 @@ export declare class TopicControlPlane extends DirectStream<PubSubEvents> implem
     private readonly fanoutPublishMaxEphemeralChannels;
     private autoTopicRootCandidates;
     private autoTopicRootCandidateSet?;
+    private pendingAutoTopicRootCandidates?;
+    private autoTopicRootCandidateUpdateTimer?;
     private reconcileShardOverlaysInFlight?;
     private reconcileShardOverlaysDirty;
     private topicControlPlaneStopping;
     private topicControlPlaneLifecycleRevision;
+    private topicRootResolutionAbortController;
+    private topicRootCandidateResolutionGeneration?;
+    private topicRootCandidateResolutionAbortController;
     private hostOwnedShardRootsInFlight?;
     private hostOwnedShardRootsDirty;
     private autoCandidatesBroadcastTimers;
@@ -194,6 +199,11 @@ export declare class TopicControlPlane extends DirectStream<PubSubEvents> implem
     private ensureAutoCandidatesGossipInterval;
     private sendAutoTopicRootCandidates;
     private mergeAutoTopicRootCandidatesFromPeer;
+    private queueAutoTopicRootCandidateUpdate;
+    private applyAutoTopicRootCandidates;
+    private scheduleAutoTopicRootCandidateUpdateCooldown;
+    private flushPendingAutoTopicRootCandidateUpdate;
+    private clearAutoTopicRootCandidateUpdateSchedule;
     private scheduleHostOwnedShardRoots;
     private scheduleReconcileShardOverlays;
     private reconcileShardOverlays;
@@ -221,9 +231,11 @@ export declare class TopicControlPlane extends DirectStream<PubSubEvents> implem
     private decodePubSubMessage;
     private getTopicRootCandidateGeneration;
     private assertTopicControlPlaneActive;
+    private syncTopicRootCandidateResolutionSignal;
+    private withTopicRootCandidateResolution;
     private normalizePeerTopicRootState;
     private resolveTopicRootState;
-    resolveTopicRoot(topic: string): Promise<string | undefined>;
+    resolveTopicRoot(topic: string, options?: TopicRootResolutionOptions): Promise<string | undefined>;
     private resolveShardRootState;
     private getConnectedTopicRootTrackers;
     private nextTopicRootRequestIdValue;
@@ -236,7 +248,7 @@ export declare class TopicControlPlane extends DirectStream<PubSubEvents> implem
     private ensureFanoutChannel;
     private ensureFanoutChannelOnce;
     private closeFanoutChannel;
-    hostShardRootsNow(): Promise<void>;
+    hostShardRootsNow(options?: TopicRootResolutionOptions): Promise<void>;
     subscribe(topic: string): Promise<void>;
     private _subscribe;
     unsubscribe(topic: string, options?: {

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -9,7 +9,7 @@ import { Uint8ArrayList } from "uint8arraylist";
 import { toUint8Array } from "./bytes.js";
 import { debouncedAccumulatorSetCounter, } from "./debounced-set.js";
 import { FanoutChannel } from "./fanout-channel.js";
-import { TopicRootControlPlane } from "./topic-root-control-plane.js";
+import { TopicRootControlPlane, } from "./topic-root-control-plane.js";
 export * from "./fanout-tree.js";
 // The complete /peerbit/fanout-tree/0.5.0 wire codec and the
 // parent-upgrade decision module (the TS references the native rust-core
@@ -43,6 +43,7 @@ const withAbort = async (promise, signal) => {
     if (!signal)
         return promise;
     if (signal.aborted) {
+        void promise.catch(() => { });
         throw signal.reason ?? new AbortError("Operation was aborted");
     }
     return new Promise((resolve, reject) => {
@@ -68,6 +69,41 @@ const withAbort = async (promise, signal) => {
         });
     });
 };
+const throwIfAborted = (signal) => {
+    if (signal?.aborted) {
+        throw signal.reason ?? new AbortError("Operation was aborted");
+    }
+};
+const linkAbortSignals = (signals) => {
+    const unique = [...new Set(signals.filter((signal) => signal !== undefined))];
+    if (unique.length === 1) {
+        return { signal: unique[0], clear: () => { } };
+    }
+    const controller = new AbortController();
+    const listeners = new Map();
+    const clear = () => {
+        for (const [signal, listener] of listeners) {
+            signal.removeEventListener("abort", listener);
+        }
+        listeners.clear();
+    };
+    const abortFrom = (signal) => {
+        clear();
+        controller.abort(signal.reason ?? new AbortError("Topic-root resolution aborted"));
+    };
+    const aborted = unique.find((signal) => signal.aborted);
+    if (aborted) {
+        abortFrom(aborted);
+    }
+    else {
+        for (const signal of unique) {
+            const listener = () => abortFrom(signal);
+            listeners.set(signal, listener);
+            signal.addEventListener("abort", listener, { once: true });
+        }
+    }
+    return { signal: controller.signal, clear };
+};
 const SUBSCRIBER_CACHE_MAX_ENTRIES_HARD_CAP = 100_000;
 const SUBSCRIBER_CACHE_DEFAULT_MAX_ENTRIES = 4_096;
 const DEFAULT_FANOUT_PUBLISH_IDLE_CLOSE_MS = 60_000;
@@ -75,6 +111,7 @@ const DEFAULT_FANOUT_PUBLISH_MAX_EPHEMERAL_CHANNELS = 64;
 const DEFAULT_PUBSUB_SHARD_COUNT = 256;
 const PUBSUB_SHARD_COUNT_HARD_CAP = 16_384;
 const DEFAULT_PUBSUB_SHARD_TOPIC_PREFIX = "/peerbit/pubsub-shard/1/";
+const AUTO_TOPIC_ROOT_CANDIDATE_UPDATE_COOLDOWN_MS = 2_000;
 const sameCandidates = (left, right) => left.length === right.length &&
     left.every((candidate, index) => candidate === right[index]);
 // Topic-root queries may need to wait for the responder to finish opening an
@@ -148,10 +185,15 @@ export class TopicControlPlane extends DirectStream {
     // This keeps small ad-hoc networks working without explicit bootstraps.
     autoTopicRootCandidates = false;
     autoTopicRootCandidateSet;
+    pendingAutoTopicRootCandidates;
+    autoTopicRootCandidateUpdateTimer;
     reconcileShardOverlaysInFlight;
     reconcileShardOverlaysDirty = false;
     topicControlPlaneStopping = false;
     topicControlPlaneLifecycleRevision = 0;
+    topicRootResolutionAbortController = new AbortController();
+    topicRootCandidateResolutionGeneration;
+    topicRootCandidateResolutionAbortController = new AbortController();
     hostOwnedShardRootsInFlight;
     hostOwnedShardRootsDirty = false;
     autoCandidatesBroadcastTimers = [];
@@ -250,6 +292,7 @@ export class TopicControlPlane extends DirectStream {
         // Disable auto mode and stop its background gossip/timers.
         this.autoTopicRootCandidates = false;
         this.autoTopicRootCandidateSet = undefined;
+        this.clearAutoTopicRootCandidateUpdateSchedule();
         for (const t of this.autoCandidatesBroadcastTimers)
             clearTimeout(t);
         this.autoCandidatesBroadcastTimers = [];
@@ -269,6 +312,9 @@ export class TopicControlPlane extends DirectStream {
     }
     async start() {
         this.topicControlPlaneStopping = false;
+        if (this.topicRootResolutionAbortController.signal.aborted) {
+            this.topicRootResolutionAbortController = new AbortController();
+        }
         await this.fanout.start();
         this._onFanoutPeerUnreachable =
             this._onFanoutPeerUnreachable ||
@@ -287,6 +333,8 @@ export class TopicControlPlane extends DirectStream {
     }
     async stop() {
         this.topicControlPlaneStopping = true;
+        this.topicRootResolutionAbortController.abort(new AbortError("topic control plane stopped"));
+        this.clearAutoTopicRootCandidateUpdateSchedule();
         this.topicControlPlaneLifecycleRevision += 1;
         this.reconcileShardOverlaysDirty = false;
         for (const opening of this.ensureFanoutChannelInFlight.values()) {
@@ -398,6 +446,7 @@ export class TopicControlPlane extends DirectStream {
         // intact and reconcile shard overlays under the new mapping.
         this.autoTopicRootCandidates = false;
         this.autoTopicRootCandidateSet = undefined;
+        this.clearAutoTopicRootCandidateUpdateSchedule();
         this.shardRootCache.clear();
         // Ensure we host any shard roots we're now responsible for. This is important
         // in tests where candidates may be configured before protocol streams have
@@ -413,29 +462,7 @@ export class TopicControlPlane extends DirectStream {
         if (!isCanonicalTopicRootCandidate(peerHash) ||
             peerHash === this.publicKeyHash)
             return;
-        if (this.maybeDisableAutoTopicRootCandidatesIfExternallyConfigured())
-            return;
-        const current = this.topicRootControlPlane.getTopicRootCandidates();
-        const managed = this.autoTopicRootCandidateSet;
-        if (current.includes(peerHash))
-            return;
-        managed?.add(peerHash);
-        const next = this.normalizeAutoTopicRootCandidates(managed ? [...managed] : [...current, peerHash]);
-        this.autoTopicRootCandidateSet = new Set(next);
-        if (sameCandidates(current, next))
-            return;
-        this.topicRootControlPlane.setTopicRootCandidates(next);
-        this.shardRootCache.clear();
-        this.scheduleReconcileShardOverlays();
-        // In auto-candidate mode, shard roots are selected deterministically across
-        // *all* connected peers (not just those currently subscribed to a shard).
-        // That means a peer can be selected as root for shards it isn't using yet.
-        // Ensure we proactively host the shard roots we're responsible for so other
-        // peers can join without timing out in small ad-hoc networks.
-        this.scheduleHostOwnedShardRoots();
-        // Share the updated candidate set so other peers converge on the same
-        // deterministic mapping even in partially connected topologies.
-        this.scheduleAutoTopicRootCandidatesBroadcast();
+        this.queueAutoTopicRootCandidateUpdate([peerHash]);
     }
     normalizeAutoTopicRootCandidates(candidates) {
         const canonicalCandidates = candidates.filter(isCanonicalTopicRootCandidate);
@@ -520,27 +547,78 @@ export class TopicControlPlane extends DirectStream {
     mergeAutoTopicRootCandidatesFromPeer(candidates) {
         if (!this.autoTopicRootCandidates)
             return false;
+        return this.queueAutoTopicRootCandidateUpdate(candidates);
+    }
+    queueAutoTopicRootCandidateUpdate(candidates) {
+        if (!this.autoTopicRootCandidates ||
+            this.stopping ||
+            this.topicControlPlaneStopping)
+            return false;
         if (this.maybeDisableAutoTopicRootCandidatesIfExternallyConfigured())
             return false;
         const managed = this.autoTopicRootCandidateSet;
         if (!managed)
             return false;
-        const before = this.topicRootControlPlane.getTopicRootCandidates();
-        for (const c of candidates) {
-            if (!isCanonicalTopicRootCandidate(c))
-                continue;
-            managed.add(c);
-        }
-        const next = this.normalizeAutoTopicRootCandidates([...managed]);
-        this.autoTopicRootCandidateSet = new Set(next);
+        const before = this.pendingAutoTopicRootCandidates ?? [...managed];
+        const next = this.normalizeAutoTopicRootCandidates([
+            ...before,
+            ...candidates,
+        ]);
         if (sameCandidates(before, next))
             return false;
+        if (this.autoTopicRootCandidateUpdateTimer) {
+            this.pendingAutoTopicRootCandidates = next;
+            return true;
+        }
+        this.scheduleAutoTopicRootCandidateUpdateCooldown();
+        this.applyAutoTopicRootCandidates(next);
+        return true;
+    }
+    applyAutoTopicRootCandidates(next) {
+        this.autoTopicRootCandidateSet = new Set(next);
         this.topicRootControlPlane.setTopicRootCandidates(next);
         this.shardRootCache.clear();
         this.scheduleReconcileShardOverlays();
         this.scheduleHostOwnedShardRoots();
         this.scheduleAutoTopicRootCandidatesBroadcast();
-        return true;
+    }
+    scheduleAutoTopicRootCandidateUpdateCooldown() {
+        if (this.autoTopicRootCandidateUpdateTimer)
+            return;
+        const timer = setTimeout(() => {
+            if (this.autoTopicRootCandidateUpdateTimer !== timer)
+                return;
+            this.flushPendingAutoTopicRootCandidateUpdate();
+        }, AUTO_TOPIC_ROOT_CANDIDATE_UPDATE_COOLDOWN_MS);
+        timer.unref?.();
+        this.autoTopicRootCandidateUpdateTimer = timer;
+    }
+    flushPendingAutoTopicRootCandidateUpdate() {
+        if (this.autoTopicRootCandidateUpdateTimer) {
+            clearTimeout(this.autoTopicRootCandidateUpdateTimer);
+            this.autoTopicRootCandidateUpdateTimer = undefined;
+        }
+        const next = this.pendingAutoTopicRootCandidates;
+        this.pendingAutoTopicRootCandidates = undefined;
+        if (!next)
+            return;
+        if (!this.autoTopicRootCandidates ||
+            this.stopping ||
+            this.topicControlPlaneStopping)
+            return;
+        if (this.maybeDisableAutoTopicRootCandidatesIfExternallyConfigured())
+            return;
+        // The trailing update starts its own fixed window so another inbound update
+        // cannot create a second candidate generation immediately afterwards.
+        this.scheduleAutoTopicRootCandidateUpdateCooldown();
+        this.applyAutoTopicRootCandidates(next);
+    }
+    clearAutoTopicRootCandidateUpdateSchedule() {
+        if (this.autoTopicRootCandidateUpdateTimer) {
+            clearTimeout(this.autoTopicRootCandidateUpdateTimer);
+            this.autoTopicRootCandidateUpdateTimer = undefined;
+        }
+        this.pendingAutoTopicRootCandidates = undefined;
     }
     scheduleHostOwnedShardRoots() {
         this.hostOwnedShardRootsDirty = true;
@@ -574,6 +652,7 @@ export class TopicControlPlane extends DirectStream {
     }
     scheduleReconcileShardOverlays() {
         const candidateGeneration = this.getTopicRootCandidateGeneration();
+        this.syncTopicRootCandidateResolutionSignal(candidateGeneration);
         for (const opening of this.ensureFanoutChannelInFlight.values()) {
             if (opening.candidateGeneration !== candidateGeneration) {
                 opening.abortController.abort(new AbortError("topic root candidates changed"));
@@ -885,6 +964,53 @@ export class TopicControlPlane extends DirectStream {
             throw new NotStartedError();
         }
     }
+    syncTopicRootCandidateResolutionSignal(candidateGeneration = this.getTopicRootCandidateGeneration()) {
+        if (this.topicRootCandidateResolutionGeneration === undefined) {
+            this.topicRootCandidateResolutionGeneration = candidateGeneration;
+        }
+        else if (candidateGeneration !== this.topicRootCandidateResolutionGeneration) {
+            this.topicRootCandidateResolutionAbortController.abort(new AbortError("topic root candidates changed"));
+            this.topicRootCandidateResolutionAbortController = new AbortController();
+            this.topicRootCandidateResolutionGeneration = candidateGeneration;
+        }
+        return this.topicRootCandidateResolutionAbortController.signal;
+    }
+    async withTopicRootCandidateResolution(operation, terminalSignals = []) {
+        for (;;) {
+            for (const signal of terminalSignals)
+                throwIfAborted(signal);
+            const candidateGeneration = this.getTopicRootCandidateGeneration();
+            const candidateSignal = this.syncTopicRootCandidateResolutionSignal(candidateGeneration);
+            const linked = linkAbortSignals([...terminalSignals, candidateSignal]);
+            try {
+                const result = await operation({
+                    candidateGeneration,
+                    signal: linked.signal,
+                });
+                for (const signal of terminalSignals)
+                    throwIfAborted(signal);
+                if (candidateSignal.aborted ||
+                    candidateGeneration !== this.getTopicRootCandidateGeneration()) {
+                    continue;
+                }
+                return result;
+            }
+            catch (error) {
+                for (const signal of terminalSignals) {
+                    if (signal?.aborted)
+                        throw signal.reason ?? error;
+                }
+                if (candidateSignal.aborted ||
+                    candidateGeneration !== this.getTopicRootCandidateGeneration()) {
+                    continue;
+                }
+                throw error;
+            }
+            finally {
+                linked.clear();
+            }
+        }
+    }
     normalizePeerTopicRootState(topic, root) {
         const deterministic = this.topicRootControlPlane.resolveDeterministicTopicRoot(topic);
         if (this.autoTopicRootCandidates &&
@@ -895,12 +1021,13 @@ export class TopicControlPlane extends DirectStream {
         }
         return { root, authoritative: true };
     }
-    async resolveTopicRootState(topic) {
-        const tracked = await this.topicRootControlPlane.resolveTrackedTopicRoot(topic);
+    async resolveTopicRootState(topic, options) {
+        throwIfAborted(options?.signal);
+        const tracked = await this.topicRootControlPlane.resolveTrackedTopicRoot(topic, options);
         if (tracked) {
             return { root: tracked, authoritative: true };
         }
-        const resolvedThroughPeers = await this.resolveTopicRootThroughPeers(topic);
+        const resolvedThroughPeers = await this.resolveTopicRootThroughPeers(topic, options);
         if (resolvedThroughPeers) {
             // Unconfigured peer-query replies cannot override the locally
             // deterministic root for internal shards in auto mode. Roots, resolvers,
@@ -914,8 +1041,8 @@ export class TopicControlPlane extends DirectStream {
             this.autoTopicRootCandidates &&
             this.getConnectedTopicRootTrackers().length > 0) {
             for (let attempt = 0; attempt < 8; attempt++) {
-                await delay(150 * (attempt < 4 ? 1 : 2));
-                const retried = await this.resolveTopicRootThroughPeers(topic);
+                await withAbort(delay(150 * (attempt < 4 ? 1 : 2), options), options?.signal);
+                const retried = await this.resolveTopicRootThroughPeers(topic, options);
                 if (retried) {
                     return this.normalizePeerTopicRootState(topic, retried);
                 }
@@ -926,12 +1053,16 @@ export class TopicControlPlane extends DirectStream {
             authoritative: false,
         };
     }
-    async resolveTopicRoot(topic) {
-        return (await this.resolveTopicRootState(topic)).root;
+    async resolveTopicRoot(topic, options) {
+        const lifecycleSignal = this.started && !this.stopping && !this.topicControlPlaneStopping
+            ? this.topicRootResolutionAbortController.signal
+            : undefined;
+        return this.withTopicRootCandidateResolution(async ({ signal }) => (await this.resolveTopicRootState(topic, { signal })).root, [lifecycleSignal, options?.signal]);
     }
-    async resolveShardRootState(shardTopic) {
+    async resolveShardRootState(shardTopic, options) {
         const lifecycleRevision = this.topicControlPlaneLifecycleRevision;
         for (;;) {
+            throwIfAborted(options?.signal);
             this.assertTopicControlPlaneActive(lifecycleRevision);
             // If someone configured topic-root candidates externally (e.g.
             // TestSession router selection or Peerbit.bootstrap) after this peer
@@ -945,7 +1076,7 @@ export class TopicControlPlane extends DirectStream {
             if (cached && (cached.authoritative || !hasConnectedTrackers)) {
                 return { root: cached.root, candidateGeneration };
             }
-            const resolved = await this.resolveTopicRootState(shardTopic);
+            const resolved = await this.resolveTopicRootState(shardTopic, options);
             this.assertTopicControlPlaneActive(lifecycleRevision);
             if (candidateGeneration !== this.getTopicRootCandidateGeneration()) {
                 continue;
@@ -1005,36 +1136,57 @@ export class TopicControlPlane extends DirectStream {
         pending.resolve(message.root);
         return true;
     }
-    async queryTopicRootFromPeer(peer, topic, timeoutMs = DEFAULT_TOPIC_ROOT_QUERY_TIMEOUT_MS) {
+    async queryTopicRootFromPeer(peer, topic, timeoutMs = DEFAULT_TOPIC_ROOT_QUERY_TIMEOUT_MS, signal) {
+        throwIfAborted(signal);
         if (!this.started || this.stopping)
             return undefined;
         const expectedPeerHash = peer.publicKey.hashcode();
         const requestId = this.nextTopicRootRequestIdValue();
         const responsePromise = new Promise((resolve) => {
-            const timer = setTimeout(() => {
-                this.pendingTopicRootQueries.delete(requestId);
-                resolve(undefined);
-            }, Math.max(1, Math.floor(timeoutMs)));
+            let settled = false;
+            const settle = (root) => {
+                if (settled)
+                    return;
+                settled = true;
+                const pending = this.pendingTopicRootQueries.get(requestId);
+                if (pending?.resolve === settle) {
+                    this.pendingTopicRootQueries.delete(requestId);
+                }
+                clearTimeout(timer);
+                if (signal && onAbort) {
+                    signal.removeEventListener("abort", onAbort);
+                }
+                resolve(root);
+            };
+            const onAbort = signal ? () => settle(undefined) : undefined;
+            const timer = setTimeout(() => settle(undefined), Math.max(1, Math.floor(timeoutMs)));
             timer.unref?.();
             this.pendingTopicRootQueries.set(requestId, {
                 expectedPeerHash,
                 topic,
-                resolve,
+                resolve: settle,
                 timer,
             });
+            if (signal && onAbort) {
+                signal.addEventListener("abort", onAbort, { once: true });
+                if (signal.aborted)
+                    onAbort();
+            }
         });
         try {
-            await this.sendDirectControlMessage(peer, new TopicRootQuery({ requestId, topic }));
+            await withAbort(this.sendDirectControlMessage(peer, new TopicRootQuery({ requestId, topic })), signal);
         }
-        catch {
+        catch (error) {
             const pending = this.pendingTopicRootQueries.get(requestId);
             if (pending) {
                 this.pendingTopicRootQueries.delete(requestId);
                 clearTimeout(pending.timer);
                 pending.resolve(undefined);
             }
+            if (signal?.aborted)
+                throw error;
         }
-        return responsePromise;
+        return withAbort(responsePromise, signal);
     }
     async confirmDirectShardRoot(shardTopic, root, candidateGeneration, lifecycleRevision, signal) {
         this.assertTopicControlPlaneActive(lifecycleRevision);
@@ -1043,7 +1195,7 @@ export class TopicControlPlane extends DirectStream {
         const rootPeer = this.peers.get(root);
         if (!rootPeer)
             return root;
-        const confirmation = await withAbort(this.queryTopicRootFromPeer(rootPeer, shardTopic, DIRECT_SHARD_ROOT_CONFIRM_TIMEOUT_MS), signal);
+        const confirmation = await withAbort(this.queryTopicRootFromPeer(rootPeer, shardTopic, DIRECT_SHARD_ROOT_CONFIRM_TIMEOUT_MS, signal), signal);
         this.assertTopicControlPlaneActive(lifecycleRevision);
         if (candidateGeneration !== this.getTopicRootCandidateGeneration()) {
             return root;
@@ -1064,14 +1216,14 @@ export class TopicControlPlane extends DirectStream {
     }
     async resolveQueryableTopicRoot(topic) {
         const lifecycleRevision = this.topicControlPlaneLifecycleRevision;
-        for (;;) {
+        const lifecycleSignal = this.topicRootResolutionAbortController.signal;
+        return this.withTopicRootCandidateResolution(async ({ candidateGeneration, signal }) => {
+            throwIfAborted(signal);
             this.assertTopicControlPlaneActive(lifecycleRevision);
-            const rootCandidateGeneration = this.getTopicRootCandidateGeneration();
-            const root = await this.topicRootControlPlane.resolveCanonicalTopicRoot(topic);
+            const root = await this.topicRootControlPlane.resolveCanonicalTopicRoot(topic, {
+                signal,
+            });
             this.assertTopicControlPlaneActive(lifecycleRevision);
-            if (rootCandidateGeneration !== this.getTopicRootCandidateGeneration()) {
-                continue;
-            }
             if (root !== this.publicKeyHash) {
                 return root;
             }
@@ -1082,34 +1234,37 @@ export class TopicControlPlane extends DirectStream {
                 await this.ensureFanoutChannel(topic, {
                     pin: true,
                     root,
-                    rootCandidateGeneration,
+                    rootCandidateGeneration: candidateGeneration,
+                    signal,
                 });
                 this.assertTopicControlPlaneActive(lifecycleRevision);
-                if (rootCandidateGeneration !== this.getTopicRootCandidateGeneration()) {
-                    continue;
-                }
                 return root;
             }
             catch (error) {
+                if (signal.aborted ||
+                    candidateGeneration !== this.getTopicRootCandidateGeneration()) {
+                    throw error;
+                }
                 warn(`Failed to host shard root ${topic} before answering root query: ${error instanceof Error ? error.message : String(error)}`);
                 return undefined;
             }
-        }
+        }, [lifecycleSignal]);
     }
-    async resolveTopicRootThroughPeers(topic) {
+    async resolveTopicRootThroughPeers(topic, options) {
+        throwIfAborted(options?.signal);
         const peers = this.getConnectedTopicRootTrackers();
         if (peers.length === 0) {
             return undefined;
         }
         for (let attempt = 0; attempt < 3; attempt++) {
             for (const peer of peers) {
-                const resolved = await this.queryTopicRootFromPeer(peer, topic);
+                const resolved = await this.queryTopicRootFromPeer(peer, topic, DEFAULT_TOPIC_ROOT_QUERY_TIMEOUT_MS, options?.signal);
                 if (resolved) {
                     return resolved;
                 }
             }
             if (attempt < 2) {
-                await delay(150 * (attempt + 1));
+                await withAbort(delay(150 * (attempt + 1), options), options?.signal);
             }
         }
         return undefined;
@@ -1233,7 +1388,9 @@ export class TopicControlPlane extends DirectStream {
         const existing = this.fanoutChannels.get(t);
         if (existing) {
             if (!root) {
-                const resolved = await this.resolveShardRootState(t);
+                const resolved = await this.resolveShardRootState(t, {
+                    signal: options?.signal,
+                });
                 this.assertTopicControlPlaneActive(lifecycleRevision);
                 root = resolved.root;
                 resolvedGeneration = resolved.candidateGeneration;
@@ -1270,7 +1427,9 @@ export class TopicControlPlane extends DirectStream {
             }
         }
         if (!root) {
-            const resolved = await this.resolveShardRootState(t);
+            const resolved = await this.resolveShardRootState(t, {
+                signal: options?.signal,
+            });
             this.assertTopicControlPlaneActive(lifecycleRevision);
             root = resolved.root;
             resolvedGeneration = resolved.candidateGeneration;
@@ -1488,22 +1647,37 @@ export class TopicControlPlane extends DirectStream {
             }
         }
     }
-    async hostShardRootsNow() {
+    async hostShardRootsNow(options) {
         if (!this.started)
             throw new NotStartedError();
-        const joins = [];
-        for (let i = 0; i < this.shardCount; i++) {
-            const shardTopic = `${this.shardTopicPrefix}${i}`;
-            const resolved = await this.resolveShardRootState(shardTopic);
-            if (resolved.root !== this.publicKeyHash)
-                continue;
-            joins.push(this.ensureFanoutChannel(shardTopic, {
-                pin: true,
-                root: resolved.root,
-                rootCandidateGeneration: resolved.candidateGeneration,
-            }));
-        }
-        await Promise.all(joins);
+        const lifecycleSignal = this.topicRootResolutionAbortController.signal;
+        return this.withTopicRootCandidateResolution(async ({ candidateGeneration, signal }) => {
+            const joins = [];
+            try {
+                for (let i = 0; i < this.shardCount; i++) {
+                    throwIfAborted(signal);
+                    const shardTopic = `${this.shardTopicPrefix}${i}`;
+                    const resolved = await this.resolveShardRootState(shardTopic, {
+                        signal,
+                    });
+                    if (resolved.root !== this.publicKeyHash)
+                        continue;
+                    const joining = this.ensureFanoutChannel(shardTopic, {
+                        pin: true,
+                        root: resolved.root,
+                        rootCandidateGeneration: resolved.candidateGeneration,
+                        signal,
+                    });
+                    void joining.catch(() => { });
+                    joins.push(joining);
+                }
+                await Promise.all(joins);
+            }
+            catch (error) {
+                await Promise.allSettled(joins);
+                throw error;
+            }
+        }, [lifecycleSignal, options?.signal]);
     }
     async subscribe(topic) {
         this.pendingSubscriptions.add(topic);