@juspay/neurolink 9.1.1 → 9.2.0

package/dist/processors/registry/types.js

@@ -0,0 +1,10 @@
+/**
+ * Processor Registry Type Definitions
+ *
+ * Contains only types unique to the registry module.
+ * All shared types (ProcessorMatch, RegistryOptions, etc.) are defined
+ * in the single source of truth: processors/base/types.ts
+ *
+ * @module processors/registry/types
+ */
+export {};

package/dist/server/utils/validation.d.ts

@@ -38,11 +38,11 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     provider?: string | undefined;
     model?: string | undefined;
     userId?: string | undefined;
+    stream?: boolean | undefined;
     tools?: string[] | undefined;
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    stream?: boolean | undefined;
     systemPrompt?: string | undefined;
 }, {
     input: string | {
@@ -53,11 +53,11 @@ export declare const AgentExecuteRequestSchema: z.ZodObject<{
     provider?: string | undefined;
     model?: string | undefined;
     userId?: string | undefined;
+    stream?: boolean | undefined;
     tools?: string[] | undefined;
     sessionId?: string | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
-    stream?: boolean | undefined;
     systemPrompt?: string | undefined;
 }>;
 /**
@@ -148,12 +148,12 @@ export declare const SessionsListQuerySchema: z.ZodObject<{
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     userId?: string | undefined;
-    limit?: number | undefined;
     offset?: number | undefined;
+    limit?: number | undefined;
 }, {
     userId?: string | undefined;
-    limit?: string | undefined;
     offset?: string | undefined;
+    limit?: string | undefined;
 }>;
 /**
  * Session messages query schema (for pagination)
@@ -162,11 +162,11 @@ export declare const SessionMessagesQuerySchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
     offset: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    limit?: number | undefined;
     offset?: number | undefined;
+    limit?: number | undefined;
 }, {
-    limit?: string | undefined;
     offset?: string | undefined;
+    limit?: string | undefined;
 }>;
 /**
  * Standardized error response format

package/dist/types/fileTypes.d.ts

@@ -4,7 +4,7 @@
 /**
  * Supported file types for multimodal input
  */
-export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "docx" | "pptx" | "xlsx" | "unknown";
+export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "svg" | "docx" | "pptx" | "xlsx" | "unknown";
 /**
  * Office document types
  */

package/dist/types/index.d.ts

@@ -1,34 +1,35 @@
 /**
  * Centralized type exports for NeuroLink
  */
-export * from "./common.js";
 export { AIProviderName } from "../constants/enums.js";
-export type { ZodUnknownSchema, ValidationSchema, OptionalValidationSchema, StandardRecord, OptionalStandardRecord, } from "./typeAliases.js";
-export * from "./tools.js";
-export * from "./providers.js";
 export * from "./cli.js";
+export * from "./common.js";
+export type { AnalyticsConfig, BackupInfo, BackupMetadata, CacheConfig, ConfigUpdateOptions, ConfigValidationResult, FallbackConfig, NeuroLinkConfig, PerformanceConfig, RetryConfig, ToolConfig, } from "./configTypes.js";
+export type { ExternalMCPConfigValidation, ExternalMCPManagerConfig, ExternalMCPOperationResult, ExternalMCPServerEvents, ExternalMCPServerHealth, ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolContext, ExternalMCPToolInfo, ExternalMCPToolResult, } from "./externalMcp.js";
+export type { AuthorizationUrlResult, CircuitBreakerConfig, CircuitBreakerEvents, CircuitBreakerState, CircuitBreakerStats, DiscoveredMcp, ExternalToolExecutionOptions, FlexibleValidationResult, HTTPRetryConfig, MCPClientResult, MCPConnectedServer, MCPDiscoveredServer, MCPExecutableTool, MCPOAuthConfig, MCPServerCategory, MCPServerConfig, MCPServerConnectionStatus, MCPServerMetadata, MCPServerRegistryEntry, MCPServerStatus, MCPToolInfo, MCPToolMetadata, MCPTransportType, McpMetadata, McpRegistry, NeuroLinkExecutionContext, NeuroLinkMCPServer, NeuroLinkMCPTool, OAuthClientInformation, OAuthTokens, RateLimitConfig, TokenBucketRateLimitConfig, TokenExchangeRequest, TokenStorage, ToolDiscoveryResult, ToolRegistryEvents, ToolValidationResult, } from "./mcpTypes.js";
+export type { ModelCapability, ModelFilter, ModelPricing, ModelResolutionContext, ModelStats, ModelUseCase, } from "./providers.js";
+export * from "./providers.js";
 export * from "./taskClassificationTypes.js";
-export type { NeuroLinkConfig, PerformanceConfig, CacheConfig, FallbackConfig, RetryConfig, AnalyticsConfig, ToolConfig, BackupInfo, BackupMetadata, ConfigValidationResult, ConfigUpdateOptions, } from "./configTypes.js";
-export type { MCPTransportType, MCPServerConnectionStatus, MCPServerCategory, MCPServerStatus, MCPDiscoveredServer, MCPConnectedServer, MCPToolInfo, MCPExecutableTool, MCPServerMetadata, MCPToolMetadata, MCPServerRegistryEntry, NeuroLinkMCPTool, NeuroLinkMCPServer, NeuroLinkExecutionContext, MCPServerConfig, DiscoveredMcp, McpMetadata, ToolDiscoveryResult, ExternalToolExecutionOptions, ToolValidationResult, ToolRegistryEvents, CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvents, McpRegistry, MCPClientResult, FlexibleValidationResult, OAuthTokens, TokenStorage, MCPOAuthConfig, OAuthClientInformation, AuthorizationUrlResult, TokenExchangeRequest, TokenBucketRateLimitConfig, RateLimitConfig, HTTPRetryConfig, } from "./mcpTypes.js";
-export type { ExternalMCPServerInstance, ExternalMCPServerStatus, ExternalMCPToolInfo, ExternalMCPServerHealth, ExternalMCPConfigValidation, ExternalMCPOperationResult, ExternalMCPToolContext, ExternalMCPToolResult, ExternalMCPServerEvents, ExternalMCPManagerConfig, } from "./externalMcp.js";
-export type { ModelCapability, ModelUseCase, ModelFilter, ModelResolutionContext, ModelStats, ModelPricing, } from "./providers.js";
-export type { DomainType, DomainConfig, DomainTemplate, DomainConfigOptions, DomainEvaluationCriteria, DomainValidationRule, } from "./domainTypes.js";
-export type { GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
-UnifiedGenerationOptions, EnhancedProvider, FactoryEnhancedProvider, TextGenerationOptions, TextGenerationResult, EnhancedGenerateResult, } from "./generateTypes.js";
-export type { StreamingProgressData, StreamingMetadata, ProgressCallback, ToolCall as StreamToolCall, // Renamed to avoid conflict with tools.js ToolCall
-ToolResult as StreamToolResult, // Renamed to avoid conflict with tools.js ToolResult
-ToolCallResults, ToolCalls, StreamOptions, StreamingOptions, StreamResult, EnhancedStreamProvider, } from "./streamTypes.js";
-export type { TokenUsage, ErrorInfo as AnalyticsErrorInfo, // Renamed to avoid conflict with common.js ErrorInfo
-AnalyticsData, StreamAnalyticsData, PerformanceMetrics, } from "./analytics.js";
+export * from "./tools.js";
+export type { OptionalStandardRecord, OptionalValidationSchema, StandardRecord, ValidationSchema, ZodUnknownSchema, } from "./typeAliases.js";
+export type { BatchProcessingSummary, ExcelWorksheet, FailedFileInfo, FileInfo, FileProcessingError, FileProcessingResult as ProcessorFileResult, FileProcessorConfig, FileWarning, JsonTypeGuard, OperationResult, ProcessedConfig, ProcessedExcel, ProcessedFileBase, ProcessedFileInfo, ProcessedHtml, ProcessedJson, ProcessedMarkdown, ProcessedOpenDocument, ProcessedRtf, ProcessedSourceCode, ProcessedSvg, ProcessedText, ProcessedWord, ProcessedYaml, ProcessOptions, ProcessorInfo, ProcessorMatch, ProcessorPriorityKey, ProcessorPriorityValue, RegistryOptions, RegistryProcessResult, RetryConfig as ProcessorRetryConfig, SkippedFileInfo, UnsupportedFileError, } from "../processors/base/types.js";
+export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
+export type { ActionAWSConfig, ActionCommentResult, ActionEvaluation, ActionExecutionResult, ActionGoogleCloudConfig, ActionInputs, ActionInputValidation, ActionMultimodalInputs, ActionOutput, ActionProviderKeys, ActionThinkingConfig, ActionTokenUsage, CliAnalytics, CliEvaluation, CliResponse, CliTokenUsage, ProviderKeyMapping, } from "./actionTypes.js";
+export type { AnalyticsData, ErrorInfo as AnalyticsErrorInfo, // Renamed to avoid conflict with common.js ErrorInfo
+PerformanceMetrics, StreamAnalyticsData, TokenUsage, } from "./analytics.js";
+export * from "./content.js";
+export type { DomainConfig, DomainConfigOptions, DomainEvaluationCriteria, DomainTemplate, DomainType, DomainValidationRule, } from "./domainTypes.js";
 export * from "./evaluation.js";
-export * from "./modelTypes.js";
-export * from "./serviceTypes.js";
 export * from "./evaluationProviders.js";
-export * from "./sdkTypes.js";
-export * from "./utilities.js";
-export * from "./middlewareTypes.js";
 export * from "./fileTypes.js";
-export * from "./content.js";
-export * from "./ttsTypes.js";
+export type { EnhancedGenerateResult, EnhancedProvider, FactoryEnhancedProvider, GenerateOptions, GenerateResult as GenerateApiResult, // Renamed to avoid conflict with cli.js GenerateResult
+TextGenerationOptions, TextGenerationResult, UnifiedGenerationOptions, } from "./generateTypes.js";
 export * from "./hitlTypes.js";
-export type { ActionInputs, ActionProviderKeys, ActionAWSConfig, ActionGoogleCloudConfig, ActionThinkingConfig, ActionMultimodalInputs, ActionExecutionResult, ActionCommentResult, ActionOutput, ActionTokenUsage, ActionEvaluation, ActionInputValidation, ProviderKeyMapping, CliResponse, CliTokenUsage, CliAnalytics, CliEvaluation, } from "./actionTypes.js";
+export * from "./middlewareTypes.js";
+export * from "./modelTypes.js";
+export * from "./sdkTypes.js";
+export * from "./serviceTypes.js";
+export type { EnhancedStreamProvider, ProgressCallback, StreamingMetadata, StreamingOptions, StreamingProgressData, StreamOptions, StreamResult, ToolCall as StreamToolCall, // Renamed to avoid conflict with tools.js ToolCall
+ToolCallResults, ToolCalls, ToolResult as StreamToolResult, } from "./streamTypes.js";
+export * from "./ttsTypes.js";
+export * from "./utilities.js";

package/dist/types/index.js

@@ -1,39 +1,40 @@
 /**
  * Centralized type exports for NeuroLink
  */
-// Common utility types
-export * from "./common.js";
 // Constants and enums
 export { AIProviderName } from "../constants/enums.js";
-// Tool system types
-export * from "./tools.js";
-// Provider types
-export * from "./providers.js";
 // CLI types
 export * from "./cli.js";
+// Common utility types
+export * from "./common.js";
+// Provider types
+export * from "./providers.js";
 // Task classification types
 export * from "./taskClassificationTypes.js";
+// Tool system types
+export * from "./tools.js";
+export { PROCESSOR_PRIORITIES } from "../processors/base/types.js";
+// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
+export * from "./content.js";
 // Evaluation types - NEW
 export * from "./evaluation.js";
-// Model types - NEW
-export * from "./modelTypes.js";
-// Service types - NEW
-export * from "./serviceTypes.js";
 // Evaluation provider types - NEW
 export * from "./evaluationProviders.js";
+// File detection and processing types
+export * from "./fileTypes.js";
+// HITL (Human-in-the-Loop) types
+export * from "./hitlTypes.js";
+// Middleware Types - Middleware system types
+export * from "./middlewareTypes.js";
+// Model types - NEW
+export * from "./modelTypes.js";
 // SDK Types - Core types for external developers
 // Note: sdkTypes.ts uses selective re-exports internally, so we use wildcard here
 // The conflicts were from generateTypes and analytics which are now handled above
 export * from "./sdkTypes.js";
-// Utilities Types - Utility module types (selective export to avoid conflicts)
-export * from "./utilities.js";
-// Middleware Types - Middleware system types
-export * from "./middlewareTypes.js";
-// File detection and processing types
-export * from "./fileTypes.js";
-// Content types for multimodal support (includes multimodal re-exports for backward compatibility)
-export * from "./content.js";
+// Service types - NEW
+export * from "./serviceTypes.js";
 // TTS (Text-to-Speech) types
 export * from "./ttsTypes.js";
-// HITL (Human-in-the-Loop) types
-export * from "./hitlTypes.js";
+// Utilities Types - Utility module types (selective export to avoid conflicts)
+export * from "./utilities.js";

package/dist/types/modelTypes.d.ts

@@ -79,11 +79,11 @@ export declare const ModelConfigSchema: z.ZodObject<{
         input: z.ZodNumber;
         output: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        input: number;
         output: number;
-    }, {
         input: number;
+    }, {
         output: number;
+        input: number;
     }>;
     contextWindow: z.ZodNumber;
     releaseDate: z.ZodString;
@@ -93,8 +93,8 @@ export declare const ModelConfigSchema: z.ZodObject<{
     displayName: string;
     deprecated: boolean;
     pricing: {
-        input: number;
         output: number;
+        input: number;
     };
     contextWindow: number;
     releaseDate: string;
@@ -104,8 +104,8 @@ export declare const ModelConfigSchema: z.ZodObject<{
     displayName: string;
     deprecated: boolean;
     pricing: {
-        input: number;
         output: number;
+        input: number;
     };
     contextWindow: number;
     releaseDate: string;
@@ -125,11 +125,11 @@ export declare const ModelRegistrySchema: z.ZodObject<{
             input: z.ZodNumber;
             output: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            input: number;
             output: number;
-        }, {
             input: number;
+        }, {
             output: number;
+            input: number;
         }>;
         contextWindow: z.ZodNumber;
         releaseDate: z.ZodString;
@@ -139,8 +139,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         displayName: string;
         deprecated: boolean;
         pricing: {
-            input: number;
             output: number;
+            input: number;
         };
         contextWindow: number;
         releaseDate: string;
@@ -150,8 +150,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         displayName: string;
         deprecated: boolean;
         pricing: {
-            input: number;
             output: number;
+            input: number;
         };
         contextWindow: number;
         releaseDate: string;
@@ -167,8 +167,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         displayName: string;
         deprecated: boolean;
         pricing: {
-            input: number;
             output: number;
+            input: number;
         };
         contextWindow: number;
         releaseDate: string;
@@ -184,8 +184,8 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         displayName: string;
         deprecated: boolean;
         pricing: {
-            input: number;
             output: number;
+            input: number;
         };
         contextWindow: number;
         releaseDate: string;

package/dist/types/pptTypes.d.ts

@@ -10,10 +10,10 @@
  * - CompleteSlide / PPTGenerationContext: Generation context types
  * - PPTError: Error handling (follows VideoError pattern)
  */
-import type { ImageWithAltText } from "./content.js";
+import type { NeuroLink } from "../neurolink.js";
 import { NeuroLinkError } from "../utils/errorHandling.js";
+import type { ImageWithAltText } from "./content.js";
 import type { AIProvider } from "./providers.js";
-import type { NeuroLink } from "../neurolink.js";
 export type ThemeOption = "modern" | "corporate" | "creative" | "minimal" | "dark";
 export type AudienceOption = "business" | "students" | "technical" | "general";
 export type ToneOption = "professional" | "casual" | "educational" | "persuasive";
@@ -681,11 +681,23 @@ export type CompleteSlide = {
     };
     generationTime: number;
 };
+/** Minimum number of slides allowed */
+export declare const MIN_SLIDES = 5;
+/** Maximum number of slides allowed */
+export declare const MAX_SLIDES = 50;
 /** Slide dimensions in inches by aspect ratio */
 export declare const SLIDE_DIMENSIONS: Record<AspectRatioOption, {
     width: number;
     height: number;
 }>;
+/**
+ * Validate a hex color string (6 hex characters, no # prefix).
+ */
+export declare function isValidHexColor(color: string): boolean;
+/**
+ * Normalize a hex color by stripping leading # if present.
+ */
+export declare function normalizeHexColor(color: string): string;
 /**
  * Text properties for addText method
  * Represents individual text items with formatting options

package/dist/types/pptTypes.js

@@ -59,8 +59,24 @@ export class PPTError extends NeuroLinkError {
 // ============================================================================
 // VALIDATION CONSTANTS
 // ============================================================================
+/** Minimum number of slides allowed */
+export const MIN_SLIDES = 5;
+/** Maximum number of slides allowed */
+export const MAX_SLIDES = 50;
 /** Slide dimensions in inches by aspect ratio */
 export const SLIDE_DIMENSIONS = {
     "16:9": { width: 10, height: 5.625 },
     "4:3": { width: 10, height: 7.5 },
 };
+/**
+ * Validate a hex color string (6 hex characters, no # prefix).
+ */
+export function isValidHexColor(color) {
+    return /^[0-9A-Fa-f]{6}$/.test(color);
+}
+/**
+ * Normalize a hex color by stripping leading # if present.
+ */
+export function normalizeHexColor(color) {
+    return color.startsWith("#") ? color.slice(1) : color;
+}

package/dist/utils/async/delay.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Delay Utilities
+ *
+ * Promise-based delay/sleep functions for async flow control.
+ */
+/**
+ * Delay execution for a specified number of milliseconds.
+ *
+ * This is the canonical implementation for promise-based delays.
+ *
+ * @param ms - Duration to wait in milliseconds
+ * @returns Promise that resolves after the specified delay
+ *
+ * @example
+ * ```typescript
+ * await delay(1000); // Wait 1 second
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use in a loop for polling
+ * while (condition) {
+ *   await checkStatus();
+ *   await delay(500);
+ * }
+ * ```
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Alias for delay - provided for code clarity in sleep-like contexts.
+ *
+ * @param ms - Duration to sleep in milliseconds
+ * @returns Promise that resolves after the specified duration
+ *
+ * @example
+ * ```typescript
+ * await sleep(2000); // Sleep for 2 seconds
+ * ```
+ */
+export declare const sleep: typeof delay;

package/dist/utils/async/delay.js

@@ -0,0 +1,42 @@
+/**
+ * Delay Utilities
+ *
+ * Promise-based delay/sleep functions for async flow control.
+ */
+/**
+ * Delay execution for a specified number of milliseconds.
+ *
+ * This is the canonical implementation for promise-based delays.
+ *
+ * @param ms - Duration to wait in milliseconds
+ * @returns Promise that resolves after the specified delay
+ *
+ * @example
+ * ```typescript
+ * await delay(1000); // Wait 1 second
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use in a loop for polling
+ * while (condition) {
+ *   await checkStatus();
+ *   await delay(500);
+ * }
+ * ```
+ */
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Alias for delay - provided for code clarity in sleep-like contexts.
+ *
+ * @param ms - Duration to sleep in milliseconds
+ * @returns Promise that resolves after the specified duration
+ *
+ * @example
+ * ```typescript
+ * await sleep(2000); // Sleep for 2 seconds
+ * ```
+ */
+export const sleep = delay;

package/dist/utils/async/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Async Utilities
+ *
+ * Centralized async/promise utilities for NeuroLink.
+ * Provides common patterns like delays, timeouts, and retry logic.
+ *
+ * @example
+ * ```typescript
+ * import { delay, withTimeout, retry } from './utils/async/index.js';
+ *
+ * // Simple delay
+ * await delay(1000);
+ *
+ * // Timeout protection
+ * const result = await withTimeout(fetchData(), 5000);
+ *
+ * // Retry with backoff
+ * const data = await retry(() => unreliableAPI(), { maxRetries: 3 });
+ * ```
+ */
+export { delay, sleep } from "./delay.js";
+export { calculateBackoff, createRetry, DEFAULT_RETRY_OPTIONS, RetryExhaustedError, type RetryOptions, retry, } from "./retry.js";
+export { TimeoutError, withTimeout, withTimeoutFn } from "./withTimeout.js";

package/dist/utils/async/index.js

@@ -0,0 +1,23 @@
+/**
+ * Async Utilities
+ *
+ * Centralized async/promise utilities for NeuroLink.
+ * Provides common patterns like delays, timeouts, and retry logic.
+ *
+ * @example
+ * ```typescript
+ * import { delay, withTimeout, retry } from './utils/async/index.js';
+ *
+ * // Simple delay
+ * await delay(1000);
+ *
+ * // Timeout protection
+ * const result = await withTimeout(fetchData(), 5000);
+ *
+ * // Retry with backoff
+ * const data = await retry(() => unreliableAPI(), { maxRetries: 3 });
+ * ```
+ */
+export { delay, sleep } from "./delay.js";
+export { calculateBackoff, createRetry, DEFAULT_RETRY_OPTIONS, RetryExhaustedError, retry, } from "./retry.js";
+export { TimeoutError, withTimeout, withTimeoutFn } from "./withTimeout.js";

package/dist/utils/async/retry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Retry Utilities
+ *
+ * Provides retry logic with exponential backoff for resilient async operations.
+ */
+/**
+ * Configuration options for retry operations.
+ */
+export interface RetryOptions {
+    /**
+     * Maximum number of retry attempts (not including the initial attempt).
+     * @default 3
+     */
+    maxRetries: number;
+    /**
+     * Initial delay between retries in milliseconds.
+     * @default 1000
+     */
+    baseDelayMs: number;
+    /**
+     * Maximum delay cap in milliseconds.
+     * @default 30000
+     */
+    maxDelayMs: number;
+    /**
+     * Multiplier for exponential backoff.
+     * @default 2
+     */
+    backoffMultiplier?: number;
+    /**
+     * Function to determine if a retry should be attempted.
+     * Return false to stop retrying immediately.
+     */
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    /**
+     * Callback invoked before each retry attempt.
+     * Useful for logging or metrics.
+     */
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+/**
+ * Default retry configuration.
+ */
+export declare const DEFAULT_RETRY_OPTIONS: RetryOptions;
+/**
+ * Calculate exponential backoff delay with optional jitter.
+ *
+ * Uses the formula: min(baseDelay * 2^(attempt-1) + jitter, maxDelay)
+ *
+ * @param attempt - Current attempt number (1-based)
+ * @param baseDelayMs - Base delay in milliseconds
+ * @param maxDelayMs - Maximum delay cap in milliseconds
+ * @param addJitter - Whether to add random jitter (default: true)
+ * @returns Calculated delay in milliseconds
+ *
+ * @example
+ * ```typescript
+ * // Without jitter
+ * calculateBackoff(1, 1000, 30000, false); // 1000ms
+ * calculateBackoff(2, 1000, 30000, false); // 2000ms
+ * calculateBackoff(3, 1000, 30000, false); // 4000ms
+ *
+ * // With jitter (adds up to 10% random delay)
+ * calculateBackoff(3, 1000, 30000, true); // ~4000-4400ms
+ * ```
+ */
+export declare function calculateBackoff(attempt: number, baseDelayMs: number, maxDelayMs: number, addJitter?: boolean): number;
+/**
+ * Error thrown when all retry attempts are exhausted.
+ */
+export declare class RetryExhaustedError extends Error {
+    readonly attempts: number;
+    readonly lastError: Error;
+    /**
+     * Creates a new RetryExhaustedError.
+     *
+     * @param message - Error message
+     * @param attempts - Total number of attempts made
+     * @param lastError - The last error that caused the final failure
+     */
+    constructor(message: string, attempts: number, lastError: Error);
+}
+/**
+ * Retry an async function with exponential backoff.
+ *
+ * Executes the provided function and retries on failure according to
+ * the specified options. Uses exponential backoff between retries.
+ *
+ * @param fn - Async function to execute
+ * @param options - Retry configuration (merged with defaults)
+ * @returns Promise that resolves with the function result
+ * @throws The last error if all retries are exhausted
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const data = await retry(() => fetchFromAPI());
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom options
+ * const data = await retry(
+ *   () => fetchFromAPI(),
+ *   {
+ *     maxRetries: 5,
+ *     baseDelayMs: 500,
+ *     maxDelayMs: 10000,
+ *     onRetry: (err, attempt, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms: ${err.message}`);
+ *     },
+ *     shouldRetry: (err) => {
+ *       // Only retry on network errors
+ *       return err.name === 'NetworkError';
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+/**
+ * Create a retry wrapper with pre-configured options.
+ *
+ * Useful for creating reusable retry strategies.
+ *
+ * @param defaultOptions - Default retry options for the wrapper
+ * @returns A retry function with the specified defaults
+ *
+ * @example
+ * ```typescript
+ * const apiRetry = createRetry({
+ *   maxRetries: 5,
+ *   baseDelayMs: 100,
+ *   onRetry: (err, attempt) => logger.warn(`API retry ${attempt}`)
+ * });
+ *
+ * // Use the configured retry
+ * const data = await apiRetry(() => fetchFromAPI());
+ * ```
+ */
+export declare function createRetry(defaultOptions: Partial<RetryOptions>): <T>(fn: () => Promise<T>, overrideOptions?: Partial<RetryOptions>) => Promise<T>;