@leaflow/sdk 0.121.0 → 0.123.0

package/dist/billing/v1/generated/functions.d.ts

@@ -5,7 +5,7 @@
  * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
-import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CheckoutOrderRequest, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
+import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -593,17 +593,31 @@ export declare const getPayInvoiceUrl: (invoiceId: string) => string;
  * Applies eligible credit grants and available balance as requested, then collects the remainder
  * through the selected payment gateway and method. With no gateway selection, insufficient
  * account funds fail without starting an online payment. Card and non-card methods use this same
- * operation. Promotion codes are confirmed by checkout, before collecting payment.
+ * operation.
+ *
+ * The draft invoice of a deferred order is priced when it is first paid: Billing applies
+ * promotion_code, or the best applicable account discount when it is omitted, compares the total
+ * with expected_amount, records the discount on the order and issues the invoice before collecting.
+ * An invalid or inapplicable code fails rather than collecting full price, and a different total
+ * fails with `BILLING_AMOUNT_CHANGED`; in both cases nothing changes. The terms are fixed before
+ * any funds are collected and stay fixed when collection does not complete, for example with
+ * insufficient funds or a declined card: later attempts reuse them, and a different promotion_code
+ * is then refused with `BILLING_ORDER_CHECKOUT_CONFLICT`. A deferred period-end change can be paid
+ * once its first period is due to be invoiced; earlier attempts are refused with
+ * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
  * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
  * attempt is reused, and retries do not apply credit grants or balance twice.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
