@hashtree/worker 0.2.1 → 0.2.2

package/dist/capabilities/connectivity.js

@@ -0,0 +1,49 @@
+const PROBE_TIMEOUT_MS = 3500;
+const DUMMY_HASH = '0000000000000000000000000000000000000000000000000000000000000000';
+function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+async function probe(url) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), PROBE_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, {
+            method: 'HEAD',
+            // Connectivity checks should not fail just because cross-origin response
+            // headers are restricted. If the fetch resolves in no-cors mode, the
+            // endpoint is reachable.
+            mode: 'no-cors',
+            signal: controller.signal,
+            cache: 'no-store',
+        });
+        if (res.type === 'opaque') {
+            return true;
+        }
+        return res.status >= 100;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export async function probeConnectivity(servers) {
+    const readServers = servers.filter(server => server.read !== false);
+    const writeServers = servers.filter(server => server.write);
+    const [readResults, writeResults] = await Promise.all([
+        Promise.all(readServers.map(server => probe(`${stripTrailingSlash(server.url)}/${DUMMY_HASH}.bin`))),
+        Promise.all(writeServers.map(server => probe(`${stripTrailingSlash(server.url)}/upload`))),
+    ]);
+    const reachableReadServers = readResults.filter(Boolean).length;
+    const reachableWriteServers = writeResults.filter(Boolean).length;
+    return {
+        online: typeof navigator === 'undefined' ? true : navigator.onLine,
+        reachableReadServers,
+        totalReadServers: readServers.length,
+        reachableWriteServers,
+        totalWriteServers: writeServers.length,
+        updatedAt: Date.now(),
+    };
+}
+//# sourceMappingURL=connectivity.js.map

package/dist/capabilities/connectivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.js","sourceRoot":"","sources":["../../src/capabilities/connectivity.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,UAAU,GAAG,kEAAkE,CAAC;AAEtF,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,GAAW;IAC9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,yEAAyE;YACzE,qEAAqE;YACrE,yBAAyB;YACzB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA8B;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5D,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,MAAM,CAAC,CAAC,CAAC;QACpG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;KAC3F,CAAC,CAAC;IAEH,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,qBAAqB,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAElE,OAAO;QACL,MAAM,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM;QAClE,oBAAoB;QACpB,gBAAgB,EAAE,WAAW,CAAC,MAAM;QACpC,qBAAqB;QACrB,iBAAiB,EAAE,YAAY,CAAC,MAAM;QACtC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/capabilities/idbStorage.d.ts

@@ -0,0 +1,25 @@
+export interface StorageStats {
+    items: number;
+    bytes: number;
+    maxBytes: number;
+}
+export declare class IdbBlobStorage {
+    private readonly store;
+    private maxBytes;
+    private writesSinceEviction;
+    private evictionPromise;
+    private static readonly EVICTION_WRITE_INTERVAL;
+    constructor(dbName: string, maxBytes: number);
+    setMaxBytes(maxBytes: number): void;
+    getMaxBytes(): number;
+    put(data: Uint8Array): Promise<string>;
+    putByHash(hashHex: string, data: Uint8Array): Promise<void>;
+    putByHashTrusted(hashHex: string, data: Uint8Array): Promise<void>;
+    get(hashHex: string): Promise<Uint8Array | null>;
+    has(hashHex: string): Promise<boolean>;
+    delete(hashHex: string): Promise<boolean>;
+    getStats(): Promise<StorageStats>;
+    close(): void;
+    private scheduleEviction;
+}
+//# sourceMappingURL=idbStorage.d.ts.map

package/dist/capabilities/idbStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idbStorage.d.ts","sourceRoot":"","sources":["../../src/capabilities/idbStorage.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAA8B;IAErD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAM;gBAEzC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,WAAW,IAAI,MAAM;IAIf,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIhD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAQvC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,gBAAgB;CAkBzB"}

package/dist/capabilities/idbStorage.js

