@revenium/anthropic 1.0.7 → 1.0.9

package/dist/esm/utils/validation.js

@@ -2,7 +2,7 @@
  * Validation utilities for Anthropic middleware
  * Provides type-safe validation with detailed error reporting
  */
-import { VALIDATION_CONFIG, ANTHROPIC_PATTERNS } from '../constants.js';
+import { VALIDATION_CONFIG, ANTHROPIC_PATTERNS, DEFAULT_CONFIG } from '../constants.js';
 /**
  * Type guard for checking if a value is a non-null object
  */
@@ -128,38 +128,40 @@ export function validateReveniumConfig(config) {
     else if (cfg?.reveniumApiKey?.length < VALIDATION_CONFIG.MIN_API_KEY_LENGTH) {
         warnings.push('reveniumApiKey appears to be too short - verify it is correct');
     }
-    // Validate Revenium base URL
-    if (!isString(cfg?.reveniumBaseUrl)) {
-        errors.push('reveniumBaseUrl is required and must be a string');
-    }
-    else if (!cfg?.reveniumBaseUrl?.trim()) {
-        errors.push('reveniumBaseUrl cannot be empty');
-    }
-    else {
-        try {
-            const url = new URL(cfg?.reveniumBaseUrl);
-            if (!url.protocol.startsWith('http')) {
-                errors.push('reveniumBaseUrl must use HTTP or HTTPS protocol');
+    // Validate Revenium base URL (optional - defaults to https://api.revenium.ai)
+    if (cfg?.reveniumBaseUrl !== undefined) {
+        if (!isString(cfg?.reveniumBaseUrl)) {
+            errors.push('reveniumBaseUrl must be a string if provided');
+        }
+        else if (!cfg?.reveniumBaseUrl?.trim()) {
+            errors.push('reveniumBaseUrl cannot be empty if provided');
+        }
+        else {
+            try {
+                const url = new URL(cfg?.reveniumBaseUrl);
+                if (!url.protocol.startsWith('http')) {
+                    errors.push('reveniumBaseUrl must use HTTP or HTTPS protocol');
+                }
+                // Check for localhost/development hostnames (IPv4, IPv6, and named)
+                const localhostHostnames = ['localhost', '127.0.0.1', '::1', '[::1]'];
+                if (localhostHostnames.includes(url.hostname)) {
+                    warnings.push('Using localhost for Revenium API - ensure this is intended for development');
+                }
             }
-            // Check for localhost/development hostnames (IPv4, IPv6, and named)
-            const localhostHostnames = ['localhost', '127.0.0.1', '::1', '[::1]'];
-            if (localhostHostnames.includes(url.hostname)) {
-                warnings.push('Using localhost for Revenium API - ensure this is intended for development');
+            catch {
+                errors.push('reveniumBaseUrl must be a valid URL');
+                suggestions.push('Use format: https://api.revenium.ai');
             }
         }
-        catch {
-            errors.push('reveniumBaseUrl must be a valid URL');
-            suggestions.push('Use format: https://api.revenium.io');
-        }
     }
     // Validate optional Anthropic API key
-    if (!isString(cfg?.anthropicApiKey)) {
+    if (cfg?.anthropicApiKey !== undefined && !isString(cfg?.anthropicApiKey)) {
         errors.push('anthropicApiKey must be a string if provided');
     }
-    else if (cfg?.anthropicApiKey?.trim()?.length === 0) {
+    else if (cfg?.anthropicApiKey !== undefined && cfg?.anthropicApiKey?.trim()?.length === 0) {
         warnings.push('anthropicApiKey is empty - API calls may fail');
     }
-    else if (!cfg?.anthropicApiKey?.startsWith(VALIDATION_CONFIG.ANTHROPIC_API_KEY_PREFIX)) {
+    else if (cfg?.anthropicApiKey && !cfg?.anthropicApiKey?.startsWith(VALIDATION_CONFIG.ANTHROPIC_API_KEY_PREFIX)) {
         warnings.push(`anthropicApiKey does not start with "${VALIDATION_CONFIG.ANTHROPIC_API_KEY_PREFIX}" - verify it is correct`);
     }
     // Validate optional timeout using constants
@@ -192,6 +194,23 @@ export function validateReveniumConfig(config) {
     else if (cfg?.maxRetries !== undefined && cfg?.maxRetries === 0) {
         warnings.push('maxRetries is 0 - no retry attempts will be made');
     }
+    // Validate optional printSummary
+    if (cfg?.printSummary !== undefined) {
+        const validPrintSummaryValues = [true, false, 'human', 'json'];
+        if (!validPrintSummaryValues.includes(cfg?.printSummary)) {
+            errors.push("printSummary must be a boolean or one of: 'human', 'json'");
+            suggestions.push("Use printSummary: true, 'human', or 'json' to enable summary output");
+        }
+    }
+    // Validate optional teamId
+    if (cfg?.teamId !== undefined) {
+        if (!isString(cfg?.teamId)) {
+            errors.push('teamId must be a string if provided');
+        }
+        else if (cfg?.teamId?.trim()?.length === 0) {
+            errors.push('teamId cannot be empty if provided');
+        }
+    }
     if (errors.length > 0) {
         return {
             isValid: false,
@@ -200,14 +219,27 @@ export function validateReveniumConfig(config) {
             suggestions
         };
     }
-    // Build validated config
+    // Determine validated printSummary value
+    let validatedPrintSummary;
+    if (cfg?.printSummary === true || cfg?.printSummary === 'human') {
+        validatedPrintSummary = 'human';
+    }
+    else if (cfg?.printSummary === 'json') {
+        validatedPrintSummary = 'json';
+    }
+    else if (cfg?.printSummary === false) {
+        validatedPrintSummary = false;
+    }
+    // Build validated config (apply default for reveniumBaseUrl if not provided)
     const validatedConfig = {
         reveniumApiKey: cfg?.reveniumApiKey,
-        reveniumBaseUrl: cfg?.reveniumBaseUrl,
+        reveniumBaseUrl: isString(cfg?.reveniumBaseUrl) ? cfg?.reveniumBaseUrl : DEFAULT_CONFIG.REVENIUM_BASE_URL,
         anthropicApiKey: isString(cfg?.anthropicApiKey) ? cfg?.anthropicApiKey : undefined,
         apiTimeout: isNumber(cfg?.apiTimeout) ? cfg?.apiTimeout : undefined,
         failSilent: isBoolean(cfg?.failSilent) ? cfg?.failSilent : undefined,
-        maxRetries: isNumber(cfg?.maxRetries) ? cfg?.maxRetries : undefined
+        maxRetries: isNumber(cfg?.maxRetries) ? cfg?.maxRetries : undefined,
+        printSummary: validatedPrintSummary,
+        teamId: isString(cfg?.teamId) ? cfg?.teamId?.trim() : undefined
     };
     return {
         isValid: true,

package/dist/esm/wrapper.js

@@ -1,12 +1,12 @@
 /**
  * Anthropic SDK wrapper with type safety and structured error handling
  */
-import Anthropic from '@anthropic-ai/sdk';
-import { getLogger } from './config.js';
-import { trackUsageAsync, extractUsageFromResponse, extractUsageFromStream } from './tracking.js';
-import { validateAnthropicMessageParams, validateUsageMetadata } from './utils/validation.js';
-import { AnthropicPatchingError, RequestProcessingError, StreamProcessingError, createErrorContext, handleError } from './utils/error-handling.js';
-import { randomUUID } from 'crypto';
+import Anthropic from "@anthropic-ai/sdk";
+import { getLogger, getConfig } from "./config.js";
+import { trackUsageAsync, extractUsageFromResponse, extractUsageFromStream, } from "./tracking.js";
+import { validateAnthropicMessageParams, validateUsageMetadata, } from "./utils/validation.js";
+import { AnthropicPatchingError, RequestProcessingError, StreamProcessingError, createErrorContext, handleError, } from "./utils/error-handling.js";
+import { randomUUID } from "crypto";
 // Global logger
 const logger = getLogger();
 /**
@@ -15,7 +15,7 @@ const logger = getLogger();
 const patchingContext = {
     originalMethods: {},
     isPatched: false,
-    patchedInstances: new WeakSet()
+    patchedInstances: new WeakSet(),
 };
 /**
  * Get the Messages prototype using sophisticated prototype access
@@ -34,9 +34,12 @@ function getMessagesPrototype() {
             return anthropicConstructor?._Messages?.prototype;
         // Method 3: Create a minimal instance with the real API key if available
         // Fallback approach when direct prototype access methods fail
-        const apiKey = process.env.ANTHROPIC_API_KEY;
+        // Check config first, then environment variable
+        const config = getConfig();
+        const apiKey = config?.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY;
         if (!apiKey) {
-            throw new AnthropicPatchingError('Unable to access Anthropic Messages prototype: No API key available and direct prototype access failed');
+            throw new AnthropicPatchingError("Unable to access Anthropic Messages prototype: No API key available and direct prototype access failed. " +
+                "Provide ANTHROPIC_API_KEY environment variable or pass anthropicApiKey in config.");
         }
         const minimalInstance = new Anthropic({ apiKey });
         const messagesPrototype = Object.getPrototypeOf(minimalInstance.messages);
@@ -54,19 +57,19 @@ function getMessagesPrototype() {
  */
 export function patchAnthropic() {
     if (patchingContext.isPatched) {
-        logger.debug('Anthropic SDK already patched, skipping duplicate initialization');
+        logger.debug("Anthropic SDK already patched, skipping duplicate initialization");
         return;
     }
     try {
         // Access the Messages class prototype using sophisticated prototype access
         const messagesPrototype = getMessagesPrototype();
         if (!messagesPrototype)
-            throw new AnthropicPatchingError('Unable to access Anthropic Messages prototype');
+            throw new AnthropicPatchingError("Unable to access Anthropic Messages prototype");
         // Store original methods
         patchingContext.originalMethods.create = messagesPrototype?.create;
         patchingContext.originalMethods.stream = messagesPrototype?.stream;
         if (!patchingContext.originalMethods?.create) {
-            throw new AnthropicPatchingError('Unable to find original create method');
+            throw new AnthropicPatchingError("Unable to find original create method");
         }
         // Patch the create method
         const patchedCreateFunction = function (params, options) {
@@ -80,11 +83,11 @@ export function patchAnthropic() {
             };
         }
         patchingContext.isPatched = true;
-        logger.info('Anthropic SDK patched successfully');
+        logger.info("Anthropic SDK patched successfully");
     }
     catch (error) {
         const errorContext = createErrorContext()
-            .with('patchingAttempt', true)
+            .with("patchingAttempt", true)
             .build();
         handleError(error, logger, errorContext);
         if (error instanceof AnthropicPatchingError)
@@ -109,11 +112,11 @@ export function unpatchAnthropic() {
         }
         patchingContext.isPatched = false;
         patchingContext.originalMethods = {};
-        logger.info('Anthropic SDK unpatched successfully');
+        logger.info("Anthropic SDK unpatched successfully");
     }
     catch (error) {
         const errorContext = createErrorContext()
-            .with('unpatchingAttempt', true)
+            .with("unpatchingAttempt", true)
             .build();
         handleError(error, logger, errorContext);
         throw new AnthropicPatchingError(`Failed to unpatch Anthropic SDK: ${error instanceof Error ? error.message : String(error)}`, errorContext);
@@ -129,7 +132,7 @@ export function isAnthropicPatched() {
  * Handle streaming response by collecting chunks and extracting usage data
  */
 async function handleStreamingResponse(stream, context) {
-    const { requestId, model, metadata, requestTime, startTime } = context;
+    const { requestId, model, metadata, requestTime, startTime, requestBody } = context;
     // Create a new async generator that collects chunks and tracks usage
     async function* trackingStream() {
         const chunks = [];
@@ -137,7 +140,7 @@ async function handleStreamingResponse(stream, context) {
         try {
             for await (const chunk of stream) {
                 // Track first token time
-                if (!firstTokenTime && chunk.type === 'content_block_delta') {
+                if (!firstTokenTime && chunk.type === "content_block_delta") {
                     firstTokenTime = Date.now();
                 }
                 chunks.push(chunk);
@@ -147,10 +150,14 @@ async function handleStreamingResponse(stream, context) {
             const endTime = Date.now();
             const responseTime = new Date();
             const duration = endTime - startTime;
-            logger.debug('Stream completed, extracting usage', {
+            const timeToFirstToken = firstTokenTime
+                ? firstTokenTime - startTime
+                : undefined;
+            logger.debug("Stream completed, extracting usage", {
                 requestId,
                 chunkCount: chunks.length,
-                duration
+                duration,
+                timeToFirstToken,
             });
             const usage = extractUsageFromStream(chunks);
             // Create tracking data
@@ -166,22 +173,24 @@ async function handleStreamingResponse(stream, context) {
                 stopReason: usage.stopReason,
                 metadata,
                 requestTime,
-                responseTime
+                responseTime,
+                timeToFirstToken,
+                requestBody: requestBody,
             };
             // Track usage asynchronously
             trackUsageAsync(trackingData);
-            logger.debug('Anthropic streaming request completed successfully', {
+            logger.debug("Anthropic streaming request completed successfully", {
                 requestId,
                 model,
                 inputTokens: usage.inputTokens,
                 outputTokens: usage.outputTokens,
-                duration
+                duration,
             });
         }
         catch (error) {
-            logger.error('Error processing streaming response', {
+            logger.error("Error processing streaming response", {
                 requestId,
-                error: error instanceof Error ? error.message : String(error)
+                error: error instanceof Error ? error.message : String(error),
             });
             throw error;
         }
@@ -195,19 +204,19 @@ async function patchedCreateMethod(params, options) {
     const requestId = randomUUID();
     const startTime = Date.now();
     const requestTime = new Date();
-    logger.debug('Intercepted Anthropic messages.create call', {
+    logger.debug("Intercepted Anthropic messages.create call", {
         requestId,
         model: params.model,
         hasMetadata: !!params.usageMetadata,
-        isStreaming: !!params.stream
+        isStreaming: !!params.stream,
     });
     // Validate parameters
     const validation = validateAnthropicMessageParams(params);
     if (!validation.isValid) {
-        logger.warn('Invalid Anthropic parameters detected', {
+        logger.warn("Invalid Anthropic parameters detected", {
             requestId,
             errors: validation.errors,
-            warnings: validation.warnings
+            warnings: validation.warnings,
         });
     }
     // Extract and validate metadata
@@ -218,7 +227,7 @@ async function patchedCreateMethod(params, options) {
         // Call original method
         const originalCreate = patchingContext.originalMethods.create;
         if (!originalCreate)
-            throw new RequestProcessingError('Original create method not available');
+            throw new RequestProcessingError("Original create method not available");
         const response = await originalCreate.call(this, cleanParams, options);
         // Check if this is a streaming response
         const isStreaming = !!params.stream;
@@ -241,16 +250,17 @@ async function patchedCreateMethod(params, options) {
                 stopReason: usage.stopReason,
                 metadata,
                 requestTime,
-                responseTime
+                responseTime,
+                requestBody: params,
             };
             // Track usage asynchronously
             trackUsageAsync(trackingData);
-            logger.debug('Anthropic request completed successfully', {
+            logger.debug("Anthropic request completed successfully", {
                 requestId,
                 model: params.model,
                 inputTokens: usage.inputTokens,
                 outputTokens: usage.outputTokens,
-                duration
+                duration,
             });
             return response;
         }
@@ -260,7 +270,8 @@ async function patchedCreateMethod(params, options) {
             model: params.model,
             metadata,
             requestTime,
-            startTime
+            startTime,
+            requestBody: params,
         });
     }
     catch (error) {
@@ -285,18 +296,18 @@ async function* patchedStreamMethod(params, options) {
     const responseTime = new Date();
     const chunks = [];
     let firstTokenTime;
-    logger.debug('Intercepted Anthropic messages.stream call', {
+    logger.debug("Intercepted Anthropic messages.stream call", {
         requestId,
         model: params.model,
-        hasMetadata: !!params.usageMetadata
+        hasMetadata: !!params.usageMetadata,
     });
     // Validate parameters
     const validation = validateAnthropicMessageParams(params);
     if (!validation.isValid) {
-        logger.warn('Invalid Anthropic streaming parameters detected', {
+        logger.warn("Invalid Anthropic streaming parameters detected", {
             requestId,
             errors: validation.errors,
-            warnings: validation.warnings
+            warnings: validation.warnings,
         });
     }
     // Extract and validate metadata
@@ -307,12 +318,12 @@ async function* patchedStreamMethod(params, options) {
         // Call original stream method
         const originalStream = patchingContext.originalMethods?.stream;
         if (!originalStream) {
-            throw new StreamProcessingError('Original stream method not available');
+            throw new StreamProcessingError("Original stream method not available");
         }
         const stream = originalStream.call(this, cleanParams, options);
         for await (const chunk of stream) {
             // Track first token time
-            if (!firstTokenTime && chunk.type === 'content_block_delta') {
+            if (!firstTokenTime && chunk.type === "content_block_delta") {
                 firstTokenTime = Date.now();
             }
             chunks.push(chunk);
@@ -320,7 +331,9 @@ async function* patchedStreamMethod(params, options) {
         }
         const endTime = Date.now();
         const duration = endTime - startTime;
-        const timeToFirstToken = firstTokenTime ? firstTokenTime - startTime : undefined;
+        const timeToFirstToken = firstTokenTime
+            ? firstTokenTime - startTime
+            : undefined;
         // Extract usage information from all chunks
         const usage = extractUsageFromStream(chunks);
         // Create tracking data
@@ -337,18 +350,19 @@ async function* patchedStreamMethod(params, options) {
             metadata,
             requestTime,
             responseTime,
-            timeToFirstToken
+            timeToFirstToken,
+            requestBody: params,
         };
         // Track usage asynchronously
         trackUsageAsync(trackingData);
-        logger.debug('Anthropic streaming request completed successfully', {
+        logger.debug("Anthropic streaming request completed successfully", {
             requestId,
             model: params.model,
             inputTokens: usage.inputTokens,
             outputTokens: usage.outputTokens,
             duration,
             timeToFirstToken,
-            chunkCount: chunks.length
+            chunkCount: chunks.length,
         });
     }
     catch (error) {
@@ -358,8 +372,8 @@ async function* patchedStreamMethod(params, options) {
             .withRequestId(requestId)
             .withModel(params.model)
             .withDuration(duration)
-            .with('isStreaming', true)
-            .with('chunkCount', chunks.length)
+            .with("isStreaming", true)
+            .with("chunkCount", chunks.length)
             .build();
         handleError(error, logger, errorContext);
         throw error;

package/dist/types/config.d.ts

@@ -13,6 +13,7 @@ export declare function validateConfig(config: ReveniumConfig): void;
 export declare function getConfig(): ReveniumConfig | null;
 /**
  * Set the global configuration
+ * Uses the normalized config from validation (with defaults applied and fields trimmed)
  */
 export declare function setConfig(config: ReveniumConfig): void;
 /**

package/dist/types/constants.d.ts

@@ -7,7 +7,7 @@
  */
 export declare const DEFAULT_CONFIG: {
     /** Default Revenium API base URL */
-    readonly REVENIUM_BASE_URL: "https://api.revenium.io";
+    readonly REVENIUM_BASE_URL: "https://api.revenium.ai";
     /** Default API timeout in milliseconds */
     readonly API_TIMEOUT: 5000;
     /** Default maximum retries for failed API calls */
@@ -109,6 +109,21 @@ export declare const ENV_VARS: {
     readonly FAIL_SILENT: "REVENIUM_FAIL_SILENT";
     /** Maximum retries */
     readonly MAX_RETRIES: "REVENIUM_MAX_RETRIES";
+    /** Print summary mode (true/false/human/json) */
+    readonly PRINT_SUMMARY: "REVENIUM_PRINT_SUMMARY";
+    /** Team ID for cost metrics retrieval */
+    readonly TEAM_ID: "REVENIUM_TEAM_ID";
+};
+/**
+ * Summary printer configuration
+ */
+export declare const SUMMARY_PRINTER_CONFIG: {
+    /** Maximum number of retries when fetching cost metrics */
+    readonly MAX_RETRIES: 3;
+    /** Delay between retries in milliseconds */
+    readonly RETRY_DELAY: 2000;
+    /** Fetch timeout in milliseconds (prevents hung requests from keeping Node process alive) */
+    readonly FETCH_TIMEOUT: 10000;
 };
 /**
  * API endpoints

package/dist/types/types/anthropic-augmentation.d.ts

@@ -18,68 +18,6 @@
  * - **Automatic Validation**: TypeScript validates the structure at compile time
  * - **Better Developer Experience**: Auto-completion and error detection
  *
- * ## Usage Examples:
- *
- * ### Basic Usage:
- * ```typescript
- * import '@revenium/anthropic';
- * import Anthropic from '@anthropic-ai/sdk';
- *
- * const anthropic = new Anthropic();
- *
- * const response = await anthropic.messages.create({
- *   model: 'claude-3-5-sonnet-latest',
- *   max_tokens: 1024,
- *   messages: [{ role: 'user', content: 'Hello!' }],
- *   usageMetadata: {  // TypeScript recognizes this natively
- *     subscriber: { id: 'user-123', email: 'user@example.com' },
- *     organizationId: 'my-company',
- *     taskType: 'customer-support',
- *     traceId: 'session-abc-123'
- *   }
- * });
- * ```
- *
- * ### Streaming Usage:
- * ```typescript
- * const stream = await anthropic.messages.stream({
- *   model: 'claude-3-5-sonnet-latest',
- *   max_tokens: 1024,
- *   messages: [{ role: 'user', content: 'Generate a report' }],
- *   usageMetadata: {
- *     taskType: 'content-generation',
- *     productId: 'report-generator',
- *     responseQualityScore: 0.95
- *   }
- * });
- * ```
- *
- * ### Advanced Usage with All Fields:
- * ```typescript
- * const response = await anthropic.messages.create({
- *   model: 'claude-3-5-sonnet-latest',
- *   max_tokens: 2048,
- *   messages: [{ role: 'user', content: 'Complex analysis task' }],
- *   usageMetadata: {
- *     subscriber: {
- *       id: 'user-456',
- *       email: 'analyst@company.com',
- *       credential: { name: 'api-key', value: 'sk-...' }
- *     },
- *     traceId: 'analysis-session-789',
- *     taskType: 'data-analysis',
- *     organizationId: 'enterprise-client',
- *     subscriptionId: 'premium-plan',
- *     productId: 'analytics-suite',
- *     agent: 'data-analyst-bot',
- *     responseQualityScore: 0.98,
- *     customField: 'custom-value'  // Extensible with custom fields
- *   }
- * });
- * ```
- *
- * @public
- * @since 1.1.0
  */
 import { UsageMetadata } from "../types";
 export {};
@@ -109,36 +47,6 @@ declare module "@anthropic-ai/sdk/resources/messages" {
          * - **Multi-tenancy**: Organize usage by organizationId
          * - **Quality Monitoring**: Track response quality scores
          * - **Custom Analytics**: Add custom fields for specific business needs
-         *
-         * @example Basic user tracking
-         * ```typescript
-         * usageMetadata: {
-         *   subscriber: { id: 'user-123', email: 'user@example.com' },
-         *   organizationId: 'my-company'
-         * }
-         * ```
-         *
-         * @example Session and task tracking
-         * ```typescript
-         * usageMetadata: {
-         *   traceId: 'session-abc-123',
-         *   taskType: 'customer-support',
-         *   productId: 'help-desk'
-         * }
-         * ```
-         *
-         * @example Advanced analytics
-         * ```typescript
-         * usageMetadata: {
-         *   subscriber: { id: 'user-456' },
-         *   taskType: 'content-generation',
-         *   responseQualityScore: 0.95,
-         *   customMetric: 'high-priority'
-         * }
-         * ```
-         *
-         * @public
-         * @since 1.1.0
          */
         usageMetadata?: UsageMetadata;
     }