@doswiftly/storefront-operations 8.0.0 → 10.0.0

package/operations.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "8.0.0",
+  "schemaVersion": "10.0.0",
   "queries": [
     {
       "name": "Shop",
@@ -325,21 +325,24 @@
       "body": "query CustomerOrder($orderId: ID!) {\n  customerOrder(orderId: $orderId) {\n    ...Order\n  }\n}"
     },
     {
-      "name": "Checkout",
+      "name": "CartValidateDiscountCode",
       "kind": "query",
-      "section": "Checkout",
-      "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.",
+      "section": "Discount Code Validation",
+      "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": [
         {
-          "name": "id",
+          "name": "cartId",
           "type": "ID!",
           "defaultValue": null
+        },
+        {
+          "name": "discountCode",
+          "type": "String!",
+          "defaultValue": null
         }
       ],
-      "fragmentRefs": [
-        "Checkout"
-      ],
-      "body": "query Checkout($id: ID!) {\n  checkout(id: $id) {\n    ...Checkout\n  }\n}"
+      "fragmentRefs": [],
+      "body": "query CartValidateDiscountCode($cartId: ID!, $discountCode: String!) {\n  cartValidateDiscountCode(cartId: $cartId, discountCode: $discountCode) {\n    isValid\n    discount {\n      code\n      title\n      type\n      value\n      discountAmount {\n        amount\n        currencyCode\n      }\n    }\n    error {\n      code\n      message\n    }\n  }\n}"
     },
     {
       "name": "AvailablePaymentMethods",
@@ -1095,10 +1098,10 @@
       "body": "mutation CartRemoveLines($id: ID!, $lineIds: [ID!]!) {\n  cartRemoveLines(id: $id, lineIds: $lineIds) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CartApplyDiscountCodes",
+      "name": "CartDiscountCodesUpdate",
       "kind": "mutation",
       "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": [
         {
           "name": "id",
@@ -1116,7 +1119,7 @@
         "CartWarning",
         "UserError"
       ],
-      "body": "mutation CartApplyDiscountCodes($id: ID!, $discountCodes: [String!]!) {\n  cartApplyDiscountCodes(id: $id, discountCodes: $discountCodes) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
+      "body": "mutation CartDiscountCodesUpdate($id: ID!, $discountCodes: [String!]!) {\n  cartDiscountCodesUpdate(id: $id, discountCodes: $discountCodes) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
       "name": "CartUpdateBuyerIdentity",
@@ -1386,293 +1389,157 @@
       "body": "mutation CustomerResetPassword($token: String!, $newPassword: String!) {\n  customerResetPassword(token: $token, newPassword: $newPassword) {\n    customer {\n      ...Customer\n    }\n    customerAccessToken {\n      ...CustomerAccessToken\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutCreate",
+      "name": "CartSetShippingAddress",
       "kind": "mutation",
-      "section": "Checkout 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.",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
           "name": "input",
-          "type": "CheckoutCreateInput!",
-          "defaultValue": null
-        }
-      ],
-      "fragmentRefs": [
-        "Checkout",
-        "UserError"
-      ],
-      "body": "mutation CheckoutCreate($input: CheckoutCreateInput!) {\n  checkoutCreate(input: $input) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
-    },
-    {
-      "name": "CheckoutUpdateShippingAddress",
-      "kind": "mutation",
-      "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": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "shippingAddress",
-          "type": "CheckoutAddressInput!",
-          "defaultValue": null
-        }
-      ],
-      "fragmentRefs": [
-        "Checkout",
-        "UserError"
-      ],
-      "body": "mutation CheckoutUpdateShippingAddress($id: ID!, $shippingAddress: CheckoutAddressInput!) {\n  checkoutUpdateShippingAddress(id: $id, shippingAddress: $shippingAddress) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
-    },
-    {
-      "name": "CheckoutUpdateBillingAddress",
-      "kind": "mutation",
-      "section": "Checkout Mutations",
-      "description": "Sets the billing address (full replace). Independent of shipping address — pass it explicitly even when \"billing same as shipping\".",
-      "variables": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "billingAddress",
-          "type": "CheckoutAddressInput!",
-          "defaultValue": null
-        }
-      ],
-      "fragmentRefs": [
-        "Checkout",
-        "UserError"
-      ],
-      "body": "mutation CheckoutUpdateBillingAddress($id: ID!, $billingAddress: CheckoutAddressInput!) {\n  checkoutUpdateBillingAddress(id: $id, billingAddress: $billingAddress) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
-    },
-    {
-      "name": "CheckoutUpdateEmail",
-      "kind": "mutation",
-      "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": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "email",
-          "type": "String!",
+          "type": "CartSetShippingAddressInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
-        "UserError"
-      ],
-      "body": "mutation CheckoutUpdateEmail($id: ID!, $email: String!) {\n  checkoutUpdateEmail(id: $id, email: $email) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
-    },
-    {
-      "name": "CheckoutSelectShippingRate",
-      "kind": "mutation",
-      "section": "Checkout 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.",
-      "variables": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "rateId",
-          "type": "String!",
-          "defaultValue": null
-        }
-      ],
-      "fragmentRefs": [
-        "Checkout",
-        "UserError"
-      ],
-      "body": "mutation CheckoutSelectShippingRate($id: ID!, $rateId: String!) {\n  checkoutSelectShippingRate(id: $id, rateId: $rateId) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
-    },
-    {
-      "name": "CheckoutApplyDiscountCode",
-      "kind": "mutation",
-      "section": "Checkout 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.",
-      "variables": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "discountCode",
-          "type": "String!",
-          "defaultValue": null
-        }
-      ],
-      "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutApplyDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutApplyDiscountCode(id: $id, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartSetShippingAddress($input: CartSetShippingAddressInput!) {\n  cartSetShippingAddress(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutRemoveDiscountCode",
+      "name": "CartSetBillingAddress",
       "kind": "mutation",
