autumn-js 1.2.49 → 1.2.51

package/dist/backend/{routeTypes-NNlpTwza.d.ts → routeTypes-CY41TUL_.d.ts}

@@ -1,4 +1,4 @@
-import { b as ClosedEnum, O as OpenEnum, c as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-COW88tnI.js';
+import { b as ClosedEnum, O as OpenEnum, c as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-BPv82hMB.js';
 import { z } from 'zod/v4';
 import { ProtectedBodyField } from './core/utils/sanitizeBody.js';
 import { BackendResult } from './core/types/responseTypes.js';
@@ -2032,6 +2032,10 @@ type Breakdown = {
     expiresAt: number | null;
 };
 type BalanceRollover = {
+    /**
+     * Amount originally rolled over from a previous period, before any of it was consumed.
+     */
+    granted: number;
     /**
      * Amount of balance rolled over from a previous period.
      */
@@ -6435,7 +6439,7 @@ type PlanVariantDetailsBillingControls = {
 /**
  * The customization that transforms the base plan into this variant.
  */
-type Customize = {
+type Customize1 = {
     /**
      * Override the base price of the plan. Pass null to remove the base price.
      */
@@ -6468,7 +6472,7 @@ type VariantDetails = {
     /**
      * The customization that transforms the base plan into this variant.
      */
-    customize?: Customize | undefined;
+    customize?: Customize1 | undefined;
 };
 /**
  * Miscellaneous plan-level configuration flags.
@@ -10015,36 +10019,36 @@ type CreateReferralCodeResponse = {
 /**
  * When the reward is granted: on redemption, or when the redeemer checks out.
  */
-declare const RedeemOnRequest: {
+declare const CreateReferralProgramRedeemOnRequest: {
     readonly CustomerCreation: "customer_creation";
     readonly Checkout: "checkout";
 };
 /**
  * When the reward is granted: on redemption, or when the redeemer checks out.
  */
-type RedeemOnRequest = ClosedEnum<typeof RedeemOnRequest>;
+type CreateReferralProgramRedeemOnRequest = ClosedEnum<typeof CreateReferralProgramRedeemOnRequest>;
 /**
  * Who receives the reward: the referrer only, or both parties.
  */
-declare const ReceivedByRequest: {
+declare const CreateReferralProgramReceivedByRequest: {
     readonly Referrer: "referrer";
     readonly All: "all";
 };
 /**
  * Who receives the reward: the referrer only, or both parties.
  */
-type ReceivedByRequest = ClosedEnum<typeof ReceivedByRequest>;
+type CreateReferralProgramReceivedByRequest = ClosedEnum<typeof CreateReferralProgramReceivedByRequest>;
 type CreateReferralProgramParams = {
     id: string;
     rewardId: string;
     /**
      * When the reward is granted: on redemption, or when the redeemer checks out.
      */
-    redeemOn: RedeemOnRequest;
+    redeemOn: CreateReferralProgramRedeemOnRequest;
     /**
      * Who receives the reward: the referrer only, or both parties.
      */
-    receivedBy: ReceivedByRequest;
+    receivedBy: CreateReferralProgramReceivedByRequest;
     /**
      * A positive redemption limit, or null for unlimited redemptions.
      */
@@ -10061,25 +10065,25 @@ type CreateReferralProgramParams = {
 /**
  * When the reward is granted: on redemption, or when the redeemer checks out.
  */
-declare const RedeemOnResponse: {
+declare const CreateReferralProgramRedeemOnResponse: {
     readonly CustomerCreation: "customer_creation";
     readonly Checkout: "checkout";
 };
 /**
  * When the reward is granted: on redemption, or when the redeemer checks out.
  */
-type RedeemOnResponse = OpenEnum<typeof RedeemOnResponse>;
+type CreateReferralProgramRedeemOnResponse = OpenEnum<typeof CreateReferralProgramRedeemOnResponse>;
 /**
  * Who receives the reward: the referrer only, or both parties.
  */
-declare const ReceivedByResponse: {
+declare const CreateReferralProgramReceivedByResponse: {
     readonly Referrer: "referrer";
     readonly All: "all";
 };
 /**
  * Who receives the reward: the referrer only, or both parties.
  */
-type ReceivedByResponse = OpenEnum<typeof ReceivedByResponse>;
+type CreateReferralProgramReceivedByResponse = OpenEnum<typeof CreateReferralProgramReceivedByResponse>;
 /**
  * OK
  */
@@ -10095,11 +10099,11 @@ type CreateReferralProgramResponse = {
     /**
      * When the reward is granted: on redemption, or when the redeemer checks out.
      */
-    redeemOn: RedeemOnResponse;
+    redeemOn: CreateReferralProgramRedeemOnResponse;
     /**
      * Who receives the reward: the referrer only, or both parties.
      */
-    receivedBy: ReceivedByResponse;
+    receivedBy: CreateReferralProgramReceivedByResponse;
     /**
      * The maximum number of times a referral code can be redeemed.
      */
@@ -10168,7 +10172,7 @@ type CreateRewardCouponRequest = {
 /**
  * The unit of time the grant lasts.
  */
-declare const ExpiryTypeRequestBody: {
+declare const CreateRewardExpiryTypeRequestBody: {
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
@@ -10177,12 +10181,12 @@ declare const ExpiryTypeRequestBody: {
 /**
  * The unit of time the grant lasts.
  */
-type ExpiryTypeRequestBody = ClosedEnum<typeof ExpiryTypeRequestBody>;
-type ExpiryRequest = {
+type CreateRewardExpiryTypeRequestBody = ClosedEnum<typeof CreateRewardExpiryTypeRequestBody>;
+type CreateRewardExpiryRequest = {
     /**
      * The unit of time the grant lasts.
      */
-    type: ExpiryTypeRequestBody;
+    type: CreateRewardExpiryTypeRequestBody;
     /**
      * The positive integer count of periods before the grant expires.
      */
@@ -10191,10 +10195,10 @@ type ExpiryRequest = {
 type CreateRewardGrant = {
     featureId: string;
     /**
-     * A positive amount to grant, or null for boolean features.
+     * A non-negative amount to grant, or null for boolean features.
      */
     included: number | null;
-    expiry: ExpiryRequest | null;
+    expiry: CreateRewardExpiryRequest | null;
 };
 type CreateRewardFeatureGrantPromoCode = {
     code: string;
@@ -10486,6 +10490,845 @@ declare const CreateScheduleBillingBehavior: {
  * Whether to prorate the immediate phase. 'none' skips proration charges and credits.
  */
 type CreateScheduleBillingBehavior = ClosedEnum<typeof CreateScheduleBillingBehavior>;
+/**
+ * Quantity configuration for a prepaid feature.
+ */
+type UnscheduledPlanFeatureQuantity = {
+    /**
+     * The ID of the feature to set quantity for.
+     */
+    featureId: string;
+    /**
+     * The quantity of the feature.
+     */
+    quantity?: number | undefined;
+    /**
+     * Whether the customer can adjust the quantity.
+     */
+    adjustable?: boolean | undefined;
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+declare const PriceUnscheduledPlanInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval (e.g. 'month', 'year').
+ */
+type PriceUnscheduledPlanInterval = ClosedEnum<typeof PriceUnscheduledPlanInterval>;
+type UnscheduledPlanAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+/**
+ * Base price configuration for a plan.
+ */
+type UnscheduledPlanBasePrice = {
+    /**
+     * Base price amount for the plan.
+     */
+    amount: number;
+    /**
+     * Billing interval (e.g. 'month', 'year').
+     */
+    interval: PriceUnscheduledPlanInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<UnscheduledPlanAdditionalCurrency> | undefined;
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+declare const UnscheduledPlanItemResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type UnscheduledPlanItemResetInterval = ClosedEnum<typeof UnscheduledPlanItemResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type UnscheduledPlanItemReset = {
+    /**
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+     */
+    interval: UnscheduledPlanItemResetInterval;
+    /**
+     * Number of intervals between resets. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+};
+type UnscheduledPlanItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type UnscheduledPlanItemTierAdditionalCurrency = {
+    currency?: any | undefined;
+    amount?: any | undefined;
+    flatAmount?: any | undefined;
+};
+type UnscheduledPlanItemTier = {
+    to: number | string;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<UnscheduledPlanItemTierAdditionalCurrency> | undefined;
+};
+declare const UnscheduledPlanItemTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
+};
+type UnscheduledPlanItemTierBehavior = ClosedEnum<typeof UnscheduledPlanItemTierBehavior>;
+/**
+ * Billing interval. For consumable features, should match reset.interval.
+ */
+declare const UnscheduledPlanItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval. For consumable features, should match reset.interval.
+ */
+type UnscheduledPlanItemPriceInterval = ClosedEnum<typeof UnscheduledPlanItemPriceInterval>;
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+declare const UnscheduledPlanItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+type UnscheduledPlanItemBillingMethod = ClosedEnum<typeof UnscheduledPlanItemBillingMethod>;
+/**
+ * Pricing for usage beyond included units. Omit for free features.
+ */
+type UnscheduledPlanItemPrice = {
+    /**
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
+     */
+    amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<UnscheduledPlanItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<UnscheduledPlanItemTier> | undefined;
+    tierBehavior?: UnscheduledPlanItemTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: UnscheduledPlanItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: UnscheduledPlanItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | undefined;
+};
+/**
+ * Billing behavior when quantity increases mid-cycle.
+ */
+declare const UnscheduledPlanItemOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
+};
+/**
+ * Billing behavior when quantity increases mid-cycle.
+ */
+type UnscheduledPlanItemOnIncrease = ClosedEnum<typeof UnscheduledPlanItemOnIncrease>;
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+declare const UnscheduledPlanItemOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
+};
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+type UnscheduledPlanItemOnDecrease = ClosedEnum<typeof UnscheduledPlanItemOnDecrease>;
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type UnscheduledPlanItemProration = {
+    /**
+     * Billing behavior when quantity increases mid-cycle.
+     */
+    onIncrease: UnscheduledPlanItemOnIncrease;
+    /**
+     * Credit behavior when quantity decreases mid-cycle.
+     */
+    onDecrease: UnscheduledPlanItemOnDecrease;
+};
+/**
+ * When rolled over units expire.
+ */
+declare const UnscheduledPlanItemExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
+};
+/**
+ * When rolled over units expire.
+ */
+type UnscheduledPlanItemExpiryDurationType = ClosedEnum<typeof UnscheduledPlanItemExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type UnscheduledPlanItemRollover = {
+    /**
+     * Max rollover units. Omit for unlimited rollover.
+     */
+    max?: number | undefined;
+    /**
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
+     */
+    maxPercentage?: number | undefined;
+    /**
+     * When rolled over units expire.
+     */
+    expiryDurationType: UnscheduledPlanItemExpiryDurationType;
+    /**
+     * Number of periods before expiry.
+     */
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type UnscheduledPlanItemPlanItem = {
+    /**
+     * The ID of the feature to configure.
+     */
+    featureId: string;
+    /**
+     * Number of free units included. Balance resets to this each interval for consumable features.
+     */
+    included?: number | undefined;
+    /**
+     * If true, customer has unlimited access to this feature.
+     */
+    unlimited?: boolean | undefined;
+    /**
+     * Whether entity-level grants contribute to a shared customer balance.
+     */
+    pooled?: boolean | undefined;
+    /**
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: UnscheduledPlanItemReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: UnscheduledPlanItemPrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: UnscheduledPlanItemProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: UnscheduledPlanItemRollover | undefined;
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+declare const UnscheduledPlanAddItemResetInterval: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ */
+type UnscheduledPlanAddItemResetInterval = ClosedEnum<typeof UnscheduledPlanAddItemResetInterval>;
+/**
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ */
+type UnscheduledPlanAddItemReset = {
+    /**
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+     */
+    interval: UnscheduledPlanAddItemResetInterval;
+    /**
+     * Number of intervals between resets. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+};
+type UnscheduledPlanAddItemAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
+};
+type UnscheduledPlanAddItemTierAdditionalCurrency = {
+    currency?: any | undefined;
+    amount?: any | undefined;
+    flatAmount?: any | undefined;
+};
+type UnscheduledPlanAddItemTier = {
+    to: number | string;
+    amount?: number | undefined;
+    flatAmount?: number | undefined;
+    /**
+     * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
+     */
+    additionalCurrencies?: Array<UnscheduledPlanAddItemTierAdditionalCurrency> | undefined;
+};
+declare const UnscheduledPlanAddItemTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
+};
+type UnscheduledPlanAddItemTierBehavior = ClosedEnum<typeof UnscheduledPlanAddItemTierBehavior>;
+/**
+ * Billing interval. For consumable features, should match reset.interval.
+ */
+declare const UnscheduledPlanAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+/**
+ * Billing interval. For consumable features, should match reset.interval.
+ */
+type UnscheduledPlanAddItemPriceInterval = ClosedEnum<typeof UnscheduledPlanAddItemPriceInterval>;
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+declare const UnscheduledPlanAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+type UnscheduledPlanAddItemBillingMethod = ClosedEnum<typeof UnscheduledPlanAddItemBillingMethod>;
+/**
+ * Pricing for usage beyond included units. Omit for free features.
+ */
+type UnscheduledPlanAddItemPrice = {
+    /**
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
+     */
+    amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<UnscheduledPlanAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<UnscheduledPlanAddItemTier> | undefined;
+    tierBehavior?: UnscheduledPlanAddItemTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: UnscheduledPlanAddItemPriceInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     */
+    billingUnits?: number | undefined;
+    /**
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     */
+    billingMethod: UnscheduledPlanAddItemBillingMethod;
+    /**
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     */
+    maxPurchase?: number | null | undefined;
+};
+/**
+ * Billing behavior when quantity increases mid-cycle.
+ */
+declare const UnscheduledPlanAddItemOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
+};
+/**
+ * Billing behavior when quantity increases mid-cycle.
+ */
+type UnscheduledPlanAddItemOnIncrease = ClosedEnum<typeof UnscheduledPlanAddItemOnIncrease>;
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+declare const UnscheduledPlanAddItemOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
+};
+/**
+ * Credit behavior when quantity decreases mid-cycle.
+ */
+type UnscheduledPlanAddItemOnDecrease = ClosedEnum<typeof UnscheduledPlanAddItemOnDecrease>;
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type UnscheduledPlanAddItemProration = {
+    /**
+     * Billing behavior when quantity increases mid-cycle.
+     */
+    onIncrease: UnscheduledPlanAddItemOnIncrease;
+    /**
+     * Credit behavior when quantity decreases mid-cycle.
+     */
+    onDecrease: UnscheduledPlanAddItemOnDecrease;
+};
+/**
+ * When rolled over units expire.
+ */
+declare const UnscheduledPlanAddItemExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
+};
+/**
+ * When rolled over units expire.
+ */
+type UnscheduledPlanAddItemExpiryDurationType = ClosedEnum<typeof UnscheduledPlanAddItemExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type UnscheduledPlanAddItemRollover = {
+    /**
+     * Max rollover units. Omit for unlimited rollover.
+     */
+    max?: number | undefined;
+    /**
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
+     */
+    maxPercentage?: number | undefined;
+    /**
+     * When rolled over units expire.
+     */
+    expiryDurationType: UnscheduledPlanAddItemExpiryDurationType;
+    /**
+     * Number of periods before expiry.
+     */
+    expiryDurationLength?: number | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type UnscheduledPlanAddItemPlanItem = {
+    /**
+     * The ID of the feature to configure.
+     */
+    featureId: string;
+    /**
+     * Number of free units included. Balance resets to this each interval for consumable features.
+     */
+    included?: number | undefined;
+    /**
+     * If true, customer has unlimited access to this feature.
+     */
+    unlimited?: boolean | undefined;
+    /**
+     * Whether entity-level grants contribute to a shared customer balance.
+     */
+    pooled?: boolean | undefined;
+    /**
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: UnscheduledPlanAddItemReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: UnscheduledPlanAddItemPrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: UnscheduledPlanAddItemProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: UnscheduledPlanAddItemRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const UnscheduledPlanRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type UnscheduledPlanRemoveItemBillingMethod = ClosedEnum<typeof UnscheduledPlanRemoveItemBillingMethod>;
+declare const IntervalUnscheduledPlanRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type IntervalUnscheduledPlanRemoveItemEnum2 = ClosedEnum<typeof IntervalUnscheduledPlanRemoveItemEnum2>;
+declare const IntervalUnscheduledPlanRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type IntervalUnscheduledPlanRemoveItemEnum1 = ClosedEnum<typeof IntervalUnscheduledPlanRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type UnscheduledPlanPlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: UnscheduledPlanRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: IntervalUnscheduledPlanRemoveItemEnum1 | IntervalUnscheduledPlanRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const UnscheduledPlanPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type UnscheduledPlanPurchaseLimitInterval = ClosedEnum<typeof UnscheduledPlanPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
+ */
+type UnscheduledPlanPurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: UnscheduledPlanPurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+    /**
+     * Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+     */
+    count?: number | undefined;
+};
+type UnscheduledPlanAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
+     */
+    purchaseLimit?: UnscheduledPlanPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const UnscheduledPlanLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type UnscheduledPlanLimitType = ClosedEnum<typeof UnscheduledPlanLimitType>;
+type UnscheduledPlanSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: UnscheduledPlanLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+    /**
+     * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
+     */
+    skipOverageBilling?: boolean | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const UnscheduledPlanUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type UnscheduledPlanUsageLimitInterval = ClosedEnum<typeof UnscheduledPlanUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UnscheduledPlanFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
+type UnscheduledPlanUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: UnscheduledPlanUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UnscheduledPlanFilter | undefined;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const UnscheduledPlanThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type UnscheduledPlanThresholdType = ClosedEnum<typeof UnscheduledPlanThresholdType>;
+type UnscheduledPlanUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: UnscheduledPlanThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type UnscheduledPlanOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
+/**
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ */
+type UnscheduledPlanBillingControls = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<UnscheduledPlanAutoTopup> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<UnscheduledPlanSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<UnscheduledPlanUsageLimit> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<UnscheduledPlanUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<UnscheduledPlanOverageAllowed> | undefined;
+};
+/**
+ * Customize the plan to schedule. Can override price, replace items, or patch items with add_items and remove_items.
+ */
+type UnscheduledPlanCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: UnscheduledPlanBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<UnscheduledPlanItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<UnscheduledPlanAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<UnscheduledPlanPlanItemFilter> | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: UnscheduledPlanBillingControls | undefined;
+};
+type UnscheduledPlan = {
+    /**
+     * The ID of the plan to schedule in this phase.
+     */
+    planId: string;
+    /**
+     * The immediate plan scope. Omit to inherit the request entity, pass null for customer-level, or pass an entity ID.
+     */
+    entityId?: string | null | undefined;
+    /**
+     * Optional prepaid feature quantities for this phase's plan.
+     */
+    featureQuantities?: Array<UnscheduledPlanFeatureQuantity> | undefined;
+    /**
+     * Optional explicit plan version to schedule.
+     */
+    version?: number | undefined;
+    /**
+     * Customize the plan to schedule. Can override price, replace items, or patch items with add_items and remove_items.
+     */
+    customize?: UnscheduledPlanCustomize | undefined;
+    /**
+     * A unique ID to identify this subscription. Useful when scheduling the same plan multiple times.
+     */
+    subscriptionId?: string | undefined;
+};
 /**
  * The duration unit to offset this phase from the prior phase.
  */
@@ -10513,7 +11356,7 @@ type StartingAfter2 = {
 /**
  * Quantity configuration for a prepaid feature.
  */
-type CreateScheduleFeatureQuantity2 = {
+type PhaseStartFeatureQuantity = {
     /**
      * The ID of the feature to set quantity for.
      */
@@ -10530,7 +11373,7 @@ type CreateScheduleFeatureQuantity2 = {
 /**
  * Billing interval (e.g. 'month', 'year').
  */
-declare const CreateSchedulePriceInterval2: {
+declare const PhaseStartPriceInterval: {
     readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
@@ -10541,8 +11384,8 @@ declare const CreateSchedulePriceInterval2: {
 /**
  * Billing interval (e.g. 'month', 'year').
  */
-type CreateSchedulePriceInterval2 = ClosedEnum<typeof CreateSchedulePriceInterval2>;
-type CreateScheduleAdditionalCurrency2 = {
+type PhaseStartPriceInterval = ClosedEnum<typeof PhaseStartPriceInterval>;
+type PhaseStartAdditionalCurrency = {
     /**
      * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
@@ -10555,7 +11398,7 @@ type CreateScheduleAdditionalCurrency2 = {
 /**
  * Base price configuration for a plan.
  */
-type CreateScheduleBasePrice2 = {
+type PhaseStartBasePrice = {
     /**
      * Base price amount for the plan.
      */
@@ -10563,7 +11406,7 @@ type CreateScheduleBasePrice2 = {
     /**
      * Billing interval (e.g. 'month', 'year').
      */
-    interval: CreateSchedulePriceInterval2;
+    interval: PhaseStartPriceInterval;
     /**
      * Number of intervals per billing cycle. Defaults to 1.
      */
@@ -10571,12 +11414,12 @@ type CreateScheduleBasePrice2 = {
     /**
      * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    additionalCurrencies?: Array<CreateScheduleAdditionalCurrency2> | undefined;
+    additionalCurrencies?: Array<PhaseStartAdditionalCurrency> | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-declare const CreateScheduleItemResetInterval2: {
+declare const PhaseStartItemResetInterval: {
     readonly OneOff: "one_off";
     readonly Minute: "minute";
     readonly Hour: "hour";
@@ -10590,39 +11433,39 @@ declare const CreateScheduleItemResetInterval2: {
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type CreateScheduleItemResetInterval2 = ClosedEnum<typeof CreateScheduleItemResetInterval2>;
+type PhaseStartItemResetInterval = ClosedEnum<typeof PhaseStartItemResetInterval>;
 /**
  * Reset configuration for consumable features. Omit for non-consumable features like seats.
  */
-type CreateScheduleItemReset2 = {
+type PhaseStartItemReset = {
     /**
      * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    interval: CreateScheduleItemResetInterval2;
+    interval: PhaseStartItemResetInterval;
     /**
      * Number of intervals between resets. Defaults to 1.
      */
     intervalCount?: number | undefined;
 };
-type CreateScheduleItemAdditionalCurrency2 = {
+type PhaseStartItemAdditionalCurrency = {
     currency?: any | undefined;
     amount?: any | undefined;
 };
-type CreateScheduleItemTier2 = {
+type PhaseStartItemTier = {
     to?: any | undefined;
     amount?: any | undefined;
     flatAmount?: any | undefined;
     additionalCurrencies?: any | undefined;
 };
-declare const CreateScheduleItemTierBehavior2: {
+declare const PhaseStartItemTierBehavior: {
     readonly Graduated: "graduated";
     readonly Volume: "volume";
 };
-type CreateScheduleItemTierBehavior2 = ClosedEnum<typeof CreateScheduleItemTierBehavior2>;
+type PhaseStartItemTierBehavior = ClosedEnum<typeof PhaseStartItemTierBehavior>;
 /**
  * Billing interval. For consumable features, should match reset.interval.
  */
-declare const CreateScheduleItemPriceInterval2: {
+declare const PhaseStartItemPriceInterval: {
     readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
@@ -10633,22 +11476,22 @@ declare const CreateScheduleItemPriceInterval2: {
 /**
  * Billing interval. For consumable features, should match reset.interval.
  */
-type CreateScheduleItemPriceInterval2 = ClosedEnum<typeof CreateScheduleItemPriceInterval2>;
+type PhaseStartItemPriceInterval = ClosedEnum<typeof PhaseStartItemPriceInterval>;
 /**
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const CreateScheduleItemBillingMethod2: {
+declare const PhaseStartItemBillingMethod: {
     readonly Prepaid: "prepaid";
     readonly UsageBased: "usage_based";
 };
 /**
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type CreateScheduleItemBillingMethod2 = ClosedEnum<typeof CreateScheduleItemBillingMethod2>;
+type PhaseStartItemBillingMethod = ClosedEnum<typeof PhaseStartItemBillingMethod>;
 /**
  * Pricing for usage beyond included units. Omit for free features.
  */
-type CreateScheduleItemPrice2 = {
+type PhaseStartItemPrice = {
     /**
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
@@ -10656,16 +11499,16 @@ type CreateScheduleItemPrice2 = {
     /**
      * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    additionalCurrencies?: Array<CreateScheduleItemAdditionalCurrency2> | undefined;
+    additionalCurrencies?: Array<PhaseStartItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
-    tiers?: Array<CreateScheduleItemTier2> | undefined;
-    tierBehavior?: CreateScheduleItemTierBehavior2 | undefined;
+    tiers?: Array<PhaseStartItemTier> | undefined;
+    tierBehavior?: PhaseStartItemTierBehavior | undefined;
     /**
      * Billing interval. For consumable features, should match reset.interval.
      */
-    interval: CreateScheduleItemPriceInterval2;
+    interval: PhaseStartItemPriceInterval;
     /**
      * Number of intervals per billing cycle. Defaults to 1.
      */
@@ -10677,7 +11520,7 @@ type CreateScheduleItemPrice2 = {
     /**
      * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
      */
-    billingMethod: CreateScheduleItemBillingMethod2;
+    billingMethod: PhaseStartItemBillingMethod;
     /**
      * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
@@ -10686,7 +11529,7 @@ type CreateScheduleItemPrice2 = {
 /**
  * Billing behavior when quantity increases mid-cycle.
  */
-declare const CreateScheduleItemOnIncrease2: {
+declare const PhaseStartItemOnIncrease: {
     readonly BillImmediately: "bill_immediately";
     readonly ProrateImmediately: "prorate_immediately";
     readonly ProrateNextCycle: "prorate_next_cycle";
@@ -10695,11 +11538,11 @@ declare const CreateScheduleItemOnIncrease2: {
 /**
  * Billing behavior when quantity increases mid-cycle.
  */
-type CreateScheduleItemOnIncrease2 = ClosedEnum<typeof CreateScheduleItemOnIncrease2>;
+type PhaseStartItemOnIncrease = ClosedEnum<typeof PhaseStartItemOnIncrease>;
 /**
  * Credit behavior when quantity decreases mid-cycle.
  */
-declare const CreateScheduleItemOnDecrease2: {
+declare const PhaseStartItemOnDecrease: {
     readonly Prorate: "prorate";
     readonly ProrateImmediately: "prorate_immediately";
     readonly ProrateNextCycle: "prorate_next_cycle";
@@ -10709,35 +11552,35 @@ declare const CreateScheduleItemOnDecrease2: {
 /**
  * Credit behavior when quantity decreases mid-cycle.
  */
-type CreateScheduleItemOnDecrease2 = ClosedEnum<typeof CreateScheduleItemOnDecrease2>;
+type PhaseStartItemOnDecrease = ClosedEnum<typeof PhaseStartItemOnDecrease>;
 /**
  * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
  */
-type CreateScheduleItemProration2 = {
+type PhaseStartItemProration = {
     /**
      * Billing behavior when quantity increases mid-cycle.
      */
-    onIncrease: CreateScheduleItemOnIncrease2;
+    onIncrease: PhaseStartItemOnIncrease;
     /**
      * Credit behavior when quantity decreases mid-cycle.
      */
-    onDecrease: CreateScheduleItemOnDecrease2;
+    onDecrease: PhaseStartItemOnDecrease;
 };
 /**
  * When rolled over units expire.
  */
-declare const CreateScheduleItemExpiryDurationType2: {
+declare const PhaseStartItemExpiryDurationType: {
     readonly Month: "month";
     readonly Forever: "forever";
 };
 /**
  * When rolled over units expire.
  */
-type CreateScheduleItemExpiryDurationType2 = ClosedEnum<typeof CreateScheduleItemExpiryDurationType2>;
+type PhaseStartItemExpiryDurationType = ClosedEnum<typeof PhaseStartItemExpiryDurationType>;
 /**
  * Rollover config for unused units. If set, unused included units carry over.
  */
-type CreateScheduleItemRollover2 = {
+type PhaseStartItemRollover = {
     /**
      * Max rollover units. Omit for unlimited rollover.
      */
@@ -10749,7 +11592,7 @@ type CreateScheduleItemRollover2 = {
     /**
      * When rolled over units expire.
      */
-    expiryDurationType: CreateScheduleItemExpiryDurationType2;
+    expiryDurationType: PhaseStartItemExpiryDurationType;
     /**
      * Number of periods before expiry.
      */
@@ -10758,7 +11601,7 @@ type CreateScheduleItemRollover2 = {
 /**
  * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
  */
-type CreateScheduleItemPlanItem2 = {
+type PhaseStartItemPlanItem = {
     /**
      * The ID of the feature to configure.
      */
@@ -10778,24 +11621,24 @@ type CreateScheduleItemPlanItem2 = {
     /**
      * Reset configuration for consumable features. Omit for non-consumable features like seats.
      */
-    reset?: CreateScheduleItemReset2 | undefined;
+    reset?: PhaseStartItemReset | undefined;
     /**
      * Pricing for usage beyond included units. Omit for free features.
      */
-    price?: CreateScheduleItemPrice2 | undefined;
+    price?: PhaseStartItemPrice | undefined;
     /**
      * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
      */
-    proration?: CreateScheduleItemProration2 | undefined;
+    proration?: PhaseStartItemProration | undefined;
     /**
      * Rollover config for unused units. If set, unused included units carry over.
      */
-    rollover?: CreateScheduleItemRollover2 | undefined;
+    rollover?: PhaseStartItemRollover | undefined;
 };
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-declare const CreateScheduleAddItemResetInterval2: {
+declare const PhaseStartAddItemResetInterval: {
     readonly OneOff: "one_off";
     readonly Minute: "minute";
     readonly Hour: "hour";
@@ -10809,39 +11652,39 @@ declare const CreateScheduleAddItemResetInterval2: {
 /**
  * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type CreateScheduleAddItemResetInterval2 = ClosedEnum<typeof CreateScheduleAddItemResetInterval2>;
+type PhaseStartAddItemResetInterval = ClosedEnum<typeof PhaseStartAddItemResetInterval>;
 /**
  * Reset configuration for consumable features. Omit for non-consumable features like seats.
  */
-type CreateScheduleAddItemReset2 = {
+type PhaseStartAddItemReset = {
     /**
      * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    interval: CreateScheduleAddItemResetInterval2;
+    interval: PhaseStartAddItemResetInterval;
     /**
      * Number of intervals between resets. Defaults to 1.
      */
     intervalCount?: number | undefined;
 };
-type CreateScheduleAddItemAdditionalCurrency2 = {
+type PhaseStartAddItemAdditionalCurrency = {
     currency?: any | undefined;
     amount?: any | undefined;
 };
-type CreateScheduleAddItemTier2 = {
+type PhaseStartAddItemTier = {
     to?: any | undefined;
     amount?: any | undefined;
     flatAmount?: any | undefined;
     additionalCurrencies?: any | undefined;
 };
-declare const CreateScheduleAddItemTierBehavior2: {
+declare const PhaseStartAddItemTierBehavior: {
     readonly Graduated: "graduated";
     readonly Volume: "volume";
 };
-type CreateScheduleAddItemTierBehavior2 = ClosedEnum<typeof CreateScheduleAddItemTierBehavior2>;
+type PhaseStartAddItemTierBehavior = ClosedEnum<typeof PhaseStartAddItemTierBehavior>;
 /**
  * Billing interval. For consumable features, should match reset.interval.
  */
-declare const CreateScheduleAddItemPriceInterval2: {
+declare const PhaseStartAddItemPriceInterval: {
     readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
@@ -10852,22 +11695,22 @@ declare const CreateScheduleAddItemPriceInterval2: {
 /**
  * Billing interval. For consumable features, should match reset.interval.
  */
-type CreateScheduleAddItemPriceInterval2 = ClosedEnum<typeof CreateScheduleAddItemPriceInterval2>;
+type PhaseStartAddItemPriceInterval = ClosedEnum<typeof PhaseStartAddItemPriceInterval>;
 /**
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-declare const CreateScheduleAddItemBillingMethod2: {
+declare const PhaseStartAddItemBillingMethod: {
     readonly Prepaid: "prepaid";
     readonly UsageBased: "usage_based";
 };
 /**
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
  */
-type CreateScheduleAddItemBillingMethod2 = ClosedEnum<typeof CreateScheduleAddItemBillingMethod2>;
+type PhaseStartAddItemBillingMethod = ClosedEnum<typeof PhaseStartAddItemBillingMethod>;
 /**
  * Pricing for usage beyond included units. Omit for free features.
  */
-type CreateScheduleAddItemPrice2 = {
+type PhaseStartAddItemPrice = {
     /**
      * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
@@ -10875,16 +11718,16 @@ type CreateScheduleAddItemPrice2 = {
     /**
      * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
      */
-    additionalCurrencies?: Array<CreateScheduleAddItemAdditionalCurrency2> | undefined;
+    additionalCurrencies?: Array<PhaseStartAddItemAdditionalCurrency> | undefined;
     /**
      * Tiered pricing.  Either 'amount' or 'tiers' is required.
      */
-    tiers?: Array<CreateScheduleAddItemTier2> | undefined;
-    tierBehavior?: CreateScheduleAddItemTierBehavior2 | undefined;
+    tiers?: Array<PhaseStartAddItemTier> | undefined;
+    tierBehavior?: PhaseStartAddItemTierBehavior | undefined;
     /**
      * Billing interval. For consumable features, should match reset.interval.
      */
-    interval: CreateScheduleAddItemPriceInterval2;
+    interval: PhaseStartAddItemPriceInterval;
     /**
      * Number of intervals per billing cycle. Defaults to 1.
      */
@@ -10896,7 +11739,7 @@ type CreateScheduleAddItemPrice2 = {
     /**
      * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
      */
-    billingMethod: CreateScheduleAddItemBillingMethod2;
+    billingMethod: PhaseStartAddItemBillingMethod;
     /**
      * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
@@ -10905,7 +11748,7 @@ type CreateScheduleAddItemPrice2 = {
 /**
  * Billing behavior when quantity increases mid-cycle.
  */
-declare const CreateScheduleAddItemOnIncrease2: {
+declare const PhaseStartAddItemOnIncrease: {
     readonly BillImmediately: "bill_immediately";
     readonly ProrateImmediately: "prorate_immediately";
     readonly ProrateNextCycle: "prorate_next_cycle";
@@ -10914,11 +11757,11 @@ declare const CreateScheduleAddItemOnIncrease2: {
 /**
  * Billing behavior when quantity increases mid-cycle.
  */
-type CreateScheduleAddItemOnIncrease2 = ClosedEnum<typeof CreateScheduleAddItemOnIncrease2>;
+type PhaseStartAddItemOnIncrease = ClosedEnum<typeof PhaseStartAddItemOnIncrease>;
 /**
  * Credit behavior when quantity decreases mid-cycle.
  */
-declare const CreateScheduleAddItemOnDecrease2: {
+declare const PhaseStartAddItemOnDecrease: {
     readonly Prorate: "prorate";
     readonly ProrateImmediately: "prorate_immediately";
     readonly ProrateNextCycle: "prorate_next_cycle";
@@ -10928,35 +11771,35 @@ declare const CreateScheduleAddItemOnDecrease2: {
 /**
  * Credit behavior when quantity decreases mid-cycle.
  */
-type CreateScheduleAddItemOnDecrease2 = ClosedEnum<typeof CreateScheduleAddItemOnDecrease2>;
+type PhaseStartAddItemOnDecrease = ClosedEnum<typeof PhaseStartAddItemOnDecrease>;
 /**
  * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
  */
-type CreateScheduleAddItemProration2 = {
+type PhaseStartAddItemProration = {
     /**
      * Billing behavior when quantity increases mid-cycle.
      */
-    onIncrease: CreateScheduleAddItemOnIncrease2;
+    onIncrease: PhaseStartAddItemOnIncrease;
     /**
      * Credit behavior when quantity decreases mid-cycle.
      */
-    onDecrease: CreateScheduleAddItemOnDecrease2;
+    onDecrease: PhaseStartAddItemOnDecrease;
 };
 /**
  * When rolled over units expire.
  */
-declare const CreateScheduleAddItemExpiryDurationType2: {
+declare const PhaseStartAddItemExpiryDurationType: {
     readonly Month: "month";
     readonly Forever: "forever";
 };
 /**
  * When rolled over units expire.
  */
-type CreateScheduleAddItemExpiryDurationType2 = ClosedEnum<typeof CreateScheduleAddItemExpiryDurationType2>;
+type PhaseStartAddItemExpiryDurationType = ClosedEnum<typeof PhaseStartAddItemExpiryDurationType>;
 /**
  * Rollover config for unused units. If set, unused included units carry over.
  */
-type CreateScheduleAddItemRollover2 = {
+type PhaseStartAddItemRollover = {
     /**
      * Max rollover units. Omit for unlimited rollover.
      */
@@ -10968,7 +11811,7 @@ type CreateScheduleAddItemRollover2 = {
     /**
      * When rolled over units expire.
      */
-    expiryDurationType: CreateScheduleAddItemExpiryDurationType2;
+    expiryDurationType: PhaseStartAddItemExpiryDurationType;
     /**
      * Number of periods before expiry.
      */
@@ -10977,7 +11820,7 @@ type CreateScheduleAddItemRollover2 = {
 /**
  * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
  */
-type CreateScheduleAddItemPlanItem2 = {
+type PhaseStartAddItemPlanItem = {
     /**
      * The ID of the feature to configure.
      */
@@ -10997,32 +11840,32 @@ type CreateScheduleAddItemPlanItem2 = {
     /**
      * Reset configuration for consumable features. Omit for non-consumable features like seats.
      */
-    reset?: CreateScheduleAddItemReset2 | undefined;
+    reset?: PhaseStartAddItemReset | undefined;
     /**
      * Pricing for usage beyond included units. Omit for free features.
      */
-    price?: CreateScheduleAddItemPrice2 | undefined;
+    price?: PhaseStartAddItemPrice | undefined;
     /**
      * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
      */
-    proration?: CreateScheduleAddItemProration2 | undefined;
+    proration?: PhaseStartAddItemProration | undefined;
     /**
      * Rollover config for unused units. If set, unused included units carry over.
      */
-    rollover?: CreateScheduleAddItemRollover2 | undefined;
+    rollover?: PhaseStartAddItemRollover | undefined;
 };
 /**
  * Match items with this billing method (prepaid or usage_based).
  */
-declare const CreateScheduleRemoveItemBillingMethod2: {
+declare const PhaseStartRemoveItemBillingMethod: {
     readonly Prepaid: "prepaid";
     readonly UsageBased: "usage_based";
 };
 /**
  * Match items with this billing method (prepaid or usage_based).
  */
-type CreateScheduleRemoveItemBillingMethod2 = ClosedEnum<typeof CreateScheduleRemoveItemBillingMethod2>;
-declare const CreateScheduleIntervalRemoveItemEnum4: {
+type PhaseStartRemoveItemBillingMethod = ClosedEnum<typeof PhaseStartRemoveItemBillingMethod>;
+declare const PhaseStartIntervalRemoveItemEnum2: {
     readonly OneOff: "one_off";
     readonly Minute: "minute";
     readonly Hour: "hour";
@@ -11033,8 +11876,8 @@ declare const CreateScheduleIntervalRemoveItemEnum4: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type CreateScheduleIntervalRemoveItemEnum4 = ClosedEnum<typeof CreateScheduleIntervalRemoveItemEnum4>;
-declare const CreateScheduleIntervalRemoveItemEnum3: {
+type PhaseStartIntervalRemoveItemEnum2 = ClosedEnum<typeof PhaseStartIntervalRemoveItemEnum2>;
+declare const PhaseStartIntervalRemoveItemEnum1: {
     readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
@@ -11042,11 +11885,11 @@ declare const CreateScheduleIntervalRemoveItemEnum3: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type CreateScheduleIntervalRemoveItemEnum3 = ClosedEnum<typeof CreateScheduleIntervalRemoveItemEnum3>;
+type PhaseStartIntervalRemoveItemEnum1 = ClosedEnum<typeof PhaseStartIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
-type CreateSchedulePlanItemFilter2 = {
+type PhaseStartPlanItemFilter = {
     /**
      * Match items linked to this feature.
      */
@@ -11054,11 +11897,11 @@ type CreateSchedulePlanItemFilter2 = {
     /**
      * Match items with this billing method (prepaid or usage_based).
      */
-    billingMethod?: CreateScheduleRemoveItemBillingMethod2 | undefined;
+    billingMethod?: PhaseStartRemoveItemBillingMethod | undefined;
     /**
      * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
      */
-    interval?: CreateScheduleIntervalRemoveItemEnum3 | CreateScheduleIntervalRemoveItemEnum4 | undefined;
+    interval?: PhaseStartIntervalRemoveItemEnum1 | PhaseStartIntervalRemoveItemEnum2 | undefined;
     /**
      * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
@@ -11067,7 +11910,7 @@ type CreateSchedulePlanItemFilter2 = {
 /**
  * The time interval for the purchase limit window.
  */
-declare const CreateSchedulePurchaseLimitInterval2: {
+declare const PhaseStartPurchaseLimitInterval: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
@@ -11076,15 +11919,15 @@ declare const CreateSchedulePurchaseLimitInterval2: {
 /**
  * The time interval for the purchase limit window.
  */
-type CreateSchedulePurchaseLimitInterval2 = ClosedEnum<typeof CreateSchedulePurchaseLimitInterval2>;
+type PhaseStartPurchaseLimitInterval = ClosedEnum<typeof PhaseStartPurchaseLimitInterval>;
 /**
  * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
  */
-type CreateSchedulePurchaseLimit2 = {
+type PhaseStartPurchaseLimit = {
     /**
      * The time interval for the purchase limit window.
      */
-    interval: CreateSchedulePurchaseLimitInterval2;
+    interval: PhaseStartPurchaseLimitInterval;
     /**
      * Number of intervals in the purchase limit window.
      */
@@ -11098,7 +11941,7 @@ type CreateSchedulePurchaseLimit2 = {
      */
     count?: number | undefined;
 };
-type CreateScheduleAutoTopup2 = {
+type PhaseStartAutoTopup = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
      */
@@ -11118,7 +11961,7 @@ type CreateScheduleAutoTopup2 = {
     /**
      * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
      */
-    purchaseLimit?: CreateSchedulePurchaseLimit2 | undefined;
+    purchaseLimit?: PhaseStartPurchaseLimit | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
@@ -11127,15 +11970,15 @@ type CreateScheduleAutoTopup2 = {
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-declare const CreateScheduleLimitType2: {
+declare const PhaseStartLimitType: {
     readonly Absolute: "absolute";
     readonly UsagePercentage: "usage_percentage";
 };
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-type CreateScheduleLimitType2 = ClosedEnum<typeof CreateScheduleLimitType2>;
-type CreateScheduleSpendLimit2 = {
+type PhaseStartLimitType = ClosedEnum<typeof PhaseStartLimitType>;
+type PhaseStartSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
      */
@@ -11147,7 +11990,7 @@ type CreateScheduleSpendLimit2 = {
     /**
      * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
      */
-    limitType?: CreateScheduleLimitType2 | undefined;
+    limitType?: PhaseStartLimitType | undefined;
     /**
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
@@ -11160,7 +12003,7 @@ type CreateScheduleSpendLimit2 = {
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
  */
-declare const CreateScheduleUsageLimitInterval2: {
+declare const PhaseStartUsageLimitInterval: {
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
@@ -11169,16 +12012,16 @@ declare const CreateScheduleUsageLimitInterval2: {
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
  */
-type CreateScheduleUsageLimitInterval2 = ClosedEnum<typeof CreateScheduleUsageLimitInterval2>;
+type PhaseStartUsageLimitInterval = ClosedEnum<typeof PhaseStartUsageLimitInterval>;
 /**
  * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
  */
-type CreateScheduleFilter2 = {
+type PhaseStartFilter = {
     properties: {
         [k: string]: any;
     };
 };
-type CreateScheduleUsageLimit2 = {
+type PhaseStartUsageLimit = {
     /**
      * The feature this usage limit applies to.
      */
@@ -11194,16 +12037,16 @@ type CreateScheduleUsageLimit2 = {
     /**
      * Interval for the cap, aligned to the customer's billing cycle.
      */
-    interval: CreateScheduleUsageLimitInterval2;
+    interval: PhaseStartUsageLimitInterval;
     /**
      * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
      */
-    filter?: CreateScheduleFilter2 | undefined;
+    filter?: PhaseStartFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const CreateScheduleThresholdType2: {
+declare const PhaseStartThresholdType: {
     readonly Usage: "usage";
     readonly UsagePercentage: "usage_percentage";
     readonly Remaining: "remaining";
@@ -11212,8 +12055,8 @@ declare const CreateScheduleThresholdType2: {
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-type CreateScheduleThresholdType2 = ClosedEnum<typeof CreateScheduleThresholdType2>;
-type CreateScheduleUsageAlert2 = {
+type PhaseStartThresholdType = ClosedEnum<typeof PhaseStartThresholdType>;
+type PhaseStartUsageAlert = {
     /**
      * The feature ID this alert applies to.
      */
@@ -11229,13 +12072,13 @@ type CreateScheduleUsageAlert2 = {
     /**
      * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
      */
-    thresholdType: CreateScheduleThresholdType2;
+    thresholdType: PhaseStartThresholdType;
     /**
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
 };
-type CreateScheduleOverageAllowed2 = {
+type PhaseStartOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
      */
@@ -11248,52 +12091,52 @@ type CreateScheduleOverageAllowed2 = {
 /**
  * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
  */
-type CreateScheduleBillingControls2 = {
+type PhaseStartBillingControls = {
     /**
      * List of auto top-up configurations per feature.
      */
-    autoTopups?: Array<CreateScheduleAutoTopup2> | undefined;
+    autoTopups?: Array<PhaseStartAutoTopup> | undefined;
     /**
      * List of overage spend limits per feature (caps overage spend).
      */
-    spendLimits?: Array<CreateScheduleSpendLimit2> | undefined;
+    spendLimits?: Array<PhaseStartSpendLimit> | undefined;
     /**
      * List of hard usage caps per feature (max units per interval).
      */
-    usageLimits?: Array<CreateScheduleUsageLimit2> | undefined;
+    usageLimits?: Array<PhaseStartUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
-    usageAlerts?: Array<CreateScheduleUsageAlert2> | undefined;
+    usageAlerts?: Array<PhaseStartUsageAlert> | undefined;
     /**
      * List of overage allowed controls per feature. When enabled, usage can exceed balance.
      */
-    overageAllowed?: Array<CreateScheduleOverageAllowed2> | undefined;
+    overageAllowed?: Array<PhaseStartOverageAllowed> | undefined;
 };
 /**
  * Customize the plan to schedule. Can override price, replace items, or patch items with add_items and remove_items.
  */
-type CreateScheduleCustomize2 = {
+type PhaseStartCustomize = {
     /**
      * Override the base price of the plan. Pass null to remove the base price.
      */
-    price?: CreateScheduleBasePrice2 | null | undefined;
+    price?: PhaseStartBasePrice | null | undefined;
     /**
      * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
-    items?: Array<CreateScheduleItemPlanItem2> | undefined;
+    items?: Array<PhaseStartItemPlanItem> | undefined;
     /**
      * Items to add to the plan.
      */
-    addItems?: Array<CreateScheduleAddItemPlanItem2> | undefined;
+    addItems?: Array<PhaseStartAddItemPlanItem> | undefined;
     /**
      * Filters selecting items to remove from the plan.
      */
-    removeItems?: Array<CreateSchedulePlanItemFilter2> | undefined;
+    removeItems?: Array<PhaseStartPlanItemFilter> | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
-    billingControls?: CreateScheduleBillingControls2 | undefined;
+    billingControls?: PhaseStartBillingControls | undefined;
 };
 type CreateSchedulePlan2 = {
     /**
@@ -11307,7 +12150,7 @@ type CreateSchedulePlan2 = {
     /**
      * Optional prepaid feature quantities for this phase's plan.
      */
-    featureQuantities?: Array<CreateScheduleFeatureQuantity2> | undefined;
+    featureQuantities?: Array<PhaseStartFeatureQuantity> | undefined;
     /**
      * Optional explicit plan version to schedule.
      */
@@ -11315,7 +12158,7 @@ type CreateSchedulePlan2 = {
     /**
      * Customize the plan to schedule. Can override price, replace items, or patch items with add_items and remove_items.
      */
-    customize?: CreateScheduleCustomize2 | undefined;
+    customize?: PhaseStartCustomize | undefined;
     /**
      * A unique ID to identify this subscription. Useful when scheduling the same plan multiple times.
      */
@@ -11401,9 +12244,13 @@ type CreateScheduleParams = {
      */
     enablePlanImmediately?: boolean | undefined;
     /**
-     * If true, active recurring add-ons in scopes represented by the phase plans are retained.
+     * Deprecated and ignored. Active plans the schedule does not declare are always retained.
      */
     preserveAddOns?: boolean | undefined;
+    /**
+     * Plans billed with the immediate phase that the schedule never expires or replaces. No phase may declare a plan in the same group and scope.
+     */
+    unscheduledPlans?: Array<UnscheduledPlan> | undefined;
     /**
      * Ordered phase definitions for the schedule.
      */
@@ -12205,6 +13052,89 @@ type Invoice = {
      */
     hostedInvoiceUrl?: string | null | undefined;
 };
+type InvoicePreviewDiscount = {
+    amountOff: number;
+    percentOff?: number | undefined;
+    rewardId?: string | undefined;
+    rewardName?: string | undefined;
+};
+/**
+ * The period of time that this line item is being charged for.
+ */
+type Period = {
+    /**
+     * The start of the period in milliseconds since the Unix epoch.
+     */
+    start: number;
+    /**
+     * The end of the period in milliseconds since the Unix epoch.
+     */
+    end: number;
+};
+type LineItem = {
+    /**
+     * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
+     */
+    displayName: string;
+    /**
+     * A detailed description of the line item.
+     */
+    description: string;
+    /**
+     * The amount in cents before discounts and tax for this line item.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for this line item.
+     */
+    total: number;
+    /**
+     * List of discounts applied to this line item.
+     */
+    discounts?: Array<InvoicePreviewDiscount> | undefined;
+    /**
+     * The ID of the plan that this line item belongs to.
+     */
+    planId: string;
+    /**
+     * The ID of the feature that this line item belongs to.
+     */
+    featureId: string | null;
+    /**
+     * The period of time that this line item is being charged for.
+     */
+    period?: Period | undefined;
+    /**
+     * The quantity of the line item.
+     */
+    quantity: number;
+};
+type InvoicePreview = {
+    /**
+     * Plan IDs contributing line items to this invoice.
+     */
+    planIds: Array<string>;
+    /**
+     * Unix timestamp (milliseconds) when this invoice will be created.
+     */
+    invoiceAt: number;
+    /**
+     * The three-letter ISO currency code (e.g., 'usd').
+     */
+    currency: string;
+    /**
+     * The total before discounts, in major currency units.
+     */
+    subtotal: number;
+    /**
+     * The total after discounts, in major currency units.
+     */
+    total: number;
+    /**
+     * The line items this invoice will contain: usage accrued in the closing cycle, plus recurring charges for the opening cycle.
+     */
+    lineItems: Array<LineItem>;
+};
 /**
  * The environment (sandbox/live)
  */
@@ -12273,7 +13203,7 @@ declare const CustomerDurationType: {
  * How long the discount lasts
  */
 type CustomerDurationType = OpenEnum<typeof CustomerDurationType>;
-type Discount = {
+type RewardsDiscount = {
     /**
      * The unique identifier for this discount
      */
@@ -12323,7 +13253,7 @@ type Rewards$1 = {
     /**
      * Array of active discounts applied to the customer
      */
-    discounts: Array<Discount>;
+    discounts: Array<RewardsDiscount>;
 };
 type ReferralCustomer = {
     id: string;
@@ -12415,6 +13345,10 @@ type Customer = {
      * Invoices for this customer.
      */
     invoices?: Array<Invoice> | undefined;
+    /**
+     * Upcoming invoice for each of this customer's Stripe subscriptions.
+     */
+    invoicePreviews?: Array<InvoicePreview> | undefined;
     /**
      * Entities associated with this customer.
      */
@@ -12552,6 +13486,32 @@ type DeletePlanResponse = {
     success: boolean;
 };
 
+type DeleteReferralProgramParams = {
+    /**
+     * The ID of the referral program.
+     */
+    referralProgramId: string;
+};
+/**
+ * OK
+ */
+type DeleteReferralProgramResponse = {
+    success: boolean;
+};
+
+type DeleteRewardParams = {
+    /**
+     * The ID of the coupon or feature grant.
+     */
+    rewardId: string;
+};
+/**
+ * OK
+ */
+type DeleteRewardResponse = {
+    success: boolean;
+};
+
 /**
  * Use 'confirm' to commit the deduction, or 'release' to return the held balance.
  */
@@ -13295,6 +14255,89 @@ type GetCustomerInvoice = {
      */
     hostedInvoiceUrl?: string | null | undefined;
 };
+type GetCustomerInvoicePreviewDiscount = {
+    amountOff: number;
+    percentOff?: number | undefined;
+    rewardId?: string | undefined;
+    rewardName?: string | undefined;
+};
+/**
+ * The period of time that this line item is being charged for.
+ */
+type GetCustomerPeriod = {
+    /**
+     * The start of the period in milliseconds since the Unix epoch.
+     */
+    start: number;
+    /**
+     * The end of the period in milliseconds since the Unix epoch.
+     */
+    end: number;
+};
+type GetCustomerLineItem = {
+    /**
+     * The name of the line item to display to the customer if you're building a UI. It will either be the plan name or the feature name.
+     */
+    displayName: string;
+    /**
+     * A detailed description of the line item.
+     */
+    description: string;
+    /**
+     * The amount in cents before discounts and tax for this line item.
+     */
+    subtotal: number;
+    /**
+     * The final amount in cents after discounts and tax for this line item.
+     */
+    total: number;
+    /**
+     * List of discounts applied to this line item.
+     */
+    discounts?: Array<GetCustomerInvoicePreviewDiscount> | undefined;
+    /**
+     * The ID of the plan that this line item belongs to.
+     */
+    planId: string;
+    /**
+     * The ID of the feature that this line item belongs to.
+     */
+    featureId: string | null;
+    /**
+     * The period of time that this line item is being charged for.
+     */
+    period?: GetCustomerPeriod | undefined;
+    /**
+     * The quantity of the line item.
+     */
+    quantity: number;
+};
+type GetCustomerInvoicePreview = {
+    /**
+     * Plan IDs contributing line items to this invoice.
+     */
+    planIds: Array<string>;
+    /**
+     * Unix timestamp (milliseconds) when this invoice will be created.
+     */
+    invoiceAt: number;
+    /**
+     * The three-letter ISO currency code (e.g., 'usd').
+     */
+    currency: string;
+    /**
+     * The total before discounts, in major currency units.
+     */
+    subtotal: number;
+    /**
+     * The total after discounts, in major currency units.
+     */
+    total: number;
+    /**
+     * The line items this invoice will contain: usage accrued in the closing cycle, plus recurring charges for the opening cycle.
+     */
+    lineItems: Array<GetCustomerLineItem>;
+};
 /**
  * The environment (sandbox/live)
  */
@@ -13363,7 +14406,7 @@ declare const GetCustomerDurationType: {
  * How long the discount lasts
  */
 type GetCustomerDurationType = OpenEnum<typeof GetCustomerDurationType>;
-type GetCustomerDiscount = {
+type GetCustomerRewardsDiscount = {
     /**
      * The unique identifier for this discount
      */
@@ -13413,7 +14456,7 @@ type GetCustomerRewards = {
     /**
      * Array of active discounts applied to the customer
      */
-    discounts: Array<GetCustomerDiscount>;
+    discounts: Array<GetCustomerRewardsDiscount>;
 };
 type GetCustomerCustomer = {
     id: string;
@@ -13508,6 +14551,10 @@ type GetCustomerResponse = {
      * Invoices for this customer.
      */
     invoices?: Array<GetCustomerInvoice> | undefined;
+    /**
+     * Upcoming invoice for each of this customer's Stripe subscriptions.
+     */
+    invoicePreviews?: Array<GetCustomerInvoicePreview> | undefined;
     /**
      * Entities associated with this customer.
      */
@@ -15541,6 +16588,72 @@ type GetPlanResponse = {
     customerEligibility?: GetPlanCustomerEligibility | undefined;
 };
 
+type GetReferralProgramParams = {
+    /**
+     * The ID of the referral program.
+     */
+    referralProgramId: string;
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+declare const GetReferralProgramRedeemOn: {
+    readonly CustomerCreation: "customer_creation";
+    readonly Checkout: "checkout";
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+type GetReferralProgramRedeemOn = OpenEnum<typeof GetReferralProgramRedeemOn>;
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+declare const GetReferralProgramReceivedBy: {
+    readonly Referrer: "referrer";
+    readonly All: "all";
+};
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+type GetReferralProgramReceivedBy = OpenEnum<typeof GetReferralProgramReceivedBy>;
+/**
+ * OK
+ */
+type GetReferralProgramResponse = {
+    /**
+     * The unique identifier for the referral program.
+     */
+    id: string;
+    /**
+     * The ID of the reward granted when a code is redeemed.
+     */
+    rewardId: string;
+    /**
+     * When the reward is granted: on redemption, or when the redeemer checks out.
+     */
+    redeemOn: GetReferralProgramRedeemOn;
+    /**
+     * Who receives the reward: the referrer only, or both parties.
+     */
+    receivedBy: GetReferralProgramReceivedBy;
+    /**
+     * The maximum number of times a referral code can be redeemed.
+     */
+    maxRedemptions?: number | null | undefined;
+    /**
+     * The plans whose checkout triggers the reward. Only used when redeem_on is checkout.
+     */
+    planIds?: Array<string> | null | undefined;
+    /**
+     * Whether checkouts that start a trial should skip granting the reward.
+     */
+    excludeTrial?: boolean | null | undefined;
+    /**
+     * The Unix timestamp (in milliseconds) when the referral program was created.
+     */
+    createdAt: number;
+};
+
 /**
  * "test" and "sandbox" both target the sandbox environment
  */
@@ -15594,6 +16707,174 @@ type GetRevenueCatKeysResponse = {
     oauthAccessToken: string | null;
 };
 
+type GetRewardParams = {
+    /**
+     * The ID of the coupon or feature grant.
+     */
+    rewardId: string;
+};
+/**
+ * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+ */
+declare const GetRewardCouponType: {
+    readonly PercentageDiscount: "percentage_discount";
+    readonly FixedDiscount: "fixed_discount";
+    readonly InvoiceCredits: "invoice_credits";
+};
+/**
+ * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+ */
+type GetRewardCouponType = OpenEnum<typeof GetRewardCouponType>;
+/**
+ * The unit of time the duration is measured in.
+ */
+declare const GetRewardDurationType: {
+    readonly OneOff: "one_off";
+    readonly Months: "months";
+    readonly Forever: "forever";
+};
+/**
+ * The unit of time the duration is measured in.
+ */
+type GetRewardDurationType = OpenEnum<typeof GetRewardDurationType>;
+/**
+ * How long the coupon applies once redeemed.
+ */
+type GetRewardDuration = {
+    /**
+     * The unit of time the duration is measured in.
+     */
+    type: GetRewardDurationType;
+    /**
+     * The number of `type` periods the duration lasts, or null when the type has no length (e.g. one_off, forever).
+     */
+    length: number | null;
+};
+type GetRewardCouponPromoCode = {
+    /**
+     * The promo code customers enter to redeem the coupon.
+     */
+    code: string;
+    /**
+     * Maximum number of times this promo code can be redeemed across all customers, or null for unlimited.
+     */
+    globalMaxRedemption?: number | null | undefined;
+    /**
+     * Whether this promo code can only be applied to a customer's first transaction.
+     */
+    firstTimeTransaction?: boolean | null | undefined;
+};
+type GetRewardCoupon = {
+    /**
+     * The unique identifier for the coupon.
+     */
+    id: string;
+    /**
+     * A human-readable name for the coupon.
+     */
+    name?: string | null | undefined;
+    /**
+     * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+     */
+    type: GetRewardCouponType;
+    /**
+     * The discount value. A percentage for percentage_discount, or an amount for fixed_discount / invoice_credits.
+     */
+    value: number;
+    /**
+     * How long the coupon applies once redeemed.
+     */
+    duration: GetRewardDuration;
+    /**
+     * The plan IDs the coupon applies to, or null when it applies to all plans.
+     */
+    planIds: Array<string> | null;
+    /**
+     * The promo codes customers can use to redeem the coupon.
+     */
+    promoCodes: Array<GetRewardCouponPromoCode>;
+    /**
+     * The Unix timestamp (in milliseconds) when the coupon was created.
+     */
+    createdAt: number;
+};
+/**
+ * The unit of time the grant lasts.
+ */
+declare const GetRewardExpiryType: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * The unit of time the grant lasts.
+ */
+type GetRewardExpiryType = OpenEnum<typeof GetRewardExpiryType>;
+type GetRewardExpiry = {
+    /**
+     * The unit of time the grant lasts.
+     */
+    type: GetRewardExpiryType;
+    /**
+     * The positive integer count of periods before the grant expires.
+     */
+    length: number;
+};
+type GetRewardGrant = {
+    /**
+     * The feature ID this grant applies to.
+     */
+    featureId: string;
+    /**
+     * The amount of the feature granted, or null for boolean features.
+     */
+    included: number | null;
+    /**
+     * How long the granted amount lasts before expiring, or null for a permanent grant.
+     */
+    expiry: GetRewardExpiry | null;
+};
+type GetRewardFeatureGrantPromoCode = {
+    /**
+     * The promo code customers enter to redeem the feature grant.
+     */
+    code: string;
+    /**
+     * Maximum number of times this promo code can be redeemed, or null for unlimited.
+     */
+    maxUses: number | null;
+};
+type GetRewardFeatureGrant = {
+    /**
+     * The unique identifier for the feature grant.
+     */
+    id: string;
+    /**
+     * A human-readable name for the feature grant.
+     */
+    name?: string | null | undefined;
+    /**
+     * The feature grants awarded when the grant is redeemed.
+     */
+    grants: Array<GetRewardGrant>;
+    /**
+     * The promo codes customers can use to redeem the feature grant.
+     */
+    promoCodes: Array<GetRewardFeatureGrantPromoCode>;
+    /**
+     * The Unix timestamp (in milliseconds) when the feature grant was created.
+     */
+    createdAt: number;
+};
+/**
+ * OK
+ */
+type GetRewardResponse = {
+    coupon?: GetRewardCoupon | undefined;
+    featureGrant?: GetRewardFeatureGrant | undefined;
+};
+
 /**
  * Base class for all HTTP errors.
  */
@@ -19165,6 +20446,70 @@ type ListPlansResponse = {
     list: Array<ListPlansList>;
 };
 
+type ListReferralProgramsParams = {};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+declare const ListReferralProgramsRedeemOn: {
+    readonly CustomerCreation: "customer_creation";
+    readonly Checkout: "checkout";
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+type ListReferralProgramsRedeemOn = OpenEnum<typeof ListReferralProgramsRedeemOn>;
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+declare const ListReferralProgramsReceivedBy: {
+    readonly Referrer: "referrer";
+    readonly All: "all";
+};
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+type ListReferralProgramsReceivedBy = OpenEnum<typeof ListReferralProgramsReceivedBy>;
+type ListReferralProgramsList = {
+    /**
+     * The unique identifier for the referral program.
+     */
+    id: string;
+    /**
+     * The ID of the reward granted when a code is redeemed.
+     */
+    rewardId: string;
+    /**
+     * When the reward is granted: on redemption, or when the redeemer checks out.
+     */
+    redeemOn: ListReferralProgramsRedeemOn;
+    /**
+     * Who receives the reward: the referrer only, or both parties.
+     */
+    receivedBy: ListReferralProgramsReceivedBy;
+    /**
+     * The maximum number of times a referral code can be redeemed.
+     */
+    maxRedemptions?: number | null | undefined;
+    /**
+     * The plans whose checkout triggers the reward. Only used when redeem_on is checkout.
+     */
+    planIds?: Array<string> | null | undefined;
+    /**
+     * Whether checkouts that start a trial should skip granting the reward.
+     */
+    excludeTrial?: boolean | null | undefined;
+    /**
+     * The Unix timestamp (in milliseconds) when the referral program was created.
+     */
+    createdAt: number;
+};
+/**
+ * OK
+ */
+type ListReferralProgramsResponse = {
+    list: Array<ListReferralProgramsList>;
+};
+
 type RewardsListParams = {};
 /**
  * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
@@ -19217,7 +20562,7 @@ type ListRewardsCouponPromoCode = {
      */
     firstTimeTransaction?: boolean | null | undefined;
 };
-type Coupon = {
+type ListRewardsCoupon = {
     /**
      * The unique identifier for the coupon.
      */
@@ -19298,7 +20643,7 @@ type ListRewardsFeatureGrantPromoCode = {
      */
     maxUses: number | null;
 };
-type FeatureGrant = {
+type ListRewardsFeatureGrant = {
     /**
      * The unique identifier for the feature grant.
      */
@@ -19327,11 +20672,11 @@ type ListRewardsResponse = {
     /**
      * The list of coupons configured for the organization.
      */
-    coupons: Array<Coupon>;
+    coupons: Array<ListRewardsCoupon>;
     /**
      * The list of feature grants configured for the organization.
      */
-    featureGrants: Array<FeatureGrant>;
+    featureGrants: Array<ListRewardsFeatureGrant>;
 };
 
 type MintKeyParams = {
@@ -30118,6 +31463,7 @@ type UpdateLicenseParent = {
     planId: string;
     version: number;
 };
+type CustomizeVariant2 = {};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -30205,19 +31551,14 @@ type VariantAddItemAdditionalCurrency = {
      */
     amount: number;
 };
-type VariantTierAdditionalCurrency = {
-    currency?: any | undefined;
-    amount?: any | undefined;
-    flatAmount?: any | undefined;
-};
 type VariantTier = {
-    to: number | string;
+    to?: any | undefined;
     amount?: number | undefined;
     flatAmount?: number | undefined;
     /**
      * Per-currency amounts for this tier. Tier boundaries ('to') are shared across all currencies.
      */
-    additionalCurrencies?: Array<VariantTierAdditionalCurrency> | undefined;
+    additionalCurrencies?: Array<any> | undefined;
 };
 declare const VariantTierBehavior: {
     readonly Graduated: "graduated";
@@ -30605,7 +31946,7 @@ type VariantUsageLimitInterval = ClosedEnum<typeof VariantUsageLimitInterval>;
  */
 type VariantFilter = {
     properties: {
-        [k: string]: string | number | boolean;
+        [k: string]: any;
     };
 };
 type VariantUsageLimit = {
@@ -30700,10 +32041,7 @@ type VariantBillingControls = {
      */
     overageAllowed?: Array<VariantOverageAllowed> | undefined;
 };
-/**
- * The exact customize patch to apply to this variant.
- */
-type VariantCustomize = {
+type CustomizeVariant1 = {
     /**
      * Override the base price of the plan. Pass null to remove the base price.
      */
@@ -30744,7 +32082,7 @@ type Variant = {
     /**
      * The exact customize patch to apply to this variant.
      */
-    customize: VariantCustomize;
+    customize: CustomizeVariant1 | CustomizeVariant2;
     /**
      * Edit this variant in place instead of versioning it for this update.
      */
@@ -32190,6 +33528,338 @@ type UpdatePlanResponse = {
     customerEligibility?: UpdatePlanCustomerEligibility | undefined;
 };
 
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+declare const UpdateReferralProgramRedeemOnRequest: {
+    readonly CustomerCreation: "customer_creation";
+    readonly Checkout: "checkout";
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+type UpdateReferralProgramRedeemOnRequest = ClosedEnum<typeof UpdateReferralProgramRedeemOnRequest>;
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+declare const UpdateReferralProgramReceivedByRequest: {
+    readonly Referrer: "referrer";
+    readonly All: "all";
+};
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+type UpdateReferralProgramReceivedByRequest = ClosedEnum<typeof UpdateReferralProgramReceivedByRequest>;
+type UpdateReferralProgramParams = {
+    /**
+     * The ID of the referral program.
+     */
+    referralProgramId: string;
+    /**
+     * The ID of the reward granted when a code is redeemed.
+     */
+    rewardId?: string | undefined;
+    /**
+     * When the reward is granted: on redemption, or when the redeemer checks out.
+     */
+    redeemOn?: UpdateReferralProgramRedeemOnRequest | undefined;
+    /**
+     * Who receives the reward: the referrer only, or both parties.
+     */
+    receivedBy?: UpdateReferralProgramReceivedByRequest | undefined;
+    /**
+     * A positive redemption limit.
+     */
+    maxRedemptions?: number | undefined;
+    /**
+     * Required when redeem_on is checkout. Plan IDs must be unique.
+     */
+    planIds?: Array<string> | undefined;
+    excludeTrial?: boolean | undefined;
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+declare const UpdateReferralProgramRedeemOnResponse: {
+    readonly CustomerCreation: "customer_creation";
+    readonly Checkout: "checkout";
+};
+/**
+ * When the reward is granted: on redemption, or when the redeemer checks out.
+ */
+type UpdateReferralProgramRedeemOnResponse = OpenEnum<typeof UpdateReferralProgramRedeemOnResponse>;
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+declare const UpdateReferralProgramReceivedByResponse: {
+    readonly Referrer: "referrer";
+    readonly All: "all";
+};
+/**
+ * Who receives the reward: the referrer only, or both parties.
+ */
+type UpdateReferralProgramReceivedByResponse = OpenEnum<typeof UpdateReferralProgramReceivedByResponse>;
+/**
+ * OK
+ */
+type UpdateReferralProgramResponse = {
+    /**
+     * The unique identifier for the referral program.
+     */
+    id: string;
+    /**
+     * The ID of the reward granted when a code is redeemed.
+     */
+    rewardId: string;
+    /**
+     * When the reward is granted: on redemption, or when the redeemer checks out.
+     */
+    redeemOn: UpdateReferralProgramRedeemOnResponse;
+    /**
+     * Who receives the reward: the referrer only, or both parties.
+     */
+    receivedBy: UpdateReferralProgramReceivedByResponse;
+    /**
+     * The maximum number of times a referral code can be redeemed.
+     */
+    maxRedemptions?: number | null | undefined;
+    /**
+     * The plans whose checkout triggers the reward. Only used when redeem_on is checkout.
+     */
+    planIds?: Array<string> | null | undefined;
+    /**
+     * Whether checkouts that start a trial should skip granting the reward.
+     */
+    excludeTrial?: boolean | null | undefined;
+    /**
+     * The Unix timestamp (in milliseconds) when the referral program was created.
+     */
+    createdAt: number;
+};
+
+type UpdateRewardCouponPromoCodeRequest = {
+    code: string;
+    globalMaxRedemption?: number | null | undefined;
+    firstTimeTransaction?: boolean | null | undefined;
+};
+type UpdateRewardCouponRequest = {
+    name?: string | undefined;
+    /**
+     * Plan IDs must be unique. Null applies the coupon to all plans.
+     */
+    planIds?: Array<string> | null | undefined;
+    /**
+     * Replaces the existing promo codes when provided.
+     */
+    promoCodes?: Array<UpdateRewardCouponPromoCodeRequest> | undefined;
+};
+/**
+ * The unit of time the grant lasts.
+ */
+declare const UpdateRewardTypeRequestBody: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * The unit of time the grant lasts.
+ */
+type UpdateRewardTypeRequestBody = ClosedEnum<typeof UpdateRewardTypeRequestBody>;
+type UpdateRewardExpiryRequest = {
+    /**
+     * The unit of time the grant lasts.
+     */
+    type: UpdateRewardTypeRequestBody;
+    /**
+     * The positive integer count of periods before the grant expires.
+     */
+    length: number;
+};
+type UpdateRewardGrantRequest = {
+    featureId: string;
+    included: number | null;
+    /**
+     * How long the granted amount lasts before expiring, or null for a permanent grant.
+     */
+    expiry: UpdateRewardExpiryRequest | null;
+};
+type UpdateRewardFeatureGrantPromoCodeRequest = {
+    code: string;
+    maxUses: number | null;
+};
+type UpdateRewardFeatureGrantRequest = {
+    name?: string | undefined;
+    /**
+     * Replaces the existing grants when provided.
+     */
+    grants?: Array<UpdateRewardGrantRequest> | undefined;
+    /**
+     * Replaces the existing promo codes when provided.
+     */
+    promoCodes?: Array<UpdateRewardFeatureGrantPromoCodeRequest> | undefined;
+};
+type UpdateRewardParams = {
+    /**
+     * The ID of the coupon or feature grant.
+     */
+    rewardId: string;
+    coupon?: UpdateRewardCouponRequest | undefined;
+    featureGrant?: UpdateRewardFeatureGrantRequest | undefined;
+};
+/**
+ * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+ */
+declare const UpdateRewardCouponType: {
+    readonly PercentageDiscount: "percentage_discount";
+    readonly FixedDiscount: "fixed_discount";
+    readonly InvoiceCredits: "invoice_credits";
+};
+/**
+ * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+ */
+type UpdateRewardCouponType = OpenEnum<typeof UpdateRewardCouponType>;
+/**
+ * The unit of time the duration is measured in.
+ */
+declare const UpdateRewardDurationType: {
+    readonly OneOff: "one_off";
+    readonly Months: "months";
+    readonly Forever: "forever";
+};
+/**
+ * The unit of time the duration is measured in.
+ */
+type UpdateRewardDurationType = OpenEnum<typeof UpdateRewardDurationType>;
+/**
+ * How long the coupon applies once redeemed.
+ */
+type UpdateRewardDuration = {
+    /**
+     * The unit of time the duration is measured in.
+     */
+    type: UpdateRewardDurationType;
+    /**
+     * The number of `type` periods the duration lasts, or null when the type has no length (e.g. one_off, forever).
+     */
+    length: number | null;
+};
+type UpdateRewardCouponPromoCodeResponse = {
+    /**
+     * The promo code customers enter to redeem the coupon.
+     */
+    code: string;
+    /**
+     * Maximum number of times this promo code can be redeemed across all customers, or null for unlimited.
+     */
+    globalMaxRedemption?: number | null | undefined;
+    /**
+     * Whether this promo code can only be applied to a customer's first transaction.
+     */
+    firstTimeTransaction?: boolean | null | undefined;
+};
+type UpdateRewardCoupon = {
+    /**
+     * The unique identifier for the coupon.
+     */
+    id: string;
+    /**
+     * A human-readable name for the coupon.
+     */
+    name?: string | null | undefined;
+    /**
+     * The type of discount: percentage_discount, fixed_discount, or invoice_credits.
+     */
+    type: UpdateRewardCouponType;
+    /**
+     * The discount value. A percentage for percentage_discount, or an amount for fixed_discount / invoice_credits.
+     */
+    value: number;
+    /**
+     * How long the coupon applies once redeemed.
+     */
+    duration: UpdateRewardDuration;
+    /**
+     * The plan IDs the coupon applies to, or null when it applies to all plans.
+     */
+    planIds: Array<string> | null;
+    promoCodes: Array<UpdateRewardCouponPromoCodeResponse>;
+    /**
+     * The Unix timestamp (in milliseconds) when the coupon was created.
+     */
+    createdAt: number;
+};
+/**
+ * The unit of time the grant lasts.
+ */
+declare const UpdateRewardExpiryTypeResponse: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * The unit of time the grant lasts.
+ */
+type UpdateRewardExpiryTypeResponse = OpenEnum<typeof UpdateRewardExpiryTypeResponse>;
+type UpdateRewardExpiryResponse = {
+    /**
+     * The unit of time the grant lasts.
+     */
+    type: UpdateRewardExpiryTypeResponse;
+    /**
+     * The positive integer count of periods before the grant expires.
+     */
+    length: number;
+};
+type UpdateRewardGrantResponse = {
+    /**
+     * The feature ID this grant applies to.
+     */
+    featureId: string;
+    /**
+     * The amount of the feature granted, or null for boolean features.
+     */
+    included: number | null;
+    /**
+     * How long the granted amount lasts before expiring, or null for a permanent grant.
+     */
+    expiry: UpdateRewardExpiryResponse | null;
+};
+type UpdateRewardFeatureGrantPromoCodeResponse = {
+    /**
+     * The promo code customers enter to redeem the feature grant.
+     */
+    code: string;
+    /**
+     * Maximum number of times this promo code can be redeemed, or null for unlimited.
+     */
+    maxUses: number | null;
+};
+type UpdateRewardFeatureGrant = {
+    /**
+     * The unique identifier for the feature grant.
+     */
+    id: string;
+    /**
+     * A human-readable name for the feature grant.
+     */
+    name?: string | null | undefined;
+    grants: Array<UpdateRewardGrantResponse>;
+    promoCodes: Array<UpdateRewardFeatureGrantPromoCodeResponse>;
+    /**
+     * The Unix timestamp (in milliseconds) when the feature grant was created.
+     */
+    createdAt: number;
+};
+/**
+ * OK
+ */
+type UpdateRewardResponse = {
+    coupon?: UpdateRewardCoupon | undefined;
+    featureGrant?: UpdateRewardFeatureGrant | undefined;
+};
+
 type OAuth2PasswordFlow = {
     username: string;
     password: string;
@@ -32459,7 +34129,8 @@ declare class Billing extends ClientSDK {
      * @param billingBehavior - Whether to prorate the immediate phase. 'none' skips proration charges and credits. (optional)
      * @param billingCycleAnchor - Pass 'now' to reset the billing cycle anchor of the immediate phase to the current time. (optional)
      * @param enablePlanImmediately - If true, the immediate-phase cusProducts are activated immediately (and scheduled-phase cusProducts pre-inserted) even when payment is pending via Stripe checkout. The Autumn schedule rows are persisted on checkout.session.completed. (optional)
-     * @param preserveAddOns - If true, active recurring add-ons in scopes represented by the phase plans are retained. (optional)
+     * @param preserveAddOns - Deprecated and ignored. Active plans the schedule does not declare are always retained. (optional)
+     * @param unscheduledPlans - Plans billed with the immediate phase that the schedule never expires or replaces. No phase may declare a plan in the same group and scope. (optional)
      * @param phases - Ordered phase definitions for the schedule.
      *
      * @returns A create-schedule response with the schedule ID, persisted phases, and any required payment or checkout URL.
@@ -33292,6 +34963,22 @@ declare class Referrals extends ClientSDK {
      * Create a referral program linked to an existing reward.
      */
     createProgram(request: CreateReferralProgramParams, options?: RequestOptions): Promise<CreateReferralProgramResponse>;
+    /**
+     * List the referral programs configured for the org.
+     */
+    listPrograms(request?: ListReferralProgramsParams | undefined, options?: RequestOptions): Promise<ListReferralProgramsResponse>;
+    /**
+     * Fetch a referral program by ID.
+     */
+    getProgram(request: GetReferralProgramParams, options?: RequestOptions): Promise<GetReferralProgramResponse>;
+    /**
+     * Update a referral program. Omitted fields keep their current value.
+     */
+    updateProgram(request: UpdateReferralProgramParams, options?: RequestOptions): Promise<UpdateReferralProgramResponse>;
+    /**
+     * Delete a referral program.
+     */
+    deleteProgram(request: DeleteReferralProgramParams, options?: RequestOptions): Promise<DeleteReferralProgramResponse>;
 }
 
 declare class Rewards extends ClientSDK {
@@ -33303,6 +34990,18 @@ declare class Rewards extends ClientSDK {
      * List the coupons and feature grants configured for the org.
      */
     list(request?: RewardsListParams | undefined, options?: RequestOptions): Promise<ListRewardsResponse>;
+    /**
+     * Fetch a coupon or feature grant by ID.
+     */
+    get(request: GetRewardParams, options?: RequestOptions): Promise<GetRewardResponse>;
+    /**
+     * Update a coupon or feature grant. Omitted fields keep their current value.
+     */
+    update(request: UpdateRewardParams, options?: RequestOptions): Promise<UpdateRewardResponse>;
+    /**
+     * Delete a coupon or feature grant.
+     */
+    delete(request: DeleteRewardParams, options?: RequestOptions): Promise<DeleteRewardResponse>;
     /**
      * Redeem a reward promo code for a customer.
      */