@revenium/openai 1.0.8

package/dist/types/types/responses-api.d.ts

@@ -0,0 +1,247 @@
+/**
+ * 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
+ */
+import { UsageMetadata } from './index.js';
+/**
+ * OpenAI Responses API request parameters
+ * Based on the official OpenAI Responses API documentation
+ * Reference: https://platform.openai.com/docs/guides/migrate-to-responses
+ */
+export interface OpenAIResponsesRequest {
+    /** The model to use for the response */
+    model: string;
+    /** Input for the response - can be string or message array */
+    input: string | Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Maximum number of output tokens to generate */
+    max_output_tokens?: number;
+    /** Temperature for response generation (0.0 to 2.0) */
+    temperature?: number;
+    /** Top-p sampling parameter (0.0 to 1.0) */
+    top_p?: number;
+    /** Instructions for the model (replaces system messages) */
+    instructions?: string;
+    /** Tools available to the model */
+    tools?: Array<{
+        type: 'function' | 'web_search' | 'file_search' | 'code_interpreter' | 'image_generation';
+        name?: string;
+        description?: string;
+        parameters?: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+            additionalProperties?: boolean;
+        };
+        [key: string]: unknown;
+    }>;
+    /** Tool choice configuration */
+    tool_choice?: 'auto' | 'none' | {
+        type: 'function';
+        name: string;
+    };
+    /** Structured output configuration */
+    text?: {
+        format?: {
+            type: 'json_schema';
+            name: string;
+            strict?: boolean;
+            schema: {
+                type: 'object';
+                properties: Record<string, unknown>;
+                required?: string[];
+                additionalProperties?: boolean;
+            };
+        };
+    };
+    /** Metadata for the request */
+    metadata?: Record<string, unknown>;
+    /** ID of previous response to continue from */
+    previous_response_id?: string;
+    /** Whether to run in background mode */
+    background?: boolean;
+    /** Whether to store the response (default: true) */
+    store?: boolean;
+    /** Parallel tool calls configuration */
+    parallel_tool_calls?: boolean;
+    /** Reasoning effort level */
+    reasoning_effort?: 'low' | 'medium' | 'high';
+    /** Include additional data in response */
+    include?: Array<'reasoning.encrypted_content'>;
+    /** Custom metadata field for Revenium tracking */
+    usageMetadata?: UsageMetadata;
+    /** Additional parameters */
+    [key: string]: unknown;
+}
+/**
+ * OpenAI Responses API response structure
+ * Based on the official Azure OpenAI Responses API documentation
+ */
+export interface OpenAIResponsesResponse {
+    /** Unique identifier for the response */
+    id: string;
+    /** Timestamp when the response was created */
+    created_at: number;
+    /** The model used for the response */
+    model: string;
+    /** Response object type */
+    object: 'response';
+    /** Response status */
+    status: 'queued' | 'in_progress' | 'completed' | 'incomplete' | 'cancelled' | 'failed';
+    /** Response output array */
+    output: Array<{
+        id: string;
+        type: 'message' | 'function_call' | 'function_call_output' | 'image_generation_call';
+        role?: 'assistant';
+        content?: Array<{
+            type: 'output_text' | 'text';
+            text?: string;
+            annotations?: Array<unknown>;
+        }>;
+        name?: string;
+        call_id?: string;
+        output?: string;
+        result?: string;
+        status?: string | null;
+    }>;
+    /** Simplified output text (convenience field) */
+    output_text?: string;
+    /** Usage statistics */
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        output_tokens_details?: {
+            reasoning_tokens: number;
+        };
+    };
+    /** Response metadata */
+    metadata?: Record<string, unknown>;
+    /** Instructions used */
+    instructions?: string | null;
+    /** Tools configuration */
+    tools?: Array<unknown>;
+    /** Tool choice configuration */
+    tool_choice?: unknown;
+    /** Parallel tool calls setting */
+    parallel_tool_calls?: boolean | null;
+    /** Temperature used */
+    temperature?: number;
+    /** Top-p used */
+    top_p?: number;
+    /** Max output tokens */
+    max_output_tokens?: number | null;
+    /** Previous response ID */
+    previous_response_id?: string | null;
+    /** Error information */
+    error?: unknown | null;
+    /** Incomplete details */
+    incomplete_details?: unknown | null;
+    /** Reasoning information */
+    reasoning?: unknown | null;
+    /** Text field */
+    text?: unknown | null;
+    /** Truncation information */
+    truncation?: unknown | null;
+    /** User information */
+    user?: unknown | null;
+    /** Reasoning effort */
+    reasoning_effort?: unknown | null;
+}
+/**
+ * Streaming chunk for Responses API
+ */
+export interface OpenAIResponsesStreamChunk {
+    /** Unique identifier for the response */
+    id: string;
+    /** The model used */
+    model: string;
+    /** Delta content for this chunk */
+    delta?: {
+        content?: Array<{
+            type: 'text' | 'tool_use';
+            text?: string;
+            [key: string]: unknown;
+        }>;
+    };
+    /** Usage information (typically in final chunk) */
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        total_tokens?: number;
+        reasoning_tokens?: number;
+        cached_tokens?: number;
+    };
+    /** Finish reason (in final chunk) */
+    finish_reason?: string | null;
+    /** Additional chunk fields */
+    [key: string]: unknown;
+}
+/**
+ * Type guard to check if a request is for Responses API
+ */
+export declare function isResponsesRequest(params: unknown): params is OpenAIResponsesRequest;
+/**
+ * Type guard to check if a response is from Responses API
+ */
+export declare function isResponsesResponse(response: unknown): response is OpenAIResponsesResponse;
+/**
+ * Simplified interface for Responses API create parameters (for examples)
+ */
+export interface ResponsesCreateParams {
+    model: string;
+    input: string | Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    stream?: boolean;
+    max_output_tokens?: number;
+    temperature?: number;
+    instructions?: string;
+    tools?: Array<{
+        type: 'function' | 'web_search' | 'file_search' | 'code_interpreter' | 'image_generation';
+        function?: {
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        };
+    }>;
+    usageMetadata?: UsageMetadata;
+}
+/**
+ * Simplified interface for Responses API response (for examples)
+ */
+export interface ResponsesResponse {
+    id: string;
+    model: string;
+    object: 'response';
+    status: string;
+    output: Array<{
+        id: string;
+        type: string;
+        role?: string;
+        content?: Array<{
+            type: 'output_text' | 'text';
+            text?: string;
+        }>;
+    }>;
+    output_text?: string;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        output_tokens_details?: {
+            reasoning_tokens: number;
+        };
+    };
+}
+//# sourceMappingURL=responses-api.d.ts.map

