@usebillow/sdk 0.9.0 → 0.10.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 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-Ci6jeNAe.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-Ci6jeNAe.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;
@@ -2005,7 +2010,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 +2215,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 +2234,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 +2426,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 +2535,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 +2643,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 +2689,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 +2697,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 +2713,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 +2747,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 +2767,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 +2776,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 +2790,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 +2798,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 +2825,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 +2833,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 +2910,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>;