@oxy.so/services 13.2.0 → 13.3.0

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

@@ -1,63 +1,83 @@
 "use strict";
 
 import { useEffect, useState } from 'react';
+import { useOptionalOxy } from "../context/oxyRuntimeContext.js";
+function isAbsoluteUrl(ref) {
+  return ref.startsWith('http://') || ref.startsWith('https://');
+}
+
 /**
- * Hook to resolve a file's download URL asynchronously.
+ * Resolve a file's download URL for the current caller.
+ *
+ * A URL `assets.url` already resolved is answered in the FIRST render from
+ * core's identity-scoped cache (`assets.cachedUrl`): no request, no loading
+ * frame. Only a miss resolves asynchronously, through `assets.url`, which
+ * returns a scoped media-token stream URL for a private asset. There is no
+ * public-CDN fallback: `assets.publicUrl` 404s for private uploads. A
+ * reference that is already an absolute `http(s)` URL is returned unchanged.
  *
- * Uses `getFileDownloadUrlAsync`, which returns a scoped media-token stream URL
- * for private assets. There is no sync CDN fallback — the synchronous
- * `getFileDownloadUrl` is public-CDN-only and 404s for private uploads.
+ * For a synchronous, render-only answer (an image resolver, a list row) use
+ * `oxyServices.assets.renderUrl`, which reads the same cache.
  */
 export const useFileDownloadUrl = (oxyServices, fileId, options) => {
-  const [url, setUrl] = useState(null);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
   const variant = options?.variant;
   const expiresIn = options?.expiresIn;
+  // A resolved URL can carry the viewer's scoped media token, so the viewer is
+  // part of what was asked: an account switch never shows the previous one's.
+  const viewerId = useOptionalOxy()?.user?.id ?? '';
+  const request = fileId ? `${viewerId}|${fileId}|${variant ?? ''}|${expiresIn ?? ''}` : null;
+  const immediate = !fileId ? null : isAbsoluteUrl(fileId) ? fileId : oxyServices?.assets.cachedUrl(fileId, variant, expiresIn) ?? null;
+  const needsResolve = !!fileId && !!oxyServices && immediate === null;
+  const [settled, setSettled] = useState(null);
   useEffect(() => {
-    if (!fileId) {
-      setUrl(null);
-      setLoading(false);
-      setError(null);
-      return;
-    }
-    if (!oxyServices) {
-      setUrl(null);
-      setLoading(false);
-      setError(new Error('OxyServices instance not configured for useFileDownloadUrl'));
-      return;
-    }
+    if (!needsResolve || !fileId || !oxyServices || !request) return;
     let cancelled = false;
-    const instance = oxyServices;
-    const targetFileId = fileId;
-    const load = async () => {
-      setLoading(true);
-      setError(null);
-      try {
-        const resolvedUrl = await instance.assets.url(targetFileId, variant, expiresIn);
-        if (!cancelled) {
-          setUrl(resolvedUrl || null);
-        }
-      } catch (err) {
-        if (!cancelled) {
-          setUrl(null);
-          setError(err instanceof Error ? err : new Error(String(err)));
-        }
-      } finally {
-        if (!cancelled) {
-          setLoading(false);
-        }
+    oxyServices.assets.url(fileId, variant, expiresIn).then(url => {
+      if (!cancelled) setSettled({
+        request,
+        url: url || null,
+        error: null
+      });
+    }, err => {
+      if (!cancelled) {
+        setSettled({
+          request,
+          url: null,
+          error: err instanceof Error ? err : new Error(String(err))
+        });
       }
-    };
-    load();
+    });
     return () => {
       cancelled = true;
     };
-  }, [fileId, oxyServices, variant, expiresIn]);
+  }, [needsResolve, fileId, oxyServices, variant, expiresIn, request]);
+  if (!fileId) return {
+    url: null,
+    loading: false,
+    error: null
+  };
+  if (immediate !== null) return {
+    url: immediate,
+    loading: false,
+    error: null
+  };
+  if (!oxyServices) {
+    return {
+      url: null,
+      loading: false,
+      error: new Error('OxyServices instance not configured for useFileDownloadUrl')
+    };
+  }
+  // A result settled for another file, variant or expiry is never shown.
+  if (settled?.request !== request) return {
+    url: null,
+    loading: true,
+    error: null
+  };
   return {
-    url,
-    loading,
-    error
+    url: settled.url,
+    loading: false,
+    error: settled.error
   };
 };
 //# sourceMappingURL=useFileDownloadUrl.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useState","useFileDownloadUrl","oxyServices","fileId","options","url","setUrl","loading","setLoading","error","setError","variant","expiresIn","Error","cancelled","instance","targetFileId","load","resolvedUrl","assets","err","String"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFileDownloadUrl.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAc3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,GAAGA,CAChCC,WAA2C,EAC3CC,MAAiC,EACjCC,OAAmC,KACN;EAC7B,MAAM,CAACC,GAAG,EAAEC,MAAM,CAAC,GAAGN,QAAQ,CAAgB,IAAI,CAAC;EACnD,MAAM,CAACO,OAAO,EAAEC,UAAU,CAAC,GAAGR,QAAQ,CAAC,KAAK,CAAC;EAC7C,MAAM,CAACS,KAAK,EAAEC,QAAQ,CAAC,GAAGV,QAAQ,CAAe,IAAI,CAAC;EAEtD,MAAMW,OAAO,GAAGP,OAAO,EAAEO,OAAO;EAChC,MAAMC,SAAS,GAAGR,OAAO,EAAEQ,SAAS;EAEpCb,SAAS,CAAC,MAAM;IACd,IAAI,CAACI,MAAM,EAAE;MACXG,MAAM,CAAC,IAAI,CAAC;MACZE,UAAU,CAAC,KAAK,CAAC;MACjBE,QAAQ,CAAC,IAAI,CAAC;MACd;IACF;IAEA,IAAI,CAACR,WAAW,EAAE;MAChBI,MAAM,CAAC,IAAI,CAAC;MACZE,UAAU,CAAC,KAAK,CAAC;MACjBE,QAAQ,CAAC,IAAIG,KAAK,CAAC,4DAA4D,CAAC,CAAC;MACjF;IACF;IAEA,IAAIC,SAAS,GAAG,KAAK;IACrB,MAAMC,QAAQ,GAAGb,WAAW;IAC5B,MAAMc,YAAY,GAAGb,MAAM;IAE3B,MAAMc,IAAI,GAAG,MAAAA,CAAA,KAAY;MACvBT,UAAU,CAAC,IAAI,CAAC;MAChBE,QAAQ,CAAC,IAAI,CAAC;MAEd,IAAI;QACF,MAAMQ,WAAW,GAAG,MAAMH,QAAQ,CAACI,MAAM,CAACd,GAAG,CAACW,YAAY,EAAEL,OAAO,EAAEC,SAAS,CAAC;QAE/E,IAAI,CAACE,SAAS,EAAE;UACdR,MAAM,CAACY,WAAW,IAAI,IAAI,CAAC;QAC7B;MACF,CAAC,CAAC,OAAOE,GAAY,EAAE;QACrB,IAAI,CAACN,SAAS,EAAE;UACdR,MAAM,CAAC,IAAI,CAAC;UACZI,QAAQ,CAACU,GAAG,YAAYP,KAAK,GAAGO,GAAG,GAAG,IAAIP,KAAK,CAACQ,MAAM,CAACD,GAAG,CAAC,CAAC,CAAC;QAC/D;MACF,CAAC,SAAS;QACR,IAAI,CAACN,SAAS,EAAE;UACdN,UAAU,CAAC,KAAK,CAAC;QACnB;MACF;IACF,CAAC;IAEDS,IAAI,CAAC,CAAC;IAEN,OAAO,MAAM;MACXH,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CAACX,MAAM,EAAED,WAAW,EAAES,OAAO,EAAEC,SAAS,CAAC,CAAC;EAE7C,OAAO;IAAEP,GAAG;IAAEE,OAAO;IAAEE;EAAM,CAAC;AAChC,CAAC","ignoreList":[]}