@@ -0,0 +1,73 @@
+import { fromHex, sha256, toHex } from '@hashtree/core';
+import { DexieStore } from '@hashtree/dexie';
+export class IdbBlobStorage {
+    store;
+    maxBytes;
+    writesSinceEviction = 0;
+    evictionPromise = null;
+    static EVICTION_WRITE_INTERVAL = 32;
+    constructor(dbName, maxBytes) {
+        this.store = new DexieStore(dbName);
+        this.maxBytes = maxBytes;
+    }
+    setMaxBytes(maxBytes) {
+        this.maxBytes = maxBytes;
+    }
+    getMaxBytes() {
+        return this.maxBytes;
+    }
+    async put(data) {
+        const hashHex = toHex(await sha256(data));
+        await this.store.put(fromHex(hashHex), data);
+        void this.scheduleEviction();
+        return hashHex;
+    }
+    async putByHash(hashHex, data) {
+        const computed = toHex(await sha256(data));
+        if (computed !== hashHex) {
+            throw new Error('Hash mismatch while caching fetched blob');
+        }
+        await this.store.put(fromHex(hashHex), data);
+        void this.scheduleEviction();
+    }
+    async putByHashTrusted(hashHex, data) {
+        await this.store.put(fromHex(hashHex), data);
+        void this.scheduleEviction();
+    }
+    async get(hashHex) {
+        return this.store.get(fromHex(hashHex));
+    }
+    async has(hashHex) {
+        return this.store.has(fromHex(hashHex));
+    }
+    async delete(hashHex) {
+        return this.store.delete(fromHex(hashHex));
+    }
+    async getStats() {
+        const [items, bytes] = await Promise.all([
+            this.store.count(),
+            this.store.totalBytes(),
+        ]);
+        return { items, bytes, maxBytes: this.maxBytes };
+    }
+    close() {
+        this.store.close();
+    }
+    scheduleEviction() {
+        this.writesSinceEviction += 1;
+        if (this.writesSinceEviction < IdbBlobStorage.EVICTION_WRITE_INTERVAL) {
+            return;
+        }
+        this.writesSinceEviction = 0;
+        if (this.evictionPromise) {
+            return;
+        }
+        this.evictionPromise = this.store
+            .evict(this.maxBytes)
+            .then(() => { })
+            .finally(() => {
+            this.evictionPromise = null;
+        });
+    }
+}
+//# sourceMappingURL=idbStorage.js.map

package/dist/capabilities/idbStorage.js.map

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

package/dist/capabilities/meshRouterStore.d.ts

@@ -0,0 +1,71 @@
+import type { Hash, Store } from '@hashtree/core';
+import { type RequestDispatchConfig } from '@hashtree/nostr';
+export interface MeshReadSource {
+    id: string;
+    get(hash: Hash): Promise<Uint8Array | null>;
+    isAvailable?: () => boolean;
+}
+export interface MeshRouterGetOptions {
+    sourceIds?: readonly string[];
+    skipPrimary?: boolean;
+}
+export interface MeshRouterGetResult {
+    data: Uint8Array;
+    sourceId: string;
+}
+export interface MeshRouterStoreConfig {
+    primary: Store;
+    sources?: MeshReadSource[];
+    dispatch?: RequestDispatchConfig;
+    requestTimeoutMs?: number;
+    primarySourceId?: string;
+}
+interface SourceStats {
+    requests: number;
+    successes: number;
+    misses: number;
+    failures: number;
+    timeouts: number;
+    srttMs: number;
+    rttvarMs: number;
+    backoffLevel: number;
+    backedOffUntilMs?: number;
+    lastSuccessMs?: number;
+    lastFailureMs?: number;
+}
+export declare class MeshRouterStore implements Store {
+    private readonly primary;
+    private readonly primarySourceId;
+    private readonly dispatch;
+    private readonly requestTimeoutMs;
+    private readonly sources;
+    private readonly statsBySource;
+    private readonly inflightReads;
+    constructor(config: MeshRouterStoreConfig);
+    setSources(sources: MeshReadSource[]): void;
+    addSource(source: MeshReadSource): void;
+    removeSource(sourceId: string): void;
+    getDetailed(hash: Hash, options?: MeshRouterGetOptions): Promise<MeshRouterGetResult | null>;
+    getSourceStats(): Record<string, SourceStats>;
+    put(hash: Hash, data: Uint8Array): Promise<boolean>;
+    get(hash: Hash): Promise<Uint8Array | null>;
+    has(hash: Hash): Promise<boolean>;
+    delete(hash: Hash): Promise<boolean>;
+    private pendingReadKey;
+    private getCandidateSources;
+    private orderedSources;
+    private shouldProbeMultipleSources;
+    private dispatchFor;
+    private createInFlightSourceRequest;
+    private waitForNextResult;
+    private loadFromSources;
+    private statsFor;
+    private recordRequest;
+    private recordMiss;
+    private recordSuccess;
+    private recordFailure;
+    private recordTimeout;
+    private applyBackoff;
+}
+export {};
+//# sourceMappingURL=meshRouterStore.d.ts.map

package/dist/capabilities/meshRouterStore.d.ts.map

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

package/dist/capabilities/meshRouterStore.js

