@leaflow/sdk 0.117.1 → 0.118.0

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

@@ -29,6 +29,7 @@ export type listContactsResponseError = listContactsResponseDefault & {
 export type listContactsResponse = listContactsResponseSuccess | listContactsResponseError;
 export declare const getListContactsUrl: (accountId: number, params?: ListContactsParams) => string;
 /**
+ * Paginated contact profiles belonging to the billing account in the path, including inactive contacts. Returns 404 if the account does not exist.
  * @summary List contacts
  */
 export declare const listContacts: (accountId: number, params?: ListContactsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listContactsResponse>;
@@ -49,6 +50,7 @@ export type createContactResponseError = createContactResponseDefault & {
 export type createContactResponse = createContactResponseSuccess | createContactResponseError;
 export declare const getCreateContactUrl: (accountId: number) => string;
 /**
+ * Creates a contact profile for the billing account in the path. Creating a contact does not select it for invoicing; set the account invoice_contact_id separately.
  * @summary Create contact
  */
 export declare const createContact: (accountId: number, contactCreate: ContactCreate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createContactResponse>;
@@ -67,11 +69,12 @@ export type getContactResponseError = getContactResponseDefault & {
     headers: Headers;
 };
 export type getContactResponse = getContactResponseSuccess | getContactResponseError;
-export declare const getGetContactUrl: (contactId: string) => string;
+export declare const getGetContactUrl: (accountId: number, contactId: string) => string;
 /**
+ * Returns a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Get contact
  */
-export declare const getContact: (contactId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getContactResponse>;
+export declare const getContact: (accountId: number, contactId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getContactResponse>;
 export type updateContactResponse200 = {
     data: Contact;
     status: 200;
@@ -87,11 +90,12 @@ export type updateContactResponseError = updateContactResponseDefault & {
     headers: Headers;
 };
 export type updateContactResponse = updateContactResponseSuccess | updateContactResponseError;
-export declare const getUpdateContactUrl: (contactId: string) => string;
+export declare const getUpdateContactUrl: (accountId: number, contactId: string) => string;
 /**
+ * Updates a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Update contact
  */
-export declare const updateContact: (contactId: string, contactUpdate: ContactUpdate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<updateContactResponse>;
+export declare const updateContact: (accountId: number, contactId: string, contactUpdate: ContactUpdate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<updateContactResponse>;
 export type deleteContactResponse204 = {
     data: void;
     status: 204;
@@ -107,12 +111,12 @@ export type deleteContactResponseError = deleteContactResponseDefault & {
     headers: Headers;
 };
 export type deleteContactResponse = deleteContactResponseSuccess | deleteContactResponseError;
-export declare const getDeleteContactUrl: (contactId: string) => string;
+export declare const getDeleteContactUrl: (accountId: number, contactId: string) => string;
 /**
- * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * Deletes a contact belonging to this billing account. Returns 404 if the contact does not exist in this account. The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
  * @summary Delete contact
  */
-export declare const deleteContact: (contactId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteContactResponse>;
+export declare const deleteContact: (accountId: number, contactId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteContactResponse>;
 export type listCurrenciesResponse200 = {
     data: CurrencyList;
     status: 200;
@@ -152,6 +156,7 @@ export type listBillingAccountsResponseError = listBillingAccountsResponseDefaul
 export type listBillingAccountsResponse = listBillingAccountsResponseSuccess | listBillingAccountsResponseError;
 export declare const getListBillingAccountsUrl: (params?: ListBillingAccountsParams) => string;
 /**
+ * Paginated billing accounts owned by the authenticated user. Accounts owned by other users are excluded; the result is empty when the user owns none.
  * @summary List billing accounts
  */
 export declare const listBillingAccounts: (params?: ListBillingAccountsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listBillingAccountsResponse>;
@@ -196,6 +201,7 @@ export type getBillingAccountResponseError = getBillingAccountResponseDefault &
 export type getBillingAccountResponse = getBillingAccountResponseSuccess | getBillingAccountResponseError;
 export declare const getGetBillingAccountUrl: (accountId: number) => string;
 /**
+ * Returns an owned account settlement currency, lifecycle state and selected invoice contact. Returns 404 if the account does not exist and 403 if it belongs to another user.
  * @summary Get billing account
  */
 export declare const getBillingAccount: (accountId: number, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getBillingAccountResponse>;
@@ -239,6 +245,7 @@ export type getAccountBalanceResponseError = getAccountBalanceResponseDefault &
 export type getAccountBalanceResponse = getAccountBalanceResponseSuccess | getAccountBalanceResponseError;
 export declare const getGetAccountBalanceUrl: (accountId: number) => string;
 /**
+ * Returns the owned account balance, applicable credit groups, unpaid invoice amounts, unbilled estimates and pending returns separately. Returns 404 for a missing account and 403 for an account owned by another user.
  * @summary Get account balance
  */
 export declare const getAccountBalance: (accountId: number, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getAccountBalanceResponse>;
@@ -283,6 +290,7 @@ export type listProjectAssignmentsResponseError = listProjectAssignmentsResponse
 export type listProjectAssignmentsResponse = listProjectAssignmentsResponseSuccess | listProjectAssignmentsResponseError;
 export declare const getListProjectAssignmentsUrl: (params?: ListProjectAssignmentsParams) => string;
 /**
+ * Paginated current project assignments to accounts owned by the authenticated user. Filter by billing_account_id or project_ids; historical financial records keep their original account assignment.
  * @summary List project assignments
  */
 export declare const listProjectAssignments: (params?: ListProjectAssignmentsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listProjectAssignmentsResponse>;
@@ -493,6 +501,7 @@ export type listPaymentMethodsResponseError = listPaymentMethodsResponseDefault
 export type listPaymentMethodsResponse = listPaymentMethodsResponseSuccess | listPaymentMethodsResponseError;
 export declare const getListPaymentMethodsUrl: (params?: ListPaymentMethodsParams) => string;
 /**
+ * Paginated saved payment methods for owned billing accounts, optionally restricted to billing_account_id. Removed methods are excluded; they do not disappear from historical payment records.
  * @summary List payment methods
  */
 export declare const listPaymentMethods: (params?: ListPaymentMethodsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listPaymentMethodsResponse>;
@@ -538,6 +547,7 @@ export type setDefaultPaymentMethodResponseError = setDefaultPaymentMethodRespon
 export type setDefaultPaymentMethodResponse = setDefaultPaymentMethodResponseSuccess | setDefaultPaymentMethodResponseError;
 export declare const getSetDefaultPaymentMethodUrl: (paymentMethodId: string) => string;
 /**
+ * Selects an active saved payment method as the default for its owned billing account and returns it. Expired or removed methods cannot be selected; selecting the current default is idempotent.
  * @summary Set default payment method
  */
 export declare const setDefaultPaymentMethod: (paymentMethodId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<setDefaultPaymentMethodResponse>;
@@ -699,6 +709,7 @@ export type listInvoicesResponseError = listInvoicesResponseDefault & {
 export type listInvoicesResponse = listInvoicesResponseSuccess | listInvoicesResponseError;
 export declare const getListInvoicesUrl: (params?: ListInvoicesParams) => string;
 /**
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
  * @summary List invoices
  */
 export declare const listInvoices: (params?: ListInvoicesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listInvoicesResponse>;
@@ -719,6 +730,7 @@ export type getInvoiceResponseError = getInvoiceResponseDefault & {
 export type getInvoiceResponse = getInvoiceResponseSuccess | getInvoiceResponseError;
 export declare const getGetInvoiceUrl: (invoiceId: string) => string;
 /**
+ * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export declare const getInvoice: (invoiceId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getInvoiceResponse>;
@@ -739,6 +751,7 @@ export type listInvoiceItemsResponseError = listInvoiceItemsResponseDefault & {
 export type listInvoiceItemsResponse = listInvoiceItemsResponseSuccess | listInvoiceItemsResponseError;
 export declare const getListInvoiceItemsUrl: (invoiceId: string, params?: ListInvoiceItemsParams) => string;
 /**
+ * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export declare const listInvoiceItems: (invoiceId: string, params?: ListInvoiceItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listInvoiceItemsResponse>;
@@ -759,6 +772,7 @@ export type listTransactionsResponseError = listTransactionsResponseDefault & {
 export type listTransactionsResponse = listTransactionsResponseSuccess | listTransactionsResponseError;
 export declare const getListTransactionsUrl: (params?: ListTransactionsParams) => string;
 /**
+ * Paginated ledger entries for owned billing accounts, optionally filtered by billing_account_id and creation interval. Each entry retains its amount, currency and any referenced credit grant.
  * @summary List transactions
  */
 export declare const listTransactions: (params?: ListTransactionsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listTransactionsResponse>;
@@ -1143,6 +1157,7 @@ export type getCancellationResponseError = getCancellationResponseDefault & {
 export type getCancellationResponse = getCancellationResponseSuccess | getCancellationResponseError;
 export declare const getGetCancellationUrl: (cancellationId: string) => string;
 /**
+ * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export declare const getCancellation: (cancellationId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCancellationResponse>;
@@ -1354,6 +1369,7 @@ export type getOrderResponseError = getOrderResponseDefault & {
 export type getOrderResponse = getOrderResponseSuccess | getOrderResponseError;
 export declare const getGetOrderUrl: (orderId: string) => string;
 /**
+ * Returns an order charged to an owned billing account with its commercial state and invoice reference. An unknown order returns 404; an order on another user account is forbidden.
  * @summary Get order
  */
 export declare const getOrder: (orderId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getOrderResponse>;
@@ -1550,6 +1566,7 @@ export type listProductsResponseError = (listProductsResponse304 | listProductsR
 export type listProductsResponse = listProductsResponseSuccess | listProductsResponseError;
 export declare const getListProductsUrl: (params?: ListProductsParams) => string;
 /**
+ * Paginated registered catalog products with their service identities and descriptions. Supports If- None-Match and returns 304 when the selected page has not changed.
  * @summary List catalog products
  */
 export declare const listProducts: (params?: ListProductsParams, headers?: ListProductsHeaders, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listProductsResponse>;
@@ -1651,6 +1668,7 @@ export type listPlansResponseError = (listPlansResponse304 | listPlansResponseDe
 export type listPlansResponse = listPlansResponseSuccess | listPlansResponseError;
 export declare const getListPlansUrl: (params: ListPlansParams) => string;
 /**
+ * Paginated active plans for the required product_id, with their feature allocations. An unknown product returns 404; If-None-Match can return 304 for an unchanged page.
  * @summary List catalog plans
  */
 export declare const listPlans: (params: ListPlansParams, headers?: ListPlansHeaders, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listPlansResponse>;
@@ -1771,6 +1789,7 @@ export type listStatementsResponseError = listStatementsResponseDefault & {
 export type listStatementsResponse = listStatementsResponseSuccess | listStatementsResponseError;
 export declare const getListStatementsUrl: (params?: ListStatementsParams) => string;
 /**
+ * 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
  */
 export declare const listStatements: (params?: ListStatementsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listStatementsResponse>;
@@ -1791,6 +1810,7 @@ export type getStatementResponseError = getStatementResponseDefault & {
 export type getStatementResponse = getStatementResponseSuccess | getStatementResponseError;
 export declare const getGetStatementUrl: (statementId: string) => string;
 /**
+ * Returns an owned-account consumption batch with its period, estimated or closed amounts and invoice reference. Returns 404 for a missing batch and 403 when the billing account belongs to another user.
  * @summary Get statement
  */
 export declare const getStatement: (statementId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getStatementResponse>;

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

@@ -11,6 +11,7 @@ export const getListContactsUrl = (accountId, params) => {
         : `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/contacts`;
 };
 /**
+ * Paginated contact profiles belonging to the billing account in the path, including inactive contacts. Returns 404 if the account does not exist.
  * @summary List contacts
  */
 export const listContacts = async (accountId, params, options, fetchFn) => {
@@ -26,6 +27,7 @@ export const getCreateContactUrl = (accountId) => {
     return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/contacts`;
 };
 /**
+ * Creates a contact profile for the billing account in the path. Creating a contact does not select it for invoicing; set the account invoice_contact_id separately.
  * @summary Create contact
  */
 export const createContact = async (accountId, contactCreate, options, fetchFn) => {
@@ -54,14 +56,15 @@ export const createContact = async (accountId, contactCreate, options, fetchFn)
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getGetContactUrl = (contactId) => {
-    return `https://billing.leaflow.cloud/api/v1/contacts/${encodeURIComponent(String(contactId))}`;
+export const getGetContactUrl = (accountId, contactId) => {
+    return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/contacts/${encodeURIComponent(String(contactId))}`;
 };
 /**
+ * Returns a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Get contact
  */
-export const getContact = async (contactId, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getGetContactUrl(contactId), {
+export const getContact = async (accountId, contactId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetContactUrl(accountId, contactId), {
         ...options,
         method: "GET",
     });
@@ -69,13 +72,14 @@ export const getContact = async (contactId, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getUpdateContactUrl = (contactId) => {
-    return `https://billing.leaflow.cloud/api/v1/contacts/${encodeURIComponent(String(contactId))}`;
+export const getUpdateContactUrl = (accountId, contactId) => {
+    return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/contacts/${encodeURIComponent(String(contactId))}`;
 };
 /**
+ * Updates a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Update contact
  */
-export const updateContact = async (contactId, contactUpdate, options, fetchFn) => {
+export const updateContact = async (accountId, contactId, contactUpdate, options, fetchFn) => {
     const getHeaders = (h) => {
         if (!h)
             return {};
@@ -91,7 +95,7 @@ export const updateContact = async (contactId, contactUpdate, options, fetchFn)
         }
         return headers;
     };
-    const res = await (fetchFn ?? fetch)(getUpdateContactUrl(contactId), {
+    const res = await (fetchFn ?? fetch)(getUpdateContactUrl(accountId, contactId), {
         ...options,
         method: "PATCH",
         headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
@@ -101,15 +105,15 @@ export const updateContact = async (contactId, contactUpdate, options, fetchFn)
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getDeleteContactUrl = (contactId) => {
-    return `https://billing.leaflow.cloud/api/v1/contacts/${encodeURIComponent(String(contactId))}`;
+export const getDeleteContactUrl = (accountId, contactId) => {
+    return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/contacts/${encodeURIComponent(String(contactId))}`;
 };
 /**
- * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * Deletes a contact belonging to this billing account. Returns 404 if the contact does not exist in this account. The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
  * @summary Delete contact
  */
-export const deleteContact = async (contactId, options, fetchFn) => {
-    const res = await (fetchFn ?? fetch)(getDeleteContactUrl(contactId), {
+export const deleteContact = async (accountId, contactId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteContactUrl(accountId, contactId), {
         ...options,
         method: "DELETE",
     });
@@ -156,6 +160,7 @@ export const getListBillingAccountsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/billing-accounts`;
 };
 /**
+ * Paginated billing accounts owned by the authenticated user. Accounts owned by other users are excluded; the result is empty when the user owns none.
  * @summary List billing accounts
  */
 export const listBillingAccounts = async (params, options, fetchFn) => {
@@ -207,6 +212,7 @@ export const getGetBillingAccountUrl = (accountId) => {
     return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}`;
 };
 /**
+ * Returns an owned account settlement currency, lifecycle state and selected invoice contact. Returns 404 if the account does not exist and 403 if it belongs to another user.
  * @summary Get billing account
  */
 export const getBillingAccount = async (accountId, options, fetchFn) => {
@@ -257,6 +263,7 @@ export const getGetAccountBalanceUrl = (accountId) => {
     return `https://billing.leaflow.cloud/api/v1/billing-accounts/${encodeURIComponent(String(accountId))}/balance`;
 };
 /**
+ * Returns the owned account balance, applicable credit groups, unpaid invoice amounts, unbilled estimates and pending returns separately. Returns 404 for a missing account and 403 for an account owned by another user.
  * @summary Get account balance
  */
 export const getAccountBalance = async (accountId, options, fetchFn) => {
@@ -309,6 +316,7 @@ export const getListProjectAssignmentsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/assignments`;
 };
 /**
+ * Paginated current project assignments to accounts owned by the authenticated user. Filter by billing_account_id or project_ids; historical financial records keep their original account assignment.
  * @summary List project assignments
  */
 export const listProjectAssignments = async (params, options, fetchFn) => {
@@ -527,6 +535,7 @@ export const getListPaymentMethodsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/payment-methods`;
 };
 /**
+ * Paginated saved payment methods for owned billing accounts, optionally restricted to billing_account_id. Removed methods are excluded; they do not disappear from historical payment records.
  * @summary List payment methods
  */
 export const listPaymentMethods = async (params, options, fetchFn) => {
@@ -579,6 +588,7 @@ export const getSetDefaultPaymentMethodUrl = (paymentMethodId) => {
     return `https://billing.leaflow.cloud/api/v1/payment-methods/${encodeURIComponent(String(paymentMethodId))}/default`;
 };
 /**
+ * Selects an active saved payment method as the default for its owned billing account and returns it. Expired or removed methods cannot be selected; selecting the current default is idempotent.
  * @summary Set default payment method
  */
 export const setDefaultPaymentMethod = async (paymentMethodId, options, fetchFn) => {
@@ -779,6 +789,7 @@ export const getListInvoicesUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/invoices`;
 };
 /**
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
  * @summary List invoices
  */
 export const listInvoices = async (params, options, fetchFn) => {
@@ -794,6 +805,7 @@ export const getGetInvoiceUrl = (invoiceId) => {
     return `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}`;
 };
 /**
+ * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export const getInvoice = async (invoiceId, options, fetchFn) => {
@@ -818,6 +830,7 @@ export const getListInvoiceItemsUrl = (invoiceId, params) => {
         : `https://billing.leaflow.cloud/api/v1/invoices/${encodeURIComponent(String(invoiceId))}/items`;
 };
 /**
+ * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export const listInvoiceItems = async (invoiceId, params, options, fetchFn) => {
@@ -842,6 +855,7 @@ export const getListTransactionsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/transactions`;
 };
 /**
+ * Paginated ledger entries for owned billing accounts, optionally filtered by billing_account_id and creation interval. Each entry retains its amount, currency and any referenced credit grant.
  * @summary List transactions
  */
 export const listTransactions = async (params, options, fetchFn) => {
@@ -1270,6 +1284,7 @@ export const getGetCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };
 /**
+ * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export const getCancellation = async (cancellationId, options, fetchFn) => {
@@ -1511,6 +1526,7 @@ export const getGetOrderUrl = (orderId) => {
     return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}`;
 };
 /**
+ * Returns an order charged to an owned billing account with its commercial state and invoice reference. An unknown order returns 404; an order on another user account is forbidden.
  * @summary Get order
  */
 export const getOrder = async (orderId, options, fetchFn) => {
@@ -1747,6 +1763,7 @@ export const getListProductsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/products`;
 };
 /**
+ * Paginated registered catalog products with their service identities and descriptions. Supports If- None-Match and returns 304 when the selected page has not changed.
  * @summary List catalog products
  */
 export const listProducts = async (params, headers, options, fetchFn) => {
@@ -1885,6 +1902,7 @@ export const getListPlansUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/plans`;
 };
 /**
+ * Paginated active plans for the required product_id, with their feature allocations. An unknown product returns 404; If-None-Match can return 304 for an unchanged page.
  * @summary List catalog plans
  */
 export const listPlans = async (params, headers, options, fetchFn) => {
@@ -2065,6 +2083,7 @@ export const getListStatementsUrl = (params) => {
         : `https://billing.leaflow.cloud/api/v1/statements`;
 };
 /**
+ * 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
  */
 export const listStatements = async (params, options, fetchFn) => {
@@ -2080,6 +2099,7 @@ export const getGetStatementUrl = (statementId) => {
     return `https://billing.leaflow.cloud/api/v1/statements/${encodeURIComponent(String(statementId))}`;
 };
 /**
+ * Returns an owned-account consumption batch with its period, estimated or closed amounts and invoice reference. Returns 404 for a missing batch and 403 when the billing account belongs to another user.
  * @summary Get statement
  */
 export const getStatement = async (statementId, options, fetchFn) => {

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 /**
+ * Paginated contact profiles belonging to the billing account in the path, including inactive contacts. Returns 404 if the account does not exist.
  * @summary List contacts
  */
 export declare const ListContactsParams: zod.ZodObject<{
@@ -21,6 +22,7 @@ export declare const ListContactsQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
+ * Creates a contact profile for the billing account in the path. Creating a contact does not select it for invoicing; set the account invoice_contact_id separately.
  * @summary Create contact
  */
 export declare const CreateContactParams: zod.ZodObject<{
@@ -39,15 +41,19 @@ export declare const CreateContactBody: zod.ZodObject<{
     address_country: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Returns a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Get contact
  */
 export declare const GetContactParams: zod.ZodObject<{
+    accountId: zod.ZodInt;
     contactId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
+ * Updates a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Update contact
  */
 export declare const UpdateContactParams: zod.ZodObject<{
+    accountId: zod.ZodInt;
     contactId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 export declare const UpdateContactBody: zod.ZodObject<{
@@ -64,10 +70,11 @@ export declare const UpdateContactBody: zod.ZodObject<{
     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.
+ * Deletes a contact belonging to this billing account. Returns 404 if the contact does not exist in this account. 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<{
+    accountId: zod.ZodInt;
     contactId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
@@ -84,6 +91,7 @@ export declare const ListCurrenciesQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated billing accounts owned by the authenticated user. Accounts owned by other users are excluded; the result is empty when the user owns none.
  * @summary List billing accounts
  */
 export declare const listBillingAccountsQueryPageDefault = 1;
@@ -106,6 +114,7 @@ export declare const CreateBillingAccountBody: zod.ZodObject<{
     name: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Returns an owned account settlement currency, lifecycle state and selected invoice contact. Returns 404 if the account does not exist and 403 if it belongs to another user.
  * @summary Get billing account
  */
 export declare const GetBillingAccountParams: zod.ZodObject<{
@@ -125,6 +134,7 @@ export declare const UpdateBillingAccountBody: zod.ZodObject<{
     name: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Returns the owned account balance, applicable credit groups, unpaid invoice amounts, unbilled estimates and pending returns separately. Returns 404 for a missing account and 403 for an account owned by another user.
  * @summary Get account balance
  */
 export declare const GetAccountBalanceParams: zod.ZodObject<{
@@ -149,6 +159,7 @@ export declare const ListPaymentOptionsQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated current project assignments to accounts owned by the authenticated user. Filter by billing_account_id or project_ids; historical financial records keep their original account assignment.
  * @summary List project assignments
  */
 export declare const listProjectAssignmentsQueryPageDefault = 1;
@@ -266,6 +277,7 @@ export declare const CancelTopUpParams: zod.ZodObject<{
     topUpId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
+ * Paginated saved payment methods for owned billing accounts, optionally restricted to billing_account_id. Removed methods are excluded; they do not disappear from historical payment records.
  * @summary List payment methods
  */
 export declare const listPaymentMethodsQueryPageDefault = 1;
@@ -290,6 +302,7 @@ export declare const CreatePaymentMethodSetupBody: zod.ZodObject<{
     billing_account_id: zod.ZodInt;
 }, zod.z.core.$strict>;
 /**
+ * Selects an active saved payment method as the default for its owned billing account and returns it. Expired or removed methods cannot be selected; selecting the current default is idempotent.
  * @summary Set default payment method
  */
 export declare const SetDefaultPaymentMethodParams: zod.ZodObject<{
@@ -383,6 +396,7 @@ export declare const PreviewPayTogetherBody: zod.ZodObject<{
     order_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
  * @summary List invoices
  */
 export declare const listInvoicesQueryPageDefault = 1;
@@ -405,12 +419,14 @@ export declare const ListInvoicesQueryParams: zod.ZodObject<{
     to: zod.ZodOptional<zod.z.ZodISODateTime>;
 }, zod.z.core.$strict>;
 /**
+ * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export declare const GetInvoiceParams: zod.ZodObject<{
     invoiceId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
+ * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export declare const ListInvoiceItemsParams: zod.ZodObject<{
@@ -425,6 +441,7 @@ export declare const ListInvoiceItemsQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated ledger entries for owned billing accounts, optionally filtered by billing_account_id and creation interval. Each entry retains its amount, currency and any referenced credit grant.
  * @summary List transactions
  */
 export declare const listTransactionsQueryPageDefault = 1;
@@ -760,6 +777,7 @@ export declare const CreateCancellationBody: zod.ZodObject<{
     reason: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export declare const GetCancellationParams: zod.ZodObject<{
@@ -927,6 +945,7 @@ export declare const ListOrdersQueryParams: zod.ZodObject<{
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, zod.z.core.$strict>;
 /**
+ * Returns an order charged to an owned billing account with its commercial state and invoice reference. An unknown order returns 404; an order on another user account is forbidden.
  * @summary Get order
  */
 export declare const GetOrderParams: zod.ZodObject<{
@@ -1068,6 +1087,7 @@ export declare const ListPricesHeader: zod.ZodObject<{
     "If-None-Match": zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated registered catalog products with their service identities and descriptions. Supports If- None-Match and returns 304 when the selected page has not changed.
  * @summary List catalog products
  */
 export declare const listProductsQueryPageDefault = 1;
@@ -1116,6 +1136,7 @@ export declare const GetPriceHeader: zod.ZodObject<{
     "If-None-Match": zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
+ * Paginated active plans for the required product_id, with their feature allocations. An unknown product returns 404; If-None-Match can return 304 for an unchanged page.
  * @summary List catalog plans
  */
 export declare const listPlansQueryProductIdMax = 64;
@@ -1232,6 +1253,7 @@ export declare const ListSpendQueryParams: zod.ZodObject<{
     project_ids: zod.ZodOptional<zod.ZodArray<zod.ZodUUID>>;
 }, 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
  */
 export declare const listStatementsQueryPageDefault = 1;
@@ -1250,6 +1272,7 @@ export declare const ListStatementsQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
+ * Returns an owned-account consumption batch with its period, estimated or closed amounts and invoice reference. Returns 404 for a missing batch and 403 when the billing account belongs to another user.
  * @summary Get statement
  */
 export declare const GetStatementParams: zod.ZodObject<{

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

@@ -24,6 +24,7 @@ import { RenewalOrderRequest } from "./validators/renewalOrderRequest.zod.js";
 import { SetProjectAssignmentRequest } from "./validators/setProjectAssignmentRequest.zod.js";
 import { TopUpCreate } from "./validators/topUpCreate.zod.js";
 /**
+ * Paginated contact profiles belonging to the billing account in the path, including inactive contacts. Returns 404 if the account does not exist.
  * @summary List contacts
  */
 export const ListContactsParams = zod.strictObject({
@@ -48,6 +49,7 @@ export const ListContactsQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
+ * Creates a contact profile for the billing account in the path. Creating a contact does not select it for invoicing; set the account invoice_contact_id separately.
  * @summary Create contact
  */
 export const CreateContactParams = zod.strictObject({
@@ -55,23 +57,28 @@ export const CreateContactParams = zod.strictObject({
 });
 export const CreateContactBody = ContactCreate;
 /**
+ * Returns a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Get contact
  */
 export const GetContactParams = zod.strictObject({
+    accountId: zod.int(),
     contactId: zod.uuid(),
 });
 /**
+ * Updates a contact belonging to this billing account. Returns 404 if the contact does not exist in this account.
  * @summary Update contact
  */
 export const UpdateContactParams = zod.strictObject({
+    accountId: zod.int(),
     contactId: zod.uuid(),
 });
 export const UpdateContactBody = ContactUpdate;
 /**
- * The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
+ * Deletes a contact belonging to this billing account. Returns 404 if the contact does not exist in this account. The selected invoice contact must be cleared or replaced before deletion. Issued invoice snapshots are retained.
  * @summary Delete contact
  */
 export const DeleteContactParams = zod.strictObject({
+    accountId: zod.int(),
     contactId: zod.uuid(),
 });
 /**
@@ -98,6 +105,7 @@ export const ListCurrenciesQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
+ * Paginated billing accounts owned by the authenticated user. Accounts owned by other users are excluded; the result is empty when the user owns none.
  * @summary List billing accounts
  */
 export const listBillingAccountsQueryPageDefault = 1;
@@ -127,6 +135,7 @@ export const ListBillingAccountsQueryParams = zod.strictObject({
  */
 export const CreateBillingAccountBody = BillingAccountCreate;
 /**
+ * Returns an owned account settlement currency, lifecycle state and selected invoice contact. Returns 404 if the account does not exist and 403 if it belongs to another user.
  * @summary Get billing account
  */
 export const GetBillingAccountParams = zod.strictObject({
@@ -143,6 +152,7 @@ export const UpdateBillingAccountParams = zod.strictObject({
 });
 export const UpdateBillingAccountBody = BillingAccountUpdate;
 /**
+ * Returns the owned account balance, applicable credit groups, unpaid invoice amounts, unbilled estimates and pending returns separately. Returns 404 for a missing account and 403 for an account owned by another user.
  * @summary Get account balance
  */
 export const GetAccountBalanceParams = zod.strictObject({
@@ -177,6 +187,7 @@ export const ListPaymentOptionsQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
+ * Paginated current project assignments to accounts owned by the authenticated user. Filter by billing_account_id or project_ids; historical financial records keep their original account assignment.
  * @summary List project assignments
  */
 export const listProjectAssignmentsQueryPageDefault = 1;
@@ -312,6 +323,7 @@ export const CancelTopUpParams = zod.strictObject({
     topUpId: zod.uuid(),
 });
 /**
+ * Paginated saved payment methods for owned billing accounts, optionally restricted to billing_account_id. Removed methods are excluded; they do not disappear from historical payment records.
  * @summary List payment methods
  */
 export const listPaymentMethodsQueryPageDefault = 1;
@@ -346,6 +358,7 @@ export const ListPaymentMethodsQueryParams = zod.strictObject({
  */
 export const CreatePaymentMethodSetupBody = PaymentMethodSetup;
 /**
+ * Selects an active saved payment method as the default for its owned billing account and returns it. Expired or removed methods cannot be selected; selecting the current default is idempotent.
  * @summary Set default payment method
  */
 export const SetDefaultPaymentMethodParams = zod.strictObject({
@@ -432,6 +445,7 @@ export const PayTogetherBody = PayTogetherRequest;
  */
 export const PreviewPayTogetherBody = PayTogetherRequest;
 /**
+ * Paginated issued invoices belonging to owned billing accounts, filtered by billing_account_id, status and creation interval. Drafts are excluded; top-ups do not create invoices.
  * @summary List invoices
  */
 export const listInvoicesQueryPageDefault = 1;
@@ -463,12 +477,14 @@ export const ListInvoicesQueryParams = zod.strictObject({
     to: zod.iso.datetime({ offset: true }).optional().describe("Exclusive."),
 });
 /**
+ * Returns an issued invoice for an owned billing account with its amounts, tax lines and payment state. Returns 404 for a missing or unissued invoice and 403 when its account belongs to another user.
  * @summary Get invoice
  */
 export const GetInvoiceParams = zod.strictObject({
     invoiceId: zod.uuid(),
 });
 /**
+ * Paginated lines of an issued invoice belonging to an owned billing account, including their service periods and project references. A missing or unissued invoice returns 404; another user account returns 403.
  * @summary List invoice items
  */
 export const ListInvoiceItemsParams = zod.strictObject({
@@ -493,6 +509,7 @@ export const ListInvoiceItemsQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
+ * Paginated ledger entries for owned billing accounts, optionally filtered by billing_account_id and creation interval. Each entry retains its amount, currency and any referenced credit grant.
  * @summary List transactions
  */
 export const listTransactionsQueryPageDefault = 1;
@@ -887,6 +904,7 @@ export const ListCancellationsQueryParams = zod.strictObject({
  */
 export const CreateCancellationBody = CancellationCreate;
 /**
+ * Returns a cancellation request for an authorized billing account with its schedule, expected refundable amount and individual subscription outcomes. Read individual item states for per-subscription outcomes, including partial success.
  * @summary Get a cancellation
  */
 export const GetCancellationParams = zod.strictObject({
@@ -1076,6 +1094,7 @@ export const ListOrdersQueryParams = zod.strictObject({
         .describe("Restrict the account-authorized results to these projects. Omit for all projects and account-level records. This filter does not grant access to another billing account."),
 });
 /**
+ * Returns an order charged to an owned billing account with its commercial state and invoice reference. An unknown order returns 404; an order on another user account is forbidden.
  * @summary Get order
  */
 export const GetOrderParams = zod.strictObject({
@@ -1268,6 +1287,7 @@ export const ListPricesHeader = zod.strictObject({
         .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
 });
 /**
+ * Paginated registered catalog products with their service identities and descriptions. Supports If- None-Match and returns 304 when the selected page has not changed.
  * @summary List catalog products
  */
 export const listProductsQueryPageDefault = 1;
@@ -1343,6 +1363,7 @@ export const GetPriceHeader = zod.strictObject({
         .describe("The `ETag` from an earlier reply. When the catalogue has not changed since, the\nanswer is `304` with no body.\n\nSend it on every catalogue read. An unchanged catalogue is answered without a body."),
 });
 /**
+ * Paginated active plans for the required product_id, with their feature allocations. An unknown product returns 404; If-None-Match can return 304 for an unchanged page.
  * @summary List catalog plans
  */
 export const listPlansQueryProductIdMax = 64;
@@ -1549,6 +1570,7 @@ export const ListSpendQueryParams = zod.strictObject({
         .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."),
 });
 /**
+ * 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
  */
 export const listStatementsQueryPageDefault = 1;
@@ -1574,6 +1596,7 @@ export const ListStatementsQueryParams = zod.strictObject({
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
+ * Returns an owned-account consumption batch with its period, estimated or closed amounts and invoice reference. Returns 404 for a missing batch and 403 when the billing account belongs to another user.
  * @summary Get statement
  */
 export const GetStatementParams = zod.strictObject({

package/dist/routes.d.ts

@@ -506,7 +506,7 @@ export declare const routes: readonly [{
     readonly service: "billing";
     readonly contract: "billing";
     readonly method: "GET";
-    readonly path: "/api/v1/contacts/{contactId}";
+    readonly path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}";
     readonly operationId: "get-contact";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
@@ -514,7 +514,7 @@ export declare const routes: readonly [{
     readonly service: "billing";
     readonly contract: "billing";
     readonly method: "PATCH";
-    readonly path: "/api/v1/contacts/{contactId}";
+    readonly path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}";
     readonly operationId: "update-contact";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
@@ -522,7 +522,7 @@ export declare const routes: readonly [{
     readonly service: "billing";
     readonly contract: "billing";
     readonly method: "DELETE";
-    readonly path: "/api/v1/contacts/{contactId}";
+    readonly path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}";
     readonly operationId: "delete-contact";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";

package/dist/routes.js

@@ -571,7 +571,7 @@ export const routes = [
         service: "billing",
         contract: "billing",
         method: "GET",
-        path: "/api/v1/contacts/{contactId}",
+        path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}",
         operationId: "get-contact",
         securityScheme: "AccessToken",
         upstreamUrl: "https://billing.leaflow.cloud",
@@ -580,7 +580,7 @@ export const routes = [
         service: "billing",
         contract: "billing",
         method: "PATCH",
-        path: "/api/v1/contacts/{contactId}",
+        path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}",
         operationId: "update-contact",
         securityScheme: "AccessToken",
         upstreamUrl: "https://billing.leaflow.cloud",
@@ -589,7 +589,7 @@ export const routes = [
         service: "billing",
         contract: "billing",
         method: "DELETE",
-        path: "/api/v1/contacts/{contactId}",
+        path: "/api/v1/billing-accounts/{accountId}/contacts/{contactId}",
         operationId: "delete-contact",
         securityScheme: "AccessToken",
         upstreamUrl: "https://billing.leaflow.cloud",

package/package.json

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