@leaflow/sdk 0.108.0 → 0.110.0

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

@@ -0,0 +1,1469 @@
+/**
+ * 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 { CancellationCreate } from "./validators/cancellationCreate.zod.js";
+import { CheckoutOrderRequest } from "./validators/checkoutOrderRequest.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";
+/**
+ * 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(),
+});
+/**
+ * The legal name, address and tax identifier are copied onto each invoice when it is
+ * issued. Changing them here affects invoices issued afterwards, not those already sent.
+ *
+ * The currency cannot be changed.
+ * @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(),
+});
+/**
+ * Whether the account has anything billed by usage, and what that usage has cost over the last
+ * seven days. Usage is paid from the balance, so this tells how much of the balance it is likely
+ * to need: the balance divided by `average_daily_amount` is roughly how many days it lasts.
+ * @summary Get account metered usage
+ */
+export const GetAccountMeteredUsageParams = 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("An order invoice stays `draft` until checkout confirms its discount and final amounts. It\ncannot be collected while draft. Confirmation makes it `open`, or `paid` when its total is zero\nwithout creating a payment transaction. A quote never changes this status.\n\nA usage invoice stays `draft` through its month: each charge is added to it as it is priced\nand paid from credits and balance as it goes. It is issued at the end of the month, becoming\n`paid` when everything was covered and `open` when something is still owed.\n\n`refunded` means the invoice was paid and has since been refunded in full; a partial refund\nleaves it `paid`, with the refunded part in `amount_refunded`.\n\n`void` means the invoice will not be paid and holds no money: nothing was paid, or its order\nfailed or was canceled and everything paid toward it has been returned, as `amount_paid` and\n`amount_refunded` show."),
+    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."),
+});
+/**
+ * Each charge is added to the month's usage invoice as it is priced, summed into one line per
+ * subscription, project, resource, meter and rate. Filter by `invoice_item_id` to see the
+ * charges behind a line. Charges still waiting to be priced are included too.
+ *
+ * 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(),
+});
+/**
+ * @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."),
+});
+/**
+ * @summary Get subscription
+ */
+export const GetSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+/**
+ * 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(),
+});
+/**
+ * Aggregates rated and invoiced usage charges in the specified time range for one billing account.
+ * Includes usage not yet invoiced. 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("`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."),
+});