@stripe/extensibility-sdk 0.22.4 → 0.24.0

package/dist/extensibility-sdk-beta.d.ts

@@ -4,7 +4,7 @@
  * Lean runtime for Stripe script extensions.
  *
  * - Standard library utilities (Decimal, Integer, Ref, etc.)
- * - Extension interfaces via `./extensions` subpath
+ * - Extension interfaces (Billing, Core, Extend namespaces, Context)
  *
  * @packageDocumentation
  */
@@ -39,6 +39,19 @@ export declare const __brand: unique symbol;
  */
 export declare const __stripeType: unique symbol;
 
+/** @public */
+declare type AnyTimeRange = {
+    at: Date;
+    value: 'oneTime';
+} | {
+    endDate: Date;
+    startDate: Date;
+    value: 'timeRange';
+} | {
+    otherValue: string;
+    value: 'other';
+};
+
 /* Excluded from this release type: _apply */
 
 /* Excluded from this release type: _applyConfig */
@@ -49,6 +62,28 @@ export declare const __stripeType: unique symbol;
 
 /* Excluded from this release type: _ApplyStrategy */
 
+declare namespace Bill {
+    export {
+        DiscountCalculation
+    }
+}
+
+declare namespace Billing {
+    export {
+        CustomerBalanceApplication,
+        InvoiceCollectionSetting,
+        Prorations,
+        RecurringBillingItemHandling,
+        Bill,
+        OneTime,
+        TimeRange,
+        AnyTimeRange,
+        Currency,
+        MonetaryAmount
+    }
+}
+export { Billing }
+
 /** The type of the opaque brand symbol used as a property key in SDK branded types. @public */
 export declare type BrandSymbol = typeof __brand;
 
@@ -58,9 +93,370 @@ export declare type BrandSymbol = typeof __brand;
 
 /* Excluded from this release type: _ConfigEnum */
 
+/** @public */
+export declare interface Context {
+    type: string;
+    id: string;
+    livemode: boolean;
+    stripeContext?: string;
+    clockTime?: string;
+}
+
+declare namespace Core {
+    export {
+        Workflows
+    }
+}
+export { Core }
+
 /** @public */
 export declare type Currency = 'aed' | 'afn' | 'all' | 'amd' | 'ang' | 'aoa' | 'apt' | 'arb' | 'ars' | 'aud' | 'avax' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnb' | 'bnd' | 'bob' | 'bov' | 'brl' | 'bsd' | 'btc' | 'btn' | 'buidl' | 'bwp' | 'byn' | 'byr' | 'bzd' | 'cad' | 'cdf' | 'celo' | 'che' | 'chf' | 'chw' | 'clf' | 'clp' | 'cny' | 'cop' | 'cou' | 'crc' | 'cuc' | 'cup' | 'cve' | 'czk' | 'dai' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'eek' | 'egp' | 'ern' | 'etb' | 'eth' | 'eur' | 'eurc' | 'fjd' | 'fkp' | 'frxusd' | 'gbp' | 'gel' | 'ghc' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'hype' | 'idr' | 'ils' | 'inr' | 'iqd' | 'irr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'kpw' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'ltl' | 'lvl' | 'lyd' | 'lzd' | 'm' | 'mad' | 'mdl' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mro' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nio' | 'nok' | 'npr' | 'nzd' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pol' | 'pyg' | 'pyusd' | 'qar' | 'rd' | 're' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sdg' | 'sek' | 'sgd' | 'shp' | 'sle' | 'sll' | 'sol' | 'sos' | 'srd' | 'ssp' | 'std' | 'stn' | 'sui' | 'svc' | 'syp' | 'szl' | 'thb' | 'tjs' | 'tmt' | 'tnd' | 'top' | 'trx' | 'try' | 'ttd' | 'twd' | 'tzs' | 'uah' | 'ugx' | 'usd' | 'usdb' | 'usdc' | 'usdg' | 'usdp' | 'usdt' | 'usn' | 'ustb' | 'uyi' | 'uyu' | 'uzs' | 'vef' | 'ves' | 'vnd' | 'vuv' | 'wst' | 'xaf' | 'xcd' | 'xcg' | 'xeur' | 'xlm' | 'xof' | 'xpf' | 'xpl' | 'xusd' | 'yer' | 'zar' | 'zmk' | 'zmw' | 'zwd' | 'zwg' | 'zwl';
 
