ytdlp-react-native 1.0.0

package/build/ExpoYtDlpModule.web.js

@@ -0,0 +1,13 @@
+import { NativeModule, registerWebModule } from 'expo';
+import { SUPPORTED_PLATFORM_MESSAGE } from './constants';
+/**
+ * Web placeholder. The package is Android-only (see AGENTS.md §3); every
+ * method throws a meaningful error instead of a silent no-op.
+ */
+class ExpoYtDlpModule extends NativeModule {
+    getVersion() {
+        throw new Error(SUPPORTED_PLATFORM_MESSAGE);
+    }
+}
+export default registerWebModule(ExpoYtDlpModule, 'ExpoYtDlp');
+//# sourceMappingURL=ExpoYtDlpModule.web.js.map

package/build/ExpoYtDlpModule.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoYtDlpModule.web.js","sourceRoot":"","sources":["../src/ExpoYtDlpModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD;;;GAGG;AACH,MAAM,eAAgB,SAAQ,YAAY;IACxC,UAAU;QACR,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;CACF;AAED,eAAe,iBAAiB,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC","sourcesContent":["import { NativeModule, registerWebModule } from 'expo';\n\nimport { SUPPORTED_PLATFORM_MESSAGE } from './constants';\n\n/**\n * Web placeholder. The package is Android-only (see AGENTS.md §3); every\n * method throws a meaningful error instead of a silent no-op.\n */\nclass ExpoYtDlpModule extends NativeModule {\n  getVersion(): Promise<string> {\n    throw new Error(SUPPORTED_PLATFORM_MESSAGE);\n  }\n}\n\nexport default registerWebModule(ExpoYtDlpModule, 'ExpoYtDlp');\n"]}

package/build/YtDlp.d.ts

@@ -0,0 +1,23 @@
+import type { DownloadOptions, DownloadTask, ExtractOptions, Format, VideoInfo, YtDlpVersion } from './types';
+/**
+ * Read the yt-dlp version embedded in the native runtime plus this package's
+ * version. The two are independent (see AGENTS.md §35).
+ */
+export declare function getVersion(): Promise<YtDlpVersion>;
+/**
+ * Extract normalized media information without downloading anything.
+ */
+export declare function extractInfo(url: string, options?: ExtractOptions): Promise<VideoInfo>;
+/**
+ * List usable download formats. Internally reuses the same extraction as
+ * `extractInfo` to avoid redundant work (see AGENTS.md §34).
+ */
+export declare function getFormats(url: string, options?: ExtractOptions): Promise<Format[]>;
+/**
+ * Start a download. Resolves with a [DownloadTask] immediately; progress and
+ * the final result arrive through the task's listeners (AGENTS.md §12).
+ */
+export declare function download(options: DownloadOptions): Promise<DownloadTask>;
+/** Cancel a download by task id, e.g. after app re-creation (AGENTS.md §22). */
+export declare function cancel(taskId: string): Promise<boolean>;
+//# sourceMappingURL=YtDlp.d.ts.map

package/build/YtDlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YtDlp.d.ts","sourceRoot":"","sources":["../src/YtDlp.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,eAAe,EACf,YAAY,EACZ,cAAc,EACd,MAAM,EACN,SAAS,EACT,YAAY,EACb,MAAM,SAAS,CAAC;AAejB;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAQxD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAS3F;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGzF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAS9E;AAED,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7D"}

package/build/YtDlp.js