-      "section": "Checkout Mutations",
-      "description": "Removes a code from the cart's `discount_codes` array (filters by exact match). Triggers re-pricing.",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "discountCode",
-          "type": "String!",
+          "name": "input",
+          "type": "CartSetBillingAddressInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutRemoveDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutRemoveDiscountCode(id: $id, discountCode: $discountCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartSetBillingAddress($input: CartSetBillingAddressInput!) {\n  cartSetBillingAddress(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutValidateDiscountCode",
+      "name": "CartSelectShippingMethod",
       "kind": "mutation",
-      "section": "Checkout 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).",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "discountCode",
-          "type": "String!",
+          "name": "input",
+          "type": "CartSelectShippingMethodInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutValidateDiscountCode($id: ID!, $discountCode: String!) {\n  checkoutValidateDiscountCode(id: $id, discountCode: $discountCode) {\n    result {\n      isValid\n      discount {\n        code\n        title\n        type\n        value\n        discountAmount {\n          amount\n          currencyCode\n        }\n      }\n      error {\n        code\n        message\n      }\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartSelectShippingMethod($input: CartSelectShippingMethodInput!) {\n  cartSelectShippingMethod(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutSelectPaymentMethod",
+      "name": "CartSelectPaymentMethod",
       "kind": "mutation",
-      "section": "Checkout Mutations",
-      "description": "Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence and active status; no pre-authorization is performed here.",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "paymentMethodId",
-          "type": "ID!",
+          "name": "input",
+          "type": "CartSelectPaymentMethodInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutSelectPaymentMethod($id: ID!, $paymentMethodId: ID!) {\n  checkoutSelectPaymentMethod(id: $id, paymentMethodId: $paymentMethodId) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartSelectPaymentMethod($input: CartSelectPaymentMethodInput!) {\n  cartSelectPaymentMethod(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutComplete",
+      "name": "CartApplyGiftCard",
       "kind": "mutation",
