@oxy.so/services 8.4.0 → 9.1.0

package/lib/module/ui/hooks/queryClient.js

@@ -7,30 +7,26 @@
  * - TanStack Query with `networkMode: 'offlineFirst'` for queries and mutations
  *   so cached data is served immediately and mutations are queued (paused) while
  *   the browser/device reports offline.
- * - `persistQueryClient(...)` from `@tanstack/react-query-persist-client` so that
- *   query results AND paused mutations survive a cold restart (kill-and-relaunch).
+ * - `attachQueryPersistence(...)` so that query results AND paused mutations
+ *   survive a cold restart (kill-and-relaunch); see `persistedQueryCache.ts`.
  * - `onlineManager` resume hook so paused mutations replay the moment the
  *   network is reported back, even if the host app swapped in a custom
  *   onlineManager implementation.
  *
- * Storage layer:
- * - React Native -> AsyncStorage via `createAsyncStoragePersister`.
- * - Web -> localStorage via `createSyncStoragePersister` (wrapped in the
- *   async persister API for a single call site).
- * - Both adapters are content-shape compatible with our `StorageInterface`.
+ * Storage layer: the platform `StorageInterface` (AsyncStorage on native,
+ * localStorage on web).
  *
  * Whitelist policy:
  * - Persist every account/user/session/privacy query and every queued mutation.
  * - DO NOT persist large list queries (e.g. activity feeds) — they go stale
  *   fast and would balloon storage. Add new keys to `PERSISTED_QUERY_PREFIXES`
- *   when introducing reads that should survive restart.
+ *   (`persistedQueryCache.ts`) when introducing reads that should survive restart.
  */
 
-import { QueryClient, hashKey, onlineManager } from '@tanstack/react-query';
-import { persistQueryClient } from '@tanstack/react-query-persist-client';
-import { createAsyncStoragePersister } from '@tanstack/query-async-storage-persister';
+import { QueryClient, onlineManager } from '@tanstack/react-query';
 import { isDev } from '@oxy.so/core';
-import { getOxyBuildId } from "../utils/buildId.js";
+import { accountQueryOwnership } from "./accountQueryPersistence.js";
+import { PERSISTED_QUERY_PREFIXES, hydrateSnapshot, subscribeSnapshots } from "./persistedQueryCache.js";
 const QUERY_CACHE_KEY = 'oxy_query_cache_v3';
 const QUERY_CACHE_MAX_AGE = 30 * 24 * 60 * 60 * 1000; // 30 days
 const QUERY_PERSIST_THROTTLE_MS = 1_000;
@@ -50,46 +46,16 @@ export function shouldRetryQuery(failureCount, error) {
 }
 
 /**
- * Query-key prefixes that should survive cold restart. Anything not listed
- * is dropped during dehydration so the persisted blob stays small.
- *
- * Mutations are persisted independently (always) so the offline write queue
- * works regardless of the read whitelist.
+ * Whether a query belongs in the account-agnostic cache: successful (a
+ * `pending`/`error` state is not worth keeping, and an error would leak
+ * failure objects across restarts) and under one of the SDK's own prefixes.
  */
