bun-torrent 0.0.1-beta → 0.0.3-beta

package/README.md

@@ -1 +1,235 @@
 # bun-torrent
+
+A minimal Bun-native BitTorrent download-only client written in TypeScript.
+
+`bun-torrent` can parse `.torrent` files, announce to HTTP and UDP trackers, connect to peers, download pieces, validate piece hashes, and write the downloaded files to disk. The public API is intentionally small: create a `Client`, inspect a torrent when you need metadata, then call `download()`.
+
+It has no runtime dependencies.
+
+> This package is currently beta software. The API can still change before a stable release.
+
+## Requirements
+
+- Bun `>= 1.3.0`
+
+## Installation
+
+```bash
+bun add bun-torrent@beta
+```
+
+or:
+
+```bash
+npm install bun-torrent@beta
+```
+
+## Basic Usage
+
+```ts
+import { Client } from 'bun-torrent';
+
+const client = new Client({
+    outputDirectory: './downloads',
+});
+
+const torrent = await client.download({
+    torrentFile: './example.torrent',
+});
+
+torrent.on('progress', (progress) => {
+    console.log({
+        percent: `${(progress.percent * 100).toFixed(2)}%`,
+        downloaded: progress.downloadedBytes,
+        received: progress.receivedBytes,
+        speed: progress.speed,
+    });
+});
+
+torrent.on('done', () => {
+    console.log('Download complete');
+});
+
+torrent.on('error', (error) => {
+    console.error('Download failed', error);
+});
+
+await torrent.done;
+```
+
+`download()` returns a `Torrent` instance and starts the download immediately.
+
+## Client Setup
+
+```ts
+import { Client } from 'bun-torrent';
+
+const client = new Client({
+    outputDirectory: './downloads',
+    maxInFlightRequestsPerPeer: 20,
+    requestTimeoutMs: 15_000,
+    progressEvents: 'piece',
+    speedSampleIntervalMs: 500,
+});
+```
+
+Client options:
+
+- `outputDirectory`: directory where downloaded files are written. Defaults to `process.cwd()`.
+- `files`: optional default file selection for downloads.
+- `maxInFlightRequestsPerPeer`: maximum active block requests per peer. Defaults to `20`.
+- `requestTimeoutMs`: timeout for an individual block request. Defaults to `15000`.
+- `progressEvents`: `'piece'` emits progress when a piece completes, `'block'` emits for every received block. Defaults to `'piece'`.
+- `speedSampleIntervalMs`: minimum interval used to refresh speed calculations. Defaults to `500`.
+
+Options passed to `download()` override the client defaults for that download.
+
+## Inspecting a Torrent
+
+Use `inspect()` when you want metadata before starting a download, for example to show the file list or choose only some files.
+
+```ts
+const metadata = await client.inspect({
+    torrentFile: './example.torrent',
+});
+
+console.log(metadata.name);
+console.log(metadata.length);
+console.log(metadata.files);
+```
+
+Torrent file input can be a file path, `Uint8Array`, or `ArrayBuffer`.
+
+## Download Options
+
+```ts
+const torrent = await client.download(
+    {
+        torrentFile: './example.torrent',
+    },
+    {
+        outputDirectory: './downloads',
+        minConnections: 5,
+        announcePort: 6881,
+        progressEvents: 'block',
+        onChangeState: (state) => {
+            console.log('client state:', state);
+        },
+    },
+);
+```
+
+Download options:
+
+- `outputDirectory`: override the output directory for this download.
+- `files`: download only selected files.
+- `minConnections`: minimum connectable peer count requested before downloading starts.
+- `announcePort`: port sent to trackers in announce requests.
+- `maxInFlightRequestsPerPeer`: override request concurrency per peer.
+- `requestTimeoutMs`: override block request timeout.
+- `progressEvents`: `'piece'` or `'block'`.
+- `speedSampleIntervalMs`: override speed sample interval.
+- `onChangeState`: receives client setup states: `parsing`, `tracking`, `connecting`, `downloading`.
+
+Tracker announce failures are treated as non-fatal. If no tracker responds, the client can still continue with an empty peer list instead of throwing during tracking.
+
+## Selecting Files
+
+For multi-file torrents, pass `files` to download only specific files. A file can be selected by its slash-joined path string or by its torrent path array.
+
+```ts
+const metadata = await client.inspect({
+    torrentFile: './big-buck-bunny.torrent',
+});
+
+console.log(metadata.files);
+
+const torrent = await client.download(
+    {
+        torrentFile: './big-buck-bunny.torrent',
+    },
+    {
+        outputDirectory: './downloads',
+        files: ['Big Buck Bunny.mp4'],
+    },
+);
+
+console.log(torrent.files);
+await torrent.done;
+```
+
+`torrent.files` separates the selected files from the skipped files:
+
+```ts
+{
+    included: [
+        { path: ['Big Buck Bunny.mp4'], length: 276134947, offset: 140 },
+    ],
+    excluded: [
+        { path: ['Big Buck Bunny.en.srt'], length: 140, offset: 0 },
+        { path: ['poster.jpg'], length: 310380, offset: 276135087 },
+    ],
+}
+```
+
+Passing `files: null` or omitting `files` downloads everything.
+
+## Torrent Events
+
+```ts
+torrent.on('state', ({ previous, state }) => {
+    console.log(previous, '->', state);
+});
+
+torrent.on('progress', (progress) => {
+    console.log(progress.percent, progress.speed);
+});
+
+torrent.on('peer', (peer) => {
+    console.log('peer connected', peer);
+});
+
+torrent.on('done', () => {
+    console.log('done');
+});
+
+torrent.on('error', (error) => {
+    console.error(error);
+});
+
+torrent.on('close', () => {
+    console.log('closed');
+});
+```
+
+The current torrent state is also available through `torrent.state`. Possible states are:
+
+- `downloading`
+- `completed`
+- `failed`
+- `closed`
+
+Call `torrent.close()` to stop the download and close peer connections.
+
+## Progress Shape
+
+Progress events and `torrent.progress` expose:
+
+```ts
+{
+    totalBytes: number;
+    receivedBytes: number;
+    downloadedBytes: number;
+    totalPieces: number;
+    completedPieces: number;
+    percent: number;
+    speedBytesPerSecond: number;
+    speed: string;
+}
+```
+
+`receivedBytes` counts received piece data, while `downloadedBytes` counts completed and hash-validated pieces.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,50 @@
+import { type DownloadProgressEventMode } from './torrent/download';
+import { Torrent } from './torrent/session/index';
+import type { TorrentMetadata } from './torrent/types';
+import type { TorrentFileSelection } from './torrent/file-selection';
+export declare enum DownloadState {
+    PARSING = "parsing",
+    TRACKING = "tracking",
+    CONNECTING = "connecting",
+    DOWNLOADING = "downloading"
+}
+export type ClientConfig = {
+    files?: TorrentFileSelection;
+    maxInFlightRequestsPerPeer?: number;
+    outputDirectory?: string;
+    progressEvents?: DownloadProgressEventMode;
+    requestTimeoutMs?: number;
+    speedSampleIntervalMs?: number;
+};
+export declare const DEFAULT_CLIENT_CONFIG: {
+    readonly maxInFlightRequestsPerPeer: 20;
+    readonly progressEvents: "piece";
+    readonly requestTimeoutMs: 15000;
+    readonly speedSampleIntervalMs: 500;
+};
+export declare class Client {
+    private readonly config;
+    private readonly peerId;
+    constructor(config?: ClientConfig);
+    download(input: {
+        torrentFile: string | Uint8Array | ArrayBuffer;
+    }, options?: DownloadOptions): Promise<Torrent>;
+    inspect(input: {
+        torrentFile: string | Uint8Array | ArrayBuffer;
+    }): Promise<TorrentMetadata>;
+    private trackPeers;
+}
+export type DownloadOptions = {
+    announcePort?: number;
+    files?: TorrentFileSelection;
+    maxInFlightRequestsPerPeer?: number;
+    minConnections?: number;
+    onChangeState?: (state: DownloadState) => unknown;
+    outputDirectory?: string;
+    progressEvents?: DownloadProgressEventMode;
+    requestTimeoutMs?: number;
+    speedSampleIntervalMs?: number;
+};
+export type TorrentFileInput = string | Uint8Array | ArrayBuffer;
+export declare const readTorrentFile: (input: TorrentFileInput) => Promise<Uint8Array>;
+export { Client as TorrentClient };

