@oxyhq/services 5.16.23 → 5.16.24

package/lib/module/ui/context/hooks/useDeviceManagement.js

@@ -0,0 +1,68 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { DeviceManager } from '../../../utils/deviceManager';
+import { handleAuthError } from '../../utils/errorHandlers';
+/**
+ * Provide device session management helpers tied to the current active session.
+ *
+ * @param options - Device management configuration
+ */
+export const useDeviceManagement = ({
+  oxyServices,
+  activeSessionId,
+  onError,
+  clearSessionState,
+  logger
+}) => {
+  const getDeviceSessions = useCallback(async () => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      return await oxyServices.getDeviceSessions(activeSessionId);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to get device sessions',
+        code: 'GET_DEVICE_SESSIONS_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to get device sessions');
+    }
+  }, [activeSessionId, logger, onError, oxyServices]);
+  const logoutAllDeviceSessions = useCallback(async () => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      await oxyServices.logoutAllDeviceSessions(activeSessionId);
+      await clearSessionState();
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to logout all device sessions',
+        code: 'LOGOUT_ALL_DEVICES_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to logout all device sessions');
+    }
+  }, [activeSessionId, clearSessionState, logger, onError, oxyServices]);
+  const updateDeviceName = useCallback(async deviceName => {
+    if (!activeSessionId) throw new Error('No active session');
+    try {
+      await oxyServices.updateDeviceName(activeSessionId, deviceName);
+      await DeviceManager.updateDeviceName(deviceName);
+    } catch (error) {
+      handleAuthError(error, {
+        defaultMessage: 'Failed to update device name',
+        code: 'UPDATE_DEVICE_NAME_ERROR',
+        onError,
+        logger
+      });
+      throw error instanceof Error ? error : new Error('Failed to update device name');
+    }
+  }, [activeSessionId, logger, onError, oxyServices]);
+  return {
+    getDeviceSessions,
+    logoutAllDeviceSessions,
+    updateDeviceName
+  };
+};
+//# sourceMappingURL=useDeviceManagement.js.map

package/lib/module/ui/context/hooks/useDeviceManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","DeviceManager","handleAuthError","useDeviceManagement","oxyServices","activeSessionId","onError","clearSessionState","logger","getDeviceSessions","Error","error","defaultMessage","code","logoutAllDeviceSessions","updateDeviceName","deviceName"],"sourceRoot":"../../../../../src","sources":["ui/context/hooks/useDeviceManagement.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AAEnC,SAASC,aAAa,QAAQ,8BAA8B;AAE5D,SAASC,eAAe,QAAQ,2BAA2B;AAwB3D;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAAGA,CAAC;EAClCC,WAAW;EACXC,eAAe;EACfC,OAAO;EACPC,iBAAiB;EACjBC;AAC0B,CAAC,KAAgC;EAC3D,MAAMC,iBAAiB,GAAGT,WAAW,CAAC,YAQjC;IACH,IAAI,CAACK,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAC1D,IAAI;MACF,OAAO,MAAMN,WAAW,CAACK,iBAAiB,CAACJ,eAAe,CAAC;IAC7D,CAAC,CAAC,OAAOM,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,+BAA+B;QAC/CC,IAAI,EAAE,2BAA2B;QACjCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,+BAA+B,CAAC;IACnF;EACF,CAAC,EAAE,CAACL,eAAe,EAAEG,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAAC,CAAC;EAEnD,MAAMU,uBAAuB,GAAGd,WAAW,CAAC,YAA2B;IACrE,IAAI,CAACK,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAE1D,IAAI;MACF,MAAMN,WAAW,CAACU,uBAAuB,CAACT,eAAe,CAAC;MAC1D,MAAME,iBAAiB,CAAC,CAAC;IAC3B,CAAC,CAAC,OAAOI,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,sCAAsC;QACtDC,IAAI,EAAE,0BAA0B;QAChCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,sCAAsC,CAAC;IAC1F;EACF,CAAC,EAAE,CAACL,eAAe,EAAEE,iBAAiB,EAAEC,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAAC,CAAC;EAEtE,MAAMW,gBAAgB,GAAGf,WAAW,CAClC,MAAOgB,UAAkB,IAAoB;IAC3C,IAAI,CAACX,eAAe,EAAE,MAAM,IAAIK,KAAK,CAAC,mBAAmB,CAAC;IAE1D,IAAI;MACF,MAAMN,WAAW,CAACW,gBAAgB,CAACV,eAAe,EAAEW,UAAU,CAAC;MAC/D,MAAMf,aAAa,CAACc,gBAAgB,CAACC,UAAU,CAAC;IAClD,CAAC,CAAC,OAAOL,KAAK,EAAE;MACdT,eAAe,CAACS,KAAK,EAAE;QACrBC,cAAc,EAAE,8BAA8B;QAC9CC,IAAI,EAAE,0BAA0B;QAChCP,OAAO;QACPE;MACF,CAAC,CAAC;MACF,MAAMG,KAAK,YAAYD,KAAK,GAAGC,KAAK,GAAG,IAAID,KAAK,CAAC,8BAA8B,CAAC;IAClF;EACF,CAAC,EACD,CAACL,eAAe,EAAEG,MAAM,EAAEF,OAAO,EAAEF,WAAW,CAChD,CAAC;EAED,OAAO;IACLK,iBAAiB;IACjBK,uBAAuB;IACvBC;EACF,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/ui/context/hooks/useLanguageManagement.js

