@proxy-checkout/stripe-server-js 0.1.0-prx-146.161.1 → 0.1.0

package/dist/esm/types.d.ts

@@ -10,109 +10,17 @@ export type StripeMetadataValue = string | number | null;
 export type StripeMetadata = Record<string, StripeMetadataValue> | null | undefined;
 export type StripeMetadataParam = Record<string, StripeMetadataValue> | undefined;
 export interface StripeCheckoutSessionLike {
-    readonly amount_subtotal?: number | null;
-    readonly amount_total?: number | null;
     readonly client_secret?: string | null;
-    readonly currency?: string | null;
-    readonly customer?: null | string | {
-        readonly id: string;
-    };
     readonly id: string;
-    readonly line_items?: StripeCheckoutLineItemListLike | null;
     readonly metadata?: StripeMetadata;
-    readonly mode?: "payment" | "setup" | "subscription" | null;
-    readonly payment_intent?: string | {
-        readonly id: string;
-    } | null;
-    readonly payment_status?: "no_payment_required" | "paid" | "unpaid" | string;
-    readonly status?: "complete" | "expired" | "open" | string | null;
-    readonly ui_mode?: string | null;
-    readonly url?: string | null;
-}
-export interface StripeCheckoutLineItemListLike {
-    readonly data?: readonly StripeCheckoutLineItemLike[];
-    readonly has_more?: boolean;
-}
-export interface StripeCheckoutLineItemLike {
-    readonly description?: string | null;
-    readonly id?: string;
-    readonly price?: string | {
-        readonly currency?: string | null;
-        readonly id?: string;
-        readonly product?: string | {
-            readonly id?: string;
-        } | null;
-        readonly recurring?: {
-            readonly interval?: string;
-            readonly interval_count?: number;
-            readonly usage_type?: string;
-        } | null;
-        readonly type?: "one_time" | "recurring" | string;
-        readonly unit_amount?: number | null;
-        readonly unit_amount_decimal?: unknown;
-    } | null;
-    readonly quantity?: number | null;
-}
-export interface StripeCheckoutLineItemPageLike extends StripeCheckoutLineItemListLike {
 }
 export interface StripeSubscriptionLike {
-    readonly customer?: string | StripeObjectReferenceLike | null;
-    readonly default_payment_method?: string | StripeObjectReferenceLike | null;
     readonly id: string;
-    readonly latest_invoice?: string | StripeInvoiceLike | null;
     readonly metadata?: StripeMetadata;
-    readonly status?: string | null;
 }
 export interface StripePaymentIntentLike {
-    readonly amount?: number;
-    readonly amount_received?: number;
-    readonly capture_method?: "automatic" | "automatic_async" | "manual" | string;
-    readonly client_secret?: string | null;
-    readonly currency?: string;
-    readonly customer?: null | string | {
-        readonly id: string;
-    };
-    readonly id: string;
-    readonly metadata?: StripeMetadata;
-    readonly status?: "canceled" | "processing" | "requires_action" | "requires_capture" | "requires_confirmation" | "requires_payment_method" | "succeeded" | string;
-}
-export interface StripeObjectReferenceLike {
-    readonly id: string;
-}
-export interface StripeSetupIntentLike {
-    readonly client_secret?: string | null;
-    readonly customer?: string | StripeObjectReferenceLike | null;
     readonly id: string;
     readonly metadata?: StripeMetadata;
-    readonly payment_method?: string | StripeObjectReferenceLike | null;
-    readonly payment_method_types?: readonly string[];
-    readonly status?: string;
-    readonly usage?: string;
-}
-export interface StripePaymentMethodLike {
-    readonly customer?: string | StripeObjectReferenceLike | null;
-    readonly id: string;
-}
-export interface StripePriceLike {
-    readonly active?: boolean;
-    readonly currency?: string;
-    readonly id: string;
-    readonly recurring?: {
-        readonly interval?: string;
-        readonly interval_count?: number;
-        readonly usage_type?: string;
-    } | null;
-    readonly unit_amount?: number | null;
-}
-export interface StripeInvoiceLike {
-    readonly amount_due?: number;
-    readonly confirmation_secret?: {
-        readonly client_secret?: string | null;
-        readonly type?: string;
-    } | null;
-    readonly id: string;
-    readonly payment_intent?: string | StripePaymentIntentLike | null;
-    readonly status?: string | null;
 }
 export interface StripeCheckoutSessionUpdateParams {
     readonly line_items?: unknown;
@@ -124,77 +32,10 @@ export type StripeCheckoutSessionCreateParams = object & {
             readonly enabled?: boolean;
         };
     };
