@drip-sdk/node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Drip Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,603 @@
+# @drip-sdk/node
+
+The official Node.js SDK for **Drip** - Usage-based billing for AI agents.
+
+Drip enables real-time, per-request billing using USDC on blockchain. Perfect for AI APIs, compute platforms, and any service with variable usage patterns.
+
+[![npm version](https://badge.fury.io/js/@drip-sdk/node.svg)](https://www.npmjs.com/package/@drip-sdk/node)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install @drip-sdk/node
+```
+
+```bash
+yarn add @drip-sdk/node
+```
+
+```bash
+pnpm add @drip-sdk/node
+```
+
+## Quick Start
+
+### One-Liner Integration (Recommended)
+
+The fastest way to add billing to your API:
+
+#### Next.js App Router
+
+```typescript
+// app/api/generate/route.ts
+import { withDrip } from '@drip-sdk/node/next';
+
+export const POST = withDrip({
+  meter: 'api_calls',
+  quantity: 1,
+}, async (req, { charge, customerId }) => {
+  // Your handler - payment already verified!
+  console.log(`Charged ${charge.charge.amountUsdc} USDC to ${customerId}`);
+  return Response.json({ result: 'success' });
+});
+```
+
+#### Express
+
+```typescript
+import express from 'express';
+import { dripMiddleware } from '@drip-sdk/node/express';
+
+const app = express();
+
+app.use('/api/paid', dripMiddleware({
+  meter: 'api_calls',
+  quantity: 1,
+}));
+
+app.post('/api/paid/generate', (req, res) => {
+  console.log(`Charged: ${req.drip.charge.charge.amountUsdc} USDC`);
+  res.json({ success: true });
+});
+```
+
+### Manual Integration
+
+For more control, use the SDK directly:
+
+```typescript
+import { Drip } from '@drip-sdk/node';
+
+// Initialize the client
+const drip = new Drip({
+  apiKey: process.env.DRIP_API_KEY!,
+});
+
+// Create a customer
+const customer = await drip.createCustomer({
+  onchainAddress: '0x1234567890abcdef...',
+  externalCustomerId: 'user_123',
+});
+
+// Record usage and charge
+const result = await drip.charge({
+  customerId: customer.id,
+  meter: 'api_calls',
+  quantity: 100,
+});
+
+console.log(`Charged ${result.charge.amountUsdc} USDC`);
+console.log(`TX: ${result.charge.txHash}`);
+```
+
+## Configuration
+
+```typescript
+const drip = new Drip({
+  // Required: Your Drip API key
+  apiKey: 'drip_live_abc123...',
+
+  // Optional: API base URL (for staging/development)
+  baseUrl: 'https://api.drip.dev/v1',
+
+  // Optional: Request timeout in milliseconds (default: 30000)
+  timeout: 30000,
+});
+```
+
+## API Reference
+
+### Customer Management
+
+#### Create a Customer
+
+```typescript
+const customer = await drip.createCustomer({
+  onchainAddress: '0x1234567890abcdef...',
+  externalCustomerId: 'user_123', // Your internal user ID
+  metadata: { plan: 'pro' },
+});
+```
+
+#### Get a Customer
+
+```typescript
+const customer = await drip.getCustomer('cust_abc123');
+```
+
+#### List Customers
+
+```typescript
+// List all customers
+const { data: customers } = await drip.listCustomers();
+
+// With filters
+const { data: activeCustomers } = await drip.listCustomers({
+  status: 'ACTIVE',
+  limit: 50,
+});
+```
+
+#### Get Customer Balance
+
+```typescript
+const balance = await drip.getBalance('cust_abc123');
+console.log(`Balance: ${balance.balanceUSDC} USDC`);
+```
+
+### Meters (Usage Types)
+
+#### List Available Meters
+
+Discover what meter names are valid for charging. Meters are defined by your pricing plans.
+
+```typescript
+const { data: meters } = await drip.listMeters();
+
+console.log('Available meters:');
+for (const meter of meters) {
+  console.log(`  ${meter.meter}: $${meter.unitPriceUsd}/unit`);
+}
+// Output:
+//   api_calls: $0.001/unit
+//   tokens: $0.00001/unit
+//   compute_seconds: $0.01/unit
+```
+
+### Charging & Usage
+
+#### Record Usage and Charge
+
+```typescript
+const result = await drip.charge({
+  customerId: 'cust_abc123',
+  meter: 'api_calls',
+  quantity: 100,
+  idempotencyKey: 'req_unique_123', // Prevents duplicate charges
+  metadata: { endpoint: '/v1/chat' },
+});
+
+if (result.success) {
+  console.log(`Charge ID: ${result.charge.id}`);
+  console.log(`Amount: ${result.charge.amountUsdc} USDC`);
+  console.log(`TX Hash: ${result.charge.txHash}`);
+}
+```
+
+#### Get Charge Details
+
+```typescript
+const charge = await drip.getCharge('chg_abc123');
+console.log(`Status: ${charge.status}`);
+```
+
+#### List Charges
+
+```typescript
+// List all charges
+const { data: charges } = await drip.listCharges();
+
+// Filter by customer and status
+const { data: customerCharges } = await drip.listCharges({
+  customerId: 'cust_abc123',
+  status: 'CONFIRMED',
+  limit: 50,
+});
+```
+
+#### Check Charge Status
+
+```typescript
+const status = await drip.getChargeStatus('chg_abc123');
+if (status.status === 'CONFIRMED') {
+  console.log('Charge confirmed on-chain!');
+}
+```
+
+### Run Tracking (Simplified API)
+
+Track agent executions with a single API call instead of multiple separate calls.
+
+#### Record a Complete Run
+
+The `recordRun()` method combines workflow creation, run tracking, event emission, and completion into one call:
+
+```typescript
+// Before: 4+ separate API calls
+const workflow = await drip.createWorkflow({ name: 'My Agent', slug: 'my_agent' });
+const run = await drip.startRun({ customerId, workflowId: workflow.id });
+await drip.emitEvent({ runId: run.id, eventType: 'step1', ... });
+await drip.emitEvent({ runId: run.id, eventType: 'step2', ... });
+await drip.endRun(run.id, { status: 'COMPLETED' });
+
+// After: 1 call with recordRun()
+const result = await drip.recordRun({
+  customerId: 'cust_123',
+  workflow: 'my_agent',  // Auto-creates workflow if it doesn't exist
+  events: [
+    { eventType: 'agent.start', description: 'Started processing' },
+    { eventType: 'tool.ocr', quantity: 3, units: 'pages', costUnits: 0.15 },
+    { eventType: 'tool.validate', quantity: 1, costUnits: 0.05 },
+    { eventType: 'agent.complete', description: 'Finished successfully' },
+  ],
+  status: 'COMPLETED',
+});
+
+console.log(result.summary);
+// Output: "✓ My Agent: 4 events recorded (250ms)"
+```
+
+#### Record a Failed Run
+
+```typescript
+const result = await drip.recordRun({
+  customerId: 'cust_123',
+  workflow: 'prescription_intake',
+  events: [
+    { eventType: 'agent.start', description: 'Started processing' },
+    { eventType: 'error', description: 'OCR failed: image too blurry' },
+  ],
+  status: 'FAILED',
+  errorMessage: 'OCR processing failed',
+  errorCode: 'OCR_QUALITY_ERROR',
+});
+
+console.log(result.summary);
+// Output: "✗ Prescription Intake: 2 events recorded (150ms)"
+```
+
+### Webhooks
+
+#### Create a Webhook
+
+```typescript
+const webhook = await drip.createWebhook({
+  url: 'https://api.yourapp.com/webhooks/drip',
+  events: ['charge.succeeded', 'charge.failed', 'customer.balance.low'],
+  description: 'Main webhook endpoint',
+});
+
+// IMPORTANT: Save the secret securely!
+console.log(`Webhook secret: ${webhook.secret}`);
+```
+
+#### List Webhooks
+
+```typescript
+const { data: webhooks } = await drip.listWebhooks();
+webhooks.forEach((wh) => {
+  console.log(`${wh.url}: ${wh.stats?.successfulDeliveries} successful`);
+});
+```
+
+#### Delete a Webhook
+
+```typescript
+await drip.deleteWebhook('wh_abc123');
+```
+
+#### Verify Webhook Signatures
+
+```typescript
+import express from 'express';
+import { Drip } from '@drip-sdk/node';
+
+const app = express();
+
+app.post(
+  '/webhooks/drip',
+  express.raw({ type: 'application/json' }),
+  (req, res) => {
+    const isValid = Drip.verifyWebhookSignature(
+      req.body.toString(),
+      req.headers['x-drip-signature'] as string,
+      process.env.DRIP_WEBHOOK_SECRET!,
+    );
+
+    if (!isValid) {
+      return res.status(401).send('Invalid signature');
+    }
+
+    const event = JSON.parse(req.body.toString());
+
+    switch (event.type) {
+      case 'charge.succeeded':
+        console.log('Charge succeeded:', event.data.charge_id);
+        break;
+      case 'charge.failed':
+        console.log('Charge failed:', event.data.failure_reason);
+        break;
+      case 'customer.balance.low':
+        console.log('Low balance alert for:', event.data.customer_id);
+        break;
+    }
+
+    res.status(200).send('OK');
+  },
+);
+```
+
+### Available Webhook Events
+
+| Event                        | Description                          |
+| ---------------------------- | ------------------------------------ |
+| `charge.succeeded`           | Charge confirmed on-chain            |
+| `charge.failed`              | Charge failed                        |
+| `customer.balance.low`       | Customer balance below threshold     |
+| `customer.deposit.confirmed` | Deposit confirmed on-chain           |
+| `customer.withdraw.confirmed`| Withdrawal confirmed                 |
+| `customer.usage_cap.reached` | Usage cap hit                        |
+| `customer.created`           | New customer created                 |
+| `usage.recorded`             | Usage event recorded                 |
+| `transaction.created`        | Transaction initiated                |
+| `transaction.confirmed`      | Transaction confirmed on-chain       |
+| `transaction.failed`         | Transaction failed                   |
+
+## TypeScript Usage
+
+The SDK is written in TypeScript and includes full type definitions.
+
+```typescript
+import {
+  Drip,
+  DripConfig,
+  DripError,
+  Customer,
+  Charge,
+  ChargeResult,
+  ChargeStatus,
+  Webhook,
+  WebhookEventType,
+} from '@drip-sdk/node';
+
+// All types are available for use
+const config: DripConfig = {
+  apiKey: process.env.DRIP_API_KEY!,
+};
+
+const drip = new Drip(config);
+
+// Type-safe responses
+const customer: Customer = await drip.getCustomer('cust_abc123');
+const result: ChargeResult = await drip.charge({
+  customerId: customer.id,
+  meter: 'api_calls',
+  quantity: 100,
+});
+```
+
+## Error Handling
+
+The SDK throws `DripError` for API errors:
+
+```typescript
+import { Drip, DripError } from '@drip-sdk/node';
+
+try {
+  const result = await drip.charge({
+    customerId: 'cust_abc123',
+    meter: 'api_calls',
+    quantity: 100,
+  });
+} catch (error) {
+  if (error instanceof DripError) {
+    console.error(`API Error: ${error.message}`);
+    console.error(`Status Code: ${error.statusCode}`);
+    console.error(`Error Code: ${error.code}`);
+
+    switch (error.code) {
+      case 'INSUFFICIENT_BALANCE':
+        // Handle low balance
+        break;
+      case 'CUSTOMER_NOT_FOUND':
+        // Handle missing customer
+        break;
+      case 'RATE_LIMITED':
+        // Handle rate limiting
+        break;
+    }
+  }
+}
+```
+
+### Common Error Codes
+
+| Code                   | Description                              |
+| ---------------------- | ---------------------------------------- |
+| `INSUFFICIENT_BALANCE` | Customer doesn't have enough balance     |
+| `CUSTOMER_NOT_FOUND`   | Customer ID doesn't exist                |
+| `DUPLICATE_CUSTOMER`   | Customer already exists                  |
+| `INVALID_API_KEY`      | API key is invalid or revoked            |
+| `RATE_LIMITED`         | Too many requests                        |
+| `TIMEOUT`              | Request timed out                        |
+
+## Idempotency
+
+Use idempotency keys to safely retry requests:
+
+```typescript
+const result = await drip.charge({
+  customerId: 'cust_abc123',
+  meter: 'api_calls',
+  quantity: 100,
+  idempotencyKey: `req_${requestId}`, // Unique per request
+});
+
+// Retrying with the same key returns the original result
+const retry = await drip.charge({
+  customerId: 'cust_abc123',
+  meter: 'api_calls',
+  quantity: 100,
+  idempotencyKey: `req_${requestId}`, // Same key = same result
+});
+```
+
+## CommonJS Usage
+
+The SDK supports both ESM and CommonJS:
+
+```javascript
+// ESM
+import { Drip } from '@drip-sdk/node';
+
+// CommonJS
+const { Drip } = require('@drip-sdk/node');
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- Native `fetch` support (included in Node.js 18+)
+
+## Middleware Reference (withDrip)
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `meter` | `string` | **required** | Usage meter to charge (must match pricing plan) |
+| `quantity` | `number \| (req) => number` | **required** | Quantity to charge (static or dynamic) |
+| `apiKey` | `string` | `DRIP_API_KEY` | Drip API key |
+| `baseUrl` | `string` | `DRIP_API_URL` | Drip API base URL |
+| `customerResolver` | `'header' \| 'query' \| function` | `'header'` | How to identify customers |
+| `skipInDevelopment` | `boolean` | `false` | Skip charging in dev mode |
+| `metadata` | `object \| function` | `undefined` | Custom metadata for charges |
+| `onCharge` | `function` | `undefined` | Callback after successful charge |
+| `onError` | `function` | `undefined` | Custom error handler |
+
+### How It Works
+
+```
+┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
+│   Your API      │    │   withDrip       │    │   Drip Backend  │
+│   (Next/Express)│───▶│   Middleware     │───▶│   API           │
+└─────────────────┘    └──────────────────┘    └─────────────────┘
+         │                      │                       │
+         ▼                      ▼                       ▼
+    1. Request            2. Resolve             3. Check balance
+       arrives               customer               & charge
+         │                      │                       │
+         ▼                      ▼                       ▼
+    6. Response           5. Pass to             4. Return result
+       returned              handler                or 402
+```
+
+### x402 Payment Flow
+
+When a customer has insufficient balance, the middleware returns `402 Payment Required`:
+
+```
+HTTP/1.1 402 Payment Required
+X-Payment-Required: true
+X-Payment-Amount: 0.01
+X-Payment-Recipient: 0x...
+X-Payment-Usage-Id: 0x...
+X-Payment-Expires: 1704110400
+X-Payment-Nonce: abc123
+
+{
+  "error": "Payment required",
+  "code": "PAYMENT_REQUIRED",
+  "paymentRequest": { ... },
+  "instructions": {
+    "step1": "Sign the payment request with your session key using EIP-712",
+    "step2": "Retry the request with X-Payment-* headers"
+  }
+}
+```
+
+### Advanced Usage
+
+#### Dynamic Quantity
+
+```typescript
+export const POST = withDrip({
+  meter: 'tokens',
+  quantity: async (req) => {
+    const body = await req.json();
+    return body.maxTokens ?? 100;
+  },
+}, handler);
+```
+
+#### Custom Customer Resolution
+
+```typescript
+export const POST = withDrip({
+  meter: 'api_calls',
+  quantity: 1,
+  customerResolver: (req) => {
+    const token = req.headers.get('authorization')?.split(' ')[1];
+    return decodeJWT(token).customerId;
+  },
+}, handler);
+```
+
+#### Factory Pattern
+
+```typescript
+// lib/drip.ts
+import { createWithDrip } from '@drip-sdk/node/next';
+
+export const withDrip = createWithDrip({
+  apiKey: process.env.DRIP_API_KEY,
+  baseUrl: process.env.DRIP_API_URL,
+});
+
+// app/api/generate/route.ts
+import { withDrip } from '@/lib/drip';
+export const POST = withDrip({ meter: 'api_calls', quantity: 1 }, handler);
+```
+
+### What's Included vs. Missing
+
+| Feature | Status | Description |
+|---------|--------|-------------|
+| Next.js App Router | ✅ | `withDrip` wrapper |
+| Express Middleware | ✅ | `dripMiddleware` |
+| x402 Payment Flow | ✅ | Automatic 402 handling |
+| Dynamic Quantity | ✅ | Function-based pricing |
+| Customer Resolution | ✅ | Header, query, or custom |
+| Idempotency | ✅ | Built-in or custom keys |
+| Dev Mode Skip | ✅ | Skip in development |
+| Metadata | ✅ | Attach to charges |
+| TypeScript | ✅ | Full type definitions |
+| Fastify Adapter | ❌ | Coming soon |
+| Rate Limiting | ❌ | Planned |
+| Balance Caching | ❌ | Planned |
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT - see [LICENSE](./LICENSE)
+
+## Links
+
+- [GitHub Repository](https://github.com/MichaelLevin5908/drip-sdk)
+- [Issue Tracker](https://github.com/MichaelLevin5908/drip-sdk/issues)
+- [npm Package](https://www.npmjs.com/package/@drip-sdk/node)
+- [Documentation](https://docs.drip.dev)

package/dist/express.cjs

@@ -0,0 +1,3 @@
+'use strict';var crypto=require('crypto');var f=class t extends Error{constructor(r,s,n){super(r);this.statusCode=s;this.code=n;this.name="DripError",Object.setPrototypeOf(this,t.prototype);}},x=class{apiKey;baseUrl;timeout;constructor(e){if(!e.apiKey)throw new Error("Drip API key is required");this.apiKey=e.apiKey,this.baseUrl=e.baseUrl||"https://api.drip.dev/v1",this.timeout=e.timeout||3e4;}async request(e,r={}){let s=new AbortController,n=setTimeout(()=>s.abort(),this.timeout);try{let i=await fetch(`${this.baseUrl}${e}`,{...r,signal:s.signal,headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,...r.headers}});if(i.status===204)return {success:!0};let o=await i.json();if(!i.ok)throw new f(o.message||o.error||"Request failed",i.status,o.code);return o}catch(i){throw i instanceof f?i:i instanceof Error&&i.name==="AbortError"?new f("Request timed out",408,"TIMEOUT"):new f(i instanceof Error?i.message:"Unknown error",0,"UNKNOWN")}finally{clearTimeout(n);}}async createCustomer(e){return this.request("/customers",{method:"POST",body:JSON.stringify(e)})}async getCustomer(e){return this.request(`/customers/${e}`)}async listCustomers(e){let r=new URLSearchParams;e?.limit&&r.set("limit",e.limit.toString()),e?.status&&r.set("status",e.status);let s=r.toString(),n=s?`/customers?${s}`:"/customers";return this.request(n)}async getBalance(e){return this.request(`/customers/${e}/balance`)}async charge(e){return this.request("/usage",{method:"POST",body:JSON.stringify({customerId:e.customerId,usageType:e.meter,quantity:e.quantity,idempotencyKey:e.idempotencyKey,metadata:e.metadata})})}async getCharge(e){return this.request(`/charges/${e}`)}async listCharges(e){let r=new URLSearchParams;e?.customerId&&r.set("customerId",e.customerId),e?.status&&r.set("status",e.status),e?.limit&&r.set("limit",e.limit.toString()),e?.offset&&r.set("offset",e.offset.toString());let s=r.toString(),n=s?`/charges?${s}`:"/charges";return this.request(n)}async getChargeStatus(e){return this.request(`/charges/${e}/status`)}async checkout(e){let r=await this.request("/checkout",{method:"POST",body:JSON.stringify({customer_id:e.customerId,external_customer_id:e.externalCustomerId,amount:e.amount,return_url:e.returnUrl,cancel_url:e.cancelUrl,metadata:e.metadata})});return {id:r.id,url:r.url,expiresAt:r.expires_at,amountUsd:r.amount_usd}}async createWebhook(e){return this.request("/webhooks",{method:"POST",body:JSON.stringify(e)})}async listWebhooks(){return this.request("/webhooks")}async getWebhook(e){return this.request(`/webhooks/${e}`)}async deleteWebhook(e){return this.request(`/webhooks/${e}`,{method:"DELETE"})}async testWebhook(e){return this.request(`/webhooks/${e}/test`,{method:"POST"})}async rotateWebhookSecret(e){return this.request(`/webhooks/${e}/rotate-secret`,{method:"POST"})}async createWorkflow(e){return this.request("/workflows",{method:"POST",body:JSON.stringify(e)})}async listWorkflows(){return this.request("/workflows")}async startRun(e){return this.request("/runs",{method:"POST",body:JSON.stringify(e)})}async endRun(e,r){return this.request(`/runs/${e}`,{method:"PATCH",body:JSON.stringify(r)})}async getRunTimeline(e){return this.request(`/runs/${e}`)}async emitEvent(e){return this.request("/events",{method:"POST",body:JSON.stringify(e)})}async emitEventsBatch(e){return this.request("/events/batch",{method:"POST",body:JSON.stringify({events:e})})}async listMeters(){let e=await this.request("/pricing-plans");return {data:e.data.map(r=>({id:r.id,name:r.name,meter:r.unitType,unitPriceUsd:r.unitPriceUsd,isActive:r.isActive})),count:e.count}}async recordRun(e){let r=Date.now(),s=e.workflow,n=e.workflow;if(!e.workflow.startsWith("wf_"))try{let y=(await this.listWorkflows()).data.find(d=>d.slug===e.workflow||d.id===e.workflow);if(y)s=y.id,n=y.name;else {let d=await this.createWorkflow({name:e.workflow.replace(/[_-]/g," ").replace(/\b\w/g,E=>E.toUpperCase()),slug:e.workflow,productSurface:"AGENT"});s=d.id,n=d.name;}}catch{s=e.workflow;}let i=await this.startRun({customerId:e.customerId,workflowId:s,externalRunId:e.externalRunId,correlationId:e.correlationId,metadata:e.metadata}),o=0,c=0;if(e.events.length>0){let l=e.events.map((d,E)=>({runId:i.id,eventType:d.eventType,quantity:d.quantity,units:d.units,description:d.description,costUnits:d.costUnits,metadata:d.metadata,idempotencyKey:e.externalRunId?`${e.externalRunId}:${d.eventType}:${E}`:void 0})),y=await this.emitEventsBatch(l);o=y.created,c=y.duplicates;}let m=await this.endRun(i.id,{status:e.status,errorMessage:e.errorMessage,errorCode:e.errorCode}),g=Date.now()-r,u=e.events.length>0?`${o} events recorded`:"no events",h=`${e.status==="COMPLETED"?"\u2713":e.status==="FAILED"?"\u2717":"\u25CB"} ${n}: ${u} (${m.durationMs??g}ms)`;return {run:{id:i.id,workflowId:s,workflowName:n,status:e.status,durationMs:m.durationMs},events:{created:o,duplicates:c},totalCostUnits:m.totalCostUnits,summary:h}}static generateIdempotencyKey(e){let r=[e.customerId,e.runId??"no_run",e.stepName,String(e.sequence??0)],s=0,n=r.join("|");for(let i=0;i<n.length;i++){let o=n.charCodeAt(i);s=(s<<5)-s+o,s=s&s;}return `drip_${Math.abs(s).toString(36)}_${e.stepName.slice(0,16)}`}static verifyWebhookSignature(e,r,s){let n=new TextEncoder,i=n.encode(e),o=n.encode(s),c=0;for(let g=0;g<i.length;g++)c=(c<<5)-c+i[g]+o[g%o.length]|0;let m=Math.abs(c).toString(16);return r===m||r.includes(m)}};var p=class t extends Error{constructor(r,s,n,i){super(r);this.code=s;this.statusCode=n;this.details=i;this.name="DripMiddlewareError",Object.setPrototypeOf(this,t.prototype);}};var v=300,A=300,S=["x-payment-signature","x-payment-session-key","x-payment-smart-account","x-payment-timestamp","x-payment-amount","x-payment-recipient","x-payment-usage-id","x-payment-nonce"];function N(t){return t.toLowerCase()}function R(t,e){let r=N(e);if(t[r]!==void 0){let s=t[r];return Array.isArray(s)?s[0]:s}for(let[s,n]of Object.entries(t))if(s.toLowerCase()===r)return Array.isArray(n)?n[0]:n}function P(t){return S.every(e=>R(t,e)!==void 0)}function O(t){let e=R(t,"x-payment-signature"),r=R(t,"x-payment-session-key"),s=R(t,"x-payment-smart-account"),n=R(t,"x-payment-timestamp"),i=R(t,"x-payment-amount"),o=R(t,"x-payment-recipient"),c=R(t,"x-payment-usage-id"),m=R(t,"x-payment-nonce");if(!e||!r||!s||!n||!i||!o||!c||!m)return null;let g=parseInt(n,10);if(isNaN(g)||Math.floor(Date.now()/1e3)-g>A)return null;let a=(h,l)=>{if(!h.startsWith("0x"))return  false;let y=h.slice(2);return y.length<l?false:/^[a-fA-F0-9]+$/.test(y)};return !a(e,130)||!a(r,64)||!a(s,40)?null:{signature:e,sessionKeyId:r,smartAccount:s,timestamp:g,amount:i,recipient:o,usageId:c,nonce:m}}function U(t){let e=Math.floor(Date.now()/1e3),r=e+(t.expiresInSec??v),s=`${e}-${crypto.randomBytes(16).toString("hex")}`,n=t.usageId;n.startsWith("0x")||(n=b(n));let i={"X-Payment-Required":"true","X-Payment-Amount":t.amount,"X-Payment-Recipient":t.recipient,"X-Payment-Usage-Id":n,"X-Payment-Description":t.description??"API usage charge","X-Payment-Expires":String(r),"X-Payment-Nonce":s,"X-Payment-Timestamp":String(e)},o={amount:t.amount,recipient:t.recipient,usageId:n,description:t.description??"API usage charge",expiresAt:r,nonce:s,timestamp:e};return {headers:i,paymentRequest:o}}function b(t){let e=5381,r=52711;for(let i=0;i<t.length;i++){let o=t.charCodeAt(i);e=(e<<5)+e^o,r=(r<<5)+r^o;}return `0x${Math.abs(e*31+r).toString(16).padStart(16,"0").slice(0,16).padEnd(64,"0")}`}async function M(t,e){let r=e.customerResolver??"header";if(typeof r=="function")return r(t);if(r==="header"){let s=R(t.headers,"x-drip-customer-id")??R(t.headers,"x-customer-id");if(!s)throw new p("Missing customer ID. Include X-Drip-Customer-Id header.","CUSTOMER_RESOLUTION_FAILED",400);return s}if(r==="query"){let s=t.query??{},n=s.drip_customer_id??s.customer_id,i=Array.isArray(n)?n[0]:n;if(!i)throw new p("Missing customer ID. Include drip_customer_id query parameter.","CUSTOMER_RESOLUTION_FAILED",400);return i}throw new p(`Invalid customer resolver: ${r}`,"CONFIGURATION_ERROR",500)}async function _(t,e){return typeof e.quantity=="function"?e.quantity(t):e.quantity}async function W(t,e,r){if(r.idempotencyKey)return r.idempotencyKey(t);let s=Date.now(),n=[t.method,t.url,e,s];return `drip_${b(n.join("|")).slice(2,18)}`}function C(t){let e=t.apiKey??process.env.DRIP_API_KEY;if(!e)throw new p("Missing Drip API key. Set DRIP_API_KEY environment variable or pass apiKey in config.","CONFIGURATION_ERROR",500);return new x({apiKey:e,baseUrl:t.baseUrl??process.env.DRIP_API_URL})}async function I(t,e){if(e.skipInDevelopment&&process.env.NODE_ENV==="development"){console.warn("[Drip] Skipping billing in development mode. Set skipInDevelopment: false or NODE_ENV to production to enable billing.");let r=C(e),s={success:true,usageEventId:"dev_usage_event",isReplay:false,charge:{id:"dev_charge",amountUsdc:"0.00",amountToken:"0",txHash:"0x0",status:"CONFIRMED"}};return {success:true,state:{customerId:"dev_customer",quantity:typeof e.quantity=="number"?e.quantity:1,idempotencyKey:"dev_idempotency",hasPaymentProof:false},charge:s,drip:r,isReplay:false}}try{let r=C(e),s=await M(t,e),n=await _(t,e),i=await W(t,s,e),o=P(t.headers),c=o?O(t.headers):void 0,m={customerId:s,quantity:n,idempotencyKey:i,hasPaymentProof:o,paymentProof:c??void 0},g=typeof e.metadata=="function"?e.metadata(t):e.metadata;try{let u=await r.charge({customerId:s,meter:e.meter,quantity:n,idempotencyKey:i,metadata:g});return e.onCharge&&await e.onCharge(u,t),{success:!0,state:m,charge:u,drip:r,isReplay:u.isReplay??!1}}catch(u){if(u instanceof f){if(u.statusCode===402){let a=process.env.DRIP_RECIPIENT_ADDRESS;if(!a)throw new p("DRIP_RECIPIENT_ADDRESS environment variable must be configured for x402 payment flow.","CONFIGURATION_ERROR",500);let h="0.01",l=u.message.match(/amount[:\s]+([0-9.]+)/i);l?h=l[1]:h=(n*1e-4).toFixed(6);let{headers:y,paymentRequest:d}=U({amount:h,recipient:a,usageId:i,description:`${e.meter} usage charge`});return {success:!1,error:new p("Insufficient balance. Payment required.","PAYMENT_REQUIRED",402),paymentRequired:{headers:y,paymentRequest:d}}}throw e.onError&&await e.onError(u,t),new p(u.message,"CHARGE_FAILED",u.statusCode,{code:u.code})}throw u}}catch(r){if(r instanceof p)return {success:false,error:r};let s=r instanceof Error?r.message:"Unknown error";return {success:false,error:new p(s,"INTERNAL_ERROR",500)}}}function q(t){let e={};for(let[r,s]of Object.entries(t))e[r.toLowerCase()]=Array.isArray(s)?s[0]:s;return e}function L(t,e,r){t.status(402).set(e).json({error:"Payment required",code:"PAYMENT_REQUIRED",paymentRequest:r,instructions:{step1:"Sign the payment request with your session key using EIP-712",step2:"Retry the request with X-Payment-* headers",documentation:"https://docs.drip.dev/x402"}});}function X(t,e,r,s,n){t.status(s).json({error:e,code:r,...n&&{details:n}});}function D(t){let e=t.attachToRequest??true;return async(r,s,n)=>{let i={method:r.method,url:r.originalUrl||r.url,headers:q(r.headers),query:r.query},o=typeof t.quantity=="function"?await t.quantity(r):t.quantity,c;if(typeof t.customerResolver=="function"){let l=t.customerResolver;c=async()=>l(r);}else c=t.customerResolver;let m;if(typeof t.idempotencyKey=="function"){let l=t.idempotencyKey;m=async()=>l(r);}let g=typeof t.metadata=="function"?t.metadata(r):t.metadata,u={meter:t.meter,quantity:o,apiKey:t.apiKey,baseUrl:t.baseUrl,customerResolver:c,idempotencyKey:m,metadata:g,skipInDevelopment:t.skipInDevelopment,onCharge:void 0,onError:void 0},a=await I(i,u);if(!a.success){if(t.errorHandler&&await t.errorHandler(a.error,r,s))return;if(a.paymentRequired){L(s,a.paymentRequired.headers,a.paymentRequired.paymentRequest);return}X(s,a.error.message,a.error.code,a.error.statusCode,a.error.details);return}t.onCharge&&await t.onCharge(a.charge,r);let h={drip:a.drip,customerId:a.state.customerId,charge:a.charge,isReplay:a.isReplay};e&&(r.drip=h),n();}}function K(t){return e=>D({...t,...e})}function $(t){return P(q(t.headers))}function k(t){return "drip"in t&&typeof t.drip=="object"}function F(t){if(!k(t))throw new Error("Drip context not found on request. Ensure dripMiddleware is applied before this route.");return t.drip}
+exports.Drip=x;exports.DripError=f;exports.DripMiddlewareError=p;exports.createDripMiddleware=K;exports.dripMiddleware=D;exports.getDripContext=F;exports.hasDripContext=k;exports.hasPaymentProofHeaders=$;//# sourceMappingURL=express.cjs.map
+//# sourceMappingURL=express.cjs.map