@hashtree/worker 0.2.1 → 0.2.3

package/dist/protocol.d.ts

@@ -0,0 +1,225 @@
+import type { CID } from '@hashtree/core';
+export interface BlossomServerConfig {
+    url: string;
+    read?: boolean;
+    write?: boolean;
+}
+export interface WorkerConfig {
+    storeName?: string;
+    blossomServers?: BlossomServerConfig[];
+    relays?: string[];
+    storageMaxBytes?: number;
+    connectivityProbeIntervalMs?: number;
+    diagnosticsEnabled?: boolean;
+    diagnosticsMirrorToConsole?: boolean;
+}
+export type WorkerDiagnosticLevel = 'debug' | 'info' | 'warn' | 'error';
+export type WorkerDiagnosticDataValue = string | number | boolean | null;
+export interface WorkerDiagnosticEvent {
+    scope: string;
+    code: string;
+    level: WorkerDiagnosticLevel;
+    message: string;
+    timestamp: number;
+    data?: Record<string, WorkerDiagnosticDataValue>;
+}
+export interface ConnectivityState {
+    online: boolean;
+    reachableReadServers: number;
+    totalReadServers: number;
+    reachableWriteServers: number;
+    totalWriteServers: number;
+    updatedAt: number;
+}
+export type BlobSource = 'idb' | 'blossom' | 'p2p';
+export interface UploadServerStatus {
+    url: string;
+    uploaded: number;
+    skipped: number;
+    failed: number;
+}
+export interface UploadProgressState {
+    hashHex: string;
+    nhash: string;
+    totalServers: number;
+    processedServers: number;
+    uploadedServers: number;
+    skippedServers: number;
+    failedServers: number;
+    totalChunks?: number;
+    processedChunks?: number;
+    /** 0..1 normalized progress for chunk upload traversal */
+    progressRatio?: number;
+    serverStatuses?: UploadServerStatus[];
+    complete: boolean;
+    error?: string;
+}
+export interface BlossomBandwidthServerStats {
+    url: string;
+    bytesSent: number;
+    bytesReceived: number;
+}
+export interface BlossomBandwidthState {
+    totalBytesSent: number;
+    totalBytesReceived: number;
+    updatedAt: number;
+    servers: BlossomBandwidthServerStats[];
+}
+export interface BlobStreamStarted {
+    id: string;
+    streamId: string;
+}
+export interface RootResolveOptions {
+    timeoutMs?: number;
+    settleMs?: number;
+}
+export type WorkerRequest = {
+    type: 'init';
+    id: string;
+    config: WorkerConfig;
+} | {
+    type: 'close';
+    id: string;
+} | {
+    type: 'putBlob';
+    id: string;
+    data: Uint8Array;
+    mimeType?: string;
+    upload?: boolean;
+} | {
+    type: 'beginPutBlobStream';
+    id: string;
+    mimeType?: string;
+    upload?: boolean;
+} | {
+    type: 'appendPutBlobStream';
+    id: string;
+    streamId: string;
+    chunk: Uint8Array;
+} | {
+    type: 'finishPutBlobStream';
+    id: string;
+    streamId: string;
+} | {
+    type: 'cancelPutBlobStream';
+    id: string;
+    streamId: string;
+} | {
+    type: 'p2pFetchResult';
+    id: string;
+    requestId: string;
+    data?: Uint8Array;
+    error?: string;
+} | {
+    type: 'getBlob';
+    id: string;
+    hashHex: string;
+    forPeer?: boolean;
+} | {
+    type: 'registerMediaPort';
+    id: string;
+    port: MessagePort;
+} | {
+    type: 'setBlossomServers';
+    id: string;
+    servers: BlossomServerConfig[];
+} | {
+    type: 'setStorageMaxBytes';
+    id: string;
+    maxBytes: number;
+} | {
+    type: 'getStorageStats';
+    id: string;
+} | {
+    type: 'probeConnectivity';
+    id: string;
+} | {
+    type: 'resolveRoot';
+    id: string;
+    npub: string;
+    path?: string;
+    timeoutMs?: number;
+    settleMs?: number;
+} | {
+    type: 'watchRoot';
+    id: string;
+    npub: string;
+    path?: string;
+    timeoutMs?: number;
+    settleMs?: number;
+} | {
+    type: 'unwatchRoot';
+    id: string;
+    watchId: string;
+};
+export type WorkerResponse = {
+    type: 'ready';
+    id: string;
+} | {
+    type: 'error';
+    id?: string;
+    error: string;
+} | {
+    type: 'diagnostic';
+    event: WorkerDiagnosticEvent;
+} | {
+    type: 'p2pFetch';
+    requestId: string;
+    hashHex: string;
+} | {
+    type: 'blobStreamStarted';
+    id: string;
+    streamId: string;
+} | {
+    type: 'blobStored';
+    id: string;
+    hashHex: string;
+    nhash: string;
+} | {
+    type: 'blob';
+    id: string;
+    data?: Uint8Array;
+    source?: BlobSource;
+    error?: string;
+} | {
+    type: 'cid';
+    id: string;
+    cid?: CID;
+    error?: string;
+} | {
+    type: 'void';
+    id: string;
+    error?: string;
+} | {
+    type: 'storageStats';
+    id: string;
+    items: number;
+    bytes: number;
+    maxBytes: number;
+    error?: string;
+} | {
+    type: 'connectivity';
+    id: string;
+    state?: ConnectivityState;
+    error?: string;
+} | {
+    type: 'rootWatchStarted';
+    id: string;
+    watchId: string;
+    cid?: CID;
+    error?: string;
+} | {
+    type: 'rootUpdate';
+    watchId: string;
+    cid?: CID;
+} | {
+    type: 'connectivityUpdate';
+    state: ConnectivityState;
+} | {
+    type: 'blossomBandwidth';
+    stats: BlossomBandwidthState;
+} | {
+    type: 'uploadProgress';
+    progress: UploadProgressState;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACxE,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,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,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":""}

package/dist/relay/identity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Worker Identity Management
+ *
+ * Manages user identity for signing operations.
+ * - For nsec login: secret key available, sign directly
+ * - For extension login: delegate to main thread via NIP-07
+ */
+/**
+ * Initialize identity from config
+ */
+export declare function initIdentity(pubkey: string, nsecHex?: string): void;
+/**
+ * Update identity (account switch)
+ */
+export declare function setIdentity(pubkey: string, nsecHex?: string): void;
+/**
+ * Clear identity on close
+ */
+export declare function clearIdentity(): void;
+/**
+ * Get user's pubkey (or ephemeral fallback)
+ */
+export declare function getPubkey(): string | null;
+/**
+ * Get user's secret key (null for extension login)
+ */
+export declare function getSecretKey(): Uint8Array | null;
+/**
+ * Get ephemeral secret key (fallback for sync signing)
+ */
+export declare function getEphemeralSecretKey(): Uint8Array | null;
+/**
+ * Check if we have a secret key for direct signing
+ */
+export declare function hasSecretKey(): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/relay/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/relay/identity.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAYH;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAanE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/relay/identity.js

@@ -0,0 +1,78 @@
+// @ts-nocheck
+/**
+ * Worker Identity Management
+ *
+ * Manages user identity for signing operations.
+ * - For nsec login: secret key available, sign directly
+ * - For extension login: delegate to main thread via NIP-07
+ */
+import { generateSecretKey, getPublicKey } from 'nostr-tools';
+// User identity (set via init or setIdentity)
+let userPubkey = null;
+let userSecretKey = null;
+// Fallback ephemeral identity (used before user logs in)
+let ephemeralSecretKey = null;
+let ephemeralPubkey = null;
+/**
+ * Initialize identity from config
+ */
+export function initIdentity(pubkey, nsecHex) {
+    userPubkey = pubkey;
+    if (nsecHex) {
+        userSecretKey = new Uint8Array(nsecHex.match(/.{2}/g).map(b => parseInt(b, 16)));
+    }
+    else {
+        userSecretKey = null;
+    }
+    // Generate fallback ephemeral identity
+    if (!ephemeralSecretKey) {
+        ephemeralSecretKey = generateSecretKey();
+        ephemeralPubkey = getPublicKey(ephemeralSecretKey);
+    }
+}
+/**
+ * Update identity (account switch)
+ */
+export function setIdentity(pubkey, nsecHex) {
+    userPubkey = pubkey;
+    if (nsecHex) {
+        userSecretKey = new Uint8Array(nsecHex.match(/.{2}/g).map(b => parseInt(b, 16)));
+    }
+    else {
+        userSecretKey = null;
+    }
+}
+/**
+ * Clear identity on close
+ */
+export function clearIdentity() {
+    userPubkey = null;
+    userSecretKey = null;
+    ephemeralSecretKey = null;
+    ephemeralPubkey = null;
+}
+/**
+ * Get user's pubkey (or ephemeral fallback)
+ */
+export function getPubkey() {
+    return userPubkey || ephemeralPubkey;
+}
+/**
+ * Get user's secret key (null for extension login)
+ */
+export function getSecretKey() {
+    return userSecretKey;
+}
+/**
+ * Get ephemeral secret key (fallback for sync signing)
+ */
+export function getEphemeralSecretKey() {
+    return ephemeralSecretKey;
+}
+/**
+ * Check if we have a secret key for direct signing
+ */
+export function hasSecretKey() {
+    return userSecretKey !== null;
+}
+//# sourceMappingURL=identity.js.map

package/dist/relay/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/relay/identity.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,8CAA8C;AAC9C,IAAI,UAAU,GAAkB,IAAI,CAAC;AACrC,IAAI,aAAa,GAAsB,IAAI,CAAC;AAE5C,yDAAyD;AACzD,IAAI,kBAAkB,GAAsB,IAAI,CAAC;AACjD,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAgB;IAC3D,UAAU,GAAG,MAAM,CAAC;IACpB,IAAI,OAAO,EAAE,CAAC;QACZ,aAAa,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,iBAAiB,EAAE,CAAC;QACzC,eAAe,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAgB;IAC1D,UAAU,GAAG,MAAM,CAAC;IACpB,IAAI,OAAO,EAAE,CAAC;QACZ,aAAa,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,UAAU,GAAG,IAAI,CAAC;IAClB,aAAa,GAAG,IAAI,CAAC;IACrB,kBAAkB,GAAG,IAAI,CAAC;IAC1B,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,IAAI,eAAe,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,KAAK,IAAI,CAAC;AAChC,CAAC"}

package/dist/relay/mediaHandler.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Media Streaming Handler for Hashtree Worker
+ *
+ * Handles media requests from the service worker via MessagePort.
+ * Supports both direct CID-based requests and path-based requests with live streaming.
+ */
+import type { HashTree, CID } from '@hashtree/core';
+/**
+ * SW FileRequest format (from service worker)
+ */
+interface SwFileRequest {
+    type: 'hashtree-file';
+    requestId: string;
+    npub?: string;
+    nhash?: string;
+    snapshot?: boolean;
+    linkKey?: string | null;
+    treeName?: string;
+    path: string;
+    start: number;
+    end?: number;
+    rangeHeader?: string | null;
+    mimeType: string;
+    download?: boolean;
+}
+interface ResolvedRootEntry {
+    cid: CID;
+    size?: number;
+    path?: string;
+}
+/**
+ * Initialize the media handler with the HashTree instance
+ */
+export declare function initMediaHandler(hashTree: HashTree): void;
+/**
+ * Register a MessagePort from the service worker for media streaming
+ */
+export declare function registerMediaPort(port: MessagePort, debug?: boolean): void;
+/**
+ * Handle file request from service worker (hashtree-file format)
+ * This is the main entry point for direct SW → Worker communication
+ */
+declare function handleSwFileRequest(req: SwFileRequest): Promise<void>;
+declare function waitForCachedRoot(npub: string, treeName: string): Promise<CID | null>;
+declare function resolveMutableTreeEntry(npub: string, treeName: string, path: string, options?: {
+    allowSingleSegmentRootFallback?: boolean;
+    expectedMimeType?: string;
+}): Promise<ResolvedRootEntry | null>;
+declare function resolveCidWithinRoot(rootCid: CID, path: string, options?: {
+    allowSingleSegmentRootFallback?: boolean;
+    expectedMimeType?: string;
+}): Promise<CID | null>;
+declare function normalizeAliasPath(rootCid: CID, path: string): Promise<string>;
+declare function canListDirectory(rootCid: CID): Promise<boolean>;
+export declare const __test__: {
+    handleSwFileRequest: typeof handleSwFileRequest;
+    resolveCidWithinRoot: typeof resolveCidWithinRoot;
+    resolveMutableTreeEntry: typeof resolveMutableTreeEntry;
+    normalizeAliasPath: typeof normalizeAliasPath;
+    canListDirectory: typeof canListDirectory;
+    waitForCachedRoot: typeof waitForCachedRoot;
+};
+export {};
+//# sourceMappingURL=mediaHandler.d.ts.map

package/dist/relay/mediaHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaHandler.d.ts","sourceRoot":"","sources":["../../src/relay/mediaHandler.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAqDpD;;GAEG;AACH,UAAU,aAAa;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD,UAAU,iBAAiB;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmJD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CA2B1E;AA+OD;;;GAGG;AACH,iBAAe,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0GpE;AAED,iBAAe,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAoDpF;AAED,iBAAe,uBAAuB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA0BnC;AAuFD,iBAAe,oBAAoB,CACjC,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAErB;AAoWD,iBAAe,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7E;AAED,iBAAe,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9D;AAED,eAAO,MAAM,QAAQ;;;;;;;CAOpB,CAAC"}