-    readonly line_items?: unknown;
     readonly metadata?: StripeMetadataParam;
     readonly mode?: "payment" | "setup" | "subscription";
     readonly payment_intent_data?: unknown;
-    readonly return_url?: string;
-    readonly success_url?: string;
     readonly subscription_data?: unknown;
-    readonly ui_mode?: string;
-};
-export type StripePaymentIntentCreateParams = object & {
-    readonly amount?: number;
-    readonly application_fee_amount?: number;
-    readonly application_fee_percent?: number;
-    readonly capture_method?: string;
-    readonly currency?: string;
-    readonly metadata?: StripeMetadataParam;
-    readonly on_behalf_of?: unknown;
-    readonly transfer_data?: unknown;
-};
-export type StripeSetupIntentCreateParams = object & {
-    readonly customer?: string;
-    readonly metadata?: StripeMetadataParam;
-    readonly payment_method?: unknown;
-    readonly payment_method_types?: readonly string[];
-    readonly usage?: string;
-};
-export interface StripeSubscriptionItemCreateParamsLike {
-    readonly price?: string;
-    readonly price_data?: unknown;
-    readonly quantity?: number;
-}
-export interface StripeSubscriptionPaymentSettingsLike {
-    readonly payment_method_options?: {
-        readonly card?: {
-            readonly request_three_d_secure?: "any" | "automatic";
-        };
-    };
-}
-/**
- * Narrow create shape used by the direct Subscription helper. Additional
- * merchant fields remain structurally accepted, then the runtime option policy
- * rejects fields that would move pricing or collection outside the supported
- * fixed `charge_automatically` contract.
- */
-export type StripeSubscriptionCreateParams = object & {
-    readonly add_invoice_items?: unknown;
-    readonly application_fee_percent?: unknown;
-    readonly automatic_tax?: {
-        readonly enabled?: boolean;
-    } | null;
-    readonly billing_cycle_anchor?: unknown;
-    readonly cancel_at?: unknown;
-    readonly collection_method?: string;
-    readonly customer?: string;
-    readonly days_until_due?: unknown;
-    readonly default_payment_method?: string;
-    readonly discounts?: readonly unknown[];
-    readonly expand?: readonly string[];
-    readonly invoice_settings?: unknown;
-    readonly items?: readonly StripeSubscriptionItemCreateParamsLike[];
-    readonly metadata?: StripeMetadataParam;
-    readonly off_session?: unknown;
-    readonly on_behalf_of?: unknown;
-    readonly payment_behavior?: string;
-    readonly payment_settings?: StripeSubscriptionPaymentSettingsLike;
-    readonly pending_invoice_item_interval?: unknown;
-    readonly proration_behavior?: string;
-    readonly schedule?: unknown;
-    readonly transfer_data?: unknown;
-    readonly trial_end?: number | "now";
-    readonly trial_period_days?: number;
 };
 export interface StripeRequestOptionsLike {
     readonly idempotencyKey?: string;
@@ -206,51 +47,11 @@ export interface StripeRequestOptionsWithoutIdempotencyLike {
 }
 export interface StripeCheckoutSessionsApiLike {
     create(params: unknown, options?: unknown): Promise<StripeCheckoutSessionLike>;
-    listLineItems?(id: string, params?: unknown, options?: unknown): Promise<StripeCheckoutLineItemPageLike>;
     retrieve(id: string, params?: unknown, options?: unknown): Promise<StripeCheckoutSessionLike>;
-}
-/** Checkout Session mutation is used only by the legacy cart-sync helper. */
-export interface StripeMutableCheckoutSessionsApiLike extends StripeCheckoutSessionsApiLike {
     update(id: string, params: unknown, options?: unknown): Promise<StripeCheckoutSessionLike>;
 }
-export interface StripePaymentIntentsApiLike {
-    create(params: unknown, options?: unknown): Promise<StripePaymentIntentLike>;
-    retrieve(id: string, params?: unknown, options?: unknown): Promise<StripePaymentIntentLike>;
-}
-export interface StripeSetupIntentsApiLike {
-    create(params: unknown, options?: unknown): Promise<StripeSetupIntentLike>;
-    retrieve(id: string, params?: unknown, options?: unknown): Promise<StripeSetupIntentLike>;
-}
-export interface StripeSubscriptionsApiLike {
-    create(params: unknown, options?: unknown): Promise<StripeSubscriptionLike>;
-    retrieve(id: string, params?: unknown, options?: unknown): Promise<StripeSubscriptionLike>;
-}
-export interface StripePaymentMethodsApiLike {
-    retrieve(id: string, params?: unknown, options?: unknown): Promise<StripePaymentMethodLike>;
-}
-export interface StripePricesApiLike {
-    retrieve(id: string, params?: unknown, options?: unknown): Promise<StripePriceLike>;
-}
-export interface StripeSetupIntentClientLike {
-    readonly setupIntents: StripeSetupIntentsApiLike;
-}
-export interface StripeDirectSubscriptionClientLike {
-    readonly paymentMethods: StripePaymentMethodsApiLike;
-    readonly prices: StripePricesApiLike;
-    readonly subscriptions: StripeSubscriptionsApiLike;
-}
-export type StripeSetupSubscriptionClientLike = StripeDirectSubscriptionClientLike & StripeSetupIntentClientLike;
 export interface StripeClientLike {
     readonly checkout: {
         readonly sessions: StripeCheckoutSessionsApiLike;
     };
-    readonly paymentIntents?: StripePaymentIntentsApiLike;
-}
-export interface StripeMutableCheckoutClientLike extends StripeClientLike {
-    readonly checkout: {
-        readonly sessions: StripeMutableCheckoutSessionsApiLike;
-    };
-}
-export interface StripePaymentIntentClientLike {
-    readonly paymentIntents: StripePaymentIntentsApiLike;
 }

package/dist/esm/version.d.ts

@@ -1,2 +1,2 @@
 export declare const proxyCheckoutStripeServerSdkName = "@proxy-checkout/stripe-server-js";
-export declare const proxyCheckoutStripeServerSdkVersion = "0.1.0-prx-146.161.1";
+export declare const proxyCheckoutStripeServerSdkVersion = "0.1.0";

package/dist/esm/version.js

@@ -1,2 +1,2 @@
 export const proxyCheckoutStripeServerSdkName = "@proxy-checkout/stripe-server-js";
-export const proxyCheckoutStripeServerSdkVersion = "0.1.0-prx-146.161.1";
+export const proxyCheckoutStripeServerSdkVersion = "0.1.0";

package/package.json

@@ -1,5 +1,5 @@
 {
-  "description": "Server-side Stripe adapter for Proxy Checkout acquisition, Checkout, SetupIntent, direct Subscription, and cart sync workflows.",
+  "description": "Server-side Stripe adapter for Proxy Checkout: required metadata, provider binding, openCheckout, and cart sync.",
   "license": "MIT",
   "module": "./dist/esm/index.js",
   "name": "@proxy-checkout/stripe-server-js",
@@ -7,14 +7,14 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/esm/index.d.ts",
-  "version": "0.1.0-prx-146.161.1",
+  "version": "0.1.0",
   "devDependencies": {
     "@types/node": "^24.12.4",
     "@vitest/coverage-v8": "4.1.7",
     "stripe": "^21.0.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.7",
-    "@proxy-checkout/server-js": "0.1.0-prx-146.161.1"
+    "@proxy-checkout/server-js": "0.1.0"
   },
   "exports": {
     ".": {

package/dist/cjs/acquisition.d.cts

@@ -1,189 +0,0 @@
-import type { PayerOpenedResult, ProviderAcquisition, ProviderAcquisitionCartConfirmationInput, ProviderAcquisitionCheckoutUiMode, ProviderAcquisitionCommercialMode, ProviderAcquisitionDirectSubscriptionSource, ProviderAcquisitionIntegrationPath, ProviderAcquisitionObjectType, ProviderAcquisitionPricingMode, ProviderAcquisitionReservation, ProxyCartValidator, ProxyCheckoutServerClient, ProxySessionProviderBinding } from "@proxy-checkout/server-js";
-import type { StripeCheckoutSessionLike, StripeClientLike, StripeMetadata, StripeMetadataParam, StripeMetadataValue, StripeRequestOptionsLike, StripeRequestOptionsWithoutIdempotencyLike } from "./types.js";
-export interface StripeAcquisitionProxyClient {
-    readonly providerAcquisitions: Pick<ProxyCheckoutServerClient["providerAcquisitions"], "attachProviderAcquisitionObject" | "listProviderAcquisitions" | "reserveProviderAcquisition">;
-    readonly sessions: Pick<ProxyCheckoutServerClient["sessions"], "parseCart" | "payerOpened">;
-}
-export interface StripeAcquisitionMetadata {
-    readonly proxy_acquisition_attempt_id: string;
-    readonly proxy_contract_version: "2";
-    readonly proxy_integration_path: ProviderAcquisitionIntegrationPath;
-    readonly proxy_session_id: string;
-}
-export interface StripeRootObjectLike {
-    readonly customer?: null | string | {
-        readonly id: string;
-    };
-    readonly id: string;
-}
-export interface AcquireStripeRootOptions<TObject extends StripeRootObjectLike> {
-    readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
-    readonly commercialMode: ProviderAcquisitionCommercialMode;
-    readonly create: (reservation: ProviderAcquisitionReservation) => Promise<TObject>;
-    readonly directMerchandiseSubtotalMinor?: number;
-    readonly integrationPath: ProviderAcquisitionIntegrationPath;
-    readonly objectType: ProviderAcquisitionObjectType;
-    readonly pricingMode: ProviderAcquisitionPricingMode;
-    readonly providerOptionsFingerprint: string;
-    readonly proxy: ProxyCheckoutServerClient;
-    readonly proxySession: PayerOpenedResult;
-    readonly requestId?: string;
-    readonly retrieve: (id: string) => Promise<TObject>;
-    readonly toConfirmation: (object: TObject) => ProviderAcquisitionCartConfirmationInput;
-    readonly validateObject: (object: TObject, acquisition: ProviderAcquisition) => void;
-}
-export interface AcquiredStripeRoot<TObject extends StripeRootObjectLike> {
-    readonly acquisition: ProviderAcquisition;
-    readonly object: TObject;
-    readonly outcome: "acquired";
-    readonly reservation: ProviderAcquisitionReservation | null;
-}
-export interface StripeAcquisitionObjectReplayResult<TObject extends StripeRootObjectLike> {
-    readonly acquisition: ProviderAcquisition;
-    /** False only when the object still needs a null-or-same Proxy attachment. */
-    readonly alreadyAttached: boolean;
-    readonly object: TObject;
-}
-export interface TerminalStripeRootAcquisition {
-    readonly outcome: "terminal";
-    readonly proxySession: PayerOpenedResult;
-}
-export type AcquireStripeRootResult<TObject extends StripeRootObjectLike> = AcquiredStripeRoot<TObject> | TerminalStripeRootAcquisition;
-export type SharedAcquisitionTerminalResult<TCart> = {
-    readonly cart: TCart;
-    readonly outcome: "already_paid";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "paid" | "provisionable" | "provisioned" | "provisioning_failed";
-} | {
-    readonly cart: TCart;
-    readonly outcome: "action_required";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "merchant_action_required";
-} | {
-    readonly cart: TCart;
-    readonly outcome: "unavailable";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "cancelled" | "created" | "expired" | "failed";
-};
-export type SharedAcquisitionTerminal<TCart> = SharedAcquisitionTerminalResult<TCart>;
-export interface SharedAcquisitionActive<TCart> {
-    readonly cart: TCart;
-    readonly outcome: "active";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-}
-export type SharedAcquisitionSession<TCart> = SharedAcquisitionActive<TCart> | SharedAcquisitionTerminal<TCart>;
-export interface OpenSharedAcquisitionSessionOptions<TCart> {
-    readonly cartSchema?: ProxyCartValidator<TCart>;
-    readonly getCartBuyerReference?: (cart: TCart) => string | null | undefined;
-    readonly proxy: StripeAcquisitionProxyClient;
-    readonly proxySessionId: string;
-    readonly requestId?: string;
-}
-/** Connect routing is outside every first-class Proxy acquisition path. */
-export declare function assertNoConnectRequestOptions(options: StripeRequestOptionsWithoutIdempotencyLike | undefined): void;
-export declare function terminalAcquisitionResult<TCart>(proxySession: PayerOpenedResult, cart: TCart): SharedAcquisitionTerminalResult<TCart>;
-export declare function openSharedAcquisitionSession<TCart>(options: OpenSharedAcquisitionSessionOptions<TCart>): Promise<SharedAcquisitionSession<TCart>>;
-/**
- * One order-scoped owner for reserve/join, deterministic provider creation,
- * null-or-same attachment, and exact provider/cart confirmation. There is no
- * payer lease: every identical caller can execute this function concurrently.
- */
-export declare function acquireStripeRoot<TObject extends StripeRootObjectLike>(options: AcquireStripeRootOptions<TObject>): Promise<AcquireStripeRootResult<TObject>>;
-/**
- * Re-read only a terminal reserve conflict. Failures after reserve are never
- * converted because a Stripe root may already exist and must remain visible.
- */
-export declare function terminalAfterAcquisitionFailure(input: {
-    cause: unknown;
-    proxy: {
-        readonly sessions: Pick<ProxyCheckoutServerClient["sessions"], "payerOpened">;
-    };
-    proxySessionId: string;
-    requestId?: string;
-}): Promise<PayerOpenedResult>;
-/** Compatibility bridge for 0.0.x Checkout callers while the public helper
- * moves all provider-binding ownership out of open-checkout.ts. */
-export declare function recordOrReconcileLegacyCheckoutBinding(input: {
-    checkoutSessionId: string;
-    commercialMode: "one_time" | "subscription";
-    expectedCartVersion: number;
-    proxy: ProxyCheckoutServerClient;
-    proxySessionId: string;
-    psp: string;
-    requestId?: string;
-    stripe: StripeClientLike;
-    stripeRequestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-}): Promise<ProxySessionProviderBinding>;
-export declare function fingerprintStripeProviderOptions(path: ProviderAcquisitionIntegrationPath, params: unknown): string;
-export declare function hashProviderCartEvidence(path: ProviderAcquisitionIntegrationPath, value: unknown): string;
-export declare function checkoutOptionsForFingerprint(params: Record<string, unknown>): {
-    [x: string]: unknown;
-};
-/** Canonical provider-options identity used when replacing a hosted Checkout acquisition. */
-export declare function fingerprintHostedCheckoutProviderOptions(params: Record<string, unknown>): string;
-export declare function retrieveCheckoutSessionWithLineEvidence(input: {
-    id: string;
-    initial?: StripeCheckoutSessionLike;
-    requestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-    stripe: StripeClientLike;
-}): Promise<StripeCheckoutSessionLike>;
-export declare function checkoutCartConfirmation(input: {
-    cartVersion: number;
-    checkoutSession: StripeCheckoutSessionLike;
-    expectedLineItems: unknown;
-}): ProviderAcquisitionCartConfirmationInput;
-export declare function paymentIntentOptionsForFingerprint(params: Record<string, unknown>): {
-    [x: string]: unknown;
-};
-export declare function acquisitionMetadata(reservation: ProviderAcquisitionReservation): StripeAcquisitionMetadata;
-export declare function mergeAcquisitionMetadata(existing: StripeMetadata | StripeMetadataParam, required: StripeAcquisitionMetadata, field?: string): Record<string, StripeMetadataValue>;
-export declare function assertMerchantDoesNotSetAcquisitionMetadata(metadata: StripeMetadata | StripeMetadataParam, field?: string): void;
-export declare function assertAcquisitionMetadata(metadata: StripeMetadata, expected: StripeAcquisitionMetadata, objectLabel: string): void;
-export declare function reserveDirectSubscriptionAcquisition(input: {
-    directSubscriptionSource: ProviderAcquisitionDirectSubscriptionSource;
-    providerOptionsFingerprint: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-}): Promise<ProviderAcquisitionReservation>;
-export declare function recoverSetupIntentReservation(input: {
-    acquisitionAttemptId: string;
-    providerOptionsFingerprint: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    setupIntentId: string;
-}): Promise<ProviderAcquisitionReservation>;
-export declare function attachAcquisitionObject(input: {
-    acquisitionAttempt: ProviderAcquisition;
-    objectId: string;
-    objectType: ProviderAcquisitionObjectType;
-    providerConfirmation?: ProviderAcquisitionCartConfirmationInput;
-    providerCustomerId?: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    role: "root" | "setup_intent";
-}): Promise<ProviderAcquisition>;
-/**
- * Canonical deterministic-create replay used by every Stripe acquisition role.
- * A second create uses the same caller-owned idempotency key and therefore
- * recovers the first result; it never authorizes another physical object.
- */
-export declare function createOrRecoverStripeAcquisitionObject<TObject extends StripeRootObjectLike>(input: {
-    acquisition: ProviderAcquisition;
-    create: () => Promise<TObject>;
-    objectType: ProviderAcquisitionObjectType;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    retrieve: (id: string) => Promise<TObject>;
-    role: "root" | "setup_intent";
-}): Promise<StripeAcquisitionObjectReplayResult<TObject>>;
-export declare function stripeRequestOptions(merchantOptions: StripeRequestOptionsWithoutIdempotencyLike | undefined, idempotencyKey: string): StripeRequestOptionsLike;
-export declare function requireStripeObjectId(value: unknown, prefix: string, field: string): string;
-export declare function assertDirectSubscriptionReservation(reservation: ProviderAcquisitionReservation, source: ProviderAcquisitionDirectSubscriptionSource, proxySessionId: string, providerOptionsFingerprint?: string): void;

package/dist/cjs/acquisition.d.ts

@@ -1,189 +0,0 @@
-import type { PayerOpenedResult, ProviderAcquisition, ProviderAcquisitionCartConfirmationInput, ProviderAcquisitionCheckoutUiMode, ProviderAcquisitionCommercialMode, ProviderAcquisitionDirectSubscriptionSource, ProviderAcquisitionIntegrationPath, ProviderAcquisitionObjectType, ProviderAcquisitionPricingMode, ProviderAcquisitionReservation, ProxyCartValidator, ProxyCheckoutServerClient, ProxySessionProviderBinding } from "@proxy-checkout/server-js";
-import type { StripeCheckoutSessionLike, StripeClientLike, StripeMetadata, StripeMetadataParam, StripeMetadataValue, StripeRequestOptionsLike, StripeRequestOptionsWithoutIdempotencyLike } from "./types.js";
-export interface StripeAcquisitionProxyClient {
-    readonly providerAcquisitions: Pick<ProxyCheckoutServerClient["providerAcquisitions"], "attachProviderAcquisitionObject" | "listProviderAcquisitions" | "reserveProviderAcquisition">;
-    readonly sessions: Pick<ProxyCheckoutServerClient["sessions"], "parseCart" | "payerOpened">;
-}
-export interface StripeAcquisitionMetadata {
-    readonly proxy_acquisition_attempt_id: string;
-    readonly proxy_contract_version: "2";
-    readonly proxy_integration_path: ProviderAcquisitionIntegrationPath;
-    readonly proxy_session_id: string;
-}
-export interface StripeRootObjectLike {
-    readonly customer?: null | string | {
-        readonly id: string;
-    };
-    readonly id: string;
-}
-export interface AcquireStripeRootOptions<TObject extends StripeRootObjectLike> {
-    readonly checkoutUiMode?: ProviderAcquisitionCheckoutUiMode;
-    readonly commercialMode: ProviderAcquisitionCommercialMode;
-    readonly create: (reservation: ProviderAcquisitionReservation) => Promise<TObject>;
-    readonly directMerchandiseSubtotalMinor?: number;
-    readonly integrationPath: ProviderAcquisitionIntegrationPath;
-    readonly objectType: ProviderAcquisitionObjectType;
-    readonly pricingMode: ProviderAcquisitionPricingMode;
-    readonly providerOptionsFingerprint: string;
-    readonly proxy: ProxyCheckoutServerClient;
-    readonly proxySession: PayerOpenedResult;
-    readonly requestId?: string;
-    readonly retrieve: (id: string) => Promise<TObject>;
-    readonly toConfirmation: (object: TObject) => ProviderAcquisitionCartConfirmationInput;
-    readonly validateObject: (object: TObject, acquisition: ProviderAcquisition) => void;
-}
-export interface AcquiredStripeRoot<TObject extends StripeRootObjectLike> {
-    readonly acquisition: ProviderAcquisition;
-    readonly object: TObject;
-    readonly outcome: "acquired";
-    readonly reservation: ProviderAcquisitionReservation | null;
-}
-export interface StripeAcquisitionObjectReplayResult<TObject extends StripeRootObjectLike> {
-    readonly acquisition: ProviderAcquisition;
-    /** False only when the object still needs a null-or-same Proxy attachment. */
-    readonly alreadyAttached: boolean;
-    readonly object: TObject;
-}
-export interface TerminalStripeRootAcquisition {
-    readonly outcome: "terminal";
-    readonly proxySession: PayerOpenedResult;
-}
-export type AcquireStripeRootResult<TObject extends StripeRootObjectLike> = AcquiredStripeRoot<TObject> | TerminalStripeRootAcquisition;
-export type SharedAcquisitionTerminalResult<TCart> = {
-    readonly cart: TCart;
-    readonly outcome: "already_paid";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "paid" | "provisionable" | "provisioned" | "provisioning_failed";
-} | {
-    readonly cart: TCart;
-    readonly outcome: "action_required";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "merchant_action_required";
-} | {
-    readonly cart: TCart;
-    readonly outcome: "unavailable";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-    readonly sessionStatus: "cancelled" | "created" | "expired" | "failed";
-};
-export type SharedAcquisitionTerminal<TCart> = SharedAcquisitionTerminalResult<TCart>;
-export interface SharedAcquisitionActive<TCart> {
-    readonly cart: TCart;
-    readonly outcome: "active";
-    readonly proxySession: PayerOpenedResult;
-    readonly proxySessionId: string;
-}
-export type SharedAcquisitionSession<TCart> = SharedAcquisitionActive<TCart> | SharedAcquisitionTerminal<TCart>;
-export interface OpenSharedAcquisitionSessionOptions<TCart> {
-    readonly cartSchema?: ProxyCartValidator<TCart>;
-    readonly getCartBuyerReference?: (cart: TCart) => string | null | undefined;
-    readonly proxy: StripeAcquisitionProxyClient;
-    readonly proxySessionId: string;
-    readonly requestId?: string;
-}
-/** Connect routing is outside every first-class Proxy acquisition path. */
-export declare function assertNoConnectRequestOptions(options: StripeRequestOptionsWithoutIdempotencyLike | undefined): void;
-export declare function terminalAcquisitionResult<TCart>(proxySession: PayerOpenedResult, cart: TCart): SharedAcquisitionTerminalResult<TCart>;
-export declare function openSharedAcquisitionSession<TCart>(options: OpenSharedAcquisitionSessionOptions<TCart>): Promise<SharedAcquisitionSession<TCart>>;
-/**
- * One order-scoped owner for reserve/join, deterministic provider creation,
- * null-or-same attachment, and exact provider/cart confirmation. There is no
- * payer lease: every identical caller can execute this function concurrently.
- */
-export declare function acquireStripeRoot<TObject extends StripeRootObjectLike>(options: AcquireStripeRootOptions<TObject>): Promise<AcquireStripeRootResult<TObject>>;
-/**
- * Re-read only a terminal reserve conflict. Failures after reserve are never
- * converted because a Stripe root may already exist and must remain visible.
- */
-export declare function terminalAfterAcquisitionFailure(input: {
-    cause: unknown;
-    proxy: {
-        readonly sessions: Pick<ProxyCheckoutServerClient["sessions"], "payerOpened">;
-    };
-    proxySessionId: string;
-    requestId?: string;
-}): Promise<PayerOpenedResult>;
-/** Compatibility bridge for 0.0.x Checkout callers while the public helper
- * moves all provider-binding ownership out of open-checkout.ts. */
-export declare function recordOrReconcileLegacyCheckoutBinding(input: {
-    checkoutSessionId: string;
-    commercialMode: "one_time" | "subscription";
-    expectedCartVersion: number;
-    proxy: ProxyCheckoutServerClient;
-    proxySessionId: string;
-    psp: string;
-    requestId?: string;
-    stripe: StripeClientLike;
-    stripeRequestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-}): Promise<ProxySessionProviderBinding>;
-export declare function fingerprintStripeProviderOptions(path: ProviderAcquisitionIntegrationPath, params: unknown): string;
-export declare function hashProviderCartEvidence(path: ProviderAcquisitionIntegrationPath, value: unknown): string;
-export declare function checkoutOptionsForFingerprint(params: Record<string, unknown>): {
-    [x: string]: unknown;
-};
-/** Canonical provider-options identity used when replacing a hosted Checkout acquisition. */
-export declare function fingerprintHostedCheckoutProviderOptions(params: Record<string, unknown>): string;
-export declare function retrieveCheckoutSessionWithLineEvidence(input: {
-    id: string;
-    initial?: StripeCheckoutSessionLike;
-    requestOptions?: StripeRequestOptionsWithoutIdempotencyLike;
-    stripe: StripeClientLike;
-}): Promise<StripeCheckoutSessionLike>;
-export declare function checkoutCartConfirmation(input: {
-    cartVersion: number;
-    checkoutSession: StripeCheckoutSessionLike;
-    expectedLineItems: unknown;
-}): ProviderAcquisitionCartConfirmationInput;
-export declare function paymentIntentOptionsForFingerprint(params: Record<string, unknown>): {
-    [x: string]: unknown;
-};
-export declare function acquisitionMetadata(reservation: ProviderAcquisitionReservation): StripeAcquisitionMetadata;
-export declare function mergeAcquisitionMetadata(existing: StripeMetadata | StripeMetadataParam, required: StripeAcquisitionMetadata, field?: string): Record<string, StripeMetadataValue>;
-export declare function assertMerchantDoesNotSetAcquisitionMetadata(metadata: StripeMetadata | StripeMetadataParam, field?: string): void;
-export declare function assertAcquisitionMetadata(metadata: StripeMetadata, expected: StripeAcquisitionMetadata, objectLabel: string): void;
-export declare function reserveDirectSubscriptionAcquisition(input: {
-    directSubscriptionSource: ProviderAcquisitionDirectSubscriptionSource;
-    providerOptionsFingerprint: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-}): Promise<ProviderAcquisitionReservation>;
-export declare function recoverSetupIntentReservation(input: {
-    acquisitionAttemptId: string;
-    providerOptionsFingerprint: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    setupIntentId: string;
-}): Promise<ProviderAcquisitionReservation>;
-export declare function attachAcquisitionObject(input: {
-    acquisitionAttempt: ProviderAcquisition;
-    objectId: string;
-    objectType: ProviderAcquisitionObjectType;
-    providerConfirmation?: ProviderAcquisitionCartConfirmationInput;
-    providerCustomerId?: string;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    role: "root" | "setup_intent";
-}): Promise<ProviderAcquisition>;
-/**
- * Canonical deterministic-create replay used by every Stripe acquisition role.
- * A second create uses the same caller-owned idempotency key and therefore
- * recovers the first result; it never authorizes another physical object.
- */
-export declare function createOrRecoverStripeAcquisitionObject<TObject extends StripeRootObjectLike>(input: {
-    acquisition: ProviderAcquisition;
-    create: () => Promise<TObject>;
-    objectType: ProviderAcquisitionObjectType;
-    proxy: StripeAcquisitionProxyClient;
-    proxySessionId: string;
-    requestId?: string;
-    retrieve: (id: string) => Promise<TObject>;
-    role: "root" | "setup_intent";
-}): Promise<StripeAcquisitionObjectReplayResult<TObject>>;
-export declare function stripeRequestOptions(merchantOptions: StripeRequestOptionsWithoutIdempotencyLike | undefined, idempotencyKey: string): StripeRequestOptionsLike;
-export declare function requireStripeObjectId(value: unknown, prefix: string, field: string): string;
-export declare function assertDirectSubscriptionReservation(reservation: ProviderAcquisitionReservation, source: ProviderAcquisitionDirectSubscriptionSource, proxySessionId: string, providerOptionsFingerprint?: string): void;