@onairos/react-native 3.1.9 → 3.1.11

package/lib/commonjs/utils/retryHelper.js

@@ -0,0 +1,220 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NETWORK_RETRY_OPTIONS = exports.DEFAULT_RETRY_OPTIONS = exports.API_RETRY_OPTIONS = void 0;
+exports.fetchWithRetry = fetchWithRetry;
+exports.healthCheck = healthCheck;
+exports.withRetry = withRetry;
+/**
+ * 🔄 Retry Helper Utility
+ * 
+ * Provides robust retry logic with exponential backoff for network operations.
+ * Used throughout the Onairos SDK for handling transient failures gracefully.
+ */
+
+/**
+ * Default retry options for the Onairos SDK
+ */
+const DEFAULT_RETRY_OPTIONS = exports.DEFAULT_RETRY_OPTIONS = {
+  maxRetries: 3,
+  baseDelay: 1000,
+  maxDelay: 5000,
+  exponentialBackoff: true,
+  enableLogging: false,
+  shouldRetry: (error, attempt) => {
+    // Don't retry client errors (4xx) except for 408 (timeout) and 429 (rate limit)
+    if (error.status >= 400 && error.status < 500 && error.status !== 408 && error.status !== 429) {
+      return false;
+    }
+
+    // Retry network errors, timeouts, and server errors (5xx)
+    if (error.name === 'AbortError' || error.message.includes('Network request failed') || error.message.includes('fetch') || error.message.includes('ENOTFOUND') || error.message.includes('timeout') || error.status >= 500) {
+      return true;
+    }
+
+    // Retry JSON parse errors (likely server issues)
+    if (error.message.includes('JSON Parse error') || error.message.includes('Unexpected character')) {
+      return true;
+    }
+    return false;
+  }
+};
+
+/**
+ * Execute a function with retry logic and exponential backoff
+ * @param fn Function to execute (should return a Promise)
+ * @param options Retry configuration options
+ * @returns Promise with retry result
+ */
+async function withRetry(fn, options = {}) {
+  const config = {
+    ...DEFAULT_RETRY_OPTIONS,
+    ...options
+  };
+  const startTime = Date.now();
+  let lastError = null;
+  for (let attempt = 1; attempt <= config.maxRetries + 1; attempt++) {
+    try {
+      if (config.enableLogging && attempt > 1) {
+        console.log(`🔄 Retry attempt ${attempt}/${config.maxRetries + 1}`);
+      }
+      const result = await fn();
+      return {
+        success: true,
+        data: result,
+        attempts: attempt,
+        totalDuration: Date.now() - startTime
+      };
+    } catch (error) {
+      lastError = error;
+
+      // Check if we should retry this error
+      const shouldRetryError = config.shouldRetry ? config.shouldRetry(error, attempt) : true;
+
+      // If this is the last attempt or we shouldn't retry, throw the error
+      if (attempt > config.maxRetries || !shouldRetryError) {
+        if (config.enableLogging) {
+          console.error(`❌ All retry attempts exhausted or error not retryable: ${error.message}`);
+        }
+        break;
+      }
+
+      // Calculate delay for next attempt
+      let delay = config.baseDelay;
+      if (config.exponentialBackoff) {
+        delay = Math.min(config.baseDelay * Math.pow(2, attempt - 1), config.maxDelay);
+      }
+
+      // Add some jitter to prevent thundering herd
+      const jitter = Math.random() * 0.1 * delay;
+      delay = Math.floor(delay + jitter);
+      if (config.onRetry) {
+        config.onRetry(error, attempt, delay);
+      }
+      if (config.enableLogging) {
+        console.log(`⏳ Waiting ${delay}ms before retry (attempt ${attempt}/${config.maxRetries + 1})`);
+      }
+
+      // Wait before next attempt
+      await new Promise(resolve => setTimeout(() => resolve(), delay));
+    }
+  }
+  return {
+    success: false,
+    error: lastError || new Error('Unknown error'),
+    attempts: config.maxRetries + 1,
+    totalDuration: Date.now() - startTime
+  };
+}
+
+/**
+ * Retry configuration for API calls
+ */
+const API_RETRY_OPTIONS = exports.API_RETRY_OPTIONS = {
+  maxRetries: 3,
+  baseDelay: 1000,
+  maxDelay: 5000,
+  exponentialBackoff: true,
+  shouldRetry: (error, attempt) => {
+    // Enhanced retry logic for API calls
+
+    // Never retry authentication errors (401) or permission errors (403)
+    if (error.status === 401 || error.status === 403) {
+      return false;
+    }
+
+    // Never retry bad request errors (400) or not found (404) unless it's a specific case
+    if (error.status === 400 || error.status === 404 && !error.message.includes('validation endpoint')) {
+      return false;
+    }
+
+    // Retry rate limiting (429) with longer delays
+    if (error.status === 429) {
+      return attempt <= 2; // Limit retries for rate limiting
+    }
+
+    // Retry server errors (5xx)
+    if (error.status >= 500) {
+      return true;
+    }
+
+    // Retry timeout and network errors
+    if (error.name === 'AbortError' || error.message.includes('timeout') || error.message.includes('Network request failed') || error.message.includes('fetch') || error.message.includes('ENOTFOUND')) {
+      return true;
+    }
+
+    // Retry JSON parse errors (server returning HTML instead of JSON)
+    if (error.message.includes('JSON Parse error') || error.message.includes('Unexpected character') || error.message.includes('HTML page instead of JSON')) {
+      return true;
+    }
+    return false;
+  },
+  onRetry: (error, attempt, delay) => {
+    console.warn(`⚠️ API call failed (attempt ${attempt}), retrying in ${delay}ms: ${error.message}`);
+  }
+};
+
+/**
+ * Specialized retry for network/connectivity issues
+ */
+const NETWORK_RETRY_OPTIONS = exports.NETWORK_RETRY_OPTIONS = {
+  maxRetries: 2,
+  baseDelay: 2000,
+  maxDelay: 8000,
+  exponentialBackoff: true,
+  shouldRetry: (error, attempt) => {
+    // Only retry actual network/connectivity issues
+    return error.message.includes('Network request failed') || error.message.includes('ENOTFOUND') || error.message.includes('DNS') || error.name === 'AbortError';
+  }
+};
+
+/**
+ * Create a retry wrapper for fetch requests
+ * @param url Request URL
+ * @param options Fetch options
+ * @param retryOptions Retry configuration
+ * @returns Promise with fetch response
+ */
+async function fetchWithRetry(url, options = {}, retryOptions = API_RETRY_OPTIONS) {
+  const result = await withRetry(() => fetch(url, options), retryOptions);
+  if (!result.success) {
+    throw result.error;
+  }
+  return result.data;
+}
+
+/**
+ * Health check function with retry for testing connectivity
+ * @param url URL to check
+ * @param timeout Timeout in milliseconds
+ * @returns Promise indicating if the service is reachable
+ */
+async function healthCheck(url, timeout = 5000) {
+  const startTime = Date.now();
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    const response = await fetch(url, {
+      method: 'GET',
+      signal: controller.signal,
+      headers: {
+        'User-Agent': 'OnairosReactNative/HealthCheck'
+      }
+    });
+    clearTimeout(timeoutId);
+    return {
+      reachable: true,
+      status: response.status,
+      duration: Date.now() - startTime
+    };
+  } catch (error) {
+    return {
+      reachable: false,
+      error: error.message,
+      duration: Date.now() - startTime
+    };
+  }
+}
+//# sourceMappingURL=retryHelper.js.map

