@usebillow/sdk 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 import { f as SavedPaymentMethod, g as CreateHostedDomainInput, h as PayInvoiceInput } from './index.d-DSEYhV2c.js';
 export { i as ContractAddSubscriptionItemInput, j as ContractApplySubscriptionCouponInput, k as ContractCancelSubscriptionInput, l as ContractChangeSubscriptionPlanInput, m as ContractCreateChargeInput, n as ContractCreateCustomerInput, o as ContractCreateMerchantInitiatedChargeInput, p as ContractCreatePortalSessionInput, q as ContractCreateProductInput, r as ContractCreateSubscriptionInput, s as ContractCreateWebhookEndpointInput, M as ContractMigrateSubscribersInput, R as ContractRefundChargeInput, t as ContractResolveRefundInput, U as ContractUpdateProductInput, u as ContractUpdateSubscriptionItemInput, v as ContractUpdateWebhookEndpointInput, H as HostedDomain, w as HostedDomainList, I as InvoicePaymentResult } from './index.d-DSEYhV2c.js';
-import { C as ChargeStatus, P as PaymentMethodStatus, I as InvoiceStatus, R as RefundStatus, W as WebhookDeliveryStatus } from './billing-status-BZQN_gm7.js';
-export { a as CHARGE_STATUSES, b as INVOICE_STATUSES, c as PAYMENT_METHOD_STATUSES, d as REFUND_STATUSES, e as WEBHOOK_DELIVERY_STATUSES } from './billing-status-BZQN_gm7.js';
+import { C as ChargeStatus, P as PaymentMethodStatus, I as InvoiceStatus, R as RefundStatus, W as WebhookDeliveryStatus } from './billing-status-DZkB0VPK.js';
+export { a as CHARGE_STATUSES, b as INVOICE_STATUSES, c as PAYMENT_METHOD_STATUSES, d as REFUND_STATUSES, e as WEBHOOK_DELIVERY_STATUSES } from './billing-status-DZkB0VPK.js';
 import { SubscriptionStatus } from './status.js';
 export { ACTIVE_SUBSCRIPTION_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, grantsAccess, isTerminal } from './status.js';
