react-smart-query 1.0.0

package/dist/testing.js

@@ -0,0 +1,272 @@
+'use strict';
+
+var React = require('react');
+var reactQuery = require('@tanstack/react-query');
+var reactNative = require('react-native');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+function createMemoryStorage() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => Promise.resolve(store.get(key)),
+    set: (key, value) => {
+      store.set(key, value);
+      return Promise.resolve();
+    },
+    delete: (key) => {
+      store.delete(key);
+      return Promise.resolve();
+    },
+    clearAll: () => {
+      store.clear();
+      return Promise.resolve();
+    },
+    keys: () => Promise.resolve(Array.from(store.keys()))
+  };
+}
+function createNativeStorage() {
+  const MMKV = __require("react-native-mmkv").MMKV;
+  const mmkv = new MMKV({ id: "react-smart-query-v2" });
+  return {
+    get: (key) => Promise.resolve(mmkv.getString(key) ?? void 0),
+    set: (key, value) => Promise.resolve(void mmkv.set(key, value)),
+    delete: (key) => Promise.resolve(void mmkv.delete(key)),
+    clearAll: () => Promise.resolve(void mmkv.clearAll()),
+    keys: () => Promise.resolve(mmkv.getAllKeys())
+  };
+}
+var IDB_NAME = "SmartQueryV2";
+var IDB_STORE = "entries";
+var IDB_VERSION = 1;
+function isIDBAvailable() {
+  return typeof globalThis !== "undefined" && typeof globalThis.indexedDB !== "undefined";
+}
+function openIDB() {
+  return new Promise((resolve, reject) => {
+    const req = indexedDB.open(IDB_NAME, IDB_VERSION);
+    req.onupgradeneeded = (e) => {
+      const db = e.target.result;
+      if (!db.objectStoreNames.contains(IDB_STORE)) {
+        db.createObjectStore(IDB_STORE);
+      }
+    };
+    req.onsuccess = (e) => resolve(e.target.result);
+    req.onerror = () => reject(req.error);
+    req.onblocked = () => reject(new Error("IDB blocked by another tab"));
+  });
+}
+var _idb = null;
+var getIDB = () => {
+  _idb ??= openIDB();
+  return _idb;
+};
+function idbWrap(req) {
+  return new Promise((res, rej) => {
+    req.onsuccess = () => res(req.result);
+    req.onerror = () => rej(req.error);
+  });
+}
+function createWebStorage() {
+  if (!isIDBAvailable()) return createMemoryStorage();
+  return {
+    async get(key) {
+      const db = await getIDB();
+      return idbWrap(
+        db.transaction(IDB_STORE, "readonly").objectStore(IDB_STORE).get(key)
+      );
+    },
+    async set(key, value) {
+      const db = await getIDB();
+      await idbWrap(
+        db.transaction(IDB_STORE, "readwrite").objectStore(IDB_STORE).put(value, key)
+      );
+    },
+    async delete(key) {
+      const db = await getIDB();
+      await idbWrap(
+        db.transaction(IDB_STORE, "readwrite").objectStore(IDB_STORE).delete(key)
+      );
+    },
+    async clearAll() {
+      const db = await getIDB();
+      await idbWrap(
+        db.transaction(IDB_STORE, "readwrite").objectStore(IDB_STORE).clear()
+      );
+    },
+    async keys() {
+      const db = await getIDB();
+      const result = await idbWrap(
+        db.transaction(IDB_STORE, "readonly").objectStore(IDB_STORE).getAllKeys()
+      );
+      return result.map(String);
+    }
+  };
+}
+var storage = reactNative.Platform.OS === "web" ? createWebStorage() : createNativeStorage();
+var _overrideStorage = null;
+function getStorage() {
+  return _overrideStorage ?? storage;
+}
+function _setStorageOverride(s) {
+  _overrideStorage = s;
+}
+
+// src/services/observer.service.ts
+var observers = /* @__PURE__ */ new Set();
+function emit(event) {
+  if (observers.size === 0) return;
+  for (const fn of observers) {
+    try {
+      fn(event);
+    } catch {
+    }
+  }
+}
+
+// src/services/cache.service.ts
+var CURRENT_CACHE_VERSION = 2;
+var DEFAULT_MAX_ENTRIES = 200;
+var _maxEntries = DEFAULT_MAX_ENTRIES;
+function cacheKeyFor(queryKey) {
+  return `sq2:${JSON.stringify(queryKey)}`;
+}
+async function writeCache(key, data, queryKey) {
+  try {
+    const storage2 = getStorage();
+    const now = Date.now();
+    const entry = {
+      version: CURRENT_CACHE_VERSION,
+      data,
+      cachedAt: now,
+      lastAccessedAt: now
+    };
+    const serialized = JSON.stringify(entry);
+    try {
+      await storage2.set(key, serialized);
+      if (queryKey) ;
+    } catch (quotaErr) {
+      emit({ type: "storage_quota_exceeded", key });
+      await evictLRUEntries();
+      await storage2.set(key, serialized);
+    }
+    void checkAndEvict();
+  } catch {
+  }
+}
+async function checkAndEvict() {
+  const storage2 = getStorage();
+  const allKeys = await storage2.keys();
+  const sqKeys = allKeys.filter((k) => k.startsWith("sq2:"));
+  if (sqKeys.length <= _maxEntries) return;
+  await evictLRUEntries(sqKeys);
+}
+async function evictLRUEntries(sqKeys) {
+  const storage2 = getStorage();
+  const keys = sqKeys ?? (await storage2.keys()).filter((k) => k.startsWith("sq2:"));
+  const metas = [];
+  await Promise.all(
+    keys.map(async (key) => {
+      try {
+        const raw = await storage2.get(key);
+        if (!raw) return;
+        const parsed = JSON.parse(raw);
+        metas.push({ key, lastAccessedAt: parsed.lastAccessedAt ?? 0 });
+      } catch {
+      }
+    })
+  );
+  metas.sort((a, b) => a.lastAccessedAt - b.lastAccessedAt);
+  const evictCount = Math.max(1, Math.floor(metas.length * 0.2));
+  const toEvict = metas.slice(0, evictCount);
+  await Promise.all(toEvict.map(({ key }) => storage2.delete(key)));
+}
+
+// src/testing.ts
+function createMockStorage() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => Promise.resolve(store.get(key)),
+    set: (key, value) => {
+      store.set(key, value);
+      return Promise.resolve();
+    },
+    delete: (key) => {
+      store.delete(key);
+      return Promise.resolve();
+    },
+    clearAll: () => {
+      store.clear();
+      return Promise.resolve();
+    },
+    keys: () => Promise.resolve(Array.from(store.keys()))
+  };
+}
+var _mockStorage = null;
+function ensureMockStorage() {
+  if (!_mockStorage) {
+    _mockStorage = createMockStorage();
+    _setStorageOverride(_mockStorage);
+  }
+  return _mockStorage;
+}
+function SmartQueryTestProvider({
+  children,
+  queryClient
+}) {
+  const client = queryClient ?? new reactQuery.QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: false,
+        gcTime: Infinity
+      }
+    }
+  });
+  React.useEffect(() => {
+    ensureMockStorage();
+    return () => {
+      _setStorageOverride(null);
+      _mockStorage = null;
+    };
+  }, []);
+  return React__default.default.createElement(
+    reactQuery.QueryClientProvider,
+    { client },
+    children
+  );
+}
+async function seedCache(queryKey, data) {
+  ensureMockStorage();
+  const key = cacheKeyFor(queryKey);
+  await writeCache(key, data);
+}
+async function clearTestCache() {
+  await ensureMockStorage().clearAll();
+}
+function waitForCacheLoad(ms = 50) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function mockQueryFn(data, delayMs = 0) {
+  return () => new Promise((resolve) => setTimeout(() => resolve(data), delayMs));
+}
+function mockErrorFn(error, delayMs = 0) {
+  return () => new Promise((_, reject) => setTimeout(() => reject(error), delayMs));
+}
+
+exports.SmartQueryTestProvider = SmartQueryTestProvider;
+exports.clearTestCache = clearTestCache;
+exports.createMockStorage = createMockStorage;
+exports.mockErrorFn = mockErrorFn;
+exports.mockQueryFn = mockQueryFn;
+exports.seedCache = seedCache;
+exports.waitForCacheLoad = waitForCacheLoad;
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/storage.adapter.ts","../src/services/observer.service.ts","../src/services/cache.service.ts","../src/testing.ts"],"names":["Platform","storage","QueryClient","useEffect","React","QueryClientProvider"],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * src/services/storage.adapter.ts\n *\n * Platform-aware storage with SSR safety.\n *\n *   iOS / Android  →  react-native-mmkv\n *   Web (browser)  →  IndexedDB\n *   SSR / Node.js  →  in-memory Map (safe no-op, hydrates on client)\n *\n * The SSR guard prevents \"indexedDB is not defined\" crashes in\n * Next.js / Expo Router SSR builds. Data written during SSR is discarded;\n * the client hydrates from real IDB on first mount.\n */\n\nimport { Platform } from \"react-native\";\nimport type { AsyncStorage } from \"../types\";\n\nexport type { AsyncStorage };\n\n// ─── SSR / Node.js in-memory adapter ─────────────────────────────────────────\n\nfunction createMemoryStorage(): AsyncStorage {\n  const store = new Map<string, string>();\n  return {\n    get: (key) => Promise.resolve(store.get(key)),\n    set: (key, value) => { store.set(key, value); return Promise.resolve(); },\n    delete: (key) => { store.delete(key); return Promise.resolve(); },\n    clearAll: () => { store.clear(); return Promise.resolve(); },\n    keys: () => Promise.resolve(Array.from(store.keys())),\n  };\n}\n\n// ─── Native adapter (iOS + Android) ──────────────────────────────────────────\n\nfunction createNativeStorage(): AsyncStorage {\n  const MMKV = require(\"react-native-mmkv\").MMKV;\n  const mmkv = new MMKV({ id: \"react-smart-query-v2\" });\n  return {\n    get: (key) => Promise.resolve(mmkv.getString(key) ?? undefined),\n    set: (key, value) => Promise.resolve(void mmkv.set(key, value)),\n    delete: (key) => Promise.resolve(void mmkv.delete(key)),\n    clearAll: () => Promise.resolve(void mmkv.clearAll()),\n    keys: () => Promise.resolve(mmkv.getAllKeys()),\n  };\n}\n\n// ─── Web adapter (IndexedDB) with SSR guard ───────────────────────────────────\n\nconst IDB_NAME = \"SmartQueryV2\";\nconst IDB_STORE = \"entries\";\nconst IDB_VERSION = 1;\n\nfunction isIDBAvailable(): boolean {\n  return typeof globalThis !== \"undefined\" &&\n    typeof (globalThis as unknown as Record<string, unknown>).indexedDB !== \"undefined\";\n}\n\nfunction openIDB(): Promise<IDBDatabase> {\n  return new Promise((resolve, reject) => {\n    const req = indexedDB.open(IDB_NAME, IDB_VERSION);\n    req.onupgradeneeded = (e) => {\n      const db = (e.target as IDBOpenDBRequest).result;\n      if (!db.objectStoreNames.contains(IDB_STORE)) {\n        db.createObjectStore(IDB_STORE);\n      }\n    };\n    req.onsuccess = (e) => resolve((e.target as IDBOpenDBRequest).result);\n    req.onerror = () => reject(req.error);\n    req.onblocked = () => reject(new Error(\"IDB blocked by another tab\"));\n  });\n}\n\nlet _idb: Promise<IDBDatabase> | null = null;\nconst getIDB = () => { _idb ??= openIDB(); return _idb; };\n\nfunction idbWrap<T>(req: IDBRequest<T>): Promise<T> {\n  return new Promise((res, rej) => {\n    req.onsuccess = () => res(req.result);\n    req.onerror = () => rej(req.error);\n  });\n}\n\nfunction createWebStorage(): AsyncStorage {\n  // SSR guard — return memory storage when IDB is unavailable\n  if (!isIDBAvailable()) return createMemoryStorage();\n\n  return {\n    async get(key) {\n      const db = await getIDB();\n      return idbWrap<string | undefined>(\n        db.transaction(IDB_STORE, \"readonly\").objectStore(IDB_STORE).get(key)\n      );\n    },\n    async set(key, value) {\n      const db = await getIDB();\n      await idbWrap(\n        db.transaction(IDB_STORE, \"readwrite\").objectStore(IDB_STORE).put(value, key)\n      );\n    },\n    async delete(key) {\n      const db = await getIDB();\n      await idbWrap(\n        db.transaction(IDB_STORE, \"readwrite\").objectStore(IDB_STORE).delete(key)\n      );\n    },\n    async clearAll() {\n      const db = await getIDB();\n      await idbWrap(\n        db.transaction(IDB_STORE, \"readwrite\").objectStore(IDB_STORE).clear()\n      );\n    },\n    async keys() {\n      const db = await getIDB();\n      const result = await idbWrap<IDBValidKey[]>(\n        db.transaction(IDB_STORE, \"readonly\").objectStore(IDB_STORE).getAllKeys()\n      );\n      return result.map(String);\n    },\n  };\n}\n\n// ─── Singleton ────────────────────────────────────────────────────────────────\n\nexport const storage: AsyncStorage =\n  Platform.OS === \"web\" ? createWebStorage() : createNativeStorage();\n\n/** Exposed for test utilities to inject a custom adapter */\nlet _overrideStorage: AsyncStorage | null = null;\n\nexport function getStorage(): AsyncStorage {\n  return _overrideStorage ?? storage;\n}\n\n/** @internal — used by SmartQueryTestProvider only */\nexport function _setStorageOverride(s: AsyncStorage | null): void {\n  _overrideStorage = s;\n}\n","/**\n * src/services/observer.service.ts\n *\n * Pluggable observability — emit structured events to any analytics backend.\n *\n * Zero coupling: the library emits; you decide where it goes.\n * Attach observers at app startup; they receive every internal event.\n *\n * @example\n *   // Sentry breadcrumbs\n *   addObserver((event) => {\n *     if (event.type === \"fetch_error\") {\n *       Sentry.addBreadcrumb({ message: event.type, data: event });\n *     }\n *   });\n *\n * @example\n *   // Datadog / Mixpanel\n *   addObserver((event) => {\n *     analytics.track(event.type, event);\n *   });\n *\n * @example\n *   // Simple console logger in dev\n *   if (__DEV__) addObserver(console.log);\n */\n\nimport type { ObservabilityEvent, ObserverFn } from \"../types\";\n\nconst observers = new Set<ObserverFn>();\n\n/**\n * Register an observer. Returns an unsubscribe function.\n *\n * @example\n *   const unsub = addObserver(myLogger);\n *   // Later:\n *   unsub();\n */\nexport function addObserver(fn: ObserverFn): () => void {\n  observers.add(fn);\n  return () => observers.delete(fn);\n}\n\n/** Remove a specific observer */\nexport function removeObserver(fn: ObserverFn): void {\n  observers.delete(fn);\n}\n\n/** Remove all observers */\nexport function clearObservers(): void {\n  observers.clear();\n}\n\n/**\n * @internal — emit an event to all registered observers.\n * Called by cache.service, queue.service, and useSmartQuery.\n * Never throws — observer errors are swallowed to protect the data path.\n */\nexport function emit(event: ObservabilityEvent): void {\n  if (observers.size === 0) return; // fast path — no observers registered\n  for (const fn of observers) {\n    try { fn(event); } catch { /* observer error must not crash the app */ }\n  }\n}\n","/**\n * src/services/cache.service.ts\n *\n * Versioned, LRU-aware cache layer.\n *\n * Features:\n *   • Schema versioning — auto-invalidates stale entries on version bump\n *   • lastAccessedAt tracking — enables LRU eviction\n *   • Configurable max entries per prefix — prevents unbounded growth\n *   • Partial hydration — read a subset of a NormalizedList by ids\n *   • Observability events on hit / miss / write / quota exceeded\n */\n\nimport { getStorage } from \"./storage.adapter\";\nimport { emit } from \"./observer.service\";\nimport type { CacheEntry, NormalizedList, AnyItem } from \"../types\";\n\n// ─── Versioning ───────────────────────────────────────────────────────────────\n\n/**\n * Bump when CacheEntry shape or NormalizedList schema changes in a\n * breaking way. Any stored entry with a lower version is silently discarded.\n */\nexport const CURRENT_CACHE_VERSION = 2;\n\n// ─── LRU config ───────────────────────────────────────────────────────────────\n\nconst DEFAULT_MAX_ENTRIES = 200;\nlet _maxEntries = DEFAULT_MAX_ENTRIES;\n\n/** Override the global max entries limit (call before any reads/writes) */\nexport function setMaxCacheEntries(n: number): void {\n  _maxEntries = n;\n}\n\n// ─── Key derivation ───────────────────────────────────────────────────────────\n\nexport function cacheKeyFor(queryKey: readonly unknown[]): string {\n  return `sq2:${JSON.stringify(queryKey)}`;\n}\n\n// ─── Read ─────────────────────────────────────────────────────────────────────\n\nexport async function readCache<T>(\n  key: string,\n  queryKey?: readonly unknown[]\n): Promise<CacheEntry<T> | null> {\n  try {\n    const storage = getStorage();\n    const raw = await storage.get(key);\n\n    if (!raw) {\n      if (queryKey) emit({ type: \"cache_miss\", queryKey });\n      return null;\n    }\n\n    const entry = JSON.parse(raw) as CacheEntry<T>;\n\n    if (entry.version !== CURRENT_CACHE_VERSION) {\n      void storage.delete(key);\n      if (queryKey) emit({ type: \"cache_miss\", queryKey });\n      return null;\n    }\n\n    // Touch lastAccessedAt for LRU — fire-and-forget, non-blocking\n    void storage.set(\n      key,\n      JSON.stringify({ ...entry, lastAccessedAt: Date.now() })\n    );\n\n    if (queryKey) emit({ type: \"cache_hit\", queryKey, cachedAt: entry.cachedAt });\n    return entry;\n  } catch {\n    return null;\n  }\n}\n\n// ─── Write ────────────────────────────────────────────────────────────────────\n\nexport async function writeCache<T>(\n  key: string,\n  data: T,\n  queryKey?: readonly unknown[]\n): Promise<void> {\n  try {\n    const storage = getStorage();\n    const now = Date.now();\n    const entry: CacheEntry<T> = {\n      version: CURRENT_CACHE_VERSION,\n      data,\n      cachedAt: now,\n      lastAccessedAt: now,\n    };\n\n    const serialized = JSON.stringify(entry);\n\n    try {\n      await storage.set(key, serialized);\n      if (queryKey) {\n        emit({ type: \"cache_write\", queryKey, dataSize: serialized.length });\n      }\n    } catch (quotaErr) {\n      emit({ type: \"storage_quota_exceeded\", key });\n      // Attempt LRU eviction then retry once\n      await evictLRUEntries();\n      await storage.set(key, serialized);\n    }\n\n    // Async LRU check — doesn't block the write\n    void checkAndEvict();\n  } catch {\n    // Fail silently — a cache write failure must never crash the app\n  }\n}\n\n// ─── Delete ───────────────────────────────────────────────────────────────────\n\nexport async function deleteCache(key: string): Promise<void> {\n  try {\n    await getStorage().delete(key);\n  } catch {}\n}\n\n// ─── LRU eviction ─────────────────────────────────────────────────────────────\n\ninterface LRUMeta {\n  key: string;\n  lastAccessedAt: number;\n}\n\nasync function checkAndEvict(): Promise<void> {\n  const storage = getStorage();\n  const allKeys = await storage.keys();\n  const sqKeys = allKeys.filter((k) => k.startsWith(\"sq2:\"));\n\n  if (sqKeys.length <= _maxEntries) return;\n\n  await evictLRUEntries(sqKeys);\n}\n\nasync function evictLRUEntries(sqKeys?: string[]): Promise<void> {\n  const storage = getStorage();\n  const keys = sqKeys ?? (await storage.keys()).filter((k) => k.startsWith(\"sq2:\"));\n\n  // Read lastAccessedAt for each entry — lightweight parse\n  const metas: LRUMeta[] = [];\n  await Promise.all(\n    keys.map(async (key) => {\n      try {\n        const raw = await storage.get(key);\n        if (!raw) return;\n        const parsed = JSON.parse(raw) as Partial<CacheEntry<unknown>>;\n        metas.push({ key, lastAccessedAt: parsed.lastAccessedAt ?? 0 });\n      } catch {}\n    })\n  );\n\n  // Sort oldest-first and evict the bottom 20%\n  metas.sort((a, b) => a.lastAccessedAt - b.lastAccessedAt);\n  const evictCount = Math.max(1, Math.floor(metas.length * 0.2));\n  const toEvict = metas.slice(0, evictCount);\n\n  await Promise.all(toEvict.map(({ key }) => storage.delete(key)));\n}\n\n// ─── Partial hydration ────────────────────────────────────────────────────────\n\n/**\n * Read a subset of a NormalizedList cache entry by item ids.\n *\n * Use for pagination, lazy loading, or detail views that only need\n * a handful of items from a large cached list.\n *\n * @returns null if the cache entry doesn't exist.\n *          Empty array if none of the requested ids are cached.\n *\n * @example\n *   const items = await getPartialCache<Expense>(\n *     cacheKeyFor([\"expenses\", tripId]),\n *     [\"exp_1\", \"exp_2\"]\n *   );\n */\nexport async function getPartialCache<T extends AnyItem>(\n  key: string,\n  ids: string[]\n): Promise<T[] | null> {\n  const entry = await readCache<NormalizedList<T>>(key);\n  if (!entry) return null;\n\n  const { byId } = entry.data;\n  const result: T[] = [];\n  for (const id of ids) {\n    if (id in byId) result.push(byId[id]);\n  }\n  return result;\n}\n\n// ─── TTL check ────────────────────────────────────────────────────────────────\n\nexport function isCacheStale(entry: CacheEntry<unknown>, ttlMs: number): boolean {\n  return Date.now() - entry.cachedAt > ttlMs;\n}\n","/**\n * src/testing.ts\n *\n * Test utilities for SmartQuery.\n *\n * Provides:\n *   • SmartQueryTestProvider  — wraps components with all required context\n *   • createMockStorage       — in-memory AsyncStorage (no MMKV, no IDB)\n *   • seedCache               — pre-populate cache before rendering\n *   • clearTestCache          — reset between tests\n *   • waitForCacheLoad        — await the initial async cache read\n *\n * Works with Jest, Vitest, and React Native Testing Library.\n *\n * @example\n *   import { render } from \"@testing-library/react-native\";\n *   import { SmartQueryTestProvider, seedCache } from \"react-smart-query/testing\";\n *\n *   beforeEach(() => seedCache([\"expenses\", \"trip_1\"], mockExpenses));\n *\n *   it(\"renders cached expenses\", async () => {\n *     const { findAllByTestId } = render(\n *       <SmartQueryTestProvider>\n *         <ExpenseList tripId=\"trip_1\" />\n *       </SmartQueryTestProvider>\n *     );\n *     const rows = await findAllByTestId(\"expense-row\");\n *     expect(rows).toHaveLength(mockExpenses.length);\n *   });\n */\n\nimport React, { ReactNode, useEffect } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { _setStorageOverride } from \"./services/storage.adapter\";\nimport { writeCache, cacheKeyFor } from \"./services/cache.service\";\nimport type { AsyncStorage, AnyItem } from \"./types\";\n\n// ─── In-memory storage ────────────────────────────────────────────────────────\n\nexport function createMockStorage(): AsyncStorage {\n  const store = new Map<string, string>();\n  return {\n    get: (key) => Promise.resolve(store.get(key)),\n    set: (key, value) => { store.set(key, value); return Promise.resolve(); },\n    delete: (key) => { store.delete(key); return Promise.resolve(); },\n    clearAll: () => { store.clear(); return Promise.resolve(); },\n    keys: () => Promise.resolve(Array.from(store.keys())),\n  };\n}\n\n// Module-level mock storage used by all test utilities\nlet _mockStorage: AsyncStorage | null = null;\n\nfunction ensureMockStorage(): AsyncStorage {\n  if (!_mockStorage) {\n    _mockStorage = createMockStorage();\n    _setStorageOverride(_mockStorage);\n  }\n  return _mockStorage;\n}\n\n// ─── SmartQueryTestProvider ───────────────────────────────────────────────────\n\ninterface TestProviderProps {\n  children: ReactNode;\n  /** Override the QueryClient (e.g. to set custom defaults) */\n  queryClient?: QueryClient;\n}\n\n/**\n * Wrap your component tree in tests.\n * Automatically uses in-memory storage — no MMKV, no IndexedDB required.\n */\nexport function SmartQueryTestProvider({\n  children,\n  queryClient,\n}: TestProviderProps): React.ReactElement {\n  const client = queryClient ?? new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: false,\n        gcTime: Infinity,\n      },\n    },\n  });\n\n  useEffect(() => {\n    ensureMockStorage();\n    return () => {\n      // Clean up override after the test\n      _setStorageOverride(null);\n      _mockStorage = null;\n    };\n  }, []);\n\n  return React.createElement(\n    QueryClientProvider,\n    { client },\n    children\n  );\n}\n\n// ─── Cache seeding ────────────────────────────────────────────────────────────\n\n/**\n * Pre-populate the cache before rendering a component.\n * Must be called before rendering (not inside a component).\n *\n * @example\n *   beforeEach(() => seedCache([\"expenses\", \"trip_1\"], mockExpenses));\n */\nexport async function seedCache<T>(\n  queryKey: readonly unknown[],\n  data: T\n): Promise<void> {\n  ensureMockStorage();\n  const key = cacheKeyFor(queryKey);\n  await writeCache(key, data);\n}\n\n/**\n * Clear all test cache entries between tests.\n *\n * @example\n *   afterEach(() => clearTestCache());\n */\nexport async function clearTestCache(): Promise<void> {\n  await ensureMockStorage().clearAll();\n}\n\n/**\n * Wait for the initial cache read to complete.\n * Useful when you need to assert on cached data immediately after render.\n *\n * @example\n *   const { getByText } = render(<MyComponent />);\n *   await waitForCacheLoad();\n *   expect(getByText(\"Expense 1\")).toBeTruthy();\n */\nexport function waitForCacheLoad(ms = 50): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ─── Mock query factory ───────────────────────────────────────────────────────\n\n/**\n * Create a mock queryFn that resolves with the provided data.\n * Use to test loading → success transitions.\n *\n * @example\n *   queryFn: mockQueryFn(mockExpenses, 100) // resolves after 100ms\n */\nexport function mockQueryFn<T>(data: T, delayMs = 0): () => Promise<T> {\n  return () =>\n    new Promise((resolve) => setTimeout(() => resolve(data), delayMs));\n}\n\n/**\n * Create a mock queryFn that rejects with the provided error.\n * Use to test error states.\n *\n * @example\n *   queryFn: mockErrorFn(new Error(\"Network error\"))\n */\nexport function mockErrorFn(error: Error, delayMs = 0): () => Promise<never> {\n  return () =>\n    new Promise((_, reject) => setTimeout(() => reject(error), delayMs));\n}\n"]}

