ytdlp-react-native 1.0.0 → 1.1.0-beta.0

package/build/serializers.js

@@ -0,0 +1,96 @@
+/**
+ * Pure serializers that translate public options into the plain map sent to
+ * the native layer. Kept free of native imports so they can be unit-tested
+ * (AGENTS.md §49, §41).
+ */
+import { YtDlpError } from './errors';
+export 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;
+}
+export 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.ffmpeg?.location) {
+        const location = options.ffmpeg.location.trim();
+        if (!location) {
+            throw new YtDlpError('PROCESSING_FAILED', 'ffmpeg.location must not be empty.');
+        }
+        out.ffmpeg = { location };
+    }
+    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;
+}
+export 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=serializers.js.map

package/build/serializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../src/serializers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure serializers that translate public options into the plain map sent to\n * the native layer. Kept free of native imports so they can be unit-tested\n * (AGENTS.md §49, §41).\n */\nimport { YtDlpError } from './errors';\nimport type { CookieOptions, DownloadOptions, ExtractOptions } from './types';\n\nexport function serializeExtractOptions(\n  options: ExtractOptions | undefined\n): 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\nexport function 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.ffmpeg?.location) {\n    const location = options.ffmpeg.location.trim();\n    if (!location) {\n      throw new YtDlpError('PROCESSING_FAILED', 'ffmpeg.location must not be empty.');\n    }\n    out.ffmpeg = { location };\n  }\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\nexport function 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/types.d.ts

@@ -5,7 +5,7 @@
  * leak into this surface (see AGENTS.md §68).
  */
 import type { YtDlpError } from './errors';
