@sixtyninecommerce/client 0.30.0 → 0.31.0

package/dist/commerce/cart.d.ts

@@ -1,16 +1,13 @@
 import type { HttpClient } from '../core/http.js';
-import type { Order } from '../types.js';
+import type * as Shop from '../generated/shop.js';
 export declare function createCartMethods(http: HttpClient): {
-    getActiveOrder(): Promise<Order | null>;
-    addToCart(variantId: string, quantity: number): Promise<Order>;
-    addItemsToCart(items: Array<{
-        productVariantId: string;
-        quantity: number;
-    }>): Promise<Order>;
-    updateCartLine(lineId: string, quantity: number): Promise<Order>;
-    removeFromCart(lineId: string): Promise<Order>;
-    clearCart(): Promise<Order>;
-    applyCouponCode(code: string): Promise<Order>;
-    removeCouponCode(code: string): Promise<Order>;
+    getActiveOrder(): Promise<Shop.OrderFragment | null>;
+    addToCart(variantId: string, quantity: number): Promise<Shop.OrderFragment>;
+    addItemsToCart(items: Shop.AddItemInput[]): Promise<Shop.OrderFragment>;
+    updateCartLine(lineId: string, quantity: number): Promise<Shop.OrderFragment>;
+    removeFromCart(lineId: string): Promise<Shop.OrderFragment>;
+    clearCart(): Promise<Shop.OrderFragment>;
+    applyCouponCode(code: string): Promise<Shop.OrderFragment>;
+    removeCouponCode(code: string): Promise<Shop.OrderFragment | null>;
 };
 //# sourceMappingURL=cart.d.ts.map

package/dist/commerce/cart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/commerce/cart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAA0B,MAAM,aAAa,CAAC;AAgDjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU;sBAEtB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;yBAKlB,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;0BAS3D,KAAK,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3D,OAAO,CAAC,KAAK,CAAC;2BAiDY,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;2BAQzC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;iBAOjC,OAAO,CAAC,KAAK,CAAC;0BAKL,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;2BAKtB,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;EAOvD"}
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/commerce/cart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,KAAK,IAAI,MAAM,sBAAsB,CAAC;AAsClD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU;sBAEtB,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;yBAK/B,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;0BAQrD,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;2BAiDhD,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;2BAQtD,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;iBAO9C,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;0BAKlB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;2BAKnC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;EAO3E"}

package/dist/commerce/cart.js

