react-native-compressor 1.7.2 → 1.8.1

package/README.md

@@ -17,9 +17,9 @@
 **REACT-NATIVE-COMPRESSOR** is a react-native package, which helps us to Compress `Image`, `Video`, and `Audio` before uploading, same like **Whatsapp** without knowing the compression `algorithm`
 
 <div align="center">
-<img height="90" src="/media/whatsapp_logo.png"/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<img height="90" src="/media/compress_media.png"/>
+<pre>
+<img height="90" src="/media/whatsapp_logo.png"/>               <img height="90" src="/media/compress_media.png"/>
+</pre>
 <h2 align="center">🗜️Compress Image, Video, and Audio same like Whatsapp</h2>
 </div>
 
@@ -53,9 +53,7 @@ We should use **react-native-compressor** instead of **FFmpeg** because **react-
 <summary>Open Table of Contents</summary>
 
 - [Installation](#installation)
-  - [For React Native](#react-native)
-    - [For React Native<0.65](#for-react-native065)
-    - [For React Native 0.65 or greater](#for-react-native-065-or-greater)
+  - [For React Native](#Installation)
   - [Managed Expo](#managed-expo)
 - [Usage](#usage)
   - [Image](#image)
@@ -69,6 +67,7 @@ We should use **react-native-compressor** instead of **FFmpeg** because **react-
     - [Video Api Docs](#video-1)
   - [Audio](#audio)
   - [Background Upload](#background-upload)
+  - [Download File](#download)
 
 * [Other Utilities](#api)
   - [Background Upload](#background-upload-1)
@@ -85,7 +84,7 @@ yarn add react-native-compressor
 
 ### [New Architecture (Turbo Module)](https://reactnative.dev/docs/new-architecture-intro) Supported
 
-you can give feedback on [Discord channel](https://discord.gg/dtYzk8sp)
+you can give feedback on [Discord channel](https://discord.gg/6Wx8Em8KAN)
 
 ### Managed Expo
 
@@ -164,6 +163,7 @@ import { Image } from 'react-native-compressor';
 const result = await Image.compress('file://path_of_file/image.jpg');
 // OR
 const result = await Image.compress('https://path_of_file/image.jpg', {
+  progressDivider: 10,
   downloadProgress: (progress) => {
     console.log('downloadProgress: ', progress);
   },
@@ -204,6 +204,7 @@ const result = await Video.compress(
 const result = await Video.compress(
   'https://example.com/video.mp4',
   {
+    progressDivider: 10,
     downloadProgress: (progress) => {
       console.log('downloadProgress: ', progress);
     },
@@ -288,6 +289,26 @@ const uploadResult = await backgroundUpload(
 );
 ```
 
+### Download File
+
+```js
+import { download } from 'react-native-compressor';
+
+const downloadFileUrl = await download(url, (progress) => {
+  console.log('downloadProgress: ', progress);
+});
+```
+
+### Video Thumbnail
+
+```js
+import { createVideoThumbnail, clearCache } from 'react-native-compressor';
+
+const thumbnail = await createVideoThumbnail(videoUri);
+
+await clearCache(); // this will clear cache of thumbnails cache directory
+```
+
 # API
 
 ## Image
@@ -308,6 +329,10 @@ const uploadResult = await backgroundUpload(
 
   it is callback, only trigger when we pass image url from server
 
+- ##### `progressDivider?: number` (default: 0)
+
+  we uses it when we use downloadProgress
+
 - ###### `maxWidth: number` (default: 1280)
 
   The maximum width boundary used as the main boundary in resizing a landscape image.
@@ -348,6 +373,10 @@ const uploadResult = await backgroundUpload(
 
   it is callback, only trigger when we pass image url from server
 
+- ##### `progressDivider?: number` (default: 0)
+
+  we uses it when we use downloadProgress/onProgress
+
 - ###### `maxSize: number` (default: 640)
 
   The maximum size can be height in case of portrait video or can be width in case of landscape video.
@@ -376,7 +405,7 @@ const uploadResult = await backgroundUpload(
 
 ## Background Upload
 
-- ###### `backgroundUpload: (url: string, fileUrl: string, options: FileSystemUploadOptions, onProgress?: ((writtem: number, total: number) => void) | undefined) => Promise<any>
+- ###### backgroundUpload: (url: string, fileUrl: string, options: FileSystemUploadOptions, onProgress?: ((writtem: number, total: number) => void) | undefined) => Promise< any >
 
 - ###### ` FileSystemUploadOptions`
 
@@ -398,6 +427,20 @@ type FileSystemUploadOptions = (
 };
 ```
 
+### Download
+
+- ##### download: ( fileUrl: string, downloadProgress?: (progress: number) => void, progressDivider?: number ) => Promise< string >
+
+### Create Video Thumbnail and clear cache
+
+- #### createVideoThumbnail( fileUrl: string, options: {header:Object} ): Promise<{ path: string;size: number; mime: string; width: number; height: number; }>
+
+  it will save the thumbnail of the video into the cache directory and return the thumbnail URI which you can display
+
+- #### clearCache(cacheDir?: string): Promise< string >
+
+  it will clear the cache that was created from createVideoThumbnail, in future this clear cache will be totally customized
+
 ### Get Metadata Of Video
 
 if you want to get metadata of video than you can use this function

package/android/build.gradle

@@ -1,4 +1,7 @@
 buildscript {
+   // Buildscript is evaluated before everything else so we can't use getExtOrDefault
+  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["Compressor_kotlinVersion"]
+
   repositories {
     google()
     mavenCentral()
@@ -6,6 +9,8 @@ buildscript {
 
   dependencies {
     classpath "com.android.tools.build:gradle:7.2.1"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
 }
 
@@ -14,6 +19,7 @@ def isNewArchitectureEnabled() {
 }
 
 apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
 
 
 def appProject = rootProject.allprojects.find { it.plugins.hasPlugin('com.android.application') }
@@ -96,12 +102,15 @@ repositories {
   google()
 }
 
+def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
   // For < 0.71, this will be from the local maven repo
   // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
   //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-native:+"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation 'commons-io:commons-io:2.8.0'
   implementation 'io.github.lizhangqu:coreprogress:1.0.2'
   implementation 'com.github.numandev1:VideoCompressor:1a262bba37'
 }