@oxyhq/services 5.21.5 → 5.21.7

package/lib/typescript/module/ui/utils/authHelpers.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Authentication helper utilities to reduce code duplication across hooks and utilities.
+ * These functions handle common token validation and authentication error patterns.
+ */
+import type { OxyServices } from '../../core';
+/**
+ * Error thrown when session sync is required
+ */
+export declare class SessionSyncRequiredError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when authentication fails
+ */
+export declare class AuthenticationFailedError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Ensures a valid token exists before making authenticated API calls.
+ * If no valid token exists and an active session ID is available,
+ * attempts to refresh the token using the session.
+ *
+ * @param oxyServices - The OxyServices instance
+ * @param activeSessionId - The active session ID (if available)
+ * @throws {SessionSyncRequiredError} If the session needs to be synced (offline session)
+ * @throws {Error} If token refresh fails for other reasons
+ *
+ * @example
+ * ```ts
+ * // In a mutation or query function:
+ * await ensureValidToken(oxyServices, activeSessionId);
+ * return await oxyServices.updateProfile(updates);
+ * ```
+ */
+export declare function ensureValidToken(oxyServices: OxyServices, activeSessionId: string | null | undefined): Promise<void>;
+/**
+ * Options for handling API authentication errors
+ */
+export interface HandleApiErrorOptions {
+    /** Optional callback to attempt session sync and retry */
+    syncSession?: () => Promise<unknown>;
+    /** The active session ID for retry attempts */
+    activeSessionId?: string | null;
+    /** The OxyServices instance for retry attempts */
+    oxyServices?: OxyServices;
+}
+/**
+ * Checks if an error is an authentication error (401 or auth-related message)
+ *
+ * @param error - The error to check
+ * @returns True if the error is an authentication error
+ */
+export declare function isAuthenticationError(error: unknown): boolean;
+/**
+ * Wraps an API call with authentication error handling.
+ * If an authentication error occurs, it can optionally attempt to sync the session and retry.
+ *
+ * @param apiCall - The API call function to execute
+ * @param options - Optional error handling configuration
+ * @returns The result of the API call
+ * @throws {AuthenticationFailedError} If authentication fails and cannot be recovered
+ * @throws {Error} If the API call fails for non-auth reasons
+ *
+ * @example
+ * ```ts
+ * // Simple usage:
+ * const result = await withAuthErrorHandling(
+ *   () => oxyServices.updateProfile(updates)
+ * );
+ *
+ * // With retry on auth failure:
+ * const result = await withAuthErrorHandling(
+ *   () => oxyServices.updateProfile(updates),
+ *   { syncSession, activeSessionId, oxyServices }
+ * );
+ * ```
+ */
+export declare function withAuthErrorHandling<T>(apiCall: () => Promise<T>, options?: HandleApiErrorOptions): Promise<T>;
+/**
+ * Combines token validation and auth error handling for a complete authenticated API call.
+ * This is the recommended helper for most authenticated API operations.
+ *
+ * @param oxyServices - The OxyServices instance
+ * @param activeSessionId - The active session ID
+ * @param apiCall - The API call function to execute
+ * @param syncSession - Optional callback to sync session on auth failure
+ * @returns The result of the API call
+ *
+ * @example
+ * ```ts
+ * return await authenticatedApiCall(
+ *   oxyServices,
+ *   activeSessionId,
+ *   () => oxyServices.updateProfile(updates)
+ * );
+ * ```
+ */
+export declare function authenticatedApiCall<T>(oxyServices: OxyServices, activeSessionId: string | null | undefined, apiCall: () => Promise<T>, syncSession?: () => Promise<unknown>): Promise<T>;
+//# sourceMappingURL=authHelpers.d.ts.map

package/lib/typescript/module/ui/utils/authHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/authHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAAkD;CAItE;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAAiD;CAIrE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kDAAkD;IAClD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/lib/typescript/module/ui/utils/avatarUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatarUtils.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/avatarUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,WAAW,EACxB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,IAAI,CAON;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAoEf"}
+{"version":3,"file":"avatarUtils.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/avatarUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,WAAW,EACxB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,IAAI,CAON;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EACtB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/services",
-  "version": "5.21.5",
+  "version": "5.21.7",
   "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",
@@ -252,4 +252,4 @@
     "react-native-gesture-handler": "~2.28.0",
     "react-native-reanimated": "~4.1.1"
   }
