react-native-pdf-jsi 2.2.7 → 3.0.0

package/README.md

@@ -3,19 +3,41 @@
 [![npm](https://img.shields.io/npm/v/react-native-pdf-jsi.svg?style=flat-square)](https://www.npmjs.com/package/react-native-pdf-jsi)
 [![Downloads](https://img.shields.io/npm/dm/react-native-pdf-jsi.svg?style=flat-square)](https://www.npmjs.com/package/react-native-pdf-jsi)
 [![GitHub stars](https://img.shields.io/github/stars/126punith/react-native-enhanced-pdf.svg?style=flat-square)](https://github.com/126punith/react-native-enhanced-pdf)
+[![Documentation](https://img.shields.io/badge/docs-online-blue.svg?style=flat-square)](https://euphonious-faun-24f4bc.netlify.app/)
 
 **The fastest React Native PDF viewer with JSI acceleration - up to 80x faster than traditional bridge!**
 
+## 🆓 100% FREE - All Features Included!
+
+**Every feature is FREE and MIT licensed - no hidden costs, no Pro tier, no subscriptions!**
+
+All advanced features that were previously paid are now completely FREE:
+- ✅ **Bookmarks with 10 Colors** - Create, organize with custom colors
+- ✅ **Reading Analytics** - Track progress, sessions, and insights  
+- ✅ **Export to Images** - PNG/JPEG export with quality control
+- ✅ **PDF Operations** - Split, merge, extract, rotate, delete pages
+- ✅ **PDF Compression** - Reduce file sizes with smart presets
+- ✅ **Text Extraction** - Extract and search text from PDFs
+- ✅ **File Management** - Download to storage, open folders (Android)
+- ✅ **All Performance Features** - JSI acceleration, smart caching
+
+**Use commercially without restrictions - MIT License!**
+
+📚 **[Complete Documentation Website](https://euphonious-faun-24f4bc.netlify.app/)** - API Reference, Guides, and Examples
+
 ### Key Advantages:
+- 🆓 **100% FREE** - All features MIT licensed, no subscriptions or hidden fees
 - ✅ **Google Play 16KB Compliant** - Ready for Android 15+ requirements
-- ⚡ **High Performance** - JSI integration for faster rendering
+- ⚡ **High Performance** - JSI integration for faster rendering (80x faster)
 - 🚀 **Easy Migration** - Drop-in replacement for existing PDF libraries
-- 📄 **Lazy Loading** - Optimized loading for large PDF files
+- 📄 **Advanced Features** - Bookmarks, analytics, export, compression all FREE
 - 🎯 **Smart Caching** - 30-day persistent cache system
-- 🛡️ **Future-Proof** - Built with latest NDK r27+ and modern toolchain
+- 🛡️ **Future-Proof** - Built with latest NDK r28.2+ and modern toolchain
 
 A high-performance React Native PDF viewer component with JSI (JavaScript Interface) integration for enhanced speed and efficiency. Perfect for large PDF files with lazy loading, smart caching, progressive loading, and zero-bridge overhead operations.
 
+**🎓 [Read Full Documentation](https://euphonious-faun-24f4bc.netlify.app/)** - Complete guides, API reference, and examples
+
 ## ✅ **Google Play 16KB Page Size Compliance**
 
 Starting November 1, 2025, Google Play will require apps to support 16KB page sizes for devices with Android 15+. **react-native-pdf-jsi is built with NDK r27+ and fully supports Android 15+ requirements**, ensuring your app meets Google Play policy requirements.
@@ -35,6 +57,35 @@ Starting November 1, 2025, Google Play will require apps to support 16KB page si
 - ✅ **Google Play Approved** - Meets all current and future requirements  
 - ✅ **Drop-in Replacement** - Easy migration from existing libraries
 
+## 🎉 Version 3.0.0 - Major Release with Complete Feature Sync!
+
+**Complete synchronization of all features from development package with enhanced Android capabilities!**
+
+### 🚀 **What's New in v3.0.0:**
+- **📦 Complete Feature Sync** - All features from local development package now in production
+- **📥 FileDownloader Module** - Native Android module for downloading files to public storage using MediaStore API
+- **📂 FileManager Module** - Native Android module for opening Downloads folder with multiple fallback strategies
+- **🔧 PDFTextExtractor Utility** - JavaScript wrapper for native text extraction with search capabilities
+- **✅ Enhanced Structure** - Complete src/utils directory with all utility modules
+- **✅ Android 10+ Support** - Scoped Storage compliant with MediaStore API for Android 10+
+- **✅ Legacy Support** - Backward compatible with Android 9 and below using legacy storage
+- **✅ Smart Notifications** - Download completion notifications with "Open Folder" action
+- **✅ Text Search & Statistics** - Advanced text extraction with search and statistics features
+- **✅ Production Ready** - All development features now available in stable release
+
+## 🎉 Version 2.2.8 - Android File Download & Management Features!
+
+**New Android native modules for file download and folder management with MediaStore API support!**
+
+### 🚀 **What's New in v2.2.8:**
+- **📥 FileDownloader Module** - Native Android module for downloading files to public storage using MediaStore API
+- **📂 FileManager Module** - Native Android module for opening Downloads folder with multiple fallback strategies
+- **✅ Android 10+ Support** - Scoped Storage compliant with MediaStore API for Android 10+
+- **✅ Legacy Support** - Backward compatible with Android 9 and below using legacy storage
+- **✅ Smart Notifications** - Download completion notifications with "Open Folder" action
+- **✅ Immediate Visibility** - Files are immediately visible in file managers after export
+- **✅ Multi-Strategy Folder Opening** - Multiple fallback strategies for maximum device compatibility
+
 ## 🎉 Version 2.2.7 - iOS Codegen Fix & New Architecture Support!
 
 **Critical fix for React Native 0.79+ compatibility and iOS codegen integration!**
@@ -170,9 +221,11 @@ Starting November 1, 2025, Google Play will require apps to support 16KB page si
 - **Enhanced Features**: Additional functionality out of the box
 - **Easy Upgrade**: Minimal code changes required
 
-## ✨ Features
+## ✨ Features - All FREE!
+
+**📚 [Explore All Features in Documentation](https://euphonious-faun-24f4bc.netlify.app/docs/features/core-features)**
 
-### Core Features
+### Core Features (FREE)
 * Read a PDF from URL, blob, local file or asset and can cache it
 * Display horizontally or vertically
 * Drag and zoom
@@ -180,7 +233,7 @@ Starting November 1, 2025, Google Play will require apps to support 16KB page si
 * Support password protected PDF
 * Jump to a specific page in the PDF
 
-### 🚀 JSI Enhanced Features
+### 🚀 JSI Enhanced Features (FREE)
 * **Zero Bridge Overhead** - Direct JavaScript-to-Native communication
 * **Enhanced Caching** - Multi-level intelligent caching system
 * **Batch Operations** - Process multiple operations efficiently
@@ -193,6 +246,19 @@ Starting November 1, 2025, Google Play will require apps to support 16KB page si
 * **React Hooks** - Easy integration with `usePDFJSI` hook
 * **Enhanced Components** - Drop-in replacement with automatic JSI detection
 
+### 🎁 Advanced Features (100% FREE!)
+* **📚 Bookmarks with 10 Colors** - Create, edit, delete bookmarks with custom colors and notes
+* **📊 Reading Analytics** - Track reading sessions, progress, speed, and engagement scores
+* **🖼️ Export to Images** - Export pages to PNG/JPEG with quality control
+* **📝 Export to Text** - Extract text from PDFs with search capabilities
+* **✂️ PDF Operations** - Split, merge, extract, rotate, and delete pages
+* **🗜️ PDF Compression** - Reduce file sizes with 5 smart presets (EMAIL, WEB, MOBILE, PRINT, ARCHIVE)
+* **🔍 Text Extraction** - Extract and search text with statistics and context
+* **📥 File Management** (Android) - Download to public storage, open folders with MediaStore API
+* **🎨 Professional UI Components** - Ready-to-use bookmark, analytics, and export components
+
+**All features work immediately - no activation, no license keys, no restrictions!**
+
 ## 📱 Supported Platforms
 
 - ✅ **Android** (with full JSI acceleration - up to 80x faster)
@@ -209,8 +275,12 @@ npm install react-native-pdf-jsi react-native-blob-util --save
 yarn add react-native-pdf-jsi react-native-blob-util
 ```
 
+**📚 Need help?** Check our [complete installation guide](https://euphonious-faun-24f4bc.netlify.app/docs/getting-started/installation) with platform-specific instructions.
+
 ## 🚀 **Quick Start**
 
+**📚 [See Quick Start Guide](https://euphonious-faun-24f4bc.netlify.app/docs/getting-started/quick-start)** for detailed instructions and more examples.
+
 ```jsx
 // Import the Pdf component from react-native-pdf-jsi
 const PdfModule = require('react-native-pdf-jsi');
@@ -345,6 +415,8 @@ protected List<ReactPackage> getPackages() {
 
 ## 📖 Usage
 
+**📚 [View Complete Documentation](https://euphonious-faun-24f4bc.netlify.app/)** - Detailed guides, API reference, and working examples
+
 ### Basic Usage
 
 ```jsx
@@ -696,6 +768,213 @@ export default function AdvancedJSIExample() {
 }
 ```
 
+## 📥 **Android File Download & Management** (v2.2.8+)
+
+The new Android native modules provide seamless file download and folder management capabilities with full Android 10+ Scoped Storage support.
+
+### FileDownloader Module
+
+Download files to public storage with automatic MediaStore API integration for Android 10+ and legacy support for older versions.
+
+#### **Features:**
+- ✅ **MediaStore API Support** - Android 10+ Scoped Storage compliant
+- ✅ **Legacy Storage** - Backward compatible with Android 9 and below
+- ✅ **Instant Visibility** - Files appear immediately in file managers
+- ✅ **Smart Notifications** - Download completion notifications with "Open Folder" action
+- ✅ **Multiple Formats** - Supports PDF, PNG, and JPEG files
+
+#### **Usage:**
+
+```jsx
+import { NativeModules } from 'react-native';
+const { FileDownloader } = NativeModules;
+
+// Download a file to public Downloads/PDFDemoApp folder
+const downloadFile = async () => {
+  try {
+    const sourcePath = '/path/to/cached/file.pdf';
+    const fileName = 'my-document.pdf';
+    const mimeType = 'application/pdf'; // or 'image/png', 'image/jpeg'
+    
+    const publicPath = await FileDownloader.downloadToPublicFolder(
+      sourcePath,
+      fileName,
+      mimeType
+    );
+    
+    console.log('✅ File downloaded to:', publicPath);
+    // Android 10+: /storage/emulated/0/Download/PDFDemoApp/my-document.pdf
+    
+  } catch (error) {
+    console.error('❌ Download failed:', error);
+  }
+};
+```
+
+#### **API:**
+
+```typescript
+FileDownloader.downloadToPublicFolder(
+  sourcePath: string,  // Path to source file in app's cache/internal storage
+  fileName: string,    // Desired file name
+  mimeType: string     // MIME type: 'application/pdf', 'image/png', 'image/jpeg'
+): Promise<string>     // Returns public file path
+```
+
+#### **How It Works:**
+- **Android 10+**: Uses MediaStore API to create entries in the Downloads collection with proper visibility
+- **Android 9 and below**: Uses legacy `Environment.getExternalStoragePublicDirectory()` with media scanner
+- **Automatic folder creation**: Creates `Downloads/PDFDemoApp` folder if it doesn't exist
+- **Progress notifications**: Shows notification with "Open Folder" action when download completes
+
+### FileManager Module
+
+Open the Downloads folder with multiple fallback strategies for maximum compatibility across Android devices.
+
+#### **Features:**
+- ✅ **Multi-Strategy Opening** - 4 different fallback strategies
+- ✅ **Maximum Compatibility** - Works with various file manager apps
+- ✅ **Graceful Degradation** - Automatically tries next strategy if one fails
+- ✅ **User-Friendly** - Opens specific folder or general file manager
+
+#### **Usage:**
+
+```jsx
+import { NativeModules, Alert } from 'react-native';
+const { FileManager } = NativeModules;
+
+// Open Downloads/PDFDemoApp folder
+const openFolder = async () => {
+  try {
+    await FileManager.openDownloadsFolder();
+    console.log('✅ Folder opened successfully');
+  } catch (error) {
+    // All strategies failed - no file manager available
+    Alert.alert(
+      'Info',
+      'Please check Downloads/PDFDemoApp folder in your file manager'
+    );
+  }
+};
+```
+
+#### **API:**
+
+```typescript
+FileManager.openDownloadsFolder(): Promise<boolean>
+```
+
+#### **Fallback Strategies:**
+1. **Strategy 1**: Opens specific `Downloads/PDFDemoApp` folder via DocumentsUI
+2. **Strategy 2**: Opens system Downloads app
+3. **Strategy 3**: Opens generic Files app
+4. **Strategy 4**: Shows file picker to let user choose file manager
+
+### Complete Example: Export and Download PDF Pages
+
+```jsx
+import React, { useState } from 'react';
+import { View, Button, Alert, NativeModules } from 'react-native';
+
+const { PDFExporter, FileDownloader, FileManager } = NativeModules;
+
+const ExportAndDownload = () => {
+  const [exporting, setExporting] = useState(false);
+
+  const exportAndDownloadPages = async (pdfPath, pageNumbers) => {
+    setExporting(true);
+    
+    try {
+      // Step 1: Export pages to images
+      const exportedImages = [];
+      for (let page of pageNumbers) {
+        const imagePath = await PDFExporter.exportPageToImage(
+          pdfPath,
+          page - 1, // Convert to 0-indexed
+          {
+            format: 'png',
+            quality: 0.9,
+            scale: 2.0
+          }
+        );
+        exportedImages.push(imagePath);
+      }
+      
+      // Step 2: Download to public storage
+      const downloadedFiles = [];
+      for (let i = 0; i < exportedImages.length; i++) {
+        const publicPath = await FileDownloader.downloadToPublicFolder(
+          exportedImages[i],
+          `page-${pageNumbers[i]}.png`,
+          'image/png'
+        );
+        downloadedFiles.push(publicPath);
+      }
+      
+      setExporting(false);
+      
+      // Step 3: Show success and offer to open folder
+      Alert.alert(
+        '✅ Export Complete',
+        `${downloadedFiles.length} pages saved to Downloads/PDFDemoApp`,
+        [
+          { text: 'Done', style: 'cancel' },
+          {
+            text: 'Open Folder',
+            onPress: async () => {
+              try {
+                await FileManager.openDownloadsFolder();
+              } catch (e) {
+                Alert.alert('Info', 'Check Downloads/PDFDemoApp folder');
+              }
+            }
+          }
+        ]
+      );
+      
+    } catch (error) {
+      setExporting(false);
+      Alert.alert('Export Failed', error.message);
+    }
+  };
+
+  return (
+    <View>
+      <Button
+        title={exporting ? 'Exporting...' : 'Export Pages 1-3'}
+        onPress={() => exportAndDownloadPages('/path/to/file.pdf', [1, 2, 3])}
+        disabled={exporting}
+      />
+    </View>
+  );
+};
+
+export default ExportAndDownload;
+```
+
+### Android Permissions
+
+For Android 10+ (API 29+), the MediaStore API doesn't require `WRITE_EXTERNAL_STORAGE` permission for adding files to public Downloads folder. However, for Android 9 and below, you may need to add:
+
+```xml
+<!-- android/app/src/main/AndroidManifest.xml -->
+<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
+```
+
+### Customization
+
+You can customize the folder name by modifying the `FOLDER_NAME` constant in the native modules:
+
+```java
+// android/src/main/java/org/wonday/pdf/FileDownloader.java
+private static final String FOLDER_NAME = "YourAppName"; // Change this
+```
+
+```java
+// android/src/main/java/org/wonday/pdf/FileManager.java
+private static final String FOLDER_NAME = "YourAppName"; // Change this
+```
+
 ## 🛡️ **ProGuard Configuration (Required for Production)**
 
 **IMPORTANT**: For production builds, you MUST add ProGuard rules to prevent obfuscation of JSI classes. Without these rules, your app will crash in release mode.
@@ -1579,11 +1858,20 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ## 📞 Support
 
-For issues and questions:
-- GitHub Issues: [react-native-enhanced-pdf](https://github.com/126punith/react-native-enhanced-pdf)
-- Performance Issues: Include JSI stats and performance history
-- Build Issues: Include CMake logs and Android NDK version
-- Contact: punithm300@gmail.com
+**📚 Documentation Website**: https://euphonious-faun-24f4bc.netlify.app/
+
+Get help with:
+- **📖 Complete Guides**: https://euphonious-faun-24f4bc.netlify.app/docs/getting-started/installation
+- **🔧 API Reference**: https://euphonious-faun-24f4bc.netlify.app/docs/api/pdf-component
+- **💡 Working Examples**: https://euphonious-faun-24f4bc.netlify.app/docs/examples/basic-viewer
+- **🐛 GitHub Issues**: https://github.com/126punith/react-native-enhanced-pdf/issues
+- **💬 Discussions**: https://github.com/126punith/react-native-enhanced-pdf/discussions
+- **📧 Email**: punithm300@gmail.com
+
+For bug reports, include:
+- JSI stats and performance history
+- CMake logs and Android NDK version
+- Platform and React Native version
 
 ---
 

package/android/src/main/java/org/wonday/pdf/FileDownloader.java

@@ -0,0 +1,292 @@
+package org.wonday.pdf;
+
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Environment;
+import android.provider.MediaStore;
+import android.util.Log;
+import androidx.core.app.NotificationCompat;
+import androidx.core.app.NotificationManagerCompat;
+
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.InputStream;
+import java.io.OutputStream;
+
+/**
+ * FileDownloader - Native module for downloading files to public storage using MediaStore API
+ * Ensures files are immediately visible in file managers
+ */
+public class FileDownloader extends ReactContextBaseJavaModule {
+    private static final String TAG = "FileDownloader";
+    private static final String FOLDER_NAME = "PDFDemoApp";
+    private static final String NOTIFICATION_CHANNEL_ID = "pdf_exports";
+    private final ReactApplicationContext reactContext;
+
+    public FileDownloader(ReactApplicationContext reactContext) {
+        super(reactContext);
+        this.reactContext = reactContext;
+        createNotificationChannel();
+    }
+    
+    /**
+     * Create notification channel for export notifications (Android O+)
+     */
+    private void createNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            CharSequence name = "PDF Exports";
+            String description = "Notifications for PDF export operations";
+            int importance = NotificationManager.IMPORTANCE_DEFAULT;
+            NotificationChannel channel = new NotificationChannel(NOTIFICATION_CHANNEL_ID, name, importance);
+            channel.setDescription(description);
+            
+            NotificationManager notificationManager = reactContext.getSystemService(NotificationManager.class);
+            if (notificationManager != null) {
+                notificationManager.createNotificationChannel(channel);
+                Log.i(TAG, "📱 [NOTIFICATION] Channel created");
+            }
+        }
+    }
+
+    @Override
+    public String getName() {
+        return "FileDownloader";
+    }
+
+    /**
+     * Download file to public Downloads folder using MediaStore API
+     * 
+     * @param sourcePath Path to source file in app's cache
+     * @param fileName Name for the downloaded file
+     * @param mimeType MIME type (application/pdf, image/png, image/jpeg)
+     * @param promise Promise to resolve with public file path
+     */
+    @ReactMethod
+    public void downloadToPublicFolder(String sourcePath, String fileName, String mimeType, Promise promise) {
+        try {
+            Log.i(TAG, "📥 [DOWNLOAD] START - file: " + fileName + ", type: " + mimeType);
+            Log.i(TAG, "📁 [SOURCE] " + sourcePath);
+
+            // Verify source file exists
+            File sourceFile = new File(sourcePath);
+            if (!sourceFile.exists()) {
+                Log.e(TAG, "❌ [ERROR] Source file not found: " + sourcePath);
+                promise.reject("FILE_NOT_FOUND", "Source file not found: " + sourcePath);
+                return;
+            }
+
+            Log.i(TAG, "📁 [SOURCE] File exists, size: " + sourceFile.length() + " bytes");
+
+            String publicPath;
+
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                // Android 10+ - Use MediaStore API (Scoped Storage)
+                publicPath = downloadUsingMediaStore(sourceFile, fileName, mimeType);
+            } else {
+                // Android 9 and below - Use legacy public directory
+                publicPath = downloadUsingLegacyStorage(sourceFile, fileName);
+            }
+
+            Log.i(TAG, "✅ [DOWNLOAD] SUCCESS - " + publicPath);
+            
+            // Show notification with "Open Folder" action
+            showDownloadNotification(1, fileName);
+            
+            promise.resolve(publicPath);
+
+        } catch (Exception e) {
+            Log.e(TAG, "❌ [DOWNLOAD] ERROR", e);
+            promise.reject("DOWNLOAD_ERROR", e.getMessage());
+        }
+    }
+
+    /**
+     * Download using MediaStore API (Android 10+)
+     */
+    private String downloadUsingMediaStore(File sourceFile, String fileName, String mimeType) throws Exception {
+        Log.i(TAG, "📱 [MEDIASTORE] Using MediaStore API for Android 10+");
+
+        ContentResolver resolver = reactContext.getContentResolver();
+        
+        // Set up content values
+        ContentValues values = new ContentValues();
+        values.put(MediaStore.Downloads.DISPLAY_NAME, fileName);
+        values.put(MediaStore.Downloads.MIME_TYPE, mimeType);
+        values.put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS + "/" + FOLDER_NAME);
+        values.put(MediaStore.Downloads.IS_PENDING, 1); // Mark as pending while writing
+
+        Log.i(TAG, "📁 [MEDIASTORE] Creating entry in MediaStore...");
+        
+        // Insert into MediaStore
+        Uri uri = resolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, values);
+        
+        if (uri == null) {
+            throw new Exception("Failed to create MediaStore entry");
+        }
+
+        Log.i(TAG, "📁 [MEDIASTORE] URI created: " + uri.toString());
+        Log.i(TAG, "📥 [COPY] Copying file content...");
+
+        // Copy file content
+        try (InputStream in = new FileInputStream(sourceFile);
+             OutputStream out = resolver.openOutputStream(uri)) {
+            
+            if (out == null) {
+                throw new Exception("Failed to open output stream");
+            }
+
+            byte[] buffer = new byte[8192];
+            int bytesRead;
+            long totalBytes = 0;
+
+            while ((bytesRead = in.read(buffer)) != -1) {
+                out.write(buffer, 0, bytesRead);
+                totalBytes += bytesRead;
+            }
+
+            Log.i(TAG, "✅ [COPY] Copied " + totalBytes + " bytes");
+        }
+
+        // Mark as complete (no longer pending)
+        values.clear();
+        values.put(MediaStore.Downloads.IS_PENDING, 0);
+        resolver.update(uri, values, null, null);
+
+        Log.i(TAG, "✅ [MEDIASTORE] File published successfully");
+
+        // Return user-friendly path
+        String publicPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
+                + "/" + FOLDER_NAME + "/" + fileName;
+        
+        return publicPath;
+    }
+
+    /**
+     * Download using legacy storage (Android 9 and below)
+     */
+    private String downloadUsingLegacyStorage(File sourceFile, String fileName) throws Exception {
+        Log.i(TAG, "📱 [LEGACY] Using legacy storage for Android 9 and below");
+
+        // Get public Downloads directory
+        File downloadsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
+        File appFolder = new File(downloadsDir, FOLDER_NAME);
+
+        // Create folder if needed
+        if (!appFolder.exists()) {
+            boolean created = appFolder.mkdirs();
+            Log.i(TAG, "📁 [LEGACY] Folder created: " + created);
+        }
+
+        File destFile = new File(appFolder, fileName);
+        Log.i(TAG, "📁 [LEGACY] Destination: " + destFile.getAbsolutePath());
+        Log.i(TAG, "📥 [COPY] Copying file...");
+
+        // Copy file
+        try (InputStream in = new FileInputStream(sourceFile);
+             OutputStream out = new java.io.FileOutputStream(destFile)) {
+            
+            byte[] buffer = new byte[8192];
+            int bytesRead;
+            long totalBytes = 0;
+
+            while ((bytesRead = in.read(buffer)) != -1) {
+                out.write(buffer, 0, bytesRead);
+                totalBytes += bytesRead;
+            }
+
+            Log.i(TAG, "✅ [COPY] Copied " + totalBytes + " bytes");
+        }
+
+        // Trigger media scanner for legacy devices
+        android.media.MediaScannerConnection.scanFile(
+            reactContext,
+            new String[]{destFile.getAbsolutePath()},
+            new String[]{getMimeType(fileName)},
+            null
+        );
+
+        Log.i(TAG, "✅ [LEGACY] Media scanner notified");
+
+        return destFile.getAbsolutePath();
+    }
+
+    /**
+     * Get MIME type from file extension
+     */
+    private String getMimeType(String fileName) {
+        if (fileName.endsWith(".pdf")) {
+            return "application/pdf";
+        } else if (fileName.endsWith(".png")) {
+            return "image/png";
+        } else if (fileName.endsWith(".jpeg") || fileName.endsWith(".jpg")) {
+            return "image/jpeg";
+        }
+        return "application/octet-stream";
+    }
+    
+    /**
+     * Show notification after successful download with "Open Folder" action
+     * @param fileCount Number of files downloaded
+     * @param fileName Name of the file (used for notification text)
+     */
+    private void showDownloadNotification(int fileCount, String fileName) {
+        try {
+            Log.i(TAG, "📱 [NOTIFICATION] Showing notification for " + fileCount + " file(s)");
+            
+            // Create intent to open Downloads/PDFDemoApp folder
+            Intent intent = new Intent(Intent.ACTION_VIEW);
+            Uri folderUri = Uri.parse("content://com.android.externalstorage.documents/document/primary:Download/" + FOLDER_NAME);
+            intent.setDataAndType(folderUri, "resource/folder");
+            intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            
+            // Create pending intent with FLAG_IMMUTABLE for Android 12+
+            PendingIntent pendingIntent = PendingIntent.getActivity(
+                reactContext, 
+                0, 
+                intent, 
+                Build.VERSION.SDK_INT >= Build.VERSION_CODES.M 
+                    ? PendingIntent.FLAG_IMMUTABLE 
+                    : 0
+            );
+            
+            // Build notification
+            String contentText = fileCount + " file(s) saved to Downloads/" + FOLDER_NAME;
+            NotificationCompat.Builder builder = new NotificationCompat.Builder(reactContext, NOTIFICATION_CHANNEL_ID)
+                .setSmallIcon(android.R.drawable.ic_menu_save)
+                .setContentTitle("✅ Export Complete")
+                .setContentText(contentText)
+                .setStyle(new NotificationCompat.BigTextStyle().bigText(contentText))
+                .setPriority(NotificationCompat.PRIORITY_DEFAULT)
+                .setContentIntent(pendingIntent)
+                .setAutoCancel(true)
+                .addAction(android.R.drawable.ic_menu_view, "Open Folder", pendingIntent);
+            
+            // Show notification
+            NotificationManagerCompat notificationManager = NotificationManagerCompat.from(reactContext);
+            notificationManager.notify(1001, builder.build());
+            
+            Log.i(TAG, "✅ [NOTIFICATION] Notification shown successfully");
+            
+        } catch (Exception e) {
+            Log.e(TAG, "❌ [NOTIFICATION] Failed to show notification", e);
+            // Don't throw - notification is non-critical
+        }
+    }
+}
+
+
+
+
+