@revenium/litellm 0.0.1

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/circuit-breaker.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Circuit breaker pattern implementation for handling repeated failures
+ *
+ * This module provides a circuit breaker to prevent cascading failures
+ * when the Revenium API is experiencing issues.
+ */
+/**
+ * Circuit breaker states
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation
+    OPEN = "OPEN",// Failing fast
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit */
+    failureThreshold: number;
+    /** Time in ms to wait before attempting recovery */
+    recoveryTimeout: number;
+    /** Number of successful calls needed to close circuit from half-open */
+    successThreshold: number;
+    /** Time window in ms for counting failures */
+    timeWindow: number;
+}
+/**
+ * Default circuit breaker configuration
+ */
+export declare const DEFAULT_CIRCUIT_CONFIG: CircuitBreakerConfig;
+/**
+ * Circuit breaker implementation
+ */
+export declare class CircuitBreaker {
+    private config;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private failures;
+    constructor(config?: CircuitBreakerConfig);
+    /**
+     * Execute a function with circuit breaker protection
+     * @param fn - Function to execute
+     * @returns Promise that resolves with function result or rejects if circuit is open
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if circuit breaker allows execution
+     * @returns True if execution is allowed
+     */
+    canExecute(): boolean;
+    /**
+     * Get current circuit breaker state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats(): {
+        state: CircuitState;
+        failureCount: number;
+        successCount: number;
+        recentFailures: number;
+        timeUntilRecovery?: number;
+    };
+    /**
+     * Reset circuit breaker to closed state
+     */
+    reset(): void;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Check if we should attempt recovery from open state
+     */
+    private shouldAttemptRecovery;
+    /**
+     * Remove old failure timestamps outside the time window
+     */
+    private cleanupOldFailures;
+}
+/**
+ * Get or create the global circuit breaker instance
+ * @param config - Optional configuration for the circuit breaker
+ * @returns Global circuit breaker instance
+ */
+export declare function getCircuitBreaker(config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+/**
+ * Reset the global circuit breaker
+ */
+export declare function resetCircuitBreaker(): void;
+/**
+ * Check if the global circuit breaker allows execution
+ * @returns True if execution is allowed
+ */
+export declare function canExecuteRequest(): boolean;
+/**
+ * Execute a function with global circuit breaker protection
+ * @param fn - Function to execute
+ * @returns Promise that resolves with function result
+ */
+export declare function executeWithCircuitBreaker<T>(fn: () => Promise<T>): Promise<T>;
+/**
+ * Get global circuit breaker statistics
+ */
+export declare function getCircuitBreakerStats(): ReturnType<CircuitBreaker['getStats']>;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/utils/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW,CAAM,mBAAmB;IAC1C,IAAI,SAAS,CAAU,eAAe;IACtC,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBAKpC,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAgB;gBAEZ,MAAM,GAAE,oBAA6C;IAEzE;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoBlD;;;OAGG;IACH,UAAU,IAAI,OAAO;IAMrB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,YAAY,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;IAoBD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,SAAS;IAwBjB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,cAAc,CAMxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAE/E"}

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Circuit breaker pattern implementation for handling repeated failures
+ *
+ * This module provides a circuit breaker to prevent cascading failures
+ * when the Revenium API is experiencing issues.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.DEFAULT_CIRCUIT_CONFIG = exports.CircuitState = void 0;
+exports.getCircuitBreaker = getCircuitBreaker;
+exports.resetCircuitBreaker = resetCircuitBreaker;
+exports.canExecuteRequest = canExecuteRequest;
+exports.executeWithCircuitBreaker = executeWithCircuitBreaker;
+exports.getCircuitBreakerStats = getCircuitBreakerStats;
+/**
+ * Circuit breaker states
+ */
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN"; // Testing if service recovered
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+/**
+ * Default circuit breaker configuration
+ */
+exports.DEFAULT_CIRCUIT_CONFIG = {
+    failureThreshold: 5,
+    recoveryTimeout: 30000, // 30 seconds
+    successThreshold: 3,
+    timeWindow: 60000 // 1 minute
+};
+/**
+ * Circuit breaker implementation
+ */
+class CircuitBreaker {
+    constructor(config = exports.DEFAULT_CIRCUIT_CONFIG) {
+        this.config = config;
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = 0;
+        this.failures = []; // Timestamps of failures
+    }
+    /**
+     * Execute a function with circuit breaker protection
+     * @param fn - Function to execute
+     * @returns Promise that resolves with function result or rejects if circuit is open
+     */
+    async execute(fn) {
+        if (this.state === CircuitState.OPEN) {
+            if (this.shouldAttemptRecovery()) {
+                this.state = CircuitState.HALF_OPEN;
+                this.successCount = 0;
+            }
+            else {
+                throw new Error('Circuit breaker is OPEN - failing fast');
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    /**
+     * Check if circuit breaker allows execution
+     * @returns True if execution is allowed
+     */
+    canExecute() {
+        if (this.state === CircuitState.CLOSED || this.state === CircuitState.HALF_OPEN)
+            return true;
+        if (this.state === CircuitState.OPEN && this.shouldAttemptRecovery())
+            return true;
+        return false;
+    }
+    /**
+     * Get current circuit breaker state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get circuit breaker statistics
+     */
+    getStats() {
+        const now = Date.now();
+        const recentFailures = this.failures.filter(timestamp => now - timestamp < this.config.timeWindow).length;
+        let timeUntilRecovery;
+        if (this.state === CircuitState.OPEN) {
+            const timeSinceLastFailure = now - this.lastFailureTime;
+            timeUntilRecovery = Math.max(0, this.config.recoveryTimeout - timeSinceLastFailure);
+        }
+        return {
+            state: this.state,
+            failureCount: this.failureCount,
+            successCount: this.successCount,
+            recentFailures,
+            timeUntilRecovery
+        };
+    }
+    /**
+     * Reset circuit breaker to closed state
+     */
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = 0;
+        this.failures = [];
+    }
+    /**
+     * Handle successful execution
+     */
+    onSuccess() {
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.successCount++;
+            if (this.successCount >= this.config.successThreshold) {
+                this.state = CircuitState.CLOSED;
+                this.failureCount = 0;
+                this.failures = [];
+            }
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            // Reset failure count on success in closed state
+            this.failureCount = 0;
+            this.cleanupOldFailures();
+        }
+    }
+    /**
+     * Handle failed execution
+     */
+    onFailure() {
+        const now = Date.now();
+        this.failureCount++;
+        this.lastFailureTime = now;
+        this.failures.push(now);
+        this.cleanupOldFailures();
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Go back to open state on any failure in half-open
+            this.state = CircuitState.OPEN;
+            this.successCount = 0;
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            // Check if we should open the circuit
+            const recentFailures = this.failures.filter(timestamp => now - timestamp < this.config.timeWindow).length;
+            if (recentFailures >= this.config.failureThreshold) {
+                this.state = CircuitState.OPEN;
+            }
+        }
+    }
+    /**
+     * Check if we should attempt recovery from open state
+     */
+    shouldAttemptRecovery() {
+        const now = Date.now();
+        return now - this.lastFailureTime >= this.config.recoveryTimeout;
+    }
+    /**
+     * Remove old failure timestamps outside the time window
+     */
+    cleanupOldFailures() {
+        const now = Date.now();
+        this.failures = this.failures.filter(timestamp => now - timestamp < this.config.timeWindow);
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+/**
+ * Global circuit breaker instance for Revenium API calls
+ */
+let globalCircuitBreaker = null;
+/**
+ * Get or create the global circuit breaker instance
+ * @param config - Optional configuration for the circuit breaker
+ * @returns Global circuit breaker instance
+ */
+function getCircuitBreaker(config) {
+    if (!globalCircuitBreaker) {
+        const finalConfig = config ? { ...exports.DEFAULT_CIRCUIT_CONFIG, ...config } : exports.DEFAULT_CIRCUIT_CONFIG;
+        globalCircuitBreaker = new CircuitBreaker(finalConfig);
+    }
+    return globalCircuitBreaker;
+}
+/**
+ * Reset the global circuit breaker
+ */
+function resetCircuitBreaker() {
+    if (globalCircuitBreaker)
+        globalCircuitBreaker.reset();
+}
+/**
+ * Check if the global circuit breaker allows execution
+ * @returns True if execution is allowed
+ */
+function canExecuteRequest() {
+    return getCircuitBreaker().canExecute();
+}
+/**
+ * Execute a function with global circuit breaker protection
+ * @param fn - Function to execute
+ * @returns Promise that resolves with function result
+ */
+async function executeWithCircuitBreaker(fn) {
+    return getCircuitBreaker().execute(fn);
+}
+/**
+ * Get global circuit breaker statistics
+ */
+function getCircuitBreakerStats() {
+    return getCircuitBreaker().getStats();
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

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

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

@@ -0,0 +1,166 @@
+/**
+ * Error handling utilities for consistent error management
+ *
+ * This module provides centralized error handling and custom error types
+ * for better error reporting and debugging.
+ */
+/**
+ * Base error class for Revenium middleware errors
+ */
+export declare class ReveniumError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+}
+/**
+ * Configuration-related errors
+ */
+export declare class ConfigurationError extends ReveniumError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * HTTP client patching errors
+ */
+export declare class PatchingError extends ReveniumError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Request processing errors
+ */
+export declare class RequestProcessingError extends ReveniumError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Revenium API communication errors
+ */
+export declare class ReveniumApiError extends ReveniumError {
+    readonly statusCode?: number;
+    readonly responseBody?: string;
+    constructor(message: string, statusCode?: number, responseBody?: string, context?: Record<string, unknown>);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends ReveniumError {
+    readonly validationErrors: string[];
+    constructor(message: string, validationErrors: string[], context?: Record<string, unknown>);
+}
+/**
+ * Stream processing errors
+ */
+export declare class StreamProcessingError extends ReveniumError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error context builder for consistent error reporting
+ */
+export declare class ErrorContext {
+    private context;
+    /**
+     * Add request ID to error context
+     */
+    withRequestId(requestId: string): this;
+    /**
+     * Add model information to error context
+     */
+    withModel(model: string): this;
+    /**
+     * Add URL to error context
+     */
+    withUrl(url: string): this;
+    /**
+     * Add HTTP status to error context
+     */
+    withStatus(status: number): this;
+    /**
+     * Add duration to error context
+     */
+    withDuration(duration: number): this;
+    /**
+     * Add custom field to error context
+     */
+    with(key: string, value: unknown): this;
+    /**
+     * Build the context object
+     */
+    build(): Record<string, unknown>;
+}
+/**
+ * Safe error message extraction
+ * @param error - Error to extract message from
+ * @returns Safe error message string
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Safe error stack extraction
+ * @param error - Error to extract stack from
+ * @returns Error stack or undefined
+ */
+export declare function getErrorStack(error: unknown): string | undefined;
+/**
+ * Create error context builder
+ * @returns New error context builder
+ */
+export declare function createErrorContext(): ErrorContext;
+/**
+ * Handle and log errors consistently
+ * @param error - Error to handle
+ * @param logger - Logger instance
+ * @param context - Additional context
+ */
+export declare function handleError(error: unknown, logger: {
+    error: (message: string, ...args: unknown[]) => void;
+}, context?: Record<string, unknown>): void;
+/**
+ * Wrap async function with error handling
+ * @param fn - Function to wrap
+ * @param errorHandler - Error handler function
+ * @returns Wrapped function
+ */
+export declare function withErrorHandling<T extends unknown[], R>(fn: (...args: T) => Promise<R>, errorHandler: (error: unknown, ...args: T) => void): (...args: T) => Promise<R | undefined>;
+/**
+ * Error handling strategy configuration
+ */
+export interface ErrorHandlingStrategy {
+    /** Whether to fail silently or throw errors */
+    failSilent: boolean;
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Base delay for retries in milliseconds */
+    baseDelay: number;
+    /** Whether to log errors */
+    logErrors: boolean;
+}
+/**
+ * Default error handling strategy
+ */
+export declare const DEFAULT_ERROR_STRATEGY: ErrorHandlingStrategy;
+/**
+ * Result of an operation that may fail
+ */
+export interface OperationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    retryCount?: number;
+}
+/**
+ * Execute operation with consistent error handling
+ * @param fn - Function to execute
+ * @param strategy - Error handling strategy
+ * @param logger - Logger instance
+ * @param context - Additional context for logging
+ * @returns Operation result
+ */
+export declare function executeWithErrorHandling<T>(fn: () => Promise<T>, strategy?: ErrorHandlingStrategy, logger?: {
+    error: (message: string, context?: Record<string, unknown>) => void;
+}, context?: Record<string, unknown>): Promise<OperationResult<T>>;
+/**
+ * Retry function with exponential backoff
+ * @param fn - Function to retry
+ * @param maxRetries - Maximum number of retries
+ * @param baseDelay - Base delay in milliseconds
+ * @returns Promise that resolves with function result or rejects with last error
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, maxRetries?: number, baseDelay?: number): Promise<T>;
+//# sourceMappingURL=error-handling.d.ts.map

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

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