@hashtree/worker 0.2.1 → 0.2.3

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/dist/app-runtime.d.ts

@@ -0,0 +1,60 @@
+import type { WorkerConfig, BlossomServerConfig } from './protocol.js';
+import type { HtreeRuntimeWindowLike } from './runtime.js';
+import type { ParsedHtreeUrl, ResolveHtreeRequestUrlOptions } from './htree-url.js';
+import type { HtreeClientIdStorageLike } from './client-id.js';
+import { type RuntimeEndpoints } from './runtime-network.js';
+export type RuntimeValueSource<T> = T | (() => T);
+export interface HtreeRuntimeEndpointOverrides {
+    relays?: readonly string[];
+    blossomServers?: readonly BlossomServerConfig[];
+}
+export interface HtreeRuntimeOptions {
+    appId?: string | null;
+    fallbackBaseUrl?: string | null;
+    windowLike?: HtreeRuntimeWindowLike;
+    storage?: HtreeClientIdStorageLike | null;
+    clientIdFactory?: () => string;
+    clientIdStorageKey?: string;
+    clientIdPrefix?: string;
+    serviceWorker?: ServiceWorkerContainer | null;
+    relays?: RuntimeValueSource<readonly string[]>;
+    blossomServers?: RuntimeValueSource<readonly BlossomServerConfig[]>;
+}
+export interface HtreeRuntimeRequestUrlOptions extends Omit<ResolveHtreeRequestUrlOptions, 'windowLike' | 'fallbackBaseUrl'> {
+}
+export interface HtreeRuntimeMediaUrlOptions extends HtreeRuntimeRequestUrlOptions {
+    clientScoped?: boolean;
+    mimeType?: string | null | undefined;
+    query?: Record<string, string | number | boolean | null | undefined>;
+}
+export interface HtreeRuntimeWorkerConfigOptions extends Omit<WorkerConfig, 'relays' | 'blossomServers'> {
+    relays?: readonly string[];
+    blossomServers?: readonly BlossomServerConfig[];
+}
+export interface HtreeRuntimeMediaPortOptions {
+    registerMediaPort: (port: MessagePort, debug?: boolean) => Promise<void> | void;
+    debug?: boolean;
+    attempts?: number;
+    delayMs?: number;
+    pingTimeoutMs?: number;
+    registrationTimeoutMs?: number;
+    controllerTimeoutMs?: number;
+}
+export interface HtreeRuntime {
+    readonly appId: string | null;
+    readonly clientId: string | null;
+    readonly endpoints: RuntimeEndpoints;
+    getEndpoints(overrides?: HtreeRuntimeEndpointOverrides): RuntimeEndpoints;
+    getWorkerConfig(options?: HtreeRuntimeWorkerConfigOptions): WorkerConfig;
+    urls: {
+        request: (input: string | ParsedHtreeUrl, options?: HtreeRuntimeRequestUrlOptions) => string;
+        media: (input: string | ParsedHtreeUrl, options?: HtreeRuntimeMediaUrlOptions) => string;
+        appendClientId: (url: string) => string;
+    };
+    media: {
+        ensureReady: (options: HtreeRuntimeMediaPortOptions) => Promise<boolean>;
+        reset: () => void;
+    };
+}
+export declare function createHtreeRuntime(options?: HtreeRuntimeOptions): HtreeRuntime;
+//# sourceMappingURL=app-runtime.d.ts.map

package/dist/app-runtime.d.ts.map

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

package/dist/app-runtime.js