-      "section": "Checkout 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.",
+      "section": "Cart Completion 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 `cartComplete`. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`.",
       "variables": [
-        {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
         {
           "name": "input",
-          "type": "CheckoutCompleteInput",
+          "type": "CartApplyGiftCardInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
-        "Order",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutComplete($id: ID!, $input: CheckoutCompleteInput) {\n  checkoutComplete(id: $id, input: $input) {\n    checkout {\n      ...Checkout\n    }\n    order {\n      ...Order\n    }\n    paymentUrl\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartApplyGiftCard($input: CartApplyGiftCardInput!) {\n  cartApplyGiftCard(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutApplyGiftCard",
+      "name": "CartRemoveGiftCard",
       "kind": "mutation",
-      "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`.",
+      "section": "Cart Completion 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 `cartComplete`, removing before completion has no effect on the underlying gift card balance.",
       "variables": [
         {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "giftCardCode",
-          "type": "String!",
+          "name": "input",
+          "type": "CartRemoveGiftCardInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutApplyGiftCard($id: ID!, $giftCardCode: String!) {\n  checkoutApplyGiftCard(id: $id, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartRemoveGiftCard($input: CartRemoveGiftCardInput!) {\n  cartRemoveGiftCard(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutRemoveGiftCard",
+      "name": "CartUpdateGiftCardRecipient",
       "kind": "mutation",
-      "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.",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
-          "name": "id",
-          "type": "ID!",
-          "defaultValue": null
-        },
-        {
-          "name": "giftCardCode",
-          "type": "String!",
+          "name": "input",
+          "type": "CartUpdateGiftCardRecipientInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
         "UserError"
       ],
-      "body": "mutation CheckoutRemoveGiftCard($id: ID!, $giftCardCode: String!) {\n  checkoutRemoveGiftCard(id: $id, giftCardCode: $giftCardCode) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartUpdateGiftCardRecipient($input: CartUpdateGiftCardRecipientInput!) {\n  cartUpdateGiftCardRecipient(input: $input) {\n    cart {\n      ...Cart\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
-      "name": "CheckoutUpdateGiftCardRecipient",
+      "name": "CartComplete",
       "kind": "mutation",
-      "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.",
+      "section": "Cart Completion Mutations",
+      "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": [
         {
           "name": "input",
-          "type": "CheckoutGiftCardRecipientInput!",
+          "type": "CartCompleteInput!",
           "defaultValue": null
         }
       ],
       "fragmentRefs": [
-        "Checkout",
+        "Cart",
+        "CartWarning",
+        "Order",
         "UserError"
       ],
-      "body": "mutation CheckoutUpdateGiftCardRecipient($input: CheckoutGiftCardRecipientInput!) {\n  checkoutUpdateGiftCardRecipient(input: $input) {\n    checkout {\n      ...Checkout\n    }\n    userErrors {\n      ...UserError\n    }\n  }\n}"
+      "body": "mutation CartComplete($input: CartCompleteInput!) {\n  cartComplete(input: $input) {\n    cart {\n      ...Cart\n    }\n    order {\n      ...Order\n    }\n    userErrors {\n      ...UserError\n    }\n    warnings {\n      ...CartWarning\n    }\n  }\n}"
     },
     {
       "name": "ReturnCreate",
@@ -2075,7 +1942,7 @@
       "description": "Customer mailing address — full street/city/state/country/postal code with names and phone. `isDefault` flips when this address is the default for shipping. Spread on the address book UI and order summaries.",
       "variables": [],
       "fragmentRefs": [],
-      "body": "fragment MailingAddress on MailingAddress {\n  id\n  streetLine1\n  streetLine2\n  city\n  company\n  country\n  countryCode\n  firstName\n  lastName\n  phone\n  state\n  stateCode\n  postalCode\n  isDefault\n}",
+      "body": "fragment MailingAddress on MailingAddress {\n  id\n  streetLine1\n  streetLine2\n  city\n  company\n  country\n  countryCode\n  firstName\n  lastName\n  name\n  phone\n  state\n  stateCode\n  postalCode\n  isDefault\n}",
       "onType": "MailingAddress"
     },
     {
@@ -2105,13 +1972,13 @@
       "name": "Order",
       "kind": "fragment",
       "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.",
       "variables": [],
       "fragmentRefs": [
         "MailingAddress",
         "Money"
       ],
-      "body": "fragment Order on Order {\n  id\n  orderNumber\n  totals {\n    total {\n      ...Money\n    }\n    subtotal {\n      ...Money\n    }\n    totalTax {\n      ...Money\n    }\n    totalShipping {\n      ...Money\n    }\n  }\n  status\n  paymentStatus\n  fulfillmentStatus\n  processedAt\n  confirmedAt\n  cancelledAt\n  expiredAt\n  shippingAddress {\n    ...MailingAddress\n  }\n  itemCount\n}",
+      "body": "fragment Order on Order {\n  id\n  orderNumber\n  totals {\n    total {\n      ...Money\n    }\n    subtotal {\n      ...Money\n    }\n    totalTax {\n      ...Money\n    }\n    totalShipping {\n      ...Money\n    }\n  }\n  status\n  paymentStatus\n  fulfillmentStatus\n  processedAt\n  confirmedAt\n  cancelledAt\n  expiredAt\n  shippingAddress {\n    ...MailingAddress\n  }\n  itemCount\n  canCreatePayment\n  paymentMethodType\n}",
       "onType": "Order"
     },
     {
@@ -2198,19 +2065,57 @@
       "name": "Cart",
       "kind": "fragment",
       "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.",
       "variables": [],
       "fragmentRefs": [
+        "CartAppliedGiftCard",
         "CartBuyerIdentity",
         "CartCost",
         "CartDiscountAllocation",
         "CartDiscountCode",
         "CartLine",
+        "CartSelectedPaymentMethod",
+        "CartShippingMethod",
+        "MailingAddress",
         "PageInfo"
       ],
-      "body": "fragment Cart on Cart {\n  id\n  checkoutUrl\n  totalQuantity\n  cost {\n    ...CartCost\n  }\n  lines(first: 100) {\n    edges {\n      cursor\n      node {\n        ... on CartLine {\n          ...CartLine\n        }\n      }\n    }\n    nodes {\n      ... on CartLine {\n        ...CartLine\n      }\n    }\n    pageInfo {\n      ...PageInfo\n    }\n    totalCount\n  }\n  buyerIdentity {\n    ...CartBuyerIdentity\n  }\n  discountCodes {\n    ...CartDiscountCode\n  }\n  discountAllocations {\n    ...CartDiscountAllocation\n  }\n  note\n  attributes {\n    key\n    value\n  }\n  createdAt\n  updatedAt\n}",
+      "body": "fragment Cart on Cart {\n  id\n  checkoutUrl\n  totalQuantity\n  cost {\n    ...CartCost\n  }\n  lines(first: 100) {\n    edges {\n      cursor\n      node {\n        ... on CartLine {\n          ...CartLine\n        }\n      }\n    }\n    nodes {\n      ... on CartLine {\n        ...CartLine\n      }\n    }\n    pageInfo {\n      ...PageInfo\n    }\n    totalCount\n  }\n  buyerIdentity {\n    ...CartBuyerIdentity\n  }\n  discountCodes {\n    ...CartDiscountCode\n  }\n  discountAllocations {\n    ...CartDiscountAllocation\n  }\n  note\n  attributes {\n    key\n    value\n  }\n  email\n  phone\n  shippingAddress {\n    ...MailingAddress\n  }\n  billingAddress {\n    ...MailingAddress\n  }\n  selectedShippingMethod {\n    ...CartShippingMethod\n  }\n  selectedPaymentMethod {\n    ...CartSelectedPaymentMethod\n  }\n  appliedGiftCards {\n    ...CartAppliedGiftCard\n  }\n  createdAt\n  updatedAt\n}",
       "onType": "Cart"
     },
+    {
+      "name": "CartShippingMethod",
+      "kind": "fragment",
+      "section": "Cart",
+      "description": "Shipping method selected on a cart (D8 term unification — wcześniej ShippingRate). Returned przez `cart.selectedShippingMethod` po `cartSelectShippingMethod` mutation.",
+      "variables": [],
+      "fragmentRefs": [
+        "Money"
+      ],
+      "body": "fragment CartShippingMethod on CartShippingMethod {\n  handle\n  title\n  price {\n    ...Money\n  }\n}",
+      "onType": "CartShippingMethod"
+    },
+    {
+      "name": "CartAppliedGiftCard",
+      "kind": "fragment",
+      "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`.",
+      "variables": [],
+      "fragmentRefs": [
+        "Money"
+      ],
+      "body": "fragment CartAppliedGiftCard on CartAppliedGiftCard {\n  maskedCode\n  lastCharacters\n  appliedAmount {\n    ...Money\n  }\n  remainingBalance {\n    ...Money\n  }\n}",
+      "onType": "CartAppliedGiftCard"
+    },
+    {
+      "name": "CartSelectedPaymentMethod",
+      "kind": "fragment",
+      "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.",
+      "variables": [],
+      "fragmentRefs": [],
+      "body": "fragment CartSelectedPaymentMethod on PaymentMethod {\n  id\n  name\n  provider\n  type\n  icon\n  description\n  isDefault\n  supportedCurrencies\n  position\n}",
+      "onType": "PaymentMethod"
+    },
     {
       "name": "ShopColors",
       "kind": "fragment",
@@ -2336,110 +2241,6 @@
       "body": "fragment AvailablePaymentMethods on AvailablePaymentMethods {\n  methods {\n    ...PaymentMethod\n  }\n  defaultMethod {\n    ...PaymentMethod\n  }\n}",
       "onType": "AvailablePaymentMethods"
     },
-    {
-      "name": "ShippingRate",
-      "kind": "fragment",
-      "section": "Checkout",
-      "description": "Single shipping rate option — `handle` is the stable id you pass to `checkoutSelectShippingRate` as `rateId`, plus title and price.",
-      "variables": [],
-      "fragmentRefs": [
-        "Money"
-      ],
-      "body": "fragment ShippingRate on ShippingRate {\n  handle\n  title\n  price {\n    ...Money\n  }\n}",
-      "onType": "ShippingRate"
-    },
-    {
-      "name": "TaxLine",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "Money"
-      ],
-      "body": "fragment TaxLine on TaxLine {\n  title\n  rate\n  price {\n    ...Money\n  }\n}",
-      "onType": "TaxLine"
-    },
-    {
-      "name": "DiscountAffectedItem",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "Money"
-      ],
-      "body": "fragment DiscountAffectedItem on DiscountAffectedItem {\n  productId\n  variantId\n  title\n  quantity\n  originalPrice {\n    ...Money\n  }\n  discountedPrice {\n    ...Money\n  }\n  savings {\n    ...Money\n  }\n  isFreeItem\n}",
-      "onType": "DiscountAffectedItem"
-    },
-    {
-      "name": "DiscountApplication",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "DiscountAffectedItem",
-        "Money"
-      ],
-      "body": "fragment DiscountApplication on DiscountApplication {\n  code\n  isApplicable\n  type\n  value {\n    ...Money\n  }\n  title\n  affectedItems {\n    ...DiscountAffectedItem\n  }\n  buyQuantity\n  getQuantity\n  getDiscountPercent\n}",
-      "onType": "DiscountApplication"
-    },
-    {
-      "name": "DiscountCode",
-      "kind": "fragment",
-      "section": "Checkout",
-      "description": "Lightweight discount code entry on the checkout — code + applicability flag.",
-      "variables": [],
-      "fragmentRefs": [],
-      "body": "fragment DiscountCode on DiscountCode {\n  code\n  isApplicable\n}",
-      "onType": "DiscountCode"
-    },
-    {
-      "name": "CheckoutLineItem",
-      "kind": "fragment",
-      "section": "Checkout",
-      "description": "Single line item in the checkout — variant snapshot, quantity, unit + total prices, image. Use on the order summary panel.",
-      "variables": [],
-      "fragmentRefs": [
-        "ImageThumbnail",
-        "Money"
-      ],
-      "body": "fragment CheckoutLineItem on CheckoutLineItem {\n  id\n  title\n  variantTitle\n  quantity\n  pricePerUnit {\n    ...Money\n  }\n  total {\n    ...Money\n  }\n  variantId\n  productId\n  sku\n  image {\n    ...ImageThumbnail\n  }\n}",
-      "onType": "CheckoutLineItem"
-    },
-    {
-      "name": "AppliedGiftCard",
-      "kind": "fragment",
-      "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.",
-      "variables": [],
-      "fragmentRefs": [
-        "Money"
-      ],
-      "body": "fragment AppliedGiftCard on AppliedGiftCard {\n  maskedCode\n  lastCharacters\n  appliedAmount {\n    ...Money\n  }\n  remainingBalance {\n    ...Money\n  }\n}",
-      "onType": "AppliedGiftCard"
-    },
-    {
-      "name": "Checkout",
-      "kind": "fragment",
-      "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`.",
-      "variables": [],
-      "fragmentRefs": [
-        "AppliedGiftCard",
-        "CheckoutLineItem",
-        "DiscountApplication",
-        "DiscountCode",
-        "MailingAddress",
-        "Money",
-        "PaymentMethod",
-        "ShippingRate",
-        "TaxLine"
-      ],
-      "body": "fragment Checkout on Checkout {\n  id\n  isReady\n  isCompleted\n  completedOrderId\n  webUrl\n  lineItems {\n    ...CheckoutLineItem\n  }\n  totalQuantity\n  shippingAddress {\n    ...MailingAddress\n  }\n  billingAddress {\n    ...MailingAddress\n  }\n  shippingLine {\n    ...ShippingRate\n  }\n  availableShippingRates {\n    ...ShippingRate\n  }\n  shippingRatesReady\n  email\n  phone\n  customerId\n  discountCodes {\n    ...DiscountCode\n  }\n  discountApplications {\n    ...DiscountApplication\n  }\n  availablePaymentMethods {\n    ...PaymentMethod\n  }\n  selectedPaymentMethodId\n  cost {\n    subtotal {\n      ...Money\n    }\n    total {\n      ...Money\n    }\n    totalTax {\n      ...Money\n    }\n    totalShipping {\n      ...Money\n    }\n    totalDiscounts {\n      ...Money\n    }\n  }\n  taxLines {\n    ...TaxLine\n  }\n  appliedGiftCards {\n    ...AppliedGiftCard\n  }\n  totalGiftCardAmount {\n    ...Money\n  }\n  paymentDue {\n    ...Money\n  }\n  currencyCode\n  note\n  createdAt\n  updatedAt\n}",
-      "onType": "Checkout"
-    },
     {
       "name": "ShipmentEvent",
       "kind": "fragment",