@leaflow/sdk 0.127.0 → 0.128.0

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

@@ -891,7 +891,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2220,9 +2220,15 @@ export interface OrderItem {
     /** `gross_amount` less `discount_amount`. */
     amount?: Money;
     currency: string;
-    /** @nullable */
+    /**
+     * The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines.
+     * @nullable
+     */
     period_start?: string | null;
-    /** @nullable */
+    /**
+     * The end of that service period, exclusive.
+     * @nullable
+     */
     period_end?: string | null;
     status: OrderItemStatus;
 }

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

@@ -21,7 +21,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -65,8 +65,14 @@ export const OrderItem = zod
     discount_amount: Money.optional().describe("The reduction on this line: from the coupon the order uses and, for a renewal at the agreed terms,\nfrom the discount the subscription carries.\n\nA carried discount is part of the agreed amount. It is listed here, and `gross_amount` is then\n`unit_amount` times `quantity`, except in two cases where `gross_amount` is the agreed amount and\nthe carried discount is already reflected in it: the renewal order also uses a coupon the account\nholds, or the account's tax rate is inclusive."),
     amount: Money.optional().describe("`gross_amount` less `discount_amount`."),
     currency: zod.string(),
-    period_start: zod.iso.datetime({ offset: true }).nullish(),
-    period_end: zod.iso.datetime({ offset: true }).nullish(),
+    period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines."),
+    period_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The end of that service period, exclusive."),
     status: OrderItemStatus,
 })
     .describe("Frozen purchase terms. Monetary fields come from related invoice-line snapshots and are zero\nfor a line with no immediate charge, such as postpaid admission. Later catalog changes do not reprice this line. A new service\npurchase creates its pending subscription when this item is recorded, not when payment succeeds.");

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

@@ -607,8 +607,12 @@ export declare const getPayInvoiceUrl: (invoiceId: string) => string;
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
- * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
- * attempt is reused, and retries do not apply credit grants or balance twice.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -679,8 +683,9 @@ export declare const getPayTogetherUrl: () => string;
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
- * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1430,7 +1435,7 @@ export declare const getCancelOrderUrl: (orderId: string) => string;
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms

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

@@ -638,8 +638,12 @@ export const getPayInvoiceUrl = (invoiceId) => {
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
- * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
- * attempt is reused, and retries do not apply credit grants or balance twice.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -726,8 +730,9 @@ export const getPayTogetherUrl = () => {
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
- * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1578,7 +1583,7 @@ export const getCancelOrderUrl = (orderId) => {
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms

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

@@ -712,7 +712,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2091,9 +2091,15 @@ export interface OrderItem {
     /** `gross_amount` less `discount_amount`. */
     amount?: Money;
     currency: string;
-    /** @nullable */
+    /**
+     * The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines.
+     * @nullable
+     */
     period_start?: string | null;
-    /** @nullable */
+    /**
+     * The end of that service period, exclusive.
+     * @nullable
+     */
     period_end?: string | null;
     status: OrderItemStatus;
 }

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

@@ -334,8 +334,12 @@ export declare const DeletePaymentMethodParams: zod.ZodObject<{
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
- * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
- * attempt is reused, and retries do not apply credit grants or balance twice.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -396,8 +400,9 @@ export declare const PreviewInvoicePaymentQueryParams: zod.ZodObject<{
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
- * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -996,7 +1001,7 @@ export declare const GetOrderParams: zod.ZodObject<{
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms

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

@@ -389,8 +389,12 @@ export const DeletePaymentMethodParams = zod.strictObject({
  * `BILLING_CHANGE_NOT_INVOICED`.
  *
  * Returns a payment action when customer interaction is required. requires_action and processing
- * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved payment
- * attempt is reused, and retries do not apply credit grants or balance twice.
+ * do not mean paid; the invoice is marked paid after payment is confirmed. An unresolved online
+ * payment made with the same gateway, method and saved payment method is reused, and retries do not
+ * apply credit grants or balance twice. Paying any other way cancels that earlier online payment
+ * first; if the gateway had already collected it, the invoice is paid by it and nothing more is
+ * charged. One the gateway is still processing is refused with `BILLING_PAYMENT_PENDING` and
+ * `meta.transaction_id`; wait for its outcome.
  *
  * Calling this on an invoice that is already paid returns the existing payment result without
  * another charge. A void invoice is refused with `BILLING_INVOICE_NOT_PAYABLE`; the invoice of an
@@ -453,8 +457,9 @@ export const PreviewInvoicePaymentQueryParams = zod.strictObject({
  * Either every invoice is paid or none is. When the credit grants and balance cannot cover
  * them all, the request fails with `BILLING_INSUFFICIENT_FUNDS` and nothing is charged.
  * A total different from expected_amount fails with `BILLING_AMOUNT_CHANGED` and nothing is charged.
- * Invoices that are already paid are not charged again. An invoice with an online payment
- * still in progress is refused with `BILLING_PAYMENT_PENDING`, a void invoice with
+ * Invoices that are already paid are not charged again. An online payment started earlier for one
+ * of the invoices is canceled first; one the gateway is still processing is refused with
+ * `BILLING_PAYMENT_PENDING` and `meta.transaction_id`, a void invoice with
  * `BILLING_INVOICE_NOT_PAYABLE`, a deferred period-end change not yet due to be invoiced with
  * `BILLING_CHANGE_NOT_INVOICED`, an order that has failed or was canceled with
  * `BILLING_ORDER_FAILED` or `BILLING_ORDER_CANCELED`, and an order whose payment deadline has
@@ -1135,7 +1140,7 @@ export const GetOrderParams = zod.strictObject({
  * Payment may be absent, partial or complete. Once the order's terms are fixed, the selected items
  * keep their agreed amounts and discounts; credit notes reduce issued invoices, and collected amounts
  * are returned to their original payment sources. While the terms of a deferred order are not fixed,
- * the remaining items are priced again. External payment-method refunds can finish asynchronously.
+ * the remaining items are priced again. External payment-method refunds can finish asynchronously. An online payment still waiting for the payer is canceled with the order; one the gateway is already processing is refused with `BILLING_PAYMENT_PENDING` and `meta.transaction_id`.
  * The order and financial history are retained; the same cancellation does not refund twice.
  *
  * Once the order is accepted, its owning service coordinates cancellation and confirms

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

@@ -21,7 +21,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -65,8 +65,14 @@ export const OrderItem = zod
     discount_amount: Money.optional().describe("The reduction on this line: from the coupon the order uses and, for a renewal at the agreed terms,\nfrom the discount the subscription carries.\n\nA carried discount is part of the agreed amount. It is listed here, and `gross_amount` is then\n`unit_amount` times `quantity`, except in two cases where `gross_amount` is the agreed amount and\nthe carried discount is already reflected in it: the renewal order also uses a coupon the account\nholds, or the account's tax rate is inclusive."),
     amount: Money.optional().describe("`gross_amount` less `discount_amount`."),
     currency: zod.string(),
-    period_start: zod.iso.datetime({ offset: true }).nullish(),
-    period_end: zod.iso.datetime({ offset: true }).nullish(),
+    period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines."),
+    period_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The end of that service period, exclusive."),
     status: OrderItemStatus,
 })
     .describe("Frozen purchase terms. Monetary fields come from related invoice-line snapshots and are zero\nfor a line with no immediate charge, such as postpaid admission. Later catalog changes do not reprice this line. A new service\npurchase creates its pending subscription when this item is recorded, not when payment succeeds.");

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

@@ -1359,7 +1359,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2688,9 +2688,15 @@ export interface OrderItem {
     /** `gross_amount` less `discount_amount`. */
     amount?: Money;
     currency: string;
-    /** @nullable */
+    /**
+     * The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines.
+     * @nullable
+     */
     period_start?: string | null;
-    /** @nullable */
+    /**
+     * The end of that service period, exclusive.
+     * @nullable
+     */
     period_end?: string | null;
     status: OrderItemStatus;
 }

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

@@ -44,7 +44,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -88,8 +88,14 @@ export const OrderItem = zod
     discount_amount: Money.optional().describe("The reduction on this line: from the coupon the order uses and, for a renewal at the agreed terms,\nfrom the discount the subscription carries.\n\nA carried discount is part of the agreed amount. It is listed here, and `gross_amount` is then\n`unit_amount` times `quantity`, except in two cases where `gross_amount` is the agreed amount and\nthe carried discount is already reflected in it: the renewal order also uses a coupon the account\nholds, or the account's tax rate is inclusive."),
     amount: Money.optional().describe("`gross_amount` less `discount_amount`."),
     currency: zod.string(),
-    period_start: zod.iso.datetime({ offset: true }).nullish(),
-    period_end: zod.iso.datetime({ offset: true }).nullish(),
+    period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines."),
+    period_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The end of that service period, exclusive."),
     status: OrderItemStatus,
 })
     .describe("Frozen purchase terms. Monetary fields come from related invoice-line snapshots and are zero\nfor a line with no immediate charge, such as postpaid admission. Later catalog changes do not reprice this line. A new service\npurchase creates its pending subscription when this item is recorded, not when payment succeeds.");

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

@@ -3305,7 +3305,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -4634,9 +4634,15 @@ export interface OrderItem {
     /** `gross_amount` less `discount_amount`. */
     amount?: Money;
     currency: string;
-    /** @nullable */
+    /**
+     * The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines.
+     * @nullable
+     */
     period_start?: string | null;
-    /** @nullable */
+    /**
+     * The end of that service period, exclusive.
+     * @nullable
+     */
     period_end?: string | null;
     status: OrderItemStatus;
 }

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

@@ -37,7 +37,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -81,8 +81,14 @@ export const OrderItem = zod
     discount_amount: Money.optional().describe("The reduction on this line: from the coupon the order uses and, for a renewal at the agreed terms,\nfrom the discount the subscription carries.\n\nA carried discount is part of the agreed amount. It is listed here, and `gross_amount` is then\n`unit_amount` times `quantity`, except in two cases where `gross_amount` is the agreed amount and\nthe carried discount is already reflected in it: the renewal order also uses a coupon the account\nholds, or the account's tax rate is inclusive."),
     amount: Money.optional().describe("`gross_amount` less `discount_amount`."),
     currency: zod.string(),
-    period_start: zod.iso.datetime({ offset: true }).nullish(),
-    period_end: zod.iso.datetime({ offset: true }).nullish(),
+    period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines."),
+    period_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The end of that service period, exclusive."),
     status: OrderItemStatus,
 })
     .describe("Frozen purchase terms. Monetary fields come from related invoice-line snapshots and are zero\nfor a line with no immediate charge, such as postpaid admission. Later catalog changes do not reprice this line. A new service\npurchase creates its pending subscription when this item is recorded, not when payment succeeds.");

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

@@ -1180,7 +1180,7 @@ export interface AccountBalance {
      * spendable balance and may differ from the recorded credits total.
      */
     credit_groups: CreditGroup[];
-    /** Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
+    /** Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms. */
     due: Money;
     pending_returns_amount: Money;
 }
@@ -2509,9 +2509,15 @@ export interface OrderItem {
     /** `gross_amount` less `discount_amount`. */
     amount?: Money;
     currency: string;
-    /** @nullable */
+    /**
+     * The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines.
+     * @nullable
+     */
     period_start?: string | null;
-    /** @nullable */
+    /**
+     * The end of that service period, exclusive.
+     * @nullable
+     */
     period_end?: string | null;
     status: OrderItemStatus;
 }

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

@@ -21,7 +21,7 @@ export const AccountBalance = zod
     credit_groups: zod
         .array(CreditGroup)
         .describe("Currently valid, unspent credit grouped by permitted use. Restrictions and\nvalidity dates determine which charges a group can cover, so these groups are not a general\nspendable balance and may differ from the recorded credits total."),
-    due: Money.describe("Amount still payable on issued invoices. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
+    due: Money.describe("Amount still payable on issued invoices. The invoice of an order not yet accepted is a request to pay for that order rather than a debt, so it is excluded here and from available_credit. Unbilled usage is reported separately; arrears depend on actual eligible funding and grace terms."),
     pending_returns_amount: Money,
 })
     .describe("Account balance, credits, and unpaid charges are reported separately.");

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

@@ -65,8 +65,14 @@ export const OrderItem = zod
     discount_amount: Money.optional().describe("The reduction on this line: from the coupon the order uses and, for a renewal at the agreed terms,\nfrom the discount the subscription carries.\n\nA carried discount is part of the agreed amount. It is listed here, and `gross_amount` is then\n`unit_amount` times `quantity`, except in two cases where `gross_amount` is the agreed amount and\nthe carried discount is already reflected in it: the renewal order also uses a coupon the account\nholds, or the account's tax rate is inclusive."),
     amount: Money.optional().describe("`gross_amount` less `discount_amount`."),
     currency: zod.string(),
-    period_start: zod.iso.datetime({ offset: true }).nullish(),
-    period_end: zod.iso.datetime({ offset: true }).nullish(),
+    period_start: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The start of the service period this line paid for. Frozen at placement for renewals and period-end changes; for a prepaid line of a new purchase, fixed from the second its invoice is paid and kept when delivery is confirmed. Absent for postpaid and one-time lines."),
+    period_end: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("The end of that service period, exclusive."),
     status: OrderItemStatus,
 })
     .describe("Frozen purchase terms. Monetary fields come from related invoice-line snapshots and are zero\nfor a line with no immediate charge, such as postpaid admission. Later catalog changes do not reprice this line. A new service\npurchase creates its pending subscription when this item is recorded, not when payment succeeds.");

package/package.json

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