bun-torrent 0.0.2-beta → 0.0.4-beta

package/README.md

@@ -66,8 +66,13 @@ import { Client } from 'bun-torrent';
 
 const client = new Client({
     outputDirectory: './downloads',
+    targetConnections: 20,
+    maxConnecting: 30,
     maxInFlightRequestsPerPeer: 20,
+    peerConnectTimeoutMs: 5_000,
+    trackerTimeoutMs: 5_000,
     requestTimeoutMs: 15_000,
+    seed: false,
     progressEvents: 'piece',
     speedSampleIntervalMs: 500,
 });
@@ -77,8 +82,14 @@ Client options:
 
 - `outputDirectory`: directory where downloaded files are written. Defaults to `process.cwd()`.
 - `files`: optional default file selection for downloads.
+- `targetConnections`: preferred number of connected peers. Defaults to `20`.
+- `minConnections`: minimum connectable peer count before downloading starts. Defaults to `0`.
+- `maxConnecting`: maximum simultaneous peer connection attempts. Defaults to `30`.
+- `peerConnectTimeoutMs`: timeout for connecting to one peer. Defaults to `5000`.
+- `trackerTimeoutMs`: timeout for tracker announces. Defaults to `5000`.
 - `maxInFlightRequestsPerPeer`: maximum active block requests per peer. Defaults to `20`.
 - `requestTimeoutMs`: timeout for an individual block request. Defaults to `15000`.
+- `seed`: reserved for future seeding support. Currently only `false` is supported.
 - `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`.
 
@@ -109,8 +120,11 @@ const torrent = await client.download(
     },
     {
         outputDirectory: './downloads',
+        targetConnections: 50,
+        maxConnecting: 100,
         minConnections: 5,
         announcePort: 6881,
+        seed: false,
         progressEvents: 'block',
         onChangeState: (state) => {
             console.log('client state:', state);
@@ -123,10 +137,15 @@ Download options:
 
 - `outputDirectory`: override the output directory for this download.
 - `files`: download only selected files.
+- `targetConnections`: override the preferred peer connection count.
 - `minConnections`: minimum connectable peer count requested before downloading starts.
+- `maxConnecting`: override simultaneous peer connection attempts.
+- `peerConnectTimeoutMs`: override peer connection timeout.
+- `trackerTimeoutMs`: override tracker announce timeout.
 - `announcePort`: port sent to trackers in announce requests.
 - `maxInFlightRequestsPerPeer`: override request concurrency per peer.
 - `requestTimeoutMs`: override block request timeout.
+- `seed`: reserved for future seeding support. Currently only `false` is supported.
 - `progressEvents`: `'piece'` or `'block'`.
 - `speedSampleIntervalMs`: override speed sample interval.
 - `onChangeState`: receives client setup states: `parsing`, `tracking`, `connecting`, `downloading`.
@@ -185,8 +204,8 @@ torrent.on('progress', (progress) => {
     console.log(progress.percent, progress.speed);
 });
 
-torrent.on('peer', (peer) => {
-    console.log('peer connected', peer);
+torrent.on('peer', (stats) => {
+    console.log('peer connected', stats.connections, '/', stats.targetConnections);
 });
 
 torrent.on('done', () => {
@@ -209,7 +228,7 @@ The current torrent state is also available through `torrent.state`. Possible st
 - `failed`
 - `closed`
 
-Call `torrent.close()` to stop the download and close peer connections.
+When a download completes, `torrent.done` resolves, the state becomes `completed`, and internal peer connections are closed automatically because seeding is not implemented yet. Call `torrent.close()` to stop an active download early or to mark a completed torrent as explicitly closed.
 
 ## Progress Shape
 

package/dist/client.d.ts

@@ -0,0 +1,67 @@
+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;
+    maxConnecting?: number;
+    minConnections?: number;
+    outputDirectory?: string;
+    peerConnectTimeoutMs?: number;
+    progressEvents?: DownloadProgressEventMode;
+    requestTimeoutMs?: number;
+    seed?: false;
+    speedSampleIntervalMs?: number;
+    targetConnections?: number;
+    trackerTimeoutMs?: number;
+};
+export declare const DEFAULT_CLIENT_CONFIG: {
+    readonly maxInFlightRequestsPerPeer: 20;
+    readonly maxConnecting: 30;
+    readonly minConnections: 0;
+    readonly peerConnectTimeoutMs: 5000;
+    readonly progressEvents: "piece";
+    readonly requestTimeoutMs: 15000;
+    readonly seed: false;
+    readonly speedSampleIntervalMs: 500;
+    readonly targetConnections: 20;
+    readonly trackerTimeoutMs: 5000;
+};
+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;
+    maxConnecting?: number;
+    minConnections?: number;
+    onChangeState?: (state: DownloadState) => unknown;
+    outputDirectory?: string;
+    peerConnectTimeoutMs?: number;
+    progressEvents?: DownloadProgressEventMode;
+    requestTimeoutMs?: number;
+    seed?: false;
+    speedSampleIntervalMs?: number;
+    targetConnections?: number;
+    trackerTimeoutMs?: 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,130 @@
+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,
+    maxConnecting: 30,
+    minConnections: 0,
+    peerConnectTimeoutMs: 5_000,
+    progressEvents: 'piece',
+    requestTimeoutMs: 15_000,
+    seed: false,
+    speedSampleIntervalMs: 500,
+    targetConnections: 20,
+    trackerTimeoutMs: 5_000,
+};
+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, downloadConfig);
+        options.onChangeState?.(DownloadState.CONNECTING);
+        const pool = await openPeerPool(peers, {
+            infoHash: meta.infoHash,
+            peerId: this.peerId,
+            targetConnections: downloadConfig.targetConnections,
+            totalPieces: meta.pieces.length,
+            minConnections: downloadConfig.minConnections,
+            maxConnecting: downloadConfig.maxConnecting,
+            timeoutMs: downloadConfig.peerConnectTimeoutMs,
+        });
+        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), downloadConfig.seed);
+    }
+    async inspect(input) {
+        const bytes = await readTorrentFile(input.torrentFile);
+        return parseTorrent(bytes);
+    }
+    async trackPeers(meta, options, config) {
+        try {
+            return await trackPeers({
+                meta,
+                peerId: this.peerId,
+                announcePort: options.announcePort,
+                timeoutMs: config.trackerTimeoutMs,
+            });
+        }
+        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,
+    maxConnecting: options.maxConnecting ?? config.maxConnecting ?? DEFAULT_CLIENT_CONFIG.maxConnecting,
+    minConnections: options.minConnections ?? config.minConnections ?? DEFAULT_CLIENT_CONFIG.minConnections,
+    outputDirectory: options.outputDirectory ?? config.outputDirectory ?? process.cwd(),
+    peerConnectTimeoutMs: options.peerConnectTimeoutMs ??
+        config.peerConnectTimeoutMs ??
+        DEFAULT_CLIENT_CONFIG.peerConnectTimeoutMs,
+    progressEvents: options.progressEvents ?? config.progressEvents ?? DEFAULT_CLIENT_CONFIG.progressEvents,
+    requestTimeoutMs: options.requestTimeoutMs ??
+        config.requestTimeoutMs ??
+        DEFAULT_CLIENT_CONFIG.requestTimeoutMs,
+    seed: options.seed ?? config.seed ?? DEFAULT_CLIENT_CONFIG.seed,
+    speedSampleIntervalMs: options.speedSampleIntervalMs ??
+        config.speedSampleIntervalMs ??
+        DEFAULT_CLIENT_CONFIG.speedSampleIntervalMs,
+    targetConnections: options.targetConnections ??
+        config.targetConnections ??
+        DEFAULT_CLIENT_CONFIG.targetConnections,
+    trackerTimeoutMs: options.trackerTimeoutMs ??
+        config.trackerTimeoutMs ??
+        DEFAULT_CLIENT_CONFIG.trackerTimeoutMs,
+});
+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":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 Nikola Nedeljkovic
+ * SPDX-License-Identifier: MIT
+ */
+export { Client, DEFAULT_CLIENT_CONFIG, DownloadState, TorrentClient } from './client';
+export { ClientError, ClientErrorCode } from './client.error';
+export type { ClientConfig, DownloadOptions, TorrentFileInput } from './client';
+export { Torrent, TorrentState, TorrentParseError, TorrentParseErrorCode, TorrentStorageError, TorrentStorageErrorCode, PiecePlannerError, PiecePlannerErrorCode, } from './torrent/index';
+export { PeerPoolError, PeerPoolErrorCode, PeerSessionError, PeerSessionErrorCode } from './peer';
+export { TrackerError, TrackerErrorCode } from './tracker';
+export type { DownloadProgress, DownloadProgressEventMode, TorrentFileSelection, TorrentFiles, TorrentMetadata, TorrentStats, TorrentStateChange, } from './torrent/index';
+export type { TorrentFile } from './torrent/types';
+export { BunTorrentError } from './utils/errors';

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 Nikola Nedeljkovic
+ * SPDX-License-Identifier: MIT
+ */
+export { Client, DEFAULT_CLIENT_CONFIG, DownloadState, TorrentClient } from './client';
+export { ClientError, ClientErrorCode } from './client.error';
+export { Torrent, TorrentState, TorrentParseError, TorrentParseErrorCode, TorrentStorageError, TorrentStorageErrorCode, PiecePlannerError, PiecePlannerErrorCode, } from './torrent/index';
+export { PeerPoolError, PeerPoolErrorCode, PeerSessionError, PeerSessionErrorCode } from './peer';
+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,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,EACH,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAa3D,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);
+}

