@stripe/extensibility-sdk 1.1.0 → 1.3.0

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

@@ -85,6 +85,58 @@ declare type AnyTimeRange = {
     value: 'other';
 };
 
+/**
+ * Stage-2 outgoing strategy: transforms API-JSON to proto wire format.
+ * Performs structural transformations (camelCase → snake_case key renaming,
+ * SDK enum → proto enum translation, discriminated union → proto oneof,
+ * plain string → `{value: string}` decimal wrapping).
+ *
+ * @internal
+ */
+export declare const _ApiJsonToProto: _ApiJsonToProtoStrategy;
+
+/**
+ * Branded strategy for API-JSON → proto wire (stage 2 outgoing).
+ * Performs structural transformations (key renaming back to snake_case,
+ * enum translation to proto values, union restructuring to oneof, decimal
+ * wrapping as `{value: string}`).
+ *
+ * @internal
+ */
+export declare interface _ApiJsonToProtoStrategy extends _ApplyStrategy {
+    /**
+     * Brand marker distinguishing this strategy from other `_ApplyStrategy` implementations.
+     * @internal
+     */
+    readonly _brand: 'ApiJsonToProto';
+}
+
+/**
+ * Stage-2 incoming strategy: hydrates SDK objects from API-JSON.
+ * Reads from camelCase keys (already renamed by stage 1), constructs
+ * Decimal and Date instances from plain strings, validates required
+ * fields, and recursively hydrates nested shapes and unions that are
+ * already in discriminated form.
+ *
+ * @internal
+ */
+export declare const _ApiJsonToType: _ApiJsonToTypeStrategy;
+
+/**
+ * Branded strategy for API-JSON → SDK types (stage 2 incoming).
+ * Hydrates JS objects (Decimal, Date) from the already-restructured
+ * API-JSON intermediate format.
+ *
+ * @internal
+ */
+export declare interface _ApiJsonToTypeStrategy extends _ApplyStrategy {
+    /**
+     * Brand marker distinguishing this strategy from other `_ApplyStrategy` implementations.
+     * @internal
+     */
+    readonly _brand: 'ApiJsonToType';
+}
+
 /**
  * Apply a strategy to a field array, transforming each field.
  * The strategy determines direction (proto→SDK, SDK→proto, or JSON→SDK).
@@ -105,15 +157,13 @@ export declare function _applyConfig<T, S extends _JsonWireToTypeStrategy>(descr
 
 /**
  * Apply _ProtoWireToType to a descriptor, returning the typed SDK value.
- * Eliminates the `as unknown as T` exit cast at call sites.
  *
  * @internal
  */
 export declare function _applyIncoming<T, S extends _ProtoWireToTypeStrategy>(descriptor: _ShapeDescriptor<S, T>, inputObject: unknown): T;
 
 /**
- * Apply _TypeToProtoWire to a descriptor. The input is typed as `T`,
- * catching wrong-direction mistakes at compile time.
+ * Apply _TypeToProtoWire to a descriptor.
  *
  * @internal
  */
@@ -225,6 +275,13 @@ export declare class _ConfigEnum implements _EnumSpec {
     toWire(value: string): null | string;
 }
 
