@lightbird/core 0.1.6 → 0.3.0

package/dist/index.cjs

@@ -1,6 +1,8 @@
 'use strict';
 
 var assCompiler = require('ass-compiler');
+var webSdk = require('@openfeature/web-sdk');
+var unleashWebProvider = require('@openfeature/unleash-web-provider');
 var ffmpeg = require('@ffmpeg/ffmpeg');
 var util = require('@ffmpeg/util');
 
@@ -1104,6 +1106,132 @@ function parseM3U8(text) {
   return items;
 }
 
+// src/magnet-player.ts
+var VIDEO_EXTENSIONS = [
+  "mp4",
+  "mkv",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  "m4v",
+  "ts",
+  "m2ts",
+  "ogv",
+  "ogg",
+  "divx",
+  "xvid",
+  "rmvb",
+  "rm"
+];
+var DEFAULT_TRACKERS = [
+  "wss://tracker.openwebtorrent.com",
+  "wss://tracker.btorrent.xyz",
+  "wss://tracker.fastcast.nz"
+];
+var DISCLAIMER_KEY = "lightbird_magnet_disclaimer_accepted";
+function isMagnetUri(str) {
+  if (typeof str !== "string" || !str.trim()) return false;
+  return /^magnet:\?xt=urn:(btih:([a-f0-9]{40}|[a-z2-7]{32})|btmh:[a-z0-9]{20,})/i.test(str.trim());
+}
+function isVideoFile(name) {
+  if (typeof name !== "string" || !name) return false;
+  const ext = name.split(".").pop()?.toLowerCase() ?? "";
+  return VIDEO_EXTENSIONS.includes(ext);
+}
+function getVideoFiles(torrent) {
+  return [...torrent.files].filter((f) => isVideoFile(f.name)).sort((a, b) => a.path.localeCompare(b.path));
+}
+function hasAcceptedDisclaimer() {
+  try {
+    return localStorage.getItem(DISCLAIMER_KEY) === "true";
+  } catch {
+    return false;
+  }
+}
+function acceptDisclaimer() {
+  try {
+    localStorage.setItem(DISCLAIMER_KEY, "true");
+  } catch {
+  }
+}
+var wtClient = null;
+var wtClientPromise = null;
+var swPromise = null;
+async function ensureServiceWorker() {
+  if (swPromise) return swPromise;
+  swPromise = (async () => {
+    if (!("serviceWorker" in navigator)) {
+      throw new Error("Service workers are not supported in this browser");
+    }
+    const existing = await navigator.serviceWorker.getRegistration("/webtorrent-sw.js");
+    if (existing?.active) return existing;
+    const reg = await navigator.serviceWorker.register("/webtorrent-sw.js", {
+      scope: "/"
+    });
+    if (reg.active) return reg;
+    return new Promise((resolve, reject) => {
+      const sw = reg.installing ?? reg.waiting;
+      if (!sw) {
+        if (reg.active) return resolve(reg);
+        return reject(new Error("No service worker found after registration"));
+      }
+      const onStateChange = () => {
+        if (sw.state === "activated") {
+          sw.removeEventListener("statechange", onStateChange);
+          resolve(reg);
+        } else if (sw.state === "redundant") {
+          sw.removeEventListener("statechange", onStateChange);
+          reject(new Error("Service worker became redundant during activation"));
+        }
+      };
+      sw.addEventListener("statechange", onStateChange);
+    });
+  })();
+  return swPromise;
+}
+async function getWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) return wtClient;
+  if (wtClientPromise) return wtClientPromise;
+  wtClientPromise = (async () => {
+    const { default: WebTorrentClass } = await import('webtorrent');
+    const client = new WebTorrentClass();
+    wtClient = client;
+    try {
+      const registration = await ensureServiceWorker();
+      if (!client._server) {
+        client.createServer({ controller: registration });
+      }
+    } catch (err) {
+      console.warn("[magnet-player] Service worker setup failed:", err);
+    }
+    return client;
+  })();
+  return wtClientPromise;
+}
+function destroyWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) {
+    wtClient.destroy();
+  }
+  wtClient = null;
+  wtClientPromise = null;
+}
+var FLAG_MAGNET_LINK = "magnet-link-enabled";
+function initFeatureFlags() {
+  const url = process.env.NEXT_PUBLIC_UNLEASH_URL ?? "";
+  const clientKey = process.env.NEXT_PUBLIC_UNLEASH_CLIENT_KEY ?? "";
+  if (!url || !clientKey) {
+    console.warn(
+      "[feature-flags] NEXT_PUBLIC_UNLEASH_URL and/or NEXT_PUBLIC_UNLEASH_CLIENT_KEY are not set \u2014 feature flags will use their default values (magnet link enabled by default)."
+    );
+    return Promise.resolve();
+  }
+  return webSdk.OpenFeature.setProviderAndWait(
+    new unleashWebProvider.UnleashWebProvider({ url, clientKey, appName: "lightbird" })
+  );
+}
+
 // src/utils/media-error.ts
 var MEDIA_ERR_ABORTED = 1;
 var MEDIA_ERR_NETWORK = 2;
