@oxyhq/services 5.13.0 → 5.13.2

package/src/core/RequestManager.ts

@@ -0,0 +1,240 @@
+/**
+ * Request Manager
+ * 
+ * Handles request-level optimizations: caching, deduplication, queuing, and retry.
+ * Works on top of HttpClient to add performance features.
+ */
+
+import type { AxiosInstance } from 'axios';
+import { TTLCache, registerCacheForCleanup } from '../utils/cache';
+import { RequestDeduplicator, RequestQueue, SimpleLogger } from '../utils/requestUtils';
+import { retryWithBackoff } from '../utils/errorUtils';
+import type { OxyConfig } from '../models/interfaces';
+
+export interface RequestOptions {
+  cache?: boolean;
+  cacheTTL?: number;
+  deduplicate?: boolean;
+  retry?: boolean;
+  maxRetries?: number;
+  timeout?: number;
+  signal?: AbortSignal;
+}
+
+/**
+ * Request Manager
+ * 
+ * Manages request-level optimizations while delegating actual HTTP calls to HttpClient.
+ */
+export class RequestManager {
+  private cache: TTLCache<any>;
+  private deduplicator: RequestDeduplicator;
+  private requestQueue: RequestQueue;
+  private logger: SimpleLogger;
+  private config: OxyConfig;
+  private httpClient: { request: (config: any) => Promise<any> };
+
+  // Performance monitoring
+  private requestMetrics = {
+    totalRequests: 0,
+    successfulRequests: 0,
+    failedRequests: 0,
+    cacheHits: 0,
+    cacheMisses: 0,
+    averageResponseTime: 0,
+  };
+
+  constructor(
+    httpClient: { request: (config: any) => Promise<any> },
+    config: OxyConfig
+  ) {
+    this.httpClient = httpClient;
+    this.config = config;
+
+    // Initialize performance infrastructure
+    this.cache = new TTLCache<any>(config.cacheTTL || 5 * 60 * 1000);
+    registerCacheForCleanup(this.cache);
+    this.deduplicator = new RequestDeduplicator();
+    this.requestQueue = new RequestQueue(
+      config.maxConcurrentRequests || 10,
+      config.requestQueueSize || 100
+    );
+    this.logger = new SimpleLogger(
+      config.enableLogging || false,
+      config.logLevel || 'error',
+      'RequestManager'
+    );
+  }
+
+  /**
+   * Make a request with all performance optimizations
+   */
+  async request<T>(
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',
+    url: string,
+    data?: any,
+    options: RequestOptions = {}
+  ): Promise<T> {
+    const {
+      cache = method === 'GET', // Cache GET requests by default
+      cacheTTL,
+      deduplicate = true,
+      retry = this.config.enableRetry !== false,
+      maxRetries = this.config.maxRetries || 3,
+      timeout,
+      signal,
+    } = options;
+
+    // Generate cache key
+    const cacheKey = cache ? `${method}:${url}:${JSON.stringify(data || {})}` : null;
+
+    // Check cache first
+    if (cache && cacheKey) {
+      const cached = this.cache.get(cacheKey) as T | null;
+      if (cached !== null) {
+        this.requestMetrics.cacheHits++;
+        this.logger.debug('Cache hit:', url);
+        return cached;
+      }
+      this.requestMetrics.cacheMisses++;
+    }
+
+    // Request function that uses HttpClient
+    const requestFn = async (): Promise<T> => {
+      const startTime = Date.now();
+      try {
+        const result = await this.httpClient.request({
+          method,
+          url,
+          data: method !== 'GET' ? data : undefined,
+          params: method === 'GET' ? data : undefined,
+          timeout: timeout || this.config.requestTimeout || 5000,
+          signal,
+        });
+
+        const duration = Date.now() - startTime;
+        this.updateMetrics(true, duration);
+        this.config.onRequestEnd?.(url, method, duration, true);
+
+        return result as T;
+      } catch (error: any) {
+        const duration = Date.now() - startTime;
+        this.updateMetrics(false, duration);
+        this.config.onRequestEnd?.(url, method, duration, false);
+        this.config.onRequestError?.(url, method, error);
+        throw error;
+      }
+    };
+
+    // Wrap with retry if enabled
+    const requestWithRetry = retry
+      ? () => this.retryWithBackoff(requestFn, maxRetries)
+      : requestFn;
+
+    // Wrap with deduplication if enabled
+    const dedupeKey = deduplicate ? `${method}:${url}:${JSON.stringify(data || {})}` : null;
+    const finalRequest = dedupeKey
+      ? () => this.deduplicator.deduplicate(dedupeKey, requestWithRetry)
+      : requestWithRetry;
+
+    // Execute request (with queue if needed)
+    const result = await this.requestQueue.enqueue(finalRequest);
+
+    // Cache the result if caching is enabled
+    if (cache && cacheKey && result) {
+      this.cache.set(cacheKey, result, cacheTTL);
+    }
+
+    return result;
+  }
+
+  /**
+   * Exponential backoff retry logic with 4xx error handling
+   */
+  private async retryWithBackoff<T>(
+    fn: () => Promise<T>,
+    maxRetries: number = 3,
+    baseDelay: number = 1000
+  ): Promise<T> {
+    let lastError: any;
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        return await fn();
+      } catch (error: any) {
+        lastError = error;
+
+        // Don't retry on 4xx errors (client errors)
+        if (error.response?.status >= 400 && error.response?.status < 500) {
+          throw error;
+        }
+
+        // Don't retry on last attempt
+        if (attempt === maxRetries) {
+          break;
+        }
+
+        // Calculate delay with exponential backoff and jitter
+        const delay = baseDelay * Math.pow(2, attempt) + Math.random() * 1000;
+        this.logger.debug(`Retry attempt ${attempt + 1}/${maxRetries} after ${delay}ms`);
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
+    }
+
+    throw lastError;
+  }
+
+  /**
+   * Update request metrics
+   */
+  private updateMetrics(success: boolean, duration: number): void {
+    this.requestMetrics.totalRequests++;
+    if (success) {
+      this.requestMetrics.successfulRequests++;
+    } else {
+      this.requestMetrics.failedRequests++;
+    }
+
+    // Update average response time (exponential moving average)
+    const alpha = 0.1; // Smoothing factor
+    this.requestMetrics.averageResponseTime =
+      this.requestMetrics.averageResponseTime * (1 - alpha) + duration * alpha;
+  }
+
+  /**
+   * Get performance metrics
+   */
+  getMetrics(): typeof this.requestMetrics {
+    return { ...this.requestMetrics };
+  }
+
+  /**
+   * Clear request cache
+   */
+  clearCache(): void {
+    this.cache.clear();
+    this.logger.debug('Cache cleared');
+  }
+
+  /**
+   * Clear specific cache entry
+   */
+  clearCacheEntry(key: string): void {
+    this.cache.delete(key);
+  }
+
+  /**
+   * Get cache statistics
+   */
+  getCacheStats(): { size: number; hits: number; misses: number; hitRate: number } {
+    const cacheStats = this.cache.getStats();
+    const total = this.requestMetrics.cacheHits + this.requestMetrics.cacheMisses;
+    return {
+      size: cacheStats.size,
+      hits: this.requestMetrics.cacheHits,
+      misses: this.requestMetrics.cacheMisses,
+      hitRate: total > 0 ? this.requestMetrics.cacheHits / total : 0,
+    };
+  }
+}
+

