@idealyst/files 1.2.96

package/src/hooks/createUseFileUploadHook.ts

@@ -0,0 +1,173 @@
+import { useState, useCallback, useEffect, useRef } from 'react';
+import type {
+  UseFileUploadOptions,
+  UseFileUploadResult,
+  QueueStatus,
+  UploadProgressInfo,
+  PickedFile,
+  UploadConfig,
+  IFileUploader,
+  CreateFileUploaderFactory,
+} from '../types';
+import { INITIAL_QUEUE_STATUS, DEFAULT_UPLOAD_CONFIG } from '../constants';
+
+/**
+ * Create a useFileUpload hook with the given file uploader factory.
+ */
+export function createUseFileUploadHook(createFileUploader: CreateFileUploaderFactory) {
+  return function useFileUpload(options: UseFileUploadOptions = {}): UseFileUploadResult {
+    const { config = {}, autoStart = true, concurrency = 3 } = options;
+
+    const uploaderRef = useRef<IFileUploader | null>(null);
+    const configRef = useRef<Partial<Omit<UploadConfig, 'url'>>>(config);
+
+    const [queueStatus, setQueueStatus] = useState<QueueStatus>(INITIAL_QUEUE_STATUS);
+    const [uploads, setUploads] = useState<UploadProgressInfo[]>([]);
+
+    // Update config ref when it changes
+    useEffect(() => {
+      configRef.current = config;
+    }, [config]);
+
+    // Initialize uploader
+    useEffect(() => {
+      const uploader = createFileUploader({ concurrency });
+      uploaderRef.current = uploader;
+
+      // Subscribe to queue changes
+      const unsubscribeQueue = uploader.onQueueChange((status) => {
+        setQueueStatus(status);
+        setUploads(Array.from(uploader.uploads.values()));
+      });
+
+      // Subscribe to completion for final update
+      const unsubscribeComplete = uploader.onComplete(() => {
+        setUploads(Array.from(uploader.uploads.values()));
+      });
+
+      return () => {
+        unsubscribeQueue();
+        unsubscribeComplete();
+        uploader.dispose();
+        uploaderRef.current = null;
+      };
+    }, [concurrency]);
+
+    /**
+     * Add files to upload queue.
+     */
+    const addFiles = useCallback((
+      files: PickedFile | PickedFile[],
+      uploadConfig: UploadConfig
+    ): string[] => {
+      if (!uploaderRef.current) return [];
+
+      const finalConfig: UploadConfig = {
+        ...DEFAULT_UPLOAD_CONFIG,
+        ...configRef.current,
+        ...uploadConfig,
+      } as UploadConfig;
+
+      const ids = uploaderRef.current.add(files, finalConfig);
+
+      if (autoStart) {
+        uploaderRef.current.start();
+      }
+
+      // Update uploads state
+      setUploads(Array.from(uploaderRef.current.uploads.values()));
+
+      return ids;
+    }, [autoStart]);
+
+    /**
+     * Start processing queue.
+     */
+    const start = useCallback(() => {
+      uploaderRef.current?.start();
+    }, []);
+
+    /**
+     * Pause all uploads.
+     */
+    const pause = useCallback(() => {
+      uploaderRef.current?.pause();
+    }, []);
+
+    /**
+     * Resume paused uploads.
+     */
+    const resume = useCallback(() => {
+      uploaderRef.current?.resume();
+    }, []);
+
+    /**
+     * Cancel specific upload.
+     */
+    const cancel = useCallback((uploadId: string) => {
+      uploaderRef.current?.cancel(uploadId);
+    }, []);
+
+    /**
+     * Cancel all uploads.
+     */
+    const cancelAll = useCallback(() => {
+      uploaderRef.current?.cancelAll();
+    }, []);
+
+    /**
+     * Retry failed upload.
+     */
+    const retry = useCallback((uploadId: string) => {
+      uploaderRef.current?.retry(uploadId);
+    }, []);
+
+    /**
+     * Retry all failed uploads.
+     */
+    const retryAll = useCallback(() => {
+      uploaderRef.current?.retryAll();
+    }, []);
+
+    /**
+     * Remove upload from queue.
+     */
+    const remove = useCallback((uploadId: string) => {
+      uploaderRef.current?.remove(uploadId);
+    }, []);
+
+    /**
+     * Clear completed uploads.
+     */
+    const clearCompleted = useCallback(() => {
+      uploaderRef.current?.clearCompleted();
+    }, []);
+
+    /**
+     * Get specific upload.
+     */
+    const getUpload = useCallback((uploadId: string): UploadProgressInfo | undefined => {
+      return uploaderRef.current?.getUpload(uploadId);
+    }, []);
+
+    return {
+      queueStatus,
+      uploads,
+      isUploading: queueStatus.isProcessing,
+      isPaused: queueStatus.isPaused,
+      hasFailedUploads: queueStatus.failed > 0,
+      addFiles,
+      start,
+      pause,
+      resume,
+      cancel,
+      cancelAll,
+      retry,
+      retryAll,
+      remove,
+      clearCompleted,
+      getUpload,
+      uploaderRef,
+    };
+  };
+}

