@leaflow/sdk 0.211.0 → 0.213.1

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

@@ -8,7 +8,6 @@
 import * as zod from "zod";
 import { ActiveResourceStatus } from "./validators/activeResourceStatus.zod.js";
 import { AllowanceStatus } from "./validators/allowanceStatus.zod.js";
-import { AutoRenewSet } from "./validators/autoRenewSet.zod.js";
 import { BillingAccountCreate } from "./validators/billingAccountCreate.zod.js";
 import { BillingAccountStatus } from "./validators/billingAccountStatus.zod.js";
 import { BillingAccountUpdate } from "./validators/billingAccountUpdate.zod.js";
@@ -34,6 +33,7 @@ import { RenewRequest } from "./validators/renewRequest.zod.js";
 import { SetProjectAssignmentRequest } from "./validators/setProjectAssignmentRequest.zod.js";
 import { StatementStatus } from "./validators/statementStatus.zod.js";
 import { SubscriptionStatus } from "./validators/subscriptionStatus.zod.js";
+import { SubscriptionUpdate } from "./validators/subscriptionUpdate.zod.js";
 import { TopUpCreate } from "./validators/topUpCreate.zod.js";
 import { TopUpStatus } from "./validators/topUpStatus.zod.js";
 import { TransactionStatus } from "./validators/transactionStatus.zod.js";
@@ -861,17 +861,24 @@ export const ListUsageChargesQueryParams = zod.strictObject({
     statement_id: zod.uuid().optional(),
 });
 /**
- * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Deleted subscriptions are not listed.
+ * Subscriptions paid by your billing accounts; members of a project list its subscriptions with `project_ids`. Each subscription includes its items. Deleted subscriptions are not listed.
  * @summary List subscriptions
  */
+export const listSubscriptionsQuerySubscriptionIdsMax = 200;
 export const listSubscriptionsQueryPageDefault = 1;
 export const listSubscriptionsQueryPageMax = 2147483647;
 export const listSubscriptionsQueryPageSizeDefault = 50;
 export const listSubscriptionsQueryPageSizeMax = 200;
 export const listSubscriptionsQueryProjectIdsMax = 100;