@@ -0,0 +1,160 @@
+import { NativeExpoYtDlp } from './ExpoYtDlpModule';
+import { LIBRARY_VERSION, SUPPORTED_PLATFORM_MESSAGE } from './constants';
+import { YtDlpDownloadTask } from './downloadTask';
+import { normalizeError, normalizeExtractionError, YtDlpError } from './errors';
+import { mapVideoInfo } from './mappers';
+function requireNative() {
+    if (!NativeExpoYtDlp) {
+        throw new YtDlpError('UNSUPPORTED_PLATFORM', SUPPORTED_PLATFORM_MESSAGE);
+    }
+    return NativeExpoYtDlp;
+}
+function validateUrl(url) {
+    if (!url || url.trim().length === 0) {
+        throw new YtDlpError('INVALID_URL', 'URL is required.');
+    }
+}
+/**
+ * Read the yt-dlp version embedded in the native runtime plus this package's
+ * version. The two are independent (see AGENTS.md §35).
+ */
+export async function getVersion() {
+    try {
+        const native = requireNative();
+        const ytDlp = await native.getVersion();
+        return { ytDlp, library: LIBRARY_VERSION };
+    }
+    catch (cause) {
+        throw normalizeError(cause);
+    }
+}
+/**
+ * Extract normalized media information without downloading anything.
+ */
+export async function extractInfo(url, options) {
+    validateUrl(url);
+    try {
+        const native = requireNative();
+        const json = await native.extractInfo(url, serializeExtractOptions(options));
+        return mapVideoInfo(JSON.parse(json));
+    }
+    catch (cause) {
+        throw normalizeExtractionError(cause);
+    }
+}
+/**
+ * List usable download formats. Internally reuses the same extraction as
+ * `extractInfo` to avoid redundant work (see AGENTS.md §34).
+ */
+export async function getFormats(url, options) {
+    const info = await extractInfo(url, options);
+    return info.formats;
+}
+/**
+ * Start a download. Resolves with a [DownloadTask] immediately; progress and
+ * the final result arrive through the task's listeners (AGENTS.md §12).
+ */
+export async function download(options) {
+    validateUrl(options.url);
+    try {
+        const native = requireNative();
+        const info = await native.startDownload(serializeDownloadOptions(options));
+        return new YtDlpDownloadTask(native, info.taskId);
+    }
+    catch (cause) {
+        throw normalizeError(cause);
+    }
+}
+/** Cancel a download by task id, e.g. after app re-creation (AGENTS.md §22). */
+export async function cancel(taskId) {
+    try {
+        const native = requireNative();
+        return await native.cancelDownload(taskId);
+    }
+    catch (cause) {
+        throw normalizeError(cause);
+    }
+}
+function serializeExtractOptions(options) {
+    if (!options)
+        return {};
+    const out = {};
+    if (options.cookies)
+        out.cookies = serializeCookies(options.cookies);
+    if (options.proxy)
+        out.proxy = options.proxy;
+    if (options.userAgent || options.headers) {
+        const headers = { ...(options.headers ?? {}) };
+        if (options.userAgent)
+            headers['User-Agent'] = options.userAgent;
+        out.headers = headers;
+    }
+    return out;
+}
+function serializeDownloadOptions(options) {
+    const out = { url: options.url };
+    if (options.format)
+        out.format = options.format;
+    if (options.output) {
+        const output = {};
+        if (options.output.directory)
+            output.directory = options.output.directory;
+        if (options.output.filename)
+            output.filename = options.output.filename;
+        if (Object.keys(output).length > 0)
+            out.output = output;
+    }
+    if (options.merge != null)
+        out.merge = options.merge;
+    if (options.cookies)
+        out.cookies = serializeCookies(options.cookies);
+    if (options.userAgent || options.headers) {
+        const headers = { ...(options.headers ?? {}) };
+        if (options.userAgent)
+            headers['User-Agent'] = options.userAgent;
+        out.headers = headers;
+    }
+    if (options.referer)
+        out.referer = options.referer;
+    if (options.proxy)
+        out.proxy = options.proxy;
+    if (options.playlist) {
+        const playlist = {};
+        if (options.playlist.enabled != null)
+            playlist.enabled = options.playlist.enabled;
+        if (options.playlist.start != null)
+            playlist.start = options.playlist.start;
+        if (options.playlist.end != null)
+            playlist.end = options.playlist.end;
+        if (Object.keys(playlist).length > 0)
+            out.playlist = playlist;
+    }
+    if (options.network) {
+        const network = {};
+        if (options.network.timeout != null)
+            network.timeout = options.network.timeout;
+        if (options.network.retries != null)
+            network.retries = options.network.retries;
+        if (Object.keys(network).length > 0)
+            out.network = network;
+    }
+    if (options.subtitles) {
+        const subtitles = {};
+        if (options.subtitles.enabled != null)
+            subtitles.enabled = options.subtitles.enabled;
+        if (options.subtitles.languages?.length)
+            subtitles.languages = options.subtitles.languages;
+        if (options.subtitles.autoGenerated != null)
+            subtitles.autoGenerated = options.subtitles.autoGenerated;
+        if (Object.keys(subtitles).length > 0)
+            out.subtitles = subtitles;
+    }
+    return out;
+}
+function serializeCookies(cookies) {
+    if (cookies.source === 'file' && cookies.path) {
+        return { path: cookies.path };
+    }
+    throw new YtDlpError('INVALID_URL', 'Cookies must reference a cookies file path.');
+}
+//# sourceMappingURL=YtDlp.js.map

