@leaflow/sdk 0.109.0 → 0.111.0

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, Cancellation, CancellationCreate, CancellationList, CheckoutOrderRequest, CreditGrantList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCreditGrantsParams, ListCurrenciesParams, ListEntitlementsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, MeteredUsage, NotModifiedResponse, Order, 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, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList } from "./models.js";
+import type { AccountBalance, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CheckoutOrderRequest, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListInvoiceItemsParams, ListInvoicesParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRatesHeaders, ListRatesParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, MeteredUsage, 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, Subscription, SubscriptionList, TerminateSubscriptionRequest, 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;
@@ -729,6 +729,69 @@ export declare const getListCreditGrantsUrl: (params?: ListCreditGrantsParams) =
  * @summary List credit grants
  */
 export declare const listCreditGrants: (params?: ListCreditGrantsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditGrantsResponse>;
+export type listCreditNotesResponse200 = {
+    data: CreditNoteList;
+    status: 200;
+};
+export type listCreditNotesResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listCreditNotesResponseSuccess = listCreditNotesResponse200 & {
+    headers: Headers;
+};
+export type listCreditNotesResponseError = listCreditNotesResponseDefault & {
+    headers: Headers;
+};
+export type listCreditNotesResponse = listCreditNotesResponseSuccess | listCreditNotesResponseError;
+export declare const getListCreditNotesUrl: (params?: ListCreditNotesParams) => string;
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export declare const listCreditNotes: (params?: ListCreditNotesParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditNotesResponse>;
+export type getCreditNoteResponse200 = {
+    data: CreditNote;
+    status: 200;
+};
+export type getCreditNoteResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type getCreditNoteResponseSuccess = getCreditNoteResponse200 & {
+    headers: Headers;
+};
+export type getCreditNoteResponseError = getCreditNoteResponseDefault & {
+    headers: Headers;
+};
+export type getCreditNoteResponse = getCreditNoteResponseSuccess | getCreditNoteResponseError;
+export declare const getGetCreditNoteUrl: (creditNoteId: string) => string;
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export declare const getCreditNote: (creditNoteId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getCreditNoteResponse>;
+export type listCreditNoteItemsResponse200 = {
+    data: CreditNoteItemList;
+    status: 200;
+};
+export type listCreditNoteItemsResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type listCreditNoteItemsResponseSuccess = listCreditNoteItemsResponse200 & {
+    headers: Headers;
+};
+export type listCreditNoteItemsResponseError = listCreditNoteItemsResponseDefault & {
+    headers: Headers;
+};
+export type listCreditNoteItemsResponse = listCreditNoteItemsResponseSuccess | listCreditNoteItemsResponseError;
+export declare const getListCreditNoteItemsUrl: (creditNoteId: string, params?: ListCreditNoteItemsParams) => string;
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export declare const listCreditNoteItems: (creditNoteId: string, params?: ListCreditNoteItemsParams, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<listCreditNoteItemsResponse>;
 export type listRefundsResponse200 = {
     data: RefundList;
     status: 200;
@@ -815,6 +878,96 @@ export declare const getGetSubscriptionUrl: (subscriptionId: string) => string;
  * @summary Get subscription
  */
 export declare const getSubscription: (subscriptionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<getSubscriptionResponse>;
+export type deleteSubscriptionResponse204 = {
+    data: void;
+    status: 204;
+};
+export type deleteSubscriptionResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 204>;
+};
+export type deleteSubscriptionResponseSuccess = deleteSubscriptionResponse204 & {
+    headers: Headers;
+};
+export type deleteSubscriptionResponseError = deleteSubscriptionResponseDefault & {
+    headers: Headers;
+};
+export type deleteSubscriptionResponse = deleteSubscriptionResponseSuccess | deleteSubscriptionResponseError;
+export declare const getDeleteSubscriptionUrl: (subscriptionId: string) => string;
+/**
+ * Hides an already terminated subscription from your subscription list and detail. Your account
+ * access token must authorize the subscription's current billing account. Billing and financial
+ * history remain available. This operation cannot force termination, skip cleanup, or delete a
+ * pending, provisioning, active or suspended subscription. Other states, including canceled, are
+ * refused with 409 BILLING_SUBSCRIPTION_NOT_TERMINATED and status in error params. A canceled
+ * subscription must first be converted to terminated. Sends no cleanup command and creates no refund.
+ * @summary Delete subscription
+ */
+export declare const deleteSubscription: (subscriptionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<deleteSubscriptionResponse>;
+export type cancelSubscriptionResponse202 = {
+    data: Cancellation;
+    status: 202;
+};
+export type cancelSubscriptionResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 202>;
+};
+export type cancelSubscriptionResponseSuccess = cancelSubscriptionResponse202 & {
+    headers: Headers;
+};
+export type cancelSubscriptionResponseError = cancelSubscriptionResponseDefault & {
+    headers: Headers;
+};
+export type cancelSubscriptionResponse = cancelSubscriptionResponseSuccess | cancelSubscriptionResponseError;
+export declare const getCancelSubscriptionUrl: (subscriptionId: string) => string;
+/**
+ * Requests cancellation on the purchase's agreed terms. Uses the same quotation, eligibility,
+ * metering and original-payment-source refund rules as creating a cancellation.
+ * Supply the refund amount from create-quote with this subscription in cancellation.subscription_ids.
+ * Your account access token must authorize the subscription's current billing account.
+ *
+ * Immediate cancellation asks the owning service to clean up now. Period-end cancellation keeps
+ * the subscription active or suspended until the paid term ends. Neither payment nor acceptance
+ * of this request proves cleanup. The subscription becomes canceled only after the service
+ * confirms release and the end of metering; follow the returned cancellation for progress.
+ *
+ * Related subscriptions released together must be submitted as one group to create-cancellation.
+ * Pending or provisioning purchases are canceled through their order, not this operation.
+ * Repeating the same open cancellation returns it without another refund or command.
+ * @summary Cancel subscription
+ */
+export declare const cancelSubscription: (subscriptionId: string, cancelSubscriptionRequest: CancelSubscriptionRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelSubscriptionResponse>;
+export type terminateSubscriptionResponse200 = {
+    data: Subscription;
+    status: 200;
+};
+export type terminateSubscriptionResponseDefault = {
+    data: ErrorResponse;
+    status: Exclude<HTTPStatusCodes, 200>;
+};
+export type terminateSubscriptionResponseSuccess = terminateSubscriptionResponse200 & {
+    headers: Headers;
+};
+export type terminateSubscriptionResponseError = terminateSubscriptionResponseDefault & {
+    headers: Headers;
+};
+export type terminateSubscriptionResponse = terminateSubscriptionResponseSuccess | terminateSubscriptionResponseError;
+export declare const getTerminateSubscriptionUrl: (subscriptionId: string) => string;
+/**
+ * Converts an already canceled subscription to terminated so it can subsequently be hidden.
+ * Your account access token must authorize the subscription's current billing account. Preserves
+ * the original billing end and financial history, sends no new cleanup command, and creates no
+ * credit note or refund. A terminated subscription is returned unchanged on repeat; a deleted
+ * subscription remains hidden from tenant reads.
+ *
+ * Account holders cannot force termination of pending, provisioning, active or suspended
+ * subscriptions. These states are refused with 400 BILLING_SUBSCRIPTION_INVALID and status in
+ * error params. Use cancellation under the agreed terms to end service. Immediate commercial
+ * termination is reserved for administrators and the owning service. The audited reason does
+ * not grant permission to terminate. No force, skip-cleanup or refund options are accepted.
+ * @summary Terminate subscription
+ */
+export declare const terminateSubscription: (subscriptionId: string, terminateSubscriptionRequest: TerminateSubscriptionRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<terminateSubscriptionResponse>;
 export type createQuoteResponse200 = {
     data: Quote;
     status: 200;
@@ -1228,20 +1381,27 @@ export type cancelOrderResponseError = (cancelOrderResponse409 | cancelOrderResp
 export type cancelOrderResponse = cancelOrderResponseSuccess | cancelOrderResponseError;
 export declare const getCancelOrderUrl: (orderId: string) => string;
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
+ *
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
-export declare const cancelOrder: (orderId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelOrderResponse>;
+export declare const cancelOrder: (orderId: string, orderCancel?: OrderCancel, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<cancelOrderResponse>;
 export type listOrderItemsResponse200 = {
     data: OrderItemList;
     status: 200;

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

@@ -805,6 +805,72 @@ export const listCreditGrants = async (params, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getListCreditNotesUrl = (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/credit-notes?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/credit-notes`;
+};
+/**
+ * Newest issued_at first, then ID. Requires authorization for the invoice's billing account. Filters narrow authorized results and apply before counting and paging.
+ * @summary List credit notes
+ */
+export const listCreditNotes = async (params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListCreditNotesUrl(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 getGetCreditNoteUrl = (creditNoteId) => {
+    return `https://billing.leaflow.cloud/api/v1/credit-notes/${encodeURIComponent(String(creditNoteId))}`;
+};
+/**
+ * Requires authorization for the invoice's billing account.
+ * @summary Get credit note
+ */
+export const getCreditNote = async (creditNoteId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getGetCreditNoteUrl(creditNoteId), {
+        ...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 getListCreditNoteItemsUrl = (creditNoteId, 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/credit-notes/${encodeURIComponent(String(creditNoteId))}/items?${stringifiedParams}`
+        : `https://billing.leaflow.cloud/api/v1/credit-notes/${encodeURIComponent(String(creditNoteId))}/items`;
+};
+/**
+ * The original invoice lines reduced by this note. Requires authorization for their invoice's billing account.
+ * @summary List credit note items
+ */
+export const listCreditNoteItems = async (creditNoteId, params, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getListCreditNoteItemsUrl(creditNoteId, 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 getListRefundsUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -898,6 +964,115 @@ export const getSubscription = async (subscriptionId, options, fetchFn) => {
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
+export const getDeleteSubscriptionUrl = (subscriptionId) => {
+    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}`;
+};
+/**
+ * Hides an already terminated subscription from your subscription list and detail. Your account
+ * access token must authorize the subscription's current billing account. Billing and financial
+ * history remain available. This operation cannot force termination, skip cleanup, or delete a
+ * pending, provisioning, active or suspended subscription. Other states, including canceled, are
+ * refused with 409 BILLING_SUBSCRIPTION_NOT_TERMINATED and status in error params. A canceled
+ * subscription must first be converted to terminated. Sends no cleanup command and creates no refund.
+ * @summary Delete subscription
+ */
+export const deleteSubscription = async (subscriptionId, options, fetchFn) => {
+    const res = await (fetchFn ?? fetch)(getDeleteSubscriptionUrl(subscriptionId), {
+        ...options,
+        method: "DELETE",
+    });
+    const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+    const data = body ? JSON.parse(body) : undefined;
+    return { data, status: res.status, headers: res.headers };
+};
+export const getCancelSubscriptionUrl = (subscriptionId) => {
+    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/cancel`;
+};
+/**
+ * Requests cancellation on the purchase's agreed terms. Uses the same quotation, eligibility,
+ * metering and original-payment-source refund rules as creating a cancellation.
+ * Supply the refund amount from create-quote with this subscription in cancellation.subscription_ids.
+ * Your account access token must authorize the subscription's current billing account.
+ *
+ * Immediate cancellation asks the owning service to clean up now. Period-end cancellation keeps
+ * the subscription active or suspended until the paid term ends. Neither payment nor acceptance
+ * of this request proves cleanup. The subscription becomes canceled only after the service
+ * confirms release and the end of metering; follow the returned cancellation for progress.
+ *
+ * Related subscriptions released together must be submitted as one group to create-cancellation.
+ * Pending or provisioning purchases are canceled through their order, not this operation.
+ * Repeating the same open cancellation returns it without another refund or command.
+ * @summary Cancel subscription
+ */
+export const cancelSubscription = async (subscriptionId, cancelSubscriptionRequest, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getCancelSubscriptionUrl(subscriptionId), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(cancelSubscriptionRequest),
+    });
+    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 getTerminateSubscriptionUrl = (subscriptionId) => {
+    return `https://billing.leaflow.cloud/api/v1/subscriptions/${encodeURIComponent(String(subscriptionId))}/terminate`;
+};
+/**
+ * Converts an already canceled subscription to terminated so it can subsequently be hidden.
+ * Your account access token must authorize the subscription's current billing account. Preserves
+ * the original billing end and financial history, sends no new cleanup command, and creates no
+ * credit note or refund. A terminated subscription is returned unchanged on repeat; a deleted
+ * subscription remains hidden from tenant reads.
+ *
+ * Account holders cannot force termination of pending, provisioning, active or suspended
+ * subscriptions. These states are refused with 400 BILLING_SUBSCRIPTION_INVALID and status in
+ * error params. Use cancellation under the agreed terms to end service. Immediate commercial
+ * termination is reserved for administrators and the owning service. The audited reason does
+ * not grant permission to terminate. No force, skip-cleanup or refund options are accepted.
+ * @summary Terminate subscription
+ */
+export const terminateSubscription = async (subscriptionId, terminateSubscriptionRequest, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
+    const res = await (fetchFn ?? fetch)(getTerminateSubscriptionUrl(subscriptionId), {
+        ...options,
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(terminateSubscriptionRequest),
+    });
+    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 getCreateQuoteUrl = () => {
     return `https://billing.leaflow.cloud/api/v1/quotes`;
 };
@@ -1351,23 +1526,47 @@ export const getCancelOrderUrl = (orderId) => {
     return `https://billing.leaflow.cloud/api/v1/orders/${encodeURIComponent(String(orderId))}/cancel`;
 };
 /**
- * Withdraws an unaccepted order without recording a delivery failure. Payment may be absent,
- * partial or complete; the order becomes canceled and any collected amount is automatically
- * returned to its original payment sources. External payment-method refunds can finish
- * asynchronously. Canceling an already canceled order returns it unchanged. A previously failed
- * order keeps its failure outcome. The order and financial history are retained.
+ * Cancels the selected, still-undelivered items of an unaccepted order without recording a
+ * delivery failure. Omit order_item_ids to select every still-pending item, or name one or
+ * more items. Successful items remain delivered and are not refunded. Whole-order and partial
+ * cancellation both require confirmed non-delivery and necessary cleanup. The order keeps
+ * its existing pending phase while any item is still pending; its final outcome follows all
+ * item outcomes. Previously failed items keep their failure outcome.
+ *
+ * Payment may be absent, partial or complete. Confirmed checkout keeps the selected items'
+ * agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
+ * are returned to their original payment sources. When checkout has not been confirmed, the
+ * remaining items are quoted again. External payment-method refunds can finish asynchronously.
+ * The order and financial history are retained; the same cancellation does not refund twice.
  *
- * Refused once the order is accepted: its owning service must coordinate cancellation during
- * provisioning and confirm non-delivery and necessary cleanup before recording cancellation.
- * Delivered items are ended through subscription cancellation. An unknown or in-flight payment
- * outcome must first be reconciled; it is not assumed to be unpaid. Scheduled changes continue
- * to be canceled through the service that owns them. Refund quotations use CreateQuote.refund.
+ * Once the order is accepted, its owning service coordinates cancellation and confirms
+ * non-delivery and cleanup through the cancellation RPC. Delivered items are ended through
+ * subscription cancellation. Unknown delivery or payment outcomes are not refund evidence;
+ * in-flight or unknown payments must be reconciled first. Scheduled changes continue to be
+ * canceled through the owning service. Refund quotations use CreateQuote.refund.
  * @summary Cancel order
  */
-export const cancelOrder = async (orderId, options, fetchFn) => {
+export const cancelOrder = async (orderId, orderCancel, options, fetchFn) => {
+    const getHeaders = (h) => {
+        if (!h)
+            return {};
+        if (h instanceof Headers)
+            return Object.fromEntries(h.entries());
+        if (Symbol.iterator in h) {
+            return Object.fromEntries(Array.from(h, (entry) => Array.from(entry)));
+        }
+        const headers = {};
+        for (const [name, value] of Object.entries(h)) {
+            if (value !== undefined)
+                headers[name] = value;
+        }
+        return headers;
+    };
     const res = await (fetchFn ?? fetch)(getCancelOrderUrl(orderId), {
         ...options,
         method: "POST",
+        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+        body: JSON.stringify(orderCancel),
     });
     const body = [204, 205, 304].includes(res.status) ? null : await res.text();
     const data = body ? JSON.parse(body) : {};

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

@@ -30,6 +30,14 @@ export declare const RefundPolicy: {
     readonly none: "none";
     readonly prorated: "prorated";
 };
+export interface OrderCancel {
+    /**
+     * Omit to select all still-pending items. Explicit selections name one or more items of this order; successful items cannot be reversed here.
+     * @minItems 1
+     * @maxItems 100
+     */
+    order_item_ids?: string[];
+}
 /**
  * A decimal string, in the currency stated alongside it.
  *
@@ -1304,7 +1312,11 @@ export interface Invoice {
     /** Subtotal less discount plus tax. Balance and credit grants are payment sources, not reductions of the receivable. */
     total: Money;
     amount_paid?: Money;
-    /** What is still collectible after applied credits and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none. */
+    /** Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total. */
+    unpaid_credit_notes_amount: Money;
+    /** Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds. */
+    paid_credit_notes_amount: Money;
+    /** What is still collectible after unpaid credit notes and successful payments; never below zero. A draft order invoice is not collectible until checkout confirms it, and a paid or void invoice has none. */
     amount_due: Money;
     /** @nullable */
     period_start?: string | null;
@@ -1416,6 +1428,50 @@ export interface CreditGrantList {
     items: CreditGrant[];
     pagination: OffsetPagination;
 }
+export type CreditNoteStatus = (typeof CreditNoteStatus)[keyof typeof CreditNoteStatus];
+export declare const CreditNoteStatus: {
+    readonly issued: "issued";
+    readonly void: "void";
+};
+/**
+ * An issued invoice reduction. Its credited amount is unpaid_amount plus paid_amount. A paid credit records a return obligation; refund_id identifies its refund, whose outcome may still be pending. Original invoice amounts remain unchanged.
+ */
+export interface CreditNote {
+    id: string;
+    invoice_id: string;
+    currency: string;
+    issued_at: string;
+    status: CreditNoteStatus;
+    /**
+     * When this note was voided; null while issued.
+     * @nullable
+     */
+    voided_at: string | null;
+    /** The reduction of unpaid receivables. A void note no longer reduces what is due. */
+    unpaid_amount: Money;
+    /** The credited part of payments already received. This is not proof that its refund has completed. */
+    paid_amount: Money;
+    /**
+     * The refund to the original payment sources, or null when no paid amount was credited.
+     * @nullable
+     */
+    refund_id: string | null;
+}
+export interface CreditNoteItem {
+    id: string;
+    credit_note_id: string;
+    invoice_item_id: string;
+    unpaid_amount: Money;
+    paid_amount: Money;
+}
+export interface CreditNoteList {
+    items: CreditNote[];
+    pagination: OffsetPagination;
+}
+export interface CreditNoteItemList {
+    items: CreditNoteItem[];
+    pagination: OffsetPagination;
+}
 /**
  * Use balance_amount, credit_amount and gateway_amount, which also show a refund split between several destinations.
  * @deprecated
@@ -1623,6 +1679,7 @@ export declare const SubscriptionStatus: {
     readonly suspended: "suspended";
     readonly canceled: "canceled";
     readonly terminated: "terminated";
+    readonly deleted: "deleted";
 };
 /**
  * An independently billed purchase relationship, separate from the owning service's resource.
@@ -1911,8 +1968,12 @@ export interface InvoiceSummary {
     tax_amount: string;
     total: string;
     amount_paid: string;
+    /** Issued, non-void credit notes that reduced unpaid receivables. Does not rewrite the original invoice total. */
+    unpaid_credit_notes_amount: Money;
+    /** Issued credit notes against payments already received. This is a return obligation, not evidence of completed refunds. */
+    paid_credit_notes_amount: Money;
     /**
-     * What is still collectible after applied credits and successful payments; never below zero.
+     * What is still collectible after unpaid credit notes and successful payments; never below zero.
      * @pattern ^\d+(\.\d{1,10})?$
      */
     amount_due: string;
@@ -2046,7 +2107,6 @@ export interface Order {
     /** How the order was paid. Absent until it is paid. */
     paid_with?: PaidWith;
     account?: AccountIdentity;
-    cancel_reason?: string;
     change_effective_at?: string;
     id: string;
     /**
@@ -2587,6 +2647,22 @@ export interface CursorPagination {
     /** @nullable */
     next_cursor?: string | null;
 }
+export interface TerminateSubscriptionRequest {
+    /**
+     * @minLength 8
+     * @maxLength 1024
+     */
+    reason: string;
+}
+export interface CancelSubscriptionRequest {
+    mode: TerminationPolicy;
+    /** For immediate cancellation, the quoted whole-second refund basis. Now when omitted. */
+    proration_date?: string;
+    /** The cancellation quote's refundable amount, including an explicit zero. */
+    expected_refundable_amount: Money & string;
+    /** @maxLength 1024 */
+    reason?: string;
+}
 /**
  * Error
  */
@@ -2834,6 +2910,42 @@ export declare const ListCreditGrantsStatus: {
     readonly expired: "expired";
     readonly voided: "voided";
 };
+export type ListCreditNotesParams = {
+    /**
+     * 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;
+    /**
+     * Restrict to one of your accounts. All of them when omitted.
+     */
+    billing_account_id?: AccountIdQueryParameter;
+    /**
+     * Only the notes for this invoice.
+     */
+    invoice_id?: string;
+};
+export type ListCreditNoteItemsParams = {
+    /**
+     * 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 ListRefundsParams = {
     /**
      * 1-based page number. Defaults to 1.

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

@@ -160,6 +160,10 @@ export const CreditGrantStatus = {
     expired: "expired",
     voided: "voided",
 };
+export const CreditNoteStatus = {
+    issued: "issued",
+    void: "void",
+};
 export const RefundDestination = {
     balance: "balance",
     gateway: "gateway",
@@ -201,6 +205,7 @@ export const SubscriptionStatus = {
     suspended: "suspended",
     canceled: "canceled",
     terminated: "terminated",
+    deleted: "deleted",
 };
 export const RenewalPriceInterval = {
     day: "day",