@revenium/anthropic 1.0.3 → 1.0.5

package/dist/cjs/constants.js

@@ -10,7 +10,7 @@ exports.ANTHROPIC_PATTERNS = exports.API_ENDPOINTS = exports.ENV_VARS = exports.
  */
 exports.DEFAULT_CONFIG = {
     /** Default Revenium API base URL */
-    REVENIUM_BASE_URL: 'https://api.revenium.io/meter',
+    REVENIUM_BASE_URL: 'https://api.revenium.io',
     /** Default API timeout in milliseconds */
     API_TIMEOUT: 5000,
     /** Default maximum retries for failed API calls */
@@ -118,7 +118,7 @@ exports.ENV_VARS = {
  */
 exports.API_ENDPOINTS = {
     /** Revenium AI completions endpoint */
-    AI_COMPLETIONS: '/v2/ai/completions',
+    AI_COMPLETIONS: '/meter/v2/ai/completions',
 };
 /**
  * Anthropic model patterns

package/dist/cjs/utils/validation.js

@@ -161,7 +161,7 @@ function validateReveniumConfig(config) {
         }
         catch {
             errors.push('reveniumBaseUrl must be a valid URL');
-            suggestions.push('Use format: https://api.revenium.io/meter');
+            suggestions.push('Use format: https://api.revenium.io');
         }
     }
     // Validate optional Anthropic API key

package/dist/esm/constants.js

@@ -7,7 +7,7 @@
  */
 export const DEFAULT_CONFIG = {
     /** Default Revenium API base URL */
-    REVENIUM_BASE_URL: 'https://api.revenium.io/meter',
+    REVENIUM_BASE_URL: 'https://api.revenium.io',
     /** Default API timeout in milliseconds */
     API_TIMEOUT: 5000,
     /** Default maximum retries for failed API calls */
@@ -115,7 +115,7 @@ export const ENV_VARS = {
  */
 export const API_ENDPOINTS = {
     /** Revenium AI completions endpoint */
-    AI_COMPLETIONS: '/v2/ai/completions',
+    AI_COMPLETIONS: '/meter/v2/ai/completions',
 };
 /**
  * Anthropic model patterns

package/dist/esm/utils/validation.js

@@ -150,7 +150,7 @@ export function validateReveniumConfig(config) {
         }
         catch {
             errors.push('reveniumBaseUrl must be a valid URL');
-            suggestions.push('Use format: https://api.revenium.io/meter');
+            suggestions.push('Use format: https://api.revenium.io');
         }
     }
     // Validate optional Anthropic API key

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/meter";
+    readonly REVENIUM_BASE_URL: "https://api.revenium.io";
     /** Default API timeout in milliseconds */
     readonly API_TIMEOUT: 5000;
     /** Default maximum retries for failed API calls */
@@ -115,7 +115,7 @@ export declare const ENV_VARS: {
  */
 export declare const API_ENDPOINTS: {
     /** Revenium AI completions endpoint */
-    readonly AI_COMPLETIONS: "/v2/ai/completions";
+    readonly AI_COMPLETIONS: "/meter/v2/ai/completions";
 };
 /**
  * Anthropic model patterns

package/dist/types/types.d.ts

@@ -52,7 +52,7 @@ export interface Subscriber {
  * ```typescript
  * const config: ReveniumConfig = {
  *   reveniumApiKey: 'hak_1234567890abcdef',
- *   reveniumBaseUrl: 'https://api.revenium.io/meter/v2',
+ *   reveniumBaseUrl: 'https://api.revenium.io',
  *   anthropicApiKey: 'sk-ant-1234567890abcdef',
  *   apiTimeout: 8000,
  *   failSilent: true,

package/examples/README.md

@@ -0,0 +1,182 @@
+# Revenium Anthropic Middleware - Examples
+
+**TypeScript-first** examples demonstrating automatic Revenium usage tracking with the Anthropic SDK.
+
+## Getting Started - Step by Step
+
+### 1. Create Your Project
+
+```bash
+# Create project directory
+mkdir my-anthropic-project
+cd my-anthropic-project
+
+# Initialize Node.js project
+npm init -y
+```
+
+### 2. Install Dependencies
+
+```bash
+npm install @revenium/anthropic @anthropic-ai/sdk dotenv
+npm install -D typescript tsx @types/node  # For TypeScript
+```
+
+### 3. Environment Setup
+
+Create a `.env` file in your project root:
+
+```bash
+# Required
+REVENIUM_METERING_API_KEY=hak_your_revenium_api_key
+ANTHROPIC_API_KEY=sk-ant-your_anthropic_api_key
+
+# Optional
+REVENIUM_METERING_BASE_URL=https://api.revenium.io
+REVENIUM_DEBUG=false
+```
+
+### 4. Run Examples
+
+**If you cloned from GitHub:**
+
+```bash
+# Run included examples directly
+npm run example:basic
+npm run example:advanced
+
+# Or use tsx directly
+npx tsx examples/basic-usage.ts
+npx tsx examples/advanced-features.ts
+```
+
+**If you installed via npm:**
+
+Examples are included in your `node_modules/@revenium/anthropic/examples/` directory:
+
+```bash
+npx tsx node_modules/@revenium/anthropic/examples/basic-usage.ts
+npx tsx node_modules/@revenium/anthropic/examples/advanced-features.ts
+```
+
+## Available Examples
+
+### `basic-usage.ts` - Initialization Methods
+
+Demonstrates the three ways to initialize the Revenium middleware:
+
+- **Auto-initialization** (Recommended) - Import and go, uses environment variables
+- **Explicit initialization** - Call `initialize()` for error handling control
+- **Manual configuration** - Use `configure()` for custom settings
+
+**Key Features:**
+- TypeScript module augmentation for native `usageMetadata` support
+- Full type safety with IntelliSense
+- Interface validation using `satisfies` operator
+- Comprehensive error handling patterns
+
+**See the file for complete code examples.**
+
+### `advanced-features.ts` - Streaming, Tools, and Manual Tracking
+
+Demonstrates advanced Anthropic SDK features with automatic tracking:
+
+- **Streaming responses** - Real-time response tracking with type safety
+- **Tool use (function calling)** - Function calls with metadata tracking
+- **Manual tracking** - Custom tracking for edge cases
+- **Error handling** - Comprehensive error handling patterns
+
+**Key Features:**
+- Type-safe event handling and stream processing
+- Advanced metadata patterns with interface extensions
+- Generic functions with type constraints
+- Custom logger integration
+
+**See the file for complete code examples.**
+
+## TypeScript Configuration
+
+Ensure your `tsconfig.json` includes:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "skipLibCheck": true
+  }
+}
+```
+
+## Requirements
+
+- **Node.js 16+** with TypeScript support
+- **TypeScript 4.5+** for module augmentation features
+- **Valid Revenium API key** (starts with `hak_`)
+- **Valid Anthropic API key** (starts with `sk-ant-`)
+
+## Troubleshooting
+
+### Module Augmentation Not Working
+
+**Problem:** TypeScript doesn't recognize `usageMetadata` in Anthropic SDK calls
+
+**Solution:**
+
+```typescript
+// ❌ Wrong - missing module augmentation import
+import { configure } from "@revenium/anthropic";
+
+// ✅ Correct - import for module augmentation
+import "@revenium/anthropic";
+import Anthropic from "@anthropic-ai/sdk";
+```
+
+### Environment Variables Not Loading
+
+**Problem:** `REVENIUM_METERING_API_KEY` or `ANTHROPIC_API_KEY` not found
+
+**Solutions:**
+- Ensure `.env` file is in project root
+- Check variable names match exactly
+- Verify you're importing `dotenv/config` before the middleware
+- Check API keys have correct prefixes (`hak_` for Revenium, `sk-ant-` for Anthropic)
+
+### TypeScript Compilation Errors
+
+**Problem:** Module resolution or import errors
+
+**Solution:** Verify your `tsconfig.json` settings:
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  }
+}
+```
+
+### Debug Mode
+
+Enable detailed logging to troubleshoot issues:
+
+```bash
+# In .env file
+REVENIUM_DEBUG=true
+
+# Then run examples
+npm run example:basic
+```
+
+## Additional Resources
+
+- **Main Documentation**: See root [README.md](https://github.com/revenium/revenium-middleware-anthropic-node/blob/HEAD/README.md)
+- **API Reference**: Full TypeScript types and JSDoc in the package
+- **Issues**: [Report bugs](https://github.com/revenium/revenium-middleware-anthropic-node/issues)