+/**
+ * Union of strategies that process config data (JSON → SDK types).
+ *
+ * @internal
+ */
+export declare type _ConfigStrategy = _JsonWireToTypeStrategy;
+
 /** @public */
 export declare interface Context {
     type: string;
@@ -242,7 +299,7 @@ declare namespace Core {
 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';
+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' | 'mon' | 'mop' | 'mro' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'ngn' | 'nio' | 'nok' | 'npr' | 'nzd' | 'omr' | 'open_usd' | 'ord' | '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' | 'usdsui' | '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 {
@@ -252,7 +309,7 @@ declare namespace CustomAction {
      */
     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>;
+        values?: Record<string, unknown>;
         /** Per-field configuration keyed by field name. */
         config: Record<string, FormStateFieldConfig>;
     }
@@ -302,28 +359,8 @@ declare namespace CustomAction {
         /** 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;
     /**
@@ -388,7 +425,7 @@ declare namespace CustomAction_2 {
      */
     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>;
+        values?: Record<string, unknown>;
         /** Per-field configuration keyed by field name. */
         config: Record<string, FormStateFieldConfig>;
     }
@@ -438,28 +475,8 @@ declare namespace CustomAction_2 {
         /** 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;
     /**
@@ -536,28 +553,8 @@ declare namespace CustomerBalanceApplication {
         /** 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
@@ -1035,28 +1032,8 @@ declare namespace DiscountCalculation {
         /** 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
@@ -1158,6 +1135,16 @@ export declare type _FieldTransformer = (strategy: _ApplyStrategy, value: unknow
  */
 export declare const _identity: _FieldTransformer;
 
+/**
+ * Union of strategies that process incoming runtime data (proto-JSON or
+ * API-JSON). Descriptors branded with this type can be used with either the
+ * full composed pipeline (_ProtoWireToType) or just the hydration stage
+ * (_ApiJsonToType) when structural transformation has already occurred.
+ *
+ * @internal
+ */
+export declare type _IncomingRuntimeStrategy = _ApiJsonToTypeStrategy | _ProtoWireToTypeStrategy;
+
 /** A branded integer — a `number` guaranteed to satisfy `Number.isInteger`. @public */
 export declare type Integer = {
     readonly [__integerBrand]: true;
@@ -1213,8 +1200,8 @@ declare namespace InvoiceCollectionOptions {
      * @public
      */
     interface InvoiceCollectionOptionsResult {
-        /** Override the auto-advancement setting. Set to false to keep the invoice in draft. Return null to use the default. */
-        autoAdvance?: boolean;
+        /** Override the auto-advancement setting. Set to false to keep the invoice in draft. */
+        autoAdvance: boolean;
     }
     /** @public */
     type InvoiceCollectionOptionsInput = ({
@@ -1265,28 +1252,8 @@ declare namespace InvoiceCollectionOptions {
         /** The payment methods configured for this invoice. */
         paymentMethods: PaymentMethodType[];
     }
-    /**
-     * @public
-     * @deprecated Platform dispatch handles wire/SDK conversion.
-     */
-    function prepareArgsOverrideOptions(proto: unknown): InvoiceCollectionOptionsInput;
-    /**
-     * @public
-     * @deprecated Platform dispatch handles wire/SDK conversion.
-     */
-    function prepareResultOverrideOptions(result: InvoiceCollectionOptionsResult): InvoiceCollectionOptionsResult;
     /** @internal */
     function $platformWrapOverrideOptions(configTransformer?: (wireConfig: unknown, appCtx: _ConfigApplicationContext) => unknown): (cls: new () => { overrideOptions(...a: unknown[]): unknown }, wireArgs: unknown, wireConfig: unknown, ctx: unknown) => unknown;
-    /**
-     * @public
-     * @deprecated Platform dispatch handles wire/SDK conversion.
-     */
-    const prepareArgs: typeof prepareArgsOverrideOptions;
-    /**
-     * @public
-     * @deprecated Platform dispatch handles wire/SDK conversion.
-     */
-    const prepareResult: typeof prepareResultOverrideOptions;
     /**
      * Overrides invoice collection options before a draft invoice is created.
      * @public
@@ -1304,13 +1271,13 @@ declare namespace InvoiceCollectionOptions {
  *
  * export default class MyInvoiceCollectionOptions implements Billing.InvoiceCollectionOptions<MyInvoiceCollectionOptionsConfig> {
  *   overrideOptions(
- *     _request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
+ *     request: Billing.InvoiceCollectionOptions.InvoiceCollectionOptionsInput,
  *     _config: MyInvoiceCollectionOptionsConfig,
  *     _context: Context
  *   ) {
  *     // TODO: implement your collection setting logic here
  *
- *     return {};
+ *     return { autoAdvance: request.collectionOptions.autoAdvance };
  *   }
  * }
  *
@@ -1399,6 +1366,17 @@ declare interface OneTime {
     at: Date;
 }
 
+/**
+ * Union of strategies that process outgoing runtime data (SDK types to
+ * proto-JSON or API-JSON). Descriptors branded with this type can be used
+ * with either the full composed pipeline (_TypeToProtoWire) or just the
+ * dehydration stage (_TypeToApiJson) when structural transformation will
+ * occur externally.
+ *
+ * @internal
+ */
+export declare type _OutgoingRuntimeStrategy = _TypeToApiJsonStrategy | _TypeToProtoWireStrategy;
+
 /**
  * Represents a percentage number value (0-100).
  * @format percent
@@ -1598,28 +1576,8 @@ declare namespace Prorations {
         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
@@ -1680,7 +1638,35 @@ export declare class _ProtoEnum implements _EnumSpec {
 }
 
 /**
- * Strategy for transforming incoming proto wire data to SDK types.
+ * Stage-1 incoming strategy: transforms proto wire data to API-JSON.
+ * Performs all structural operations (key renaming, enum translation,
+ * union/oneof restructuring) but leaves values as plain JSON -- decimals
+ * become plain strings (unwrapped from the proto `{value}` wrapper) and
+ * datetimes pass through as ISO strings.
+ *
+ * @internal
+ */
+export declare const _ProtoToApiJson: _ProtoToApiJsonStrategy;
+
+/**
+ * Branded strategy for proto wire → API-JSON (stage 1 incoming).
+ * Performs structural transformations (key renaming, enum translation,
+ * union restructuring, decimal unwrapping) without hydrating JS objects.
+ *
+ * @internal
+ */
+export declare interface _ProtoToApiJsonStrategy extends _ApplyStrategy {
+    /**
+     * Brand marker distinguishing this strategy from other `_ApplyStrategy` implementations.
+     * @internal
+     */
+    readonly _brand: 'ProtoToApiJson';
+}
+
+/**
+ * Composed incoming strategy (proto wire → SDK types).
+ * Delegates structural work to {@link _ProtoToApiJson} and hydration to
+ * {@link _ApiJsonToType}, composed at the per-field-translator level.
  *
  * @internal
  */
@@ -1940,40 +1926,10 @@ declare namespace RecurringBillingItemHandling {
         /** 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;
     /**
@@ -2225,7 +2181,34 @@ export declare function _translateShape(getDesc: () => _ShapeDescriptor): _Field
 export declare function _translateUnion(getDesc: () => _UnionDescriptor): _FieldTransformer;
 
 /**
- * Strategy for transforming outgoing SDK types to proto wire data.
+ * Stage-1 outgoing strategy: dehydrates SDK objects to API-JSON.
+ * Converts Decimal → string, Date → ISO string, but keeps camelCase keys
+ * and SDK enum values unchanged (structural transformation is stage 2).
+ *
+ * @internal
+ */
+export declare const _TypeToApiJson: _TypeToApiJsonStrategy;
+
+/**
+ * Branded strategy for SDK types → API-JSON (stage 1 outgoing).
+ * Dehydrates JS objects (Decimal → string, Date → ISO string) without
+ * performing structural transformations (key renaming stays camelCase).
+ *
+ * @internal
+ */
+export declare interface _TypeToApiJsonStrategy extends _ApplyStrategy {
+    /**
+     * Brand marker distinguishing this strategy from other `_ApplyStrategy` implementations.
+     * @internal
+     */
+    readonly _brand: 'TypeToApiJson';
+}
+
+/**
+ * Composed outgoing strategy (SDK types → proto wire).
+ * Delegates dehydration to {@link _TypeToApiJson} and structural
+ * transformation to {@link _ApiJsonToProto}, composed at the
+ * per-field-translator level.
  *
  * @internal
  */