opencode-puter-auth 1.0.37 → 1.0.39

package/dist/fallback.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Fallback Manager for opencode-puter-auth
+ *
+ * Provides automatic model fallback when rate limits are encountered.
+ * When a model returns a rate limit error (429/403), the manager:
+ * 1. Adds the model to a cooldown list
+ * 2. Tries alternative free models in order
+ * 3. Returns to the original model after cooldown expires
+ *
+ * @example
+ * ```ts
+ * const manager = new FallbackManager({
+ *   fallbackModels: ['openrouter:xiaomi/mimo-v2-flash:free'],
+ *   cooldownMs: 60000,
+ * });
+ *
+ * const result = await manager.executeWithFallback(
+ *   'claude-opus-4-5',
+ *   async (model) => puter.ai.chat(messages, { model }),
+ *   logger
+ * );
+ *
+ * if (result.wasFallback) {
+ *   console.log(`Used fallback model: ${result.usedModel}`);
+ * }
+ * ```
+ */
+import type { Logger } from './logger.js';
+/**
+ * Default fallback models - FREE OpenRouter models via Puter gateway.
+ * Ordered by quality/capability (best first).
+ */
+export declare const DEFAULT_FALLBACK_MODELS: string[];
+/**
+ * Default cooldown duration in milliseconds (60 seconds)
+ */
+export declare const DEFAULT_COOLDOWN_MS = 60000;
+/**
+ * Configuration options for FallbackManager
+ */
+export interface FallbackOptions {
+    /** List of fallback models to try when primary fails */
+    fallbackModels?: string[];
+    /** Cooldown duration in milliseconds */
+    cooldownMs?: number;
+    /** Whether fallback is enabled */
+    enabled?: boolean;
+}
+/**
+ * Record of a single model attempt
+ */
+export interface FallbackAttempt {
+    /** Model that was tried */
+    model: string;
+    /** Whether the attempt succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Whether the error was a rate limit */
+    isRateLimit?: boolean;
+    /** Duration of the attempt in ms */
+    durationMs?: number;
+}
+/**
+ * Result of executeWithFallback
+ */
+export interface FallbackResult<T> {
+    /** The result from the successful model */
+    result: T;
+    /** The model that was actually used */
+    usedModel: string;
+    /** Whether a fallback model was used instead of the primary */
+    wasFallback: boolean;
+    /** All attempts made (for debugging/logging) */
+    attempts: FallbackAttempt[];
+}
+/**
+ * Error thrown when all models (primary + fallbacks) have failed
+ */
+export declare class FallbackExhaustedError extends Error {
+    readonly attempts: FallbackAttempt[];
+    constructor(attempts: FallbackAttempt[]);
+}
+/**
+ * Check if an error indicates a rate limit
+ *
+ * Detects various rate limit error patterns from different providers:
+ * - HTTP 429 (Too Many Requests)
+ * - HTTP 403 (Forbidden) - Puter uses this for account limits
+ * - Various error message patterns
+ *
+ * @param error - The error to check
+ * @returns true if the error is a rate limit error
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Manages automatic model fallback when rate limits are encountered.
+ *
+ * This is a singleton-style class designed to be shared across all
+ * PuterChatLanguageModel instances so cooldown state is consistent.
+ */
+export declare class FallbackManager {
+    private cooldownMap;
+    private fallbackModels;
+    private cooldownMs;
+    private enabled;
+    constructor(options?: FallbackOptions);
+    /**
+     * Check if a model is currently on cooldown
+     *
+     * @param model - Model ID to check
+     * @returns true if the model is on cooldown
+     */
+    isModelOnCooldown(model: string): boolean;
+    /**
+     * Get remaining cooldown time for a model in milliseconds
+     *
+     * @param model - Model ID to check
+     * @returns Remaining cooldown in ms, or 0 if not on cooldown
+     */
+    getCooldownRemaining(model: string): number;
+    /**
+     * Add a model to the cooldown list
+     *
+     * @param model - Model ID to add to cooldown
+     * @param reason - Reason for the cooldown (e.g., error message)
+     * @param durationMs - Optional custom cooldown duration
+     */
+    addToCooldown(model: string, reason: string, durationMs?: number): void;
+    /**
+     * Remove a model from cooldown (e.g., if it's working again)
+     *
+     * @param model - Model ID to remove from cooldown
+     */
+    removeFromCooldown(model: string): void;
+    /**
+     * Get all models currently on cooldown
+     *
+     * @returns Map of model IDs to their cooldown info
+     */
+    getCooldownStatus(): Map<string, {
+        remainingMs: number;
+        reason: string;
+    }>;
+    /**
+     * Build the queue of models to try, respecting cooldowns
+     *
+     * @param primaryModel - The primary model requested
+     * @returns Ordered array of models to try
+     */
+    buildModelQueue(primaryModel: string): string[];
+    /**
+     * Execute an operation with automatic model fallback
+     *
+     * Tries the primary model first, and if it fails with a rate limit error,
+     * automatically tries fallback models in order.
+     *
+     * @param primaryModel - The primary model to try first
+     * @param operation - Function that performs the API call with the given model
+     * @param logger - Optional logger for debugging
+     * @returns Result including which model was used and all attempts
+     * @throws FallbackExhaustedError if all models fail
+     *
+     * @example
+     * ```ts
+     * const result = await manager.executeWithFallback(
+     *   'claude-opus-4-5',
+     *   async (model) => {
+     *     return await puter.ai.chat(messages, { model });
+     *   },
+     *   logger
+     * );
+     * ```
+     */
+    executeWithFallback<T>(primaryModel: string, operation: (model: string) => Promise<T>, logger?: Logger): Promise<FallbackResult<T>>;
+    /**
+     * Clear all cooldowns (useful for testing or manual reset)
+     */
+    clearCooldowns(): void;
+    /**
+     * Update configuration
+     */
+    configure(options: Partial<FallbackOptions>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Required<FallbackOptions>;
+}
+/**
+ * Get the global FallbackManager instance, creating it if needed
+ *
+ * @param options - Configuration options (only used when creating)
+ * @returns The global FallbackManager instance
+ */
+export declare function getGlobalFallbackManager(options?: FallbackOptions): FallbackManager;
+/**
+ * Reset the global FallbackManager (useful for testing)
+ */
+export declare function resetGlobalFallbackManager(): void;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/fallback.d.ts.map

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

package/dist/fallback.js

@@ -0,0 +1,380 @@
+/**
+ * Fallback Manager for opencode-puter-auth
+ *
+ * Provides automatic model fallback when rate limits are encountered.
+ * When a model returns a rate limit error (429/403), the manager:
+ * 1. Adds the model to a cooldown list
+ * 2. Tries alternative free models in order
+ * 3. Returns to the original model after cooldown expires
+ *
+ * @example
+ * ```ts
+ * const manager = new FallbackManager({
+ *   fallbackModels: ['openrouter:xiaomi/mimo-v2-flash:free'],
+ *   cooldownMs: 60000,
+ * });
+ *
+ * const result = await manager.executeWithFallback(
+ *   'claude-opus-4-5',
+ *   async (model) => puter.ai.chat(messages, { model }),
+ *   logger
+ * );
+ *
+ * if (result.wasFallback) {
+ *   console.log(`Used fallback model: ${result.usedModel}`);
+ * }
+ * ```
+ */
+/**
+ * Default fallback models - FREE OpenRouter models via Puter gateway.
+ * Ordered by quality/capability (best first).
+ */
+export const DEFAULT_FALLBACK_MODELS = [
+    // Tier 1: Best free models (try these first)
+    'openrouter:xiaomi/mimo-v2-flash:free', // 309B MoE, #1 SWE-bench
+    'openrouter:deepseek/deepseek-r1-0528:free', // 671B MoE, o1-level reasoning
+    'openrouter:mistralai/devstral-2512:free', // 123B, agentic coding
+    // Tier 2: Other quality free models
+    'openrouter:qwen/qwen3-coder:free', // 480B MoE coding model
+    'openrouter:google/gemini-2.0-flash-exp:free', // Google's experimental
+    // Tier 3: Fallback free models
+    'openrouter:meta-llama/llama-4-maverick:free',
+    'openrouter:openai/gpt-oss-120b:free',
+];
+/**
+ * Default cooldown duration in milliseconds (60 seconds)
+ */
+export const DEFAULT_COOLDOWN_MS = 60000;
+/**
+ * Error thrown when all models (primary + fallbacks) have failed
+ */
+export class FallbackExhaustedError extends Error {
+    attempts;
+    constructor(attempts) {
+        const modelsTried = attempts.map(a => a.model).join(', ');
+        super(`All models exhausted. Tried: ${modelsTried}`);
+        this.name = 'FallbackExhaustedError';
+        this.attempts = attempts;
+    }
+}
+/**
+ * Check if an error indicates a rate limit
+ *
+ * Detects various rate limit error patterns from different providers:
+ * - HTTP 429 (Too Many Requests)
+ * - HTTP 403 (Forbidden) - Puter uses this for account limits
+ * - Various error message patterns
+ *
+ * @param error - The error to check
+ * @returns true if the error is a rate limit error
+ */
+export function isRateLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // HTTP status codes that indicate rate limiting
+    if (message.includes('(429)') || message.includes('status 429'))
+        return true;
+    if (message.includes('(403)') || message.includes('status 403'))
+        return true;
+    // Error message patterns from various providers
+    const rateLimitPatterns = [
+        'rate limit',
+        'rate_limit',
+        'ratelimit',
+        'too many requests',
+        'quota exceeded',
+        'quota_exceeded',
+        'limit exceeded',
+        'request limit',
+        'credits exhausted',
+        'insufficient credits',
+        'usage limit',
+        'capacity',
+        'overloaded',
+        'try again later',
+    ];
+    return rateLimitPatterns.some(pattern => message.includes(pattern));
+}
+/**
+ * Manages automatic model fallback when rate limits are encountered.
+ *
+ * This is a singleton-style class designed to be shared across all
+ * PuterChatLanguageModel instances so cooldown state is consistent.
+ */
+export class FallbackManager {
+    cooldownMap = new Map();
+    fallbackModels;
+    cooldownMs;
+    enabled;
+    constructor(options = {}) {
+        this.fallbackModels = options.fallbackModels ?? DEFAULT_FALLBACK_MODELS;
+        this.cooldownMs = options.cooldownMs ?? DEFAULT_COOLDOWN_MS;
+        this.enabled = options.enabled ?? true;
+    }
+    /**
+     * Check if a model is currently on cooldown
+     *
+     * @param model - Model ID to check
+     * @returns true if the model is on cooldown
+     */
+    isModelOnCooldown(model) {
+        const entry = this.cooldownMap.get(model);
+        if (!entry)
+            return false;
+        // Check if cooldown has expired
+        if (Date.now() >= entry.expiresAt) {
+            this.cooldownMap.delete(model);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get remaining cooldown time for a model in milliseconds
+     *
+     * @param model - Model ID to check
+     * @returns Remaining cooldown in ms, or 0 if not on cooldown
+     */
+    getCooldownRemaining(model) {
+        const entry = this.cooldownMap.get(model);
+        if (!entry)
+            return 0;
+        const remaining = entry.expiresAt - Date.now();
+        if (remaining <= 0) {
+            this.cooldownMap.delete(model);
+            return 0;
+        }
+        return remaining;
+    }
+    /**
+     * Add a model to the cooldown list
+     *
+     * @param model - Model ID to add to cooldown
+     * @param reason - Reason for the cooldown (e.g., error message)
+     * @param durationMs - Optional custom cooldown duration
+     */
+    addToCooldown(model, reason, durationMs) {
+        this.cooldownMap.set(model, {
+            expiresAt: Date.now() + (durationMs ?? this.cooldownMs),
+            reason,
+        });
+    }
+    /**
+     * Remove a model from cooldown (e.g., if it's working again)
+     *
+     * @param model - Model ID to remove from cooldown
+     */
+    removeFromCooldown(model) {
+        this.cooldownMap.delete(model);
+    }
+    /**
+     * Get all models currently on cooldown
+     *
+     * @returns Map of model IDs to their cooldown info
+     */
+    getCooldownStatus() {
+        const status = new Map();
+        const now = Date.now();
+        for (const [model, entry] of this.cooldownMap) {
+            const remaining = entry.expiresAt - now;
+            if (remaining > 0) {
+                status.set(model, { remainingMs: remaining, reason: entry.reason });
+            }
+            else {
+                // Clean up expired entries
+                this.cooldownMap.delete(model);
+            }
+        }
+        return status;
+    }
+    /**
+     * Build the queue of models to try, respecting cooldowns
+     *
+     * @param primaryModel - The primary model requested
+     * @returns Ordered array of models to try
+     */
+    buildModelQueue(primaryModel) {
+        const queue = [];
+        // Add primary model first if not on cooldown
+        if (!this.isModelOnCooldown(primaryModel)) {
+            queue.push(primaryModel);
+        }
+        // Add fallback models that aren't on cooldown
+        for (const model of this.fallbackModels) {
+            // Skip if it's the primary (already added) or on cooldown
+            if (model === primaryModel)
+                continue;
+            if (this.isModelOnCooldown(model))
+                continue;
+            queue.push(model);
+        }
+        // If primary was on cooldown but we have no fallbacks, add it anyway
+        // (better to try and fail than to give up immediately)
+        if (queue.length === 0 && this.isModelOnCooldown(primaryModel)) {
+            queue.push(primaryModel);
+        }
+        return queue;
+    }
+    /**
+     * Execute an operation with automatic model fallback
+     *
+     * Tries the primary model first, and if it fails with a rate limit error,
+     * automatically tries fallback models in order.
+     *
+     * @param primaryModel - The primary model to try first
+     * @param operation - Function that performs the API call with the given model
+     * @param logger - Optional logger for debugging
+     * @returns Result including which model was used and all attempts
+     * @throws FallbackExhaustedError if all models fail
+     *
+     * @example
+     * ```ts
+     * const result = await manager.executeWithFallback(
+     *   'claude-opus-4-5',
+     *   async (model) => {
+     *     return await puter.ai.chat(messages, { model });
+     *   },
+     *   logger
+     * );
+     * ```
+     */
+    async executeWithFallback(primaryModel, operation, logger) {
+        // If fallback is disabled, just run the operation directly
+        if (!this.enabled) {
+            const startTime = Date.now();
+            try {
+                const result = await operation(primaryModel);
+                return {
+                    result,
+                    usedModel: primaryModel,
+                    wasFallback: false,
+                    attempts: [{
+                            model: primaryModel,
+                            success: true,
+                            durationMs: Date.now() - startTime,
+                        }],
+                };
+            }
+            catch (error) {
+                throw error;
+            }
+        }
+        const modelQueue = this.buildModelQueue(primaryModel);
+        const attempts = [];
+        logger?.debug('Fallback queue built', {
+            primary: primaryModel,
+            queue: modelQueue.join(', '),
+            cooldowns: this.cooldownMap.size,
+        });
+        for (const model of modelQueue) {
+            const startTime = Date.now();
+            const isFallback = model !== primaryModel;
+            if (isFallback) {
+                logger?.info(`Trying fallback model: ${model}`);
+            }
+            try {
+                const result = await operation(model);
+                // Success! If this was a fallback, log it
+                if (isFallback) {
+                    logger?.info(`Fallback model succeeded: ${model}`);
+                }
+                attempts.push({
+                    model,
+                    success: true,
+                    durationMs: Date.now() - startTime,
+                });
+                return {
+                    result,
+                    usedModel: model,
+                    wasFallback: isFallback,
+                    attempts,
+                };
+            }
+            catch (error) {
+                const durationMs = Date.now() - startTime;
+                const isRateLimit = isRateLimitError(error);
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                attempts.push({
+                    model,
+                    success: false,
+                    error: errorMessage,
+                    isRateLimit,
+                    durationMs,
+                });
+                if (isRateLimit) {
+                    // Add to cooldown and continue to next model
+                    this.addToCooldown(model, errorMessage);
+                    const cooldownSecs = Math.round(this.cooldownMs / 1000);
+                    logger?.warn(`Model ${model} rate limited, cooldown ${cooldownSecs}s`);
+                }
+                else {
+                    // Non-rate-limit error - might be a real problem
+                    // Still try fallbacks but log it differently
+                    logger?.warn(`Model ${model} failed: ${errorMessage}`);
+                }
+                // Continue to next model in queue
+            }
+        }
+        // All models exhausted
+        logger?.error('All models exhausted', new FallbackExhaustedError(attempts));
+        throw new FallbackExhaustedError(attempts);
+    }
+    /**
+     * Clear all cooldowns (useful for testing or manual reset)
+     */
+    clearCooldowns() {
+        this.cooldownMap.clear();
+    }
+    /**
+     * Update configuration
+     */
+    configure(options) {
+        if (options.fallbackModels !== undefined) {
+            this.fallbackModels = options.fallbackModels;
+        }
+        if (options.cooldownMs !== undefined) {
+            this.cooldownMs = options.cooldownMs;
+        }
+        if (options.enabled !== undefined) {
+            this.enabled = options.enabled;
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return {
+            fallbackModels: [...this.fallbackModels],
+            cooldownMs: this.cooldownMs,
+            enabled: this.enabled,
+        };
+    }
+}
+/**
+ * Global FallbackManager instance shared across all model instances.
+ * This ensures cooldown state is consistent across the application.
+ */
+let globalFallbackManager = null;
+/**
+ * Get the global FallbackManager instance, creating it if needed
+ *
+ * @param options - Configuration options (only used when creating)
+ * @returns The global FallbackManager instance
+ */
+export function getGlobalFallbackManager(options) {
+    if (!globalFallbackManager) {
+        globalFallbackManager = new FallbackManager(options);
+    }
+    else if (options) {
+        // Update config if options provided
+        globalFallbackManager.configure(options);
+    }
+    return globalFallbackManager;
+}
+/**
+ * Reset the global FallbackManager (useful for testing)
+ */
+export function resetGlobalFallbackManager() {
+    globalFallbackManager = null;
+}
+//# sourceMappingURL=fallback.js.map

package/dist/fallback.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,8 @@
  * and 500+ AI models through Puter.com's "User-Pays" model.
  * Free tier available with undocumented limits.
  *
+ * Features automatic model fallback when rate limits are encountered.
+ *
  * @author chindris-mihai-alexandru
  * @license MIT
  */
@@ -12,5 +14,9 @@ export { PuterAuthPlugin } from './plugin.js';
 export { createPuter as default } from './ai-provider/index.js';
 export { createPuter } from './ai-provider/index.js';
 export type { PuterProvider, PuterChatSettings, PuterProviderConfig, PuterChatConfig } from './ai-provider/index.js';
+export { createLogger, createLoggerFromConfig, nullLogger, LogLevel } from './logger.js';
+export type { Logger, LoggerOptions } from './logger.js';
+export { FallbackManager, getGlobalFallbackManager, resetGlobalFallbackManager, isRateLimitError, FallbackExhaustedError, DEFAULT_FALLBACK_MODELS, DEFAULT_COOLDOWN_MS, } from './fallback.js';
+export type { FallbackOptions, FallbackResult, FallbackAttempt, } from './fallback.js';
 export type { PuterConfig, PuterAccount, PuterChatOptions, PuterChatResponse, PuterChatMessage, PuterChatStreamChunk, PuterModelInfo } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGrH,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGrH,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -5,6 +5,8 @@
  * and 500+ AI models through Puter.com's "User-Pays" model.
  * Free tier available with undocumented limits.
  *
+ * Features automatic model fallback when rate limits are encountered.
+ *
  * @author chindris-mihai-alexandru
  * @license MIT
  */
@@ -19,4 +21,8 @@ export { PuterAuthPlugin } from './plugin.js';
 export { createPuter as default } from './ai-provider/index.js';
 // AI SDK Provider exports
 export { createPuter } from './ai-provider/index.js';
+// Logger exports for debug mode
+export { createLogger, createLoggerFromConfig, nullLogger, LogLevel } from './logger.js';
+// Fallback Manager exports for automatic model fallback
+export { FallbackManager, getGlobalFallbackManager, resetGlobalFallbackManager, isRateLimitError, FallbackExhaustedError, DEFAULT_FALLBACK_MODELS, DEFAULT_COOLDOWN_MS, } from './fallback.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,2DAA2D;AAC3D,wEAAwE;AACxE,yFAAyF;AACzF,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,gEAAgE;AAChE,uEAAuE;AACvE,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEhE,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD,2DAA2D;AAC3D,wEAAwE;AACxE,yFAAyF;AACzF,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,gEAAgE;AAChE,uEAAuE;AACvE,OAAO,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEhE,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGzF,wDAAwD;AACxD,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,eAAe,CAAC"}