@@ -0,0 +1,316 @@
+import { toHex } from '@hashtree/core';
+import { buildHedgedWavePlan, normalizeDispatchConfig, } from '@hashtree/nostr';
+const DEFAULT_DISPATCH = {
+    initialFanout: 1,
+    hedgeFanout: 1,
+    maxFanout: 4,
+    hedgeIntervalMs: 75,
+};
+const DEFAULT_REQUEST_TIMEOUT_MS = 5_500;
+const INITIAL_BACKOFF_MS = 250;
+const MAX_BACKOFF_MS = 10_000;
+const SCORE_TIE_DELTA = 0.15;
+function defaultStats() {
+    return {
+        requests: 0,
+        successes: 0,
+        misses: 0,
+        failures: 0,
+        timeouts: 0,
+        srttMs: 0,
+        rttvarMs: 0,
+        backoffLevel: 0,
+    };
+}
+function reliabilityScore(stats) {
+    return (stats.successes + 1) / (stats.requests + 2);
+}
+function latencyScore(stats) {
+    if (stats.srttMs <= 0)
+        return 0.5;
+    return Math.min(1, 500 / (stats.srttMs + 50));
+}
+function hasHistory(stats) {
+    return stats.requests > 0 || stats.successes > 0 || stats.misses > 0 || stats.failures > 0 || stats.timeouts > 0;
+}
+function scoreSource(stats, now) {
+    if (stats.backedOffUntilMs && stats.backedOffUntilMs > now) {
+        return Number.NEGATIVE_INFINITY;
+    }
+    const missPenalty = stats.requests > 0 ? (stats.misses / stats.requests) * 0.15 : 0;
+    const failurePenalty = stats.requests > 0 ? ((stats.failures + stats.timeouts) / stats.requests) * 0.3 : 0;
+    const recencyBonus = stats.lastSuccessMs && now - stats.lastSuccessMs < 60_000
+        ? 0.1
+        : 0;
+    return (0.6 * reliabilityScore(stats) +
+        0.3 * latencyScore(stats) +
+        recencyBonus -
+        missPenalty -
+        failurePenalty);
+}
+export class MeshRouterStore {
+    primary;
+    primarySourceId;
+    dispatch;
+    requestTimeoutMs;
+    sources = new Map();
+    statsBySource = new Map();
+    inflightReads = new Map();
+    constructor(config) {
+        this.primary = config.primary;
+        this.primarySourceId = config.primarySourceId ?? 'primary';
+        this.dispatch = config.dispatch ?? DEFAULT_DISPATCH;
+        this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.setSources(config.sources ?? []);
+    }
+    setSources(sources) {
+        this.sources.clear();
+        for (const source of sources) {
+            this.sources.set(source.id, source);
+            this.statsBySource.set(source.id, this.statsBySource.get(source.id) ?? defaultStats());
+        }
+    }
+    addSource(source) {
+        this.sources.set(source.id, source);
+        this.statsBySource.set(source.id, this.statsBySource.get(source.id) ?? defaultStats());
+    }
+    removeSource(sourceId) {
+        this.sources.delete(sourceId);
+    }
+    async getDetailed(hash, options = {}) {
+        if (!options.skipPrimary) {
+            const local = await this.primary.get(hash);
+            if (local) {
+                return { data: local, sourceId: this.primarySourceId };
+            }
+        }
+        const pendingKey = this.pendingReadKey(hash, options);
+        let pending = this.inflightReads.get(pendingKey);
+        if (!pending) {
+            pending = this.loadFromSources(hash, options).finally(() => {
+                if (this.inflightReads.get(pendingKey) === pending) {
+                    this.inflightReads.delete(pendingKey);
+                }
+            });
+            this.inflightReads.set(pendingKey, pending);
+        }
+        return pending;
+    }
+    getSourceStats() {
+        return Object.fromEntries(Array.from(this.statsBySource.entries()).map(([sourceId, stats]) => [sourceId, { ...stats }]));
+    }
+    async put(hash, data) {
+        return this.primary.put(hash, data);
+    }
+    async get(hash) {
+        return (await this.getDetailed(hash))?.data ?? null;
+    }
+    async has(hash) {
+        return this.primary.has(hash);
+    }
+    async delete(hash) {
+        return this.primary.delete(hash);
+    }
+    pendingReadKey(hash, options) {
+        const sourceKey = options.sourceIds && options.sourceIds.length > 0
+            ? [...options.sourceIds].sort().join(',')
+            : '*';
+        return `${toHex(hash)}:${options.skipPrimary === true ? 'skip-primary' : 'with-primary'}:${sourceKey}`;
+    }
+    getCandidateSources(sourceIds) {
+        const requested = sourceIds && sourceIds.length > 0
+            ? new Set(sourceIds)
+            : null;
+        const available = Array.from(this.sources.values()).filter((source) => {
+            if (requested && !requested.has(source.id))
+                return false;
+            return source.isAvailable ? source.isAvailable() : true;
+        });
+        if (available.length === 0)
+            return [];
+        const now = Date.now();
+        const healthy = available.filter((source) => {
+            const stats = this.statsBySource.get(source.id) ?? defaultStats();
+            return !stats.backedOffUntilMs || stats.backedOffUntilMs <= now;
+        });
+        return healthy.length > 0 ? healthy : available;
+    }
+    orderedSources(sourceIds) {
+        const now = Date.now();
+        const candidates = this.getCandidateSources(sourceIds);
+        return candidates.sort((left, right) => {
+            const leftStats = this.statsBySource.get(left.id) ?? defaultStats();
+            const rightStats = this.statsBySource.get(right.id) ?? defaultStats();
+            const scoreDiff = scoreSource(rightStats, now) - scoreSource(leftStats, now);
+            if (scoreDiff !== 0)
+                return scoreDiff;
+            return left.id.localeCompare(right.id);
+        });
+    }
+    shouldProbeMultipleSources(orderedSources) {
+        if (orderedSources.length <= 1)
+            return false;
+        const [best, secondBest] = orderedSources;
+        const bestStats = this.statsBySource.get(best.id) ?? defaultStats();
+        const secondStats = this.statsBySource.get(secondBest.id) ?? defaultStats();
+        if (!hasHistory(bestStats) || !hasHistory(secondStats)) {
+            return true;
+        }
+        const now = Date.now();
+        const diff = scoreSource(bestStats, now) - scoreSource(secondStats, now);
+        return diff < SCORE_TIE_DELTA;
+    }
+    dispatchFor(sourceCount, orderedSources) {
+        const probeMultiple = this.shouldProbeMultipleSources(orderedSources);
+        const initialFanout = probeMultiple
+            ? Math.min(sourceCount, 2)
+            : 1;
+        return {
+            initialFanout,
+            hedgeFanout: this.dispatch.hedgeFanout,
+            maxFanout: Math.min(this.dispatch.maxFanout, sourceCount),
+            hedgeIntervalMs: this.dispatch.hedgeIntervalMs,
+        };
+    }
+    createInFlightSourceRequest(source, hash) {
+        const startedAt = Date.now();
+        this.recordRequest(source.id);
+        const task = {
+            source,
+            settled: false,
+            timeoutRecorded: false,
+            promise: Promise.resolve({ sourceId: source.id, data: null }),
+        };
+        task.promise = source.get(hash)
+            .then(async (data) => {
+            const elapsedMs = Math.max(1, Date.now() - startedAt);
+            if (data) {
+                this.recordSuccess(source.id, elapsedMs);
+                await this.primary.put(hash, data).catch(() => false);
+                return { sourceId: source.id, data };
+            }
+            if (!task.timeoutRecorded) {
+                this.recordMiss(source.id);
+            }
+            return { sourceId: source.id, data: null };
+        })
+            .catch(() => {
+            if (!task.timeoutRecorded) {
+                this.recordFailure(source.id);
+            }
+            return { sourceId: source.id, data: null };
+        });
+        return task;
+    }
+    async waitForNextResult(inFlight, waitMs) {
+        const active = inFlight.filter((task) => !task.settled);
+        if (active.length === 0 || waitMs <= 0)
+            return null;
+        const timeout = new Promise((resolve) => {
+            setTimeout(() => resolve(null), waitMs);
+        });
+        const result = await Promise.race([
+            timeout,
+            ...active.map((task) => task.promise.then((value) => ({ task, ...value }))),
+        ]);
+        if (!result)
+            return null;
+        result.task.settled = true;
+        return result;
+    }
+    async loadFromSources(hash, options) {
+        const orderedSources = this.orderedSources(options.sourceIds);
+        if (orderedSources.length === 0) {
+            return null;
+        }
+        const dispatch = normalizeDispatchConfig(this.dispatchFor(orderedSources.length, orderedSources), orderedSources.length);
+        const wavePlan = buildHedgedWavePlan(orderedSources.length, dispatch);
+        if (wavePlan.length === 0)
+            return null;
+        const deadline = Date.now() + this.requestTimeoutMs;
+        const inFlight = [];
+        let nextSourceIdx = 0;
+        for (let waveIdx = 0; waveIdx < wavePlan.length; waveIdx++) {
+            const waveSize = wavePlan[waveIdx];
+            const from = nextSourceIdx;
+            const to = Math.min(from + waveSize, orderedSources.length);
+            nextSourceIdx = to;
+            for (const source of orderedSources.slice(from, to)) {
+                inFlight.push(this.createInFlightSourceRequest(source, hash));
+            }
+            const isLastWave = waveIdx === wavePlan.length - 1 || nextSourceIdx >= orderedSources.length;
+            const windowEnd = isLastWave
+                ? deadline
+                : Math.min(deadline, Date.now() + dispatch.hedgeIntervalMs);
+            while (Date.now() < windowEnd) {
+                const remaining = windowEnd - Date.now();
+                const result = await this.waitForNextResult(inFlight, remaining);
+                if (!result)
+                    break;
+                if (result.data) {
+                    return {
+                        data: result.data,
+                        sourceId: result.sourceId,
+                    };
+                }
+            }
+            if (Date.now() >= deadline) {
+                break;
+            }
+        }
+        for (const task of inFlight) {
+            if (task.settled)
+                continue;
+            task.timeoutRecorded = true;
+            this.recordTimeout(task.source.id);
+        }
+        return null;
+    }
+    statsFor(sourceId) {
+        const stats = this.statsBySource.get(sourceId);
+        if (stats)
+            return stats;
+        const created = defaultStats();
+        this.statsBySource.set(sourceId, created);
+        return created;
+    }
+    recordRequest(sourceId) {
+        this.statsFor(sourceId).requests += 1;
+    }
+    recordMiss(sourceId) {
+        this.statsFor(sourceId).misses += 1;
+    }
+    recordSuccess(sourceId, elapsedMs) {
+        const stats = this.statsFor(sourceId);
+        const now = Date.now();
+        stats.successes += 1;
+        stats.lastSuccessMs = now;
+        stats.backoffLevel = 0;
+        stats.backedOffUntilMs = undefined;
+        if (stats.srttMs === 0) {
+            stats.srttMs = elapsedMs;
+            stats.rttvarMs = elapsedMs / 2;
+            return;
+        }
+        stats.rttvarMs = 0.75 * stats.rttvarMs + 0.25 * Math.abs(stats.srttMs - elapsedMs);
+        stats.srttMs = 0.875 * stats.srttMs + 0.125 * elapsedMs;
+    }
+    recordFailure(sourceId) {
+        const stats = this.statsFor(sourceId);
+        stats.failures += 1;
+        stats.lastFailureMs = Date.now();
+        this.applyBackoff(stats);
+    }
+    recordTimeout(sourceId) {
+        const stats = this.statsFor(sourceId);
+        stats.timeouts += 1;
+        stats.lastFailureMs = Date.now();
+        this.applyBackoff(stats);
+    }
+    applyBackoff(stats) {
+        stats.backoffLevel += 1;
+        const backoffMs = Math.min(MAX_BACKOFF_MS, INITIAL_BACKOFF_MS * (2 ** Math.max(0, stats.backoffLevel - 1)));
+        stats.backedOffUntilMs = Date.now() + backoffMs;
+    }
+}
+//# sourceMappingURL=meshRouterStore.js.map

