@leaflow/sdk 0.213.1 → 0.215.0

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

@@ -2,42 +2,77 @@
  * 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";
 import { AccountIdentity } from "./accountIdentity.zod.js";
 import { CheckoutOptions } from "./checkoutOptions.zod.js";
+import { CheckoutSessionDiscount } from "./checkoutSessionDiscount.zod.js";
 import { CheckoutSessionStatus } from "./checkoutSessionStatus.zod.js";
 import { CheckoutSessionSubscription } from "./checkoutSessionSubscription.zod.js";
+import { Funds } from "./funds.zod.js";
+import { Money } from "./money.zod.js";
 import { NamedIdentity } from "./namedIdentity.zod.js";
 import { ProductId } from "./productId.zod.js";
+import { TrialGrant } from "./trialGrant.zod.js";
 export const CheckoutSession = zod
     .strictObject({
-    id: zod.uuid(),
+    id: zod.uuid().nullable().describe("Null in a preview."),
     product_id: ProductId,
-    billing_account_id: zod.int(),
-    account: AccountIdentity,
+    billing_account_id: zod.int().nullable().describe("Null in a preview without an account."),
+    account: zod
+        .union([AccountIdentity, zod.null()])
+        .describe("Null in a preview without an account."),
     project_id: zod
         .uuid()
         .nullable()
-        .describe("The project the purchase is for. Null for an account-level purchase, such as a membership."),
+        .describe("The project the purchase is for. Null for an account-level purchase, such as a membership, and in a preview."),
     project: zod
         .union([NamedIdentity, zod.null()])
-        .describe("The project and its current name. Null for an account-level purchase or when the project cannot be read; `project_id` still identifies it."),
+        .describe("The project and its current name. Null when `project_id` is, or when the project cannot be read;\n`project_id` still identifies it."),
     type: zod
         .enum(["new", "renew", "modify"])
-        .describe("`new` buys, `renew` extends subscriptions, `modify` changes subscription items' configuration or billing terms."),
+        .describe('"`new` buys, `renew` extends subscriptions, `modify` changes subscription items\' configuration or\nbilling terms."'),
     change_effective: zod
         .enum(["none", "immediate", "period_end"])
         .describe("When a change takes effect, as on the order it creates; `none` for anything that is not a change."),
-    status: CheckoutSessionStatus,
+    status: CheckoutSessionStatus.describe("`open` in a preview."),
     currency: zod.string(),
-    checkout: CheckoutOptions.describe("The checkout choices as the purchase gave them. Billing does not check `return_url`; validate it before navigating."),
+    checkout: CheckoutOptions.describe("The checkout choices, as the purchase gave them and as you saved them since. Billing does not check\n`return_url`; validate it before navigating."),
+    promotion_code: zod
+        .string()
+        .nullable()
+        .describe("The promotion code saved on the session, or used to complete it; null without one."),
+    discount: zod
+        .union([CheckoutSessionDiscount, zod.null()])
+        .describe("The discount the session gets, from its promotion code or otherwise the best applicable account discount. Null when there is none, and for an expired session."),
+    subtotal: zod
+        .union([Money, zod.null()])
+        .describe("Sum before discounts, excluding tax already included in the item amounts."),
+    discount_amount: zod.union([Money, zod.null()]).describe("Total item discounts."),
+    tax_amount: zod.union([Money, zod.null()]).describe("Total tax on the discounted amounts."),
+    total: zod
+        .union([Money, zod.null()])
+        .describe("subtotal minus discount_amount plus tax_amount, before credit grants and balance. Confirm an open session with it as `expected_amount`."),
+    tax_status: zod
+        .enum(["complete", "requires_location_inputs"])
+        .describe('"`complete`: tax is calculated for the billing account\'s invoice contact, or for `address` in a preview\nwithout an account. `requires_location_inputs`: a preview without an account or `address`, which leaves out\ntax that would be added; tax already contained in a price is included."'),
+    proration_date: zod.iso
+        .datetime({ offset: true })
+        .nullable()
+        .describe("Immediate changes and items added to an existing subscription of an open session only; null otherwise.\nThe instant they are priced from; confirm the session with it so it is priced from the same instant."),
+    funds: zod
+        .union([Funds, zod.null()])
+        .describe("Account funds for completing an open session; null for other sessions and without an account."),
+    trial_grants: zod
+        .array(TrialGrant)
+        .describe("The free trial grants of the account that the session can use now, soonest to expire first. Empty for a\nsession that is not open, without an account, and for changes and renewals."),
     expires_at: zod.iso
         .datetime({ offset: true })
-        .describe("When an open session expires. The order a complete session created has its own payment deadline."),
-    created_at: zod.iso.datetime({ offset: true }),
+        .nullable()
+        .describe("When an open session expires; null in a preview. The order a complete session created has its own payment deadline."),
+    created_at: zod.iso.datetime({ offset: true }).nullable().describe("Null in a preview."),
     completed_at: zod.iso.datetime({ offset: true }).nullable(),
     expired_at: zod.iso.datetime({ offset: true }).nullable(),
     order_id: zod
@@ -46,6 +81,6 @@ export const CheckoutSession = zod
         .describe("The order created when the session completed. Null otherwise."),
     subscriptions: zod
         .array(CheckoutSessionSubscription)
-        .describe("The subscriptions the session buys, renews or changes, in order; each item names its entry in `subscription_index`."),
+        .describe("The subscriptions the session buys, renews or changes, in order, each with its items."),
 })