-}
+}

package/src/crypto/keyManager.ts

@@ -8,6 +8,7 @@
 import { ec as EC } from 'elliptic';
 import type { ECKeyPair } from 'elliptic';
 import { Platform } from 'react-native';
+import { logger } from '../utils/loggerUtils';
 
 // Lazy imports for React Native specific modules
 let SecureStore: typeof import('expo-secure-store') | null = null;
@@ -243,7 +244,7 @@ export class KeyManager {
     KeyManager.cachedHasSharedIdentity = true;
 
     if (__DEV__) {
-      console.log('[KeyManager] Shared identity created successfully');
+      logger.debug('Shared identity created successfully', { component: 'KeyManager' });
     }
 
     return publicKey;
@@ -282,7 +283,7 @@ export class KeyManager {
       return publicKey;
     } catch (error) {
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to get shared public key:', error);
+        logger.warn('Failed to get shared public key', { component: 'KeyManager' }, error);
       }
       KeyManager.cachedSharedPublicKey = null;
       return null;
@@ -317,7 +318,7 @@ export class KeyManager {
       return privateKey;
     } catch (error) {
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to get shared private key:', error);
+        logger.warn('Failed to get shared private key', { component: 'KeyManager' }, error);
       }
       return null;
     }
@@ -348,7 +349,7 @@ export class KeyManager {
       return hasShared;
     } catch (error) {
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to check shared identity:', error);
+        logger.warn('Failed to check shared identity', { component: 'KeyManager' }, error);
       }
       KeyManager.cachedHasSharedIdentity = false;
       return false;
@@ -397,7 +398,7 @@ export class KeyManager {
     KeyManager.cachedHasSharedIdentity = true;
 
     if (__DEV__) {
-      console.log('[KeyManager] Shared identity imported successfully');
+      logger.debug('Shared identity imported successfully', { component: 'KeyManager' });
     }
 
     return publicKey;
@@ -436,11 +437,11 @@ export class KeyManager {
       }
 
       if (__DEV__) {
-        console.log('[KeyManager] Shared session stored successfully');
+        logger.debug('Shared session stored successfully', { component: 'KeyManager' });
       }
     } catch (error) {
       if (__DEV__) {
-        console.error('[KeyManager] Failed to store shared session:', error);
+        logger.error('Failed to store shared session', error, { component: 'KeyManager' });
       }
       throw error;
     }
@@ -484,7 +485,7 @@ export class KeyManager {
       return { sessionId, accessToken };
     } catch (error) {
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to get shared session:', error);
+        logger.warn('Failed to get shared session', { component: 'KeyManager' }, error);
       }
       return null;
     }
@@ -517,11 +518,11 @@ export class KeyManager {
       }
 
       if (__DEV__) {
-        console.log('[KeyManager] Shared session cleared successfully');
+        logger.debug('Shared session cleared successfully', { component: 'KeyManager' });
       }
     } catch (error) {
       if (__DEV__) {
-        console.error('[KeyManager] Failed to clear shared session:', error);
+        logger.error('Failed to clear shared session', error, { component: 'KeyManager' });
       }
     }
   }
@@ -545,7 +546,7 @@ export class KeyManager {
       const hasShared = await KeyManager.hasSharedIdentity();
       if (hasShared) {
         if (__DEV__) {
-          console.log('[KeyManager] Shared identity already exists, skipping migration');
+          logger.debug('Shared identity already exists, skipping migration', { component: 'KeyManager' });
         }
         return true;
       }
@@ -554,7 +555,7 @@ export class KeyManager {
       const privateKey = await KeyManager.getPrivateKey();
       if (!privateKey) {
         if (__DEV__) {
-          console.log('[KeyManager] No local identity to migrate');
+          logger.debug('No local identity to migrate', { component: 'KeyManager' });
         }
         return false;
       }
@@ -563,13 +564,13 @@ export class KeyManager {
       await KeyManager.importSharedIdentity(privateKey);
 
       if (__DEV__) {
-        console.log('[KeyManager] Successfully migrated local identity to shared identity');
+        logger.debug('Successfully migrated local identity to shared identity', { component: 'KeyManager' });
       }
 
       return true;
     } catch (error) {
       if (__DEV__) {
-        console.error('[KeyManager] Failed to migrate to shared identity:', error);
+        logger.error('Failed to migrate to shared identity', error, { component: 'KeyManager' });
       }
       return false;
     }
@@ -640,7 +641,7 @@ export class KeyManager {
       // If secure store is not available, return null (no identity)
       // This allows the app to continue functioning even if secure store fails to load
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to access secure store:', error);
+        logger.warn('Failed to access secure store', { component: 'KeyManager' }, error);
       }
       return null;
     }
@@ -670,7 +671,7 @@ export class KeyManager {
       // Cache null to avoid repeated failed attempts
       KeyManager.cachedPublicKey = null;
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to access secure store:', error);
+        logger.warn('Failed to access secure store', { component: 'KeyManager' }, error);
       }
       return null;
     }
