ytdlp-react-native 1.0.0

package/build/events.js

@@ -0,0 +1,96 @@
+/**
+ * Shared helpers for reacting to native `downloadEvent` emissions.
+ */
+import { NativeExpoYtDlp } from './ExpoYtDlpModule';
+import { fromNativeCode } from './errors';
+const EVENT_NAME = 'downloadEvent';
+/**
+ * Returns a per-task subscription backed by the native event stream.
+ * `taskId` is used to filter events that belong to another task.
+ */
+export function subscribeToTask(taskId, handler) {
+    return subscribeToDownloadEvents((event) => {
+        if (event.taskId === taskId) {
+            handler(event);
+        }
+    });
+}
+export function subscribeToDownloadEvents(handler) {
+    if (!NativeExpoYtDlp) {
+        return { remove: () => { } };
+    }
+    // The native module is itself an EventEmitter (Expo SDK 52+); the old
+    // `new NativeEventEmitter(module)` path requires `addListener`/`removeListeners`
+    // that Expo modules do not expose.
+    const subscription = NativeExpoYtDlp.addListener(EVENT_NAME, (event) => {
+        try {
+            handler(normalizeEvent(event));
+        }
+        catch {
+            // Never let a listener crash the JS runtime.
+        }
+    });
+    return { remove: () => subscription.remove() };
+}
+/**
+ * Adds task-level listeners to a [DownloadTask] from a raw subscription
+ * factory. Keeps the event filtering in one place.
+ */
+export function attachTaskListeners(taskId, listeners) {
+    const subs = [];
+    subs.push(subscribeToTask(taskId, (event) => {
+        switch (event.type) {
+            case 'progress':
+                if (event.progress && listeners.progress)
+                    listeners.progress(event.progress);
+                break;
+            case 'state':
+                if (listeners.state)
+                    listeners.state({ taskId: event.taskId, status: event.status });
+                break;
+            case 'completed':
+                if (event.result && listeners.completed)
+                    listeners.completed(event.result);
+                break;
+            case 'cancelled':
+                if (listeners.cancelled)
+                    listeners.cancelled();
+                if (listeners.state)
+                    listeners.state({ taskId: event.taskId, status: 'cancelled' });
+                break;
+            case 'error':
+                if (event.error) {
+                    const error = fromNativeCode(event.error.code, event.error.message);
+                    if (listeners.error)
+                        listeners.error(error);
+                }
+                break;
+        }
+    }));
+    return subs;
+}
+function normalizeEvent(event) {
+    if (event.type === 'progress' && event.progress) {
+        return {
+            ...event,
+            progress: {
+                taskId: event.taskId,
+                status: event.status,
+                phase: event.progress.phase,
+                percent: finiteOrUndefined(event.progress.percent),
+                downloadedBytes: finiteOrUndefined(event.progress.downloadedBytes),
+                totalBytes: finiteOrUndefined(event.progress.totalBytes),
+                speedBytesPerSecond: finiteOrUndefined(event.progress.speedBytesPerSecond),
+                etaSeconds: finiteOrUndefined(event.progress.etaSeconds),
+                filename: event.progress.filename,
+            },
+        };
+    }
+    return event;
+}
+function finiteOrUndefined(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=events.js.map

package/build/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared helpers for reacting to native `downloadEvent` emissions.\n */\nimport { NativeExpoYtDlp } from './ExpoYtDlpModule';\nimport { fromNativeCode, type YtDlpError } from './errors';\nimport type {\n  DownloadEvent,\n  DownloadProgress,\n  DownloadResult,\n  DownloadStateEvent,\n  Subscription,\n} from './types';\n\nconst EVENT_NAME = 'downloadEvent';\n\n/**\n * Returns a per-task subscription backed by the native event stream.\n * `taskId` is used to filter events that belong to another task.\n */\nexport function subscribeToTask(\n  taskId: string,\n  handler: (event: DownloadEvent) => void\n): Subscription {\n  return subscribeToDownloadEvents((event) => {\n    if (event.taskId === taskId) {\n      handler(event);\n    }\n  });\n}\n\nexport function subscribeToDownloadEvents(handler: (event: DownloadEvent) => void): Subscription {\n  if (!NativeExpoYtDlp) {\n    return { remove: () => {} };\n  }\n  // The native module is itself an EventEmitter (Expo SDK 52+); the old\n  // `new NativeEventEmitter(module)` path requires `addListener`/`removeListeners`\n  // that Expo modules do not expose.\n  const subscription = NativeExpoYtDlp.addListener(EVENT_NAME, (event: DownloadEvent) => {\n    try {\n      handler(normalizeEvent(event));\n    } catch {\n      // Never let a listener crash the JS runtime.\n    }\n  });\n  return { remove: () => subscription.remove() };\n}\n\n/**\n * Adds task-level listeners to a [DownloadTask] from a raw subscription\n * factory. Keeps the event filtering in one place.\n */\nexport function attachTaskListeners(\n  taskId: string,\n  listeners: {\n    progress?: (progress: DownloadProgress) => void;\n    state?: (state: DownloadStateEvent) => void;\n    completed?: (result: DownloadResult) => void;\n    cancelled?: () => void;\n    error?: (error: YtDlpError) => void;\n  }\n): Subscription[] {\n  const subs: Subscription[] = [];\n\n  subs.push(\n    subscribeToTask(taskId, (event) => {\n      switch (event.type) {\n        case 'progress':\n          if (event.progress && listeners.progress) listeners.progress(event.progress);\n          break;\n        case 'state':\n          if (listeners.state) listeners.state({ taskId: event.taskId, status: event.status });\n          break;\n        case 'completed':\n          if (event.result && listeners.completed) listeners.completed(event.result);\n          break;\n        case 'cancelled':\n          if (listeners.cancelled) listeners.cancelled();\n          if (listeners.state) listeners.state({ taskId: event.taskId, status: 'cancelled' });\n          break;\n        case 'error':\n          if (event.error) {\n            const error = fromNativeCode(event.error.code, event.error.message);\n            if (listeners.error) listeners.error(error);\n          }\n          break;\n      }\n    })\n  );\n\n  return subs;\n}\n\nfunction normalizeEvent(event: DownloadEvent): DownloadEvent {\n  if (event.type === 'progress' && event.progress) {\n    return {\n      ...event,\n      progress: {\n        taskId: event.taskId,\n        status: event.status,\n        phase: event.progress.phase,\n        percent: finiteOrUndefined(event.progress.percent),\n        downloadedBytes: finiteOrUndefined(event.progress.downloadedBytes),\n        totalBytes: finiteOrUndefined(event.progress.totalBytes),\n        speedBytesPerSecond: finiteOrUndefined(event.progress.speedBytesPerSecond),\n        etaSeconds: finiteOrUndefined(event.progress.etaSeconds),\n        filename: event.progress.filename,\n      },\n    };\n  }\n  return event;\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/index.d.ts

@@ -0,0 +1,14 @@
+import { cancel, download, extractInfo, getFormats, getVersion } from './YtDlp';
+import { YtDlpError } from './errors';
+export type * from './types';
+/** Main SDK facade. */
+export declare const YtDlp: {
+    getVersion: typeof getVersion;
+    extractInfo: typeof extractInfo;
+    getFormats: typeof getFormats;
+    download: typeof download;
+    cancel: typeof cancel;
+};
+export { YtDlpError };
+export default YtDlp;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,mBAAmB,SAAS,CAAC;AAE7B,uBAAuB;AACvB,eAAO,MAAM,KAAK;;;;;;CAMjB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAe,KAAK,CAAC"}

package/build/index.js

@@ -0,0 +1,13 @@
+import { cancel, download, extractInfo, getFormats, getVersion } from './YtDlp';
+import { YtDlpError } from './errors';
+/** Main SDK facade. */
+export const YtDlp = {
+    getVersion,
+    extractInfo,
+    getFormats,
+    download,
+    cancel,
+};
+export { YtDlpError };
+export default YtDlp;
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAItC,uBAAuB;AACvB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU;IACV,WAAW;IACX,UAAU;IACV,QAAQ;IACR,MAAM;CACP,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,eAAe,KAAK,CAAC","sourcesContent":["import { cancel, download, extractInfo, getFormats, getVersion } from './YtDlp';\nimport { YtDlpError } from './errors';\n\nexport type * from './types';\n\n/** Main SDK facade. */\nexport const YtDlp = {\n  getVersion,\n  extractInfo,\n  getFormats,\n  download,\n  cancel,\n};\n\nexport { YtDlpError };\n\nexport default YtDlp;\n"]}

package/build/mappers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Mapping from the raw JSON produced by yt-dlp into the stable public types.
+ *
+ * Everything is defensive: unknown fields become `undefined`, never fake
+ * values (see AGENTS.md §11, §69, §70).
+ */
+import type { DownloadProgress, Format, VideoInfo } from './types';
+export declare function mapVideoInfo(raw: unknown): VideoInfo;
+export declare function mapFormat(raw: unknown): Format;
+/**
+ * Maps the raw progress payload from the native `downloadEvent` into a
+ * `DownloadProgress`, replacing any non-finite numbers with `undefined`.
+ */
+export declare function mapDownloadProgress(raw: unknown, taskId: string): DownloadProgress | null;
+//# sourceMappingURL=mappers.d.ts.map

package/build/mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAa,SAAS,EAAE,MAAM,SAAS,CAAC;AAM9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAqCpD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgC9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAkBzF"}

package/build/mappers.js

@@ -0,0 +1,149 @@
+const NONE_CODEC = 'none';
+export function mapVideoInfo(raw) {
+    const info = asRecord(raw);
+    const formats = Array.isArray(info.formats) ? info.formats.map(mapFormat) : [];
+    const liveStatus = stringOf(info.live_status);
+    const thumbnails = normalizeThumbnails(info.thumbnails, stringOf(info.thumbnail));
+    return {
+        id: stringOf(info.id),
+        title: stringOf(info.title),
+        description: stringOf(info.description),
+        uploader: stringOf(info.uploader),
+        uploaderId: stringOf(info.uploader_id),
+        uploaderUrl: stringOf(info.uploader_url),
+        channel: stringOf(info.channel),
+        channelId: stringOf(info.channel_id),
+        channelUrl: stringOf(info.channel_url),
+        webpageUrl: stringOf(info.webpage_url),
+        originalUrl: stringOf(info.original_url),
+        thumbnail: firstThumbnailUrl(thumbnails) ?? stringOf(info.thumbnail),
+        thumbnails,
+        duration: numberOf(info.duration),
+        durationString: stringOf(info.duration_string),
+        uploadDate: stringOf(info.upload_date),
+        timestamp: numberOf(info.timestamp),
+        viewCount: numberOf(info.view_count),
+        likeCount: numberOf(info.like_count),
+        commentCount: numberOf(info.comment_count),
+        ageLimit: numberOf(info.age_limit),
+        isLive: liveStatus === 'is_live',
+        wasLive: liveStatus === 'was_live',
+        extractor: stringOf(info.extractor),
+        extractorKey: stringOf(info.extractor_key),
+        webpageUrlDomain: stringOf(info.webpage_url_domain),
+        formats,
+    };
+}
+export function mapFormat(raw) {
+    const format = asRecord(raw);
+    const vcodec = stringOf(format.vcodec);
+    const acodec = stringOf(format.acodec);
+    const hasVideo = vcodec !== undefined && vcodec.toLowerCase() !== NONE_CODEC;
+    const hasAudio = acodec !== undefined && acodec.toLowerCase() !== NONE_CODEC;
+    return {
+        id: stringOf(format.format_id) ?? stringOf(format.id) ?? '',
+        url: stringOf(format.url),
+        ext: stringOf(format.ext),
+        protocol: stringOf(format.protocol),
+        format: stringOf(format.format),
+        formatNote: stringOf(format.format_note),
+        width: numberOf(format.width),
+        height: numberOf(format.height),
+        fps: numberOf(format.fps),
+        vcodec,
+        acodec,
+        abr: numberOf(format.abr),
+        vbr: numberOf(format.vbr),
+        tbr: numberOf(format.tbr),
+        filesize: numberOf(format.filesize),
+        filesizeApprox: numberOf(format.filesize_approx),
+        quality: numberOf(format.quality),
+        audioOnly: hasAudio && !hasVideo,
+        videoOnly: hasVideo && !hasAudio,
+        hasVideo,
+        hasAudio,
+        language: stringOf(format.language),
+        container: stringOf(format.container),
+    };
+}
+/**
+ * Maps the raw progress payload from the native `downloadEvent` into a
+ * `DownloadProgress`, replacing any non-finite numbers with `undefined`.
+ */
+export function mapDownloadProgress(raw, taskId) {
+    const progress = asRecord(raw);
+    if (!progress)
+        return null;
+    const percent = numberOf(progress.percent);
+    const phaseRaw = stringOf(progress.phase);
+    return {
+        taskId,
+        status: statusOf(progress.status),
+        phase: phaseRaw === 'extracting' || phaseRaw === 'processing' ? phaseRaw : 'downloading',
+        percent,
+        downloadedBytes: numberOf(progress.downloadedBytes),
+        totalBytes: numberOf(progress.totalBytes),
+        speedBytesPerSecond: numberOf(progress.speedBytesPerSecond),
+        etaSeconds: numberOf(progress.etaSeconds),
+        filename: stringOf(progress.filename),
+    };
+}
+function statusOf(value) {
+    const s = stringOf(value);
+    switch (s) {
+        case 'queued':
+        case 'extracting':
+        case 'downloading':
+        case 'processing':
+        case 'completed':
+        case 'cancelled':
+        case 'failed':
+            return s;
+        default:
+            return 'downloading';
+    }
+}
+function normalizeThumbnails(value, fallbackUrl) {
+    const result = [];
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const record = asRecord(item);
+            const url = stringOf(record.url);
+            if (!url)
+                continue;
+            result.push({
+                url,
+                width: numberOf(record.width),
+                height: numberOf(record.height),
+                resolution: stringOf(record.resolution),
+                id: stringOf(record.id),
+            });
+        }
+    }
+    if (result.length === 0 && fallbackUrl) {
+        result.push({ url: fallbackUrl });
+    }
+    return result;
+}
+function firstThumbnailUrl(thumbnails) {
+    return thumbnails[0]?.url;
+}
+function stringOf(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    return undefined;
+}
+function numberOf(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '' && Number.isFinite(Number(value))) {
+        return Number(value);
+    }
+    return undefined;
+}
+function asRecord(value) {
+    if (typeof value === 'object' && value !== null)
+        return value;
+    return {};
+}
+//# sourceMappingURL=mappers.js.map

