@hashtree/worker 0.2.1 → 0.2.3

package/dist/p2p/signaling.js

@@ -0,0 +1,185 @@
+export const SIGNALING_KIND = 25050;
+export const HELLO_TAG = 'hello';
+export const MAX_EVENT_AGE_SEC = 30;
+const HELLO_EXPIRATION_SEC = 5 * 60;
+function getSince(nowMs, maxEventAgeSec) {
+    return Math.floor((nowMs - maxEventAgeSec * 1000) / 1000);
+}
+function isExpired(event, nowSec, maxEventAgeSec) {
+    const createdAt = event.created_at ?? 0;
+    if (nowSec - createdAt > maxEventAgeSec) {
+        return true;
+    }
+    const expirationTag = event.tags.find((tag) => tag[0] === 'expiration');
+    if (expirationTag?.[1]) {
+        const expiration = Number.parseInt(expirationTag[1], 10);
+        if (Number.isFinite(expiration) && expiration < nowSec) {
+            return true;
+        }
+    }
+    return false;
+}
+function normalizePeerEndpoint(value, senderPubkey) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return senderPubkey;
+    return trimmed.includes(':') ? senderPubkey : trimmed;
+}
+function normalizeSignalingMessage(raw, senderPubkey) {
+    if (!raw || typeof raw !== 'object' || !('type' in raw))
+        return null;
+    const msg = raw;
+    if (typeof msg.type !== 'string')
+        return null;
+    if (typeof msg.peerId === 'string' && msg.type === 'hello') {
+        return {
+            ...msg,
+            peerId: senderPubkey,
+        };
+    }
+    if ('targetPeerId' in msg &&
+        typeof msg.targetPeerId === 'string' &&
+        typeof msg.peerId === 'string') {
+        return {
+            ...msg,
+            peerId: senderPubkey,
+            targetPeerId: normalizePeerEndpoint(msg.targetPeerId, senderPubkey),
+        };
+    }
+    if (!('recipient' in msg) || typeof msg.recipient !== 'string' || typeof msg.peerId !== 'string') {
+        return null;
+    }
+    const senderPeerId = senderPubkey;
+    const targetPeerId = normalizePeerEndpoint(msg.recipient, senderPubkey);
+    switch (msg.type) {
+        case 'offer': {
+            const offer = msg.offer;
+            const sdp = typeof offer === 'string' ? offer : offer?.sdp;
+            return sdp ? { type: 'offer', peerId: senderPeerId, targetPeerId, sdp } : null;
+        }
+        case 'answer': {
+            const answer = msg.answer;
+            const sdp = typeof answer === 'string' ? answer : answer?.sdp;
+            return sdp ? { type: 'answer', peerId: senderPeerId, targetPeerId, sdp } : null;
+        }
+        case 'candidate': {
+            const candidateObj = msg.candidate;
+            const candidate = typeof candidateObj === 'string' ? candidateObj : candidateObj?.candidate;
+            return candidate
+                ? {
+                    type: 'candidate',
+                    peerId: senderPeerId,
+                    targetPeerId,
+                    candidate,
+                    sdpMLineIndex: typeof candidateObj === 'object' ? candidateObj?.sdpMLineIndex : undefined,
+                    sdpMid: typeof candidateObj === 'object' ? candidateObj?.sdpMid : undefined,
+                }
+                : null;
+        }
+        case 'candidates': {
+            const candidates = Array.isArray(msg.candidates)
+                ? msg.candidates
+                    .map((entry) => {
+                    if (typeof entry === 'string') {
+                        return { candidate: entry };
+                    }
+                    if (entry && typeof entry === 'object') {
+                        const candidateEntry = entry;
+                        if (typeof candidateEntry.candidate === 'string') {
+                            return {
+                                candidate: candidateEntry.candidate,
+                                sdpMLineIndex: candidateEntry.sdpMLineIndex,
+                                sdpMid: candidateEntry.sdpMid,
+                            };
+                        }
+                    }
+                    return null;
+                })
+                    .filter((entry) => !!entry)
+                : [];
+            return { type: 'candidates', peerId: senderPeerId, targetPeerId, candidates };
+        }
+        default:
+            return null;
+    }
+}
+export function createSignalingFilters(myPubkey, nowMs = Date.now(), maxEventAgeSec = MAX_EVENT_AGE_SEC) {
+    const since = getSince(nowMs, maxEventAgeSec);
+    return {
+        since,
+        helloFilter: {
+            kinds: [SIGNALING_KIND],
+            '#l': [HELLO_TAG],
+            since,
+        },
+        directedFilter: {
+            kinds: [SIGNALING_KIND],
+            '#p': [myPubkey],
+            since,
+        },
+    };
+}
+export async function sendSignalingMessage({ msg, recipientPubkey, signEvent, giftWrap, publish, nowMs = () => Date.now(), }) {
+    if (recipientPubkey) {
+        const wrappedEvent = await giftWrap({
+            kind: SIGNALING_KIND,
+            content: JSON.stringify(msg),
+            tags: [],
+        }, recipientPubkey);
+        await publish(wrappedEvent);
+        return;
+    }
+    const createdAt = Math.floor(nowMs() / 1000);
+    const event = await signEvent({
+        kind: SIGNALING_KIND,
+        created_at: createdAt,
+        tags: [
+            ['l', HELLO_TAG],
+            ['peerId', msg.peerId],
+            ['expiration', String(createdAt + HELLO_EXPIRATION_SEC)],
+        ],
+        content: '',
+    });
+    await publish(event);
+}
+export async function decodeSignalingEvent({ event, giftUnwrap, nowMs = () => Date.now(), maxEventAgeSec = MAX_EVENT_AGE_SEC, }) {
+    const nowSec = nowMs() / 1000;
+    if (isExpired(event, nowSec, maxEventAgeSec)) {
+        return null;
+    }
+    const isHello = event.tags.some((tag) => tag[0] === 'l' && tag[1] === HELLO_TAG);
+    if (isHello) {
+        const peerIdTag = event.tags.find((tag) => tag[0] === 'peerId');
+        if (!peerIdTag?.[1])
+            return null;
+        const senderPeerId = normalizePeerEndpoint(event.pubkey, event.pubkey);
+        if (normalizePeerEndpoint(peerIdTag[1], event.pubkey) !== senderPeerId) {
+            return null;
+        }
+        return {
+            senderPubkey: event.pubkey,
+            message: {
+                type: 'hello',
+                peerId: senderPeerId,
+            },
+        };
+    }
+    const seal = await giftUnwrap(event);
+    if (!seal?.content) {
+        return null;
+    }
+    try {
+        const raw = JSON.parse(seal.content);
+        const message = normalizeSignalingMessage(raw, seal.pubkey);
+        if (!message)
+            return null;
+        return {
+            senderPubkey: seal.pubkey,
+            message,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=signaling.js.map

package/dist/p2p/signaling.js.map

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

package/dist/p2p/uploadRateLimiter.d.ts

@@ -0,0 +1,21 @@
+type UploadRateLimiterConfig = {
+    bytesPerSecond?: number | null;
+    now?: () => number;
+};
+type UploadReservation = {
+    allowed: boolean;
+    delayMs: number;
+};
+export declare class UploadRateLimiter {
+    private bytesPerSecond;
+    private availableBytes;
+    private lastRefillMs;
+    private readonly now;
+    constructor(config?: UploadRateLimiterConfig);
+    setBytesPerSecond(bytesPerSecond?: number | null): void;
+    getBytesPerSecond(): number | null;
+    reserve(byteLength: number): UploadReservation;
+    private refill;
+}
+export {};
+//# sourceMappingURL=uploadRateLimiter.d.ts.map

package/dist/p2p/uploadRateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadRateLimiter.d.ts","sourceRoot":"","sources":["../../src/p2p/uploadRateLimiter.ts"],"names":[],"mappings":"AAAA,KAAK,uBAAuB,GAAG;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AASF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,MAAM,GAAE,uBAA4B;IAOhD,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUvD,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAyB9C,OAAO,CAAC,MAAM;CAef"}

package/dist/p2p/uploadRateLimiter.js

@@ -0,0 +1,62 @@
+function normalizeBytesPerSecond(value) {
+    if (!Number.isFinite(value) || !value || value <= 0) {
+        return null;
+    }
+    return Math.floor(value);
+}
+export class UploadRateLimiter {
+    bytesPerSecond;
+    availableBytes;
+    lastRefillMs;
+    now;
+    constructor(config = {}) {
+        this.now = config.now ?? (() => performance.now());
+        this.bytesPerSecond = normalizeBytesPerSecond(config.bytesPerSecond);
+        this.availableBytes = this.bytesPerSecond ?? Number.POSITIVE_INFINITY;
+        this.lastRefillMs = this.now();
+    }
+    setBytesPerSecond(bytesPerSecond) {
+        const nowMs = this.now();
+        this.refill(nowMs);
+        this.bytesPerSecond = normalizeBytesPerSecond(bytesPerSecond);
+        this.availableBytes = this.bytesPerSecond
+            ? Math.min(this.availableBytes, this.bytesPerSecond)
+            : Number.POSITIVE_INFINITY;
+        this.lastRefillMs = nowMs;
+    }
+    getBytesPerSecond() {
+        return this.bytesPerSecond;
+    }
+    reserve(byteLength) {
+        if (byteLength <= 0) {
+            return { allowed: true, delayMs: 0 };
+        }
+        const limit = this.bytesPerSecond;
+        if (!limit) {
+            return { allowed: true, delayMs: 0 };
+        }
+        const nowMs = this.now();
+        this.refill(nowMs);
+        if (this.availableBytes >= byteLength) {
+            this.availableBytes = Math.max(0, this.availableBytes - byteLength);
+            return { allowed: true, delayMs: 0 };
+        }
+        const missingBytes = byteLength - this.availableBytes;
+        return {
+            allowed: false,
+            delayMs: Math.max(4, Math.ceil((missingBytes / limit) * 1000)),
+        };
+    }
+    refill(nowMs) {
+        const limit = this.bytesPerSecond;
+        if (!limit) {
+            this.availableBytes = Number.POSITIVE_INFINITY;
+            this.lastRefillMs = nowMs;
+            return;
+        }
+        const elapsedMs = Math.max(0, nowMs - this.lastRefillMs);
+        this.lastRefillMs = nowMs;
+        this.availableBytes = Math.min(limit, this.availableBytes + (elapsedMs * limit) / 1000);
+    }
+}
+//# sourceMappingURL=uploadRateLimiter.js.map

package/dist/p2p/uploadRateLimiter.js.map

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

package/dist/p2p/webrtcController.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Worker WebRTC Controller
+ *
+ * Controls WebRTC connections from the worker thread.
+ * Main thread proxy executes RTCPeerConnection operations.
+ *
+ * Worker owns:
+ * - Peer state tracking
+ * - Connection lifecycle decisions
+ * - Data protocol (request/response)
+ * - Signaling message handling
+ *
+ * Main thread proxy owns:
+ * - RTCPeerConnection instances (not available in workers)
+ * - Data channel I/O
+ */
+import type { Store } from '@hashtree/core';
+import type { WebRTCCommand, WebRTCEvent } from './protocol.js';
+import { type SignalingMessage, type PeerPool, type SelectionStrategy, type RequestDispatchConfig } from '@hashtree/nostr';
+export interface WebRTCControllerConfig {
+    pubkey: string;
+    localStore: Store;
+    sendCommand: (cmd: WebRTCCommand) => void;
+    sendSignaling: (msg: SignalingMessage, recipientPubkey?: string) => Promise<void>;
+    upstreamFetch?: (hash: Uint8Array) => Promise<Uint8Array | null>;
+    getFollows?: () => Set<string>;
+    requestTimeout?: number;
+    forwardRateLimit?: {
+        maxForwardsPerPeerWindow?: number;
+        windowMs?: number;
+    };
+    requestSelectionStrategy?: SelectionStrategy;
+    requestFairnessEnabled?: boolean;
+    requestDispatch?: RequestDispatchConfig;
+    debug?: boolean;
+}
+export declare class WebRTCController {
+    private myPeerId;
+    private peers;
+    private pendingRemoteCandidates;
+    private localStore;
+    private sendCommand;
+    private sendSignaling;
+    private classifyPeer;
+    private requestTimeout;
+    private debug;
+    private recentRequests;
+    private readonly activePeerRequests;
+    private readonly meshRouter;
+    private readonly peerSelector;
+    private routing;
+    private poolConfig;
+    private helloInterval?;
+    private readonly HELLO_INTERVAL;
+    constructor(config: WebRTCControllerConfig);
+    start(): void;
+    stop(): void;
+    private sendHello;
+    /**
+     * Public method to trigger a hello broadcast.
+     * Used for testing to force peer discovery after follows are set up.
+     */
+    broadcastHello(): void;
+    /**
+     * Handle incoming signaling message (from Nostr kind 25050)
+     *
+     * `peerId` is the remote endpoint identity.
+     */
+    handleSignalingMessage(msg: SignalingMessage, senderPubkey: string): Promise<void>;
+    private isMessageForUs;
+    private handleHello;
+    private handleOffer;
+    private handleAnswer;
+    private handleIceCandidate;
+    private shouldConnect;
+    private getPoolCount;
+    /**
+     * Check if we already have a connection from this pubkey in the 'other' pool.
+     * In the 'other' pool, we only allow 1 connection per pubkey to prevent spam.
+     */
+    private hasOtherPoolPubkey;
+    private createPeer;
+    private createOutboundPeer;
+    private closePeer;
+    /**
+     * Handle event from main thread proxy
+     */
+    handleProxyEvent(event: WebRTCEvent): void;
+    private onPeerCreated;
+    private onPeerStateChange;
+    private onPeerClosed;
+    private onOfferCreated;
+    private onAnswerCreated;
+    private onDescriptionSet;
+    private onIceCandidate;
+    private onDataChannelOpen;
+    private onDataChannelClose;
+    private onDataChannelError;
+    private onBufferHigh;
+    private onBufferLow;
+    private processDeferredRequests;
+    private orderedConnectedPeers;
+    private peerMetadataPointerHash;
+    private createInFlightRequest;
+    private waitForInFlightResult;
+    private clearPendingHashFromPeers;
+    private reservePeerRequest;
+    private releasePeerRequest;
+    /**
+     * Persist selector metadata snapshot to local store.
+     * Returns the snapshot hash.
+     */
+    persistPeerMetadata(): Promise<Uint8Array | null>;
+    /**
+     * Load selector metadata snapshot from local store.
+     */
+    loadPeerMetadata(): Promise<boolean>;
+    private sendDataToPeer;
+    private onDataChannelMessage;
+    private handleRequest;
+    private processRequest;
+    private handleResponse;
+    private sendResponse;
+    private sendRequestToPeer;
+    private queryPeersWithDispatch;
+    /**
+     * Request data from peers
+     */
+    get(hash: Uint8Array): Promise<Uint8Array | null>;
+    /**
+     * Get peer stats for UI
+     */
+    getPeerStats(): Array<{
+        peerId: string;
+        pubkey: string;
+        connected: boolean;
+        pool: PeerPool;
+        requestsSent: number;
+        requestsReceived: number;
+        responsesSent: number;
+        responsesReceived: number;
+        bytesSent: number;
+        bytesReceived: number;
+        forwardedRequests: number;
+        forwardedResolved: number;
+        forwardedSuppressed: number;
+    }>;
+    /**
+     * Get connected peer count
+     */
+    getConnectedCount(): number;
+    /**
+     * Set pool configuration
+     */
+    setPoolConfig(config: {
+        follows: {
+            max: number;
+            satisfied: number;
+        };
+        other: {
+            max: number;
+            satisfied: number;
+        };
+    }): void;
+    setForwardRateLimit(config?: {
+        maxForwardsPerPeerWindow?: number;
+        windowMs?: number;
+    }): void;
+    /**
+     * Update identity (pubkey) and restart signaling if already running.
+     * This keeps peerId consistent with the current account.
+     */
+    setIdentity(pubkey: string): void;
+    private log;
+}
+//# sourceMappingURL=webrtcController.d.ts.map

package/dist/p2p/webrtcController.d.ts.map

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