package/dist/capabilities/meshRouterStore.js.map

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

package/dist/capabilities/rootResolver.d.ts

@@ -0,0 +1,10 @@
+import type { CID, HashTree } from '@hashtree/core';
+export declare const DEFAULT_ROOT_RESOLVE_TIMEOUT_MS = 15000;
+export declare const DEFAULT_ROOT_RESOLVE_SETTLE_MS = 500;
+export interface RootWatchHandle {
+    initialCid: CID | null;
+    close(): Promise<void>;
+}
+export declare function watchRootPathFromRelays(tree: Pick<HashTree, 'resolvePath'> | null, relays: string[] | undefined, npub: string, path: string | undefined, onUpdate: (cid: CID | null) => void | Promise<void>, timeoutMs?: number, settleMs?: number): Promise<RootWatchHandle>;
+export declare function resolveRootPathFromRelays(tree: Pick<HashTree, 'resolvePath'> | null, relays: string[] | undefined, npub: string, path?: string, timeoutMs?: number, settleMs?: number): Promise<CID | null>;
+//# sourceMappingURL=rootResolver.d.ts.map

package/dist/capabilities/rootResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootResolver.d.ts","sourceRoot":"","sources":["../../src/capabilities/rootResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAIpD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AA8DlD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAuPD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,IAAI,EAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACnD,SAAS,GAAE,MAAwC,EACnD,QAAQ,GAAE,MAAuC,GAChD,OAAO,CAAC,eAAe,CAAC,CA+I1B;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,IAAI,EAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,GAAE,MAAwC,EACnD,QAAQ,GAAE,MAAuC,GAChD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAmBrB"}