@drip-sdk/node 1.0.2 → 1.0.5

package/dist/index.d.cts

@@ -1,3 +1,145 @@
+/**
+ * StreamMeter - Accumulate usage locally and charge once at the end.
+ *
+ * Perfect for LLM token streaming and other high-frequency metering scenarios
+ * where you want to avoid making an API call for every small increment.
+ *
+ * @example
+ * ```typescript
+ * const meter = drip.createStreamMeter({
+ *   customerId: 'cust_abc123',
+ *   meter: 'tokens',
+ * });
+ *
+ * for await (const chunk of llmStream) {
+ *   meter.add(chunk.tokens);
+ * }
+ *
+ * const result = await meter.flush();
+ * console.log(`Charged ${result.charge.amountUsdc} for ${result.quantity} tokens`);
+ * ```
+ */
+
+/**
+ * Options for creating a StreamMeter.
+ */
+interface StreamMeterOptions {
+    /**
+     * The Drip customer ID to charge.
+     */
+    customerId: string;
+    /**
+     * The usage meter/type to record against.
+     * Must match a meter configured in your pricing plan.
+     */
+    meter: string;
+    /**
+     * Unique key to prevent duplicate charges.
+     * If not provided, one will be generated.
+     */
+    idempotencyKey?: string;
+    /**
+     * Additional metadata to attach to the charge.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Auto-flush when accumulated quantity reaches this threshold.
+     * Useful for long-running streams where you want periodic charges.
+     */
+    flushThreshold?: number;
+    /**
+     * Callback invoked on each add() call.
+     * Useful for logging or progress tracking.
+     */
+    onAdd?: (quantity: number, total: number) => void;
+    /**
+     * Callback invoked after each successful flush.
+     */
+    onFlush?: (result: StreamMeterFlushResult) => void;
+}
+/**
+ * Result of flushing a StreamMeter.
+ */
+interface StreamMeterFlushResult {
+    /** Whether the flush was successful */
+    success: boolean;
+    /** The quantity that was charged */
+    quantity: number;
+    /** The charge result from the API (if quantity > 0) */
+    charge: ChargeResult['charge'] | null;
+    /** Whether this was an idempotent replay */
+    isReplay: boolean;
+}
+/**
+ * Internal charge function type (injected by Drip class).
+ */
+type ChargeFn = (params: ChargeParams) => Promise<ChargeResult>;
+/**
+ * StreamMeter accumulates usage locally and charges once when flushed.
+ *
+ * This is ideal for:
+ * - LLM token streaming (charge once at end of stream)
+ * - High-frequency events (batch small increments)
+ * - Partial failure handling (charge for what was delivered)
+ */
+declare class StreamMeter {
+    private _total;
+    private _flushed;
+    private _flushCount;
+    private readonly _chargeFn;
+    private readonly _options;
+    /**
+     * Creates a new StreamMeter.
+     *
+     * @param chargeFn - The charge function from Drip client
+     * @param options - StreamMeter configuration
+     */
+    constructor(chargeFn: ChargeFn, options: StreamMeterOptions);
+    /**
+     * Current accumulated quantity (not yet charged).
+     */
+    get total(): number;
+    /**
+     * Whether this meter has been flushed at least once.
+     */
+    get isFlushed(): boolean;
+    /**
+     * Number of times this meter has been flushed.
+     */
+    get flushCount(): number;
+    /**
+     * Add quantity to the accumulated total.
+     *
+     * If a flushThreshold is set and the total exceeds it,
+     * this will automatically trigger a flush.
+     *
+     * @param quantity - Amount to add (must be positive)
+     * @returns Promise that resolves when add completes (may trigger auto-flush)
+     */
+    add(quantity: number): Promise<StreamMeterFlushResult | null>;
+    /**
+     * Synchronously add quantity without auto-flush.
+     * Use this for maximum performance when you don't need threshold-based flushing.
+     *
+     * @param quantity - Amount to add (must be positive)
+     */
+    addSync(quantity: number): void;
+    /**
+     * Flush accumulated usage and charge the customer.
+     *
+     * If total is 0, returns a success result with no charge.
+     * After flush, the meter resets to 0 and can be reused.
+     *
+     * @returns The flush result including charge details
+     */
+    flush(): Promise<StreamMeterFlushResult>;
+    /**
+     * Reset the meter without charging.
+     * Use this to discard accumulated usage (e.g., on error before delivery).
+     */
+    reset(): void;
+}
+
 /**
  * Drip SDK - Usage-based billing for Node.js
  *
@@ -7,6 +149,7 @@
  *
  * @packageDocumentation
  */
+
 /**
  * Configuration options for the Drip SDK client.
  */
