@hashtree/worker 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sirius Business Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @hashtree/worker
+
+Modular browser worker for hashtree blob caching and Blossom connectivity.
+
+Runs hashtree storage operations in a Web Worker to keep the main thread free. Handles IndexedDB caching, Blossom server uploads/downloads, connectivity probing, and WebRTC P2P data exchange.
+
+## Install
+
+```bash
+npm install @hashtree/worker
+```
+
+## Usage
+
+```typescript
+import { HashtreeWorkerClient } from '@hashtree/worker';
+
+const client = new HashtreeWorkerClient({ workerFactory });
+
+await client.configure({
+  blossomServers: [{ url: 'https://upload.iris.to', read: true, write: true }],
+});
+
+// Store and retrieve blobs
+await client.put(hash, data);
+const blob = await client.get(hash);
+```
+
+## Exports
+
+- `@hashtree/worker` — `HashtreeWorkerClient` for main-thread use
+- `@hashtree/worker/p2p` — `WebRTCController` / `WebRTCProxy` for P2P data channel management
+- `@hashtree/worker/entry` — Worker entry point
+- `@hashtree/worker/protocol` — Shared message types between main thread and worker
+
+## License
+
+MIT

package/dist/capabilities/blossomBandwidthTracker.d.ts

@@ -0,0 +1,26 @@
+import type { BlossomLogEntry } from '@hashtree/core';
+export interface BlossomBandwidthServerStats {
+    url: string;
+    bytesSent: number;
+    bytesReceived: number;
+}
+export interface BlossomBandwidthStats {
+    totalBytesSent: number;
+    totalBytesReceived: number;
+    updatedAt: number;
+    servers: BlossomBandwidthServerStats[];
+}
+export type BlossomBandwidthUpdateHandler = (stats: BlossomBandwidthStats) => void;
+export declare class BlossomBandwidthTracker {
+    private totalBytesSent;
+    private totalBytesReceived;
+    private readonly serverBandwidth;
+    private readonly onUpdate?;
+    private readonly now;
+    constructor(onUpdate?: BlossomBandwidthUpdateHandler, now?: () => number);
+    apply(entry: BlossomLogEntry): void;
+    getStats(): BlossomBandwidthStats;
+    reset(): void;
+    private getOrderedServerBandwidth;
+}
+//# sourceMappingURL=blossomBandwidthTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blossomBandwidthTracker.d.ts","sourceRoot":"","sources":["../../src/capabilities/blossomBandwidthTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,2BAA2B,EAAE,CAAC;CACxC;AAED,MAAM,MAAM,6BAA6B,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAEnF,qBAAa,uBAAuB;IAClC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmE;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,QAAQ,CAAC,EAAE,6BAA6B,EAAE,GAAG,GAAE,MAAM,MAAyB;IAK1F,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAoBnC,QAAQ,IAAI,qBAAqB;IASjC,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,yBAAyB;CASlC"}

package/dist/capabilities/blossomBandwidthTracker.js

@@ -0,0 +1,53 @@
+export class BlossomBandwidthTracker {
+    totalBytesSent = 0;
+    totalBytesReceived = 0;
+    serverBandwidth = new Map();
+    onUpdate;
+    now;
+    constructor(onUpdate, now = () => Date.now()) {
+        this.onUpdate = onUpdate;
+        this.now = now;
+    }
+    apply(entry) {
+        const bytes = entry.bytes ?? 0;
+        if (!entry.success || bytes <= 0)
+            return;
+        const serverStats = this.serverBandwidth.get(entry.server) ?? { bytesSent: 0, bytesReceived: 0 };
+        if (entry.operation === 'put') {
+            this.totalBytesSent += bytes;
+            serverStats.bytesSent += bytes;
+        }
+        else if (entry.operation === 'get') {
+            this.totalBytesReceived += bytes;
+            serverStats.bytesReceived += bytes;
+        }
+        else {
+            return;
+        }
+        this.serverBandwidth.set(entry.server, serverStats);
+        this.onUpdate?.(this.getStats());
+    }
+    getStats() {
+        return {
+            totalBytesSent: this.totalBytesSent,
+            totalBytesReceived: this.totalBytesReceived,
+            updatedAt: this.now(),
+            servers: this.getOrderedServerBandwidth(),
+        };
+    }
+    reset() {
+        this.totalBytesSent = 0;
+        this.totalBytesReceived = 0;
+        this.serverBandwidth.clear();
+    }
+    getOrderedServerBandwidth() {
+        return Array.from(this.serverBandwidth.entries())
+            .map(([url, stats]) => ({
+            url,
+            bytesSent: stats.bytesSent,
+            bytesReceived: stats.bytesReceived,
+        }))
+            .sort((a, b) => a.url.localeCompare(b.url));
+    }
+}
+//# sourceMappingURL=blossomBandwidthTracker.js.map

