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

package/dist/graphql/generated/graphql-env.d.mts

@@ -748,6 +748,73 @@ type introspection_types = {
       };
     };
   };
+  'BaseCartDiscountApplication': {
+    kind: 'INTERFACE';
+    name: 'BaseCartDiscountApplication';
+    fields: {
+      'allocationMethod': {
+        name: 'allocationMethod';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationAllocationMethod';
+            ofType: null;
+          };
+        };
+      };
+      'targetSelection': {
+        name: 'targetSelection';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetSelection';
+            ofType: null;
+          };
+        };
+      };
+      'targetType': {
+        name: 'targetType';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetType';
+            ofType: null;
+          };
+        };
+      };
+      'totalAllocatedAmount': {
+        name: 'totalAllocatedAmount';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'OBJECT';
+            name: 'MoneyV2';
+            ofType: null;
+          };
+        };
+      };
+      'value': {
+        name: 'value';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'UNION';
+            name: 'PricingValue';
+            ofType: null;
+          };
+        };
+      };
+    };
+    possibleTypes: 'CartAutomaticDiscountApplication' | 'CartCodeDiscountApplication' | 'CartCustomDiscountApplication';
+  };
   'BaseCartLine': {
     kind: 'INTERFACE';
     name: 'BaseCartLine';
@@ -868,6 +935,14 @@ type introspection_types = {
           ofType: null;
         };
       };
+      'viewKey': {
+        name: 'viewKey';
+        type: {
+          kind: 'SCALAR';
+          name: 'String';
+          ofType: null;
+        };
+      };
     };
     possibleTypes: 'CartLine' | 'ComponentizableCartLine';
   };
@@ -1474,6 +1549,26 @@ type introspection_types = {
           };
         };
       };
+      'discountApplications': {
+        name: 'discountApplications';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'LIST';
+            name: never;
+            ofType: {
+              kind: 'NON_NULL';
+              name: never;
+              ofType: {
+                kind: 'INTERFACE';
+                name: 'BaseCartDiscountApplication';
+                ofType: null;
+              };
+            };
+          };
+        };
+      };
       'discountCodes': {
         name: 'discountCodes';
         type: {
@@ -1698,6 +1793,18 @@ type introspection_types = {
           };
         };
       };
+      'sourceDiscountApplication': {
+        name: 'sourceDiscountApplication';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'INTERFACE';
+            name: 'BaseCartDiscountApplication';
+            ofType: null;
+          };
+        };
+      };
       'targetType': {
         name: 'targetType';
         type: {
@@ -1724,6 +1831,84 @@ type introspection_types = {
       };
     };
   };
+  'CartAutomaticDiscountApplication': {
+    kind: 'OBJECT';
+    name: 'CartAutomaticDiscountApplication';
+    fields: {
+      'allocationMethod': {
+        name: 'allocationMethod';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationAllocationMethod';
+            ofType: null;
+          };
+        };
+      };
+      'targetSelection': {
+        name: 'targetSelection';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetSelection';
+            ofType: null;
+          };
+        };
+      };
+      'targetType': {
+        name: 'targetType';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetType';
+            ofType: null;
+          };
+        };
+      };
+      'title': {
+        name: 'title';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'SCALAR';
+            name: 'String';
+            ofType: null;
+          };
+        };
+      };
+      'totalAllocatedAmount': {
+        name: 'totalAllocatedAmount';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'OBJECT';
+            name: 'MoneyV2';
+            ofType: null;
+          };
+        };
+      };
+      'value': {
+        name: 'value';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'UNION';
+            name: 'PricingValue';
+            ofType: null;
+          };
+        };
+      };
+    };
+  };
   'CartBillingAddressUpdatePayload': {
     kind: 'OBJECT';
     name: 'CartBillingAddressUpdatePayload';
@@ -2074,6 +2259,18 @@ type introspection_types = {
           };
         };
       };
