@revealui/core 0.0.1-pre.4 → 0.2.1

package/dist/error-handling/fallback-components.js

@@ -0,0 +1,371 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Fallback UI Components
+ *
+ * Reusable fallback components for error states, loading states, and degraded functionality
+ */
+/// <reference types="react" />
+import React from 'react';
+/**
+ * Generic error fallback component
+ */
+export function ErrorFallback({ error, onRetry, onDismiss, title = 'Something went wrong', message, showDetails = process.env.NODE_ENV === 'development', compact = false, }) {
+    if (compact) {
+        return (_jsxs("div", { style: {
+                padding: '12px',
+                backgroundColor: '#fee',
+                border: '1px solid #fcc',
+                borderRadius: '4px',
+                color: '#c00',
+            }, children: [_jsx("strong", { children: title }), message && _jsx("p", { style: { margin: '4px 0 0 0', fontSize: '14px' }, children: message }), onRetry && (_jsx("button", { type: "button", onClick: onRetry, style: {
+                        marginTop: '8px',
+                        padding: '4px 12px',
+                        fontSize: '12px',
+                        backgroundColor: '#c00',
+                        color: '#fff',
+                        border: 'none',
+                        borderRadius: '4px',
+                        cursor: 'pointer',
+                    }, children: "Retry" }))] }));
+    }
+    return (_jsxs("div", { role: "alert", style: {
+            padding: '24px',
+            maxWidth: '600px',
+            margin: '40px auto',
+            backgroundColor: '#fff',
+            border: '2px solid #f44336',
+            borderRadius: '8px',
+            boxShadow: '0 2px 8px rgba(0,0,0,0.1)',
+        }, children: [_jsx("h2", { style: { color: '#f44336', marginTop: 0 }, children: title }), _jsx("p", { style: { color: '#666', lineHeight: 1.6 }, children: message || 'An unexpected error occurred. Please try again.' }), showDetails && error && (_jsxs("details", { style: { marginTop: '16px' }, children: [_jsx("summary", { style: {
+                            cursor: 'pointer',
+                            fontWeight: 'bold',
+                            color: '#333',
+                            padding: '8px',
+                            backgroundColor: '#f5f5f5',
+                            borderRadius: '4px',
+                        }, children: "Error details" }), _jsxs("pre", { style: {
+                            marginTop: '8px',
+                            padding: '12px',
+                            backgroundColor: '#f5f5f5',
+                            borderRadius: '4px',
+                            overflow: 'auto',
+                            fontSize: '12px',
+                            color: '#c00',
+                        }, children: [error.name, ": ", error.message, error.stack && `\n\n${error.stack}`] })] })), _jsxs("div", { style: { marginTop: '24px', display: 'flex', gap: '12px' }, children: [onRetry && (_jsx("button", { type: "button", onClick: onRetry, style: {
+                            padding: '10px 20px',
+                            backgroundColor: '#2196f3',
+                            color: '#fff',
+                            border: 'none',
+                            borderRadius: '4px',
+                            cursor: 'pointer',
+                            fontWeight: 'bold',
+                        }, children: "Try Again" })), onDismiss && (_jsx("button", { type: "button", onClick: onDismiss, style: {
+                            padding: '10px 20px',
+                            backgroundColor: '#fff',
+                            color: '#666',
+                            border: '1px solid #ddd',
+                            borderRadius: '4px',
+                            cursor: 'pointer',
+                        }, children: "Dismiss" }))] })] }));
+}
+/**
+ * Network error fallback
+ */
+export function NetworkErrorFallback({ onRetry, message = 'Unable to connect to the server. Please check your internet connection.', }) {
+    return (_jsxs("div", { style: {
+            padding: '24px',
+            textAlign: 'center',
+            maxWidth: '400px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: { fontSize: '48px', marginBottom: '16px' }, children: "\uD83D\uDCE1" }), _jsx("h3", { style: { color: '#333', marginTop: 0 }, children: "Connection Error" }), _jsx("p", { style: { color: '#666', lineHeight: 1.6 }, children: message }), onRetry && (_jsx("button", { type: "button", onClick: onRetry, style: {
+                    marginTop: '16px',
+                    padding: '10px 20px',
+                    backgroundColor: '#2196f3',
+                    color: '#fff',
+                    border: 'none',
+                    borderRadius: '4px',
+                    cursor: 'pointer',
+                    fontWeight: 'bold',
+                }, children: "Retry Connection" }))] }));
+}
+/**
+ * Not found fallback
+ */
+export function NotFoundFallback({ title = 'Page Not Found', message = 'The page you are looking for does not exist.', onGoHome, }) {
+    return (_jsxs("div", { style: {
+            padding: '24px',
+            textAlign: 'center',
+            maxWidth: '400px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: { fontSize: '72px', marginBottom: '16px' }, children: "404" }), _jsx("h2", { style: { color: '#333', marginTop: 0 }, children: title }), _jsx("p", { style: { color: '#666', lineHeight: 1.6 }, children: message }), onGoHome && (_jsx("button", { type: "button", onClick: onGoHome, style: {
+                    marginTop: '16px',
+                    padding: '10px 20px',
+                    backgroundColor: '#2196f3',
+                    color: '#fff',
+                    border: 'none',
+                    borderRadius: '4px',
+                    cursor: 'pointer',
+                    fontWeight: 'bold',
+                }, children: "Go Home" }))] }));
+}
+/**
+ * Loading fallback with retry
+ */
+export function LoadingFallback({ message = 'Loading...', timeout, onTimeout, }) {
+    const [timedOut, setTimedOut] = React.useState(false);
+    React.useEffect(() => {
+        if (timeout && onTimeout) {
+            const timer = setTimeout(() => {
+                setTimedOut(true);
+                onTimeout();
+            }, timeout);
+            return () => clearTimeout(timer);
+        }
+        return undefined;
+    }, [timeout, onTimeout]);
+    if (timedOut) {
+        return (_jsx(ErrorFallback, { title: "Loading Timeout", message: "This is taking longer than expected.", onRetry: onTimeout }));
+    }
+    return (_jsxs("div", { style: {
+            padding: '24px',
+            textAlign: 'center',
+            maxWidth: '400px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: {
+                    width: '40px',
+                    height: '40px',
+                    margin: '0 auto 16px',
+                    border: '4px solid #f3f3f3',
+                    borderTop: '4px solid #2196f3',
+                    borderRadius: '50%',
+                    animation: 'spin 1s linear infinite',
+                } }), _jsx("p", { style: { color: '#666' }, children: message }), _jsx("style", { children: `
+          @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+          }
+        ` })] }));
+}
+/**
+ * Offline fallback
+ */
+export function OfflineFallback({ message = 'You are currently offline. Some features may be unavailable.', children, }) {
+    return (_jsxs("div", { children: [_jsxs("div", { style: {
+                    padding: '12px 16px',
+                    backgroundColor: '#fff3cd',
+                    borderBottom: '1px solid #ffc107',
+                    textAlign: 'center',
+                    color: '#856404',
+                }, children: [_jsx("strong", { children: "\u26A0\uFE0F Offline Mode" }), _jsx("span", { style: { marginLeft: '8px', fontSize: '14px' }, children: message })] }), children] }));
+}
+/**
+ * Degraded service fallback
+ */
+export function DegradedServiceFallback({ serviceName, message, children, }) {
+    const displayMessage = message ||
+        (serviceName
+            ? `${serviceName} is currently experiencing issues. Some features may be limited.`
+            : 'Some services are experiencing issues. Functionality may be limited.');
+    return (_jsxs("div", { children: [_jsxs("div", { style: {
+                    padding: '12px 16px',
+                    backgroundColor: '#fff3cd',
+                    borderBottom: '1px solid #ffc107',
+                    textAlign: 'center',
+                    color: '#856404',
+                }, children: [_jsx("strong", { children: "\u26A0\uFE0F Service Degraded" }), _jsx("span", { style: { marginLeft: '8px', fontSize: '14px' }, children: displayMessage })] }), children] }));
+}
+/**
+ * Maintenance fallback
+ */
+export function MaintenanceFallback({ title = 'Under Maintenance', message = 'We are currently performing maintenance. Please check back soon.', estimatedTime, }) {
+    return (_jsxs("div", { style: {
+            padding: '48px 24px',
+            textAlign: 'center',
+            maxWidth: '500px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: { fontSize: '64px', marginBottom: '24px' }, children: "\uD83D\uDD27" }), _jsx("h1", { style: { color: '#333', marginTop: 0 }, children: title }), _jsx("p", { style: { color: '#666', lineHeight: 1.6, fontSize: '16px' }, children: message }), estimatedTime && (_jsxs("p", { style: { color: '#999', marginTop: '16px' }, children: ["Estimated completion: ", estimatedTime] }))] }));
+}
+/**
+ * Permission denied fallback
+ */
+export function PermissionDeniedFallback({ message = 'You do not have permission to access this resource.', onRequestAccess, onGoBack, }) {
+    return (_jsxs("div", { style: {
+            padding: '24px',
+            textAlign: 'center',
+            maxWidth: '400px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: { fontSize: '64px', marginBottom: '16px' }, children: "\uD83D\uDD12" }), _jsx("h2", { style: { color: '#333', marginTop: 0 }, children: "Access Denied" }), _jsx("p", { style: { color: '#666', lineHeight: 1.6 }, children: message }), _jsxs("div", { style: { marginTop: '24px', display: 'flex', gap: '12px', justifyContent: 'center' }, children: [onRequestAccess && (_jsx("button", { type: "button", onClick: onRequestAccess, style: {
+                            padding: '10px 20px',
+                            backgroundColor: '#2196f3',
+                            color: '#fff',
+                            border: 'none',
+                            borderRadius: '4px',
+                            cursor: 'pointer',
+                            fontWeight: 'bold',
+                        }, children: "Request Access" })), onGoBack && (_jsx("button", { type: "button", onClick: onGoBack, style: {
+                            padding: '10px 20px',
+                            backgroundColor: '#fff',
+                            color: '#666',
+                            border: '1px solid #ddd',
+                            borderRadius: '4px',
+                            cursor: 'pointer',
+                        }, children: "Go Back" }))] })] }));
+}
+/**
+ * Retry boundary - wrapper that provides retry functionality
+ */
+export function RetryBoundary({ children, fallback, maxRetries = 3, retryDelay = 1000, }) {
+    const [error, setError] = React.useState(null);
+    const [retryCount, setRetryCount] = React.useState(0);
+    const [isRetrying, setIsRetrying] = React.useState(false);
+    const retry = React.useCallback(() => {
+        if (retryCount < maxRetries) {
+            setIsRetrying(true);
+            setTimeout(() => {
+                setError(null);
+                setRetryCount((c) => c + 1);
+                setIsRetrying(false);
+            }, retryDelay);
+        }
+    }, [retryCount, maxRetries, retryDelay]);
+    if (error && !isRetrying) {
+        if (fallback) {
+            return _jsx(_Fragment, { children: fallback(error, retry, retryCount) });
+        }
+        return (_jsx(ErrorFallback, { error: error, onRetry: retryCount < maxRetries ? retry : undefined, title: retryCount >= maxRetries ? 'Maximum Retries Exceeded' : 'Error', message: retryCount >= maxRetries ? 'Unable to recover after multiple attempts.' : undefined }));
+    }
+    if (isRetrying) {
+        return _jsx(LoadingFallback, { message: `Retrying... (Attempt ${retryCount + 1}/${maxRetries})` });
+    }
+    return _jsx(_Fragment, { children: children });
+}
+/**
+ * Suspense fallback with timeout
+ */
+export function SuspenseFallback({ message = 'Loading...', timeout = 10000, }) {
+    const [timedOut, setTimedOut] = React.useState(false);
+    React.useEffect(() => {
+        const timer = setTimeout(() => {
+            setTimedOut(true);
+        }, timeout);
+        return () => clearTimeout(timer);
+    }, [timeout]);
+    if (timedOut) {
+        return (_jsx(ErrorFallback, { title: "Loading Timeout", message: "This is taking longer than expected. Please refresh the page." }));
+    }
+    return _jsx(LoadingFallback, { message: message });
+}
+/**
+ * Feature flag fallback
+ */
+export function FeatureUnavailableFallback({ featureName, message, }) {
+    return (_jsxs("div", { style: {
+            padding: '24px',
+            textAlign: 'center',
+            maxWidth: '400px',
+            margin: '40px auto',
+        }, children: [_jsx("div", { style: { fontSize: '48px', marginBottom: '16px' }, children: "\uD83D\uDEA7" }), _jsx("h3", { style: { color: '#333', marginTop: 0 }, children: "Feature Unavailable" }), _jsx("p", { style: { color: '#666', lineHeight: 1.6 }, children: message || `The "${featureName}" feature is currently unavailable.` })] }));
+}
+/**
+ * Inline error message
+ */
+export function InlineError({ message, onDismiss, }) {
+    return (_jsxs("div", { role: "alert", style: {
+            padding: '12px 16px',
+            backgroundColor: '#fee',
+            border: '1px solid #fcc',
+            borderRadius: '4px',
+            color: '#c00',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'space-between',
+        }, children: [_jsxs("span", { style: { display: 'flex', alignItems: 'center' }, children: [_jsx("span", { style: { marginRight: '8px' }, children: "\u26A0\uFE0F" }), message] }), onDismiss && (_jsx("button", { type: "button", onClick: onDismiss, style: {
+                    background: 'none',
+                    border: 'none',
+                    color: '#c00',
+                    cursor: 'pointer',
+                    fontSize: '18px',
+                    padding: '0 4px',
+                }, "aria-label": "Dismiss", children: "\u00D7" }))] }));
+}
+/**
+ * Success message
+ */
+export function SuccessMessage({ message, onDismiss, }) {
+    return (_jsxs("output", { style: {
+            padding: '12px 16px',
+            backgroundColor: '#efe',
+            border: '1px solid #cec',
+            borderRadius: '4px',
+            color: '#060',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'space-between',
+        }, children: [_jsxs("span", { style: { display: 'flex', alignItems: 'center' }, children: [_jsx("span", { style: { marginRight: '8px' }, children: "\u2713" }), message] }), onDismiss && (_jsx("button", { type: "button", onClick: onDismiss, style: {
+                    background: 'none',
+                    border: 'none',
+                    color: '#060',
+                    cursor: 'pointer',
+                    fontSize: '18px',
+                    padding: '0 4px',
+                }, "aria-label": "Dismiss", children: "\u00D7" }))] }));
+}
+/**
+ * Toast notification
+ */
+export function Toast({ type = 'info', message, duration = 5000, onDismiss, }) {
+    React.useEffect(() => {
+        if (duration > 0 && onDismiss) {
+            const timer = setTimeout(onDismiss, duration);
+            return () => clearTimeout(timer);
+        }
+        return undefined;
+    }, [duration, onDismiss]);
+    const colors = {
+        success: { bg: '#efe', border: '#cec', text: '#060', icon: '✓' },
+        error: { bg: '#fee', border: '#fcc', text: '#c00', icon: '✗' },
+        warning: { bg: '#fff3cd', border: '#ffc107', text: '#856404', icon: '!' },
+        info: { bg: '#e7f3ff', border: '#2196f3', text: '#0c5393', icon: 'i' },
+    };
+    const color = colors[type];
+    return (_jsxs("div", { style: {
+            position: 'fixed',
+            bottom: '20px',
+            right: '20px',
+            padding: '16px 20px',
+            backgroundColor: color.bg,
+            border: `1px solid ${color.border}`,
+            borderRadius: '4px',
+            color: color.text,
+            boxShadow: '0 4px 12px rgba(0,0,0,0.15)',
+            display: 'flex',
+            alignItems: 'center',
+            gap: '12px',
+            maxWidth: '400px',
+            zIndex: 9999,
+        }, children: [_jsx("span", { style: { fontSize: '20px' }, children: color.icon }), _jsx("span", { style: { flex: 1 }, children: message }), onDismiss && (_jsx("button", { type: "button", onClick: onDismiss, style: {
+                    background: 'none',
+                    border: 'none',
+                    color: color.text,
+                    cursor: 'pointer',
+                    fontSize: '20px',
+                    padding: '0 4px',
+                }, "aria-label": "Dismiss", children: "\u00D7" }))] }));
+}
+/**
+ * Skeleton loader
+ */
+export function Skeleton({ width = '100%', height = '20px', borderRadius = '4px', }) {
+    return (_jsx("div", { style: {
+            width,
+            height,
+            borderRadius,
+            backgroundColor: '#e0e0e0',
+            animation: 'pulse 1.5s ease-in-out infinite',
+        }, children: _jsx("style", { children: `
+          @keyframes pulse {
+            0%, 100% { opacity: 1; }
+            50% { opacity: 0.5; }
+          }
+        ` }) }));
+}

