@shopify/hydrogen 2026.4.5 → 2026.4.7

package/dist/production/index.d.cts

@@ -1384,6 +1384,23 @@ type VisitorConsent = {
     preferences: ConsentStatus;
     sale_of_data: ConsentStatus;
 };
+/** Consent choices returned by the Customer Privacy API. */
+type VisitorConsentValues = Record<keyof VisitorConsent, 'yes' | 'no' | ''>;
+type CustomerPrivacyConfiguration = {
+    isHeadless?: boolean;
+    asyncConsent?: boolean;
+    asyncVisitorState?: boolean;
+    consentDomain?: string;
+    storefrontAccessToken?: string;
+    injectedConsent?: string;
+    debug?: {
+        hydrogen?: {
+            generation: number;
+            serverTiming: boolean;
+        };
+        [key: string]: unknown;
+    };
+};
 type VisitorConsentCollected = {
     analyticsAllowed: boolean;
     firstPartyMarketingAllowed: boolean;
@@ -1392,7 +1409,6 @@ type VisitorConsentCollected = {
     saleOfDataAllowed: boolean;
     thirdPartyMarketingAllowed: boolean;
 };
-type CustomerPrivacyApiLoaded = boolean;
 type CustomerPrivacyConsentConfig = {
     checkoutRootDomain: string;
     storefrontRootDomain?: string;
@@ -1401,11 +1417,11 @@ type CustomerPrivacyConsentConfig = {
     /** The privacyBanner refers to `language` as `locale`  */
     locale?: LanguageCode$1;
 };
-type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig & {
+type SetConsentHeadlessParams = Partial<VisitorConsent> & CustomerPrivacyConsentConfig & {
     headlessStorefront?: boolean;
 };
 /**
-  Ideally this type should come from the Custoemr Privacy API sdk
+  Ideally this type should come from the Customer Privacy API sdk
   analyticsProcessingAllowed -
   currentVisitorConsent
   doesMerchantSupportGranularConsent
@@ -1422,7 +1438,9 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   thirdPartyMarketingAllowed
 **/
 type OriginalCustomerPrivacy = {
-    currentVisitorConsent: () => VisitorConsent;
+    currentVisitorConsent: () => VisitorConsentValues;
+    consentStatus?: 'loading' | 'loaded';
+    config?: CustomerPrivacyConfiguration;
     preferencesProcessingAllowed: () => boolean;
     saleOfDataAllowed: () => boolean;
     marketingAllowed: () => boolean;
@@ -1433,7 +1451,7 @@ type OriginalCustomerPrivacy = {
     shouldShowBanner: () => boolean;
 };
 type CustomerPrivacy = Omit<OriginalCustomerPrivacy, 'setTrackingConsent'> & {
-    setTrackingConsent: (consent: VisitorConsent, // we have already applied the headlessStorefront in the override
+    setTrackingConsent: (consent: Partial<VisitorConsent>, // we have already applied the headlessStorefront in the override
     callback: (data: {
         error: string;
     } | undefined) => void) => void;
@@ -1442,16 +1460,17 @@ type PrivacyBanner = {
     loadBanner: (options?: Partial<CustomerPrivacyConsentConfig>) => void;
     showPreferences: (options?: Partial<CustomerPrivacyConsentConfig>) => void;
 };
-interface CustomEventMap$1 {
+interface CustomEventMap {
     visitorConsentCollected: CustomEvent<VisitorConsentCollected>;
-    customerPrivacyApiLoaded: CustomEvent<CustomerPrivacyApiLoaded>;
+    consentTrackingApiLoaded: Event;
+    shopifyCustomerPrivacyApiLoaded: CustomEvent<null>;
 }
 type CustomerPrivacyApiProps = {
     /** The production shop checkout domain url.  */
     checkoutDomain: string;
     /** The storefront access token for the shop. */
     storefrontAccessToken: string;
-    /** Whether to load the Shopify privacy banner as configured in Shopify admin. Defaults to true. */
+    /** Whether to load the Shopify privacy banner as configured in Shopify admin. Defaults to false. */
     withPrivacyBanner?: boolean;
     /** Country code for the shop. */
     country?: CountryCode$1;
@@ -1459,18 +1478,25 @@ type CustomerPrivacyApiProps = {
     locale?: LanguageCode$1;
     /** Callback to be called when visitor consent is collected. */
     onVisitorConsentCollected?: (consent: VisitorConsentCollected) => void;
-    /** Callback to be call when customer privacy api is ready. */
+    /**
+     * Called once consent is available and the selected APIs are loaded. If initial
+     * consent fails to load, waits for a successful consent update. The returned
+     * customerPrivacy API may be available earlier, for example to show a custom CMP.
+     */
     onReady?: () => void;
     /**
-     * Whether consent libraries can use same-domain requests to the Storefront API.
-     * Defaults to true if the standard route proxy is enabled in Hydrogen server.
+     * @deprecated This option is ignored: consent requests always use the
+     * same-origin Storefront API proxy that Hydrogen's `createRequestHandler`
+     * includes, as if this were `true`. Consent and analytics do not work
+     * without the proxy, so `false` is no longer supported,
+     * [notice](https://shopify.dev/changelog/posts/tracking-cookie-deprecation-hydrogen).
      */
     sameDomainForStorefrontApi?: boolean;
 };
 /** @publicDocs */
 declare function useCustomerPrivacy(props: CustomerPrivacyApiProps): {
+    privacyBanner?: PrivacyBanner | null | undefined;
     customerPrivacy: CustomerPrivacy | null;
-    privacyBanner?: PrivacyBanner | null;
 };
 
 interface HydrogenSessionData {
@@ -1557,9 +1583,9 @@ declare global {
   interface Window {
     privacyBanner: PrivacyBanner;
     Shopify: {
-      customerPrivacy?: Partial<CustomerPrivacy> & {
-        backendConsentEnabled?: boolean;
-      };
+      country?: string;
+      locale?: string;
+      customerPrivacy?: Partial<CustomerPrivacy>;
     };
   }
   interface Document {
@@ -1651,8 +1677,8 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     forwardMcp: (request: Request) => Promise<Response>;
     /**
      * Sets the collected subrequest headers in the response.
-     * Useful to forward the cookies and server-timing headers
-     * from server subrequests to the browser.
+     * Useful to forward cookies from server subrequests
+     * to the browser.
      */
     setCollectedSubrequestHeaders: (response: {
         headers: Headers;
@@ -1974,7 +2000,7 @@ type AnalyticsProviderProps = {
     consent: Consent;
     /** @deprecated Disable throwing errors when required props are missing. */
     disableThrowOnError?: boolean;
-    /** The domain scope of the cookie set with `useShopifyCookies`. **/
+    /** @deprecated No longer used. The Customer Privacy API manages Shopify cookies. */
     cookieDomain?: string;
 };
 type AnalyticsContextValue = {
@@ -2018,7 +2044,7 @@ declare function publish(event: typeof AnalyticsEvent.CART_UPDATED, payload: Car
 declare function publish(event: typeof AnalyticsEvent.PRODUCT_ADD_TO_CART, payload: CartLineUpdatePayload): void;
 declare function publish(event: typeof AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, payload: CartLineUpdatePayload): void;
 declare function publish(event: typeof AnalyticsEvent.CUSTOM_EVENT, payload: OtherData): void;
-declare function AnalyticsProvider({ canTrack: customCanTrack, cart: currentCart, children, consent, customData, shop: shopProp, cookieDomain, }: AnalyticsProviderProps): JSX.Element;
+declare function AnalyticsProvider({ canTrack: customCanTrack, cart: currentCart, children, consent, customData, shop: shopProp, }: AnalyticsProviderProps): JSX.Element;
 /** @publicDocs */
 declare function useAnalytics(): AnalyticsContextValue;
 type ShopAnalyticsProps = {
@@ -3257,4 +3283,4 @@ interface GetSiteMapOptions {
  */
 declare function getSitemap(options: GetSiteMapOptions): Promise<Response>;
 
-export { Analytics, AnalyticsEvent, CacheCustom, type CacheKey, CacheLong, CacheNone, CacheShort, type CachingStrategy, type CartActionInput, CartForm, type CartLineUpdatePayload, type CartQueryDataReturn, type CartQueryOptions, type CartQueryReturn, type CartReturn, type CartUpdatePayload, type CartViewPayload, type CollectionViewPayload, type ConsentStatus, type CookieOptions, type CreateStorefrontClientForDocs, type CreateStorefrontClientOptions, type CustomEventMap$1 as CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenRouterContextProvider, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, NonceProvider, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner, type ProductViewPayload, RichText, Script, type SearchViewPayload, Seo, type SeoConfig, type SeoHandleFunction, type SetConsentHeadlessParams, type ShopAnalytics, ShopPayButton, type Storefront, type StorefrontApiErrors, type StorefrontClient, type StorefrontForDoc, type StorefrontMutationOptionsForDocs, type StorefrontMutations, type StorefrontQueries, type StorefrontQueryOptionsForDocs, type VariantOption, type VariantOptionValue, VariantSelector, type VisitorConsent, type VisitorConsentCollected, type WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartGiftCardCodesAddDefault, cartGiftCardCodesRemoveDefault, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createRequestHandler, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, hydrogenContext, hydrogenPreset, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };
+export { Analytics, AnalyticsEvent, CacheCustom, type CacheKey, CacheLong, CacheNone, CacheShort, type CachingStrategy, type CartActionInput, CartForm, type CartLineUpdatePayload, type CartQueryDataReturn, type CartQueryOptions, type CartQueryReturn, type CartReturn, type CartUpdatePayload, type CartViewPayload, type CollectionViewPayload, type ConsentStatus, type CookieOptions, type CreateStorefrontClientForDocs, type CreateStorefrontClientOptions, type CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenRouterContextProvider, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, NonceProvider, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner, type ProductViewPayload, RichText, Script, type SearchViewPayload, Seo, type SeoConfig, type SeoHandleFunction, type SetConsentHeadlessParams, type ShopAnalytics, ShopPayButton, type Storefront, type StorefrontApiErrors, type StorefrontClient, type StorefrontForDoc, type StorefrontMutationOptionsForDocs, type StorefrontMutations, type StorefrontQueries, type StorefrontQueryOptionsForDocs, type VariantOption, type VariantOptionValue, VariantSelector, type VisitorConsent, type VisitorConsentCollected, type WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartGiftCardCodesAddDefault, cartGiftCardCodesRemoveDefault, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createRequestHandler, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, hydrogenContext, hydrogenPreset, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };

package/dist/production/index.d.ts

@@ -1384,6 +1384,23 @@ type VisitorConsent = {
     preferences: ConsentStatus;
     sale_of_data: ConsentStatus;
 };
+/** Consent choices returned by the Customer Privacy API. */
+type VisitorConsentValues = Record<keyof VisitorConsent, 'yes' | 'no' | ''>;
+type CustomerPrivacyConfiguration = {
+    isHeadless?: boolean;
+    asyncConsent?: boolean;
+    asyncVisitorState?: boolean;
+    consentDomain?: string;
+    storefrontAccessToken?: string;
+    injectedConsent?: string;
+    debug?: {
+        hydrogen?: {
+            generation: number;
+            serverTiming: boolean;
+        };
+        [key: string]: unknown;
+    };
+};
 type VisitorConsentCollected = {
     analyticsAllowed: boolean;
     firstPartyMarketingAllowed: boolean;
@@ -1392,7 +1409,6 @@ type VisitorConsentCollected = {
     saleOfDataAllowed: boolean;
     thirdPartyMarketingAllowed: boolean;
 };
-type CustomerPrivacyApiLoaded = boolean;
 type CustomerPrivacyConsentConfig = {
     checkoutRootDomain: string;
     storefrontRootDomain?: string;
@@ -1401,11 +1417,11 @@ type CustomerPrivacyConsentConfig = {
     /** The privacyBanner refers to `language` as `locale`  */
     locale?: LanguageCode$1;
 };
-type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig & {
+type SetConsentHeadlessParams = Partial<VisitorConsent> & CustomerPrivacyConsentConfig & {
     headlessStorefront?: boolean;
 };
 /**
-  Ideally this type should come from the Custoemr Privacy API sdk
+  Ideally this type should come from the Customer Privacy API sdk
   analyticsProcessingAllowed -
   currentVisitorConsent
   doesMerchantSupportGranularConsent
@@ -1422,7 +1438,9 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   thirdPartyMarketingAllowed
 **/
 type OriginalCustomerPrivacy = {
-    currentVisitorConsent: () => VisitorConsent;
+    currentVisitorConsent: () => VisitorConsentValues;
+    consentStatus?: 'loading' | 'loaded';
+    config?: CustomerPrivacyConfiguration;
     preferencesProcessingAllowed: () => boolean;
     saleOfDataAllowed: () => boolean;
     marketingAllowed: () => boolean;
@@ -1433,7 +1451,7 @@ type OriginalCustomerPrivacy = {
     shouldShowBanner: () => boolean;
 };
 type CustomerPrivacy = Omit<OriginalCustomerPrivacy, 'setTrackingConsent'> & {
-    setTrackingConsent: (consent: VisitorConsent, // we have already applied the headlessStorefront in the override
+    setTrackingConsent: (consent: Partial<VisitorConsent>, // we have already applied the headlessStorefront in the override
     callback: (data: {
         error: string;
     } | undefined) => void) => void;
@@ -1442,16 +1460,17 @@ type PrivacyBanner = {
     loadBanner: (options?: Partial<CustomerPrivacyConsentConfig>) => void;
     showPreferences: (options?: Partial<CustomerPrivacyConsentConfig>) => void;
 };
-interface CustomEventMap$1 {
+interface CustomEventMap {
     visitorConsentCollected: CustomEvent<VisitorConsentCollected>;
-    customerPrivacyApiLoaded: CustomEvent<CustomerPrivacyApiLoaded>;
+    consentTrackingApiLoaded: Event;
+    shopifyCustomerPrivacyApiLoaded: CustomEvent<null>;
 }
 type CustomerPrivacyApiProps = {
     /** The production shop checkout domain url.  */
     checkoutDomain: string;
     /** The storefront access token for the shop. */
     storefrontAccessToken: string;
-    /** Whether to load the Shopify privacy banner as configured in Shopify admin. Defaults to true. */
+    /** Whether to load the Shopify privacy banner as configured in Shopify admin. Defaults to false. */
     withPrivacyBanner?: boolean;
     /** Country code for the shop. */
     country?: CountryCode$1;
@@ -1459,18 +1478,25 @@ type CustomerPrivacyApiProps = {
     locale?: LanguageCode$1;
     /** Callback to be called when visitor consent is collected. */
     onVisitorConsentCollected?: (consent: VisitorConsentCollected) => void;
-    /** Callback to be call when customer privacy api is ready. */
+    /**
+     * Called once consent is available and the selected APIs are loaded. If initial
+     * consent fails to load, waits for a successful consent update. The returned
+     * customerPrivacy API may be available earlier, for example to show a custom CMP.
+     */
     onReady?: () => void;
     /**
-     * Whether consent libraries can use same-domain requests to the Storefront API.
-     * Defaults to true if the standard route proxy is enabled in Hydrogen server.
+     * @deprecated This option is ignored: consent requests always use the
+     * same-origin Storefront API proxy that Hydrogen's `createRequestHandler`
+     * includes, as if this were `true`. Consent and analytics do not work
+     * without the proxy, so `false` is no longer supported,
+     * [notice](https://shopify.dev/changelog/posts/tracking-cookie-deprecation-hydrogen).
      */
     sameDomainForStorefrontApi?: boolean;
 };
 /** @publicDocs */
 declare function useCustomerPrivacy(props: CustomerPrivacyApiProps): {
+    privacyBanner?: PrivacyBanner | null | undefined;
     customerPrivacy: CustomerPrivacy | null;
-    privacyBanner?: PrivacyBanner | null;
 };
 
 interface HydrogenSessionData {
@@ -1557,9 +1583,9 @@ declare global {
   interface Window {
     privacyBanner: PrivacyBanner;
     Shopify: {
-      customerPrivacy?: Partial<CustomerPrivacy> & {
-        backendConsentEnabled?: boolean;
-      };
+      country?: string;
+      locale?: string;
+      customerPrivacy?: Partial<CustomerPrivacy>;
     };
   }
   interface Document {
@@ -1651,8 +1677,8 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     forwardMcp: (request: Request) => Promise<Response>;
     /**
      * Sets the collected subrequest headers in the response.
-     * Useful to forward the cookies and server-timing headers
-     * from server subrequests to the browser.
+     * Useful to forward cookies from server subrequests
+     * to the browser.
      */
     setCollectedSubrequestHeaders: (response: {
         headers: Headers;
@@ -1974,7 +2000,7 @@ type AnalyticsProviderProps = {
     consent: Consent;
     /** @deprecated Disable throwing errors when required props are missing. */
     disableThrowOnError?: boolean;
-    /** The domain scope of the cookie set with `useShopifyCookies`. **/
+    /** @deprecated No longer used. The Customer Privacy API manages Shopify cookies. */
     cookieDomain?: string;
 };
 type AnalyticsContextValue = {
@@ -2018,7 +2044,7 @@ declare function publish(event: typeof AnalyticsEvent.CART_UPDATED, payload: Car
 declare function publish(event: typeof AnalyticsEvent.PRODUCT_ADD_TO_CART, payload: CartLineUpdatePayload): void;
 declare function publish(event: typeof AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, payload: CartLineUpdatePayload): void;
 declare function publish(event: typeof AnalyticsEvent.CUSTOM_EVENT, payload: OtherData): void;
-declare function AnalyticsProvider({ canTrack: customCanTrack, cart: currentCart, children, consent, customData, shop: shopProp, cookieDomain, }: AnalyticsProviderProps): JSX.Element;
+declare function AnalyticsProvider({ canTrack: customCanTrack, cart: currentCart, children, consent, customData, shop: shopProp, }: AnalyticsProviderProps): JSX.Element;
 /** @publicDocs */
 declare function useAnalytics(): AnalyticsContextValue;
 type ShopAnalyticsProps = {
@@ -3257,4 +3283,4 @@ interface GetSiteMapOptions {
  */
 declare function getSitemap(options: GetSiteMapOptions): Promise<Response>;
 
-export { Analytics, AnalyticsEvent, CacheCustom, type CacheKey, CacheLong, CacheNone, CacheShort, type CachingStrategy, type CartActionInput, CartForm, type CartLineUpdatePayload, type CartQueryDataReturn, type CartQueryOptions, type CartQueryReturn, type CartReturn, type CartUpdatePayload, type CartViewPayload, type CollectionViewPayload, type ConsentStatus, type CookieOptions, type CreateStorefrontClientForDocs, type CreateStorefrontClientOptions, type CustomEventMap$1 as CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenRouterContextProvider, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, NonceProvider, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner, type ProductViewPayload, RichText, Script, type SearchViewPayload, Seo, type SeoConfig, type SeoHandleFunction, type SetConsentHeadlessParams, type ShopAnalytics, ShopPayButton, type Storefront, type StorefrontApiErrors, type StorefrontClient, type StorefrontForDoc, type StorefrontMutationOptionsForDocs, type StorefrontMutations, type StorefrontQueries, type StorefrontQueryOptionsForDocs, type VariantOption, type VariantOptionValue, VariantSelector, type VisitorConsent, type VisitorConsentCollected, type WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartGiftCardCodesAddDefault, cartGiftCardCodesRemoveDefault, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createRequestHandler, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, hydrogenContext, hydrogenPreset, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };
+export { Analytics, AnalyticsEvent, CacheCustom, type CacheKey, CacheLong, CacheNone, CacheShort, type CachingStrategy, type CartActionInput, CartForm, type CartLineUpdatePayload, type CartQueryDataReturn, type CartQueryOptions, type CartQueryReturn, type CartReturn, type CartUpdatePayload, type CartViewPayload, type CollectionViewPayload, type ConsentStatus, type CookieOptions, type CreateStorefrontClientForDocs, type CreateStorefrontClientOptions, type CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenRouterContextProvider, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, NonceProvider, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner, type ProductViewPayload, RichText, Script, type SearchViewPayload, Seo, type SeoConfig, type SeoHandleFunction, type SetConsentHeadlessParams, type ShopAnalytics, ShopPayButton, type Storefront, type StorefrontApiErrors, type StorefrontClient, type StorefrontForDoc, type StorefrontMutationOptionsForDocs, type StorefrontMutations, type StorefrontQueries, type StorefrontQueryOptionsForDocs, type VariantOption, type VariantOptionValue, VariantSelector, type VisitorConsent, type VisitorConsentCollected, type WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartGiftCardCodesAddDefault, cartGiftCardCodesRemoveDefault, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createRequestHandler, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, hydrogenContext, hydrogenPreset, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };