@tickean/checkout-js 0.2.0 → 0.2.12

package/README.md

@@ -2,13 +2,28 @@
 
 Framework-agnostic TypeScript client for Tickean Headless Checkout.
 
+Current version: **0.2.12**.
+
 ## APIs
 
-- `createTickean(options)` — low-level client (unchanged public method signatures)
+- `createTickean(options)` — low-level client
 - `createCheckoutController(options)` — state machine with cart, quote debounce, OTP, purchase+payment, persistence, telemetry
+- `tickean.exchangeRecovery({ code })` — abandon-cart recovery (`POST /v1/checkout/recovery/exchange`)
+- `resumeCode` option on the controller — exchange + rehydrate on init
 
 ## Phases
 
 `initializing` → `browsing` → `quoting` → `verifying_buyer` → `ready_to_purchase` → `purchasing` → `requires_action` | `processing` → `completed` | `failed` | `expired`
 
-See repository root README for monorepo build/test commands.
+## Recovery example
+
+```ts
+const controller = createCheckoutController({
+  publishableKey: "pk_live_...",
+  eventSlug: "mi-evento",
+  returnUrl: "https://tusitio.com/checkout/",
+  resumeCode: new URLSearchParams(location.search).get("resume") || undefined,
+});
+```
+
+See [Reanudar sesión](../../docs/readme/18-session-resume.md) and the repository root README for monorepo build/test commands.

package/dist/index.d.mts

@@ -67,6 +67,23 @@ type CheckoutSession = {
     nextAction?: NextAction;
     returnUrl?: string | null;
 };