@@ -0,0 +1,107 @@
+"use strict";
+
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { getLanguageMetadata, getLanguageName, getNativeLanguageName, normalizeLanguageCode } from '../../../utils/languageUtils';
+import { extractErrorMessage } from '../../utils/errorHandlers';
+const DEFAULT_LANGUAGE = 'en-US';
+
+/**
+ * Manage UI language state, persistence, and metadata derivation.
+ *
+ * @param options - Configuration for storage access and error reporting
+ */
+export const useLanguageManagement = ({
+  storage,
+  languageKey,
+  onError,
+  logger
+}) => {
+  const [currentLanguage, setCurrentLanguage] = useState(DEFAULT_LANGUAGE);
+  const loadLanguageFromStorage = useCallback(async () => {
+    if (!storage) {
+      return;
+    }
+    try {
+      const savedLanguageRaw = await storage.getItem(languageKey);
+      const normalized = normalizeLanguageCode(savedLanguageRaw) || savedLanguageRaw;
+      if (normalized) {
+        setCurrentLanguage(normalized);
+      }
+    } catch (error) {
+      const message = extractErrorMessage(error, 'Failed to load language preference');
+      onError?.({
+        message,
+        code: 'LANGUAGE_LOAD_ERROR',
+        status: 500
+      });
+      if (logger) {
+        logger(message, error);
+      } else if (__DEV__) {
+        console.warn('Failed to load language preference:', error);
+      }
+    }
+  }, [languageKey, logger, onError, storage]);
+  useEffect(() => {
+    loadLanguageFromStorage().catch(error => {
+      if (logger) {
+        logger('Unexpected error loading language', error);
+      }
+    });
+  }, [loadLanguageFromStorage, logger]);
+  const setLanguage = useCallback(async languageId => {
+    if (!storage) {
+      throw new Error('Storage not initialized');
+    }
+    const normalized = normalizeLanguageCode(languageId) || languageId;
+    try {
+      await storage.setItem(languageKey, normalized);
+      setCurrentLanguage(normalized);
+    } catch (error) {
+      const message = extractErrorMessage(error, 'Failed to save language preference');
+      onError?.({
+        message,
+        code: 'LANGUAGE_SAVE_ERROR',
+        status: 500
+      });
+      if (logger) {
+        logger(message, error);
+      } else if (__DEV__) {
+        console.warn('Failed to save language preference:', error);
+      }
+      throw error instanceof Error ? error : new Error(message);
+    }
+  }, [languageKey, logger, onError, storage]);
+  const applyLanguagePreference = useCallback(async user => {
+    if (!storage || !user) {
+      return;
+    }
+    const userLanguage = user?.language;
+    if (!userLanguage) {
+      return;
+    }
+    try {
+      const normalized = normalizeLanguageCode(userLanguage) || userLanguage;
+      await storage.setItem(languageKey, normalized);
+      setCurrentLanguage(normalized);
+    } catch (error) {
+      if (logger) {
+        logger('Failed to apply server language preference', error);
+      } else if (__DEV__) {
+        console.warn('Failed to apply server language preference', error);
+      }
+    }
+  }, [languageKey, logger, storage]);
+  const metadata = useMemo(() => getLanguageMetadata(currentLanguage), [currentLanguage]);
+  const languageName = useMemo(() => getLanguageName(currentLanguage), [currentLanguage]);
+  const nativeLanguageName = useMemo(() => getNativeLanguageName(currentLanguage), [currentLanguage]);
+  return {
+    currentLanguage,
+    metadata,
+    languageName,
+    nativeLanguageName,
+    setLanguage,
+    applyLanguagePreference,
+    hydrateLanguage: loadLanguageFromStorage
+  };
+};
+//# sourceMappingURL=useLanguageManagement.js.map

