@leaflow/sdk 0.126.0 → 0.127.0

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

@@ -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/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;
@@ -1770,6 +1770,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

@@ -2064,6 +2064,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

@@ -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

@@ -1273,6 +1273,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

@@ -1600,6 +1600,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/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>;

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

@@ -0,0 +1,30 @@
+/**
+ * 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 { 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/v1/generated/validators/monthlyStatementList.zod.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 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/v1/generated/validators/monthlyStatementList.zod.js

@@ -0,0 +1,14 @@
+/**
+ * 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 { MonthlyStatement } from "./monthlyStatement.zod.js";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+export const MonthlyStatementList = zod.strictObject({
+    items: zod.array(MonthlyStatement),
+    pagination: OffsetPagination,
+});

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

@@ -3342,6 +3342,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/canopy/v1/generated/validators/monthlyStatement.zod.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These endpoints do not accept an API key, and the forwarding endpoints do not accept a scoped token.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+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/canopy/v1/generated/validators/monthlyStatement.zod.js

@@ -0,0 +1,53 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These endpoints do not accept an API key, and the forwarding endpoints do not accept a scoped token.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+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/canopy/v1/generated/validators/monthlyStatementList.zod.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These endpoints do not accept an API key, and the forwarding endpoints do not accept a scoped token.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+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/canopy/v1/generated/validators/monthlyStatementList.zod.js

@@ -0,0 +1,37 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These endpoints do not accept an API key, and the forwarding endpoints do not accept a scoped token.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+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/compute/v1/generated/models.d.ts

@@ -5288,6 +5288,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/compute/v1/generated/validators/monthlyStatement.zod.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+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/compute/v1/generated/validators/monthlyStatement.zod.js

@@ -0,0 +1,46 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+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/compute/v1/generated/validators/monthlyStatementList.zod.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+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/compute/v1/generated/validators/monthlyStatementList.zod.js

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+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/membership/v1/generated/models.d.ts

@@ -3165,6 +3165,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/membership/v1/generated/validators/monthlyStatement.zod.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+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/membership/v1/generated/validators/monthlyStatement.zod.js

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+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/membership/v1/generated/validators/monthlyStatementList.zod.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+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/membership/v1/generated/validators/monthlyStatementList.zod.js

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+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/routes.d.ts

@@ -1038,6 +1038,14 @@ export declare const routes: readonly [{
     readonly operationId: "list-spend";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
+}, {
+    readonly service: "billing";
+    readonly contract: "billing";
+    readonly method: "GET";
+    readonly path: "/api/v1/monthly-statements";
+    readonly operationId: "list-monthly-statements";
+    readonly securityScheme: "AccessToken";
+    readonly upstreamUrl: "https://billing.leaflow.cloud";
 }, {
     readonly service: "billing";
     readonly contract: "billing";

package/dist/routes.js

@@ -1170,6 +1170,15 @@ export const routes = [
         securityScheme: "AccessToken",
         upstreamUrl: "https://billing.leaflow.cloud",
     },
+    {
+        service: "billing",
+        contract: "billing",
+        method: "GET",
+        path: "/api/v1/monthly-statements",
+        operationId: "list-monthly-statements",
+        securityScheme: "AccessToken",
+        upstreamUrl: "https://billing.leaflow.cloud",
+    },
     {
         service: "billing",
         contract: "billing",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leaflow/sdk",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "description": "Leaflow 平台 API 的 TypeScript SDK",
   "license": "MIT",
   "repository": {