@doswiftly/storefront-sdk 4.3.0 → 4.5.0

package/dist/core/operations/cart.js

@@ -1,11 +1,17 @@
 /**
  * Cart GraphQL operations — manual query strings (no codegen).
  *
- * These match the backend storefront-graphql schema exactly.
+ * SSOT: packages/backend/src/commerce/storefront-graphql/operations/
+ *   - fragments.graphql (CartCost, CartLineCost, CartLine, Cart, etc.)
+ *   - queries.graphql   (Cart query)
+ *   - mutations.graphql  (cartCreate, cartLinesAdd, etc.)
+ *
+ * Validate drift: pnpm test:contract (cart-operations-drift test)
+ *
  * Cart mutations always return full Cart + userErrors.
  */
 // ---------------------------------------------------------------------------
-// Fragments
+// Shared fragments (matching SSOT fragments.graphql)
 // ---------------------------------------------------------------------------
 const MONEY_FRAGMENT = `
   fragment Money on Money {
@@ -13,74 +19,140 @@ const MONEY_FRAGMENT = `
     currencyCode
   }
 `;
+const PRICE_FRAGMENT = `
+  fragment Price on PriceMoney {
+    amount
+    currencyCode
+  }
+`;
+const PRICE_MONEY_FRAGMENT = `
+  fragment PriceMoney on PriceMoney {
+    ...Price
+    baseAmount
+    baseCurrencyCode
+    exchangeRate
+    marginApplied
+    rateTimestamp
+    isConverted
+  }
+  ${PRICE_FRAGMENT}
+`;
+const IMAGE_FRAGMENT = `
+  fragment Image on Image {
+    id
+    url
+    altText
+    width
+    height
+  }
+`;
+const SELECTED_OPTION_FRAGMENT = `
+  fragment SelectedOption on SelectedOption {
+    name
+    value
+  }
+`;
+// ---------------------------------------------------------------------------
+// Cart-specific fragments (matching SSOT fragments.graphql)
+// ---------------------------------------------------------------------------
+const PRODUCT_VARIANT_FRAGMENT = `
+  fragment ProductVariant on ProductVariant {
+    id
+    title
+    sku
+    price { ...PriceMoney }
+    originalPrice { ...Money }
+    compareAtPrice { ...PriceMoney }
+    originalCompareAtPrice { ...Money }
+    available
+    quantityAvailable
+    image { ...Image }
+    selectedOptions { ...SelectedOption }
+    barcode
+    weight
+    position
+  }
+  ${PRICE_MONEY_FRAGMENT}
+  ${MONEY_FRAGMENT}
+  ${IMAGE_FRAGMENT}
+  ${SELECTED_OPTION_FRAGMENT}
+`;
 const CART_COST_FRAGMENT = `
   fragment CartCost on CartCost {
-    totalAmount { ...Money }
-    subtotalAmount { ...Money }
-    totalTaxAmount { ...Money }
-    totalDutyAmount { ...Money }
+    totalAmount { ...PriceMoney }
+    subtotalAmount { ...PriceMoney }
+    totalTaxAmount { ...PriceMoney }
+    totalDutyAmount { ...PriceMoney }
+  }
+`;
+const CART_LINE_COST_FRAGMENT = `
+  fragment CartLineCost on CartLineCost {
+    amountPerQuantity { ...PriceMoney }
+    subtotalAmount { ...PriceMoney }
+    totalAmount { ...PriceMoney }
+    compareAtAmountPerQuantity { ...PriceMoney }
   }
 `;
 const CART_LINE_FRAGMENT = `
