@oxyhq/services 5.16.23 → 5.16.25

package/lib/module/ui/utils/sessionHelpers.js

@@ -0,0 +1,94 @@
+"use strict";
+
+/**
+ * Normalize backend session payloads into `ClientSession` objects.
+ *
+ * @param sessions - Raw session array returned from the API
+ * @param fallbackDeviceId - Device identifier to use when missing from payload
+ * @param fallbackUserId - User identifier to use when missing from payload
+ */
+export const mapSessionsToClient = (sessions, fallbackDeviceId, fallbackUserId) => {
+  const now = new Date();
+  return sessions.map(session => ({
+    sessionId: session.sessionId,
+    deviceId: session.deviceId || fallbackDeviceId || '',
+    expiresAt: session.expiresAt || new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000).toISOString(),
+    lastActive: session.lastActive || now.toISOString(),
+    userId: session.user?.id || session.userId || (session.user?._id ? session.user._id.toString() : undefined) || fallbackUserId || '',
+    isCurrent: Boolean(session.isCurrent)
+  }));
+};
+
+/**
+ * Fetch device sessions with fallback to the legacy session endpoint when needed.
+ *
+ * @param oxyServices - Oxy service instance
+ * @param sessionId - Session identifier to fetch
+ * @param options - Optional fallback options
+ */
+export const fetchSessionsWithFallback = async (oxyServices, sessionId, {
+  fallbackDeviceId,
+  fallbackUserId,
+  logger
+} = {}) => {
+  try {
+    const deviceSessions = await oxyServices.getDeviceSessions(sessionId);
+    return mapSessionsToClient(deviceSessions, fallbackDeviceId, fallbackUserId);
+  } catch (error) {
+    if (__DEV__ && logger) {
+      logger('Failed to get device sessions, falling back to user sessions', error);
+    }
+    const userSessions = await oxyServices.getSessionsBySessionId(sessionId);
+    return mapSessionsToClient(userSessions, fallbackDeviceId, fallbackUserId);
+  }
+};
+
+/**
+ * Validate multiple sessions concurrently with configurable concurrency.
+ *
+ * @param oxyServices - Oxy service instance
+ * @param sessionIds - Session identifiers to validate
+ * @param options - Validation options
+ */
+export const validateSessionBatch = async (oxyServices, sessionIds, {
+  useHeaderValidation = true,
+  maxConcurrency = 5
+} = {}) => {
+  if (!sessionIds.length) {
+    return [];
+  }
+  const uniqueSessionIds = Array.from(new Set(sessionIds));
+  const safeConcurrency = Math.max(1, Math.min(maxConcurrency, uniqueSessionIds.length));
+  const results = [];
+  let index = 0;
+  const worker = async () => {
+    while (index < uniqueSessionIds.length) {
+      const currentIndex = index;
+      index += 1;
+      const sessionId = uniqueSessionIds[currentIndex];
+      try {
+        const validation = await oxyServices.validateSession(sessionId, {
+          useHeaderValidation
+        });
+        const valid = Boolean(validation?.valid);
+        results.push({
+          sessionId,
+          valid,
+          user: validation?.user,
+          raw: validation
+        });
+      } catch (error) {
+        results.push({
+          sessionId,
+          valid: false,
+          error
+        });
+      }
+    }
+  };
+  await Promise.all(Array.from({
+    length: safeConcurrency
+  }, worker));
+  return results;
+};
+//# sourceMappingURL=sessionHelpers.js.map

package/lib/module/ui/utils/sessionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mapSessionsToClient","sessions","fallbackDeviceId","fallbackUserId","now","Date","map","session","sessionId","deviceId","expiresAt","getTime","toISOString","lastActive","userId","user","id","_id","toString","undefined","isCurrent","Boolean","fetchSessionsWithFallback","oxyServices","logger","deviceSessions","getDeviceSessions","error","__DEV__","userSessions","getSessionsBySessionId","validateSessionBatch","sessionIds","useHeaderValidation","maxConcurrency","length","uniqueSessionIds","Array","from","Set","safeConcurrency","Math","max","min","results","index","worker","currentIndex","validation","validateSession","valid","push","raw","Promise","all"],"sourceRoot":"../../../../src","sources":["ui/utils/sessionHelpers.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/utils/storageHelpers.js

