@oxyhq/services 5.17.0 → 5.17.3

package/lib/typescript/ui/context/OxyContextBase.d.ts

@@ -0,0 +1,99 @@
+import type { ReactNode } from 'react';
+import type { OxyServices } from '../../core';
+import type { User, ApiError } from '../../models/interfaces';
+import type { ClientSession } from '../../models/session';
+import type { UseFollowHook } from '../hooks/useFollow.types';
+import type { useLanguageManagement } from '../hooks/useLanguageManagement';
+import type { RouteName } from '../navigation/routes';
+import type { BackupData } from '../../crypto';
+export interface OxyContextState {
+    user: User | null;
+    sessions: ClientSession[];
+    activeSessionId: string | null;
+    currentDeviceId: string | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    isTokenReady: boolean;
+    isStorageReady: boolean;
+    error: string | null;
+    currentLanguage: string;
+    currentLanguageMetadata: ReturnType<typeof useLanguageManagement>['metadata'];
+    currentLanguageName: string;
+    currentNativeLanguageName: string;
+    createIdentity: () => Promise<{
+        synced: boolean;
+    }>;
+    importIdentity: (backupData: BackupData, password: string) => Promise<{
+        synced: boolean;
+    }>;
+    signIn: (deviceName?: string) => Promise<User>;
+    hasIdentity: () => Promise<boolean>;
+    getPublicKey: () => Promise<string | null>;
+    isIdentitySynced: () => Promise<boolean>;
+    syncIdentity: () => Promise<User>;
+    deleteIdentityAndClearAccount: (skipBackup?: boolean, force?: boolean, userConfirmed?: boolean) => Promise<void>;
+    storeTransferCode: (transferId: string, code: string, sourceDeviceId: string | null, publicKey: string) => Promise<void>;
+    getTransferCode: (transferId: string) => {
+        code: string;
+        sourceDeviceId: string | null;
+        publicKey: string;
+        timestamp: number;
+        state: 'pending' | 'completed' | 'failed';
+    } | null;
+    clearTransferCode: (transferId: string) => Promise<void>;
+    getAllPendingTransfers: () => Array<{
+        transferId: string;
+        data: {
+            code: string;
+            sourceDeviceId: string | null;
+            publicKey: string;
+            timestamp: number;
+            state: 'pending' | 'completed' | 'failed';
+        };
+    }>;
+    getActiveTransferId: () => string | null;
+    updateTransferState: (transferId: string, state: 'pending' | 'completed' | 'failed') => Promise<void>;
+    identitySyncState: {
+        isSynced: boolean;
+        isSyncing: boolean;
+    };
+    logout: (targetSessionId?: string) => Promise<void>;
+    logoutAll: () => Promise<void>;
+    switchSession: (sessionId: string) => Promise<void>;
+    removeSession: (sessionId: string) => Promise<void>;
+    refreshSessions: () => Promise<void>;
+    setLanguage: (languageId: string) => Promise<void>;
+    getDeviceSessions: () => Promise<Array<{
+        sessionId: string;
+        deviceId: string;
+        deviceName?: string;
+        lastActive?: string;
+        expiresAt?: string;
+    }>>;
+    logoutAllDeviceSessions: () => Promise<void>;
+    updateDeviceName: (deviceName: string) => Promise<void>;
+    clearSessionState: () => Promise<void>;
+    clearAllAccountData: () => Promise<void>;
+    oxyServices: OxyServices;
+    useFollow?: UseFollowHook;
+    showBottomSheet?: (screenOrConfig: RouteName | {
+        screen: RouteName;
+        props?: Record<string, unknown>;
+    }) => void;
+    openAvatarPicker: () => void;
+}
+export declare const OxyContext: import("react").Context<OxyContextState | null>;
+export interface OxyContextProviderProps {
+    children: ReactNode;
+    oxyServices?: OxyServices;
+    baseURL?: string;
+    storageKeyPrefix?: string;
+    onAuthStateChange?: (user: User | null) => void;
+    onError?: (error: ApiError) => void;
+}
+/**
+ * Hook to access the Oxy context.
+ * Must be used within an OxyContextProvider.
+ */
+export declare const useOxy: () => OxyContextState;
+//# sourceMappingURL=OxyContextBase.d.ts.map

