@shopify/hydrogen 2023.7.13 → 2023.10.1

package/dist/production/index.d.cts

@@ -2,7 +2,7 @@ import { createStorefrontClient as createStorefrontClient$1, StorefrontClientPro
 export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MediaFile, ModelViewer, Money, ParsedMetafields, ShopPayButton, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalytics, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, flattenConnection, getClientBrowserParameters, getShopifyCookies, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useShopifyCookies } from '@shopify/hydrogen-react';
 import { ExecutionArgs } from 'graphql';
 import { LanguageCode, CountryCode, Maybe, PageInfo, CartMetafieldsSetInput, Cart, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, Scalars, AttributeInput, CartBuyerIdentityInput, CartInput, CartLineInput, CartLineUpdateInput, CartSelectedDeliveryOptionInput, ProductOption, ProductVariantConnection, ProductVariant, SelectedOptionInput } from '@shopify/hydrogen-react/storefront-api-types';
-import { LoaderArgs, LoaderFunction, SerializeFrom, AppData } from '@remix-run/server-runtime';
+import { LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
 import * as react from 'react';
 import { ReactNode, Ref, ComponentType } from 'react';
 import { Params, Location, LinkProps, FetcherWithComponents } from '@remix-run/react';
@@ -116,23 +116,23 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     mutate: <OverrideReturnType = any, RawGqlString extends string = string>(mutation: RawGqlString, ...options: RawGqlString extends keyof StorefrontMutations ? IsOptionalVariables<StorefrontMutations[RawGqlString]> extends true ? [StorefrontMutateSecondParam<RawGqlString>?] : [StorefrontMutateSecondParam<RawGqlString>] : [StorefrontMutateSecondParam?]) => Promise<RawGqlString extends keyof StorefrontMutations ? StorefrontMutations[RawGqlString]['return'] : OverrideReturnType>;
     /** The cache instance passed in from the `createStorefrontClient` argument. */
     cache?: Cache;
-    /** Re-export of [`CacheNone`](/docs/api/hydrogen/2023-07/utilities/cachenone). */
+    /** Re-export of [`CacheNone`](/docs/api/hydrogen/2023-10/utilities/cachenone). */
     CacheNone: typeof CacheNone;
-    /** Re-export of [`CacheLong`](/docs/api/hydrogen/2023-07/utilities/cachelong). */
+    /** Re-export of [`CacheLong`](/docs/api/hydrogen/2023-10/utilities/cachelong). */
     CacheLong: typeof CacheLong;
-    /** Re-export of [`CacheShort`](/docs/api/hydrogen/2023-07/utilities/cacheshort). */
+    /** Re-export of [`CacheShort`](/docs/api/hydrogen/2023-10/utilities/cacheshort). */
     CacheShort: typeof CacheShort;
-    /** Re-export of [`CacheCustom`](/docs/api/hydrogen/2023-07/utilities/cachecustom). */
+    /** Re-export of [`CacheCustom`](/docs/api/hydrogen/2023-10/utilities/cachecustom). */
     CacheCustom: typeof CacheCustom;
-    /** Re-export of [`generateCacheControlHeader`](/docs/api/hydrogen/2023-07/utilities/generatecachecontrolheader). */
+    /** Re-export of [`generateCacheControlHeader`](/docs/api/hydrogen/2023-10/utilities/generatecachecontrolheader). */
     generateCacheControlHeader: typeof generateCacheControlHeader;
-    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint. See [`getPublicTokenHeaders` in Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=%27graphql%27.-,getPublicTokenHeaders,-(props%3F%3A) for more details. */
+    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint. See [`getPublicTokenHeaders` in Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=%27graphql%27.-,getPublicTokenHeaders,-(props%3F%3A) for more details. */
     getPublicTokenHeaders: ReturnType<typeof createStorefrontClient$1>['getPublicTokenHeaders'];
-    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint for API calls made from a server. See [`getPrivateTokenHeaders` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=storefrontApiVersion-,getPrivateTokenHeaders,-(props%3F%3A) for more details.*/
+    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint for API calls made from a server. See [`getPrivateTokenHeaders` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=storefrontApiVersion-,getPrivateTokenHeaders,-(props%3F%3A) for more details.*/
     getPrivateTokenHeaders: ReturnType<typeof createStorefrontClient$1>['getPrivateTokenHeaders'];
-    /** Creates the fully-qualified URL to your myshopify.com domain. See [`getShopifyDomain` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=StorefrontClientReturn-,getShopifyDomain,-(props%3F%3A) for more details. */
+    /** Creates the fully-qualified URL to your myshopify.com domain. See [`getShopifyDomain` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=StorefrontClientReturn-,getShopifyDomain,-(props%3F%3A) for more details. */
     getShopifyDomain: ReturnType<typeof createStorefrontClient$1>['getShopifyDomain'];
-    /** Creates the fully-qualified URL to your store's GraphQL endpoint. See [`getStorefrontApiUrl` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=storeDomain-,getStorefrontApiUrl,-(props%3F%3A) for more details.*/
+    /** Creates the fully-qualified URL to your store's GraphQL endpoint. See [`getStorefrontApiUrl` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=storeDomain-,getStorefrontApiUrl,-(props%3F%3A) for more details.*/
     getApiUrl: ReturnType<typeof createStorefrontClient$1>['getStorefrontApiUrl'];
     /** Determines if the error is resulted from a Storefront API call. */
     isApiError: (error: any) => boolean;
@@ -144,10 +144,6 @@ type HydrogenClientProps<TI18n> = {
     storefrontHeaders?: StorefrontHeaders;
     /** An instance that implements the [Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache) */
     cache?: Cache;
-    /** @deprecated use storefrontHeaders instead */
-    buyerIp?: string;
-    /** @deprecated use storefrontHeaders instead */
-    requestGroupId?: string | null;
     /** The globally unique identifier for the Shop */
     storefrontId?: string;
     /** The `waitUntil` function is used to keep the current request/response lifecycle alive even after a response has been sent. It should be provided by your platform. */
@@ -169,7 +165,7 @@ type StorefrontHeaders = {
 declare const StorefrontApiError: ErrorConstructor;
 declare const isStorefrontApiError: (error: any) => boolean;
 /**
- *  This function extends `createStorefrontClient` from [Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient). The additional arguments enable internationalization (i18n), caching, and other features particular to Remix and Oxygen.
+ *  This function extends `createStorefrontClient` from [Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient). The additional arguments enable internationalization (i18n), caching, and other features particular to Remix and Oxygen.
  *
  *  Learn more about [data fetching in Hydrogen](/docs/custom-storefronts/hydrogen/data-fetching/fetch-data).
  */
@@ -232,7 +228,7 @@ declare class InMemoryCache implements Cache {
 }
 
 type StorefrontRedirect = {
-    /** The [Storefront client](/docs/api/hydrogen/2023-07/utilities/createstorefrontclient) instance */
+    /** The [Storefront client](/docs/api/hydrogen/2023-10/utilities/createstorefrontclient) instance */
     storefront: Storefront<I18nBase>;
     /** The [MDN Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object that was passed to the `server.ts` request handler. */
     request: Request;
@@ -251,7 +247,7 @@ type StorefrontRedirect = {
  */
 declare function storefrontRedirect(options: StorefrontRedirect): Promise<Response>;
 
-type GraphiQLLoader = (args: LoaderArgs) => Promise<Response>;
+type GraphiQLLoader = (args: LoaderFunctionArgs) => Promise<Response>;
 declare const graphiqlLoader: GraphiQLLoader;
 
 interface SeoConfig<Schema extends Thing = Thing> {
@@ -518,7 +514,7 @@ type SeoMedia = {
 
 interface SeoHandleFunction<Loader extends LoaderFunction | unknown = unknown, StructuredDataSchema extends Thing = Thing> {
     (args: {
-        data: Loader extends LoaderFunction ? SerializeFrom<Loader> : AppData;
+        data: Loader extends LoaderFunction ? SerializeFrom<Loader> : unknown;
         id: string;
         params: Params;
         pathname: Location['pathname'];
@@ -607,12 +603,53 @@ declare function getPaginationVariables(request: Request, options?: {
     endCursor: string | null;
 };
 
+interface HydrogenSession {
+    get: (key: string) => string | undefined;
+    set: (key: string, value: string) => void;
+    unset: (key: string) => void;
+    commit: () => Promise<string>;
+}
+
+type CustomerClient = {
+    /** Start the OAuth login flow. This function should be called and returned from a Remix action. It redirects the user to a login domain. */
+    login: () => Promise<Response>;
+    /** On successful login, the user is redirect back to your app. This function validates the OAuth response and exchanges the authorization code for an access token and refresh token. It also persists the tokens on your session. This function should be called and returned from the Remix loader configured as the redirect URI within the Customer Account API settings. */
+    authorize: (redirectPath?: string) => Promise<Response>;
+    /** Returns if the user is logged in. It also checks if the access token is expired and refreshes it if needed. */
+    isLoggedIn: () => Promise<boolean>;
+    /** Logout the user by clearing the session and redirecting to the login domain. It should be called and returned from a Remix action. */
+    logout: () => Promise<Response>;
+    /** Execute a GraphQL query against the Customer Account API. Usually you should first check if the user is logged in before querying the API. */
+    query: <ReturnType = any, RawGqlString extends string = string>(query: RawGqlString, options?: {
+        variables: Record<string, any>;
+    }) => Promise<ReturnType>;
+    /** Execute a GraphQL mutation against the Customer Account API. Usually you should first check if the user is logged in before querying the API. */
+    mutate: <ReturnType = any, RawGqlString extends string = string>(mutation: RawGqlString, options?: {
+        variables: Record<string, any>;
+    }) => Promise<ReturnType>;
+};
+type CustomerClientOptions = {
+    /** The client requires a session to persist the auth and refresh token. By default Hydrogen ships with cookie session storage, but you can use [another session storage](https://remix.run/docs/en/main/utils/sessions) implementation.  */
+    session: HydrogenSession;
+    /** Unique UUID prefixed with `shp_` associated with the application, this should be visible in the customer account api settings in the Hydrogen admin channel. */
+    customerAccountId: string;
+    /** The account URL associated with the application, this should be visible in the customer account api settings in the Hydrogen admin channel. */
+    customerAccountUrl: string;
+    /** Override the version of the API */
+    customerApiVersion?: string;
+    /** The object for the current Request. It should be provided by your platform. */
+    request: CrossRuntimeRequest;
+    /** The waitUntil function is used to keep the current request/response lifecycle alive even after a response has been sent. It should be provided by your platform. */
+    waitUntil?: ExecutionContext['waitUntil'];
+};
+declare function createCustomerClient({ session, customerAccountId, customerAccountUrl, customerApiVersion, request, waitUntil, }: CustomerClientOptions): CustomerClient;
+
 type CartOptionalInput = {
     /**
      * The cart id.
      * @default cart.getCartId();
      */
-    cartId?: Scalars['ID'];
+    cartId?: Scalars['ID']['input'];
     /**
      * The country code.
      * @default storefront.i18n.country
@@ -771,13 +808,13 @@ type CartMetafieldsSetRequire = {
 type CartMetafieldDeleteProps = {
     action: 'MetafieldsDelete';
     inputs?: {
-        key: Scalars['String'];
+        key: Scalars['String']['input'];
     } & OtherFormData;
 };
 type CartMetafieldDeleteRequire = {
     action: 'MetafieldsDelete';
     inputs: {
-        key: Scalars['String'];
+        key: Scalars['String']['input'];
     } & OtherFormData;
 };
 type CartCustomProps = {
@@ -876,7 +913,7 @@ declare function cartAttributesUpdateDefault(options: CartQueryOptions): CartAtt
 type CartMetafieldsSetFunction = (metafields: MetafieldWithoutOwnerId[], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
 declare function cartMetafieldsSetDefault(options: CartQueryOptions): CartMetafieldsSetFunction;
 
-type CartMetafieldDeleteFunction = (key: Scalars['String'], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
+type CartMetafieldDeleteFunction = (key: Scalars['String']['input'], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
 declare function cartMetafieldDeleteDefault(options: CartQueryOptions): CartMetafieldDeleteFunction;
 
 declare const cartGetIdDefault: (requestHeaders: Headers) => () => string | undefined;
@@ -901,7 +938,7 @@ type CartHandlerOptions = {
 };
 type CustomMethodsBase = Record<string, Function>;
 type CartHandlerOptionsWithCustom<TCustomMethods extends CustomMethodsBase> = CartHandlerOptions & {
-    customMethods__unstable?: TCustomMethods;
+    customMethods?: TCustomMethods;
 };
 type HydrogenCart = {
     get: ReturnType<typeof cartGetDefault>;
@@ -938,9 +975,9 @@ type VariantOptionValue = {
 type VariantSelectorProps = {
     /** The product handle for all of the variants */
     handle: string;
-    /** Product options from the [Storefront API](/docs/api/storefront/2023-07/objects/ProductOption). Make sure both `name` and `values` are apart of your query. */
+    /** Product options from the [Storefront API](/docs/api/storefront/2023-10/objects/ProductOption). Make sure both `name` and `values` are apart of your query. */
     options: Array<PartialDeep<ProductOption>> | undefined;
-    /** Product variants from the [Storefront API](/docs/api/storefront/2023-07/objects/ProductVariant). You only need to pass this prop if you want to show product availability. If a product option combination is not found within `variants`, it is assumed to be available. Make sure to include `availableForSale` and `selectedOptions.name` and `selectedOptions.value`. */
+    /** Product variants from the [Storefront API](/docs/api/storefront/2023-10/objects/ProductVariant). You only need to pass this prop if you want to show product availability. If a product option combination is not found within `variants`, it is assumed to be available. Make sure to include `availableForSale` and `selectedOptions.name` and `selectedOptions.value`. */
     variants?: PartialDeep<ProductVariantConnection> | Array<PartialDeep<ProductVariant>>;
     /** By default all products are under /products. Use this prop to provide a custom path. */
     productPath?: string;
@@ -986,4 +1023,4 @@ type OptimisticInputProps = {
 };
 declare function OptimisticInput({ id, data }: OptimisticInputProps): react_jsx_runtime.JSX.Element;
 
-export { CacheCustom, CacheLong, CacheNone, CacheShort, CartActionInput, CartForm, CartQueryData, CartQueryOptions, CartQueryReturn, CookieOptions, CreateStorefrontClientOptions, HydrogenCart, HydrogenCartCustom, I18nBase, InMemoryCache, MetafieldWithoutOwnerId, OptimisticInput, Pagination, Script, Seo, SeoConfig, SeoHandleFunction, Storefront, StorefrontApiError, StorefrontClient, StorefrontMutations, StorefrontQueries, VariantOption, VariantOptionValue, VariantSelector, WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, createCartHandler, createContentSecurityPolicy, createStorefrontClient, createWithCache, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, graphiqlLoader, isStorefrontApiError, storefrontRedirect, useNonce, useOptimisticData };
+export { CacheCustom, CacheLong, CacheNone, CacheShort, CartActionInput, CartForm, CartQueryData, CartQueryOptions, CartQueryReturn, CookieOptions, CreateStorefrontClientOptions, CustomerClient, HydrogenCart, HydrogenCartCustom, I18nBase, InMemoryCache, MetafieldWithoutOwnerId, OptimisticInput, Pagination, Script, Seo, SeoConfig, SeoHandleFunction, Storefront, StorefrontApiError, StorefrontClient, StorefrontMutations, StorefrontQueries, VariantOption, VariantOptionValue, VariantSelector, WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, createCartHandler, createContentSecurityPolicy, createCustomerClient as createCustomerClient__unstable, createStorefrontClient, createWithCache, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, graphiqlLoader, isStorefrontApiError, storefrontRedirect, useNonce, useOptimisticData };

package/dist/production/index.d.ts

@@ -2,7 +2,7 @@ import { createStorefrontClient as createStorefrontClient$1, StorefrontClientPro
 export { AnalyticsEventName, AnalyticsPageType, ClientBrowserParameters, ExternalVideo, IMAGE_FRAGMENT, Image, MediaFile, ModelViewer, Money, ParsedMetafields, ShopPayButton, ShopifyAddToCart, ShopifyAddToCartPayload, ShopifyAnalytics, ShopifyAnalyticsPayload, ShopifyAnalyticsProduct, ShopifyCookies, ShopifyPageView, ShopifyPageViewPayload, ShopifySalesChannel, StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, Video, flattenConnection, getClientBrowserParameters, getShopifyCookies, parseGid, parseMetafield, sendShopifyAnalytics, storefrontApiCustomScalars, useLoadScript, useMoney, useShopifyCookies } from '@shopify/hydrogen-react';
 import { ExecutionArgs } from 'graphql';
 import { LanguageCode, CountryCode, Maybe, PageInfo, CartMetafieldsSetInput, Cart, CartUserError, MetafieldsSetUserError, MetafieldDeleteUserError, Scalars, AttributeInput, CartBuyerIdentityInput, CartInput, CartLineInput, CartLineUpdateInput, CartSelectedDeliveryOptionInput, ProductOption, ProductVariantConnection, ProductVariant, SelectedOptionInput } from '@shopify/hydrogen-react/storefront-api-types';
-import { LoaderArgs, LoaderFunction, SerializeFrom, AppData } from '@remix-run/server-runtime';
+import { LoaderFunctionArgs, LoaderFunction, SerializeFrom } from '@remix-run/server-runtime';
 import * as react from 'react';
 import { ReactNode, Ref, ComponentType } from 'react';
 import { Params, Location, LinkProps, FetcherWithComponents } from '@remix-run/react';
@@ -116,23 +116,23 @@ type Storefront<TI18n extends I18nBase = I18nBase> = {
     mutate: <OverrideReturnType = any, RawGqlString extends string = string>(mutation: RawGqlString, ...options: RawGqlString extends keyof StorefrontMutations ? IsOptionalVariables<StorefrontMutations[RawGqlString]> extends true ? [StorefrontMutateSecondParam<RawGqlString>?] : [StorefrontMutateSecondParam<RawGqlString>] : [StorefrontMutateSecondParam?]) => Promise<RawGqlString extends keyof StorefrontMutations ? StorefrontMutations[RawGqlString]['return'] : OverrideReturnType>;
     /** The cache instance passed in from the `createStorefrontClient` argument. */
     cache?: Cache;
-    /** Re-export of [`CacheNone`](/docs/api/hydrogen/2023-07/utilities/cachenone). */
+    /** Re-export of [`CacheNone`](/docs/api/hydrogen/2023-10/utilities/cachenone). */
     CacheNone: typeof CacheNone;
-    /** Re-export of [`CacheLong`](/docs/api/hydrogen/2023-07/utilities/cachelong). */
+    /** Re-export of [`CacheLong`](/docs/api/hydrogen/2023-10/utilities/cachelong). */
     CacheLong: typeof CacheLong;
-    /** Re-export of [`CacheShort`](/docs/api/hydrogen/2023-07/utilities/cacheshort). */
+    /** Re-export of [`CacheShort`](/docs/api/hydrogen/2023-10/utilities/cacheshort). */
     CacheShort: typeof CacheShort;
-    /** Re-export of [`CacheCustom`](/docs/api/hydrogen/2023-07/utilities/cachecustom). */
+    /** Re-export of [`CacheCustom`](/docs/api/hydrogen/2023-10/utilities/cachecustom). */
     CacheCustom: typeof CacheCustom;
-    /** Re-export of [`generateCacheControlHeader`](/docs/api/hydrogen/2023-07/utilities/generatecachecontrolheader). */
+    /** Re-export of [`generateCacheControlHeader`](/docs/api/hydrogen/2023-10/utilities/generatecachecontrolheader). */
     generateCacheControlHeader: typeof generateCacheControlHeader;
-    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint. See [`getPublicTokenHeaders` in Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=%27graphql%27.-,getPublicTokenHeaders,-(props%3F%3A) for more details. */
+    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint. See [`getPublicTokenHeaders` in Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=%27graphql%27.-,getPublicTokenHeaders,-(props%3F%3A) for more details. */
     getPublicTokenHeaders: ReturnType<typeof createStorefrontClient$1>['getPublicTokenHeaders'];
-    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint for API calls made from a server. See [`getPrivateTokenHeaders` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=storefrontApiVersion-,getPrivateTokenHeaders,-(props%3F%3A) for more details.*/
+    /** Returns an object that contains headers that are needed for each query to Storefront API GraphQL endpoint for API calls made from a server. See [`getPrivateTokenHeaders` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=storefrontApiVersion-,getPrivateTokenHeaders,-(props%3F%3A) for more details.*/
     getPrivateTokenHeaders: ReturnType<typeof createStorefrontClient$1>['getPrivateTokenHeaders'];
-    /** Creates the fully-qualified URL to your myshopify.com domain. See [`getShopifyDomain` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=StorefrontClientReturn-,getShopifyDomain,-(props%3F%3A) for more details. */
+    /** Creates the fully-qualified URL to your myshopify.com domain. See [`getShopifyDomain` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=StorefrontClientReturn-,getShopifyDomain,-(props%3F%3A) for more details. */
     getShopifyDomain: ReturnType<typeof createStorefrontClient$1>['getShopifyDomain'];
-    /** Creates the fully-qualified URL to your store's GraphQL endpoint. See [`getStorefrontApiUrl` in  Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient#:~:text=storeDomain-,getStorefrontApiUrl,-(props%3F%3A) for more details.*/
+    /** Creates the fully-qualified URL to your store's GraphQL endpoint. See [`getStorefrontApiUrl` in  Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient#:~:text=storeDomain-,getStorefrontApiUrl,-(props%3F%3A) for more details.*/
     getApiUrl: ReturnType<typeof createStorefrontClient$1>['getStorefrontApiUrl'];
     /** Determines if the error is resulted from a Storefront API call. */
     isApiError: (error: any) => boolean;
@@ -144,10 +144,6 @@ type HydrogenClientProps<TI18n> = {
     storefrontHeaders?: StorefrontHeaders;
     /** An instance that implements the [Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache) */
     cache?: Cache;
-    /** @deprecated use storefrontHeaders instead */
-    buyerIp?: string;
-    /** @deprecated use storefrontHeaders instead */
-    requestGroupId?: string | null;
     /** The globally unique identifier for the Shop */
     storefrontId?: string;
     /** The `waitUntil` function is used to keep the current request/response lifecycle alive even after a response has been sent. It should be provided by your platform. */
@@ -169,7 +165,7 @@ type StorefrontHeaders = {
 declare const StorefrontApiError: ErrorConstructor;
 declare const isStorefrontApiError: (error: any) => boolean;
 /**
- *  This function extends `createStorefrontClient` from [Hydrogen React](/docs/api/hydrogen-react/2023-07/utilities/createstorefrontclient). The additional arguments enable internationalization (i18n), caching, and other features particular to Remix and Oxygen.
+ *  This function extends `createStorefrontClient` from [Hydrogen React](/docs/api/hydrogen-react/2023-10/utilities/createstorefrontclient). The additional arguments enable internationalization (i18n), caching, and other features particular to Remix and Oxygen.
  *
  *  Learn more about [data fetching in Hydrogen](/docs/custom-storefronts/hydrogen/data-fetching/fetch-data).
  */
@@ -232,7 +228,7 @@ declare class InMemoryCache implements Cache {
 }
 
 type StorefrontRedirect = {
-    /** The [Storefront client](/docs/api/hydrogen/2023-07/utilities/createstorefrontclient) instance */
+    /** The [Storefront client](/docs/api/hydrogen/2023-10/utilities/createstorefrontclient) instance */
     storefront: Storefront<I18nBase>;
     /** The [MDN Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object that was passed to the `server.ts` request handler. */
     request: Request;
@@ -251,7 +247,7 @@ type StorefrontRedirect = {
  */
 declare function storefrontRedirect(options: StorefrontRedirect): Promise<Response>;
 
-type GraphiQLLoader = (args: LoaderArgs) => Promise<Response>;
+type GraphiQLLoader = (args: LoaderFunctionArgs) => Promise<Response>;
 declare const graphiqlLoader: GraphiQLLoader;
 
 interface SeoConfig<Schema extends Thing = Thing> {
@@ -518,7 +514,7 @@ type SeoMedia = {
 
 interface SeoHandleFunction<Loader extends LoaderFunction | unknown = unknown, StructuredDataSchema extends Thing = Thing> {
     (args: {
-        data: Loader extends LoaderFunction ? SerializeFrom<Loader> : AppData;
+        data: Loader extends LoaderFunction ? SerializeFrom<Loader> : unknown;
         id: string;
         params: Params;
         pathname: Location['pathname'];
@@ -607,12 +603,53 @@ declare function getPaginationVariables(request: Request, options?: {
     endCursor: string | null;
 };
 
+interface HydrogenSession {
+    get: (key: string) => string | undefined;
+    set: (key: string, value: string) => void;
+    unset: (key: string) => void;
+    commit: () => Promise<string>;
+}
+
+type CustomerClient = {
+    /** Start the OAuth login flow. This function should be called and returned from a Remix action. It redirects the user to a login domain. */
+    login: () => Promise<Response>;
+    /** On successful login, the user is redirect back to your app. This function validates the OAuth response and exchanges the authorization code for an access token and refresh token. It also persists the tokens on your session. This function should be called and returned from the Remix loader configured as the redirect URI within the Customer Account API settings. */
+    authorize: (redirectPath?: string) => Promise<Response>;
+    /** Returns if the user is logged in. It also checks if the access token is expired and refreshes it if needed. */
+    isLoggedIn: () => Promise<boolean>;
+    /** Logout the user by clearing the session and redirecting to the login domain. It should be called and returned from a Remix action. */
+    logout: () => Promise<Response>;
+    /** Execute a GraphQL query against the Customer Account API. Usually you should first check if the user is logged in before querying the API. */
+    query: <ReturnType = any, RawGqlString extends string = string>(query: RawGqlString, options?: {
+        variables: Record<string, any>;
+    }) => Promise<ReturnType>;
+    /** Execute a GraphQL mutation against the Customer Account API. Usually you should first check if the user is logged in before querying the API. */
+    mutate: <ReturnType = any, RawGqlString extends string = string>(mutation: RawGqlString, options?: {
+        variables: Record<string, any>;
+    }) => Promise<ReturnType>;
+};
+type CustomerClientOptions = {
+    /** The client requires a session to persist the auth and refresh token. By default Hydrogen ships with cookie session storage, but you can use [another session storage](https://remix.run/docs/en/main/utils/sessions) implementation.  */
+    session: HydrogenSession;
+    /** Unique UUID prefixed with `shp_` associated with the application, this should be visible in the customer account api settings in the Hydrogen admin channel. */
+    customerAccountId: string;
+    /** The account URL associated with the application, this should be visible in the customer account api settings in the Hydrogen admin channel. */
+    customerAccountUrl: string;
+    /** Override the version of the API */
+    customerApiVersion?: string;
+    /** The object for the current Request. It should be provided by your platform. */
+    request: CrossRuntimeRequest;
+    /** The waitUntil function is used to keep the current request/response lifecycle alive even after a response has been sent. It should be provided by your platform. */
+    waitUntil?: ExecutionContext['waitUntil'];
+};
+declare function createCustomerClient({ session, customerAccountId, customerAccountUrl, customerApiVersion, request, waitUntil, }: CustomerClientOptions): CustomerClient;
+
 type CartOptionalInput = {
     /**
      * The cart id.
      * @default cart.getCartId();
      */
-    cartId?: Scalars['ID'];
+    cartId?: Scalars['ID']['input'];
     /**
      * The country code.
      * @default storefront.i18n.country
@@ -771,13 +808,13 @@ type CartMetafieldsSetRequire = {
 type CartMetafieldDeleteProps = {
     action: 'MetafieldsDelete';
     inputs?: {
-        key: Scalars['String'];
+        key: Scalars['String']['input'];
     } & OtherFormData;
 };
 type CartMetafieldDeleteRequire = {
     action: 'MetafieldsDelete';
     inputs: {
-        key: Scalars['String'];
+        key: Scalars['String']['input'];
     } & OtherFormData;
 };
 type CartCustomProps = {
@@ -876,7 +913,7 @@ declare function cartAttributesUpdateDefault(options: CartQueryOptions): CartAtt
 type CartMetafieldsSetFunction = (metafields: MetafieldWithoutOwnerId[], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
 declare function cartMetafieldsSetDefault(options: CartQueryOptions): CartMetafieldsSetFunction;
 
-type CartMetafieldDeleteFunction = (key: Scalars['String'], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
+type CartMetafieldDeleteFunction = (key: Scalars['String']['input'], optionalParams?: CartOptionalInput) => Promise<CartQueryData>;
 declare function cartMetafieldDeleteDefault(options: CartQueryOptions): CartMetafieldDeleteFunction;
 
 declare const cartGetIdDefault: (requestHeaders: Headers) => () => string | undefined;
@@ -901,7 +938,7 @@ type CartHandlerOptions = {
 };
 type CustomMethodsBase = Record<string, Function>;
 type CartHandlerOptionsWithCustom<TCustomMethods extends CustomMethodsBase> = CartHandlerOptions & {
-    customMethods__unstable?: TCustomMethods;
+    customMethods?: TCustomMethods;
 };
 type HydrogenCart = {
     get: ReturnType<typeof cartGetDefault>;
@@ -938,9 +975,9 @@ type VariantOptionValue = {
 type VariantSelectorProps = {
     /** The product handle for all of the variants */
     handle: string;
-    /** Product options from the [Storefront API](/docs/api/storefront/2023-07/objects/ProductOption). Make sure both `name` and `values` are apart of your query. */
+    /** Product options from the [Storefront API](/docs/api/storefront/2023-10/objects/ProductOption). Make sure both `name` and `values` are apart of your query. */
     options: Array<PartialDeep<ProductOption>> | undefined;
-    /** Product variants from the [Storefront API](/docs/api/storefront/2023-07/objects/ProductVariant). You only need to pass this prop if you want to show product availability. If a product option combination is not found within `variants`, it is assumed to be available. Make sure to include `availableForSale` and `selectedOptions.name` and `selectedOptions.value`. */
+    /** Product variants from the [Storefront API](/docs/api/storefront/2023-10/objects/ProductVariant). You only need to pass this prop if you want to show product availability. If a product option combination is not found within `variants`, it is assumed to be available. Make sure to include `availableForSale` and `selectedOptions.name` and `selectedOptions.value`. */
     variants?: PartialDeep<ProductVariantConnection> | Array<PartialDeep<ProductVariant>>;
     /** By default all products are under /products. Use this prop to provide a custom path. */
     productPath?: string;
@@ -986,4 +1023,4 @@ type OptimisticInputProps = {
 };
 declare function OptimisticInput({ id, data }: OptimisticInputProps): react_jsx_runtime.JSX.Element;
 
-export { CacheCustom, CacheLong, CacheNone, CacheShort, CartActionInput, CartForm, CartQueryData, CartQueryOptions, CartQueryReturn, CookieOptions, CreateStorefrontClientOptions, HydrogenCart, HydrogenCartCustom, I18nBase, InMemoryCache, MetafieldWithoutOwnerId, OptimisticInput, Pagination, Script, Seo, SeoConfig, SeoHandleFunction, Storefront, StorefrontApiError, StorefrontClient, StorefrontMutations, StorefrontQueries, VariantOption, VariantOptionValue, VariantSelector, WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, createCartHandler, createContentSecurityPolicy, createStorefrontClient, createWithCache, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, graphiqlLoader, isStorefrontApiError, storefrontRedirect, useNonce, useOptimisticData };
+export { CacheCustom, CacheLong, CacheNone, CacheShort, CartActionInput, CartForm, CartQueryData, CartQueryOptions, CartQueryReturn, CookieOptions, CreateStorefrontClientOptions, CustomerClient, HydrogenCart, HydrogenCartCustom, I18nBase, InMemoryCache, MetafieldWithoutOwnerId, OptimisticInput, Pagination, Script, Seo, SeoConfig, SeoHandleFunction, Storefront, StorefrontApiError, StorefrontClient, StorefrontMutations, StorefrontQueries, VariantOption, VariantOptionValue, VariantSelector, WithCache, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, createCartHandler, createContentSecurityPolicy, createCustomerClient as createCustomerClient__unstable, createStorefrontClient, createWithCache, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, graphiqlLoader, isStorefrontApiError, storefrontRedirect, useNonce, useOptimisticData };