@leaflow/sdk 0.211.0 → 0.213.1

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

@@ -0,0 +1,22 @@
+/**
+ * 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";
+import { Money } from "./money.zod.js";
+import { RenewalOptionItem } from "./renewalOptionItem.zod.js";
+export const RenewalOption = zod
+    .strictObject({
+    interval: zod.enum(["day", "month", "year"]),
+    interval_count: zod.int().describe("How many intervals one renewal covers."),
+    current: zod
+        .boolean()
+        .describe("The term the subscription renews at now; renewing for it keeps every item's agreed price."),
+    amount: Money.describe("One period for every item, before tax and discounts."),
+    currency: zod.string(),
+    items: zod.array(RenewalOptionItem),
+})
+    .describe("One term the whole subscription can renew for. Every continuing licensed item renews at it; items with an open cancellation end with the current term and are left out.");

package/dist/billing/v1/generated/validators/{renewalPrice.zod.d.ts → renewalOptionItem.zod.d.ts}

@@ -6,7 +6,10 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const RenewalPrice: zod.ZodObject<{
+export declare const RenewalOptionItem: zod.ZodObject<{
+    subscription_item_id: zod.ZodUUID;
+    price_id: zod.ZodNullable<zod.ZodUUID>;
+    amount: zod.ZodString;
     cancellation_policy: zod.ZodOptional<zod.ZodEnum<{
         immediate: "immediate";
         period_end: "period_end";
@@ -18,16 +21,6 @@ export declare const RenewalPrice: zod.ZodObject<{
     }>>;
     short_rate_multiplier: zod.ZodOptional<zod.ZodString>;
     short_rate_threshold_seconds: zod.ZodOptional<zod.ZodInt>;
-    price_id: zod.ZodUUID;
-    interval_count: zod.ZodInt;
-    interval: zod.ZodEnum<{
-        day: "day";
-        month: "month";
-        year: "year";
-    }>;
-    amount: zod.ZodOptional<zod.ZodString>;
-    currency: zod.ZodOptional<zod.ZodString>;
-    current: zod.ZodBoolean;
 }, zod.z.core.$strict>;
-export type RenewalPrice = zod.input<typeof RenewalPrice>;
-export type RenewalPriceOutput = zod.output<typeof RenewalPrice>;
+export type RenewalOptionItem = zod.input<typeof RenewalOptionItem>;
+export type RenewalOptionItemOutput = zod.output<typeof RenewalOptionItem>;

package/dist/billing/v1/generated/validators/{renewalPrice.zod.js → renewalOptionItem.zod.js}

@@ -9,17 +9,17 @@ import * as zod from "zod";
 import { CancellationPolicy } from "./cancellationPolicy.zod.js";
 import { Money } from "./money.zod.js";
 import { RefundPolicy } from "./refundPolicy.zod.js";
-export const RenewalPrice = zod.strictObject({
+export const RenewalOptionItem = zod
+    .strictObject({
+    subscription_item_id: zod.uuid(),
+    price_id: zod
+        .uuid()
+        .nullable()
+        .describe("The price the item renews at; null on the current option, which keeps the agreed amount."),
+    amount: Money.describe("One period of this item, before tax and discounts."),
     cancellation_policy: CancellationPolicy.optional(),
     refund_policy: RefundPolicy.optional(),
     short_rate_multiplier: zod.string().optional().describe("Refund policy `short_rate` only."),
     short_rate_threshold_seconds: zod.int().optional().describe("Refund policy `short_rate` only."),
-    price_id: zod.uuid(),
-    interval_count: zod.int().describe("How many periods one renewal covers."),
-    interval: zod.enum(["day", "month", "year"]),
-    amount: Money.optional().describe("What renewing for this term costs, for the quantity held."),
-    currency: zod.string().optional(),
-    current: zod
-        .boolean()
-        .describe("The term the subscription renews at now; renewing for it keeps the agreed price."),
-});
+})
+    .describe("What one item renews at under a renewal option.");

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

@@ -0,0 +1,44 @@
+/**
+ * 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 RenewalOptionList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        interval: zod.ZodEnum<{
+            day: "day";
+            month: "month";
+            year: "year";
+        }>;
+        interval_count: zod.ZodInt;
+        current: zod.ZodBoolean;
+        amount: zod.ZodString;
+        currency: zod.ZodString;
+        items: zod.ZodArray<zod.ZodObject<{
+            subscription_item_id: zod.ZodUUID;
+            price_id: zod.ZodNullable<zod.ZodUUID>;
+            amount: zod.ZodString;
+            cancellation_policy: zod.ZodOptional<zod.ZodEnum<{
+                immediate: "immediate";
+                period_end: "period_end";
+            }>>;
+            refund_policy: zod.ZodOptional<zod.ZodEnum<{
+                none: "none";
+                prorated: "prorated";
+                short_rate: "short_rate";
+            }>>;
+            short_rate_multiplier: zod.ZodOptional<zod.ZodString>;
+            short_rate_threshold_seconds: zod.ZodOptional<zod.ZodInt>;
+        }, zod.z.core.$strict>>;
+    }, zod.z.core.$strict>>;
+    pagination: zod.ZodObject<{
+        page: zod.ZodInt;
+        page_size: zod.ZodInt;
+        total_count: zod.ZodOptional<zod.ZodInt>;
+    }, zod.z.core.$strict>;
+}, zod.z.core.$strict>;
+export type RenewalOptionList = zod.input<typeof RenewalOptionList>;
+export type RenewalOptionListOutput = zod.output<typeof RenewalOptionList>;

package/dist/billing/v1/generated/validators/{renewalPriceList.zod.js → renewalOptionList.zod.js}

@@ -7,8 +7,8 @@
  */
 import * as zod from "zod";
 import { OffsetPagination } from "./offsetPagination.zod.js";
