@revenium/perplexity 2.0.3 → 2.0.5

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

@@ -1,159 +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;
+    /** 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;
+    /** Distributed tracing identifier */
+    traceId?: string;
+    /** Quality score for response evaluation (0.0-1.0 scale) */
+    responseQualityScore?: number;
+    /** Agent or model variant identifier */
     agent?: string;
-    stopReason?: string;
-    costType?: string;
-    subscriberId?: string;
-    subscriberEmail?: string;
-    subscriberCredentialName?: string;
-    subscriberCredential?: 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;
-    middleware_source: 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 {
 }
-export declare const PERPLEXITY_MODELS: {
-    readonly SONAR: "sonar";
-    readonly SONAR_PRO: "sonar-pro";
-    readonly SONAR_REASONING: "sonar-reasoning";
-    readonly LLAMA_3_1_SONAR_SMALL_128K_CHAT: "llama-3.1-sonar-small-128k-chat";
-    readonly LLAMA_3_1_SONAR_LARGE_128K_CHAT: "llama-3.1-sonar-large-128k-chat";
-    readonly LLAMA_3_1_SONAR_HUGE_128K_CHAT: "llama-3.1-sonar-huge-128k-chat";
-};
-export type PerplexityModel = (typeof PERPLEXITY_MODELS)[keyof typeof PERPLEXITY_MODELS];
-export declare const DEFAULT_MODEL: PerplexityModel;
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Error message patterns for network-related errors
+ */
+export declare const MESSAGE_PATTERNS_TYPE_NETWORK: string[];
+/**
+ * Error message patterns for configuration-related errors
+ */
+export declare const ERROR_MESSAGE_PATTERNS_TYPE_CONFIG: string[];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,6BAA6B,UAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,UAI9C,CAAC"}