package/dist/capabilities/blossomBandwidthTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blossomBandwidthTracker.js","sourceRoot":"","sources":["../../src/capabilities/blossomBandwidthTracker.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,uBAAuB;IAC1B,cAAc,GAAG,CAAC,CAAC;IACnB,kBAAkB,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,IAAI,GAAG,EAAwD,CAAC;IAClF,QAAQ,CAAiC;IACzC,GAAG,CAAe;IAEnC,YAAY,QAAwC,EAAE,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACxF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAsB;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO;QAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAEjG,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC;YAC7B,WAAW,CAAC,SAAS,IAAI,KAAK,CAAC;QACjC,CAAC;aAAM,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC;YACjC,WAAW,CAAC,aAAa,IAAI,KAAK,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO;QACT,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ;QACN,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,IAAI,CAAC,yBAAyB,EAAE;SAC1C,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEO,yBAAyB;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;aAC9C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,GAAG;YACH,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/capabilities/blossomTransport.d.ts

@@ -0,0 +1,22 @@
+import { BlossomStore, type BlossomUploadCallback } from '@hashtree/core';
+import type { BlossomServerConfig } from '../protocol.js';
+import { type BlossomBandwidthStats, type BlossomBandwidthUpdateHandler } from './blossomBandwidthTracker.js';
+export declare const DEFAULT_BLOSSOM_SERVERS: BlossomServerConfig[];
+export type { BlossomBandwidthServerStats, BlossomBandwidthStats, BlossomBandwidthUpdateHandler, } from './blossomBandwidthTracker.js';
+export declare class BlossomTransport {
+    private servers;
+    private readonly signer;
+    private readonly bandwidthTracker;
+    private store;
+    constructor(servers?: BlossomServerConfig[], onBandwidthUpdate?: BlossomBandwidthUpdateHandler);
+    setServers(servers: BlossomServerConfig[]): void;
+    getServers(): BlossomServerConfig[];
+    getWriteServers(): BlossomServerConfig[];
+    getBandwidthStats(): BlossomBandwidthStats;
+    private createStore;
+    createUploadStore(onUploadProgress?: BlossomUploadCallback): BlossomStore;
+    upload(hashHex: string, data: Uint8Array, _mimeType?: string, onUploadProgress?: BlossomUploadCallback): Promise<void>;
+    fetch(hashHex: string): Promise<Uint8Array | null>;
+    private fetchFromServer;
+}
+//# sourceMappingURL=blossomTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blossomTransport.d.ts","sourceRoot":"","sources":["../../src/capabilities/blossomTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,KAAK,qBAAqB,EAI3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,EAGxD,CAAC;AAEF,YAAY,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AA2CtC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,KAAK,CAAe;gBAEhB,OAAO,CAAC,EAAE,mBAAmB,EAAE,EAAE,iBAAiB,CAAC,EAAE,6BAA6B;IAO9F,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAKhD,UAAU,IAAI,mBAAmB,EAAE;IAInC,eAAe,IAAI,mBAAmB,EAAE;IAIxC,iBAAiB,IAAI,qBAAqB;IAI1C,OAAO,CAAC,WAAW;IAWnB,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,YAAY;IAInE,MAAM,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,OAAO,CAAC,IAAI,CAAC;IAYV,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAU1C,eAAe;CAe9B"}

package/dist/capabilities/blossomTransport.js