package/dist/client.error.d.ts

@@ -0,0 +1,8 @@
+import { BunTorrentError } from './utils/errors';
+export declare enum ClientErrorCode {
+    INVALID_FILE_SELECTION = "CLIENT_INVALID_FILE_SELECTION",
+    UNSUPPORTED_TORRENT_FILE_INPUT = "CLIENT_UNSUPPORTED_TORRENT_FILE_INPUT"
+}
+export declare class ClientError extends BunTorrentError {
+    constructor(code: ClientErrorCode, message: string);
+}

package/dist/client.error.js

@@ -0,0 +1,12 @@
+import { BunTorrentError } from './utils/errors';
+export var ClientErrorCode;
+(function (ClientErrorCode) {
+    ClientErrorCode["INVALID_FILE_SELECTION"] = "CLIENT_INVALID_FILE_SELECTION";
+    ClientErrorCode["UNSUPPORTED_TORRENT_FILE_INPUT"] = "CLIENT_UNSUPPORTED_TORRENT_FILE_INPUT";
+})(ClientErrorCode || (ClientErrorCode = {}));
+export class ClientError extends BunTorrentError {
+    constructor(code, message) {
+        super(message, code);
+    }
+}
+//# sourceMappingURL=client.error.js.map

package/dist/client.error.js.map