-    .describe("A purchase waiting for you to complete checkout. Completing it applies the discount and creates the order with its invoice issued; the order carries the session's ID.");
+    .describe("A purchase, a change of subscriptions or their renewal, waiting for checkout to be completed, and what\ncompleting it invoices. Completing it applies the choices saved on it and creates the order with its invoice\nissued; the order carries the session's ID. A preview returns the same object without saving it.\n\nAmounts are what completing an open session would invoice at the time it is read, and for a complete session\nthose of its order's invoice. An expired session has no amounts; they are null.");

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

@@ -2,14 +2,12 @@
  * 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";
-export declare const checkoutSessionConfirmPromotionCodeMax = 64;
 export declare const checkoutSessionConfirmExpectedAmountTwoRegExp: RegExp;
 export declare const CheckoutSessionConfirm: 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>;

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

@@ -2,23 +2,16 @@
  * 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";
 import { Money } from "./money.zod.js";
-export const checkoutSessionConfirmPromotionCodeMax = 64;
 export const checkoutSessionConfirmExpectedAmountTwoRegExp = new RegExp("^[0-9]{1,15}([.][0-9]{1,10})?$");
 export const CheckoutSessionConfirm = zod.strictObject({
-    promotion_code: zod
-        .string()
-        .min(1)
-        .max(checkoutSessionConfirmPromotionCodeMax)
-        .optional()
-        .describe("As quoted. Omit to apply the best applicable account discount."),
-    expected_amount: Money.and(zod.string().regex(checkoutSessionConfirmExpectedAmountTwoRegExp)).describe("The quote's `total`, after discounts and tax and before credit grants or balance."),
+    expected_amount: Money.and(zod.string().regex(checkoutSessionConfirmExpectedAmountTwoRegExp)).describe("The session's `total` as read, after discounts and tax and before credit grants or balance."),
     proration_date: zod.iso
         .datetime({ offset: true })
         .optional()
-        .describe("Immediate changes only. The quote's `proration_date`; it must be a whole second, not in the future and at most 10 minutes old, otherwise the request is refused with `BILLING_CHANGE_INVALID`. Defaults to the time of the request."),
+        .describe("Immediate changes and items added to an existing subscription only. The session's `proration_date` as\nread; it must be a whole second, not in the future and at most 10 minutes old, otherwise the request is\nrefused with `BILLING_CHANGE_INVALID`. Defaults to the time of the request."),
 });

package/dist/billing/v1/generated/validators/checkoutSessionCreate.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/checkoutSessionCreate.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/checkoutSessionDiscount.zod.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 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";
+export declare const checkoutSessionDiscountPromotionCodeMax = 64;
+export declare const CheckoutSessionDiscount: zod.ZodObject<{
+    type: zod.ZodEnum<{
+        promotion_code: "promotion_code";
+        account_discount: "account_discount";
+    }>;
+    name: zod.ZodString;
+    promotion_code: zod.ZodNullable<zod.ZodString>;
+    frequency: zod.ZodEnum<{
+        recurring: "recurring";
+        once: "once";
+        forever: "forever";
+    }>;
+    frequency_duration: zod.ZodNullable<zod.ZodInt>;
+    eligibility: zod.ZodEnum<{
+        confirmed: "confirmed";
+        unverified: "unverified";
+    }>;
+}, zod.z.core.$strict>;
+export type CheckoutSessionDiscount = zod.input<typeof CheckoutSessionDiscount>;
+export type CheckoutSessionDiscountOutput = zod.output<typeof CheckoutSessionDiscount>;

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

