Cart Mutations

Operations registered in src/gql/mutations/cart/*.

Available Mutations

• CreateGuestCartMutation Operation: createGuestCart
• CreateCustomerCartMutation Operation: createCustomerCart
• AddProductsToCartMutation Operation: addProductsToCart(cartId: String!, siteId: Int, items: [AddCartItemInput!])
• UpdateCartItemsMutation Operation: updateCartItems(cartId: String!, items: [UpdateCartItemInput!])
• RemoveItemFromCartMutation Operation: removeItemFromCart(cartId: String!, itemId: Int!)
• ApplyCouponToCartMutation Operation: applyCouponToCart(cartId: String!, couponCode: String!)
• ApplyGiftCardToCartMutation Operation: applyGiftCardToCart(cartId: String!, giftCardCode: String!, giftCardSecurityCode: String)
• RemoveCouponFromCartMutation Operation: removeCouponFromCart(cartId: String!, couponCode: String!)
• RemoveGiftCardFromCartMutation Operation: removeGiftCardFromCart(cartId: String!, giftCardCode: String!)
• ClearCartMutation Operation: clearCart(cartId: String!): Boolean!
• ConvertCartMutation Operations: convertGuestCartToCustomerCart(cartId: String!, userId: Int!), convertCustomerCartToGuestCart(cartId: String!)

How To Work With Cart Mutations

1. Start with createGuestCart (guest flow) or createCustomerCart (logged-in flow).
2. Save cartId in your frontend state.
3. Run cart item/coupon/gift card mutations against that cartId.
4. Use cart query to refresh totals, selected methods, and validation-driven changes.

Notes

• createCustomerCart requires an authenticated GraphQL user context.
• Convert mutations are intended for login/logout transitions where the cart must persist.