@oxy.so/services 13.1.0 → 13.2.0

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

@@ -48,10 +48,11 @@ export interface AttachPersistenceResult {
  * Restore, then keep writing, the account-agnostic cache.
  *
  * 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.
+ * (`persistedQueryCache.ts`). Whatever belongs to the account (`accountQueries`,
+ * or a query marked `meta: { persist: 'account' }`) 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).

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

@@ -1 +1 @@
-{"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,4BAAyB,CAAC;AAChE,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,8BAA2B,CAAC;AAoB7F,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,uBA6CF,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,EAA6B,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAChE,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,8BAA2B,CAAC;AAqB7F,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9E;AAQD;;;;;;;;;;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;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,WAAW,EACxB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC5C,iBAAiB,oBAAoB,KACpC,uBA4CF,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/module/ui/icons/Ionicons.d.ts

@@ -1,4 +1,4 @@
 /** Glyphs are decorative: hidden from assistive technology (see `decorativeIconSet`). */
-declare const Ionicons: import("@expo/vector-icons/build/createIconSet").Icon<"push" | "at" | "code" | "business" | "navigate" | "key" | "open" | "add" | "search" | "list" | "settings" | "infinite" | "trash" | "wallet" | "link" | "text" | "scale" | "image" | "alert" | "radio" | "grid" | "warning" | "people" | "ellipse" | "add-circle-outline" | "alert-circle" | "alert-circle-outline" | "apps" | "archive" | "arrow-back" | "arrow-down" | "arrow-forward" | "arrow-undo" | "arrow-up" | "briefcase-outline" | "bug" | "bulb" | "business-outline" | "calendar" | "calendar-outline" | "camera" | "camera-outline" | "card" | "card-outline" | "cart-outline" | "cash-outline" | "chatbubble" | "checkmark" | "checkmark-circle" | "chevron-back" | "chevron-down" | "chevron-forward" | "chevron-up" | "close" | "close-circle" | "cloud-offline-outline" | "cloud-outline" | "cloud-upload" | "cloud-upload-outline" | "cog" | "cog-outline" | "construct-outline" | "copy-outline" | "cube-outline" | "desktop" | "document" | "document-outline" | "document-text" | "documents" | "download" | "download-outline" | "earth" | "ellipse-outline" | "ellipsis-horizontal" | "eye" | "eye-off-outline" | "filter-outline" | "flame" | "flash" | "folder" | "folder-open-outline" | "folder-outline" | "footsteps" | "gift" | "gift-outline" | "hand-left" | "hardware-chip-outline" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "hourglass-outline" | "image-outline" | "images" | "images-outline" | "information" | "information-circle" | "information-outline" | "leaf" | "library" | "link-outline" | "location" | "location-outline" | "lock-closed" | "log-out-outline" | "mail" | "musical-notes" | "pencil-outline" | "people-outline" | "play" | "pricetag-outline" | "pulse" | "qr-code-outline" | "receipt-outline" | "refresh-outline" | "remove" | "repeat-outline" | "resize" | "rocket" | "school-outline" | "search-outline" | "server" | "share-outline" | "shield" | "shield-checkmark" | "shield-checkmark-outline" | "star" | "swap-horizontal-outline" | "swap-vertical-outline" | "sync" | "time-outline" | "trash-outline" | "trophy" | "trophy-outline" | "videocam" | "volume-off" | "wallet-outline" | "watch" | "wifi", "OxyServicesIonicons">;
+declare const Ionicons: import("@expo/vector-icons/build/createIconSet").Icon<"push" | "at" | "infinite" | "code" | "business" | "navigate" | "key" | "open" | "add" | "search" | "list" | "settings" | "trash" | "wallet" | "link" | "text" | "scale" | "image" | "alert" | "radio" | "grid" | "warning" | "people" | "ellipse" | "add-circle-outline" | "alert-circle" | "alert-circle-outline" | "apps" | "archive" | "arrow-back" | "arrow-down" | "arrow-forward" | "arrow-undo" | "arrow-up" | "briefcase-outline" | "bug" | "bulb" | "business-outline" | "calendar" | "calendar-outline" | "camera" | "camera-outline" | "card" | "card-outline" | "cart-outline" | "cash-outline" | "chatbubble" | "checkmark" | "checkmark-circle" | "chevron-back" | "chevron-down" | "chevron-forward" | "chevron-up" | "close" | "close-circle" | "cloud-offline-outline" | "cloud-outline" | "cloud-upload" | "cloud-upload-outline" | "cog" | "cog-outline" | "construct-outline" | "copy-outline" | "cube-outline" | "desktop" | "document" | "document-outline" | "document-text" | "documents" | "download" | "download-outline" | "earth" | "ellipse-outline" | "ellipsis-horizontal" | "eye" | "eye-off-outline" | "filter-outline" | "flame" | "flash" | "folder" | "folder-open-outline" | "folder-outline" | "footsteps" | "gift" | "gift-outline" | "hand-left" | "hardware-chip-outline" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "hourglass-outline" | "image-outline" | "images" | "images-outline" | "information" | "information-circle" | "information-outline" | "leaf" | "library" | "link-outline" | "location" | "location-outline" | "lock-closed" | "log-out-outline" | "mail" | "musical-notes" | "pencil-outline" | "people-outline" | "play" | "pricetag-outline" | "pulse" | "qr-code-outline" | "receipt-outline" | "refresh-outline" | "remove" | "repeat-outline" | "resize" | "rocket" | "school-outline" | "search-outline" | "server" | "share-outline" | "shield" | "shield-checkmark" | "shield-checkmark-outline" | "star" | "swap-horizontal-outline" | "swap-vertical-outline" | "sync" | "time-outline" | "trash-outline" | "trophy" | "trophy-outline" | "videocam" | "volume-off" | "wallet-outline" | "watch" | "wifi", "OxyServicesIonicons">;
 export default Ionicons;
 //# sourceMappingURL=Ionicons.d.ts.map

package/lib/typescript/module/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" | "android" | "web" | "devices" | "at" | "security" | "account" | "message" | "email" | "bio" | "phone" | "key" | "network" | "logout" | "label" | "history" | "wallet" | "link" | "text" | "translate" | "scale" | "solid" | "wrap" | "image" | "alert" | "radio" | "switch" | "grid" | "numeric" | "loading" | "decimal" | "contacts" | "ellipse" | "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" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "image-outline" | "information" | "information-outline" | "leaf" | "library" | "mail" | "pencil-outline" | "play" | "pulse" | "receipt-outline" | "resize" | "rocket" | "school-outline" | "server" | "share-outline" | "shield" | "star" | "sync" | "trophy" | "trophy-outline" | "volume-off" | "wallet-outline" | "watch" | "wifi" | "delete" | "forward" | "account-circle" | "account-cog-outline" | "account-eye-outline" | "account-group" | "account-multiple" | "account-outline" | "account-plus" | "account-search" | "account-switch" | "archive-arrow-down" | "arrow-left" | "bell" | "bell-outline" | "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-outline" | "dots-horizontal" | "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" | "image-multiple-outline" | "inbox" | "link-variant" | "lock-outline" | "magnify" | "map-marker" | "map-marker-multiple" | "map-marker-outline" | "message-outline" | "minus-circle" | "motion" | "music-note-outline" | "null" | "open-in-app" | "openid" | "palette" | "palette-outline" | "pan" | "phone-outline" | "plus" | "plus-circle" | "post" | "presentation" | "react" | "read" | "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" | "trash-can-outline" | "tray-arrow-down" | "update" | "upload" | "video-outline" | "wifi-off" | "wrench" | "xml", "OxyServicesMaterialCommunityIcons">;
+declare const MaterialCommunityIcons: import("@expo/vector-icons/build/createIconSet").Icon<"function" | "android" | "web" | "devices" | "at" | "forward" | "account" | "security" | "message" | "email" | "bio" | "phone" | "key" | "network" | "logout" | "label" | "history" | "wallet" | "link" | "text" | "translate" | "scale" | "solid" | "wrap" | "image" | "alert" | "radio" | "switch" | "grid" | "numeric" | "loading" | "decimal" | "contacts" | "ellipse" | "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" | "heart" | "heart-outline" | "help-circle" | "help-circle-outline" | "image-outline" | "information" | "information-outline" | "leaf" | "library" | "mail" | "pencil-outline" | "play" | "pulse" | "receipt-outline" | "resize" | "rocket" | "school-outline" | "server" | "share-outline" | "shield" | "star" | "sync" | "trophy" | "trophy-outline" | "volume-off" | "wallet-outline" | "watch" | "wifi" | "delete" | "account-circle" | "account-cog-outline" | "account-eye-outline" | "account-group" | "account-multiple" | "account-outline" | "account-plus" | "account-search" | "account-switch" | "archive-arrow-down" | "arrow-left" | "bell" | "bell-outline" | "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-outline" | "dots-horizontal" | "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" | "image-multiple-outline" | "inbox" | "link-variant" | "lock-outline" | "magnify" | "map-marker" | "map-marker-multiple" | "map-marker-outline" | "message-outline" | "minus-circle" | "motion" | "music-note-outline" | "null" | "open-in-app" | "openid" | "palette" | "palette-outline" | "pan" | "phone-outline" | "plus" | "plus-circle" | "post" | "presentation" | "react" | "read" | "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" | "trash-can-outline" | "tray-arrow-down" | "update" | "upload" | "video-outline" | "wifi-off" | "wrench" | "xml", "OxyServicesMaterialCommunityIcons">;
 export default MaterialCommunityIcons;
 //# sourceMappingURL=MaterialCommunityIcons.d.ts.map

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

@@ -20,7 +20,7 @@ export { LogoIcon } from './components/logo/LogoIcon.js';
 export { LogoText } from './components/logo/LogoText.js';
 export { RequireOxyAuth } from './components/RequireOxyAuth.js';
 export type { RequireOxyAuthProps, RequireOxyAuthPrompt } from './components/RequireOxyAuth.js';
-export type { AccountQueriesConfig } from './hooks/accountQueryPersistence.js';
+export type { AccountQueriesConfig, AccountQueryMeta } from './hooks/accountQueryPersistence.js';
 export { default as FollowButton } from './components/FollowButton.js';
 export { default as PeableButton } from './components/PeableButton.js';
 export type { PeableButtonProps } from './components/PeableButton.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,wBAAqB,CAAC;AAS7B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,6BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAA8B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,+BAA4B,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA4B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA4B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA4B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gCAA6B,CAAC;AAE7F,YAAY,EAAE,oBAAoB,EAAE,MAAM,oCAAiC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA2B,CAAC;AACnE,8CAA8C;AAC9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,mDAAmD;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA2B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,+BAA4B,CAAC;AAGtE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAsB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAoC,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAoC,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAiB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAiB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,sBAAmB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAoB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAM9E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAoB,CAAC;AAGlD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,0BAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAAuB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,wBAAqB,CAAC;AAS7B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,6BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iCAA8B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,+BAA4B,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA4B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA4B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA4B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAA6B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gCAA6B,CAAC;AAE7F,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oCAAiC,CAAC;AAC9F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA2B,CAAC;AACnE,8CAA8C;AAC9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,8BAA2B,CAAC;AACpE,mDAAmD;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA2B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,+BAA4B,CAAC;AAGtE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAsB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAoC,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uCAAoC,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAiB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAiB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,sBAAmB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAoB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAM9E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAoB,CAAC;AAGlD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,0BAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAAuB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mCAAgC,CAAC"}

package/lib/typescript/module/ui/types/navigation.d.ts

@@ -129,6 +129,8 @@ export interface OxyProviderProps {
      * account switch and deleted on sign-out. `RequireOxyAuth` waits for the
      * signed-in account's cache to restore, so another account's rows never
      * render. Works with the SDK's client or one passed as `queryClient`.
+     * A single query opts in with `meta: { persist: 'account' }` and needs no
+     * declaration here (`AccountQueryMeta`).
      */
     accountQueries?: AccountQueriesConfig;
     /**

package/lib/typescript/module/ui/types/navigation.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "13.1.0",
+  "version": "13.2.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/index.ts

@@ -323,7 +323,7 @@ export type {
 export { RequireOxyAuth } from './ui/components/RequireOxyAuth';
 export type { RequireOxyAuthProps, RequireOxyAuthPrompt } from './ui/components/RequireOxyAuth';
 // `OxyProvider`'s `accountQueries`: the app's per-account offline cache.
-export type { AccountQueriesConfig } from './ui/hooks/accountQueryPersistence';
+export type { AccountQueriesConfig, AccountQueryMeta } from './ui/hooks/accountQueryPersistence';
 
 export { default as FollowButton } from './ui/components/FollowButton';
 export type {

package/src/ui/context/OxyContext.tsx

@@ -130,8 +130,6 @@ export {
   OxyProviderMissingError,
 } from './oxyRuntimeContext';
 
-const subscribeNever = (): (() => void) => () => undefined;
-
 /**
  * The SDK's internal runtime provider — the session/account state machine that
  * backs `useOxy()`.
@@ -350,24 +348,23 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
   // a persistence write is never dropped because it raced storage init.
   const queryClient = useQueryClient();
 
-  // The app's per-account offline cache (`accountQueries`). Built once, like the
-  // runtime. `handleSubjectChange` activates it BEFORE anyone is woken, so a
-  // consumer of the new account never reads the previous account's rows.
-  const accountQueryPersistenceRef = useRef<AccountQueryPersistence | null | undefined>(undefined);
-  if (accountQueryPersistenceRef.current === undefined) {
-    accountQueryPersistenceRef.current = accountQueries
-      ? createAccountQueryPersistence(queryClient, accountQueries)
-      : null;
+  // The account's offline cache: the app's `accountQueries` roots and every
+  // query marked `meta: { persist: 'account' }`. Built once, like the runtime.
+  // `handleSubjectChange` activates it BEFORE anyone is woken, so a consumer of
+  // the new account never reads the previous account's rows.
+  const accountQueryPersistenceRef = useRef<AccountQueryPersistence | null>(null);
+  if (accountQueryPersistenceRef.current === null) {
+    accountQueryPersistenceRef.current = createAccountQueryPersistence(queryClient, accountQueries);
   }
   const accountQueryPersistence = accountQueryPersistenceRef.current;
   useEffect(() => {
-    accountQueryPersistence?.attach();
-    return () => accountQueryPersistence?.detach();
+    accountQueryPersistence.attach();
+    return () => accountQueryPersistence.detach();
   }, [accountQueryPersistence]);
   const isAccountCacheReady = useSyncExternalStore(
-    accountQueryPersistence ? accountQueryPersistence.subscribe : subscribeNever,
-    () => accountQueryPersistence?.isReady() ?? true,
-    () => accountQueryPersistence?.isReady() ?? true,
+    accountQueryPersistence.subscribe,
+    accountQueryPersistence.isReady,
+    accountQueryPersistence.isReady,
   );
 
   const storageRef = useRef<StorageInterface | null>(null);
@@ -409,7 +406,7 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
       .then((storageInstance) => {
         storageRef.current = storageInstance;
         storageReady.resolve(storageInstance);
-        accountQueryPersistence?.setStorage(storageInstance);
+        accountQueryPersistence.setStorage(storageInstance);
         if (mounted) {
           setStorage(storageInstance);
           runtime.setStorageReady(true);
@@ -418,7 +415,7 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
       .catch((err) => {
         // Nothing persisted can be restored; the account cache still has to
         // become ready, or RequireOxyAuth would wait forever.
-        accountQueryPersistence?.setStorage(createMemoryStorage());
+        accountQueryPersistence.setStorage(createMemoryStorage());
         if (mounted) {
           logger('Failed to initialize storage', err);
           onError?.({
@@ -1378,9 +1375,20 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
       runtime.setAccount(cached.user);
     });
     onAuthStateChangeRef.current?.(cached.user);
+    // The account's cached queries are part of this paint: one local read,
+    // started by the subject change above, so nothing renders without them.
+    await accountQueryPersistence.whenReady();
     markAuthResolvedRef.current();
     return true;
-  }, [identity, clientIdProp, authStore, oxyServices, runtime, syncDeviceCredentialToHost]);
+  }, [
+    identity,
+    clientIdProp,
+    authStore,
+    oxyServices,
+    runtime,
+    syncDeviceCredentialToHost,
+    accountQueryPersistence,
+  ]);
 
   // A painted session the server could not be asked about yet stays on screen
   // and is asked again: on the lost-token backoff, and at once when the device
@@ -1687,7 +1695,7 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
     ({ previous, next }: SubjectTransition): void => {
       // Every transition, the first sign-in included: the account cache is
       // keyed by the subject, and a sign-out deletes the signed-out one's.
-      accountQueryPersistence?.activate(next);
+      accountQueryPersistence.activate(next);
       if (previous === null) {
         return;
       }

package/src/ui/hooks/accountQueryPersistence.ts

@@ -4,7 +4,9 @@
  * The SDK's own persister (`attachQueryPersistence`) keeps account-agnostic
  * data. An app's mail, library or drafts belong to one account, and every app
  * that wanted them to survive a restart had to scope a persister to the session
- * itself. The SDK owns the session, so it owns this too:
+ * itself. The SDK owns the session, so it owns this too, for every root an app
+ * declares (`accountQueries`) and for any single query marked
+ * `meta: { persist: 'account' }`, with no declaration at all:
  *
  * - Storage is keyed by the account (`oxy_account_queries:<accountId>`), so a
  *   restore can only ever hydrate the account that is signed in.
@@ -15,7 +17,9 @@
  *   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.
+ *   `RequireOxyAuth` waits on it, so another account's rows never render. A
+ *   cold boot that paints a cached session waits on it too (`whenReady()`), so
+ *   the first paint already has the account's rows.
  *
  * 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.
@@ -39,12 +43,29 @@ import {
   type PersistFilters,
 } from './persistedQueryCache';
 
+/**
+ * The `meta` that makes one query the signed-in account's and keeps it across
+ * restarts, exactly like a query under a declared root: for the few reads that
+ * shape a returning user's first paint (the tabs, the theme), not for lists.
+ *
+ * `useQuery({ queryKey, queryFn, meta: { persist: 'account' } })`
+ */
+export interface AccountQueryMeta {
+  persist: 'account';
+}
+
+function isAccountQuery(query: Query): boolean {
+  return (query.meta as Partial<AccountQueryMeta> | undefined)?.persist === 'account';
+}
+
 /** 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. `'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.
+   * Every root's queries are written on every change to any of them: for one
+   * or two queries under a busy root, mark those instead (`AccountQueryMeta`).
    *
    * 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
@@ -75,13 +96,19 @@ export interface AccountQueryOwnership {
 /** SDK roots that hold device-level data, the same whoever is signed in. */
 const DEVICE_ROOTS = new Set(['accounts', 'sessions', 'devices']);
 
-export function accountQueryOwnership(config: AccountQueriesConfig): AccountQueryOwnership {
+/** No declared roots: only the queries marked `AccountQueryMeta` are the account's. */
+const NO_ROOTS: AccountQueriesConfig = { roots: [] };
+
+export function accountQueryOwnership(
+  config: AccountQueriesConfig = NO_ROOTS,
+): AccountQueryOwnership {
   const memoryOnly = new Set([...(config.memoryOnlyRoots ?? []), ...SDK_MEMORY_ONLY_ROOTS]);
   const sdkRoots = new Set(PERSISTED_QUERY_PREFIXES);
   const declared = config.roots === 'all' ? null : new Set(config.roots);
   const mutationHashes = new Set((config.mutationKeys ?? []).map((key) => hashKey(key)));
 
   const ownsQuery = (query: Query): boolean => {
+    if (isAccountQuery(query)) return true;
     const root = rootOf(query);
     if (root !== null && memoryOnly.has(root)) return true;
     if (declared === null) return root === null || !DEVICE_ROOTS.has(root);
@@ -94,7 +121,9 @@ export function accountQueryOwnership(config: AccountQueriesConfig): AccountQuer
       const root = rootOf(query);
       if (root === null) return true;
       // The SDK's own roots stay with the SDK persister.
-      return !memoryOnly.has(root) && (declared !== null || !sdkRoots.has(root));
+      return (
+        !memoryOnly.has(root) && (isAccountQuery(query) || declared !== null || !sdkRoots.has(root))
+      );
     },
     ownsMutation: (mutation) => {
       const key = mutation.options.mutationKey;
@@ -118,6 +147,8 @@ export interface AccountQueryPersistence {
   detach(): void;
   /** True once the active account's cache is restored (always true signed out). */
   isReady(): boolean;
+  /** Resolves once `isReady()`, or once the account it waited for is left. */
+  whenReady(): Promise<void>;
   subscribe(listener: () => void): () => void;
 }
 
@@ -127,11 +158,11 @@ function storageKeyFor(accountId: string): string {
 
 export function createAccountQueryPersistence(
   queryClient: QueryClient,
-  config: AccountQueriesConfig,
+  config?: AccountQueriesConfig,
 ): AccountQueryPersistence {
   const { ownsQuery, persistsQuery, ownsMutation } = accountQueryOwnership(config);
   const filters: PersistFilters = {
-    shouldDehydrateQuery: (query) => query.state.status === 'success' && persistsQuery(query),
+    persistsQuery,
     shouldDehydrateMutation: (mutation) => mutation.state.isPaused && ownsMutation(mutation),
   };
   const listeners = new Set<() => void>();
@@ -159,6 +190,13 @@ export function createAccountQueryPersistence(
   const notify = () => {
     for (const listener of listeners) listener();
   };
+  const subscribe = (listener: () => void) => {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  };
+  const isReady = () => accountId === null || restoredFor === accountId;
 
   const dropScopedData = () => {
     queryClient.removeQueries({ predicate: ownsQuery });
@@ -179,11 +217,12 @@ export function createAccountQueryPersistence(
     const current = generation;
     const key = storageKeyFor(id);
     enqueue(async (storage) => {
-      const raw = await storage.getItem(key);
+      // An unreadable blob restores nothing; it must not leave the account unready.
+      const raw = await storage.getItem(key).catch(() => null);
       // Same tick as the hydrate: a switch in between cannot be missed.
       if (current !== generation) return;
       if (!hydrateSnapshot(queryClient, raw, ACCOUNT_QUERY_CACHE_MAX_AGE) && raw) {
-        await storage.removeItem(key);
+        await storage.removeItem(key).catch(() => undefined);
         if (current !== generation) return;
       }
       restoredFor = id;
@@ -245,15 +284,21 @@ export function createAccountQueryPersistence(
       restoredFor = null;
     },
 
-    isReady() {
-      return accountId === null || restoredFor === accountId;
-    },
+    isReady,
 
-    subscribe(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
+    whenReady() {
+      const waitingFor = generation;
+      const settled = () => isReady() || generation !== waitingFor;
+      if (settled()) return Promise.resolve();
+      return new Promise((resolve) => {
+        const off = subscribe(() => {
+          if (!settled()) return;
+          off();
+          resolve();
+        });
+      });
     },
+
+    subscribe,
   };
 }

package/src/ui/hooks/persistedQueryCache.ts

@@ -44,7 +44,8 @@ export const SDK_MEMORY_ONLY_ROOTS: ReadonlyArray<string> = [
 ];
 
 export interface PersistFilters {
-  shouldDehydrateQuery: (query: Query) => boolean;
+  /** The queries this cache keeps, whatever their state; only successful ones are written. */
+  persistsQuery: (query: Query) => boolean;
   shouldDehydrateMutation: (mutation: Mutation) => boolean;
 }
 
@@ -64,7 +65,11 @@ export function snapshot(queryClient: QueryClient, filters: PersistFilters): str
   const blob: PersistedBlob = {
     buster: getOxyBuildId(),
     timestamp: Date.now(),
-    clientState: dehydrate(queryClient, filters),
+    clientState: dehydrate(queryClient, {
+      shouldDehydrateQuery: (query) =>
+        query.state.status === 'success' && filters.persistsQuery(query),
+      shouldDehydrateMutation: filters.shouldDehydrateMutation,
+    }),
   };
   return JSON.stringify(blob);
 }
@@ -102,8 +107,9 @@ export function hydrateSnapshot(
 }
 
 /**
- * Write the filtered cache on every change, at most once per `throttleMs`.
- * `write` receives the serialized snapshot; `flush()` writes now.
+ * Write the filtered cache whenever one of its queries or any mutation changes,
+ * at most once per `throttleMs`. Activity in queries it does not keep (feeds,
+ * search) never serializes it. `write` receives the snapshot; `flush()` writes now.
  */
 export function subscribeSnapshots(
   queryClient: QueryClient,
@@ -120,7 +126,9 @@ export function subscribeSnapshots(
   const schedule = () => {
     if (!timer) timer = setTimeout(flush, throttleMs);
   };
-  const offQueries = queryClient.getQueryCache().subscribe(schedule);
+  const offQueries = queryClient.getQueryCache().subscribe((event) => {
+    if (filters.persistsQuery(event.query)) schedule();
+  });
   const offMutations = queryClient.getMutationCache().subscribe(schedule);
   return {
     flush,

package/src/ui/hooks/queryClient.ts

@@ -21,7 +21,7 @@
  *   (`persistedQueryCache.ts`) when introducing reads that should survive restart.
  */
 
-import { QueryClient, onlineManager, type Mutation, type Query } from '@tanstack/react-query';
+import { QueryClient, onlineManager, type Query } from '@tanstack/react-query';
 import type { PersistedClient } from '@tanstack/react-query-persist-client';
 import { isDev } from '@oxy.so/core';
 import type { StorageInterface } from '../utils/storageHelpers';
@@ -30,6 +30,7 @@ import {
   PERSISTED_QUERY_PREFIXES,
   hydrateSnapshot,
   subscribeSnapshots,
+  type PersistFilters,
 } from './persistedQueryCache';
 
 const QUERY_CACHE_KEY = 'oxy_query_cache_v3';
@@ -53,15 +54,8 @@ export function shouldRetryQuery(failureCount: number, error: unknown): boolean
   return status === 408 || status === 425 || status === 429 || status >= 500;
 }
 
-/**
- * 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.
- */
+/** Whether a query is under one of the SDK's own account-agnostic prefixes. */
 function isSharedQuery(query: Query): boolean {
-  if (query.state.status !== 'success') {
-    return false;
-  }
   const head = query.queryKey[0];
   return typeof head === 'string' && PERSISTED_QUERY_PREFIXES.includes(head);
 }
@@ -135,10 +129,11 @@ export interface AttachPersistenceResult {
  * Restore, then keep writing, the account-agnostic cache.
  *
  * 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.
+ * (`persistedQueryCache.ts`). Whatever belongs to the account (`accountQueries`,
+ * or a query marked `meta: { persist: 'account' }`) 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).
@@ -155,13 +150,12 @@ export const attachQueryPersistence = (
     };
   }
 
-  const account = accountQueries ? accountQueryOwnership(accountQueries) : null;
-  const filters = {
-    shouldDehydrateQuery: (query: Query) =>
-      isSharedQuery(query) && !(account?.ownsQuery(query) ?? false),
+  const account = accountQueryOwnership(accountQueries);
+  const filters: PersistFilters = {
+    persistsQuery: (query) => isSharedQuery(query) && !account.ownsQuery(query),
     // Every other mutation, whatever its status: paused ones are exactly the
     // ones that must survive a restart to replay when online.
-    shouldDehydrateMutation: (mutation: Mutation) => !(account?.ownsMutation(mutation) ?? false),
+    shouldDehydrateMutation: (mutation) => !account.ownsMutation(mutation),
   };
 
   let stopped = false;

package/src/ui/index.ts

@@ -34,7 +34,7 @@ export { LogoText } from './components/logo/LogoText';
 export { RequireOxyAuth } from './components/RequireOxyAuth';
 export type { RequireOxyAuthProps, RequireOxyAuthPrompt } from './components/RequireOxyAuth';
 // `OxyProvider`'s `accountQueries`: the app's per-account offline cache.
-export type { AccountQueriesConfig } from './hooks/accountQueryPersistence';
+export type { AccountQueriesConfig, AccountQueryMeta } from './hooks/accountQueryPersistence';
 export { default as FollowButton } from './components/FollowButton';
 export { default as PeableButton } from './components/PeableButton';
 export type { PeableButtonProps } from './components/PeableButton';

package/src/ui/types/navigation.ts

@@ -150,6 +150,8 @@ export interface OxyProviderProps {
    * account switch and deleted on sign-out. `RequireOxyAuth` waits for the
    * signed-in account's cache to restore, so another account's rows never
    * render. Works with the SDK's client or one passed as `queryClient`.
+   * A single query opts in with `meta: { persist: 'account' }` and needs no
+   * declaration here (`AccountQueryMeta`).
    */
   accountQueries?: AccountQueriesConfig;
   /**