npm - @dropgate/core - Versions diffs - 2.0.0-beta.1 → 2.1.0 - Mend

@dropgate/core 2.0.0-beta.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/dist/p2p/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/p2p/index.ts","../../src/errors.ts","../../src/utils/network.ts","../../src/adapters/defaults.ts","../../src/p2p/utils.ts","../../src/p2p/helpers.ts","../../src/p2p/send.ts","../../src/p2p/receive.ts"],"sourcesContent":["// P2P module exports\nexport { startP2PSend } from './send.js';\nexport { startP2PReceive } from './receive.js';\nexport { generateP2PCode, isP2PCodeLike, isLocalhostHostname, isSecureContextForP2P } from './utils.js';\nexport { buildPeerOptions, createPeerWithRetries } from './helpers.js';\n\n// Re-export types\nexport type {\n PeerConstructor,\n PeerInstance,\n PeerOptions,\n DataConnection,\n P2PSendOptions,\n P2PSendSession,\n P2PReceiveOptions,\n P2PReceiveSession,\n} from './types.js';\n","export interface DropgateErrorOptions {\n code?: string;\n details?: unknown;\n cause?: unknown;\n}\n\n/*\n Base error class for all Dropgate errors\n /\nexport class DropgateError extends Error {\n readonly code: string;\n readonly details?: unknown;\n\n constructor(message: string, opts: DropgateErrorOptions = {}) {\n super(message);\n this.name = this.constructor.name;\n this.code = opts.code \|\| 'DROPGATE_ERROR';\n this.details = opts.details;\n if (opts.cause !== undefined) {\n // Use Object.defineProperty for cause to maintain compatibility\n Object.defineProperty(this, 'cause', {\n value: opts.cause,\n writable: false,\n enumerable: false,\n configurable: true,\n });\n }\n }\n}\n\n/\n Validation error for invalid inputs\n /\nexport class DropgateValidationError extends DropgateError {\n constructor(message: string, opts: DropgateErrorOptions = {}) {\n super(message, { ...opts, code: opts.code \|\| 'VALIDATION_ERROR' });\n }\n}\n\n/\n Network error for connection issues\n /\nexport class DropgateNetworkError extends DropgateError {\n constructor(message: string, opts: DropgateErrorOptions = {}) {\n super(message, { ...opts, code: opts.code \|\| 'NETWORK_ERROR' });\n }\n}\n\n/\n Protocol error for server communication issues\n /\nexport class DropgateProtocolError extends DropgateError {\n constructor(message: string, opts: DropgateErrorOptions = {}) {\n super(message, { ...opts, code: opts.code \|\| 'PROTOCOL_ERROR' });\n }\n}\n\n/\n Abort error - replacement for DOMException with AbortError name\n * Used when operations are cancelled\n /\nexport class DropgateAbortError extends DropgateError {\n constructor(message = 'Operation aborted') {\n super(message, { code: 'ABORT_ERROR' });\n this.name = 'AbortError';\n }\n}\n\n/\n Timeout error - replacement for DOMException with TimeoutError name\n * Used when operations exceed their time limit\n /\nexport class DropgateTimeoutError extends DropgateError {\n constructor(message = 'Request timed out') {\n super(message, { code: 'TIMEOUT_ERROR' });\n this.name = 'TimeoutError';\n }\n}\n","import { DropgateAbortError, DropgateTimeoutError, DropgateValidationError } from '../errors.js';\nimport type { FetchFn, ServerTarget } from '../types.js';\n\n/\n Parse a server URL string into host, port, and secure components.\n * If no protocol is specified, defaults to HTTPS.\n /\nexport function parseServerUrl(urlStr: string): ServerTarget {\n let normalized = urlStr.trim();\n if (!normalized.startsWith('http://') && !normalized.startsWith('https://')) {\n normalized = 'https://' + normalized;\n }\n const url = new URL(normalized);\n return {\n host: url.hostname,\n port: url.port ? Number(url.port) : undefined,\n secure: url.protocol === 'https:',\n };\n}\n\n/\n Build a base URL from host, port, and secure options.\n /\nexport function buildBaseUrl(opts: ServerTarget): string {\n const { host, port, secure } = opts;\n\n if (!host \|\| typeof host !== 'string') {\n throw new DropgateValidationError('Server host is required.');\n }\n\n const protocol = secure === false ? 'http' : 'https';\n const portSuffix = port ? `:${port}` : '';\n\n return `${protocol}://${host}${portSuffix}`;\n}\n\n/\n Sleep for a specified duration, with optional abort signal support.\n /\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise((resolve, reject) => {\n if (signal?.aborted) {\n return reject(signal.reason \|\| new DropgateAbortError());\n }\n\n const t = setTimeout(resolve, ms);\n\n if (signal) {\n signal.addEventListener(\n 'abort',\n () => {\n clearTimeout(t);\n reject(signal.reason \|\| new DropgateAbortError());\n },\n { once: true }\n );\n }\n });\n}\n\nexport interface AbortSignalWithCleanup {\n signal: AbortSignal;\n cleanup: () => void;\n}\n\n/\n Create an AbortSignal that combines a parent signal with a timeout.\n /\nexport function makeAbortSignal(\n parentSignal?: AbortSignal \| null,\n timeoutMs?: number\n): AbortSignalWithCleanup {\n const controller = new AbortController();\n let timeoutId: ReturnType<typeof setTimeout> \| null = null;\n\n const abort = (reason?: unknown): void => {\n if (!controller.signal.aborted) {\n controller.abort(reason);\n }\n };\n\n if (parentSignal) {\n if (parentSignal.aborted) {\n abort(parentSignal.reason);\n } else {\n parentSignal.addEventListener('abort', () => abort(parentSignal.reason), {\n once: true,\n });\n }\n }\n\n if (Number.isFinite(timeoutMs) && timeoutMs! > 0) {\n timeoutId = setTimeout(() => {\n abort(new DropgateTimeoutError());\n }, timeoutMs);\n }\n\n return {\n signal: controller.signal,\n cleanup: () => {\n if (timeoutId) clearTimeout(timeoutId);\n },\n };\n}\n\nexport interface FetchJsonResult {\n res: Response;\n json: unknown;\n text: string;\n}\n\nexport interface FetchJsonOptions extends Omit<RequestInit, 'signal'> {\n timeoutMs?: number;\n signal?: AbortSignal;\n}\n\n/\n Fetch JSON from a URL with timeout and error handling.\n /\nexport async function fetchJson(\n fetchFn: FetchFn,\n url: string,\n opts: FetchJsonOptions = {}\n): Promise<FetchJsonResult> {\n const { timeoutMs, signal, ...rest } = opts;\n const { signal: s, cleanup } = makeAbortSignal(signal, timeoutMs);\n\n try {\n const res = await fetchFn(url, { ...rest, signal: s });\n const text = await res.text();\n\n let json: unknown = null;\n try {\n json = text ? JSON.parse(text) : null;\n } catch {\n // Ignore parse errors - json will remain null\n }\n\n return { res, json, text };\n } finally {\n cleanup();\n }\n}\n","import type { Base64Adapter, CryptoAdapter, FetchFn } from '../types.js';\n\n/\n Get the default Base64 adapter for the current environment.\n * Automatically detects Node.js Buffer vs browser btoa/atob.\n /\nexport function getDefaultBase64(): Base64Adapter {\n // Check for Node.js Buffer (works in Node.js and some bundlers)\n if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\n return {\n encode(bytes: Uint8Array): string {\n return Buffer.from(bytes).toString('base64');\n },\n decode(b64: string): Uint8Array {\n return new Uint8Array(Buffer.from(b64, 'base64'));\n },\n };\n }\n\n // Browser fallback using btoa/atob\n if (typeof btoa === 'function' && typeof atob === 'function') {\n return {\n encode(bytes: Uint8Array): string {\n let binary = '';\n for (let i = 0; i < bytes.length; i++) {\n binary += String.fromCharCode(bytes[i]);\n }\n return btoa(binary);\n },\n decode(b64: string): Uint8Array {\n const binary = atob(b64);\n const out = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n out[i] = binary.charCodeAt(i);\n }\n return out;\n },\n };\n }\n\n throw new Error(\n 'No Base64 implementation available. Provide a Base64Adapter via options.'\n );\n}\n\n/\n Get the default crypto object for the current environment.\n * Returns globalThis.crypto if available.\n /\nexport function getDefaultCrypto(): CryptoAdapter \| undefined {\n return globalThis.crypto as CryptoAdapter \| undefined;\n}\n\n/\n Get the default fetch function for the current environment.\n * Returns globalThis.fetch if available.\n /\nexport function getDefaultFetch(): FetchFn \| undefined {\n return globalThis.fetch?.bind(globalThis) as FetchFn \| undefined;\n}\n","import type { CryptoAdapter } from '../types.js';\nimport { getDefaultCrypto } from '../adapters/defaults.js';\n\n/\n Check if a hostname is localhost\n /\nexport function isLocalhostHostname(hostname: string): boolean {\n const host = String(hostname \|\| '').toLowerCase();\n return host === 'localhost' \|\| host === '127.0.0.1' \|\| host === '::1';\n}\n\n/\n Check if the current context allows P2P (HTTPS or localhost)\n /\nexport function isSecureContextForP2P(\n hostname?: string,\n isSecureContext?: boolean\n): boolean {\n return Boolean(isSecureContext) \|\| isLocalhostHostname(hostname \|\| '');\n}\n\n/\n Generate a P2P sharing code using cryptographically secure random.\n * Format: XXXX-0000 (4 letters + 4 digits)\n /\nexport function generateP2PCode(cryptoObj?: CryptoAdapter): string {\n const crypto = cryptoObj \|\| getDefaultCrypto();\n const letters = 'ABCDEFGHJKLMNPQRSTUVWXYZ'; // Excluded I and O to avoid confusion\n\n if (crypto) {\n const randomBytes = new Uint8Array(8);\n crypto.getRandomValues(randomBytes);\n\n let letterPart = '';\n for (let i = 0; i < 4; i++) {\n letterPart += letters[randomBytes[i] % letters.length];\n }\n\n let numberPart = '';\n for (let i = 4; i < 8; i++) {\n numberPart += (randomBytes[i] % 10).toString();\n }\n\n return `${letterPart}-${numberPart}`;\n }\n\n // Fallback to Math.random (less secure, but works everywhere)\n let a = '';\n for (let i = 0; i < 4; i++) {\n a += letters[Math.floor(Math.random() letters.length)];\n }\n let b = '';\n for (let i = 0; i < 4; i++) {\n b += Math.floor(Math.random() * 10);\n }\n return `${a}-${b}`;\n}\n\n/*\n Check if a string looks like a P2P sharing code\n /\nexport function isP2PCodeLike(code: string): boolean {\n return /^[A-Z]{4}-\\d{4}$/.test(String(code \|\| '').trim());\n}\n","import { DropgateNetworkError } from '../errors.js';\nimport type { PeerInstance, PeerOptions } from './types.js';\n\nexport interface BuildPeerOptionsInput {\n host?: string;\n port?: number;\n peerjsPath?: string;\n secure?: boolean;\n iceServers?: RTCIceServer[];\n}\n\n/\n Build PeerJS connection options\n /\nexport function buildPeerOptions(opts: BuildPeerOptionsInput = {}): PeerOptions {\n const { host, port, peerjsPath = '/peerjs', secure = false, iceServers = [] } = opts;\n\n const peerOpts: PeerOptions = {\n host,\n path: peerjsPath,\n secure,\n config: { iceServers },\n debug: 0,\n };\n\n if (port) {\n peerOpts.port = port;\n }\n\n return peerOpts;\n}\n\nexport interface CreatePeerWithRetriesOptions {\n code?: string \| null;\n codeGenerator: () => string;\n maxAttempts: number;\n buildPeer: (id: string) => PeerInstance;\n onCode?: (code: string, attempt: number) => void;\n}\n\n/\n Create a peer with retries if the code is already taken\n /\nexport async function createPeerWithRetries(\n opts: CreatePeerWithRetriesOptions\n): Promise<{ peer: PeerInstance; code: string }> {\n const { code, codeGenerator, maxAttempts, buildPeer, onCode } = opts;\n\n let nextCode = code \|\| codeGenerator();\n let peer: PeerInstance \| null = null;\n let lastError: Error \| null = null;\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n onCode?.(nextCode, attempt);\n\n try {\n peer = await new Promise<PeerInstance>((resolve, reject) => {\n const instance = buildPeer(nextCode);\n instance.on('open', () => resolve(instance));\n instance.on('error', (err: Error) => {\n try {\n instance.destroy();\n } catch {\n // Ignore destroy errors\n }\n reject(err);\n });\n });\n\n return { peer, code: nextCode };\n } catch (err) {\n lastError = err as Error;\n nextCode = codeGenerator();\n }\n }\n\n throw lastError \|\| new DropgateNetworkError('Could not establish PeerJS connection.');\n}\n","import { DropgateValidationError, DropgateNetworkError } from '../errors.js';\nimport { sleep } from '../utils/network.js';\nimport type { P2PSendOptions, P2PSendSession, DataConnection } from './types.js';\nimport { generateP2PCode } from './utils.js';\nimport { buildPeerOptions, createPeerWithRetries } from './helpers.js';\n\n/\n Start a direct transfer (P2P) sender session.\n \n IMPORTANT: Consumer must provide the PeerJS Peer constructor.\n * This removes DOM coupling (no script injection).\n \n Example:\n * ```js\n * import Peer from 'peerjs';\n * import { startP2PSend } from '@dropgate/core/p2p';\n \n const session = await startP2PSend({\n * file: myFile,\n * Peer,\n * host: 'dropgate.link',\n * secure: true,\n * onCode: (code) => console.log('Share this code:', code),\n * onProgress: (evt) => console.log(`${evt.percent}% sent`),\n * onComplete: () => console.log('Done!'),\n * });\n * ```\n /\nexport async function startP2PSend(opts: P2PSendOptions): Promise<P2PSendSession> {\n const {\n file,\n Peer,\n serverInfo,\n host,\n port,\n peerjsPath,\n secure = false,\n iceServers,\n codeGenerator,\n cryptoObj,\n maxAttempts = 4,\n chunkSize = 256 1024,\n readyTimeoutMs = 8000,\n endAckTimeoutMs = 15000,\n bufferHighWaterMark = 8 * 1024 * 1024,\n bufferLowWaterMark = 2 * 1024 * 1024,\n onCode,\n onStatus,\n onProgress,\n onComplete,\n onError,\n } = opts;\n\n // Validate required options\n if (!file) {\n throw new DropgateValidationError('File is missing.');\n }\n\n if (!Peer) {\n throw new DropgateValidationError(\n 'PeerJS Peer constructor is required. Install peerjs and pass it as the Peer option.'\n );\n }\n\n // Check P2P capabilities if serverInfo is provided\n const p2pCaps = serverInfo?.capabilities?.p2p;\n if (serverInfo && !p2pCaps?.enabled) {\n throw new DropgateValidationError('Direct transfer is disabled on this server.');\n }\n\n // Determine options (use serverInfo if available)\n const finalPath = peerjsPath ?? p2pCaps?.peerjsPath ?? '/peerjs';\n const finalIceServers = iceServers ?? p2pCaps?.iceServers ?? [];\n\n // Build peer options\n const peerOpts = buildPeerOptions({\n host,\n port,\n peerjsPath: finalPath,\n secure,\n iceServers: finalIceServers,\n });\n\n // Create the code generator\n const finalCodeGenerator = codeGenerator \|\| (() => generateP2PCode(cryptoObj));\n\n // Create peer with retries\n const buildPeer = (id: string) => new Peer(id, peerOpts);\n const { peer, code } = await createPeerWithRetries({\n code: null,\n codeGenerator: finalCodeGenerator,\n maxAttempts,\n buildPeer,\n onCode,\n });\n\n let stopped = false;\n let activeConn: DataConnection \| null = null;\n let transferActive = false;\n let transferCompleted = false;\n\n const reportProgress = (data: { received: number; total: number }): void => {\n const safeTotal =\n Number.isFinite(data.total) && data.total > 0 ? data.total : file.size;\n const safeReceived = Math.min(Number(data.received) \|\| 0, safeTotal \|\| 0);\n const percent = safeTotal ? (safeReceived / safeTotal) * 100 : 0;\n onProgress?.({ sent: safeReceived, total: safeTotal, percent });\n };\n\n const stop = (): void => {\n stopped = true;\n try {\n activeConn?.close();\n } catch {\n // Ignore close errors\n }\n try {\n peer.destroy();\n } catch {\n // Ignore destroy errors\n }\n };\n\n peer.on('connection', (conn: DataConnection) => {\n if (stopped) return;\n\n if (activeConn) {\n try {\n conn.send({ t: 'error', message: 'Another receiver is already connected.' });\n } catch {\n // Ignore send errors\n }\n try {\n conn.close();\n } catch {\n // Ignore close errors\n }\n return;\n }\n\n activeConn = conn;\n onStatus?.({ phase: 'connected', message: 'Connected. Starting transfer...' });\n\n let readyResolve: (() => void) \| null = null;\n let ackResolve: ((data: unknown) => void) \| null = null;\n\n const readyPromise = new Promise<void>((resolve) => {\n readyResolve = resolve;\n });\n\n const ackPromise = new Promise<unknown>((resolve) => {\n ackResolve = resolve;\n });\n\n conn.on('data', (data: unknown) => {\n if (\n !data \|\|\n typeof data !== 'object' \|\|\n data instanceof ArrayBuffer \|\|\n ArrayBuffer.isView(data)\n ) {\n return;\n }\n\n const msg = data as { t?: string; received?: number; total?: number; phase?: string; message?: string };\n if (!msg.t) return;\n\n if (msg.t === 'ready') {\n readyResolve?.();\n return;\n }\n\n if (msg.t === 'progress') {\n reportProgress({ received: msg.received \|\| 0, total: msg.total \|\| 0 });\n return;\n }\n\n if (msg.t === 'ack' && msg.phase === 'end') {\n ackResolve?.(msg);\n return;\n }\n\n if (msg.t === 'error') {\n onError?.(new DropgateNetworkError(msg.message \|\| 'Receiver reported an error.'));\n stop();\n }\n });\n\n conn.on('open', async () => {\n try {\n transferActive = true;\n if (stopped) return;\n\n conn.send({\n t: 'meta',\n name: file.name,\n size: file.size,\n mime: file.type \|\| 'application/octet-stream',\n });\n\n let sent = 0;\n const total = file.size;\n const dc = conn._dc;\n\n if (dc && Number.isFinite(bufferLowWaterMark)) {\n try {\n dc.bufferedAmountLowThreshold = bufferLowWaterMark;\n } catch {\n // Ignore threshold setting errors\n }\n }\n\n // Wait for ready signal\n await Promise.race([readyPromise, sleep(readyTimeoutMs).catch(() => null)]);\n\n // Send file in chunks\n for (let offset = 0; offset < total; offset += chunkSize) {\n if (stopped) return;\n\n const slice = file.slice(offset, offset + chunkSize);\n const buf = await slice.arrayBuffer();\n conn.send(buf);\n sent += buf.byteLength;\n\n // Flow control\n if (dc) {\n while (dc.bufferedAmount > bufferHighWaterMark) {\n await new Promise<void>((resolve) => {\n const fallback = setTimeout(resolve, 60);\n try {\n dc.addEventListener(\n 'bufferedamountlow',\n () => {\n clearTimeout(fallback);\n resolve();\n },\n { once: true }\n );\n } catch {\n // Fallback only\n }\n });\n }\n }\n }\n\n if (stopped) return;\n conn.send({ t: 'end' });\n\n // Wait for acknowledgment\n const ackTimeoutMs = Number.isFinite(endAckTimeoutMs)\n ? Math.max(endAckTimeoutMs, Math.ceil(file.size / (1024 * 1024)) * 1000)\n : null;\n\n const ackResult = await Promise.race([\n ackPromise,\n sleep(ackTimeoutMs \|\| 15000).catch(() => null),\n ]);\n\n if (!ackResult \|\| typeof ackResult !== 'object') {\n throw new DropgateNetworkError('Receiver did not confirm completion.');\n }\n\n const ackData = ackResult as { total?: number; received?: number };\n const ackTotal = Number(ackData.total) \|\| file.size;\n const ackReceived = Number(ackData.received) \|\| 0;\n\n if (ackTotal && ackReceived < ackTotal) {\n throw new DropgateNetworkError('Receiver reported an incomplete transfer.');\n }\n\n reportProgress({ received: ackReceived \|\| ackTotal, total: ackTotal });\n transferCompleted = true;\n transferActive = false;\n onComplete?.();\n stop();\n } catch (err) {\n onError?.(err as Error);\n stop();\n }\n });\n\n conn.on('error', (err: Error) => {\n onError?.(err);\n stop();\n });\n\n conn.on('close', () => {\n if (!transferCompleted && transferActive && !stopped) {\n onError?.(\n new DropgateNetworkError('Receiver disconnected before transfer completed.')\n );\n }\n stop();\n });\n });\n\n return { peer, code, stop };\n}\n","import { DropgateValidationError, DropgateNetworkError } from '../errors.js';\nimport type { P2PReceiveOptions, P2PReceiveSession } from './types.js';\nimport { isP2PCodeLike } from './utils.js';\nimport { buildPeerOptions } from './helpers.js';\n\n/*\n Start a direct transfer (P2P) receiver session.\n \n IMPORTANT: Consumer must provide the PeerJS Peer constructor and handle file writing.\n * This removes DOM coupling (no streamSaver).\n \n Example:\n * ```js\n * import Peer from 'peerjs';\n * import { startP2PReceive } from '@dropgate/core/p2p';\n \n let writer;\n * const session = await startP2PReceive({\n * code: 'ABCD-1234',\n * Peer,\n * host: 'dropgate.link',\n * secure: true,\n * onMeta: ({ name, total }) => {\n * // Consumer creates file writer\n * writer = createWriteStream(name);\n * },\n * onData: async (chunk) => {\n * // Consumer writes data\n * await writer.write(chunk);\n * },\n * onComplete: () => {\n * writer.close();\n * console.log('Done!');\n * },\n * });\n * ```\n /\nexport async function startP2PReceive(opts: P2PReceiveOptions): Promise<P2PReceiveSession> {\n const {\n code,\n Peer,\n serverInfo,\n host,\n port,\n peerjsPath,\n secure = false,\n iceServers,\n onStatus,\n onMeta,\n onData,\n onProgress,\n onComplete,\n onError,\n onDisconnect,\n } = opts;\n\n // Validate required options\n if (!code) {\n throw new DropgateValidationError('No sharing code was provided.');\n }\n\n if (!Peer) {\n throw new DropgateValidationError(\n 'PeerJS Peer constructor is required. Install peerjs and pass it as the Peer option.'\n );\n }\n\n // Check P2P capabilities if serverInfo is provided\n const p2pCaps = serverInfo?.capabilities?.p2p;\n if (serverInfo && !p2pCaps?.enabled) {\n throw new DropgateValidationError('Direct transfer is disabled on this server.');\n }\n\n // Validate and normalize code\n const normalizedCode = String(code).trim().replace(/\\s+/g, '').toUpperCase();\n if (!isP2PCodeLike(normalizedCode)) {\n throw new DropgateValidationError('Invalid direct transfer code.');\n }\n\n // Determine options (use serverInfo if available)\n const finalPath = peerjsPath ?? p2pCaps?.peerjsPath ?? '/peerjs';\n const finalIceServers = iceServers ?? p2pCaps?.iceServers ?? [];\n\n // Build peer options\n const peerOpts = buildPeerOptions({\n host,\n port,\n peerjsPath: finalPath,\n secure,\n iceServers: finalIceServers,\n });\n\n // Create peer (receiver doesn't need a specific ID)\n const peer = new Peer(undefined, peerOpts);\n\n let total = 0;\n let received = 0;\n let lastProgressSentAt = 0;\n const progressIntervalMs = 120;\n let writeQueue = Promise.resolve();\n\n const stop = (): void => {\n try {\n peer.destroy();\n } catch {\n // Ignore destroy errors\n }\n };\n\n peer.on('error', (err: Error) => {\n onError?.(err);\n stop();\n });\n\n peer.on('open', () => {\n const conn = peer.connect(normalizedCode, { reliable: true });\n\n conn.on('open', () => {\n onStatus?.({ phase: 'connected', message: 'Waiting for file details...' });\n });\n\n conn.on('data', async (data: unknown) => {\n try {\n // Handle control messages\n if (\n data &&\n typeof data === 'object' &&\n !(data instanceof ArrayBuffer) &&\n !ArrayBuffer.isView(data)\n ) {\n const msg = data as {\n t?: string;\n name?: string;\n size?: number;\n message?: string;\n };\n\n if (msg.t === 'meta') {\n const name = String(msg.name \|\| 'file');\n total = Number(msg.size) \|\| 0;\n received = 0;\n writeQueue = Promise.resolve();\n\n onMeta?.({ name, total });\n onProgress?.({ received, total, percent: 0 });\n\n try {\n conn.send({ t: 'ready' });\n } catch {\n // Ignore send errors\n }\n return;\n }\n\n if (msg.t === 'end') {\n await writeQueue;\n\n if (total && received < total) {\n const err = new DropgateNetworkError(\n 'Transfer ended before the full file was received.'\n );\n try {\n conn.send({ t: 'error', message: err.message });\n } catch {\n // Ignore send errors\n }\n throw err;\n }\n\n onComplete?.({ received, total });\n\n try {\n conn.send({ t: 'ack', phase: 'end', received, total });\n } catch {\n // Ignore send errors\n }\n return;\n }\n\n if (msg.t === 'error') {\n throw new DropgateNetworkError(msg.message \|\| 'Sender reported an error.');\n }\n\n return;\n }\n\n // Handle binary data\n let bufPromise: Promise<Uint8Array>;\n\n if (data instanceof ArrayBuffer) {\n bufPromise = Promise.resolve(new Uint8Array(data));\n } else if (ArrayBuffer.isView(data)) {\n bufPromise = Promise.resolve(\n new Uint8Array(data.buffer, data.byteOffset, data.byteLength)\n );\n } else if (typeof Blob !== 'undefined' && data instanceof Blob) {\n bufPromise = data.arrayBuffer().then((buffer) => new Uint8Array(buffer));\n } else {\n return;\n }\n\n writeQueue = writeQueue\n .then(async () => {\n const buf = await bufPromise;\n\n // Call consumer's onData handler\n if (onData) {\n await onData(buf);\n }\n\n received += buf.byteLength;\n const percent = total ? Math.min(100, (received / total) 100) : 0;\n onProgress?.({ received, total, percent });\n\n const now = Date.now();\n if (received === total \|\| now - lastProgressSentAt >= progressIntervalMs) {\n lastProgressSentAt = now;\n try {\n conn.send({ t: 'progress', received, total });\n } catch {\n // Ignore send errors\n }\n }\n })\n .catch((err) => {\n try {\n conn.send({\n t: 'error',\n message: (err as Error)?.message \|\| 'Receiver write failed.',\n });\n } catch {\n // Ignore send errors\n }\n onError?.(err as Error);\n stop();\n });\n } catch (err) {\n onError?.(err as Error);\n stop();\n }\n });\n\n conn.on('close', () => {\n if (received > 0 && total > 0 && received < total) {\n onDisconnect?.();\n }\n });\n });\n\n return { peer, stop };\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../../src/p2p/index.ts","../../src/errors.ts","../../src/utils/network.ts","../../src/adapters/defaults.ts","../../src/p2p/utils.ts","../../src/p2p/helpers.ts","../../src/p2p/send.ts","../../src/p2p/receive.ts"],"sourcesContent":["// P2P module exports\r\nexport { startP2PSend } from './send.js';\r\nexport { startP2PReceive } from './receive.js';\r\nexport { generateP2PCode, isP2PCodeLike, isLocalhostHostname, isSecureContextForP2P } from './utils.js';\r\nexport { buildPeerOptions, createPeerWithRetries, resolvePeerConfig } from './helpers.js';\r\n\r\n// Re-export types\r\nexport type {\r\n // State machine types\r\n P2PSendState,\r\n P2PReceiveState,\r\n // PeerJS types\r\n PeerConstructor,\r\n PeerInstance,\r\n PeerInstanceEvents,\r\n PeerOptions,\r\n DataConnection,\r\n DataConnectionEvents,\r\n // P2P config\r\n P2PServerConfig,\r\n // P2P event types\r\n P2PStatusEvent,\r\n P2PSendProgressEvent,\r\n P2PReceiveProgressEvent,\r\n P2PMetadataEvent,\r\n P2PReceiveCompleteEvent,\r\n // P2P options and sessions\r\n P2PSendOptions,\r\n P2PSendSession,\r\n P2PReceiveOptions,\r\n P2PReceiveSession,\r\n} from './types.js';\r\n","export interface DropgateErrorOptions {\r\n code?: string;\r\n details?: unknown;\r\n cause?: unknown;\r\n}\r\n\r\n/*\r\n Base error class for all Dropgate errors\r\n /\r\nexport class DropgateError extends Error {\r\n readonly code: string;\r\n readonly details?: unknown;\r\n\r\n constructor(message: string, opts: DropgateErrorOptions = {}) {\r\n super(message);\r\n this.name = this.constructor.name;\r\n this.code = opts.code \|\| 'DROPGATE_ERROR';\r\n this.details = opts.details;\r\n if (opts.cause !== undefined) {\r\n // Use Object.defineProperty for cause to maintain compatibility\r\n Object.defineProperty(this, 'cause', {\r\n value: opts.cause,\r\n writable: false,\r\n enumerable: false,\r\n configurable: true,\r\n });\r\n }\r\n }\r\n}\r\n\r\n/\r\n Validation error for invalid inputs\r\n /\r\nexport class DropgateValidationError extends DropgateError {\r\n constructor(message: string, opts: DropgateErrorOptions = {}) {\r\n super(message, { ...opts, code: opts.code \|\| 'VALIDATION_ERROR' });\r\n }\r\n}\r\n\r\n/\r\n Network error for connection issues\r\n /\r\nexport class DropgateNetworkError extends DropgateError {\r\n constructor(message: string, opts: DropgateErrorOptions = {}) {\r\n super(message, { ...opts, code: opts.code \|\| 'NETWORK_ERROR' });\r\n }\r\n}\r\n\r\n/\r\n Protocol error for server communication issues\r\n /\r\nexport class DropgateProtocolError extends DropgateError {\r\n constructor(message: string, opts: DropgateErrorOptions = {}) {\r\n super(message, { ...opts, code: opts.code \|\| 'PROTOCOL_ERROR' });\r\n }\r\n}\r\n\r\n/\r\n Abort error - replacement for DOMException with AbortError name\r\n * Used when operations are cancelled\r\n /\r\nexport class DropgateAbortError extends DropgateError {\r\n constructor(message = 'Operation aborted') {\r\n super(message, { code: 'ABORT_ERROR' });\r\n this.name = 'AbortError';\r\n }\r\n}\r\n\r\n/\r\n Timeout error - replacement for DOMException with TimeoutError name\r\n * Used when operations exceed their time limit\r\n /\r\nexport class DropgateTimeoutError extends DropgateError {\r\n constructor(message = 'Request timed out') {\r\n super(message, { code: 'TIMEOUT_ERROR' });\r\n this.name = 'TimeoutError';\r\n }\r\n}\r\n","import { DropgateAbortError, DropgateTimeoutError, DropgateValidationError } from '../errors.js';\r\nimport type { FetchFn, ServerTarget } from '../types.js';\r\n\r\n/\r\n Parse a server URL string into host, port, and secure components.\r\n * If no protocol is specified, defaults to HTTPS.\r\n /\r\nexport function parseServerUrl(urlStr: string): ServerTarget {\r\n let normalized = urlStr.trim();\r\n if (!normalized.startsWith('http://') && !normalized.startsWith('https://')) {\r\n normalized = 'https://' + normalized;\r\n }\r\n const url = new URL(normalized);\r\n return {\r\n host: url.hostname,\r\n port: url.port ? Number(url.port) : undefined,\r\n secure: url.protocol === 'https:',\r\n };\r\n}\r\n\r\n/\r\n Build a base URL from host, port, and secure options.\r\n /\r\nexport function buildBaseUrl(opts: ServerTarget): string {\r\n const { host, port, secure } = opts;\r\n\r\n if (!host \|\| typeof host !== 'string') {\r\n throw new DropgateValidationError('Server host is required.');\r\n }\r\n\r\n const protocol = secure === false ? 'http' : 'https';\r\n const portSuffix = port ? `:${port}` : '';\r\n\r\n return `${protocol}://${host}${portSuffix}`;\r\n}\r\n\r\n/\r\n Sleep for a specified duration, with optional abort signal support.\r\n /\r\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\r\n return new Promise((resolve, reject) => {\r\n if (signal?.aborted) {\r\n return reject(signal.reason \|\| new DropgateAbortError());\r\n }\r\n\r\n const t = setTimeout(resolve, ms);\r\n\r\n if (signal) {\r\n signal.addEventListener(\r\n 'abort',\r\n () => {\r\n clearTimeout(t);\r\n reject(signal.reason \|\| new DropgateAbortError());\r\n },\r\n { once: true }\r\n );\r\n }\r\n });\r\n}\r\n\r\nexport interface AbortSignalWithCleanup {\r\n signal: AbortSignal;\r\n cleanup: () => void;\r\n}\r\n\r\n/\r\n Create an AbortSignal that combines a parent signal with a timeout.\r\n /\r\nexport function makeAbortSignal(\r\n parentSignal?: AbortSignal \| null,\r\n timeoutMs?: number\r\n): AbortSignalWithCleanup {\r\n const controller = new AbortController();\r\n let timeoutId: ReturnType<typeof setTimeout> \| null = null;\r\n\r\n const abort = (reason?: unknown): void => {\r\n if (!controller.signal.aborted) {\r\n controller.abort(reason);\r\n }\r\n };\r\n\r\n if (parentSignal) {\r\n if (parentSignal.aborted) {\r\n abort(parentSignal.reason);\r\n } else {\r\n parentSignal.addEventListener('abort', () => abort(parentSignal.reason), {\r\n once: true,\r\n });\r\n }\r\n }\r\n\r\n if (Number.isFinite(timeoutMs) && timeoutMs! > 0) {\r\n timeoutId = setTimeout(() => {\r\n abort(new DropgateTimeoutError());\r\n }, timeoutMs);\r\n }\r\n\r\n return {\r\n signal: controller.signal,\r\n cleanup: () => {\r\n if (timeoutId) clearTimeout(timeoutId);\r\n },\r\n };\r\n}\r\n\r\nexport interface FetchJsonResult {\r\n res: Response;\r\n json: unknown;\r\n text: string;\r\n}\r\n\r\nexport interface FetchJsonOptions extends Omit<RequestInit, 'signal'> {\r\n timeoutMs?: number;\r\n signal?: AbortSignal;\r\n}\r\n\r\n/\r\n Fetch JSON from a URL with timeout and error handling.\r\n /\r\nexport async function fetchJson(\r\n fetchFn: FetchFn,\r\n url: string,\r\n opts: FetchJsonOptions = {}\r\n): Promise<FetchJsonResult> {\r\n const { timeoutMs, signal, ...rest } = opts;\r\n const { signal: s, cleanup } = makeAbortSignal(signal, timeoutMs);\r\n\r\n try {\r\n const res = await fetchFn(url, { ...rest, signal: s });\r\n const text = await res.text();\r\n\r\n let json: unknown = null;\r\n try {\r\n json = text ? JSON.parse(text) : null;\r\n } catch {\r\n // Ignore parse errors - json will remain null\r\n }\r\n\r\n return { res, json, text };\r\n } finally {\r\n cleanup();\r\n }\r\n}\r\n","import type { Base64Adapter, CryptoAdapter, FetchFn } from '../types.js';\r\n\r\n/\r\n Get the default Base64 adapter for the current environment.\r\n * Automatically detects Node.js Buffer vs browser btoa/atob.\r\n /\r\nexport function getDefaultBase64(): Base64Adapter {\r\n // Check for Node.js Buffer (works in Node.js and some bundlers)\r\n if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {\r\n return {\r\n encode(bytes: Uint8Array): string {\r\n return Buffer.from(bytes).toString('base64');\r\n },\r\n decode(b64: string): Uint8Array {\r\n return new Uint8Array(Buffer.from(b64, 'base64'));\r\n },\r\n };\r\n }\r\n\r\n // Browser fallback using btoa/atob\r\n if (typeof btoa === 'function' && typeof atob === 'function') {\r\n return {\r\n encode(bytes: Uint8Array): string {\r\n let binary = '';\r\n for (let i = 0; i < bytes.length; i++) {\r\n binary += String.fromCharCode(bytes[i]);\r\n }\r\n return btoa(binary);\r\n },\r\n decode(b64: string): Uint8Array {\r\n const binary = atob(b64);\r\n const out = new Uint8Array(binary.length);\r\n for (let i = 0; i < binary.length; i++) {\r\n out[i] = binary.charCodeAt(i);\r\n }\r\n return out;\r\n },\r\n };\r\n }\r\n\r\n throw new Error(\r\n 'No Base64 implementation available. Provide a Base64Adapter via options.'\r\n );\r\n}\r\n\r\n/\r\n Get the default crypto object for the current environment.\r\n * Returns globalThis.crypto if available.\r\n /\r\nexport function getDefaultCrypto(): CryptoAdapter \| undefined {\r\n return globalThis.crypto as CryptoAdapter \| undefined;\r\n}\r\n\r\n/\r\n Get the default fetch function for the current environment.\r\n * Returns globalThis.fetch if available.\r\n /\r\nexport function getDefaultFetch(): FetchFn \| undefined {\r\n return globalThis.fetch?.bind(globalThis) as FetchFn \| undefined;\r\n}\r\n","import type { CryptoAdapter } from '../types.js';\r\nimport { getDefaultCrypto } from '../adapters/defaults.js';\r\n\r\n/\r\n Check if a hostname is localhost\r\n /\r\nexport function isLocalhostHostname(hostname: string): boolean {\r\n const host = String(hostname \|\| '').toLowerCase();\r\n return host === 'localhost' \|\| host === '127.0.0.1' \|\| host === '::1';\r\n}\r\n\r\n/\r\n Check if the current context allows P2P (HTTPS or localhost)\r\n /\r\nexport function isSecureContextForP2P(\r\n hostname?: string,\r\n isSecureContext?: boolean\r\n): boolean {\r\n return Boolean(isSecureContext) \|\| isLocalhostHostname(hostname \|\| '');\r\n}\r\n\r\n/\r\n Generate a P2P sharing code using cryptographically secure random.\r\n * Format: XXXX-0000 (4 letters + 4 digits)\r\n /\r\nexport function generateP2PCode(cryptoObj?: CryptoAdapter): string {\r\n const crypto = cryptoObj \|\| getDefaultCrypto();\r\n const letters = 'ABCDEFGHJKLMNPQRSTUVWXYZ'; // Excluded I and O to avoid confusion\r\n\r\n if (crypto) {\r\n const randomBytes = new Uint8Array(8);\r\n crypto.getRandomValues(randomBytes);\r\n\r\n let letterPart = '';\r\n for (let i = 0; i < 4; i++) {\r\n letterPart += letters[randomBytes[i] % letters.length];\r\n }\r\n\r\n let numberPart = '';\r\n for (let i = 4; i < 8; i++) {\r\n numberPart += (randomBytes[i] % 10).toString();\r\n }\r\n\r\n return `${letterPart}-${numberPart}`;\r\n }\r\n\r\n // Fallback to Math.random (less secure, but works everywhere)\r\n let a = '';\r\n for (let i = 0; i < 4; i++) {\r\n a += letters[Math.floor(Math.random() letters.length)];\r\n }\r\n let b = '';\r\n for (let i = 0; i < 4; i++) {\r\n b += Math.floor(Math.random() * 10);\r\n }\r\n return `${a}-${b}`;\r\n}\r\n\r\n/*\r\n Check if a string looks like a P2P sharing code\r\n /\r\nexport function isP2PCodeLike(code: string): boolean {\r\n return /^[A-Z]{4}-\\d{4}$/.test(String(code \|\| '').trim());\r\n}\r\n","import { DropgateNetworkError } from '../errors.js';\r\nimport type { P2PCapabilities } from '../types.js';\r\nimport type { PeerInstance, PeerOptions, P2PServerConfig } from './types.js';\r\n\r\n/\r\n Resolve P2P server configuration from user options and server capabilities.\r\n * User-provided values take precedence over server capabilities.\r\n /\r\nexport function resolvePeerConfig(\r\n userConfig: P2PServerConfig,\r\n serverCaps?: P2PCapabilities\r\n): { path: string; iceServers: RTCIceServer[] } {\r\n return {\r\n path: userConfig.peerjsPath ?? serverCaps?.peerjsPath ?? '/peerjs',\r\n iceServers: userConfig.iceServers ?? serverCaps?.iceServers ?? [],\r\n };\r\n}\r\n\r\n/\r\n Build PeerJS connection options from P2P server configuration.\r\n /\r\nexport function buildPeerOptions(config: P2PServerConfig = {}): PeerOptions {\r\n const { host, port, peerjsPath = '/peerjs', secure = false, iceServers = [] } = config;\r\n\r\n const peerOpts: PeerOptions = {\r\n host,\r\n path: peerjsPath,\r\n secure,\r\n config: { iceServers },\r\n debug: 0,\r\n };\r\n\r\n if (port) {\r\n peerOpts.port = port;\r\n }\r\n\r\n return peerOpts;\r\n}\r\n\r\nexport interface CreatePeerWithRetriesOptions {\r\n code?: string \| null;\r\n codeGenerator: () => string;\r\n maxAttempts: number;\r\n buildPeer: (id: string) => PeerInstance;\r\n onCode?: (code: string, attempt: number) => void;\r\n}\r\n\r\n/\r\n Create a peer with retries if the code is already taken\r\n /\r\nexport async function createPeerWithRetries(\r\n opts: CreatePeerWithRetriesOptions\r\n): Promise<{ peer: PeerInstance; code: string }> {\r\n const { code, codeGenerator, maxAttempts, buildPeer, onCode } = opts;\r\n\r\n let nextCode = code \|\| codeGenerator();\r\n let peer: PeerInstance \| null = null;\r\n let lastError: Error \| null = null;\r\n\r\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\r\n onCode?.(nextCode, attempt);\r\n\r\n try {\r\n peer = await new Promise<PeerInstance>((resolve, reject) => {\r\n const instance = buildPeer(nextCode);\r\n instance.on('open', () => resolve(instance));\r\n instance.on('error', (err: Error) => {\r\n try {\r\n instance.destroy();\r\n } catch {\r\n // Ignore destroy errors\r\n }\r\n reject(err);\r\n });\r\n });\r\n\r\n return { peer, code: nextCode };\r\n } catch (err) {\r\n lastError = err as Error;\r\n nextCode = codeGenerator();\r\n }\r\n }\r\n\r\n throw lastError \|\| new DropgateNetworkError('Could not establish PeerJS connection.');\r\n}\r\n","import { DropgateValidationError, DropgateNetworkError } from '../errors.js';\r\nimport { sleep } from '../utils/network.js';\r\nimport type { P2PSendOptions, P2PSendSession, P2PSendState, DataConnection } from './types.js';\r\nimport { generateP2PCode } from './utils.js';\r\nimport { buildPeerOptions, createPeerWithRetries, resolvePeerConfig } from './helpers.js';\r\n\r\n/\r\n Generate a unique session ID for transfer tracking.\r\n * Uses crypto.randomUUID if available, falls back to timestamp + random.\r\n /\r\nfunction generateSessionId(): string {\r\n if (typeof crypto !== 'undefined' && crypto.randomUUID) {\r\n return crypto.randomUUID();\r\n }\r\n // Fallback for environments without crypto.randomUUID\r\n return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\r\n}\r\n\r\n/\r\n Start a direct transfer (P2P) sender session.\r\n \r\n IMPORTANT: Consumer must provide the PeerJS Peer constructor.\r\n * This removes DOM coupling (no script injection).\r\n \r\n Example:\r\n * ```js\r\n * import Peer from 'peerjs';\r\n * import { startP2PSend } from '@dropgate/core/p2p';\r\n \r\n const session = await startP2PSend({\r\n * file: myFile,\r\n * Peer,\r\n * host: 'dropgate.link',\r\n * secure: true,\r\n * onCode: (code) => console.log('Share this code:', code),\r\n * onProgress: (evt) => console.log(`${evt.percent}% sent`),\r\n * onComplete: () => console.log('Done!'),\r\n * });\r\n * ```\r\n /\r\nexport async function startP2PSend(opts: P2PSendOptions): Promise<P2PSendSession> {\r\n const {\r\n file,\r\n Peer,\r\n serverInfo,\r\n host,\r\n port,\r\n peerjsPath,\r\n secure = false,\r\n iceServers,\r\n codeGenerator,\r\n cryptoObj,\r\n maxAttempts = 4,\r\n chunkSize = 256 1024,\r\n endAckTimeoutMs = 15000,\r\n bufferHighWaterMark = 8 * 1024 * 1024,\r\n bufferLowWaterMark = 2 * 1024 * 1024,\r\n heartbeatIntervalMs = 5000,\r\n onCode,\r\n onStatus,\r\n onProgress,\r\n onComplete,\r\n onError,\r\n onDisconnect,\r\n } = opts;\r\n\r\n // Validate required options\r\n if (!file) {\r\n throw new DropgateValidationError('File is missing.');\r\n }\r\n\r\n if (!Peer) {\r\n throw new DropgateValidationError(\r\n 'PeerJS Peer constructor is required. Install peerjs and pass it as the Peer option.'\r\n );\r\n }\r\n\r\n // Check P2P capabilities if serverInfo is provided\r\n const p2pCaps = serverInfo?.capabilities?.p2p;\r\n if (serverInfo && !p2pCaps?.enabled) {\r\n throw new DropgateValidationError('Direct transfer is disabled on this server.');\r\n }\r\n\r\n // Resolve config from user options and server capabilities\r\n const { path: finalPath, iceServers: finalIceServers } = resolvePeerConfig(\r\n { peerjsPath, iceServers },\r\n p2pCaps\r\n );\r\n\r\n // Build peer options\r\n const peerOpts = buildPeerOptions({\r\n host,\r\n port,\r\n peerjsPath: finalPath,\r\n secure,\r\n iceServers: finalIceServers,\r\n });\r\n\r\n // Create the code generator\r\n const finalCodeGenerator = codeGenerator \|\| (() => generateP2PCode(cryptoObj));\r\n\r\n // Create peer with retries\r\n const buildPeer = (id: string) => new Peer(id, peerOpts);\r\n const { peer, code } = await createPeerWithRetries({\r\n code: null,\r\n codeGenerator: finalCodeGenerator,\r\n maxAttempts,\r\n buildPeer,\r\n onCode,\r\n });\r\n\r\n // Generate unique session ID for this transfer\r\n const sessionId = generateSessionId();\r\n\r\n // State machine - replaces boolean flags to prevent race conditions\r\n let state: P2PSendState = 'listening';\r\n let activeConn: DataConnection \| null = null;\r\n let sentBytes = 0;\r\n let heartbeatTimer: ReturnType<typeof setInterval> \| null = null;\r\n\r\n const reportProgress = (data: { received: number; total: number }): void => {\r\n const safeTotal =\r\n Number.isFinite(data.total) && data.total > 0 ? data.total : file.size;\r\n const safeReceived = Math.min(Number(data.received) \|\| 0, safeTotal \|\| 0);\r\n const percent = safeTotal ? (safeReceived / safeTotal) * 100 : 0;\r\n onProgress?.({ processedBytes: safeReceived, totalBytes: safeTotal, percent });\r\n };\r\n\r\n // Safe error handler - prevents calling onError after completion\r\n const safeError = (err: Error): void => {\r\n if (state === 'closed' \|\| state === 'completed') return;\r\n state = 'closed';\r\n onError?.(err);\r\n cleanup();\r\n };\r\n\r\n // Safe complete handler - only fires from finishing state\r\n const safeComplete = (): void => {\r\n if (state !== 'finishing') return;\r\n state = 'completed';\r\n onComplete?.();\r\n cleanup();\r\n };\r\n\r\n // Cleanup all resources\r\n const cleanup = (): void => {\r\n // Clear heartbeat timer\r\n if (heartbeatTimer) {\r\n clearInterval(heartbeatTimer);\r\n heartbeatTimer = null;\r\n }\r\n\r\n // Remove beforeunload listener if in browser\r\n if (typeof window !== 'undefined') {\r\n window.removeEventListener('beforeunload', handleUnload);\r\n }\r\n\r\n try {\r\n activeConn?.close();\r\n } catch {\r\n // Ignore close errors\r\n }\r\n try {\r\n peer.destroy();\r\n } catch {\r\n // Ignore destroy errors\r\n }\r\n };\r\n\r\n // Handle browser tab close/refresh\r\n const handleUnload = (): void => {\r\n try {\r\n activeConn?.send({ t: 'error', message: 'Sender closed the connection.' });\r\n } catch {\r\n // Best effort\r\n }\r\n stop();\r\n };\r\n\r\n // Add beforeunload listener if in browser\r\n if (typeof window !== 'undefined') {\r\n window.addEventListener('beforeunload', handleUnload);\r\n }\r\n\r\n const stop = (): void => {\r\n if (state === 'closed') return;\r\n state = 'closed';\r\n cleanup();\r\n };\r\n\r\n // Helper to check if session is stopped - bypasses TypeScript narrowing\r\n // which doesn't understand state can change asynchronously\r\n const isStopped = (): boolean => state === 'closed';\r\n\r\n peer.on('connection', (conn: DataConnection) => {\r\n if (state === 'closed') return;\r\n\r\n // Connection replacement logic - allow new connections if old one is dead\r\n if (activeConn) {\r\n // Check if existing connection is actually still open\r\n // @ts-expect-error - open property may exist on PeerJS connections\r\n const isOldConnOpen = activeConn.open !== false;\r\n\r\n if (isOldConnOpen && state === 'transferring') {\r\n // Actively transferring, reject new connection\r\n try {\r\n conn.send({ t: 'error', message: 'Transfer already in progress.' });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n try {\r\n conn.close();\r\n } catch {\r\n // Ignore close errors\r\n }\r\n return;\r\n } else if (!isOldConnOpen) {\r\n // Old connection is dead, clean it up and accept new one\r\n try {\r\n activeConn.close();\r\n } catch {\r\n // Ignore\r\n }\r\n activeConn = null;\r\n // Reset state to allow new transfer\r\n state = 'listening';\r\n sentBytes = 0;\r\n } else {\r\n // Connection exists but not transferring (maybe in negotiating state)\r\n // Reject to avoid confusion\r\n try {\r\n conn.send({ t: 'error', message: 'Another receiver is already connected.' });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n try {\r\n conn.close();\r\n } catch {\r\n // Ignore close errors\r\n }\r\n return;\r\n }\r\n }\r\n\r\n activeConn = conn;\r\n state = 'negotiating';\r\n onStatus?.({ phase: 'waiting', message: 'Connected. Waiting for receiver to accept...' });\r\n\r\n let readyResolve: (() => void) \| null = null;\r\n let ackResolve: ((data: unknown) => void) \| null = null;\r\n\r\n const readyPromise = new Promise<void>((resolve) => {\r\n readyResolve = resolve;\r\n });\r\n\r\n const ackPromise = new Promise<unknown>((resolve) => {\r\n ackResolve = resolve;\r\n });\r\n\r\n conn.on('data', (data: unknown) => {\r\n if (\r\n !data \|\|\r\n typeof data !== 'object' \|\|\r\n data instanceof ArrayBuffer \|\|\r\n ArrayBuffer.isView(data)\r\n ) {\r\n return;\r\n }\r\n\r\n const msg = data as { t?: string; received?: number; total?: number; phase?: string; message?: string };\r\n if (!msg.t) return;\r\n\r\n if (msg.t === 'ready') {\r\n onStatus?.({ phase: 'transferring', message: 'Receiver accepted. Starting transfer...' });\r\n readyResolve?.();\r\n return;\r\n }\r\n\r\n if (msg.t === 'progress') {\r\n reportProgress({ received: msg.received \|\| 0, total: msg.total \|\| 0 });\r\n return;\r\n }\r\n\r\n if (msg.t === 'ack' && msg.phase === 'end') {\r\n ackResolve?.(msg);\r\n return;\r\n }\r\n\r\n if (msg.t === 'pong') {\r\n // Heartbeat response received, connection is alive\r\n return;\r\n }\r\n\r\n if (msg.t === 'error') {\r\n safeError(new DropgateNetworkError(msg.message \|\| 'Receiver reported an error.'));\r\n }\r\n });\r\n\r\n conn.on('open', async () => {\r\n try {\r\n if (isStopped()) return;\r\n\r\n // Send metadata with sessionId\r\n conn.send({\r\n t: 'meta',\r\n sessionId,\r\n name: file.name,\r\n size: file.size,\r\n mime: file.type \|\| 'application/octet-stream',\r\n });\r\n\r\n const total = file.size;\r\n const dc = conn._dc;\r\n\r\n if (dc && Number.isFinite(bufferLowWaterMark)) {\r\n try {\r\n dc.bufferedAmountLowThreshold = bufferLowWaterMark;\r\n } catch {\r\n // Ignore threshold setting errors\r\n }\r\n }\r\n\r\n // Wait for ready signal\r\n await readyPromise;\r\n if (isStopped()) return;\r\n\r\n // Start heartbeat for long transfers\r\n if (heartbeatIntervalMs > 0) {\r\n heartbeatTimer = setInterval(() => {\r\n if (state === 'transferring' \|\| state === 'finishing') {\r\n try {\r\n conn.send({ t: 'ping' });\r\n } catch {\r\n // Ignore ping errors\r\n }\r\n }\r\n }, heartbeatIntervalMs);\r\n }\r\n\r\n state = 'transferring';\r\n\r\n // Send file in chunks\r\n for (let offset = 0; offset < total; offset += chunkSize) {\r\n if (isStopped()) return;\r\n\r\n const slice = file.slice(offset, offset + chunkSize);\r\n const buf = await slice.arrayBuffer();\r\n conn.send(buf);\r\n sentBytes += buf.byteLength;\r\n\r\n // Flow control\r\n if (dc) {\r\n while (dc.bufferedAmount > bufferHighWaterMark) {\r\n await new Promise<void>((resolve) => {\r\n const fallback = setTimeout(resolve, 60);\r\n try {\r\n dc.addEventListener(\r\n 'bufferedamountlow',\r\n () => {\r\n clearTimeout(fallback);\r\n resolve();\r\n },\r\n { once: true }\r\n );\r\n } catch {\r\n // Fallback only\r\n }\r\n });\r\n }\r\n }\r\n }\r\n\r\n if (isStopped()) return;\r\n\r\n state = 'finishing';\r\n conn.send({ t: 'end' });\r\n\r\n // Wait for acknowledgment\r\n const ackTimeoutMs = Number.isFinite(endAckTimeoutMs)\r\n ? Math.max(endAckTimeoutMs, Math.ceil(file.size / (1024 * 1024)) * 1000)\r\n : null;\r\n\r\n const ackResult = await Promise.race([\r\n ackPromise,\r\n sleep(ackTimeoutMs \|\| 15000).catch(() => null),\r\n ]);\r\n\r\n if (isStopped()) return;\r\n\r\n if (!ackResult \|\| typeof ackResult !== 'object') {\r\n throw new DropgateNetworkError('Receiver did not confirm completion.');\r\n }\r\n\r\n const ackData = ackResult as { total?: number; received?: number };\r\n const ackTotal = Number(ackData.total) \|\| file.size;\r\n const ackReceived = Number(ackData.received) \|\| 0;\r\n\r\n if (ackTotal && ackReceived < ackTotal) {\r\n throw new DropgateNetworkError('Receiver reported an incomplete transfer.');\r\n }\r\n\r\n reportProgress({ received: ackReceived \|\| ackTotal, total: ackTotal });\r\n safeComplete();\r\n } catch (err) {\r\n safeError(err as Error);\r\n }\r\n });\r\n\r\n conn.on('error', (err: Error) => {\r\n safeError(err);\r\n });\r\n\r\n conn.on('close', () => {\r\n if (state === 'closed' \|\| state === 'completed') {\r\n // Clean shutdown, ensure full cleanup\r\n cleanup();\r\n return;\r\n }\r\n\r\n if (state === 'transferring' \|\| state === 'finishing') {\r\n // Disconnected during transfer\r\n safeError(\r\n new DropgateNetworkError('Receiver disconnected before transfer completed.')\r\n );\r\n } else {\r\n // Disconnected before transfer started (during waiting/negotiating phase)\r\n // Reset state to allow reconnection\r\n activeConn = null;\r\n state = 'listening';\r\n sentBytes = 0;\r\n onDisconnect?.();\r\n }\r\n });\r\n });\r\n\r\n return {\r\n peer,\r\n code,\r\n sessionId,\r\n stop,\r\n getStatus: () => state,\r\n getBytesSent: () => sentBytes,\r\n getConnectedPeerId: () => {\r\n if (!activeConn) return null;\r\n // @ts-expect-error - peer property exists on PeerJS DataConnection\r\n return activeConn.peer \|\| null;\r\n },\r\n };\r\n}\r\n","import { DropgateValidationError, DropgateNetworkError } from '../errors.js';\r\nimport type { P2PReceiveOptions, P2PReceiveSession, P2PReceiveState, DataConnection } from './types.js';\r\nimport { isP2PCodeLike } from './utils.js';\r\nimport { buildPeerOptions, resolvePeerConfig } from './helpers.js';\r\n\r\n/*\r\n Start a direct transfer (P2P) receiver session.\r\n \r\n IMPORTANT: Consumer must provide the PeerJS Peer constructor and handle file writing.\r\n * This removes DOM coupling (no streamSaver).\r\n \r\n Example:\r\n * ```js\r\n * import Peer from 'peerjs';\r\n * import { startP2PReceive } from '@dropgate/core/p2p';\r\n \r\n let writer;\r\n * const session = await startP2PReceive({\r\n * code: 'ABCD-1234',\r\n * Peer,\r\n * host: 'dropgate.link',\r\n * secure: true,\r\n * onMeta: ({ name, total }) => {\r\n * // Consumer creates file writer\r\n * writer = createWriteStream(name);\r\n * },\r\n * onData: async (chunk) => {\r\n * // Consumer writes data\r\n * await writer.write(chunk);\r\n * },\r\n * onComplete: () => {\r\n * writer.close();\r\n * console.log('Done!');\r\n * },\r\n * });\r\n * ```\r\n /\r\nexport async function startP2PReceive(opts: P2PReceiveOptions): Promise<P2PReceiveSession> {\r\n const {\r\n code,\r\n Peer,\r\n serverInfo,\r\n host,\r\n port,\r\n peerjsPath,\r\n secure = false,\r\n iceServers,\r\n autoReady = true,\r\n watchdogTimeoutMs = 15000,\r\n onStatus,\r\n onMeta,\r\n onData,\r\n onProgress,\r\n onComplete,\r\n onError,\r\n onDisconnect,\r\n } = opts;\r\n\r\n // Validate required options\r\n if (!code) {\r\n throw new DropgateValidationError('No sharing code was provided.');\r\n }\r\n\r\n if (!Peer) {\r\n throw new DropgateValidationError(\r\n 'PeerJS Peer constructor is required. Install peerjs and pass it as the Peer option.'\r\n );\r\n }\r\n\r\n // Check P2P capabilities if serverInfo is provided\r\n const p2pCaps = serverInfo?.capabilities?.p2p;\r\n if (serverInfo && !p2pCaps?.enabled) {\r\n throw new DropgateValidationError('Direct transfer is disabled on this server.');\r\n }\r\n\r\n // Validate and normalize code\r\n const normalizedCode = String(code).trim().replace(/\\s+/g, '').toUpperCase();\r\n if (!isP2PCodeLike(normalizedCode)) {\r\n throw new DropgateValidationError('Invalid direct transfer code.');\r\n }\r\n\r\n // Resolve config from user options and server capabilities\r\n const { path: finalPath, iceServers: finalIceServers } = resolvePeerConfig(\r\n { peerjsPath, iceServers },\r\n p2pCaps\r\n );\r\n\r\n // Build peer options\r\n const peerOpts = buildPeerOptions({\r\n host,\r\n port,\r\n peerjsPath: finalPath,\r\n secure,\r\n iceServers: finalIceServers,\r\n });\r\n\r\n // Create peer (receiver doesn't need a specific ID)\r\n const peer = new Peer(undefined, peerOpts);\r\n\r\n // State machine - replaces boolean flags to prevent race conditions\r\n let state: P2PReceiveState = 'initializing';\r\n let total = 0;\r\n let received = 0;\r\n let currentSessionId: string \| null = null;\r\n let lastProgressSentAt = 0;\r\n const progressIntervalMs = 120;\r\n let writeQueue = Promise.resolve();\r\n let watchdogTimer: ReturnType<typeof setTimeout> \| null = null;\r\n let activeConn: DataConnection \| null = null;\r\n\r\n // Watchdog - detects dead connections during transfer\r\n const resetWatchdog = (): void => {\r\n if (watchdogTimeoutMs <= 0) return;\r\n\r\n if (watchdogTimer) {\r\n clearTimeout(watchdogTimer);\r\n }\r\n\r\n watchdogTimer = setTimeout(() => {\r\n if (state === 'transferring') {\r\n safeError(new DropgateNetworkError('Connection timed out (no data received).'));\r\n }\r\n }, watchdogTimeoutMs);\r\n };\r\n\r\n const clearWatchdog = (): void => {\r\n if (watchdogTimer) {\r\n clearTimeout(watchdogTimer);\r\n watchdogTimer = null;\r\n }\r\n };\r\n\r\n // Safe error handler - prevents calling onError after completion\r\n const safeError = (err: Error): void => {\r\n if (state === 'closed' \|\| state === 'completed') return;\r\n state = 'closed';\r\n onError?.(err);\r\n cleanup();\r\n };\r\n\r\n // Safe complete handler - only fires from transferring state\r\n const safeComplete = (completeData: { received: number; total: number }): void => {\r\n if (state !== 'transferring') return;\r\n state = 'completed';\r\n onComplete?.(completeData);\r\n cleanup();\r\n };\r\n\r\n // Cleanup all resources\r\n const cleanup = (): void => {\r\n clearWatchdog();\r\n\r\n // Remove beforeunload listener if in browser\r\n if (typeof window !== 'undefined') {\r\n window.removeEventListener('beforeunload', handleUnload);\r\n }\r\n\r\n try {\r\n peer.destroy();\r\n } catch {\r\n // Ignore destroy errors\r\n }\r\n };\r\n\r\n // Handle browser tab close/refresh\r\n const handleUnload = (): void => {\r\n try {\r\n activeConn?.send({ t: 'error', message: 'Receiver closed the connection.' });\r\n } catch {\r\n // Best effort\r\n }\r\n stop();\r\n };\r\n\r\n // Add beforeunload listener if in browser\r\n if (typeof window !== 'undefined') {\r\n window.addEventListener('beforeunload', handleUnload);\r\n }\r\n\r\n const stop = (): void => {\r\n if (state === 'closed') return;\r\n state = 'closed';\r\n cleanup();\r\n };\r\n\r\n peer.on('error', (err: Error) => {\r\n safeError(err);\r\n });\r\n\r\n peer.on('open', () => {\r\n state = 'connecting';\r\n const conn = peer.connect(normalizedCode, { reliable: true });\r\n activeConn = conn;\r\n\r\n conn.on('open', () => {\r\n state = 'negotiating';\r\n onStatus?.({ phase: 'connected', message: 'Waiting for file details...' });\r\n });\r\n\r\n conn.on('data', async (data: unknown) => {\r\n try {\r\n // Reset watchdog on any data received\r\n resetWatchdog();\r\n\r\n // Handle control messages\r\n if (\r\n data &&\r\n typeof data === 'object' &&\r\n !(data instanceof ArrayBuffer) &&\r\n !ArrayBuffer.isView(data)\r\n ) {\r\n const msg = data as {\r\n t?: string;\r\n sessionId?: string;\r\n name?: string;\r\n size?: number;\r\n message?: string;\r\n };\r\n\r\n if (msg.t === 'meta') {\r\n // Session ID validation - reject if we're busy with a different session\r\n if (currentSessionId && msg.sessionId && msg.sessionId !== currentSessionId) {\r\n try {\r\n conn.send({ t: 'error', message: 'Busy with another session.' });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n return;\r\n }\r\n\r\n // Store the session ID for this transfer\r\n if (msg.sessionId) {\r\n currentSessionId = msg.sessionId;\r\n }\r\n\r\n const name = String(msg.name \|\| 'file');\r\n total = Number(msg.size) \|\| 0;\r\n received = 0;\r\n writeQueue = Promise.resolve();\r\n\r\n // Function to send ready signal - called automatically if autoReady is true,\r\n // or passed to onMeta callback for manual invocation if autoReady is false\r\n const sendReady = (): void => {\r\n state = 'transferring';\r\n // Start watchdog once we're ready to receive data\r\n resetWatchdog();\r\n try {\r\n conn.send({ t: 'ready' });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n };\r\n\r\n if (autoReady) {\r\n onMeta?.({ name, total });\r\n onProgress?.({ processedBytes: received, totalBytes: total, percent: 0 });\r\n sendReady();\r\n } else {\r\n // Pass sendReady function to callback so consumer can trigger transfer start\r\n onMeta?.({ name, total, sendReady });\r\n onProgress?.({ processedBytes: received, totalBytes: total, percent: 0 });\r\n }\r\n return;\r\n }\r\n\r\n if (msg.t === 'ping') {\r\n // Respond to heartbeat - keeps watchdog alive and confirms we're active\r\n try {\r\n conn.send({ t: 'pong' });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n return;\r\n }\r\n\r\n if (msg.t === 'end') {\r\n clearWatchdog();\r\n await writeQueue;\r\n\r\n if (total && received < total) {\r\n const err = new DropgateNetworkError(\r\n 'Transfer ended before the full file was received.'\r\n );\r\n try {\r\n conn.send({ t: 'error', message: err.message });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n throw err;\r\n }\r\n\r\n try {\r\n conn.send({ t: 'ack', phase: 'end', received, total });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n\r\n safeComplete({ received, total });\r\n return;\r\n }\r\n\r\n if (msg.t === 'error') {\r\n throw new DropgateNetworkError(msg.message \|\| 'Sender reported an error.');\r\n }\r\n\r\n return;\r\n }\r\n\r\n // Handle binary data\r\n let bufPromise: Promise<Uint8Array>;\r\n\r\n if (data instanceof ArrayBuffer) {\r\n bufPromise = Promise.resolve(new Uint8Array(data));\r\n } else if (ArrayBuffer.isView(data)) {\r\n bufPromise = Promise.resolve(\r\n new Uint8Array(data.buffer, data.byteOffset, data.byteLength)\r\n );\r\n } else if (typeof Blob !== 'undefined' && data instanceof Blob) {\r\n bufPromise = data.arrayBuffer().then((buffer) => new Uint8Array(buffer));\r\n } else {\r\n return;\r\n }\r\n\r\n writeQueue = writeQueue\r\n .then(async () => {\r\n const buf = await bufPromise;\r\n\r\n // Call consumer's onData handler\r\n if (onData) {\r\n await onData(buf);\r\n }\r\n\r\n received += buf.byteLength;\r\n const percent = total ? Math.min(100, (received / total) 100) : 0;\r\n onProgress?.({ processedBytes: received, totalBytes: total, percent });\r\n\r\n const now = Date.now();\r\n if (received === total \|\| now - lastProgressSentAt >= progressIntervalMs) {\r\n lastProgressSentAt = now;\r\n try {\r\n conn.send({ t: 'progress', received, total });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n }\r\n })\r\n .catch((err) => {\r\n try {\r\n conn.send({\r\n t: 'error',\r\n message: (err as Error)?.message \|\| 'Receiver write failed.',\r\n });\r\n } catch {\r\n // Ignore send errors\r\n }\r\n safeError(err as Error);\r\n });\r\n } catch (err) {\r\n safeError(err as Error);\r\n }\r\n });\r\n\r\n conn.on('close', () => {\r\n if (state === 'closed' \|\| state === 'completed') {\r\n // Clean shutdown, ensure full cleanup\r\n cleanup();\r\n return;\r\n }\r\n\r\n // Sender disconnected before transfer completed\r\n if (state === 'transferring') {\r\n // We were mid-transfer\r\n safeError(new DropgateNetworkError('Sender disconnected during transfer.'));\r\n } else if (state === 'negotiating') {\r\n // We had metadata but transfer hadn't started\r\n state = 'closed';\r\n cleanup();\r\n onDisconnect?.();\r\n } else {\r\n // Disconnected before we even got file metadata\r\n safeError(new DropgateNetworkError('Sender disconnected before file details were received.'));\r\n }\r\n });\r\n });\r\n\r\n return {\r\n peer,\r\n stop,\r\n getStatus: () => state,\r\n getBytesReceived: () => received,\r\n getTotalBytes: () => total,\r\n getSessionId: () => currentSessionId,\r\n };\r\n}\r\n"],"mappings":"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","names":["crypto"]}

