@revenium/perplexity 2.0.3 → 2.0.5

package/SECURITY.md

@@ -0,0 +1,34 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this package, please report it to us.
+
+**DO NOT** create a public GitHub issue for security vulnerabilities.
+
+### How to Report
+
+Email: support@revenium.io
+
+Please include:
+- Package name and version
+- Description of the vulnerability
+- Steps to reproduce (if applicable)
+- Potential impact
+- Suggested fix (if available)
+
+We will review and respond to security reports in a timely manner.
+
+## Security Best Practices
+
+When using this middleware:
+
+1. **API Keys**: Never commit API keys to version control
+2. **Environment Variables**: Use environment variables for sensitive configuration
+3. **PII Handling**: Ensure no PII is sent to Revenium unless explicitly configured for billing purposes
+4. **Network Security**: Always use HTTPS connections
+5. **Updates**: Keep the package updated to the latest version
+
+## Additional Resources
+
+- [Revenium Documentation](https://docs.revenium.io)

package/dist/cjs/constants/models.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * 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!" }]
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERPLEXITY_MODELS = void 0;
+/**
+ * Available Perplexity AI models
+ * @see https://docs.perplexity.ai/docs/model-cards
+ */
+exports.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/cjs/constants/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/constants/models.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH;;;GAGG;AACU,QAAA,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/cjs/core/client/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Client module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Configure = exports.Reset = exports.IsInitialized = exports.GetClient = exports.Initialize = void 0;
+var manager_js_1 = require("./manager.js");
+Object.defineProperty(exports, "Initialize", { enumerable: true, get: function () { return manager_js_1.Initialize; } });
+Object.defineProperty(exports, "GetClient", { enumerable: true, get: function () { return manager_js_1.GetClient; } });
+Object.defineProperty(exports, "IsInitialized", { enumerable: true, get: function () { return manager_js_1.IsInitialized; } });
+Object.defineProperty(exports, "Reset", { enumerable: true, get: function () { return manager_js_1.Reset; } });
+Object.defineProperty(exports, "Configure", { enumerable: true, get: function () { return manager_js_1.Configure; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,2CAAsF;AAA7E,wGAAA,UAAU,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,2GAAA,aAAa,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,uGAAA,SAAS,OAAA"}

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

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Client Manager - singleton pattern
+ *
+ * Provides Initialize/GetClient pattern.
+ * Manages singleton instance of ReveniumPerplexity client.
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Initialize = Initialize;
+exports.Configure = Configure;
+exports.GetClient = GetClient;
+exports.IsInitialized = IsInitialized;
+exports.Reset = Reset;
+const revenium_client_js_1 = require("../middleware/revenium-client.js");
+const manager_js_1 = require("../config/manager.js");
+const validator_js_1 = require("../config/validator.js");
+/**
+ * Singleton instance of ReveniumPerplexity client
+ */
+let clientInstance = null;
+const logger = (0, manager_js_1.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
+ */
+function Initialize() {
+    logger.debug("Initializing Revenium Perplexity client");
+    const config = (0, manager_js_1.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
+ *
+ */
+function Configure(config) {
+    logger.debug("Configuring Revenium Perplexity client");
+    // Validate configuration (including API key formats)
+    (0, validator_js_1.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 revenium_client_js_1.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
+ *
+ */
+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
+ */
+function IsInitialized() {
+    return clientInstance !== null;
+}
+/**
+ * Reset the client instance (useful for testing)
+ */
+function Reset() {
+    clientInstance = null;
+}
+//# sourceMappingURL=manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/core/client/manager.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAsBH,gCAOC;AASD,8BAkBC;AASD,8BAOC;AAMD,sCAEC;AAKD,sBAEC;AArFD,yEAAsE;AAEtE,qDAAmE;AACnE,yDAAwD;AAExD;;GAEG;AACH,IAAI,cAAc,GAA8B,IAAI,CAAC;AACrD,MAAM,MAAM,GAAG,IAAA,sBAAS,GAAE,CAAC;AAG3B;;;;;;;GAOG;AACH,SAAgB,UAAU;IACxB,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,IAAA,6BAAgB,GAAE,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,CAAC;IAElB,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,MAAsB;IAC9C,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAEvD,qDAAqD;IACrD,IAAA,6BAAc,EAAC,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,uCAAkB,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,SAAgB,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,SAAgB,aAAa;IAC3B,OAAO,cAAc,KAAK,IAAI,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK;IACnB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Configuration module - Main exports
+ *
+ * This module provides a clean interface for configuration management.
+ * Aligned with OpenAI modular implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLogger = exports.initializeConfig = exports.getLogger = exports.setConfig = exports.getConfig = exports.validateConfig = exports.loadConfigFromEnv = void 0;
+// Re-export all configuration functionality
+var loader_js_1 = require("./loader.js");
+Object.defineProperty(exports, "loadConfigFromEnv", { enumerable: true, get: function () { return loader_js_1.loadConfigFromEnv; } });
+var validator_js_1 = require("./validator.js");
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return validator_js_1.validateConfig; } });
+var manager_js_1 = require("./manager.js");
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return manager_js_1.getConfig; } });
+Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return manager_js_1.setConfig; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return manager_js_1.getLogger; } });
+Object.defineProperty(exports, "initializeConfig", { enumerable: true, get: function () { return manager_js_1.initializeConfig; } });
+Object.defineProperty(exports, "defaultLogger", { enumerable: true, get: function () { return manager_js_1.defaultLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,+CAAgD;AAAvC,8GAAA,cAAc,OAAA;AAEvB,2CAMsB;AALpB,uGAAA,SAAS,OAAA;AACT,uGAAA,SAAS,OAAA;AACT,uGAAA,SAAS,OAAA;AACT,8GAAA,gBAAgB,OAAA;AAChB,2GAAA,aAAa,OAAA"}

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

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Configuration Loader Module
+ *
+ * Handles loading configuration from environment variables.
+ * Separated from validation and management for single responsibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigFromEnv = loadConfigFromEnv;
+const dotenv_1 = require("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
+ */
+function loadConfigFromEnv() {
+    if (!envFileLoaded) {
+        (0, dotenv_1.config)();
+        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/cjs/core/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../../src/core/config/loader.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAoBH,8CA2BC;AA5CD,mCAA8C;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,SAAgB,iBAAiB;IAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAA,eAAU,GAAE,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/cjs/core/config/manager.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Configuration Manager Module
+ *
+ * Handles global configuration state management and logging.
+ * Aligned with OpenAI modular implementation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLogger = void 0;
+exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+exports.getLogger = getLogger;
+exports.initializeConfig = initializeConfig;
+const loader_js_1 = require("./loader.js");
+const validator_js_1 = require("./validator.js");
+/**
+ * Global configuration instance
+ */
+let globalConfig = null;
+/**
+ * Default console logger implementation
+ */
+exports.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 = exports.defaultLogger;
+/**
+ * Get the current global configuration
+ */
+function getConfig() {
+    return globalConfig;
+}
+/**
+ * Set the global configuration
+ */
+function setConfig(config) {
+    (0, validator_js_1.validateConfig)(config);
+    globalConfig = config;
+    globalLogger.debug("Revenium configuration updated", {
+        baseUrl: config.reveniumBaseUrl,
+        hasReveniumKey: !!config.reveniumApiKey,
+        hasPerplexityKey: !!config.perplexityApiKey,
+    });
+}
+/**
+ * Get the current logger
+ */
+function getLogger() {
+    return globalLogger;
+}
+/**
+ * Initialize configuration from environment variables
+ */
+function initializeConfig() {
+    const envConfig = (0, loader_js_1.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/cjs/core/config/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/core/config/manager.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAuCH,8BAEC;AAKD,8BAQC;AAKD,8BAEC;AAKD,4CAkBC;AAjFD,2CAAgD;AAChD,iDAAgD;AAIhD;;GAEG;AACH,IAAI,YAAY,GAA0B,IAAI,CAAC;AAG/C;;GAEG;AACU,QAAA,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,qBAAa,CAAC;AAEzC;;GAEG;AACH,SAAgB,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,MAAsB;IAC9C,IAAA,6BAAc,EAAC,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,SAAgB,SAAS;IACvB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,SAAS,GAAG,IAAA,6BAAiB,GAAE,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"}

package/dist/cjs/core/config/validator.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Configuration Validator Module
+ *
+ * Handles validation of configuration objects.
+ * Separated from loading and management for single responsibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+/**
+ * Validate Revenium configuration
+ */
+function validateConfig(config) {
+    if (!config.reveniumApiKey) {
+        throw new Error("Revenium API key is required. Set REVENIUM_METERING_API_KEY environment variable or provide reveniumApiKey in config.");
+    }
+    if (!config.reveniumApiKey.startsWith("hak_")) {
+        throw new Error('Invalid Revenium API key format. Revenium API keys should start with "hak_"');
+    }
+    // Validate Revenium URL format (base URL should always be provided by loader with default)
+    if (config.reveniumBaseUrl) {
+        try {
+            new URL(config.reveniumBaseUrl);
+        }
+        catch (error) {
+            throw new Error(`Invalid Revenium base URL format: ${config.reveniumBaseUrl}`);
+        }
+    }
+    if (!config.perplexityApiKey) {
+        throw new Error("Perplexity API key is required. Set PERPLEXITY_API_KEY environment variable or provide perplexityApiKey in config.");
+    }
+    if (!config.perplexityApiKey.startsWith("pplx-")) {
+        throw new Error('Invalid Perplexity API key format. Perplexity API keys should start with "pplx-"');
+    }
+    // Validate Perplexity URL format (base URL should always be provided by loader with default)
+    if (config.perplexityBaseUrl) {
+        try {
+            new URL(config.perplexityBaseUrl);
+        }
+        catch (error) {
+            throw new Error(`Invalid Perplexity base URL format: ${config.perplexityBaseUrl}`);
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/cjs/core/config/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../../src/core/config/validator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAOH,wCA8CC;AAjDD;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAsB;IACnD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,2FAA2F;IAC3F,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,eAAe,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,oHAAoH,CACrH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IAED,6FAA6F;IAC7F,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,iBAAiB,EAAE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/core/middleware/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Middleware module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingWrapper = exports.CompletionsInterface = exports.ChatInterface = exports.ReveniumPerplexity = void 0;
+var revenium_client_js_1 = require("./revenium-client.js");
+Object.defineProperty(exports, "ReveniumPerplexity", { enumerable: true, get: function () { return revenium_client_js_1.ReveniumPerplexity; } });
+var interfaces_js_1 = require("./interfaces.js");
+Object.defineProperty(exports, "ChatInterface", { enumerable: true, get: function () { return interfaces_js_1.ChatInterface; } });
+Object.defineProperty(exports, "CompletionsInterface", { enumerable: true, get: function () { return interfaces_js_1.CompletionsInterface; } });
+var streaming_wrapper_js_1 = require("./streaming-wrapper.js");
+Object.defineProperty(exports, "StreamingWrapper", { enumerable: true, get: function () { return streaming_wrapper_js_1.StreamingWrapper; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/core/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/middleware/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,iDAAsE;AAA7D,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAC5C,+DAA0D;AAAjD,wHAAA,gBAAgB,OAAA"}

package/dist/cjs/core/middleware/interfaces.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Middleware interfaces for Perplexity API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletionsInterface = exports.ChatInterface = void 0;
+const index_js_1 = require("../config/index.js");
+const transaction_id_js_1 = require("../../utils/transaction-id.js");
+const index_js_2 = require("../tracking/index.js");
+const streaming_wrapper_js_1 = require("./streaming-wrapper.js");
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Chat interface - provides access to chat completions
+ */
+class ChatInterface {
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Get completions interface
+     */
+    completions() {
+        return new CompletionsInterface(this.client, this.config);
+    }
+}
+exports.ChatInterface = ChatInterface;
+/**
+ * Completions interface - handles chat completion requests
+ */
+class CompletionsInterface {
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Create a chat completion
+     */
+    async create(params, metadata) {
+        const startTime = new Date();
+        const transactionId = (0, transaction_id_js_1.generateTransactionId)();
+        try {
+            logger.debug(`[Revenium] Creating chat completion with model: ${params.model}`);
+            const response = await this.client.chat.completions.create(params);
+            const endTime = Date.now();
+            const duration = endTime - startTime.getTime();
+            // Track usage asynchronously (fire-and-forget - errors handled internally)
+            if ("usage" in response && response.usage) {
+                // Extract cost if available (Perplexity-specific)
+                const usage = response.usage;
+                (0, index_js_2.trackUsageAsync)({
+                    requestId: ("id" in response ? response.id : null) || transactionId,
+                    model: params.model,
+                    promptTokens: response.usage.prompt_tokens,
+                    completionTokens: response.usage.completion_tokens,
+                    totalTokens: response.usage.total_tokens,
+                    duration,
+                    finishReason: "choices" in response
+                        ? response.choices[0]?.finish_reason || null
+                        : null,
+                    usageMetadata: metadata,
+                    isStreamed: false,
+                    cost: usage.cost,
+                });
+            }
+            return response;
+        }
+        catch (error) {
+            logger.error(`[Revenium] Error in chat completion: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Create a streaming chat completion
+     */
+    async createStreaming(params, metadata) {
+        const startTime = new Date();
+        const transactionId = (0, transaction_id_js_1.generateTransactionId)();
+        try {
+            logger.debug(`[Revenium] Creating streaming chat completion with model: ${params.model}`);
+            const stream = await this.client.chat.completions.create({
+                ...params,
+                stream: true,
+            });
+            return new streaming_wrapper_js_1.StreamingWrapper(stream, params.model, startTime, transactionId, metadata, this.config);
+        }
+        catch (error) {
+            logger.error(`[Revenium] Error in streaming chat completion: ${error.message}`);
+            throw error;
+        }
+    }
+}
+exports.CompletionsInterface = CompletionsInterface;
+//# sourceMappingURL=interfaces.js.map

package/dist/cjs/core/middleware/interfaces.js.map

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

package/dist/cjs/core/middleware/revenium-client.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Revenium Perplexity Client
+ *
+ * Main client class that wraps Perplexity API with Revenium tracking
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReveniumPerplexity = void 0;
+const openai_1 = __importDefault(require("openai"));
+const interfaces_js_1 = require("./interfaces.js");
+/**
+ * Revenium Perplexity client with usage tracking
+ */
+class ReveniumPerplexity {
+    constructor(config) {
+        this.config = config;
+        this.client = new openai_1.default({
+            apiKey: config.perplexityApiKey,
+            baseURL: config.perplexityBaseUrl,
+        });
+        if (config.debug) {
+            console.log("[Revenium] Perplexity client created", {
+                baseURL: config.perplexityBaseUrl,
+            });
+        }
+    }
+    /**
+     * Get chat interface
+     */
+    chat() {
+        return new interfaces_js_1.ChatInterface(this.client, this.config);
+    }
+    /**
+     * Get underlying OpenAI client (for advanced use cases)
+     */
+    getUnderlyingClient() {
+        return this.client;
+    }
+}
+exports.ReveniumPerplexity = ReveniumPerplexity;
+//# sourceMappingURL=revenium-client.js.map

package/dist/cjs/core/middleware/revenium-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenium-client.js","sourceRoot":"","sources":["../../../../src/core/middleware/revenium-client.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,oDAA4B;AAC5B,mDAAgD;AAGhD;;GAEG;AACH,MAAa,kBAAkB;IAI7B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,gBAAgB;YAC/B,OAAO,EAAE,MAAM,CAAC,iBAAiB;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE;gBAClD,OAAO,EAAE,MAAM,CAAC,iBAAiB;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,6BAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AA/BD,gDA+BC"}

package/dist/cjs/core/middleware/streaming-wrapper.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Streaming wrapper for Perplexity API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingWrapper = void 0;
+const index_js_1 = require("../config/index.js");
+const index_js_2 = require("../tracking/index.js");
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Wrapper for streaming responses that tracks usage
+ */
+class StreamingWrapper {
+    constructor(stream, model, startTime, transactionId, metadata, config) {
+        this.stream = stream;
+        this.model = model;
+        this.startTime = startTime;
+        this.transactionId = transactionId;
+        this.metadata = metadata;
+        this.config = config || {};
+    }
+    /**
+     * Iterate over stream chunks
+     */
+    async *[Symbol.asyncIterator]() {
+        let lastChunk = null;
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let totalTokens = 0;
+        let costData = undefined;
+        let firstChunkTime = null;
+        let timeToFirstToken = 0;
+        try {
+            for await (const chunk of this.stream) {
+                // Capture time of first chunk
+                if (!firstChunkTime) {
+                    firstChunkTime = new Date();
+                    timeToFirstToken =
+                        firstChunkTime.getTime() - this.startTime.getTime();
+                }
+                lastChunk = chunk;
+                // Track usage if available in chunk
+                if (chunk.usage) {
+                    inputTokens = chunk.usage.prompt_tokens || 0;
+                    outputTokens = chunk.usage.completion_tokens || 0;
+                    totalTokens = chunk.usage.total_tokens || 0;
+                    // Extract cost data if available (Perplexity-specific)
+                    if (chunk.usage.cost) {
+                        costData = chunk.usage.cost;
+                    }
+                }
+                yield chunk;
+            }
+            // Send metering data when stream completes (fire-and-forget)
+            const endTime = Date.now();
+            const duration = endTime - this.startTime.getTime();
+            // fire-and-forget
+            (0, index_js_2.trackUsageAsync)({
+                requestId: this.transactionId,
+                model: this.model,
+                promptTokens: inputTokens,
+                completionTokens: outputTokens,
+                totalTokens,
+                duration,
+                finishReason: lastChunk?.choices?.[0]?.finish_reason || null,
+                usageMetadata: this.metadata,
+                isStreamed: true,
+                timeToFirstToken,
+                cost: costData,
+            });
+        }
+        catch (error) {
+            // Log error
+            logger.error("[Revenium] Error in stream processing:", error.message);
+            throw error;
+        }
+    }
+}
+exports.StreamingWrapper = StreamingWrapper;
+//# sourceMappingURL=streaming-wrapper.js.map

package/dist/cjs/core/middleware/streaming-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-wrapper.js","sourceRoot":"","sources":["../../../../src/core/middleware/streaming-wrapper.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,iDAA+C;AAC/C,mDAAuD;AAEvD,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;AAE3B;;GAEG;AACH,MAAa,gBAAgB;IAQ3B,YACE,MAA0B,EAC1B,KAAa,EACb,SAAe,EACf,aAAqB,EACrB,QAAwB,EACxB,MAAY;QAEZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,IAAI,SAAS,GAAQ,IAAI,CAAC;QAC1B,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,QAAQ,GAAQ,SAAS,CAAC;QAC9B,IAAI,cAAc,GAAgB,IAAI,CAAC;QACvC,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACtC,8BAA8B;gBAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC;oBAC5B,gBAAgB;wBACd,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACxD,CAAC;gBAED,SAAS,GAAG,KAAK,CAAC;gBAElB,oCAAoC;gBACpC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAChB,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;oBAC7C,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC;oBAClD,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;oBAC5C,uDAAuD;oBACvD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;wBACrB,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;YAED,6DAA6D;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAEpD,kBAAkB;YAClB,IAAA,0BAAe,EAAC;gBACd,SAAS,EAAE,IAAI,CAAC,aAAa;gBAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,YAAY,EAAE,WAAW;gBACzB,gBAAgB,EAAE,YAAY;gBAC9B,WAAW;gBACX,QAAQ;gBACR,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,IAAI;gBAC5D,aAAa,EAAE,IAAI,CAAC,QAAQ;gBAC5B,UAAU,EAAE,IAAI;gBAChB,gBAAgB;gBAChB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,YAAY;YACZ,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AArFD,4CAqFC"}