@@ -0,0 +1,124 @@
+import { BlossomStore, sha256, toHex, fromHex, } from '@hashtree/core';
+import { finalizeEvent, generateSecretKey } from 'nostr-tools/pure';
+import { BlossomBandwidthTracker, } from './blossomBandwidthTracker.js';
+export const DEFAULT_BLOSSOM_SERVERS = [
+    { url: 'https://blossom.primal.net', read: true, write: true },
+    { url: 'https://upload.iris.to', read: false, write: true },
+];
+function normalizeServerUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+function normalizeServers(servers) {
+    const source = servers && servers.length > 0 ? servers : DEFAULT_BLOSSOM_SERVERS;
+    const unique = new Map();
+    for (const server of source) {
+        const url = normalizeServerUrl(server.url.trim());
+        if (!url)
+            continue;
+        unique.set(url, {
+            url,
+            read: server.read ?? true,
+            write: server.write ?? false,
+        });
+    }
+    return Array.from(unique.values());
+}
+function createEphemeralSigner() {
+    const secretKey = generateSecretKey();
+    return async (template) => {
+        const event = finalizeEvent({
+            ...template,
+            kind: template.kind,
+            created_at: template.created_at,
+            content: template.content,
+            tags: template.tags,
+        }, secretKey);
+        return {
+            kind: event.kind,
+            created_at: event.created_at,
+            content: event.content,
+            tags: event.tags,
+            pubkey: event.pubkey,
+            id: event.id,
+            sig: event.sig,
+        };
+    };
+}
+export class BlossomTransport {
+    servers;
+    signer;
+    bandwidthTracker;
+    store;
+    constructor(servers, onBandwidthUpdate) {
+        this.servers = normalizeServers(servers);
+        this.signer = createEphemeralSigner();
+        this.bandwidthTracker = new BlossomBandwidthTracker(onBandwidthUpdate);
+        this.store = this.createStore(this.servers);
+    }
+    setServers(servers) {
+        this.servers = normalizeServers(servers);
+        this.store = this.createStore(this.servers);
+    }
+    getServers() {
+        return this.servers;
+    }
+    getWriteServers() {
+        return this.servers.filter(server => !!server.write);
+    }
+    getBandwidthStats() {
+        return this.bandwidthTracker.getStats();
+    }
+    createStore(servers, onUploadProgress) {
+        return new BlossomStore({
+            servers,
+            signer: this.signer,
+            onUploadProgress,
+            logger: (entry) => {
+                this.bandwidthTracker.apply(entry);
+            },
+        });
+    }
+    createUploadStore(onUploadProgress) {
+        return this.createStore(this.servers, onUploadProgress);
+    }
+    async upload(hashHex, data, _mimeType, onUploadProgress) {
+        if (!this.servers.some(server => server.write))
+            return;
+        const uploadMimeType = 'application/octet-stream';
+        if (onUploadProgress) {
+            const store = this.createStore(this.servers, onUploadProgress);
+            await store.put(fromHex(hashHex), data, uploadMimeType);
+            return;
+        }
+        await this.store.put(fromHex(hashHex), data, uploadMimeType);
+    }
+    async fetch(hashHex) {
+        const readServers = this.servers.filter(server => server.read !== false);
+        for (const server of readServers) {
+            const baseUrl = normalizeServerUrl(server.url);
+            const data = await this.fetchFromServer(baseUrl, hashHex);
+            if (data)
+                return data;
+        }
+        return null;
+    }
+    async fetchFromServer(baseUrl, hashHex) {
+        const urls = [`${baseUrl}/${hashHex}`, `${baseUrl}/${hashHex}.bin`];
+        for (const url of urls) {
+            try {
+                const res = await fetch(url);
+                if (!res.ok)
+                    continue;
+                const data = new Uint8Array(await res.arrayBuffer());
+                const verified = toHex(await sha256(data)) === hashHex;
+                if (verified)
+                    return data;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=blossomTransport.js.map

package/dist/capabilities/blossomTransport.js.map

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

package/dist/capabilities/connectivity.d.ts

@@ -0,0 +1,3 @@
+import type { BlossomServerConfig, ConnectivityState } from '../protocol.js';
+export declare function probeConnectivity(servers: BlossomServerConfig[]): Promise<ConnectivityState>;
+//# sourceMappingURL=connectivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity.d.ts","sourceRoot":"","sources":["../../src/capabilities/connectivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAiC7E,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoBlG"}

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}`))),
+        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,EAAE,CAAC,CAAC,CAAC;QAChG,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/client.d.ts

@@ -0,0 +1,54 @@
+import type { BlossomBandwidthState, BlossomServerConfig, BlobSource, ConnectivityState, UploadProgressState, WorkerConfig } from './protocol.js';
+export type WorkerFactory = URL | string | (new () => Worker);
+export type P2PFetchHandler = (hashHex: string) => Promise<Uint8Array | null>;
+export declare class HashtreeWorkerClient {
+    private readonly workerFactory;
+    private readonly config;
+    private worker;
+    private initPromise;
+    private pending;
+    private connectivityListeners;
+    private uploadProgressListeners;
+    private blossomBandwidthListeners;
+    private p2pFetchHandler;
+    constructor(workerFactory: WorkerFactory, config?: WorkerConfig);
+    init(): Promise<void>;
+    private spawnWorker;
+    private rejectAllPending;
+    private resolvePending;
+    private rejectPending;
+    private handleP2PFetch;
+    private request;
+    private initIfNeeded;
+    putBlob(data: Uint8Array, mimeType?: string, upload?: boolean): Promise<{
+        hashHex: string;
+        nhash: string;
+    }>;
+    beginPutBlobStream(mimeType?: string, upload?: boolean): Promise<string>;
+    appendPutBlobStream(streamId: string, chunk: Uint8Array): Promise<void>;
+    finishPutBlobStream(streamId: string): Promise<{
+        hashHex: string;
+        nhash: string;
+    }>;
+    cancelPutBlobStream(streamId: string): Promise<void>;
+    getBlob(hashHex: string): Promise<{
+        data: Uint8Array;
+        source: BlobSource;
+    }>;
+    getBlobForPeer(hashHex: string): Promise<Uint8Array | null>;
+    setBlossomServers(servers: BlossomServerConfig[]): Promise<void>;
+    registerMediaPort(port: MessagePort): Promise<void>;
+    setStorageMaxBytes(maxBytes: number): Promise<void>;
+    getStorageStats(): Promise<{
+        items: number;
+        bytes: number;
+        maxBytes: number;
+    }>;
+    probeConnectivity(): Promise<ConnectivityState>;
+    onConnectivityUpdate(listener: (state: ConnectivityState) => void): () => void;
+    onUploadProgress(listener: (progress: UploadProgressState) => void): () => void;
+    onBlossomBandwidth(listener: (stats: BlossomBandwidthState) => void): () => void;
+    setP2PFetchHandler(handler: P2PFetchHandler | null): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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