@revenium/perplexity 2.0.3 → 2.0.5

package/dist/cjs/core/providers/detector.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Provider Detection Module
+ *
+ * Handles provider metadata for Perplexity AI.
+ * Simplified compared to OpenAI modular since Perplexity doesn't have Azure variant.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProvider = detectProvider;
+exports.getProviderMetadata = getProviderMetadata;
+const index_js_1 = require("../config/index.js");
+// Global logger
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Get provider info for Perplexity
+ * Always returns Perplexity since there's no Azure variant
+ *
+ * @returns ProviderInfo with Perplexity provider
+ */
+function detectProvider() {
+    logger.debug("Using Perplexity AI provider");
+    return {
+        provider: "PERPLEXITY",
+        modelSource: "PERPLEXITY",
+    };
+}
+/**
+ * Get provider metadata for Revenium payload
+ *
+ * @returns metadata object for Revenium
+ */
+function getProviderMetadata() {
+    return {
+        provider: "Perplexity",
+        modelSource: "PERPLEXITY",
+    };
+}
+//# sourceMappingURL=detector.js.map

package/dist/cjs/core/providers/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../../src/core/providers/detector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAcH,wCAMC;AAOD,kDAQC;AAhCD,iDAA+C;AAE/C,gBAAgB;AAChB,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;AAE3B;;;;;GAKG;AACH,SAAgB,cAAc;IAC5B,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC7C,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,YAAY;KAC1B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB;IAIjC,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,YAAY;KAC1B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Providers module - Main exports
+ *
+ * This module provides a clean interface for provider detection and management.
+ * Simplified for Perplexity (no Azure variant).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProviderMetadata = exports.detectProvider = void 0;
+// Re-export all provider functionality
+var detector_js_1 = require("./detector.js");
+Object.defineProperty(exports, "detectProvider", { enumerable: true, get: function () { return detector_js_1.detectProvider; } });
+Object.defineProperty(exports, "getProviderMetadata", { enumerable: true, get: function () { return detector_js_1.getProviderMetadata; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/providers/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAAuC;AACvC,6CAAoE;AAA3D,6GAAA,cAAc,OAAA;AAAE,kHAAA,mBAAmB,OAAA"}

package/dist/cjs/core/tracking/api-client.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Revenium API Client Module
+ *
+ * Handles HTTP communication with the Revenium API.
+ * Extracted from tracking.ts for single responsibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendToRevenium = sendToRevenium;
+const index_js_1 = require("../config/index.js");
+const url_builder_js_1 = require("../../utils/url-builder.js");
+// Global logger
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Send payload to Revenium API
+ *
+ * This is the shared HTTP function that eliminates all duplication
+ * between chat completions and embeddings tracking.
+ *
+ * @param payload - The payload to send to Revenium
+ */
+async function sendToRevenium(payload) {
+    const config = (0, index_js_1.getConfig)();
+    if (!config)
+        return logger.warn("Revenium configuration not found, skipping tracking");
+    const url = (0, url_builder_js_1.buildReveniumUrl)(config.reveniumBaseUrl || "https://api.revenium.ai", "/ai/completions");
+    logger.debug("Sending Revenium API request", {
+        url,
+        operationType: payload.operationType,
+        transactionId: payload.transactionId,
+        model: payload.model,
+        totalTokens: payload.totalTokenCount,
+    });
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "x-api-key": config.reveniumApiKey,
+        },
+        body: JSON.stringify(payload),
+    });
+    logger.debug("Revenium API response", {
+        status: response.status,
+        statusText: response.statusText,
+        transactionId: payload.transactionId,
+        operationType: payload.operationType,
+    });
+    if (!response.ok) {
+        const responseText = await response.text();
+        logger.error("Revenium API error response", {
+            status: response.status,
+            statusText: response.statusText,
+            body: responseText,
+            transactionId: payload.transactionId,
+            operationType: payload.operationType,
+        });
+        throw new Error(`Revenium API error: ${response.status} ${response.statusText} - ${responseText}`);
+    }
+    const responseBody = await response.text();
+    logger.debug("Revenium tracking successful", {
+        transactionId: payload.transactionId,
+        operationType: payload.operationType,
+        response: responseBody,
+    });
+}
+//# sourceMappingURL=api-client.js.map