package/build/YtDlp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"YtDlp.js","sourceRoot":"","sources":["../src/YtDlp.ts"],"names":[],"mappings":"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","sourcesContent":["import { NativeExpoYtDlp, type ExpoYtDlpNativeModule } from './ExpoYtDlpModule';\nimport { LIBRARY_VERSION, SUPPORTED_PLATFORM_MESSAGE } from './constants';\nimport { YtDlpDownloadTask } from './downloadTask';\nimport { normalizeError, normalizeExtractionError, YtDlpError } from './errors';\nimport { mapVideoInfo } from './mappers';\nimport type {\n  CookieOptions,\n  DownloadOptions,\n  DownloadTask,\n  ExtractOptions,\n  Format,\n  VideoInfo,\n  YtDlpVersion,\n} from './types';\n\nfunction requireNative(): ExpoYtDlpNativeModule {\n  if (!NativeExpoYtDlp) {\n    throw new YtDlpError('UNSUPPORTED_PLATFORM', SUPPORTED_PLATFORM_MESSAGE);\n  }\n  return NativeExpoYtDlp;\n}\n\nfunction validateUrl(url: string | undefined): void {\n  if (!url || url.trim().length === 0) {\n    throw new YtDlpError('INVALID_URL', 'URL is required.');\n  }\n}\n\n/**\n * Read the yt-dlp version embedded in the native runtime plus this package's\n * version. The two are independent (see AGENTS.md §35).\n */\nexport async function getVersion(): Promise<YtDlpVersion> {\n  try {\n    const native = requireNative();\n    const ytDlp = await native.getVersion();\n    return { ytDlp, library: LIBRARY_VERSION };\n  } catch (cause) {\n    throw normalizeError(cause);\n  }\n}\n\n/**\n * Extract normalized media information without downloading anything.\n */\nexport async function extractInfo(url: string, options?: ExtractOptions): Promise<VideoInfo> {\n  validateUrl(url);\n  try {\n    const native = requireNative();\n    const json = await native.extractInfo(url, serializeExtractOptions(options));\n    return mapVideoInfo(JSON.parse(json));\n  } catch (cause) {\n    throw normalizeExtractionError(cause);\n  }\n}\n\n/**\n * List usable download formats. Internally reuses the same extraction as\n * `extractInfo` to avoid redundant work (see AGENTS.md §34).\n */\nexport async function getFormats(url: string, options?: ExtractOptions): Promise<Format[]> {\n  const info = await extractInfo(url, options);\n  return info.formats;\n}\n\n/**\n * Start a download. Resolves with a [DownloadTask] immediately; progress and\n * the final result arrive through the task's listeners (AGENTS.md §12).\n */\nexport async function download(options: DownloadOptions): Promise<DownloadTask> {\n  validateUrl(options.url);\n  try {\n    const native = requireNative();\n    const info = await native.startDownload(serializeDownloadOptions(options));\n    return new YtDlpDownloadTask(native, info.taskId);\n  } catch (cause) {\n    throw normalizeError(cause);\n  }\n}\n\n/** Cancel a download by task id, e.g. after app re-creation (AGENTS.md §22). */\nexport async function cancel(taskId: string): Promise<boolean> {\n  try {\n    const native = requireNative();\n    return await native.cancelDownload(taskId);\n  } catch (cause) {\n    throw normalizeError(cause);\n  }\n}\n\nfunction serializeExtractOptions(options: ExtractOptions | undefined): Record<string, unknown> {\n  if (!options) return {};\n  const out: Record<string, unknown> = {};\n  if (options.cookies) out.cookies = serializeCookies(options.cookies);\n  if (options.proxy) out.proxy = options.proxy;\n  if (options.userAgent || options.headers) {\n    const headers: Record<string, string> = { ...(options.headers ?? {}) };\n    if (options.userAgent) headers['User-Agent'] = options.userAgent;\n    out.headers = headers;\n  }\n  return out;\n}\n\nfunction serializeDownloadOptions(options: DownloadOptions): Record<string, unknown> {\n  const out: Record<string, unknown> = { url: options.url };\n  if (options.format) out.format = options.format;\n  if (options.output) {\n    const output: Record<string, unknown> = {};\n    if (options.output.directory) output.directory = options.output.directory;\n    if (options.output.filename) output.filename = options.output.filename;\n    if (Object.keys(output).length > 0) out.output = output;\n  }\n  if (options.merge != null) out.merge = options.merge;\n  if (options.cookies) out.cookies = serializeCookies(options.cookies);\n  if (options.userAgent || options.headers) {\n    const headers: Record<string, string> = { ...(options.headers ?? {}) };\n    if (options.userAgent) headers['User-Agent'] = options.userAgent;\n    out.headers = headers;\n  }\n  if (options.referer) out.referer = options.referer;\n  if (options.proxy) out.proxy = options.proxy;\n  if (options.playlist) {\n    const playlist: Record<string, unknown> = {};\n    if (options.playlist.enabled != null) playlist.enabled = options.playlist.enabled;\n    if (options.playlist.start != null) playlist.start = options.playlist.start;\n    if (options.playlist.end != null) playlist.end = options.playlist.end;\n    if (Object.keys(playlist).length > 0) out.playlist = playlist;\n  }\n  if (options.network) {\n    const network: Record<string, unknown> = {};\n    if (options.network.timeout != null) network.timeout = options.network.timeout;\n    if (options.network.retries != null) network.retries = options.network.retries;\n    if (Object.keys(network).length > 0) out.network = network;\n  }\n  if (options.subtitles) {\n    const subtitles: Record<string, unknown> = {};\n    if (options.subtitles.enabled != null) subtitles.enabled = options.subtitles.enabled;\n    if (options.subtitles.languages?.length) subtitles.languages = options.subtitles.languages;\n    if (options.subtitles.autoGenerated != null)\n      subtitles.autoGenerated = options.subtitles.autoGenerated;\n    if (Object.keys(subtitles).length > 0) out.subtitles = subtitles;\n  }\n  return out;\n}\n\nfunction serializeCookies(cookies: CookieOptions): Record<string, unknown> {\n  if (cookies.source === 'file' && cookies.path) {\n    return { path: cookies.path };\n  }\n  throw new YtDlpError('INVALID_URL', 'Cookies must reference a cookies file path.');\n}\n"]}