package/dist/types/types/responses-api.d.ts.map

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

package/dist/types/utils/azure-model-resolver.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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
+ */
+export declare function resolveAzureModelName(deploymentName: string, useCache?: boolean): string;
+/**
+ * Clear the model name cache
+ * Useful for testing or when deployment configurations change
+ */
+export declare function clearModelNameCache(): void;
+/**
+ * Get cache statistics for monitoring
+ */
+export declare function getModelNameCacheStats(): {
+    cacheSize: number;
+    failedResolutionCount: number;
+    cacheEntries: Array<{
+        deployment: string;
+        resolved: string;
+    }>;
+};
+/**
+ * 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
+ */
+export declare function batchResolveModelNames(deploymentNames: string[]): Map<string, string>;
+/**
+ * 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
+ */
+export declare function wouldTransformDeploymentName(deploymentName: string): boolean;
+//# sourceMappingURL=azure-model-resolver.d.ts.map

package/dist/types/utils/azure-model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-model-resolver.d.ts","sourceRoot":"","sources":["../../../src/utils/azure-model-resolver.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,MAAM,CA0C9F;AAuED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D,CASA;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBrF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAG5E"}

package/dist/types/utils/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const knownModels: string[];
+export declare const MESSAGE_PATTERNS_TYPE_NETWORK: string[];
+export declare const ERROR_MESSAGE_PATTERNS_TYPE_CONFIG: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,UAgBvB,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAAuC,CAAC;AAClF,eAAO,MAAM,kCAAkC,UAAoC,CAAC"}

