react-native-pdf-jsi 2.2.8 → 3.0.1

package/src/managers/FileManager.js

@@ -0,0 +1,89 @@
+import { NativeModules } from 'react-native';
+
+const { FileManager: NativeFileManager, FileDownloader } = NativeModules;
+
+/**
+ * FileManager - JavaScript wrapper for file operations
+ * Provides methods for file management, downloading, and folder access
+ */
+class FileManager {
+  /**
+   * Open the Downloads folder in the device's file manager
+   * Uses multiple fallback strategies for maximum compatibility
+   * @returns {Promise<boolean>} Resolves to true if folder opened successfully
+   */
+  static async openDownloadsFolder() {
+    try {
+      console.log('📂 [FileManager] Opening Downloads folder');
+      
+      if (!NativeFileManager) {
+        throw new Error('FileManager native module not available');
+      }
+      
+      const result = await NativeFileManager.openDownloadsFolder();
+      console.log('✅ [FileManager] Folder opened successfully');
+      return result;
+    } catch (error) {
+      console.error('❌ [FileManager] Error opening folder:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Download file to public Downloads folder using MediaStore API
+   * Ensures files are immediately visible in file managers
+   * 
+   * @param {string} sourcePath Path to source file in app's cache
+   * @param {string} fileName Name for the downloaded file
+   * @param {string} mimeType MIME type (application/pdf, image/png, image/jpeg)
+   * @returns {Promise<string>} Resolves to public file path
+   */
+  static async downloadToPublicFolder(sourcePath, fileName, mimeType = 'application/pdf') {
+    try {
+      console.log('📥 [FileManager] Downloading to public folder:', fileName);
+      
+      if (!FileDownloader) {
+        throw new Error('FileDownloader native module not available');
+      }
+      
+      const publicPath = await FileDownloader.downloadToPublicFolder(sourcePath, fileName, mimeType);
+      console.log('✅ [FileManager] File downloaded:', publicPath);
+      return publicPath;
+    } catch (error) {
+      console.error('❌ [FileManager] Error downloading file:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Download multiple files to public Downloads folder
+   * 
+   * @param {Array<{sourcePath: string, fileName: string, mimeType: string}>} files Array of file objects
+   * @returns {Promise<Array<string>>} Resolves to array of public file paths
+   */
+  static async downloadMultipleFiles(files) {
+    try {
+      console.log(`📥 [FileManager] Downloading ${files.length} files to public folder`);
+      
+      const results = [];
+      for (const file of files) {
+        const { sourcePath, fileName, mimeType = 'application/pdf' } = file;
+        const publicPath = await this.downloadToPublicFolder(sourcePath, fileName, mimeType);
+        results.push(publicPath);
+      }
+      
+      console.log(`✅ [FileManager] Downloaded ${results.length} files successfully`);
+      return results;
+    } catch (error) {
+      console.error('❌ [FileManager] Error downloading multiple files:', error);
+      throw error;
+    }
+  }
+}
+
+export default FileManager;
+
+
+
+
+

package/src/utils/ErrorHandler.js

@@ -0,0 +1,179 @@
+/**
+ * ErrorHandler - Comprehensive error handling utilities
+ */
+
+import {Alert} from 'react-native';
+
+export class PDFError extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = 'PDFError';
+  }
+}
+
+export const ErrorCodes = {
+  // License errors
+  LICENSE_INVALID: 'LICENSE_INVALID',
+  LICENSE_EXPIRED: 'LICENSE_EXPIRED',
+  LICENSE_REQUIRED: 'LICENSE_REQUIRED',
+
+  // PDF loading errors
+  PDF_NOT_FOUND: 'PDF_NOT_FOUND',
+  PDF_CORRUPTED: 'PDF_CORRUPTED',
+  PDF_PASSWORD_REQUIRED: 'PDF_PASSWORD_REQUIRED',
+  PDF_LOAD_TIMEOUT: 'PDF_LOAD_TIMEOUT',
+
+  // Network errors
+  NETWORK_ERROR: 'NETWORK_ERROR',
+  NETWORK_TIMEOUT: 'NETWORK_TIMEOUT',
+
+  // Storage errors
+  STORAGE_FULL: 'STORAGE_FULL',
+  STORAGE_PERMISSION: 'STORAGE_PERMISSION',
+
+  // Feature errors
+  EXPORT_FAILED: 'EXPORT_FAILED',
+  OPERATION_FAILED: 'OPERATION_FAILED',
+  BOOKMARK_FAILED: 'BOOKMARK_FAILED',
+
+  // JSI errors
+  JSI_NOT_AVAILABLE: 'JSI_NOT_AVAILABLE',
+  NATIVE_MODULE_MISSING: 'NATIVE_MODULE_MISSING',
+
+  // Generic
+  UNKNOWN_ERROR: 'UNKNOWN_ERROR',
+};
+
+export const getUserFriendlyMessage = (error) => {
+  if (error instanceof PDFError) {
+    switch (error.code) {
+      case ErrorCodes.LICENSE_INVALID:
+        return 'Your license key is invalid. Please check and try again.';
+      case ErrorCodes.LICENSE_EXPIRED:
+        return 'Your license has expired. Please renew to continue using Pro features.';
+      case ErrorCodes.LICENSE_REQUIRED:
+        return 'This feature requires a Pro license. Upgrade to unlock!';
+      case ErrorCodes.PDF_NOT_FOUND:
+        return 'PDF file not found. Please check the file path.';
+      case ErrorCodes.PDF_CORRUPTED:
+        return 'This PDF file appears to be corrupted or invalid.';
+      case ErrorCodes.PDF_PASSWORD_REQUIRED:
+        return 'This PDF is password protected. Password support coming soon.';
+      case ErrorCodes.NETWORK_ERROR:
+        return 'Network error. Please check your internet connection.';
+      case ErrorCodes.NETWORK_TIMEOUT:
+        return 'Request timed out. Please try again.';
+      case ErrorCodes.STORAGE_FULL:
+        return 'Not enough storage space. Please free up some space and try again.';
+      case ErrorCodes.STORAGE_PERMISSION:
+        return 'Storage permission denied. Please grant permission in settings.';
+      case ErrorCodes.EXPORT_FAILED:
+        return 'Failed to export PDF. Please try again.';
+      case ErrorCodes.JSI_NOT_AVAILABLE:
+        return 'High-performance mode not available. Using standard mode.';
+      default:
+        return error.message;
+    }
+  }
+
+  // Handle standard errors
+  if (error.message) {
+    // Password errors
+    if (error.message.includes('Password') || error.message.includes('password')) {
+      return 'This PDF requires a password. Password support coming soon.';
+    }
+    // Network errors
+    if (error.message.includes('Network') || error.message.includes('fetch')) {
+      return 'Network error. Please check your connection and try again.';
+    }
+    // File errors
+    if (error.message.includes('not found') || error.message.includes('ENOENT')) {
+      return 'File not found. Please try again.';
+    }
+    // Permission errors
+    if (error.message.includes('permission') || error.message.includes('denied')) {
+      return 'Permission denied. Please grant necessary permissions.';
+    }
+
+    return error.message;
+  }
+
+  return 'An unexpected error occurred. Please try again.';
+};
+
+export const handleError = (
+  error,
+  context,
+  showAlert = true,
+  onRetry
+) => {
+  const message = getUserFriendlyMessage(error);
+  console.error(`❌ Error in ${context}:`, error);
+
+  if (showAlert) {
+    const buttons = onRetry
+      ? [
+          {text: 'Cancel', style: 'cancel'},
+          {text: 'Retry', onPress: onRetry},
+        ]
+      : [{text: 'OK'}];
+
+    Alert.alert(`Error: ${context}`, message, buttons);
+  }
+};
+
+export const withErrorHandling = async (
+  fn,
+  context,
+  onError
+) => {
+  try {
+    return await fn();
+  } catch (error) {
+    console.error(`❌ Error in ${context}:`, error);
+    if (onError) {
+      onError(error);
+    } else {
+      handleError(error, context);
+    }
+    return null;
+  }
+};
+
+export const validatePDFPath = (path) => {
+  if (!path || path.trim() === '') {
+    throw new PDFError('PDF path is empty', ErrorCodes.PDF_NOT_FOUND);
+  }
+};
+
+export const validatePageNumber = (page, totalPages) => {
+  if (page < 1 || page > totalPages) {
+    throw new PDFError(
+      `Page number ${page} is out of range (1-${totalPages})`,
+      ErrorCodes.UNKNOWN_ERROR
+    );
+  }
+};
+
+export const validateLicense = (licenseManager, featureName) => {
+  if (!licenseManager.isProActive()) {
+    throw new PDFError(
+      `${featureName} requires a Pro license`,
+      ErrorCodes.LICENSE_REQUIRED,
+      {feature: featureName}
+    );
+  }
+};
+
+export default {
+  PDFError,
+  ErrorCodes,
+  getUserFriendlyMessage,
+  handleError,
+  withErrorHandling,
+  validatePDFPath,
+  validatePageNumber,
+  validateLicense,
+};

package/src/utils/TestData.js

@@ -0,0 +1,112 @@
+/**
+ * Test Data - Sample PDFs and Test Scenarios
+ * Provides various test cases for Pro feature validation
+ */
+
+export const SamplePDFs = {
+  SMALL: {
+    name: 'React Native Book Sample',
+    uri: 'http://samples.leanpub.com/thereactnativebook-sample.pdf',
+    cache: true,
+    description: 'Small PDF for quick testing',
+    expectedPages: 10,
+  },
+  MEDIUM: {
+    name: 'Lorem Ipsum Document',
+    uri: 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
+    cache: true,
+    description: 'Medium-sized PDF',
+    expectedPages: 1,
+  },
+  LARGE: {
+    name: 'JavaScript Guide',
+    uri: 'https://eloquentjavascript.net/Eloquent_JavaScript.pdf',
+    cache: true,
+    description: 'Large PDF for performance testing',
+    expectedPages: 472,
+  },
+};
+
+export const TestScenarios = {
+  BOOKMARKS: {
+    name: 'Test Bookmarks',
+    steps: [
+      'Open PDF',
+      'Navigate to page 3',
+      'Create bookmark with Red color',
+      'Add notes to bookmark',
+      'Navigate to page 5',
+      'Create bookmark with Blue color',
+      'Open bookmark sidebar',
+      'Tap bookmark to jump to page',
+    ],
+  },
+  EXPORT: {
+    name: 'Test Export',
+    steps: [
+      'Open PDF',
+      'Navigate to page 1',
+      'Tap Export icon',
+      'Choose PNG format',
+      'Verify export success',
+      'Try JPEG export',
+      'Test batch export',
+    ],
+  },
+  OPERATIONS: {
+    name: 'Test PDF Operations',
+    steps: [
+      'Open PDF',
+      'Tap Operations icon',
+      'Test Split (pages 1-2)',
+      'Test Extract (pages 1,3,5)',
+      'Verify output files',
+    ],
+  },
+  ANALYTICS: {
+    name: 'Test Analytics',
+    steps: [
+      'Open PDF',
+      'Navigate through 5 pages',
+      'Wait 30 seconds',
+      'Open Analytics panel',
+      'Verify time tracking',
+      'Check reading speed',
+    ],
+  },
+};
+
+export const SampleBookmarks = [
+  {
+    page: 1,
+    name: 'Introduction',
+    color: '#FF6B6B',
+    notes: 'Start of the document',
+  },
+  {
+    page: 5,
+    name: 'Important Section',
+    color: '#4ECDC4',
+    notes: 'Key information here',
+  },
+  {
+    page: 10,
+    name: 'Summary',
+    color: '#95E1D3',
+    notes: 'Conclusion and takeaways',
+  },
+];
+
+export default {
+  SamplePDFs,
+  TestScenarios,
+  SampleBookmarks,
+};
+
+
+
+
+
+
+
+