@oxyhq/services 5.26.4 → 6.0.0

package/lib/typescript/module/shared/utils/colorUtils.d.ts

@@ -1,105 +0,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 #
- * ```
- */
-export declare const darkenColor: (color: string, factor?: number) => string;
-/**
- * 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
- * ```
- */
-export declare const lightenColor: (color: string, factor?: number) => string;
-/**
- * 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 }
- * ```
- */
-export declare const hexToRgb: (hex: string) => {
-    r: number;
-    g: number;
-    b: number;
-} | 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'
- * ```
- */
-export declare const rgbToHex: (r: number, g: number, b: number) => string;
-/**
- * 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)'
- * ```
- */
-export declare const withOpacity: (hex: string, opacity: number) => string;
-/**
- * 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
- * ```
- */
-export declare const isLightColor: (hex: string) => boolean;
-/**
- * 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)
- * ```
- */
-export declare const getContrastTextColor: (backgroundColor: string) => string;
-//# sourceMappingURL=colorUtils.d.ts.map

package/lib/typescript/module/shared/utils/colorUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"colorUtils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/colorUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAY,KAAG,MAYjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAY,KAAG,MAYlE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAS5E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAE1D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,MAI1D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAO1C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAI,iBAAiB,MAAM,KAAG,MAE9D,CAAC"}

package/lib/typescript/module/shared/utils/debugUtils.d.ts

@@ -1,49 +0,0 @@
-/**
- * Debug Utilities
- *
- * Provides safe logging functions that only output in development mode.
- * All logs are stripped in production builds.
- *
- * @module shared/utils/debugUtils
- */
-/**
- * Check if running in development mode
- */
-export declare const isDev: () => boolean;
-/**
- * Log a debug message (only in development)
- * @param prefix - Log prefix (e.g., '[FedCM]')
- * @param args - Arguments to log
- */
-export declare const debugLog: (prefix: string, ...args: unknown[]) => void;
-/**
- * Log a debug warning (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-export declare const debugWarn: (prefix: string, ...args: unknown[]) => void;
-/**
- * Log a debug error (only in development)
- * @param prefix - Log prefix
- * @param args - Arguments to log
- */
-export declare const debugError: (prefix: string, ...args: unknown[]) => void;
-/**
- * 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);
- * ```
- */
-export declare const createDebugLogger: (namespace: string) => {
-    log: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-};
-//# sourceMappingURL=debugUtils.d.ts.map

package/lib/typescript/module/shared/utils/debugUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"debugUtils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/debugUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,eAAO,MAAM,KAAK,QAAO,OAExB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,KAAG,IAI7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,KAAG,IAI9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,KAAG,IAI/D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM;mBAGhC,OAAO,EAAE;oBACR,OAAO,EAAE;qBACR,OAAO,EAAE;CAE7B,CAAC"}

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

