@leaflow/sdk 0.125.1 → 0.127.0

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

@@ -11,7 +11,7 @@ export const getListPlansUrl = (params) => {
         : `https://membership.leaflow.cloud/api/v1/plans`;
 };
 /**
- * Lists the plans on sale, in ascending rank, with their prices and benefits. No authentication is required.
+ * Lists tiers on sale with prices and benefits, ordered by rank.
  * @summary List plans
  */
 export const listPlans = async (params, options, fetchFn) => {
@@ -36,7 +36,7 @@ export const getGetPlanUrl = (planId, params) => {
         : `https://membership.leaflow.cloud/api/v1/plans/${encodeURIComponent(String(planId))}`;
 };
 /**
- * Returns a plan on sale with its prices and benefits. No authentication is required.
+ * Returns a tier on sale with its prices and benefits.
  * @summary Get a plan
  */
 export const getPlan = async (planId, params, options, fetchFn) => {
@@ -61,7 +61,7 @@ export const getListMembershipsUrl = (params) => {
         : `https://membership.leaflow.cloud/api/v1/memberships`;
 };
 /**
- * Lists the memberships of a billing account you own, newest first, including ended ones.
+ * Lists memberships of the specified account, including ended memberships, newest first.
  * @summary List memberships
  */
 export const listMemberships = async (params, options, fetchFn) => {
@@ -77,10 +77,7 @@ export const getCreateMembershipUrl = () => {
     return `https://membership.leaflow.cloud/api/v1/memberships`;
 };
 /**
- * Places a Billing order for the plan's price on a billing account you own, and returns the pending membership with the order.
- * The membership becomes active, and its first period's benefits are issued, once Billing reports the order ready.
- *
- * Fails with 409 `MEMBERSHIP_EXISTS` when the account already has a pending or active membership, and with 422 `MEMBERSHIP_PLAN_UNAVAILABLE` when the plan is not on sale or has no price or credit in the account's currency. Billing refusals, such as `BILLING_INSUFFICIENT_FUNDS`, are returned as Billing reports them.
+ * Places a purchase order and returns the membership and invoice. Activation follows successful benefit issuance and delivery confirmation. Returns 409 MEMBERSHIP_EXISTS or 422 MEMBERSHIP_PLAN_UNAVAILABLE.
  * @summary Buy a membership
  */
 export const createMembership = async (membershipCreate, options, fetchFn) => {
@@ -137,7 +134,7 @@ export const getListMembershipPeriodsUrl = (membershipId, params) => {
         : `https://membership.leaflow.cloud/api/v1/memberships/${encodeURIComponent(String(membershipId))}/periods`;
 };
 /**
- * Lists the paid periods of a membership, newest first, each with the benefits issued for it.
+ * Lists fulfilled periods and their grants, newest first.
  * @summary List membership periods
  */
 export const listMembershipPeriods = async (membershipId, params, options, fetchFn) => {
@@ -153,9 +150,7 @@ export const getUpgradeMembershipUrl = (membershipId) => {
     return `https://membership.leaflow.cloud/api/v1/memberships/${encodeURIComponent(String(membershipId))}/upgrade`;
 };
 /**
- * Places a Billing order for the full difference between the current and the chosen plan's period prices. Once Billing reports it ready, the membership moves to the chosen plan for the rest of the period: the difference in credit is issued and the new plan's discount and allowances apply. Renewals are charged at the chosen plan's price.
- *
- * Fails with 409 `MEMBERSHIP_NOT_ACTIVE` unless the membership is active, and with 422 `MEMBERSHIP_UPGRADE_UNAVAILABLE` when the chosen plan does not rank above the current one or no upgrade is priced in the account's currency. A pending upgrade or a scheduled downgrade must finish or be canceled first (409 `MEMBERSHIP_CHANGE_PENDING`).
+ * Places an order for the full-period price difference. The upgrade takes effect after benefit issuance and delivery confirmation; renewal uses the target tier. Returns 409 MEMBERSHIP_NOT_ACTIVE or MEMBERSHIP_CHANGE_PENDING, or 422 MEMBERSHIP_UPGRADE_UNAVAILABLE.
  * @summary Upgrade a membership
  */
 export const upgradeMembership = async (membershipId, membershipUpgrade, options, fetchFn) => {
@@ -188,9 +183,7 @@ export const getScheduleMembershipDowngradeUrl = (membershipId) => {
     return `https://membership.leaflow.cloud/api/v1/memberships/${encodeURIComponent(String(membershipId))}/downgrade`;
 };
 /**
- * Schedules a move to a lower-ranked plan at the end of the paid period. Nothing is charged or refunded and the current period keeps its benefits. The membership's `scheduled_plan` shows the pending move.
- *
- * Fails with 409 `MEMBERSHIP_NOT_ACTIVE` unless the membership is active, 409 `MEMBERSHIP_CHANGE_PENDING` while another change is pending, and 422 `MEMBERSHIP_DOWNGRADE_INVALID` when the chosen plan does not rank below the current one or has no price in the account's currency for the membership's billing interval.
+ * Schedules a lower tier for the next period. Current benefits remain valid. Returns 409 MEMBERSHIP_NOT_ACTIVE or MEMBERSHIP_CHANGE_PENDING, or 422 MEMBERSHIP_DOWNGRADE_INVALID.
  * @summary Schedule a downgrade
  */
 export const scheduleMembershipDowngrade = async (membershipId, membershipDowngrade, options, fetchFn) => {
@@ -223,7 +216,7 @@ export const getCancelMembershipDowngradeUrl = (membershipId) => {
     return `https://membership.leaflow.cloud/api/v1/memberships/${encodeURIComponent(String(membershipId))}/downgrade`;
 };
 /**
- * Keeps the current plan at renewal. Fails with 409 `MEMBERSHIP_CHANGE_PENDING` when no downgrade is scheduled.
+ * Cancels the scheduled downgrade. Returns 409 MEMBERSHIP_CHANGE_PENDING if none is scheduled.
  * @summary Cancel a scheduled downgrade
  */
 export const cancelMembershipDowngrade = async (membershipId, options, fetchFn) => {

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

@@ -2,22 +2,7 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Membership API
- * Membership plans and the memberships held by billing accounts.
- *
- * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
- *
- * ## Authentication
- *
- * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
- *
- * ## Conventions
- *
- * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
- * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
- * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
- * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
- * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
- * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * Membership tiers and account memberships. Catalog queries support any configured currency; purchases use the billing account currency.
  * OpenAPI spec version: 1.0.0
  */
 /**
@@ -58,7 +43,7 @@ export interface PlanSummary {
     id: string;
     lookup_key: string;
     name: string;
-    /** Higher ranks are higher plans. Upgrades move up and downgrades move down. */
+    /** Higher values mean higher tiers. Upgrades move up and downgrades move down. */
     rank: number;
 }
 export type PlanPriceInterval = (typeof PlanPriceInterval)[keyof typeof PlanPriceInterval];
@@ -94,7 +79,7 @@ export interface NamedIdentity {
     name: string;
 }
 /**
- * Credit issued for each period in one currency. It never pays for memberships.
+ * Credit granted for each period.
  */
 export interface CreditBenefit {
     currency: Currency;
@@ -102,7 +87,7 @@ export interface CreditBenefit {
     /** The services and plans the credit can pay for. */
     applies_to: NamedIdentity;
     /**
-     * Days the credit can be used from issue. Null means it does not expire.
+     * Credit validity in days; null means no expiry.
      * @minimum 1
      * @nullable
      */
@@ -116,28 +101,28 @@ export declare const DiscountBenefitCouponType: {
     readonly free_setup: "free_setup";
 };
 /**
- * A Billing coupon the account holds during each period. Every type applies to purchases within its scope; a percentage coupon also reduces metered usage. Only one coupon applies to a purchase or a usage charge, the one that saves the most.
+ * A Billing coupon held during each period.
  */
 export interface DiscountBenefit {
     name: string;
     coupon_type: DiscountBenefitCouponType;
     /**
-     * Decimal string for a percentage coupon, such as "10" for ten per cent; null for other types.
+     * Percentage discount; null for other coupon types.
      * @nullable
      */
     percent_off: string | null;
-    /** The services and plans the coupon applies to. Null means every service other than memberships. */
+    /** Coupon applicability; null means unrestricted. */
     applies_to: NamedIdentity | null;
 }
 /**
- * A Leaflow service, such as compute or canopy.
+ * A Leaflow service.
  */
 export interface ProductIdentity {
     id: string;
     name: string;
 }
 /**
- * Access to a feature of a service for every project of the account during each period.
+ * Account-level feature access for each period.
  */
 export interface FeatureBenefit {
     product: ProductIdentity;
@@ -145,22 +130,22 @@ export interface FeatureBenefit {
     name: string;
 }
 /**
- * Exact dimension values the allowance is limited to, such as a model. Empty means every usage of the meter.
+ * Meter dimension selectors; empty means unrestricted usage.
  */
 export type AllowanceBenefitDimensions = {
     [key: string]: string;
 };
 /**
- * Usage of a service included in each period. Usage with the listed dimension values draws from it before it is charged.
+ * Metered usage included in each period.
  */
 export interface AllowanceBenefit {
     product: ProductIdentity;
     meter_id: string;
     meter_name: string;
     unit: string;
-    /** Decimal string in the meter's unit. */
+    /** Quantity in the meter's unit. */
     quantity: string;
-    /** Exact dimension values the allowance is limited to, such as a model. Empty means every usage of the meter. */
+    /** Meter dimension selectors; empty means unrestricted usage. */
     dimensions: AllowanceBenefitDimensions;
 }
 export type BenefitType = (typeof BenefitType)[keyof typeof BenefitType];
@@ -171,7 +156,7 @@ export declare const BenefitType: {
     readonly feature: "feature";
 };
 /**
- * One benefit of a plan. Exactly the object named by type is present.
+ * Exactly one benefit object matching type.
  */
 export interface Benefit {
     id: string;
@@ -186,7 +171,7 @@ export interface Plan {
     lookup_key: string;
     name: string;
     description: string;
-    /** Higher ranks are higher plans. */
+    /** Higher values mean higher tiers. */
     rank: number;
     prices: PlanPrice[];
     benefits: Benefit[];
@@ -214,7 +199,7 @@ export declare const GrantType: {
     readonly feature: "feature";
 };
 /**
- * revoked means it was withdrawn before the period ended; what had been used is kept.
+ * Revocation withdraws unused benefits.
  */
 export type GrantStatus = (typeof GrantStatus)[keyof typeof GrantStatus];
 export declare const GrantStatus: {
@@ -222,13 +207,13 @@ export declare const GrantStatus: {
     readonly revoked: "revoked";
 };
 /**
- * A benefit issued for a period, with the terms it was issued on. The Billing resource is listed in Billing.
+ * A benefit grant with frozen terms and Billing resource identifiers.
  */
 export interface Grant {
     id: string;
     benefit_id: string;
     type: GrantType;
-    /** revoked means it was withdrawn before the period ended; what had been used is kept. */
+    /** Revocation withdraws unused benefits. */
     status: GrantStatus;
     credit?: CreditBenefit;
     discount?: DiscountBenefit;
@@ -245,7 +230,7 @@ export interface Grant {
     issued_at: string;
 }
 /**
- * A paid period of a membership.
+ * A fulfilled membership period.
  */
 export interface Period {
     id: string;
@@ -261,7 +246,7 @@ export interface PeriodList {
     pagination: OffsetPagination;
 }
 /**
- * pending until Billing reports the first order ready; active while paid; ended afterwards.
+ * Pending until delivery is confirmed; active afterwards; ended when terminated.
  */
 export type MembershipStatus = (typeof MembershipStatus)[keyof typeof MembershipStatus];
 export declare const MembershipStatus: {
@@ -270,10 +255,7 @@ export declare const MembershipStatus: {
     readonly ended: "ended";
 };
 /**
- * canceled: the subscription was canceled and the paid period ended.
- * reclaimed: Billing reclaimed the subscription after non-payment.
- * revoked: an operator ended the membership.
- * abandoned: the first order was canceled or expired before payment.
+ * Cancellation, reclamation, operator revocation, or an unfulfilled first order.
  * @nullable
  */
 export type MembershipEndedReason = (typeof MembershipEndedReason)[keyof typeof MembershipEndedReason] | null;
@@ -287,24 +269,21 @@ export interface Membership {
     id: string;
     billing_account_id: number;
     plan: PlanSummary;
-    /** pending until Billing reports the first order ready; active while paid; ended afterwards. */
+    /** Pending until delivery is confirmed; active afterwards; ended when terminated. */
     status: MembershipStatus;
     /**
-     * canceled: the subscription was canceled and the paid period ended.
-     * reclaimed: Billing reclaimed the subscription after non-payment.
-     * revoked: an operator ended the membership.
-     * abandoned: the first order was canceled or expired before payment.
+     * Cancellation, reclamation, operator revocation, or an unfulfilled first order.
      * @nullable
      */
     ended_reason: MembershipEndedReason;
     /**
-     * The Billing subscription. Cancel it or change auto-renewal in Billing. Null until Billing reports the first order ready.
+     * Billing subscription ID; null until activation.
      * @nullable
      */
     subscription_id: string | null;
-    /** The period in effect now. Null when the membership is pending or ended. */
+    /** Current fulfilled period; null while pending or ended. */
     current_period: Period | null;
-    /** The plan a scheduled downgrade moves to at the end of the paid period. */
+    /** The scheduled downgrade target. */
     scheduled_plan: PlanSummary | null;
     created_at: string;
     /** @nullable */
@@ -381,7 +360,7 @@ export interface PlacedOrder {
     invoice: InvoiceSummary;
 }
 /**
- * The membership and the Billing order placed for it.
+ * The membership and its Billing purchase order.
  */
 export interface MembershipPurchase {
     membership: Membership;
@@ -421,17 +400,17 @@ export interface MembershipCreate {
     /** @minimum 1 */
     billing_account_id: number;
     plan_id: string;
-    /** One of the plan's prices in the account's currency. It sets the billing interval. */
+    /** A tier price matching the account currency and chosen billing interval. */
     price_id: string;
     checkout?: CheckoutOptions;
 }
 export interface MembershipUpgrade {
-    /** A plan ranked above the current one. */
+    /** A higher-ranked target tier. */
     plan_id: string;
     checkout?: CheckoutOptions;
 }
 export interface MembershipDowngrade {
-    /** A plan ranked below the current one, priced for the membership's billing interval in the account's currency. */
+    /** A lower-ranked tier supporting the account currency and billing interval. */
     plan_id: string;
 }
 /**
@@ -3186,13 +3165,47 @@ export interface StatementAmounts {
     tax_amount: Money;
     total: Money;
 }
+/**
+ * One billing account's usage billing for one UTC calendar month, summed over the month's statements. It is a summary, not something to pay; each closing's invoice is collected on its own.
+ */
+export interface MonthlyStatement {
+    billing_account_id: number;
+    currency: string;
+    period_start: string;
+    period_end: string;
+    /** True after the period's final closing, which applies minimum charges for the whole month. Usage priced later is still billed in supplement statements and added here. */
+    finalized: boolean;
+    finalized_at?: string;
+    /** Statements of the period, including the open one. */
+    statement_count: number;
+    billed: StatementAmounts;
+    credited_amount: Money;
+    unbilled?: StatementAmounts;
+    credit_applied: Money;
+    amount_paid: Money;
+    amount_due: Money;
+    amount_refunded: Money;
+}
+export interface MonthlyStatementList {
+    items: MonthlyStatement[];
+    pagination: OffsetPagination;
+}
 export type StatementStatus = (typeof StatementStatus)[keyof typeof StatementStatus];
 export declare const StatementStatus: {
     readonly open: "open";
     readonly closed: "closed";
 };
 /**
- * An account's consumption for one billing period, collected at one closing. The first statement of a period (sequence 1) closes after the period ends. Usage priced after that closing is collected in a later statement for the same period, which closes and invoices separately; a closed statement is never rewritten. Payments apply to issued invoices.
+ * interim: a closing before the period's usage is final; minimum charges are not applied. final: the first closing after the period ended and its late usage was settled; minimum charges for the whole period are applied. supplement: a closing after the final one, for usage priced late. An open statement is interim.
+ */
+export type StatementType = (typeof StatementType)[keyof typeof StatementType];
+export declare const StatementType: {
+    readonly interim: "interim";
+    readonly final: "final";
+    readonly supplement: "supplement";
+};
+/**
+ * An account's consumption for one billing period, collected at one closing. Usage is billed after every settlement run, about hourly; each closing issues an invoice for the usage priced since the previous closing and collects it from credits and balance at once, and later usage is collected in the next statement of the same period. A closed statement is never rewritten. The period's consumption is the sum of its statements.
  */
 export interface Statement {
     id: string;
@@ -3200,10 +3213,11 @@ export interface Statement {
     currency: string;
     period_start: string;
     period_end: string;
-    /** 1 for the first closing of the period; higher for statements that collect usage priced after an earlier closing. */
+    /** Increases with each closing of the period. */
     sequence: number;
     status: StatementStatus;
-    /** True while the statement is open. The estimate applies tier pricing to the period's usage so far and adds tax for the current invoice contact. Minimum charges are added at closing, and a tier reduction larger than this statement's own charges is credited to earlier invoices of the period at closing. */
+    type: StatementType;
+    /** True while the statement is open. The estimate applies tier pricing to the period's usage so far and adds tax for the current invoice contact. Minimum charges are added at the period's final closing, and a tier reduction larger than this statement's own charges is credited to earlier invoices of the period at closing. */
     estimated: boolean;
     amounts: StatementAmounts;
     closed_at?: string;
@@ -3247,7 +3261,7 @@ export interface StatementSummary {
  */
 export type ErrorResponse = Error;
 /**
- * A billing account you own.
+ * The account to query.
  */
 export type BillingAccountIdQueryParameter = number;
 export type ListPlansParams = {
@@ -3264,13 +3278,13 @@ export type ListPlansParams = {
      */
     page_size?: number;
     /**
-     * Restricts prices and currency-specific benefits to this currency. All currencies are returned while it is absent.
+     * Filters prices and currency-specific benefits. Any configured currency is allowed; omit to return all currencies.
      */
     currency?: Currency;
 };
 export type GetPlanParams = {
     /**
-     * Restricts prices and currency-specific benefits to this currency.
+     * Filters prices and currency-specific benefits. Any configured currency is allowed; omit to return all currencies.
      */
     currency?: Currency;
 };
@@ -3288,7 +3302,7 @@ export type ListMembershipsParams = {
      */
     page_size?: number;
     /**
-     * A billing account you own.
+     * The account to query.
      * @minimum 1
      */
     billing_account_id: BillingAccountIdQueryParameter;

package/dist/membership/v1/generated/models.js

@@ -393,6 +393,11 @@ export const StatementStatus = {
     open: "open",
     closed: "closed",
 };
+export const StatementType = {
+    interim: "interim",
+    final: "final",
+    supplement: "supplement",
+};
 export const StatementSummaryGroupBy = {
     project: "project",
     product: "product",

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

@@ -2,27 +2,12 @@
  * Generated by orval 🍺
  * Do not edit manually.
  * Leaflow Membership API
- * Membership plans and the memberships held by billing accounts.
- *
- * A membership is a prepaid subscription sold through Billing. For each paid period it issues the plan's benefits to the billing account. A plan can carry several benefits across services: credit for chosen services, coupons on purchases and metered usage, and usage allowances such as model tokens, and access to features of other services. Benefits are shared by every project paid for by the account.
- *
- * ## Authentication
- *
- * Plans are public. Memberships require an access token; see the `accessTokenAuth` security scheme. Only the owner of a billing account can read or change its membership; anyone else receives 403 `MEMBERSHIP_ACCOUNT_FORBIDDEN`.
- *
- * ## Conventions
- *
- * - **One membership per billing account.** A pending or active membership must end before another is bought; change plans with upgrade and downgrade instead.
- * - **Payment goes through Billing.** Purchases and upgrades return a Billing order. With `checkout.mode` `deferred`, pay the order's invoice through Billing. Benefits are issued once Billing reports the order ready; every order has an invoice, including a zero-total one, which is paid automatically.
- * - **Cancellation and auto-renewal are managed in Billing** on the membership's `subscription_id`. A cancellation takes effect at the end of the paid period without a refund, and the period's benefits remain until then.
- * - **An upgrade takes effect immediately** for the full difference between the two plans' period prices, whatever remains of the period. The difference in credit is issued in full and the new plan's discount applies from payment. Renewals are charged at the new plan's price.
- * - **A downgrade takes effect at the end of the paid period.** The current period keeps its benefits and nothing is refunded.
- * - **Amounts are decimal strings** in the billing account's currency. There is no currency conversion: a plan without a price or credit in the account's currency cannot be bought with it.
+ * 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";
 /**
- * Lists the plans on sale, in ascending rank, with their prices and benefits. No authentication is required.
+ * Lists tiers on sale with prices and benefits, ordered by rank.
  * @summary List plans
  */
 export declare const listPlansQueryPageDefault = 1;
@@ -36,7 +21,7 @@ export declare const ListPlansQueryParams: zod.ZodObject<{
     currency: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
- * Returns a plan on sale with its prices and benefits. No authentication is required.
+ * Returns a tier on sale with its prices and benefits.
  * @summary Get a plan
  */
 export declare const GetPlanParams: zod.ZodObject<{
@@ -47,7 +32,7 @@ export declare const GetPlanQueryParams: zod.ZodObject<{
     currency: zod.ZodOptional<zod.ZodString>;
 }, zod.z.core.$strict>;
 /**
- * Lists the memberships of a billing account you own, newest first, including ended ones.
+ * Lists memberships of the specified account, including ended memberships, newest first.
  * @summary List memberships
  */
 export declare const listMembershipsQueryPageDefault = 1;
@@ -60,10 +45,7 @@ export declare const ListMembershipsQueryParams: zod.ZodObject<{
     billing_account_id: zod.ZodInt;
 }, zod.z.core.$strict>;
 /**
- * Places a Billing order for the plan's price on a billing account you own, and returns the pending membership with the order.
- * The membership becomes active, and its first period's benefits are issued, once Billing reports the order ready.
- *
- * Fails with 409 `MEMBERSHIP_EXISTS` when the account already has a pending or active membership, and with 422 `MEMBERSHIP_PLAN_UNAVAILABLE` when the plan is not on sale or has no price or credit in the account's currency. Billing refusals, such as `BILLING_INSUFFICIENT_FUNDS`, are returned as Billing reports them.
+ * Places a purchase order and returns the membership and invoice. Activation follows successful benefit issuance and delivery confirmation. Returns 409 MEMBERSHIP_EXISTS or 422 MEMBERSHIP_PLAN_UNAVAILABLE.
  * @summary Buy a membership
  */
 export declare const CreateMembershipBody: zod.ZodObject<{
@@ -85,7 +67,7 @@ export declare const GetMembershipParams: zod.ZodObject<{
     membershipId: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
- * Lists the paid periods of a membership, newest first, each with the benefits issued for it.
+ * Lists fulfilled periods and their grants, newest first.
  * @summary List membership periods
  */
 export declare const ListMembershipPeriodsParams: zod.ZodObject<{
@@ -100,9 +82,7 @@ export declare const ListMembershipPeriodsQueryParams: zod.ZodObject<{
     page_size: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 /**
- * Places a Billing order for the full difference between the current and the chosen plan's period prices. Once Billing reports it ready, the membership moves to the chosen plan for the rest of the period: the difference in credit is issued and the new plan's discount and allowances apply. Renewals are charged at the chosen plan's price.
- *
- * Fails with 409 `MEMBERSHIP_NOT_ACTIVE` unless the membership is active, and with 422 `MEMBERSHIP_UPGRADE_UNAVAILABLE` when the chosen plan does not rank above the current one or no upgrade is priced in the account's currency. A pending upgrade or a scheduled downgrade must finish or be canceled first (409 `MEMBERSHIP_CHANGE_PENDING`).
+ * Places an order for the full-period price difference. The upgrade takes effect after benefit issuance and delivery confirmation; renewal uses the target tier. Returns 409 MEMBERSHIP_NOT_ACTIVE or MEMBERSHIP_CHANGE_PENDING, or 422 MEMBERSHIP_UPGRADE_UNAVAILABLE.
  * @summary Upgrade a membership
  */
 export declare const UpgradeMembershipParams: zod.ZodObject<{
@@ -119,9 +99,7 @@ export declare const UpgradeMembershipBody: zod.ZodObject<{
     }, zod.z.core.$strict>>;
 }, zod.z.core.$strict>;
 /**
- * Schedules a move to a lower-ranked plan at the end of the paid period. Nothing is charged or refunded and the current period keeps its benefits. The membership's `scheduled_plan` shows the pending move.
- *
- * Fails with 409 `MEMBERSHIP_NOT_ACTIVE` unless the membership is active, 409 `MEMBERSHIP_CHANGE_PENDING` while another change is pending, and 422 `MEMBERSHIP_DOWNGRADE_INVALID` when the chosen plan does not rank below the current one or has no price in the account's currency for the membership's billing interval.
+ * Schedules a lower tier for the next period. Current benefits remain valid. Returns 409 MEMBERSHIP_NOT_ACTIVE or MEMBERSHIP_CHANGE_PENDING, or 422 MEMBERSHIP_DOWNGRADE_INVALID.
  * @summary Schedule a downgrade
  */
 export declare const ScheduleMembershipDowngradeParams: zod.ZodObject<{
@@ -131,7 +109,7 @@ export declare const ScheduleMembershipDowngradeBody: zod.ZodObject<{
     plan_id: zod.ZodUUID;
 }, zod.z.core.$strict>;
 /**
- * Keeps the current plan at renewal. Fails with 409 `MEMBERSHIP_CHANGE_PENDING` when no downgrade is scheduled.
+ * Cancels the scheduled downgrade. Returns 409 MEMBERSHIP_CHANGE_PENDING if none is scheduled.
  * @summary Cancel a scheduled downgrade
  */
 export declare const CancelMembershipDowngradeParams: zod.ZodObject<{