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

package/lib/typescript/src/core/prune.d.ts

@@ -0,0 +1,39 @@
+import type { ICacheIndex, ICacheEntryMeta } from "./types";
+/**
+ * Options for pruning operations.
+ */
+export interface IPruneOptions {
+    readonly maxSizeBytes?: number;
+    readonly now?: number;
+}
+/**
+ * Identifies entries to remove based on TTL expiration.
+ * Returns entries that have expired (expiresAt < now).
+ */
+export declare function getExpiredEntries(index: ICacheIndex, now?: number): ReadonlyArray<ICacheEntryMeta>;
+/**
+ * Identifies entries to remove based on LRU policy to meet size limit.
+ * Sorts entries by lastAccessedAt (oldest first) and returns entries
+ * that need to be removed to get under maxSizeBytes.
+ */
+export declare function getLruPruneTargets(index: ICacheIndex, maxSizeBytes: number): ReadonlyArray<ICacheEntryMeta>;
+/**
+ * Creates a new index with the specified entries removed.
+ * Returns a new ICacheIndex without mutating the original.
+ */
+export declare function removeEntriesFromIndex(index: ICacheIndex, keysToRemove: ReadonlyArray<string>): ICacheIndex;
+/**
+ * Adds or updates an entry in the index.
+ * Returns a new ICacheIndex without mutating the original.
+ */
+export declare function addEntryToIndex(index: ICacheIndex, entry: ICacheEntryMeta): ICacheIndex;
+/**
+ * Updates the lastAccessedAt timestamp for an entry.
+ * Returns a new ICacheIndex without mutating the original.
+ */
+export declare function touchEntry(index: ICacheIndex, key: string, accessedAt?: number): ICacheIndex;
+/**
+ * Creates an empty cache index.
+ */
+export declare function createEmptyIndex(): ICacheIndex;
+//# sourceMappingURL=prune.d.ts.map

package/lib/typescript/src/core/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../../../src/core/prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,GAAG,GAAE,MAAmB,GACvB,aAAa,CAAC,eAAe,CAAC,CAUhC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,GACnB,aAAa,CAAC,eAAe,CAAC,CAsBhC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,GAClC,WAAW,CAkBb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,WAAW,CAavF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAmB,GAC9B,WAAW,CAiBb;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAO9C"}

package/lib/typescript/src/core/types.d.ts