package/dist/error-handling/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error Handling & Recovery
+ *
+ * Comprehensive error handling infrastructure for production applications
+ */
+export type { CircuitBreakerConfig, CircuitBreakerStats, CircuitState, } from './circuit-breaker';
+export { AdaptiveCircuitBreaker, Bulkhead, CircuitBreak, CircuitBreaker, CircuitBreakerOpenError, CircuitBreakerRegistry, circuitBreakerRegistry, createCircuitBreakerMiddleware, createResilientFunction, fetchWithCircuitBreaker, ResilientOperation, withCircuitBreaker, } from './circuit-breaker';
+export type { ErrorBoundaryProps, ErrorBoundaryState, ErrorBoundaryWithRetryProps, ErrorInfo, ErrorSeverity, } from './error-boundary';
+export { AuthenticationError, ErrorBoundary, ErrorBoundaryWithRetry, getErrorSeverity, isAuthenticationError, isNetworkError, isNotFoundError, isValidationError, NetworkError, NotFoundError, shouldRetryError, useErrorHandler, ValidationError, withErrorBoundary, } from './error-boundary';
+export type { Breadcrumb, ErrorContext, ErrorLevel, ErrorReport, ErrorReporter, UserContext, } from './error-reporter';
+export { ConsoleErrorReporter, ErrorFilters, ErrorReportingSystem, errorReporter, HTTPErrorReporter, initializeErrorReporting, LoggingErrorReporter, trackAction, trackAPICall, trackNavigation, } from './error-reporter';
+export type { ErrorFallbackProps } from './fallback-components';
+export { DegradedServiceFallback, ErrorFallback, FeatureUnavailableFallback, InlineError, LoadingFallback, MaintenanceFallback, NetworkErrorFallback, NotFoundFallback, OfflineFallback, PermissionDeniedFallback, RetryBoundary, Skeleton, SuccessMessage, SuspenseFallback, Toast, } from './fallback-components';
+export type { RetryConfig, RetryOptions } from './retry';
+export { calculateDelay, createRetryMiddleware, ExponentialBackoff, fetchWithRetry, globalRetryConfig, Retryable, RetryableOperation, RetryPolicies, RetryPolicyBuilder, retry, retryBatch, retryIf, retryUntil, retryWithFallback, sleep, } from './retry';
+//# sourceMappingURL=index.d.ts.map

