@peerbit/shared-log 12.3.5 → 13.0.0-b712c6b

package/dist/benchmark/sync-batch-sweep.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync-batch-sweep.d.ts.map

package/dist/benchmark/sync-batch-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-batch-sweep.d.ts","sourceRoot":"","sources":["../../benchmark/sync-batch-sweep.ts"],"names":[],"mappings":""}

package/dist/benchmark/sync-batch-sweep.js

@@ -0,0 +1,305 @@
+// Benchmarks catch-up sync behavior while varying repair sweep batch size.
+//
+// Run with:
+//   cd packages/programs/data/shared-log
+//   SWEEP_BATCH_SIZES="256,512,1024,4096,16384,65536" SWEEP_ENTRY_COUNT=20000 \
+//     SWEEP_RUNS=1 SWEEP_TIMEOUT=120000 node --loader ts-node/esm ./benchmark/sync-batch-sweep.ts
+//
+// CI assertion env vars:
+// - SWEEP_ASSERT_MAX_RATIO: max allowed (slowest_mean / fastest_mean)
+// - SWEEP_ASSERT_REQUIRE_STARTSYNC_FOR_BATCH_GTE: require StartSync traffic for batches >= value
+// - SWEEP_ASSERT_MAX_MEAN_MS: comma list "batch:maxMs,batch:maxMs"
+import { keys } from "@libp2p/crypto";
+import { TestSession } from "@peerbit/test-utils";
+import { waitForResolved } from "@peerbit/time";
+import { expect } from "chai";
+import { performance } from "node:perf_hooks";
+import { createReplicationDomainHash } from "../src/index.js";
+import { MoreSymbols, RatelessIBLTSynchronizer, RequestAll, StartSync, } from "../src/sync/rateless-iblt.js";
+import { RequestMaybeSync, RequestMaybeSyncCoordinate, } from "../src/sync/simple.js";
+import { EventStore } from "../test/utils/stores/event-store.js";
+const parsePositiveInteger = (value, fallback) => {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, got '${value}'`);
+    }
+    return parsed;
+};
+const parseNonNegativeInteger = (value, fallback) => {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`Expected a non-negative integer, got '${value}'`);
+    }
+    return parsed;
+};
+const parseNumberList = (value, defaults) => {
+    if (!value)
+        return defaults;
+    const parsed = value
+        .split(",")
+        .map((x) => Number.parseInt(x.trim(), 10))
+        .filter((x) => Number.isFinite(x) && x > 0);
+    return parsed.length > 0 ? parsed : defaults;
+};
+const parseBatchThresholdMap = (value) => {
+    const thresholds = new Map();
+    if (!value)
+        return thresholds;
+    for (const token of value.split(",")) {
+        const [batchRaw, thresholdRaw] = token.split(":");
+        if (!batchRaw || !thresholdRaw) {
+            throw new Error(`Invalid SWEEP_ASSERT_MAX_MEAN_MS token '${token}', expected 'batch:maxMs'`);
+        }
+        const batch = Number.parseInt(batchRaw.trim(), 10);
+        const threshold = Number.parseFloat(thresholdRaw.trim());
+        if (!Number.isFinite(batch) || batch <= 0) {
+            throw new Error(`Invalid batch '${batchRaw}' in SWEEP_ASSERT_MAX_MEAN_MS token '${token}'`);
+        }
+        if (!Number.isFinite(threshold) || threshold <= 0) {
+            throw new Error(`Invalid threshold '${thresholdRaw}' in SWEEP_ASSERT_MAX_MEAN_MS token '${token}'`);
+        }
+        thresholds.set(batch, threshold);
+    }
+    return thresholds;
+};
+const parseOptionalPositiveFloat = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseFloat(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive number, got '${value}'`);
+    }
+    return parsed;
+};
+const parseOptionalPositiveInteger = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, got '${value}'`);
+    }
+    return parsed;
+};
+const createEmptyCounters = () => ({
+    startSync: 0,
+    moreSymbols: 0,
+    requestAll: 0,
+    requestMaybeSync: 0,
+    requestMaybeSyncCoordinate: 0,
+});
+const mergeCounters = (left, right) => ({
+    startSync: left.startSync + right.startSync,
+    moreSymbols: left.moreSymbols + right.moreSymbols,
+    requestAll: left.requestAll + right.requestAll,
+    requestMaybeSync: left.requestMaybeSync + right.requestMaybeSync,
+    requestMaybeSyncCoordinate: left.requestMaybeSyncCoordinate + right.requestMaybeSyncCoordinate,
+});
+const attachMessageCounter = (store) => {
+    const counters = createEmptyCounters();
+    const original = store.log.onMessage.bind(store.log);
+    store.log.onMessage = async (msg, context) => {
+        if (msg instanceof StartSync)
+            counters.startSync += 1;
+        else if (msg instanceof MoreSymbols)
+            counters.moreSymbols += 1;
+        else if (msg instanceof RequestAll)
+            counters.requestAll += 1;
+        else if (msg instanceof RequestMaybeSync)
+            counters.requestMaybeSync += 1;
+        else if (msg instanceof RequestMaybeSyncCoordinate)
+            counters.requestMaybeSyncCoordinate += 1;
+        return original(msg, context);
+    };
+    return {
+        read: () => ({ ...counters }),
+        restore: () => {
+            store.log.onMessage = original;
+        },
+    };
+};
+const fixedKeys = [
+    {
+        libp2p: {
+            privateKey: keys.privateKeyFromRaw(new Uint8Array([
+                204, 234, 187, 172, 226, 232, 70, 175, 62, 211, 147, 91, 229, 157,
+                168, 15, 45, 242, 144, 98, 75, 58, 208, 9, 223, 143, 251, 52, 252,
+                159, 64, 83, 52, 197, 24, 246, 24, 234, 141, 183, 151, 82, 53, 142,
+                57, 25, 148, 150, 26, 209, 223, 22, 212, 40, 201, 6, 191, 72, 148, 82,
+                66, 138, 199, 185,
+            ])),
+        },
+    },
+    {
+        libp2p: {
+            privateKey: keys.privateKeyFromRaw(new Uint8Array([
+                237, 55, 205, 86, 40, 44, 73, 169, 196, 118, 36, 69, 214, 122, 28,
+                157, 208, 163, 15, 215, 104, 193, 151, 177, 62, 231, 253, 120, 122,
+                222, 174, 242, 120, 50, 165, 97, 8, 235, 97, 186, 148, 251, 100, 168,
+                49, 10, 119, 71, 246, 246, 174, 163, 198, 54, 224, 6, 174, 212, 159,
+                187, 2, 137, 47, 192,
+            ])),
+        },
+    },
+];
+const setup = {
+    domain: createReplicationDomainHash("u64"),
+    type: "u64",
+    syncronizer: RatelessIBLTSynchronizer,
+    name: "u64-iblt",
+};
+const runCatchup = async (properties) => {
+    const session = await TestSession.disconnected(2, fixedKeys);
+    const store = new EventStore();
+    let db1;
+    let db2;
+    let counter1;
+    let counter2;
+    try {
+        db1 = await session.peers[0].open(store.clone(), {
+            args: {
+                replicate: { factor: 2 },
+                setup,
+                sync: {
+                    repairSweepTargetBufferSize: properties.batchSize,
+                },
+            },
+        });
+        // Preload while only a single replica is active to avoid delivery-timeout
+        // artifacts when very large entry counts are written offline.
+        for (let i = 0; i < properties.entryCount; i++) {
+            await db1.add(`entry-${i}`, { meta: { next: [] } });
+        }
+        expect(db1.log.log.length).to.equal(properties.entryCount);
+        db2 = await session.peers[1].open(store.clone(), {
+            args: {
+                replicate: { factor: 2 },
+                setup,
+                sync: {
+                    repairSweepTargetBufferSize: properties.batchSize,
+                },
+            },
+        });
+        expect(db2.log.log.length).to.equal(0);
+        counter1 = attachMessageCounter(db1);
+        counter2 = attachMessageCounter(db2);
+        await waitForResolved(() => session.peers[0].dial(session.peers[1].getMultiaddrs()));
+        const t0 = performance.now();
+        await waitForResolved(() => expect(db2.log.log.length).to.equal(properties.entryCount), { timeout: properties.timeoutMs, delayInterval: 250 });
+        const catchupMs = performance.now() - t0;
+        const counters = mergeCounters(counter1.read(), counter2.read());
+        return { catchupMs, counters };
+    }
+    finally {
+        counter1?.restore();
+        counter2?.restore();
+        await session.stop();
+    }
+};
+const mean = (values) => values.reduce((acc, value) => acc + value, 0) / values.length;
+const batchSizes = parseNumberList(process.env.SWEEP_BATCH_SIZES, [
+    256,
+    512,
+    1024,
+    4096,
+    16384,
+    65536,
+]);
+const entryCount = parsePositiveInteger(process.env.SWEEP_ENTRY_COUNT, 20_000);
+const timeoutMs = parsePositiveInteger(process.env.SWEEP_TIMEOUT, 120_000);
+const warmupRuns = parseNonNegativeInteger(process.env.SWEEP_WARMUP_RUNS, 0);
+const measuredRuns = parsePositiveInteger(process.env.SWEEP_RUNS, 1);
+const assertMaxRatio = parseOptionalPositiveFloat(process.env.SWEEP_ASSERT_MAX_RATIO);
+const assertStartSyncForBatchGte = parseOptionalPositiveInteger(process.env.SWEEP_ASSERT_REQUIRE_STARTSYNC_FOR_BATCH_GTE);
+const assertMaxMeanByBatch = parseBatchThresholdMap(process.env.SWEEP_ASSERT_MAX_MEAN_MS);
+const tasks = [];
+for (const batchSize of batchSizes) {
+    let counterTotals = createEmptyCounters();
+    const samples = [];
+    const totalRuns = warmupRuns + measuredRuns;
+    for (let run = 0; run < totalRuns; run++) {
+        const result = await runCatchup({ batchSize, entryCount, timeoutMs });
+        if (run < warmupRuns) {
+            continue;
+        }
+        samples.push(result.catchupMs);
+        counterTotals = mergeCounters(counterTotals, result.counters);
+    }
+    const meanMs = mean(samples);
+    tasks.push({
+        name: `repairSweepTargetBufferSize=${batchSize}`,
+        batchSize,
+        mean_ms: meanMs,
+        hz: meanMs > 0 ? 1000 / meanMs : 0,
+        rme: null,
+        samples: samples.length,
+        startSyncTotal: counterTotals.startSync,
+        moreSymbolsTotal: counterTotals.moreSymbols,
+        requestAllTotal: counterTotals.requestAll,
+        requestMaybeSyncTotal: counterTotals.requestMaybeSync,
+        requestMaybeSyncCoordinateTotal: counterTotals.requestMaybeSyncCoordinate,
+    });
+}
+const failures = [];
+if (assertMaxRatio != null && tasks.length > 1) {
+    const means = tasks.map((task) => task.mean_ms);
+    const ratio = Math.max(...means) / Math.min(...means);
+    if (ratio > assertMaxRatio) {
+        failures.push(`max mean ratio ${ratio.toFixed(3)} exceeded threshold ${assertMaxRatio.toFixed(3)}`);
+    }
+}
+if (assertStartSyncForBatchGte != null) {
+    for (const task of tasks) {
+        if (task.batchSize >= assertStartSyncForBatchGte &&
+            task.startSyncTotal === 0) {
+            failures.push(`batch ${task.batchSize} produced zero StartSync messages (expected rateless path)`);
+        }
+    }
+}
+for (const [batchSize, maxMeanMs] of assertMaxMeanByBatch) {
+    const task = tasks.find((x) => x.batchSize === batchSize);
+    if (!task) {
+        failures.push(`missing configured batch size ${batchSize} for max mean assertion`);
+        continue;
+    }
+    if (task.mean_ms > maxMeanMs) {
+        failures.push(`batch ${batchSize} mean ${task.mean_ms.toFixed(3)}ms exceeded max ${maxMeanMs.toFixed(3)}ms`);
+    }
+}
+const output = {
+    name: "shared-log-sync-batch-sweep",
+    tasks,
+    meta: {
+        entryCount,
+        timeoutMs,
+        warmupRuns,
+        measuredRuns,
+        batchSizes,
+    },
+};
+if (process.env.BENCH_JSON === "1") {
+    process.stdout.write(JSON.stringify(output, null, 2));
+}
+else {
+    console.table(tasks.map((task) => ({
+        batch: task.batchSize,
+        mean_ms: task.mean_ms.toFixed(2),
+        hz: task.hz.toFixed(2),
+        startSync: task.startSyncTotal,
+        moreSymbols: task.moreSymbolsTotal,
+        requestAll: task.requestAllTotal,
+        requestMaybeSync: task.requestMaybeSyncTotal,
+        requestMaybeSyncCoordinate: task.requestMaybeSyncCoordinateTotal,
+    })));
+}
+if (failures.length > 0) {
+    throw new Error(`sync-batch-sweep assertions failed:\n- ${failures.join("\n- ")}`);
+}
+//# sourceMappingURL=sync-batch-sweep.js.map

package/dist/benchmark/sync-batch-sweep.js.map

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

package/dist/src/fanout-envelope.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Application-level envelope for fanout-delivered shared-log messages.
+ *
+ * FanoutTree's data-plane forwarding makes the root the transport-level origin
+ * when proxy-publishing. Shared-log needs a stable publisher identity and
+ * timestamp regardless of which overlay hop forwarded the bytes.
+ */
+export declare class FanoutEnvelope {
+    from: string;
+    timestamp: bigint;
+    payload: Uint8Array;
+    constructor(props: {
+        from: string;
+        timestamp: bigint;
+        payload: Uint8Array;
+    });
+}
+//# sourceMappingURL=fanout-envelope.d.ts.map

package/dist/src/fanout-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout-envelope.d.ts","sourceRoot":"","sources":["../../src/fanout-envelope.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBACa,cAAc;IAE1B,IAAI,EAAE,MAAM,CAAC;IAGb,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,UAAU,CAAC;gBAER,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE;CAK3E"}

package/dist/src/fanout-envelope.js

@@ -0,0 +1,85 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { field, variant } from "@dao-xyz/borsh";
+/**
+ * Application-level envelope for fanout-delivered shared-log messages.
+ *
+ * FanoutTree's data-plane forwarding makes the root the transport-level origin
+ * when proxy-publishing. Shared-log needs a stable publisher identity and
+ * timestamp regardless of which overlay hop forwarded the bytes.
+ */
+let FanoutEnvelope = (() => {
+    let _classDecorators = [variant(0)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _from_decorators;
+    let _from_initializers = [];
+    let _from_extraInitializers = [];
+    let _timestamp_decorators;
+    let _timestamp_initializers = [];
+    let _timestamp_extraInitializers = [];
+    let _payload_decorators;
+    let _payload_initializers = [];
+    let _payload_extraInitializers = [];
+    var FanoutEnvelope = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _from_decorators = [field({ type: "string" })];
+            _timestamp_decorators = [field({ type: "u64" })];
+            _payload_decorators = [field({ type: Uint8Array })];
+            __esDecorate(null, null, _from_decorators, { kind: "field", name: "from", static: false, private: false, access: { has: obj => "from" in obj, get: obj => obj.from, set: (obj, value) => { obj.from = value; } }, metadata: _metadata }, _from_initializers, _from_extraInitializers);
+            __esDecorate(null, null, _timestamp_decorators, { kind: "field", name: "timestamp", static: false, private: false, access: { has: obj => "timestamp" in obj, get: obj => obj.timestamp, set: (obj, value) => { obj.timestamp = value; } }, metadata: _metadata }, _timestamp_initializers, _timestamp_extraInitializers);
+            __esDecorate(null, null, _payload_decorators, { kind: "field", name: "payload", static: false, private: false, access: { has: obj => "payload" in obj, get: obj => obj.payload, set: (obj, value) => { obj.payload = value; } }, metadata: _metadata }, _payload_initializers, _payload_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            FanoutEnvelope = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        from = __runInitializers(this, _from_initializers, void 0); // publisher publicKey hash
+        timestamp = (__runInitializers(this, _from_extraInitializers), __runInitializers(this, _timestamp_initializers, void 0)); // publisher-supplied timestamp
+        payload = (__runInitializers(this, _timestamp_extraInitializers), __runInitializers(this, _payload_initializers, void 0)); // serialized TransportMessage
+        constructor(props) {
+            __runInitializers(this, _payload_extraInitializers);
+            this.from = props.from;
+            this.timestamp = props.timestamp;
+            this.payload = props.payload;
+        }
+    };
+    return FanoutEnvelope = _classThis;
+})();
+export { FanoutEnvelope };
+//# sourceMappingURL=fanout-envelope.js.map

package/dist/src/fanout-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout-envelope.js","sourceRoot":"","sources":["../../src/fanout-envelope.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;IAEU,cAAc;4BAD1B,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;gCAET,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;qCAGzB,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;mCAGtB,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAL5B,8JAAA,IAAI,6BAAJ,IAAI,mFAAS;YAGb,6KAAA,SAAS,6BAAT,SAAS,6FAAS;YAGlB,uKAAA,OAAO,6BAAP,OAAO,yFAAa;YARrB,6KAeC;;;YAfY,uDAAc;;QAE1B,IAAI,uDAAS,CAAC,2BAA2B;QAGzC,SAAS,gHAAS,CAAC,+BAA+B;QAGlD,OAAO,mHAAa,CAAC,8BAA8B;QAEnD,YAAY,KAA+D;;YAC1E,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACvB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YACjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;SAC7B;;;;SAdW,cAAc"}

package/dist/src/index.d.ts

@@ -2,6 +2,7 @@ import { PublicSignKey } from "@peerbit/crypto";
 import { type Index } from "@peerbit/indexer-interface";
 import { type AppendOptions, type Change, Entry, Log, type LogEvents, type LogProperties, Meta, ShallowEntry, type ShallowOrFullEntry } from "@peerbit/log";
 import { Program, type ProgramEvents } from "@peerbit/program";
+import { type FanoutTreeChannelOptions, type FanoutTreeJoinOptions } from "@peerbit/pubsub";
 import { SubscriptionEvent, UnsubcriptionEvent } from "@peerbit/pubsub-interface";
 import { RPC, type RequestContext } from "@peerbit/rpc";
 import { BlocksMessage } from "./blocks.js";
@@ -101,6 +102,7 @@ export type SharedLogOptions<T, D extends ReplicationDomain<any, T, R>, R extend
     eagerBlocks?: boolean | {
         cacheSize?: number;
     };
+    fanout?: SharedLogFanoutOptions;
 };
 export declare const DEFAULT_MIN_REPLICAS = 2;
 export declare const WAIT_FOR_REPLICATOR_TIMEOUT = 20000;
@@ -109,20 +111,30 @@ export declare const WAIT_FOR_REPLICATOR_REQUEST_INTERVAL = 1000;
 export declare const WAIT_FOR_REPLICATOR_REQUEST_MIN_ATTEMPTS = 3;
 export declare const WAIT_FOR_PRUNE_DELAY = 0;
 export type Args<T, D extends ReplicationDomain<any, T, R>, R extends "u32" | "u64" = D extends ReplicationDomain<any, T, infer I> ? I : "u32"> = LogProperties<T> & LogEvents<T> & SharedLogOptions<T, D, R>;
+export type DeliveryReliability = "ack" | "best-effort";
 export type DeliveryOptions = {
-    settle?: true | {
-        min: number;
-    };
+    reliability?: DeliveryReliability;
+    minAcks?: number;
     requireRecipients?: boolean;
     timeout?: number;
     signal?: AbortSignal;
 };
-export type SharedAppendOptions<T> = AppendOptions<T> & {
+export type SharedLogFanoutOptions = {
+    root?: string;
+    channel?: Partial<Omit<FanoutTreeChannelOptions, "role">>;
+    join?: FanoutTreeJoinOptions;
+};
+type SharedAppendBaseOptions<T> = AppendOptions<T> & {
     replicas?: AbsoluteReplicas | number;
     replicate?: boolean;
-    target?: "all" | "replicators" | "none";
-    delivery?: false | true | DeliveryOptions;
 };
+export type SharedAppendOptions<T> = (SharedAppendBaseOptions<T> & {
+    target?: "replicators" | "none";
+    delivery?: false | true | DeliveryOptions;
+}) | (SharedAppendBaseOptions<T> & {
+    target: "all";
+    delivery?: false | undefined;
+});
 export type ReplicatorJoinEvent = {
     publicKey: PublicSignKey;
 };
@@ -151,10 +163,15 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
     private coordinateToHash;
     private recentlyRebalanced;
     uniqueReplicators: Set<string>;
+    private _replicatorJoinEmitted;
     private _replicatorsReconciled;
     _gidPeersHistory: Map<string, Set<string>>;
     private _onSubscriptionFn;
     private _onUnsubscriptionFn;
+    private _onFanoutDataFn?;
+    private _onFanoutUnicastFn?;
+    private _fanoutChannel?;
+    private _providerHandle?;
     private _isTrustedReplicator?;
     private _logProperties?;
     private _closeController;
@@ -166,6 +183,9 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
         timeout: ReturnType<typeof setTimeout>;
     }>>;
     private latestReplicationInfoMessage;
+    private _replicationInfoBlockedPeers;
+    private _replicationInfoRequestByPeer;
+    private _replicationInfoApplyQueueByPeer;
     private remoteBlocks;
     private openTime;
     private oldestOpenTime;
@@ -178,7 +198,13 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
     private responseToPruneDebouncedFn;
     private _requestIPruneSent;
     private _requestIPruneResponseReplicatorSet;
+    private _checkedPruneRetries;
     private replicationChangeDebounceFn;
+    private _repairRetryTimers;
+    private _recentRepairDispatch;
+    private _repairSweepRunning;
+    private _repairSweepForceFreshPending;
+    private _repairSweepAddedPeersPending;
     private distributeQueue?;
     syncronizer: Syncronizer<R>;
     replicas: ReplicationLimits;
@@ -189,6 +215,7 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
     waitForReplicatorRequestMaxAttempts?: number;
     waitForPruneDelay: number;
     distributionDebounceTime: number;
+    repairSweepTargetBufferSize: number;
     replicationController: PIDReplicationController;
     history: {
         usedMemory: number;
@@ -203,6 +230,20 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
     get compatibility(): number | undefined;
     get isAdaptiveReplicating(): boolean;
     private get v8Behaviour();
+    private getFanoutChannelOptions;
+    private _openFanoutChannel;
+    private _closeFanoutChannel;
+    private _onFanoutData;
+    private _onFanoutUnicast;
+    private _publishExchangeHeadsViaFanout;
+    private _parseDeliveryOptions;
+    private _getSortedRouteHints;
+    private _sendAckWithUnifiedHints;
+    private _appendDeliverToReplicators;
+    private _mergeLeadersFromGidReferences;
+    private _appendDeliverToAllFanout;
+    private _resolvePublicKeyFromHash;
+    private _getTopicSubscribers;
     private getRole;
     isReplicating(): Promise<boolean>;
     private setupRebalanceDebounceFunction;
@@ -231,7 +272,12 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
     }): Promise<void>;
     private removePeerFromGidPeerHistory;
     addPeersToGidPeerHistory(gid: string, publicKeys: Iterable<string>, reset?: boolean): Set<string>;
+    private dispatchMaybeMissingEntries;
+    private scheduleRepairSweep;
+    private runRepairSweep;
     private pruneDebouncedFnAddIfNotKeeping;
+    private clearCheckedPruneRetry;
+    private scheduleCheckedPruneRetry;
     append(data: T, options?: SharedAppendOptions<T> | undefined): Promise<{
         entry: Entry<T>;
         removed: ShallowOrFullEntry<T>[];
@@ -345,6 +391,9 @@ export declare class SharedLog<T, D extends ReplicationDomain<any, T, R> = any,
         candidates?: string[];
         roleAge?: number;
     }): Promise<boolean>;
+    private withReplicationInfoApplyQueue;
+    private cancelReplicationInfoRequests;
+    private scheduleReplicationInfoRequests;
     handleSubscriptionChange(publicKey: PublicSignKey, topics: string[], subscribed: boolean): Promise<void>;
     private getClampedReplicas;
     private removePruneRequestSent;