package/lib/commonjs/utils/retryHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_RETRY_OPTIONS","exports","maxRetries","baseDelay","maxDelay","exponentialBackoff","enableLogging","shouldRetry","error","attempt","status","name","message","includes","withRetry","fn","options","config","startTime","Date","now","lastError","console","log","result","success","data","attempts","totalDuration","shouldRetryError","delay","Math","min","pow","jitter","random","floor","onRetry","Promise","resolve","setTimeout","Error","API_RETRY_OPTIONS","warn","NETWORK_RETRY_OPTIONS","fetchWithRetry","url","retryOptions","fetch","healthCheck","timeout","controller","AbortController","timeoutId","abort","response","method","signal","headers","clearTimeout","reachable","duration"],"sourceRoot":"..\\..\\..\\src","sources":["utils/retryHelper.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/services/apiKeyService.js

@@ -87,7 +87,14 @@ export const initializeApiKey = async config => {
     // Validate the API key (handles both admin and developer keys)
     const validation = await validateApiKey(config.apiKey);
     if (!validation.isValid) {
-      throw new Error(`API key validation failed: ${validation.error}`);
+      var _validation$error, _validation$error2, _validation$error3;
+      // If it's a network error or JSON parse error, warn but don't fail initialization
+      if ((_validation$error = validation.error) !== null && _validation$error !== void 0 && _validation$error.includes('Network error') || (_validation$error2 = validation.error) !== null && _validation$error2 !== void 0 && _validation$error2.includes('JSON Parse error') || (_validation$error3 = validation.error) !== null && _validation$error3 !== void 0 && _validation$error3.includes('API validation endpoint returned')) {
+        console.warn('⚠️ API key validation failed due to network/server issues, continuing in offline mode:', validation.error);
+        console.warn('📝 SDK will function with limited validation. Ensure your API key is valid for production use.');
+      } else {
+        throw new Error(`API key validation failed: ${validation.error}`);
+      }
     }
 
     // Try to load existing JWT token
@@ -150,7 +157,7 @@ export const isAdminKey = apiKey => {
  */
 export const validateApiKey = async apiKey => {
   try {
-    var _globalConfig2, _globalConfig3;
+    var _globalConfig2, _globalConfig3, _globalConfig4;
     console.log('🔍 Validating API key...');
 
     // Check if it's an admin key
@@ -190,82 +197,187 @@ export const validateApiKey = async apiKey => {
     const environment = ((_globalConfig2 = globalConfig) === null || _globalConfig2 === void 0 ? void 0 : _globalConfig2.environment) || 'production';
     const baseUrl = API_ENDPOINTS[environment];
     const timeout = ((_globalConfig3 = globalConfig) === null || _globalConfig3 === void 0 ? void 0 : _globalConfig3.timeout) || 30000;
+    const maxRetries = ((_globalConfig4 = globalConfig) === null || _globalConfig4 === void 0 ? void 0 : _globalConfig4.retryAttempts) || 3;
+
+    // Retry logic for network failures
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      // Create abort controller for timeout
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), timeout);
+      try {
+        var _globalConfig5;
+        if ((_globalConfig5 = globalConfig) !== null && _globalConfig5 !== void 0 && _globalConfig5.enableLogging && attempt > 1) {
+          console.log(`🔄 Retry attempt ${attempt}/${maxRetries} for API key validation`);
+        }
+        const response = await fetch(`${baseUrl}/auth/validate-key`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+            'User-Agent': 'OnairosReactNative/3.1.10',
+            'X-API-Key-Type': keyType,
+            'X-SDK-Platform': 'react-native',
+            'X-Retry-Attempt': attempt.toString()
+          },
+          body: JSON.stringify({
+            environment,
+            sdk_version: '3.1.10',
+            platform: 'react-native',
+            keyType,
+            timestamp: new Date().toISOString(),
+            attempt
+          }),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
 
-    // Create abort controller for timeout
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeout);
-    try {
-      const response = await fetch(`${baseUrl}/auth/validate-key`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${apiKey}`,
-          'User-Agent': 'OnairosReactNative/1.0',
-          'X-API-Key-Type': keyType
-        },
-        body: JSON.stringify({
-          environment,
-          sdk_version: '3.0.72',
-          platform: 'react-native',
-          keyType,
-          timestamp: new Date().toISOString()
-        }),
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      const data = await response.json();
-      if (response.ok && data.success) {
-        var _globalConfig4;
-        const result = {
-          isValid: true,
-          permissions: data.permissions || [],
-          rateLimits: data.rateLimits || null,
-          keyType: keyType
-        };
-
-        // Cache the successful result
-        validationCache.set(apiKey, {
-          result,
-          timestamp: Date.now()
+        // First check if we got a valid response
+        if (!response) {
+          throw new Error('No response received from server');
+        }
+
+        // Check if response is actually JSON before trying to parse
+        const contentType = response.headers.get('content-type');
+        const isJsonResponse = contentType && contentType.includes('application/json');
+        if (!isJsonResponse) {
+          const textContent = await response.text();
+          const previewText = textContent.substring(0, 200);
+          console.error('❌ API endpoint returned non-JSON response:', {
+            status: response.status,
+            statusText: response.statusText,
+            contentType: contentType || 'unknown',
+            preview: previewText,
+            url: `${baseUrl}/auth/validate-key`,
+            attempt: attempt
+          });
+
+          // Handle specific error cases
+          if (response.status === 404) {
+            throw new Error(`API validation endpoint not found (404). The endpoint ${baseUrl}/auth/validate-key may not exist or be configured correctly.`);
+          } else if (response.status === 500) {
+            throw new Error(`Server error (500). The Onairos backend is experiencing issues.`);
+          } else if (response.status === 502 || response.status === 503) {
+            throw new Error(`Service unavailable (${response.status}). The Onairos backend may be temporarily down.`);
+          } else if (textContent.includes('<html') || textContent.includes('<!DOCTYPE')) {
+            throw new Error(`Server returned HTML page instead of JSON API response. This often indicates a routing issue or server misconfiguration.`);
+          } else {
+            throw new Error(`API validation endpoint returned ${response.status} - ${response.statusText}. Expected JSON but got ${contentType || 'unknown content type'}.`);
+          }
+        }
+
+        // Parse JSON response
+        let data;
+        try {
+          data = await response.json();
+        } catch (jsonError) {
+          console.error('❌ Failed to parse JSON response:', {
+            error: jsonError.message,
+            status: response.status,
+            contentType,
+            attempt: attempt
+          });
+          throw new Error(`Failed to parse server response as JSON: ${jsonError.message}`);
+        }
+
+        // Handle successful response
+        if (response.ok && data.success) {
+          var _globalConfig6;
+          const result = {
+            isValid: true,
+            permissions: data.permissions || [],
+            rateLimits: data.rateLimits || null,
+            keyType: keyType
+          };
+
+          // Cache the successful result
+          validationCache.set(apiKey, {
+            result,
+            timestamp: Date.now()
+          });
+          if ((_globalConfig6 = globalConfig) !== null && _globalConfig6 !== void 0 && _globalConfig6.enableLogging) {
+            console.log('✅ API key validation successful');
+          }
+          return result;
+        } else {
+          // Handle API errors (invalid key, etc.)
+          const errorMessage = data.error || data.message || `HTTP ${response.status}: ${response.statusText}`;
+          const result = {
+            isValid: false,
+            error: errorMessage,
+            keyType: keyType
+          };
+
+          // For client errors (4xx), don't retry
+          if (response.status >= 400 && response.status < 500) {
+            var _globalConfig7;
+            if ((_globalConfig7 = globalConfig) !== null && _globalConfig7 !== void 0 && _globalConfig7.enableLogging) {
+              console.error('❌ API key validation failed (client error):', errorMessage);
+            }
+            return result;
+          }
+
+          // For server errors (5xx), retry
+          throw new Error(errorMessage);
+        }
+      } catch (fetchError) {
+        var _globalConfig8;
+        clearTimeout(timeoutId);
+        if (fetchError.name === 'AbortError') {
+          const errorMessage = `API key validation timeout (${timeout}ms)`;
+          console.error('⏱️ API key validation timeout');
+          if (attempt === maxRetries) {
+            return {
+              isValid: false,
+              error: errorMessage,
+              keyType: keyType
+            };
+          }
+          continue; // Retry timeout errors
+        }
+
+        // Enhanced error message based on error type
+        let errorMessage = `Network error during API key validation: ${fetchError.message}`;
+
+        // Add specific guidance for common errors
+        if (fetchError.message.includes('JSON Parse error') || fetchError.message.includes('Unexpected character')) {
+          errorMessage = `Server returned invalid JSON response. This usually indicates the API endpoint returned HTML instead of JSON (often a 404 or server error page). ${fetchError.message}`;
+        } else if (fetchError.message.includes('Network request failed') || fetchError.message.includes('fetch')) {
+          errorMessage = `Network connectivity issue. Please check internet connection and verify the Onairos API is accessible. ${fetchError.message}`;
+        } else if (fetchError.message.includes('DNS') || fetchError.message.includes('ENOTFOUND')) {
+          errorMessage = `DNS resolution failed for ${baseUrl}. Please check network settings and domain accessibility. ${fetchError.message}`;
+        }
+        console.error('🌐 Network error during API key validation:', {
+          error: fetchError,
+          endpoint: `${baseUrl}/auth/validate-key`,
+          attempt: attempt,
+          maxRetries: maxRetries,
+          retryable: attempt < maxRetries
         });
-        if ((_globalConfig4 = globalConfig) !== null && _globalConfig4 !== void 0 && _globalConfig4.enableLogging) {
-          console.log('✅ API key validation successful');
+
+        // If this is the last attempt, return the error
+        if (attempt === maxRetries) {
+          return {
+            isValid: false,
+            error: errorMessage,
+            keyType: keyType
+          };
         }
-        return result;
-      } else {
-        var _globalConfig5;
-        const errorMessage = data.error || `HTTP ${response.status}: ${response.statusText}`;
-        const result = {
-          isValid: false,
-          error: errorMessage,
-          keyType: keyType
-        };
-
-        // Don't cache failed results
-        if ((_globalConfig5 = globalConfig) !== null && _globalConfig5 !== void 0 && _globalConfig5.enableLogging) {
-          console.error('❌ API key validation failed:', errorMessage);
+
+        // Wait before retrying (exponential backoff)
+        const backoffDelay = Math.min(1000 * Math.pow(2, attempt - 1), 5000);
+        if ((_globalConfig8 = globalConfig) !== null && _globalConfig8 !== void 0 && _globalConfig8.enableLogging) {
+          console.log(`⏳ Waiting ${backoffDelay}ms before retry...`);
         }
-        return result;
-      }
-    } catch (fetchError) {
-      clearTimeout(timeoutId);
-      if (fetchError.name === 'AbortError') {
-        const errorMessage = 'API key validation timeout';
-        console.error('⏱️ API key validation timeout');
-        return {
-          isValid: false,
-          error: errorMessage,
-          keyType: keyType
-        };
+        await new Promise(resolve => setTimeout(() => resolve(), backoffDelay));
       }
-      const errorMessage = `Network error during API key validation: ${fetchError.message}`;
-      console.error('🌐 Network error during API key validation:', fetchError);
-      return {
-        isValid: false,
-        error: errorMessage,
-        keyType: keyType
-      };
     }
+
+    // This should never be reached, but just in case
+    return {
+      isValid: false,
+      error: 'All retry attempts exhausted',
+      keyType: keyType
+    };
   } catch (error) {
     const errorMessage = `API key validation error: ${error.message}`;
     console.error('❌ API key validation error:', error);
@@ -290,8 +402,8 @@ export const getApiConfig = () => {
  * @returns Current API key or null if not initialized
  */
 export const getApiKey = () => {
-  var _globalConfig6;
-  return ((_globalConfig6 = globalConfig) === null || _globalConfig6 === void 0 ? void 0 : _globalConfig6.apiKey) || null;
+  var _globalConfig9;
+  return ((_globalConfig9 = globalConfig) === null || _globalConfig9 === void 0 ? void 0 : _globalConfig9.apiKey) || null;
 };
 
 /**
@@ -308,10 +420,10 @@ export const isApiKeyInitialized = () => {
  */
 export const storeJWT = async token => {
   try {
-    var _globalConfig7;
+    var _globalConfig0;
     await AsyncStorage.setItem(JWT_TOKEN_KEY, token);
     userToken = token;
-    if ((_globalConfig7 = globalConfig) !== null && _globalConfig7 !== void 0 && _globalConfig7.enableLogging) {
+    if ((_globalConfig0 = globalConfig) !== null && _globalConfig0 !== void 0 && _globalConfig0.enableLogging) {
       console.log('🎫 JWT token stored successfully');
     }
   } catch (error) {
@@ -348,10 +460,10 @@ export const getJWT = () => {
  */
 export const clearJWT = async () => {
   try {
-    var _globalConfig8;
+    var _globalConfig1;
     await AsyncStorage.removeItem(JWT_TOKEN_KEY);
     userToken = null;
-    if ((_globalConfig8 = globalConfig) !== null && _globalConfig8 !== void 0 && _globalConfig8.enableLogging) {
+    if ((_globalConfig1 = globalConfig) !== null && _globalConfig1 !== void 0 && _globalConfig1.enableLogging) {
       console.log('🗑️ JWT token cleared');
     }
   } catch (error) {
@@ -420,7 +532,7 @@ export const decodeJWTPayload = token => {
  */
 export const extractUsernameFromJWT = token => {
   try {
-    var _globalConfig9;
+    var _globalConfig10;
     const jwtToken = token || userToken;
     if (!jwtToken) {
       console.warn('⚠️ No JWT token available for username extraction');
@@ -433,7 +545,7 @@ export const extractUsernameFromJWT = token => {
 
     // Try different possible username fields in order of preference
     const username = payload.userName || payload.username || payload.userId || payload.email;
-    if ((_globalConfig9 = globalConfig) !== null && _globalConfig9 !== void 0 && _globalConfig9.enableLogging) {
+    if ((_globalConfig10 = globalConfig) !== null && _globalConfig10 !== void 0 && _globalConfig10.enableLogging) {
       console.log('👤 Extracted username from JWT:', username);
     }
     return username || null;
@@ -450,7 +562,7 @@ export const extractUsernameFromJWT = token => {
  */
 export const extractUserDataFromJWT = token => {
   try {
-    var _globalConfig0;
+    var _globalConfig11;
     const jwtToken = token || userToken;
     if (!jwtToken) {
       console.warn('⚠️ No JWT token available for user data extraction');
@@ -469,7 +581,7 @@ export const extractUserDataFromJWT = token => {
       iat: payload.iat,
       exp: payload.exp
     };
-    if ((_globalConfig0 = globalConfig) !== null && _globalConfig0 !== void 0 && _globalConfig0.enableLogging) {
+    if ((_globalConfig11 = globalConfig) !== null && _globalConfig11 !== void 0 && _globalConfig11.enableLogging) {
       console.log('👤 Extracted user data from JWT:', userData);
     }
     return userData;
@@ -492,8 +604,8 @@ export const isUserAuthenticated = () => {
  * @returns Headers object with Authorization and other required headers
  */
 export const getAuthHeaders = () => {
-  var _globalConfig1;
-  if (!((_globalConfig1 = globalConfig) !== null && _globalConfig1 !== void 0 && _globalConfig1.apiKey)) {
+  var _globalConfig12;
+  if (!((_globalConfig12 = globalConfig) !== null && _globalConfig12 !== void 0 && _globalConfig12.apiKey)) {
     throw new Error('SDK not initialized. Call initializeApiKey() first.');
   }
   const keyType = getApiKeyType(globalConfig.apiKey);
@@ -513,8 +625,8 @@ export const getAuthHeaders = () => {
  * @returns Headers with developer API key
  */
 export const getDeveloperAuthHeaders = () => {
-  var _globalConfig10;
-  if (!((_globalConfig10 = globalConfig) !== null && _globalConfig10 !== void 0 && _globalConfig10.apiKey)) {
+  var _globalConfig13;
+  if (!((_globalConfig13 = globalConfig) !== null && _globalConfig13 !== void 0 && _globalConfig13.apiKey)) {
     throw new Error('SDK not initialized. Call initializeApiKey() first.');
   }
   const keyType = getApiKeyType(globalConfig.apiKey);
@@ -534,7 +646,7 @@ export const getDeveloperAuthHeaders = () => {
  * @returns Headers with user JWT token
  */
 export const getUserAuthHeaders = () => {
-  var _globalConfig11;
+  var _globalConfig14;
   if (!userToken) {
     throw new Error('User not authenticated. Please verify email first.');
   }
@@ -543,7 +655,7 @@ export const getUserAuthHeaders = () => {
     'Authorization': `Bearer ${userToken}`,
     'User-Agent': 'OnairosSDK/1.0.0',
     'X-SDK-Version': '3.0.72',
-    'X-SDK-Environment': ((_globalConfig11 = globalConfig) === null || _globalConfig11 === void 0 ? void 0 : _globalConfig11.environment) || 'production'
+    'X-SDK-Environment': ((_globalConfig14 = globalConfig) === null || _globalConfig14 === void 0 ? void 0 : _globalConfig14.environment) || 'production'
   };
 };
 
@@ -738,9 +850,9 @@ export const makeUserRequest = async (endpoint, options = {}) => {
  * Clear the API key validation cache
  */
 export const clearValidationCache = () => {
-  var _globalConfig12;
+  var _globalConfig15;
   validationCache.clear();
-  if ((_globalConfig12 = globalConfig) !== null && _globalConfig12 !== void 0 && _globalConfig12.enableLogging) {
+  if ((_globalConfig15 = globalConfig) !== null && _globalConfig15 !== void 0 && _globalConfig15.enableLogging) {
     console.log('🗑️ API key validation cache cleared');
   }
 };