@@ -0,0 +1,111 @@
+"use strict";
+
+/**
+ * Create an in-memory storage implementation used as a safe fallback.
+ */
+const MEMORY_STORAGE = () => {
+  const store = new Map();
+  return {
+    async getItem(key) {
+      return store.has(key) ? store.get(key) : null;
+    },
+    async setItem(key, value) {
+      store.set(key, value);
+    },
+    async removeItem(key) {
+      store.delete(key);
+    },
+    async clear() {
+      store.clear();
+    }
+  };
+};
+
+/**
+ * Create a web storage implementation backed by `localStorage`.
+ * Falls back to in-memory storage when unavailable.
+ */
+const createWebStorage = () => {
+  if (typeof window === 'undefined' || typeof window.localStorage === 'undefined') {
+    return MEMORY_STORAGE();
+  }
+  return {
+    async getItem(key) {
+      try {
+        return window.localStorage.getItem(key);
+      } catch {
+        return null;
+      }
+    },
+    async setItem(key, value) {
+      try {
+        window.localStorage.setItem(key, value);
+      } catch {
+        // Ignore quota or access issues for now.
+      }
+    },
+    async removeItem(key) {
+      try {
+        window.localStorage.removeItem(key);
+      } catch {
+        // Ignore failures.
+      }
+    },
+    async clear() {
+      try {
+        window.localStorage.clear();
+      } catch {
+        // Ignore failures.
+      }
+    }
+  };
+};
+let asyncStorageInstance = null;
+
+/**
+ * Lazily import React Native AsyncStorage implementation.
+ */
+const createNativeStorage = async () => {
+  if (asyncStorageInstance) {
+    return asyncStorageInstance;
+  }
+  try {
+    const asyncStorageModule = await import('@react-native-async-storage/async-storage');
+    asyncStorageInstance = asyncStorageModule.default;
+    return asyncStorageInstance;
+  } catch (error) {
+    if (__DEV__) {
+      console.error('Failed to import AsyncStorage:', error);
+    }
+    throw new Error('AsyncStorage is required in React Native environment');
+  }
+};
+
+/**
+ * Detect whether the current runtime is React Native.
+ */
+export const isReactNative = () => typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+
+/**
+ * Create a platform-appropriate storage implementation.
+ * Defaults to in-memory storage when no platform storage is available.
+ */
+export const createPlatformStorage = async () => {
+  if (isReactNative()) {
+    return createNativeStorage();
+  }
+  return createWebStorage();
+};
+export const STORAGE_KEY_PREFIX = 'oxy_session';
+
+/**
+ * Produce strongly typed storage key names for the supplied prefix.
+ *
+ * @param prefix - Storage key prefix
+ */
+export const getStorageKeys = (prefix = STORAGE_KEY_PREFIX) => ({
+  activeSessionId: `${prefix}_active_session_id`,
+  sessionIds: `${prefix}_session_ids`,
+  language: `${prefix}_language`
+});
+//# sourceMappingURL=storageHelpers.js.map

package/lib/module/ui/utils/storageHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MEMORY_STORAGE","store","Map","getItem","key","has","get","setItem","value","set","removeItem","delete","clear","createWebStorage","window","localStorage","asyncStorageInstance","createNativeStorage","asyncStorageModule","default","error","__DEV__","console","Error","isReactNative","navigator","product","createPlatformStorage","STORAGE_KEY_PREFIX","getStorageKeys","prefix","activeSessionId","sessionIds","language"],"sourceRoot":"../../../../src","sources":["ui/utils/storageHelpers.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/utils/themeUtils.js