@@ -95,12 +238,16 @@ interface ListCustomersResponse {
 interface BalanceResult {
     /** Customer ID */
     customerId: string;
-    /** Balance in USDC (6 decimals) */
-    balanceUSDC: string;
-    /** Balance in native token */
-    balanceToken: string;
-    /** ISO timestamp of last balance update */
-    lastUpdated: string;
+    /** On-chain address */
+    onchainAddress: string;
+    /** Balance in USDC (6 decimals) - matches backend field name */
+    balanceUsdc: string;
+    /** Pending charges in USDC */
+    pendingChargesUsdc: string;
+    /** Available USDC (balance minus pending) */
+    availableUsdc: string;
+    /** ISO timestamp of last balance sync */
+    lastSyncedAt: string | null;
 }
 /**
  * Parameters for recording usage and charging a customer.
@@ -625,7 +772,7 @@ declare class DripError extends Error {
  *
  * @example
  * ```typescript
- * import { Drip } from '@drip-billing/sdk';
+ * import { Drip } from '@drip-sdk/node';
  *
  * const drip = new Drip({
  *   apiKey: process.env.DRIP_API_KEY!,
@@ -670,6 +817,25 @@ declare class Drip {
      * @internal
      */
     private request;
+    /**
+     * Pings the Drip API to check connectivity and measure latency.
+     *
+     * @returns Health status with latency information
+     *
+     * @example
+     * ```typescript
+     * const health = await drip.ping();
+     * if (health.ok) {
+     *   console.log(`API healthy, latency: ${health.latencyMs}ms`);
+     * }
+     * ```
+     */
+    ping(): Promise<{
+        ok: boolean;
+        status: string;
+        latencyMs: number;
+        timestamp: number;
+    }>;
     /**
      * Creates a new customer in your Drip account.
      *
@@ -1214,9 +1380,39 @@ declare class Drip {
         sequence?: number;
     }): string;
     /**
-     * Verifies a webhook signature.
+     * Verifies a webhook signature using HMAC-SHA256.
      *
      * Call this when receiving webhook events to ensure they're authentic.
+     * This is an async method that uses the Web Crypto API for secure verification.
+     *
+     * @param payload - The raw request body (string)
+     * @param signature - The x-drip-signature header value
+     * @param secret - Your webhook secret
+     * @returns Promise resolving to whether the signature is valid
+     *
+     * @example
+     * ```typescript
+     * app.post('/webhooks/drip', async (req, res) => {
+     *   const isValid = await Drip.verifyWebhookSignature(
+     *     req.rawBody,
+     *     req.headers['x-drip-signature'],
+     *     process.env.DRIP_WEBHOOK_SECRET!,
+     *   );
+     *
+     *   if (!isValid) {
+     *     return res.status(401).send('Invalid signature');
+     *   }
+     *
+     *   // Process the webhook...
+     * });
+     * ```
+     */
+    static verifyWebhookSignature(payload: string, signature: string, secret: string): Promise<boolean>;
+    /**
+     * Synchronously verifies a webhook signature using HMAC-SHA256.
+     *
+     * This method uses Node.js crypto module and is only available in Node.js environments.
+     * For edge runtimes or browsers, use the async `verifyWebhookSignature` method instead.
      *
      * @param payload - The raw request body (string)
      * @param signature - The x-drip-signature header value
@@ -1226,7 +1422,7 @@ declare class Drip {
      * @example
      * ```typescript
      * app.post('/webhooks/drip', (req, res) => {
-     *   const isValid = Drip.verifyWebhookSignature(
+     *   const isValid = Drip.verifyWebhookSignatureSync(
      *     req.rawBody,
      *     req.headers['x-drip-signature'],
      *     process.env.DRIP_WEBHOOK_SECRET!,
@@ -1240,9 +1436,55 @@ declare class Drip {
      * });
      * ```
      */
-    static verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
+    static verifyWebhookSignatureSync(payload: string, signature: string, secret: string): boolean;
+    /**
+     * Creates a StreamMeter for accumulating usage and charging once.
+     *
+     * Perfect for LLM token streaming where you want to:
+     * - Accumulate tokens locally (no API call per token)
+     * - Charge once at the end of the stream
+     * - Handle partial failures (charge for what was delivered)
+     *
+     * @param options - StreamMeter configuration
+     * @returns A new StreamMeter instance
+     *
+     * @example
+     * ```typescript
+     * const meter = drip.createStreamMeter({
+     *   customerId: 'cust_abc123',
+     *   meter: 'tokens',
+     * });
+     *
+     * // Accumulate tokens as they stream
+     * for await (const chunk of llmStream) {
+     *   meter.addSync(chunk.tokens);
+     *   yield chunk;
+     * }
+     *
+     * // Single charge at end
+     * const result = await meter.flush();
+     * console.log(`Charged ${result.charge?.amountUsdc} for ${result.quantity} tokens`);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With auto-flush threshold
+     * const meter = drip.createStreamMeter({
+     *   customerId: 'cust_abc123',
+     *   meter: 'tokens',
+     *   flushThreshold: 10000, // Charge every 10k tokens
+     * });
+     *
+     * for await (const chunk of longStream) {
+     *   await meter.add(chunk.tokens); // May auto-flush
+     * }
+     *
+     * await meter.flush(); // Final flush for remaining tokens
+     * ```
+     */
+    createStreamMeter(options: StreamMeterOptions): StreamMeter;
 }
 
 // @ts-ignore
 export = Drip;