package/dist/testing.mjs

@@ -0,0 +1,78 @@
+import { cacheKeyFor, writeCache } from './chunk-KSLDOL27.mjs';
+import { _setStorageOverride } from './chunk-QRCVY7UR.mjs';
+import React, { useEffect } from 'react';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+
+function createMockStorage() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => Promise.resolve(store.get(key)),
+    set: (key, value) => {
+      store.set(key, value);
+      return Promise.resolve();
+    },
+    delete: (key) => {
+      store.delete(key);
+      return Promise.resolve();
+    },
+    clearAll: () => {
+      store.clear();
+      return Promise.resolve();
+    },
+    keys: () => Promise.resolve(Array.from(store.keys()))
+  };
+}
+var _mockStorage = null;
+function ensureMockStorage() {
+  if (!_mockStorage) {
+    _mockStorage = createMockStorage();
+    _setStorageOverride(_mockStorage);
+  }
+  return _mockStorage;
+}
+function SmartQueryTestProvider({
+  children,
+  queryClient
+}) {
+  const client = queryClient ?? new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: false,
+        gcTime: Infinity
+      }
+    }
+  });
+  useEffect(() => {
+    ensureMockStorage();
+    return () => {
+      _setStorageOverride(null);
+      _mockStorage = null;
+    };
+  }, []);
+  return React.createElement(
+    QueryClientProvider,
+    { client },
+    children
+  );
+}
+async function seedCache(queryKey, data) {
+  ensureMockStorage();
+  const key = cacheKeyFor(queryKey);
+  await writeCache(key, data);
+}
+async function clearTestCache() {
+  await ensureMockStorage().clearAll();
+}
+function waitForCacheLoad(ms = 50) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function mockQueryFn(data, delayMs = 0) {
+  return () => new Promise((resolve) => setTimeout(() => resolve(data), delayMs));
+}
+function mockErrorFn(error, delayMs = 0) {
+  return () => new Promise((_, reject) => setTimeout(() => reject(error), delayMs));
+}
+
+export { SmartQueryTestProvider, clearTestCache, createMockStorage, mockErrorFn, mockQueryFn, seedCache, waitForCacheLoad };
+//# sourceMappingURL=testing.mjs.map
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":";;;;;AAuCO,SAAS,iBAAA,GAAkC;AAChD,EAAA,MAAM,KAAA,uBAAY,GAAA,EAAoB;AACtC,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,CAAC,GAAA,KAAQ,OAAA,CAAQ,QAAQ,KAAA,CAAM,GAAA,CAAI,GAAG,CAAC,CAAA;AAAA,IAC5C,GAAA,EAAK,CAAC,GAAA,EAAK,KAAA,KAAU;AAAE,MAAA,KAAA,CAAM,GAAA,CAAI,KAAK,KAAK,CAAA;AAAG,MAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,IAAG,CAAA;AAAA,IACxE,MAAA,EAAQ,CAAC,GAAA,KAAQ;AAAE,MAAA,KAAA,CAAM,OAAO,GAAG,CAAA;AAAG,MAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,IAAG,CAAA;AAAA,IAChE,UAAU,MAAM;AAAE,MAAA,KAAA,CAAM,KAAA,EAAM;AAAG,MAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,IAAG,CAAA;AAAA,IAC3D,IAAA,EAAM,MAAM,OAAA,CAAQ,OAAA,CAAQ,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,CAAC;AAAA,GACtD;AACF;AAGA,IAAI,YAAA,GAAoC,IAAA;AAExC,SAAS,iBAAA,GAAkC;AACzC,EAAA,IAAI,CAAC,YAAA,EAAc;AACjB,IAAA,YAAA,GAAe,iBAAA,EAAkB;AACjC,IAAA,mBAAA,CAAoB,YAAY,CAAA;AAAA,EAClC;AACA,EAAA,OAAO,YAAA;AACT;AAcO,SAAS,sBAAA,CAAuB;AAAA,EACrC,QAAA;AAAA,EACA;AACF,CAAA,EAA0C;AACxC,EAAA,MAAM,MAAA,GAAS,WAAA,IAAe,IAAI,WAAA,CAAY;AAAA,IAC5C,cAAA,EAAgB;AAAA,MACd,OAAA,EAAS;AAAA,QACP,KAAA,EAAO,KAAA;AAAA,QACP,MAAA,EAAQ;AAAA;AACV;AACF,GACD,CAAA;AAED,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,iBAAA,EAAkB;AAClB,IAAA,OAAO,MAAM;AAEX,MAAA,mBAAA,CAAoB,IAAI,CAAA;AACxB,MAAA,YAAA,GAAe,IAAA;AAAA,IACjB,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,KAAA,CAAM,aAAA;AAAA,IACX,mBAAA;AAAA,IACA,EAAE,MAAA,EAAO;AAAA,IACT;AAAA,GACF;AACF;AAWA,eAAsB,SAAA,CACpB,UACA,IAAA,EACe;AACf,EAAA,iBAAA,EAAkB;AAClB,EAAA,MAAM,GAAA,GAAM,YAAY,QAAQ,CAAA;AAChC,EAAA,MAAM,UAAA,CAAW,KAAK,IAAI,CAAA;AAC5B;AAQA,eAAsB,cAAA,GAAgC;AACpD,EAAA,MAAM,iBAAA,GAAoB,QAAA,EAAS;AACrC;AAWO,SAAS,gBAAA,CAAiB,KAAK,EAAA,EAAmB;AACvD,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;AAWO,SAAS,WAAA,CAAe,IAAA,EAAS,OAAA,GAAU,CAAA,EAAqB;AACrE,EAAA,OAAO,MACL,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY,UAAA,CAAW,MAAM,OAAA,CAAQ,IAAI,CAAA,EAAG,OAAO,CAAC,CAAA;AACrE;AASO,SAAS,WAAA,CAAY,KAAA,EAAc,OAAA,GAAU,CAAA,EAAyB;AAC3E,EAAA,OAAO,MACL,IAAI,OAAA,CAAQ,CAAC,CAAA,EAAG,MAAA,KAAW,UAAA,CAAW,MAAM,MAAA,CAAO,KAAK,CAAA,EAAG,OAAO,CAAC,CAAA;AACvE","file":"testing.mjs","sourcesContent":["/**\n * src/testing.ts\n *\n * Test utilities for SmartQuery.\n *\n * Provides:\n *   • SmartQueryTestProvider  — wraps components with all required context\n *   • createMockStorage       — in-memory AsyncStorage (no MMKV, no IDB)\n *   • seedCache               — pre-populate cache before rendering\n *   • clearTestCache          — reset between tests\n *   • waitForCacheLoad        — await the initial async cache read\n *\n * Works with Jest, Vitest, and React Native Testing Library.\n *\n * @example\n *   import { render } from \"@testing-library/react-native\";\n *   import { SmartQueryTestProvider, seedCache } from \"react-smart-query/testing\";\n *\n *   beforeEach(() => seedCache([\"expenses\", \"trip_1\"], mockExpenses));\n *\n *   it(\"renders cached expenses\", async () => {\n *     const { findAllByTestId } = render(\n *       <SmartQueryTestProvider>\n *         <ExpenseList tripId=\"trip_1\" />\n *       </SmartQueryTestProvider>\n *     );\n *     const rows = await findAllByTestId(\"expense-row\");\n *     expect(rows).toHaveLength(mockExpenses.length);\n *   });\n */\n\nimport React, { ReactNode, useEffect } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { _setStorageOverride } from \"./services/storage.adapter\";\nimport { writeCache, cacheKeyFor } from \"./services/cache.service\";\nimport type { AsyncStorage, AnyItem } from \"./types\";\n\n// ─── In-memory storage ────────────────────────────────────────────────────────\n\nexport function createMockStorage(): AsyncStorage {\n  const store = new Map<string, string>();\n  return {\n    get: (key) => Promise.resolve(store.get(key)),\n    set: (key, value) => { store.set(key, value); return Promise.resolve(); },\n    delete: (key) => { store.delete(key); return Promise.resolve(); },\n    clearAll: () => { store.clear(); return Promise.resolve(); },\n    keys: () => Promise.resolve(Array.from(store.keys())),\n  };\n}\n\n// Module-level mock storage used by all test utilities\nlet _mockStorage: AsyncStorage | null = null;\n\nfunction ensureMockStorage(): AsyncStorage {\n  if (!_mockStorage) {\n    _mockStorage = createMockStorage();\n    _setStorageOverride(_mockStorage);\n  }\n  return _mockStorage;\n}\n\n// ─── SmartQueryTestProvider ───────────────────────────────────────────────────\n\ninterface TestProviderProps {\n  children: ReactNode;\n  /** Override the QueryClient (e.g. to set custom defaults) */\n  queryClient?: QueryClient;\n}\n\n/**\n * Wrap your component tree in tests.\n * Automatically uses in-memory storage — no MMKV, no IndexedDB required.\n */\nexport function SmartQueryTestProvider({\n  children,\n  queryClient,\n}: TestProviderProps): React.ReactElement {\n  const client = queryClient ?? new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: false,\n        gcTime: Infinity,\n      },\n    },\n  });\n\n  useEffect(() => {\n    ensureMockStorage();\n    return () => {\n      // Clean up override after the test\n      _setStorageOverride(null);\n      _mockStorage = null;\n    };\n  }, []);\n\n  return React.createElement(\n    QueryClientProvider,\n    { client },\n    children\n  );\n}\n\n// ─── Cache seeding ────────────────────────────────────────────────────────────\n\n/**\n * Pre-populate the cache before rendering a component.\n * Must be called before rendering (not inside a component).\n *\n * @example\n *   beforeEach(() => seedCache([\"expenses\", \"trip_1\"], mockExpenses));\n */\nexport async function seedCache<T>(\n  queryKey: readonly unknown[],\n  data: T\n): Promise<void> {\n  ensureMockStorage();\n  const key = cacheKeyFor(queryKey);\n  await writeCache(key, data);\n}\n\n/**\n * Clear all test cache entries between tests.\n *\n * @example\n *   afterEach(() => clearTestCache());\n */\nexport async function clearTestCache(): Promise<void> {\n  await ensureMockStorage().clearAll();\n}\n\n/**\n * Wait for the initial cache read to complete.\n * Useful when you need to assert on cached data immediately after render.\n *\n * @example\n *   const { getByText } = render(<MyComponent />);\n *   await waitForCacheLoad();\n *   expect(getByText(\"Expense 1\")).toBeTruthy();\n */\nexport function waitForCacheLoad(ms = 50): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ─── Mock query factory ───────────────────────────────────────────────────────\n\n/**\n * Create a mock queryFn that resolves with the provided data.\n * Use to test loading → success transitions.\n *\n * @example\n *   queryFn: mockQueryFn(mockExpenses, 100) // resolves after 100ms\n */\nexport function mockQueryFn<T>(data: T, delayMs = 0): () => Promise<T> {\n  return () =>\n    new Promise((resolve) => setTimeout(() => resolve(data), delayMs));\n}\n\n/**\n * Create a mock queryFn that rejects with the provided error.\n * Use to test error states.\n *\n * @example\n *   queryFn: mockErrorFn(new Error(\"Network error\"))\n */\nexport function mockErrorFn(error: Error, delayMs = 0): () => Promise<never> {\n  return () =>\n    new Promise((_, reject) => setTimeout(() => reject(error), delayMs));\n}\n"]}

