@dynlabs/react-native-immutable-file-cache 1.0.0-alpha.1

package/lib/module/adapters/rnfsAdapter.js

@@ -0,0 +1,251 @@
+/**
+ * React Native FS Adapter
+ *
+ * This is the ONLY file that imports react-native-fs.
+ * Implements IStorageAdapter using RNFS APIs.
+ */
+
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/* eslint-disable @typescript-eslint/no-unsafe-argument */
+/* eslint-disable @typescript-eslint/require-await */
+
+// RNFS types are not fully typed, disable unsafe rules for this adapter
+import RNFS from "react-native-fs";
+import { UnsupportedSourceError, AdapterIOError } from "../core/errors";
+/**
+ * Creates a storage adapter backed by react-native-fs.
+ */
+export function createRnfsAdapter(options) {
+  const baseDir = options?.baseDir ?? RNFS.CachesDirectoryPath;
+  const namespace = options?.namespace ?? "default";
+  const rootPath = `${baseDir}/immutable-cache/${namespace}`;
+
+  /**
+   * Converts adapter-relative path to absolute filesystem path.
+   */
+  const toAbsolute = path => {
+    return `${rootPath}/${path}`;
+  };
+
+  /**
+   * Generates a unique temp file path for atomic writes.
+   */
+  const getTempPath = path => {
+    return `${toAbsolute(path)}.tmp.${Date.now()}.${Math.random().toString(36).slice(2)}`;
+  };
+  const adapter = {
+    kind: "native-fs",
+    rootId: rootPath,
+    // ─────────────────────────────────────────────────────────────────
+    // Directory Management
+    // ─────────────────────────────────────────────────────────────────
+
+    async ensureDir(path) {
+      try {
+        const absPath = toAbsolute(path);
+        await RNFS.mkdir(absPath);
+      } catch (error) {
+        throw new AdapterIOError("ensureDir", path, error);
+      }
+    },
+    async exists(path) {
+      try {
+        const absPath = toAbsolute(path);
+        return await RNFS.exists(absPath);
+      } catch {
+        return false;
+      }
+    },
+    async remove(path) {
+      try {
+        const absPath = toAbsolute(path);
+        const exists = await RNFS.exists(absPath);
+        if (exists) {
+          await RNFS.unlink(absPath);
+        }
+      } catch (error) {
+        throw new AdapterIOError("remove", path, error);
+      }
+    },
+    async removeDir(path) {
+      try {
+        const absPath = toAbsolute(path);
+        const exists = await RNFS.exists(absPath);
+        if (exists) {
+          // RNFS.unlink can remove directories recursively
+          await RNFS.unlink(absPath);
+        }
+      } catch (error) {
+        throw new AdapterIOError("removeDir", path, error);
+      }
+    },
+    async listDir(path) {
+      try {
+        const absPath = toAbsolute(path);
+        const exists = await RNFS.exists(absPath);
+        if (!exists) {
+          return [];
+        }
+        const items = await RNFS.readDir(absPath);
+        return items.map(item => item.name);
+      } catch (error) {
+        throw new AdapterIOError("listDir", path, error);
+      }
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // File I/O
+    // ─────────────────────────────────────────────────────────────────
+
+    async readText(path, _encoding) {
+      try {
+        const absPath = toAbsolute(path);
+        return await RNFS.readFile(absPath, "utf8");
+      } catch (error) {
+        throw new AdapterIOError("readText", path, error);
+      }
+    },
+    async writeTextAtomic(path, content, _encoding) {
+      const tempPath = getTempPath(path);
+      const absPath = toAbsolute(path);
+      try {
+        // Ensure parent directory exists
+        const parentDir = absPath.substring(0, absPath.lastIndexOf("/"));
+        await RNFS.mkdir(parentDir);
+
+        // Write to temp file
+        await RNFS.writeFile(tempPath, content, "utf8");
+
+        // Atomic move
+        await RNFS.moveFile(tempPath, absPath);
+      } catch (error) {
+        // Clean up temp file on error
+        try {
+          await RNFS.unlink(tempPath);
+        } catch {
+          // Ignore cleanup errors
+        }
+        throw new AdapterIOError("writeTextAtomic", path, error);
+      }
+    },
+    async stat(path) {
+      try {
+        const absPath = toAbsolute(path);
+        const statResult = await RNFS.stat(absPath);
+        return {
+          sizeBytes: statResult.size,
+          mtimeMs: new Date(statResult.mtime).getTime()
+        };
+      } catch (error) {
+        throw new AdapterIOError("stat", path, error);
+      }
+    },
+    async writeBinaryAtomic(path, source, options) {
+      const tempPath = getTempPath(path);
+      const absPath = toAbsolute(path);
+      try {
+        // Ensure parent directory exists
+        const parentDir = absPath.substring(0, absPath.lastIndexOf("/"));
+        await RNFS.mkdir(parentDir);
+        let contentType;
+        switch (source.type) {
+          case "url":
+            {
+              // Download file with progress
+              const downloadResult = await new Promise((resolve, reject) => {
+                const {
+                  promise
+                } = RNFS.downloadFile({
+                  fromUrl: source.url,
+                  toFile: tempPath,
+                  headers: {
+                    ...source.headers,
+                    ...options?.headers
+                  },
+                  progress: res => {
+                    if (options?.onProgress && res.contentLength > 0) {
+                      const pct = res.bytesWritten / res.contentLength * 100;
+                      options.onProgress(pct);
+                    }
+                  },
+                  progressDivider: 1
+                });
+                promise.then(resolve).catch(reject);
+              });
+              if (downloadResult.statusCode < 200 || downloadResult.statusCode >= 300) {
+                throw new Error(`Download failed with status ${downloadResult.statusCode}`);
+              }
+              break;
+            }
+          case "file":
+            {
+              // Copy file
+              await RNFS.copyFile(source.filePath, tempPath);
+              break;
+            }
+          case "bytes":
+            {
+              // Convert Uint8Array to base64 and write
+              const base64 = uint8ArrayToBase64(source.bytes);
+              await RNFS.writeFile(tempPath, base64, "base64");
+              break;
+            }
+          case "blob":
+            {
+              // Blob is not supported on native
+              throw new UnsupportedSourceError("blob", "native-fs");
+            }
+          default:
+            {
+              const _exhaustive = source;
+              throw new UnsupportedSourceError(_exhaustive.type, "native-fs");
+            }
+        }
+
+        // Get size before moving
+        const statResult = await RNFS.stat(tempPath);
+
+        // Atomic move
+        await RNFS.moveFile(tempPath, absPath);
+
+        // Report 100% progress
+        options?.onProgress?.(100);
+        return {
+          sizeBytes: statResult.size,
+          contentType
+        };
+      } catch (error) {
+        // Clean up temp file on error
+        try {
+          await RNFS.unlink(tempPath);
+        } catch {
+          // Ignore cleanup errors
+        }
+        if (error instanceof UnsupportedSourceError) {
+          throw error;
+        }
+        throw new AdapterIOError("writeBinaryAtomic", path, error);
+      }
+    },
+    async getPublicUri(path) {
+      const absPath = toAbsolute(path);
+      // Return file:// URI for native platforms
+      return `file://${absPath}`;
+    }
+  };
+  return adapter;
+}
+
+/**
+ * Converts Uint8Array to base64 string.
+ */
+function uint8ArrayToBase64(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+//# sourceMappingURL=rnfsAdapter.js.map

package/lib/module/adapters/rnfsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RNFS","UnsupportedSourceError","AdapterIOError","createRnfsAdapter","options","baseDir","CachesDirectoryPath","namespace","rootPath","toAbsolute","path","getTempPath","Date","now","Math","random","toString","slice","adapter","kind","rootId","ensureDir","absPath","mkdir","error","exists","remove","unlink","removeDir","listDir","items","readDir","map","item","name","readText","_encoding","readFile","writeTextAtomic","content","tempPath","parentDir","substring","lastIndexOf","writeFile","moveFile","stat","statResult","sizeBytes","size","mtimeMs","mtime","getTime","writeBinaryAtomic","source","contentType","type","downloadResult","Promise","resolve","reject","promise","downloadFile","fromUrl","url","toFile","headers","progress","res","onProgress","contentLength","pct","bytesWritten","progressDivider","then","catch","statusCode","Error","copyFile","filePath","base64","uint8ArrayToBase64","bytes","_exhaustive","getPublicUri","binary","i","length","String","fromCharCode","btoa"],"sourceRoot":"../../../src","sources":["adapters/rnfsAdapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/adapters/webAdapter.js

@@ -0,0 +1,426 @@
+/**
+ * Web Storage Adapter
+ *
+ * Implements IStorageAdapter using:
+ * - Cache Storage API for binary file storage
+ * - IndexedDB for metadata and index storage
+ */
+
+import { UnsupportedSourceError, AdapterIOError } from "../core/errors";
+const CACHE_URL_PREFIX = "https://cache.local";
+
+/**
+ * Creates a storage adapter for web platforms using Cache Storage and IndexedDB.
+ */
+export function createWebAdapter(options) {
+  const cacheName = options?.cacheName ?? "immutable-file-cache";
+  const idbName = options?.idbName ?? "immutable-file-cache-meta";
+  const namespace = options?.namespace ?? "default";
+  const rootId = `${cacheName}/${namespace}`;
+
+  // Track created blob URLs for cleanup
+  const blobUrls = new Set();
+
+  /**
+   * Converts adapter path to cache URL key.
+   */
+  const toCacheKey = path => {
+    return `${CACHE_URL_PREFIX}/${namespace}/${path}`;
+  };
+
+  /**
+   * Converts cache URL key back to adapter path.
+   */
+  const fromCacheKey = url => {
+    const prefix = `${CACHE_URL_PREFIX}/${namespace}/`;
+    return url.startsWith(prefix) ? url.slice(prefix.length) : url;
+  };
+
+  /**
+   * Gets the IDB object store key for metadata.
+   */
+  const toMetaKey = path => {
+    return `${namespace}/${path}`;
+  };
+
+  /**
+   * Opens or creates the IndexedDB database.
+   */
+  const openDB = () => {
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open(idbName, 1);
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve(request.result);
+      request.onupgradeneeded = event => {
+        const db = event.target.result;
+        if (!db.objectStoreNames.contains("metadata")) {
+          db.createObjectStore("metadata");
+        }
+        if (!db.objectStoreNames.contains("directories")) {
+          db.createObjectStore("directories");
+        }
+      };
+    });
+  };
+
+  /**
+   * Gets metadata from IDB.
+   */
+  const getMetadata = async path => {
+    const db = await openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction("metadata", "readonly");
+      const store = tx.objectStore("metadata");
+      const request = store.get(toMetaKey(path));
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve(request.result ?? null);
+      tx.oncomplete = () => db.close();
+    });
+  };
+
+  /**
+   * Sets metadata in IDB.
+   */
+  const setMetadata = async (path, meta) => {
+    const db = await openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction("metadata", "readwrite");
+      const store = tx.objectStore("metadata");
+      const request = store.put(meta, toMetaKey(path));
+      request.onerror = () => reject(request.error);
+      tx.oncomplete = () => {
+        db.close();
+        resolve();
+      };
+    });
+  };
+
+  /**
+   * Deletes metadata from IDB.
+   */
+  const deleteMetadata = async path => {
+    const db = await openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction("metadata", "readwrite");
+      const store = tx.objectStore("metadata");
+      const request = store.delete(toMetaKey(path));
+      request.onerror = () => reject(request.error);
+      tx.oncomplete = () => {
+        db.close();
+        resolve();
+      };
+    });
+  };
+
+  /**
+   * Marks a directory as existing in IDB.
+   */
+  const markDirectory = async path => {
+    const db = await openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction("directories", "readwrite");
+      const store = tx.objectStore("directories");
+      const request = store.put(true, toMetaKey(path));
+      request.onerror = () => reject(request.error);
+      tx.oncomplete = () => {
+        db.close();
+        resolve();
+      };
+    });
+  };
+
+  /**
+   * Checks if directory exists in IDB.
+   */
+  const hasDirectory = async path => {
+    const db = await openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction("directories", "readonly");
+      const store = tx.objectStore("directories");
+      const request = store.get(toMetaKey(path));
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => resolve(request.result === true);
+      tx.oncomplete = () => db.close();
+    });
+  };
+  const adapter = {
+    kind: "web",
+    rootId,
+    // ─────────────────────────────────────────────────────────────────
+    // Directory Management
+    // ─────────────────────────────────────────────────────────────────
+
+    async ensureDir(path) {
+      try {
+        await markDirectory(path);
+      } catch (error) {
+        throw new AdapterIOError("ensureDir", path, error);
+      }
+    },
+    async exists(path) {
+      try {
+        // Check if it's a file in cache storage
+        const cache = await caches.open(cacheName);
+        const response = await cache.match(toCacheKey(path));
+        if (response) {
+          return true;
+        }
+
+        // Check if it's a directory
+        return await hasDirectory(path);
+      } catch {
+        return false;
+      }
+    },
+    async remove(path) {
+      try {
+        const cache = await caches.open(cacheName);
+        await cache.delete(toCacheKey(path));
+        await deleteMetadata(path);
+      } catch (error) {
+        throw new AdapterIOError("remove", path, error);
+      }
+    },
+    async removeDir(path) {
+      try {
+        const cache = await caches.open(cacheName);
+        const keys = await cache.keys();
+        const prefix = toCacheKey(path + "/");
+
+        // Delete all entries with this prefix
+        for (const request of keys) {
+          if (request.url.startsWith(prefix) || request.url === toCacheKey(path)) {
+            await cache.delete(request);
+            const entryPath = fromCacheKey(request.url);
+            await deleteMetadata(entryPath);
+          }
+        }
+
+        // Remove directory marker
+        const db = await openDB();
+        await new Promise((resolve, reject) => {
+          const tx = db.transaction("directories", "readwrite");
+          const store = tx.objectStore("directories");
+          store.delete(toMetaKey(path));
+          tx.oncomplete = () => {
+            db.close();
+            resolve();
+          };
+          tx.onerror = () => reject(tx.error);
+        });
+      } catch (error) {
+        throw new AdapterIOError("removeDir", path, error);
+      }
+    },
+    async listDir(path) {
+      try {
+        const cache = await caches.open(cacheName);
+        const keys = await cache.keys();
+        const prefix = toCacheKey(path + "/");
+        const entries = [];
+        for (const request of keys) {
+          if (request.url.startsWith(prefix)) {
+            // Extract the relative path from this directory
+            const relativePath = request.url.slice(prefix.length);
+            // Only include direct children (no further slashes)
+            if (!relativePath.includes("/")) {
+              entries.push(relativePath);
+            }
+          }
+        }
+        return entries;
+      } catch (error) {
+        throw new AdapterIOError("listDir", path, error);
+      }
+    },
+    // ─────────────────────────────────────────────────────────────────
+    // File I/O
+    // ─────────────────────────────────────────────────────────────────
+
+    async readText(path, _encoding) {
+      try {
+        const cache = await caches.open(cacheName);
+        const response = await cache.match(toCacheKey(path));
+        if (!response) {
+          throw new Error("File not found");
+        }
+        return await response.text();
+      } catch (error) {
+        throw new AdapterIOError("readText", path, error);
+      }
+    },
+    async writeTextAtomic(path, content, _encoding) {
+      try {
+        const cache = await caches.open(cacheName);
+        const blob = new Blob([content], {
+          type: "text/plain; charset=utf-8"
+        });
+        const response = new Response(blob);
+
+        // Cache Storage puts are atomic by nature
+        await cache.put(toCacheKey(path), response);
+
+        // Store metadata
+        await setMetadata(path, {
+          sizeBytes: blob.size,
+          mtimeMs: Date.now(),
+          contentType: "text/plain"
+        });
+      } catch (error) {
+        throw new AdapterIOError("writeTextAtomic", path, error);
+      }
+    },
+    async stat(path) {
+      try {
+        const meta = await getMetadata(path);
+        if (!meta) {
+          throw new Error("File not found");
+        }
+        return {
+          sizeBytes: meta.sizeBytes,
+          mtimeMs: meta.mtimeMs
+        };
+      } catch (error) {
+        throw new AdapterIOError("stat", path, error);
+      }
+    },
+    async writeBinaryAtomic(path, source, options) {
+      try {
+        const cache = await caches.open(cacheName);
+        let blob;
+        let contentType;
+        switch (source.type) {
+          case "url":
+            {
+              // Fetch with progress tracking
+              const response = await fetch(source.url, {
+                headers: {
+                  ...source.headers,
+                  ...options?.headers
+                }
+              });
+              if (!response.ok) {
+                throw new Error(`Fetch failed with status ${response.status}`);
+              }
+              contentType = response.headers.get("content-type") ?? undefined;
+
+              // Try to track progress if content-length is available
+              const contentLength = response.headers.get("content-length");
+              if (contentLength && options?.onProgress && response.body) {
+                const total = parseInt(contentLength, 10);
+                let loaded = 0;
+                const reader = response.body.getReader();
+                const chunks = [];
+
+                // eslint-disable-next-line no-constant-condition
+                while (true) {
+                  const {
+                    done,
+                    value
+                  } = await reader.read();
+                  if (done) {
+                    break;
+                  }
+                  chunks.push(value);
+                  loaded += value.length;
+                  options.onProgress(loaded / total * 100);
+                }
+                blob = new Blob(chunks.map(c => c.buffer), {
+                  type: contentType
+                });
+              } else {
+                blob = await response.blob();
+                options?.onProgress?.(100);
+              }
+              break;
+            }
+          case "blob":
+            {
+              blob = source.blob;
+              contentType = source.blob.type || undefined;
+              options?.onProgress?.(100);
+              break;
+            }
+          case "bytes":
+            {
+              blob = new Blob([source.bytes.buffer]);
+              options?.onProgress?.(100);
+              break;
+            }
+          case "file":
+            {
+              // File paths not supported on web
+              throw new UnsupportedSourceError("file", "web");
+            }
+          default:
+            {
+              const _exhaustive = source;
+              throw new UnsupportedSourceError(_exhaustive.type, "web");
+            }
+        }
+
+        // Store in cache
+        const response = new Response(blob, {
+          headers: contentType ? {
+            "Content-Type": contentType
+          } : {}
+        });
+        await cache.put(toCacheKey(path), response);
+
+        // Store metadata
+        const meta = {
+          sizeBytes: blob.size,
+          mtimeMs: Date.now(),
+          contentType
+        };
+        await setMetadata(path, meta);
+        return {
+          sizeBytes: blob.size,
+          contentType
+        };
+      } catch (error) {
+        if (error instanceof UnsupportedSourceError) {
+          throw error;
+        }
+        throw new AdapterIOError("writeBinaryAtomic", path, error);
+      }
+    },
+    async getPublicUri(path) {
+      try {
+        const cache = await caches.open(cacheName);
+        const response = await cache.match(toCacheKey(path));
+        if (!response) {
+          throw new Error("File not found");
+        }
+        const blob = await response.blob();
+        const blobUrl = URL.createObjectURL(blob);
+
+        // Track for cleanup
+        blobUrls.add(blobUrl);
+        return blobUrl;
+      } catch (error) {
+        throw new AdapterIOError("getPublicUri", path, error);
+      }
+    }
+  };
+
+  // Add cleanup method (non-standard, for internal use)
+  adapter.revokeUri = uri => {
+    if (blobUrls.has(uri)) {
+      URL.revokeObjectURL(uri);
+      blobUrls.delete(uri);
+    }
+  };
+  adapter.revokeAllUris = () => {
+    for (const uri of blobUrls) {
+      URL.revokeObjectURL(uri);
+    }
+    blobUrls.clear();
+  };
+  return adapter;
+}
+
+/**
+ * Extended interface for web adapter with cleanup methods.
+ */
+//# sourceMappingURL=webAdapter.js.map