@revenium/openai 1.0.8

package/dist/cjs/types/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Core Types Module
+ *
+ * Central type definitions for the Revenium OpenAI middleware.
+ * This module exports all core types used throughout the application.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Provider = void 0;
+// Re-export function parameter types
+__exportStar(require("./function-parameters.js"), exports);
+// Re-export Responses API types
+__exportStar(require("./responses-api.js"), exports);
+/**
+ * Supported AI providers
+ *
+ * Enumeration of AI providers supported by the Revenium middleware.
+ * Used for automatic detection, routing, and provider-specific handling.
+ *
+ * @public
+ * @example
+ * ```typescript
+ * if (providerInfo.provider === Provider.AZURE_OPENAI) {
+ *   console.log('Using Azure OpenAI');
+ * }
+ * ```
+ */
+var Provider;
+(function (Provider) {
+    /** Standard OpenAI API */
+    Provider["OPENAI"] = "OPENAI";
+    /** Azure OpenAI Service */
+    Provider["AZURE_OPENAI"] = "AZURE_OPENAI";
+})(Provider || (exports.Provider = Provider = {}));
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,qCAAqC;AACrC,2DAAyC;AAEzC,gCAAgC;AAChC,qDAAmC;AA0InC;;;;;;;;;;;;;GAaG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,0BAA0B;IAC1B,6BAAiB,CAAA;IACjB,2BAA2B;IAC3B,yCAA6B,CAAA;AAC/B,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}