package/src/hooks/index.native.ts

@@ -0,0 +1,12 @@
+import { createUseFilePickerHook } from './createUseFilePickerHook';
+import { createUseFileUploadHook } from './createUseFileUploadHook';
+import { createFilePicker } from '../picker/FilePicker.native';
+import { createFileUploader } from '../uploader/FileUploader.native';
+
+// Export hook factories
+export { createUseFilePickerHook } from './createUseFilePickerHook';
+export { createUseFileUploadHook } from './createUseFileUploadHook';
+
+// Create and export hooks with native-specific factories
+export const useFilePicker = createUseFilePickerHook(createFilePicker);
+export const useFileUpload = createUseFileUploadHook(createFileUploader);

package/src/hooks/index.ts

@@ -0,0 +1,12 @@
+import { createUseFilePickerHook } from './createUseFilePickerHook';
+import { createUseFileUploadHook } from './createUseFileUploadHook';
+import { createFilePicker } from '../picker';
+import { createFileUploader } from '../uploader';
+
+// Export hook factories
+export { createUseFilePickerHook } from './createUseFilePickerHook';
+export { createUseFileUploadHook } from './createUseFileUploadHook';
+
+// Create and export hooks with platform-specific factories
+export const useFilePicker = createUseFilePickerHook(createFilePicker);
+export const useFileUpload = createUseFileUploadHook(createFileUploader);

package/src/hooks/index.web.ts

@@ -0,0 +1,12 @@
+import { createUseFilePickerHook } from './createUseFilePickerHook';
+import { createUseFileUploadHook } from './createUseFileUploadHook';
+import { createFilePicker } from '../picker/FilePicker.web';
+import { createFileUploader } from '../uploader/FileUploader.web';
+
+// Export hook factories
+export { createUseFilePickerHook } from './createUseFilePickerHook';
+export { createUseFileUploadHook } from './createUseFileUploadHook';
+
+// Create and export hooks with web-specific factories
+export const useFilePicker = createUseFilePickerHook(createFilePicker);
+export const useFileUpload = createUseFileUploadHook(createFileUploader);

package/src/index.native.ts

@@ -0,0 +1,142 @@
+// Types - re-export everything from main types
+export type {
+  // File types
+  FileType,
+  PickedFile,
+  FilePickerConfig,
+  FilePickerResult,
+  ValidationResult,
+  RejectedFile,
+  RejectionReason,
+
+  // Camera types
+  CameraMediaType,
+  CameraOptions,
+
+  // Picker types
+  FilePickerState,
+  FilePickerStatus,
+  IFilePicker,
+
+  // Upload types
+  UploadMethod,
+  RetryDelayStrategy,
+  UploadConfig,
+  UploadState,
+  UploadProgressInfo,
+  UploadResult,
+  QueueStatus,
+  IFileUploader,
+
+  // Error types
+  FilePickerErrorCode,
+  FilePickerError,
+  UploadErrorCode,
+  UploadError,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Hook types
+  UseFilePickerOptions,
+  UseFilePickerResult,
+  UseFileUploadOptions,
+  UseFileUploadResult,
+
+  // Component types
+  ButtonVariant,
+  Size,
+  Intent,
+  FilePickerButtonProps,
+  DropZoneState,
+  DropZoneProps,
+  ProgressVariant,
+  UploadProgressProps,
+
+  // Preset types
+  FilePickerPresets,
+  UploadPresets,
+
+  // Factory types
+  CreateFilePickerFactory,
+  CreateFileUploaderFactory,
+  CreateFileUploaderOptions,
+
+  // Chunked upload types
+  ChunkProgress,
+  ChunkUploadConfig,
+  ChunkUploadResponse,
+} from './types';
+
+// Constants
+export {
+  FILE_TYPE_MIME_TYPES,
+  FILE_TYPE_EXTENSIONS,
+  DOCUMENT_PICKER_TYPES,
+  DEFAULT_FILE_PICKER_CONFIG,
+  DEFAULT_UPLOAD_CONFIG,
+  INITIAL_FILE_PICKER_STATUS,
+  INITIAL_QUEUE_STATUS,
+  FILE_PICKER_PRESETS,
+  UPLOAD_PRESETS,
+  SIZE_LIMITS,
+  TIMING,
+  FILE_PICKER_ERROR_MESSAGES,
+  UPLOAD_ERROR_MESSAGES,
+} from './constants';
+
+// Utilities
+export {
+  generateId,
+  formatBytes,
+  parseSize,
+  formatDuration,
+  getMimeTypes,
+  getExtensions,
+  buildAcceptString,
+  getFileExtension,
+  getFileTypeFromMime,
+  isMimeTypeAllowed,
+  validateFiles,
+  createPickedFileFromFile,
+  revokeFileUri,
+  revokeFileUris,
+  createFilePickerError,
+  createUploadError,
+  mergeFilePickerConfig,
+  mergeUploadConfig,
+  SpeedCalculator,
+  calculateETA,
+  calculateRetryDelay,
+  isRetryableError,
+  calculateChunkCount,
+  getChunkBoundaries,
+  shouldUseChunkedUpload,
+  EventEmitter,
+} from './utils';
+
+// Permissions (native-specific)
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions/index.native';
+
+// Picker (native-specific)
+export { createFilePicker, NativeFilePicker } from './picker/index.native';
+
+// Uploader (native-specific)
+export { UploadQueue, ChunkedUploader, createChunkedUploader, createFileUploader, NativeFileUploader } from './uploader/index.native';
+
+// Hooks (native-specific)
+export { useFilePicker, useFileUpload, createUseFilePickerHook, createUseFileUploadHook } from './hooks/index.native';
+
+// Components (native-specific)
+export { FilePickerButton, DropZone, UploadProgress } from './components/index.native';
+
+// Styles
+export { filePickerButtonStyles, dropZoneStyles, uploadProgressStyles } from './components/index.native';