package/lib/module/ui/context/hooks/useLanguageManagement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useMemo","useState","getLanguageMetadata","getLanguageName","getNativeLanguageName","normalizeLanguageCode","extractErrorMessage","DEFAULT_LANGUAGE","useLanguageManagement","storage","languageKey","onError","logger","currentLanguage","setCurrentLanguage","loadLanguageFromStorage","savedLanguageRaw","getItem","normalized","error","message","code","status","__DEV__","console","warn","catch","setLanguage","languageId","Error","setItem","applyLanguagePreference","user","userLanguage","language","metadata","languageName","nativeLanguageName","hydrateLanguage"],"sourceRoot":"../../../../../src","sources":["ui/context/hooks/useLanguageManagement.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,276 @@
+"use strict";
+
+import { useCallback, useMemo, useRef, useState } from 'react';
+import { mergeSessions, normalizeAndSortSessions, sessionsArraysEqual } from '../../../utils/sessionUtils';
+import { fetchSessionsWithFallback, validateSessionBatch } from '../../utils/sessionHelpers';
+import { getStorageKeys } from '../../utils/storageHelpers';
+import { handleAuthError, isInvalidSessionError } from '../../utils/errorHandlers';
+import { clearQueryCache } from '../../hooks/queryClient';
+const DEFAULT_SAVE_ERROR_MESSAGE = 'Failed to save session data';
+const CLEAR_STORAGE_ERROR = 'Failed to clear storage';
+
+/**
+ * Manage session state, persistence, and high-level multi-session operations.
+ *
+ * @param options - Session management configuration
+ */
+export const useSessionManagement = ({
+  oxyServices,
+  storage,
+  storageKeyPrefix,
+  loginSuccess,
+  logoutStore,
+  applyLanguagePreference,
+  onAuthStateChange,
+  onError,
+  setAuthError,
+  logger,
+  setTokenReady,
+  queryClient
+}) => {
+  const [sessions, setSessions] = useState([]);
+  const [activeSessionId, setActiveSessionId] = useState(null);
+  const refreshInFlightRef = useRef(null);
+  const removedSessionsRef = useRef(new Set());
+  const lastRefreshRef = useRef(0);
+  const storageKeys = useMemo(() => getStorageKeys(storageKeyPrefix), [storageKeyPrefix]);
+  const saveSessionIds = useCallback(async sessionIds => {
+    if (!storage) return;
+    try {
+      const uniqueIds = Array.from(new Set(sessionIds));
+      await storage.setItem(storageKeys.sessionIds, JSON.stringify(uniqueIds));
+    } catch (error) {
+      if (logger) {
+        logger(DEFAULT_SAVE_ERROR_MESSAGE, error);
+      } else if (__DEV__) {
+        console.warn('Failed to save session IDs:', error);
+      }
+    }
+  }, [logger, storage, storageKeys.sessionIds]);
+  const updateSessions = useCallback((incoming, options = {}) => {
+    setSessions(prevSessions => {
+      const processed = options.merge ? mergeSessions(prevSessions, incoming, activeSessionId, false) : normalizeAndSortSessions(incoming, activeSessionId, false);
+      if (storage) {
+        void saveSessionIds(processed.map(session => session.sessionId));
+      }
+      if (sessionsArraysEqual(prevSessions, processed)) {
+        return prevSessions;
+      }
+      return processed;
+    });
+  }, [activeSessionId, saveSessionIds, storage]);
+  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 removeActiveSessionId = useCallback(async () => {
+    if (!storage) return;
+    try {
+      await storage.removeItem(storageKeys.activeSessionId);
+    } 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);
+      // Clear identity sync state
+      await storage.removeItem('oxy_identity_synced').catch(() => {});
+    } 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 () => {
+    setSessions([]);
+    setActiveSessionId(null);
+    logoutStore();
+
+    // Clear TanStack Query cache (in-memory)
+    if (queryClient) {
+      queryClient.clear();
+    }
+
+    // Clear persisted query cache
+    if (storage) {
+      try {
+        await clearQueryCache(storage);
+      } catch (error) {
+        if (logger) {
+          logger('Failed to clear persisted query cache', error);
+        }
+      }
+    }
+    await clearSessionStorage();
+    onAuthStateChange?.(null);
+  }, [clearSessionStorage, logoutStore, onAuthStateChange, queryClient, storage, logger]);
+  const activateSession = useCallback(async (sessionId, user) => {
+    await oxyServices.getTokenBySession(sessionId);
+    setTokenReady?.(true);
+    setActiveSessionId(sessionId);
+    loginSuccess(user);
+    await saveActiveSessionId(sessionId);
+    await applyLanguagePreference(user);
+    onAuthStateChange?.(user);
+  }, [applyLanguagePreference, loginSuccess, onAuthStateChange, oxyServices, saveActiveSessionId, setTokenReady]);
+  const trackRemovedSession = useCallback(sessionId => {
+    removedSessionsRef.current.add(sessionId);
+    setTimeout(() => {
+      removedSessionsRef.current.delete(sessionId);
+    }, 5000);
+  }, []);
+  const findReplacementSession = useCallback(async sessionIds => {
+    if (!sessionIds.length) {
+      return null;
+    }
+    const validationResults = await validateSessionBatch(oxyServices, sessionIds, {
+      maxConcurrency: 3
+    });
+    const validSession = validationResults.find(result => result.valid);
+    if (!validSession) {
+      return null;
+    }
+    const validation = await oxyServices.validateSession(validSession.sessionId, {
+      useHeaderValidation: true
+    });
+    if (!validation?.valid || !validation.user) {
+      return null;
+    }
+    const user = validation.user;
+    await activateSession(validSession.sessionId, user);
+    return user;
+  }, [activateSession, oxyServices]);
+  const switchSession = useCallback(async sessionId => {
+    try {
+      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;
+      await activateSession(sessionId, user);
+      try {
+        const deviceSessions = await fetchSessionsWithFallback(oxyServices, sessionId, {
+          fallbackUserId: user.id,
+          logger
+        });
+        updateSessions(deviceSessions, {
+          merge: true
+        });
+      } catch (error) {
+        if (__DEV__) {
+          console.warn('Failed to synchronize sessions after switch:', error);
+        }
+      }
+      return user;
+    } catch (error) {
+      const invalidSession = isInvalidSessionError(error);
+      if (invalidSession) {
+        updateSessions(sessions.filter(session => session.sessionId !== sessionId), {
+          merge: false
+        });
+        if (sessionId === activeSessionId) {
+          const otherSessionIds = sessions.filter(session => session.sessionId !== sessionId && !removedSessionsRef.current.has(session.sessionId)).map(session => session.sessionId);
+          const replacementUser = await findReplacementSession(otherSessionIds);
+          if (replacementUser) {
+            return replacementUser;
+          }
+        }
+      }
+      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');
+    }
+  }, [activateSession, activeSessionId, findReplacementSession, logger, loginSuccess, onError, oxyServices, sessions, setAuthError, updateSessions]);
+  const refreshSessions = useCallback(async activeUserId => {
+    if (!activeSessionId) return;
+    if (refreshInFlightRef.current) {
+      await refreshInFlightRef.current;
+      return;
+    }
+    const now = Date.now();
+    if (now - lastRefreshRef.current < 500) {
+      return;
+    }
+    lastRefreshRef.current = now;
+    const refreshPromise = (async () => {
+      try {
+        const deviceSessions = await fetchSessionsWithFallback(oxyServices, activeSessionId, {
+          fallbackUserId: activeUserId,
+          logger
+        });
+        updateSessions(deviceSessions, {
+          merge: true
+        });
+      } catch (error) {
+        if (isInvalidSessionError(error)) {
+          const otherSessions = sessions.filter(session => session.sessionId !== activeSessionId && !removedSessionsRef.current.has(session.sessionId)).map(session => session.sessionId);
+          const replacementUser = await findReplacementSession(otherSessions);
+          if (!replacementUser) {
+            await clearSessionState();
+          }
+          return;
+        }
+        handleAuthError(error, {
+          defaultMessage: 'Failed to refresh sessions',
+          code: 'SESSION_REFRESH_ERROR',
+          onError,
+          setAuthError,
+          logger
+        });
+      } finally {
+        refreshInFlightRef.current = null;
+        lastRefreshRef.current = Date.now();
+      }
+    })();
+    refreshInFlightRef.current = refreshPromise;
+    await refreshPromise;
+  }, [activeSessionId, clearSessionState, findReplacementSession, logger, onError, oxyServices, sessions, setAuthError, updateSessions]);
+  const isRefreshInFlight = Boolean(refreshInFlightRef.current);
+  return {
+    sessions,
+    activeSessionId,
+    setActiveSessionId,
+    updateSessions,
+    switchSession,
+    refreshSessions,
+    clearSessionState,
+    saveActiveSessionId,
+    trackRemovedSession,
+    storageKeys,
+    isRefreshInFlight
+  };
+};
+//# sourceMappingURL=useSessionManagement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useRef","useState","mergeSessions","normalizeAndSortSessions","sessionsArraysEqual","fetchSessionsWithFallback","validateSessionBatch","getStorageKeys","handleAuthError","isInvalidSessionError","clearQueryCache","DEFAULT_SAVE_ERROR_MESSAGE","CLEAR_STORAGE_ERROR","useSessionManagement","oxyServices","storage","storageKeyPrefix","loginSuccess","logoutStore","applyLanguagePreference","onAuthStateChange","onError","setAuthError","logger","setTokenReady","queryClient","sessions","setSessions","activeSessionId","setActiveSessionId","refreshInFlightRef","removedSessionsRef","Set","lastRefreshRef","storageKeys","saveSessionIds","sessionIds","uniqueIds","Array","from","setItem","JSON","stringify","error","__DEV__","console","warn","updateSessions","incoming","options","prevSessions","processed","merge","map","session","sessionId","saveActiveSessionId","defaultMessage","code","removeActiveSessionId","removeItem","clearSessionStorage","catch","clearSessionState","clear","activateSession","user","getTokenBySession","trackRemovedSession","current","add","setTimeout","delete","findReplacementSession","length","validationResults","maxConcurrency","validSession","find","result","valid","validation","validateSession","useHeaderValidation","switchSession","Error","deviceSessions","fallbackUserId","id","invalidSession","filter","otherSessionIds","has","replacementUser","refreshSessions","activeUserId","now","Date","refreshPromise","otherSessions","isRefreshInFlight","Boolean"],"sourceRoot":"../../../../../src","sources":["ui/context/hooks/useSessionManagement.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,74 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { createPlatformStorage } from '../../utils/storageHelpers';
+import { extractErrorMessage } from '../../utils/errorHandlers';
+const DEFAULT_ERROR_CODE = 'STORAGE_INIT_ERROR';
+
+/**
+ * React hook that exposes a platform-agnostic storage reference.
+ * Handles initialization, error propagation, and lazy re-initialization.
+ *
+ * @param options - Optional configuration for error reporting and logging
+ */
+export const useStorage = ({
+  onError,
+  logger,
+  errorCode = DEFAULT_ERROR_CODE
+} = {}) => {
+  const [storage, setStorage] = useState(null);
+  const [error, setError] = useState(null);
+  const initializingRef = useRef(null);
+  const notifyError = useCallback(err => {
+    const message = extractErrorMessage(err, 'Failed to initialize storage');
+    setError(message);
+    if (logger) {
+      logger(message, err);
+    }
+    onError?.({
+      message,
+      code: errorCode,
+      status: 500
+    });
+  }, [errorCode, logger, onError]);
+  const createStorageInstance = useCallback(async () => {
+    try {
+      const platformStorage = await createPlatformStorage();
+      setStorage(platformStorage);
+      setError(null);
+      return platformStorage;
+    } catch (err) {
+      notifyError(err);
+      setStorage(null);
+      return null;
+    }
+  }, [notifyError]);
+  const refresh = useCallback(async () => {
+    if (!initializingRef.current) {
+      initializingRef.current = createStorageInstance().finally(() => {
+        initializingRef.current = null;
+      });
+    }
+    return initializingRef.current;
+  }, [createStorageInstance]);
+  useEffect(() => {
+    refresh().catch(err => {
+      notifyError(err);
+    });
+  }, [refresh, notifyError]);
+  const withStorage = useCallback(async callback => {
+    const resolvedStorage = storage ?? (await refresh());
+    if (!resolvedStorage) {
+      return null;
+    }
+    return callback(resolvedStorage);
+  }, [refresh, storage]);
+  return {
+    storage,
+    isReady: Boolean(storage) && !error,
+    error,
+    refresh,
+    withStorage
+  };
+};
+//# sourceMappingURL=useStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","createPlatformStorage","extractErrorMessage","DEFAULT_ERROR_CODE","useStorage","onError","logger","errorCode","storage","setStorage","error","setError","initializingRef","notifyError","err","message","code","status","createStorageInstance","platformStorage","refresh","current","finally","catch","withStorage","callback","resolvedStorage","isReady","Boolean"],"sourceRoot":"../../../../../src","sources":["ui/context/hooks/useStorage.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAEhE,SAASC,qBAAqB,QAA+B,4BAA4B;AACzF,SAASC,mBAAmB,QAAQ,2BAA2B;AAgB/D,MAAMC,kBAAkB,GAAG,oBAAoB;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAGA,CAAC;EACzBC,OAAO;EACPC,MAAM;EACNC,SAAS,GAAGJ;AACK,CAAC,GAAG,CAAC,CAAC,KAAuB;EAC9C,MAAM,CAACK,OAAO,EAAEC,UAAU,CAAC,GAAGT,QAAQ,CAA0B,IAAI,CAAC;EACrE,MAAM,CAACU,KAAK,EAAEC,QAAQ,CAAC,GAAGX,QAAQ,CAAgB,IAAI,CAAC;EACvD,MAAMY,eAAe,GAAGb,MAAM,CAA0C,IAAI,CAAC;EAE7E,MAAMc,WAAW,GAAGhB,WAAW,CAC5BiB,GAAY,IAAK;IAChB,MAAMC,OAAO,GAAGb,mBAAmB,CAACY,GAAG,EAAE,8BAA8B,CAAC;IACxEH,QAAQ,CAACI,OAAO,CAAC;IAEjB,IAAIT,MAAM,EAAE;MACVA,MAAM,CAACS,OAAO,EAAED,GAAG,CAAC;IACtB;IAEAT,OAAO,GAAG;MACRU,OAAO;MACPC,IAAI,EAAET,SAAS;MACfU,MAAM,EAAE;IACV,CAAC,CAAC;EACJ,CAAC,EACD,CAACV,SAAS,EAAED,MAAM,EAAED,OAAO,CAC7B,CAAC;EAED,MAAMa,qBAAqB,GAAGrB,WAAW,CAAC,YAA8C;IACtF,IAAI;MACF,MAAMsB,eAAe,GAAG,MAAMlB,qBAAqB,CAAC,CAAC;MACrDQ,UAAU,CAACU,eAAe,CAAC;MAC3BR,QAAQ,CAAC,IAAI,CAAC;MACd,OAAOQ,eAAe;IACxB,CAAC,CAAC,OAAOL,GAAG,EAAE;MACZD,WAAW,CAACC,GAAG,CAAC;MAChBL,UAAU,CAAC,IAAI,CAAC;MAChB,OAAO,IAAI;IACb;EACF,CAAC,EAAE,CAACI,WAAW,CAAC,CAAC;EAEjB,MAAMO,OAAO,GAAGvB,WAAW,CAAC,YAA8C;IACxE,IAAI,CAACe,eAAe,CAACS,OAAO,EAAE;MAC5BT,eAAe,CAACS,OAAO,GAAGH,qBAAqB,CAAC,CAAC,CAACI,OAAO,CAAC,MAAM;QAC9DV,eAAe,CAACS,OAAO,GAAG,IAAI;MAChC,CAAC,CAAC;IACJ;IAEA,OAAOT,eAAe,CAACS,OAAO;EAChC,CAAC,EAAE,CAACH,qBAAqB,CAAC,CAAC;EAE3BpB,SAAS,CAAC,MAAM;IACdsB,OAAO,CAAC,CAAC,CAACG,KAAK,CAAET,GAAG,IAAK;MACvBD,WAAW,CAACC,GAAG,CAAC;IAClB,CAAC,CAAC;EACJ,CAAC,EAAE,CAACM,OAAO,EAAEP,WAAW,CAAC,CAAC;EAE1B,MAAMW,WAAW,GAAG3B,WAAW,CAC7B,MAAW4B,QAA2D,IAAwB;IAC5F,MAAMC,eAAe,GAAGlB,OAAO,KAAK,MAAMY,OAAO,CAAC,CAAC,CAAC;IACpD,IAAI,CAACM,eAAe,EAAE;MACpB,OAAO,IAAI;IACb;IACA,OAAOD,QAAQ,CAACC,eAAe,CAAC;EAClC,CAAC,EACD,CAACN,OAAO,EAAEZ,OAAO,CACnB,CAAC;EAED,OAAO;IACLA,OAAO;IACPmB,OAAO,EAAEC,OAAO,CAACpB,OAAO,CAAC,IAAI,CAACE,KAAK;IACnCA,KAAK;IACLU,OAAO;IACPI;EACF,CAAC;AACH,CAAC","ignoreList":[]}

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

