@usebillow/sdk 0.7.0 → 0.9.0

package/dist/config.d.cts

@@ -1,10 +1,10 @@
 import { Billow } from './index.cjs';
-import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-B-VyZCXV.cjs';
-import './index.d-CKQAhQfJ.cjs';
+import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-B16zL5xU.cjs';
+import './index.d-DSEYhV2c.cjs';
 import 'zod';
 import './billing-status-BZQN_gm7.cjs';
 import './status.cjs';
-import './hosted-domains-BYYl2DSa.cjs';
+import './hosted-domains-DwakPG4J.cjs';
 
 /**
  * Code-as-config sync (ARCHITECTURE §12 "code-as-config sync"). Keep your catalog

package/dist/config.d.ts

@@ -1,10 +1,10 @@
 import { Billow } from './index.js';
-import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-CgjcWmvb.js';
-import './index.d-CKQAhQfJ.js';
+import { F as FeatureKind, M as MeterConfig, C as CreateProductInput, a as CreateCouponInput } from './billing-BF4OGaLI.js';
+import './index.d-DSEYhV2c.js';
 import 'zod';
 import './billing-status-BZQN_gm7.js';
 import './status.js';
-import './hosted-domains-z_I0edmM.js';
+import './hosted-domains-DSTQ1GZz.js';
 
 /**
  * Code-as-config sync (ARCHITECTURE §12 "code-as-config sync"). Keep your catalog

package/dist/{hosted-domains-z_I0edmM.d.ts → hosted-domains-DSTQ1GZz.d.ts}

@@ -1,4 +1,4 @@
-import { H as HostedDomainResponse } from './index.d-CKQAhQfJ.js';
+import { H as HostedDomainResponse } from './index.d-DSEYhV2c.js';
 
 /**
  * Public SDK types for prepaid credits. Re-exported by ../types.ts.
@@ -67,9 +67,33 @@ interface CreateCreditGrantInput {
 }
 /** A Credit Account's status: `frozen` takes no new reservations; `closed` (erased) takes nothing. */
 type CreditAccountStatus = "active" | "frozen" | "closed";