package/build/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package-level constants.
+ */
+export declare const LIBRARY_VERSION = "0.1.0";
+export declare const SUPPORTED_PLATFORM = "android";
+export declare const SUPPORTED_PLATFORM_MESSAGE = "expo-ytdlp-native is currently supported on android only.";
+/** yt-dlp output template used when the caller does not provide a filename. */
+export declare const DEFAULT_FILENAME_TEMPLATE = "%(title)s.%(ext)s";
+//# sourceMappingURL=constants.d.ts.map

package/build/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,eAAO,MAAM,0BAA0B,8DAAiF,CAAC;AAEzH,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,sBAAsB,CAAC"}

package/build/constants.js

@@ -0,0 +1,9 @@
+/**
+ * Package-level constants.
+ */
+export const LIBRARY_VERSION = '0.1.0';
+export const SUPPORTED_PLATFORM = 'android';
+export const SUPPORTED_PLATFORM_MESSAGE = `${'expo-ytdlp-native'} is currently supported on ${SUPPORTED_PLATFORM} only.`;
+/** yt-dlp output template used when the caller does not provide a filename. */
+export const DEFAULT_FILENAME_TEMPLATE = '%(title)s.%(ext)s';
+//# sourceMappingURL=constants.js.map

package/build/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,mBAAmB,8BAA8B,kBAAkB,QAAQ,CAAC;AAEzH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC","sourcesContent":["/**\n * Package-level constants.\n */\nexport const LIBRARY_VERSION = '0.1.0';\n\nexport const SUPPORTED_PLATFORM = 'android';\n\nexport const SUPPORTED_PLATFORM_MESSAGE = `${'expo-ytdlp-native'} is currently supported on ${SUPPORTED_PLATFORM} only.`;\n\n/** yt-dlp output template used when the caller does not provide a filename. */\nexport const DEFAULT_FILENAME_TEMPLATE = '%(title)s.%(ext)s';\n"]}

package/build/downloadTask.d.ts

@@ -0,0 +1,30 @@
+/**
+ * JS-side `DownloadTask` implementation.
+ *
+ * Keeps this module dependency-light: all per-task state lives in the native
+ * task registry; the JS object only relays events and forwards commands
+ * (AGENTS.md §17, §47).
+ */
+import type { ExpoYtDlpNativeModule } from './ExpoYtDlpModule';
+import { YtDlpError } from './errors';
+import type { DownloadProgress, DownloadResult, DownloadStateEvent, DownloadStatus, DownloadTask, Subscription } from './types';
+type Listener<T> = (value: T) => void;
+export declare class YtDlpDownloadTask implements DownloadTask {
+    readonly id: string;
+    private readonly native;
+    private currentStatus;
+    private finalized;
+    private readonly listeners;
+    private subscriptions;
+    constructor(native: ExpoYtDlpNativeModule, id: string);
+    cancel(): Promise<void>;
+    getStatus(): Promise<DownloadStatus>;
+    getProgress(): Promise<DownloadProgress | null>;
+    addListener(event: 'progress', listener: Listener<DownloadProgress>): Subscription;
+    addListener(event: 'state', listener: Listener<DownloadStateEvent>): Subscription;
+    addListener(event: 'completed', listener: Listener<DownloadResult>): Subscription;
+    addListener(event: 'error', listener: Listener<YtDlpError>): Subscription;
+    private teardown;
+}
+export {};
+//# sourceMappingURL=downloadTask.d.ts.map

package/build/downloadTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadTask.d.ts","sourceRoot":"","sources":["../src/downloadTask.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAsB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAStC,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAKxB;IACF,OAAO,CAAC,aAAa,CAAsB;gBAE/B,MAAM,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM;IAgC/C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAOpC,WAAW,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAMrD,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY;IAClF,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,YAAY;IACjF,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,YAAY;IACjF,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,YAAY;IAyBzE,OAAO,CAAC,QAAQ;CAIjB"}

package/build/downloadTask.js