@@ -1,98 +0,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.
- */
-export declare const HttpStatus: {
-    readonly BAD_REQUEST: 400;
-    readonly UNAUTHORIZED: 401;
-    readonly FORBIDDEN: 403;
-    readonly NOT_FOUND: 404;
-    readonly CONFLICT: 409;
-    readonly UNPROCESSABLE_ENTITY: 422;
-    readonly TOO_MANY_REQUESTS: 429;
-    readonly INTERNAL_SERVER_ERROR: 500;
-    readonly BAD_GATEWAY: 502;
-    readonly SERVICE_UNAVAILABLE: 503;
-    readonly 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
- */
-export declare const getErrorStatus: (error: unknown) => number | 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
- */
-export declare const getErrorMessage: (error: unknown, fallback?: string) => string;
-/**
- * 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
- */
-export declare const isAlreadyRegisteredError: (error: unknown) => boolean;
-/**
- * Check if an error is an authentication error (HTTP 401).
- *
- * @param error - Any error object
- * @returns true if the error is a 401 Unauthorized
- */
-export declare const isUnauthorizedError: (error: unknown) => boolean;
-/**
- * Check if an error is a forbidden error (HTTP 403).
- *
- * @param error - Any error object
- * @returns true if the error is a 403 Forbidden
- */
-export declare const isForbiddenError: (error: unknown) => boolean;
-/**
- * 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
- */
-export declare const isNotFoundError: (error: unknown) => boolean;
-/**
- * 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
- */
-export declare const isRateLimitError: (error: unknown) => boolean;
-/**
- * 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
- */
-export declare const isServerError: (error: unknown) => boolean;
-/**
- * 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
- */
-export declare const isNetworkError: (error: unknown) => boolean;
-/**
- * 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
- */
-export declare const isRetryableError: (error: unknown) => boolean;
-//# sourceMappingURL=errorUtils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errorUtils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAkBxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,WAAU,MAAoC,KAAG,MAyBhG,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,OAEzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,OAEpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,OAEjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,OAEhD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,OAEjD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,OAG9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAe/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,OAEjD,CAAC"}

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

@@ -1,14 +0,0 @@
-/**
- * Shared Utility Functions
- *
- * Re-exports all shared utilities for convenient importing.
- *
- * @module shared/utils
- */
-export { darkenColor, lightenColor, hexToRgb, rgbToHex, withOpacity, isLightColor, getContrastTextColor, } from './colorUtils';
-export { normalizeTheme, normalizeColorScheme, getOppositeTheme, systemPrefersDarkMode, getSystemColorScheme, } from './themeUtils';
-export type { ThemeValue } from './themeUtils';
-export { HttpStatus, getErrorStatus, getErrorMessage, isAlreadyRegisteredError, isUnauthorizedError, isForbiddenError, isNotFoundError, isRateLimitError, isServerError, isNetworkError, isRetryableError, } from './errorUtils';
-export { DEFAULT_CIRCUIT_BREAKER_CONFIG, createCircuitBreakerState, calculateBackoffInterval, recordFailure, recordSuccess, shouldAllowRequest, delay, withRetry, } from './networkUtils';
-export type { CircuitBreakerState, CircuitBreakerConfig, } from './networkUtils';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,KAAK,EACL,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/lib/typescript/module/shared/utils/networkUtils.d.ts

@@ -1,140 +0,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.
- */
-export interface CircuitBreakerState {
-    /** Number of consecutive failures */
-    consecutiveFailures: number;
-    /** Current interval between retries (ms) */
-    currentInterval: number;
-    /** Base interval for retries (ms) */
-    baseInterval: number;
-    /** Maximum interval cap (ms) */
-    maxInterval: number;
-    /** Number of failures before circuit opens */
-    maxFailures: number;
-    /** Whether the circuit is currently open (blocking requests) */
-    isOpen?: boolean;
-    /** Timestamp when circuit was opened */
-    openedAt?: number;
-}
-/**
- * Configuration for circuit breaker.
- */
-export interface CircuitBreakerConfig {
-    /** Base interval between retries in milliseconds. Default: 10000 (10s) */
-    baseInterval?: number;
-    /** Maximum interval cap in milliseconds. Default: 60000 (60s) */
-    maxInterval?: number;
-    /** Number of consecutive failures before opening circuit. Default: 5 */
-    maxFailures?: number;
-    /** Time to wait before attempting recovery in milliseconds. Default: 30000 (30s) */
-    recoveryTimeout?: number;
-}
-/**
- * Default circuit breaker configuration.
- */
-export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: Required<CircuitBreakerConfig>;
-/**
- * Creates initial circuit breaker state.
- *
- * @param config - Optional custom configuration
- * @returns Initial circuit breaker state
- *
- * @example
- * ```ts
- * const state = createCircuitBreakerState({ maxFailures: 3 });
- * ```
- */
-export declare const createCircuitBreakerState: (config?: CircuitBreakerConfig) => CircuitBreakerState;
-/**
- * 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);
- * ```
- */
-export declare const calculateBackoffInterval: (state: CircuitBreakerState) => number;
-/**
- * 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);
- * }
- * ```
- */
-export declare const recordFailure: (state: CircuitBreakerState) => CircuitBreakerState;
-/**
- * Records a success and resets circuit breaker state.
- *
- * @param state - Current circuit breaker state
- * @returns Reset state after successful request
- */
-export declare const recordSuccess: (state: CircuitBreakerState) => CircuitBreakerState;
-/**
- * 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
- */
-export declare const shouldAllowRequest: (state: CircuitBreakerState, recoveryTimeout?: number) => boolean;
-/**
- * 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
- * ```
- */
-export declare const delay: (ms: number) => Promise<void>;
-/**
- * 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 }
- * );
- * ```
- */
-export declare const withRetry: <T>(fn: () => Promise<T>, options?: {
-    maxRetries?: number;
-    baseDelay?: number;
-    maxDelay?: number;
-    shouldRetry?: (error: unknown) => boolean;
-    onRetry?: (error: unknown, attempt: number) => void;
-}) => Promise<T>;
-//# sourceMappingURL=networkUtils.d.ts.map

package/lib/typescript/module/shared/utils/networkUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"networkUtils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/networkUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,oBAAoB,CAKzE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAQ,oBAAyB,KAChC,mBAcF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,mBAAmB,KAAG,MAWrE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,mBAAmB,KAAG,mBAiB1D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,mBAAmB,KAAG,mBAQ1D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,mBAAmB,EAC1B,kBAAiB,MAAuD,KACvE,OAOF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACE,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,GAAU,CAAC,EAC/B,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAS;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD,KACL,OAAO,CAAC,CAAC,CA4BX,CAAC"}