package/dist/cjs/core/tracking/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../../src/core/tracking/api-client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,wCAuDC;AArED,iDAA0D;AAC1D,+DAA8D;AAE9D,gBAAgB;AAChB,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;AAE3B;;;;;;;GAOG;AACI,KAAK,UAAU,cAAc,CAAC,OAAwB;IAC3D,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QACT,OAAO,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAG,IAAA,iCAAgB,EAC1B,MAAM,CAAC,eAAe,IAAI,yBAAyB,EACnD,iBAAiB,CAClB,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;QAC3C,GAAG;QACH,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,eAAe;KACrC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;YAC1B,WAAW,EAAE,MAAM,CAAC,cAAc;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACpC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE;YAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,YAAY;YAClB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,YAAY,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;QAC3C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Tracking module - Main exports
+ *
+ * This module provides a clean interface for usage tracking,
+ * separating concerns into focused sub-modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapStopReason = exports.trackUsageAsync = exports.sendReveniumMetrics = exports.buildPayload = exports.sendToRevenium = void 0;
+// Re-export all tracking functionality
+var api_client_js_1 = require("./api-client.js");
+Object.defineProperty(exports, "sendToRevenium", { enumerable: true, get: function () { return api_client_js_1.sendToRevenium; } });
+var payload_builder_js_1 = require("./payload-builder.js");
+Object.defineProperty(exports, "buildPayload", { enumerable: true, get: function () { return payload_builder_js_1.buildPayload; } });
+var usage_tracker_js_1 = require("./usage-tracker.js");
+Object.defineProperty(exports, "sendReveniumMetrics", { enumerable: true, get: function () { return usage_tracker_js_1.sendReveniumMetrics; } });
+Object.defineProperty(exports, "trackUsageAsync", { enumerable: true, get: function () { return usage_tracker_js_1.trackUsageAsync; } });
+// Export utility functions
+var stop_reason_mapper_js_1 = require("../../utils/stop-reason-mapper.js");
+Object.defineProperty(exports, "mapStopReason", { enumerable: true, get: function () { return stop_reason_mapper_js_1.mapStopReason; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/tracking/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAAuC;AACvC,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AAEvB,2DAAoD;AAA3C,kHAAA,YAAY,OAAA;AAErB,uDAA0E;AAAjE,uHAAA,mBAAmB,OAAA;AAAE,mHAAA,eAAe,OAAA;AAE7C,2BAA2B;AAC3B,2EAAkE;AAAzD,sHAAA,aAAa,OAAA"}

package/dist/cjs/core/tracking/payload-builder.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Payload Builder Module
+ *
+ * Handles construction of Revenium API payloads.
+ * Extracted from tracking.ts for single responsibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPayload = buildPayload;
+const crypto_1 = require("crypto");
+const index_js_1 = require("../config/index.js");
+const stop_reason_mapper_js_1 = require("../../utils/stop-reason-mapper.js");
+const metadata_builder_js_1 = require("../../utils/metadata-builder.js");
+const index_js_2 = require("../providers/index.js");
+// Global logger
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Build payload for Revenium API
+ *
+ * This shared payload builder eliminates payload duplication.
+ * Handles CHAT operation type for Perplexity.
+ *
+ * @param operationType - Type of operation (CHAT)
+ * @param response - API response from Perplexity
+ * @param request - Original request parameters
+ * @param startTime - Request start timestamp
+ * @param duration - Request duration in milliseconds
+ * @param providerInfo - Provider information (always Perplexity)
+ * @param timeToFirstToken - Time to first token in milliseconds (for streaming)
+ * @returns Constructed payload for Revenium API
+ */
+function buildPayload(operationType, response, request, startTime, duration, providerInfo, timeToFirstToken) {
+    const now = new Date().toISOString();
+    const requestTime = new Date(startTime).toISOString();
+    const usage = response.usage;
+    if (!usage) {
+        throw new Error("Response usage data is missing");
+    }
+    const modelName = response.model;
+    // Get provider metadata (always Perplexity)
+    const providerMetadata = providerInfo
+        ? (0, index_js_2.getProviderMetadata)()
+        : { provider: "Perplexity", modelSource: "PERPLEXITY" };
+    // Build metadata fields using utility (eliminates repetitive spreading)
+    const metadataFields = (0, metadata_builder_js_1.buildMetadataFields)(request.usageMetadata);
+    // Map Perplexity cost object to Revenium cost fields
+    const costFields = usage.cost
+        ? {
+            inputTokenCost: usage.cost.input_tokens_cost,
+            outputTokenCost: usage.cost.output_tokens_cost,
+            totalCost: usage.cost.total_cost,
+        }
+        : {
+            // Let Revenium calculate costs if not provided
+            inputTokenCost: undefined,
+            outputTokenCost: undefined,
+            totalCost: undefined,
+        };
+    // Common fields for all operations
+    const commonPayload = {
+        costType: "AI",
+        model: modelName,
+        responseTime: now,
+        requestDuration: duration,
+        provider: providerMetadata.provider,
+        modelSource: providerMetadata.modelSource,
+        requestTime,
+        completionStartTime: now,
+        // Common token counts
+        inputTokenCount: usage.prompt_tokens,
+        totalTokenCount: usage.total_tokens,
+        // Metadata fields (processed by utility)
+        ...metadataFields,
+        // Fixed middleware source identifier (spec format: revenium-{provider}-{language})
+        middlewareSource: "revenium-perplexity-node",
+        // Cost fields from Perplexity
+        ...costFields,
+    };
+    // Chat-specific fields
+    return {
+        ...commonPayload,
+        operationType: "CHAT",
+        transactionId: response.id || `chat-${(0, crypto_1.randomUUID)()}`,
+        outputTokenCount: usage.completion_tokens || 0,
+        // Perplexity doesn't support reasoning or caching
+        reasoningTokenCount: undefined,
+        cacheCreationTokenCount: undefined,
+        cacheReadTokenCount: undefined,
+        stopReason: (0, stop_reason_mapper_js_1.mapStopReason)(response.choices?.[0]?.finish_reason, logger),
+        isStreamed: Boolean(request.stream),
+        // Time to first token (for streaming requests)
+        timeToFirstToken: timeToFirstToken,
+    };
+}
+//# sourceMappingURL=payload-builder.js.map

package/dist/cjs/core/tracking/payload-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-builder.js","sourceRoot":"","sources":["../../../../src/core/tracking/payload-builder.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgCH,oCAoFC;AAlHD,mCAAoC;AAOpC,iDAA+C;AAC/C,6EAAkE;AAClE,yEAAsE;AACtE,oDAA4D;AAE5D,gBAAgB;AAChB,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,SAAgB,YAAY,CAC1B,aAAqB,EACrB,QAA4B,EAC5B,OAA8B,EAC9B,SAAiB,EACjB,QAAgB,EAChB,YAA2B,EAC3B,gBAAyB;IAEzB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC;IAEjC,4CAA4C;IAC5C,MAAM,gBAAgB,GAAG,YAAY;QACnC,CAAC,CAAC,IAAA,8BAAmB,GAAE;QACvB,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;IAE1D,wEAAwE;IACxE,MAAM,cAAc,GAAG,IAAA,yCAAmB,EAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAElE,qDAAqD;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI;QAC3B,CAAC,CAAC;YACE,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB;YAC5C,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB;YAC9C,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU;SACjC;QACH,CAAC,CAAC;YACE,+CAA+C;YAC/C,cAAc,EAAE,SAAS;YACzB,eAAe,EAAE,SAAS;YAC1B,SAAS,EAAE,SAAS;SACrB,CAAC;IAEN,mCAAmC;IACnC,MAAM,aAAa,GAAG;QACpB,QAAQ,EAAE,IAAa;QACvB,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE,QAAQ;QACzB,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;QACnC,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,WAAW;QACX,mBAAmB,EAAE,GAAG;QAExB,sBAAsB;QACtB,eAAe,EAAE,KAAK,CAAC,aAAa;QACpC,eAAe,EAAE,KAAK,CAAC,YAAY;QAEnC,yCAAyC;QACzC,GAAG,cAAc;QAEjB,mFAAmF;QACnF,gBAAgB,EAAE,0BAA0B;QAE5C,8BAA8B;QAC9B,GAAG,UAAU;KACd,CAAC;IAEF,uBAAuB;IACvB,OAAO;QACL,GAAG,aAAa;QAChB,aAAa,EAAE,MAAM;QACrB,aAAa,EAAE,QAAQ,CAAC,EAAE,IAAI,QAAQ,IAAA,mBAAU,GAAE,EAAE;QACpD,gBAAgB,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC;QAC9C,kDAAkD;QAClD,mBAAmB,EAAE,SAAS;QAC9B,uBAAuB,EAAE,SAAS;QAClC,mBAAmB,EAAE,SAAS;QAC9B,UAAU,EAAE,IAAA,qCAAa,EACvB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EACpC,MAAM,CACP;QACD,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,+CAA+C;QAC/C,gBAAgB,EAAE,gBAAgB;KACnC,CAAC;AACJ,CAAC"}

package/dist/cjs/core/tracking/usage-tracker.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Usage Tracker Module
+ *
+ * High-level tracking functions that combine payload building and API communication.
+ * Extracted from tracking.ts for better organization.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendReveniumMetrics = sendReveniumMetrics;
+exports.trackUsageAsync = trackUsageAsync;
+const index_js_1 = require("../config/index.js");
+const api_client_js_1 = require("./api-client.js");
+const payload_builder_js_1 = require("./payload-builder.js");
+const error_handler_js_1 = require("../../utils/error-handler.js");
+// Global logger
+const logger = (0, index_js_1.getLogger)();
+/**
+ * Chat completions tracking - thin wrapper
+ */
+async function sendReveniumMetrics(response, request, startTime, duration, providerInfo, timeToFirstToken) {
+    await (0, error_handler_js_1.safeAsyncOperation)(async () => {
+        const payload = (0, payload_builder_js_1.buildPayload)("CHAT", response, request, startTime, duration, providerInfo, timeToFirstToken);
+        await (0, api_client_js_1.sendToRevenium)(payload);
+    }, "Chat completion tracking", {
+        logError: true,
+        rethrow: false, // Don't rethrow to maintain fire-and-forget behavior
+        messagePrefix: "Chat completion tracking failed: ",
+    }, logger);
+}
+/**
+ * Fire-and-forget wrapper for chat completions
+ * Constructs DTO objects from simple tracking data to call sendReveniumMetrics
+ */
+function trackUsageAsync(trackingData) {
+    // Build DTO response object from tracking data
+    const dtoResponse = {
+        id: trackingData.requestId,
+        model: trackingData.model,
+        object: "chat.completion",
+        created: Math.floor(Date.now() / 1000),
+        usage: {
+            prompt_tokens: trackingData.promptTokens,
+            completion_tokens: trackingData.completionTokens,
+            total_tokens: trackingData.totalTokens,
+            cost: trackingData.cost,
+        },
+        choices: [
+            {
+                index: 0,
+                finish_reason: trackingData.finishReason,
+                message: {
+                    role: "assistant",
+                    content: "",
+                },
+            },
+        ],
+    };
+    // Build DTO request object from tracking data
+    const dtoRequest = {
+        model: trackingData.model,
+        messages: [],
+        usageMetadata: trackingData.usageMetadata,
+        stream: trackingData.isStreamed,
+    };
+    const startTime = Date.now() - trackingData.duration;
+    sendReveniumMetrics(dtoResponse, dtoRequest, startTime, trackingData.duration, trackingData.providerInfo, trackingData.timeToFirstToken)
+        .then(() => {
+        logger.debug("Usage tracking completed successfully", {
+            requestId: trackingData.requestId,
+            model: trackingData.model,
+            totalTokens: trackingData.totalTokens,
+            isStreamed: trackingData.isStreamed,
+        });
+    })
+        .catch((error) => {
+        logger.warn("Usage tracking failed", {
+            error: error instanceof Error ? error.message : String(error),
+            requestId: trackingData.requestId,
+            model: trackingData.model,
+        });
+    });
+}
+//# sourceMappingURL=usage-tracker.js.map

package/dist/cjs/core/tracking/usage-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracker.js","sourceRoot":"","sources":["../../../../src/core/tracking/usage-tracker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAoBH,kDA6BC;AAMD,0CAuEC;AArHD,iDAA+C;AAC/C,mDAAiD;AACjD,6DAAoD;AACpD,mEAAkE;AAElE,gBAAgB;AAChB,MAAM,MAAM,GAAG,IAAA,oBAAS,GAAE,CAAC;AAE3B;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAA4B,EAC5B,OAA8B,EAC9B,SAAiB,EACjB,QAAgB,EAChB,YAA2B,EAC3B,gBAAyB;IAEzB,MAAM,IAAA,qCAAkB,EACtB,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,IAAA,iCAAY,EAC1B,MAAM,EACN,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,gBAAgB,CACjB,CAAC;QACF,MAAM,IAAA,8BAAc,EAAC,OAAO,CAAC,CAAC;IAChC,CAAC,EACD,0BAA0B,EAC1B;QACE,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,KAAK,EAAE,qDAAqD;QACrE,aAAa,EAAE,mCAAmC;KACnD,EACD,MAAM,CACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,YAa/B;IACC,+CAA+C;IAC/C,MAAM,WAAW,GAAuB;QACtC,EAAE,EAAE,YAAY,CAAC,SAAS;QAC1B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACtC,KAAK,EAAE;YACL,aAAa,EAAE,YAAY,CAAC,YAAY;YACxC,iBAAiB,EAAE,YAAY,CAAC,gBAAgB;YAChD,YAAY,EAAE,YAAY,CAAC,WAAW;YACtC,IAAI,EAAE,YAAY,CAAC,IAAI;SACxB;QACD,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,CAAC;gBACR,aAAa,EAAE,YAAY,CAAC,YAAY;gBACxC,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF,CAAC;IAEF,8CAA8C;IAC9C,MAAM,UAAU,GAA0B;QACxC,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,QAAQ,EAAE,EAAE;QACZ,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,MAAM,EAAE,YAAY,CAAC,UAAU;KAChC,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC;IAErD,mBAAmB,CACjB,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,CAAC,QAAQ,EACrB,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,gBAAgB,CAC9B;SACE,IAAI,CAAC,GAAG,EAAE;QACT,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;YACpD,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,UAAU,EAAE,YAAY,CAAC,UAAU;SACpC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACnC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cjs/index.js

@@ -1,64 +1,70 @@
 "use strict";
 /**
- * Revenium Middleware for Perplexity
+ * Revenium Perplexity Middleware for TypeScript
  *
- * A lightweight middleware that adds Revenium metering to Perplexity API calls.
+ * This middleware tracks Perplexity AI usage and sends metrics to Revenium.
+ * Uses Go-aligned API pattern with Initialize/GetClient.
  *
- * @example
- * ```typescript
- * import {
- *   initializeReveniumFromEnv,
- *   initializePerplexityFromEnv,
- *   createChatCompletion,
- * } from '@revenium/perplexity';
+ * Environment Variables:
+ * REVENIUM_METERING_API_KEY=hak_your_api_key
+ * REVENIUM_METERING_BASE_URL=https://api.revenium.ai (optional)
+ * PERPLEXITY_API_KEY=pplx_your_perplexity_key
  *
- * // Initialize configurations
- * initializeReveniumFromEnv();
- * initializePerplexityFromEnv();
+ * Usage:
+ * import { Initialize, GetClient } from "@revenium/perplexity";
  *
- * // Create a chat completion
- * const result = await createChatCompletion({
- *   messages: [{ role: 'user', content: 'Hello!' }],
- *   model: 'sonar-pro',
- * });
+ * // Initialize from environment
+ * Initialize();
+ *
+ * // Get client
+ * const client = GetClient();
  *
- * console.log(result.content);
- * ```
+ * // Use client
+ * const response = await client.chat().completions().create({
+ *   model: "sonar",
+ *   messages: [{ role: "user", content: "Hello!" }]
+ * }, {
+ *   organizationId: "my-org",
+ *   productId: "my-app",
+ *   subscriber: {
+ *     id: "user-123",
+ *     email: "user@my-org.com"
+ *   }
+ * });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = exports.DEFAULT_MODEL = exports.PERPLEXITY_MODELS = exports.sendMeteringData = exports.buildMeteringData = exports.generateTransactionId = exports.createStreamingChatCompletion = exports.createChatCompletion = exports.getPerplexityConfig = exports.initializePerplexity = exports.initializePerplexityFromEnv = exports.enableRevenium = exports.disableRevenium = exports.isReveniumEnabled = exports.getReveniumConfig = exports.initializeRevenium = exports.initializeReveniumFromEnv = void 0;
-const dotenv_1 = require("dotenv");
-(0, dotenv_1.config)();
-// ============================================================================
-// Configuration
-// ============================================================================
-var revenium_config_1 = require("./core/config/revenium-config");
-Object.defineProperty(exports, "initializeReveniumFromEnv", { enumerable: true, get: function () { return revenium_config_1.initializeReveniumFromEnv; } });
-Object.defineProperty(exports, "initializeRevenium", { enumerable: true, get: function () { return revenium_config_1.initializeRevenium; } });
-Object.defineProperty(exports, "getReveniumConfig", { enumerable: true, get: function () { return revenium_config_1.getReveniumConfig; } });
-Object.defineProperty(exports, "isReveniumEnabled", { enumerable: true, get: function () { return revenium_config_1.isReveniumEnabled; } });
-Object.defineProperty(exports, "disableRevenium", { enumerable: true, get: function () { return revenium_config_1.disableRevenium; } });
-Object.defineProperty(exports, "enableRevenium", { enumerable: true, get: function () { return revenium_config_1.enableRevenium; } });
-var perplexity_config_1 = require("./core/config/perplexity-config");
-Object.defineProperty(exports, "initializePerplexityFromEnv", { enumerable: true, get: function () { return perplexity_config_1.initializePerplexityFromEnv; } });
-Object.defineProperty(exports, "initializePerplexity", { enumerable: true, get: function () { return perplexity_config_1.initializePerplexity; } });
-Object.defineProperty(exports, "getPerplexityConfig", { enumerable: true, get: function () { return perplexity_config_1.getPerplexityConfig; } });
-// ============================================================================
-// Core API
-// ============================================================================
-var perplexity_client_1 = require("./core/wrapper/perplexity-client");
-Object.defineProperty(exports, "createChatCompletion", { enumerable: true, get: function () { return perplexity_client_1.createChatCompletion; } });
-Object.defineProperty(exports, "createStreamingChatCompletion", { enumerable: true, get: function () { return perplexity_client_1.createStreamingChatCompletion; } });
-var metering_1 = require("./core/tracking/metering");
-Object.defineProperty(exports, "generateTransactionId", { enumerable: true, get: function () { return metering_1.generateTransactionId; } });
-Object.defineProperty(exports, "buildMeteringData", { enumerable: true, get: function () { return metering_1.buildMeteringData; } });
-Object.defineProperty(exports, "sendMeteringData", { enumerable: true, get: function () { return metering_1.sendMeteringData; } });
-var types_1 = require("./types");
-Object.defineProperty(exports, "PERPLEXITY_MODELS", { enumerable: true, get: function () { return types_1.PERPLEXITY_MODELS; } });
-Object.defineProperty(exports, "DEFAULT_MODEL", { enumerable: true, get: function () { return types_1.DEFAULT_MODEL; } });
-// ============================================================================
-// Utilities
-// ============================================================================
-var logger_1 = require("./utils/logger");
-Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+exports.PERPLEXITY_MODELS = exports.getProviderMetadata = exports.detectProvider = exports.trackUsageAsync = exports.StreamingWrapper = exports.CompletionsInterface = exports.ChatInterface = exports.ReveniumPerplexity = exports.Configure = exports.Reset = exports.IsInitialized = exports.GetClient = exports.Initialize = void 0;
+/**
+ * Main API - Go-aligned pattern
+ */
+var index_js_1 = require("./core/client/index.js");
+Object.defineProperty(exports, "Initialize", { enumerable: true, get: function () { return index_js_1.Initialize; } });
+Object.defineProperty(exports, "GetClient", { enumerable: true, get: function () { return index_js_1.GetClient; } });
+Object.defineProperty(exports, "IsInitialized", { enumerable: true, get: function () { return index_js_1.IsInitialized; } });
+Object.defineProperty(exports, "Reset", { enumerable: true, get: function () { return index_js_1.Reset; } });
+Object.defineProperty(exports, "Configure", { enumerable: true, get: function () { return index_js_1.Configure; } });
+/**
+ * Middleware classes
+ */
+var index_js_2 = require("./core/middleware/index.js");
+Object.defineProperty(exports, "ReveniumPerplexity", { enumerable: true, get: function () { return index_js_2.ReveniumPerplexity; } });
+Object.defineProperty(exports, "ChatInterface", { enumerable: true, get: function () { return index_js_2.ChatInterface; } });
+Object.defineProperty(exports, "CompletionsInterface", { enumerable: true, get: function () { return index_js_2.CompletionsInterface; } });
+Object.defineProperty(exports, "StreamingWrapper", { enumerable: true, get: function () { return index_js_2.StreamingWrapper; } });
+/**
+ * Tracking functions (for advanced use cases)
+ */
+var index_js_3 = require("./core/tracking/index.js");
+Object.defineProperty(exports, "trackUsageAsync", { enumerable: true, get: function () { return index_js_3.trackUsageAsync; } });
+/**
+ * Provider detection functions
+ */
+var index_js_4 = require("./core/providers/index.js");
+Object.defineProperty(exports, "detectProvider", { enumerable: true, get: function () { return index_js_4.detectProvider; } });
+Object.defineProperty(exports, "getProviderMetadata", { enumerable: true, get: function () { return index_js_4.getProviderMetadata; } });
+/**
+ * Model constants
+ */
+var models_js_1 = require("./constants/models.js");
+Object.defineProperty(exports, "PERPLEXITY_MODELS", { enumerable: true, get: function () { return models_js_1.PERPLEXITY_MODELS; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AA8BH;;GAEG;AACH,mDAMgC;AAL9B,sGAAA,UAAU,OAAA;AACV,qGAAA,SAAS,OAAA;AACT,yGAAA,aAAa,OAAA;AACb,iGAAA,KAAK,OAAA;AACL,qGAAA,SAAS,OAAA;AAGX;;GAEG;AACH,uDAKoC;AAJlC,8GAAA,kBAAkB,OAAA;AAClB,yGAAA,aAAa,OAAA;AACb,gHAAA,oBAAoB,OAAA;AACpB,4GAAA,gBAAgB,OAAA;AAGlB;;GAEG;AACH,qDAA2D;AAAlD,2GAAA,eAAe,OAAA;AAExB;;GAEG;AACH,sDAAgF;AAAvE,0GAAA,cAAc,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAE5C;;GAEG;AACH,mDAA0D;AAAjD,8GAAA,iBAAiB,OAAA"}

package/dist/cjs/types/function-parameters.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Function Parameter Types
+ *
+ * Comprehensive type definitions for function parameters throughout the middleware.
+ * These interfaces provide type safety by replacing 'any' types with proper,
+ * well-documented interfaces that match Perplexity API structures and internal requirements.
+ *
+ * @fileoverview Type-safe function parameter definitions
+ * @author Revenium
+ * @since 2.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=function-parameters.js.map

package/dist/cjs/types/function-parameters.js.map

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

package/dist/cjs/types/index.js

@@ -1,21 +1,25 @@
 "use strict";
 /**
- * TypeScript Type Definitions for Perplexity Middleware
+ * Core Types Module
+ *
+ * Central type definitions for the Revenium Perplexity middleware.
+ * This module exports all core types used throughout the application.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_MODEL = exports.PERPLEXITY_MODELS = void 0;
-// ============================================================================
-// Constants
-// ============================================================================
-exports.PERPLEXITY_MODELS = {
-    // Sonar Models (Online)
-    SONAR: "sonar",
-    SONAR_PRO: "sonar-pro",
-    SONAR_REASONING: "sonar-reasoning",
-    // Chat Models (Offline)
-    LLAMA_3_1_SONAR_SMALL_128K_CHAT: "llama-3.1-sonar-small-128k-chat",
-    LLAMA_3_1_SONAR_LARGE_128K_CHAT: "llama-3.1-sonar-large-128k-chat",
-    LLAMA_3_1_SONAR_HUGE_128K_CHAT: "llama-3.1-sonar-huge-128k-chat",
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-exports.DEFAULT_MODEL = exports.PERPLEXITY_MODELS.SONAR_PRO;
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export function parameter types
+__exportStar(require("./function-parameters.js"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,qCAAqC;AACrC,2DAAyC"}

package/dist/cjs/utils/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_MESSAGE_PATTERNS_TYPE_CONFIG = exports.MESSAGE_PATTERNS_TYPE_NETWORK = void 0;
+/**
+ * Error message patterns for network-related errors
+ */
+exports.MESSAGE_PATTERNS_TYPE_NETWORK = [
+    "network",
+    "timeout",
+    "ECONNRESET",
+];
+/**
+ * Error message patterns for configuration-related errors
+ */
+exports.ERROR_MESSAGE_PATTERNS_TYPE_CONFIG = [
+    "config",
+    "key",
+    "unauthorized",
+];
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,6BAA6B,GAAG;IAC3C,SAAS;IACT,SAAS;IACT,YAAY;CACb,CAAC;AAEF;;GAEG;AACU,QAAA,kCAAkC,GAAG;IAChD,QAAQ;IACR,KAAK;IACL,cAAc;CACf,CAAC"}