@@ -0,0 +1,41 @@
+"use strict";
+
+/**
+ * Theme utility functions
+ */
+
+/**
+ * Normalizes a theme value to ensure it's always 'light' | 'dark'
+ * @param theme - Theme value (may be 'light' | 'dark' | string | undefined)
+ * @returns Normalized 'light' | 'dark' theme (defaults to 'light')
+ */
+export const normalizeTheme = theme => theme === 'light' || theme === 'dark' ? theme : 'light';
+
+/**
+ * Normalizes a color scheme value to ensure it's always 'light' or 'dark'
+ * Handles null/undefined cases with proper fallback chain
+ * 
+ * @param colorScheme - The color scheme from useColorScheme() hook (may be null/undefined)
+ * @param theme - Optional theme prop as fallback
+ * @returns Normalized 'light' | 'dark' color scheme
+ * 
+ * @example
+ * ```ts
+ * const colorScheme = normalizeColorScheme(useColorScheme(), theme);
+ * ```
+ */
+export const normalizeColorScheme = (colorScheme, theme) => {
+  // First try the colorScheme from hook
+  if (colorScheme === 'light' || colorScheme === 'dark') {
+    return colorScheme;
+  }
+
+  // Fallback to theme prop
+  if (theme === 'light' || theme === 'dark') {
+    return theme;
+  }
+
+  // Default to light
+  return 'light';
+};
+//# sourceMappingURL=themeUtils.js.map

package/lib/module/ui/utils/themeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["normalizeTheme","theme","normalizeColorScheme","colorScheme"],"sourceRoot":"../../../../src","sources":["ui/utils/themeUtils.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,cAAc,GAAIC,KAAqB,IAChDA,KAAK,KAAK,OAAO,IAAIA,KAAK,KAAK,MAAM,GAAGA,KAAK,GAAG,OAAO;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAAGA,CAChCC,WAA2B,EAC3BF,KAAc,KACK;EACnB;EACA,IAAIE,WAAW,KAAK,OAAO,IAAIA,WAAW,KAAK,MAAM,EAAE;IACnD,OAAOA,WAAW;EACtB;;EAEA;EACA,IAAIF,KAAK,KAAK,OAAO,IAAIA,KAAK,KAAK,MAAM,EAAE;IACvC,OAAOA,KAAK;EAChB;;EAEA;EACA,OAAO,OAAO;AAClB,CAAC","ignoreList":[]}

package/lib/module/ui/utils/user-utils.js

@@ -0,0 +1,46 @@
+"use strict";
+
+/**
+ * User display name and date formatting utilities
+ */
+
+/**
+ * Formats a date string to a readable format (e.g., "Feb 21, 2025")
+ */
+export const formatDate = dateString => {
+  if (!dateString) return '';
+  try {
+    const date = dateString instanceof Date ? dateString : new Date(dateString);
+    if (isNaN(date.getTime())) return '';
+    return date.toLocaleDateString('en-US', {
+      month: 'short',
+      day: 'numeric',
+      year: 'numeric'
+    });
+  } catch {
+    return '';
+  }
+};
+
+/**
+ * Gets a display name from user data
+ */
+export const getDisplayName = user => {
+  if (!user) return 'User';
+  const fullName = user.name?.full;
+  if (fullName) return fullName;
+  const firstLast = [user.name?.first, user.name?.last].filter(Boolean).join(' ').trim();
+  if (firstLast) return firstLast;
+  return user.username || 'User';
+};
+
+/**
+ * Gets a short display name (first name or username)
+ */
+export const getShortDisplayName = user => {
+  if (!user) return 'User';
+  const firstName = user.name?.first || user.name?.full?.split(' ')[0];
+  if (firstName) return firstName;
+  return user.username || 'User';
+};
+//# sourceMappingURL=user-utils.js.map