@@ -0,0 +1,111 @@
+import { attachTaskListeners } from './events';
+export class YtDlpDownloadTask {
+    id;
+    native;
+    currentStatus = 'queued';
+    finalized = false;
+    listeners = {
+        progress: new Set(),
+        state: new Set(),
+        completed: new Set(),
+        error: new Set(),
+    };
+    subscriptions = [];
+    constructor(native, id) {
+        this.native = native;
+        this.id = id;
+        this.subscriptions = attachTaskListeners(id, {
+            progress: (progress) => {
+                this.currentStatus = progress.status;
+                this.listeners.progress.forEach((listener) => listener(progress));
+            },
+            state: (state) => {
+                this.currentStatus = state.status;
+                this.listeners.state.forEach((listener) => listener(state));
+            },
+            completed: (result) => {
+                this.finalized = true;
+                this.currentStatus = 'completed';
+                this.teardown();
+                this.listeners.completed.forEach((listener) => listener(result));
+            },
+            cancelled: () => {
+                this.finalized = true;
+                this.currentStatus = 'cancelled';
+                this.teardown();
+            },
+            error: (error) => {
+                this.finalized = true;
+                this.currentStatus = 'failed';
+                this.teardown();
+                this.listeners.error.forEach((listener) => listener(error));
+            },
+        });
+    }
+    async cancel() {
+        await this.native.cancelDownload(this.id);
+    }
+    async getStatus() {
+        if (this.finalized)
+            return this.currentStatus;
+        const info = await this.native.getDownloadStatus(this.id);
+        if (info?.status)
+            this.currentStatus = info.status;
+        return this.currentStatus;
+    }
+    async getProgress() {
+        const info = await this.native.getDownloadStatus(this.id);
+        if (!info)
+            return null;
+        return mapStatusInfo(this.id, this.currentStatus, info);
+    }
+    addListener(event, listener) {
+        const set = event === 'progress'
+            ? this.listeners.progress
+            : event === 'state'
+                ? this.listeners.state
+                : event === 'completed'
+                    ? this.listeners.completed
+                    : this.listeners.error;
+        set.add(listener);
+        return {
+            remove: () => {
+                set.delete(listener);
+            },
+        };
+    }
+    teardown() {
+        this.subscriptions.forEach((subscription) => subscription.remove());
+        this.subscriptions = [];
+    }
+}
+function mapStatusInfo(taskId, fallbackStatus, info) {
+    return {
+        taskId,
+        status: (info.status ?? fallbackStatus),
+        phase: phaseOf(info.status),
+        percent: finiteOrUndefined(info.percent),
+        downloadedBytes: finiteOrUndefined(info.downloadedBytes),
+        totalBytes: finiteOrUndefined(info.totalBytes),
+        speedBytesPerSecond: finiteOrUndefined(info.speedBytesPerSecond),
+        etaSeconds: finiteOrUndefined(info.etaSeconds),
+        filename: info.filename,
+    };
+}
+function phaseOf(status) {
+    switch (status) {
+        case 'downloading':
+            return 'downloading';
+        case 'completed':
+        case 'processing':
+            return 'processing';
+        default:
+            return 'extracting';
+    }
+}
+function finiteOrUndefined(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=downloadTask.js.map

package/build/downloadTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadTask.js","sourceRoot":"","sources":["../src/downloadTask.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * JS-side `DownloadTask` implementation.\n *\n * Keeps this module dependency-light: all per-task state lives in the native\n * task registry; the JS object only relays events and forwards commands\n * (AGENTS.md §17, §47).\n */\nimport type { DownloadStatusInfo, ExpoYtDlpNativeModule } from './ExpoYtDlpModule';\nimport { YtDlpError } from './errors';\nimport { attachTaskListeners } from './events';\nimport type {\n  DownloadProgress,\n  DownloadResult,\n  DownloadStateEvent,\n  DownloadStatus,\n  DownloadTask,\n  Subscription,\n} from './types';\n\ntype Listener<T> = (value: T) => void;\n\ninterface TaskListenerSets {\n  progress: Set<Listener<DownloadProgress>>;\n  state: Set<Listener<DownloadStateEvent>>;\n  completed: Set<Listener<DownloadResult>>;\n  error: Set<Listener<YtDlpError>>;\n}\n\nexport class YtDlpDownloadTask implements DownloadTask {\n  readonly id: string;\n\n  private readonly native: ExpoYtDlpNativeModule;\n  private currentStatus: DownloadStatus = 'queued';\n  private finalized = false;\n  private readonly listeners: TaskListenerSets = {\n    progress: new Set(),\n    state: new Set(),\n    completed: new Set(),\n    error: new Set(),\n  };\n  private subscriptions: Subscription[] = [];\n\n  constructor(native: ExpoYtDlpNativeModule, id: string) {\n    this.native = native;\n    this.id = id;\n    this.subscriptions = attachTaskListeners(id, {\n      progress: (progress) => {\n        this.currentStatus = progress.status;\n        this.listeners.progress.forEach((listener) => listener(progress));\n      },\n      state: (state) => {\n        this.currentStatus = state.status;\n        this.listeners.state.forEach((listener) => listener(state));\n      },\n      completed: (result) => {\n        this.finalized = true;\n        this.currentStatus = 'completed';\n        this.teardown();\n        this.listeners.completed.forEach((listener) => listener(result));\n      },\n      cancelled: () => {\n        this.finalized = true;\n        this.currentStatus = 'cancelled';\n        this.teardown();\n      },\n      error: (error) => {\n        this.finalized = true;\n        this.currentStatus = 'failed';\n        this.teardown();\n        this.listeners.error.forEach((listener) => listener(error));\n      },\n    });\n  }\n\n  async cancel(): Promise<void> {\n    await this.native.cancelDownload(this.id);\n  }\n\n  async getStatus(): Promise<DownloadStatus> {\n    if (this.finalized) return this.currentStatus;\n    const info = await this.native.getDownloadStatus(this.id);\n    if (info?.status) this.currentStatus = info.status;\n    return this.currentStatus;\n  }\n\n  async getProgress(): Promise<DownloadProgress | null> {\n    const info = await this.native.getDownloadStatus(this.id);\n    if (!info) return null;\n    return mapStatusInfo(this.id, this.currentStatus, info);\n  }\n\n  addListener(event: 'progress', listener: Listener<DownloadProgress>): Subscription;\n  addListener(event: 'state', listener: Listener<DownloadStateEvent>): Subscription;\n  addListener(event: 'completed', listener: Listener<DownloadResult>): Subscription;\n  addListener(event: 'error', listener: Listener<YtDlpError>): Subscription;\n  addListener(\n    event: 'progress' | 'state' | 'completed' | 'error',\n    listener:\n      | Listener<DownloadProgress>\n      | Listener<DownloadStateEvent>\n      | Listener<DownloadResult>\n      | Listener<YtDlpError>\n  ): Subscription {\n    const set =\n      event === 'progress'\n        ? this.listeners.progress\n        : event === 'state'\n          ? this.listeners.state\n          : event === 'completed'\n            ? this.listeners.completed\n            : this.listeners.error;\n    set.add(listener as never);\n    return {\n      remove: () => {\n        set.delete(listener as never);\n      },\n    };\n  }\n\n  private teardown() {\n    this.subscriptions.forEach((subscription) => subscription.remove());\n    this.subscriptions = [];\n  }\n}\n\nfunction mapStatusInfo(\n  taskId: string,\n  fallbackStatus: DownloadStatus,\n  info: DownloadStatusInfo\n): DownloadProgress {\n  return {\n    taskId,\n    status: (info.status ?? fallbackStatus) as DownloadStatus,\n    phase: phaseOf(info.status),\n    percent: finiteOrUndefined(info.percent),\n    downloadedBytes: finiteOrUndefined(info.downloadedBytes),\n    totalBytes: finiteOrUndefined(info.totalBytes),\n    speedBytesPerSecond: finiteOrUndefined(info.speedBytesPerSecond),\n    etaSeconds: finiteOrUndefined(info.etaSeconds),\n    filename: info.filename,\n  };\n}\n\nfunction phaseOf(status: DownloadStatus): DownloadProgress['phase'] {\n  switch (status) {\n    case 'downloading':\n      return 'downloading';\n    case 'completed':\n    case 'processing':\n      return 'processing';\n    default:\n      return 'extracting';\n  }\n}\n\nfunction finiteOrUndefined(value: number | undefined): number | undefined {\n  if (value === undefined || value === null) return undefined;\n  return Number.isFinite(value) ? value : undefined;\n}\n"]}

package/build/errors.d.ts

@@ -0,0 +1,27 @@
+import type { YtDlpErrorCode } from './types';
+export declare class YtDlpError extends Error {
+    readonly code: YtDlpErrorCode;
+    readonly taskId?: string;
+    readonly cause?: unknown;
+    constructor(code: YtDlpErrorCode, message: string, options?: {
+        taskId?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Normalizes anything thrown by the native layer into a `YtDlpError`.
+ * Unknown/missing codes map to `UNKNOWN`; raw stack traces are never surfaced.
+ */
+export declare function normalizeError(cause: unknown, fallbackMessage?: string): YtDlpError;
+/**
+ * Builds a `YtDlpError` from a code+message pair received from native events.
+ * Unknown codes degrade to `UNKNOWN` (AGENTS.md §23).
+ */
+export declare function fromNativeCode(code: string, message: string): YtDlpError;
+/**
+ * Refines an extraction failure into a more specific code by matching the
+ * yt-dlp error message. Kept conservative: no match falls back to the
+ * normalized code.
+ */
+export declare function normalizeExtractionError(cause: unknown, fallbackMessage?: string): YtDlpError;
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,eAAe,SAAyB,GACvC,UAAU,CAkBZ;AAmCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAExE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,eAAe,SAAwC,GACtD,UAAU,CAiCZ"}

package/build/errors.js

@@ -0,0 +1,111 @@
+/** Prefix used by the Kotlin layer to carry error codes across the bridge. */
+const NATIVE_PREFIX = 'YTD_NATIVE|';
+export class YtDlpError extends Error {
+    code;
+    taskId;
+    cause;
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'YtDlpError';
+        this.code = code;
+        if (options?.taskId)
+            this.taskId = options.taskId;
+        if (options?.cause !== undefined)
+            this.cause = options.cause;
+    }
+}
+/**
+ * Normalizes anything thrown by the native layer into a `YtDlpError`.
+ * Unknown/missing codes map to `UNKNOWN`; raw stack traces are never surfaced.
+ */
+export function normalizeError(cause, fallbackMessage = 'Unknown yt-dlp error') {
+    if (cause instanceof YtDlpError)
+        return cause;
+    if (cause instanceof Error) {
+        const parsed = parseNativeMessage(cause.message);
+        if (parsed) {
+            return new YtDlpError(parsed.code, parsed.message, { cause });
+        }
+        return new YtDlpError('UNKNOWN', cause.message || fallbackMessage, { cause });
+    }
+    if (typeof cause === 'string') {
+        const parsed = parseNativeMessage(cause);
+        if (parsed)
+            return new YtDlpError(parsed.code, parsed.message);
+        return new YtDlpError('UNKNOWN', cause || fallbackMessage);
+    }
+    return new YtDlpError('UNKNOWN', fallbackMessage, { cause });
+}
+function parseNativeMessage(message) {
+    if (!message.startsWith(NATIVE_PREFIX))
+        return null;
+    const rest = message.slice(NATIVE_PREFIX.length);
+    const separator = rest.indexOf('|');
+    if (separator === -1)
+        return null;
+    const rawCode = rest.slice(0, separator);
+    const text = rest.slice(separator + 1);
+    const code = toKnownCode(rawCode);
+    return { code, message: text || rawCode };
+}
+function toKnownCode(rawCode) {
+    const known = [
+        'INVALID_URL',
+        'EXTRACTION_FAILED',
+        'DOWNLOAD_FAILED',
+        'CANCELLED',
+        'FORMAT_UNAVAILABLE',
+        'NETWORK_ERROR',
+        'AUTHENTICATION_REQUIRED',
+        'GEO_RESTRICTED',
+        'PRIVATE_CONTENT',
+        'AGE_RESTRICTED',
+        'PROCESSING_FAILED',
+        'STORAGE_ERROR',
+        'INIT_FAILED',
+        'UNSUPPORTED_PLATFORM',
+        'UNKNOWN',
+    ];
+    if (known.includes(rawCode))
+        return rawCode;
+    return 'UNKNOWN';
+}
+/**
+ * Builds a `YtDlpError` from a code+message pair received from native events.
+ * Unknown codes degrade to `UNKNOWN` (AGENTS.md §23).
+ */
+export function fromNativeCode(code, message) {
+    return new YtDlpError(toKnownCode(code), message);
+}
+/**
+ * Refines an extraction failure into a more specific code by matching the
+ * yt-dlp error message. Kept conservative: no match falls back to the
+ * normalized code.
+ */
+export function normalizeExtractionError(cause, fallbackMessage = 'Failed to extract media information') {
+    const base = normalizeError(cause, fallbackMessage);
+    if (base.code !== 'EXTRACTION_FAILED' && base.code !== 'UNKNOWN')
+        return base;
+    const message = base.message.toLowerCase();
+    if (/http error|connection|timed out|unreachable|name or service not known|failed to establish|reset by peer|couldn't connect|503|429/.test(message)) {
+        return new YtDlpError('NETWORK_ERROR', base.message, { cause: base.cause });
+    }
+    if (message.includes('sign in to confirm') ||
+        message.includes('log in') ||
+        message.includes('sign up')) {
+        return new YtDlpError('AUTHENTICATION_REQUIRED', base.message, { cause: base.cause });
+    }
+    if (message.includes('private') || message.includes('members-only')) {
+        return new YtDlpError('PRIVATE_CONTENT', base.message, { cause: base.cause });
+    }
+    if (message.includes('age') || message.includes('mature') || message.includes('under 18')) {
+        return new YtDlpError('AGE_RESTRICTED', base.message, { cause: base.cause });
+    }
+    if (message.includes('geographic') ||
+        message.includes('geo-') ||
+        message.includes('not available in your country')) {
+        return new YtDlpError('GEO_RESTRICTED', base.message, { cause: base.cause });
+    }
+    return base;
+}
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { YtDlpErrorCode } from './types';\n\n/** Prefix used by the Kotlin layer to carry error codes across the bridge. */\nconst NATIVE_PREFIX = 'YTD_NATIVE|';\n\nexport class YtDlpError extends Error {\n  readonly code: YtDlpErrorCode;\n  readonly taskId?: string;\n  readonly cause?: unknown;\n\n  constructor(\n    code: YtDlpErrorCode,\n    message: string,\n    options?: { taskId?: string; cause?: unknown }\n  ) {\n    super(message);\n    this.name = 'YtDlpError';\n    this.code = code;\n    if (options?.taskId) this.taskId = options.taskId;\n    if (options?.cause !== undefined) this.cause = options.cause;\n  }\n}\n\n/**\n * Normalizes anything thrown by the native layer into a `YtDlpError`.\n * Unknown/missing codes map to `UNKNOWN`; raw stack traces are never surfaced.\n */\nexport function normalizeError(\n  cause: unknown,\n  fallbackMessage = 'Unknown yt-dlp error'\n): YtDlpError {\n  if (cause instanceof YtDlpError) return cause;\n\n  if (cause instanceof Error) {\n    const parsed = parseNativeMessage(cause.message);\n    if (parsed) {\n      return new YtDlpError(parsed.code, parsed.message, { cause });\n    }\n    return new YtDlpError('UNKNOWN', cause.message || fallbackMessage, { cause });\n  }\n\n  if (typeof cause === 'string') {\n    const parsed = parseNativeMessage(cause);\n    if (parsed) return new YtDlpError(parsed.code, parsed.message);\n    return new YtDlpError('UNKNOWN', cause || fallbackMessage);\n  }\n\n  return new YtDlpError('UNKNOWN', fallbackMessage, { cause });\n}\n\nfunction parseNativeMessage(message: string): { code: YtDlpErrorCode; message: string } | null {\n  if (!message.startsWith(NATIVE_PREFIX)) return null;\n  const rest = message.slice(NATIVE_PREFIX.length);\n  const separator = rest.indexOf('|');\n  if (separator === -1) return null;\n  const rawCode = rest.slice(0, separator);\n  const text = rest.slice(separator + 1);\n  const code = toKnownCode(rawCode);\n  return { code, message: text || rawCode };\n}\n\nfunction toKnownCode(rawCode: string): YtDlpErrorCode {\n  const known: YtDlpErrorCode[] = [\n    'INVALID_URL',\n    'EXTRACTION_FAILED',\n    'DOWNLOAD_FAILED',\n    'CANCELLED',\n    'FORMAT_UNAVAILABLE',\n    'NETWORK_ERROR',\n    'AUTHENTICATION_REQUIRED',\n    'GEO_RESTRICTED',\n    'PRIVATE_CONTENT',\n    'AGE_RESTRICTED',\n    'PROCESSING_FAILED',\n    'STORAGE_ERROR',\n    'INIT_FAILED',\n    'UNSUPPORTED_PLATFORM',\n    'UNKNOWN',\n  ];\n  if ((known as readonly string[]).includes(rawCode)) return rawCode as YtDlpErrorCode;\n  return 'UNKNOWN';\n}\n\n/**\n * Builds a `YtDlpError` from a code+message pair received from native events.\n * Unknown codes degrade to `UNKNOWN` (AGENTS.md §23).\n */\nexport function fromNativeCode(code: string, message: string): YtDlpError {\n  return new YtDlpError(toKnownCode(code), message);\n}\n\n/**\n * Refines an extraction failure into a more specific code by matching the\n * yt-dlp error message. Kept conservative: no match falls back to the\n * normalized code.\n */\nexport function normalizeExtractionError(\n  cause: unknown,\n  fallbackMessage = 'Failed to extract media information'\n): YtDlpError {\n  const base = normalizeError(cause, fallbackMessage);\n  if (base.code !== 'EXTRACTION_FAILED' && base.code !== 'UNKNOWN') return base;\n\n  const message = base.message.toLowerCase();\n  if (\n    /http error|connection|timed out|unreachable|name or service not known|failed to establish|reset by peer|couldn't connect|503|429/.test(\n      message\n    )\n  ) {\n    return new YtDlpError('NETWORK_ERROR', base.message, { cause: base.cause });\n  }\n  if (\n    message.includes('sign in to confirm') ||\n    message.includes('log in') ||\n    message.includes('sign up')\n  ) {\n    return new YtDlpError('AUTHENTICATION_REQUIRED', base.message, { cause: base.cause });\n  }\n  if (message.includes('private') || message.includes('members-only')) {\n    return new YtDlpError('PRIVATE_CONTENT', base.message, { cause: base.cause });\n  }\n  if (message.includes('age') || message.includes('mature') || message.includes('under 18')) {\n    return new YtDlpError('AGE_RESTRICTED', base.message, { cause: base.cause });\n  }\n  if (\n    message.includes('geographic') ||\n    message.includes('geo-') ||\n    message.includes('not available in your country')\n  ) {\n    return new YtDlpError('GEO_RESTRICTED', base.message, { cause: base.cause });\n  }\n  return base;\n}\n"]}

package/build/events.d.ts

@@ -0,0 +1,20 @@
+import { type YtDlpError } from './errors';
+import type { DownloadEvent, DownloadProgress, DownloadResult, DownloadStateEvent, Subscription } from './types';
+/**
+ * Returns a per-task subscription backed by the native event stream.
+ * `taskId` is used to filter events that belong to another task.
+ */
+export declare function subscribeToTask(taskId: string, handler: (event: DownloadEvent) => void): Subscription;
+export declare function subscribeToDownloadEvents(handler: (event: DownloadEvent) => void): Subscription;
+/**
+ * Adds task-level listeners to a [DownloadTask] from a raw subscription
+ * factory. Keeps the event filtering in one place.
+ */
+export declare function attachTaskListeners(taskId: string, listeners: {
+    progress?: (progress: DownloadProgress) => void;
+    state?: (state: DownloadStateEvent) => void;
+    completed?: (result: DownloadResult) => void;
+    cancelled?: () => void;
+    error?: (error: YtDlpError) => void;
+}): Subscription[];
+//# sourceMappingURL=events.d.ts.map

package/build/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACb,MAAM,SAAS,CAAC;AAIjB;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACtC,YAAY,CAMd;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,YAAY,CAe/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE;IACT,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACrC,GACA,YAAY,EAAE,CA8BhB"}