package/dist/p2p/index.d.cts CHANGED Viewed

@@ -51,6 +51,18 @@ interface ServerInfo {
     /** Server capabilities. */
     capabilities?: ServerCapabilities;
 }
+/**
+ * Base progress event with common fields for all transfer operations.
+ * Provides a consistent interface for upload, download, and P2P progress tracking.
+ */
+interface BaseProgressEvent {
+    /** Completion percentage (0-100). */
+    percent: number;
+    /** Bytes processed so far (sent, received, or uploaded). */
+    processedBytes: number;
+    /** Total bytes expected (may be 0 if unknown). */
+    totalBytes: number;
+}
 /**
  * Crypto adapter interface compatible with the Web Crypto API.
  * Used for encryption operations and secure random generation.
@@ -78,6 +90,15 @@ interface FileSource {
     arrayBuffer(): Promise<ArrayBuffer>;
 }
+/**
+ * Finite state machine states for P2P send sessions.
+ * Prevents race conditions and ensures callbacks fire in correct order.
+ */
+type P2PSendState = 'initializing' | 'listening' | 'negotiating' | 'transferring' | 'finishing' | 'completed' | 'closed';
+/**
+ * Finite state machine states for P2P receive sessions.
+ */
+type P2PReceiveState = 'initializing' | 'connecting' | 'negotiating' | 'transferring' | 'completed' | 'closed';
 /**
  * PeerJS Peer constructor interface.
  * Consumer must provide this constructor to P2P functions.
@@ -105,16 +126,20 @@ interface PeerOptions {
     /** PeerJS debug level (0-3). */
     debug?: number;
 }