-import { RenewalPrice } from "./renewalPrice.zod.js";
-export const RenewalPriceList = zod.strictObject({
-    items: zod.array(RenewalPrice),
+import { RenewalOption } from "./renewalOption.zod.js";
+export const RenewalOptionList = zod.strictObject({
+    items: zod.array(RenewalOption),
     pagination: OffsetPagination,
 });

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

@@ -23,4 +23,4 @@ export const ScheduledChange = zod
     interval: zod.enum(["day", "month", "year"]),
     interval_count: zod.int().min(1),
 })
-    .describe("The next accepted period-end change of the subscription: the target terms, applied at effective_at.");
+    .describe("The next accepted period-end change of the item: the target terms, applied at effective_at.");

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

@@ -6,19 +6,35 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
-export declare const subscriptionDiscountedRenewalsRemainingMin = 0;
 export declare const Subscription: zod.ZodObject<{
-    renewal_discounts_enabled: zod.ZodOptional<zod.ZodBoolean>;
+    id: zod.ZodUUID;
+    billing_account_id: zod.ZodInt;
+    account: zod.ZodObject<{
+        id: zod.ZodInt;
+        name: zod.ZodString;
+        currency: zod.ZodString;
+    }, zod.z.core.$strict>;
+    product_id: zod.ZodString;
+    product: zod.ZodObject<{
+        id: zod.ZodString;
+        name: zod.ZodString;
+        description: zod.ZodOptional<zod.ZodString>;
+    }, zod.z.core.$strict>;
+    project_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    project: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        id: zod.ZodUUID;
+        name: zod.ZodString;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     currency: zod.ZodString;
-    type: zod.ZodEnum<{
-        one_time: "one_time";
-        recurring: "recurring";
-    }>;
-    usage_type: zod.ZodEnum<{
-        licensed: "licensed";
-        metered: "metered";
+    status: zod.ZodEnum<{
+        active: "active";
+        pending: "pending";
+        suspended: "suspended";
+        canceled: "canceled";
+        provisioning: "provisioning";
+        trialing: "trialing";
+        terminated: "terminated";
     }>;
-    dimensions: zod.ZodRecord<zod.ZodString, zod.ZodString>;
     interval: zod.ZodEnum<{
         none: "none";
         day: "day";
@@ -26,27 +42,23 @@ export declare const Subscription: zod.ZodObject<{
         year: "year";
     }>;
     interval_count: zod.ZodOptional<zod.ZodInt>;
-    recurring_amount: zod.ZodOptional<zod.ZodString>;
-    cancellation_policy: zod.ZodOptional<zod.ZodEnum<{
-        immediate: "immediate";
-        period_end: "period_end";
-    }>>;
-    refund_policy: zod.ZodOptional<zod.ZodEnum<{
-        none: "none";
-        prorated: "prorated";
-        short_rate: "short_rate";
-    }>>;
-    short_rate_multiplier: zod.ZodOptional<zod.ZodString>;
-    short_rate_threshold_seconds: zod.ZodOptional<zod.ZodInt>;
-    monthly_list_amount: zod.ZodOptional<zod.ZodString>;
-    order_item_id: zod.ZodOptional<zod.ZodUUID>;
-    coupon_id: zod.ZodOptional<zod.ZodUUID>;
-    coupon: zod.ZodOptional<zod.ZodObject<{
-        lookup_key: zod.ZodOptional<zod.ZodString>;
-        id: zod.ZodUUID;
-        name: zod.ZodString;
-    }, zod.z.core.$strict>>;
-    discounted_renewals_remaining: zod.ZodOptional<zod.ZodInt>;
+    current_term_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    current_period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    current_period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    billing_cycle_anchor: zod.ZodOptional<zod.z.ZodISODateTime>;
+    auto_renew: zod.ZodBoolean;
+    trial_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    trial_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    trial_settings: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        end_behavior: zod.ZodObject<{
+            missing_payment_method: zod.ZodEnum<{
+                cancel: "cancel";
+                pause: "pause";
+                create_invoice: "create_invoice";
+            }>;
+            retention_seconds: zod.ZodNullable<zod.ZodInt>;
+        }, zod.z.core.$strict>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     restrictions: zod.ZodOptional<zod.ZodArray<zod.ZodEnum<{
         "billing.subscriptions.use": "billing.subscriptions.use";
         "billing.subscriptions.renew": "billing.subscriptions.renew";
@@ -54,94 +66,101 @@ export declare const Subscription: zod.ZodObject<{
         "billing.subscriptions.cancel": "billing.subscriptions.cancel";
         "billing.subscriptions.terminate": "billing.subscriptions.terminate";
     }>>>;
-    billing_cycle_anchor: zod.ZodOptional<zod.z.ZodISODateTime>;
-    cancellation: zod.ZodOptional<zod.ZodObject<{
-        reason: zod.ZodOptional<zod.ZodString>;
-        cancellation_id: zod.ZodOptional<zod.ZodUUID>;
+    default_payment_method_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    items: zod.ZodArray<zod.ZodObject<{
         id: zod.ZodUUID;
         subscription_id: zod.ZodUUID;
-        status: zod.ZodEnum<{
-            scheduled: "scheduled";
-            completed: "completed";
-            failed: "failed";
-            requested: "requested";
-            releasing: "releasing";
-            canceled: "canceled";
-        }>;
-        mode: zod.ZodEnum<{
-            immediate: "immediate";
-            period_end: "period_end";
-        }>;
-        requested_at: zod.z.ZodISODateTime;
-        scheduled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-        effective_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-        completed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-        release_started_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-        canceled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-        forfeit_remaining_value: zod.ZodBoolean;
-        failure_code: zod.ZodOptional<zod.ZodString>;
-        failure_reason: zod.ZodOptional<zod.ZodString>;
-    }, zod.z.core.$strict>>;
-    scheduled_change: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
-        order_id: zod.ZodUUID;
-        status: zod.ZodEnum<{
-            completed: "completed";
-            failed: "failed";
-            pending: "pending";
-            canceled: "canceled";
-            accepted: "accepted";
-            partially_completed: "partially_completed";
-        }>;
-        effective_at: zod.z.ZodISODateTime;
         plan_id: zod.ZodUUID;
         plan_name: zod.ZodString;
         price_id: zod.ZodUUID;
-        quantity: zod.ZodString;
-        recurring_amount: zod.ZodString;
-        currency: zod.ZodString;
-        interval: zod.ZodEnum<{
-            day: "day";
-            month: "month";
-            year: "year";
+        type: zod.ZodEnum<{
+            one_time: "one_time";
+            recurring: "recurring";
         }>;
-        interval_count: zod.ZodInt;
-    }, zod.z.core.$strict>, zod.ZodNull]>>;
-    default_payment_method_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+        usage_type: zod.ZodEnum<{
+            licensed: "licensed";
+            metered: "metered";
+        }>;
+        dimensions: zod.ZodRecord<zod.ZodString, zod.ZodString>;
+        quantity: zod.ZodString;
+        recurring_amount: zod.ZodOptional<zod.ZodString>;
+        renewal_discounts_enabled: zod.ZodOptional<zod.ZodBoolean>;
+        cancellation_policy: zod.ZodOptional<zod.ZodEnum<{
+            immediate: "immediate";
+            period_end: "period_end";
+        }>>;
+        refund_policy: zod.ZodOptional<zod.ZodEnum<{
+            none: "none";
+            prorated: "prorated";
+            short_rate: "short_rate";
+        }>>;
+        short_rate_multiplier: zod.ZodOptional<zod.ZodString>;
+        short_rate_threshold_seconds: zod.ZodOptional<zod.ZodInt>;
+        monthly_list_amount: zod.ZodOptional<zod.ZodString>;
+        coupon_id: zod.ZodOptional<zod.ZodUUID>;
+        coupon: zod.ZodOptional<zod.ZodObject<{
+            lookup_key: zod.ZodOptional<zod.ZodString>;
+            id: zod.ZodUUID;
+            name: zod.ZodString;
+        }, zod.z.core.$strict>>;
+        discounted_renewals_remaining: zod.ZodOptional<zod.ZodInt>;
+        order_item_id: zod.ZodOptional<zod.ZodUUID>;
+        cancellation: zod.ZodOptional<zod.ZodObject<{
+            reason: zod.ZodOptional<zod.ZodString>;
+            cancellation_id: zod.ZodOptional<zod.ZodUUID>;
+            id: zod.ZodUUID;
+            subscription_item_id: zod.ZodUUID;
+            status: zod.ZodEnum<{
+                scheduled: "scheduled";
+                completed: "completed";
+                failed: "failed";
+                requested: "requested";
+                releasing: "releasing";
+                canceled: "canceled";
+            }>;
+            mode: zod.ZodEnum<{
+                immediate: "immediate";
+                period_end: "period_end";
+            }>;
+            requested_at: zod.z.ZodISODateTime;
+            scheduled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+            effective_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+            completed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+            release_started_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+            canceled_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+            forfeit_remaining_value: zod.ZodBoolean;
+            failure_code: zod.ZodOptional<zod.ZodString>;
+            failure_reason: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strict>>;
+        scheduled_change: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            order_id: zod.ZodUUID;
+            status: zod.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+                canceled: "canceled";
+                accepted: "accepted";
+                partially_completed: "partially_completed";
+            }>;
+            effective_at: zod.z.ZodISODateTime;
+            plan_id: zod.ZodUUID;
+            plan_name: zod.ZodString;
+            price_id: zod.ZodUUID;
+            quantity: zod.ZodString;
+            recurring_amount: zod.ZodString;
+            currency: zod.ZodString;
+            interval: zod.ZodEnum<{
+                day: "day";
+                month: "month";
+                year: "year";
+            }>;
+            interval_count: zod.ZodInt;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
+        created_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        started_at: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        ended_at: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    }, zod.z.core.$strict>>;
     created_at: zod.ZodOptional<zod.z.ZodISODateTime>;
-    id: zod.ZodUUID;
-    billing_account_id: zod.ZodInt;
-    account: zod.ZodObject<{
-        id: zod.ZodInt;
-        name: zod.ZodString;
-        currency: zod.ZodString;
-    }, zod.z.core.$strict>;
-    product_id: zod.ZodString;
-    project_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
-    project: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
-        id: zod.ZodUUID;
-        name: zod.ZodString;
-    }, zod.z.core.$strict>, zod.ZodNull]>>;
-    product: zod.ZodObject<{
-        id: zod.ZodString;
-        name: zod.ZodString;
-        description: zod.ZodOptional<zod.ZodString>;
-    }, zod.z.core.$strict>;
-    plan_id: zod.ZodUUID;
-    plan_name: zod.ZodString;
-    price_id: zod.ZodUUID;
-    quantity: zod.ZodString;
-    current_term_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
-    current_period_start: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
-    current_period_end: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
-    auto_renew: zod.ZodBoolean;
-    status: zod.ZodEnum<{
-        active: "active";
-        pending: "pending";
-        suspended: "suspended";
-        canceled: "canceled";
-        provisioning: "provisioning";
-        terminated: "terminated";
-    }>;
     started_at: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
     ended_at: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
 }, zod.z.core.$strict>;

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

