@shopify/hydrogen 2025.4.0 → 2025.4.2

package/dist/production/index.d.cts

@@ -2,9 +2,9 @@ import * as react from 'react';
 import { ReactNode, ComponentType, ScriptHTMLAttributes, FC, Ref, ComponentProps } from 'react';
 import { BuyerInput, LanguageCode, CountryCode, Cart, CartMetafieldsSetInput, Scalars, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, CartWarning, Product, ProductVariant, CartLine, ComponentizableCartLine, CurrencyCode, AttributeInput, CartBuyerIdentityInput, CartInput, CartLineInput, CartLineUpdateInput, CartSelectedDeliveryOptionInput, CartSelectableAddressInput, CartSelectableAddressUpdateInput, PageInfo, Maybe, ProductOptionValue, SelectedOptionInput, ProductOption, ProductVariantConnection } from '@shopify/hydrogen-react/storefront-api-types';
 import { createStorefrontClient as createStorefrontClient$1, StorefrontClientProps, RichText as RichText$1, ShopPayButton as ShopPayButton$1 } from '@shopify/hydrogen-react';
-export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MappedProductOptions, MediaFile, ModelViewer, Money, ParsedMetafields, ShopifyAnalytics as SendShopifyAnalyticsEvent, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, customerAccountApiCustomScalars, decodeEncodedVariant, flattenConnection, getAdjacentAndFirstAvailableVariants, getClientBrowserParameters, getProductOptions, getShopifyCookies, isOptionValueCombinationInEncodedVariant, mapSelectedProductOptionToObject, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useSelectedOptionInUrlParam, useShopifyCookies } from '@shopify/hydrogen-react';
+export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MappedProductOptions, MediaFile, ModelViewer, Money, ParsedMetafields, ShopifyAnalytics as SendShopifyAnalyticsEvent, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, customerAccountApiCustomScalars, decodeEncodedVariant, flattenConnection, getAdjacentAndFirstAvailableVariants, getClientBrowserParameters, getProductOptions, getShopifyCookies, getTrackingValues, isOptionValueCombinationInEncodedVariant, mapSelectedProductOptionToObject, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useSelectedOptionInUrlParam, useShopifyCookies } from '@shopify/hydrogen-react';
 import { ExecutionArgs } from 'graphql';
