@leaflow/sdk 0.122.0 → 0.123.0

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

@@ -471,6 +471,10 @@ export interface Quote {
 /**
  * A cancellation to quote: what ending these subscriptions together would return. One mode per
  * request; to compare, quote `immediate` and `period_end` separately.
+ *
+ * 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 still waiting to switch (`meta.order_id`).
  */
 export interface QuoteCancellation {
     /**
@@ -1135,6 +1139,9 @@ export interface PaymentMethodSetupResult {
  * through the selected gateway. Grants restricted to other purchases are not counted as available funds.
  * An unresolved channel payment is reused; retries do not apply the grant or balance portions twice.
  * Without a gateway selection, insufficient account funds fail without starting an online payment.
+ *
+ * `payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;
+ * otherwise the request is refused with `BILLING_PURCHASE_INVALID`.
  */
 export interface PayInvoiceRequest {
     /**
@@ -1860,8 +1867,9 @@ export interface Subscription {
     cancellation?: SubscriptionCancellation;
     /**
      * The saved payment method automatic renewal charges after the account's balance and credits,
-     * before the account's default payment method. Set when the purchase, or a renewal, is paid with a saved
-     * payment method. It is used only while it belongs to the account that pays the renewal.
+     * before the account's default payment method. Set when the purchase, a renewal or a change is paid with a
+     * saved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the
+     * account that pays the renewal.
      * @nullable
      */
     default_payment_method_id?: string | null;
@@ -2027,6 +2035,8 @@ export interface RenewalOrderRequest {
     interval_count?: number;
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
+    /** As in renewing. */
+    termination_policy?: TerminationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;

package/dist/billing/type/order/v1/generated/validators/payInvoiceRequest.zod.js

@@ -50,4 +50,4 @@ export const PayInvoiceRequest = zod
         .optional()
         .describe("The invoice total to expect, after discounts and tax and before credit grants or balance, as the\npayment preview or an order quote gave it. A different total fails with BILLING_AMOUNT_CHANGED\nand nothing is charged. Omit to skip the comparison; an explicit zero is compared."),
 })
-    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.");
+    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.\n\n`payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;\notherwise the request is refused with `BILLING_PURCHASE_INVALID`.");

package/dist/billing/type/order/v1/generated/validators/quoteCancellation.zod.js

@@ -17,4 +17,4 @@ export const QuoteCancellation = zod
         .describe("The subscriptions to end together, all of one service. Every subscription released with a resource must be included."),
     mode: TerminationPolicy,
 })
-    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.");
+    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.\n\nRefused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being\ncanceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a\npaid change still waiting to switch (`meta.order_id`).");

package/dist/billing/type/order/v1/generated/validators/renewalOrderRequest.zod.d.ts

@@ -16,6 +16,10 @@ export declare const RenewalOrderRequest: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 export type RenewalOrderRequest = zod.input<typeof RenewalOrderRequest>;
 export type RenewalOrderRequestOutput = zod.output<typeof RenewalOrderRequest>;

package/dist/billing/type/order/v1/generated/validators/renewalOrderRequest.zod.js

@@ -6,6 +6,7 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
+import { TerminationPolicy } from "./terminationPolicy.zod.js";
 export const renewalOrderRequestPeriodsDefault = 1;
 export const RenewalOrderRequest = zod
     .strictObject({
@@ -19,5 +20,6 @@ export const RenewalOrderRequest = zod
         .describe("As in renewing."),
     interval_count: zod.int().min(1).optional().describe("As in renewing."),
     interval: zod.enum(["day", "month", "year"]).optional().describe("As in renewing."),
+    termination_policy: TerminationPolicy.optional().describe("As in renewing."),
 })
     .describe("The periods and price of the renewal, chosen as in renewing.");

package/dist/billing/type/order/v1/generated/validators/subscription.zod.js

@@ -44,7 +44,7 @@ export const Subscription = zod
     default_payment_method_id: zod
         .uuid()
         .nullish()
-        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, or a renewal, is paid with a saved\npayment method. It is used only while it belongs to the account that pays the renewal."),
+        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, a renewal or a change is paid with a\nsaved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the\naccount that pays the renewal."),
     created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod

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

@@ -614,7 +614,10 @@ export declare const getPayInvoiceUrl: (invoiceId: string) => string;
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
  * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export declare const payInvoice: (invoiceId: string, payInvoiceRequest?: PayInvoiceRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<payInvoiceResponse>;
@@ -678,7 +681,10 @@ export declare const getPayTogetherUrl: () => string;
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export declare const payTogether: (payTogetherRequest: PayTogetherRequest, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<payTogetherResponse>;
@@ -1142,7 +1148,8 @@ export declare const getCreateCancellationUrl: () => string;
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer

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

@@ -645,7 +645,10 @@ export const getPayInvoiceUrl = (invoiceId) => {
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
  * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export const payInvoice = async (invoiceId, payInvoiceRequest, options, fetchFn) => {
@@ -725,7 +728,10 @@ export const getPayTogetherUrl = () => {
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export const payTogether = async (payTogetherRequest, options, fetchFn) => {
@@ -1257,7 +1263,8 @@ export const getCreateCancellationUrl = () => {
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer

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

@@ -281,6 +281,10 @@ export interface Quote {
 /**
  * A cancellation to quote: what ending these subscriptions together would return. One mode per
  * request; to compare, quote `immediate` and `period_end` separately.
+ *
+ * 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 still waiting to switch (`meta.order_id`).
  */
 export interface QuoteCancellation {
     /**
@@ -956,6 +960,9 @@ export interface PaymentMethodSetupResult {
  * through the selected gateway. Grants restricted to other purchases are not counted as available funds.
  * An unresolved channel payment is reused; retries do not apply the grant or balance portions twice.
  * Without a gateway selection, insufficient account funds fail without starting an online payment.
+ *
+ * `payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;
+ * otherwise the request is refused with `BILLING_PURCHASE_INVALID`.
  */
 export interface PayInvoiceRequest {
     /**
@@ -1697,8 +1704,9 @@ export interface Subscription {
     cancellation?: SubscriptionCancellation;
     /**
      * The saved payment method automatic renewal charges after the account's balance and credits,
-     * before the account's default payment method. Set when the purchase, or a renewal, is paid with a saved
-     * payment method. It is used only while it belongs to the account that pays the renewal.
+     * before the account's default payment method. Set when the purchase, a renewal or a change is paid with a
+     * saved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the
+     * account that pays the renewal.
      * @nullable
      */
     default_payment_method_id?: string | null;
@@ -1864,6 +1872,8 @@ export interface RenewalOrderRequest {
     interval_count?: number;
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
+    /** As in renewing. */
+    termination_policy?: TerminationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;

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

@@ -341,7 +341,10 @@ export declare const DeletePaymentMethodParams: zod.ZodObject<{
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
  * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export declare const PayInvoiceParams: zod.ZodObject<{
@@ -395,7 +398,10 @@ export declare const PreviewInvoicePaymentQueryParams: zod.ZodObject<{
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export declare const PayTogetherBody: zod.ZodObject<{
@@ -774,7 +780,8 @@ export declare const ListCancellationsQueryParams: zod.ZodObject<{
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer
@@ -889,6 +896,10 @@ export declare const CreateRenewalOrderBody: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 /**
  * Controls automatic prepaid renewal. Disabling it does not shorten current_term_end and still permits

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

@@ -396,7 +396,10 @@ export const DeletePaymentMethodParams = zod.strictObject({
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
  * order that has failed or was
  * canceled, with `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`; and that of an order whose
- * payment deadline has passed, with `BILLING_ORDER_EXPIRED`.
+ * payment deadline has passed, with `BILLING_ORDER_EXPIRED`. A renewal invoice is also refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay an invoice
  */
 export const PayInvoiceParams = zod.strictObject({
@@ -452,7 +455,10 @@ export const PreviewInvoicePaymentQueryParams = zod.strictObject({
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
- * passed with `BILLING_ORDER_EXPIRED`.
+ * passed with `BILLING_ORDER_EXPIRED`. A renewal invoice is refused with
+ * `BILLING_INVOICE_NOT_PAYABLE` while its subscription is being canceled, is being reclaimed or has
+ * ended, with `meta.reason` `subscription_canceling`, `subscription_reclaiming` or
+ * `subscription_ended` respectively.
  * @summary Pay together
  */
 export const PayTogetherBody = PayTogetherRequest;
@@ -911,7 +917,8 @@ export const ListCancellationsQueryParams = zod.strictObject({
  * - 409 `BILLING_CANCELLATION_SCHEDULES_DIFFER` when, for `period_end`, the paid terms end at
  *   different times;
  * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being canceled
- *   (`meta.cancellation_id`) or reclaimed (`meta.action_id`);
+ *   (`meta.cancellation_id`) or reclaimed (`meta.reason` `reclaim_requested`), or has a paid
+ *   change still waiting to switch (`meta.order_id`);
  * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online payment for a renewal of one of them
  *   is in progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund is no longer

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

@@ -50,4 +50,4 @@ export const PayInvoiceRequest = zod
         .optional()
         .describe("The invoice total to expect, after discounts and tax and before credit grants or balance, as the\npayment preview or an order quote gave it. A different total fails with BILLING_AMOUNT_CHANGED\nand nothing is charged. Omit to skip the comparison; an explicit zero is compared."),
 })
-    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.");
+    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.\n\n`payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;\notherwise the request is refused with `BILLING_PURCHASE_INVALID`.");

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

@@ -17,4 +17,4 @@ export const QuoteCancellation = zod
         .describe("The subscriptions to end together, all of one service. Every subscription released with a resource must be included."),
     mode: TerminationPolicy,
 })
-    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.");
+    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.\n\nRefused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being\ncanceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a\npaid change still waiting to switch (`meta.order_id`).");

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

@@ -16,6 +16,10 @@ export declare const RenewalOrderRequest: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 export type RenewalOrderRequest = zod.input<typeof RenewalOrderRequest>;
 export type RenewalOrderRequestOutput = zod.output<typeof RenewalOrderRequest>;

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

@@ -6,6 +6,7 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
+import { TerminationPolicy } from "./terminationPolicy.zod.js";
 export const renewalOrderRequestPeriodsDefault = 1;
 export const RenewalOrderRequest = zod
     .strictObject({
@@ -19,5 +20,6 @@ export const RenewalOrderRequest = zod
         .describe("As in renewing."),
     interval_count: zod.int().min(1).optional().describe("As in renewing."),
     interval: zod.enum(["day", "month", "year"]).optional().describe("As in renewing."),
+    termination_policy: TerminationPolicy.optional().describe("As in renewing."),
 })
     .describe("The periods and price of the renewal, chosen as in renewing.");

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

@@ -44,7 +44,7 @@ export const Subscription = zod
     default_payment_method_id: zod
         .uuid()
         .nullish()
-        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, or a renewal, is paid with a saved\npayment method. It is used only while it belongs to the account that pays the renewal."),
+        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, a renewal or a change is paid with a\nsaved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the\naccount that pays the renewal."),
     created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod

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

@@ -955,6 +955,10 @@ export type QuoteA200529 = Quote5f60d00;
 /**
  * A cancellation to quote: what ending these subscriptions together would return. One mode per
  * request; to compare, quote `immediate` and `period_end` separately.
+ *
+ * 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 still waiting to switch (`meta.order_id`).
  */
 export interface QuoteCancellation {
     /**
@@ -1603,6 +1607,9 @@ export interface PaymentMethodSetupResult {
  * through the selected gateway. Grants restricted to other purchases are not counted as available funds.
  * An unresolved channel payment is reused; retries do not apply the grant or balance portions twice.
  * Without a gateway selection, insufficient account funds fail without starting an online payment.
+ *
+ * `payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;
+ * otherwise the request is refused with `BILLING_PURCHASE_INVALID`.
  */
 export interface PayInvoiceRequest {
     /**
@@ -2328,8 +2335,9 @@ export interface Subscription {
     cancellation?: SubscriptionCancellation;
     /**
      * The saved payment method automatic renewal charges after the account's balance and credits,
-     * before the account's default payment method. Set when the purchase, or a renewal, is paid with a saved
-     * payment method. It is used only while it belongs to the account that pays the renewal.
+     * before the account's default payment method. Set when the purchase, a renewal or a change is paid with a
+     * saved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the
+     * account that pays the renewal.
      * @nullable
      */
     default_payment_method_id?: string | null;
@@ -2495,6 +2503,8 @@ export interface RenewalOrderRequest {
     interval_count?: number;
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
+    /** As in renewing. */
+    termination_policy?: TerminationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;

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

@@ -73,4 +73,4 @@ export const PayInvoiceRequest = zod
         .optional()
         .describe("The invoice total to expect, after discounts and tax and before credit grants or balance, as the\npayment preview or an order quote gave it. A different total fails with BILLING_AMOUNT_CHANGED\nand nothing is charged. Omit to skip the comparison; an explicit zero is compared."),
 })
-    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.");
+    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.\n\n`payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;\notherwise the request is refused with `BILLING_PURCHASE_INVALID`.");

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

@@ -40,4 +40,4 @@ export const QuoteCancellation = zod
         .describe("The subscriptions to end together, all of one service. Every subscription released with a resource must be included."),
     mode: TerminationPolicy,
 })
-    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.");
+    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.\n\nRefused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being\ncanceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a\npaid change still waiting to switch (`meta.order_id`).");

package/dist/canopy/v1/generated/validators/renewalOrderRequest.zod.d.ts

@@ -39,6 +39,10 @@ export declare const RenewalOrderRequest: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 export type RenewalOrderRequest = zod.input<typeof RenewalOrderRequest>;
 export type RenewalOrderRequestOutput = zod.output<typeof RenewalOrderRequest>;

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

@@ -29,6 +29,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { TerminationPolicy } from "./terminationPolicy.zod.js";
 export const renewalOrderRequestPeriodsDefault = 1;
 export const RenewalOrderRequest = zod
     .strictObject({
@@ -42,5 +43,6 @@ export const RenewalOrderRequest = zod
         .describe("As in renewing."),
     interval_count: zod.int().min(1).optional().describe("As in renewing."),
     interval: zod.enum(["day", "month", "year"]).optional().describe("As in renewing."),
+    termination_policy: TerminationPolicy.optional().describe("As in renewing."),
 })
     .describe("The periods and price of the renewal, chosen as in renewing.");

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

@@ -67,7 +67,7 @@ export const Subscription = zod
     default_payment_method_id: zod
         .uuid()
         .nullish()
-        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, or a renewal, is paid with a saved\npayment method. It is used only while it belongs to the account that pays the renewal."),
+        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, a renewal or a change is paid with a\nsaved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the\naccount that pays the renewal."),
     created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod

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

@@ -2901,6 +2901,10 @@ export type QuoteA200529 = Quote5f60d00;
 /**
  * A cancellation to quote: what ending these subscriptions together would return. One mode per
  * request; to compare, quote `immediate` and `period_end` separately.
+ *
+ * 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 still waiting to switch (`meta.order_id`).
  */
 export interface QuoteCancellation {
     /**
@@ -3549,6 +3553,9 @@ export interface PaymentMethodSetupResult {
  * through the selected gateway. Grants restricted to other purchases are not counted as available funds.
  * An unresolved channel payment is reused; retries do not apply the grant or balance portions twice.
  * Without a gateway selection, insufficient account funds fail without starting an online payment.
+ *
+ * `payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;
+ * otherwise the request is refused with `BILLING_PURCHASE_INVALID`.
  */
 export interface PayInvoiceRequest {
     /**
@@ -4274,8 +4281,9 @@ export interface Subscription {
     cancellation?: SubscriptionCancellation;
     /**
      * The saved payment method automatic renewal charges after the account's balance and credits,
-     * before the account's default payment method. Set when the purchase, or a renewal, is paid with a saved
-     * payment method. It is used only while it belongs to the account that pays the renewal.
+     * before the account's default payment method. Set when the purchase, a renewal or a change is paid with a
+     * saved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the
+     * account that pays the renewal.
      * @nullable
      */
     default_payment_method_id?: string | null;
@@ -4441,6 +4449,8 @@ export interface RenewalOrderRequest {
     interval_count?: number;
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
+    /** As in renewing. */
+    termination_policy?: TerminationPolicyBfdab9f;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;

package/dist/compute/v1/generated/validators/payInvoiceRequest.zod.js

@@ -66,4 +66,4 @@ export const PayInvoiceRequest = zod
         .optional()
         .describe("The invoice total to expect, after discounts and tax and before credit grants or balance, as the\npayment preview or an order quote gave it. A different total fails with BILLING_AMOUNT_CHANGED\nand nothing is charged. Omit to skip the comparison; an explicit zero is compared."),
 })
-    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.");
+    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.\n\n`payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;\notherwise the request is refused with `BILLING_PURCHASE_INVALID`.");

package/dist/compute/v1/generated/validators/quoteCancellation.zod.js

@@ -33,4 +33,4 @@ export const QuoteCancellation = zod
         .describe("The subscriptions to end together, all of one service. Every subscription released with a resource must be included."),
     mode: TerminationPolicyBfdab9f,
 })
-    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.");
+    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.\n\nRefused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being\ncanceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a\npaid change still waiting to switch (`meta.order_id`).");

package/dist/compute/v1/generated/validators/renewalOrderRequest.zod.d.ts

@@ -32,6 +32,10 @@ export declare const RenewalOrderRequest: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 export type RenewalOrderRequest = zod.input<typeof RenewalOrderRequest>;
 export type RenewalOrderRequestOutput = zod.output<typeof RenewalOrderRequest>;

package/dist/compute/v1/generated/validators/renewalOrderRequest.zod.js

@@ -22,6 +22,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { TerminationPolicyBfdab9f } from "./terminationPolicyBfdab9f.zod.js";
 export const renewalOrderRequestPeriodsDefault = 1;
 export const RenewalOrderRequest = zod
     .strictObject({
@@ -35,5 +36,6 @@ export const RenewalOrderRequest = zod
         .describe("As in renewing."),
     interval_count: zod.int().min(1).optional().describe("As in renewing."),
     interval: zod.enum(["day", "month", "year"]).optional().describe("As in renewing."),
+    termination_policy: TerminationPolicyBfdab9f.optional().describe("As in renewing."),
 })
     .describe("The periods and price of the renewal, chosen as in renewing.");

package/dist/compute/v1/generated/validators/subscription.zod.js

@@ -60,7 +60,7 @@ export const Subscription = zod
     default_payment_method_id: zod
         .uuid()
         .nullish()
-        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, or a renewal, is paid with a saved\npayment method. It is used only while it belongs to the account that pays the renewal."),
+        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, a renewal or a change is paid with a\nsaved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the\naccount that pays the renewal."),
     created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod

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

@@ -796,6 +796,10 @@ export interface Quote {
 /**
  * A cancellation to quote: what ending these subscriptions together would return. One mode per
  * request; to compare, quote `immediate` and `period_end` separately.
+ *
+ * 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 still waiting to switch (`meta.order_id`).
  */
 export interface QuoteCancellation {
     /**
@@ -1445,6 +1449,9 @@ export interface PaymentMethodSetupResult {
  * through the selected gateway. Grants restricted to other purchases are not counted as available funds.
  * An unresolved channel payment is reused; retries do not apply the grant or balance portions twice.
  * Without a gateway selection, insufficient account funds fail without starting an online payment.
+ *
+ * `payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;
+ * otherwise the request is refused with `BILLING_PURCHASE_INVALID`.
  */
 export interface PayInvoiceRequest {
     /**
@@ -2170,8 +2177,9 @@ export interface Subscription {
     cancellation?: SubscriptionCancellation;
     /**
      * The saved payment method automatic renewal charges after the account's balance and credits,
-     * before the account's default payment method. Set when the purchase, or a renewal, is paid with a saved
-     * payment method. It is used only while it belongs to the account that pays the renewal.
+     * before the account's default payment method. Set when the purchase, a renewal or a change is paid with a
+     * saved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the
+     * account that pays the renewal.
      * @nullable
      */
     default_payment_method_id?: string | null;
@@ -2337,6 +2345,8 @@ export interface RenewalOrderRequest {
     interval_count?: number;
     /** As in renewing. */
     interval?: RenewalOrderRequestInterval;
+    /** As in renewing. */
+    termination_policy?: TerminationPolicy;
 }
 export interface AutoRenewSet {
     auto_renew: boolean;

package/dist/membership/v1/generated/validators/payInvoiceRequest.zod.js

@@ -65,4 +65,4 @@ export const PayInvoiceRequest = zod
         .optional()
         .describe("The invoice total to expect, after discounts and tax and before credit grants or balance, as the\npayment preview or an order quote gave it. A different total fails with BILLING_AMOUNT_CHANGED\nand nothing is charged. Omit to skip the comparison; an explicit zero is compared."),
 })
-    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.");
+    .describe("Applies eligible credit grants and the available balance as requested, then collects only the remainder\nthrough the selected gateway. Grants restricted to other purchases are not counted as available funds.\nAn unresolved channel payment is reused; retries do not apply the grant or balance portions twice.\nWithout a gateway selection, insufficient account funds fail without starting an online payment.\n\n`payment_gateway` and `method_type` are given together, and `payment_method_id` only with both;\notherwise the request is refused with `BILLING_PURCHASE_INVALID`.");

package/dist/membership/v1/generated/validators/quoteCancellation.zod.js

@@ -32,4 +32,4 @@ export const QuoteCancellation = zod
         .describe("The subscriptions to end together, all of one service. Every subscription released with a resource must be included."),
     mode: TerminationPolicy,
 })
-    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.");
+    .describe("A cancellation to quote: what ending these subscriptions together would return. One mode per\nrequest; to compare, quote `immediate` and `period_end` separately.\n\nRefused with 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when a subscription is already being\ncanceled (`meta.cancellation_id`), is being reclaimed (`meta.reason` `reclaim_requested`) or has a\npaid change still waiting to switch (`meta.order_id`).");

package/dist/membership/v1/generated/validators/renewalOrderRequest.zod.d.ts

@@ -31,6 +31,10 @@ export declare const RenewalOrderRequest: zod.ZodObject<{
         month: "month";
         year: "year";
     }>>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
 }, zod.z.core.$strict>;
 export type RenewalOrderRequest = zod.input<typeof RenewalOrderRequest>;
 export type RenewalOrderRequestOutput = zod.output<typeof RenewalOrderRequest>;

package/dist/membership/v1/generated/validators/renewalOrderRequest.zod.js

@@ -21,6 +21,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { TerminationPolicy } from "./terminationPolicy.zod.js";
 export const renewalOrderRequestPeriodsDefault = 1;
 export const RenewalOrderRequest = zod
     .strictObject({
@@ -34,5 +35,6 @@ export const RenewalOrderRequest = zod
         .describe("As in renewing."),
     interval_count: zod.int().min(1).optional().describe("As in renewing."),
     interval: zod.enum(["day", "month", "year"]).optional().describe("As in renewing."),
+    termination_policy: TerminationPolicy.optional().describe("As in renewing."),
 })
     .describe("The periods and price of the renewal, chosen as in renewing.");

package/dist/membership/v1/generated/validators/subscription.zod.js

@@ -59,7 +59,7 @@ export const Subscription = zod
     default_payment_method_id: zod
         .uuid()
         .nullish()
-        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, or a renewal, is paid with a saved\npayment method. It is used only while it belongs to the account that pays the renewal."),
+        .describe("The saved payment method automatic renewal charges after the account's balance and credits,\nbefore the account's default payment method. Set when the purchase, a renewal or a change is paid with a\nsaved payment method; paying any other way leaves it unchanged. It is used only while it belongs to the\naccount that pays the renewal."),
     created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod

package/package.json

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