@shopify/hydrogen 2025.7.0 → 2025.7.2

package/dist/production/index.d.cts

@@ -2,11 +2,11 @@ import * as react from 'react';
 import { ReactNode, ComponentType, ScriptHTMLAttributes, FC, ForwardRefExoticComponent, RefAttributes, ComponentProps } from 'react';
 import { BuyerInput, CountryCode as CountryCode$1, LanguageCode as LanguageCode$1, CartInput, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartSelectedDeliveryOptionInput, AttributeInput, Scalars, CartSelectableAddressInput, CartSelectableAddressUpdateInput, Cart, CartMetafieldsSetInput, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, CartWarning, Product, ProductVariant, CartLine, ComponentizableCartLine, CurrencyCode, 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 { LanguageCode, CountryCode } from '@shopify/hydrogen-react/customer-account-api-types';
 import { ExecutionArgs } from 'graphql';
 import * as react_router from 'react-router';
-import { SessionData, FlashSessionData, Session, SessionStorage, RouterContextProvider, FetcherWithComponents, LinkProps, LoaderFunctionArgs, MetaFunction, LoaderFunction, Params, Location } from 'react-router';
+import { SessionData, FlashSessionData, Session, SessionStorage, RouterContextProvider, FetcherWithComponents, ServerBuild, LinkProps, LoaderFunctionArgs, MetaFunction, LoaderFunction, Params, Location } from 'react-router';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { PartialDeep } from 'type-fest';
 import { RouteConfigEntry } from '@react-router/dev/routes';
@@ -603,6 +603,8 @@ interface CustomerAccountMutations {
 type LoginOptions = {
     uiLocales?: LanguageCode;
     countryCode?: CountryCode;
+    acrValues?: string;
+    loginHint?: string;
 };
 type LogoutOptions = {
     /** The url to redirect customer to after logout, should be a relative URL. This url will need to included in Customer Account API's application setup for logout URI. The default value is current app origin, which is automatically setup in admin when using `--customer-account-push` flag with dev. */
@@ -1032,9 +1034,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;
 };
 
@@ -1132,6 +1136,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()` */
@@ -1409,18 +1433,13 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   doesMerchantSupportGranularConsent
   firstPartyMarketingAllowed
   getCCPAConsent
-  getRegulation
-  getShopPrefs
   getTrackingConsent
-  isRegulationEnforced
   marketingAllowed
   preferencesProcessingAllowed
   saleOfDataAllowed
   saleOfDataRegion
-  setCCPAConsent
   setTrackingConsent
   shouldShowBanner
-  shouldShowCCPABanner
   shouldShowGDPRBanner
   thirdPartyMarketingAllowed
 **/
@@ -1433,6 +1452,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
@@ -1463,6 +1483,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;
@@ -1479,7 +1504,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$1;
 };
 type AnalyticsProviderProps = {
@@ -2038,6 +2063,42 @@ interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TC
 }
 declare function createHydrogenContext<TSession extends HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env, TAdditionalContext extends Record<string, any> = {}>(options: HydrogenContextOptions<TSession, TCustomMethods, TI18n, TEnv>, additionalContext?: TAdditionalContext): HydrogenRouterContextProvider<TSession, TCustomMethods, TI18n, TEnv> & TAdditionalContext;
 
+type CreateRequestHandlerOptions<Context = unknown> = {
+    /** React Router's server build */
+    build: ServerBuild;
+    /** React Router'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 React Router.
+ */
+declare function createRequestHandler<Context = unknown>({ build, mode, poweredByHeader, getLoadContext, collectTrackingInformation, proxyStandardRoutes, }: CreateRequestHandlerOptions<Context>): (request: Request) => Promise<Response>;
+
 declare const NonceProvider: react.Provider<string | undefined>;
 declare const useNonce: () => string | undefined;
 type ContentSecurityPolicy = {
@@ -2286,12 +2347,12 @@ type GetSelectedProductOptions = (request: Request) => SelectedOptionInput[];
 declare const getSelectedProductOptions: GetSelectedProductOptions;
 
 /**
- * Official Hydrogen Preset for React Router 7.9.x
+ * Official Hydrogen Preset for React Router 7.12.x
  *
  * Provides optimal React Router configuration for Hydrogen applications on Oxygen.
  * Enables validated performance optimizations while ensuring CLI compatibility.
  *
- * React Router 7.9.x Feature Support Matrix for Hydrogen 2025.7.0
+ * React Router 7.12.x Feature Support Matrix for Hydrogen 2025.7.0
  *
  * +----------------------------------+----------+----------------------------------+
  * | Feature                          | Status   | Notes                            |
@@ -2304,9 +2365,9 @@ declare const getSelectedProductOptions: GetSelectedProductOptions;
  * +----------------------------------+----------+----------------------------------+
  * | PERFORMANCE FLAGS                                                               |
  * +----------------------------------+----------+----------------------------------+
- * | unstable_optimizeDeps            | Enabled  | Build performance optimization   |
  * | v8_middleware                    | Enabled  | Required for Hydrogen context    |
- * | unstable_splitRouteModules       | Enabled  | Route code splitting             |
+ * | v8_splitRouteModules             | Enabled  | Route code splitting             |
+ * | unstable_optimizeDeps            | Enabled  | Build performance optimization   |
  * +----------------------------------+----------+----------------------------------+
  * | ROUTE DISCOVERY                                                                 |
  * +----------------------------------+----------+----------------------------------+
@@ -2320,7 +2381,7 @@ declare const getSelectedProductOptions: GetSelectedProductOptions;
  * | serverBundles: () => {}          | Blocked  | Manifest incompatibility         |
  * | buildEnd: () => {}               | Blocked  | CLI bypasses hook execution      |
  * | unstable_subResourceIntegrity    | Blocked  | CSP nonce/hash conflict          |
- * | unstable_viteEnvironmentApi      | Blocked  | CLI fallback detection used      |
+ * | v8_viteEnvironmentApi            | Blocked  | CLI fallback detection used      |
  * +----------------------------------+----------+----------------------------------+
  *
  * @version 2025.7.0
@@ -2693,4 +2754,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 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$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, cartGiftCardCodesRemoveDefault, 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, 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$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 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$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, 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

@@ -2,11 +2,11 @@ import * as react from 'react';
 import { ReactNode, ComponentType, ScriptHTMLAttributes, FC, ForwardRefExoticComponent, RefAttributes, ComponentProps } from 'react';
 import { BuyerInput, CountryCode as CountryCode$1, LanguageCode as LanguageCode$1, CartInput, CartLineInput, CartLineUpdateInput, CartBuyerIdentityInput, CartSelectedDeliveryOptionInput, AttributeInput, Scalars, CartSelectableAddressInput, CartSelectableAddressUpdateInput, Cart, CartMetafieldsSetInput, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, CartWarning, Product, ProductVariant, CartLine, ComponentizableCartLine, CurrencyCode, 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 { LanguageCode, CountryCode } from '@shopify/hydrogen-react/customer-account-api-types';
 import { ExecutionArgs } from 'graphql';
 import * as react_router from 'react-router';
-import { SessionData, FlashSessionData, Session, SessionStorage, RouterContextProvider, FetcherWithComponents, LinkProps, LoaderFunctionArgs, MetaFunction, LoaderFunction, Params, Location } from 'react-router';
+import { SessionData, FlashSessionData, Session, SessionStorage, RouterContextProvider, FetcherWithComponents, ServerBuild, LinkProps, LoaderFunctionArgs, MetaFunction, LoaderFunction, Params, Location } from 'react-router';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { PartialDeep } from 'type-fest';
 import { RouteConfigEntry } from '@react-router/dev/routes';
@@ -603,6 +603,8 @@ interface CustomerAccountMutations {
 type LoginOptions = {
     uiLocales?: LanguageCode;
     countryCode?: CountryCode;
+    acrValues?: string;
+    loginHint?: string;
 };
 type LogoutOptions = {
     /** The url to redirect customer to after logout, should be a relative URL. This url will need to included in Customer Account API's application setup for logout URI. The default value is current app origin, which is automatically setup in admin when using `--customer-account-push` flag with dev. */
@@ -1032,9 +1034,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;
 };
 
@@ -1132,6 +1136,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()` */
@@ -1409,18 +1433,13 @@ type SetConsentHeadlessParams = VisitorConsent & CustomerPrivacyConsentConfig &
   doesMerchantSupportGranularConsent
   firstPartyMarketingAllowed
   getCCPAConsent
-  getRegulation
-  getShopPrefs
   getTrackingConsent
-  isRegulationEnforced
   marketingAllowed
   preferencesProcessingAllowed
   saleOfDataAllowed
   saleOfDataRegion
-  setCCPAConsent
   setTrackingConsent
   shouldShowBanner
-  shouldShowCCPABanner
   shouldShowGDPRBanner
   thirdPartyMarketingAllowed
 **/
@@ -1433,6 +1452,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
@@ -1463,6 +1483,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;
@@ -1479,7 +1504,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$1;
 };
 type AnalyticsProviderProps = {
@@ -2038,6 +2063,42 @@ interface HydrogenContext<TSession extends HydrogenSession = HydrogenSession, TC
 }
 declare function createHydrogenContext<TSession extends HydrogenSession, TCustomMethods extends CustomMethodsBase | undefined = {}, TI18n extends I18nBase = I18nBase, TEnv extends HydrogenEnv = Env, TAdditionalContext extends Record<string, any> = {}>(options: HydrogenContextOptions<TSession, TCustomMethods, TI18n, TEnv>, additionalContext?: TAdditionalContext): HydrogenRouterContextProvider<TSession, TCustomMethods, TI18n, TEnv> & TAdditionalContext;
 
+type CreateRequestHandlerOptions<Context = unknown> = {
+    /** React Router's server build */
+    build: ServerBuild;
+    /** React Router'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 React Router.
+ */
+declare function createRequestHandler<Context = unknown>({ build, mode, poweredByHeader, getLoadContext, collectTrackingInformation, proxyStandardRoutes, }: CreateRequestHandlerOptions<Context>): (request: Request) => Promise<Response>;
+
 declare const NonceProvider: react.Provider<string | undefined>;
 declare const useNonce: () => string | undefined;
 type ContentSecurityPolicy = {
@@ -2286,12 +2347,12 @@ type GetSelectedProductOptions = (request: Request) => SelectedOptionInput[];
 declare const getSelectedProductOptions: GetSelectedProductOptions;
 
 /**
- * Official Hydrogen Preset for React Router 7.9.x
+ * Official Hydrogen Preset for React Router 7.12.x
  *
  * Provides optimal React Router configuration for Hydrogen applications on Oxygen.
  * Enables validated performance optimizations while ensuring CLI compatibility.
  *
- * React Router 7.9.x Feature Support Matrix for Hydrogen 2025.7.0
+ * React Router 7.12.x Feature Support Matrix for Hydrogen 2025.7.0
  *
  * +----------------------------------+----------+----------------------------------+
  * | Feature                          | Status   | Notes                            |
@@ -2304,9 +2365,9 @@ declare const getSelectedProductOptions: GetSelectedProductOptions;
  * +----------------------------------+----------+----------------------------------+
  * | PERFORMANCE FLAGS                                                               |
  * +----------------------------------+----------+----------------------------------+
- * | unstable_optimizeDeps            | Enabled  | Build performance optimization   |
  * | v8_middleware                    | Enabled  | Required for Hydrogen context    |
- * | unstable_splitRouteModules       | Enabled  | Route code splitting             |
+ * | v8_splitRouteModules             | Enabled  | Route code splitting             |
+ * | unstable_optimizeDeps            | Enabled  | Build performance optimization   |
  * +----------------------------------+----------+----------------------------------+
  * | ROUTE DISCOVERY                                                                 |
  * +----------------------------------+----------+----------------------------------+
@@ -2320,7 +2381,7 @@ declare const getSelectedProductOptions: GetSelectedProductOptions;
  * | serverBundles: () => {}          | Blocked  | Manifest incompatibility         |
  * | buildEnd: () => {}               | Blocked  | CLI bypasses hook execution      |
  * | unstable_subResourceIntegrity    | Blocked  | CSP nonce/hash conflict          |
- * | unstable_viteEnvironmentApi      | Blocked  | CLI fallback detection used      |
+ * | v8_viteEnvironmentApi            | Blocked  | CLI fallback detection used      |
  * +----------------------------------+----------+----------------------------------+
  *
  * @version 2025.7.0
@@ -2693,4 +2754,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 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$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, cartGiftCardCodesRemoveDefault, 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, 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$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 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$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, 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 };