package/src/core/index.ts

@@ -17,6 +17,16 @@ export * from '../models/session';
 export { DeviceManager } from '../utils/deviceManager';
 export type { DeviceFingerprint, StoredDeviceInfo } from '../utils/deviceManager';
 
+// Export language utilities
+export { 
+  SUPPORTED_LANGUAGES,
+  getLanguageMetadata,
+  getLanguageName,
+  getNativeLanguageName,
+  normalizeLanguageCode
+} from '../utils/languageUtils';
+export type { LanguageMetadata } from '../utils/languageUtils';
+
 // Import for default export
 import { OxyServices } from './OxyServices';
 

package/src/i18n/index.ts

@@ -3,6 +3,24 @@
 const enUS = require('./locales/en-US.json') as Record<string, any>;
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const esES = require('./locales/es-ES.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const caES = require('./locales/ca-ES.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const frFR = require('./locales/fr-FR.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const deDE = require('./locales/de-DE.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const itIT = require('./locales/it-IT.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const ptPT = require('./locales/pt-PT.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const jaJP = require('./locales/ja-JP.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const koKR = require('./locales/ko-KR.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const zhCN = require('./locales/zh-CN.json') as Record<string, any>;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const arSA = require('./locales/ar-SA.json') as Record<string, any>;
 
 export type LocaleDict = Record<string, any>;
 
@@ -11,6 +29,24 @@ const DICTS: Record<string, LocaleDict> = {
   'en-US': enUS as LocaleDict,
   'es': esES as LocaleDict,
   'es-ES': esES as LocaleDict,
+  'ca': caES as LocaleDict,
+  'ca-ES': caES as LocaleDict,
+  'fr': frFR as LocaleDict,
+  'fr-FR': frFR as LocaleDict,
+  'de': deDE as LocaleDict,
+  'de-DE': deDE as LocaleDict,
+  'it': itIT as LocaleDict,
+  'it-IT': itIT as LocaleDict,
+  'pt': ptPT as LocaleDict,
+  'pt-PT': ptPT as LocaleDict,
+  'ja': jaJP as LocaleDict,
+  'ja-JP': jaJP as LocaleDict,
+  'ko': koKR as LocaleDict,
+  'ko-KR': koKR as LocaleDict,
+  'zh': zhCN as LocaleDict,
+  'zh-CN': zhCN as LocaleDict,
+  'ar': arSA as LocaleDict,
+  'ar-SA': arSA as LocaleDict,
 };
 
 const FALLBACK = 'en-US';

package/src/i18n/locales/ar-SA.json

@@ -0,0 +1,128 @@
+{
+  "signin": {
+    "title": "تسجيل الدخول",
+    "subtitle": "سجل الدخول للمتابعة",
+    "addAccountTitle": "إضافة حساب آخر",
+    "addAccountSubtitle": "تسجيل الدخول بحساب آخر",
+    "username": {
+      "label": "اسم المستخدم",
+      "placeholder": "أدخل اسم المستخدم",
+      "helper": "3-30 حرفًا، أحرف وأرقام فقط",
+      "required": "يرجى إدخال اسم المستخدم.",
+      "minLength": "يجب أن يكون اسم المستخدم 3 أحرف على الأقل."
+    },
+    "password": {
+      "label": "كلمة المرور",
+      "placeholder": "أدخل كلمة المرور",
+      "required": "يرجى إدخال كلمة المرور.",
+      "hint": "أدخل كلمة المرور لتسجيل الدخول"
+    },
+    "actions": {
+      "continue": "متابعة",
+      "back": "رجوع",
+      "signIn": "تسجيل الدخول",
+      "verify": "التحقق",
+      "openAccountSwitcher": "التبديل إلى حساب آخر",
+      "openAccountSwitcherSubtitle": "{{count}} حسابات أخرى متاحة",
+      "openAccountSwitcherSubtitle_singular": "حساب آخر واحد متاح",
+      "openAccountSwitcherSubtitle_zero": "راجع حساباتك المحفوظة",
+      "manageAccounts": "إدارة الحسابات المحفوظة",
+      "manageAccountsSubtitle": "مراجعة الجلسات أو إزالتها أو تسجيل الخروج",
+      "loadingOtherAccounts": "جاري تحميل الحسابات الأخرى…",
+      "switchAccountFailed": "لم نتمكن من التبديل بين الحسابات. يرجى المحاولة مرة أخرى."
+    },
+    "forgotPrompt": "نسيت كلمة المرور؟",
+    "security": {
+      "dataSecure": "بياناتك مشفرة وآمنة"
+    },
+    "currentlySignedInAs": "مسجل الدخول حاليًا كـ",
+    "alreadySignedInWith": "مسجل الدخول بالفعل بـ",
+    "alreadySignedIn": "مسجل الدخول بالفعل",
+    "alreadySignedInMessage": "هذا الحساب مسجل الدخول بالفعل. المتابعة بهذا الحساب؟",
+    "continueWithAccount": "متابعة",
+    "currentAccount": "الحالي",
+    "or": "أو",
+    "viewAllAccounts": "عرض {{count}} المزيد",
+    "status": {
+      "accountSwitched": "استخدام {{name}} الآن"
+    },
+    "totp": {
+      "title": "رمز المصادقة الثنائية",
+      "subtitle": "أدخل الرمز المكون من 6 أرقام من تطبيق المصادقة الخاص بك لـ @{{username}}",
+      "invalidCode": "رمز غير صالح. يرجى المحاولة مرة أخرى.",
+      "noAccess": "لا يمكن الوصول إلى تطبيق المصادقة؟",
+      "useBackupCode": "استخدام رمز النسخ الاحتياطي",
+      "useRecoveryKey": "استخدام مفتاح الاسترداد"
+    }
+  },
+  "signup": {
+    "welcome": {
+      "title": "مرحبًا بك في Oxy!",
+      "subtitle": "أنشئ حسابك في خطوات قليلة",
+      "haveAccount": "لديك حساب بالفعل؟",
+      "signInCta": "تسجيل الدخول"
+    },
+    "identity": {
+      "title": "من أنت؟",
+      "subtitle": "اختر اسم المستخدم وأدخل بريدك الإلكتروني"
+    },
+    "username": {
+      "helper": "3-30 حرفًا، أحرف وأرقام فقط",
+      "required": "يرجى إدخال اسم مستخدم",
+      "minLength": "يجب أن يكون اسم المستخدم 3 أحرف على الأقل"
+    },
+    "email": {
+      "required": "يرجى إدخال عنوان بريد إلكتروني",
+      "invalid": "يرجى إدخال عنوان بريد إلكتروني صالح",
+      "helper": "لن نشارك بريدك الإلكتروني أبدًا"
+    },
+    "security": {
+      "title": "أمّن حسابك",
+      "subtitle": "أنشئ كلمة مرور قوية لحماية حسابك"
+    },
+    "password": {
+      "helper": "8 أحرف على الأقل",
+      "required": "يرجى إدخال كلمة مرور",
+      "minLength": "يجب أن تكون كلمة المرور 8 أحرف على الأقل",
+      "confirmRequired": "يرجى تأكيد كلمة المرور",
+      "mismatch": "كلمات المرور غير متطابقة",
+      "confirmHint": "أعد إدخال كلمة المرور للتأكيد"
+    },
+    "summary": {
+      "title": "أوشكت على الانتهاء!",
+      "subtitle": "راجع معلوماتك وأنشئ حسابك",
+      "sectionTitle": "معلومات الحساب",
+      "fields": {
+        "username": "اسم المستخدم",
+        "email": "البريد الإلكتروني",
+        "password": "كلمة المرور"
+      },
+      "notSet": "غير محدد",
+      "securityTip": "لمزيد من الأمان، قم بتمكين المصادقة الثنائية (TOTP) من إعدادات الحساب بعد إنشاء حسابك.",
+      "legalReminder": "بإنشاء حساب، فإنك توافق على شروط الخدمة وسياسة الخصوصية الخاصة بنا."
+    }
+  },
+  "common": {
+    "actions": {
+      "back": "رجوع",
+      "continue": "متابعة",
+      "next": "التالي",
+      "getStarted": "ابدأ",
+      "createAccount": "إنشاء حساب",
+      "signIn": "تسجيل الدخول",
+      "verify": "التحقق",
+      "resetPassword": "إعادة تعيين كلمة المرور"
+    },
+    "links": {
+      "recoverAccount": "استعادة حسابك",
+      "signUp": "التسجيل"
+    },
+    "labels": {
+      "username": "اسم المستخدم",
+      "email": "البريد الإلكتروني",
+      "password": "كلمة المرور",
+      "confirmPassword": "تأكيد كلمة المرور"
+    }
+  }
+}
+

package/src/i18n/locales/ca-ES.json

@@ -0,0 +1,128 @@
+{
+  "signin": {
+    "title": "Iniciar sessió",
+    "subtitle": "Inicia sessió per continuar",
+    "addAccountTitle": "Afegir un altre compte",
+    "addAccountSubtitle": "Inicia sessió amb un altre compte",
+    "username": {
+      "label": "Nom d'usuari",
+      "placeholder": "Introdueix el teu nom d'usuari",
+      "helper": "3-30 caràcters, només lletres i números",
+      "required": "Si us plau, introdueix el teu nom d'usuari.",
+      "minLength": "El nom d'usuari ha de tenir almenys 3 caràcters."
+    },
+    "password": {
+      "label": "Contrasenya",
+      "placeholder": "Introdueix la teva contrasenya",
+      "required": "Si us plau, introdueix la teva contrasenya.",
+      "hint": "Introdueix la teva contrasenya per iniciar sessió"
+    },
+    "actions": {
+      "continue": "Continuar",
+      "back": "Enrere",
+      "signIn": "Iniciar sessió",
+      "verify": "Verificar",
+      "openAccountSwitcher": "Canviar a un altre compte",
+      "openAccountSwitcherSubtitle": "{{count}} altres comptes disponibles",
+      "openAccountSwitcherSubtitle_singular": "1 altre compte disponible",
+      "openAccountSwitcherSubtitle_zero": "Revisa els teus comptes guardats",
+      "manageAccounts": "Gestionar comptes guardats",
+      "manageAccountsSubtitle": "Revisar sessions, eliminar o tancar sessió",
+      "loadingOtherAccounts": "Carregant altres comptes…",
+      "switchAccountFailed": "No hem pogut canviar de compte. Torna-ho a intentar."
+    },
+    "forgotPrompt": "Has oblidat la teva contrasenya?",
+    "security": {
+      "dataSecure": "Les teves dades estan xifrades i segures"
+    },
+    "currentlySignedInAs": "Actualment has iniciat sessió com",
+    "alreadySignedInWith": "Ja has iniciat sessió amb",
+    "alreadySignedIn": "Ja has iniciat sessió",
+    "alreadySignedInMessage": "Aquest compte ja ha iniciat sessió. Continuar amb aquest compte?",
+    "continueWithAccount": "Continuar",
+    "currentAccount": "Actual",
+    "or": "o",
+    "viewAllAccounts": "Veure {{count}} més",
+    "status": {
+      "accountSwitched": "Ara utilitzant {{name}}"
+    },
+    "totp": {
+      "title": "Codi de dos factors",
+      "subtitle": "Introdueix el codi de 6 dígits de la teva app autenticadora per @{{username}}",
+      "invalidCode": "Codi invàlid. Torna-ho a intentar.",
+      "noAccess": "Sense accés al teu autenticador?",
+      "useBackupCode": "Utilitzar codi de còpia de seguretat",
+      "useRecoveryKey": "Utilitzar clau de recuperació"
+    }
+  },
+  "signup": {
+    "welcome": {
+      "title": "Benvingut a Oxy!",
+      "subtitle": "Crea el teu compte en pocs passos",
+      "haveAccount": "Ja tens un compte?",
+      "signInCta": "Inicia sessió"
+    },
+    "identity": {
+      "title": "Qui ets?",
+      "subtitle": "Tria el teu nom d'usuari i introdueix el teu correu"
+    },
+    "username": {
+      "helper": "3-30 caràcters, només lletres i números",
+      "required": "Si us plau, introdueix un nom d'usuari",
+      "minLength": "El nom d'usuari ha de tenir almenys 3 caràcters"
+    },
+    "email": {
+      "required": "Si us plau, introdueix una adreça de correu electrònic",
+      "invalid": "Si us plau, introdueix una adreça de correu electrònic vàlida",
+      "helper": "Mai compartirem el teu correu"
+    },
+    "security": {
+      "title": "Protegeix el teu compte",
+      "subtitle": "Crea una contrasenya forta per protegir el teu compte"
+    },
+    "password": {
+      "helper": "Almenys 8 caràcters",
+      "required": "Si us plau, introdueix una contrasenya",
+      "minLength": "La contrasenya ha de tenir almenys 8 caràcters",
+      "confirmRequired": "Si us plau, confirma la teva contrasenya",
+      "mismatch": "Les contrasenyes no coincideixen",
+      "confirmHint": "Torna a introduir la teva contrasenya per confirmar"
+    },
+    "summary": {
+      "title": "Gairebé allà!",
+      "subtitle": "Revisa la teva informació i crea el teu compte",
+      "sectionTitle": "Informació del compte",
+      "fields": {
+        "username": "Nom d'usuari",
+        "email": "Correu electrònic",
+        "password": "Contrasenya"
+      },
+      "notSet": "No definit",
+      "securityTip": "Per a una major seguretat, habilita l'Autenticació de Dos Factors (TOTP) des de Configuració del compte després de crear el teu compte.",
+      "legalReminder": "En crear un compte, acceptes els nostres Termes de servei i Política de privacitat."
+    }
+  },
+  "common": {
+    "actions": {
+      "back": "Enrere",
+      "continue": "Continuar",
+      "next": "Següent",
+      "getStarted": "Començar",
+      "createAccount": "Crear compte",
+      "signIn": "Iniciar sessió",
+      "verify": "Verificar",
+      "resetPassword": "Restablir contrasenya"
+    },
+    "links": {
+      "recoverAccount": "Recuperar el teu compte",
+      "signUp": "Registrar-se"
+    },
+    "labels": {
+      "username": "Nom d'usuari",
+      "email": "Correu electrònic",
+      "password": "Contrasenya",
+      "confirmPassword": "Confirmar contrasenya"
+    }
+  }
+}
+