@oxyhq/services 5.16.23 → 5.16.25

package/lib/module/utils/cache.js

@@ -0,0 +1,250 @@
+"use strict";
+
+/**
+ * Centralized cache utility with TTL support
+ * 
+ * This is a production-ready cache implementation used across the codebase
+ * for consistent caching behavior and performance optimization.
+ */
+
+/**
+ * Cache entry with expiration tracking
+ */
+
+/**
+ * Cache statistics
+ */
+
+/**
+ * TTL-based cache implementation
+ * 
+ * Features:
+ * - Automatic expiration based on TTL
+ * - Manual cleanup of expired entries
+ * - Statistics tracking (hits, misses, hit rate)
+ * - Type-safe generic interface
+ * 
+ * @example
+ * ```typescript
+ * const cache = new TTLCache<string>(5 * 60 * 1000); // 5 minutes
+ * 
+ * // Set with default TTL
+ * cache.set('key', 'value');
+ * 
+ * // Set with custom TTL
+ * cache.set('key', 'value', 10 * 60 * 1000); // 10 minutes
+ * 
+ * // Get value
+ * const value = cache.get('key');
+ * 
+ * // Get statistics
+ * const stats = cache.getStats();
+ * ```
+ */
+export class TTLCache {
+  cache = new Map();
+  hits = 0;
+  misses = 0;
+
+  /**
+   * Create a new TTL cache
+   * @param defaultTTL Default TTL in milliseconds (default: 5 minutes)
+   */
+  constructor(defaultTTL = 5 * 60 * 1000) {
+    this.defaultTTL = defaultTTL;
+  }
+
+  /**
+   * Get a value from cache
+   * @param key Cache key
+   * @returns Cached value or null if not found or expired
+   */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this.misses++;
+      return null;
+    }
+    const now = Date.now();
+    if (now > entry.expiresAt) {
+      this.cache.delete(key);
+      this.misses++;
+      return null;
+    }
+    this.hits++;
+    return entry.data;
+  }
+
+  /**
+   * Set a value in cache
+   * @param key Cache key
+   * @param data Data to cache
+   * @param ttl Optional TTL override (uses default if not provided)
+   */
+  set(key, data, ttl) {
+    const now = Date.now();
+    const expiresAt = now + (ttl || this.defaultTTL);
+    this.cache.set(key, {
+      data,
+      timestamp: now,
+      expiresAt
+    });
+  }
+
+  /**
+   * Delete a specific cache entry
+   * @param key Cache key
+   * @returns true if entry was deleted, false if not found
+   */
+  delete(key) {
+    return this.cache.delete(key);
+  }
+
+  /**
+   * Clear all cache entries
+   */
+  clear() {
+    this.cache.clear();
+    this.hits = 0;
+    this.misses = 0;
+  }
+
+  /**
+   * Check if a key exists and is not expired
+   * @param key Cache key
+   * @returns true if key exists and is valid
+   */
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+
+  /**
+   * Get all valid cache keys
+   * @returns Array of valid cache keys
+   */
+  keys() {
+    const now = Date.now();
+    const validKeys = [];
+    for (const [key, entry] of this.cache.entries()) {
+      if (now <= entry.expiresAt) {
+        validKeys.push(key);
+      } else {
+        this.cache.delete(key);
+      }
+    }
+    return validKeys;
+  }
+
+  /**
+   * Clean up expired entries
+   * @returns Number of entries removed
+   */
+  cleanup() {
+    const now = Date.now();
+    let removed = 0;
+    for (const [key, entry] of this.cache.entries()) {
+      if (now > entry.expiresAt) {
+        this.cache.delete(key);
+        removed++;
+      }
+    }
+    return removed;
+  }
+
+  /**
+   * Get cache size (number of entries)
+   */
+  size() {
+    return this.cache.size;
+  }
+
+  /**
+   * Get cache statistics
+   */
+  getStats() {
+    const total = this.hits + this.misses;
+    return {
+      size: this.cache.size,
+      hits: this.hits,
+      misses: this.misses,
+      hitRate: total > 0 ? this.hits / total : 0
+    };
+  }
+
+  /**
+   * Reset statistics (keeps cache entries)
+   */
+  resetStats() {
+    this.hits = 0;
+    this.misses = 0;
+  }
+}
+
+/**
+ * Create a TTL cache instance (convenience function)
+ * 
+ * @example
+ * ```typescript
+ * const cache = createCache<string>(5 * 60 * 1000);
+ * ```
+ */
+export function createCache(ttl = 5 * 60 * 1000) {
+  return new TTLCache(ttl);
+}
+
+/**
+ * Global cache cleanup interval (runs every minute)
+ * This helps prevent memory leaks from expired cache entries
+ */
+let cleanupInterval = null;
+const activeCaches = new Set();
+
+/**
+ * Register a cache for automatic cleanup
+ * @param cache Cache instance to register
+ */
+export function registerCacheForCleanup(cache) {
+  activeCaches.add(cache);
+
+  // Start cleanup interval if not already running
+  if (!cleanupInterval) {
+    cleanupInterval = setInterval(() => {
+      for (const cache of activeCaches) {
+        cache.cleanup();
+      }
+    }, 60000); // Every minute
+  }
+}
+
+/**
+ * Unregister a cache from automatic cleanup
+ * @param cache Cache instance to unregister
+ */
+export function unregisterCacheFromCleanup(cache) {
+  activeCaches.delete(cache);
+
+  // Stop cleanup interval if no caches are registered
+  if (activeCaches.size === 0 && cleanupInterval) {
+    clearInterval(cleanupInterval);
+    cleanupInterval = null;
+  }
+}
+
+/**
+ * Stop all cleanup intervals (useful for testing)
+ * This will clear the interval and unregister all caches
+ */
+export function stopAllCleanupIntervals() {
+  if (cleanupInterval) {
+    clearInterval(cleanupInterval);
+    cleanupInterval = null;
+  }
+  activeCaches.clear();
+}
+//# sourceMappingURL=cache.js.map

