@revenium/litellm 0.0.1

package/dist/utils/trace-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-fields.d.ts","sourceRoot":"","sources":["../../src/utils/trace-fields.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAe9C;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAWlD;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAsB5C;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAa5C;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAKvE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAOvC"}

package/dist/utils/trace-fields.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvironment = getEnvironment;
+exports.getRegion = getRegion;
+exports.getCredentialAlias = getCredentialAlias;
+exports.getTraceType = getTraceType;
+exports.getTraceName = getTraceName;
+exports.detectOperationSubtype = detectOperationSubtype;
+exports.getParentTransactionId = getParentTransactionId;
+exports.getTransactionName = getTransactionName;
+exports.getRetryNumber = getRetryNumber;
+const config_1 = require("../config");
+const logger = (0, config_1.getLogger)();
+let cachedRegion = null;
+let regionCached = false;
+function getEnvironment() {
+    const env = process.env.REVENIUM_ENVIRONMENT ||
+        process.env.NODE_ENV ||
+        process.env.DEPLOYMENT_ENV ||
+        null;
+    if (env && env.length > 255) {
+        logger.warn(`environment exceeds max length of 255 characters. Truncating.`);
+        return env.substring(0, 255).trim();
+    }
+    return env ? env.trim() : null;
+}
+async function getRegion() {
+    if (regionCached) {
+        return cachedRegion;
+    }
+    const envRegion = process.env.AWS_REGION ||
+        process.env.AZURE_REGION ||
+        process.env.GCP_REGION ||
+        process.env.REVENIUM_REGION;
+    if (envRegion) {
+        cachedRegion = envRegion.trim();
+        regionCached = true;
+        return cachedRegion;
+    }
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 1000);
+        const response = await fetch("http://169.254.169.254/latest/meta-data/placement/region", {
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            cachedRegion = null;
+            regionCached = true;
+            return null;
+        }
+        const text = await response.text();
+        cachedRegion = text.trim();
+        regionCached = true;
+        return cachedRegion;
+    }
+    catch (error) {
+        cachedRegion = null;
+        regionCached = true;
+        return null;
+    }
+}
+function getCredentialAlias() {
+    const alias = process.env.REVENIUM_CREDENTIAL_ALIAS || null;
+    if (alias && alias.length > 255) {
+        logger.warn(`credentialAlias exceeds max length of 255 characters. Truncating.`);
+        return alias.substring(0, 255).trim();
+    }
+    return alias ? alias.trim() : null;
+}
+function getTraceType() {
+    const traceType = process.env.REVENIUM_TRACE_TYPE;
+    if (!traceType) {
+        return null;
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(traceType)) {
+        logger.warn(`Invalid trace_type format: ${traceType}. Must be alphanumeric with hyphens/underscores only.`);
+        return null;
+    }
+    if (traceType.length > 128) {
+        logger.warn(`trace_type exceeds max length of 128 characters: ${traceType}. Truncating.`);
+        return traceType.substring(0, 128);
+    }
+    return traceType;
+}
+function getTraceName() {
+    const traceName = process.env.REVENIUM_TRACE_NAME;
+    if (!traceName) {
+        return null;
+    }
+    if (traceName.length > 256) {
+        logger.warn(`trace_name exceeds max length of 256 characters. Truncating.`);
+        return traceName.substring(0, 256);
+    }
+    return traceName;
+}
+function detectOperationSubtype(requestBody) {
+    if (requestBody && requestBody.tools && requestBody.tools.length > 0) {
+        return "function_call";
+    }
+    return null;
+}
+function getParentTransactionId() {
+    return process.env.REVENIUM_PARENT_TRANSACTION_ID || null;
+}
+function getTransactionName() {
+    return process.env.REVENIUM_TRANSACTION_NAME || null;
+}
+function getRetryNumber() {
+    const retryNum = process.env.REVENIUM_RETRY_NUMBER;
+    if (retryNum) {
+        const parsed = parseInt(retryNum, 10);
+        return isNaN(parsed) ? 0 : parsed;
+    }
+    return 0;
+}
+//# sourceMappingURL=trace-fields.js.map

package/dist/utils/trace-fields.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Validation utilities for type-safe input handling
+ *
+ * This module provides runtime validation to replace 'any' types
+ * with proper type checking and validation.
+ */
+import { ReveniumConfig, UsageMetadata } from "../types";
+/**
+ * Type guard for checking if a value is a non-null object
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard for checking if a value is a string
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Type guard for checking if a value is a number
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard for checking if a value is a boolean
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Validate and extract string from unknown value
+ * @param value - Value to validate
+ * @param defaultValue - Default value if validation fails
+ * @returns Validated string or default
+ */
+export declare function validateString(value: unknown, defaultValue?: string): string;
+/**
+ * Validate and extract number from unknown value
+ * @param value - Value to validate
+ * @param defaultValue - Default value if validation fails
+ * @returns Validated number or default
+ */
+export declare function validateNumber(value: unknown, defaultValue?: number): number;
+/**
+ * Validate and extract boolean from unknown value
+ * @param value - Value to validate
+ * @param defaultValue - Default value if validation fails
+ * @returns Validated boolean or default
+ */
+export declare function validateBoolean(value: unknown, defaultValue?: boolean): boolean;
+/**
+ * Validate HTTP headers object
+ * @param headers - Headers to validate
+ * @returns Validated headers record
+ */
+export declare function validateHeaders(headers: unknown): Record<string, string>;
+/**
+ * Validate usage metadata object
+ * @param metadata - Metadata to validate
+ * @returns Validated usage metadata
+ */
+export declare function validateUsageMetadata(metadata: unknown): UsageMetadata;
+/**
+ * Enhanced configuration validation with detailed error reporting
+ */
+interface ConfigValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    config?: ReveniumConfig;
+    suggestions?: string[];
+}
+/**
+ * Validate Revenium configuration object with enhanced error reporting
+ * @param config - Configuration to validate
+ * @returns Detailed validation result
+ */
+export declare function validateReveniumConfig(config: unknown): ConfigValidationResult;
+/**
+ * Validate stream chunk data
+ * @param chunk - Chunk data to validate
+ * @returns Validated chunk or null if invalid
+ */
+export declare function validateStreamChunk(chunk: unknown): {
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    choices?: Array<{
+        finish_reason?: string;
+        delta?: {
+            content?: string;
+        };
+    }>;
+    x_groq?: {
+        usage?: {
+            prompt_tokens?: number;
+            completion_tokens?: number;
+            total_tokens?: number;
+        };
+    };
+} | null;
+/**
+ * Validate LiteLLM request data
+ * @param requestData - Request data to validate
+ * @param endpointType - Type of endpoint (chat or embeddings)
+ * @returns Validation result
+ */
+export declare function validateLiteLLMRequest(requestData: unknown, endpointType: "chat" | "embeddings"): {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Validate URL for LiteLLM proxy requests
+ * @param url - URL to validate
+ * @param proxyUrl - Configured proxy URL
+ * @returns Validation result
+ */
+export declare function validateLiteLLMUrl(url: string, proxyUrl: string): {
+    isValid: boolean;
+    errors: string[];
+    endpointType?: "chat" | "embeddings";
+};
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAK,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,UAAQ,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,aAAa,CAuBtE;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,GACd,sBAAsB,CAwJxB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE;YACN,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;CACH,GAAG,IAAI,CAiEP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,MAAM,GAAG,YAAY,GAClC;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA2FA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CACtC,CAoDA"}