package/dist/types/utils/error-handler.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Error Handler Utilities
+ *
+ * Centralized error handling patterns to eliminate repetitive try/catch blocks
+ * and provide consistent error logging and recovery strategies.
+ */
+import { Logger } from '../types/index.js';
+/**
+ * Error handling strategy configuration
+ */
+export interface ErrorHandlingStrategy {
+    /** Whether to log the error */
+    logError?: boolean;
+    /** Whether to re-throw the error */
+    rethrow?: boolean;
+    /** Custom error message prefix */
+    messagePrefix?: string;
+    /** Fallback value to return on error */
+    fallbackValue?: unknown;
+    /** Custom error transformation function */
+    transformError?: (error: unknown) => 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
+ */
+export declare function safeAsyncOperation<T>(operation: () => Promise<T>, context: string, strategy?: ErrorHandlingStrategy, logger?: Logger): Promise<T | undefined>;
+/**
+ * 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
+ */
+export declare function safeSyncOperation<T>(operation: () => T, context: string, strategy?: ErrorHandlingStrategy, logger?: Logger): T | undefined;
+/**
+ * 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
+ */
+export declare function validateOrThrow<T>(value: unknown, validator: (value: unknown) => value is T, errorMessage: string): T;
+/**
+ * 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
+ */
+export declare function validateOrUndefined<T>(value: unknown, validator: (value: unknown) => value is T, logger?: Logger, context?: string): T | undefined;
+/**
+ * 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
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, maxRetries?: number, delayMs?: number, logger?: Logger): Promise<T>;
+/**
+ * Common error types for better error handling
+ */
+export declare class ValidationError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+export declare class ConfigurationError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+export declare class NetworkError extends Error {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Error classification utility
+ */
+export declare function classifyError(error: unknown): {
+    type: 'validation' | 'configuration' | 'network' | 'unknown';
+    message: string;
+    isRetryable: boolean;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/types/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;CAC5C;AAaD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAA0B,EACpC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAkBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAA0B,EACpC,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,GAAG,SAAS,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACzC,YAAY,EAAE,MAAM,GACnB,CAAC,CAGH;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACzC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,CAAC,GAAG,SAAS,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,OAAO,GAAE,MAAa,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,YAAa,SAAQ,KAAK;aAGnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBADjD,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAC7C,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB,CAwBA"}

package/dist/types/utils/metadata-builder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Metadata Builder Utilities
+ *
+ * Centralized metadata handling to eliminate repetitive spreading
+ * and provide consistent metadata processing across the codebase.
+ */
+import { UsageMetadata } from '../types/index.js';
+/**
+ * Build metadata object for payload inclusion
+ *
+ * This function eliminates the repetitive spreading pattern and provides
+ * a clean, testable way to handle metadata transformation.
+ * Subscriber object is passed through directly without transformation.
+ *
+ * @param usageMetadata - Source metadata from request
+ * @returns Clean metadata object for payload
+ */
+export declare function buildMetadataFields(usageMetadata?: UsageMetadata): Record<string, unknown>;
+/**
+ * Validate metadata completeness for specific use cases
+ *
+ * @param usageMetadata - Metadata to validate
+ * @param requiredFields - List of required field names
+ * @returns Validation result
+ */
+export declare function validateMetadata(usageMetadata?: UsageMetadata, requiredFields?: (keyof UsageMetadata)[]): {
+    isValid: boolean;
+    missingFields: string[];
+    warnings: string[];
+};
+/**
+ * Merge multiple metadata sources with priority
+ *
+ * @param sources - Metadata sources in priority order (first wins)
+ * @returns Merged metadata object
+ */
+export declare function mergeMetadata(...sources: (UsageMetadata | undefined)[]): UsageMetadata;
+/**
+ * Extract metadata from request parameters safely
+ *
+ * @param params - Request parameters that might contain usageMetadata
+ * @returns Extracted metadata and cleaned parameters
+ */
+export declare function extractMetadata<T extends Record<string, unknown>>(params: T & {
+    usageMetadata?: UsageMetadata;
+}): {
+    metadata: UsageMetadata | undefined;
+    cleanParams: Omit<T, 'usageMetadata'>;
+};
+/**
+ * Create a metadata context for consistent logging
+ * Uses sanitization to protect PII (emails are masked)
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Logging context object with sanitized PII
+ */
+export declare function createLoggingContext(usageMetadata?: UsageMetadata): Record<string, unknown>;
+/**
+ * Sanitize metadata for logging (remove sensitive fields)
+ *
+ * @param usageMetadata - Source metadata
+ * @returns Sanitized metadata safe for logging
+ */
+export declare function sanitizeMetadataForLogging(usageMetadata?: UsageMetadata): Record<string, unknown>;
+//# sourceMappingURL=metadata-builder.d.ts.map

package/dist/types/utils/metadata-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-builder.d.ts","sourceRoot":"","sources":["../../../src/utils/metadata-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAuC9D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB1F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,CAAC,EAAE,aAAa,EAC7B,cAAc,GAAE,CAAC,MAAM,aAAa,CAAC,EAAO,GAC3C;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAqCA;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,OAAO,EAAE,CAAC,aAAa,GAAG,SAAS,CAAC,EAAE,GAAG,aAAa,CAQtF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,MAAM,EAAE,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,GAC5C;IACD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;CACvC,CAMA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB3F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BjG"}

package/dist/types/utils/stop-reason-mapper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Stop Reason Mapper Utilities
+ *
+ * Centralized stop reason mapping logic using lookup tables
+ * instead of nested conditionals. Based on the good example
+ * from the anthropic-node middleware.
+ */
+/**
+ * Map provider stop reasons to Revenium stop reasons
+ *
+ * This replaces the nested if/switch logic with a clean lookup table approach.
+ * Based on the good example from the anthropic-node middleware.
+ *
+ * @param providerStopReason - Stop reason from the AI provider
+ * @param logger - Optional logger for warnings about unknown reasons
+ * @returns Standardized Revenium stop reason
+ */
+export declare function mapStopReason(providerStopReason: string | null | undefined, logger?: {
+    warn: (message: string, ...args: any[]) => void;
+}): string;
+/**
+ * Get all supported stop reasons for documentation/testing
+ */
+export declare function getSupportedStopReasons(): string[];
+/**
+ * Check if a stop reason is supported
+ */
+export declare function isStopReasonSupported(reason: string): boolean;
+//# sourceMappingURL=stop-reason-mapper.d.ts.map

package/dist/types/utils/stop-reason-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reason-mapper.d.ts","sourceRoot":"","sources":["../../../src/utils/stop-reason-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7C,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAE,GAC3D,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/types/utils/transaction-id.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Transaction ID Generator
+ *
+ * Generates unique transaction IDs for tracking requests.
+ * Format: txn_{timestamp}_{random}
+ */
+/**
+ * Generate a unique transaction ID
+ *
+ * @returns A unique transaction ID in format: txn_{timestamp}_{random}
+ *
+ */
+export declare function generateTransactionId(): string;
+//# sourceMappingURL=transaction-id.d.ts.map

package/dist/types/utils/transaction-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-id.d.ts","sourceRoot":"","sources":["../../../src/utils/transaction-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/types/utils/url-builder.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 declare function buildReveniumUrl(baseUrl: string, endpoint: string): string;
+/**
+ * Validate URL format
+ *
+ * @param url - URL to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidUrl(url: string): boolean;
+//# sourceMappingURL=url-builder.d.ts.map

package/dist/types/utils/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../../src/utils/url-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2B1E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C"}