-export const listSubscriptionsQueryStatusMax = 6;
+export const listSubscriptionsQueryStatusMax = 7;
 export const ListSubscriptionsQueryParams = zod.strictObject({
     expiring_before: zod.iso.datetime({ offset: true }).optional(),
+    subscription_ids: zod
+        .array(zod.uuid())
+        .min(1)
+        .max(listSubscriptionsQuerySubscriptionIdsMax)
+        .optional()
+        .describe("Only these subscriptions, such as those of the resources shown on one page. Comma-separated."),
     page: zod
         .int()
         .min(1)
@@ -902,30 +909,47 @@ export const ListSubscriptionsQueryParams = zod.strictObject({
         .describe("Only subscriptions in these statuses; omit for every status. Comma-separated, for example `status=active,suspended`."),
 });
 /**
- * A subscription paid by your billing account or of a project you are a member of. Deleted subscriptions are reported as not found.
+ * A subscription paid by your billing account or of a project you are a member of, with its items. Deleted subscriptions are reported as not found.
  * @summary Get subscription
  */
 export const GetSubscriptionParams = zod.strictObject({
     subscriptionId: zod.uuid(),
 });
 /**
- * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
+ * Changes the subscription's settings given in the request; settings left out keep their values. `auto_renew`
+ * turns automatic renewal on or off for the whole subscription, or, on a trialing subscription, whether the trial
+ * converts to paid. Turning it off does not shorten current_term_end and still allows manual renewal.
+ *
+ * `auto_renew` is refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning
+ * subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a subscription with only metered items, which
+ * continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id`
+ * while a cancellation of the whole subscription is open: creating it turned renewal off, and withdrawing it does
+ * not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its
+ * project with the project permission `billing:finance.manage`.
+ * @summary Update subscription
+ */
+export const UpdateSubscriptionParams = zod.strictObject({
+    subscriptionId: zod.uuid(),
+});
+export const UpdateSubscriptionBody = SubscriptionUpdate;
+/**
+ * Hides a canceled or terminated subscription from your subscription list and detail by setting deleted_at; its status, ended_at, items and history are kept. Only the owner of the subscription's current billing account can delete it. A subscription that has not ended is refused with 409 `BILLING_SUBSCRIPTION_NOT_ENDED` and `status`. Repeating it keeps the original deleted_at. It sends no cleanup command and creates no refund.
  * @summary Delete subscription
  */
 export const DeleteSubscriptionParams = zod.strictObject({
     subscriptionId: zod.uuid(),
 });
 /**
- * Requests cancellation on the purchase's agreed terms, with the same rules as creating a cancellation. Give the
- * `proration_date` and `refundable_amount` of preview-cancellation for this subscription. Open to the owner of the
- * subscription's current billing account and to members of its project with the project permission
- * `billing:finance.manage`.
+ * Requests cancellation of every continuing item of the subscription on their agreed terms, with the same rules
+ * as creating a cancellation. Give the `proration_date` and `refundable_amount` of preview-cancellation for these
+ * items. Open to the owner of the subscription's current billing account and to members of its project with the
+ * project permission `billing:finance.manage`.
  *
  * Immediate cancellation asks the owning service to release the resources now; period-end cancellation keeps the
- * subscription active or suspended until the paid term ends. The subscription becomes canceled when the service
- * confirms the release; follow the returned cancellation. Subscriptions released together must be canceled
- * together through create-cancellation, and pending or provisioning purchases through their order. Repeating the
- * request while the cancellation is open returns it.
+ * subscription in service until its current term ends. The subscription becomes canceled when the service
+ * confirms the release; follow the returned cancellation. To cancel some items, or items released together across
+ * subscriptions, use create-cancellation; pending or provisioning purchases are canceled through their order.
+ * Repeating the request while the cancellation is open returns it.
  * @summary Cancel subscription
  */
 export const CancelSubscriptionParams = zod.strictObject({
@@ -933,7 +957,7 @@ export const CancelSubscriptionParams = zod.strictObject({
 });
 export const CancelSubscriptionBody = CancelSubscriptionRequest;
 /**
- * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_id` and `status=open` to find a subscription's cancellation in progress.
+ * Newest first; members of a project list its cancellations with `project_ids`. Filter by `subscription_item_id` and `status=open` to find an item's cancellation in progress, or by `subscription_id` for every item of a subscription.
  * @summary List cancellations
  */
 export const listCancellationsQueryPageDefault = 1;
@@ -962,7 +986,11 @@ export const ListCancellationsQueryParams = zod.strictObject({
     subscription_id: zod
         .uuid()
         .optional()
-        .describe("Only cancellations that include this subscription."),
+        .describe("Only cancellations that include an item of this subscription."),
+    subscription_item_id: zod
+        .uuid()
+        .optional()
+        .describe("Only cancellations that include this subscription item."),
     status: zod
         .array(zod.enum(["open", "requested", "scheduled", "releasing", "completed", "canceled", "failed"]))
         .min(1)
@@ -977,88 +1005,93 @@ export const ListCancellationsQueryParams = zod.strictObject({
         .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * Ends subscriptions of one service together. Deleting a resource is an `immediate` cancellation of every
- * subscription released with it, such as a server with its disks or an address with its bandwidth. Open to the
- * owner of the subscriptions' current billing account and to members of their project with the project
- * permission `billing:finance.manage`.
+ * Ends subscription items of one service together, from one subscription or several. Deleting a resource is an
+ * `immediate` cancellation of every item released with it, such as a server with its disks or an address with
+ * its bandwidth. Open to the owner of the items' current billing account and to members of their project with
+ * the project permission `billing:finance.manage`.
  *
- * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the paid
- * term, for `period_end`. When release is confirmed, the unused value is returned to the original payment
- * sources under each subscription's refund terms. For `immediate` the refund is computed as of `proration_date`
- * and is not reduced by service used during release. Metered usage is charged until release.
+ * The owning service releases the resources at once for `immediate`, or at `scheduled_at`, the end of the
+ * subscription's current term, for `period_end`; until then the items are left out of renewals. When release is
+ * confirmed, the unused value is returned to the original payment sources under each item's refund terms. For
+ * `immediate` the refund is computed as of `proration_date` and is not reduced by service used during release.
+ * Metered usage is charged until release. A subscription whose continuing items all end is canceled.
  *
- * `mode` must be allowed for every subscription. Metered and one-time subscriptions end only `immediate`. A
- * licensed subscription ends `period_end` while its paid term lasts, and `immediate` unless its terms allow only
- * the end of the paid term and that term has not ended. For `period_end` all paid terms must end at the same
+ * `mode` must be allowed for every item. Metered and one-time items end only `immediate`. A licensed item ends
+ * `period_end` while its subscription's paid term lasts, and `immediate` unless its terms allow only the end of
+ * the paid term and that term has not ended. For `period_end` the paid terms of all items must end at the same
  * time.
  *
  * Refused with:
  *
- * - 400 `BILLING_CANCELLATION_INVALID` when `subscription_ids` or `proration_date` is invalid (`meta.field`), or
- *   the subscriptions do not share one service, project, account and currency;
- * - 409 `BILLING_CANCELLATION_CONFLICT` when a subscription has not started or has ended;
+ * - 400 `BILLING_CANCELLATION_INVALID` when `items` or `proration_date` is invalid (`meta.field`), or the items
+ *   do not share one service, project, account and currency;
+ * - 409 `BILLING_CANCELLATION_CONFLICT` when an item has not started or has ended;
  * - 422 `BILLING_CANCELLATION_MODE_FIXED` when `mode` is not allowed, and `BILLING_CANCELLATION_TERMS_UNSET`
- *   when a licensed subscription has no cancellation terms, both with `meta.subscription_id`;
+ *   when a licensed item has no cancellation terms, both with `meta.subscription_item_id`;
  * - 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.reason` `reclaim_requested`), or has a paid change waiting to
- *   switch (`meta.order_id`);
- * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online renewal payment for one of them is in progress;
+ * - 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` when an item is already being canceled
+ *   (`meta.cancellation_id`), its subscription is being reclaimed (`meta.reason` `reclaim_requested`), or the
+ *   item has a paid change waiting to switch (`meta.order_id`);
+ * - 409 `BILLING_ORDER_PAYMENT_IN_FLIGHT` while an online renewal payment for one of their subscriptions is in
+ *   progress;
  * - 409 `BILLING_CANCELLATION_REFUND_CHANGED` when the refund no longer equals `expected_refundable_amount`.
  *
- * Repeating the request for the same subscriptions, mode and amount while the cancellation is open returns it
- * with 200. Unpaid renewal orders are canceled with it, and automatic renewal is turned off for every
- * subscription.
- * @summary Cancel subscriptions
+ * Repeating the request for the same items, mode and amount while the cancellation is open returns it with 200.
+ * When it covers every continuing item of a subscription, unpaid renewal orders of that subscription are
+ * canceled with it and its automatic renewal is turned off.
+ * @summary Cancel subscription items
  */
 export const CreateCancellationBody = CancellationCreate;
 /**
- * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each subscription, including partial success.
+ * A cancellation paid by your billing account or of a project you are a member of, with its schedule, expected refundable amount and the outcome for each item, including partial success.
  * @summary Get a cancellation
  */
 export const GetCancellationParams = zod.strictObject({
     cancellationId: zod.uuid(),
 });
 /**
- * Withdraws the whole cancellation, which stays with status `canceled`, while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The subscriptions continue, but automatic renewal, turned off when the cancellation was created, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the subscriptions' current billing account and to members of their project with the project permission `billing:finance.manage`.
+ * Withdraws the whole cancellation, which stays with status `canceled`, while no resource has begun to be released; afterwards it is refused with 409 `BILLING_CANCELLATION_CONFLICT`. The items continue and renew with their subscriptions again; a subscription's automatic renewal, turned off when the cancellation covered all of its continuing items, stays off until it is turned on again. Withdrawing a withdrawn cancellation returns it unchanged. Open to the owner of the items' current billing account and to members of their project with the project permission `billing:finance.manage`.
  * @summary Withdraw a cancellation
  */
-export const WithdrawCancellationParams = zod.strictObject({
+export const DeleteCancellationParams = zod.strictObject({
     cancellationId: zod.uuid(),
 });
 /**
- * Lists the current renewal agreement and available intervals. The current option preserves recurring_amount; other options use current prices. Amounts cover the whole subscription quantity and exclude tax. Open to the owner of the subscription's current billing account and to members of its project.
- * @summary List the terms this item can be renewed for
+ * The current agreement first, then each other term every continuing licensed item sells in the subscription's currency. The current option keeps each item's recurring_amount; other options use current prices, each item taking the price of that term with its own cancellation policy, or the only price of that term. Amounts exclude tax and discounts. Open to the owner of the subscription's current billing account and to members of its project.
+ * @summary List the terms the subscription can be renewed for
  */
-export const ListRenewalPricesParams = zod.strictObject({
+export const ListRenewalOptionsParams = zod.strictObject({
     subscriptionId: zod.uuid(),
 });
-export const listRenewalPricesQueryPageDefault = 1;
-export const listRenewalPricesQueryPageMax = 2147483647;
-export const listRenewalPricesQueryPageSizeDefault = 50;
-export const listRenewalPricesQueryPageSizeMax = 200;
-export const ListRenewalPricesQueryParams = zod.strictObject({
+export const listRenewalOptionsQueryPageDefault = 1;
+export const listRenewalOptionsQueryPageMax = 2147483647;
+export const listRenewalOptionsQueryPageSizeDefault = 50;
+export const listRenewalOptionsQueryPageSizeMax = 200;
+export const ListRenewalOptionsQueryParams = zod.strictObject({
     page: zod
         .int()
         .min(1)
-        .max(listRenewalPricesQueryPageMax)
-        .default(listRenewalPricesQueryPageDefault)
+        .max(listRenewalOptionsQueryPageMax)
+        .default(listRenewalOptionsQueryPageDefault)
         .describe("1-based page number. Defaults to 1."),
     page_size: zod
         .int()
         .min(1)
-        .max(listRenewalPricesQueryPageSizeMax)
-        .default(listRenewalPricesQueryPageSizeDefault)
+        .max(listRenewalOptionsQueryPageSizeMax)
+        .default(listRenewalOptionsQueryPageSizeDefault)
         .describe("Items per page. Defaults to 50; at most 200."),
 });
 /**
- * Buys licensed periods from current_term_end at the agreed recurring amount and pays for them at once. A
- * different interval selects the price currently sold for it and fixes new terms on the order, applied after
- * fulfillment. Paid periods keep their value.
+ * Buys further periods for the whole subscription from current_term_end and pays for them at once: every
+ * continuing licensed item renews, at its agreed recurring amount or, with a different interval, at the price each
+ * item currently sells that term for, and the new terms are fixed on the order. Items with an open cancellation end
+ * with the current term and are left out. Paid periods keep their value. A trialing subscription converts to paid
+ * this way; renewed after its trial expired, its first paid period starts at payment.
  *
  * Without `payment_method_id`, the renewal is paid from credit grants and balance as `use_credits` and
  * `use_balance` allow; when they cannot cover it, the request fails with `BILLING_INSUFFICIENT_FUNDS` and no
- * order is left. To apply a promotion code or pay later, create a renewal Checkout Session.
+ * order is left. To apply a promotion code, pay later, or renew several subscriptions in one order, create a
+ * renewal Checkout Session.
  *
  * Open to the owner of the subscription's current billing account and to members of its project with the
  * project permission `billing:finance.manage`. Only the owner can pay with `payment_method_id`.
@@ -1070,14 +1103,6 @@ export const RenewSubscriptionParams = zod.strictObject({
     subscriptionId: zod.uuid(),
 });
 export const RenewSubscriptionBody = RenewRequest;
-/**
- * Turns automatic renewal of an active or suspended licensed subscription on or off. Turning it off does not shorten current_term_end and still allows manual renewal. Refused with 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_INACTIVE` for a pending or provisioning subscription, 409 `BILLING_SUBSCRIPTION_AUTO_RENEW_FIXED` for a metered subscription, which continues until it is canceled, and 409 `BILLING_SUBSCRIPTION_OPERATION_PENDING` with `meta.cancellation_id` while a cancellation is open: creating it turned renewal off, and withdrawing it does not turn renewal back on. Open to the owner of the subscription's current billing account and to members of its project with the project permission `billing:finance.manage`.
- * @summary Set auto renew
- */
-export const SetAutoRenewParams = zod.strictObject({
-    subscriptionId: zod.uuid(),
-});
-export const SetAutoRenewBody = AutoRenewSet;
 /**
  * Remaining usage quantities, such as bytes, seconds or tokens; members of a project list its allowances with `project_ids`. Applicable allowances are consumed before usage is charged: lower priority values first, then earlier expiry, then earlier issuance. Unused quantity expires without refund or carry-over. Promotional allowances apply to usage paid by their holding account; included allowances apply only to their subscription, also after its project moves to another billing account.
  * @summary List allowances
@@ -1169,13 +1194,14 @@ export const ListCheckoutSessionsQueryParams = zod.strictObject({
         .describe("Only records of these projects. Omit for all projects and account-level records of your billing accounts. Where an operation is open to project members, each project must be assigned to a billing account you own or have you as a member, and a member sees the records of the project that the owner of its current billing account sees."),
 });
 /**
- * Opens a Checkout Session renewing a licensed subscription, with periods and price chosen as in
- * renewing. Nothing is charged until you complete it, when a promotion code can be applied; it then renews from
- * the subscription's current_term_end at that time. To renew at once from credit grants, balance or a payment
- * method, renew the subscription instead. Purchases and changes of a service's resources are created through
- * that service.
+ * Opens a Checkout Session renewing one or more subscriptions in one order, such as a machine and the separately
+ * bought volumes and elastic IPs attached to it, with periods and price chosen as in renewing. Every subscription
+ * must be paid by the same billing account and belong to the same project and service. Nothing is charged until
+ * you complete it, when a promotion code can be applied; each subscription then renews from its current_term_end
+ * at that time. To renew one subscription at once from credit grants, balance or a payment method, renew the
+ * subscription instead. Purchases and changes of a service's resources are created through that service.
  *
- * Open to the owner of the subscription's current billing account and to members of its project with the
+ * Open to the owner of the subscriptions' current billing account and to members of their project with the
  * project permission `billing:finance.manage`. Keep `checkout_session_id` and read the session after an
  * unknown outcome; creating it again conflicts.
  * @summary Create a renewal Checkout Session
@@ -1334,7 +1360,7 @@ export const PreviewOrderRefundQueryParams = zod.strictObject({
  * payment waiting for the payer is canceled with the order; one the gateway is processing is refused with
  * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`. Repeating the cancellation does not refund twice.
  *
- * An accepted order is canceled by its owning service, and delivered items through subscription cancellation.
+ * An accepted order is canceled by its owning service, and delivered items through cancellation of their subscription items.
  * Refunds are previewed with `preview-order-refund`. Open to the owner of the order's billing account and to members of its project.
  * @summary Cancel order
  */

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

@@ -11,6 +11,7 @@ export declare const ActiveResource: zod.ZodObject<{
     ended_at: zod.ZodOptional<zod.z.ZodISODateTime>;
     suspended_at: zod.ZodOptional<zod.z.ZodISODateTime>;
     state_changed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    subscription_item_id: zod.ZodUUID;
     subscription_id: zod.ZodUUID;
     resource_id: zod.ZodString;
     product: zod.ZodObject<{

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

@@ -15,9 +15,10 @@ export const ActiveResource = zod
     ended_at: zod.iso.datetime({ offset: true }).optional(),
     suspended_at: zod.iso.datetime({ offset: true }).optional(),
     state_changed_at: zod.iso.datetime({ offset: true }).optional(),
-    subscription_id: zod
+    subscription_item_id: zod
         .uuid()
-        .describe("The metered subscription charged for this metering record."),
+        .describe("The metered subscription item charged for this metering record."),
+    subscription_id: zod.uuid().describe("The subscription the item belongs to."),
     resource_id: zod.string(),
     product: Product,
     resource_type: zod

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

@@ -12,6 +12,7 @@ export declare const ActiveResourceList: zod.ZodObject<{
         ended_at: zod.ZodOptional<zod.z.ZodISODateTime>;
         suspended_at: zod.ZodOptional<zod.z.ZodISODateTime>;
         state_changed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        subscription_item_id: zod.ZodUUID;
         subscription_id: zod.ZodUUID;
         resource_id: zod.ZodString;
         product: zod.ZodObject<{

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

@@ -8,6 +8,7 @@
 import * as zod from "zod";
 export declare const Allowance: zod.ZodObject<{
     idempotency_key: zod.ZodOptional<zod.ZodString>;
+    subscription_item_id: zod.ZodOptional<zod.ZodUUID>;
     subscription_id: zod.ZodOptional<zod.ZodUUID>;
     id: zod.ZodUUID;
     billing_account_id: zod.ZodOptional<zod.ZodInt>;

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

@@ -14,7 +14,11 @@ export const Allowance = zod.strictObject({
         .string()
         .optional()
         .describe("Optional issuance key, unique within this billing account."),
-    subscription_id: zod.uuid().optional(),
+    subscription_item_id: zod
+        .uuid()
+        .optional()
+        .describe("The subscription item whose purchase includes the allowance; absent for an allowance not included in a purchase."),
+    subscription_id: zod.uuid().optional().describe("The subscription that item belongs to."),
     id: zod.uuid(),
     billing_account_id: zod.int().optional(),
     product: Product,

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

@@ -9,6 +9,7 @@ import * as zod from "zod";
 export declare const AllowanceList: zod.ZodObject<{
     items: zod.ZodArray<zod.ZodObject<{
         idempotency_key: zod.ZodOptional<zod.ZodString>;
+        subscription_item_id: zod.ZodOptional<zod.ZodUUID>;
         subscription_id: zod.ZodOptional<zod.ZodUUID>;
         id: zod.ZodUUID;
         billing_account_id: zod.ZodOptional<zod.ZodInt>;

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

@@ -36,6 +36,7 @@ export declare const Cancellation: zod.ZodObject<{
     canceled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
     items: zod.ZodArray<zod.ZodObject<{
         id: zod.ZodUUID;
+        subscription_item_id: zod.ZodUUID;
         subscription_id: zod.ZodUUID;
         plan_id: zod.ZodUUID;
         plan_name: zod.ZodString;

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

@@ -24,7 +24,7 @@ export const Cancellation = zod
         .describe("Who requested it; `project_deletion` means the project was deleted."),
     billing_account_id: zod
         .int()
-        .describe("The billing account paying for these subscriptions when the cancellation was created: the purchasing account of an account-level purchase, or the project's linked account."),
+        .describe("The billing account paying for these items when the cancellation was created: the purchasing account of an account-level purchase, or the project's linked account."),
     currency: zod.string(),
     expected_refundable_amount: Money.optional().describe("The refund confirmed when the cancellation was created. Absent when the platform created it."),
     failure_code: zod
@@ -36,4 +36,4 @@ export const Cancellation = zod
     canceled_at: zod.iso.datetime({ offset: true }).optional(),
     items: zod.array(CancellationItem),
 })
-    .describe("One cancellation of a set of subscriptions of one service, released together at one time.\n\n- `requested`: `immediate`, release has not begun.\n- `scheduled`: `period_end`, waiting for `scheduled_at`.\n- `releasing`: release has begun; it can no longer be withdrawn.\n- `completed`: every subscription has ended and its refund has been made.\n- `canceled`: withdrawn before release began; the subscriptions continue.\n- `failed`: the service could not carry it out, for the reason in `failure_code`; the\n  subscriptions continue and can be canceled again.");
+    .describe("One cancellation of a set of subscription items of one service, released together at one time.\n\n- `requested`: `immediate`, release has not begun.\n- `scheduled`: `period_end`, waiting for `scheduled_at`.\n- `releasing`: release has begun; it can no longer be withdrawn.\n- `completed`: every item has ended and its refund has been made.\n- `canceled`: withdrawn before release began; the items continue.\n- `failed`: the service could not carry it out, for the reason in `failure_code`; the\n  items continue and can be canceled again.");

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

@@ -6,11 +6,13 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const cancellationCreateSubscriptionIdsMax = 50;
+export declare const cancellationCreateItemsMax = 50;
 export declare const cancellationCreateExpectedRefundableAmountTwoRegExp: RegExp;
 export declare const cancellationCreateReasonMax = 1024;
 export declare const CancellationCreate: zod.ZodObject<{
-    subscription_ids: zod.ZodArray<zod.ZodUUID>;
+    items: zod.ZodArray<zod.ZodObject<{
+        subscription_item_id: zod.ZodUUID;
+    }, zod.z.core.$strict>>;
     mode: zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";

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

@@ -6,16 +6,17 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
+import { CancellationItemInput } from "./cancellationItemInput.zod.js";
 import { CancellationMode } from "./cancellationMode.zod.js";
 import { Money } from "./money.zod.js";
-export const cancellationCreateSubscriptionIdsMax = 50;
+export const cancellationCreateItemsMax = 50;
 export const cancellationCreateExpectedRefundableAmountTwoRegExp = new RegExp("^[0-9]{1,15}([.][0-9]{1,10})?$");
 export const cancellationCreateReasonMax = 1024;
 export const CancellationCreate = zod.strictObject({
-    subscription_ids: zod
-        .array(zod.uuid())
+    items: zod
+        .array(CancellationItemInput)
         .min(1)
-        .max(cancellationCreateSubscriptionIdsMax)
+        .max(cancellationCreateItemsMax)
         .describe("As in the preview."),
     mode: CancellationMode,
     proration_date: zod.iso

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

@@ -8,6 +8,7 @@
 import * as zod from "zod";
 export declare const CancellationItem: zod.ZodObject<{
     id: zod.ZodUUID;
+    subscription_item_id: zod.ZodUUID;
     subscription_id: zod.ZodUUID;
     plan_id: zod.ZodUUID;
     plan_name: zod.ZodString;

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

@@ -13,12 +13,13 @@ export const CancellationItem = zod
     .strictObject({
     id: zod
         .uuid()
-        .describe("The subscription's cancellation item, the same as `Subscription.cancellation.id`."),
-    subscription_id: zod.uuid(),
+        .describe("The item's entry in the cancellation, the same as `SubscriptionItem.cancellation.id`."),
+    subscription_item_id: zod.uuid(),
+    subscription_id: zod.uuid().describe("The subscription the item belongs to."),
     plan_id: zod.uuid(),
     plan_name: zod.string(),
     type: PriceType,
-    usage_type: UsageType.describe("Creating the cancellation turned automatic renewal off; withdrawing it turns renewal back on\nfor a `metered` subscription and leaves it off for a `licensed` one."),
+    usage_type: UsageType.describe("When the cancellation covers every continuing item of a subscription, creating it turned the\nsubscription's automatic renewal off; withdrawing it turns renewal back on for a subscription with\nonly `metered` items and leaves it off for one with `licensed` items."),
     status: zod.enum(["requested", "scheduled", "releasing", "completed", "canceled", "failed"]),
     failure_code: zod
         .string()
@@ -33,4 +34,4 @@ export const CancellationItem = zod
     credit_amount: Money.optional().describe("Present with `completed`. The part restored to the credit grants that paid."),
     gateway_amount: Money.optional().describe("Present with `completed`. The part returned to the payment method it was paid with."),
 })
-    .describe("One subscription of the cancellation.");
+    .describe("One subscription item of the cancellation.");

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

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * 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 and renewals, preview 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 * as zod from "zod";
+export declare const CancellationItemInput: zod.ZodObject<{
+    subscription_item_id: zod.ZodUUID;
+}, zod.z.core.$strict>;
+export type CancellationItemInput = zod.input<typeof CancellationItemInput>;
+export type CancellationItemInputOutput = zod.output<typeof CancellationItemInput>;

package/dist/billing/v1/generated/validators/{autoRenewSet.zod.d.ts → cancellationItemInput.zod.js}

@@ -6,8 +6,8 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const AutoRenewSet: zod.ZodObject<{
-    auto_renew: zod.ZodBoolean;
-}, zod.z.core.$strict>;
-export type AutoRenewSet = zod.input<typeof AutoRenewSet>;
-export type AutoRenewSetOutput = zod.output<typeof AutoRenewSet>;
+export const CancellationItemInput = zod
+    .strictObject({
+    subscription_item_id: zod.uuid(),
+})
+    .describe("One subscription item to end, each at most once.");

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

@@ -37,6 +37,7 @@ export declare const CancellationList: zod.ZodObject<{
         canceled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
         items: zod.ZodArray<zod.ZodObject<{
             id: zod.ZodUUID;
+            subscription_item_id: zod.ZodUUID;
             subscription_id: zod.ZodUUID;
             plan_id: zod.ZodUUID;
             plan_name: zod.ZodString;

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

@@ -22,6 +22,7 @@ export declare const CancellationPreview: zod.ZodObject<{
     tax_amount: zod.ZodString;
     forfeited_amount: zod.ZodString;
     items: zod.ZodArray<zod.ZodObject<{
+        subscription_item_id: zod.ZodUUID;
         subscription_id: zod.ZodUUID;
         plan_id: zod.ZodUUID;
         plan_name: zod.ZodString;

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

@@ -15,7 +15,7 @@ export const CancellationPreview = zod
     scheduled_at: zod.iso
         .datetime({ offset: true })
         .optional()
-        .describe("For `period_end`, when release begins, the end of the paid terms."),
+        .describe("For `period_end`, when release begins, the end of the subscriptions' current terms."),
     proration_date: zod.iso
         .datetime({ offset: true })
         .optional()
@@ -30,4 +30,4 @@ export const CancellationPreview = zod
     forfeited_amount: Money,
     items: zod.array(CancellationPreviewItem),
 })
-    .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 item 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 items show zero; their usage until release is charged as usual.");

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 export declare const CancellationPreviewItem: zod.ZodObject<{
+    subscription_item_id: zod.ZodUUID;
     subscription_id: zod.ZodUUID;
     plan_id: zod.ZodUUID;
     plan_name: zod.ZodString;

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

@@ -12,7 +12,8 @@ import { PriceType } from "./priceType.zod.js";
 import { UsageType } from "./usageType.zod.js";
 export const CancellationPreviewItem = zod
     .strictObject({
-    subscription_id: zod.uuid(),
+    subscription_item_id: zod.uuid(),
+    subscription_id: zod.uuid().describe("The subscription the item belongs to."),
     plan_id: zod.uuid(),
     plan_name: zod.string(),
     project: zod
@@ -23,7 +24,7 @@ export const CancellationPreviewItem = zod
     usage_type: UsageType,
     auto_renew: zod
         .boolean()
-        .describe("Whether automatic renewal is on now. Creating the cancellation turns it off; withdrawing it turns it back on for a metered subscription but not for a licensed one."),
+        .describe("Whether the item's subscription renews automatically now. Creating a cancellation of every continuing item of the subscription turns it off; withdrawing it turns it back on for a subscription with only metered items but not for one with licensed items."),
     unused_amount: Money,
     short_rate_surcharge_amount: Money,
     refundable_amount: Money,
@@ -32,4 +33,4 @@ export const CancellationPreviewItem = zod
     tax_amount: Money,
     forfeited_amount: Money,
 })
-    .describe("One subscription of the previewed cancellation.");
+    .describe("One subscription item of the previewed cancellation.");

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

@@ -6,10 +6,12 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const cancellationPreviewRequestSubscriptionIdsMax = 50;
+export declare const cancellationPreviewRequestItemsMax = 50;
 export declare const CancellationPreviewRequest: zod.ZodObject<{
     billing_account_id: zod.ZodInt;
-    subscription_ids: zod.ZodArray<zod.ZodUUID>;
+    items: zod.ZodArray<zod.ZodObject<{
+        subscription_item_id: zod.ZodUUID;
+    }, zod.z.core.$strict>>;
     mode: zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";