bun-torrent 0.0.7 → 0.0.8

package/dist/client.d.ts

@@ -3,29 +3,60 @@ import { Torrent } from './torrent/session/index';
 import type { TorrentMetadata } from './torrent/types';
 import type { TorrentFileSelection } from './torrent/file-selection';
 import type { PeerInfo } from './tracker/types';
+/**
+ * Setup phases reported through {@link DownloadOptions.onChangeState} before download starts.
+ *
+ * The values are emitted in order: `parsing` → `tracking` → `connecting` → `downloading`.
+ * Once `downloading` fires, progress events take over via {@link Torrent.on}.
+ */
 export declare enum DownloadState {
     PARSING = "parsing",
     TRACKING = "tracking",
     CONNECTING = "connecting",
     DOWNLOADING = "downloading"
 }
+/**
+ * Minimal DHT contract used by {@link Client} for peer discovery.
+ *
+ * Implement this to swap the default in-memory DHT for a persistent or
+ * shared implementation. `close` is called from {@link Client.close}.
+ */
 export type ClientDht = {
     lookupPeers(infoHash: Uint8Array): Promise<PeerInfo[]>;
     close?(): void;
 };
+/**
+ * Default options applied to every download started by a {@link Client}.
+ *
+ * All fields are optional. Any field can be overridden per-download via
+ * {@link DownloadOptions}.
+ */
 export type ClientConfig = {
+    /** Custom DHT implementation, or `false` to disable DHT entirely. Defaults to an in-memory {@link DhtClient}. */
     dht?: ClientDht | false;
+    /** Default file selection for multi-file torrents. `null`/omitted downloads every file. */
     files?: TorrentFileSelection;
+    /** Maximum block requests in flight per peer. Higher values increase throughput but also memory. Defaults to 300. */
     maxInFlightRequestsPerPeer?: number;
+    /** Maximum simultaneous peer connection attempts. Defaults to 30. */
     maxConnecting?: number;
+    /** Minimum connected peers required before download starts. `0` allows downloads to start with no peers. Defaults to 0. */
     minConnections?: number;
+    /** Directory where downloaded files are written. Defaults to `process.cwd()`. */
     outputDirectory?: string;
+    /** Timeout for a single peer TCP connect + handshake, in milliseconds. Defaults to 5000. */
     peerConnectTimeoutMs?: number;
+    /** Granularity of `progress` events: `'piece'` (once per validated piece) or `'block'` (every received block). Defaults to `'piece'`. */
     progressEvents?: DownloadProgressEventMode;
+    /** Timeout for a single block request, in milliseconds. Timed-out requests are retried on other peers. Defaults to 15000. */
     requestTimeoutMs?: number;
+    /** Reserved for future seeding support. Currently only `false` is supported. */
     seed?: false;
+    /** Minimum interval between speed recalculations, in milliseconds. Defaults to 500. */
     speedSampleIntervalMs?: number;
+    /** Preferred number of connected peers. The pool stops opening new connections once this is reached. Defaults to 20. */
     targetConnections?: number;
+    /** Timeout for tracker announce requests, in milliseconds. Defaults to 5000. */
     trackerTimeoutMs?: number;
 };
 type InspectInput = {
@@ -40,6 +71,25 @@ type InspectInput = {
 type DownloadInput = {
     meta: TorrentMetadata;
 } | InspectInput;
+/**
+ * Entry point of the library. Holds shared state (peer id, DHT node) across downloads.
+ *
+ * One `Client` instance can run multiple concurrent downloads. The same client is also
+ * reused across `inspect` → `download` flows so the DHT routing table and peer cache
+ * can warm up once and pay off on subsequent calls.
+ *
+ * Call {@link Client.close} when the client is no longer needed — it closes every
+ * active torrent and the DHT socket. After close, every method throws {@link ClientError}.
+ *
+ * @example
+ * const client = new Client({ outputDirectory: './downloads' });
+ * try {
+ *     const torrent = await client.download({ torrentFile: './example.torrent' });
+ *     await torrent.done;
+ * } finally {
+ *     client.close();
+ * }
+ */
 export declare class Client {
     private readonly config;
     private readonly peerId;
@@ -47,33 +97,104 @@ export declare class Client {
     private readonly dht?;
     private readonly torrents;
     private closed;
+    /**
+     * Build a client with optional defaults that apply to every download.
+     *
+     * The constructor is cheap: it generates a peer id and a DHT node id but does not
+     * open any sockets. The default DHT instance opens its UDP socket lazily on the
+     * first lookup.
+     *
+     * @param config - Defaults applied to downloads started by this client.
+     */
     constructor(config?: ClientConfig);
+    /**
+     * Start downloading a torrent and return a {@link Torrent} that emits progress events.
+     *
+     * The returned promise settles once the client has parsed metadata, discovered peers,
+     * opened the peer pool, and started the download manager. The actual download runs
+     * in the background — `await torrent.done` or listen for the `done` event to wait
+     * for it to finish.
+     *
+     * Tracker failures are non-fatal: if no tracker returns peers, DHT lookup is attempted
+     * when DHT is enabled. With DHT disabled, the download continues with whatever peers
+     * were found provided `minConnections` is `0`.
+     *
+     * @param input - Torrent source: a `.torrent` file path/bytes, a magnet URI, or already-parsed `meta`.
+     * @param options - Per-download overrides for {@link ClientConfig}, plus `announcePort` and `onChangeState`.
+     * @returns A {@link Torrent} whose `done` promise settles when the download finishes or fails.
+     * @throws {ClientError} When the client is closed, the input is unsupported, or file selection is invalid.
+     */
     download(input: DownloadInput, options?: DownloadOptions): Promise<Torrent>;
+    /**
+     * Parse a `.torrent` file or magnet URI and return its metadata without starting a download.
+     *
+     * Useful for showing the file list, computing total size, or letting the user pick
+     * a subset of files before calling {@link Client.download}. For magnet links this
+     * method fetches the info dictionary from a peer using the `ut_metadata` extension,
+     * so it may discover and warm DHT state that a later `download({ meta })` call reuses.
+     *
+     * @param input - Either `{ torrentFile }` (path/bytes/ArrayBuffer) or `{ magnet }` (URI string).
+     * @param options - Optional overrides. `timeout` caps the per-peer metadata fetch for magnets.
+     * @returns Parsed torrent metadata, including computed info hash.
+     * @throws {ClientError} When the client is closed or no input is provided.
+     * @throws {TorrentParseError} When the torrent file or magnet info dictionary cannot be parsed.
+     * @throws {MagnetParseError} When the magnet URI is invalid or no peer returned metadata.
+     */
     inspect(input: InspectInput, options?: {
         timeout?: number;
     }): Promise<TorrentMetadata>;
+    /**
+     * Stop the client, close every active torrent, and release the DHT socket.
+     *
+     * Idempotent — calling close more than once is a no-op. After close, every other
+     * method throws {@link ClientError} with code `CLIENT_CLOSED`.
+     */
     close(): void;
     private discoverPeers;
     private trackPeers;
     private trackTorrent;
     private assertOpen;
 }
+/**
+ * Per-download overrides passed to {@link Client.download}.
+ *
+ * Every field except `announcePort` and `onChangeState` overrides the matching field
+ * in {@link ClientConfig} for this download only.
+ */
 export type DownloadOptions = {
+    /** Port sent to trackers in announce requests. Defaults to 6881. */
     announcePort?: number;
+    /** Restrict the download to specific files. Selectable by `'a/b.txt'` string or `['a','b.txt']` array. */
     files?: TorrentFileSelection;
+    /** Override {@link ClientConfig.maxInFlightRequestsPerPeer} for this download. */
     maxInFlightRequestsPerPeer?: number;
+    /** Override {@link ClientConfig.maxConnecting} for this download. */
     maxConnecting?: number;
+    /** Override {@link ClientConfig.minConnections} for this download. */
     minConnections?: number;
+    /** Called with each setup phase before download starts. See {@link DownloadState}. */
     onChangeState?: (state: DownloadState) => unknown;
+    /** Override {@link ClientConfig.outputDirectory} for this download. */
     outputDirectory?: string;
+    /** Override {@link ClientConfig.peerConnectTimeoutMs} for this download. */
     peerConnectTimeoutMs?: number;
+    /** Override {@link ClientConfig.progressEvents} for this download. */
     progressEvents?: DownloadProgressEventMode;
+    /** Override {@link ClientConfig.requestTimeoutMs} for this download. */
     requestTimeoutMs?: number;
+    /** Reserved for future seeding support. Currently only `false` is supported. */
     seed?: false;
+    /** Override {@link ClientConfig.speedSampleIntervalMs} for this download. */
     speedSampleIntervalMs?: number;
+    /** Override {@link ClientConfig.targetConnections} for this download. */
     targetConnections?: number;
+    /** Override {@link ClientConfig.trackerTimeoutMs} for this download. */
     trackerTimeoutMs?: number;
 };
+/** Supported torrent file sources. */
 export type TorrentFileInput = string | Uint8Array | ArrayBuffer;
+/**
+ * @internal
+ */
 export declare const readTorrentFile: (input: unknown) => Promise<Uint8Array>;
 export { Client as TorrentClient };

package/dist/client.error.d.ts

@@ -1,9 +1,19 @@
 import { BunTorrentError } from './utils/errors';
+/** Error codes set on {@link ClientError.code}. */
 export declare enum ClientErrorCode {
+    /** {@link Client.download} or {@link Client.inspect} called after {@link Client.close}. */
     CLOSED = "CLIENT_CLOSED",
+    /** `files` option referenced paths that do not exist in the torrent. */
     INVALID_FILE_SELECTION = "CLIENT_INVALID_FILE_SELECTION",
+    /** Torrent file input was neither a string path, `Uint8Array`, nor `ArrayBuffer`. */
     UNSUPPORTED_TORRENT_FILE_INPUT = "CLIENT_UNSUPPORTED_TORRENT_FILE_INPUT"
 }
+/**
+ * Errors thrown directly by {@link Client}. See {@link ClientErrorCode}.
+ *
+ * Errors from underlying subsystems (parser, tracker, peer pool, DHT) are thrown as
+ * their own classes — this one only wraps client-level failures.
+ */
 export declare class ClientError extends BunTorrentError {
     constructor(code: ClientErrorCode, message: string);
 }

package/dist/client.error.js

@@ -1,10 +1,20 @@
 import { BunTorrentError } from './utils/errors';
+/** Error codes set on {@link ClientError.code}. */
 export var ClientErrorCode;
 (function (ClientErrorCode) {
+    /** {@link Client.download} or {@link Client.inspect} called after {@link Client.close}. */
     ClientErrorCode["CLOSED"] = "CLIENT_CLOSED";
+    /** `files` option referenced paths that do not exist in the torrent. */
     ClientErrorCode["INVALID_FILE_SELECTION"] = "CLIENT_INVALID_FILE_SELECTION";
+    /** Torrent file input was neither a string path, `Uint8Array`, nor `ArrayBuffer`. */
     ClientErrorCode["UNSUPPORTED_TORRENT_FILE_INPUT"] = "CLIENT_UNSUPPORTED_TORRENT_FILE_INPUT";
 })(ClientErrorCode || (ClientErrorCode = {}));
+/**
+ * Errors thrown directly by {@link Client}. See {@link ClientErrorCode}.
+ *
+ * Errors from underlying subsystems (parser, tracker, peer pool, DHT) are thrown as
+ * their own classes — this one only wraps client-level failures.
+ */
 export class ClientError extends BunTorrentError {
     constructor(code, message) {
         super(message, code);

package/dist/client.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.error.js","sourceRoot":"","sources":["../src/client.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACvB,2CAAwB,CAAA;IACxB,2EAAwD,CAAA;IACxD,2FAAwE,CAAA;AAC5E,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC5C,YAAY,IAAqB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;CACJ"}
+{"version":3,"file":"client.error.js","sourceRoot":"","sources":["../src/client.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,mDAAmD;AACnD,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACvB,2FAA2F;IAC3F,2CAAwB,CAAA;IACxB,wEAAwE;IACxE,2EAAwD,CAAA;IACxD,qFAAqF;IACrF,2FAAwE,CAAA;AAC5E,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC5C,YAAY,IAAqB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;CACJ"}

package/dist/client.js

@@ -11,6 +11,12 @@ import { BunTorrentError } from './utils/errors';
 import { parseMagnet } from './magnet';
 import { DhtClient } from './dht';
 import { createDhtNodeId } from './dht/utils/distance';
+/**
+ * Setup phases reported through {@link DownloadOptions.onChangeState} before download starts.
+ *
+ * The values are emitted in order: `parsing` → `tracking` → `connecting` → `downloading`.
+ * Once `downloading` fires, progress events take over via {@link Torrent.on}.
+ */
 export var DownloadState;
 (function (DownloadState) {
     DownloadState["PARSING"] = "parsing";
@@ -18,6 +24,25 @@ export var DownloadState;
     DownloadState["CONNECTING"] = "connecting";
     DownloadState["DOWNLOADING"] = "downloading";
 })(DownloadState || (DownloadState = {}));
+/**
+ * Entry point of the library. Holds shared state (peer id, DHT node) across downloads.
+ *
+ * One `Client` instance can run multiple concurrent downloads. The same client is also
+ * reused across `inspect` → `download` flows so the DHT routing table and peer cache
+ * can warm up once and pay off on subsequent calls.
+ *
+ * Call {@link Client.close} when the client is no longer needed — it closes every
+ * active torrent and the DHT socket. After close, every method throws {@link ClientError}.
+ *
+ * @example
+ * const client = new Client({ outputDirectory: './downloads' });
+ * try {
+ *     const torrent = await client.download({ torrentFile: './example.torrent' });
+ *     await torrent.done;
+ * } finally {
+ *     client.close();
+ * }
+ */
 export class Client {
     config;
     peerId;
@@ -25,6 +50,15 @@ export class Client {
     dht;
     torrents = new Set();
     closed = false;
+    /**
+     * Build a client with optional defaults that apply to every download.
+     *
+     * The constructor is cheap: it generates a peer id and a DHT node id but does not
+     * open any sockets. The default DHT instance opens its UDP socket lazily on the
+     * first lookup.
+     *
+     * @param config - Defaults applied to downloads started by this client.
+     */
     constructor(config = {}) {
         this.config = config;
         this.peerId = createPeerId();
@@ -34,6 +68,23 @@ export class Client {
                 ? undefined
                 : (config.dht ?? new DhtClient({ nodeId: this.dhtNodeId }));
     }
+    /**
+     * Start downloading a torrent and return a {@link Torrent} that emits progress events.
+     *
+     * The returned promise settles once the client has parsed metadata, discovered peers,
+     * opened the peer pool, and started the download manager. The actual download runs
+     * in the background — `await torrent.done` or listen for the `done` event to wait
+     * for it to finish.
+     *
+     * Tracker failures are non-fatal: if no tracker returns peers, DHT lookup is attempted
+     * when DHT is enabled. With DHT disabled, the download continues with whatever peers
+     * were found provided `minConnections` is `0`.
+     *
+     * @param input - Torrent source: a `.torrent` file path/bytes, a magnet URI, or already-parsed `meta`.
+     * @param options - Per-download overrides for {@link ClientConfig}, plus `announcePort` and `onChangeState`.
+     * @returns A {@link Torrent} whose `done` promise settles when the download finishes or fails.
+     * @throws {ClientError} When the client is closed, the input is unsupported, or file selection is invalid.
+     */
     async download(input, options = {}) {
         this.assertOpen();
         options.onChangeState?.(DownloadState.PARSING);
@@ -66,6 +117,21 @@ export class Client {
         this.trackTorrent(torrent);
         return torrent;
     }
+    /**
+     * Parse a `.torrent` file or magnet URI and return its metadata without starting a download.
+     *
+     * Useful for showing the file list, computing total size, or letting the user pick
+     * a subset of files before calling {@link Client.download}. For magnet links this
+     * method fetches the info dictionary from a peer using the `ut_metadata` extension,
+     * so it may discover and warm DHT state that a later `download({ meta })` call reuses.
+     *
+     * @param input - Either `{ torrentFile }` (path/bytes/ArrayBuffer) or `{ magnet }` (URI string).
+     * @param options - Optional overrides. `timeout` caps the per-peer metadata fetch for magnets.
+     * @returns Parsed torrent metadata, including computed info hash.
+     * @throws {ClientError} When the client is closed or no input is provided.
+     * @throws {TorrentParseError} When the torrent file or magnet info dictionary cannot be parsed.
+     * @throws {MagnetParseError} When the magnet URI is invalid or no peer returned metadata.
+     */
     async inspect(input, options) {
         this.assertOpen();
         if ('torrentFile' in input && input.torrentFile !== undefined) {
@@ -77,6 +143,12 @@ export class Client {
         }
         throw new BunTorrentError('No input provided', 'NO_INPUT');
     }
+    /**
+     * Stop the client, close every active torrent, and release the DHT socket.
+     *
+     * Idempotent — calling close more than once is a no-op. After close, every other
+     * method throws {@link ClientError} with code `CLIENT_CLOSED`.
+     */
     close() {
         if (this.closed)
             return;
@@ -160,6 +232,9 @@ const assertValidFileSelection = (metadata, files) => {
         return;
     throw new ClientError(ClientErrorCode.INVALID_FILE_SELECTION, `Unknown torrent file selection: ${unknownFiles.join(', ')}`);
 };
+/**
+ * @internal
+ */
 export const readTorrentFile = async (input) => {
     if (typeof input === 'string')
         return await Bun.file(input).bytes();

package/dist/client.js.map

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

package/dist/magnet/base32/errors.d.ts

@@ -1,8 +1,18 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link Base32DecoderError.code}. */
 export declare enum Base32DecoderErrorCode {
+    /** Input contained a character outside the base32 alphabet. */
     INVALID_CHAR = "INVALID_BASE32_CHAR"
 }
+/**
+ * Errors from base32 decoding of magnet info hashes (BEP 9 short form, 32 chars).
+ *
+ * Surfaces during {@link parseMagnetURI} when the `xt` info hash uses base32 instead of hex.
+ */
 export declare class Base32DecoderError extends BunTorrentError {
+    /** Optional field path for context. */
     readonly field?: string | undefined;
-    constructor(code: Base32DecoderErrorCode, message: string, field?: string | undefined);
+    constructor(code: Base32DecoderErrorCode, message: string, 
+    /** Optional field path for context. */
+    field?: string | undefined);
 }

package/dist/magnet/base32/errors.js

@@ -1,11 +1,20 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link Base32DecoderError.code}. */
 export var Base32DecoderErrorCode;
 (function (Base32DecoderErrorCode) {
+    /** Input contained a character outside the base32 alphabet. */
     Base32DecoderErrorCode["INVALID_CHAR"] = "INVALID_BASE32_CHAR";
 })(Base32DecoderErrorCode || (Base32DecoderErrorCode = {}));
+/**
+ * Errors from base32 decoding of magnet info hashes (BEP 9 short form, 32 chars).
+ *
+ * Surfaces during {@link parseMagnetURI} when the `xt` info hash uses base32 instead of hex.
+ */
 export class Base32DecoderError extends BunTorrentError {
     field;
-    constructor(code, message, field) {
+    constructor(code, message, 
+    /** Optional field path for context. */
+    field) {
         super(message, code);
         this.field = field;
     }

package/dist/magnet/base32/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/magnet/base32/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAN,IAAY,sBAEX;AAFD,WAAY,sBAAsB;IAC9B,8DAAoC,CAAA;AACxC,CAAC,EAFW,sBAAsB,KAAtB,sBAAsB,QAEjC;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAI/B;IAHpB,YACI,IAA4B,EAC5B,OAAe,EACC,KAAc;QAE9B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFL,UAAK,GAAL,KAAK,CAAS;IAGlC,CAAC;CACJ"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/magnet/base32/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,0DAA0D;AAC1D,MAAM,CAAN,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAC9B,+DAA+D;IAC/D,8DAAoC,CAAA;AACxC,CAAC,EAHW,sBAAsB,KAAtB,sBAAsB,QAGjC;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAK/B;IAJpB,YACI,IAA4B,EAC5B,OAAe;IACf,uCAAuC;IACvB,KAAc;QAE9B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFL,UAAK,GAAL,KAAK,CAAS;IAGlC,CAAC;CACJ"}

package/dist/magnet/parser/errors.d.ts

@@ -1,13 +1,31 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link MagnetParseError.code}. */
 export declare enum MagnetParseErrorCode {
+    /** Magnet string is not a valid `magnet:` URI. */
     INVALID_URI = "INVALID_MAGNET_URI",
+    /** The `xt` parameter is missing, has the wrong scheme, or carries a malformed info hash. */
     INVALID_XT = "INVALID_XT_PARAM",
+    /** Magnet had no trackers and no DHT was provided to resolve peers. */
     NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    /** No peer returned the info dictionary via `ut_metadata` within the timeout. */
     NO_METADATA = "NO_METADATA",
+    /** Info dictionary was received but failed to parse. See `cause`. */
     PARSING_FAILED = "METADATA_FAILED_TO_PARSE"
 }
+/**
+ * Errors thrown while parsing a magnet URI or fetching its info dictionary from peers.
+ *
+ * For magnets the parser must discover peers (trackers + DHT) and fetch the info dict
+ * via the `ut_metadata` extension; this class covers failures along that pipeline.
+ */
 export declare class MagnetParseError extends BunTorrentError {
+    /** Field name involved in the failure, when applicable. */
     readonly field?: string | undefined;
+    /** Underlying error (e.g. the bencode parse failure for `PARSING_FAILED`). */
     readonly cause?: unknown | undefined;
-    constructor(code: MagnetParseErrorCode, message: string, field?: string | undefined, cause?: unknown | undefined);
+    constructor(code: MagnetParseErrorCode, message: string, 
+    /** Field name involved in the failure, when applicable. */
+    field?: string | undefined, 
+    /** Underlying error (e.g. the bencode parse failure for `PARSING_FAILED`). */
+    cause?: unknown | undefined);
 }

package/dist/magnet/parser/errors.js

@@ -1,16 +1,32 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link MagnetParseError.code}. */
 export var MagnetParseErrorCode;
 (function (MagnetParseErrorCode) {
+    /** Magnet string is not a valid `magnet:` URI. */
     MagnetParseErrorCode["INVALID_URI"] = "INVALID_MAGNET_URI";
+    /** The `xt` parameter is missing, has the wrong scheme, or carries a malformed info hash. */
     MagnetParseErrorCode["INVALID_XT"] = "INVALID_XT_PARAM";
+    /** Magnet had no trackers and no DHT was provided to resolve peers. */
     MagnetParseErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    /** No peer returned the info dictionary via `ut_metadata` within the timeout. */
     MagnetParseErrorCode["NO_METADATA"] = "NO_METADATA";
+    /** Info dictionary was received but failed to parse. See `cause`. */
     MagnetParseErrorCode["PARSING_FAILED"] = "METADATA_FAILED_TO_PARSE";
 })(MagnetParseErrorCode || (MagnetParseErrorCode = {}));
+/**
+ * Errors thrown while parsing a magnet URI or fetching its info dictionary from peers.
+ *
+ * For magnets the parser must discover peers (trackers + DHT) and fetch the info dict
+ * via the `ut_metadata` extension; this class covers failures along that pipeline.
+ */
 export class MagnetParseError extends BunTorrentError {
     field;
     cause;
-    constructor(code, message, field, cause) {
+    constructor(code, message, 
+    /** Field name involved in the failure, when applicable. */
+    field, 
+    /** Underlying error (e.g. the bencode parse failure for `PARSING_FAILED`). */
+    cause) {
         super(message, code);
         this.field = field;
         this.cause = cause;

package/dist/magnet/parser/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/magnet/parser/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC5B,0DAAkC,CAAA;IAClC,uDAA+B,CAAA;IAC/B,2DAAmC,CAAA;IACnC,mDAA2B,CAAA;IAC3B,mEAA2C,CAAA;AAC/C,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAI7B;IACS;IAJ7B,YACI,IAA0B,EAC1B,OAAe,EACC,KAAc,EACL,KAAe;QAExC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAHL,UAAK,GAAL,KAAK,CAAS;QACL,UAAK,GAAL,KAAK,CAAU;IAG5C,CAAC;CACJ"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/magnet/parser/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,wDAAwD;AACxD,MAAM,CAAN,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC5B,kDAAkD;IAClD,0DAAkC,CAAA;IAClC,6FAA6F;IAC7F,uDAA+B,CAAA;IAC/B,uEAAuE;IACvE,2DAAmC,CAAA;IACnC,iFAAiF;IACjF,mDAA2B,CAAA;IAC3B,qEAAqE;IACrE,mEAA2C,CAAA;AAC/C,CAAC,EAXW,oBAAoB,KAApB,oBAAoB,QAW/B;AAED;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAK7B;IAES;IAN7B,YACI,IAA0B,EAC1B,OAAe;IACf,2DAA2D;IAC3C,KAAc;IAC9B,8EAA8E;IACrD,KAAe;QAExC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAJL,UAAK,GAAL,KAAK,CAAS;QAEL,UAAK,GAAL,KAAK,CAAU;IAG5C,CAAC;CACJ"}

package/dist/peer/pool/pool.error.d.ts

@@ -1,10 +1,23 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link PeerPoolError.code}. */
 export declare enum PeerPoolErrorCode {
+    /** A pool option (e.g. `targetConnections`) failed validation. */
     INVALID_OPTION = "PEER_POOL_INVALID_OPTION",
+    /** Every peer attempt failed and the connected count is below `minConnections`. See `causes` for details. */
     NO_CONNECTABLE_PEERS = "PEER_POOL_NO_CONNECTABLE_PEERS",
+    /** No peers were provided and `minConnections` is greater than zero. */
     NO_PEERS = "PEER_POOL_NO_PEERS"
 }
+/**
+ * Errors thrown by the peer connection pool.
+ *
+ * Typically reaches the caller as a download-time failure when no peers can be reached
+ * and `minConnections` is not zero.
+ */
 export declare class PeerPoolError extends BunTorrentError {
+    /** Individual peer connection errors collected during pool ramp-up. */
     readonly causes: unknown[];
-    constructor(code: PeerPoolErrorCode, message: string, causes?: unknown[]);
+    constructor(code: PeerPoolErrorCode, message: string, 
+    /** Individual peer connection errors collected during pool ramp-up. */
+    causes?: unknown[]);
 }

package/dist/peer/pool/pool.error.js

@@ -1,13 +1,25 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link PeerPoolError.code}. */
 export var PeerPoolErrorCode;
 (function (PeerPoolErrorCode) {
+    /** A pool option (e.g. `targetConnections`) failed validation. */
     PeerPoolErrorCode["INVALID_OPTION"] = "PEER_POOL_INVALID_OPTION";
+    /** Every peer attempt failed and the connected count is below `minConnections`. See `causes` for details. */
     PeerPoolErrorCode["NO_CONNECTABLE_PEERS"] = "PEER_POOL_NO_CONNECTABLE_PEERS";
+    /** No peers were provided and `minConnections` is greater than zero. */
     PeerPoolErrorCode["NO_PEERS"] = "PEER_POOL_NO_PEERS";
 })(PeerPoolErrorCode || (PeerPoolErrorCode = {}));
+/**
+ * Errors thrown by the peer connection pool.
+ *
+ * Typically reaches the caller as a download-time failure when no peers can be reached
+ * and `minConnections` is not zero.
+ */
 export class PeerPoolError extends BunTorrentError {
     causes;
-    constructor(code, message, causes = []) {
+    constructor(code, message, 
+    /** Individual peer connection errors collected during pool ramp-up. */
+    causes = []) {
         super(message, code);
         this.causes = causes;
     }

package/dist/peer/pool/pool.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.error.js","sourceRoot":"","sources":["../../../src/peer/pool/pool.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,gEAA2C,CAAA;IAC3C,4EAAuD,CAAA;IACvD,oDAA+B,CAAA;AACnC,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;IAI1B;IAHpB,YACI,IAAuB,EACvB,OAAe,EACC,SAAoB,EAAE;QAEtC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFL,WAAM,GAAN,MAAM,CAAgB;IAG1C,CAAC;CACJ"}
+{"version":3,"file":"pool.error.js","sourceRoot":"","sources":["../../../src/peer/pool/pool.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,qDAAqD;AACrD,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IACzB,kEAAkE;IAClE,gEAA2C,CAAA;IAC3C,6GAA6G;IAC7G,4EAAuD,CAAA;IACvD,wEAAwE;IACxE,oDAA+B,CAAA;AACnC,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAK1B;IAJpB,YACI,IAAuB,EACvB,OAAe;IACf,uEAAuE;IACvD,SAAoB,EAAE;QAEtC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFL,WAAM,GAAN,MAAM,CAAgB;IAG1C,CAAC;CACJ"}

package/dist/peer/session/session.error.d.ts

@@ -1,12 +1,27 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link PeerSessionError.code}. */
 export declare enum PeerSessionErrorCode {
+    /** The session was closed before or during the operation. */
     CLOSED = "PEER_SESSION_CLOSED",
+    /** The TCP connect or handshake exceeded `peerConnectTimeoutMs`. */
     CONNECT_TIMEOUT = "PEER_SESSION_CONNECT_TIMEOUT",
+    /** The peer's handshake info hash did not match the torrent's info hash. */
     INFO_HASH_MISMATCH = "PEER_SESSION_INFO_HASH_MISMATCH",
+    /** The socket closed before a full handshake was received. */
     SOCKET_CLOSED_BEFORE_HANDSHAKE = "PEER_SESSION_SOCKET_CLOSED_BEFORE_HANDSHAKE",
+    /** Lower-level socket error (e.g. ECONNREFUSED, ECONNRESET). See `cause`. */
     SOCKET_ERROR = "PEER_SESSION_SOCKET_ERROR"
 }
+/**
+ * Errors thrown by an individual peer session.
+ *
+ * Surfaced as `causes` entries on {@link PeerPoolError} when the pool fails to reach
+ * its connection target.
+ */
 export declare class PeerSessionError extends BunTorrentError {
+    /** Underlying error (typically a Node `net.Socket` error). */
     readonly cause?: unknown | undefined;
-    constructor(code: PeerSessionErrorCode, message: string, cause?: unknown | undefined);
+    constructor(code: PeerSessionErrorCode, message: string, 
+    /** Underlying error (typically a Node `net.Socket` error). */
+    cause?: unknown | undefined);
 }

package/dist/peer/session/session.error.js

@@ -1,15 +1,29 @@
 import { BunTorrentError } from '../../utils/errors';
+/** Error codes set on {@link PeerSessionError.code}. */
 export var PeerSessionErrorCode;
 (function (PeerSessionErrorCode) {
+    /** The session was closed before or during the operation. */
     PeerSessionErrorCode["CLOSED"] = "PEER_SESSION_CLOSED";
+    /** The TCP connect or handshake exceeded `peerConnectTimeoutMs`. */
     PeerSessionErrorCode["CONNECT_TIMEOUT"] = "PEER_SESSION_CONNECT_TIMEOUT";
+    /** The peer's handshake info hash did not match the torrent's info hash. */
     PeerSessionErrorCode["INFO_HASH_MISMATCH"] = "PEER_SESSION_INFO_HASH_MISMATCH";
+    /** The socket closed before a full handshake was received. */
     PeerSessionErrorCode["SOCKET_CLOSED_BEFORE_HANDSHAKE"] = "PEER_SESSION_SOCKET_CLOSED_BEFORE_HANDSHAKE";
+    /** Lower-level socket error (e.g. ECONNREFUSED, ECONNRESET). See `cause`. */
     PeerSessionErrorCode["SOCKET_ERROR"] = "PEER_SESSION_SOCKET_ERROR";
 })(PeerSessionErrorCode || (PeerSessionErrorCode = {}));
+/**
+ * Errors thrown by an individual peer session.
+ *
+ * Surfaced as `causes` entries on {@link PeerPoolError} when the pool fails to reach
+ * its connection target.
+ */
 export class PeerSessionError extends BunTorrentError {
     cause;
-    constructor(code, message, cause) {
+    constructor(code, message, 
+    /** Underlying error (typically a Node `net.Socket` error). */
+    cause) {
         super(message, code);
         this.cause = cause;
     }