package/lib/typescript/module/shared/utils/themeUtils.d.ts

@@ -1,91 +0,0 @@
-/**
- * Theme Utility Functions
- *
- * Consolidated theme utilities for normalizing and handling color schemes
- * across the OxyServices ecosystem.
- *
- * @module shared/utils/themeUtils
- */
-/**
- * Valid theme values in the Oxy ecosystem.
- */
-export type ThemeValue = 'light' | 'dark';
-/**
- * Normalizes a theme value to ensure it's always 'light' or 'dark'.
- *
- * @param theme - Theme value (may be 'light' | 'dark' | string | undefined)
- * @returns Normalized 'light' | 'dark' theme (defaults to 'light')
- *
- * @example
- * ```ts
- * normalizeTheme('dark');     // 'dark'
- * normalizeTheme('light');    // 'light'
- * normalizeTheme('unknown');  // 'light'
- * normalizeTheme(undefined);  // 'light'
- * normalizeTheme(null);       // 'light'
- * ```
- */
-export declare const normalizeTheme: (theme?: string | null) => ThemeValue;
-/**
- * Normalizes a color scheme value with optional fallback chain.
- *
- * Handles null/undefined cases from React Native's useColorScheme() hook
- * with a 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
- * // In a React Native component:
- * const systemScheme = useColorScheme(); // might be null
- * const colorScheme = normalizeColorScheme(systemScheme, props.theme);
- *
- * normalizeColorScheme('dark', 'light');      // 'dark'
- * normalizeColorScheme(null, 'dark');         // 'dark'
- * normalizeColorScheme(undefined, undefined); // 'light'
- * ```
- */
-export declare const normalizeColorScheme: (colorScheme?: string | null, theme?: string) => ThemeValue;
-/**
- * Gets the opposite theme value.
- *
- * @param theme - Current theme value
- * @returns The opposite theme ('light' → 'dark', 'dark' → 'light')
- *
- * @example
- * ```ts
- * getOppositeTheme('light'); // 'dark'
- * getOppositeTheme('dark');  // 'light'
- * ```
- */
-export declare const getOppositeTheme: (theme: ThemeValue) => ThemeValue;
-/**
- * Checks if the system prefers dark mode.
- *
- * This function only works in browser environments.
- * Returns false in non-browser environments (Node.js, React Native).
- *
- * @returns true if system prefers dark mode, false otherwise
- *
- * @example
- * ```ts
- * if (systemPrefersDarkMode()) {
- *   setTheme('dark');
- * }
- * ```
- */
-export declare const systemPrefersDarkMode: () => boolean;
-/**
- * Gets the system's preferred color scheme.
- *
- * @returns 'dark' if system prefers dark mode, 'light' otherwise
- *
- * @example
- * ```ts
- * const theme = getSystemColorScheme();
- * ```
- */
-export declare const getSystemColorScheme: () => ThemeValue;
-//# sourceMappingURL=themeUtils.d.ts.map

package/lib/typescript/module/shared/utils/themeUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"themeUtils.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/themeUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,UACE,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,GAAG,IAAI,EAC3B,QAAQ,MAAM,KACb,UAUF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,KAAG,UACf,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,QAAO,OAGxC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,QAAO,UACI,CAAC"}

