@revenium/openai 1.0.8

package/dist/esm/utils/error-handler.js

@@ -0,0 +1,182 @@
+/**
+ * Error Handler Utilities
+ *
+ * Centralized error handling patterns to eliminate repetitive try/catch blocks
+ * and provide consistent error logging and recovery strategies.
+ */
+import { ERROR_MESSAGE_PATTERNS_TYPE_CONFIG, MESSAGE_PATTERNS_TYPE_NETWORK } from './constants.js';
+/**
+ * Default error handling strategy
+ */
+const DEFAULT_STRATEGY = {
+    logError: true,
+    rethrow: true,
+    messagePrefix: '',
+    fallbackValue: undefined,
+    transformError: (error) => (error instanceof Error ? error : new Error(String(error))),
+};
+/**
+ * Safe async operation wrapper with comprehensive error handling
+ *
+ * @param operation - The async operation to execute
+ * @param context - Context information for logging
+ * @param strategy - Error handling strategy
+ * @param logger - Logger instance
+ * @returns Promise with result or fallback value
+ */
+export async function safeAsyncOperation(operation, context, strategy = {}, logger) {
+    const config = { ...DEFAULT_STRATEGY, ...strategy };
+    try {
+        return await operation();
+    }
+    catch (error) {
+        const transformedError = config.transformError(error);
+        if (config.logError && logger) {
+            logger.error(`${config.messagePrefix}${context}`, {
+                error: transformedError.message,
+                stack: transformedError.stack,
+            });
+        }
+        if (config.rethrow)
+            throw transformedError;
+        return config.fallbackValue;
+    }
+}
+/**
+ * Safe sync operation wrapper
+ *
+ * @param operation - The sync operation to execute
+ * @param context - Context information for logging
+ * @param strategy - Error handling strategy
+ * @param logger - Logger instance
+ * @returns Result or fallback value
+ */
+export function safeSyncOperation(operation, context, strategy = {}, logger) {
+    const config = { ...DEFAULT_STRATEGY, ...strategy };
+    try {
+        return operation();
+    }
+    catch (error) {
+        const transformedError = config.transformError(error);
+        if (config.logError && logger) {
+            logger.error(`${config.messagePrefix}${context}`, {
+                error: transformedError.message,
+                stack: transformedError.stack,
+            });
+        }
+        if (config.rethrow)
+            throw transformedError;
+        return config.fallbackValue;
+    }
+}
+/**
+ * Validation wrapper that provides clear error messages
+ *
+ * @param value - Value to validate
+ * @param validator - Validation function
+ * @param errorMessage - Error message if validation fails
+ * @returns Validated value
+ */
+export function validateOrThrow(value, validator, errorMessage) {
+    if (!validator(value))
+        throw new Error(errorMessage);
+    return value;
+}
+/**
+ * Validation wrapper that returns undefined on failure
+ *
+ * @param value - Value to validate
+ * @param validator - Validation function
+ * @param logger - Optional logger for warnings
+ * @param context - Context for logging
+ * @returns Validated value or undefined
+ */
+export function validateOrUndefined(value, validator, logger, context) {
+    if (!validator(value)) {
+        if (logger && context) {
+            logger.warn(`Validation failed: ${context}`, { value });
+        }
+        return;
+    }
+    return value;
+}
+/**
+ * Create a retry wrapper for operations that might fail temporarily
+ *
+ * @param operation - Operation to retry
+ * @param maxRetries - Maximum number of retries
+ * @param delayMs - Delay between retries in milliseconds
+ * @param logger - Logger for retry attempts
+ * @returns Promise with operation result
+ */
+export async function withRetry(operation, maxRetries = 3, delayMs = 1000, logger) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxRetries) {
+                break;
+            }
+            if (logger) {
+                logger.warn(`Operation failed, retrying (${attempt}/${maxRetries})`, {
+                    error: lastError.message,
+                    nextRetryIn: delayMs,
+                });
+            }
+            await new Promise(resolve => setTimeout(resolve, delayMs));
+        }
+    }
+    // eslint-disable-next-line no-throw-literal
+    throw lastError;
+}
+/**
+ * Common error types for better error handling
+ */
+export class ValidationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ValidationError';
+    }
+}
+export class ConfigurationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ConfigurationError';
+    }
+}
+export class NetworkError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Error classification utility
+ */
+export function classifyError(error) {
+    if (error instanceof ValidationError) {
+        return { type: 'validation', message: error.message, isRetryable: false };
+    }
+    if (error instanceof ConfigurationError) {
+        return { type: 'configuration', message: error.message, isRetryable: false };
+    }
+    if (error instanceof NetworkError) {
+        return { type: 'network', message: error.message, isRetryable: true };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    // Classify based on message patterns
+    if (MESSAGE_PATTERNS_TYPE_NETWORK.some(pattern => message.includes(pattern))) {
+        return { type: 'network', message, isRetryable: true };
+    }
+    if (ERROR_MESSAGE_PATTERNS_TYPE_CONFIG.some(pattern => message.includes(pattern))) {
+        return { type: 'configuration', message, isRetryable: false };
+    }
+    return { type: 'unknown', message, isRetryable: false };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/esm/utils/error-handler.js.map

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

package/dist/esm/utils/metadata-builder.js

@@ -0,0 +1,176 @@
+/**
+ * Metadata Builder Utilities
+ *
+ * Centralized metadata handling to eliminate repetitive spreading
+ * and provide consistent metadata processing across the codebase.
+ */
+/**
+ * Metadata mapping configuration
+ * Maps UsageMetadata fields to payload fields with optional transformations
+ * Subscriber object is passed through directly without transformation
+ */
+const METADATA_FIELD_MAP = [
+    { source: 'traceId' },
+    { source: 'taskType' },
+    { source: 'agent' },
+    { source: 'organizationId' },
+    { source: 'productId' },
+    { source: 'subscriber' }, // Pass through nested subscriber object directly
+    { source: 'subscriptionId' },
+    {
+        source: 'responseQualityScore',
+        transform: (value) => {
+            // Ensure quality score is between 0 and 1
+            if (typeof value === 'number')
+                return Math.max(0, Math.min(1, value));
+            return value;
+        },
+    },
+];
+/**
+ * Build metadata object for payload inclusion
+ *
+ * This function eliminates the repetitive spreading pattern and provides
+ * a clean, testable way to handle metadata transformation.
+ * Subscriber object is passed through directly without transformation.
+ *
+ * @param usageMetadata - Source metadata from request
+ * @returns Clean metadata object for payload
+ */
+export function buildMetadataFields(usageMetadata) {
+    if (!usageMetadata)
+        return {};
+    const result = {};
+    // Process all metadata fields including nested subscriber object
+    for (const config of METADATA_FIELD_MAP) {
+        const value = usageMetadata[config.source];
+        // Skip undefined values (but allow null, empty strings, objects, etc.)
+        if (value === undefined)
+            continue;
+        // Apply transformation if configured
+        const transformedValue = config.transform ? config.transform(value) : value;
+        // Use target field name or default to source
+        const targetField = config.target || config.source;
+        result[targetField] = transformedValue;
+    }
+    return result;
+}
+/**
+ * Validate metadata completeness for specific use cases
+ *
+ * @param usageMetadata - Metadata to validate
+ * @param requiredFields - List of required field names
+ * @returns Validation result
+ */
+export function validateMetadata(usageMetadata, requiredFields = []) {
+    const missingFields = [];
+    const warnings = [];
+    if (!usageMetadata && requiredFields.length > 0) {
+        return {
+            isValid: false,
+            missingFields: requiredFields,
+            warnings: ['No metadata provided'],
+        };
+    }
+    if (usageMetadata) {
+        // Check required fields
+        for (const field of requiredFields) {
+            if (!usageMetadata[field])
+                missingFields.push(String(field));
+        }
+        // Check for common issues
+        if (usageMetadata.responseQualityScore) {
+            const score = usageMetadata.responseQualityScore;
+            if (typeof score !== 'number' || score < 0 || score > 1) {
+                warnings.push('responseQualityScore should be a number between 0 and 1');
+            }
+        }
+        if (usageMetadata.subscriber?.email && !usageMetadata.subscriber.email.includes('@')) {
+            warnings.push('subscriber.email does not appear to be a valid email address');
+        }
+    }
+    return {
+        isValid: missingFields.length === 0,
+        missingFields,
+        warnings,
+    };
+}
+/**
+ * Merge multiple metadata sources with priority
+ *
+ * @param sources - Metadata sources in priority order (first wins)
+ * @returns Merged metadata object
+ */
+export function mergeMetadata(...sources) {
+    const result = {};
+    // Process sources in reverse order so first source wins
+    for (const source of sources.reverse()) {
+        if (source)
+            Object.assign(result, source);
+    }
+    return result;
+}
+/**
+ * Extract metadata from request parameters safely
+ *
+ * @param params - Request parameters that might contain usageMetadata
+ * @returns Extracted metadata and cleaned parameters
+ */
+export function extractMetadata(params) {
+    const { usageMetadata, ...cleanParams } = params;
+    return {
+        metadata: usageMetadata,
+        cleanParams: cleanParams,
+    };
+}
+/**
+ * Create a metadata context for consistent logging
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Logging context object
+ */
+export function createLoggingContext(usageMetadata) {
+    if (!usageMetadata)
+        return {};
+    return {
+        traceId: usageMetadata.traceId,
+        taskType: usageMetadata.taskType,
+        subscriberId: usageMetadata.subscriber?.id,
+        subscriberEmail: usageMetadata.subscriber?.email,
+        organizationId: usageMetadata.organizationId,
+        productId: usageMetadata.productId,
+        agent: usageMetadata.agent,
+    };
+}
+/**
+ * Sanitize metadata for logging (remove sensitive fields)
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Sanitized metadata safe for logging
+ */
+export function sanitizeMetadataForLogging(usageMetadata) {
+    if (!usageMetadata)
+        return {};
+    // Create a copy and handle nested subscriber object
+    const { subscriber, ...safeMetadata } = usageMetadata;
+    const result = { ...safeMetadata };
+    // Sanitize subscriber object if present
+    if (subscriber) {
+        const sanitizedSubscriber = {};
+        if (subscriber.id) {
+            sanitizedSubscriber.id = subscriber.id;
+        }
+        if (subscriber.email) {
+            sanitizedSubscriber.email = subscriber.email.replace(/(.{2}).*(@.*)/, '$1***$2');
+        }
+        if (subscriber.credential) {
+            sanitizedSubscriber.credential = {
+                name: subscriber.credential.name,
+                value: '[REDACTED]',
+            };
+        }
+        result.subscriber = sanitizedSubscriber;
+    }
+    return result;
+}
+//# sourceMappingURL=metadata-builder.js.map

package/dist/esm/utils/metadata-builder.js.map

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

package/dist/esm/utils/provider-detection.js

@@ -0,0 +1,206 @@
+/**
+ * Provider Detection Utilities
+ *
+ * Simplifies complex provider detection logic using strategy pattern
+ * instead of nested conditionals.
+ */
+import { Provider } from '../types/index.js';
+/**
+ * Provider detection strategies in priority order
+ */
+const DETECTION_STRATEGIES = [
+    {
+        name: 'Constructor Name',
+        priority: 100,
+        detect: client => {
+            return client?.constructor?.name?.includes('Azure') || false;
+        },
+        getContext: client => ({
+            constructorName: client?.constructor?.name,
+        }),
+    },
+    {
+        name: 'Base URL',
+        priority: 90,
+        detect: client => {
+            const baseUrl = getBaseUrlString(client);
+            return baseUrl?.toLowerCase().includes('azure') || false;
+        },
+        getContext: client => ({
+            baseURL: getBaseUrlString(client),
+        }),
+    },
+    {
+        name: 'Environment Variables',
+        priority: 80,
+        detect: client => {
+            // Only use env vars if not explicitly OpenAI
+            const baseUrl = getBaseUrlString(client);
+            const isExplicitlyOpenAI = baseUrl?.includes('api.openai.com') ||
+                (client?.constructor?.name?.toLowerCase().includes('openai') &&
+                    !client?.constructor?.name?.toLowerCase().includes('azure'));
+            return !isExplicitlyOpenAI && !!process.env.AZURE_OPENAI_ENDPOINT;
+        },
+        getContext: () => ({
+            hasAzureEndpoint: !!process.env.AZURE_OPENAI_ENDPOINT,
+            hasAzureDeployment: !!process.env.AZURE_OPENAI_DEPLOYMENT,
+            hasAzureApiKey: !!process.env.AZURE_OPENAI_API_KEY,
+        }),
+    },
+];
+/**
+ * Extract base URL as string from client
+ */
+function getBaseUrlString(client) {
+    if (!client?.baseURL)
+        return undefined;
+    return typeof client.baseURL === 'string' ? client.baseURL : client.baseURL.toString();
+}
+/**
+ * Detect provider using strategy pattern
+ *
+ * This replaces the complex nested conditional logic with a clean,
+ * testable strategy pattern.
+ *
+ * @param client - OpenAI client instance
+ * @param logger - Logger for debugging
+ * @returns Provider detection result
+ */
+export function detectProviderStrategy(client, logger) {
+    // Sort strategies by priority (highest first)
+    const sortedStrategies = [...DETECTION_STRATEGIES].sort((a, b) => b.priority - a.priority);
+    for (const strategy of sortedStrategies) {
+        try {
+            if (strategy.detect(client)) {
+                const context = strategy.getContext?.(client) || {};
+                if (logger) {
+                    logger.debug(`Azure provider detected via ${strategy.name}`, context);
+                }
+                return {
+                    provider: Provider.AZURE_OPENAI,
+                    strategy: strategy.name,
+                    context,
+                };
+            }
+        }
+        catch (error) {
+            if (logger) {
+                logger.warn(`Provider detection strategy '${strategy.name}' failed`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    // Default to OpenAI
+    if (logger) {
+        logger.debug('Standard OpenAI provider detected (no Azure indicators found)');
+    }
+    return { provider: Provider.OPENAI };
+}
+const AZURE_CONFIG_STRATEGIES = [
+    {
+        name: 'Client BaseURL',
+        gather: client => {
+            const baseUrl = getBaseUrlString(client);
+            return baseUrl ? { endpoint: baseUrl } : {};
+        },
+    },
+    {
+        name: 'Environment Variables',
+        gather: () => ({
+            endpoint: process.env.AZURE_OPENAI_ENDPOINT,
+            deployment: process.env.AZURE_OPENAI_DEPLOYMENT,
+            apiVersion: process.env.AZURE_OPENAI_API_VERSION || '2024-12-01-preview',
+            apiKey: process.env.AZURE_OPENAI_API_KEY,
+            tenantId: process.env.AZURE_OPENAI_TENANT_ID,
+            resourceGroup: process.env.AZURE_OPENAI_RESOURCE_GROUP,
+        }),
+    },
+];
+/**
+ * Gather Azure configuration using strategy pattern
+ *
+ * @param client - OpenAI client instance
+ * @param logger - Logger for debugging
+ * @returns Merged Azure configuration
+ */
+export function gatherAzureConfigStrategy(client, logger) {
+    const config = {};
+    for (const strategy of AZURE_CONFIG_STRATEGIES) {
+        try {
+            const strategyConfig = strategy.gather(client);
+            // Merge non-undefined values
+            Object.entries(strategyConfig).forEach(([key, value]) => {
+                if (value !== undefined && !(key in config)) {
+                    config[key] = value;
+                }
+            });
+        }
+        catch (error) {
+            if (logger) {
+                logger.warn(`Azure config strategy '${strategy.name}' failed`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    if (logger) {
+        logger.debug('Azure configuration gathered', {
+            hasEndpoint: !!config.endpoint,
+            hasDeployment: !!config.deployment,
+            hasApiKey: !!config.apiKey,
+            apiVersion: config.apiVersion,
+        });
+    }
+    return config;
+}
+/**
+ * Create complete provider info using strategies
+ *
+ * @param client - OpenAI client instance
+ * @param logger - Logger for debugging
+ * @returns Complete provider information
+ */
+export function createProviderInfo(client, logger) {
+    const detection = detectProviderStrategy(client, logger);
+    if (detection.provider === Provider.AZURE_OPENAI) {
+        const azureConfig = gatherAzureConfigStrategy(client, logger);
+        return {
+            provider: detection.provider,
+            isAzure: true,
+            azureConfig,
+        };
+    }
+    return {
+        provider: detection.provider,
+        isAzure: false,
+        azureConfig: undefined,
+    };
+}
+/**
+ * Validate provider detection result
+ *
+ * @param providerInfo - Provider info to validate
+ * @returns Validation result
+ */
+export function validateProviderInfo(providerInfo) {
+    const warnings = [];
+    if (providerInfo.isAzure) {
+        if (!providerInfo.azureConfig) {
+            warnings.push('Azure provider detected but no Azure configuration available');
+        }
+        else {
+            if (!providerInfo.azureConfig.endpoint) {
+                warnings.push('Azure configuration missing endpoint');
+            }
+            if (!providerInfo.azureConfig.apiKey) {
+                warnings.push('Azure configuration missing API key');
+            }
+        }
+    }
+    return {
+        isValid: warnings.length === 0,
+        warnings,
+    };
+}
+//# sourceMappingURL=provider-detection.js.map

package/dist/esm/utils/provider-detection.js.map

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