package/src/index.ts

@@ -0,0 +1,139 @@
+// Types
+export type {
+  // File types
+  FileType,
+  PickedFile,
+  FilePickerConfig,
+  FilePickerResult,
+  ValidationResult,
+  RejectedFile,
+  RejectionReason,
+
+  // Camera types
+  CameraMediaType,
+  CameraOptions,
+
+  // Picker types
+  FilePickerState,
+  FilePickerStatus,
+  IFilePicker,
+
+  // Upload types
+  UploadMethod,
+  RetryDelayStrategy,
+  UploadConfig,
+  UploadState,
+  UploadProgressInfo,
+  UploadResult,
+  QueueStatus,
+  IFileUploader,
+
+  // Error types
+  FilePickerErrorCode,
+  FilePickerError,
+  UploadErrorCode,
+  UploadError,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Hook types
+  UseFilePickerOptions,
+  UseFilePickerResult,
+  UseFileUploadOptions,
+  UseFileUploadResult,
+
+  // Component types
+  ButtonVariant,
+  Size,
+  Intent,
+  FilePickerButtonProps,
+  DropZoneState,
+  DropZoneProps,
+  ProgressVariant,
+  UploadProgressProps,
+
+  // Preset types
+  FilePickerPresets,
+  UploadPresets,
+
+  // Factory types
+  CreateFilePickerFactory,
+  CreateFileUploaderFactory,
+  CreateFileUploaderOptions,
+
+  // Chunked upload types
+  ChunkProgress,
+  ChunkUploadConfig,
+  ChunkUploadResponse,
+} from './types';
+
+// Constants
+export {
+  FILE_TYPE_MIME_TYPES,
+  FILE_TYPE_EXTENSIONS,
+  DOCUMENT_PICKER_TYPES,
+  DEFAULT_FILE_PICKER_CONFIG,
+  DEFAULT_UPLOAD_CONFIG,
+  INITIAL_FILE_PICKER_STATUS,
+  INITIAL_QUEUE_STATUS,
+  FILE_PICKER_PRESETS,
+  UPLOAD_PRESETS,
+  SIZE_LIMITS,
+  TIMING,
+  FILE_PICKER_ERROR_MESSAGES,
+  UPLOAD_ERROR_MESSAGES,
+} from './constants';
+
+// Utilities
+export {
+  generateId,
+  formatBytes,
+  parseSize,
+  formatDuration,
+  getMimeTypes,
+  getExtensions,
+  buildAcceptString,
+  getFileExtension,
+  getFileTypeFromMime,
+  isMimeTypeAllowed,
+  validateFiles,
+  createPickedFileFromFile,
+  revokeFileUri,
+  revokeFileUris,
+  createFilePickerError,
+  createUploadError,
+  mergeFilePickerConfig,
+  mergeUploadConfig,
+  SpeedCalculator,
+  calculateETA,
+  calculateRetryDelay,
+  isRetryableError,
+  calculateChunkCount,
+  getChunkBoundaries,
+  shouldUseChunkedUpload,
+  EventEmitter,
+} from './utils';
+
+// Permissions
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions';
+
+// Picker
+export { createFilePicker } from './picker';
+
+// Uploader
+export { UploadQueue, ChunkedUploader, createChunkedUploader, createFileUploader } from './uploader';
+
+// Hooks
+export { useFilePicker, useFileUpload, createUseFilePickerHook, createUseFileUploadHook } from './hooks';
+
+// Styles (components are platform-specific, exported from index.web.ts and index.native.ts)
+export { filePickerButtonStyles, dropZoneStyles, uploadProgressStyles } from './components';