package/dist/types-XXiTKLnh.d.mts

@@ -0,0 +1,134 @@
+/**
+ * src/types.ts
+ *
+ * Single source of truth for all shared public types.
+ * No implementation logic — pure TypeScript interfaces and type aliases.
+ */
+/**
+ * Minimum shape required for list items.
+ * The actual id field name is configured via `getItemId` — this type
+ * only enforces that items are plain objects.
+ */
+type AnyItem = Record<string, unknown>;
+/**
+ * Extracts the id of an item. Configurable so APIs using `_id`, `uuid`,
+ * numeric ids, or composite keys all work without data transformation.
+ *
+ * @example
+ *   getItemId: (item) => item.id          // "id: string"
+ *   getItemId: (item) => String(item._id) // MongoDB ObjectId
+ *   getItemId: (item) => String(item.id)  // numeric id
+ */
+type GetItemId<T extends AnyItem> = (item: T) => string;
+/**
+ * Comparator for sort order. Same contract as Array.sort comparator.
+ * Return negative if a < b, positive if a > b, 0 if equal.
+ */
+type SortComparator<T extends AnyItem> = (a: T, b: T) => number;
+/**
+ * Extracts a version sticker (timestamp or counter) from an item.
+ * Used to prevent stale updates from overwriting fresher data.
+ */
+type GetItemVersion<T extends AnyItem> = (item: T) => number | string;
+interface CacheEntry<T> {
+    readonly version: number;
+    readonly data: T;
+    readonly cachedAt: number;
+    readonly lastAccessedAt: number;
+}
+interface NormalizedList<T extends AnyItem> {
+    byId: Record<string, T>;
+    allIds: string[];
+}
+type PaginationMode = "normalized" | "pages";
+interface UnifiedNormalizedInfiniteData<T extends AnyItem> {
+    data: NormalizedList<T>;
+    meta: {
+        nextCursor: unknown | null;
+        pageParams: unknown[];
+        lastFetchedAt?: number;
+    };
+}
+/** Legacy support - will be used internally or for migration if needed */
+interface InfinitePagedData<T extends AnyItem> {
+    pages: NormalizedList<T>[];
+    pageParams: unknown[];
+    nextCursor: unknown | null;
+}
+type ObservabilityEvent = {
+    type: "cache_hit";
+    queryKey: readonly unknown[];
+    cachedAt: number;
+} | {
+    type: "cache_miss";
+    queryKey: readonly unknown[];
+} | {
+    type: "cache_write";
+    queryKey: readonly unknown[];
+    dataSize: number;
+} | {
+    type: "fetch_start";
+    queryKey: readonly unknown[];
+} | {
+    type: "fetch_success";
+    queryKey: readonly unknown[];
+    durationMs: number;
+} | {
+    type: "fetch_error";
+    queryKey: readonly unknown[];
+    error: unknown;
+} | {
+    type: "queue_enqueue";
+    mutationId: string;
+    mutationType: string;
+} | {
+    type: "queue_success";
+    mutationId: string;
+} | {
+    type: "queue_failure";
+    mutationId: string;
+    retryCount: number;
+} | {
+    type: "queue_drained";
+} | {
+    type: "sync_conflict";
+    queryKey: readonly unknown[];
+    localVersion: unknown;
+    serverVersion: unknown;
+} | {
+    type: "storage_quota_exceeded";
+    key: string;
+};
+type ObserverFn = (event: ObservabilityEvent) => void;
+type MutationType = "ADD_ITEM" | "UPDATE_ITEM" | "REMOVE_ITEM" | "CUSTOM";
+interface QueuedMutation<TPayload = unknown> {
+    id: string;
+    type: MutationType | string;
+    /** Logical entity key for coalescing — e.g. "expense:exp_123" */
+    entityKey?: string;
+    queryKey: readonly unknown[];
+    payload: TPayload;
+    enqueuedAt: number;
+    retryCount: number;
+    maxRetries: number;
+    nextRetryAt: number;
+}
+interface SmartQueryError {
+    /** Original error from the API / network */
+    cause: unknown;
+    /** Human-readable message */
+    message: string;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** HTTP status code if available */
+    statusCode?: number;
+}
+interface AsyncStorage {
+    get(key: string): Promise<string | undefined>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    clearAll(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+export type { AsyncStorage as A, CacheEntry as C, GetItemId as G, InfinitePagedData as I, MutationType as M, NormalizedList as N, ObserverFn as O, PaginationMode as P, QueuedMutation as Q, SortComparator as S, UnifiedNormalizedInfiniteData as U, AnyItem as a, GetItemVersion as b, SmartQueryError as c, ObservabilityEvent as d };