-export { type BalanceResult, type Charge, type ChargeParams, type ChargeResult, type ChargeStatus, type CheckoutParams, type CheckoutResult, type CreateCustomerParams, type CreateWebhookParams, type CreateWebhookResponse, type CreateWorkflowParams, type Customer, type DeleteWebhookResponse, Drip, type DripConfig, DripError, type EmitEventParams, type EndRunParams, type EventResult, type ListChargesOptions, type ListChargesResponse, type ListCustomersOptions, type ListCustomersResponse, type ListMetersResponse, type ListWebhooksResponse, type Meter, type RecordRunEvent, type RecordRunParams, type RecordRunResult, type RunResult, type RunStatus, type RunTimeline, type StartRunParams, type Webhook, type WebhookEventType, type Workflow };
+export { type BalanceResult, type Charge, type ChargeParams, type ChargeResult, type ChargeStatus, type CheckoutParams, type CheckoutResult, type CreateCustomerParams, type CreateWebhookParams, type CreateWebhookResponse, type CreateWorkflowParams, type Customer, type DeleteWebhookResponse, Drip, type DripConfig, DripError, type EmitEventParams, type EndRunParams, type EventResult, type ListChargesOptions, type ListChargesResponse, type ListCustomersOptions, type ListCustomersResponse, type ListMetersResponse, type ListWebhooksResponse, type Meter, type RecordRunEvent, type RecordRunParams, type RecordRunResult, type RunResult, type RunStatus, type RunTimeline, type StartRunParams, StreamMeter, type StreamMeterFlushResult, type StreamMeterOptions, type Webhook, type WebhookEventType, type Workflow };

package/dist/index.d.ts

@@ -1,3 +1,145 @@
+/**
+ * StreamMeter - Accumulate usage locally and charge once at the end.
+ *
+ * Perfect for LLM token streaming and other high-frequency metering scenarios
+ * where you want to avoid making an API call for every small increment.
+ *
+ * @example
+ * ```typescript
+ * const meter = drip.createStreamMeter({
+ *   customerId: 'cust_abc123',
+ *   meter: 'tokens',
+ * });
+ *
+ * for await (const chunk of llmStream) {
+ *   meter.add(chunk.tokens);
+ * }
+ *
+ * const result = await meter.flush();
+ * console.log(`Charged ${result.charge.amountUsdc} for ${result.quantity} tokens`);
+ * ```
+ */
+
+/**
+ * Options for creating a StreamMeter.
+ */
+interface StreamMeterOptions {
+    /**
+     * The Drip customer ID to charge.
+     */
+    customerId: string;
+    /**
+     * The usage meter/type to record against.
+     * Must match a meter configured in your pricing plan.
+     */
+    meter: string;
+    /**
+     * Unique key to prevent duplicate charges.
+     * If not provided, one will be generated.
+     */
+    idempotencyKey?: string;
+    /**
+     * Additional metadata to attach to the charge.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Auto-flush when accumulated quantity reaches this threshold.
+     * Useful for long-running streams where you want periodic charges.
+     */
+    flushThreshold?: number;
+    /**
+     * Callback invoked on each add() call.
+     * Useful for logging or progress tracking.
+     */
+    onAdd?: (quantity: number, total: number) => void;
+    /**
+     * Callback invoked after each successful flush.
+     */
+    onFlush?: (result: StreamMeterFlushResult) => void;
+}
+/**
+ * Result of flushing a StreamMeter.
+ */
+interface StreamMeterFlushResult {
+    /** Whether the flush was successful */
+    success: boolean;
+    /** The quantity that was charged */
+    quantity: number;
+    /** The charge result from the API (if quantity > 0) */
+    charge: ChargeResult['charge'] | null;
+    /** Whether this was an idempotent replay */
+    isReplay: boolean;
+}
+/**
+ * Internal charge function type (injected by Drip class).
+ */
+type ChargeFn = (params: ChargeParams) => Promise<ChargeResult>;
+/**
+ * StreamMeter accumulates usage locally and charges once when flushed.
+ *
+ * This is ideal for:
+ * - LLM token streaming (charge once at end of stream)
+ * - High-frequency events (batch small increments)
+ * - Partial failure handling (charge for what was delivered)
+ */
+declare class StreamMeter {
+    private _total;
+    private _flushed;
+    private _flushCount;
+    private readonly _chargeFn;
+    private readonly _options;
+    /**
+     * Creates a new StreamMeter.
+     *
+     * @param chargeFn - The charge function from Drip client
+     * @param options - StreamMeter configuration
+     */
+    constructor(chargeFn: ChargeFn, options: StreamMeterOptions);
+    /**
+     * Current accumulated quantity (not yet charged).
+     */
+    get total(): number;
+    /**
+     * Whether this meter has been flushed at least once.
+     */
+    get isFlushed(): boolean;
+    /**
+     * Number of times this meter has been flushed.
+     */
+    get flushCount(): number;
+    /**
+     * Add quantity to the accumulated total.
+     *
+     * If a flushThreshold is set and the total exceeds it,
+     * this will automatically trigger a flush.
+     *
+     * @param quantity - Amount to add (must be positive)
+     * @returns Promise that resolves when add completes (may trigger auto-flush)
+     */
+    add(quantity: number): Promise<StreamMeterFlushResult | null>;
+    /**
+     * Synchronously add quantity without auto-flush.
+     * Use this for maximum performance when you don't need threshold-based flushing.
+     *
+     * @param quantity - Amount to add (must be positive)
+     */
+    addSync(quantity: number): void;
+    /**
+     * Flush accumulated usage and charge the customer.
+     *
+     * If total is 0, returns a success result with no charge.
+     * After flush, the meter resets to 0 and can be reused.
+     *
+     * @returns The flush result including charge details
+     */
+    flush(): Promise<StreamMeterFlushResult>;
+    /**
+     * Reset the meter without charging.
+     * Use this to discard accumulated usage (e.g., on error before delivery).
+     */
+    reset(): void;
+}
+
 /**
  * Drip SDK - Usage-based billing for Node.js
  *
@@ -7,6 +149,7 @@
  *
  * @packageDocumentation
  */
