@oxyhq/services 5.14.0 → 5.15.0

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,256 @@
+"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';
+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
+}) => {
+  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);
+    } 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();
+    await clearSessionStorage();
+    onAuthStateChange?.(null);
+  }, [clearSessionStorage, logoutStore, onAuthStateChange]);
+  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","DEFAULT_SAVE_ERROR_MESSAGE","CLEAR_STORAGE_ERROR","useSessionManagement","oxyServices","storage","storageKeyPrefix","loginSuccess","logoutStore","applyLanguagePreference","onAuthStateChange","onError","setAuthError","logger","setTokenReady","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","clearSessionState","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,yBAAyB;AACtF,SAASC,mBAAmB,QAAQ,wBAAwB;AAgB5D,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/context/utils/errorHandlers.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const DEFAULT_INVALID_SESSION_MESSAGES = ['Invalid or expired session', 'Session is invalid', 'Session not found', 'Session expired'];
+const isObject = value => typeof value === 'object' && value !== null;
+const getResponseStatus = error => {
+  if (!isObject(error)) return undefined;
+  const response = error.response;
+  return response?.status;
+};
+
+/**
+ * Determine whether the error represents an invalid session condition.
+ * This centralizes 401 detection across different fetch clients.
+ */
+export const isInvalidSessionError = error => {
+  const status = getResponseStatus(error);
+  if (status === 401) {
+    return true;
+  }
+  if (!isObject(error)) {
+    return false;
+  }
+  const normalizedMessage = extractErrorMessage(error)?.toLowerCase();
+  if (!normalizedMessage) {
+    return false;
+  }
+  return DEFAULT_INVALID_SESSION_MESSAGES.some(msg => normalizedMessage.includes(msg.toLowerCase()));
+};
+
+/**
+ * Extract a consistent error message from unknown error shapes.
+ *
+ * @param error - The unknown error payload
+ * @param fallbackMessage - Message to return when no concrete message is available
+ */
+export const extractErrorMessage = (error, fallbackMessage = 'Unexpected error') => {
+  if (typeof error === 'string' && error.trim().length > 0) {
+    return error;
+  }
+  if (!isObject(error)) {
+    return fallbackMessage;
+  }
+  const withMessage = error;
+  if (withMessage.message && withMessage.message.trim().length > 0) {
+    return withMessage.message;
+  }
+  const withResponse = error;
+  const responseMessage = withResponse.response?.data?.message ?? withResponse.response?.data?.error;
+  if (typeof responseMessage === 'string' && responseMessage.trim().length > 0) {
+    return responseMessage;
+  }
+  return fallbackMessage;
+};
+
+/**
+ * Centralized error handler for auth-related operations.
+ *
+ * @param error - Unknown error object
+ * @param options - Error handling configuration
+ * @returns Resolved error message
+ */
+export const handleAuthError = (error, {
+  defaultMessage,
+  code,
+  status,
+  onError,
+  setAuthError,
+  logger
+}) => {
+  const resolvedStatus = status ?? getResponseStatus(error) ?? (isInvalidSessionError(error) ? 401 : 500);
+  const message = extractErrorMessage(error, defaultMessage);
+  if (logger) {
+    logger(message, error);
+  }
+  setAuthError?.(message);
+  onError?.({
+    message,
+    code,
+    status: resolvedStatus
+  });
+  return message;
+};
+//# sourceMappingURL=errorHandlers.js.map

