@leaflow/sdk 0.213.1 → 0.214.0

package/dist/billing/type/checkout/v1/generated/models.d.ts

@@ -56,7 +56,16 @@ export interface CheckoutOptions {
     return_url?: string;
     /**
      * Turns on automatic renewal of every subscription with licensed items that the purchase opens. Off
-     * when omitted. It must be the customer's own choice.
+     * when omitted. It must be the customer's own choice. For a free trial, it converts the trial to paid
+     * when the trial ends.
      */
     auto_renew?: boolean;
+    /**
+     * A free trial grant of the paying billing account that the customer chose to use. The first new
+     * subscription of the purchase whose lines the grant's offer all covers, and that has a licensed line and
+     * no trial of its own, opens with the offer's free trial. Accepted only in automatic mode; with deferred it is refused with
+     * HTTP 400, and the grant is chosen when completing the checkout through Billing. Refused with
+     * BILLING_TRIAL_GRANT_INAPPLICABLE when no subscription qualifies or the grant cannot be used now.
+     */
+    trial_grant_id?: string;
 }

package/dist/billing/type/checkout/v1/generated/validators/checkoutOptions.zod.d.ts

@@ -18,6 +18,7 @@ export declare const CheckoutOptions: zod.ZodObject<{
     expected_amount: zod.ZodOptional<zod.ZodIntersection<zod.ZodString, zod.ZodString>>;
     return_url: zod.ZodOptional<zod.ZodURL>;
     auto_renew: zod.ZodDefault<zod.ZodBoolean>;
+    trial_grant_id: zod.ZodOptional<zod.ZodUUID>;
 }, zod.z.core.$strict>;
 export type CheckoutOptions = zod.input<typeof CheckoutOptions>;
 export type CheckoutOptionsOutput = zod.output<typeof CheckoutOptions>;

package/dist/billing/type/checkout/v1/generated/validators/checkoutOptions.zod.js

@@ -26,6 +26,10 @@ export const CheckoutOptions = zod
     auto_renew: zod
         .boolean()
         .default(checkoutOptionsAutoRenewDefault)
-        .describe("Turns on automatic renewal of every subscription with licensed items that the purchase opens. Off\nwhen omitted. It must be the customer's own choice."),
+        .describe("Turns on automatic renewal of every subscription with licensed items that the purchase opens. Off\nwhen omitted. It must be the customer's own choice. For a free trial, it converts the trial to paid\nwhen the trial ends."),
+    trial_grant_id: zod
+        .uuid()
+        .optional()
+        .describe("A free trial grant of the paying billing account that the customer chose to use. The first new\nsubscription of the purchase whose lines the grant's offer all covers, and that has a licensed line and\nno trial of its own, opens with the offer's free trial. Accepted only in automatic mode; with deferred it is refused with\nHTTP 400, and the grant is chosen when completing the checkout through Billing. Refused with\nBILLING_TRIAL_GRANT_INAPPLICABLE when no subscription qualifies or the grant cannot be used now."),
 })
     .describe("Shared checkout choices for a product purchase. The service may set them or forward its client's\nchoices unchanged; it does not need to read them, and Billing validates them. Omitting this object or\nmode selects automatic checkout. Each purchase creates its own Checkout Session. Promotion codes are supplied\nonly to Billing. A service may retain a failed creation record when Billing refuses a purchase; no\ninfrastructure is created for that refusal.");

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

@@ -3,6 +3,6 @@ export {};
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */

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

@@ -3,6 +3,6 @@ export {};
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */

package/dist/billing/type/funds/v1/generated/models.d.ts

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */
 /**
@@ -25,13 +25,13 @@ export type Money = string;
 export interface Funds {
     /** Spendable balance after pending returns. */
     available_balance_amount: Money;
-    /** Currently effective credits eligible for the quoted purchases or metered usage. Each grant is counted once. */
+    /** Currently effective credits eligible for the purchases being checked out or metered usage. Each grant is counted once. */
     usable_credit_amount: Money;
-    /** Currently effective credits that cannot fund any quoted purchase or metered target. Unused eligible credits are not restricted. */
+    /** Currently effective credits that cannot fund any purchase being checked out or metered target. Unused eligible credits are not restricted. */
     restricted_credit_amount: Money;
     /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement. */
     required_balance_amount: Money;
-    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    /** Additional balance needed now. Zero means account funds satisfy this purchase. No funds are reserved. */
     balance_shortfall_amount: Money;
     /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
     required_top_up_amount: Money;

package/dist/billing/type/funds/v1/generated/schemas.zod.d.ts

@@ -3,6 +3,6 @@ export {};
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */

package/dist/billing/type/funds/v1/generated/schemas.zod.js

@@ -3,6 +3,6 @@ export {};
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */

package/dist/billing/type/funds/v1/generated/validators/funds.zod.d.ts

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";

package/dist/billing/type/funds/v1/generated/validators/funds.zod.js

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
@@ -10,10 +10,10 @@ import { Money } from "./money.zod.js";
 export const Funds = zod
     .strictObject({
     available_balance_amount: Money.describe("Spendable balance after pending returns."),
-    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or metered usage. Each grant is counted once."),
-    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or metered target. Unused eligible credits are not restricted."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the purchases being checked out or metered usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any purchase being checked out or metered target. Unused eligible credits are not restricted."),
     required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement."),
-    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this purchase. No funds are reserved."),
     required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
 })
     .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA licensed purchase may instead be paid with an online payment method.\n");

package/dist/billing/type/funds/v1/generated/validators/money.zod.d.ts

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";

package/dist/billing/type/funds/v1/generated/validators/money.zod.js

@@ -2,7 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Purchase Funds
- * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * Current account funds and the additional balance needed for a purchase being checked out. Types only.
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";

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

