@oxyhq/services 5.13.0 → 5.13.2

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 cache cleanup intervals
+ * Useful for tests to prevent Jest from hanging
+ */
+export function stopAllCacheCleanup() {
+  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","stopAllCacheCleanup"],"sourceRoot":"../../../src","sources":["utils/cache.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/index.js

@@ -1,4 +1,11 @@
 "use strict";
 
 export { DeviceManager } from './deviceManager';
+// Request utilities
+export { RequestDeduplicator, RequestQueue, SimpleLogger } from './requestUtils';
+
+// Cache utilities
+export { TTLCache, createCache, registerCacheForCleanup, unregisterCacheFromCleanup, stopAllCacheCleanup } from './cache';
+// Session utilities
+export { normalizeSession, sortSessions, deduplicateSessions, deduplicateSessionsByUserId, normalizeAndSortSessions, mergeSessions, sessionsEqual, sessionsArraysEqual } from './sessionUtils';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["DeviceManager"],"sourceRoot":"../../../src","sources":["utils/index.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,iBAAiB","ignoreList":[]}
+{"version":3,"names":["DeviceManager","RequestDeduplicator","RequestQueue","SimpleLogger","TTLCache","createCache","registerCacheForCleanup","unregisterCacheFromCleanup","stopAllCacheCleanup","normalizeSession","sortSessions","deduplicateSessions","deduplicateSessionsByUserId","normalizeAndSortSessions","mergeSessions","sessionsEqual","sessionsArraysEqual"],"sourceRoot":"../../../src","sources":["utils/index.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,iBAAiB;AAG/C;AACA,SAASC,mBAAmB,EAAEC,YAAY,EAAEC,YAAY,QAAQ,gBAAgB;;AAEhF;AACA,SAASC,QAAQ,EAAEC,WAAW,EAAEC,uBAAuB,EAAEC,0BAA0B,EAAEC,mBAAmB,QAAQ,SAAS;AAGzH;AACA,SACEC,gBAAgB,EAChBC,YAAY,EACZC,mBAAmB,EACnBC,2BAA2B,EAC3BC,wBAAwB,EACxBC,aAAa,EACbC,aAAa,EACbC,mBAAmB,QACd,gBAAgB","ignoreList":[]}

package/lib/module/utils/languageUtils.js

@@ -0,0 +1,151 @@
+"use strict";
+
+/**
+ * Language utilities for OxyServices
+ * Provides access to supported languages and language metadata
+ */
+
+// Supported languages with their metadata
+export const SUPPORTED_LANGUAGES = [{
+  id: 'en-US',
+  name: 'English',
+  nativeName: 'English',
+  flag: '🇺🇸',
+  icon: 'language-outline',
+  color: '#007AFF'
+}, {
+  id: 'es-ES',
+  name: 'Spanish',
+  nativeName: 'Español',
+  flag: '🇪🇸',
+  icon: 'language-outline',
+  color: '#FF3B30'
+}, {
+  id: 'ca-ES',
+  name: 'Catalan',
+  nativeName: 'Català',
+  flag: '🇪🇸',
+  icon: 'language-outline',
+  color: '#0CA678'
+}, {
+  id: 'fr-FR',
+  name: 'French',
+  nativeName: 'Français',
+  flag: '🇫🇷',
+  icon: 'language-outline',
+  color: '#5856D6'
+}, {
+  id: 'de-DE',
+  name: 'German',
+  nativeName: 'Deutsch',
+  flag: '🇩🇪',
+  icon: 'language-outline',
+  color: '#FF9500'
+}, {
+  id: 'it-IT',
+  name: 'Italian',
+  nativeName: 'Italiano',
+  flag: '🇮🇹',
+  icon: 'language-outline',
+  color: '#34C759'
+}, {
+  id: 'pt-PT',
+  name: 'Portuguese',
+  nativeName: 'Português',
+  flag: '🇵🇹',
+  icon: 'language-outline',
+  color: '#AF52DE'
+}, {
+  id: 'ja-JP',
+  name: 'Japanese',
+  nativeName: '日本語',
+  flag: '🇯🇵',
+  icon: 'language-outline',
+  color: '#FF2D92'
+}, {
+  id: 'ko-KR',
+  name: 'Korean',
+  nativeName: '한국어',
+  flag: '🇰🇷',
+  icon: 'language-outline',
+  color: '#32D74B'
+}, {
+  id: 'zh-CN',
+  name: 'Chinese',
+  nativeName: '中文',
+  flag: '🇨🇳',
+  icon: 'language-outline',
+  color: '#FF9F0A'
+}, {
+  id: 'ar-SA',
+  name: 'Arabic',
+  nativeName: 'العربية',
+  flag: '🇸🇦',
+  icon: 'language-outline',
+  color: '#30B0C7'
+}];
+const FALLBACK_LANGUAGE = 'en-US';
+
+/**
+ * Get language metadata by language code
+ * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
+ * @returns Language metadata or null if not found
+ */
+export function getLanguageMetadata(languageCode) {
+  if (!languageCode) return null;
+
+  // Direct match
+  const exactMatch = SUPPORTED_LANGUAGES.find(lang => lang.id === languageCode);
+  if (exactMatch) return exactMatch;
+
+  // Try to match base language code (e.g., 'en' matches 'en-US')
+  const baseCode = languageCode.split('-')[0];
+  const baseMatch = SUPPORTED_LANGUAGES.find(lang => lang.id.startsWith(baseCode + '-'));
+  if (baseMatch) return baseMatch;
+  return null;
+}
+
+/**
+ * Get language name by language code
+ * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
+ * @returns Language name (e.g., 'English') or the code if not found
+ */
+export function getLanguageName(languageCode) {
+  const metadata = getLanguageMetadata(languageCode);
+  return metadata?.name || languageCode || FALLBACK_LANGUAGE;
+}
+
+/**
+ * Get native language name by language code
+ * @param languageCode - BCP-47 language code (e.g., 'en-US', 'es-ES')
+ * @returns Native language name (e.g., 'Español') or the code if not found
+ */
+export function getNativeLanguageName(languageCode) {
+  const metadata = getLanguageMetadata(languageCode);
+  return metadata?.nativeName || languageCode || FALLBACK_LANGUAGE;
+}
+
+/**
+ * Normalize language code to BCP-47 format
+ * @param lang - Language code (may be short like 'en' or full like 'en-US')
+ * @returns Normalized BCP-47 language code
+ */
+export function normalizeLanguageCode(lang) {
+  if (!lang) return FALLBACK_LANGUAGE;
+  if (lang.includes('-')) return lang;
+  const map = {
+    en: 'en-US',
+    es: 'es-ES',
+    ca: 'ca-ES',
+    fr: 'fr-FR',
+    de: 'de-DE',
+    it: 'it-IT',
+    pt: 'pt-PT',
+    ja: 'ja-JP',
+    ko: 'ko-KR',
+    zh: 'zh-CN',
+    ar: 'ar-SA'
+  };
+  return map[lang] || lang;
+}
+//# sourceMappingURL=languageUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["SUPPORTED_LANGUAGES","id","name","nativeName","flag","icon","color","FALLBACK_LANGUAGE","getLanguageMetadata","languageCode","exactMatch","find","lang","baseCode","split","baseMatch","startsWith","getLanguageName","metadata","getNativeLanguageName","normalizeLanguageCode","includes","map","en","es","ca","fr","de","it","pt","ja","ko","zh","ar"],"sourceRoot":"../../../src","sources":["utils/languageUtils.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/requestUtils.js

@@ -0,0 +1,210 @@
+"use strict";
+
+/**
+ * Request utilities for HTTP clients
+ * 
+ * Provides reusable components for request deduplication, queuing, and logging
+ */
+
+/**
+ * Request deduplication - prevents duplicate concurrent requests
+ * 
+ * When multiple requests with the same key are made simultaneously,
+ * only one request is executed and all callers receive the same result.
+ * 
+ * @example
+ * ```typescript
+ * const deduplicator = new RequestDeduplicator();
+ * 
+ * // Multiple calls with same key will share the same promise
+ * const promise1 = deduplicator.deduplicate('user-123', () => fetchUser('123'));
+ * const promise2 = deduplicator.deduplicate('user-123', () => fetchUser('123'));
+ * // promise1 === promise2, only one API call is made
+ * ```
+ */
+export class RequestDeduplicator {
+  pendingRequests = new Map();
+
+  /**
+   * Deduplicate a request by key
+   * @param key Unique key for the request
+   * @param requestFn Function that returns a promise
+   * @returns Promise that will be shared if key already exists
+   */
+  async deduplicate(key, requestFn) {
+    const existing = this.pendingRequests.get(key);
+    if (existing) {
+      return existing;
+    }
+    const promise = requestFn().finally(() => {
+      this.pendingRequests.delete(key);
+    });
+    this.pendingRequests.set(key, promise);
+    return promise;
+  }
+
+  /**
+   * Clear all pending requests
+   */
+  clear() {
+    this.pendingRequests.clear();
+  }
+
+  /**
+   * Get number of pending requests
+   */
+  size() {
+    return this.pendingRequests.size;
+  }
+}
+
+/**
+ * Request queue with concurrency control
+ * 
+ * Limits the number of concurrent requests and queues excess requests.
+ * Useful for rate limiting and preventing request flooding.
+ * 
+ * @example
+ * ```typescript
+ * const queue = new RequestQueue(5, 100); // Max 5 concurrent, queue up to 100
+ * 
+ * // All requests will be queued and processed with max 5 concurrent
+ * await queue.enqueue(() => fetchUser('1'));
+ * await queue.enqueue(() => fetchUser('2'));
+ * // ...
+ * ```
+ */
+export class RequestQueue {
+  queue = [];
+  running = 0;
+  /**
+   * Create a new request queue
+   * @param maxConcurrent Maximum number of concurrent requests (default: 10)
+   * @param maxQueueSize Maximum queue size (default: 100)
+   */
+  constructor(maxConcurrent = 10, maxQueueSize = 100) {
+    this.maxConcurrent = maxConcurrent;
+    this.maxQueueSize = maxQueueSize;
+  }
+
+  /**
+   * Enqueue a request
+   * @param requestFn Function that returns a promise
+   * @returns Promise that resolves when request completes
+   */
+  async enqueue(requestFn) {
+    if (this.queue.length >= this.maxQueueSize) {
+      throw new Error('Request queue is full');
+    }
+    return new Promise((resolve, reject) => {
+      this.queue.push(async () => {
+        try {
+          const result = await requestFn();
+          resolve(result);
+        } catch (error) {
+          reject(error);
+        }
+      });
+      this.process();
+    });
+  }
+
+  /**
+   * Process queued requests
+   */
+  async process() {
+    if (this.running >= this.maxConcurrent || this.queue.length === 0) {
+      return;
+    }
+    this.running++;
+    const requestFn = this.queue.shift();
+    if (requestFn) {
+      try {
+        await requestFn();
+      } finally {
+        this.running--;
+        this.process();
+      }
+    } else {
+      this.running--;
+    }
+  }
+
+  /**
+   * Clear all queued requests
+   */
+  clear() {
+    this.queue = [];
+  }
+
+  /**
+   * Get queue size
+   */
+  size() {
+    return this.queue.length;
+  }
+
+  /**
+   * Get number of currently running requests
+   */
+  runningCount() {
+    return this.running;
+  }
+}
+
+/**
+ * Simple logger with level support
+ * 
+ * Lightweight logger for HTTP clients and utilities.
+ * For more advanced logging, use loggerUtils.ts
+ * 
+ * @example
+ * ```typescript
+ * const logger = new SimpleLogger(true, 'debug');
+ * logger.debug('Debug message');
+ * logger.info('Info message');
+ * logger.error('Error message');
+ * ```
+ */
+export class SimpleLogger {
+  /**
+   * Create a new simple logger
+   * @param enabled Whether logging is enabled
+   * @param level Minimum log level
+   * @param prefix Prefix for log messages (default: '')
+   */
+  constructor(enabled = false, level = 'error', prefix = '') {
+    this.enabled = enabled;
+    this.level = level;
+    this.prefix = prefix;
+  }
+  shouldLog(level) {
+    if (!this.enabled || this.level === 'none') return false;
+    const levels = ['none', 'error', 'warn', 'info', 'debug'];
+    return levels.indexOf(level) <= levels.indexOf(this.level);
+  }
+  formatMessage(...args) {
+    return this.prefix ? [`[${this.prefix}]`, ...args] : args;
+  }
+  error(...args) {
+    if (this.shouldLog('error')) {
+      console.error(...this.formatMessage(...args));
+    }
+  }
+  warn(...args) {
+    if (this.shouldLog('warn')) {
+      console.warn(...this.formatMessage(...args));
+    }
+  }
+  info(...args) {
+    if (this.shouldLog('info')) {
+      console.info(...this.formatMessage(...args));
+    }
+  }
+  debug(...args) {
+    if (this.shouldLog('debug')) {
+      console.log(...this.formatMessage(...args));
+    }
+  }
+}
+//# sourceMappingURL=requestUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["RequestDeduplicator","pendingRequests","Map","deduplicate","key","requestFn","existing","get","promise","finally","delete","set","clear","size","RequestQueue","queue","running","constructor","maxConcurrent","maxQueueSize","enqueue","length","Error","Promise","resolve","reject","push","result","error","process","shift","runningCount","SimpleLogger","enabled","level","prefix","shouldLog","levels","indexOf","formatMessage","args","console","warn","info","debug","log"],"sourceRoot":"../../../src","sources":["utils/requestUtils.ts"],"mappings":"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","ignoreList":[]}