@oxyhq/services 5.16.0 → 5.16.2

package/lib/typescript/ui/hooks/queries/queryKeys.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Centralized query keys for TanStack Query
+ *
+ * Following best practices:
+ * - Use arrays for hierarchical keys
+ * - Include all parameters in the key
+ * - Use consistent naming conventions
+ */
+export declare const queryKeys: {
+    readonly accounts: {
+        readonly all: readonly ["accounts"];
+        readonly lists: () => readonly ["accounts", "list"];
+        readonly list: (sessionIds: string[]) => readonly ["accounts", "list", string[]];
+        readonly details: () => readonly ["accounts", "detail"];
+        readonly detail: (sessionId: string) => readonly ["accounts", "detail", string];
+        readonly current: () => readonly ["accounts", "current"];
+        readonly settings: () => readonly ["accounts", "settings"];
+    };
+    readonly users: {
+        readonly all: readonly ["users"];
+        readonly lists: () => readonly ["users", "list"];
+        readonly list: (userIds: string[]) => readonly ["users", "list", string[]];
+        readonly details: () => readonly ["users", "detail"];
+        readonly detail: (userId: string) => readonly ["users", "detail", string];
+        readonly profile: (sessionId: string) => readonly ["users", "detail", string, "profile"];
+    };
+    readonly sessions: {
+        readonly all: readonly ["sessions"];
+        readonly lists: () => readonly ["sessions", "list"];
+        readonly list: (userId?: string) => readonly ["sessions", "list", string | undefined];
+        readonly details: () => readonly ["sessions", "detail"];
+        readonly detail: (sessionId: string) => readonly ["sessions", "detail", string];
+        readonly active: () => readonly ["sessions", "active"];
+        readonly device: (deviceId: string) => readonly ["sessions", "device", string];
+    };
+    readonly devices: {
+        readonly all: readonly ["devices"];
+        readonly lists: () => readonly ["devices", "list"];
+        readonly list: (userId?: string) => readonly ["devices", "list", string | undefined];
+        readonly details: () => readonly ["devices", "detail"];
+        readonly detail: (deviceId: string) => readonly ["devices", "detail", string];
+    };
+};
+/**
+ * Helper to invalidate all account-related queries
+ */
+export declare const invalidateAccountQueries: (queryClient: any) => void;
+/**
+ * Helper to invalidate all user-related queries
+ */
+export declare const invalidateUserQueries: (queryClient: any) => void;
+/**
+ * Helper to invalidate all session-related queries
+ */
+export declare const invalidateSessionQueries: (queryClient: any) => void;
+//# sourceMappingURL=queryKeys.d.ts.map

package/lib/typescript/ui/hooks/queries/queryKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;;;;;;;iCASV,MAAM,EAAE;;kCAEP,MAAM;sCACF,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;iCAOT,MAAM;;oCAEH,MAAM;;CAEnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,GAAG,SAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,GAAG,SAExD,CAAC"}

package/lib/typescript/ui/hooks/queries/useAccountQueries.d.ts