@@ -0,0 +1,32 @@
+/**
+ * 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 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";
+export const checkoutSessionDiscountPromotionCodeMax = 64;
+export const CheckoutSessionDiscount = zod
+    .strictObject({
+    type: zod.enum(["promotion_code", "account_discount"]),
+    name: zod.string(),
+    promotion_code: zod
+        .string()
+        .min(1)
+        .max(checkoutSessionDiscountPromotionCodeMax)
+        .nullable()
+        .describe("Code text for a promotion_code discount; null for an account_discount."),
+    frequency: zod
+        .enum(["once", "recurring", "forever"])
+        .describe('"Whether the discount continues on renewals of what is bought: `once` applies only to this\npurchase, `recurring` for `frequency_duration` periods including the first, `forever` on every renewal."'),
+    frequency_duration: zod
+        .int()
+        .min(1)
+        .nullable()
+        .describe("For `recurring`, the periods the discount lasts; null otherwise."),
+    eligibility: zod
+        .enum(["confirmed", "unverified"])
+        .describe('"`confirmed`: every condition of the discount holds for the billing account. `unverified`: a preview\nwithout an account, where conditions that depend on the account, such as a first purchase or a per-account\nlimit, are checked only when a session is completed."'),
+})
+    .describe("The discount a session gets. It is redeemed only when the session completes.");

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

@@ -2,22 +2,55 @@
  * 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";
 export declare const checkoutSessionItemPositionMin = 0;
-export declare const checkoutSessionItemSubscriptionIndexMin = 0;
 export declare const CheckoutSessionItem: zod.ZodObject<{
     position: zod.ZodInt;
+    subscription_item_id: zod.ZodNullable<zod.ZodUUID>;
+    product_id: zod.ZodString;
     plan_id: zod.ZodUUID;
     plan_name: zod.ZodString;
     price_id: zod.ZodNullable<zod.ZodUUID>;
+    type: zod.ZodUnion<readonly [zod.ZodEnum<{
+        one_time: "one_time";
+        recurring: "recurring";
+    }>, zod.ZodNull]>;
+    usage_type: zod.ZodUnion<readonly [zod.ZodEnum<{
+        licensed: "licensed";
+        metered: "metered";
+    }>, zod.ZodNull]>;
+    interval: zod.ZodEnum<{
+        none: "none";
+        day: "day";
+        month: "month";
+        year: "year";
+    }>;
+    interval_count: zod.ZodNullable<zod.ZodInt>;
     quantity: zod.ZodString;
     dimensions: zod.ZodRecord<zod.ZodString, zod.ZodString>;
-    subscription_index: zod.ZodInt;
-    subscription_item_id: zod.ZodNullable<zod.ZodUUID>;
     periods: zod.ZodNullable<zod.ZodInt>;
+    unit_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    setup_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    recurring_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    discount_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    coupon: zod.ZodUnion<readonly [zod.ZodObject<{
+        lookup_key: zod.ZodOptional<zod.ZodString>;
+        id: zod.ZodUUID;
+        name: zod.ZodString;
+    }, zod.z.core.$strict>, zod.ZodNull]>;
+    tax_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    tax_included_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    total: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    remaining_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    unused_amount: zod.ZodUnion<readonly [zod.ZodString, zod.ZodNull]>;
+    downgrade_refund: zod.ZodUnion<readonly [zod.ZodObject<{
+        refundable_amount: zod.ZodString;
+        forfeited_amount: zod.ZodString;
+    }, zod.z.core.$strict>, zod.ZodNull]>;
 }, zod.z.core.$strict>;
 export type CheckoutSessionItem = zod.input<typeof CheckoutSessionItem>;
 export type CheckoutSessionItemOutput = zod.output<typeof CheckoutSessionItem>;

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

@@ -2,37 +2,90 @@
  * 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";
+import { CheckoutSessionItemDowngradeRefund } from "./checkoutSessionItemDowngradeRefund.zod.js";
+import { Money } from "./money.zod.js";
+import { ObjectIdentity } from "./objectIdentity.zod.js";
+import { PriceType } from "./priceType.zod.js";
+import { ProductId } from "./productId.zod.js";
+import { UsageType } from "./usageType.zod.js";
 export const checkoutSessionItemPositionMin = 0;
-export const checkoutSessionItemSubscriptionIndexMin = 0;
 export const CheckoutSessionItem = zod
     .strictObject({
-    position: zod.int().min(checkoutSessionItemPositionMin),
+    position: zod
+        .int()
+        .min(checkoutSessionItemPositionMin)
+        .describe("Counted across the session's subscriptions in order, starting from zero."),
+    subscription_item_id: zod
+        .uuid()
+        .nullable()
+        .describe("The subscription item changed or renewed. Null for an item the purchase adds."),
+    product_id: ProductId,
     plan_id: zod.uuid(),
     plan_name: zod.string(),
     price_id: zod
         .uuid()
         .nullable()
-        .describe("The price the item named. Null when Billing selects it by billing terms or from the subscription being changed or renewed."),
+        .describe("The price the item is charged under: the one it named, or the one selected by billing terms or from the\nsubscription item changed or renewed. Null for an expired session whose item did not name one."),
+    type: zod.union([PriceType, zod.null()]).describe("The price type; null when `price_id` is."),
+    usage_type: zod
+        .union([UsageType, zod.null()])
+        .describe("The usage type; null when `price_id` is."),
+    interval: zod
+        .enum(["none", "day", "month", "year"])
+        .describe("The billing period of a recurring licensed price; `none` otherwise, and when `price_id` is null."),
+    interval_count: zod
+        .int()
+        .min(1)
+        .nullable()
+        .describe("Periods per billing cycle of a recurring licensed price; null otherwise."),
     quantity: zod.string(),
     dimensions: zod
         .record(zod.string(), zod.string())
         .describe("The dimension values of what is bought, such as region and instance type."),
-    subscription_index: zod
-        .int()
-        .min(checkoutSessionItemSubscriptionIndexMin)
-        .describe("The item's subscription, as its index in the session's `subscriptions`."),
-    subscription_item_id: zod
-        .uuid()
-        .nullable()
-        .describe("The subscription item changed or renewed. Null for an item the purchase adds."),
     periods: zod
         .int()
         .min(1)
         .nullable()
         .describe("Renewals only; null otherwise. How many consecutive periods are renewed."),
+    unit_amount: zod
+        .union([Money, zod.null()])
+        .describe("Unit price before discounts. Null when no single unit price applies, such as tiered or multiple-rate pricing."),
+    setup_amount: zod
+        .union([Money, zod.null()])
+        .describe("The setup charge already included in `amount`; null when none applies."),
+    recurring_amount: zod
+        .union([Money, zod.null()])
+        .describe("Recurring licensed items only; null otherwise. What each later period renews at, before discounts and\ntax, which differs from `amount` when the first period is priced differently, such as in a free trial. The\nsession's `discount` says whether its discount continues on renewals."),
+    amount: zod
+        .union([Money, zod.null()])
+        .describe("Amount before discounts, including any setup charge."),
+    discount_amount: zod
+        .union([Money, zod.null()])
+        .describe("Total reduction on this item, including any continuing renewal discount."),
+    coupon: zod
+        .union([ObjectIdentity, zod.null()])
+        .describe("The coupon behind `discount_amount`, so the discount can be named: the one this checkout applies, or on\na renewal the one continuing from the purchase that first used it. Null when the item has no coupon\ndiscount."),
+    tax_amount: zod
+        .union([Money, zod.null()])
+        .describe("Tax on the discounted amount, including any tax already contained in that amount."),
+    tax_included_amount: zod
+        .union([Money, zod.null()])
+        .describe("The part of tax_amount already contained in amount minus discount_amount."),
+    total: zod
+        .union([Money, zod.null()])
+        .describe("amount minus discount_amount plus tax_amount minus tax_included_amount."),
+    remaining_amount: zod
+        .union([Money, zod.null()])
+        .describe("Immediate changes only; null otherwise. Before tax, the new terms for the time from `proration_date` to\nthe end of the paid period. An upgrade invoices `remaining_amount` minus `unused_amount`."),
+    unused_amount: zod
+        .union([Money, zod.null()])
+        .describe("Immediate changes only; null otherwise. Before tax, for an upgrade or an unchanged period price, the\namount paid for that time, up to the new terms' value for the same time; for a downgrade, the remaining value\nof what was paid, under the refund terms of each paid period."),
+    downgrade_refund: zod
+        .union([CheckoutSessionItemDowngradeRefund, zod.null()])
+        .describe("Immediate downgrades only, when `unused_amount` exceeds `remaining_amount`; null otherwise."),
 })
-    .describe("One item of the session. It becomes the order item at the same position; its price is chosen when checkout completes.");
+    .describe("One item of the session; it becomes the order item at the same position. Its price is selected as when\ncheckout completes, and amounts are this item's share of the session's.");

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

@@ -0,0 +1,14 @@
+/**
+ * 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 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";
+export declare const CheckoutSessionItemDowngradeRefund: zod.ZodObject<{
+    refundable_amount: zod.ZodString;
+    forfeited_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type CheckoutSessionItemDowngradeRefund = zod.input<typeof CheckoutSessionItemDowngradeRefund>;
+export type CheckoutSessionItemDowngradeRefundOutput = zod.output<typeof CheckoutSessionItemDowngradeRefund>;

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

@@ -0,0 +1,15 @@
+/**
+ * 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 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";
+import { Money } from "./money.zod.js";
+export const CheckoutSessionItemDowngradeRefund = zod
+    .strictObject({
+    refundable_amount: Money.describe("Returned to the original payment sources, tax paid on it included."),
+    forfeited_amount: Money.describe("Before tax, the part of the excess that the item's refund terms do not return."),
+})
+    .describe("What an immediate downgrade would refund, estimated as of `proration_date`. The refund itself is determined\nwhen the change takes effect.");

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

@@ -0,0 +1,42 @@
+/**
+ * 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 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";
+export declare const checkoutSessionItemInputPriceLookupKeyMax = 128;
+export declare const checkoutSessionItemInputPlanLookupKeyMax = 128;
+export declare const checkoutSessionItemInputQuantityRegExp: RegExp;
+export declare const CheckoutSessionItemInput: zod.ZodObject<{
+    subscription_item_id: zod.ZodOptional<zod.ZodUUID>;
+    price_lookup_key: zod.ZodOptional<zod.ZodString>;
+    plan_lookup_key: zod.ZodOptional<zod.ZodString>;
+    price_id: zod.ZodOptional<zod.ZodUUID>;
+    product_id: zod.ZodOptional<zod.ZodString>;
+    plan_id: zod.ZodOptional<zod.ZodUUID>;
+    price_type: zod.ZodOptional<zod.ZodEnum<{
+        one_time: "one_time";
+        recurring: "recurring";
+    }>>;
+    usage_type: zod.ZodOptional<zod.ZodEnum<{
+        licensed: "licensed";
+        metered: "metered";
+    }>>;
+    interval: zod.ZodOptional<zod.ZodEnum<{
+        none: "none";
+        day: "day";
+        month: "month";
+        year: "year";
+    }>>;
+    interval_count: zod.ZodOptional<zod.ZodInt>;
+    cancellation_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
+    quantity: zod.ZodString;
+    dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
+}, zod.z.core.$strict>;
+export type CheckoutSessionItemInput = zod.input<typeof CheckoutSessionItemInput>;
+export type CheckoutSessionItemInputOutput = zod.output<typeof CheckoutSessionItemInput>;

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

@@ -0,0 +1,41 @@
+/**
+ * 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 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";
+import { CancellationPolicy } from "./cancellationPolicy.zod.js";
+import { PriceType } from "./priceType.zod.js";
+import { ProductId } from "./productId.zod.js";
+import { UsageType } from "./usageType.zod.js";
+export const checkoutSessionItemInputPriceLookupKeyMax = 128;
+export const checkoutSessionItemInputPlanLookupKeyMax = 128;
+export const checkoutSessionItemInputQuantityRegExp = new RegExp("^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$");
+export const CheckoutSessionItemInput = zod
+    .strictObject({
+    subscription_item_id: zod
+        .uuid()
+        .optional()
+        .describe("For `modify` only. The subscription item changed."),
+    price_lookup_key: zod.string().min(1).max(checkoutSessionItemInputPriceLookupKeyMax).optional(),
+    plan_lookup_key: zod.string().min(1).max(checkoutSessionItemInputPlanLookupKeyMax).optional(),
+    price_id: zod.uuid().optional(),
+    product_id: ProductId.optional(),
+    plan_id: zod.uuid().optional(),
+    price_type: PriceType.optional().describe("Narrows the selection when a plan offers more than one price type."),
+    usage_type: UsageType.optional().describe("Narrows the selection when a plan offers more than one usage type."),
+    interval: zod.enum(["none", "day", "month", "year"]).optional(),
+    interval_count: zod.int().min(1).optional(),
+    cancellation_policy: CancellationPolicy.optional().describe("Selects among licensed prices with otherwise identical billing terms. Ambiguous terms are refused instead of choosing a price arbitrarily."),
+    quantity: zod
+        .string()
+        .regex(checkoutSessionItemInputQuantityRegExp)
+        .describe("The quantity bought, or after a change."),
+    dimensions: zod
+        .record(zod.string(), zod.string())
+        .optional()
+        .describe("The dimension values of what is bought, such as region and instance type, or after a change, given in full. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to."),
+})
+    .describe("Identify a price, or select one for a plan; give each resource's ID or lookup key, never both, and\nproduct_id with lookup keys. A change names its `subscription_item_id`; without a price or billing terms the\nplan's price with the item's price type, usage type, interval, interval count and cancellation policy is\nselected, and omitted dimensions keep the item's. A metered item includes only any setup charge; its usage is\nestimated with `estimate-usage`.");