package/lib/module/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TTLCache","cache","Map","hits","misses","constructor","defaultTTL","get","key","entry","now","Date","expiresAt","delete","data","set","ttl","timestamp","clear","has","keys","validKeys","entries","push","cleanup","removed","size","getStats","total","hitRate","resetStats","createCache","cleanupInterval","activeCaches","Set","registerCacheForCleanup","add","setInterval","unregisterCacheFromCleanup","clearInterval","stopAllCleanupIntervals"],"sourceRoot":"../../../src","sources":["utils/cache.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/deviceManager.js

@@ -0,0 +1,171 @@
+"use strict";
+
+/**
+ * Client-side device management utility
+ * Handles persistent device identification across app sessions
+ */
+export class DeviceManager {
+  static DEVICE_KEY = 'oxy_device_info';
+
+  /**
+   * Check if we're in React Native environment
+   */
+  static isReactNative() {
+    return typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+  }
+
+  /**
+   * Get appropriate storage for the platform
+   */
+  static async getStorage() {
+    if (this.isReactNative()) {
+      try {
+        const asyncStorageModule = await import('@react-native-async-storage/async-storage');
+        const storage = asyncStorageModule.default;
+        return {
+          getItem: storage.getItem.bind(storage),
+          setItem: storage.setItem.bind(storage),
+          removeItem: storage.removeItem.bind(storage)
+        };
+      } catch (error) {
+        console.error('AsyncStorage not available in React Native:', error);
+        throw new Error('AsyncStorage is required in React Native environment');
+      }
+    } else {
+      // Use localStorage for web
+      return {
+        getItem: async key => localStorage.getItem(key),
+        setItem: async (key, value) => localStorage.setItem(key, value),
+        removeItem: async key => localStorage.removeItem(key)
+      };
+    }
+  }
+
+  /**
+   * Get or create device fingerprint for current device
+   */
+  static getDeviceFingerprint() {
+    const fingerprint = {
+      userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'unknown',
+      platform: typeof navigator !== 'undefined' ? navigator.platform : 'unknown',
+      language: typeof navigator !== 'undefined' ? navigator.language : undefined,
+      timezone: typeof Intl !== 'undefined' ? Intl.DateTimeFormat().resolvedOptions().timeZone : undefined
+    };
+
+    // Add screen info if available
+    if (typeof screen !== 'undefined') {
+      fingerprint.screen = {
+        width: screen.width,
+        height: screen.height,
+        colorDepth: screen.colorDepth
+      };
+    }
+    return fingerprint;
+  }
+
+  /**
+   * Get stored device info or create new one
+   */
+  static async getDeviceInfo() {
+    try {
+      const storage = await this.getStorage();
+      const stored = await storage.getItem(this.DEVICE_KEY);
+      if (stored) {
+        const deviceInfo = JSON.parse(stored);
+
+        // Update last used timestamp
+        deviceInfo.lastUsed = new Date().toISOString();
+        await this.saveDeviceInfo(deviceInfo);
+        return deviceInfo;
+      }
+
+      // Create new device info
+      return await this.createNewDeviceInfo();
+    } catch (error) {
+      console.error('Error getting device info:', error);
+      return await this.createNewDeviceInfo();
+    }
+  }
+
+  /**
+   * Create new device info and store it
+   */
+  static async createNewDeviceInfo() {
+    const deviceInfo = {
+      deviceId: this.generateDeviceId(),
+      fingerprint: JSON.stringify(this.getDeviceFingerprint()),
+      createdAt: new Date().toISOString(),
+      lastUsed: new Date().toISOString()
+    };
+    await this.saveDeviceInfo(deviceInfo);
+    return deviceInfo;
+  }
+
+  /**
+   * Save device info to storage
+   */
+  static async saveDeviceInfo(deviceInfo) {
+    try {
+      const storage = await this.getStorage();
+      await storage.setItem(this.DEVICE_KEY, JSON.stringify(deviceInfo));
+    } catch (error) {
+      console.error('Error saving device info:', error);
+    }
+  }
+
+  /**
+   * Update device name
+   */
+  static async updateDeviceName(deviceName) {
+    try {
+      const deviceInfo = await this.getDeviceInfo();
+      deviceInfo.deviceName = deviceName;
+      await this.saveDeviceInfo(deviceInfo);
+    } catch (error) {
+      console.error('Error updating device name:', error);
+    }
+  }
+
+  /**
+   * Clear stored device info (useful for testing or reset)
+   */
+  static async clearDeviceInfo() {
+    try {
+      const storage = await this.getStorage();
+      await storage.removeItem(this.DEVICE_KEY);
+    } catch (error) {
+      console.error('Error clearing device info:', error);
+    }
+  }
+
+  /**
+   * Generate a unique device ID
+   */
+  static generateDeviceId() {
+    // Use crypto.getRandomValues if available, otherwise fallback to Math.random
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+      const array = new Uint8Array(32);
+      crypto.getRandomValues(array);
+      return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');
+    } else {
+      // Fallback for environments without crypto.getRandomValues
+      return 'device_' + Date.now().toString(36) + Math.random().toString(36).substr(2);
+    }
+  }
+
+  /**
+   * Get a user-friendly device name based on platform
+   */
+  static getDefaultDeviceName() {
+    const fingerprint = this.getDeviceFingerprint();
+    const platform = (fingerprint.platform || '').toLowerCase();
+    if (platform.includes('win')) return 'Windows Computer';
+    if (platform.includes('mac')) return 'Mac Computer';
+    if (platform.includes('linux')) return 'Linux Computer';
+    if (platform.includes('iphone')) return 'iPhone';
+    if (platform.includes('ipad')) return 'iPad';
+    if (platform.includes('android')) return 'Android Device';
+    return 'Unknown Device';
+  }
+}
+//# sourceMappingURL=deviceManager.js.map

