@onairos/react-native 3.1.15 → 3.1.17

package/lib/commonjs/services/apiKeyService.js

@@ -18,23 +18,23 @@ let ApiKeyType = exports.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
@@ -53,9 +53,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
  */
 const initializeApiKey = async config => {
   try {
@@ -128,10 +128,10 @@ 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
  */
 exports.initializeApiKey = initializeApiKey;
 const getApiKeyType = apiKey => {
@@ -146,20 +146,20 @@ 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
  */
 exports.getApiKeyType = getApiKeyType;
 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
  */
 exports.isAdminKey = isAdminKey;
 const validateApiKey = async apiKey => {
@@ -396,18 +396,18 @@ 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
  */
 exports.validateApiKey = validateApiKey;
 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
  */
 exports.getApiConfig = getApiConfig;
 const getApiKey = () => {
@@ -415,18 +415,18 @@ const getApiKey = () => {
   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
  */
 exports.getApiKey = getApiKey;
 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
  */
 exports.isApiKeyInitialized = isApiKeyInitialized;
 const storeJWT = async token => {
@@ -443,9 +443,9 @@ 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
  */
 exports.storeJWT = storeJWT;
 const loadJWT = async () => {
@@ -459,17 +459,17 @@ 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
  */
 exports.loadJWT = loadJWT;
 const getJWT = () => {
   return userToken;
 };
 
-/**
- * Clear JWT token (on logout or token expiration)
+/**
+ * Clear JWT token (on logout or token expiration)
  */
 exports.getJWT = getJWT;
 const clearJWT = async () => {
@@ -485,10 +485,10 @@ 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
  */
 exports.clearJWT = clearJWT;
 const base64Decode = str => {
@@ -510,10 +510,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
  */
 const decodeJWTPayload = token => {
   try {
@@ -540,10 +540,10 @@ 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
  */
 exports.decodeJWTPayload = decodeJWTPayload;
 const extractUsernameFromJWT = token => {
@@ -571,10 +571,10 @@ 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
  */
 exports.extractUsernameFromJWT = extractUsernameFromJWT;
 const extractUserDataFromJWT = token => {
@@ -608,18 +608,18 @@ 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
  */
 exports.extractUserDataFromJWT = extractUserDataFromJWT;
 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
  */
 exports.isUserAuthenticated = isUserAuthenticated;
 const getAuthHeaders = () => {
@@ -639,9 +639,9 @@ 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
  */
 exports.getAuthHeaders = getAuthHeaders;
 const getDeveloperAuthHeaders = () => {
@@ -661,9 +661,9 @@ 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
  */
 exports.getDeveloperAuthHeaders = getDeveloperAuthHeaders;
 const getUserAuthHeaders = () => {
@@ -680,11 +680,11 @@ 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
  */
 exports.getUserAuthHeaders = getUserAuthHeaders;
 const makeAuthenticatedRequest = async (endpoint, options = {}) => {
@@ -742,11 +742,11 @@ 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
  */
 exports.makeAuthenticatedRequest = makeAuthenticatedRequest;
 const makeDeveloperRequest = async (endpoint, options = {}) => {
@@ -804,11 +804,11 @@ 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
  */
 exports.makeDeveloperRequest = makeDeveloperRequest;
 const makeUserRequest = async (endpoint, options = {}) => {
@@ -870,8 +870,8 @@ const makeUserRequest = async (endpoint, options = {}) => {
   }
 };
 
-/**
- * Clear the API key validation cache
+/**
+ * Clear the API key validation cache
  */
 exports.makeUserRequest = makeUserRequest;
 const clearValidationCache = () => {
@@ -882,8 +882,8 @@ const clearValidationCache = () => {
   }
 };
 
-/**
- * Reset the SDK initialization state
+/**
+ * Reset the SDK initialization state
  */
 exports.clearValidationCache = clearValidationCache;
 const resetApiKeyService = () => {

package/lib/commonjs/services/authService.js

@@ -15,27 +15,27 @@ const API_BASE_URL = _api.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
  */
 const authenticateWithOnairos = async onairosAuthData => {
   try {
@@ -85,10 +85,10 @@ 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
  */
 exports.authenticateWithOnairos = authenticateWithOnairos;
 const authenticateWithOnairosSignIn = async credentials => {
@@ -271,9 +271,9 @@ const authenticateWithApple = async appleAuthData => {
   }
 };
 
-/**
- * Save authentication token
- * @param token JWT token
+/**
+ * Save authentication token
+ * @param token JWT token
  */
 exports.authenticateWithApple = authenticateWithApple;
 const saveAuthToken = async token => {
@@ -285,8 +285,8 @@ const saveAuthToken = async token => {
   }
 };
 
-/**
- * Debug function to check all auth-related storage
+/**
+ * Debug function to check all auth-related storage
  */
 exports.saveAuthToken = saveAuthToken;
 const debugAuthStorage = async () => {
@@ -314,8 +314,8 @@ const debugAuthStorage = async () => {
   });
 };
 
-/**
- * Clear all auth tokens and start fresh
+/**
+ * Clear all auth tokens and start fresh
  */
 exports.debugAuthStorage = debugAuthStorage;
 const clearAllAuthTokens = async () => {
@@ -332,9 +332,9 @@ 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
  */
 exports.clearAllAuthTokens = clearAllAuthTokens;
 const getAuthToken = async () => {
@@ -375,8 +375,8 @@ const getAuthToken = async () => {
   }
 };
 
-/**
- * Remove authentication token (logout)
+/**
+ * Remove authentication token (logout)
  */
 exports.getAuthToken = getAuthToken;
 const removeAuthToken = async () => {
@@ -387,9 +387,9 @@ 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
  */
 exports.removeAuthToken = removeAuthToken;
 const isAuthenticated = async () => {
@@ -402,10 +402,10 @@ 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
  */
 exports.isAuthenticated = isAuthenticated;
 const ensureAuthentication = async apiName => {
@@ -418,9 +418,9 @@ 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
  */
 exports.ensureAuthentication = ensureAuthentication;
 const getEnochToken = async () => {
@@ -432,9 +432,9 @@ const getEnochToken = async () => {
   }
 };
 
-/**
- * Save Enoch authentication token specifically
- * @param token Enoch JWT token
+/**
+ * Save Enoch authentication token specifically
+ * @param token Enoch JWT token
  */
 exports.getEnochToken = getEnochToken;
 const saveEnochToken = async token => {
@@ -447,9 +447,9 @@ 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
  */
 exports.saveEnochToken = saveEnochToken;
 const verifyToken = async () => {
@@ -480,10 +480,10 @@ 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
  */
 exports.verifyToken = verifyToken;
 const getUserProfile = async () => {
@@ -595,10 +595,10 @@ 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
  */
 exports.getUserProfile = getUserProfile;
 const createOrUpdateProfile = async profileData => {
@@ -624,9 +624,9 @@ 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
  */
 exports.createOrUpdateProfile = createOrUpdateProfile;
 const updateUserOnboardedStatus = async () => {
@@ -651,9 +651,9 @@ 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
  */
 exports.updateUserOnboardedStatus = updateUserOnboardedStatus;
 const getEventTimer = async () => {
@@ -810,10 +810,10 @@ 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
  */
 exports.getEventTimer = getEventTimer;
 const isAdminEmail = email => {
@@ -831,9 +831,9 @@ 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
  */
 exports.isAdminEmail = isAdminEmail;
 const getAdminStatus = async () => {
@@ -846,9 +846,9 @@ 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
  */
 exports.getAdminStatus = getAdminStatus;
 const saveAdminStatus = async isAdmin => {
@@ -859,10 +859,10 @@ 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
  */
 exports.saveAdminStatus = saveAdminStatus;
 const getOnairosUsername = async () => {
@@ -874,9 +874,9 @@ 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
  */
 exports.getOnairosUsername = getOnairosUsername;
 const saveOnairosUsername = async username => {
@@ -887,11 +887,11 @@ 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
  */
 exports.saveOnairosUsername = saveOnairosUsername;
 const checkEnochOnairosConnection = async userIdentifier => {