@oxyhq/services 30.0.0 → 30.0.1

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

@@ -0,0 +1,157 @@
+"use strict";
+
+import { useMemo } from 'react';
+import { useQuery } from '@tanstack/react-query';
+
+/**
+ * The variant-aware batch resolver contract (`@oxyhq/core`).
+ *
+ * `getFileDownloadUrls` takes a per-file `{ fileId, variant }` list and returns
+ * a map keyed by `fileId`; ids that are denied or missing are OMITTED (never an
+ * empty string), and PRIVATE assets resolve to a working scoped-media-token
+ * stream URL. Typed here rather than `Pick<OxyServices, …>` so this file states
+ * the exact contract it depends on.
+ */
+
+/**
+ * Private-safe grid/thumbnail URL resolution.
+ *
+ * The synchronous `oxyServices.getFileDownloadUrl(id, variant)` always yields
+ * the public CDN origin (`cloud.oxy.so/<id>`), which 404s for PRIVATE assets —
+ * and uploads default to private. Thumbnails and previews therefore have to be
+ * resolved through the authenticated batch endpoint, which returns a working
+ * `/assets/:id/stream?…&mt=<scoped media token>` URL for private files.
+ *
+ * This hook resolves an ENTIRE page of files in ONE (chunked) batch request
+ * rather than N per-tile calls, and caches the result in React Query keyed by
+ * the (fileId, variant) set. `staleTime` is deliberately shorter than the
+ * server media-token TTL so a tile never renders a URL whose token has already
+ * expired.
+ *
+ * Optimistic (`temp-…` / `uploading`) entries are NEVER resolved here — an
+ * asset URL must never be built from an id the server does not yet know. Their
+ * preview comes from the locally-picked uri (see {@link fileThumbSource}).
+ */
+
+/** Server media-token lifetime we request for each resolved URL (seconds). */
+const ASSET_URL_TTL_SECONDS = 600; // 10 minutes
+/**
+ * Refresh window. Kept below {@link ASSET_URL_TTL_SECONDS} so React Query
+ * re-resolves in the background before a rendered URL's token can die.
+ */
+const ASSET_URL_STALE_MS = 5 * 60 * 1000; // 5 minutes
+const ASSET_URL_GC_MS = 30 * 60 * 1000;
+/** Server-side batch cap for `POST /assets/batch-access` — chunk beyond this. */
+const BATCH_CAP = 100;
+
+/** React Query prefix — scoped media URLs must never leak across accounts. */
+export const ASSET_DOWNLOAD_URLS_QUERY_KEY = 'assetDownloadUrls';
+
+/**
+ * True when a file is an optimistic placeholder that has not been persisted by
+ * the server yet — either its id is still the client-minted `temp-…` id, or it
+ * carries the `uploading` flag. Mirrors the `temp-` id guard precedent in
+ * `@oxyhq/core`'s `avatarUtils.updateAvatarVisibility`.
+ */
+export function isOptimisticFile(file) {
+  if (typeof file.id === 'string' && file.id.startsWith('temp-')) return true;
+  return file.metadata?.uploading === true;
+}
+
+/** Grid thumbnail variant for a file, or `undefined` when it needs no URL. */
+function thumbVariantFor(file) {
+  if (file.contentType.startsWith('video/')) return 'poster';
+  if (file.contentType.startsWith('image/')) return 'thumb';
+  return undefined;
+}
+
+/**
+ * Locally-picked preview uri stashed on an optimistic entry's metadata by the
+ * upload flow, if present.
+ */
+function localPreviewUri(file) {
+  const uri = file.metadata?.localPreviewUri;
+  return typeof uri === 'string' && uri.length > 0 ? uri : undefined;
+}
+
+/**
+ * Resolve the image source for a grid tile.
+ *
+ * - Optimistic entry → its locally-picked preview uri (never an asset URL).
+ * - Persisted entry → the private-safe URL from {@link useResolvedFileUrls},
+ *   or `undefined` while it is still resolving / was denied (tile shows a
+ *   placeholder instead of a guaranteed-404 CDN URL).
+ */
+export function fileThumbSource(file, resolved) {
+  if (isOptimisticFile(file)) {
+    return localPreviewUri(file);
+  }
+  return resolved.get(file.id);
+}
+
+/**
+ * Batch-resolve private-safe thumbnail URLs for the given files.
+ *
+ * Only image/video, non-optimistic files are resolved (documents render an
+ * icon, optimistic entries render their local preview). Returns a stable
+ * `Map<fileId, url>`; missing entries mean "not resolved yet or access denied".
+ */
+export function useResolvedFileUrls(oxyServices, files, /** Active viewer account id — media tokens are minted per user; must be in the query key. */
+viewerId) {
+  const viewerKey = viewerId ?? '';
+  const requests = useMemo(() => {
+    const list = [];
+    for (const file of files) {
+      if (isOptimisticFile(file)) continue;
+      const variant = thumbVariantFor(file);
+      if (!variant) continue;
+      list.push({
+        fileId: file.id,
+        variant
+      });
+    }
+    return list;
+  }, [files]);
+
+  // A content signature so the query key is stable across renders while the
+  // resolvable set is unchanged (the `files` array is a fresh reference every
+  // render). Sorted so ordering churn does not force a refetch.
+  const signature = useMemo(() => requests.map(r => `${r.fileId}:${r.variant ?? ''}`).sort().join('|'), [requests]);
+  const query = useQuery({
+    queryKey: [ASSET_DOWNLOAD_URLS_QUERY_KEY, viewerKey, signature],
+    enabled: requests.length > 0 && viewerKey.length > 0,
+    staleTime: ASSET_URL_STALE_MS,
+    gcTime: ASSET_URL_GC_MS,
+    // Keep previously-resolved URLs on screen while the SAME viewer's file set
+    // grows (pagination), but never carry another account's scoped media tokens
+    // across a switch — `keepPreviousData` alone would do that.
+    placeholderData: (previousData, previousQuery) => {
+      if (!previousData || !previousQuery) return undefined;
+      const prevViewer = previousQuery.queryKey[1];
+      if (prevViewer !== viewerKey) return undefined;
+      return previousData;
+    },
+    queryFn: async () => {
+      const merged = {};
+      for (let i = 0; i < requests.length; i += BATCH_CAP) {
+        const chunk = requests.slice(i, i + BATCH_CAP);
+        const urls = await oxyServices.getFileDownloadUrls(chunk, {
+          expiresIn: ASSET_URL_TTL_SECONDS
+        });
+        Object.assign(merged, urls);
+      }
+      return merged;
+    }
+  });
+  return useMemo(() => {
+    const map = new Map();
+    const data = query.data;
+    if (data) {
+      for (const [id, url] of Object.entries(data)) {
+        if (typeof url === 'string' && url.length > 0) map.set(id, url);
+      }
+    }
+    return map;
+  }, [query.data]);
+}
+//# sourceMappingURL=useResolvedFileUrls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useQuery","ASSET_URL_TTL_SECONDS","ASSET_URL_STALE_MS","ASSET_URL_GC_MS","BATCH_CAP","ASSET_DOWNLOAD_URLS_QUERY_KEY","isOptimisticFile","file","id","startsWith","metadata","uploading","thumbVariantFor","contentType","undefined","localPreviewUri","uri","length","fileThumbSource","resolved","get","useResolvedFileUrls","oxyServices","files","viewerId","viewerKey","requests","list","variant","push","fileId","signature","map","r","sort","join","query","queryKey","enabled","staleTime","gcTime","placeholderData","previousData","previousQuery","prevViewer","queryFn","merged","i","chunk","slice","urls","getFileDownloadUrls","expiresIn","Object","assign","Map","data","url","entries","set"],"sourceRoot":"../../../../src","sources":["ui/hooks/useResolvedFileUrls.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,uBAAuB;;AAGhD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMC,qBAAqB,GAAG,GAAG,CAAC,CAAC;AACnC;AACA;AACA;AACA;AACA,MAAMC,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC1C,MAAMC,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;AACtC;AACA,MAAMC,SAAS,GAAG,GAAG;;AAErB;AACA,OAAO,MAAMC,6BAA6B,GAAG,mBAA4B;;AAEzE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,IAA2C,EAAW;EACrF,IAAI,OAAOA,IAAI,CAACC,EAAE,KAAK,QAAQ,IAAID,IAAI,CAACC,EAAE,CAACC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI;EAC3E,OAAOF,IAAI,CAACG,QAAQ,EAAEC,SAAS,KAAK,IAAI;AAC1C;;AAEA;AACA,SAASC,eAAeA,CAACL,IAAkB,EAAsB;EAC/D,IAAIA,IAAI,CAACM,WAAW,CAACJ,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,QAAQ;EAC1D,IAAIF,IAAI,CAACM,WAAW,CAACJ,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,OAAO;EACzD,OAAOK,SAAS;AAClB;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACR,IAAkB,EAAsB;EAC/D,MAAMS,GAAG,GAAIT,IAAI,CAACG,QAAQ,EAA0CK,eAAe;EACnF,OAAO,OAAOC,GAAG,KAAK,QAAQ,IAAIA,GAAG,CAACC,MAAM,GAAG,CAAC,GAAGD,GAAG,GAAGF,SAAS;AACpE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASI,eAAeA,CAC7BX,IAAkB,EAClBY,QAAqC,EACjB;EACpB,IAAIb,gBAAgB,CAACC,IAAI,CAAC,EAAE;IAC1B,OAAOQ,eAAe,CAACR,IAAI,CAAC;EAC9B;EACA,OAAOY,QAAQ,CAACC,GAAG,CAACb,IAAI,CAACC,EAAE,CAAC;AAC9B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASa,mBAAmBA,CACjCC,WAAkC,EAClCC,KAAqB,EACrB;AACAC,QAAwB,EACK;EAC7B,MAAMC,SAAS,GAAGD,QAAQ,IAAI,EAAE;EAChC,MAAME,QAAQ,GAAG3B,OAAO,CAAC,MAAM;IAC7B,MAAM4B,IAAiD,GAAG,EAAE;IAC5D,KAAK,MAAMpB,IAAI,IAAIgB,KAAK,EAAE;MACxB,IAAIjB,gBAAgB,CAACC,IAAI,CAAC,EAAE;MAC5B,MAAMqB,OAAO,GAAGhB,eAAe,CAACL,IAAI,CAAC;MACrC,IAAI,CAACqB,OAAO,EAAE;MACdD,IAAI,CAACE,IAAI,CAAC;QAAEC,MAAM,EAAEvB,IAAI,CAACC,EAAE;QAAEoB;MAAQ,CAAC,CAAC;IACzC;IACA,OAAOD,IAAI;EACb,CAAC,EAAE,CAACJ,KAAK,CAAC,CAAC;;EAEX;EACA;EACA;EACA,MAAMQ,SAAS,GAAGhC,OAAO,CACvB,MAAM2B,QAAQ,CAACM,GAAG,CAAEC,CAAC,IAAK,GAAGA,CAAC,CAACH,MAAM,IAAIG,CAAC,CAACL,OAAO,IAAI,EAAE,EAAE,CAAC,CAACM,IAAI,CAAC,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC,EAC5E,CAACT,QAAQ,CACX,CAAC;EAED,MAAMU,KAAK,GAAGpC,QAAQ,CAAC;IACrBqC,QAAQ,EAAE,CAAChC,6BAA6B,EAAEoB,SAAS,EAAEM,SAAS,CAAC;IAC/DO,OAAO,EAAEZ,QAAQ,CAACT,MAAM,GAAG,CAAC,IAAIQ,SAAS,CAACR,MAAM,GAAG,CAAC;IACpDsB,SAAS,EAAErC,kBAAkB;IAC7BsC,MAAM,EAAErC,eAAe;IACvB;IACA;IACA;IACAsC,eAAe,EAAEA,CAACC,YAAY,EAAEC,aAAa,KAAK;MAChD,IAAI,CAACD,YAAY,IAAI,CAACC,aAAa,EAAE,OAAO7B,SAAS;MACrD,MAAM8B,UAAU,GAAGD,aAAa,CAACN,QAAQ,CAAC,CAAC,CAAC;MAC5C,IAAIO,UAAU,KAAKnB,SAAS,EAAE,OAAOX,SAAS;MAC9C,OAAO4B,YAAY;IACrB,CAAC;IACDG,OAAO,EAAE,MAAAA,CAAA,KAA6C;MACpD,MAAMC,MAA8B,GAAG,CAAC,CAAC;MACzC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGrB,QAAQ,CAACT,MAAM,EAAE8B,CAAC,IAAI3C,SAAS,EAAE;QACnD,MAAM4C,KAAK,GAAGtB,QAAQ,CAACuB,KAAK,CAACF,CAAC,EAAEA,CAAC,GAAG3C,SAAS,CAAC;QAC9C,MAAM8C,IAAI,GAAG,MAAM5B,WAAW,CAAC6B,mBAAmB,CAACH,KAAK,EAAE;UACxDI,SAAS,EAAEnD;QACb,CAAC,CAAC;QACFoD,MAAM,CAACC,MAAM,CAACR,MAAM,EAAEI,IAAI,CAAC;MAC7B;MACA,OAAOJ,MAAM;IACf;EACF,CAAC,CAAC;EAEF,OAAO/C,OAAO,CAAC,MAAM;IACnB,MAAMiC,GAAG,GAAG,IAAIuB,GAAG,CAAiB,CAAC;IACrC,MAAMC,IAAI,GAAGpB,KAAK,CAACoB,IAAI;IACvB,IAAIA,IAAI,EAAE;MACR,KAAK,MAAM,CAAChD,EAAE,EAAEiD,GAAG,CAAC,IAAIJ,MAAM,CAACK,OAAO,CAACF,IAAI,CAAC,EAAE;QAC5C,IAAI,OAAOC,GAAG,KAAK,QAAQ,IAAIA,GAAG,CAACxC,MAAM,GAAG,CAAC,EAAEe,GAAG,CAAC2B,GAAG,CAACnD,EAAE,EAAEiD,GAAG,CAAC;MACjE;IACF;IACA,OAAOzB,GAAG;EACZ,CAAC,EAAE,CAACI,KAAK,CAACoB,IAAI,CAAC,CAAC;AAClB","ignoreList":[]}

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