package/dist/cjs/types/openai-augmentation.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * TypeScript module augmentation for OpenAI SDK
+ *
+ * This file extends OpenAI's existing types to include the usageMetadata field
+ * through TypeScript's declaration merging feature. This provides seamless
+ * integration with the OpenAI SDK, allowing developers to use usageMetadata
+ * directly in OpenAI API calls without type casting or additional imports.
+ *
+ * The augmentation covers all major OpenAI API endpoints including:
+ * - Chat completions (streaming and non-streaming)
+ * - Embeddings
+ * - Future API endpoints as they become available
+ *
+ * @fileoverview OpenAI SDK type augmentation for Revenium middleware
+ * @author Revenium
+ * @since 1.0.0
+ *
+ * @example Basic usage with chat completions
+ * ```typescript
+ * import 'revenium-middleware-openai-node';
+ * import OpenAI from 'openai';
+ *
+ * const openai = new OpenAI();
+ *
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4o-mini',
+ *   messages: [{ role: 'user', content: 'Hello!' }],
+ *   usageMetadata: {  // TypeScript recognizes this natively
+ *     subscriber: {
+ *       id: 'user-123',
+ *       email: 'user@my-company.com'
+ *     },
+ *     organizationId: 'my-company',
+ *     productId: 'chat-app',
+ *     taskType: 'customer-support'
+ *   }
+ * });
+ * ```
+ *
+ * @example Usage with embeddings
+ * ```typescript
+ * const embedding = await openai.embeddings.create({
+ *   model: 'text-embedding-ada-002',
+ *   input: 'Text to embed',
+ *   usageMetadata: {
+ *     subscriber: { id: 'user-456' },
+ *     productId: 'search-engine',
+ *     taskType: 'document-indexing'
+ *   }
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=openai-augmentation.js.map

package/dist/cjs/types/openai-augmentation.js.map

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

package/dist/cjs/types/responses-api.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Types for OpenAI Responses API support
+ *
+ * This module defines types for the new OpenAI Responses API that replaces
+ * the traditional Chat Completions API. The Responses API provides a unified
+ * interface for building agent-like applications with built-in tools and capabilities.
+ *
+ * Reference: https://platform.openai.com/docs/guides/migrate-to-responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isResponsesRequest = isResponsesRequest;
+exports.isResponsesResponse = isResponsesResponse;
+/**
+ * Type guard to check if a request is for Responses API
+ */
+function isResponsesRequest(params) {
+    return typeof params === 'object' && params !== null && 'input' in params && 'model' in params;
+}
+/**
+ * Type guard to check if a response is from Responses API
+ */
+function isResponsesResponse(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'id' in response &&
+        'model' in response &&
+        ('output' in response || 'usage' in response));
+}
+//# sourceMappingURL=responses-api.js.map

package/dist/cjs/types/responses-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-api.js","sourceRoot":"","sources":["../../../src/types/responses-api.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AA2OH,gDAEC;AAKD,kDAQC;AAlBD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAe;IAChD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC;AACjG,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAAiB;IACnD,OAAO,CACL,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,IAAI,IAAI,QAAQ;QAChB,OAAO,IAAI,QAAQ;QACnB,CAAC,QAAQ,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,CAAC,CAC9C,CAAC;AACJ,CAAC"}

package/dist/cjs/utils/azure-model-resolver.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAzureModelName = resolveAzureModelName;
+exports.clearModelNameCache = clearModelNameCache;
+exports.getModelNameCacheStats = getModelNameCacheStats;
+exports.batchResolveModelNames = batchResolveModelNames;
+exports.wouldTransformDeploymentName = wouldTransformDeploymentName;
+const index_js_1 = require("../core/config/index.js");
+const constants_js_1 = require("./constants.js");
+/**
+ * Azure Model Name Resolution Module
+ *
+ * This module maps Azure deployment names to LiteLLM-compatible model names for accurate pricing.
+ * Based on learnings from the Python implementation, it uses heuristic pattern matching
+ * with fallback strategies to ensure reliable model name resolution.
+ *
+ * Key patterns observed in real Azure deployments:
+ * - "gpt-4o-2024-11-20" → "gpt-4o"
+ * - "text-embedding-3-large" → "text-embedding-3-large" (exact match)
+ * - "o4-mini" → "gpt-4o-mini"
+ * - "gpt4o-prod" → "gpt-4o"
+ * - "gpt-35-turbo-dev" → "gpt-3.5-turbo"
+ */
+/**
+ * In-memory cache for resolved model names
+ * Using Map for thread-safe operations in Node.js
+ */
+const modelNameCache = new Map();
+/**
+ * Cache for failed resolution attempts to avoid repeated warnings
+ */
+const failedResolutionCache = new Set();
+// Global logger
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Resolve Azure deployment name to LiteLLM-compatible model name
+ *
+ * @param deploymentName - Azure deployment name
+ * @param useCache - Whether to use cached results (default: true)
+ * @returns LiteLLM-compatible model name
+ */
+function resolveAzureModelName(deploymentName, useCache = true) {
+    if (!deploymentName) {
+        logger.warn('Empty deployment name provided to model resolver');
+        return deploymentName;
+    }
+    // Check cache first
+    if (useCache && modelNameCache.has(deploymentName)) {
+        const cachedResult = modelNameCache.get(deploymentName);
+        logger.debug('Model name resolved from cache', {
+            deployment: deploymentName,
+            resolved: cachedResult,
+        });
+        return cachedResult;
+    }
+    try {
+        const resolved = resolveModelNameHeuristic(deploymentName);
+        // Cache the result
+        if (useCache) {
+            modelNameCache.set(deploymentName, resolved);
+        }
+        // Log successful resolution
+        if (resolved !== deploymentName) {
+            logger.debug('Model name resolved via heuristics', {
+                deployment: deploymentName,
+                resolved,
+            });
+        }
+        return resolved;
+    }
+    catch (error) {
+        logger.error('Error during model name resolution', {
+            deployment: deploymentName,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        // Fallback to deployment name
+        return deploymentName;
+    }
+}
+/**
+ * Heuristic pattern matching for Azure deployment names
+ * Based on real-world patterns observed in the Python implementation
+ *
+ * @param deploymentName - Azure deployment name
+ * @returns LiteLLM-compatible model name
+ */
+function resolveModelNameHeuristic(deploymentName) {
+    const nameLower = deploymentName.toLowerCase();
+    // GPT-4o family - handle both "gpt-4o" and "o4" patterns
+    if (/gpt-?4o/.test(nameLower) || /o4/.test(nameLower)) {
+        if (/mini/.test(nameLower))
+            return 'gpt-4o-mini';
+        return 'gpt-4o';
+    }
+    // GPT-4 family (non-omni)
+    if (/gpt-?4(?!o)/.test(nameLower)) {
+        if (/turbo/.test(nameLower))
+            return 'gpt-4-turbo';
+        if (/vision/.test(nameLower) || /v/.test(nameLower))
+            return 'gpt-4-vision-preview';
+        return 'gpt-4';
+    }
+    // GPT-3.5 family
+    if (/gpt-?3\.?5/.test(nameLower) || /35-turbo/.test(nameLower) || /gpt-35/.test(nameLower)) {
+        if (/instruct/.test(nameLower))
+            return 'gpt-3.5-turbo-instruct';
+        return 'gpt-3.5-turbo';
+    }
+    // Embedding models - exact matches work well
+    if (/embed/.test(nameLower)) {
+        if (/text-embedding-3-large/.test(nameLower))
+            return 'text-embedding-3-large';
+        if (/text-embedding-3-small/.test(nameLower))
+            return 'text-embedding-3-small';
+        if (/text-embedding-ada-002/.test(nameLower) || /ada-002/.test(nameLower))
+            return 'text-embedding-ada-002';
+        if (/3-large/.test(nameLower))
+            return 'text-embedding-3-large';
+        if (/3-small/.test(nameLower))
+            return 'text-embedding-3-small';
+    }
+    // Ada-002 pattern (can appear without "embed" in deployment name)
+    if (/ada-002/.test(nameLower))
+        return 'text-embedding-ada-002';
+    // DALL-E models
+    if (/dall-?e/.test(nameLower)) {
+        if (/3/.test(nameLower))
+            return 'dall-e-3';
+        if (/2/.test(nameLower))
+            return 'dall-e-2';
+    }
+    // Whisper models
+    if (/whisper/.test(nameLower))
+        return 'whisper-1';
+    // TTS models
+    if (/tts/.test(nameLower)) {
+        if (/hd/.test(nameLower))
+            return 'tts-1-hd';
+        return 'tts-1';
+    }
+    if (constants_js_1.knownModels.includes(nameLower))
+        return nameLower;
+    // No heuristic match found - log warning and use deployment name
+    if (!failedResolutionCache.has(deploymentName)) {
+        logger.warn(`⚠️ No heuristic match for Azure deployment: ${deploymentName}. Using deployment name for pricing. Consider adding pattern to azure-model-resolver.ts`);
+        failedResolutionCache.add(deploymentName);
+    }
+    return deploymentName;
+}
+/**
+ * Clear the model name cache
+ * Useful for testing or when deployment configurations change
+ */
+function clearModelNameCache() {
+    modelNameCache.clear();
+    failedResolutionCache.clear();
+    (0, index_js_1.getLogger)().debug('Model name cache cleared');
+}
+/**
+ * Get cache statistics for monitoring
+ */
+function getModelNameCacheStats() {
+    return {
+        cacheSize: modelNameCache.size,
+        failedResolutionCount: failedResolutionCache.size,
+        cacheEntries: Array.from(modelNameCache.entries()).map(([deployment, resolved]) => ({
+            deployment,
+            resolved,
+        })),
+    };
+}
+/**
+ * Batch resolve multiple deployment names
+ * Useful for pre-warming cache or bulk operations
+ *
+ * @param deploymentNames - Array of deployment names to resolve
+ * @returns Map of deployment name to resolved model name
+ */
+function batchResolveModelNames(deploymentNames) {
+    const results = new Map();
+    logger.debug('Batch resolving model names', {
+        count: deploymentNames.length,
+        deployments: deploymentNames,
+    });
+    for (const deployment of deploymentNames) {
+        try {
+            const resolved = resolveAzureModelName(deployment);
+            results.set(deployment, resolved);
+        }
+        catch (error) {
+            logger.error('Error in batch resolution', {
+                deployment,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            results.set(deployment, deployment); // Fallback to original name
+        }
+    }
+    return results;
+}
+/**
+ * Check if a deployment name would be resolved to a different model name
+ * Useful for validation and testing
+ *
+ * @param deploymentName - Azure deployment name
+ * @returns true if the deployment name would be transformed
+ */
+function wouldTransformDeploymentName(deploymentName) {
+    const resolved = resolveAzureModelName(deploymentName, false); // Don't use cache for this check
+    return resolved !== deploymentName;
+}
+//# sourceMappingURL=azure-model-resolver.js.map

package/dist/cjs/utils/azure-model-resolver.js.map

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

package/dist/cjs/utils/constants.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_MESSAGE_PATTERNS_TYPE_CONFIG = exports.MESSAGE_PATTERNS_TYPE_NETWORK = exports.knownModels = void 0;
+// Direct match check for known LiteLLM model names
+exports.knownModels = [
+    'gpt-4o',
+    'gpt-4o-mini',
+    'gpt-4',
+    'gpt-4-turbo',
+    'gpt-4-vision-preview',
+    'gpt-3.5-turbo',
+    'gpt-3.5-turbo-instruct',
+    'text-embedding-3-large',
+    'text-embedding-3-small',
+    'text-embedding-ada-002',
+    'dall-e-3',
+    'dall-e-2',
+    'whisper-1',
+    'tts-1',
+    'tts-1-hd'
+];
+exports.MESSAGE_PATTERNS_TYPE_NETWORK = ["network", "timeout", "ECONNRESET"];
+exports.ERROR_MESSAGE_PATTERNS_TYPE_CONFIG = ["config", "key", "unauthorized"];
+//# sourceMappingURL=constants.js.map

package/dist/cjs/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA,mDAAmD;AACtC,QAAA,WAAW,GAAG;IAC3B,QAAQ;IACR,aAAa;IACb,OAAO;IACP,aAAa;IACb,sBAAsB;IACtB,eAAe;IACf,wBAAwB;IACxB,wBAAwB;IACxB,wBAAwB;IACxB,wBAAwB;IACxB,UAAU;IACV,UAAU;IACV,WAAW;IACX,OAAO;IACP,UAAU;CACT,CAAC;AAEW,QAAA,6BAA6B,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACrE,QAAA,kCAAkC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC"}

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

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Error Handler Utilities
+ *
+ * Centralized error handling patterns to eliminate repetitive try/catch blocks
+ * and provide consistent error logging and recovery strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.ConfigurationError = exports.ValidationError = void 0;
+exports.safeAsyncOperation = safeAsyncOperation;
+exports.safeSyncOperation = safeSyncOperation;
+exports.validateOrThrow = validateOrThrow;
+exports.validateOrUndefined = validateOrUndefined;
+exports.withRetry = withRetry;
+exports.classifyError = classifyError;
+const constants_js_1 = require("./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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+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
+ */
+class ValidationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class ConfigurationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class NetworkError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error classification utility
+ */
+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 (constants_js_1.MESSAGE_PATTERNS_TYPE_NETWORK.some(pattern => message.includes(pattern))) {
+        return { type: 'network', message, isRetryable: true };
+    }
+    if (constants_js_1.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/cjs/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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"}