@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

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

@@ -0,0 +1,70 @@
+import { gql } from "../../graphql/graphql.mjs";
+
+//#region src/core/cart/queries.ts
+const CART_FRAGMENT_NAME = "CartFragment";
+const CART_FRAGMENT_CONTRACT = {
+	name: CART_FRAGMENT_NAME,
+	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 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]);
+const CART_LINES_UPDATE_MUTATION = gql(`mutation CartLinesUpdate($cartId:ID!$lines:[CartLineUpdateInput!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartLinesUpdate(cartId:$cartId lines:$lines){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CART_LINES_REMOVE_MUTATION = gql(`mutation CartLinesRemove($cartId:ID!$lineIds:[ID!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartLinesRemove(cartId:$cartId lineIds:$lineIds){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(`mutation CartDiscountCodesUpdate($cartId:ID!$discountCodes:[String!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartDiscountCodesUpdate(cartId:$cartId discountCodes:$discountCodes){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CART_NOTE_UPDATE_MUTATION = gql(`mutation CartNoteUpdate($cartId:ID!$note:String!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartNoteUpdate(cartId:$cartId note:$note){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CART_ATTRIBUTES_UPDATE_MUTATION = gql(`mutation CartAttributesUpdate($cartId:ID!$attributes:[AttributeInput!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartAttributesUpdate(cartId:$cartId attributes:$attributes){cart{...HydrogenCartFragment}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_QUERY = gql(`query Cart($id:ID!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cart(id:$id){...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_CREATE_MUTATION = gql(`mutation CartCreate($input:CartInput!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartCreate(input:$input){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_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 ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_LINES_UPDATE_MUTATION = gql(`mutation CartLinesUpdate($cartId:ID!$lines:[CartLineUpdateInput!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartLinesUpdate(cartId:$cartId lines:$lines){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_LINES_REMOVE_MUTATION = gql(`mutation CartLinesRemove($cartId:ID!$lineIds:[ID!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartLinesRemove(cartId:$cartId lineIds:$lineIds){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION = gql(`mutation CartDiscountCodesUpdate($cartId:ID!$discountCodes:[String!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartDiscountCodesUpdate(cartId:$cartId discountCodes:$discountCodes){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_NOTE_UPDATE_MUTATION = gql(`mutation CartNoteUpdate($cartId:ID!$note:String!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartNoteUpdate(cartId:$cartId note:$note){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION = gql(`mutation CartAttributesUpdate($cartId:ID!$attributes:[AttributeInput!]!$country:CountryCode$language:LanguageCode)@inContext(country:$country language:$language){cartAttributesUpdate(cartId:$cartId attributes:$attributes){cart{...HydrogenCartFragment ...${CART_FRAGMENT_NAME}}userErrors{code field message}warnings{code message target}}}`, [HYDROGEN_CART_FRAGMENT]);
+const CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE = `mutation CartBuyerIdentityUpdate($cartId:ID!$buyerIdentity:CartBuyerIdentityInput!){cartBuyerIdentityUpdate(cartId:$cartId buyerIdentity:$buyerIdentity){cart{id}userErrors{code field message}}}`;
+const DEFAULT_CART_QUERIES = {
+	cart: CART_QUERY,
+	cartCreate: CART_CREATE_MUTATION,
+	cartLinesAdd: CART_LINES_ADD_MUTATION,
+	cartLinesUpdate: CART_LINES_UPDATE_MUTATION,
+	cartLinesRemove: CART_LINES_REMOVE_MUTATION,
+	cartDiscountCodesUpdate: CART_DISCOUNT_CODES_UPDATE_MUTATION,
+	cartNoteUpdate: CART_NOTE_UPDATE_MUTATION,
+	cartAttributesUpdate: CART_ATTRIBUTES_UPDATE_MUTATION
+};
+const cartBuyerIdentityUpdateMutation = gql(CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE);
+function assertCartFragmentName(fragment) {
+	if (CART_FRAGMENT_PATTERN.test(fragment)) return;
+	throw new Error(`Cart fragment must be named ${CART_FRAGMENT_NAME} and target ${CART_FRAGMENT_CONTRACT.typeName}`);
+}
+function createFragmentPattern({ name, typeName }) {
+	return new RegExp(`fragment\\s+${name}\\s+on\\s+${typeName}`);
+}
+function createCartQueries(cartFragment) {
+	const fragments = [cartFragment];
+	return {
+		cart: gql(CUSTOM_CART_QUERY, fragments),
+		cartCreate: gql(CUSTOM_CART_CREATE_MUTATION, fragments),
+		cartLinesAdd: gql(CUSTOM_CART_LINES_ADD_MUTATION, fragments),
+		cartLinesUpdate: gql(CUSTOM_CART_LINES_UPDATE_MUTATION, fragments),
+		cartLinesRemove: gql(CUSTOM_CART_LINES_REMOVE_MUTATION, fragments),
+		cartDiscountCodesUpdate: gql(CUSTOM_CART_DISCOUNT_CODES_UPDATE_MUTATION, fragments),
+		cartNoteUpdate: gql(CUSTOM_CART_NOTE_UPDATE_MUTATION, fragments),
+		cartAttributesUpdate: gql(CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION, fragments)
+	};
+}
+function makeCartQueries(options) {
+	if (options) {
+		assertCartFragmentName(options.fragment);
+		return createCartQueries(options.fragment);
+	}
+	return DEFAULT_CART_QUERIES;
+}
+const cartQueries = makeCartQueries();
+
+//#endregion
+export { cartBuyerIdentityUpdateMutation, cartQueries, makeCartQueries };
+//# sourceMappingURL=queries.mjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,82 @@
+import { ShopifyRequestContext } from "../request-context.mjs";
+import { AnyStorefrontQueryString } from "../../graphql/graphql.mjs";
+import { StorefrontClient } from "../../client/types.mjs";
+import { CallableRouteHandler, ShopifyRouteError, ShopifyRouteErrorResult, ShopifyRouteJsonResult, ShopifyRouteRedirectResult } from "../request-routing/route-types.mjs";
+import { CartData } from "./state.mjs";
+import { CartDataForOptions, CartQueriesForOptions, cartQueries } from "./queries.mjs";
+import { CartDataFromQuery } from "./get-cart.mjs";
+import { CartBuyerIdentitySync, cartBuyerIdentitySync } from "./buyer-identity-sync.mjs";
+import { CustomerSession, ReadonlyCustomerSessionManager, WritableCustomerSessionManager } from "../../customer-account/session.mjs";
+
+//#region src/core/cart/server-handlers.d.ts
+declare const CART_API_PATH: "/api/cart";
+declare const CART_GET_METHOD: "GET";
+declare const CART_POST_METHOD: "POST";
+declare const cartServerHandlersCartQuery: unique symbol;
+type CartGetData<TCart = CartData> = {
+  cart: TCart | null;
+  errors?: Array<{
+    message: string;
+  }>;
+};
+type CartGetResult<TCart = CartData> = ShopifyRouteJsonResult<CartGetData<TCart>>;
+type CartErrorCode = "invalid_cart_request" | "missing_cart" | "cart_mutation_failed";
+type CartError = ShopifyRouteError & {
+  code: CartErrorCode;
+};
+type CartPostResult = ShopifyRouteJsonResult<Record<string, unknown>> | ShopifyRouteRedirectResult | ShopifyRouteErrorResult<CartError>;
+type CartGetHandlerContext = {
+  storefrontClient: StorefrontClient;
+  request?: Request;
+};
+type CartPostHandlerContext = {
+  request: Request;
+  storefrontClient: StorefrontClient;
+};
+type CartCustomerSessionReadContext = {
+  sessionManager: ReadonlyCustomerSessionManager;
+  requestContext: ShopifyRequestContext;
+};
+type CartCustomerSessionWriteContext = {
+  sessionManager: WritableCustomerSessionManager;
+  requestContext: ShopifyRequestContext;
+};
+type CartCustomerSession = CustomerSession;
+type CartGetHandler<TCart = CartData, TContext extends CartGetHandlerContext = CartGetHandlerContext> = CallableRouteHandler<TContext, CartGetResult<TCart>, typeof CART_API_PATH, typeof CART_GET_METHOD>;
+type CartPostHandler<TContext extends CartPostHandlerContext = CartPostHandlerContext> = CallableRouteHandler<TContext, CartPostResult, typeof CART_API_PATH, typeof CART_POST_METHOD>;
+type CartServerHandlers<TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart, TCart extends CartData = CartDataFromQuery<TCartQuery>> = {
+  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;
+  get: CartGetHandler<TCart>;
+  post: CartPostHandler;
+};
+type CartServerHandlersWithCustomerSession<TCartQuery extends AnyStorefrontQueryString = typeof cartQueries.cart, TCart extends CartData = CartDataFromQuery<TCartQuery>> = {
+  readonly [cartServerHandlersCartQuery]: TCartQuery | undefined;
+  readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;
+  get: CartGetHandler<TCart, CartGetHandlerContext & CartCustomerSessionReadContext>;
+  post: CartPostHandler<CartPostHandlerContext & CartCustomerSessionWriteContext>;
+};
+type AsyncHandlerResult<THandler> = THandler extends ((...args: infer _Args) => Promise<infer TResult>) ? TResult : never;
+type CartGetHandlerResult<THandlers> = THandlers extends {
+  get: infer THandler;
+} ? AsyncHandlerResult<THandler> : never;
+type CartDataFromHandlerResult<TResult> = [TResult] extends [never] ? never : TResult extends {
+  data: {
+    cart: infer TCart;
+  };
+} ? NonNullable<TCart> extends CartData ? NonNullable<TCart> : CartData : CartData;
+type CartDataFromHandlers<THandlers> = CartDataFromHandlerResult<CartGetHandlerResult<THandlers>>;
+type CreateCartServerHandlersOptions<TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString> = {
+  readonly fragment?: TCartFragment;
+} & ({
+  readonly customerSession: CartCustomerSession;
+} | {
+  readonly customerSession?: undefined;
+});
+type CartServerHandlersForOptions<TOptions> = TOptions extends {
+  readonly customerSession: CartCustomerSession;
+} ? CartServerHandlersWithCustomerSession<CartQueriesForOptions<TOptions>["cart"], CartDataForOptions<TOptions>> : CartServerHandlers<CartQueriesForOptions<TOptions>["cart"], CartDataForOptions<TOptions>>;
+declare function createCartServerHandlers(): CartServerHandlers<typeof cartQueries.cart>;
+declare function createCartServerHandlers<const TOptions extends CreateCartServerHandlersOptions>(options: TOptions): CartServerHandlersForOptions<TOptions>;
+//#endregion
+export { CartDataFromHandlers, CartError, CartErrorCode, CartGetData, CartGetHandler, CartGetResult, CartPostHandler, CartPostResult, CartServerHandlers, CartServerHandlersWithCustomerSession, CreateCartServerHandlersOptions, createCartServerHandlers };
+//# sourceMappingURL=server-handlers.d.mts.map

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

@@ -0,0 +1,322 @@
+import { getLogger } from "../logging/logging.mjs";
+import { applyPrivateResponseCacheHeaders } from "../headers.mjs";
+import { createProxyResponseHeaders } from "../request-routing/interceptors/proxy.mjs";
+import { createCartCookie, createExpiredCartCookie, getCartIdFromCookie } from "./cookie.mjs";
+import { cartBuyerIdentityUpdateMutation, cartQueries, makeCartQueries } from "./queries.mjs";
+import { getCart, getCartId } from "./get-cart.mjs";
+import { createCallableRouteHandler } from "../request-routing/registered-routes.mjs";
+import { parseCartRequest } from "./actions.mjs";
+import { cartBuyerIdentitySync } from "./buyer-identity-sync.mjs";
+import { getCustomerSessionRefreshResult } from "../../customer-account/session.mjs";
+
+//#region src/core/cart/server-handlers.ts
+const log = getLogger("cart-api");
+const CART_API_PATH = "/api/cart";
+const CART_GET_METHOD = "GET";
+const CART_POST_METHOD = "POST";
+const CART_MUTATION_FAILED_STATUS = 500;
+const CART_MUTATION_FAILED_MESSAGE = "Cart mutation failed. Please try again.";
+const cartServerHandlersCartQuery = Symbol("hydrogen.cartQuery");
+function createCartServerHandlers(options) {
+	const queries = options?.fragment ? makeCartQueries({ fragment: options.fragment }) : cartQueries;
+	const runtimeQueries = queries;
+	const customerSession = options?.customerSession;
+	const handlers = {
+		get: createCallableRouteHandler(CART_API_PATH, CART_GET_METHOD, (context) => handleGet(context, runtimeQueries, customerSession)),
+		post: createCallableRouteHandler(CART_API_PATH, CART_POST_METHOD, (context) => handlePost(context, runtimeQueries, customerSession))
+	};
+	Object.defineProperty(handlers, cartServerHandlersCartQuery, { value: queries.cart });
+	if (customerSession) Object.defineProperty(handlers, cartBuyerIdentitySync, { value: createCartBuyerIdentitySync() });
+	return handlers;
+}
+function createCartBuyerIdentitySync() {
+	return {
+		updateBuyerIdentity: updateCartBuyerIdentity,
+		expiredCartCookie: createExpiredCartCookie()
+	};
+}
+async function updateCartBuyerIdentity(context, customerAccessToken) {
+	const cartId = getCartIdFromCookie(context.request);
+	if (!cartId) return;
+	const { userErrors } = assertMutationData(await context.storefrontClient.graphql(cartBuyerIdentityUpdateMutation, { variables: {
+		cartId,
+		buyerIdentity: { customerAccessToken }
+	} }), "cartBuyerIdentityUpdate");
+	if (userErrors.length > 0) throw new Error(userErrors.map(({ message }) => message).join("\n"));
+}
+async function handleGet(context, queries, customerSession) {
+	const { request, storefrontClient } = context;
+	const result = await getCart(getCartId(request ?? storefrontClient.requestContext), storefrontClient, queries.cart);
+	logCartErrors(result.errors);
+	const data = {
+		cart: await addLoggedInCheckoutParam(result.cart, context, customerSession),
+		...result.errors && { errors: result.errors }
+	};
+	const headers = createProxyResponseHeaders(result.headers);
+	applyPrivateResponseCacheHeaders(headers);
+	return {
+		type: "json",
+		data,
+		headers
+	};
+}
+function logCartErrors(errors) {
+	if (!errors?.length) return;
+	log.error(errors.map(({ message }) => message).join("\n"));
+}
+async function handlePost(context, queries, customerSession) {
+	const { request, storefrontClient } = context;
+	const isFormRequest = !request.headers.get("content-type")?.includes("application/json");
+	const redirectTarget = safeRedirectTarget(request);
+	const parsedCartRequest = await parseCartAction(request, isFormRequest, redirectTarget);
+	if (parsedCartRequest.type === "response") return parsedCartRequest.response;
+	const cookieCartId = getCartIdFromCookie(request);
+	const cartId = parsedCartRequest.bodyCartId ?? cookieCartId;
+	const missingCartResponse = getMissingCartResponse(parsedCartRequest.action, cartId, isFormRequest, redirectTarget);
+	if (missingCartResponse) return missingCartResponse;
+	const { action } = parsedCartRequest;
+	const customerAccess = await getCartCreateCustomerAccess(parsedCartRequest.action, cartId, context, customerSession);
+	const customerSessionHeaders = customerAccess.commitSession ? await getCustomerSessionHeaders(context) : void 0;
+	const result = await executeCartMutation(action, cartId, storefrontClient, queries, customerAccess.accessToken, customerSessionHeaders);
+	if (result.type !== "mutation") return result.response;
+	const headers = createProxyResponseHeaders(result.headers);
+	appendHeaders(headers, customerSessionHeaders);
+	if (cartId === cookieCartId && result.cartId !== null && result.cartId !== cookieCartId) headers.append("set-cookie", createCartCookie(result.cartId));
+	if (isFormRequest) return redirectResult(redirectTarget, headers);
+	return jsonResult(result.data, headers);
+}
+async function parseCartAction(request, isFormRequest, redirectTarget) {
+	try {
+		const { action, cartId: bodyCartId } = await parseCartRequest(request);
+		return {
+			type: "action",
+			action,
+			bodyCartId
+		};
+	} catch (error) {
+		if (isFormRequest) return {
+			type: "response",
+			response: redirectResult(redirectTarget)
+		};
+		return {
+			type: "response",
+			response: errorResult("invalid_cart_request", getErrorMessage(error, "Bad Request"))
+		};
+	}
+}
+function getMissingCartResponse(action, cartId, isFormRequest, redirectTarget) {
+	if (action.intent === "add" || cartId) return void 0;
+	if (isFormRequest) return redirectResult(redirectTarget);
+	return errorResult("missing_cart", "No cart exists. Add an item first.");
+}
+async function executeCartMutation(action, cartId, storefrontClient, queries, customerAccessToken, customerSessionHeaders) {
+	try {
+		return {
+			type: "mutation",
+			...await executeMutation(action, cartId, storefrontClient, queries, customerAccessToken)
+		};
+	} catch (error) {
+		if (!customerSessionHeaders) throw error;
+		log.error("cart mutation failed", { error });
+		return {
+			type: "response",
+			response: errorResult("cart_mutation_failed", CART_MUTATION_FAILED_MESSAGE, customerSessionHeaders, CART_MUTATION_FAILED_STATUS)
+		};
+	}
+}
+async function getCustomerSessionHeaders(context) {
+	assertCustomerSessionWriteContext(context);
+	const sessionHeaders = await context.sessionManager.commit?.();
+	if (!sessionHeaders) return void 0;
+	return new Headers(sessionHeaders);
+}
+function appendHeaders(headers, headersToAppend) {
+	if (!headersToAppend) return;
+	for (const [key, value] of headersToAppend) if (key !== "set-cookie") headers.append(key, value);
+	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 "/";
+	}
+}
+function assertGraphQLData(result) {
+	if (result.errors || !result.data) {
+		const message = result.errors?.[0]?.message ?? "GraphQL error";
+		throw new Error(message);
+	}
+	return result.data;
+}
+function assertMutationData(result, key) {
+	const payload = assertGraphQLData(result)[key];
+	if (payload == null) throw new Error(`Missing ${String(key)} in mutation response`);
+	return payload;
+}
+function createMutationResult(cart, userErrors, warnings, headers) {
+	const storefrontCart = cart ?? null;
+	return {
+		data: {
+			cart: storefrontCart,
+			userErrors,
+			warnings
+		},
+		cartId: typeof storefrontCart?.id === "string" ? storefrontCart.id : null,
+		headers
+	};
+}
+async function executeMutation(action, cartId, storefront, queries, customerAccessToken) {
+	if (action.intent === "add") return executeAdd(action.lines, cartId, storefront, queries, customerAccessToken);
+	if (!cartId) throw new Error("cartId is required for non-add mutations");
+	switch (action.intent) {
+		case "update": {
+			const result = await storefront.graphql(queries.cartLinesUpdate, { variables: {
+				cartId,
+				lines: action.lines
+			} });
+			const { cart, userErrors, warnings } = assertMutationData(result, "cartLinesUpdate");
+			return createMutationResult(cart, userErrors, warnings, result.headers);
+		}
+		case "remove": {
+			const result = await storefront.graphql(queries.cartLinesRemove, { variables: {
+				cartId,
+				lineIds: action.lineIds
+			} });
+			const { cart, userErrors, warnings } = assertMutationData(result, "cartLinesRemove");
+			return createMutationResult(cart, userErrors, warnings, result.headers);
+		}
+		case "discount-update": {
+			const result = await storefront.graphql(queries.cartDiscountCodesUpdate, { variables: {
+				cartId,
+				discountCodes: action.discountCodes
+			} });
+			const { cart, userErrors, warnings } = assertMutationData(result, "cartDiscountCodesUpdate");
+			return createMutationResult(cart, userErrors, warnings, result.headers);
+		}
+		case "discount-apply": return executeDiscountModify(cartId, "apply", action.code, storefront, queries);
+		case "discount-remove": return executeDiscountModify(cartId, "remove", action.code, storefront, queries);
+		case "note-update": {
+			const result = await storefront.graphql(queries.cartNoteUpdate, { variables: {
+				cartId,
+				note: action.note
+			} });
+			const { cart, userErrors, warnings } = assertMutationData(result, "cartNoteUpdate");
+			return createMutationResult(cart, userErrors, warnings, result.headers);
+		}
+		case "attributes-update": {
+			const result = await storefront.graphql(queries.cartAttributesUpdate, { variables: {
+				cartId,
+				attributes: action.attributes
+			} });
+			const { cart, userErrors, warnings } = assertMutationData(result, "cartAttributesUpdate");
+			return createMutationResult(cart, userErrors, warnings, result.headers);
+		}
+		default: throw new Error(`Unhandled cart action intent: ${action.intent}`);
+	}
+}
+async function executeAdd(lines, cartId, storefront, queries, customerAccessToken) {
+	if (cartId) {
+		const result = await storefront.graphql(queries.cartLinesAdd, { variables: {
+			cartId,
+			lines
+		} });
+		const { cart, userErrors, warnings } = assertMutationData(result, "cartLinesAdd");
+		return createMutationResult(cart, userErrors, warnings, result.headers);
+	}
+	const result = await storefront.graphql(queries.cartCreate, { variables: { input: {
+		lines,
+		...customerAccessToken && { buyerIdentity: { customerAccessToken } }
+	} } });
+	const { cart, userErrors, warnings } = assertMutationData(result, "cartCreate");
+	return createMutationResult(cart, userErrors, warnings, result.headers);
+}
+async function getCartCreateCustomerAccess(action, cartId, context, customerSession) {
+	if (action.intent !== "add" || cartId || !customerSession) return { commitSession: false };
+	assertCustomerSessionWriteContext(context);
+	const accessToken = await customerSession.getAccessToken(context.sessionManager, context.requestContext);
+	if (accessToken) return {
+		accessToken,
+		commitSession: false
+	};
+	if (!await customerSession.isLoggedIn(context.sessionManager, context.requestContext)) return { commitSession: false };
+	const refreshResult = await getCustomerSessionRefreshResult(customerSession, context.sessionManager, context.requestContext);
+	if (refreshResult) return {
+		accessToken: refreshResult.accessToken,
+		commitSession: refreshResult.status !== "transient"
+	};
+	return {
+		accessToken: await customerSession.getOrRefreshAccessToken(context.sessionManager, context.requestContext),
+		commitSession: true
+	};
+}
+async function addLoggedInCheckoutParam(cart, context, customerSession) {
+	if (!cart || !customerSession) return cart;
+	assertCustomerSessionReadContext(context);
+	if (!await customerSession.isLoggedIn(context.sessionManager, context.requestContext)) return cart;
+	if (!cart.checkoutUrl) return cart;
+	const checkoutUrl = new URL(cart.checkoutUrl);
+	checkoutUrl.searchParams.set("logged_in", "true");
+	return {
+		...cart,
+		checkoutUrl: checkoutUrl.toString()
+	};
+}
+function assertCustomerSessionContext(context) {
+	if (context.sessionManager && context.requestContext) return;
+	throw new Error("Cart handlers configured with customerSession require sessionManager and requestContext.");
+}
+function assertCustomerSessionReadContext(context) {
+	assertCustomerSessionContext(context);
+}
+function assertCustomerSessionWriteContext(context) {
+	assertCustomerSessionContext(context);
+}
+async function executeDiscountModify(cartId, mode, code, storefront, queries) {
+	const currentCodes = (assertGraphQLData(await storefront.graphql(queries.cart, { variables: { id: cartId } })).cart?.discountCodes ?? []).map((dc) => dc.code);
+	const updatedCodes = mode === "apply" ? [...currentCodes, code] : currentCodes.filter((c) => c !== code);
+	const result = await storefront.graphql(queries.cartDiscountCodesUpdate, { variables: {
+		cartId,
+		discountCodes: updatedCodes
+	} });
+	const { cart, userErrors, warnings } = assertMutationData(result, "cartDiscountCodesUpdate");
+	return createMutationResult(cart, userErrors, warnings, result.headers);
+}
+function jsonResult(data, headers = {}) {
+	return {
+		type: "json",
+		data,
+		headers
+	};
+}
+function redirectResult(location, headers = {}) {
+	return {
+		type: "redirect",
+		location,
+		headers
+	};
+}
+function errorResult(code, message, headers, status) {
+	return {
+		type: "error",
+		error: {
+			code,
+			message
+		},
+		...headers && { headers },
+		...status !== void 0 && { status }
+	};
+}
+function getErrorMessage(error, fallback) {
+	if (error instanceof Error) return error.message;
+	return fallback;
+}
+
+//#endregion
+export { createCartServerHandlers };
+//# sourceMappingURL=server-handlers.mjs.map

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

@@ -0,0 +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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"}