@01.software/sdk 0.44.0 → 0.45.0

package/dist/{types-Dt9FJisi.d.ts → types-C4WuJfw7.d.cts}

@@ -1,6 +1,34 @@
-import { P as PublicCollection, S as ServerCollection } from './const-pGDnsy0o.js';
-import { C as CollectionType, P as PublicProduct } from './types-oiae_LMm.js';
-import { O as Order, m as Transaction, n as Fulfillment, R as Return } from './payload-types-CDsuOEfM.js';
+import { P as PublicCollection, C as Collection, S as ServerCollection } from './const-BAG0MH0u.cjs';
+import { C as CollectionType, a as PublicProduct, P as PublicMarket } from './types-D5p7-m1l.cjs';
+import { O as Order, k as Transaction, l as Fulfillment, R as Return } from './payload-types-CJZuXcgF.cjs';
+
+declare const operationBrand: unique symbol;
+type HttpOperation = {
+    readonly [operationBrand]: true;
+    readonly collection: string | null;
+    readonly method: 'get' | 'post' | 'patch' | 'delete';
+    readonly path: `/${string}`;
+};
+
+/**
+ * Single source of truth for the commerce HTTP paths the SDK calls.
+ *
+ * Console exposes these as `slug + Endpoint.path` on collection configs; the SDK
+ * has to hardcode the joined `/api/<slug>/<path>` because it cannot import the
+ * Console at build time. To stop a Console path change from silently turning into
+ * a runtime 404, non-quarantined values are cross-checked against live Console
+ * endpoint registration by `apps/console/tests/unit/sdk/endpoint-parity.test.ts`.
+ * That test also records canonical Phase 1 operations whose route is absent or
+ * whose same-path legacy handler is not yet contract-compatible; registration
+ * alone must never be interpreted as transport parity.
+ *
+ * Keep this internal — it is the transport contract, not public SDK surface.
+ */
+type CanonicalCommerceEndpointDescriptor = {
+    readonly method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    readonly path: string;
+};
+type CommerceEndpointDescriptor = CanonicalCommerceEndpointDescriptor | HttpOperation;
 
 interface CustomerScopedApiOptions {
     publishableKey?: string;
@@ -15,14 +43,22 @@ interface CustomerScopedRequestOptions {
     method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
     body?: unknown;
     headers?: Record<string, string>;
+    errorFamily?: 'commerce';
 }
+type EndpointRequestOptions$1 = {
+    headers?: Record<string, string>;
+    pathParams?: Readonly<Record<string, string>>;
+    query?: string | URLSearchParams;
+};
+/** Operation-only base for customer-scoped commerce APIs. */
 declare class CustomerScopedApi {
-    private readonly publishableKey;
-    private readonly secretKey?;
-    private readonly apiUrl?;
-    private readonly customerToken?;
-    private readonly onUnauthorized?;
-    private readonly onRequestId?;
+    private readonly transport;
+    constructor(apiName: string, options: CustomerScopedApiOptions);
+    protected requestEndpoint<T>(endpoint: CommerceEndpointDescriptor, body?: unknown, options?: EndpointRequestOptions$1): Promise<T>;
+}
+/** Raw transport base reserved for non-commerce customer-scoped APIs. */
+declare class RawCustomerScopedApi {
+    private readonly transport;
     constructor(apiName: string, options: CustomerScopedApiOptions);
     protected request<T>(endpoint: string, options: CustomerScopedRequestOptions): Promise<T>;
 }
@@ -167,7 +203,7 @@ type CommunityPostMutationResponse = CommunityPost | RawCommunityPost;
 type CommunityCommentMutationResponse = CommunityComment | RawCommunityComment;
 type CommunityReactionMutationResponse = Reaction | RawCommunityReaction;
 type CommunityBookmarkMutationResponse = Bookmark | RawCommunityBookmark;
-declare class CommunityClient extends CustomerScopedApi {
+declare class CommunityClient extends RawCustomerScopedApi {
     constructor(options: CommunityClientOptions);
     private buildQuery;
     private buildPostsListQuery;
@@ -332,8 +368,22 @@ interface ServerApiOptions {
 interface RequestOptions {
     method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
     headers?: Record<string, string>;
+    errorFamily?: 'commerce';
 }
+type EndpointRequestOptions = {
+    headers?: Record<string, string>;
+    pathParams?: Readonly<Record<string, string>>;
+    query?: string | URLSearchParams;
+};
+/** Operation-only base for commerce APIs. Raw URL execution is intentionally absent. */
 declare abstract class BaseApi {
+    private readonly transport;
+    constructor(apiName: string, options: ServerApiOptions);
+    protected requestEndpoint<T>(endpoint: CommerceEndpointDescriptor, body: unknown, options?: EndpointRequestOptions): Promise<T>;
+}
+/** Raw transport base reserved for non-commerce APIs with genuinely dynamic URLs. */
+declare abstract class RawBaseApi {
+    private readonly transport;
     protected readonly publishableKey: string;
     protected readonly secretKey: string;
     protected readonly apiUrl?: string;
@@ -362,7 +412,7 @@ type BanCustomerParams = {
 type UnbanCustomerParams = {
     customerId: string;
 };
-declare class ModerationApi extends BaseApi {
+declare class ModerationApi extends RawBaseApi {
     constructor(options: ModerationApiOptions);
     banCustomer(params: BanCustomerParams): Promise<CommunityBan>;
     unbanCustomer(params: UnbanCustomerParams): Promise<{
@@ -388,6 +438,177 @@ type PublicMediaAsset = string | {
     sizes?: Record<string, PublicMediaSize>;
 };
 
+interface CartApiOptions {
+    publishableKey?: string;
+    secretKey?: string;
+    apiUrl?: string;
+    customerToken?: string | (() => string | null);
+    onUnauthorized?: () => Promise<string | null>;
+    onRequestId?: (id: string | null) => void;
+}
+declare const MAX_CART_LINE_ADMISSIONS = 32;
+type PublicAttribute = {
+    key: string;
+    value: string;
+};
+type CreateCartParams = {
+    market?: string;
+    attributes?: PublicAttribute[];
+};
+type PublicCartItemAdmission = {
+    eventId: string;
+    occurrenceId: string;
+    admissionTypeId: string;
+};
+type AddItemParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+    productId: string;
+    variantId: string;
+    quantity: number;
+    admissions?: readonly [PublicCartItemAdmission, ...PublicCartItemAdmission[]];
+};
+type UpdateItemParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+    cartItemId: string;
+    quantity: number;
+};
+type RemoveItemParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+    cartItemId: string;
+};
+type UpdateDiscountCodesParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+    discountCodes: string[];
+};
+type UpdateCartAttributesParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+    attributes: PublicAttribute[];
+};
+type ClearCartParams = {
+    cartToken: string;
+    expectedRevision: number;
+    idempotencyKey: string;
+};
+type RetrieveCartParams = {
+    cartToken: string;
+};
+type CartMineParams = Record<string, never>;
+type ServerCartMineParams = {
+    customerToken: string;
+};
+type CartMergeParams = {
+    guestCartToken: string;
+    idempotencyKey: string;
+};
+type ServerCartMergeParams = CartMergeParams & {
+    customerToken: string;
+};
+type CartDiscountCode = {
+    code: string;
+    applicable: boolean;
+};
+type CartWarningCode = 'DISCOUNT_CODE_NOT_HONOURED' | 'DISCOUNT_CURRENTLY_INACTIVE' | 'DISCOUNT_CUSTOMER_NOT_ELIGIBLE' | 'DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED' | 'DISCOUNT_ELIGIBLE_CUSTOMER_MISSING' | 'DISCOUNT_NO_ENTITLED_LINE_ITEMS' | 'DISCOUNT_NO_ENTITLED_SHIPPING_LINES' | 'DISCOUNT_NOT_FOUND' | 'DISCOUNT_PURCHASE_NOT_IN_RANGE' | 'DISCOUNT_USAGE_LIMIT_REACHED' | 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'MERCHANDISE_OUT_OF_STOCK';
+type CartWarning = {
+    code: CartWarningCode;
+    message: string;
+    target: string;
+};
+type PublicCartReference = {
+    id: string;
+    title: string;
+    handle: string | null;
+    image: PublicMediaAsset | null;
+};
+type PublicCartMarket = {
+    id: string;
+    handle: string;
+    name: string;
+};
+type PublicCartItem = {
+    id: string;
+    product: PublicCartReference;
+    variant: PublicCartReference;
+    admissions: PublicCartItemAdmission[];
+    quantity: number;
+    unitPriceMinor: number;
+    discountMinor: number;
+    estimatedLineTotalMinor: number;
+    requiresShipping: boolean;
+};
+type PublicCart = {
+    id: string;
+    status: 'active' | 'completed' | 'abandoned';
+    revision: number;
+    currency: Uppercase<string>;
+    market: PublicCartMarket;
+    subtotalMinor: number;
+    discountMinor: number;
+    estimatedTotalMinor: number;
+    discountCodes: CartDiscountCode[];
+    attributes: PublicAttribute[];
+    items: PublicCartItem[];
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type CartMutationResult = {
+    cart: PublicCart;
+    warnings: CartWarning[];
+};
+type CreateCartResult = {
+    cart: PublicCart;
+    warnings: CartWarning[];
+    cartToken: string;
+};
+type CartMergeResultBase = CreateCartResult;
+type CartMergeResult = CartMergeResultBase & ({
+    resolution: 'unchanged';
+    merged: false;
+    claimed: false;
+} | {
+    resolution: 'claimed';
+    merged: false;
+    claimed: true;
+} | {
+    resolution: 'merged';
+    merged: true;
+    claimed: false;
+});
+type CartMineResult = {
+    cart: PublicCart;
+    cartToken: string;
+} | {
+    cart: null;
+    cartToken: null;
+};
+declare class CartApi extends CustomerScopedApi {
+    private readonly serverTransport;
+    constructor(options: CartApiOptions);
+    private endpoint;
+    private execute;
+    create(params?: CreateCartParams): Promise<CreateCartResult>;
+    retrieve(params: RetrieveCartParams): Promise<PublicCart>;
+    mine(params?: CartMineParams | ServerCartMineParams): Promise<CartMineResult>;
+    merge(params: CartMergeParams | ServerCartMergeParams): Promise<CartMergeResult>;
+    addItem(params: AddItemParams): Promise<CartMutationResult>;
+    private mutate;
+    updateItem(params: UpdateItemParams): Promise<CartMutationResult>;
+    removeItem(params: RemoveItemParams): Promise<CartMutationResult>;
+    clear(params: ClearCartParams): Promise<CartMutationResult>;
+    updateDiscountCodes(params: UpdateDiscountCodesParams): Promise<CartMutationResult>;
+    updateAttributes(params: UpdateCartAttributesParams): Promise<CartMutationResult>;
+}
+
 type OrderApiOptions = ServerApiOptions;
 /** Header-only; never sent in the JSON body. */
 type WithIdempotencyKey<T> = T & {
@@ -397,196 +618,76 @@ type WithIdempotencyKey<T> = T & {
      */
     idempotencyKey?: string;
 };
-type CustomerSnapshot = {
-    name?: string;
-    email: string;
-    phone?: string;
-};
-type CheckoutShippingAddress = {
-    recipientName: string;
-    phone: string;
-    postalCode: string;
-    address: string;
-    detailAddress: string;
-    deliveryMessage?: string;
-};
-type PublicOrderReference = string | {
-    id?: string | number | null;
-    title?: string | null;
-    name?: string | null;
-    slug?: string | null;
-    displayName?: string | null;
-    handle?: string | null;
-    color?: string | null;
-    image?: PublicMediaAsset | null;
-    thumbnail?: PublicMediaAsset | null;
-    avatar?: PublicMediaAsset | null;
-};
+type PublicOrderReference = PublicCartReference;
 type PublicOrderItem = {
-    id?: string | number;
-    product?: PublicOrderReference;
-    variant?: PublicOrderReference;
-    productTitle?: string | null;
-    variantTitle?: string | null;
-    sku?: string | null;
-    quantity?: number | null;
-    unitPrice?: number | null;
-    discountedUnitPrice?: number | null;
-    discountedTotalPrice?: number | null;
-    totalPrice?: number | null;
-    options?: unknown;
-    createdAt?: string | null;
-    updatedAt?: string | null;
-    image?: PublicMediaAsset | null;
+    id: string;
+    product: PublicOrderReference | null;
+    variant: PublicOrderReference | null;
+    productTitle: string;
+    variantTitle: string | null;
+    sku: string | null;
+    admissions: PublicCartItemAdmission[];
+    quantity: number;
+    unitPriceMinor: number;
+    discountMinor: number;
+    lineTotalMinor: number;
+    requiresShipping: boolean;
+};
+type PublicOrderAmounts = {
+    currency: Uppercase<string>;
+    subtotalMinor: number;
+    shippingMinor: number;
+    discountMinor: number;
+    totalMinor: number;
+    refundedMinor: number;
+    currentTotalMinor: number;
 };
 type PublicOrder = {
-    id?: string | number;
-    orderNumber?: string | null;
-    /** @deprecated Read-only compatibility alias. Prefer the independent axes. */
-    status?: string | null;
-    /** @deprecated Read-only compatibility alias. Prefer the independent axes. */
-    displayStatus?: string | null;
-    primaryDisplayStatus?: string | null;
-    displayFinancialStatus?: string | null;
-    displayFulfillmentStatus?: string | null;
-    returnStatus?: string | null;
-    returnDisplayStatus?: string | null;
-    totalAmount?: number | null;
-    subtotalAmount?: number | null;
-    shippingAmount?: number | null;
-    discountAmount?: number | null;
-    taxAmount?: number | null;
-    refundedAmount?: number | null;
-    /** Net order total after refunds (`totalAmount - refundedAmount`, clamped at 0). */
-    currentTotalAmount?: number | null;
-    currency?: string | null;
-    customerNote?: string | null;
-    createdAt?: string | null;
-    updatedAt?: string | null;
-    customerSnapshot?: {
-        name?: string | null;
-        email?: string | null;
-        phone?: string | null;
-    };
-    shippingAddress?: {
-        recipientName?: string | null;
-        phone?: string | null;
-        postalCode?: string | null;
-        address1?: string | null;
-        address2?: string | null;
-        jibunAddress?: string | null;
-        administrativeArea?: string | null;
-        city?: string | null;
-        province?: string | null;
-        country?: string | null;
-        deliveryMemo?: string | null;
-        address?: string | null;
-        detailAddress?: string | null;
-        deliveryMessage?: string | null;
+    id: string;
+    orderNumber: string;
+    amounts: PublicOrderAmounts;
+    market: PublicCartMarket | null;
+    customerSnapshot: {
+        email: string;
+        name?: string;
+        phone?: string;
     };
-    items?: PublicOrderItem[];
-};
-type ReturnReason = 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other';
+    shippingAddress: {
+        recipientName: string;
+        phone: string;
+        countryCode?: string;
+        regionCode?: string;
+        postalCode: string;
+        address: string;
+        detailAddress: string;
+        deliveryMessage?: string;
+    } | null;
+    attributes: PublicAttribute[];
+    items: PublicOrderItem[];
+    financialStatus: 'pending' | 'authorized' | 'expired' | 'partially_paid' | 'paid' | 'canceled' | 'partially_refunded' | 'refunded' | 'reconciliation_required';
+    fulfillmentStatus: 'unfulfilled' | 'in_progress' | 'on_hold' | 'partially_fulfilled' | 'shipped' | 'fulfilled' | 'canceled';
+    returnStatus: 'no_return' | 'return_requested' | 'in_progress' | 'returned';
+    confirmationStatus: 'unconfirmed' | 'confirmed';
+    primaryDisplayStatus: 'pending' | 'paid' | 'canceled' | 'refunded' | 'preparing' | 'shipped' | 'delivered' | 'confirmed';
+    placedAt: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type ReturnReason = 'change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'size_too_large' | 'size_too_small' | 'color' | 'style' | 'not_as_described' | 'wrong_item' | 'unknown' | 'other';
+type ReturnRejectionReason = 'window_expired' | 'used_or_damaged' | 'non_returnable' | 'other';
+type ReturnCancellationReasonCode = 'items_not_received' | 'customer_withdrew' | 'merchant_decision' | 'other';
 type ReturnItem = {
     orderItem: string | number;
     quantity: number;
     restockAction?: RestockAction;
     restockingFee?: number;
 };
-type OrderCreateEntityID = string | number;
-type CreateOrderItem = {
-    /**
-     * Compatibility input: the create-order endpoint derives the line's product
-     * from the variant's parent server-side; storefront items may omit this.
-     */
-    product?: OrderCreateEntityID;
-    variant: OrderCreateEntityID;
-    /**
-     * Compatibility input: accepted but unused by the create-order endpoint;
-     * option selection is snapshotted server-side from the variant.
-     */
-    option?: OrderCreateEntityID;
-    quantity: number;
-    /**
-     * Compatibility input: the create-order endpoint accepts this, but the server
-     * derives authoritative line pricing from the product variant.
-     */
-    unitPrice?: number;
-    /**
-     * Compatibility input: the create-order endpoint accepts this, but the server
-     * derives authoritative line totals from the product variant.
-     */
-    totalPrice?: number;
-};
-type CreateOrderLineItemsInput = {
-    orderItems: CreateOrderItem[];
-    items?: never;
-} | {
-    /**
-     * Storefront-facing alias for orderItems. The SDK serializes this to
-     * orderItems for the existing create-order endpoint.
-     */
-    items: CreateOrderItem[];
-    /**
-     * @deprecated Use items for storefront-facing create-order inputs.
-     */
-    orderItems?: never;
-};
-type PaymentProviderInput = {
-    pgPaymentId: string;
-    pgProvider: string;
-} | {
-    pgPaymentId?: never;
-    pgProvider?: never;
-};
-type CreateOrderBodyBase = {
-    orderNumber: string;
-    customer?: string;
-    customerSnapshot: CustomerSnapshot;
-    shippingAddress?: Order['shippingAddress'];
-    totalAmount: number;
-    shippingAmount?: number;
-    discountCode?: string;
-} & PaymentProviderInput;
-type CreateOrderParams = WithIdempotencyKey<CreateOrderBodyBase & CreateOrderLineItemsInput>;
 type UpdateOrderParams = {
     orderNumber: string;
     status: 'confirmed';
 };
-type TransactionStatus = 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded';
-type UpdateTransactionParams = {
-    pgPaymentId: string;
-    status: TransactionStatus;
-    paymentMethod?: string;
-    receiptUrl?: string;
-    paymentKey?: string;
-    amount?: number;
-};
-type ConfirmPaymentParams = WithIdempotencyKey<{
-    orderNumber?: string;
-    pgPaymentId: string;
-    pgProvider: string;
-    pgOrderId?: string;
-    amount: number;
-    currency?: string;
-    paymentMethod?: string;
-    receiptUrl?: string;
-    approvedAt?: string;
-    providerStatus?: string;
-    /** Provider event id; also used as idempotency key when `idempotencyKey` is omitted. */
-    providerEventId?: string;
-    paymentKey?: string;
-    confirmationSource?: 'provider_webhook' | 'provider_lookup' | 'provider_api_confirm' | 'manual_server';
-    metadata?: Record<string, unknown>;
-}>;
-type ConfirmPaymentResponse = {
-    orderId: string;
-    transactionId: string;
-    status: 'paid';
-    alreadyConfirmed?: boolean;
-};
 type GetOrderByPaymentIdParams = {
-    /** Payment provider slug, e.g. `toss`, `portone`. */
+    /** Payment provider slug, e.g. `toss`. */
     pgProvider: string;
     /** Provider payment identifier stored on the payment transaction. */
     pgPaymentId: string;
@@ -601,18 +702,7 @@ type OrderByPaymentResult = {
     order: Order;
     transaction: Transaction | null;
 };
-/**
- * Result of {@link OrderApi.confirmPaymentReturningOrder}: the raw
- * `confirmPayment` confirmation plus the depth-populated order/transaction
- * resolved by the same payment id.
- */
-type ConfirmPaymentWithOrderResult = ConfirmPaymentResponse & {
-    order: Order;
-    transaction: Transaction | null;
-};
 type CancelReasonCode = 'customer' | 'inventory' | 'fraud' | 'declined' | 'staff' | 'other';
-type CancelOrderStatus = 'pending' | 'paid' | 'canceled' | 'refunded' | 'preparing' | 'shipped' | 'delivered' | 'confirmed' | 'return_requested' | 'return_processing' | 'returned';
-type CancelOrderReconciliationStatus = Exclude<CancelOrderStatus, 'pending' | 'canceled'>;
 type CancelOrderResponseBase = {
     orderId: string;
 };
@@ -626,12 +716,6 @@ type CancelOrderPaidCommittedResponseFields = {
     providerRefunded: false;
     refundPending: true;
 };
-type CancelOrderLegacyProviderRefundResponseFields = {
-    transactionId: string;
-    refundedAmount: number;
-    refundSeq: number;
-    providerRefunded: true;
-};
 type CancelOrderAlreadyCanceledResponseFields = {
     refundedAmount: number;
     providerRefunded: false;
@@ -661,13 +745,7 @@ type CancelOrderAlreadyCanceledRefundPendingResponse = CancelOrderResponseBase &
     cancelCommitted: false;
     alreadyCanceled: true;
 };
-/** @deprecated Inline PG cancel reconciliation; retained for legacy API consumers. */
-type CancelOrderReconciliationResponse = CancelOrderResponseBase & CancelOrderLegacyProviderRefundResponseFields & {
-    status: CancelOrderReconciliationStatus;
-    cancelCommitted: false;
-    reconciliationRequired: true;
-};
-type CancelOrderResponse = CancelOrderCommittedResponse | CancelOrderAlreadyCanceledResponse | CancelOrderAlreadyCanceledRefundPendingResponse | CancelOrderReconciliationResponse;
+type CancelOrderResponse = CancelOrderCommittedResponse | CancelOrderAlreadyCanceledResponse | CancelOrderAlreadyCanceledRefundPendingResponse;
 type CancelOrderParams = {
     orderNumber: string;
     reasonCode?: CancelReasonCode;
@@ -698,7 +776,7 @@ type ResolveCancelRefundSucceededResponse = {
     refundTransactionId: string;
     refundedAmount: number;
     refundStatus: 'succeeded';
-    transactionStatus: 'refunded';
+    transactionStatus: 'paid' | 'refunded';
 };
 type ResolveCancelRefundFailedResponse = {
     orderId: string;
@@ -729,14 +807,6 @@ type ReturnWithRefundParams = WithIdempotencyKey<{
     paymentKey?: string;
     refundReceiptUrl?: string;
 }>;
-type CheckoutParams = WithIdempotencyKey<{
-    cartId: string;
-    cartToken?: string;
-    orderNumber: string;
-    customerSnapshot: CustomerSnapshot;
-    shippingAddress?: CheckoutShippingAddress;
-    discountCode?: string;
-} & PaymentProviderInput>;
 type CreateFulfillmentParams = WithIdempotencyKey<{
     orderNumber: string;
     fulfillmentOrderId?: string | number;
@@ -749,7 +819,7 @@ type CreateFulfillmentParams = WithIdempotencyKey<{
     carrier?: string;
     trackingNumber?: string;
     items?: Array<{
-        orderItem: string;
+        orderItem: string | number;
         quantity: number;
     }>;
 }>;
@@ -764,7 +834,7 @@ type PrepareFulfillmentOrderResponse = {
     }>;
 };
 type UpdateFulfillmentParams = {
-    fulfillmentId: string;
+    fulfillmentId: string | number;
     status?: 'shipped' | 'delivered' | 'failed';
     carrier?: string;
     trackingNumber?: string;
@@ -797,39 +867,23 @@ type CreateReturnParams = WithIdempotencyKey<{
     initialShippingRefundOverrideNote?: string;
 }>;
 type UpdateReturnParams = {
-    returnId: string;
-    status: 'processing' | 'approved' | 'rejected' | 'completed';
+    returnId: string | number;
+    status: 'processing' | 'approved' | 'rejected' | 'canceled' | 'completed';
+    reasonCode?: ReturnRejectionReason;
+    cancellationReasonCode?: ReturnCancellationReasonCode;
+    cancellationReasonDetail?: string;
 };
 declare class OrderApi extends BaseApi {
     constructor(options: OrderApiOptions);
-    createOrder(params: CreateOrderParams): Promise<Order>;
     updateOrder(params: UpdateOrderParams): Promise<Order>;
-    updateTransaction(params: UpdateTransactionParams): Promise<Transaction>;
-    confirmPayment(params: ConfirmPaymentParams): Promise<ConfirmPaymentResponse>;
     /**
      * Resolve an order + its payment transaction by PG payment id. Replaces raw
      * `transactions.find({ where: { pgPaymentId } })` + a local file index in
      * storefronts. Server-only (sk01_) read of the full populated Order.
      */
     getByPaymentId(params: GetOrderByPaymentIdParams): Promise<OrderByPaymentResult>;
-    /**
-     * Composed facade: confirm a provider payment, then resolve the
-     * depth-populated order/transaction by the same payment id. `confirmPayment`'s
-     * wire response carries only IDs (its contract is `.strict()`); this returns
-     * the populated `Order` so storefronts stop reconstructing order state
-     * locally. Two round trips by design — the alternative (widening the strict
-     * confirm-payment wire contract to embed a full Order) is rejected.
-     */
-    confirmPaymentReturningOrder(params: ConfirmPaymentParams): Promise<ConfirmPaymentWithOrderResult>;
     cancelOrder(params: CancelOrderParams): Promise<CancelOrderResponse>;
     resolveCancelRefund(params: ResolveCancelRefundParams): Promise<ResolveCancelRefundResponse>;
-    /**
-     * Returns a `PublicOrder`-compatible shape even when the server backs the
-     * response with a Checkout (checkout/order separation, #1285). `orderNumber`
-     * stays the stable cross-window key. A breaking `PublicCheckout` split is a
-     * deferred follow-up (design D10 / Q3-b); do not change this return type here.
-     */
-    checkout(params: CheckoutParams): Promise<PublicOrder>;
     createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
     prepareFulfillmentOrder(params: PrepareFulfillmentOrderParams): Promise<PrepareFulfillmentOrderResponse>;
     updateFulfillment(params: UpdateFulfillmentParams): Promise<Fulfillment>;
@@ -842,18 +896,88 @@ declare class OrderApi extends BaseApi {
     updateReturn(params: UpdateReturnParams): Promise<Return>;
 }
 
+interface CustomerOAuthConfig {
+    clientId: string;
+    issuer: string;
+    timeout?: number;
+}
+interface CustomerAuthorizationUrlInput {
+    redirectUri: string;
+    returnTo?: string;
+    scopes?: readonly string[];
+}
+interface CustomerAuthorizationUrlResult {
+    authorizationUrl: string;
+    codeChallenge: string;
+    codeVerifier: string;
+    nonce: string;
+    returnTo: string | null;
+    state: string;
+}
+interface CustomerOAuthCallbackResult {
+    code: string;
+    state: string;
+}
+interface CustomerOAuthTokenSet {
+    accessToken: string;
+    expiresAt: number;
+    expiresIn: number;
+    idToken?: string;
+    refreshToken: string;
+    scope?: string;
+    tokenType: 'Bearer';
+}
+declare class CustomerOAuth {
+    private readonly clientId;
+    private readonly issuer;
+    private readonly timeout;
+    constructor(config: CustomerOAuthConfig);
+    createAuthorizationUrl(input: CustomerAuthorizationUrlInput): Promise<CustomerAuthorizationUrlResult>;
+    parseCallback(callbackUrl: string, options: {
+        expectedState: string;
+    }): CustomerOAuthCallbackResult;
+    exchangeCode(input: {
+        code: string;
+        codeVerifier: string;
+        redirectUri: string;
+    }): Promise<CustomerOAuthTokenSet>;
+    refresh(input: {
+        refreshToken: string;
+    }): Promise<CustomerOAuthTokenSet>;
+    logout(input: {
+        postLogoutRedirectUri?: string;
+        refreshToken?: string;
+    }): Promise<{
+        redirectUrl?: string;
+        success: boolean;
+    }>;
+    verifyIdToken(): never;
+    private tokenRequest;
+}
+
 interface CustomerAuthResponse {
     token: string;
+    refreshToken?: string;
     customer: CustomerProfile;
 }
+type MarketingConsentState = 'not_subscribed' | 'pending' | 'subscribed' | 'unsubscribed';
+type MarketingOptInLevel = 'single_opt_in' | 'confirmed_opt_in' | 'unknown';
 interface MarketingConsentChannel {
+    state?: MarketingConsentState | null;
+    optInLevel?: MarketingOptInLevel | null;
+    source?: string | null;
+    reason?: string | null;
+    consentedAt?: string | null;
+    consentUpdatedAt?: string | null;
+    expiresAt?: string | null;
+    unsubscribedAt?: string | null;
+    /** Backward-compatible write input; responses use `state`. */
     isConsented?: boolean;
 }
 interface MarketingConsent {
     email?: MarketingConsentChannel;
     sms?: MarketingConsentChannel;
     push?: MarketingConsentChannel;
-    consentSource?: string;
 }
 interface CustomerProfile {
     id: string;
@@ -881,6 +1005,7 @@ interface CustomerLoginData {
 }
 interface CustomerRefreshResponse {
     token: string;
+    refreshToken?: string;
 }
 interface UpdateProfileData {
     name?: string;
@@ -900,20 +1025,24 @@ interface CustomerAuthOptions {
     persist?: boolean | string;
     /** Initial token (e.g. from SSR cookie) */
     token?: string;
+    /** Initial refresh token, stored separately from the access token */
+    refreshToken?: string;
     /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
     onTokenChange?: (token: string | null) => void;
+    /** Called when refresh token changes (login/refresh/logout) */
+    onRefreshTokenChange?: (refreshToken: string | null) => void;
+    /** Optional hosted OAuth helper configuration */
+    oauth?: CustomerOAuthConfig;
 }
 
 type CustomerOrderListOptions = {
     page?: number;
     limit?: number;
-    displayFinancialStatus?: string;
-    displayFulfillmentStatus?: string;
-    returnStatus?: string;
-    primaryDisplayStatus?: string;
-    returnDisplayStatus?: string;
-    /** @deprecated Read-only compatibility alias filter. Prefer independent status axes. */
-    status?: string;
+    financialStatus?: PublicOrder['financialStatus'];
+    fulfillmentStatus?: PublicOrder['fulfillmentStatus'];
+    returnStatus?: PublicOrder['returnStatus'];
+    confirmationStatus?: PublicOrder['confirmationStatus'];
+    primaryDisplayStatus?: PublicOrder['primaryDisplayStatus'];
 };
 /**
  * Customer authentication client.
@@ -925,7 +1054,9 @@ declare class CustomerAuth {
     private publishableKey;
     private baseUrl;
     private token;
+    private refreshTokenValue;
     private onTokenChange?;
+    private onRefreshTokenChange?;
     private refreshPromise;
     constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
     /**
@@ -937,7 +1068,8 @@ declare class CustomerAuth {
      */
     login(data: CustomerLoginData): Promise<CustomerAuthResponse>;
     /**
-     * Refresh the current token. Requires a valid (non-expired) token.
+     * Refresh the current token. Uses a refresh token when available, otherwise
+     * falls back to the legacy bearer-token compatibility path.
      */
     refreshToken(): Promise<CustomerRefreshResponse>;
     private _doRefreshToken;
@@ -973,10 +1105,18 @@ declare class CustomerAuth {
      * Get the current token (or null if not authenticated)
      */
     getToken(): string | null;
+    /**
+     * Get the current refresh token (or null if unavailable)
+     */
+    getRefreshToken(): string | null;
     /**
      * Set the token manually (e.g. from SSR)
      */
     setToken(token: string | null): void;
+    /**
+     * Set the refresh token manually (e.g. from SSR cookie)
+     */
+    setRefreshToken(refreshToken: string | null): void;
     /**
      * Check if the customer is currently authenticated
      */
@@ -988,158 +1128,6 @@ declare class CustomerAuth {
     private requestJson;
 }
 
-interface CartApiOptions {
-    publishableKey?: string;
-    secretKey?: string;
-    apiUrl?: string;
-    customerToken?: string | (() => string | null);
-    onUnauthorized?: () => Promise<string | null>;
-    onRequestId?: (id: string | null) => void;
-}
-type CreateCartParams = Record<string, never>;
-type AddItemParams = {
-    cartToken: string;
-    product: string;
-    variant: string;
-    option?: string;
-    quantity: number;
-};
-type UpdateItemParams = {
-    cartToken: string;
-    cartItemId: string;
-    quantity: number;
-};
-type RemoveItemParams = {
-    cartToken: string;
-    cartItemId: string;
-};
-type ApplyDiscountParams = {
-    cartToken: string;
-    discountCode: string;
-};
-type RemoveDiscountParams = {
-    cartToken: string;
-};
-type ClearCartParams = {
-    cartToken: string;
-};
-type CartMergeParams = {
-    guestCartToken: string;
-};
-type PublicCartReference = string | {
-    id?: string | number | null;
-    title?: string | null;
-    name?: string | null;
-    slug?: string | null;
-    displayName?: string | null;
-    handle?: string | null;
-    color?: string | null;
-    image?: PublicMediaAsset | null;
-    thumbnail?: PublicMediaAsset | null;
-    avatar?: PublicMediaAsset | null;
-};
-type PublicCartItem = {
-    id?: string | number;
-    product?: PublicCartReference;
-    variant?: PublicCartReference;
-    quantity?: number | null;
-    unitPrice?: number | null;
-    discountAllocation?: number | null;
-    discountedUnitPrice?: number | null;
-    discountedTotalPrice?: number | null;
-    requiresShipping?: boolean | null;
-    createdAt?: string | null;
-    updatedAt?: string | null;
-};
-type PublicCart = {
-    id?: string | number;
-    status?: string | null;
-    currency?: string | null;
-    subtotalAmount?: number | null;
-    shippingAmount?: number | null;
-    discountAmount?: number | null;
-    totalAmount?: number | null;
-    discountCode?: string | null;
-    customerNote?: string | null;
-    lastActivityAt?: string | null;
-    expiresAt?: string | null;
-    createdAt?: string | null;
-    updatedAt?: string | null;
-    shippingAddress?: {
-        recipientName?: string | null;
-        phone?: string | null;
-        postalCode?: string | null;
-        address?: string | null;
-        detailAddress?: string | null;
-        deliveryMessage?: string | null;
-        address1?: string | null;
-        address2?: string | null;
-        jibunAddress?: string | null;
-        administrativeArea?: string | null;
-        city?: string | null;
-        province?: string | null;
-        country?: string | null;
-        deliveryMemo?: string | null;
-    };
-    items?: PublicCartItem[];
-};
-/**
- * Create response: the only place the server returns the `cartToken`. Persist
- * it (cookie/storage) and pass it as the handle on every later cart call.
- */
-type CreatedCart = PublicCart & {
-    cartToken?: string;
-};
-type CartMergeResult = {
-    cart: PublicCart;
-    merged: boolean;
-    claimed: boolean;
-    guestCartId: string | number;
-    customerCartId: string | number;
-    /**
-     * The resolved customer cart's capability handle. Persist it after a merge so
-     * the storefront can keep operating the cart when a union moved lines into a
-     * different cart row. `null` only if the resolved cart has no token.
-     */
-    cartToken: string | null;
-};
-/**
- * The authenticated customer's active cart resolved by JWT. `cartToken` is the
- * capability handle returned to the owner; persist it for later token-keyed
- * mutations. Both fields are `null` when the customer has no active cart.
- */
-type CartMineResult = {
-    cart: PublicCart | null;
-    cartToken: string | null;
-};
-declare class CartApi extends CustomerScopedApi {
-    constructor(options: CartApiOptions);
-    private execute;
-    /**
-     * Create a cart and receive its `cartToken`. Store the token and pass it to
-     * every subsequent cart operation.
-     */
-    createCart(params?: CreateCartParams): Promise<CreatedCart>;
-    getCart(cartToken: string): Promise<PublicCart>;
-    merge(params: CartMergeParams): Promise<CartMergeResult>;
-    /**
-     * Resolve the authenticated customer's active cart by JWT (no `cartToken`
-     * required). Returns the cart and its capability handle, or both `null` when
-     * the customer has no active cart. Requires a customer token.
-     */
-    mine(): Promise<CartMineResult>;
-    addItem(params: AddItemParams): Promise<PublicCartItem>;
-    updateItem(params: UpdateItemParams): Promise<PublicCartItem>;
-    removeItem(params: RemoveItemParams): Promise<{
-        success: boolean;
-    }>;
-    applyDiscount(params: ApplyDiscountParams): Promise<PublicCart>;
-    removeDiscount(params: RemoveDiscountParams): Promise<PublicCart>;
-    clearCart(params: ClearCartParams): Promise<{
-        success: boolean;
-    }>;
-}
-
 type NormalizedOptionSwatch<TMedia = unknown> = {
     type: 'color' | 'media' | null;
     color?: string | null;
@@ -1152,7 +1140,7 @@ type ProductSelectionMediaSource = 'variant_media_selected' | 'variant_media_mat
 type ProductDisplayMediaSource = 'featured_image' | 'product_pool' | 'none';
 /** @deprecated Use {@link ProductSelectionMediaSource} or {@link ProductDisplayMediaSource}. */
 type ProductMediaResolutionSource = ProductSelectionMediaSource | ProductDisplayMediaSource;
-type ProductSelectionVariant<TMedia> = {
+type ProductSelectionVariant$1<TMedia> = {
     id?: string | number | null;
     images?: Array<TMedia | string | number | null | undefined> | null;
 };
@@ -1165,8 +1153,8 @@ type ProductSelectionMediaPointer = string | number | {
 } | null;
 type ResolveProductSelectionMediaInput<TMedia> = {
     productMediaPool?: TMedia[] | null;
-    selectedVariant?: ProductSelectionVariant<TMedia> | null;
-    matchingVariants?: Array<ProductSelectionVariant<TMedia> | null | undefined> | null;
+    selectedVariant?: ProductSelectionVariant$1<TMedia> | null;
+    matchingVariants?: Array<ProductSelectionVariant$1<TMedia> | null | undefined> | null;
     selectedOptionValues?: Array<ProductSelectionOptionValue | null | undefined> | null;
 };
 type ResolveProductSelectionMediaResult<TMedia> = {
@@ -1193,6 +1181,9 @@ type FeaturedImagePointerInput<TMedia> = {
 };
 declare function resolveFeaturedImagePointer<TMedia>(input: FeaturedImagePointerInput<TMedia>): string | null;
 
+type ProductSelectionDetail = ProductDetail | ProductDetailCatalog;
+type ProductSelectionVariant = ProductDetailVariant | ProductDetailCatalog['variants'][number];
+type ProductSelectionVariantForDetail<TDetail extends ProductSelectionDetail> = TDetail extends ProductDetail ? ProductDetailVariant : ProductDetailCatalog['variants'][number];
 type EntityID = string;
 type RelationshipValue = string | number | null | undefined | {
     id?: string | number | null;
@@ -1229,17 +1220,26 @@ interface ProductVariantShape {
     optionValues?: unknown[] | null;
     price?: number | null;
     compareAtPrice?: number | null;
+    resolvedPrice?: {
+        amount: number;
+        compareAtPrice?: number | null;
+        currency?: string | null;
+        marketId?: string | null;
+        source?: 'fixed' | 'computed';
+    };
     stock?: number | null;
     reservedStock?: number | null;
     isUnlimited?: boolean | null;
     inventoryPolicy?: ('deny' | 'continue') | null;
     isActive?: boolean | null;
+    availableForSale?: boolean | null;
     thumbnail?: MediaValue;
     images?: MediaValue[] | null;
     _order?: string | null;
 }
 interface ProductListingProductShape {
     id?: EntityID;
+    title?: ProductLocalizedText;
     images?: MediaValue[] | null;
     featuredImage?: MediaValue;
     priceRange?: {
@@ -1339,7 +1339,7 @@ type ProductListingCardRepresentativeVariant = ProductListingCardSourceItem['gro
 type ProductListingCard = {
     id: EntityID;
     href: string;
-    title: string;
+    title: ProductLocalizedText;
     representativeVariant?: ProductListingCardRepresentativeVariant | null;
     primaryImage: ProductDetailMedia | null;
     priceRange: ProductListingCardPriceRange;
@@ -1382,10 +1382,10 @@ type ProductSelectionCodecOptions = {
     onLegacyOptionIdParam?: (event: LegacyProductSelectionParamEvent) => void;
 };
 type ProductSelectionResolutionContext = {
-    detail?: Pick<ProductDetail, 'featuredImage' | 'images' | 'selectedOrFirstAvailableVariant'>;
-    featuredImage?: ProductDetail['featuredImage'];
-    images?: ProductDetail['images'];
-    selectedOrFirstAvailableVariant?: ProductDetail['selectedOrFirstAvailableVariant'];
+    detail?: Pick<ProductSelectionDetail, 'featuredImage' | 'images' | 'selectedOrFirstAvailableVariant'>;
+    featuredImage?: ProductSelectionDetail['featuredImage'];
+    images?: ProductSelectionDetail['images'];
+    selectedOrFirstAvailableVariant?: ProductSelectionDetail['selectedOrFirstAvailableVariant'];
 };
 type ProductSelectionAvailableSwatch = {
     color?: string | null;
@@ -1404,11 +1404,11 @@ type ProductSelectionAvailableValue = {
     availableStock: number | null;
     swatch: ProductOptionValueSwatch;
 };
-type ProductSelectionResolution = {
+type ProductSelectionResolution<TVariant extends ProductVariantShape = ProductSelectionVariant> = {
     normalizedSelection: NormalizedProductSelection;
-    selectedVariant: ProductDetailVariant | null;
-    matchingVariants: ProductDetailVariant[];
-    partialVariants: ProductDetailVariant[];
+    selectedVariant: TVariant | null;
+    matchingVariants: TVariant[];
+    partialVariants: TVariant[];
     availableValuesByOptionSlug: Record<string, ProductSelectionAvailableValue[]>;
     availableValuesByOptionId: Record<string, ProductSelectionAvailableValue[]>;
     allOptionsSelected: boolean;
@@ -1440,21 +1440,21 @@ declare function buildProductOptionMatrix<TVariant extends ProductVariantShape =
     options: ProductOptionShape[];
     variants?: TVariant[];
 }): ProductOptionMatrix<TVariant>;
-declare function buildProductOptionMatrixFromDetail(detail: ProductDetail): ProductOptionMatrix<ProductDetailVariant>;
+declare function buildProductOptionMatrixFromDetail<TDetail extends ProductSelectionDetail>(detail: TDetail): ProductOptionMatrix<ProductSelectionVariantForDetail<TDetail>>;
 declare function getSelectedValueByOptionId<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): Map<string, string>;
 declare function normalizeSelectedValueIds<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): string[];
 declare function getAvailableOptionValues<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, optionId: string, selectedValueIds: Iterable<unknown>): ProductOptionMatrixValue[];
 declare function resolveVariantForSelection<TVariant extends ProductVariantShape = ProductVariantShape>(matrix: ProductOptionMatrix<TVariant>, selectedValueIds: Iterable<unknown>): ProductOptionMatrixVariant<TVariant> | undefined;
-declare function normalizeProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
-declare function normalizeProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductDetailVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
-declare function parseProductSelection(detail: ProductDetail, search: string | URLSearchParams | URL | null | undefined, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
-declare function stringifyProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): string;
-declare function createProductSelectionCodec(detail: ProductDetail, options?: ProductSelectionCodecOptions): {
+declare function normalizeProductSelection(detail: ProductSelectionDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function normalizeProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductSelectionVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function parseProductSelection(detail: ProductSelectionDetail, search: string | URLSearchParams | URL | null | undefined, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
+declare function stringifyProductSelection(detail: ProductSelectionDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): string;
+declare function createProductSelectionCodec(detail: ProductSelectionDetail, options?: ProductSelectionCodecOptions): {
     parse: (search: string | URLSearchParams | URL | null | undefined) => NormalizedProductSelection;
     stringify: (selection?: ProductSelectionInput) => string;
 };
-declare function resolveProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductDetailVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions, context?: ProductSelectionResolutionContext): ProductSelectionResolution;
-declare function resolveProductSelection(detail: ProductDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution;
+declare function resolveProductSelectionFromMatrix(matrix: ProductOptionMatrix<ProductSelectionVariant>, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions, context?: ProductSelectionResolutionContext): ProductSelectionResolution;
+declare function resolveProductSelection<TDetail extends ProductSelectionDetail>(detail: TDetail, selection?: ProductSelectionInput, options?: ProductSelectionCodecOptions): ProductSelectionResolution<ProductSelectionVariantForDetail<TDetail>>;
 declare function selectNext(detail: ProductDetail, current: ProductSelectionInput | undefined, optionSlug: string, valueSlug: string, options?: ProductSelectionCodecOptions): NormalizedProductSelection;
 type ProductDetailImageMedia = Extract<ProductDetailMedia, {
     id?: string | number | null;
@@ -1479,8 +1479,8 @@ type ProductHrefGroup = {
 };
 type ProductHrefOptions = {
     basePath?: string;
-    detail?: ProductDetail;
-    matrix?: ProductOptionMatrix<ProductDetailVariant>;
+    detail?: ProductSelectionDetail;
+    matrix?: ProductOptionMatrix<ProductSelectionVariant>;
     selection?: ProductSelectionInput;
     trailingSlash?: boolean;
     emit?: ProductSelectionUrlEmit;
@@ -1615,6 +1615,11 @@ type VariantInput = {
     externalId?: string | null;
     isActive?: boolean;
     images?: string[];
+    marketPrices?: Array<{
+        market: string;
+        price: number;
+        compareAtPrice?: number | null;
+    }>;
     metadata?: unknown;
 };
 type ProductFieldsInput = {
@@ -1636,6 +1641,7 @@ type ProductFieldsInput = {
     publishedAt?: string | null;
     categories?: string[];
     tags?: string[];
+    markets?: string[] | null;
     seo?: {
         title?: string | null;
         description?: string | null;
@@ -1684,16 +1690,31 @@ type StockCheckResponse = {
 };
 type ListingGroupsParams = {
     productIds: string[];
+    market?: string;
+    locale?: ProductLocaleOption;
+    fallbackLocale?: ProductFallbackLocaleOption;
 };
-type ProductListingGroupVariant = Pick<ProductVariantShape, 'id' | 'optionValues' | 'price' | 'compareAtPrice' | 'stock' | 'isUnlimited' | 'isActive' | 'thumbnail' | 'images' | '_order'>;
+type ProductListingGroupVariant = Pick<ProductVariantShape, 'id' | 'optionValues' | 'price' | 'compareAtPrice' | 'resolvedPrice' | 'stock' | 'isUnlimited' | 'inventoryPolicy' | 'isActive' | 'thumbnail' | 'images' | '_order'>;
 type ProductListingGroupSummary = ProductListingGroup<ProductListingGroupVariant>;
 type ProductListingGroupCatalogVariant = Omit<ProductListingGroupVariant, 'stock'>;
 type ProductListingGroupCatalogSummary = ProductListingGroup<ProductListingGroupCatalogVariant>;
 type ProductListingGroupsProductVariants = NonNullable<PublicProduct['variants']>;
-type ProductListingGroupsProduct = Omit<PublicProduct, 'createdAt' | 'updatedAt' | 'variants'> & {
+type ProductListingGroupsProductSeo = Omit<NonNullable<PublicProduct['seo']>, 'title' | 'description' | 'openGraph'> & {
+    title?: ProductLocalizedText | null;
+    description?: ProductLocalizedText | null;
+    openGraph?: Omit<NonNullable<NonNullable<PublicProduct['seo']>['openGraph']>, 'title' | 'description'> & {
+        title?: ProductLocalizedText | null;
+        description?: ProductLocalizedText | null;
+    };
+};
+type ProductListingGroupsProduct = Omit<PublicProduct, 'content' | 'createdAt' | 'description' | 'seo' | 'subtitle' | 'title' | 'updatedAt' | 'variants'> & {
     id: string;
     slug: string;
-    title: string;
+    title: ProductLocalizedText;
+    subtitle?: ProductLocalizedText | null;
+    description?: ProductLocalizedText | null;
+    content?: ProductLocalizedValue<NonNullable<PublicProduct['content']>> | null;
+    seo?: ProductListingGroupsProductSeo;
     createdAt?: PublicProduct['createdAt'];
     updatedAt?: PublicProduct['updatedAt'];
     featuredImage?: ProductDetailMedia | null;
@@ -1709,7 +1730,7 @@ type ProductListingGroupsCatalogProduct = {
     id: string;
     slug: string;
     handle?: string | null;
-    title: string;
+    title: ProductLocalizedText;
     subtitle?: ProductListingGroupsProduct['subtitle'];
     images?: ProductListingGroupsProduct['images'];
     featuredImage?: ProductDetailMedia | null;
@@ -1756,6 +1777,9 @@ type ProductListingPageFilters = {
     availableForSale?: boolean;
 };
 type ProductListingPageBaseParams = {
+    market?: string;
+    locale?: ProductLocaleOption;
+    fallbackLocale?: ProductFallbackLocaleOption;
     page?: number;
     limit?: number;
     search?: string;
@@ -1772,11 +1796,24 @@ type ProductListingPageParams = ProductListingPageCatalogParams | ProductListing
 type ProductListingPageResult<TItem> = PayloadFindResponse<TItem> & {
     cards: ProductListingCard[];
 };
-type ProductDetailParams = {
+type ProductLocaleOption = 'ko' | 'en' | 'all';
+type ProductFallbackLocaleOption = 'ko' | 'en' | false;
+type ProductLocaleReadParams = {
+    locale?: ProductLocaleOption;
+    fallbackLocale?: ProductFallbackLocaleOption;
+};
+type ProductLocalizedValue<T> = T | {
+    en?: T | null;
+    ko?: T | null;
+};
+type ProductLocalizedText = ProductLocalizedValue<string>;
+type ProductDetailParams = ({
     slug: string;
 } | {
     id: string;
-};
+}) & {
+    market?: string;
+} & ProductLocaleReadParams;
 type ProductDetailPreviewParams = {
     id: string;
 };
@@ -1809,6 +1846,13 @@ type ProductOptionValueMediaSwatch<TMedia = ProductDetailMedia> = {
 };
 type ProductOptionValueSwatch<TMedia = ProductDetailMedia> = ProductOptionValueColorSwatch | ProductOptionValueMediaSwatch<TMedia> | null;
 type ProductDetailSelectionMediaSource = 'variant_media_selected' | 'variant_media_matching' | 'option_swatch' | 'none';
+interface ResolvedCatalogPrice {
+    amount: number;
+    compareAtPrice?: number | null;
+    currency?: string | null;
+    marketId?: string | null;
+    source?: 'fixed' | 'computed';
+}
 interface ProductDetailVariant {
     id: string | number;
     optionKey: string;
@@ -1817,6 +1861,7 @@ interface ProductDetailVariant {
     sku?: string | null;
     price: number;
     compareAtPrice?: number | null;
+    resolvedPrice?: ResolvedCatalogPrice;
     stock: number;
     reservedStock: number;
     isUnlimited: boolean;
@@ -1881,7 +1926,9 @@ interface ProductMoneyRange {
 interface ProductPriceRange extends ProductMoneyRange {
     isPriceRange?: boolean | null;
 }
-type ProductDetailCatalogVariant = Omit<ProductDetailVariant, 'stock' | 'reservedStock'>;
+type ProductDetailCatalogVariant = Omit<ProductDetailVariant, 'stock' | 'reservedStock'> & {
+    availableForSale?: boolean | null;
+};
 interface ProductDetailCatalog {
     product: Omit<ProductDetail['product'], 'totalInventory'>;
     variants: ProductDetailCatalogVariant[];
@@ -1920,9 +1967,9 @@ interface ProductDetail {
     product: {
         id: string | number;
         slug: string;
-        title: string;
-        subtitle?: string | null;
-        description?: string | null;
+        title: ProductLocalizedText;
+        subtitle?: ProductLocalizedText | null;
+        description?: ProductLocalizedText | null;
         content?: unknown;
         publishedAt?: string | null;
         status: string;
@@ -1964,6 +2011,34 @@ type ProductDetailCatalogResult = {
     found: false;
     reason: ProductDetailUnavailableReason;
 };
+type ProductUpsertVariantOptionValue = string | {
+    valueSlug?: string;
+    valueId?: string;
+    value?: string;
+};
+type ProductUpsertVariantInput = {
+    id?: string;
+    optionValues?: Record<string, ProductUpsertVariantOptionValue> | string[];
+    sku?: string | null;
+    title?: string | null;
+    price: number;
+    compareAtPrice?: number | null;
+    stock?: number;
+    isUnlimited?: boolean;
+    inventoryPolicy?: 'deny' | 'continue';
+    weight?: number | null;
+    requiresShipping?: boolean;
+    barcode?: string | null;
+    externalId?: string | null;
+    isActive?: boolean;
+    images?: string[];
+    marketPrices?: Array<{
+        market: string;
+        price: number;
+        compareAtPrice?: number | null;
+    }>;
+    metadata?: unknown;
+};
 type ProductUpsertParams = ProductUpsertInput;
 /** Console `POST /api/products/upsert` field allowlist error reasons. */
 declare const PRODUCT_UPSERT_UNKNOWN_FIELD_REASON: "unknown_field";
@@ -2026,8 +2101,14 @@ type DiscountApiOptions = ServerApiOptions;
 type ValidateDiscountParams = {
     code: string;
     orderAmount: number;
+    items?: Array<{
+        product: string | number;
+        totalPrice: number;
+    }>;
+    currency?: string;
+    market?: string;
 };
-type DiscountErrorReasonCode = 'discount_code_not_found' | 'discount_not_started' | 'discount_expired' | 'discount_usage_limit' | 'discount_per_customer_limit' | 'discount_customer_required' | 'discount_first_order_only' | 'discount_customer_not_eligible' | 'discount_customer_excluded' | 'discount_items_required' | 'discount_product_not_eligible' | 'discount_product_excluded' | 'discount_min_order_amount';
+type DiscountErrorReasonCode = 'discount_code_not_found' | 'discount_not_started' | 'discount_expired' | 'discount_usage_limit' | 'discount_per_customer_limit' | 'discount_customer_required' | 'discount_first_order_only' | 'discount_customer_not_eligible' | 'discount_customer_excluded' | 'discount_items_required' | 'discount_product_not_eligible' | 'discount_product_excluded' | 'discount_min_order_amount' | 'discount_currency_scope_required' | 'discount_allocation_method_unsupported' | 'market_not_found';
 type ValidateDiscountResult = {
     valid: boolean;
     code: string;
@@ -2044,17 +2125,29 @@ declare class DiscountApi extends BaseApi {
 
 type ShippingApiOptions = ServerApiOptions;
 type CalculateShippingParams = {
-    shippingPolicyId?: string;
+    shippingPolicyId?: string | number;
     orderAmount: number;
+    countryCode?: string;
+    regionCode?: string;
     postalCode?: string;
 };
+type ShippingLine = {
+    label: string;
+    lineType: 'base' | 'surcharge' | 'insurance' | 'handling';
+    amount: number;
+    rateId?: string;
+    zoneId?: string;
+};
 type CalculateShippingResult = {
     shippingAmount: number;
     baseShippingAmount: number;
     extraShippingAmount: number;
+    shippingLines: ShippingLine[];
     freeShipping: boolean;
     freeShippingMinAmount: number | null;
+    /** Prefer shippingLines with zone-scoped rates. */
     isJeju: boolean;
+    /** Prefer shippingLines with zone-scoped rates. */
     isRemoteIsland: boolean;
 };
 declare class ShippingApi extends BaseApi {
@@ -2062,15 +2155,383 @@ declare class ShippingApi extends BaseApi {
     calculate(params: CalculateShippingParams): Promise<CalculateShippingResult>;
 }
 
+type CheckoutApiOptions = CustomerScopedApiOptions;
+type CheckoutStatus = 'open' | 'placed' | 'abandoned';
+type CustomerSnapshot = {
+    email: string;
+    name?: string;
+    phone?: string;
+};
+type CheckoutShippingAddress = {
+    recipientName: string;
+    phone: string;
+    countryCode?: string;
+    regionCode?: string;
+    postalCode: string;
+    address: string;
+    detailAddress: string;
+    deliveryMessage?: string;
+};
+type PublicCheckoutItem = {
+    id: string;
+    product: PublicCartReference;
+    variant: PublicCartReference;
+    productTitle: string;
+    variantTitle: string | null;
+    sku: string | null;
+    admissions: PublicCartItemAdmission[];
+    quantity: number;
+    unitPriceMinor: number;
+    discountMinor: number;
+    lineTotalMinor: number;
+    requiresShipping: boolean;
+};
+type CheckoutAmounts = {
+    currency: Uppercase<string>;
+    subtotalMinor: number;
+    shippingMinor: number;
+    discountMinor: number;
+    totalMinor: number;
+};
+type CheckoutPaymentSessionRef = {
+    id: string;
+    provider: 'toss';
+    providerStatus: 'requires_payment_method' | 'requires_action' | 'requires_confirmation' | 'initializing' | 'processing' | 'authorized' | 'canceling' | 'unknown' | 'captured' | 'failed' | 'canceled';
+};
+type OpenCheckoutPaymentState = {
+    activePaymentSession: CheckoutPaymentSessionRef | null;
+};
+type SpentCheckoutPaymentState = {
+    activePaymentSession: null;
+};
+type PublicCheckoutBase = {
+    id: string;
+    amounts: CheckoutAmounts;
+    items: PublicCheckoutItem[];
+    customerSnapshot: CustomerSnapshot;
+    shippingAddress: CheckoutShippingAddress | null;
+    attributes: PublicAttribute[];
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type CheckoutOrderReference = {
+    id: string;
+    orderNumber: string;
+};
+type CheckoutAbandonedReason = 'expired' | 'customer' | 'operator';
+type PublicCheckout = PublicCheckoutBase & ({
+    status: 'open';
+    paymentState: OpenCheckoutPaymentState;
+    order: null;
+    placedAt?: never;
+    placedVia?: never;
+    abandonedAt?: never;
+    abandonedReason?: never;
+} | {
+    status: 'placed';
+    placedAt: string;
+    paymentState: SpentCheckoutPaymentState;
+    order: CheckoutOrderReference;
+    placedVia?: never;
+    abandonedAt?: never;
+    abandonedReason?: never;
+} | {
+    status: 'placed';
+    placedAt: string;
+    placedVia: 'late_capture';
+    abandonedAt: string;
+    abandonedReason: CheckoutAbandonedReason;
+    paymentState: SpentCheckoutPaymentState;
+    order: CheckoutOrderReference;
+} | {
+    status: 'abandoned';
+    abandonedAt: string;
+    abandonedReason: CheckoutAbandonedReason;
+    paymentState: {
+        activePaymentSession: null;
+    };
+    order: null;
+    placedAt?: never;
+    placedVia?: never;
+});
+type ServerCheckout = PublicCheckout & {
+    clientReferenceId: string | null;
+    integrationMetadata: Record<string, string>;
+};
+type RetrieveCheckoutParams = {
+    checkoutToken: string;
+};
+type RetrieveServerCheckoutParams = {
+    checkoutId: string;
+};
+type CreateCheckoutParams = {
+    cartToken: string;
+    customer: CustomerSnapshot;
+    shippingAddress?: CheckoutShippingAddress;
+    idempotencyKey: string;
+};
+type CreateServerCheckoutParams = CreateCheckoutParams & {
+    clientReferenceId?: string;
+    integrationMetadata?: Record<string, string>;
+};
+type CreateCheckoutResult = {
+    checkout: PublicCheckout;
+    checkoutToken: string;
+};
+type CreateServerCheckoutResult = {
+    checkout: ServerCheckout;
+    checkoutToken: string;
+};
+type CheckoutQueryParams = {
+    limit?: number;
+    cursor?: string;
+    status?: CheckoutStatus[];
+    createdAtFrom?: string;
+    createdAtTo?: string;
+    clientReferenceId?: string;
+};
+type CheckoutListItem = PublicCheckout extends infer Checkout ? Checkout extends unknown ? Omit<Checkout, 'items' | 'shippingAddress' | 'attributes'> & {
+    clientReferenceId: string | null;
+} : never : never;
+type CheckoutQueryResult = {
+    data: CheckoutListItem[];
+    hasMore: boolean;
+    nextCursor: string | null;
+};
+declare class CheckoutApi extends CustomerScopedApi {
+    constructor(options: CheckoutApiOptions);
+    private post;
+    private publicCheckout;
+    private serverCheckout;
+    private createResult;
+    private createServerResult;
+    create(params: CreateCheckoutParams): Promise<CreateCheckoutResult>;
+    createServer(params: CreateServerCheckoutParams): Promise<CreateServerCheckoutResult>;
+    retrieve(params: RetrieveCheckoutParams): Promise<PublicCheckout>;
+    retrieveServer(params: RetrieveServerCheckoutParams): Promise<ServerCheckout>;
+    query(params?: CheckoutQueryParams): Promise<CheckoutQueryResult>;
+}
+
+type PaymentSessionApiOptions = CustomerScopedApiOptions;
+type Money = {
+    amountMinor: number;
+    currency: Uppercase<string>;
+};
+type CreatePaymentSessionParams = {
+    checkoutToken: string;
+    idempotencyKey: string;
+    provider: 'toss';
+    providerOptions: {
+        profile: 'widget_v2';
+    };
+};
+type RetrieveBrowserPaymentSessionParams = {
+    paymentSessionId: string;
+    checkoutToken: string;
+};
+type RetrieveServerPaymentSessionParams = {
+    paymentSessionId: string;
+};
+type CancelBrowserPaymentSessionParams = RetrieveBrowserPaymentSessionParams & {
+    idempotencyKey: string;
+};
+type CancelServerPaymentSessionParams = RetrieveServerPaymentSessionParams & {
+    idempotencyKey: string;
+};
+type ConfirmTossPaymentSessionParams = {
+    paymentSessionId: string;
+    idempotencyKey: string;
+    action: {
+        type: 'toss_authorization';
+        paymentKey: string;
+        providerOrderId: string;
+    };
+};
+type PaymentNextAction = {
+    type: 'toss_widget';
+    clientKey: string;
+    paymentMethodVariantKey: string;
+    agreementVariantKey: string;
+    providerOrderId: string;
+    providerCustomerKey: 'ANONYMOUS' | string;
+    orderName: string;
+    customerName?: string;
+    customerEmail?: string;
+};
+type PaymentSessionRole = 'active' | 'canonical_candidate' | 'canonical' | 'residual' | 'historical';
+type PaymentProviderStatus = 'requires_payment_method' | 'requires_action' | 'requires_confirmation' | 'initializing' | 'processing' | 'authorized' | 'canceling' | 'unknown' | 'captured' | 'failed' | 'canceled';
+type PaymentReconciliationReason = 'provider_outcome_unknown' | 'local_commit_ambiguous' | 'amount_mismatch' | 'currency_mismatch' | 'excess_capture_pending_order' | 'inventory_unavailable' | 'admission_unavailable' | 'excess_capture' | 'late_capture' | 'cross_checkout_duplicate';
+type PaymentFailureReason = 'payment_declined' | 'authentication_failed' | 'authorization_expired' | 'payment_method_unavailable' | 'provider_terminal_failure' | 'unknown_provider_terminal_failure';
+type PublicCaptureEvidence = {
+    amountMinor: number;
+    currency: Uppercase<string>;
+    observedAt: string;
+};
+type ReconciliationRequired<Reason extends string> = {
+    status: 'required';
+    reasons: readonly [Reason, ...Reason[]];
+};
+type PublicPaymentSessionBase = {
+    id: string;
+    money: Money;
+    expiresAt: string | null;
+    sessionRole: PaymentSessionRole;
+};
+type PublicPaymentSessionState<Action extends PaymentNextAction> = ({
+    providerStatus: 'requires_payment_method' | 'requires_action';
+    finalizationStatus: 'not_ready';
+    reconciliation: {
+        status: 'none';
+    };
+    order: null;
+} & ({
+    sessionRole: 'active';
+    presentationStatus: 'actionable';
+    nextAction: Action;
+} | {
+    sessionRole: 'residual';
+    presentationStatus: 'suppressed';
+    nextAction?: never;
+})) | {
+    providerStatus: 'requires_confirmation';
+    sessionRole: 'active' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    order: null;
+} | {
+    providerStatus: 'initializing' | 'processing' | 'authorized';
+    sessionRole: 'active' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    order: null;
+} | {
+    providerStatus: 'canceling';
+    sessionRole: 'active' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    order: null;
+} | {
+    providerStatus: 'unknown';
+    sessionRole: 'active' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    reconciliation: ReconciliationRequired<'provider_outcome_unknown'>;
+    order: null;
+} | {
+    providerStatus: 'captured';
+    sessionRole: 'canonical_candidate' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'pending';
+    nextAction?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    providerEvidence: PublicCaptureEvidence;
+    order: null;
+} | {
+    providerStatus: 'captured';
+    sessionRole: 'canonical' | 'historical';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'committed';
+    nextAction?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    providerEvidence: PublicCaptureEvidence;
+    order: {
+        id: string;
+        orderNumber: string;
+    };
+} | {
+    providerStatus: 'captured';
+    sessionRole: 'canonical_candidate' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'pending';
+    nextAction?: never;
+    reconciliation: ReconciliationRequired<'local_commit_ambiguous' | 'amount_mismatch' | 'currency_mismatch' | 'excess_capture_pending_order'>;
+    providerEvidence: PublicCaptureEvidence;
+    order: null;
+} | {
+    providerStatus: 'captured';
+    sessionRole: 'canonical' | 'residual';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'committed';
+    nextAction?: never;
+    reconciliation: ReconciliationRequired<'inventory_unavailable' | 'admission_unavailable' | 'amount_mismatch' | 'currency_mismatch' | 'excess_capture' | 'late_capture' | 'cross_checkout_duplicate'>;
+    providerEvidence: PublicCaptureEvidence;
+    order: {
+        id: string;
+        orderNumber: string;
+    };
+} | {
+    providerStatus: 'failed';
+    sessionRole: 'historical';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    providerEvidence?: never;
+    cancellationReason?: never;
+    reconciliation: {
+        status: 'none';
+    };
+    failure: {
+        reason: PaymentFailureReason;
+        message?: string;
+    };
+    order: null;
+} | {
+    providerStatus: 'canceled';
+    sessionRole: 'historical';
+    presentationStatus: 'suppressed';
+    finalizationStatus: 'not_ready';
+    nextAction?: never;
+    providerEvidence?: never;
+    failure?: never;
+    cancellationReason: 'expired' | 'customer' | 'operator' | 'provider';
+    reconciliation: {
+        status: 'none';
+    };
+    order: null;
+};
+type PublicPaymentSession = PublicPaymentSessionBase & {
+    provider: 'toss';
+} & PublicPaymentSessionState<PaymentNextAction>;
+declare class PaymentSessionApi extends CustomerScopedApi {
+    private readonly serverTransport;
+    constructor(options: PaymentSessionApiOptions);
+    private post;
+    private paymentSession;
+    create(params: CreatePaymentSessionParams): Promise<PublicPaymentSession>;
+    retrieve(params: RetrieveBrowserPaymentSessionParams | RetrieveServerPaymentSessionParams): Promise<PublicPaymentSession>;
+    cancel(params: CancelBrowserPaymentSessionParams | CancelServerPaymentSessionParams): Promise<PublicPaymentSession>;
+    confirm(params: ConfirmTossPaymentSessionParams): Promise<PublicPaymentSession>;
+}
+
 interface CommerceClientOptions {
     publishableKey: string;
     apiUrl?: string;
+    market?: string;
     customerToken: () => string | null;
     onUnauthorized?: () => Promise<string | null>;
     onRequestId?: (id: string | null) => void;
     customerAuth: CustomerAuth;
 }
 declare class CommerceClient {
+    private readonly market?;
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         stockSnapshot: (params: StockSnapshotParams) => Promise<StockSnapshotResponse>;
@@ -2079,22 +2540,18 @@ declare class CommerceClient {
         listingPage: {
             (params?: ProductListingPageCatalogParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem>>;
         };
-        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
         detailCatalog: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
     };
-    readonly cart: {
-        create: (params?: CreateCartParams) => Promise<CreatedCart>;
-        get: (cartToken: string) => Promise<PublicCart>;
-        addItem: (params: AddItemParams) => Promise<PublicCartItem>;
-        updateItem: (params: UpdateItemParams) => Promise<PublicCartItem>;
-        removeItem: (params: RemoveItemParams) => Promise<{
-            success: boolean;
-        }>;
-        applyDiscount: (params: ApplyDiscountParams) => Promise<PublicCart>;
-        removeDiscount: (params: RemoveDiscountParams) => Promise<PublicCart>;
-        clear: (params: ClearCartParams) => Promise<{
-            success: boolean;
-        }>;
+    readonly carts: {
+        create: (params?: CreateCartParams) => Promise<CreateCartResult>;
+        retrieve: (params: RetrieveCartParams) => Promise<PublicCart>;
+        addItem: (params: AddItemParams) => Promise<CartMutationResult>;
+        updateItem: (params: UpdateItemParams) => Promise<CartMutationResult>;
+        removeItem: (params: RemoveItemParams) => Promise<CartMutationResult>;
+        updateDiscountCodes: (params: UpdateDiscountCodesParams) => Promise<CartMutationResult>;
+        updateAttributes: (params: UpdateCartAttributesParams) => Promise<CartMutationResult>;
+        clear: (params: ClearCartParams) => Promise<CartMutationResult>;
         /**
          * Union/claim a pre-login guest cart into the authenticated customer's cart
          * (customer JWT required). Returns the resolved customer cart's `cartToken`
@@ -2108,9 +2565,17 @@ declare class CommerceClient {
         mine: () => Promise<CartMineResult>;
     };
     readonly orders: {
-        checkout: (params: CheckoutParams) => Promise<PublicOrder>;
         listMine: (options?: CustomerOrderListOptions) => Promise<PayloadFindResponse<PublicOrder>>;
     };
+    readonly checkouts: {
+        create: (params: CreateCheckoutParams) => Promise<CreateCheckoutResult>;
+        retrieve: (params: RetrieveCheckoutParams) => Promise<PublicCheckout>;
+    };
+    readonly paymentSessions: {
+        create: (params: CreatePaymentSessionParams) => Promise<PublicPaymentSession>;
+        retrieve: (params: RetrieveBrowserPaymentSessionParams) => Promise<PublicPaymentSession>;
+        cancel: (params: CancelBrowserPaymentSessionParams) => Promise<PublicPaymentSession>;
+    };
     readonly discounts: {
         validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
     };
@@ -2118,6 +2583,8 @@ declare class CommerceClient {
         calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
     };
     constructor(options: CommerceClientOptions);
+    getDefaultMarket(): string | undefined;
+    private withMarket;
 }
 
 type StorefrontContentReference = {
@@ -2203,9 +2670,11 @@ interface ServerCommerceClientOptions {
     publishableKey?: string;
     secretKey: string;
     apiUrl?: string;
+    market?: string;
     onRequestId?: (id: string | null) => void;
 }
 declare class ServerCommerceClient {
+    private readonly market?;
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
@@ -2215,37 +2684,24 @@ declare class ServerCommerceClient {
             (params: ProductListingPageParams): Promise<ProductListingPageResult<ProductListingGroupsCatalogItem> | ProductListingPageResult<ProductListingGroupsItem>>;
         };
         detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
+        detailCatalog: (params: ProductDetailParams) => Promise<ProductDetailCatalogResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };
-    readonly cart: {
-        create: (params?: CreateCartParams) => Promise<CreatedCart>;
-        get: (cartToken: string) => Promise<PublicCart>;
-        addItem: (params: AddItemParams) => Promise<PublicCartItem>;
-        updateItem: (params: UpdateItemParams) => Promise<PublicCartItem>;
-        removeItem: (params: RemoveItemParams) => Promise<{
-            success: boolean;
-        }>;
-        applyDiscount: (params: ApplyDiscountParams) => Promise<PublicCart>;
-        removeDiscount: (params: RemoveDiscountParams) => Promise<PublicCart>;
-        clear: (params: ClearCartParams) => Promise<{
-            success: boolean;
-        }>;
-        /**
-         * Union/claim a guest cart into a customer's cart. Customer-bound resolution
-         * requires a customer JWT; a secret-key caller has no customer session.
-         */
-        merge: (params: CartMergeParams) => Promise<CartMergeResult>;
-        /** Load the authenticated customer's active cart by JWT. */
-        mine: () => Promise<CartMineResult>;
+    readonly carts: {
+        create: (params?: CreateCartParams) => Promise<CreateCartResult>;
+        retrieve: (params: RetrieveCartParams) => Promise<PublicCart>;
+        addItem: (params: AddItemParams) => Promise<CartMutationResult>;
+        updateItem: (params: UpdateItemParams) => Promise<CartMutationResult>;
+        removeItem: (params: RemoveItemParams) => Promise<CartMutationResult>;
+        updateDiscountCodes: (params: UpdateDiscountCodesParams) => Promise<CartMutationResult>;
+        updateAttributes: (params: UpdateCartAttributesParams) => Promise<CartMutationResult>;
+        clear: (params: ClearCartParams) => Promise<CartMutationResult>;
+        merge: (params: ServerCartMergeParams) => Promise<CartMergeResult>;
+        mine: (params: ServerCartMineParams) => Promise<CartMineResult>;
     };
     readonly orders: {
-        checkout: (params: CheckoutParams) => Promise<PublicOrder>;
-        create: (params: CreateOrderParams) => Promise<Order>;
         update: (params: UpdateOrderParams) => Promise<Order>;
-        updateTransaction: (params: UpdateTransactionParams) => Promise<Transaction>;
-        confirmPayment: (params: ConfirmPaymentParams) => Promise<ConfirmPaymentResponse>;
-        confirmPaymentReturningOrder: (params: ConfirmPaymentParams) => Promise<ConfirmPaymentWithOrderResult>;
         getByPaymentId: (params: GetOrderByPaymentIdParams) => Promise<OrderByPaymentResult>;
         cancelOrder: (params: CancelOrderParams) => Promise<CancelOrderResponse>;
         resolveCancelRefund: (params: ResolveCancelRefundParams) => Promise<ResolveCancelRefundResponse>;
@@ -2260,6 +2716,17 @@ declare class ServerCommerceClient {
             transaction: Transaction | null;
         }>;
     };
+    readonly checkouts: {
+        create: (params: CreateServerCheckoutParams) => Promise<CreateServerCheckoutResult>;
+        retrieve: (params: RetrieveServerCheckoutParams) => Promise<ServerCheckout>;
+        query: (params?: CheckoutQueryParams) => Promise<CheckoutQueryResult>;
+    };
+    readonly paymentSessions: {
+        create: (params: CreatePaymentSessionParams) => Promise<PublicPaymentSession>;
+        retrieve: (params: RetrieveServerPaymentSessionParams) => Promise<PublicPaymentSession>;
+        cancel: (params: CancelServerPaymentSessionParams) => Promise<PublicPaymentSession>;
+        confirm: (params: ConfirmTossPaymentSessionParams) => Promise<PublicPaymentSession>;
+    };
     readonly discounts: {
         validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
     };
@@ -2267,6 +2734,8 @@ declare class ServerCommerceClient {
         calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
     };
     constructor(options: ServerCommerceClientOptions);
+    getDefaultMarket(): string | undefined;
+    private withMarket;
 }
 
 /**
@@ -2275,6 +2744,7 @@ declare class ServerCommerceClient {
  */
 declare class CustomerNamespace {
     readonly auth: CustomerAuth;
+    readonly oauth?: CustomerOAuth;
     constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
 }
 
@@ -2376,6 +2846,33 @@ interface EventsRangeResponse {
     hasNextPage: boolean;
     hasPrevPage: boolean;
 }
+interface EventAdmissionAvailabilityParams {
+    occurrence: string;
+}
+interface EventAdmissionPricePresentment {
+    amount: number;
+    compareAtPrice: number | null;
+    currency: string | null;
+    marketId: string | null;
+}
+interface EventAdmissionAvailabilityType {
+    id: string | number;
+    label?: string | null;
+    description?: string | null;
+    eventId: string | number;
+    occurrenceId: string | number;
+    productId: string | number | null;
+    variantId: string | number | null;
+    price: EventAdmissionPricePresentment | null;
+    remainingCapacityHint: number | null;
+    available: boolean;
+}
+interface EventAdmissionAvailabilityResponse {
+    occurrenceId: string | number;
+    eventId: string | number;
+    remainingCapacityHint: number | null;
+    admissionTypes: EventAdmissionAvailabilityType[];
+}
 interface EventRegistrationAttendeeInput {
     name?: string;
     email?: string;
@@ -2432,13 +2929,81 @@ declare class EventsClient {
     private readonly onRequestId?;
     constructor(options: EventsClientOptions);
     getRange(params: EventsRangeParams): Promise<EventsRangeResponse>;
+    getAdmissionAvailability(params: EventAdmissionAvailabilityParams): Promise<EventAdmissionAvailabilityResponse>;
     register(params: EventRegistrationRegisterParams): Promise<EventRegistrationRegisterResponse>;
     getGuestRegistration(token: string): Promise<EventGuestRegistrationResponse>;
     cancelGuestRegistration(token: string, params?: EventGuestCancelParams): Promise<EventGuestRegistrationResponse>;
     private execute;
 }
 
+/**
+ * Client-safe market discovery shape (Shopify-like). Structural copy of the
+ * private contracts package's `PublicMarketDTO` — the public SDK must not import
+ * private contracts, so a parity `test-d` keeps the two in lockstep. The
+ * `toMarketDTO` return annotation ties this shape back to the real `PublicMarket`
+ * row (which the parity test alone cannot check).
+ */
+type MarketDTO = {
+    id: string;
+    handle: string;
+    name: string;
+    countryCode: string;
+    targetCountries: string[];
+    currency: string;
+    isPrimary: boolean;
+    isActive: boolean;
+};
+/**
+ * Minimal reader the discovery helper depends on: the shape of
+ * `collections.from('markets').find`. Kept narrow so the helper is
+ * transport-agnostic and unit-testable against a mock.
+ */
+type MarketRowReader = (options: {
+    where: Where;
+    limit: number;
+}) => Promise<PayloadFindResponse<PublicMarket>>;
+interface MarketDiscoveryClient {
+    /** List the tenant's active buyer markets. */
+    list(): Promise<MarketDTO[]>;
+    /** Resolve the tenant's default (active primary) market, or `null`. */
+    default(): Promise<MarketDTO | null>;
+}
+/** Read-side helper for public market discovery. */
+declare class MarketDiscovery implements MarketDiscoveryClient {
+    private readonly read;
+    constructor(read: MarketRowReader);
+    list(): Promise<MarketDTO[]>;
+    default(): Promise<MarketDTO | null>;
+}
+
 type TenantIntrospectionApiOptions = ServerApiOptions;
+interface TenantContextInput {
+    includeCounts?: boolean;
+}
+interface TenantFieldConfigState {
+    hiddenFields: string[];
+    isHidden: boolean;
+}
+interface TenantContextResponse {
+    tenant: {
+        id: string;
+        name: string;
+        plan: string;
+        planSource?: string;
+        authoritative?: boolean;
+        capabilityVersion?: string;
+    };
+    features: string[];
+    collections: {
+        active: string[];
+        inactive: string[];
+    };
+    fieldConfigs: Record<string, TenantFieldConfigState>;
+    counts?: Record<string, number>;
+    config?: {
+        webhookConfigured: boolean;
+    };
+}
 type TenantFeatureProgressFeature = 'ecommerce';
 interface TenantFeatureProgressInput {
     feature: TenantFeatureProgressFeature;
@@ -2523,11 +3088,13 @@ interface CollectionSchemaResponse {
     };
 }
 interface TenantIntrospectionClient {
+    context: (params?: TenantContextInput) => Promise<TenantContextResponse>;
     collectionSchema: (collection: string) => Promise<CollectionSchemaResponse>;
     featureProgress: (params: TenantFeatureProgressInput) => Promise<TenantFeatureProgressResponse>;
 }
-declare class TenantIntrospectionApi extends BaseApi implements TenantIntrospectionClient {
+declare class TenantIntrospectionApi extends RawBaseApi implements TenantIntrospectionClient {
     constructor(options: TenantIntrospectionApiOptions);
+    context(params?: TenantContextInput): Promise<TenantContextResponse>;
     collectionSchema(collection: string): Promise<CollectionSchemaResponse>;
     featureProgress(params: TenantFeatureProgressInput): Promise<TenantFeatureProgressResponse>;
 }
@@ -2536,23 +3103,27 @@ declare class TenantIntrospectionApi extends BaseApi implements TenantIntrospect
  * SDK-local hand-declarations of the membership wire contract types.
  *
  * The public SDK must keep these types local because the canonical membership
- * contract package is private to the workspace. These public types are
- * structurally checked by membership contract-parity type tests.
+ * contract package is private to the workspace and must not be imported at
+ * runtime. These public types are structurally checked by membership
+ * contract-parity type tests.
  */
 type MembershipStatus = 'incomplete' | 'trialing' | 'active' | 'past_due' | 'cancelled' | 'expired';
 /**
  * Parameters for the subscribe endpoint (delegated charge model).
- * The storefront already collected the first payment; this records it and
- * activates the membership.
+ * The storefront already collected the first payment for non-trial plans; this
+ * records it and activates the membership. Trial starts omit pgPaymentId until
+ * the renewal cron sends the first delegated charge.
  */
 type SubscribeMembershipParams = {
     planId: string;
+    priceId: string;
     /** Stable client-generated key used as the deduplication key for this subscription intent. */
     subscribeIntentKey: string;
-    pgPaymentId: string;
-    amount: number;
-    currency: string;
-    customerRef?: string;
+    pgPaymentId?: string;
+    /** Internal Console customer document id. */
+    customerId: string;
+    /** Delegated payment provider customer reference. */
+    customerRef: string;
     card?: {
         last4?: string;
         brand?: string;
@@ -2564,8 +3135,9 @@ type SubscribeMembershipResponse = {
 };
 /**
  * Parameters for cancelling a membership.
- * `immediate=false` (default) sets `cancelAtPeriodEnd`; benefits persist to
- * the last paid period. `immediate=true` cancels immediately and revokes groups.
+ * Default (omit `immediate` or pass `false`) sets `cancelAtPeriodEnd`; benefits
+ * persist until the last paid period end and renewals stop. Pass
+ * `immediate=true` to cancel immediately and revoke groups now.
  */
 type CancelMembershipParams = {
     id: string;
@@ -2581,12 +3153,15 @@ type CancelMembershipResponse = {
 type CustomerMembershipView = {
     id: string;
     plan: string;
+    price: string;
     status: MembershipStatus;
     currentPeriodEnd: string;
     nextBillingAt: string | null;
     cancelAtPeriodEnd: boolean;
     amount: number;
     currency: string;
+    billingInterval: 'month' | 'year';
+    intervalCount: number;
     card?: {
         last4?: string;
         brand?: string;
@@ -2597,26 +3172,16 @@ interface ClientConfig {
     publishableKey: string;
     /** API base URL for staging, self-hosted, preview, or proxy deployments. */
     apiUrl?: string;
+    /**
+     * Default commerce market handle/id. Applied to market-aware product and cart
+     * helpers when the individual call does not provide `market`.
+     */
+    market?: string;
     /**
      * Customer authentication options.
      * Used to initialize CustomerAuth on Client.
      */
-    customer?: {
-        /**
-         * Persist token in localStorage. Defaults to `true`.
-         * - `true` (default): uses key `'customer-token'`
-         * - `string`: uses the given string as localStorage key
-         * - `false`: disables persistence (token/onTokenChange used instead)
-         *
-         * Handles SSR safely (no-op on server).
-         * When enabled, `token` and `onTokenChange` are ignored.
-         */
-        persist?: boolean | string;
-        /** Initial token (e.g. from SSR cookie) */
-        token?: string;
-        /** Called when token changes (login/logout) — use to persist in localStorage/cookie */
-        onTokenChange?: (token: string | null) => void;
-    };
+    customer?: CustomerAuthOptions;
 }
 interface ClientServerConfig extends ClientConfig {
     secretKey: string;
@@ -2656,15 +3221,23 @@ interface PayloadMutationResponse<T = unknown> {
 }
 type Sort = string | string[];
 type Where = Record<string, unknown>;
+type LocaleOption = 'en' | 'ko';
+type FallbackLocaleOption = 'en' | 'ko' | 'none' | false;
 /**
  * Do NOT replace with `Pick<FindOptions>` from `payload` or import Payload
  * types here. Payload's generic query types depend on `PayloadTypes` module
  * augmentation; external SDK consumers who only use `createClient` should not
  * install Payload just to type REST query objects. Excluded vs native:
- * Local-API-only fields, `locale`/`fallbackLocale`.
+ * Local-API-only fields.
  */
 interface ApiQueryOptions {
     page?: number;
+    /**
+     * Rows per page. With a browser publishable key, raw collection reads must
+     * request a bounded limit in [1, 100]: `limit: 0`, a `limit` above 100, and
+     * `pagination: false` are rejected (400) rather than returning an entire
+     * collection — use `page` to paginate. Server credentials are not capped.
+     */
     limit?: number;
     sort?: Sort;
     /**
@@ -2719,12 +3292,21 @@ interface ApiQueryOptions {
         where?: Where;
         count?: boolean;
     } | false> | false;
-    /** Set to `false` to skip the count query — returns docs without totalDocs/totalPages */
+    /**
+     * Set to `false` to skip the count query — returns docs without
+     * totalDocs/totalPages. With a browser publishable key this is rejected (400)
+     * on raw collection reads (pagination cannot be disabled so the row cap
+     * applies); it takes effect with server credentials.
+     */
     pagination?: boolean;
     /** Include draft versions (access control still applies on the server) */
     draft?: boolean;
     /** Include soft-deleted documents (requires `trash` enabled on the collection) */
     trash?: boolean;
+    /** Resolve localized fields for a specific locale. */
+    locale?: LocaleOption;
+    /** Fallback locale for missing localized values; set false to disable fallback. */
+    fallbackLocale?: FallbackLocaleOption;
 }
 type ApiDeleteOptions = Pick<ApiQueryOptions, 'trash'>;
 type PublicReadQueryOptions = Omit<ApiQueryOptions, 'depth' | 'joins' | 'populate'> & {
@@ -2751,7 +3333,7 @@ interface RetryConfig {
     retryableStatuses?: number[];
     retryDelay?: (attempt: number) => number;
 }
-interface RootQueryLookup<T extends string, Options extends ApiQueryOptions = ApiQueryOptions> {
+interface RootQueryLookup<T extends Collection, Options extends ApiQueryOptions = ApiQueryOptions> {
     find(options?: Options): Promise<PayloadFindResponse<CollectionType<T>>>;
     findById(id: string | number, options?: Options): Promise<CollectionType<T>>;
     count(options?: Options): Promise<{
@@ -2786,10 +3368,13 @@ interface RootClient {
     events?: EventsClient;
     customer: CustomerNamespace;
     collections: RootCollectionClient;
+    markets: MarketDiscoveryClient;
     memberships: {
         me: () => Promise<CustomerMembershipView | null>;
+        cancel: (params: CancelMembershipParams) => Promise<CancelMembershipResponse>;
     };
     lastRequestId: string | null;
+    withMarket(market: string): RootClientWithEvents;
     getState(): ClientState;
     getConfig(): ClientConfig;
 }
@@ -2799,7 +3384,6 @@ interface RootServerClient {
     memberships: {
         subscribe: (params: SubscribeMembershipParams) => Promise<SubscribeMembershipResponse>;
         cancel: (params: CancelMembershipParams) => Promise<CancelMembershipResponse>;
-        me: () => Promise<CustomerMembershipView | null>;
     };
     /** Set on {@link createServerClient} return values; optional for structural mocks. */
     events?: EventsClient;
@@ -2812,7 +3396,9 @@ interface RootServerClient {
         };
     };
     collections: RootServerCollectionClient;
+    markets: MarketDiscoveryClient;
     lastRequestId: string | null;
+    withMarket(market: string): RootServerClientWithEvents;
     getState(): ClientState;
     getConfig(): Omit<ClientServerConfig, 'secretKey'>;
 }
@@ -2827,4 +3413,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type BanCustomerParams as $, type AddItemParams as A, type RootCollectionClient as B, CommerceClient as C, type DebugConfig as D, EventsClient as E, type RootReadOnlyQueryBuilder as F, type StorefrontContentListOptions as G, type StorefrontContentReference as H, type StorefrontGalleryItem as I, type StorefrontGalleryItemsListOptions as J, type StorefrontGalleryItemsSort as K, type StorefrontLink as L, type StorefrontLinksListOptions as M, type StorefrontLinksSort as N, BaseApi as O, type PayloadFindResponse as P, type ServerApiOptions as Q, type RemoveDiscountParams as R, type Sort as S, ServerCommerceClient as T, type UpdateItemParams as U, type TenantIntrospectionClient as V, type Where as W, type SubscribeMembershipParams as X, type SubscribeMembershipResponse as Y, type CancelMembershipParams as Z, type CancelMembershipResponse as _, CommunityClient as a, type ResolveProductSelectionMediaResult as a$, type CommunityBan as a0, type UnbanCustomerParams as a1, type ClientServerConfig as a2, type RootServerClientWithEvents as a3, type CollectionFieldSchema as a4, type CollectionSchemaResponse as a5, type EventGuestCancelParams as a6, type EventGuestRegistration as a7, type EventGuestRegistrationResponse as a8, type EventRegistrationAnswerInput as a9, TenantIntrospectionApi as aA, type TenantIntrospectionApiOptions as aB, type ApiDeleteOptions as aC, type PublicReadQueryOptions as aD, CustomerAuth as aE, type CustomerProfile as aF, type CustomerAuthResponse as aG, type CustomerLoginData as aH, type CustomerRegisterResponse as aI, type CustomerRegisterData as aJ, type CustomerRefreshResponse as aK, type UpdateProfileData as aL, type ProductListingPageBaseParams as aM, type ProductListingPageParams as aN, type ProductDetailParams as aO, type ProductDetailResult as aP, type ProductListingPageCatalogParams as aQ, type ProductListingPageResult as aR, type ProductListingGroupsCatalogItem as aS, type ProductListingPageFullParams as aT, type ProductListingGroupsItem as aU, type ProductDetail as aV, type ProductDetailCatalog as aW, type StockSnapshotResponse as aX, type ProductSelectionMediaSource as aY, type ProductDisplayMediaSource as aZ, type ResolveProductSelectionMediaInput as a_, type EventRegistrationAttendeeInput as aa, type EventRegistrationPublic as ab, type EventRegistrationRegisterParams as ac, type EventRegistrationRegisterResponse as ad, type EventsCalendarItem as ae, type EventsClientOptions as af, type EventsDateParam as ag, type EventsExternalSource as ah, type EventsLocation as ai, type EventsOccurrenceLocation as aj, type EventsRangeEvent as ak, type EventsRangeOccurrence as al, type EventsRangeParams as am, type EventsRangeResponse as an, type EventsTaxonomyItem as ao, ModerationApi as ap, type RootServerClient as aq, type TenantFeatureProgressEvidenceValue as ar, type TenantFeatureProgressFeature as as, type TenantFeatureProgressGroup as at, type TenantFeatureProgressInput as au, type TenantFeatureProgressItem as av, type TenantFeatureProgressItemState as aw, type TenantFeatureProgressResponse as ax, type TenantFeatureProgressSeverity as ay, type TenantFeatureProgressStatus as az, ContentClient as b, type ProductDetailImage as b$, type ProductSelectionMediaPointer as b0, type RootClientWithEvents as b1, type BulkImportFulfillmentsParams as b2, type BulkImportFulfillmentsResponse as b3, type CalculateShippingParams as b4, type CalculateShippingResult as b5, type CancelOrderParams as b6, type CancelOrderReconciliationStatus as b7, type CancelOrderResponse as b8, type CancelReasonCode as b9, type CustomerOrderListOptions as bA, type CustomerSnapshot as bB, DiscountApi as bC, type DiscountApiOptions as bD, type DiscountErrorReasonCode as bE, type FeaturedImagePointerInput as bF, type GetOrderByPaymentIdParams as bG, type LegacyProductSelectionParamEvent as bH, type ListingGroupsParams as bI, type MediaValue as bJ, type MembershipStatus as bK, type NormalizedOptionSwatch as bL, type NormalizedProductSelection as bM, OrderApi as bN, type OrderApiOptions as bO, type OrderByPaymentResult as bP, PRODUCT_PLP_FIND_OPTIONS as bQ, PRODUCT_UPSERT_READONLY_FIELD_REASON as bR, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as bS, type PrepareFulfillmentOrderParams as bT, type PrepareFulfillmentOrderResponse as bU, ProductApi as bV, type ProductApiOptions as bW, type ProductDetailBrand as bX, type ProductDetailCatalogResult as bY, type ProductDetailCatalogVariant as bZ, type ProductDetailCategory as b_, CartApi as ba, type CartApiOptions as bb, type CartMergeParams as bc, type CartMergeResult as bd, type CartMineResult as be, type Comment as bf, type CommerceClientOptions as bg, type CommunityClientOptions as bh, type CommunityComment as bi, type CommunityCommentListSort as bj, type CommunityPost as bk, type CommunityPostCategory as bl, type CommunityPostListSort as bm, type CommunityPostTag as bn, type CommunityPublicAuthorSnapshot as bo, type CommunityPublicMediaAsset as bp, type CommunityPublicReference as bq, type CompatibilityProductSelectionParamEvent as br, type ConfirmPaymentParams as bs, type ConfirmPaymentResponse as bt, type ConfirmPaymentWithOrderResult as bu, type CreateFulfillmentParams as bv, type CreateOrderItem as bw, type CreateOrderParams as bx, type CreateReturnParams as by, type CustomerAuthOptions as bz, CustomerNamespace as c, type ReturnItem as c$, type ProductDetailImageMedia as c0, type ProductDetailMedia as c1, type ProductDetailOption as c2, type ProductDetailOptionValue as c3, type ProductDetailTag as c4, type ProductDetailUnavailableReason as c5, type ProductDetailVariant as c6, type ProductDetailVariantOptionValue as c7, type ProductDetailVideo as c8, type ProductHrefGroup as c9, type ProductOptionShape as cA, type ProductOptionValueShape as cB, type ProductOptionValueSwatch as cC, type ProductOptionValueSwatchInput as cD, type ProductPriceRange as cE, type ProductSelectionAvailableSwatch as cF, type ProductSelectionAvailableValue as cG, type ProductSelectionByOptionValue as cH, ProductSelectionCodecError as cI, type ProductSelectionCodecOptions as cJ, type ProductSelectionInput as cK, type ProductSelectionOptionValue as cL, type ProductSelectionResolution as cM, type ProductSelectionResolutionContext as cN, type ProductSelectionUrlEmit as cO, type ProductSelectionVariant as cP, type ProductUpsertFieldValidationErrorBody as cQ, type ProductUpsertFieldValidationErrorReason as cR, type ProductVariantShape as cS, type RequestOptions as cT, type ResolveCancelRefundFailedResponse as cU, type ResolveCancelRefundOutcome as cV, type ResolveCancelRefundParams as cW, type ResolveCancelRefundResponse as cX, type ResolveCancelRefundSucceededResponse as cY, type ResolveProductDisplayMediaInput as cZ, type ResolveProductDisplayMediaResult as c_, type ProductHrefOptions as ca, type ProductHrefProduct as cb, type ProductListingCard as cc, type ProductListingCardOptions as cd, type ProductListingCardPriceRange as ce, type ProductListingCardRepresentativeVariant as cf, type ProductListingGroup as cg, type ProductListingGroupCatalogSummary as ch, type ProductListingGroupCatalogVariant as ci, type ProductListingGroupProjection as cj, type ProductListingGroupSummary as ck, type ProductListingGroupVariant as cl, type ProductListingGroupsCatalogProduct as cm, type ProductListingGroupsCatalogResponse as cn, type ProductListingGroupsProduct as co, type ProductListingGroupsResponse as cp, type ProductListingPageFilters as cq, type ProductListingPageSort as cr, type ProductListingProductShape as cs, type ProductListingSwatch as ct, type ProductMediaResolutionSource as cu, type ProductMoneyRange as cv, type ProductOptionMatrix as cw, type ProductOptionMatrixOption as cx, type ProductOptionMatrixValue as cy, type ProductOptionMatrixVariant as cz, type CustomerMembershipView as d, type ReturnReason as d0, type ReturnWithRefundItem as d1, type ReturnWithRefundParams as d2, ShippingApi as d3, type ShippingApiOptions as d4, type StockCheckParams as d5, type StockCheckResponse as d6, type StockCheckResult as d7, type StockSnapshotItem as d8, type StockSnapshotParams as d9, projectProductToListingShape as dA, resolveFeaturedImagePointer as dB, resolveProductDisplayMedia as dC, resolveProductSelection as dD, resolveProductSelectionFromMatrix as dE, resolveProductSelectionMedia as dF, resolveVariantForSelection as dG, selectNext as dH, selectedSwatchMediaItemId as dI, stringifyProductSelection as dJ, toShopifyPriceRangeV2 as dK, type TransactionStatus as da, type UpdateFulfillmentParams as db, type UpdateOrderParams as dc, type UpdateReturnParams as dd, type UpdateTransactionParams as de, type ValidateDiscountParams as df, type ValidateDiscountResult as dg, type WithIdempotencyKey as dh, buildProductHref as di, buildProductListingCard as dj, buildProductListingGroupProjection as dk, buildProductListingGroupsByOption as dl, buildProductOptionMatrix as dm, buildProductOptionMatrixFromDetail as dn, createProductSelectionCodec as dp, getAvailableOptionValues as dq, getProductSelectionImages as dr, getSelectedValueByOptionId as ds, getVariantAvailableForSale as dt, getVariantAvailableStock as du, isProductUpsertFieldValidationErrorBody as dv, normalizeProductSelection as dw, normalizeProductSelectionFromMatrix as dx, normalizeSelectedValueIds as dy, parseProductSelection as dz, type ClientState as e, type ClientConfig as f, type ApiQueryOptions as g, type ApplyDiscountParams as h, type CheckoutParams as i, type ClearCartParams as j, type ClientMetadata as k, type ContentClientOptions as l, type DeepPartial as m, type ExtractArrayType as n, type PayloadMutationResponse as o, type PublicCart as p, type PublicCartItem as q, type PublicCartReference as r, type PublicMediaAsset as s, type PublicMediaSize as t, type PublicOrder as u, type PublicOrderItem as v, type PublicOrderReference as w, type RemoveItemParams as x, type RetryConfig as y, type RootClient as z };
+export { type PublicCartItemAdmission as $, type AddItemParams as A, type CreatePaymentSessionParams as B, CommerceClient as C, type CustomerSnapshot as D, EventsClient as E, type DebugConfig as F, type DeepPartial as G, type ExtractArrayType as H, type MembershipStatus as I, type Money as J, type PayloadMutationResponse as K, type PaymentFailureReason as L, MarketDiscovery as M, type PaymentNextAction as N, type OpenCheckoutPaymentState as O, type PayloadFindResponse as P, type PaymentProviderStatus as Q, type PaymentReconciliationReason as R, type PaymentSessionRole as S, type ProductUpsertInput as T, type ProductUpsertParams as U, type ProductUpsertResponse as V, type ProductUpsertVariantInput as W, type PublicAttribute as X, type PublicCaptureEvidence as Y, type PublicCart as Z, type PublicCartItem as _, CommunityClient as a, type EventAdmissionAvailabilityType as a$, type PublicCartMarket as a0, type PublicCartReference as a1, type PublicCheckout as a2, type PublicCheckoutItem as a3, type PublicMediaAsset as a4, type PublicMediaSize as a5, type PublicOrder as a6, type PublicOrderAmounts as a7, type PublicOrderItem as a8, type PublicOrderReference as a9, RawBaseApi as aA, type ServerApiOptions as aB, ServerCommerceClient as aC, type TenantIntrospectionClient as aD, type SubscribeMembershipParams as aE, type SubscribeMembershipResponse as aF, type BanCustomerParams as aG, type CommunityBan as aH, type UnbanCustomerParams as aI, type ClientServerConfig as aJ, type RootServerClientWithEvents as aK, type CancelServerPaymentSessionParams as aL, CartApi as aM, type CartApiOptions as aN, CheckoutApi as aO, type CheckoutApiOptions as aP, type CheckoutListItem as aQ, type CheckoutQueryParams as aR, type CheckoutQueryResult as aS, type CheckoutStatus as aT, type CollectionFieldSchema as aU, type CollectionSchemaResponse as aV, type ConfirmTossPaymentSessionParams as aW, type CreateServerCheckoutParams as aX, type CreateServerCheckoutResult as aY, type EventAdmissionAvailabilityParams as aZ, type EventAdmissionAvailabilityResponse as a_, type PublicPaymentSession as aa, type ReconciliationRequired as ab, type RemoveItemParams as ac, type RetrieveBrowserPaymentSessionParams as ad, type RetrieveCartParams as ae, type RetrieveCheckoutParams as af, type RetryConfig as ag, type RootClient as ah, type RootCollectionClient as ai, type RootReadOnlyQueryBuilder as aj, type ShippingLine as ak, type Sort as al, type SpentCheckoutPaymentState as am, type StorefrontContentListOptions as an, type StorefrontContentReference as ao, type StorefrontGalleryItem as ap, type StorefrontGalleryItemsListOptions as aq, type StorefrontGalleryItemsSort as ar, type StorefrontLink as as, type StorefrontLinksListOptions as at, type StorefrontLinksSort as au, type UpdateCartAttributesParams as av, type UpdateDiscountCodesParams as aw, type UpdateItemParams as ax, type VariantInput as ay, type Where as az, ContentClient as b, type ProductDetail as b$, type EventAdmissionPricePresentment as b0, type EventGuestCancelParams as b1, type EventGuestRegistration as b2, type EventGuestRegistrationResponse as b3, type EventRegistrationAnswerInput as b4, type EventRegistrationAttendeeInput as b5, type EventRegistrationPublic as b6, type EventRegistrationRegisterParams as b7, type EventRegistrationRegisterResponse as b8, type EventsCalendarItem as b9, type TenantFeatureProgressItemState as bA, type TenantFeatureProgressResponse as bB, type TenantFeatureProgressSeverity as bC, type TenantFeatureProgressStatus as bD, type TenantFieldConfigState as bE, TenantIntrospectionApi as bF, type TenantIntrospectionApiOptions as bG, type ApiDeleteOptions as bH, type PublicReadQueryOptions as bI, CustomerAuth as bJ, type CustomerProfile as bK, type CustomerAuthResponse as bL, type CustomerLoginData as bM, type CustomerRegisterResponse as bN, type CustomerRegisterData as bO, type CustomerRefreshResponse as bP, type UpdateProfileData as bQ, type ProductListingPageParams as bR, type ProductListingPageBaseParams as bS, type ProductDetailParams as bT, type ProductDetailCatalogResult as bU, type ProductListingPageCatalogParams as bV, type ProductListingPageResult as bW, type ProductListingGroupsCatalogItem as bX, type ProductListingPageFullParams as bY, type ProductListingGroupsItem as bZ, BaseApi as b_, type EventsClientOptions as ba, type EventsDateParam as bb, type EventsExternalSource as bc, type EventsLocation as bd, type EventsOccurrenceLocation as be, type EventsRangeEvent as bf, type EventsRangeOccurrence as bg, type EventsRangeParams as bh, type EventsRangeResponse as bi, type EventsTaxonomyItem as bj, ModerationApi as bk, PaymentSessionApi as bl, type PaymentSessionApiOptions as bm, type RetrieveServerCheckoutParams as bn, type RetrieveServerPaymentSessionParams as bo, type RootServerClient as bp, type ServerCartMergeParams as bq, type ServerCartMineParams as br, type ServerCheckout as bs, type TenantContextInput as bt, type TenantContextResponse as bu, type TenantFeatureProgressEvidenceValue as bv, type TenantFeatureProgressFeature as bw, type TenantFeatureProgressGroup as bx, type TenantFeatureProgressInput as by, type TenantFeatureProgressItem as bz, CustomerNamespace as c, type ProductDetailBrand as c$, type ProductDetailCatalog as c0, type StockSnapshotResponse as c1, type ProductSelectionMediaSource as c2, type ProductDisplayMediaSource as c3, type ResolveProductSelectionMediaInput as c4, type ResolveProductSelectionMediaResult as c5, type ProductSelectionMediaPointer as c6, type RootClientWithEvents as c7, type BulkImportFulfillmentsParams as c8, type BulkImportFulfillmentsResponse as c9, CustomerOAuth as cA, type CustomerOAuthCallbackResult as cB, type CustomerOAuthConfig as cC, type CustomerOAuthTokenSet as cD, type CustomerOrderListOptions as cE, DiscountApi as cF, type DiscountApiOptions as cG, type DiscountErrorReasonCode as cH, type FeaturedImagePointerInput as cI, type GetOrderByPaymentIdParams as cJ, type LegacyProductSelectionParamEvent as cK, type ListingGroupsParams as cL, MAX_CART_LINE_ADMISSIONS as cM, type MarketDTO as cN, type MediaValue as cO, type NormalizedOptionSwatch as cP, type NormalizedProductSelection as cQ, OrderApi as cR, type OrderApiOptions as cS, type OrderByPaymentResult as cT, PRODUCT_PLP_FIND_OPTIONS as cU, PRODUCT_UPSERT_READONLY_FIELD_REASON as cV, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as cW, type PrepareFulfillmentOrderParams as cX, type PrepareFulfillmentOrderResponse as cY, ProductApi as cZ, type ProductApiOptions as c_, type CalculateShippingParams as ca, type CalculateShippingResult as cb, type CancelOrderParams as cc, type CancelOrderResponse as cd, type CancelReasonCode as ce, type CartDiscountCode as cf, type CartWarning as cg, type CartWarningCode as ch, type Comment as ci, type CommerceClientOptions as cj, type CommunityClientOptions as ck, type CommunityComment as cl, type CommunityCommentListSort as cm, type CommunityPost as cn, type CommunityPostCategory as co, type CommunityPostListSort as cp, type CommunityPostTag as cq, type CommunityPublicAuthorSnapshot as cr, type CommunityPublicMediaAsset as cs, type CommunityPublicReference as ct, type CompatibilityProductSelectionParamEvent as cu, type CreateFulfillmentParams as cv, type CreateReturnParams as cw, type CustomerAuthOptions as cx, type CustomerAuthorizationUrlInput as cy, type CustomerAuthorizationUrlResult as cz, type CustomerMembershipView as d, type ProductUpsertFieldValidationErrorReason as d$, type ProductDetailCatalogVariant as d0, type ProductDetailCategory as d1, type ProductDetailImage as d2, type ProductDetailImageMedia as d3, type ProductDetailMedia as d4, type ProductDetailOption as d5, type ProductDetailOptionValue as d6, type ProductDetailResult as d7, type ProductDetailTag as d8, type ProductDetailUnavailableReason as d9, type ProductLocaleOption as dA, type ProductLocaleReadParams as dB, type ProductLocalizedText as dC, type ProductLocalizedValue as dD, type ProductMediaResolutionSource as dE, type ProductMoneyRange as dF, type ProductOptionMatrix as dG, type ProductOptionMatrixOption as dH, type ProductOptionMatrixValue as dI, type ProductOptionMatrixVariant as dJ, type ProductOptionShape as dK, type ProductOptionValueShape as dL, type ProductOptionValueSwatch as dM, type ProductOptionValueSwatchInput as dN, type ProductPriceRange as dO, type ProductSelectionAvailableSwatch as dP, type ProductSelectionAvailableValue as dQ, type ProductSelectionByOptionValue as dR, ProductSelectionCodecError as dS, type ProductSelectionCodecOptions as dT, type ProductSelectionInput as dU, type ProductSelectionOptionValue as dV, type ProductSelectionResolution as dW, type ProductSelectionResolutionContext as dX, type ProductSelectionUrlEmit as dY, type ProductSelectionVariant$1 as dZ, type ProductUpsertFieldValidationErrorBody as d_, type ProductDetailVariant as da, type ProductDetailVariantOptionValue as db, type ProductDetailVideo as dc, type ProductFallbackLocaleOption as dd, type ProductHrefGroup as de, type ProductHrefOptions as df, type ProductHrefProduct as dg, type ProductListingCard as dh, type ProductListingCardOptions as di, type ProductListingCardPriceRange as dj, type ProductListingCardRepresentativeVariant as dk, type ProductListingGroup as dl, type ProductListingGroupCatalogSummary as dm, type ProductListingGroupCatalogVariant as dn, type ProductListingGroupProjection as dp, type ProductListingGroupSummary as dq, type ProductListingGroupVariant as dr, type ProductListingGroupsCatalogProduct as ds, type ProductListingGroupsCatalogResponse as dt, type ProductListingGroupsProduct as du, type ProductListingGroupsResponse as dv, type ProductListingPageFilters as dw, type ProductListingPageSort as dx, type ProductListingProductShape as dy, type ProductListingSwatch as dz, type CancelMembershipParams as e, type ProductVariantShape as e0, type PublicCheckoutBase as e1, type RequestOptions as e2, type ResolveCancelRefundFailedResponse as e3, type ResolveCancelRefundOutcome as e4, type ResolveCancelRefundParams as e5, type ResolveCancelRefundResponse as e6, type ResolveCancelRefundSucceededResponse as e7, type ResolveProductDisplayMediaInput as e8, type ResolveProductDisplayMediaResult as e9, getAvailableOptionValues as eA, getProductSelectionImages as eB, getSelectedValueByOptionId as eC, getVariantAvailableForSale as eD, getVariantAvailableStock as eE, isProductUpsertFieldValidationErrorBody as eF, normalizeProductSelection as eG, normalizeProductSelectionFromMatrix as eH, normalizeSelectedValueIds as eI, parseProductSelection as eJ, projectProductToListingShape as eK, resolveFeaturedImagePointer as eL, resolveProductDisplayMedia as eM, resolveProductSelection as eN, resolveProductSelectionFromMatrix as eO, resolveProductSelectionMedia as eP, resolveVariantForSelection as eQ, selectNext as eR, selectedSwatchMediaItemId as eS, stringifyProductSelection as eT, toShopifyPriceRangeV2 as eU, type ResolvedCatalogPrice as ea, type ReturnCancellationReasonCode as eb, type ReturnItem as ec, type ReturnReason as ed, type ReturnWithRefundItem as ee, type ReturnWithRefundParams as ef, ShippingApi as eg, type ShippingApiOptions as eh, type StockCheckParams as ei, type StockCheckResponse as ej, type StockCheckResult as ek, type StockSnapshotItem as el, type StockSnapshotParams as em, type UpdateFulfillmentParams as en, type UpdateOrderParams as eo, type UpdateReturnParams as ep, type ValidateDiscountParams as eq, type ValidateDiscountResult as er, type WithIdempotencyKey as es, buildProductHref as et, buildProductListingCard as eu, buildProductListingGroupProjection as ev, buildProductListingGroupsByOption as ew, buildProductOptionMatrix as ex, buildProductOptionMatrixFromDetail as ey, createProductSelectionCodec as ez, type CancelMembershipResponse as f, type ClientState as g, type ClientConfig as h, type ApiQueryOptions as i, type CancelBrowserPaymentSessionParams as j, type CartMergeParams as k, type CartMergeResult as l, type CartMineResult as m, type CartMutationResult as n, type CheckoutAbandonedReason as o, type CheckoutAmounts as p, type CheckoutOrderReference as q, type CheckoutPaymentSessionRef as r, type CheckoutShippingAddress as s, type ClearCartParams as t, type ClientMetadata as u, type ContentClientOptions as v, type CreateCartParams as w, type CreateCartResult as x, type CreateCheckoutParams as y, type CreateCheckoutResult as z };