package/build/mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mapping from the raw JSON produced by yt-dlp into the stable public types.\n *\n * Everything is defensive: unknown fields become `undefined`, never fake\n * values (see AGENTS.md §11, §69, §70).\n */\nimport type { DownloadProgress, Format, Thumbnail, VideoInfo } from './types';\n\ntype RawRecord = Record<string, unknown>;\n\nconst NONE_CODEC = 'none';\n\nexport function mapVideoInfo(raw: unknown): VideoInfo {\n  const info = asRecord(raw);\n\n  const formats = Array.isArray(info.formats) ? info.formats.map(mapFormat) : [];\n\n  const liveStatus = stringOf(info.live_status);\n  const thumbnails = normalizeThumbnails(info.thumbnails, stringOf(info.thumbnail));\n\n  return {\n    id: stringOf(info.id),\n    title: stringOf(info.title),\n    description: stringOf(info.description),\n    uploader: stringOf(info.uploader),\n    uploaderId: stringOf(info.uploader_id),\n    uploaderUrl: stringOf(info.uploader_url),\n    channel: stringOf(info.channel),\n    channelId: stringOf(info.channel_id),\n    channelUrl: stringOf(info.channel_url),\n    webpageUrl: stringOf(info.webpage_url),\n    originalUrl: stringOf(info.original_url),\n    thumbnail: firstThumbnailUrl(thumbnails) ?? stringOf(info.thumbnail),\n    thumbnails,\n    duration: numberOf(info.duration),\n    durationString: stringOf(info.duration_string),\n    uploadDate: stringOf(info.upload_date),\n    timestamp: numberOf(info.timestamp),\n    viewCount: numberOf(info.view_count),\n    likeCount: numberOf(info.like_count),\n    commentCount: numberOf(info.comment_count),\n    ageLimit: numberOf(info.age_limit),\n    isLive: liveStatus === 'is_live',\n    wasLive: liveStatus === 'was_live',\n    extractor: stringOf(info.extractor),\n    extractorKey: stringOf(info.extractor_key),\n    webpageUrlDomain: stringOf(info.webpage_url_domain),\n    formats,\n  };\n}\n\nexport function mapFormat(raw: unknown): Format {\n  const format = asRecord(raw);\n  const vcodec = stringOf(format.vcodec);\n  const acodec = stringOf(format.acodec);\n  const hasVideo = vcodec !== undefined && vcodec.toLowerCase() !== NONE_CODEC;\n  const hasAudio = acodec !== undefined && acodec.toLowerCase() !== NONE_CODEC;\n\n  return {\n    id: stringOf(format.format_id) ?? stringOf(format.id) ?? '',\n    url: stringOf(format.url),\n    ext: stringOf(format.ext),\n    protocol: stringOf(format.protocol),\n    format: stringOf(format.format),\n    formatNote: stringOf(format.format_note),\n    width: numberOf(format.width),\n    height: numberOf(format.height),\n    fps: numberOf(format.fps),\n    vcodec,\n    acodec,\n    abr: numberOf(format.abr),\n    vbr: numberOf(format.vbr),\n    tbr: numberOf(format.tbr),\n    filesize: numberOf(format.filesize),\n    filesizeApprox: numberOf(format.filesize_approx),\n    quality: numberOf(format.quality),\n    audioOnly: hasAudio && !hasVideo,\n    videoOnly: hasVideo && !hasAudio,\n    hasVideo,\n    hasAudio,\n    language: stringOf(format.language),\n    container: stringOf(format.container),\n  };\n}\n\n/**\n * Maps the raw progress payload from the native `downloadEvent` into a\n * `DownloadProgress`, replacing any non-finite numbers with `undefined`.\n */\nexport function mapDownloadProgress(raw: unknown, taskId: string): DownloadProgress | null {\n  const progress = asRecord(raw);\n  if (!progress) return null;\n\n  const percent = numberOf(progress.percent);\n  const phaseRaw = stringOf(progress.phase);\n\n  return {\n    taskId,\n    status: statusOf(progress.status),\n    phase: phaseRaw === 'extracting' || phaseRaw === 'processing' ? phaseRaw : 'downloading',\n    percent,\n    downloadedBytes: numberOf(progress.downloadedBytes),\n    totalBytes: numberOf(progress.totalBytes),\n    speedBytesPerSecond: numberOf(progress.speedBytesPerSecond),\n    etaSeconds: numberOf(progress.etaSeconds),\n    filename: stringOf(progress.filename),\n  };\n}\n\nfunction statusOf(value: unknown): DownloadProgress['status'] {\n  const s = stringOf(value);\n  switch (s) {\n    case 'queued':\n    case 'extracting':\n    case 'downloading':\n    case 'processing':\n    case 'completed':\n    case 'cancelled':\n    case 'failed':\n      return s;\n    default:\n      return 'downloading';\n  }\n}\n\nfunction normalizeThumbnails(value: unknown, fallbackUrl?: string): Thumbnail[] {\n  const result: Thumbnail[] = [];\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      const record = asRecord(item);\n      const url = stringOf(record.url);\n      if (!url) continue;\n      result.push({\n        url,\n        width: numberOf(record.width),\n        height: numberOf(record.height),\n        resolution: stringOf(record.resolution),\n        id: stringOf(record.id),\n      });\n    }\n  }\n  if (result.length === 0 && fallbackUrl) {\n    result.push({ url: fallbackUrl });\n  }\n  return result;\n}\n\nfunction firstThumbnailUrl(thumbnails: Thumbnail[]): string | undefined {\n  return thumbnails[0]?.url;\n}\n\nfunction stringOf(value: unknown): string | undefined {\n  if (typeof value === 'string' && value.length > 0) return value;\n  return undefined;\n}\n\nfunction numberOf(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && value.trim() !== '' && Number.isFinite(Number(value))) {\n    return Number(value);\n  }\n  return undefined;\n}\n\nfunction asRecord(value: unknown): RawRecord {\n  if (typeof value === 'object' && value !== null) return value as RawRecord;\n  return {};\n}\n"]}

package/build/types.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Public types for expo-ytdlp-native.
+ *
+ * These types are the stable contract of the package. Native details never
+ * 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 DownloadPhase = 'extracting' | 'downloading' | 'processing';
+export interface Thumbnail {
+    url: string;
+    width?: number;
+    height?: number;
+    resolution?: string;
+    id?: string;
+}
+/** Normalized media information. Every field is optional except `formats`. */
+export interface VideoInfo {
+    id?: string;
+    title?: string;
+    description?: string;
+    uploader?: string;
+    uploaderId?: string;
+    uploaderUrl?: string;
+    channel?: string;
+    channelId?: string;
+    channelUrl?: string;
+    webpageUrl?: string;
+    originalUrl?: string;
+    thumbnail?: string;
+    thumbnails?: Thumbnail[];
+    duration?: number;
+    durationString?: string;
+    uploadDate?: string;
+    timestamp?: number;
+    viewCount?: number;
+    likeCount?: number;
+    commentCount?: number;
+    ageLimit?: number;
+    isLive?: boolean;
+    wasLive?: boolean;
+    extractor?: string;
+    extractorKey?: string;
+    webpageUrlDomain?: string;
+    formats: Format[];
+}
+/** Normalized format model. Unknown native values become `undefined`. */
+export interface Format {
+    id: string;
+    url?: string;
+    ext?: string;
+    protocol?: string;
+    format?: string;
+    formatNote?: string;
+    width?: number;
+    height?: number;
+    fps?: number;
+    vcodec?: string;
+    acodec?: string;
+    abr?: number;
+    vbr?: number;
+    tbr?: number;
+    filesize?: number;
+    filesizeApprox?: number;
+    quality?: number;
+    audioOnly: boolean;
+    videoOnly: boolean;
+    hasVideo: boolean;
+    hasAudio: boolean;
+    language?: string;
+    container?: string;
+}
+export interface OutputOptions {
+    /**
+     * Directory name, relative to the app-specific external storage directory.
+     * Single path segments only; `..` is rejected.
+     */
+    directory?: string;
+    /**
+     * yt-dlp output template, e.g. `%(title)s.%(ext)s`.
+     * Static parts are sanitized; template directives are preserved.
+     */
+    filename?: string;
+}
+export interface SubtitleOptions {
+    enabled?: boolean;
+    languages?: string[];
+    autoGenerated?: boolean;
+}
+export interface CookieOptions {
+    source: 'file';
+    path: string;
+}
+export interface NetworkOptions {
+    timeout?: number;
+    retries?: number;
+}
+export interface PlaylistOptions {
+    enabled?: boolean;
+    start?: number;
+    end?: number;
+}
+export interface ExtractOptions {
+    /** Cookies used during extraction (e.g. for login-gated sources). */
+    cookies?: CookieOptions;
+    /** Additional HTTP headers sent during extraction. Never logged. */
+    headers?: Record<string, string>;
+    /** Custom `User-Agent`. */
+    userAgent?: string;
+    proxy?: string;
+}
+export interface DownloadOptions {
+    url: string;
+    /** Raw yt-dlp format expression, e.g. `best`, `bestvideo+bestaudio`. */
+    format?: string;
+    output?: OutputOptions;
+    merge?: boolean;
+    subtitles?: SubtitleOptions;
+    cookies?: CookieOptions;
+    /** Additional HTTP headers. Validated; secrets are never logged. */
+    headers?: Record<string, string>;
+    userAgent?: string;
+    referer?: string;
+    proxy?: string;
+    playlist?: PlaylistOptions;
+    network?: NetworkOptions;
+}
+export interface DownloadProgress {
+    taskId: string;
+    status: DownloadStatus;
+    phase: DownloadPhase;
+    percent?: number;
+    downloadedBytes?: number;
+    totalBytes?: number;
+    speedBytesPerSecond?: number;
+    etaSeconds?: number;
+    filename?: string;
+}
+export interface DownloadResult {
+    taskId: string;
+    path?: string;
+    uri?: string;
+    filename?: string;
+    mimeType?: string;
+    size?: number;
+    duration?: number;
+}
+export type DownloadEventType = 'progress' | 'state' | 'completed' | 'error' | 'cancelled';
+export interface DownloadEvent {
+    taskId: string;
+    type: DownloadEventType;
+    status: DownloadStatus;
+    phase: DownloadPhase;
+    progress?: DownloadProgress;
+    result?: DownloadResult;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type DownloadStateEvent = {
+    taskId: string;
+    status: DownloadStatus;
+};
+export interface Subscription {
+    remove(): void;
+}
+export interface DownloadTask {
+    id: string;
+    cancel(): Promise<void>;
+    getStatus(): Promise<DownloadStatus>;
+    getProgress(): Promise<DownloadProgress | null>;
+    addListener(event: 'progress', listener: (progress: DownloadProgress) => void): Subscription;
+    addListener(event: 'state', listener: (state: DownloadStateEvent) => void): Subscription;
+    addListener(event: 'completed', listener: (result: DownloadResult) => void): Subscription;
+    addListener(event: 'error', listener: (error: YtDlpError) => void): Subscription;
+}
+export interface YtDlpVersion {
+    ytDlp: string;
+    library: string;
+}
+export type YtDlpErrorCode = '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';
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

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

package/build/types.js

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

package/build/types.js.map

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

package/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["android"],
+  "android": {
+    "modules": ["expo.modules.ytdlp.ExpoYtDlpModule"]
+  }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "ytdlp-react-native",
+  "version": "1.0.0",
+  "description": "A native Android Expo module providing a TypeScript API around yt-dlp.",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "files": [
+    "android",
+    "build",
+    "src",
+    "expo-module.config.json",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node internal/module_scripts/build.js",
+    "clean": "node internal/module_scripts/clean.js",
+    "lint": "eslint src/",
+    "test": "node internal/module_scripts/test.js",
+    "prepare": "node internal/module_scripts/prepare.js",
+    "open:ios": "node internal/module_scripts/open-ios.js",
+    "open:android": "node internal/module_scripts/open-android.js"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "ytdlp-react-native",
+    "ExpoYtDlp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devusimple/ytdlp-react-native.git"
+  },
+  "bugs": {
+    "url": "https://github.com/devusimple/ytdlp-react-native/issues"
+  },
+  "author": "Mehedi Hasan <huzzat2@gmail.com> (devusimple)",
+  "license": "MIT",
+  "homepage": "https://github.com/devusimple/ytdlp-react-native#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@babel/core": "^7.26.0",
+    "@types/jest": "^29.2.1",
+    "@types/react": "~19.1.1",
+    "babel-preset-expo": "~55.0.8",
+    "eslint": "~9.39.4",
+    "eslint-config-universe": "^15.0.3",
+    "expo": "^57.0.13",
+    "jest": "^29.7.0",
+    "jest-expo": "~55.0.9",
+    "prettier": "^3.0.0",
+    "react-native": "0.82.1",
+    "typescript": "^5.9.2"
+  },
+  "jest": {
+    "preset": "jest-expo",
+    "roots": [
+      "<rootDir>/src"
+    ]
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "expo-modules-core": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}