package/lib/typescript/module/utils/apiUtils.d.ts

@@ -1,54 +0,0 @@
-/**
- * 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 declare function buildSearchParams(params: Record<string, any>): URLSearchParams;
-/**
- * Build URL with search parameters
- * @param baseUrl Base URL
- * @param params Object with parameter key-value pairs
- * @returns Complete URL with search parameters
- */
-export declare function buildUrl(baseUrl: string, params?: Record<string, any>): string;
-/**
- * Common pagination parameters
- */
-export interface PaginationParams {
-    limit?: number;
-    offset?: number;
-}
-/**
- * Build pagination search parameters
- * @param params Pagination parameters
- * @returns URLSearchParams with pagination
- */
-export declare function buildPaginationParams(params: PaginationParams): URLSearchParams;
-/**
- * Common API response wrapper
- */
-export interface ApiResponse<T = any> {
-    data: T;
-    message?: string;
-    success?: boolean;
-}
-/**
- * Common error response wrapper
- */
-export interface ErrorResponse {
-    message: string;
-    code: string;
-    status: number;
-    details?: any;
-}
-/**
- * Safe JSON parsing with error handling
- * @param data Data to parse
- * @param fallback Fallback value if parsing fails
- * @returns Parsed data or fallback
- */
-export declare function safeJsonParse<T>(data: any, fallback: T): T;
-//# sourceMappingURL=apiUtils.d.ts.map

package/lib/typescript/module/utils/apiUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/apiUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAE/E;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAS1D"}

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

@@ -1,59 +0,0 @@
-/**
- * Async utilities for common asynchronous patterns and error handling
- */
-/**
- * Wrapper for async operations with automatic error handling
- * Returns null on error instead of throwing
- */
-export declare function withErrorHandling<T>(operation: () => Promise<T>, errorHandler?: (error: any) => void, context?: string): Promise<T | null>;
-/**
- * Execute multiple async operations in parallel with error handling
- */
-export declare function parallelWithErrorHandling<T>(operations: (() => Promise<T>)[], errorHandler?: (error: any, index: number) => void): Promise<(T | 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 declare function retryAsync<T>(operation: () => Promise<T>, maxRetries?: number, baseDelay?: number, shouldRetry?: (error: any) => boolean): Promise<T>;
-/**
- * Debounce async function calls
- */
-export declare function debounceAsync<T extends (...args: any[]) => Promise<any>>(func: T, delay: number): (...args: Parameters<T>) => Promise<ReturnType<T>>;
-/**
- * Throttle async function calls
- */
-export declare function throttleAsync<T extends (...args: any[]) => Promise<any>>(func: T, limit: number, interval: number): (...args: Parameters<T>) => Promise<ReturnType<T>>;
-/**
- * Execute async operations sequentially with progress tracking
- */
-export declare function sequentialWithProgress<T>(operations: (() => Promise<T>)[], onProgress?: (completed: number, total: number) => void): Promise<T[]>;
-/**
- * Batch async operations
- */
-export declare function batchAsync<T>(items: T[], batchSize: number, processor: (batch: T[]) => Promise<void>): Promise<void>;
-/**
- * Create a cancellable async operation
- */
-export declare function createCancellableAsync<T>(operation: (signal: AbortSignal) => Promise<T>): {
-    execute: () => Promise<T>;
-    cancel: () => void;
-};
-/**
- * Timeout wrapper for async operations
- */
-export declare function withTimeout<T>(operation: Promise<T>, timeoutMs: number, timeoutMessage?: string): Promise<T>;
-/**
- * Execute async operation with loading state
- */
-export declare function withLoadingState<T>(operation: () => Promise<T>, setLoading: (loading: boolean) => void): Promise<T>;
-/**
- * Create a promise that resolves after a delay
- */
-export declare const delay: (ms: number) => Promise<void>;
-/**
- * Execute async operation with retry on specific errors
- */
-export declare function retryOnError<T>(operation: () => Promise<T>, retryableErrors: (string | number)[], maxRetries?: number): Promise<T>;
-//# sourceMappingURL=asyncUtils.d.ts.map

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

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