package/dist/error-handling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error-handling/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,sBAAsB,EACtB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,SAAS,EACT,aAAa,GACd,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE/D,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,KAAK,GACN,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAExD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,KAAK,EACL,UAAU,EACV,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,KAAK,GACN,MAAM,SAAS,CAAA"}

package/dist/error-handling/index.js

@@ -0,0 +1,15 @@
+/**
+ * Error Handling & Recovery
+ *
+ * Comprehensive error handling infrastructure for production applications
+ */
+// Circuit breakers
+export { AdaptiveCircuitBreaker, Bulkhead, CircuitBreak, CircuitBreaker, CircuitBreakerOpenError, CircuitBreakerRegistry, circuitBreakerRegistry, createCircuitBreakerMiddleware, createResilientFunction, fetchWithCircuitBreaker, ResilientOperation, withCircuitBreaker, } from './circuit-breaker';
+// Error boundaries
+export { AuthenticationError, ErrorBoundary, ErrorBoundaryWithRetry, getErrorSeverity, isAuthenticationError, isNetworkError, isNotFoundError, isValidationError, NetworkError, NotFoundError, shouldRetryError, useErrorHandler, ValidationError, withErrorBoundary, } from './error-boundary';
+// Error reporting
+export { ConsoleErrorReporter, ErrorFilters, ErrorReportingSystem, errorReporter, HTTPErrorReporter, initializeErrorReporting, LoggingErrorReporter, trackAction, trackAPICall, trackNavigation, } from './error-reporter';
+// Fallback components
+export { DegradedServiceFallback, ErrorFallback, FeatureUnavailableFallback, InlineError, LoadingFallback, MaintenanceFallback, NetworkErrorFallback, NotFoundFallback, OfflineFallback, PermissionDeniedFallback, RetryBoundary, Skeleton, SuccessMessage, SuspenseFallback, Toast, } from './fallback-components';
+// Retry logic
+export { calculateDelay, createRetryMiddleware, ExponentialBackoff, fetchWithRetry, globalRetryConfig, Retryable, RetryableOperation, RetryPolicies, RetryPolicyBuilder, retry, retryBatch, retryIf, retryUntil, retryWithFallback, sleep, } from './retry';