+/** Event handlers for PeerInstance. */
+interface PeerInstanceEvents {
+    open: (id: string) => void;
+    connection: (conn: DataConnection) => void;
+    error: (err: Error) => void;
+    close: () => void;
+}
 /**
  * PeerJS Peer instance interface.
  * Represents a connection to the PeerJS signaling server.
  */
 interface PeerInstance {
     /** Register an event handler. */
-    on(event: 'open', callback: (id: string) => void): void;
-    on(event: 'connection', callback: (conn: DataConnection) => void): void;
-    on(event: 'error', callback: (err: Error) => void): void;
-    on(event: 'close', callback: () => void): void;
+    on<K extends keyof PeerInstanceEvents>(event: K, callback: PeerInstanceEvents[K]): void;
     on(event: string, callback: (...args: unknown[]) => void): void;
     /** Connect to another peer by ID. */
     connect(peerId: string, options?: {
@@ -123,16 +148,20 @@ interface PeerInstance {
     /** Destroy this peer and close all connections. */
     destroy(): void;
 }
+/** Event handlers for DataConnection. */
+interface DataConnectionEvents {
+    open: () => void;
+    data: (data: unknown) => void;
+    close: () => void;
+    error: (err: Error) => void;
+}
 /**
  * PeerJS DataConnection interface.
  * Represents a WebRTC data channel connection between peers.
  */
 interface DataConnection {
     /** Register an event handler. */
-    on(event: 'open', callback: () => void): void;
-    on(event: 'data', callback: (data: unknown) => void): void;
-    on(event: 'close', callback: () => void): void;
-    on(event: 'error', callback: (err: Error) => void): void;
+    on<K extends keyof DataConnectionEvents>(event: K, callback: DataConnectionEvents[K]): void;
     on(event: string, callback: (...args: unknown[]) => void): void;
     /** Send data to the connected peer. */
     send(data: unknown): void;
@@ -142,58 +171,81 @@ interface DataConnection {
     _dc?: RTCDataChannel;
 }
 /**
- * Options for starting a P2P send session.
+ * Common server configuration for P2P connections.
  */
-interface P2PSendOptions {
-    /** File to send */
-    file: FileSource;
-    /** PeerJS Peer constructor - REQUIRED */
-    Peer: PeerConstructor;
-    /** Server info (optional, for capability checking) */
-    serverInfo?: ServerInfo;
-    /** PeerJS server host */
+interface P2PServerConfig {
+    /** PeerJS server host. */
     host?: string;
-    /** PeerJS server port */
+    /** PeerJS server port. */
     port?: number;
-    /** PeerJS server path (default: /peerjs) */
+    /** PeerJS server path (default: /peerjs). */
     peerjsPath?: string;
-    /** Whether to use secure connection */
+    /** Whether to use secure connection. */
     secure?: boolean;
-    /** ICE servers for WebRTC */
+    /** ICE servers for WebRTC. */
     iceServers?: RTCIceServer[];
-    /** Custom code generator function */
+}
+/** Status event for P2P operations. */
+interface P2PStatusEvent {
+    phase: string;
+    message: string;
+}
+/** Progress event for P2P send operations. */
+interface P2PSendProgressEvent extends BaseProgressEvent {
+}
+/** Progress event for P2P receive operations. */
+interface P2PReceiveProgressEvent extends BaseProgressEvent {
+}
+/** Metadata event when receiving a file. */
+interface P2PMetadataEvent {
+    name: string;
+    total: number;
+    /** Call this to signal the sender to begin transfer (when autoReady is false). */
+    sendReady?: () => void;
+}
+/** Completion event for P2P receive operations. */
+interface P2PReceiveCompleteEvent {
+    received: number;
+    total: number;
+}
+/**
+ * Options for starting a P2P send session.
+ */
+interface P2PSendOptions extends P2PServerConfig {
+    /** File to send. */
+    file: FileSource;
+    /** PeerJS Peer constructor - REQUIRED. */
+    Peer: PeerConstructor;
+    /** Server info (optional, for capability checking). */
+    serverInfo?: ServerInfo;
+    /** Custom code generator function. */
     codeGenerator?: (cryptoObj?: CryptoAdapter) => string;
-    /** Crypto object for secure code generation */
+    /** Crypto object for secure code generation. */
     cryptoObj?: CryptoAdapter;
-    /** Max attempts to register a peer ID */
+    /** Max attempts to register a peer ID. */
     maxAttempts?: number;
-    /** Chunk size for data transfer */
+    /** Chunk size for data transfer. */
     chunkSize?: number;
-    /** Timeout waiting for receiver ready signal */
-    readyTimeoutMs?: number;
-    /** Timeout waiting for end acknowledgment */
+    /** Timeout waiting for end acknowledgment. */
     endAckTimeoutMs?: number;
-    /** Buffer high water mark for flow control */
+    /** Buffer high water mark for flow control. */
     bufferHighWaterMark?: number;
-    /** Buffer low water mark for flow control */
+    /** Buffer low water mark for flow control. */
     bufferLowWaterMark?: number;
-    /** Callback when code is generated */
+    /** Heartbeat interval in ms for long transfers (default: 5000, 0 to disable). */
+    heartbeatIntervalMs?: number;
+    /** Callback when code is generated. */
     onCode?: (code: string, attempt: number) => void;
-    /** Callback for status updates */
-    onStatus?: (evt: {
-        phase: string;
-        message: string;
-    }) => void;
-    /** Callback for progress updates */
-    onProgress?: (evt: {
-        sent: number;
-        total: number;
-        percent: number;
-    }) => void;
-    /** Callback when transfer completes */
+    /** Callback for status updates. */
+    onStatus?: (evt: P2PStatusEvent) => void;
+    /** Callback for progress updates. */
+    onProgress?: (evt: P2PSendProgressEvent) => void;
+    /** Callback when transfer completes. */
     onComplete?: () => void;
-    /** Callback on error */
+    /** Callback on error. */
     onError?: (err: Error) => void;
+    /** Callback when receiver disconnects. */
+    onDisconnect?: () => void;
 }
 /**
  * Return value from startP2PSend containing session control.
@@ -203,55 +255,56 @@ interface P2PSendSession {
     peer: PeerInstance;
     /** The generated sharing code. */
     code: string;
+    /** The unique session ID for this transfer. */
+    sessionId: string;
     /** Stop the session and clean up resources. */
     stop: () => void;
+    /** Get the current session state. */
+    getStatus: () => P2PSendState;
+    /** Get the number of bytes sent so far. */
+    getBytesSent: () => number;
+    /** Get the connected receiver's peer ID (if connected). */
+    getConnectedPeerId: () => string | null;
 }
 /**
  * Options for starting a P2P receive session.
  */
-interface P2PReceiveOptions {
-    /** Sharing code to connect to */
+interface P2PReceiveOptions extends P2PServerConfig {
+    /** Sharing code to connect to. */
     code: string;
-    /** PeerJS Peer constructor - REQUIRED */
+    /** PeerJS Peer constructor - REQUIRED. */
     Peer: PeerConstructor;
-    /** Server info (optional, for capability checking) */
+    /** Server info (optional, for capability checking). */
     serverInfo?: ServerInfo;
-    /** PeerJS server host */
-    host?: string;
-    /** PeerJS server port */
-    port?: number;
-    /** PeerJS server path (default: /peerjs) */
-    peerjsPath?: string;
-    /** Whether to use secure connection */
-    secure?: boolean;
-    /** ICE servers for WebRTC */
-    iceServers?: RTCIceServer[];
-    /** Callback for status updates */
-    onStatus?: (evt: {
-        phase: string;
-        message: string;
-    }) => void;
-    /** Callback when file metadata is received */
-    onMeta?: (evt: {
-        name: string;
-        total: number;
-    }) => void;
-    /** Callback when data chunk is received - consumer handles file writing */
+    /**
+     * Whether to automatically send the "ready" signal after receiving metadata.
+     * Default: true.
+     * Set to false to show a preview and manually control when the transfer starts.
+     * When false, call the sendReady function passed to onMeta to start the transfer.
+     */
+    autoReady?: boolean;
+    /**
+     * Timeout in ms for detecting dead connections (no data received).
+     * Default: 15000 (15 seconds). Set to 0 to disable.
+     */
+    watchdogTimeoutMs?: number;
+    /** Callback for status updates. */
+    onStatus?: (evt: P2PStatusEvent) => void;
+    /**
+     * Callback when file metadata is received.
+     * When autoReady is false, this callback receives a sendReady function
+     * that must be called to signal the sender to begin the transfer.
+     */
+    onMeta?: (evt: P2PMetadataEvent) => void;
+    /** Callback when data chunk is received - consumer handles file writing. */
     onData?: (chunk: Uint8Array) => Promise<void> | void;
-    /** Callback for progress updates */
-    onProgress?: (evt: {
-        received: number;
-        total: number;
-        percent: number;
-    }) => void;
-    /** Callback when transfer completes */
-    onComplete?: (evt: {
-        received: number;
-        total: number;
-    }) => void;
-    /** Callback on error */
+    /** Callback for progress updates. */
+    onProgress?: (evt: P2PReceiveProgressEvent) => void;
+    /** Callback when transfer completes. */
+    onComplete?: (evt: P2PReceiveCompleteEvent) => void;
+    /** Callback on error. */
     onError?: (err: Error) => void;
-    /** Callback when sender disconnects */
+    /** Callback when sender disconnects. */
     onDisconnect?: () => void;
 }
 /**
@@ -262,6 +315,14 @@ interface P2PReceiveSession {
     peer: PeerInstance;
     /** Stop the session and clean up resources. */
     stop: () => void;
+    /** Get the current session state. */
+    getStatus: () => P2PReceiveState;
+    /** Get the number of bytes received so far. */
+    getBytesReceived: () => number;
+    /** Get the expected total bytes (0 if metadata not received). */
+    getTotalBytes: () => number;
+    /** Get the current session ID (if received from sender). */
+    getSessionId: () => string | null;
 }
 /**
@@ -340,17 +401,18 @@ declare function generateP2PCode(cryptoObj?: CryptoAdapter): string;
  */
 declare function isP2PCodeLike(code: string): boolean;
-interface BuildPeerOptionsInput {
-    host?: string;
-    port?: number;
-    peerjsPath?: string;
-    secure?: boolean;
-    iceServers?: RTCIceServer[];
-}
 /**
- * Build PeerJS connection options
+ * Resolve P2P server configuration from user options and server capabilities.
+ * User-provided values take precedence over server capabilities.
+ */
+declare function resolvePeerConfig(userConfig: P2PServerConfig, serverCaps?: P2PCapabilities): {
+    path: string;
+    iceServers: RTCIceServer[];
+};
+/**
+ * Build PeerJS connection options from P2P server configuration.
  */
-declare function buildPeerOptions(opts?: BuildPeerOptionsInput): PeerOptions;
+declare function buildPeerOptions(config?: P2PServerConfig): PeerOptions;
 interface CreatePeerWithRetriesOptions {
     code?: string | null;
     codeGenerator: () => string;
@@ -366,4 +428,4 @@ declare function createPeerWithRetries(opts: CreatePeerWithRetriesOptions): Prom
     code: string;
 }>;
-export { type DataConnection, type P2PReceiveOptions, type P2PReceiveSession, type P2PSendOptions, type P2PSendSession, type PeerConstructor, type PeerInstance, type PeerOptions, buildPeerOptions, createPeerWithRetries, generateP2PCode, isLocalhostHostname, isP2PCodeLike, isSecureContextForP2P, startP2PReceive, startP2PSend };
+export { type DataConnection, type DataConnectionEvents, type P2PMetadataEvent, type P2PReceiveCompleteEvent, type P2PReceiveOptions, type P2PReceiveProgressEvent, type P2PReceiveSession, type P2PReceiveState, type P2PSendOptions, type P2PSendProgressEvent, type P2PSendSession, type P2PSendState, type P2PServerConfig, type P2PStatusEvent, type PeerConstructor, type PeerInstance, type PeerInstanceEvents, type PeerOptions, buildPeerOptions, createPeerWithRetries, generateP2PCode, isLocalhostHostname, isP2PCodeLike, isSecureContextForP2P, resolvePeerConfig, startP2PReceive, startP2PSend };