-const PERSISTED_QUERY_PREFIXES = ['accounts', 'users', 'sessions', 'devices', 'privacy'];
-
-/**
- * Adapt our `StorageInterface` (which always returns `null` for missing keys)
- * to TanStack's `AsyncStorage` shape. The two are structurally identical
- * apart from naming; this also gives us a single place to add error
- * suppression if a host platform's storage throws.
- */
-function adaptStorage(storage) {
-  return {
-    getItem: key => storage.getItem(key),
-    setItem: (key, value) => storage.setItem(key, value),
-    removeItem: key => storage.removeItem(key)
-  };
-}
-
-/**
- * Decide whether a given query should be written to persistent storage.
- *
- * Two gates:
- * 1. The query must be in our prefix whitelist.
- * 2. The query must have completed successfully at least once — there's no
- *    point persisting a `pending`/`error` state, and persisting `error` would
- *    leak failure objects across restarts.
- */
-function shouldDehydrateQuery(query) {
+function isSharedQuery(query) {
   if (query.state.status !== 'success') {
     return false;
   }
   const head = query.queryKey[0];
-  if (typeof head !== 'string') {
-    return false;
-  }
-  return PERSISTED_QUERY_PREFIXES.includes(head);
+  return typeof head === 'string' && PERSISTED_QUERY_PREFIXES.includes(head);
 }
 
 /**
@@ -148,58 +114,55 @@ export const createQueryClient = () => {
   return client;
 };
 /**
- * Wire `persistQueryClient` to the supplied storage adapter.
+ * Restore, then keep writing, the account-agnostic cache.
  *
- * Returns once the in-flight restore promise is available so callers can
- * `await result.restored` before rendering UI that depends on cached data.
+ * Queries written by another build are dropped; queued mutations are kept
+ * (`persistedQueryCache.ts`). Whatever the app declared account-scoped
+ * (`accountQueries`) is left to `createAccountQueryPersistence`, even under
+ * one of the SDK's prefixes, so private rows never land in the shared blob and
+ * a paused mutation cannot replay twice or under another account.
  *
  * Safe to no-op if `storage` is null/undefined (e.g. server-side render
  * with no host storage).
  */
-export const attachQueryPersistence = (queryClient, storage,
-/**
- * Mutation keys the app declared account-scoped (`accountQueries`). Those are
- * persisted per account by `createAccountQueryPersistence`, never here, so a
- * paused mutation cannot replay twice or under another account.
- */
-accountMutationKeys = []) => {
+export const attachQueryPersistence = (queryClient, storage, accountQueries) => {
   if (!storage) {
     return {
       restored: Promise.resolve(),
       unsubscribe: () => {}
     };
   }
-  const persister = createAsyncStoragePersister({
-    storage: adaptStorage(storage),
-    key: QUERY_CACHE_KEY,
-    throttleTime: QUERY_PERSIST_THROTTLE_MS
-  });
-
-  // Persist every other mutation regardless of status: paused mutations are
-  // exactly the ones that must survive restart to replay when online.
-  const accountScoped = new Set(accountMutationKeys.map(key => hashKey(key)));
-  const shouldDehydrateMutation = mutation => {
-    const key = mutation.options.mutationKey;
-    return key === undefined || !accountScoped.has(hashKey(key));
+  const account = accountQueries ? accountQueryOwnership(accountQueries) : null;
+  const filters = {
+    shouldDehydrateQuery: query => isSharedQuery(query) && !(account?.ownsQuery(query) ?? false),
+    // Every other mutation, whatever its status: paused ones are exactly the
+    // ones that must survive a restart to replay when online.
+    shouldDehydrateMutation: mutation => !(account?.ownsMutation(mutation) ?? false)
   };
-  const [unsubscribe, restored] = persistQueryClient({
-    queryClient,
-    persister,
-    maxAge: QUERY_CACHE_MAX_AGE,
-    buster: getOxyBuildId(),
-    dehydrateOptions: {
-      shouldDehydrateQuery,
-      shouldDehydrateMutation
+  let stopped = false;
+  let writer = null;
+  const restored = (async () => {
+    const raw = await storage.getItem(QUERY_CACHE_KEY);
+    if (stopped) return;
+    if (!hydrateSnapshot(queryClient, raw, QUERY_CACHE_MAX_AGE) && raw) {
+      await storage.removeItem(QUERY_CACHE_KEY);
     }
-  });
-  restored.catch(error => {
+  })().catch(error => {
     if (isDev()) {
       console.warn('[QueryClient] Failed to restore persisted cache', error);
     }
+  }).then(() => {
+    if (stopped) return;
+    writer = subscribeSnapshots(queryClient, filters, QUERY_PERSIST_THROTTLE_MS, serialized => {
+      void Promise.resolve(storage.setItem(QUERY_CACHE_KEY, serialized)).catch(() => undefined);
+    });
   });
   return {
-    unsubscribe,
-    restored
+    restored,
+    unsubscribe: () => {
+      stopped = true;
+      writer?.unsubscribe();
+    }
   };
 };
 

package/lib/module/ui/hooks/queryClient.js.map

@@ -1 +1 @@
-{"version":3,"names":["QueryClient","hashKey","onlineManager","persistQueryClient","createAsyncStoragePersister","isDev","getOxyBuildId","QUERY_CACHE_KEY","QUERY_CACHE_MAX_AGE","QUERY_PERSIST_THROTTLE_MS","MAX_QUERY_RETRIES","statusOf","error","value","status","response","shouldRetryQuery","failureCount","PERSISTED_QUERY_PREFIXES","adaptStorage","storage","getItem","key","setItem","removeItem","shouldDehydrateQuery","query","state","head","queryKey","includes","createQueryClient","client","defaultOptions","queries","staleTime","gcTime","retry","retryDelay","attemptIndex","Math","min","refetchOnReconnect","refetchOnWindowFocus","networkMode","mutations","unsubscribe","subscribe","isOnline","getMutationCache","resumePausedMutations","Object","defineProperty","enumerable","configurable","writable","attachQueryPersistence","queryClient","accountMutationKeys","restored","Promise","resolve","persister","throttleTime","accountScoped","Set","map","shouldDehydrateMutation","mutation","options","mutationKey","undefined","has","maxAge","buster","dehydrateOptions","catch","console","warn","clearQueryCache"],"sourceRoot":"../../../../src","sources":["ui/hooks/queryClient.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,WAAW,EAAEC,OAAO,EAAEC,aAAa,QAAkD,uBAAuB;AACrH,SACEC,kBAAkB,QAEb,sCAAsC;AAC7C,SAASC,2BAA2B,QAAQ,yCAAyC;AACrF,SAASC,KAAK,QAAQ,cAAc;AAEpC,SAASC,aAAa,QAAQ,qBAAkB;AAEhD,MAAMC,eAAe,GAAG,oBAAoB;AAC5C,MAAMC,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AACtD,MAAMC,yBAAyB,GAAG,KAAK;AACvC,MAAMC,iBAAiB,GAAG,CAAC;AAE3B,SAASC,QAAQA,CAACC,KAAc,EAAiB;EAC/C,IAAI,CAACA,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE,OAAO,IAAI;EACpD,MAAMC,KAAK,GAAID,KAAK,CAA2DE,MAAM,IAC/EF,KAAK,CAAyCG,QAAQ,EAAED,MAAM;EACpE,OAAO,OAAOD,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,IAAI;AACjD;;AAEA;AACA,OAAO,SAASG,gBAAgBA,CAACC,YAAoB,EAAEL,KAAc,EAAW;EAC9E,IAAIK,YAAY,IAAIP,iBAAiB,EAAE,OAAO,KAAK;EACnD,MAAMI,MAAM,GAAGH,QAAQ,CAACC,KAAK,CAAC;EAC9B,IAAIE,MAAM,KAAK,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;EAClC,OAAOA,MAAM,KAAK,GAAG,IAAIA,MAAM,KAAK,GAAG,IAAIA,MAAM,KAAK,GAAG,IAAIA,MAAM,IAAI,GAAG;AAC5E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMI,wBAA+C,GAAG,CACtD,UAAU,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,CACV;;AAED;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAACC,OAAyB,EAI7C;EACA,OAAO;IACLC,OAAO,EAAGC,GAAG,IAAKF,OAAO,CAACC,OAAO,CAACC,GAAG,CAAC;IACtCC,OAAO,EAAEA,CAACD,GAAG,EAAET,KAAK,KAAKO,OAAO,CAACG,OAAO,CAACD,GAAG,EAAET,KAAK,CAAC;IACpDW,UAAU,EAAGF,GAAG,IAAKF,OAAO,CAACI,UAAU,CAACF,GAAG;EAC7C,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,oBAAoBA,CAACC,KAAY,EAAW;EACnD,IAAIA,KAAK,CAACC,KAAK,CAACb,MAAM,KAAK,SAAS,EAAE;IACpC,OAAO,KAAK;EACd;EACA,MAAMc,IAAI,GAAGF,KAAK,CAACG,QAAQ,CAAC,CAAC,CAAC;EAC9B,IAAI,OAAOD,IAAI,KAAK,QAAQ,EAAE;IAC5B,OAAO,KAAK;EACd;EACA,OAAOV,wBAAwB,CAACY,QAAQ,CAACF,IAAI,CAAC;AAChD;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMG,iBAAiB,GAAGA,CAAA,KAAmB;EAClD,MAAMC,MAAM,GAAG,IAAIhC,WAAW,CAAC;IAC7BiC,cAAc,EAAE;MACdC,OAAO,EAAE;QACP;QACAC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QACxB;QACAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACtBC,KAAK,EAAErB,gBAAgB;QACvBsB,UAAU,EAAGC,YAAY,IAAKC,IAAI,CAACC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAIF,YAAY,EAAE,KAAK,CAAC;QACvE;QACAG,kBAAkB,EAAE,IAAI;QACxB;QACAC,oBAAoB,EAAE,KAAK;QAC3B;QACAC,WAAW,EAAE;MACf,CAAC;MACDC,SAAS,EAAE;QACT;QACA;QACAR,KAAK,EAAE,KAAK;QACZ;QACAO,WAAW,EAAE;MACf;IACF;EACF,CAAC,CAAC;;EAEF;EACA;EACA;EACA;EACA,MAAME,WAAW,GAAG5C,aAAa,CAAC6C,SAAS,CAAEC,QAAQ,IAAK;IACxD,IAAIA,QAAQ,EAAE;MACZ,KAAKhB,MAAM,CAACiB,gBAAgB,CAAC,CAAC,CAACC,qBAAqB,CAAC,CAAC;IACxD;EACF,CAAC,CAAC;EAEFC,MAAM,CAACC,cAAc,CAACpB,MAAM,EAAE,wBAAwB,EAAE;IACtDnB,KAAK,EAAEiC,WAAW;IAClBO,UAAU,EAAE,KAAK;IACjBC,YAAY,EAAE,IAAI;IAClBC,QAAQ,EAAE;EACZ,CAAC,CAAC;EAEF,OAAOvB,MAAM;AACf,CAAC;AASD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMwB,sBAAsB,GAAGA,CACpCC,WAAwB,EACxBrC,OAA4C;AAC5C;AACF;AACA;AACA;AACA;AACEsC,mBAAwC,GAAG,EAAE,KACjB;EAC5B,IAAI,CAACtC,OAAO,EAAE;IACZ,OAAO;MACLuC,QAAQ,EAAEC,OAAO,CAACC,OAAO,CAAC,CAAC;MAC3Bf,WAAW,EAAEA,CAAA,KAAM,CAAC;IACtB,CAAC;EACH;EAEA,MAAMgB,SAAS,GAAG1D,2BAA2B,CAAC;IAC5CgB,OAAO,EAAED,YAAY,CAACC,OAAO,CAAC;IAC9BE,GAAG,EAAEf,eAAe;IACpBwD,YAAY,EAAEtD;EAChB,CAAC,CAAC;;EAEF;EACA;EACA,MAAMuD,aAAa,GAAG,IAAIC,GAAG,CAACP,mBAAmB,CAACQ,GAAG,CAAE5C,GAAG,IAAKrB,OAAO,CAACqB,GAAG,CAAC,CAAC,CAAC;EAC7E,MAAM6C,uBAAuB,GAAIC,QAAkB,IAAc;IAC/D,MAAM9C,GAAG,GAAG8C,QAAQ,CAACC,OAAO,CAACC,WAAW;IACxC,OAAOhD,GAAG,KAAKiD,SAAS,IAAI,CAACP,aAAa,CAACQ,GAAG,CAACvE,OAAO,CAACqB,GAAG,CAAC,CAAC;EAC9D,CAAC;EAED,MAAM,CAACwB,WAAW,EAAEa,QAAQ,CAAC,GAAGxD,kBAAkB,CAAC;IACjDsD,WAAW;IACXK,SAAS;IACTW,MAAM,EAAEjE,mBAAmB;IAC3BkE,MAAM,EAAEpE,aAAa,CAAC,CAAC;IACvBqE,gBAAgB,EAAE;MAChBlD,oBAAoB;MACpB0C;IACF;EACF,CAAC,CAAC;EAEFR,QAAQ,CAACiB,KAAK,CAAEhE,KAAK,IAAK;IACxB,IAAIP,KAAK,CAAC,CAAC,EAAE;MACXwE,OAAO,CAACC,IAAI,CAAC,iDAAiD,EAAElE,KAAK,CAAC;IACxE;EACF,CAAC,CAAC;EAEF,OAAO;IAAEkC,WAAW;IAAEa;EAAS,CAAC;AAClC,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMoB,eAAe,GAAG,MAAO3D,OAAyB,IAAoB;EACjF,IAAI;IACF,MAAMA,OAAO,CAACI,UAAU,CAACjB,eAAe,CAAC;EAC3C,CAAC,CAAC,OAAOK,KAAK,EAAE;IACd,IAAIP,KAAK,CAAC,CAAC,EAAE;MACXwE,OAAO,CAACC,IAAI,CAAC,qDAAqD,EAAElE,KAAK,CAAC;IAC5E;EACF;AACF,CAAC;;AAED;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["QueryClient","onlineManager","isDev","accountQueryOwnership","PERSISTED_QUERY_PREFIXES","hydrateSnapshot","subscribeSnapshots","QUERY_CACHE_KEY","QUERY_CACHE_MAX_AGE","QUERY_PERSIST_THROTTLE_MS","MAX_QUERY_RETRIES","statusOf","error","value","status","response","shouldRetryQuery","failureCount","isSharedQuery","query","state","head","queryKey","includes","createQueryClient","client","defaultOptions","queries","staleTime","gcTime","retry","retryDelay","attemptIndex","Math","min","refetchOnReconnect","refetchOnWindowFocus","networkMode","mutations","unsubscribe","subscribe","isOnline","getMutationCache","resumePausedMutations","Object","defineProperty","enumerable","configurable","writable","attachQueryPersistence","queryClient","storage","accountQueries","restored","Promise","resolve","account","filters","shouldDehydrateQuery","ownsQuery","shouldDehydrateMutation","mutation","ownsMutation","stopped","writer","raw","getItem","removeItem","catch","console","warn","then","serialized","setItem","undefined","clearQueryCache"],"sourceRoot":"../../../../src","sources":["ui/hooks/queryClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/ui/context/OxyContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgF/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AAU3B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAMhG,KAAK,0BAA0B,GAAG,IAAI,CACpC,eAAe,EACb,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CACtB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAixChE,CAAC;AAMF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAA0B;;CAMxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,eAAe,GAAG,IAAqC,CAAC;AAE1F,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,0BAMpC,CAAC"}
+{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgF/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AAU3B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAMhG,KAAK,0BAA0B,GAAG,IAAI,CACpC,eAAe,EACb,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CACtB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqxChE,CAAC;AAMF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAA0B;;CAMxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,eAAe,GAAG,IAAqC,CAAC;AAE1F,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,0BAMpC,CAAC"}

package/lib/typescript/commonjs/ui/hooks/accountQueryPersistence.d.ts

@@ -8,24 +8,32 @@
  *
  * - Storage is keyed by the account (`oxy_account_queries:<accountId>`), so a
  *   restore can only ever hydrate the account that is signed in.
- * - The buster is the build (`getOxyBuildId`), so no cache written by an older
- *   bundle, in an older shape, is ever served.
- * - On a subject change the declared roots, memory-only ones included, and the
- *   account's paused mutations are dropped
- *   from memory synchronously, before anyone is woken, and the new account's
- *   blob is restored. `isReady()` is false until that restore settles, and
+ * - Queries written by another build are dropped on restore; queued (paused)
+ *   mutations are kept (`persistedQueryCache.ts`).
+ * - On a subject change the account's queries, memory-only ones included, and
+ *   its paused mutations are dropped from memory synchronously, before anyone
+ *   is woken. The leaving account's latest state is written first, a sign-out
+ *   then deletes it, and only then is the next account's blob read.
+ * - `isReady()` is false until the signed-in account's blob is restored, and
  *   `RequireOxyAuth` waits on it, so another account's rows never render.
- * - On sign-out the signed-out account's blob is deleted.
+ *
+ * Every storage operation runs through one queue, in order, and a restore
+ * checks that its account is still the active one in the same tick it hydrates.
  */
-import { type Mutation, type QueryClient, type QueryKey } from '@tanstack/react-query';
+import { type Mutation, type Query, type QueryClient, type QueryKey } from '@tanstack/react-query';
 import type { StorageInterface } from '../utils/storageHelpers';
 /** An app's declaration of which data is private to the signed-in account. */
 export interface AccountQueriesConfig {
     /**
      * Query-key roots (`queryKey[0]`) whose data belongs to the signed-in account
-     * and survives a restart.
+     * and survives a restart. `'all'`: every query the app runs, for an app whose
+     * every read may depend on who is signed in, so no root can be forgotten.
+     *
+     * The roots `accounts`, `sessions` and `devices` are reserved for the SDK's
+     * device-level data: an app must not use them. `users` and `privacy` are the
+     * SDK's too, and with `'all'` they are dropped on a switch like the app's.
      */
-    roots: readonly string[];
+    roots: readonly string[] | 'all';
     /**
      * Roots that belong to the account too, but must not be written to disk
      * (signed URLs, AI output, search results): dropped on a switch, never persisted.
@@ -37,18 +45,28 @@ export interface AccountQueriesConfig {
      */
     mutationKeys?: readonly QueryKey[];
 }
+/** Which queries and mutations an `AccountQueriesConfig` makes the account's. */
+export interface AccountQueryOwnership {
+    /** Dropped from memory on a subject change. */
+    ownsQuery: (query: Query) => boolean;
+    /** Written to the account's blob. */
+    persistsQuery: (query: Query) => boolean;
+    ownsMutation: (mutation: Mutation) => boolean;
+}
+export declare function accountQueryOwnership(config: AccountQueriesConfig): AccountQueryOwnership;
 export declare const ACCOUNT_QUERY_CACHE_KEY = "oxy_account_queries";
 export interface AccountQueryPersistence {
     /** Storage became available (it initializes asynchronously). */
     setStorage(storage: StorageInterface): void;
     /** The signed-in account changed. `null` is a sign-out. Synchronous in-memory reset. */
     activate(accountId: string | null): void;
+    /** The owning provider mounted: restore and persist the active account. */
+    attach(): void;
+    /** The owning provider unmounted: stop touching the client and storage. */
+    detach(): void;
     /** True once the active account's cache is restored (always true signed out). */
     isReady(): boolean;
     subscribe(listener: () => void): () => void;
-    /** Whether a mutation is account-scoped (so the SDK's own persister skips it). */
-    ownsMutation(mutation: Mutation): boolean;
-    dispose(): void;
 }
 export declare function createAccountQueryPersistence(queryClient: QueryClient, config: AccountQueriesConfig): AccountQueryPersistence;
 //# sourceMappingURL=accountQueryPersistence.d.ts.map

package/lib/typescript/commonjs/ui/hooks/accountQueryPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountQueryPersistence.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/accountQueryPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAW,KAAK,QAAQ,EAAc,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAG5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,oBAAoB,GAC3B,uBAAuB,CAmIzB"}
+{"version":3,"file":"accountQueryPersistence.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/accountQueryPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAW,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAWhE,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACrC,qCAAqC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACzC,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;CAC/C;AAKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,qBAAqB,CA0BzF;AAED,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAAC;IACf,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAAC;IACf,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAMD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,oBAAoB,GAC3B,uBAAuB,CA2HzB"}

package/lib/typescript/commonjs/ui/hooks/persistedQueryCache.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The storage format and restore rules shared by the SDK's two query caches:
+ * the account-agnostic one (`attachQueryPersistence`) and the per-account one
+ * (`createAccountQueryPersistence`).
+ *
+ * A blob is `{ buster, timestamp, clientState }`, TanStack's persisted-client
+ * shape. Restoring it treats its two halves differently:
+ *
+ * - Queries are served before any refetch, so a query written by another
+ *   build, in whatever shape that build used, is dropped (`getOxyBuildId`).
+ * - Paused mutations are the user's queued actions (a star, a send made
+ *   offline). A deploy must not lose them, so they are restored whatever build
+ *   wrote them; the current build's `setMutationDefaults` replays them.
+ */
+import { type Mutation, type Query, type QueryClient } from '@tanstack/react-query';
+/** The SDK's own account-agnostic query roots, persisted by `attachQueryPersistence`. */
+export declare const PERSISTED_QUERY_PREFIXES: ReadonlyArray<string>;
+/**
+ * SDK queries whose data (or key) carries a signed, expiring URL. Never
+ * written to disk: a restored one would serve an expired URL.
+ */
+export declare const SDK_MEMORY_ONLY_ROOTS: ReadonlyArray<string>;
+export interface PersistFilters {
+    shouldDehydrateQuery: (query: Query) => boolean;
+    shouldDehydrateMutation: (mutation: Mutation) => boolean;
+}
+export declare function rootOf(query: Query): string | null;
+/** Serialize what the filters select, stamped with this build. */
+export declare function snapshot(queryClient: QueryClient, filters: PersistFilters): string;
+/**
+ * Hydrate a stored blob into the client, synchronously, so a caller can check
+ * it is still wanted immediately before. Returns false when there was nothing
+ * usable (absent, unreadable or expired), in which case the caller removes it.
+ */
+export declare function hydrateSnapshot(queryClient: QueryClient, raw: string | null, maxAge: number): boolean;
+/**
+ * Write the filtered cache on every change, at most once per `throttleMs`.
+ * `write` receives the serialized snapshot; `flush()` writes now.
+ */
+export declare function subscribeSnapshots(queryClient: QueryClient, filters: PersistFilters, throttleMs: number, write: (serialized: string) => void): {
+    flush: () => void;
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=persistedQueryCache.d.ts.map

package/lib/typescript/commonjs/ui/hooks/persistedQueryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistedQueryCache.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/persistedQueryCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAG/B,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,MAAM,CAM1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAKvD,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAChD,uBAAuB,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;CAC1D;AAQD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAGlD;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAOlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiBrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAClC;IAAE,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAqBhD"}

package/lib/typescript/commonjs/ui/hooks/queryClient.d.ts

@@ -5,27 +5,25 @@
  * - TanStack Query with `networkMode: 'offlineFirst'` for queries and mutations
  *   so cached data is served immediately and mutations are queued (paused) while
  *   the browser/device reports offline.
- * - `persistQueryClient(...)` from `@tanstack/react-query-persist-client` so that
- *   query results AND paused mutations survive a cold restart (kill-and-relaunch).
+ * - `attachQueryPersistence(...)` so that query results AND paused mutations
+ *   survive a cold restart (kill-and-relaunch); see `persistedQueryCache.ts`.
  * - `onlineManager` resume hook so paused mutations replay the moment the
  *   network is reported back, even if the host app swapped in a custom
  *   onlineManager implementation.
  *
- * Storage layer:
- * - React Native -> AsyncStorage via `createAsyncStoragePersister`.
- * - Web -> localStorage via `createSyncStoragePersister` (wrapped in the
- *   async persister API for a single call site).
- * - Both adapters are content-shape compatible with our `StorageInterface`.
+ * Storage layer: the platform `StorageInterface` (AsyncStorage on native,
+ * localStorage on web).
  *
  * Whitelist policy:
  * - Persist every account/user/session/privacy query and every queued mutation.
  * - DO NOT persist large list queries (e.g. activity feeds) — they go stale
  *   fast and would balloon storage. Add new keys to `PERSISTED_QUERY_PREFIXES`
- *   when introducing reads that should survive restart.
+ *   (`persistedQueryCache.ts`) when introducing reads that should survive restart.
  */
-import { QueryClient, type QueryKey } from '@tanstack/react-query';
-import { type PersistedClient } from '@tanstack/react-query-persist-client';
+import { QueryClient } from '@tanstack/react-query';
+import type { PersistedClient } from '@tanstack/react-query-persist-client';
 import type { StorageInterface } from '../utils/storageHelpers';
+import { type AccountQueriesConfig } from './accountQueryPersistence';
 /** Retry only failures that another attempt can plausibly change. */
 export declare function shouldRetryQuery(failureCount: number, error: unknown): boolean;
 /**
@@ -47,21 +45,18 @@ export interface AttachPersistenceResult {
     unsubscribe: () => void;
 }
 /**
- * Wire `persistQueryClient` to the supplied storage adapter.
+ * Restore, then keep writing, the account-agnostic cache.
  *
- * Returns once the in-flight restore promise is available so callers can
- * `await result.restored` before rendering UI that depends on cached data.
+ * Queries written by another build are dropped; queued mutations are kept
+ * (`persistedQueryCache.ts`). Whatever the app declared account-scoped
+ * (`accountQueries`) is left to `createAccountQueryPersistence`, even under
+ * one of the SDK's prefixes, so private rows never land in the shared blob and
+ * a paused mutation cannot replay twice or under another account.
  *
  * Safe to no-op if `storage` is null/undefined (e.g. server-side render
  * with no host storage).
  */
-export declare const attachQueryPersistence: (queryClient: QueryClient, storage: StorageInterface | null | undefined, 
-/**
- * Mutation keys the app declared account-scoped (`accountQueries`). Those are
- * persisted per account by `createAccountQueryPersistence`, never here, so a
- * paused mutation cannot replay twice or under another account.
- */
-accountMutationKeys?: readonly QueryKey[]) => AttachPersistenceResult;
+export declare const attachQueryPersistence: (queryClient: QueryClient, storage: StorageInterface | null | undefined, accountQueries?: AccountQueriesConfig) => AttachPersistenceResult;
 /**
  * Remove the persisted query+mutation cache (used on full sign-out / data reset).
  * Safe to call even if persistence was never attached.

package/lib/typescript/commonjs/ui/hooks/queryClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queryClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,WAAW,EAAqD,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9E;AAwDD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,QAAO,WA6CpC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,WAAW,EACxB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS;AAC5C;;;;GAIG;AACH,sBAAqB,SAAS,QAAQ,EAAO,KAC5C,uBAwCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAQ7E,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queryClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,WAAW,EAA4C,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAe7F,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9E;AAeD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,QAAO,WA6CpC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,WAAW,EACxB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC5C,iBAAiB,oBAAoB,KACpC,uBA8CF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAQ7E,CAAC;AAEF;;GAEG;AACH,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/lib/typescript/commonjs/ui/icons/MaterialCommunityIcons.d.ts

@@ -1,4 +1,4 @@
 /** Glyphs are decorative: hidden from assistive technology (see `decorativeIconSet`). */
-declare const MaterialCommunityIcons: import("@expo/vector-icons/build/createIconSet").Icon<"function" | "sort" | "at" | "label" | "link" | "ellipse" | "image" | "switch" | "text" | "alert" | "alert-circle" | "alert-circle-outline" | "apps" | "archive" | "arrow-down" | "arrow-up" | "briefcase-outline" | "bug" | "calendar" | "calendar-outline" | "camera" | "camera-outline" | "card" | "card-outline" | "cart-outline" | "chevron-down" | "chevron-up" | "close" | "close-circle" | "cloud-outline" | "cloud-upload" | "cloud-upload-outline" | "cog" | "cog-outline" | "cube-outline" | "download" | "download-outline" | "earth" | "ellipse-outline" | "eye" | "eye-off-outline" | "filter-outline" | "flash" | "folder" | "folder-open-outline" | "folder-outline" | "gift" | "gift-outline" | "grid" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "image-outline" | "information" | "information-outline" | "key" | "leaf" | "library" | "pencil-outline" | "play" | "pulse" | "radio" | "receipt-outline" | "resize" | "rocket" | "scale" | "school-outline" | "server" | "share-outline" | "shield" | "star" | "sync" | "trophy" | "trophy-outline" | "volume-off" | "wallet" | "wallet-outline" | "watch" | "wifi" | "solid" | "account" | "account-circle" | "account-cog-outline" | "account-eye-outline" | "account-group" | "account-multiple" | "account-multiple-outline" | "account-outline" | "account-plus" | "account-search" | "account-switch" | "android" | "archive-arrow-down" | "arrow-left" | "bell" | "bell-outline" | "bio" | "bullhorn" | "cake-variant" | "cake-variant-outline" | "cancel" | "cellphone" | "cellphone-basic" | "cellphone-message" | "cellphone-screenshot" | "chart-line" | "check-all" | "check-circle" | "chip" | "circle-outline" | "clock" | "clock-outline" | "code-tags" | "contain" | "content-copy" | "controller" | "cookie" | "credit-card" | "database-outline" | "delete" | "delete-outline" | "devices" | "dots-horizontal" | "email" | "email-outline" | "file" | "file-document" | "file-document-edit-outline" | "file-document-outline" | "file-excel-outline" | "file-outline" | "file-pdf-box" | "folder-image" | "folder-zip-outline" | "ghost" | "history" | "image-multiple-outline" | "link-variant" | "loading" | "lock-outline" | "logout" | "magnify" | "map-marker" | "map-marker-multiple" | "map-marker-outline" | "message" | "message-outline" | "minus-circle" | "motion" | "music-note-outline" | "network" | "null" | "numeric" | "opacity" | "open-in-app" | "openid" | "palette" | "palette-outline" | "pan" | "phone" | "phone-outline" | "plus" | "plus-circle" | "post" | "presentation" | "react" | "read" | "security" | "shield-account-outline" | "shield-check" | "shield-search" | "signature" | "sort-alphabetical-variant" | "sort-numeric-variant" | "store" | "tag" | "tag-outline" | "text-box-outline" | "theme-light-dark" | "transfer" | "translate" | "trash-can-outline" | "tray-arrow-down" | "update" | "video-outline" | "web" | "wifi-off" | "wrap" | "wrench" | "xml", "OxyServicesMaterialCommunityIcons">;
+declare const MaterialCommunityIcons: import("@expo/vector-icons/build/createIconSet").Icon<"function" | "devices" | "sort" | "at" | "label" | "link" | "ellipse" | "image" | "switch" | "text" | "alert" | "alert-circle" | "alert-circle-outline" | "apps" | "archive" | "arrow-down" | "arrow-up" | "briefcase-outline" | "bug" | "calendar" | "calendar-outline" | "camera" | "camera-outline" | "card" | "card-outline" | "cart-outline" | "chevron-down" | "chevron-up" | "close" | "close-circle" | "cloud-outline" | "cloud-upload" | "cloud-upload-outline" | "cog" | "cog-outline" | "cube-outline" | "download" | "download-outline" | "earth" | "ellipse-outline" | "eye" | "eye-off-outline" | "filter-outline" | "flash" | "folder" | "folder-open-outline" | "folder-outline" | "gift" | "gift-outline" | "grid" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "image-outline" | "information" | "information-outline" | "key" | "leaf" | "library" | "pencil-outline" | "play" | "pulse" | "radio" | "receipt-outline" | "resize" | "rocket" | "scale" | "school-outline" | "server" | "share-outline" | "shield" | "star" | "sync" | "trophy" | "trophy-outline" | "volume-off" | "wallet" | "wallet-outline" | "watch" | "wifi" | "solid" | "opacity" | "wrap" | "account" | "account-circle" | "account-cog-outline" | "account-eye-outline" | "account-group" | "account-multiple" | "account-multiple-outline" | "account-outline" | "account-plus" | "account-search" | "account-switch" | "android" | "archive-arrow-down" | "arrow-left" | "bell" | "bell-outline" | "bio" | "bullhorn" | "cake-variant" | "cake-variant-outline" | "cancel" | "cellphone" | "cellphone-basic" | "cellphone-message" | "cellphone-screenshot" | "chart-line" | "check-all" | "check-circle" | "chip" | "circle-outline" | "clock" | "clock-outline" | "code-tags" | "contain" | "content-copy" | "controller" | "cookie" | "credit-card" | "database-outline" | "delete" | "delete-outline" | "dots-horizontal" | "email" | "email-outline" | "file" | "file-document" | "file-document-edit-outline" | "file-document-outline" | "file-excel-outline" | "file-outline" | "file-pdf-box" | "folder-image" | "folder-zip-outline" | "ghost" | "history" | "image-multiple-outline" | "link-variant" | "loading" | "lock-outline" | "logout" | "magnify" | "map-marker" | "map-marker-multiple" | "map-marker-outline" | "message" | "message-outline" | "minus-circle" | "motion" | "music-note-outline" | "network" | "null" | "numeric" | "open-in-app" | "openid" | "palette" | "palette-outline" | "pan" | "phone" | "phone-outline" | "plus" | "plus-circle" | "post" | "presentation" | "react" | "read" | "security" | "shield-account-outline" | "shield-check" | "shield-search" | "signature" | "sort-alphabetical-variant" | "sort-numeric-variant" | "store" | "tag" | "tag-outline" | "text-box-outline" | "theme-light-dark" | "transfer" | "translate" | "trash-can-outline" | "tray-arrow-down" | "update" | "video-outline" | "web" | "wifi-off" | "wrench" | "xml", "OxyServicesMaterialCommunityIcons">;
 export default MaterialCommunityIcons;
 //# sourceMappingURL=MaterialCommunityIcons.d.ts.map

package/lib/typescript/module/ui/context/OxyContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgF/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,sBAAmB,CAAC;AAU3B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAMhG,KAAK,0BAA0B,GAAG,IAAI,CACpC,eAAe,EACb,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CACtB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAixChE,CAAC;AAMF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAA0B;;CAMxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,eAAe,GAAG,IAAqC,CAAC;AAE1F,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,0BAMpC,CAAC"}
+{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgF/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,sBAAmB,CAAC;AAU3B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAMhG,KAAK,0BAA0B,GAAG,IAAI,CACpC,eAAe,EACb,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CACtB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqxChE,CAAC;AAMF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAA0B;;CAMxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,eAAe,GAAG,IAAqC,CAAC;AAE1F,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,0BAMpC,CAAC"}

package/lib/typescript/module/ui/hooks/accountQueryPersistence.d.ts

@@ -8,24 +8,32 @@
  *
  * - Storage is keyed by the account (`oxy_account_queries:<accountId>`), so a
  *   restore can only ever hydrate the account that is signed in.
- * - The buster is the build (`getOxyBuildId`), so no cache written by an older
- *   bundle, in an older shape, is ever served.
- * - On a subject change the declared roots, memory-only ones included, and the
- *   account's paused mutations are dropped
- *   from memory synchronously, before anyone is woken, and the new account's
- *   blob is restored. `isReady()` is false until that restore settles, and
+ * - Queries written by another build are dropped on restore; queued (paused)
+ *   mutations are kept (`persistedQueryCache.ts`).
+ * - On a subject change the account's queries, memory-only ones included, and
+ *   its paused mutations are dropped from memory synchronously, before anyone
+ *   is woken. The leaving account's latest state is written first, a sign-out
+ *   then deletes it, and only then is the next account's blob read.
+ * - `isReady()` is false until the signed-in account's blob is restored, and
  *   `RequireOxyAuth` waits on it, so another account's rows never render.
- * - On sign-out the signed-out account's blob is deleted.
+ *
+ * Every storage operation runs through one queue, in order, and a restore
+ * checks that its account is still the active one in the same tick it hydrates.
  */
-import { type Mutation, type QueryClient, type QueryKey } from '@tanstack/react-query';
+import { type Mutation, type Query, type QueryClient, type QueryKey } from '@tanstack/react-query';
 import type { StorageInterface } from '../utils/storageHelpers.js';
 /** An app's declaration of which data is private to the signed-in account. */
 export interface AccountQueriesConfig {
     /**
      * Query-key roots (`queryKey[0]`) whose data belongs to the signed-in account
-     * and survives a restart.
+     * and survives a restart. `'all'`: every query the app runs, for an app whose
+     * every read may depend on who is signed in, so no root can be forgotten.
+     *
+     * The roots `accounts`, `sessions` and `devices` are reserved for the SDK's
+     * device-level data: an app must not use them. `users` and `privacy` are the
+     * SDK's too, and with `'all'` they are dropped on a switch like the app's.
      */
-    roots: readonly string[];
+    roots: readonly string[] | 'all';
     /**
      * Roots that belong to the account too, but must not be written to disk
      * (signed URLs, AI output, search results): dropped on a switch, never persisted.
@@ -37,18 +45,28 @@ export interface AccountQueriesConfig {
      */
     mutationKeys?: readonly QueryKey[];
 }
+/** Which queries and mutations an `AccountQueriesConfig` makes the account's. */
+export interface AccountQueryOwnership {
+    /** Dropped from memory on a subject change. */
+    ownsQuery: (query: Query) => boolean;
+    /** Written to the account's blob. */
+    persistsQuery: (query: Query) => boolean;
+    ownsMutation: (mutation: Mutation) => boolean;
+}
+export declare function accountQueryOwnership(config: AccountQueriesConfig): AccountQueryOwnership;
 export declare const ACCOUNT_QUERY_CACHE_KEY = "oxy_account_queries";
 export interface AccountQueryPersistence {
     /** Storage became available (it initializes asynchronously). */
     setStorage(storage: StorageInterface): void;
     /** The signed-in account changed. `null` is a sign-out. Synchronous in-memory reset. */
     activate(accountId: string | null): void;
+    /** The owning provider mounted: restore and persist the active account. */
+    attach(): void;
+    /** The owning provider unmounted: stop touching the client and storage. */
+    detach(): void;
     /** True once the active account's cache is restored (always true signed out). */
     isReady(): boolean;
     subscribe(listener: () => void): () => void;
-    /** Whether a mutation is account-scoped (so the SDK's own persister skips it). */
-    ownsMutation(mutation: Mutation): boolean;
-    dispose(): void;
 }
 export declare function createAccountQueryPersistence(queryClient: QueryClient, config: AccountQueriesConfig): AccountQueryPersistence;
 //# sourceMappingURL=accountQueryPersistence.d.ts.map

package/lib/typescript/module/ui/hooks/accountQueryPersistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountQueryPersistence.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/accountQueryPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAW,KAAK,QAAQ,EAAc,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAG5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAGhE,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,oBAAoB,GAC3B,uBAAuB,CAmIzB"}
+{"version":3,"file":"accountQueryPersistence.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/accountQueryPersistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAW,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAWhE,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACrC,qCAAqC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACzC,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;CAC/C;AAKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,qBAAqB,CA0BzF;AAED,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAI7D,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAAC;IACf,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAAC;IACf,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAMD,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,oBAAoB,GAC3B,uBAAuB,CA2HzB"}

package/lib/typescript/module/ui/hooks/persistedQueryCache.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The storage format and restore rules shared by the SDK's two query caches:
+ * the account-agnostic one (`attachQueryPersistence`) and the per-account one
+ * (`createAccountQueryPersistence`).
+ *
+ * A blob is `{ buster, timestamp, clientState }`, TanStack's persisted-client
+ * shape. Restoring it treats its two halves differently:
+ *
+ * - Queries are served before any refetch, so a query written by another
+ *   build, in whatever shape that build used, is dropped (`getOxyBuildId`).
+ * - Paused mutations are the user's queued actions (a star, a send made
+ *   offline). A deploy must not lose them, so they are restored whatever build
+ *   wrote them; the current build's `setMutationDefaults` replays them.
+ */
+import { type Mutation, type Query, type QueryClient } from '@tanstack/react-query';
+/** The SDK's own account-agnostic query roots, persisted by `attachQueryPersistence`. */
+export declare const PERSISTED_QUERY_PREFIXES: ReadonlyArray<string>;
+/**
+ * SDK queries whose data (or key) carries a signed, expiring URL. Never
+ * written to disk: a restored one would serve an expired URL.
+ */
+export declare const SDK_MEMORY_ONLY_ROOTS: ReadonlyArray<string>;
+export interface PersistFilters {
+    shouldDehydrateQuery: (query: Query) => boolean;
+    shouldDehydrateMutation: (mutation: Mutation) => boolean;
+}
+export declare function rootOf(query: Query): string | null;
+/** Serialize what the filters select, stamped with this build. */
+export declare function snapshot(queryClient: QueryClient, filters: PersistFilters): string;
+/**
+ * Hydrate a stored blob into the client, synchronously, so a caller can check
+ * it is still wanted immediately before. Returns false when there was nothing
+ * usable (absent, unreadable or expired), in which case the caller removes it.
+ */
+export declare function hydrateSnapshot(queryClient: QueryClient, raw: string | null, maxAge: number): boolean;
+/**
+ * Write the filtered cache on every change, at most once per `throttleMs`.
+ * `write` receives the serialized snapshot; `flush()` writes now.
+ */
+export declare function subscribeSnapshots(queryClient: QueryClient, filters: PersistFilters, throttleMs: number, write: (serialized: string) => void): {
+    flush: () => void;
+    unsubscribe: () => void;
+};
+//# sourceMappingURL=persistedQueryCache.d.ts.map

package/lib/typescript/module/ui/hooks/persistedQueryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistedQueryCache.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/persistedQueryCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAG/B,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,MAAM,CAM1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAKvD,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAChD,uBAAuB,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;CAC1D;AAQD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAGlD;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAOlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiBrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAClC;IAAE,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAqBhD"}