package/lib/typescript/ui/context/OxyContextBase.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/services",
-  "version": "5.17.0",
+  "version": "5.17.3",
   "description": "Reusable OxyHQ module to handle authentication, user management, karma system, device-based session management and more 🚀",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/ui/components/OxyProvider.tsx

@@ -10,7 +10,6 @@ import { setupFonts } from './FontLoader';
 import BottomSheetRouter from './BottomSheetRouter';
 import { Toaster } from '../../lib/sonner';
 import { createQueryClient } from '../hooks/queryClient';
-import { useStorage } from '../hooks/useStorage';
 
 // Initialize fonts automatically
 setupFonts();
@@ -34,26 +33,20 @@ const OxyProvider: FC<OxyProviderProps> = ({
     // bottom sheet experience is removed. At the moment both modes behave the same.
     void contextOnly;
 
-    // Get storage for query persistence
-    const { storage, isReady: isStorageReady } = useStorage();
-    
-    // Initialize React Query Client with persistence
+    // Initialize React Query Client (in-memory; persistence handled separately if needed)
     const queryClientRef = useRef<ReturnType<typeof createQueryClient> | null>(null);
-    const [queryClient, setQueryClient] = useState<ReturnType<typeof createQueryClient> | null>(null);
+    const [queryClient, setQueryClient] = useState<ReturnType<typeof createQueryClient>>(
+        () => providedQueryClient ?? createQueryClient(),
+    );
 
     useEffect(() => {
-        if (providedQueryClient) {
+        if (providedQueryClient && queryClientRef.current !== providedQueryClient) {
             queryClientRef.current = providedQueryClient;
             setQueryClient(providedQueryClient);
-        } else if (isStorageReady) {
-            // Create query client with persistence once storage is ready
-            if (!queryClientRef.current) {
-                const client = createQueryClient(storage);
-                queryClientRef.current = client;
-                setQueryClient(client);
-            }
+        } else if (!queryClientRef.current) {
+            queryClientRef.current = queryClient;
         }
-    }, [providedQueryClient, isStorageReady, storage]);
+    }, [providedQueryClient, queryClient]);
 
     // Hook React Query focus manager into React Native AppState
     useEffect(() => {
@@ -114,12 +107,6 @@ const OxyProvider: FC<OxyProviderProps> = ({
         };
     }, []);
 
-    // Ensure we have a valid QueryClient
-    if (!queryClient) {
-        // Return loading state or fallback
-        return null;
-    }
-
     return (
         <SafeAreaProvider>
             <GestureHandlerRootView style={{ flex: 1 }}>

package/src/ui/context/OxyContext.tsx

@@ -1,17 +1,14 @@
 import type React from 'react';
 import {
-  createContext,
   useCallback,
-  useContext,
   useEffect,
   useMemo,
   useRef,
   useState,
-  type ReactNode,
 } from 'react';
 import { Platform } from 'react-native';
 import { OxyServices } from '../../core';
-import type { User, ApiError } from '../../models/interfaces';
+import type { User } from '../../models/interfaces';
 import type { ClientSession } from '../../models/session';
 import { toast } from '../../lib/sonner';
 import { useAuthStore, type AuthState } from '../stores/authStore';
@@ -27,88 +24,25 @@ import { getStorageKeys } from '../utils/storageHelpers';
 import { isInvalidSessionError, isTimeoutOrNetworkError } from '../utils/errorHandlers';
 import type { RouteName } from '../navigation/routes';
 import { showBottomSheet as globalShowBottomSheet } from '../navigation/bottomSheetManager';
-import { useQueryClient } from '@tanstack/react-query';
-import { useCurrentUser } from '../hooks/queries';
+import { useQueryClient, useQuery } from '@tanstack/react-query';
 import { clearQueryCache } from '../hooks/queryClient';
+import { queryKeys } from '../hooks/queries/queryKeys';
 import { KeyManager, type BackupData } from '../../crypto';
 import { translate } from '../../i18n';
 import { updateAvatarVisibility, updateProfileWithAvatar } from '../utils/avatarUtils';
 import { useAccountStore } from '../stores/accountStore';
 import { logger as loggerUtil } from '../../utils/loggerUtils';
 
-export interface OxyContextState {
-  user: User | null;
-  sessions: ClientSession[];
-  activeSessionId: string | null;
-  currentDeviceId: string | null;
-  isAuthenticated: boolean;
-  isLoading: boolean;
-  isTokenReady: boolean;
-  isStorageReady: boolean;
-  error: string | null;
-  currentLanguage: string;
-  currentLanguageMetadata: ReturnType<typeof useLanguageManagement>['metadata'];
-  currentLanguageName: string;
-  currentNativeLanguageName: string;
-
-  // Identity management (public key authentication - offline-first)
-  createIdentity: () => Promise<{ synced: boolean }>;
-  importIdentity: (backupData: BackupData, password: string) => Promise<{ synced: boolean }>;
-  signIn: (deviceName?: string) => Promise<User>;
-  hasIdentity: () => Promise<boolean>;
-  getPublicKey: () => Promise<string | null>;
-  isIdentitySynced: () => Promise<boolean>;
-  syncIdentity: () => Promise<User>;
-  deleteIdentityAndClearAccount: (skipBackup?: boolean, force?: boolean, userConfirmed?: boolean) => Promise<void>;
-  storeTransferCode: (transferId: string, code: string, sourceDeviceId: string | null, publicKey: string) => Promise<void>;
-  getTransferCode: (transferId: string) => { code: string; sourceDeviceId: string | null; publicKey: string; timestamp: number; state: 'pending' | 'completed' | 'failed' } | null;
-  clearTransferCode: (transferId: string) => Promise<void>;
-  getAllPendingTransfers: () => Array<{ transferId: string; data: { code: string; sourceDeviceId: string | null; publicKey: string; timestamp: number; state: 'pending' | 'completed' | 'failed' } }>;
-  getActiveTransferId: () => string | null;
-  updateTransferState: (transferId: string, state: 'pending' | 'completed' | 'failed') => Promise<void>;
-
-  // Identity sync state (reactive, from Zustand store)
-  identitySyncState: {
-    isSynced: boolean;
-    isSyncing: boolean;
-  };
-
-  // Session management
-  logout: (targetSessionId?: string) => Promise<void>;
-  logoutAll: () => Promise<void>;
-  switchSession: (sessionId: string) => Promise<void>;
-  removeSession: (sessionId: string) => Promise<void>;
-  refreshSessions: () => Promise<void>;
-  setLanguage: (languageId: string) => Promise<void>;
-  getDeviceSessions: () => Promise<
-    Array<{
-      sessionId: string;
-      deviceId: string;
-      deviceName?: string;
-      lastActive?: string;
-      expiresAt?: string;
-    }>
-  >;
-  logoutAllDeviceSessions: () => Promise<void>;
-  updateDeviceName: (deviceName: string) => Promise<void>;
-  clearSessionState: () => Promise<void>;
-  clearAllAccountData: () => Promise<void>;
-  oxyServices: OxyServices;
-  useFollow?: UseFollowHook;
-  showBottomSheet?: (screenOrConfig: RouteName | { screen: RouteName; props?: Record<string, unknown> }) => void;
-  openAvatarPicker: () => void;
-}
-
-const OxyContext = createContext<OxyContextState | null>(null);
-
-export interface OxyContextProviderProps {
-  children: ReactNode;
-  oxyServices?: OxyServices;
-  baseURL?: string;
-  storageKeyPrefix?: string;
-  onAuthStateChange?: (user: User | null) => void;
-  onError?: (error: ApiError) => void;
-}
+// Import context, types and useOxy from base file to avoid circular dependencies
+import {
+  OxyContext,
+  useOxy,
+  type OxyContextState,
+  type OxyContextProviderProps,
+} from './OxyContextBase';
+
+// Re-export for backwards compatibility
+export { OxyContext, useOxy, type OxyContextState, type OxyContextProviderProps };
 
 let cachedUseFollowHook: UseFollowHook | null = null;
 
@@ -297,7 +231,20 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
   // Get current user from query (no persistent cache - always fetch fresh)
   // Services never caches profile - always fetch from backend
-  const { data: userData } = useCurrentUser({ enabled: isAuthenticated && !!activeSessionId });
+  // Note: We use useQuery directly here instead of useCurrentUser to avoid
+  // circular dependency (useCurrentUser calls useOxy, but we're inside the provider)
+  const { data: userData } = useQuery({
+    queryKey: queryKeys.accounts.current(),
+    queryFn: async () => {
+      if (!activeSessionId) {
+        throw new Error('No active session');
+      }
+      return await oxyServices.getUserBySession(activeSessionId);
+    },
+    enabled: isAuthenticated && !!activeSessionId,
+    staleTime: 0, // Always fetch fresh - Services never caches profile
+    gcTime: 0, // No garbage collection time - always fetch fresh
+  });
   const user = userData ?? null;
 
   const {
@@ -1206,12 +1153,4 @@ export const OxyProvider: React.FC<OxyContextProviderProps> = ({
 
 export const OxyContextProvider = OxyProvider;
 
-export const useOxy = (): OxyContextState => {
-  const context = useContext(OxyContext);
-  if (!context) {
-    throw new Error('useOxy must be used within an OxyContextProvider');
-  }
-  return context;
-};
-
 export default OxyContext;

package/src/ui/context/OxyContextBase.tsx

@@ -0,0 +1,95 @@
+import { createContext, useContext } from 'react';
+import type { ReactNode } from 'react';
+import type { OxyServices } from '../../core';
+import type { User, ApiError } from '../../models/interfaces';
+import type { ClientSession } from '../../models/session';
+import type { UseFollowHook } from '../hooks/useFollow.types';
+import type { useLanguageManagement } from '../hooks/useLanguageManagement';
+import type { RouteName } from '../navigation/routes';
+import type { BackupData } from '../../crypto';
+
+export interface OxyContextState {
+  user: User | null;
+  sessions: ClientSession[];
+  activeSessionId: string | null;
+  currentDeviceId: string | null;
+  isAuthenticated: boolean;
+  isLoading: boolean;
+  isTokenReady: boolean;
+  isStorageReady: boolean;
+  error: string | null;
+  currentLanguage: string;
+  currentLanguageMetadata: ReturnType<typeof useLanguageManagement>['metadata'];
+  currentLanguageName: string;
+  currentNativeLanguageName: string;
+
+  // Identity management (public key authentication - offline-first)
+  createIdentity: () => Promise<{ synced: boolean }>;
+  importIdentity: (backupData: BackupData, password: string) => Promise<{ synced: boolean }>;
+  signIn: (deviceName?: string) => Promise<User>;
+  hasIdentity: () => Promise<boolean>;
+  getPublicKey: () => Promise<string | null>;
+  isIdentitySynced: () => Promise<boolean>;
+  syncIdentity: () => Promise<User>;
+  deleteIdentityAndClearAccount: (skipBackup?: boolean, force?: boolean, userConfirmed?: boolean) => Promise<void>;
+  storeTransferCode: (transferId: string, code: string, sourceDeviceId: string | null, publicKey: string) => Promise<void>;
+  getTransferCode: (transferId: string) => { code: string; sourceDeviceId: string | null; publicKey: string; timestamp: number; state: 'pending' | 'completed' | 'failed' } | null;
+  clearTransferCode: (transferId: string) => Promise<void>;
+  getAllPendingTransfers: () => Array<{ transferId: string; data: { code: string; sourceDeviceId: string | null; publicKey: string; timestamp: number; state: 'pending' | 'completed' | 'failed' } }>;
+  getActiveTransferId: () => string | null;
+  updateTransferState: (transferId: string, state: 'pending' | 'completed' | 'failed') => Promise<void>;
+
+  // Identity sync state (reactive, from Zustand store)
+  identitySyncState: {
+    isSynced: boolean;
+    isSyncing: boolean;
+  };
+
+  // Session management
+  logout: (targetSessionId?: string) => Promise<void>;
+  logoutAll: () => Promise<void>;
+  switchSession: (sessionId: string) => Promise<void>;
+  removeSession: (sessionId: string) => Promise<void>;
+  refreshSessions: () => Promise<void>;
+  setLanguage: (languageId: string) => Promise<void>;
+  getDeviceSessions: () => Promise<
+    Array<{
+      sessionId: string;
+      deviceId: string;
+      deviceName?: string;
+      lastActive?: string;
+      expiresAt?: string;
+    }>
+  >;
+  logoutAllDeviceSessions: () => Promise<void>;
+  updateDeviceName: (deviceName: string) => Promise<void>;
+  clearSessionState: () => Promise<void>;
+  clearAllAccountData: () => Promise<void>;
+  oxyServices: OxyServices;
+  useFollow?: UseFollowHook;
+  showBottomSheet?: (screenOrConfig: RouteName | { screen: RouteName; props?: Record<string, unknown> }) => void;
+  openAvatarPicker: () => void;
+}
+
+export const OxyContext = createContext<OxyContextState | null>(null);
+
+export interface OxyContextProviderProps {
+  children: ReactNode;
+  oxyServices?: OxyServices;
+  baseURL?: string;
+  storageKeyPrefix?: string;
+  onAuthStateChange?: (user: User | null) => void;
+  onError?: (error: ApiError) => void;
+}
+
+/**
+ * Hook to access the Oxy context.
+ * Must be used within an OxyContextProvider.
+ */
+export const useOxy = (): OxyContextState => {
+  const context = useContext(OxyContext);
+  if (!context) {
+    throw new Error('useOxy must be used within an OxyContextProvider');
+  }
+  return context;
+};

package/src/ui/hooks/queries/useAccountQueries.ts

@@ -2,7 +2,7 @@ import { useQuery, useQueries } from '@tanstack/react-query';
 import type { User } from '../../../models/interfaces';
 import type { OxyServices } from '../../../core';
 import { queryKeys } from './queryKeys';
-import { useOxy } from '../../context/OxyContext';
+import { useOxy } from '../../context/OxyContextBase';
 
 /**
  * Get user profile by session ID

package/src/ui/hooks/queries/useSecurityQueries.ts

@@ -1,6 +1,6 @@
 import { useQuery } from '@tanstack/react-query';
 import { queryKeys } from './queryKeys';
-import { useOxy } from '../../context/OxyContext';
+import { useOxy } from '../../context/OxyContextBase';
 import type { SecurityActivity, SecurityEventType } from '../../../models/interfaces';
 
 /**

package/src/ui/hooks/queries/useServicesQueries.ts

@@ -1,7 +1,7 @@
 import { useQuery } from '@tanstack/react-query';
 import type { ClientSession } from '../../../models/session';
 import { queryKeys } from './queryKeys';
-import { useOxy } from '../../context/OxyContext';
+import { useOxy } from '../../context/OxyContextBase';
 import { fetchSessionsWithFallback, mapSessionsToClient } from '../../utils/sessionHelpers';
 
 /**