@revenium/perplexity 2.0.4 → 2.0.6

package/dist/types/core/tracking/api-client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Revenium API Client Module
+ *
+ * Handles HTTP communication with the Revenium API.
+ * Extracted from tracking.ts for single responsibility.
+ */
+import { ReveniumPayload } from "../../types";
+/**
+ * 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
+ */
+export declare function sendToRevenium(payload: ReveniumPayload): Promise<void>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/types/core/tracking/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../../src/core/tracking/api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/types/core/tracking/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tracking module - Main exports
+ *
+ * This module provides a clean interface for usage tracking,
+ * separating concerns into focused sub-modules.
+ */
+export { sendToRevenium } from './api-client.js';
+export { buildPayload } from './payload-builder.js';
+export { sendReveniumMetrics, trackUsageAsync } from './usage-tracker.js';
+export { mapStopReason } from '../../utils/stop-reason-mapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/tracking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/tracking/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/types/core/tracking/payload-builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Payload Builder Module
+ *
+ * Handles construction of Revenium API payloads.
+ * Extracted from tracking.ts for single responsibility.
+ */
+import { ReveniumPayload, PerplexityResponse, PerplexityChatRequest, ProviderInfo } from "../../types/index.js";
+/**
+ * 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
+ */
+export declare function buildPayload(operationType: "CHAT", response: PerplexityResponse, request: PerplexityChatRequest, startTime: number, duration: number, providerInfo?: ProviderInfo, timeToFirstToken?: number): ReveniumPayload;
+//# sourceMappingURL=payload-builder.d.ts.map

package/dist/types/core/tracking/payload-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-builder.d.ts","sourceRoot":"","sources":["../../../../src/core/tracking/payload-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAS9B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,EAC3B,gBAAgB,CAAC,EAAE,MAAM,GACxB,eAAe,CA4EjB"}

package/dist/types/core/tracking/usage-tracker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Usage Tracker Module
+ *
+ * High-level tracking functions that combine payload building and API communication.
+ * Extracted from tracking.ts for better organization.
+ */
+import { UsageMetadata, ProviderInfo, PerplexityResponse, PerplexityChatRequest, PerplexityCost } from "../../types/index.js";
+/**
+ * Chat completions tracking - thin wrapper
+ */
+export declare function sendReveniumMetrics(response: PerplexityResponse, request: PerplexityChatRequest, startTime: number, duration: number, providerInfo?: ProviderInfo, timeToFirstToken?: number): Promise<void>;
+/**
+ * Fire-and-forget wrapper for chat completions
+ * Constructs DTO objects from simple tracking data to call sendReveniumMetrics
+ */
+export declare function trackUsageAsync(trackingData: {
+    requestId: string;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    duration: number;
+    finishReason: string | null;
+    usageMetadata?: UsageMetadata;
+    isStreamed?: boolean;
+    timeToFirstToken?: number;
+    providerInfo?: ProviderInfo;
+    cost?: PerplexityCost;
+}): void;
+//# sourceMappingURL=usage-tracker.d.ts.map

package/dist/types/core/tracking/usage-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracker.d.ts","sourceRoot":"","sources":["../../../../src/core/tracking/usage-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,YAAY,EAC3B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,GAAG,IAAI,CA0DP"}

package/dist/types/index.d.ts

@@ -1,34 +1,58 @@
 /**
- * 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"
+ *   }
+ * });
+ */
+/**
+ * Core types for TypeScript developers using Revenium middleware
+ */
+export type { ReveniumConfig, UsageMetadata, Logger, ProviderInfo, Subscriber, Credential, ReveniumPayload, MeteringData, } from "./types/index.js";
+/**
+ * Perplexity API types
+ */
+export type { PerplexityChatRequest, PerplexityChatResponse, PerplexityMessage, PerplexityChoice, PerplexityUsage, PerplexityStreamChunk, PerplexityResponse, TrackingData, } from "./types/function-parameters.js";
+/**
+ * Main API - Go-aligned pattern
+ */
+export { Initialize, GetClient, IsInitialized, Reset, Configure, } from "./core/client/index.js";
+/**
+ * Middleware classes
+ */
+export { ReveniumPerplexity, ChatInterface, CompletionsInterface, StreamingWrapper, } from "./core/middleware/index.js";
+/**
+ * Tracking functions (for advanced use cases)
+ */
+export { trackUsageAsync } from "./core/tracking/index.js";
+/**
+ * Provider detection functions
  */