+/** What current Included Credit Windows include, and where it stands. */
+interface IncludedCredits {
+    /** What the windows include. */
+    granted: string;
+    /** Consumed from their credits, net of reversals. */
+    used: string;
+    held: string;
+    /** Unheld and spendable, credits recorded but not issued yet included. */
+    remaining: string;
+}
+/** One subscription's current Included Credit Window, in a customer's balance. */
+interface IncludedPeriod extends IncludedCredits {
+    subscriptionId: string;
+    /** The window (ISO 8601), half-open: its credits expire at `end`. */
+    start: string;
+    end: string;
+    /** The billing period it belongs to (a trial's is the trial). */
+    periodStart: string;
+    periodEnd: string;
+    /** The next window's start within the paid period (a monthly refill), or null. */
+    nextRefillAt: string | null;
+}
 /**
  * A customer's credit balance, true at `asOf`. A balance never grants spending authority - only a
- * reservation does. A customer with no credit account yet reads as zeros, `active`, `exhausted`.
+ * reservation does. A customer with no credit account yet reads as their subscriptions' recorded
+ * included credits alone (zeros without any), `active`, `exhausted` when nothing is spendable.
+ * Included credits count from the instant their window is current, before Billow issues them.
  */
 interface CreditBalance {
     /** The customer's external id. */
@@ -79,7 +103,10 @@ interface CreditBalance {
     spendable: string;
     /** Credits held by open reservations. */
     held: string;
-    /** Credits consumed since `periodStart`, net of reversals. */
+    /**
+     * Credits consumed since `periodStart`, net of their reversals: a reversal counts against the
+     * period of the consumption it reverses, so this is never negative.
+     */
     consumedThisPeriod: string;
     /** The current included period's start, else the first instant of the current UTC month. */
     periodStart: string;
@@ -99,22 +126,23 @@ interface CreditBalance {
         /** Spendable on a category not listed: the grants that pay for every category. */
         otherCategories: string;
     };
-    /** The active included grants (a subscription's period allowance); null when there are none. */
-    currentPeriod: {
-        granted: string;
-        /** Consumed from them, net of reversals. */
-        used: string;
-        held: string;
-        /** Unheld and spendable. */
-        remaining: string;
+    /**
+     * The current Included Credit Windows together - the billing period, or the current month under
+     * a monthly allocation - across the customer's subscriptions; null when none is current (between
+     * a period's end and the payment that grants the next).
+     */
+    currentPeriod: (IncludedCredits & {
+        /** The earliest current window's start. */
         start: string;
-        /** When they expire (the period end); null if one never does. */
-        end: string | null;
-    } | null;
+        /** The earliest current window's end: when the first of these credits stop. */
+        end: string;
+    }) | null;
+    /** Each subscription's current window, soonest end first (empty when none is current). */
+    includedPeriods: IncludedPeriod[];
     thresholds: {
         lowPercent: number;
         criticalPercent: number;
-        /** What the percentages apply to: the current period's credits, else the last top-up's. */
+        /** What the percentages apply to: the current windows' credits, else the last top-up's. */
         reference: string | null;
         level: CreditThresholdLevel;
     };
@@ -144,6 +172,8 @@ interface CreditLedgerEntry {
     callerReason: string | null;
     /** The metadata of the resource it belongs to: its reservation, reversal or top-up, else its grant. */
     metadata: Record<string, string> | null;
+    /** On an included grant's transaction: the subscription whose window issued the grant. */
+    subscriptionId: string | null;
     createdAt: string;
 }
 /** What `credits.usage.get` totals each row by. */
@@ -274,6 +304,121 @@ interface CreditPacks {
     currency: string;
     data: CreditPackListItem[];
 }
+/**
+ * How an Included Credit Rule allocates its credits: `billing_period` - the whole period is one
+ * window; `month` - each month of the period is its own window, refilled at its start and expiring
+ * at its end, with no rollover (only on a Price billed for longer than a month).
+ */
+type CreditAllocationInterval = "billing_period" | "month";
+/**
+ * An Included Credit Rule: the credits a subscription on a recurring base Price includes for each
+ * period Billow grants it. At most one live (not archived) rule per Price. A change takes effect
+ * from the next period granted, never on one already granted.
+ */
+interface CreditIncludedRule {
+    id: string;
+    /** The recurring base Price it applies to; never changes. */
+    priceId: string;
+    /** Microcredits each window includes: per billing period, or per month under `month`. */
+    credits: string;
+    /** Whether `credits` and `trialCredits` are multiplied by the base item's quantity (per seat). */
+    perUnit: boolean;
+    /** Microcredits a trial includes, as one window; "0" for none. */
+    trialCredits: string;
+    allocationInterval: CreditAllocationInterval;
+    /** An archived rule includes nothing for periods granted after it was archived. */
+    archived: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Configure an Included Credit Rule on a recurring base Price (`fixed_recurring` or `licensed`, of
+ * a product that is not an add-on).
+ */
+interface CreateCreditIncludedRuleInput {
+    priceId: string;
+    /** Whole microcredits each window includes, as a decimal string; positive. */
+    credits: string;
+    /**
+     * Required: `true` multiplies the credits by the base item's quantity (per-seat credits on a
+     * `licensed` Price); `false` includes them once per subscription whatever the quantity.
+     */
+    perUnit: boolean;
+    /** Whole microcredits a trial includes, as a decimal string; omit for none. */
+    trialCredits?: string;
+    /** `billing_period` when omitted; `month` only on a Price billed for longer than a month. */
+    allocationInterval?: CreditAllocationInterval;
+}
+/**
+ * Edit an Included Credit Rule: any of its terms, or `archived` (`false` brings it back while its
+ * Price has no other live rule). Its Price never changes.
+ */
+type UpdateCreditIncludedRuleInput = Partial<Omit<CreateCreditIncludedRuleInput, "priceId">> & {
+    archived?: boolean;
+};
+/**
+ * Where an Included Credit Window stands: `scheduled` (a later window, not started), `pending`
+ * (current, waiting to be issued - Billow issues it within seconds), `blocked` (current, but its
+ * last issue attempt could not go through - see `blockedCause` - and Billow retries it with
+ * backoff), `issued`, `suspended` (held by a pause), `lapsed` (over without being issued: a period
+ * paid after it ended, or one that passed while paused), `ended` (ended early, with `endCause`),
+ * or `account_closed` (the customer was erased, so it never issues).
+ */
+type CreditWindowState = "scheduled" | "pending" | "blocked" | "issued" | "suspended" | "lapsed" | "ended" | "account_closed";
+/**
+ * An Included Credit Window: what one window of a period Billow granted a subscription includes -
+ * the whole billing period, one month of it under a monthly rule, or a trial - and how far its
+ * credits have been issued.
+ */
+interface CreditIncludedWindow {
+    id: string;
+    subscriptionId: string;
+    /** The customer's external id. */
+    customerId: string;
+    /** The window (ISO 8601), half-open: its credits expire at `end`. */
+    start: string;
+    end: string;
+    /** The billing period it belongs to (a trial's is the trial). */
+    periodStart: string;
+    periodEnd: string;
+    /** The next window's start within the period (a monthly refill), or null for its last window. */
+    nextRefillAt: string | null;
+    /** How the rule allocated the period when it was granted. */
+    allocation: CreditAllocationInterval;
+    /** The categories its credits may pay for; null = every category. */
+    eligibility: string[] | null;
+    /** Microcredits the window includes. */
+    entitled: string;
+    /** Microcredits issued to the customer for it so far. */
+    issued: string;
+    state: CreditWindowState;
+    /**
+     * For a `blocked` window: `capacity` (its credits would take the customer's balance past the
+     * largest total Billow holds) or `error` (an unexpected fault); null otherwise.
+     */
+    blockedCause: "capacity" | "error" | null;
+    /** For a `pending` or `blocked` window: since when it has been due. */
+    dueSince: string | null;
+    endedAt: string | null;
+    endCause: "canceled" | "charged_back" | null;
+    createdAt: string;
+}
+/**
+ * Whose Included Credit Windows to list: one or more subscriptions, or a customer (by external id)
+ * - exactly one of the two.
+ */
+type CreditIncludedWindowListParams = ({
+    subscription: string | string[];
+    customer?: never;
+} | {
+    customer: string;
+    subscription?: never;
+}) & {
+    /** Only each subscription's latest window that has started (what the subscription shows now). */
+    current?: boolean;
+    limit?: number;
+    cursor?: string;
+};
 /**
  * A top-up's state: `pending` until its payment settles; `succeeded` (credits granted) or
  * `failed` (a later payment on the same checkout still succeeds it); `unfulfilled` - paid after
@@ -375,4 +520,4 @@ interface HostedDomainDisabledData extends HostedDomainEventBase {
     reason: Extract<HostedDomainStatusReason, "dns_lost" | "reassigned" | "entitlement_lapsed" | "suspended">;
 }
 
-export type { HostedDomainStatus as A, HostedDomainStatusReason as B, CreditGrantKind as C, HostedDomainActivatedData as H, UpdateCreditPackInput as U, CreditThresholdLevel as a, HostedDomainDnsFailingData as b, HostedDomainReassignmentPendingData as c, HostedDomainDisabledData as d, CreditGrant as e, CreditTopUp as f, CreateCreditGrantInput as g, CreditGrantRequestResult as h, CreditPacks as i, CreateCreditPackInput as j, CreditPack as k, CreateCreditTopUpInput as l, CreditTopUpRequestResult as m, CreditTopUpListParams as n, CreditBalance as o, CreditLedgerEntry as p, CreditUsageParams as q, CreditUsage as r, CreditAccountStatus as s, CreditMoney as t, CreditPackBreakdown as u, CreditPackListItem as v, CreditTopUpStatus as w, CreditTransactionType as x, CreditUsageGroupBy as y, HostedDomainEventBase as z };
+export type { CreditPackBreakdown as A, CreditPackListItem as B, CreditGrantKind as C, CreditTopUpStatus as D, CreditTransactionType as E, CreditUsageGroupBy as F, CreditWindowState as G, HostedDomainActivatedData as H, HostedDomainEventBase as I, HostedDomainStatus as J, HostedDomainStatusReason as K, IncludedCredits as L, IncludedPeriod as M, UpdateCreditPackInput as U, CreditThresholdLevel as a, HostedDomainDnsFailingData as b, HostedDomainReassignmentPendingData as c, HostedDomainDisabledData as d, CreditGrant as e, CreditTopUp as f, CreditIncludedWindow as g, CreateCreditGrantInput as h, CreditGrantRequestResult as i, CreditPacks as j, CreateCreditPackInput as k, CreditPack as l, CreateCreditIncludedRuleInput as m, CreditIncludedRule as n, UpdateCreditIncludedRuleInput as o, CreditIncludedWindowListParams as p, CreateCreditTopUpInput as q, CreditTopUpRequestResult as r, CreditTopUpListParams as s, CreditBalance as t, CreditLedgerEntry as u, CreditUsageParams as v, CreditUsage as w, CreditAccountStatus as x, CreditAllocationInterval as y, CreditMoney as z };

package/dist/{hosted-domains-BYYl2DSa.d.cts → hosted-domains-DwakPG4J.d.cts}

@@ -1,4 +1,4 @@
-import { H as HostedDomainResponse } from './index.d-CKQAhQfJ.cjs';
+import { H as HostedDomainResponse } from './index.d-DSEYhV2c.cjs';
 
 /**
  * Public SDK types for prepaid credits. Re-exported by ../types.ts.
@@ -67,9 +67,33 @@ interface CreateCreditGrantInput {
 }
 /** A Credit Account's status: `frozen` takes no new reservations; `closed` (erased) takes nothing. */
 type CreditAccountStatus = "active" | "frozen" | "closed";
+/** What current Included Credit Windows include, and where it stands. */
+interface IncludedCredits {
+    /** What the windows include. */
+    granted: string;
+    /** Consumed from their credits, net of reversals. */
+    used: string;
+    held: string;
+    /** Unheld and spendable, credits recorded but not issued yet included. */
+    remaining: string;
+}
+/** One subscription's current Included Credit Window, in a customer's balance. */
+interface IncludedPeriod extends IncludedCredits {
+    subscriptionId: string;
+    /** The window (ISO 8601), half-open: its credits expire at `end`. */
+    start: string;
+    end: string;
+    /** The billing period it belongs to (a trial's is the trial). */
+    periodStart: string;
+    periodEnd: string;
+    /** The next window's start within the paid period (a monthly refill), or null. */
+    nextRefillAt: string | null;
+}
 /**
  * A customer's credit balance, true at `asOf`. A balance never grants spending authority - only a
- * reservation does. A customer with no credit account yet reads as zeros, `active`, `exhausted`.
+ * reservation does. A customer with no credit account yet reads as their subscriptions' recorded
+ * included credits alone (zeros without any), `active`, `exhausted` when nothing is spendable.
+ * Included credits count from the instant their window is current, before Billow issues them.
  */
 interface CreditBalance {
     /** The customer's external id. */
@@ -79,7 +103,10 @@ interface CreditBalance {
     spendable: string;
     /** Credits held by open reservations. */
     held: string;
-    /** Credits consumed since `periodStart`, net of reversals. */
+    /**
+     * Credits consumed since `periodStart`, net of their reversals: a reversal counts against the
+     * period of the consumption it reverses, so this is never negative.
+     */
     consumedThisPeriod: string;
     /** The current included period's start, else the first instant of the current UTC month. */
     periodStart: string;
@@ -99,22 +126,23 @@ interface CreditBalance {
         /** Spendable on a category not listed: the grants that pay for every category. */
         otherCategories: string;
     };
-    /** The active included grants (a subscription's period allowance); null when there are none. */
-    currentPeriod: {
-        granted: string;
-        /** Consumed from them, net of reversals. */
-        used: string;
-        held: string;
-        /** Unheld and spendable. */
-        remaining: string;
+    /**
+     * The current Included Credit Windows together - the billing period, or the current month under
+     * a monthly allocation - across the customer's subscriptions; null when none is current (between
+     * a period's end and the payment that grants the next).
+     */
+    currentPeriod: (IncludedCredits & {
+        /** The earliest current window's start. */
         start: string;
-        /** When they expire (the period end); null if one never does. */
-        end: string | null;
-    } | null;
+        /** The earliest current window's end: when the first of these credits stop. */
+        end: string;
+    }) | null;
+    /** Each subscription's current window, soonest end first (empty when none is current). */
+    includedPeriods: IncludedPeriod[];
     thresholds: {
         lowPercent: number;
         criticalPercent: number;
-        /** What the percentages apply to: the current period's credits, else the last top-up's. */
+        /** What the percentages apply to: the current windows' credits, else the last top-up's. */
         reference: string | null;
         level: CreditThresholdLevel;
     };
@@ -144,6 +172,8 @@ interface CreditLedgerEntry {
     callerReason: string | null;
     /** The metadata of the resource it belongs to: its reservation, reversal or top-up, else its grant. */
     metadata: Record<string, string> | null;
+    /** On an included grant's transaction: the subscription whose window issued the grant. */
+    subscriptionId: string | null;
     createdAt: string;
 }
 /** What `credits.usage.get` totals each row by. */
@@ -274,6 +304,121 @@ interface CreditPacks {
     currency: string;
     data: CreditPackListItem[];
 }
+/**
+ * How an Included Credit Rule allocates its credits: `billing_period` - the whole period is one
+ * window; `month` - each month of the period is its own window, refilled at its start and expiring
+ * at its end, with no rollover (only on a Price billed for longer than a month).
+ */
+type CreditAllocationInterval = "billing_period" | "month";
+/**
+ * An Included Credit Rule: the credits a subscription on a recurring base Price includes for each
+ * period Billow grants it. At most one live (not archived) rule per Price. A change takes effect
+ * from the next period granted, never on one already granted.
+ */
+interface CreditIncludedRule {
+    id: string;
+    /** The recurring base Price it applies to; never changes. */
+    priceId: string;
+    /** Microcredits each window includes: per billing period, or per month under `month`. */
+    credits: string;
+    /** Whether `credits` and `trialCredits` are multiplied by the base item's quantity (per seat). */
+    perUnit: boolean;
+    /** Microcredits a trial includes, as one window; "0" for none. */
+    trialCredits: string;
+    allocationInterval: CreditAllocationInterval;
+    /** An archived rule includes nothing for periods granted after it was archived. */
+    archived: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Configure an Included Credit Rule on a recurring base Price (`fixed_recurring` or `licensed`, of
+ * a product that is not an add-on).
+ */
+interface CreateCreditIncludedRuleInput {
+    priceId: string;
+    /** Whole microcredits each window includes, as a decimal string; positive. */
+    credits: string;
+    /**
+     * Required: `true` multiplies the credits by the base item's quantity (per-seat credits on a
+     * `licensed` Price); `false` includes them once per subscription whatever the quantity.
+     */
+    perUnit: boolean;
+    /** Whole microcredits a trial includes, as a decimal string; omit for none. */
+    trialCredits?: string;
+    /** `billing_period` when omitted; `month` only on a Price billed for longer than a month. */
+    allocationInterval?: CreditAllocationInterval;
+}
+/**
+ * Edit an Included Credit Rule: any of its terms, or `archived` (`false` brings it back while its
+ * Price has no other live rule). Its Price never changes.
+ */
+type UpdateCreditIncludedRuleInput = Partial<Omit<CreateCreditIncludedRuleInput, "priceId">> & {
+    archived?: boolean;
+};
+/**
+ * Where an Included Credit Window stands: `scheduled` (a later window, not started), `pending`
+ * (current, waiting to be issued - Billow issues it within seconds), `blocked` (current, but its
+ * last issue attempt could not go through - see `blockedCause` - and Billow retries it with
+ * backoff), `issued`, `suspended` (held by a pause), `lapsed` (over without being issued: a period
+ * paid after it ended, or one that passed while paused), `ended` (ended early, with `endCause`),
+ * or `account_closed` (the customer was erased, so it never issues).
+ */
+type CreditWindowState = "scheduled" | "pending" | "blocked" | "issued" | "suspended" | "lapsed" | "ended" | "account_closed";
+/**
+ * An Included Credit Window: what one window of a period Billow granted a subscription includes -
+ * the whole billing period, one month of it under a monthly rule, or a trial - and how far its
+ * credits have been issued.
+ */
+interface CreditIncludedWindow {
+    id: string;
+    subscriptionId: string;
+    /** The customer's external id. */
+    customerId: string;
+    /** The window (ISO 8601), half-open: its credits expire at `end`. */
+    start: string;
+    end: string;
+    /** The billing period it belongs to (a trial's is the trial). */
+    periodStart: string;
+    periodEnd: string;
+    /** The next window's start within the period (a monthly refill), or null for its last window. */
+    nextRefillAt: string | null;
+    /** How the rule allocated the period when it was granted. */
+    allocation: CreditAllocationInterval;
+    /** The categories its credits may pay for; null = every category. */
+    eligibility: string[] | null;
+    /** Microcredits the window includes. */
+    entitled: string;
+    /** Microcredits issued to the customer for it so far. */
+    issued: string;
+    state: CreditWindowState;
+    /**
+     * For a `blocked` window: `capacity` (its credits would take the customer's balance past the
+     * largest total Billow holds) or `error` (an unexpected fault); null otherwise.
+     */
+    blockedCause: "capacity" | "error" | null;
+    /** For a `pending` or `blocked` window: since when it has been due. */
+    dueSince: string | null;
+    endedAt: string | null;
+    endCause: "canceled" | "charged_back" | null;
+    createdAt: string;
+}
+/**
+ * Whose Included Credit Windows to list: one or more subscriptions, or a customer (by external id)
+ * - exactly one of the two.
+ */
+type CreditIncludedWindowListParams = ({
+    subscription: string | string[];
+    customer?: never;
+} | {
+    customer: string;
+    subscription?: never;
+}) & {
+    /** Only each subscription's latest window that has started (what the subscription shows now). */
+    current?: boolean;
+    limit?: number;
+    cursor?: string;
+};
 /**
  * A top-up's state: `pending` until its payment settles; `succeeded` (credits granted) or
  * `failed` (a later payment on the same checkout still succeeds it); `unfulfilled` - paid after
@@ -375,4 +520,4 @@ interface HostedDomainDisabledData extends HostedDomainEventBase {
     reason: Extract<HostedDomainStatusReason, "dns_lost" | "reassigned" | "entitlement_lapsed" | "suspended">;
 }
 
-export type { HostedDomainStatus as A, HostedDomainStatusReason as B, CreditGrantKind as C, HostedDomainActivatedData as H, UpdateCreditPackInput as U, CreditThresholdLevel as a, HostedDomainDnsFailingData as b, HostedDomainReassignmentPendingData as c, HostedDomainDisabledData as d, CreditGrant as e, CreditTopUp as f, CreateCreditGrantInput as g, CreditGrantRequestResult as h, CreditPacks as i, CreateCreditPackInput as j, CreditPack as k, CreateCreditTopUpInput as l, CreditTopUpRequestResult as m, CreditTopUpListParams as n, CreditBalance as o, CreditLedgerEntry as p, CreditUsageParams as q, CreditUsage as r, CreditAccountStatus as s, CreditMoney as t, CreditPackBreakdown as u, CreditPackListItem as v, CreditTopUpStatus as w, CreditTransactionType as x, CreditUsageGroupBy as y, HostedDomainEventBase as z };
+export type { CreditPackBreakdown as A, CreditPackListItem as B, CreditGrantKind as C, CreditTopUpStatus as D, CreditTransactionType as E, CreditUsageGroupBy as F, CreditWindowState as G, HostedDomainActivatedData as H, HostedDomainEventBase as I, HostedDomainStatus as J, HostedDomainStatusReason as K, IncludedCredits as L, IncludedPeriod as M, UpdateCreditPackInput as U, CreditThresholdLevel as a, HostedDomainDnsFailingData as b, HostedDomainReassignmentPendingData as c, HostedDomainDisabledData as d, CreditGrant as e, CreditTopUp as f, CreditIncludedWindow as g, CreateCreditGrantInput as h, CreditGrantRequestResult as i, CreditPacks as j, CreateCreditPackInput as k, CreditPack as l, CreateCreditIncludedRuleInput as m, CreditIncludedRule as n, UpdateCreditIncludedRuleInput as o, CreditIncludedWindowListParams as p, CreateCreditTopUpInput as q, CreditTopUpRequestResult as r, CreditTopUpListParams as s, CreditBalance as t, CreditLedgerEntry as u, CreditUsageParams as v, CreditUsage as w, CreditAccountStatus as x, CreditAllocationInterval as y, CreditMoney as z };

package/dist/index.cjs

@@ -528,6 +528,79 @@ function createCreditsResource(ctx) {
         options
       )
     },
+    includedRules: {
+      /**
+       * Configure an Included Credit Rule on a recurring base Price: the credits a subscription on
+       * it includes for each period Billow grants it - per billing period, or per month of a Price
+       * billed for longer than a month - and for a trial. Configuration, so no idempotency key:
+       * a second live rule for the same Price throws `conflict` (409,
+       * `details.reason: "included_rule_exists"`, with the live rule's `ruleId`). Throws
+       * `validation_error` (422) with `details.reason: "not_a_base_price"` for a Price that is not
+       * a recurring base Price, or `"allocation_not_shorter_than_billing"` for a monthly
+       * allocation on a Price not billed for longer than a month.
+       */
+      create: (input, options) => apiRequest(ctx, "POST", "/v1/credits/included-rules", input, options),
+      /** A rule, archived or not. */
+      get: (ruleId, options) => apiRequest(
+        ctx,
+        "GET",
+        `/v1/credits/included-rules/${encodeURIComponent(ruleId)}`,
+        void 0,
+        options
+      ),
+      /**
+       * Every rule, archived ones included, newest first. Auto-paginating by cursor: `await` the
+       * first page, `for await (…)` every rule, or `.listAll()` to collect them.
+       */
+      list: (params = {}, options) => makeCursorListPromise(
+        (p) => apiRequest(
+          ctx,
+          "GET",
+          `/v1/credits/included-rules${toQuery(p)}`,
+          void 0,
+          options
+        ),
+        params
+      ),
+      /**
+       * Edit a rule's credits, per-seat choice, trial credits or allocation interval, or archive
+       * it (`archived: false` brings it back). It takes effect from the next period granted;
+       * periods already granted keep what they were granted. A rule left live is judged against
+       * its Price as it is now, with the same errors as `create`.
+       */
+      update: (ruleId, input, options) => apiRequest(
+        ctx,
+        "PATCH",
+        `/v1/credits/included-rules/${encodeURIComponent(ruleId)}`,
+        input,
+        options
+      )
+    },
+    includedWindows: {
+      /**
+       * The Included Credit Windows of one or more subscriptions (`subscription`, an id or a list
+       * of up to 100), or of a customer (`customer`, by external id) - newest first: what each
+       * period Billow granted includes (the whole period, each month of it under a monthly rule,
+       * or a trial), how far it was issued, and its `state`. With `current: true`, only each
+       * subscription's latest window that has started - what it stands at now. Auto-paginating by
+       * cursor: `await` the first page, `for await (…)` every window, or `.listAll()` to collect
+       * them.
+       */
+      list: (params, options) => {
+        const { subscription, ...rest } = params;
+        const subscriptions = Array.isArray(subscription) ? subscription.join(",") : subscription;
+        return makeCursorListPromise(
+          (p) => apiRequest(
+            ctx,
+            "GET",
+            `/v1/credits/included-windows${toQuery({ ...p, subscription: subscriptions })}`,
+            void 0,
+            options
+          ),
+          rest
+        );
+      }
+    },
     topUps: {
       /**
        * Buy a Credit Pack for a customer: answers the top-up with `checkoutUrl`, the hosted
@@ -708,6 +781,24 @@ function createCreditsResource(ctx) {
         void 0,
         options
       ),
+      /**
+       * Your project's reservations, oldest first, optionally of one `status`, one `customer` (by
+       * external id), or protected more than `protectedLongerThan` seconds ago - with
+       * `{ status: "protected", protectedLongerThan: page.protectedHoldMaxSeconds }`, the paid
+       * operations waiting past your maximum for a decision (commit or release each). Every page
+       * carries `protectedHoldMaxSeconds`. Auto-paginating by cursor: `await` the first page,
+       * `for await (…)` every reservation, or `.listAll()` to collect them.
+       */
+      list: (params = {}, options) => makeCursorListPromise(
+        (p) => apiRequest(
+          ctx,
+          "GET",
+          `/v1/credits/reservations${toQuery(p)}`,
+          void 0,
+          options
+        ),
+        params
+      ),
       /**
        * A customer's reservation (by external id) made with `operationKey` - how to find one whose
        * reply was lost. Throws `not_found` (404) when there is none.
@@ -1257,7 +1348,18 @@ function createSubscriptionsResource(ctx) {
       "POST",
       `/v1/subscriptions/${encodeURIComponent(id)}/resume-cancellation`
     ),
+    /**
+     * Pause an active or trialing subscription: no renewals and no access until it is resumed.
+     * Refused while one of its invoices is still being collected.
+     */
     pause: (id) => apiRequest(ctx, "POST", `/v1/subscriptions/${encodeURIComponent(id)}/pause`),
+    /**
+     * Resume a paused subscription. Paused time is never billed: resumed before its paid period
+     * ends, it carries on and renews at `currentPeriodEnd`; resumed after, a fresh full period
+     * starts now and is charged at once like a renewal, with the ended period's usage (a decline
+     * returns it `past_due`). Usage recorded while paused is never billed. A paused trial resumes
+     * `trialing`. Duplicate calls are safe.
+     */
     resume: (id) => apiRequest(ctx, "POST", `/v1/subscriptions/${encodeURIComponent(id)}/resume`),
     /** Apply a coupon to an existing subscription. */
     applyCoupon: (id, code) => apiRequest(