package/lib/module/ui/utils/user-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatDate","dateString","date","Date","isNaN","getTime","toLocaleDateString","month","day","year","getDisplayName","user","fullName","name","full","firstLast","first","last","filter","Boolean","join","trim","username","getShortDisplayName","firstName","split"],"sourceRoot":"../../../../src","sources":["ui/utils/user-utils.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;AACA;AACA;AACA,OAAO,MAAMA,UAAU,GAAIC,UAA4C,IAAa;EAClF,IAAI,CAACA,UAAU,EAAE,OAAO,EAAE;EAE1B,IAAI;IACF,MAAMC,IAAI,GAAGD,UAAU,YAAYE,IAAI,GAAGF,UAAU,GAAG,IAAIE,IAAI,CAACF,UAAU,CAAC;IAC3E,IAAIG,KAAK,CAACF,IAAI,CAACG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE;IAEpC,OAAOH,IAAI,CAACI,kBAAkB,CAAC,OAAO,EAAE;MACtCC,KAAK,EAAE,OAAO;MACdC,GAAG,EAAE,SAAS;MACdC,IAAI,EAAE;IACR,CAAC,CAAC;EACJ,CAAC,CAAC,MAAM;IACN,OAAO,EAAE;EACX;AACF,CAAC;;AAED;AACA;AACA;AACA,OAAO,MAAMC,cAAc,GAAIC,IAAuG,IAAa;EACjJ,IAAI,CAACA,IAAI,EAAE,OAAO,MAAM;EAExB,MAAMC,QAAQ,GAAGD,IAAI,CAACE,IAAI,EAAEC,IAAI;EAChC,IAAIF,QAAQ,EAAE,OAAOA,QAAQ;EAE7B,MAAMG,SAAS,GAAG,CAACJ,IAAI,CAACE,IAAI,EAAEG,KAAK,EAAEL,IAAI,CAACE,IAAI,EAAEI,IAAI,CAAC,CAACC,MAAM,CAACC,OAAO,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC,CAACC,IAAI,CAAC,CAAC;EACtF,IAAIN,SAAS,EAAE,OAAOA,SAAS;EAE/B,OAAOJ,IAAI,CAACW,QAAQ,IAAI,MAAM;AAChC,CAAC;;AAED;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAAIZ,IAAwF,IAAa;EACvI,IAAI,CAACA,IAAI,EAAE,OAAO,MAAM;EAExB,MAAMa,SAAS,GAAGb,IAAI,CAACE,IAAI,EAAEG,KAAK,IAAIL,IAAI,CAACE,IAAI,EAAEC,IAAI,EAAEW,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;EACpE,IAAID,SAAS,EAAE,OAAOA,SAAS;EAE/B,OAAOb,IAAI,CAACW,QAAQ,IAAI,MAAM;AAChC,CAAC","ignoreList":[]}

package/lib/module/utils/apiUtils.js