package/src/index.web.ts

@@ -0,0 +1,142 @@
+// Types - re-export everything from main types
+export type {
+  // File types
+  FileType,
+  PickedFile,
+  FilePickerConfig,
+  FilePickerResult,
+  ValidationResult,
+  RejectedFile,
+  RejectionReason,
+
+  // Camera types
+  CameraMediaType,
+  CameraOptions,
+
+  // Picker types
+  FilePickerState,
+  FilePickerStatus,
+  IFilePicker,
+
+  // Upload types
+  UploadMethod,
+  RetryDelayStrategy,
+  UploadConfig,
+  UploadState,
+  UploadProgressInfo,
+  UploadResult,
+  QueueStatus,
+  IFileUploader,
+
+  // Error types
+  FilePickerErrorCode,
+  FilePickerError,
+  UploadErrorCode,
+  UploadError,
+
+  // Permission types
+  PermissionStatus,
+  PermissionResult,
+
+  // Hook types
+  UseFilePickerOptions,
+  UseFilePickerResult,
+  UseFileUploadOptions,
+  UseFileUploadResult,
+
+  // Component types
+  ButtonVariant,
+  Size,
+  Intent,
+  FilePickerButtonProps,
+  DropZoneState,
+  DropZoneProps,
+  ProgressVariant,
+  UploadProgressProps,
+
+  // Preset types
+  FilePickerPresets,
+  UploadPresets,
+
+  // Factory types
+  CreateFilePickerFactory,
+  CreateFileUploaderFactory,
+  CreateFileUploaderOptions,
+
+  // Chunked upload types
+  ChunkProgress,
+  ChunkUploadConfig,
+  ChunkUploadResponse,
+} from './types';
+
+// Constants
+export {
+  FILE_TYPE_MIME_TYPES,
+  FILE_TYPE_EXTENSIONS,
+  DOCUMENT_PICKER_TYPES,
+  DEFAULT_FILE_PICKER_CONFIG,
+  DEFAULT_UPLOAD_CONFIG,
+  INITIAL_FILE_PICKER_STATUS,
+  INITIAL_QUEUE_STATUS,
+  FILE_PICKER_PRESETS,
+  UPLOAD_PRESETS,
+  SIZE_LIMITS,
+  TIMING,
+  FILE_PICKER_ERROR_MESSAGES,
+  UPLOAD_ERROR_MESSAGES,
+} from './constants';
+
+// Utilities
+export {
+  generateId,
+  formatBytes,
+  parseSize,
+  formatDuration,
+  getMimeTypes,
+  getExtensions,
+  buildAcceptString,
+  getFileExtension,
+  getFileTypeFromMime,
+  isMimeTypeAllowed,
+  validateFiles,
+  createPickedFileFromFile,
+  revokeFileUri,
+  revokeFileUris,
+  createFilePickerError,
+  createUploadError,
+  mergeFilePickerConfig,
+  mergeUploadConfig,
+  SpeedCalculator,
+  calculateETA,
+  calculateRetryDelay,
+  isRetryableError,
+  calculateChunkCount,
+  getChunkBoundaries,
+  shouldUseChunkedUpload,
+  EventEmitter,
+} from './utils';
+
+// Permissions (web-specific)
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions/index.web';
+
+// Picker (web-specific)
+export { createFilePicker, WebFilePicker } from './picker/index.web';
+
+// Uploader (web-specific)
+export { UploadQueue, ChunkedUploader, createChunkedUploader, createFileUploader, WebFileUploader } from './uploader/index.web';
+
+// Hooks (web-specific)
+export { useFilePicker, useFileUpload, createUseFilePickerHook, createUseFileUploadHook } from './hooks/index.web';
+
+// Components (web-specific)
+export { FilePickerButton, DropZone, UploadProgress } from './components/index.web';
+
+// Styles
+export { filePickerButtonStyles, dropZoneStyles, uploadProgressStyles } from './components/index.web';

package/src/permissions/index.native.ts

@@ -0,0 +1,8 @@
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions.native';

package/src/permissions/index.ts

@@ -0,0 +1,8 @@
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions.web';

package/src/permissions/index.web.ts

@@ -0,0 +1,8 @@
+export {
+  checkPhotoLibraryPermission,
+  requestPhotoLibraryPermission,
+  checkCameraPermission,
+  requestCameraPermission,
+  checkPermissions,
+  requestPermissions,
+} from './permissions.web';