package/dist/types/utils/error-handler.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Error Handler Utilities
+ *
+ * Centralized error handling patterns to eliminate repetitive try/catch blocks
+ * and provide consistent error logging and recovery strategies.
+ */
+import { Logger } from '../types/index.js';
+/**
+ * Error handling strategy configuration
+ */
+export interface ErrorHandlingStrategy {
+    /** Whether to log the error */
+    logError?: boolean;
+    /** Whether to re-throw the error */
+    rethrow?: boolean;
+    /** Custom error message prefix */
+    messagePrefix?: string;
+    /** Fallback value to return on error */
+    fallbackValue?: unknown;
+    /** Custom error transformation function */
+    transformError?: (error: unknown) => 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 declare function safeAsyncOperation<T>(operation: () => Promise<T>, context: string, strategy?: ErrorHandlingStrategy, logger?: Logger): Promise<T | undefined>;
+/**
+ * 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 declare function safeSyncOperation<T>(operation: () => T, context: string, strategy?: ErrorHandlingStrategy, logger?: Logger): T | undefined;
+/**
+ * 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 declare function validateOrThrow<T>(value: unknown, validator: (value: unknown) => value is T, errorMessage: string): T;
+/**
+ * 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 declare function validateOrUndefined<T>(value: unknown, validator: (value: unknown) => value is T, logger?: Logger, context?: string): T | undefined;
+/**
+ * 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 declare function withRetry<T>(operation: () => Promise<T>, maxRetries?: number, delayMs?: number, logger?: Logger): Promise<T>;
+/**
+ * Common error types for better error handling
+ */
+export declare class ValidationError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+export declare class ConfigurationError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+export declare class NetworkError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Error classification utility
+ */
+export declare function classifyError(error: unknown): {
+    type: 'validation' | 'configuration' | 'network' | 'unknown';
+    message: string;
+    isRetryable: boolean;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/types/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;CAC5C;AAaD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAA0B,EACpC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAkBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAA0B,EACpC,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,GAAG,SAAS,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACzC,YAAY,EAAE,MAAM,GACnB,CAAC,CAGH;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACzC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,CAAC,GAAG,SAAS,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,MAAa,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,YAAa,SAAQ,KAAK;aAGnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAC7C,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB,CAwBA"}

package/dist/types/utils/metadata-builder.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Metadata Builder Utilities
+ *
+ * Centralized metadata handling to eliminate repetitive spreading
+ * and provide consistent metadata processing across the codebase.
+ */
+import { UsageMetadata } from '../types/index.js';
+/**
+ * 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 declare function buildMetadataFields(usageMetadata?: UsageMetadata): Record<string, unknown>;
+/**
+ * Validate metadata completeness for specific use cases
+ *
+ * @param usageMetadata - Metadata to validate
+ * @param requiredFields - List of required field names
+ * @returns Validation result
+ */
+export declare function validateMetadata(usageMetadata?: UsageMetadata, requiredFields?: (keyof UsageMetadata)[]): {
+    isValid: boolean;
+    missingFields: string[];
+    warnings: string[];
+};
+/**
+ * Merge multiple metadata sources with priority
+ *
+ * @param sources - Metadata sources in priority order (first wins)
+ * @returns Merged metadata object
+ */
+export declare function mergeMetadata(...sources: (UsageMetadata | undefined)[]): UsageMetadata;
+/**
+ * Extract metadata from request parameters safely
+ *
+ * @param params - Request parameters that might contain usageMetadata
+ * @returns Extracted metadata and cleaned parameters
+ */
+export declare function extractMetadata<T extends Record<string, unknown>>(params: T & {
+    usageMetadata?: UsageMetadata;
+}): {
+    metadata: UsageMetadata | undefined;
+    cleanParams: Omit<T, 'usageMetadata'>;
+};
+/**
+ * Create a metadata context for consistent logging
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Logging context object
+ */
+export declare function createLoggingContext(usageMetadata?: UsageMetadata): Record<string, unknown>;
+/**
+ * Sanitize metadata for logging (remove sensitive fields)
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Sanitized metadata safe for logging
+ */
+export declare function sanitizeMetadataForLogging(usageMetadata?: UsageMetadata): Record<string, unknown>;
+//# sourceMappingURL=metadata-builder.d.ts.map

package/dist/types/utils/metadata-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-builder.d.ts","sourceRoot":"","sources":["../../../src/utils/metadata-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAuC9D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB1F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,CAAC,EAAE,aAAa,EAC7B,cAAc,GAAE,CAAC,MAAM,aAAa,CAAC,EAAO,GAC3C;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAmCA;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,OAAO,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC,EAAE,GAAG,aAAa,CAQtF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,MAAM,EAAE,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,GAC5C;IACD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;CACvC,CAMA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW3F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BjG"}

package/dist/types/utils/provider-detection.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Provider Detection Utilities
+ *
+ * Simplifies complex provider detection logic using strategy pattern
+ * instead of nested conditionals.
+ */
+import { Provider, ProviderInfo, AzureConfig } from '../types/index.js';
+import { OpenAIClientInstance } from '../types/function-parameters.js';
+import { Logger } from '../types/index.js';
+/**
+ * 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 declare function detectProviderStrategy(client: OpenAIClientInstance, logger?: Logger): {
+    provider: Provider;
+    strategy?: string;
+    context?: Record<string, unknown>;
+};
+/**
+ * Gather Azure configuration using strategy pattern
+ *
+ * @param client - OpenAI client instance
+ * @param logger - Logger for debugging
+ * @returns Merged Azure configuration
+ */
+export declare function gatherAzureConfigStrategy(client: OpenAIClientInstance, logger?: Logger): AzureConfig;
+/**
+ * Create complete provider info using strategies
+ *
+ * @param client - OpenAI client instance
+ * @param logger - Logger for debugging
+ * @returns Complete provider information
+ */
+export declare function createProviderInfo(client: OpenAIClientInstance, logger?: Logger): ProviderInfo;
+/**
+ * Validate provider detection result
+ *
+ * @param providerInfo - Provider info to validate
+ * @returns Validation result
+ */
+export declare function validateProviderInfo(providerInfo: ProviderInfo): {
+    isValid: boolean;
+    warnings: string[];
+};
+//# sourceMappingURL=provider-detection.d.ts.map

package/dist/types/utils/provider-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-detection.d.ts","sourceRoot":"","sources":["../../../src/utils/provider-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAuE3C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAkC9E;AA+BD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CA+Bb;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAkB9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAmBA"}

package/dist/types/utils/request-handler-factory.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Request Handler Factory
+ *
+ * Eliminates dynamic require() calls and provides a clean factory pattern
+ * for creating request handlers with proper dependency injection.
+ */
+import { OpenAIChatRequest, OpenAIEmbeddingRequest, OpenAIRequestOptions, OpenAIClientInstance, OpenAIOriginalFunction, OpenAIResponsesOriginalFunction } from '../types/function-parameters.js';
+import { UsageMetadata, OpenAIResponsesRequest } from '../types/index.js';
+/**
+ * Request handler function signatures
+ */
+export type StreamingRequestHandler = (originalCreate: OpenAIOriginalFunction, params: Omit<OpenAIChatRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance) => Promise<AsyncIterable<unknown>>;
+export type NonStreamingRequestHandler = (originalCreate: OpenAIOriginalFunction, params: Omit<OpenAIChatRequest, 'usageMetadata'> | Omit<OpenAIEmbeddingRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance) => Promise<unknown>;
+export type EmbeddingsRequestHandler = (originalCreate: OpenAIOriginalFunction, params: Omit<OpenAIEmbeddingRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance) => Promise<unknown>;
+export type ResponsesStreamingRequestHandler = (originalCreate: OpenAIResponsesOriginalFunction, params: Omit<OpenAIResponsesRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance) => Promise<AsyncIterable<unknown>>;
+export type ResponsesNonStreamingRequestHandler = (originalCreate: OpenAIResponsesOriginalFunction, params: Omit<OpenAIResponsesRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance) => Promise<unknown>;
+/**
+ * Request handler dependencies
+ */
+export interface RequestHandlerDependencies {
+    handleStreamingRequest: StreamingRequestHandler;
+    handleNonStreamingRequest: NonStreamingRequestHandler;
+    handleEmbeddingsRequest: EmbeddingsRequestHandler;
+    handleResponsesStreamingRequest: ResponsesStreamingRequestHandler;
+    handleResponsesNonStreamingRequest: ResponsesNonStreamingRequestHandler;
+}
+/**
+ * Request handler factory class
+ *
+ * This eliminates the need for dynamic require() calls and provides
+ * a clean dependency injection pattern.
+ */
+export declare class RequestHandlerFactory {
+    private dependencies;
+    /**
+     * Initialize the factory with dependencies
+     */
+    initialize(dependencies: RequestHandlerDependencies): void;
+    /**
+     * Get streaming request handler
+     */
+    getStreamingHandler(): StreamingRequestHandler;
+    /**
+     * Get non-streaming request handler
+     */
+    getNonStreamingHandler(): NonStreamingRequestHandler;
+    /**
+     * Get embeddings request handler
+     */
+    getEmbeddingsHandler(): EmbeddingsRequestHandler;
+    /**
+     * Route chat request to appropriate handler
+     */
+    routeChatRequest(originalCreate: OpenAIOriginalFunction, params: Omit<OpenAIChatRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance): Promise<unknown>;
+    /**
+     * Route embeddings request to appropriate handler
+     */
+    routeEmbeddingsRequest(originalCreate: OpenAIOriginalFunction, params: Omit<OpenAIEmbeddingRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance): Promise<unknown>;
+    /**
+     * Route responses request to appropriate handler (new OpenAI Responses API)
+     */
+    routeResponsesRequest(originalCreate: OpenAIResponsesOriginalFunction, params: Omit<OpenAIResponsesRequest, 'usageMetadata'>, options: OpenAIRequestOptions | undefined, usageMetadata: UsageMetadata | undefined, requestStartTime: number, instance: OpenAIClientInstance): Promise<unknown>;
+    /**
+     * Check if factory is initialized
+     */
+    isInitialized(): boolean;
+}
+/**
+ * Global factory instance
+ */
+export declare const requestHandlerFactory: RequestHandlerFactory;
+/**
+ * Initialize the global factory (called once during module setup)
+ * Uses dynamic import to avoid circular dependencies
+ */
+export declare function initializeRequestHandlerFactory(): Promise<void>;
+/**
+ * Utility function to ensure factory is initialized
+ */
+export declare function ensureFactoryInitialized(): Promise<void>;
+//# sourceMappingURL=request-handler-factory.d.ts.map

package/dist/types/utils/request-handler-factory.d.ts.map

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

package/dist/types/utils/stop-reason-mapper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Stop Reason Mapper Utilities
+ *
+ * Centralized stop reason mapping logic using lookup tables
+ * instead of nested conditionals. Based on the good example
+ * from the anthropic-node middleware.
+ */
+/**
+ * Map provider stop reasons to Revenium stop reasons
+ *
+ * This replaces the nested if/switch logic with a clean lookup table approach.
+ * Based on the good example from the anthropic-node middleware.
+ *
+ * @param providerStopReason - Stop reason from the AI provider
+ * @param logger - Optional logger for warnings about unknown reasons
+ * @returns Standardized Revenium stop reason
+ */
+export declare function mapStopReason(providerStopReason: string | null | undefined, logger?: {
+    warn: (message: string, ...args: any[]) => void;
+}): string;
+/**
+ * Get all supported stop reasons for documentation/testing
+ */
+export declare function getSupportedStopReasons(): string[];
+/**
+ * Check if a stop reason is supported
+ */
+export declare function isStopReasonSupported(reason: string): boolean;
+//# sourceMappingURL=stop-reason-mapper.d.ts.map

package/dist/types/utils/stop-reason-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reason-mapper.d.ts","sourceRoot":"","sources":["../../../src/utils/stop-reason-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7C,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAE,GAC3D,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D"}