package/lib/module/utils/deviceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DeviceManager","DEVICE_KEY","isReactNative","navigator","product","getStorage","asyncStorageModule","storage","default","getItem","bind","setItem","removeItem","error","console","Error","key","localStorage","value","getDeviceFingerprint","fingerprint","userAgent","platform","language","undefined","timezone","Intl","DateTimeFormat","resolvedOptions","timeZone","screen","width","height","colorDepth","getDeviceInfo","stored","deviceInfo","JSON","parse","lastUsed","Date","toISOString","saveDeviceInfo","createNewDeviceInfo","deviceId","generateDeviceId","stringify","createdAt","updateDeviceName","deviceName","clearDeviceInfo","crypto","getRandomValues","array","Uint8Array","Array","from","byte","toString","padStart","join","now","Math","random","substr","getDefaultDeviceName","toLowerCase","includes"],"sourceRoot":"../../../src","sources":["utils/deviceManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/errorUtils.js

@@ -0,0 +1,167 @@
+"use strict";
+
+import { logger } from './loggerUtils';
+
+/**
+ * Error handling utilities for consistent error processing
+ */
+
+/**
+ * Common error codes
+ */
+export const ErrorCodes = {
+  // Authentication errors
+  UNAUTHORIZED: 'UNAUTHORIZED',
+  FORBIDDEN: 'FORBIDDEN',
+  INVALID_TOKEN: 'INVALID_TOKEN',
+  MISSING_TOKEN: 'MISSING_TOKEN',
+  // Validation errors
+  VALIDATION_ERROR: 'VALIDATION_ERROR',
+  BAD_REQUEST: 'BAD_REQUEST',
+  MISSING_PARAMETER: 'MISSING_PARAMETER',
+  INVALID_FORMAT: 'INVALID_FORMAT',
+  // Resource errors
+  NOT_FOUND: 'NOT_FOUND',
+  ALREADY_EXISTS: 'ALREADY_EXISTS',
+  CONFLICT: 'CONFLICT',
+  // Server errors
+  INTERNAL_ERROR: 'INTERNAL_ERROR',
+  SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+  TIMEOUT: 'TIMEOUT',
+  // Network errors
+  NETWORK_ERROR: 'NETWORK_ERROR',
+  CONNECTION_FAILED: 'CONNECTION_FAILED'
+};
+
+/**
+ * Create a standardized API error
+ */
+export function createApiError(message, code = ErrorCodes.INTERNAL_ERROR, status = 500, details) {
+  return {
+    message,
+    code,
+    status,
+    details
+  };
+}
+
+/**
+ * Handle common HTTP errors and convert to ApiError
+ */
+export function handleHttpError(error) {
+  // If it's already an ApiError, ensure it has a non-empty message
+  if (error && typeof error === 'object' && 'code' in error && 'status' in error) {
+    const apiError = error;
+    // Ensure message is not empty
+    if (!apiError.message || !apiError.message.trim()) {
+      return {
+        ...apiError,
+        message: apiError.message || 'An error occurred'
+      };
+    }
+    return apiError;
+  }
+
+  // Handle AbortError (timeout or cancelled requests)
+  if (error instanceof Error && error.name === 'AbortError') {
+    return createApiError('Request timeout or cancelled', ErrorCodes.TIMEOUT, 0);
+  }
+
+  // Handle TypeError (network failures, CORS, etc.)
+  if (error instanceof TypeError) {
+    // Check if it's a network-related TypeError
+    if (error.message.includes('fetch') || error.message.includes('network') || error.message.includes('Failed to fetch')) {
+      return createApiError('Network error - failed to connect to server', ErrorCodes.NETWORK_ERROR, 0);
+    }
+    return createApiError(error.message || 'Network error occurred', ErrorCodes.NETWORK_ERROR, 0);
+  }
+
+  // Handle fetch Response errors - check if it has response property with status
+  if (error && typeof error === 'object' && 'response' in error) {
+    const fetchError = error;
+    const status = fetchError.response?.status || fetchError.status;
+    if (status) {
+      return createApiError(fetchError.message || `HTTP ${status} error`, getErrorCodeFromStatus(status), status);
+    }
+  }
+
+  // Handle standard errors
+  if (error instanceof Error) {
+    // Check for common error patterns
+    if (error.message.includes('timeout') || error.message.includes('aborted')) {
+      return createApiError('Request timeout', ErrorCodes.TIMEOUT, 0);
+    }
+    if (error.message.includes('network') || error.message.includes('fetch')) {
+      return createApiError(error.message || 'Network error occurred', ErrorCodes.NETWORK_ERROR, 0);
+    }
+    return createApiError(error.message || 'Unknown error occurred', ErrorCodes.INTERNAL_ERROR, 500);
+  }
+
+  // Handle other errors - ensure we always return a non-empty message
+  const errorString = error ? String(error) : '';
+  const message = errorString.trim() || 'Unknown error occurred';
+  return createApiError(message, ErrorCodes.INTERNAL_ERROR, 500);
+}
+
+/**
+ * Get error code from HTTP status
+ * Exported for use in other modules
+ */
+export function getErrorCodeFromStatus(status) {
+  switch (status) {
+    case 400:
+      return ErrorCodes.BAD_REQUEST;
+    case 401:
+      return ErrorCodes.UNAUTHORIZED;
+    case 403:
+      return ErrorCodes.FORBIDDEN;
+    case 404:
+      return ErrorCodes.NOT_FOUND;
+    case 409:
+      return ErrorCodes.CONFLICT;
+    case 422:
+      return ErrorCodes.VALIDATION_ERROR;
+    case 500:
+      return ErrorCodes.INTERNAL_ERROR;
+    case 503:
+      return ErrorCodes.SERVICE_UNAVAILABLE;
+    default:
+      return ErrorCodes.INTERNAL_ERROR;
+  }
+}
+
+/**
+ * Validate required fields and throw error if missing
+ */
+export function validateRequiredFields(data, fields) {
+  const missing = fields.filter(field => !data[field]);
+  if (missing.length > 0) {
+    throw createApiError(`Missing required fields: ${missing.join(', ')}`, ErrorCodes.MISSING_PARAMETER, 400);
+  }
+}
+
+/**
+ * Safe error logging with context
+ */
+export function logError(error, context) {
+  if (error instanceof Error) {
+    logger.error(error.message, {
+      component: context || 'errorUtils',
+      method: 'logError',
+      stack: error.stack
+    });
+  } else {
+    logger.error(String(error), {
+      component: context || 'errorUtils',
+      method: 'logError'
+    });
+  }
+}
+
+/**
+ * Retry function with exponential backoff
+ * Re-exports retryAsync for backward compatibility
+ * @deprecated Use retryAsync from asyncUtils instead
+ */
+export { retryAsync as retryWithBackoff } from './asyncUtils';
+//# sourceMappingURL=errorUtils.js.map

package/lib/module/utils/errorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["logger","ErrorCodes","UNAUTHORIZED","FORBIDDEN","INVALID_TOKEN","MISSING_TOKEN","VALIDATION_ERROR","BAD_REQUEST","MISSING_PARAMETER","INVALID_FORMAT","NOT_FOUND","ALREADY_EXISTS","CONFLICT","INTERNAL_ERROR","SERVICE_UNAVAILABLE","TIMEOUT","NETWORK_ERROR","CONNECTION_FAILED","createApiError","message","code","status","details","handleHttpError","error","apiError","trim","Error","name","TypeError","includes","fetchError","response","getErrorCodeFromStatus","errorString","String","validateRequiredFields","data","fields","missing","filter","field","length","join","logError","context","component","method","stack","retryAsync","retryWithBackoff"],"sourceRoot":"../../../src","sources":["utils/errorUtils.ts"],"mappings":"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","ignoreList":[]}