@doswiftly/storefront-operations 8.0.0 → 10.0.0

package/llms-full.txt

@@ -1,7 +1,7 @@
 # DoSwiftly Storefront Operations — Full Reference
 
-> Schema version: **8.0.0**
-> 48 queries · 44 mutations · 104 fragments
+> Schema version: **10.0.0**
+> 48 queries · 39 mutations · 99 fragments
 
 Auto-generated from `.graphql` source files. Do not edit by hand — this file is
 regenerated on every release to match the published schema.
@@ -430,22 +430,35 @@ query CustomerOrder($orderId: ID!) {
 }
 ```
 
-### Query: `Checkout`
+### Query: `CartValidateDiscountCode`
 
-**Section**: Checkout
+**Section**: Discount Code Validation
 
-**Description**: Fetches a checkout session by `id`. **Important**: `checkoutId` and `cartId` are 1:1 — there is no separate "checkout" record, the response is built dynamically from the cart. Returns line items, addresses, selected shipping rate, available shipping rates + payment methods, applied discount/gift cards (gift card codes are masked for security), and totals (`cost`, `tax`, `paymentDue`). Public read; ownership enforced on mutations. Refetch after every checkout mutation.
+**Description**: Read-only validation of a discount code against an existing cart — does NOT modify cart state. Returns `{ isValid, discount, error }` (`DiscountValidationResult`) for previewing the effect of a code (inline UI feedback as the user types, before they commit to applying via `cartDiscountCodesUpdate`). Validates: discount existence + active status + customer eligibility + minimum order amount + minimum quantity met. Errors: `NOT_FOUND`, `INACTIVE`, `NOT_STARTED`, `EXPIRED`, `USAGE_LIMIT_REACHED`, `CUSTOMER_USAGE_LIMIT_REACHED`, `CUSTOMER_NOT_ELIGIBLE`, `MINIMUM_ORDER_NOT_MET`, `MINIMUM_QUANTITY_NOT_MET`.
 
 **Variables**:
-- `$id`: `ID!`
-
-**Fragments used**: `Checkout`
+- `$cartId`: `ID!`
+- `$discountCode`: `String!`
 
 **GraphQL**:
 ```graphql