@@ -0,0 +1,72 @@
+"use strict";
+
+/**
+ * Utility functions for common API patterns
+ */
+
+/**
+ * Build URL search parameters from an object
+ * @param params Object with parameter key-value pairs
+ * @returns URLSearchParams instance
+ */
+export function buildSearchParams(params) {
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== undefined && value !== null) {
+      searchParams.append(key, value.toString());
+    }
+  }
+  return searchParams;
+}
+
+/**
+ * Build URL with search parameters
+ * @param baseUrl Base URL
+ * @param params Object with parameter key-value pairs
+ * @returns Complete URL with search parameters
+ */
+export function buildUrl(baseUrl, params) {
+  if (!params) return baseUrl;
+  const searchParams = buildSearchParams(params);
+  const queryString = searchParams.toString();
+  return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+}
+
+/**
+ * Common pagination parameters
+ */
+
+/**
+ * Build pagination search parameters
+ * @param params Pagination parameters
+ * @returns URLSearchParams with pagination
+ */
+export function buildPaginationParams(params) {
+  return buildSearchParams(params);
+}
+
+/**
+ * Common API response wrapper
+ */
+
+/**
+ * Common error response wrapper
+ */
+
+/**
+ * Safe JSON parsing with error handling
+ * @param data Data to parse
+ * @param fallback Fallback value if parsing fails
+ * @returns Parsed data or fallback
+ */
+export function safeJsonParse(data, fallback) {
+  if (typeof data === 'string') {
+    try {
+      return JSON.parse(data);
+    } catch {
+      return fallback;
+    }
+  }
+  return data;
+}
+//# sourceMappingURL=apiUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["buildSearchParams","params","searchParams","URLSearchParams","key","value","Object","entries","undefined","append","toString","buildUrl","baseUrl","queryString","buildPaginationParams","safeJsonParse","data","fallback","JSON","parse"],"sourceRoot":"../../../src","sources":["utils/apiUtils.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,iBAAiBA,CAACC,MAA2B,EAAmB;EAC9E,MAAMC,YAAY,GAAG,IAAIC,eAAe,CAAC,CAAC;EAE1C,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACN,MAAM,CAAC,EAAE;IACjD,IAAII,KAAK,KAAKG,SAAS,IAAIH,KAAK,KAAK,IAAI,EAAE;MACzCH,YAAY,CAACO,MAAM,CAACL,GAAG,EAAEC,KAAK,CAACK,QAAQ,CAAC,CAAC,CAAC;IAC5C;EACF;EAEA,OAAOR,YAAY;AACrB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,QAAQA,CAACC,OAAe,EAAEX,MAA4B,EAAU;EAC9E,IAAI,CAACA,MAAM,EAAE,OAAOW,OAAO;EAE3B,MAAMV,YAAY,GAAGF,iBAAiB,CAACC,MAAM,CAAC;EAC9C,MAAMY,WAAW,GAAGX,YAAY,CAACQ,QAAQ,CAAC,CAAC;EAE3C,OAAOG,WAAW,GAAG,GAAGD,OAAO,IAAIC,WAAW,EAAE,GAAGD,OAAO;AAC5D;;AAEA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,qBAAqBA,CAACb,MAAwB,EAAmB;EAC/E,OAAOD,iBAAiB,CAACC,MAAM,CAAC;AAClC;;AAEA;AACA;AACA;;AAOA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASc,aAAaA,CAAIC,IAAS,EAAEC,QAAW,EAAK;EAC1D,IAAI,OAAOD,IAAI,KAAK,QAAQ,EAAE;IAC5B,IAAI;MACF,OAAOE,IAAI,CAACC,KAAK,CAACH,IAAI,CAAC;IACzB,CAAC,CAAC,MAAM;MACN,OAAOC,QAAQ;IACjB;EACF;EACA,OAAOD,IAAI;AACb","ignoreList":[]}

package/lib/module/utils/asyncUtils.js

