@revenium/perplexity 2.0.4 → 2.0.5

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

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

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

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

package/dist/types/constants/models.d.ts

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

package/dist/types/constants/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/constants/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

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

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

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

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

package/dist/types/core/client/manager.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Client Manager - singleton pattern
+ *
+ * Provides Initialize/GetClient pattern.
+ * Manages singleton instance of ReveniumPerplexity client.
+ *
+ */
+import { ReveniumPerplexity } from "../middleware/revenium-client.js";
+import type { ReveniumConfig } from "../../types/index.js";
+/**
+ * Initialize Revenium Perplexity client from environment variables
+ *
+ * Loads configuration from environment:
+ * - REVENIUM_METERING_API_KEY (required)
+ * - PERPLEXITY_API_KEY (required)
+ * @throws {Error} If required environment variables are missing
+ */
+export declare function Initialize(): void;
+/**
+ * Configure Revenium Perplexity client with custom configuration
+ *
+ * @param config - Configuration object
+ * @throws {Error} If required configuration fields are missing
+ *
+ */
+export declare function Configure(config: ReveniumConfig): void;
+/**
+ * Get the singleton ReveniumPerplexity client instance
+ *
+ * @returns {ReveniumPerplexity} The client instance
+ * @throws {Error} If client has not been initialized
+ *
+ */
+export declare function GetClient(): ReveniumPerplexity;
+/**
+ * Check if client has been initialized
+ * @returns {boolean} True if client is initialized
+ */
+export declare function IsInitialized(): boolean;
+/**
+ * Reset the client instance (useful for testing)
+ */
+export declare function Reset(): void;
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/core/client/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/core/client/manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAkBtD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAO9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}

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

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

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

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

package/dist/types/core/config/loader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Configuration Loader Module
+ *
+ * Handles loading configuration from environment variables.
+ * Separated from validation and management for single responsibility.
+ */
+import { ReveniumConfig } from "../../types/index.js";
+/**
+ * Load configuration from environment variables
+ * Automatically loads .env file from current directory if present
+ */
+export declare function loadConfigFromEnv(): ReveniumConfig | null;
+//# sourceMappingURL=loader.d.ts.map

package/dist/types/core/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/core/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AActD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CA2BzD"}

package/dist/types/core/config/manager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Configuration Manager Module
+ *
+ * Handles global configuration state management and logging.
+ * Aligned with OpenAI modular implementation.
+ */
+import { ReveniumConfig, Logger } from "../../types/index.js";
+/**
+ * Default console logger implementation
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Get the current global configuration
+ */
+export declare function getConfig(): ReveniumConfig | null;
+/**
+ * Set the global configuration
+ */
+export declare function setConfig(config: ReveniumConfig): void;
+/**
+ * Get the current logger
+ */
+export declare function getLogger(): Logger;
+/**
+ * Initialize configuration from environment variables
+ */
+export declare function initializeConfig(): ReveniumConfig;
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/core/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/core/config/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAY9D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAe3B,CAAC;AAIF;;GAEG;AACH,wBAAgB,SAAS,IAAI,cAAc,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAQtD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAkBjD"}

package/dist/types/core/config/validator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration Validator Module
+ *
+ * Handles validation of configuration objects.
+ * Separated from loading and management for single responsibility.
+ */
+import { ReveniumConfig } from "../../types/index.js";
+/**
+ * Validate Revenium configuration
+ */
+export declare function validateConfig(config: ReveniumConfig): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/types/core/config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/core/config/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CA8C3D"}

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

