react-native-pdf-jsi 3.4.2 → 4.0.0

package/README.md

@@ -8,7 +8,7 @@
 
 ---
 
-## ⚡ Performance Benchmarks (v3.4.0)
+## ⚡ Performance Benchmarks (v4.0.0)
 
 **World-class performance proven with real-world testing:**
 
@@ -87,6 +87,37 @@ 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 4.0.0 - iOS Feature Parity & Major Improvements!
+
+**Complete iOS pro features port with full feature parity between Android and iOS platforms!**
+
+### 🚀 **What's New in v4.0.0:**
+
+#### ✨ **New Features**
+- **📱 iOS Pro Features Port** - Complete feature parity with Android! All pro features now available on iOS:
+  - File download and management (FileDownloader, FileManager)
+  - PDF export operations (split, merge, extract, rotate, delete)
+  - Export to images (PNG/JPEG) with quality control
+  - PDF compression with smart presets
+  - Text extraction and search capabilities
+- **⚡ iOS Performance Optimizations**:
+  - **ImagePool** - Efficient UIImage reuse and memory management
+  - **LazyMetadataLoader** - Deferred PDF metadata loading for faster initial load
+  - **MemoryMappedCache** - Zero-copy file access using mmap() system call
+  - **StreamingPDFProcessor** - Chunk-based processing for large files (60MB-200MB+)
+- **🌐 Cross-Platform Compatibility** - Platform.OS checks for method signature differences (Android 3 args vs iOS 2 args for splitPDF)
+
+#### 🐛 **Bug Fixes**
+- **📝 TypeScript Definitions** - Fixed malformed comment blocks in `index.d.ts` that made functional props appear commented out. All props (spacing, password, renderActivityIndicator, enableAntialiasing, enablePaging, enableRTL, enableAnnotationRendering, enableDoubleTapZoom, fitPolicy) now properly documented
+- **🤖 Android splitPDF** - Fixed argument count mismatch error. Android requires 3 arguments (filePath, ranges, outputDir) while iOS requires 2 (filePath, ranges)
+- **💥 Promise Resolution** - Fixed EXC_BAD_ACCESS crashes by ensuring all promise callbacks execute on main thread
+- **📁 File Download** - Removed unstable native folder creation code, using react-native-blob-util for reliable folder operations
+
+#### 🔄 **Technical Improvements**
+- **Simplified File Management** - Removed subfolderName/folderName parameters, using react-native-blob-util for folder creation
+- **Enhanced Stability** - Removed unstable iOS code that caused crashes, replaced with proven react-native-blob-util implementation
+- **Better Error Handling** - Improved promise handling and thread safety across all native modules
+
 ## 🎉 Version 3.4.0 - Enhanced Navigation & File Path Handling!
 
 **Major improvements to navigation reliability and file path tracking for better bookmarking, export, and PDF operations!**

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Thu Oct 02 20:04:14 IST 2025
+gradle.version=8.5

package/index.d.ts