@@ -0,0 +1,192 @@
+"use strict";
+
+/**
+ * Async utilities for common asynchronous patterns and error handling
+ */
+
+import { logger } from './loggerUtils';
+
+/**
+ * Wrapper for async operations with automatic error handling
+ * Returns null on error instead of throwing
+ */
+export async function withErrorHandling(operation, errorHandler, context) {
+  try {
+    return await operation();
+  } catch (error) {
+    if (errorHandler) {
+      errorHandler(error);
+    } else {
+      logger.error(`Error in ${context || 'operation'}`, error instanceof Error ? error : new Error(String(error)), {
+        component: 'asyncUtils',
+        method: 'withErrorHandling'
+      });
+    }
+    return null;
+  }
+}
+
+/**
+ * Execute multiple async operations in parallel with error handling
+ */
+export async function parallelWithErrorHandling(operations, errorHandler) {
+  const results = await Promise.allSettled(operations.map((op, index) => withErrorHandling(op, error => errorHandler?.(error, index))));
+  return results.map(result => result.status === 'fulfilled' ? result.value : null);
+}
+
+/**
+ * Retry an async operation with exponential backoff
+ * 
+ * By default, does not retry on 4xx errors (client errors).
+ * Use shouldRetry callback to customize retry behavior.
+ */
+export async function retryAsync(operation, maxRetries = 3, baseDelay = 1000, shouldRetry) {
+  let lastError;
+
+  // Default shouldRetry: don't retry on 4xx errors
+  const defaultShouldRetry = error => {
+    // Don't retry on 4xx errors (client errors)
+    if (error?.response?.status >= 400 && error?.response?.status < 500) {
+      return false;
+    }
+    return true;
+  };
+  const retryCheck = shouldRetry || defaultShouldRetry;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await operation();
+    } catch (error) {
+      lastError = error;
+      if (attempt === maxRetries) {
+        break;
+      }
+      if (!retryCheck(error)) {
+        break;
+      }
+
+      // Calculate delay with exponential backoff and jitter
+      const delay = baseDelay * Math.pow(2, attempt) + Math.random() * 1000;
+      await new Promise(resolve => setTimeout(resolve, delay));
+    }
+  }
+  throw lastError;
+}
+
+/**
+ * Debounce async function calls
+ */
+export function debounceAsync(func, delay) {
+  let timeoutId;
+  const lastPromise = null;
+  return (...args) => {
+    return new Promise((resolve, reject) => {
+      clearTimeout(timeoutId);
+      timeoutId = setTimeout(async () => {
+        try {
+          const result = await func(...args);
+          resolve(result);
+        } catch (error) {
+          reject(error);
+        }
+      }, delay);
+    });
+  };
+}
+
+/**
+ * Throttle async function calls
+ */
+export function throttleAsync(func, limit, interval) {
+  let inThrottle = false;
+  let lastPromise = null;
+  return (...args) => {
+    if (inThrottle) {
+      return lastPromise;
+    }
+    inThrottle = true;
+    lastPromise = func(...args);
+    setTimeout(() => {
+      inThrottle = false;
+    }, interval);
+    return lastPromise;
+  };
+}
+
+/**
+ * Execute async operations sequentially with progress tracking
+ */
+export async function sequentialWithProgress(operations, onProgress) {
+  const results = [];
+  for (let i = 0; i < operations.length; i++) {
+    const result = await operations[i]();
+    results.push(result);
+    onProgress?.(i + 1, operations.length);
+  }
+  return results;
+}
+
+/**
+ * Batch async operations
+ */
+export async function batchAsync(items, batchSize, processor) {
+  for (let i = 0; i < items.length; i += batchSize) {
+    const batch = items.slice(i, i + batchSize);
+    await processor(batch);
+  }
+}
+
+/**
+ * Create a cancellable async operation
+ */
+export function createCancellableAsync(operation) {
+  let abortController = null;
+  return {
+    execute: async () => {
+      abortController = new AbortController();
+      return await operation(abortController.signal);
+    },
+    cancel: () => {
+      abortController?.abort();
+    }
+  };
+}
+
+/**
+ * Timeout wrapper for async operations
+ */
+export async function withTimeout(operation, timeoutMs, timeoutMessage) {
+  const timeoutPromise = new Promise((_, reject) => {
+    setTimeout(() => {
+      reject(new Error(timeoutMessage || `Operation timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+  });
+  return Promise.race([operation, timeoutPromise]);
+}
+
+/**
+ * Execute async operation with loading state
+ */
+export async function withLoadingState(operation, setLoading) {
+  setLoading(true);
+  try {
+    return await operation();
+  } finally {
+    setLoading(false);
+  }
+}
+
+/**
+ * Create a promise that resolves after a delay
+ */
+export const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+/**
+ * Execute async operation with retry on specific errors
+ */
+export async function retryOnError(operation, retryableErrors, maxRetries = 3) {
+  return retryAsync(operation, maxRetries, 1000, error => {
+    const errorCode = error?.code || error?.status || error?.message;
+    return retryableErrors.includes(errorCode);
+  });
+}
+//# sourceMappingURL=asyncUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["logger","withErrorHandling","operation","errorHandler","context","error","Error","String","component","method","parallelWithErrorHandling","operations","results","Promise","allSettled","map","op","index","result","status","value","retryAsync","maxRetries","baseDelay","shouldRetry","lastError","defaultShouldRetry","response","retryCheck","attempt","delay","Math","pow","random","resolve","setTimeout","debounceAsync","func","timeoutId","lastPromise","args","reject","clearTimeout","throttleAsync","limit","interval","inThrottle","sequentialWithProgress","onProgress","i","length","push","batchAsync","items","batchSize","processor","batch","slice","createCancellableAsync","abortController","execute","AbortController","signal","cancel","abort","withTimeout","timeoutMs","timeoutMessage","timeoutPromise","_","race","withLoadingState","setLoading","ms","retryOnError","retryableErrors","errorCode","code","message","includes"],"sourceRoot":"../../../src","sources":["utils/asyncUtils.ts"],"mappings":"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","ignoreList":[]}