@onairos/react-native 3.1.15 → 3.1.17

package/lib/module/services/apiKeyService.js

@@ -14,23 +14,23 @@ export let ApiKeyType = /*#__PURE__*/function (ApiKeyType) {
 // JWT token storage key
 const JWT_TOKEN_KEY = 'onairos_jwt_token';
 
-/**
- * Two-Tier Authentication Service for Onairos React Native SDK
- * 
- * This service implements the two-tier authentication system:
- * 1. Developer API Keys: For app-level operations (email verification, app registration)
- * 2. JWT User Tokens: For user-level operations (PIN storage, user profile)
- * 
- * How it works:
- * 1. Initialize with developer API key
- * 2. Use API key for email verification requests
- * 3. Store JWT token from email verification response
- * 4. Use JWT token for user-authenticated requests
- * 5. Handle token expiration gracefully
- * 
- * Backend Integration:
- * - Developer routes: Authorization: Bearer ${API_KEY}
- * - User routes: Authorization: Bearer ${JWT_TOKEN}
+/**
+ * Two-Tier Authentication Service for Onairos React Native SDK
+ * 
+ * This service implements the two-tier authentication system:
+ * 1. Developer API Keys: For app-level operations (email verification, app registration)
+ * 2. JWT User Tokens: For user-level operations (PIN storage, user profile)
+ * 
+ * How it works:
+ * 1. Initialize with developer API key
+ * 2. Use API key for email verification requests
+ * 3. Store JWT token from email verification response
+ * 4. Use JWT token for user-authenticated requests
+ * 5. Handle token expiration gracefully
+ * 
+ * Backend Integration:
+ * - Developer routes: Authorization: Bearer ${API_KEY}
+ * - User routes: Authorization: Bearer ${JWT_TOKEN}
  */
 
 // Global configuration state
@@ -49,9 +49,9 @@ const API_ENDPOINTS = {
   development: 'https://dev-api.onairos.uk'
 };
 
-/**
- * Initialize the SDK with developer API key
- * @param config API configuration including developer API key
+/**
+ * Initialize the SDK with developer API key
+ * @param config API configuration including developer API key
  */
 export const initializeApiKey = async config => {
   try {
@@ -124,10 +124,10 @@ export const initializeApiKey = async config => {
   }
 };
 
-/**
- * Determine API key type
- * @param apiKey The API key to check
- * @returns The type of API key
+/**
+ * Determine API key type
+ * @param apiKey The API key to check
+ * @returns The type of API key
  */
 export const getApiKeyType = apiKey => {
   if (apiKey === ADMIN_API_KEY) {
@@ -141,19 +141,19 @@ export const getApiKeyType = apiKey => {
   return ApiKeyType.INVALID;
 };
 
-/**
- * Check if API key is admin key
- * @param apiKey The API key to check
- * @returns True if admin key
+/**
+ * Check if API key is admin key
+ * @param apiKey The API key to check
+ * @returns True if admin key
  */
 export const isAdminKey = apiKey => {
   return apiKey === ADMIN_API_KEY;
 };
 
-/**
- * Validate an API key with the Onairos backend
- * @param apiKey The API key to validate
- * @returns Validation result with permissions and rate limits
+/**
+ * Validate an API key with the Onairos backend
+ * @param apiKey The API key to validate
+ * @returns Validation result with permissions and rate limits
  */
 export const validateApiKey = async apiKey => {
   try {
@@ -389,34 +389,34 @@ export const validateApiKey = async apiKey => {
   }
 };
 
-/**
- * Get the current API configuration
- * @returns Current API configuration or null if not initialized
+/**
+ * Get the current API configuration
+ * @returns Current API configuration or null if not initialized
  */
 export const getApiConfig = () => {
   return globalConfig;
 };
 
-/**
- * Get the current API key
- * @returns Current API key or null if not initialized
+/**
+ * Get the current API key
+ * @returns Current API key or null if not initialized
  */
 export const getApiKey = () => {
   var _globalConfig9;
   return ((_globalConfig9 = globalConfig) === null || _globalConfig9 === void 0 ? void 0 : _globalConfig9.apiKey) || null;
 };
 
-/**
- * Check if the SDK is properly initialized
- * @returns True if initialized with valid API key
+/**
+ * Check if the SDK is properly initialized
+ * @returns True if initialized with valid API key
  */
 export const isApiKeyInitialized = () => {
   return isInitialized && globalConfig !== null;
 };
 
-/**
- * Store JWT token securely after email verification
- * @param token JWT token from email verification response
+/**
+ * Store JWT token securely after email verification
+ * @param token JWT token from email verification response
  */
 export const storeJWT = async token => {
   try {
@@ -432,9 +432,9 @@ export const storeJWT = async token => {
   }
 };
 
-/**
- * Load JWT token from storage
- * @returns JWT token or null if not found
+/**
+ * Load JWT token from storage
+ * @returns JWT token or null if not found
  */
 export const loadJWT = async () => {
   try {
@@ -447,16 +447,16 @@ export const loadJWT = async () => {
   }
 };
 
-/**
- * Get current JWT token
- * @returns JWT token or null if not available
+/**
+ * Get current JWT token
+ * @returns JWT token or null if not available
  */
 export const getJWT = () => {
   return userToken;
 };
 
-/**
- * Clear JWT token (on logout or token expiration)
+/**
+ * Clear JWT token (on logout or token expiration)
  */
 export const clearJWT = async () => {
   try {
@@ -471,10 +471,10 @@ export const clearJWT = async () => {
   }
 };
 
-/**
- * React Native compatible base64 decoder
- * @param str Base64 encoded string
- * @returns Decoded string
+/**
+ * React Native compatible base64 decoder
+ * @param str Base64 encoded string
+ * @returns Decoded string
  */
 const base64Decode = str => {
   // Simple base64 decoding for React Native
@@ -495,10 +495,10 @@ const base64Decode = str => {
   return result;
 };
 
-/**
- * Decode JWT token payload (React Native compatible)
- * @param token JWT token string
- * @returns Decoded payload or null if invalid
+/**
+ * Decode JWT token payload (React Native compatible)
+ * @param token JWT token string
+ * @returns Decoded payload or null if invalid
  */
 export const decodeJWTPayload = token => {
   try {
@@ -525,10 +525,10 @@ export const decodeJWTPayload = token => {
   }
 };
 
-/**
- * Extract username from JWT token
- * @param token JWT token (optional, uses stored token if not provided)
- * @returns Username or null if not found
+/**
+ * Extract username from JWT token
+ * @param token JWT token (optional, uses stored token if not provided)
+ * @returns Username or null if not found
  */
 export const extractUsernameFromJWT = token => {
   try {
@@ -555,10 +555,10 @@ export const extractUsernameFromJWT = token => {
   }
 };
 
-/**
- * Extract user data from JWT token
- * @param token JWT token (optional, uses stored token if not provided)
- * @returns User data object or null if not found
+/**
+ * Extract user data from JWT token
+ * @param token JWT token (optional, uses stored token if not provided)
+ * @returns User data object or null if not found
  */
 export const extractUserDataFromJWT = token => {
   try {
@@ -591,17 +591,17 @@ export const extractUserDataFromJWT = token => {
   }
 };
 
-/**
- * Check if user is authenticated with JWT token
- * @returns True if user has valid JWT token
+/**
+ * Check if user is authenticated with JWT token
+ * @returns True if user has valid JWT token
  */
 export const isUserAuthenticated = () => {
   return !!userToken;
 };
 
-/**
- * Get authenticated headers for API requests
- * @returns Headers object with Authorization and other required headers
+/**
+ * Get authenticated headers for API requests
+ * @returns Headers object with Authorization and other required headers
  */
 export const getAuthHeaders = () => {
   var _globalConfig12;
@@ -620,9 +620,9 @@ export const getAuthHeaders = () => {
   };
 };
 
-/**
- * Get authentication headers for developer API requests
- * @returns Headers with developer API key
+/**
+ * Get authentication headers for developer API requests
+ * @returns Headers with developer API key
  */
 export const getDeveloperAuthHeaders = () => {
   var _globalConfig13;
@@ -641,9 +641,9 @@ export const getDeveloperAuthHeaders = () => {
   };
 };
 
-/**
- * Get authentication headers for user JWT requests
- * @returns Headers with user JWT token
+/**
+ * Get authentication headers for user JWT requests
+ * @returns Headers with user JWT token
  */
 export const getUserAuthHeaders = () => {
   var _globalConfig14;
@@ -659,11 +659,11 @@ export const getUserAuthHeaders = () => {
   };
 };
 
-/**
- * Make an authenticated API request
- * @param endpoint The API endpoint (relative to base URL)
- * @param options Fetch options
- * @returns Response promise
+/**
+ * Make an authenticated API request
+ * @param endpoint The API endpoint (relative to base URL)
+ * @param options Fetch options
+ * @returns Response promise
  */
 export const makeAuthenticatedRequest = async (endpoint, options = {}) => {
   if (!isApiKeyInitialized()) {
@@ -720,11 +720,11 @@ export const makeAuthenticatedRequest = async (endpoint, options = {}) => {
   }
 };
 
-/**
- * Make authenticated request with developer API key
- * @param endpoint The API endpoint
- * @param options Fetch options
- * @returns Response promise
+/**
+ * Make authenticated request with developer API key
+ * @param endpoint The API endpoint
+ * @param options Fetch options
+ * @returns Response promise
  */
 export const makeDeveloperRequest = async (endpoint, options = {}) => {
   if (!isApiKeyInitialized()) {
@@ -781,11 +781,11 @@ export const makeDeveloperRequest = async (endpoint, options = {}) => {
   }
 };
 
-/**
- * Make authenticated request with user JWT token
- * @param endpoint The API endpoint
- * @param options Fetch options
- * @returns Response promise
+/**
+ * Make authenticated request with user JWT token
+ * @param endpoint The API endpoint
+ * @param options Fetch options
+ * @returns Response promise
  */
 export const makeUserRequest = async (endpoint, options = {}) => {
   if (!isUserAuthenticated()) {
@@ -846,8 +846,8 @@ export const makeUserRequest = async (endpoint, options = {}) => {
   }
 };
 
-/**
- * Clear the API key validation cache
+/**
+ * Clear the API key validation cache
  */
 export const clearValidationCache = () => {
   var _globalConfig15;
@@ -857,8 +857,8 @@ export const clearValidationCache = () => {
   }
 };
 
-/**
- * Reset the SDK initialization state
+/**
+ * Reset the SDK initialization state
  */
 export const resetApiKeyService = () => {
   globalConfig = null;

package/lib/module/services/authService.js

@@ -8,27 +8,27 @@ const API_BASE_URL = API_CONFIG.BASE_URL;
 
 // Interface for Apple authentication payload
 
-/**
- * Interface for the timer response from backend
+/**
+ * Interface for the timer response from backend
  */
 
-/**
- * Interface for the profile response from backend
+/**
+ * Interface for the profile response from backend
  */
 
-/**
- * Interface for creating/updating user profile
+/**
+ * Interface for creating/updating user profile
  */
 
-/**
- * Authenticate with Apple
- * @param appleAuthData Data from Apple authentication
- * @returns Authentication response with token and user data
+/**
+ * Authenticate with Apple
+ * @param appleAuthData Data from Apple authentication
+ * @returns Authentication response with token and user data
  */
-/**
- * Authenticate with Onairos (similar to Apple authentication)
- * @param onairosAuthData Data from Onairos authentication
- * @returns Authentication response with token and user data
+/**
+ * Authenticate with Onairos (similar to Apple authentication)
+ * @param onairosAuthData Data from Onairos authentication
+ * @returns Authentication response with token and user data
  */
 export const authenticateWithOnairos = async onairosAuthData => {
   try {
@@ -78,10 +78,10 @@ export const authenticateWithOnairos = async onairosAuthData => {
   }
 };
 
-/**
- * Authenticate with Onairos using the standardized /login/signin endpoint
- * @param credentials Email and password for Onairos sign-in
- * @returns Authentication response with token and user data
+/**
+ * Authenticate with Onairos using the standardized /login/signin endpoint
+ * @param credentials Email and password for Onairos sign-in
+ * @returns Authentication response with token and user data
  */
 export const authenticateWithOnairosSignIn = async credentials => {
   try {
@@ -262,9 +262,9 @@ export const authenticateWithApple = async appleAuthData => {
   }
 };
 
-/**
- * Save authentication token
- * @param token JWT token
+/**
+ * Save authentication token
+ * @param token JWT token
  */
 export const saveAuthToken = async token => {
   try {
@@ -275,8 +275,8 @@ export const saveAuthToken = async token => {
   }
 };
 
-/**
- * Debug function to check all auth-related storage
+/**
+ * Debug function to check all auth-related storage
  */
 export const debugAuthStorage = async () => {
   console.log('🔍 [AUTH STORAGE DEBUG] Checking all auth-related storage:');
@@ -303,8 +303,8 @@ export const debugAuthStorage = async () => {
   });
 };
 
-/**
- * Clear all auth tokens and start fresh
+/**
+ * Clear all auth tokens and start fresh
  */
 export const clearAllAuthTokens = async () => {
   console.log('🧹 [AUTH DEBUG] Clearing all auth tokens via centralized service...');
@@ -320,9 +320,9 @@ export const clearAllAuthTokens = async () => {
   console.log('✅ [AUTH DEBUG] All auth tokens and data cleared');
 };
 
-/**
- * Get saved authentication token - CRITICAL FIX: Try all token types
- * @returns Saved JWT token or null if not found
+/**
+ * Get saved authentication token - CRITICAL FIX: Try all token types
+ * @returns Saved JWT token or null if not found
  */
 export const getAuthToken = async () => {
   try {
@@ -362,8 +362,8 @@ export const getAuthToken = async () => {
   }
 };
 
-/**
- * Remove authentication token (logout)
+/**
+ * Remove authentication token (logout)
  */
 export const removeAuthToken = async () => {
   try {
@@ -373,9 +373,9 @@ export const removeAuthToken = async () => {
   }
 };
 
-/**
- * Validate if user is properly authenticated
- * @returns boolean indicating if user has valid authentication
+/**
+ * Validate if user is properly authenticated
+ * @returns boolean indicating if user has valid authentication
  */
 export const isAuthenticated = async () => {
   try {
@@ -387,10 +387,10 @@ export const isAuthenticated = async () => {
   }
 };
 
-/**
- * Ensure authentication is available before making API calls
- * @param apiName - Name of the API being called (for logging)
- * @returns boolean indicating if authentication is available
+/**
+ * Ensure authentication is available before making API calls
+ * @param apiName - Name of the API being called (for logging)
+ * @returns boolean indicating if authentication is available
  */
 export const ensureAuthentication = async apiName => {
   const isAuth = await isAuthenticated();
@@ -402,9 +402,9 @@ export const ensureAuthentication = async apiName => {
   return isAuth;
 };
 
-/**
- * Get saved Enoch authentication token specifically
- * @returns Saved Enoch JWT token or null if not found
+/**
+ * Get saved Enoch authentication token specifically
+ * @returns Saved Enoch JWT token or null if not found
  */
 export const getEnochToken = async () => {
   try {
@@ -415,9 +415,9 @@ export const getEnochToken = async () => {
   }
 };
 
-/**
- * Save Enoch authentication token specifically
- * @param token Enoch JWT token
+/**
+ * Save Enoch authentication token specifically
+ * @param token Enoch JWT token
  */
 export const saveEnochToken = async token => {
   try {
@@ -429,9 +429,9 @@ export const saveEnochToken = async token => {
   }
 };
 
-/**
- * Verify token with backend
- * @returns Boolean indicating if token is valid
+/**
+ * Verify token with backend
+ * @returns Boolean indicating if token is valid
  */
 export const verifyToken = async () => {
   try {
@@ -461,10 +461,10 @@ export const verifyToken = async () => {
   }
 };
 
-/**
- * Get user profile from backend using stored token
- * Note: This endpoint doesn't exist as GET, so we'll try to fetch via other means
- * @returns User profile data
+/**
+ * Get user profile from backend using stored token
+ * Note: This endpoint doesn't exist as GET, so we'll try to fetch via other means
+ * @returns User profile data
  */
 export const getUserProfile = async () => {
   try {
@@ -575,10 +575,10 @@ export const getUserProfile = async () => {
   }
 };
 
-/**
- * Create or update user profile
- * @param profileData Profile data to create/update
- * @returns Profile response from backend
+/**
+ * Create or update user profile
+ * @param profileData Profile data to create/update
+ * @returns Profile response from backend
  */
 export const createOrUpdateProfile = async profileData => {
   try {
@@ -603,9 +603,9 @@ export const createOrUpdateProfile = async profileData => {
   }
 };
 
-/**
- * Update user's onboarded status
- * @returns Promise that resolves when update is successful
+/**
+ * Update user's onboarded status
+ * @returns Promise that resolves when update is successful
  */
 export const updateUserOnboardedStatus = async () => {
   try {
@@ -629,9 +629,9 @@ export const updateUserOnboardedStatus = async () => {
   }
 };
 
-/**
- * Fetch the current timer status from the backend
- * @returns Timer information including expiry and duration
+/**
+ * Fetch the current timer status from the backend
+ * @returns Timer information including expiry and duration
  */
 export const getEventTimer = async () => {
   try {
@@ -787,10 +787,10 @@ export const getEventTimer = async () => {
   }
 };
 
-/**
- * Check if a user email has admin privileges
- * @param email User email to check
- * @returns True if user is an admin
+/**
+ * Check if a user email has admin privileges
+ * @param email User email to check
+ * @returns True if user is an admin
  */
 export const isAdminEmail = email => {
   if (!email) {
@@ -807,9 +807,9 @@ export const isAdminEmail = email => {
   return isAdmin;
 };
 
-/**
- * Get the current admin status from AsyncStorage
- * This could be used for caching admin status between sessions
+/**
+ * Get the current admin status from AsyncStorage
+ * This could be used for caching admin status between sessions
  */
 export const getAdminStatus = async () => {
   try {
@@ -821,9 +821,9 @@ export const getAdminStatus = async () => {
   }
 };
 
-/**
- * Save admin status to AsyncStorage
- * @param isAdmin Whether the user is an admin
+/**
+ * Save admin status to AsyncStorage
+ * @param isAdmin Whether the user is an admin
  */
 export const saveAdminStatus = async isAdmin => {
   try {
@@ -833,10 +833,10 @@ export const saveAdminStatus = async isAdmin => {
   }
 };
 
-/**
- * Get stored Onairos username for API calls
- * This is used for data connector APIs (Reddit, etc.) that need the username
- * @returns Stored username or null if not found
+/**
+ * Get stored Onairos username for API calls
+ * This is used for data connector APIs (Reddit, etc.) that need the username
+ * @returns Stored username or null if not found
  */
 export const getOnairosUsername = async () => {
   try {
@@ -847,9 +847,9 @@ export const getOnairosUsername = async () => {
   }
 };
 
-/**
- * Save Onairos username for API calls
- * @param username Username to store
+/**
+ * Save Onairos username for API calls
+ * @param username Username to store
  */
 export const saveOnairosUsername = async username => {
   try {
@@ -859,11 +859,11 @@ export const saveOnairosUsername = async username => {
   }
 };
 
-/**
- * Check if user has connected Onairos to Enoch before
- * This checks for actual usage/training data, not just account existence
- * @param userIdentifier - Email, username, or user ID to check
- * @returns Promise<boolean> - true if user has connected Onairos features to Enoch
+/**
+ * Check if user has connected Onairos to Enoch before
+ * This checks for actual usage/training data, not just account existence
+ * @param userIdentifier - Email, username, or user ID to check
+ * @returns Promise<boolean> - true if user has connected Onairos features to Enoch
  */
 export const checkEnochOnairosConnection = async userIdentifier => {
   try {