@@ -0,0 +1,109 @@
+import type { IStorageAdapter, TAdapterPath } from "./adapter";
+export interface ICacheConfig {
+    /**
+     * Namespace for cache isolation. Creates separate storage area.
+     * @default "default"
+     */
+    readonly namespace?: string;
+    /**
+     * Custom storage adapter. If not provided, auto-selects based on platform.
+     */
+    readonly adapter?: IStorageAdapter;
+    /**
+     * Default TTL in milliseconds for new entries.
+     * @default undefined (no expiration)
+     */
+    readonly defaultTtlMs?: number;
+    /**
+     * Maximum cache size in bytes. Triggers LRU pruning when exceeded.
+     * @default undefined (no limit)
+     */
+    readonly maxSizeBytes?: number;
+    /**
+     * Whether to auto-prune expired entries on cache operations.
+     * @default true
+     */
+    readonly autoPruneExpired?: boolean;
+    /**
+     * Custom hash function for generating cache keys from input keys.
+     * @default SHA-256 hex
+     */
+    readonly hashFn?: (input: string) => string | Promise<string>;
+}
+export interface ICacheEntryMeta {
+    /** User-provided unique key. */
+    readonly key: string;
+    /** Hash of the key (used for filename). */
+    readonly hash: string;
+    /** Original file extension (e.g., ".jpg"). */
+    readonly ext: string;
+    /** Size in bytes. */
+    readonly sizeBytes: number;
+    /** MIME content type if known. */
+    readonly contentType?: string;
+    /** Timestamp when entry was created (ms since epoch). */
+    readonly createdAt: number;
+    /** Timestamp when entry was last accessed (ms since epoch). */
+    readonly lastAccessedAt: number;
+    /** Expiration timestamp (ms since epoch). undefined = never expires. */
+    readonly expiresAt?: number;
+    /** Optional user-defined metadata. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ICacheEntry extends ICacheEntryMeta {
+    /** Adapter-relative path to the cached file. */
+    readonly path: TAdapterPath;
+}
+export interface ICacheIndex {
+    readonly version: 1;
+    readonly entries: Readonly<Record<string, ICacheEntryMeta>>;
+    readonly totalSizeBytes: number;
+    readonly lastModifiedAt: number;
+}
+export interface IPutOptions {
+    /** TTL in milliseconds. Overrides defaultTtlMs. */
+    readonly ttlMs?: number;
+    /** File extension to use (e.g., ".jpg"). Auto-detected if omitted. */
+    readonly ext?: string;
+    /** Optional user-defined metadata. */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    /** Progress callback for download/write operations. */
+    readonly onProgress?: (percent: number) => void;
+    /** Additional headers for URL fetches. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export type TPutStatus = "created" | "exists";
+export interface IPutResult {
+    readonly status: TPutStatus;
+    readonly entry: ICacheEntry;
+}
+export interface IGetResult {
+    readonly entry: ICacheEntry;
+    readonly uri: string;
+}
+export type TSortField = "createdAt" | "lastAccessedAt" | "sizeBytes" | "key";
+export type TSortOrder = "asc" | "desc";
+export interface IListOptions {
+    /** Sort field. @default "createdAt" */
+    readonly sortBy?: TSortField;
+    /** Sort order. @default "desc" */
+    readonly order?: TSortOrder;
+    /** Maximum entries to return. */
+    readonly limit?: number;
+    /** Number of entries to skip. */
+    readonly offset?: number;
+    /** Filter by metadata. */
+    readonly filter?: (entry: ICacheEntryMeta) => boolean;
+}
+export interface IPruneResult {
+    readonly removedCount: number;
+    readonly freedBytes: number;
+    readonly removedKeys: ReadonlyArray<string>;
+}
+export interface ICacheStats {
+    readonly entryCount: number;
+    readonly totalSizeBytes: number;
+    readonly oldestEntry?: ICacheEntryMeta;
+    readonly newestEntry?: ICacheEntryMeta;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/core/types.d.ts.map

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

package/lib/typescript/src/factory.d.ts

@@ -0,0 +1,46 @@
+import type { ICacheConfig } from "./core/types";
+import type { IStorageAdapter } from "./core/adapter";
+import { CacheEngine } from "./core/cacheEngine";
+export interface ICreateCacheOptions extends ICacheConfig {
+    /**
+     * If true, auto-initializes the cache before returning.
+     * @default true
+     */
+    readonly autoInit?: boolean;
+}
+/**
+ * Creates an immutable file cache instance.
+ *
+ * This is the base factory function. Platform-specific entrypoints
+ * (index.native.ts, index.web.ts) wrap this to auto-select the appropriate adapter.
+ *
+ * @param options - Cache configuration options
+ * @param adapter - Storage adapter (required in base factory)
+ * @returns Initialized CacheEngine instance
+ *
+ * @example
+ * ```typescript
+ * import { createImmutableFileCache } from "react-native-immutable-file-cache";
+ *
+ * const cache = await createImmutableFileCache({
+ *   namespace: "images",
+ *   defaultTtlMs: 7 * 24 * 60 * 60 * 1000, // 7 days
+ * });
+ * ```
+ */
+export declare function createImmutableFileCache(options: ICreateCacheOptions & {
+    adapter: IStorageAdapter;
+}): Promise<CacheEngine>;
+/**
+ * Creates a cache engine without auto-initialization.
+ * Useful when you need to control initialization timing.
+ *
+ * @example
+ * ```typescript
+ * const engine = createCacheEngineSync({ namespace: "images" }, adapter);
+ * // Later...
+ * await engine.init();
+ * ```
+ */
+export declare function createCacheEngineSync(config: ICacheConfig, adapter: IStorageAdapter): CacheEngine;
+//# sourceMappingURL=factory.d.ts.map

package/lib/typescript/src/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,mBAAmB,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,GAC1D,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CAEjG"}

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

@@ -0,0 +1,20 @@
+/**
+ * @dynlabs/react-native-immutable-file-cache
+ *
+ * Cross-platform immutable file cache with pluggable storage adapters.
+ */
+export type { IStorageAdapter, TAdapterPath, TBinarySource, IBinaryWriteResult, IBinaryWriteOptions, IFileStat, TProgressCallback, } from "./core/adapter";
+export type { ICacheConfig, ICacheEntry, ICacheEntryMeta, ICacheIndex, IPutOptions, IPutResult, IGetResult, IListOptions, IPruneResult, ICacheStats, TPutStatus, TSortField, TSortOrder, } from "./core/types";
+export { CacheError, UnsupportedSourceError, AdapterIOError, CorruptIndexError, ImmutableConflictError, EntryNotFoundError, } from "./core/errors";
+export { CacheEngine } from "./core/cacheEngine";
+export { createImmutableFileCache, createCacheEngineSync } from "./factory";
+export type { ICreateCacheOptions } from "./factory";
+export { createRnfsAdapter } from "./adapters/rnfsAdapter";
+export type { IRnfsAdapterOptions } from "./adapters/rnfsAdapter";
+export { createWebAdapter } from "./adapters/webAdapter";
+export type { IWebAdapterOptions, IWebAdapterWithCleanup } from "./adapters/webAdapter";
+export { createMemoryAdapter } from "./adapters/memoryAdapter";
+export type { IMemoryAdapter } from "./adapters/memoryAdapter";
+export { hash, hashSync } from "./core/hash";
+export { Mutex, KeyedMutex } from "./core/mutex";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAMrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * @dynlabs/react-native-immutable-file-cache - Native entrypoint
+ * Auto-selects RNFS adapter for React Native (iOS/Android).
+ */
+export * from "./index";
+import type { ICreateCacheOptions } from "./factory";
+import { CacheEngine } from "./core/cacheEngine";
+/**
+ * Creates an immutable file cache instance for React Native.
+ * Automatically uses the RNFS adapter.
+ *
+ * @param options - Cache configuration options
+ * @returns Initialized CacheEngine instance
+ *
+ * @example
+ * ```typescript
+ * import { createImmutableFileCache } from "@dynlabs/react-native-immutable-file-cache";
+ *
+ * const cache = await createImmutableFileCache({
+ *   namespace: "images",
+ *   defaultTtlMs: 7 * 24 * 60 * 60 * 1000,
+ * });
+ *
+ * // Cache an image
+ * const result = await cache.putFromUrl("avatar", "https://example.com/avatar.jpg");
+ *
+ * // Get cached image URI
+ * const entry = await cache.get("avatar");
+ * if (entry) {
+ *   console.log("Image URI:", entry.uri);
+ * }
+ * ```
+ */
+export declare function createImmutableFileCache(options?: Omit<ICreateCacheOptions, "adapter"> & {
+    adapter?: ICreateCacheOptions["adapter"];
+}): Promise<CacheEngine>;
+//# sourceMappingURL=index.native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../../src/index.native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;CAAE,GAC5F,OAAO,CAAC,WAAW,CAAC,CAiBtB"}

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

@@ -0,0 +1,38 @@
+/**
+ * @dynlabs/react-native-immutable-file-cache - Web entrypoint
+ * Auto-selects Web adapter for browser environments.
+ */
+export * from "./index";
+import type { ICreateCacheOptions } from "./factory";
+import { CacheEngine } from "./core/cacheEngine";
+/**
+ * Creates an immutable file cache instance for web browsers.
+ * Automatically uses the Web adapter (Cache Storage + IndexedDB).
+ *
+ * @param options - Cache configuration options
+ * @returns Initialized CacheEngine instance
+ *
+ * @example
+ * ```typescript
+ * import { createImmutableFileCache } from "@dynlabs/react-native-immutable-file-cache/web";
+ *
+ * const cache = await createImmutableFileCache({
+ *   namespace: "images",
+ *   defaultTtlMs: 7 * 24 * 60 * 60 * 1000,
+ * });
+ *
+ * // Cache an image
+ * const result = await cache.putFromUrl("avatar", "https://example.com/avatar.jpg");
+ *
+ * // Get cached image URI (blob: URL)
+ * const entry = await cache.get("avatar");
+ * if (entry) {
+ *   // Use entry.uri as image source
+ *   // Remember to revoke blob URL when done to free memory
+ * }
+ * ```
+ */
+export declare function createImmutableFileCache(options?: Omit<ICreateCacheOptions, "adapter"> & {
+    adapter?: ICreateCacheOptions["adapter"];
+}): Promise<CacheEngine>;
+//# sourceMappingURL=index.web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;CAAE,GAC5F,OAAO,CAAC,WAAW,CAAC,CAiBtB"}

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "@dynlabs/react-native-immutable-file-cache",
+  "version": "1.0.0-alpha.1",
+  "description": "Cross-platform immutable file cache with pluggable storage adapters for React Native and Web",
+  "author": "dienp",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dienp/react-native-immutable-file-cache.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dienp/react-native-immutable-file-cache/issues"
+  },
+  "homepage": "https://github.com/dienp/react-native-immutable-file-cache#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index.native.ts",
+  "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "react-native": "./src/index.native.ts",
+      "import": "./lib/module/index.js",
+      "require": "./lib/commonjs/index.js"
+    },
+    "./native": {
+      "types": "./lib/typescript/src/index.native.d.ts",
+      "react-native": "./src/index.native.ts",
+      "import": "./lib/module/index.native.js",
+      "require": "./lib/commonjs/index.native.js"
+    },
+    "./web": {
+      "types": "./lib/typescript/src/index.web.d.ts",
+      "import": "./lib/module/index.web.js",
+      "require": "./lib/commonjs/index.web.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "README.md",
+    "!**/__tests__",
+    "!**/__mocks__",
+    "!**/*.test.ts"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"__tests__/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "clean": "rimraf lib",
+    "prepublishOnly": "npm run build && npm run lint && npm run typecheck && npm test",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major"
+  },
+  "keywords": [
+    "react-native",
+    "cache",
+    "file-cache",
+    "immutable",
+    "storage",
+    "offline",
+    "ios",
+    "android",
+    "web",
+    "cross-platform",
+    "adapter"
+  ],
+  "peerDependencies": {
+    "react-native": ">=0.70.0",
+    "react-native-fs": ">=2.20.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    },
+    "react-native-fs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/react-native": "^0.72.8",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "react-native-builder-bob": "^0.23.2",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}