@stripe/extensibility-sdk 0.22.4

package/dist/extensibility-sdk-extensions-internal.d.ts

@@ -0,0 +1,1655 @@
+/**
+ * Opaque brand symbol used as a property key in SDK branded types.
+ *
+ * @remarks
+ * You do not need to use this directly — it is already embedded in
+ * branded values returned by factory functions like {@link (Integer:type)}.create().
+ * The `unique symbol` key makes the brand non-enumerable and impossible
+ * to forge without access to this symbol.
+ *
+ * @public
+ */
+declare const __brand: unique symbol;
+
+/**
+ * Unique brand symbol for the {@link Decimal} type.
+ *
+ * Using a dedicated symbol (rather than the shared `__brand`) lets formspec's
+ * structural brand-detection distinguish `Decimal` from other SDK branded
+ * types (e.g., `Ref`, `StreetAddress`) that also carry `[__brand]`.
+ *
+ * @internal
+ */
+declare const __decimalBrand: unique symbol;
+
+/**
+ * Opaque type-tag symbol used by SDK scalar types to carry Stripe type metadata.
+ *
+ * @remarks
+ * You do not need to use this directly — it is already embedded in
+ * branded values returned by factory functions like {@link (Integer:type)}.create().
+ *
+ * @public
+ */
+declare const __stripeType: unique symbol;
+
+/** @public */
+declare type AnyTimeRange = {
+    value: 'oneTime';
+    at: Date;
+} | {
+    value: 'timeRange';
+    startDate: Date;
+    endDate: Date;
+} | {
+    value: 'other';
+    otherValue: string;
+};
+
+declare namespace Bill {
+    export {
+        DiscountCalculation
+    }
+}
+
+declare namespace Billing {
+    export {
+        CustomerBalanceApplication,
+        InvoiceCollectionSetting,
+        Prorations,
+        RecurringBillingItemHandling,
+        Bill,
+        OneTime,
+        TimeRange,
+        AnyTimeRange,
+        Currency,
+        MonetaryAmount
+    }
+}
+export { Billing }
+
+/**
+ * Context values threaded into config application at runtime.
+ *
+ * The platform dispatch layer builds this from the extension context
+ * (`_configAppContextFromContext`) and passes it through the config
+ * transformer into `_applyConfig`.
+ *
+ * @internal
+ */
+declare interface _ConfigApplicationContext {
+    /** ISO 8601 clock time for Billing test clocks. */
+    clockTime?: string;
+}
+
+/** @public */
+export declare interface Context {
+    type: string;
+    id: string;
+    livemode: boolean;
+    stripeContext?: string;
+    clockTime?: string;
+}
+
+declare namespace Core {
+    export {
+        Workflows
+    }
+}
+export { Core }
+
+/** @public */
+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;
+    /** @internal */
+    function $platformWrapExecute(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        execute(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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;
+    /** @internal */
+    function $platformWrapGetFormState(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        getFormState(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * Executes the custom action at workflow runtime. Called when a workflow triggers this action, with the configured input values.
+     * @public
+     */
+    type ExecuteFunction<Config extends Record<string, unknown>> = (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 extends Record<string, unknown>> = (request: GetFormStateRequest, config: Config, context: Context) => GetFormStateResponse | PromiseLike<GetFormStateResponse>;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Core } from '@stripe/extensibility-sdk/extensions';
+ * import type { Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyCustomActionConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    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;
+    /** @internal */
+    function $platformWrapExecute(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        execute(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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;
+    /** @internal */
+    function $platformWrapGetFormState(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        getFormState(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * Executes the custom action at workflow runtime. Called when a workflow triggers this action, with the configured input values.
+     * @public
+     */
+    type ExecuteFunction<Config extends Record<string, unknown>> = (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 extends Record<string, unknown>> = (request: GetFormStateRequest, config: Config, context: Context) => GetFormStateResponse | PromiseLike<GetFormStateResponse>;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Extend } from '@stripe/extensibility-sdk/extensions';
+ * import type { Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyCustomActionConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    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;
+    /** @internal */
+    function $platformWrapComputeAppliedCustomerBalance(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        computeAppliedCustomerBalance(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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 extends Record<string, unknown>> = (request: CustomerBalanceApplicationInput, config: Config, context: Context) => CustomerBalanceApplicationResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyCustomerBalanceApplicationConfig extends Record<string, unknown> {}
+ *
+ * export default class MyCustomerBalanceApplication implements Billing.CustomerBalanceApplication<MyCustomerBalanceApplicationConfig> {
+ *   computeAppliedCustomerBalance(
+ *     request: Billing.CustomerBalanceApplication.CustomerBalanceApplicationInput,
+ *     _config: MyCustomerBalanceApplicationConfig,
+ *     _context: Context
+ *   ) {
+ *     // TODO: implement your customer balance logic here
+ *
+ *     return {
+ *       appliedCustomerBalance: request.customerBalance,
+ *     };
+ *   }
+ * }
+ *
+ * ```
+ * @public
+ */
+declare interface CustomerBalanceApplication<Config extends Record<string, unknown>> {
+    computeAppliedCustomerBalance: CustomerBalanceApplication.ComputeAppliedCustomerBalanceFunction<Config>;
+}
+
+/**
+ * Arbitrary-precision decimal type for billing calculations.
+ *
+ * @remarks
+ * `Decimal` values are created by the {@link (Decimal:variable) | Decimal companion object}
+ * and store values as `coefficient × 10^exponent` using `BigInt`. They avoid
+ * every common binary floating-point pitfall — `Decimal.from('0.1').add(Decimal.from('0.2'))`
+ * is exactly `0.3`.
+ *
+ * Instances are immutable (frozen) and all arithmetic returns a new
+ * `Decimal`. The public type carries two brand symbols so the type system
+ * prevents accidental assignment from plain `number`, `string`, or
+ * `bigint`.
+ *
+ * Create values via the companion object:
+ *
+ * @example
+ * ```ts
+ * import { Decimal, RoundDirection } from '@stripe/extensibility-sdk/stdlib';
+ *
+ * const price = Decimal.from('19.99');
+ * const tax   = price.mul(Decimal.from('0.0825'));
+ * const total = price.add(tax);
+ *
+ * console.log(total.toFixed(2, 'half-up'));   // "21.64"
+ * console.log(JSON.stringify({ total }));          // '{"total":"21.639175"}'
+ * console.log(total.toFixed(2, 'half-even')); // "21.64"
+ * ```
+ *
+ * @public
+ */
+export declare interface Decimal {
+    /**
+     * Nominal brand tag.
+     * @internal
+     */
+    readonly [__brand]: 'Decimal';
+    /** @internal */
+    readonly [__decimalBrand]: true;
+    /**
+     * Stripe type discriminator.
+     * @internal
+     */
+    readonly [__stripeType]: 'decimal';
+    /**
+     * Return the sum of this value and `other`.
+     * @public
+     */
+    add(other: Decimal): Decimal;
+    /**
+     * Return the difference of this value and `other`.
+     * @public
+     */
+    sub(other: Decimal): Decimal;
+    /**
+     * Return the product of this value and `other`.
+     * @public
+     */
+    mul(other: Decimal): Decimal;
+    /**
+     * Return the quotient of this value divided by `other`.
+     * @public
+     */
+    div(other: Decimal, precision: number, direction: RoundDirection): Decimal;
+    /**
+     * Three-way comparison: returns `-1`, `0`, or `1`.
+     * @public
+     */
+    cmp(other: Decimal): -1 | 0 | 1;
+    /**
+     * Return `true` if this value is numerically equal to `other`.
+     * @public
+     */
+    eq(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is strictly less than `other`.
+     * @public
+     */
+    lt(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is less than or equal to `other`.
+     * @public
+     */
+    lte(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is strictly greater than `other`.
+     * @public
+     */
+    gt(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is greater than or equal to `other`.
+     * @public
+     */
+    gte(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is exactly zero.
+     * @public
+     */
+    isZero(): boolean;
+    /**
+     * Return `true` if this value is strictly less than zero.
+     * @public
+     */
+    isNegative(): boolean;
+    /**
+     * Return `true` if this value is strictly greater than zero.
+     * @public
+     */
+    isPositive(): boolean;
+    /**
+     * Return the additive inverse of this value.
+     * @public
+     */
+    neg(): Decimal;
+    /**
+     * Return the absolute value.
+     * @public
+     */
+    abs(): Decimal;
+    /**
+     * Round this value to the specified precision.
+     * @public
+     */
+    round(direction: RoundDirection, options: DecimalRoundingOptions | keyof typeof DecimalRoundingPresets): Decimal;
+    /**
+     * Return the canonical string representation.
+     * @public
+     */
+    toString(): string;
+    /**
+     * Return the JSON-serializable string representation.
+     * @public
+     */
+    toJSON(): string;
+    /**
+     * Convert to a JavaScript `number` (lossy).
+     * @public
+     */
+    toNumber(): number;
+    /**
+     * Format as a fixed-point string with exactly `decimalPlaces` digits.
+     * @public
+     */
+    toFixed(decimalPlaces: number, direction: RoundDirection): string;
+    /**
+     * Rejects implicit coercion; explicit `String(d)` and template literals still work.
+     * @public
+     */
+    [Symbol.toPrimitive](hint: 'default' | 'number' | 'string'): string;
+    /**
+     * Returns the string representation; invoked by the JavaScript engine as a fallback coercion path.
+     * @public
+     */
+    valueOf(): string;
+}
+
+/**
+ * Companion object for creating `Decimal` instances.
+ *
+ * @public
+ */
+export declare const Decimal: {
+    from(value: bigint | number | string): Decimal;
+    zero: Decimal;
+};
+
+/**
+ * Precision specification for `Decimal.round()`.
+ *
+ * @remarks
+ * Two modes are supported:
+ * - `"decimal-places"` — round to a fixed number of digits after the decimal point.
+ * - `"significant-figures"` — round to a fixed number of significant digits.
+ *
+ * @example
+ * ```ts
+ * // Round to 2 decimal places
+ * amount.round('half-even', { mode: 'decimal-places', value: 2 });
+ *
+ * // Round to 4 significant figures
+ * amount.round('half-up', { mode: 'significant-figures', value: 4 });
+ * ```
+ *
+ * @public
+ */
+export declare interface DecimalRoundingOptions {
+    /** Whether to count digits from the decimal point (`"decimal-places"`) or from the most significant digit (`"significant-figures"`). */
+    mode: 'decimal-places' | 'significant-figures';
+    /**
+     * The number of digits to retain. Interpreted as decimal places when
+     * `mode` is `"decimal-places"`, or as significant figures when `mode`
+     * is `"significant-figures"`.
+     * @public
+     */
+    value: number;
+}
+
+/**
+ * Built-in rounding presets keyed by semantic name.
+ *
+ * @remarks
+ * Stripe defines the full set of supported preset names accepted by
+ * `Decimal.round()`.
+ *
+ * | Preset              | Equivalent DecimalRoundingOptions                     |
+ * | ------------------- | ----------------------------------------------------- |
+ * | `"ubb-usage-count"` | `{ mode: "significant-figures", value: 15 }`         |
+ * | `"v1-api"`          | `{ mode: "decimal-places", value: 12 }`              |
+ *
+ * @public
+ */
+export declare const DecimalRoundingPresets: Readonly<{
+    'ubb-usage-count': Readonly<{
+        mode: "significant-figures";
+        value: number;
+    }>;
+    'v1-api': Readonly<{
+        mode: "decimal-places";
+        value: number;
+    }>;
+}>;
+
+/** @public */
+declare namespace DiscountCalculation {
+    /** @public */
+    type BillingReason = 'automatic_pending_invoice_item_invoice' | 'manual' | 'subscription' | 'subscription_create' | 'subscription_cycle' | 'subscription_cancel' | 'subscription_threshold' | 'subscription_trial_ended' | 'subscription_update' | 'upcoming' | 'quote_accept';
+    /** @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' | 'week' | 'month' | '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;
+    /** @internal */
+    function $platformWrapComputeDiscounts(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        computeDiscounts(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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 extends Record<string, unknown>> = (request: DiscountableItem, config: Config, context: Context) => DiscountResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing } from '@stripe/extensibility-sdk/extensions';
+ * import type { Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyDiscountCalculationConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    computeDiscounts: DiscountCalculation.ComputeDiscountsFunction<Config>;
+}
+
+declare namespace Extend {
+    export {
+        Workflows_2 as Workflows
+    }
+}
+export { Extend }
+
+/** @public */
+declare namespace InvoiceCollectionSetting {
+    /** @public */
+    type ParentType = 'subscription' | 'contract' | 'quote' | 'billing_cadence' | 'subscription_schedule' | 'standalone';
+    /** @public */
+    type PaymentMethodType = 'card' | 'ach_debit' | 'ach_credit_transfer' | 'sepa_debit' | 'sepa_credit_transfer' | 'bacs_debit' | 'au_becs_debit' | 'us_bank_account' | 'link' | 'boleto' | 'oxxo' | 'ideal' | 'bancontact' | 'giropay' | 'eps' | 'p24' | 'sofort' | 'alipay' | 'wechat_pay' | 'klarna' | 'affirm' | 'afterpay_clearpay' | 'cashapp' | 'paypal' | 'multibanco' | 'konbini' | 'promptpay' | 'paynow' | 'grabpay' | 'fpx';
+    /** @public */
+    type CollectionMethod = 'send_invoice' | 'charge_automatically';
+    /**
+     * 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 = {
+        /** The current collection settings that would be applied to the invoice. */
+        collectionSettings: CollectionSettings;
+        /** The billing resource that triggered invoice creation. */
+        parent: Parent;
+    } & ({
+        payer: 'customer';
+        customer: Customer;
+    } | {
+        payer: 'other';
+        otherPayer: string;
+    });
+    /** @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;
+    /** @internal */
+    function $platformWrapCollectionOverride(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        collectionOverride(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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 extends Record<string, unknown>> = (request: InvoiceCollectionRequest, config: Config, context: Context) => InvoiceCollectionResponse;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyInvoiceCollectionSettingConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    collectionOverride: InvoiceCollectionSetting.CollectionOverrideFunction<Config>;
+}
+
+/**
+ * Represents a monetary value with amount and currency.
+ * @format monetary-amount
+ * @public
+ */
+declare interface MonetaryAmount {
+    /** The numerical value. */
+    amount: Decimal;
+    /** The currency code. */
+    currency: Currency;
+}
+
+/**
+ * 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;
+}
+
+/** @public */
+declare namespace Prorations {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'week' | 'month' | '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 = {
+        /** Unique identifier for the item. */
+        key: string;
+        /** Either CREDIT or DEBIT based on whether the item is a credit or debit. */
+        type: ItemType;
+        /** Whether the item was generated from a proration event. */
+        isProration: boolean;
+        /** The time period this item covers. */
+        servicePeriod: TimeRange;
+        /** The default proration factor calculated by Stripe. */
+        currentProrationFactor: Decimal;
+        /** The duration of the price interval in seconds. */
+        priceIntervalDuration: number;
+        /** Information about the corresponding debit that a CREDIT item credits against. */
+        correspondingDebit?: PreviousDebit;
+    } & ({
+        priceKind: 'price';
+        price: Price;
+    } | {
+        priceKind: 'licenseFee';
+        licenseFee: LicenseFee;
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    } | {
+        priceKind: 'customPricingUnitOverageRate';
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+    } | {
+        priceKind: 'other';
+        otherPriceKind: string;
+    });
+    /**
+     * 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;
+    /** @internal */
+    function $platformWrapProrateItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        prorateItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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 extends Record<string, unknown>> = (request: ProrateItemsInput, config: Config, context: Context) => ProrateItemsResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyProrationsConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    prorateItems: Prorations.ProrateItemsFunction<Config>;
+}
+
+/** @public */
+declare namespace RecurringBillingItemHandling {
+    /** @public */
+    type PricingTierMode = 'graduated' | 'volume';
+    /** @public */
+    type RecurringPriceInterval = 'day' | 'week' | 'month' | '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 = {
+        /** Unique identifier for the item. */
+        key: string;
+        /** Either CREDIT or DEBIT based on whether the item is a credit or debit. */
+        type: ItemType;
+        /** Whether the item was generated from a proration event. */
+        isProration: boolean;
+        /** The time period this item covers. */
+        servicePeriod: AnyTimeRange;
+        /** The proration factor for this item. */
+        prorationFactor: Decimal;
+    } & ({
+        priceKind: 'price';
+        price: Price;
+    } | {
+        priceKind: 'licenseFee';
+        licenseFee: LicenseFee;
+    } | {
+        priceKind: 'rateCardRate';
+        rateCardRate: RateCardRate;
+    } | {
+        priceKind: 'customPricingUnitOverageRate';
+        customPricingUnitOverageRate: CustomPricingUnitOverageRate;
+    } | {
+        priceKind: 'other';
+        otherPriceKind: string;
+    });
+    /** @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 = {
+        /** The unique identifier of the item, matching a key from the input. */
+        key: string;
+    } & ({
+        creationStrategy: 'doNotCreate';
+    } | {
+        creationStrategy: 'invoice';
+    } | {
+        creationStrategy: 'other';
+        otherCreationStrategy: 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;
+    /** @internal */
+    function $platformWrapBeforeItemCreation(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        beforeItemCreation(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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;
+    /** @internal */
+    function $platformWrapFilterItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        filterItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * @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;
+    /** @internal */
+    function $platformWrapGroupItems(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => {
+        groupItems(...a: unknown[]): unknown;
+    }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
+    /**
+     * Runs before invoice items are created. Decides whether each item should be created or skipped.
+     * @public
+     */
+    type BeforeItemCreationFunction<Config extends Record<string, unknown>> = (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 extends Record<string, unknown>> = (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 extends Record<string, unknown>> = (request: GroupItemsInput, config: Config, context: Context) => GroupItemsResult;
+}
+
+/**
+ * @example
+ * ```ts
+ * import type { Billing, Context } from '@stripe/extensibility-sdk/extensions';
+ *
+ * // eslint-disable-next-line @typescript-eslint/no-empty-object-type
+ * interface MyRecurringBillingItemHandlingConfig extends Record<string, unknown> {}
+ *
+ * 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 extends Record<string, unknown>> {
+    beforeItemCreation: RecurringBillingItemHandling.BeforeItemCreationFunction<Config>;
+    filterItems: RecurringBillingItemHandling.FilterItemsFunction<Config>;
+    groupItems: RecurringBillingItemHandling.GroupItemsFunction<Config>;
+}
+
+/**
+ * Rounding direction for Decimal operations.
+ *
+ * @remarks
+ * Seven modes corresponding to
+ * {@link https://standards.ieee.org/ieee/754/6210/ | IEEE 754-2019} §4.3
+ * rounding-direction attributes:
+ *
+ * | Direction      | IEEE 754 name           | Behavior                          | Examples (→ integer)                  |
+ * | -------------- | ----------------------- | --------------------------------- | ------------------------------------- |
+ * | `'ceil'`       | `roundTowardPositive`   | Toward +∞                         |  1.1→2, -1.1→-1                       |
+ * | `'floor'`      | `roundTowardNegative`   | Toward -∞                         |  1.9→1, -1.1→-2                       |
+ * | `'round-down'` | `roundTowardZero`       | Toward zero (truncate)            |  1.9→1, -1.9→-1                       |
+ * | `'round-up'`   | —                       | Away from zero                    |  1.1→2, -1.1→-2                       |
+ * | `'half-up'`    | `roundTiesToAway`       | Nearest; ties away from zero      |  0.5→1, -0.5→-1, 1.4→1               |
+ * | `'half-down'`  | —                       | Nearest; ties toward zero         |  0.5→0, -0.5→0, 1.6→2                |
+ * | `'half-even'`  | `roundTiesToEven`       | Nearest; ties to even (banker's)  |  0.5→0, 1.5→2, 2.5→2, 3.5→4          |
+ *
+ * @public
+ */
+export declare type RoundDirection = 'ceil' | 'floor' | 'half-down' | 'half-even' | 'half-up' | 'round-down' | 'round-up';
+
+/**
+ * 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;
+}
+
+declare namespace Workflows {
+    export {
+        CustomAction
+    }
+}
+
+declare namespace Workflows_2 {
+    export {
+        CustomAction_2 as CustomAction
+    }
+}
+
+export { }