@oxyhq/services 5.16.23 → 5.16.25

package/lib/typescript/utils/asyncUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/asyncUtils.ts"],"names":[],"mappings":"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"}

package/lib/typescript/utils/cache.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 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 statistics
+ */
+export interface CacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+/**
+ * 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 declare class TTLCache<T> {
+    private cache;
+    private defaultTTL;
+    private hits;
+    private misses;
+    /**
+     * Create a new TTL cache
+     * @param defaultTTL Default TTL in milliseconds (default: 5 minutes)
+     */
+    constructor(defaultTTL?: number);
+    /**
+     * Get a value from cache
+     * @param key Cache key
+     * @returns Cached value or null if not found or expired
+     */
+    get(key: string): T | null;
+    /**
+     * 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: string, data: T, ttl?: number): void;
+    /**
+     * Delete a specific cache entry
+     * @param key Cache key
+     * @returns true if entry was deleted, false if not found
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Check if a key exists and is not expired
+     * @param key Cache key
+     * @returns true if key exists and is valid
+     */
+    has(key: string): boolean;
+    /**
+     * Get all valid cache keys
+     * @returns Array of valid cache keys
+     */
+    keys(): string[];
+    /**
+     * Clean up expired entries
+     * @returns Number of entries removed
+     */
+    cleanup(): number;
+    /**
+     * Get cache size (number of entries)
+     */
+    size(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset statistics (keeps cache entries)
+     */
+    resetStats(): void;
+}
+/**
+ * Create a TTL cache instance (convenience function)
+ *
+ * @example
+ * ```typescript
+ * const cache = createCache<string>(5 * 60 * 1000);
+ * ```
+ */
+export declare function createCache<T>(ttl?: number): TTLCache<T>;
+/**
+ * Register a cache for automatic cleanup
+ * @param cache Cache instance to register
+ */
+export declare function registerCacheForCleanup(cache: TTLCache<any>): void;
+/**
+ * Unregister a cache from automatic cleanup
+ * @param cache Cache instance to unregister
+ */
+export declare function unregisterCacheFromCleanup(cache: TTLCache<any>): void;
+/**
+ * Stop all cleanup intervals (useful for testing)
+ * This will clear the interval and unregister all caches
+ */
+export declare function stopAllCleanupIntervals(): void;
+//# sourceMappingURL=cache.d.ts.map

package/lib/typescript/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;OAGG;gBACS,UAAU,GAAE,MAAsB;IAI9C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkB1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAM7C;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYzB;;;OAGG;IACH,IAAI,IAAI,MAAM,EAAE;IAehB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAcjB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,QAAQ,IAAI,UAAU;IAUtB;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,GAAE,MAAsB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEvE;AASD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAWlE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAQrE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C"}

package/lib/typescript/utils/deviceManager.d.ts

@@ -0,0 +1,66 @@
+export interface DeviceFingerprint {
+    userAgent: string;
+    platform: string;
+    language?: string;
+    timezone?: string;
+    screen?: {
+        width: number;
+        height: number;
+        colorDepth: number;
+    };
+}
+export interface StoredDeviceInfo {
+    deviceId: string;
+    deviceName?: string;
+    fingerprint?: string;
+    createdAt: string;
+    lastUsed: string;
+}
+/**
+ * Client-side device management utility
+ * Handles persistent device identification across app sessions
+ */
+export declare class DeviceManager {
+    private static DEVICE_KEY;
+    /**
+     * Check if we're in React Native environment
+     */
+    private static isReactNative;
+    /**
+     * Get appropriate storage for the platform
+     */
+    private static getStorage;
+    /**
+     * Get or create device fingerprint for current device
+     */
+    static getDeviceFingerprint(): DeviceFingerprint;
+    /**
+     * Get stored device info or create new one
+     */
+    static getDeviceInfo(): Promise<StoredDeviceInfo>;
+    /**
+     * Create new device info and store it
+     */
+    static createNewDeviceInfo(): Promise<StoredDeviceInfo>;
+    /**
+     * Save device info to storage
+     */
+    static saveDeviceInfo(deviceInfo: StoredDeviceInfo): Promise<void>;
+    /**
+     * Update device name
+     */
+    static updateDeviceName(deviceName: string): Promise<void>;
+    /**
+     * Clear stored device info (useful for testing or reset)
+     */
+    static clearDeviceInfo(): Promise<void>;
+    /**
+     * Generate a unique device ID
+     */
+    private static generateDeviceId;
+    /**
+     * Get a user-friendly device name based on platform
+     */
+    static getDefaultDeviceName(): string;
+}
+//# sourceMappingURL=deviceManager.d.ts.map