@@ -7,79 +7,22 @@
  */
 import * as zod from "zod";
 import { AccountIdentity } from "./accountIdentity.zod.js";
-import { CancellationPolicy } from "./cancellationPolicy.zod.js";
 import { NamedIdentity } from "./namedIdentity.zod.js";
-import { ObjectIdentity } from "./objectIdentity.zod.js";
-import { PriceType } from "./priceType.zod.js";
 import { Product } from "./product.zod.js";
-import { ProductID } from "./productID.zod.js";
-import { RefundPolicy } from "./refundPolicy.zod.js";
-import { ScheduledChange } from "./scheduledChange.zod.js";
-import { SubscriptionCancellation } from "./subscriptionCancellation.zod.js";
+import { ProductId } from "./productId.zod.js";
+import { SubscriptionItem } from "./subscriptionItem.zod.js";
 import { SubscriptionRestriction } from "./subscriptionRestriction.zod.js";
 import { SubscriptionStatus } from "./subscriptionStatus.zod.js";
-import { UsageType } from "./usageType.zod.js";
-export const subscriptionDiscountedRenewalsRemainingMin = 0;
+import { TrialSettings } from "./trialSettings.zod.js";
 export const Subscription = zod
     .strictObject({
-    renewal_discounts_enabled: zod
-        .boolean()
-        .optional()
-        .describe("Whether new account discounts may apply to future renewals. A fixed operator renewal agreement disables automatic discounts; catalog repricing or a newly selected purchase agreement enables them."),
-    currency: zod.string(),
-    type: PriceType,
-    usage_type: UsageType,
-    dimensions: zod
-        .record(zod.string(), zod.string())
-        .describe("The dimension values of what was bought, such as region and instance type. Empty when the purchase gave none."),
-    interval: zod.enum(["none", "day", "month", "year"]),
-    interval_count: zod.int().min(1).optional(),
-    recurring_amount: zod
-        .string()
-        .optional()
-        .describe("The whole licensed subscription's renewal amount, after continuing discounts and before tax. A pending subscription shows base terms until paying the order fixes any new discount. Absent for metered and one-time subscriptions."),
-    cancellation_policy: CancellationPolicy.optional(),
-    refund_policy: RefundPolicy.optional(),
-    short_rate_multiplier: zod
-        .string()
-        .optional()
-        .describe("Refund policy `short_rate` only, as on the price bought."),
-    short_rate_threshold_seconds: zod
-        .int()
-        .optional()
-        .describe("Refund policy `short_rate` only, as on the price bought."),
-    monthly_list_amount: zod
-        .string()
-        .optional()
-        .describe("Licensed recurring only, the `monthly_list_amount` that a renewal at the agreed amount keeps; see the order item."),
-    order_item_id: zod.uuid().optional(),
-    coupon_id: zod.uuid().optional(),
-    coupon: ObjectIdentity.optional(),
-    discounted_renewals_remaining: zod
-        .int()
-        .min(subscriptionDiscountedRenewalsRemainingMin)
-        .optional(),
-    restrictions: zod
-        .array(SubscriptionRestriction)
-        .optional()
-        .describe("The operations currently prevented on the subscription, sorted; it is suspended while this contains `billing.subscriptions.use`."),
-    billing_cycle_anchor: zod.iso.datetime({ offset: true }).optional(),
-    cancellation: SubscriptionCancellation.optional(),
-    scheduled_change: zod
-        .union([ScheduledChange, zod.null()])
-        .optional()
-        .describe("The accepted period-end change scheduled for this subscription; null when there is none."),
-    default_payment_method_id: zod
-        .uuid()
-        .nullish()
-        .describe("The saved payment method automatic renewal charges after balance and credits, before the account's default payment method. Set when a purchase, renewal or change is paid with a saved payment method. Used only while it belongs to the account paying the renewal."),
-    created_at: zod.iso.datetime({ offset: true }).optional(),
     id: zod.uuid(),
     billing_account_id: zod
         .int()
         .describe("The billing account that made the purchase. Renewals of a project subscription are charged to the project's current billing account."),
     account: AccountIdentity,
-    product_id: ProductID,
+    product_id: ProductId,
+    product: Product,
     project_id: zod
         .uuid()
         .nullish()
@@ -88,31 +31,54 @@ export const Subscription = zod
         .union([NamedIdentity, zod.null()])
         .optional()
         .describe("The project and its current name. Absent for an account-level purchase or when the project cannot be read; `project_id` still identifies it."),
-    product: Product,
-    plan_id: zod.uuid(),
-    plan_name: zod.string(),
-    price_id: zod.uuid(),
-    quantity: zod.string(),
+    currency: zod.string(),
+    status: SubscriptionStatus,
+    interval: zod
+        .enum(["none", "day", "month", "year"])
+        .describe("The renewal term of its licensed items, `interval_count` intervals long; `none` when every item is metered."),
+    interval_count: zod.int().min(1).optional(),
     current_term_end: zod.iso
         .datetime({ offset: true })
         .nullish()
-        .describe("When a licensed subscription renews or expires: the end of the last period bought, moved by renewing in advance. Null until the subscription becomes active, even when its purchase has been paid, and for metered subscriptions."),
+        .describe("When the subscription renews or expires: the end of the free trial or of the last period bought for its licensed items, moved by renewing in advance. Null until the subscription becomes active, even when its purchase has been paid, and when every item is metered."),
     current_period_start: zod.iso
         .datetime({ offset: true })
         .nullish()
-        .describe("Start of the service period in effect now. Null when none is, including for metered subscriptions."),
+        .describe("Start of the service period in effect now. Null when none is, including when every item is metered."),
     current_period_end: zod.iso
         .datetime({ offset: true })
         .nullish()
-        .describe("End of the service period in effect now; renewing in advance moves `current_term_end`, not this. Null when no period is in effect, including for metered subscriptions."),
+        .describe("End of the service period in effect now; renewing in advance moves `current_term_end`, not this. Null when no period is in effect, including when every item is metered."),
+    billing_cycle_anchor: zod.iso.datetime({ offset: true }).optional(),
     auto_renew: zod
         .boolean()
-        .describe("Whether a licensed subscription renews automatically. A metered subscription continues until it is canceled; for it this is true until a cancellation is requested, and cannot be set."),
-    status: SubscriptionStatus,
+        .describe("Whether the subscription renews automatically, or converts to paid when its free trial ends. Without licensed items it continues until it is canceled; then this is true until a cancellation is requested, and cannot be set."),
+    trial_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("Start of the free trial; null without one."),
+    trial_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("End of the free trial; null without one. It is `current_term_end` until the first paid period is bought."),
+    trial_settings: zod
+        .union([TrialSettings, zod.null()])
+        .optional()
+        .describe("How the free trial ends; null without one."),
+    restrictions: zod
+        .array(SubscriptionRestriction)
+        .optional()
+        .describe("The operations currently prevented on the subscription, sorted; it is suspended while this contains `billing.subscriptions.use`."),
+    default_payment_method_id: zod
+        .uuid()
+        .nullish()
+        .describe("The saved payment method automatic renewal charges after balance and credits, before the account's default payment method. Set when a purchase, renewal or change is paid with a saved payment method. Used only while it belongs to the account paying the renewal."),
+    items: zod.array(SubscriptionItem).describe("Every item, ended ones included, oldest first."),
+    created_at: zod.iso.datetime({ offset: true }).optional(),
     started_at: zod.iso
         .datetime({ offset: true })
         .nullish()
         .describe("When service started. Null until a new subscription becomes active, also after payment."),
     ended_at: zod.iso.datetime({ offset: true }).nullish(),
 })
