@leaflow/sdk 0.121.0 → 0.122.0

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

@@ -0,0 +1,31 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const SpendRowList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        product: zod.ZodOptional<zod.ZodObject<{
+            id: zod.ZodString;
+            name: zod.ZodString;
+            description: zod.ZodOptional<zod.ZodString>;
+        }, zod.z.core.$strict>>;
+        plan_id: zod.ZodOptional<zod.ZodUUID>;
+        plan_name: zod.ZodOptional<zod.ZodString>;
+        resource_id: zod.ZodOptional<zod.ZodString>;
+        amount: zod.ZodString;
+        currency: zod.ZodString;
+    }, zod.z.core.$strict>>;
+    total: zod.ZodString;
+    currency: zod.ZodString;
+    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 SpendRowList = zod.input<typeof SpendRowList>;
+export type SpendRowListOutput = zod.output<typeof SpendRowList>;

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

@@ -0,0 +1,17 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+import { SpendRow } from "./spendRow.zod.js";
+export const SpendRowList = zod.strictObject({
+    items: zod.array(SpendRow),
+    total: Money.describe("The sum over the whole period, not only the page returned."),
+    currency: zod.string(),
+    pagination: OffsetPagination,
+});

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

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const Statement: zod.ZodObject<{
+    id: zod.ZodUUID;
+    billing_account_id: zod.ZodInt;
+    currency: zod.ZodString;
+    period_start: zod.z.ZodISODateTime;
+    period_end: zod.z.ZodISODateTime;
+    sequence: zod.ZodInt;
+    status: zod.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>;
+    estimated: zod.ZodBoolean;
+    amounts: zod.ZodObject<{
+        subtotal: zod.ZodString;
+        discount_amount: zod.ZodString;
+        tax_amount: zod.ZodString;
+        total: zod.ZodString;
+    }, zod.z.core.$strict>;
+    closed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    invoice_id: zod.ZodOptional<zod.ZodUUID>;
+    created_at: zod.z.ZodISODateTime;
+    calculated_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    credited_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Statement = zod.input<typeof Statement>;
+export type StatementOutput = zod.output<typeof Statement>;

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

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+import { StatementAmounts } from "./statementAmounts.zod.js";
+import { StatementStatus } from "./statementStatus.zod.js";
+export const Statement = zod
+    .strictObject({
+    id: zod.uuid(),
+    billing_account_id: zod.int(),
+    currency: zod.string(),
+    period_start: zod.iso.datetime({ offset: true }),
+    period_end: zod.iso.datetime({ offset: true }),
+    sequence: zod
+        .int()
+        .describe("1 for the first closing of the period; higher for statements that collect usage priced after an earlier closing."),
+    status: StatementStatus,
+    estimated: zod
+        .boolean()
+        .describe("True while the statement is open. The estimate applies tier pricing to the period's usage so far and adds tax for the current invoice contact. Minimum charges are added at closing, and a tier reduction larger than this statement's own charges is credited to earlier invoices of the period at closing."),
+    amounts: StatementAmounts,
+    closed_at: zod.iso.datetime({ offset: true }).optional(),
+    invoice_id: zod
+        .uuid()
+        .optional()
+        .describe("The invoice issued at this closing, when it produced one."),
+    created_at: zod.iso.datetime({ offset: true }),
+    calculated_at: zod.iso.datetime({ offset: true }).optional(),
+    credited_amount: Money,
+})
+    .describe("An account's consumption for one billing period, collected at one closing. The first statement of a period (sequence 1) closes after the period ends. Usage priced after that closing is collected in a later statement for the same period, which closes and invoices separately; a closed statement is never rewritten. Payments apply to issued invoices.");

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

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const StatementAmounts: zod.ZodObject<{
+    subtotal: zod.ZodString;
+    discount_amount: zod.ZodString;
+    tax_amount: zod.ZodString;
+    total: zod.ZodString;
+}, zod.z.core.$strict>;
+export type StatementAmounts = zod.input<typeof StatementAmounts>;
+export type StatementAmountsOutput = zod.output<typeof StatementAmounts>;

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

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const StatementAmounts = zod.strictObject({
+    subtotal: Money,
+    discount_amount: Money,
+    tax_amount: Money,
+    total: Money,
+});

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

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const StatementItem: zod.ZodObject<{
+    project_id: zod.ZodOptional<zod.ZodUUID>;
+    product_id: zod.ZodOptional<zod.ZodString>;
+    meter_id: zod.ZodOptional<zod.ZodUUID>;
+    unit: zod.ZodOptional<zod.ZodString>;
+    quantity: zod.ZodOptional<zod.ZodString>;
+    deducted_quantity: zod.ZodOptional<zod.ZodString>;
+    amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type StatementItem = zod.input<typeof StatementItem>;
+export type StatementItemOutput = zod.output<typeof StatementItem>;

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

@@ -0,0 +1,21 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const StatementItem = zod.strictObject({
+    project_id: zod.uuid().optional(),
+    product_id: zod.string().optional(),
+    meter_id: zod.uuid().optional(),
+    unit: zod.string().optional(),
+    quantity: zod
+        .string()
+        .optional()
+        .describe("Net usage quantity. Included only when grouping by meter."),
+    deducted_quantity: zod.string().optional(),
+    amount: Money,
+});

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

@@ -0,0 +1,41 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const StatementList: zod.ZodObject<{
+    items: zod.ZodArray<zod.ZodObject<{
+        id: zod.ZodUUID;
+        billing_account_id: zod.ZodInt;
+        currency: zod.ZodString;
+        period_start: zod.z.ZodISODateTime;
+        period_end: zod.z.ZodISODateTime;
+        sequence: zod.ZodInt;
+        status: zod.ZodEnum<{
+            open: "open";
+            closed: "closed";
+        }>;
+        estimated: zod.ZodBoolean;
+        amounts: zod.ZodObject<{
+            subtotal: zod.ZodString;
+            discount_amount: zod.ZodString;
+            tax_amount: zod.ZodString;
+            total: zod.ZodString;
+        }, zod.z.core.$strict>;
+        closed_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        invoice_id: zod.ZodOptional<zod.ZodUUID>;
+        created_at: zod.z.ZodISODateTime;
+        calculated_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+        credited_amount: zod.ZodString;
+    }, 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 StatementList = zod.input<typeof StatementList>;
+export type StatementListOutput = zod.output<typeof StatementList>;

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

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+import { Statement } from "./statement.zod.js";
+export const StatementList = zod.strictObject({
+    items: zod.array(Statement),
+    pagination: OffsetPagination,
+});

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

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const StatementStatus: zod.ZodEnum<{
+    open: "open";
+    closed: "closed";
+}>;
+export type StatementStatus = zod.input<typeof StatementStatus>;
+export type StatementStatusOutput = zod.output<typeof StatementStatus>;

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

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const StatementStatus = zod.enum(["open", "closed"]);

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

@@ -0,0 +1,35 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const StatementSummary: zod.ZodObject<{
+    statement_id: zod.ZodUUID;
+    currency: zod.ZodString;
+    estimated: zod.ZodBoolean;
+    calculated_at: zod.ZodOptional<zod.z.ZodISODateTime>;
+    group_by: zod.ZodEnum<{
+        project: "project";
+        product: "product";
+        meter: "meter";
+    }>;
+    items: zod.ZodArray<zod.ZodObject<{
+        project_id: zod.ZodOptional<zod.ZodUUID>;
+        product_id: zod.ZodOptional<zod.ZodString>;
+        meter_id: zod.ZodOptional<zod.ZodUUID>;
+        unit: zod.ZodOptional<zod.ZodString>;
+        quantity: zod.ZodOptional<zod.ZodString>;
+        deducted_quantity: zod.ZodOptional<zod.ZodString>;
+        amount: zod.ZodString;
+    }, 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 StatementSummary = zod.input<typeof StatementSummary>;
+export type StatementSummaryOutput = zod.output<typeof StatementSummary>;

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

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { OffsetPagination } from "./offsetPagination.zod.js";
+import { StatementItem } from "./statementItem.zod.js";
+export const StatementSummary = zod.strictObject({
+    statement_id: zod.uuid(),
+    currency: zod.string(),
+    estimated: zod.boolean(),
+    calculated_at: zod.iso.datetime({ offset: true }).optional(),
+    group_by: zod.enum(["project", "product", "meter"]),
+    items: zod.array(StatementItem),
+    pagination: OffsetPagination,
+});

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

@@ -0,0 +1,111 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const subscriptionDiscountedRenewalsRemainingMin = 0;
+export declare const Subscription: zod.ZodObject<{
+    currency: zod.ZodString;
+    charge_type: zod.ZodEnum<{
+        postpaid: "postpaid";
+        prepaid: "prepaid";
+        one_time: "one_time";
+    }>;
+    interval: zod.ZodEnum<{
+        none: "none";
+        day: "day";
+        month: "month";
+        year: "year";
+    }>;
+    interval_count: zod.ZodOptional<zod.ZodInt>;
+    recurring_amount: zod.ZodOptional<zod.ZodString>;
+    termination_policy: zod.ZodOptional<zod.ZodEnum<{
+        immediate: "immediate";
+        period_end: "period_end";
+    }>>;
+    refund_policy: zod.ZodOptional<zod.ZodEnum<{
+        none: "none";
+        prorated: "prorated";
+    }>>;
+    order_item_id: zod.ZodOptional<zod.ZodUUID>;
+    replaces_subscription_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>;
+    suspend_reason: zod.ZodOptional<zod.ZodString>;
+    billing_cycle_anchor: zod.ZodOptional<zod.z.ZodISODateTime>;
+    cancellation: zod.ZodOptional<zod.ZodObject<{
+        reason: zod.ZodOptional<zod.ZodString>;
+        cancellation_id: zod.ZodOptional<zod.ZodUUID>;
+        id: zod.ZodUUID;
+        subscription_id: zod.ZodUUID;
+        status: zod.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            requested: "requested";
+            scheduled: "scheduled";
+            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>>;
+    default_payment_method_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;
+    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<{
+        pending: "pending";
+        active: "active";
+        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>;
+export type Subscription = zod.input<typeof Subscription>;
+export type SubscriptionOutput = zod.output<typeof Subscription>;

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

@@ -0,0 +1,92 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { AccountIdentity } from "./accountIdentity.zod.js";
+import { NamedIdentity } from "./namedIdentity.zod.js";
+import { ObjectIdentity } from "./objectIdentity.zod.js";
+import { Product } from "./product.zod.js";
+import { ProductID } from "./productID.zod.js";
+import { RefundPolicy } from "./refundPolicy.zod.js";
+import { SubscriptionCancellation } from "./subscriptionCancellation.zod.js";
+import { TerminationPolicy } from "./terminationPolicy.zod.js";
+export const subscriptionDiscountedRenewalsRemainingMin = 0;
+export const Subscription = zod
+    .strictObject({
+    currency: zod.string(),
+    charge_type: zod.enum(["postpaid", "prepaid", "one_time"]),
+    interval: zod.enum(["none", "day", "month", "year"]),
+    interval_count: zod.int().min(1).optional(),
+    recurring_amount: zod
+        .string()
+        .optional()
+        .describe("Whole-subscription prepaid renewal amount, after continuing discounts and before tax.\nPending subscriptions show base terms until paying the order fixes any new continuing discount.\nAbsent for other charge types."),
+    termination_policy: TerminationPolicy.optional(),
+    refund_policy: RefundPolicy.optional(),
+    order_item_id: zod.uuid().optional(),
+    replaces_subscription_id: zod
+        .uuid()
+        .optional()
+        .describe("Present only on subscriptions created by an earlier change that replaced the subscription. A change now keeps the subscription ID."),
+    coupon_id: zod.uuid().optional(),
+    coupon: ObjectIdentity.optional(),
+    discounted_renewals_remaining: zod
+        .int()
+        .min(subscriptionDiscountedRenewalsRemainingMin)
+        .optional(),
+    suspend_reason: zod.string().optional(),
+    billing_cycle_anchor: zod.iso.datetime({ offset: true }).optional(),
+    cancellation: SubscriptionCancellation.optional(),
+    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."),
+    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,
+    project_id: zod
+        .uuid()
+        .nullish()
+        .describe("Which project this is for. Absent when it was bought at account level, such as a\nmembership, which belongs to no single project."),
+    project: zod
+        .union([NamedIdentity, zod.null()])
+        .optional()
+        .describe("The project and its current name, for display. Absent for a purchase at account level,\nand when the project no longer exists or its details cannot be read at the moment;\n`project_id` still identifies it then."),
+    product: Product,
+    plan_id: zod.uuid(),
+    plan_name: zod.string(),
+    price_id: zod.uuid(),
+    quantity: zod.string(),
+    current_term_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("When a prepaid subscription renews or expires, the end of the last service period bought.\nRenewing several periods in advance moves it. Null until a new subscription becomes active, even when\nits purchase has been paid, and for postpaid subscriptions."),
+    current_period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("Start of the service period in effect now. Null when none is, including for postpaid subscriptions."),
+    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\nthis. Null when no period is in effect, including for postpaid subscriptions."),
+    auto_renew: zod
+        .boolean()
+        .describe("A prepaid subscription renews automatically while this is on. A postpaid subscription always continues until it is canceled; this is true until a cancellation is requested and cannot be set."),
+    status: zod
+        .enum(["pending", "provisioning", "active", "suspended", "canceled", "terminated"])
+        .describe("pending means the purchase relationship exists but its order has not been accepted.\nprovisioning means the service accepted the order and is delivering. For a service-owned\npurchase, only confirmed delivery moves it to active; paying alone does not.\ncanceled means cancellation completed, or an unfulfilled purchase was canceled or failed without delivery.\nterminated means an administrator or the owning service immediately ended the commercial relationship."),
+    started_at: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("Confirmed start of service. Null until a new subscription becomes active, including after payment."),
+    ended_at: zod.iso.datetime({ offset: true }).nullish(),
+})
+    .describe("An independently billed purchase relationship, separate from the owning service's resource.\nPlacing a new prepaid or postpaid service order creates a pending subscription for each line\nin the same purchase transaction. Its ID is returned on the order item and remains stable\nthrough checkout and delivery. One order may create several subscriptions, such as an instance,\nits system disk and its address; it has no single subscription ID.\n\nPending and provisioning do not grant service or accrue usage. A service-owned subscription\nbecomes provisioning when the owning service accepts the order, and active when the service\nconfirms delivery, with started_at set to the confirmed effective time; payment changes neither. Prepaid service periods start\nthen; postpaid usage starts only when the service reports actual delivery and metering.\n\nOne-time delivery may omit a subscription. Renewals reference and extend existing subscriptions\nrather than creating another; a change keeps the subscription ID and switches its terms when it\ntakes effect. Canceling or failing an unfulfilled purchase sets its pending or provisioning\nsubscriptions to canceled without starting a service period.\nFixed renewals use the agreed recurring_amount and interval; already paid periods retain their\noriginal value. Technical state belongs to the owning service.\n\nA purchased shared capacity limit, such as a regional snapshot count quota, can have its own\nsubscription. Activating that capacity confirms delivery of the quota, not individual snapshots.\nCreating or deleting snapshots within it does not create, activate or terminate more subscriptions;\nthe owning service enforces current holdings against the purchased count.");

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

@@ -0,0 +1,37 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const SubscriptionCancellation: zod.ZodObject<{
+    reason: zod.ZodOptional<zod.ZodString>;
+    cancellation_id: zod.ZodOptional<zod.ZodUUID>;
+    id: zod.ZodUUID;
+    subscription_id: zod.ZodUUID;
+    status: zod.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        requested: "requested";
+        scheduled: "scheduled";
+        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>;
+export type SubscriptionCancellation = zod.input<typeof SubscriptionCancellation>;
+export type SubscriptionCancellationOutput = zod.output<typeof SubscriptionCancellation>;

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

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Billing Order Types
+ * The Billing order a product purchase placed. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const SubscriptionCancellation = zod
+    .strictObject({
+    reason: zod.string().optional(),
+    cancellation_id: zod
+        .uuid()
+        .optional()
+        .describe("The cancellation this request belongs to, with the other subscriptions released together."),
+    id: zod.uuid(),
+    subscription_id: zod.uuid(),
+    status: zod.enum(["requested", "scheduled", "releasing", "failed", "completed", "canceled"]),
+    mode: zod.enum(["immediate", "period_end"]),
+    requested_at: zod.iso.datetime({ offset: true }),
+    scheduled_at: zod.iso.datetime({ offset: true }).optional(),
+    effective_at: zod.iso.datetime({ offset: true }).optional(),
+    completed_at: zod.iso.datetime({ offset: true }).optional(),
+    release_started_at: zod.iso.datetime({ offset: true }).optional(),
+    canceled_at: zod.iso.datetime({ offset: true }).optional(),
+    forfeit_remaining_value: zod.boolean(),
+    failure_code: zod.string().optional(),
+    failure_reason: zod.string().optional(),
+})
+    .describe("The latest cancellation that includes the subscription, with this subscription's item. `id` is the\nitem; `cancellation_id` is the cancellation. scheduled_at is the intended time; effective_at is the\nconfirmed end of service. A cancellation alone does not stop metering or issue a refund.");