package/lib/typescript/utils/deviceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceManager.d.ts","sourceRoot":"","sources":["../../../src/utils/deviceManager.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAqB;IAE9C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAI5B;;OAEG;mBACkB,UAAU;IA4B/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,iBAAiB;IAoBhD;;OAEG;WACU,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAuBvD;;OAEG;WACU,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAY7D;;OAEG;WACU,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IASxE;;OAEG;WACU,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE;;OAEG;WACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAY/B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;CAatC"}

package/lib/typescript/utils/errorUtils.d.ts

@@ -0,0 +1,53 @@
+import type { ApiError } from '../models/interfaces';
+/**
+ * Error handling utilities for consistent error processing
+ */
+/**
+ * Common error codes
+ */
+export declare const ErrorCodes: {
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly MISSING_TOKEN: "MISSING_TOKEN";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly BAD_REQUEST: "BAD_REQUEST";
+    readonly MISSING_PARAMETER: "MISSING_PARAMETER";
+    readonly INVALID_FORMAT: "INVALID_FORMAT";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly ALREADY_EXISTS: "ALREADY_EXISTS";
+    readonly CONFLICT: "CONFLICT";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly CONNECTION_FAILED: "CONNECTION_FAILED";
+};
+/**
+ * Create a standardized API error
+ */
+export declare function createApiError(message: string, code?: string, status?: number, details?: Record<string, unknown>): ApiError;
+/**
+ * Handle common HTTP errors and convert to ApiError
+ */
+export declare function handleHttpError(error: unknown): ApiError;
+/**
+ * Get error code from HTTP status
+ * Exported for use in other modules
+ */
+export declare function getErrorCodeFromStatus(status: number): string;
+/**
+ * Validate required fields and throw error if missing
+ */
+export declare function validateRequiredFields(data: Record<string, unknown>, fields: string[]): void;
+/**
+ * Safe error logging with context
+ */
+export declare function logError(error: unknown, context?: string): void;
+/**
+ * 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.d.ts.map

package/lib/typescript/utils/errorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAkC,EACxC,MAAM,SAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAOV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CA+FxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAU5F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAa/D;AAED;;;;GAIG;AACH,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/utils/hookUtils.d.ts

@@ -0,0 +1,102 @@
+/**
+ * React hook utilities for common patterns and state management
+ */
+/**
+ * Hook for managing async operations with loading, error, and data states
+ */
+export declare function useAsync<T>(asyncFn: () => Promise<T>, deps?: React.DependencyList): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    execute: () => Promise<T>;
+};
+/**
+ * Hook for managing async operations that execute on mount
+ */
+export declare function useAsyncEffect<T>(asyncFn: () => Promise<T>, deps?: React.DependencyList): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook for debounced values
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Hook for throttled values
+ */
+export declare function useThrottle<T>(value: T, delay: number): T;
+/**
+ * Hook for previous value
+ */
+export declare function usePrevious<T>(value: T): T | undefined;
+/**
+ * Hook for boolean state with toggle
+ */
+export declare function useToggle(initialValue?: boolean): {
+    value: boolean;
+    toggle: () => void;
+    setTrue: () => void;
+    setFalse: () => void;
+    setValue: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+};
+/**
+ * Hook for counter state
+ */
+export declare function useCounter(initialValue?: number): {
+    count: number;
+    increment: () => void;
+    decrement: () => void;
+    reset: () => void;
+    setValue: (value: number) => void;
+};
+/**
+ * Hook for local storage
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+/**
+ * Hook for session storage
+ */
+export declare function useSessionStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+/**
+ * Hook for window size
+ */
+export declare function useWindowSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Hook for scroll position
+ */
+export declare function useScrollPosition(): number;
+/**
+ * Hook for online/offline status
+ */
+export declare function useOnlineStatus(): boolean;
+/**
+ * Hook for media queries
+ */
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Hook for keyboard events
+ */
+export declare function useKeyPress(targetKey: string): boolean;
+/**
+ * Hook for click outside detection
+ */
+export declare function useClickOutside(ref: React.RefObject<HTMLElement>, handler: () => void): void;
+/**
+ * Hook for form validation
+ */
+export declare function useFormValidation<T extends Record<string, unknown>>(initialValues: T, validationSchema: (values: T) => Partial<Record<keyof T, string>>): {
+    values: T;
+    errors: Partial<Record<keyof T, string>>;
+    touched: Partial<Record<keyof T, boolean>>;
+    isValid: boolean;
+    setValue: (field: keyof T, value: T[keyof T]) => void;
+    setTouchedField: (field: keyof T) => void;
+    setValues: import("react").Dispatch<import("react").SetStateAction<T>>;
+    setErrors: import("react").Dispatch<import("react").SetStateAction<Partial<Record<keyof T, string>>>>;
+    setTouched: import("react").Dispatch<import("react").SetStateAction<Partial<Record<keyof T, boolean>>>>;
+};
+//# sourceMappingURL=hookUtils.d.ts.map

