@doswiftly/storefront-operations 7.1.0 → 9.1.0

package/mutations.graphql

@@ -291,9 +291,9 @@ mutation CheckoutCreate($input: CheckoutCreateInput!) {
   }
 }
 
-# Sets the shipping address (full replace, not patch). Triggers cart re-pricing. Address format is NOT validated here — full validation runs at `checkoutComplete` (`validateOrderReadiness`).
-mutation CheckoutShippingAddressUpdate($checkoutId: ID!, $shippingAddress: CheckoutAddressInput!) {
-  checkoutShippingAddressUpdate(checkoutId: $checkoutId, shippingAddress: $shippingAddress) {
+# Sets the shipping address (full replace, not patch). Triggers cart re-pricing. Address format is NOT validated here — full validation runs at `checkoutComplete`.
+mutation CheckoutUpdateShippingAddress($id: ID!, $shippingAddress: CheckoutAddressInput!) {
+  checkoutUpdateShippingAddress(id: $id, shippingAddress: $shippingAddress) {
     checkout {
       ...Checkout
     }
@@ -304,8 +304,8 @@ mutation CheckoutShippingAddressUpdate($checkoutId: ID!, $shippingAddress: Check
 }
 
 # Sets the billing address (full replace). Independent of shipping address — pass it explicitly even when "billing same as shipping".
-mutation CheckoutBillingAddressUpdate($checkoutId: ID!, $billingAddress: CheckoutAddressInput!) {
-  checkoutBillingAddressUpdate(checkoutId: $checkoutId, billingAddress: $billingAddress) {
+mutation CheckoutUpdateBillingAddress($id: ID!, $billingAddress: CheckoutAddressInput!) {
+  checkoutUpdateBillingAddress(id: $id, billingAddress: $billingAddress) {
     checkout {
       ...Checkout
     }
@@ -316,8 +316,8 @@ mutation CheckoutBillingAddressUpdate($checkoutId: ID!, $billingAddress: Checkou
 }
 
 # 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.
-mutation CheckoutEmailUpdate($checkoutId: ID!, $email: String!) {
-  checkoutEmailUpdate(checkoutId: $checkoutId, email: $email) {
+mutation CheckoutUpdateEmail($id: ID!, $email: String!) {
+  checkoutUpdateEmail(id: $id, email: $email) {
     checkout {
       ...Checkout
     }
@@ -327,9 +327,9 @@ mutation CheckoutEmailUpdate($checkoutId: ID!, $email: String!) {
   }
 }
 
-# Selects a shipping method by `shippingRateHandle` (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.
-mutation CheckoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: String!) {
-  checkoutShippingLineUpdate(checkoutId: $checkoutId, shippingRateHandle: $shippingRateHandle) {
+# 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.
+mutation CheckoutSelectShippingRate($id: ID!, $rateId: String!) {
+  checkoutSelectShippingRate(id: $id, rateId: $rateId) {
     checkout {
       ...Checkout
     }
@@ -339,9 +339,9 @@ mutation CheckoutShippingLineUpdate($checkoutId: ID!, $shippingRateHandle: Strin
   }
 }
 
-# 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 via `discountService.validateDiscount`.
-mutation CheckoutDiscountCodeApply($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeApply(checkoutId: $checkoutId, discountCode: $discountCode) {
+# 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.
+mutation CheckoutApplyDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutApplyDiscountCode(id: $id, discountCode: $discountCode) {
     checkout {
       ...Checkout
     }
@@ -352,8 +352,8 @@ mutation CheckoutDiscountCodeApply($checkoutId: ID!, $discountCode: String!) {
 }
 
 # Removes a code from the cart's `discount_codes` array (filters by exact match). Triggers re-pricing.
-mutation CheckoutDiscountCodeRemove($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeRemove(checkoutId: $checkoutId, discountCode: $discountCode) {
+mutation CheckoutRemoveDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutRemoveDiscountCode(id: $id, discountCode: $discountCode) {
     checkout {
       ...Checkout
     }
@@ -364,8 +364,8 @@ mutation CheckoutDiscountCodeRemove($checkoutId: ID!, $discountCode: String!) {
 }
 
 # 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).
-mutation CheckoutDiscountCodeValidate($checkoutId: ID!, $discountCode: String!) {
-  checkoutDiscountCodeValidate(checkoutId: $checkoutId, discountCode: $discountCode) {
+mutation CheckoutValidateDiscountCode($id: ID!, $discountCode: String!) {
+  checkoutValidateDiscountCode(id: $id, discountCode: $discountCode) {
     result {
       isValid
       discount {
@@ -390,8 +390,8 @@ mutation CheckoutDiscountCodeValidate($checkoutId: ID!, $discountCode: String!)
 }
 
 # Selects a payment method by `paymentMethodId` (UUID from `availablePaymentMethods` query). Validates existence and active status; no pre-authorization is performed here.
-mutation CheckoutPaymentMethodUpdate($checkoutId: ID!, $paymentMethodId: ID!) {
-  checkoutPaymentMethodUpdate(checkoutId: $checkoutId, paymentMethodId: $paymentMethodId) {
+mutation CheckoutSelectPaymentMethod($id: ID!, $paymentMethodId: ID!) {
+  checkoutSelectPaymentMethod(id: $id, paymentMethodId: $paymentMethodId) {
     checkout {
       ...Checkout
     }
@@ -401,9 +401,9 @@ mutation CheckoutPaymentMethodUpdate($checkoutId: ID!, $paymentMethodId: ID!) {
   }
 }
 
-# Finalizes the checkout: creates the `Order`, marks the cart `CONVERTED`, deducts gift cards, emits `ORDER_CREATED` (and `ORDER_CONFIRMED` for COD) — all in a single serializable transaction. **Idempotent on `idempotencyKey`** (NOT on `checkoutId`); auto-generated from `cartId + timestamp` 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.
-mutation CheckoutComplete($checkoutId: ID!, $input: CheckoutCompleteInput) {
-  checkoutComplete(checkoutId: $checkoutId, input: $input) {
+# 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.
+mutation CheckoutComplete($id: ID!, $input: CheckoutCompleteInput) {
+  checkoutComplete(id: $id, input: $input) {
     checkout {
       ...Checkout
     }
@@ -421,9 +421,9 @@ mutation CheckoutComplete($checkoutId: ID!, $input: CheckoutCompleteInput) {
 # Gift Card Checkout Mutations
 # ============================================
 
-# 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 inside the `checkoutComplete` transaction. Errors: `GIFT_CARD_NOT_FOUND`, `GIFT_CARD_DEPLETED`, `GIFT_CARD_UNUSABLE`, `GIFT_CARD_ALREADY_APPLIED`.
-mutation CheckoutGiftCardApply($checkoutId: ID!, $giftCardCode: String!) {
-  checkoutGiftCardApply(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {
+# 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`.
+mutation CheckoutApplyGiftCard($id: ID!, $giftCardCode: String!) {
+  checkoutApplyGiftCard(id: $id, giftCardCode: $giftCardCode) {
     checkout {
       ...Checkout
     }
@@ -434,8 +434,8 @@ mutation CheckoutGiftCardApply($checkoutId: ID!, $giftCardCode: String!) {
 }
 
 # 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.
-mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {
-  checkoutGiftCardRemove(checkoutId: $checkoutId, giftCardCode: $giftCardCode) {
+mutation CheckoutRemoveGiftCard($id: ID!, $giftCardCode: String!) {
+  checkoutRemoveGiftCard(id: $id, giftCardCode: $giftCardCode) {
     checkout {
       ...Checkout
     }
@@ -446,8 +446,8 @@ mutation CheckoutGiftCardRemove($checkoutId: ID!, $giftCardCode: String!) {
 }
 
 # 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.
-mutation CheckoutGiftCardRecipientUpdate($input: CheckoutGiftCardRecipientInput!) {
-  checkoutGiftCardRecipientUpdate(input: $input) {
+mutation CheckoutUpdateGiftCardRecipient($input: CheckoutGiftCardRecipientInput!) {
+  checkoutUpdateGiftCardRecipient(input: $input) {
     checkout {
       ...Checkout
     }
@@ -491,14 +491,14 @@ mutation ReturnCancel($id: ID!) {
 
 # Redeems a loyalty reward by `rewardId`. Three reward types are supported, distinguished by which output field is populated: `discountCode` (issues a `LOYALTY-XXXX` code with 30-day expiry), `productDiscountCode` (issues a single-use 100%-off code for a specific product), or `giftCardCode` (creates a new gift card for the customer). Points are deducted atomically inside a transaction — if external creation (e.g. gift card service) fails after deduction, points are reversed.
 mutation RedeemLoyaltyReward($input: RedeemRewardInput!) {
-  redeemLoyaltyReward(input: $input) {
+  loyaltyRedeemReward(input: $input) {
     ...RedeemRewardPayload
   }
 }
 
 # Returns the customer's referral code, generating one on first call. Idempotent UPSERT — subsequent calls return the existing code from `customers.referral_code`. Format: `REF-XXXXXXXX` (8 random alphanumeric chars). Output also includes a `shareUrl` built from the shop's domain.
 mutation GenerateReferralCode {
-  generateReferralCode {
+  loyaltyGenerateReferralCode {
     ...GenerateReferralCodePayload
   }
 }
@@ -553,37 +553,45 @@ mutation WishlistCreate($input: WishlistCreateInput!) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 
-# Adds an item by `productId` (and optional `variantId`) to a wishlist. Idempotent on the `(wishlist_id, product_id, variant_id)` unique constraint — adding an already-present item is a silent no-op (`ON CONFLICT DO NOTHING`). Captures `priceAtAdd` for price-drop notifications.
-mutation WishlistAddItem($wishlistId: ID!, $input: WishlistItemInput!) {
-  wishlistAddItem(wishlistId: $wishlistId, input: $input) {
+# Adds an item by `productId` (and optional `variantId`) to a wishlist. Idempotent on the `(wishlist_id, product_id, variant_id)` unique constraint — adding an already-present item is a silent no-op. Captures `priceAtAdd` for price-drop notifications.
+mutation WishlistAddItem($id: ID!, $input: WishlistItemInput!) {
+  wishlistAddItem(id: $id, input: $input) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 
 # Hard-deletes a wishlist item by `itemId` (the `WishlistItem` row id, NOT the product id).
-mutation WishlistRemoveItem($wishlistId: ID!, $itemId: ID!) {
-  wishlistRemoveItem(wishlistId: $wishlistId, itemId: $itemId) {
+mutation WishlistRemoveItem($id: ID!, $itemId: ID!) {
+  wishlistRemoveItem(id: $id, itemId: $itemId) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }
 
-# Hard-deletes the wishlist row. All `WishlistItem` rows are removed via FK cascade. No soft-delete; cannot be undone.
-mutation WishlistDelete($wishlistId: ID!) {
-  wishlistDelete(wishlistId: $wishlistId) {
+# Hard-deletes the wishlist row. All wishlist items are removed via cascade. No soft-delete; cannot be undone.
+mutation WishlistDelete($id: ID!) {
+  wishlistDelete(id: $id) {
     wishlist {
       ...Wishlist
     }
-    userErrors
+    userErrors {
+      ...UserError
+    }
   }
 }