@@ -1331,21 +1459,33 @@ function resetFFmpeg() {
 exports.ASSRenderer = ASSRenderer;
 exports.CancellationError = CancellationError;
 exports.DEFAULT_SHORTCUTS = DEFAULT_SHORTCUTS;
+exports.DEFAULT_TRACKERS = DEFAULT_TRACKERS;
+exports.DISCLAIMER_KEY = DISCLAIMER_KEY;
+exports.FLAG_MAGNET_LINK = FLAG_MAGNET_LINK;
 exports.MKVPlayer = MKVPlayer;
 exports.ProgressEstimator = ProgressEstimator;
 exports.SimplePlayer = SimplePlayer;
 exports.SubtitleConverter = SubtitleConverter;
 exports.UniversalSubtitleManager = UniversalSubtitleManager;
+exports.VIDEO_EXTENSIONS = VIDEO_EXTENSIONS;
+exports.acceptDisclaimer = acceptDisclaimer;
 exports.applyOffsetToVtt = applyOffsetToVtt;
 exports.captureVideoThumbnail = captureVideoThumbnail;
 exports.configureLightBird = configureLightBird;
 exports.createOffsetVttUrl = createOffsetVttUrl;
 exports.createVideoPlayer = createVideoPlayer;
+exports.destroyWebTorrentClient = destroyWebTorrentClient;
 exports.exportPlaylist = exportPlaylist;
 exports.extractNativeMetadata = extractNativeMetadata;
 exports.formatShortcutKey = formatShortcutKey;
 exports.getFFmpeg = getFFmpeg;
+exports.getVideoFiles = getVideoFiles;
+exports.getWebTorrentClient = getWebTorrentClient;
+exports.hasAcceptedDisclaimer = hasAcceptedDisclaimer;
+exports.initFeatureFlags = initFeatureFlags;
 exports.isInteractiveElement = isInteractiveElement;
+exports.isMagnetUri = isMagnetUri;
+exports.isVideoFile = isVideoFile;
 exports.loadShortcuts = loadShortcuts;
 exports.matchesShortcut = matchesShortcut;
 exports.parseChaptersFromFFmpegLog = parseChaptersFromFFmpegLog;

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import WebTorrent from 'webtorrent';
 import { FFmpeg } from '@ffmpeg/ffmpeg';
 
 interface LightBirdConfig {
@@ -16,9 +17,20 @@ interface PlaylistItem {
     name: string;
     url: string;
     type: 'video' | 'stream';
+    /** Set only on items added via magnet link. */
+    source?: 'torrent';
     file?: File;
     duration?: number;
 }
+interface TorrentStatus {
+    status: 'idle' | 'loading-metadata' | 'ready' | 'error';
+    torrentName: string;
+    numPeers: number;
+    downloadSpeed: number;
+    uploadSpeed: number;
+    progress: number;
+    error: string | null;
+}
 interface SubtitleCue {
     startTime: number;
     endTime: number;
@@ -252,6 +264,65 @@ declare function exportPlaylist(items: PlaylistItem[]): void;
 /** Parse an M3U / M3U8 text file into playlist item descriptors (without id). */
 declare function parseM3U8(text: string): Omit<PlaylistItem, "id">[];
 
+declare const VIDEO_EXTENSIONS: string[];
+declare const DEFAULT_TRACKERS: string[];
+declare const DISCLAIMER_KEY = "lightbird_magnet_disclaimer_accepted";
+/**
+ * Returns true if the given string is a valid magnet URI.
+ */
+declare function isMagnetUri(str: unknown): boolean;
+/**
+ * Returns true if the filename has a recognised video extension.
+ */
+declare function isVideoFile(name: unknown): boolean;
+/**
+ * Filters and returns all video files from a torrent, sorted by path.
+ */
+declare function getVideoFiles(torrent: {
+    files: Array<{
+        name: string;
+        path: string;
+        length: number;
+    }>;
+}): Array<{
+    name: string;
+    path: string;
+    length: number;
+}>;
+/**
+ * Returns true if the user has already accepted the magnet disclaimer.
+ */
+declare function hasAcceptedDisclaimer(): boolean;
+/**
+ * Persists the user's acceptance of the magnet disclaimer.
+ */
+declare function acceptDisclaimer(): void;
+/**
+ * Returns the lazy singleton WebTorrent client, creating it if necessary.
+ * Sets up the local streaming server backed by the service worker.
+ */
+declare function getWebTorrentClient(): Promise<InstanceType<typeof WebTorrent>>;
+/**
+ * Destroys the WebTorrent client singleton (call on component unmount).
+ */
+declare function destroyWebTorrentClient(): void;
+
+/**
+ * Feature flag keys — use these constants everywhere instead of raw strings.
+ */
+declare const FLAG_MAGNET_LINK = "magnet-link-enabled";
+/**
+ * Initialise the OpenFeature SDK with the Unleash Frontend API provider.
+ * Returns a promise that resolves once Unleash has fetched the initial flag
+ * state. Each `useBooleanFlagValue` call supplies its own default, used while
+ * the provider is loading or when no provider is configured.
+ *
+ * Requires the following environment variables (set in .env.local or Vercel):
+ *   NEXT_PUBLIC_UNLEASH_URL        — Frontend API URL
+ *   NEXT_PUBLIC_UNLEASH_CLIENT_KEY — Frontend API token
+ */
+declare function initFeatureFlags(): Promise<void>;
+
 type MediaErrorType = 'aborted' | 'network' | 'decode' | 'unsupported' | 'unknown';
 interface ParsedMediaError {
     type: MediaErrorType;
@@ -314,4 +385,4 @@ declare class ProgressEstimator {
 declare function getFFmpeg(): Promise<FFmpeg>;
 declare function resetFFmpeg(): void;
 
-export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, UniversalSubtitleManager, type VideoFilters, type VideoMetadata, type VideoPlayer, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, isInteractiveElement, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import WebTorrent from 'webtorrent';
 import { FFmpeg } from '@ffmpeg/ffmpeg';
 
 interface LightBirdConfig {
@@ -16,9 +17,20 @@ interface PlaylistItem {
     name: string;
     url: string;
     type: 'video' | 'stream';
+    /** Set only on items added via magnet link. */
+    source?: 'torrent';
     file?: File;
     duration?: number;
 }
+interface TorrentStatus {
+    status: 'idle' | 'loading-metadata' | 'ready' | 'error';
+    torrentName: string;
+    numPeers: number;
+    downloadSpeed: number;
+    uploadSpeed: number;
+    progress: number;
+    error: string | null;
+}
 interface SubtitleCue {
     startTime: number;
     endTime: number;
@@ -252,6 +264,65 @@ declare function exportPlaylist(items: PlaylistItem[]): void;
 /** Parse an M3U / M3U8 text file into playlist item descriptors (without id). */
 declare function parseM3U8(text: string): Omit<PlaylistItem, "id">[];
 
+declare const VIDEO_EXTENSIONS: string[];
+declare const DEFAULT_TRACKERS: string[];
+declare const DISCLAIMER_KEY = "lightbird_magnet_disclaimer_accepted";
+/**
+ * Returns true if the given string is a valid magnet URI.
+ */
+declare function isMagnetUri(str: unknown): boolean;
+/**
+ * Returns true if the filename has a recognised video extension.
+ */
+declare function isVideoFile(name: unknown): boolean;
+/**
+ * Filters and returns all video files from a torrent, sorted by path.
+ */
+declare function getVideoFiles(torrent: {
+    files: Array<{
+        name: string;
+        path: string;
+        length: number;
+    }>;
+}): Array<{
+    name: string;
+    path: string;
+    length: number;
+}>;
+/**
+ * Returns true if the user has already accepted the magnet disclaimer.
+ */
+declare function hasAcceptedDisclaimer(): boolean;
+/**
+ * Persists the user's acceptance of the magnet disclaimer.
+ */
+declare function acceptDisclaimer(): void;
+/**
+ * Returns the lazy singleton WebTorrent client, creating it if necessary.
+ * Sets up the local streaming server backed by the service worker.
+ */
+declare function getWebTorrentClient(): Promise<InstanceType<typeof WebTorrent>>;
+/**
+ * Destroys the WebTorrent client singleton (call on component unmount).
+ */
+declare function destroyWebTorrentClient(): void;
+
+/**
+ * Feature flag keys — use these constants everywhere instead of raw strings.
+ */
+declare const FLAG_MAGNET_LINK = "magnet-link-enabled";
+/**
+ * Initialise the OpenFeature SDK with the Unleash Frontend API provider.
+ * Returns a promise that resolves once Unleash has fetched the initial flag
+ * state. Each `useBooleanFlagValue` call supplies its own default, used while
+ * the provider is loading or when no provider is configured.
+ *
+ * Requires the following environment variables (set in .env.local or Vercel):
+ *   NEXT_PUBLIC_UNLEASH_URL        — Frontend API URL
+ *   NEXT_PUBLIC_UNLEASH_CLIENT_KEY — Frontend API token
+ */
+declare function initFeatureFlags(): Promise<void>;
+
 type MediaErrorType = 'aborted' | 'network' | 'decode' | 'unsupported' | 'unknown';
 interface ParsedMediaError {
     type: MediaErrorType;
@@ -314,4 +385,4 @@ declare class ProgressEstimator {
 declare function getFFmpeg(): Promise<FFmpeg>;
 declare function resetFFmpeg(): void;
 
-export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, UniversalSubtitleManager, type VideoFilters, type VideoMetadata, type VideoPlayer, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, isInteractiveElement, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+export { ASSRenderer, type AudioTrack, type AudioTrackMeta, CancellationError, type Chapter, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, type LightBirdConfig, MKVPlayer, type MKVPlayerFile, type MediaErrorType, type ParsedMediaError, type PlaylistItem, type ProcessedFile, ProgressEstimator, type ShortcutAction, type ShortcutBinding, SimplePlayer, type SimplePlayerFile, type Subtitle, SubtitleConverter, type SubtitleCue, type SubtitleTrackMeta, type TorrentStatus, UniversalSubtitleManager, VIDEO_EXTENSIONS, type VideoFilters, type VideoMetadata, type VideoPlayer, acceptDisclaimer, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/index.js

@@ -1,4 +1,6 @@
 import { compile } from 'ass-compiler';
+import { OpenFeature } from '@openfeature/web-sdk';
+import { UnleashWebProvider } from '@openfeature/unleash-web-provider';
 import { FFmpeg } from '@ffmpeg/ffmpeg';
 import { toBlobURL } from '@ffmpeg/util';
 
@@ -1101,6 +1103,132 @@ function parseM3U8(text) {
   return items;
 }
 
+// src/magnet-player.ts
+var VIDEO_EXTENSIONS = [
+  "mp4",
+  "mkv",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  "m4v",
+  "ts",
+  "m2ts",
+  "ogv",
+  "ogg",
+  "divx",
+  "xvid",
+  "rmvb",
+  "rm"
+];
+var DEFAULT_TRACKERS = [
+  "wss://tracker.openwebtorrent.com",
+  "wss://tracker.btorrent.xyz",
+  "wss://tracker.fastcast.nz"
+];
+var DISCLAIMER_KEY = "lightbird_magnet_disclaimer_accepted";
+function isMagnetUri(str) {
+  if (typeof str !== "string" || !str.trim()) return false;
+  return /^magnet:\?xt=urn:(btih:([a-f0-9]{40}|[a-z2-7]{32})|btmh:[a-z0-9]{20,})/i.test(str.trim());
+}
+function isVideoFile(name) {
+  if (typeof name !== "string" || !name) return false;
+  const ext = name.split(".").pop()?.toLowerCase() ?? "";
+  return VIDEO_EXTENSIONS.includes(ext);
+}
+function getVideoFiles(torrent) {
+  return [...torrent.files].filter((f) => isVideoFile(f.name)).sort((a, b) => a.path.localeCompare(b.path));
+}
+function hasAcceptedDisclaimer() {
+  try {
+    return localStorage.getItem(DISCLAIMER_KEY) === "true";
+  } catch {
+    return false;
+  }
+}
+function acceptDisclaimer() {
+  try {
+    localStorage.setItem(DISCLAIMER_KEY, "true");
+  } catch {
+  }
+}
+var wtClient = null;
+var wtClientPromise = null;
+var swPromise = null;
+async function ensureServiceWorker() {
+  if (swPromise) return swPromise;
+  swPromise = (async () => {
+    if (!("serviceWorker" in navigator)) {
+      throw new Error("Service workers are not supported in this browser");
+    }
+    const existing = await navigator.serviceWorker.getRegistration("/webtorrent-sw.js");
+    if (existing?.active) return existing;
+    const reg = await navigator.serviceWorker.register("/webtorrent-sw.js", {
+      scope: "/"
+    });
+    if (reg.active) return reg;
+    return new Promise((resolve, reject) => {
+      const sw = reg.installing ?? reg.waiting;
+      if (!sw) {
+        if (reg.active) return resolve(reg);
+        return reject(new Error("No service worker found after registration"));
+      }
+      const onStateChange = () => {
+        if (sw.state === "activated") {
+          sw.removeEventListener("statechange", onStateChange);
+          resolve(reg);
+        } else if (sw.state === "redundant") {
+          sw.removeEventListener("statechange", onStateChange);
+          reject(new Error("Service worker became redundant during activation"));
+        }
+      };
+      sw.addEventListener("statechange", onStateChange);
+    });
+  })();
+  return swPromise;
+}
+async function getWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) return wtClient;
+  if (wtClientPromise) return wtClientPromise;
+  wtClientPromise = (async () => {
+    const { default: WebTorrentClass } = await import('webtorrent');
+    const client = new WebTorrentClass();
+    wtClient = client;
+    try {
+      const registration = await ensureServiceWorker();
+      if (!client._server) {
+        client.createServer({ controller: registration });
+      }
+    } catch (err) {
+      console.warn("[magnet-player] Service worker setup failed:", err);
+    }
+    return client;
+  })();
+  return wtClientPromise;
+}
+function destroyWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) {
+    wtClient.destroy();
+  }
+  wtClient = null;
+  wtClientPromise = null;
+}
+var FLAG_MAGNET_LINK = "magnet-link-enabled";
+function initFeatureFlags() {
+  const url = process.env.NEXT_PUBLIC_UNLEASH_URL ?? "";
+  const clientKey = process.env.NEXT_PUBLIC_UNLEASH_CLIENT_KEY ?? "";
+  if (!url || !clientKey) {
+    console.warn(
+      "[feature-flags] NEXT_PUBLIC_UNLEASH_URL and/or NEXT_PUBLIC_UNLEASH_CLIENT_KEY are not set \u2014 feature flags will use their default values (magnet link enabled by default)."
+    );
+    return Promise.resolve();
+  }
+  return OpenFeature.setProviderAndWait(
+    new UnleashWebProvider({ url, clientKey, appName: "lightbird" })
+  );
+}
+
 // src/utils/media-error.ts
 var MEDIA_ERR_ABORTED = 1;
 var MEDIA_ERR_NETWORK = 2;
@@ -1325,4 +1453,4 @@ function resetFFmpeg() {
   loading = null;
 }
 
-export { ASSRenderer, CancellationError, DEFAULT_SHORTCUTS, MKVPlayer, ProgressEstimator, SimplePlayer, SubtitleConverter, UniversalSubtitleManager, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, isInteractiveElement, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };
+export { ASSRenderer, CancellationError, DEFAULT_SHORTCUTS, DEFAULT_TRACKERS, DISCLAIMER_KEY, FLAG_MAGNET_LINK, MKVPlayer, ProgressEstimator, SimplePlayer, SubtitleConverter, UniversalSubtitleManager, VIDEO_EXTENSIONS, acceptDisclaimer, applyOffsetToVtt, captureVideoThumbnail, configureLightBird, createOffsetVttUrl, createVideoPlayer, destroyWebTorrentClient, exportPlaylist, extractNativeMetadata, formatShortcutKey, getFFmpeg, getVideoFiles, getWebTorrentClient, hasAcceptedDisclaimer, initFeatureFlags, isInteractiveElement, isMagnetUri, isVideoFile, loadShortcuts, matchesShortcut, parseChaptersFromFFmpegLog, parseChaptersFromVtt, parseM3U8, parseMediaError, resetFFmpeg, saveShortcuts, validateFile };

package/dist/react/index.cjs

@@ -902,9 +902,251 @@ function useChapters(videoRef, playerRef) {
   return { chapters, currentChapter, goToChapter };
 }
 
+// src/magnet-player.ts
+var VIDEO_EXTENSIONS2 = [
+  "mp4",
+  "mkv",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  "m4v",
+  "ts",
+  "m2ts",
+  "ogv",
+  "ogg",
+  "divx",
+  "xvid",
+  "rmvb",
+  "rm"
+];
+var DEFAULT_TRACKERS = [
+  "wss://tracker.openwebtorrent.com",
+  "wss://tracker.btorrent.xyz",
+  "wss://tracker.fastcast.nz"
+];
+function isMagnetUri(str) {
+  if (typeof str !== "string" || !str.trim()) return false;
+  return /^magnet:\?xt=urn:(btih:([a-f0-9]{40}|[a-z2-7]{32})|btmh:[a-z0-9]{20,})/i.test(str.trim());
+}
+function isVideoFile(name) {
+  if (typeof name !== "string" || !name) return false;
+  const ext = name.split(".").pop()?.toLowerCase() ?? "";
+  return VIDEO_EXTENSIONS2.includes(ext);
+}
+function getVideoFiles(torrent) {
+  return [...torrent.files].filter((f) => isVideoFile(f.name)).sort((a, b) => a.path.localeCompare(b.path));
+}
+var wtClient = null;
+var wtClientPromise = null;
+var swPromise = null;
+async function ensureServiceWorker() {
+  if (swPromise) return swPromise;
+  swPromise = (async () => {
+    if (!("serviceWorker" in navigator)) {
+      throw new Error("Service workers are not supported in this browser");
+    }
+    const existing = await navigator.serviceWorker.getRegistration("/webtorrent-sw.js");
+    if (existing?.active) return existing;
+    const reg = await navigator.serviceWorker.register("/webtorrent-sw.js", {
+      scope: "/"
+    });
+    if (reg.active) return reg;
+    return new Promise((resolve, reject) => {
+      const sw = reg.installing ?? reg.waiting;
+      if (!sw) {
+        if (reg.active) return resolve(reg);
+        return reject(new Error("No service worker found after registration"));
+      }
+      const onStateChange = () => {
+        if (sw.state === "activated") {
+          sw.removeEventListener("statechange", onStateChange);
+          resolve(reg);
+        } else if (sw.state === "redundant") {
+          sw.removeEventListener("statechange", onStateChange);
+          reject(new Error("Service worker became redundant during activation"));
+        }
+      };
+      sw.addEventListener("statechange", onStateChange);
+    });
+  })();
+  return swPromise;
+}
+async function getWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) return wtClient;
+  if (wtClientPromise) return wtClientPromise;
+  wtClientPromise = (async () => {
+    const { default: WebTorrentClass } = await import('webtorrent');
+    const client = new WebTorrentClass();
+    wtClient = client;
+    try {
+      const registration = await ensureServiceWorker();
+      if (!client._server) {
+        client.createServer({ controller: registration });
+      }
+    } catch (err) {
+      console.warn("[magnet-player] Service worker setup failed:", err);
+    }
+    return client;
+  })();
+  return wtClientPromise;
+}
+function destroyWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) {
+    wtClient.destroy();
+  }
+  wtClient = null;
+  wtClientPromise = null;
+}
+
+// src/react/use-magnet.ts
+var METADATA_TIMEOUT_MS = 3e4;
+var INITIAL_STATUS = {
+  status: "idle",
+  torrentName: "",
+  numPeers: 0,
+  downloadSpeed: 0,
+  uploadSpeed: 0,
+  progress: 0,
+  error: null
+};
+function useMagnet() {
+  const [torrentStatus, setTorrentStatus] = react.useState(INITIAL_STATUS);
+  const activeTorrentRef = react.useRef(null);
+  react.useEffect(() => {
+    return () => {
+      destroyWebTorrentClient();
+    };
+  }, []);
+  const destroyMagnet = react.useCallback(() => {
+    if (activeTorrentRef.current && !activeTorrentRef.current.destroyed) {
+      activeTorrentRef.current.destroy();
+    }
+    activeTorrentRef.current = null;
+    setTorrentStatus(INITIAL_STATUS);
+  }, []);
+  const addMagnet = react.useCallback(async (uri) => {
+    if (!isMagnetUri(uri)) {
+      throw new Error("Not a valid magnet link");
+    }
+    if (activeTorrentRef.current && !activeTorrentRef.current.destroyed) {
+      activeTorrentRef.current.destroy();
+    }
+    activeTorrentRef.current = null;
+    setTorrentStatus({
+      ...INITIAL_STATUS,
+      status: "loading-metadata",
+      error: null
+    });
+    let client;
+    try {
+      client = await getWebTorrentClient();
+    } catch {
+      const msg = "Could not initialise torrent client";
+      setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+      throw new Error(msg);
+    }
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      let torrent;
+      const settle = (fn) => {
+        if (settled) return;
+        settled = true;
+        fn();
+      };
+      const timeout = setTimeout(() => {
+        settle(() => {
+          torrent?.destroy?.();
+          activeTorrentRef.current = null;
+          const msg = "Could not connect to peers. Check the link and try again.";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+      }, METADATA_TIMEOUT_MS);
+      try {
+        torrent = client.add(uri.trim(), { announce: DEFAULT_TRACKERS });
+        activeTorrentRef.current = torrent;
+      } catch (err) {
+        settle(() => {
+          clearTimeout(timeout);
+          const msg = "Failed to add torrent";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+        return;
+      }
+      torrent.on("error", (err) => {
+        settle(() => {
+          clearTimeout(timeout);
+          torrent?.destroy?.();
+          activeTorrentRef.current = null;
+          const msg = err?.message ?? "Torrent error";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+      });
+      torrent.on("ready", () => {
+        clearTimeout(timeout);
+        const videoFiles = getVideoFiles(torrent);
+        const streamable = videoFiles.filter(
+          (file) => Boolean(file.streamURL)
+        );
+        if (streamable.length === 0) {
+          settle(() => {
+            torrent.destroy();
+            activeTorrentRef.current = null;
+            const msg = videoFiles.length === 0 ? "No video files found in this torrent" : "Video files in this torrent could not be made streamable";
+            setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+            reject(new Error(msg));
+          });
+          return;
+        }
+        settle(() => {
+          setTorrentStatus((s) => ({
+            ...s,
+            status: "ready",
+            torrentName: torrent.name ?? "",
+            progress: torrent.progress ?? 0
+          }));
+          const items = streamable.map((file) => ({
+            id: crypto.randomUUID(),
+            name: file.name,
+            url: file.streamURL,
+            type: "stream",
+            source: "torrent",
+            duration: void 0
+          }));
+          resolve(items);
+        });
+        torrent.on("download", () => {
+          setTorrentStatus((s) => ({
+            ...s,
+            numPeers: torrent.numPeers ?? 0,
+            downloadSpeed: torrent.downloadSpeed ?? 0,
+            uploadSpeed: torrent.uploadSpeed ?? 0,
+            progress: torrent.progress ?? 0
+          }));
+        });
+        torrent.on("done", () => {
+          setTorrentStatus((s) => ({ ...s, progress: 1 }));
+        });
+        torrent.on("wire", () => {
+          setTorrentStatus((s) => ({
+            ...s,
+            numPeers: torrent.numPeers ?? 0
+          }));
+        });
+      });
+    });
+  }, []);
+  return { torrentStatus, addMagnet, destroyMagnet };
+}
+
 exports.useChapters = useChapters;
 exports.useFullscreen = useFullscreen;
 exports.useKeyboardShortcuts = useKeyboardShortcuts;
+exports.useMagnet = useMagnet;
 exports.useMediaSession = useMediaSession;
 exports.usePictureInPicture = usePictureInPicture;
 exports.usePlaylist = usePlaylist;

package/dist/react/index.d.cts

@@ -29,9 +29,20 @@ interface PlaylistItem {
     name: string;
     url: string;
     type: 'video' | 'stream';
+    /** Set only on items added via magnet link. */
+    source?: 'torrent';
     file?: File;
     duration?: number;
 }
+interface TorrentStatus {
+    status: 'idle' | 'loading-metadata' | 'ready' | 'error';
+    torrentName: string;
+    numPeers: number;
+    downloadSpeed: number;
+    uploadSpeed: number;
+    progress: number;
+    error: string | null;
+}
 interface SubtitleCue {
     startTime: number;
     endTime: number;
@@ -249,4 +260,16 @@ declare function useChapters(videoRef: RefObject<HTMLVideoElement>, playerRef: R
     goToChapter: (index: number) => void;
 };
 
-export { type ShortcutHandlers, type UseMediaSessionOptions, type UseSubtitlesOptions, useChapters, useFullscreen, useKeyboardShortcuts, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };
+interface UseMagnetReturn {
+    torrentStatus: TorrentStatus;
+    /**
+     * Resolves with the playlist items (one per video file in the torrent).
+     * Throws an Error with a user-facing message on failure.
+     */
+    addMagnet: (uri: string) => Promise<PlaylistItem[]>;
+    /** Destroys the active torrent. */
+    destroyMagnet: () => void;
+}
+declare function useMagnet(): UseMagnetReturn;
+
+export { type ShortcutHandlers, type UseMagnetReturn, type UseMediaSessionOptions, type UseSubtitlesOptions, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };

package/dist/react/index.d.ts

@@ -29,9 +29,20 @@ interface PlaylistItem {
     name: string;
     url: string;
     type: 'video' | 'stream';
+    /** Set only on items added via magnet link. */
+    source?: 'torrent';
     file?: File;
     duration?: number;
 }
+interface TorrentStatus {
+    status: 'idle' | 'loading-metadata' | 'ready' | 'error';
+    torrentName: string;
+    numPeers: number;
+    downloadSpeed: number;
+    uploadSpeed: number;
+    progress: number;
+    error: string | null;
+}
 interface SubtitleCue {
     startTime: number;
     endTime: number;
@@ -249,4 +260,16 @@ declare function useChapters(videoRef: RefObject<HTMLVideoElement>, playerRef: R
     goToChapter: (index: number) => void;
 };
 
-export { type ShortcutHandlers, type UseMediaSessionOptions, type UseSubtitlesOptions, useChapters, useFullscreen, useKeyboardShortcuts, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };
+interface UseMagnetReturn {
+    torrentStatus: TorrentStatus;
+    /**
+     * Resolves with the playlist items (one per video file in the torrent).
+     * Throws an Error with a user-facing message on failure.
+     */
+    addMagnet: (uri: string) => Promise<PlaylistItem[]>;
+    /** Destroys the active torrent. */
+    destroyMagnet: () => void;
+}
+declare function useMagnet(): UseMagnetReturn;
+
+export { type ShortcutHandlers, type UseMagnetReturn, type UseMediaSessionOptions, type UseSubtitlesOptions, useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };

package/dist/react/index.js

@@ -900,4 +900,245 @@ function useChapters(videoRef, playerRef) {
   return { chapters, currentChapter, goToChapter };
 }
 
-export { useChapters, useFullscreen, useKeyboardShortcuts, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };
+// src/magnet-player.ts
+var VIDEO_EXTENSIONS2 = [
+  "mp4",
+  "mkv",
+  "avi",
+  "mov",
+  "wmv",
+  "flv",
+  "webm",
+  "m4v",
+  "ts",
+  "m2ts",
+  "ogv",
+  "ogg",
+  "divx",
+  "xvid",
+  "rmvb",
+  "rm"
+];
+var DEFAULT_TRACKERS = [
+  "wss://tracker.openwebtorrent.com",
+  "wss://tracker.btorrent.xyz",
+  "wss://tracker.fastcast.nz"
+];
+function isMagnetUri(str) {
+  if (typeof str !== "string" || !str.trim()) return false;
+  return /^magnet:\?xt=urn:(btih:([a-f0-9]{40}|[a-z2-7]{32})|btmh:[a-z0-9]{20,})/i.test(str.trim());
+}
+function isVideoFile(name) {
+  if (typeof name !== "string" || !name) return false;
+  const ext = name.split(".").pop()?.toLowerCase() ?? "";
+  return VIDEO_EXTENSIONS2.includes(ext);
+}
+function getVideoFiles(torrent) {
+  return [...torrent.files].filter((f) => isVideoFile(f.name)).sort((a, b) => a.path.localeCompare(b.path));
+}
+var wtClient = null;
+var wtClientPromise = null;
+var swPromise = null;
+async function ensureServiceWorker() {
+  if (swPromise) return swPromise;
+  swPromise = (async () => {
+    if (!("serviceWorker" in navigator)) {
+      throw new Error("Service workers are not supported in this browser");
+    }
+    const existing = await navigator.serviceWorker.getRegistration("/webtorrent-sw.js");
+    if (existing?.active) return existing;
+    const reg = await navigator.serviceWorker.register("/webtorrent-sw.js", {
+      scope: "/"
+    });
+    if (reg.active) return reg;
+    return new Promise((resolve, reject) => {
+      const sw = reg.installing ?? reg.waiting;
+      if (!sw) {
+        if (reg.active) return resolve(reg);
+        return reject(new Error("No service worker found after registration"));
+      }
+      const onStateChange = () => {
+        if (sw.state === "activated") {
+          sw.removeEventListener("statechange", onStateChange);
+          resolve(reg);
+        } else if (sw.state === "redundant") {
+          sw.removeEventListener("statechange", onStateChange);
+          reject(new Error("Service worker became redundant during activation"));
+        }
+      };
+      sw.addEventListener("statechange", onStateChange);
+    });
+  })();
+  return swPromise;
+}
+async function getWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) return wtClient;
+  if (wtClientPromise) return wtClientPromise;
+  wtClientPromise = (async () => {
+    const { default: WebTorrentClass } = await import('webtorrent');
+    const client = new WebTorrentClass();
+    wtClient = client;
+    try {
+      const registration = await ensureServiceWorker();
+      if (!client._server) {
+        client.createServer({ controller: registration });
+      }
+    } catch (err) {
+      console.warn("[magnet-player] Service worker setup failed:", err);
+    }
+    return client;
+  })();
+  return wtClientPromise;
+}
+function destroyWebTorrentClient() {
+  if (wtClient && !wtClient.destroyed) {
+    wtClient.destroy();
+  }
+  wtClient = null;
+  wtClientPromise = null;
+}
+
+// src/react/use-magnet.ts
+var METADATA_TIMEOUT_MS = 3e4;
+var INITIAL_STATUS = {
+  status: "idle",
+  torrentName: "",
+  numPeers: 0,
+  downloadSpeed: 0,
+  uploadSpeed: 0,
+  progress: 0,
+  error: null
+};
+function useMagnet() {
+  const [torrentStatus, setTorrentStatus] = useState(INITIAL_STATUS);
+  const activeTorrentRef = useRef(null);
+  useEffect(() => {
+    return () => {
+      destroyWebTorrentClient();
+    };
+  }, []);
+  const destroyMagnet = useCallback(() => {
+    if (activeTorrentRef.current && !activeTorrentRef.current.destroyed) {
+      activeTorrentRef.current.destroy();
+    }
+    activeTorrentRef.current = null;
+    setTorrentStatus(INITIAL_STATUS);
+  }, []);
+  const addMagnet = useCallback(async (uri) => {
+    if (!isMagnetUri(uri)) {
+      throw new Error("Not a valid magnet link");
+    }
+    if (activeTorrentRef.current && !activeTorrentRef.current.destroyed) {
+      activeTorrentRef.current.destroy();
+    }
+    activeTorrentRef.current = null;
+    setTorrentStatus({
+      ...INITIAL_STATUS,
+      status: "loading-metadata",
+      error: null
+    });
+    let client;
+    try {
+      client = await getWebTorrentClient();
+    } catch {
+      const msg = "Could not initialise torrent client";
+      setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+      throw new Error(msg);
+    }
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      let torrent;
+      const settle = (fn) => {
+        if (settled) return;
+        settled = true;
+        fn();
+      };
+      const timeout = setTimeout(() => {
+        settle(() => {
+          torrent?.destroy?.();
+          activeTorrentRef.current = null;
+          const msg = "Could not connect to peers. Check the link and try again.";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+      }, METADATA_TIMEOUT_MS);
+      try {
+        torrent = client.add(uri.trim(), { announce: DEFAULT_TRACKERS });
+        activeTorrentRef.current = torrent;
+      } catch (err) {
+        settle(() => {
+          clearTimeout(timeout);
+          const msg = "Failed to add torrent";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+        return;
+      }
+      torrent.on("error", (err) => {
+        settle(() => {
+          clearTimeout(timeout);
+          torrent?.destroy?.();
+          activeTorrentRef.current = null;
+          const msg = err?.message ?? "Torrent error";
+          setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+          reject(new Error(msg));
+        });
+      });
+      torrent.on("ready", () => {
+        clearTimeout(timeout);
+        const videoFiles = getVideoFiles(torrent);
+        const streamable = videoFiles.filter(
+          (file) => Boolean(file.streamURL)
+        );
+        if (streamable.length === 0) {
+          settle(() => {
+            torrent.destroy();
+            activeTorrentRef.current = null;
+            const msg = videoFiles.length === 0 ? "No video files found in this torrent" : "Video files in this torrent could not be made streamable";
+            setTorrentStatus((s) => ({ ...s, status: "error", error: msg }));
+            reject(new Error(msg));
+          });
+          return;
+        }
+        settle(() => {
+          setTorrentStatus((s) => ({
+            ...s,
+            status: "ready",
+            torrentName: torrent.name ?? "",
+            progress: torrent.progress ?? 0
+          }));
+          const items = streamable.map((file) => ({
+            id: crypto.randomUUID(),
+            name: file.name,
+            url: file.streamURL,
+            type: "stream",
+            source: "torrent",
+            duration: void 0
+          }));
+          resolve(items);
+        });
+        torrent.on("download", () => {
+          setTorrentStatus((s) => ({
+            ...s,
+            numPeers: torrent.numPeers ?? 0,
+            downloadSpeed: torrent.downloadSpeed ?? 0,
+            uploadSpeed: torrent.uploadSpeed ?? 0,
+            progress: torrent.progress ?? 0
+          }));
+        });
+        torrent.on("done", () => {
+          setTorrentStatus((s) => ({ ...s, progress: 1 }));
+        });
+        torrent.on("wire", () => {
+          setTorrentStatus((s) => ({
+            ...s,
+            numPeers: torrent.numPeers ?? 0
+          }));
+        });
+      });
+    });
+  }, []);
+  return { torrentStatus, addMagnet, destroyMagnet };
+}
+
+export { useChapters, useFullscreen, useKeyboardShortcuts, useMagnet, useMediaSession, usePictureInPicture, usePlaylist, useProgressPersistence, useSubtitles, useVideoFilters, useVideoInfo, useVideoPlayback };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightbird/core",
-  "version": "0.1.6",
+  "version": "0.3.0",
   "description": "Client-side video player engine. Plays MKV, MP4, WebM with full subtitle, audio track, and chapter support. No server required.",
   "license": "MIT",
   "author": "Punyam Singh",
@@ -54,7 +54,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "ass-compiler": "^0.1.16"
+    "@openfeature/unleash-web-provider": "^0.1.1",
+    "@openfeature/web-sdk": "^1.6.0",
+    "ass-compiler": "^0.1.16",
+    "webtorrent": "^2.8.5"
   },
   "optionalDependencies": {
     "@ffmpeg/core": "^0.12.6",