rn-file-toolkit 1.0.9 → 1.0.11

package/lib/typescript/module/src/NativeFileToolkit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeFileToolkit.d.ts","sourceRoot":"","sources":["../../../../src/NativeFileToolkit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NativeFileToolkit.d.ts","sourceRoot":"","sources":["../../../../src/NativeFileToolkit.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/src/index.d.ts

@@ -11,7 +11,9 @@ export interface DownloadOptions {
     background?: boolean;
     headers?: Record<string, string>;
     destination?: 'downloads' | 'cache' | 'documents';
+    /** Notification title shown during background download. @platform Android */
     notificationTitle?: string;
+    /** Notification description shown during background download. @platform Android */
     notificationDescription?: string;
     checksum?: {
         hash: string;
@@ -185,7 +187,18 @@ export declare function cancelDownload(id: string): Promise<ActionResult>;
 export declare function getCachedFiles(): Promise<CacheResult>;
 export declare function deleteFile(path: string): Promise<ActionResult>;
 export declare function clearCache(): Promise<ActionResult>;
-export declare function getBackgroundDownloads(): Promise<any>;
+export interface BackgroundDownloadInfo {
+    downloadId: string;
+    url: string;
+    status: number;
+    progress: number;
+}
+export interface BackgroundDownloadsResult {
+    success: boolean;
+    downloads?: BackgroundDownloadInfo[];
+    error?: string;
+}
+export declare function getBackgroundDownloads(): Promise<BackgroundDownloadsResult>;
 export declare function exists(path: string): Promise<boolean>;
 export declare function stat(path: string): Promise<FsStat>;
 export declare function readFile(path: string, enc?: FsEncoding): Promise<string>;
@@ -198,18 +211,62 @@ export declare function df(): Promise<DiskSpaceResult>;
 export declare function appendFile(path: string, data: string, enc?: FsEncoding): Promise<void>;
 export declare function hash(path: string, algorithm?: HashAlgorithm): Promise<HashResult>;
 export declare function getCookies(domain: string): Promise<CookiesResult>;
-export declare function clearCookies(domain?: string): Promise<ActionResult>;
+export declare function clearAllCookies(): Promise<ActionResult>;
+export declare function clearCookies(domain: string): Promise<ActionResult>;
 export declare function saveToMediaStore(opts: MediaStoreOptions): Promise<MediaStoreResult>;
+/**
+ * Session management API for grouping downloaded files into named sessions.
+ *
+ * @remarks
+ * Sessions are stored in JS memory only — they do **not** persist across app
+ * restarts or React Native hot-reloads. Use sessions for temporary grouping
+ * within a single app lifecycle (e.g., clearing temp files on user logout).
+ */
 export declare const session: SessionApi;
 export declare const cookies: {
     get: typeof getCookies;
     clear: typeof clearCookies;
+    clearAll: typeof clearAllCookies;
 };
+/**
+ * File system API — POSIX-style operations.
+ *
+ * @remarks
+ * All `fs.*` methods **throw** on failure (via exceptions), unlike top-level
+ * helpers such as `deleteFile()` which return `{ success: false }`.
+ *
+ * To avoid IDE auto-import conflicts with Node's built-in `fs`, consider:
+ * ```ts
+ * import { fs as fileSystem } from 'rn-file-toolkit';
+ * ```
+ */
 export declare const fs: FsApi;
-export declare function onDownloadComplete(cb: any): () => void;
-export declare function onDownloadError(cb: any): () => void;
-export declare function onUploadProgress(cb: any): () => void;
-export declare function onDownloadRetry(cb: any): () => void;
+export interface DownloadCompleteEvent {
+    success: boolean;
+    downloadId: string;
+    filePath?: string;
+    error?: string;
+}
+export interface DownloadErrorEvent {
+    success: boolean;
+    downloadId: string;
+    error: string;
+}
+export interface UploadProgressEvent {
+    url: string;
+    uploadId: string;
+    progress: number;
+}
+export interface DownloadRetryEvent {
+    downloadId: string;
+    url: string;
+    attempt: number;
+    error: string;
+}
+export declare function onDownloadComplete(cb: (event: DownloadCompleteEvent) => void): () => void;
+export declare function onDownloadError(cb: (event: DownloadErrorEvent) => void): () => void;
+export declare function onUploadProgress(cb: (event: UploadProgressEvent) => void): () => void;
+export declare function onDownloadRetry(cb: (event: DownloadRetryEvent) => void): () => void;
 export declare function saveBase64AsFile(opts: SaveBase64Options): Promise<SaveBase64Result>;
 export declare function urlToBase64(opts: UrlToBase64Options): Promise<UrlToBase64Result>;
 export declare function shareFile(opts: ShareFileOptions): Promise<ShareFileResult>;
@@ -225,8 +282,8 @@ export interface ZipResult {
     zipPath?: string;
     error?: string;
 }
-export declare function unzip(s: string, d: string): Promise<UnzipResult>;
-export declare function zip(s: string, d: string): Promise<ZipResult>;
+export declare function unzip(sourcePath: string, destDir: string): Promise<UnzipResult>;
+export declare function zip(sourcePath: string, destPath: string): Promise<ZipResult>;
 export interface UseDownloadReturn {
     start: (options: DownloadOptions) => Promise<DownloadResult>;
     pause: () => Promise<void>;
@@ -237,7 +294,29 @@ export interface UseDownloadReturn {
     result: DownloadResult | null;
     downloadId: string | null;
 }
+/**
+ * React hook for managing a single download with progress, pause/resume, and cancel.
+ *
+ * @remarks
+ * The `start` callback is memoised with an empty dependency array but uses a
+ * ref internally to always read the **latest** `onProgress` callback you pass,
+ * so you do not need to memoise your options object.
+ */
 export declare function useDownload(): UseDownloadReturn;
+/**
+ * Default export — provides all APIs as a single namespace.
+ *
+ * **For optimal tree-shaking, prefer named imports:**
+ * ```ts
+ * import { download, upload, fs } from 'rn-file-toolkit';
+ * ```
+ *
+ * **Error handling patterns:**
+ * - Top-level functions (`download`, `upload`, `deleteFile`, etc.) return
+ *   `{ success: boolean; error?: string }` and **never throw**.
+ * - `fs.*` methods **throw** on failure via exceptions.
+ * - `useDownload()` sets `status` to `'error'` on failure.
+ */
 declare const _default: {
     download: typeof download;
     upload: typeof upload;
@@ -271,11 +350,13 @@ declare const _default: {
     hash: typeof hash;
     getCookies: typeof getCookies;
     clearCookies: typeof clearCookies;
+    clearAllCookies: typeof clearAllCookies;
     saveToMediaStore: typeof saveToMediaStore;
     fs: FsApi;
     cookies: {
         get: typeof getCookies;
         clear: typeof clearCookies;
+        clearAll: typeof clearAllCookies;
     };
     session: SessionApi;
     useDownload: typeof useDownload;

package/lib/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-file-toolkit",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "The ultimate native file management toolkit for React Native. Features background downloads, resumable uploads, filesystem operations, queues, zip/unzip, and media utilities with zero third-party dependencies.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -24,7 +24,6 @@
     "lib",
     "android",
     "ios",
-    "cpp",
     "*.podspec",
     "react-native.config.js",
     "app.plugin.js",

package/react-native.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {},
+      ios: {},
+    },
+  },
+};

package/src/NativeFileToolkit.ts

@@ -30,6 +30,10 @@ export interface Spec extends TurboModule {
   getCookies(domain: string): Promise<Object>;
   clearCookies(domain: string): Promise<Object>;
   saveToMediaStore(options: Object): Promise<Object>;
+
+  // Event emitter support
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('FileToolkit');

package/src/index.tsx

@@ -1,9 +1,16 @@
-import { useState, useCallback, useRef } from 'react';
+import { useState, useCallback, useRef, useEffect } from 'react';
 import { NativeEventEmitter, NativeModules } from 'react-native';
 import FileToolkitSpec from './NativeFileToolkit';
 
 const FileToolkitModule = NativeModules.FileToolkit || FileToolkitSpec;
-const eventEmitter = new NativeEventEmitter(FileToolkitModule);
+
+let _eventEmitter: NativeEventEmitter | null = null;
+function getEventEmitter(): NativeEventEmitter {
+  if (!_eventEmitter) {
+    _eventEmitter = new NativeEventEmitter(FileToolkitModule);
+  }
+  return _eventEmitter;
+}
 
 export interface ProgressInfo {
   percent: number;
@@ -19,7 +26,9 @@ export interface DownloadOptions {
   background?: boolean;
   headers?: Record<string, string>;
   destination?: 'downloads' | 'cache' | 'documents';
+  /** Notification title shown during background download. @platform Android */
   notificationTitle?: string;
+  /** Notification description shown during background download. @platform Android */
   notificationDescription?: string;
   checksum?: {
     hash: string;
@@ -282,11 +291,27 @@ class DownloadQueue {
 const _globalQueue = new DownloadQueue();
 
 function _generateId(): string {
-  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-    const r = Math.floor(Math.random() * 16);
-    const v = c === 'x' ? r : (r % 4) + 8;
-    return v.toString(16);
-  });
+  // Use crypto.getRandomValues (available on Hermes since RN 0.73) for collision resistance
+  if (
+    typeof globalThis.crypto !== 'undefined' &&
+    typeof globalThis.crypto.getRandomValues === 'function'
+  ) {
+    const bytes = new Uint8Array(16);
+    globalThis.crypto.getRandomValues(bytes);
+    bytes[6] = (bytes[6]! & 0x0f) | 0x40; // version 4
+    bytes[8] = (bytes[8]! & 0x3f) | 0x80; // variant 1
+    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join(
+      ''
+    );
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(
+      12,
+      16
+    )}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+  }
+  // Fallback for older Hermes: timestamp + random suffix for uniqueness
+  return `${Date.now().toString(36)}-${Math.random()
+    .toString(36)
+    .slice(2, 10)}`;
 }
 
 export function setQueueOptions(options: QueueOptions): void {
@@ -309,7 +334,7 @@ async function _executeDownload(
   let _smoothedSpeedBps: number = 0;
 
   if (options.onProgress) {
-    progressSubscription = eventEmitter.addListener(
+    progressSubscription = getEventEmitter().addListener(
       'onDownloadProgress',
       (event: any) => {
         const matchesId = event.downloadId === knownDownloadId;
@@ -352,7 +377,7 @@ async function _executeDownload(
   }
 
   if (options.retry?.onRetry) {
-    retrySubscription = eventEmitter.addListener(
+    retrySubscription = getEventEmitter().addListener(
       'onDownloadRetry',
       (event: any) => {
         const matchesId = event.downloadId === knownDownloadId;
@@ -370,13 +395,26 @@ async function _executeDownload(
   };
 
   try {
-    const result = await (FileToolkitModule as any).download({
+    // Strip JS-only fields — functions cannot be serialized across the native bridge
+    const nativeOpts: any = {
       ...options,
       downloadId,
       background: options.background ?? false,
       headers: options.headers ?? {},
       destination: options.destination ?? 'downloads',
-    });
+    };
+    // Strip JS-only fields — functions cannot be serialized across the native bridge
+    delete nativeOpts.onProgress;
+    delete nativeOpts.queue;
+    delete nativeOpts.priority;
+    if (nativeOpts.retry) {
+      // Reconstruct retry without the onRetry callback to prevent function leak
+      nativeOpts.retry = {
+        attempts: nativeOpts.retry.attempts ?? 0,
+        delay: nativeOpts.retry.delay,
+      };
+    }
+    const result = await (FileToolkitModule as any).download(nativeOpts);
     cleanup();
     return result as DownloadResult;
   } catch (error: any) {
@@ -394,18 +432,21 @@ export async function upload(options: UploadOptions): Promise<UploadResult> {
   let sub: any = null;
   const uploadId = options.uploadId || _generateId();
   if (options.onProgress) {
-    sub = eventEmitter.addListener('onUploadProgress', (e: any) => {
+    sub = getEventEmitter().addListener('onUploadProgress', (e: any) => {
       if (e.uploadId === uploadId) options.onProgress!(e.progress);
     });
   }
   try {
-    const res = await (FileToolkitModule as any).upload({
+    // Strip onProgress callback — functions cannot be serialized across the native bridge
+    const nativeUploadOpts: any = {
       ...options,
       uploadId,
       fieldName: options.fieldName ?? 'file',
       headers: options.headers ?? {},
       parameters: options.parameters ?? {},
-    });
+    };
+    delete nativeUploadOpts.onProgress;
+    const res = await (FileToolkitModule as any).upload(nativeUploadOpts);
     sub?.remove();
     return { ...res, uploadId } as UploadResult;
   } catch (err: any) {
@@ -462,7 +503,20 @@ export async function clearCache(): Promise<ActionResult> {
   }
 }
 
-export async function getBackgroundDownloads(): Promise<any> {
+export interface BackgroundDownloadInfo {
+  downloadId: string;
+  url: string;
+  status: number;
+  progress: number;
+}
+
+export interface BackgroundDownloadsResult {
+  success: boolean;
+  downloads?: BackgroundDownloadInfo[];
+  error?: string;
+}
+
+export async function getBackgroundDownloads(): Promise<BackgroundDownloadsResult> {
   try {
     return await (FileToolkitModule as any).getBackgroundDownloads();
   } catch (err: any) {
@@ -561,7 +615,11 @@ export async function getCookies(domain: string): Promise<CookiesResult> {
   }
 }
 
-export async function clearCookies(domain: string = ''): Promise<ActionResult> {
+export async function clearAllCookies(): Promise<ActionResult> {
+  return clearCookies('');
+}
+
+export async function clearCookies(domain: string): Promise<ActionResult> {
   try {
     return await (FileToolkitModule as any).clearCookies(domain);
   } catch (err: any) {
@@ -626,6 +684,14 @@ async function _sessionClearAll(): Promise<ActionResult> {
     : { success: true };
 }
 
+/**
+ * Session management API for grouping downloaded files into named sessions.
+ *
+ * @remarks
+ * Sessions are stored in JS memory only — they do **not** persist across app
+ * restarts or React Native hot-reloads. Use sessions for temporary grouping
+ * within a single app lifecycle (e.g., clearing temp files on user logout).
+ */
 export const session: SessionApi = {
   add: _sessionAdd,
   get: _sessionGet,
@@ -636,8 +702,21 @@ export const session: SessionApi = {
 export const cookies = {
   get: getCookies,
   clear: clearCookies,
+  clearAll: clearAllCookies,
 };
 
+/**
+ * File system API — POSIX-style operations.
+ *
+ * @remarks
+ * All `fs.*` methods **throw** on failure (via exceptions), unlike top-level
+ * helpers such as `deleteFile()` which return `{ success: false }`.
+ *
+ * To avoid IDE auto-import conflicts with Node's built-in `fs`, consider:
+ * ```ts
+ * import { fs as fileSystem } from 'rn-file-toolkit';
+ * ```
+ */
 export const fs: FsApi = {
   exists,
   stat,
@@ -647,7 +726,8 @@ export const fs: FsApi = {
   copyFile,
   moveFile,
   deleteFile: async (p) => {
-    _ensure(await deleteFile(p), 'DEL_ERROR');
+    const res = await (FileToolkitModule as any).deleteFile(p);
+    _ensure(res, 'DEL_ERROR');
   },
   mkdir,
   ls,
@@ -655,20 +735,66 @@ export const fs: FsApi = {
   hash,
 };
 
-export function onDownloadComplete(cb: any) {
-  const s = eventEmitter.addListener('onDownloadComplete', cb);
+export interface DownloadCompleteEvent {
+  success: boolean;
+  downloadId: string;
+  filePath?: string;
+  error?: string;
+}
+
+export interface DownloadErrorEvent {
+  success: boolean;
+  downloadId: string;
+  error: string;
+}
+
+export interface UploadProgressEvent {
+  url: string;
+  uploadId: string;
+  progress: number;
+}
+
+export interface DownloadRetryEvent {
+  downloadId: string;
+  url: string;
+  attempt: number;
+  error: string;
+}
+
+export function onDownloadComplete(
+  cb: (event: DownloadCompleteEvent) => void
+): () => void {
+  const s = getEventEmitter().addListener(
+    'onDownloadComplete',
+    cb as (event: any) => void
+  );
   return () => s.remove();
 }
-export function onDownloadError(cb: any) {
-  const s = eventEmitter.addListener('onDownloadError', cb);
+export function onDownloadError(
+  cb: (event: DownloadErrorEvent) => void
+): () => void {
+  const s = getEventEmitter().addListener(
+    'onDownloadError',
+    cb as (event: any) => void
+  );
   return () => s.remove();
 }
-export function onUploadProgress(cb: any) {
-  const s = eventEmitter.addListener('onUploadProgress', cb);
+export function onUploadProgress(
+  cb: (event: UploadProgressEvent) => void
+): () => void {
+  const s = getEventEmitter().addListener(
+    'onUploadProgress',
+    cb as (event: any) => void
+  );
   return () => s.remove();
 }
-export function onDownloadRetry(cb: any) {
-  const s = eventEmitter.addListener('onDownloadRetry', cb);
+export function onDownloadRetry(
+  cb: (event: DownloadRetryEvent) => void
+): () => void {
+  const s = getEventEmitter().addListener(
+    'onDownloadRetry',
+    cb as (event: any) => void
+  );
   return () => s.remove();
 }
 
@@ -739,19 +865,25 @@ export interface ZipResult {
   error?: string;
 }
 
-export async function unzip(s: string, d: string): Promise<UnzipResult> {
+export async function unzip(
+  sourcePath: string,
+  destDir: string
+): Promise<UnzipResult> {
   try {
-    return await (FileToolkitModule as any).unzip(s, d);
-  } catch {
-    return { success: false, error: 'UNZIP_ERROR' };
+    return await (FileToolkitModule as any).unzip(sourcePath, destDir);
+  } catch (err: any) {
+    return { success: false, error: err?.message || 'UNZIP_ERROR' };
   }
 }
 
-export async function zip(s: string, d: string): Promise<ZipResult> {
+export async function zip(
+  sourcePath: string,
+  destPath: string
+): Promise<ZipResult> {
   try {
-    return await (FileToolkitModule as any).zip(s, d);
-  } catch {
-    return { success: false, error: 'ZIP_ERROR' };
+    return await (FileToolkitModule as any).zip(sourcePath, destPath);
+  } catch (err: any) {
+    return { success: false, error: err?.message || 'ZIP_ERROR' };
   }
 }
 
@@ -766,14 +898,34 @@ export interface UseDownloadReturn {
   downloadId: string | null;
 }
 
+/**
+ * React hook for managing a single download with progress, pause/resume, and cancel.
+ *
+ * @remarks
+ * The `start` callback is memoised with an empty dependency array but uses a
+ * ref internally to always read the **latest** `onProgress` callback you pass,
+ * so you do not need to memoise your options object.
+ */
 export function useDownload(): UseDownloadReturn {
   const [status, setStatus] = useState<any>('idle');
   const [progress, setProgress] = useState<ProgressInfo | null>(null);
   const [result, setResult] = useState<DownloadResult | null>(null);
   const [downloadId, setDownloadId] = useState<string | null>(null);
   const downloadIdRef = useRef<string | null>(null);
+  const latestOptsRef = useRef<DownloadOptions | null>(null);
+
+  // Cancel any in-flight download when the component unmounts to prevent
+  // native event listeners from calling setState on an unmounted component.
+  useEffect(() => {
+    return () => {
+      if (downloadIdRef.current) {
+        cancelDownload(downloadIdRef.current);
+      }
+    };
+  }, []);
 
   const start = useCallback(async (opts: DownloadOptions) => {
+    latestOptsRef.current = opts;
     const id = opts.downloadId || _generateId();
     setStatus('downloading');
     setProgress(null);
@@ -785,7 +937,8 @@ export function useDownload(): UseDownloadReturn {
       downloadId: id,
       onProgress: (p) => {
         setProgress(p);
-        opts.onProgress?.(p);
+        // Always call the latest onProgress — avoids stale-closure issues
+        latestOptsRef.current?.onProgress?.(p);
       },
     });
     setResult(res);
@@ -801,14 +954,14 @@ export function useDownload(): UseDownloadReturn {
 
   const pause = useCallback(async () => {
     if (downloadIdRef.current) {
-      await pauseDownload(downloadIdRef.current);
-      setStatus('paused');
+      const res = await pauseDownload(downloadIdRef.current);
+      if (res.success) setStatus('paused');
     }
   }, []);
   const resume = useCallback(async () => {
     if (downloadIdRef.current) {
-      await resumeDownload(downloadIdRef.current);
-      setStatus('downloading');
+      const res = await resumeDownload(downloadIdRef.current);
+      if (res.success) setStatus('downloading');
     }
   }, []);
   const cancel = useCallback(async () => {
@@ -825,6 +978,20 @@ export function useDownload(): UseDownloadReturn {
   return { start, pause, resume, cancel, status, progress, result, downloadId };
 }
 
+/**
+ * Default export — provides all APIs as a single namespace.
+ *
+ * **For optimal tree-shaking, prefer named imports:**
+ * ```ts
+ * import { download, upload, fs } from 'rn-file-toolkit';
+ * ```
+ *
+ * **Error handling patterns:**
+ * - Top-level functions (`download`, `upload`, `deleteFile`, etc.) return
+ *   `{ success: boolean; error?: string }` and **never throw**.
+ * - `fs.*` methods **throw** on failure via exceptions.
+ * - `useDownload()` sets `status` to `'error'` on failure.
+ */
 export default {
   download,
   upload,
@@ -858,6 +1025,7 @@ export default {
   hash,
   getCookies,
   clearCookies,
+  clearAllCookies,
   saveToMediaStore,
   fs,
   cookies,