@hashtree/core 0.1.0

package/dist/verify.js

@@ -0,0 +1,32 @@
+/**
+ * Tree verification utilities
+ */
+import { toHex } from './types.js';
+import { tryDecodeTreeNode } from './codec.js';
+/**
+ * Verify tree integrity - checks that all referenced hashes exist
+ */
+export async function verifyTree(store, rootHash) {
+    const missing = [];
+    const visited = new Set();
+    async function check(hash) {
+        const hex = toHex(hash);
+        if (visited.has(hex))
+            return;
+        visited.add(hex);
+        const data = await store.get(hash);
+        if (!data) {
+            missing.push(hash);
+            return;
+        }
+        const node = tryDecodeTreeNode(data);
+        if (node) {
+            for (const link of node.links) {
+                await check(link.hash);
+            }
+        }
+    }
+    await check(rootHash);
+    return { valid: missing.length === 0, missing };
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,KAAK,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAY,EACZ,QAAc;IAEd,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,UAAU,KAAK,CAAC,IAAU;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEtB,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/visibility.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Tree visibility and encryption utilities
+ *
+ * ## Encryption Modes
+ *
+ * - **Unencrypted**: No CHK, just hash - anyone with hash can read
+ * - **Public**: CHK encrypted, ["key", "<hex>"] in event - anyone can decrypt
+ * - **Link-visible**: CHK + XOR mask, ["encryptedKey", XOR(key,secret)] - need #k=<secret> URL
+ * - **Private**: CHK + NIP-44 to self, ["selfEncryptedKey", "..."] - author only
+ *
+ * Default is Public (CHK encrypted, key in nostr event).
+ */
+/**
+ * Tree visibility levels
+ */
+export type TreeVisibility = 'public' | 'link-visible' | 'private';
+/**
+ * Generate a random 32-byte link key for link-visible trees
+ */
+export declare function generateLinkKey(): Uint8Array;
+/**
+ * Compute keyId from link key (first 8 bytes of SHA-256 hash)
+ * Used to identify which link key was used without revealing the key
+ */
+export declare function computeKeyId(linkKey: Uint8Array): Promise<Uint8Array>;
+/**
+ * Encrypt a CHK key for link-visible visibility using XOR (one-time pad)
+ * @param chkKey - The CHK key to encrypt (32 bytes)
+ * @param linkKey - The link decryption key (32 bytes)
+ * @returns Encrypted key (32 bytes) - XOR of chkKey and linkKey
+ */
+export declare function encryptKeyForLink(chkKey: Uint8Array, linkKey: Uint8Array): Uint8Array;
+/**
+ * Decrypt a CHK key for link-visible visibility
+ * Supports both new XOR format (32 bytes) and legacy AES-GCM format (60 bytes)
+ * @param encryptedKey - Encrypted key (32 bytes for XOR, 60 bytes for AES-GCM)
+ * @param linkKey - The link decryption key (32 bytes)
+ * @returns Decrypted CHK key (32 bytes), or null if decryption fails
+ */
+export declare function decryptKeyFromLink(encryptedKey: Uint8Array, linkKey: Uint8Array): Promise<Uint8Array | null>;
+/**
+ * Hex string versions of the encryption functions for convenience
+ */
+export declare const hex: {
+    generateLinkKey(): string;
+    computeKeyId(linkKeyHex: string): Promise<string>;
+    encryptKeyForLink(chkKeyHex: string, linkKeyHex: string): string;
+    decryptKeyFromLink(encryptedKeyHex: string, linkKeyHex: string): Promise<string | null>;
+};
+//# sourceMappingURL=visibility.d.ts.map

package/dist/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../src/visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AAEnE;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAG3E;AA2CD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAErF;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgBlH;AAED;;GAEG;AACH,eAAO,MAAM,GAAG;uBACK,MAAM;6BAIM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iCAK1B,MAAM,cAAc,MAAM,GAAG,MAAM;wCAKtB,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAI9F,CAAC"}

package/dist/visibility.js

@@ -0,0 +1,111 @@
+/**
+ * Tree visibility and encryption utilities
+ *
+ * ## Encryption Modes
+ *
+ * - **Unencrypted**: No CHK, just hash - anyone with hash can read
+ * - **Public**: CHK encrypted, ["key", "<hex>"] in event - anyone can decrypt
+ * - **Link-visible**: CHK + XOR mask, ["encryptedKey", XOR(key,secret)] - need #k=<secret> URL
+ * - **Private**: CHK + NIP-44 to self, ["selfEncryptedKey", "..."] - author only
+ *
+ * Default is Public (CHK encrypted, key in nostr event).
+ */
+import { sha256 } from './hash.js';
+import { toHex, fromHex } from './types.js';
+/**
+ * Generate a random 32-byte link key for link-visible trees
+ */
+export function generateLinkKey() {
+    return crypto.getRandomValues(new Uint8Array(32));
+}
+/**
+ * Compute keyId from link key (first 8 bytes of SHA-256 hash)
+ * Used to identify which link key was used without revealing the key
+ */
+export async function computeKeyId(linkKey) {
+    const hash = await sha256(linkKey);
+    return hash.slice(0, 8);
+}
+/**
+ * XOR two 32-byte arrays
+ * Used for encrypting/decrypting CHK keys with link keys.
+ * XOR with random key is one-time pad (information-theoretically secure).
+ */
+function xor32(a, b) {
+    const result = new Uint8Array(32);
+    for (let i = 0; i < 32; i++) {
+        result[i] = a[i] ^ b[i];
+    }
+    return result;
+}
+/**
+ * Legacy AES-GCM decryption for backward compatibility
+ * Old format: 12-byte nonce + ciphertext + 16-byte tag = 60 bytes total
+ */
+async function decryptAesGcm(encryptedKey, linkKey) {
+    try {
+        const keyBuffer = new ArrayBuffer(linkKey.length);
+        new Uint8Array(keyBuffer).set(linkKey);
+        const nonce = encryptedKey.slice(0, 12);
+        const ciphertext = encryptedKey.slice(12);
+        const ciphertextBuffer = new ArrayBuffer(ciphertext.length);
+        new Uint8Array(ciphertextBuffer).set(ciphertext);
+        const cryptoKey = await crypto.subtle.importKey('raw', keyBuffer, { name: 'AES-GCM' }, false, ['decrypt']);
+        const plaintext = await crypto.subtle.decrypt({ name: 'AES-GCM', iv: nonce }, cryptoKey, ciphertextBuffer);
+        return new Uint8Array(plaintext);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Encrypt a CHK key for link-visible visibility using XOR (one-time pad)
+ * @param chkKey - The CHK key to encrypt (32 bytes)
+ * @param linkKey - The link decryption key (32 bytes)
+ * @returns Encrypted key (32 bytes) - XOR of chkKey and linkKey
+ */
+export function encryptKeyForLink(chkKey, linkKey) {
+    return xor32(chkKey, linkKey);
+}
+/**
+ * Decrypt a CHK key for link-visible visibility
+ * Supports both new XOR format (32 bytes) and legacy AES-GCM format (60 bytes)
+ * @param encryptedKey - Encrypted key (32 bytes for XOR, 60 bytes for AES-GCM)
+ * @param linkKey - The link decryption key (32 bytes)
+ * @returns Decrypted CHK key (32 bytes), or null if decryption fails
+ */
+export async function decryptKeyFromLink(encryptedKey, linkKey) {
+    if (linkKey.length !== 32) {
+        return null;
+    }
+    // New XOR format: 32 bytes
+    if (encryptedKey.length === 32) {
+        return xor32(encryptedKey, linkKey);
+    }
+    // Legacy AES-GCM format: 60 bytes (12 nonce + 32 ciphertext + 16 tag)
+    if (encryptedKey.length === 60) {
+        return decryptAesGcm(encryptedKey, linkKey);
+    }
+    return null;
+}
+/**
+ * Hex string versions of the encryption functions for convenience
+ */
+export const hex = {
+    generateLinkKey() {
+        return toHex(generateLinkKey());
+    },
+    async computeKeyId(linkKeyHex) {
+        const keyId = await computeKeyId(fromHex(linkKeyHex));
+        return toHex(keyId);
+    },
+    encryptKeyForLink(chkKeyHex, linkKeyHex) {
+        const encrypted = encryptKeyForLink(fromHex(chkKeyHex), fromHex(linkKeyHex));
+        return toHex(encrypted);
+    },
+    async decryptKeyFromLink(encryptedKeyHex, linkKeyHex) {
+        const decrypted = await decryptKeyFromLink(fromHex(encryptedKeyHex), fromHex(linkKeyHex));
+        return decrypted ? toHex(decrypted) : null;
+    },
+};
+//# sourceMappingURL=visibility.js.map

package/dist/visibility.js.map

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

package/dist/webrtc/index.d.ts

@@ -0,0 +1,4 @@
+export { WebRTCStore, DEFAULT_RELAYS } from './store.js';
+export { Peer } from './peer.js';
+export { PeerId, generateUuid, type SignalingMessage, type WebRTCStoreConfig, type PeerStatus, type WebRTCStoreEvent, type WebRTCStoreEventHandler, type EventSigner, type EventEncrypter, type EventDecrypter, type GiftWrapper, type GiftUnwrapper, type SignedEvent, type PeerPool, type PeerClassifier, type PoolConfig, type WebRTCStats, type BandwidthSample, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/webrtc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webrtc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,MAAM,EACN,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/webrtc/index.js

@@ -0,0 +1,4 @@
+export { WebRTCStore, DEFAULT_RELAYS } from './store.js';
+export { Peer } from './peer.js';
+export { PeerId, generateUuid, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/webrtc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/webrtc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,MAAM,EACN,YAAY,GAiBb,MAAM,YAAY,CAAC"}

package/dist/webrtc/lruCache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Simple LRU Cache implementation
+ */
+export declare class LRUCache<K, V> {
+    private cache;
+    private maxSize;
+    constructor(maxSize?: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+    forEach(callback: (value: V, key: K) => void): void;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
+}
+//# sourceMappingURL=lruCache.d.ts.map

package/dist/webrtc/lruCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lruCache.d.ts","sourceRoot":"","sources":["../../src/webrtc/lruCache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAY;IAIjC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAU1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAe3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI3B,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI5B,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAIpC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAInD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAG9C"}

package/dist/webrtc/lruCache.js

@@ -0,0 +1,59 @@
+/**
+ * Simple LRU Cache implementation
+ */
+export class LRUCache {
+    cache = new Map();
+    maxSize;
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        // Delete first to reset position if exists
+        this.cache.delete(key);
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.maxSize) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined) {
+                this.cache.delete(oldest);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+    keys() {
+        return this.cache.keys();
+    }
+    values() {
+        return this.cache.values();
+    }
+    *entries() {
+        yield* this.cache.entries();
+    }
+    forEach(callback) {
+        this.cache.forEach(callback);
+    }
+    [Symbol.iterator]() {
+        return this.entries();
+    }
+}
+//# sourceMappingURL=lruCache.js.map

package/dist/webrtc/lruCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lruCache.js","sourceRoot":"","sources":["../../src/webrtc/lruCache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACX,KAAK,GAAG,IAAI,GAAG,EAAQ,CAAC;IACxB,OAAO,CAAS;IAExB,YAAY,UAAkB,GAAG;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,2CAA2C;QAC3C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEvB,8BAA8B;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,CAAC,OAAO;QACN,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,QAAoC;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/webrtc/peer.d.ts

@@ -0,0 +1,122 @@
+/**
+ * WebRTC peer connection for hashtree data exchange
+ */
+import type { Store, Hash } from '../types.js';
+import type { SignalingMessage, PeerId } from './types.js';
+export declare class Peer {
+    readonly peerId: string;
+    readonly pubkey: string;
+    readonly direction: 'inbound' | 'outbound';
+    private pc;
+    private dataChannel;
+    private localStore;
+    private sendSignaling;
+    private onClose;
+    private onConnected?;
+    private onConnectedFired;
+    private debug;
+    private makingOffer;
+    private ignoreOffer;
+    private isPolite;
+    private myPeerId;
+    private ourRequests;
+    private theirRequests;
+    private requestTimeout;
+    private pendingCandidates;
+    private candidateBatchTimeout;
+    private queuedRemoteCandidates;
+    private onForwardRequest?;
+    private stats;
+    private pendingReassemblies;
+    private reassemblyCleanupInterval?;
+    private htlConfig;
+    readonly createdAt: number;
+    connectedAt?: number;
+    constructor(options: {
+        peerId: PeerId;
+        myPeerId: string;
+        direction: 'inbound' | 'outbound';
+        localStore: Store | null;
+        sendSignaling: (msg: SignalingMessage) => Promise<void>;
+        onClose: () => void;
+        onConnected?: () => void;
+        onForwardRequest?: (hash: Uint8Array, excludePeerId: string, htl: number) => Promise<Uint8Array | null>;
+        requestTimeout?: number;
+        debug?: boolean;
+    });
+    private log;
+    get state(): RTCPeerConnectionState;
+    get isConnected(): boolean;
+    get pendingTheirRequestsCount(): number;
+    private scheduleCandidateBatch;
+    private setupPeerConnection;
+    private setupDataChannel;
+    private handleMessage;
+    private handleRequest;
+    private sendResponse;
+    /**
+     * Handle a fragmented response - buffer and reassemble
+     * Returns assembled data when complete, null when waiting for more fragments
+     */
+    private handleFragmentResponse;
+    /**
+     * Assemble fragments in order into a single buffer
+     */
+    private assembleFragments;
+    /**
+     * Clean up stale reassemblies (stalled or timed out)
+     */
+    private cleanupStaleReassemblies;
+    /**
+     * Request data by hash from this peer
+     * @param htl Hops To Live - decremented before sending
+     */
+    request(hash: Hash, htl?: number): Promise<Uint8Array | null>;
+    /**
+     * Get per-peer statistics
+     */
+    getStats(): {
+        requestsSent: number;
+        requestsReceived: number;
+        responsesSent: number;
+        responsesReceived: number;
+        receiveErrors: number;
+        fragmentsSent: number;
+        fragmentsReceived: number;
+        fragmentTimeouts: number;
+        reassembliesCompleted: number;
+        bytesSent: number;
+        bytesReceived: number;
+        bytesForwarded: number;
+    };
+    /**
+     * Send data to this peer for a hash they previously requested
+     * Returns true if this peer had requested this hash
+     */
+    sendData(hash: Uint8Array, data: Uint8Array): boolean;
+    /**
+     * Check if this peer has requested a hash
+     */
+    hasRequested(hash: Uint8Array): boolean;
+    /**
+     * Get count of pending requests from this peer
+     */
+    getTheirRequestCount(): number;
+    /**
+     * Initiate connection (create offer)
+     * Uses perfect negotiation pattern - both peers can call this
+     */
+    connect(): Promise<void>;
+    /**
+     * Handle incoming signaling message
+     * Implements perfect negotiation pattern for collision handling
+     */
+    handleSignaling(msg: SignalingMessage): Promise<void>;
+    private addRemoteCandidate;
+    private processQueuedCandidates;
+    /**
+     * Close the peer connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=peer.d.ts.map

package/dist/webrtc/peer.d.ts.map

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