@@ -0,0 +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,eAGX;AAHD,WAAY,eAAe;IACvB,2EAAwD,CAAA;IACxD,2FAAwE,CAAA;AAC5E,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,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

@@ -0,0 +1,112 @@
+import { createPeerId } from './peer/peer-id';
+import { openPeerPool } from './peer/pool';
+import { DownloadManager } from './torrent/download';
+import { parseTorrent } from './torrent/parser';
+import { Torrent } from './torrent/session/index';
+import { ClientError, ClientErrorCode } from './client.error';
+import { trackPeers, TrackerError, TrackerErrorCode } from './tracker';
+import { getUnknownSelectedFiles, normalizeTorrentFileSelection } from './torrent/file-selection';
+export var DownloadState;
+(function (DownloadState) {
+    DownloadState["PARSING"] = "parsing";
+    DownloadState["TRACKING"] = "tracking";
+    DownloadState["CONNECTING"] = "connecting";
+    DownloadState["DOWNLOADING"] = "downloading";
+})(DownloadState || (DownloadState = {}));
+export const DEFAULT_CLIENT_CONFIG = {
+    maxInFlightRequestsPerPeer: 20,
+    progressEvents: 'piece',
+    requestTimeoutMs: 15_000,
+    speedSampleIntervalMs: 500,
+};
+export class Client {
+    config;
+    peerId;
+    constructor(config = {}) {
+        this.config = config;
+        this.peerId = createPeerId();
+    }
+    async download(input, options = {}) {
+        options.onChangeState?.(DownloadState.PARSING);
+        const meta = await this.inspect(input);
+        const downloadConfig = resolveDownloadConfig(this.config, options);
+        assertValidFileSelection(meta, downloadConfig.files);
+        options.onChangeState?.(DownloadState.TRACKING);
+        const peers = await this.trackPeers(meta, options);
+        options.onChangeState?.(DownloadState.CONNECTING);
+        const pool = await openPeerPool(peers, {
+            infoHash: meta.infoHash,
+            peerId: this.peerId,
+            targetConnections: 20,
+            totalPieces: meta.pieces.length,
+            minConnections: options.minConnections ?? 0,
+            maxConnecting: 30,
+            timeoutMs: 5_000,
+        });
+        options.onChangeState?.(DownloadState.DOWNLOADING);
+        return new Torrent(meta, pool, new DownloadManager({
+            metadata: meta,
+            files: downloadConfig.files,
+            outputDirectory: downloadConfig.outputDirectory,
+            peerPool: pool,
+            maxInFlightRequestsPerPeer: downloadConfig.maxInFlightRequestsPerPeer,
+            progressEvents: downloadConfig.progressEvents,
+            requestTimeoutMs: downloadConfig.requestTimeoutMs,
+            speedSampleIntervalMs: downloadConfig.speedSampleIntervalMs,
+        }), normalizeTorrentFileSelection(downloadConfig.files));
+    }
+    async inspect(input) {
+        const bytes = await readTorrentFile(input.torrentFile);
+        return parseTorrent(bytes);
+    }
+    async trackPeers(meta, options) {
+        try {
+            return await trackPeers({
+                meta,
+                peerId: this.peerId,
+                announcePort: options.announcePort,
+                timeoutMs: 5_000,
+            });
+        }
+        catch (error) {
+            if (isNonFatalTrackerError(error))
+                return [];
+            throw error;
+        }
+    }
+}
+const isNonFatalTrackerError = (error) => error instanceof TrackerError &&
+    (error.code === TrackerErrorCode.ANNOUNCE_FAILED ||
+        error.code === TrackerErrorCode.NO_PEERS ||
+        error.code === TrackerErrorCode.NO_SUPPORTED_TRACKERS);
+const resolveDownloadConfig = (config, options) => ({
+    files: options.files ?? config.files ?? null,
+    maxInFlightRequestsPerPeer: options.maxInFlightRequestsPerPeer ??
+        config.maxInFlightRequestsPerPeer ??
+        DEFAULT_CLIENT_CONFIG.maxInFlightRequestsPerPeer,
+    outputDirectory: options.outputDirectory ?? config.outputDirectory ?? process.cwd(),
+    progressEvents: options.progressEvents ?? config.progressEvents ?? DEFAULT_CLIENT_CONFIG.progressEvents,
+    requestTimeoutMs: options.requestTimeoutMs ??
+        config.requestTimeoutMs ??
+        DEFAULT_CLIENT_CONFIG.requestTimeoutMs,
+    speedSampleIntervalMs: options.speedSampleIntervalMs ??
+        config.speedSampleIntervalMs ??
+        DEFAULT_CLIENT_CONFIG.speedSampleIntervalMs,
+});
+const assertValidFileSelection = (metadata, files) => {
+    const unknownFiles = getUnknownSelectedFiles(metadata, files);
+    if (unknownFiles.length === 0)
+        return;
+    throw new ClientError(ClientErrorCode.INVALID_FILE_SELECTION, `Unknown torrent file selection: ${unknownFiles.join(', ')}`);
+};
+export const readTorrentFile = async (input) => {
+    if (typeof input === 'string')
+        return await Bun.file(input).bytes();
+    if (input instanceof Uint8Array)
+        return input;
+    if (input instanceof ArrayBuffer)
+        return new Uint8Array(input);
+    throw new ClientError(ClientErrorCode.UNSUPPORTED_TORRENT_FILE_INPUT, 'Unsupported torrent file input');
+};
+export { Client as TorrentClient };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAkC,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAElG,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,0CAAyB,CAAA;IACzB,4CAA2B,CAAA;AAC/B,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAWD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,0BAA0B,EAAE,EAAE;IAC9B,cAAc,EAAE,OAAO;IACvB,gBAAgB,EAAE,MAAM;IACxB,qBAAqB,EAAE,GAAG;CAS7B,CAAC;AAEF,MAAM,OAAO,MAAM;IAGc;IAFZ,MAAM,CAAa;IAEpC,YAA6B,SAAuB,EAAE;QAAzB,WAAM,GAAN,MAAM,CAAmB;QAClD,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,QAAQ,CACjB,KAEC,EACD,UAA2B,EAAE;QAE7B,OAAO,CAAC,aAAa,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnE,wBAAwB,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;QAErD,OAAO,CAAC,aAAa,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnD,OAAO,CAAC,aAAa,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,iBAAiB,EAAE,EAAE;YACrB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC;YAC3C,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,OAAO,CAAC,aAAa,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QACnD,OAAO,IAAI,OAAO,CACd,IAAI,EACJ,IAAI,EACJ,IAAI,eAAe,CAAC;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,eAAe,EAAE,cAAc,CAAC,eAAe;YAC/C,QAAQ,EAAE,IAAI;YACd,0BAA0B,EAAE,cAAc,CAAC,0BAA0B;YACrE,cAAc,EAAE,cAAc,CAAC,cAAc;YAC7C,gBAAgB,EAAE,cAAc,CAAC,gBAAgB;YACjD,qBAAqB,EAAE,cAAc,CAAC,qBAAqB;SAC9D,CAAC,EACF,6BAA6B,CAAC,cAAc,CAAC,KAAK,CAAC,CACtD,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAEpB;QACG,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACvD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAqB,EAAE,OAAwB;QACpE,IAAI,CAAC;YACD,OAAO,MAAM,UAAU,CAAC;gBACpB,IAAI;gBACJ,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,KAAK;aACnB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,sBAAsB,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC7C,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ;AAkBD,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAyB,EAAE,CACrE,KAAK,YAAY,YAAY;IAC7B,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,eAAe;QAC5C,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ;QACxC,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;AAE/D,MAAM,qBAAqB,GAAG,CAC1B,MAAoB,EACpB,OAAwB,EACF,EAAE,CAAC,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;IAC5C,0BAA0B,EACtB,OAAO,CAAC,0BAA0B;QAClC,MAAM,CAAC,0BAA0B;QACjC,qBAAqB,CAAC,0BAA0B;IACpD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE;IACnF,cAAc,EACV,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,IAAI,qBAAqB,CAAC,cAAc;IAC3F,gBAAgB,EACZ,OAAO,CAAC,gBAAgB;QACxB,MAAM,CAAC,gBAAgB;QACvB,qBAAqB,CAAC,gBAAgB;IAC1C,qBAAqB,EACjB,OAAO,CAAC,qBAAqB;QAC7B,MAAM,CAAC,qBAAqB;QAC5B,qBAAqB,CAAC,qBAAqB;CAClD,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAC7B,QAAyB,EACzB,KAAuC,EACnC,EAAE;IACN,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEtC,MAAM,IAAI,WAAW,CACjB,eAAe,CAAC,sBAAsB,EACtC,mCAAmC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;AACN,CAAC,CAAC;AAIF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,KAAuB,EAAuB,EAAE;IAClF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IACpE,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAE/D,MAAM,IAAI,WAAW,CACjB,eAAe,CAAC,8BAA8B,EAC9C,gCAAgC,CACnC,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026 Nikola Nedeljkovic
+ * SPDX-License-Identifier: MIT
+ */
+export * from './client';
+export { ClientError, ClientErrorCode } from './client.error';
+export { BencodeDecodeError, BencodeDecodeErrorCode, BencodeEncodeError, BencodeEncodeErrorCode, computeInfoHash, decodeBencode, encodeBencode, parseTorrent, Torrent, TorrentState, toBValue, TorrentParseError, TorrentParseErrorCode, type TorrentFileSelection, type TorrentMetadata, } from './torrent/index';
+export { connectToPeers, createPeerId, decodeHandshake, decodePeerMessage, encodePeerMessage, encodeHandshake, HandshakeErrorCode, PeerMessageError, PeerMessageErrorCode, PeerMessageId, PeerHandshakeError, PeerPoolError, PeerPoolErrorCode, PeerPool, PeerSession, PeerSessionError, PeerSessionErrorCode, openPeerPool, type PeerHandshake, } from './peer/index';
+export { TrackerError, TrackerErrorCode } from './tracker';
+export type { BitfieldMessage, CancelMessage, ChokeMessage, HaveMessage, InterestedMessage, KeepAliveMessage, NotInterestedMessage, PeerMessage, PieceMessage, RequestMessage, UnchokeMessage, PeerConnectionSession, PeerPoolOptions, PeerSessionConnectOptions, } from './peer/index';
+export { BunTorrentError } from './utils/errors';
+export type { BBytes, BDict, BInteger, BList, BValue, BencodeInput, TorrentFiles, TorrentStats, TorrentStateChange, } from './torrent/index';

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 Nikola Nedeljkovic
+ * SPDX-License-Identifier: MIT
+ */
+export * from './client';
+export { ClientError, ClientErrorCode } from './client.error';
+export { BencodeDecodeError, BencodeDecodeErrorCode, BencodeEncodeError, BencodeEncodeErrorCode, computeInfoHash, decodeBencode, encodeBencode, parseTorrent, Torrent, TorrentState, toBValue, TorrentParseError, TorrentParseErrorCode, } from './torrent/index';
+export { connectToPeers, createPeerId, decodeHandshake, decodePeerMessage, encodePeerMessage, encodeHandshake, HandshakeErrorCode, PeerMessageError, PeerMessageErrorCode, PeerMessageId, PeerHandshakeError, PeerPoolError, PeerPoolErrorCode, PeerPool, PeerSession, PeerSessionError, PeerSessionErrorCode, openPeerPool, } from './peer/index';
+export { TrackerError, TrackerErrorCode } from './tracker';
+export { BunTorrentError } from './utils/errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EACH,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,qBAAqB,GAGxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,GAEf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAkB3D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/peer/availability.d.ts