@@ -35,7 +35,12 @@ export function createCartMethods(http) {
             return unwrapOrderResult(data, 'addItemToOrder');
         },
         async addItemsToCart(items) {
-            const data = await http.graphql(ADD_ITEMS_TO_CART, { inputs: items });
+            // `errorResults` is one entry per FAILING input, so it is NOT positionally
+            // aligned with `inputs` — an entry's `inputIndex` is the only thing that
+            // says which item the shopper needs to fix.
+            const data = await http.graphql(ADD_ITEMS_TO_CART, {
+                inputs: items,
+            });
             const result = data.addItemsToOrder;
             if (!result) {
                 throw new MutationError('UNKNOWN_ERROR', 'No result from addItemsToOrder');

package/dist/commerce/cart.js.map

@@ -1 +1 @@
-{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/commerce/cart.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/commerce/cart.ts"],"names":[],"mappings":"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"}

package/dist/commerce/checkout.d.ts

@@ -1,7 +1,53 @@
 import type { HttpClient, RequestOptions } from '../core/http.js';
-import type { ActiveChannelOrderConstraints, AddressInput, CustomerDeliveryTerms, CustomerInput, Order, OrderPaymentIntent, PaymentInput, PaymentMethod, PickupLocation, PickupLocationSearchInput, ShippingMethod, StoreContext } from '../types.js';
+import type * as Shop from '../generated/shop.js';
+import type { PickupLocation, StoreContext } from '../types.js';
+import { type ResultData } from './placement-error.js';
+/**
+ * Order custom fields the Shop API shows but never lets a shopper write, and
+ * where each one IS written. The engine refuses them on its own (they are not
+ * members of `UpdateOrderCustomFieldsInput`); naming the owner turns a GraphQL
+ * variable-coercion error into one that says what to call instead. Every key
+ * must stay a READ-ONLY field — `order-custom-fields.spec.ts` checks it against
+ * the schema snapshot, so this can never refuse a field the engine accepts.
+ */
+export declare const READ_ONLY_ORDER_CUSTOM_FIELDS: Readonly<Record<string, string>>;
+/**
+ * What `setOrderCustomFields` resolves to: the order plus the fields a shopper
+ * can write, as the engine stored them — the generated `Order` member of the
+ * mutation's result (`OrderFragment` with `customFields` selected as
+ * `OrderWritableCustomFieldsFragment`).
+ */
+export type OrderWithWritableCustomFields = ResultData<Shop.SetOrderCustomFieldsMutation['setOrderCustomFields']>;
+/**
+ * Unwrap a `Result`-union mutation, throwing the ErrorResult members.
+ *
+ * Every refusal a checkout mutation can return is hoisted by
+ * `toMutationError`: `error.code` names WHY (`ORDER_MINIMUM_AMOUNT_NOT_MET`,
+ * `PAYMENT_TERMS_UNAVAILABLE`, …) and `error.message` is already the best
+ * shopper-safe prose available — `placement.customerMessage` when the engine
+ * supplied one, else a vetted operator reason (`transitionError` /
+ * `interceptorError`), else the ErrorResult's generic template.
+ * `paymentErrorMessage` is deliberately NOT part of that walk — it can carry
+ * acquirer/ERP detail a shopper must never read — so a declined payment
+ * without `placement` keeps the generic message; the raw text stays on
+ * `error.fields.paymentErrorMessage` (see `placement-error.ts`).
+ */
+export declare function unwrapResult<D, K extends keyof D & string>(data: D, field: K): ResultData<D[K]>;
+/**
+ * How long a keyed payment call (`addPayment`, `payDeposit`,
+ * `createDepositPaymentIntent`) waits out `IDEMPOTENCY_IN_PROGRESS` and
+ * `ORDER_BUSY` before giving up.
+ *
+ * Longer than one request's own 15-second timeout: the answer means the FIRST
+ * attempt under this key is still running on the engine — a double click, or
+ * a repeat of a call that timed out on this side while the engine kept going.
+ */
+export declare const ADD_PAYMENT_IN_PROGRESS_WAIT_MS = 20000;
+type KeyedRequestOptions = RequestOptions & {
+    idempotencyKey?: string;
+};
 export declare function createCheckoutMethods(http: HttpClient, ctx?: StoreContext): {
-    setCustomerForOrder(input: CustomerInput): Promise<Order>;
+    setCustomerForOrder(input: Shop.CreateCustomerInput): Promise<Shop.OrderFragment>;
     /**
      * Set the order's delivery address.
      *
@@ -12,19 +58,37 @@ export declare function createCheckoutMethods(http: HttpClient, ctx?: StoreConte
      * changing the identity the cache is stamped with. The next
      * `pricing.getTaxDisplayMode()` therefore re-resolves.
      */
-    setShippingAddress(input: AddressInput): Promise<Order>;
-    setBillingAddress(input: AddressInput): Promise<Order>;
-    getEligibleShippingMethods(): Promise<ShippingMethod[]>;
-    getDeliveryTerms(options?: RequestOptions): Promise<CustomerDeliveryTerms | null>;
-    setShippingMethod(ids: string[]): Promise<Order>;
-    applyPreferredShippingMethod(): Promise<Order>;
-    getEligiblePaymentMethods(): Promise<PaymentMethod[]>;
+    setShippingAddress(input: Shop.CreateAddressInput): Promise<Shop.OrderFragment>;
+    setBillingAddress(input: Shop.CreateAddressInput): Promise<Shop.OrderFragment>;
+    /**
+     * See {@link CommerceModule.unsetShippingAddress}. Drops the cached tax
+     * display mode for the reason `setShippingAddress` does: with no address
+     * the order falls back to the channel's default tax zone.
+     */
+    unsetShippingAddress(options?: RequestOptions): Promise<Shop.OrderFragment>;
+    /** See {@link CommerceModule.unsetBillingAddress}. */
+    unsetBillingAddress(options?: RequestOptions): Promise<Shop.OrderFragment>;
+    /**
+     * See {@link CommerceModule.setOrderCustomFields}. The read-only fields are
+     * refused here only to name their owner; the engine is the authority on
+     * what is writable and refuses them anyway.
+     */
+    setOrderCustomFields(fields: Shop.UpdateOrderCustomFieldsInput, options?: RequestOptions): Promise<OrderWithWritableCustomFields>;
+    /** See {@link CommerceModule.setOrderCurrency}. */
+    setOrderCurrency(currencyCode: Shop.CurrencyCode, options?: RequestOptions): Promise<Shop.OrderFragment>;
+    getEligibleShippingMethods(): Promise<Shop.ShippingMethodsQuery["eligibleShippingMethods"]>;
+    getEligibleShippingRates(): Promise<Shop.ShippingRatesQuery["eligibleShippingRates"]>;
+    setShippingRate(shippingMethodId: string, rateCode?: string | null): Promise<Shop.OrderFragment>;
+    getDeliveryTerms(options?: RequestOptions): Promise<Shop.MyDeliveryTermsQuery["myDeliveryTerms"]>;
+    setShippingMethod(ids: string[]): Promise<Shop.OrderFragment>;
+    applyPreferredShippingMethod(): Promise<Shop.OrderFragment>;
+    getEligiblePaymentMethods(): Promise<Shop.PaymentMethodsQuery["eligiblePaymentMethods"]>;
     /**
      * Order minimums in effect on the active channel — for display and cart
      * pre-validation (e.g. "Minimum order €375"). Checkout enforces them
      * server-side at the ArrangingPayment transition regardless.
      */
-    getOrderConstraints(): Promise<ActiveChannelOrderConstraints>;
+    getOrderConstraints(): Promise<Shop.ActiveChannelOrderConstraintsQuery["activeChannelOrderConstraints"]>;
     /**
      * Tell the engine how the buyer intends to pay, and get the re-priced order
      * back.
@@ -59,15 +123,30 @@ export declare function createCheckoutMethods(http: HttpClient, ctx?: StoreConte
      *
      * @param intent - `PAY_NOW` or `PAY_ON_ACCOUNT`.
      */
-    setPaymentIntent(intent: OrderPaymentIntent): Promise<Order>;
-    transitionToArrangingPayment(): Promise<Order>;
-    addPayment(input: PaymentInput): Promise<Order>;
+    setPaymentIntent(intent: Shop.OrderPaymentIntent): Promise<ResultData<Shop.SetOrderPaymentIntentMutation["setOrderPaymentIntent"]>>;
+    transitionToArrangingPayment(): Promise<Shop.OrderFragment>;
+    /**
+     * The contract is on `CommerceModule.addPayment` (`types.ts`). Keyed by
+     * {@link underIdempotencyKey}. With `amount` the call is a DEPOSIT and goes
+     * to `payDeposit` under the same key handling, answering the held order —
+     * the same type a full payment answers.
+     *
+     * Routed on the PRESENCE of `amount`, never on its size: the SDK cannot see
+     * what the order still bills without a second read, so the engine judges
+     * (an amount equal to the balance is `AMOUNT_NOT_A_DEPOSIT`).
+     */
+    addPayment(input: Shop.PaymentInput, options?: KeyedRequestOptions & {
+        amount?: number;
+    }): Promise<ResultData<Shop.AddPaymentMutation["addPaymentToOrder"]>>;
+    payDeposit: (input: Shop.PayDepositInput, options?: KeyedRequestOptions) => Promise<Shop.PayDepositMutation["payDeposit"]>;
+    /** See {@link CommerceModule.createDepositPaymentIntent}. Keyed as `payDeposit`. */
+    createDepositPaymentIntent(input: Shop.DepositPaymentIntentInput, options?: KeyedRequestOptions): Promise<Shop.CreateDepositPaymentIntentMutation["createDepositPaymentIntent"]>;
     /**
      * Search for pickup locations near a postcode for a given carrier.
      * Carrier-agnostic — the backend dispatches to the configured provider
      * (currently MyParcel; future Sendcloud/Hendriks).
      */
-    findPickupLocations(input: PickupLocationSearchInput): Promise<PickupLocation[]>;
+    findPickupLocations(input: Shop.PickupLocationSearchInput): Promise<PickupLocation[]>;
     /**
      * Persist the customer's chosen pickup location onto the active order.
      * The backend re-validates the submitted location against the provider's
@@ -78,11 +157,12 @@ export declare function createCheckoutMethods(http: HttpClient, ctx?: StoreConte
      * builds the location object (e.g. cached from an earlier session) gets
      * a clear `StorefrontError` instead of an opaque `MutationError`.
      */
-    selectPickupLocation(location: PickupLocation): Promise<Order>;
+    selectPickupLocation(location: PickupLocation): Promise<ResultData<Shop.SetActiveOrderPickupLocationMutation["setActiveOrderPickupLocation"]>>;
     /**
      * Read the pickup location currently stored on the active order. Returns
      * `null` when no selection has been made or there is no active order.
      */
     getActivePickupLocation(): Promise<PickupLocation | null>;
 };
+export {};
 //# sourceMappingURL=checkout.d.ts.map

package/dist/commerce/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/commerce/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EACV,6BAA6B,EAC7B,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAkDrB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,YAAY;+BAErC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IAK/D;;;;;;;;;OASG;8BAC6B,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;6BAU9B,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;kCAOxB,OAAO,CAAC,cAAc,EAAE,CAAC;+BAO5B,cAAc,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;2BAS1D,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;oCAOhB,OAAO,CAAC,KAAK,CAAC;iCAKjB,OAAO,CAAC,aAAa,EAAE,CAAC;IAO3D;;;;OAIG;2BAC0B,OAAO,CAAC,6BAA6B,CAAC;IAOnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;6BAC4B,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;oCAK5B,OAAO,CAAC,KAAK,CAAC;sBAK5B,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;IAOrD;;;;OAIG;+BAC8B,yBAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOtF;;;;;;;;;OASG;mCACkC,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAQpE;;;OAGG;+BAC8B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;EAOlE"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/commerce/checkout.ts"],"names":[],"mappings":"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"}

package/dist/commerce/checkout.js

@@ -1,7 +1,23 @@
-import { MutationError } from '../errors.js';
+import { idempotencyKey } from '@sixtyninecommerce/core';
+import { CURRENCY_CODE_PATTERN, orderCurrencyRefusal } from '../core/currency.js';
+import { MutationError, StorefrontError } from '../errors.js';
+import { invalidArgument, isPlainObject } from './arguments.js';
 import { normalizePickupLocationInput, parseOptionalPickupLocation, parsePickupLocations, } from './pickup-location-parser.js';
 import { toMutationError } from './placement-error.js';
-import { ACTIVE_CHANNEL_ORDER_CONSTRAINTS, ACTIVE_ORDER_PICKUP_LOCATION, ADD_PAYMENT, APPLY_PREFERRED_SHIPPING_METHOD, ELIGIBLE_PAYMENT_METHODS, ELIGIBLE_SHIPPING_METHODS, MY_DELIVERY_TERMS, PICKUP_LOCATIONS, SET_ACTIVE_ORDER_PICKUP_LOCATION, SET_BILLING_ADDRESS, SET_CUSTOMER, SET_PAYMENT_INTENT, SET_SHIPPING_ADDRESS, SET_SHIPPING_METHOD, TRANSITION_TO_ARRANGING_PAYMENT, } from './queries.js';
+import { ACTIVE_CHANNEL_ORDER_CONSTRAINTS, ACTIVE_ORDER_PICKUP_LOCATION, ADD_PAYMENT, APPLY_PREFERRED_SHIPPING_METHOD, CREATE_DEPOSIT_PAYMENT_INTENT_MUTATION, ELIGIBLE_PAYMENT_METHODS, ELIGIBLE_SHIPPING_METHODS, ELIGIBLE_SHIPPING_RATES, MY_DELIVERY_TERMS, PAY_DEPOSIT_MUTATION, PICKUP_LOCATIONS, SET_ACTIVE_ORDER_PICKUP_LOCATION, SET_BILLING_ADDRESS, SET_CUSTOMER, SET_ORDER_CURRENCY, SET_ORDER_CUSTOM_FIELDS, SET_PAYMENT_INTENT, SET_SHIPPING_ADDRESS, SET_SHIPPING_METHOD, SET_SHIPPING_RATE, TRANSITION_TO_ARRANGING_PAYMENT, UNSET_BILLING_ADDRESS, UNSET_SHIPPING_ADDRESS, } from './queries.js';
+/**
+ * Order custom fields the Shop API shows but never lets a shopper write, and
+ * where each one IS written. The engine refuses them on its own (they are not
+ * members of `UpdateOrderCustomFieldsInput`); naming the owner turns a GraphQL
+ * variable-coercion error into one that says what to call instead. Every key
+ * must stay a READ-ONLY field — `order-custom-fields.spec.ts` checks it against
+ * the schema snapshot, so this can never refuse a field the engine accepts.
+ */
+export const READ_ONLY_ORDER_CUSTOM_FIELDS = {
+    paymentIntent: 'call setPaymentIntent instead: it records the intent and re-prices the order in one call',
+    orderScope: "it is fixed when the order is created, from the client's orderScope (the x-order-scope header)",
+    chargedParcelCount: 'the store sets it when it charges shipping per parcel',
+};
 /**
  * Unwrap a `Result`-union mutation, throwing the ErrorResult members.
  *
@@ -16,7 +32,7 @@ import { ACTIVE_CHANNEL_ORDER_CONSTRAINTS, ACTIVE_ORDER_PICKUP_LOCATION, ADD_PAY
  * without `placement` keeps the generic message; the raw text stays on
  * `error.fields.paymentErrorMessage` (see `placement-error.ts`).
  */
-function unwrapResult(data, field) {
+export function unwrapResult(data, field) {
     const result = data[field];
     if (!result) {
         throw new MutationError('UNKNOWN_ERROR', `No result from ${field}`);
@@ -26,7 +42,111 @@ function unwrapResult(data, field) {
     }
     return result;
 }
+/**
+ * How long a keyed payment call (`addPayment`, `payDeposit`,
+ * `createDepositPaymentIntent`) waits out `IDEMPOTENCY_IN_PROGRESS` and
+ * `ORDER_BUSY` before giving up.
+ *
+ * Longer than one request's own 15-second timeout: the answer means the FIRST
+ * attempt under this key is still running on the engine — a double click, or
+ * a repeat of a call that timed out on this side while the engine kept going.
+ */
+export const ADD_PAYMENT_IN_PROGRESS_WAIT_MS = 20_000;
+/**
+ * The two answers a keyed call asks again after, under the SAME key. Both say
+ * that THIS request changed nothing:
+ *
+ * - `IDEMPOTENCY_IN_PROGRESS`: the first attempt under the key is still
+ *   running. Asking again waits for it or replays it.
+ * - `ORDER_BUSY`: another change of the same cart was still being applied (the
+ *   engine makes storefront requests on one cart take turns) and this request
+ *   gave up waiting before it wrote anything. Asking again is the first run.
+ */
+const ASK_AGAIN_CODES = new Set(['IDEMPOTENCY_IN_PROGRESS', 'ORDER_BUSY']);
+/** Pauses between asks, then the last one repeats. */
+const IN_PROGRESS_BACKOFF_MS = [250, 500, 1_000, 2_000];
+/** What the engine accepts in `Idempotency-Key`: 1–255 visible ASCII characters. */
+const IDEMPOTENCY_KEY_PATTERN = /^[\x21-\x7e]{1,255}$/;
+function wait(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(done, ms);
+        function done() {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', done);
+            resolve();
+        }
+        signal?.addEventListener('abort', done, { once: true });
+    });
+}
+/** Stamp the key on whatever a keyed call throws, keeping one a caller already saw. */
+function withKey(error, key) {
+    if (error instanceof StorefrontError && error.idempotencyKey === undefined) {
+        error.idempotencyKey = key;
+    }
+    return error;
+}
+/**
+ * Run one keyed Shop API call (W8-12): always under a key — the caller's, or a
+ * fresh UUIDv7 — refused before anything is sent when the engine would refuse
+ * it, with `IDEMPOTENCY_IN_PROGRESS` and `ORDER_BUSY` asked again under the
+ * SAME key and the key stamped on whatever is thrown.
+ *
+ * Only an engine that honours the key can answer either, and both mean this
+ * request changed nothing ({@link ASK_AGAIN_CODES}), so asking again can only
+ * wait, replay, or run the payment for the first time. These are the only two
+ * reasons the SDK repeats a payment, and it repeats nothing that carries no
+ * key: a cart mutation answered `ORDER_BUSY` is thrown to the caller.
+ * `send` makes the request itself, so each caller's `graphql<T>(DOCUMENT)`
+ * stays a typed call of a constant document (`graphql-call-types.spec.ts`).
+ */
+async function underIdempotencyKey(options, send) {
+    const key = options?.idempotencyKey ?? idempotencyKey();
+    if (!IDEMPOTENCY_KEY_PATTERN.test(key)) {
+        throw new StorefrontError('idempotencyKey must be 1 to 255 visible ASCII characters (no spaces).', 'vendure', undefined, 'IDEMPOTENCY_KEY_INVALID');
+    }
+    const signal = options?.signal;
+    const deadline = Date.now() + ADD_PAYMENT_IN_PROGRESS_WAIT_MS;
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await send({ ...options, idempotencyKey: key });
+        }
+        catch (error) {
+            const pause = IN_PROGRESS_BACKOFF_MS[Math.min(attempt, IN_PROGRESS_BACKOFF_MS.length - 1)] ?? 0;
+            const askAgain = error instanceof StorefrontError &&
+                error.code !== undefined &&
+                ASK_AGAIN_CODES.has(error.code);
+            if (!askAgain || signal?.aborted || Date.now() + pause > deadline) {
+                throw withKey(error, key);
+            }
+            await wait(pause, signal);
+            if (signal?.aborted)
+                throw withKey(error, key);
+        }
+    }
+}
+/**
+ * A deposit amount that cannot even reach the engine: GraphQL `Int` holds whole
+ * minor units only. Zero and negative amounts are left to the engine, whose
+ * answer (`AMOUNT_NOT_POSITIVE`) is the code a storefront branches on.
+ */
+function requireWholeAmount(method, amount) {
+    if (typeof amount !== 'number' || !Number.isInteger(amount)) {
+        throw invalidArgument(`${method}: amount must be a whole number of minor units of the order's currency (e.g. 2500 for 25.00)`);
+    }
+}
 export function createCheckoutMethods(http, ctx) {
+    /** See {@link CommerceModule.payDeposit}. */
+    async function payDeposit(input, options) {
+        requireWholeAmount('payDeposit', input.amount);
+        return underIdempotencyKey(options, async (keyed) => {
+            const data = await http.graphql(PAY_DEPOSIT_MUTATION, { input }, keyed);
+            return data.payDeposit;
+        });
+    }
     return {
         async setCustomerForOrder(input) {
             const data = await http.graphql(SET_CUSTOMER, { input });
@@ -57,10 +177,80 @@ export function createCheckoutMethods(http, ctx) {
             });
             return unwrapResult(data, 'setOrderBillingAddress');
         },
+        /**
+         * See {@link CommerceModule.unsetShippingAddress}. Drops the cached tax
+         * display mode for the reason `setShippingAddress` does: with no address
+         * the order falls back to the channel's default tax zone.
+         */
+        async unsetShippingAddress(options) {
+            const data = await http.graphql(UNSET_SHIPPING_ADDRESS, undefined, options);
+            if (ctx) {
+                ctx.taxDisplay = null;
+            }
+            return unwrapResult(data, 'unsetOrderShippingAddress');
+        },
+        /** See {@link CommerceModule.unsetBillingAddress}. */
+        async unsetBillingAddress(options) {
+            const data = await http.graphql(UNSET_BILLING_ADDRESS, undefined, options);
+            return unwrapResult(data, 'unsetOrderBillingAddress');
+        },
+        /**
+         * See {@link CommerceModule.setOrderCustomFields}. The read-only fields are
+         * refused here only to name their owner; the engine is the authority on
+         * what is writable and refuses them anyway.
+         */
+        async setOrderCustomFields(fields, options) {
+            if (!isPlainObject(fields)) {
+                throw invalidArgument('setOrderCustomFields: fields must be an object of custom fields');
+            }
+            for (const name of Object.keys(fields)) {
+                const owner = READ_ONLY_ORDER_CUSTOM_FIELDS[name];
+                if (owner !== undefined) {
+                    throw invalidArgument(`setOrderCustomFields: "${name}" is read-only on the Shop API — ${owner}`);
+                }
+            }
+            const data = await http.graphql(SET_ORDER_CUSTOM_FIELDS, { input: { customFields: fields } }, options);
+            return unwrapResult(data, 'setOrderCustomFields');
+        },
+        /** See {@link CommerceModule.setOrderCurrency}. */
+        async setOrderCurrency(currencyCode, options) {
+            if (typeof currencyCode !== 'string' || !CURRENCY_CODE_PATTERN.test(currencyCode)) {
+                throw invalidArgument(`setOrderCurrency: "${String(currencyCode)}" is not an ISO 4217 code (three upper-case letters, e.g. "EUR")`);
+            }
+            let data;
+            try {
+                data = await http.graphql(SET_ORDER_CURRENCY, { currencyCode }, options);
+            }
+            catch (error) {
+                throw ((error instanceof StorefrontError && orderCurrencyRefusal(error, currencyCode)) || error);
+            }
+            const order = unwrapResult(data, 'setCurrencyCodeForOrder');
+            // The engine re-prices an order into the REQUEST's currency on every
+            // change (`applyPriceAdjustments`), and a request names one only through
+            // `?currencyCode=`. Without this the next addToCart put the order back in
+            // the channel default. The session follows the order's own answer.
+            if (ctx) {
+                const chosen = typeof order.currencyCode === 'string' ? order.currencyCode : currencyCode;
+                ctx.sessionCurrencyCode = chosen;
+                ctx.currencyCode = chosen;
+            }
+            return order;
+        },
         async getEligibleShippingMethods() {
             const data = await http.graphql(ELIGIBLE_SHIPPING_METHODS);
             return data.eligibleShippingMethods;
         },
+        async getEligibleShippingRates() {
+            const data = await http.graphql(ELIGIBLE_SHIPPING_RATES);
+            return data.eligibleShippingRates;
+        },
+        async setShippingRate(shippingMethodId, rateCode) {
+            const data = await http.graphql(SET_SHIPPING_RATE, {
+                shippingMethodId,
+                rateCode: rateCode ?? null,
+            });
+            return unwrapResult(data, 'setOrderShippingRate');
+        },
         async getDeliveryTerms(options) {
             const data = await http.graphql(MY_DELIVERY_TERMS, undefined, options);
             return data.myDeliveryTerms;
@@ -123,16 +313,48 @@ export function createCheckoutMethods(http, ctx) {
          * @param intent - `PAY_NOW` or `PAY_ON_ACCOUNT`.
          */
         async setPaymentIntent(intent) {
-            const data = await http.graphql(SET_PAYMENT_INTENT, { intent });
+            const data = await http.graphql(SET_PAYMENT_INTENT, {
+                intent,
+            });
             return unwrapResult(data, 'setOrderPaymentIntent');
         },
         async transitionToArrangingPayment() {
             const data = await http.graphql(TRANSITION_TO_ARRANGING_PAYMENT);
             return unwrapResult(data, 'transitionOrderToState');
         },
-        async addPayment(input) {
-            const data = await http.graphql(ADD_PAYMENT, { input });
-            return unwrapResult(data, 'addPaymentToOrder');
+        /**
+         * The contract is on `CommerceModule.addPayment` (`types.ts`). Keyed by
+         * {@link underIdempotencyKey}. With `amount` the call is a DEPOSIT and goes
+         * to `payDeposit` under the same key handling, answering the held order —
+         * the same type a full payment answers.
+         *
+         * Routed on the PRESENCE of `amount`, never on its size: the SDK cannot see
+         * what the order still bills without a second read, so the engine judges
+         * (an amount equal to the balance is `AMOUNT_NOT_A_DEPOSIT`).
+         */
+        async addPayment(input, options) {
+            // `!== undefined`, not `typeof === 'number'`: a `null` from untyped code is
+            // refused below rather than read as "pay in full", which takes MORE money
+            // than a caller who meant a deposit intended.
+            if (options?.amount !== undefined) {
+                const { amount, ...rest } = options;
+                requireWholeAmount('addPayment', amount);
+                const deposit = await payDeposit({ method: input.method, amount, metadata: input.metadata }, rest);
+                return deposit.order;
+            }
+            return underIdempotencyKey(options, async (keyed) => {
+                const data = await http.graphql(ADD_PAYMENT, { input }, keyed);
+                return unwrapResult(data, 'addPaymentToOrder');
+            });
+        },
+        payDeposit,
+        /** See {@link CommerceModule.createDepositPaymentIntent}. Keyed as `payDeposit`. */
+        async createDepositPaymentIntent(input, options) {
+            requireWholeAmount('createDepositPaymentIntent', input.amount);
+            return underIdempotencyKey(options, async (keyed) => {
+                const data = await http.graphql(CREATE_DEPOSIT_PAYMENT_INTENT_MUTATION, { input }, keyed);
+                return data.createDepositPaymentIntent;
+            });
         },
         // --- Pickup locations (carrier-agnostic) ---
         /**
@@ -158,9 +380,7 @@ export function createCheckoutMethods(http, ctx) {
          */
         async selectPickupLocation(location) {
             const normalized = normalizePickupLocationInput(location);
-            const data = await http.graphql(SET_ACTIVE_ORDER_PICKUP_LOCATION, {
-                location: normalized,
-            });
+            const data = await http.graphql(SET_ACTIVE_ORDER_PICKUP_LOCATION, { location: normalized });
             return unwrapResult(data, 'setActiveOrderPickupLocation');
         },
         /**

package/dist/commerce/checkout.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../src/commerce/checkout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../src/commerce/checkout.ts"],"names":[],"mappings":"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"}