attocode 0.1.0

package/dist/src/providers/adapters/openrouter.js

@@ -0,0 +1,363 @@
+/**
+ * OpenRouter Provider Adapter
+ *
+ * Adapts the OpenRouter API (OpenAI-compatible) to our LLMProvider interface.
+ * OpenRouter provides access to 100+ models from various providers through
+ * a single API key.
+ */
+import { ProviderError } from '../types.js';
+import { registerProvider, hasEnv, requireEnv } from '../provider.js';
+import { resilientFetch } from '../resilient-fetch.js';
+// =============================================================================
+// DEFAULT MODEL SELECTION
+// =============================================================================
+/**
+ * TODO: Choose your default model for OpenRouter.
+ *
+ * This is a meaningful design choice based on your priorities:
+ *
+ * Cost-optimized options:
+ *   - 'meta-llama/llama-3.1-8b-instruct' - Very cheap, good for simple tasks
+ *   - 'mistralai/mistral-7b-instruct' - Budget-friendly, solid performance
+ *
+ * Balanced options:
+ *   - 'anthropic/claude-sonnet-4' - Good balance of quality and cost
+ *   - 'openai/gpt-4o-mini' - Fast, cheap, capable
+ *
+ * Quality-optimized options:
+ *   - 'anthropic/claude-opus-4' - Highest Claude quality
+ *   - 'openai/gpt-4-turbo' - High quality, good for complex tasks
+ *
+ * Consider: What's your primary use case? Development/testing (use cheaper),
+ * production (use quality), or experimentation (use balanced)?
+ */
+function getDefaultModel() {
+    // Using Gemini Flash - fast, cheap, and good tool use support
+    // Change to 'anthropic/claude-sonnet-4' for higher quality
+    return 'google/gemini-2.0-flash-001';
+}
+// =============================================================================
+// OPENROUTER PROVIDER
+// =============================================================================
+export class OpenRouterProvider {
+    name = 'openrouter';
+    defaultModel;
+    apiKey;
+    model;
+    baseUrl = 'https://openrouter.ai/api/v1';
+    siteUrl;
+    siteName;
+    networkConfig;
+    constructor(config) {
+        this.apiKey = config?.apiKey ?? requireEnv('OPENROUTER_API_KEY');
+        this.defaultModel = getDefaultModel();
+        this.model = config?.model ?? process.env.OPENROUTER_MODEL ?? this.defaultModel;
+        this.siteUrl = config?.siteUrl ?? process.env.OPENROUTER_SITE_URL;
+        this.siteName = config?.siteName ?? process.env.OPENROUTER_SITE_NAME;
+        this.networkConfig = {
+            timeout: 120000, // 2 minutes
+            maxRetries: 3,
+            baseRetryDelay: 1000,
+        };
+    }
+    isConfigured() {
+        return hasEnv('OPENROUTER_API_KEY');
+    }
+    async chat(messages, options) {
+        const model = options?.model ?? this.model;
+        // OpenRouter uses OpenAI-compatible message format
+        const openRouterMessages = messages.map(m => ({
+            role: m.role,
+            content: m.content,
+        }));
+        // Build request body (OpenAI-compatible)
+        const body = {
+            model,
+            messages: openRouterMessages,
+            max_tokens: options?.maxTokens ?? 4096,
+            temperature: options?.temperature ?? 0.7,
+            ...(options?.stopSequences && { stop: options.stopSequences }),
+            // Enable usage accounting to get actual cost from OpenRouter
+            usage: { include: true },
+        };
+        // OpenRouter requires specific headers for analytics
+        const headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        // Optional headers for OpenRouter analytics/rate limits
+        if (this.siteUrl) {
+            headers['HTTP-Referer'] = this.siteUrl;
+        }
+        if (this.siteName) {
+            headers['X-Title'] = this.siteName;
+        }
+        try {
+            const { response } = await resilientFetch({
+                url: `${this.baseUrl}/chat/completions`,
+                init: {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                },
+                providerName: this.name,
+                networkConfig: this.networkConfig,
+                onRetry: (attempt, delay, error) => {
+                    console.warn(`[OpenRouter] Retry attempt ${attempt} after ${delay}ms: ${error.message}`);
+                },
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw this.handleError(response.status, error);
+            }
+            const data = await response.json();
+            const choice = data.choices[0];
+            // Get cost: try inline first, then query generation endpoint
+            let cost = data.usage.cost;
+            if (cost === undefined && data.id) {
+                cost = await this.queryGenerationCost(data.id);
+            }
+            return {
+                content: choice.message.content,
+                stopReason: this.mapStopReason(choice.finish_reason),
+                usage: {
+                    inputTokens: data.usage.prompt_tokens,
+                    outputTokens: data.usage.completion_tokens,
+                    cost,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof ProviderError)
+                throw error;
+            throw new ProviderError(`OpenRouter request failed: ${error.message}`, this.name, 'NETWORK_ERROR', error);
+        }
+    }
+    /**
+     * ═══════════════════════════════════════════════════════════════════════════
+     * NATIVE TOOL USE: Why This Matters
+     * ═══════════════════════════════════════════════════════════════════════════
+     *
+     * Before (Lesson 1): Parse JSON from text response
+     *   LLM returns: "I'll use the read_file tool:\n```json\n{\"path\": \"x.ts\"}\n```"
+     *   We parse: Extract JSON with regex → JSON.parse → Hope it's valid
+     *   Problems: Hallucinated formats, partial JSON, extra text
+     *
+     * After (Native tool use):
+     *   LLM returns: { tool_calls: [{ function: { name: "read_file", arguments: "{\"path\":\"x.ts\"}" }}] }
+     *   We use: Structured response → Always valid JSON → Type-safe
+     *   Benefits: No parsing errors, proper function calling semantics
+     *
+     * This method enables native tool use through OpenRouter's OpenAI-compatible API.
+     * ═══════════════════════════════════════════════════════════════════════════
+     */
+    async chatWithTools(messages, options) {
+        const model = options?.model ?? this.model;
+        // Convert messages to OpenRouter format
+        // This handles both simple string content and structured content with cache_control
+        const openRouterMessages = messages.map(m => {
+            // Handle tool role messages (results from tool execution)
+            if ('tool_call_id' in m && m.role === 'tool') {
+                const toolMsg = {
+                    role: 'tool',
+                    content: typeof m.content === 'string' ? m.content : m.content.map(c => c.text).join(''),
+                    tool_call_id: m.tool_call_id,
+                };
+                // Include name if present (required for Gemini)
+                if ('name' in m && m.name) {
+                    toolMsg.name = m.name;
+                }
+                return toolMsg;
+            }
+            // Handle assistant messages with tool calls
+            if ('tool_calls' in m && m.tool_calls) {
+                return {
+                    role: 'assistant',
+                    content: typeof m.content === 'string' ? m.content : (m.content.length > 0 ? m.content.map(c => c.text).join('') : null),
+                    tool_calls: m.tool_calls,
+                };
+            }
+            // Handle structured content (with potential cache_control)
+            if (typeof m.content !== 'string') {
+                return {
+                    role: m.role,
+                    content: m.content, // Pass through structured content for caching
+                };
+            }
+            // Simple string content
+            return {
+                role: m.role,
+                content: m.content,
+            };
+        });
+        // Build request body with tool definitions
+        const body = {
+            model,
+            messages: openRouterMessages,
+            max_tokens: options?.maxTokens ?? 4096,
+            temperature: options?.temperature ?? 0.7,
+            ...(options?.stopSequences && { stop: options.stopSequences }),
+            // Enable usage accounting to get cached_tokens in response
+            usage: { include: true },
+        };
+        // Add tool definitions if provided
+        if (options?.tools && options.tools.length > 0) {
+            body.tools = options.tools;
+            body.tool_choice = options?.tool_choice ?? 'auto';
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        if (this.siteUrl) {
+            headers['HTTP-Referer'] = this.siteUrl;
+        }
+        if (this.siteName) {
+            headers['X-Title'] = this.siteName;
+        }
+        try {
+            const { response } = await resilientFetch({
+                url: `${this.baseUrl}/chat/completions`,
+                init: {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                },
+                providerName: this.name,
+                networkConfig: this.networkConfig,
+                onRetry: (attempt, delay, error) => {
+                    console.warn(`[OpenRouter] Retry attempt ${attempt} after ${delay}ms: ${error.message}`);
+                },
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw this.handleError(response.status, error);
+            }
+            const data = await response.json();
+            const choice = data.choices[0];
+            // Get cost: try inline first, then query generation endpoint
+            let cost = data.usage.cost;
+            if (cost === undefined && data.id) {
+                cost = await this.queryGenerationCost(data.id);
+            }
+            if (process.env.DEBUG_COST) {
+                console.log('[OpenRouter] Response ID:', data.id);
+                console.log('[OpenRouter] Usage:', JSON.stringify(data.usage));
+                console.log('[OpenRouter] Final cost:', cost);
+            }
+            // Extract tool calls if present
+            const toolCalls = choice.message.tool_calls?.map(tc => ({
+                id: tc.id,
+                type: tc.type,
+                function: {
+                    name: tc.function.name,
+                    arguments: tc.function.arguments,
+                },
+            }));
+            return {
+                content: choice.message.content ?? '',
+                stopReason: this.mapStopReason(choice.finish_reason),
+                usage: {
+                    inputTokens: data.usage.prompt_tokens,
+                    outputTokens: data.usage.completion_tokens,
+                    cachedTokens: data.usage.prompt_tokens_details?.cached_tokens,
+                    // Use actual cost from OpenRouter
+                    cost,
+                },
+                toolCalls,
+            };
+        }
+        catch (error) {
+            if (error instanceof ProviderError)
+                throw error;
+            throw new ProviderError(`OpenRouter request failed: ${error.message}`, this.name, 'NETWORK_ERROR', error);
+        }
+    }
+    /**
+     * Query the generation endpoint to get actual cost with retry.
+     * OpenRouter's generation data may not be immediately available after completion,
+     * so we retry with exponential backoff.
+     */
+    async queryGenerationCost(generationId) {
+        const maxRetries = 3;
+        const delays = [100, 300, 600]; // ms - exponential backoff
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                // Wait before querying (generation data needs time to propagate)
+                await new Promise(resolve => setTimeout(resolve, delays[attempt]));
+                const response = await fetch(`${this.baseUrl}/generation?id=${generationId}`, {
+                    method: 'GET',
+                    headers: {
+                        'Authorization': `Bearer ${this.apiKey}`,
+                    },
+                });
+                if (!response.ok) {
+                    if (process.env.DEBUG_COST) {
+                        console.log(`[OpenRouter] Generation query attempt ${attempt + 1} failed:`, response.status);
+                    }
+                    continue; // Retry on non-OK response
+                }
+                const data = await response.json();
+                // OpenRouter returns cost in data.total_cost or data.usage
+                const cost = data.data?.total_cost ?? data.data?.usage;
+                if (process.env.DEBUG_COST) {
+                    console.log(`[OpenRouter] Generation attempt ${attempt + 1}:`, JSON.stringify(data.data));
+                    console.log('[OpenRouter] Cost from generation:', cost);
+                }
+                // If we got a valid cost, return it
+                if (cost !== undefined && cost > 0) {
+                    return cost;
+                }
+                // Cost not ready yet, continue to retry
+                if (process.env.DEBUG_COST) {
+                    console.log(`[OpenRouter] Cost not ready, attempt ${attempt + 1}/${maxRetries}`);
+                }
+            }
+            catch (err) {
+                if (process.env.DEBUG_COST) {
+                    console.log(`[OpenRouter] Generation query error attempt ${attempt + 1}:`, err);
+                }
+            }
+        }
+        if (process.env.DEBUG_COST) {
+            console.log('[OpenRouter] Failed to get cost after all retries');
+        }
+        return undefined;
+    }
+    handleError(status, body) {
+        let code = 'UNKNOWN';
+        if (status === 401)
+            code = 'AUTHENTICATION_FAILED';
+        else if (status === 429)
+            code = 'RATE_LIMITED';
+        else if (status === 400) {
+            if (body.includes('context_length')) {
+                code = 'CONTEXT_LENGTH_EXCEEDED';
+            }
+            else {
+                code = 'INVALID_REQUEST';
+            }
+        }
+        else if (status >= 500)
+            code = 'SERVER_ERROR';
+        return new ProviderError(`OpenRouter API error (${status}): ${body}`, this.name, code);
+    }
+    mapStopReason(reason) {
+        switch (reason) {
+            case 'stop': return 'end_turn';
+            case 'length': return 'max_tokens';
+            case 'stop_sequence': return 'stop_sequence';
+            case 'tool_calls': return 'end_turn'; // Tool calls are a form of completion
+            default: return 'end_turn';
+        }
+    }
+}
+// =============================================================================
+// REGISTRATION
+// =============================================================================
+registerProvider('openrouter', {
+    priority: 0, // Highest priority - becomes default when configured
+    detect: () => hasEnv('OPENROUTER_API_KEY'),
+    create: async () => new OpenRouterProvider(),
+});
+//# sourceMappingURL=openrouter.js.map

package/dist/src/providers/adapters/openrouter.js.map

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

package/dist/src/providers/provider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Lesson 2: Provider Factory
+ *
+ * Creates and manages LLM providers with auto-detection.
+ */
+import type { LLMProvider, ProviderConfig } from './types.js';
+/**
+ * Registry of available providers.
+ * Each provider has a detection function and factory.
+ */
+interface ProviderRegistry {
+    detect: () => boolean;
+    create: () => Promise<LLMProvider>;
+    priority: number;
+}
+/**
+ * Register a provider.
+ * Call this for each provider adapter.
+ */
+export declare function registerProvider(name: string, registry: ProviderRegistry): void;
+/**
+ * Auto-detect and create the best available provider.
+ *
+ * Detection order (by priority):
+ * 0. OpenRouter (if OPENROUTER_API_KEY set)
+ * 1. Anthropic (if ANTHROPIC_API_KEY set)
+ * 2. OpenAI (if OPENAI_API_KEY set)
+ * 3. Azure (if AZURE_OPENAI_* set)
+ * 100. Mock (always available as fallback)
+ */
+export declare function getProvider(preferred?: string): Promise<LLMProvider>;
+/**
+ * Create a provider from explicit configuration.
+ * Use this when you don't want auto-detection.
+ */
+export declare function createProvider(config: ProviderConfig): Promise<LLMProvider>;
+/**
+ * List all registered providers and their status.
+ */
+export declare function listProviders(): Array<{
+    name: string;
+    configured: boolean;
+    priority: number;
+}>;
+/**
+ * Check if an environment variable is set and non-empty.
+ */
+export declare function hasEnv(key: string): boolean;
+/**
+ * Get environment variable or throw.
+ */
+export declare function requireEnv(key: string): string;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/providers/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAO9D;;;GAGG;AACH,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAEN;AAMD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8B1E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BjF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ9F;AAMD;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/dist/src/providers/provider.js

@@ -0,0 +1,111 @@
+/**
+ * Lesson 2: Provider Factory
+ *
+ * Creates and manages LLM providers with auto-detection.
+ */
+import { ProviderError } from './types.js';
+const providers = new Map();
+/**
+ * Register a provider.
+ * Call this for each provider adapter.
+ */
+export function registerProvider(name, registry) {
+    providers.set(name, registry);
+}
+// =============================================================================
+// PROVIDER FACTORY
+// =============================================================================
+/**
+ * Auto-detect and create the best available provider.
+ *
+ * Detection order (by priority):
+ * 0. OpenRouter (if OPENROUTER_API_KEY set)
+ * 1. Anthropic (if ANTHROPIC_API_KEY set)
+ * 2. OpenAI (if OPENAI_API_KEY set)
+ * 3. Azure (if AZURE_OPENAI_* set)
+ * 100. Mock (always available as fallback)
+ */
+export async function getProvider(preferred) {
+    // If preferred provider specified, try it first
+    if (preferred) {
+        const registry = providers.get(preferred);
+        if (registry?.detect()) {
+            return registry.create();
+        }
+        throw new ProviderError(`Preferred provider "${preferred}" is not configured`, preferred, 'NOT_CONFIGURED');
+    }
+    // Sort by priority and find first configured provider
+    const sorted = [...providers.entries()]
+        .sort((a, b) => a[1].priority - b[1].priority);
+    for (const [name, registry] of sorted) {
+        if (registry.detect()) {
+            console.log(`🔌 Using provider: ${name}`);
+            return registry.create();
+        }
+    }
+    throw new ProviderError('No LLM provider configured. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or AZURE_OPENAI_* environment variables.', 'none', 'NOT_CONFIGURED');
+}
+/**
+ * Create a provider from explicit configuration.
+ * Use this when you don't want auto-detection.
+ */
+export async function createProvider(config) {
+    switch (config.type) {
+        case 'anthropic': {
+            const { AnthropicProvider } = await import('./adapters/anthropic.js');
+            return new AnthropicProvider(config.config);
+        }
+        case 'openai': {
+            const { OpenAIProvider } = await import('./adapters/openai.js');
+            return new OpenAIProvider(config.config);
+        }
+        // Azure provider not included in attocode
+        // case 'azure': {
+        //   const { AzureOpenAIProvider } = await import('./adapters/azure.js');
+        //   return new AzureOpenAIProvider(config.config);
+        // }
+        case 'openrouter': {
+            const { OpenRouterProvider } = await import('./adapters/openrouter.js');
+            return new OpenRouterProvider(config.config);
+        }
+        case 'mock': {
+            const { MockProvider } = await import('./adapters/mock.js');
+            return new MockProvider();
+        }
+        default:
+            throw new ProviderError(`Unknown provider type: ${config.type}`, 'unknown', 'INVALID_REQUEST');
+    }
+}
+/**
+ * List all registered providers and their status.
+ */
+export function listProviders() {
+    return [...providers.entries()]
+        .map(([name, registry]) => ({
+        name,
+        configured: registry.detect(),
+        priority: registry.priority,
+    }))
+        .sort((a, b) => a.priority - b.priority);
+}
+// =============================================================================
+// HELPER FOR ADAPTER REGISTRATION
+// =============================================================================
+/**
+ * Check if an environment variable is set and non-empty.
+ */
+export function hasEnv(key) {
+    const value = process.env[key];
+    return value !== undefined && value.trim() !== '';
+}
+/**
+ * Get environment variable or throw.
+ */
+export function requireEnv(key) {
+    const value = process.env[key];
+    if (!value) {
+        throw new Error(`Missing required environment variable: ${key}`);
+    }
+    return value;
+}
+//# sourceMappingURL=provider.js.map

package/dist/src/providers/provider.js.map

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

package/dist/src/providers/resilient-fetch.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Resilient Fetch Utility
+ *
+ * Provides network resilience for LLM provider requests:
+ * - Configurable timeout to prevent infinite hangs
+ * - Retry with exponential backoff for transient failures
+ * - Rate limit handling with Retry-After header parsing
+ * - Cancellation token support for user interrupts
+ */
+/**
+ * Network configuration for resilient fetch.
+ */
+export interface NetworkConfig {
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Base delay between retries in ms (default: 1000) */
+    baseRetryDelay?: number;
+    /** Maximum delay between retries in ms (default: 30000) */
+    maxRetryDelay?: number;
+    /** HTTP status codes that trigger retry (default: [429, 500, 502, 503, 504]) */
+    retryableStatusCodes?: number[];
+}
+/**
+ * Cancellation token interface for external cancellation.
+ */
+export interface CancellationToken {
+    /** Whether cancellation has been requested */
+    isCancelled: boolean;
+    /** Register a callback to be called on cancellation */
+    onCancel?: (callback: () => void) => void;
+}
+/**
+ * Options for resilient fetch.
+ */
+export interface ResilientFetchOptions {
+    /** URL to fetch */
+    url: string;
+    /** Fetch init options (method, headers, body, etc.) */
+    init: RequestInit;
+    /** Provider name for error messages */
+    providerName: string;
+    /** Network configuration */
+    networkConfig?: NetworkConfig;
+    /** External cancellation token */
+    cancellationToken?: CancellationToken;
+    /** Callback for retry events */
+    onRetry?: (attempt: number, delay: number, error: Error) => void;
+}
+/**
+ * Result of resilient fetch.
+ */
+export interface ResilientFetchResult {
+    /** The fetch response */
+    response: Response;
+    /** Number of attempts made */
+    attempts: number;
+    /** Total duration in milliseconds */
+    duration: number;
+}
+/**
+ * Error thrown when fetch fails after all retries.
+ */
+export declare class ResilientFetchError extends Error {
+    readonly providerName: string;
+    readonly attempts: number;
+    readonly lastError?: Error | undefined;
+    readonly isTimeout: boolean;
+    readonly isCancelled: boolean;
+    constructor(message: string, providerName: string, attempts: number, lastError?: Error | undefined, isTimeout?: boolean, isCancelled?: boolean);
+}
+/**
+ * Perform a fetch with timeout, retry, and cancellation support.
+ *
+ * @example
+ * ```typescript
+ * const { response, attempts, duration } = await resilientFetch({
+ *   url: 'https://api.anthropic.com/v1/messages',
+ *   init: { method: 'POST', headers: {...}, body: JSON.stringify(body) },
+ *   providerName: 'anthropic',
+ *   networkConfig: { timeout: 60000, maxRetries: 3 },
+ * });
+ * ```
+ */
+export declare function resilientFetch(options: ResilientFetchOptions): Promise<ResilientFetchResult>;
+/**
+ * Check if an error is a resilient fetch error.
+ */
+export declare function isResilientFetchError(error: unknown): error is ResilientFetchError;
+/**
+ * Check if an error is a timeout error.
+ */
+export declare function isTimeoutError(error: unknown): boolean;
+/**
+ * Check if an error is a cancellation error.
+ */
+export declare function isCancellationError(error: unknown): boolean;
+//# sourceMappingURL=resilient-fetch.d.ts.map

package/dist/src/providers/resilient-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-fetch.d.ts","sourceRoot":"","sources":["../../../src/providers/resilient-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,EAAE,WAAW,CAAC;IAClB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,YAAY,EAAE,MAAM;aACpB,QAAQ,EAAE,MAAM;aAChB,SAAS,CAAC,EAAE,KAAK;aACjB,SAAS,EAAE,OAAO;aAClB,WAAW,EAAE,OAAO;gBALpC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,KAAK,YAAA,EACjB,SAAS,GAAE,OAAe,EAC1B,WAAW,GAAE,OAAe;CAK/C;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAmJ/B;AA0DD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE3D"}