@@ -40,15 +40,37 @@ export interface PdfProps {
     showsVerticalScrollIndicator?: boolean,
     scrollEnabled?: boolean,
     /**
-    /**
-    /**
+     * Space between pages in pixels
+     */
     spacing?: number,
+    /**
+     * Password for encrypted PDFs
+     */
     password?: string,
+    /**
+     * Custom loading indicator component
+     * @param progress - Progress value from 0 to 1
+     */
     renderActivityIndicator?: (progress: number) => React.ReactElement,
+    /**
+     * Enable antialiasing for smoother rendering
+     */
     enableAntialiasing?: boolean,
+    /**
+     * Enable page-by-page navigation mode
+     */
     enablePaging?: boolean,
+    /**
+     * Enable right-to-left layout support
+     */
     enableRTL?: boolean,
+    /**
+     * Enable rendering of PDF annotations
+     */
     enableAnnotationRendering?: boolean,
+    /**
+     * Enable double-tap to zoom functionality
+     */
     enableDoubleTapZoom?: boolean;
     /**
      * Fit policy.  This will adjust the initial zoom of the PDF based on the initial size of the view and the scale factor.

package/ios/PERMISSIONS.md

@@ -0,0 +1,106 @@
+# iOS Permissions Guide
+
+## Overview
+This document explains the permissions required and how they are handled in the iOS implementation.
+
+## Required Permissions
+
+### 1. Notification Permissions
+**Status**: ✅ Properly Handled
+
+**What it's used for**: 
+- Showing download completion notifications in `FileDownloader`
+
+**How it's handled**:
+- Permissions are requested **on-demand** when a notification needs to be shown (not on module initialization)
+- Permission status is checked before attempting to show notifications
+- Graceful fallback if permissions are denied (logs warning, doesn't crash)
+- Error handling included in permission request
+
+**Info.plist Requirements**: 
+- ❌ **No Info.plist entry required** - Local notifications don't require usage descriptions
+
+**Code Location**: 
+- `ios/RNPDFPdf/FileDownloader.m` - `requestNotificationPermissionsWithCompletion:` and `showDownloadNotification:`
+
+### 2. File System Access
+**Status**: ✅ No Special Permissions Required
+
+**What it's used for**:
+- Accessing app's Documents directory
+- Creating folders in app's sandbox
+- Copying files within app's container
+
+**How it's handled**:
+- Uses `NSDocumentDirectory` which is within the app's sandbox
+- No special permissions needed - apps have full access to their own sandbox
+- Uses `NSFileManager` for file operations
+
+**Info.plist Requirements**: 
+- ❌ **No Info.plist entry required** - Accessing app's own sandbox doesn't require permissions
+
+**Code Location**: 
+- `ios/RNPDFPdf/FileDownloader.m` - File operations
+- `ios/RNPDFPdf/FileManager.m` - File operations
+
+### 3. UIDocumentPickerViewController
+**Status**: ✅ No Special Permissions Required
+
+**What it's used for**:
+- Opening Files app to show downloaded files
+- Providing user access to exported files
+
+**How it's handled**:
+- Uses `UIDocumentPickerViewController` which doesn't require special permissions
+- Multiple fallback strategies for maximum compatibility
+- Handles cases where Files app might not be available
+
+**Info.plist Requirements**: 
+- ❌ **No Info.plist entry required** - `UIDocumentPickerViewController` doesn't need permissions
+
+**Code Location**: 
+- `ios/RNPDFPdf/FileManager.m` - `openDownloadsFolder:`
+
+## Permission Request Flow
+
+### Notification Permissions
+```
+1. User triggers download/export
+2. FileDownloader.showDownloadNotification() is called
+3. Check current authorization status
+4. If not authorized → Request permissions
+5. If authorized → Show notification
+6. If denied → Log warning, continue without notification
+```
+
+### File Access
+```
+1. No permission request needed
+2. Direct access to NSDocumentDirectory (app's sandbox)
+3. Create folders/files as needed
+4. No user interaction required
+```
+
+## Best Practices Implemented
+
+1. ✅ **On-Demand Permission Requests**: Permissions are requested when needed, not on app startup
+2. ✅ **Permission Status Checks**: Always check authorization status before using protected resources
+3. ✅ **Graceful Degradation**: App continues to work even if permissions are denied
+4. ✅ **Error Handling**: All permission requests include error handling
+5. ✅ **No Info.plist Pollution**: Only request permissions that are actually needed
+
+## Testing Checklist
+
+- [ ] Test notification permission request flow
+- [ ] Test notification display when permissions granted
+- [ ] Test graceful handling when permissions denied
+- [ ] Test file operations in Documents directory
+- [ ] Test UIDocumentPickerViewController on different iOS versions
+- [ ] Verify no crashes when permissions are denied
+
+## Notes
+
+- **No Info.plist modifications needed** - All permissions are handled programmatically
+- **No external dependencies** - Uses only iOS system frameworks
+- **Backward compatible** - Works on iOS 11.0+ with appropriate fallbacks
+

package/ios/RNPDFPdf/FileDownloader.h

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025-present, Punith M (punithm300@gmail.com)
+ * FileDownloader for iOS - Downloads files to Documents directory or iCloud Drive
+ * All rights reserved.
+ * 
+ * Downloads files to public storage and shows notifications
+ */
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface FileDownloader : RCTEventEmitter <RCTBridgeModule>
+
+@end
+