@doswiftly/storefront-sdk 16.1.0 → 17.0.0

package/dist/core/generated/operation-types.d.ts

@@ -474,7 +474,7 @@ export type Cart = Node & {
     appliedGiftCards: Array<CartAppliedGiftCard>;
     /** Cart-level custom attributes (free-form key/value). Use for cart-wide metadata such as B2B PO number or marketing source. Replace (not merge) the list with `cartUpdateAttributes`. */
     attributes: Array<CartAttribute>;
-    /** Available payment methods dla tego cart (shop-configured providers) */
+    /** Available payment methods dla tego carta — deduplikowane per type, sorted by merchant priority. */
     availablePaymentMethods: Array<PaymentMethod>;
     /** Shipping methods available for this cart at the given destination. Reads the cart subtotal and weight directly — for pre-cart preview (e.g. a product detail page calculator) use the top-level `availableShippingMethods(address, cart)` query instead. Returns an empty `methods` list plus a `DIGITAL_ONLY_NO_SHIPPING` user error when the cart has no shippable items; the storefront can use this to skip the shipping step entirely. */
     availableShippingMethods: AvailableShippingMethodsPayload;
@@ -508,6 +508,8 @@ export type Cart = Node & {
     recommendations?: Maybe<CartRecommendations>;
     /** True when at least one line in the cart requires physical shipping. False when every line is non-physical (digital, gift card, service, subscription). Use as the single signal to render or skip the shipping step in checkout. */
     requiresShipping: Scalars['Boolean']['output'];
+    /** Optional concrete instrument code selected within `selectedPaymentMethod` (e.g. `"blik"`, `"mb"`, `"154"`). Set gdy klient klika konkretny instrument tile na storefront (per `PaymentMethod.instruments`). Pre-payment intent: skopiowany do `Order.paymentInstrumentCode` przy `cartComplete`. Storefront może cross-reference z `availablePaymentMethods.methods[].instruments[]` żeby dostać `displayName` / `brandImageUrl`. Added by payment-instrument-preselection core sprint Req 3 AC7. */
+    selectedPaymentInstrumentCode?: Maybe<Scalars['String']['output']>;
     /** The payment method currently selected on the cart. Null until the buyer picks a method via `cartSelectPaymentMethod`. */
     selectedPaymentMethod?: Maybe<PaymentMethod>;
     /** The shipping method currently selected on the cart (label + cost). Null until the buyer picks a method. */
@@ -520,6 +522,8 @@ export type Cart = Node & {
     totalQuantity: Scalars['Int']['output'];
     /** When the cart was last modified (ISO 8601). */
     updatedAt: Scalars['DateTime']['output'];
+    /** Non-fatal advisories computed at query time. Currently emitted: `PAYMENT_SELECTION_STALE` when `selectedPaymentMethod` / `selectedPaymentInstrumentCode` are no longer in live gateway capabilities (storefront re-prompts the buyer). Read-only — backend state is not mutated. Added by payment-instrument-preselection-advanced sub-sprint Adv-2 Req 1. */
+    warnings: Array<CartWarning>;
 };
 export type CartAddLinesPayload = {
     /** The updated cart on success; null when `userErrors` is non-empty. */
@@ -619,6 +623,18 @@ export type CartBuyerIdentityInput = {
     /** Buyer phone number. Free-form; max 30 chars. */
     phone?: InputMaybe<Scalars['String']['input']>;
 };
+export type CartClearPaymentSelectionInput = {
+    /** ID of the cart to clear payment selection on. */
+    cartId: Scalars['ID']['input'];
+};
+export type CartClearPaymentSelectionPayload = {
+    /** The updated cart z cleared payment selection. */
+    cart?: Maybe<Cart>;
+    /** Business / validation errors carrying a stable `CartErrorCode` in `code` (e.g. `ALREADY_COMPLETED`). */
+    userErrors: Array<UserError>;
+    /** Non-fatal advisories — the mutation itself succeeded. */
+    warnings: Array<CartWarning>;
+};
 export type CartCompleteInput = {
     /** ID of the cart to complete. */
     cartId: Scalars['ID']['input'];
@@ -814,8 +830,12 @@ export type CartRemoveLinesPayload = {
 export type CartSelectPaymentMethodInput = {
     /** ID of the cart to update. */
     cartId: Scalars['ID']['input'];
-    /** ID of the chosen payment method (matches a `PaymentMethod.id` from `availablePaymentMethods`). */
-    paymentMethodId: Scalars['ID']['input'];
+    /** Category of the payment method the buyer picked (matches `PaymentMethod.type` from `availablePaymentMethods`). */
+    methodType: PaymentMethodType;
+    /** Optional gateway-specific instrument code (`blik`, `mb`, `c`, `154`, ...) z `PaymentMethod.instruments[].instrumentCode`. Wymaga ustawienia `preferredProviderCode` — instrument code jest provider-specific. Bez restrictive regex (różne bramki używają `.` / `:` / `/` w przyszłości). SQL injection chroniona przez Prisma parametrized queries. Added by payment-instrument-preselection core sprint Req 3.1. */
+    preferredInstrumentCode?: InputMaybe<Scalars['String']['input']>;
+    /** Optional override of `PaymentMethod.preferredProvider`. Pass a provider code (`payu`, `przelewy24`, ...) from `providersAvailable` when the buyer explicitly picks one (rare — usually the merchant priority is enough). Format: lowercase alphanumerics + underscore + hyphen, 2-50 characters. Renamed from `preferredProviderId` — `*Code` is reserved for lowercase string identifiers, `*Id` for UUIDs. */
+    preferredProviderCode?: InputMaybe<Scalars['String']['input']>;
 };
 export type CartSelectPaymentMethodPayload = {
     /** The updated cart with `selectedPaymentMethod` populated. */
@@ -936,7 +956,7 @@ export type CartWarning = {
     /** What the warning is about — a cart line ID when the warning refers to a specific item, or a field path otherwise. */
     target: Scalars['String']['output'];
 };
-export type CartWarningCode = 'MERCHANDISE_NOT_AVAILABLE' | 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'PAYMENTS_AMOUNT_REGION_MISMATCH' | 'SHIPPING_METHOD_AUTO_CLEARED';
+export type CartWarningCode = 'MERCHANDISE_NOT_AVAILABLE' | 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'PAYMENTS_AMOUNT_REGION_MISMATCH' | 'PAYMENT_SELECTION_STALE' | 'SHIPPING_METHOD_AUTO_CLEARED';
 export type Category = {
     /** Child categories */
     children: Array<Category>;
@@ -1823,6 +1843,8 @@ export type Mutation = {
     cartAddLines: CartAddLinesPayload;
     /** Apply a gift card to the cart by full code. The card is debited at `cartComplete`. Rate-limited to 5 requests per minute per IP+shop (gift card codes form a finite enumerable space). */
     cartApplyGiftCard: CartApplyGiftCardPayload;
+    /** Clear all payment selection state on the cart in a single atomic operation. Use for accordion "back to method picker" flows w storefront UI. Idempotent — calling twice yields the same end state. Cart MUSI być `ACTIVE` (CONVERTED carts reject z `ALREADY_COMPLETED`). */
+    cartClearPaymentSelection: CartClearPaymentSelectionPayload;
     /** Finalise the cart into an `Order`. The cart is locked and no longer accepts mutations. Payment is initiated separately via `paymentCreate` — check `order.canCreatePayment` to decide whether to render a "Pay now" button or send the buyer directly to the confirmation page (for offline methods such as cash on delivery). Rate-limited to 5 requests per minute per IP+shop; pass an `idempotencyKey` to guard against duplicate orders on retry. */
     cartComplete: CartCompletePayload;
     /** Create a new cart. All fields on `input` are optional — call with no input to create an empty cart, or pass initial lines, buyer identity, attributes, discount codes, email and a shipping address to skip the corresponding follow-up calls. */
@@ -1833,7 +1855,7 @@ export type Mutation = {
     cartRemoveGiftCard: CartRemoveGiftCardPayload;
     /** Remove one or more lines from the cart by `CartLine.id`. Equivalent to `cartUpdateLines` with `quantity: 0` but lets the storefront express the intent explicitly. */
     cartRemoveLines: CartRemoveLinesPayload;
-    /** Select a payment method on the cart. Validates against the active shop payment methods and currency. The selection is finalised at `cartComplete`; payment itself is initiated via a separate `paymentCreate` mutation after the order is created. */
+    /** Select a payment method on the cart by category (BLIK, CARD, BANK_TRANSFER, ...). Backend resolves the preferred provider from `MerchantPaymentConfig` at `paymentCreate` time. Optional `preferredProviderCode` overrides the merchant priority when the buyer explicitly picks a gateway from `PaymentMethod.providersAvailable`. Optional `preferredInstrumentCode` enables instrument-level deep-link na gateway hosted page (BLIK ekran, mBank flow, etc.) — wymaga `preferredProviderCode`. */
     cartSelectPaymentMethod: CartSelectPaymentMethodPayload;
     /** Select a shipping method on the cart. Validates the method against the cart contents and the shipping address (must be eligible for the destination, and a pickup point must be set when the method delivers to a locker / collection point). Updates `cost.totalShipping` and the grand total. */
     cartSelectShippingMethod: CartSelectShippingMethodPayload;
@@ -2029,31 +2051,62 @@ export type PaymentCreateInput = {
 export type PaymentCreatePayload = {
     /** The created (or reused) payment session on success; null when `userErrors` is non-empty. */
     payment?: Maybe<PaymentSession>;
-    /** Business / validation errors carrying a stable `PaymentErrorCode` in `code` (e.g. `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `PAYMENT_FAILED`). */
+    /** Business / validation errors carrying a stable `PaymentErrorCode` in `code` (e.g. `ORDER_NOT_FOUND`, `ORDER_ALREADY_PAID`, `ORDER_NOT_PAYABLE`, `PAYMENT_PROVIDER_NOT_CONFIGURED`, `RETURN_URL_INVALID`, `PAYMENT_FAILED`, `INSTRUMENT_PRESELECTION_FAILED`). */
     userErrors: Array<UserError>;
+    /** Non-blocking signals — backend state change context (e.g. instrument auto-cleared, server-side adjustment). Default empty array. Storefront branches per `code` for UI retry hints / analytics events. Added by payment-instrument-preselection-advanced Adv-1 Req 2.3. */
+    warnings: Array<PaymentWarning>;
 };
 export type PaymentInitiationFlow = 'INSTANT_DIRECT' | 'OFFLINE_MANUAL' | 'ONLINE_EMBEDDED' | 'ONLINE_REDIRECT';
 export type PaymentMethod = {
+    /** True when the buyer can actually pick this method right now. False when the resolving gateway is temporarily unavailable (incident/maintenance) or reported the method as disabled. Storefront UI should gray-out the tile when false instead of hiding it — gives merchants observability into routing failures. */
+    available: Scalars['Boolean']['output'];
     /** Optional buyer-facing description shown under the name (e.g. "Pay with your bank app"). */
     description?: Maybe<Scalars['String']['output']>;
     /** Optional icon URL configured by the merchant. Use as the method tile artwork. */
     icon?: Maybe<Scalars['String']['output']>;
     /** Stable ID of the payment method. Pass to `cartSelectPaymentMethod` to select it. */
     id: Scalars['ID']['output'];
+    /** Concrete instruments exposed by gateway providers w obrębie tej method (BLIK code, branded banks, wallets, card brands). Null gdy żaden provider nie expose'uje granular data dla tej method. Empty array gdy gateway expose'uje ale wszystkie instruments są disabled lub po post-filter (cross-provider leak prevention). Storefront może wyrenderować listę i pass `instrumentCode` jako `preferredInstrumentCode` w `cartSelectPaymentMethod` → gateway deep-link na ten ekran. Added by payment-instrument-preselection core sprint Req 1. */
+    instruments?: Maybe<Array<PaymentMethodInstrument>>;
     /** True when the merchant has marked this method as the default. Pre-select it in the picker. */
     isDefault: Scalars['Boolean']['output'];
     /** Display name configured by the merchant (e.g. "BLIK", "Credit card", "Cash on delivery"). */
     name: Scalars['String']['output'];
     /** Merchant-configured display position — lower values come first in the picker. */
     position: Scalars['Float']['output'];
-    /** Provider code (e.g. "payu", "stripe", "p24", "cash_on_delivery"). Identifies the integration behind the method; do not branch UI on it — use `type` instead. */
-    provider: Scalars['String']['output'];
+    /** Preferred provider code (UPPERCASE enum) that the backend will route to when the buyer picks this method type and does not specify `preferredProviderCode`. Populated only when at least one provider supports the type. Typed enum since core sprint payment-instrument-preselection (was `String` pre-v9.0). */
+    preferredProvider?: Maybe<ProviderCode>;
+    /** Provider code (e.g. `PAYU`, `STRIPE`, `PRZELEWY24`, `CASH_ON_DELIVERY`). Identifies the integration behind the method; do not branch UI on it — use `type` instead. Typed enum since core sprint payment-instrument-preselection (was `String` pre-v9.0). */
+    provider: ProviderCode;
+    /** Provider codes (UPPERCASE enum: `PAYU`, `PRZELEWY24`, ...) that can fulfil this method type for the current shop, ordered by merchant priority. Pre-select `preferredProvider`; expose the rest only when the buyer wants to choose explicitly. Single-element array when only one provider supports the type. Typed enum since core sprint payment-instrument-preselection (was `[String]` pre-v9.0). */
+    providersAvailable?: Maybe<Array<ProviderCode>>;
     /** ISO 4217 currency codes the method accepts. Null when the method accepts the shop currency without restriction. */
     supportedCurrencies?: Maybe<Array<Scalars['String']['output']>>;
     /** Category of the method (CARD, BLIK, BANK_TRANSFER, CASH_ON_DELIVERY, OTHER). Drives iconography and copy. */
     type: PaymentMethodType;
-};
+    /** When `available` is false, this enum carries the diagnostic reason (GATEWAY_DOWN, GATEWAY_DISABLED, NO_INSTRUMENTS, CREDENTIALS_INVALID). Null when `available` is true. UI can render context-aware copy ("PayU is temporarily down" vs "Method not configured"). */
+    unavailableReason?: Maybe<PaymentMethodUnavailableReason>;
+};
+export type PaymentMethodInstrument = {
+    /** Optional brand image URL (bank logo, wallet icon). Storefront może użyć jako tile artwork. Null gdy gateway nie expose'uje albo instrument nie ma brand visual (BLIK code). */
+    brandImageUrl?: Maybe<Scalars['String']['output']>;
+    /** UX rendering hint — jak storefront powinien wyrenderować ten instrument (prominent button vs branded tile vs dropdown vs radio). Backend-agnostic mapping na visual treatment. */
+    displayHint: PaymentMethodInstrumentDisplayHint;
+    /** Buyer-facing display name (e.g. "BLIK", "mBank", "ING Bank Śląski", "Apple Pay"). Lokalizacja zazwyczaj PL/EN — multi-language defer post-v1. */
+    displayName: Scalars['String']['output'];
+    /** True gdy instrument jest currently enabled w gateway live capabilities. Storefront może gray-out tile gdy false zamiast hide (observability dla merchant). */
+    enabled: Scalars['Boolean']['output'];
+    /** Gateway-specific instrument identifier (PayU: `"blik"`/`"mb"`/`"c"`, P24: numeric ID string `"154"`). Pass jako `preferredInstrumentCode` w `cartSelectPaymentMethod`. Stabilne per provider — gateway nie renumeruje. */
+    instrumentCode: Scalars['String']['output'];
+    /** Provider obsługujący ten instrument (UPPERCASE enum). Wymagane dla cross-provider dedupe (np. BLIK code dostępny zarówno przez PayU jak P24 — różne instrumenty mimo tej samej method type). */
+    providerCode: ProviderCode;
+    /** Semantic type klasyfikujący instrument w obrębie method (BLIK code vs bank vs wallet vs card brand). Storefront-facing dispatch dla per-instrument UI components. */
+    type: PaymentMethodInstrumentType;
+};
+export type PaymentMethodInstrumentDisplayHint = 'BRANDED_TILE' | 'DROPDOWN_OPTION' | 'PROMINENT_BUTTON' | 'RADIO_OPTION';
+export type PaymentMethodInstrumentType = 'BANK' | 'BLIK_CODE' | 'CARD_BRAND' | 'OTHER' | 'WALLET';
 export type PaymentMethodType = 'BANK_TRANSFER' | 'BLIK' | 'CARD' | 'CASH_ON_DELIVERY' | 'OTHER';
+export type PaymentMethodUnavailableReason = 'CREDENTIALS_INVALID' | 'GATEWAY_DISABLED' | 'GATEWAY_DOWN' | 'NO_INSTRUMENTS';
 export type PaymentSession = {
     /** Client secret / token for the in-page payment widget. Populated only when `flow` is ONLINE_EMBEDDED. Treat as sensitive — do not log. */
     clientSecret?: Maybe<Scalars['String']['output']>;
@@ -2082,6 +2135,15 @@ export type PaymentSettings = {
     /** Kody aktywnych payment providerów dla tego sklepu (z IntegrationProvider table, type=PAYMENT). Np. ["payu", "cash_on_delivery"]. Storefront-dev używa do warunkowania UI checkout. */
     paymentProviders: Array<Scalars['String']['output']>;
 };
+export type PaymentWarning = {
+    /** Machine-readable code — branch on this to dispatch UI retry hints. Add a new code only when there is a distinct UX response. */
+    code: PaymentWarningCode;
+    /** Pre-translated user-facing message describing what happened (Polish-first per shop locale). */
+    message: Scalars['String']['output'];
+    /** Optional additional hint string for UI dispatch — currently unused for `INSTRUMENT_CLEARED_FOR_RETRY` (semantic encoded in `message`). Reserved for future warning codes (e.g. `SLOW_GATEWAY_RESPONSE` → "Retry in 30s"). */
+    retryHint?: Maybe<Scalars['String']['output']>;
+};
+export type PaymentWarningCode = 'INSTRUMENT_CLEARED_FOR_RETRY';
 export type PickupPoint = {
     /** Point address as a single human-readable line — show alongside the name on the confirmation page. */
     address?: Maybe<Scalars['String']['output']>;
@@ -2422,12 +2484,13 @@ export type ProductVariantEdge = {
     node: ProductVariant;
 };
 export type ProductVisibility = 'BUNDLE_ONLY' | 'HIDDEN' | 'PUBLIC';
+export type ProviderCode = 'BANK_TRANSFER' | 'CASH_ON_DELIVERY' | 'GIFT_CARD' | 'MANUAL_PAYMENT' | 'PAYU' | 'PRZELEWY24' | 'STRIPE' | 'TEST_GATEWAY';
 export type Query = {
     /** List of all currencies supported by the system (ECB rates) */
     allSupportedCurrencies: Array<Currency>;
     /** Paginated + searchable attribute options dla drill-into filter UI (np. dropdown z 800 licencjami + search input). Honors product context z exclude-self per attribute. Sort: COUNT_DESC default (most popular first), LABEL_ASC dla alfabetycznego z polskim collation. */
     attributeOptionsSearch: AttributeFilterValueConnection;
-    /** Payment methods active for the current shop, plus the merchant default. Shop-level — independent of cart contents in this iteration. Fetch once for the checkout payment step. */
+    /** Payment methods active for the current shop, plus the merchant default. Returns one row per `PaymentMethodType` (BLIK, CARD, BANK_TRANSFER, ...) with `providersAvailable` (provider codes sorted by merchant priority) and `preferredProvider` (the head of the list). Shop-level — independent of cart contents. */
     availablePaymentMethods: AvailablePaymentMethods;
     /** Standalone shipping-method preview for an address — does not require a cart. Pass an optional `cart` summary (subtotal, weight, currency) to evaluate price-based / weight-based rules and free-shipping thresholds. For an already-created cart, prefer `cart.availableShippingMethods(address)` — it reads the cart contents directly. */
     availableShippingMethods: AvailableShippingMethodsPayload;
@@ -3210,8 +3273,12 @@ export type AvailablePaymentMethodsQueryVariables = Exact<{
 }>;
 export type AvailablePaymentMethodsQuery = {
     availablePaymentMethods: {
-        methods: Array<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
-        defaultMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+        methods: Array<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+            instruments?: Maybe<Array<Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>>>;
+        })>;
+        defaultMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+            instruments?: Maybe<Array<Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>>>;
+        })>;
     };
 };
 export type CartAddLinesMutationVariables = Exact<{
@@ -3220,7 +3287,7 @@ export type CartAddLinesMutationVariables = Exact<{
 }>;
 export type CartAddLinesMutation = {
     cartAddLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3282,7 +3349,7 @@ export type CartApplyGiftCardMutationVariables = Exact<{
 }>;
 export type CartApplyGiftCardMutation = {
     cartApplyGiftCard: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3365,6 +3432,68 @@ export type CartAvailableShippingMethodsQuery = {
         };
     })>;
 };
+export type CartClearPaymentSelectionMutationVariables = Exact<{
+    input: CartClearPaymentSelectionInput;
+}>;
+export type CartClearPaymentSelectionMutation = {
+    cartClearPaymentSelection: {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+            cost: {
+                total: Pick<Money, 'amount' | 'currencyCode'>;
+                subtotal: Pick<Money, 'amount' | 'currencyCode'>;
+                totalTax?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                totalDuty?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                checkoutCharge?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                totalDiscount: Pick<Money, 'amount' | 'currencyCode'>;
+                totalShipping?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+            };
+            lines: (Pick<CartLineConnection, 'totalCount'> & {
+                nodes: Array<(Pick<CartLine, 'id' | 'quantity' | 'productId' | 'productTitle' | 'productHandle' | 'productType' | 'requiresShipping'> & {
+                    variant: (Pick<ProductVariant, 'id' | 'title' | 'sku' | 'isAvailable' | 'availableStock' | 'barcode' | 'sortOrder'> & {
+                        price: Pick<Money, 'amount' | 'currencyCode'>;
+                        compareAtPrice?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                        image?: Maybe<Pick<Image, 'id' | 'url' | 'altText' | 'width' | 'height' | 'thumbhash'>>;
+                        selectedOptions: Array<Pick<SelectedOption, 'name' | 'value'>>;
+                        weight?: Maybe<Pick<Weight, 'value' | 'unit'>>;
+                    });
+                    cost: {
+                        pricePerUnit: Pick<Money, 'amount' | 'currencyCode'>;
+                        subtotal: Pick<Money, 'amount' | 'currencyCode'>;
+                        total: Pick<Money, 'amount' | 'currencyCode'>;
+                        compareAtPricePerUnit?: Maybe<Pick<Money, 'amount' | 'currencyCode'>>;
+                    };
+                    attributes: Array<Pick<Attribute, 'key' | 'value'>>;
+                    attributeSelections: Array<Pick<AttributeSelection, 'attributeDefinitionId' | 'attributeName' | 'type' | 'fillingMode' | 'billingMode' | 'optionId' | 'optionLabel' | 'optionIds' | 'textValue' | 'surchargeAmount' | 'surchargeType' | 'taxClassId' | 'linkedVariantId'>>;
+                    giftCardRecipient?: Maybe<Pick<GiftCardLineRecipient, 'recipientEmail' | 'recipientName' | 'message'>>;
+                })>;
+                pageInfo: Pick<PageInfo, 'hasNextPage' | 'hasPreviousPage' | 'startCursor' | 'endCursor'>;
+            });
+            buyerIdentity?: Maybe<Pick<CartBuyerIdentity, 'email' | 'phone' | 'countryCode'>>;
+            discountCodes: Array<Pick<CartDiscountCode, 'code' | 'isApplicable'>>;
+            discountAllocations: Array<(Pick<CartDiscountAllocation, 'discountCode'> & {
+                amount: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            attributes: Array<Pick<CartAttribute, 'key' | 'value'>>;
+            shippingAddress?: Maybe<(Pick<MailingAddress, 'id' | 'firstName' | 'lastName' | 'name' | 'company' | 'streetLine1' | 'streetLine2' | 'city' | 'state' | 'stateCode' | 'country' | 'countryCode' | 'postalCode' | 'phone' | 'isDefault' | 'taxId' | 'vatNumber'> & {
+                pickupPoint?: Maybe<Pick<PickupPoint, 'provider' | 'pointId' | 'name' | 'address'>>;
+            })>;
+            billingAddress?: Maybe<(Pick<MailingAddress, 'id' | 'firstName' | 'lastName' | 'name' | 'company' | 'streetLine1' | 'streetLine2' | 'city' | 'state' | 'stateCode' | 'country' | 'countryCode' | 'postalCode' | 'phone' | 'isDefault' | 'taxId' | 'vatNumber'> & {
+                pickupPoint?: Maybe<Pick<PickupPoint, 'provider' | 'pointId' | 'name' | 'address'>>;
+            })>;
+            selectedShippingMethod?: Maybe<(Pick<CartShippingMethod, 'handle' | 'title'> & {
+                price: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            selectedPaymentMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+            appliedGiftCards: Array<(Pick<CartAppliedGiftCard, 'id' | 'maskedCode' | 'lastCharacters'> & {
+                appliedAmount: Pick<Money, 'amount' | 'currencyCode'>;
+                remainingBalance: Pick<Money, 'amount' | 'currencyCode'>;
+            })>;
+            completedOrder?: Maybe<Pick<Order, 'id' | 'orderNumber' | 'accessToken' | 'status' | 'paymentStatus' | 'fulfillmentStatus'>>;
+        })>;
+        userErrors: Array<Pick<UserError, 'message' | 'code' | 'field'>>;
+        warnings: Array<Pick<CartWarning, 'message' | 'code' | 'target'>>;
+    };
+};
 export type CartCompleteMutationVariables = Exact<{
     input: CartCompleteInput;
 }>;
@@ -3390,7 +3519,7 @@ export type CartCreateMutationVariables = Exact<{
 }>;
 export type CartCreateMutation = {
     cartCreate: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3453,7 +3582,7 @@ export type CartDiscountCodesUpdateMutationVariables = Exact<{
 }>;
 export type CartDiscountCodesUpdateMutation = {
     cartDiscountCodesUpdate: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3514,7 +3643,7 @@ export type CartQueryVariables = Exact<{
     id: Scalars['ID']['input'];
 }>;
 export type CartQuery = {
-    cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+    cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
         cost: {
             total: Pick<Money, 'amount' | 'currencyCode'>;
             subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3573,7 +3702,7 @@ export type CartRemoveGiftCardMutationVariables = Exact<{
 }>;
 export type CartRemoveGiftCardMutation = {
     cartRemoveGiftCard: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3636,7 +3765,7 @@ export type CartRemoveLinesMutationVariables = Exact<{
 }>;
 export type CartRemoveLinesMutation = {
     cartRemoveLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3698,7 +3827,7 @@ export type CartSelectPaymentMethodMutationVariables = Exact<{
 }>;
 export type CartSelectPaymentMethodMutation = {
     cartSelectPaymentMethod: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3760,7 +3889,7 @@ export type CartSelectShippingMethodMutationVariables = Exact<{
 }>;
 export type CartSelectShippingMethodMutation = {
     cartSelectShippingMethod: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3822,7 +3951,7 @@ export type CartSetBillingAddressMutationVariables = Exact<{
 }>;
 export type CartSetBillingAddressMutation = {
     cartSetBillingAddress: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3884,7 +4013,7 @@ export type CartSetShippingAddressMutationVariables = Exact<{
 }>;
 export type CartSetShippingAddressMutation = {
     cartSetShippingAddress: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -3947,7 +4076,7 @@ export type CartUpdateAttributesMutationVariables = Exact<{
 }>;
 export type CartUpdateAttributesMutation = {
     cartUpdateAttributes: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4010,7 +4139,7 @@ export type CartUpdateBuyerIdentityMutationVariables = Exact<{
 }>;
 export type CartUpdateBuyerIdentityMutation = {
     cartUpdateBuyerIdentity: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4072,7 +4201,7 @@ export type CartUpdateGiftCardRecipientMutationVariables = Exact<{
 }>;
 export type CartUpdateGiftCardRecipientMutation = {
     cartUpdateGiftCardRecipient: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4135,7 +4264,7 @@ export type CartUpdateLinesMutationVariables = Exact<{
 }>;
 export type CartUpdateLinesMutation = {
     cartUpdateLines: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4198,7 +4327,7 @@ export type CartUpdateNoteMutationVariables = Exact<{
 }>;
 export type CartUpdateNoteMutation = {
     cartUpdateNote: {
-        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+        cart?: Maybe<(Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
             cost: {
                 total: Pick<Money, 'amount' | 'currencyCode'>;
                 subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4291,6 +4420,7 @@ export type PaymentCreateMutation = {
     paymentCreate: {
         payment?: Maybe<Pick<PaymentSession, 'id' | 'orderId' | 'flow' | 'provider' | 'redirectUrl' | 'clientSecret' | 'status' | 'expiresAt'>>;
         userErrors: Array<Pick<UserError, 'message' | 'code' | 'field'>>;
+        warnings: Array<Pick<PaymentWarning, 'message' | 'code' | 'retryHint'>>;
     };
 };
 export type CustomerAddressesQueryVariables = Exact<{
@@ -4355,11 +4485,18 @@ export type CustomerSignupMutation = {
     };
 };
 export type AvailablePaymentMethodsFragment = {
-    methods: Array<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
-    defaultMethod?: Maybe<Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>>;
+    methods: Array<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+        instruments?: Maybe<Array<Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>>>;
+    })>;
+    defaultMethod?: Maybe<(Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+        instruments?: Maybe<Array<Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>>>;
+    })>;
 };
-export type PaymentMethodFragment = Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position'>;
-export type CartFragment = (Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
+export type PaymentMethodFragment = (Pick<PaymentMethod, 'id' | 'name' | 'provider' | 'type' | 'icon' | 'description' | 'isDefault' | 'supportedCurrencies' | 'position' | 'providersAvailable' | 'preferredProvider' | 'available' | 'unavailableReason'> & {
+    instruments?: Maybe<Array<Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>>>;
+});
+export type PaymentMethodInstrumentFragment = Pick<PaymentMethodInstrument, 'providerCode' | 'instrumentCode' | 'type' | 'displayName' | 'displayHint' | 'brandImageUrl' | 'enabled'>;
+export type CartFragment = (Pick<Cart, 'id' | 'checkoutUrl' | 'totalQuantity' | 'note' | 'email' | 'phone' | 'selectedPaymentInstrumentCode' | 'requiresShipping' | 'createdAt' | 'updatedAt' | 'status'> & {
     cost: {
         total: Pick<Money, 'amount' | 'currencyCode'>;
         subtotal: Pick<Money, 'amount' | 'currencyCode'>;
@@ -4505,6 +4642,7 @@ export type OrderFragment = (Pick<Order, 'id' | 'orderNumber' | 'accessToken' |
     })>;
 });
 export type PaymentSessionFragment = Pick<PaymentSession, 'id' | 'orderId' | 'flow' | 'provider' | 'redirectUrl' | 'clientSecret' | 'status' | 'expiresAt'>;
+export type PaymentWarningFragment = Pick<PaymentWarning, 'message' | 'code' | 'retryHint'>;
 export type CustomerAccessTokenFieldsFragment = Pick<CustomerAccessToken, 'accessToken' | 'expiresAt'>;
 export type UserErrorFieldsFragment = Pick<UserError, 'message' | 'field' | 'code'>;
 export type CustomerFieldsFragment = (Pick<Customer, 'id' | 'email' | 'firstName' | 'lastName' | 'displayName' | 'phone' | 'isEmailVerified' | 'emailMarketing' | 'orderCount' | 'createdAt' | 'updatedAt'> & {