package/lib/typescript/utils/hookUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/hookUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,IAAI,GAAE,KAAK,CAAC,cAAmB;;;;;EAwBhC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,IAAI,GAAE,KAAK,CAAC,cAAmB;;;;EAiChC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAkBzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAQtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,YAAY,UAAQ;;;;;;EAQ7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,SAAI;;;;;sBAMJ,MAAM;EAG5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,wBAWxB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAWzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,wBAW1B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAWzD;AAED;;GAEG;AACH,wBAAgB,aAAa;;;EAmB5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,WAahC;AAED;;GAEG;AACH,wBAAgB,eAAe,YAiB9B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAgBpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA0BtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,QAiBrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,aAAa,EAAE,CAAC,EAChB,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;;;;;sBAU5B,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;6BAQnB,MAAM,CAAC;;;;EAsBpD"}

package/lib/typescript/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { DeviceManager } from './deviceManager';
+export type { DeviceFingerprint, StoredDeviceInfo } from './deviceManager';
+export { RequestDeduplicator, RequestQueue, SimpleLogger } from './requestUtils';
+export { TTLCache, createCache, registerCacheForCleanup, unregisterCacheFromCleanup } from './cache';
+export type { CacheStats } from './cache';
+export { normalizeSession, sortSessions, deduplicateSessions, deduplicateSessionsByUserId, normalizeAndSortSessions, mergeSessions, sessionsEqual, sessionsArraysEqual } from './sessionUtils';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACrG,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC"}

