@leaflow/sdk 0.126.0 → 0.127.1

package/dist/billing/type/order/v1/generated/models.d.ts

@@ -891,7 +891,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2874,6 +2874,31 @@ export interface StatementAmounts {
     tax_amount: Money;
     total: Money;
 }
+/**
+ * One billing account's usage billing for one UTC calendar month, summed over the month's statements. It is a summary, not something to pay; each closing's invoice is collected on its own.
+ */
+export interface MonthlyStatement {
+    billing_account_id: number;
+    currency: string;
+    period_start: string;
+    period_end: string;
+    /** True after the period's final closing, which applies minimum charges for the whole month. Usage priced later is still billed in supplement statements and added here. */
+    finalized: boolean;
+    finalized_at?: string;
+    /** Statements of the period, including the open one. */
+    statement_count: number;
+    billed: StatementAmounts;
+    credited_amount: Money;
+    unbilled?: StatementAmounts;
+    credit_applied: Money;
+    amount_paid: Money;
+    amount_due: Money;
+    amount_refunded: Money;
+}
+export interface MonthlyStatementList {
+    items: MonthlyStatement[];
+    pagination: OffsetPagination;
+}
 export type StatementStatus = (typeof StatementStatus)[keyof typeof StatementStatus];
 export declare const StatementStatus: {
     readonly open: "open";

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

@@ -21,7 +21,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

package/dist/billing/type/order/v1/generated/validators/monthlyStatement.zod.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const MonthlyStatement: zod.ZodObject<{
+    billing_account_id: zod.ZodInt;
+    currency: zod.ZodString;
+    period_start: zod.z.ZodISODateTime;
+    period_end: zod.z.ZodISODateTime;
+    finalized: zod.ZodBoolean;
+    finalized_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    statement_count: zod.ZodInt;
+    billed: zod.ZodObject<{
+        subtotal: zod.ZodString;
+        discount_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        total: zod.ZodString;
+    }, zod.z.core.$strict>;
+    credited_amount: zod.ZodString;
+    unbilled: zod.ZodOptional<zod.ZodObject<{
+        subtotal: zod.ZodString;
+        discount_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        total: zod.ZodString;
+    }, zod.z.core.$strict>>;
+    credit_applied: zod.ZodString;
+    amount_paid: zod.ZodString;
+    amount_due: zod.ZodString;
+    amount_refunded: zod.ZodString;
+}, zod.z.core.$strict>;
+export type MonthlyStatement = zod.input<typeof MonthlyStatement>;
+export type MonthlyStatementOutput = zod.output<typeof MonthlyStatement>;

package/dist/billing/type/order/v1/generated/validators/monthlyStatement.zod.js

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+import { StatementAmounts } from "./statementAmounts.zod.js";
+export const MonthlyStatement = zod
+    .strictObject({
+    billing_account_id: zod.int(),
+    currency: zod.string(),
+    period_start: zod.iso.datetime({ offset: true }),
+    period_end: zod.iso.datetime({ offset: true }),
+    finalized: zod
+        .boolean()
+        .describe("True after the period's final closing, which applies minimum charges for the whole month. Usage priced later is still billed in supplement statements and added here."),
+    finalized_at: zod.iso.datetime({ offset: true }).optional(),
+    statement_count: zod.int().describe("Statements of the period, including the open one."),
+    billed: StatementAmounts,
+    credited_amount: Money,
+    unbilled: StatementAmounts.optional(),
+    credit_applied: Money,
+    amount_paid: Money,
+    amount_due: Money,
+    amount_refunded: Money,
+})
+    .describe("One billing account's usage billing for one UTC calendar month, summed over the month's statements. It is a summary, not something to pay; each closing's invoice is collected on its own.");

package/dist/billing/type/order/v1/generated/validators/monthlyStatementList.zod.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const MonthlyStatementList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        billing_account_id: zod.ZodInt;
+        currency: zod.ZodString;
+        period_start: zod.z.ZodISODateTime;
+        period_end: zod.z.ZodISODateTime;
+        finalized: zod.ZodBoolean;
+        finalized_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        statement_count: zod.ZodInt;
+        billed: zod.ZodObject<{
+            subtotal: zod.ZodString;
+            discount_amount: zod.ZodString;
+            tax_amount: zod.ZodString;
+            total: zod.ZodString;
+        }, zod.z.core.$strict>;
+        credited_amount: zod.ZodString;
+        unbilled: zod.ZodOptional<zod.ZodObject<{
+            subtotal: zod.ZodString;
+            discount_amount: zod.ZodString;
+            tax_amount: zod.ZodString;
+            total: zod.ZodString;
+        }, zod.z.core.$strict>>;
+        credit_applied: zod.ZodString;
+        amount_paid: zod.ZodString;
+        amount_due: zod.ZodString;
+        amount_refunded: zod.ZodString;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type MonthlyStatementList = zod.input<typeof MonthlyStatementList>;
+export type MonthlyStatementListOutput = zod.output<typeof MonthlyStatementList>;

package/dist/billing/type/order/v1/generated/validators/monthlyStatementList.zod.js

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { MonthlyStatement } from "./monthlyStatement.zod.js";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+export const MonthlyStatementList = zod.strictObject({
+    items: zod.array(MonthlyStatement),
+    pagination: OffsetPagination,
+});

package/dist/billing/v1/generated/functions.d.ts

@@ -5,7 +5,7 @@
  * 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 type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
+import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, Price, PriceList, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RateList, RefundList, RenewRequest, RenewalOrderRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
 export type HTTPStatusCode1xx = 100 | 101 | 102 | 103;
 export type HTTPStatusCode2xx = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207;
 export type HTTPStatusCode3xx = 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308;
@@ -607,8 +607,12 @@ export declare const getPayInvoiceUrl: (invoiceId: string) => string;
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * 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.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -679,8 +683,9 @@ export declare const getPayTogetherUrl: () => string;
  * 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.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` 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 void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1430,7 +1435,7 @@ export declare const getCancelOrderUrl: (orderId: string) => string;
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * 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
@@ -1770,6 +1775,27 @@ export declare const getListSpendUrl: (params: ListSpendParams) => string;
  * @summary List account spend
  */
 export declare const listSpend: (params: ListSpendParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listSpendResponse>;
+export type listMonthlyStatementsResponse200 = {
+    data: MonthlyStatementList;
+    status: 200;
+};
+export type listMonthlyStatementsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listMonthlyStatementsResponseSuccess = listMonthlyStatementsResponse200 & {
+    headers: Headers;
+};
+export type listMonthlyStatementsResponseError = listMonthlyStatementsResponseDefault & {
+    headers: Headers;
+};
+export type listMonthlyStatementsResponse = listMonthlyStatementsResponseSuccess | listMonthlyStatementsResponseError;
+export declare const getListMonthlyStatementsUrl: (params?: ListMonthlyStatementsParams) => string;
+/**
+ * Usage billing by UTC calendar month for owned billing accounts, newest first. Each period combines its statements, the invoices they issued and how those invoices were paid; usage is billed about hourly, so a month holds many statements. Filter by billing_account_id and by period start.
+ * @summary List monthly statements
+ */
+export declare const listMonthlyStatements: (params?: ListMonthlyStatementsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listMonthlyStatementsResponse>;
 export type listStatementsResponse200 = {
     data: StatementList;
     status: 200;

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

@@ -638,8 +638,12 @@ export const getPayInvoiceUrl = (invoiceId) => {
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * 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.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -726,8 +730,9 @@ export const getPayTogetherUrl = () => {
  * 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.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` 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 void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1578,7 +1583,7 @@ export const getCancelOrderUrl = (orderId) => {
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * 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
@@ -2064,6 +2069,31 @@ export const listSpend = async (params, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListMonthlyStatementsUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value !== undefined) {
+            normalizedParams.append(key, value === null ? "null" : String(value));
+        }
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0
+        ? `https://billing.leaflow.cloud/api/v1/monthly-statements?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/monthly-statements`;
+};
+/**
+ * Usage billing by UTC calendar month for owned billing accounts, newest first. Each period combines its statements, the invoices they issued and how those invoices were paid; usage is billed about hourly, so a month holds many statements. Filter by billing_account_id and by period start.
+ * @summary List monthly statements
+ */
+export const listMonthlyStatements = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListMonthlyStatementsUrl(params), {
+        ...options,
+        method: "GET",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : {};
+    return { data, status: res.status, headers: res.headers };
+};
 export const getListStatementsUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {

package/dist/billing/v1/generated/models.d.ts

@@ -712,7 +712,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2858,6 +2858,31 @@ export interface StatementAmounts {
     tax_amount: Money;
     total: Money;
 }
+/**
+ * One billing account's usage billing for one UTC calendar month, summed over the month's statements. It is a summary, not something to pay; each closing's invoice is collected on its own.
+ */
+export interface MonthlyStatement {
+    billing_account_id: number;
+    currency: string;
+    period_start: string;
+    period_end: string;
+    /** True after the period's final closing, which applies minimum charges for the whole month. Usage priced later is still billed in supplement statements and added here. */
+    finalized: boolean;
+    finalized_at?: string;
+    /** Statements of the period, including the open one. */
+    statement_count: number;
+    billed: StatementAmounts;
+    credited_amount: Money;
+    unbilled?: StatementAmounts;
+    credit_applied: Money;
+    amount_paid: Money;
+    amount_due: Money;
+    amount_refunded: Money;
+}
+export interface MonthlyStatementList {
+    items: MonthlyStatement[];
+    pagination: OffsetPagination;
+}
 export type StatementStatus = (typeof StatementStatus)[keyof typeof StatementStatus];
 export declare const StatementStatus: {
     readonly open: "open";
@@ -3750,6 +3775,29 @@ export declare const ListSpendGroupBy: {
     readonly plan: "plan";
     readonly resource: "resource";
 };
+export type ListMonthlyStatementsParams = {
+    billing_account_id?: number;
+    /**
+     * Earliest period start, inclusive.
+     */
+    from?: string;
+    /**
+     * Latest period start, exclusive.
+     */
+    to?: string;
+    /**
+     * 1-based page number. Defaults to 1.
+     * @minimum 1
+     * @maximum 2147483647
+     */
+    page?: number;
+    /**
+     * Items per page. Defaults to 50; at most 200.
+     * @minimum 1
+     * @maximum 200
+     */
+    page_size?: number;
+};
 export type ListStatementsParams = {
     billing_account_id?: number;
     status?: StatementStatus;

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

@@ -334,8 +334,12 @@ export declare const DeletePaymentMethodParams: zod.ZodObject<{
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * 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.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -396,8 +400,9 @@ export declare const PreviewInvoicePaymentQueryParams: zod.ZodObject<{
  * 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.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` 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 void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -996,7 +1001,7 @@ export declare const GetOrderParams: zod.ZodObject<{
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * 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
@@ -1273,6 +1278,21 @@ export declare const ListSpendQueryParams: zod.ZodObject<{
     billing_account_id: zod.ZodInt;
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, zod.z.core.$strict>;
+/**
+ * Usage billing by UTC calendar month for owned billing accounts, newest first. Each period combines its statements, the invoices they issued and how those invoices were paid; usage is billed about hourly, so a month holds many statements. Filter by billing_account_id and by period start.
+ * @summary List monthly statements
+ */
+export declare const listMonthlyStatementsQueryPageDefault = 1;
+export declare const listMonthlyStatementsQueryPageMax = 2147483647;
+export declare const listMonthlyStatementsQueryPageSizeDefault = 50;
+export declare const listMonthlyStatementsQueryPageSizeMax = 200;
+export declare const ListMonthlyStatementsQueryParams: zod.ZodObject<{
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    from: zod.ZodOptional<zod.z.ZodISODateTime>;
+    to: zod.ZodOptional<zod.z.ZodISODateTime>;
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
 /**
  * Paginated consumption statement batches for owned billing accounts, filtered by billing_account_id, open or closed state and period-start interval. A closed batch is not proof that the whole month has finished.
  * @summary List statements

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

@@ -389,8 +389,12 @@ export const DeletePaymentMethodParams = zod.strictObject({
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * 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.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -453,8 +457,9 @@ export const PreviewInvoicePaymentQueryParams = zod.strictObject({
  * 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.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` 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 void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1135,7 +1140,7 @@ export const GetOrderParams = zod.strictObject({
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * 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
@@ -1600,6 +1605,31 @@ export const ListSpendQueryParams = zod.strictObject({
         .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."),
 });
+/**
+ * Usage billing by UTC calendar month for owned billing accounts, newest first. Each period combines its statements, the invoices they issued and how those invoices were paid; usage is billed about hourly, so a month holds many statements. Filter by billing_account_id and by period start.
+ * @summary List monthly statements
+ */
+export const listMonthlyStatementsQueryPageDefault = 1;
+export const listMonthlyStatementsQueryPageMax = 2147483647;
+export const listMonthlyStatementsQueryPageSizeDefault = 50;
+export const listMonthlyStatementsQueryPageSizeMax = 200;
+export const ListMonthlyStatementsQueryParams = zod.strictObject({
+    billing_account_id: zod.int().optional(),
+    from: zod.iso.datetime({ offset: true }).optional().describe("Earliest period start, inclusive."),
+    to: zod.iso.datetime({ offset: true }).optional().describe("Latest period start, exclusive."),
+    page: zod
+        .int()
+        .min(1)
+        .max(listMonthlyStatementsQueryPageMax)
+        .default(listMonthlyStatementsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listMonthlyStatementsQueryPageSizeMax)
+        .default(listMonthlyStatementsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
 /**
  * Paginated consumption statement batches for owned billing accounts, filtered by billing_account_id, open or closed state and period-start interval. A closed batch is not proof that the whole month has finished.
  * @summary List statements

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

@@ -21,7 +21,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -0,0 +1,21 @@
+/**
+ * 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";
+export declare const listMonthlyStatementsParamsPageDefault = 1;
+export declare const listMonthlyStatementsParamsPageMax = 2147483647;
+export declare const listMonthlyStatementsParamsPageSizeDefault = 50;
+export declare const listMonthlyStatementsParamsPageSizeMax = 200;
+export declare const ListMonthlyStatementsParams: zod.ZodObject<{
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    from: zod.ZodOptional<zod.z.ZodISODateTime>;
+    to: zod.ZodOptional<zod.z.ZodISODateTime>;
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+export type ListMonthlyStatementsParams = zod.input<typeof ListMonthlyStatementsParams>;
+export type ListMonthlyStatementsParamsOutput = zod.output<typeof ListMonthlyStatementsParams>;

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

@@ -0,0 +1,27 @@
+/**
+ * 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";
+export const listMonthlyStatementsParamsPageDefault = 1;
+export const listMonthlyStatementsParamsPageMax = 2147483647;
+export const listMonthlyStatementsParamsPageSizeDefault = 50;
+export const listMonthlyStatementsParamsPageSizeMax = 200;
+export const ListMonthlyStatementsParams = zod.strictObject({
+    billing_account_id: zod.int().optional(),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(listMonthlyStatementsParamsPageMax)
+        .default(listMonthlyStatementsParamsPageDefault),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listMonthlyStatementsParamsPageSizeMax)
+        .default(listMonthlyStatementsParamsPageSizeDefault),
+});

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

@@ -0,0 +1,36 @@
+/**
+ * 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";
+export declare const MonthlyStatement: zod.ZodObject<{
+    billing_account_id: zod.ZodInt;
+    currency: zod.ZodString;
+    period_start: zod.z.ZodISODateTime;
+    period_end: zod.z.ZodISODateTime;
+    finalized: zod.ZodBoolean;
+    finalized_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    statement_count: zod.ZodInt;
+    billed: zod.ZodObject<{
+        subtotal: zod.ZodString;
+        discount_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        total: zod.ZodString;
+    }, zod.z.core.$strict>;
+    credited_amount: zod.ZodString;
+    unbilled: zod.ZodOptional<zod.ZodObject<{
+        subtotal: zod.ZodString;
+        discount_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        total: zod.ZodString;
+    }, zod.z.core.$strict>>;
+    credit_applied: zod.ZodString;
+    amount_paid: zod.ZodString;
+    amount_due: zod.ZodString;
+    amount_refunded: zod.ZodString;
+}, zod.z.core.$strict>;
+export type MonthlyStatement = zod.input<typeof MonthlyStatement>;
+export type MonthlyStatementOutput = zod.output<typeof MonthlyStatement>;