@peerbit/shared-log 13.2.24 → 13.2.26

package/dist/src/replicator-liveness.js

@@ -0,0 +1,304 @@
+import { logger as loggerFn } from "@peerbit/logger";
+import { waitForSubscribers } from "@peerbit/pubsub";
+import { ACK_CONTROL_PRIORITY, AcknowledgeDelivery, } from "@peerbit/stream-interface";
+import { isNotStartedError } from "./errors.js";
+import { ReplicationPingMessage } from "./replication.js";
+const logger = loggerFn("peerbit:shared-log");
+// In sparse topologies (browser/relay), peers can learn about replicators via broadcast
+// replication announcements without having a direct connection that emits unsubscribe
+// on abrupt churn. Probe conservatively so a single missed ACK does not evict a
+// healthy replicator, and rely on replication-info refresh to recover membership.
+const REPLICATOR_LIVENESS_SWEEP_INTERVAL_MS = 2_000;
+const REPLICATOR_LIVENESS_IDLE_THRESHOLD_MS = 8_000;
+const REPLICATOR_LIVENESS_PROBE_FAILURES_TO_EVICT = 2;
+export class ReplicatorLivenessMonitor {
+    deps;
+    _replicatorLivenessSweepRunning;
+    _replicatorLivenessTimer;
+    _replicatorLivenessTargets;
+    _replicatorLivenessTargetsSize;
+    _replicatorLivenessCursor;
+    _replicatorLivenessFailures;
+    _replicatorLastActivityAt;
+    constructor(deps) {
+        this.deps = deps;
+        this._replicatorLivenessSweepRunning = false;
+        this._replicatorLivenessTargets = [];
+        this._replicatorLivenessTargetsSize = 0;
+        this._replicatorLivenessCursor = 0;
+        this._replicatorLivenessFailures = new Map();
+        this._replicatorLastActivityAt = new Map();
+    }
+    resetForOpen() {
+        this._replicatorLivenessSweepRunning = false;
+        this._replicatorLivenessTimer = undefined;
+        this._replicatorLivenessTargets = [];
+        this._replicatorLivenessTargetsSize = 0;
+        this._replicatorLivenessCursor = 0;
+        this._replicatorLivenessFailures = new Map();
+        this._replicatorLastActivityAt = new Map();
+    }
+    startReplicatorLivenessSweep() {
+        if (this._replicatorLivenessTimer) {
+            return;
+        }
+        this._replicatorLivenessTimer = setInterval(() => {
+            void this.runReplicatorLivenessSweep();
+        }, REPLICATOR_LIVENESS_SWEEP_INTERVAL_MS);
+        this._replicatorLivenessTimer.unref?.();
+    }
+    stopReplicatorLivenessSweep() {
+        if (this._replicatorLivenessTimer) {
+            clearInterval(this._replicatorLivenessTimer);
+            this._replicatorLivenessTimer = undefined;
+        }
+        this._replicatorLivenessSweepRunning = false;
+        this._replicatorLivenessTargets = [];
+        this._replicatorLivenessTargetsSize = 0;
+        this._replicatorLivenessCursor = 0;
+        this._replicatorLivenessFailures.clear();
+        this._replicatorLastActivityAt.clear();
+    }
+    rebuildReplicatorLivenessTargets() {
+        const selfHash = this.deps.getSelfHash();
+        this._replicatorLivenessTargets = [
+            ...this.deps.getUniqueReplicators(),
+        ].filter((hash) => hash !== selfHash);
+        this._replicatorLivenessTargetsSize = this.deps.getUniqueReplicators().size;
+        if (this._replicatorLivenessCursor >= this._replicatorLivenessTargets.length) {
+            this._replicatorLivenessCursor = 0;
+        }
+    }
+    getReplicatorLivenessTargets() {
+        const selfHash = this.deps.getSelfHash();
+        const uniqueReplicators = this.deps.getUniqueReplicators();
+        const expected = uniqueReplicators.size - (uniqueReplicators.has(selfHash) ? 1 : 0);
+        if (this._replicatorLivenessTargets.length > 0) {
+            // Keep the cursor stable, but purge stale hashes (membership can change while
+            // the total size stays constant).
+            this._replicatorLivenessTargets = this._replicatorLivenessTargets.filter((hash) => hash !== selfHash && uniqueReplicators.has(hash));
+        }
+        if (this._replicatorLivenessTargetsSize !== uniqueReplicators.size ||
+            this._replicatorLivenessTargets.length !== expected) {
+            this.rebuildReplicatorLivenessTargets();
+        }
+        return this._replicatorLivenessTargets;
+    }
+    markReplicatorActivity(peerHash, now = Date.now()) {
+        this._replicatorLastActivityAt.set(peerHash, now);
+        // Any recent authenticated activity is positive liveness evidence. Reset the
+        // consecutive miss streak immediately, including while an eviction is
+        // waiting in the per-peer mutation lane.
+        if (Date.now() - now < REPLICATOR_LIVENESS_IDLE_THRESHOLD_MS) {
+            this._replicatorLivenessFailures.delete(peerHash);
+        }
+    }
+    hasRecentReplicatorActivity(peerHash, now = Date.now()) {
+        const lastActivityAt = this._replicatorLastActivityAt.get(peerHash);
+        if (lastActivityAt != null &&
+            now - lastActivityAt < REPLICATOR_LIVENESS_IDLE_THRESHOLD_MS) {
+            this._replicatorLivenessFailures.delete(peerHash);
+            return true;
+        }
+        return false;
+    }
+    async evictReplicatorFromLiveness(peerHash, publicKey, replicationLifecycleController, subscriptionEpoch, observedActivityAt) {
+        try {
+            await this.deps.removeReplicator(publicKey, {
+                noEvent: true,
+                replicationLifecycleController,
+                shouldRemove: () => this._replicatorLastActivityAt.get(peerHash) === observedActivityAt,
+                subscriptionEpoch,
+                onRemoved: ({ wasReplicator }) => {
+                    if (wasReplicator) {
+                        this.deps.getPendingReplicatorLeaveByPeer().add(peerHash);
+                    }
+                    // A newer subscription/lifecycle may have started while the admitted
+                    // removal was completing. Its reconnect barrier owns all later effects.
+                    if (!this.deps.isReplicationLifecycleActive(replicationLifecycleController) ||
+                        !this.deps.isPeerSessionCurrent(peerHash, subscriptionEpoch)) {
+                        return;
+                    }
+                    if (this.deps.getPendingReplicatorLeaveByPeer().delete(peerHash)) {
+                        this.deps.dispatchReplicatorLeave(publicKey);
+                    }
+                    if (!this.deps.isBlockedPeer(peerHash)) {
+                        this.deps.scheduleReplicationInfoRequests(publicKey, replicationLifecycleController);
+                    }
+                    this._replicatorLivenessTargetsSize = -1;
+                },
+            });
+        }
+        catch (error) {
+            if (!isNotStartedError(error)) {
+                throw error;
+            }
+        }
+    }
+    async runReplicatorLivenessSweep() {
+        const replicationLifecycleController = this.deps.getReplicationLifecycleController();
+        if (this.deps.isClosed() ||
+            this.deps.getCloseSignal().aborted ||
+            !this.deps.isReplicationLifecycleActive(replicationLifecycleController)) {
+            return;
+        }
+        if (this._replicatorLivenessSweepRunning) {
+            return;
+        }
+        const targets = this.getReplicatorLivenessTargets();
+        if (targets.length === 0) {
+            return;
+        }
+        this._replicatorLivenessSweepRunning = true;
+        try {
+            if (this._replicatorLivenessCursor >= targets.length) {
+                this._replicatorLivenessCursor = 0;
+            }
+            const peerHash = targets[this._replicatorLivenessCursor];
+            this._replicatorLivenessCursor =
+                (this._replicatorLivenessCursor + 1) % targets.length;
+            await this.deps.probeReplicatorLiveness(peerHash);
+        }
+        catch (error) {
+            if (!isNotStartedError(error)) {
+                logger.error(error?.toString?.() ?? String(error));
+            }
+        }
+        finally {
+            if (this.deps.getReplicationLifecycleController() ===
+                replicationLifecycleController) {
+                this._replicatorLivenessSweepRunning = false;
+            }
+        }
+    }
+    async probeReplicatorLiveness(peerHash) {
+        const replicationLifecycleController = this.deps.getReplicationLifecycleController();
+        if (this.deps.isClosed() ||
+            this.deps.getCloseSignal().aborted ||
+            !replicationLifecycleController ||
+            !this.deps.isReplicationLifecycleActive(replicationLifecycleController)) {
+            return;
+        }
+        const subscriptionEpoch = this.deps.getPeerSession(peerHash);
+        const ownsProbe = () => this.deps.isReplicationLifecycleActive(replicationLifecycleController) &&
+            this.deps.isPeerSessionCurrent(peerHash, subscriptionEpoch);
+        if (!this.deps.getUniqueReplicators().has(peerHash)) {
+            this._replicatorLivenessFailures.delete(peerHash);
+            return;
+        }
+        if (this.hasRecentReplicatorActivity(peerHash)) {
+            return;
+        }
+        const observedActivityAt = this._replicatorLastActivityAt.get(peerHash);
+        const publicKey = await this.deps.resolvePublicKeyFromHash(peerHash);
+        if (!ownsProbe()) {
+            return;
+        }
+        if (this.hasRecentReplicatorActivity(peerHash)) {
+            return;
+        }
+        if (!publicKey) {
+            try {
+                await this.deps.removeReplicator(peerHash, {
+                    noEvent: true,
+                    replicationLifecycleController,
+                    shouldRemove: () => this._replicatorLastActivityAt.get(peerHash) === observedActivityAt,
+                    subscriptionEpoch,
+                    onRemoved: () => {
+                        if (!ownsProbe()) {
+                            return;
+                        }
+                        this._replicatorLivenessTargetsSize = -1;
+                    },
+                });
+            }
+            catch (error) {
+                if (!isNotStartedError(error)) {
+                    throw error;
+                }
+            }
+            return;
+        }
+        try {
+            // Explicit ping (ACKed) instead of RequestReplicationInfoMessage to avoid
+            // triggering large segment snapshots just to prove liveness.
+            await this.deps.getRpc().send(new ReplicationPingMessage(), {
+                mode: new AcknowledgeDelivery({ redundancy: 1, to: [publicKey] }),
+                priority: ACK_CONTROL_PRIORITY,
+                responsePriority: ACK_CONTROL_PRIORITY,
+            });
+            if (!ownsProbe()) {
+                return;
+            }
+            this.deps.markReplicatorActivity(peerHash);
+            this._replicatorLivenessFailures.delete(peerHash);
+            return;
+        }
+        catch (error) {
+            if (isNotStartedError(error)) {
+                return;
+            }
+        }
+        if (!ownsProbe()) {
+            return;
+        }
+        if (this.hasRecentReplicatorActivity(peerHash)) {
+            return;
+        }
+        // Relay-backed prod paths can keep a peer subscribed/reachable even if an
+        // ACKed liveness ping gets delayed or dropped under load. Treat observed
+        // topic presence as a positive liveness signal before evicting the peer.
+        if (await this.deps.confirmReplicatorSubscriberPresence(peerHash)) {
+            if (!ownsProbe()) {
+                return;
+            }
+            this.deps.markReplicatorActivity(peerHash);
+            this._replicatorLivenessFailures.delete(peerHash);
+            return;
+        }
+        if (!ownsProbe()) {
+            return;
+        }
+        if (this.hasRecentReplicatorActivity(peerHash)) {
+            return;
+        }
+        const failures = (this._replicatorLivenessFailures.get(peerHash) ?? 0) + 1;
+        this._replicatorLivenessFailures.set(peerHash, failures);
+        this.deps.scheduleReplicationInfoRequests(publicKey, replicationLifecycleController);
+        if (failures < REPLICATOR_LIVENESS_PROBE_FAILURES_TO_EVICT) {
+            return;
+        }
+        if (!ownsProbe() || !this.deps.getUniqueReplicators().has(peerHash)) {
+            this._replicatorLivenessFailures.delete(peerHash);
+            return;
+        }
+        await this.evictReplicatorFromLiveness(peerHash, publicKey, replicationLifecycleController, subscriptionEpoch, observedActivityAt);
+    }
+    async confirmReplicatorSubscriberPresence(peerHash) {
+        try {
+            const subscribers = await this.deps.getTopicSubscribers(this.deps.getRpc().topic);
+            if (subscribers?.some((subscriber) => subscriber.hashcode() === peerHash)) {
+                return true;
+            }
+        }
+        catch (error) {
+            if (isNotStartedError(error)) {
+                return false;
+            }
+        }
+        try {
+            await waitForSubscribers(this.deps.getNode(), peerHash, this.deps.getRpc().topic, {
+                signal: this.deps.getCloseSignal(),
+                timeout: Math.max(1_000, Math.min(5_000, Math.floor(this.deps.getWaitForReplicatorTimeout() / 4))),
+            });
+            return true;
+        }
+        catch (error) {
+            if (isNotStartedError(error)) {
+                return false;
+            }
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=replicator-liveness.js.map

package/dist/src/replicator-liveness.js.map

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

package/dist/src/sync/dispatch-lifecycle.d.ts

@@ -0,0 +1,48 @@
+export interface DispatchTargetLifecycleBase<LC> {
+    lifecycle: LC;
+    target: string;
+    controller: AbortController;
+}
+export interface DispatchLifecycleBase<TL> {
+    ownershipLifecycleController: AbortController;
+    callerSignal?: AbortSignal;
+    controller: AbortController;
+    targets: Map<string, TL>;
+    onOwnerOrCallerAbort: () => void;
+    dispatchFinished: boolean;
+    disposed: boolean;
+}
+export type DispatchLifecycleRegistryDeps<LC extends DispatchLifecycleBase<TL>, TL extends DispatchTargetLifecycleBase<LC>> = {
+    isClosed: () => boolean;
+    currentOwnershipLifecycleController: () => AbortController;
+    hasRetainedWork: (lifecycle: LC) => boolean;
+    isTargetCurrent: (targetLifecycle: TL) => boolean;
+    onTargetAborted?: (targetLifecycle: TL) => void;
+};
+export declare class DispatchLifecycleRegistry<LC extends DispatchLifecycleBase<TL>, TL extends DispatchTargetLifecycleBase<LC>> {
+    private readonly deps;
+    readonly activeTargets: Map<string, Set<TL>>;
+    constructor(deps: DispatchLifecycleRegistryDeps<LC, TL>);
+    register(lifecycle: LC, targets: string[], createTargetLifecycle: (lifecycle: LC, target: string) => TL | undefined, onTargetRegistered?: (targetLifecycle: TL) => void): void;
+    abortTarget(targetLifecycle: TL, reason?: unknown): void;
+    abortLifecycle(lifecycle: LC, reason?: unknown): void;
+    finish(lifecycle: LC): void;
+    maybeDispose(lifecycle: LC): void;
+    isLifecycleActive(lifecycle: LC, target?: string): boolean;
+    getSignal(lifecycle: LC, target: string): AbortSignal;
+}
+export declare const isOwnershipGenerationActive: (properties: {
+    closed: boolean;
+    ownershipLifecycleController: AbortController;
+    currentOwnershipLifecycleController: AbortController;
+}) => boolean;
+export declare const isTrackedSessionActive: <TSession>(properties: {
+    closed: boolean;
+    cancelled: boolean;
+    sessionController: AbortController;
+    ownershipLifecycleController: AbortController;
+    currentOwnershipLifecycleController: AbortController;
+    session: TSession;
+    registered: TSession | undefined;
+}) => boolean;
+//# sourceMappingURL=dispatch-lifecycle.d.ts.map

package/dist/src/sync/dispatch-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/sync/dispatch-lifecycle.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,2BAA2B,CAAC,EAAE;IAC9C,SAAS,EAAE,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB,CAAC,EAAE;IACxC,4BAA4B,EAAE,eAAe,CAAC;IAC9C,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,6BAA6B,CACxC,EAAE,SAAS,qBAAqB,CAAC,EAAE,CAAC,EACpC,EAAE,SAAS,2BAA2B,CAAC,EAAE,CAAC,IACvC;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,mCAAmC,EAAE,MAAM,eAAe,CAAC;IAE3D,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,OAAO,CAAC;IAE5C,eAAe,EAAE,CAAC,eAAe,EAAE,EAAE,KAAK,OAAO,CAAC;IAGlD,eAAe,CAAC,EAAE,CAAC,eAAe,EAAE,EAAE,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,qBAAa,yBAAyB,CACrC,EAAE,SAAS,qBAAqB,CAAC,EAAE,CAAC,EACpC,EAAE,SAAS,2BAA2B,CAAC,EAAE,CAAC;IAI9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAa;gBAE5B,IAAI,EAAE,6BAA6B,CAAC,EAAE,EAAE,EAAE,CAAC;IAOxE,QAAQ,CACP,SAAS,EAAE,EAAE,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,qBAAqB,EAAE,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE,GAAG,SAAS,EACxE,kBAAkB,CAAC,EAAE,CAAC,eAAe,EAAE,EAAE,KAAK,IAAI,GAChD,IAAI;IA0CP,WAAW,CAAC,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAQxD,cAAc,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAUrD,MAAM,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI;IAK3B,YAAY,CAAC,SAAS,EAAE,EAAE,GAAG,IAAI;IA+BjC,iBAAiB,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAuB1D,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW;CAMrD;AAMD,eAAO,MAAM,2BAA2B,GAAI,YAAY;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B,EAAE,eAAe,CAAC;IAC9C,mCAAmC,EAAE,eAAe,CAAC;CACrD,KAAG,OAIoD,CAAC;AAOzD,eAAO,MAAM,sBAAsB,GAAI,QAAQ,EAAE,YAAY;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,eAAe,CAAC;IACnC,4BAA4B,EAAE,eAAe,CAAC;IAC9C,mCAAmC,EAAE,eAAe,CAAC;IACrD,OAAO,EAAE,QAAQ,CAAC;IAClB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;CACjC,KAAG,OAOyC,CAAC"}

package/dist/src/sync/dispatch-lifecycle.js

@@ -0,0 +1,141 @@
+// Shared dispatch-lifecycle registry for the sync module (stage-4 sync
+// unification). The simple and rateless synchronizers used to carry
+// near-verbatim copies of the capture/abort/finish/dispose/isActive
+// lifecycle machinery; this registry hosts the shared mechanics and keeps
+// the two deliberate behavioral deltas as injected strategies:
+//
+// - target activity: the simple synchronizer compares the target's dispatch
+//   EPOCH identity, the rateless synchronizer checks SET MEMBERSHIP of the
+//   target lifecycle in the active-target registry. The strategy is always
+//   injected (`isTargetCurrent`), never defaulted.
+// - retention: disposal is deferred while `hasRetainedWork` is true — a
+//   retained-work counter for the simple synchronizer, a per-target
+//   retainedByProcess/responseLeases scan for the rateless one.
+//
+// Lifecycle objects are constructed by the callers (they carry
+// caller-specific fields such as epochs, batches and retained-work
+// counters); the registry owns the per-target active sets, the listener
+// add/remove pairing and the dispose gating.
+export class DispatchLifecycleRegistry {
+    deps;
+    activeTargets = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    // Registers the caller-constructed lifecycle: creates the per-target
+    // lifecycles (the factory may skip a target or abort it right after
+    // registration via `onTargetRegistered`), pairs the owner/caller abort
+    // listeners and performs the initial staleness abort exactly like both
+    // former capture implementations.
+    register(lifecycle, targets, createTargetLifecycle, onTargetRegistered) {
+        for (const target of [...new Set(targets)]) {
+            const targetLifecycle = createTargetLifecycle(lifecycle, target);
+            if (!targetLifecycle) {
+                continue;
+            }
+            lifecycle.targets.set(target, targetLifecycle);
+            let activeForTarget = this.activeTargets.get(target);
+            if (!activeForTarget) {
+                activeForTarget = new Set();
+                this.activeTargets.set(target, activeForTarget);
+            }
+            activeForTarget.add(targetLifecycle);
+            onTargetRegistered?.(targetLifecycle);
+        }
+        lifecycle.ownershipLifecycleController.signal.addEventListener("abort", lifecycle.onOwnerOrCallerAbort, { once: true });
+        if (lifecycle.callerSignal &&
+            lifecycle.callerSignal !== lifecycle.ownershipLifecycleController.signal) {
+            lifecycle.callerSignal.addEventListener("abort", lifecycle.onOwnerOrCallerAbort, { once: true });
+        }
+        if (this.deps.isClosed() ||
+            lifecycle.ownershipLifecycleController !==
+                this.deps.currentOwnershipLifecycleController() ||
+            lifecycle.ownershipLifecycleController.signal.aborted ||
+            lifecycle.callerSignal?.aborted) {
+            lifecycle.onOwnerOrCallerAbort();
+        }
+    }
+    abortTarget(targetLifecycle, reason) {
+        if (!targetLifecycle.controller.signal.aborted) {
+            targetLifecycle.controller.abort(reason);
+        }
+        this.deps.onTargetAborted?.(targetLifecycle);
+        this.maybeDispose(targetLifecycle.lifecycle);
+    }
+    abortLifecycle(lifecycle, reason) {
+        if (!lifecycle.controller.signal.aborted) {
+            lifecycle.controller.abort(reason);
+        }
+        for (const targetLifecycle of lifecycle.targets.values()) {
+            this.abortTarget(targetLifecycle, reason);
+        }
+        this.maybeDispose(lifecycle);
+    }
+    finish(lifecycle) {
+        lifecycle.dispatchFinished = true;
+        this.maybeDispose(lifecycle);
+    }
+    maybeDispose(lifecycle) {
+        if (lifecycle.disposed ||
+            !lifecycle.dispatchFinished ||
+            this.deps.hasRetainedWork(lifecycle)) {
+            return;
+        }
+        lifecycle.disposed = true;
+        lifecycle.ownershipLifecycleController.signal.removeEventListener("abort", lifecycle.onOwnerOrCallerAbort);
+        if (lifecycle.callerSignal &&
+            lifecycle.callerSignal !== lifecycle.ownershipLifecycleController.signal) {
+            lifecycle.callerSignal.removeEventListener("abort", lifecycle.onOwnerOrCallerAbort);
+        }
+        for (const targetLifecycle of lifecycle.targets.values()) {
+            const activeForTarget = this.activeTargets.get(targetLifecycle.target);
+            activeForTarget?.delete(targetLifecycle);
+            if (activeForTarget?.size === 0) {
+                this.activeTargets.delete(targetLifecycle.target);
+            }
+        }
+    }
+    isLifecycleActive(lifecycle, target) {
+        if (this.deps.isClosed() ||
+            lifecycle.disposed ||
+            lifecycle.ownershipLifecycleController !==
+                this.deps.currentOwnershipLifecycleController() ||
+            lifecycle.ownershipLifecycleController.signal.aborted ||
+            lifecycle.callerSignal?.aborted ||
+            lifecycle.controller.signal.aborted) {
+            return false;
+        }
+        if (target === undefined) {
+            return true;
+        }
+        const targetLifecycle = lifecycle.targets.get(target);
+        return (targetLifecycle !== undefined &&
+            !targetLifecycle.controller.signal.aborted &&
+            this.deps.isTargetCurrent(targetLifecycle));
+    }
+    getSignal(lifecycle, target) {
+        return (lifecycle.targets.get(target)?.controller.signal ??
+            lifecycle.controller.signal);
+    }
+}
+// The shared ownership-generation identity check: a captured ownership
+// controller is current while the synchronizer is open, the controller is
+// still THE controller (identity, not just non-aborted) and it has not been
+// aborted.
+export const isOwnershipGenerationActive = (properties) => !properties.closed &&
+    properties.ownershipLifecycleController ===
+        properties.currentOwnershipLifecycleController &&
+    !properties.ownershipLifecycleController.signal.aborted;
+// The shared tracked-session identity check (the pattern the host-side
+// instance lifecycle drained the index.ts fences into): a session is active
+// while nothing cancelled or aborted it, its ownership generation is still
+// current, and the session registry still maps its id to THIS session
+// object.
+export const isTrackedSessionActive = (properties) => !properties.closed &&
+    !properties.cancelled &&
+    !properties.sessionController.signal.aborted &&
+    !properties.ownershipLifecycleController.signal.aborted &&
+    properties.ownershipLifecycleController ===
+        properties.currentOwnershipLifecycleController &&
+    properties.registered === properties.session;
+//# sourceMappingURL=dispatch-lifecycle.js.map

package/dist/src/sync/dispatch-lifecycle.js.map

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

package/dist/src/sync/factory.d.ts

@@ -0,0 +1,29 @@
+import type { Cache } from "@peerbit/cache";
+import type { Index } from "@peerbit/indexer-interface";
+import type { Log } from "@peerbit/log";
+import type { NativePeerbitBackbone } from "@peerbit/native-backbone";
+import type { RPC } from "@peerbit/rpc";
+import type { SharedLogNativeState } from "@peerbit/shared-log-rust";
+import type { Numbers } from "../integers.js";
+import type { TransportMessage } from "../message.js";
+import type { EntryReplicated, ReplicationRangeIndexable } from "../ranges.js";
+import type { RawExchangeHeadsSender, SyncOptions, SynchronizerConstructor, Syncronizer } from "./index.js";
+export type CreateSyncronizerProps<R extends "u32" | "u64"> = {
+    numbers: Numbers<R>;
+    entryIndex: Index<EntryReplicated<R>, any>;
+    rangeIndex: Index<ReplicationRangeIndexable<R>, any>;
+    log: Log<any>;
+    rpc: RPC<TransportMessage, TransportMessage>;
+    coordinateToHash: Cache<string>;
+    getNativeState: () => NativePeerbitBackbone | SharedLogNativeState | undefined;
+    isEntryRecentlyKnownByPeer: (hash: string, peer: string, maxAgeMs: number) => boolean;
+    peerSupportsRawExchangeHeads: (peer: string) => boolean;
+    sendRawExchangeHeads: RawExchangeHeadsSender;
+    warn: (message: string) => void;
+    compatibility?: number;
+    resolution: R;
+    sync?: SyncOptions<R>;
+    syncronizer?: SynchronizerConstructor<R>;
+};
+export declare function createSyncronizer<R extends "u32" | "u64">(props: CreateSyncronizerProps<R>): Syncronizer<R>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/sync/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/sync/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EACX,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,WAAW,EACX,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI;IAE7D,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,UAAU,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACd,GAAG,EAAE,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC7C,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAGhC,cAAc,EAAE,MACb,qBAAqB,GACrB,oBAAoB,GACpB,SAAS,CAAC;IACb,0BAA0B,EAAE,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC;IACb,4BAA4B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EACxD,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,CAAC,CAAC,CAwGhB"}

package/dist/src/sync/factory.js

@@ -0,0 +1,87 @@
+import { RatelessIBLTSynchronizer } from "./rateless-iblt.js";
+import { SimpleSyncronizer } from "./simple.js";
+export function createSyncronizer(props) {
+    const resolveHashesForSymbols = (symbols) => {
+        const nativeState = props.getNativeState();
+        if (!nativeState) {
+            return undefined;
+        }
+        if (typeof BigUint64Array !== "undefined" &&
+            typeof nativeState.getEntryHashesForHashNumbersU64 === "function") {
+            return nativeState.getEntryHashesForHashNumbersU64(symbols instanceof BigUint64Array
+                ? symbols
+                : BigUint64Array.from(symbols));
+        }
+        return nativeState.getEntryHashesForHashNumbers(symbols);
+    };
+    const resolveHashListForSymbols = (symbols) => {
+        const nativeState = props.getNativeState();
+        if (!nativeState ||
+            typeof BigUint64Array === "undefined" ||
+            typeof nativeState.getEntryHashListForHashNumbersU64 !== "function") {
+            return undefined;
+        }
+        return nativeState.getEntryHashListForHashNumbersU64(symbols instanceof BigUint64Array
+            ? symbols
+            : BigUint64Array.from(symbols));
+    };
+    const resolveHashNumbersInRange = (range) => {
+        const nativeState = props.getNativeState();
+        return (nativeState?.getEntryHashNumbersInRangeU64?.(range) ??
+            nativeState?.getEntryHashNumbersInRange(range));
+    };
+    if (props.syncronizer) {
+        return new props.syncronizer({
+            numbers: props.numbers,
+            entryIndex: props.entryIndex,
+            log: props.log,
+            rangeIndex: props.rangeIndex,
+            rpc: props.rpc,
+            coordinateToHash: props.coordinateToHash,
+            resolveHashesForSymbols,
+            resolveHashListForSymbols,
+            resolveHashNumbersInRange,
+            sync: props.sync,
+            isEntryRecentlyKnownByPeer: props.isEntryRecentlyKnownByPeer,
+            peerSupportsRawExchangeHeads: props.peerSupportsRawExchangeHeads,
+            sendRawExchangeHeads: props.sendRawExchangeHeads,
+        });
+    }
+    else {
+        if (props.compatibility && props.compatibility < 10) {
+            return new SimpleSyncronizer({
+                log: props.log,
+                rpc: props.rpc,
+                entryIndex: props.entryIndex,
+                coordinateToHash: props.coordinateToHash,
+                resolveHashesForSymbols,
+                resolveHashListForSymbols,
+                sync: props.sync,
+                isEntryRecentlyKnownByPeer: props.isEntryRecentlyKnownByPeer,
+                peerSupportsRawExchangeHeads: props.peerSupportsRawExchangeHeads,
+                sendRawExchangeHeads: props.sendRawExchangeHeads,
+            });
+        }
+        else {
+            if (props.resolution === "u32") {
+                props.warn("u32 resolution is not recommended for RatelessIBLTSynchronizer");
+            }
+            return new RatelessIBLTSynchronizer({
+                numbers: props.numbers,
+                entryIndex: props.entryIndex,
+                log: props.log,
+                rangeIndex: props.rangeIndex,
+                rpc: props.rpc,
+                coordinateToHash: props.coordinateToHash,
+                resolveHashesForSymbols,
+                resolveHashListForSymbols,
+                resolveHashNumbersInRange,
+                sync: props.sync,
+                isEntryRecentlyKnownByPeer: props.isEntryRecentlyKnownByPeer,
+                peerSupportsRawExchangeHeads: props.peerSupportsRawExchangeHeads,
+                sendRawExchangeHeads: props.sendRawExchangeHeads,
+            });
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map