@@ -700,7 +701,7 @@ export class KeyManager {
       // Cache false to avoid repeated failed attempts
       KeyManager.cachedHasIdentity = false;
       if (__DEV__) {
-        console.warn('[KeyManager] Failed to check identity:', error);
+        logger.warn('Failed to check identity', { component: 'KeyManager' }, error);
       }
       return false;
     }
@@ -741,11 +742,11 @@ export class KeyManager {
       try {
         const backupSuccess = await KeyManager.backupIdentity();
         if (!backupSuccess && typeof __DEV__ !== 'undefined' && __DEV__) {
-          console.warn('[KeyManager] Failed to backup identity before deletion - proceeding anyway');
+          logger.warn('Failed to backup identity before deletion - proceeding anyway', { component: 'KeyManager' });
         }
       } catch (backupError) {
         if (typeof __DEV__ !== 'undefined' && __DEV__) {
-          console.warn('[KeyManager] Failed to backup identity before deletion:', backupError);
+          logger.warn('Failed to backup identity before deletion', { component: 'KeyManager' }, backupError);
         }
       }
     }
@@ -795,7 +796,7 @@ export class KeyManager {
       return true;
     } catch (error) {
       if (typeof __DEV__ !== 'undefined' && __DEV__) {
-        console.error('[KeyManager] Failed to backup identity:', error);
+        logger.error('Failed to backup identity', error, { component: 'KeyManager' });
       }
       return false;
     }
@@ -841,7 +842,7 @@ export class KeyManager {
       return true;
     } catch (error) {
       if (typeof __DEV__ !== 'undefined' && __DEV__) {
-        console.error('[KeyManager] Identity integrity check failed:', error);
+        logger.error('Identity integrity check failed', error, { component: 'KeyManager' });
       }
       return false;
     }
@@ -898,7 +899,7 @@ export class KeyManager {
       return false;
     } catch (error) {
       if (typeof __DEV__ !== 'undefined' && __DEV__) {
-        console.error('[KeyManager] Failed to restore identity from backup:', error);
+        logger.error('Failed to restore identity from backup', error, { component: 'KeyManager' });
       }
       return false;
     }

package/src/index.ts

@@ -183,6 +183,31 @@ export {
   useRemoveDevice,
 } from './ui/hooks/mutations';
 
+// Mutation factory utilities
+export {
+  createProfileMutation,
+  createGenericMutation,
+} from './ui/hooks/mutations/mutationFactory';
+export type {
+  ProfileMutationConfig,
+  GenericMutationConfig,
+} from './ui/hooks/mutations/mutationFactory';
+
+// Authentication helpers
+export {
+  ensureValidToken,
+  withAuthErrorHandling,
+  authenticatedApiCall,
+  isAuthenticationError,
+  SessionSyncRequiredError,
+  AuthenticationFailedError,
+} from './ui/utils/authHelpers';
+export type { HandleApiErrorOptions } from './ui/utils/authHelpers';
+
+// File filtering hook
+export { useFileFiltering } from './ui/hooks/useFileFiltering';
+export type { ViewMode, SortBy, SortOrder } from './ui/hooks/useFileFiltering';
+
 // UI components
 export { OxySignInButton } from './ui/components/OxySignInButton';
 export { OxyLogo, FollowButton } from './ui';