@doswiftly/storefront-operations 9.1.0 → 11.0.0

package/schema.graphql

@@ -32,21 +32,6 @@ directive @inContext(
   preferredLocationId: ID
 ) on MUTATION | QUERY | SUBSCRIPTION
 
-"""Gift card applied to checkout"""
-type AppliedGiftCard {
-  """Amount applied to this checkout"""
-  appliedAmount: Money!
-
-  """Last 4 characters of the gift card code"""
-  lastCharacters: String!
-
-  """Masked gift card code for display (e.g., "****-****-****-ABCD")"""
-  maskedCode: String!
-
-  """Remaining balance on the gift card after this checkout"""
-  remainingBalance: Money!
-}
-
 """Generic attribute"""
 type Attribute {
   """Attribute key"""
@@ -709,9 +694,20 @@ type CarrierShippingRate {
 
 """Shopping cart"""
 type Cart implements Node {
+  """Gift cards applied do tego koszyka (debited at cartComplete)"""
+  appliedGiftCards: [CartAppliedGiftCard!]!
+
   """Cart attributes"""
   attributes: [CartAttribute!]!
 
+  """Available payment methods dla tego cart (shop-configured providers)"""
+  availablePaymentMethods: [PaymentMethod!]!
+
+  """
+  Billing address ustawiony przez cartSetBillingAddress (jeśli różny od shipping)
+  """
+  billingAddress: MailingAddress
+
   """Buyer identity information"""
   buyerIdentity: CartBuyerIdentity
 
@@ -730,6 +726,11 @@ type Cart implements Node {
   """Applied discount codes"""
   discountCodes: [CartDiscountCode!]!
 
+  """
+  Customer email (D2 — persisted via cartUpdateBuyerIdentity). Convenience accessor; pełen kontekst w buyerIdentity.email.
+  """
+  email: String
+
   """Unique cart identifier"""
   id: ID!
 
@@ -739,9 +740,25 @@ type Cart implements Node {
   """Cart note"""
   note: String
 
+  """
+  Customer phone (D2). Convenience accessor; pełen kontekst w buyerIdentity.phone.
+  """
+  phone: String
+
   """Product recommendations based on cart contents"""
   recommendations(first: Int = 4): CartRecommendations
 
+  """Selected payment method (PayU/Stripe/COD/etc.)"""
+  selectedPaymentMethod: PaymentMethod
+
+  """
+  Selected shipping method (D8 term unification — wcześniej selectedShippingRate)
+  """
+  selectedShippingMethod: CartShippingMethod
+
+  """Shipping address ustawiony przez cartSetShippingAddress"""
+  shippingAddress: MailingAddress
+
   """Total quantity of all items"""
   totalQuantity: Int!
 
@@ -763,13 +780,70 @@ type CartAddLinesPayload {
   warnings: [CartWarning!]!
 }
 
-"""Result of applying discount codes"""
-type CartApplyDiscountCodesPayload {
-  """Updated cart"""
+"""Mailing address input dla cart fulfillment mutations"""
+input CartAddressInput {
+  """City"""
+  city: String!
+
+  """Company name"""
+  company: String
+
+  """ISO 3166-1 alpha-2 country code"""
+  country: CountryCode!
+
+  """First name"""
+  firstName: String
+
+  """Last name"""
+  lastName: String
+
+  """Phone number"""
+  phone: String
+
+  """Postal / ZIP code"""
+  postalCode: String!
+
+  """State / province"""
+  state: String
+
+  """First line of street address"""
+  streetLine1: String!
+
+  """Second line of street address"""
+  streetLine2: String
+}
+
+"""Gift card applied to a cart"""
+type CartAppliedGiftCard {
+  """Amount applied to this cart"""
+  appliedAmount: Money!
+
+  """Last 4 characters of the gift card code"""
+  lastCharacters: String!
+
+  """Masked gift card code for display (np. "****-****-****-ABCD")"""
+  maskedCode: String!
+
+  """Remaining balance on the gift card after this cart"""
+  remainingBalance: Money!
+}
+
+"""Input dla cartApplyGiftCard mutation"""
+input CartApplyGiftCardInput {
+  """Cart ID"""
+  cartId: ID!
+
+  """Gift card code (np. ABCD-1234-EFGH-5678)"""
+  giftCardCode: String!
+}
+
+"""Result of applying gift card to cart"""
+type CartApplyGiftCardPayload {
+  """Updated cart z appliedGiftCards"""
   cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  User errors (CartErrorCode-namespaced — np. GIFT_CARD_NOT_FOUND, GIFT_CARD_DEPLETED, GIFT_CARD_UNUSABLE)
   """
   userErrors: [UserError!]!
 
@@ -831,6 +905,35 @@ input CartBuyerIdentityInput {
   phone: String
 }
 
+"""Input dla cartComplete mutation — finalizuje cart do Order"""
+input CartCompleteInput {
+  """Cart ID do skompletowania"""
+  cartId: ID!
+
+  """
+  Optional idempotency key — zapobiega duplicate Orders przy retry / network issue (jeśli null, generowany z cartId + minute timestamp)
+  """
+  idempotencyKey: String
+}
+
+"""
+Result of completing cart — transition cart → order (per D4 NO paymentUrl). Cart NIE w payload — po complete koszyk jest CONVERTED/locked.
+"""
+type CartCompletePayload {
+  """
+  Order created z cart. Zapewnia canCreatePayment + paymentMethodType (Phase 4 ResolveFields) dla decyzji storefront przycisku "Zapłać".
+  """
+  order: Order
+
+  """
+  User errors (CartErrorCode-namespaced — np. INSUFFICIENT_STOCK, SHIPPING_ADDRESS_REQUIRED, PAYMENT_METHOD_REQUIRED, EMAIL_REQUIRED)
+  """
+  userErrors: [UserError!]!
+
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
+}
+
 """Cart cost breakdown"""
 type CartCost {
   """Checkout charge amount."""
@@ -875,11 +978,17 @@ input CartCreateInput {
   """Discount codes to apply"""
   discountCodes: [String!]
 
+  """Customer email (Phase 3 D2 — merge funkcjonalności checkoutCreate)"""
+  email: String
+
   """Initial cart lines"""
   lines: [CartLineInput!]
 
   """Cart note"""
   note: String
+
+  """Shipping address (Phase 3 — fulfillment context w jednym round-trip)"""
+  shippingAddress: CartAddressInput
 }
 
 """Result of cart creation"""
@@ -914,6 +1023,20 @@ type CartDiscountCode {
   isApplicable: Boolean!
 }
 
+"""Result of applying discount codes"""
+type CartDiscountCodesUpdatePayload {
+  """Updated cart"""
+  cart: Cart
+
+  """
+  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  """
+  userErrors: [UserError!]!
+
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
+}
+
 """Single line item in the cart"""
 type CartLine {
   """Typed customer-filled attribute selections (surcharge + tax snapshot)"""
@@ -1039,34 +1162,29 @@ type CartRecommendations {
   youMayAlsoLike: [ProductRecommendation!]!
 }
 
-"""Result of removing cart lines"""
-type CartRemoveLinesPayload {
-  """Updated cart"""
+"""Input dla cartRemoveGiftCard mutation"""
+input CartRemoveGiftCardInput {
+  """Cart ID"""
+  cartId: ID!
+
+  """Gift card code (matching wartości aplikowanej karty)"""
+  giftCardCode: String!
+}
+
+"""Result of removing gift card from cart"""
+type CartRemoveGiftCardPayload {
+  """Updated cart (gift card usunięty z appliedGiftCards)"""
   cart: Cart
 
-  """
-  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
-  """
+  """User errors (CartErrorCode-namespaced)"""
   userErrors: [UserError!]!
 
   """Non-fatal warnings"""
   warnings: [CartWarning!]!
 }
 
-"""Cart data for shipping calculation"""
-input CartShippingInput {
-  """Currency code (ISO 4217)"""
-  currencyCode: String
-
-  """Cart subtotal in cents"""
-  subtotal: Int
-
-  """Total weight in grams"""
-  totalWeight: Int
-}
-
-"""Result of updating cart attributes"""
-type CartUpdateAttributesPayload {
+"""Result of removing cart lines"""
+type CartRemoveLinesPayload {
   """Updated cart"""
   cart: Cart
 
@@ -1079,13 +1197,22 @@ type CartUpdateAttributesPayload {
   warnings: [CartWarning!]!
 }
 
-"""Result of updating buyer identity"""
-type CartUpdateBuyerIdentityPayload {
-  """Updated cart"""
+"""Input dla cartSelectPaymentMethod mutation"""
+input CartSelectPaymentMethodInput {
+  """Cart ID"""
+  cartId: ID!
+
+  """Payment method (integration provider) ID"""
+  paymentMethodId: ID!
+}
+
+"""Result of selecting payment method on cart"""
+type CartSelectPaymentMethodPayload {
+  """Updated cart (selectedPaymentMethod populated)"""
   cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  User errors (CartErrorCode-namespaced — np. PAYMENT_METHOD_REQUIRED, INVALID_PAYMENT)
   """
   userErrors: [UserError!]!
 
@@ -1093,27 +1220,24 @@ type CartUpdateBuyerIdentityPayload {
   warnings: [CartWarning!]!
 }
 
-"""Result of updating cart lines"""
-type CartUpdateLinesPayload {
-  """Updated cart"""
-  cart: Cart
+"""Input dla cartSelectShippingMethod mutation (D8 term unification)"""
+input CartSelectShippingMethodInput {
+  """Cart ID"""
+  cartId: ID!
 
   """
-  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  Shipping method ID (handle z available shipping methods query). Typed ID! per D8 rename argument rateId → shippingMethodId.
   """
-  userErrors: [UserError!]!
-
-  """Non-fatal warnings"""
-  warnings: [CartWarning!]!
+  shippingMethodId: ID!
 }
 
-"""Result of updating cart note"""
-type CartUpdateNotePayload {
-  """Updated cart"""
+"""Result of selecting shipping method on cart (D8 term unification)"""
+type CartSelectShippingMethodPayload {
+  """Updated cart (selectedShippingMethod populated)"""
   cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  User errors (CartErrorCode-namespaced — np. SHIPPING_METHOD_REQUIRED, ZIP_CODE_NOT_SUPPORTED)
   """
   userErrors: [UserError!]!
 
@@ -1121,496 +1245,272 @@ type CartUpdateNotePayload {
   warnings: [CartWarning!]!
 }
 
-"""Cart warning (non-fatal advisory)"""
-type CartWarning {
-  """Typed warning code"""
-  code: CartWarningCode!
-
-  """Warning message"""
-  message: String!
-
-  """Target identifier (cart line ID lub field path)"""
-  target: String!
-}
-
-"""Non-fatal cart warnings"""
-enum CartWarningCode {
-  MERCHANDISE_NOT_AVAILABLE
-  MERCHANDISE_NOT_ENOUGH_STOCK
-  PAYMENTS_AMOUNT_REGION_MISMATCH
-}
-
-"""Product category - hierarchical organization"""
-type Category {
-  """Child categories"""
-  children: [Category!]!
-
-  """Category description"""
-  description: String
-
-  """Unique identifier"""
-  id: ID!
-
-  """Category image"""
-  image: Image
-
-  """Depth level in hierarchy (0 = root)"""
-  level: Int!
-
-  """Category name"""
-  name: String!
-
-  """Parent category (null for root)"""
-  parent: Category
-
-  """Full path (e.g., "Electronics/Phones/Smartphones")"""
-  path: String!
-
-  """Number of products in category"""
-  productCount: Int!
-
-  """Products in category"""
-  products(after: String, first: Float! = 20): CategoryConnection!
-
-  """SEO metadata"""
-  seo: SEO
-
-  """URL-friendly slug"""
-  slug: String!
+"""Input dla cartSetBillingAddress mutation"""
+input CartSetBillingAddressInput {
+  """Billing address (zostawia shipping bez zmian)"""
+  address: CartAddressInput!
 
-  """Sort order within parent"""
-  sortOrder: Int!
+  """Cart ID"""
+  cartId: ID!
 }
 
-"""Paginated category list (Relay Connection)"""
-type CategoryConnection {
-  """List of category edges (cursor + node pairs)"""
-  edges: [CategoryEdge!]!
-
-  """List of category nodes (shortcut without cursor)"""
-  nodes: [Category!]!
+"""Result of setting cart billing address"""
+type CartSetBillingAddressPayload {
+  """Updated cart"""
+  cart: Cart
 
-  """Pagination info"""
-  pageInfo: PageInfo!
+  """User errors (CartErrorCode-namespaced)"""
+  userErrors: [UserError!]!
 
-  """Total count of categories"""
-  totalCount: Int!
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
 }
 
-"""Category edge in connection"""
-type CategoryEdge {
-  """Cursor for pagination"""
-  cursor: String!
-
-  """Category node"""
-  node: Category!
-}
+"""Input dla cartSetShippingAddress mutation"""
+input CartSetShippingAddressInput {
+  """Shipping address"""
+  address: CartAddressInput!
 
-"""Category filter"""
-input CategoryFilter {
-  """Category ID"""
-  id: ID
+  """Cart ID"""
+  cartId: ID!
 }
 
-"""Category filter option"""
-type CategoryFilterOption {
-  """Category ID"""
-  id: ID!
-
-  """Nesting level (0 = root)"""
-  level: Int!
-
-  """Category name"""
-  name: String!
-
-  """Parent category ID"""
-  parentId: ID
+"""Result of setting cart shipping address"""
+type CartSetShippingAddressPayload {
+  """Updated cart"""
+  cart: Cart
 
-  """Number of products in this category"""
-  productCount: Int!
+  """
+  User errors (CartErrorCode-namespaced — np. INVALID_ADDRESS, EMAIL_REQUIRED)
+  """
+  userErrors: [UserError!]!
 
-  """URL-friendly slug"""
-  slug: String!
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
 }
 
-"""Checkout object"""
-type Checkout {
-  """Applied gift cards"""
-  appliedGiftCards: [AppliedGiftCard!]!
-
-  """Available payment methods (Requirements: R23.1, R23.2)"""
-  availablePaymentMethods: [PaymentMethod!]!
-
-  """Available shipping rates"""
-  availableShippingRates: [ShippingRate!]!
-
-  """Billing address"""
-  billingAddress: MailingAddress
-
-  """Completed order ID"""
-  completedOrderId: String
-
-  """Cost breakdown (subtotal/total/totalTax/totalShipping/totalDiscounts)"""
-  cost: CheckoutCost!
-
-  """Created at"""
-  createdAt: DateTime!
-
-  """Currency code"""
-  currencyCode: String!
-
-  """Customer ID"""
-  customerId: String
-
-  """Applied discounts with details"""
-  discountApplications: [DiscountApplication!]!
-
-  """Applied discount codes"""
-  discountCodes: [DiscountCode!]!
-
-  """Customer email"""
-  email: String
-
-  """Checkout ID"""
-  id: ID!
-
-  """Whether checkout is completed"""
-  isCompleted: Boolean!
-
-  """Whether checkout is ready for payment"""
-  isReady: Boolean!
-
-  """Line items"""
-  lineItems: [CheckoutLineItem!]!
-
-  """Order note"""
-  note: String
-
-  """Amount due for payment after gift cards applied"""
-  paymentDue: Money!
-
-  """Customer phone"""
-  phone: String
-
-  """Selected payment method ID (Requirements: R23.5)"""
-  selectedPaymentMethodId: ID
-
-  """Shipping address"""
-  shippingAddress: MailingAddress
-
-  """Selected shipping rate"""
-  shippingLine: ShippingRate
-
-  """Whether shipping rates are ready"""
-  shippingRatesReady: Boolean!
-
-  """Tax breakdown"""
-  taxLines: [TaxLine!]!
-
-  """Total amount covered by gift cards"""
-  totalGiftCardAmount: Money!
-
-  """Total quantity"""
-  totalQuantity: Float!
+"""Cart data for shipping calculation"""
+input CartShippingInput {
+  """Currency code (ISO 4217)"""
+  currencyCode: String
 
-  """Updated at"""
-  updatedAt: DateTime!
+  """Cart subtotal in cents"""
+  subtotal: Int
 
-  """Checkout URL"""
-  webUrl: String!
+  """Total weight in grams"""
+  totalWeight: Int
 }
 
-"""Mailing address input"""
-input CheckoutAddressInput {
-  """City"""
-  city: String!
-
-  """Company name"""
-  company: String
-
-  """ISO 3166-1 alpha-2 country code"""
-  country: CountryCode!
-
-  """First name"""
-  firstName: String
-
-  """Last name"""
-  lastName: String
-
-  """Phone number"""
-  phone: String
-
-  """Postal / ZIP code"""
-  postalCode: String!
-
-  """State / province"""
-  state: String
-
-  """First line of street address"""
-  streetLine1: String!
-
-  """Second line of street address"""
-  streetLine2: String
-}
+"""Shipping method selected on a cart (D8 term unification)"""
+type CartShippingMethod {
+  """Shipping method (rate) handle"""
+  handle: ID!
 
-"""Checkout discount code apply payload"""
-type CheckoutApplyDiscountCodePayload {
-  """Updated checkout"""
-  checkout: Checkout
+  """Shipping cost"""
+  price: Money!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
+  """Display title (e.g. "DPD Standard 2 dni")"""
+  title: String!
 }
 
-"""Checkout gift card apply payload"""
-type CheckoutApplyGiftCardPayload {
-  """Updated checkout"""
-  checkout: Checkout
+"""Result of updating cart attributes"""
+type CartUpdateAttributesPayload {
+  """Updated cart"""
+  cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
+  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
   """
   userErrors: [UserError!]!
-}
 
-"""Checkout complete input"""
-input CheckoutCompleteInput {
-  """Idempotency key for duplicate prevention"""
-  idempotencyKey: String
-
-  """Payment method ID"""
-  paymentMethodId: String
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
 }
 
-"""Checkout complete payload"""
-type CheckoutCompletePayload {
-  """Completed checkout"""
-  checkout: Checkout
-
-  """Created order (if checkout successful)"""
-  order: Order
-
-  """Payment redirect URL (if payment required)"""
-  paymentUrl: String
+"""Result of updating buyer identity"""
+type CartUpdateBuyerIdentityPayload {
+  """Updated cart"""
+  cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
+  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
   """
   userErrors: [UserError!]!
-}
 
-"""Checkout cost breakdown"""
-type CheckoutCost {
-  """Subtotal before discounts and taxes"""
-  subtotal: Money!
-
-  """Total amount (after discounts, including taxes and shipping)"""
-  total: Money!
-
-  """Total discount amount"""
-  totalDiscounts: Money!
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
+}
 
-  """Total shipping cost"""
-  totalShipping: Money!
+"""
+Input dla cartUpdateGiftCardRecipient mutation (gift card line item recipient info)
+"""
+input CartUpdateGiftCardRecipientInput {
+  """Cart ID"""
+  cartId: ID!
 
-  """Total tax amount"""
-  totalTax: Money!
-}
+  """Cart line item ID (musi reprezentować gift card SKU)"""
+  lineItemId: ID!
 
-"""Checkout create input"""
-input CheckoutCreateInput {
-  """Existing cart ID to convert to checkout"""
-  cartId: ID
+  """Personalised message dla recipienta (max 500 znaków)"""
+  message: String
 
-  """Customer access token"""
-  customerAccessToken: String
+  """Recipient email (gift card delivery target)"""
+  recipientEmail: String
 
-  """Customer email"""
-  email: String
+  """Recipient display name"""
+  recipientName: String
+}
 
-  """Line items"""
-  lineItems: [CheckoutLineItemInput!]
+"""Result of updating gift card recipient info on cart line item"""
+type CartUpdateGiftCardRecipientPayload {
+  """Updated cart"""
+  cart: Cart
 
-  """Note"""
-  note: String
+  """User errors (CartErrorCode-namespaced)"""
+  userErrors: [UserError!]!
 
-  """Shipping address"""
-  shippingAddress: CheckoutAddressInput
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
 }
 
-"""Checkout create payload"""
-type CheckoutCreatePayload {
-  """Created checkout"""
-  checkout: Checkout
+"""Result of updating cart lines"""
+type CartUpdateLinesPayload {
+  """Updated cart"""
+  cart: Cart
 
   """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
+  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
   """
   userErrors: [UserError!]!
-}
-
-"""Gift card recipient input"""
-input CheckoutGiftCardRecipientInput {
-  """Checkout ID"""
-  checkoutId: ID!
 
-  """Line item ID to attach recipient info to"""
-  lineItemId: ID!
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
+}
 
-  """Personal message to recipient"""
-  message: String
+"""Result of updating cart note"""
+type CartUpdateNotePayload {
+  """Updated cart"""
+  cart: Cart
 
-  """Recipient email address"""
-  recipientEmail: String
+  """
+  User errors (code is namespaced — e.g. CART_NOT_FOUND, CART_LINE_NOT_FOUND)
+  """
+  userErrors: [UserError!]!
 
-  """Recipient name"""
-  recipientName: String
+  """Non-fatal warnings"""
+  warnings: [CartWarning!]!
 }
 
-"""Checkout line item"""
-type CheckoutLineItem {
-  """Line item ID"""
-  id: ID!
+"""Cart warning (non-fatal advisory)"""
+type CartWarning {
+  """Typed warning code"""
+  code: CartWarningCode!
 
-  """Product image"""
-  image: Image
+  """Warning message"""
+  message: String!
 
-  """Price per unit"""
-  pricePerUnit: Money!
+  """Target identifier (cart line ID lub field path)"""
+  target: String!
+}
 
-  """Product ID"""
-  productId: String
+"""Non-fatal cart warnings"""
+enum CartWarningCode {
+  MERCHANDISE_NOT_AVAILABLE
+  MERCHANDISE_NOT_ENOUGH_STOCK
+  PAYMENTS_AMOUNT_REGION_MISMATCH
+}
 
-  """Quantity"""
-  quantity: Int!
+"""Product category - hierarchical organization"""
+type Category {
+  """Child categories"""
+  children: [Category!]!
 
-  """SKU"""
-  sku: String
+  """Category description"""
+  description: String
 
-  """Product title"""
-  title: String!
+  """Unique identifier"""
+  id: ID!
 
-  """Total price for this line"""
-  total: Money!
+  """Category image"""
+  image: Image
 
-  """Product variant"""
-  variant: ProductVariant
+  """Depth level in hierarchy (0 = root)"""
+  level: Int!
 
-  """Product variant ID"""
-  variantId: String
+  """Category name"""
+  name: String!
 
-  """Variant title"""
-  variantTitle: String
-}
+  """Parent category (null for root)"""
+  parent: Category
 
-"""Checkout line item input"""
-input CheckoutLineItemInput {
-  """Quantity"""
-  quantity: Float!
+  """Full path (e.g., "Electronics/Phones/Smartphones")"""
+  path: String!
 
-  """Product variant ID"""
-  variantId: ID!
-}
+  """Number of products in category"""
+  productCount: Int!
 
-"""Checkout discount code remove payload"""
-type CheckoutRemoveDiscountCodePayload {
-  """Updated checkout"""
-  checkout: Checkout
+  """Products in category"""
+  products(after: String, first: Float! = 20): CategoryConnection!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
-}
+  """SEO metadata"""
+  seo: SEO
 
-"""Checkout gift card remove payload"""
-type CheckoutRemoveGiftCardPayload {
-  """Updated checkout"""
-  checkout: Checkout
+  """URL-friendly slug"""
+  slug: String!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
+  """Sort order within parent"""
+  sortOrder: Int!
 }
 
-"""Checkout payment method update payload"""
-type CheckoutSelectPaymentMethodPayload {
-  """Updated checkout"""
-  checkout: Checkout
+"""Paginated category list (Relay Connection)"""
+type CategoryConnection {
+  """List of category edges (cursor + node pairs)"""
+  edges: [CategoryEdge!]!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
-}
+  """List of category nodes (shortcut without cursor)"""
+  nodes: [Category!]!
 
-"""Checkout shipping line update payload"""
-type CheckoutSelectShippingRatePayload {
-  """Updated checkout"""
-  checkout: Checkout
+  """Pagination info"""
+  pageInfo: PageInfo!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
+  """Total count of categories"""
+  totalCount: Int!
 }
 
-"""Checkout billing address update payload"""
-type CheckoutUpdateBillingAddressPayload {
-  """Updated checkout"""
-  checkout: Checkout
+"""Category edge in connection"""
+type CategoryEdge {
+  """Cursor for pagination"""
+  cursor: String!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
+  """Category node"""
+  node: Category!
 }
 
-"""Checkout email update payload"""
-type CheckoutUpdateEmailPayload {
-  """Updated checkout"""
-  checkout: Checkout
-
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
+"""Category filter"""
+input CategoryFilter {
+  """Category ID"""
+  id: ID
 }
 
-"""Checkout gift card recipient update payload"""
-type CheckoutUpdateGiftCardRecipientPayload {
-  """Updated checkout"""
-  checkout: Checkout
+"""Category filter option"""
+type CategoryFilterOption {
+  """Category ID"""
+  id: ID!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
-}
+  """Nesting level (0 = root)"""
+  level: Int!
 
-"""Checkout shipping address update payload"""
-type CheckoutUpdateShippingAddressPayload {
-  """Updated checkout"""
-  checkout: Checkout
+  """Category name"""
+  name: String!
 
-  """
-  User errors (code is namespaced — e.g. CHECKOUT_NOT_FOUND, CHECKOUT_PAYMENT_FAILED)
-  """
-  userErrors: [UserError!]!
-}
+  """Parent category ID"""
+  parentId: ID
 
-"""Checkout discount code validation result"""
-type CheckoutValidateDiscountCodePayload {
-  """Validation result"""
-  result: DiscountValidationResult!
+  """Number of products in this category"""
+  productCount: Int!
 
-  """
-  User errors (for checkout-level issues; code is namespaced — e.g. CHECKOUT_NOT_FOUND)
-  """
-  userErrors: [UserError!]!
+  """URL-friendly slug"""
+  slug: String!
 }
 
 """Collection - curated group of products"""
@@ -2362,63 +2262,6 @@ type DeliveryEstimate {
   minDays: Int
 }
 
-"""Item affected by a discount (especially BXGY)"""
-type DiscountAffectedItem {
-  """Discounted price per unit"""
-  discountedPrice: Money!
-
-  """Whether this item is "free" in BXGY"""
-  isFreeItem: Boolean!
-
-  """Original price per unit"""
-  originalPrice: Money!
-
-  """Product ID"""
-  productId: ID!
-
-  """Quantity affected by discount"""
-  quantity: Int!
-
-  """Total savings for this item"""
-  savings: Money!
-
-  """Product/variant title"""
-  title: String!
-
-  """Variant ID"""
-  variantId: ID
-}
-
-"""Applied discount"""
-type DiscountApplication {
-  """Items affected by this discount (for BXGY type)"""
-  affectedItems: [DiscountAffectedItem!]
-
-  """Buy quantity for BXGY (e.g., 2 in "Buy 2 Get 1")"""
-  buyQuantity: Int
-
-  """Discount code"""
-  code: String!
-
-  """Discount percentage on "get" items (100 = free)"""
-  getDiscountPercent: Float
-
-  """Get quantity for BXGY (e.g., 1 in "Buy 2 Get 1")"""
-  getQuantity: Int
-
-  """Whether discount is applicable"""
-  isApplicable: Boolean!
-
-  """Discount title/description"""
-  title: String
-
-  """Type of discount"""
-  type: DiscountApplicationType
-
-  """Discount amount"""
-  value: Money
-}
-
 """Type of discount being applied"""
 enum DiscountApplicationType {
   BUY_X_GET_Y
@@ -2427,15 +2270,6 @@ enum DiscountApplicationType {
   PERCENTAGE
 }
 
-"""Discount code applied to checkout"""
-type DiscountCode {
-  """Discount code string"""
-  code: String!
-
-  """Whether the code is currently applicable"""
-  isApplicable: Boolean!
-}
-
 """Error codes for discount validation"""
 enum DiscountErrorCode {
   CUSTOMER_NOT_ELIGIBLE
@@ -3560,71 +3394,55 @@ type Mutation {
   """Add lines to cart"""
   cartAddLines(id: ID!, lines: [CartLineInput!]!): CartAddLinesPayload!
 
-  """Apply discount codes"""
-  cartApplyDiscountCodes(discountCodes: [String!]!, id: ID!): CartApplyDiscountCodesPayload!
+  """Apply gift card to cart"""
+  cartApplyGiftCard(input: CartApplyGiftCardInput!): CartApplyGiftCardPayload!
+
+  """
+  Complete cart → create Order (D6 — delegates do CartCompletionOrchestrator.processCart)
+  """
+  cartComplete(input: CartCompleteInput!): CartCompletePayload!
 
   """Create new cart"""
   cartCreate(input: CartCreateInput): CartCreatePayload!
 
+  """Apply discount codes"""
+  cartDiscountCodesUpdate(discountCodes: [String!]!, id: ID!): CartDiscountCodesUpdatePayload!
+
+  """Remove gift card from cart"""
+  cartRemoveGiftCard(input: CartRemoveGiftCardInput!): CartRemoveGiftCardPayload!
+
   """Remove lines from cart"""
   cartRemoveLines(id: ID!, lineIds: [ID!]!): CartRemoveLinesPayload!
 
+  """Select payment method on cart"""
+  cartSelectPaymentMethod(input: CartSelectPaymentMethodInput!): CartSelectPaymentMethodPayload!
+
+  """
+  Select shipping method on cart (D8 term unification — wcześniej cartSelectShippingRate)
+  """
+  cartSelectShippingMethod(input: CartSelectShippingMethodInput!): CartSelectShippingMethodPayload!
+
+  """Set billing address on cart"""
+  cartSetBillingAddress(input: CartSetBillingAddressInput!): CartSetBillingAddressPayload!
+
+  """Set shipping address on cart"""
+  cartSetShippingAddress(input: CartSetShippingAddressInput!): CartSetShippingAddressPayload!
+
   """Update cart attributes"""
   cartUpdateAttributes(attributes: [CartAttributeInput!]!, id: ID!): CartUpdateAttributesPayload!
 
   """Update buyer identity"""
   cartUpdateBuyerIdentity(buyerIdentity: CartBuyerIdentityInput!, id: ID!): CartUpdateBuyerIdentityPayload!
 
+  """Set recipient info on gift card line item (personalised delivery)"""
+  cartUpdateGiftCardRecipient(input: CartUpdateGiftCardRecipientInput!): CartUpdateGiftCardRecipientPayload!
+
   """Update cart lines"""
   cartUpdateLines(id: ID!, lines: [CartLineUpdateInput!]!): CartUpdateLinesPayload!
 
   """Update cart note"""
   cartUpdateNote(id: ID!, note: String!): CartUpdateNotePayload!
 
-  """Apply discount code to checkout"""
-  checkoutApplyDiscountCode(discountCode: String!, id: ID!): CheckoutApplyDiscountCodePayload!
-
-  """Apply gift card to checkout"""
-  checkoutApplyGiftCard(giftCardCode: String!, id: ID!): CheckoutApplyGiftCardPayload!
-
-  """Complete checkout and create order"""
-  checkoutComplete(id: ID!, input: CheckoutCompleteInput): CheckoutCompletePayload!
-
-  """Create new checkout"""
-  checkoutCreate(input: CheckoutCreateInput!): CheckoutCreatePayload!
-
-  """Remove discount code from checkout"""
-  checkoutRemoveDiscountCode(discountCode: String!, id: ID!): CheckoutRemoveDiscountCodePayload!
-
-  """Remove gift card from checkout"""
-  checkoutRemoveGiftCard(giftCardCode: String!, id: ID!): CheckoutRemoveGiftCardPayload!
-
-  """Select payment method for checkout"""
-  checkoutSelectPaymentMethod(id: ID!, paymentMethodId: ID!): CheckoutSelectPaymentMethodPayload!
-
-  """Select shipping rate for checkout"""
-  checkoutSelectShippingRate(
-    id: ID!
-
-    """Shipping rate handle/id from checkout.availableShippingRates"""
-    rateId: String!
-  ): CheckoutSelectShippingRatePayload!
-
-  """Update checkout billing address"""
-  checkoutUpdateBillingAddress(billingAddress: CheckoutAddressInput!, id: ID!): CheckoutUpdateBillingAddressPayload!
-
-  """Update checkout email"""
-  checkoutUpdateEmail(email: String!, id: ID!): CheckoutUpdateEmailPayload!
-
-  """Update gift card recipient info for a line item"""
-  checkoutUpdateGiftCardRecipient(input: CheckoutGiftCardRecipientInput!): CheckoutUpdateGiftCardRecipientPayload!
-
-  """Update checkout shipping address"""
-  checkoutUpdateShippingAddress(id: ID!, shippingAddress: CheckoutAddressInput!): CheckoutUpdateShippingAddressPayload!
-
-  """Validate discount code without applying"""
-  checkoutValidateDiscountCode(discountCode: String!, id: ID!): CheckoutValidateDiscountCodePayload!
-
   """
   Activate customer account using raw activation token (admin-created flow)
   """
@@ -3747,6 +3565,9 @@ enum NodeType {
 
 """Customer order summary"""
 type Order implements Node {
+  """Czy storefront może zainicjować płatność dla tego order"""
+  canCreatePayment: Boolean!
+
   """When order was cancelled"""
   cancelledAt: DateTime
 
@@ -3774,6 +3595,9 @@ type Order implements Node {
   """Order number (human-readable)"""
   orderNumber: String!
 
+  """Kategoria payment method zmapowana z provider code"""
+  paymentMethodType: PaymentMethodType!
+
   """Payment status"""
   paymentStatus: OrderPaymentStatus!
 
@@ -3925,14 +3749,11 @@ type PaymentMethod {
 
 """Type of payment method"""
 enum PaymentMethodType {
-  APPLE_PAY
   BANK_TRANSFER
   BLIK
   CARD
   CASH_ON_DELIVERY
-  GOOGLE_PAY
   OTHER
-  PAYPAL
 }
 
 """Shop payment configuration (currency, country, providers)"""
@@ -4637,6 +4458,9 @@ type Query {
   """Get cart by ID"""
   cart(id: ID!): Cart
 
+  """Validate discount code preview (read-only, no cart side effects)"""
+  cartValidateDiscountCode(cartId: ID!, discountCode: String!): DiscountValidationResult!
+
   """
   Lista kategorii (Relay Connection) z opcjonalnym filtrem rootsOnly/parentId
   """
@@ -4671,9 +4495,6 @@ type Query {
     slug: String
   ): Category
 
-  """Get checkout by ID"""
-  checkout(id: ID!): Checkout
-
   """Get single collection"""
   collection(
     """Collection handle (slug)"""
@@ -5584,18 +5405,6 @@ type ShippingCarrier {
   serviceCode: String
 }
 
-"""Available shipping rate"""
-type ShippingRate {
-  """Shipping rate ID"""
-  handle: ID!
-
-  """Shipping price"""
-  price: Money!
-
-  """Shipping rate title"""
-  title: String!
-}
-
 """Shop information"""
 type Shop {
   """Shop physical address"""
@@ -5925,18 +5734,6 @@ type SubscribeToMarketingPayload {
   userErrors: [UserError!]!
 }
 
-"""Tax line item"""
-type TaxLine {
-  """Tax amount"""
-  price: Money!
-
-  """Tax rate as decimal (e.g., 0.23 for 23%)"""
-  rate: Float!
-
-  """Tax name"""
-  title: String!
-}
-
 """Custom tier benefit"""
 type TierBenefit {
   """Benefit description"""