@@ -0,0 +1,7 @@
+/**
+ * Middleware module exports
+ */
+export { ReveniumPerplexity } from "./revenium-client.js";
+export { ChatInterface, CompletionsInterface } from "./interfaces.js";
+export { StreamingWrapper } from "./streaming-wrapper.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/core/middleware/interfaces.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Middleware interfaces for Perplexity API
+ */
+import type OpenAI from "openai";
+import type { UsageMetadata } from "../../types";
+import { StreamingWrapper } from "./streaming-wrapper.js";
+/**
+ * Chat interface - provides access to chat completions
+ */
+export declare class ChatInterface {
+    private client;
+    private config;
+    constructor(client: OpenAI, config: any);
+    /**
+     * Get completions interface
+     */
+    completions(): CompletionsInterface;
+}
+/**
+ * Completions interface - handles chat completion requests
+ */
+export declare class CompletionsInterface {
+    private client;
+    private config;
+    constructor(client: OpenAI, config: any);
+    /**
+     * Create a chat completion
+     */
+    create(params: OpenAI.Chat.ChatCompletionCreateParams, metadata?: UsageMetadata): Promise<any>;
+    /**
+     * Create a streaming chat completion
+     */
+    createStreaming(params: OpenAI.Chat.ChatCompletionCreateParams, metadata?: UsageMetadata): Promise<StreamingWrapper>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/types/core/middleware/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/core/middleware/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,MAAM;gBAA9B,MAAM,EAAE,MAAM,EAAU,MAAM,EAAE,GAAG;IAEvD;;OAEG;IACH,WAAW,IAAI,oBAAoB;CAGpC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,MAAM;gBAA9B,MAAM,EAAE,MAAM,EAAU,MAAM,EAAE,GAAG;IAEvD;;OAEG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAC9C,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,GAAG,CAAC;IA2Cf;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAC9C,QAAQ,CAAC,EAAE,aAAa;CA8B3B"}

package/dist/types/core/middleware/revenium-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Revenium Perplexity Client
+ *
+ * Main client class that wraps Perplexity API with Revenium tracking
+ */
+import OpenAI from "openai";
+import { ChatInterface } from "./interfaces.js";
+import type { ReveniumConfig } from "../../types/index.js";
+/**
+ * Revenium Perplexity client with usage tracking
+ */
+export declare class ReveniumPerplexity {
+    private client;
+    private config;
+    constructor(config: ReveniumConfig);
+    /**
+     * Get chat interface
+     */
+    chat(): ChatInterface;
+    /**
+     * Get underlying OpenAI client (for advanced use cases)
+     */
+    getUnderlyingClient(): OpenAI;
+}
+//# sourceMappingURL=revenium-client.d.ts.map

package/dist/types/core/middleware/revenium-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenium-client.d.ts","sourceRoot":"","sources":["../../../../src/core/middleware/revenium-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;IAclC;;OAEG;IACH,IAAI,IAAI,aAAa;IAIrB;;OAEG;IACH,mBAAmB,IAAI,MAAM;CAG9B"}

package/dist/types/core/middleware/streaming-wrapper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Streaming wrapper for Perplexity API
+ */
+import type { UsageMetadata } from "../../types";
+/**
+ * Wrapper for streaming responses that tracks usage
+ */
+export declare class StreamingWrapper {
+    private stream;
+    private model;
+    private startTime;
+    private transactionId;
+    private metadata?;
+    private config;
+    constructor(stream: AsyncIterable<any>, model: string, startTime: Date, transactionId: string, metadata?: UsageMetadata, config?: any);
+    /**
+     * Iterate over stream chunks
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<any>;
+}
+//# sourceMappingURL=streaming-wrapper.d.ts.map

package/dist/types/core/middleware/streaming-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/core/middleware/streaming-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,MAAM,CAAM;gBAGlB,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,IAAI,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,aAAa,EACxB,MAAM,CAAC,EAAE,GAAG;IAUd;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC;CA0DrD"}

package/dist/types/core/providers/detector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Provider Detection Module
+ *
+ * Handles provider metadata for Perplexity AI.
+ * Simplified compared to OpenAI modular since Perplexity doesn't have Azure variant.
+ */
+import { ProviderInfo } from "../../types/index.js";
+/**
+ * Get provider info for Perplexity
+ * Always returns Perplexity since there's no Azure variant
+ *
+ * @returns ProviderInfo with Perplexity provider
+ */
+export declare function detectProvider(): ProviderInfo;
+/**
+ * Get provider metadata for Revenium payload
+ *
+ * @returns metadata object for Revenium
+ */
+export declare function getProviderMetadata(): {
+    provider: string;
+    modelSource: string;
+};
+//# sourceMappingURL=detector.d.ts.map

package/dist/types/core/providers/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../../src/core/providers/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAM7C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAKA"}

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

@@ -0,0 +1,8 @@
+/**
+ * Providers module - Main exports
+ *
+ * This module provides a clean interface for provider detection and management.
+ * Simplified for Perplexity (no Azure variant).
+ */
+export { detectProvider, getProviderMetadata } from "./detector.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

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,63 @@
 /**
- * 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);
- * ```
- */
-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";
+ * // 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 { detectProvider, getProviderMetadata } from "./core/providers/index.js";
+/**
+ * Model constants
+ */
+export { PERPLEXITY_MODELS } from "./constants/models.js";
+export type { PerplexityModel } from "./constants/models.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;AAEhF;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}