@revenium/litellm 0.0.1

package/dist/utils/error-handling.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * Error handling utilities for consistent error management
+ *
+ * This module provides centralized error handling and custom error types
+ * for better error reporting and debugging.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ERROR_STRATEGY = exports.ErrorContext = exports.StreamProcessingError = exports.ValidationError = exports.ReveniumApiError = exports.RequestProcessingError = exports.PatchingError = exports.ConfigurationError = exports.ReveniumError = void 0;
+exports.getErrorMessage = getErrorMessage;
+exports.getErrorStack = getErrorStack;
+exports.createErrorContext = createErrorContext;
+exports.handleError = handleError;
+exports.withErrorHandling = withErrorHandling;
+exports.executeWithErrorHandling = executeWithErrorHandling;
+exports.withRetry = withRetry;
+/**
+ * Base error class for Revenium middleware errors
+ */
+class ReveniumError extends Error {
+    constructor(message, code, context) {
+        super(message);
+        this.name = 'ReveniumError';
+        this.code = code;
+        this.context = context;
+        // Maintain proper stack trace for where our error was thrown
+        if (Error.captureStackTrace)
+            Error.captureStackTrace(this, ReveniumError);
+    }
+}
+exports.ReveniumError = ReveniumError;
+/**
+ * Configuration-related errors
+ */
+class ConfigurationError extends ReveniumError {
+    constructor(message, context) {
+        super(message, 'CONFIGURATION_ERROR', context);
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+/**
+ * HTTP client patching errors
+ */
+class PatchingError extends ReveniumError {
+    constructor(message, context) {
+        super(message, 'PATCHING_ERROR', context);
+        this.name = 'PatchingError';
+    }
+}
+exports.PatchingError = PatchingError;
+/**
+ * Request processing errors
+ */
+class RequestProcessingError extends ReveniumError {
+    constructor(message, context) {
+        super(message, 'REQUEST_PROCESSING_ERROR', context);
+        this.name = 'RequestProcessingError';
+    }
+}
+exports.RequestProcessingError = RequestProcessingError;
+/**
+ * Revenium API communication errors
+ */
+class ReveniumApiError extends ReveniumError {
+    constructor(message, statusCode, responseBody, context) {
+        super(message, 'REVENIUM_API_ERROR', context);
+        this.name = 'ReveniumApiError';
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+exports.ReveniumApiError = ReveniumApiError;
+/**
+ * Validation errors
+ */
+class ValidationError extends ReveniumError {
+    constructor(message, validationErrors, context) {
+        super(message, 'VALIDATION_ERROR', context);
+        this.name = 'ValidationError';
+        this.validationErrors = validationErrors;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Stream processing errors
+ */
+class StreamProcessingError extends ReveniumError {
+    constructor(message, context) {
+        super(message, 'STREAM_PROCESSING_ERROR', context);
+        this.name = 'StreamProcessingError';
+    }
+}
+exports.StreamProcessingError = StreamProcessingError;
+/**
+ * Error context builder for consistent error reporting
+ */
+class ErrorContext {
+    constructor() {
+        this.context = {};
+    }
+    /**
+     * Add request ID to error context
+     */
+    withRequestId(requestId) {
+        this.context.requestId = requestId;
+        return this;
+    }
+    /**
+     * Add model information to error context
+     */
+    withModel(model) {
+        this.context.model = model;
+        return this;
+    }
+    /**
+     * Add URL to error context
+     */
+    withUrl(url) {
+        this.context.url = url;
+        return this;
+    }
+    /**
+     * Add HTTP status to error context
+     */
+    withStatus(status) {
+        this.context.status = status;
+        return this;
+    }
+    /**
+     * Add duration to error context
+     */
+    withDuration(duration) {
+        this.context.duration = duration;
+        return this;
+    }
+    /**
+     * Add custom field to error context
+     */
+    with(key, value) {
+        this.context[key] = value;
+        return this;
+    }
+    /**
+     * Build the context object
+     */
+    build() {
+        return { ...this.context };
+    }
+}
+exports.ErrorContext = ErrorContext;
+/**
+ * Safe error message extraction
+ * @param error - Error to extract message from
+ * @returns Safe error message string
+ */
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    if (error && typeof error === 'object' && 'message' in error) {
+        const message = error.message;
+        if (typeof message === 'string') {
+            return message;
+        }
+    }
+    return 'Unknown error occurred';
+}
+/**
+ * Safe error stack extraction
+ * @param error - Error to extract stack from
+ * @returns Error stack or undefined
+ */
+function getErrorStack(error) {
+    if (error instanceof Error && error.stack)
+        return error.stack;
+    return;
+}
+/**
+ * Create error context builder
+ * @returns New error context builder
+ */
+function createErrorContext() {
+    return new ErrorContext();
+}
+/**
+ * Handle and log errors consistently
+ * @param error - Error to handle
+ * @param logger - Logger instance
+ * @param context - Additional context
+ */
+function handleError(error, logger, context) {
+    const message = getErrorMessage(error);
+    const stack = getErrorStack(error);
+    const logContext = {
+        ...context,
+        error: message,
+        stack: stack
+    };
+    if (error instanceof ReveniumError) {
+        logContext.errorCode = error.code;
+        logContext.errorContext = error.context;
+        if (error instanceof ReveniumApiError) {
+            logContext.statusCode = error.statusCode;
+            logContext.responseBody = error.responseBody;
+        }
+        if (error instanceof ValidationError) {
+            logContext.validationErrors = error.validationErrors;
+        }
+    }
+    logger.error('Error occurred', logContext);
+}
+/**
+ * Wrap async function with error handling
+ * @param fn - Function to wrap
+ * @param errorHandler - Error handler function
+ * @returns Wrapped function
+ */
+function withErrorHandling(fn, errorHandler) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (error) {
+            errorHandler(error, ...args);
+            return undefined;
+        }
+    };
+}
+/**
+ * Default error handling strategy
+ */
+exports.DEFAULT_ERROR_STRATEGY = {
+    failSilent: true,
+    maxRetries: 3,
+    baseDelay: 1000,
+    logErrors: true
+};
+/**
+ * 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
+ */
+async function executeWithErrorHandling(fn, strategy = exports.DEFAULT_ERROR_STRATEGY, logger, context) {
+    let lastError;
+    for (let attempt = 0; attempt <= strategy.maxRetries; attempt++) {
+        try {
+            const result = await fn();
+            return {
+                success: true,
+                data: result,
+                retryCount: attempt
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (strategy.logErrors && logger) {
+                logger.error(`Operation failed (attempt ${attempt + 1}/${strategy.maxRetries + 1})`, {
+                    ...context,
+                    error: lastError.message,
+                    stack: lastError.stack,
+                    attempt: attempt + 1
+                });
+            }
+            if (attempt === strategy.maxRetries) {
+                break;
+            }
+            // Exponential backoff with jitter
+            const delay = Math.min(strategy.baseDelay * Math.pow(2, attempt), 5000);
+            const jitter = Math.random() * 0.1 * delay;
+            await new Promise(resolve => setTimeout(resolve, delay + jitter));
+        }
+    }
+    const result = {
+        success: false,
+        error: lastError,
+        retryCount: strategy.maxRetries + 1
+    };
+    if (!strategy.failSilent && lastError)
+        throw lastError;
+    return result;
+}
+/**
+ * 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
+ */
+async function withRetry(fn, maxRetries = 3, baseDelay = 1000) {
+    const strategy = {
+        failSilent: false,
+        maxRetries,
+        baseDelay,
+        logErrors: false
+    };
+    const result = await executeWithErrorHandling(fn, strategy);
+    if (result.success && result.data)
+        return result.data;
+    throw result.error || new Error('Operation failed');
+}
+//# sourceMappingURL=error-handling.js.map

package/dist/utils/error-handling.js.map

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

package/dist/utils/logger-types.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Enhanced logger types and utilities
+ *
+ * This module provides type-safe logging interfaces and utilities
+ * to replace 'any' usage in logger implementations.
+ */
+/**
+ * Supported log levels
+ */
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARNING = "WARNING",
+    ERROR = "ERROR"
+}
+/**
+ * Serializable log data types
+ */
+export type LogData = string | number | boolean | null | undefined | LogData[] | {
+    [key: string]: LogData;
+};
+/**
+ * Log context object with known structure
+ */
+export interface LogContext {
+    /** Request identifier */
+    requestId?: string;
+    /** Model being used */
+    model?: string;
+    /** URL being accessed */
+    url?: string;
+    /** HTTP status code */
+    status?: number;
+    /** Request duration in milliseconds */
+    duration?: number;
+    /** Error message */
+    error?: string;
+    /** Error stack trace */
+    stack?: string;
+    /** Token counts */
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    /** Provider information */
+    provider?: string;
+    /** Additional structured data */
+    [key: string]: LogData;
+}
+/**
+ * Enhanced logger interface with type safety
+ */
+export interface TypeSafeLogger {
+    /**
+     * Log debug message
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log info message
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log warning message
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log error message
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    error(message: string, context?: LogContext): void;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Whether to include timestamps */
+    includeTimestamp: boolean;
+    /** Whether to format output as JSON */
+    jsonFormat: boolean;
+    /** Custom prefix for log messages */
+    prefix: string;
+}
+/**
+ * Default logger configuration
+ */
+export declare const DEFAULT_LOGGER_CONFIG: LoggerConfig;
+/**
+ * Check if a log level should be output based on configuration
+ * @param level - Log level to check
+ * @param configLevel - Configured minimum log level
+ * @returns True if the level should be logged
+ */
+export declare function shouldLog(level: LogLevel, configLevel: LogLevel): boolean;
+/**
+ * Format log context for output
+ * @param context - Log context to format
+ * @param jsonFormat - Whether to format as JSON
+ * @returns Formatted context string
+ */
+export declare function formatLogContext(context: LogContext | undefined, jsonFormat: boolean): string;
+/**
+ * Create a timestamp string
+ * @returns ISO timestamp string
+ */
+export declare function createTimestamp(): string;
+/**
+ * Sanitize log data to ensure it's serializable
+ * @param data - Data to sanitize
+ * @returns Sanitized data
+ */
+export declare function sanitizeLogData(data: unknown): LogData;
+/**
+ * Create a type-safe logger context builder
+ */
+export declare class LogContextBuilder {
+    private context;
+    /**
+     * Add request ID to context
+     */
+    withRequestId(requestId: string): this;
+    /**
+     * Add model to context
+     */
+    withModel(model: string): this;
+    /**
+     * Add URL to context
+     */
+    withUrl(url: string): this;
+    /**
+     * Add HTTP status to context
+     */
+    withStatus(status: number): this;
+    /**
+     * Add duration to context
+     */
+    withDuration(duration: number): this;
+    /**
+     * Add error information to context
+     */
+    withError(error: string, stack?: string): this;
+    /**
+     * Add token counts to context
+     */
+    withTokens(prompt: number, completion: number, total: number): this;
+    /**
+     * Add provider to context
+     */
+    withProvider(provider: string): this;
+    /**
+     * Add custom field to context
+     */
+    with(key: string, value: LogData): this;
+    /**
+     * Build the context object
+     */
+    build(): LogContext;
+}
+/**
+ * Create a new log context builder
+ * @returns New log context builder instance
+ */
+export declare function createLogContext(): LogContextBuilder;
+//# sourceMappingURL=logger-types.d.ts.map

package/dist/utils/logger-types.d.ts.map

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

package/dist/utils/logger-types.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Enhanced logger types and utilities
+ *
+ * This module provides type-safe logging interfaces and utilities
+ * to replace 'any' usage in logger implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogContextBuilder = exports.DEFAULT_LOGGER_CONFIG = exports.LogLevel = void 0;
+exports.shouldLog = shouldLog;
+exports.formatLogContext = formatLogContext;
+exports.createTimestamp = createTimestamp;
+exports.sanitizeLogData = sanitizeLogData;
+exports.createLogContext = createLogContext;
+/**
+ * Supported log levels
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARNING"] = "WARNING";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Log level hierarchy for filtering
+ */
+const LOG_LEVEL_HIERARCHY = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.WARNING]: 2,
+    [LogLevel.ERROR]: 3
+};
+/**
+ * Default logger configuration
+ */
+exports.DEFAULT_LOGGER_CONFIG = {
+    level: LogLevel.INFO,
+    includeTimestamp: true,
+    jsonFormat: false,
+    prefix: '[Revenium LiteLLM]'
+};
+/**
+ * Check if a log level should be output based on configuration
+ * @param level - Log level to check
+ * @param configLevel - Configured minimum log level
+ * @returns True if the level should be logged
+ */
+function shouldLog(level, configLevel) {
+    return LOG_LEVEL_HIERARCHY[level] >= LOG_LEVEL_HIERARCHY[configLevel];
+}
+/**
+ * Format log context for output
+ * @param context - Log context to format
+ * @param jsonFormat - Whether to format as JSON
+ * @returns Formatted context string
+ */
+function formatLogContext(context, jsonFormat) {
+    if (!context || Object.keys(context).length === 0)
+        return '';
+    if (jsonFormat) {
+        try {
+            return JSON.stringify(context);
+        }
+        catch {
+            return '[Invalid JSON context]';
+        }
+    }
+    // Format as key-value pairs
+    const pairs = Object.entries(context)
+        .filter(([, value]) => value)
+        .map(([key, value]) => {
+        if (typeof value === 'object') {
+            try {
+                return `${key}=${JSON.stringify(value)}`;
+            }
+            catch {
+                return `${key}=[object]`;
+            }
+        }
+        return `${key}=${value}`;
+    });
+    return pairs.length > 0 ? ` ${pairs.join(' ')}` : '';
+}
+/**
+ * Create a timestamp string
+ * @returns ISO timestamp string
+ */
+function createTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Sanitize log data to ensure it's serializable
+ * @param data - Data to sanitize
+ * @returns Sanitized data
+ */
+function sanitizeLogData(data) {
+    if (Array.isArray(data))
+        return data.map(sanitizeLogData);
+    if (data === null)
+        return data;
+    if (typeof data === 'object') {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(data)) {
+            // Skip functions and symbols
+            if (typeof value === 'function' || typeof value === 'symbol')
+                continue;
+            // Handle circular references and complex objects
+            try {
+                sanitized[key] = sanitizeLogData(value);
+            }
+            catch {
+                sanitized[key] = '[Circular or Complex Object]';
+            }
+        }
+        return sanitized;
+    }
+    // Fallback for other types
+    return String(data);
+}
+/**
+ * Create a type-safe logger context builder
+ */
+class LogContextBuilder {
+    constructor() {
+        this.context = {};
+    }
+    /**
+     * Add request ID to context
+     */
+    withRequestId(requestId) {
+        this.context.requestId = requestId;
+        return this;
+    }
+    /**
+     * Add model to context
+     */
+    withModel(model) {
+        this.context.model = model;
+        return this;
+    }
+    /**
+     * Add URL to context
+     */
+    withUrl(url) {
+        this.context.url = url;
+        return this;
+    }
+    /**
+     * Add HTTP status to context
+     */
+    withStatus(status) {
+        this.context.status = status;
+        return this;
+    }
+    /**
+     * Add duration to context
+     */
+    withDuration(duration) {
+        this.context.duration = duration;
+        return this;
+    }
+    /**
+     * Add error information to context
+     */
+    withError(error, stack) {
+        this.context.error = error;
+        if (stack)
+            this.context.stack = stack;
+        return this;
+    }
+    /**
+     * Add token counts to context
+     */
+    withTokens(prompt, completion, total) {
+        this.context.promptTokens = prompt;
+        this.context.completionTokens = completion;
+        this.context.totalTokens = total;
+        return this;
+    }
+    /**
+     * Add provider to context
+     */
+    withProvider(provider) {
+        this.context.provider = provider;
+        return this;
+    }
+    /**
+     * Add custom field to context
+     */
+    with(key, value) {
+        this.context[key] = value;
+        return this;
+    }
+    /**
+     * Build the context object
+     */
+    build() {
+        return { ...this.context };
+    }
+}
+exports.LogContextBuilder = LogContextBuilder;
+/**
+ * Create a new log context builder
+ * @returns New log context builder instance
+ */
+function createLogContext() {
+    return new LogContextBuilder();
+}
+//# sourceMappingURL=logger-types.js.map