+
 /**
  * Configuration options for the Drip SDK client.
  */
@@ -95,12 +238,16 @@ interface ListCustomersResponse {
 interface BalanceResult {
     /** Customer ID */
     customerId: string;
-    /** Balance in USDC (6 decimals) */
-    balanceUSDC: string;
-    /** Balance in native token */
-    balanceToken: string;
-    /** ISO timestamp of last balance update */
-    lastUpdated: string;
+    /** On-chain address */
+    onchainAddress: string;
+    /** Balance in USDC (6 decimals) - matches backend field name */
+    balanceUsdc: string;
+    /** Pending charges in USDC */
+    pendingChargesUsdc: string;
+    /** Available USDC (balance minus pending) */
+    availableUsdc: string;
+    /** ISO timestamp of last balance sync */
+    lastSyncedAt: string | null;
 }
 /**
  * Parameters for recording usage and charging a customer.
@@ -625,7 +772,7 @@ declare class DripError extends Error {
  *
  * @example
  * ```typescript
- * import { Drip } from '@drip-billing/sdk';
+ * import { Drip } from '@drip-sdk/node';
  *
  * const drip = new Drip({
  *   apiKey: process.env.DRIP_API_KEY!,
@@ -670,6 +817,25 @@ declare class Drip {
      * @internal
      */
     private request;
+    /**
+     * Pings the Drip API to check connectivity and measure latency.
+     *
+     * @returns Health status with latency information
+     *
+     * @example
+     * ```typescript
+     * const health = await drip.ping();
+     * if (health.ok) {
+     *   console.log(`API healthy, latency: ${health.latencyMs}ms`);
+     * }
+     * ```
+     */
+    ping(): Promise<{
+        ok: boolean;
+        status: string;
+        latencyMs: number;
+        timestamp: number;
+    }>;
     /**
      * Creates a new customer in your Drip account.
      *
@@ -1214,9 +1380,39 @@ declare class Drip {
         sequence?: number;
     }): string;
     /**
-     * Verifies a webhook signature.
+     * Verifies a webhook signature using HMAC-SHA256.
      *
      * Call this when receiving webhook events to ensure they're authentic.
+     * This is an async method that uses the Web Crypto API for secure verification.
+     *
+     * @param payload - The raw request body (string)
+     * @param signature - The x-drip-signature header value
+     * @param secret - Your webhook secret
+     * @returns Promise resolving to whether the signature is valid
+     *
+     * @example
+     * ```typescript
+     * app.post('/webhooks/drip', async (req, res) => {
+     *   const isValid = await Drip.verifyWebhookSignature(
+     *     req.rawBody,
+     *     req.headers['x-drip-signature'],
+     *     process.env.DRIP_WEBHOOK_SECRET!,
+     *   );
+     *
+     *   if (!isValid) {
+     *     return res.status(401).send('Invalid signature');
+     *   }
+     *
+     *   // Process the webhook...
+     * });
+     * ```
+     */
+    static verifyWebhookSignature(payload: string, signature: string, secret: string): Promise<boolean>;
+    /**
+     * Synchronously verifies a webhook signature using HMAC-SHA256.
+     *
+     * This method uses Node.js crypto module and is only available in Node.js environments.
+     * For edge runtimes or browsers, use the async `verifyWebhookSignature` method instead.
      *
      * @param payload - The raw request body (string)
      * @param signature - The x-drip-signature header value
@@ -1226,7 +1422,7 @@ declare class Drip {
      * @example
      * ```typescript
      * app.post('/webhooks/drip', (req, res) => {
-     *   const isValid = Drip.verifyWebhookSignature(
+     *   const isValid = Drip.verifyWebhookSignatureSync(
      *     req.rawBody,
      *     req.headers['x-drip-signature'],
      *     process.env.DRIP_WEBHOOK_SECRET!,
@@ -1240,7 +1436,53 @@ declare class Drip {
      * });
      * ```
      */
-    static verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
+    static verifyWebhookSignatureSync(payload: string, signature: string, secret: string): boolean;
+    /**
+     * Creates a StreamMeter for accumulating usage and charging once.
+     *
+     * Perfect for LLM token streaming where you want to:
+     * - Accumulate tokens locally (no API call per token)
+     * - Charge once at the end of the stream
+     * - Handle partial failures (charge for what was delivered)
+     *
+     * @param options - StreamMeter configuration
+     * @returns A new StreamMeter instance
+     *
+     * @example
+     * ```typescript
+     * const meter = drip.createStreamMeter({
+     *   customerId: 'cust_abc123',
+     *   meter: 'tokens',
+     * });
+     *
+     * // Accumulate tokens as they stream
+     * for await (const chunk of llmStream) {
+     *   meter.addSync(chunk.tokens);
+     *   yield chunk;
+     * }
+     *
+     * // Single charge at end
+     * const result = await meter.flush();
+     * console.log(`Charged ${result.charge?.amountUsdc} for ${result.quantity} tokens`);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With auto-flush threshold
+     * const meter = drip.createStreamMeter({
+     *   customerId: 'cust_abc123',
+     *   meter: 'tokens',
+     *   flushThreshold: 10000, // Charge every 10k tokens
+     * });
+     *
+     * for await (const chunk of longStream) {
+     *   await meter.add(chunk.tokens); // May auto-flush
+     * }
+     *
+     * await meter.flush(); // Final flush for remaining tokens
+     * ```
+     */
+    createStreamMeter(options: StreamMeterOptions): StreamMeter;
 }
 