-import { SessionData, FlashSessionData, Session, SessionStorage, LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
+import { SessionData, FlashSessionData, Session, SessionStorage, ServerBuild, LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FetcherWithComponents, LinkProps, MetaFunction, Params, Location } from '@remix-run/react';
 import { PartialDeep } from 'type-fest';
@@ -639,9 +639,11 @@ type StorefrontHeaders = {
   requestGroupId: string | null;
   /** The IP address of the client. */
   buyerIp: string | null;
+  /** The signature of the client's IP address for verification. */
+  buyerIpSig: string | null;
   /** The cookie header from the client  */
   cookie: string | null;
-  /** The purpose header value for debugging */
+  /** The sec-purpose or purpose header value */
   purpose: string | null;
 };
 
@@ -717,6 +719,26 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     getShopifyDomain: ReturnType<typeof createStorefrontClient$1>['getShopifyDomain'];
     getApiUrl: ReturnType<typeof createStorefrontClient$1>['getStorefrontApiUrl'];
     i18n: TI18n;
+    getHeaders: () => Record<string, string>;
+    /**
+     * Checks if the request URL matches the Storefront API GraphQL endpoint.
+     */
+    isStorefrontApiUrl: (request: {
+        url?: string;
+    }) => boolean;
+    /**
+     * Forwards the request to the Storefront API.
+     * It reads the API version from the request URL.
+     */
+    forward: (request: Request, options?: Pick<StorefrontCommonExtraParams, 'storefrontApiVersion'>) => 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.
+     */
+    setCollectedSubrequestHeaders: (response: {
+        headers: Headers;
+    }) => void;
 };
 type HydrogenClientProps<TI18n> = {
     /** Storefront API headers. If on Oxygen, use `getStorefrontHeaders()` */
@@ -1122,18 +1144,13 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   doesMerchantSupportGranularConsent
   firstPartyMarketingAllowed
   getCCPAConsent
-  getRegulation
-  getShopPrefs
   getTrackingConsent
-  isRegulationEnforced
   marketingAllowed
   preferencesProcessingAllowed
   saleOfDataAllowed
   saleOfDataRegion
-  setCCPAConsent
   setTrackingConsent
   shouldShowBanner
-  shouldShowCCPABanner
   shouldShowGDPRBanner
   thirdPartyMarketingAllowed
 **/
@@ -1146,6 +1163,7 @@ type OriginalCustomerPrivacy = {
     setTrackingConsent: (consent: SetConsentHeadlessParams, callback: (data: {
         error: string;
     } | undefined) => void) => void;
+    shouldShowBanner: () => boolean;
 };
 type CustomerPrivacy$1 = Omit<OriginalCustomerPrivacy, 'setTrackingConsent'> & {
     setTrackingConsent: (consent: VisitorConsent, // we have already applied the headlessStorefront in the override
@@ -1176,6 +1194,11 @@ type CustomerPrivacyApiProps = {
     onVisitorConsentCollected?: (consent: VisitorConsentCollected) => void;
     /** Callback to be call when customer privacy api is ready. */
     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.
+     */
+    sameDomainForStorefrontApi?: boolean;
 };
 declare function useCustomerPrivacy(props: CustomerPrivacyApiProps): {
     customerPrivacy: CustomerPrivacy$1 | null;
@@ -1192,7 +1215,7 @@ type ShopAnalytics = {
     /** The Hydrogen subchannel ID generated by Oxygen in the environment variable. */
     hydrogenSubchannelId: string | '0';
 };
-type Consent = Partial<Pick<CustomerPrivacyApiProps, 'checkoutDomain' | 'storefrontAccessToken' | 'withPrivacyBanner' | 'country'>> & {
+type Consent = Partial<Pick<CustomerPrivacyApiProps, 'checkoutDomain' | 'sameDomainForStorefrontApi' | 'storefrontAccessToken' | 'withPrivacyBanner' | 'country'>> & {
     language?: LanguageCode;
 };
 type AnalyticsProviderProps = {
@@ -1750,6 +1773,7 @@ type CartHandlerOptions = {
     setCartId: (cartId: string) => Headers;
     cartQueryFragment?: string;
     cartMutateFragment?: string;
+    buyerIdentity?: CartBuyerIdentityInput;
 };
 type CustomMethodsBase = Record<string, Function>;
 type CartHandlerOptionsWithCustom<TCustomMethods extends CustomMethodsBase> = CartHandlerOptions & {
@@ -1951,6 +1975,7 @@ type HydrogenContextOptions<TSession extends HydrogenSession = HydrogenSession,
          */
         customMethods?: TCustomMethods;
     };
+    buyerIdentity?: CartBuyerIdentityInput;
 };
 interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env> {
     /** A GraphQL client for querying the [Storefront API](https://shopify.dev/docs/api/storefront). */
@@ -1967,6 +1992,42 @@ interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TC
 }
 declare function createHydrogenContext<TSession extends HydrogenSession = HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env>(options: HydrogenContextOptions<TSession, TCustomMethods, TI18n, TEnv>): HydrogenContext<TSession, TCustomMethods, TI18n, TEnv>;
 
+type CreateRequestHandlerOptions<Context = unknown> = {
+    /** Remix's server build */
+    build: ServerBuild;
+    /** Remix's mode */
+    mode?: string;
+    /**
+     * Function to provide the load context for each request.
+     * It must contain Hydrogen's storefront client instance
+     * for other Hydrogen utilities to work properly.
+     */
+    getLoadContext?: (request: Request) => Promise<Context> | Context;
+    /**
+     * Whether to include the `powered-by` header in responses
+     * @default true
+     */
+    poweredByHeader?: boolean;
+    /**
+     * Collect tracking information from subrequests such as cookies
+     * and forward them to the browser. Disable this if you are not
+     * using Hydrogen's built-in analytics.
+     * @default true
+     */
+    collectTrackingInformation?: boolean;
+    /**
+     * Whether to proxy standard routes such as `/api/.../graphql.json` (Storefront API).
+     * You can disable this if you are handling these routes yourself. Ensure that
+     * the proxy works if you rely on Hydrogen's built-in behaviors such as analytics.
+     * @default true
+     */
+    proxyStandardRoutes?: boolean;
+};
+/**
+ * Creates a request handler for Hydrogen apps using Remix.
+ */
+declare function createRequestHandler<Context = unknown>({ build, mode, poweredByHeader, getLoadContext, collectTrackingInformation, proxyStandardRoutes, }: CreateRequestHandlerOptions<Context>): (request: Request) => Promise<Response>;
+
 declare const useNonce: () => string | undefined;
 type ContentSecurityPolicy = {
     /** A randomly generated nonce string that should be passed to any custom `script` element */
@@ -2581,4 +2642,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$1 as CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner$1 as 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, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, 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$1 as CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy$1 as CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner$1 as 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, 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, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };

package/dist/production/index.d.ts

@@ -2,9 +2,9 @@ import * as react from 'react';
 import { ReactNode, ComponentType, ScriptHTMLAttributes, FC, Ref, ComponentProps } from 'react';
 import { BuyerInput, LanguageCode, CountryCode, Cart, CartMetafieldsSetInput, Scalars, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, CartWarning, Product, ProductVariant, CartLine, ComponentizableCartLine, CurrencyCode, AttributeInput, CartBuyerIdentityInput, CartInput, CartLineInput, CartLineUpdateInput, CartSelectedDeliveryOptionInput, CartSelectableAddressInput, CartSelectableAddressUpdateInput, PageInfo, Maybe, ProductOptionValue, SelectedOptionInput, ProductOption, ProductVariantConnection } from '@shopify/hydrogen-react/storefront-api-types';
 import { createStorefrontClient as createStorefrontClient$1, StorefrontClientProps, RichText as RichText$1, ShopPayButton as ShopPayButton$1 } from '@shopify/hydrogen-react';
-export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MappedProductOptions, MediaFile, ModelViewer, Money, ParsedMetafields, ShopifyAnalytics as SendShopifyAnalyticsEvent, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, customerAccountApiCustomScalars, decodeEncodedVariant, flattenConnection, getAdjacentAndFirstAvailableVariants, getClientBrowserParameters, getProductOptions, getShopifyCookies, isOptionValueCombinationInEncodedVariant, mapSelectedProductOptionToObject, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useSelectedOptionInUrlParam, useShopifyCookies } from '@shopify/hydrogen-react';
+export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MappedProductOptions, MediaFile, ModelViewer, Money, ParsedMetafields, ShopifyAnalytics as SendShopifyAnalyticsEvent, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, customerAccountApiCustomScalars, decodeEncodedVariant, flattenConnection, getAdjacentAndFirstAvailableVariants, getClientBrowserParameters, getProductOptions, getShopifyCookies, getTrackingValues, isOptionValueCombinationInEncodedVariant, mapSelectedProductOptionToObject, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useSelectedOptionInUrlParam, useShopifyCookies } from '@shopify/hydrogen-react';
 import { ExecutionArgs } from 'graphql';
-import { SessionData, FlashSessionData, Session, SessionStorage, LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
+import { SessionData, FlashSessionData, Session, SessionStorage, ServerBuild, LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FetcherWithComponents, LinkProps, MetaFunction, Params, Location } from '@remix-run/react';
 import { PartialDeep } from 'type-fest';
@@ -639,9 +639,11 @@ type StorefrontHeaders = {
   requestGroupId: string | null;
   /** The IP address of the client. */
   buyerIp: string | null;
+  /** The signature of the client's IP address for verification. */
+  buyerIpSig: string | null;
   /** The cookie header from the client  */
   cookie: string | null;
-  /** The purpose header value for debugging */
+  /** The sec-purpose or purpose header value */
   purpose: string | null;
 };
 
@@ -717,6 +719,26 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     getShopifyDomain: ReturnType<typeof createStorefrontClient$1>['getShopifyDomain'];
     getApiUrl: ReturnType<typeof createStorefrontClient$1>['getStorefrontApiUrl'];
     i18n: TI18n;
+    getHeaders: () => Record<string, string>;
+    /**
+     * Checks if the request URL matches the Storefront API GraphQL endpoint.
+     */
+    isStorefrontApiUrl: (request: {
+        url?: string;
+    }) => boolean;
+    /**
+     * Forwards the request to the Storefront API.
+     * It reads the API version from the request URL.
+     */
+    forward: (request: Request, options?: Pick<StorefrontCommonExtraParams, 'storefrontApiVersion'>) => 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.
+     */
+    setCollectedSubrequestHeaders: (response: {
+        headers: Headers;
+    }) => void;
 };
 type HydrogenClientProps<TI18n> = {
     /** Storefront API headers. If on Oxygen, use `getStorefrontHeaders()` */
@@ -1122,18 +1144,13 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   doesMerchantSupportGranularConsent
   firstPartyMarketingAllowed
   getCCPAConsent
-  getRegulation
-  getShopPrefs
   getTrackingConsent
-  isRegulationEnforced
   marketingAllowed
   preferencesProcessingAllowed
   saleOfDataAllowed
   saleOfDataRegion
-  setCCPAConsent
   setTrackingConsent
   shouldShowBanner
-  shouldShowCCPABanner
   shouldShowGDPRBanner
   thirdPartyMarketingAllowed
 **/
@@ -1146,6 +1163,7 @@ type OriginalCustomerPrivacy = {
     setTrackingConsent: (consent: SetConsentHeadlessParams, callback: (data: {
         error: string;
     } | undefined) => void) => void;
+    shouldShowBanner: () => boolean;
 };
 type CustomerPrivacy$1 = Omit<OriginalCustomerPrivacy, 'setTrackingConsent'> & {
     setTrackingConsent: (consent: VisitorConsent, // we have already applied the headlessStorefront in the override
@@ -1176,6 +1194,11 @@ type CustomerPrivacyApiProps = {
     onVisitorConsentCollected?: (consent: VisitorConsentCollected) => void;
     /** Callback to be call when customer privacy api is ready. */
     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.
+     */
+    sameDomainForStorefrontApi?: boolean;
 };
 declare function useCustomerPrivacy(props: CustomerPrivacyApiProps): {
     customerPrivacy: CustomerPrivacy$1 | null;
@@ -1192,7 +1215,7 @@ type ShopAnalytics = {
     /** The Hydrogen subchannel ID generated by Oxygen in the environment variable. */
     hydrogenSubchannelId: string | '0';
 };
-type Consent = Partial<Pick<CustomerPrivacyApiProps, 'checkoutDomain' | 'storefrontAccessToken' | 'withPrivacyBanner' | 'country'>> & {
+type Consent = Partial<Pick<CustomerPrivacyApiProps, 'checkoutDomain' | 'sameDomainForStorefrontApi' | 'storefrontAccessToken' | 'withPrivacyBanner' | 'country'>> & {
     language?: LanguageCode;
 };
 type AnalyticsProviderProps = {
@@ -1750,6 +1773,7 @@ type CartHandlerOptions = {
     setCartId: (cartId: string) => Headers;
     cartQueryFragment?: string;
     cartMutateFragment?: string;
+    buyerIdentity?: CartBuyerIdentityInput;
 };
 type CustomMethodsBase = Record<string, Function>;
 type CartHandlerOptionsWithCustom<TCustomMethods extends CustomMethodsBase> = CartHandlerOptions & {
@@ -1951,6 +1975,7 @@ type HydrogenContextOptions<TSession extends HydrogenSession = HydrogenSession,
          */
         customMethods?: TCustomMethods;
     };
+    buyerIdentity?: CartBuyerIdentityInput;
 };
 interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env> {
     /** A GraphQL client for querying the [Storefront API](https://shopify.dev/docs/api/storefront). */
@@ -1967,6 +1992,42 @@ interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TC
 }
 declare function createHydrogenContext<TSession extends HydrogenSession = HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env>(options: HydrogenContextOptions<TSession, TCustomMethods, TI18n, TEnv>): HydrogenContext<TSession, TCustomMethods, TI18n, TEnv>;
 
+type CreateRequestHandlerOptions<Context = unknown> = {
+    /** Remix's server build */
+    build: ServerBuild;
+    /** Remix's mode */
+    mode?: string;
+    /**
+     * Function to provide the load context for each request.
+     * It must contain Hydrogen's storefront client instance
+     * for other Hydrogen utilities to work properly.
+     */
+    getLoadContext?: (request: Request) => Promise<Context> | Context;
+    /**
+     * Whether to include the `powered-by` header in responses
+     * @default true
+     */
+    poweredByHeader?: boolean;
+    /**
+     * Collect tracking information from subrequests such as cookies
+     * and forward them to the browser. Disable this if you are not
+     * using Hydrogen's built-in analytics.
+     * @default true
+     */
+    collectTrackingInformation?: boolean;
+    /**
+     * Whether to proxy standard routes such as `/api/.../graphql.json` (Storefront API).
+     * You can disable this if you are handling these routes yourself. Ensure that
+     * the proxy works if you rely on Hydrogen's built-in behaviors such as analytics.
+     * @default true
+     */
+    proxyStandardRoutes?: boolean;
+};
+/**
+ * Creates a request handler for Hydrogen apps using Remix.
+ */
+declare function createRequestHandler<Context = unknown>({ build, mode, poweredByHeader, getLoadContext, collectTrackingInformation, proxyStandardRoutes, }: CreateRequestHandlerOptions<Context>): (request: Request) => Promise<Response>;
+
 declare const useNonce: () => string | undefined;
 type ContentSecurityPolicy = {
     /** A randomly generated nonce string that should be passed to any custom `script` element */
@@ -2581,4 +2642,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$1 as CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner$1 as 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, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, 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$1 as CustomEventMap, type CustomerAccount, type CustomerAccountMutations, type CustomerAccountQueries, type CustomerPrivacy$1 as CustomerPrivacy, type CustomerPrivacyApiProps, type CustomerPrivacyConsentConfig, type HydrogenCart, type HydrogenCartCustom, type HydrogenContext, type HydrogenEnv, type HydrogenSession, type HydrogenSessionData, type I18nBase, InMemoryCache, type MetafieldWithoutOwnerId, type NoStoreStrategy, type OptimisticCart, type OptimisticCartLine, type OptimisticCartLineInput, OptimisticInput, type PageViewPayload, Pagination, type PrivacyBanner$1 as 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, 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, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };