@leaflow/sdk 0.136.0 → 0.137.0

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

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */

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

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */

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

@@ -0,0 +1,38 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */
+/**
+ * A decimal string, in the currency stated alongside it.
+ *
+ * **The currency is not part of this type.** It is carried by a `currency` field next to the
+ * amount, or by the account the amount belongs to. Reading an amount without that field is
+ * reading a number with no unit.
+ *
+ * It is a string rather than a JSON number because a JSON number is a float in most parsers,
+ * and a float loses precision on the first arithmetic. Nothing on this platform puts an amount
+ * through a float.
+ */
+export type Money = string;
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}

package/dist/billing/type/funds/v1/generated/models.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */

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

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */

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

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

package/dist/billing/type/funds/v1/generated/validators/funds.zod.js

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

package/dist/billing/type/funds/v1/generated/validators/money.zod.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const Money: zod.ZodString;
+export type Money = zod.input<typeof Money>;
+export type MoneyOutput = zod.output<typeof Money>;

package/dist/billing/type/funds/v1/generated/validators/money.zod.js

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Purchase Funds
+ * Current account funds and the additional balance needed for a quoted purchase. Types only.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export const Money = zod
+    .string()
+    .describe("A decimal string, in the currency stated alongside it.\n\n**The currency is not part of this type.** It is carried by a `currency` field next to the\namount, or by the account the amount belongs to. Reading an amount without that field is\nreading a number with no unit.\n\nIt is a string rather than a JSON number because a JSON number is a float in most parsers,\nand a float loses precision on the first arithmetic. Nothing on this platform puts an amount\nthrough a float.");

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

@@ -384,6 +384,25 @@ export interface QuoteItem {
     total: Money;
     currency: string;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 export type QuotedDiscountType = (typeof QuotedDiscountType)[keyof typeof QuotedDiscountType];
 export declare const QuotedDiscountType: {
     readonly promotion_code: "promotion_code";
@@ -502,6 +521,8 @@ export interface OrderRefundQuote {
  * provides that order's checkout amount.
  */
 export interface Quote {
+    /** Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews. */
+    funds?: Funds;
     subtotal: Money;
     discount_amount: Money;
     tax_amount: Money;
@@ -1282,6 +1303,7 @@ export interface PaymentPreviewInvoice {
  * What paying would take, computed as paying computes it. Nothing is charged or reserved.
  */
 export interface PaymentPreview {
+    funds?: Funds;
     currency: string;
     /** What is outstanding before paying. */
     amount_due: Money;

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

@@ -0,0 +1,18 @@
+/**
+ * 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 Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

package/dist/billing/type/order/v1/generated/validators/funds.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 { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const PaymentPreview: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     currency: zod.ZodString;
     amount_due: zod.ZodString;
     credit_applied: zod.ZodString;

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

@@ -7,10 +7,12 @@
  */
 import * as zod from "zod";
 import { AppliedCredit } from "./appliedCredit.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { PaymentPreviewInvoice } from "./paymentPreviewInvoice.zod.js";
 export const PaymentPreview = zod
     .strictObject({
+    funds: Funds.optional(),
     currency: zod.string(),
     amount_due: Money.describe("What is outstanding before paying."),
     credit_applied: Money.describe("What credit grants would pay. Grants restricted to other purchases pay nothing here."),

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;
     tax_amount: zod.ZodString;

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 import { CancellationRefundPreview } from "./cancellationRefundPreview.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { OrderRefundQuote } from "./orderRefundQuote.zod.js";
 import { QuotedDiscount } from "./quotedDiscount.zod.js";
@@ -14,6 +15,7 @@ import { QuoteItem } from "./quoteItem.zod.js";
 import { QuoteRenewalResult } from "./quoteRenewalResult.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds.optional().describe("Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews."),
     subtotal: Money,
     discount_amount: Money,
     tax_amount: Money,

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

@@ -17,6 +17,25 @@
  * through a float.
  */
 export type Money = string;
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 /**
  * One calculated purchase line. Fixed purchase amounts are rounded as checkout rounds them.
  * A line without an immediate charge has zero checkout amounts. unit_amount remains null when
@@ -62,11 +81,13 @@ export interface QuoteItem {
  * error response; it never returns a partial quote with HTTP 200.
  */
 export interface Quote {
+    funds: Funds;
     /**
      * Whether the account's current balance and eligible credits cover immediate charges
      * and the currency's minimum top-up for every new postpaid item. False preserves this
      * complete price preview. Nothing is reserved; checkout rechecks funds. Prepaid
      * purchases may also use an online payment method.
+     * @deprecated
      */
     funds_sufficient: boolean;
     /** One line for each item the purchase would order, in the order it would order them. */

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

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Quote Types
+ * Price previews returned before purchase confirmation. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

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

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Quote Types
+ * Price previews returned before purchase confirmation. Types only; this document declares no operations.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>;
     funds_sufficient: zod.ZodBoolean;
     items: zod.ZodArray<zod.ZodObject<{
         plan_name: zod.ZodString;

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

@@ -6,10 +6,12 @@
  * OpenAPI spec version: v1
  */
 import * as zod from "zod";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { QuoteItem } from "./quoteItem.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds,
     funds_sufficient: zod
         .boolean()
         .describe("Whether the account's current balance and eligible credits cover immediate charges\nand the currency's minimum top-up for every new postpaid item. False preserves this\ncomplete price preview. Nothing is reserved; checkout rechecks funds. Prepaid\npurchases may also use an online payment method."),

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

@@ -143,6 +143,25 @@ export interface QuoteItem {
     total: Money;
     currency: string;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 export type QuotedDiscountType = (typeof QuotedDiscountType)[keyof typeof QuotedDiscountType];
 export declare const QuotedDiscountType: {
     readonly promotion_code: "promotion_code";
@@ -261,6 +280,8 @@ export interface OrderRefundQuote {
  * provides that order's checkout amount.
  */
 export interface Quote {
+    /** Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews. */
+    funds?: Funds;
     subtotal: Money;
     discount_amount: Money;
     tax_amount: Money;
@@ -1052,6 +1073,7 @@ export interface PaymentPreviewInvoice {
  * What paying would take, computed as paying computes it. Nothing is charged or reserved.
  */
 export interface PaymentPreview {
+    funds?: Funds;
     currency: string;
     /** What is outstanding before paying. */
     amount_due: Money;

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

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

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

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Billing API
+ * Products, prices, orders, subscriptions and account billing. Financial operations require an account access token and billing-account authorization. Public catalogue operations declare no security requirement.
+ * OpenAPI spec version: v1
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const PaymentPreview: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     currency: zod.ZodString;
     amount_due: zod.ZodString;
     credit_applied: zod.ZodString;

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

@@ -7,10 +7,12 @@
  */
 import * as zod from "zod";
 import { AppliedCredit } from "./appliedCredit.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { PaymentPreviewInvoice } from "./paymentPreviewInvoice.zod.js";
 export const PaymentPreview = zod
     .strictObject({
+    funds: Funds.optional(),
     currency: zod.string(),
     amount_due: Money.describe("What is outstanding before paying."),
     credit_applied: Money.describe("What credit grants would pay. Grants restricted to other purchases pay nothing here."),

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;
     tax_amount: zod.ZodString;

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 import { CancellationRefundPreview } from "./cancellationRefundPreview.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { OrderRefundQuote } from "./orderRefundQuote.zod.js";
 import { QuotedDiscount } from "./quotedDiscount.zod.js";
@@ -14,6 +15,7 @@ import { QuoteItem } from "./quoteItem.zod.js";
 import { QuoteRenewalResult } from "./quoteRenewalResult.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds.optional().describe("Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews."),
     subtotal: Money,
     discount_amount: Money,
     tax_amount: Money,

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

@@ -491,6 +491,25 @@ export interface CreateServiceResponseBody {
     service: ServiceResource;
     order: PlacedOrder;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 /**
  * One calculated purchase line. Fixed purchase amounts are rounded as checkout rounds them.
  * A line without an immediate charge has zero checkout amounts. unit_amount remains null when
@@ -536,11 +555,13 @@ export interface QuoteItemDc1fddb {
  * error response; it never returns a partial quote with HTTP 200.
  */
 export interface Quote {
+    funds: Funds;
     /**
      * Whether the account's current balance and eligible credits cover immediate charges
      * and the currency's minimum top-up for every new postpaid item. False preserves this
      * complete price preview. Nothing is reserved; checkout rechecks funds. Prepaid
      * purchases may also use an online payment method.
+     * @deprecated
      */
     funds_sufficient: boolean;
     /** One line for each item the purchase would order, in the order it would order them. */
@@ -996,6 +1017,8 @@ export interface OrderRefundQuote {
  * provides that order's checkout amount.
  */
 export interface Quote5f60d00 {
+    /** Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews. */
+    funds?: Funds;
     subtotal: Money;
     discount_amount: Money;
     tax_amount: Money;
@@ -1761,6 +1784,7 @@ export interface PaymentPreviewInvoice {
  * What paying would take, computed as paying computes it. Nothing is charged or reserved.
  */
 export interface PaymentPreview {
+    funds?: Funds;
     currency: string;
     /** What is outstanding before paying. */
     amount_due: Money;

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

@@ -0,0 +1,41 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These management endpoints do not accept a Canopy API key. On this userapi host, the OpenAI-compatible `/v1/chat/completions`, `/v1/embeddings`, `/v1/models` and `/v1/models/{model}` endpoints accept the same project token; see the project inference contract. The separate API-key gateway continues to accept Canopy API keys.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

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

@@ -0,0 +1,42 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Management of API keys, together with the models available and the usage recorded against them.
+ *
+ * **These endpoints do not perform inference.** Requests are issued to the forwarding address, which accepts the OpenAI, Anthropic and Gemini request formats:
+ *
+ * ```
+ * POST /v1/chat/completions                    OpenAI
+ * POST /v1/messages                            Anthropic
+ * POST /v1beta/models/{model}:generateContent  Gemini
+ * ```
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * These management endpoints do not accept a Canopy API key. On this userapi host, the OpenAI-compatible `/v1/chat/completions`, `/v1/embeddings`, `/v1/models` and `/v1/models/{model}` endpoints accept the same project token; see the project inference contract. The separate API-key gateway continues to accept Canopy API keys.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -30,6 +30,14 @@
  */
 import * as zod from "zod";
 export declare const PaymentPreview: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     currency: zod.ZodString;
     amount_due: zod.ZodString;
     credit_applied: zod.ZodString;

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

@@ -30,10 +30,12 @@
  */
 import * as zod from "zod";
 import { AppliedCredit } from "./appliedCredit.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { PaymentPreviewInvoice } from "./paymentPreviewInvoice.zod.js";
 export const PaymentPreview = zod
     .strictObject({
+    funds: Funds.optional(),
     currency: zod.string(),
     amount_due: Money.describe("What is outstanding before paying."),
     credit_applied: Money.describe("What credit grants would pay. Grants restricted to other purchases pay nothing here."),

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

@@ -30,6 +30,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>;
     funds_sufficient: zod.ZodBoolean;
     items: zod.ZodArray<zod.ZodObject<{
         plan_name: zod.ZodString;

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

@@ -29,10 +29,12 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { QuoteItemDc1fddb } from "./quoteItemDc1fddb.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds,
     funds_sufficient: zod
         .boolean()
         .describe("Whether the account's current balance and eligible credits cover immediate charges\nand the currency's minimum top-up for every new postpaid item. False preserves this\ncomplete price preview. Nothing is reserved; checkout rechecks funds. Prepaid\npurchases may also use an online payment method."),

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

@@ -30,6 +30,14 @@
  */
 import * as zod from "zod";
 export declare const Quote5f60d00: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;
     tax_amount: zod.ZodString;

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

@@ -30,6 +30,7 @@
  */
 import * as zod from "zod";
 import { CancellationRefundPreview } from "./cancellationRefundPreview.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { OrderRefundQuote } from "./orderRefundQuote.zod.js";
 import { QuotedDiscount } from "./quotedDiscount.zod.js";
@@ -37,6 +38,7 @@ import { QuoteItem } from "./quoteItem.zod.js";
 import { QuoteRenewalResult } from "./quoteRenewalResult.zod.js";
 export const Quote5f60d00 = zod
     .strictObject({
+    funds: Funds.optional().describe("Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews."),
     subtotal: Money,
     discount_amount: Money,
     tax_amount: Money,

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

@@ -30,6 +30,14 @@
  */
 import * as zod from "zod";
 export declare const QuoteA200529: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;
     tax_amount: zod.ZodString;

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

@@ -2302,6 +2302,25 @@ export interface SetFloatingIPBandwidthQuoteRequestBody {
      */
     bandwidth_mbps: number;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 /**
  * One calculated purchase line. Fixed purchase amounts are rounded as checkout rounds them.
  * A line without an immediate charge has zero checkout amounts. unit_amount remains null when
@@ -2347,11 +2366,13 @@ export interface QuoteItem {
  * error response; it never returns a partial quote with HTTP 200.
  */
 export interface Quote {
+    funds: Funds;
     /**
      * Whether the account's current balance and eligible credits cover immediate charges
      * and the currency's minimum top-up for every new postpaid item. False preserves this
      * complete price preview. Nothing is reserved; checkout rechecks funds. Prepaid
      * purchases may also use an online payment method.
+     * @deprecated
      */
     funds_sufficient: boolean;
     /** One line for each item the purchase would order, in the order it would order them. */

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

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

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

@@ -0,0 +1,35 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Compute API
+ * Leaflow Compute user API for managing instances, disks, snapshots, backups, images, private networks, subnets, routes, security groups, network interfaces and floating IPs.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `scopedTokenAuth` security scheme.
+ *
+ * ## Conventions
+ *
+ * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
+ * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
+ * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
+ * - **IPv6 is not sold separately.** Once enabled on a private network, IPv6 addresses are assigned to the instances in that network automatically; they can be neither requested nor released individually.
+ * - **Floating IPs have a cooldown period.** A released address is neither available for re-allocation nor handed to another user for some time, so that DNS records and allow-lists still pointing at it do not break immediately.
+ * - **Passwords are returned once.** A password generated by the platform during creation or rebuild appears only in that response. Store it immediately.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -23,6 +23,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>;
     funds_sufficient: zod.ZodBoolean;
     items: zod.ZodArray<zod.ZodObject<{
         plan_name: zod.ZodString;

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

@@ -22,10 +22,12 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { QuoteItem } from "./quoteItem.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds,
     funds_sufficient: zod
         .boolean()
         .describe("Whether the account's current balance and eligible credits cover immediate charges\nand the currency's minimum top-up for every new postpaid item. False preserves this\ncomplete price preview. Nothing is reserved; checkout rechecks funds. Prepaid\npurchases may also use an online payment method."),

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

@@ -709,6 +709,25 @@ export interface QuoteItem {
     total: Money;
     currency: string;
 }
+/**
+ * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
+ * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
+ * A prepaid purchase may instead use an online payment method.
+ */
+export interface Funds {
+    /** Spendable balance after pending returns. */
+    available_balance_amount: Money;
+    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    usable_credit_amount: Money;
+    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    restricted_credit_amount: Money;
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    required_balance_amount: Money;
+    /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
+    balance_shortfall_amount: Money;
+    /** Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed. */
+    required_top_up_amount: Money;
+}
 export type QuotedDiscountType = (typeof QuotedDiscountType)[keyof typeof QuotedDiscountType];
 export declare const QuotedDiscountType: {
     readonly promotion_code: "promotion_code";
@@ -812,6 +831,8 @@ export interface OrderRefundQuote {
  * provides that order's checkout amount.
  */
 export interface Quote {
+    /** Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews. */
+    funds?: Funds;
     subtotal: Money;
     discount_amount: Money;
     tax_amount: Money;
@@ -1577,6 +1598,7 @@ export interface PaymentPreviewInvoice {
  * What paying would take, computed as paying computes it. Nothing is charged or reserved.
  */
 export interface PaymentPreview {
+    funds?: Funds;
     currency: string;
     /** What is outstanding before paying. */
     amount_due: Money;

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

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const Funds: zod.ZodObject<{
+    available_balance_amount: zod.ZodString;
+    usable_credit_amount: zod.ZodString;
+    restricted_credit_amount: zod.ZodString;
+    required_balance_amount: zod.ZodString;
+    balance_shortfall_amount: zod.ZodString;
+    required_top_up_amount: zod.ZodString;
+}, zod.z.core.$strict>;
+export type Funds = zod.input<typeof Funds>;
+export type FundsOutput = zod.output<typeof Funds>;

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

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Membership API
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+import { Money } from "./money.zod.js";
+export const Funds = zod
+    .strictObject({
+    available_balance_amount: Money.describe("Spendable balance after pending returns."),
+    usable_credit_amount: Money.describe("Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once."),
+    restricted_credit_amount: Money.describe("Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted."),
+    required_balance_amount: Money.describe("Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement."),
+    balance_shortfall_amount: Money.describe("Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved."),
+    required_top_up_amount: Money.describe("Minimum recharge that covers the shortfall, respecting the currency minimum recharge and currency precision. Zero when no additional balance is needed."),
+})
+    .describe("Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.\nCredit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.\nA prepaid purchase may instead use an online payment method.\n");

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const PaymentPreview: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     currency: zod.ZodString;
     amount_due: zod.ZodString;
     credit_applied: zod.ZodString;

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

@@ -7,10 +7,12 @@
  */
 import * as zod from "zod";
 import { AppliedCredit } from "./appliedCredit.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { PaymentPreviewInvoice } from "./paymentPreviewInvoice.zod.js";
 export const PaymentPreview = zod
     .strictObject({
+    funds: Funds.optional(),
     currency: zod.string(),
     amount_due: Money.describe("What is outstanding before paying."),
     credit_applied: Money.describe("What credit grants would pay. Grants restricted to other purchases pay nothing here."),

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

@@ -7,6 +7,14 @@
  */
 import * as zod from "zod";
 export declare const Quote: zod.ZodObject<{
+    funds: zod.ZodOptional<zod.ZodObject<{
+        available_balance_amount: zod.ZodString;
+        usable_credit_amount: zod.ZodString;
+        restricted_credit_amount: zod.ZodString;
+        required_balance_amount: zod.ZodString;
+        balance_shortfall_amount: zod.ZodString;
+        required_top_up_amount: zod.ZodString;
+    }, zod.z.core.$strict>>;
     subtotal: zod.ZodString;
     discount_amount: zod.ZodString;
     tax_amount: zod.ZodString;

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

@@ -7,6 +7,7 @@
  */
 import * as zod from "zod";
 import { CancellationRefundPreview } from "./cancellationRefundPreview.zod.js";
+import { Funds } from "./funds.zod.js";
 import { Money } from "./money.zod.js";
 import { OrderRefundQuote } from "./orderRefundQuote.zod.js";
 import { QuotedDiscount } from "./quotedDiscount.zod.js";
@@ -14,6 +15,7 @@ import { QuoteItem } from "./quoteItem.zod.js";
 import { QuoteRenewalResult } from "./quoteRenewalResult.zod.js";
 export const Quote = zod
     .strictObject({
+    funds: Funds.optional().describe("Account funding for an existing-order checkout quote. Absent for usage estimates, refunds and cancellation previews."),
     subtotal: Money,
     discount_amount: Money,
     tax_amount: Money,

package/package.json

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