@oxyhq/services 5.24.0 → 5.26.0

package/lib/commonjs/shared/index.js

@@ -0,0 +1,227 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DEFAULT_CIRCUIT_BREAKER_CONFIG", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.DEFAULT_CIRCUIT_BREAKER_CONFIG;
+  }
+});
+Object.defineProperty(exports, "HttpStatus", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.HttpStatus;
+  }
+});
+Object.defineProperty(exports, "calculateBackoffInterval", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.calculateBackoffInterval;
+  }
+});
+Object.defineProperty(exports, "createCircuitBreakerState", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.createCircuitBreakerState;
+  }
+});
+Object.defineProperty(exports, "createDebugLogger", {
+  enumerable: true,
+  get: function () {
+    return _debugUtils.createDebugLogger;
+  }
+});
+Object.defineProperty(exports, "darkenColor", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.darkenColor;
+  }
+});
+Object.defineProperty(exports, "debugError", {
+  enumerable: true,
+  get: function () {
+    return _debugUtils.debugError;
+  }
+});
+Object.defineProperty(exports, "debugLog", {
+  enumerable: true,
+  get: function () {
+    return _debugUtils.debugLog;
+  }
+});
+Object.defineProperty(exports, "debugWarn", {
+  enumerable: true,
+  get: function () {
+    return _debugUtils.debugWarn;
+  }
+});
+Object.defineProperty(exports, "delay", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.delay;
+  }
+});
+Object.defineProperty(exports, "getContrastTextColor", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.getContrastTextColor;
+  }
+});
+Object.defineProperty(exports, "getErrorMessage", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.getErrorMessage;
+  }
+});
+Object.defineProperty(exports, "getErrorStatus", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.getErrorStatus;
+  }
+});
+Object.defineProperty(exports, "getOppositeTheme", {
+  enumerable: true,
+  get: function () {
+    return _themeUtils.getOppositeTheme;
+  }
+});
+Object.defineProperty(exports, "getSystemColorScheme", {
+  enumerable: true,
+  get: function () {
+    return _themeUtils.getSystemColorScheme;
+  }
+});
+Object.defineProperty(exports, "hexToRgb", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.hexToRgb;
+  }
+});
+Object.defineProperty(exports, "isAlreadyRegisteredError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isAlreadyRegisteredError;
+  }
+});
+Object.defineProperty(exports, "isDev", {
+  enumerable: true,
+  get: function () {
+    return _debugUtils.isDev;
+  }
+});
+Object.defineProperty(exports, "isForbiddenError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isForbiddenError;
+  }
+});
+Object.defineProperty(exports, "isLightColor", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.isLightColor;
+  }
+});
+Object.defineProperty(exports, "isNetworkError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isNetworkError;
+  }
+});
+Object.defineProperty(exports, "isNotFoundError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isNotFoundError;
+  }
+});
+Object.defineProperty(exports, "isRateLimitError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isRateLimitError;
+  }
+});
+Object.defineProperty(exports, "isRetryableError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isRetryableError;
+  }
+});
+Object.defineProperty(exports, "isServerError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isServerError;
+  }
+});
+Object.defineProperty(exports, "isUnauthorizedError", {
+  enumerable: true,
+  get: function () {
+    return _errorUtils.isUnauthorizedError;
+  }
+});
+Object.defineProperty(exports, "lightenColor", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.lightenColor;
+  }
+});
+Object.defineProperty(exports, "normalizeColorScheme", {
+  enumerable: true,
+  get: function () {
+    return _themeUtils.normalizeColorScheme;
+  }
+});
+Object.defineProperty(exports, "normalizeTheme", {
+  enumerable: true,
+  get: function () {
+    return _themeUtils.normalizeTheme;
+  }
+});
+Object.defineProperty(exports, "recordFailure", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.recordFailure;
+  }
+});
+Object.defineProperty(exports, "recordSuccess", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.recordSuccess;
+  }
+});
+Object.defineProperty(exports, "rgbToHex", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.rgbToHex;
+  }
+});
+Object.defineProperty(exports, "shouldAllowRequest", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.shouldAllowRequest;
+  }
+});
+Object.defineProperty(exports, "systemPrefersDarkMode", {
+  enumerable: true,
+  get: function () {
+    return _themeUtils.systemPrefersDarkMode;
+  }
+});
+Object.defineProperty(exports, "withOpacity", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.withOpacity;
+  }
+});
+Object.defineProperty(exports, "withRetry", {
+  enumerable: true,
+  get: function () {
+    return _networkUtils.withRetry;
+  }
+});
+var _colorUtils = require("./utils/colorUtils.js");
+var _themeUtils = require("./utils/themeUtils.js");
+var _errorUtils = require("./utils/errorUtils.js");
+var _networkUtils = require("./utils/networkUtils.js");
+var _debugUtils = require("./utils/debugUtils.js");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_colorUtils","require","_themeUtils","_errorUtils","_networkUtils","_debugUtils"],"sourceRoot":"../../../src","sources":["shared/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAAA,WAAA,GAAAC,OAAA;AAWA,IAAAC,WAAA,GAAAD,OAAA;AAUA,IAAAE,WAAA,GAAAF,OAAA;AAeA,IAAAG,aAAA,GAAAH,OAAA;AAgBA,IAAAI,WAAA,GAAAJ,OAAA","ignoreList":[]}