@@ -0,0 +1,7 @@
+"use strict";
+
+export { useFollow, useFollowerCounts } from './useFollow';
+export { useFileDownloadUrl, setOxyFileUrlInstance } from './useFileDownloadUrl';
+export { useThemeStyles } from './useThemeStyles';
+export { useThemeColors } from './useThemeColors';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useFollow","useFollowerCounts","useFileDownloadUrl","setOxyFileUrlInstance","useThemeStyles","useThemeColors"],"sourceRoot":"../../../../src","sources":["ui/hooks/index.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,iBAAiB,QAAQ,aAAa;AAC1D,SAASC,kBAAkB,EAAEC,qBAAqB,QAAQ,sBAAsB;AAChF,SAASC,cAAc,QAAQ,kBAAkB;AACjD,SAASC,cAAc,QAAQ,kBAAkB","ignoreList":[]}

package/lib/module/ui/hooks/mutations/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * Mutation Hooks
+ * 
+ * TanStack Query mutation hooks for updating Oxy services data.
+ * All mutations handle authentication, error handling, and query invalidation.
+ */
+
+// Account mutation hooks
+export { useUpdateProfile, useUploadAvatar, useUpdateAccountSettings, useUpdatePrivacySettings, useUploadFile } from './useAccountMutations';
+
+// Service mutation hooks (sessions, devices)
+export { useSwitchSession, useLogoutSession, useLogoutAll, useUpdateDeviceName, useRemoveDevice } from './useServicesMutations';
+//# sourceMappingURL=index.js.map

package/lib/module/ui/hooks/mutations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useUpdateProfile","useUploadAvatar","useUpdateAccountSettings","useUpdatePrivacySettings","useUploadFile","useSwitchSession","useLogoutSession","useLogoutAll","useUpdateDeviceName","useRemoveDevice"],"sourceRoot":"../../../../../src","sources":["ui/hooks/mutations/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SACEA,gBAAgB,EAChBC,eAAe,EACfC,wBAAwB,EACxBC,wBAAwB,EACxBC,aAAa,QACR,uBAAuB;;AAE9B;AACA,SACEC,gBAAgB,EAChBC,gBAAgB,EAChBC,YAAY,EACZC,mBAAmB,EACnBC,eAAe,QACV,wBAAwB","ignoreList":[]}