@@ -0,0 +1,41 @@
+import type { User } from '../../../models/interfaces';
+/**
+ * Get user profile by session ID
+ */
+export declare const useUserProfile: (sessionId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<User, Error>;
+/**
+ * Get multiple user profiles by session IDs (batch query)
+ */
+export declare const useUserProfiles: (sessionIds: string[], options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<User | null, Error>[];
+/**
+ * Get current authenticated user
+ */
+export declare const useCurrentUser: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<User, Error>;
+/**
+ * Get user by ID
+ */
+export declare const useUserById: (userId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<User, Error>;
+/**
+ * Get user profile by username
+ */
+export declare const useUserByUsername: (username: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<User, Error>;
+/**
+ * Batch get users by session IDs (optimized single API call)
+ */
+export declare const useUsersBySessions: (sessionIds: string[], options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<{
+    sessionId: string;
+    user: User | null;
+}[], Error>;
+//# sourceMappingURL=useAccountQueries.d.ts.map

package/lib/typescript/ui/hooks/queries/useAccountQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountQueries.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queries/useAccountQueries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAKvD;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gEAevF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,EAAE,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,yEAepF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gEAe7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gEAejF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gEAezF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,EAAE,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;WAevF,CAAC"}

package/lib/typescript/ui/hooks/queries/useServicesQueries.d.ts

@@ -0,0 +1,34 @@
+import type { ClientSession } from '../../../models/session';
+/**
+ * Get all active sessions for the current user
+ */
+export declare const useSessions: (userId?: string, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<ClientSession[], Error>;
+/**
+ * Get specific session by ID
+ */
+export declare const useSession: (sessionId: string | null, options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<ClientSession, Error>;
+/**
+ * Get device sessions for the current active session
+ */
+export declare const useDeviceSessions: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+/**
+ * Get user devices
+ */
+export declare const useUserDevices: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+/**
+ * Get security information
+ */
+export declare const useSecurityInfo: (options?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<{
+    recoveryEmail: string | null;
+}, Error>;
+//# sourceMappingURL=useServicesQueries.d.ts.map

package/lib/typescript/ui/hooks/queries/useServicesQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServicesQueries.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/queries/useServicesQueries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,2EAqB3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,WAAW,MAAM,GAAG,IAAI,EAAE,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,yEA6BnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,iEAgBhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,iEAY7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;SAY9D,CAAC"}

package/lib/typescript/ui/hooks/queryClient.d.ts

@@ -0,0 +1,19 @@
+import { QueryClient } from '@tanstack/react-query';
+import type { StorageInterface } from '../utils/storageHelpers';
+/**
+ * Custom persistence adapter for TanStack Query using our StorageInterface
+ */
+export declare const createPersistenceAdapter: (storage: StorageInterface) => {
+    persistClient: (client: any) => Promise<void>;
+    restoreClient: () => Promise<any>;
+    removeClient: () => Promise<void>;
+};
+/**
+ * Create a QueryClient with offline-first configuration
+ */
+export declare const createQueryClient: (storage?: StorageInterface | null) => QueryClient;
+/**
+ * Clear persisted query cache
+ */
+export declare const clearQueryCache: (storage: StorageInterface) => Promise<void>;
+//# sourceMappingURL=queryClient.d.ts.map

package/lib/typescript/ui/hooks/queryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryClient.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/queryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,gBAAgB;4BAEhC,GAAG;;;CAqDpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,gBAAgB,GAAG,IAAI,KAAG,WAiCrE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAG7E,CAAC"}

package/lib/typescript/ui/hooks/useIdentityMutations.d.ts

@@ -0,0 +1,29 @@
+/**
+ * TanStack Query mutations for identity operations
+ * Provides offline-first mutations for identity creation, import, and sync
+ * Never deletes identity on errors - preserves user data
+ */
+import type { User } from '../../models/interfaces';
+export interface CreateIdentityResult {
+    recoveryPhrase: string[];
+    synced: boolean;
+}
+export interface ImportIdentityResult {
+    synced: boolean;
+}
+/**
+ * Hook for creating a new identity with offline support
+ * Never deletes identity on error - preserves user data
+ */
+export declare function useCreateIdentity(createIdentityFn: () => Promise<CreateIdentityResult>): import("@tanstack/react-query").UseMutationResult<CreateIdentityResult, Error, void, unknown>;
+/**
+ * Hook for importing an identity from recovery phrase
+ * Never deletes identity on error - preserves user data
+ */
+export declare function useImportIdentity(importIdentityFn: (phrase: string) => Promise<ImportIdentityResult>): import("@tanstack/react-query").UseMutationResult<ImportIdentityResult, Error, string, unknown>;
+/**
+ * Hook for syncing identity with server
+ * Never deletes identity on error - only logs and allows retry
+ */
+export declare function useSyncIdentity(syncIdentityFn: () => Promise<User>): import("@tanstack/react-query").UseMutationResult<User, Error, void, unknown>;
+//# sourceMappingURL=useIdentityMutations.d.ts.map

package/lib/typescript/ui/hooks/useIdentityMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIdentityMutations.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useIdentityMutations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,iGAqBtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,mGAmBpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,iFAoCpC"}

package/lib/typescript/ui/hooks/useProfileEditing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useProfileEditing.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useProfileEditing.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9C,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;2BASsB,iBAAiB;yBAgEnB,MAAM,SAAS,GAAG;;CAmCnE,CAAC"}
+{"version":3,"file":"useProfileEditing.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useProfileEditing.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9C,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;2BAOsB,iBAAiB;yBAqDnB,MAAM,SAAS,GAAG;;CAmCnE,CAAC"}

package/lib/typescript/ui/hooks/useQueryClient.d.ts

@@ -0,0 +1,7 @@
+import type { QueryClient } from '@tanstack/react-query';
+/**
+ * Custom hook to access the QueryClient
+ * Provides type safety and ensures client is available
+ */
+export declare const useQueryClient: () => QueryClient;
+//# sourceMappingURL=useQueryClient.d.ts.map

package/lib/typescript/ui/hooks/useQueryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryClient.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useQueryClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,WAQjC,CAAC"}

package/lib/typescript/ui/hooks/useSessionManagement.d.ts

@@ -2,6 +2,7 @@ import type { ApiError, User } from '../../models/interfaces';
 import type { ClientSession } from '../../models/session';
 import { getStorageKeys, type StorageInterface } from '../utils/storageHelpers';
 import type { OxyServices } from '../../core';
+import type { QueryClient } from '@tanstack/react-query';
 export interface UseSessionManagementOptions {
     oxyServices: OxyServices;
     storage: StorageInterface | null;
@@ -14,6 +15,7 @@ export interface UseSessionManagementOptions {
     setAuthError?: (message: string | null) => void;
     logger?: (message: string, error?: unknown) => void;
     setTokenReady?: (ready: boolean) => void;
+    queryClient?: QueryClient | null;
 }
 export interface UseSessionManagementResult {
     sessions: ClientSession[];
@@ -35,5 +37,5 @@ export interface UseSessionManagementResult {
  *
  * @param options - Session management configuration
  */
-export declare const useSessionManagement: ({ oxyServices, storage, storageKeyPrefix, loginSuccess, logoutStore, applyLanguagePreference, onAuthStateChange, onError, setAuthError, logger, setTokenReady, }: UseSessionManagementOptions) => UseSessionManagementResult;
+export declare const useSessionManagement: ({ oxyServices, storage, storageKeyPrefix, loginSuccess, logoutStore, applyLanguagePreference, onAuthStateChange, onError, setAuthError, logger, setTokenReady, queryClient, }: UseSessionManagementOptions) => UseSessionManagementResult;
 //# sourceMappingURL=useSessionManagement.d.ts.map

package/lib/typescript/ui/hooks/useSessionManagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSessionManagement.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useSessionManagement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uBAAuB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACnF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,kKAYlC,2BAA2B,KAAG,0BA8ThC,CAAC"}
+{"version":3,"file":"useSessionManagement.d.ts","sourceRoot":"","sources":["../../../../src/ui/hooks/useSessionManagement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uBAAuB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACnF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC/C,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAKD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,+KAalC,2BAA2B,KAAG,0BAiVhC,CAAC"}

package/lib/typescript/ui/screens/AccountOverviewScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountOverviewScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/AccountOverviewScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAcjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;AAszB3D,wBAAiD"}
+{"version":3,"file":"AccountOverviewScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/AccountOverviewScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAcjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;AA8yB3D,wBAAiD"}

package/lib/typescript/ui/screens/AccountSettingsScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountSettingsScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/AccountSettingsScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAcjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;mBA4Cc,MAAM;qBAAmB,MAAM;;AA0gExG,wBAAiD"}
+{"version":3,"file":"AccountSettingsScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/AccountSettingsScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAcjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;mBA8Cc,MAAM;qBAAmB,MAAM;;AAwgExG,wBAAiD"}

package/lib/typescript/ui/screens/WelcomeNewUserScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WelcomeNewUserScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/WelcomeNewUserScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA8C3D;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CA0MvE,CAAC;AAgGF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"WelcomeNewUserScreen.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/WelcomeNewUserScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA+C3D;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CA0MvE,CAAC;AAgGF,eAAe,oBAAoB,CAAC"}

package/lib/typescript/ui/stores/accountStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountStore.d.ts","sourceRoot":"","sources":["../../../../src/ui/stores/accountStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,YAAY;IAElB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,YAAY,EAAE,CAAC;IAG9B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAG/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAC3E,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAG9C,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAGjE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAGzC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5I,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AA4CD,eAAO,MAAM,eAAe,2EAwLzB,CAAC;AAGJ,eAAO,MAAM,WAAW,QAAO,YAAY,EAE1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAAwC,CAAC;AACvE,eAAO,MAAM,eAAe,qBAAsC,CAAC;AACnE,eAAO,MAAM,wBAAwB,GAAI,WAAW,MAAM,YACE,CAAC"}
+{"version":3,"file":"accountStore.d.ts","sourceRoot":"","sources":["../../../../src/ui/stores/accountStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,YAAY;IAElB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,YAAY,EAAE,CAAC;IAG9B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAG/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAC3E,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAG9C,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAGjE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAGzC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5I,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AA4CD,eAAO,MAAM,eAAe,2EAmMzB,CAAC;AAGJ,eAAO,MAAM,WAAW,QAAO,YAAY,EAE1C,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAAwC,CAAC;AACvE,eAAO,MAAM,eAAe,qBAAsC,CAAC;AACnE,eAAO,MAAM,wBAAwB,GAAI,WAAW,MAAM,YACE,CAAC"}

package/lib/typescript/ui/stores/authStore.d.ts

@@ -13,10 +13,6 @@ export interface AuthState {
     fetchUser: (oxyServices: {
         getCurrentUser: () => Promise<User>;
     }, forceRefresh?: boolean) => Promise<void>;
-    updateUser: (updates: Partial<User>, oxyServices: {
-        updateProfile: (updates: Partial<User>) => Promise<User>;
-        getCurrentUser: () => Promise<User>;
-    }) => Promise<void>;
     setUser: (user: User) => void;
     setIdentitySynced: (synced: boolean) => void;
     setSyncing: (syncing: boolean) => void;

package/lib/typescript/ui/stores/authStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authStore.d.ts","sourceRoot":"","sources":["../../../../src/ui/stores/authStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IAEnB,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,WAAW,EAAE;QAAE,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE;QAAE,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtK,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAG9B,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,YAAY,wEAuEtB,CAAC"}
+{"version":3,"file":"authStore.d.ts","sourceRoot":"","sources":["../../../../src/ui/stores/authStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IAEnB,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,WAAW,EAAE;QAAE,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAG9B,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,YAAY,wEA0DtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/services",
-  "version": "5.16.0",
+  "version": "5.16.2",
   "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",
@@ -90,6 +90,7 @@
   },
   "dependencies": {
     "@react-native-async-storage/async-storage": "2.1.2",
+    "@react-native-community/netinfo": "^11.4.1",
     "@tanstack/react-query": "^5.59.0",
     "axios": "^1.9.0",
     "bip39": "^3.1.0",
@@ -111,13 +112,14 @@
     "zustand": "^5.0.6"
   },
   "devDependencies": {
-    "@types/color": "^3.0.6",
-    "@types/elliptic": "^6.4.18",
     "@biomejs/biome": "^1.9.4",
     "@commitlint/cli": "^17.6.5",
     "@commitlint/config-conventional": "^17.6.5",
+    "@react-native/babel-preset": "^0.77.0",
     "@release-it/conventional-changelog": "^10.0.2",
     "@testing-library/jest-dom": "^6.4.2",
+    "@types/color": "^3.0.6",
+    "@types/elliptic": "^6.4.18",
     "@types/invariant": "^2.2.34",
     "@types/jest": "^29.5.14",
     "@types/jwt-decode": "^2.2.1",
@@ -132,7 +134,6 @@
     "husky": "^4.3.8",
     "jest": "~29.7.0",
     "lint-staged": "^15.2.4",
-    "@react-native/babel-preset": "^0.77.0",
     "react-native-builder-bob": "^0.40.16",
     "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~4.1.1",
@@ -204,4 +205,4 @@
     "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~4.1.1"
   }
-}
+}

package/src/core/mixins/OxyServices.assets.ts

@@ -1,7 +1,7 @@
 /**
  * Asset & File Methods Mixin
  */
-import type { AssetInitResponse, AssetUrlResponse, AssetVariant } from '../../models/interfaces';
+import type { AccountStorageUsageResponse, AssetInitResponse, AssetUrlResponse, AssetVariant } from '../../models/interfaces';
 import type { OxyServicesBase } from '../OxyServices.base';
 import { File } from 'expo-file-system';
 
@@ -83,6 +83,21 @@ export function OxyServicesAssetsMixin<T extends typeof OxyServicesBase>(Base: T
       }
     }
 
+    /**
+     * Get account storage usage (server-side usage aggregated from assets)
+     *
+     * NOTE: This is NOT the same as `getStorage()` from the language mixin (which returns local storage).
+     */
+    async getAccountStorageUsage(): Promise<AccountStorageUsageResponse> {
+      try {
+        return await this.makeRequest<AccountStorageUsageResponse>('GET', '/api/storage/usage', undefined, {
+          cache: false,
+        });
+      } catch (error) {
+        throw this.handleError(error);
+      }
+    }
+
     /**
      * Get file content as text
      */

package/src/core/mixins/OxyServices.user.ts

@@ -129,11 +129,28 @@ export function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T)
 
     /**
      * Update user profile
+     * TanStack Query handles offline queuing automatically
      */
     async updateProfile(updates: Record<string, any>): Promise<User> {
       try {
         return await this.makeRequest<User>('PUT', '/api/users/me', updates, { cache: false });
       } catch (error) {
+        const errorAny = error as any;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const status = errorAny?.status || errorAny?.response?.status;
+        
+        // Check if it's an authentication error (401)
+        const isAuthError = status === 401 || 
+          errorMessage.includes('Authentication required') ||
+          errorMessage.includes('Invalid or missing authorization header');
+
+        // If authentication error and we don't have a token, this might be an offline session
+        // The caller should handle syncing the session before retrying
+        if (isAuthError && !this.hasValidToken()) {
+          // Re-throw with a specific message so the caller knows to sync
+          throw new Error('AUTH_REQUIRED_OFFLINE_SESSION: Session needs to be synced to get a token');
+        }
+
         throw this.handleError(error);
       }
     }
@@ -219,16 +236,6 @@ export function OxyServicesUserMixin<T extends typeof OxyServicesBase>(Base: T)
       }
     }
 
-    /**
-     * Update user by ID (admin function)
-     */
-    async updateUser(userId: string, updates: Record<string, any>): Promise<User> {
-      try {
-        return await this.makeRequest<User>('PUT', `/api/users/${userId}`, updates, { cache: false });
-      } catch (error) {
-        throw this.handleError(error);
-      }
-    }
 
     /**
      * Follow a user

package/src/crypto/keyManager.ts

@@ -17,6 +17,9 @@ const ec = new EC('secp256k1');
 const STORAGE_KEYS = {
   PRIVATE_KEY: 'oxy_identity_private_key',
   PUBLIC_KEY: 'oxy_identity_public_key',
+  BACKUP_PRIVATE_KEY: 'oxy_identity_backup_private_key',
+  BACKUP_PUBLIC_KEY: 'oxy_identity_backup_public_key',
+  BACKUP_TIMESTAMP: 'oxy_identity_backup_timestamp',
 } as const;
 
 /**
@@ -183,12 +186,184 @@ export class KeyManager {
 
   /**
    * Delete the stored identity (both keys)
-   * Use with caution - this is irreversible without a recovery phrase
+   * Use with EXTREME caution - this is irreversible without a recovery phrase
+   * This should ONLY be called when explicitly requested by the user
+   * @param skipBackup - If true, skip backup before deletion (default: false)
+   * @param force - If true, skip confirmation checks (default: false)
+   * @param userConfirmed - If true, user has explicitly confirmed deletion (default: false)
    */
-  static async deleteIdentity(): Promise<void> {
+  static async deleteIdentity(
+    skipBackup: boolean = false, 
+    force: boolean = false,
+    userConfirmed: boolean = false
+  ): Promise<void> {
+    // CRITICAL SAFEGUARD: Require explicit user confirmation unless force is true
+    if (!force && !userConfirmed) {
+      throw new Error('Identity deletion requires explicit user confirmation. This is a safety measure to prevent accidental data loss.');
+    }
+
+    if (!force) {
+      const hasIdentity = await KeyManager.hasIdentity();
+      if (!hasIdentity) {
+        return; // Nothing to delete
+      }
+    }
+
     const store = await initSecureStore();
+    
+    // ALWAYS create backup before deletion unless explicitly skipped
+    if (!skipBackup) {
+      try {
+        const backupSuccess = await KeyManager.backupIdentity();
+        if (!backupSuccess && typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.warn('[KeyManager] Failed to backup identity before deletion - proceeding anyway');
+        }
+      } catch (backupError) {
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.warn('[KeyManager] Failed to backup identity before deletion:', backupError);
+        }
+      }
+    }
+
     await store.deleteItemAsync(STORAGE_KEYS.PRIVATE_KEY);
     await store.deleteItemAsync(STORAGE_KEYS.PUBLIC_KEY);
+    
+    // Also clear backup if force deletion
+    if (force) {
+      try {
+        await store.deleteItemAsync(STORAGE_KEYS.BACKUP_PRIVATE_KEY);
+        await store.deleteItemAsync(STORAGE_KEYS.BACKUP_PUBLIC_KEY);
+        await store.deleteItemAsync(STORAGE_KEYS.BACKUP_TIMESTAMP);
+      } catch (error) {
+        // Ignore backup deletion errors
+      }
+    }
+  }
+
+  /**
+   * Backup identity to SecureStore (separate backup storage)
+   * This provides a recovery mechanism if primary storage fails
+   */
+  static async backupIdentity(): Promise<boolean> {
+    try {
+      const store = await initSecureStore();
+      const privateKey = await KeyManager.getPrivateKey();
+      const publicKey = await KeyManager.getPublicKey();
+
+      if (!privateKey || !publicKey) {
+        return false; // Nothing to backup
+      }
+
+      // Store backup in SecureStore (still secure, but separate from primary storage)
+      await store.setItemAsync(STORAGE_KEYS.BACKUP_PRIVATE_KEY, privateKey, {
+        keychainAccessible: store.WHEN_UNLOCKED_THIS_DEVICE_ONLY,
+      });
+      await store.setItemAsync(STORAGE_KEYS.BACKUP_PUBLIC_KEY, publicKey);
+      await store.setItemAsync(STORAGE_KEYS.BACKUP_TIMESTAMP, Date.now().toString());
+
+      return true;
+    } catch (error) {
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.error('[KeyManager] Failed to backup identity:', error);
+      }
+      return false;
+    }
+  }
+
+  /**
+   * Verify identity integrity - checks if keys are valid and accessible
+   */
+  static async verifyIdentityIntegrity(): Promise<boolean> {
+    try {
+      const privateKey = await KeyManager.getPrivateKey();
+      const publicKey = await KeyManager.getPublicKey();
+
+      if (!privateKey || !publicKey) {
+        return false;
+      }
+
+      // Validate private key format
+      if (!KeyManager.isValidPrivateKey(privateKey)) {
+        return false;
+      }
+
+      // Validate public key format
+      if (!KeyManager.isValidPublicKey(publicKey)) {
+        return false;
+      }
+
+      // Verify public key can be derived from private key
+      const derivedPublicKey = KeyManager.derivePublicKey(privateKey);
+      if (derivedPublicKey !== publicKey) {
+        return false; // Keys don't match
+      }
+
+      // Verify we can create a key pair object (tests elliptic curve operations)
+      const keyPair = await KeyManager.getKeyPairObject();
+      if (!keyPair) {
+        return false;
+      }
+
+      return true;
+    } catch (error) {
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.error('[KeyManager] Identity integrity check failed:', error);
+      }
+      return false;
+    }
+  }
+
+  /**
+   * Restore identity from backup if primary storage is corrupted
+   */
+  static async restoreIdentityFromBackup(): Promise<boolean> {
+    try {
+      const store = await initSecureStore();
+      
+      // Check if backup exists
+      const backupPrivateKey = await store.getItemAsync(STORAGE_KEYS.BACKUP_PRIVATE_KEY);
+      const backupPublicKey = await store.getItemAsync(STORAGE_KEYS.BACKUP_PUBLIC_KEY);
+
+      if (!backupPrivateKey || !backupPublicKey) {
+        return false; // No backup available
+      }
+
+      // Verify backup integrity
+      if (!KeyManager.isValidPrivateKey(backupPrivateKey)) {
+        return false;
+      }
+
+      if (!KeyManager.isValidPublicKey(backupPublicKey)) {
+        return false;
+      }
+
+      // Verify keys match
+      const derivedPublicKey = KeyManager.derivePublicKey(backupPrivateKey);
+      if (derivedPublicKey !== backupPublicKey) {
+        return false; // Backup keys don't match
+      }
+
+      // Restore from backup
+      await store.setItemAsync(STORAGE_KEYS.PRIVATE_KEY, backupPrivateKey, {
+        keychainAccessible: store.WHEN_UNLOCKED_THIS_DEVICE_ONLY,
+      });
+      await store.setItemAsync(STORAGE_KEYS.PUBLIC_KEY, backupPublicKey);
+
+      // Verify restoration was successful
+      const restored = await KeyManager.verifyIdentityIntegrity();
+      if (restored) {
+        // Update backup timestamp
+        await store.setItemAsync(STORAGE_KEYS.BACKUP_TIMESTAMP, Date.now().toString());
+        return true;
+      }
+
+      return false;
+    } catch (error) {
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.error('[KeyManager] Failed to restore identity from backup:', error);
+      }
+      return false;
+    }
   }
 
   /**