@cimplify/sdk 0.108.0 → 0.110.2

package/dist/{catalogue-OT89_Ifs.d.mts → catalogue-OTuS5zp-.d.ts}

@@ -1,4 +1,5 @@
-import { c as CimplifyError, b1 as ClaimedCustomer, an as Cart, eM as UICart, ar as CartItem, bE as DestinationQuoteInput, bC as DestinationQuote, aw as CartSummary, v as AddToCartInput, at as CartMutationResult, eT as UpdateCartItemInput, bI as DiscountDetails, cJ as Money, a as ChosenPrice, C as CurrencyCode, cs as LineConfiguration, cN as NextAction, ad as CHECKOUT_NEXT_ACTION, ca as ErrorCode, aE as CheckoutCollectionOptions, aK as CheckoutFormData, aW as CheckoutResult, dn as PaymentMethod, cj as InitializePaymentResult, eA as SubmitAuthorizationInput, dy as PaymentStatusResponse, aI as CheckoutCustomerInfo, dJ as ProcessAndResolveOptions, dL as ProcessCheckoutResult, i as ConfirmPurchaseIntentRequest, g as ConfirmPurchaseIntentResponse, d8 as PURCHASE_INTENT_RESOLVE_STATUS, e0 as PurchaseIntentActionResponse, d0 as PURCHASE_INTENT_ACTION_DECISION, eB as SubmitPurchaseIntentActionRequest, h as PURCHASE_INTENT_CONFIRM_STATUS, e7 as PurchaseIntentResolution, cE as MintPurchaseIntentRequest, ee as PurchaseIntentView, dC as PreparePurchaseIntentRequest, e_ as VariantDetails, e$ as VariantDetailsDTO, p as AddOnDetails, s as AddOnOptionDetails, q as AddOnGroupDetails, a2 as BundleSelectionData, bh as CompositeSelectionData, br as CustomerInputValue, em as RequestOtpInput, en as RequestOtpResult$1, f4 as VerifyOtpInput, J as AuthResponse, cw as LinkStatusResult, ct as LinkData, bq as CustomerAddress, bt as CustomerMobileMoney, bs as CustomerLinkPreferences, bp as Customer, c9 as EnrollmentData, cu as LinkEnrollResult, c7 as EnrollAndLinkOrderInput, c8 as EnrollAndLinkOrderResult, bl as CreateAddressInput, eS as UpdateAddressInput, bm as CreateMobileMoneyInput, cv as LinkSession, ep as RevokeSessionResult, eo as RevokeAllSessionsResult, fh as components, et as SchedulingMode, D as DurationUnit, P as Product, eC as Subscription, eG as SubscriptionWithDetails, c5 as ElementsOptions, bZ as ElementType, bY as ElementOptions, bX as ElementEventType, bW as ElementEventHandler, aA as CheckoutCartData, dg as ParentToIframeMessage, ci as IframeToParentMessage, L as AuthenticatedData, c2 as ElementsCheckoutData, c3 as ElementsCheckoutResult, dK as ProcessCheckoutOptions, n as AbortablePromise, y as AddressInfo, dp as PaymentMethodInfo, b_ as ElementsAuthContactType, b as Category, u as AddOnWithOptions, de as Pagination, e as ProductWithDetails, dX as ProductVariant, eU as VariantAxis, eV as VariantAxisSelection, o as AddOn, d as Collection, a5 as BundleSummary, X as Bundle, ba as Composite, b8 as ComponentSelectionInput, bf as CompositePriceResult, S as SaleInfo, dU as ProductTaxonomy, eL as TaxonomyWithChildren, c6 as EligiblePlansQuery, dP as ProductBillingPlan, dV as ProductTimeProfile, dO as ProductAvailabilityNow, bz as Deal, dQ as ProductDealInfo, bJ as DiscountValidation, eI as TagsResponse, bn as CustomAttributeDefinition, bo as CustomAttributeValue, dZ as PropertyFacet, eK as TaxonomyAttributeTemplate, cn as KnowledgeArticle } from './elements-Bty6Qs_N.mjs';
+import { d as CimplifyError, b6 as ClaimedCustomer, at as Cart, o as UICart, ax as CartItem, bM as DestinationQuoteInput, bK as DestinationQuote, aC as CartSummary, B as AddToCartInput, az as CartMutationResult, e_ as UpdateCartItemInput, bQ as DiscountDetails, M as Money, a as ChosenPrice, C as CurrencyCode, cz as LineConfiguration, cS as NextAction, aj as CHECKOUT_NEXT_ACTION, ch as ErrorCode, aJ as CheckoutCollectionOptions, aP as CheckoutFormData, a$ as CheckoutResult, ds as PaymentMethod, cq as InitializePaymentResult, eI as SubmitAuthorizationInput, dC as PaymentStatusResponse, aN as CheckoutCustomerInfo, dN as ProcessAndResolveOptions, dP as ProcessCheckoutResult, n as ConfirmPurchaseIntentRequest, l as ConfirmPurchaseIntentResponse, dc as PURCHASE_INTENT_RESOLVE_STATUS, e4 as PurchaseIntentActionResponse, d5 as PURCHASE_INTENT_ACTION_DECISION, eJ as SubmitPurchaseIntentActionRequest, m as PURCHASE_INTENT_CONFIRM_STATUS, g as PurchaseIntentResolution, cL as MintPurchaseIntentRequest, eh as PurchaseIntentView, dG as PreparePurchaseIntentRequest, f5 as VariantDetails, f6 as VariantDetailsDTO, u as AddOnDetails, x as AddOnOptionDetails, v as AddOnGroupDetails, a8 as BundleSelectionData, bm as CompositeSelectionData, bz as CustomerInputValue, ep as RequestOtpInput, eq as RequestOtpResult$1, fc as VerifyOtpInput, Q as AuthResponse, cD as LinkStatusResult, cA as LinkData, by as CustomerAddress, bB as CustomerMobileMoney, bA as CustomerLinkPreferences, bx as Customer, br as ContactChangeInput, bq as ContactChangeChallenge, bp as ConfirmContactChangeInput, cg as EnrollmentData, cB as LinkEnrollResult, eA as SaveDetailsInput, eB as SaveDetailsResult, bt as CreateAddressInput, eZ as UpdateAddressInput, bu as CreateMobileMoneyInput, fb as VerifyMobileMoneyResult, cC as LinkSession, es as RevokeSessionResult, er as RevokeAllSessionsResult, fp as components, P as Product, eK as Subscription, eO as SubscriptionWithDetails, ce as ElementsOptions, c6 as ElementType, c5 as ElementOptions, c4 as ElementEventType, c2 as ElementEventHandler, c3 as ElementEventMap, p as CheckoutCartData, dk as ParentToIframeMessage, cp as IframeToParentMessage, V as AuthenticatedData, cb as ElementsCheckoutData, cc as ElementsCheckoutResult, dO as ProcessCheckoutOptions, s as AbortablePromise, G as AddressInfo, dt as PaymentMethodInfo, c7 as ElementsAuthContactType, c as Category, z as AddOnWithOptions, di as Pagination, f as ProductWithDetails, d$ as ProductVariant, e$ as VariantAxis, f0 as VariantAxisSelection, t as AddOn, e as Collection, ab as BundleSummary, a1 as Bundle, bf as Composite, bd as ComponentSelectionInput, bk as CompositePriceResult, b as SaleInfo, dY as ProductTaxonomy, eT as TaxonomyWithChildren, cf as EligiblePlansQuery, dT as ProductBillingPlan, dZ as ProductTimeProfile, dS as ProductAvailabilityNow, bH as Deal, dU as ProductDealInfo, bR as DiscountValidation, eQ as TagsResponse, bv as CustomAttributeDefinition, bw as CustomAttributeValue, e1 as PropertyFacet, eS as TaxonomyAttributeTemplate, cu as KnowledgeArticle } from './elements-DdsRig-2.js';
+import { k as Service, G as GetAvailableSlotsInput, A as AvailableSlot, e as CheckSlotAvailabilityInput, f as CheckSlotAvailabilityResult, l as ServiceAvailabilityParams, m as ServiceAvailabilityResult, c as BookingWithDetails, g as CustomerBooking, C as CancelBookingInput, d as CancelBookingResult, R as RescheduleBookingInput, i as RescheduleBookingResult } from './scheduling-D2ajXpMC.js';
 
 interface RequestContext {
     method: "GET" | "POST" | "PATCH" | "DELETE";
@@ -602,7 +603,8 @@ type CardPopupAction = Extract<NextAction, {
 }>;
 interface PaymentAuthorizationContext {
     action: CardPopupAction;
-    email: string;
+    /** The shopper's own email, when they gave one. Never a placeholder. */
+    email?: string;
     currency: CurrencyCode;
     reference?: string;
     returnUrl?: string;
@@ -683,6 +685,11 @@ declare class CheckoutService {
     processAndResolve(data: CheckoutFormData & ProcessAndResolveOptions): Promise<Result<ProcessCheckoutResult, CimplifyError>>;
 }
 
+/**
+ * Network failures, timeouts and server errors say nothing about the payment.
+ * The confirmation is idempotent, so replaying it is always safe.
+ */
+declare function isTransientPurchaseIntentError(error: CimplifyError): boolean;
 type PurchaseIntentResolveStatus = (typeof PURCHASE_INTENT_RESOLVE_STATUS)[keyof typeof PURCHASE_INTENT_RESOLVE_STATUS];
 type PurchaseIntentActionDecision = typeof PURCHASE_INTENT_ACTION_DECISION.CONTINUE | typeof PURCHASE_INTENT_ACTION_DECISION.STOP | {
     kind: typeof PURCHASE_INTENT_ACTION_DECISION.SUBMIT;
@@ -695,6 +702,11 @@ interface PurchaseIntentResolveOptions {
     maxPollAttempts?: number;
     maxActionSteps?: number;
     maxTermsReviewSteps?: number;
+    /**
+     * Wall-clock budget for riding out network errors, timeouts and server
+     * errors. Each is retried with bounded backoff until this passes.
+     */
+    deadlineMs?: number;
     signal?: AbortSignal;
     requestTimeoutMs?: number;
     onStatusChange?: (status: PurchaseIntentResolveStatus, response?: ConfirmPurchaseIntentResponse) => void;
@@ -703,6 +715,10 @@ interface PurchaseIntentResolveOptions {
      * attempt. For a typed provider challenge, return `submit` with only the
      * requested authorization value; the SDK sends it through the owner-fenced
      * attempt endpoint. Neither arm can alter the accepted terms.
+     *
+     * A redirect or card popup is handed over once per attempt: after
+     * `continue`, later replays that still report the same attempt waiting on
+     * the shopper are polled without calling back again.
      */
     onActionRequired?: (action: PurchaseIntentActionResponse) => PurchaseIntentActionDecision | Promise<PurchaseIntentActionDecision>;
     /** Returning a request is explicit consent to replacement terms. */
@@ -723,6 +739,7 @@ interface PurchaseIntentConfirmationPort {
 interface PurchaseIntentResolverDependencies {
     confirmation: PurchaseIntentConfirmationPort;
     wait?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+    now?: () => number;
 }
 /**
  * Pure purchase-intent state machine. Transport stays behind the narrow
@@ -731,6 +748,7 @@ interface PurchaseIntentResolverDependencies {
 declare class PurchaseIntentResolver {
     private readonly confirmation;
     private readonly wait;
+    private readonly now;
     constructor(dependencies: PurchaseIntentResolverDependencies);
     resolve(intentId: string, options: PurchaseIntentResolveOptions): Promise<Result<PurchaseIntentResolution, CimplifyError>>;
     private ensureActive;
@@ -1010,6 +1028,7 @@ interface SuccessResult {
     message?: string;
     action?: string;
     expires_in?: number;
+    /** @deprecated Always false: whether a contact has an account is never disclosed. */
     is_new_account?: boolean;
 }
 /**
@@ -1050,15 +1069,32 @@ declare class LinkService {
     getAddresses(): Promise<Result<CustomerAddress[], CimplifyError>>;
     getMobileMoney(): Promise<Result<CustomerMobileMoney[], CimplifyError>>;
     getPreferences(): Promise<Result<CustomerLinkPreferences, CimplifyError>>;
+    /**
+     * Updates the profile name. An email or phone may only be echoed back
+     * unchanged; a different one is refused with CONTACT_VERIFICATION_REQUIRED
+     * and goes through `requestContactChange` and `confirmContactChange`.
+     */
     updateProfile(input: {
         name?: string;
         email?: string;
         phone?: string;
     }): Promise<Result<Customer, CimplifyError>>;
+    requestContactChange(input: ContactChangeInput): Promise<Result<ContactChangeChallenge, CimplifyError>>;
+    confirmContactChange(input: ConfirmContactChangeInput): Promise<Result<Customer, CimplifyError>>;
     getOrders(options?: GetLinkOrdersOptions): Promise<Result<Order[], CimplifyError>>;
     getOrder(orderId: string, options?: GetLinkOrderOptions): Promise<Result<Order, CimplifyError>>;
     enroll(data: EnrollmentData, opts?: IdempotencyOption$7): Promise<Result<LinkEnrollResult, CimplifyError>>;
-    enrollAndLinkOrder(data: EnrollAndLinkOrderInput, opts?: IdempotencyOption$7): Promise<Result<EnrollAndLinkOrderResult, CimplifyError>>;
+    /**
+     * Save a paid order's details after the person ticked "Save my details with Cimplify".
+     * Nothing is saved until the order's contact is proved; when it is not, the result names
+     * the contact to send one code to. Never call this before payment completes.
+     */
+    saveDetails(data: SaveDetailsInput, opts?: IdempotencyOption$7): Promise<Result<SaveDetailsResult, CimplifyError>>;
+    /**
+     * After `saveDetails` asked for a code: checks the code the person received, which signs
+     * them in to Link, then saves the order's details under their account.
+     */
+    confirmSaveDetails(data: SaveDetailsInput, code: VerifyOtpInput): Promise<Result<SaveDetailsResult, CimplifyError>>;
     updatePreferences(preferences: Partial<CustomerLinkPreferences>): Promise<Result<SuccessResult, CimplifyError>>;
     createAddress(input: CreateAddressInput, opts?: IdempotencyOption$7): Promise<Result<CustomerAddress, CimplifyError>>;
     updateAddress(input: UpdateAddressInput): Promise<Result<SuccessResult, CimplifyError>>;
@@ -1069,7 +1105,17 @@ declare class LinkService {
     deleteMobileMoney(mobileMoneyId: string): Promise<Result<SuccessResult, CimplifyError>>;
     setDefaultMobileMoney(mobileMoneyId: string): Promise<Result<SuccessResult, CimplifyError>>;
     trackMobileMoneyUsage(mobileMoneyId: string): Promise<Result<SuccessResult, CimplifyError>>;
-    verifyMobileMoney(mobileMoneyId: string, opts?: IdempotencyOption$7): Promise<Result<SuccessResult, CimplifyError>>;
+    /**
+     * Reports whether a saved mobile money account is verified; it verifies nothing.
+     * Verification comes only from a successful payment from the account; one not yet
+     * verified fails with `CONCURRENCY_CONFLICT`.
+     */
+    checkMobileMoneyVerification(mobileMoneyId: string, opts?: IdempotencyOption$7): Promise<Result<VerifyMobileMoneyResult, CimplifyError>>;
+    /**
+     * @deprecated Renamed to {@link LinkService.checkMobileMoneyVerification}: it only reports
+     * whether the account is verified and never verifies it.
+     */
+    verifyMobileMoney(mobileMoneyId: string, opts?: IdempotencyOption$7): Promise<Result<VerifyMobileMoneyResult, CimplifyError>>;
     getSessions(): Promise<Result<LinkSession[], CimplifyError>>;
     revokeSession(sessionId: string): Promise<Result<RevokeSessionResult, CimplifyError>>;
     revokeAllSessions(): Promise<Result<RevokeAllSessionsResult, CimplifyError>>;
@@ -1093,6 +1139,7 @@ interface OtpResult {
 interface RequestOtpResult {
     message: string;
     expires_in: number;
+    /** @deprecated Always false: whether a contact has an account is never disclosed. */
     is_new_account: boolean;
 }
 interface UpdateProfileInput {
@@ -1271,9 +1318,15 @@ interface CategoryInfo {
     slug: string;
 }
 
+/** Sites allowed to embed this business's checkout element. */
+interface EmbeddingOrigins {
+    origins: string[];
+    allow_local_development: boolean;
+}
 declare class BusinessService {
     private client;
     constructor(client: CimplifyClient);
+    getEmbeddingOrigins(opts?: ReadRequestOptions): Promise<Result<EmbeddingOrigins, CimplifyError>>;
     getInfo(opts?: ReadRequestOptions): Promise<Result<Business, CimplifyError>>;
     getByHandle(handle: string, opts?: ReadRequestOptions): Promise<Result<Business, CimplifyError>>;
     getByDomain(domain: string, opts?: ReadRequestOptions): Promise<Result<Business, CimplifyError>>;
@@ -1307,211 +1360,6 @@ declare class InventoryService {
     getAvailableQuantity(productId: string, locationId?: string): Promise<Result<number | undefined, CimplifyError>>;
 }
 
-interface Service {
-    id: string;
-    name: string;
-    description?: string;
-    price?: Money;
-    scheduling_mode?: SchedulingMode;
-    duration_value?: number;
-    duration_minutes: number;
-    duration_unit?: DurationUnit;
-    price_basis?: "flat" | "per_person" | "per_duration_unit";
-    image_url?: string | null;
-    category_id?: string | null;
-    is_available: boolean;
-    business_id?: string;
-    product_id?: string;
-    buffer_before_minutes?: number;
-    buffer_after_minutes?: number;
-    max_participants?: number;
-    currency?: string;
-    requires_staff?: boolean;
-    is_active?: boolean;
-    metadata?: Record<string, unknown>;
-}
-interface Staff {
-    id: string;
-    business_id?: string;
-    name: string;
-    email?: string;
-    phone?: string;
-    avatar_url?: string;
-    bio?: string;
-    is_active?: boolean;
-    services?: string[];
-}
-interface TimeSlot {
-    start_time: string;
-    end_time: string;
-    is_available?: boolean;
-    staff_id?: string;
-    staff_name?: string;
-    remaining_capacity?: number;
-}
-interface SlotResourceInfo {
-    resource_id: string;
-    name: string;
-    resource_type: string;
-}
-interface SlotStaffInfo {
-    staff_id: string;
-    name: string;
-}
-interface AvailableSlot extends TimeSlot {
-    price?: Money;
-    duration_minutes?: number;
-    available_staff?: SlotStaffInfo[];
-    available_resources?: SlotResourceInfo[];
-    capacity_available?: number;
-}
-interface DayAvailability {
-    date: string;
-    slots: TimeSlot[];
-    has_availability: boolean;
-}
-type BookingStatus = "booked" | "assigned" | "pending" | "confirmed" | "in_progress" | "checked_in" | "checked_out" | "overstay" | "completed" | "cancelled" | "no_show" | string;
-interface Booking {
-    id: string;
-    service_name: string;
-    start_time: string;
-    end_time: string;
-    status: BookingStatus;
-    confirmation_code?: string;
-    total_amount?: Money;
-    participant_count: number;
-    staff_name?: string | null;
-    notes?: unknown;
-    business_id?: string;
-    order_id?: string;
-    line_item_id?: string;
-    service_id?: string;
-    customer_id?: string;
-    customer_name?: string;
-    customer_phone?: string;
-    staff_id?: string;
-    location_id?: string;
-    location_name?: string;
-    duration_minutes?: number;
-    cancellation_reason?: string;
-    cancelled_at?: string;
-    created_at?: string;
-    updated_at?: string;
-}
-interface BookingWithDetails extends Booking {
-    service?: Service;
-    staff?: Staff;
-}
-interface CustomerBookingServiceItem {
-    service_id: string;
-    scheduled_start?: string | null;
-    scheduled_end?: string | null;
-    confirmation_code?: string | null;
-    status?: string | null;
-}
-interface CustomerBooking {
-    order_id: string;
-    service_items: CustomerBookingServiceItem[];
-    status: BookingStatus;
-    created_at: string;
-    total_price: Money;
-}
-interface GetAvailableSlotsInput {
-    service_id: string;
-    date: string;
-    participant_count?: number;
-    /** Whole units needed; slots that can't seat them drop out. Default 1. */
-    units?: number;
-    variant_id?: string;
-}
-interface CheckSlotAvailabilityInput {
-    service_id: string;
-    slot_time: string;
-    duration_minutes?: number;
-    participant_count?: number;
-}
-interface CheckSlotAvailabilityResult {
-    available: boolean;
-    reason?: string;
-    service_id?: string;
-    start_time?: string;
-    duration_minutes?: number;
-    participant_count?: number;
-}
-interface RescheduleBookingInput {
-    order_id: string;
-    line_item_id: string;
-    new_start_time: string;
-    new_end_time: string;
-    new_staff_id?: string;
-    reason?: string;
-    reschedule_type?: "customer" | "business" | "system";
-}
-interface CancelBookingInput {
-    booking_id: string;
-    reason?: string;
-}
-interface CancelBookingResult {
-    message: string;
-}
-type BookingModificationType = "reschedule" | "extend" | "shorten" | "early_checkout";
-interface RescheduleBookingResult {
-    success: boolean;
-    booking_id: string;
-    old_time: {
-        start: string;
-        end: string;
-    };
-    new_time: {
-        start: string;
-        end: string;
-    };
-    staff_changed: boolean;
-    old_staff_id?: string | null;
-    new_staff_id?: string | null;
-    fee_charged?: string;
-}
-interface ServiceAvailabilityParams {
-    service_id: string;
-    start_date: string;
-    end_date: string;
-    location_id?: string;
-    participant_count?: number;
-    /** Whole units needed; short check-in days report unavailable. Default 1. */
-    units?: number;
-    variant_id?: string;
-}
-interface ServiceAvailabilityResult {
-    service_id: string;
-    location_id: string;
-    scheduling_mode: SchedulingMode;
-    duration_unit: string;
-    duration_value: number;
-    start_date: string;
-    end_date: string;
-    participant_count: number;
-    availability: DayAvailability[];
-}
-interface RescheduleHistoryRecord {
-    id: string;
-    booking_id: string;
-    order_id: string;
-    order_item_id?: string | null;
-    old_start_time: string;
-    old_end_time: string;
-    new_start_time: string;
-    new_end_time: string;
-    old_staff_id?: string | null;
-    new_staff_id?: string | null;
-    reason?: string | null;
-    rescheduled_by: string;
-    rescheduled_at: string;
-    modification_type: BookingModificationType;
-    reschedule_type: "customer" | "business" | "system";
-    fee_applied: string | number;
-    metadata?: Record<string, unknown> | null;
-}
-
 interface IdempotencyOption$5 {
     idempotencyKey?: string;
 }
@@ -1753,6 +1601,19 @@ declare class SubscriptionService {
 interface IdempotencyOption$2 {
     idempotencyKey?: string;
 }
+interface UploadInitOptions extends IdempotencyOption$2 {
+    digest?: ContentSha256;
+}
+/** The presigned PUT is signed over this header, so the store refuses other bytes. */
+declare const CONTENT_SHA256_HEADER = "x-amz-checksum-sha256";
+interface ContentSha256 {
+    /** Lowercase hex, as `init` declares it. */
+    hex: string;
+    /** Base64, as the presigned PUT carries it in `CONTENT_SHA256_HEADER`. */
+    base64: string;
+}
+/** Hashes in bounded chunks so a large file is never held in memory whole. */
+declare function contentSha256(blob: Blob): Promise<ContentSha256>;
 interface UploadInitResponse {
     upload_id: string;
     upload_url: string;
@@ -1768,7 +1629,11 @@ interface UploadResult {
 declare class UploadService {
     private client;
     constructor(client: CimplifyClient);
-    init(filename: string, contentType: string, sizeBytes: number, opts?: IdempotencyOption$2): Promise<Result<UploadInitResponse, CimplifyError>>;
+    /**
+     * With `opts.digest` the PUT to `upload_url` must send `digest.base64` as
+     * `CONTENT_SHA256_HEADER`; without it the server hashes the stored bytes.
+     */
+    init(filename: string, contentType: string, sizeBytes: number, opts?: UploadInitOptions): Promise<Result<UploadInitResponse, CimplifyError>>;
     confirm(uploadId: string): Promise<Result<UploadResult, CimplifyError>>;
     upload(file: File): Promise<Result<UploadResult, CimplifyError>>;
 }
@@ -1795,8 +1660,13 @@ interface PlaceDetailsResponse {
 declare class PlacesService {
     private client;
     constructor(client: CimplifyClient);
-    autocomplete(input: string, sessionToken?: string): Promise<Result<AutocompleteResponse, CimplifyError>>;
-    details(placeId: string, sessionToken?: string): Promise<Result<PlaceDetailsResponse, CimplifyError>>;
+    /** `country` (ISO alpha-2) biases results; absent, the store's own country. */
+    autocomplete(input: string, sessionToken?: string, country?: string): Promise<Result<AutocompleteResponse, CimplifyError>>;
+    /**
+     * `country` (ISO alpha-2) is the country the place must lie in; pass the one
+     * the autocomplete used. Absent, the store's own country.
+     */
+    details(placeId: string, sessionToken?: string, country?: string): Promise<Result<PlaceDetailsResponse, CimplifyError>>;
 }
 
 interface DeliveryFeeResponse {
@@ -2025,8 +1895,9 @@ declare class SessionService {
     constructor(client: CimplifyClient);
     /** The verified customer this session is bound to, null while anonymous. */
     get claimedCustomerName(): string | null;
-    /** Adopt a session another holder already bound for this bearer. */
-    adopt(accessToken: string, session: SessionClaimedEvent): void;
+    /** Adopt a session another holder already bound, for this bearer or, with
+     * `null`, for a bearer this client never holds (the checkout element). */
+    adopt(accessToken: string | null, session: SessionClaimedEvent): void;
     /**
      * Bind the anonymous session to the verified Link identity in one server
      * transaction: verify the bearer, rotate the session token (adopted here),
@@ -2049,6 +1920,7 @@ declare class CimplifyElements {
     private options;
     private elements;
     private accessToken;
+    private sessionAuthenticated;
     private accountId;
     private customerId;
     private customerData;
@@ -2065,6 +1937,7 @@ declare class CimplifyElements {
     private stopSessionSync;
     _syncHostSession(element?: CimplifyElement): void;
     private identityCustomer;
+    private forgetIdentity;
     create(type: ElementType, options?: ElementOptions): CimplifyElement;
     getElement(type: ElementType): CimplifyElement | undefined;
     _removeElement(type: ElementType, instance: CimplifyElement): void;
@@ -2077,14 +1950,21 @@ declare class CimplifyElements {
     getSessionToken(): string | null;
     getBusinessId(): string | null;
     resolveBusinessId(): Promise<string | null>;
+    /** @internal Whether a `processCheckout` call is waiting on the checkout element. */
+    _isCheckoutInProgress(): boolean;
     getAppearance(): ElementsOptions["appearance"];
     private isAuthGenerationCurrent;
     private hydrateCustomerData;
     private sourceElementFor;
-    private sessionStorageKey;
-    private persistRefreshToken;
-    private clearPersistedSession;
-    private clearClaimedAuthorityAfterRestoreFailure;
+    /** Earlier SDK versions kept the account-wide Link refresh token here. It
+     * is removed on sight and never read. */
+    private dropLegacyRefreshToken;
+    private sessionAuthenticatedData;
+    /**
+     * A reload keeps the shopper signed in through the storefront session the
+     * element claimed for this business. The page asks the storefront API who
+     * that session belongs to; no Link credential is involved.
+     */
     private restoreSession;
     private applyAccessToken;
     private adoptEstablishedSession;
@@ -2108,6 +1988,7 @@ declare class CimplifyElement {
     private ready;
     private pendingMessages;
     private pendingInit;
+    private destroyed;
     private eventHandlers;
     private resolvers;
     private boundHandleMessage;
@@ -2125,11 +2006,18 @@ declare class CimplifyElement {
     private applyHeight;
     mount(container: string | HTMLElement): void;
     destroy(): void;
-    on(event: ElementEventType, handler: ElementEventHandler): void;
-    off(event: ElementEventType, handler: ElementEventHandler): void;
+    on<E extends ElementEventType>(event: E, handler: ElementEventHandler<ElementEventMap[E]>): void;
+    off<E extends ElementEventType>(event: E, handler: ElementEventHandler<ElementEventMap[E]>): void;
     getData(): Promise<unknown>;
     setCart(cart: CheckoutCartData): void;
+    /**
+     * Posts to the element. Until its iframe exists and reports READY (before
+     * `mount`, while the business id resolves, or while the iframe loads) the
+     * message is queued and sent on READY; a newer cart replaces a queued one.
+     * A destroyed element, or one whose iframe was removed from the page, drops it.
+     */
     sendMessage(message: ParentToIframeMessage): void;
+    private queue;
     private flushPending;
     getContentWindow(): Window | null;
     isMounted(): boolean;
@@ -2556,4 +2444,4 @@ declare class CatalogueQueries {
     getKnowledgeArticles(): Promise<Result<KnowledgeArticle[], CimplifyError>>;
 }
 
-export { type CimplifyConfig as $, type ActivityRecommendation as A, type Booking as B, CimplifyClient as C, type BusinessWithLocations as D, type CancelBookingInput as E, type CancelBookingResult as F, type CancelOrderInput as G, type CancellationPolicy as H, type CardPopupAction as I, CartOperations as J, CatalogueQueries as K, type CatalogueResult as L, type CatalogueSnapshot as M, type CategoryInfo as N, type ChatAttachment as O, type PaymentAuthorizationAdapter as P, type ChatConversation as Q, type ReadRequestOptions as R, type ChatConversationResponse as S, type ChatMessage as T, type ChatReplyContext as U, type ChatUploadAttachment as V, type ChatWidgetStarter as W, type CheckSlotAvailabilityInput as X, type CheckSlotAvailabilityResult as Y, type CheckoutInput as Z, CheckoutService as _, type CacheOptions as a, type OrderGroupDetails as a$, CimplifyElement as a0, CimplifyElements as a1, type ClaimExternalChatsResult as a2, type ClaimSessionResult as a3, type ContentType as a4, type CustomerBooking as a5, type CustomerBookingServiceItem as a6, type CustomerServicePreferences as a7, type DayAvailability as a8, type DeliveryFeeDetails as a9, type GetOrdersOptions as aA, type GetProductsOptions as aB, type GroupOrderInfo as aC, HostedPurchaseIntentService as aD, InventoryService as aE, type LifecyclePhase as aF, type LineItem as aG, type LineType as aH, LinkService as aI, type LiteBootstrap as aJ, type LiteDayHours as aK, type LiteHoursRange as aL, LiteService as aM, type Location as aN, type LocationBooking as aO, type LocationTaxBehavior as aP, type LocationTaxOverrides as aQ, type LocationTimeProfile as aR, type LocationWithDetails as aS, type ObservabilityHooks as aT, type Ok as aU, type Order as aV, type OrderCustomerInfo as aW, type OrderDiscountInfo as aX, type OrderFilter as aY, type OrderFulfillmentSummary as aZ, type OrderGroup as a_, type DeliveryFeeResponse as aa, type DeliveryFeeStatus as ab, type DeliveryOption as ac, type DeliveryOptionsQuery as ad, type DeliveryOptionsResponse as ae, DeliveryService as af, type DepositResult as ag, type DismissMessageResponse as ah, type EnrichedOrder as ai, type EnrichedOrderItem as aj, type Err as ak, type ExternalChatClaimAttempt as al, type ExternalChatClaimDisposition as am, type FeeBearerType as an, type FetchQuoteInput as ao, type FulfillmentLink as ap, type FulfillmentStatus as aq, type FulfillmentSummaryDTO as ar, type FulfillmentType as as, type FxQuote as at, type FxQuoteRequest as au, type FxQuoteStatus as av, type FxRateResponse as aw, FxService as ax, type GetAvailableSlotsInput as ay, type GetDeliveryOptionsParams as az, type Result as b, type ResourceAssignment as b$, type OrderGroupPayment as b0, type OrderGroupPaymentState as b1, type OrderGroupPaymentStatus as b2, type OrderGroupPaymentSummary as b3, type OrderGroupStatus as b4, type OrderHistory as b5, type OrderLineState as b6, type OrderLineStatus as b7, type OrderLocationInfo as b8, type OrderPaymentEvent as b9, PurchaseIntentService as bA, type PurchaseIntentTransport as bB, type QuoteBundleSelectionInput as bC, type QuoteCompositeSelectionInput as bD, type QuoteDynamicBuckets as bE, type QuoteStatus as bF, type QuoteUiMessage as bG, type RefreshQuoteInput as bH, type RefreshQuoteResult as bI, type RefundOrderInput as bJ, type RelatedCandidate as bK, type RelatedProduct as bL, type RelatedProductsEnrichment as bM, type RelationType as bN, type ReminderMethod as bO, type ReminderSettings as bP, type ReorderResult as bQ, type RequestContext as bR, type RequestErrorEvent as bS, type RequestOptions as bT, type RequestRetryPolicy as bU, type RequestSource as bV, type RequestStartEvent as bW, type RequestSuccessEvent as bX, type RescheduleBookingInput as bY, type RescheduleBookingResult as bZ, type RescheduleHistoryRecord as b_, type OrderPricingView as ba, OrderQueries as bb, type OrderSplitDetail as bc, type OrderStaffInfo as bd, type OrderStatus as be, type OrderTimestampsDTO as bf, type Origin as bg, type OriginActor as bh, type OriginChannel as bi, type OtpResult as bj, PAYMENT_AUTHORIZATION_OUTCOME_STATUS as bk, PAYMENT_AUTHORIZATION_PROVIDER as bl, PURCHASE_INTENT_ROUTE as bm, PaymentAuthorizationAdapterRegistry as bn, type PaymentInfoDTO as bo, type PaymentState as bp, type PlaceDetailsResponse as bq, PlacesService as br, type PriceQuote as bs, type PricingOverrides as bt, type ProviderResolutionSource as bu, type PurchaseIntentActionDecision as bv, type PurchaseIntentRequestOptions as bw, type PurchaseIntentResolveOptions as bx, type PurchaseIntentResolveStatus as by, PurchaseIntentResolver as bz, type PaymentAuthorizationContext as c, type ResourceInfo as c0, type RetryEvent as c1, type Room as c2, SESSION_CHANGE_SOURCE as c3, type SchedulingMetadata as c4, type SchedulingResult as c5, SchedulingService as c6, type SenderType as c7, type Service as c8, type ServiceAvailabilityParams as c9, type TimeSlot as cA, type TrackCategoryViewOptions as cB, type TrackProductViewOptions as cC, type UpdateOrderStatusInput as cD, type UpdateProfileInput as cE, type UploadInitResponse as cF, type UploadResult as cG, UploadService as cH, combine as cI, combineObject as cJ, createCimplifyClient as cK, createDefaultPaymentAuthorizationAdapterRegistry as cL, createElements as cM, err as cN, flatMap as cO, fromPromise as cP, getOrElse as cQ, isErr as cR, isOk as cS, mapError as cT, mapResult as cU, ok as cV, toNullable as cW, tryCatch as cX, unwrap as cY, type ServiceAvailabilityResult as ca, type ServiceCharge as cb, type ServiceNotes as cc, type ServiceScheduleRequest as cd, type ServiceStatus as ce, type SessionActivityData as cf, type SessionChangeEvent as cg, type SessionChangeSource as ch, type SessionMessage as ci, SessionService as cj, type SlotResourceInfo as ck, type SlotStaffInfo as cl, type Staff as cm, type StaffAssignment as cn, type StaffRole as co, type StaffScheduleItem as cp, type StockLevel as cq, type StockStatus as cr, type StoreCreditBalance as cs, StoreCreditQueries as ct, type StorefrontBootstrap as cu, SubscriptionService as cv, SupportService as cw, type Table as cx, type TimeRange as cy, type TimeRanges as cz, type PaymentAuthorizationOutcome as d, type ChatReplyCard as e, type ActivityRecommendationsResponse as f, ActivityService as g, type ActivityStateResponse as h, type AmountToPay as i, AuthService as j, type AuthStatus as k, type AuthorizeCardPopupOptions as l, type AutocompletePrediction as m, type AutocompleteResponse as n, type AvailabilityResult as o, type AvailableSlot as p, type BookingModificationType as q, type BookingStatus as r, type BookingWithDetails as s, type BufferTimes as t, type Business as u, type BusinessDetailsDTO as v, type BusinessHours as w, type BusinessPreferences as x, BusinessService as y, type BusinessSettings as z };
+export { type DeliveryFeeDetails as $, type ActivityRecommendation as A, type BufferTimes as B, CimplifyClient as C, CartOperations as D, CatalogueQueries as E, type CatalogueResult as F, type CatalogueSnapshot as G, type CategoryInfo as H, type ChatAttachment as I, type ChatConversation as J, type ChatConversationResponse as K, type ChatMessage as L, type ChatReplyContext as M, type ChatUploadAttachment as N, type ChatWidgetStarter as O, type PaymentAuthorizationAdapter as P, type CheckoutInput as Q, type ReadRequestOptions as R, CheckoutService as S, type CimplifyConfig as T, CimplifyElement as U, CimplifyElements as V, type ClaimExternalChatsResult as W, type ClaimSessionResult as X, type ContentSha256 as Y, type ContentType as Z, type CustomerServicePreferences as _, type CacheOptions as a, type OrderPaymentEvent as a$, type DeliveryFeeResponse as a0, type DeliveryFeeStatus as a1, type DeliveryOption as a2, type DeliveryOptionsQuery as a3, type DeliveryOptionsResponse as a4, DeliveryService as a5, type DepositResult as a6, type DismissMessageResponse as a7, type EmbeddingOrigins as a8, type EnrichedOrder as a9, type LiteDayHours as aA, type LiteHoursRange as aB, LiteService as aC, type Location as aD, type LocationBooking as aE, type LocationTaxBehavior as aF, type LocationTaxOverrides as aG, type LocationTimeProfile as aH, type LocationWithDetails as aI, type ObservabilityHooks as aJ, type Ok as aK, type Order as aL, type OrderCustomerInfo as aM, type OrderDiscountInfo as aN, type OrderFilter as aO, type OrderFulfillmentSummary as aP, type OrderGroup as aQ, type OrderGroupDetails as aR, type OrderGroupPayment as aS, type OrderGroupPaymentState as aT, type OrderGroupPaymentStatus as aU, type OrderGroupPaymentSummary as aV, type OrderGroupStatus as aW, type OrderHistory as aX, type OrderLineState as aY, type OrderLineStatus as aZ, type OrderLocationInfo as a_, type EnrichedOrderItem as aa, type Err as ab, type ExternalChatClaimAttempt as ac, type ExternalChatClaimDisposition as ad, type FeeBearerType as ae, type FetchQuoteInput as af, type FulfillmentLink as ag, type FulfillmentStatus as ah, type FulfillmentSummaryDTO as ai, type FulfillmentType as aj, type FxQuote as ak, type FxQuoteRequest as al, type FxQuoteStatus as am, type FxRateResponse as an, FxService as ao, type GetDeliveryOptionsParams as ap, type GetOrdersOptions as aq, type GetProductsOptions as ar, type GroupOrderInfo as as, HostedPurchaseIntentService as at, InventoryService as au, type LifecyclePhase as av, type LineItem as aw, type LineType as ax, LinkService as ay, type LiteBootstrap as az, type Result as b, type SessionActivityData as b$, type OrderPricingView as b0, OrderQueries as b1, type OrderSplitDetail as b2, type OrderStaffInfo as b3, type OrderStatus as b4, type OrderTimestampsDTO as b5, type Origin as b6, type OriginActor as b7, type OriginChannel as b8, type OtpResult as b9, type RelatedCandidate as bA, type RelatedProduct as bB, type RelatedProductsEnrichment as bC, type RelationType as bD, type ReminderMethod as bE, type ReminderSettings as bF, type ReorderResult as bG, type RequestContext as bH, type RequestErrorEvent as bI, type RequestOptions as bJ, type RequestRetryPolicy as bK, type RequestSource as bL, type RequestStartEvent as bM, type RequestSuccessEvent as bN, type ResourceAssignment as bO, type ResourceInfo as bP, type RetryEvent as bQ, type Room as bR, SESSION_CHANGE_SOURCE as bS, type SchedulingMetadata as bT, type SchedulingResult as bU, SchedulingService as bV, type SenderType as bW, type ServiceCharge as bX, type ServiceNotes as bY, type ServiceScheduleRequest as bZ, type ServiceStatus as b_, PAYMENT_AUTHORIZATION_OUTCOME_STATUS as ba, PAYMENT_AUTHORIZATION_PROVIDER as bb, PURCHASE_INTENT_ROUTE as bc, PaymentAuthorizationAdapterRegistry as bd, type PaymentInfoDTO as be, type PaymentState as bf, type PlaceDetailsResponse as bg, PlacesService as bh, type PriceQuote as bi, type PricingOverrides as bj, type ProviderResolutionSource as bk, type PurchaseIntentActionDecision as bl, type PurchaseIntentRequestOptions as bm, type PurchaseIntentResolveOptions as bn, type PurchaseIntentResolveStatus as bo, PurchaseIntentResolver as bp, PurchaseIntentService as bq, type PurchaseIntentTransport as br, type QuoteBundleSelectionInput as bs, type QuoteCompositeSelectionInput as bt, type QuoteDynamicBuckets as bu, type QuoteStatus as bv, type QuoteUiMessage as bw, type RefreshQuoteInput as bx, type RefreshQuoteResult as by, type RefundOrderInput as bz, type PaymentAuthorizationContext as c, type SessionChangeEvent as c0, type SessionChangeSource as c1, type SessionMessage as c2, SessionService as c3, type StaffAssignment as c4, type StaffRole as c5, type StaffScheduleItem as c6, type StockLevel as c7, type StockStatus as c8, type StoreCreditBalance as c9, isOk as cA, isTransientPurchaseIntentError as cB, mapError as cC, mapResult as cD, ok as cE, toNullable as cF, tryCatch as cG, unwrap as cH, StoreCreditQueries as ca, type StorefrontBootstrap as cb, SubscriptionService as cc, SupportService as cd, type Table as ce, type TimeRange as cf, type TimeRanges as cg, type TrackCategoryViewOptions as ch, type TrackProductViewOptions as ci, type UpdateOrderStatusInput as cj, type UpdateProfileInput as ck, type UploadInitOptions as cl, type UploadInitResponse as cm, type UploadResult as cn, UploadService as co, combine as cp, combineObject as cq, contentSha256 as cr, createCimplifyClient as cs, createDefaultPaymentAuthorizationAdapterRegistry as ct, createElements as cu, err as cv, flatMap as cw, fromPromise as cx, getOrElse as cy, isErr as cz, type PaymentAuthorizationOutcome as d, type ChatReplyCard as e, type ActivityRecommendationsResponse as f, ActivityService as g, type ActivityStateResponse as h, type AmountToPay as i, AuthService as j, type AuthStatus as k, type AuthorizeCardPopupOptions as l, type AutocompletePrediction as m, type AutocompleteResponse as n, type AvailabilityResult as o, type Business as p, type BusinessDetailsDTO as q, type BusinessHours as r, type BusinessPreferences as s, BusinessService as t, type BusinessSettings as u, type BusinessWithLocations as v, CONTENT_SHA256_HEADER as w, type CancelOrderInput as x, type CancellationPolicy as y, type CardPopupAction as z };