+{"version":3,"names":["useEffect","useState","useOptionalOxy","isAbsoluteUrl","ref","startsWith","useFileDownloadUrl","oxyServices","fileId","options","variant","expiresIn","viewerId","user","id","request","immediate","assets","cachedUrl","needsResolve","settled","setSettled","cancelled","url","then","error","err","Error","String","loading"],"sourceRoot":"../../../../src","sources":["ui/hooks/useFileDownloadUrl.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/ui/client.d.ts

@@ -36,6 +36,8 @@ export type { OxyPayButtonProps } from './components/OxyPayButton';
 export { useOxy, useOptionalOxy, OxyProviderMissingError } from './context/OxyContext';
 export { useAuth } from './hooks/useAuth';
 export { useAccountColor, useAccountColorSave, resolveAccountColor, entitledAccountColors, } from './hooks/useAccountColor';
+export { useAccountTheme, useAccountThemeControls } from './hooks/useAccountTheme';
+export type { AccountThemeControls, ThemeSource } from './hooks/useAccountTheme';
 export { useAppAssertion, AppAssertionProviderMissingError, } from './appAssertion/AppAssertionContext';
 export type { UseAppAssertionResult } from './appAssertion/AppAssertionContext';
 export type { AppAssertionSnapshot, AppAssertionStatus } from './appAssertion/appAssertionManager';

package/lib/typescript/commonjs/ui/client.d.ts.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * useAccountTheme / useAccountThemeControls
+ *
+ * The Oxy account carries a portable theme (`user.themePreference`: a mode and
+ * a colour preset) that every Oxy app can wear. The COLOUR is the account
+ * colour and always applies (`useAccountColor`). Whether an app also follows
+ * the account's MODE is the viewer's choice per device: the theme SOURCE.
+ *
+ * - `account` (the default): the account's mode is applied to Bloom, and a mode
+ *   chosen here is written back to the account for the other Oxy apps.
+ * - `app`: the mode stays on this device; nothing is written to the account.
+ *
+ * The source is a local preference, never sent anywhere. On web it is read
+ * synchronously, so the first paint already knows it; on native it resolves
+ * from AsyncStorage right after mount. Bloom's own persistence still paints the
+ * last theme instantly on cold boot, so the account theme lands without a flash
+ * once the session resolves.
+ */
+import { type AppColorName, type ThemeMode } from '@oxy.so/bloom/theme';
+/** Where the app's theme MODE comes from on this device. */
+export type ThemeSource = 'app' | 'account';
+/**
+ * Apply the account theme to Bloom: the colour always (through
+ * `useAccountColor`, which `canUse` can narrow), the mode while this device's
+ * source is `account`. Mount ONCE, inside `OxyProvider` and Bloom's theme
+ * provider.
+ */
+export declare function useAccountTheme({ canUse, }?: {
+    canUse?: (name: AppColorName) => boolean;
+}): void;
+export interface AccountThemeControls {
+    /** The effective source: `app` whenever no session can reach the account. */
+    source: ThemeSource;
+    /** Switch this device's source; enabling `account` seeds an account with no theme yet. */
+    changeThemeSource: (source: ThemeSource) => void;
+    /** Change the mode now; on the `account` source, also write it to the account. */
+    changeThemeMode: (mode: ThemeMode) => Promise<void>;
+}
+/**
+ * Source-aware theme mode changes for a settings screen. Bloom changes at once;
+ * on the `account` source the account's portable theme follows. Without a
+ * usable session the effective source is `app`, so changes stay local, and the
+ * stored choice applies again once signed in. The colour is chosen with
+ * `useAccountColorSave`.
+ */
+export declare function useAccountThemeControls(): AccountThemeControls;
+//# sourceMappingURL=useAccountTheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountTheme.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAccountTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMvF,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AA4D5C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;CACrC,GAAG,IAAI,CAiBZ;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAC;IACpB,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,kFAAkF;IAClF,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CA0C9D"}

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

@@ -9,11 +9,17 @@ export interface UseFileDownloadUrlResult {
     error: Error | null;
 }
 /**
- * Hook to resolve a file's download URL asynchronously.
+ * Resolve a file's download URL for the current caller.
  *
- * Uses `getFileDownloadUrlAsync`, which returns a scoped media-token stream URL
- * for private assets. There is no sync CDN fallback — the synchronous
- * `getFileDownloadUrl` is public-CDN-only and 404s for private uploads.
+ * A URL `assets.url` already resolved is answered in the FIRST render from
+ * core's identity-scoped cache (`assets.cachedUrl`): no request, no loading
+ * frame. Only a miss resolves asynchronously, through `assets.url`, which
+ * returns a scoped media-token stream URL for a private asset. There is no
+ * public-CDN fallback: `assets.publicUrl` 404s for private uploads. A
+ * reference that is already an absolute `http(s)` URL is returned unchanged.
+ *
+ * For a synchronous, render-only answer (an image resolver, a list row) use
+ * `oxyServices.assets.renderUrl`, which reads the same cache.
  */
 export declare const useFileDownloadUrl: (oxyServices: OxyServices | null | undefined, fileId: string | null | undefined, options?: UseFileDownloadUrlOptions) => UseFileDownloadUrlResult;
 //# sourceMappingURL=useFileDownloadUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useFileDownloadUrl.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFileDownloadUrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,yBAAyB,KAClC,wBAyDF,CAAC"}
+{"version":3,"file":"useFileDownloadUrl.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFileDownloadUrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAYD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,yBAAyB,KAClC,wBAkDF,CAAC"}

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

@@ -36,6 +36,8 @@ export type { OxyPayButtonProps } from './components/OxyPayButton.js';
 export { useOxy, useOptionalOxy, OxyProviderMissingError } from './context/OxyContext.js';
 export { useAuth } from './hooks/useAuth.js';
 export { useAccountColor, useAccountColorSave, resolveAccountColor, entitledAccountColors, } from './hooks/useAccountColor.js';
+export { useAccountTheme, useAccountThemeControls } from './hooks/useAccountTheme.js';
+export type { AccountThemeControls, ThemeSource } from './hooks/useAccountTheme.js';
 export { useAppAssertion, AppAssertionProviderMissingError, } from './appAssertion/AppAssertionContext.js';
 export type { UseAppAssertionResult } from './appAssertion/AppAssertionContext.js';
 export type { AppAssertionSnapshot, AppAssertionStatus } from './appAssertion/appAssertionManager.js';

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * useAccountTheme / useAccountThemeControls
+ *
+ * The Oxy account carries a portable theme (`user.themePreference`: a mode and
+ * a colour preset) that every Oxy app can wear. The COLOUR is the account
+ * colour and always applies (`useAccountColor`). Whether an app also follows
+ * the account's MODE is the viewer's choice per device: the theme SOURCE.
+ *
+ * - `account` (the default): the account's mode is applied to Bloom, and a mode
+ *   chosen here is written back to the account for the other Oxy apps.
+ * - `app`: the mode stays on this device; nothing is written to the account.
+ *
+ * The source is a local preference, never sent anywhere. On web it is read
+ * synchronously, so the first paint already knows it; on native it resolves
+ * from AsyncStorage right after mount. Bloom's own persistence still paints the
+ * last theme instantly on cold boot, so the account theme lands without a flash
+ * once the session resolves.
+ */
+import { type AppColorName, type ThemeMode } from '@oxy.so/bloom/theme';
+/** Where the app's theme MODE comes from on this device. */
+export type ThemeSource = 'app' | 'account';
+/**
+ * Apply the account theme to Bloom: the colour always (through
+ * `useAccountColor`, which `canUse` can narrow), the mode while this device's
+ * source is `account`. Mount ONCE, inside `OxyProvider` and Bloom's theme
+ * provider.
+ */
+export declare function useAccountTheme({ canUse, }?: {
+    canUse?: (name: AppColorName) => boolean;
+}): void;
+export interface AccountThemeControls {
+    /** The effective source: `app` whenever no session can reach the account. */
+    source: ThemeSource;
+    /** Switch this device's source; enabling `account` seeds an account with no theme yet. */
+    changeThemeSource: (source: ThemeSource) => void;
+    /** Change the mode now; on the `account` source, also write it to the account. */
+    changeThemeMode: (mode: ThemeMode) => Promise<void>;
+}
+/**
+ * Source-aware theme mode changes for a settings screen. Bloom changes at once;
+ * on the `account` source the account's portable theme follows. Without a
+ * usable session the effective source is `app`, so changes stay local, and the
+ * stored choice applies again once signed in. The colour is chosen with
+ * `useAccountColorSave`.
+ */
+export declare function useAccountThemeControls(): AccountThemeControls;
+//# sourceMappingURL=useAccountTheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountTheme.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAccountTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMvF,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AA4D5C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;CACrC,GAAG,IAAI,CAiBZ;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAC;IACpB,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,kFAAkF;IAClF,eAAe,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CA0C9D"}

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

@@ -9,11 +9,17 @@ export interface UseFileDownloadUrlResult {
     error: Error | null;
 }
 /**
- * Hook to resolve a file's download URL asynchronously.
+ * Resolve a file's download URL for the current caller.
  *
- * Uses `getFileDownloadUrlAsync`, which returns a scoped media-token stream URL
- * for private assets. There is no sync CDN fallback — the synchronous
- * `getFileDownloadUrl` is public-CDN-only and 404s for private uploads.
+ * A URL `assets.url` already resolved is answered in the FIRST render from
+ * core's identity-scoped cache (`assets.cachedUrl`): no request, no loading
+ * frame. Only a miss resolves asynchronously, through `assets.url`, which
+ * returns a scoped media-token stream URL for a private asset. There is no
+ * public-CDN fallback: `assets.publicUrl` 404s for private uploads. A
+ * reference that is already an absolute `http(s)` URL is returned unchanged.
+ *
+ * For a synchronous, render-only answer (an image resolver, a list row) use
+ * `oxyServices.assets.renderUrl`, which reads the same cache.
  */
 export declare const useFileDownloadUrl: (oxyServices: OxyServices | null | undefined, fileId: string | null | undefined, options?: UseFileDownloadUrlOptions) => UseFileDownloadUrlResult;
 //# sourceMappingURL=useFileDownloadUrl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useFileDownloadUrl.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFileDownloadUrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,yBAAyB,KAClC,wBAyDF,CAAC"}
+{"version":3,"file":"useFileDownloadUrl.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useFileDownloadUrl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAYD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,UAAU,yBAAyB,KAClC,wBAkDF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "13.2.0",
+  "version": "13.3.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -160,7 +160,7 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@expo/app-integrity": "~58.0.2",
     "@expo/vector-icons": "^15.0.3",
-    "@oxy.so/core": "7.1.0",
+    "@oxy.so/core": "7.2.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^12.0.1",
     "@react-native/babel-preset": "^0.88.0",
@@ -209,13 +209,13 @@
     "expo-video": "~58.0.12"
   },
   "//@oxy.so/bloom": "Bloom 11.1.0 adds the shared grouped sections, usage card, subscription plans, frame appearance and overlay navigation APIs used by this SDK. First-party Bloom peers remain open above this tested minimum.",
-  "//@oxy.so/core": "Core 6.16.0 supplies `requireServerVerdict` and `onHolderRejected`, with which the cold boot checks a session it painted from the cache; 6.13.0 supplies the `accounts.settings.*` strings (picture, categories) the account settings speak in every language; 6.12.0 supplies `fileManagement.contentLost` and the `lost` file status a lost file is listed with; 6.11.0 supplies the `follow.errors.*` strings the follow error codes are worded with; 6.4.0 the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
+  "//@oxy.so/core": "Core 7.2.0 supplies `assets.cachedUrl`, with which `useFileDownloadUrl` answers an already-resolved URL in its first render; 6.16.0 supplies `requireServerVerdict` and `onHolderRejected`, with which the cold boot checks a session it painted from the cache; 6.13.0 supplies the `accounts.settings.*` strings (picture, categories) the account settings speak in every language; 6.12.0 supplies `fileManagement.contentLost` and the `lost` file status a lost file is listed with; 6.11.0 supplies the `follow.errors.*` strings the follow error codes are worded with; 6.4.0 the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
   "//react-native": "React Native 0.81 to 0.88, React 19.1+ and Expo SDK 54 to 58. The floors are the Expo SDK 54 stack (react-native 0.81.6, react 19.1.4, react-native-web 0.21.4, expo 54.0.38 and the module versions its bundledNativeModules.json pins), which compat/expo-54 installs as an external consumer and checks on every CI run (`bun check.mjs`): every peer here admits that stack, services' published src typechecks against its types, and <OxyProvider> mounts and settles its cold boot on iOS (React Native 0.81), web (react-native-web 0.21) and react-native-macos 0.81 with the native modules macOS lacks absent. Astro, Oxy's browser, runs react-native-macos 0.81 (0.83 is its latest release), which is why the floor is not 0.85. The SDK 56 floors these replaced were the versions current when the ranges were first written, not measurements.",
   "peerDependencies": {
     "@expo/app-integrity": ">=0.1.10 <59.0.0",
     "@expo/vector-icons": "^15.0.3",
     "@oxy.so/bloom": ">=11.1.0",
-    "@oxy.so/core": "^7.0.0",
+    "@oxy.so/core": "^7.2.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": ">=11.4.1 <13.0.0",
     "@tanstack/query-async-storage-persister": "^5.101",

package/src/ui/client.ts

@@ -53,6 +53,8 @@ export {
   resolveAccountColor,
   entitledAccountColors,
 } from './hooks/useAccountColor';
+export { useAccountTheme, useAccountThemeControls } from './hooks/useAccountTheme';
+export type { AccountThemeControls, ThemeSource } from './hooks/useAccountTheme';
 // This app's Oxy-signed assertion of which app it is (ADR 0045), for an SDK
 // that attaches it to its own requests without pulling in the account screens.
 export {

package/src/ui/hooks/useAccountTheme.ts

@@ -0,0 +1,177 @@
+/**
+ * useAccountTheme / useAccountThemeControls
+ *
+ * The Oxy account carries a portable theme (`user.themePreference`: a mode and
+ * a colour preset) that every Oxy app can wear. The COLOUR is the account
+ * colour and always applies (`useAccountColor`). Whether an app also follows
+ * the account's MODE is the viewer's choice per device: the theme SOURCE.
+ *
+ * - `account` (the default): the account's mode is applied to Bloom, and a mode
+ *   chosen here is written back to the account for the other Oxy apps.
+ * - `app`: the mode stays on this device; nothing is written to the account.
+ *
+ * The source is a local preference, never sent anywhere. On web it is read
+ * synchronously, so the first paint already knows it; on native it resolves
+ * from AsyncStorage right after mount. Bloom's own persistence still paints the
+ * last theme instantly on cold boot, so the account theme lands without a flash
+ * once the session resolves.
+ */
+
+import { useCallback, useEffect } from 'react';
+import { create } from 'zustand';
+import { logger, type User } from '@oxy.so/core';
+import { useBloomTheme, type AppColorName, type ThemeMode } from '@oxy.so/bloom/theme';
+import { createPlatformStorage, isReactNative } from '../utils/storageHelpers';
+import { resolveAccountColor, useAccountColor } from './useAccountColor';
+import { useAuth } from './useAuth';
+import { useUpdateProfile } from './mutations/useAccountMutations';
+
+/** Where the app's theme MODE comes from on this device. */
+export type ThemeSource = 'app' | 'account';
+
+type PortableThemeMode = NonNullable<User['themePreference']>['mode'];
+
+const THEME_SOURCE_KEY = 'oxy.theme.source';
+
+function normalizeSource(stored: string | null | undefined): ThemeSource {
+  return stored === 'app' ? 'app' : 'account';
+}
+
+/**
+ * Bloom's richer mode set onto the portable subset the account stores
+ * (`adaptive` has no cross-app meaning, so it is `system`).
+ */
+function toPortableMode(mode: ThemeMode): PortableThemeMode {
+  return mode === 'light' || mode === 'dark' ? mode : 'system';
+}
+
+/** Web reads `localStorage` synchronously; native resolves in `hydrate`. */
+function readInitialSource(): { source: ThemeSource; hydrated: boolean } {
+  if (isReactNative() || typeof window === 'undefined') {
+    return { source: 'account', hydrated: false };
+  }
+  try {
+    return {
+      source: normalizeSource(window.localStorage?.getItem(THEME_SOURCE_KEY)),
+      hydrated: true,
+    };
+  } catch {
+    // A sandboxed document's storage getter throws: no stored choice.
+    return { source: 'account', hydrated: true };
+  }
+}
+
+interface ThemeSourceState {
+  source: ThemeSource;
+  /** True once the stored source is known (at once on web). */
+  hydrated: boolean;
+  setSource: (source: ThemeSource) => void;
+  hydrate: () => Promise<void>;
+}
+
+const useThemeSourceStore = create<ThemeSourceState>((set, get) => ({
+  ...readInitialSource(),
+  setSource(source) {
+    set({ source, hydrated: true });
+    void createPlatformStorage()
+      .then((storage) => storage.setItem(THEME_SOURCE_KEY, source))
+      .catch(() => undefined);
+  },
+  async hydrate() {
+    if (get().hydrated) return;
+    const stored = await createPlatformStorage()
+      .then((storage) => storage.getItem(THEME_SOURCE_KEY))
+      .catch(() => null);
+    // A choice made while storage was being read wins over the stored one.
+    if (!get().hydrated) set({ source: normalizeSource(stored), hydrated: true });
+  },
+}));
+
+/**
+ * Apply the account theme to Bloom: the colour always (through
+ * `useAccountColor`, which `canUse` can narrow), the mode while this device's
+ * source is `account`. Mount ONCE, inside `OxyProvider` and Bloom's theme
+ * provider.
+ */
+export function useAccountTheme({
+  canUse,
+}: {
+  canUse?: (name: AppColorName) => boolean;
+} = {}): void {
+  const { isAuthenticated, user } = useAuth();
+  const source = useThemeSourceStore((state) => state.source);
+  const hydrated = useThemeSourceStore((state) => state.hydrated);
+  const hydrate = useThemeSourceStore((state) => state.hydrate);
+  const { setMode } = useBloomTheme();
+  useAccountColor({ canUse });
+
+  useEffect(() => {
+    void hydrate();
+  }, [hydrate]);
+
+  const accountMode = user?.themePreference?.mode;
+  useEffect(() => {
+    if (!hydrated || !isAuthenticated || source !== 'account' || !accountMode) return;
+    setMode(accountMode);
+  }, [hydrated, isAuthenticated, source, accountMode, setMode]);
+}
+
+export interface AccountThemeControls {
+  /** The effective source: `app` whenever no session can reach the account. */
+  source: ThemeSource;
+  /** Switch this device's source; enabling `account` seeds an account with no theme yet. */
+  changeThemeSource: (source: ThemeSource) => void;
+  /** Change the mode now; on the `account` source, also write it to the account. */
+  changeThemeMode: (mode: ThemeMode) => Promise<void>;
+}
+
+/**
+ * Source-aware theme mode changes for a settings screen. Bloom changes at once;
+ * on the `account` source the account's portable theme follows. Without a
+ * usable session the effective source is `app`, so changes stay local, and the
+ * stored choice applies again once signed in. The colour is chosen with
+ * `useAccountColorSave`.
+ */
+export function useAccountThemeControls(): AccountThemeControls {
+  const { user, canUsePrivateApi } = useAuth();
+  const { mode, colorPreset, setMode } = useBloomTheme();
+  const { mutateAsync } = useUpdateProfile();
+  const storedSource = useThemeSourceStore((state) => state.source);
+  const setSource = useThemeSourceStore((state) => state.setSource);
+  const source: ThemeSource = canUsePrivateApi ? storedSource : 'app';
+
+  const persist = useCallback(
+    async (next: { mode: ThemeMode; colorPreset: AppColorName }) => {
+      await mutateAsync({
+        themePreference: { mode: toPortableMode(next.mode), colorPreset: next.colorPreset },
+      });
+    },
+    [mutateAsync],
+  );
+
+  const changeThemeMode = useCallback(
+    async (nextMode: ThemeMode) => {
+      setMode(nextMode);
+      if (source === 'account') await persist({ mode: nextMode, colorPreset });
+    },
+    [setMode, source, persist, colorPreset],
+  );
+
+  const accountTheme = user?.themePreference;
+  const hasAccountTheme =
+    !!accountTheme && resolveAccountColor({ themePreference: accountTheme }) !== null;
+  const changeThemeSource = useCallback(
+    (nextSource: ThemeSource) => {
+      setSource(nextSource);
+      // An existing account theme is applied by `useAccountTheme`; only an
+      // account without one is seeded, from what the viewer sees now.
+      if (nextSource !== 'account' || !canUsePrivateApi || hasAccountTheme) return;
+      persist({ mode, colorPreset }).catch((error: unknown) => {
+        logger.error('Failed to seed the account theme', error);
+      });
+    },
+    [setSource, canUsePrivateApi, hasAccountTheme, persist, mode, colorPreset],
+  );
+
+  return { source, changeThemeSource, changeThemeMode };
+}