-export { initializeReveniumFromEnv, initializeRevenium, getReveniumConfig, isReveniumEnabled, disableRevenium, enableRevenium, type ReveniumConfig, } from "./core/config/revenium-config";
-export { initializePerplexityFromEnv, initializePerplexity, getPerplexityConfig, type PerplexityConfig, } from "./core/config/perplexity-config";
-export { createChatCompletion, createStreamingChatCompletion, } from "./core/wrapper/perplexity-client";
-export { generateTransactionId, buildMeteringData, sendMeteringData, } from "./core/tracking/metering";
-export type { PerplexityMessage, PerplexityChatRequest, PerplexityUsage, PerplexityChoice, PerplexityResponse, PerplexityStreamChunk, UsageMetadata, MeteringData, ChatCompletionResult, StreamingResult, } from "./types";
-export { PERPLEXITY_PATTERNS, DEFAULT_CONFIG, API_ENDPOINTS, MIDDLEWARE_INFO, } from "./constants";
-export { logger } from "./utils/logger";
+export { detectProvider, getProviderMetadata } from "./core/providers/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAMlC,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;GAEG;AACH,YAAY,EACV,cAAc,EACd,aAAa,EACb,MAAM,EACN,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,GACb,MAAM,gCAAgC,CAAC;AAExC;;GAEG;AACH,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/types/function-parameters.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 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
+ */
+import { UsageMetadata } from "./index.js";
+/**
+ * Perplexity API response structure for chat completions
+ *
+ * Represents the complete response structure returned by Perplexity's chat completions API.
+ * Includes usage statistics, response choices, and metadata. Used internally for
+ * processing responses and extracting usage metrics.
+ *
+ * @public
+ */
+export interface PerplexityChatResponse {
+    /** Unique identifier for the chat completion */
+    id: string;
+    /** Model used for the completion */
+    model: string;
+    /** Token usage statistics */
+    usage: {
+        /** Number of tokens in the prompt */
+        prompt_tokens: number;
+        /** Number of tokens in the completion */
+        completion_tokens: number;
+        /** Total tokens used (prompt + completion) */
+        total_tokens: number;
+    };
+    /** Array of completion choices */
+    choices: Array<{
+        /** Reason why the completion finished */
+        finish_reason: string | null;
+        /** Complete message (for non-streaming responses) */
+        message?: {
+            /** Message content */
+            content: string;
+            /** Message role (assistant, user, system) */
+            role: string;
+        };
+        /** Delta message (for streaming responses) */
+        delta?: {
+            /** Incremental content */
+            content?: string;
+            /** Message role */
+            role?: string;
+        };
+    }>;
+    /** Unix timestamp of when the completion was created */
+    created?: number;
+    /** Object type identifier */
+    object?: string;
+}
+/**
+ * Perplexity API request structure for chat completions
+ *
+ * Represents the request parameters sent to Perplexity's chat completions API.
+ * Includes model selection, messages, and optional parameters.
+ *
+ * @public
+ */
+export interface PerplexityChatRequest {
+    /** Model to use for the completion */
+    model: string;
+    /** Array of messages in the conversation */
+    messages: Array<{
+        /** Message role */
+        role: "system" | "user" | "assistant";
+        /** Message content */
+        content: string;
+    }>;
+    /** Maximum number of tokens to generate */
+    max_tokens?: number;
+    /** Temperature for sampling */
+    temperature?: number;
+    /** Top-p for nucleus sampling */
+    top_p?: number;
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Presence penalty */
+    presence_penalty?: number;
+    /** Frequency penalty */
+    frequency_penalty?: number;
+    /** Usage metadata for Revenium tracking (custom field, not sent to Perplexity) */
+    usageMetadata?: UsageMetadata;
+}
+/**
+ * Perplexity message structure
+ */
+export interface PerplexityMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/**
+ * Perplexity cost breakdown (specific to Perplexity API)
+ */
+export interface PerplexityCost {
+    input_tokens_cost: number;
+    output_tokens_cost: number;
+    request_cost: number;
+    total_cost: number;
+}
+/**
+ * Perplexity usage statistics
+ */
+export interface PerplexityUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    search_context_size?: string;
+    cost?: PerplexityCost;
+}
+/**
+ * Perplexity choice structure
+ */
+export interface PerplexityChoice {
+    index: number;
+    message?: {
+        role: string;
+        content: string;
+    };
+    delta?: {
+        role?: string;
+        content?: string;
+    };
+    finish_reason: string | null;
+}
+/**
+ * Perplexity response structure
+ */
+export interface PerplexityResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: PerplexityChoice[];
+    usage?: PerplexityUsage;
+}
+/**
+ * Perplexity stream chunk structure
+ */
+export interface PerplexityStreamChunk {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: PerplexityChoice[];
+}
+/**
+ * Tracking data structure for usage tracking
+ *
+ * Contains all necessary information for tracking API usage with Revenium.
+ * Used internally by the tracking system.
+ *
+ * @internal
+ */
+export interface TrackingData {
+    /** Unique request identifier */
+    requestId: string;
+    /** Model used for the request */
+    model: string;
+    /** Number of prompt tokens */
+    promptTokens: number;
+    /** Number of completion tokens */
+    completionTokens: number;
+    /** Total number of tokens */
+    totalTokens: number;
+    /** Request duration in milliseconds */
+    duration: number;
+    /** Finish reason from the API */
+    finishReason: string | null;
+    /** Usage metadata */
+    usageMetadata?: UsageMetadata;
+    /** Whether the request was streamed */
+    isStreamed?: boolean;
+    /** Time to first token (for streaming) */
+    timeToFirstToken?: number;
+}
+//# sourceMappingURL=function-parameters.d.ts.map