+type PromotionNxM = {
+    enabled?: boolean;
+    buyQty?: number;
+    payQty?: number;
+    label?: string;
+    startsAt?: string;
+    endsAt?: string;
+};
+type QuantityDiscount = {
+    enabled?: boolean;
+    type?: "SECOND_UNIT_PERCENT" | "NTH_UNIT_PERCENT" | string;
+    targetUnit?: number;
+    percentOff?: number;
+    label?: string;
+    startsAt?: string;
+    endsAt?: string;
+};
 type PublicShowOption = {
     id: string;
     name?: string;
@@ -74,15 +91,20 @@ type PublicShowOption = {
     price: number;
     currency?: string;
     stock?: number;
+    sold?: number;
+    reserved?: number;
+    availableStock?: number;
     maxPerPurchase?: number;
     optionType?: string;
     accessScope?: string;
     coveredShowIds?: string[];
     passIssuanceMode?: "PER_DAY" | "SINGLE_PASS";
     catalogVisibility?: "PUBLIC" | "PROMO_GATED";
-    promotionNxM?: unknown;
-    quantityDiscount?: unknown;
+    promotionNxM?: PromotionNxM | null;
+    quantityDiscount?: QuantityDiscount | null;
     status?: string;
+    /** Present on options returned via promo unlock. */
+    showId?: string;
 };
 type PublicShow = {
     id: string;
@@ -91,6 +113,32 @@ type PublicShow = {
     endDate?: string;
     showOptions: PublicShowOption[];
 };
+type RegistrationQuestion = {
+    id: string;
+    type?: string;
+    label?: string;
+    required?: boolean;
+    options?: string[];
+};
+type RegistrationSettings = {
+    maxAttendeesPerPurchase?: number;
+    requireAttendeeEmail?: boolean;
+    requireAttendeePhone?: boolean;
+    terms?: {
+        required?: boolean;
+        label?: string | null;
+        pdfUrl?: string | null;
+    } | null;
+    questions?: RegistrationQuestion[];
+};
+type PurchaseAttendee = {
+    showOptionId: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    termsAccepted?: boolean;
+};
 type PublicEvent = {
     id: string;
     slug: string;
@@ -99,6 +147,9 @@ type PublicEvent = {
     images?: unknown[];
     location?: unknown;
     availablePaymentMethods?: string[];
+    hasPromoGatedShowOptions?: boolean;
+    collectAttendeeData?: boolean;
+    registrationSettings?: RegistrationSettings | null;
     organization?: {
         id?: string;
         slug?: string;
@@ -111,11 +162,37 @@ type CartItem = {
     showOptionId: string;
     amount: number;
 };
+type QuotePricingLine = {
+    showOptionId?: string;
+    quantity?: number;
+    baseUnitPrice?: number;
+    lineTotal?: number;
+    codeDiscountAmount?: number;
+    codeDiscountedUnits?: number;
+};
+type QuotePricingBreakdown = {
+    subtotalBase?: number;
+    promotionDiscountTotal?: number;
+    codeDiscountTotal?: number;
+    serviceCharge?: number;
+    total?: number;
+    lines?: QuotePricingLine[];
+};
+type QuoteDiscountCode = {
+    code?: string;
+    discountType?: "PERCENT" | "FIXED" | string;
+    value?: number;
+    amountApplied?: number;
+    benefitKind?: string;
+    allowedShowOptionIds?: string[];
+    applicationMode?: string;
+};
 type QuoteResult = {
     valid: boolean;
     totalPrice: number;
-    pricingBreakdown?: unknown;
-    discountCode?: unknown;
+    pricingBreakdown?: QuotePricingBreakdown | unknown;
+    discountCode?: QuoteDiscountCode | unknown;
+    message?: string;
     unlockedShowOptionIds?: string[];
     unlockedShowOptions?: PublicShowOption[];
 };
@@ -200,6 +277,25 @@ declare function createTickean(options: CreateTickeanOptions): {
         eventSlug: string;
         returnUrl?: string;
     }): Promise<CheckoutSession>;
+    exchangeRecovery(params: {
+        code: string;
+    }): Promise<{
+        sessionId: string;
+        sessionToken: string;
+        expiresAt: string;
+        suggestedStep?: string | number;
+        event: PublicEvent;
+        capabilities?: Record<string, boolean>;
+        cart: CartItem[];
+        discountCode?: string | null;
+        buyer?: Buyer | null;
+        buyerVerified?: boolean;
+        purchase?: PurchaseResult["purchase"] | null;
+        payment?: PaymentResult | null;
+        nextAction?: NextAction;
+        shoppingCartReference?: string | null;
+        phase?: string;
+    }>;
     getSession(): Promise<CheckoutSession>;
     getCatalog(): Promise<PublicEvent>;
     quote(params: {
@@ -207,6 +303,17 @@ declare function createTickean(options: CreateTickeanOptions): {
         discountCode?: string;
         showId?: string;
     }): Promise<QuoteResult>;
+    lookupBuyer(params: {
+        phone: string;
+    }): Promise<{
+        exists: boolean;
+        buyer?: {
+            id: string;
+            phone: string;
+            name?: string;
+            email?: string;
+        };
+    }>;
     sendOtp(params: {
         phone: string;
         channel?: string;
@@ -226,6 +333,7 @@ declare function createTickean(options: CreateTickeanOptions): {
         expectedTotal?: number;
         shoppingCartReference?: string;
         idempotencyKey?: string;
+        attendees?: PurchaseAttendee[];
     }): Promise<PurchaseResult>;
     createPayment(params: {
         orderId: string;
@@ -296,6 +404,9 @@ type CheckoutAction = {
 } | {
     type: "SET_EVENT";
     event: PublicEvent;
+} | {
+    type: "MERGE_UNLOCKED_OPTIONS";
+    options: PublicShowOption[];
 } | {
     type: "PURCHASE_START";
 } | {
@@ -310,6 +421,8 @@ type CheckoutAction = {
     type: "SET_NEXT_ACTION";
     nextAction: NextAction;
     payment?: PaymentResult | null;
+} | {
+    type: "RESET_PAYMENT_FLOW";
 } | {
     type: "PROCESSING";
 } | {
@@ -332,6 +445,8 @@ declare function checkoutReducer(state: CheckoutState, action: CheckoutAction):
 type CreateCheckoutControllerOptions = CreateTickeanOptions & {
     eventSlug: string;
     returnUrl?: string;
+    /** Abandonment recovery code from `?resume=` deep link. */
+    resumeCode?: string;
     quoteDebounceMs?: number;
     persistence?: PersistenceAdapter | false;
     persistenceKey?: string;
@@ -344,6 +459,25 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             eventSlug: string;
             returnUrl?: string;
         }): Promise<CheckoutSession>;
+        exchangeRecovery(params: {
+            code: string;
+        }): Promise<{
+            sessionId: string;
+            sessionToken: string;
+            expiresAt: string;
+            suggestedStep?: string | number;
+            event: PublicEvent;
+            capabilities?: Record<string, boolean>;
+            cart: CartItem[];
+            discountCode?: string | null;
+            buyer?: Buyer | null;
+            buyerVerified?: boolean;
+            purchase?: PurchaseResult["purchase"] | null;
+            payment?: PaymentResult | null;
+            nextAction?: NextAction;
+            shoppingCartReference?: string | null;
+            phase?: string;
+        }>;
         getSession(): Promise<CheckoutSession>;
         getCatalog(): Promise<PublicEvent>;
         quote(params: {
@@ -351,6 +485,17 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             discountCode?: string;
             showId?: string;
         }): Promise<QuoteResult>;
+        lookupBuyer(params: {
+            phone: string;
+        }): Promise<{
+            exists: boolean;
+            buyer?: {
+                id: string;
+                phone: string;
+                name?: string;
+                email?: string;
+            };
+        }>;
         sendOtp(params: {
             phone: string;
             channel?: string;
@@ -370,6 +515,7 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             expectedTotal?: number;
             shoppingCartReference?: string;
             idempotencyKey?: string;
+            attendees?: PurchaseAttendee[];
         }): Promise<PurchaseResult>;
         createPayment(params: {
             orderId: string;
@@ -397,6 +543,15 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
     setCartItem: (showOptionId: string, amount: number) => void;
     setCart: (cart: CartItem[]) => void;
     applyDiscountCode: (code: string) => Promise<QuoteResult>;
+    lookupBuyer: (phone: string) => Promise<{
+        exists: boolean;
+        buyer?: {
+            id: string;
+            phone: string;
+            name?: string;
+            email?: string;
+        };
+    }>;
     sendOtp: (phone: string, channel?: string) => Promise<void>;
     verifyOtp: (params: {
         phone: string;
@@ -410,11 +565,13 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
         discountCode?: string;
         showId?: string;
         idempotencyKey?: string;
+        attendees?: PurchaseAttendee[];
     }) => Promise<{
         purchaseId: string;
         payment: PaymentResult;
         nextAction: NextAction;
     }>;
+    changePaymentMethod: () => void;
     confirmPayment: (params?: {
         paymentId?: string;
         confirmationToken?: string;
@@ -443,4 +600,43 @@ declare function createEventEmitterTelemetry(listeners?: TelemetryListener[]): T
     subscribe(listener: TelemetryListener): () => void;
 };
 
-export { type Buyer, type CartItem, type CheckoutAction, type CheckoutController, type CheckoutPhase, type CheckoutSession, type CheckoutState, type CheckoutTransport, type CreateCheckoutControllerOptions, type CreateTickeanOptions, type NextAction, type PaymentResult, type PaymentStatusResult, type PersistedCheckoutState, type PersistenceAdapter, type PublicEvent, type PublicShow, type PublicShowOption, type PurchaseResult, type QuoteResult, type TelemetryAdapter, type TelemetryEvent, type TelemetryListener, type TickeanClient, TickeanError, type TickeanErrorPayload, checkoutReducer, createCheckoutController, createEventEmitterTelemetry, createInitialState, createMemoryPersistence, createNoopTelemetry, createSessionStoragePersistence, createTickean };
+type PaymentSocketSnapshot = {
+    purchaseId?: string;
+    orderId?: string;
+    paymentId?: string;
+    status?: string;
+    amount?: number;
+    currency?: string;
+};
+type PaymentSocketWatchHandle = {
+    promise: Promise<PaymentSocketSnapshot>;
+    dispose: () => void;
+    get connected(): boolean;
+};
+/**
+ * Join the legacy cart payment room (same as ecommerce) and resolve when
+ * payment:confirmed arrives. HTTP polling remains the fallback.
+ */
+declare function watchPaymentSocket(params: {
+    apiBaseUrl: string;
+    shoppingCartReference: string;
+    purchaseId?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): PaymentSocketWatchHandle;
+
+/**
+ * Navigate the top-level browsing context (breaks out of iframes).
+ * Used for Mercado Pago hosted checkout so payment is not trapped in embeds.
+ */
+declare function navigateTopLevel(url: string): void;
+declare function resolveRedirectUrl(params: {
+    nextAction?: {
+        type: string;
+        url?: string;
+    } | null;
+    redirectUrl?: string | null;
+    initPoint?: string | null;
+}): string | null;
+
+export { type Buyer, type CartItem, type CheckoutAction, type CheckoutController, type CheckoutPhase, type CheckoutSession, type CheckoutState, type CheckoutTransport, type CreateCheckoutControllerOptions, type CreateTickeanOptions, type NextAction, type PaymentResult, type PaymentSocketSnapshot, type PaymentSocketWatchHandle, type PaymentStatusResult, type PersistedCheckoutState, type PersistenceAdapter, type PromotionNxM, type PublicEvent, type PublicShow, type PublicShowOption, type PurchaseAttendee, type PurchaseResult, type QuantityDiscount, type QuoteDiscountCode, type QuotePricingBreakdown, type QuotePricingLine, type QuoteResult, type RegistrationQuestion, type RegistrationSettings, type TelemetryAdapter, type TelemetryEvent, type TelemetryListener, type TickeanClient, TickeanError, type TickeanErrorPayload, checkoutReducer, createCheckoutController, createEventEmitterTelemetry, createInitialState, createMemoryPersistence, createNoopTelemetry, createSessionStoragePersistence, createTickean, navigateTopLevel, resolveRedirectUrl, watchPaymentSocket };

package/dist/index.d.ts

@@ -67,6 +67,23 @@ type CheckoutSession = {
     nextAction?: NextAction;
     returnUrl?: string | null;
 };
+type PromotionNxM = {
+    enabled?: boolean;
+    buyQty?: number;
+    payQty?: number;
+    label?: string;
+    startsAt?: string;
+    endsAt?: string;
+};
+type QuantityDiscount = {
+    enabled?: boolean;
+    type?: "SECOND_UNIT_PERCENT" | "NTH_UNIT_PERCENT" | string;
+    targetUnit?: number;
+    percentOff?: number;
+    label?: string;
+    startsAt?: string;
+    endsAt?: string;
+};
 type PublicShowOption = {
     id: string;
     name?: string;
@@ -74,15 +91,20 @@ type PublicShowOption = {
     price: number;
     currency?: string;
     stock?: number;
+    sold?: number;
+    reserved?: number;
+    availableStock?: number;
     maxPerPurchase?: number;
     optionType?: string;
     accessScope?: string;
     coveredShowIds?: string[];
     passIssuanceMode?: "PER_DAY" | "SINGLE_PASS";
     catalogVisibility?: "PUBLIC" | "PROMO_GATED";
-    promotionNxM?: unknown;
-    quantityDiscount?: unknown;
+    promotionNxM?: PromotionNxM | null;
+    quantityDiscount?: QuantityDiscount | null;
     status?: string;
+    /** Present on options returned via promo unlock. */
+    showId?: string;
 };
 type PublicShow = {
     id: string;
@@ -91,6 +113,32 @@ type PublicShow = {
     endDate?: string;
     showOptions: PublicShowOption[];
 };
+type RegistrationQuestion = {
+    id: string;
+    type?: string;
+    label?: string;
+    required?: boolean;
+    options?: string[];
+};
+type RegistrationSettings = {
+    maxAttendeesPerPurchase?: number;
+    requireAttendeeEmail?: boolean;
+    requireAttendeePhone?: boolean;
+    terms?: {
+        required?: boolean;
+        label?: string | null;
+        pdfUrl?: string | null;
+    } | null;
+    questions?: RegistrationQuestion[];
+};
+type PurchaseAttendee = {
+    showOptionId: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    termsAccepted?: boolean;
+};
 type PublicEvent = {
     id: string;
     slug: string;
@@ -99,6 +147,9 @@ type PublicEvent = {
     images?: unknown[];
     location?: unknown;
     availablePaymentMethods?: string[];
+    hasPromoGatedShowOptions?: boolean;
+    collectAttendeeData?: boolean;
+    registrationSettings?: RegistrationSettings | null;
     organization?: {
         id?: string;
         slug?: string;
@@ -111,11 +162,37 @@ type CartItem = {
     showOptionId: string;
     amount: number;
 };
+type QuotePricingLine = {
+    showOptionId?: string;
+    quantity?: number;
+    baseUnitPrice?: number;
+    lineTotal?: number;
+    codeDiscountAmount?: number;
+    codeDiscountedUnits?: number;
+};
+type QuotePricingBreakdown = {
+    subtotalBase?: number;
+    promotionDiscountTotal?: number;
+    codeDiscountTotal?: number;
+    serviceCharge?: number;
+    total?: number;
+    lines?: QuotePricingLine[];
+};
+type QuoteDiscountCode = {
+    code?: string;
+    discountType?: "PERCENT" | "FIXED" | string;
+    value?: number;
+    amountApplied?: number;
+    benefitKind?: string;
+    allowedShowOptionIds?: string[];
+    applicationMode?: string;
+};
 type QuoteResult = {
     valid: boolean;
     totalPrice: number;
-    pricingBreakdown?: unknown;
-    discountCode?: unknown;
+    pricingBreakdown?: QuotePricingBreakdown | unknown;
+    discountCode?: QuoteDiscountCode | unknown;
+    message?: string;
     unlockedShowOptionIds?: string[];
     unlockedShowOptions?: PublicShowOption[];
 };
@@ -200,6 +277,25 @@ declare function createTickean(options: CreateTickeanOptions): {
         eventSlug: string;
         returnUrl?: string;
     }): Promise<CheckoutSession>;
+    exchangeRecovery(params: {
+        code: string;
+    }): Promise<{
+        sessionId: string;
+        sessionToken: string;
+        expiresAt: string;
+        suggestedStep?: string | number;
+        event: PublicEvent;
+        capabilities?: Record<string, boolean>;
+        cart: CartItem[];
+        discountCode?: string | null;
+        buyer?: Buyer | null;
+        buyerVerified?: boolean;
+        purchase?: PurchaseResult["purchase"] | null;
+        payment?: PaymentResult | null;
+        nextAction?: NextAction;
+        shoppingCartReference?: string | null;
+        phase?: string;
+    }>;
     getSession(): Promise<CheckoutSession>;
     getCatalog(): Promise<PublicEvent>;
     quote(params: {
@@ -207,6 +303,17 @@ declare function createTickean(options: CreateTickeanOptions): {
         discountCode?: string;
         showId?: string;
     }): Promise<QuoteResult>;
+    lookupBuyer(params: {
+        phone: string;
+    }): Promise<{
+        exists: boolean;
+        buyer?: {
+            id: string;
+            phone: string;
+            name?: string;
+            email?: string;
+        };
+    }>;
     sendOtp(params: {
         phone: string;
         channel?: string;
@@ -226,6 +333,7 @@ declare function createTickean(options: CreateTickeanOptions): {
         expectedTotal?: number;
         shoppingCartReference?: string;
         idempotencyKey?: string;
+        attendees?: PurchaseAttendee[];
     }): Promise<PurchaseResult>;
     createPayment(params: {
         orderId: string;
@@ -296,6 +404,9 @@ type CheckoutAction = {
 } | {
     type: "SET_EVENT";
     event: PublicEvent;
+} | {
+    type: "MERGE_UNLOCKED_OPTIONS";
+    options: PublicShowOption[];
 } | {
     type: "PURCHASE_START";
 } | {
@@ -310,6 +421,8 @@ type CheckoutAction = {
     type: "SET_NEXT_ACTION";
     nextAction: NextAction;
     payment?: PaymentResult | null;
+} | {
+    type: "RESET_PAYMENT_FLOW";
 } | {
     type: "PROCESSING";
 } | {
@@ -332,6 +445,8 @@ declare function checkoutReducer(state: CheckoutState, action: CheckoutAction):
 type CreateCheckoutControllerOptions = CreateTickeanOptions & {
     eventSlug: string;
     returnUrl?: string;
+    /** Abandonment recovery code from `?resume=` deep link. */
+    resumeCode?: string;
     quoteDebounceMs?: number;
     persistence?: PersistenceAdapter | false;
     persistenceKey?: string;
@@ -344,6 +459,25 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             eventSlug: string;
             returnUrl?: string;
         }): Promise<CheckoutSession>;
+        exchangeRecovery(params: {
+            code: string;
+        }): Promise<{
+            sessionId: string;
+            sessionToken: string;
+            expiresAt: string;
+            suggestedStep?: string | number;
+            event: PublicEvent;
+            capabilities?: Record<string, boolean>;
+            cart: CartItem[];
+            discountCode?: string | null;
+            buyer?: Buyer | null;
+            buyerVerified?: boolean;
+            purchase?: PurchaseResult["purchase"] | null;
+            payment?: PaymentResult | null;
+            nextAction?: NextAction;
+            shoppingCartReference?: string | null;
+            phase?: string;
+        }>;
         getSession(): Promise<CheckoutSession>;
         getCatalog(): Promise<PublicEvent>;
         quote(params: {
@@ -351,6 +485,17 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             discountCode?: string;
             showId?: string;
         }): Promise<QuoteResult>;
+        lookupBuyer(params: {
+            phone: string;
+        }): Promise<{
+            exists: boolean;
+            buyer?: {
+                id: string;
+                phone: string;
+                name?: string;
+                email?: string;
+            };
+        }>;
         sendOtp(params: {
             phone: string;
             channel?: string;
@@ -370,6 +515,7 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
             expectedTotal?: number;
             shoppingCartReference?: string;
             idempotencyKey?: string;
+            attendees?: PurchaseAttendee[];
         }): Promise<PurchaseResult>;
         createPayment(params: {
             orderId: string;
@@ -397,6 +543,15 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
     setCartItem: (showOptionId: string, amount: number) => void;
     setCart: (cart: CartItem[]) => void;
     applyDiscountCode: (code: string) => Promise<QuoteResult>;
+    lookupBuyer: (phone: string) => Promise<{
+        exists: boolean;
+        buyer?: {
+            id: string;
+            phone: string;
+            name?: string;
+            email?: string;
+        };
+    }>;
     sendOtp: (phone: string, channel?: string) => Promise<void>;
     verifyOtp: (params: {
         phone: string;
@@ -410,11 +565,13 @@ declare function createCheckoutController(options: CreateCheckoutControllerOptio
         discountCode?: string;
         showId?: string;
         idempotencyKey?: string;
+        attendees?: PurchaseAttendee[];
     }) => Promise<{
         purchaseId: string;
         payment: PaymentResult;
         nextAction: NextAction;
     }>;
+    changePaymentMethod: () => void;
     confirmPayment: (params?: {
         paymentId?: string;
         confirmationToken?: string;
@@ -443,4 +600,43 @@ declare function createEventEmitterTelemetry(listeners?: TelemetryListener[]): T
     subscribe(listener: TelemetryListener): () => void;
 };
 
-export { type Buyer, type CartItem, type CheckoutAction, type CheckoutController, type CheckoutPhase, type CheckoutSession, type CheckoutState, type CheckoutTransport, type CreateCheckoutControllerOptions, type CreateTickeanOptions, type NextAction, type PaymentResult, type PaymentStatusResult, type PersistedCheckoutState, type PersistenceAdapter, type PublicEvent, type PublicShow, type PublicShowOption, type PurchaseResult, type QuoteResult, type TelemetryAdapter, type TelemetryEvent, type TelemetryListener, type TickeanClient, TickeanError, type TickeanErrorPayload, checkoutReducer, createCheckoutController, createEventEmitterTelemetry, createInitialState, createMemoryPersistence, createNoopTelemetry, createSessionStoragePersistence, createTickean };
+type PaymentSocketSnapshot = {
+    purchaseId?: string;
+    orderId?: string;
+    paymentId?: string;
+    status?: string;
+    amount?: number;
+    currency?: string;
+};
+type PaymentSocketWatchHandle = {
+    promise: Promise<PaymentSocketSnapshot>;
+    dispose: () => void;
+    get connected(): boolean;
+};
+/**
+ * Join the legacy cart payment room (same as ecommerce) and resolve when
+ * payment:confirmed arrives. HTTP polling remains the fallback.
+ */
+declare function watchPaymentSocket(params: {
+    apiBaseUrl: string;
+    shoppingCartReference: string;
+    purchaseId?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): PaymentSocketWatchHandle;
+
+/**
+ * Navigate the top-level browsing context (breaks out of iframes).
+ * Used for Mercado Pago hosted checkout so payment is not trapped in embeds.
+ */
+declare function navigateTopLevel(url: string): void;
+declare function resolveRedirectUrl(params: {
+    nextAction?: {
+        type: string;
+        url?: string;
+    } | null;
+    redirectUrl?: string | null;
+    initPoint?: string | null;
+}): string | null;
+
+export { type Buyer, type CartItem, type CheckoutAction, type CheckoutController, type CheckoutPhase, type CheckoutSession, type CheckoutState, type CheckoutTransport, type CreateCheckoutControllerOptions, type CreateTickeanOptions, type NextAction, type PaymentResult, type PaymentSocketSnapshot, type PaymentSocketWatchHandle, type PaymentStatusResult, type PersistedCheckoutState, type PersistenceAdapter, type PromotionNxM, type PublicEvent, type PublicShow, type PublicShowOption, type PurchaseAttendee, type PurchaseResult, type QuantityDiscount, type QuoteDiscountCode, type QuotePricingBreakdown, type QuotePricingLine, type QuoteResult, type RegistrationQuestion, type RegistrationSettings, type TelemetryAdapter, type TelemetryEvent, type TelemetryListener, type TickeanClient, TickeanError, type TickeanErrorPayload, checkoutReducer, createCheckoutController, createEventEmitterTelemetry, createInitialState, createMemoryPersistence, createNoopTelemetry, createSessionStoragePersistence, createTickean, navigateTopLevel, resolveRedirectUrl, watchPaymentSocket };