-query Checkout($id: ID!) {
-  checkout(id: $id) {
-    ...Checkout
+query CartValidateDiscountCode($cartId: ID!, $discountCode: String!) {
+  cartValidateDiscountCode(cartId: $cartId, discountCode: $discountCode) {
+    isValid
+    discount {
+      code
+      title
+      type
+      value
+      discountAmount {
+        amount
+        currencyCode
+      }
+    }
+    error {
+      code
+      message
+    }
   }
 }
 ```
@@ -1383,11 +1396,11 @@ mutation CartRemoveLines($id: ID!, $lineIds: [ID!]!) {
 }
 ```
 
-### Mutation: `CartApplyDiscountCodes`
+### Mutation: `CartDiscountCodesUpdate`
 
 **Section**: Cart Mutations
 
-**Description**: Replaces (NOT appends) the cart's discount codes with the given list. Pass `[]` to clear all codes. Each code is validated against `discounts` table (existence, active status); invalid codes appear in `userErrors[]` as `DISCOUNT_CODE_INVALID`. Triggers cart re-pricing — discount allocations are recomputed and stored in `cart.discountAmount`.
+**Description**: Replaces (NOT appends) the cart's discount codes with the given list. Pass `[]` to clear all codes. Each code is validated against the discounts table (existence, active status); invalid codes appear in `userErrors[]` as `DISCOUNT_CODE_INVALID`. Triggers cart re-pricing — discount allocations are recomputed and stored in `cart.discountAmount`. Single canonical replace-all entry point — prior append/single-remove variants were removed in favor of this explicit caller-controlled list semantics.
 
 **Variables**:
 - `$id`: `ID!`
@@ -1397,8 +1410,8 @@ mutation CartRemoveLines($id: ID!, $lineIds: [ID!]!) {
 
 **GraphQL**:
 ```graphql
-mutation CartApplyDiscountCodes($id: ID!, $discountCodes: [String!]!) {
-  cartApplyDiscountCodes(id: $id, discountCodes: $discountCodes) {
+mutation CartDiscountCodesUpdate($id: ID!, $discountCodes: [String!]!) {
+  cartDiscountCodesUpdate(id: $id, discountCodes: $discountCodes) {
     cart {
       ...Cart
     }
@@ -1774,355 +1787,228 @@ mutation CustomerResetPassword($token: String!, $newPassword: String!) {
 }
 ```
 
-### Mutation: `CheckoutCreate`
+### Mutation: `CartSetShippingAddress`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Creates a new checkout session for the given cart (or a fresh cart if `cartId` is omitted). Inherits applied discounts and gift cards from the cart by reference (not snapshot). Errors: `CART_NOT_FOUND`, `EMPTY_CART`, `ALREADY_COMPLETED` (cart already converted to order). NOT idempotent — multiple calls create multiple checkouts.
+**Description**: Phase 3 unify-cart-graphql-surface: wszystkie fulfillment + payment + completion operations teraz na Cart aggregate (zamiast Checkout dual-aggregate). Klient robi typowy checkout flow: cart create/add items → setShipping/Billing/Method → selectPayment → (optional) applyGiftCard → cartComplete → Order created. Sets the shipping address on the cart (full replace, not patch). Triggers cart re-pricing (tax recalculation per address country/region). Address format validated against `CartAddressInput` constraints (firstName/lastName/streetLine1/city/country/postalCode required). Errors: `INVALID_ADDRESS`, `CART_NOT_FOUND`.
 
 **Variables**:
-- `$input`: `CheckoutCreateInput!`
+- `$input`: `CartSetShippingAddressInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutCreate($input: CheckoutCreateInput!) {
-  checkoutCreate(input: $input) {
-    checkout {
-      ...Checkout
+mutation CartSetShippingAddress($input: CartSetShippingAddressInput!) {
+  cartSetShippingAddress(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
-  }
-}
-```
-
-### Mutation: `CheckoutUpdateShippingAddress`
-
-**Section**: Checkout Mutations
-
-**Description**: Sets the shipping address (full replace, not patch). Triggers cart re-pricing. Address format is NOT validated here — full validation runs at `checkoutComplete`.
-
-**Variables**:
-- `$id`: `ID!`
-- `$shippingAddress`: `CheckoutAddressInput!`
-
-**Fragments used**: `Checkout`, `UserError`
-
-**GraphQL**:
-```graphql
-mutation CheckoutUpdateShippingAddress($id: ID!, $shippingAddress: CheckoutAddressInput!) {
-  checkoutUpdateShippingAddress(id: $id, shippingAddress: $shippingAddress) {
-    checkout {
-      ...Checkout
-    }
-    userErrors {
-      ...UserError
+    warnings {
+      ...CartWarning
     }
   }
 }
 ```
 
-### Mutation: `CheckoutUpdateBillingAddress`
+### Mutation: `CartSetBillingAddress`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Sets the billing address (full replace). Independent of shipping address — pass it explicitly even when "billing same as shipping".
+**Description**: Sets the billing address on the cart (full replace). Independent of shipping address — pass it explicitly even when "billing same as shipping". Errors: `INVALID_ADDRESS`, `CART_NOT_FOUND`.
 
 **Variables**:
-- `$id`: `ID!`
-- `$billingAddress`: `CheckoutAddressInput!`
+- `$input`: `CartSetBillingAddressInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutUpdateBillingAddress($id: ID!, $billingAddress: CheckoutAddressInput!) {
-  checkoutUpdateBillingAddress(id: $id, billingAddress: $billingAddress) {
-    checkout {
-      ...Checkout
+mutation CartSetBillingAddress($input: CartSetBillingAddressInput!) {
+  cartSetBillingAddress(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
-  }
-}
-```
-
-### Mutation: `CheckoutUpdateEmail`
-
-**Section**: Checkout Mutations
-
-**Description**: Sets or updates the contact email on the checkout (used for guest checkout, order confirmation, and tracking emails). Validated against a regex; returns `INVALID` for malformed format.
-
-**Variables**:
-- `$id`: `ID!`
-- `$email`: `String!`
-
-**Fragments used**: `Checkout`, `UserError`
-
-**GraphQL**:
-```graphql
-mutation CheckoutUpdateEmail($id: ID!, $email: String!) {
-  checkoutUpdateEmail(id: $id, email: $email) {
-    checkout {
-      ...Checkout
-    }
-    userErrors {
-      ...UserError
+    warnings {
+      ...CartWarning
     }
   }
 }
 ```
 
-### Mutation: `CheckoutSelectShippingRate`
+### Mutation: `CartSelectShippingMethod`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Selects a shipping method by `rateId` (a stable shipping-method UUID, NOT an opaque per-request token). The id comes from `availableShippingMethods` query, computed for the current address + cart subtotal at request time.
+**Description**: Selects a shipping method by `shippingMethodId` (typed `ID!`, a stable shipping-method UUID — NOT a per-request token). The id comes from a list of methods available for the current address + cart subtotal (queryable separately). Errors: `SHIPPING_METHOD_REQUIRED`, `ZIP_CODE_NOT_SUPPORTED`, `CART_NOT_FOUND`.
 
 **Variables**:
-- `$id`: `ID!`
-- `$rateId`: `String!`
+- `$input`: `CartSelectShippingMethodInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutSelectShippingRate($id: ID!, $rateId: String!) {
-  checkoutSelectShippingRate(id: $id, rateId: $rateId) {
-    checkout {
-      ...Checkout
+mutation CartSelectShippingMethod($input: CartSelectShippingMethodInput!) {
+  cartSelectShippingMethod(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 ```
 
-### Mutation: `CheckoutApplyDiscountCode`
+### Mutation: `CartSelectPaymentMethod`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Appends a discount code to the cart's `discount_codes` array. Note: while multiple codes can be stored, the pricing engine currently uses **only the first applied code** — codes do not stack. Validated for existence, active status, and customer usage limits.
+**Description**: Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence + active status; no pre-authorization performed here. Errors: `PAYMENT_METHOD_REQUIRED`, `INVALID_PAYMENT`, `CART_NOT_FOUND`.
 
 **Variables**:
-- `$id`: `ID!`
-- `$discountCode`: `String!`
+- `$input`: `CartSelectPaymentMethodInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutApplyDiscountCode($id: ID!, $discountCode: String!) {
-  checkoutApplyDiscountCode(id: $id, discountCode: $discountCode) {
-    checkout {
-      ...Checkout
+mutation CartSelectPaymentMethod($input: CartSelectPaymentMethodInput!) {
+  cartSelectPaymentMethod(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 ```
 
-### Mutation: `CheckoutRemoveDiscountCode`
+### Mutation: `CartApplyGiftCard`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Removes a code from the cart's `discount_codes` array (filters by exact match). Triggers re-pricing.
+**Description**: Applies a gift card to the cart, stackable with discount codes. Consumption is FIFO: each card consumes `min(remainingBalance, paymentDue)` against the current cart total in the order they were applied. The gift card balance is NOT debited yet — actual deduction happens atomically at `cartComplete`. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`.
 
 **Variables**:
-- `$id`: `ID!`
-- `$discountCode`: `String!`
+- `$input`: `CartApplyGiftCardInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutRemoveDiscountCode($id: ID!, $discountCode: String!) {
-  checkoutRemoveDiscountCode(id: $id, discountCode: $discountCode) {
-    checkout {
-      ...Checkout
+mutation CartApplyGiftCard($input: CartApplyGiftCardInput!) {
+  cartApplyGiftCard(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 ```
 
-### Mutation: `CheckoutValidateDiscountCode`
+### Mutation: `CartRemoveGiftCard`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: READ-ONLY validation of a discount code against the current checkout — does NOT modify state. Returns `{ isValid, discount, error }` for previewing the effect (e.g. inline UI feedback as the user types).
+**Description**: Removes a gift card from the applied list and recalculates FIFO `appliedAmount` for the remaining cards. Since gift card balances are only debited at `cartComplete`, removing before completion has no effect on the underlying gift card balance.
 
 **Variables**:
-- `$id`: `ID!`
-- `$discountCode`: `String!`
+- `$input`: `CartRemoveGiftCardInput!`
 
-**Fragments used**: `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutValidateDiscountCode($id: ID!, $discountCode: String!) {
-  checkoutValidateDiscountCode(id: $id, discountCode: $discountCode) {
-    result {
-      isValid
-      discount {
-        code
-        title
-        type
-        value
-        discountAmount {
-          amount
-          currencyCode
-        }
-      }
-      error {
-        code
-        message
-      }
+mutation CartRemoveGiftCard($input: CartRemoveGiftCardInput!) {
+  cartRemoveGiftCard(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 ```
 
-### Mutation: `CheckoutSelectPaymentMethod`
+### Mutation: `CartUpdateGiftCardRecipient`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence and active status; no pre-authorization is performed here.
+**Description**: Sets per-line-item recipient details (name, email, message) for digital gift card products in the cart (line items where the variant represents a gift-card SKU). Required before `cartComplete` for any line item with a gift-card variant. Recipient details propagated to the resulting order.
 
 **Variables**:
-- `$id`: `ID!`
-- `$paymentMethodId`: `ID!`
+- `$input`: `CartUpdateGiftCardRecipientInput!`
 
-**Fragments used**: `Checkout`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutSelectPaymentMethod($id: ID!, $paymentMethodId: ID!) {
-  checkoutSelectPaymentMethod(id: $id, paymentMethodId: $paymentMethodId) {
-    checkout {
-      ...Checkout
+mutation CartUpdateGiftCardRecipient($input: CartUpdateGiftCardRecipientInput!) {
+  cartUpdateGiftCardRecipient(input: $input) {
+    cart {
+      ...Cart
     }
     userErrors {
       ...UserError
     }
+    warnings {
+      ...CartWarning
+    }
   }
 }
 ```
 
-### Mutation: `CheckoutComplete`
+### Mutation: `CartComplete`
 
-**Section**: Checkout Mutations
+**Section**: Cart Completion Mutations
 
-**Description**: Finalizes the checkout: creates the `Order`, deducts gift cards, sends order-created confirmation — all atomically. **Idempotent on `idempotencyKey`** (NOT on the checkout `id`); auto-generated if the caller omits it. The `paymentUrl` field is reserved but is NOT populated here — for hosted gateways (PayU, P24) the storefront calls a separate `paymentCreate` mutation after this returns.
+**Description**: Finalizes the cart — creates the `Order`, deducts gift cards, sends order-created confirmation — all atomically. **Idempotent on `idempotencyKey`** (auto-generated from cartId + minute timestamp if caller omits it). Returns `order` field after completion. Note: `paymentUrl` is intentionally NOT in payload — for hosted gateways (online providers) the storefront calls a separate `paymentCreate` mutation after this returns (check `order.canCreatePayment` first). Errors: `EMAIL_REQUIRED`, `SHIPPING_ADDRESS_REQUIRED`, `SHIPPING_METHOD_REQUIRED`, `PAYMENT_METHOD_REQUIRED`, `INSUFFICIENT_STOCK`, `ALREADY_COMPLETED`.
 
 **Variables**:
-- `$id`: `ID!`
-- `$input`: `CheckoutCompleteInput`
+- `$input`: `CartCompleteInput!`
 
-**Fragments used**: `Checkout`, `Order`, `UserError`
+**Fragments used**: `Cart`, `CartWarning`, `Order`, `UserError`
 
 **GraphQL**:
 ```graphql
-mutation CheckoutComplete($id: ID!, $input: CheckoutCompleteInput) {
-  checkoutComplete(id: $id, input: $input) {
-    checkout {
-      ...Checkout
+mutation CartComplete($input: CartCompleteInput!) {
+  cartComplete(input: $input) {
+    cart {
+      ...Cart
     }
     order {
       ...Order
     }
-    paymentUrl
     userErrors {
       ...UserError
     }
-  }
-}
-```
-
-### Mutation: `CheckoutApplyGiftCard`
-
-**Section**: Gift Card Checkout Mutations
-
-**Description**: Applies a gift card to the cart, stackable with discount codes. Consumption is FIFO: each card consumes `min(remainingBalance, paymentDue)` against the current cart total in the order they were applied. The gift card balance is NOT debited yet — actual deduction happens atomically at `checkoutComplete`. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`, `GIFT_CARD_ALREADY_APPLIED`.
-
-**Variables**:
-- `$id`: `ID!`
-- `$giftCardCode`: `String!`
-
-**Fragments used**: `Checkout`, `UserError`
-
-**GraphQL**:
-```graphql
-mutation CheckoutApplyGiftCard($id: ID!, $giftCardCode: String!) {
-  checkoutApplyGiftCard(id: $id, giftCardCode: $giftCardCode) {
-    checkout {
-      ...Checkout
-    }
-    userErrors {
-      ...UserError
-    }
-  }
-}
-```
-
-### Mutation: `CheckoutRemoveGiftCard`
-
-**Section**: Gift Card Checkout Mutations
-
-**Description**: Removes a gift card from the applied list and recalculates FIFO `appliedAmount` for the remaining cards. Since gift card balances are only debited at `checkoutComplete`, removing before completion has no effect on the underlying gift card balance.
-
-**Variables**:
-- `$id`: `ID!`
-- `$giftCardCode`: `String!`
-
-**Fragments used**: `Checkout`, `UserError`
-
-**GraphQL**:
-```graphql
-mutation CheckoutRemoveGiftCard($id: ID!, $giftCardCode: String!) {
-  checkoutRemoveGiftCard(id: $id, giftCardCode: $giftCardCode) {
-    checkout {
-      ...Checkout
-    }
-    userErrors {
-      ...UserError
-    }
-  }
-}
-```
-
-### Mutation: `CheckoutUpdateGiftCardRecipient`
-
-**Section**: Gift Card Checkout Mutations
-
-**Description**: Sets per-line-item recipient details (name, email, message, delivery date) for digital gift card products in the cart (variants with `type: GIFT_CARD`). Required before `checkoutComplete` for any line item with a gift-card variant. Recipient details are associated with each gift-card line item and propagated to the resulting order.
-
-**Variables**:
-- `$input`: `CheckoutGiftCardRecipientInput!`
-
-**Fragments used**: `Checkout`, `UserError`
-
-**GraphQL**:
-```graphql
-mutation CheckoutUpdateGiftCardRecipient($input: CheckoutGiftCardRecipientInput!) {
-  checkoutUpdateGiftCardRecipient(input: $input) {
-    checkout {
-      ...Checkout
-    }
-    userErrors {
-      ...UserError
+    warnings {
+      ...CartWarning
     }
   }
 }
@@ -2801,6 +2687,7 @@ fragment MailingAddress on MailingAddress {
   countryCode
   firstName
   lastName
+  name
   phone
   state
   stateCode
@@ -2864,7 +2751,7 @@ fragment Customer on Customer {
 
 **Section**: Customer
 
-**Description**: Order summary — number, totals (cost / tax / shipping), payment + fulfillment status, shipping address, item count, lifecycle timestamps. Spread on the order list and order detail pages. Line items are not included here.
+**Description**: Order summary — number, totals (cost / tax / shipping), payment + fulfillment status, shipping address, item count, lifecycle timestamps, plus payment capability signal (`canCreatePayment` + `paymentMethodType`) the storefront uses to decide post-completion payment flow without hard-coded provider checks. Spread on the order list, order detail, and the `cartComplete` mutation result. Line items are not included here.
 
 **Uses fragments**: `MailingAddress`, `Money`
 
@@ -2898,6 +2785,8 @@ fragment Order on Order {
     ...MailingAddress
   }
   itemCount
+  canCreatePayment
+  paymentMethodType
 }
 ```
 
@@ -3065,9 +2954,9 @@ fragment CartDiscountAllocation on CartDiscountAllocation {
 
 **Section**: Cart
 
-**Description**: Full cart shape — totals, line items (paginated up to 100), buyer identity, applied discount codes + allocations, note, custom attributes. Spread on the cart drawer / cart page; refetch after every cart mutation.
+**Description**: Full cart shape — totals, line items (paginated up to 100), buyer identity, applied discount codes + allocations, note, custom attributes, plus fulfillment fields (email/phone/addresses/shipping method/payment method/applied gift cards). Spread on the cart drawer / cart page; refetch after every cart mutation including completion lifecycle.
 
-**Uses fragments**: `CartBuyerIdentity`, `CartCost`, `CartDiscountAllocation`, `CartDiscountCode`, `CartLine`, `PageInfo`
+**Uses fragments**: `CartAppliedGiftCard`, `CartBuyerIdentity`, `CartCost`, `CartDiscountAllocation`, `CartDiscountCode`, `CartLine`, `CartSelectedPaymentMethod`, `CartShippingMethod`, `MailingAddress`, `PageInfo`
 
 **GraphQL**:
 ```graphql
@@ -3111,11 +3000,90 @@ fragment Cart on Cart {
     key
     value
   }
+  email
+  phone
+  shippingAddress {
+    ...MailingAddress
+  }
+  billingAddress {
+    ...MailingAddress
+  }
+  selectedShippingMethod {
+    ...CartShippingMethod
+  }
+  selectedPaymentMethod {
+    ...CartSelectedPaymentMethod
+  }
+  appliedGiftCards {
+    ...CartAppliedGiftCard
+  }
   createdAt
   updatedAt
 }
 ```
 
+### Fragment: `CartShippingMethod` on `CartShippingMethod`
+
+**Section**: Cart
+
+**Description**: Shipping method selected on a cart (D8 term unification — wcześniej ShippingRate). Returned przez `cart.selectedShippingMethod` po `cartSelectShippingMethod` mutation.
+
+**Uses fragments**: `Money`
+
+**GraphQL**:
+```graphql
+fragment CartShippingMethod on CartShippingMethod {
+  handle
+  title
+  price {
+    ...Money
+  }
+}
+```
+
+### Fragment: `CartAppliedGiftCard` on `CartAppliedGiftCard`
+
+**Section**: Cart
+
+**Description**: Gift card applied to a cart — masked code for display, last 4 chars for matching, applied amount + remaining balance. Balance NIE debited yet — actual deduction atomically at `cartComplete`.
+
+**Uses fragments**: `Money`
+
+**GraphQL**:
+```graphql
+fragment CartAppliedGiftCard on CartAppliedGiftCard {
+  maskedCode
+  lastCharacters
+  appliedAmount {
+    ...Money
+  }
+  remainingBalance {
+    ...Money
+  }
+}
+```
+
+### Fragment: `CartSelectedPaymentMethod` on `PaymentMethod`
+
+**Section**: Cart
+
+**Description**: Payment method (integration provider) selected on a cart — id, name, provider code, type category (CARD/BLIK/BANK_TRANSFER/etc.), icon, description, isDefault, supportedCurrencies. Storefront UI używa do iconography + selection display.
+
+**GraphQL**:
+```graphql
+fragment CartSelectedPaymentMethod on PaymentMethod {
+  id
+  name
+  provider
+  type
+  icon
+  description
+  isDefault
+  supportedCurrencies
+  position
+}
+```
+
 ### Fragment: `ShopColors` on `ShopColors`
 
 **Section**: Shop
@@ -3350,247 +3318,6 @@ fragment AvailablePaymentMethods on AvailablePaymentMethods {
 }
 ```
 
-### Fragment: `ShippingRate` on `ShippingRate`
-
-**Section**: Checkout
-
-**Description**: Single shipping rate option — `handle` is the stable id you pass to `checkoutSelectShippingRate` as `rateId`, plus title and price.
-
-**Uses fragments**: `Money`
-
-**GraphQL**:
-```graphql
-fragment ShippingRate on ShippingRate {
-  handle
-  title
-  price {
-    ...Money
-  }
-}
-```
-
-### Fragment: `TaxLine` on `TaxLine`
-
-**Section**: Checkout
-
-**Description**: One tax line on the checkout — title, rate (decimal, e.g. 0.23 for 23%), computed amount. Spread on the order summary.
-
-**Uses fragments**: `Money`
-
-**GraphQL**:
-```graphql
-fragment TaxLine on TaxLine {
-  title
-  rate
-  price {
-    ...Money
-  }
-}
-```
-
-### Fragment: `DiscountAffectedItem` on `DiscountAffectedItem`
-
-**Section**: Checkout
-
-**Description**: Item affected by a discount — the discounted product/variant with original + discounted prices and savings. Used on Buy-X-Get-Y promotions to highlight which items the discount applies to.
-
-**Uses fragments**: `Money`
-
-**GraphQL**:
-```graphql
-fragment DiscountAffectedItem on DiscountAffectedItem {
-  productId
-  variantId
-  title
-  quantity
-  originalPrice {
-    ...Money
-  }
-  discountedPrice {
-    ...Money
-  }
-  savings {
-    ...Money
-  }
-  isFreeItem
-}
-```
-
-### Fragment: `DiscountApplication` on `DiscountApplication`
-
-**Section**: Checkout
-
-**Description**: A discount currently applied to the checkout — code, type, value, plus BXGY (Buy X Get Y) metadata when applicable (`buyQuantity`, `getQuantity`, `getDiscountPercent`, `affectedItems`). Use to render a "Discounts applied" panel.
-
-**Uses fragments**: `DiscountAffectedItem`, `Money`
-
-**GraphQL**:
-```graphql
-fragment DiscountApplication on DiscountApplication {
-  code
-  isApplicable
-  type
-  value {
-    ...Money
-  }
-  title
-  affectedItems {
-    ...DiscountAffectedItem
-  }
-  buyQuantity
-  getQuantity
-  getDiscountPercent
-}
-```
-
-### Fragment: `DiscountCode` on `DiscountCode`
-
-**Section**: Checkout
-
-**Description**: Lightweight discount code entry on the checkout — code + applicability flag.
-
-**GraphQL**:
-```graphql
-fragment DiscountCode on DiscountCode {
-  code
-  isApplicable
-}
-```
-
-### Fragment: `CheckoutLineItem` on `CheckoutLineItem`
-
-**Section**: Checkout
-
-**Description**: Single line item in the checkout — variant snapshot, quantity, unit + total prices, image. Use on the order summary panel.
-
-**Uses fragments**: `ImageThumbnail`, `Money`
-
-**GraphQL**:
-```graphql
-fragment CheckoutLineItem on CheckoutLineItem {
-  id
-  title
-  variantTitle
-  quantity
-  pricePerUnit {
-    ...Money
-  }
-  total {
-    ...Money
-  }
-  variantId
-  productId
-  sku
-  image {
-    ...ImageThumbnail
-  }
-}
-```
-
-### Fragment: `AppliedGiftCard` on `AppliedGiftCard`
-
-**Section**: Checkout
-
-**Description**: Gift card applied to the checkout — `maskedCode` (first + last 4 chars), `lastCharacters` (for display matching), the amount applied to this checkout, and remaining balance after this order would complete.
-
-**Uses fragments**: `Money`
-
-**GraphQL**:
-```graphql
-fragment AppliedGiftCard on AppliedGiftCard {
-  maskedCode
-  lastCharacters
-  appliedAmount {
-    ...Money
-  }
-  remainingBalance {
-    ...Money
-  }
-}
-```
-
-### Fragment: `Checkout` on `Checkout`
-
-**Section**: Checkout
-
-**Description**: Full checkout shape — line items, shipping + billing addresses, selected + available shipping rates, available payment methods, applied discounts + gift cards, tax lines, totals (`cost`, `paymentDue`, `totalGiftCardAmount`). Spread on the checkout flow; refetch after every checkout mutation. `isReady` flips to true when the checkout has all required fields to call `checkoutComplete`.
-
-**Uses fragments**: `AppliedGiftCard`, `CheckoutLineItem`, `DiscountApplication`, `DiscountCode`, `MailingAddress`, `Money`, `PaymentMethod`, `ShippingRate`, `TaxLine`
-
-**GraphQL**:
-```graphql
-fragment Checkout on Checkout {
-  id
-  isReady
-  isCompleted
-  completedOrderId
-  webUrl
-  lineItems {
-    ...CheckoutLineItem
-  }
-  totalQuantity
-  shippingAddress {
-    ...MailingAddress
-  }
-  billingAddress {
-    ...MailingAddress
-  }
-  shippingLine {
-    ...ShippingRate
-  }
-  availableShippingRates {
-    ...ShippingRate
-  }
-  shippingRatesReady
-  email
-  phone
-  customerId
-  discountCodes {
-    ...DiscountCode
-  }
-  discountApplications {
-    ...DiscountApplication
-  }
-  availablePaymentMethods {
-    ...PaymentMethod
-  }
-  selectedPaymentMethodId
-  cost {
-    subtotal {
-      ...Money
-    }
-    total {
-      ...Money
-    }
-    totalTax {
-      ...Money
-    }
-    totalShipping {
-      ...Money
-    }
-    totalDiscounts {
-      ...Money
-    }
-  }
-  taxLines {
-    ...TaxLine
-  }
-  appliedGiftCards {
-    ...AppliedGiftCard
-  }
-  totalGiftCardAmount {
-    ...Money
-  }
-  paymentDue {
-    ...Money
-  }
-  currencyCode
-  note
-  createdAt
-  updatedAt
-}
-```
-
 ### Fragment: `ShipmentEvent` on `ShipmentEvent`
 
 **Section**: Shipments / Tracking