@@ -0,0 +1,178 @@
+"use strict";
+
+import { useCallback, useMemo, useRef } from 'react';
+import { isDev } from '@oxyhq/core';
+import { fetchSessionsWithFallback } from "../utils/sessionHelpers.js";
+import { getStorageKeys } from "../utils/storageHelpers.js";
+import { handleAuthError, isInvalidSessionError } from "../utils/errorHandlers.js";
+import { clearQueryCache } from "./queryClient.js";
+import { isWebBrowser } from "../utils/isWebBrowser.js";
+import { resetSessionScopedStores } from "../stores/resetSessionScopedStores.js";
+const DEFAULT_SAVE_ERROR_MESSAGE = 'Failed to save session data';
+const CLEAR_STORAGE_ERROR = 'Failed to clear storage';
+
+/**
+ * Session persistence and the one legacy switch left, over the runtime.
+ *
+ * This hook used to hold its OWN `sessions` / `activeSessionId` React state
+ * plus six refs mirroring them so its callbacks could avoid widening their
+ * dependency arrays. That made it a second owner of facts `SessionClient`
+ * already had, reconciled only by whichever `useEffect` ran last. Both are gone:
+ * the runtime owns them, this hook writes through it, and the refs mirrored
+ * nothing once there was nothing local to mirror.
+ *
+ * `refreshSessions`, `trackRemovedSession` and `isRefreshInFlight` are deleted
+ * outright — every one of them was dropped unread at the single call site.
+ */
+export const useSessionManagement = ({
+  oxyServices,
+  runtime,
+  storage,
+  storageKeyPrefix,
+  onAuthStateChange,
+  onError,
+  setAuthError,
+  logger,
+  queryClient
+}) => {
+  const storageKeys = useMemo(() => getStorageKeys(storageKeyPrefix), [storageKeyPrefix]);
+  const runtimeRef = useRef(runtime);
+  runtimeRef.current = runtime;
+  const saveSessionIds = useCallback(sessionIds => {
+    if (!storage) return;
+    const uniqueIds = Array.from(new Set(sessionIds));
+    storage.setItem(storageKeys.sessionIds, JSON.stringify(uniqueIds)).catch(error => {
+      if (logger) {
+        logger(DEFAULT_SAVE_ERROR_MESSAGE, error);
+      } else if (isDev()) {
+        console.warn('Failed to save session IDs:', error);
+      }
+    });
+  }, [logger, storage, storageKeys.sessionIds]);
+  const saveActiveSessionId = useCallback(async sessionId => {
+    if (!storage) return;
+    try {
+      await storage.setItem(storageKeys.activeSessionId, sessionId);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: DEFAULT_SAVE_ERROR_MESSAGE,
+        code: 'SESSION_PERSISTENCE_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+    }
+  }, [logger, onError, setAuthError, storage, storageKeys.activeSessionId]);
+  const clearSessionStorage = useCallback(async () => {
+    if (!storage) return;
+    try {
+      await storage.removeItem(storageKeys.activeSessionId);
+      await storage.removeItem(storageKeys.sessionIds);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: CLEAR_STORAGE_ERROR,
+        code: 'STORAGE_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+    }
+  }, [logger, onError, setAuthError, storage, storageKeys.activeSessionId, storageKeys.sessionIds]);
+  const clearSessionState = useCallback(async () => {
+    runtimeRef.current.clearSession();
+    resetSessionScopedStores();
+
+    // Clear the access token on the client instance. Without this the token
+    // store retained the stale bearer until the next 401, leaving the instance
+    // "logged in" at the HTTP layer and — via the provider's token mirror —
+    // leaking that stale token onto the shared `oxyClient` singleton after
+    // sign-out. Clearing here fires `onTokensChanged(null)`, propagating the
+    // logged-out state everywhere.
+    oxyServices.clearTokens();
+    if (queryClient) {
+      queryClient.clear();
+    }
+    if (storage) {
+      try {
+        await clearQueryCache(storage);
+      } catch (error) {
+        if (logger) {
+          logger('Failed to clear persisted query cache', error);
+        }
+      }
+    }
+    await clearSessionStorage();
+    onAuthStateChange?.(null);
+  }, [clearSessionStorage, onAuthStateChange, oxyServices, queryClient, storage, logger]);
+  const switchSession = useCallback(async sessionId => {
+    try {
+      // On web the bearer must already be in memory (planted by
+      // `claimSessionByToken`, a cold-boot restore step, or a prior
+      // `SessionClient` sync) before validating — there is no client-side
+      // refresh-cookie slot to fall back on. The native path arrives here only
+      // after a bearer has been planted too.
+      if (isWebBrowser() && !oxyServices.getAccessToken()) {
+        throw new Error('Session is invalid or expired');
+      }
+      const validation = await oxyServices.validateSession(sessionId, {
+        useHeaderValidation: true
+      });
+      if (!validation?.valid) {
+        throw new Error('Session is invalid or expired');
+      }
+      if (!validation.user) {
+        throw new Error('User data not available from session validation');
+      }
+      const user = validation.user;
+      const activeRuntime = runtimeRef.current;
+      activeRuntime.batch(() => {
+        activeRuntime.setTokenReady(true);
+        activeRuntime.setActiveSessionId(sessionId);
+        activeRuntime.setAccount(user);
+      });
+      await saveActiveSessionId(sessionId);
+      onAuthStateChange?.(user);
+      try {
+        const deviceSessions = await fetchSessionsWithFallback(oxyServices, sessionId, {
+          fallbackUserId: user.id,
+          logger
+        });
+        activeRuntime.mergeSessions(deviceSessions, {
+          merge: true
+        });
+      } catch (error) {
+        if (isDev()) {
+          console.warn('Failed to synchronize sessions after switch:', error);
+        }
+      }
+      return user;
+    } catch (error) {
+      const invalidSession = isInvalidSessionError(error);
+      if (invalidSession) {
+        // Server authority (`SessionClient` bootstrap/sync) reconciles which
+        // account is actually active — just drop the invalid session from the
+        // local view rather than guessing at a replacement.
+        const remaining = runtimeRef.current.getSnapshot().sessions.filter(session => session.sessionId !== sessionId);
+        runtimeRef.current.mergeSessions(remaining, {
+          merge: false
+        });
+      }
+      handleAuthError(error, {
+        defaultMessage: 'Failed to switch session',
+        code: invalidSession ? 'INVALID_SESSION' : 'SESSION_SWITCH_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to switch session');
+    }
+  }, [logger, onAuthStateChange, onError, oxyServices, saveActiveSessionId, setAuthError]);
+  return {
+    saveSessionIds,
+    saveActiveSessionId,
+    switchSession,
+    clearSessionState,
+    storageKeys
+  };
+};
+//# sourceMappingURL=useSessionManagement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useRef","isDev","fetchSessionsWithFallback","getStorageKeys","handleAuthError","isInvalidSessionError","clearQueryCache","isWebBrowser","resetSessionScopedStores","DEFAULT_SAVE_ERROR_MESSAGE","CLEAR_STORAGE_ERROR","useSessionManagement","oxyServices","runtime","storage","storageKeyPrefix","onAuthStateChange","onError","setAuthError","logger","queryClient","storageKeys","runtimeRef","current","saveSessionIds","sessionIds","uniqueIds","Array","from","Set","setItem","JSON","stringify","catch","error","console","warn","saveActiveSessionId","sessionId","activeSessionId","defaultMessage","code","clearSessionStorage","removeItem","clearSessionState","clearSession","clearTokens","clear","switchSession","getAccessToken","Error","validation","validateSession","useHeaderValidation","valid","user","activeRuntime","batch","setTokenReady","setActiveSessionId","setAccount","deviceSessions","fallbackUserId","id","mergeSessions","merge","invalidSession","remaining","getSnapshot","sessions","filter","session"],"sourceRoot":"../../../../src","sources":["ui/hooks/useSessionManagement.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,126 @@
+"use strict";
+
+import { useState, useCallback, useEffect } from 'react';
+import { toast } from '@oxyhq/bloom/toast';
+/**
+ * Hook for handling boolean toggle settings with optimistic updates.
+ * Automatically reverts to the previous value if the save fails.
+ *
+ * @example
+ * const { value, toggle, isSaving } = useSettingToggle({
+ *   initialValue: user.notificationsEnabled,
+ *   onSave: (value) => api.updateNotifications(value),
+ *   errorMessage: 'Failed to update notifications',
+ * });
+ *
+ * <Switch value={value} onValueChange={toggle} disabled={isSaving} />
+ */
+export function useSettingToggle(options) {
+  const {
+    initialValue,
+    onSave,
+    successMessage,
+    errorMessage = 'Failed to save setting',
+    revertOnError = true,
+    showSuccessToast = false
+  } = options;
+  const [value, setValue] = useState(initialValue);
+  const [isSaving, setIsSaving] = useState(false);
+
+  // Update value when initialValue changes (e.g., from server)
+  useEffect(() => {
+    setValue(initialValue);
+  }, [initialValue]);
+  const toggle = useCallback(async () => {
+    const previousValue = value;
+    const newValue = !value;
+
+    // Optimistic update
+    setValue(newValue);
+    setIsSaving(true);
+    try {
+      await onSave(newValue);
+      if (showSuccessToast && successMessage) {
+        toast.success(successMessage);
+      }
+    } catch (err) {
+      // Revert on error
+      if (revertOnError) {
+        setValue(previousValue);
+      }
+      toast.error(errorMessage || (err instanceof Error ? err.message : null) || 'An error occurred');
+    } finally {
+      setIsSaving(false);
+    }
+  }, [value, onSave, successMessage, errorMessage, revertOnError, showSuccessToast]);
+  return {
+    value,
+    isSaving,
+    toggle,
+    setValue
+  };
+}
+
+/**
+ * Hook for managing multiple toggle settings at once.
+ * Useful when you have several related boolean settings.
+ */
+export function useSettingToggles(options) {
+  const {
+    initialValues,
+    onSave,
+    errorMessage = 'Failed to save setting',
+    revertOnError = true
+  } = options;
+  const [values, setValues] = useState(initialValues);
+  const [savingKeys, setSavingKeys] = useState(new Set());
+
+  // Update values when initialValues change
+  useEffect(() => {
+    setValues(initialValues);
+  }, [initialValues]);
+  const toggle = useCallback(async key => {
+    const previousValue = values[key];
+    const newValue = !previousValue;
+
+    // Optimistic update
+    setValues(prev => ({
+      ...prev,
+      [key]: newValue
+    }));
+    setSavingKeys(prev => new Set(prev).add(key));
+    try {
+      await onSave(key, newValue);
+    } catch (err) {
+      // Revert on error
+      if (revertOnError) {
+        setValues(prev => ({
+          ...prev,
+          [key]: previousValue
+        }));
+      }
+      const message = typeof errorMessage === 'function' ? errorMessage(key) : errorMessage;
+      toast.error(message || (err instanceof Error ? err.message : null) || 'An error occurred');
+    } finally {
+      setSavingKeys(prev => {
+        const next = new Set(prev);
+        next.delete(key);
+        return next;
+      });
+    }
+  }, [values, onSave, errorMessage, revertOnError]);
+  const setValuesExternal = useCallback(newValues => {
+    setValues(prev => ({
+      ...prev,
+      ...newValues
+    }));
+  }, []);
+  return {
+    values,
+    savingKeys,
+    toggle,
+    setValues: setValuesExternal
+  };
+}
+export default useSettingToggle;
+//# sourceMappingURL=useSettingToggle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","useEffect","toast","useSettingToggle","options","initialValue","onSave","successMessage","errorMessage","revertOnError","showSuccessToast","value","setValue","isSaving","setIsSaving","toggle","previousValue","newValue","success","err","error","Error","message","useSettingToggles","initialValues","values","setValues","savingKeys","setSavingKeys","Set","key","prev","add","next","delete","setValuesExternal","newValues"],"sourceRoot":"../../../../src","sources":["ui/hooks/useSettingToggle.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,WAAW,EAAEC,SAAS,QAAQ,OAAO;AACxD,SAASC,KAAK,QAAQ,oBAAoB;AA4B1C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,OAAgC,EAA0B;EACvF,MAAM;IACFC,YAAY;IACZC,MAAM;IACNC,cAAc;IACdC,YAAY,GAAG,wBAAwB;IACvCC,aAAa,GAAG,IAAI;IACpBC,gBAAgB,GAAG;EACvB,CAAC,GAAGN,OAAO;EAEX,MAAM,CAACO,KAAK,EAAEC,QAAQ,CAAC,GAAGb,QAAQ,CAACM,YAAY,CAAC;EAChD,MAAM,CAACQ,QAAQ,EAAEC,WAAW,CAAC,GAAGf,QAAQ,CAAC,KAAK,CAAC;;EAE/C;EACAE,SAAS,CAAC,MAAM;IACZW,QAAQ,CAACP,YAAY,CAAC;EAC1B,CAAC,EAAE,CAACA,YAAY,CAAC,CAAC;EAElB,MAAMU,MAAM,GAAGf,WAAW,CAAC,YAAY;IACnC,MAAMgB,aAAa,GAAGL,KAAK;IAC3B,MAAMM,QAAQ,GAAG,CAACN,KAAK;;IAEvB;IACAC,QAAQ,CAACK,QAAQ,CAAC;IAClBH,WAAW,CAAC,IAAI,CAAC;IAEjB,IAAI;MACA,MAAMR,MAAM,CAACW,QAAQ,CAAC;MAEtB,IAAIP,gBAAgB,IAAIH,cAAc,EAAE;QACpCL,KAAK,CAACgB,OAAO,CAACX,cAAc,CAAC;MACjC;IACJ,CAAC,CAAC,OAAOY,GAAY,EAAE;MACnB;MACA,IAAIV,aAAa,EAAE;QACfG,QAAQ,CAACI,aAAa,CAAC;MAC3B;MAEAd,KAAK,CAACkB,KAAK,CAACZ,YAAY,KAAKW,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB,CAAC;IACnG,CAAC,SAAS;MACNR,WAAW,CAAC,KAAK,CAAC;IACtB;EACJ,CAAC,EAAE,CAACH,KAAK,EAAEL,MAAM,EAAEC,cAAc,EAAEC,YAAY,EAAEC,aAAa,EAAEC,gBAAgB,CAAC,CAAC;EAElF,OAAO;IAAEC,KAAK;IAAEE,QAAQ;IAAEE,MAAM;IAAEH;EAAS,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASW,iBAAiBA,CAAwCnB,OAKxE,EAKC;EACE,MAAM;IAAEoB,aAAa;IAAElB,MAAM;IAAEE,YAAY,GAAG,wBAAwB;IAAEC,aAAa,GAAG;EAAK,CAAC,GAAGL,OAAO;EAExG,MAAM,CAACqB,MAAM,EAAEC,SAAS,CAAC,GAAG3B,QAAQ,CAAIyB,aAAa,CAAC;EACtD,MAAM,CAACG,UAAU,EAAEC,aAAa,CAAC,GAAG7B,QAAQ,CAAe,IAAI8B,GAAG,CAAC,CAAC,CAAC;;EAErE;EACA5B,SAAS,CAAC,MAAM;IACZyB,SAAS,CAACF,aAAa,CAAC;EAC5B,CAAC,EAAE,CAACA,aAAa,CAAC,CAAC;EAEnB,MAAMT,MAAM,GAAGf,WAAW,CAAC,MAAO8B,GAAY,IAAK;IAC/C,MAAMd,aAAa,GAAGS,MAAM,CAACK,GAAG,CAAC;IACjC,MAAMb,QAAQ,GAAG,CAACD,aAAa;;IAE/B;IACAU,SAAS,CAACK,IAAI,KAAK;MAAE,GAAGA,IAAI;MAAE,CAACD,GAAG,GAAGb;IAAS,CAAC,CAAC,CAAC;IACjDW,aAAa,CAACG,IAAI,IAAI,IAAIF,GAAG,CAACE,IAAI,CAAC,CAACC,GAAG,CAACF,GAAG,CAAC,CAAC;IAE7C,IAAI;MACA,MAAMxB,MAAM,CAACwB,GAAG,EAAEb,QAAQ,CAAC;IAC/B,CAAC,CAAC,OAAOE,GAAY,EAAE;MACnB;MACA,IAAIV,aAAa,EAAE;QACfiB,SAAS,CAACK,IAAI,KAAK;UAAE,GAAGA,IAAI;UAAE,CAACD,GAAG,GAAGd;QAAc,CAAC,CAAC,CAAC;MAC1D;MAEA,MAAMM,OAAO,GAAG,OAAOd,YAAY,KAAK,UAAU,GAC5CA,YAAY,CAACsB,GAAG,CAAC,GACjBtB,YAAY;MAClBN,KAAK,CAACkB,KAAK,CAACE,OAAO,KAAKH,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACG,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB,CAAC;IAC9F,CAAC,SAAS;MACNM,aAAa,CAACG,IAAI,IAAI;QAClB,MAAME,IAAI,GAAG,IAAIJ,GAAG,CAACE,IAAI,CAAC;QAC1BE,IAAI,CAACC,MAAM,CAACJ,GAAG,CAAC;QAChB,OAAOG,IAAI;MACf,CAAC,CAAC;IACN;EACJ,CAAC,EAAE,CAACR,MAAM,EAAEnB,MAAM,EAAEE,YAAY,EAAEC,aAAa,CAAC,CAAC;EAEjD,MAAM0B,iBAAiB,GAAGnC,WAAW,CAAEoC,SAAqB,IAAK;IAC7DV,SAAS,CAACK,IAAI,KAAK;MAAE,GAAGA,IAAI;MAAE,GAAGK;IAAU,CAAC,CAAC,CAAC;EAClD,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IAAEX,MAAM;IAAEE,UAAU;IAAEZ,MAAM;IAAEW,SAAS,EAAES;EAAkB,CAAC;AACvE;AAEA,eAAehC,gBAAgB","ignoreList":[]}

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

@@ -0,0 +1,40 @@
+"use strict";
+
+import { useEffect, useRef, useState } from 'react';
+import { createPlatformStorage } from "../utils/storageHelpers.js";
+/**
+ * Simple React hook that initializes platform-appropriate storage.
+ * Returns storage instance once ready, or null if initialization failed.
+ */
+export const useStorage = ({
+  onError,
+  logger
+} = {}) => {
+  const [storage, setStorage] = useState(null);
+  const initRef = useRef(null);
+  useEffect(() => {
+    // Prevent multiple initializations
+    if (initRef.current) return;
+    initRef.current = (async () => {
+      try {
+        const storageInstance = await createPlatformStorage();
+        setStorage(storageInstance);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : 'Failed to initialize storage';
+        if (logger) {
+          logger(message, err);
+        }
+        onError?.({
+          message,
+          code: 'STORAGE_INIT_ERROR',
+          status: 500
+        });
+      }
+    })();
+  }, [logger, onError]);
+  return {
+    storage,
+    isReady: storage !== null
+  };
+};
+//# sourceMappingURL=useStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","useState","createPlatformStorage","useStorage","onError","logger","storage","setStorage","initRef","current","storageInstance","err","message","Error","code","status","isReady"],"sourceRoot":"../../../../src","sources":["ui/hooks/useStorage.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAEnD,SAASC,qBAAqB,QAA+B,4BAAyB;AAYtF;AACA;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAGA,CAAC;EACzBC,OAAO;EACPC;AACiB,CAAC,GAAG,CAAC,CAAC,KAAuB;EAC9C,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGN,QAAQ,CAA0B,IAAI,CAAC;EACrE,MAAMO,OAAO,GAAGR,MAAM,CAAuB,IAAI,CAAC;EAElDD,SAAS,CAAC,MAAM;IACd;IACA,IAAIS,OAAO,CAACC,OAAO,EAAE;IAErBD,OAAO,CAACC,OAAO,GAAG,CAAC,YAAY;MAC7B,IAAI;QACF,MAAMC,eAAe,GAAG,MAAMR,qBAAqB,CAAC,CAAC;QACrDK,UAAU,CAACG,eAAe,CAAC;MAC7B,CAAC,CAAC,OAAOC,GAAG,EAAE;QACZ,MAAMC,OAAO,GAAGD,GAAG,YAAYE,KAAK,GAAGF,GAAG,CAACC,OAAO,GAAG,8BAA8B;QACnF,IAAIP,MAAM,EAAE;UACVA,MAAM,CAACO,OAAO,EAAED,GAAG,CAAC;QACtB;QACAP,OAAO,GAAG;UACRQ,OAAO;UACPE,IAAI,EAAE,oBAAoB;UAC1BC,MAAM,EAAE;QACV,CAAC,CAAC;MACJ;IACF,CAAC,EAAE,CAAC;EACN,CAAC,EAAE,CAACV,MAAM,EAAED,OAAO,CAAC,CAAC;EAErB,OAAO;IACLE,OAAO;IACPU,OAAO,EAAEV,OAAO,KAAK;EACvB,CAAC;AACH,CAAC","ignoreList":[]}