+/** @public */
+declare namespace CustomAction {
+    /**
+     * Response payload for GetFormState.
+     * @public
+     */
+    interface GetFormStateResponse {
+        /** Updated form field values. Use this to set defaults, clear dependent fields when a parent changes, or preserve matching values across schema changes. Only fields included here are updated. Omitted fields keep their current values. */
+        values: Record<string, unknown>;
+        /** Per-field configuration keyed by field name. */
+        config: Record<string, FormStateFieldConfig>;
+    }
+    /**
+     * Configuration for a single form field, returned by GetFormState.
+     * @public
+     */
+    interface FormStateFieldConfig {
+        /** Dropdown options for `dynamic_select` fields. */
+        options: SelectOption[];
+        /** JSON Schema for dynamic_schema fields. Defines the structure of a dynamic object field (for example, template merge variables). V0 limitation: must be a flat object with string properties only. */
+        schema: Record<string, unknown>;
+        /** Whether the field is disabled (non-interactive). */
+        disabled?: boolean;
+        /** Whether the field is hidden from the form. */
+        hidden?: boolean;
+        /** Warning message displayed on the field. You can still save the workflow. */
+        warning?: string;
+        /** Error message displayed on the field. Blocks saving the workflow. */
+        error?: string;
+    }
+    /**
+     * An option in a dynamic_select dropdown.
+     * @public
+     */
+    interface SelectOption {
+        value: string;
+        label: string;
+    }
+    /**
+     * Request payload for GetFormState, sent at configuration time.
+     * @public
+     */
+    interface GetFormStateRequest {
+        /** Current form field values. Contains all field values in the form, including fields the user has not yet interacted with (which might be null). */
+        values: Record<string, unknown>;
+        /** The name of the field that just changed, triggering this request. Empty on initial form load; set to the field name (for example, `audience_id`) when a user changes a value. */
+        changedField?: string;
+    }
+    /** @public */
+    type ExecuteCustomActionResponse = Record<string, never>;
+    /**
+     * **************************************************************************** DEPRECATED: This proto is deprecated and should no longer be used. Please use the following proto instead: ***************************************************************************** / /** Request payload for executing a custom action, provided at workflow runtime.
+     * @public
+     */
+    interface ExecuteCustomActionRequest {
+        /** Custom input data for the action, validated against the app's input_schema. Contains the field values configured by the user in the workflow builder. */
+        customInput: Record<string, unknown>;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsExecute(proto: unknown): ExecuteCustomActionRequest;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultExecute(result: ExecuteCustomActionResponse): ExecuteCustomActionResponse;
+    /* Excluded from this release type: $platformWrapExecute */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsGetFormState(proto: unknown): GetFormStateRequest;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultGetFormState(result: GetFormStateResponse): GetFormStateResponse;
+    /* Excluded from this release type: $platformWrapGetFormState */
+    /**
+     * Executes the custom action at workflow runtime. Called when a workflow triggers this action, with the configured input values.
+     * @public
+     */
+    type ExecuteFunction<Config> = (request: ExecuteCustomActionRequest, config: Config, context: Context) => ExecuteCustomActionResponse | PromiseLike<ExecuteCustomActionResponse>;
+    /**
+     * Returns the current form state for the action's configuration UI. Called at configuration time (not runtime) to power dynamic form behavior, including dropdown options, dynamic JSON schemas, field visibility, and validation.
+     * @public
+     */
+    type GetFormStateFunction<Config> = (request: GetFormStateRequest, config: Config, context: Context) => GetFormStateResponse | PromiseLike<GetFormStateResponse>;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Core, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyCustomActionConfig {}
+ *
+ * export default class MyCustomAction implements Core.Workflows
+ * .CustomAction<MyCustomActionConfig> {
+ * execute(
+ * _request: Core.Workflows.CustomAction.ExecuteCustomActionRequest,
+ * _config: MyCustomActionConfig,
+ * _context: Context
+ * ) {
+ * // TODO: implement your action logic here
+ *
+ * return {};
+ * }
+ *
+ * getFormState(
+ * _request: Core.Workflows.CustomAction.GetFormStateRequest,
+ * _config: MyCustomActionConfig,
+ * _context: Context
+ * ) {
+ * // TODO: implement your logic here
+ *
+ * return {
+ * values: {},
+ * config: {},
+ * };
+ * }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface CustomAction<Config> {
+    execute: CustomAction.ExecuteFunction<Config>;
+    getFormState?: CustomAction.GetFormStateFunction<Config>;
+}
+
+/** @public */
+declare namespace CustomAction_2 {
+    /**
+     * Response payload for GetFormState.
+     * @public
+     */
+    interface GetFormStateResponse {
+        /** Updated form field values. Use this to set defaults, clear dependent fields when a parent changes, or preserve matching values across schema changes. Only fields included here are updated. Omitted fields keep their current values. */
+        values: Record<string, unknown>;
+        /** Per-field configuration keyed by field name. */
+        config: Record<string, FormStateFieldConfig>;
+    }
+    /**
+     * Configuration for a single form field, returned by GetFormState.
+     * @public
+     */
+    interface FormStateFieldConfig {
+        /** Dropdown options for `dynamic_select` fields. */
+        options: SelectOption[];
+        /** JSON Schema for dynamic_schema fields. Defines the structure of a dynamic object field (for example, template merge variables). V0 limitation: must be a flat object with string properties only. */
+        schema: Record<string, unknown>;
+        /** Whether the field is disabled (non-interactive). */
+        disabled?: boolean;
+        /** Whether the field is hidden from the form. */
+        hidden?: boolean;
+        /** Warning message displayed on the field. You can still save the workflow. */
+        warning?: string;
+        /** Error message displayed on the field. Blocks saving the workflow. */
+        error?: string;
+    }
+    /**
+     * An option in a dynamic_select dropdown.
+     * @public
+     */
+    interface SelectOption {
+        value: string;
+        label: string;
+    }
+    /**
+     * Request payload for GetFormState, sent at configuration time.
+     * @public
+     */
+    interface GetFormStateRequest {
+        /** Current form field values. Contains all field values in the form, including fields the user has not yet interacted with (which might be null). */
+        values: Record<string, unknown>;
+        /** The name of the field that just changed, triggering this request. Empty on initial form load; set to the field name (for example, `audience_id`) when a user changes a value. */
+        changedField?: string;
+    }
+    /** @public */
+    type ExecuteCustomActionResponse = Record<string, never>;
+    /**
+     * Request payload for executing a custom action, provided at workflow runtime.
+     * @public
+     */
+    interface ExecuteCustomActionRequest {
+        /** Custom input data for the action, validated against the app's input_schema. Contains the field values configured by the user in the workflow builder. */
+        customInput: Record<string, unknown>;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsExecute(proto: unknown): ExecuteCustomActionRequest;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultExecute(result: ExecuteCustomActionResponse): ExecuteCustomActionResponse;
+    /* Excluded from this release type: $platformWrapExecute */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsGetFormState(proto: unknown): GetFormStateRequest;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultGetFormState(result: GetFormStateResponse): GetFormStateResponse;
+    /* Excluded from this release type: $platformWrapGetFormState */
+    /**
+     * Executes the custom action at workflow runtime. Called when a workflow triggers this action, with the configured input values.
+     * @public
+     */
+    type ExecuteFunction<Config> = (request: ExecuteCustomActionRequest, config: Config, context: Context) => ExecuteCustomActionResponse | PromiseLike<ExecuteCustomActionResponse>;
+    /**
+     * Returns the current form state for the action's configuration UI. Called at configuration time (not runtime) to power dynamic form behavior, including dropdown options, dynamic JSON schemas, field visibility, and validation.
+     * @public
+     */
+    type GetFormStateFunction<Config> = (request: GetFormStateRequest, config: Config, context: Context) => GetFormStateResponse | PromiseLike<GetFormStateResponse>;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Extend, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyCustomActionConfig {}
+ *
+ * export default class MyCustomAction implements Extend.Workflows
+ *   .CustomAction<MyCustomActionConfig> {
+ *   execute(
+ *     _request: Extend.Workflows.CustomAction.ExecuteCustomActionRequest,
+ *     _config: MyCustomActionConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your action logic here
+ *
+ *     return {};
+ *   }
+ *
+ *   getFormState(
+ *     _request: Extend.Workflows.CustomAction.GetFormStateRequest,
+ *     _config: MyCustomActionConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your logic here
+ *
+ *     return {
+ *       values: {},
+ *       config: {},
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface CustomAction_2<Config> {
+    execute: CustomAction_2.ExecuteFunction<Config>;
+    getFormState?: CustomAction_2.GetFormStateFunction<Config>;
+}
+
+/** @public */
+declare namespace CustomerBalanceApplication {
+    /**
+     * The result of computing how much customer balance to apply to a bill.
+     * @public
+     */
+    interface CustomerBalanceApplicationResult {
+        /** The amount of customer balance to apply to this invoice. Positive values increase the invoice amount (applying a debit), negative values decrease it (applying a credit). Set to zero to apply no balance. */
+        appliedCustomerBalance: MonetaryAmount;
+    }
+    /**
+     * The bill details provided as input to the customer balance application extension.
+     * @public
+     */
+    interface CustomerBalanceApplicationInput {
+        /** The total amount of the invoice before applying any customer balance. */
+        totalAmount: MonetaryAmount;
+        /** The current customer balance available to apply. Positive values indicate debits (the customer owes money), negative values indicate credits. */
+        customerBalance: MonetaryAmount;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsComputeAppliedCustomerBalance(proto: unknown): CustomerBalanceApplicationInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultComputeAppliedCustomerBalance(result: CustomerBalanceApplicationResult): CustomerBalanceApplicationResult;
+    /* Excluded from this release type: $platformWrapComputeAppliedCustomerBalance */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareArgs: typeof prepareArgsComputeAppliedCustomerBalance;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareResult: typeof prepareResultComputeAppliedCustomerBalance;
+    /**
+     * Determines how much of the customer's balance to apply toward a bill total. The script receives the invoice total and current customer balance, then returns how much of that balance to apply.
+     * @public
+     */
+    type ComputeAppliedCustomerBalanceFunction<Config> = (request: CustomerBalanceApplicationInput, config: Config, context: Context) => CustomerBalanceApplicationResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyBalanceAppConfig {}
+ *
+ * export default class MyBalanceApp implements Billing.CustomerBalanceApplication<MyBalanceAppConfig> {
+ *   computeAppliedCustomerBalance(
+ *     request: Billing.CustomerBalanceApplication.CustomerBalanceApplicationInput,
+ *     _config: MyBalanceAppConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your customer balance logic here
+ *
+ *     return {
+ *       appliedCustomerBalance: request.customerBalance,
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface CustomerBalanceApplication<Config> {
+    computeAppliedCustomerBalance: CustomerBalanceApplication.ComputeAppliedCustomerBalanceFunction<Config>;
+}
+
 /**
  * Arbitrary-precision decimal type for billing calculations.
  *
@@ -293,8 +689,235 @@ export declare const DecimalRoundingPresets: Readonly<{
  */
 export declare const DEFAULT_DIV_PRECISION = 34;
 
+/** @public */
+declare namespace DiscountCalculation {
+    /** @public */
+    type BillingReason = 'automatic_pending_invoice_item_invoice' | 'manual' | 'quote_accept' | 'subscription_cancel' | 'subscription_create' | 'subscription_cycle' | 'subscription_threshold' | 'subscription_trial_ended' | 'subscription_update' | 'subscription' | 'upcoming';
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type PriceType = 'one_time' | 'recurring';
+    /** @public */
+    type PricingScheme = 'per_unit' | 'tiered';
+    /** @public */
+    type UsageType = 'licensed' | 'metered';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'month' | 'week' | 'year';
+    /**
+     * The result of a discount calculation.
+     * @public
+     */
+    interface DiscountResult {
+        /** The computed discount to apply. */
+        discount: Discount;
+    }
+    /**
+     * A discount to apply to a discountable item.
+     * @public
+     */
+    interface Discount {
+        /** The discount amount to subtract from the discountable item. */
+        amount: MonetaryAmount;
+    }
+    /**
+     * An item eligible for discount calculation, containing its line items and billing context.
+     * @public
+     */
+    interface DiscountableItem {
+        /** The individual line items that make up the discountable item. */
+        lineItems: DiscountableLineItem[];
+        /** The total gross amount of the discountable item before any discounts. */
+        grossAmount: MonetaryAmount;
+        /** The customer associated with the discountable item. */
+        customer?: Customer;
+        /** The reason this item is being billed. */
+        billingReason?: BillingReason;
+        /** The subscription associated with the discountable item. */
+        subscription?: Subscription;
+    }
+    /**
+     * The subscription associated with the discountable item.
+     * @public
+     */
+    interface Subscription {
+        /** The unique identifier of the subscription. */
+        id: string;
+        /** The Unix timestamp of the billing cycle anchor. */
+        billingCycleAnchor?: number;
+        /** The structured billing cycle anchor configuration. */
+        billingCycleAnchorConfig?: BillingCycleAnchorConfig;
+        /** Custom key-value pairs attached to the subscription. */
+        metadata: Record<string, string>;
+    }
+    /**
+     * Configuration for the billing cycle anchor, specifying when recurring billing periods start.
+     * @public
+     */
+    interface BillingCycleAnchorConfig {
+        /** The month component of the billing cycle anchor. */
+        month: number;
+        /** The day of the month for the billing cycle anchor. */
+        dayOfMonth: number;
+        /** The hour component of the billing cycle anchor. */
+        hour: number;
+        /** The minute component of the billing cycle anchor. */
+        minute: number;
+        /** The second component of the billing cycle anchor. */
+        second: number;
+    }
+    /**
+     * The customer associated with the discountable item.
+     * @public
+     */
+    interface Customer {
+        /** The unique identifier of the customer. */
+        id: string;
+        /** Custom key-value pairs attached to the customer. */
+        metadata: Record<string, string>;
+    }
+    /**
+     * A single line item within a discountable item.
+     * @public
+     */
+    interface DiscountableLineItem {
+        /** The subtotal amount of this line item. */
+        subtotal: MonetaryAmount;
+        /** The quantity of this line item. */
+        quantity?: Decimal;
+        /** The billing period this line item covers. */
+        period: AnyTimeRange;
+        /** The price information for this line item. */
+        price?: Price;
+    }
+    /**
+     * The price associated with a line item.
+     * @public
+     */
+    interface Price {
+        /** The unique identifier for the price. */
+        id: string;
+        /** The product this price belongs to. */
+        product?: Product;
+        /** The recurring pricing configuration, if applicable. */
+        recurring?: RecurringPrice;
+        /** The billing scheme, either per-unit or tiered. */
+        billingScheme?: PricingScheme;
+        /** The pricing tiers, applicable for tiered billing schemes. */
+        tiers: PriceTier[];
+        /** The price type, either one-time or recurring. */
+        type?: PriceType;
+        /** The tiering mode, either graduated or volume. */
+        tiersMode?: PricingTierMode;
+        /** Key-value metadata attached to the price. */
+        metadata: Record<string, string>;
+        /** The unit amount of the price. */
+        unitAmount?: Decimal;
+    }
+    /**
+     * A tier within a tiered pricing structure.
+     * @public
+     */
+    interface PriceTier {
+        /** The flat fee charged for this tier. */
+        flatAmount?: Decimal;
+        /** The per-unit price for this tier. */
+        unitAmount?: Decimal;
+        /** The upper bound of the tier range. */
+        upTo?: Decimal;
+    }
+    /**
+     * The recurring pricing configuration for a price.
+     * @public
+     */
+    interface RecurringPrice {
+        /** The billing interval for the recurring price. */
+        interval: RecurringPriceInterval;
+        /** The number of intervals between each billing cycle. */
+        intervalCount: number;
+        /** The usage type, either licensed or metered. */
+        usageType?: UsageType;
+        /** The identifier of the meter tracking usage for this price. */
+        meter?: string;
+    }
+    /**
+     * The product associated with a price.
+     * @public
+     */
+    interface Product {
+        /** The unique identifier of the product. */
+        id: string;
+        /** The name of the product. */
+        name: string;
+        /** Custom key-value pairs attached to the product. */
+        metadata: Record<string, string>;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsComputeDiscounts(proto: unknown): DiscountableItem;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultComputeDiscounts(result: DiscountResult): DiscountResult;
+    /* Excluded from this release type: $platformWrapComputeDiscounts */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareArgs: typeof prepareArgsComputeDiscounts;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareResult: typeof prepareResultComputeDiscounts;
+    /**
+     * Computes discount amounts for a discountable item and returns a discount result.
+     * @public
+     */
+    type ComputeDiscountsFunction<Config> = (request: DiscountableItem, config: Config, context: Context) => DiscountResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyDiscountCalculationConfig {}
+ *
+ * export default class MyDiscountCalculation implements Billing.Bill
+ *   .DiscountCalculation<MyDiscountCalculationConfig> {
+ *   computeDiscounts(
+ *     request: Billing.Bill.DiscountCalculation.DiscountableItem,
+ *     _config: MyDiscountCalculationConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your discount logic here
+ *
+ *     return {
+ *       discount: { amount: request.grossAmount },
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface DiscountCalculation<Config> {
+    computeDiscounts: DiscountCalculation.ComputeDiscountsFunction<Config>;
+}
+
 /* Excluded from this release type: _EnumSpec */
 
+declare namespace Extend {
+    export {
+        Workflows_2 as Workflows
+    }
+}
+export { Extend }
+
 /**
  * Extracts the string literal type of the `object` property from T.
  *
@@ -337,6 +960,117 @@ export declare const Integer: {
  */
 export declare type IntegerRoundDirection = 'ceil' | 'floor' | 'half-up' | 'round-down' | 'round-up';
 
+/** @public */
+declare namespace InvoiceCollectionSetting {
+    /** @public */
+    type ParentType = 'billing_cadence' | 'contract' | 'quote' | 'standalone' | 'subscription_schedule' | 'subscription';
+    /** @public */
+    type PaymentMethodType = 'ach_credit_transfer' | 'ach_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'boleto' | 'card' | 'cashapp' | 'eps' | 'fpx' | 'giropay' | 'grabpay' | 'ideal' | 'klarna' | 'konbini' | 'link' | 'multibanco' | 'oxxo' | 'p24' | 'paynow' | 'paypal' | 'promptpay' | 'sepa_credit_transfer' | 'sepa_debit' | 'sofort' | 'us_bank_account' | 'wechat_pay';
+    /** @public */
+    type CollectionMethod = 'charge_automatically' | 'send_invoice';
+    /**
+     * The result of the invoice collection settings override extension.
+     * @public
+     */
+    interface InvoiceCollectionResponse {
+        /** Override the auto-advancement setting. Set to false to keep the invoice in draft. Return null to use the default. */
+        autoAdvance?: boolean;
+    }
+    /** @public */
+    type InvoiceCollectionRequest = ({
+        customer: Customer;
+        payer: 'customer';
+    } | {
+        otherPayer: string;
+        payer: 'other';
+    }) & {
+        collectionSettings: CollectionSettings;
+        parent: Parent;
+    };
+    /** @public */
+    interface Customer {
+        id: string;
+        metadata: Record<string, string>;
+    }
+    /**
+     * The parent resource that triggered the invoice creation.
+     * @public
+     */
+    interface Parent {
+        /** The type of parent resource (for example, subscription or contract). */
+        type: ParentType;
+        /** Custom key-value pairs attached to the parent resource. */
+        metadata: Record<string, string>;
+    }
+    /**
+     * The collection settings for an invoice.
+     * @public
+     */
+    interface CollectionSettings {
+        /** Whether the invoice automatically advances through its lifecycle. */
+        autoAdvance: boolean;
+        /** The payment collection method: charge_automatically or send_invoice. */
+        collectionMethod: CollectionMethod;
+        /** The delay before the invoice is finalized, in hours. */
+        finalizationGracePeriod: number;
+        /** The payment methods configured for this invoice. */
+        paymentMethods: PaymentMethodType[];
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsCollectionOverride(proto: unknown): InvoiceCollectionRequest;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultCollectionOverride(result: InvoiceCollectionResponse): InvoiceCollectionResponse;
+    /* Excluded from this release type: $platformWrapCollectionOverride */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareArgs: typeof prepareArgsCollectionOverride;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareResult: typeof prepareResultCollectionOverride;
+    /**
+     * Overrides invoice collection settings before a draft invoice is created.
+     * @public
+     */
+    type CollectionOverrideFunction<Config> = (request: InvoiceCollectionRequest, config: Config, context: Context) => InvoiceCollectionResponse;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionSettingConfig {}
+ *
+ * export default class MyInvoiceCollectionSetting implements Billing.InvoiceCollectionSetting<MyInvoiceCollectionSettingConfig> {
+ *   collectionOverride(
+ *     _request: Billing.InvoiceCollectionSetting.InvoiceCollectionRequest,
+ *     _config: MyInvoiceCollectionSettingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your collection setting logic here
+ *
+ *     return {};
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface InvoiceCollectionSetting<Config> {
+    collectionOverride: InvoiceCollectionSetting.CollectionOverrideFunction<Config>;
+}
+
 /**
  * Check whether a value is a `Decimal` instance.
  *
@@ -378,6 +1112,25 @@ export declare interface MonetaryAmount {
 
 /* Excluded from this release type: _OneofFieldDescriptor */
 
+/**
+ * Represents a one-time event occurring at a specific date.
+ * @public
+ */
+declare interface OneTime {
+    /** The date and time of the event. */
+    at: Date;
+}
+
+/**
+ * Represents a percentage number value (0-100).
+ * @format percent
+ * @public
+ */
+export declare interface Percent {
+    /** The percentage value. */
+    value: number;
+}
+
 /**
  * A branded non-negative integer — a `number` guaranteed to be an integer ≥ 0.
  *
@@ -407,12 +1160,525 @@ export declare const PositiveInteger: {
     is: (value: number) => value is PositiveInteger;
 };
 
+/** @public */
+declare namespace Prorations {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'month' | 'week' | 'year';
+    /** @public */
+    type PriceType = 'one_time' | 'recurring';
+    /** @public */
+    type PricingScheme = 'per_unit' | 'tiered';
+    /** @public */
+    type UsageType = 'licensed' | 'metered';
+    /** @public */
+    type ItemType = 'credit' | 'debit';
+    /**
+     * The result of the prorations extension.
+     * @public
+     */
+    interface ProrateItemsResult {
+        /** The items with computed proration factors. */
+        items: ItemWithProration[];
+    }
+    /**
+     * An item with a computed proration factor.
+     * @public
+     */
+    interface ItemWithProration {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+        /** The computed proration factor. Positive for charges, negative for credits. */
+        prorationFactor: Decimal;
+        /** The displayed period for the invoice line item. */
+        lineItemPeriod: TimeRange;
+    }
+    /**
+     * The input to the prorations extension.
+     * @public
+     */
+    interface ProrateItemsInput {
+        /** The list of items that can have their proration factor and line item period modified. */
+        items: ProratableItem[];
+    }
+    /** @public */
+    type ProratableItem = ({
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+        priceKind: 'customPricingUnitOverageRate';
+    } | {
+        licenseFee: LicenseFee;
+        priceKind: 'licenseFee';
+    } | {
+        otherPriceKind: string;
+        priceKind: 'other';
+    } | {
+        price: Price;
+        priceKind: 'price';
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    }) & {
+        correspondingDebit?: PreviousDebit;
+        currentProrationFactor: Decimal;
+        isProration: boolean;
+        key: string;
+        priceIntervalDuration: number;
+        servicePeriod: TimeRange;
+        type: ItemType;
+    };
+    /**
+     * Information about a previous debit that a credit item offsets.
+     * @public
+     */
+    interface PreviousDebit {
+        /** The service period of the corresponding debit. */
+        servicePeriod: TimeRange;
+    }
+    /** @public */
+    interface CustomPricingUnitOverageRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        customPricingUnit: string;
+        unitAmount: Decimal;
+    }
+    /** @public */
+    interface RateCard {
+        id: string;
+        currency: Currency;
+    }
+    /** @public */
+    interface RateCardRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        tieringMode?: PricingTierMode;
+        tiers: RateCardRateTier[];
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface RateCardRateTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface LicenseFee {
+        id: string;
+        lookupKey?: string;
+        metadata: Record<string, string>;
+        serviceInterval: RecurringPriceInterval;
+        serviceIntervalCount: number;
+        tieringMode?: PricingTierMode;
+        tiers: LicenseFeeTier[];
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface LicenseFeeTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface Price {
+        id: string;
+        product: Product;
+        recurring?: RecurringPrice;
+        billingScheme: PricingScheme;
+        tiers: PriceTier[];
+        type: PriceType;
+        tiersMode?: PricingTierMode;
+        metadata: Record<string, string>;
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface PriceTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: number;
+    }
+    /** @public */
+    interface RecurringPrice {
+        interval: RecurringPriceInterval;
+        intervalCount: number;
+        usageType?: UsageType;
+        meter?: string;
+    }
+    /** @public */
+    interface Product {
+        id: string;
+        name: string;
+        metadata: Record<string, string>;
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsProrateItems(proto: unknown): ProrateItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultProrateItems(result: ProrateItemsResult): ProrateItemsResult;
+    /* Excluded from this release type: $platformWrapProrateItems */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareArgs: typeof prepareArgsProrateItems;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    const prepareResult: typeof prepareResultProrateItems;
+    /**
+     * Calculates prorated amounts for subscription items when changes occur mid-billing period. The script receives the invoice items, then returns computed proration factors for each item.
+     * @public
+     */
+    type ProrateItemsFunction<Config> = (request: ProrateItemsInput, config: Config, context: Context) => ProrateItemsResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyProrationsConfig {}
+ *
+ * export default class MyProrations implements Billing.Prorations<MyProrationsConfig> {
+ *   prorateItems(
+ *     _request: Billing.Prorations.ProrateItemsInput,
+ *     _config: MyProrationsConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your proration logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface Prorations<Config> {
+    prorateItems: Prorations.ProrateItemsFunction<Config>;
+}
+
 /* Excluded from this release type: _ProtoEnum */
 
 /* Excluded from this release type: _ProtoWireToType */
 
 /* Excluded from this release type: _ProtoWireToTypeStrategy */
 
+/** @public */
+declare namespace RecurringBillingItemHandling {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'month' | 'week' | 'year';
+    /** @public */
+    type PriceType = 'one_time' | 'recurring';
+    /** @public */
+    type PricingScheme = 'per_unit' | 'tiered';
+    /** @public */
+    type UsageType = 'licensed' | 'metered';
+    /** @public */
+    type ItemType = 'credit' | 'debit';
+    /**
+     * The result of the group items extension.
+     * @public
+     */
+    interface GroupItemsResult {
+        /** The groups of items, each corresponding to a separate invoice. */
+        groups: ItemGroup[];
+    }
+    /**
+     * A group of items to place on a single invoice.
+     * @public
+     */
+    interface ItemGroup {
+        /** The items in this group. */
+        items: GroupedItem[];
+        /** Whether this group sets the latest invoice reference on the subscription. */
+        setsLatestInvoice: boolean;
+    }
+    /**
+     * An item assigned to a group.
+     * @public
+     */
+    interface GroupedItem {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    }
+    /**
+     * The input to the group items extension.
+     * @public
+     */
+    interface GroupItemsInput {
+        /** The list of items to group across invoices. */
+        items: Item[];
+    }
+    /** @public */
+    type Item = ({
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+        priceKind: 'customPricingUnitOverageRate';
+    } | {
+        licenseFee: LicenseFee;
+        priceKind: 'licenseFee';
+    } | {
+        otherPriceKind: string;
+        priceKind: 'other';
+    } | {
+        price: Price;
+        priceKind: 'price';
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    }) & {
+        isProration: boolean;
+        key: string;
+        prorationFactor: Decimal;
+        servicePeriod: AnyTimeRange;
+        type: ItemType;
+    };
+    /** @public */
+    interface CustomPricingUnitOverageRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        customPricingUnit: string;
+        unitAmount: Decimal;
+    }
+    /** @public */
+    interface RateCard {
+        id: string;
+        currency: Currency;
+    }
+    /** @public */
+    interface RateCardRate {
+        id: string;
+        metadata: Record<string, string>;
+        rateCard: RateCard;
+        tieringMode?: PricingTierMode;
+        tiers: RateCardRateTier[];
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface RateCardRateTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface LicenseFee {
+        id: string;
+        lookupKey?: string;
+        metadata: Record<string, string>;
+        serviceInterval: RecurringPriceInterval;
+        serviceIntervalCount: number;
+        tieringMode?: PricingTierMode;
+        tiers: LicenseFeeTier[];
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface LicenseFeeTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: Decimal;
+    }
+    /** @public */
+    interface Price {
+        id: string;
+        product: Product;
+        recurring?: RecurringPrice;
+        billingScheme: PricingScheme;
+        tiers: PriceTier[];
+        type: PriceType;
+        tiersMode?: PricingTierMode;
+        metadata: Record<string, string>;
+        currency: Currency;
+        unitAmount?: Decimal;
+    }
+    /** @public */
+    interface PriceTier {
+        flatAmount?: Decimal;
+        unitAmount?: Decimal;
+        upTo?: number;
+    }
+    /** @public */
+    interface RecurringPrice {
+        interval: RecurringPriceInterval;
+        intervalCount: number;
+        usageType?: UsageType;
+        meter?: string;
+    }
+    /** @public */
+    interface Product {
+        id: string;
+        name: string;
+        metadata: Record<string, string>;
+    }
+    /**
+     * The result of the filter items extension.
+     * @public
+     */
+    interface FilterItemsResult {
+        /** The items to include on the invoice. */
+        items: ItemToInvoice[];
+    }
+    /**
+     * An item selected for inclusion on the invoice.
+     * @public
+     */
+    interface ItemToInvoice {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    }
+    /**
+     * The input to the filter items extension.
+     * @public
+     */
+    interface FilterItemsInput {
+        /** The list of items to evaluate for inclusion on the invoice. */
+        items: Item[];
+    }
+    /**
+     * The result of the before item creation extension.
+     * @public
+     */
+    interface BeforeItemCreationResult {
+        /** The items with their creation strategies. */
+        items: ItemWithCreationStrategy[];
+    }
+    /** @public */
+    type ItemWithCreationStrategy = ({
+        creationStrategy: 'other';
+        otherCreationStrategy: string;
+    } | { creationStrategy: 'doNotCreate' } | { creationStrategy: 'invoice' }) & { key: string };
+    /** @public */
+    type Invoice = Record<string, never>;
+    /** @public */
+    type DoNotCreate = Record<string, never>;
+    /**
+     * The input to the before item creation extension.
+     * @public
+     */
+    interface BeforeItemCreationInput {
+        /** The list of items to evaluate for creation. */
+        items: Item[];
+    }
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsBeforeItemCreation(proto: unknown): BeforeItemCreationInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultBeforeItemCreation(result: BeforeItemCreationResult): BeforeItemCreationResult;
+    /* Excluded from this release type: $platformWrapBeforeItemCreation */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsFilterItems(proto: unknown): FilterItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultFilterItems(result: FilterItemsResult): FilterItemsResult;
+    /* Excluded from this release type: $platformWrapFilterItems */
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareArgsGroupItems(proto: unknown): GroupItemsInput;
+    /**
+     * @public
+     * @deprecated Platform dispatch handles wire/SDK conversion.
+     */
+    function prepareResultGroupItems(result: GroupItemsResult): GroupItemsResult;
+    /* Excluded from this release type: $platformWrapGroupItems */
+    /**
+     * Runs before invoice items are created. Decides whether each item should be created or skipped.
+     * @public
+     */
+    type BeforeItemCreationFunction<Config> = (request: BeforeItemCreationInput, config: Config, context: Context) => BeforeItemCreationResult;
+    /**
+     * Runs before invoices are created. Decides which items to include on the invoice. Items not included are deferred as pending invoice items.
+     * @public
+     */
+    type FilterItemsFunction<Config> = (request: FilterItemsInput, config: Config, context: Context) => FilterItemsResult;
+    /**
+     * Runs before invoices are created. Decides how items are grouped across one or more invoices.
+     * @public
+     */
+    type GroupItemsFunction<Config> = (request: GroupItemsInput, config: Config, context: Context) => GroupItemsResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyRecurringBillingItemHandlingConfig {}
+ *
+ * export default class MyRecurringBillingItemHandling implements Billing.RecurringBillingItemHandling<MyRecurringBillingItemHandlingConfig> {
+ *   beforeItemCreation(
+ *     _request: Billing.RecurringBillingItemHandling.BeforeItemCreationInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your before-item-creation logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ *
+ *   filterItems(
+ *     _request: Billing.RecurringBillingItemHandling.FilterItemsInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your filter-items logic here
+ *
+ *     return {
+ *       items: [],
+ *     };
+ *   }
+ *
+ *   groupItems(
+ *     _request: Billing.RecurringBillingItemHandling.GroupItemsInput,
+ *     _config: MyRecurringBillingItemHandlingConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your group-items logic here
+ *
+ *     return {
+ *       groups: [],
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface RecurringBillingItemHandling<Config> {
+    beforeItemCreation: RecurringBillingItemHandling.BeforeItemCreationFunction<Config>;
+    filterItems: RecurringBillingItemHandling.FilterItemsFunction<Config>;
+    groupItems: RecurringBillingItemHandling.GroupItemsFunction<Config>;
+}
+
 /**
  * Object reference — a typed pointer to another API resource.
  *
@@ -482,6 +1748,17 @@ export declare const StreetAddress: { create: (address: string) => StreetAddress
 /** The type of the opaque Stripe type-tag symbol used in SDK scalar types. @public */
 export declare type StripeTypeSymbol = typeof __stripeType;
 
+/**
+ * Represents a time period with start and end dates.
+ * @public
+ */
+declare interface TimeRange {
+    /** The beginning date of the range. */
+    startDate: Date;
+    /** The ending date of the range. */
+    endDate: Date;
+}
+
 /** A branded string representing an ISO 8601 datetime. @public */
 export declare type Timestamp = {
     readonly [__brand]: 'Timestamp';
@@ -539,4 +1816,16 @@ export declare class WireWriteError extends Error {
     /* Excluded from this release type: name */
 }
 
+declare namespace Workflows {
+    export {
+        CustomAction
+    }
+}
+
+declare namespace Workflows_2 {
+    export {
+        CustomAction_2 as CustomAction
+    }
+}
+
 export { }