package/dist/types/types/function-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-parameters.d.ts","sourceRoot":"","sources":["../../../src/types/function-parameters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE;QACL,qCAAqC;QACrC,aAAa,EAAE,MAAM,CAAC;QACtB,yCAAyC;QACzC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,8CAA8C;QAC9C,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,kCAAkC;IAClC,OAAO,EAAE,KAAK,CAAC;QACb,yCAAyC;QACzC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,qDAAqD;QACrD,OAAO,CAAC,EAAE;YACR,sBAAsB;YACtB,OAAO,EAAE,MAAM,CAAC;YAChB,6CAA6C;YAC7C,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,8CAA8C;QAC9C,KAAK,CAAC,EAAE;YACN,0BAA0B;YAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,mBAAmB;YACnB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC,CAAC;IACH,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,CAAC;QACd,mBAAmB;QACnB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;QACtC,sBAAsB;QACtB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qBAAqB;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/types/index.d.ts

@@ -1,151 +1,130 @@
 /**
- * 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.
  */
-export interface PerplexityMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-export interface PerplexityChatRequest {
-    model: string;
-    messages: PerplexityMessage[];
-    max_tokens?: number;
-    temperature?: number;
-    top_p?: number;
-    stream?: boolean;
-    presence_penalty?: number;
-    frequency_penalty?: number;
-}
-export interface PerplexityUsage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-}
-export interface PerplexityChoice {
-    index: number;
-    message?: {
-        role: string;
-        content: string;
-    };
-    delta?: {
-        role?: string;
-        content?: string;
-    };
-    finish_reason: string | null;
-}
-export interface PerplexityResponse {
-    id: string;
-    object: string;
-    created: number;
-    model: string;
-    choices: PerplexityChoice[];
-    usage?: PerplexityUsage;
+export * from "./function-parameters.js";
+/**
+ * Credential information for subscriber authentication
+ */
+export interface Credential {
+    /** The name/type of the credential */
+    name: string;
+    /** The credential value */
+    value: string;
 }
-export interface PerplexityStreamChunk {
-    id: string;
-    object: string;
-    created: number;
-    model: string;
-    choices: PerplexityChoice[];
+/**
+ * Subscriber information for Revenium API
+ */
+export interface Subscriber {
+    /** Unique identifier for the subscriber/user */
+    id?: string;
+    /** Email address of the subscriber */
+    email?: string;
+    /** Optional authentication credential for the subscriber */
+    credential?: Credential;
 }
+/**
+ * Usage metadata interface for tracking additional context
+ */
 export interface UsageMetadata {
-    subscriber?: {
-        id: string;
-        email?: string;
-        credential?: {
-            name: string;
-            value: string;
-        };
-    };
+    /** User identification information */
+    subscriber?: Subscriber;
+    /** Organization or company identifier */
     organizationId?: string;
-    subscriptionId?: string;
+    /** Product or application identifier */
     productId?: string;
-    transactionId?: string;
-    traceId?: string;
-    inputTokenCount?: number;
-    outputTokenCount?: number;
-    totalTokenCount?: number;
-    reasoningTokenCount?: number;
-    cacheCreationTokenCount?: number;
-    cacheReadTokenCount?: number;
-    requestTime?: string;
-    responseTime?: string;
-    completionStartTime?: string;
-    timeToFirstToken?: number;
-    operationType?: string;
+    /** Subscription identifier */
+    subscriptionId?: string;
+    /** Task type classification */
     taskType?: string;
-    agent?: string;
-    stopReason?: string;
-    costType?: string;
+    /** Distributed tracing identifier */
+    traceId?: string;
+    /** Quality score for response evaluation (0.0-1.0 scale) */
     responseQualityScore?: number;
-    subscriberId?: string;
-    subscriberEmail?: string;
-    subscriberCredentialName?: string;
-    subscriberCredential?: string;
+    /** Agent or model variant identifier */
+    agent?: string;
 }
 /**
- * Metering data sent to Revenium
- * Field order matches the expected API format
+ * Provider information for tracking API source
  */
-export interface MeteringData {
-    stopReason: string;
-    costType: string;
-    isStreamed: boolean;
-    taskType: string;
-    agent: string;
-    operationType: string;
-    inputTokenCount: number;
-    outputTokenCount: number;
-    reasoningTokenCount: number;
-    cacheCreationTokenCount: number;
-    cacheReadTokenCount: number;
-    totalTokenCount: number;
-    organizationId: string;
-    productId: string;
-    subscriber: {
-        id: string;
-        email: string;
-        credential: {
-            name: string;
-            value: string;
-        };
-    };
+export interface ProviderInfo {
+    /** The detected AI provider type */
+    provider: string;
+    /** Model source identifier */
+    modelSource: string;
+}
+/**
+ * Logger interface aligned with Go implementation
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Revenium configuration interface
+ */
+export interface ReveniumConfig {
+    /** Revenium API key */
+    reveniumApiKey: string;
+    /** Revenium base URL */
+    reveniumBaseUrl: string;
+    /** Perplexity API key */
+    perplexityApiKey?: string;
+    /** Perplexity base URL */
+    perplexityBaseUrl?: string;
+    /** Debug mode flag */
+    debug?: boolean;
+    /** Custom logger */
+    logger?: Logger;
+}
+/**
+ * Configuration interface (alias for backward compatibility)
+ */
+export interface Config extends ReveniumConfig {
+}
+/**
+ * Revenium API payload structure
+ */
+export interface ReveniumPayload {
+    costType: "AI";
     model: string;
-    transactionId: string;
     responseTime: string;
     requestDuration: number;
     provider: string;
+    modelSource: string;
     requestTime: string;
     completionStartTime: string;
-    timeToFirstToken: number;
-    middlewareSource: string;
-    traceId?: string;
-}
-export interface ChatCompletionResult {
-    content: string;
-    role: string;
-    finishReason: string | null;
-    usage: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    model: string;
-    transactionId: string;
-    rawResponse: PerplexityResponse;
-}
-export interface StreamingResult {
-    stream: AsyncGenerator<PerplexityStreamChunk>;
+    inputTokenCount: number;
+    outputTokenCount: number;
+    totalTokenCount: number;
+    reasoningTokenCount?: number;
+    cacheCreationTokenCount?: number;
+    cacheReadTokenCount?: number;
+    organizationId?: string;
+    subscriptionId?: string;
+    productId?: string;
+    subscriber?: Subscriber;
     transactionId: string;
-    model: string;
-}
-export interface ReveniumConfig {
-    meteringApiKey: string;
-    meteringBaseUrl: string;
-    teamId?: string;
-    enabled: boolean;
+    traceId?: string;
+    taskType?: string;
+    operationType: "CHAT" | "EMBED";
+    stopReason: string;
+    isStreamed: boolean;
+    timeToFirstToken?: number;
+    agent?: string;
+    responseQualityScore?: number;
+    middlewareSource: string;
+    inputTokenCost?: number;
+    outputTokenCost?: number;
+    totalCost?: number;
 }
-export interface PerplexityConfig {
-    apiKey: string;
-    baseUrl: string;
+/**
+ * Metering data interface (legacy, for backward compatibility)
+ */
+export interface MeteringData extends ReveniumPayload {
 }
 //# sourceMappingURL=index.d.ts.map