@oxyhq/services 5.14.0 → 5.15.0

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

@@ -0,0 +1,112 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useLanguageManagement = void 0;
+var _react = require("react");
+var _languageUtils = require("../../../utils/languageUtils");
+var _errorHandlers = require("../utils/errorHandlers");
+const DEFAULT_LANGUAGE = 'en-US';
+
+/**
+ * Manage UI language state, persistence, and metadata derivation.
+ *
+ * @param options - Configuration for storage access and error reporting
+ */
+const useLanguageManagement = ({
+  storage,
+  languageKey,
+  onError,
+  logger
+}) => {
+  const [currentLanguage, setCurrentLanguage] = (0, _react.useState)(DEFAULT_LANGUAGE);
+  const loadLanguageFromStorage = (0, _react.useCallback)(async () => {
+    if (!storage) {
+      return;
+    }
+    try {
+      const savedLanguageRaw = await storage.getItem(languageKey);
+      const normalized = (0, _languageUtils.normalizeLanguageCode)(savedLanguageRaw) || savedLanguageRaw;
+      if (normalized) {
+        setCurrentLanguage(normalized);
+      }
+    } catch (error) {
+      const message = (0, _errorHandlers.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]);
+  (0, _react.useEffect)(() => {
+    loadLanguageFromStorage().catch(error => {
+      if (logger) {
+        logger('Unexpected error loading language', error);
+      }
+    });
+  }, [loadLanguageFromStorage, logger]);
+  const setLanguage = (0, _react.useCallback)(async languageId => {
+    if (!storage) {
+      throw new Error('Storage not initialized');
+    }
+    const normalized = (0, _languageUtils.normalizeLanguageCode)(languageId) || languageId;
+    try {
+      await storage.setItem(languageKey, normalized);
+      setCurrentLanguage(normalized);
+    } catch (error) {
+      const message = (0, _errorHandlers.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 = (0, _react.useCallback)(async user => {
+    if (!storage || !user) {
+      return;
+    }
+    const userLanguage = user?.language;
+    if (!userLanguage) {
+      return;
+    }
+    try {
+      const normalized = (0, _languageUtils.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 = (0, _react.useMemo)(() => (0, _languageUtils.getLanguageMetadata)(currentLanguage), [currentLanguage]);
+  const languageName = (0, _react.useMemo)(() => (0, _languageUtils.getLanguageName)(currentLanguage), [currentLanguage]);
+  const nativeLanguageName = (0, _react.useMemo)(() => (0, _languageUtils.getNativeLanguageName)(currentLanguage), [currentLanguage]);
+  return {
+    currentLanguage,
+    metadata,
+    languageName,
+    nativeLanguageName,
+    setLanguage,
+    applyLanguagePreference,
+    hydrateLanguage: loadLanguageFromStorage
+  };
+};
+exports.useLanguageManagement = useLanguageManagement;
+//# sourceMappingURL=useLanguageManagement.js.map

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

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

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

@@ -0,0 +1,261 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSessionManagement = void 0;
+var _react = require("react");
+var _sessionUtils = require("../../../utils/sessionUtils");
+var _sessionHelpers = require("../utils/sessionHelpers");
+var _storageHelpers = require("../utils/storageHelpers");
+var _errorHandlers = require("../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
+ */
+const useSessionManagement = ({
+  oxyServices,
+  storage,
+  storageKeyPrefix,
+  loginSuccess,
+  logoutStore,
+  applyLanguagePreference,
+  onAuthStateChange,
+  onError,
+  setAuthError,
+  logger,
+  setTokenReady
+}) => {
+  const [sessions, setSessions] = (0, _react.useState)([]);
+  const [activeSessionId, setActiveSessionId] = (0, _react.useState)(null);
+  const refreshInFlightRef = (0, _react.useRef)(null);
+  const removedSessionsRef = (0, _react.useRef)(new Set());
+  const lastRefreshRef = (0, _react.useRef)(0);
+  const storageKeys = (0, _react.useMemo)(() => (0, _storageHelpers.getStorageKeys)(storageKeyPrefix), [storageKeyPrefix]);
+  const saveSessionIds = (0, _react.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 = (0, _react.useCallback)((incoming, options = {}) => {
+    setSessions(prevSessions => {
+      const processed = options.merge ? (0, _sessionUtils.mergeSessions)(prevSessions, incoming, activeSessionId, false) : (0, _sessionUtils.normalizeAndSortSessions)(incoming, activeSessionId, false);
+      if (storage) {
+        void saveSessionIds(processed.map(session => session.sessionId));
+      }
+      if ((0, _sessionUtils.sessionsArraysEqual)(prevSessions, processed)) {
+        return prevSessions;
+      }
+      return processed;
+    });
+  }, [activeSessionId, saveSessionIds, storage]);
+  const saveActiveSessionId = (0, _react.useCallback)(async sessionId => {
+    if (!storage) return;
+    try {
+      await storage.setItem(storageKeys.activeSessionId, sessionId);
+    } catch (error) {
+      (0, _errorHandlers.handleAuthError)(error, {
+        defaultMessage: DEFAULT_SAVE_ERROR_MESSAGE,
+        code: 'SESSION_PERSISTENCE_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+    }
+  }, [logger, onError, setAuthError, storage, storageKeys.activeSessionId]);
+  const removeActiveSessionId = (0, _react.useCallback)(async () => {
+    if (!storage) return;
+    try {
+      await storage.removeItem(storageKeys.activeSessionId);
+    } catch (error) {
+      (0, _errorHandlers.handleAuthError)(error, {
+        defaultMessage: DEFAULT_SAVE_ERROR_MESSAGE,
+        code: 'SESSION_PERSISTENCE_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+    }
+  }, [logger, onError, setAuthError, storage, storageKeys.activeSessionId]);
+  const clearSessionStorage = (0, _react.useCallback)(async () => {
+    if (!storage) return;
+    try {
+      await storage.removeItem(storageKeys.activeSessionId);
+      await storage.removeItem(storageKeys.sessionIds);
+    } catch (error) {
+      (0, _errorHandlers.handleAuthError)(error, {
+        defaultMessage: CLEAR_STORAGE_ERROR,
+        code: 'STORAGE_ERROR',
+        onError,
+        setAuthError,
+        logger
+      });
+    }
+  }, [logger, onError, setAuthError, storage, storageKeys.activeSessionId, storageKeys.sessionIds]);
+  const clearSessionState = (0, _react.useCallback)(async () => {
+    setSessions([]);
+    setActiveSessionId(null);
+    logoutStore();
+    await clearSessionStorage();
+    onAuthStateChange?.(null);
+  }, [clearSessionStorage, logoutStore, onAuthStateChange]);
+  const activateSession = (0, _react.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 = (0, _react.useCallback)(sessionId => {
+    removedSessionsRef.current.add(sessionId);
+    setTimeout(() => {
+      removedSessionsRef.current.delete(sessionId);
+    }, 5000);
+  }, []);
+  const findReplacementSession = (0, _react.useCallback)(async sessionIds => {
+    if (!sessionIds.length) {
+      return null;
+    }
+    const validationResults = await (0, _sessionHelpers.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 = (0, _react.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 (0, _sessionHelpers.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 = (0, _errorHandlers.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;
+          }
+        }
+      }
+      (0, _errorHandlers.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 = (0, _react.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 (0, _sessionHelpers.fetchSessionsWithFallback)(oxyServices, activeSessionId, {
+          fallbackUserId: activeUserId,
+          logger
+        });
+        updateSessions(deviceSessions, {
+          merge: true
+        });
+      } catch (error) {
+        if ((0, _errorHandlers.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;
+        }
+        (0, _errorHandlers.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
+  };
+};
+exports.useSessionManagement = useSessionManagement;
+//# sourceMappingURL=useSessionManagement.js.map

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

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

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

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useStorage = void 0;
+var _react = require("react");
+var _storageHelpers = require("../utils/storageHelpers");
+var _errorHandlers = require("../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
+ */
+const useStorage = ({
+  onError,
+  logger,
+  errorCode = DEFAULT_ERROR_CODE
+} = {}) => {
+  const [storage, setStorage] = (0, _react.useState)(null);
+  const [error, setError] = (0, _react.useState)(null);
+  const initializingRef = (0, _react.useRef)(null);
+  const notifyError = (0, _react.useCallback)(err => {
+    const message = (0, _errorHandlers.extractErrorMessage)(err, 'Failed to initialize storage');
+    setError(message);
+    if (logger) {
+      logger(message, err);
+    }
+    onError?.({
+      message,
+      code: errorCode,
+      status: 500
+    });
+  }, [errorCode, logger, onError]);
+  const createStorageInstance = (0, _react.useCallback)(async () => {
+    try {
+      const platformStorage = await (0, _storageHelpers.createPlatformStorage)();
+      setStorage(platformStorage);
+      setError(null);
+      return platformStorage;
+    } catch (err) {
+      notifyError(err);
+      setStorage(null);
+      return null;
+    }
+  }, [notifyError]);
+  const refresh = (0, _react.useCallback)(async () => {
+    if (!initializingRef.current) {
+      initializingRef.current = createStorageInstance().finally(() => {
+        initializingRef.current = null;
+      });
+    }
+    return initializingRef.current;
+  }, [createStorageInstance]);
+  (0, _react.useEffect)(() => {
+    refresh().catch(err => {
+      notifyError(err);
+    });
+  }, [refresh, notifyError]);
+  const withStorage = (0, _react.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
+  };
+};
+exports.useStorage = useStorage;
+//# sourceMappingURL=useStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_storageHelpers","_errorHandlers","DEFAULT_ERROR_CODE","useStorage","onError","logger","errorCode","storage","setStorage","useState","error","setError","initializingRef","useRef","notifyError","useCallback","err","message","extractErrorMessage","code","status","createStorageInstance","platformStorage","createPlatformStorage","refresh","current","finally","useEffect","catch","withStorage","callback","resolvedStorage","isReady","Boolean","exports"],"sourceRoot":"../../../../../src","sources":["ui/context/hooks/useStorage.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,eAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AAgBA,MAAMG,kBAAkB,GAAG,oBAAoB;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,UAAU,GAAGA,CAAC;EACzBC,OAAO;EACPC,MAAM;EACNC,SAAS,GAAGJ;AACK,CAAC,GAAG,CAAC,CAAC,KAAuB;EAC9C,MAAM,CAACK,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAC,eAAQ,EAA0B,IAAI,CAAC;EACrE,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAG,IAAAF,eAAQ,EAAgB,IAAI,CAAC;EACvD,MAAMG,eAAe,GAAG,IAAAC,aAAM,EAA0C,IAAI,CAAC;EAE7E,MAAMC,WAAW,GAAG,IAAAC,kBAAW,EAC5BC,GAAY,IAAK;IAChB,MAAMC,OAAO,GAAG,IAAAC,kCAAmB,EAACF,GAAG,EAAE,8BAA8B,CAAC;IACxEL,QAAQ,CAACM,OAAO,CAAC;IAEjB,IAAIZ,MAAM,EAAE;MACVA,MAAM,CAACY,OAAO,EAAED,GAAG,CAAC;IACtB;IAEAZ,OAAO,GAAG;MACRa,OAAO;MACPE,IAAI,EAAEb,SAAS;MACfc,MAAM,EAAE;IACV,CAAC,CAAC;EACJ,CAAC,EACD,CAACd,SAAS,EAAED,MAAM,EAAED,OAAO,CAC7B,CAAC;EAED,MAAMiB,qBAAqB,GAAG,IAAAN,kBAAW,EAAC,YAA8C;IACtF,IAAI;MACF,MAAMO,eAAe,GAAG,MAAM,IAAAC,qCAAqB,EAAC,CAAC;MACrDf,UAAU,CAACc,eAAe,CAAC;MAC3BX,QAAQ,CAAC,IAAI,CAAC;MACd,OAAOW,eAAe;IACxB,CAAC,CAAC,OAAON,GAAG,EAAE;MACZF,WAAW,CAACE,GAAG,CAAC;MAChBR,UAAU,CAAC,IAAI,CAAC;MAChB,OAAO,IAAI;IACb;EACF,CAAC,EAAE,CAACM,WAAW,CAAC,CAAC;EAEjB,MAAMU,OAAO,GAAG,IAAAT,kBAAW,EAAC,YAA8C;IACxE,IAAI,CAACH,eAAe,CAACa,OAAO,EAAE;MAC5Bb,eAAe,CAACa,OAAO,GAAGJ,qBAAqB,CAAC,CAAC,CAACK,OAAO,CAAC,MAAM;QAC9Dd,eAAe,CAACa,OAAO,GAAG,IAAI;MAChC,CAAC,CAAC;IACJ;IAEA,OAAOb,eAAe,CAACa,OAAO;EAChC,CAAC,EAAE,CAACJ,qBAAqB,CAAC,CAAC;EAE3B,IAAAM,gBAAS,EAAC,MAAM;IACdH,OAAO,CAAC,CAAC,CAACI,KAAK,CAAEZ,GAAG,IAAK;MACvBF,WAAW,CAACE,GAAG,CAAC;IAClB,CAAC,CAAC;EACJ,CAAC,EAAE,CAACQ,OAAO,EAAEV,WAAW,CAAC,CAAC;EAE1B,MAAMe,WAAW,GAAG,IAAAd,kBAAW,EAC7B,MAAWe,QAA2D,IAAwB;IAC5F,MAAMC,eAAe,GAAGxB,OAAO,KAAK,MAAMiB,OAAO,CAAC,CAAC,CAAC;IACpD,IAAI,CAACO,eAAe,EAAE;MACpB,OAAO,IAAI;IACb;IACA,OAAOD,QAAQ,CAACC,eAAe,CAAC;EAClC,CAAC,EACD,CAACP,OAAO,EAAEjB,OAAO,CACnB,CAAC;EAED,OAAO;IACLA,OAAO;IACPyB,OAAO,EAAEC,OAAO,CAAC1B,OAAO,CAAC,IAAI,CAACG,KAAK;IACnCA,KAAK;IACLc,OAAO;IACPK;EACF,CAAC;AACH,CAAC;AAACK,OAAA,CAAA/B,UAAA,GAAAA,UAAA","ignoreList":[]}

package/lib/commonjs/ui/context/utils/errorHandlers.js

@@ -0,0 +1,90 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isInvalidSessionError = exports.handleAuthError = exports.extractErrorMessage = void 0;
+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.
+ */
+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
+ */
+exports.isInvalidSessionError = isInvalidSessionError;
+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
+ */
+exports.extractErrorMessage = extractErrorMessage;
+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;
+};
+exports.handleAuthError = handleAuthError;
+//# sourceMappingURL=errorHandlers.js.map

package/lib/commonjs/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","exports","fallbackMessage","trim","length","withMessage","message","withResponse","responseMessage","data","handleAuthError","defaultMessage","code","onError","setAuthError","logger","resolvedStatus"],"sourceRoot":"../../../../../src","sources":["ui/context/utils/errorHandlers.ts"],"mappings":"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","ignoreList":[]}