package/lib/typescript/utils/languageUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Language utilities for OxyServices
+ * Provides access to supported languages and language metadata
+ */
+export interface LanguageMetadata {
+    id: string;
+    name: string;
+    nativeName: string;
+    flag: string;
+    icon: string;
+    color: string;
+}
+export declare const SUPPORTED_LANGUAGES: LanguageMetadata[];
+/**
+ * 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 declare function getLanguageMetadata(languageCode: string | null | undefined): LanguageMetadata | 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 declare function getLanguageName(languageCode: string | null | undefined): string;
+/**
+ * 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 declare function getNativeLanguageName(languageCode: string | null | undefined): string;
+/**
+ * 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 declare function normalizeLanguageCode(lang?: string | null): string;
+//# sourceMappingURL=languageUtils.d.ts.map

package/lib/typescript/utils/languageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/languageUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAyFjD,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAapG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGrF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmBlE"}

package/lib/typescript/utils/loggerUtils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Centralized logging utilities for consistent logging across the application
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+export interface LogContext {
+    component?: string;
+    method?: string;
+    userId?: string;
+    sessionId?: string;
+    requestId?: string;
+    [key: string]: unknown;
+}
+declare class Logger {
+    private level;
+    private isDevelopment;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, context?: LogContext, ...args: unknown[]): void;
+    info(message: string, context?: LogContext, ...args: unknown[]): void;
+    warn(message: string, context?: LogContext, ...args: unknown[]): void;
+    error(message: string, error?: Error | unknown, context?: LogContext, ...args: unknown[]): void;
+    auth(message: string, context?: LogContext, ...args: unknown[]): void;
+    api(message: string, context?: LogContext, ...args: unknown[]): void;
+    session(message: string, context?: LogContext, ...args: unknown[]): void;
+    user(message: string, context?: LogContext, ...args: unknown[]): void;
+    device(message: string, context?: LogContext, ...args: unknown[]): void;
+    payment(message: string, context?: LogContext, ...args: unknown[]): void;
+    performance(operation: string, duration: number, context?: LogContext): void;
+    errorWithStack(message: string, error: Error, context?: LogContext): void;
+    group(label: string, fn: () => void): void;
+}
+export declare const logger: Logger;
+export declare const logAuth: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logApi: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logSession: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logUser: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logDevice: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logPayment: (message: string, context?: LogContext, ...args: unknown[]) => void;
+export declare const logError: (message: string, error?: Error | unknown, context?: LogContext, ...args: unknown[]) => void;
+export declare const logPerformance: (operation: string, duration: number, context?: LogContext) => void;
+export {};
+//# sourceMappingURL=loggerUtils.d.ts.map

package/lib/typescript/utils/loggerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/loggerUtils.ts"],"names":[],"mappings":"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"}

package/lib/typescript/utils/requestUtils.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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 declare class RequestDeduplicator {
+    private pendingRequests;
+    /**
+     * 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
+     */
+    deduplicate<T>(key: string, requestFn: () => Promise<T>): Promise<T>;
+    /**
+     * Clear all pending requests
+     */
+    clear(): void;
+    /**
+     * Get number of pending requests
+     */
+    size(): number;
+}
+/**
+ * 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 declare class RequestQueue {
+    private queue;
+    private running;
+    private maxConcurrent;
+    private maxQueueSize;
+    /**
+     * Create a new request queue
+     * @param maxConcurrent Maximum number of concurrent requests (default: 10)
+     * @param maxQueueSize Maximum queue size (default: 100)
+     */
+    constructor(maxConcurrent?: number, maxQueueSize?: number);
+    /**
+     * Enqueue a request
+     * @param requestFn Function that returns a promise
+     * @returns Promise that resolves when request completes
+     */
+    enqueue<T>(requestFn: () => Promise<T>): Promise<T>;
+    /**
+     * Process queued requests
+     */
+    private process;
+    /**
+     * Clear all queued requests
+     */
+    clear(): void;
+    /**
+     * Get queue size
+     */
+    size(): number;
+    /**
+     * Get number of currently running requests
+     */
+    runningCount(): number;
+}
+/**
+ * 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 declare class SimpleLogger {
+    private enabled;
+    private level;
+    private prefix;
+    /**
+     * 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?: boolean, level?: string, prefix?: string);
+    private shouldLog;
+    private formatMessage;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+//# sourceMappingURL=requestUtils.d.ts.map

package/lib/typescript/utils/requestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/requestUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,eAAe,CAAmC;IAE1D;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EACjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;OAIG;gBACS,aAAa,GAAE,MAAW,EAAE,YAAY,GAAE,MAAY;IAKlE;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBzD;;OAEG;YACW,OAAO;IAmBrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;OAKG;gBAED,OAAO,GAAE,OAAe,EACxB,KAAK,GAAE,MAAgB,EACvB,MAAM,GAAE,MAAW;IAOrB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,aAAa;IAIrB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM1B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM1B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAK5B"}

package/lib/typescript/utils/sessionUtils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Session management utilities
+ *
+ * Provides consistent session normalization, deduplication, and sorting
+ * to ensure sessions are always displayed in a predictable order.
+ */
+import type { ClientSession } from '../models/session';
+/**
+ * Normalize a session to ensure all required fields are present
+ */
+export declare function normalizeSession(session: Partial<ClientSession> & {
+    sessionId: string;
+}): ClientSession;
+/**
+ * Compare two sessions for equality
+ */
+export declare function sessionsEqual(a: ClientSession, b: ClientSession): boolean;
+/**
+ * Sort sessions by lastActive (most recent first), then by sessionId for stability
+ */
+export declare function sortSessions(sessions: ClientSession[]): ClientSession[];
+/**
+ * Deduplicate sessions by sessionId, keeping the most recent version
+ */
+export declare function deduplicateSessions(sessions: ClientSession[]): ClientSession[];
+/**
+ * Deduplicate sessions by userId, keeping only one session per user
+ * Priority: 1) Active session (if provided), 2) Most recent session
+ * This prevents showing duplicate accounts for the same user
+ */
+export declare function deduplicateSessionsByUserId(sessions: ClientSession[], activeSessionId?: string | null): ClientSession[];
+/**
+ * Normalize, deduplicate, and sort sessions
+ * This ensures consistent session ordering across the application
+ *
+ * @param sessions - Array of sessions to normalize
+ * @param activeSessionId - Optional active session ID to prioritize
+ * @param deduplicateByUserId - If true, deduplicate by userId (one account per user). Default: true
+ */
+export declare function normalizeAndSortSessions(sessions: ClientSession[], activeSessionId?: string | null, deduplicateByUserId?: boolean): ClientSession[];
+/**
+ * Merge two session arrays, prioritizing newer data
+ * Returns normalized, deduplicated, and sorted sessions
+ *
+ * @param existing - Existing sessions array
+ * @param incoming - New sessions to merge in
+ * @param activeSessionId - Optional active session ID to prioritize
+ * @param deduplicateByUserId - If true, deduplicate by userId (one account per user). Default: true
+ */
+export declare function mergeSessions(existing: ClientSession[], incoming: ClientSession[], activeSessionId?: string | null, deduplicateByUserId?: boolean): ClientSession[];
+/**
+ * Check if two session arrays are equal (same sessionIds in same order)
+ */
+export declare function sessionsArraysEqual(a: ClientSession[], b: ClientSession[]): boolean;
+//# sourceMappingURL=sessionUtils.d.ts.map