@leaflow/sdk 0.116.0 → 0.117.1

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

@@ -6,6 +6,70 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
+/**
+ * @summary List contacts
+ */
+export declare const ListContactsParams: zod.ZodObject<{
+    accountId: zod.ZodInt;
+}, zod.z.core.$strict>;
+export declare const listContactsQueryPageDefault = 1;
+export declare const listContactsQueryPageMax = 2147483647;
+export declare const listContactsQueryPageSizeDefault = 50;
+export declare const listContactsQueryPageSizeMax = 200;
+export declare const ListContactsQueryParams: zod.ZodObject<{
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;
+/**
+ * @summary Create contact
+ */
+export declare const CreateContactParams: zod.ZodObject<{
+    accountId: zod.ZodInt;
+}, zod.z.core.$strict>;
+export declare const CreateContactBody: zod.ZodObject<{
+    name: zod.ZodString;
+    legal_name: zod.ZodOptional<zod.ZodString>;
+    email: zod.ZodOptional<zod.ZodString>;
+    tax_id: zod.ZodOptional<zod.ZodString>;
+    address_line1: zod.ZodOptional<zod.ZodString>;
+    address_line2: zod.ZodOptional<zod.ZodString>;
+    address_city: zod.ZodOptional<zod.ZodString>;
+    address_state: zod.ZodOptional<zod.ZodString>;
+    address_postal_code: zod.ZodOptional<zod.ZodString>;
+    address_country: zod.ZodOptional<zod.ZodString>;
+}, zod.z.core.$strict>;
+/**
+ * @summary Get contact
+ */
+export declare const GetContactParams: zod.ZodObject<{
+    contactId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * @summary Update contact
+ */
+export declare const UpdateContactParams: zod.ZodObject<{
+    contactId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const UpdateContactBody: zod.ZodObject<{
+    name: zod.ZodOptional<zod.ZodString>;
+    legal_name: zod.ZodOptional<zod.ZodString>;
+    email: zod.ZodOptional<zod.ZodString>;
+    tax_id: zod.ZodOptional<zod.ZodString>;
+    address_line1: zod.ZodOptional<zod.ZodString>;
+    address_line2: zod.ZodOptional<zod.ZodString>;
+    address_city: zod.ZodOptional<zod.ZodString>;
+    address_state: zod.ZodOptional<zod.ZodString>;
+    address_postal_code: zod.ZodOptional<zod.ZodString>;
+    address_country: zod.ZodOptional<zod.ZodString>;
+    active: zod.ZodOptional<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+/**
+ * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * @summary Delete contact
+ */
+export declare const DeleteContactParams: zod.ZodObject<{
+    contactId: zod.ZodUUID;
+}, zod.z.core.$strict>;
 /**
  * The currencies a new billing account can be opened in. A retired currency is not listed,
  * although accounts already opened in it keep working. Results are paginated.
@@ -40,8 +104,6 @@ export declare const ListBillingAccountsQueryParams: zod.ZodObject<{
 export declare const CreateBillingAccountBody: zod.ZodObject<{
     currency: zod.ZodString;
     name: zod.ZodOptional<zod.ZodString>;
-    legal_name: zod.ZodOptional<zod.ZodString>;
-    email: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
  * @summary Get billing account
@@ -50,26 +112,17 @@ export declare const GetBillingAccountParams: zod.ZodObject<{
     accountId: zod.ZodInt;
 }, zod.z.core.$strict>;
 /**
- * The legal name, address and tax identifier are copied onto each invoice when it is
- * issued. Changing them here affects invoices issued afterwards, not those already sent.
- *
- * The currency cannot be changed.
+ * Select an active contact belonging to this account for future invoices. Its legal name,
+ * address and tax identifier are copied when an invoice is issued; issued snapshots are
+ * retained. Set invoice_contact_id to null to clear the selection. The currency cannot change.
  * @summary Update billing account
  */
 export declare const UpdateBillingAccountParams: zod.ZodObject<{
     accountId: zod.ZodInt;
 }, zod.z.core.$strict>;
 export declare const UpdateBillingAccountBody: zod.ZodObject<{
+    invoice_contact_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
     name: zod.ZodOptional<zod.ZodString>;
-    legal_name: zod.ZodOptional<zod.ZodString>;
-    email: zod.ZodOptional<zod.ZodString>;
-    address_line1: zod.ZodOptional<zod.ZodString>;
-    address_line2: zod.ZodOptional<zod.ZodString>;
-    address_city: zod.ZodOptional<zod.ZodString>;
-    address_state: zod.ZodOptional<zod.ZodString>;
-    address_postal_code: zod.ZodOptional<zod.ZodString>;
-    address_country: zod.ZodOptional<zod.ZodString>;
-    tax_id: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
  * @summary Get account balance
@@ -77,15 +130,6 @@ export declare const UpdateBillingAccountBody: zod.ZodObject<{
 export declare const GetAccountBalanceParams: zod.ZodObject<{
     accountId: zod.ZodInt;
 }, zod.z.core.$strict>;
-/**
- * Whether the account has anything billed by usage, and what that usage has cost over the last
- * seven days. Usage is paid from the balance, so this tells how much of the balance it is likely
- * to need: the balance divided by `average_daily_amount` is roughly how many days it lasts.
- * @summary Get account metered usage
- */
-export declare const GetAccountMeteredUsageParams: zod.ZodObject<{
-    accountId: zod.ZodInt;
-}, zod.z.core.$strict>;
 /**
  * Lists the payment gateways and methods that currently accept payment in this account's currency, the
  * preferred gateway first. Top-ups and invoice payments must name a gateway and method listed here;
@@ -480,9 +524,7 @@ export declare const ListRefundsQueryParams: zod.ZodObject<{
     order_id: zod.ZodOptional<zod.ZodUUID>;
 }, zod.z.core.$strict>;
 /**
- * Each charge is added to the month's usage invoice as it is priced, summed into one line per
- * subscription, project, resource, meter and rate. Filter by `invoice_item_id` to see the
- * charges behind a line. Charges still waiting to be priced are included too.
+ * Lists priced and unrated usage charges. Requires `statement_id`, `invoice_item_id`, or both `from` and `to` spanning at most 31 days; use the statement summary or spend report for longer periods. Charges are summed into one line per subscription, project, resource, meter and rate when their statement closes; filter by `invoice_item_id` to see the charges behind a line. Unrated charges had no applicable price when the usage occurred and are not billed.
  *
  * Only charges recorded against your billing accounts are included, before filtering, counting and pagination. Reassigning a project does not move previously recorded charges to its new account.
  * @summary List usage charges
@@ -505,6 +547,7 @@ export declare const ListUsageChargesQueryParams: zod.ZodObject<{
     to: zod.ZodOptional<zod.z.ZodISODateTime>;
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
     meter_id: zod.ZodOptional<zod.ZodUUID>;
+    statement_id: zod.ZodOptional<zod.ZodUUID>;
 }, zod.z.core.$strict>;
 /**
  * Lists subscriptions visible to the authorized billing account. Soft-deleted subscriptions are excluded.
@@ -1159,10 +1202,11 @@ export declare const ListActiveResourcesQueryParams: zod.ZodObject<{
     }>>;
 }, zod.z.core.$strict>;
 /**
- * Aggregates rated and invoiced usage charges in the specified time range for one billing account.
- * Includes usage not yet invoiced. Project filters use the account recorded on each charge, including
- * charges for projects later assigned to another account. The total covers all matching groups, not
- * just the returned page.
+ * Sums priced usage for one billing account by UTC day, including usage not yet invoiced. Amounts are
+ * before tax and before the tier adjustments made when a statement closes; minimum charges added at
+ * closing are included. `from` and `to` must fall on UTC day boundaries and span at most 92 days.
+ * Project filters use the account recorded on each charge, including charges for projects later
+ * assigned to another account. The total covers all matching groups, not just the returned page.
  * @summary List account spend
  */
 export declare const listSpendQueryGroupByDefault = "product";
@@ -1187,3 +1231,53 @@ export declare const ListSpendQueryParams: zod.ZodObject<{
     billing_account_id: zod.ZodInt;
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, zod.z.core.$strict>;
+/**
+ * @summary List statements
+ */
+export declare const listStatementsQueryPageDefault = 1;
+export declare const listStatementsQueryPageMax = 2147483647;
+export declare const listStatementsQueryPageSizeDefault = 50;
+export declare const listStatementsQueryPageSizeMax = 200;
+export declare const ListStatementsQueryParams: zod.ZodObject<{
+    billing_account_id: zod.ZodOptional<zod.ZodInt>;
+    status: zod.ZodOptional<zod.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>>;
+    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>;
+/**
+ * @summary Get statement
+ */
+export declare const GetStatementParams: zod.ZodObject<{
+    statementId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+/**
+ * Reads the consumption summary that is updated in the same transaction as usage is priced. Group by project, product or meter and filter within the statement. Quantities are included only for meter groups so different units are never combined.
+ * @summary Get grouped consumption
+ */
+export declare const GetStatementUsageParams: zod.ZodObject<{
+    statementId: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export declare const getStatementUsageQueryGroupByDefault = "meter";
+export declare const getStatementUsageQueryProjectIdsMax = 100;
+export declare const getStatementUsageQueryProductIdMax = 64;
+export declare const getStatementUsageQueryPageDefault = 1;
+export declare const getStatementUsageQueryPageMax = 2147483647;
+export declare const getStatementUsageQueryPageSizeDefault = 50;
+export declare const getStatementUsageQueryPageSizeMax = 200;
+export declare const GetStatementUsageQueryParams: zod.ZodObject<{
+    group_by: zod.ZodDefault<zod.ZodEnum<{
+        project: "project";
+        product: "product";
+        meter: "meter";
+    }>>;
+    project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
+    product_id: zod.ZodOptional<zod.ZodString>;
+    meter_id: zod.ZodOptional<zod.ZodUUID>;
+    page: zod.ZodDefault<zod.ZodInt>;
+    page_size: zod.ZodDefault<zod.ZodInt>;
+}, zod.z.core.$strict>;

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

@@ -12,6 +12,8 @@ import { BillingAccountUpdate } from "./validators/billingAccountUpdate.zod.js";
 import { CancelSubscriptionRequest } from "./validators/cancelSubscriptionRequest.zod.js";
 import { CancellationCreate } from "./validators/cancellationCreate.zod.js";
 import { CheckoutOrderRequest } from "./validators/checkoutOrderRequest.zod.js";
+import { ContactCreate } from "./validators/contactCreate.zod.js";
+import { ContactUpdate } from "./validators/contactUpdate.zod.js";
 import { OrderCancel } from "./validators/orderCancel.zod.js";
 import { PayInvoiceRequest } from "./validators/payInvoiceRequest.zod.js";
 import { PayTogetherRequest } from "./validators/payTogetherRequest.zod.js";
@@ -21,6 +23,57 @@ import { RenewRequest } from "./validators/renewRequest.zod.js";
 import { RenewalOrderRequest } from "./validators/renewalOrderRequest.zod.js";
 import { SetProjectAssignmentRequest } from "./validators/setProjectAssignmentRequest.zod.js";
 import { TopUpCreate } from "./validators/topUpCreate.zod.js";
+/**
+ * @summary List contacts
+ */
+export const ListContactsParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const listContactsQueryPageDefault = 1;
+export const listContactsQueryPageMax = 2147483647;
+export const listContactsQueryPageSizeDefault = 50;
+export const listContactsQueryPageSizeMax = 200;
+export const ListContactsQueryParams = zod.strictObject({
+    page: zod
+        .int()
+        .min(1)
+        .max(listContactsQueryPageMax)
+        .default(listContactsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listContactsQueryPageSizeMax)
+        .default(listContactsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary Create contact
+ */
+export const CreateContactParams = zod.strictObject({
+    accountId: zod.int(),
+});
+export const CreateContactBody = ContactCreate;
+/**
+ * @summary Get contact
+ */
+export const GetContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
+/**
+ * @summary Update contact
+ */
+export const UpdateContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
+export const UpdateContactBody = ContactUpdate;
+/**
+ * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * @summary Delete contact
+ */
+export const DeleteContactParams = zod.strictObject({
+    contactId: zod.uuid(),
+});
 /**
  * The currencies a new billing account can be opened in. A retired currency is not listed,
  * although accounts already opened in it keep working. Results are paginated.
@@ -80,10 +133,9 @@ export const GetBillingAccountParams = zod.strictObject({
     accountId: zod.int(),
 });
 /**
- * The legal name, address and tax identifier are copied onto each invoice when it is
- * issued. Changing them here affects invoices issued afterwards, not those already sent.
- *
- * The currency cannot be changed.
+ * Select an active contact belonging to this account for future invoices. Its legal name,
+ * address and tax identifier are copied when an invoice is issued; issued snapshots are
+ * retained. Set invoice_contact_id to null to clear the selection. The currency cannot change.
  * @summary Update billing account
  */
 export const UpdateBillingAccountParams = zod.strictObject({
@@ -96,15 +148,6 @@ export const UpdateBillingAccountBody = BillingAccountUpdate;
 export const GetAccountBalanceParams = zod.strictObject({
     accountId: zod.int(),
 });
-/**
- * Whether the account has anything billed by usage, and what that usage has cost over the last
- * seven days. Usage is paid from the balance, so this tells how much of the balance it is likely
- * to need: the balance divided by `average_daily_amount` is roughly how many days it lasts.
- * @summary Get account metered usage
- */
-export const GetAccountMeteredUsageParams = zod.strictObject({
-    accountId: zod.int(),
-});
 /**
  * Lists the payment gateways and methods that currently accept payment in this account's currency, the
  * preferred gateway first. Top-ups and invoice payments must name a gateway and method listed here;
@@ -415,7 +458,7 @@ export const ListInvoicesQueryParams = zod.strictObject({
     status: zod
         .enum(["draft", "open", "paid", "refunded", "void", "uncollectible"])
         .optional()
-        .describe("An order invoice stays `draft` until checkout confirms its discount and final amounts. It\ncannot be collected while draft. Confirmation makes it `open`, or `paid` when its total is zero\nwithout creating a payment transaction. A quote never changes this status.\n\nA usage invoice stays `draft` through its month: each charge is added to it as it is priced\nand paid from credits and balance as it goes. It is issued at the end of the month, becoming\n`paid` when everything was covered and `open` when something is still owed.\n\n`refunded` means the invoice was paid and has since been refunded in full; a partial refund\nleaves it `paid`, with the refunded part in `amount_refunded`.\n\n`void` means the invoice will not be paid and holds no money: nothing was paid, or its order\nfailed or was canceled and everything paid toward it has been returned, as `amount_paid` and\n`amount_refunded` show."),
+        .describe("Draft invoices are private to administrators and cannot be read, listed or paid by customers.\nAn issued invoice is open until settled; a zero-total issued invoice is immediately paid.\nUnbilled usage remains separate from invoices until it is invoiced.\nrefunded means a full refund; a partial refund leaves the invoice paid.\nvoid means collection has stopped and any funds received have been returned."),
     from: zod.iso.datetime({ offset: true }).optional(),
     to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
 });
@@ -622,9 +665,7 @@ export const ListRefundsQueryParams = zod.strictObject({
         .describe("Only the refunds that belong to this order: those of its invoice, such as the refund of a\npurchase that could not be delivered, and those it caused on an earlier invoice, such as\nthe difference returned after a downgrade."),
 });
 /**
- * Each charge is added to the month's usage invoice as it is priced, summed into one line per
- * subscription, project, resource, meter and rate. Filter by `invoice_item_id` to see the
- * charges behind a line. Charges still waiting to be priced are included too.
+ * Lists priced and unrated usage charges. Requires `statement_id`, `invoice_item_id`, or both `from` and `to` spanning at most 31 days; use the statement summary or spend report for longer periods. Charges are summed into one line per subscription, project, resource, meter and rate when their statement closes; filter by `invoice_item_id` to see the charges behind a line. Unrated charges had no applicable price when the usage occurred and are not billed.
  *
  * Only charges recorded against your billing accounts are included, before filtering, counting and pagination. Reassigning a project does not move previously recorded charges to its new account.
  * @summary List usage charges
@@ -674,6 +715,7 @@ export const ListUsageChargesQueryParams = 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."),
     meter_id: zod.uuid().optional(),
+    statement_id: zod.uuid().optional(),
 });
 /**
  * Lists subscriptions visible to the authorized billing account. Soft-deleted subscriptions are excluded.
@@ -1453,10 +1495,11 @@ export const ListActiveResourcesQueryParams = zod.strictObject({
     status: zod.enum(["active", "suspended", "closing", "completed"]).optional(),
 });
 /**
- * Aggregates rated and invoiced usage charges in the specified time range for one billing account.
- * Includes usage not yet invoiced. Project filters use the account recorded on each charge, including
- * charges for projects later assigned to another account. The total covers all matching groups, not
- * just the returned page.
+ * Sums priced usage for one billing account by UTC day, including usage not yet invoiced. Amounts are
+ * before tax and before the tier adjustments made when a statement closes; minimum charges added at
+ * closing are included. `from` and `to` must fall on UTC day boundaries and span at most 92 days.
+ * Project filters use the account recorded on each charge, including charges for projects later
+ * assigned to another account. The total covers all matching groups, not just the returned page.
  * @summary List account spend
  */
 export const listSpendQueryGroupByDefault = `product`;
@@ -1475,7 +1518,7 @@ export const ListSpendQueryParams = zod.strictObject({
     group_by: zod
         .enum(["product", "plan", "resource"])
         .default(listSpendQueryGroupByDefault)
-        .describe("`resource` groups by the resource each charge names. Items billed under their own\nidentifier — a disk, a public address — appear as their own rows rather than under\nthe machine they are attached to, since the relationship between them is known to\nthe owning service and not here."),
+        .describe("`plan` groups by the plan of the price each charge was priced with, which stays the same after the\nsubscription changes plan. `resource` groups by the resource each charge names. Items billed under their own\nidentifier — a disk, a public address — appear as their own rows rather than under\nthe machine they are attached to, since the relationship between them is known to\nthe owning service and not here."),
     product_id: zod
         .string()
         .min(1)
@@ -1505,3 +1548,66 @@ 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."),
 });
+/**
+ * @summary List statements
+ */
+export const listStatementsQueryPageDefault = 1;
+export const listStatementsQueryPageMax = 2147483647;
+export const listStatementsQueryPageSizeDefault = 50;
+export const listStatementsQueryPageSizeMax = 200;
+export const ListStatementsQueryParams = zod.strictObject({
+    billing_account_id: zod.int().optional(),
+    status: zod.enum(["open", "closed"]).optional(),
+    from: zod.iso.datetime({ offset: true }).optional(),
+    to: zod.iso.datetime({ offset: true }).optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(listStatementsQueryPageMax)
+        .default(listStatementsQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(listStatementsQueryPageSizeMax)
+        .default(listStatementsQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});
+/**
+ * @summary Get statement
+ */
+export const GetStatementParams = zod.strictObject({
+    statementId: zod.uuid(),
+});
+/**
+ * Reads the consumption summary that is updated in the same transaction as usage is priced. Group by project, product or meter and filter within the statement. Quantities are included only for meter groups so different units are never combined.
+ * @summary Get grouped consumption
+ */
+export const GetStatementUsageParams = zod.strictObject({
+    statementId: zod.uuid(),
+});
+export const getStatementUsageQueryGroupByDefault = `meter`;
+export const getStatementUsageQueryProjectIdsMax = 100;
+export const getStatementUsageQueryProductIdMax = 64;
+export const getStatementUsageQueryPageDefault = 1;
+export const getStatementUsageQueryPageMax = 2147483647;
+export const getStatementUsageQueryPageSizeDefault = 50;
+export const getStatementUsageQueryPageSizeMax = 200;
+export const GetStatementUsageQueryParams = zod.strictObject({
+    group_by: zod.enum(["project", "product", "meter"]).default(getStatementUsageQueryGroupByDefault),
+    project_ids: zod.array(zod.uuid()).max(getStatementUsageQueryProjectIdsMax).optional(),
+    product_id: zod.string().max(getStatementUsageQueryProductIdMax).optional(),
+    meter_id: zod.uuid().optional(),
+    page: zod
+        .int()
+        .min(1)
+        .max(getStatementUsageQueryPageMax)
+        .default(getStatementUsageQueryPageDefault)
+        .describe("1-based page number. Defaults to 1."),
+    page_size: zod
+        .int()
+        .min(1)
+        .max(getStatementUsageQueryPageSizeMax)
+        .default(getStatementUsageQueryPageSizeDefault)
+        .describe("Items per page. Defaults to 50; at most 200."),
+});

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

@@ -7,11 +7,12 @@
  */
 import * as zod from "zod";
 export declare const AccountBalance: zod.ZodObject<{
+    available_credit: zod.ZodString;
+    unbilled_amount: zod.ZodString;
     billing_account_id: zod.ZodInt;
     currency: zod.ZodString;
     balance: zod.ZodString;
     credits: zod.ZodString;
-    total: zod.ZodString;
     restricted_credits: zod.ZodString;
     credit_groups: zod.ZodArray<zod.ZodObject<{
         applies_to: zod.ZodObject<{
@@ -116,6 +117,7 @@ export declare const AccountBalance: zod.ZodObject<{
         amount: zod.ZodString;
     }, zod.z.core.$strict>>;
     due: zod.ZodString;
+    pending_returns_amount: zod.ZodString;
 }, zod.z.core.$strict>;
 export type AccountBalance = zod.input<typeof AccountBalance>;
 export type AccountBalanceOutput = zod.output<typeof AccountBalance>;

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

@@ -10,15 +10,17 @@ import { CreditGroup } from "./creditGroup.zod.js";
 import { Money } from "./money.zod.js";
 export const AccountBalance = zod
     .strictObject({
+    available_credit: Money.describe("Balance minus pending balance returns, unbilled usage estimates and issued unpaid amounts. Credit grants are excluded; the result may be negative."),
+    unbilled_amount: Money.describe("Current estimate of rated usage that has not been invoiced. Final pricing and tax are fixed at issuance."),
     billing_account_id: zod.int(),
     currency: zod.string(),
     balance: Money.describe("Prepaid funds in the account currency, excluding credits. May be negative after a payment\ndispute. Outstanding charges are reported separately in due; this value is not a withdrawal quote."),
     credits: Money.describe("The recorded remaining credit, including restricted grants. It is not withdrawable\nand is not part of balance. credit_groups describes currently valid credit by permitted use; a positive\ncredits balance does not imply that due is zero."),
-    total: Money.describe("balance plus credits, the sum shown as the account's funds. Credits count at their recorded remaining\namount, including restricted grants that only pay for what they allow, so total is an upper bound of what\nthe account can pay with rather than a withdrawable amount. due is reported separately and is not subtracted."),
-    restricted_credits: Money.describe("The part of currently valid credit that only pays for what its restrictions allow, such as a single\nservice, a billing type or a first purchase. The rest of the valid credit pays for anything on the account.\nIncluded in credits and therefore in total."),
+    restricted_credits: Money.describe("Currently valid credit whose use has applicable product, operation or eligibility conditions. Included in credits, separate from the balance."),
     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("Owed and not yet paid: metered usage that balance and applicable credit could not cover as it was\ncharged, and issued usage invoices still unpaid. The account is in arrears while this\nis above zero. Topping up pays it on the next collection."),
+    due: Money.describe("Amount still payable on issued invoices. 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/billingAccount.zod.d.ts

@@ -7,17 +7,9 @@
  */
 import * as zod from "zod";
 export declare const BillingAccount: zod.ZodObject<{
+    invoice_contact_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
     id: zod.ZodInt;
     name: zod.ZodOptional<zod.ZodString>;
-    legal_name: zod.ZodOptional<zod.ZodString>;
-    email: zod.ZodOptional<zod.ZodString>;
-    address_line1: zod.ZodOptional<zod.ZodString>;
-    address_line2: zod.ZodOptional<zod.ZodString>;
-    address_city: zod.ZodOptional<zod.ZodString>;
-    address_state: zod.ZodOptional<zod.ZodString>;
-    address_postal_code: zod.ZodOptional<zod.ZodString>;
-    address_country: zod.ZodOptional<zod.ZodString>;
-    tax_id: zod.ZodOptional<zod.ZodString>;
     currency: zod.ZodString;
     status: zod.ZodEnum<{
         active: "active";

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

@@ -7,20 +7,12 @@
  */
 import * as zod from "zod";
 export const BillingAccount = zod.strictObject({
+    invoice_contact_id: zod
+        .uuid()
+        .nullish()
+        .describe("The active contact used for invoicing. Must belong to this account; null clears the selection."),
     id: zod.int(),
     name: zod.string().optional().describe("What you call this account."),
-    legal_name: zod
-        .string()
-        .optional()
-        .describe("The name invoices are made out to. Copied onto each invoice when it is issued."),
-    email: zod.string().optional().describe("Where invoices are sent."),
-    address_line1: zod.string().optional(),
-    address_line2: zod.string().optional(),
-    address_city: zod.string().optional(),
-    address_state: zod.string().optional(),
-    address_postal_code: zod.string().optional(),
-    address_country: zod.string().optional().describe("Two-letter code."),
-    tax_id: zod.string().optional(),
     currency: zod.string().describe("Fixed when the account was opened."),
     status: zod.enum(["active", "suspended", "closed"]),
     grace_amount: zod

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

@@ -9,13 +9,9 @@ import * as zod from "zod";
 export declare const billingAccountCreateCurrencyMin = 3;
 export declare const billingAccountCreateCurrencyMax = 3;
 export declare const billingAccountCreateNameMax = 255;
-export declare const billingAccountCreateLegalNameMax = 255;
-export declare const billingAccountCreateEmailMax = 255;
 export declare const BillingAccountCreate: zod.ZodObject<{
     currency: zod.ZodString;
     name: zod.ZodOptional<zod.ZodString>;
-    legal_name: zod.ZodOptional<zod.ZodString>;
-    email: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 export type BillingAccountCreate = zod.input<typeof BillingAccountCreate>;
 export type BillingAccountCreateOutput = zod.output<typeof BillingAccountCreate>;

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

@@ -9,11 +9,7 @@ import * as zod from "zod";
 export const billingAccountCreateCurrencyMin = 3;
 export const billingAccountCreateCurrencyMax = 3;
 export const billingAccountCreateNameMax = 255;
-export const billingAccountCreateLegalNameMax = 255;
-export const billingAccountCreateEmailMax = 255;
 export const BillingAccountCreate = zod.strictObject({
     currency: zod.string().min(billingAccountCreateCurrencyMin).max(billingAccountCreateCurrencyMax),
     name: zod.string().max(billingAccountCreateNameMax).optional(),
-    legal_name: zod.string().max(billingAccountCreateLegalNameMax).optional(),
-    email: zod.string().max(billingAccountCreateEmailMax).optional(),
 });

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

@@ -8,17 +8,9 @@
 import * as zod from "zod";
 export declare const BillingAccountList: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
+        invoice_contact_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
         id: zod.ZodInt;
         name: zod.ZodOptional<zod.ZodString>;
-        legal_name: zod.ZodOptional<zod.ZodString>;
-        email: zod.ZodOptional<zod.ZodString>;
-        address_line1: zod.ZodOptional<zod.ZodString>;
-        address_line2: zod.ZodOptional<zod.ZodString>;
-        address_city: zod.ZodOptional<zod.ZodString>;
-        address_state: zod.ZodOptional<zod.ZodString>;
-        address_postal_code: zod.ZodOptional<zod.ZodString>;
-        address_country: zod.ZodOptional<zod.ZodString>;
-        tax_id: zod.ZodOptional<zod.ZodString>;
         currency: zod.ZodString;
         status: zod.ZodEnum<{
             active: "active";

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

@@ -7,27 +7,9 @@
  */
 import * as zod from "zod";
 export declare const billingAccountUpdateNameMax = 255;
-export declare const billingAccountUpdateLegalNameMax = 255;
-export declare const billingAccountUpdateEmailMax = 255;
-export declare const billingAccountUpdateAddressLine1Max = 255;
-export declare const billingAccountUpdateAddressLine2Max = 255;
-export declare const billingAccountUpdateAddressCityMax = 128;
-export declare const billingAccountUpdateAddressStateMax = 128;
-export declare const billingAccountUpdateAddressPostalCodeMax = 32;
-export declare const billingAccountUpdateAddressCountryMin = 2;
-export declare const billingAccountUpdateAddressCountryMax = 2;
-export declare const billingAccountUpdateTaxIdMax = 64;
 export declare const BillingAccountUpdate: zod.ZodObject<{
+    invoice_contact_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
     name: zod.ZodOptional<zod.ZodString>;
-    legal_name: zod.ZodOptional<zod.ZodString>;
-    email: zod.ZodOptional<zod.ZodString>;
-    address_line1: zod.ZodOptional<zod.ZodString>;
-    address_line2: zod.ZodOptional<zod.ZodString>;
-    address_city: zod.ZodOptional<zod.ZodString>;
-    address_state: zod.ZodOptional<zod.ZodString>;
-    address_postal_code: zod.ZodOptional<zod.ZodString>;
-    address_country: zod.ZodOptional<zod.ZodString>;
-    tax_id: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 export type BillingAccountUpdate = zod.input<typeof BillingAccountUpdate>;
 export type BillingAccountUpdateOutput = zod.output<typeof BillingAccountUpdate>;

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

@@ -7,29 +7,10 @@
  */
 import * as zod from "zod";
 export const billingAccountUpdateNameMax = 255;
-export const billingAccountUpdateLegalNameMax = 255;
-export const billingAccountUpdateEmailMax = 255;
-export const billingAccountUpdateAddressLine1Max = 255;
-export const billingAccountUpdateAddressLine2Max = 255;
-export const billingAccountUpdateAddressCityMax = 128;
-export const billingAccountUpdateAddressStateMax = 128;
-export const billingAccountUpdateAddressPostalCodeMax = 32;
-export const billingAccountUpdateAddressCountryMin = 2;
-export const billingAccountUpdateAddressCountryMax = 2;
-export const billingAccountUpdateTaxIdMax = 64;
 export const BillingAccountUpdate = zod.strictObject({
+    invoice_contact_id: zod
+        .uuid()
+        .nullish()
+        .describe("The active contact used for invoicing. Must belong to this account; null clears the selection."),
     name: zod.string().max(billingAccountUpdateNameMax).optional(),
-    legal_name: zod.string().max(billingAccountUpdateLegalNameMax).optional(),
-    email: zod.string().max(billingAccountUpdateEmailMax).optional(),
-    address_line1: zod.string().max(billingAccountUpdateAddressLine1Max).optional(),
-    address_line2: zod.string().max(billingAccountUpdateAddressLine2Max).optional(),
-    address_city: zod.string().max(billingAccountUpdateAddressCityMax).optional(),
-    address_state: zod.string().max(billingAccountUpdateAddressStateMax).optional(),
-    address_postal_code: zod.string().max(billingAccountUpdateAddressPostalCodeMax).optional(),
-    address_country: zod
-        .string()
-        .min(billingAccountUpdateAddressCountryMin)
-        .max(billingAccountUpdateAddressCountryMax)
-        .optional(),
-    tax_id: zod.string().max(billingAccountUpdateTaxIdMax).optional(),
 });