- * another charge. A draft order invoice must first be confirmed through checkout. It and a void
- * invoice are refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an order that has failed or was
+ * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
+ * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export declare const payInvoice: (invoiceId: string, payInvoiceRequest?: PayInvoiceRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<payInvoiceResponse>;
@@ -629,6 +643,8 @@ export declare const getPreviewInvoicePaymentUrl: (invoiceId: string, params?: P
  * straight afterwards takes exactly these amounts unless the account's funds change in between.
  * Nothing is charged, reserved or created.
  *
+ * A draft order invoice is priced as paying it with the same promotion_code would price it.
+ *
  * Refused with the same errors as paying, except that insufficient funds are not an error here:
  * they show as a `gateway_amount` above zero.
  * @summary Preview invoice payment
@@ -653,15 +669,22 @@ export declare const getPayTogetherUrl: () => string;
 /**
  * Pays outstanding invoices, including the invoices of the listed orders, from the account's
  * eligible credit grants and then its balance. No payment gateway is used; an invoice to be
- * paid online is paid on its own.
+ * paid online is paid on its own. The draft invoice of a deferred order takes the best applicable
+ * account discount and is issued first, and stays issued if the payment fails; pay it on its own to
+ * apply a promotion code.
  *
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
+ * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
  * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a draft order invoice or void invoice with
- * `BILLING_INVOICE_NOT_PAYABLE`, an order that has failed or was canceled with
+ * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
+ * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export declare const payTogether: (payTogetherRequest: PayTogetherRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<payTogetherResponse>;
@@ -709,7 +732,7 @@ export type listInvoicesResponseError = listInvoicesResponseDefault & {
 export type listInvoicesResponse = listInvoicesResponseSuccess | listInvoicesResponseError;
 export declare const getListInvoicesUrl: (params?: ListInvoicesParams) => string;
 /**
- * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded, including the draft invoice of an order awaiting payment, which is reached through its order; top-ups do not create invoices.
  * @summary List invoices
  */
 export declare const listInvoices: (params?: ListInvoicesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listInvoicesResponse>;
@@ -730,7 +753,7 @@ export type getInvoiceResponseError = getInvoiceResponseDefault & {
 export type getInvoiceResponse = getInvoiceResponseSuccess | getInvoiceResponseError;
 export declare const getGetInvoiceUrl: (invoiceId: string) => string;
 /**
- * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
+ * Returns an invoice for an owned billing account with its amounts, tax lines and payment state, whether issued or the draft invoice of an order. Returns 404 for a missing invoice or another draft and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export declare const getInvoice: (invoiceId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getInvoiceResponse>;
@@ -751,7 +774,7 @@ export type listInvoiceItemsResponseError = listInvoiceItemsResponseDefault & {
 export type listInvoiceItemsResponse = listInvoiceItemsResponseSuccess | listInvoiceItemsResponseError;
 export declare const getListInvoiceItemsUrl: (invoiceId: string, params?: ListInvoiceItemsParams) => string;
 /**
- * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
+ * Paginated lines of an invoice belonging to an owned billing account, issued or the draft invoice of an order, including their service periods and project references. A missing invoice or another draft returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export declare const listInvoiceItems: (invoiceId: string, params?: ListInvoiceItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listInvoiceItemsResponse>;
@@ -1046,11 +1069,11 @@ export type createQuoteResponseError = createQuoteResponseDefault & {
 export type createQuoteResponse = createQuoteResponseSuccess | createQuoteResponseError;
 export declare const getCreateQuoteUrl: () => string;
 /**
- * Calculates exactly one target for a billing account you own: proposed items, existing order checkout, renewals, cancellation or order refund. Returns all requested calculations or a structured error. No quote is saved and no resource, payment, reservation or redemption is created.
+ * Calculates exactly one target for a billing account you own: proposed items, an existing order, renewals, cancellation or order refund. Returns all requested calculations or a structured error. No quote is saved and no resource, payment, reservation or redemption is created.
  *
  * Existing orders use their recorded purchase account and terms. Renewals and cancellations use the account currently paying for each subscription. Every target must belong to the requested account. A project association or project token does not authorize a quote.
  *
- * Use an existing order quote's total as expected_amount at checkout. A confirmed order returns its recorded amounts; a different promotion code is refused. Requested future usage estimates are not collectible checkout amounts. An unknown delivery outcome is not proof of refund eligibility.
+ * Use an existing order quote's total as expected_amount when paying the order's invoice. An order whose terms are fixed returns its recorded amounts; a different promotion code is refused. Requested future usage estimates are not collectible checkout amounts. An unknown delivery outcome is not proof of refund eligibility.
  * @summary Create a quote
  */
 export declare const createQuote: (quoteRequest: QuoteRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createQuoteResponse>;
@@ -1125,7 +1148,8 @@ export declare const getCreateCancellationUrl: () => string;
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer
@@ -1155,7 +1179,7 @@ export type getCancellationResponseError = getCancellationResponseDefault & {
 export type getCancellationResponse = getCancellationResponseSuccess | getCancellationResponseError;
 export declare const getGetCancellationUrl: (cancellationId: string) => string;
 /**
- * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
+ * Returns a cancellation for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export declare const getCancellation: (cancellationId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCancellationResponse>;
@@ -1226,7 +1250,7 @@ export type renewSubscriptionResponseError = (renewSubscriptionResponse409 | ren
 export type renewSubscriptionResponse = renewSubscriptionResponseSuccess | renewSubscriptionResponseError;
 export declare const getRenewSubscriptionUrl: (subscriptionId: string) => string;
 /**
- * Purchases prepaid periods from paid_until using the agreed recurring amount, and pays for them at
+ * Purchases prepaid periods from current_term_end using the agreed recurring amount, and pays for them at
  * once. A changed interval selects a current price and freezes new terms on the order, applied
  * only after fulfillment. Existing paid periods keep their value.
  *
@@ -1262,12 +1286,12 @@ export type createRenewalOrderResponse = createRenewalOrderResponseSuccess | cre
 export declare const getCreateRenewalOrderUrl: (subscriptionId: string) => string;
 /**
  * Places a renewal order with a draft invoice, without applying a new discount or charging anything.
- * Quote and confirm its checkout before collecting payment to renew. Existing subscription
+ * Pay its invoice to renew; a promotion code can be applied when paying. Existing subscription
  * discount commitments are retained. The periods and price are chosen as for renewing. The order
  * can be paid until the current paid period ends, and never after the end of the first period it renews; unpaid by
  * then, it is canceled. While auto-renew is on, the renewal due at the end of the period pays
- * this order instead of placing another, confirming checkout with an applicable account discount
- * first if it has not already been confirmed.
+ * this order instead of placing another, applying an applicable account discount first if the
+ * order's terms are not fixed yet.
  *
  * Save `order_id` before submitting and read the order after an unknown outcome; creating it a
  * second time conflicts.
@@ -1291,8 +1315,9 @@ export type setAutoRenewResponseError = setAutoRenewResponseDefault & {
 export type setAutoRenewResponse = setAutoRenewResponseSuccess | setAutoRenewResponseError;
 export declare const getSetAutoRenewUrl: (subscriptionId: string) => string;
 /**
- * Controls automatic prepaid renewal. Disabling it does not shorten paid_until and still permits
- * manual renewal. Postpaid subscriptions do not renew and keep this false.
+ * Controls automatic prepaid renewal. Disabling it does not shorten current_term_end and still permits
+ * manual renewal. A postpaid subscription always continues until it is canceled; setting it is refused with 409
+ * `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED`.
  *
  * While the subscription has an open cancellation, turning it on or off is refused with 409
  * `BILLING_SUBSCRIPTION_OPERATION_PENDING` and `meta.cancellation_id`: creating the cancellation
@@ -1344,9 +1369,9 @@ export type listOrdersResponseError = listOrdersResponseDefault & {
 export type listOrdersResponse = listOrdersResponseSuccess | listOrdersResponseError;
 export declare const getListOrdersUrl: (params?: ListOrdersParams) => string;
 /**
- * Lists acceptance status and associated invoice amounts. pending_checkout awaits confirmation;
- * pending has confirmed checkout and may be unpaid or paid. active means accepted, not delivered.
- * pending_checkout and pending orders can expire at expires_at.
+ * Lists acceptance status and associated invoice amounts. A pending order is not yet accepted;
+ * its invoice shows whether it still needs payment. accepted means accepted, not delivered.
+ * Pending orders can expire at expires_at.
  * @summary List orders
  */
 export declare const listOrders: (params?: ListOrdersParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listOrdersResponse>;
@@ -1371,58 +1396,6 @@ export declare const getGetOrderUrl: (orderId: string) => string;
  * @summary Get order
  */
 export declare const getOrder: (orderId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getOrderResponse>;
-export type checkoutOrderResponse200 = {
-    data: Order;
-    status: 200;
-};
-export type checkoutOrderResponse409 = {
-    data: Error;
-    status: 409;
-};
-export type checkoutOrderResponseDefault = {
-    data: ErrorResponse;
-    status: Exclude<HTTPStatusCodes, 200 | 409>;
-};
-export type checkoutOrderResponseSuccess = checkoutOrderResponse200 & {
-    headers: Headers;
-};
-export type checkoutOrderResponseError = (checkoutOrderResponse409 | checkoutOrderResponseDefault) & {
-    headers: Headers;
-};
-export type checkoutOrderResponse = checkoutOrderResponseSuccess | checkoutOrderResponseError;
-export declare const getCheckoutOrderUrl: (orderId: string) => string;
-/**
- * Confirms the purchase's final amount and discount. Supply the same promotion_code used for the
- * preview, or omit it to select an applicable account discount. At most one new coupon is applied
- * to an order; existing subscription discount commitments are not stacked with a new coupon on
- * the same line. Promotion codes are evaluated against the order, not client-supplied line amounts.
- *
- * Rechecks eligibility and redemption availability. A different total fails with
- * BILLING_AMOUNT_CHANGED. An invalid or inapplicable code fails rather than collecting full price.
- * A failed confirmation leaves the invoice draft and reserves no discount redemption.
- *
- * A successful confirmation records the discount, including any recurring discount terms,
- * reserves its redemption, moves pending_checkout to pending and finalizes the invoice when one
- * is required. The reservation counts toward the code's limits and is consumed when the invoice
- * is paid, or at confirmation when nothing is due. Use pay-invoice to collect
- * its outstanding amount from account funds or a payment gateway. No payment attempt or checkout
- * session is created by this operation. An order whose total is zero completes checkout at
- * placement in either mode and does not need this operation; an order with an amount due, even
- * when credits would cover it, still does. Checkout alone does not confirm resource delivery.
- *
- * Retrying with the same code and expected amount returns the existing order without another
- * redemption. Omitting the code on a confirmed checkout retains its recorded discount. Changing
- * that code is refused with BILLING_ORDER_CHECKOUT_CONFLICT. Payment retries reuse the confirmed
- * terms. Cancellation, expiry or complete fulfillment failure releases the reservation or returns
- * the consumed redemption; a refund alone does not.
- *
- * The order must belong to one of your billing accounts. A canceled, failed or expired order
- * cannot be checked out. A period-end change cannot be checked out before its renewal invoice is
- * available. Orders retain their billing account and currency after a project is linked elsewhere;
- * discounts from another account cannot be used for them.
- * @summary Confirm order checkout
- */
-export declare const checkoutOrder: (orderId: string, checkoutOrderRequest: CheckoutOrderRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<checkoutOrderResponse>;
 export type cancelOrderResponse200 = {
     data: Order;
     status: 200;
@@ -1451,10 +1424,10 @@ export declare const getCancelOrderUrl: (orderId: string) => string;
  * its existing pending phase while any item is still pending; its final outcome follows all
  * item outcomes. Previously failed items keep their failure outcome.
  *
- * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
- * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
- * are returned to their original payment sources. When checkout has not been confirmed, the
- * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
+ * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. While the terms of a deferred order are not fixed,
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms
@@ -1507,11 +1480,35 @@ export declare const getListEntitlementsUrl: (params?: ListEntitlementsParams) =
  * does not appear, so that "this does not exist" and "this has not been bought" cannot be
  * confused.
  *
- * Derived from live subscriptions rather than stored, so this always agrees with what is
- * being paid for. It stops being listed as soon as the subscription providing it ends.
+ * Derived from live subscriptions and active feature grants rather than stored, so this always
+ * agrees with what is being paid for and granted. It stops being listed as soon as the
+ * subscription or grant providing it ends.
  * @summary List entitlements
  */
 export declare const listEntitlements: (params?: ListEntitlementsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listEntitlementsResponse>;
+export type listFeatureGrantsResponse200 = {
+    data: FeatureGrantList;
+    status: 200;
+};
+export type listFeatureGrantsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listFeatureGrantsResponseSuccess = listFeatureGrantsResponse200 & {
+    headers: Headers;
+};
+export type listFeatureGrantsResponseError = listFeatureGrantsResponseDefault & {
+    headers: Headers;
+};
+export type listFeatureGrantsResponse = listFeatureGrantsResponseSuccess | listFeatureGrantsResponseError;
+export declare const getListFeatureGrantsUrl: (params?: ListFeatureGrantsParams) => string;
+/**
+ * Access to features held by a billing account for a period, for example through a membership. While a grant
+ * is active, every project whose current billing account holds it has the feature, in addition to the
+ * features of its own subscriptions.
+ * @summary List feature grants
+ */
+export declare const listFeatureGrants: (params?: ListFeatureGrantsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listFeatureGrantsResponse>;
 export type listPricesResponse200 = {
     data: PriceList;
     status: 200;

package/dist/billing/v1/generated/functions.js

@@ -624,17 +624,31 @@ export const getPayInvoiceUrl = (invoiceId) => {
  * Applies eligible credit grants and available balance as requested, then collects the remainder
  * through the selected payment gateway and method. With no gateway selection, insufficient
  * account funds fail without starting an online payment. Card and non-card methods use this same
- * operation. Promotion codes are confirmed by checkout, before collecting payment.
+ * operation.
+ *
+ * The draft invoice of a deferred order is priced when it is first paid: Billing applies
+ * promotion_code, or the best applicable account discount when it is omitted, compares the total
+ * with expected_amount, records the discount on the order and issues the invoice before collecting.
+ * An invalid or inapplicable code fails rather than collecting full price, and a different total
+ * fails with `BILLING_AMOUNT_CHANGED`; in both cases nothing changes. The terms are fixed before
+ * any funds are collected and stay fixed when collection does not complete, for example with
+ * insufficient funds or a declined card: later attempts reuse them, and a different promotion_code
+ * is then refused with `BILLING_ORDER_CHECKOUT_CONFLICT`. A deferred period-end change can be paid
+ * once its first period is due to be invoiced; earlier attempts are refused with
+ * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
  * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
  * attempt is reused, and retries do not apply credit grants or balance twice.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
- * another charge. A draft order invoice must first be confirmed through checkout. It and a void
- * invoice are refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an order that has failed or was
+ * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
+ * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export const payInvoice = async (invoiceId, payInvoiceRequest, options, fetchFn) => {
@@ -681,6 +695,8 @@ export const getPreviewInvoicePaymentUrl = (invoiceId, params) => {
  * straight afterwards takes exactly these amounts unless the account's funds change in between.
  * Nothing is charged, reserved or created.
  *
+ * A draft order invoice is priced as paying it with the same promotion_code would price it.
+ *
  * Refused with the same errors as paying, except that insufficient funds are not an error here:
  * they show as a `gateway_amount` above zero.
  * @summary Preview invoice payment
@@ -700,15 +716,22 @@ export const getPayTogetherUrl = () => {
 /**
  * Pays outstanding invoices, including the invoices of the listed orders, from the account's
  * eligible credit grants and then its balance. No payment gateway is used; an invoice to be
- * paid online is paid on its own.
+ * paid online is paid on its own. The draft invoice of a deferred order takes the best applicable
+ * account discount and is issued first, and stays issued if the payment fails; pay it on its own to
+ * apply a promotion code.
  *
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
+ * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
  * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a draft order invoice or void invoice with
- * `BILLING_INVOICE_NOT_PAYABLE`, an order that has failed or was canceled with
+ * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
+ * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export const payTogether = async (payTogetherRequest, options, fetchFn) => {
@@ -789,7 +812,7 @@ export const getListInvoicesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/invoices`;
 };
 /**
- * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded, including the draft invoice of an order awaiting payment, which is reached through its order; top-ups do not create invoices.
  * @summary List invoices
  */
 export const listInvoices = async (params, options, fetchFn) => {
@@ -805,7 +828,7 @@ export const getGetInvoiceUrl = (invoiceId) => {
     return `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}`;
 };
 /**
- * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
+ * Returns an invoice for an owned billing account with its amounts, tax lines and payment state, whether issued or the draft invoice of an order. Returns 404 for a missing invoice or another draft and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export const getInvoice = async (invoiceId, options, fetchFn) => {
@@ -830,7 +853,7 @@ export const getListInvoiceItemsUrl = (invoiceId, params) => {
         : `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}/items`;
 };
 /**
- * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
+ * Paginated lines of an invoice belonging to an owned billing account, issued or the draft invoice of an order, including their service periods and project references. A missing invoice or another draft returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export const listInvoiceItems = async (invoiceId, params, options, fetchFn) => {
@@ -1149,11 +1172,11 @@ export const getCreateQuoteUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/quotes`;
 };
 /**
- * Calculates exactly one target for a billing account you own: proposed items, existing order checkout, renewals, cancellation or order refund. Returns all requested calculations or a structured error. No quote is saved and no resource, payment, reservation or redemption is created.
+ * Calculates exactly one target for a billing account you own: proposed items, an existing order, renewals, cancellation or order refund. Returns all requested calculations or a structured error. No quote is saved and no resource, payment, reservation or redemption is created.
  *
  * Existing orders use their recorded purchase account and terms. Renewals and cancellations use the account currently paying for each subscription. Every target must belong to the requested account. A project association or project token does not authorize a quote.
  *
- * Use an existing order quote's total as expected_amount at checkout. A confirmed order returns its recorded amounts; a different promotion code is refused. Requested future usage estimates are not collectible checkout amounts. An unknown delivery outcome is not proof of refund eligibility.
+ * Use an existing order quote's total as expected_amount when paying the order's invoice. An order whose terms are fixed returns its recorded amounts; a different promotion code is refused. Requested future usage estimates are not collectible checkout amounts. An unknown delivery outcome is not proof of refund eligibility.
  * @summary Create a quote
  */
 export const createQuote = async (quoteRequest, options, fetchFn) => {
@@ -1240,7 +1263,8 @@ export const getCreateCancellationUrl = () => {
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer
@@ -1282,7 +1306,7 @@ export const getGetCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };
 /**
- * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
+ * Returns a cancellation for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export const getCancellation = async (cancellationId, options, fetchFn) => {
@@ -1343,7 +1367,7 @@ export const getRenewSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renew`;
 };
 /**
- * Purchases prepaid periods from paid_until using the agreed recurring amount, and pays for them at
+ * Purchases prepaid periods from current_term_end using the agreed recurring amount, and pays for them at
  * once. A changed interval selects a current price and freezes new terms on the order, applied
  * only after fulfillment. Existing paid periods keep their value.
  *
@@ -1387,12 +1411,12 @@ export const getCreateRenewalOrderUrl = (subscriptionId) => {
 };
 /**
  * Places a renewal order with a draft invoice, without applying a new discount or charging anything.
- * Quote and confirm its checkout before collecting payment to renew. Existing subscription
+ * Pay its invoice to renew; a promotion code can be applied when paying. Existing subscription
  * discount commitments are retained. The periods and price are chosen as for renewing. The order
  * can be paid until the current paid period ends, and never after the end of the first period it renews; unpaid by
  * then, it is canceled. While auto-renew is on, the renewal due at the end of the period pays
- * this order instead of placing another, confirming checkout with an applicable account discount
- * first if it has not already been confirmed.
+ * this order instead of placing another, applying an applicable account discount first if the
+ * order's terms are not fixed yet.
  *
  * Save `order_id` before submitting and read the order after an unknown outcome; creating it a
  * second time conflicts.
@@ -1428,8 +1452,9 @@ export const getSetAutoRenewUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/auto-renew`;
 };
 /**
- * Controls automatic prepaid renewal. Disabling it does not shorten paid_until and still permits
- * manual renewal. Postpaid subscriptions do not renew and keep this false.
+ * Controls automatic prepaid renewal. Disabling it does not shorten current_term_end and still permits
+ * manual renewal. A postpaid subscription always continues until it is canceled; setting it is refused with 409
+ * `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED`.
  *
  * While the subscription has an open cancellation, turning it on or off is refused with 409
  * `BILLING_SUBSCRIPTION_OPERATION_PENDING` and `meta.cancellation_id`: creating the cancellation
@@ -1506,9 +1531,9 @@ export const getListOrdersUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/orders`;
 };
 /**
- * Lists acceptance status and associated invoice amounts. pending_checkout awaits confirmation;
- * pending has confirmed checkout and may be unpaid or paid. active means accepted, not delivered.
- * pending_checkout and pending orders can expire at expires_at.
+ * Lists acceptance status and associated invoice amounts. A pending order is not yet accepted;
+ * its invoice shows whether it still needs payment. accepted means accepted, not delivered.
+ * Pending orders can expire at expires_at.
  * @summary List orders
  */
 export const listOrders = async (params, options, fetchFn) => {
@@ -1536,66 +1561,6 @@ export const getOrder = async (orderId, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getCheckoutOrderUrl = (orderId) => {
-    return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/checkout`;
-};
-/**
- * Confirms the purchase's final amount and discount. Supply the same promotion_code used for the
- * preview, or omit it to select an applicable account discount. At most one new coupon is applied
- * to an order; existing subscription discount commitments are not stacked with a new coupon on
- * the same line. Promotion codes are evaluated against the order, not client-supplied line amounts.
- *
- * Rechecks eligibility and redemption availability. A different total fails with
- * BILLING_AMOUNT_CHANGED. An invalid or inapplicable code fails rather than collecting full price.
- * A failed confirmation leaves the invoice draft and reserves no discount redemption.
- *
- * A successful confirmation records the discount, including any recurring discount terms,
- * reserves its redemption, moves pending_checkout to pending and finalizes the invoice when one
- * is required. The reservation counts toward the code's limits and is consumed when the invoice
- * is paid, or at confirmation when nothing is due. Use pay-invoice to collect
- * its outstanding amount from account funds or a payment gateway. No payment attempt or checkout
- * session is created by this operation. An order whose total is zero completes checkout at
- * placement in either mode and does not need this operation; an order with an amount due, even
- * when credits would cover it, still does. Checkout alone does not confirm resource delivery.
- *
- * Retrying with the same code and expected amount returns the existing order without another
- * redemption. Omitting the code on a confirmed checkout retains its recorded discount. Changing
- * that code is refused with BILLING_ORDER_CHECKOUT_CONFLICT. Payment retries reuse the confirmed
- * terms. Cancellation, expiry or complete fulfillment failure releases the reservation or returns
- * the consumed redemption; a refund alone does not.
- *
- * The order must belong to one of your billing accounts. A canceled, failed or expired order
- * cannot be checked out. A period-end change cannot be checked out before its renewal invoice is
- * available. Orders retain their billing account and currency after a project is linked elsewhere;
- * discounts from another account cannot be used for them.
- * @summary Confirm order checkout
- */
-export const checkoutOrder = async (orderId, checkoutOrderRequest, options, fetchFn) => {
-    const getHeaders = (h) => {
-        if (!h)
-            return {};
-        if (h instanceof Headers)
-            return Object.fromEntries(h.entries());
-        if (Symbol.iterator in h) {
-            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
-        }
-        const headers = {};
-        for (const [name, value] of Object.entries(h)) {
-            if (value !== undefined)
-                headers[name] = value;
-        }
-        return headers;
-    };
-    const res = await (fetchFn ?? fetch)(getCheckoutOrderUrl(orderId), {
-        ...options,
-        method: "POST",
-        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(checkoutOrderRequest),
-    });
-    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
-    const data = body ? JSON.parse(body) : {};
-    return { data, status: res.status, headers: res.headers };
-};
 export const getCancelOrderUrl = (orderId) => {
     return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/cancel`;
 };
@@ -1607,10 +1572,10 @@ export const getCancelOrderUrl = (orderId) => {
  * its existing pending phase while any item is still pending; its final outcome follows all
  * item outcomes. Previously failed items keep their failure outcome.
  *
- * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
- * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
- * are returned to their original payment sources. When checkout has not been confirmed, the
- * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
+ * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. While the terms of a deferred order are not fixed,
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms
@@ -1688,8 +1653,9 @@ export const getListEntitlementsUrl = (params) => {
  * does not appear, so that "this does not exist" and "this has not been bought" cannot be
  * confused.
  *
- * Derived from live subscriptions rather than stored, so this always agrees with what is
- * being paid for. It stops being listed as soon as the subscription providing it ends.
+ * Derived from live subscriptions and active feature grants rather than stored, so this always
+ * agrees with what is being paid for and granted. It stops being listed as soon as the
+ * subscription or grant providing it ends.
  * @summary List entitlements
  */
 export const listEntitlements = async (params, options, fetchFn) => {
@@ -1701,6 +1667,33 @@ export const listEntitlements = async (params, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListFeatureGrantsUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://billing.leaflow.cloud/api/v1/feature-grants?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/feature-grants`;
+};
+/**
+ * Access to features held by a billing account for a period, for example through a membership. While a grant
+ * is active, every project whose current billing account holds it has the feature, in addition to the
+ * features of its own subscriptions.
+ * @summary List feature grants
+ */
+export const listFeatureGrants = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListFeatureGrantsUrl(params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getListPricesUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {