@01.software/sdk 0.44.0 → 0.46.0

package/dist/{types-CDND3hzq.d.cts → types-C60vHIkY.d.ts}

@@ -1,6 +1,34 @@
-import { P as PublicCollection, S as ServerCollection } from './const-1vleZ6ov.cjs';
-import { C as CollectionType, P as PublicProduct } from './types-SoXsbKhj.cjs';
-import { O as Order, m as Transaction, n as Fulfillment, R as Return } from './payload-types-CDsuOEfM.cjs';
+import { P as PublicCollection, C as Collection, S as ServerCollection } from './const-CaPq2AE4.js';
+import { C as CollectionType, a as PublicProduct, P as PublicMarket } from './types-BC6rVmJa.js';
+import { O as Order, k as Transaction, l as Fulfillment, R as Return } from './payload-types-CJZuXcgF.js';
+
+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,418 @@ 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 CreateCustomPaymentSessionParams = {
+    provider: string;
+    checkoutToken: string;
+    idempotencyKey: string;
+};
+type CustomPaymentSession = {
+    id: string;
+    provider: string;
+    providerSessionId: string;
+    money: Money;
+};
+type ConfirmCustomPaymentSessionParams = {
+    provider: string;
+    providerSessionId: string;
+    providerPaymentId: string;
+    providerEventId: string;
+    /** Captured amount in the currency's minor unit. */
+    amount: number;
+    currency: string;
+    occurredAt: string;
+};
+type ConfirmCustomPaymentSessionResponse = {
+    orderId: string;
+    transactionId: string;
+    status: 'paid';
+    alreadyConfirmed?: boolean;
+};
+type CustomPaymentSessionProof = {
+    timestamp: string;
+    signature: string;
+};
+type ConfirmCustomPaymentSessionOptions = {
+    /** Receives the exact JSON bytes the SDK will send. Required only where the Console custom-provider policy requires HMAC. */
+    createProof?: (rawBody: string) => CustomPaymentSessionProof | Promise<CustomPaymentSessionProof>;
+};
+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 +2575,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 +2600,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 +2618,8 @@ declare class CommerceClient {
         calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
     };
     constructor(options: CommerceClientOptions);
+    getDefaultMarket(): string | undefined;
+    private withMarket;
 }
 
 type StorefrontContentReference = {
@@ -2203,9 +2705,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 +2719,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 +2751,21 @@ 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>;
+        custom: {
+            create: (params: CreateCustomPaymentSessionParams) => Promise<CustomPaymentSession>;
+            confirm: (params: ConfirmCustomPaymentSessionParams, options?: ConfirmCustomPaymentSessionOptions) => Promise<ConfirmCustomPaymentSessionResponse>;
+        };
+    };
     readonly discounts: {
         validate: (params: ValidateDiscountParams) => Promise<ValidateDiscountResult>;
     };
@@ -2267,6 +2773,8 @@ declare class ServerCommerceClient {
         calculate: (params: CalculateShippingParams) => Promise<CalculateShippingResult>;
     };
     constructor(options: ServerCommerceClientOptions);
+    getDefaultMarket(): string | undefined;
+    private withMarket;
 }
 
 /**
@@ -2275,6 +2783,7 @@ declare class ServerCommerceClient {
  */
 declare class CustomerNamespace {
     readonly auth: CustomerAuth;
+    readonly oauth?: CustomerOAuth;
     constructor(publishableKey: string, options?: CustomerAuthOptions, apiUrl?: string);
 }
 
@@ -2376,6 +2885,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 +2968,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 +3127,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 +3142,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 +3174,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 +3192,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 +3211,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 +3260,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 +3331,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 +3372,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 +3407,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 +3423,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 +3435,9 @@ interface RootServerClient {
         };
     };
     collections: RootServerCollectionClient;
+    markets: MarketDiscoveryClient;
     lastRequestId: string | null;
+    withMarket(market: string): RootServerClientWithEvents;
     getState(): ClientState;
     getConfig(): Omit<ClientServerConfig, 'secretKey'>;
 }
@@ -2827,4 +3452,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 CreateServerCheckoutParams 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 ConfirmCustomPaymentSessionOptions as aW, type ConfirmCustomPaymentSessionParams as aX, type ConfirmCustomPaymentSessionResponse as aY, type ConfirmTossPaymentSessionParams as aZ, type CreateCustomPaymentSessionParams 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 ProductListingPageCatalogParams as b$, type CreateServerCheckoutResult as b0, type CustomPaymentSession as b1, type CustomPaymentSessionProof as b2, type EventAdmissionAvailabilityParams as b3, type EventAdmissionAvailabilityResponse as b4, type EventAdmissionAvailabilityType as b5, type EventAdmissionPricePresentment as b6, type EventGuestCancelParams as b7, type EventGuestRegistration as b8, type EventGuestRegistrationResponse as b9, type TenantContextResponse as bA, type TenantFeatureProgressEvidenceValue as bB, type TenantFeatureProgressFeature as bC, type TenantFeatureProgressGroup as bD, type TenantFeatureProgressInput as bE, type TenantFeatureProgressItem as bF, type TenantFeatureProgressItemState as bG, type TenantFeatureProgressResponse as bH, type TenantFeatureProgressSeverity as bI, type TenantFeatureProgressStatus as bJ, type TenantFieldConfigState as bK, TenantIntrospectionApi as bL, type TenantIntrospectionApiOptions as bM, type ApiDeleteOptions as bN, type PublicReadQueryOptions as bO, CustomerAuth as bP, type CustomerProfile as bQ, type CustomerAuthResponse as bR, type CustomerLoginData as bS, type CustomerRegisterResponse as bT, type CustomerRegisterData as bU, type CustomerRefreshResponse as bV, type UpdateProfileData as bW, type ProductListingPageParams as bX, type ProductListingPageBaseParams as bY, type ProductDetailParams as bZ, type ProductDetailCatalogResult as b_, type EventRegistrationAnswerInput as ba, type EventRegistrationAttendeeInput as bb, type EventRegistrationPublic as bc, type EventRegistrationRegisterParams as bd, type EventRegistrationRegisterResponse as be, type EventsCalendarItem as bf, type EventsClientOptions as bg, type EventsDateParam as bh, type EventsExternalSource as bi, type EventsLocation as bj, type EventsOccurrenceLocation as bk, type EventsRangeEvent as bl, type EventsRangeOccurrence as bm, type EventsRangeParams as bn, type EventsRangeResponse as bo, type EventsTaxonomyItem as bp, ModerationApi as bq, PaymentSessionApi as br, type PaymentSessionApiOptions as bs, type RetrieveServerCheckoutParams as bt, type RetrieveServerPaymentSessionParams as bu, type RootServerClient as bv, type ServerCartMergeParams as bw, type ServerCartMineParams as bx, type ServerCheckout as by, type TenantContextInput as bz, CustomerNamespace as c, PRODUCT_UPSERT_READONLY_FIELD_REASON as c$, type ProductListingPageResult as c0, type ProductListingGroupsCatalogItem as c1, type ProductListingPageFullParams as c2, type ProductListingGroupsItem as c3, BaseApi as c4, type ProductDetail as c5, type ProductDetailCatalog as c6, type StockSnapshotResponse as c7, type ProductSelectionMediaSource as c8, type ProductDisplayMediaSource as c9, type CompatibilityProductSelectionParamEvent as cA, type CreateFulfillmentParams as cB, type CreateReturnParams as cC, type CustomerAuthOptions as cD, type CustomerAuthorizationUrlInput as cE, type CustomerAuthorizationUrlResult as cF, CustomerOAuth as cG, type CustomerOAuthCallbackResult as cH, type CustomerOAuthConfig as cI, type CustomerOAuthTokenSet as cJ, type CustomerOrderListOptions as cK, DiscountApi as cL, type DiscountApiOptions as cM, type DiscountErrorReasonCode as cN, type FeaturedImagePointerInput as cO, type GetOrderByPaymentIdParams as cP, type LegacyProductSelectionParamEvent as cQ, type ListingGroupsParams as cR, MAX_CART_LINE_ADMISSIONS as cS, type MarketDTO as cT, type MediaValue as cU, type NormalizedOptionSwatch as cV, type NormalizedProductSelection as cW, OrderApi as cX, type OrderApiOptions as cY, type OrderByPaymentResult as cZ, PRODUCT_PLP_FIND_OPTIONS as c_, type ResolveProductSelectionMediaInput as ca, type ResolveProductSelectionMediaResult as cb, type ProductSelectionMediaPointer as cc, type RootClientWithEvents as cd, type BulkImportFulfillmentsParams as ce, type BulkImportFulfillmentsResponse as cf, type CalculateShippingParams as cg, type CalculateShippingResult as ch, type CancelOrderParams as ci, type CancelOrderResponse as cj, type CancelReasonCode as ck, type CartDiscountCode as cl, type CartWarning as cm, type CartWarningCode as cn, type Comment as co, type CommerceClientOptions as cp, type CommunityClientOptions as cq, type CommunityComment as cr, type CommunityCommentListSort as cs, type CommunityPost as ct, type CommunityPostCategory as cu, type CommunityPostListSort as cv, type CommunityPostTag as cw, type CommunityPublicAuthorSnapshot as cx, type CommunityPublicMediaAsset as cy, type CommunityPublicReference as cz, type CustomerMembershipView as d, type ProductSelectionOptionValue as d$, PRODUCT_UPSERT_UNKNOWN_FIELD_REASON as d0, type PrepareFulfillmentOrderParams as d1, type PrepareFulfillmentOrderResponse as d2, ProductApi as d3, type ProductApiOptions as d4, type ProductDetailBrand as d5, type ProductDetailCatalogVariant as d6, type ProductDetailCategory as d7, type ProductDetailImage as d8, type ProductDetailImageMedia as d9, type ProductListingGroupsProduct as dA, type ProductListingGroupsResponse as dB, type ProductListingPageFilters as dC, type ProductListingPageSort as dD, type ProductListingProductShape as dE, type ProductListingSwatch as dF, type ProductLocaleOption as dG, type ProductLocaleReadParams as dH, type ProductLocalizedText as dI, type ProductLocalizedValue as dJ, type ProductMediaResolutionSource as dK, type ProductMoneyRange as dL, type ProductOptionMatrix as dM, type ProductOptionMatrixOption as dN, type ProductOptionMatrixValue as dO, type ProductOptionMatrixVariant as dP, type ProductOptionShape as dQ, type ProductOptionValueShape as dR, type ProductOptionValueSwatch as dS, type ProductOptionValueSwatchInput as dT, type ProductPriceRange as dU, type ProductSelectionAvailableSwatch as dV, type ProductSelectionAvailableValue as dW, type ProductSelectionByOptionValue as dX, ProductSelectionCodecError as dY, type ProductSelectionCodecOptions as dZ, type ProductSelectionInput as d_, type ProductDetailMedia as da, type ProductDetailOption as db, type ProductDetailOptionValue as dc, type ProductDetailResult as dd, type ProductDetailTag as de, type ProductDetailUnavailableReason as df, type ProductDetailVariant as dg, type ProductDetailVariantOptionValue as dh, type ProductDetailVideo as di, type ProductFallbackLocaleOption as dj, type ProductHrefGroup as dk, type ProductHrefOptions as dl, type ProductHrefProduct as dm, type ProductListingCard as dn, type ProductListingCardOptions as dp, type ProductListingCardPriceRange as dq, type ProductListingCardRepresentativeVariant as dr, type ProductListingGroup as ds, type ProductListingGroupCatalogSummary as dt, type ProductListingGroupCatalogVariant as du, type ProductListingGroupProjection as dv, type ProductListingGroupSummary as dw, type ProductListingGroupVariant as dx, type ProductListingGroupsCatalogProduct as dy, type ProductListingGroupsCatalogResponse as dz, type CancelMembershipParams as e, type ProductSelectionResolution as e0, type ProductSelectionResolutionContext as e1, type ProductSelectionUrlEmit as e2, type ProductSelectionVariant$1 as e3, type ProductUpsertFieldValidationErrorBody as e4, type ProductUpsertFieldValidationErrorReason as e5, type ProductVariantShape as e6, type PublicCheckoutBase as e7, type RequestOptions as e8, type ResolveCancelRefundFailedResponse as e9, buildProductListingCard as eA, buildProductListingGroupProjection as eB, buildProductListingGroupsByOption as eC, buildProductOptionMatrix as eD, buildProductOptionMatrixFromDetail as eE, createProductSelectionCodec as eF, getAvailableOptionValues as eG, getProductSelectionImages as eH, getSelectedValueByOptionId as eI, getVariantAvailableForSale as eJ, getVariantAvailableStock as eK, isProductUpsertFieldValidationErrorBody as eL, normalizeProductSelection as eM, normalizeProductSelectionFromMatrix as eN, normalizeSelectedValueIds as eO, parseProductSelection as eP, projectProductToListingShape as eQ, resolveFeaturedImagePointer as eR, resolveProductDisplayMedia as eS, resolveProductSelection as eT, resolveProductSelectionFromMatrix as eU, resolveProductSelectionMedia as eV, resolveVariantForSelection as eW, selectNext as eX, selectedSwatchMediaItemId as eY, stringifyProductSelection as eZ, toShopifyPriceRangeV2 as e_, type ResolveCancelRefundOutcome as ea, type ResolveCancelRefundParams as eb, type ResolveCancelRefundResponse as ec, type ResolveCancelRefundSucceededResponse as ed, type ResolveProductDisplayMediaInput as ee, type ResolveProductDisplayMediaResult as ef, type ResolvedCatalogPrice as eg, type ReturnCancellationReasonCode as eh, type ReturnItem as ei, type ReturnReason as ej, type ReturnWithRefundItem as ek, type ReturnWithRefundParams as el, ShippingApi as em, type ShippingApiOptions as en, type StockCheckParams as eo, type StockCheckResponse as ep, type StockCheckResult as eq, type StockSnapshotItem as er, type StockSnapshotParams as es, type UpdateFulfillmentParams as et, type UpdateOrderParams as eu, type UpdateReturnParams as ev, type ValidateDiscountParams as ew, type ValidateDiscountResult as ex, type WithIdempotencyKey as ey, buildProductHref 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 };