-  fragment CartLineFields on CartLine {
+  fragment CartLine on CartLine {
     id
     quantity
-    merchandise {
-      id
-      title
-      sku
-      image { url altText }
-      price { ...Money }
-      compareAtPrice { ...Money }
-    }
-    cost {
-      totalAmount { ...Money }
-      amountPerQuantity { ...Money }
-      compareAtAmountPerQuantity { ...Money }
-    }
+    merchandise { ...ProductVariant }
+    cost { ...CartLineCost }
     attributes { key value }
     productId
     productTitle
     productHandle
+    productType
+  }
+  ${CART_LINE_COST_FRAGMENT}
+  ${PRODUCT_VARIANT_FRAGMENT}
+`;
+const CART_BUYER_IDENTITY_FRAGMENT = `
+  fragment CartBuyerIdentity on CartBuyerIdentity {
+    email
+    phone
+    countryCode
+  }
+`;
+const CART_DISCOUNT_CODE_FRAGMENT = `
+  fragment CartDiscountCode on CartDiscountCode {
+    code
+    applicable
+  }
+`;
+const CART_DISCOUNT_ALLOCATION_FRAGMENT = `
+  fragment CartDiscountAllocation on CartDiscountAllocation {
+    discountCode
+    amount { ...Money }
   }
 `;
 const CART_FRAGMENT = `
-  fragment CartFields on Cart {
+  fragment Cart on Cart {
     id
     checkoutUrl
     totalQuantity
+    cost { ...CartCost }
+    lines(first: 100) { ...CartLine }
+    buyerIdentity { ...CartBuyerIdentity }
+    discountCodes { ...CartDiscountCode }
+    discountAllocations { ...CartDiscountAllocation }
     note
+    attributes { key value }
     createdAt
     updatedAt
-    cost { ...CartCost }
-    lines(first: 100) {
-      edges {
-        node { ...CartLineFields }
-      }
-    }
-    buyerIdentity {
-      email
-      phone
-      countryCode
-    }
-    discountCodes {
-      code
-      applicable
-    }
-    discountAllocations {
-      discountedAmount { ...Money }
-    }
-    attributes { key value }
   }
-  ${MONEY_FRAGMENT}
   ${CART_COST_FRAGMENT}
   ${CART_LINE_FRAGMENT}
+  ${CART_BUYER_IDENTITY_FRAGMENT}
+  ${CART_DISCOUNT_CODE_FRAGMENT}
+  ${CART_DISCOUNT_ALLOCATION_FRAGMENT}
 `;
 const USER_ERROR_FRAGMENT = `
-  fragment UserErrorFields on UserError {
+  fragment UserError on UserError {
     message
-    field
     code
+    field
   }
 `;
 // ---------------------------------------------------------------------------
@@ -89,7 +161,7 @@ const USER_ERROR_FRAGMENT = `
 export const CART_QUERY = `
   query Cart($id: ID!) {
     cart(id: $id) {
-      ...CartFields
+      ...Cart
     }
   }
   ${CART_FRAGMENT}
@@ -100,8 +172,8 @@ export const CART_QUERY = `
 export const CART_CREATE = `
   mutation CartCreate($input: CartCreateInput) {
     cartCreate(input: $input) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -110,8 +182,8 @@ export const CART_CREATE = `
 export const CART_LINES_ADD = `
   mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
     cartLinesAdd(cartId: $cartId, lines: $lines) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -120,8 +192,8 @@ export const CART_LINES_ADD = `
 export const CART_LINES_UPDATE = `
   mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
     cartLinesUpdate(cartId: $cartId, lines: $lines) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -130,8 +202,8 @@ export const CART_LINES_UPDATE = `
 export const CART_LINES_REMOVE = `
   mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
     cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -140,8 +212,8 @@ export const CART_LINES_REMOVE = `
 export const CART_DISCOUNT_CODES_UPDATE = `
   mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {
     cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -150,8 +222,8 @@ export const CART_DISCOUNT_CODES_UPDATE = `
 export const CART_NOTE_UPDATE = `
   mutation CartNoteUpdate($cartId: ID!, $note: String!) {
     cartNoteUpdate(cartId: $cartId, note: $note) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}
@@ -160,8 +232,8 @@ export const CART_NOTE_UPDATE = `
 export const CART_BUYER_IDENTITY_UPDATE = `
   mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {
     cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
-      cart { ...CartFields }
-      userErrors { ...UserErrorFields }
+      cart { ...Cart }
+      userErrors { ...UserError }
     }
   }
   ${CART_FRAGMENT}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @doswiftly/storefront-sdk v4.0.0
+ * @doswiftly/storefront-sdk v4.4.0
  *
  * Layered SDK — Hydrogen-aligned architecture.
  *

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * @doswiftly/storefront-sdk v4.0.0
+ * @doswiftly/storefront-sdk v4.4.0
  *
  * Layered SDK — Hydrogen-aligned architecture.
  *

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "4.3.0",
+  "version": "4.5.0",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "types": "dist/core/index.d.ts",
   "exports": {
     ".": {
@@ -30,7 +34,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:unit": "vitest run src/__tests__/unit/",
-    "test:contract": "vitest run src/__tests__/contract/"
+    "test:contract": "vitest run src/__tests__/contract/",
+    "validate:cart": "node scripts/validate-cart-operations.cjs --strict"
   },
   "keywords": [
     "sdk",
@@ -50,9 +55,9 @@
     "@types/node": "^22.10.2",
     "@types/react": "^18.3.0 || ^19.0.0",
     "fast-check": "^3.23.2",
-    "next": "^15.0.0",
+    "next": "^16.0.0",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8",
+    "vitest": "^4.1.0",
     "zustand": "^5.0.2",
     "react": "^19.0.0"
   },