bun-torrent 0.0.4-beta → 0.0.6

package/README.md

@@ -2,12 +2,10 @@
 
 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()`.
+`bun-torrent` can parse `.torrent` files and tracker-backed magnet links, 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`
@@ -15,13 +13,13 @@ It has no runtime dependencies.
 ## Installation
 
 ```bash
-bun add bun-torrent@beta
+bun add bun-torrent
 ```
 
 or:
 
 ```bash
-npm install bun-torrent@beta
+npm install bun-torrent
 ```
 
 ## Basic Usage
@@ -111,6 +109,39 @@ console.log(metadata.files);
 
 Torrent file input can be a file path, `Uint8Array`, or `ArrayBuffer`.
 
+## Magnet Links
+
+Magnet links are supported when they include at least one HTTP, HTTPS, or UDP tracker through the `tr` parameter. Metadata is fetched from peers with the `ut_metadata` extension before the normal download flow starts.
+
+```ts
+const magnet =
+    'magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567' +
+    '&dn=file.bin' +
+    '&tr=udp%3A%2F%2Ftracker.example.com%3A6969%2Fannounce';
+
+const metadata = await client.inspect({ magnet });
+
+console.log(metadata.name);
+console.log(metadata.files);
+
+const torrent = await client.download(
+    { magnet },
+    {
+        outputDirectory: './downloads',
+    },
+);
+
+await torrent.done;
+```
+
+Supported magnet fields:
+
+- `xt=urn:btih:<infoHash>`: required. Hex-encoded 40-character info hashes and base32 32-character info hashes are supported.
+- `dn`: optional display name.
+- `tr`: optional tracker URL. Multiple `tr` parameters are supported.
+
+Trackerless magnets are not supported yet because DHT peer discovery is not implemented. A magnet without `tr` currently fails during inspection with a DHT-not-implemented error.
+
 ## Download Options
 
 ```ts

package/dist/client.d.ts

@@ -22,27 +22,25 @@ export type ClientConfig = {
     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;
+type InspectInput = {
+    torrentFile: string | Uint8Array | ArrayBuffer;
+    magnet?: undefined | null;
+    meta?: null;
+} | {
+    magnet: string;
+    torrentFile?: undefined | null;
+    meta?: null;
 };
+type DownloadInput = {
+    meta: TorrentMetadata;
+} | InspectInput;
 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;
+    download(input: DownloadInput, options?: DownloadOptions): Promise<Torrent>;
+    inspect(input: InspectInput, options?: {
+        timeout?: number;
     }): Promise<TorrentMetadata>;
     private trackPeers;
 }
@@ -63,5 +61,5 @@ export type DownloadOptions = {
     trackerTimeoutMs?: number;
 };
 export type TorrentFileInput = string | Uint8Array | ArrayBuffer;
-export declare const readTorrentFile: (input: TorrentFileInput) => Promise<Uint8Array>;
+export declare const readTorrentFile: (input: unknown) => Promise<Uint8Array>;
 export { Client as TorrentClient };

package/dist/client.js

@@ -6,6 +6,9 @@ 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';
+import { defaults } from './configs/defaults';
+import { BunTorrentError } from './utils/errors';
+import { parseMagnet } from './magnet';
 export var DownloadState;
 (function (DownloadState) {
     DownloadState["PARSING"] = "parsing";
@@ -13,18 +16,6 @@ export var DownloadState;
     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;
@@ -34,7 +25,7 @@ export class Client {
     }
     async download(input, options = {}) {
         options.onChangeState?.(DownloadState.PARSING);
-        const meta = await this.inspect(input);
+        const meta = input.meta ?? (await this.inspect(input, { timeout: options.trackerTimeoutMs }));
         const downloadConfig = resolveDownloadConfig(this.config, options);
         assertValidFileSelection(meta, downloadConfig.files);
         options.onChangeState?.(DownloadState.TRACKING);
@@ -61,9 +52,15 @@ export class Client {
             speedSampleIntervalMs: downloadConfig.speedSampleIntervalMs,
         }), normalizeTorrentFileSelection(downloadConfig.files), downloadConfig.seed);
     }
-    async inspect(input) {
-        const bytes = await readTorrentFile(input.torrentFile);
-        return parseTorrent(bytes);
+    async inspect(input, options) {
+        if ('torrentFile' in input && input.torrentFile !== undefined) {
+            const bytes = await readTorrentFile(input.torrentFile);
+            return parseTorrent(bytes);
+        }
+        if ('magnet' in input && input.magnet !== undefined && input.magnet !== null) {
+            return parseMagnet(input.magnet, this.peerId, options);
+        }
+        throw new BunTorrentError('No input provided', 'NO_INPUT');
     }
     async trackPeers(meta, options, config) {
         try {
@@ -89,27 +86,21 @@ 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,
+        defaults.download.maxInFlightRequestsPerPeer,
+    maxConnecting: options.maxConnecting ?? config.maxConnecting ?? defaults.peers.maxConnecting,
+    minConnections: options.minConnections ?? config.minConnections ?? defaults.peers.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,
+        defaults.peers.connectTimeoutMs,
+    progressEvents: options.progressEvents ?? config.progressEvents ?? defaults.progress.events,
+    requestTimeoutMs: options.requestTimeoutMs ?? config.requestTimeoutMs ?? defaults.download.requestTimeoutMs,
+    seed: options.seed ?? config.seed ?? defaults.download.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,
+        defaults.progress.speedSampleIntervalMs,
+    targetConnections: options.targetConnections ?? config.targetConnections ?? defaults.peers.targetConnections,
+    trackerTimeoutMs: options.trackerTimeoutMs ?? config.trackerTimeoutMs ?? defaults.trackers.timeoutMs,
 });
 const assertValidFileSelection = (metadata, files) => {
     const unknownFiles = getUnknownSelectedFiles(metadata, files);

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/configs/defaults.d.ts

@@ -0,0 +1,29 @@
+export declare const defaults: {
+    readonly pieces: {
+        readonly blockSize: number;
+    };
+    readonly peers: {
+        readonly targetConnections: 20;
+        readonly minConnections: 0;
+        readonly maxConnecting: 30;
+        readonly connectTimeoutMs: 5000;
+    };
+    readonly download: {
+        readonly maxInFlightRequestsPerPeer: 300;
+        readonly baseInFlightRequestsPerPeer: 8;
+        readonly requestTimeoutMs: 15000;
+        readonly seed: false;
+    };
+    readonly progress: {
+        readonly events: "piece";
+        readonly speedSampleIntervalMs: 500;
+    };
+    readonly trackers: {
+        readonly announcePort: 6881;
+        readonly timeoutMs: 5000;
+    };
+    readonly magnet: {
+        readonly trackerTimeoutMs: 3000;
+        readonly peerTimeoutMs: 5000;
+    };
+};

package/dist/configs/defaults.js

@@ -0,0 +1,30 @@
+export const defaults = {
+    pieces: {
+        blockSize: 16 * 1024,
+    },
+    peers: {
+        targetConnections: 20,
+        minConnections: 0,
+        maxConnecting: 30,
+        connectTimeoutMs: 5_000,
+    },
+    download: {
+        maxInFlightRequestsPerPeer: 300,
+        baseInFlightRequestsPerPeer: 8,
+        requestTimeoutMs: 15_000,
+        seed: false,
+    },
+    progress: {
+        events: 'piece',
+        speedSampleIntervalMs: 500,
+    },
+    trackers: {
+        announcePort: 6881,
+        timeoutMs: 5_000,
+    },
+    magnet: {
+        trackerTimeoutMs: 3_000,
+        peerTimeoutMs: 5_000,
+    },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/configs/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/configs/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,MAAM,EAAE;QACJ,SAAS,EAAE,EAAE,GAAG,IAAI;KACvB;IACD,KAAK,EAAE;QACH,iBAAiB,EAAE,EAAE;QACrB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,KAAK;KAC1B;IACD,QAAQ,EAAE;QACN,0BAA0B,EAAE,GAAG;QAC/B,2BAA2B,EAAE,CAAC;QAC9B,gBAAgB,EAAE,MAAM;QACxB,IAAI,EAAE,KAAK;KACd;IACD,QAAQ,EAAE;QACN,MAAM,EAAE,OAAO;QACf,qBAAqB,EAAE,GAAG;KAC7B;IACD,QAAQ,EAAE;QACN,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,KAAK;KACnB;IACD,MAAM,EAAE;QACJ,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,KAAK;KACvB;CACK,CAAC"}

package/dist/index.d.ts

@@ -2,10 +2,11 @@
  * Copyright (c) 2026 Nikola Nedeljkovic
  * SPDX-License-Identifier: MIT
  */
-export { Client, DEFAULT_CLIENT_CONFIG, DownloadState, TorrentClient } from './client';
+export { Client, 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 { MagnetParseError, MagnetParseErrorCode, Base32DecoderError, Base32DecoderErrorCode, } from './magnet';
 export { PeerPoolError, PeerPoolErrorCode, PeerSessionError, PeerSessionErrorCode } from './peer';
 export { TrackerError, TrackerErrorCode } from './tracker';
 export type { DownloadProgress, DownloadProgressEventMode, TorrentFileSelection, TorrentFiles, TorrentMetadata, TorrentStats, TorrentStateChange, } from './torrent/index';

package/dist/index.js

@@ -2,9 +2,10 @@
  * Copyright (c) 2026 Nikola Nedeljkovic
  * SPDX-License-Identifier: MIT
  */
-export { Client, DEFAULT_CLIENT_CONFIG, DownloadState, TorrentClient } from './client';
+export { Client, DownloadState, TorrentClient } from './client';
 export { ClientError, ClientErrorCode } from './client.error';
 export { Torrent, TorrentState, TorrentParseError, TorrentParseErrorCode, TorrentStorageError, TorrentStorageErrorCode, PiecePlannerError, PiecePlannerErrorCode, } from './torrent/index';
+export { MagnetParseError, MagnetParseErrorCode, Base32DecoderError, Base32DecoderErrorCode, } from './magnet';
 export { PeerPoolError, PeerPoolErrorCode, PeerSessionError, PeerSessionErrorCode } from './peer';
 export { TrackerError, TrackerErrorCode } from './tracker';
 export { BunTorrentError } from './utils/errors';

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAChE,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,EACH,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACzB,MAAM,UAAU,CAAC;AAElB,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/magnet/base32/errors.d.ts

@@ -0,0 +1,8 @@
+import { BunTorrentError } from '../../utils/errors';
+export declare enum Base32DecoderErrorCode {
+    INVALID_CHAR = "INVALID_BASE32_CHAR"
+}
+export declare class Base32DecoderError extends BunTorrentError {
+    readonly field?: string | undefined;
+    constructor(code: Base32DecoderErrorCode, message: string, field?: string | undefined);
+}

package/dist/magnet/base32/errors.js

@@ -0,0 +1,13 @@
+import { BunTorrentError } from '../../utils/errors';
+export var Base32DecoderErrorCode;
+(function (Base32DecoderErrorCode) {
+    Base32DecoderErrorCode["INVALID_CHAR"] = "INVALID_BASE32_CHAR";
+})(Base32DecoderErrorCode || (Base32DecoderErrorCode = {}));
+export class Base32DecoderError extends BunTorrentError {
+    field;
+    constructor(code, message, field) {
+        super(message, code);
+        this.field = field;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+import { Base32DecoderError, Base32DecoderErrorCode } from './errors';
+export declare const decodeBase32: (str: string) => Uint8Array;
+export { Base32DecoderError, Base32DecoderErrorCode };

package/dist/magnet/base32/index.js

@@ -0,0 +1,24 @@
+import { Base32DecoderError, Base32DecoderErrorCode } from './errors';
+const BASE32_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+export const decodeBase32 = (str) => {
+    const base32 = str.toUpperCase().replace(/=+$/, '');
+    let bits = 0;
+    let value = 0;
+    let index = 0;
+    const output = new Uint8Array(Math.floor((base32.length * 5) / 8));
+    for (const char of base32) {
+        const charIndex = BASE32_ALPHABET.indexOf(char);
+        if (charIndex === -1) {
+            throw new Base32DecoderError(Base32DecoderErrorCode.INVALID_CHAR, `Invalid base32 character: ${char}`);
+        }
+        value = (value << 5) | charIndex;
+        bits += 5;
+        if (bits >= 8) {
+            output[index++] = (value >> (bits - 8)) & 0xff;
+            bits -= 8;
+        }
+    }
+    return output;
+};
+export { Base32DecoderError, Base32DecoderErrorCode };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/magnet/base32/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEtE,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAE3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAc,EAAE;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnE,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CACxB,sBAAsB,CAAC,YAAY,EACnC,6BAA6B,IAAI,EAAE,CACtC,CAAC;QACN,CAAC;QAED,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;QACjC,IAAI,IAAI,CAAC,CAAC;QAEV,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAC/C,IAAI,IAAI,CAAC,CAAC;QACd,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/magnet/index.d.ts

@@ -0,0 +1,2 @@
+export { decodeBase32, Base32DecoderError, Base32DecoderErrorCode } from './base32';
+export { parseMagnet, MagnetParseError, MagnetParseErrorCode } from './parser';

package/dist/magnet/index.js

@@ -0,0 +1,3 @@
+export { decodeBase32, Base32DecoderError, Base32DecoderErrorCode } from './base32';
+export { parseMagnet, MagnetParseError, MagnetParseErrorCode } from './parser';
+//# sourceMappingURL=index.js.map

package/dist/magnet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/magnet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,12 @@
+import { BunTorrentError } from '../../utils/errors';
+export declare enum MagnetParseErrorCode {
+    INVALID_URI = "INVALID_MAGNET_URI",
+    INVALID_XT = "INVALID_XT_PARAM",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    NO_METADATA = "NO_METADATA",
+    PARSING_FAILED = "METADATA_FAILED_TO_PARSE"
+}
+export declare class MagnetParseError extends BunTorrentError {
+    readonly field?: string | undefined;
+    constructor(code: MagnetParseErrorCode, message: string, field?: string | undefined);
+}

package/dist/magnet/parser/errors.js

@@ -0,0 +1,17 @@
+import { BunTorrentError } from '../../utils/errors';
+export var MagnetParseErrorCode;
+(function (MagnetParseErrorCode) {
+    MagnetParseErrorCode["INVALID_URI"] = "INVALID_MAGNET_URI";
+    MagnetParseErrorCode["INVALID_XT"] = "INVALID_XT_PARAM";
+    MagnetParseErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    MagnetParseErrorCode["NO_METADATA"] = "NO_METADATA";
+    MagnetParseErrorCode["PARSING_FAILED"] = "METADATA_FAILED_TO_PARSE";
+})(MagnetParseErrorCode || (MagnetParseErrorCode = {}));
+export class MagnetParseError extends BunTorrentError {
+    field;
+    constructor(code, message, field) {
+        super(message, code);
+        this.field = field;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +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;IAHpB,YACI,IAA0B,EAC1B,OAAe,EACC,KAAc;QAE9B,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAFL,UAAK,GAAL,KAAK,CAAS;IAGlC,CAAC;CACJ"}

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

@@ -0,0 +1,8 @@
+import { type TorrentMetadata } from '../../torrent';
+import { MagnetParseError, MagnetParseErrorCode } from './errors';
+import type { ParsedMagnetURI } from './types';
+export declare const parseMagnet: (magnet: string, peerId: Uint8Array, options?: {
+    timeout?: number;
+}) => Promise<TorrentMetadata>;
+export declare const parseMagnetURI: (uri: string) => ParsedMagnetURI;
+export { MagnetParseError, MagnetParseErrorCode };

package/dist/magnet/parser/index.js

@@ -0,0 +1,74 @@
+import { defaults } from '../../configs/defaults';
+import { fetchMetadataFromPeer } from '../../peer/extended';
+import {} from '../../torrent';
+import { trackPeers } from '../../tracker';
+import { decodeBase32 } from '../base32';
+import { MagnetParseError, MagnetParseErrorCode } from './errors';
+import { parseInfoDict } from './meta';
+export const parseMagnet = async (magnet, peerId, options) => {
+    const data = parseMagnetURI(magnet);
+    if (data.trackers.length <= 0) {
+        throw new MagnetParseError(MagnetParseErrorCode.NOT_IMPLEMENTED, 'No trackers found, DHT is not yet implemented');
+    }
+    const peers = await trackPeers({
+        meta: {
+            infoHash: data.infoHash,
+            length: 0,
+            announce: undefined,
+            announceList: data.trackers.map((t) => [t]),
+        },
+        peerId: peerId,
+        timeoutMs: defaults.magnet.trackerTimeoutMs,
+    });
+    let raw;
+    try {
+        raw = await Promise.any(peers.map((p) => fetchMetadataFromPeer(p, data.infoHash, peerId, {
+            timeoutMs: options?.timeout ?? defaults.magnet.peerTimeoutMs,
+        })));
+    }
+    catch {
+        throw new MagnetParseError(MagnetParseErrorCode.NO_METADATA, 'Failed to fetch metadata from any peer');
+    }
+    try {
+        return parseInfoDict(raw, data.infoHash, undefined, data.trackers.map((t) => [t]));
+    }
+    catch {
+        throw new MagnetParseError(MagnetParseErrorCode.PARSING_FAILED, 'Failed to parse metadata from peer');
+    }
+};
+export const parseMagnetURI = (uri) => {
+    let url;
+    try {
+        url = new URL(uri);
+    }
+    catch {
+        throw new MagnetParseError(MagnetParseErrorCode.INVALID_URI, 'Invalid magnet URI');
+    }
+    if (url.protocol !== 'magnet:') {
+        throw new MagnetParseError(MagnetParseErrorCode.INVALID_URI, 'Invalid magnet URI scheme');
+    }
+    const params = new URLSearchParams(url.search);
+    const xt = params.get('xt');
+    const name = params.get('dn') ?? undefined;
+    const trackers = params.getAll('tr');
+    if (!xt?.startsWith('urn:btih:'))
+        throw new MagnetParseError(MagnetParseErrorCode.INVALID_XT, 'Invalid xt parameter');
+    const raw = xt.slice(9);
+    if (raw.length !== 40 && raw.length !== 32) {
+        throw new MagnetParseError(MagnetParseErrorCode.INVALID_XT, 'Invalid info hash length');
+    }
+    if (raw.length === 40 && !isHex(raw)) {
+        throw new MagnetParseError(MagnetParseErrorCode.INVALID_XT, 'Invalid hex info hash');
+    }
+    return {
+        infoHash: raw.length === 40 ? Uint8Array.fromHex(raw) : decodeBase32(raw),
+        name,
+        trackers,
+    };
+};
+const isHex = (str) => {
+    const hexRegex = /^[0-9a-fA-F]+$/;
+    return hexRegex.test(str) && str.length === 40;
+};
+export { MagnetParseError, MagnetParseErrorCode };
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { TorrentMetadata } from '../../torrent';
+export declare const parseInfoDict: (dict: unknown, infoHash: Uint8Array, announce?: string, announceList?: string[][]) => TorrentMetadata;

package/dist/magnet/parser/meta.js

@@ -0,0 +1,68 @@
+const textDecoder = new TextDecoder();
+export const parseInfoDict = (dict, infoHash, announce, announceList = []) => {
+    if (!(dict instanceof Map))
+        throw new Error('Info dict must be a Map');
+    const name = dict.get('name');
+    if (!(name instanceof Uint8Array))
+        throw new Error('Missing name');
+    const pieceLength = dict.get('piece length');
+    if (typeof pieceLength !== 'number')
+        throw new Error('Missing piece length');
+    const piecesRaw = dict.get('pieces');
+    if (!(piecesRaw instanceof Uint8Array) || piecesRaw.byteLength % 20 !== 0)
+        throw new Error('Invalid pieces');
+    const pieces = [];
+    for (let i = 0; i < piecesRaw.byteLength; i += 20) {
+        pieces.push(piecesRaw.subarray(i, i + 20));
+    }
+    const filesRaw = dict.get('files');
+    if (Array.isArray(filesRaw)) {
+        let offset = 0;
+        const files = filesRaw.map((f) => {
+            if (!(f instanceof Map))
+                throw new Error('Invalid file entry');
+            const length = f.get('length');
+            if (typeof length !== 'number')
+                throw new Error('Missing file length');
+            const path = f.get('path');
+            if (!Array.isArray(path))
+                throw new Error('Missing file path');
+            const file = {
+                path: path.map((p) => {
+                    if (!(p instanceof Uint8Array))
+                        throw new Error('Invalid path segment');
+                    return textDecoder.decode(p);
+                }),
+                length,
+                offset,
+            };
+            offset += length;
+            return file;
+        });
+        return {
+            announce,
+            announceList,
+            infoHash,
+            name: textDecoder.decode(name),
+            pieceLength,
+            pieces,
+            length: offset,
+            files,
+        };
+    }
+    // single-file
+    const length = dict.get('length');
+    if (typeof length !== 'number')
+        throw new Error('Missing length');
+    return {
+        announce,
+        announceList,
+        infoHash,
+        name: textDecoder.decode(name),
+        pieceLength,
+        pieces,
+        length,
+        files: [{ path: [textDecoder.decode(name)], length, offset: 0 }],
+    };
+};
+//# sourceMappingURL=meta.js.map

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

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

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

@@ -0,0 +1,5 @@
+export type ParsedMagnetURI = {
+    infoHash: Uint8Array;
+    name?: string;
+    trackers: string[];
+};

package/dist/magnet/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/magnet/parser/types.ts"],"names":[],"mappings":""}