package/dist/error-handling/retry.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Retry Logic for API Calls
+ *
+ * Implements exponential backoff and retry strategies
+ */
+export interface HttpError extends Error {
+    statusCode?: number;
+    response?: Response;
+}
+export interface RetryConfig {
+    maxRetries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    exponentialBackoff?: boolean;
+    jitter?: boolean;
+    retryableErrors?: (error: Error) => boolean;
+    onRetry?: (error: Error, attempt: number) => void;
+}
+export interface RetryOptions {
+    signal?: AbortSignal;
+}
+/**
+ * Retry a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, config?: RetryConfig, options?: RetryOptions): Promise<T>;
+/**
+ * Calculate retry delay with exponential backoff
+ */
+export declare function calculateDelay(attempt: number, baseDelay: number, maxDelay: number, exponentialBackoff: boolean, jitter: boolean): number;
+/**
+ * Sleep with abort support
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Retry wrapper for fetch
+ */
+export declare function fetchWithRetry(url: string, init?: RequestInit, config?: RetryConfig): Promise<Response>;
+/**
+ * Retry wrapper class
+ */
+export declare class RetryableOperation<T> {
+    private fn;
+    private config;
+    private abortController;
+    private attempts;
+    private lastError?;
+    constructor(fn: () => Promise<T>, config?: RetryConfig);
+    /**
+     * Execute with retry
+     */
+    execute(): Promise<T>;
+    /**
+     * Abort operation
+     */
+    abort(): void;
+    /**
+     * Get retry statistics
+     */
+    getStats(): {
+        attempts: number;
+        lastError?: Error;
+    };
+}
+/**
+ * Retry decorator
+ */
+export declare function Retryable(config?: RetryConfig): (_target: object, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Create retry middleware for API client
+ */
+export declare function createRetryMiddleware<TRequest = unknown, TResponse = unknown>(config?: RetryConfig): (_request: TRequest, next: () => Promise<TResponse>) => Promise<TResponse>;
+/**
+ * Batch retry - retry multiple operations
+ */
+export declare function retryBatch<T>(operations: Array<() => Promise<T>>, config?: RetryConfig): Promise<Array<T | Error>>;
+/**
+ * Retry with fallback
+ */
+export declare function retryWithFallback<T>(primary: () => Promise<T>, fallback: () => Promise<T>, config?: RetryConfig): Promise<T>;
+/**
+ * Conditional retry - only retry if condition is met
+ */
+export declare function retryIf<T>(fn: () => Promise<T>, condition: (error: Error, attempt: number) => boolean, config?: RetryConfig): Promise<T>;
+/**
+ * Retry until condition is met
+ */
+export declare function retryUntil<T>(fn: () => Promise<T>, predicate: (result: T) => boolean, config?: RetryConfig, maxAttempts?: number): Promise<T>;
+/**
+ * Exponential backoff iterator
+ */
+export declare class ExponentialBackoff implements AsyncIterable<number> {
+    private baseDelay;
+    private maxDelay;
+    private maxAttempts;
+    private jitter;
+    constructor(baseDelay?: number, maxDelay?: number, maxAttempts?: number, jitter?: boolean);
+    [Symbol.asyncIterator](): AsyncIterator<number>;
+}
+/**
+ * Retry policy builder
+ */
+export declare class RetryPolicyBuilder {
+    private config;
+    /**
+     * Set max retries
+     */
+    maxRetries(count: number): this;
+    /**
+     * Set base delay
+     */
+    baseDelay(ms: number): this;
+    /**
+     * Set max delay
+     */
+    maxDelay(ms: number): this;
+    /**
+     * Enable/disable exponential backoff
+     */
+    exponentialBackoff(enabled?: boolean): this;
+    /**
+     * Enable/disable jitter
+     */
+    jitter(enabled?: boolean): this;
+    /**
+     * Set custom retryable errors function
+     */
+    retryOn(fn: (error: Error) => boolean): this;
+    /**
+     * Set retry callback
+     */
+    onRetry(fn: (error: Error, attempt: number) => void): this;
+    /**
+     * Build retry config
+     */
+    build(): RetryConfig;
+    /**
+     * Execute function with built policy
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+}
+/**
+ * Common retry policies
+ */
+export declare const RetryPolicies: {
+    /**
+     * Default policy - 3 retries with exponential backoff
+     */
+    default: () => RetryConfig;
+    /**
+     * Aggressive policy - more retries, faster backoff
+     */
+    aggressive: () => RetryConfig;
+    /**
+     * Conservative policy - fewer retries, longer backoff
+     */
+    conservative: () => RetryConfig;
+    /**
+     * Linear backoff policy
+     */
+    linear: () => RetryConfig;
+    /**
+     * Immediate retry policy - no delay
+     */
+    immediate: () => RetryConfig;
+    /**
+     * Network error only policy
+     */
+    networkOnly: () => RetryConfig;
+    /**
+     * Idempotent operations policy (safe to retry)
+     */
+    idempotent: () => RetryConfig;
+};
+/**
+ * Global retry configuration
+ */
+declare class GlobalRetryConfig {
+    private config;
+    /**
+     * Set global retry config
+     */
+    setConfig(config: RetryConfig): void;
+    /**
+     * Get global retry config
+     */
+    getConfig(): RetryConfig;
+    /**
+     * Reset to default config
+     */
+    reset(): void;
+}
+export declare const globalRetryConfig: GlobalRetryConfig;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/error-handling/retry.d.ts.map

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