@leaflow/sdk 0.0.0-dev.29.g8fe6a71 → 0.0.0-dev.293.g578f043

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

@@ -0,0 +1,1613 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { AutoRenewSet } from "./validators/autoRenewSet.zod.js";
+import { BillingAccountCreate } from "./validators/billingAccountCreate.zod.js";
+import { BillingAccountUpdate } from "./validators/billingAccountUpdate.zod.js";
+import { CancelSubscriptionRequest } from "./validators/cancelSubscriptionRequest.zod.js";
+import { CancellationCreate } from "./validators/cancellationCreate.zod.js";
+import { CheckoutOrderRequest } from "./validators/checkoutOrderRequest.zod.js";
+import { ContactCreate } from "./validators/contactCreate.zod.js";
+import { ContactUpdate } from "./validators/contactUpdate.zod.js";
+import { OrderCancel } from "./validators/orderCancel.zod.js";
+import { PayInvoiceRequest } from "./validators/payInvoiceRequest.zod.js";
+import { PayTogetherRequest } from "./validators/payTogetherRequest.zod.js";
+import { PaymentMethodSetup } from "./validators/paymentMethodSetup.zod.js";
+import { QuoteRequest } from "./validators/quoteRequest.zod.js";
+import { RenewRequest } from "./validators/renewRequest.zod.js";
+import { RenewalOrderRequest } from "./validators/renewalOrderRequest.zod.js";
+import { SetProjectAssignmentRequest } from "./validators/setProjectAssignmentRequest.zod.js";
+import { TopUpCreate } from "./validators/topUpCreate.zod.js";
+/**
+ * @summary List contacts
+ */
+export const ListContactsParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const listContactsQueryPageDefault = 1;
+export const listContactsQueryPageMax = 2147483647;
+export const listContactsQueryPageSizeDefault = 50;
+export const listContactsQueryPageSizeMax = 200;
+export const ListContactsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listContactsQueryPageMax)
+        .default(listContactsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listContactsQueryPageSizeMax)
+        .default(listContactsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary Create contact
+ */
+export const CreateContactParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const CreateContactBody = ContactCreate;
+/**
+ * @summary Get contact
+ */
+export const GetContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
+/**
+ * @summary Update contact
+ */
+export const UpdateContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
+export const UpdateContactBody = ContactUpdate;
+/**
+ * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * @summary Delete contact
+ */
+export const DeleteContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
+/**
+ * The currencies a new billing account can be opened in. A retired currency is not listed,
+ * although accounts already opened in it keep working. Results are paginated.
+ * @summary List currencies accounts can be opened in
+ */
+export const listCurrenciesQueryPageDefault = 1;
+export const listCurrenciesQueryPageMax = 2147483647;
+export const listCurrenciesQueryPageSizeDefault = 50;
+export const listCurrenciesQueryPageSizeMax = 200;
+export const ListCurrenciesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCurrenciesQueryPageMax)
+        .default(listCurrenciesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCurrenciesQueryPageSizeMax)
+        .default(listCurrenciesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary List billing accounts
+ */
+export const listBillingAccountsQueryPageDefault = 1;
+export const listBillingAccountsQueryPageMax = 2147483647;
+export const listBillingAccountsQueryPageSizeDefault = 50;
+export const listBillingAccountsQueryPageSizeMax = 200;
+export const ListBillingAccountsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listBillingAccountsQueryPageMax)
+        .default(listBillingAccountsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listBillingAccountsQueryPageSizeMax)
+        .default(listBillingAccountsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * The currency is chosen here and cannot be changed afterwards. Everything charged to the
+ * account — prices, orders, invoices, balance — is denominated in it.
+ *
+ * One person may hold several accounts, for example a personal one and one for a team.
+ * @summary Create billing account
+ */
+export const CreateBillingAccountBody = BillingAccountCreate;
+/**
+ * @summary Get billing account
+ */
+export const GetBillingAccountParams = zod.strictObject({
+    accountId: zod.int(),
+});
+/**
+ * Select an active contact belonging to this account for future invoices. Its legal name,
+ * address and tax identifier are copied when an invoice is issued; issued snapshots are
+ * retained. Set invoice_contact_id to null to clear the selection. The currency cannot change.
+ * @summary Update billing account
+ */
+export const UpdateBillingAccountParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const UpdateBillingAccountBody = BillingAccountUpdate;
+/**
+ * @summary Get account balance
+ */
+export const GetAccountBalanceParams = zod.strictObject({
+    accountId: zod.int(),
+});
+/**
+ * Lists the payment gateways and methods that currently accept payment in this account's currency, the
+ * preferred gateway first. Top-ups and invoice payments must name a gateway and method listed here;
+ * others are refused. An empty result means no online payment is available for this account.
+ * Results are paginated.
+ * @summary List payment options
+ */
+export const ListPaymentOptionsParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const listPaymentOptionsQueryPageDefault = 1;
+export const listPaymentOptionsQueryPageMax = 2147483647;
+export const listPaymentOptionsQueryPageSizeDefault = 50;
+export const listPaymentOptionsQueryPageSizeMax = 200;
+export const ListPaymentOptionsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listPaymentOptionsQueryPageMax)
+        .default(listPaymentOptionsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listPaymentOptionsQueryPageSizeMax)
+        .default(listPaymentOptionsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary List project assignments
+ */
+export const listProjectAssignmentsQueryPageDefault = 1;
+export const listProjectAssignmentsQueryPageMax = 2147483647;
+export const listProjectAssignmentsQueryPageSizeDefault = 50;
+export const listProjectAssignmentsQueryPageSizeMax = 200;
+export const listProjectAssignmentsQueryProjectIdsMax = 100;
+export const ListProjectAssignmentsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listProjectAssignmentsQueryPageMax)
+        .default(listProjectAssignmentsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listProjectAssignmentsQueryPageSizeMax)
+        .default(listProjectAssignmentsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod.int().optional(),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listProjectAssignmentsQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * Returns the current assignment for the project identified by projectId. Returns 404 when
+ * no billing account is assigned; no resources can be created until one is assigned.
+ * @summary Get project assignment
+ */
+export const GetProjectAssignmentParams = zod.strictObject({
+    projectId: zod.uuid(),
+});
+/**
+ * Charges already incurred remain with the billing account that was linked when they
+ * occurred, and are still invoiced to it. Metered resources are settled up to the moment of
+ * the change. Amounts owed by the previous billing account remain owed by it and do not
+ * prevent the change.
+ *
+ * Orders keep the billing account they were placed with and are fulfilled as placed. Periods
+ * already paid for are unaffected; renewals are charged to the new billing account.
+ *
+ * The request is refused once the project no longer accepts purchases because it is being
+ * deleted, and while a subscription or an order in progress in the project uses a currency
+ * other than that of the new billing account.
+ * @summary Set project assignment
+ */
+export const SetProjectAssignmentParams = zod.strictObject({
+    projectId: zod.uuid(),
+});
+export const SetProjectAssignmentBody = SetProjectAssignmentRequest;
+/**
+ * Ends the project's current assignment without deleting its assignment history.
+ *
+ * Permitted only when nothing in the project is still running or in progress: no metered
+ * resources, no subscriptions that have not ended, and no orders in progress, including
+ * changes scheduled for the end of a period. Orders are not modified by this request; wait
+ * for them to complete, and have the service that scheduled a change call it off.
+ *
+ * Charges already incurred remain with the billing account and are invoiced to it as usual.
+ * Amounts the billing account owes do not prevent unlinking.
+ *
+ * After this the project cannot make purchases until a billing account is linked again.
+ * @summary Unlink project billing account
+ */
+export const UnlinkProjectBillingAccountParams = zod.strictObject({
+    projectId: zod.uuid(),
+});
+/**
+ * Lists only the authenticated user's top-ups. Includes pending, failed and canceled attempts; no invoice is
+ * created for a top-up. Items carry no `action`; read a pending top-up with get-top-up to continue its payment.
+ * @summary List top ups
+ */
+export const listTopUpsQueryPageDefault = 1;
+export const listTopUpsQueryPageMax = 2147483647;
+export const listTopUpsQueryPageSizeDefault = 50;
+export const listTopUpsQueryPageSizeMax = 200;
+export const ListTopUpsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listTopUpsQueryPageMax)
+        .default(listTopUpsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listTopUpsQueryPageSizeMax)
+        .default(listTopUpsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+});
+/**
+ * Creates a top-up for an account owned by the authenticated user and returns its payment information.
+ * The balance increases only after the payment gateway confirms receipt. A top-up has no invoice.
+ * Keep the supplied ID to query the original attempt after a lost response; duplicate creation conflicts.
+ * @summary Create top up
+ */
+export const CreateTopUpBody = TopUpCreate;
+/**
+ * Reads a top-up owned by the authenticated user, including its outcome and the part of it not yet spent.
+ * It is not an invoice.
+ *
+ * While the top-up is pending, the answer includes the customer's next step as the payment gateway
+ * currently reports it, so that a payment interrupted by a closed page can be continued. When the gateway
+ * cannot be reached, the top-up is returned without `action`; read it again later.
+ * @summary Get top up
+ */
+export const GetTopUpParams = zod.strictObject({
+    topUpId: zod.uuid(),
+});
+/**
+ * Withdraws a pending top-up owned by the authenticated user at the payment gateway. It becomes
+ * `canceled` with `cancellation_reason` `requested_by_customer`, and no money is collected for it. Canceling a
+ * top-up that is already canceled returns it unchanged.
+ *
+ * If the gateway has already collected the payment, nothing is withdrawn and the top-up is returned
+ * as `succeeded` with the balance increased. Check `status` in the answer rather than assuming the
+ * cancellation took effect.
+ *
+ * Fails with 409 and BILLING_TOPUP_NOT_CANCELABLE when the top-up has already succeeded or failed,
+ * with `status` naming that outcome, and while the gateway is processing the payment and can no
+ * longer withdraw it, with `status` set to `pending`; read the top-up again later in that case.
+ * @summary Cancel top up
+ */
+export const CancelTopUpParams = zod.strictObject({
+    topUpId: zod.uuid(),
+});
+/**
+ * @summary List payment methods
+ */
+export const listPaymentMethodsQueryPageDefault = 1;
+export const listPaymentMethodsQueryPageMax = 2147483647;
+export const listPaymentMethodsQueryPageSizeDefault = 50;
+export const listPaymentMethodsQueryPageSizeMax = 200;
+export const ListPaymentMethodsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listPaymentMethodsQueryPageMax)
+        .default(listPaymentMethodsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listPaymentMethodsQueryPageSizeMax)
+        .default(listPaymentMethodsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+});
+/**
+ * Returns what is needed to hand the browser over to the payment gateway's own card
+ * form. Nothing is charged, and the method appears in the list once the gateway
+ * confirms it.
+ *
+ * Card numbers are never sent to or stored by this service.
+ * @summary Create payment method setup
+ */
+export const CreatePaymentMethodSetupBody = PaymentMethodSetup;
+/**
+ * @summary Set default payment method
+ */
+export const SetDefaultPaymentMethodParams = zod.strictObject({
+    paymentMethodId: zod.uuid(),
+});
+/**
+ * Refused when it is the only method on an account that has resources billed by the hour,
+ * as there would be nothing left to charge when the balance runs out.
+ * @summary Delete payment method
+ */
+export const DeletePaymentMethodParams = zod.strictObject({
+    paymentMethodId: zod.uuid(),
+});
+/**
+ * Applies eligible credit grants and available balance as requested, then collects the remainder
+ * through the selected payment gateway and method. With no gateway selection, insufficient
+ * account funds fail without starting an online payment. Card and non-card methods use this same
+ * operation. Promotion codes are confirmed by checkout, before collecting payment.
+ *
+ * Returns a payment action when customer interaction is required. requires_action and processing
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
+ * attempt is reused, and retries do not apply credit grants or balance twice.
+ *
+ * Calling this on an invoice that is already paid returns the existing payment result without
+ * another charge. A draft order invoice must first be confirmed through checkout. It and a void
+ * invoice are refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an order that has failed or was
+ * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * @summary Pay an invoice
+ */
+export const PayInvoiceParams = zod.strictObject({
+    invoiceId: zod.uuid(),
+});
+export const PayInvoiceBody = PayInvoiceRequest;
+/**
+ * What paying this invoice now would take from credit grants, from the balance and, for the rest,
+ * from a payment gateway. It is computed as paying computes it, so paying with the same options
+ * straight afterwards takes exactly these amounts unless the account's funds change in between.
+ * Nothing is charged, reserved or created.
+ *
+ * Refused with the same errors as paying, except that insufficient funds are not an error here:
+ * they show as a `gateway_amount` above zero.
+ * @summary Preview invoice payment
+ */
+export const PreviewInvoicePaymentParams = zod.strictObject({
+    invoiceId: zod.uuid(),
+});
+export const previewInvoicePaymentQueryUseBalanceDefault = true;
+export const previewInvoicePaymentQueryUseCreditsDefault = true;
+export const PreviewInvoicePaymentQueryParams = zod.strictObject({
+    use_balance: zod
+        .boolean()
+        .default(previewInvoicePaymentQueryUseBalanceDefault)
+        .describe("As in paying. True when omitted."),
+    use_credits: zod
+        .boolean()
+        .default(previewInvoicePaymentQueryUseCreditsDefault)
+        .describe("As in paying. True when omitted."),
+});
+/**
+ * Pays outstanding invoices, including the invoices of the listed orders, from the account's
+ * eligible credit grants and then its balance. No payment gateway is used; an invoice to be
+ * paid online is paid on its own.
+ *
+ * Either every invoice is paid or none is. When the credit grants and balance cannot cover
+ * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
+ * Invoices that are already paid are not charged again. An invoice with an online payment
+ * still in progress is refused with `BILLING_PAYMENT_PENDING`, a draft order invoice or void invoice with
+ * `BILLING_INVOICE_NOT_PAYABLE`, an order that has failed or was canceled with
+ * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
+ * passed with `BILLING_ORDER_EXPIRED`.
+ * @summary Pay together
+ */
+export const PayTogetherBody = PayTogetherRequest;
+/**
+ * What paying these invoices together now would take from credit grants and from the balance,
+ * invoice by invoice in the order they would be paid. It is computed as paying together computes
+ * it. Nothing is charged, reserved or created.
+ *
+ * Refused with the same errors as paying together, except that insufficient funds are not an
+ * error here: they show as a `gateway_amount` above zero, and paying together would then be
+ * refused with `BILLING_INSUFFICIENT_FUNDS`.
+ * @summary Preview paying together
+ */
+export const PreviewPayTogetherBody = PayTogetherRequest;
+/**
+ * @summary List invoices
+ */
+export const listInvoicesQueryPageDefault = 1;
+export const listInvoicesQueryPageMax = 2147483647;
+export const listInvoicesQueryPageSizeDefault = 50;
+export const listInvoicesQueryPageSizeMax = 200;
+export const ListInvoicesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listInvoicesQueryPageMax)
+        .default(listInvoicesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listInvoicesQueryPageSizeMax)
+        .default(listInvoicesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    status: zod
+        .enum(["draft", "open", "paid", "refunded", "void", "uncollectible"])
+        .optional()
+        .describe("Draft invoices are private to administrators and cannot be read, listed or paid by customers.\nAn issued invoice is open until settled; a zero-total issued invoice is immediately paid.\nUnbilled usage remains separate from invoices until it is invoiced.\nrefunded means a full refund; a partial refund leaves the invoice paid.\nvoid means collection has stopped and any funds received have been returned."),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
+});
+/**
+ * @summary Get invoice
+ */
+export const GetInvoiceParams = zod.strictObject({
+    invoiceId: zod.uuid(),
+});
+/**
+ * @summary List invoice items
+ */
+export const ListInvoiceItemsParams = zod.strictObject({
+    invoiceId: zod.uuid(),
+});
+export const listInvoiceItemsQueryPageDefault = 1;
+export const listInvoiceItemsQueryPageMax = 2147483647;
+export const listInvoiceItemsQueryPageSizeDefault = 50;
+export const listInvoiceItemsQueryPageSizeMax = 200;
+export const ListInvoiceItemsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listInvoiceItemsQueryPageMax)
+        .default(listInvoiceItemsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listInvoiceItemsQueryPageSizeMax)
+        .default(listInvoiceItemsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary List transactions
+ */
+export const listTransactionsQueryPageDefault = 1;
+export const listTransactionsQueryPageMax = 2147483647;
+export const listTransactionsQueryPageSizeDefault = 50;
+export const listTransactionsQueryPageSizeMax = 200;
+export const ListTransactionsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listTransactionsQueryPageMax)
+        .default(listTransactionsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listTransactionsQueryPageSizeMax)
+        .default(listTransactionsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
+});
+/**
+ * Coupons placed on the account directly, which apply at checkout without a code being
+ * entered. A coupon reached through a code is not listed here.
+ * @summary List the coupons held on this account
+ */
+export const listAccountDiscountsQueryPageDefault = 1;
+export const listAccountDiscountsQueryPageMax = 2147483647;
+export const listAccountDiscountsQueryPageSizeDefault = 50;
+export const listAccountDiscountsQueryPageSizeMax = 200;
+export const ListAccountDiscountsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listAccountDiscountsQueryPageMax)
+        .default(listAccountDiscountsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listAccountDiscountsQueryPageSizeMax)
+        .default(listAccountDiscountsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+});
+/**
+ * Each grant shows what remains and what it may be used for. Credit is spent before the balance
+ * and cannot be withdrawn.
+ * @summary List credit grants
+ */
+export const listCreditGrantsQueryPageDefault = 1;
+export const listCreditGrantsQueryPageMax = 2147483647;
+export const listCreditGrantsQueryPageSizeDefault = 50;
+export const listCreditGrantsQueryPageSizeMax = 200;
+export const ListCreditGrantsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditGrantsQueryPageMax)
+        .default(listCreditGrantsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditGrantsQueryPageSizeMax)
+        .default(listCreditGrantsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    status: zod.enum(["active", "depleted", "expired", "voided"]).optional(),
+});
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export const listCreditNotesQueryPageDefault = 1;
+export const listCreditNotesQueryPageMax = 2147483647;
+export const listCreditNotesQueryPageSizeDefault = 50;
+export const listCreditNotesQueryPageSizeMax = 200;
+export const ListCreditNotesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesQueryPageMax)
+        .default(listCreditNotesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNotesQueryPageSizeMax)
+        .default(listCreditNotesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    invoice_id: zod.uuid().optional().describe("Only the notes for this invoice."),
+});
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export const GetCreditNoteParams = zod.strictObject({
+    creditNoteId: zod.uuid(),
+});
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export const ListCreditNoteItemsParams = zod.strictObject({
+    creditNoteId: zod.uuid(),
+});
+export const listCreditNoteItemsQueryPageDefault = 1;
+export const listCreditNoteItemsQueryPageMax = 2147483647;
+export const listCreditNoteItemsQueryPageSizeDefault = 50;
+export const listCreditNoteItemsQueryPageSizeMax = 200;
+export const ListCreditNoteItemsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsQueryPageMax)
+        .default(listCreditNoteItemsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCreditNoteItemsQueryPageSizeMax)
+        .default(listCreditNoteItemsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * Newest first.
+ * @summary List refunds
+ */
+export const listRefundsQueryPageDefault = 1;
+export const listRefundsQueryPageMax = 2147483647;
+export const listRefundsQueryPageSizeDefault = 50;
+export const listRefundsQueryPageSizeMax = 200;
+export const ListRefundsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listRefundsQueryPageMax)
+        .default(listRefundsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listRefundsQueryPageSizeMax)
+        .default(listRefundsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    invoice_id: zod.uuid().optional().describe("Only the refunds of this invoice."),
+    order_id: zod
+        .uuid()
+        .optional()
+        .describe("Only the refunds that belong to this order: those of its invoice, such as the refund of a\npurchase that could not be delivered, and those it caused on an earlier invoice, such as\nthe difference returned after a downgrade."),
+});
+/**
+ * Lists priced and unrated usage charges. Requires `statement_id`, `invoice_item_id`, or both `from` and `to` spanning at most 31 days; use the statement summary or spend report for longer periods. Charges are summed into one line per subscription, project, resource, meter and rate when their statement closes; filter by `invoice_item_id` to see the charges behind a line. Unrated charges had no applicable price when the usage occurred and are not billed.
+ *
+ * Only charges recorded against your billing accounts are included, before filtering, counting and pagination. Reassigning a project does not move previously recorded charges to its new account.
+ * @summary List usage charges
+ */
+export const listUsageChargesQueryPageDefault = 1;
+export const listUsageChargesQueryPageMax = 2147483647;
+export const listUsageChargesQueryPageSizeDefault = 50;
+export const listUsageChargesQueryPageSizeMax = 200;
+export const listUsageChargesQueryProductIdMax = 64;
+export const listUsageChargesQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const listUsageChargesQueryProjectIdsMax = 100;
+export const ListUsageChargesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listUsageChargesQueryPageMax)
+        .default(listUsageChargesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listUsageChargesQueryPageSizeMax)
+        .default(listUsageChargesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listUsageChargesQueryProductIdMax)
+        .regex(listUsageChargesQueryProductIdRegExp)
+        .optional()
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+    resource_id: zod.string().optional(),
+    invoice_item_id: zod
+        .uuid()
+        .optional()
+        .describe("Only the charges summed into this usage invoice line."),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listUsageChargesQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+    meter_id: zod.uuid().optional(),
+    statement_id: zod.uuid().optional(),
+});
+/**
+ * Lists subscriptions visible to the authorized billing account. Soft-deleted subscriptions are excluded.
+ * @summary List subscriptions
+ */
+export const listSubscriptionsQueryPageDefault = 1;
+export const listSubscriptionsQueryPageMax = 2147483647;
+export const listSubscriptionsQueryPageSizeDefault = 50;
+export const listSubscriptionsQueryPageSizeMax = 200;
+export const listSubscriptionsQueryProjectIdsMax = 100;
+export const ListSubscriptionsQueryParams = zod.strictObject({
+    expiring_before: zod.iso.datetime({ offset: true }).optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(listSubscriptionsQueryPageMax)
+        .default(listSubscriptionsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listSubscriptionsQueryPageSizeMax)
+        .default(listSubscriptionsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listSubscriptionsQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * Returns a subscription visible to the authorized billing account. Soft-deleted subscriptions are reported as not found.
+ * @summary Get subscription
+ */
+export const GetSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+/**
+ * Sets deleted_at on a canceled or terminated subscription, hiding it from your subscription
+ * list and detail. Your account access token must authorize the subscription's current billing
+ * account. Preserves commercial status, ended_at and billing and financial history. Completed
+ * cancellations and canceled unfulfilled purchases can be deleted directly, without termination.
+ * Pending, provisioning, active and suspended subscriptions are refused with 409
+ * BILLING_SUBSCRIPTION_NOT_ENDED and status in error params. A scheduled or releasing cancellation
+ * does not make a subscription canceled.
+ * There is no force, skip-cleanup or override option. Repeating deletion preserves the original
+ * deleted_at. Sends no cleanup command and creates no refund; outstanding cleanup continues.
+ * @summary Delete subscription
+ */
+export const DeleteSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+/**
+ * Requests cancellation on the purchase's agreed terms. Uses the same quotation, eligibility,
+ * metering and original-payment-source refund rules as creating a cancellation.
+ * Supply the refund amount from create-quote with this subscription in cancellation.subscription_ids.
+ * Your account access token must authorize the subscription's current billing account.
+ *
+ * Immediate cancellation asks the owning service to clean up now. Period-end cancellation keeps
+ * the subscription active or suspended until the paid term ends. Neither payment nor acceptance
+ * of this request proves cleanup. The subscription becomes canceled only after the service
+ * confirms release and the end of metering; follow the returned cancellation for progress.
+ *
+ * Related subscriptions released together must be submitted as one group to create-cancellation.
+ * Pending or provisioning purchases are canceled through their order, not this operation.
+ * Repeating the same open cancellation returns it without another refund or command.
+ * @summary Cancel subscription
+ */
+export const CancelSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const CancelSubscriptionBody = CancelSubscriptionRequest;
+/**
+ * Calculates exactly one target for a billing account you own: proposed items, existing order checkout, renewals, cancellation or order refund. Returns all requested calculations or a structured error. No quote is saved and no resource, payment, reservation or redemption is created.
+ *
+ * Existing orders use their recorded purchase account and terms. Renewals and cancellations use the account currently paying for each subscription. Every target must belong to the requested account. A project association or project token does not authorize a quote.
+ *
+ * Use an existing order quote's total as expected_amount at checkout. A confirmed order returns its recorded amounts; a different promotion code is refused. Requested future usage estimates are not collectible checkout amounts. An unknown delivery outcome is not proof of refund eligibility.
+ * @summary Create a quote
+ */
+export const CreateQuoteBody = QuoteRequest;
+/**
+ * Newest first. Filter by `subscription_id` and `status=open` to find the cancellation now under way for a subscription.
+ * @summary List cancellations
+ */
+export const listCancellationsQueryPageDefault = 1;
+export const listCancellationsQueryPageMax = 2147483647;
+export const listCancellationsQueryPageSizeDefault = 50;
+export const listCancellationsQueryPageSizeMax = 200;
+export const listCancellationsQueryProjectIdsMax = 100;
+export const ListCancellationsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listCancellationsQueryPageMax)
+        .default(listCancellationsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listCancellationsQueryPageSizeMax)
+        .default(listCancellationsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    subscription_id: zod
+        .uuid()
+        .optional()
+        .describe("Only cancellations that include this subscription."),
+    status: zod
+        .enum(["open", "requested", "scheduled", "releasing", "completed", "canceled", "failed"])
+        .optional()
+        .describe("Only cancellations in this status. `open` means requested, scheduled or releasing."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listCancellationsQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * Ends a set of subscriptions of one service together, at one time. Deleting a resource that a
+ * subscription pays for is an `immediate` cancellation of every subscription released with it,
+ * such as a server with the disks deleted along with it, or an address with its bandwidth.
+ *
+ * The service that provides the resources releases them: at once for `immediate`, or at
+ * `scheduled_at`, the end of the paid term, for `period_end`. When release is confirmed, the
+ * unused value is returned the way it was paid, under the refund terms agreed when each
+ * subscription was bought. For `immediate` the refund is computed as of `proration_date`, so the
+ * amount confirmed here is the amount returned: prepaid service used while the resources are
+ * being released is not deducted from it. Usage of a postpaid subscription is charged until its
+ * resources are released, as usual.
+ *
+ * `mode` must be allowed for every subscription. Postpaid and one-time subscriptions end only
+ * `immediate`. A prepaid subscription ends `period_end` while its paid term lasts, and
+ * `immediate` unless its termination terms allow only the end of the paid term and that term has
+ * not ended yet. For `period_end` the paid terms of all the subscriptions must end at the same
+ * time.
+ *
+ * Refused with:
+ * - 400 `BILLING_CANCELLATION_INVALID` when `subscription_ids` or `proration_date` is not
+ *   acceptable (`meta.field`), or the subscriptions do not all belong to one service, project,
+ *   account and currency;
+ * - 409 `BILLING_CANCELLATION_CONFLICT` when a subscription has not started or has ended;
+ * - 422 `BILLING_CANCELLATION_MODE_FIXED` when `mode` is not allowed for a subscription, and
+ *   `BILLING_CANCELLATION_TERMS_UNSET` when a prepaid subscription has no termination terms;
+ *   both carry `meta.subscription_id`;
+ * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
+ *   different times;
+ * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
+ *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
+ *   is in progress;
+ * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer
+ *   `expected_refundable_amount`; quote again.
+ *
+ * Sending the same request again, for the same subscriptions, mode and amount while that
+ * cancellation is still open, returns it with 200 rather than creating another. Renewal orders
+ * still waiting for payment are canceled along with it, and automatic renewal is turned off for
+ * every subscription in the set, for `period_end` as well as `immediate`.
+ * @summary Cancel subscriptions
+ */
+export const CreateCancellationBody = CancellationCreate;
+/**
+ * @summary Get a cancellation
+ */
+export const GetCancellationParams = zod.strictObject({
+    cancellationId: zod.uuid(),
+});
+/**
+ * Withdraws the whole cancellation while none of its resources has begun to be released; the
+ * subscriptions continue as before, except that automatic renewal, turned off when the
+ * cancellation was created, stays off until it is turned on again. After that it is refused with
+ * 409 `BILLING_CANCELLATION_CONFLICT`. Withdrawing one that is already withdrawn returns it
+ * unchanged.
+ * @summary Withdraw a cancellation
+ */
+export const WithdrawCancellationParams = zod.strictObject({
+    cancellationId: zod.uuid(),
+});
+/**
+ * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax.
+ * @summary List the terms this item can be renewed for
+ */
+export const ListRenewalPricesParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const listRenewalPricesQueryPageDefault = 1;
+export const listRenewalPricesQueryPageMax = 2147483647;
+export const listRenewalPricesQueryPageSizeDefault = 50;
+export const listRenewalPricesQueryPageSizeMax = 200;
+export const ListRenewalPricesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listRenewalPricesQueryPageMax)
+        .default(listRenewalPricesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listRenewalPricesQueryPageSizeMax)
+        .default(listRenewalPricesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * Purchases prepaid periods from paid_until using the agreed recurring amount, and pays for them at
+ * once. A changed interval selects a current price and freezes new terms on the order, applied
+ * only after fulfillment. Existing paid periods keep their value.
+ *
+ * Without `payment_method_id`, the renewal is paid from credit grants and the balance as
+ * `use_credits` and `use_balance` allow; when they cannot pay it all, the renewal is refused with
+ * `BILLING_INSUFFICIENT_FUNDS` and no order is left. To pay another way, create a renewal order
+ * and pay its invoice instead.
+ *
+ * Save order_id before submitting and query the order after an unknown outcome; duplicate
+ * creation conflicts.
+ * @summary Renew subscription
+ */
+export const RenewSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const RenewSubscriptionBody = RenewRequest;
+/**
+ * Places a renewal order with a draft invoice, without applying a new discount or charging anything.
+ * Quote and confirm its checkout before collecting payment to renew. Existing subscription
+ * discount commitments are retained. The periods and price are chosen as for renewing. The order
+ * can be paid until the current paid period ends, and never after the end of the first period it renews; unpaid by
+ * then, it is canceled. While auto-renew is on, the renewal due at the end of the period pays
+ * this order instead of placing another, confirming checkout with an applicable account discount
+ * first if it has not already been confirmed.
+ *
+ * Save `order_id` before submitting and read the order after an unknown outcome; creating it a
+ * second time conflicts.
+ * @summary Create renewal order
+ */
+export const CreateRenewalOrderParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const CreateRenewalOrderBody = RenewalOrderRequest;
+/**
+ * Controls automatic prepaid renewal. Disabling it does not shorten paid_until and still permits
+ * manual renewal. Postpaid subscriptions do not renew and keep this false.
+ *
+ * While the subscription has an open cancellation, turning it on or off is refused with 409
+ * `BILLING_SUBSCRIPTION_OPERATION_PENDING` and `meta.cancellation_id`: creating the cancellation
+ * turned it off, and withdrawing the cancellation does not turn it back on.
+ * @summary Set auto renew
+ */
+export const SetAutoRenewParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const SetAutoRenewBody = AutoRenewSet;
+/**
+ * Lists remaining usage quantities, such as bytes, seconds or tokens. Applicable allowances are
+ * consumed before usage is charged. Lower priority values are consumed first, followed by earlier
+ * expiry and earlier issuance.
+ *
+ * Unused quantity expires without a refund or carry-over. Promotional allowances apply to usage paid
+ * by their holding account. Included allowances apply only to the associated subscription, including
+ * after its project moves to another billing account.
+ * @summary List allowances
+ */
+export const listAllowancesQueryPageDefault = 1;
+export const listAllowancesQueryPageMax = 2147483647;
+export const listAllowancesQueryPageSizeDefault = 50;
+export const listAllowancesQueryPageSizeMax = 200;
+export const listAllowancesQueryProductIdMax = 64;
+export const listAllowancesQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const listAllowancesQueryProjectIdsMax = 100;
+export const ListAllowancesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listAllowancesQueryPageMax)
+        .default(listAllowancesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listAllowancesQueryPageSizeMax)
+        .default(listAllowancesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    meter_id: zod.uuid().optional().describe("Filter by the meter UUID."),
+    status: zod.enum(["active", "depleted", "expired", "voided"]).optional(),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listAllowancesQueryProductIdMax)
+        .regex(listAllowancesQueryProductIdRegExp)
+        .optional()
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listAllowancesQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * Lists acceptance status and associated invoice amounts. pending_checkout awaits confirmation;
+ * pending has confirmed checkout and may be unpaid or paid. active means accepted, not delivered.
+ * pending_checkout and pending orders can expire at expires_at.
+ * @summary List orders
+ */
+export const listOrdersQueryPageDefault = 1;
+export const listOrdersQueryPageMax = 2147483647;
+export const listOrdersQueryPageSizeDefault = 50;
+export const listOrdersQueryPageSizeMax = 200;
+export const listOrdersQueryProjectIdsMax = 100;
+export const ListOrdersQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listOrdersQueryPageMax)
+        .default(listOrdersQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listOrdersQueryPageSizeMax)
+        .default(listOrdersQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    status: zod
+        .enum([
+        "pending_checkout",
+        "pending",
+        "active",
+        "completed",
+        "partially_completed",
+        "failed",
+        "canceled",
+    ])
+        .optional()
+        .describe("pending_checkout has recorded purchase terms but no confirmed checkout; only a deferred order\nwith an amount due reaches it, since a zero-total order completes checkout at placement.\nConfirmation moves it to pending. Both pending_checkout\nand pending can expire or be canceled; neither establishes service delivery.\n\nFollows the items. `pending` has confirmed checkout, is not yet accepted and may be paid or unpaid. `active` is\naccepted with items still being set up. `completed` means every item was set up.\n`partially_completed` means some items were set up and the others failed or were canceled and were\nrefunded to their original payment sources. `failed` means no item was delivered and at least one failed; collected amounts for the\nundelivered items are refunded. `canceled` means every item was withdrawn without delivery; collected amounts are\nreturned to their original payment sources."),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listOrdersQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * @summary Get order
+ */
+export const GetOrderParams = zod.strictObject({
+    orderId: zod.uuid(),
+});
+/**
+ * Confirms the purchase's final amount and discount. Supply the same promotion_code used for the
+ * preview, or omit it to select an applicable account discount. At most one new coupon is applied
+ * to an order; existing subscription discount commitments are not stacked with a new coupon on
+ * the same line. Promotion codes are evaluated against the order, not client-supplied line amounts.
+ *
+ * Rechecks eligibility and redemption availability. A different total fails with
+ * BILLING_AMOUNT_CHANGED. An invalid or inapplicable code fails rather than collecting full price.
+ * A failed confirmation leaves the invoice draft and reserves no discount redemption.
+ *
+ * A successful confirmation records the discount, including any recurring discount terms,
+ * reserves its redemption, moves pending_checkout to pending and finalizes the invoice when one
+ * is required. The reservation counts toward the code's limits and is consumed when the invoice
+ * is paid, or at confirmation when nothing is due. Use pay-invoice to collect
+ * its outstanding amount from account funds or a payment gateway. No payment attempt or checkout
+ * session is created by this operation. An order whose total is zero completes checkout at
+ * placement in either mode and does not need this operation; an order with an amount due, even
+ * when credits would cover it, still does. Checkout alone does not confirm resource delivery.
+ *
+ * Retrying with the same code and expected amount returns the existing order without another
+ * redemption. Omitting the code on a confirmed checkout retains its recorded discount. Changing
+ * that code is refused with BILLING_ORDER_CHECKOUT_CONFLICT. Payment retries reuse the confirmed
+ * terms. Cancellation, expiry or complete fulfillment failure releases the reservation or returns
+ * the consumed redemption; a refund alone does not.
+ *
+ * The order must belong to one of your billing accounts. A canceled, failed or expired order
+ * cannot be checked out. A period-end change cannot be checked out before its renewal invoice is
+ * available. Orders retain their billing account and currency after a project is linked elsewhere;
+ * discounts from another account cannot be used for them.
+ * @summary Confirm order checkout
+ */
+export const CheckoutOrderParams = zod.strictObject({
+    orderId: zod.uuid(),
+});
+export const CheckoutOrderBody = CheckoutOrderRequest;
+/**
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
+ *
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
+ *
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
+ * @summary Cancel order
+ */
+export const CancelOrderParams = zod.strictObject({
+    orderId: zod.uuid(),
+});
+export const CancelOrderBody = OrderCancel;
+/**
+ * One entry per item bought, with the price charged and the period it covers.
+ * @summary List order items
+ */
+export const ListOrderItemsParams = zod.strictObject({
+    orderId: zod.uuid(),
+});
+export const listOrderItemsQueryPageDefault = 1;
+export const listOrderItemsQueryPageMax = 2147483647;
+export const listOrderItemsQueryPageSizeDefault = 50;
+export const listOrderItemsQueryPageSizeMax = 200;
+export const ListOrderItemsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listOrderItemsQueryPageMax)
+        .default(listOrderItemsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listOrderItemsQueryPageSizeMax)
+        .default(listOrderItemsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * Capabilities that come with what has been bought. A capability that is not held simply
+ * does not appear, so that "this does not exist" and "this has not been bought" cannot be
+ * confused.
+ *
+ * Derived from live subscriptions rather than stored, so this always agrees with what is
+ * being paid for. It stops being listed as soon as the subscription providing it ends.
+ * @summary List entitlements
+ */
+export const listEntitlementsQueryPageDefault = 1;
+export const listEntitlementsQueryPageMax = 2147483647;
+export const listEntitlementsQueryPageSizeDefault = 50;
+export const listEntitlementsQueryPageSizeMax = 200;
+export const listEntitlementsQueryProjectIdsMax = 100;
+export const listEntitlementsQueryProductIdMax = 64;
+export const listEntitlementsQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const ListEntitlementsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listEntitlementsQueryPageMax)
+        .default(listEntitlementsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listEntitlementsQueryPageSizeMax)
+        .default(listEntitlementsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listEntitlementsQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listEntitlementsQueryProductIdMax)
+        .regex(listEntitlementsQueryProductIdRegExp)
+        .optional()
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+});
+/**
+ * Every sellable thing and what it costs, in one request. A plan appears once per price.
+ *
+ * `currency` is required: a plan has a price in each currency it is sold in, so "what does
+ * this cost" has no answer without one.
+ *
+ * Archived prices are left out. Existing subscriptions keep the terms they were bought at, so
+ * this is not the place to look up what an existing purchase is paying.
+ * @summary List what is on sale, with prices
+ */
+export const listPricesQueryPageDefault = 1;
+export const listPricesQueryPageMax = 2147483647;
+export const listPricesQueryPageSizeDefault = 50;
+export const listPricesQueryPageSizeMax = 200;
+export const listPricesQueryCurrencyMin = 3;
+export const listPricesQueryCurrencyMax = 3;
+export const listPricesQueryProductIdMax = 64;
+export const listPricesQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const ListPricesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listPricesQueryPageMax)
+        .default(listPricesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listPricesQueryPageSizeMax)
+        .default(listPricesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    currency: zod
+        .string()
+        .min(listPricesQueryCurrencyMin)
+        .max(listPricesQueryCurrencyMax)
+        .describe("ISO 4217, three uppercase letters."),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listPricesQueryProductIdMax)
+        .regex(listPricesQueryProductIdRegExp)
+        .optional()
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+    type: zod
+        .enum(["postpaid", "prepaid", "one_time"])
+        .optional()
+        .describe("Narrows to one payment timing."),
+});
+export const ListPricesHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * @summary List catalog products
+ */
+export const listProductsQueryPageDefault = 1;
+export const listProductsQueryPageMax = 2147483647;
+export const listProductsQueryPageSizeDefault = 50;
+export const listProductsQueryPageSizeMax = 200;
+export const ListProductsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listProductsQueryPageMax)
+        .default(listProductsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listProductsQueryPageSizeMax)
+        .default(listProductsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+export const ListProductsHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Resolves an identifier that was stored elsewhere — on an order line, an invoice line, or
+ * the terms of a credit — into something that can be displayed.
+ * @summary Get a service
+ */
+export const getProductPathProductIdMax = 64;
+export const getProductPathProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const GetProductParams = zod.strictObject({
+    productId: zod
+        .string()
+        .min(1)
+        .max(getProductPathProductIdMax)
+        .regex(getProductPathProductIdRegExp)
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+});
+export const GetProductHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Resolves a stored identifier into something that can be displayed. Returns items that are
+ * no longer on sale: an existing purchase still refers to one.
+ * @summary Get a sellable item
+ */
+export const GetPlanParams = zod.strictObject({
+    planId: zod.uuid(),
+});
+export const GetPlanHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Returns the catalog price, including archived prices. Fixed purchase history and renewal agreements are shown on orders and subscriptions rather than reconstructed from today's catalog.
+ * @summary Get a price
+ */
+export const GetPriceParams = zod.strictObject({
+    priceId: zod.uuid(),
+});
+export const GetPriceHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * @summary List catalog plans
+ */
+export const listPlansQueryProductIdMax = 64;
+export const listPlansQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const listPlansQueryPageDefault = 1;
+export const listPlansQueryPageMax = 2147483647;
+export const listPlansQueryPageSizeDefault = 50;
+export const listPlansQueryPageSizeMax = 200;
+export const ListPlansQueryParams = zod.strictObject({
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listPlansQueryProductIdMax)
+        .regex(listPlansQueryProductIdRegExp)
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+    page: zod
+        .int()
+        .min(1)
+        .max(listPlansQueryPageMax)
+        .default(listPlansQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listPlansQueryPageSizeMax)
+        .default(listPlansQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+export const ListPlansHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Public list prices only. An account holding a negotiated agreement may be charged less;
+ * it is never charged more.
+ * @summary List catalog prices
+ */
+export const ListPricesByPlanParams = zod.strictObject({
+    planId: zod.uuid(),
+});
+export const listPricesByPlanQueryPageDefault = 1;
+export const listPricesByPlanQueryPageMax = 2147483647;
+export const listPricesByPlanQueryPageSizeDefault = 50;
+export const listPricesByPlanQueryPageSizeMax = 200;
+export const ListPricesByPlanQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listPricesByPlanQueryPageMax)
+        .default(listPricesByPlanQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listPricesByPlanQueryPageSizeMax)
+        .default(listPricesByPlanQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    currency: zod.string().optional(),
+});
+export const ListPricesByPlanHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Only public price lists are readable here. A list written for a single agreement is not,
+ * and its identifier cannot be used to reach it.
+ * @summary List catalog rates
+ */
+export const ListRatesParams = zod.strictObject({
+    rateCardId: zod.uuid(),
+});
+export const listRatesQueryPageDefault = 1;
+export const listRatesQueryPageMax = 2147483647;
+export const listRatesQueryPageSizeDefault = 50;
+export const listRatesQueryPageSizeMax = 200;
+export const ListRatesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listRatesQueryPageMax)
+        .default(listRatesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listRatesQueryPageSizeMax)
+        .default(listRatesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    meter_id: zod.uuid().optional().describe("Filter by the meter UUID."),
+    at: zod.iso
+        .datetime({ offset: true })
+        .optional()
+        .describe("Return the rates in effect at this moment. Defaults to now."),
+});
+export const ListRatesHeader = zod.strictObject({
+    "If-None-Match": zod
+        .string()
+        .optional()
+        .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
+});
+/**
+ * Lists continuous metering registrations paid for by your billing accounts. Their state does not
+ * describe machine runtime or health. Project filters narrow the authorized accounts; they do not
+ * grant project-based access.
+ * @summary List active resources
+ */
+export const listActiveResourcesQueryPageDefault = 1;
+export const listActiveResourcesQueryPageMax = 2147483647;
+export const listActiveResourcesQueryPageSizeDefault = 50;
+export const listActiveResourcesQueryPageSizeMax = 200;
+export const listActiveResourcesQueryProjectIdsMax = 100;
+export const listActiveResourcesQueryProductIdMax = 64;
+export const listActiveResourcesQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const ListActiveResourcesQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listActiveResourcesQueryPageMax)
+        .default(listActiveResourcesQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listActiveResourcesQueryPageSizeMax)
+        .default(listActiveResourcesQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    resource_id: zod.string().optional(),
+    billing_account_id: zod
+        .int()
+        .optional()
+        .describe("Restrict to one of your accounts. All of them when omitted."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listActiveResourcesQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+    meter_id: zod.uuid().optional(),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listActiveResourcesQueryProductIdMax)
+        .regex(listActiveResourcesQueryProductIdRegExp)
+        .optional()
+        .describe("Immutable platform service identifier, such as compute, canopy or assistant."),
+    status: zod.enum(["active", "suspended", "closing", "completed"]).optional(),
+});
+/**
+ * Sums priced usage for one billing account by UTC day, including usage not yet invoiced. Amounts are
+ * before tax and before the tier adjustments made when a statement closes; minimum charges added at
+ * closing are included. `from` and `to` must fall on UTC day boundaries and span at most 92 days.
+ * Project filters use the account recorded on each charge, including charges for projects later
+ * assigned to another account. The total covers all matching groups, not just the returned page.
+ * @summary List account spend
+ */
+export const listSpendQueryGroupByDefault = `product`;
+export const listSpendQueryProductIdMax = 64;
+export const listSpendQueryProductIdRegExp = new RegExp("^[a-z][a-z0-9]*(-[a-z0-9]+)*$");
+export const listSpendQueryPageDefault = 1;
+export const listSpendQueryPageMax = 2147483647;
+export const listSpendQueryPageSizeDefault = 50;
+export const listSpendQueryPageSizeMax = 200;
+export const listSpendQueryProjectIdsMax = 100;
+export const ListSpendQueryParams = zod.strictObject({
+    from: zod.iso.datetime({ offset: true }),
+    to: zod.iso
+        .datetime({ offset: true })
+        .describe("Exclusive. One month is `[2026-09-01, 2026-10-01)`."),
+    group_by: zod
+        .enum(["product", "plan", "resource"])
+        .default(listSpendQueryGroupByDefault)
+        .describe("`plan` groups by the plan of the price each charge was priced with, which stays the same after the\nsubscription changes plan. `resource` groups by the resource each charge names. Items billed under their own\nidentifier — a disk, a public address — appear as their own rows rather than under\nthe machine they are attached to, since the relationship between them is known to\nthe owning service and not here."),
+    product_id: zod
+        .string()
+        .min(1)
+        .max(listSpendQueryProductIdMax)
+        .regex(listSpendQueryProductIdRegExp)
+        .optional()
+        .describe("Filter by the fixed platform service ID."),
+    page: zod
+        .int()
+        .min(1)
+        .max(listSpendQueryPageMax)
+        .default(listSpendQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listSpendQueryPageSizeMax)
+        .default(listSpendQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+    billing_account_id: zod
+        .int()
+        .describe("The authorized billing account whose currency and charges are used for this report."),
+    project_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listSpendQueryProjectIdsMax)
+        .optional()
+        .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
+});
+/**
+ * @summary List statements
+ */
+export const listStatementsQueryPageDefault = 1;
+export const listStatementsQueryPageMax = 2147483647;
+export const listStatementsQueryPageSizeDefault = 50;
+export const listStatementsQueryPageSizeMax = 200;
+export const ListStatementsQueryParams = zod.strictObject({
+    billing_account_id: zod.int().optional(),
+    status: zod.enum(["open", "closed"]).optional(),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(listStatementsQueryPageMax)
+        .default(listStatementsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listStatementsQueryPageSizeMax)
+        .default(listStatementsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary Get statement
+ */
+export const GetStatementParams = zod.strictObject({
+    statementId: zod.uuid(),
+});
+/**
+ * Reads the consumption summary that is updated in the same transaction as usage is priced. Group by project, product or meter and filter within the statement. Quantities are included only for meter groups so different units are never combined.
+ * @summary Get grouped consumption
+ */
+export const GetStatementUsageParams = zod.strictObject({
+    statementId: zod.uuid(),
+});
+export const getStatementUsageQueryGroupByDefault = `meter`;
+export const getStatementUsageQueryProjectIdsMax = 100;
+export const getStatementUsageQueryProductIdMax = 64;
+export const getStatementUsageQueryPageDefault = 1;
+export const getStatementUsageQueryPageMax = 2147483647;
+export const getStatementUsageQueryPageSizeDefault = 50;
+export const getStatementUsageQueryPageSizeMax = 200;
+export const GetStatementUsageQueryParams = zod.strictObject({
+    group_by: zod.enum(["project", "product", "meter"]).default(getStatementUsageQueryGroupByDefault),
+    project_ids: zod.array(zod.uuid()).max(getStatementUsageQueryProjectIdsMax).optional(),
+    product_id: zod.string().max(getStatementUsageQueryProductIdMax).optional(),
+    meter_id: zod.uuid().optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(getStatementUsageQueryPageMax)
+        .default(getStatementUsageQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(getStatementUsageQueryPageSizeMax)
+        .default(getStatementUsageQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});