package/lib/module/ui/context/utils/errorHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_INVALID_SESSION_MESSAGES","isObject","value","getResponseStatus","error","undefined","response","status","isInvalidSessionError","normalizedMessage","extractErrorMessage","toLowerCase","some","msg","includes","fallbackMessage","trim","length","withMessage","message","withResponse","responseMessage","data","handleAuthError","defaultMessage","code","onError","setAuthError","logger","resolvedStatus"],"sourceRoot":"../../../../../src","sources":["ui/context/utils/errorHandlers.ts"],"mappings":";;AAyBA,MAAMA,gCAAgC,GAAG,CACvC,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,CAClB;AAED,MAAMC,QAAQ,GAAIC,KAAc,IAC9B,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI;AAE7C,MAAMC,iBAAiB,GAAIC,KAAc,IAAyB;EAChE,IAAI,CAACH,QAAQ,CAACG,KAAK,CAAC,EAAE,OAAOC,SAAS;EACtC,MAAMC,QAAQ,GAAIF,KAAK,CAAuBE,QAAQ;EACtD,OAAOA,QAAQ,EAAEC,MAAM;AACzB,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,GAAIJ,KAAc,IAAc;EAChE,MAAMG,MAAM,GAAGJ,iBAAiB,CAACC,KAAK,CAAC;EACvC,IAAIG,MAAM,KAAK,GAAG,EAAE;IAClB,OAAO,IAAI;EACb;EAEA,IAAI,CAACN,QAAQ,CAACG,KAAK,CAAC,EAAE;IACpB,OAAO,KAAK;EACd;EAEA,MAAMK,iBAAiB,GAAGC,mBAAmB,CAACN,KAAK,CAAC,EAAEO,WAAW,CAAC,CAAC;EACnE,IAAI,CAACF,iBAAiB,EAAE;IACtB,OAAO,KAAK;EACd;EAEA,OAAOT,gCAAgC,CAACY,IAAI,CAAEC,GAAG,IAC/CJ,iBAAiB,CAACK,QAAQ,CAACD,GAAG,CAACF,WAAW,CAAC,CAAC,CAC9C,CAAC;AACH,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMD,mBAAmB,GAAGA,CACjCN,KAAc,EACdW,eAAe,GAAG,kBAAkB,KACzB;EACX,IAAI,OAAOX,KAAK,KAAK,QAAQ,IAAIA,KAAK,CAACY,IAAI,CAAC,CAAC,CAACC,MAAM,GAAG,CAAC,EAAE;IACxD,OAAOb,KAAK;EACd;EAEA,IAAI,CAACH,QAAQ,CAACG,KAAK,CAAC,EAAE;IACpB,OAAOW,eAAe;EACxB;EAEA,MAAMG,WAAW,GAAGd,KAAyB;EAC7C,IAAIc,WAAW,CAACC,OAAO,IAAID,WAAW,CAACC,OAAO,CAACH,IAAI,CAAC,CAAC,CAACC,MAAM,GAAG,CAAC,EAAE;IAChE,OAAOC,WAAW,CAACC,OAAO;EAC5B;EAEA,MAAMC,YAAY,GAAGhB,KAA0B;EAC/C,MAAMiB,eAAe,GACnBD,YAAY,CAACd,QAAQ,EAAEgB,IAAI,EAAEH,OAAO,IAAIC,YAAY,CAACd,QAAQ,EAAEgB,IAAI,EAAElB,KAAK;EAE5E,IAAI,OAAOiB,eAAe,KAAK,QAAQ,IAAIA,eAAe,CAACL,IAAI,CAAC,CAAC,CAACC,MAAM,GAAG,CAAC,EAAE;IAC5E,OAAOI,eAAe;EACxB;EAEA,OAAON,eAAe;AACxB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMQ,eAAe,GAAGA,CAC7BnB,KAAc,EACd;EACEoB,cAAc;EACdC,IAAI;EACJlB,MAAM;EACNmB,OAAO;EACPC,YAAY;EACZC;AACsB,CAAC,KACd;EACX,MAAMC,cAAc,GAAGtB,MAAM,IAAIJ,iBAAiB,CAACC,KAAK,CAAC,KAAKI,qBAAqB,CAACJ,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;EACvG,MAAMe,OAAO,GAAGT,mBAAmB,CAACN,KAAK,EAAEoB,cAAc,CAAC;EAE1D,IAAII,MAAM,EAAE;IACVA,MAAM,CAACT,OAAO,EAAEf,KAAK,CAAC;EACxB;EAEAuB,YAAY,GAAGR,OAAO,CAAC;EAEvBO,OAAO,GAAG;IACRP,OAAO;IACPM,IAAI;IACJlB,MAAM,EAAEsB;EACV,CAAC,CAAC;EAEF,OAAOV,OAAO;AAChB,CAAC","ignoreList":[]}

package/lib/module/ui/context/utils/sessionHelpers.js

