react-native-ensys-camera-x 1.0.7

package/src/index.tsx

@@ -0,0 +1,763 @@
+import { measurePerformance } from './performance';
+import { debounceForLowEnd } from './cpuOptimization';
+import { setGlobalCameraTheme, getCurrentCameraTheme } from './theme';
+// The native bridge accessor and the wrappers the plugin's own screens call live
+// in ./nativeActions, so `src/library/**` can reach them without importing this
+// barrel (which would be a require cycle). They are re-exported below, so the
+// public API is unchanged.
+import { getCustomCameraModule } from './nativeActions';
+
+// Types used for exports
+import type {
+  CameraTheme,
+  CameraThemeConfig,
+  FaceEffect,
+  FilterType,
+  FlashMode,
+  ImageCropOptions,
+  PerformanceMetrics,
+} from './types';
+
+// Export utility functions and constants
+export {
+  DEFAULT_FILTERS,
+  DEFAULT_FACE_EFFECTS,
+  DEFAULT_THEMES,
+  DEFAULT_FLASH_MODES,
+  validateCropOptions,
+  generateAlbumName,
+  formatVideoDuration,
+  isVideoUri,
+  isImageUri,
+  isGifAsset,
+  requiresNativeImageDecoder,
+} from './utils';
+
+// Export localization
+export {
+  setCameraLocalization,
+  updateCameraLocalization,
+  setCameraLanguage,
+  // One-time automatic host-language synchronization.
+  setCameraLanguageProvider,
+  clearCameraLanguageProvider,
+  getCameraLanguageProvider,
+  syncCameraLanguage,
+  isCameraLanguageProvider,
+  registerCameraTranslations,
+  getCameraLocale,
+  getCameraIsRtl,
+  defaultTranslations,
+  CameraLocalizationProvider,
+  LocalizationManager,
+  cameraLocalizationKeys,
+  useCameraLocalization,
+  useCameraLocalizationContext,
+  rtlAwareStyles,
+  getRtlAwareStyles,
+  type CameraTranslations,
+  type CameraLanguageProvider,
+  type CameraLanguageSubscription,
+  type CameraLocalizationConfig,
+  type CameraLocalizationProviderProps,
+  type CameraTranslationBundles,
+  type CameraTranslationFunction,
+  type CameraTranslationKey,
+  type CameraTranslationMap,
+} from './localization';
+
+// Export the locale engine — useful for hosts that want to reuse the plugin's
+// tag parsing or RTL detection instead of shipping their own.
+export {
+  DEFAULT_LOCALE,
+  RTL_LANGUAGES,
+  RTL_SCRIPTS,
+  isRtlLocale,
+  localeFallbackChain,
+  matchLocaleKey,
+  normalizeLocale,
+  parseLocale,
+  resolveLocaleTranslations,
+  type ParsedLocale,
+} from './locales';
+
+// Export error handling
+export {
+  CameraError,
+  ERROR_CODES,
+  isCameraError,
+  handleCameraError,
+  getUserFriendlyErrorMessage,
+  validateUri,
+  validateImageUri,
+  validateVideoUri,
+  validateFilterType,
+  validateFlashMode,
+  validateFaceEffect,
+  validateCameraTheme,
+} from './errors';
+
+// Export validation utilities
+export {
+  validateCameraPickerOptions,
+  validateUrisArray,
+  validateAlbumName,
+  validateCaption,
+  validateTimerDelay,
+  validateVideoTrimParameters,
+  validateUploadUrl,
+  checkFileSize,
+  validateAlbumId,
+  validateRotationDegrees,
+  VALIDATION_CONSTANTS,
+} from './validation';
+
+// Export state management
+export {
+  createInitialOperationState,
+  createLoadingState,
+  createSuccessState,
+  createErrorState,
+  createCancelledState,
+  isOperationInProgress,
+  isOperationSuccessful,
+  isOperationFailed,
+  isOperationCancelled,
+  getStatusMessage,
+  OperationQueue,
+  processInBatches,
+  retryWithBackoff,
+  withTimeout,
+} from './state';
+export type { OperationResult, OperationStatus } from './state';
+
+// Export theme system
+export {
+  DEFAULT_CAMERA_THEME_CONFIG,
+  createCameraTheme,
+  resolveCameraTheme,
+  setGlobalCameraTheme,
+  getCurrentCameraTheme,
+  subscribeToCameraTheme,
+  CameraThemeProvider,
+  useCameraTheme,
+} from './theme';
+
+// Export the centralized white-label configuration system
+export {
+  CameraPlugin,
+  configureCameraPlugin,
+  getCameraPluginConfig,
+  subscribeToCameraPluginConfig,
+  setCameraIcons,
+  getCameraIcons,
+  resetCameraIcons,
+  DEFAULT_CUSTOM_ICONS,
+  DEFAULT_ICON_CONFIG,
+  DEFAULT_ANIMATION_CONFIG,
+  DEFAULT_DIMENSION_CONFIG,
+  DEFAULT_NOTIFICATION_CONFIG,
+} from './config';
+export type { ResolvedCameraPluginConfig } from './config';
+
+// Export THE centralized icon configuration: one catalog of unique icon ids in
+// front of both the RN component registry and the native drawable layer.
+export {
+  CAMERA_ICON_CATALOG,
+  CAMERA_ICON_IDS,
+  isCameraIconId,
+  normalizeCameraIconValue,
+  createSvgIconComponent,
+  createImageIconComponent,
+  isRenderableSvg,
+  resolveCameraIconRegistryConfig,
+  resolveNativeIconConfig,
+  mergeCameraIconsConfig,
+} from './iconConfig';
+export type {
+  CameraIconId,
+  CameraIconsConfig,
+  CameraIconCustomization,
+  CameraIconValue,
+  CameraIconSurface,
+  CameraIconCatalogEntry,
+} from './iconConfig';
+
+export type {
+  CameraPluginConfig,
+  CameraIconConfig,
+  CameraIconName,
+  CameraIconStyle,
+  CameraAnimationConfig,
+  CameraDimensionConfig,
+  UploadNotificationConfig,
+} from './types';
+export {
+  CameraIconProvider,
+  useIcon,
+  useIconRegistry,
+  useIconConfig,
+  useRenderIcon,
+  RenderIcon,
+  createDefaultIconRegistry,
+  resolveIconConfig,
+  mergeIconConfigs,
+  getIconComponent,
+  setGlobalIconRegistryConfig,
+  getGlobalIconRegistryConfig,
+  subscribeToGlobalIconRegistryConfig,
+  DefaultFallbackIcon,
+  DEFAULT_ICON_REGISTRY_CONFIG,
+  DEFAULT_ICON_SIZE,
+  DEFAULT_ICON_COLOR,
+  DEFAULT_ICON_STROKE_WIDTH,
+  DEFAULT_FALLBACK_ICON_COLOR,
+  DEFAULT_FALLBACK_ICON_WEIGHT,
+} from './icons';
+export type {
+  // RN React-component icon registry (distinct from the native
+  // CameraIconConfig/CameraIconName/CameraIconStyle exported above, which
+  // configure the native Activity's Android vector drawables). Host apps
+  // normally use the centralized CameraIconId layer instead of either.
+  CameraIconKey,
+  IconComponent,
+  IconProps,
+  IconOverride,
+  IconRegistry,
+  ResolvedIconConfig,
+  CameraIconProviderProps,
+  CameraIconRegistryConfig,
+} from './icons';
+export type {
+  CameraThemeConfig,
+  CameraThemeInput,
+  CameraThemePreset,
+  CameraThemePalette,
+  CameraThemeTypography,
+  CameraFontWeight,
+  CameraThemeSpacing,
+  CameraThemeBorderRadius,
+  CameraThemeShadow,
+  CameraThemeComponentStyles,
+  CameraThemeComponentStyle,
+} from './types';
+
+// Export performance utilities
+export {
+  measurePerformance,
+  debounce,
+  throttle,
+  MediaCache,
+  BackgroundOperationManager,
+  LazyLoader,
+  processMediaInChunks,
+} from './performance';
+
+// Export memory management
+export { MemoryManager, WeakCache, processMediaInChunksMemory } from './memory';
+
+// Export network utilities
+export {
+  checkNetworkConnectivity,
+  validateUploadUrl as validateUploadUrlNetwork,
+  adaptiveUpload,
+  estimateBandwidth,
+  NetworkMonitor,
+} from './networkPerformance';
+
+// Export rendering utilities
+export {
+  runAfterInteractions,
+  createOptimizedListData,
+  createMemoizer,
+  createThrottledRenderer,
+  optimizeListRenderItem,
+  createOptimizedImageSource,
+} from './rendering';
+
+// Export security utilities
+export {
+  validateSecureUri,
+  sanitizeFileName,
+  validateFileContentType,
+  validateSecureFileSize,
+  validateBatchOperation,
+} from './security';
+
+// Export permission utilities
+export {
+  checkCameraPermission,
+  checkCameraPermissionStatus,
+  requestCameraPermission,
+  checkStoragePermission,
+  checkStoragePermissionStatus,
+  requestStoragePermission,
+  checkMicrophonePermission,
+  checkMicrophonePermissionStatus,
+  requestMicrophonePermission,
+  checkAllPermissions,
+  requestAllPermissions,
+  openSettings,
+  shouldShowRationale,
+  getDefaultPermissionRationale,
+  DEFAULT_RATIONALE,
+  type PermissionStatus,
+  type PermissionFeature,
+} from './permissions';
+
+// Export performance-optimized operations
+export const cropImageWithPerformance = async (
+  uri: string,
+  options: ImageCropOptions = {}
+): Promise<{ result: string; metrics: PerformanceMetrics }> => {
+  return measurePerformance('crop_image', () => cropImage(uri, options));
+};
+
+export const applyFilterWithPerformance = async (
+  uri: string,
+  filterType: FilterType = 'none'
+): Promise<{ result: string; metrics: PerformanceMetrics }> => {
+  return measurePerformance('apply_filter', () => applyFilter(uri, filterType));
+};
+
+export const debouncedRotateImage = debounceForLowEnd(
+  (uri: unknown, degrees: unknown) => {
+    if (typeof uri === 'string' && typeof degrees === 'number') {
+      return rotateImage(uri, degrees);
+    }
+    return Promise.reject(
+      new Error('Invalid arguments for debouncedRotateImage')
+    );
+  },
+  300
+);
+export const throttledSetCameraFlash = debounceForLowEnd((mode: unknown) => {
+  if (
+    mode === undefined ||
+    ['auto', 'on', 'off', 'torch'].includes(mode as string)
+  ) {
+    return setCameraFlash(mode as FlashMode);
+  }
+  return Promise.reject(
+    new Error('Invalid arguments for throttledSetCameraFlash')
+  );
+}, 500);
+
+// Export low-end optimization utilities
+export {
+  LowMemoryCache,
+  processMediaForLowEnd,
+  processInSmallBatches,
+  getOptimizedImageDimensions,
+  shouldUseLowMemoryOptimizations,
+} from './lowMemoryCache';
+
+export {
+  debounceForLowEnd,
+  throttleForLowEnd,
+  runInBackgroundWithPriority,
+  createLazyInitializer,
+  processInChunks,
+  efficientDelay,
+  isMainThreadBusy,
+  waitForMainThreadAvailable,
+  requestEfficientAnimationFrame,
+  cancelEfficientAnimationFrame,
+  getCpuOptimizationLevel,
+  supportsIdleCallback,
+  requestIdleCallbackPolyfill,
+  cancelIdleCallbackPolyfill,
+} from './cpuOptimization';
+
+export {
+  detectDeviceCapabilities,
+  isLowEndDevice,
+  getOptimizationLevel,
+  getMemorySettings,
+  getCpuSettings,
+  getRenderingSettings,
+  getNetworkSettings,
+  getImageQualitySettings,
+  shouldUseOptimization,
+  createOptimizedConfig,
+  createTestDeviceSpecs,
+} from './deviceCapabilities';
+export type { DeviceSpecs } from './deviceCapabilities';
+
+// Export performance monitoring
+export { PerformanceMonitor } from './performanceMonitor';
+
+// Export accessibility utilities
+export {
+  useScreenReaderEnabled,
+  useReducedMotion,
+  useBoldText,
+} from './accessibility';
+
+// Export all types for TypeScript
+export type {
+  CameraPickerOptions,
+  FilePickerOptions,
+  GalleryEditorOptions,
+  MediaEditorItem,
+  MediaEditorOptions,
+  CameraAsset,
+  CameraPickerResult,
+} from './types';
+export { prependMediaHistory } from './mediaHistory';
+export type {
+  CameraTheme,
+  FaceEffect,
+  FilterType,
+  FlashMode,
+  ImageCropOptions,
+  MediaMetadata,
+  PerformanceMetrics,
+} from './types';
+export type { ErrorCode } from './errors';
+
+export function openCamera(): Promise<string> {
+  return getCustomCameraModule().openCamera();
+}
+
+// ── Native bridge actions ───────────────────────────────────────────
+// Defined in ./nativeActions (see the import at the top of this file for why)
+// and re-exported here unchanged — these are part of the public API.
+export {
+  openCameraPicker,
+  openDocumentPicker,
+  openAudioPicker,
+  openImageVideoPicker,
+  openMediaEditor,
+  openGalleryEditor,
+  openDocument,
+  startUpload,
+  secureDeleteMedia,
+  shareMedia,
+  getMediaMetadata,
+  getRecordedOriginalSize,
+  startAudioRecording,
+  stopAudioRecording,
+  cancelAudioRecording,
+  stopAndPublishAudioRecording,
+  pauseAudioRecording,
+  resumeAudioRecording,
+  getAudioRecordingState,
+  getAudioAmplitude,
+  compressVideo,
+  compressImage,
+  addCompressionProgressListener,
+} from './nativeActions';
+export type { CompressionProgressEvent } from './nativeActions';
+
+export function getUploadState(): Promise<string> {
+  return getCustomCameraModule().getUploadState();
+}
+
+export function getNotificationHistory(): Promise<string> {
+  return getCustomCameraModule().getNotificationHistory();
+}
+
+export function clearNotificationHistory(): Promise<void> {
+  return getCustomCameraModule().clearNotificationHistory();
+}
+
+/**
+ * Real device-memory facts from the OS (Android: ActivityManager). Returns
+ * `{ isLowRamDevice, memoryClassMb, totalRamMb, availableRamMb,
+ * isCurrentlyLowMemory, cpuCores }`. detectDeviceCapabilities() consumes this
+ * to classify the device instead of guessing from screen size.
+ */
+export function getDeviceCapabilities(): Promise<Object> {
+  return getCustomCameraModule().getDeviceCapabilities();
+}
+
+export function cropImage(
+  uri: string,
+  options: ImageCropOptions = {}
+): Promise<string> {
+  return getCustomCameraModule().cropImage(uri, options);
+}
+
+export function rotateImage(uri: string, degrees: number): Promise<string> {
+  return getCustomCameraModule().rotateImage(uri, degrees);
+}
+
+export function applyFilter(
+  uri: string,
+  filterType: FilterType = 'none'
+): Promise<string> {
+  return getCustomCameraModule().applyFilter(uri, filterType);
+}
+
+// Media Management Features
+export function createAlbum(albumName: string): Promise<boolean> {
+  return getCustomCameraModule().createAlbum(albumName);
+}
+
+export function moveMediaToAlbum(
+  uris: string[],
+  albumId: string
+): Promise<boolean> {
+  return getCustomCameraModule().moveMediaToAlbum(uris, albumId);
+}
+
+/**
+ * Delete media files, securely overwriting their bytes first (Android).
+ *
+ * Resolves `true` when at least one file was removed. This boolean cannot say
+ * whether the secure overwrite actually succeeded — call
+ * {@link secureDeleteMedia} instead whenever that distinction matters, e.g.
+ * before telling the user their media was securely erased.
+ */
+export function deleteMedia(uris: string[]): Promise<boolean> {
+  return getCustomCameraModule().deleteMedia(uris);
+}
+
+export function setCameraFlash(mode: FlashMode = 'auto'): Promise<void> {
+  return getCustomCameraModule().setCameraFlash(mode);
+}
+
+export function setCameraTimer(delaySeconds: number): Promise<void> {
+  return getCustomCameraModule().setCameraTimer(delaySeconds);
+}
+
+export function enableCameraGrid(enabled: boolean): Promise<void> {
+  return getCustomCameraModule().enableCameraGrid(enabled);
+}
+
+// Metadata Features
+export function setMediaCaption(
+  uri: string,
+  caption: string
+): Promise<boolean> {
+  return getCustomCameraModule().setMediaCaption(uri, caption);
+}
+
+// Video Features
+export function trimVideo(
+  uri: string,
+  startTime: number,
+  endTime: number
+): Promise<string> {
+  return getCustomCameraModule().trimVideo(uri, startTime, endTime);
+}
+
+// Compression (video + image) lives in ./nativeActions with the other bridge
+// calls, so the shipped library shell under src/library/ can reach it without
+// importing this barrel. Re-exported below, unchanged.
+
+// QR Code Features
+export function scanQRCode(): Promise<string> {
+  return getCustomCameraModule().scanQRCode();
+}
+
+export function enableFaceDetection(enabled: boolean): Promise<void> {
+  return getCustomCameraModule().enableFaceDetection(enabled);
+}
+
+export function setFaceEffect(effectType: FaceEffect = 'none'): Promise<void> {
+  return getCustomCameraModule().setFaceEffect(effectType);
+}
+
+export function setCameraTheme(theme: CameraTheme | CameraThemeConfig = 'default'): Promise<void> {
+  setGlobalCameraTheme(theme as CameraTheme);
+  const resolvedTheme = getCurrentCameraTheme();
+  return getCustomCameraModule().setCameraTheme(JSON.stringify(resolvedTheme));
+}
+
+// ===== Media Storage Features =====
+
+export {
+  getMediaStorageManager,
+  initializeMediaStorage,
+  publishCachedMedia,
+  getCacheInfo,
+  cleanupExpiredCache,
+  MediaStorageManager,
+} from './storage';
+
+// Export new media storage service
+export {
+  getMediaStorageService,
+  initializeMediaStorageService,
+  handleCapturedMedia,
+  publishAllCachedMedia,
+  getStorageSummary,
+  MediaStorageService,
+} from './mediaStorageService';
+
+// Re-export storage types
+export type {
+  StoredMediaMetadata,
+  MediaPublishResult,
+  CleanupResult,
+  StorageStats,
+  MediaStorageLocation,
+  MediaStorageStatus,
+  MediaStorageConfig,
+  SecureDeleteOptions,
+  SecureDeleteResult,
+} from './types';
+
+// ── Encrypted media database (SQLCipher) ──────────────────────────
+// Modular, production-ready persistence layer: centralized manager, schema
+// migrations, repository/service, typed models, and a UI hook.
+export {
+  // Manager + lifecycle
+  DatabaseManager,
+  getDatabaseManager,
+  initializeMediaDatabase,
+  // Repository / service
+  MediaRepository,
+  getMediaRepository,
+  // Migrations
+  MIGRATIONS,
+  LATEST_SCHEMA_VERSION,
+  runMigrations,
+  // Mapping helpers
+  assetToRecordInput,
+  recordToAsset,
+  rowToRecord,
+  assetTypeToMediaType,
+  mediaTypeToAssetType,
+  normalizeSource,
+  extensionForMimeType,
+  resolveDocumentsPath,
+  isPublishedToDocuments,
+  detectSource,
+  // Encryption key
+  getDatabaseKey,
+  isHardwareBackedKeyAvailable,
+  // UI hook
+  useMediaDatabase,
+  // Table/column constants
+  MEDIA_TABLE,
+  MediaColumns,
+} from './db';
+
+export type {
+  MediaRecord,
+  MediaRecordInput,
+  MediaType,
+  MediaSource,
+  MediaFilter,
+  MediaCounts,
+  MediaQueryOptions,
+  BatchStatement,
+  Migration,
+  MigrationExecutor,
+  UseMediaDatabaseResult,
+} from './db';
+
+export { NativeCustomVideoView } from './NativeCustomVideoView';
+export type { NativeCustomVideoViewProps } from './NativeCustomVideoView';
+export {
+  NativeAnimatedImageView,
+  isNativeAnimatedImageAvailable,
+} from './NativeAnimatedImageView';
+export type { NativeAnimatedImageViewProps } from './NativeAnimatedImageView';
+export {
+  NativeMediaThumbnailView,
+  MediaThumbnail,
+  isNativeMediaThumbnailAvailable,
+} from './NativeMediaThumbnailView';
+export type {
+  NativeMediaThumbnailViewProps,
+  MediaThumbnailProps,
+} from './NativeMediaThumbnailView';
+export { NativeBlurView } from './NativeBlurView';
+export type { NativeBlurViewProps } from './NativeBlurView';
+export { NativeAudioPlayerView } from './NativeAudioPlayerView';
+export type { NativeAudioPlayerViewProps } from './NativeAudioPlayerView';
+export { GlobalAudioPlayerProvider, GlobalMiniAudioPlayer, useGlobalAudioPlayer } from './AudioPlayerContext';
+export type { GlobalAudioPlayerProviderProps } from './AudioPlayerContext';
+export {
+  NativeDocumentPreviewView,
+  getDocumentPreviewKind,
+  isNativeDocumentPreviewAvailable,
+} from './NativeDocumentPreviewView';
+export type {
+  NativeDocumentPreviewViewProps,
+  DocumentPreviewKind,
+} from './NativeDocumentPreviewView';
+export { CameraPreview } from './CameraPreview';
+export {
+  ResponsivePreviewContainer,
+  PREVIEW_WIDTH,
+  PREVIEW_HEIGHT,
+  WHATSAPP_ASPECT_RATIO,
+  PORTRAIT_PREVIEW_ASPECT_RATIO,
+  DEFAULT_PREVIEW_DIMENSION_CONFIG,
+  calcPreviewDimensions,
+  calcPortraitPreviewDimensions,
+  usePreviewDimensions,
+  usePortraitPreviewDimensions,
+} from './ResponsivePreviewContainer';
+export type { PreviewDimensionConfig } from './ResponsivePreviewContainer';
+
+// ── Audio Recording ─────────────────────────────────────────────────
+// startAudioRecording / stopAudioRecording / cancelAudioRecording /
+// stopAndPublishAudioRecording / pauseAudioRecording / resumeAudioRecording /
+// getAudioRecordingState / getAudioAmplitude are defined in ./nativeActions and
+// re-exported near the top of this file.
+
+// ── Media library shell (the RN screens on top of the native camera) ─
+// `<CameraMediaLibrary />` is the one-element drop-in: the library grid with its
+// five category pills, the swipeable category pager, the Plus/Cross FAB, the
+// full-screen viewer with scrubber + counter, the document/audio preview cards,
+// the record-audio screen, the SQLCipher-backed store and upload progress.
+//
+// Everything it is built from is exported too, so a host can assemble its own
+// screen from the same pieces. See ./library for the folder's own docs.
+export {
+  // Screens
+  CameraMediaLibrary,
+  MediaLibraryScreen,
+  RecordAudioScreen,
+  // Viewer slides
+  ImagePreview,
+  VideoPreview,
+  DocumentPreview,
+  AudioPreview,
+  MediaMetadataHeader,
+  // Chrome
+  ExpandableFab,
+  ViewerCounter,
+  DocumentTile,
+  AudioTile,
+  // Theming / icons / scaling
+  createLibraryIconRegistry,
+  libraryIconRegistry,
+  PlusCloseIcon,
+  CircularSeekIcon,
+  ViewDetailsIcon,
+  libraryPalette,
+  useLibraryPalette,
+  createPalette,
+  wp,
+  hp,
+  ms,
+  fs,
+  SCREEN_W,
+  SCREEN_H,
+  BASE_W,
+  BASE_H,
+  // Metadata helpers
+  getFileSize,
+  refreshAssetMetadata,
+  refreshAssetMetadataBatch,
+} from './library';
+
+export type {
+  CameraMediaLibraryProps,
+  MediaLibraryScreenProps,
+  MediaLibraryFilterKey,
+  RecordAudioScreenProps,
+  VideoPreviewProps,
+  MediaMetadataHeaderProps,
+  ExpandableFabProps,
+  ViewerCounterProps,
+  ViewerCounterHandle,
+  LibraryPalette,
+} from './library';