@@ -0,0 +1,271 @@
+import { appendHtreeClientId, appendHtreeQueryParam, getOrCreateHtreeClientId, } from './client-id.js';
+import { resolveHtreeRequestUrl } from './htree-url.js';
+import { canUseInjectedHtreeServerUrl, canUseSameOriginHtreeProtocolStreaming } from './runtime.js';
+import { resolveRuntimeEndpoints } from './runtime-network.js';
+const DEFAULT_FALLBACK_BASE_URL = '';
+const DEFAULT_MEDIA_PORT_ATTEMPTS = 3;
+const DEFAULT_MEDIA_PORT_DELAY_MS = 500;
+const DEFAULT_MEDIA_PORT_PING_TIMEOUT_MS = 1_500;
+const DEFAULT_MEDIA_PORT_REGISTRATION_TIMEOUT_MS = 5_000;
+const DEFAULT_MEDIA_PORT_CONTROLLER_TIMEOUT_MS = 5_000;
+const RECONNECT_REQUEST_COOLDOWN_MS = 1_000;
+function resolveRuntimeValue(value, fallback) {
+    if (typeof value === 'function') {
+        return value();
+    }
+    return value ?? fallback;
+}
+function getServiceWorkerContainer(serviceWorker) {
+    if (typeof serviceWorker !== 'undefined') {
+        return serviceWorker;
+    }
+    if (typeof navigator === 'undefined') {
+        return null;
+    }
+    return navigator.serviceWorker ?? null;
+}
+function isDirectMediaRuntime(windowLike) {
+    return canUseInjectedHtreeServerUrl(windowLike)
+        || canUseSameOriginHtreeProtocolStreaming(windowLike);
+}
+function createMessageId(prefix) {
+    return `${prefix}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+export function createHtreeRuntime(options = {}) {
+    const appId = options.appId?.trim() || null;
+    const fallbackBaseUrl = options.fallbackBaseUrl ?? DEFAULT_FALLBACK_BASE_URL;
+    const windowLike = options.windowLike;
+    const storage = typeof options.storage === 'undefined' ? undefined : options.storage;
+    const storageKey = options.clientIdStorageKey ?? (appId ? `${appId}.mediaClientId` : 'htree.mediaClientId');
+    const clientIdPrefix = options.clientIdPrefix ?? (appId ? appId.replace(/[^a-z0-9]+/gi, '').toLowerCase() || 'htree' : 'htree');
+    const serviceWorker = getServiceWorkerContainer(options.serviceWorker);
+    let setupPromise = null;
+    let mediaReady = false;
+    let activeController = null;
+    let controllerListenerAttached = false;
+    let messageListenerAttached = false;
+    let reconnectPromise = null;
+    let lastReconnectRequestAt = 0;
+    let lastEnsureOptions = null;
+    const getClientId = () => getOrCreateHtreeClientId({
+        storage,
+        storageKey,
+        prefix: clientIdPrefix,
+        uuidFactory: options.clientIdFactory,
+    });
+    const getEndpoints = (overrides = {}) => {
+        const relays = overrides.relays ?? resolveRuntimeValue(options.relays, []);
+        const blossomServers = overrides.blossomServers ?? resolveRuntimeValue(options.blossomServers, []);
+        return resolveRuntimeEndpoints({
+            windowLike,
+            relays,
+            blossomServers,
+        });
+    };
+    const appendRuntimeClientId = (url) => appendHtreeClientId(url, getClientId());
+    const resolveRequestUrl = (input, urlOptions = {}) => resolveHtreeRequestUrl(input, {
+        ...urlOptions,
+        windowLike,
+        fallbackBaseUrl,
+    });
+    const resolveMediaUrl = (input, mediaOptions = {}) => {
+        let url = resolveRequestUrl(input, mediaOptions);
+        if (mediaOptions.clientScoped) {
+            url = appendRuntimeClientId(url);
+        }
+        url = appendHtreeQueryParam(url, 'htree_t', mediaOptions.mimeType);
+        for (const [key, value] of Object.entries(mediaOptions.query ?? {})) {
+            url = appendHtreeQueryParam(url, key, value == null ? value : String(value));
+        }
+        return url;
+    };
+    const getWorkerConfig = (configOptions = {}) => {
+        const { relays, blossomServers, ...rest } = configOptions;
+        const endpoints = getEndpoints({ relays, blossomServers });
+        return {
+            ...rest,
+            relays: endpoints.nostrRelays,
+            blossomServers: endpoints.blossomServers,
+        };
+    };
+    const resetMedia = () => {
+        mediaReady = false;
+        setupPromise = null;
+        activeController = null;
+    };
+    const ensureControllerListener = () => {
+        if (controllerListenerAttached || !serviceWorker)
+            return;
+        controllerListenerAttached = true;
+        serviceWorker.addEventListener('controllerchange', () => {
+            resetMedia();
+        });
+    };
+    const requestMediaReconnect = (requestedClientKey) => {
+        const clientId = getClientId();
+        if (!lastEnsureOptions)
+            return;
+        if (requestedClientKey && clientId && requestedClientKey !== clientId) {
+            return;
+        }
+        const now = Date.now();
+        if (reconnectPromise || now - lastReconnectRequestAt < RECONNECT_REQUEST_COOLDOWN_MS) {
+            return;
+        }
+        lastReconnectRequestAt = now;
+        resetMedia();
+        reconnectPromise = ensureMediaPortReady(lastEnsureOptions)
+            .then(() => undefined)
+            .catch(() => undefined)
+            .finally(() => {
+            reconnectPromise = null;
+        });
+    };
+    const ensureMessageListener = () => {
+        if (messageListenerAttached || !serviceWorker)
+            return;
+        messageListenerAttached = true;
+        serviceWorker.addEventListener('message', (event) => {
+            const data = event.data;
+            if (data?.type !== 'REQUEST_WORKER_PORT_RECONNECT') {
+                return;
+            }
+            requestMediaReconnect(data.clientKey ?? null);
+        });
+    };
+    const waitForController = async (timeoutMs) => {
+        if (!serviceWorker)
+            return null;
+        if (serviceWorker.controller)
+            return serviceWorker.controller;
+        await serviceWorker.ready.catch(() => undefined);
+        if (serviceWorker.controller)
+            return serviceWorker.controller;
+        return await new Promise((resolve) => {
+            const timeoutId = setTimeout(() => resolve(serviceWorker.controller ?? null), timeoutMs);
+            serviceWorker.addEventListener('controllerchange', () => {
+                clearTimeout(timeoutId);
+                resolve(serviceWorker.controller ?? null);
+            }, { once: true });
+        });
+    };
+    const pingMediaPort = async (clientKey, controller, timeoutMs) => {
+        if (!serviceWorker)
+            return false;
+        const requestId = createMessageId('media-ping');
+        const ackPromise = new Promise((resolve) => {
+            const timeoutId = setTimeout(() => {
+                serviceWorker.removeEventListener('message', onMessage);
+                resolve(false);
+            }, timeoutMs);
+            const onMessage = (event) => {
+                const data = event.data;
+                if (data?.type === 'WORKER_PORT_PONG' && data.requestId === requestId) {
+                    clearTimeout(timeoutId);
+                    serviceWorker.removeEventListener('message', onMessage);
+                    resolve(!!data.ok);
+                }
+            };
+            serviceWorker.addEventListener('message', onMessage);
+        });
+        controller.postMessage({ type: 'PING_WORKER_PORT', requestId, clientKey });
+        return await ackPromise;
+    };
+    const setupMediaPort = async (portOptions) => {
+        if (!serviceWorker) {
+            return false;
+        }
+        ensureControllerListener();
+        ensureMessageListener();
+        const controller = await waitForController(portOptions.controllerTimeoutMs ?? DEFAULT_MEDIA_PORT_CONTROLLER_TIMEOUT_MS);
+        if (!controller) {
+            return false;
+        }
+        const clientKey = getClientId() ?? undefined;
+        if (mediaReady && activeController === controller) {
+            if (!clientKey) {
+                return true;
+            }
+            const alive = await pingMediaPort(clientKey, controller, portOptions.pingTimeoutMs ?? DEFAULT_MEDIA_PORT_PING_TIMEOUT_MS);
+            if (alive) {
+                return true;
+            }
+            resetMedia();
+        }
+        const channel = new MessageChannel();
+        const requestId = createMessageId('media');
+        const ackPromise = new Promise((resolve) => {
+            const timeoutId = setTimeout(() => {
+                serviceWorker.removeEventListener('message', onMessage);
+                resolve(false);
+            }, portOptions.registrationTimeoutMs ?? DEFAULT_MEDIA_PORT_REGISTRATION_TIMEOUT_MS);
+            const onMessage = (event) => {
+                const data = event.data;
+                if (data?.type === 'WORKER_PORT_READY' && data.requestId === requestId) {
+                    clearTimeout(timeoutId);
+                    serviceWorker.removeEventListener('message', onMessage);
+                    resolve(true);
+                }
+            };
+            serviceWorker.addEventListener('message', onMessage);
+        });
+        controller.postMessage({
+            type: 'REGISTER_WORKER_PORT',
+            port: channel.port1,
+            requestId,
+            clientKey,
+            debug: !!portOptions.debug,
+        }, [channel.port1]);
+        await portOptions.registerMediaPort(channel.port2, !!portOptions.debug);
+        const acked = await ackPromise;
+        mediaReady = acked;
+        activeController = acked ? controller : null;
+        return acked;
+    };
+    const ensureMediaPortReady = async (portOptions) => {
+        lastEnsureOptions = portOptions;
+        if (isDirectMediaRuntime(windowLike)) {
+            return true;
+        }
+        const attempts = portOptions.attempts ?? DEFAULT_MEDIA_PORT_ATTEMPTS;
+        const delayMs = portOptions.delayMs ?? DEFAULT_MEDIA_PORT_DELAY_MS;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            if (!setupPromise) {
+                setupPromise = setupMediaPort(portOptions).finally(() => {
+                    if (!mediaReady) {
+                        setupPromise = null;
+                    }
+                });
+            }
+            const ready = await setupPromise.catch(() => false);
+            if (ready) {
+                return true;
+            }
+            if (attempt < attempts - 1) {
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+            }
+        }
+        return false;
+    };
+    return {
+        appId,
+        get clientId() {
+            return getClientId();
+        },
+        get endpoints() {
+            return getEndpoints();
+        },
+        getEndpoints,
+        getWorkerConfig,
+        urls: {
+            request: resolveRequestUrl,
+            media: resolveMediaUrl,
+            appendClientId: appendRuntimeClientId,
+        },
+        media: {
+            ensureReady: ensureMediaPortReady,
+            reset: resetMedia,
+        },
+    };
+}
+//# sourceMappingURL=app-runtime.js.map

package/dist/app-runtime.js.map

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

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 readonly inflightFetches;
+    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>;
+}
+//# 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,EAE3B,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,EAAO,CAAC;AAOjE,YAAY,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AA6EtC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,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;CAazD"}

package/dist/capabilities/blossomTransport.js

@@ -0,0 +1,139 @@
+import { BlossomStore, fromHex, } from '@hashtree/core';
+import { finalizeEvent, generateSecretKey } from 'nostr-tools/pure';
+import { BlossomBandwidthTracker, } from './blossomBandwidthTracker.js';
+export const DEFAULT_BLOSSOM_SERVERS = [];
+const MAX_CONCURRENT_READ_FETCHES = 32;
+let activeReadFetches = 0;
+const pendingReadFetchWaiters = [];
+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,
+        };
+    };
+}
+function releaseReadFetchSlot() {
+    activeReadFetches = Math.max(0, activeReadFetches - 1);
+    pendingReadFetchWaiters.shift()?.();
+}
+function withReadFetchSlot(loader) {
+    return new Promise((resolve, reject) => {
+        const start = () => {
+            activeReadFetches += 1;
+            let pending;
+            try {
+                pending = loader();
+            }
+            catch (error) {
+                releaseReadFetchSlot();
+                reject(error);
+                return;
+            }
+            pending
+                .then(resolve, reject)
+                .finally(() => {
+                releaseReadFetchSlot();
+            });
+        };
+        if (activeReadFetches < MAX_CONCURRENT_READ_FETCHES) {
+            start();
+            return;
+        }
+        pendingReadFetchWaiters.push(start);
+    });
+}
+export class BlossomTransport {
+    servers;
+    signer;
+    bandwidthTracker;
+    inflightFetches = new Map();
+    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 inflight = this.inflightFetches.get(hashHex);
+        if (inflight) {
+            return inflight;
+        }
+        const pending = withReadFetchSlot(() => this.store.get(fromHex(hashHex)))
+            .finally(() => {
+            this.inflightFetches.delete(hashHex);
+        });
+        this.inflightFetches.set(hashHex, pending);
+        return await pending;
+    }
+}
+//# 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"}