@@ -0,0 +1,96 @@
+"use strict";
+
+/**
+ * Normalize backend session payloads into `ClientSession` objects.
+ *
+ * @param sessions - Raw session array returned from the API
+ * @param fallbackDeviceId - Device identifier to use when missing from payload
+ * @param fallbackUserId - User identifier to use when missing from payload
+ */
+export const mapSessionsToClient = (sessions, fallbackDeviceId, fallbackUserId) => {
+  const now = new Date();
+  return sessions.map(session => ({
+    sessionId: session.sessionId,
+    deviceId: session.deviceId || fallbackDeviceId || '',
+    expiresAt: session.expiresAt || new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000).toISOString(),
+    lastActive: session.lastActive || now.toISOString(),
+    userId: session.user?.id || session.userId || (session.user?._id ? session.user._id.toString() : undefined) || fallbackUserId || '',
+    isCurrent: Boolean(session.isCurrent)
+  }));
+};
+
+/**
+ * Fetch device sessions with fallback to the legacy session endpoint when needed.
+ *
+ * @param oxyServices - Oxy service instance
+ * @param sessionId - Session identifier to fetch
+ * @param options - Optional fallback options
+ */
+export const fetchSessionsWithFallback = async (oxyServices, sessionId, {
+  fallbackDeviceId,
+  fallbackUserId,
+  logger
+} = {}) => {
+  try {
+    const deviceSessions = await oxyServices.getDeviceSessions(sessionId);
+    return mapSessionsToClient(deviceSessions, fallbackDeviceId, fallbackUserId);
+  } catch (error) {
+    if (__DEV__ && logger) {
+      logger('Failed to get device sessions, falling back to user sessions', error);
+    } else if (__DEV__) {
+      console.warn('Failed to get device sessions, falling back to user sessions:', error);
+    }
+    const userSessions = await oxyServices.getSessionsBySessionId(sessionId);
+    return mapSessionsToClient(userSessions, fallbackDeviceId, fallbackUserId);
+  }
+};
+
+/**
+ * Validate multiple sessions concurrently with configurable concurrency.
+ *
+ * @param oxyServices - Oxy service instance
+ * @param sessionIds - Session identifiers to validate
+ * @param options - Validation options
+ */
+export const validateSessionBatch = async (oxyServices, sessionIds, {
+  useHeaderValidation = true,
+  maxConcurrency = 5
+} = {}) => {
+  if (!sessionIds.length) {
+    return [];
+  }
+  const uniqueSessionIds = Array.from(new Set(sessionIds));
+  const safeConcurrency = Math.max(1, Math.min(maxConcurrency, uniqueSessionIds.length));
+  const results = [];
+  let index = 0;
+  const worker = async () => {
+    while (index < uniqueSessionIds.length) {
+      const currentIndex = index;
+      index += 1;
+      const sessionId = uniqueSessionIds[currentIndex];
+      try {
+        const validation = await oxyServices.validateSession(sessionId, {
+          useHeaderValidation
+        });
+        const valid = Boolean(validation?.valid);
+        results.push({
+          sessionId,
+          valid,
+          user: validation?.user,
+          raw: validation
+        });
+      } catch (error) {
+        results.push({
+          sessionId,
+          valid: false,
+          error
+        });
+      }
+    }
+  };
+  await Promise.all(Array.from({
+    length: safeConcurrency
+  }, worker));
+  return results;
+};
+//# sourceMappingURL=sessionHelpers.js.map

package/lib/module/ui/context/utils/sessionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mapSessionsToClient","sessions","fallbackDeviceId","fallbackUserId","now","Date","map","session","sessionId","deviceId","expiresAt","getTime","toISOString","lastActive","userId","user","id","_id","toString","undefined","isCurrent","Boolean","fetchSessionsWithFallback","oxyServices","logger","deviceSessions","getDeviceSessions","error","__DEV__","console","warn","userSessions","getSessionsBySessionId","validateSessionBatch","sessionIds","useHeaderValidation","maxConcurrency","length","uniqueSessionIds","Array","from","Set","safeConcurrency","Math","max","min","results","index","worker","currentIndex","validation","validateSession","valid","push","raw","Promise","all"],"sourceRoot":"../../../../../src","sources":["ui/context/utils/sessionHelpers.ts"],"mappings":"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","ignoreList":[]}