+      'sourceDiscountApplication': {
+        name: 'sourceDiscountApplication';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'INTERFACE';
+            name: 'BaseCartDiscountApplication';
+            ofType: null;
+          };
+        };
+      };
       'targetType': {
         name: 'targetType';
         type: {
@@ -2088,6 +2285,84 @@ type introspection_types = {
       };
     };
   };
+  'CartCodeDiscountApplication': {
+    kind: 'OBJECT';
+    name: 'CartCodeDiscountApplication';
+    fields: {
+      'allocationMethod': {
+        name: 'allocationMethod';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationAllocationMethod';
+            ofType: null;
+          };
+        };
+      };
+      'code': {
+        name: 'code';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'SCALAR';
+            name: 'String';
+            ofType: null;
+          };
+        };
+      };
+      'targetSelection': {
+        name: 'targetSelection';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetSelection';
+            ofType: null;
+          };
+        };
+      };
+      'targetType': {
+        name: 'targetType';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetType';
+            ofType: null;
+          };
+        };
+      };
+      'totalAllocatedAmount': {
+        name: 'totalAllocatedAmount';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'OBJECT';
+            name: 'MoneyV2';
+            ofType: null;
+          };
+        };
+      };
+      'value': {
+        name: 'value';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'UNION';
+            name: 'PricingValue';
+            ofType: null;
+          };
+        };
+      };
+    };
+  };
   'CartCompletionAction': {
     kind: 'UNION';
     name: 'CartCompletionAction';
@@ -2432,6 +2707,72 @@ type introspection_types = {
           };
         };
       };
+      'sourceDiscountApplication': {
+        name: 'sourceDiscountApplication';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'INTERFACE';
+            name: 'BaseCartDiscountApplication';
+            ofType: null;
+          };
+        };
+      };
+      'targetType': {
+        name: 'targetType';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetType';
+            ofType: null;
+          };
+        };
+      };
+      'title': {
+        name: 'title';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'SCALAR';
+            name: 'String';
+            ofType: null;
+          };
+        };
+      };
+    };
+  };
+  'CartCustomDiscountApplication': {
+    kind: 'OBJECT';
+    name: 'CartCustomDiscountApplication';
+    fields: {
+      'allocationMethod': {
+        name: 'allocationMethod';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationAllocationMethod';
+            ofType: null;
+          };
+        };
+      };
+      'targetSelection': {
+        name: 'targetSelection';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'ENUM';
+            name: 'DiscountApplicationTargetSelection';
+            ofType: null;
+          };
+        };
+      };
       'targetType': {
         name: 'targetType';
         type: {
@@ -2456,6 +2797,30 @@ type introspection_types = {
           };
         };
       };
+      'totalAllocatedAmount': {
+        name: 'totalAllocatedAmount';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'OBJECT';
+            name: 'MoneyV2';
+            ofType: null;
+          };
+        };
+      };
+      'value': {
+        name: 'value';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'UNION';
+            name: 'PricingValue';
+            ofType: null;
+          };
+        };
+      };
     };
   };
   'CartDelivery': {
@@ -3056,6 +3421,26 @@ type introspection_types = {
           };
         };
       };
+      'discountAllocations': {
+        name: 'discountAllocations';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'LIST';
+            name: never;
+            ofType: {
+              kind: 'NON_NULL';
+              name: never;
+              ofType: {
+                kind: 'INTERFACE';
+                name: 'CartDiscountAllocation';
+                ofType: null;
+              };
+            };
+          };
+        };
+      };
       'groupType': {
         name: 'groupType';
         type: {
@@ -3444,6 +3829,18 @@ type introspection_types = {
           };
         };
       };
+      'sourceDiscountApplication': {
+        name: 'sourceDiscountApplication';
+        type: {
+          kind: 'NON_NULL';
+          name: never;
+          ofType: {
+            kind: 'INTERFACE';
+            name: 'BaseCartDiscountApplication';
+            ofType: null;
+          };
+        };
+      };
       'targetType': {
         name: 'targetType';
         type: {
@@ -3947,6 +4344,14 @@ type introspection_types = {
         };
       };
       defaultValue: null;
+    }, {
+      name: 'sourceName';
+      type: {
+        kind: 'SCALAR';
+        name: 'String';
+        ofType: null;
+      };
+      defaultValue: null;
     }];
   };
   'CartInputMetafieldInput': {
@@ -4131,6 +4536,14 @@ type introspection_types = {
           ofType: null;
         };
       };