package/lib/commonjs/shared/utils/colorUtils.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withOpacity = exports.rgbToHex = exports.lightenColor = exports.isLightColor = exports.hexToRgb = exports.getContrastTextColor = exports.darkenColor = void 0;
+/**
+ * Color Utility Functions
+ *
+ * Consolidated color manipulation utilities used across the OxyServices ecosystem.
+ * These functions work in any JavaScript environment (browser, Node.js, React Native).
+ *
+ * @module shared/utils/colorUtils
+ */
+
+/**
+ * Darkens a hex color by a specified factor.
+ *
+ * @param color - Hex color string (with or without #)
+ * @param factor - Amount to darken (0-1). Default: 0.6
+ * @returns Darkened hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * darkenColor('#FF0000', 0.5); // Returns a darker red
+ * darkenColor('FF0000', 0.3);  // Also works without #
+ * ```
+ */
+const darkenColor = (color, factor = 0.6) => {
+  const hex = color.replace('#', '');
+  const r = parseInt(hex.substring(0, 2), 16);
+  const g = parseInt(hex.substring(2, 4), 16);
+  const b = parseInt(hex.substring(4, 6), 16);
+  const newR = Math.max(0, Math.round(r * (1 - factor)));
+  const newG = Math.max(0, Math.round(g * (1 - factor)));
+  const newB = Math.max(0, Math.round(b * (1 - factor)));
+  return `#${newR.toString(16).padStart(2, '0')}${newG.toString(16).padStart(2, '0')}${newB.toString(16).padStart(2, '0')}`;
+};
+
+/**
+ * Lightens a hex color by a specified factor.
+ *
+ * @param color - Hex color string (with or without #)
+ * @param factor - Amount to lighten (0-1). Default: 0.3
+ * @returns Lightened hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * lightenColor('#0000FF', 0.5); // Returns a lighter blue
+ * ```
+ */
+exports.darkenColor = darkenColor;
+const lightenColor = (color, factor = 0.3) => {
+  const hex = color.replace('#', '');
+  const r = parseInt(hex.substring(0, 2), 16);
+  const g = parseInt(hex.substring(2, 4), 16);
+  const b = parseInt(hex.substring(4, 6), 16);
+  const newR = Math.min(255, Math.round(r + (255 - r) * factor));
+  const newG = Math.min(255, Math.round(g + (255 - g) * factor));
+  const newB = Math.min(255, Math.round(b + (255 - b) * factor));
+  return `#${newR.toString(16).padStart(2, '0')}${newG.toString(16).padStart(2, '0')}${newB.toString(16).padStart(2, '0')}`;
+};
+
+/**
+ * Converts a hex color to RGB values.
+ *
+ * @param hex - Hex color string (with or without #)
+ * @returns Object with r, g, b values (0-255)
+ *
+ * @example
+ * ```ts
+ * hexToRgb('#FF5733'); // { r: 255, g: 87, b: 51 }
+ * ```
+ */
+exports.lightenColor = lightenColor;
+const hexToRgb = hex => {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  return result ? {
+    r: parseInt(result[1], 16),
+    g: parseInt(result[2], 16),
+    b: parseInt(result[3], 16)
+  } : null;
+};
+
+/**
+ * Converts RGB values to a hex color string.
+ *
+ * @param r - Red value (0-255)
+ * @param g - Green value (0-255)
+ * @param b - Blue value (0-255)
+ * @returns Hex color string with # prefix
+ *
+ * @example
+ * ```ts
+ * rgbToHex(255, 87, 51); // '#ff5733'
+ * ```
+ */
+exports.hexToRgb = hexToRgb;
+const rgbToHex = (r, g, b) => {
+  return `#${((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1)}`;
+};
+
+/**
+ * Adjusts the opacity of a hex color, returning an rgba string.
+ *
+ * @param hex - Hex color string
+ * @param opacity - Opacity value (0-1)
+ * @returns RGBA color string
+ *
+ * @example
+ * ```ts
+ * withOpacity('#FF0000', 0.5); // 'rgba(255, 0, 0, 0.5)'
+ * ```
+ */
+exports.rgbToHex = rgbToHex;
+const withOpacity = (hex, opacity) => {
+  const rgb = hexToRgb(hex);
+  if (!rgb) return hex;
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${opacity})`;
+};
+
+/**
+ * Checks if a color is considered "light" (for determining text contrast).
+ *
+ * @param hex - Hex color string
+ * @returns true if the color is light, false if dark
+ *
+ * @example
+ * ```ts
+ * isLightColor('#FFFFFF'); // true
+ * isLightColor('#000000'); // false
+ * ```
+ */
+exports.withOpacity = withOpacity;
+const isLightColor = hex => {
+  const rgb = hexToRgb(hex);
+  if (!rgb) return true;
+
+  // Using relative luminance formula
+  const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;
+  return luminance > 0.5;
+};
+
+/**
+ * Gets a contrasting text color (black or white) for a given background color.
+ *
+ * @param backgroundColor - Hex color string of the background
+ * @returns '#000000' for light backgrounds, '#ffffff' for dark backgrounds
+ *
+ * @example
+ * ```ts
+ * getContrastTextColor('#FFFF00'); // '#000000' (black text on yellow)
+ * getContrastTextColor('#000080'); // '#ffffff' (white text on navy)
+ * ```
+ */
+exports.isLightColor = isLightColor;
+const getContrastTextColor = backgroundColor => {
+  return isLightColor(backgroundColor) ? '#000000' : '#ffffff';
+};
+exports.getContrastTextColor = getContrastTextColor;
+//# sourceMappingURL=colorUtils.js.map

package/lib/commonjs/shared/utils/colorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["darkenColor","color","factor","hex","replace","r","parseInt","substring","g","b","newR","Math","max","round","newG","newB","toString","padStart","exports","lightenColor","min","hexToRgb","result","exec","rgbToHex","slice","withOpacity","opacity","rgb","isLightColor","luminance","getContrastTextColor","backgroundColor"],"sourceRoot":"../../../../src","sources":["shared/utils/colorUtils.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/shared/utils/debugUtils.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isDev = exports.debugWarn = exports.debugLog = exports.debugError = exports.createDebugLogger = void 0;
+/**
+ * Debug Utilities
+ *
+ * Provides safe logging functions that only output in development mode.
+ * All logs are stripped in production builds.
+ *
+ * @module shared/utils/debugUtils
+ */
+
+/* global __DEV__ */
+
+/**
+ * Check if running in development mode
+ */
+const isDev = () => {
+  return typeof __DEV__ !== 'undefined' && __DEV__;
+};
+
+/**
+ * Log a debug message (only in development)
+ * @param prefix - Log prefix (e.g., '[FedCM]')
+ * @param args - Arguments to log
+ */
+exports.isDev = isDev;
+const debugLog = (prefix, ...args) => {
+  if (isDev()) {
+    console.log(prefix, ...args);
+  }
+};
+
+/**
+ * Log a debug warning (only in development)
+ * @param prefix - Log prefix
+ * @param args - Arguments to log
+ */
+exports.debugLog = debugLog;
+const debugWarn = (prefix, ...args) => {
+  if (isDev()) {
+    console.warn(prefix, ...args);
+  }
+};
+
+/**
+ * Log a debug error (only in development)
+ * @param prefix - Log prefix
+ * @param args - Arguments to log
+ */
+exports.debugWarn = debugWarn;
+const debugError = (prefix, ...args) => {
+  if (isDev()) {
+    console.error(prefix, ...args);
+  }
+};
+
+/**
+ * Create a namespaced debug logger
+ * @param namespace - Logger namespace (e.g., 'FedCM', 'PopupAuth')
+ * @returns Object with log, warn, error methods
+ *
+ * @example
+ * ```ts
+ * const debug = createDebugLogger('FedCM');
+ * debug.log('Starting authentication');
+ * debug.warn('Token expires soon');
+ * debug.error('Authentication failed', error);
+ * ```
+ */
+exports.debugError = debugError;
+const createDebugLogger = namespace => {
+  const prefix = `[${namespace}]`;
+  return {
+    log: (...args) => debugLog(prefix, ...args),
+    warn: (...args) => debugWarn(prefix, ...args),
+    error: (...args) => debugError(prefix, ...args)
+  };
+};
+exports.createDebugLogger = createDebugLogger;
+//# sourceMappingURL=debugUtils.js.map

package/lib/commonjs/shared/utils/debugUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isDev","__DEV__","exports","debugLog","prefix","args","console","log","debugWarn","warn","debugError","error","createDebugLogger","namespace"],"sourceRoot":"../../../../src","sources":["shared/utils/debugUtils.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;AACA;AACA;AACO,MAAMA,KAAK,GAAGA,CAAA,KAAe;EAClC,OAAO,OAAOC,OAAO,KAAK,WAAW,IAAIA,OAAO;AAClD,CAAC;;AAED;AACA;AACA;AACA;AACA;AAJAC,OAAA,CAAAF,KAAA,GAAAA,KAAA;AAKO,MAAMG,QAAQ,GAAGA,CAACC,MAAc,EAAE,GAAGC,IAAe,KAAW;EACpE,IAAIL,KAAK,CAAC,CAAC,EAAE;IACXM,OAAO,CAACC,GAAG,CAACH,MAAM,EAAE,GAAGC,IAAI,CAAC;EAC9B;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AAJAH,OAAA,CAAAC,QAAA,GAAAA,QAAA;AAKO,MAAMK,SAAS,GAAGA,CAACJ,MAAc,EAAE,GAAGC,IAAe,KAAW;EACrE,IAAIL,KAAK,CAAC,CAAC,EAAE;IACXM,OAAO,CAACG,IAAI,CAACL,MAAM,EAAE,GAAGC,IAAI,CAAC;EAC/B;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AAJAH,OAAA,CAAAM,SAAA,GAAAA,SAAA;AAKO,MAAME,UAAU,GAAGA,CAACN,MAAc,EAAE,GAAGC,IAAe,KAAW;EACtE,IAAIL,KAAK,CAAC,CAAC,EAAE;IACXM,OAAO,CAACK,KAAK,CAACP,MAAM,EAAE,GAAGC,IAAI,CAAC;EAChC;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAZAH,OAAA,CAAAQ,UAAA,GAAAA,UAAA;AAaO,MAAME,iBAAiB,GAAIC,SAAiB,IAAK;EACtD,MAAMT,MAAM,GAAG,IAAIS,SAAS,GAAG;EAC/B,OAAO;IACLN,GAAG,EAAEA,CAAC,GAAGF,IAAe,KAAKF,QAAQ,CAACC,MAAM,EAAE,GAAGC,IAAI,CAAC;IACtDI,IAAI,EAAEA,CAAC,GAAGJ,IAAe,KAAKG,SAAS,CAACJ,MAAM,EAAE,GAAGC,IAAI,CAAC;IACxDM,KAAK,EAAEA,CAAC,GAAGN,IAAe,KAAKK,UAAU,CAACN,MAAM,EAAE,GAAGC,IAAI;EAC3D,CAAC;AACH,CAAC;AAACH,OAAA,CAAAU,iBAAA,GAAAA,iBAAA","ignoreList":[]}

package/lib/commonjs/shared/utils/errorUtils.js

@@ -0,0 +1,190 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isUnauthorizedError = exports.isServerError = exports.isRetryableError = exports.isRateLimitError = exports.isNotFoundError = exports.isNetworkError = exports.isForbiddenError = exports.isAlreadyRegisteredError = exports.getErrorStatus = exports.getErrorMessage = exports.HttpStatus = void 0;
+/**
+ * Error Utility Functions
+ *
+ * Consolidated error handling utilities for the OxyServices ecosystem.
+ * These functions help with common error patterns like checking HTTP status codes.
+ *
+ * @module shared/utils/errorUtils
+ */
+
+/**
+ * Common HTTP status codes used in error checking.
+ */
+const HttpStatus = exports.HttpStatus = {
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  CONFLICT: 409,
+  UNPROCESSABLE_ENTITY: 422,
+  TOO_MANY_REQUESTS: 429,
+  INTERNAL_SERVER_ERROR: 500,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504
+};
+
+/**
+ * Extracts the HTTP status code from an error object.
+ *
+ * @param error - Any error object
+ * @returns The status code if found, undefined otherwise
+ */
+const getErrorStatus = error => {
+  if (!error || typeof error !== 'object') return undefined;
+  const err = error;
+
+  // Direct status property
+  if (typeof err.status === 'number') return err.status;
+
+  // Axios-style response.status
+  if (err.response && typeof err.response === 'object') {
+    const response = err.response;
+    if (typeof response.status === 'number') return response.status;
+  }
+
+  // statusCode property (some libraries use this)
+  if (typeof err.statusCode === 'number') return err.statusCode;
+  return undefined;
+};
+
+/**
+ * Extracts the error message from an error object.
+ *
+ * @param error - Any error object
+ * @param fallback - Fallback message if none found
+ * @returns The error message
+ */
+exports.getErrorStatus = getErrorStatus;
+const getErrorMessage = (error, fallback = 'An unknown error occurred') => {
+  if (!error) return fallback;
+  if (typeof error === 'string') return error;
+  if (error instanceof Error) return error.message;
+  if (typeof error === 'object') {
+    const err = error;
+    if (typeof err.message === 'string') return err.message;
+    if (typeof err.error === 'string') return err.error;
+
+    // Axios-style response.data.message
+    if (err.response && typeof err.response === 'object') {
+      const response = err.response;
+      if (response.data && typeof response.data === 'object') {
+        const data = response.data;
+        if (typeof data.message === 'string') return data.message;
+        if (typeof data.error === 'string') return data.error;
+      }
+    }
+  }
+  return fallback;
+};
+
+/**
+ * Check if an error indicates the user is already registered (HTTP 409 Conflict).
+ *
+ * The backend should always return HTTP 409 for duplicate registrations.
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 409 Conflict
+ */
+exports.getErrorMessage = getErrorMessage;
+const isAlreadyRegisteredError = error => {
+  return getErrorStatus(error) === HttpStatus.CONFLICT;
+};
+
+/**
+ * Check if an error is an authentication error (HTTP 401).
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 401 Unauthorized
+ */
+exports.isAlreadyRegisteredError = isAlreadyRegisteredError;
+const isUnauthorizedError = error => {
+  return getErrorStatus(error) === HttpStatus.UNAUTHORIZED;
+};
+
+/**
+ * Check if an error is a forbidden error (HTTP 403).
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 403 Forbidden
+ */
+exports.isUnauthorizedError = isUnauthorizedError;
+const isForbiddenError = error => {
+  return getErrorStatus(error) === HttpStatus.FORBIDDEN;
+};
+
+/**
+ * Check if an error is a not found error (HTTP 404).
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 404 Not Found
+ */
+exports.isForbiddenError = isForbiddenError;
+const isNotFoundError = error => {
+  return getErrorStatus(error) === HttpStatus.NOT_FOUND;
+};
+
+/**
+ * Check if an error is a rate limit error (HTTP 429).
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 429 Too Many Requests
+ */
+exports.isNotFoundError = isNotFoundError;
+const isRateLimitError = error => {
+  return getErrorStatus(error) === HttpStatus.TOO_MANY_REQUESTS;
+};
+
+/**
+ * Check if an error is a server error (HTTP 5xx).
+ *
+ * @param error - Any error object
+ * @returns true if the error is a 5xx server error
+ */
+exports.isRateLimitError = isRateLimitError;
+const isServerError = error => {
+  const status = getErrorStatus(error);
+  return status !== undefined && status >= 500 && status < 600;
+};
+
+/**
+ * Check if an error is a network error (no response received).
+ *
+ * @param error - Any error object
+ * @returns true if the error appears to be a network error
+ */
+exports.isServerError = isServerError;
+const isNetworkError = error => {
+  if (!error || typeof error !== 'object') return false;
+  const err = error;
+
+  // Check for common network error indicators
+  if (err.name === 'NetworkError') return true;
+  if (err.code === 'ENOTFOUND' || err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT') return true;
+
+  // Axios-style: has request but no response
+  if (err.request && !err.response) return true;
+
+  // Message-based detection
+  const message = getErrorMessage(error, '').toLowerCase();
+  return message.includes('network') || message.includes('connection') || message.includes('timeout');
+};
+
+/**
+ * Check if an error is retryable (network errors or 5xx server errors).
+ *
+ * @param error - Any error object
+ * @returns true if the request should be retried
+ */
+exports.isNetworkError = isNetworkError;
+const isRetryableError = error => {
+  return isNetworkError(error) || isServerError(error) || isRateLimitError(error);
+};
+exports.isRetryableError = isRetryableError;
+//# sourceMappingURL=errorUtils.js.map

package/lib/commonjs/shared/utils/errorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["HttpStatus","exports","BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","CONFLICT","UNPROCESSABLE_ENTITY","TOO_MANY_REQUESTS","INTERNAL_SERVER_ERROR","BAD_GATEWAY","SERVICE_UNAVAILABLE","GATEWAY_TIMEOUT","getErrorStatus","error","undefined","err","status","response","statusCode","getErrorMessage","fallback","Error","message","data","isAlreadyRegisteredError","isUnauthorizedError","isForbiddenError","isNotFoundError","isRateLimitError","isServerError","isNetworkError","name","code","request","toLowerCase","includes","isRetryableError"],"sourceRoot":"../../../../src","sources":["shared/utils/errorUtils.ts"],"mappings":"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","ignoreList":[]}