-export { type BalanceResult, type Charge, type ChargeParams, type ChargeResult, type ChargeStatus, type CheckoutParams, type CheckoutResult, type CreateCustomerParams, type CreateWebhookParams, type CreateWebhookResponse, type CreateWorkflowParams, type Customer, type DeleteWebhookResponse, Drip, type DripConfig, DripError, type EmitEventParams, type EndRunParams, type EventResult, type ListChargesOptions, type ListChargesResponse, type ListCustomersOptions, type ListCustomersResponse, type ListMetersResponse, type ListWebhooksResponse, type Meter, type RecordRunEvent, type RecordRunParams, type RecordRunResult, type RunResult, type RunStatus, type RunTimeline, type StartRunParams, type Webhook, type WebhookEventType, type Workflow, Drip as default };
+export { type BalanceResult, type Charge, type ChargeParams, type ChargeResult, type ChargeStatus, type CheckoutParams, type CheckoutResult, type CreateCustomerParams, type CreateWebhookParams, type CreateWebhookResponse, type CreateWorkflowParams, type Customer, type DeleteWebhookResponse, Drip, type DripConfig, DripError, type EmitEventParams, type EndRunParams, type EventResult, type ListChargesOptions, type ListChargesResponse, type ListCustomersOptions, type ListCustomersResponse, type ListMetersResponse, type ListWebhooksResponse, type Meter, type RecordRunEvent, type RecordRunParams, type RecordRunResult, type RunResult, type RunStatus, type RunTimeline, type StartRunParams, StreamMeter, type StreamMeterFlushResult, type StreamMeterOptions, type Webhook, type WebhookEventType, type Workflow, Drip as default };

package/dist/index.js

@@ -1,3 +1,3 @@
-var g=class h extends Error{constructor(e,r,n){super(e);this.statusCode=r;this.code=n;this.name="DripError",Object.setPrototypeOf(this,h.prototype);}},m=class{apiKey;baseUrl;timeout;constructor(t){if(!t.apiKey)throw new Error("Drip API key is required");this.apiKey=t.apiKey,this.baseUrl=t.baseUrl||"https://api.drip.dev/v1",this.timeout=t.timeout||3e4;}async request(t,e={}){let r=new AbortController,n=setTimeout(()=>r.abort(),this.timeout);try{let s=await fetch(`${this.baseUrl}${t}`,{...e,signal:r.signal,headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,...e.headers}});if(s.status===204)return {success:!0};let i=await s.json();if(!s.ok)throw new g(i.message||i.error||"Request failed",s.status,i.code);return i}catch(s){throw s instanceof g?s:s instanceof Error&&s.name==="AbortError"?new g("Request timed out",408,"TIMEOUT"):new g(s instanceof Error?s.message:"Unknown error",0,"UNKNOWN")}finally{clearTimeout(n);}}async createCustomer(t){return this.request("/customers",{method:"POST",body:JSON.stringify(t)})}async getCustomer(t){return this.request(`/customers/${t}`)}async listCustomers(t){let e=new URLSearchParams;t?.limit&&e.set("limit",t.limit.toString()),t?.status&&e.set("status",t.status);let r=e.toString(),n=r?`/customers?${r}`:"/customers";return this.request(n)}async getBalance(t){return this.request(`/customers/${t}/balance`)}async charge(t){return this.request("/usage",{method:"POST",body:JSON.stringify({customerId:t.customerId,usageType:t.meter,quantity:t.quantity,idempotencyKey:t.idempotencyKey,metadata:t.metadata})})}async getCharge(t){return this.request(`/charges/${t}`)}async listCharges(t){let e=new URLSearchParams;t?.customerId&&e.set("customerId",t.customerId),t?.status&&e.set("status",t.status),t?.limit&&e.set("limit",t.limit.toString()),t?.offset&&e.set("offset",t.offset.toString());let r=e.toString(),n=r?`/charges?${r}`:"/charges";return this.request(n)}async getChargeStatus(t){return this.request(`/charges/${t}/status`)}async checkout(t){let e=await this.request("/checkout",{method:"POST",body:JSON.stringify({customer_id:t.customerId,external_customer_id:t.externalCustomerId,amount:t.amount,return_url:t.returnUrl,cancel_url:t.cancelUrl,metadata:t.metadata})});return {id:e.id,url:e.url,expiresAt:e.expires_at,amountUsd:e.amount_usd}}async createWebhook(t){return this.request("/webhooks",{method:"POST",body:JSON.stringify(t)})}async listWebhooks(){return this.request("/webhooks")}async getWebhook(t){return this.request(`/webhooks/${t}`)}async deleteWebhook(t){return this.request(`/webhooks/${t}`,{method:"DELETE"})}async testWebhook(t){return this.request(`/webhooks/${t}/test`,{method:"POST"})}async rotateWebhookSecret(t){return this.request(`/webhooks/${t}/rotate-secret`,{method:"POST"})}async createWorkflow(t){return this.request("/workflows",{method:"POST",body:JSON.stringify(t)})}async listWorkflows(){return this.request("/workflows")}async startRun(t){return this.request("/runs",{method:"POST",body:JSON.stringify(t)})}async endRun(t,e){return this.request(`/runs/${t}`,{method:"PATCH",body:JSON.stringify(e)})}async getRunTimeline(t){return this.request(`/runs/${t}`)}async emitEvent(t){return this.request("/events",{method:"POST",body:JSON.stringify(t)})}async emitEventsBatch(t){return this.request("/events/batch",{method:"POST",body:JSON.stringify({events:t})})}async listMeters(){let t=await this.request("/pricing-plans");return {data:t.data.map(e=>({id:e.id,name:e.name,meter:e.unitType,unitPriceUsd:e.unitPriceUsd,isActive:e.isActive})),count:t.count}}async recordRun(t){let e=Date.now(),r=t.workflow,n=t.workflow;if(!t.workflow.startsWith("wf_"))try{let d=(await this.listWorkflows()).data.find(o=>o.slug===t.workflow||o.id===t.workflow);if(d)r=d.id,n=d.name;else {let o=await this.createWorkflow({name:t.workflow.replace(/[_-]/g," ").replace(/\b\w/g,l=>l.toUpperCase()),slug:t.workflow,productSurface:"AGENT"});r=o.id,n=o.name;}}catch{r=t.workflow;}let s=await this.startRun({customerId:t.customerId,workflowId:r,externalRunId:t.externalRunId,correlationId:t.correlationId,metadata:t.metadata}),i=0,a=0;if(t.events.length>0){let f=t.events.map((o,l)=>({runId:s.id,eventType:o.eventType,quantity:o.quantity,units:o.units,description:o.description,costUnits:o.costUnits,metadata:o.metadata,idempotencyKey:t.externalRunId?`${t.externalRunId}:${o.eventType}:${l}`:void 0})),d=await this.emitEventsBatch(f);i=d.created,a=d.duplicates;}let u=await this.endRun(s.id,{status:t.status,errorMessage:t.errorMessage,errorCode:t.errorCode}),c=Date.now()-e,y=t.events.length>0?`${i} events recorded`:"no events",p=`${t.status==="COMPLETED"?"\u2713":t.status==="FAILED"?"\u2717":"\u25CB"} ${n}: ${y} (${u.durationMs??c}ms)`;return {run:{id:s.id,workflowId:r,workflowName:n,status:t.status,durationMs:u.durationMs},events:{created:i,duplicates:a},totalCostUnits:u.totalCostUnits,summary:p}}static generateIdempotencyKey(t){let e=[t.customerId,t.runId??"no_run",t.stepName,String(t.sequence??0)],r=0,n=e.join("|");for(let s=0;s<n.length;s++){let i=n.charCodeAt(s);r=(r<<5)-r+i,r=r&r;}return `drip_${Math.abs(r).toString(36)}_${t.stepName.slice(0,16)}`}static verifyWebhookSignature(t,e,r){let n=new TextEncoder,s=n.encode(t),i=n.encode(r),a=0;for(let c=0;c<s.length;c++)a=(a<<5)-a+s[c]+i[c%i.length]|0;let u=Math.abs(a).toString(16);return e===u||e.includes(u)}},C=m;
-export{m as Drip,g as DripError,C as default};//# sourceMappingURL=index.js.map
+var R=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(t,e)=>(typeof require<"u"?require:t)[e]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var m=class{_total=0;_flushed=false;_flushCount=0;_chargeFn;_options;constructor(t,e){this._chargeFn=t,this._options=e;}get total(){return this._total}get isFlushed(){return this._flushed}get flushCount(){return this._flushCount}async add(t){return t<=0?null:(this._total+=t,this._options.onAdd?.(t,this._total),this._options.flushThreshold!==void 0&&this._total>=this._options.flushThreshold?this.flush():null)}addSync(t){t<=0||(this._total+=t,this._options.onAdd?.(t,this._total));}async flush(){let t=this._total;if(this._total=0,t===0)return {success:true,quantity:0,charge:null,isReplay:false};let e=this._options.idempotencyKey?`${this._options.idempotencyKey}_flush_${this._flushCount}`:void 0,r=await this._chargeFn({customerId:this._options.customerId,meter:this._options.meter,quantity:t,idempotencyKey:e,metadata:this._options.metadata});this._flushed=true,this._flushCount++;let s={success:r.success,quantity:t,charge:r.charge,isReplay:r.isReplay};return this._options.onFlush?.(s),s}reset(){this._total=0;}};var d=class a extends Error{constructor(e,r,s){super(e);this.statusCode=r;this.code=s;this.name="DripError",Object.setPrototypeOf(this,a.prototype);}},y=class{apiKey;baseUrl;timeout;constructor(t){if(!t.apiKey)throw new Error("Drip API key is required");this.apiKey=t.apiKey,this.baseUrl=t.baseUrl||"https://api.drip.dev/v1",this.timeout=t.timeout||3e4;}async request(t,e={}){let r=new AbortController,s=setTimeout(()=>r.abort(),this.timeout);try{let n=await fetch(`${this.baseUrl}${t}`,{...e,signal:r.signal,headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`,...e.headers}});if(n.status===204)return {success:!0};let i=await n.json();if(!n.ok)throw new d(i.message||i.error||"Request failed",n.status,i.code);return i}catch(n){throw n instanceof d?n:n instanceof Error&&n.name==="AbortError"?new d("Request timed out",408,"TIMEOUT"):new d(n instanceof Error?n.message:"Unknown error",0,"UNKNOWN")}finally{clearTimeout(s);}}async ping(){let t=Date.now(),e=await fetch(`${this.baseUrl.replace("/v1","")}/health`,{headers:{Authorization:`Bearer ${this.apiKey}`}}),r=Date.now()-t,s=await e.json();return {ok:s.status==="healthy",status:s.status,latencyMs:r,timestamp:s.timestamp}}async createCustomer(t){return this.request("/customers",{method:"POST",body:JSON.stringify(t)})}async getCustomer(t){return this.request(`/customers/${t}`)}async listCustomers(t){let e=new URLSearchParams;t?.limit&&e.set("limit",t.limit.toString()),t?.status&&e.set("status",t.status);let r=e.toString(),s=r?`/customers?${r}`:"/customers";return this.request(s)}async getBalance(t){return this.request(`/customers/${t}/balance`)}async charge(t){return this.request("/usage",{method:"POST",body:JSON.stringify({customerId:t.customerId,usageType:t.meter,quantity:t.quantity,idempotencyKey:t.idempotencyKey,metadata:t.metadata})})}async getCharge(t){return this.request(`/charges/${t}`)}async listCharges(t){let e=new URLSearchParams;t?.customerId&&e.set("customerId",t.customerId),t?.status&&e.set("status",t.status),t?.limit&&e.set("limit",t.limit.toString()),t?.offset&&e.set("offset",t.offset.toString());let r=e.toString(),s=r?`/charges?${r}`:"/charges";return this.request(s)}async getChargeStatus(t){return this.request(`/charges/${t}/status`)}async checkout(t){let e=await this.request("/checkout",{method:"POST",body:JSON.stringify({customer_id:t.customerId,external_customer_id:t.externalCustomerId,amount:t.amount,return_url:t.returnUrl,cancel_url:t.cancelUrl,metadata:t.metadata})});return {id:e.id,url:e.url,expiresAt:e.expires_at,amountUsd:e.amount_usd}}async createWebhook(t){return this.request("/webhooks",{method:"POST",body:JSON.stringify(t)})}async listWebhooks(){return this.request("/webhooks")}async getWebhook(t){return this.request(`/webhooks/${t}`)}async deleteWebhook(t){return this.request(`/webhooks/${t}`,{method:"DELETE"})}async testWebhook(t){return this.request(`/webhooks/${t}/test`,{method:"POST"})}async rotateWebhookSecret(t){return this.request(`/webhooks/${t}/rotate-secret`,{method:"POST"})}async createWorkflow(t){return this.request("/workflows",{method:"POST",body:JSON.stringify(t)})}async listWorkflows(){return this.request("/workflows")}async startRun(t){return this.request("/runs",{method:"POST",body:JSON.stringify(t)})}async endRun(t,e){return this.request(`/runs/${t}`,{method:"PATCH",body:JSON.stringify(e)})}async getRunTimeline(t){return this.request(`/runs/${t}`)}async emitEvent(t){return this.request("/events",{method:"POST",body:JSON.stringify(t)})}async emitEventsBatch(t){return this.request("/run-events/batch",{method:"POST",body:JSON.stringify({events:t})})}async listMeters(){let t=await this.request("/pricing-plans");return {data:t.data.map(e=>({id:e.id,name:e.name,meter:e.unitType,unitPriceUsd:e.unitPriceUsd,isActive:e.isActive})),count:t.count}}async recordRun(t){let e=Date.now(),r=t.workflow,s=t.workflow;if(!t.workflow.startsWith("wf_"))try{let l=(await this.listWorkflows()).data.find(o=>o.slug===t.workflow||o.id===t.workflow);if(l)r=l.id,s=l.name;else {let o=await this.createWorkflow({name:t.workflow.replace(/[_-]/g," ").replace(/\b\w/g,f=>f.toUpperCase()),slug:t.workflow,productSurface:"AGENT"});r=o.id,s=o.name;}}catch{r=t.workflow;}let n=await this.startRun({customerId:t.customerId,workflowId:r,externalRunId:t.externalRunId,correlationId:t.correlationId,metadata:t.metadata}),i=0,u=0;if(t.events.length>0){let b=t.events.map((o,f)=>({runId:n.id,eventType:o.eventType,quantity:o.quantity,units:o.units,description:o.description,costUnits:o.costUnits,metadata:o.metadata,idempotencyKey:t.externalRunId?`${t.externalRunId}:${o.eventType}:${f}`:void 0})),l=await this.emitEventsBatch(b);i=l.created,u=l.duplicates;}let g=await this.endRun(n.id,{status:t.status,errorMessage:t.errorMessage,errorCode:t.errorCode}),h=Date.now()-e,p=t.events.length>0?`${i} events recorded`:"no events",w=`${t.status==="COMPLETED"?"\u2713":t.status==="FAILED"?"\u2717":"\u25CB"} ${s}: ${p} (${g.durationMs??h}ms)`;return {run:{id:n.id,workflowId:r,workflowName:s,status:t.status,durationMs:g.durationMs},events:{created:i,duplicates:u},totalCostUnits:g.totalCostUnits,summary:w}}static generateIdempotencyKey(t){let e=[t.customerId,t.runId??"no_run",t.stepName,String(t.sequence??0)],r=0,s=e.join("|");for(let n=0;n<s.length;n++){let i=s.charCodeAt(n);r=(r<<5)-r+i,r=r&r;}return `drip_${Math.abs(r).toString(36)}_${t.stepName.slice(0,16)}`}static async verifyWebhookSignature(t,e,r){if(!t||!e||!r)return  false;try{let s=new TextEncoder,n=s.encode(r),i=s.encode(t),u=await crypto.subtle.importKey("raw",n,{name:"HMAC",hash:"SHA-256"},!1,["sign"]),g=await crypto.subtle.sign("HMAC",u,i),h=Array.from(new Uint8Array(g)).map(c=>c.toString(16).padStart(2,"0")).join("");if(e.length!==h.length)return !1;let p=0;for(let c=0;c<e.length;c++)p|=e.charCodeAt(c)^h.charCodeAt(c);return p===0}catch{return  false}}static verifyWebhookSignatureSync(t,e,r){if(!t||!e||!r)return  false;try{let s=R("crypto"),n=s.createHmac("sha256",r).update(t).digest("hex"),i=Buffer.from(e),u=Buffer.from(n);return i.length!==u.length?!1:s.timingSafeEqual(i,u)}catch{return  false}}createStreamMeter(t){return new m(this.charge.bind(this),t)}},E=y;
+export{y as Drip,d as DripError,m as StreamMeter,E as default};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map