@revenium/perplexity 2.0.4 → 2.0.5

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

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Metadata Builder Utilities
+ *
+ * Centralized metadata handling to eliminate repetitive spreading
+ * and provide consistent metadata processing across the codebase.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMetadataFields = buildMetadataFields;
+exports.validateMetadata = validateMetadata;
+exports.mergeMetadata = mergeMetadata;
+exports.extractMetadata = extractMetadata;
+exports.createLoggingContext = createLoggingContext;
+exports.sanitizeMetadataForLogging = sanitizeMetadataForLogging;
+/**
+ * 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.0 and 1.0 (API spec requirement)
+            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
+ */
+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
+ */
+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;
+            // API Spec: https://revenium.readme.io/reference/meter_ai_completion (responseQualityScore)
+            // "typically on a 0.0-1.0 scale"
+            if (typeof score !== 'number' || score < 0 || score > 1) {
+                warnings.push('responseQualityScore should be a number between 0.0 and 1.0');
+            }
+        }
+        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
+ */
+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
+ */
+function extractMetadata(params) {
+    const { usageMetadata, ...cleanParams } = params;
+    return {
+        metadata: usageMetadata,
+        cleanParams: cleanParams,
+    };
+}
+/**
+ * Create a metadata context for consistent logging
+ * Uses sanitization to protect PII (emails are masked)
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Logging context object with sanitized PII
+ */
+function createLoggingContext(usageMetadata) {
+    if (!usageMetadata)
+        return {};
+    // Use sanitizer to protect PII in logs
+    const sanitized = sanitizeMetadataForLogging(usageMetadata);
+    const sanitizedSubscriber = sanitized.subscriber;
+    return {
+        traceId: usageMetadata.traceId,
+        taskType: usageMetadata.taskType,
+        subscriberId: usageMetadata.subscriber?.id,
+        subscriberEmail: sanitizedSubscriber?.email, // ← Now masked: us***@example.com
+        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
+ */
+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) {
+            // Mask email: handles single-char emails (a@x.com → a***@x.com)
+            sanitizedSubscriber.email = subscriber.email.replace(/(.{1,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/cjs/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/cjs/utils/stop-reason-mapper.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapStopReason = mapStopReason;
+exports.getSupportedStopReasons = getSupportedStopReasons;
+exports.isStopReasonSupported = isStopReasonSupported;
+/**
+ * Stop reason mapping configuration
+ * Maps provider-specific stop reasons to Revenium's standardized set
+ */
+const STOP_REASON_MAP = {
+    // OpenAI/Azure OpenAI stop reasons
+    stop: 'END',
+    function_call: 'END_SEQUENCE',
+    tool_calls: 'END_SEQUENCE',
+    timeout: 'TIMEOUT',
+    length: 'TOKEN_LIMIT',
+    max_tokens: 'TOKEN_LIMIT',
+    cost_limit: 'COST_LIMIT',
+    completion_limit: 'COMPLETION_LIMIT',
+    content_filter: 'ERROR',
+    error: 'ERROR',
+    cancelled: 'CANCELLED',
+    canceled: 'CANCELLED', // Handle both spellings
+    // Anthropic stop reasons (for consistency across middleware)
+    end_turn: 'END',
+    stop_sequence: 'END_SEQUENCE',
+    tool_use: 'END_SEQUENCE',
+};
+/**
+ * Default stop reason when mapping fails
+ */
+const DEFAULT_STOP_REASON = 'END';
+/**
+ * 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
+ */
+function mapStopReason(providerStopReason, logger) {
+    if (!providerStopReason)
+        return DEFAULT_STOP_REASON;
+    const normalizedReason = providerStopReason.toLowerCase();
+    const mappedReason = STOP_REASON_MAP[normalizedReason];
+    if (!mappedReason) {
+        // Log warning for unknown stop reasons to help with future mapping
+        logger?.warn(`Unknown stop reason: ${providerStopReason}, mapping to ${DEFAULT_STOP_REASON}`);
+        return DEFAULT_STOP_REASON;
+    }
+    return mappedReason;
+}
+/**
+ * Get all supported stop reasons for documentation/testing
+ */
+function getSupportedStopReasons() {
+    return Object.keys(STOP_REASON_MAP);
+}
+/**
+ * Check if a stop reason is supported
+ */
+function isStopReasonSupported(reason) {
+    return reason.toLowerCase() in STOP_REASON_MAP;
+}
+//# sourceMappingURL=stop-reason-mapper.js.map

package/dist/cjs/utils/stop-reason-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reason-mapper.js","sourceRoot":"","sources":["../../../src/utils/stop-reason-mapper.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA0CH,sCAeC;AAKD,0DAEC;AAKD,sDAEC;AArED;;;GAGG;AACH,MAAM,eAAe,GAA2B;IAC9C,mCAAmC;IACnC,IAAI,EAAE,KAAK;IACX,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,OAAO;IACvB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,WAAW,EAAG,wBAAwB;IAEhD,6DAA6D;IAC7D,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,cAAc;IAC7B,QAAQ,EAAE,cAAc;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,kBAA6C,EAC7C,MAA4D;IAE5D,IAAI,CAAC,kBAAkB;QAAE,OAAO,mBAAmB,CAAC;IACpD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAEvD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,mEAAmE;QACnE,MAAM,EAAE,IAAI,CAAC,wBAAwB,kBAAkB,gBAAgB,mBAAmB,EAAE,CAAC,CAAC;QAC9F,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAc;IAClD,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,eAAe,CAAC;AACjD,CAAC"}

package/dist/cjs/utils/transaction-id.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Transaction ID Generator
+ *
+ * Generates unique transaction IDs for tracking requests.
+ * Format: txn_{timestamp}_{random}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTransactionId = generateTransactionId;
+/**
+ * Generate a unique transaction ID
+ *
+ * @returns A unique transaction ID in format: txn_{timestamp}_{random}
+ *
+ */
+function generateTransactionId() {
+    return `txn_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+}
+//# sourceMappingURL=transaction-id.js.map

package/dist/cjs/utils/transaction-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-id.js","sourceRoot":"","sources":["../../../src/utils/transaction-id.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAQH,sDAEC;AARD;;;;;GAKG;AACH,SAAgB,qBAAqB;IACnC,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/cjs/utils/url-builder.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * URL Builder Utilities
+ *
+ * Centralized URL construction logic to eliminate nested conditionals.
+ * Replaces the complex URL building logic from tracking.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildReveniumUrl = buildReveniumUrl;
+exports.isValidUrl = isValidUrl;
+/**
+ * Build Revenium API URL with proper path handling
+ *
+ * @param baseUrl - The base URL from configuration (may include /meter or /meter/v2)
+ * @param endpoint - The API endpoint to append (e.g., '/ai/completions')
+ * @returns Complete URL for the API call
+ */
+function buildReveniumUrl(baseUrl, endpoint) {
+    // Normalize the base URL by removing trailing slashes
+    let normalizedBase = baseUrl.replace(/\/+$/, '');
+    // Check if /meter/v2 is already at the end
+    const hasMeterV2AtEnd = /\/meter\/v2$/i.test(normalizedBase);
+    if (hasMeterV2AtEnd) {
+        // Already has /meter/v2, just append endpoint
+        return `${normalizedBase}${endpoint}`;
+    }
+    // Check if /meter is at the end (but not /meter/v2)
+    const hasMeterAtEnd = /\/meter$/i.test(normalizedBase);
+    if (hasMeterAtEnd) {
+        // Has /meter but not /v2, append /v2 and endpoint
+        return `${normalizedBase}/v2${endpoint}`;
+    }
+    // Check if /v2 is at the end (without /meter)
+    const hasV2AtEnd = /\/v2$/i.test(normalizedBase);
+    if (hasV2AtEnd) {
+        // Has /v2 but not /meter, append endpoint as-is
+        return `${normalizedBase}${endpoint}`;
+    }
+    // Has neither /meter nor /v2, append /meter/v2 and endpoint
+    return `${normalizedBase}/meter/v2${endpoint}`;
+}
+/**
+ * Validate URL format
+ *
+ * @param url - URL to validate
+ * @returns true if valid, false otherwise
+ */
+function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=url-builder.js.map

package/dist/cjs/utils/url-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.js","sourceRoot":"","sources":["../../../src/utils/url-builder.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AASH,4CA2BC;AAQD,gCAOC;AAjDD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IAChE,sDAAsD;IACtD,IAAI,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD,2CAA2C;IAC3C,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7D,IAAI,eAAe,EAAE,CAAC;QACpB,8CAA8C;QAC9C,OAAO,GAAG,cAAc,GAAG,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,kDAAkD;QAClD,OAAO,GAAG,cAAc,MAAM,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,UAAU,EAAE,CAAC;QACf,gDAAgD;QAChD,OAAO,GAAG,cAAc,GAAG,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,4DAA4D;IAC5D,OAAO,GAAG,cAAc,YAAY,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/esm/constants/models.js

@@ -0,0 +1,35 @@
+/**
+ * Perplexity Model Constants
+ *
+ * Official model names for Perplexity AI.
+ * Use these constants instead of hardcoding model strings.
+ *
+ * @example
+ * ```typescript
+ * import { PERPLEXITY_MODELS } from "@revenium/perplexity";
+ *
+ * const response = await client.chat().completions().create({
+ *   model: PERPLEXITY_MODELS.SONAR_PRO,
+ *   messages: [{ role: "user", content: "Hello!" }]
+ * });
+ * ```
+ */
+/**
+ * Available Perplexity AI models
+ * @see https://docs.perplexity.ai/docs/model-cards
+ */
+export const PERPLEXITY_MODELS = {
+    /**
+     * Sonar Pro - Most capable model for complex queries
+     */
+    SONAR_PRO: "sonar-pro",
+    /**
+     * Sonar - Standard model for most use cases
+     */
+    SONAR: "sonar",
+    /**
+     * Sonar Reasoning - Specialized for reasoning tasks
+     */
+    SONAR_REASONING: "sonar-reasoning",
+};
+//# sourceMappingURL=models.js.map

package/dist/esm/constants/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/constants/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,SAAS,EAAE,WAAoB;IAE/B;;OAEG;IACH,KAAK,EAAE,OAAgB;IAEvB;;OAEG;IACH,eAAe,EAAE,iBAA0B;CACnC,CAAC"}

package/dist/esm/core/client/index.js

@@ -0,0 +1,5 @@
+/**
+ * Client module exports
+ */
+export { Initialize, GetClient, IsInitialized, Reset, Configure } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/core/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/core/client/manager.js

@@ -0,0 +1,78 @@
+/**
+ * Client Manager - singleton pattern
+ *
+ * Provides Initialize/GetClient pattern.
+ * Manages singleton instance of ReveniumPerplexity client.
+ *
+ */
+import { ReveniumPerplexity } from "../middleware/revenium-client.js";
+import { initializeConfig, getLogger } from "../config/manager.js";
+import { validateConfig } from "../config/validator.js";
+/**
+ * Singleton instance of ReveniumPerplexity client
+ */
+let clientInstance = null;
+const logger = getLogger();
+/**
+ * Initialize Revenium Perplexity client from environment variables
+ *
+ * Loads configuration from environment:
+ * - REVENIUM_METERING_API_KEY (required)
+ * - PERPLEXITY_API_KEY (required)
+ * @throws {Error} If required environment variables are missing
+ */
+export function Initialize() {
+    logger.debug("Initializing Revenium Perplexity client");
+    const config = initializeConfig();
+    Configure(config);
+    logger.debug("Revenium Perplexity client initialized successfully");
+}
+/**
+ * Configure Revenium Perplexity client with custom configuration
+ *
+ * @param config - Configuration object
+ * @throws {Error} If required configuration fields are missing
+ *
+ */
+export function Configure(config) {
+    logger.debug("Configuring Revenium Perplexity client");
+    // Validate configuration (including API key formats)
+    validateConfig(config);
+    const fullConfig = {
+        ...config,
+        reveniumBaseUrl: config.reveniumBaseUrl || "https://api.revenium.ai",
+        perplexityBaseUrl: config.perplexityBaseUrl || "https://api.perplexity.ai",
+        debug: config.debug ?? false,
+    };
+    clientInstance = new ReveniumPerplexity(fullConfig);
+    if (fullConfig.debug) {
+        logger.debug("Revenium Perplexity client initialized successfully");
+    }
+}
+/**
+ * Get the singleton ReveniumPerplexity client instance
+ *
+ * @returns {ReveniumPerplexity} The client instance
+ * @throws {Error} If client has not been initialized
+ *
+ */
+export function GetClient() {
+    if (!clientInstance) {
+        throw new Error("Revenium Perplexity client not initialized. Call Initialize() or Configure() first.");
+    }
+    return clientInstance;
+}
+/**
+ * Check if client has been initialized
+ * @returns {boolean} True if client is initialized
+ */
+export function IsInitialized() {
+    return clientInstance !== null;
+}
+/**
+ * Reset the client instance (useful for testing)
+ */
+export function Reset() {
+    clientInstance = null;
+}
+//# sourceMappingURL=manager.js.map

package/dist/esm/core/client/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/core/client/manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,IAAI,cAAc,GAA8B,IAAI,CAAC;AACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AAG3B;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,CAAC;IAElB,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAEvD,qDAAqD;IACrD,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,UAAU,GAAmB;QACjC,GAAG,MAAM;QACT,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,yBAAyB;QACpE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,2BAA2B;QAC1E,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;KAC7B,CAAC;IAEF,cAAc,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK;IACnB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/esm/core/config/index.js

@@ -0,0 +1,11 @@
+/**
+ * Configuration module - Main exports
+ *
+ * This module provides a clean interface for configuration management.
+ * Aligned with OpenAI modular implementation.
+ */
+// Re-export all configuration functionality
+export { loadConfigFromEnv } from './loader.js';
+export { validateConfig } from './validator.js';
+export { getConfig, setConfig, getLogger, initializeConfig, defaultLogger, } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/esm/core/config/loader.js

@@ -0,0 +1,45 @@
+/**
+ * Configuration Loader Module
+ *
+ * Handles loading configuration from environment variables.
+ * Separated from validation and management for single responsibility.
+ */
+import { config as loadDotenv } from "dotenv";
+/**
+ * Default URLs for consistency with other middleware
+ */
+const DEFAULT_REVENIUM_BASE_URL = "https://api.revenium.ai";
+const DEFAULT_PERPLEXITY_BASE_URL = "https://api.perplexity.ai";
+/**
+ * Flag to track if .env file has been loaded
+ */
+let envFileLoaded = false;
+/**
+ * Load configuration from environment variables
+ * Automatically loads .env file from current directory if present
+ */
+export function loadConfigFromEnv() {
+    if (!envFileLoaded) {
+        loadDotenv();
+        envFileLoaded = true;
+    }
+    const reveniumApiKey = process.env.REVENIUM_METERING_API_KEY || process.env.REVENIUM_API_KEY;
+    const reveniumBaseUrl = process.env.REVENIUM_METERING_BASE_URL ||
+        process.env.REVENIUM_BASE_URL ||
+        DEFAULT_REVENIUM_BASE_URL;
+    const perplexityApiKey = process.env.PERPLEXITY_API_KEY;
+    const perplexityBaseUrl = process.env.PERPLEXITY_API_BASE_URL || DEFAULT_PERPLEXITY_BASE_URL;
+    const debug = process.env.REVENIUM_DEBUG === "true";
+    if (!reveniumApiKey)
+        return null;
+    if (!perplexityApiKey)
+        return null;
+    return {
+        reveniumApiKey,
+        reveniumBaseUrl,
+        perplexityApiKey,
+        perplexityBaseUrl,
+        debug,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/esm/core/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../src/core/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;AAEhE;;GAEG;AACH,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,UAAU,EAAE,CAAC;QACb,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxE,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,0BAA0B;QACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,yBAAyB,CAAC;IAC5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxD,MAAM,iBAAiB,GACrB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,2BAA2B,CAAC;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC;IAEpD,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO;QACL,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,iBAAiB;QACjB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/esm/core/config/manager.js

@@ -0,0 +1,70 @@
+/**
+ * Configuration Manager Module
+ *
+ * Handles global configuration state management and logging.
+ * Aligned with OpenAI modular implementation.
+ */
+import { loadConfigFromEnv } from "./loader.js";
+import { validateConfig } from "./validator.js";
+/**
+ * Global configuration instance
+ */
+let globalConfig = null;
+/**
+ * Default console logger implementation
+ */
+export const defaultLogger = {
+    debug: (message, ...args) => {
+        if (globalConfig?.debug || process.env.REVENIUM_DEBUG === "true") {
+            console.debug(`[Revenium Debug] ${message}`, ...args);
+        }
+    },
+    info: (message, ...args) => {
+        console.info(`[Revenium] ${message}`, ...args);
+    },
+    warn: (message, ...args) => {
+        console.warn(`[Revenium Warning] ${message}`, ...args);
+    },
+    error: (message, ...args) => {
+        console.error(`[Revenium Error] ${message}`, ...args);
+    },
+};
+let globalLogger = defaultLogger;
+/**
+ * Get the current global configuration
+ */
+export function getConfig() {
+    return globalConfig;
+}
+/**
+ * Set the global configuration
+ */
+export function setConfig(config) {
+    validateConfig(config);
+    globalConfig = config;
+    globalLogger.debug("Revenium configuration updated", {
+        baseUrl: config.reveniumBaseUrl,
+        hasReveniumKey: !!config.reveniumApiKey,
+        hasPerplexityKey: !!config.perplexityApiKey,
+    });
+}
+/**
+ * Get the current logger
+ */
+export function getLogger() {
+    return globalLogger;
+}
+/**
+ * Initialize configuration from environment variables
+ */
+export function initializeConfig() {
+    const envConfig = loadConfigFromEnv();
+    if (!envConfig) {
+        globalLogger.error("Failed to load configuration from environment. Ensure REVENIUM_METERING_API_KEY and PERPLEXITY_API_KEY are set.");
+        throw new Error("Failed to load configuration from environment. Ensure REVENIUM_METERING_API_KEY and PERPLEXITY_API_KEY are set.");
+    }
+    setConfig(envConfig);
+    globalLogger.debug("Revenium middleware initialized from environment variables");
+    return envConfig;
+}
+//# sourceMappingURL=manager.js.map

package/dist/esm/core/config/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/core/config/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD;;GAEG;AACH,IAAI,YAAY,GAA0B,IAAI,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7C,IAAI,YAAY,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,OAAO,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,OAAO,CAAC,IAAI,CAAC,sBAAsB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7C,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;CACF,CAAC;AAEF,IAAI,YAAY,GAAW,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,YAAY,GAAG,MAAM,CAAC;IACtB,YAAY,CAAC,KAAK,CAAC,gCAAgC,EAAE;QACnD,OAAO,EAAE,MAAM,CAAC,eAAe;QAC/B,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc;QACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB;KAC5C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IAEtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,YAAY,CAAC,KAAK,CAChB,iHAAiH,CAClH,CAAC;QACF,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,YAAY,CAAC,KAAK,CAChB,4DAA4D,CAC7D,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}