react-native-tpstreams 0.2.15 → 0.2.16

package/README.md

@@ -117,15 +117,39 @@ import { TPStreamsPlayerView } from "react-native-tpstreams";
 
 - `getAllDownloads()`: Gets all downloaded videos. Returns `Promise<DownloadItem[]>`.
 
+### Real-time Download Progress
+
+The library provides real-time download progress updates for optimal performance:
+
+#### Progress Listener Methods
+
+- `addDownloadProgressListener()`: Starts listening for download progress updates. Returns `Promise<void>`.
+
+- `removeDownloadProgressListener()`: Stops listening for download progress updates. Returns `Promise<void>`.
+
+- `onDownloadProgressChanged(listener: DownloadProgressListener)`: Adds a listener for progress changes. Returns `EmitterSubscription`.
+
+#### Progress Listener Types
+
+```typescript
+// Progress update event (uses existing DownloadItem interface)
+type DownloadProgressChange = DownloadItem;
+
+// Listener function type
+type DownloadProgressListener = (downloads: DownloadProgressChange[]) => void;
+```
+
 ### Download Item
 
 The download item object (`DownloadItem`) contains information about a downloaded or downloading video, including:
 
-- `assetId`: The ID of the video.
-- `state`: The current state of the download as String (Queued, Downloading, Completed, Failed, Removing, Restarting, Paused ).
-- `progressPercentage`: Download progress from 0 to 100.
-- `title`: The title of the video Asset.
+- `videoId`: The ID of the video.
+- `title`: The title of the video.
 - `thumbnailUrl`: URL to the video thumbnail (if available).
+- `totalBytes`: Total size of the video in bytes.
+- `downloadedBytes`: Number of bytes downloaded so far.
+- `progressPercentage`: Download progress from 0 to 100.
+- `state`: The current state of the download as String (Queued, Downloading, Completed, Failed, Removing, Restarting, Paused).
 - `metadata`: Custom metadata attached to the download as a JSON string (if provided during download).
 
 ---