-export type DownloadStatus = 'queued' | 'extracting' | 'downloading' | 'processing' | 'completed' | 'cancelled' | 'failed';
+export type DownloadStatus = 'queued' | 'extracting' | 'downloading' | 'processing' | 'paused' | 'completed' | 'cancelled' | 'failed';
 export type DownloadPhase = 'extracting' | 'downloading' | 'processing';
 export interface Thumbnail {
     url: string;
@@ -95,6 +95,20 @@ export interface NetworkOptions {
     timeout?: number;
     retries?: number;
 }
+/**
+ * Optional FFmpeg integration (see issue #2). The package does **not** bundle
+ * FFmpeg — yt-dlp needs a real executable to merge separate video+audio
+ * streams (`bestvideo+bestaudio`), extract/re-encode audio, or embed metadata
+ * and thumbnails. Point `location` at an ffmpeg binary already on the device.
+ */
+export interface FfmpegOptions {
+    /**
+     * Absolute filesystem path to an `ffmpeg` executable, or to a directory
+     * that contains one. yt-dlp spawns the binary from here during
+     * post-processing. An in-process JNI wrapper (e.g. FFmpegKit) is not enough.
+     */
+    location: string;
+}
 export interface PlaylistOptions {
     enabled?: boolean;
     start?: number;
@@ -114,7 +128,17 @@ export interface DownloadOptions {
     /** Raw yt-dlp format expression, e.g. `best`, `bestvideo+bestaudio`. */
     format?: string;
     output?: OutputOptions;
+    /**
+     * Set to `true` to request merging (e.g. with `format: 'bestvideo+bestaudio'`).
+     * Merging requires FFmpeg — see `ffmpeg`.
+     */
     merge?: boolean;
+    /**
+     * Optional FFmpeg integration. When unset, FFmpeg-dependent features are
+     * rejected with `PROCESSING_FAILED`. When set, `bestvideo+bestaudio` and
+     * other post-processing become available.
+     */
+    ffmpeg?: FfmpegOptions;
     subtitles?: SubtitleOptions;
     cookies?: CookieOptions;
     /** Additional HTTP headers. Validated; secrets are never logged. */
@@ -168,6 +192,20 @@ export interface Subscription {
 export interface DownloadTask {
     id: string;
     cancel(): Promise<void>;
+    /**
+     * Pause an in-flight download. yt-dlp aborts on the next progress tick and
+     * leaves its `.part` file on disk; the task remains registered with status
+     * `paused`. Resolves `false` if the task is unknown, already paused, or
+     * already finished.
+     */
+    pause(): Promise<boolean>;
+    /**
+     * Resume a paused download with the exact same options. yt-dlp continues
+     * from the `.part` file by default (byte-range where the source supports it,
+     * otherwise the file restarts). Resolves `false` if the task is unknown or
+     * not paused.
+     */
+    resume(): Promise<boolean>;
     getStatus(): Promise<DownloadStatus>;
     getProgress(): Promise<DownloadProgress | null>;
     addListener(event: 'progress', listener: (progress: DownloadProgress) => void): Subscription;

package/build/types.d.ts.map

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

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Public types for expo-ytdlp-native.\n *\n * These types are the stable contract of the package. Native details never\n * leak into this surface (see AGENTS.md §68).\n */\nimport type { YtDlpError } from './errors';\n\nexport type DownloadStatus =\n  'queued' | 'extracting' | 'downloading' | 'processing' | 'completed' | 'cancelled' | 'failed';\n\nexport type DownloadPhase = 'extracting' | 'downloading' | 'processing';\n\nexport interface Thumbnail {\n  url: string;\n  width?: number;\n  height?: number;\n  resolution?: string;\n  id?: string;\n}\n\n/** Normalized media information. Every field is optional except `formats`. */\nexport interface VideoInfo {\n  id?: string;\n  title?: string;\n  description?: string;\n  uploader?: string;\n  uploaderId?: string;\n  uploaderUrl?: string;\n  channel?: string;\n  channelId?: string;\n  channelUrl?: string;\n  webpageUrl?: string;\n  originalUrl?: string;\n  thumbnail?: string;\n  thumbnails?: Thumbnail[];\n  duration?: number;\n  durationString?: string;\n  uploadDate?: string;\n  timestamp?: number;\n  viewCount?: number;\n  likeCount?: number;\n  commentCount?: number;\n  ageLimit?: number;\n  isLive?: boolean;\n  wasLive?: boolean;\n  extractor?: string;\n  extractorKey?: string;\n  webpageUrlDomain?: string;\n  formats: Format[];\n}\n\n/** Normalized format model. Unknown native values become `undefined`. */\nexport interface Format {\n  id: string;\n  url?: string;\n  ext?: string;\n  protocol?: string;\n  format?: string;\n  formatNote?: string;\n  width?: number;\n  height?: number;\n  fps?: number;\n  vcodec?: string;\n  acodec?: string;\n  abr?: number;\n  vbr?: number;\n  tbr?: number;\n  filesize?: number;\n  filesizeApprox?: number;\n  quality?: number;\n  audioOnly: boolean;\n  videoOnly: boolean;\n  hasVideo: boolean;\n  hasAudio: boolean;\n  language?: string;\n  container?: string;\n}\n\nexport interface OutputOptions {\n  /**\n   * Directory name, relative to the app-specific external storage directory.\n   * Single path segments only; `..` is rejected.\n   */\n  directory?: string;\n  /**\n   * yt-dlp output template, e.g. `%(title)s.%(ext)s`.\n   * Static parts are sanitized; template directives are preserved.\n   */\n  filename?: string;\n}\n\nexport interface SubtitleOptions {\n  enabled?: boolean;\n  languages?: string[];\n  autoGenerated?: boolean;\n}\n\nexport interface CookieOptions {\n  source: 'file';\n  path: string;\n}\n\nexport interface NetworkOptions {\n  timeout?: number;\n  retries?: number;\n}\n\nexport interface PlaylistOptions {\n  enabled?: boolean;\n  start?: number;\n  end?: number;\n}\n\nexport interface ExtractOptions {\n  /** Cookies used during extraction (e.g. for login-gated sources). */\n  cookies?: CookieOptions;\n  /** Additional HTTP headers sent during extraction. Never logged. */\n  headers?: Record<string, string>;\n  /** Custom `User-Agent`. */\n  userAgent?: string;\n  proxy?: string;\n}\n\nexport interface DownloadOptions {\n  url: string;\n  /** Raw yt-dlp format expression, e.g. `best`, `bestvideo+bestaudio`. */\n  format?: string;\n  output?: OutputOptions;\n  merge?: boolean;\n  subtitles?: SubtitleOptions;\n  cookies?: CookieOptions;\n  /** Additional HTTP headers. Validated; secrets are never logged. */\n  headers?: Record<string, string>;\n  userAgent?: string;\n  referer?: string;\n  proxy?: string;\n  playlist?: PlaylistOptions;\n  network?: NetworkOptions;\n}\n\nexport interface DownloadProgress {\n  taskId: string;\n  status: DownloadStatus;\n  phase: DownloadPhase;\n  percent?: number;\n  downloadedBytes?: number;\n  totalBytes?: number;\n  speedBytesPerSecond?: number;\n  etaSeconds?: number;\n  filename?: string;\n}\n\nexport interface DownloadResult {\n  taskId: string;\n  path?: string;\n  uri?: string;\n  filename?: string;\n  mimeType?: string;\n  size?: number;\n  duration?: number;\n}\n\nexport type DownloadEventType = 'progress' | 'state' | 'completed' | 'error' | 'cancelled';\n\nexport interface DownloadEvent {\n  taskId: string;\n  type: DownloadEventType;\n  status: DownloadStatus;\n  phase: DownloadPhase;\n  progress?: DownloadProgress;\n  result?: DownloadResult;\n  error?: {\n    code: string;\n    message: string;\n  };\n}\n\nexport type DownloadStateEvent = {\n  taskId: string;\n  status: DownloadStatus;\n};\n\nexport interface Subscription {\n  remove(): void;\n}\n\nexport interface DownloadTask {\n  id: string;\n  cancel(): Promise<void>;\n  getStatus(): Promise<DownloadStatus>;\n  getProgress(): Promise<DownloadProgress | null>;\n  addListener(event: 'progress', listener: (progress: DownloadProgress) => void): Subscription;\n  addListener(event: 'state', listener: (state: DownloadStateEvent) => void): Subscription;\n  addListener(event: 'completed', listener: (result: DownloadResult) => void): Subscription;\n  addListener(event: 'error', listener: (error: YtDlpError) => void): Subscription;\n}\n\nexport interface YtDlpVersion {\n  ytDlp: string;\n  library: string;\n}\n\nexport type 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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Public types for expo-ytdlp-native.\n *\n * These types are the stable contract of the package. Native details never\n * leak into this surface (see AGENTS.md §68).\n */\nimport type { YtDlpError } from './errors';\n\nexport type DownloadStatus =\n  | 'queued'\n  | 'extracting'\n  | 'downloading'\n  | 'processing'\n  | 'paused'\n  | 'completed'\n  | 'cancelled'\n  | 'failed';\n\nexport type DownloadPhase = 'extracting' | 'downloading' | 'processing';\n\nexport interface Thumbnail {\n  url: string;\n  width?: number;\n  height?: number;\n  resolution?: string;\n  id?: string;\n}\n\n/** Normalized media information. Every field is optional except `formats`. */\nexport interface VideoInfo {\n  id?: string;\n  title?: string;\n  description?: string;\n  uploader?: string;\n  uploaderId?: string;\n  uploaderUrl?: string;\n  channel?: string;\n  channelId?: string;\n  channelUrl?: string;\n  webpageUrl?: string;\n  originalUrl?: string;\n  thumbnail?: string;\n  thumbnails?: Thumbnail[];\n  duration?: number;\n  durationString?: string;\n  uploadDate?: string;\n  timestamp?: number;\n  viewCount?: number;\n  likeCount?: number;\n  commentCount?: number;\n  ageLimit?: number;\n  isLive?: boolean;\n  wasLive?: boolean;\n  extractor?: string;\n  extractorKey?: string;\n  webpageUrlDomain?: string;\n  formats: Format[];\n}\n\n/** Normalized format model. Unknown native values become `undefined`. */\nexport interface Format {\n  id: string;\n  url?: string;\n  ext?: string;\n  protocol?: string;\n  format?: string;\n  formatNote?: string;\n  width?: number;\n  height?: number;\n  fps?: number;\n  vcodec?: string;\n  acodec?: string;\n  abr?: number;\n  vbr?: number;\n  tbr?: number;\n  filesize?: number;\n  filesizeApprox?: number;\n  quality?: number;\n  audioOnly: boolean;\n  videoOnly: boolean;\n  hasVideo: boolean;\n  hasAudio: boolean;\n  language?: string;\n  container?: string;\n}\n\nexport interface OutputOptions {\n  /**\n   * Directory name, relative to the app-specific external storage directory.\n   * Single path segments only; `..` is rejected.\n   */\n  directory?: string;\n  /**\n   * yt-dlp output template, e.g. `%(title)s.%(ext)s`.\n   * Static parts are sanitized; template directives are preserved.\n   */\n  filename?: string;\n}\n\nexport interface SubtitleOptions {\n  enabled?: boolean;\n  languages?: string[];\n  autoGenerated?: boolean;\n}\n\nexport interface CookieOptions {\n  source: 'file';\n  path: string;\n}\n\nexport interface NetworkOptions {\n  timeout?: number;\n  retries?: number;\n}\n\n/**\n * Optional FFmpeg integration (see issue #2). The package does **not** bundle\n * FFmpeg — yt-dlp needs a real executable to merge separate video+audio\n * streams (`bestvideo+bestaudio`), extract/re-encode audio, or embed metadata\n * and thumbnails. Point `location` at an ffmpeg binary already on the device.\n */\nexport interface FfmpegOptions {\n  /**\n   * Absolute filesystem path to an `ffmpeg` executable, or to a directory\n   * that contains one. yt-dlp spawns the binary from here during\n   * post-processing. An in-process JNI wrapper (e.g. FFmpegKit) is not enough.\n   */\n  location: string;\n}\n\nexport interface PlaylistOptions {\n  enabled?: boolean;\n  start?: number;\n  end?: number;\n}\n\nexport interface ExtractOptions {\n  /** Cookies used during extraction (e.g. for login-gated sources). */\n  cookies?: CookieOptions;\n  /** Additional HTTP headers sent during extraction. Never logged. */\n  headers?: Record<string, string>;\n  /** Custom `User-Agent`. */\n  userAgent?: string;\n  proxy?: string;\n}\n\nexport interface DownloadOptions {\n  url: string;\n  /** Raw yt-dlp format expression, e.g. `best`, `bestvideo+bestaudio`. */\n  format?: string;\n  output?: OutputOptions;\n  /**\n   * Set to `true` to request merging (e.g. with `format: 'bestvideo+bestaudio'`).\n   * Merging requires FFmpeg — see `ffmpeg`.\n   */\n  merge?: boolean;\n  /**\n   * Optional FFmpeg integration. When unset, FFmpeg-dependent features are\n   * rejected with `PROCESSING_FAILED`. When set, `bestvideo+bestaudio` and\n   * other post-processing become available.\n   */\n  ffmpeg?: FfmpegOptions;\n  subtitles?: SubtitleOptions;\n  cookies?: CookieOptions;\n  /** Additional HTTP headers. Validated; secrets are never logged. */\n  headers?: Record<string, string>;\n  userAgent?: string;\n  referer?: string;\n  proxy?: string;\n  playlist?: PlaylistOptions;\n  network?: NetworkOptions;\n}\n\nexport interface DownloadProgress {\n  taskId: string;\n  status: DownloadStatus;\n  phase: DownloadPhase;\n  percent?: number;\n  downloadedBytes?: number;\n  totalBytes?: number;\n  speedBytesPerSecond?: number;\n  etaSeconds?: number;\n  filename?: string;\n}\n\nexport interface DownloadResult {\n  taskId: string;\n  path?: string;\n  uri?: string;\n  filename?: string;\n  mimeType?: string;\n  size?: number;\n  duration?: number;\n}\n\nexport type DownloadEventType = 'progress' | 'state' | 'completed' | 'error' | 'cancelled';\n\nexport interface DownloadEvent {\n  taskId: string;\n  type: DownloadEventType;\n  status: DownloadStatus;\n  phase: DownloadPhase;\n  progress?: DownloadProgress;\n  result?: DownloadResult;\n  error?: {\n    code: string;\n    message: string;\n  };\n}\n\nexport type DownloadStateEvent = {\n  taskId: string;\n  status: DownloadStatus;\n};\n\nexport interface Subscription {\n  remove(): void;\n}\n\nexport interface DownloadTask {\n  id: string;\n  cancel(): Promise<void>;\n  /**\n   * Pause an in-flight download. yt-dlp aborts on the next progress tick and\n   * leaves its `.part` file on disk; the task remains registered with status\n   * `paused`. Resolves `false` if the task is unknown, already paused, or\n   * already finished.\n   */\n  pause(): Promise<boolean>;\n  /**\n   * Resume a paused download with the exact same options. yt-dlp continues\n   * from the `.part` file by default (byte-range where the source supports it,\n   * otherwise the file restarts). Resolves `false` if the task is unknown or\n   * not paused.\n   */\n  resume(): Promise<boolean>;\n  getStatus(): Promise<DownloadStatus>;\n  getProgress(): Promise<DownloadProgress | null>;\n  addListener(event: 'progress', listener: (progress: DownloadProgress) => void): Subscription;\n  addListener(event: 'state', listener: (state: DownloadStateEvent) => void): Subscription;\n  addListener(event: 'completed', listener: (result: DownloadResult) => void): Subscription;\n  addListener(event: 'error', listener: (error: YtDlpError) => void): Subscription;\n}\n\nexport interface YtDlpVersion {\n  ytDlp: string;\n  library: string;\n}\n\nexport type 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ytdlp-react-native",
-  "version": "1.0.0",
+  "version": "1.1.0-beta.0",
   "description": "A native Android Expo module providing a TypeScript API around yt-dlp.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -17,6 +17,7 @@
     "build": "node internal/module_scripts/build.js",
     "clean": "node internal/module_scripts/clean.js",
     "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
     "test": "node internal/module_scripts/test.js",
     "prepare": "node internal/module_scripts/prepare.js",
     "open:ios": "node internal/module_scripts/open-ios.js",
@@ -42,15 +43,16 @@
   "devDependencies": {
     "@babel/core": "^7.26.0",
     "@types/jest": "^29.2.1",
-    "@types/react": "~19.1.1",
-    "babel-preset-expo": "~55.0.8",
+    "@types/react": "~19.2.18",
+    "babel-preset-expo": "~57.0.10",
     "eslint": "~9.39.4",
     "eslint-config-universe": "^15.0.3",
     "expo": "^57.0.13",
     "jest": "^29.7.0",
-    "jest-expo": "~55.0.9",
+    "jest-expo": "~57.0.5",
     "prettier": "^3.0.0",
-    "react-native": "0.82.1",
+    "react": "~19.2.3",
+    "react-native": "~0.86.3",
     "typescript": "^5.9.2"
   },
   "jest": {

package/src/ExpoYtDlpModule.ts

@@ -34,6 +34,8 @@ export declare class ExpoYtDlpNativeModule extends NativeModule<ExpoYtDlpModuleE
   extractInfo(url: string, options: Record<string, unknown>): Promise<string>;
   startDownload(options: Record<string, unknown>): Promise<DownloadTaskInfo>;
   cancelDownload(taskId: string): Promise<boolean>;
+  pauseDownload(taskId: string): Promise<boolean>;
+  resumeDownload(taskId: string): Promise<boolean>;
   getDownloadStatus(taskId: string): Promise<DownloadStatusInfo | null>;
 }
 

package/src/YtDlp.ts

@@ -3,8 +3,8 @@ import { LIBRARY_VERSION, SUPPORTED_PLATFORM_MESSAGE } from './constants';
 import { YtDlpDownloadTask } from './downloadTask';
 import { normalizeError, normalizeExtractionError, YtDlpError } from './errors';
 import { mapVideoInfo } from './mappers';
+import { serializeDownloadOptions, serializeExtractOptions } from './serializers';
 import type {
-  CookieOptions,
   DownloadOptions,
   DownloadTask,
   ExtractOptions,
@@ -88,64 +88,28 @@ export async function cancel(taskId: string): Promise<boolean> {
   }
 }
 
-function serializeExtractOptions(options: ExtractOptions | undefined): Record<string, unknown> {
-  if (!options) return {};
-  const out: Record<string, unknown> = {};
-  if (options.cookies) out.cookies = serializeCookies(options.cookies);
-  if (options.proxy) out.proxy = options.proxy;
-  if (options.userAgent || options.headers) {
-    const headers: Record<string, string> = { ...(options.headers ?? {}) };
-    if (options.userAgent) headers['User-Agent'] = options.userAgent;
-    out.headers = headers;
-  }
-  return out;
-}
-
-function serializeDownloadOptions(options: DownloadOptions): Record<string, unknown> {
-  const out: Record<string, unknown> = { url: options.url };
-  if (options.format) out.format = options.format;
-  if (options.output) {
-    const output: Record<string, unknown> = {};
-    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: Record<string, string> = { ...(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: Record<string, unknown> = {};
-    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: Record<string, unknown> = {};
-    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: Record<string, unknown> = {};
-    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;
+/**
+ * Pause an in-flight download by task id. Returns `false` if the task is
+ * unknown, already paused, or already finished.
+ */
+export async function pause(taskId: string): Promise<boolean> {
+  try {
+    const native = requireNative();
+    return await native.pauseDownload(taskId);
+  } catch (cause) {
+    throw normalizeError(cause);
   }
-  return out;
 }
 
-function serializeCookies(cookies: CookieOptions): Record<string, unknown> {
-  if (cookies.source === 'file' && cookies.path) {
-    return { path: cookies.path };
+/**
+ * Resume a paused download by task id. Returns `false` if the task is unknown
+ * or not paused. yt-dlp continues from the partial `.part` file by default.
+ */
+export async function resume(taskId: string): Promise<boolean> {
+  try {
+    const native = requireNative();
+    return await native.resumeDownload(taskId);
+  } catch (cause) {
+    throw normalizeError(cause);
   }
-  throw new YtDlpError('INVALID_URL', 'Cookies must reference a cookies file path.');
 }

package/src/__tests__/errors.test.ts

@@ -0,0 +1,117 @@
+import { YtDlpError, fromNativeCode, normalizeError, normalizeExtractionError } from '../errors';
+
+describe('YtDlpError', () => {
+  it('exposes code, message and optional metadata', () => {
+    const error = new YtDlpError('CANCELLED', 'Download cancelled', { taskId: 'abc' });
+    expect(error).toBeInstanceOf(Error);
+    expect(error.name).toBe('YtDlpError');
+    expect(error.code).toBe('CANCELLED');
+    expect(error.message).toBe('Download cancelled');
+    expect(error.taskId).toBe('abc');
+  });
+
+  it('keeps taskId/cause undefined when not provided', () => {
+    const error = new YtDlpError('UNKNOWN', 'boom');
+    expect(error.taskId).toBeUndefined();
+    expect(error.cause).toBeUndefined();
+  });
+});
+
+describe('normalizeError', () => {
+  it('passes through an existing YtDlpError unchanged', () => {
+    const original = new YtDlpError('INVALID_URL', 'nope');
+    expect(normalizeError(original)).toBe(original);
+  });
+
+  it('parses native-prefixed messages into a typed error', () => {
+    const error = normalizeError(new Error('YTD_NATIVE|GEO_RESTRICTED|Blocked'));
+    expect(error).toBeInstanceOf(YtDlpError);
+    expect(error.code).toBe('GEO_RESTRICTED');
+    expect(error.message).toBe('Blocked');
+  });
+
+  it('accepts native-prefixed string throws', () => {
+    const error = normalizeError('YTD_NATIVE|NETWORK_ERROR|timeout');
+    expect(error.code).toBe('NETWORK_ERROR');
+    expect(error.message).toBe('timeout');
+  });
+
+  it('maps unknown native codes to UNKNOWN', () => {
+    const error = normalizeError(new Error('YTD_NATIVE|NOT_A_REAL_CODE|oops'));
+    expect(error.code).toBe('UNKNOWN');
+  });
+
+  it('falls back to UNKNOWN for plain errors without leaking stack traces', () => {
+    const error = normalizeError(new Error('kaboom'));
+    expect(error.code).toBe('UNKNOWN');
+    expect(error.message).toBe('kaboom');
+  });
+
+  it('uses the fallback message for non-error, non-string causes', () => {
+    const error = normalizeError({ weird: true }, 'Fallback');
+    expect(error.code).toBe('UNKNOWN');
+    expect(error.message).toBe('Fallback');
+  });
+});
+
+describe('fromNativeCode', () => {
+  it('builds an error from a code and message', () => {
+    const error = fromNativeCode('STORAGE_ERROR', 'No space');
+    expect(error.code).toBe('STORAGE_ERROR');
+    expect(error.message).toBe('No space');
+  });
+
+  it('degrades unknown codes to UNKNOWN', () => {
+    const error = fromNativeCode('BOGUS', 'x');
+    expect(error.code).toBe('UNKNOWN');
+  });
+});
+
+describe('normalizeExtractionError', () => {
+  it('passes through a non-extraction normalized error untouched', () => {
+    const error = normalizeExtractionError(new Error('YTD_NATIVE|CANCELLED|stopped'));
+    expect(error.code).toBe('CANCELLED');
+  });
+
+  it('classifies connection failures as NETWORK_ERROR', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|HTTP Error 429')
+    );
+    expect(error.code).toBe('NETWORK_ERROR');
+  });
+
+  it('classifies sign-in prompts as AUTHENTICATION_REQUIRED', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|Please sign in to confirm you are not a bot')
+    );
+    expect(error.code).toBe('AUTHENTICATION_REQUIRED');
+  });
+
+  it('classifies private content', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|This video is private')
+    );
+    expect(error.code).toBe('PRIVATE_CONTENT');
+  });
+
+  it('classifies age-restricted content', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|Sign in to confirm your age')
+    );
+    expect(error.code).toBe('AGE_RESTRICTED');
+  });
+
+  it('classifies geo-restricted content', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|Not available in your country')
+    );
+    expect(error.code).toBe('GEO_RESTRICTED');
+  });
+
+  it('keeps the base code when nothing matches', () => {
+    const error = normalizeExtractionError(
+      new Error('YTD_NATIVE|EXTRACTION_FAILED|Unsupported URL')
+    );
+    expect(error.code).toBe('EXTRACTION_FAILED');
+  });
+});