@@ -0,0 +1,50 @@
+export type PeerPieceAvailabilityOptions = {
+    bitfield?: Uint8Array;
+};
+/**
+ * Mutable view of which torrent pieces a peer claims to have.
+ */
+export declare class PeerPieceAvailability {
+    readonly totalPieces: number;
+    private readonly pieces;
+    /**
+     * Create availability state from an optional peer bitfield.
+     *
+     * @param totalPieces - Number of pieces in the torrent.
+     * @param options - Optional initial bitfield from the peer.
+     */
+    constructor(totalPieces: number, options?: PeerPieceAvailabilityOptions);
+    /**
+     * Return true when the peer claims to have a piece.
+     *
+     * @param pieceIndex - Zero-based piece index.
+     * @returns Whether the peer has the piece. Invalid indexes return false.
+     */
+    hasPiece(pieceIndex: number): boolean;
+    /**
+     * Mark one piece as available after receiving a peer `have` message.
+     *
+     * @param pieceIndex - Zero-based piece index.
+     */
+    markHave(pieceIndex: number): void;
+    /**
+     * Replace availability from a peer `bitfield` message.
+     *
+     * @param bitfield - Raw bitfield payload from the peer.
+     */
+    setBitfield(bitfield: Uint8Array): void;
+    /**
+     * Return available piece indexes in ascending order.
+     *
+     * @returns Piece indexes currently marked as available.
+     */
+    toPieceIndexes(): number[];
+}
+/**
+ * Create mutable availability state from an optional peer bitfield.
+ *
+ * @param totalPieces - Number of pieces in the torrent.
+ * @param bitfield - Optional raw bitfield payload from the peer.
+ * @returns Peer piece availability state.
+ */
+export declare const createPeerPieceAvailability: (totalPieces: number, bitfield?: Uint8Array) => PeerPieceAvailability;

