@shopify/hydrogen 2026.10.0-preview.3 → 2026.10.0-preview.4

package/dist/core/cart/queries.mjs

@@ -7,7 +7,7 @@ const CART_FRAGMENT_CONTRACT = {
 	typeName: "Cart"
 };
 const CART_FRAGMENT_PATTERN = createFragmentPattern(CART_FRAGMENT_CONTRACT);
-const HYDROGEN_CART_FRAGMENT = gql(`fragment HydrogenCartFragment on Cart{id checkoutUrl totalQuantity note attributes{key value}cost{subtotalAmount{amount currencyCode}totalAmount{amount currencyCode}checkoutChargeAmount{amount currencyCode}}lines(first:250){nodes{id quantity attributes{key value}cost{totalAmount{amount currencyCode}subtotalAmount{amount currencyCode}amountPerQuantity{amount currencyCode}compareAtAmountPerQuantity{amount currencyCode}}merchandise{...on ProductVariant{id title sku image{id url altText width height}product{id title handle vendor productType}selectedOptions{name value}}}sellingPlanAllocation{sellingPlan{id}}...on CartLine{parentRelationship{parent{id}}}}}discountCodes{applicable code}}`);
+const HYDROGEN_CART_FRAGMENT = gql(`fragment HydrogenCartFragment on Cart{id updatedAt checkoutUrl totalQuantity note attributes{key value}cost{subtotalAmount{amount currencyCode}totalAmount{amount currencyCode}checkoutChargeAmount{amount currencyCode}}lines(first:250){nodes{id quantity attributes{key value}cost{totalAmount{amount currencyCode}subtotalAmount{amount currencyCode}amountPerQuantity{amount currencyCode}compareAtAmountPerQuantity{amount currencyCode}}merchandise{...on ProductVariant{id title sku image{id url altText width height}product{id title handle vendor productType}selectedOptions{name value}}}sellingPlanAllocation{sellingPlan{id}}...on CartLine{parentRelationship{parent{id}}}}}discountCodes{applicable code}}`);
 const CART_QUERY = gql(`query Cart($id:ID!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cart(id:$id){...HydrogenCartFragment}}`, [HYDROGEN_CART_FRAGMENT]);
 const CART_CREATE_MUTATION = gql(`mutation CartCreate($input:CartInput!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartCreate(input:$input){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
 const CART_LINES_ADD_MUTATION = gql(`mutation CartLinesAdd($cartId:ID!$lines:[CartLineInput!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartLinesAdd(cartId:$cartId lines:$lines){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
@@ -63,6 +63,7 @@ function makeCartQueries(options) {
 	}
 	return DEFAULT_CART_QUERIES;
 }
+/** Default cart GraphQL queries and mutations. */
 const cartQueries = makeCartQueries();
 
 //#endregion

package/dist/core/cart/queries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queries.mjs","names":[],"sources":["../../../src/core/cart/queries.ts"],"sourcesContent":["import {\n  gql,\n  type AnyStorefrontQueryString,\n  type ComposedSource,\n  type SourceOf,\n  type StorefrontQueryString,\n} from \"../../graphql\";\nimport type { InferResult, InferVariables } from \"../../graphql\";\nimport type { CartData, CartLineConnection } from \"./state\";\n\nconst CART_FRAGMENT_NAME = \"CartFragment\";\nconst CART_FRAGMENT_TYPE = \"Cart\";\n\ntype FragmentContract = {\n  readonly name: string;\n  readonly typeName: string;\n};\n\nconst CART_FRAGMENT_CONTRACT = {\n  name: CART_FRAGMENT_NAME,\n  typeName: CART_FRAGMENT_TYPE,\n} as const satisfies FragmentContract;\n\nconst CART_FRAGMENT_PATTERN = createFragmentPattern(CART_FRAGMENT_CONTRACT);\n\nconst HYDROGEN_CART_FRAGMENT = gql(`\n  fragment HydrogenCartFragment on Cart {\n    id\n    checkoutUrl\n    totalQuantity\n    note\n    attributes {\n      key\n      value\n    }\n    cost {\n      subtotalAmount {\n        amount\n        currencyCode\n      }\n      totalAmount {\n        amount\n        currencyCode\n      }\n      checkoutChargeAmount {\n        amount\n        currencyCode\n      }\n    }\n    lines(first: 250) {\n      nodes {\n        id\n        quantity\n        attributes {\n          key\n          value\n        }\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n          subtotalAmount {\n            amount\n            currencyCode\n          }\n          amountPerQuantity {\n            amount\n            currencyCode\n          }\n          compareAtAmountPerQuantity {\n            amount\n            currencyCode\n          }\n        }\n        merchandise {\n          ... on ProductVariant {\n            id\n            title\n            sku\n            image {\n              id\n              url\n              altText\n              width\n              height\n            }\n            product {\n              id\n              title\n              handle\n              vendor\n              productType\n            }\n            selectedOptions {\n              name\n              value\n            }\n          }\n        }\n        sellingPlanAllocation {\n          sellingPlan {\n            id\n          }\n        }\n        ... on CartLine {\n          parentRelationship {\n            parent {\n              id\n            }\n          }\n        }\n      }\n    }\n    discountCodes {\n      applicable\n      code\n    }\n  }\n`);\n\nconst CART_QUERY = gql(\n  `query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_CREATE_MUTATION = gql(\n  `mutation CartCreate($input: CartInput!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartCreate(input: $input) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_ADD_MUTATION = gql(\n  `mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_UPDATE_MUTATION = gql(\n  `mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_REMOVE_MUTATION = gql(\n  `mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(\n  `mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_NOTE_UPDATE_MUTATION = gql(\n  `mutation CartNoteUpdate($cartId: ID!, $note: String!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartNoteUpdate(cartId: $cartId, note: $note) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_ATTRIBUTES_UPDATE_MUTATION = gql(\n  `mutation CartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\n// The custom variants spread the consumer's `CartFragment`, which only exists\n// at runtime. Its spread is interpolated on purpose: the gql.tada plugin skips\n// documents containing interpolations instead of flagging an unknown fragment,\n// while TypeScript still resolves the full literal source type. The consumer's\n// fragment is composed in at runtime by `createCartQueries`.\nconst CUSTOM_CART_QUERY = gql(\n  `query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n      ...${CART_FRAGMENT_NAME}\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_CREATE_MUTATION = gql(\n  `mutation CartCreate($input: CartInput!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartCreate(input: $input) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_ADD_MUTATION = gql(\n  `mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_UPDATE_MUTATION = gql(\n  `mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_REMOVE_MUTATION = gql(\n  `mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(\n  `mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_NOTE_UPDATE_MUTATION = gql(\n  `mutation CartNoteUpdate($cartId: ID!, $note: String!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartNoteUpdate(cartId: $cartId, note: $note) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION = gql(\n  `mutation CartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\n// Minimal payload on purpose: buyer identity sync callers only need success or\n// userErrors, never the cart body, so no custom-fragment variant exists.\nconst CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE = /* GraphQL */ `\n  mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {\n    cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {\n      cart {\n        id\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n`;\n\nconst DEFAULT_CART_QUERIES = {\n  cart: CART_QUERY,\n  cartCreate: CART_CREATE_MUTATION,\n  cartLinesAdd: CART_LINES_ADD_MUTATION,\n  cartLinesUpdate: CART_LINES_UPDATE_MUTATION,\n  cartLinesRemove: CART_LINES_REMOVE_MUTATION,\n  cartDiscountCodesUpdate: CART_DISCOUNT_CODES_UPDATE_MUTATION,\n  cartNoteUpdate: CART_NOTE_UPDATE_MUTATION,\n  cartAttributesUpdate: CART_ATTRIBUTES_UPDATE_MUTATION,\n} as const;\n\ntype DefaultCartQueries = typeof DEFAULT_CART_QUERIES;\n\nexport const cartBuyerIdentityUpdateMutation = gql(CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE);\n\ntype QueryFor<\n  Source extends string,\n  Fragments extends readonly AnyStorefrontQueryString[],\n  DocumentSource extends string = ComposedSource<Source, Fragments>,\n> = StorefrontQueryString<\n  InferResult<DocumentSource>,\n  InferVariables<DocumentSource>,\n  DocumentSource\n>;\n\ntype CartFragmentDocument = AnyStorefrontQueryString;\n\ntype CustomQueryFor<\n  Document extends AnyStorefrontQueryString,\n  TCartFragment extends CartFragmentDocument,\n> = QueryFor<SourceOf<Document>, readonly [TCartFragment]>;\n\ntype CartQueriesForFragment<TCartFragment extends CartFragmentDocument> = {\n  readonly cart: CustomQueryFor<typeof CUSTOM_CART_QUERY, TCartFragment>;\n  readonly cartCreate: CustomQueryFor<typeof CUSTOM_CART_CREATE_MUTATION, TCartFragment>;\n  readonly cartLinesAdd: CustomQueryFor<typeof CUSTOM_CART_LINES_ADD_MUTATION, TCartFragment>;\n  readonly cartLinesUpdate: CustomQueryFor<typeof CUSTOM_CART_LINES_UPDATE_MUTATION, TCartFragment>;\n  readonly cartLinesRemove: CustomQueryFor<typeof CUSTOM_CART_LINES_REMOVE_MUTATION, TCartFragment>;\n  readonly cartDiscountCodesUpdate: CustomQueryFor<\n    typeof CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION,\n    TCartFragment\n  >;\n  readonly cartNoteUpdate: CustomQueryFor<typeof CUSTOM_CART_NOTE_UPDATE_MUTATION, TCartFragment>;\n  readonly cartAttributesUpdate: CustomQueryFor<\n    typeof CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION,\n    TCartFragment\n  >;\n};\n\ntype CartDataFromCartQuery<TQuery extends AnyStorefrontQueryString> =\n  TQuery extends StorefrontQueryString<infer Result, infer _Variables, string>\n    ? Result extends { cart?: (infer Cart) | null }\n      ? MergeCartData<NormalizeCartData<NonNullable<Cart>>>\n      : CartData\n    : CartData;\n\ntype MergeCartData<TCart> = Omit<CartData, keyof TCart> & TCart;\n\ntype NormalizeCartData<TCart> = TCart extends { lines: infer TLines }\n  ? Omit<TCart, \"lines\"> & { lines: NormalizeCartLines<TLines> }\n  : TCart;\n\ntype NormalizeCartLines<TLines> = TLines extends { nodes: infer TNodes }\n  ? Omit<TLines, \"nodes\"> & { nodes: Array<CartLineFromNodes<TNodes>> }\n  : TLines;\n\ntype CartLineFromNodes<TNodes> = TNodes extends CartLineConnection[\"nodes\"]\n  ? TNodes[number]\n  : TNodes extends ReadonlyArray<infer TLine>\n    ? TLine\n    : never;\n\nexport type CartDataForOptions<TOptions> = CartDataFromCartQuery<\n  CartQueriesForOptions<TOptions>[\"cart\"]\n>;\n\nexport type CreateCartQueriesOptions<\n  TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString,\n> = {\n  /**\n   * Cart fragment spread into every cart query and mutation response.\n   *\n   * The fragment must be named `CartFragment` and target `Cart`.\n   */\n  readonly fragment: TCartFragment;\n};\n\nexport type CartQueriesForOptions<TOptions> = TOptions extends {\n  readonly fragment: infer TCartFragment extends AnyStorefrontQueryString;\n}\n  ? CartQueriesForFragment<TCartFragment>\n  : DefaultCartQueries;\n\nfunction assertCartFragmentName(fragment: string): void {\n  if (CART_FRAGMENT_PATTERN.test(fragment)) return;\n\n  throw new Error(\n    `Cart fragment must be named ${CART_FRAGMENT_NAME} and target ${CART_FRAGMENT_CONTRACT.typeName}`,\n  );\n}\n\nfunction createFragmentPattern({ name, typeName }: FragmentContract): RegExp {\n  return new RegExp(`fragment\\\\s+${name}\\\\s+on\\\\s+${typeName}`);\n}\n\nfunction createCartQueries<const TCartFragment extends CartFragmentDocument>(\n  cartFragment: TCartFragment,\n): CartQueriesForFragment<TCartFragment> {\n  const fragments = [cartFragment] as const;\n\n  const cart = gql(CUSTOM_CART_QUERY, fragments);\n\n  const cartCreate = gql(CUSTOM_CART_CREATE_MUTATION, fragments);\n\n  const cartLinesAdd = gql(CUSTOM_CART_LINES_ADD_MUTATION, fragments);\n\n  const cartLinesUpdate = gql(CUSTOM_CART_LINES_UPDATE_MUTATION, fragments);\n\n  const cartLinesRemove = gql(CUSTOM_CART_LINES_REMOVE_MUTATION, fragments);\n\n  const cartDiscountCodesUpdate = gql(CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION, fragments);\n\n  const cartNoteUpdate = gql(CUSTOM_CART_NOTE_UPDATE_MUTATION, fragments);\n\n  const cartAttributesUpdate = gql(CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION, fragments);\n\n  return {\n    cart,\n    cartCreate,\n    cartLinesAdd,\n    cartLinesUpdate,\n    cartLinesRemove,\n    cartDiscountCodesUpdate,\n    cartNoteUpdate,\n    cartAttributesUpdate,\n  } as const;\n}\n\nexport function makeCartQueries<const TOptions extends CreateCartQueriesOptions>(\n  options: TOptions,\n): CartQueriesForOptions<TOptions>;\nexport function makeCartQueries(): DefaultCartQueries;\nexport function makeCartQueries(options?: CreateCartQueriesOptions) {\n  if (options) {\n    assertCartFragmentName(options.fragment);\n    return createCartQueries(options.fragment);\n  }\n\n  return DEFAULT_CART_QUERIES;\n}\n\nexport const cartQueries = makeCartQueries();\n"],"mappings":";;;AAUA,MAAA,qBAAA;AAQA,MAAA,yBAAA;CACA,MAAA;CACA,UAAA;CACA;AAEA,MAAA,wBAAA,sBAAA,uBAAA;AAEA,MAAA,yBAAA,IAAA,qrBA8FA;AAEA,MAAA,aAAA,IACA,uJAMA,CAAA,uBAAA,CACA;AAEA,MAAA,uBAAA,IACA,uPAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,0BAAA,IACA,4RAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,6BAAA,IACA,wSAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,6BAAA,IACA,6RAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,sCAAA,IACA,mUAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,4BAAA,IACA,mRAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,kCAAA,IACA,4TAkBA,CAAA,uBAAA,CACA;AAOA,MAAA,oBAAA,IACA,wJAIS,mBAAqB,KAG9B,CAAA,uBAAA,CACA;AAEA,MAAA,8BAAA,IACA,4LAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,iCAAA,IACA,iOAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,oCAAA,IACA,6OAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,oCAAA,IACA,kOAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,6CAAA,IACA,wQAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,mCAAA,IACA,wNAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,yCAAA,IACA,iQAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAIA,MAAA,6CAAA;AAeA,MAAA,uBAAA;CACA,MAAA;CACA,YAAA;CACA,cAAA;CACA,iBAAA;CACA,iBAAA;CACA,yBAAA;CACA,gBAAA;CACA,sBAAA;CACA;AAIA,MAAA,kCAAA,IAAA,2CAAA;AAgFA,SAAA,uBAAA,UAAA;AACA,KAAA,sBAAA,KAAA,SAAA,CAAA;AAEA,OAAA,IAAA,MACA,+BAAA,mBAAA,cAAA,uBAAA,WACA;;AAGA,SAAA,sBAAA,EAAA,MAAA,YAAA;AACA,QAAA,IAAA,OAAA,eAAA,KAAA,YAAA,WAAA;;AAGA,SAAA,kBACA,cACA;CACA,MAAA,YAAA,CAAA,aAAA;AAkBA,QAAA;EACA,MAjBA,IAAA,mBAAA,UAiBA;EACA,YAhBA,IAAA,6BAAA,UAgBA;EACA,cAfA,IAAA,gCAAA,UAeA;EACA,iBAdA,IAAA,mCAAA,UAcA;EACA,iBAbA,IAAA,mCAAA,UAaA;EACA,yBAZA,IAAA,4CAAA,UAYA;EACA,gBAXA,IAAA,kCAAA,UAWA;EACA,sBAVA,IAAA,wCAAA,UAUA;EACA;;AAOA,SAAA,gBAAA,SAAA;AACA,KAAA,SAAA;AACA,yBAAA,QAAA,SAAA;AACA,SAAA,kBAAA,QAAA,SAAA;;AAGA,QAAA;;AAGA,MAAA,cAAA,iBAAA"}
+{"version":3,"file":"queries.mjs","names":[],"sources":["../../../src/core/cart/queries.ts"],"sourcesContent":["import {\n  gql,\n  type AnyStorefrontQueryString,\n  type ComposedSource,\n  type SourceOf,\n  type StorefrontQueryString,\n} from \"../../graphql\";\nimport type { InferResult, InferVariables } from \"../../graphql\";\nimport type { CartData, CartLineConnection } from \"./state\";\n\nconst CART_FRAGMENT_NAME = \"CartFragment\";\nconst CART_FRAGMENT_TYPE = \"Cart\";\n\ntype FragmentContract = {\n  readonly name: string;\n  readonly typeName: string;\n};\n\nconst CART_FRAGMENT_CONTRACT = {\n  name: CART_FRAGMENT_NAME,\n  typeName: CART_FRAGMENT_TYPE,\n} as const satisfies FragmentContract;\n\nconst CART_FRAGMENT_PATTERN = createFragmentPattern(CART_FRAGMENT_CONTRACT);\n\nconst HYDROGEN_CART_FRAGMENT = gql(`\n  fragment HydrogenCartFragment on Cart {\n    id\n    updatedAt\n    checkoutUrl\n    totalQuantity\n    note\n    attributes {\n      key\n      value\n    }\n    cost {\n      subtotalAmount {\n        amount\n        currencyCode\n      }\n      totalAmount {\n        amount\n        currencyCode\n      }\n      checkoutChargeAmount {\n        amount\n        currencyCode\n      }\n    }\n    lines(first: 250) {\n      nodes {\n        id\n        quantity\n        attributes {\n          key\n          value\n        }\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n          subtotalAmount {\n            amount\n            currencyCode\n          }\n          amountPerQuantity {\n            amount\n            currencyCode\n          }\n          compareAtAmountPerQuantity {\n            amount\n            currencyCode\n          }\n        }\n        merchandise {\n          ... on ProductVariant {\n            id\n            title\n            sku\n            image {\n              id\n              url\n              altText\n              width\n              height\n            }\n            product {\n              id\n              title\n              handle\n              vendor\n              productType\n            }\n            selectedOptions {\n              name\n              value\n            }\n          }\n        }\n        sellingPlanAllocation {\n          sellingPlan {\n            id\n          }\n        }\n        ... on CartLine {\n          parentRelationship {\n            parent {\n              id\n            }\n          }\n        }\n      }\n    }\n    discountCodes {\n      applicable\n      code\n    }\n  }\n`);\n\nconst CART_QUERY = gql(\n  `query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_CREATE_MUTATION = gql(\n  `mutation CartCreate($input: CartInput!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartCreate(input: $input) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_ADD_MUTATION = gql(\n  `mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_UPDATE_MUTATION = gql(\n  `mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_LINES_REMOVE_MUTATION = gql(\n  `mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(\n  `mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_NOTE_UPDATE_MUTATION = gql(\n  `mutation CartNoteUpdate($cartId: ID!, $note: String!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartNoteUpdate(cartId: $cartId, note: $note) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CART_ATTRIBUTES_UPDATE_MUTATION = gql(\n  `mutation CartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {\n      cart {\n        ...HydrogenCartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\n// The custom variants spread the consumer's `CartFragment`, which only exists\n// at runtime. Its spread is interpolated on purpose: the gql.tada plugin skips\n// documents containing interpolations instead of flagging an unknown fragment,\n// while TypeScript still resolves the full literal source type. The consumer's\n// fragment is composed in at runtime by `createCartQueries`.\nconst CUSTOM_CART_QUERY = gql(\n  `query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n      ...${CART_FRAGMENT_NAME}\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_CREATE_MUTATION = gql(\n  `mutation CartCreate($input: CartInput!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartCreate(input: $input) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_ADD_MUTATION = gql(\n  `mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_UPDATE_MUTATION = gql(\n  `mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_LINES_REMOVE_MUTATION = gql(\n  `mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(\n  `mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_NOTE_UPDATE_MUTATION = gql(\n  `mutation CartNoteUpdate($cartId: ID!, $note: String!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartNoteUpdate(cartId: $cartId, note: $note) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\nconst CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION = gql(\n  `mutation CartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {\n      cart {\n        ...HydrogenCartFragment\n        ...${CART_FRAGMENT_NAME}\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }`,\n  [HYDROGEN_CART_FRAGMENT],\n);\n\n// Minimal payload on purpose: buyer identity sync callers only need success or\n// userErrors, never the cart body, so no custom-fragment variant exists.\nconst CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE = /* GraphQL */ `\n  mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {\n    cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {\n      cart {\n        id\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n    }\n  }\n`;\n\nconst DEFAULT_CART_QUERIES = {\n  cart: CART_QUERY,\n  cartCreate: CART_CREATE_MUTATION,\n  cartLinesAdd: CART_LINES_ADD_MUTATION,\n  cartLinesUpdate: CART_LINES_UPDATE_MUTATION,\n  cartLinesRemove: CART_LINES_REMOVE_MUTATION,\n  cartDiscountCodesUpdate: CART_DISCOUNT_CODES_UPDATE_MUTATION,\n  cartNoteUpdate: CART_NOTE_UPDATE_MUTATION,\n  cartAttributesUpdate: CART_ATTRIBUTES_UPDATE_MUTATION,\n} as const;\n\ntype DefaultCartQueries = typeof DEFAULT_CART_QUERIES;\n\nexport const cartBuyerIdentityUpdateMutation = gql(CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE);\n\ntype QueryFor<\n  Source extends string,\n  Fragments extends readonly AnyStorefrontQueryString[],\n  DocumentSource extends string = ComposedSource<Source, Fragments>,\n> = StorefrontQueryString<\n  InferResult<DocumentSource>,\n  InferVariables<DocumentSource>,\n  DocumentSource\n>;\n\ntype CartFragmentDocument = AnyStorefrontQueryString;\n\ntype CustomQueryFor<\n  Document extends AnyStorefrontQueryString,\n  TCartFragment extends CartFragmentDocument,\n> = QueryFor<SourceOf<Document>, readonly [TCartFragment]>;\n\ntype CartQueriesForFragment<TCartFragment extends CartFragmentDocument> = {\n  readonly cart: CustomQueryFor<typeof CUSTOM_CART_QUERY, TCartFragment>;\n  readonly cartCreate: CustomQueryFor<typeof CUSTOM_CART_CREATE_MUTATION, TCartFragment>;\n  readonly cartLinesAdd: CustomQueryFor<typeof CUSTOM_CART_LINES_ADD_MUTATION, TCartFragment>;\n  readonly cartLinesUpdate: CustomQueryFor<typeof CUSTOM_CART_LINES_UPDATE_MUTATION, TCartFragment>;\n  readonly cartLinesRemove: CustomQueryFor<typeof CUSTOM_CART_LINES_REMOVE_MUTATION, TCartFragment>;\n  readonly cartDiscountCodesUpdate: CustomQueryFor<\n    typeof CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION,\n    TCartFragment\n  >;\n  readonly cartNoteUpdate: CustomQueryFor<typeof CUSTOM_CART_NOTE_UPDATE_MUTATION, TCartFragment>;\n  readonly cartAttributesUpdate: CustomQueryFor<\n    typeof CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION,\n    TCartFragment\n  >;\n};\n\ntype CartDataFromCartQuery<TQuery extends AnyStorefrontQueryString> =\n  TQuery extends StorefrontQueryString<infer Result, infer _Variables, string>\n    ? Result extends { cart?: (infer Cart) | null }\n      ? MergeCartData<NormalizeCartData<NonNullable<Cart>>>\n      : CartData\n    : CartData;\n\ntype MergeCartData<TCart> = Omit<CartData, keyof TCart> & TCart;\n\ntype NormalizeCartData<TCart> = TCart extends { lines: infer TLines }\n  ? Omit<TCart, \"lines\"> & { lines: NormalizeCartLines<TLines> }\n  : TCart;\n\ntype NormalizeCartLines<TLines> = TLines extends { nodes: infer TNodes }\n  ? Omit<TLines, \"nodes\"> & { nodes: Array<CartLineFromNodes<TNodes>> }\n  : TLines;\n\ntype CartLineFromNodes<TNodes> = TNodes extends CartLineConnection[\"nodes\"]\n  ? TNodes[number]\n  : TNodes extends ReadonlyArray<infer TLine>\n    ? TLine\n    : never;\n\n/** Infers the {@link CartData} shape from `CreateCartServerHandlersOptions`. */\nexport type CartDataForOptions<TOptions> = CartDataFromCartQuery<\n  CartQueriesForOptions<TOptions>[\"cart\"]\n>;\n\n/**\n * Options for {@link makeCartQueries} when providing a custom cart fragment.\n *\n * The fragment extends the default `HydrogenCartFragment` — your additional\n * fields are merged into every cart query and mutation response.\n */\nexport type CreateCartQueriesOptions<\n  TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString,\n> = {\n  /**\n   * Cart fragment spread into every cart query and mutation response.\n   *\n   * The fragment must be named `CartFragment` and target `Cart`.\n   */\n  readonly fragment: TCartFragment;\n};\n\n/** Resolves the cart query set from handler options — custom queries when a fragment is provided, defaults otherwise. */\nexport type CartQueriesForOptions<TOptions> = TOptions extends {\n  readonly fragment: infer TCartFragment extends AnyStorefrontQueryString;\n}\n  ? CartQueriesForFragment<TCartFragment>\n  : DefaultCartQueries;\n\nfunction assertCartFragmentName(fragment: string): void {\n  if (CART_FRAGMENT_PATTERN.test(fragment)) return;\n\n  throw new Error(\n    `Cart fragment must be named ${CART_FRAGMENT_NAME} and target ${CART_FRAGMENT_CONTRACT.typeName}`,\n  );\n}\n\nfunction createFragmentPattern({ name, typeName }: FragmentContract): RegExp {\n  return new RegExp(`fragment\\\\s+${name}\\\\s+on\\\\s+${typeName}`);\n}\n\nfunction createCartQueries<const TCartFragment extends CartFragmentDocument>(\n  cartFragment: TCartFragment,\n): CartQueriesForFragment<TCartFragment> {\n  const fragments = [cartFragment] as const;\n\n  const cart = gql(CUSTOM_CART_QUERY, fragments);\n\n  const cartCreate = gql(CUSTOM_CART_CREATE_MUTATION, fragments);\n\n  const cartLinesAdd = gql(CUSTOM_CART_LINES_ADD_MUTATION, fragments);\n\n  const cartLinesUpdate = gql(CUSTOM_CART_LINES_UPDATE_MUTATION, fragments);\n\n  const cartLinesRemove = gql(CUSTOM_CART_LINES_REMOVE_MUTATION, fragments);\n\n  const cartDiscountCodesUpdate = gql(CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION, fragments);\n\n  const cartNoteUpdate = gql(CUSTOM_CART_NOTE_UPDATE_MUTATION, fragments);\n\n  const cartAttributesUpdate = gql(CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION, fragments);\n\n  return {\n    cart,\n    cartCreate,\n    cartLinesAdd,\n    cartLinesUpdate,\n    cartLinesRemove,\n    cartDiscountCodesUpdate,\n    cartNoteUpdate,\n    cartAttributesUpdate,\n  } as const;\n}\n\n/**\n * Builds a complete set of cart GraphQL query and mutation documents.\n *\n * Without options, returns the default Hydrogen cart queries. With a\n * {@link CreateCartQueriesOptions.fragment | custom fragment}, returns\n * queries that spread both `HydrogenCartFragment` and your fragment into\n * every response, so the result types include your additional fields.\n *\n * @example\n * ```ts\n * // Default queries\n * const queries = makeCartQueries();\n *\n * // With a custom fragment for metafields\n * const queries = makeCartQueries({\n *   fragment: CART_FRAGMENT,\n * });\n * ```\n */\nexport function makeCartQueries<const TOptions extends CreateCartQueriesOptions>(\n  options: TOptions,\n): CartQueriesForOptions<TOptions>;\nexport function makeCartQueries(): DefaultCartQueries;\nexport function makeCartQueries(options?: CreateCartQueriesOptions) {\n  if (options) {\n    assertCartFragmentName(options.fragment);\n    return createCartQueries(options.fragment);\n  }\n\n  return DEFAULT_CART_QUERIES;\n}\n\n/** Default cart GraphQL queries and mutations. */\nexport const cartQueries = makeCartQueries();\n"],"mappings":";;;AAUA,MAAA,qBAAA;AAQA,MAAA,yBAAA;CACA,MAAA;CACA,UAAA;CACA;AAEA,MAAA,wBAAA,sBAAA,uBAAA;AAEA,MAAA,yBAAA,IAAA,+rBA+FA;AAEA,MAAA,aAAA,IACA,uJAMA,CAAA,uBAAA,CACA;AAEA,MAAA,uBAAA,IACA,uPAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,0BAAA,IACA,4RAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,6BAAA,IACA,wSAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,6BAAA,IACA,6RAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,sCAAA,IACA,mUAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,4BAAA,IACA,mRAkBA,CAAA,uBAAA,CACA;AAEA,MAAA,kCAAA,IACA,4TAkBA,CAAA,uBAAA,CACA;AAOA,MAAA,oBAAA,IACA,wJAIS,mBAAqB,KAG9B,CAAA,uBAAA,CACA;AAEA,MAAA,8BAAA,IACA,4LAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,iCAAA,IACA,iOAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,oCAAA,IACA,6OAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,oCAAA,IACA,kOAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,6CAAA,IACA,wQAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,mCAAA,IACA,wNAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAEA,MAAA,yCAAA,IACA,iQAKW,mBAAqB,iEAchC,CAAA,uBAAA,CACA;AAIA,MAAA,6CAAA;AAeA,MAAA,uBAAA;CACA,MAAA;CACA,YAAA;CACA,cAAA;CACA,iBAAA;CACA,iBAAA;CACA,yBAAA;CACA,gBAAA;CACA,sBAAA;CACA;AAIA,MAAA,kCAAA,IAAA,2CAAA;AAwFA,SAAA,uBAAA,UAAA;AACA,KAAA,sBAAA,KAAA,SAAA,CAAA;AAEA,OAAA,IAAA,MACA,+BAAA,mBAAA,cAAA,uBAAA,WACA;;AAGA,SAAA,sBAAA,EAAA,MAAA,YAAA;AACA,QAAA,IAAA,OAAA,eAAA,KAAA,YAAA,WAAA;;AAGA,SAAA,kBACA,cACA;CACA,MAAA,YAAA,CAAA,aAAA;AAkBA,QAAA;EACA,MAjBA,IAAA,mBAAA,UAiBA;EACA,YAhBA,IAAA,6BAAA,UAgBA;EACA,cAfA,IAAA,gCAAA,UAeA;EACA,iBAdA,IAAA,mCAAA,UAcA;EACA,iBAbA,IAAA,mCAAA,UAaA;EACA,yBAZA,IAAA,4CAAA,UAYA;EACA,gBAXA,IAAA,kCAAA,UAWA;EACA,sBAVA,IAAA,wCAAA,UAUA;EACA;;AA0BA,SAAA,gBAAA,SAAA;AACA,KAAA,SAAA;AACA,yBAAA,QAAA,SAAA;AACA,SAAA,kBAAA,QAAA,SAAA;;AAGA,QAAA;;;AAIA,MAAA,cAAA,iBAAA"}

package/dist/core/cart/server-handlers.d.mts

@@ -13,17 +13,27 @@ declare const CART_API_PATH: "/api/cart";
 declare const CART_GET_METHOD: "GET";
 declare const CART_POST_METHOD: "POST";
 declare const cartServerHandlersCartQuery: unique symbol;
+/** Response shape from the cart GET handler — the fetched cart plus any GraphQL errors. */
 type CartGetData<TCart = CartData> = {
   cart: TCart | null;
   errors?: Array<{
     message: string;
   }>;
 };
+/** Full route result from the cart GET handler — JSON with {@link CartGetData} payload and response headers. */
 type CartGetResult<TCart = CartData> = ShopifyRouteJsonResult<CartGetData<TCart>>;
+/** Machine-readable error codes returned by the cart POST handler. */
 type CartErrorCode = "invalid_cart_request" | "missing_cart" | "cart_mutation_failed";
+/** A cart route error carrying a {@link CartErrorCode} for programmatic handling. */
 type CartError = ShopifyRouteError & {
   code: CartErrorCode;
 };
+/**
+ * Result from the cart POST handler — one of:
+ * - JSON with the mutation payload (programmatic clients)
+ * - 303 redirect back to the referrer (HTML form submissions)
+ * - An error with a {@link CartErrorCode}
+ */
 type CartPostResult = ShopifyRouteJsonResult<Record<string, unknown>> | ShopifyRouteRedirectResult | ShopifyRouteErrorResult<CartError>;
 type CartGetHandlerContext = {
   storefrontClient: StorefrontClient;
@@ -42,13 +52,29 @@ type CartCustomerSessionWriteContext = {
   requestContext: ShopifyRequestContext;
 };
 type CartCustomerSession = CustomerSession;
+/** GET handler for the `/api/cart` route — fetches the current cart from the Storefront API. */
 type CartGetHandler<TCart = CartData, TContext extends CartGetHandlerContext = CartGetHandlerContext> = CallableRouteHandler<TContext, CartGetResult<TCart>, typeof CART_API_PATH, typeof CART_GET_METHOD>;
+/** POST handler for the `/api/cart` route — processes cart mutations from JSON or FormData bodies. */
 type CartPostHandler<TContext extends CartPostHandlerContext = CartPostHandlerContext> = CallableRouteHandler<TContext, CartPostResult, typeof CART_API_PATH, typeof CART_POST_METHOD>;
+/**
+ * GET and POST handlers for the `/api/cart` route.
+ *
+ * Created by {@link createCartServerHandlers}. Register these with your
+ * framework's router so the client cart store can communicate with the
+ * Storefront API.
+ */
 type CartServerHandlers<TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart, TCart extends CartData = CartDataFromQuery<TCartQuery>> = {
   readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;
   get: CartGetHandler<TCart>;
   post: CartPostHandler;
 };
+/**
+ * {@link CartServerHandlers} variant that additionally syncs the cart's buyer
+ * identity with a customer session — the handler contexts require a session
+ * manager and request context.
+ *
+ * Created by passing `customerSession` to {@link createCartServerHandlers}.
+ */
 type CartServerHandlersWithCustomerSession<TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart, TCart extends CartData = CartDataFromQuery<TCartQuery>> = {
   readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;
   readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;
@@ -64,8 +90,24 @@ type CartDataFromHandlerResult<TResult> = [TResult] extends [never] ? never : TR
     cart: infer TCart;
   };
 } ? NonNullable<TCart> extends CartData ? NonNullable<TCart> : CartData : CartData;
+/**
+ * Infers the {@link CartData} shape from a {@link CartServerHandlers} instance.
+ *
+ * Use this to type framework components and hooks so they match the server
+ * handler's custom cart query without repeating the generic parameter.
+ *
+ * @example
+ * ```ts
+ * type MyCartData = CartDataFromHandlers<typeof cartHandlers>;
+ * ```
+ */
 type CartDataFromHandlers<THandlers> = CartDataFromHandlerResult<CartGetHandlerResult<THandlers>>;
+/** Options for {@link createCartServerHandlers}. */
 type CreateCartServerHandlersOptions<TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString> = {
+  /**
+   * Custom cart GraphQL fragment spread into every query and mutation response.
+   * The fragment must be named `CartFragment` and target `Cart`.
+   */
   readonly fragment?: TCartFragment;
 } & ({
   readonly customerSession: CartCustomerSession;
@@ -75,6 +117,33 @@ type CreateCartServerHandlersOptions<TCartFragment extends AnyStorefrontQueryStr
 type CartServerHandlersForOptions<TOptions> = TOptions extends {
   readonly customerSession: CartCustomerSession;
 } ? CartServerHandlersWithCustomerSession<CartQueriesForOptions<TOptions>["cart"], CartDataForOptions<TOptions>> : CartServerHandlers<CartQueriesForOptions<TOptions>["cart"], CartDataForOptions<TOptions>>;
+/**
+ * Creates GET and POST handlers for the `/api/cart` route.
+ *
+ * The handlers parse incoming requests (JSON or FormData), resolve the cart
+ * identity from a cookie, execute the matching Storefront API mutation, and
+ * return either JSON (programmatic clients) or a 303 redirect (form submissions).
+ *
+ * Pass `customerSession` to additionally sync the cart's buyer identity with
+ * the logged-in customer — the returned handlers then require a session manager
+ * in their context.
+ *
+ * @example
+ * ```ts
+ * // Basic setup
+ * const cartHandlers = createCartServerHandlers();
+ *
+ * // With a custom cart fragment
+ * const cartHandlers = createCartServerHandlers({
+ *   fragment: CART_FRAGMENT,
+ * });
+ *
+ * // With customer session for buyer identity sync
+ * const cartHandlers = createCartServerHandlers({
+ *   customerSession,
+ * });
+ * ```
+ */
 declare function createCartServerHandlers(): CartServerHandlers<typeof cartQueries.cart>;
 declare function createCartServerHandlers<const TOptions extends CreateCartServerHandlersOptions>(options: TOptions): CartServerHandlersForOptions<TOptions>;
 //#endregion

package/dist/core/cart/server-handlers.mjs

@@ -1,4 +1,5 @@
 import { getLogger } from "../logging/logging.mjs";
+import { getSameOriginPath } from "../url.mjs";
 import { applyPrivateResponseCacheHeaders } from "../headers.mjs";
 import { createProxyResponseHeaders } from "../request-routing/interceptors/proxy.mjs";
 import { createCartCookie, createExpiredCartCookie, getCartIdFromCookie } from "./cookie.mjs";
@@ -136,16 +137,7 @@ function appendHeaders(headers, headersToAppend) {
 	for (const setCookie of headersToAppend.getSetCookie()) headers.append("set-cookie", setCookie);
 }
 function safeRedirectTarget(request) {
-	const referer = request.headers.get("referer");
-	if (!referer) return "/";
-	try {
-		const refererUrl = new URL(referer);
-		const requestUrl = new URL(request.url);
-		if (refererUrl.origin !== requestUrl.origin) return "/";
-		return refererUrl.toString().replace(refererUrl.origin, "");
-	} catch {
-		return "/";
-	}
+	return getSameOriginPath(request.headers.get("referer"), new URL(request.url).origin) ?? "/";
 }
 function assertGraphQLData(result) {
 	if (result.errors || !result.data) {

package/dist/core/cart/server-handlers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server-handlers.mjs","names":["_exhaustive"],"sources":["../../../src/core/cart/server-handlers.ts"],"sourcesContent":["import type { GraphQLFormattedError, StorefrontClient } from \"../../client\";\nimport type {\n  CustomerSession,\n  ReadonlyCustomerSessionManager,\n  WritableCustomerSessionManager,\n} from \"../../customer-account/session\";\nimport { getCustomerSessionRefreshResult } from \"../../customer-account/session\";\nimport type { AnyStorefrontQueryString } from \"../../graphql\";\nimport { applyPrivateResponseCacheHeaders } from \"../headers\";\nimport { getLogger } from \"../logging\";\nimport type { ShopifyRequestContext } from \"../request-context\";\nimport { createProxyResponseHeaders } from \"../request-routing/interceptors/proxy\";\nimport type {\n  CallableRouteHandler,\n  ShopifyRouteError,\n  ShopifyRouteErrorResult,\n  ShopifyRouteJsonResult,\n  ShopifyRouteRedirectResult,\n} from \"../request-routing/registered-routes\";\nimport { createCallableRouteHandler } from \"../request-routing/registered-routes\";\nimport { parseCartRequest } from \"./actions\";\nimport type { CartAction, CartLineAddInput } from \"./actions\";\nimport {\n  cartBuyerIdentitySync,\n  type CartBuyerIdentitySync,\n  type CartBuyerIdentitySyncContext,\n} from \"./buyer-identity-sync\";\nimport { getCartIdFromCookie, createCartCookie, createExpiredCartCookie } from \"./cookie\";\nimport { getCart, getCartId, type CartDataFromQuery } from \"./get-cart\";\nimport {\n  cartBuyerIdentityUpdateMutation,\n  cartQueries,\n  makeCartQueries,\n  type CartDataForOptions,\n  type CartQueriesForOptions,\n  type CreateCartQueriesOptions,\n} from \"./queries\";\nimport type { CartData } from \"./state\";\nconst log = getLogger(\"cart-api\");\n\nconst CART_API_PATH = \"/api/cart\" as const;\nconst CART_GET_METHOD = \"GET\" as const;\nconst CART_POST_METHOD = \"POST\" as const;\nconst CART_MUTATION_FAILED_STATUS = 500;\nconst CART_MUTATION_FAILED_MESSAGE = \"Cart mutation failed. Please try again.\";\nconst cartServerHandlersCartQuery: unique symbol = Symbol(\"hydrogen.cartQuery\");\n\nexport type CartGetData<TCart = CartData> = {\n  cart: TCart | null;\n  errors?: Array<{ message: string }>;\n};\n\nexport type CartGetResult<TCart = CartData> = ShopifyRouteJsonResult<CartGetData<TCart>>;\nexport type CartErrorCode = \"invalid_cart_request\" | \"missing_cart\" | \"cart_mutation_failed\";\nexport type CartError = ShopifyRouteError & {\n  code: CartErrorCode;\n};\nexport type CartPostResult =\n  | ShopifyRouteJsonResult<Record<string, unknown>>\n  | ShopifyRouteRedirectResult\n  | ShopifyRouteErrorResult<CartError>;\n\ntype CartCustomerAccessTokenResult = {\n  accessToken?: string;\n  commitSession: boolean;\n};\n\ntype ParsedCartRequestResult =\n  | { type: \"action\"; action: CartAction; bodyCartId: string | null }\n  | { type: \"response\"; response: CartPostResult };\n\ntype CartGetHandlerContext = {\n  storefrontClient: StorefrontClient;\n  request?: Request;\n};\n\ntype CartPostHandlerContext = {\n  request: Request;\n  storefrontClient: StorefrontClient;\n};\n\ntype CartCustomerSessionReadContext = {\n  sessionManager: ReadonlyCustomerSessionManager;\n  requestContext: ShopifyRequestContext;\n};\n\ntype CartCustomerSessionWriteContext = {\n  sessionManager: WritableCustomerSessionManager;\n  requestContext: ShopifyRequestContext;\n};\n\ntype CartCustomerSession = CustomerSession;\n\nexport type CartGetHandler<\n  TCart = CartData,\n  TContext extends CartGetHandlerContext = CartGetHandlerContext,\n> = CallableRouteHandler<\n  TContext,\n  CartGetResult<TCart>,\n  typeof CART_API_PATH,\n  typeof CART_GET_METHOD\n>;\n\nexport type CartPostHandler<TContext extends CartPostHandlerContext = CartPostHandlerContext> =\n  CallableRouteHandler<TContext, CartPostResult, typeof CART_API_PATH, typeof CART_POST_METHOD>;\n\nexport type CartServerHandlers<\n  TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart,\n  TCart extends CartData = CartDataFromQuery<TCartQuery>,\n> = {\n  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;\n  get: CartGetHandler<TCart>;\n  post: CartPostHandler;\n};\n\nexport type CartServerHandlersWithCustomerSession<\n  TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart,\n  TCart extends CartData = CartDataFromQuery<TCartQuery>,\n> = {\n  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;\n  readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;\n  get: CartGetHandler<TCart, CartGetHandlerContext & CartCustomerSessionReadContext>;\n  post: CartPostHandler<CartPostHandlerContext & CartCustomerSessionWriteContext>;\n};\n\ntype AsyncHandlerResult<THandler> = THandler extends (\n  ...args: infer _Args\n) => Promise<infer TResult>\n  ? TResult\n  : never;\n\ntype CartGetHandlerResult<THandlers> = THandlers extends { get: infer THandler }\n  ? AsyncHandlerResult<THandler>\n  : never;\n\ntype CartDataFromHandlerResult<TResult> = [TResult] extends [never]\n  ? never\n  : TResult extends { data: { cart: infer TCart } }\n    ? NonNullable<TCart> extends CartData\n      ? NonNullable<TCart>\n      : CartData\n    : CartData;\n\nexport type CartDataFromHandlers<THandlers> = CartDataFromHandlerResult<\n  CartGetHandlerResult<THandlers>\n>;\n\nexport type CreateCartServerHandlersOptions<\n  TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString,\n> = {\n  readonly fragment?: TCartFragment;\n} & ({ readonly customerSession: CartCustomerSession } | { readonly customerSession?: undefined });\n\ntype CartServerHandlersForOptions<TOptions> = TOptions extends {\n  readonly customerSession: CartCustomerSession;\n}\n  ? CartServerHandlersWithCustomerSession<\n      CartQueriesForOptions<TOptions>[\"cart\"],\n      CartDataForOptions<TOptions>\n    >\n  : CartServerHandlers<CartQueriesForOptions<TOptions>[\"cart\"], CartDataForOptions<TOptions>>;\n\nexport function createCartServerHandlers(): CartServerHandlers<typeof cartQueries.cart>;\nexport function createCartServerHandlers<const TOptions extends CreateCartServerHandlersOptions>(\n  options: TOptions,\n): CartServerHandlersForOptions<TOptions>;\nexport function createCartServerHandlers(\n  options?: CreateCartServerHandlersOptions,\n): CartServerHandlers | CartServerHandlersWithCustomerSession {\n  const queries = options?.fragment\n    ? makeCartQueries({ fragment: options.fragment } as CreateCartQueriesOptions)\n    : cartQueries;\n  const runtimeQueries = queries as RuntimeCartQueries;\n  const customerSession = options?.customerSession;\n\n  const handlers = {\n    get: createCallableRouteHandler(\n      CART_API_PATH,\n      CART_GET_METHOD,\n      (context: CartGetHandlerContext & Partial<CartCustomerSessionReadContext>) =>\n        handleGet(context, runtimeQueries, customerSession),\n    ),\n    post: createCallableRouteHandler(\n      CART_API_PATH,\n      CART_POST_METHOD,\n      (context: CartPostHandlerContext & Partial<CartCustomerSessionWriteContext>) =>\n        handlePost(context, runtimeQueries, customerSession),\n    ),\n  };\n\n  Object.defineProperty(handlers, cartServerHandlersCartQuery, { value: queries.cart });\n  if (customerSession) {\n    // Symbol-keyed and non-enumerable so the capability never registers as a\n    // route in handleShopifyRoutes and stays uncallable outside Hydrogen wiring.\n    Object.defineProperty(handlers, cartBuyerIdentitySync, {\n      value: createCartBuyerIdentitySync(),\n    });\n  }\n  return handlers as CartServerHandlers | CartServerHandlersWithCustomerSession;\n}\n\nfunction createCartBuyerIdentitySync(): CartBuyerIdentitySync {\n  return {\n    updateBuyerIdentity: updateCartBuyerIdentity,\n    expiredCartCookie: createExpiredCartCookie(),\n  };\n}\n\nasync function updateCartBuyerIdentity(\n  context: CartBuyerIdentitySyncContext,\n  customerAccessToken: string | null,\n): Promise<void> {\n  const cartId = getCartIdFromCookie(context.request);\n  if (!cartId) return;\n\n  const result = await context.storefrontClient.graphql(cartBuyerIdentityUpdateMutation, {\n    variables: { cartId, buyerIdentity: { customerAccessToken } },\n  });\n  const { userErrors } = assertMutationData(result, \"cartBuyerIdentityUpdate\");\n  if (userErrors.length > 0) {\n    throw new Error(userErrors.map(({ message }) => message).join(\"\\n\"));\n  }\n}\n\ntype RuntimeCartQueries = typeof cartQueries;\n\nasync function handleGet(\n  context: CartGetHandlerContext & Partial<CartCustomerSessionReadContext>,\n  queries: RuntimeCartQueries,\n  customerSession?: CartCustomerSession,\n): Promise<CartGetResult> {\n  const { request, storefrontClient } = context;\n  const cartIdSource = request ?? storefrontClient.requestContext;\n  const result = await getCart(getCartId(cartIdSource), storefrontClient, queries.cart);\n  logCartErrors(result.errors);\n  const cart = await addLoggedInCheckoutParam(result.cart, context, customerSession);\n  const data = { cart, ...(result.errors && { errors: result.errors }) };\n  const headers = createProxyResponseHeaders(result.headers);\n  applyPrivateResponseCacheHeaders(headers);\n\n  return {\n    type: \"json\",\n    data,\n    headers,\n  };\n}\n\nfunction logCartErrors(errors: CartGetData[\"errors\"]): void {\n  if (!errors?.length) return;\n  log.error(errors.map(({ message }) => message).join(\"\\n\"));\n}\n\nasync function handlePost(\n  context: CartPostHandlerContext & Partial<CartCustomerSessionWriteContext>,\n  queries: RuntimeCartQueries,\n  customerSession?: CartCustomerSession,\n): Promise<CartPostResult> {\n  const { request, storefrontClient } = context;\n  const isFormRequest = !request.headers.get(\"content-type\")?.includes(\"application/json\");\n  const redirectTarget = safeRedirectTarget(request);\n\n  const parsedCartRequest = await parseCartAction(request, isFormRequest, redirectTarget);\n  if (parsedCartRequest.type === \"response\") return parsedCartRequest.response;\n\n  const cookieCartId = getCartIdFromCookie(request);\n  const cartId = parsedCartRequest.bodyCartId ?? cookieCartId;\n  const missingCartResponse = getMissingCartResponse(\n    parsedCartRequest.action,\n    cartId,\n    isFormRequest,\n    redirectTarget,\n  );\n  if (missingCartResponse) return missingCartResponse;\n\n  const { action } = parsedCartRequest;\n  const customerAccess = await getCartCreateCustomerAccess(\n    parsedCartRequest.action,\n    cartId,\n    context,\n    customerSession,\n  );\n  const customerSessionHeaders = customerAccess.commitSession\n    ? await getCustomerSessionHeaders(context)\n    : undefined;\n  const result = await executeCartMutation(\n    action,\n    cartId,\n    storefrontClient,\n    queries,\n    customerAccess.accessToken,\n    customerSessionHeaders,\n  );\n  if (result.type !== \"mutation\") return result.response;\n\n  const headers = createProxyResponseHeaders(result.headers);\n  appendHeaders(headers, customerSessionHeaders);\n\n  // Only persist carts the browser already owns, including newly-created carts.\n  if (cartId === cookieCartId && result.cartId !== null && result.cartId !== cookieCartId) {\n    headers.append(\"set-cookie\", createCartCookie(result.cartId));\n  }\n\n  if (isFormRequest) return redirectResult(redirectTarget, headers);\n  return jsonResult(result.data, headers);\n}\n\nasync function parseCartAction(\n  request: Request,\n  isFormRequest: boolean,\n  redirectTarget: string,\n): Promise<ParsedCartRequestResult> {\n  try {\n    const { action, cartId: bodyCartId } = await parseCartRequest(request);\n    return { type: \"action\", action, bodyCartId };\n  } catch (error) {\n    if (isFormRequest) return { type: \"response\", response: redirectResult(redirectTarget) };\n    return {\n      type: \"response\",\n      response: errorResult(\"invalid_cart_request\", getErrorMessage(error, \"Bad Request\")),\n    };\n  }\n}\n\nfunction getMissingCartResponse(\n  action: CartAction,\n  cartId: string | null,\n  isFormRequest: boolean,\n  redirectTarget: string,\n): CartPostResult | undefined {\n  if (action.intent === \"add\" || cartId) return undefined;\n  if (isFormRequest) return redirectResult(redirectTarget);\n  return errorResult(\"missing_cart\", \"No cart exists. Add an item first.\");\n}\n\nasync function executeCartMutation(\n  action: CartAction,\n  cartId: string | null,\n  storefrontClient: StorefrontClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken: string | undefined,\n  customerSessionHeaders: Headers | undefined,\n): Promise<\n  ({ type: \"mutation\" } & MutationResult) | { type: \"response\"; response: CartPostResult }\n> {\n  try {\n    return {\n      type: \"mutation\",\n      ...(await executeMutation(action, cartId, storefrontClient, queries, customerAccessToken)),\n    };\n  } catch (error) {\n    if (!customerSessionHeaders) throw error;\n    log.error(\"cart mutation failed\", { error });\n    return {\n      type: \"response\",\n      response: errorResult(\n        \"cart_mutation_failed\",\n        CART_MUTATION_FAILED_MESSAGE,\n        customerSessionHeaders,\n        CART_MUTATION_FAILED_STATUS,\n      ),\n    };\n  }\n}\n\nasync function getCustomerSessionHeaders(\n  context: Partial<CartCustomerSessionWriteContext>,\n): Promise<Headers | undefined> {\n  assertCustomerSessionWriteContext(context);\n  const sessionHeaders = await context.sessionManager.commit?.();\n  if (!sessionHeaders) return undefined;\n  return new Headers(sessionHeaders);\n}\n\nfunction appendHeaders(headers: Headers, headersToAppend: Headers | undefined) {\n  if (!headersToAppend) return;\n  for (const [key, value] of headersToAppend) {\n    if (key !== \"set-cookie\") headers.append(key, value);\n  }\n  for (const setCookie of headersToAppend.getSetCookie()) {\n    headers.append(\"set-cookie\", setCookie);\n  }\n}\n\nfunction safeRedirectTarget(request: Request): string {\n  const referer = request.headers.get(\"referer\");\n  if (!referer) return \"/\";\n  try {\n    const refererUrl = new URL(referer);\n    const requestUrl = new URL(request.url);\n    if (refererUrl.origin !== requestUrl.origin) return \"/\";\n    return refererUrl.toString().replace(refererUrl.origin, \"\");\n  } catch {\n    return \"/\";\n  }\n}\n\ntype MutationResult = {\n  data: Record<string, unknown>;\n  cartId: string | null;\n  headers: Headers;\n};\n\ntype GraphQLResult<D> = {\n  data: D | null;\n  errors?: GraphQLFormattedError[];\n  headers: Headers;\n};\n\nfunction assertGraphQLData<D>(result: GraphQLResult<D>): NonNullable<D> {\n  if (result.errors || !result.data) {\n    const message = result.errors?.[0]?.message ?? \"GraphQL error\";\n    throw new Error(message);\n  }\n  return result.data as NonNullable<D>;\n}\n\nfunction assertMutationData<D, K extends keyof NonNullable<D>>(\n  result: GraphQLResult<D>,\n  key: K,\n): NonNullable<NonNullable<D>[K]> {\n  const data = assertGraphQLData(result);\n  const payload = data[key];\n  if (payload == null) {\n    throw new Error(`Missing ${String(key)} in mutation response`);\n  }\n  return payload as NonNullable<NonNullable<D>[K]>;\n}\n\nfunction createMutationResult(\n  cart: unknown,\n  userErrors: unknown,\n  warnings: unknown,\n  headers: Headers,\n): MutationResult {\n  const storefrontCart = (cart ?? null) as Record<string, unknown> | null;\n\n  return {\n    data: { cart: storefrontCart, userErrors, warnings },\n    cartId: typeof storefrontCart?.id === \"string\" ? storefrontCart.id : null,\n    headers,\n  };\n}\n\ntype CartMutationClient = Pick<StorefrontClient, \"graphql\">;\n\nasync function executeMutation(\n  action: CartAction,\n  cartId: string | null,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken?: string,\n): Promise<MutationResult> {\n  if (action.intent === \"add\") {\n    return executeAdd(action.lines, cartId, storefront, queries, customerAccessToken);\n  }\n\n  if (!cartId) {\n    throw new Error(\"cartId is required for non-add mutations\");\n  }\n\n  switch (action.intent) {\n    case \"update\": {\n      const result = await storefront.graphql(queries.cartLinesUpdate, {\n        variables: { cartId, lines: action.lines },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"remove\": {\n      const result = await storefront.graphql(queries.cartLinesRemove, {\n        variables: { cartId, lineIds: action.lineIds },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesRemove\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"discount-update\": {\n      const result = await storefront.graphql(queries.cartDiscountCodesUpdate, {\n        variables: { cartId, discountCodes: action.discountCodes },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartDiscountCodesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"discount-apply\":\n      return executeDiscountModify(cartId, \"apply\", action.code, storefront, queries);\n    case \"discount-remove\":\n      return executeDiscountModify(cartId, \"remove\", action.code, storefront, queries);\n    case \"note-update\": {\n      const result = await storefront.graphql(queries.cartNoteUpdate, {\n        variables: { cartId, note: action.note },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartNoteUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"attributes-update\": {\n      const result = await storefront.graphql(queries.cartAttributesUpdate, {\n        variables: { cartId, attributes: action.attributes },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartAttributesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    default: {\n      const _exhaustive: never = action;\n      throw new Error(`Unhandled cart action intent: ${(_exhaustive as CartAction).intent}`);\n    }\n  }\n}\n\nasync function executeAdd(\n  lines: CartLineAddInput[],\n  cartId: string | null,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken?: string,\n): Promise<MutationResult> {\n  if (cartId) {\n    const result = await storefront.graphql(queries.cartLinesAdd, {\n      variables: { cartId, lines },\n    });\n    const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesAdd\");\n    return createMutationResult(cart, userErrors, warnings, result.headers);\n  }\n\n  const result = await storefront.graphql(queries.cartCreate, {\n    variables: {\n      input: {\n        lines,\n        ...(customerAccessToken && { buyerIdentity: { customerAccessToken } }),\n      },\n    },\n  });\n  const { cart, userErrors, warnings } = assertMutationData(result, \"cartCreate\");\n  return createMutationResult(cart, userErrors, warnings, result.headers);\n}\n\nasync function getCartCreateCustomerAccess(\n  action: CartAction,\n  cartId: string | null,\n  context: Partial<CartCustomerSessionWriteContext>,\n  customerSession?: CartCustomerSession,\n): Promise<CartCustomerAccessTokenResult> {\n  if (action.intent !== \"add\" || cartId || !customerSession) {\n    return { commitSession: false };\n  }\n\n  assertCustomerSessionWriteContext(context);\n  const accessToken = await customerSession.getAccessToken(\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (accessToken) return { accessToken, commitSession: false };\n\n  const isLoggedIn = await customerSession.isLoggedIn(\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (!isLoggedIn) return { commitSession: false };\n\n  const refreshResult = await getCustomerSessionRefreshResult(\n    customerSession,\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (refreshResult) {\n    return {\n      accessToken: refreshResult.accessToken,\n      commitSession: refreshResult.status !== \"transient\",\n    };\n  }\n\n  const refreshedAccessToken = await customerSession.getOrRefreshAccessToken(\n    context.sessionManager,\n    context.requestContext,\n  );\n  return {\n    accessToken: refreshedAccessToken,\n    commitSession: true,\n  };\n}\n\nasync function addLoggedInCheckoutParam<TCart extends CartData>(\n  cart: TCart | null,\n  context: Partial<CartCustomerSessionReadContext>,\n  customerSession?: CartCustomerSession,\n): Promise<TCart | null> {\n  if (!cart || !customerSession) return cart;\n  assertCustomerSessionReadContext(context);\n  if (!(await customerSession.isLoggedIn(context.sessionManager, context.requestContext)))\n    return cart;\n  if (!cart.checkoutUrl) return cart;\n\n  const checkoutUrl = new URL(cart.checkoutUrl);\n  checkoutUrl.searchParams.set(\"logged_in\", \"true\");\n  return { ...cart, checkoutUrl: checkoutUrl.toString() };\n}\n\nfunction assertCustomerSessionContext(\n  context: Partial<CartCustomerSessionReadContext | CartCustomerSessionWriteContext>,\n): void {\n  if (context.sessionManager && context.requestContext) return;\n  throw new Error(\n    \"Cart handlers configured with customerSession require sessionManager and requestContext.\",\n  );\n}\n\nfunction assertCustomerSessionReadContext(\n  context: Partial<CartCustomerSessionReadContext>,\n): asserts context is CartCustomerSessionReadContext {\n  assertCustomerSessionContext(context);\n}\n\nfunction assertCustomerSessionWriteContext(\n  context: Partial<CartCustomerSessionWriteContext>,\n): asserts context is CartCustomerSessionWriteContext {\n  assertCustomerSessionContext(context);\n}\n\nasync function executeDiscountModify(\n  cartId: string,\n  mode: \"apply\" | \"remove\",\n  code: string,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n): Promise<MutationResult> {\n  // Read-then-write: SFAPI has no atomic discount modify endpoint, so concurrent\n  // requests can overwrite each other's discount codes.\n  const cartResult = await storefront.graphql(queries.cart, {\n    variables: { id: cartId },\n  });\n  const cartData = assertGraphQLData(cartResult);\n\n  const currentCodes: string[] = (cartData.cart?.discountCodes ?? []).map((dc) => dc.code);\n\n  const updatedCodes =\n    mode === \"apply\" ? [...currentCodes, code] : currentCodes.filter((c) => c !== code);\n\n  const result = await storefront.graphql(queries.cartDiscountCodesUpdate, {\n    variables: { cartId, discountCodes: updatedCodes },\n  });\n  const { cart, userErrors, warnings } = assertMutationData(result, \"cartDiscountCodesUpdate\");\n  return createMutationResult(cart, userErrors, warnings, result.headers);\n}\n\nfunction jsonResult<TData>(data: TData, headers: HeadersInit = {}): ShopifyRouteJsonResult<TData> {\n  return { type: \"json\", data, headers };\n}\n\nfunction redirectResult(location: string, headers: HeadersInit = {}): ShopifyRouteRedirectResult {\n  return { type: \"redirect\", location, headers };\n}\n\nfunction errorResult(\n  code: CartErrorCode,\n  message: string,\n  headers?: HeadersInit,\n  status?: number,\n): ShopifyRouteErrorResult<CartError> {\n  return {\n    type: \"error\",\n    error: { code, message },\n    ...(headers && { headers }),\n    ...(status !== undefined && { status }),\n  };\n}\n\nfunction getErrorMessage(error: unknown, fallback: string): string {\n  if (error instanceof Error) return error.message;\n  return fallback;\n}\n"],"mappings":"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"}
+{"version":3,"file":"server-handlers.mjs","names":["_exhaustive"],"sources":["../../../src/core/cart/server-handlers.ts"],"sourcesContent":["import type { GraphQLFormattedError, StorefrontClient } from \"../../client\";\nimport type {\n  CustomerSession,\n  ReadonlyCustomerSessionManager,\n  WritableCustomerSessionManager,\n} from \"../../customer-account/session\";\nimport { getCustomerSessionRefreshResult } from \"../../customer-account/session\";\nimport type { AnyStorefrontQueryString } from \"../../graphql\";\nimport { applyPrivateResponseCacheHeaders } from \"../headers\";\nimport { getLogger } from \"../logging\";\nimport type { ShopifyRequestContext } from \"../request-context\";\nimport { createProxyResponseHeaders } from \"../request-routing/interceptors/proxy\";\nimport type {\n  CallableRouteHandler,\n  ShopifyRouteError,\n  ShopifyRouteErrorResult,\n  ShopifyRouteJsonResult,\n  ShopifyRouteRedirectResult,\n} from \"../request-routing/registered-routes\";\nimport { createCallableRouteHandler } from \"../request-routing/registered-routes\";\nimport { getSameOriginPath } from \"../url\";\nimport { parseCartRequest } from \"./actions\";\nimport type { CartAction, CartLineAddInput } from \"./actions\";\nimport {\n  cartBuyerIdentitySync,\n  type CartBuyerIdentitySync,\n  type CartBuyerIdentitySyncContext,\n} from \"./buyer-identity-sync\";\nimport { getCartIdFromCookie, createCartCookie, createExpiredCartCookie } from \"./cookie\";\nimport { getCart, getCartId, type CartDataFromQuery } from \"./get-cart\";\nimport {\n  cartBuyerIdentityUpdateMutation,\n  cartQueries,\n  makeCartQueries,\n  type CartDataForOptions,\n  type CartQueriesForOptions,\n  type CreateCartQueriesOptions,\n} from \"./queries\";\nimport type { CartData } from \"./state\";\nconst log = getLogger(\"cart-api\");\n\nconst CART_API_PATH = \"/api/cart\" as const;\nconst CART_GET_METHOD = \"GET\" as const;\nconst CART_POST_METHOD = \"POST\" as const;\nconst CART_MUTATION_FAILED_STATUS = 500;\nconst CART_MUTATION_FAILED_MESSAGE = \"Cart mutation failed. Please try again.\";\nconst cartServerHandlersCartQuery: unique symbol = Symbol(\"hydrogen.cartQuery\");\n\n/** Response shape from the cart GET handler — the fetched cart plus any GraphQL errors. */\nexport type CartGetData<TCart = CartData> = {\n  cart: TCart | null;\n  errors?: Array<{ message: string }>;\n};\n\n/** Full route result from the cart GET handler — JSON with {@link CartGetData} payload and response headers. */\nexport type CartGetResult<TCart = CartData> = ShopifyRouteJsonResult<CartGetData<TCart>>;\n\n/** Machine-readable error codes returned by the cart POST handler. */\nexport type CartErrorCode = \"invalid_cart_request\" | \"missing_cart\" | \"cart_mutation_failed\";\n\n/** A cart route error carrying a {@link CartErrorCode} for programmatic handling. */\nexport type CartError = ShopifyRouteError & {\n  code: CartErrorCode;\n};\n\n/**\n * Result from the cart POST handler — one of:\n * - JSON with the mutation payload (programmatic clients)\n * - 303 redirect back to the referrer (HTML form submissions)\n * - An error with a {@link CartErrorCode}\n */\nexport type CartPostResult =\n  | ShopifyRouteJsonResult<Record<string, unknown>>\n  | ShopifyRouteRedirectResult\n  | ShopifyRouteErrorResult<CartError>;\n\ntype CartCustomerAccessTokenResult = {\n  accessToken?: string;\n  commitSession: boolean;\n};\n\ntype ParsedCartRequestResult =\n  | { type: \"action\"; action: CartAction; bodyCartId: string | null }\n  | { type: \"response\"; response: CartPostResult };\n\ntype CartGetHandlerContext = {\n  storefrontClient: StorefrontClient;\n  request?: Request;\n};\n\ntype CartPostHandlerContext = {\n  request: Request;\n  storefrontClient: StorefrontClient;\n};\n\ntype CartCustomerSessionReadContext = {\n  sessionManager: ReadonlyCustomerSessionManager;\n  requestContext: ShopifyRequestContext;\n};\n\ntype CartCustomerSessionWriteContext = {\n  sessionManager: WritableCustomerSessionManager;\n  requestContext: ShopifyRequestContext;\n};\n\ntype CartCustomerSession = CustomerSession;\n\n/** GET handler for the `/api/cart` route — fetches the current cart from the Storefront API. */\nexport type CartGetHandler<\n  TCart = CartData,\n  TContext extends CartGetHandlerContext = CartGetHandlerContext,\n> = CallableRouteHandler<\n  TContext,\n  CartGetResult<TCart>,\n  typeof CART_API_PATH,\n  typeof CART_GET_METHOD\n>;\n\n/** POST handler for the `/api/cart` route — processes cart mutations from JSON or FormData bodies. */\nexport type CartPostHandler<TContext extends CartPostHandlerContext = CartPostHandlerContext> =\n  CallableRouteHandler<TContext, CartPostResult, typeof CART_API_PATH, typeof CART_POST_METHOD>;\n\n/**\n * GET and POST handlers for the `/api/cart` route.\n *\n * Created by {@link createCartServerHandlers}. Register these with your\n * framework's router so the client cart store can communicate with the\n * Storefront API.\n */\nexport type CartServerHandlers<\n  TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart,\n  TCart extends CartData = CartDataFromQuery<TCartQuery>,\n> = {\n  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;\n  get: CartGetHandler<TCart>;\n  post: CartPostHandler;\n};\n\n/**\n * {@link CartServerHandlers} variant that additionally syncs the cart's buyer\n * identity with a customer session — the handler contexts require a session\n * manager and request context.\n *\n * Created by passing `customerSession` to {@link createCartServerHandlers}.\n */\nexport type CartServerHandlersWithCustomerSession<\n  TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart,\n  TCart extends CartData = CartDataFromQuery<TCartQuery>,\n> = {\n  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;\n  readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;\n  get: CartGetHandler<TCart, CartGetHandlerContext & CartCustomerSessionReadContext>;\n  post: CartPostHandler<CartPostHandlerContext & CartCustomerSessionWriteContext>;\n};\n\ntype AsyncHandlerResult<THandler> = THandler extends (\n  ...args: infer _Args\n) => Promise<infer TResult>\n  ? TResult\n  : never;\n\ntype CartGetHandlerResult<THandlers> = THandlers extends { get: infer THandler }\n  ? AsyncHandlerResult<THandler>\n  : never;\n\ntype CartDataFromHandlerResult<TResult> = [TResult] extends [never]\n  ? never\n  : TResult extends { data: { cart: infer TCart } }\n    ? NonNullable<TCart> extends CartData\n      ? NonNullable<TCart>\n      : CartData\n    : CartData;\n\n/**\n * Infers the {@link CartData} shape from a {@link CartServerHandlers} instance.\n *\n * Use this to type framework components and hooks so they match the server\n * handler's custom cart query without repeating the generic parameter.\n *\n * @example\n * ```ts\n * type MyCartData = CartDataFromHandlers<typeof cartHandlers>;\n * ```\n */\nexport type CartDataFromHandlers<THandlers> = CartDataFromHandlerResult<\n  CartGetHandlerResult<THandlers>\n>;\n\n/** Options for {@link createCartServerHandlers}. */\nexport type CreateCartServerHandlersOptions<\n  TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString,\n> = {\n  /**\n   * Custom cart GraphQL fragment spread into every query and mutation response.\n   * The fragment must be named `CartFragment` and target `Cart`.\n   */\n  readonly fragment?: TCartFragment;\n} & ({ readonly customerSession: CartCustomerSession } | { readonly customerSession?: undefined });\n\ntype CartServerHandlersForOptions<TOptions> = TOptions extends {\n  readonly customerSession: CartCustomerSession;\n}\n  ? CartServerHandlersWithCustomerSession<\n      CartQueriesForOptions<TOptions>[\"cart\"],\n      CartDataForOptions<TOptions>\n    >\n  : CartServerHandlers<CartQueriesForOptions<TOptions>[\"cart\"], CartDataForOptions<TOptions>>;\n\n/**\n * Creates GET and POST handlers for the `/api/cart` route.\n *\n * The handlers parse incoming requests (JSON or FormData), resolve the cart\n * identity from a cookie, execute the matching Storefront API mutation, and\n * return either JSON (programmatic clients) or a 303 redirect (form submissions).\n *\n * Pass `customerSession` to additionally sync the cart's buyer identity with\n * the logged-in customer — the returned handlers then require a session manager\n * in their context.\n *\n * @example\n * ```ts\n * // Basic setup\n * const cartHandlers = createCartServerHandlers();\n *\n * // With a custom cart fragment\n * const cartHandlers = createCartServerHandlers({\n *   fragment: CART_FRAGMENT,\n * });\n *\n * // With customer session for buyer identity sync\n * const cartHandlers = createCartServerHandlers({\n *   customerSession,\n * });\n * ```\n */\nexport function createCartServerHandlers(): CartServerHandlers<typeof cartQueries.cart>;\nexport function createCartServerHandlers<const TOptions extends CreateCartServerHandlersOptions>(\n  options: TOptions,\n): CartServerHandlersForOptions<TOptions>;\nexport function createCartServerHandlers(\n  options?: CreateCartServerHandlersOptions,\n): CartServerHandlers | CartServerHandlersWithCustomerSession {\n  const queries = options?.fragment\n    ? makeCartQueries({ fragment: options.fragment } as CreateCartQueriesOptions)\n    : cartQueries;\n  const runtimeQueries = queries as RuntimeCartQueries;\n  const customerSession = options?.customerSession;\n\n  const handlers = {\n    get: createCallableRouteHandler(\n      CART_API_PATH,\n      CART_GET_METHOD,\n      (context: CartGetHandlerContext & Partial<CartCustomerSessionReadContext>) =>\n        handleGet(context, runtimeQueries, customerSession),\n    ),\n    post: createCallableRouteHandler(\n      CART_API_PATH,\n      CART_POST_METHOD,\n      (context: CartPostHandlerContext & Partial<CartCustomerSessionWriteContext>) =>\n        handlePost(context, runtimeQueries, customerSession),\n    ),\n  };\n\n  Object.defineProperty(handlers, cartServerHandlersCartQuery, { value: queries.cart });\n  if (customerSession) {\n    // Symbol-keyed and non-enumerable so the capability never registers as a\n    // route in handleShopifyRoutes and stays uncallable outside Hydrogen wiring.\n    Object.defineProperty(handlers, cartBuyerIdentitySync, {\n      value: createCartBuyerIdentitySync(),\n    });\n  }\n  return handlers as CartServerHandlers | CartServerHandlersWithCustomerSession;\n}\n\nfunction createCartBuyerIdentitySync(): CartBuyerIdentitySync {\n  return {\n    updateBuyerIdentity: updateCartBuyerIdentity,\n    expiredCartCookie: createExpiredCartCookie(),\n  };\n}\n\nasync function updateCartBuyerIdentity(\n  context: CartBuyerIdentitySyncContext,\n  customerAccessToken: string | null,\n): Promise<void> {\n  const cartId = getCartIdFromCookie(context.request);\n  if (!cartId) return;\n\n  const result = await context.storefrontClient.graphql(cartBuyerIdentityUpdateMutation, {\n    variables: { cartId, buyerIdentity: { customerAccessToken } },\n  });\n  const { userErrors } = assertMutationData(result, \"cartBuyerIdentityUpdate\");\n  if (userErrors.length > 0) {\n    throw new Error(userErrors.map(({ message }) => message).join(\"\\n\"));\n  }\n}\n\ntype RuntimeCartQueries = typeof cartQueries;\n\nasync function handleGet(\n  context: CartGetHandlerContext & Partial<CartCustomerSessionReadContext>,\n  queries: RuntimeCartQueries,\n  customerSession?: CartCustomerSession,\n): Promise<CartGetResult> {\n  const { request, storefrontClient } = context;\n  const cartIdSource = request ?? storefrontClient.requestContext;\n  const result = await getCart(getCartId(cartIdSource), storefrontClient, queries.cart);\n  logCartErrors(result.errors);\n  const cart = await addLoggedInCheckoutParam(result.cart, context, customerSession);\n  const data = { cart, ...(result.errors && { errors: result.errors }) };\n  const headers = createProxyResponseHeaders(result.headers);\n  applyPrivateResponseCacheHeaders(headers);\n\n  return {\n    type: \"json\",\n    data,\n    headers,\n  };\n}\n\nfunction logCartErrors(errors: CartGetData[\"errors\"]): void {\n  if (!errors?.length) return;\n  log.error(errors.map(({ message }) => message).join(\"\\n\"));\n}\n\nasync function handlePost(\n  context: CartPostHandlerContext & Partial<CartCustomerSessionWriteContext>,\n  queries: RuntimeCartQueries,\n  customerSession?: CartCustomerSession,\n): Promise<CartPostResult> {\n  const { request, storefrontClient } = context;\n  const isFormRequest = !request.headers.get(\"content-type\")?.includes(\"application/json\");\n  const redirectTarget = safeRedirectTarget(request);\n\n  const parsedCartRequest = await parseCartAction(request, isFormRequest, redirectTarget);\n  if (parsedCartRequest.type === \"response\") return parsedCartRequest.response;\n\n  const cookieCartId = getCartIdFromCookie(request);\n  const cartId = parsedCartRequest.bodyCartId ?? cookieCartId;\n  const missingCartResponse = getMissingCartResponse(\n    parsedCartRequest.action,\n    cartId,\n    isFormRequest,\n    redirectTarget,\n  );\n  if (missingCartResponse) return missingCartResponse;\n\n  const { action } = parsedCartRequest;\n  const customerAccess = await getCartCreateCustomerAccess(\n    parsedCartRequest.action,\n    cartId,\n    context,\n    customerSession,\n  );\n  const customerSessionHeaders = customerAccess.commitSession\n    ? await getCustomerSessionHeaders(context)\n    : undefined;\n  const result = await executeCartMutation(\n    action,\n    cartId,\n    storefrontClient,\n    queries,\n    customerAccess.accessToken,\n    customerSessionHeaders,\n  );\n  if (result.type !== \"mutation\") return result.response;\n\n  const headers = createProxyResponseHeaders(result.headers);\n  appendHeaders(headers, customerSessionHeaders);\n\n  // Only persist carts the browser already owns, including newly-created carts.\n  if (cartId === cookieCartId && result.cartId !== null && result.cartId !== cookieCartId) {\n    headers.append(\"set-cookie\", createCartCookie(result.cartId));\n  }\n\n  if (isFormRequest) return redirectResult(redirectTarget, headers);\n  return jsonResult(result.data, headers);\n}\n\nasync function parseCartAction(\n  request: Request,\n  isFormRequest: boolean,\n  redirectTarget: string,\n): Promise<ParsedCartRequestResult> {\n  try {\n    const { action, cartId: bodyCartId } = await parseCartRequest(request);\n    return { type: \"action\", action, bodyCartId };\n  } catch (error) {\n    if (isFormRequest) return { type: \"response\", response: redirectResult(redirectTarget) };\n    return {\n      type: \"response\",\n      response: errorResult(\"invalid_cart_request\", getErrorMessage(error, \"Bad Request\")),\n    };\n  }\n}\n\nfunction getMissingCartResponse(\n  action: CartAction,\n  cartId: string | null,\n  isFormRequest: boolean,\n  redirectTarget: string,\n): CartPostResult | undefined {\n  if (action.intent === \"add\" || cartId) return undefined;\n  if (isFormRequest) return redirectResult(redirectTarget);\n  return errorResult(\"missing_cart\", \"No cart exists. Add an item first.\");\n}\n\nasync function executeCartMutation(\n  action: CartAction,\n  cartId: string | null,\n  storefrontClient: StorefrontClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken: string | undefined,\n  customerSessionHeaders: Headers | undefined,\n): Promise<\n  ({ type: \"mutation\" } & MutationResult) | { type: \"response\"; response: CartPostResult }\n> {\n  try {\n    return {\n      type: \"mutation\",\n      ...(await executeMutation(action, cartId, storefrontClient, queries, customerAccessToken)),\n    };\n  } catch (error) {\n    if (!customerSessionHeaders) throw error;\n    log.error(\"cart mutation failed\", { error });\n    return {\n      type: \"response\",\n      response: errorResult(\n        \"cart_mutation_failed\",\n        CART_MUTATION_FAILED_MESSAGE,\n        customerSessionHeaders,\n        CART_MUTATION_FAILED_STATUS,\n      ),\n    };\n  }\n}\n\nasync function getCustomerSessionHeaders(\n  context: Partial<CartCustomerSessionWriteContext>,\n): Promise<Headers | undefined> {\n  assertCustomerSessionWriteContext(context);\n  const sessionHeaders = await context.sessionManager.commit?.();\n  if (!sessionHeaders) return undefined;\n  return new Headers(sessionHeaders);\n}\n\nfunction appendHeaders(headers: Headers, headersToAppend: Headers | undefined) {\n  if (!headersToAppend) return;\n  for (const [key, value] of headersToAppend) {\n    if (key !== \"set-cookie\") headers.append(key, value);\n  }\n  for (const setCookie of headersToAppend.getSetCookie()) {\n    headers.append(\"set-cookie\", setCookie);\n  }\n}\n\nfunction safeRedirectTarget(request: Request): string {\n  return getSameOriginPath(request.headers.get(\"referer\"), new URL(request.url).origin) ?? \"/\";\n}\n\ntype MutationResult = {\n  data: Record<string, unknown>;\n  cartId: string | null;\n  headers: Headers;\n};\n\ntype GraphQLResult<D> = {\n  data: D | null;\n  errors?: GraphQLFormattedError[];\n  headers: Headers;\n};\n\nfunction assertGraphQLData<D>(result: GraphQLResult<D>): NonNullable<D> {\n  if (result.errors || !result.data) {\n    const message = result.errors?.[0]?.message ?? \"GraphQL error\";\n    throw new Error(message);\n  }\n  return result.data as NonNullable<D>;\n}\n\nfunction assertMutationData<D, K extends keyof NonNullable<D>>(\n  result: GraphQLResult<D>,\n  key: K,\n): NonNullable<NonNullable<D>[K]> {\n  const data = assertGraphQLData(result);\n  const payload = data[key];\n  if (payload == null) {\n    throw new Error(`Missing ${String(key)} in mutation response`);\n  }\n  return payload as NonNullable<NonNullable<D>[K]>;\n}\n\nfunction createMutationResult(\n  cart: unknown,\n  userErrors: unknown,\n  warnings: unknown,\n  headers: Headers,\n): MutationResult {\n  const storefrontCart = (cart ?? null) as Record<string, unknown> | null;\n\n  return {\n    data: { cart: storefrontCart, userErrors, warnings },\n    cartId: typeof storefrontCart?.id === \"string\" ? storefrontCart.id : null,\n    headers,\n  };\n}\n\ntype CartMutationClient = Pick<StorefrontClient, \"graphql\">;\n\nasync function executeMutation(\n  action: CartAction,\n  cartId: string | null,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken?: string,\n): Promise<MutationResult> {\n  if (action.intent === \"add\") {\n    return executeAdd(action.lines, cartId, storefront, queries, customerAccessToken);\n  }\n\n  if (!cartId) {\n    throw new Error(\"cartId is required for non-add mutations\");\n  }\n\n  switch (action.intent) {\n    case \"update\": {\n      const result = await storefront.graphql(queries.cartLinesUpdate, {\n        variables: { cartId, lines: action.lines },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"remove\": {\n      const result = await storefront.graphql(queries.cartLinesRemove, {\n        variables: { cartId, lineIds: action.lineIds },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesRemove\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"discount-update\": {\n      const result = await storefront.graphql(queries.cartDiscountCodesUpdate, {\n        variables: { cartId, discountCodes: action.discountCodes },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartDiscountCodesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"discount-apply\":\n      return executeDiscountModify(cartId, \"apply\", action.code, storefront, queries);\n    case \"discount-remove\":\n      return executeDiscountModify(cartId, \"remove\", action.code, storefront, queries);\n    case \"note-update\": {\n      const result = await storefront.graphql(queries.cartNoteUpdate, {\n        variables: { cartId, note: action.note },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartNoteUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    case \"attributes-update\": {\n      const result = await storefront.graphql(queries.cartAttributesUpdate, {\n        variables: { cartId, attributes: action.attributes },\n      });\n      const { cart, userErrors, warnings } = assertMutationData(result, \"cartAttributesUpdate\");\n      return createMutationResult(cart, userErrors, warnings, result.headers);\n    }\n    default: {\n      const _exhaustive: never = action;\n      throw new Error(`Unhandled cart action intent: ${(_exhaustive as CartAction).intent}`);\n    }\n  }\n}\n\nasync function executeAdd(\n  lines: CartLineAddInput[],\n  cartId: string | null,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n  customerAccessToken?: string,\n): Promise<MutationResult> {\n  if (cartId) {\n    const result = await storefront.graphql(queries.cartLinesAdd, {\n      variables: { cartId, lines },\n    });\n    const { cart, userErrors, warnings } = assertMutationData(result, \"cartLinesAdd\");\n    return createMutationResult(cart, userErrors, warnings, result.headers);\n  }\n\n  const result = await storefront.graphql(queries.cartCreate, {\n    variables: {\n      input: {\n        lines,\n        ...(customerAccessToken && { buyerIdentity: { customerAccessToken } }),\n      },\n    },\n  });\n  const { cart, userErrors, warnings } = assertMutationData(result, \"cartCreate\");\n  return createMutationResult(cart, userErrors, warnings, result.headers);\n}\n\nasync function getCartCreateCustomerAccess(\n  action: CartAction,\n  cartId: string | null,\n  context: Partial<CartCustomerSessionWriteContext>,\n  customerSession?: CartCustomerSession,\n): Promise<CartCustomerAccessTokenResult> {\n  if (action.intent !== \"add\" || cartId || !customerSession) {\n    return { commitSession: false };\n  }\n\n  assertCustomerSessionWriteContext(context);\n  const accessToken = await customerSession.getAccessToken(\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (accessToken) return { accessToken, commitSession: false };\n\n  const isLoggedIn = await customerSession.isLoggedIn(\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (!isLoggedIn) return { commitSession: false };\n\n  const refreshResult = await getCustomerSessionRefreshResult(\n    customerSession,\n    context.sessionManager,\n    context.requestContext,\n  );\n  if (refreshResult) {\n    return {\n      accessToken: refreshResult.accessToken,\n      commitSession: refreshResult.status !== \"transient\",\n    };\n  }\n\n  const refreshedAccessToken = await customerSession.getOrRefreshAccessToken(\n    context.sessionManager,\n    context.requestContext,\n  );\n  return {\n    accessToken: refreshedAccessToken,\n    commitSession: true,\n  };\n}\n\nasync function addLoggedInCheckoutParam<TCart extends CartData>(\n  cart: TCart | null,\n  context: Partial<CartCustomerSessionReadContext>,\n  customerSession?: CartCustomerSession,\n): Promise<TCart | null> {\n  if (!cart || !customerSession) return cart;\n  assertCustomerSessionReadContext(context);\n  if (!(await customerSession.isLoggedIn(context.sessionManager, context.requestContext)))\n    return cart;\n  if (!cart.checkoutUrl) return cart;\n\n  const checkoutUrl = new URL(cart.checkoutUrl);\n  checkoutUrl.searchParams.set(\"logged_in\", \"true\");\n  return { ...cart, checkoutUrl: checkoutUrl.toString() };\n}\n\nfunction assertCustomerSessionContext(\n  context: Partial<CartCustomerSessionReadContext | CartCustomerSessionWriteContext>,\n): void {\n  if (context.sessionManager && context.requestContext) return;\n  throw new Error(\n    \"Cart handlers configured with customerSession require sessionManager and requestContext.\",\n  );\n}\n\nfunction assertCustomerSessionReadContext(\n  context: Partial<CartCustomerSessionReadContext>,\n): asserts context is CartCustomerSessionReadContext {\n  assertCustomerSessionContext(context);\n}\n\nfunction assertCustomerSessionWriteContext(\n  context: Partial<CartCustomerSessionWriteContext>,\n): asserts context is CartCustomerSessionWriteContext {\n  assertCustomerSessionContext(context);\n}\n\nasync function executeDiscountModify(\n  cartId: string,\n  mode: \"apply\" | \"remove\",\n  code: string,\n  storefront: CartMutationClient,\n  queries: RuntimeCartQueries,\n): Promise<MutationResult> {\n  // Read-then-write: SFAPI has no atomic discount modify endpoint, so concurrent\n  // requests can overwrite each other's discount codes.\n  const cartResult = await storefront.graphql(queries.cart, {\n    variables: { id: cartId },\n  });\n  const cartData = assertGraphQLData(cartResult);\n\n  const currentCodes: string[] = (cartData.cart?.discountCodes ?? []).map((dc) => dc.code);\n\n  const updatedCodes =\n    mode === \"apply\" ? [...currentCodes, code] : currentCodes.filter((c) => c !== code);\n\n  const result = await storefront.graphql(queries.cartDiscountCodesUpdate, {\n    variables: { cartId, discountCodes: updatedCodes },\n  });\n  const { cart, userErrors, warnings } = assertMutationData(result, \"cartDiscountCodesUpdate\");\n  return createMutationResult(cart, userErrors, warnings, result.headers);\n}\n\nfunction jsonResult<TData>(data: TData, headers: HeadersInit = {}): ShopifyRouteJsonResult<TData> {\n  return { type: \"json\", data, headers };\n}\n\nfunction redirectResult(location: string, headers: HeadersInit = {}): ShopifyRouteRedirectResult {\n  return { type: \"redirect\", location, headers };\n}\n\nfunction errorResult(\n  code: CartErrorCode,\n  message: string,\n  headers?: HeadersInit,\n  status?: number,\n): ShopifyRouteErrorResult<CartError> {\n  return {\n    type: \"error\",\n    error: { code, message },\n    ...(headers && { headers }),\n    ...(status !== undefined && { status }),\n  };\n}\n\nfunction getErrorMessage(error: unknown, fallback: string): string {\n  if (error instanceof Error) return error.message;\n  return fallback;\n}\n"],"mappings":"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"}