@leaflow/sdk 0.212.0 → 0.214.0

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

@@ -266,7 +266,7 @@ export const getListCurrenciesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/currencies`;
 };
 /**
- * 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 const listCurrencies = async (params, options, fetchFn) => {
@@ -1045,6 +1045,49 @@ export const listAccountDiscounts = async (params, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListTrialGrantsUrl = (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/trial-grants?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/trial-grants`;
+};
+/**
+ * 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 const listTrialGrants = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListTrialGrantsUrl(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 getGetTrialGrantUrl = (trialGrantId) => {
+    return `https://billing.leaflow.cloud/api/v1/trial-grants/${encodeURIComponent(String(trialGrantId))}`;
+};
+/**
+ * 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 const getTrialGrant = async (trialGrantId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetTrialGrantUrl(trialGrantId), {
+        ...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 getListCreditGrantsUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -1199,7 +1242,7 @@ export const getListSubscriptionsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/subscriptions`;
 };
 /**
- * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Deleted subscriptions are not listed.
+ * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Each subscription includes its items. Deleted subscriptions are not listed.
  * @summary List subscriptions
  */
 export const listSubscriptions = async (params, options, fetchFn) => {
@@ -1215,7 +1258,7 @@ export const getGetSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
 };
 /**
- * A subscription paid by your billing account or of a project you are a member of. Deleted subscriptions are reported as not found.
+ * A subscription paid by your billing account or of a project you are a member of, with its items. Deleted subscriptions are reported as not found.
  * @summary Get subscription
  */
 export const getSubscription = async (subscriptionId, options, fetchFn) => {
@@ -1227,39 +1270,23 @@ export const getSubscription = async (subscriptionId, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getDeleteSubscriptionUrl = (subscriptionId) => {
+export const getUpdateSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
 };
 /**
- * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
- * @summary Delete subscription
- */
-export const deleteSubscription = async (subscriptionId, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getDeleteSubscriptionUrl(subscriptionId), {
-        ...options,
-        method: "DELETE",
-    });
-    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
-    const data = body ? JSON.parse(body) : undefined;
-    return { data, status: res.status, headers: res.headers };
-};
-export const getCancelSubscriptionUrl = (subscriptionId) => {
-    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}:cancel`;
-};
-/**
- * Requests cancellation on the purchase's agreed terms, with the same rules as creating a cancellation. Give the
- * `proration_date` and `refundable_amount` of preview-cancellation for this subscription. Open to the owner of the
- * subscription's current billing account and to members of its project with the project permission
- * `billing:finance.manage`.
+ * Changes the subscription's settings given in the request; settings left out keep their values. `auto_renew`
+ * turns automatic renewal on or off for the whole subscription, or, on a trialing subscription, whether the trial
+ * converts to paid. Turning it off does not shorten current_term_end and still allows manual renewal.
  *
- * Immediate cancellation asks the owning service to release the resources now; period-end cancellation keeps the
- * subscription active or suspended until the paid term ends. The subscription becomes canceled when the service
- * confirms the release; follow the returned cancellation. Subscriptions released together must be canceled
- * together through create-cancellation, and pending or provisioning purchases through their order. Repeating the
- * request while the cancellation is open returns it.
- * @summary Cancel subscription
- */
-export const cancelSubscription = async (subscriptionId, cancelSubscriptionRequest, options, fetchFn) => {
+ * `auto_renew` is refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning
+ * subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a subscription with only metered items, which
+ * continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id`
+ * while a cancellation of the whole subscription is open: creating it turned renewal off, and withdrawing it does
+ * not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its
+ * project with the project permission `billing:finance.manage`.
+ * @summary Update subscription
+ */
+export const updateSubscription = async (subscriptionId, subscriptionUpdate, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -1275,38 +1302,49 @@ export const cancelSubscription = async (subscriptionId, cancelSubscriptionReque
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getCancelSubscriptionUrl(subscriptionId), {
+    const res = await (fetchFn ?? fetch)(getUpdateSubscriptionUrl(subscriptionId), {
         ...options,
-        method: "POST",
+        method: "PATCH",
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(cancelSubscriptionRequest),
+        body: JSON.stringify(subscriptionUpdate),
     });
     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 getGetQuoteUrl = () => {
-    return `https://billing.leaflow.cloud/api/v1/quotes`;
+export const getDeleteSubscriptionUrl = (subscriptionId) => {
+    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
 };
 /**
- * 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.
+ * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at, items and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
+ * @summary Delete subscription
+ */
+export const deleteSubscription = async (subscriptionId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteSubscriptionUrl(subscriptionId), {
+        ...options,
+        method: "DELETE",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : undefined;
+    return { data, status: res.status, headers: res.headers };
+};
+export const getCancelSubscriptionUrl = (subscriptionId) => {
+    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}:cancel`;
+};
+/**
+ * Requests cancellation of every continuing item of the subscription on their agreed terms, with the same rules
+ * as creating a cancellation. Give the `proration_date` and `refundable_amount` of preview-cancellation for these
+ * items. Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:finance.manage`.
  *
- * 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
+ * Immediate cancellation asks the owning service to release the resources now; period-end cancellation keeps the
+ * subscription in service until its current term ends. The subscription becomes canceled when the service
+ * confirms the release; follow the returned cancellation. To cancel some items, or items released together across
+ * subscriptions, use create-cancellation; pending or provisioning purchases are canceled through their order.
+ * Repeating the request while the cancellation is open returns it.
+ * @summary Cancel subscription
  */
-export const getQuote = async (quoteRequest, options, fetchFn) => {
+export const cancelSubscription = async (subscriptionId, cancelSubscriptionRequest, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -1322,11 +1360,11 @@ export const getQuote = async (quoteRequest, options, fetchFn) => {
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getGetQuoteUrl(), {
+    const res = await (fetchFn ?? fetch)(getCancelSubscriptionUrl(subscriptionId), {
         ...options,
-        method: "QUERY",
+        method: "POST",
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(quoteRequest),
+        body: JSON.stringify(cancelSubscriptionRequest),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};
@@ -1381,7 +1419,7 @@ export const getListCancellationsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/cancellations`;
 };
 /**
- * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
+ * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_item_id` and `status=open` to find an item's cancellation in progress, or by `subscription_id` for every item of a subscription.
  * @summary List cancellations
  */
 export const listCancellations = async (params, options, fetchFn) => {
@@ -1397,39 +1435,42 @@ export const getCreateCancellationUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/cancellations`;
 };
 /**
- * Ends subscriptions of one service together. Deleting a resource is an `immediate` cancellation of every
- * subscription released with it, such as a server with its disks or an address with its bandwidth. Open to the
- * owner of the subscriptions' current billing account and to members of their project with the project
- * permission `billing:finance.manage`.
+ * Ends subscription items of one service together, from one subscription or several. Deleting a resource is an
+ * `immediate` cancellation of every item released with it, such as a server with its disks or an address with
+ * its bandwidth. Open to the owner of the items' current billing account and to members of their project with
+ * the project permission `billing:finance.manage`.
  *
- * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the paid
- * term, for `period_end`. When release is confirmed, the unused value is returned to the original payment
- * sources under each subscription's refund terms. For `immediate` the refund is computed as of `proration_date`
- * and is not reduced by service used during release. Metered usage is charged until release.
+ * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the
+ * subscription's current term, for `period_end`; until then the items are left out of renewals. When release is
+ * confirmed, the unused value is returned to the original payment sources under each item's refund terms. For
+ * `immediate` the refund is computed as of `proration_date` and is not reduced by service used during release.
+ * Metered usage is charged until release. A subscription whose continuing items all end is canceled.
  *
- * `mode` must be allowed for every subscription. Metered and one-time subscriptions end only `immediate`. A
- * licensed subscription ends `period_end` while its 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` all paid terms must end at the same
- * time.
+ * `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. 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:
  *
- * - 400 `BILLING_CANCELLATION_INVALID` when `subscription_ids` or `proration_date` is invalid (`meta.field`), or
- *   the subscriptions do not share one service, project, account and currency;
- * - 409 `BILLING_CANCELLATION_CONFLICT` when a subscription has not started or has ended;
+ * - 400 `BILLING_CANCELLATION_INVALID` when `items` or `proration_date` is invalid (`meta.field`), or the items
+ *   do not share one service, project, account and currency;
+ * - 409 `BILLING_CANCELLATION_CONFLICT` when an item has not started or has ended;
  * - 422 `BILLING_CANCELLATION_MODE_FIXED` when `mode` is not allowed, and `BILLING_CANCELLATION_TERMS_UNSET`
- *   when a licensed subscription has no cancellation terms, both with `meta.subscription_id`;
+ *   when a licensed item has no cancellation terms, both with `meta.subscription_item_id`;
  * - 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.reason` `reclaim_requested`), or has a paid change waiting to
- *   switch (`meta.order_id`);
- * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online renewal payment for one of them is in progress;
+ * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when an item is already being canceled
+ *   (`meta.cancellation_id`), its subscription is being reclaimed (`meta.reason` `reclaim_requested`), or the
+ *   item has a paid change waiting to switch (`meta.order_id`);
+ * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online renewal payment for one of their subscriptions is in
+ *   progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund no longer equals `expected_refundable_amount`.
  *
- * Repeating the request for the same subscriptions, mode and amount while the cancellation is open returns it
- * with 200. Unpaid renewal orders are canceled with it, and automatic renewal is turned off for every
- * subscription.
- * @summary Cancel subscriptions
+ * Repeating the request for the same items, mode and amount while the cancellation is open returns it with 200.
+ * When it covers every continuing item of a subscription, unpaid renewal orders of that subscription are
+ * canceled with it and its automatic renewal is turned off.
+ * @summary Cancel subscription items
  */
 export const createCancellation = async (cancellationCreate, options, fetchFn) => {
     const getHeaders = (h) => {
@@ -1461,7 +1502,7 @@ export const getPreviewCancellationUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/cancellations:preview`;
 };
 /**
- * What creating the cancellation now would return, per subscription and in total. Nothing is canceled, ended or refunded. Open to the owner of the subscriptions' current billing account and to members of their project; refused for the same states as creating it.
+ * What creating the cancellation now would return, per item and in total. Nothing is canceled, ended or refunded. Open to the owner of the items' current billing account and to members of their project; refused for the same states as creating it.
  * @summary Preview a cancellation
  */
 export const previewCancellation = async (cancellationPreviewRequest, options, fetchFn) => {
@@ -1494,7 +1535,7 @@ export const getGetCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };
 /**
- * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
+ * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each item, including partial success.
  * @summary Get a cancellation
  */
 export const getCancellation = async (cancellationId, options, fetchFn) => {
@@ -1506,15 +1547,15 @@ export const getCancellation = async (cancellationId, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getWithdrawCancellationUrl = (cancellationId) => {
+export const getDeleteCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };
 /**
- * Withdraws the whole cancellation, which stays with status `canceled`, while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the subscriptions' current billing account and to members of their project with the project permission `billing:finance.manage`.
+ * Withdraws the whole cancellation, which stays with status `canceled`, while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The items continue and renew with their subscriptions again; a subscription's automatic renewal, turned off when the cancellation covered all of its continuing items, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the items' current billing account and to members of their project with the project permission `billing:finance.manage`.
  * @summary Withdraw a cancellation
  */
-export const withdrawCancellation = async (cancellationId, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getWithdrawCancellationUrl(cancellationId), {
+export const deleteCancellation = async (cancellationId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteCancellationUrl(cancellationId), {
         ...options,
         method: "DELETE",
     });
@@ -1522,7 +1563,7 @@ export const withdrawCancellation = async (cancellationId, options, fetchFn) =>
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getListRenewalPricesUrl = (subscriptionId, params) => {
+export const getListRenewalOptionsUrl = (subscriptionId, params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -1531,15 +1572,15 @@ export const getListRenewalPricesUrl = (subscriptionId, params) => {
     });
     const stringifiedParams = normalizedParams.toString();
     return stringifiedParams.length > 0
-        ? `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renewal-prices?${stringifiedParams}`
-        : `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renewal-prices`;
+        ? `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renewal-options?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/renewal-options`;
 };
 /**
- * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax. Open to the owner of the subscription's current billing account and to members of its project.
- * @summary List the terms this item can be renewed for
+ * The current agreement first, then each other term every continuing licensed item sells in the subscription's currency. The current option keeps each item's recurring_amount; other options use current prices, each item taking the price of that term with its own cancellation policy, or the only price of that term. Amounts exclude tax and discounts. Open to the owner of the subscription's current billing account and to members of its project.
+ * @summary List the terms the subscription can be renewed for
  */
-export const listRenewalPrices = async (subscriptionId, params, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getListRenewalPricesUrl(subscriptionId, params), {
+export const listRenewalOptions = async (subscriptionId, params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListRenewalOptionsUrl(subscriptionId, params), {
         ...options,
         method: "GET",
     });
@@ -1551,13 +1592,16 @@ export const getRenewSubscriptionUrl = (subscriptionId) => {
     return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}:renew`;
 };
 /**
- * Buys licensed periods from current_term_end at the agreed recurring amount and pays for them at once. A
- * different interval selects the price currently sold for it and fixes new terms on the order, applied after
- * fulfillment. Paid periods keep their value.
+ * Buys further periods for the whole subscription from current_term_end and pays for them at once: every
+ * continuing licensed item renews, at its agreed recurring amount or, with a different interval, at the price each
+ * item currently sells that term for, and the new terms are fixed on the order. Items with an open cancellation end
+ * with the current term and are left out. Paid periods keep their value. A trialing subscription converts to paid
+ * this way; renewed after its trial expired, its first paid period starts at payment.
  *
  * Without `payment_method_id`, the renewal is paid from credit grants and balance as `use_credits` and
  * `use_balance` allow; when they cannot cover it, the request fails with `BILLING_INSUFFICIENT_FUNDS` and no
- * order is left. To apply a promotion code or pay later, create a renewal Checkout Session.
+ * order is left. To apply a promotion code, pay later, or renew several subscriptions in one order, create a
+ * renewal Checkout Session.
  *
  * Open to the owner of the subscription's current billing account and to members of its project with the
  * project permission `billing:finance.manage`. Only the owner can pay with `payment_method_id`.
@@ -1591,39 +1635,6 @@ export const renewSubscription = async (subscriptionId, renewRequest, options, f
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getSetAutoRenewUrl = (subscriptionId) => {
-    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/auto-renew`;
-};
-/**
- * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its project with the project permission `billing:finance.manage`.
- * @summary Set auto renew
- */
-export const setAutoRenew = async (subscriptionId, autoRenewSet, 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)(getSetAutoRenewUrl(subscriptionId), {
-        ...options,
-        method: "PUT",
-        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(autoRenewSet),
-    });
-    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 getListAllowancesUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -1662,7 +1673,8 @@ export const getListCheckoutSessionsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/checkout-sessions`;
 };
 /**
- * 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 const listCheckoutSessions = async (params, options, fetchFn) => {
@@ -1678,13 +1690,15 @@ export const getCreateCheckoutSessionUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions`;
 };
 /**
- * Opens a Checkout Session renewing a licensed subscription, with periods and price chosen as in
- * renewing. Nothing is charged until you complete it, when a promotion code can be applied; it then renews from
- * the subscription's current_term_end at that time. To renew 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.
+ * 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; 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 subscription's current billing account and to members of its project with the
+ * 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
  * unknown outcome; creating it again conflicts.
  * @summary Create a renewal Checkout Session
@@ -1715,40 +1729,65 @@ export const createCheckoutSession = async (checkoutSessionCreate, options, fetc
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getGetCheckoutSessionUrl = (checkoutSessionId) => {
-    return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}`;
+export const getPreviewCheckoutSessionUrl = () => {
+    return `https://billing.leaflow.cloud/api/v1/checkout-sessions:preview`;
 };
 /**
- * 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 const getCheckoutSession = async (checkoutSessionId, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getGetCheckoutSessionUrl(checkoutSessionId), {
+export const previewCheckoutSession = async (checkoutSessionPreviewRequest, 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)(getPreviewCheckoutSessionUrl(), {
         ...options,
-        method: "GET",
+        method: "QUERY",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(checkoutSessionPreviewRequest),
     });
     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 getListCheckoutSessionItemsUrl = (checkoutSessionId, 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/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/items?${stringifiedParams}`
-        : `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/items`;
+export const getGetCheckoutSessionUrl = (checkoutSessionId) => {
+    return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}`;
 };
 /**
- * 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 const listCheckoutSessionItems = async (checkoutSessionId, params, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getListCheckoutSessionItemsUrl(checkoutSessionId, params), {
+export const getCheckoutSession = async (checkoutSessionId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetCheckoutSessionUrl(checkoutSessionId), {
         ...options,
         method: "GET",
     });
@@ -1756,35 +1795,45 @@ export const listCheckoutSessionItems = async (checkoutSessionId, params, option
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getGetCheckoutSessionQuoteUrl = (checkoutSessionId, 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/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/quote?${stringifiedParams}`
-        : `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}/quote`;
+export const getUpdateCheckoutSessionUrl = (checkoutSessionId) => {
+    return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}`;
 };
 /**
- * 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 const getCheckoutSessionQuote = async (checkoutSessionId, params, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getGetCheckoutSessionQuoteUrl(checkoutSessionId, params), {
+export const updateCheckoutSession = async (checkoutSessionId, checkoutSessionUpdate, 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)(getUpdateCheckoutSessionUrl(checkoutSessionId), {
         ...options,
-        method: "GET",
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(checkoutSessionUpdate),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};
@@ -1794,11 +1843,13 @@ export const getConfirmCheckoutSessionUrl = (checkoutSessionId) => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}:confirm`;
 };
 /**
- * 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`.
@@ -1837,7 +1888,9 @@ export const getExpireCheckoutSessionUrl = (checkoutSessionId) => {
     return `https://billing.leaflow.cloud/api/v1/checkout-sessions/${encodeURIComponent(String(checkoutSessionId))}:expire`;
 };
 /**
- * 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 const expireCheckoutSession = async (checkoutSessionId, options, fetchFn) => {
@@ -1929,7 +1982,7 @@ export const getCancelOrderUrl = (orderId) => {
  * payment waiting for the payer is canceled with the order; one the gateway is processing is refused with
  * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`. Repeating the cancellation does not refund twice.
  *
- * An accepted order is canceled by its owning service, and delivered items through subscription cancellation.
+ * An accepted order is canceled by its owning service, and delivered items through cancellation of their subscription items.
  * Refunds are previewed with `preview-order-refund`. Open to the owner of the order's billing account and to members of its project.
  * @summary Cancel order
  */