@@ -299,6 +323,285 @@ const removeVideoDownload = async (videoId: string) => {
 };
 ```
 
+## Real-time Download Progress Example
+
+Here's a complete example showing how to implement real-time download progress in a React Native component:
+
+```jsx
+import React, { useState, useEffect } from 'react';
+import {
+  View,
+  Text,
+  StyleSheet,
+  TouchableOpacity,
+  ScrollView,
+  Alert,
+} from 'react-native';
+import {
+  addDownloadProgressListener,
+  removeDownloadProgressListener,
+  onDownloadProgressChanged,
+  pauseDownload,
+  resumeDownload,
+  removeDownload,
+  type DownloadItem,
+  type DownloadProgressChange,
+} from 'react-native-tpstreams';
+
+const DownloadProgressExample = () => {
+  const [downloads, setDownloads] = useState<DownloadItem[]>([]);
+  const [isInitializing, setIsInitializing] = useState(true);
+
+  useEffect(() => {
+    // Setup progress listener when component mounts
+    const setupProgressListener = async () => {
+      try {
+        // Start listening for progress updates
+        await addDownloadProgressListener();
+        
+        // Add listener for progress updates
+        const subscription = onDownloadProgressChanged((downloads: DownloadProgressChange[]) => {
+          console.log('Progress changes received:', downloads.length, 'downloads');
+          
+          // Simply replace the state with the complete list from native
+          setDownloads(downloads);
+        });
+
+        // Cleanup function
+        return () => {
+          subscription.remove(); // Remove the listener
+          removeDownloadProgressListener(); // Stop listening
+        };
+      } catch (error) {
+        console.error('Failed to setup progress listener:', error);
+        setIsInitializing(false);
+      }
+    };
+
+    setupProgressListener();
+  }, []);
+
+  const handlePauseDownload = async (videoId: string) => {
+    try {
+      await pauseDownload(videoId);
+      console.log('Download paused successfully');
+    } catch (error) {
+      console.error('Error pausing download:', error);
+      Alert.alert('Error', 'Failed to pause download');
+    }
+  };
+
+  const handleResumeDownload = async (videoId: string) => {
+    try {
+      await resumeDownload(videoId);
+      console.log('Download resumed successfully');
+    } catch (error) {
+      console.error('Error resuming download:', error);
+      Alert.alert('Error', 'Failed to resume download');
+    }
+  };
+
+  const handleRemoveDownload = async (videoId: string) => {
+    try {
+      await removeDownload(videoId);
+      console.log('Download removed successfully');
+    } catch (error) {
+      console.error('Error removing download:', error);
+      Alert.alert('Error', 'Failed to remove download');
+    }
+  };
+
+  const renderDownloadItem = (item: DownloadItem) => {
+    const isCompleted = item.state === 'Completed';
+    const isDownloading = item.state === 'Downloading';
+    const isPaused = item.state === 'Paused';
+
+    return (
+      <View key={item.videoId} style={styles.downloadItem}>
+        <Text style={styles.title}>{item.title}</Text>
+        <Text style={styles.status}>Status: {item.state}</Text>
+        
+        {!isCompleted && (
+          <View style={styles.progressContainer}>
+            <View style={styles.progressBar}>
+              <View 
+                style={[
+                  styles.progressFill, 
+                  { width: `${item.progressPercentage}%` }
+                ]} 
+              />
+            </View>
+            <Text style={styles.progressText}>
+              {item.progressPercentage.toFixed(1)}%
+            </Text>
+          </View>
+        )}
+        
+        {item.totalBytes > 0 && (
+          <Text style={styles.bytesText}>
+            {(item.downloadedBytes / (1024 * 1024)).toFixed(1)} MB / 
+            {(item.totalBytes / (1024 * 1024)).toFixed(1)} MB
+          </Text>
+        )}
+        
+        <View style={styles.buttonContainer}>
+          {!isCompleted && (
+            <>
+              {isDownloading && (
+                <TouchableOpacity
+                  style={styles.button}
+                  onPress={() => handlePauseDownload(item.videoId)}
+                >
+                  <Text style={styles.buttonText}>Pause</Text>
+                </TouchableOpacity>
+              )}
+              
+              {isPaused && (
+                <TouchableOpacity
+                  style={styles.button}
+                  onPress={() => handleResumeDownload(item.videoId)}
+                >
+                  <Text style={styles.buttonText}>Resume</Text>
+                </TouchableOpacity>
+              )}
+            </>
+          )}
+          
+          <TouchableOpacity
+            style={[styles.button, styles.removeButton]}
+            onPress={() => handleRemoveDownload(item.videoId)}
+          >
+            <Text style={styles.buttonText}>Remove</Text>
+          </TouchableOpacity>
+        </View>
+      </View>
+    );
+  };
+
+  if (isInitializing) {
+    return (
+      <View style={styles.container}>
+        <Text>Loading downloads...</Text>
+      </View>
+    );
+  }
+
+  return (
+    <ScrollView style={styles.container}>
+      <Text style={styles.header}>Downloads ({downloads.length})</Text>
+      
+      {downloads.length > 0 ? (
+        downloads.map(renderDownloadItem)
+      ) : (
+        <Text style={styles.emptyText}>No downloads available</Text>
+      )}
+    </ScrollView>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    padding: 16,
+    backgroundColor: '#f5f5f5',
+  },
+  header: {
+    fontSize: 20,
+    fontWeight: 'bold',
+    marginBottom: 16,
+  },
+  downloadItem: {
+    backgroundColor: '#fff',
+    padding: 16,
+    marginBottom: 12,
+    borderRadius: 8,
+    shadowColor: '#000',
+    shadowOffset: { width: 0, height: 2 },
+    shadowOpacity: 0.1,
+    shadowRadius: 4,
+    elevation: 3,
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: 'bold',
+    marginBottom: 8,
+  },
+  status: {
+    fontSize: 14,
+    color: '#666',
+    marginBottom: 8,
+  },
+  progressContainer: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    marginBottom: 8,
+  },
+  progressBar: {
+    flex: 1,
+    height: 8,
+    backgroundColor: '#eee',
+    borderRadius: 4,
+    marginRight: 12,
+  },
+  progressFill: {
+    height: '100%',
+    backgroundColor: '#007AFF',
+    borderRadius: 4,
+  },
+  progressText: {
+    fontSize: 12,
+    color: '#666',
+    width: 40,
+  },
+  bytesText: {
+    fontSize: 12,
+    color: '#666',
+    marginBottom: 12,
+  },
+  buttonContainer: {
+    flexDirection: 'row',
+    gap: 8,
+  },
+  button: {
+    paddingVertical: 8,
+    paddingHorizontal: 16,
+    backgroundColor: '#007AFF',
+    borderRadius: 6,
+  },
+  removeButton: {
+    backgroundColor: '#FF3B30',
+  },
+  buttonText: {
+    color: '#fff',
+    fontSize: 14,
+    fontWeight: '600',
+  },
+  emptyText: {
+    textAlign: 'center',
+    color: '#666',
+    fontSize: 16,
+  },
+});
+
+export default DownloadProgressExample;
+```
+
+### Key Features of the Real-time Progress System:
+
+1. **Real-time Updates**: Progress bars and status update in real-time
+2. **Automatic UI Updates**: UI automatically reflects current download states
+3. **Efficient State Management**: Uses functional state updates to avoid race conditions
+4. **Proper Cleanup**: Removes listeners when component unmounts
+5. **Error Handling**: Graceful error handling with user feedback
+6. **Type Safety**: Full TypeScript support with proper types
+
+### Best Practices:
+
+1. **Start listening when needed**: Only start the progress listener when your screen is active
+2. **Stop listening when not needed**: Always stop listening to save resources
+3. **Use functional state updates**: Prevents race conditions with concurrent updates
+4. **Debounce if needed**: Consider debouncing updates for better UI performance
+
 ---
 
 ## Contributing

package/android/gradle.properties

@@ -3,4 +3,4 @@ Tpstreams_minSdkVersion=24
 Tpstreams_targetSdkVersion=34
 Tpstreams_compileSdkVersion=35
 Tpstreams_ndkVersion=27.1.12297006
-Tpstreams_tpstreamsAndroidPlayerVersion=1.0.11
+Tpstreams_tpstreamsAndroidPlayerVersion=1.0.13

package/android/src/main/java/com/tpstreams/TPStreamsDownloadModule.kt

@@ -6,19 +6,89 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.tpstreams.player.download.DownloadClient
 import com.tpstreams.player.download.DownloadItem
 
-class TPStreamsDownloadModule(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+class TPStreamsDownloadModule(private val reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext), DownloadClient.Listener {
 
     private val downloadClient: DownloadClient by lazy {
         DownloadClient.getInstance(reactContext)
     }
 
+    private var isListening = false
+
     override fun getName(): String {
         return "TPStreamsDownload"
     }
 
+    @ReactMethod
+    fun addDownloadProgressListener(promise: Promise) {
+        try {
+            if (!isListening) {
+                downloadClient.addListener(this)
+                isListening = true
+                Log.d(TAG, "Started listening for download progress")
+            }
+            promise.resolve(null)
+        } catch (e: Exception) {
+            Log.e(TAG, "Error starting progress listener: ${e.message}", e)
+            promise.reject("PROGRESS_LISTENER_START_ERROR", e.message, e)
+        }
+    }
+
+    @ReactMethod
+    fun removeDownloadProgressListener(promise: Promise) {
+        try {
+            if (isListening) {
+                downloadClient.removeListener(this)
+                isListening = false
+                Log.d(TAG, "Stopped listening for download progress")
+            }
+            promise.resolve(null)
+        } catch (e: Exception) {
+            Log.e(TAG, "Error stopping progress listener: ${e.message}", e)
+            promise.reject("PROGRESS_LISTENER_STOP_ERROR", e.message, e)
+        }
+    }
+
+    override fun onDownloadsChanged() {
+        try {
+            val currentDownloads = downloadClient.getAllDownloadItems()
+            
+            val result = Arguments.createArray()
+            for (item in currentDownloads) {
+                val map = Arguments.createMap()
+                map.putString("videoId", item.assetId)
+                map.putString("title", item.title)
+                item.thumbnailUrl?.let { map.putString("thumbnailUrl", it) }
+                map.putDouble("totalBytes", item.totalBytes.toDouble())
+                map.putDouble("downloadedBytes", item.downloadedBytes.toDouble())
+                map.putDouble("progressPercentage", item.progressPercentage.toDouble())
+                map.putString("state", downloadClient.getDownloadStatus(item.assetId))
+                
+                val metadataJson = org.json.JSONObject()
+                item.metadata.forEach { (key, value) ->
+                    metadataJson.put(key, value)
+                }
+                map.putString("metadata", metadataJson.toString())
+                
+                result.pushMap(map)
+            }
+            
+            emitEvent("onDownloadProgressChanged", result)
+                
+        } catch (e: Exception) {
+            Log.e(TAG, "Error in onDownloadsChanged: ${e.message}", e)
+        }
+    }
+
+    private fun emitEvent(eventName: String, data: Any) {
+        reactContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit(eventName, data)
+    }
+
     @ReactMethod
     fun pauseDownload(videoId: String, promise: Promise) {
         try {

package/lib/module/TPStreamsDownload.js

@@ -1,9 +1,19 @@
 "use strict";
 
-import { NativeModules } from 'react-native';
+import { NativeModules, NativeEventEmitter } from 'react-native';
 const {
   TPStreamsDownload
 } = NativeModules;
+const downloadEventEmitter = new NativeEventEmitter(TPStreamsDownload);
+export function addDownloadProgressListener() {
+  return TPStreamsDownload.addDownloadProgressListener();
+}
+export function removeDownloadProgressListener() {
+  return TPStreamsDownload.removeDownloadProgressListener();
+}
+export function onDownloadProgressChanged(listener) {
+  return downloadEventEmitter.addListener('onDownloadProgressChanged', listener);
+}
 export function pauseDownload(videoId) {
   return TPStreamsDownload.pauseDownload(videoId);
 }

package/lib/module/TPStreamsDownload.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","TPStreamsDownload","pauseDownload","videoId","resumeDownload","removeDownload","isDownloaded","isDownloading","isPaused","getDownloadStatus","getAllDownloads"],"sourceRoot":"../../src","sources":["TPStreamsDownload.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAE5C,MAAM;EAAEC;AAAkB,CAAC,GAAGD,aAAa;AAa3C,OAAO,SAASE,aAAaA,CAACC,OAAe,EAAiB;EAC5D,OAAOF,iBAAiB,CAACC,aAAa,CAACC,OAAO,CAAC;AACjD;AAEA,OAAO,SAASC,cAAcA,CAACD,OAAe,EAAiB;EAC7D,OAAOF,iBAAiB,CAACG,cAAc,CAACD,OAAO,CAAC;AAClD;AAEA,OAAO,SAASE,cAAcA,CAACF,OAAe,EAAiB;EAC7D,OAAOF,iBAAiB,CAACI,cAAc,CAACF,OAAO,CAAC;AAClD;AAEA,OAAO,SAASG,YAAYA,CAACH,OAAe,EAAoB;EAC9D,OAAOF,iBAAiB,CAACK,YAAY,CAACH,OAAO,CAAC;AAChD;AAEA,OAAO,SAASI,aAAaA,CAACJ,OAAe,EAAoB;EAC/D,OAAOF,iBAAiB,CAACM,aAAa,CAACJ,OAAO,CAAC;AACjD;AAEA,OAAO,SAASK,QAAQA,CAACL,OAAe,EAAoB;EAC1D,OAAOF,iBAAiB,CAACO,QAAQ,CAACL,OAAO,CAAC;AAC5C;AAEA,OAAO,SAASM,iBAAiBA,CAACN,OAAe,EAAmB;EAClE,OAAOF,iBAAiB,CAACQ,iBAAiB,CAACN,OAAO,CAAC;AACrD;AAEA,OAAO,SAASO,eAAeA,CAAA,EAA4B;EACzD,OAAOT,iBAAiB,CAACS,eAAe,CAAC,CAAC;AAC5C","ignoreList":[]}
+{"version":3,"names":["NativeModules","NativeEventEmitter","TPStreamsDownload","downloadEventEmitter","addDownloadProgressListener","removeDownloadProgressListener","onDownloadProgressChanged","listener","addListener","pauseDownload","videoId","resumeDownload","removeDownload","isDownloaded","isDownloading","isPaused","getDownloadStatus","getAllDownloads"],"sourceRoot":"../../src","sources":["TPStreamsDownload.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,kBAAkB,QAAQ,cAAc;AAGhE,MAAM;EAAEC;AAAkB,CAAC,GAAGF,aAAa;AAkB3C,MAAMG,oBAAoB,GAAG,IAAIF,kBAAkB,CAACC,iBAAiB,CAAC;AAEtE,OAAO,SAASE,2BAA2BA,CAAA,EAAkB;EAC3D,OAAOF,iBAAiB,CAACE,2BAA2B,CAAC,CAAC;AACxD;AAEA,OAAO,SAASC,8BAA8BA,CAAA,EAAkB;EAC9D,OAAOH,iBAAiB,CAACG,8BAA8B,CAAC,CAAC;AAC3D;AAEA,OAAO,SAASC,yBAAyBA,CACvCC,QAAkC,EACb;EACrB,OAAOJ,oBAAoB,CAACK,WAAW,CACrC,2BAA2B,EAC3BD,QACF,CAAC;AACH;AAEA,OAAO,SAASE,aAAaA,CAACC,OAAe,EAAiB;EAC5D,OAAOR,iBAAiB,CAACO,aAAa,CAACC,OAAO,CAAC;AACjD;AAEA,OAAO,SAASC,cAAcA,CAACD,OAAe,EAAiB;EAC7D,OAAOR,iBAAiB,CAACS,cAAc,CAACD,OAAO,CAAC;AAClD;AAEA,OAAO,SAASE,cAAcA,CAACF,OAAe,EAAiB;EAC7D,OAAOR,iBAAiB,CAACU,cAAc,CAACF,OAAO,CAAC;AAClD;AAEA,OAAO,SAASG,YAAYA,CAACH,OAAe,EAAoB;EAC9D,OAAOR,iBAAiB,CAACW,YAAY,CAACH,OAAO,CAAC;AAChD;AAEA,OAAO,SAASI,aAAaA,CAACJ,OAAe,EAAoB;EAC/D,OAAOR,iBAAiB,CAACY,aAAa,CAACJ,OAAO,CAAC;AACjD;AAEA,OAAO,SAASK,QAAQA,CAACL,OAAe,EAAoB;EAC1D,OAAOR,iBAAiB,CAACa,QAAQ,CAACL,OAAO,CAAC;AAC5C;AAEA,OAAO,SAASM,iBAAiBA,CAACN,OAAe,EAAmB;EAClE,OAAOR,iBAAiB,CAACc,iBAAiB,CAACN,OAAO,CAAC;AACrD;AAEA,OAAO,SAASO,eAAeA,CAAA,EAA4B;EACzD,OAAOf,iBAAiB,CAACe,eAAe,CAAC,CAAC;AAC5C","ignoreList":[]}

package/lib/module/index.js

@@ -7,7 +7,7 @@ export * from './TPStreamsPlayerViewNativeComponent';
 
 // Export the wrapper component as TPStreamsPlayerView
 export { default as TPStreamsPlayerView } from "./TPStreamsPlayer.js";
-export { pauseDownload, resumeDownload, removeDownload, isDownloaded, isDownloading, isPaused, getDownloadStatus, getAllDownloads } from "./TPStreamsDownload.js";
+export { pauseDownload, resumeDownload, removeDownload, isDownloaded, isDownloading, isPaused, getDownloadStatus, getAllDownloads, addDownloadProgressListener, removeDownloadProgressListener, onDownloadProgressChanged } from "./TPStreamsDownload.js";
 const TPStreamsModule = NativeModules.TPStreams;
 export const TPStreams = {
   initialize: organizationId => {

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","default","TPStreamsPlayerNative","TPStreamsPlayerView","pauseDownload","resumeDownload","removeDownload","isDownloaded","isDownloading","isPaused","getDownloadStatus","getAllDownloads","TPStreamsModule","TPStreams","initialize","organizationId"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C;AACA,SAASC,OAAO,IAAIC,qBAAqB,QAAQ,sCAAsC;AACvF,cAAc,sCAAsC;;AAEpD;AACA,SAASD,OAAO,IAAIE,mBAAmB,QAAQ,sBAAmB;AAGlE,SACEC,aAAa,EACbC,cAAc,EACdC,cAAc,EACdC,YAAY,EACZC,aAAa,EACbC,QAAQ,EACRC,iBAAiB,EACjBC,eAAe,QAEV,wBAAqB;AAE5B,MAAMC,eAAe,GAAGZ,aAAa,CAACa,SAAS;AAE/C,OAAO,MAAMA,SAAS,GAAG;EACvBC,UAAU,EAAGC,cAAsB,IAAW;IAC5CH,eAAe,CAACE,UAAU,CAACC,cAAc,CAAC;EAC5C;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","default","TPStreamsPlayerNative","TPStreamsPlayerView","pauseDownload","resumeDownload","removeDownload","isDownloaded","isDownloading","isPaused","getDownloadStatus","getAllDownloads","addDownloadProgressListener","removeDownloadProgressListener","onDownloadProgressChanged","TPStreamsModule","TPStreams","initialize","organizationId"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C;AACA,SAASC,OAAO,IAAIC,qBAAqB,QAAQ,sCAAsC;AACvF,cAAc,sCAAsC;;AAEpD;AACA,SAASD,OAAO,IAAIE,mBAAmB,QAAQ,sBAAmB;AAGlE,SACEC,aAAa,EACbC,cAAc,EACdC,cAAc,EACdC,YAAY,EACZC,aAAa,EACbC,QAAQ,EACRC,iBAAiB,EACjBC,eAAe,EACfC,2BAA2B,EAC3BC,8BAA8B,EAC9BC,yBAAyB,QAIpB,wBAAqB;AAE5B,MAAMC,eAAe,GAAGf,aAAa,CAACgB,SAAS;AAE/C,OAAO,MAAMA,SAAS,GAAG;EACvBC,UAAU,EAAGC,cAAsB,IAAW;IAC5CH,eAAe,CAACE,UAAU,CAACC,cAAc,CAAC;EAC5C;AACF,CAAC","ignoreList":[]}

package/lib/typescript/src/TPStreamsDownload.d.ts

@@ -1,3 +1,4 @@
+import type { EmitterSubscription } from 'react-native';
 export interface DownloadItem {
     videoId: string;
     title: string;
@@ -8,6 +9,11 @@ export interface DownloadItem {
     state: string;
     metadata: string;
 }
+export type DownloadProgressChange = DownloadItem;
+export type DownloadProgressListener = (downloads: DownloadProgressChange[]) => void;
+export declare function addDownloadProgressListener(): Promise<void>;
+export declare function removeDownloadProgressListener(): Promise<void>;
+export declare function onDownloadProgressChanged(listener: DownloadProgressListener): EmitterSubscription;
 export declare function pauseDownload(videoId: string): Promise<void>;
 export declare function resumeDownload(videoId: string): Promise<void>;
 export declare function removeDownload(videoId: string): Promise<void>;

package/lib/typescript/src/TPStreamsDownload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TPStreamsDownload.d.ts","sourceRoot":"","sources":["../../../src/TPStreamsDownload.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAEzD"}
+{"version":3,"file":"TPStreamsDownload.d.ts","sourceRoot":"","sources":["../../../src/TPStreamsDownload.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAIxD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAClD,MAAM,MAAM,wBAAwB,GAAG,CACrC,SAAS,EAAE,sBAAsB,EAAE,KAChC,IAAI,CAAC;AAIV,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,wBAAwB,GACjC,mBAAmB,CAKrB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAEzD"}

package/lib/typescript/src/index.d.ts

@@ -2,7 +2,7 @@ export { default as TPStreamsPlayerNative } from './TPStreamsPlayerViewNativeCom
 export * from './TPStreamsPlayerViewNativeComponent';
 export { default as TPStreamsPlayerView } from './TPStreamsPlayer';
 export type { TPStreamsPlayerRef } from './TPStreamsPlayer';
-export { pauseDownload, resumeDownload, removeDownload, isDownloaded, isDownloading, isPaused, getDownloadStatus, getAllDownloads, type DownloadItem, } from './TPStreamsDownload';
+export { pauseDownload, resumeDownload, removeDownload, isDownloaded, isDownloading, isPaused, getDownloadStatus, getAllDownloads, addDownloadProgressListener, removeDownloadProgressListener, onDownloadProgressChanged, type DownloadItem, type DownloadProgressChange, type DownloadProgressListener, } from './TPStreamsDownload';
 export declare const TPStreams: {
     initialize: (organizationId: string) => void;
 };

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AACxF,cAAc,sCAAsC,CAAC;AAGrD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,SAAS;iCACS,MAAM,KAAG,IAAI;CAG3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AACxF,cAAc,sCAAsC,CAAC;AAGrD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,SAAS;iCACS,MAAM,KAAG,IAAI;CAG3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-tpstreams",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "Video component for TPStreams",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/TPStreamsDownload.tsx

@@ -1,4 +1,5 @@
-import { NativeModules } from 'react-native';
+import { NativeModules, NativeEventEmitter } from 'react-native';
+import type { EmitterSubscription } from 'react-native';
 
 const { TPStreamsDownload } = NativeModules;
 
@@ -13,6 +14,30 @@ export interface DownloadItem {
   metadata: string;
 }
 
+export type DownloadProgressChange = DownloadItem;
+export type DownloadProgressListener = (
+  downloads: DownloadProgressChange[]
+) => void;
+
+const downloadEventEmitter = new NativeEventEmitter(TPStreamsDownload);
+
+export function addDownloadProgressListener(): Promise<void> {
+  return TPStreamsDownload.addDownloadProgressListener();
+}
+
+export function removeDownloadProgressListener(): Promise<void> {
+  return TPStreamsDownload.removeDownloadProgressListener();
+}
+
+export function onDownloadProgressChanged(
+  listener: DownloadProgressListener
+): EmitterSubscription {
+  return downloadEventEmitter.addListener(
+    'onDownloadProgressChanged',
+    listener
+  );
+}
+
 export function pauseDownload(videoId: string): Promise<void> {
   return TPStreamsDownload.pauseDownload(videoId);
 }

package/src/index.tsx

@@ -16,7 +16,12 @@ export {
   isPaused,
   getDownloadStatus,
   getAllDownloads,
+  addDownloadProgressListener,
+  removeDownloadProgressListener,
+  onDownloadProgressChanged,
   type DownloadItem,
+  type DownloadProgressChange,
+  type DownloadProgressListener,
 } from './TPStreamsDownload';
 
 const TPStreamsModule = NativeModules.TPStreams;