@leaflow/sdk 0.163.0 → 0.164.0

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

@@ -5,7 +5,7 @@
  * Products, prices, orders, subscriptions and account billing. Operations on a billing account require an account access token. The account, its balance, payment options and quotes are also readable by members of the projects it currently pays for; changing the account and moving its funds need the owner. Members of a project, as each operation states, can also read the project's billing account, subscriptions and orders, complete and pay for its purchases, quote purchases, changes, renewals and cancellations, and, with the project permission `billing:finance.manage` granted in IAM, renew, cancel and turn automatic renewal of its subscriptions on or off, change its billing account and read its costs. A member without the permission an operation needs is refused with 403 `PERMISSION_DENIED` and `meta.permission`; a caller who is not a member, with 403 `IAM_NOT_PROJECT_MEMBER`. Public catalogue operations declare no security requirement.
  * OpenAPI spec version: v1
  */
-import type { AccountBalance, AccountDeletionReadiness, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CancellationPreviewRequest, CancellationRefundPreview, CheckoutSession, CheckoutSessionConfirm, CheckoutSessionCreate, CheckoutSessionItemList, CheckoutSessionList, CheckoutSessionResult, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetCheckoutSessionQuoteParams, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCheckoutSessionItemsParams, ListCheckoutSessionsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, ListWithdrawalItemsParams, ListWithdrawalsParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, OrderRefundPreview, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, PreviewOrderRefundParams, Price, PriceList, PriceSearch, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RefundList, RenewRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList, UsageEstimate, UsageEstimateRequest, Withdrawal, WithdrawalCreate, WithdrawalItemList, WithdrawalList, WithdrawalPreview, WithdrawalPreviewRequest } from "./models.js";
+import type { AccountBalance, AccountDeletionReadiness, ActiveResourceList, AllowanceList, AutoRenewSet, BillingAccount, BillingAccountCreate, BillingAccountList, BillingAccountUpdate, CancelSubscriptionRequest, Cancellation, CancellationCreate, CancellationList, CheckoutSession, CheckoutSessionConfirm, CheckoutSessionCreate, CheckoutSessionItemList, CheckoutSessionList, CheckoutSessionResult, Contact, ContactCreate, ContactList, ContactUpdate, CreditGrantList, CreditNote, CreditNoteItemList, CreditNoteList, CurrencyList, DiscountList, EntitlementList, Error, ErrorResponse, FeatureGrantList, GetCheckoutSessionQuoteParams, GetPlanHeaders, GetPriceHeaders, GetProductHeaders, GetStatementUsageParams, Invoice, InvoiceItemList, InvoiceList, ListAccountDiscountsParams, ListActiveResourcesParams, ListAllowancesParams, ListBillingAccountsParams, ListCancellationsParams, ListCheckoutSessionItemsParams, ListCheckoutSessionsParams, ListContactsParams, ListCreditGrantsParams, ListCreditNoteItemsParams, ListCreditNotesParams, ListCurrenciesParams, ListEntitlementsParams, ListFeatureGrantsParams, ListInvoiceItemsParams, ListInvoicesParams, ListMonthlyStatementsParams, ListOrderItemsParams, ListOrdersParams, ListPaymentMethodsParams, ListPaymentOptionsParams, ListPlansHeaders, ListPlansParams, ListPricesByPlanHeaders, ListPricesByPlanParams, ListPricesHeaders, ListPricesParams, ListProductsHeaders, ListProductsParams, ListProjectAssignmentsParams, ListRefundsParams, ListRenewalPricesParams, ListSpendParams, ListStatementsParams, ListSubscriptionsParams, ListTopUpsParams, ListTransactionsParams, ListUsageChargesParams, ListWithdrawalItemsParams, ListWithdrawalsParams, MonthlyStatementList, NotModifiedResponse, Order, OrderCancel, OrderItemList, OrderList, OrderRefundPreview, PayInvoiceRequest, PayTogetherRequest, PaymentMethod, PaymentMethodList, PaymentMethodSetup, PaymentMethodSetupResult, PaymentOptionList, PaymentPreview, PaymentResult, Plan, PlanList, PreviewInvoicePaymentParams, PreviewOrderRefundParams, Price, PriceList, PriceSearch, Product, ProductID, ProductList, ProjectAssignment, ProjectAssignmentList, Quote, QuoteRequest, RefundList, RenewRequest, RenewalPriceList, SetProjectAssignmentRequest, SpendRowList, Statement, StatementList, StatementSummary, Subscription, SubscriptionList, TopUp, TopUpCreate, TopUpList, TransactionList, UsageChargeList, UsageEstimate, UsageEstimateRequest, Withdrawal, WithdrawalCreate, WithdrawalItemList, WithdrawalList, WithdrawalPreview, WithdrawalPreviewRequest } 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;
@@ -1175,7 +1175,8 @@ export type getQuoteResponse = getQuoteResponseSuccess | getQuoteResponseError;
 export declare const getGetQuoteUrl: () => string;
 /**
  * Calculates what a proposed purchase, a change of your subscriptions or their renewal would invoice now, and
- * what each purchased or changed line renews at. Nothing is saved, reserved or redeemed.
+ * what each purchased or changed line renews at, or what ending subscriptions would return. Nothing is saved,
+ * reserved, redeemed or canceled.
  *
  * With `billing_account_id`, the quote is for that billing account: its currency, account discounts,
  * tax and funds apply, changes and renewals use the account currently paying for each subscription, and an
@@ -1293,27 +1294,6 @@ export declare const getCreateCancellationUrl: () => string;
  * @summary Cancel subscriptions
  */
 export declare const createCancellation: (cancellationCreate: CancellationCreate, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createCancellationResponse>;
-export type previewCancellationResponse200 = {
-    data: CancellationRefundPreview;
-    status: 200;
-};
-export type previewCancellationResponseDefault = {
-    data: ErrorResponse;
-    status: Exclude<HTTPStatusCodes, 200>;
-};
-export type previewCancellationResponseSuccess = previewCancellationResponse200 & {
-    headers: Headers;
-};
-export type previewCancellationResponseError = previewCancellationResponseDefault & {
-    headers: Headers;
-};
-export type previewCancellationResponse = previewCancellationResponseSuccess | previewCancellationResponseError;
-export declare const getPreviewCancellationUrl: () => string;
-/**
- * What creating the cancellation now would return, per subscription and in total. Nothing is canceled, ended or refunded. Open to the owner of the subscriptions' current billing account and to members of their project; refused for the same states as creating it.
- * @summary Preview a cancellation
- */
-export declare const previewCancellation: (cancellationPreviewRequest: CancellationPreviewRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<previewCancellationResponse>;
 export type getCancellationResponse200 = {
     data: Cancellation;
     status: 200;

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

@@ -1290,7 +1290,8 @@ export const getGetQuoteUrl = () => {
 };
 /**
  * Calculates what a proposed purchase, a change of your subscriptions or their renewal would invoice now, and
- * what each purchased or changed line renews at. Nothing is saved, reserved or redeemed.
+ * what each purchased or changed line renews at, or what ending subscriptions would return. Nothing is saved,
+ * reserved, redeemed or canceled.
  *
  * With `billing_account_id`, the quote is for that billing account: its currency, account discounts,
  * tax and funds apply, changes and renewals use the account currently paying for each subscription, and an
@@ -1457,39 +1458,6 @@ export const createCancellation = async (cancellationCreate, options, fetchFn) =
     const data = body ? JSON.parse(body) : {};
     return { data, status: res.status, headers: res.headers };
 };
-export const getPreviewCancellationUrl = () => {
-    return `https://billing.leaflow.cloud/api/v1/cancellations/preview`;
-};
-/**
- * What creating the cancellation now would return, per subscription and in total. Nothing is canceled, ended or refunded. Open to the owner of the subscriptions' current billing account and to members of their project; refused for the same states as creating it.
- * @summary Preview a cancellation
- */
-export const previewCancellation = async (cancellationPreviewRequest, 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)(getPreviewCancellationUrl(), {
-        ...options,
-        method: "QUERY",
-        headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
-        body: JSON.stringify(cancellationPreviewRequest),
-    });
-    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 getGetCancellationUrl = (cancellationId) => {
     return `https://billing.leaflow.cloud/api/v1/cancellations/${encodeURIComponent(String(cancellationId))}`;
 };

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

@@ -290,29 +290,6 @@ export interface QuotedDiscount {
     /** `confirmed`: every condition of the discount holds for the billing account. `unverified`: a quote without an account, where conditions that depend on the account, such as a first purchase or a per-account limit, are checked only when a Checkout Session is completed. */
     eligibility: QuotedDiscountEligibility;
 }
-/**
- * A complete calculation in `currency`; nothing is saved or reserved. The request fails if any item cannot be priced. A Checkout Session quote gives what completing the session would invoice.
- */
-export interface Quote {
-    /** Account funds for the quoted purchase. Null without an account. */
-    funds: Funds | null;
-    subtotal: Money;
-    discount_amount: Money;
-    tax_amount: Money;
-    /** The discount a purchase would get, not yet applied. Null when there is none, and for renewals. */
-    discount: QuotedDiscount | null;
-    items: QuoteItem[];
-    renewals: QuoteRenewalResult[];
-    total: Money;
-    currency: string;
-    /**
-     * Immediate changes only; null otherwise. The instant the change is priced from; pass it when confirming the Checkout Session so it is priced from the same instant.
-     * @nullable
-     */
-    proration_date: string | null;
-    /** `complete`: tax is calculated for the billing account's invoice contact, or for `address` without an account. `requires_location_inputs`: a quote without an account or `address`, which leaves out tax that would be added; tax already contained in a price is included. */
-    tax_status: QuoteTaxStatus;
-}
 /**
  * When subscriptions end. immediate ends them now and refunds the unused value under their refund terms; period_end
  * ends them at the end of their paid period. The cancellation terms fixed when a subscription was bought decide which
@@ -325,23 +302,6 @@ export declare const CancellationMode: {
     readonly immediate: "immediate";
     readonly period_end: "period_end";
 };
-/**
- * What ending these subscriptions together would return, for one mode; preview `immediate` and `period_end` separately to compare. Refused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a paid change waiting to switch (`meta.order_id`).
- */
-export interface CancellationPreviewRequest {
-    /**
-     * A billing account you own that currently pays for every subscription.
-     * @minimum 1
-     */
-    billing_account_id: number;
-    /**
-     * The subscriptions to end together, all of one service, including every subscription released with a resource.
-     * @minItems 1
-     * @maxItems 50
-     */
-    subscription_ids: string[];
-    mode: CancellationMode;
-}
 /**
  * Which object this is, together with what a person currently calls it.
  *
@@ -358,9 +318,9 @@ export interface NamedIdentity {
     name: string;
 }
 /**
- * One subscription of the previewed cancellation.
+ * One subscription of the quoted cancellation.
  */
-export interface CancellationRefundPreviewItem {
+export interface QuoteCancellationItem {
     subscription_id: string;
     plan_id: string;
     plan_name: string;
@@ -379,8 +339,8 @@ export interface CancellationRefundPreviewItem {
     forfeited_amount: Money;
 }
 /**
- * What the cancellation would return, per subscription and in total, as of now. Give `proration_date` and
- * `refundable_amount` when creating the cancellation.
+ * What the cancellation would return, per subscription and in total, as of the quote's `proration_date` for
+ * `immediate`. Give that `proration_date` and `refundable_amount` when creating the cancellation.
  *
  * - `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.
  * - `short_rate_surcharge_amount`: before tax, the part of `forfeited_amount` due to the short rate of the
@@ -394,13 +354,10 @@ export interface CancellationRefundPreviewItem {
  *
  * Metered and one-time subscriptions show zero; their usage until release is charged as usual.
  */
-export interface CancellationRefundPreview {
+export interface QuoteCancellationResult {
     mode: CancellationMode;
     /** For `period_end`, when release begins, the end of the paid terms. */
     scheduled_at?: string;
-    /** For `immediate`, the second the refund is computed as of. Give it when creating the cancellation. */
-    proration_date?: string;
-    currency: string;
     unused_amount: Money;
     short_rate_surcharge_amount: Money;
     refundable_amount: Money;
@@ -408,7 +365,48 @@ export interface CancellationRefundPreview {
     credit_amount: Money;
     tax_amount: Money;
     forfeited_amount: Money;
-    items: CancellationRefundPreviewItem[];
+    items: QuoteCancellationItem[];
+}
+/**
+ * A complete calculation in `currency`; nothing is saved or reserved. The request fails if any item cannot be priced. A Checkout Session quote gives what completing the session would invoice.
+ */
+export interface Quote {
+    /** Account funds for the quoted purchase. Null without an account, and for a cancellation. */
+    funds: Funds | null;
+    subtotal: Money;
+    discount_amount: Money;
+    tax_amount: Money;
+    /** The discount a purchase would get, not yet applied. Null when there is none, and for renewals and a cancellation. */
+    discount: QuotedDiscount | null;
+    items: QuoteItem[];
+    renewals: QuoteRenewalResult[];
+    /** What the cancellation would return. Null unless the request quotes a cancellation. */
+    cancellation: QuoteCancellationResult | null;
+    total: Money;
+    currency: string;
+    /**
+     * Immediate changes and immediate cancellations only; null otherwise. The instant the change or the refund is priced from; pass it when confirming the Checkout Session or creating the cancellation so it is priced from the same instant.
+     * @nullable
+     */
+    proration_date: string | null;
+    /** `complete`: tax is calculated for the billing account's invoice contact, or for `address` without an account. `requires_location_inputs`: a quote without an account or `address`, which leaves out tax that would be added; tax already contained in a price is included. */
+    tax_status: QuoteTaxStatus;
+}
+/**
+ * Preview ending these subscriptions together in one mode; quote `immediate` and `period_end` separately to
+ * compare. Each must currently be paid by `billing_account_id` and be yours to read, as the owner of that account
+ * or a member of the subscriptions' project. Refused as creating the cancellation would be, including 409
+ * `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled (`meta.cancellation_id`),
+ * is being reclaimed (`meta.reason` `reclaim_requested`) or has a paid change waiting to switch (`meta.order_id`).
+ */
+export interface QuoteCancellation {
+    /**
+     * The subscriptions to end together, all of one service, including every subscription released with a resource.
+     * @minItems 1
+     * @maxItems 50
+     */
+    subscription_ids: string[];
+    mode: CancellationMode;
 }
 export interface CancellationCreate {
     /**
@@ -420,7 +418,7 @@ export interface CancellationCreate {
     mode: CancellationMode;
     /** For `immediate`, the quote's `proration_date`: a whole second, not in the future and at most ten minutes old; the refund is computed as of it. Now when omitted. */
     proration_date?: string;
-    /** The quote's `refundable_amount`; the cancellation is refused when the refund differs. */
+    /** The quote's `cancellation.refundable_amount`; the cancellation is refused when the refund differs. */
     expected_refundable_amount: Money & string;
     /**
      * A note from the account holder, kept with the cancellation.
@@ -2525,7 +2523,7 @@ export interface Rate {
 }
 export interface Price {
     /**
-     * For a price that delegates to a rate card, the rates in effect now that it charges at, one for each meter, dimension values and period; metered rates for a metered price, and rates on its own meter and period for a licensed one. `search-prices` narrows them with `dimensions`. Null for a price with its own amounts.
+     * For a price that delegates to a rate card, the rates in effect now that it charges at, one for each meter, dimension values and period; metered rates for a metered price, and rates on its own meter and period for a licensed one. `search-prices` narrows them with `dimensions`. Null for a price with its own amounts. Prices are set per currency, and dimension values a currency does not offer, for example in a region it does not sell to, have no rate in that currency and cannot be bought with it.
      * @nullable
      */
     rates?: Rate[] | null;
@@ -2581,7 +2579,7 @@ export declare const QuoteItemInputInterval: {
     readonly year: "year";
 };
 /**
- * The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused rather than priced at zero.
+ * The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to.
  */
 export type QuoteItemInputDimensions = {
     [key: string]: string;
@@ -2614,7 +2612,7 @@ export interface QuoteItemInput {
     cancellation_policy?: CancellationPolicy;
     /** @pattern ^(?:(?:[1-9][0-9]{0,27}|0(?:[1-9][0-9]{0,26}|0(?:[1-9][0-9]{0,25}|0(?:[1-9][0-9]{0,24}|0(?:[1-9][0-9]{0,23}|0(?:[1-9][0-9]{0,22}|0(?:[1-9][0-9]{0,21}|0(?:[1-9][0-9]{0,20}|0(?:[1-9][0-9]{0,19}|0(?:[1-9][0-9]{0,18}|0(?:[1-9][0-9]{0,17}|0(?:[1-9][0-9]{0,16}|0(?:[1-9][0-9]{0,15}|0(?:[1-9][0-9]{0,14}|0(?:[1-9][0-9]{0,13}|0(?:[1-9][0-9]{0,12}|0(?:[1-9][0-9]{0,11}|0(?:[1-9][0-9]{0,10}|0(?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9])))))))))))))))))))))))))))([.][0-9]{1,10})?|0{1,28}[.](?:[1-9][0-9]{0,9}|0(?:[1-9][0-9]{0,8}|0(?:[1-9][0-9]{0,7}|0(?:[1-9][0-9]{0,6}|0(?:[1-9][0-9]{0,5}|0(?:[1-9][0-9]{0,4}|0(?:[1-9][0-9]{0,3}|0(?:[1-9][0-9]{0,2}|0(?:[1-9][0-9]{0,1}|0[1-9]))))))))))$ */
     quantity: string;
-    /** The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused rather than priced at zero. */
+    /** The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to. */
     dimensions?: QuoteItemInputDimensions;
 }
 /**
@@ -2848,11 +2846,11 @@ export interface QuoteAddress {
     state?: string;
 }
 /**
- * Quote proposed items, changes or renewals: exactly one of them. Give exactly one of `billing_account_id` and `currency`; changes and renewals need the account. Promotion codes apply to proposed items and changes. An invalid combination fails with `BILLING_PURCHASE_INVALID` and the field.
+ * Quote proposed items, changes, renewals or a cancellation: exactly one of them. Give exactly one of `billing_account_id` and `currency`; changes, renewals and a cancellation need the account. Promotion codes apply to proposed items and changes. An invalid combination fails with `BILLING_PURCHASE_INVALID` and the field.
  */
 export interface QuoteRequest {
     /**
-     * The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Renewals must currently be paid by it.
+     * The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Renewals and a cancellation must currently be paid by it.
      * @minimum 1
      */
     billing_account_id?: number;
@@ -2880,6 +2878,7 @@ export interface QuoteRequest {
      * @maxItems 100
      */
     changes?: QuoteChangeInput[];
+    cancellation?: QuoteCancellation;
     /** When the changes take effect; defaults to `immediate`. `immediate` prices the rest of the paid period from `proration_date`, charging an upgrade the difference and showing what a downgrade refunds. `period_end` prices the first period at the new terms, which replaces the renewal when the paid period ends. */
     change_effective?: QuoteRequestChangeEffective;
     /** Only with `currency`. Where the customer is, to include the tax that would be added there for a customer who is not tax exempt; `tax_status` is then `complete`. Refused with `billing_account_id`, whose invoice contact decides tax. */

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

@@ -22,7 +22,7 @@ export const CancellationCreate = zod.strictObject({
         .datetime({ offset: true })
         .optional()
         .describe("For `immediate`, the quote's `proration_date`: a whole second, not in the future and at most ten minutes old; the refund is computed as of it. Now when omitted."),
-    expected_refundable_amount: Money.and(zod.string().regex(cancellationCreateExpectedRefundableAmountTwoRegExp)).describe("The quote's `refundable_amount`; the cancellation is refused when the refund differs."),
+    expected_refundable_amount: Money.and(zod.string().regex(cancellationCreateExpectedRefundableAmountTwoRegExp)).describe("The quote's `cancellation.refundable_amount`; the cancellation is refused when the refund differs."),
     reason: zod
         .string()
         .max(cancellationCreateReasonMax)

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

@@ -21,7 +21,7 @@ export const Price = zod.strictObject({
     rates: zod
         .array(Rate)
         .nullish()
-        .describe("For a price that delegates to a rate card, the rates in effect now that it charges at, one for each meter, dimension values and period; metered rates for a metered price, and rates on its own meter and period for a licensed one. `search-prices` narrows them with `dimensions`. Null for a price with its own amounts."),
+        .describe("For a price that delegates to a rate card, the rates in effect now that it charges at, one for each meter, dimension values and period; metered rates for a metered price, and rates on its own meter and period for a licensed one. `search-prices` narrows them with `dimensions`. Null for a price with its own amounts. Prices are set per currency, and dimension values a currency does not offer, for example in a region it does not sell to, have no rate in that currency and cannot be bought with it."),
     lookup_key: zod.string().optional(),
     product: Product,
     plan: ObjectIdentity,

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

@@ -93,6 +93,45 @@ export declare const Quote: zod.ZodObject<{
         tax_included_amount: zod.ZodString;
         total: zod.ZodString;
     }, zod.z.core.$strict>>;
+    cancellation: zod.ZodUnion<readonly [zod.ZodObject<{
+        mode: zod.ZodEnum<{
+            immediate: "immediate";
+            period_end: "period_end";
+        }>;
+        scheduled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        unused_amount: zod.ZodString;
+        short_rate_surcharge_amount: zod.ZodString;
+        refundable_amount: zod.ZodString;
+        refund_amount: zod.ZodString;
+        credit_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        forfeited_amount: zod.ZodString;
+        items: zod.ZodArray<zod.ZodObject<{
+            subscription_id: zod.ZodUUID;
+            plan_id: zod.ZodUUID;
+            plan_name: zod.ZodString;
+            project: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+                id: zod.ZodUUID;
+                name: zod.ZodString;
+            }, zod.z.core.$strict>, zod.ZodNull]>>;
+            type: zod.ZodEnum<{
+                one_time: "one_time";
+                recurring: "recurring";
+            }>;
+            usage_type: zod.ZodEnum<{
+                licensed: "licensed";
+                metered: "metered";
+            }>;
+            auto_renew: zod.ZodBoolean;
+            unused_amount: zod.ZodString;
+            short_rate_surcharge_amount: zod.ZodString;
+            refundable_amount: zod.ZodString;
+            refund_amount: zod.ZodString;
+            credit_amount: zod.ZodString;
+            tax_amount: zod.ZodString;
+            forfeited_amount: zod.ZodString;
+        }, zod.z.core.$strict>>;
+    }, zod.z.core.$strict>, zod.ZodNull]>;
     total: zod.ZodString;
     currency: zod.ZodString;
     proration_date: zod.ZodNullable<zod.z.ZodISODateTime>;

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

@@ -8,6 +8,7 @@
 import * as zod from "zod";
 import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
+import { QuoteCancellationResult } from "./quoteCancellationResult.zod.js";
 import { QuotedDiscount } from "./quotedDiscount.zod.js";
 import { QuoteItem } from "./quoteItem.zod.js";
 import { QuoteRenewalResult } from "./quoteRenewalResult.zod.js";
@@ -15,21 +16,24 @@ export const Quote = zod
     .strictObject({
     funds: zod
         .union([Funds, zod.null()])
-        .describe("Account funds for the quoted purchase. Null without an account."),
+        .describe("Account funds for the quoted purchase. Null without an account, and for a cancellation."),
     subtotal: Money,
     discount_amount: Money,
     tax_amount: Money,
     discount: zod
         .union([QuotedDiscount, zod.null()])
-        .describe("The discount a purchase would get, not yet applied. Null when there is none, and for renewals."),
+        .describe("The discount a purchase would get, not yet applied. Null when there is none, and for renewals and a cancellation."),
     items: zod.array(QuoteItem),
     renewals: zod.array(QuoteRenewalResult),
+    cancellation: zod
+        .union([QuoteCancellationResult, zod.null()])
+        .describe("What the cancellation would return. Null unless the request quotes a cancellation."),
     total: Money,
     currency: zod.string(),
     proration_date: zod.iso
         .datetime({ offset: true })
         .nullable()
-        .describe("Immediate changes only; null otherwise. The instant the change is priced from; pass it when confirming the Checkout Session so it is priced from the same instant."),
+        .describe("Immediate changes and immediate cancellations only; null otherwise. The instant the change or the refund is priced from; pass it when confirming the Checkout Session or creating the cancellation so it is priced from the same instant."),
     tax_status: zod
         .enum(["complete", "requires_location_inputs"])
         .describe("`complete`: tax is calculated for the billing account's invoice contact, or for `address` without an account. `requires_location_inputs`: a quote without an account or `address`, which leaves out tax that would be added; tax already contained in a price is included."),

package/dist/billing/v1/generated/validators/{cancellationPreviewRequest.zod.d.ts → quoteCancellation.zod.d.ts}

@@ -6,14 +6,13 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const cancellationPreviewRequestSubscriptionIdsMax = 50;
-export declare const CancellationPreviewRequest: zod.ZodObject<{
-    billing_account_id: zod.ZodInt;
+export declare const quoteCancellationSubscriptionIdsMax = 50;
+export declare const QuoteCancellation: zod.ZodObject<{
     subscription_ids: zod.ZodArray<zod.ZodUUID>;
     mode: zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";
     }>;
 }, zod.z.core.$strict>;
-export type CancellationPreviewRequest = zod.input<typeof CancellationPreviewRequest>;
-export type CancellationPreviewRequestOutput = zod.output<typeof CancellationPreviewRequest>;
+export type QuoteCancellation = zod.input<typeof QuoteCancellation>;
+export type QuoteCancellationOutput = zod.output<typeof QuoteCancellation>;

package/dist/billing/v1/generated/validators/{cancellationPreviewRequest.zod.js → quoteCancellation.zod.js}

@@ -7,18 +7,14 @@
  */
 import * as zod from "zod";
 import { CancellationMode } from "./cancellationMode.zod.js";
-export const cancellationPreviewRequestSubscriptionIdsMax = 50;
-export const CancellationPreviewRequest = zod
+export const quoteCancellationSubscriptionIdsMax = 50;
+export const QuoteCancellation = zod
     .strictObject({
-    billing_account_id: zod
-        .int()
-        .min(1)
-        .describe("A billing account you own that currently pays for every subscription."),
     subscription_ids: zod
         .array(zod.uuid())
         .min(1)
-        .max(cancellationPreviewRequestSubscriptionIdsMax)
+        .max(quoteCancellationSubscriptionIdsMax)
         .describe("The subscriptions to end together, all of one service, including every subscription released with a resource."),
     mode: CancellationMode,
 })
-    .describe("What ending these subscriptions together would return, for one mode; preview `immediate` and `period_end` separately to compare. Refused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a paid change waiting to switch (`meta.order_id`).");
+    .describe("Preview ending these subscriptions together in one mode; quote `immediate` and `period_end` separately to\ncompare. Each must currently be paid by `billing_account_id` and be yours to read, as the owner of that account\nor a member of the subscriptions' project. Refused as creating the cancellation would be, including 409\n`BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled (`meta.cancellation_id`),\nis being reclaimed (`meta.reason` `reclaim_requested`) or has a paid change waiting to switch (`meta.order_id`).");

package/dist/billing/v1/generated/validators/{cancellationRefundPreviewItem.zod.d.ts → quoteCancellationItem.zod.d.ts}

@@ -6,7 +6,7 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const CancellationRefundPreviewItem: zod.ZodObject<{
+export declare const QuoteCancellationItem: zod.ZodObject<{
     subscription_id: zod.ZodUUID;
     plan_id: zod.ZodUUID;
     plan_name: zod.ZodString;
@@ -31,5 +31,5 @@ export declare const CancellationRefundPreviewItem: zod.ZodObject<{
     tax_amount: zod.ZodString;
     forfeited_amount: zod.ZodString;
 }, zod.z.core.$strict>;
-export type CancellationRefundPreviewItem = zod.input<typeof CancellationRefundPreviewItem>;
-export type CancellationRefundPreviewItemOutput = zod.output<typeof CancellationRefundPreviewItem>;
+export type QuoteCancellationItem = zod.input<typeof QuoteCancellationItem>;
+export type QuoteCancellationItemOutput = zod.output<typeof QuoteCancellationItem>;

package/dist/billing/v1/generated/validators/{cancellationRefundPreviewItem.zod.js → quoteCancellationItem.zod.js}

@@ -10,7 +10,7 @@ import { Money } from "./money.zod.js";
 import { NamedIdentity } from "./namedIdentity.zod.js";
 import { PriceType } from "./priceType.zod.js";
 import { UsageType } from "./usageType.zod.js";
-export const CancellationRefundPreviewItem = zod
+export const QuoteCancellationItem = zod
     .strictObject({
     subscription_id: zod.uuid(),
     plan_id: zod.uuid(),
@@ -32,4 +32,4 @@ export const CancellationRefundPreviewItem = zod
     tax_amount: Money,
     forfeited_amount: Money,
 })
-    .describe("One subscription of the previewed cancellation.");
+    .describe("One subscription of the quoted cancellation.");

package/dist/billing/v1/generated/validators/{cancellationRefundPreview.zod.d.ts → quoteCancellationResult.zod.d.ts}

@@ -6,14 +6,12 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const CancellationRefundPreview: zod.ZodObject<{
+export declare const QuoteCancellationResult: zod.ZodObject<{
     mode: zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";
     }>;
     scheduled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-    proration_date: zod.ZodOptional<zod.z.ZodISODateTime>;
-    currency: zod.ZodString;
     unused_amount: zod.ZodString;
     short_rate_surcharge_amount: zod.ZodString;
     refundable_amount: zod.ZodString;
@@ -47,5 +45,5 @@ export declare const CancellationRefundPreview: zod.ZodObject<{
         forfeited_amount: zod.ZodString;
     }, zod.z.core.$strict>>;
 }, zod.z.core.$strict>;
-export type CancellationRefundPreview = zod.input<typeof CancellationRefundPreview>;
-export type CancellationRefundPreviewOutput = zod.output<typeof CancellationRefundPreview>;
+export type QuoteCancellationResult = zod.input<typeof QuoteCancellationResult>;
+export type QuoteCancellationResultOutput = zod.output<typeof QuoteCancellationResult>;

package/dist/billing/v1/generated/validators/{cancellationRefundPreview.zod.js → quoteCancellationResult.zod.js}

@@ -7,20 +7,15 @@
  */
 import * as zod from "zod";
 import { CancellationMode } from "./cancellationMode.zod.js";
-import { CancellationRefundPreviewItem } from "./cancellationRefundPreviewItem.zod.js";
 import { Money } from "./money.zod.js";
-export const CancellationRefundPreview = zod
+import { QuoteCancellationItem } from "./quoteCancellationItem.zod.js";
+export const QuoteCancellationResult = zod
     .strictObject({
     mode: CancellationMode,
     scheduled_at: zod.iso
         .datetime({ offset: true })
         .optional()
         .describe("For `period_end`, when release begins, the end of the paid terms."),
-    proration_date: zod.iso
-        .datetime({ offset: true })
-        .optional()
-        .describe("For `immediate`, the second the refund is computed as of. Give it when creating the cancellation."),
-    currency: zod.string(),
     unused_amount: Money,
     short_rate_surcharge_amount: Money,
     refundable_amount: Money,
@@ -28,6 +23,6 @@ export const CancellationRefundPreview = zod
     credit_amount: Money,
     tax_amount: Money,
     forfeited_amount: Money,
-    items: zod.array(CancellationRefundPreviewItem),
+    items: zod.array(QuoteCancellationItem),
 })
-    .describe("What the cancellation would return, per subscription and in total, as of now. Give `proration_date` and\n`refundable_amount` when creating the cancellation.\n\n- `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.\n- `short_rate_surcharge_amount`: before tax, the part of `forfeited_amount` due to the short rate of the\n  refund policy.\n- `refundable_amount`: what is returned the way it was paid, tax included; `refund_amount` plus\n  `credit_amount`.\n- `refund_amount`: the part returned to the balance or the payment method.\n- `credit_amount`: the part restored to the credit grants that paid.\n- `tax_amount`: the tax included in `refundable_amount`.\n- `forfeited_amount`: before tax, the part of `unused_amount` the refund terms do not return.\n\nMetered and one-time subscriptions show zero; their usage until release is charged as usual.");
+    .describe("What the cancellation would return, per subscription and in total, as of the quote's `proration_date` for\n`immediate`. Give that `proration_date` and `refundable_amount` when creating the cancellation.\n\n- `unused_amount`: before tax, the amount paid for the current periods in proportion to the time remaining.\n- `short_rate_surcharge_amount`: before tax, the part of `forfeited_amount` due to the short rate of the\n  refund policy.\n- `refundable_amount`: what is returned the way it was paid, tax included; `refund_amount` plus\n  `credit_amount`.\n- `refund_amount`: the part returned to the balance or the payment method.\n- `credit_amount`: the part restored to the credit grants that paid.\n- `tax_amount`: the tax included in `refundable_amount`.\n- `forfeited_amount`: before tax, the part of `unused_amount` the refund terms do not return.\n\nMetered and one-time subscriptions show zero; their usage until release is charged as usual.");

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

@@ -29,6 +29,6 @@ export const QuoteItemInput = zod
     dimensions: zod
         .record(zod.string(), zod.string())
         .optional()
-        .describe("The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused rather than priced at zero."),
+        .describe("The dimension values of what is bought, such as region and instance type. Required whenever the price uses a rate card; prices with their own amounts ignore them. Every key the meter declares must be given. A combination no rate covers is refused with `BILLING_PRICE_UNAVAILABLE` rather than priced at zero. Prices are set per currency, and a currency may not offer some combinations at all, for example in a region it does not sell to."),
 })
     .describe("Identify a price, or select one for a plan; give each resource's ID or lookup key, never both, and product_id with lookup keys. A metered item includes only any setup charge; its usage is estimated with `estimate-usage`.");

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

@@ -87,6 +87,13 @@ export declare const QuoteRequest: zod.ZodObject<{
         quantity: zod.ZodString;
         dimensions: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
     }, zod.z.core.$strict>>>;
+    cancellation: zod.ZodOptional<zod.ZodObject<{
+        subscription_ids: zod.ZodArray<zod.ZodUUID>;
+        mode: zod.ZodEnum<{
+            immediate: "immediate";
+            period_end: "period_end";
+        }>;
+    }, zod.z.core.$strict>>;
     change_effective: zod.ZodOptional<zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 import { QuoteAddress } from "./quoteAddress.zod.js";
+import { QuoteCancellation } from "./quoteCancellation.zod.js";
 import { QuoteChangeInput } from "./quoteChangeInput.zod.js";
 import { QuoteItemInput } from "./quoteItemInput.zod.js";
 import { QuoteRenewal } from "./quoteRenewal.zod.js";
@@ -22,7 +23,7 @@ export const QuoteRequest = zod
         .int()
         .min(1)
         .optional()
-        .describe("The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Renewals must currently be paid by it."),
+        .describe("The billing account to price for; it must be yours or currently pay for a project you are a member of, and an access token is required. Renewals and a cancellation must currently be paid by it."),
     currency: zod
         .string()
         .min(quoteRequestCurrencyMin)
@@ -47,6 +48,7 @@ export const QuoteRequest = zod
         .max(quoteRequestChangesMax)
         .optional()
         .describe("Preview changing these subscriptions in one order, each at most once. Each must currently be paid by `billing_account_id` and be yours to read, as the owner of that account or a member of the subscription's project; all must belong to the same project, or all to no project."),
+    cancellation: QuoteCancellation.optional(),
     change_effective: zod
         .enum(["immediate", "period_end"])
         .optional()
@@ -54,4 +56,4 @@ export const QuoteRequest = zod
     address: QuoteAddress.optional().describe("Only with `currency`. Where the customer is, to include the tax that would be added there for a customer who is not tax exempt; `tax_status` is then `complete`. Refused with `billing_account_id`, whose invoice contact decides tax."),
     promotion_code: zod.string().min(1).max(quoteRequestPromotionCodeMax).optional(),
 })
-    .describe("Quote proposed items, changes or renewals: exactly one of them. Give exactly one of `billing_account_id` and `currency`; changes and renewals need the account. Promotion codes apply to proposed items and changes. An invalid combination fails with `BILLING_PURCHASE_INVALID` and the field.");
+    .describe("Quote proposed items, changes, renewals or a cancellation: exactly one of them. Give exactly one of `billing_account_id` and `currency`; changes, renewals and a cancellation need the account. Promotion codes apply to proposed items and changes. An invalid combination fails with `BILLING_PURCHASE_INVALID` and the field.");

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

@@ -349,6 +349,8 @@ export interface ModelMeter {
  * How requests to a model are billed: under the service's subscription, on the Billing plan `plan_id`, one rate for each token kind. Read the rates from Billing with `search-prices` for the plan, narrowing each price's `rates` with each meter's `dimensions`.
  *
  * Each token kind is priced on its own. `input` excludes cached input, which is `cache_read`, and `output` excludes reasoning the provider reports separately, which is `reasoning`; a request is billed for each kind it used.
+ *
+ * Rates are set per currency, and a currency may not offer a model at all. A model is offered in the currency of the project's billing account when at least one of its token kinds has a rate there; a token kind without a rate in that currency is not charged. Requests to a model with no rate in that currency are refused with 403 `BILLING_MODEL_NOT_OFFERED`.
  */
 export interface ModelBilling {
     /**

package/dist/canopy/v1/generated/validators/modelBilling.zod.js

@@ -50,4 +50,4 @@ export const ModelBilling = zod
         .array(ModelMeter)
         .describe("One entry for each of the five token kinds, in the order input, output, cache_read, cache_write, reasoning."),
 })
-    .describe("How requests to a model are billed: under the service's subscription, on the Billing plan `plan_id`, one rate for each token kind. Read the rates from Billing with `search-prices` for the plan, narrowing each price's `rates` with each meter's `dimensions`.\n\nEach token kind is priced on its own. `input` excludes cached input, which is `cache_read`, and `output` excludes reasoning the provider reports separately, which is `reasoning`; a request is billed for each kind it used.");
+    .describe("How requests to a model are billed: under the service's subscription, on the Billing plan `plan_id`, one rate for each token kind. Read the rates from Billing with `search-prices` for the plan, narrowing each price's `rates` with each meter's `dimensions`.\n\nEach token kind is priced on its own. `input` excludes cached input, which is `cache_read`, and `output` excludes reasoning the provider reports separately, which is `reasoning`; a request is billed for each kind it used.\n\nRates are set per currency, and a currency may not offer a model at all. A model is offered in the currency of the project's billing account when at least one of its token kinds has a rate there; a token kind without a rate in that currency is not charged. Requests to a model with no rate in that currency are refused with 403 `BILLING_MODEL_NOT_OFFERED`.");

package/dist/routes.d.ts

@@ -1223,14 +1223,6 @@ export declare const routes: readonly [{
     readonly operationId: "create-cancellation";
     readonly securityScheme: "AccessToken";
     readonly upstreamUrl: "https://billing.leaflow.cloud";
-}, {
-    readonly service: "billing";
-    readonly contract: "billing";
-    readonly method: "QUERY";
-    readonly path: "/api/v1/cancellations/preview";
-    readonly operationId: "preview-cancellation";
-    readonly securityScheme: "AccessToken";
-    readonly upstreamUrl: "https://billing.leaflow.cloud";
 }, {
     readonly service: "billing";
     readonly contract: "billing";

package/dist/routes.js

@@ -1378,15 +1378,6 @@ export const routes = [
         securityScheme: "AccessToken",
         upstreamUrl: "https://billing.leaflow.cloud",
     },
-    {
-        service: "billing",
-        contract: "billing",
-        method: "QUERY",
-        path: "/api/v1/cancellations/preview",
-        operationId: "preview-cancellation",
-        securityScheme: "AccessToken",
-        upstreamUrl: "https://billing.leaflow.cloud",
-    },
     {
         service: "billing",
         contract: "billing",

package/package.json

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