-    .describe("A purchase that is billed, renewed and changed on its own, separate from the owning service's resource. A new\nrecurring purchase creates a pending subscription for each order line; its ID is returned on the order item\nand stays the same through checkout, delivery, renewals and changes. A one-time purchase may create none.\n\nPending and provisioning subscriptions grant no service. A subscription becomes provisioning when the owning\nservice accepts the order, and active when the service confirms delivery, which sets started_at; payment\nchanges neither. Licensed service periods start at delivery, and metered usage is charged as the service\nreports it. Canceling or failing an undelivered purchase cancels its subscriptions without starting a period.\nRenewals use recurring_amount and the agreed interval; paid periods keep their value.\n\nA shared capacity limit, such as a regional snapshot quota, has one subscription for the purchased quantity\nrather than one per item.");
+    .describe("A billing relationship that renews as a whole, as a Stripe subscription: one term, one renewal date, one\nautomatic renewal setting and one service state for all of its items. The owning service decides which order\nlines form one subscription, such as a machine and the volumes and elastic IP bought with it; a resource bought\non its own has its own. A purchase creates pending subscriptions and items whose IDs are returned on the order\nitems and stay the same through checkout, delivery, renewals and changes.\n\nPending and provisioning subscriptions grant no service. A subscription becomes provisioning when the owning\nservice accepts the order, and active, or trialing during a free trial, when the service confirms delivery,\nwhich sets started_at; payment changes neither. Renewing buys further periods for every continuing licensed\nitem at once; items cannot be renewed on their own, but each can be changed or canceled alone.");