@revenium/perplexity 2.0.4 → 2.0.5

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,69 +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.MIDDLEWARE_INFO = exports.API_ENDPOINTS = exports.DEFAULT_CONFIG = exports.PERPLEXITY_PATTERNS = 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; } });
-// ============================================================================
-// Constants
-// ============================================================================
-var constants_1 = require("./constants");
-Object.defineProperty(exports, "PERPLEXITY_PATTERNS", { enumerable: true, get: function () { return constants_1.PERPLEXITY_PATTERNS; } });
-Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_CONFIG; } });
-Object.defineProperty(exports, "API_ENDPOINTS", { enumerable: true, get: function () { return constants_1.API_ENDPOINTS; } });
-Object.defineProperty(exports, "MIDDLEWARE_INFO", { enumerable: true, get: function () { return constants_1.MIDDLEWARE_INFO; } });
-// ============================================================================
-// 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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,mCAAgC;AAChC,IAAA,eAAM,GAAE,CAAC;AAET,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,iEAQuC;AAPrC,4HAAA,yBAAyB,OAAA;AACzB,qHAAA,kBAAkB,OAAA;AAClB,oHAAA,iBAAiB,OAAA;AACjB,oHAAA,iBAAiB,OAAA;AACjB,kHAAA,eAAe,OAAA;AACf,iHAAA,cAAc,OAAA;AAIhB,qEAKyC;AAJvC,gIAAA,2BAA2B,OAAA;AAC3B,yHAAA,oBAAoB,OAAA;AACpB,wHAAA,mBAAmB,OAAA;AAIrB,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,sEAG0C;AAFxC,yHAAA,oBAAoB,OAAA;AACpB,kIAAA,6BAA6B,OAAA;AAG/B,qDAIkC;AAHhC,iHAAA,qBAAqB,OAAA;AACrB,6GAAA,iBAAiB,OAAA;AACjB,4GAAA,gBAAgB,OAAA;AAoBlB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,yCAKqB;AAJnB,gHAAA,mBAAmB,OAAA;AACnB,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,4GAAA,eAAe,OAAA;AAGjB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,yCAAwC;AAA/B,gGAAA,MAAM,OAAA"}
+{"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,6 +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.
  */
+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);
+};
 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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"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"}

package/dist/cjs/utils/error-handler.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Error Handler Utilities
+ *
+ * Centralized error handling patterns to eliminate repetitive try/catch blocks
+ * and provide consistent error logging and recovery strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.ConfigurationError = exports.ValidationError = void 0;
+exports.safeAsyncOperation = safeAsyncOperation;
+exports.safeSyncOperation = safeSyncOperation;
+exports.validateOrThrow = validateOrThrow;
+exports.validateOrUndefined = validateOrUndefined;
+exports.withRetry = withRetry;
+exports.classifyError = classifyError;
+const constants_js_1 = require("./constants.js");
+/**
+ * Default error handling strategy
+ */
+const DEFAULT_STRATEGY = {
+    logError: true,
+    rethrow: true,
+    messagePrefix: '',
+    fallbackValue: undefined,
+    transformError: (error) => (error instanceof Error ? error : new Error(String(error))),
+};
+/**
+ * Safe async operation wrapper with comprehensive error handling
+ *
+ * @param operation - The async operation to execute
+ * @param context - Context information for logging
+ * @param strategy - Error handling strategy
+ * @param logger - Logger instance
+ * @returns Promise with result or fallback value
+ */
+async function safeAsyncOperation(operation, context, strategy = {}, logger) {
+    const config = { ...DEFAULT_STRATEGY, ...strategy };
+    try {
+        return await operation();
+    }
+    catch (error) {
+        const transformedError = config.transformError(error);
+        if (config.logError && logger) {
+            logger.error(`${config.messagePrefix}${context}`, {
+                error: transformedError.message,
+                stack: transformedError.stack,
+            });
+        }
+        if (config.rethrow)
+            throw transformedError;
+        return config.fallbackValue;
+    }
+}
+/**
+ * Safe sync operation wrapper
+ *
+ * @param operation - The sync operation to execute
+ * @param context - Context information for logging
+ * @param strategy - Error handling strategy
+ * @param logger - Logger instance
+ * @returns Result or fallback value
+ */
+function safeSyncOperation(operation, context, strategy = {}, logger) {
+    const config = { ...DEFAULT_STRATEGY, ...strategy };
+    try {
+        return operation();
+    }
+    catch (error) {
+        const transformedError = config.transformError(error);
+        if (config.logError && logger) {
+            logger.error(`${config.messagePrefix}${context}`, {
+                error: transformedError.message,
+                stack: transformedError.stack,
+            });
+        }
+        if (config.rethrow)
+            throw transformedError;
+        return config.fallbackValue;
+    }
+}
+/**
+ * Validation wrapper that provides clear error messages
+ *
+ * @param value - Value to validate
+ * @param validator - Validation function
+ * @param errorMessage - Error message if validation fails
+ * @returns Validated value
+ */
+function validateOrThrow(value, validator, errorMessage) {
+    if (!validator(value))
+        throw new Error(errorMessage);
+    return value;
+}
+/**
+ * Validation wrapper that returns undefined on failure
+ *
+ * @param value - Value to validate
+ * @param validator - Validation function
+ * @param logger - Optional logger for warnings
+ * @param context - Context for logging
+ * @returns Validated value or undefined
+ */
+function validateOrUndefined(value, validator, logger, context) {
+    if (!validator(value)) {
+        if (logger && context) {
+            logger.warn(`Validation failed: ${context}`, { value });
+        }
+        return;
+    }
+    return value;
+}
+/**
+ * Create a retry wrapper for operations that might fail temporarily
+ *
+ * @param operation - Operation to retry
+ * @param maxRetries - Maximum number of retries
+ * @param delayMs - Delay between retries in milliseconds
+ * @param logger - Logger for retry attempts
+ * @returns Promise with operation result
+ */
+async function withRetry(operation, maxRetries = 3, delayMs = 1000, logger) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxRetries) {
+                break;
+            }
+            if (logger) {
+                logger.warn(`Operation failed, retrying (${attempt}/${maxRetries})`, {
+                    error: lastError.message,
+                    nextRetryIn: delayMs,
+                });
+            }
+            await new Promise(resolve => setTimeout(resolve, delayMs));
+        }
+    }
+    // eslint-disable-next-line no-throw-literal
+    throw lastError;
+}
+/**
+ * Common error types for better error handling
+ */
+class ValidationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class ConfigurationError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class NetworkError extends Error {
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error classification utility
+ */
+function classifyError(error) {
+    if (error instanceof ValidationError) {
+        return { type: 'validation', message: error.message, isRetryable: false };
+    }
+    if (error instanceof ConfigurationError) {
+        return { type: 'configuration', message: error.message, isRetryable: false };
+    }
+    if (error instanceof NetworkError) {
+        return { type: 'network', message: error.message, isRetryable: true };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    // Classify based on message patterns
+    if (constants_js_1.MESSAGE_PATTERNS_TYPE_NETWORK.some(pattern => message.includes(pattern))) {
+        return { type: 'network', message, isRetryable: true };
+    }
+    if (constants_js_1.ERROR_MESSAGE_PATTERNS_TYPE_CONFIG.some(pattern => message.includes(pattern))) {
+        return { type: 'configuration', message, isRetryable: false };
+    }
+    return { type: 'unknown', message, isRetryable: false };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/cjs/utils/error-handler.js.map

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