package/{src/peer/availability.ts → dist/peer/availability.js}

@@ -1,72 +1,58 @@
-export type PeerPieceAvailabilityOptions = {
-    bitfield?: Uint8Array;
-};
-
 /**
  * Mutable view of which torrent pieces a peer claims to have.
  */
 export class PeerPieceAvailability {
-    private readonly pieces: boolean[];
-
+    totalPieces;
+    pieces;
     /**
      * Create availability state from an optional peer bitfield.
      *
      * @param totalPieces - Number of pieces in the torrent.
      * @param options - Optional initial bitfield from the peer.
      */
-    public constructor(
-        public readonly totalPieces: number,
-        options: PeerPieceAvailabilityOptions = {},
-    ) {
-        this.pieces = Array.from({ length: totalPieces }, (_, pieceIndex) =>
-            options.bitfield ? hasBitfieldPiece(options.bitfield, pieceIndex) : false,
-        );
+    constructor(totalPieces, options = {}) {
+        this.totalPieces = totalPieces;
+        this.pieces = Array.from({ length: totalPieces }, (_, pieceIndex) => options.bitfield ? hasBitfieldPiece(options.bitfield, pieceIndex) : false);
     }
-
     /**
      * Return true when the peer claims to have a piece.
      *
      * @param pieceIndex - Zero-based piece index.
      * @returns Whether the peer has the piece. Invalid indexes return false.
      */
-    public hasPiece(pieceIndex: number): boolean {
+    hasPiece(pieceIndex) {
         return this.pieces[pieceIndex] ?? false;
     }
-
     /**
      * Mark one piece as available after receiving a peer `have` message.
      *
      * @param pieceIndex - Zero-based piece index.
      */
-    public markHave(pieceIndex: number): void {
+    markHave(pieceIndex) {
         if (!Number.isInteger(pieceIndex) || pieceIndex < 0 || pieceIndex >= this.totalPieces) {
             return;
         }
-
         this.pieces[pieceIndex] = true;
     }
-
     /**
      * Replace availability from a peer `bitfield` message.
      *
      * @param bitfield - Raw bitfield payload from the peer.
      */
-    public setBitfield(bitfield: Uint8Array): void {
+    setBitfield(bitfield) {
         for (let pieceIndex = 0; pieceIndex < this.totalPieces; pieceIndex += 1) {
             this.pieces[pieceIndex] = hasBitfieldPiece(bitfield, pieceIndex);
         }
     }
-
     /**
      * Return available piece indexes in ascending order.
      *
      * @returns Piece indexes currently marked as available.
      */
-    public toPieceIndexes(): number[] {
+    toPieceIndexes() {
         return this.pieces.flatMap((available, pieceIndex) => (available ? [pieceIndex] : []));
     }
 }
-
 /**
  * Create mutable availability state from an optional peer bitfield.
  *
@@ -74,15 +60,12 @@ export class PeerPieceAvailability {
  * @param bitfield - Optional raw bitfield payload from the peer.
  * @returns Peer piece availability state.
  */
-export const createPeerPieceAvailability = (
-    totalPieces: number,
-    bitfield?: Uint8Array,
-): PeerPieceAvailability => new PeerPieceAvailability(totalPieces, { bitfield });
-
-const hasBitfieldPiece = (bitfield: Uint8Array, pieceIndex: number): boolean => {
+export const createPeerPieceAvailability = (totalPieces, bitfield) => new PeerPieceAvailability(totalPieces, { bitfield });
+const hasBitfieldPiece = (bitfield, pieceIndex) => {
     const byte = bitfield[Math.floor(pieceIndex / 8)];
-    if (byte === undefined) return false;
-
+    if (byte === undefined)
+        return false;
     const mask = 0x80 >> (pieceIndex % 8);
     return (byte & mask) !== 0;
 };
+//# sourceMappingURL=availability.js.map

package/dist/peer/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/peer/availability.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAUV;IATH,MAAM,CAAY;IAEnC;;;;;OAKG;IACH,YACoB,WAAmB,EACnC,UAAwC,EAAE;QAD1B,gBAAW,GAAX,WAAW,CAAQ;QAGnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAChE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAC5E,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACI,QAAQ,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,UAAkB;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpF,OAAO;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAoB;QACnC,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACvC,WAAmB,EACnB,QAAqB,EACA,EAAE,CAAC,IAAI,qBAAqB,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAEjF,MAAM,gBAAgB,GAAG,CAAC,QAAoB,EAAE,UAAkB,EAAW,EAAE;IAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/dist/peer/consts.d.ts

@@ -0,0 +1,8 @@
+export declare const PROTOCOL = "BitTorrent protocol";
+export declare const PROTOCOL_BYTES: NodeJS.NonSharedUint8Array;
+export declare const PEER_ID_PREFIX = "-BT0001-";
+export declare const HANDSHAKE_LENGTH = 68;
+export declare const RESERVED_LENGTH = 8;
+export declare const INFO_HASH_LENGTH = 20;
+export declare const PEER_ID_LENGTH = 20;
+export declare const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";

package/{src/peer/consts.ts → dist/peer/consts.js}

@@ -1,11 +1,9 @@
 export const PROTOCOL = 'BitTorrent protocol';
 export const PROTOCOL_BYTES = new TextEncoder().encode(PROTOCOL);
-
 export const PEER_ID_PREFIX = '-BT0001-';
-
 export const HANDSHAKE_LENGTH = 68;
 export const RESERVED_LENGTH = 8;
 export const INFO_HASH_LENGTH = 20;
 export const PEER_ID_LENGTH = 20;
-
 export const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+//# sourceMappingURL=consts.js.map

package/dist/peer/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/peer/consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,qBAAqB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAG,gEAAgE,CAAC"}

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

@@ -0,0 +1,11 @@
+import { BunTorrentError } from '../../utils/errors';
+export declare enum HandshakeErrorCode {
+    INFOHASH_INVALID_LENGTH = "HANDSHK_INFOHASH_INVALID_LENGTH",
+    INVALID_LENGTH = "HANDSHK_INVALID_LENGTH",
+    INVALID_PROTOCOL = "HANDSHK_INVALID_PROTOCOL",
+    PEERID_INVALID_LENGTH = "HANDSHK_PEERID_INVALID_LENGTH",
+    RESERVED_INVALID_LENGTH = "HANDSHK_RESERVED_INVALID_LENGTH"
+}
+export declare class PeerHandshakeError extends BunTorrentError {
+    constructor(code: HandshakeErrorCode, message: string);
+}