@shopify/hydrogen 2026.10.0-preview.4 → 2026.10.0

package/dist/core/cart/queries.d.mts

@@ -1431,7 +1431,7 @@ declare const CUSTOM_CART_ATTRIBUTES_UPDATE_MUTATION: StorefrontQueryString<{
   cartId: string;
 }, "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        ...CartFragment\n      }\n      userErrors {\n        code\n        field\n        message\n      }\n      warnings {\n        code\n        message\n        target\n      }\n    }\n  }\n\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">;
 declare const DEFAULT_CART_QUERIES: {
-  readonly cart: StorefrontQueryString<{
+  /** Query that fetches a cart by ID. */readonly cart: StorefrontQueryString<{
     cart: {
       id: string;
       updatedAt: string;
@@ -1583,7 +1583,7 @@ declare const DEFAULT_CART_QUERIES: {
     language?: "ID" | "AF" | "DZ" | "AR" | "AM" | "AZ" | "BS" | "BE" | "BM" | "BO" | "BR" | "BN" | "BG" | "CA" | "KY" | "KM" | "HR" | "CU" | "CY" | "SV" | "EE" | "ET" | "FO" | "FI" | "FR" | "GA" | "DE" | "GL" | "GD" | "HU" | "IS" | "IT" | "KI" | "KW" | "LA" | "LV" | "LB" | "LT" | "LU" | "MO" | "MG" | "MY" | "ML" | "MT" | "MR" | "MN" | "MS" | "NL" | "NE" | "MK" | "NO" | "OM" | "PS" | "PA" | "PL" | "PT" | "RO" | "RU" | "RW" | "SH" | "KN" | "SA" | "SN" | "SC" | "SL" | "SG" | "SK" | "SI" | "SO" | "ES" | "SD" | "SR" | "SE" | "TH" | "TG" | "TK" | "TO" | "TT" | "TA" | "TR" | "UG" | "UZ" | "AK" | "AS" | "CE" | "CKB" | "CS" | "DA" | "EL" | "EN" | "EO" | "EU" | "FA" | "FF" | "FIL" | "FY" | "GU" | "GV" | "HA" | "HE" | "HI" | "HY" | "IA" | "IG" | "II" | "JA" | "JV" | "KA" | "KK" | "KL" | "KO" | "KS" | "KU" | "LG" | "LN" | "LO" | "MI" | "NB" | "ND" | "NN" | "OR" | "OS" | "PT_BR" | "PT_PT" | "QU" | "RM" | "RN" | "SQ" | "SU" | "SW" | "TE" | "TI" | "UK" | "UR" | "VI" | "WO" | "XH" | "YI" | "YO" | "ZH_CN" | "ZH_TW" | "ZU" | "ZH" | "VO" | null | undefined;
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     id: string;
-  }, "query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }\n\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">;
+  }, "query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }\n\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">; /** Mutation that creates a cart from a cart input. */
   readonly cartCreate: StorefrontQueryString<{
     cartCreate: {
       cart: {
@@ -1835,7 +1835,7 @@ declare const DEFAULT_CART_QUERIES: {
         key: string;
       }[] | null | undefined;
     };
-  }, "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\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">;
+  }, "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\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">; /** Mutation that adds merchandise lines to a cart. */
   readonly cartLinesAdd: StorefrontQueryString<{
     cartLinesAdd: {
       cart: {
@@ -2014,7 +2014,7 @@ declare const DEFAULT_CART_QUERIES: {
       }[] | null | undefined;
     }[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that updates existing lines in a cart. */
   readonly cartLinesUpdate: StorefrontQueryString<{
     cartLinesUpdate: {
       cart: {
@@ -2190,7 +2190,7 @@ declare const DEFAULT_CART_QUERIES: {
       id?: string | null | undefined;
     }[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that removes lines from a cart by line ID. */
   readonly cartLinesRemove: StorefrontQueryString<{
     cartLinesRemove: {
       cart: {
@@ -2356,7 +2356,7 @@ declare const DEFAULT_CART_QUERIES: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     lineIds: string[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that replaces a cart's discount codes. */
   readonly cartDiscountCodesUpdate: StorefrontQueryString<{
     cartDiscountCodesUpdate: {
       cart: {
@@ -2522,7 +2522,7 @@ declare const DEFAULT_CART_QUERIES: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     discountCodes: string[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that sets a cart's note. */
   readonly cartNoteUpdate: StorefrontQueryString<{
     cartNoteUpdate: {
       cart: {
@@ -2688,7 +2688,7 @@ declare const DEFAULT_CART_QUERIES: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     note: string;
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that sets a cart's custom attributes. */
   readonly cartAttributesUpdate: StorefrontQueryString<{
     cartAttributesUpdate: {
       cart: {
@@ -2888,15 +2888,21 @@ type NormalizeCartLines<TLines> = TLines extends {
   nodes: Array<CartLineFromNodes<TNodes>>;
 } : TLines;
 type CartLineFromNodes<TNodes> = TNodes extends CartLineConnection["nodes"] ? TNodes[number] : TNodes extends ReadonlyArray<infer TLine> ? TLine : never;
-/** Infers the {@link CartData} shape from `CreateCartServerHandlersOptions`. */
+/** Infers the cart data shape from cart server handler options. */
 type CartDataForOptions<TOptions> = CartDataFromCartQuery<CartQueriesForOptions<TOptions>["cart"]>;
-/** Resolves the cart query set from handler options — custom queries when a fragment is provided, defaults otherwise. */
+/** Resolves the cart queries for handler options. A fragment produces custom queries, and no fragment produces the default queries. */
 type CartQueriesForOptions<TOptions> = TOptions extends {
   readonly fragment: infer TCartFragment extends AnyStorefrontQueryString;
 } ? CartQueriesForFragment<TCartFragment> : DefaultCartQueries;
-/** Default cart GraphQL queries and mutations. */
+/**
+ * The default cart query and mutations that createCartServerHandlers runs.
+ *
+ * Each document returns the cart in the request's country and language through the `@inContext` directive. The Storefront API client fills both values from the request context's locale. The default cart fragment leaves out the variant's available quantity, which needs the `unauthenticated_read_product_inventory` Storefront API scope. Select the field in a custom cart fragment to cap quantities at available stock.
+ *
+ * @publicDocs
+ */
 declare const cartQueries: {
-  readonly cart: StorefrontQueryString<{
+  /** Query that fetches a cart by ID. */readonly cart: StorefrontQueryString<{
     cart: {
       id: string;
       updatedAt: string;
@@ -3048,7 +3054,7 @@ declare const cartQueries: {
     language?: "ID" | "AF" | "DZ" | "AR" | "AM" | "AZ" | "BS" | "BE" | "BM" | "BO" | "BR" | "BN" | "BG" | "CA" | "KY" | "KM" | "HR" | "CU" | "CY" | "SV" | "EE" | "ET" | "FO" | "FI" | "FR" | "GA" | "DE" | "GL" | "GD" | "HU" | "IS" | "IT" | "KI" | "KW" | "LA" | "LV" | "LB" | "LT" | "LU" | "MO" | "MG" | "MY" | "ML" | "MT" | "MR" | "MN" | "MS" | "NL" | "NE" | "MK" | "NO" | "OM" | "PS" | "PA" | "PL" | "PT" | "RO" | "RU" | "RW" | "SH" | "KN" | "SA" | "SN" | "SC" | "SL" | "SG" | "SK" | "SI" | "SO" | "ES" | "SD" | "SR" | "SE" | "TH" | "TG" | "TK" | "TO" | "TT" | "TA" | "TR" | "UG" | "UZ" | "AK" | "AS" | "CE" | "CKB" | "CS" | "DA" | "EL" | "EN" | "EO" | "EU" | "FA" | "FF" | "FIL" | "FY" | "GU" | "GV" | "HA" | "HE" | "HI" | "HY" | "IA" | "IG" | "II" | "JA" | "JV" | "KA" | "KK" | "KL" | "KO" | "KS" | "KU" | "LG" | "LN" | "LO" | "MI" | "NB" | "ND" | "NN" | "OR" | "OS" | "PT_BR" | "PT_PT" | "QU" | "RM" | "RN" | "SQ" | "SU" | "SW" | "TE" | "TI" | "UK" | "UR" | "VI" | "WO" | "XH" | "YI" | "YO" | "ZH_CN" | "ZH_TW" | "ZU" | "ZH" | "VO" | null | undefined;
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     id: string;
-  }, "query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }\n\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">;
+  }, "query Cart($id: ID!, $country: CountryCode, $language: LanguageCode)\n  @inContext(country: $country, language: $language) {\n    cart(id: $id) {\n      ...HydrogenCartFragment\n    }\n  }\n\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">; /** Mutation that creates a cart from a cart input. */
   readonly cartCreate: StorefrontQueryString<{
     cartCreate: {
       cart: {
@@ -3300,7 +3306,7 @@ declare const cartQueries: {
         key: string;
       }[] | null | undefined;
     };
-  }, "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\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">;
+  }, "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\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">; /** Mutation that adds merchandise lines to a cart. */
   readonly cartLinesAdd: StorefrontQueryString<{
     cartLinesAdd: {
       cart: {
@@ -3479,7 +3485,7 @@ declare const cartQueries: {
       }[] | null | undefined;
     }[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that updates existing lines in a cart. */
   readonly cartLinesUpdate: StorefrontQueryString<{
     cartLinesUpdate: {
       cart: {
@@ -3655,7 +3661,7 @@ declare const cartQueries: {
       id?: string | null | undefined;
     }[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that removes lines from a cart by line ID. */
   readonly cartLinesRemove: StorefrontQueryString<{
     cartLinesRemove: {
       cart: {
@@ -3821,7 +3827,7 @@ declare const cartQueries: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     lineIds: string[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that replaces a cart's discount codes. */
   readonly cartDiscountCodesUpdate: StorefrontQueryString<{
     cartDiscountCodesUpdate: {
       cart: {
@@ -3987,7 +3993,7 @@ declare const cartQueries: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     discountCodes: string[];
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that sets a cart's note. */
   readonly cartNoteUpdate: StorefrontQueryString<{
     cartNoteUpdate: {
       cart: {
@@ -4153,7 +4159,7 @@ declare const cartQueries: {
     country?: "ID" | "AF" | "AX" | "AL" | "DZ" | "AD" | "AO" | "AI" | "AG" | "AR" | "AM" | "AW" | "AC" | "AU" | "AT" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BE" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CA" | "CV" | "BQ" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "HR" | "CU" | "CW" | "CY" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "EE" | "SZ" | "ET" | "FK" | "FO" | "FJ" | "FI" | "FR" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "DE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "HU" | "IS" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "IT" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "XK" | "KW" | "KG" | "LA" | "LV" | "LB" | "LS" | "LR" | "LY" | "LI" | "LT" | "LU" | "MO" | "MG" | "MW" | "MY" | "MV" | "ML" | "MT" | "MQ" | "MR" | "MU" | "YT" | "MX" | "MD" | "MC" | "MN" | "ME" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "NL" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MK" | "NO" | "OM" | "PK" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PL" | "PT" | "QA" | "CM" | "RE" | "RO" | "RU" | "RW" | "BL" | "SH" | "KN" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "SA" | "SN" | "RS" | "SC" | "SL" | "SG" | "SX" | "SK" | "SI" | "SB" | "SO" | "ZA" | "GS" | "KR" | "SS" | "ES" | "LK" | "VC" | "SD" | "SR" | "SJ" | "SE" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TA" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "UZ" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
     note: string;
     cartId: string;
-  }, "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\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">;
+  }, "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\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">; /** Mutation that sets a cart's custom attributes. */
   readonly cartAttributesUpdate: StorefrontQueryString<{
     cartAttributesUpdate: {
       cart: {

package/dist/core/cart/queries.mjs

@@ -26,13 +26,21 @@ const CUSTOM_CART_NOTE_UPDATE_MUTATION = gql(`mutation CartNoteUpdate($cartId:ID
 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 = {
+	/** Query that fetches a cart by ID. */
 	cart: CART_QUERY,
+	/** Mutation that creates a cart from a cart input. */
 	cartCreate: CART_CREATE_MUTATION,
+	/** Mutation that adds merchandise lines to a cart. */
 	cartLinesAdd: CART_LINES_ADD_MUTATION,
+	/** Mutation that updates existing lines in a cart. */
 	cartLinesUpdate: CART_LINES_UPDATE_MUTATION,
+	/** Mutation that removes lines from a cart by line ID. */
 	cartLinesRemove: CART_LINES_REMOVE_MUTATION,
+	/** Mutation that replaces a cart's discount codes. */
 	cartDiscountCodesUpdate: CART_DISCOUNT_CODES_UPDATE_MUTATION,
+	/** Mutation that sets a cart's note. */
 	cartNoteUpdate: CART_NOTE_UPDATE_MUTATION,
+	/** Mutation that sets a cart's custom attributes. */
 	cartAttributesUpdate: CART_ATTRIBUTES_UPDATE_MUTATION
 };
 const cartBuyerIdentityUpdateMutation = gql(CART_BUYER_IDENTITY_UPDATE_MUTATION_SOURCE);
@@ -63,7 +71,13 @@ function makeCartQueries(options) {
 	}
 	return DEFAULT_CART_QUERIES;
 }
-/** Default cart GraphQL queries and mutations. */
+/**
+* The default cart query and mutations that createCartServerHandlers runs.
+*
+* Each document returns the cart in the request's country and language through the `@inContext` directive. The Storefront API client fills both values from the request context's locale. The default cart fragment leaves out the variant's available quantity, which needs the `unauthenticated_read_product_inventory` Storefront API scope. Select the field in a custom cart fragment to cap quantities at available stock.
+*
+* @publicDocs
+*/
 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    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"}
+{"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  /** Query that fetches a cart by ID. */\n  cart: CART_QUERY,\n  /** Mutation that creates a cart from a cart input. */\n  cartCreate: CART_CREATE_MUTATION,\n  /** Mutation that adds merchandise lines to a cart. */\n  cartLinesAdd: CART_LINES_ADD_MUTATION,\n  /** Mutation that updates existing lines in a cart. */\n  cartLinesUpdate: CART_LINES_UPDATE_MUTATION,\n  /** Mutation that removes lines from a cart by line ID. */\n  cartLinesRemove: CART_LINES_REMOVE_MUTATION,\n  /** Mutation that replaces a cart's discount codes. */\n  cartDiscountCodesUpdate: CART_DISCOUNT_CODES_UPDATE_MUTATION,\n  /** Mutation that sets a cart's note. */\n  cartNoteUpdate: CART_NOTE_UPDATE_MUTATION,\n  /** Mutation that sets a cart's custom attributes. */\n  cartAttributesUpdate: CART_ATTRIBUTES_UPDATE_MUTATION,\n} as const satisfies CartQueriesForDocs;\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 cart data shape from cart server handler options. */\nexport type CartDataForOptions<TOptions> = CartDataFromCartQuery<\n  CartQueriesForOptions<TOptions>[\"cart\"]\n>;\n\n/**\n * Options for building cart queries with a custom cart fragment.\n *\n * The fragment extends the default Hydrogen cart fragment. Every cart query and\n * mutation response includes your additional fields.\n */\nexport type CreateCartQueriesOptions<\n  TCartFragment extends AnyStorefrontQueryString = AnyStorefrontQueryString,\n> = {\n  /**\n   * Cart fragment spread into every cart query and mutation response.\n   *\n   * Name the fragment `CartFragment` and target the `Cart` type.\n   */\n  readonly fragment: TCartFragment;\n};\n\n/** Resolves the cart queries for handler options. A fragment produces custom queries, and no fragment produces the default queries. */\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 custom\n * fragment, returns queries that spread the default Hydrogen cart fragment and\n * your fragment into every response. 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/**\n * The default cart query and mutations that createCartServerHandlers runs.\n *\n * Each document returns the cart in the request's country and language through the `@inContext` directive. The Storefront API client fills both values from the request context's locale. The default cart fragment leaves out the variant's available quantity, which needs the `unauthenticated_read_product_inventory` Storefront API scope. Select the field in a custom cart fragment to cap quantities at available stock.\n *\n * @publicDocs\n */\nexport const cartQueries = makeCartQueries();\n\n/**\n * The default cart query and mutation documents. Each mutation returns the cart, user errors, and warnings.\n *\n * @publicDocs\n */\nexport interface CartQueriesForDocs {\n  /** Query that fetches a cart by ID. */\n  readonly cart: StorefrontQueryString;\n  /** Mutation that creates a cart from a cart input. */\n  readonly cartCreate: StorefrontQueryString;\n  /** Mutation that adds merchandise lines to a cart. */\n  readonly cartLinesAdd: StorefrontQueryString;\n  /** Mutation that updates existing lines in a cart. */\n  readonly cartLinesUpdate: StorefrontQueryString;\n  /** Mutation that removes lines from a cart by line ID. */\n  readonly cartLinesRemove: StorefrontQueryString;\n  /** Mutation that replaces a cart's discount codes. */\n  readonly cartDiscountCodesUpdate: StorefrontQueryString;\n  /** Mutation that sets a cart's note. */\n  readonly cartNoteUpdate: StorefrontQueryString;\n  /** Mutation that sets a cart's custom attributes. */\n  readonly cartAttributesUpdate: StorefrontQueryString;\n}\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;;CAEA,MAAA;;CAEA,YAAA;;CAEA,cAAA;;CAEA,iBAAA;;CAEA,iBAAA;;CAEA,yBAAA;;CAEA,gBAAA;;CAEA,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;;AAyBA,SAAA,gBAAA,SAAA;AACA,KAAA,SAAA;AACA,yBAAA,QAAA,SAAA;AACA,SAAA,kBAAA,QAAA,SAAA;;AAGA,QAAA;;;;;;;;;AAUA,MAAA,cAAA,iBAAA"}