@@ -2,10 +2,10 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Billing API
- * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token. The account, its balance, payment options and quotes are also readable by members of the projects it currently pays for; changing the account and moving its funds need the owner. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, quote purchases, changes and renewals, preview cancellations, and, with the project permission `billing:finance.manage` granted in IAM, renew, cancel and turn automatic renewal of its subscriptions on or off, change its billing account and read its costs. A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
+ * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token. The account, its balance, payment options and checkout previews are also readable by members of the projects it currently pays for; changing the account and moving its funds need the owner. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, preview the checkout of purchases, changes and renewals, preview cancellations, and, with the project permission `billing:finance.manage` granted in IAM, renew, cancel and turn automatic renewal of its subscriptions on or off, change its billing account and read its costs. A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
-import type { AccountBalance, AccountDeletionReadiness, ActiveResourceList, AllowanceList, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CancellationPreview, CancellationPreviewRequest, CheckoutSession, CheckoutSessionConfirm, CheckoutSessionCreate, CheckoutSessionItemList, CheckoutSessionList, CheckoutSessionResult, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetCheckoutSessionQuoteParams, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCheckoutSessionItemsParams, ListCheckoutSessionsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRefundsParams, ListRenewalOptionsParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, ListWithdrawalItemsParams, ListWithdrawalsParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, OrderRefundPreview, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, PreviewOrderRefundParams, Price, PriceList, PriceSearch, Product, ProductId, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RefundList, RenewRequest, RenewalOptionList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, SubscriptionUpdate, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList, UsageEstimate, UsageEstimateRequest, Withdrawal, WithdrawalCreate, WithdrawalItemList, WithdrawalList, WithdrawalPreview, WithdrawalPreviewRequest } from "./models.js";
+import type { AccountBalance, AccountDeletionReadiness, ActiveResourceList, AllowanceList, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CancellationPreview, CancellationPreviewRequest, CheckoutSession, CheckoutSessionConfirm, CheckoutSessionCreate, CheckoutSessionList, CheckoutSessionPreviewRequest, CheckoutSessionResult, CheckoutSessionUpdate, 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, ListCheckoutSessionsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRefundsParams, ListRenewalOptionsParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListTrialGrantsParams, ListUsageChargesParams, ListWithdrawalItemsParams, ListWithdrawalsParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, OrderRefundPreview, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, PreviewOrderRefundParams, Price, PriceList, PriceSearch, Product, ProductId, ProductList, ProjectAssignment, ProjectAssignmentList, RefundList, RenewRequest, RenewalOptionList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, SubscriptionUpdate, TopUp, TopUpCreate, TopUpList, TransactionList, TrialGrant, TrialGrantList, UsageChargeList, UsageEstimate, UsageEstimateRequest, Withdrawal, WithdrawalCreate, WithdrawalItemList, WithdrawalList, WithdrawalPreview, WithdrawalPreviewRequest } 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;
@@ -239,7 +239,7 @@ export type listCurrenciesResponseError = listCurrenciesResponseDefault & {
 export type listCurrenciesResponse = listCurrenciesResponseSuccess | listCurrenciesResponseError;
 export declare const getListCurrenciesUrl: (params?: ListCurrenciesParams) => string;
 /**
- * Currencies a new billing account can be opened in, and prices and quotes without an account can be given in, for anyone, signed in or not. Retired currencies are not listed.
+ * Currencies a new billing account can be opened in, and prices and checkout previews without an account can be given in, for anyone, signed in or not. Retired currencies are not listed.
  * @summary List currencies accounts can be opened in
  */
 export declare const listCurrencies: (params?: ListCurrenciesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCurrenciesResponse>;
@@ -938,6 +938,50 @@ export declare const getListAccountDiscountsUrl: (params?: ListAccountDiscountsP
  * @summary List the coupons held on this account
  */
 export declare const listAccountDiscounts: (params?: ListAccountDiscountsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listAccountDiscountsResponse>;
+export type listTrialGrantsResponse200 = {
+    data: TrialGrantList;
+    status: 200;
+};
+export type listTrialGrantsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listTrialGrantsResponseSuccess = listTrialGrantsResponse200 & {
+    headers: Headers;
+};
+export type listTrialGrantsResponseError = listTrialGrantsResponseDefault & {
+    headers: Headers;
+};
+export type listTrialGrantsResponse = listTrialGrantsResponseSuccess | listTrialGrantsResponseError;
+export declare const getListTrialGrantsUrl: (params?: ListTrialGrantsParams) => string;
+/**
+ * Free trials held by your billing accounts. Choose an available grant when checking out a purchase its offer
+ * covers, by saving its ID as `trial_grant_id` on the Checkout Session; a session and its preview list the grants that
+ * can be used for it.
+ * @summary List free trial grants
+ */
+export declare const listTrialGrants: (params?: ListTrialGrantsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listTrialGrantsResponse>;
+export type getTrialGrantResponse200 = {
+    data: TrialGrant;
+    status: 200;
+};
+export type getTrialGrantResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type getTrialGrantResponseSuccess = getTrialGrantResponse200 & {
+    headers: Headers;
+};
+export type getTrialGrantResponseError = getTrialGrantResponseDefault & {
+    headers: Headers;
+};
+export type getTrialGrantResponse = getTrialGrantResponseSuccess | getTrialGrantResponseError;
+export declare const getGetTrialGrantUrl: (trialGrantId: string) => string;
+/**
+ * A free trial held by one of your billing accounts. Returns 404 if it does not exist or is not yours.
+ * @summary Get a free trial grant
+ */
+export declare const getTrialGrant: (trialGrantId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getTrialGrantResponse>;
 export type listCreditGrantsResponse200 = {
     data: CreditGrantList;
     status: 200;
@@ -1187,41 +1231,6 @@ export declare const getCancelSubscriptionUrl: (subscriptionId: string) => strin
  * @summary Cancel subscription
  */
 export declare const cancelSubscription: (subscriptionId: string, cancelSubscriptionRequest: CancelSubscriptionRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelSubscriptionResponse>;
-export type getQuoteResponse200 = {
-    data: Quote;
-    status: 200;
-};
-export type getQuoteResponseDefault = {
-    data: ErrorResponse;
-    status: Exclude<HTTPStatusCodes, 200>;
-};
-export type getQuoteResponseSuccess = getQuoteResponse200 & {
-    headers: Headers;
-};
-export type getQuoteResponseError = getQuoteResponseDefault & {
-    headers: Headers;
-};
-export type getQuoteResponse = getQuoteResponseSuccess | getQuoteResponseError;
-export declare const getGetQuoteUrl: () => string;
-/**
- * Calculates what a proposed purchase, a change of your subscriptions or their renewal would invoice now, and
- * what each purchased or changed line renews at. Nothing is saved, reserved or redeemed.
- *
- * With `billing_account_id`, the quote is for that billing account: its currency, account discounts,
- * tax and funds apply, changes and renewals use the account currently paying for each subscription, and an
- * access token is required. The account must be yours or currently pay for a project you are a member of.
- * Without it, proposed items are priced in `currency` for anyone, signed in or not: no account discount or funds
- * apply, and tax that would be added is included only for the customer's `address`.
- *
- * A change is priced as the service that owns the subscription would order it: pass the returned `total` as the
- * expected amount and, for an immediate change, `proration_date` to that service when making the change.
- *
- * A promotion code is evaluated without being applied. It is applied only when a Checkout Session is completed
- * with it; conditions that depend on the account, such as a first purchase, are checked only with an account
- * and otherwise reported as `unverified`. Future usage of metered prices is estimated with `estimate-usage`.
- * @summary Get a quote
- */
-export declare const getQuote: (quoteRequest: QuoteRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getQuoteResponse>;
 export type estimateUsageResponse200 = {
     data: UsageEstimate;
     status: 200;
@@ -1301,8 +1310,9 @@ export declare const getCreateCancellationUrl: () => string;
  *
  * `mode` must be allowed for every item. Metered and one-time items end only `immediate`. A licensed item ends
  * `period_end` while its subscription's paid term lasts, and `immediate` unless its terms allow only the end of
- * the paid term and that term has not ended. For `period_end` the paid terms of all items must end at the same
- * time.
+ * the paid term and that term has not ended. During a free trial a licensed item ends either way whatever its
+ * terms, `period_end` meaning the end of the trial, and nothing is refunded. For `period_end` the paid terms of
+ * all items must end at the same time.
  *
  * Refused with:
  *
@@ -1486,7 +1496,8 @@ export type listCheckoutSessionsResponseError = listCheckoutSessionsResponseDefa
 export type listCheckoutSessionsResponse = listCheckoutSessionsResponseSuccess | listCheckoutSessionsResponseError;
 export declare const getListCheckoutSessionsUrl: (params?: ListCheckoutSessionsParams) => string;
 /**
- * Checkout Sessions of your billing accounts, newest first; members of a project list its sessions with `project_ids`. An open session is a purchase waiting for checkout to be completed.
+ * Checkout Sessions of your billing accounts, newest first; members of a project list its sessions with
+ * `project_ids`. An open session is a purchase waiting for checkout to be completed.
  * @summary List Checkout Sessions
  */
 export declare const listCheckoutSessions: (params?: ListCheckoutSessionsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCheckoutSessionsResponse>;
@@ -1514,9 +1525,10 @@ export declare const getCreateCheckoutSessionUrl: () => string;
  * Opens a Checkout Session renewing one or more subscriptions in one order, such as a machine and the separately
  * bought volumes and elastic IPs attached to it, with periods and price chosen as in renewing. Every subscription
  * must be paid by the same billing account and belong to the same project and service. Nothing is charged until
- * you complete it, when a promotion code can be applied; each subscription then renews from its current_term_end
- * at that time. To renew one subscription at once from credit grants, balance or a payment method, renew the
- * subscription instead. Purchases and changes of a service's resources are created through that service.
+ * you complete it; save a promotion code on it first with `update-checkout-session`. Each subscription then renews
+ * from its current_term_end at that time. To renew one subscription at once from credit grants, balance or a
+ * payment method, renew the subscription instead. Purchases and changes of a service's resources are created
+ * through that service.
  *
  * Open to the owner of the subscriptions' current billing account and to members of their project with the
  * project permission `billing:finance.manage`. Keep `checkout_session_id` and read the session after an
@@ -1524,78 +1536,97 @@ export declare const getCreateCheckoutSessionUrl: () => string;
  * @summary Create a renewal Checkout Session
  */
 export declare const createCheckoutSession: (checkoutSessionCreate: CheckoutSessionCreate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createCheckoutSessionResponse>;
-export type getCheckoutSessionResponse200 = {
+export type previewCheckoutSessionResponse200 = {
     data: CheckoutSession;
     status: 200;
 };
-export type getCheckoutSessionResponseDefault = {
+export type previewCheckoutSessionResponseDefault = {
     data: ErrorResponse;
     status: Exclude<HTTPStatusCodes, 200>;
 };
-export type getCheckoutSessionResponseSuccess = getCheckoutSessionResponse200 & {
+export type previewCheckoutSessionResponseSuccess = previewCheckoutSessionResponse200 & {
     headers: Headers;
 };
-export type getCheckoutSessionResponseError = getCheckoutSessionResponseDefault & {
+export type previewCheckoutSessionResponseError = previewCheckoutSessionResponseDefault & {
     headers: Headers;
 };
-export type getCheckoutSessionResponse = getCheckoutSessionResponseSuccess | getCheckoutSessionResponseError;
-export declare const getGetCheckoutSessionUrl: (checkoutSessionId: string) => string;
+export type previewCheckoutSessionResponse = previewCheckoutSessionResponseSuccess | previewCheckoutSessionResponseError;
+export declare const getPreviewCheckoutSessionUrl: () => string;
 /**
- * A Checkout Session of your billing account or of a project you are a member of. Poll it to follow checkout; once it is complete, read its order for payment and delivery. An unknown session returns 404; any other session returns 403.
- * @summary Get a Checkout Session
+ * What a Checkout Session for a purchase, a change of your subscriptions or their renewal would invoice if it
+ * were completed now, returned as a session that is not saved: it has no `id`, and nothing is ordered, reserved
+ * or redeemed. Use it to show prices before buying; the service that sells a resource creates the session for its
+ * purchase or change, and you create renewal sessions here.
+ *
+ * With `billing_account_id` the preview is for that billing account: its currency, account discounts, tax,
+ * funds and free trial grants apply, changes and renewals use the account currently paying for each
+ * subscription, and an access token is required. The account must be yours or currently pay for a project you
+ * are a member of. Without it, a purchase is priced in `currency` for anyone, signed in or not: no account
+ * discount, funds or trial grant apply, and tax that would be added is included only for `address`.
+ *
+ * A promotion code is evaluated without being applied; conditions that depend on the account, such as a first
+ * purchase, are checked only with an account and otherwise reported as `unverified`. An invalid or inapplicable
+ * code or trial grant fails the request. Future usage of metered prices is estimated with `estimate-usage`.
+ * @summary Preview a Checkout Session
  */
-export declare const getCheckoutSession: (checkoutSessionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCheckoutSessionResponse>;
-export type listCheckoutSessionItemsResponse200 = {
-    data: CheckoutSessionItemList;
+export declare const previewCheckoutSession: (checkoutSessionPreviewRequest: CheckoutSessionPreviewRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<previewCheckoutSessionResponse>;
+export type getCheckoutSessionResponse200 = {
+    data: CheckoutSession;
     status: 200;
 };
-export type listCheckoutSessionItemsResponseDefault = {
+export type getCheckoutSessionResponseDefault = {
     data: ErrorResponse;
     status: Exclude<HTTPStatusCodes, 200>;
 };
-export type listCheckoutSessionItemsResponseSuccess = listCheckoutSessionItemsResponse200 & {
+export type getCheckoutSessionResponseSuccess = getCheckoutSessionResponse200 & {
     headers: Headers;
 };
-export type listCheckoutSessionItemsResponseError = listCheckoutSessionItemsResponseDefault & {
+export type getCheckoutSessionResponseError = getCheckoutSessionResponseDefault & {
     headers: Headers;
 };
-export type listCheckoutSessionItemsResponse = listCheckoutSessionItemsResponseSuccess | listCheckoutSessionItemsResponseError;
-export declare const getListCheckoutSessionItemsUrl: (checkoutSessionId: string, params?: ListCheckoutSessionItemsParams) => string;
+export type getCheckoutSessionResponse = getCheckoutSessionResponseSuccess | getCheckoutSessionResponseError;
+export declare const getGetCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * What the session buys, by position. Prices and amounts are in its quote. Readable by whoever can read the session.
- * @summary List Checkout Session items
+ * A Checkout Session of your billing account or of a project you are a member of, with what completing it now
+ * would invoice under the choices saved on it. A saved promotion code or trial grant that can no longer be applied
+ * is left out of the amounts; `discount` and the subscriptions' `trial_grant_id` show what applies, and confirming
+ * fails until the session is updated. Poll it to follow checkout; once it is complete, read its order for payment
+ * and delivery. An unknown session returns 404; any other session returns 403.
+ * @summary Get a Checkout Session
  */
-export declare const listCheckoutSessionItems: (checkoutSessionId: string, params?: ListCheckoutSessionItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCheckoutSessionItemsResponse>;
-export type getCheckoutSessionQuoteResponse200 = {
-    data: Quote;
+export declare const getCheckoutSession: (checkoutSessionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCheckoutSessionResponse>;
+export type updateCheckoutSessionResponse200 = {
+    data: CheckoutSession;
     status: 200;
 };
-export type getCheckoutSessionQuoteResponseDefault = {
+export type updateCheckoutSessionResponseDefault = {
     data: ErrorResponse;
     status: Exclude<HTTPStatusCodes, 200>;
 };
-export type getCheckoutSessionQuoteResponseSuccess = getCheckoutSessionQuoteResponse200 & {
+export type updateCheckoutSessionResponseSuccess = updateCheckoutSessionResponse200 & {
     headers: Headers;
 };
-export type getCheckoutSessionQuoteResponseError = getCheckoutSessionQuoteResponseDefault & {
+export type updateCheckoutSessionResponseError = updateCheckoutSessionResponseDefault & {
     headers: Headers;
 };
-export type getCheckoutSessionQuoteResponse = getCheckoutSessionQuoteResponseSuccess | getCheckoutSessionQuoteResponseError;
-export declare const getGetCheckoutSessionQuoteUrl: (checkoutSessionId: string, params?: GetCheckoutSessionQuoteParams) => string;
+export type updateCheckoutSessionResponse = updateCheckoutSessionResponseSuccess | updateCheckoutSessionResponseError;
+export declare const getUpdateCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * What completing this open session now would invoice, with `promotion_code` or otherwise the best applicable
- * account discount, and the account funds available for it. Nothing is applied, reserved or redeemed. An invalid
- * or inapplicable code fails the request without changing the session.
+ * Saves your checkout choices on an open session: a promotion code, a free trial grant and automatic renewal.
+ * Choices left out keep their values, and null removes a code or a grant. The session is returned with its
+ * amounts calculated under the new choices; nothing is redeemed until it is completed.
  *
- * Complete the session with the returned `total` as `expected_amount`, the same `promotion_code` and, for an
- * immediate change, the returned `proration_date`. An expired session is refused with
- * `BILLING_CHECKOUT_SESSION_EXPIRED`, and a complete one with `BILLING_CHECKOUT_SESSION_COMPLETE`; read its order
- * instead.
+ * A code that does not exist or cannot be applied is refused with its promotion error, and a grant that cannot be
+ * used with `BILLING_TRIAL_GRANT_INAPPLICABLE`; the session is then unchanged. A grant applies to the first new
+ * subscription of the session whose lines its offer all covers, and that has a licensed line and no trial of its
+ * own. `auto_renew` turns automatic renewal on or off for every subscription with licensed items the session
+ * opens; for a free trial, it decides whether the trial converts to paid when it ends. A session that is not
+ * open is refused with `BILLING_CHECKOUT_SESSION_COMPLETE` or `BILLING_CHECKOUT_SESSION_EXPIRED`.
  *
  * Open to the owner of the session's billing account and to members of its project.
- * @summary Quote a Checkout Session
+ * @summary Update a Checkout Session
  */
-export declare const getCheckoutSessionQuote: (checkoutSessionId: string, params?: GetCheckoutSessionQuoteParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCheckoutSessionQuoteResponse>;
+export declare const updateCheckoutSession: (checkoutSessionId: string, checkoutSessionUpdate: CheckoutSessionUpdate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<updateCheckoutSessionResponse>;
 export type confirmCheckoutSessionResponse200 = {
     data: CheckoutSessionResult;
     status: 200;
@@ -1617,11 +1648,13 @@ export type confirmCheckoutSessionResponseError = (confirmCheckoutSessionRespons
 export type confirmCheckoutSessionResponse = confirmCheckoutSessionResponseSuccess | confirmCheckoutSessionResponseError;
 export declare const getConfirmCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * Completes an open session: applies `promotion_code`, or otherwise the best applicable account discount, checks
- * the total against `expected_amount` and creates the order with its invoice issued. A zero-total invoice is paid
- * at once; otherwise pay the invoice next. A failed payment leaves the order and its terms as they are, and the
- * invoice can be paid again until the order expires. Nothing is created when the code is invalid or
- * inapplicable or the total differs, which fails with `BILLING_AMOUNT_CHANGED`.
+ * Completes an open session under the choices saved on it: its promotion code, or otherwise the best applicable
+ * account discount, and its free trial grant. Checks the total against `expected_amount` and creates the order
+ * with its invoice issued. A zero-total invoice is paid at once; otherwise pay the invoice next. A failed payment
+ * leaves the order and its terms as they are, and the invoice can be paid again until the order expires. Nothing
+ * is created when the total differs, which fails with `BILLING_AMOUNT_CHANGED`, or when a saved code or grant can
+ * no longer be applied, which fails with its error until the session is updated. A trial grant used by an order
+ * that is later canceled or fails can be used again.
  *
  * Confirming a complete session again with the same terms returns it with its order; different terms are refused
  * with `BILLING_CHECKOUT_SESSION_COMPLETE`. An expired session is refused with `BILLING_CHECKOUT_SESSION_EXPIRED`.
@@ -1652,7 +1685,9 @@ export type expireCheckoutSessionResponseError = (expireCheckoutSessionResponse4
 export type expireCheckoutSessionResponse = expireCheckoutSessionResponseSuccess | expireCheckoutSessionResponseError;
 export declare const getExpireCheckoutSessionUrl: (checkoutSessionId: string) => string;
 /**
- * Ends an open session without an order; the service that created it releases what it was holding for the purchase. An expired session is returned unchanged. Open to the owner of the session's billing account and to members of its project.
+ * Ends an open session without an order; the service that created it releases what it was holding for
+ * the purchase. An expired session is returned unchanged. Open to the owner of the session's billing account and
+ * to members of its project.
  * @summary Expire a Checkout Session
  */
 export declare const expireCheckoutSession: (checkoutSessionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<expireCheckoutSessionResponse>;