-import { c as TaxBehavior, d as Customer, U as UnappliedPaymentReason, e as CreateChargeInput, R as RequestOptions, f as Charge, g as CreateMerchantInitiatedChargeInput, I as IdempotentRequestOptions, h as CallOptions, C as CreateProductInput, i as UpdateProductInput, j as MigrationResult, k as CreateSubscriptionInput, B as BillowOptions, a as CreateCouponInput, l as Coupon, F as FeatureKind, M as MeterConfig, m as Feature, n as UpdateFeatureInput, o as UsageAlert, p as CreateUsageAlertInput, b as CheckResult, T as TrackResult, E as EntitlementView, A as AttachResult } from './billing-BF4OGaLI.js';
-export { q as ActivatedSubscriptionResult, r as BillingInterval, s as CouponDuration, t as CouponKind, u as CreateSubscriptionResult, v as EntitlementInput, w as MeterAggregation, x as MeterFilter, y as MeterRoundingMode, z as PendingSubscriptionCheckoutResult, D as PriceInput, P as Product, G as ProductEntitlement, H as ProductPrice, S as Subscription, J as SubscriptionDetail, K as SubscriptionItem, L as UpdatePriceInput, N as UsageAlertKind, O as UsageAlertMetric, Q as UsageModel, V as UsageTier } from './billing-BF4OGaLI.js';
-import { a as CreditThresholdLevel, e as CreditGrant, f as CreditTopUp, g as CreditIncludedWindow, h as CreateCreditGrantInput, i as CreditGrantRequestResult, j as CreditPacks, k as CreateCreditPackInput, l as CreditPack, U as UpdateCreditPackInput, m as CreateCreditIncludedRuleInput, n as CreditIncludedRule, o as UpdateCreditIncludedRuleInput, p as CreditIncludedWindowListParams, q as CreateCreditTopUpInput, r as CreditTopUpRequestResult, s as CreditTopUpListParams, t as CreditBalance, u as CreditLedgerEntry, v as CreditUsageParams, w as CreditUsage } from './hosted-domains-DSTQ1GZz.js';
-export { x as CreditAccountStatus, y as CreditAllocationInterval, C as CreditGrantKind, z as CreditMoney, A as CreditPackBreakdown, B as CreditPackListItem, D as CreditTopUpStatus, E as CreditTransactionType, F as CreditUsageGroupBy, G as CreditWindowState, H as HostedDomainActivatedData, d as HostedDomainDisabledData, b as HostedDomainDnsFailingData, I as HostedDomainEventBase, c as HostedDomainReassignmentPendingData, J as HostedDomainStatus, K as HostedDomainStatusReason, L as IncludedCredits, M as IncludedPeriod } from './hosted-domains-DSTQ1GZz.js';
+import { c as TaxBehavior, d as Customer, U as UnappliedPaymentReason, e as CreateChargeInput, R as RequestOptions, f as Charge, g as CreateMerchantInitiatedChargeInput, I as IdempotentRequestOptions, h as CallOptions, C as CreateProductInput, i as UpdateProductInput, j as MigrationResult, k as CreateSubscriptionInput, B as BillowOptions, a as CreateCouponInput, l as Coupon, F as FeatureKind, M as MeterConfig, m as Feature, n as UpdateFeatureInput, o as UsageAlert, p as CreateUsageAlertInput, b as CheckResult, T as TrackResult, E as EntitlementView, A as AttachResult } from './billing-Bs10EcjR.js';
+export { q as ActivatedSubscriptionResult, r as BillingInterval, s as CouponDuration, t as CouponKind, u as CreateSubscriptionResult, v as EntitlementInput, w as MeterAggregation, x as MeterFilter, y as MeterRoundingMode, z as PendingSubscriptionCheckoutResult, D as PriceInput, P as Product, G as ProductEntitlement, H as ProductPrice, S as Subscription, J as SubscriptionDetail, K as SubscriptionItem, L as UpdatePriceInput, N as UsageAlertKind, O as UsageAlertMetric, Q as UsageModel, V as UsageTier } from './billing-Bs10EcjR.js';
+import { a as CreditThresholdLevel, e as CreditGrant, f as CreditTopUp, g as CreditIncludedWindow, h as CreateCreditGrantInput, i as CreditGrantRequestResult, j as CreditAccount, k as CreditPacks, l as CreateCreditPackInput, m as CreditPack, U as UpdateCreditPackInput, n as CreateCreditIncludedRuleInput, o as CreditIncludedRule, p as UpdateCreditIncludedRuleInput, q as CreditIncludedWindowListParams, r as CreateCreditTopUpInput, s as CreditTopUpRequestResult, t as CreditTopUpListParams, u as CreditBalance, v as CreditLedgerEntry, w as CreditUsageParams, x as CreditUsage } from './hosted-domains-BrnwkHqq.js';
+export { y as CreditAccountStatus, z as CreditAllocationInterval, C as CreditGrantKind, A as CreditMoney, B as CreditPackBreakdown, D as CreditPackListItem, E as CreditTopUpStatus, F as CreditTransactionType, G as CreditUsageGroupBy, I as CreditWindowState, H as HostedDomainActivatedData, d as HostedDomainDisabledData, b as HostedDomainDnsFailingData, J as HostedDomainEventBase, c as HostedDomainReassignmentPendingData, K as HostedDomainStatus, L as HostedDomainStatusReason, M as IncludedCredits, N as IncludedPeriod } from './hosted-domains-BrnwkHqq.js';
 import 'zod';
 
 /**
  * The machine-readable error codes billow returns on `BillowApiError.code`. Mirrored from
- * `@billow/core`'s `BILLOW_ERROR_CODES` (the server's source of truth) — the SDK carries no
+ * `@billow/core`'s `BILLOW_ERROR_CODES` (the server's source of truth) - the SDK carries no
  * runtime dependency on core, so `error-codes.test.ts` asserts this list stays in lockstep.
  *
  * `switch` on these for programmatic handling (e.g. surface `rate_limited` vs `validation_error`
@@ -98,7 +98,7 @@ interface ProviderCredentialSummary {
     currency: string;
     config: Record<string, unknown>;
 }
-/** The editable view of one credential set — secret values are never returned. */
+/** The editable view of one credential set - secret values are never returned. */
 interface CredentialSet {
     provider: string;
     currency: string;
@@ -134,7 +134,7 @@ interface BusinessProfile {
     logoUrl: string | null;
     /** Brand/accent color as `#RRGGBB` (PRD-11); null = billow's default accent. */
     brandColor: string | null;
-    /** Org-default tax treatment (Phase E) — every taxable price inherits this. */
+    /** Org-default tax treatment (Phase E) - every taxable price inherits this. */
     taxEnabled: boolean;
     /** Default rate in basis points (1% = 100 bps), e.g. 1400 for Egypt's 14% VAT. */
     taxRateBps: number;
@@ -234,7 +234,7 @@ interface Paginated<T> {
  * size), so it is correct under concurrent inserts/deletes; a list that grows at its head pages
  * by cursor instead ({@link CursorListPromise}). The caller's {@link CallOptions} (`signal` /
  * `timeoutMs`) apply to EVERY page
- * fetch — an abort stops the walk mid-stream; `timeoutMs` is per page.
+ * fetch - an abort stops the walk mid-stream; `timeoutMs` is per page.
  *
  * A returned value is ONE walk: page 1 is cached on it (so `await` then `for await` on the same
  * value fetch page 1 once), which means iterating the same value again later reuses that first
@@ -353,7 +353,7 @@ interface CustomerUsage {
     allowance: number | null;
     /** Gross units used this period (sum of positive events in the period). */
     used: number;
-    /** Units topped up this period — gross credit-backs (negative events). */
+    /** Units topped up this period - gross credit-backs (negative events). */
     added: number;
     /** Remaining = allowance + added − used; null = unlimited. May be negative (overage). */
     remaining: number | null;
@@ -431,7 +431,7 @@ interface SubscriptionListItem {
     scheduledChange: ScheduledSubscriptionChange | null;
     /** Renewals left before a limited-term subscription ends; null = open-ended. */
     remainingCycles: number | null;
-    /** Failed-renewal retries run so far (PRD-06 dunning) — 0 until a renewal fails. */
+    /** Failed-renewal retries run so far (PRD-06 dunning) - 0 until a renewal fails. */
     dunningAttempts: number;
     /** ISO-8601 time the next dunning retry is due; null when not in dunning (PRD-09). */
     nextDunningAt: string | null;
@@ -471,7 +471,7 @@ interface EmailTemplateSetting {
     defaultSubject: string;
     /** The variables the subject/message may reference (without braces). */
     variables: string[];
-    /** False for compliance-required templates (the receipt) — can't be disabled. */
+    /** False for compliance-required templates (the receipt) - can't be disabled. */
     canDisable: boolean;
     /** Subject override, or null when the default is in effect. */
     subject: string | null;
@@ -580,7 +580,7 @@ interface InvoiceListItem {
     currency: string;
     customerExternalId: string;
     subscriptionId: string | null;
-    /** What the invoice is for — the plan name (subscriptions) or first line item. */
+    /** What the invoice is for - the plan name (subscriptions) or first line item. */
     reason: string | null;
     periodStart: string | null;
     periodEnd: string | null;
@@ -633,7 +633,7 @@ interface MetricsOverview {
     to: string;
     /** Monthly recurring revenue (minor units). */
     mrr: number;
-    /** Annual recurring revenue (minor units) — `mrr × 12`. */
+    /** Annual recurring revenue (minor units) - `mrr × 12`. */
     arr: number;
     /** Cohort subscription churn over the window (0..1); null if none were active at its start. */
     churnRate: number | null;
@@ -697,7 +697,7 @@ interface Whoami {
     organizationId: string;
     organizationName: string | null;
     organizationSlug: string | null;
-    /** The billing workspace the API key scopes to — what every resource belongs to. */
+    /** The billing workspace the API key scopes to - what every resource belongs to. */
     projectId: string;
     projectName: string | null;
     projectSlug: string | null;
@@ -925,7 +925,7 @@ interface CreatePortalSessionInput {
     customerId: string;
     /** Which surface to land on; defaults to the self-serve portal. */
     flow?: PortalSessionFlow;
-    /** Product slug to subscribe to — required when `flow` is `checkout`. */
+    /** Product slug to subscribe to - required when `flow` is `checkout`. */
     productId?: string;
     /**
      * Where the surface returns the Customer when they finish or exit: an absolute `https` URL
@@ -943,7 +943,7 @@ interface PortalSession {
     id: string;
     url: string;
     flow: PortalSessionFlow;
-    /** ISO-8601 expiry — the session (and its URL) stop working after this. */
+    /** ISO-8601 expiry - the session (and its URL) stop working after this. */
     expiresAt: string;
 }
 /** The single-use entry exchange's input (`BillowPortal.exchange`). */
@@ -1015,7 +1015,7 @@ interface PortalPlanChange {
     subscription: PortalSubscriptionStatus;
     /** Upgrade only: the proration invoice raised for the prorated delta, when non-zero. */
     prorationInvoiceId?: string;
-    /** Upgrade only: the proration charge's status (`succeeded`/`failed`/`processing`/`pending`) —
+    /** Upgrade only: the proration charge's status (`succeeded`/`failed`/`processing`/`pending`) -
      *  present when an immediate charge was raised, so a client can surface an unresolved payment. */
     chargeStatus?: string;
 }
@@ -1314,9 +1314,9 @@ interface WebhookEndpoint {
     createdAt: string;
     updatedAt: string;
 }
-/** Returned once at create/rotate — carries the plaintext signing secret. */
+/** Returned once at create/rotate - carries the plaintext signing secret. */
 interface WebhookEndpointWithSecret extends WebhookEndpoint {
-    /** The HMAC signing secret — shown exactly once. Store it now; it is never listed again. */
+    /** The HMAC signing secret - shown exactly once. Store it now; it is never listed again. */
     secret: string;
 }
 interface CreateWebhookEndpointInput {
@@ -1357,15 +1357,20 @@ declare class BillowApiError extends Error {
     readonly code: BillowErrorCode | (string & {});
     /** Structured error context from the server (e.g. per-field validation issues), when present. */
     readonly details?: unknown;
-    /** billow's per-request id (`x-request-id`) — quote it in a bug report to trace the server log. */
+    /** billow's per-request id (`x-request-id`) - quote it in a bug report to trace the server log. */
     readonly requestId?: string | undefined;
-    constructor(status: number, code: BillowErrorCode | (string & {}), message: string, details?: unknown, requestId?: string);
+    /**
+     * How many seconds to wait before trying again, from the response's `Retry-After` header (sent
+     * with a `429 rate_limited`); undefined when the response did not say.
+     */
+    readonly retryAfterSeconds?: number | undefined;
+    constructor(status: number, code: BillowErrorCode | (string & {}), message: string, details?: unknown, requestId?: string, retryAfterSeconds?: number);
 }
 /** Everything a request needs: the transport, the base URL, the bearer, and resilience knobs. */
 interface RequestContext {
     fetch: typeof fetch;
     baseUrl: string;
-    /** The bearer — a secret/publishable API key, or a portal-session token. */
+    /** The bearer - a secret/publishable API key, or a portal-session token. */
     bearer: string;
     timeoutMs: number;
     maxRetries: number;
@@ -1461,6 +1466,23 @@ declare function createCreditsResource(ctx: RequestContext): {
          */
         create: (input: CreateCreditGrantInput, options: IdempotentRequestOptions) => Promise<CreditGrantRequestResult>;
     };
+    accounts: {
+        /**
+         * Freeze a customer's Credit Account (by external id): it takes no new reservations - a
+         * reserve throws `account_frozen` (423) - until unfrozen, while holds already made still
+         * commit and release, and grants, top-ups, reversals and included credits still fund it.
+         * Safe to retry: freezing a frozen account changes nothing and answers `changed: false`. A
+         * customer with no account yet gets one, frozen. Throws `account_closed` (409) for an erased
+         * customer.
+         */
+        freeze: (customer: string, options?: CallOptions) => Promise<CreditAccount>;
+        /**
+         * Unfreeze a customer's Credit Account (by external id): it takes reservations again. Safe to
+         * retry: unfreezing an account that is not frozen changes nothing and answers
+         * `changed: false`.
+         */
+        unfreeze: (customer: string, options?: CallOptions) => Promise<CreditAccount>;
+    };
     packs: {
         /**
          * The Credit Packs a customer can buy in `currency` (ISO 4217), cheapest first: credits and
@@ -2005,7 +2027,7 @@ declare function createInvoicesResource(ctx: RequestContext): {
     receipt: (id: string, options?: CallOptions) => Promise<ArrayBuffer>;
 };
 
-/** The marketplace Integration catalog — install / configure / toggle / uninstall (ADR-0008). */
+/** The marketplace Integration catalog - install / configure / toggle / uninstall (ADR-0008). */
 declare function createMarketplaceResource(ctx: RequestContext): {
     /** Every available Integration with this tenant's install state (no secret values). */
     catalog: (options?: CallOptions) => Promise<CatalogItem[]>;
@@ -2210,7 +2232,7 @@ declare function createProductsResource(ctx: RequestContext): {
 };
 
 /**
- * Organization settings (Phase D3, F) — the configurable dunning schedule, usage settlement grace,
+ * Organization settings (Phase D3, F) - the configurable dunning schedule, usage settlement grace,
  * the cross-currency reporting currency + FX-rate registry (ADR-0013), and transactional email
  * template overrides (PRD-10). All secret-key/server-side surface.
  */
@@ -2229,7 +2251,7 @@ declare function createSettingsResource(ctx: RequestContext): {
     };
     /**
      * Usage settlement grace (hours): defers *collection* of a boundary-adjacent priced
-     * calendar-meter renewal past the tz month boundary until late usage settles — the billed
+     * calendar-meter renewal past the tz month boundary until late usage settles - the billed
      * windows/amount are unchanged, only the invoice timing shifts. `0` disables it (the default);
      * a no-op for any subscription without a priced calendar meter. Cap 72h.
      */
@@ -2421,7 +2443,7 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
         productSlug: string;
         productMetadata: Record<string, string>;
     } | null>;
-    /** Cancel — immediately, or at period end with `{ atPeriodEnd: true }`. */
+    /** Cancel - immediately, or at period end with `{ atPeriodEnd: true }`. */
     cancel: (id: string, opts?: {
         atPeriodEnd?: boolean;
     }) => Promise<{
@@ -2530,7 +2552,7 @@ declare function createSubscriptionsResource(ctx: RequestContext): {
         couponId: string;
         cyclesRemaining: number | null;
     }>;
-    /** Change plan — immediate prorated upgrade, or downgrade scheduled for period end. `productId` accepts the product's id or slug. */
+    /** Change plan - immediate prorated upgrade, or downgrade scheduled for period end. `productId` accepts the product's id or slug. */
     changePlan: (id: string, productId: string) => Promise<{
         id: string;
         status: "active" | "incomplete" | "incomplete_expired" | "trialing" | "past_due" | "paused" | "canceled" | "unpaid";
@@ -2638,14 +2660,14 @@ declare function createWebhookEndpointsResource(ctx: RequestContext): {
     update: (id: string, input: UpdateWebhookEndpointInput) => Promise<WebhookEndpoint>;
     /** Delete an endpoint and its delivery history. */
     delete: (id: string) => Promise<void>;
-    /** Rotate the signing secret — the new plaintext is returned once. */
+    /** Rotate the signing secret - the new plaintext is returned once. */
     rotateSecret: (id: string) => Promise<WebhookEndpointWithSecret>;
     /** List delivery attempts for an endpoint (newest first). Auto-paginating. */
     deliveries: (id: string, params?: ListParams, options?: CallOptions) => ListPromise<WebhookDelivery>;
 };
 
 /**
- * billow client SDK — the "two lines of code" surface, mirroring Autumn's shape
+ * billow client SDK - the "two lines of code" surface, mirroring Autumn's shape
  * (CONTEXT/ARCHITECTURE §10). A thin typed wrapper over the billow REST API.
  *
  *   const billow = new Billow(process.env.BILLOW_SECRET_KEY!);
@@ -2684,7 +2706,7 @@ declare class Billow {
     /** Custom domains for the hosted customer portal (live keys, behind a rollout flag). */
     hostedDomains: ReturnType<typeof createHostedDomainsResource>;
     /**
-     * Organization settings (Phase D3, F) — the configurable dunning schedule, usage settlement grace,
+     * Organization settings (Phase D3, F) - the configurable dunning schedule, usage settlement grace,
      * and the cross-currency reporting currency + FX-rate registry (ADR-0013).
      */
     settings: ReturnType<typeof createSettingsResource>;
@@ -2692,12 +2714,12 @@ declare class Billow {
     coupons: {
         /** Define a coupon (a reusable discount template). */
         create: (input: CreateCouponInput) => Promise<Coupon>;
-        /** List coupons (secret key only — enumerates live promo codes). Auto-paginating. */
+        /** List coupons (secret key only - enumerates live promo codes). Auto-paginating. */
         list: (params?: ListParams, options?: CallOptions) => ListPromise<Coupon>;
         /** Deactivate a coupon (existing discounts keep running). */
         deactivate: (id: string) => Promise<Coupon>;
     };
-    /** Manage developer webhook endpoints — register, rotate secrets, inspect deliveries.
+    /** Manage developer webhook endpoints - register, rotate secrets, inspect deliveries.
      *  (To VERIFY incoming deliveries, import `constructEvent` from `@usebillow/sdk/webhooks`.) */
     features: {
         /** Define a feature (a boolean access gate, or a metered feature with a meter). */
@@ -2708,7 +2730,7 @@ declare class Billow {
             meter?: MeterConfig;
         }) => Promise<Feature>;
         /**
-         * Edit a feature in place: its `name`, and — for a metered feature — its `meter`
+         * Edit a feature in place: its `name`, and - for a metered feature - its `meter`
          * aggregation. The server refuses a meter change once usage has been recorded (it
          * would rewrite billed history), so set the meter right at create time or before you
          * start tracking. Returns the updated feature.
@@ -2742,7 +2764,7 @@ declare class Billow {
          * choose a credential set and `target` to probe one verify target (Paymob: a
          * method); pass `sampleToken` (SANDBOX ONLY) to run a functional sub-test.
          * This probe hits the provider's live API (mutates nothing here), so it takes a
-         * per-call {@link CallOptions} for a timeout / cancellation — `opts` is spread into
+         * per-call {@link CallOptions} for a timeout / cancellation - `opts` is spread into
          * the body, so `options` stays a separate trailing arg (never merged in).
          */
         verify: (provider: string, opts?: {
@@ -2762,7 +2784,7 @@ declare class Billow {
             }>;
         };
     };
-    /** The merchant's business identity — the seller block on documents and email from-name. */
+    /** The merchant's business identity - the seller block on documents and email from-name. */
     businessProfile: {
         /** The stored profile, or null if one was never saved. */
         get: (options?: CallOptions) => Promise<BusinessProfile | null>;
@@ -2771,11 +2793,11 @@ declare class Billow {
     };
     /**
      * Hosted customer surfaces (Phase G, ADR-0014). Mint a portal session for one of
-     * your signed-in users and redirect them to the returned `url` — the self-serve
+     * your signed-in users and redirect them to the returned `url` - the self-serve
      * portal, or a `checkout` hand-off for `productId`. The Customer's own calls go
      * through {@link BillowPortal}, constructed with the session token.
      */
-    /** Identity of this key's tenant — org, environment, configured currencies. */
+    /** Identity of this key's tenant - org, environment, configured currencies. */
     me(options?: CallOptions): Promise<Whoami>;
     /**
      * Global search (PRD-12) across customers, invoices, subscriptions, and charges
@@ -2785,7 +2807,7 @@ declare class Billow {
     search(q: string, limit?: number, options?: CallOptions): Promise<SearchResults>;
     /**
      * Gate access to a feature. `featureId` is the feature slug. Returns
-     * `{ allowed, balance }` — `balance` is `null` for unlimited/boolean features.
+     * `{ allowed, balance }` - `balance` is `null` for unlimited/boolean features.
      */
     check(input: {
         customerId: string;
@@ -2793,14 +2815,14 @@ declare class Billow {
     }, options?: CallOptions): Promise<CheckResult>;
     /**
      * Record usage of a metered feature (`value` defaults to 1; negative credits
-     * back). Pass `idempotencyKey` to make a retried call a no-op — which also makes the call
+     * back). Pass `idempotencyKey` to make a retried call a no-op - which also makes the call
      * safe to retry automatically when `maxRetries` is set.
      */
     track(input: {
         customerId: string;
         featureId: string;
         value?: number;
-        /** Arbitrary event properties — used by meter filters and property-based aggregations. */
+        /** Arbitrary event properties - used by meter filters and property-based aggregations. */
         properties?: Record<string, string | number>;
         idempotencyKey?: string;
         /**
@@ -2820,7 +2842,7 @@ declare class Billow {
 /**
  * The browser-safe client: construct it with a **publishable** key (`bl_<env>_pk_…`)
  * to read the public catalog from any origin (CORS-enabled). It exposes ONLY public,
- * project-scoped reads — products and their prices — so it is safe to ship in a
+ * project-scoped reads - products and their prices - so it is safe to ship in a
  * frontend bundle. Customer-scoped data (entitlements, checkout) is never reachable
  * with a publishable key; use the server handler or a portal session for that.
  */
@@ -2828,7 +2850,7 @@ declare class BillowPublishable {
     #private;
     constructor(publishableKey: string, opts?: BillowOptions);
     products: {
-        /** The active catalog — products and their prices, for a pricing table. */
+        /** The active catalog - products and their prices, for a pricing table. */
         list: (options?: CallOptions) => Promise<{
             id: string;
             slug: string;
@@ -2905,13 +2927,13 @@ declare class BillowPublishable {
 /**
  * The customer-surface client (Phase G, ADR-0014): construct it with a portal
  * session token (minted by your backend via `billow.portalSessions.create`) to act
- * as that one Customer. It exposes only their own data — no operator/secret-key
- * surface — so the token can be held by a hosted portal app safely.
+ * as that one Customer. It exposes only their own data - no operator/secret-key
+ * surface - so the token can be held by a hosted portal app safely.
  */
 declare class BillowPortal {
     #private;
     constructor(sessionToken: string, opts?: BillowOptions);
-    /** The portal shell: flow, return URL, merchant brand, and customer identity —
+    /** The portal shell: flow, return URL, merchant brand, and customer identity -
      *  the lightweight payload the hosting app frames every page with, and the
      *  validate-and-route check at login. */
     session(options?: CallOptions): Promise<PortalSessionInfo>;
@@ -3002,4 +3024,4 @@ declare class BillowPortal {
     };
 }
 
-export { AttachResult, BILLOW_ERROR_CODES, Billow, BillowApiError, type BillowErrorCode, BillowOptions, BillowPortal, BillowPublishable, type BusinessProfile, CallOptions, type CatalogItem, Charge, type ChargeListItem, type ChargeListParams, type ChargeSearchHit, ChargeStatus, CheckResult, type CheckoutMethodInfo, type ConfigField, type ConfigFieldOption, type ConfigFieldType, Coupon, CreateChargeInput, CreateCouponInput, CreateCreditGrantInput, CreateCreditIncludedRuleInput, CreateCreditPackInput, type CreateCreditQuoteInput, type CreateCreditReservationInput, CreateCreditTopUpInput, CreateHostedDomainInput, CreateMerchantInitiatedChargeInput, type CreatePortalSessionInput, CreateProductInput, CreateSubscriptionInput, CreateUsageAlertInput, type CreateWebhookEndpointInput, type CredentialSet, CreditBalance, type CreditDimensions, CreditGrant, CreditGrantRequestResult, CreditIncludedRule, CreditIncludedWindow, CreditIncludedWindowListParams, CreditLedgerEntry, type CreditLineItem, CreditPack, CreditPacks, type CreditPricedLine, type CreditQuote, type CreditRateCard, type CreditRateCardItem, type CreditReservation, type CreditReservationListParams, type CreditReservationPage, type CreditReservationRequestResult, type CreditReservationStatus, type CreditReversal, type CreditReversalRequestResult, CreditThresholdLevel, CreditTopUp, CreditTopUpListParams, CreditTopUpRequestResult, CreditUsage, CreditUsageParams, type CursorListParams, type CursorListPromise, type CursorPaginated, Customer, type CustomerAnonymizationResult, type CustomerCreditsExport, type CustomerDataExport, type CustomerListItem, type CustomerListParams, type CustomerOverview, type CustomerSearchHit, type CustomerUsage, type CustomerUsageDetail, type EmailDeliveryListItem, type EmailDeliveryListParams, type EmailDeliveryStatus, type EmailTemplateSetting, EntitlementView, type ExchangeRate, type ExportJsonValue, type ExternalPaymentMethod, type ExternalPaymentResult, Feature, FeatureKind, IdempotentRequestOptions, type InboundWebhookListItem, type InboundWebhookListParams, type InboundWebhookOutcome, type IntegrationDefinition, type IntegrationKind, type IntegrationTier, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListItem, type InvoiceListParams, type InvoiceSearchHit, InvoiceStatus, type ListParams, type ListPromise, MeterConfig, type MetricsOverview, type MetricsParams, type MetricsRollup, MigrationResult, type OutboxEventListItem, type OutboxEventListParams, type OutboxEventStatus, type Paginated, PayInvoiceInput, type PaymentMethod, PaymentMethodStatus, type PaymentProviderDefinition, type PortalCardSetupResult, type PortalCheckout, type PortalPlanChange, type PortalSession, type PortalSessionExchange, type PortalSessionExchangeInput, type PortalSessionFlow, type PortalSessionInfo, type PortalSubscriptionStatus, type PortalView, type ProviderCredentialSummary, type ProviderVerifyResult, type ProviderVerifyTarget, type ProviderVerifyTargetResult, type PublishCreditRateCardInput, type RecordExternalPaymentInput, type Refund, type RefundChargeInput, type RefundRequestResult, type RefundReviewReason, RefundStatus, RequestOptions, type ResolveRefundInput, type ReverseCreditConsumptionInput, SavedPaymentMethod, type ScheduledSubscriptionChange, type SearchResults, type SubscriptionListItem, type SubscriptionListParams, type SubscriptionSearchHit, SubscriptionStatus, TaxBehavior, type TimeseriesInterval, type TimeseriesMetric, type TimeseriesParams, type TimeseriesPoint, type TimeseriesResult, TrackResult, UnappliedPaymentReason, type UpdateBusinessProfileInput, UpdateCreditIncludedRuleInput, UpdateCreditPackInput, type UpdateEmailTemplateInput, UpdateFeatureInput, UpdateProductInput, type UpdateWebhookEndpointInput, type UpsertCredentialsInput, UsageAlert, type WebhookDelivery, WebhookDeliveryStatus, type WebhookEndpoint, type WebhookEndpointWithSecret, type Whoami, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits };
+export { AttachResult, BILLOW_ERROR_CODES, Billow, BillowApiError, type BillowErrorCode, BillowOptions, BillowPortal, BillowPublishable, type BusinessProfile, CallOptions, type CatalogItem, Charge, type ChargeListItem, type ChargeListParams, type ChargeSearchHit, ChargeStatus, CheckResult, type CheckoutMethodInfo, type ConfigField, type ConfigFieldOption, type ConfigFieldType, Coupon, CreateChargeInput, CreateCouponInput, CreateCreditGrantInput, CreateCreditIncludedRuleInput, CreateCreditPackInput, type CreateCreditQuoteInput, type CreateCreditReservationInput, CreateCreditTopUpInput, CreateHostedDomainInput, CreateMerchantInitiatedChargeInput, type CreatePortalSessionInput, CreateProductInput, CreateSubscriptionInput, CreateUsageAlertInput, type CreateWebhookEndpointInput, type CredentialSet, CreditAccount, CreditBalance, type CreditDimensions, CreditGrant, CreditGrantRequestResult, CreditIncludedRule, CreditIncludedWindow, CreditIncludedWindowListParams, CreditLedgerEntry, type CreditLineItem, CreditPack, CreditPacks, type CreditPricedLine, type CreditQuote, type CreditRateCard, type CreditRateCardItem, type CreditReservation, type CreditReservationListParams, type CreditReservationPage, type CreditReservationRequestResult, type CreditReservationStatus, type CreditReversal, type CreditReversalRequestResult, CreditThresholdLevel, CreditTopUp, CreditTopUpListParams, CreditTopUpRequestResult, CreditUsage, CreditUsageParams, type CursorListParams, type CursorListPromise, type CursorPaginated, Customer, type CustomerAnonymizationResult, type CustomerCreditsExport, type CustomerDataExport, type CustomerListItem, type CustomerListParams, type CustomerOverview, type CustomerSearchHit, type CustomerUsage, type CustomerUsageDetail, type EmailDeliveryListItem, type EmailDeliveryListParams, type EmailDeliveryStatus, type EmailTemplateSetting, EntitlementView, type ExchangeRate, type ExportJsonValue, type ExternalPaymentMethod, type ExternalPaymentResult, Feature, FeatureKind, IdempotentRequestOptions, type InboundWebhookListItem, type InboundWebhookListParams, type InboundWebhookOutcome, type IntegrationDefinition, type IntegrationKind, type IntegrationTier, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListItem, type InvoiceListParams, type InvoiceSearchHit, InvoiceStatus, type ListParams, type ListPromise, MeterConfig, type MetricsOverview, type MetricsParams, type MetricsRollup, MigrationResult, type OutboxEventListItem, type OutboxEventListParams, type OutboxEventStatus, type Paginated, PayInvoiceInput, type PaymentMethod, PaymentMethodStatus, type PaymentProviderDefinition, type PortalCardSetupResult, type PortalCheckout, type PortalPlanChange, type PortalSession, type PortalSessionExchange, type PortalSessionExchangeInput, type PortalSessionFlow, type PortalSessionInfo, type PortalSubscriptionStatus, type PortalView, type ProviderCredentialSummary, type ProviderVerifyResult, type ProviderVerifyTarget, type ProviderVerifyTargetResult, type PublishCreditRateCardInput, type RecordExternalPaymentInput, type Refund, type RefundChargeInput, type RefundRequestResult, type RefundReviewReason, RefundStatus, RequestOptions, type ResolveRefundInput, type ReverseCreditConsumptionInput, SavedPaymentMethod, type ScheduledSubscriptionChange, type SearchResults, type SubscriptionListItem, type SubscriptionListParams, type SubscriptionSearchHit, SubscriptionStatus, TaxBehavior, type TimeseriesInterval, type TimeseriesMetric, type TimeseriesParams, type TimeseriesPoint, type TimeseriesResult, TrackResult, UnappliedPaymentReason, type UpdateBusinessProfileInput, UpdateCreditIncludedRuleInput, UpdateCreditPackInput, type UpdateEmailTemplateInput, UpdateFeatureInput, UpdateProductInput, type UpdateWebhookEndpointInput, type UpsertCredentialsInput, UsageAlert, type WebhookDelivery, WebhookDeliveryStatus, type WebhookEndpoint, type WebhookEndpointWithSecret, type Whoami, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits };

package/dist/index.js

@@ -1,4 +1,4 @@
-export { BILLOW_ERROR_CODES, Billow, BillowApiError, BillowPortal, BillowPublishable, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits } from './chunk-GT5VBLN5.js';
-export { ACTIVE_SUBSCRIPTION_STATUSES, CHARGE_STATUSES, INVOICE_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, PAYMENT_METHOD_STATUSES, REFUND_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, WEBHOOK_DELIVERY_STATUSES, grantsAccess, isTerminal } from './chunk-CCG4F5FK.js';
+export { BILLOW_ERROR_CODES, Billow, BillowApiError, BillowPortal, BillowPublishable, currencyExponent, formatMoney, isSecretField, toMajorUnits, toMinorUnits } from './chunk-XUFQG6EA.js';
+export { ACTIVE_SUBSCRIPTION_STATUSES, CHARGE_STATUSES, INVOICE_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, PAYMENT_METHOD_STATUSES, REFUND_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, WEBHOOK_DELIVERY_STATUSES, grantsAccess, isTerminal } from './chunk-47J7FYM5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/ingestion.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ingestion.ts"],"names":[],"mappings":"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","file":"ingestion.cjs","sourcesContent":["/**\n * Auto-metering (PRD-16): ingestion strategies that call billow's `track()` for you,\n * so you never hand-instrument usage.\n *\n * Two layers:\n *   1. A generic primitive — {@link createUsageMeter} + {@link meterFunction} — a\n *      non-blocking, buffered, idempotent dispatcher you can point at ANY usage\n *      source (an S3 upload, a job run, a DB write).\n *   2. LLM strategies built on it — {@link meterOpenAI} (OpenAI-compatible clients)\n *      and {@link meterAIResult} (Vercel AI SDK) that auto-count prompt+completion\n *      tokens from the provider's own response (never re-tokenizing).\n *\n * Posture (every strategy): SERVER-SIDE ONLY — a browser can't be trusted to\n * self-report usage — and NON-BLOCKING: metering is a side effect that can never\n * delay or break the wrapped call. A failed `track()` buffers and retries under an\n * idempotency key; if it ultimately fails it is dropped (via `onError`), never thrown.\n *\n *   import { Billow } from \"@usebillow/sdk\";\n *   import { createUsageMeter, meterOpenAI } from \"@usebillow/sdk/ingestion\";\n *\n *   const billow = new Billow(process.env.BILLOW_SECRET_KEY!);\n *   const meter = createUsageMeter(billow);\n *   const openai = meterOpenAI(new OpenAI(), {\n *     meter,\n *     feature: \"tokens\",\n *     customer: (params) => String(params.user), // your billow customer id\n *   });\n *   // use `openai` exactly as before — every completion auto-meters its tokens.\n */\n\nimport type { Billow } from \"./index\";\n\n/** One usage event handed to `track()`. Mirrors {@link Billow.track}'s input. */\nexport interface UsageRecord {\n  customerId: string;\n  featureId: string;\n  /** Units to record (the engine defaults to 1). */\n  value?: number;\n  /** Event properties for meter filters / property-based aggregations. */\n  properties?: Record<string, string | number>;\n  /**\n   * Dedup key. Auto-generated per record when omitted, so a retried dispatch is a\n   * no-op — set it yourself to dedupe across process restarts.\n   */\n  idempotencyKey?: string;\n}\n\n/** The minimal client the meter needs — the real {@link Billow} satisfies it. */\nexport type TrackClient = Pick<Billow, \"track\">;\n\nexport interface MeterOptions {\n  /** Max dispatch attempts for one record before it's dropped (default 5). */\n  maxAttempts?: number;\n  /** Base retry backoff in ms; doubles each attempt (default 250). */\n  retryBaseMs?: number;\n  /** Called once when a record is permanently dropped after exhausting retries. */\n  onError?: (error: unknown, record: UsageRecord) => void;\n}\n\n/**\n * A buffered, non-blocking dispatcher to `track()`. `record()` returns immediately\n * and never throws; delivery (with retries under an idempotency key) happens in the\n * background. Call {@link UsageMeter.flush} before a serverless handler returns so\n * pending records aren't lost when the process freezes.\n */\nexport interface UsageMeter {\n  /** Enqueue a usage event. Returns immediately, never throws. */\n  record(record: UsageRecord): void;\n  /**\n   * Enqueue a usage event whose record resolves LATER (e.g. a streamed response\n   * whose token totals arrive as a promise). Registers the pending work immediately\n   * so {@link UsageMeter.flush} awaits it — a `null` resolution or a rejected source\n   * is dropped. Returns immediately, never throws.\n   */\n  recordAsync(source: Promise<UsageRecord | null>): void;\n  /** Resolve once every buffered dispatch has settled (delivered or dropped). */\n  flush(): Promise<void>;\n  /** Records still in flight (queued or retrying). */\n  readonly pending: number;\n}\n\nconst DEFAULT_MAX_ATTEMPTS = 5;\nconst DEFAULT_RETRY_BASE_MS = 250;\n\nfunction newIdempotencyKey(): string {\n  return crypto.randomUUID();\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Build a {@link UsageMeter} bound to a billow client (or any `{ track }`). */\nexport function createUsageMeter(client: TrackClient, options: MeterOptions = {}): UsageMeter {\n  const maxAttempts = Math.max(1, options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS);\n  const retryBaseMs = Math.max(0, options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS);\n  const inFlight = new Set<Promise<void>>();\n\n  async function dispatch(record: UsageRecord): Promise<void> {\n    // Freeze one idempotency key for the record so every retry is the SAME call.\n    const input: UsageRecord = {\n      ...record,\n      idempotencyKey: record.idempotencyKey ?? newIdempotencyKey(),\n    };\n    let lastError: unknown;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        await client.track(input);\n        return;\n      } catch (error) {\n        lastError = error;\n        if (attempt < maxAttempts) await sleep(retryBaseMs * 2 ** (attempt - 1));\n      }\n    }\n    try {\n      options.onError?.(lastError, input);\n    } catch {\n      // A throwing onError must not reject the tracked dispatch (which would make\n      // flush() reject) — the meter's contract is that it never throws.\n    }\n  }\n\n  /** Register a unit of metering work so `flush()`/`pending` account for it. */\n  function track(work: Promise<void>): void {\n    const p = work.finally(() => {\n      inFlight.delete(p);\n    });\n    inFlight.add(p);\n  }\n\n  return {\n    record(record) {\n      track(dispatch(record));\n    },\n    recordAsync(source) {\n      // Chain resolve-then-dispatch into ONE tracked unit so flush() covers work\n      // whose record isn't known yet. A null record or a rejected source is dropped.\n      track(\n        source.then(\n          (record) => (record ? dispatch(record) : undefined),\n          () => undefined,\n        ),\n      );\n    },\n    flush() {\n      return Promise.all([...inFlight]).then(() => undefined);\n    },\n    get pending() {\n      return inFlight.size;\n    },\n  };\n}\n\n/**\n * Derive a usage record from a completed call. Return `null` to skip metering it\n * (e.g. a cache hit with no billable usage). Receives the resolved result and the\n * original call arguments.\n */\nexport type UsageExtractor<A extends unknown[], R> = (result: R, args: A) => UsageRecord | null;\n\n/**\n * Wrap any async function so each successful call auto-records usage via `meter` —\n * the generic ingestion primitive. Point it at any source by supplying an `extract`.\n * Metering runs AFTER the call resolves and never blocks it; an extractor that\n * throws is swallowed. If the wrapped call itself rejects, nothing is recorded and\n * the error propagates unchanged.\n */\nexport function meterFunction<A extends unknown[], R>(\n  fn: (...args: A) => Promise<R>,\n  meter: UsageMeter,\n  extract: UsageExtractor<A, R>,\n): (...args: A) => Promise<R> {\n  return async (...args: A) => {\n    const result = await fn(...args);\n    try {\n      const record = extract(result, args);\n      if (record) meter.record(record);\n    } catch {\n      // Metering must never break the wrapped call — drop extractor errors.\n    }\n    return result;\n  };\n}\n\n/**\n * Yield every value of `source` straight through to the consumer while calling\n * `onValue` for each and `onDone` when iteration finishes (including an early\n * `break`/`return` — it runs in a `finally`). Taps a stream WITHOUT consuming it:\n * the caller still receives every chunk. Tap callbacks that throw are swallowed so\n * they can't break the stream.\n */\nexport async function* tapAsyncIterable<T>(\n  source: AsyncIterable<T>,\n  taps: { onValue?: (value: T) => void; onDone?: () => void },\n): AsyncGenerator<T> {\n  try {\n    for await (const value of source) {\n      try {\n        taps.onValue?.(value);\n      } catch {\n        // never let a tap break the passthrough\n      }\n      yield value;\n    }\n  } finally {\n    try {\n      taps.onDone?.();\n    } catch {\n      // never let a tap break the passthrough\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// LLM token metering\n// ---------------------------------------------------------------------------\n\n/** Normalized token counts, whatever the provider's field naming. */\nexport interface TokenCounts {\n  promptTokens: number;\n  completionTokens: number;\n  totalTokens: number;\n}\n\n/** Which token count a meter records as its `value` (default `\"total\"`). */\nexport type TokenCount = \"total\" | \"prompt\" | \"completion\";\n\nfunction firstNumber(...values: unknown[]): number | null {\n  for (const v of values) if (typeof v === \"number\" && Number.isFinite(v)) return v;\n  return null;\n}\n\n/**\n * Read token counts from a provider usage object, accepting OpenAI (`prompt_tokens`\n * / `completion_tokens` / `total_tokens`), Vercel AI SDK v4 (`promptTokens` / …) and\n * v5 (`inputTokens` / `outputTokens`) shapes. Returns `null` when no token fields\n * are present. `totalTokens` is derived from prompt+completion when not supplied.\n */\nexport function normalizeTokenUsage(usage: unknown): TokenCounts | null {\n  if (typeof usage !== \"object\" || usage === null) return null;\n  const u = usage as {\n    prompt_tokens?: unknown;\n    promptTokens?: unknown;\n    inputTokens?: unknown;\n    completion_tokens?: unknown;\n    completionTokens?: unknown;\n    outputTokens?: unknown;\n    total_tokens?: unknown;\n    totalTokens?: unknown;\n  };\n  const prompt = firstNumber(u.prompt_tokens, u.promptTokens, u.inputTokens);\n  const completion = firstNumber(u.completion_tokens, u.completionTokens, u.outputTokens);\n  const total = firstNumber(u.total_tokens, u.totalTokens);\n  if (prompt === null && completion === null && total === null) return null;\n  const promptTokens = prompt ?? 0;\n  const completionTokens = completion ?? 0;\n  return {\n    promptTokens,\n    completionTokens,\n    totalTokens: total ?? promptTokens + completionTokens,\n  };\n}\n\nfunction pickCount(counts: TokenCounts, which: TokenCount): number {\n  if (which === \"prompt\") return counts.promptTokens;\n  if (which === \"completion\") return counts.completionTokens;\n  return counts.totalTokens;\n}\n\n/** A value supplied directly, or resolved from a call's params. */\ntype Resolvable<T, P> = T | ((params: P) => T);\n\nfunction resolveValue<T, P>(r: Resolvable<T, P>, params: P): T {\n  return typeof r === \"function\" ? (r as (p: P) => T)(params) : r;\n}\n\nexport interface MeterLLMOptions<P = unknown> {\n  /** The buffered meter that dispatches to `track()`. */\n  meter: UsageMeter;\n  /** The metered feature (token meter) id — static, or resolved per call. */\n  feature: Resolvable<string, P>;\n  /**\n   * The billow customer to bill. Static for single-tenant, or resolved per call\n   * (e.g. from the OpenAI `user` param) for multi-tenant. Returning `null`/`undefined`\n   * skips metering that call — there's no customer to attribute it to.\n   */\n  customer: Resolvable<string | null | undefined, P>;\n  /** Which token count to record as the meter value (default `\"total\"`). */\n  count?: TokenCount;\n  /** Extra event properties merged onto each record (`model` is added automatically). */\n  properties?: (params: P, tokens: TokenCounts) => Record<string, string | number>;\n}\n\n/**\n * Build the usage record for one LLM call from its usage + model, or `null` to skip.\n * TOTAL by contract — a throwing `customer`/`feature`/`properties` resolver (e.g. an\n * unexpected params shape) drops the record rather than surfacing in the wrapped\n * call, so every caller (sync or async) inherits the non-blocking guarantee here.\n */\nfunction buildTokenRecord<P>(\n  options: MeterLLMOptions<P>,\n  params: P,\n  usage: unknown,\n  model: unknown,\n): UsageRecord | null {\n  const counts = normalizeTokenUsage(usage);\n  if (!counts) return null;\n  try {\n    const customerId = resolveValue(options.customer, params);\n    if (!customerId) return null;\n    const properties: Record<string, string | number> = {\n      tokens_prompt: counts.promptTokens,\n      tokens_completion: counts.completionTokens,\n      tokens_total: counts.totalTokens,\n      ...(typeof model === \"string\" ? { model } : {}),\n      ...options.properties?.(params, counts),\n    };\n    return {\n      customerId,\n      featureId: resolveValue(options.feature, params),\n      value: pickCount(counts, options.count ?? \"total\"),\n      properties,\n    };\n  } catch {\n    return null; // a resolver mistake must never break the wrapped call\n  }\n}\n\nfunction isPromiseLike(v: unknown): v is Promise<unknown> {\n  return (\n    (typeof v === \"object\" || typeof v === \"function\") &&\n    v !== null &&\n    typeof (v as { then?: unknown }).then === \"function\"\n  );\n}\n\n/** The two params slots an OpenAI-style `create(body, requestOptions?)` takes. */\ntype CreateArgs = [params: Record<string, unknown>, ...rest: unknown[]];\n\nfunction wrapOpenAICreate(\n  create: (...args: unknown[]) => unknown,\n  thisArg: unknown,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): (...args: CreateArgs) => unknown {\n  return (params, ...rest) => {\n    const returned = Reflect.apply(create, thisArg, [params, ...rest]);\n    // openai-node returns a thenable (APIPromise) for BOTH streaming and not.\n    if (!isPromiseLike(returned)) return returned;\n\n    if ((params as { stream?: unknown }).stream === true) {\n      // Streaming: TAP iteration to read the usage the final chunk carries (present\n      // when the caller sets `stream_options.include_usage`) WITHOUT dropping the\n      // OpenAI return contract — the APIPromise keeps its helpers and the resolved\n      // Stream keeps its methods; we only override `Symbol.asyncIterator`.\n      return proxyResolved(returned, (stream) =>\n        typeof stream === \"object\" && stream !== null\n          ? proxyAsyncIterable(stream, () =>\n              tapOpenAIStream(stream as AsyncIterable<unknown>, params, options),\n            )\n          : stream,\n      );\n    }\n    // Non-streaming: record from the resolved completion's `.usage`, tracked by the\n    // meter so `flush()` awaits it. The caller receives the ORIGINAL promise\n    // untouched (APIPromise helpers intact); a failed call resolves to no record.\n    options.meter.recordAsync(returned.then((resp) => completionRecord(resp, params, options)));\n    return returned;\n  };\n}\n\nfunction completionRecord(\n  resp: unknown,\n  params: Record<string, unknown>,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): UsageRecord | null {\n  if (typeof resp !== \"object\" || resp === null) return null;\n  const r = resp as { usage?: unknown; model?: unknown };\n  return buildTokenRecord(options, params, r.usage, r.model);\n}\n\n/**\n * Proxy a thenable so awaiting it yields `map(resolvedValue)`, while every other\n * property/method (an APIPromise's `.withResponse()`/`.asResponse()`, …) passes\n * straight through. Lets us tap the resolved value without dropping the return\n * contract.\n */\nfunction proxyResolved(\n  source: Promise<unknown>,\n  map: (value: unknown) => unknown,\n): Promise<unknown> {\n  const mappedThen = (onF?: (v: unknown) => unknown, onR?: (e: unknown) => unknown) =>\n    source.then((v) => (onF ? onF(map(v)) : map(v)), onR);\n  return new Proxy(source, {\n    get(target, prop) {\n      // Route `then`/`catch`/`finally` through the mapping so awaiting via ANY of\n      // them yields the tapped value — binding the native methods to `target` would\n      // resolve the raw (un-tapped) stream and silently skip metering.\n      if (prop === \"then\") return mappedThen;\n      if (prop === \"catch\") return (onR: (e: unknown) => unknown) => mappedThen(undefined, onR);\n      if (prop === \"finally\") {\n        return (cb?: () => void) =>\n          mappedThen(\n            (v) => {\n              cb?.();\n              return v;\n            },\n            (e) => {\n              cb?.();\n              throw e;\n            },\n          );\n      }\n      const value = Reflect.get(target, prop);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  }) as Promise<unknown>;\n}\n\n/**\n * Proxy an async-iterable object so `for await` runs `makeIterator()` (our tap),\n * while every other property/method (a Stream's `.tee()`, `.toReadableStream()`, …)\n * passes straight through. Taps iteration WITHOUT replacing the object.\n */\nfunction proxyAsyncIterable(source: object, makeIterator: () => AsyncIterator<unknown>): object {\n  return new Proxy(source, {\n    get(target, prop) {\n      if (prop === Symbol.asyncIterator) return makeIterator;\n      const value = Reflect.get(target, prop);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  });\n}\n\n/** Usage + model folded out of a streamed response, ready for {@link buildTokenRecord}. */\ninterface StreamUsage {\n  usage?: unknown;\n  model?: unknown;\n}\n\n/**\n * Meter a streamed response: tap the stream (yielding every chunk untouched), fold\n * each chunk into an accumulator via `reduce`, and record ONE usage event when\n * iteration finishes. This is the reusable middle between the generic\n * {@link tapAsyncIterable} and a specific provider's chunk shape — a new streaming\n * source (Anthropic SSE, etc.) plugs in by supplying only its `reduce`.\n */\nfunction meterStream<C, P>(\n  stream: AsyncIterable<C>,\n  params: P,\n  options: MeterLLMOptions<P>,\n  reduce: (chunk: C, acc: StreamUsage) => void,\n): AsyncGenerator<C> {\n  const acc: StreamUsage = {};\n  return tapAsyncIterable(stream, {\n    onValue: (chunk) => reduce(chunk, acc),\n    onDone: () => {\n      const record = buildTokenRecord(options, params, acc.usage, acc.model);\n      if (record) options.meter.record(record);\n    },\n  });\n}\n\nfunction tapOpenAIStream(\n  stream: AsyncIterable<unknown>,\n  params: Record<string, unknown>,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): AsyncGenerator<unknown> {\n  return meterStream(stream, params, options, (chunk, acc) => {\n    if (typeof chunk !== \"object\" || chunk === null) return;\n    const c = chunk as { usage?: unknown; model?: unknown };\n    if (c.usage) acc.usage = c.usage; // the final chunk carries usage (include_usage)\n    if (c.model && acc.model === undefined) acc.model = c.model;\n  });\n}\n\n/**\n * Wrap an OpenAI-compatible client so every `chat.completions.create` call\n * auto-meters its token usage. Returns a proxy of the SAME type — use it exactly as\n * before; every other property/method passes straight through untouched.\n *\n * Reads the token count from the provider's own response (no re-tokenizing), for\n * both blocking and streaming calls. For a STREAMED call, pass\n * `stream_options: { include_usage: true }` so the final chunk carries usage —\n * otherwise a streamed call can't be metered (billow never mutates your request).\n *\n * A streamed response is metered when consumed the standard way: `await` the call,\n * then `for await` the stream. The `Stream` helpers (`.tee()`, `.toReadableStream()`)\n * and the un-awaited `APIPromise` helpers (`.withResponse()`, `.asResponse()`) are\n * PRESERVED (they keep working), but consuming through them bypasses the iteration\n * tap, so those calls are not token-metered.\n *\n * Works with any client exposing `chat.completions.create` returning a `.usage`\n * shape: OpenAI, Azure OpenAI, Together, Groq, OpenRouter, and other compatibles.\n *\n *   const openai = meterOpenAI(new OpenAI(), { meter, feature: \"tokens\", customer });\n *   const res = await openai.chat.completions.create({ model, messages }); // metered\n */\nexport function meterOpenAI<T extends object>(\n  client: T,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): T {\n  const root = client as { chat?: { completions?: { create?: unknown } } };\n  const completions = root.chat?.completions;\n  const create = completions?.create;\n  if (typeof create !== \"function\" || !completions) {\n    throw new TypeError(\"meterOpenAI: expected client.chat.completions.create to be a function\");\n  }\n  const wrapped = wrapOpenAICreate(create as (...args: unknown[]) => unknown, completions, options);\n  return replaceCreate(client, wrapped);\n}\n\n/**\n * Return a non-mutating proxy of `client` that swaps ONLY `chat.completions.create`\n * for `wrapped`, passing every other access straight through. Untouched methods keep\n * their real receiver, so `this` stays correct.\n */\nfunction replaceCreate<T extends object>(client: T, wrapped: (...args: CreateArgs) => unknown): T {\n  const root = client as { chat: { completions: object } };\n  const completionsProxy = new Proxy(root.chat.completions, {\n    get: (t, p, r) => (p === \"create\" ? wrapped : Reflect.get(t, p, r)),\n  });\n  const chatProxy = new Proxy(root.chat, {\n    get: (t, p, r) => (p === \"completions\" ? completionsProxy : Reflect.get(t, p, r)),\n  });\n  return new Proxy(client, {\n    get: (t, p, r) => (p === \"chat\" ? chatProxy : Reflect.get(t, p, r)),\n  });\n}\n\n/**\n * Meter a Vercel AI SDK result (the object `generateText`/`streamText` resolves to).\n * Reads `result.usage` — an object (`generateText`) or a Promise (`streamText`) — and\n * records the token count, non-blocking. Never touches `result.textStream`, so a\n * streamed response is delivered to your consumer untouched. Accepts AI SDK v4\n * (`promptTokens`/`completionTokens`) and v5 (`inputTokens`/`outputTokens`) shapes.\n *\n *   const result = streamText({ model, prompt });\n *   meterAIResult(result, { meter, feature: \"tokens\", customer: customerId });\n *   return result.toDataStreamResponse();\n */\nexport function meterAIResult(\n  result: { usage?: unknown; response?: unknown },\n  options: MeterLLMOptions<void>,\n): void {\n  const model = extractAIModel(result.response);\n  const usage = result.usage;\n  if (isPromiseLike(usage)) {\n    // `streamText` resolves usage LATE — hand the meter the whole resolve→record\n    // chain so `flush()` (the README's serverless guidance) awaits it instead of\n    // snapshotting an empty in-flight set and dropping the usage.\n    options.meter.recordAsync(usage.then((u) => buildTokenRecord(options, undefined, u, model)));\n    return;\n  }\n  const record = buildTokenRecord(options, undefined, usage, model);\n  if (record) options.meter.record(record);\n}\n\n/** Best-effort model id from an AI SDK result's `response` (skipped if it's a promise). */\nfunction extractAIModel(response: unknown): unknown {\n  if (typeof response !== \"object\" || response === null) return undefined;\n  const m = (response as { modelId?: unknown }).modelId;\n  return typeof m === \"string\" ? m : undefined;\n}\n"]}
+{"version":3,"sources":["../src/ingestion.ts"],"names":[],"mappings":"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","file":"ingestion.cjs","sourcesContent":["/**\n * Auto-metering (PRD-16): ingestion strategies that call billow's `track()` for you,\n * so you never hand-instrument usage.\n *\n * Two layers:\n *   1. A generic primitive - {@link createUsageMeter} + {@link meterFunction} - a\n *      non-blocking, buffered, idempotent dispatcher you can point at ANY usage\n *      source (an S3 upload, a job run, a DB write).\n *   2. LLM strategies built on it - {@link meterOpenAI} (OpenAI-compatible clients)\n *      and {@link meterAIResult} (Vercel AI SDK) that auto-count prompt+completion\n *      tokens from the provider's own response (never re-tokenizing).\n *\n * Posture (every strategy): SERVER-SIDE ONLY - a browser can't be trusted to\n * self-report usage - and NON-BLOCKING: metering is a side effect that can never\n * delay or break the wrapped call. A failed `track()` buffers and retries under an\n * idempotency key; if it ultimately fails it is dropped (via `onError`), never thrown.\n *\n *   import { Billow } from \"@usebillow/sdk\";\n *   import { createUsageMeter, meterOpenAI } from \"@usebillow/sdk/ingestion\";\n *\n *   const billow = new Billow(process.env.BILLOW_SECRET_KEY!);\n *   const meter = createUsageMeter(billow);\n *   const openai = meterOpenAI(new OpenAI(), {\n *     meter,\n *     feature: \"tokens\",\n *     customer: (params) => String(params.user), // your billow customer id\n *   });\n *   // use `openai` exactly as before - every completion auto-meters its tokens.\n */\n\nimport type { Billow } from \"./index\";\n\n/** One usage event handed to `track()`. Mirrors {@link Billow.track}'s input. */\nexport interface UsageRecord {\n  customerId: string;\n  featureId: string;\n  /** Units to record (the engine defaults to 1). */\n  value?: number;\n  /** Event properties for meter filters / property-based aggregations. */\n  properties?: Record<string, string | number>;\n  /**\n   * Dedup key. Auto-generated per record when omitted, so a retried dispatch is a\n   * no-op - set it yourself to dedupe across process restarts.\n   */\n  idempotencyKey?: string;\n}\n\n/** The minimal client the meter needs - the real {@link Billow} satisfies it. */\nexport type TrackClient = Pick<Billow, \"track\">;\n\nexport interface MeterOptions {\n  /** Max dispatch attempts for one record before it's dropped (default 5). */\n  maxAttempts?: number;\n  /** Base retry backoff in ms; doubles each attempt (default 250). */\n  retryBaseMs?: number;\n  /** Called once when a record is permanently dropped after exhausting retries. */\n  onError?: (error: unknown, record: UsageRecord) => void;\n}\n\n/**\n * A buffered, non-blocking dispatcher to `track()`. `record()` returns immediately\n * and never throws; delivery (with retries under an idempotency key) happens in the\n * background. Call {@link UsageMeter.flush} before a serverless handler returns so\n * pending records aren't lost when the process freezes.\n */\nexport interface UsageMeter {\n  /** Enqueue a usage event. Returns immediately, never throws. */\n  record(record: UsageRecord): void;\n  /**\n   * Enqueue a usage event whose record resolves LATER (e.g. a streamed response\n   * whose token totals arrive as a promise). Registers the pending work immediately\n   * so {@link UsageMeter.flush} awaits it - a `null` resolution or a rejected source\n   * is dropped. Returns immediately, never throws.\n   */\n  recordAsync(source: Promise<UsageRecord | null>): void;\n  /** Resolve once every buffered dispatch has settled (delivered or dropped). */\n  flush(): Promise<void>;\n  /** Records still in flight (queued or retrying). */\n  readonly pending: number;\n}\n\nconst DEFAULT_MAX_ATTEMPTS = 5;\nconst DEFAULT_RETRY_BASE_MS = 250;\n\nfunction newIdempotencyKey(): string {\n  return crypto.randomUUID();\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Build a {@link UsageMeter} bound to a billow client (or any `{ track }`). */\nexport function createUsageMeter(client: TrackClient, options: MeterOptions = {}): UsageMeter {\n  const maxAttempts = Math.max(1, options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS);\n  const retryBaseMs = Math.max(0, options.retryBaseMs ?? DEFAULT_RETRY_BASE_MS);\n  const inFlight = new Set<Promise<void>>();\n\n  async function dispatch(record: UsageRecord): Promise<void> {\n    // Freeze one idempotency key for the record so every retry is the SAME call.\n    const input: UsageRecord = {\n      ...record,\n      idempotencyKey: record.idempotencyKey ?? newIdempotencyKey(),\n    };\n    let lastError: unknown;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        await client.track(input);\n        return;\n      } catch (error) {\n        lastError = error;\n        if (attempt < maxAttempts) await sleep(retryBaseMs * 2 ** (attempt - 1));\n      }\n    }\n    try {\n      options.onError?.(lastError, input);\n    } catch {\n      // A throwing onError must not reject the tracked dispatch (which would make\n      // flush() reject) - the meter's contract is that it never throws.\n    }\n  }\n\n  /** Register a unit of metering work so `flush()`/`pending` account for it. */\n  function track(work: Promise<void>): void {\n    const p = work.finally(() => {\n      inFlight.delete(p);\n    });\n    inFlight.add(p);\n  }\n\n  return {\n    record(record) {\n      track(dispatch(record));\n    },\n    recordAsync(source) {\n      // Chain resolve-then-dispatch into ONE tracked unit so flush() covers work\n      // whose record isn't known yet. A null record or a rejected source is dropped.\n      track(\n        source.then(\n          (record) => (record ? dispatch(record) : undefined),\n          () => undefined,\n        ),\n      );\n    },\n    flush() {\n      return Promise.all([...inFlight]).then(() => undefined);\n    },\n    get pending() {\n      return inFlight.size;\n    },\n  };\n}\n\n/**\n * Derive a usage record from a completed call. Return `null` to skip metering it\n * (e.g. a cache hit with no billable usage). Receives the resolved result and the\n * original call arguments.\n */\nexport type UsageExtractor<A extends unknown[], R> = (result: R, args: A) => UsageRecord | null;\n\n/**\n * Wrap any async function so each successful call auto-records usage via `meter` -\n * the generic ingestion primitive. Point it at any source by supplying an `extract`.\n * Metering runs AFTER the call resolves and never blocks it; an extractor that\n * throws is swallowed. If the wrapped call itself rejects, nothing is recorded and\n * the error propagates unchanged.\n */\nexport function meterFunction<A extends unknown[], R>(\n  fn: (...args: A) => Promise<R>,\n  meter: UsageMeter,\n  extract: UsageExtractor<A, R>,\n): (...args: A) => Promise<R> {\n  return async (...args: A) => {\n    const result = await fn(...args);\n    try {\n      const record = extract(result, args);\n      if (record) meter.record(record);\n    } catch {\n      // Metering must never break the wrapped call - drop extractor errors.\n    }\n    return result;\n  };\n}\n\n/**\n * Yield every value of `source` straight through to the consumer while calling\n * `onValue` for each and `onDone` when iteration finishes (including an early\n * `break`/`return` - it runs in a `finally`). Taps a stream WITHOUT consuming it:\n * the caller still receives every chunk. Tap callbacks that throw are swallowed so\n * they can't break the stream.\n */\nexport async function* tapAsyncIterable<T>(\n  source: AsyncIterable<T>,\n  taps: { onValue?: (value: T) => void; onDone?: () => void },\n): AsyncGenerator<T> {\n  try {\n    for await (const value of source) {\n      try {\n        taps.onValue?.(value);\n      } catch {\n        // never let a tap break the passthrough\n      }\n      yield value;\n    }\n  } finally {\n    try {\n      taps.onDone?.();\n    } catch {\n      // never let a tap break the passthrough\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// LLM token metering\n// ---------------------------------------------------------------------------\n\n/** Normalized token counts, whatever the provider's field naming. */\nexport interface TokenCounts {\n  promptTokens: number;\n  completionTokens: number;\n  totalTokens: number;\n}\n\n/** Which token count a meter records as its `value` (default `\"total\"`). */\nexport type TokenCount = \"total\" | \"prompt\" | \"completion\";\n\nfunction firstNumber(...values: unknown[]): number | null {\n  for (const v of values) if (typeof v === \"number\" && Number.isFinite(v)) return v;\n  return null;\n}\n\n/**\n * Read token counts from a provider usage object, accepting OpenAI (`prompt_tokens`\n * / `completion_tokens` / `total_tokens`), Vercel AI SDK v4 (`promptTokens` / …) and\n * v5 (`inputTokens` / `outputTokens`) shapes. Returns `null` when no token fields\n * are present. `totalTokens` is derived from prompt+completion when not supplied.\n */\nexport function normalizeTokenUsage(usage: unknown): TokenCounts | null {\n  if (typeof usage !== \"object\" || usage === null) return null;\n  const u = usage as {\n    prompt_tokens?: unknown;\n    promptTokens?: unknown;\n    inputTokens?: unknown;\n    completion_tokens?: unknown;\n    completionTokens?: unknown;\n    outputTokens?: unknown;\n    total_tokens?: unknown;\n    totalTokens?: unknown;\n  };\n  const prompt = firstNumber(u.prompt_tokens, u.promptTokens, u.inputTokens);\n  const completion = firstNumber(u.completion_tokens, u.completionTokens, u.outputTokens);\n  const total = firstNumber(u.total_tokens, u.totalTokens);\n  if (prompt === null && completion === null && total === null) return null;\n  const promptTokens = prompt ?? 0;\n  const completionTokens = completion ?? 0;\n  return {\n    promptTokens,\n    completionTokens,\n    totalTokens: total ?? promptTokens + completionTokens,\n  };\n}\n\nfunction pickCount(counts: TokenCounts, which: TokenCount): number {\n  if (which === \"prompt\") return counts.promptTokens;\n  if (which === \"completion\") return counts.completionTokens;\n  return counts.totalTokens;\n}\n\n/** A value supplied directly, or resolved from a call's params. */\ntype Resolvable<T, P> = T | ((params: P) => T);\n\nfunction resolveValue<T, P>(r: Resolvable<T, P>, params: P): T {\n  return typeof r === \"function\" ? (r as (p: P) => T)(params) : r;\n}\n\nexport interface MeterLLMOptions<P = unknown> {\n  /** The buffered meter that dispatches to `track()`. */\n  meter: UsageMeter;\n  /** The metered feature (token meter) id - static, or resolved per call. */\n  feature: Resolvable<string, P>;\n  /**\n   * The billow customer to bill. Static for single-tenant, or resolved per call\n   * (e.g. from the OpenAI `user` param) for multi-tenant. Returning `null`/`undefined`\n   * skips metering that call - there's no customer to attribute it to.\n   */\n  customer: Resolvable<string | null | undefined, P>;\n  /** Which token count to record as the meter value (default `\"total\"`). */\n  count?: TokenCount;\n  /** Extra event properties merged onto each record (`model` is added automatically). */\n  properties?: (params: P, tokens: TokenCounts) => Record<string, string | number>;\n}\n\n/**\n * Build the usage record for one LLM call from its usage + model, or `null` to skip.\n * TOTAL by contract - a throwing `customer`/`feature`/`properties` resolver (e.g. an\n * unexpected params shape) drops the record rather than surfacing in the wrapped\n * call, so every caller (sync or async) inherits the non-blocking guarantee here.\n */\nfunction buildTokenRecord<P>(\n  options: MeterLLMOptions<P>,\n  params: P,\n  usage: unknown,\n  model: unknown,\n): UsageRecord | null {\n  const counts = normalizeTokenUsage(usage);\n  if (!counts) return null;\n  try {\n    const customerId = resolveValue(options.customer, params);\n    if (!customerId) return null;\n    const properties: Record<string, string | number> = {\n      tokens_prompt: counts.promptTokens,\n      tokens_completion: counts.completionTokens,\n      tokens_total: counts.totalTokens,\n      ...(typeof model === \"string\" ? { model } : {}),\n      ...options.properties?.(params, counts),\n    };\n    return {\n      customerId,\n      featureId: resolveValue(options.feature, params),\n      value: pickCount(counts, options.count ?? \"total\"),\n      properties,\n    };\n  } catch {\n    return null; // a resolver mistake must never break the wrapped call\n  }\n}\n\nfunction isPromiseLike(v: unknown): v is Promise<unknown> {\n  return (\n    (typeof v === \"object\" || typeof v === \"function\") &&\n    v !== null &&\n    typeof (v as { then?: unknown }).then === \"function\"\n  );\n}\n\n/** The two params slots an OpenAI-style `create(body, requestOptions?)` takes. */\ntype CreateArgs = [params: Record<string, unknown>, ...rest: unknown[]];\n\nfunction wrapOpenAICreate(\n  create: (...args: unknown[]) => unknown,\n  thisArg: unknown,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): (...args: CreateArgs) => unknown {\n  return (params, ...rest) => {\n    const returned = Reflect.apply(create, thisArg, [params, ...rest]);\n    // openai-node returns a thenable (APIPromise) for BOTH streaming and not.\n    if (!isPromiseLike(returned)) return returned;\n\n    if ((params as { stream?: unknown }).stream === true) {\n      // Streaming: TAP iteration to read the usage the final chunk carries (present\n      // when the caller sets `stream_options.include_usage`) WITHOUT dropping the\n      // OpenAI return contract - the APIPromise keeps its helpers and the resolved\n      // Stream keeps its methods; we only override `Symbol.asyncIterator`.\n      return proxyResolved(returned, (stream) =>\n        typeof stream === \"object\" && stream !== null\n          ? proxyAsyncIterable(stream, () =>\n              tapOpenAIStream(stream as AsyncIterable<unknown>, params, options),\n            )\n          : stream,\n      );\n    }\n    // Non-streaming: record from the resolved completion's `.usage`, tracked by the\n    // meter so `flush()` awaits it. The caller receives the ORIGINAL promise\n    // untouched (APIPromise helpers intact); a failed call resolves to no record.\n    options.meter.recordAsync(returned.then((resp) => completionRecord(resp, params, options)));\n    return returned;\n  };\n}\n\nfunction completionRecord(\n  resp: unknown,\n  params: Record<string, unknown>,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): UsageRecord | null {\n  if (typeof resp !== \"object\" || resp === null) return null;\n  const r = resp as { usage?: unknown; model?: unknown };\n  return buildTokenRecord(options, params, r.usage, r.model);\n}\n\n/**\n * Proxy a thenable so awaiting it yields `map(resolvedValue)`, while every other\n * property/method (an APIPromise's `.withResponse()`/`.asResponse()`, …) passes\n * straight through. Lets us tap the resolved value without dropping the return\n * contract.\n */\nfunction proxyResolved(\n  source: Promise<unknown>,\n  map: (value: unknown) => unknown,\n): Promise<unknown> {\n  const mappedThen = (onF?: (v: unknown) => unknown, onR?: (e: unknown) => unknown) =>\n    source.then((v) => (onF ? onF(map(v)) : map(v)), onR);\n  return new Proxy(source, {\n    get(target, prop) {\n      // Route `then`/`catch`/`finally` through the mapping so awaiting via ANY of\n      // them yields the tapped value - binding the native methods to `target` would\n      // resolve the raw (un-tapped) stream and silently skip metering.\n      if (prop === \"then\") return mappedThen;\n      if (prop === \"catch\") return (onR: (e: unknown) => unknown) => mappedThen(undefined, onR);\n      if (prop === \"finally\") {\n        return (cb?: () => void) =>\n          mappedThen(\n            (v) => {\n              cb?.();\n              return v;\n            },\n            (e) => {\n              cb?.();\n              throw e;\n            },\n          );\n      }\n      const value = Reflect.get(target, prop);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  }) as Promise<unknown>;\n}\n\n/**\n * Proxy an async-iterable object so `for await` runs `makeIterator()` (our tap),\n * while every other property/method (a Stream's `.tee()`, `.toReadableStream()`, …)\n * passes straight through. Taps iteration WITHOUT replacing the object.\n */\nfunction proxyAsyncIterable(source: object, makeIterator: () => AsyncIterator<unknown>): object {\n  return new Proxy(source, {\n    get(target, prop) {\n      if (prop === Symbol.asyncIterator) return makeIterator;\n      const value = Reflect.get(target, prop);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n  });\n}\n\n/** Usage + model folded out of a streamed response, ready for {@link buildTokenRecord}. */\ninterface StreamUsage {\n  usage?: unknown;\n  model?: unknown;\n}\n\n/**\n * Meter a streamed response: tap the stream (yielding every chunk untouched), fold\n * each chunk into an accumulator via `reduce`, and record ONE usage event when\n * iteration finishes. This is the reusable middle between the generic\n * {@link tapAsyncIterable} and a specific provider's chunk shape - a new streaming\n * source (Anthropic SSE, etc.) plugs in by supplying only its `reduce`.\n */\nfunction meterStream<C, P>(\n  stream: AsyncIterable<C>,\n  params: P,\n  options: MeterLLMOptions<P>,\n  reduce: (chunk: C, acc: StreamUsage) => void,\n): AsyncGenerator<C> {\n  const acc: StreamUsage = {};\n  return tapAsyncIterable(stream, {\n    onValue: (chunk) => reduce(chunk, acc),\n    onDone: () => {\n      const record = buildTokenRecord(options, params, acc.usage, acc.model);\n      if (record) options.meter.record(record);\n    },\n  });\n}\n\nfunction tapOpenAIStream(\n  stream: AsyncIterable<unknown>,\n  params: Record<string, unknown>,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): AsyncGenerator<unknown> {\n  return meterStream(stream, params, options, (chunk, acc) => {\n    if (typeof chunk !== \"object\" || chunk === null) return;\n    const c = chunk as { usage?: unknown; model?: unknown };\n    if (c.usage) acc.usage = c.usage; // the final chunk carries usage (include_usage)\n    if (c.model && acc.model === undefined) acc.model = c.model;\n  });\n}\n\n/**\n * Wrap an OpenAI-compatible client so every `chat.completions.create` call\n * auto-meters its token usage. Returns a proxy of the SAME type - use it exactly as\n * before; every other property/method passes straight through untouched.\n *\n * Reads the token count from the provider's own response (no re-tokenizing), for\n * both blocking and streaming calls. For a STREAMED call, pass\n * `stream_options: { include_usage: true }` so the final chunk carries usage -\n * otherwise a streamed call can't be metered (billow never mutates your request).\n *\n * A streamed response is metered when consumed the standard way: `await` the call,\n * then `for await` the stream. The `Stream` helpers (`.tee()`, `.toReadableStream()`)\n * and the un-awaited `APIPromise` helpers (`.withResponse()`, `.asResponse()`) are\n * PRESERVED (they keep working), but consuming through them bypasses the iteration\n * tap, so those calls are not token-metered.\n *\n * Works with any client exposing `chat.completions.create` returning a `.usage`\n * shape: OpenAI, Azure OpenAI, Together, Groq, OpenRouter, and other compatibles.\n *\n *   const openai = meterOpenAI(new OpenAI(), { meter, feature: \"tokens\", customer });\n *   const res = await openai.chat.completions.create({ model, messages }); // metered\n */\nexport function meterOpenAI<T extends object>(\n  client: T,\n  options: MeterLLMOptions<Record<string, unknown>>,\n): T {\n  const root = client as { chat?: { completions?: { create?: unknown } } };\n  const completions = root.chat?.completions;\n  const create = completions?.create;\n  if (typeof create !== \"function\" || !completions) {\n    throw new TypeError(\"meterOpenAI: expected client.chat.completions.create to be a function\");\n  }\n  const wrapped = wrapOpenAICreate(create as (...args: unknown[]) => unknown, completions, options);\n  return replaceCreate(client, wrapped);\n}\n\n/**\n * Return a non-mutating proxy of `client` that swaps ONLY `chat.completions.create`\n * for `wrapped`, passing every other access straight through. Untouched methods keep\n * their real receiver, so `this` stays correct.\n */\nfunction replaceCreate<T extends object>(client: T, wrapped: (...args: CreateArgs) => unknown): T {\n  const root = client as { chat: { completions: object } };\n  const completionsProxy = new Proxy(root.chat.completions, {\n    get: (t, p, r) => (p === \"create\" ? wrapped : Reflect.get(t, p, r)),\n  });\n  const chatProxy = new Proxy(root.chat, {\n    get: (t, p, r) => (p === \"completions\" ? completionsProxy : Reflect.get(t, p, r)),\n  });\n  return new Proxy(client, {\n    get: (t, p, r) => (p === \"chat\" ? chatProxy : Reflect.get(t, p, r)),\n  });\n}\n\n/**\n * Meter a Vercel AI SDK result (the object `generateText`/`streamText` resolves to).\n * Reads `result.usage` - an object (`generateText`) or a Promise (`streamText`) - and\n * records the token count, non-blocking. Never touches `result.textStream`, so a\n * streamed response is delivered to your consumer untouched. Accepts AI SDK v4\n * (`promptTokens`/`completionTokens`) and v5 (`inputTokens`/`outputTokens`) shapes.\n *\n *   const result = streamText({ model, prompt });\n *   meterAIResult(result, { meter, feature: \"tokens\", customer: customerId });\n *   return result.toDataStreamResponse();\n */\nexport function meterAIResult(\n  result: { usage?: unknown; response?: unknown },\n  options: MeterLLMOptions<void>,\n): void {\n  const model = extractAIModel(result.response);\n  const usage = result.usage;\n  if (isPromiseLike(usage)) {\n    // `streamText` resolves usage LATE - hand the meter the whole resolve→record\n    // chain so `flush()` (the README's serverless guidance) awaits it instead of\n    // snapshotting an empty in-flight set and dropping the usage.\n    options.meter.recordAsync(usage.then((u) => buildTokenRecord(options, undefined, u, model)));\n    return;\n  }\n  const record = buildTokenRecord(options, undefined, usage, model);\n  if (record) options.meter.record(record);\n}\n\n/** Best-effort model id from an AI SDK result's `response` (skipped if it's a promise). */\nfunction extractAIModel(response: unknown): unknown {\n  if (typeof response !== \"object\" || response === null) return undefined;\n  const m = (response as { modelId?: unknown }).modelId;\n  return typeof m === \"string\" ? m : undefined;\n}\n"]}