+      'viewKey': {
+        name: 'viewKey';
+        type: {
+          kind: 'SCALAR';
+          name: 'String';
+          ofType: null;
+        };
+      };
     };
   };
   'CartLineCost': {
@@ -4368,13 +4781,17 @@ type introspection_types = {
     inputFields: [{
       name: 'id';
       type: {
-        kind: 'NON_NULL';
-        name: never;
-        ofType: {
-          kind: 'SCALAR';
-          name: 'ID';
-          ofType: null;
-        };
+        kind: 'SCALAR';
+        name: 'ID';
+        ofType: null;
+      };
+      defaultValue: null;
+    }, {
+      name: 'viewKey';
+      type: {
+        kind: 'SCALAR';
+        name: 'String';
+        ofType: null;
       };
       defaultValue: null;
     }, {
@@ -5531,7 +5948,7 @@ type introspection_types = {
   };
   'CartWarningCode': {
     name: 'CartWarningCode';
-    enumValues: 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'MERCHANDISE_OUT_OF_STOCK' | 'PAYMENTS_GIFT_CARDS_UNAVAILABLE' | 'DUPLICATE_DELIVERY_ADDRESS' | 'DISCOUNT_CODE_NOT_HONOURED' | 'DISCOUNT_NOT_FOUND' | 'DISCOUNT_CURRENTLY_INACTIVE' | 'DISCOUNT_USAGE_LIMIT_REACHED' | 'DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED' | 'DISCOUNT_CUSTOMER_NOT_ELIGIBLE' | 'DISCOUNT_ELIGIBLE_CUSTOMER_MISSING' | 'DISCOUNT_QUANTITY_NOT_IN_RANGE' | 'DISCOUNT_PURCHASE_NOT_IN_RANGE' | 'DISCOUNT_NO_ENTITLED_LINE_ITEMS' | 'DISCOUNT_NO_ENTITLED_SHIPPING_LINES' | 'DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE' | 'MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION';
+    enumValues: 'MERCHANDISE_NOT_ENOUGH_STOCK' | 'MERCHANDISE_OUT_OF_STOCK' | 'PAYMENTS_GIFT_CARDS_UNAVAILABLE' | 'DUPLICATE_DELIVERY_ADDRESS' | 'DISCOUNT_CODE_NOT_HONOURED' | 'DISCOUNT_NOT_FOUND' | 'DISCOUNT_CURRENTLY_INACTIVE' | 'DISCOUNT_USAGE_LIMIT_REACHED' | 'DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED' | 'DISCOUNT_CUSTOMER_NOT_ELIGIBLE' | 'DISCOUNT_ELIGIBLE_CUSTOMER_MISSING' | 'DISCOUNT_QUANTITY_NOT_IN_RANGE' | 'DISCOUNT_PURCHASE_NOT_IN_RANGE' | 'DISCOUNT_NO_ENTITLED_LINE_ITEMS' | 'DISCOUNT_NO_ENTITLED_SHIPPING_LINES' | 'DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE' | 'MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION' | 'PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION';
   };
   'CategoryFilter': {
     kind: 'INPUT_OBJECT';
@@ -6400,6 +6817,14 @@ type introspection_types = {
           ofType: null;
         };
       };
+      'viewKey': {
+        name: 'viewKey';
+        type: {
+          kind: 'SCALAR';
+          name: 'String';
+          ofType: null;
+        };
+      };
     };
   };
   'Count': {
@@ -6582,7 +7007,7 @@ type introspection_types = {
   };
   'CurrencyCode': {
     name: 'CurrencyCode';
-    enumValues: 'USD' | 'EUR' | 'GBP' | 'CAD' | 'AFN' | 'ALL' | 'DZD' | 'AOA' | 'ARS' | 'AMD' | 'AWG' | 'AUD' | 'BBD' | 'AZN' | 'BDT' | 'BSD' | 'BHD' | 'BIF' | 'BZD' | 'BMD' | 'BTN' | 'BAM' | 'BRL' | 'BOB' | 'BWP' | 'BND' | 'BGN' | 'MMK' | 'KHR' | 'CVE' | 'KYD' | 'XAF' | 'CLP' | 'CNY' | 'COP' | 'KMF' | 'CDF' | 'CRC' | 'HRK' | 'CZK' | 'DKK' | 'DOP' | 'XCD' | 'EGP' | 'ERN' | 'ETB' | 'FKP' | 'XPF' | 'FJD' | 'GIP' | 'GMD' | 'GHS' | 'GTQ' | 'GYD' | 'GEL' | 'HTG' | 'HNL' | 'HKD' | 'HUF' | 'ISK' | 'INR' | 'IDR' | 'ILS' | 'IQD' | 'JMD' | 'JPY' | 'JEP' | 'JOD' | 'KZT' | 'KES' | 'KID' | 'KWD' | 'KGS' | 'LAK' | 'LVL' | 'LBP' | 'LSL' | 'LRD' | 'LTL' | 'MGA' | 'MKD' | 'MOP' | 'MWK' | 'MVR' | 'MRU' | 'MXN' | 'MYR' | 'MUR' | 'MDL' | 'MAD' | 'MNT' | 'MZN' | 'NAD' | 'NPR' | 'ANG' | 'NZD' | 'NIO' | 'NGN' | 'NOK' | 'OMR' | 'PAB' | 'PKR' | 'PGK' | 'PYG' | 'PEN' | 'PHP' | 'PLN' | 'QAR' | 'RON' | 'RUB' | 'RWF' | 'WST' | 'SHP' | 'SAR' | 'RSD' | 'SCR' | 'SGD' | 'SDG' | 'SOS' | 'SYP' | 'ZAR' | 'KRW' | 'SSP' | 'SBD' | 'LKR' | 'SRD' | 'SZL' | 'SEK' | 'CHF' | 'TWD' | 'THB' | 'TZS' | 'TTD' | 'TND' | 'TRY' | 'TMT' | 'UGX' | 'UAH' | 'AED' | 'UYU' | 'UZS' | 'VUV' | 'VES' | 'VND' | 'XOF' | 'YER' | 'ZMW' | 'BYN' | 'BYR' | 'DJF' | 'GNF' | 'IRR' | 'LYD' | 'SLL' | 'STD' | 'STN' | 'TJS' | 'TOP' | 'VED' | 'VEF' | 'XXX';
+    enumValues: 'USD' | 'EUR' | 'GBP' | 'CAD' | 'AFN' | 'ALL' | 'DZD' | 'AOA' | 'ARS' | 'AMD' | 'AWG' | 'AUD' | 'BBD' | 'AZN' | 'BDT' | 'BSD' | 'BHD' | 'BIF' | 'BZD' | 'BMD' | 'BTN' | 'BAM' | 'BRL' | 'BOB' | 'BWP' | 'BND' | 'BGN' | 'MMK' | 'KHR' | 'CVE' | 'XCG' | 'KYD' | 'XAF' | 'CLP' | 'CNY' | 'COP' | 'KMF' | 'CDF' | 'CRC' | 'HRK' | 'CZK' | 'DKK' | 'DOP' | 'XCD' | 'EGP' | 'ERN' | 'ETB' | 'FKP' | 'XPF' | 'FJD' | 'GIP' | 'GMD' | 'GHS' | 'GTQ' | 'GYD' | 'GEL' | 'HTG' | 'HNL' | 'HKD' | 'HUF' | 'ISK' | 'INR' | 'IDR' | 'ILS' | 'IQD' | 'JMD' | 'JPY' | 'JEP' | 'JOD' | 'KZT' | 'KES' | 'KID' | 'KWD' | 'KGS' | 'LAK' | 'LVL' | 'LBP' | 'LSL' | 'LRD' | 'LTL' | 'MGA' | 'MKD' | 'MOP' | 'MWK' | 'MVR' | 'MRU' | 'MXN' | 'MYR' | 'MUR' | 'MDL' | 'MAD' | 'MNT' | 'MZN' | 'NAD' | 'NPR' | 'ANG' | 'NZD' | 'NIO' | 'NGN' | 'NOK' | 'OMR' | 'PAB' | 'PKR' | 'PGK' | 'PYG' | 'PEN' | 'PHP' | 'PLN' | 'QAR' | 'RON' | 'RUB' | 'RWF' | 'WST' | 'SHP' | 'SAR' | 'RSD' | 'SCR' | 'SGD' | 'SDG' | 'SOS' | 'SYP' | 'ZAR' | 'KRW' | 'SSP' | 'SBD' | 'LKR' | 'SRD' | 'SZL' | 'SEK' | 'CHF' | 'TWD' | 'THB' | 'TZS' | 'TTD' | 'TND' | 'TRY' | 'TMT' | 'UGX' | 'UAH' | 'AED' | 'UYU' | 'UZS' | 'VUV' | 'VES' | 'VND' | 'XOF' | 'YER' | 'ZMW' | 'BYN' | 'BYR' | 'DJF' | 'GNF' | 'IRR' | 'LYD' | 'SLL' | 'STD' | 'STN' | 'TJS' | 'TOP' | 'VED' | 'VEF' | 'XXX';
   };
   'Customer': {
     kind: 'OBJECT';
@@ -17594,6 +18019,14 @@ type introspection_types = {
           };
         };
       };
+      'shopUser': {
+        name: 'shopUser';
+        type: {
+          kind: 'OBJECT';
+          name: 'ShopPayPaymentRequestShopUser';
+          ofType: null;
+        };
+      };
       'token': {
         name: 'token';
         type: {
@@ -17627,13 +18060,9 @@ type introspection_types = {
       'paymentRequest': {
         name: 'paymentRequest';
         type: {
-          kind: 'NON_NULL';
-          name: never;
-          ofType: {
-            kind: 'OBJECT';
-            name: 'ShopPayPaymentRequest';
-            ofType: null;
-          };
+          kind: 'OBJECT';
+          name: 'ShopPayPaymentRequest';
+          ofType: null;
         };
       };
       'sourceIdentifier': {
@@ -17802,6 +18231,20 @@ type introspection_types = {
       defaultValue: null;
     }];
   };
+  'ShopPayPaymentRequestShopUser': {
+    kind: 'OBJECT';
+    name: 'ShopPayPaymentRequestShopUser';
+    fields: {
+      'publicId': {
+        name: 'publicId';
+        type: {
+          kind: 'SCALAR';
+          name: 'String';
+          ofType: null;
+        };
+      };
+    };
+  };
   'ShopPayPaymentRequestTotalShippingPrice': {
     kind: 'OBJECT';
     name: 'ShopPayPaymentRequestTotalShippingPrice';

package/dist/graphql/generated/storefront-api-types.d.mts

@@ -5,7 +5,7 @@
  */
 type CartErrorCode = /** The specified address field contains emojis. */"ADDRESS_FIELD_CONTAINS_EMOJIS" /** The specified address field contains HTML tags. */ | "ADDRESS_FIELD_CONTAINS_HTML_TAGS" /** The specified address field contains a URL. */ | "ADDRESS_FIELD_CONTAINS_URL" /** The specified address field does not match the expected pattern. */ | "ADDRESS_FIELD_DOES_NOT_MATCH_EXPECTED_PATTERN" /** The specified address field is required. */ | "ADDRESS_FIELD_IS_REQUIRED" /** The specified address field is too long. */ | "ADDRESS_FIELD_IS_TOO_LONG" /** Bundles and addons cannot be mixed. */ | "BUNDLES_AND_ADDONS_CANNOT_BE_MIXED" /** Buyer cannot purchase for company location. */ | "BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION" /** The cart is too large to save. */ | "CART_TOO_LARGE" /** The specified gift card recipient is invalid. */ | "GIFT_CARD_RECIPIENT_INVALID" /** The input value is invalid. */ | "INVALID" /** Company location not found or not allowed. */ | "INVALID_COMPANY_LOCATION" /** The delivery address was not found. */ | "INVALID_DELIVERY_ADDRESS_ID" /** Delivery group was not found in cart. */ | "INVALID_DELIVERY_GROUP" /** Delivery option was not valid. */ | "INVALID_DELIVERY_OPTION" /** The quantity must be a multiple of the specified increment. */ | "INVALID_INCREMENT" /** Merchandise line was not found in cart. */ | "INVALID_MERCHANDISE_LINE" /** The metafields were not valid. */ | "INVALID_METAFIELDS" /** The payment wasn't valid. */ | "INVALID_PAYMENT" /** The payment is invalid. Deferred payment is required. */ | "INVALID_PAYMENT_DEFERRED_PAYMENT_REQUIRED" /** Cannot update payment on an empty cart */ | "INVALID_PAYMENT_EMPTY_CART" /** The given zip code is invalid for the provided country. */ | "INVALID_ZIP_CODE_FOR_COUNTRY" /** The given zip code is invalid for the provided province. */ | "INVALID_ZIP_CODE_FOR_PROVINCE" /** The input value should be less than the maximum value allowed. */ | "LESS_THAN" /** The quantity must be below the specified maximum for the item. */ | "MAXIMUM_EXCEEDED" /** An error occurred while processing cart transformations. */ | "MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR" /** Item cannot be purchased as configured. */ | "MERCHANDISE_NOT_APPLICABLE" /** The quantity must be above the specified minimum for the item. */ | "MINIMUM_NOT_MET" /** The customer access token is required when setting a company location. */ | "MISSING_CUSTOMER_ACCESS_TOKEN" /** Missing discount code. */ | "MISSING_DISCOUNT_CODE" /** Missing note. */ | "MISSING_NOTE" /** The note length must be below the specified maximum. */ | "NOTE_TOO_LONG" /** Only one delivery address can be selected. */ | "ONLY_ONE_DELIVERY_ADDRESS_CAN_BE_SELECTED" /** Cannot reference existing parent lines by variant_id. */ | "PARENT_LINE_INVALID_REFERENCE" /** Parent line nesting is too deep or circular. */ | "PARENT_LINE_NESTING_TOO_DEEP" /** Parent line not found. */ | "PARENT_LINE_NOT_FOUND" /** Nested cartlines are blocked due to an incompatibility. */ | "PARENT_LINE_OPERATION_BLOCKED" /** Credit card has expired. */ | "PAYMENTS_CREDIT_CARD_BASE_EXPIRED" /** Credit card gateway is not supported. */ | "PAYMENTS_CREDIT_CARD_BASE_GATEWAY_NOT_SUPPORTED" /** Credit card error. */ | "PAYMENTS_CREDIT_CARD_GENERIC" /** Credit card month is invalid. */ | "PAYMENTS_CREDIT_CARD_MONTH_INCLUSION" /** Credit card number is invalid. */ | "PAYMENTS_CREDIT_CARD_NUMBER_INVALID" /** Credit card number format is invalid. */ | "PAYMENTS_CREDIT_CARD_NUMBER_INVALID_FORMAT" /** Credit card verification value is blank. */ | "PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_BLANK" /** Credit card verification value is invalid for card type. */ | "PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_INVALID_FOR_CARD_TYPE" /** Credit card has expired. */ | "PAYMENTS_CREDIT_CARD_YEAR_EXPIRED" /** Credit card expiry year is invalid. */ | "PAYMENTS_CREDIT_CARD_YEAR_INVALID_EXPIRY_YEAR" /** The payment method is not applicable. */ | "PAYMENT_METHOD_NOT_APPLICABLE" /** The payment method is not supported. */ | "PAYMENT_METHOD_NOT_SUPPORTED" /** The delivery group is in a pending state. */ | "PENDING_DELIVERY_GROUPS" /** The given province cannot be found. */ | "PROVINCE_NOT_FOUND" /** Selling plan is not applicable. */ | "SELLING_PLAN_NOT_APPLICABLE" /** An error occurred while saving the cart. */ | "SERVICE_UNAVAILABLE" /** Too many delivery addresses on Cart. */ | "TOO_MANY_DELIVERY_ADDRESSES" /** A general error occurred during address validation. */ | "UNSPECIFIED_ADDRESS_ERROR" /** Validation failed. */ | "VALIDATION_CUSTOM" /** Variant can only be purchased with a selling plan. */ | "VARIANT_REQUIRES_SELLING_PLAN" /** The given zip code is unsupported. */ | "ZIP_CODE_NOT_SUPPORTED";
 /** The code for the cart warning. */
-type CartWarningCode = /** The discount code cannot be honored. */"DISCOUNT_CODE_NOT_HONOURED" /** The discount is currently inactive. */ | "DISCOUNT_CURRENTLY_INACTIVE" /** The customer is not eligible for this discount. */ | "DISCOUNT_CUSTOMER_NOT_ELIGIBLE" /** The customer's discount usage limit has been reached. */ | "DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED" /** An eligible customer is missing for this discount. */ | "DISCOUNT_ELIGIBLE_CUSTOMER_MISSING" /** The purchase type is incompatible with this discount. */ | "DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE" /** The discount was not found. */ | "DISCOUNT_NOT_FOUND" /** There are no entitled line items for this discount. */ | "DISCOUNT_NO_ENTITLED_LINE_ITEMS" /** There are no entitled shipping lines for this discount. */ | "DISCOUNT_NO_ENTITLED_SHIPPING_LINES" /** The purchase is not in range for this discount. */ | "DISCOUNT_PURCHASE_NOT_IN_RANGE" /** The quantity is not in range for this discount. */ | "DISCOUNT_QUANTITY_NOT_IN_RANGE" /** The discount usage limit has been reached. */ | "DISCOUNT_USAGE_LIMIT_REACHED" /** A delivery address with the same details already exists on this cart. */ | "DUPLICATE_DELIVERY_ADDRESS" /** The merchandise does not have enough stock. */ | "MERCHANDISE_NOT_ENOUGH_STOCK" /** The merchandise is out of stock. */ | "MERCHANDISE_OUT_OF_STOCK" /** Only one-time purchase is available for B2B orders. */ | "MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION" /** Gift cards are not available as a payment method. */ | "PAYMENTS_GIFT_CARDS_UNAVAILABLE";
+type CartWarningCode = /** The discount code cannot be honored. */"DISCOUNT_CODE_NOT_HONOURED" /** The discount is currently inactive. */ | "DISCOUNT_CURRENTLY_INACTIVE" /** The customer is not eligible for this discount. */ | "DISCOUNT_CUSTOMER_NOT_ELIGIBLE" /** The customer's discount usage limit has been reached. */ | "DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED" /** An eligible customer is missing for this discount. */ | "DISCOUNT_ELIGIBLE_CUSTOMER_MISSING" /** The purchase type is incompatible with this discount. */ | "DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE" /** The discount was not found. */ | "DISCOUNT_NOT_FOUND" /** There are no entitled line items for this discount. */ | "DISCOUNT_NO_ENTITLED_LINE_ITEMS" /** There are no entitled shipping lines for this discount. */ | "DISCOUNT_NO_ENTITLED_SHIPPING_LINES" /** The purchase is not in range for this discount. */ | "DISCOUNT_PURCHASE_NOT_IN_RANGE" /** The quantity is not in range for this discount. */ | "DISCOUNT_QUANTITY_NOT_IN_RANGE" /** The discount usage limit has been reached. */ | "DISCOUNT_USAGE_LIMIT_REACHED" /** A delivery address with the same details already exists on this cart. */ | "DUPLICATE_DELIVERY_ADDRESS" /** The merchandise does not have enough stock. */ | "MERCHANDISE_NOT_ENOUGH_STOCK" /** The merchandise is out of stock. */ | "MERCHANDISE_OUT_OF_STOCK" /** Only one-time purchase is available for B2B orders. */ | "MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION" /** Gift cards are not available as a payment method. */ | "PAYMENTS_GIFT_CARDS_UNAVAILABLE" /** The product is unavailable in the current buyer location. */ | "PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION";
 /**
  * The code designating a country/region, which generally follows ISO 3166-1 alpha-2 guidelines.
  * If a territory doesn't have a country code value in the `CountryCode` enum, then it might be considered a subdivision

package/dist/graphql/graphql.d.mts

@@ -23,17 +23,50 @@ type StorefrontQueryString<Result = any, Variables = any, Source extends string
   readonly __hydrogenQueryBrand: true;
   readonly __hydrogenQuerySource?: Source;
 };
+/** Any `gql()`-branded string, regardless of inferred Result/Variables. Used in constraints that accept any Storefront document. */
 type AnyStorefrontQueryString = string & StorefrontQueryMetadata;
+/** Extracts the literal source text from a `gql()`-branded document type. Resolves to `never` for unbranded strings. */
 type SourceOf<Doc> = Doc extends {
   readonly __hydrogenQuerySource?: infer Source extends string;
 } ? Source : never;
 type FragmentSources<Fragments extends readonly AnyStorefrontQueryString[]> = Fragments extends readonly [] ? "" : Fragments extends readonly [infer Only extends AnyStorefrontQueryString] ? SourceOf<Only> : Fragments extends readonly [infer First extends AnyStorefrontQueryString, ...infer Rest extends readonly AnyStorefrontQueryString[]] ? `${SourceOf<First>}\n${FragmentSources<Rest>}` : string;
+/** Concatenates a query source with its fragment sources into a single literal type, enabling end-to-end type inference for composed documents. */
 type ComposedSource<Source extends string, Fragments extends readonly AnyStorefrontQueryString[]> = FragmentSources<Fragments> extends "" ? Source : `${Source}\n${FragmentSources<Fragments>}`;
 type StorefrontGql = {
   <const Document extends AnyStorefrontQueryString, const Fragments extends readonly AnyStorefrontQueryString[], const DocumentSource extends string = ComposedSource<SourceOf<Document>, Fragments>>(document: Document, fragments: Fragments): StorefrontQueryString<InferResult<DocumentSource>, InferVariables<DocumentSource>, DocumentSource>;
   <const Source extends string>(source: Source): StorefrontQueryString<InferResult<Source>, InferVariables<Source>, Source>;
   <const Source extends string, const Fragments extends readonly AnyStorefrontQueryString[], const DocumentSource extends string = ComposedSource<Source, Fragments>>(source: Source, fragments: Fragments): StorefrontQueryString<InferResult<DocumentSource>, InferVariables<DocumentSource>, DocumentSource>;
 } & StorefrontTadaGql;
+/**
+ * Tags a Storefront API query string for type-safe inference.
+ *
+ * At runtime, returns the source string (concatenated with any fragments).
+ * At the type level, the return type carries phantom `Result` and `Variables`
+ * types inferred from the Storefront API schema via gql.tada.
+ *
+ * Pass an array of previously declared `gql()` fragments as the second
+ * argument to compose documents while preserving full type inference.
+ *
+ * @example
+ * ```ts
+ * import { gql } from "@shopify/hydrogen";
+ *
+ * const PRODUCT_QUERY = gql(`
+ *   query Product($handle: String!) {
+ *     product(handle: $handle) { title }
+ *   }
+ * `);
+ *
+ * const result = await storefront.graphql(PRODUCT_QUERY, {
+ *   variables: { handle: "snowboard" },
+ * });
+ *
+ * if (!result.errors) {
+ *   // result.data.product is typed as `{ title: string } | null`
+ *   console.log(result.data.product?.title);
+ * }
+ * ```
+ */
 declare const gql: StorefrontGql;
 //#endregion
 export { AnyStorefrontQueryString, ComposedSource, SourceOf, StorefrontQueryString, gql };