@usebillow/sdk 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -1,18 +1,18 @@
 import { f as SavedPaymentMethod, g as CreateHostedDomainInput, h as PayInvoiceInput } from './index.d-DSEYhV2c.cjs';
 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.cjs';
-import { C as ChargeStatus, P as PaymentMethodStatus, I as InvoiceStatus, R as RefundStatus, W as WebhookDeliveryStatus } from './billing-status-BZQN_gm7.cjs';
-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.cjs';
+import { C as ChargeStatus, P as PaymentMethodStatus, I as InvoiceStatus, R as RefundStatus, W as WebhookDeliveryStatus } from './billing-status-DZkB0VPK.cjs';
+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.cjs';
 import { SubscriptionStatus } from './status.cjs';
 export { ACTIVE_SUBSCRIPTION_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, grantsAccess, isTerminal } from './status.cjs';
-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-B16zL5xU.cjs';
-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-B16zL5xU.cjs';
-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-DwakPG4J.cjs';
-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-DwakPG4J.cjs';
+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-8ug1Gw05.cjs';
+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-8ug1Gw05.cjs';
+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-zWm2srOk.cjs';
+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-zWm2srOk.cjs';
 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 };