@oxyhq/services 5.25.0 → 5.26.1

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":[]}

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

@@ -0,0 +1,196 @@
+"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, "darkenColor", {
+  enumerable: true,
+  get: function () {
+    return _colorUtils.darkenColor;
+  }
+});
+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, "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("./colorUtils.js");
+var _themeUtils = require("./themeUtils.js");
+var _errorUtils = require("./errorUtils.js");
+var _networkUtils = require("./networkUtils.js");
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,213 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withRetry = exports.shouldAllowRequest = exports.recordSuccess = exports.recordFailure = exports.delay = exports.createCircuitBreakerState = exports.calculateBackoffInterval = exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = void 0;
+/**
+ * Network Utility Functions
+ *
+ * Consolidated network utilities including circuit breaker pattern
+ * and exponential backoff for resilient API calls.
+ *
+ * @module shared/utils/networkUtils
+ */
+
+/**
+ * State for circuit breaker pattern.
+ */
+
+/**
+ * Configuration for circuit breaker.
+ */
+
+/**
+ * Default circuit breaker configuration.
+ */
+const DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+  baseInterval: 10000,
+  maxInterval: 60000,
+  maxFailures: 5,
+  recoveryTimeout: 30000
+};
+
+/**
+ * Creates initial circuit breaker state.
+ *
+ * @param config - Optional custom configuration
+ * @returns Initial circuit breaker state
+ *
+ * @example
+ * ```ts
+ * const state = createCircuitBreakerState({ maxFailures: 3 });
+ * ```
+ */
+const createCircuitBreakerState = (config = {}) => {
+  const {
+    baseInterval,
+    maxInterval,
+    maxFailures
+  } = {
+    ...DEFAULT_CIRCUIT_BREAKER_CONFIG,
+    ...config
+  };
+  return {
+    consecutiveFailures: 0,
+    currentInterval: baseInterval,
+    baseInterval,
+    maxInterval,
+    maxFailures,
+    isOpen: false
+  };
+};
+
+/**
+ * Calculates next interval using exponential backoff.
+ *
+ * @param state - Current circuit breaker state
+ * @returns Next interval in milliseconds
+ *
+ * @example
+ * ```ts
+ * const nextInterval = calculateBackoffInterval(state);
+ * await delay(nextInterval);
+ * ```
+ */
+exports.createCircuitBreakerState = createCircuitBreakerState;
+const calculateBackoffInterval = state => {
+  const {
+    consecutiveFailures,
+    baseInterval,
+    maxInterval
+  } = state;
+  if (consecutiveFailures === 0) return baseInterval;
+  const backoffMultiplier = Math.min(Math.pow(2, consecutiveFailures - 1), maxInterval / baseInterval);
+  return Math.min(baseInterval * backoffMultiplier, maxInterval);
+};
+
+/**
+ * Records a failure and updates circuit breaker state.
+ *
+ * @param state - Current circuit breaker state
+ * @returns Updated state after recording failure
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await apiCall();
+ *   state = recordSuccess(state);
+ * } catch (error) {
+ *   state = recordFailure(state);
+ * }
+ * ```
+ */
+exports.calculateBackoffInterval = calculateBackoffInterval;
+const recordFailure = state => {
+  const newFailures = state.consecutiveFailures + 1;
+  const newInterval = calculateBackoffInterval({
+    ...state,
+    consecutiveFailures: newFailures
+  });
+  const shouldOpenCircuit = newFailures >= state.maxFailures;
+  const finalInterval = shouldOpenCircuit ? state.maxInterval : newInterval;
+  return {
+    ...state,
+    consecutiveFailures: newFailures,
+    currentInterval: finalInterval,
+    isOpen: shouldOpenCircuit,
+    openedAt: shouldOpenCircuit ? Date.now() : state.openedAt
+  };
+};
+
+/**
+ * Records a success and resets circuit breaker state.
+ *
+ * @param state - Current circuit breaker state
+ * @returns Reset state after successful request
+ */
+exports.recordFailure = recordFailure;
+const recordSuccess = state => {
+  return {
+    ...state,
+    consecutiveFailures: 0,
+    currentInterval: state.baseInterval,
+    isOpen: false,
+    openedAt: undefined
+  };
+};
+
+/**
+ * Checks if the circuit breaker should allow a request.
+ *
+ * When the circuit is open, it will only allow requests after
+ * the recovery timeout has passed (half-open state).
+ *
+ * @param state - Current circuit breaker state
+ * @param recoveryTimeout - Time to wait before allowing recovery attempts
+ * @returns true if request should be allowed
+ */
+exports.recordSuccess = recordSuccess;
+const shouldAllowRequest = (state, recoveryTimeout = DEFAULT_CIRCUIT_BREAKER_CONFIG.recoveryTimeout) => {
+  if (!state.isOpen) return true;
+  if (!state.openedAt) return true;
+  const timeSinceOpen = Date.now() - state.openedAt;
+  return timeSinceOpen >= recoveryTimeout;
+};
+
+/**
+ * Delays execution for a specified duration.
+ *
+ * @param ms - Milliseconds to delay
+ * @returns Promise that resolves after the delay
+ *
+ * @example
+ * ```ts
+ * await delay(1000); // Wait 1 second
+ * ```
+ */
+exports.shouldAllowRequest = shouldAllowRequest;
+const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+/**
+ * Executes a function with exponential backoff retry.
+ *
+ * @param fn - Async function to execute
+ * @param options - Retry options
+ * @returns Result of the function
+ * @throws Last error if all retries fail
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   { maxRetries: 3, baseDelay: 1000 }
+ * );
+ * ```
+ */
+exports.delay = delay;
+const withRetry = async (fn, options = {}) => {
+  const {
+    maxRetries = 3,
+    baseDelay = 1000,
+    maxDelay = 30000,
+    shouldRetry = () => true,
+    onRetry
+  } = options;
+  let lastError;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (attempt === maxRetries || !shouldRetry(error)) {
+        throw error;
+      }
+      const delayMs = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+      onRetry?.(error, attempt + 1);
+      await delay(delayMs);
+    }
+  }
+  throw lastError;
+};
+exports.withRetry = withRetry;
+//# sourceMappingURL=networkUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_CIRCUIT_BREAKER_CONFIG","exports","baseInterval","maxInterval","maxFailures","recoveryTimeout","createCircuitBreakerState","config","consecutiveFailures","currentInterval","isOpen","calculateBackoffInterval","state","backoffMultiplier","Math","min","pow","recordFailure","newFailures","newInterval","shouldOpenCircuit","finalInterval","openedAt","Date","now","recordSuccess","undefined","shouldAllowRequest","timeSinceOpen","delay","ms","Promise","resolve","setTimeout","withRetry","fn","options","maxRetries","baseDelay","maxDelay","shouldRetry","onRetry","lastError","attempt","error","delayMs"],"sourceRoot":"../../../../src","sources":["shared/utils/networkUtils.ts"],"mappings":"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","ignoreList":[]}