package/dist/peer/handshake/handshake.error.js

@@ -0,0 +1,15 @@
+import { BunTorrentError } from '../../utils/errors';
+export var HandshakeErrorCode;
+(function (HandshakeErrorCode) {
+    HandshakeErrorCode["INFOHASH_INVALID_LENGTH"] = "HANDSHK_INFOHASH_INVALID_LENGTH";
+    HandshakeErrorCode["INVALID_LENGTH"] = "HANDSHK_INVALID_LENGTH";
+    HandshakeErrorCode["INVALID_PROTOCOL"] = "HANDSHK_INVALID_PROTOCOL";
+    HandshakeErrorCode["PEERID_INVALID_LENGTH"] = "HANDSHK_PEERID_INVALID_LENGTH";
+    HandshakeErrorCode["RESERVED_INVALID_LENGTH"] = "HANDSHK_RESERVED_INVALID_LENGTH";
+})(HandshakeErrorCode || (HandshakeErrorCode = {}));
+export class PeerHandshakeError extends BunTorrentError {
+    constructor(code, message) {
+        super(message, code);
+    }
+}
+//# sourceMappingURL=handshake.error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.error.js","sourceRoot":"","sources":["../../../src/peer/handshake/handshake.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC1B,iFAA2D,CAAA;IAC3D,+DAAyC,CAAA;IACzC,mEAA6C,CAAA;IAC7C,6EAAuD,CAAA;IACvD,iFAA2D,CAAA;AAC/D,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,IAAwB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;CACJ"}

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

@@ -0,0 +1,7 @@
+import type { PeerHandshake } from '../types';
+export declare const encodeHandshake: (input: {
+    infoHash: Uint8Array;
+    peerId: Uint8Array;
+    reserved?: Uint8Array;
+}) => Uint8Array;
+export declare const decodeHandshake: (handshake: Uint8Array) => PeerHandshake;