@leaflow/sdk 0.213.1 → 0.214.0

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

@@ -7,21 +7,9 @@ export const RefundPolicy = {
     prorated: "prorated",
     short_rate: "short_rate",
 };
-export const QuoteRenewalInterval = {
-    day: "day",
-    month: "month",
-    year: "year",
-};
-export const QuoteRenewalResultInterval = {
-    day: "day",
-    month: "month",
-    year: "year",
-};
-export const QuoteItemInterval = {
-    none: "none",
-    day: "day",
-    month: "month",
-    year: "year",
+export const CancellationMode = {
+    immediate: "immediate",
+    period_end: "period_end",
 };
 export const PriceType = {
     one_time: "one_time",
@@ -31,27 +19,6 @@ export const UsageType = {
     licensed: "licensed",
     metered: "metered",
 };
-export const QuoteTaxStatus = {
-    complete: "complete",
-    requires_location_inputs: "requires_location_inputs",
-};
-export const QuotedDiscountType = {
-    promotion_code: "promotion_code",
-    account_discount: "account_discount",
-};
-export const QuotedDiscountFrequency = {
-    once: "once",
-    recurring: "recurring",
-    forever: "forever",
-};
-export const QuotedDiscountEligibility = {
-    confirmed: "confirmed",
-    unverified: "unverified",
-};
-export const CancellationMode = {
-    immediate: "immediate",
-    period_end: "period_end",
-};
 export const CancellationStatus = {
     requested: "requested",
     scheduled: "scheduled",
@@ -277,10 +244,66 @@ export const CheckoutSessionChangeEffective = {
     immediate: "immediate",
     period_end: "period_end",
 };
+export const CheckoutSessionTaxStatus = {
+    complete: "complete",
+    requires_location_inputs: "requires_location_inputs",
+};
 export const CheckoutMode = {
     automatic: "automatic",
     deferred: "deferred",
 };
+export const CheckoutSessionDiscountType = {
+    promotion_code: "promotion_code",
+    account_discount: "account_discount",
+};
+export const CheckoutSessionDiscountFrequency = {
+    once: "once",
+    recurring: "recurring",
+    forever: "forever",
+};
+export const CheckoutSessionDiscountEligibility = {
+    confirmed: "confirmed",
+    unverified: "unverified",
+};
+export const TrialGrantStatus = {
+    scheduled: "scheduled",
+    available: "available",
+    redeemed: "redeemed",
+    expired: "expired",
+    voided: "voided",
+};
+export const CheckoutSessionSubscriptionInterval = {
+    none: "none",
+    day: "day",
+    month: "month",
+    year: "year",
+};
+export const CheckoutSessionItemInterval = {
+    none: "none",
+    day: "day",
+    month: "month",
+    year: "year",
+};
+export const CheckoutSessionPreviewRequestType = {
+    new: "new",
+    renew: "renew",
+    modify: "modify",
+};
+export const CheckoutSessionPreviewRequestChangeEffective = {
+    immediate: "immediate",
+    period_end: "period_end",
+};
+export const CheckoutSessionPreviewRequestInterval = {
+    day: "day",
+    month: "month",
+    year: "year",
+};
+export const CheckoutSessionItemInputInterval = {
+    none: "none",
+    day: "day",
+    month: "month",
+    year: "year",
+};
 export const CheckoutSessionCreateInterval = {
     day: "day",
     month: "month",
@@ -363,28 +386,12 @@ export const RateTiersMode = {
     graduated: "graduated",
     volume: "volume",
 };
-export const QuoteItemInputInterval = {
-    none: "none",
-    day: "day",
-    month: "month",
-    year: "year",
-};
 export const ActiveResourceStatus = {
     active: "active",
     suspended: "suspended",
     closing: "closing",
     closed: "closed",
 };
-export const QuoteRequestChangeEffective = {
-    immediate: "immediate",
-    period_end: "period_end",
-};
-export const QuoteChangeInputInterval = {
-    none: "none",
-    day: "day",
-    month: "month",
-    year: "year",
-};
 export const WithdrawalItemStatus = {
     pending: "pending",
     succeeded: "succeeded",

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

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";
@@ -138,7 +138,7 @@ export declare const DeleteContactParams: zod.ZodObject<{
     contactId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
- * 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 listCurrenciesQueryPageDefault = 1;
@@ -542,6 +542,36 @@ export declare const ListAccountDiscountsQueryParams: zod.ZodObject<{
         voided: "voided";
     }>>>;
 }, zod.z.core.$strict>;
+/**
+ * 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 listTrialGrantsQueryPageDefault = 1;
+export declare const listTrialGrantsQueryPageMax = 2147483647;
+export declare const listTrialGrantsQueryPageSizeDefault = 50;
+export declare const listTrialGrantsQueryPageSizeMax = 200;
+export declare const listTrialGrantsQueryStatusMax = 5;
+export declare const ListTrialGrantsQueryParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    status: zod.ZodOptional<zod.ZodArray<zod.ZodEnum<{
+        scheduled: "scheduled";
+        available: "available";
+        expired: "expired";
+        voided: "voided";
+        redeemed: "redeemed";
+    }>>>;
+}, zod.z.core.$strict>;
+/**
+ * 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 GetTrialGrantParams: zod.ZodObject<{
+    trialGrantId: zod.ZodUUID;
+}, zod.z.core.$strict>;
 /**
  * Credit grants with what remains and what each may pay for. Credit is spent before balance and cannot be withdrawn.
  * @summary List credit grants
@@ -776,8 +806,9 @@ export declare const ListCancellationsQueryParams: zod.ZodObject<{
  *
  * `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:
  *
@@ -906,7 +937,8 @@ export declare const ListAllowancesQueryParams: zod.ZodObject<{
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, zod.z.core.$strict>;
 /**
- * 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 listCheckoutSessionsQueryPageDefault = 1;
@@ -930,9 +962,10 @@ export declare const ListCheckoutSessionsQueryParams: zod.ZodObject<{
  * 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
@@ -957,53 +990,47 @@ export declare const CreateCheckoutSessionBody: zod.ZodObject<{
     }>>;
 }, zod.z.core.$strict>;
 /**
- * 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.
+ * 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 GetCheckoutSessionParams: zod.ZodObject<{
     checkoutSessionId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
- * 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
- */
-export declare const ListCheckoutSessionItemsParams: zod.ZodObject<{
-    checkoutSessionId: zod.ZodUUID;
-}, zod.z.core.$strict>;
-export declare const listCheckoutSessionItemsQueryPageDefault = 1;
-export declare const listCheckoutSessionItemsQueryPageMax = 2147483647;
-export declare const listCheckoutSessionItemsQueryPageSizeDefault = 50;
-export declare const listCheckoutSessionItemsQueryPageSizeMax = 200;
-export declare const ListCheckoutSessionItemsQueryParams: zod.ZodObject<{
-    page: zod.ZodDefault<zod.ZodInt>;
-    page_size: zod.ZodDefault<zod.ZodInt>;
-}, zod.z.core.$strict>;
-/**
- * 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 GetCheckoutSessionQuoteParams: zod.ZodObject<{
+export declare const UpdateCheckoutSessionParams: zod.ZodObject<{
     checkoutSessionId: zod.ZodUUID;
 }, zod.z.core.$strict>;
-export declare const getCheckoutSessionQuoteQueryPromotionCodeMax = 64;
-export declare const GetCheckoutSessionQuoteQueryParams: zod.ZodObject<{
-    promotion_code: zod.ZodOptional<zod.ZodString>;
+export declare const UpdateCheckoutSessionBody: zod.ZodObject<{
+    promotion_code: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    trial_grant_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    auto_renew: zod.ZodOptional<zod.ZodBoolean>;
 }, zod.z.core.$strict>;
 /**
- * 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`.
@@ -1016,12 +1043,13 @@ export declare const ConfirmCheckoutSessionParams: zod.ZodObject<{
     checkoutSessionId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 export declare const ConfirmCheckoutSessionBody: zod.ZodObject<{
-    promotion_code: zod.ZodOptional<zod.ZodString>;
     expected_amount: zod.ZodIntersection<zod.ZodString, zod.ZodString>;
     proration_date: zod.ZodOptional<zod.z.ZodISODateTime>;
 }, zod.z.core.$strict>;
 /**
- * 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 ExpireCheckoutSessionParams: zod.ZodObject<{

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

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";
@@ -16,6 +16,7 @@ import { CancellationCreate } from "./validators/cancellationCreate.zod.js";
 import { CheckoutSessionConfirm } from "./validators/checkoutSessionConfirm.zod.js";
 import { CheckoutSessionCreate } from "./validators/checkoutSessionCreate.zod.js";
 import { CheckoutSessionStatus } from "./validators/checkoutSessionStatus.zod.js";
+import { CheckoutSessionUpdate } from "./validators/checkoutSessionUpdate.zod.js";
 import { ContactCreate } from "./validators/contactCreate.zod.js";
 import { ContactUpdate } from "./validators/contactUpdate.zod.js";
 import { CreditGrantStatus } from "./validators/creditGrantStatus.zod.js";
@@ -38,6 +39,7 @@ import { TopUpCreate } from "./validators/topUpCreate.zod.js";
 import { TopUpStatus } from "./validators/topUpStatus.zod.js";
 import { TransactionStatus } from "./validators/transactionStatus.zod.js";
 import { TransactionType } from "./validators/transactionType.zod.js";
+import { TrialGrantStatus } from "./validators/trialGrantStatus.zod.js";
 import { WithdrawalCreate } from "./validators/withdrawalCreate.zod.js";
 import { WithdrawalStatus } from "./validators/withdrawalStatus.zod.js";
 /**
@@ -166,7 +168,7 @@ export const DeleteContactParams = zod.strictObject({
     contactId: zod.uuid(),
 });
 /**
- * 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 listCurrenciesQueryPageDefault = 1;
@@ -672,6 +674,48 @@ export const ListAccountDiscountsQueryParams = zod.strictObject({
         .optional()
         .describe("Only discounts in these statuses; omit for every status. Comma-separated, for example `status=scheduled,active`."),
 });
+/**
+ * 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 listTrialGrantsQueryPageDefault = 1;
+export const listTrialGrantsQueryPageMax = 2147483647;
+export const listTrialGrantsQueryPageSizeDefault = 50;
+export const listTrialGrantsQueryPageSizeMax = 200;
+export const listTrialGrantsQueryStatusMax = 5;
+export const ListTrialGrantsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listTrialGrantsQueryPageMax)
+        .default(listTrialGrantsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listTrialGrantsQueryPageSizeMax)
+        .default(listTrialGrantsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Only this account; all of yours when omitted."),
+    status: zod
+        .array(TrialGrantStatus)
+        .min(1)
+        .max(listTrialGrantsQueryStatusMax)
+        .optional()
+        .describe("Only grants in these statuses; omit for every status. Comma-separated, for example `status=available,scheduled`."),
+});
+/**
+ * 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 GetTrialGrantParams = zod.strictObject({
+    trialGrantId: zod.uuid(),
+});
 /**
  * Credit grants with what remains and what each may pay for. Credit is spent before balance and cannot be withdrawn.
  * @summary List credit grants
@@ -1018,8 +1062,9 @@ export const ListCancellationsQueryParams = zod.strictObject({
  *
  * `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:
  *
@@ -1154,7 +1199,8 @@ export const ListAllowancesQueryParams = zod.strictObject({
         .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * 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 listCheckoutSessionsQueryPageDefault = 1;
@@ -1197,9 +1243,10 @@ export const ListCheckoutSessionsQueryParams = zod.strictObject({
  * 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
@@ -1208,63 +1255,43 @@ export const ListCheckoutSessionsQueryParams = zod.strictObject({
  */
 export const CreateCheckoutSessionBody = CheckoutSessionCreate;
 /**
- * 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.
+ * 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 GetCheckoutSessionParams = zod.strictObject({
     checkoutSessionId: zod.uuid(),
 });
 /**
- * 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
- */
-export const ListCheckoutSessionItemsParams = zod.strictObject({
-    checkoutSessionId: zod.uuid(),
-});
-export const listCheckoutSessionItemsQueryPageDefault = 1;
-export const listCheckoutSessionItemsQueryPageMax = 2147483647;
-export const listCheckoutSessionItemsQueryPageSizeDefault = 50;
-export const listCheckoutSessionItemsQueryPageSizeMax = 200;
-export const ListCheckoutSessionItemsQueryParams = zod.strictObject({
-    page: zod
-        .int()
-        .min(1)
-        .max(listCheckoutSessionItemsQueryPageMax)
-        .default(listCheckoutSessionItemsQueryPageDefault)
-        .describe("1-based page number. Defaults to 1."),
-    page_size: zod
-        .int()
-        .min(1)
-        .max(listCheckoutSessionItemsQueryPageSizeMax)
-        .default(listCheckoutSessionItemsQueryPageSizeDefault)
-        .describe("Items per page. Defaults to 50; at most 200."),
-});
-/**
- * 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 GetCheckoutSessionQuoteParams = zod.strictObject({
+export const UpdateCheckoutSessionParams = zod.strictObject({
     checkoutSessionId: zod.uuid(),
 });
-export const getCheckoutSessionQuoteQueryPromotionCodeMax = 64;
-export const GetCheckoutSessionQuoteQueryParams = zod.strictObject({
-    promotion_code: zod.string().min(1).max(getCheckoutSessionQuoteQueryPromotionCodeMax).optional(),
-});
+export const UpdateCheckoutSessionBody = CheckoutSessionUpdate;
 /**
- * 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`.
@@ -1278,7 +1305,9 @@ export const ConfirmCheckoutSessionParams = zod.strictObject({
 });
 export const ConfirmCheckoutSessionBody = CheckoutSessionConfirm;
 /**
- * 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 ExpireCheckoutSessionParams = zod.strictObject({

package/dist/billing/v1/generated/validators/accountBalance.zod.d.ts

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";

package/dist/billing/v1/generated/validators/accountBalance.zod.js

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";

package/dist/billing/v1/generated/validators/accountDeletionObjection.zod.d.ts

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";

package/dist/billing/v1/generated/validators/accountDeletionObjection.zod.js

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";

package/dist/billing/v1/generated/validators/accountDeletionReadiness.zod.d.ts

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";

package/dist/billing/v1/generated/validators/accountDeletionReadiness.zod.js

@@ -2,7 +2,7 @@
  * 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 * as zod from "zod";