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

package/README.md

@@ -100,13 +100,13 @@ const isLoggedIn = await customerSession.isLoggedIn(
 );
 ```
 
-Customer Account OAuth methods require a public HTTPS origin. The writable session manager should expose the request origin; explicit `origin` options are only needed as overrides. For local development, use a tunnel or trusted local HTTPS through `localHttps` from `@shopify/hydrogen/vite`, and pass the framework's canonical request URL rather than an untrusted forwarded host.
+Customer Account OAuth methods require a public HTTPS origin. The writable session manager should expose the request origin; explicit `origin` options are only needed as overrides. For local development, use a tunnel or trusted local HTTPS through `localHttps` from `@shopify/hydrogen/vite`, which provisions certificates and uses Shopify CLI to push Customer Account URLs outside CI. Pass the framework's canonical request URL rather than an untrusted forwarded host.
 
 Pass `customerSession` to `createCartServerHandlers({customerSession})` to associate newly created carts with the current customer when the session has a usable access token or successfully refreshed access token, and mark checkout URLs in authenticated cart GET responses with `logged_in=true`.
 
 Use `createCustomerAccountServerHandlers({customerSession})` with `handleShopifyRoutes` to install the default `GET /account/login`, `GET /account/authorize`, `GET /account/refresh`, and `POST /account/logout` handlers. Pass those cart server handlers as `cartServerHandlers` to also keep the browser cart's buyer identity in step with the customer session: authorization and refresh attach the customer to the cart, a definitive refresh rejection and logout detach it. Sync is best-effort — a failed cart mutation never blocks the route's redirect; a failed detach during logout or definitive refresh rejection expires the cart cookie instead. `cartServerHandlers` requires the `customerSession` returned by `createCustomerSession` shared by both handler groups. Pass the same request-scoped `requestContext` and `sessionManager` into `handleShopifyRoutes` once alongside the `storefrontClient`. Session managers can be read-only for `isLoggedIn()` / `getAccessToken()` and writable for cart POST handlers configured with `customerSession`, `getOrRefreshAccessToken()`, `prepareLoginUrl()`, `handleOAuthCallback()`, `logout()`, and registered account handlers. `isLoggedIn()` is a read-only UI/session-presence check: it returns true for a usable access token or a refresh token that can attempt to restore one later. `getAccessToken()` still returns only a currently usable access token and never refreshes.
 
-The login handler respects a sanitized `return_to` search parameter and otherwise redirects back to `defaultPostLoginRedirectPathname` (default `/`). The logout handler redirects through Shopify using `postLogoutRedirectUri` (default `/`) when an ID token is present; otherwise, it redirects directly to `postLogoutRedirectUri`. Apps can still implement their own framework routes when they need custom behavior.
+The login handler respects a `return_to` search parameter when it is a same-origin path or URL, such as `/account/orders`, and otherwise redirects back to `defaultPostLoginRedirectPathname` (default `/`). The logout handler redirects through Shopify using `postLogoutRedirectUri` (default `/`) when an ID token is present; otherwise, it redirects directly to `postLogoutRedirectUri`. Apps can still implement their own framework routes when they need custom behavior.
 
 When a writable method can update cookie-backed session state, commit once while finalizing the response and append headers from `await sessionManager.commit?.()` there. After committing session headers, call `requestContext.applyResponseHeaders(response.headers)`. Customer Account session reads and GraphQL calls mark the request context private so the finalizer can prevent public/CDN caching of personalized responses.
 

package/dist/cli/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { chmod, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
+import { homedir, tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { spawn } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
@@ -46,9 +46,9 @@ function writeToConsole(level, message, context) {
 	console[CONSOLE_METHODS[level]](...args);
 }
 /**
-* Built-in sink: writes `[hydrogen:<level>:<scope>] <message>` to a
-* level-specific `console` method, followed by `context.error` and any extra
-* context fields. `trace` uses `console.debug`; `fatal` uses `console.error`.
+* The built-in logger. Writes each entry to the matching console method, with a
+* `[hydrogen:<level>:<scope>]` prefix when the entry has a scope, followed by the error and any
+* extra context fields. Trace entries use `console.debug`, and fatal entries use `console.error`.
 */
 const consoleLogger = {
 	trace: (message, context) => writeToConsole("trace", message, context),
@@ -243,15 +243,27 @@ async function uninstallCertificateAuthority() {
 
 //#endregion
 //#region src/vite/local-https.ts
+/**
+* Default host, `local.tryhydrogen.dev`, and port, `5173`, for local HTTPS. Pass the values to frameworks that set their own dev server host and port, such as Astro.
+*
+* @publicDocs
+*/
 const LOCAL_HTTPS_DEFAULTS = {
 	host: "local.tryhydrogen.dev",
 	port: 5173
 };
 /**
-* Downloads a pinned, checksum-verified mkcert release and generates the
-* trusted local certificate files when they do not exist yet. The Vite plugin
-* runs this automatically on `vite dev`; call it directly for frameworks that
-* read certificate paths before Vite starts or from setup scripts.
+* Creates trusted certificate files for local HTTPS. Call the function from a setup script, or
+* before you start a framework that reads certificate paths when its config loads, such as Nuxt.
+*
+* When both files exist, the function returns their paths and changes nothing. Otherwise, the
+* function downloads a pinned, checksum-verified mkcert release, adds the mkcert certificate
+* authority to your system trust store, and creates the certificate and private key. mkcert can
+* ask for your password.
+*
+* @param options Host and certificate paths. Each option has a Hydrogen default.
+* @returns The host and the absolute paths to the certificate and the private key.
+* @publicDocs
 */
 async function provisionLocalHttps(options = {}) {
 	const settings = resolveLocalHttpsSettings({
@@ -444,6 +456,24 @@ function isObjectRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+//#endregion
+//#region src/cli/terminal.ts
+function canPromptInTerminal(env = process.env) {
+	return Boolean(process.stdin.isTTY && process.stdout.isTTY) && !env.CI;
+}
+async function confirmInTerminal(question) {
+	const readline = createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		const answer = (await readline.question(`${question} [Y/n] `)).trim().toLowerCase();
+		return answer === "" || answer === "y" || answer === "yes";
+	} finally {
+		readline.close();
+	}
+}
+
 //#endregion
 //#region src/cli/skills.ts
 const PACKAGE_NAME$1 = "@shopify/hydrogen";
@@ -681,21 +711,6 @@ async function planOrphans(plans, version, confirm) {
 		});
 	}
 }
-function canPromptInTerminal() {
-	return Boolean(process.stdin.isTTY && process.stdout.isTTY) && !process.env.CI;
-}
-async function confirmInTerminal(question) {
-	const readline = createInterface({
-		input: process.stdin,
-		output: process.stdout
-	});
-	try {
-		const answer = (await readline.question(`${question} [Y/n] `)).trim().toLowerCase();
-		return answer === "" || answer === "y" || answer === "yes";
-	} finally {
-		readline.close();
-	}
-}
 /** Never removes user edits without an answer, so no TTY means keep. */
 function confirmByDefault(question) {
 	return canPromptInTerminal() ? confirmInTerminal(question) : Promise.resolve(false);
@@ -931,13 +946,14 @@ function parsePackageManager(value) {
 		if (value.startsWith(`${packageManager}/`)) return packageManager;
 	}
 }
+function detectPackageManagerFromEnv(env) {
+	return parsePackageManager(env.npm_config_user_agent);
+}
 function detectPackageManager(appRoot, packageJson, env) {
 	const packageJsonManager = parsePackageManager(packageJson.packageManager);
 	if (packageJsonManager) return packageJsonManager;
 	for (const [packageManager, lockfile] of PACKAGE_MANAGER_LOCKFILES) if (existsSync(join(appRoot, lockfile))) return packageManager;
-	const userAgentManager = parsePackageManager(env.npm_config_user_agent);
-	if (userAgentManager) return userAgentManager;
-	throw new Error("Could not detect a package manager. Add a packageManager field or a lockfile before running setup.");
+	return detectPackageManagerFromEnv(env) ?? "npm";
 }
 function hasHydrogenDependency(packageJson) {
 	return Boolean(packageJson.dependencies?.[PACKAGE_NAME] ?? packageJson.devDependencies?.[PACKAGE_NAME]);
@@ -961,17 +977,115 @@ function spawnRunCommand(command, args, options) {
 		});
 	});
 }
-async function setupHydrogen(options = {}) {
-	const appRoot = options.cwd ?? process.cwd();
-	const env = options.env ?? process.env;
-	const runCommand = options.runCommand ?? spawnRunCommand;
-	const log = options.log ?? console.log;
+const TEMPLATE_TARBALL_URL = "https://codeload.github.com/Shopify/hydrogen/tar.gz/dist-preview";
+const TEMPLATE_TARBALL_PREFIX = "hydrogen-dist-preview/templates/react-router/";
+const TEMPLATE_TARBALL_STRIP_COMPONENTS = TEMPLATE_TARBALL_PREFIX.split("/").filter(Boolean).length;
+async function promptSetupChoice(log) {
+	log("\nNo project found in this directory.\n");
+	log("  1) Create a new Hydrogen storefront (React Router)");
+	log("  2) Just install Hydrogen skills\n");
+	const readline = createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		while (true) {
+			const answer = (await readline.question("Your choice [1] ")).trim();
+			if (answer === "" || answer === "1") return "scaffold";
+			if (answer === "2") return "skills";
+			log("Please enter \"1\" or \"2\".");
+		}
+	} finally {
+		readline.close();
+	}
+}
+function hasPackageJson(appRoot) {
+	return existsSync(join(appRoot, PACKAGE_JSON_FILE_NAME));
+}
+async function downloadAndExtractTemplate(appRoot, runCommand) {
+	const response = await fetch(TEMPLATE_TARBALL_URL, { signal: AbortSignal.timeout(3e4) });
+	if (!response.ok) throw new Error(`Failed to download template (${response.status}). Check your internet connection.`);
+	const tempDir = mkdtempSync(join(tmpdir(), "hydrogen-template-"));
+	const tempFile = "template.tar.gz";
+	try {
+		writeFileSync(join(tempDir, tempFile), Buffer.from(await response.arrayBuffer()));
+		await runCommand("tar", [
+			"xzf",
+			tempFile,
+			`--strip-components=${TEMPLATE_TARBALL_STRIP_COMPONENTS}`,
+			"-C",
+			appRoot,
+			TEMPLATE_TARBALL_PREFIX
+		], { cwd: tempDir });
+	} finally {
+		rmSync(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function updateScaffoldedPackageJson(appRoot) {
+	const packageJsonPath = join(appRoot, PACKAGE_JSON_FILE_NAME);
+	const raw = readFileSync(packageJsonPath, "utf8");
+	const parsed = JSON.parse(raw);
+	if (!isObjectRecord(parsed)) return;
+	parsed.name = basename(appRoot);
+	delete parsed.private;
+	delete parsed.packageManager;
+	writeFileSync(packageJsonPath, JSON.stringify(parsed, null, 2) + "\n");
+}
+async function scaffoldTemplate(appRoot, env, runCommand, log) {
+	log("Downloading Hydrogen template...");
+	await downloadAndExtractTemplate(appRoot, runCommand);
+	updateScaffoldedPackageJson(appRoot);
+	const packageManager = detectPackageManagerFromEnv(env) ?? "npm";
+	log(`Installing dependencies with ${packageManager}...`);
+	try {
+		await runCommand(packageManager, ["install"], { cwd: appRoot });
+	} catch (error) {
+		throw new Error(`Template was created but dependency install failed. Run \`${packageManager} install\` or re-run \`npx @shopify/hydrogen setup\` in ${appRoot} to finish.`, { cause: error });
+	}
+	return packageManager;
+}
+async function ensureHydrogenInstalled(appRoot, env, runCommand, log) {
 	const packageJson = readPackageJson(appRoot);
-	if (!hasHydrogenDependency(packageJson)) {
+	if (hasHydrogenDependency(packageJson) && getInstalledPackageRoot(appRoot)) return;
+	if (hasHydrogenDependency(packageJson)) {
 		const packageManager = detectPackageManager(appRoot, packageJson, env);
-		log(`Installing ${PACKAGE_NAME} with ${packageManager}...`);
-		await installHydrogen(appRoot, packageManager, runCommand);
+		log(`${PACKAGE_NAME} is declared but not installed. Running ${packageManager} install...`);
+		await runCommand(packageManager, ["install"], { cwd: appRoot });
+		return;
 	}
+	const packageManager = detectPackageManager(appRoot, packageJson, env);
+	log(`Installing ${PACKAGE_NAME} with ${packageManager}...`);
+	await installHydrogen(appRoot, packageManager, runCommand);
+}
+function resolveSetupOptions(options) {
+	const env = options.env ?? process.env;
+	return {
+		appRoot: options.cwd ?? process.cwd(),
+		env,
+		runCommand: options.runCommand ?? spawnRunCommand,
+		log: options.log ?? console.log,
+		prompt: options.prompt ?? (canPromptInTerminal(env) ? promptSetupChoice : void 0)
+	};
+}
+const IGNORED_DIRECTORY_ENTRIES = new Set([".git", ".DS_Store"]);
+function isEmptyDirectory(dir) {
+	return readdirSync(dir).every((entry) => IGNORED_DIRECTORY_ENTRIES.has(entry));
+}
+async function setupHydrogen(options = {}) {
+	const { appRoot, env, runCommand, log, prompt } = resolveSetupOptions(options);
+	if (hasPackageJson(appRoot)) await ensureHydrogenInstalled(appRoot, env, runCommand, log);
+	else if (isEmptyDirectory(appRoot)) {
+		let choice;
+		if (prompt) choice = await prompt(log);
+		else {
+			log("No package.json found and no terminal to prompt; installing skills only.");
+			choice = "skills";
+		}
+		if (choice === "scaffold") log(`\nHydrogen storefront created. Run \`${await scaffoldTemplate(appRoot, env, runCommand, log)} run dev\` to start (uses mock.shop by default).\n`);
+	} else throw new Error("No package.json found. Run this command from your project root.");
 	await syncSkills({
 		force: options.force,
 		cwd: appRoot,

package/dist/client/client.d.mts

@@ -5,26 +5,29 @@ import { ClientType, CreateStorefrontClientArgs, StorefrontClient } from "./type
 
 //#region src/client/client.d.ts
 /**
- * Creates a type-safe Storefront API client.
+ * Creates a Storefront API client that runs typed queries and mutations against your store.
  *
- * Pick a `type` based on where your code runs and whether buyer context is available:
+ * Set `type` based on where your code runs and whether customer context is available:
  *
- * |                 | public                         | private                       | private_no_buyer_context |
- * |-----------------|--------------------------------|-------------------------------|--------------------------|
- * | Runs in         | Browser or mobile              | Server (SSR)                  | Server (background)      |
- * | Token           | Public access token, or none   | Private access token          | Private access token     |
- * | Buyer context   | Browser request context        | You forward trusted `buyerIp` | None                     |
- * | Best for        | Client-side fetches            | SSR with buyer context        | Webhooks, background jobs |
+ * |                  | `public`                   | `private`                   | `private_no_buyer_context` |
+ * |------------------|------------------------------|-------------------------------|------------------------------|
+ * | Runs in          | Browser or mobile            | Server-side rendering         | Background server code    |
+ * | Token            | Public access token, or none | Private access token          | Private access token      |
+ * | Customer context | Browser request context      | You forward trusted `buyerIp` | None                      |
+ * | Best for         | Client-side fetches          | SSR with customer context     | Webhooks, background jobs |
  *
- * Pass `requestContext` so the client's SFAPI requests carry request-scoped
- * headers, follow the incoming request's abort signal, and read the resolved
- * `i18n` used for Storefront API variable injection and localized routes.
+ * Pass a request context from `createShopifyRequestContext`. The client forwards the incoming
+ * request's cookies and `Sec-GPC` header to the Storefront API, and fills `$country`
+ * and `$language` variables from the context's locale. The client reads the request headers once,
+ * when you create the client. Create a client for each incoming request, and create a client at
+ * module scope only with a static request context.
  *
- * Token-based access is required for some Storefront API fields, including
- * product tags, metaobjects, metafields, menus, and customers. Use a private
- * client only in trusted server code where the token cannot leak to browsers.
+ * Keep private clients in server code, where the token can't reach browsers. The function throws an
+ * error when you create either private client type in a browser. The function throws a `TypeError`
+ * when the request context of a `private` client has no `buyerIp`.
  *
- * @see {@link https://shopify.dev/docs/api/storefront#authentication | Storefront API authentication}
+ * @see [Storefront API authentication](https://shopify.dev/docs/api/storefront#authentication)
+ * @publicDocs
  */
 declare function createStorefrontClient<const Type extends ClientType, const RequestContext extends ShopifyRequestContext, const CacheConfig extends CacheInstance | undefined = undefined>(args: CreateStorefrontClientArgs<RequestContext, Type, CacheConfig>): StorefrontClient<[CacheConfig] extends [CacheInstance] ? {
   cache?: CachingStrategy;

package/dist/client/client.mjs

@@ -1,8 +1,8 @@
+import { normalizeStoreDomain } from "../core/url.mjs";
 import { getHydrogenCacheStatus } from "../core/cache/cache-status.mjs";
 import { createFetchWithCache } from "../core/cache/fetch-with-cache.mjs";
 import { DEFAULT_TIMEOUT_IN_MS, STOREFRONT_API_VERSION } from "../core/constants.mjs";
 import { HYDROGEN_VERSION_HEADER, REQUEST_GROUP_ID_HEADER, SDK_VARIANT_HEADER, SDK_VARIANT_SOURCE_HEADER, SDK_VERSION_HEADER, SHOPIFY_STOREFRONT_S_HEADER, SHOPIFY_STOREFRONT_Y_HEADER, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER, STOREFRONT_ACCESS_TOKEN_HEADER, STOREFRONT_BUYER_IP_HEADER, STOREFRONT_ID_HEADER, STOREFRONT_PRIVATE_TOKEN_HEADER } from "../core/headers.mjs";
-import { normalizeStoreDomain } from "../core/url.mjs";
 import { StorefrontApiError, StorefrontTimeoutError } from "./errors.mjs";
 
 //#region src/client/client.ts
@@ -38,11 +38,15 @@ function withStorefrontClientCache(client, options, strategy, shouldCacheResult)
 		[SHOULD_CACHE_RESULT]: shouldCacheResult
 	};
 }
+/**
+* @param args The client type, request context, and store configuration for the new client.
+* @returns The client, with a `graphql()` method that runs queries and mutations.
+*/
 function createStorefrontClient(args) {
 	const { config, requestContext, type: clientType } = args;
 	if (!config.storeDomain) throw new Error("storeDomain is required and must be non-empty");
 	const storeUrl = normalizeStoreDomain(config.storeDomain);
-	const apiUrl = `${storeUrl}/api/${config.apiVersion ?? "2026-04"}/graphql.json`;
+	const apiUrl = `${storeUrl}/api/${config.apiVersion ?? "2026-10"}/graphql.json`;
 	const originFetch = config.fetch ?? globalThis.fetch;
 	if (typeof originFetch !== "function") throw new Error("No fetch function available. Pass a fetch option or ensure globalThis.fetch exists.");
 	const resolvedFetch = config.cache ? createFetchWithCache({
@@ -104,7 +108,7 @@ function createStorefrontClient(args) {
 				}),
 				signal: externalSignals.length > 0 ? AbortSignal.any(externalSignals) : void 0
 			};
-			const response = await resolvedFetch(apiUrl, init, createStorefrontCacheOptions(apiUrl, init, queryText, opts.cache, opts[SHOULD_CACHE_RESULT]));
+			const response = await resolvedFetch(apiUrl, init, createStorefrontCacheOptions(apiUrl, init, queryText, opts.cache, opts[SHOULD_CACHE_RESULT], timeoutInMs > 0 ? timeoutInMs : DEFAULT_TIMEOUT_IN_MS));
 			responseHeaders = response.headers;
 			if (getHydrogenCacheStatus(responseHeaders) !== "hit") requestContext.captureSubrequestHeaders(responseHeaders);
 			requestId = responseHeaders.get("x-request-id") ?? void 0;
@@ -174,7 +178,7 @@ function buildVariables(queryText, userVariables, resolvedI18n) {
 	if (LANGUAGE_VAR_RE.test(queryText)) variables.language = resolvedI18n.language;
 	return variables;
 }
-function createStorefrontCacheOptions(apiUrl, init, queryText, strategy, shouldCacheResult) {
+function createStorefrontCacheOptions(apiUrl, init, queryText, strategy, shouldCacheResult, backgroundTimeoutInMs) {
 	if (!strategy) return void 0;
 	if (/\bmutation\b/.test(queryText)) return void 0;
 	return {
@@ -185,7 +189,8 @@ function createStorefrontCacheOptions(apiUrl, init, queryText, strategy, shouldC
 			const body = await json().catch(() => void 0);
 			if (typeof body !== "object" || body == null || Array.isArray(body) || "errors" in body) return false;
 			return shouldCacheResult?.(body) ?? true;
-		}
+		},
+		backgroundSignal: () => AbortSignal.timeout(backgroundTimeoutInMs)
 	};
 }
 function createStorefrontCacheKey(apiUrl, init) {

package/dist/client/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import type { TadaDocumentNode } from \"gql.tada\";\n\nimport { getHydrogenCacheStatus } from \"../core/cache/cache-status\";\nimport { createFetchWithCache } from \"../core/cache/fetch-with-cache\";\nimport type { FetchCacheOptions, FetchCacheResponseContext } from \"../core/cache/fetch-with-cache\";\nimport type { CacheInstance } from \"../core/cache/run-with-cache\";\nimport type { CachingStrategy } from \"../core/cache/strategies\";\nimport { DEFAULT_TIMEOUT_IN_MS, STOREFRONT_API_VERSION } from \"../core/constants\";\nimport {\n  HYDROGEN_VERSION_HEADER,\n  REQUEST_GROUP_ID_HEADER,\n  SDK_VARIANT_HEADER,\n  SDK_VARIANT_SOURCE_HEADER,\n  SDK_VERSION_HEADER,\n  SHOPIFY_STOREFRONT_S_HEADER,\n  SHOPIFY_STOREFRONT_Y_HEADER,\n  STOREFRONT_ACCESS_TOKEN_HEADER,\n  STOREFRONT_BUYER_IP_HEADER,\n  STOREFRONT_ID_HEADER,\n  STOREFRONT_PRIVATE_TOKEN_HEADER,\n  SHOPIFY_UNIQUE_TOKEN_HEADER,\n  SHOPIFY_VISIT_TOKEN_HEADER,\n} from \"../core/headers\";\nimport type { I18nConfig, ShopifyRequestContext } from \"../core/request-context\";\nimport { normalizeStoreDomain } from \"../core/url\";\nimport type { AnyStorefrontQueryString } from \"../graphql\";\nimport { StorefrontApiError, StorefrontTimeoutError } from \"./errors\";\nimport type {\n  ClientType,\n  CreateStorefrontClientArgs,\n  GraphQLFormattedError,\n  StorefrontClient,\n  StorefrontGraphqlResult,\n} from \"./types\";\n\ntype DocLike = TadaDocumentNode<unknown, unknown> | AnyStorefrontQueryString;\ntype FetchInput = Parameters<typeof globalThis.fetch>[0];\ntype FetchInit = Parameters<typeof globalThis.fetch>[1];\ntype ResolvedStorefrontFetch = (\n  input: FetchInput,\n  init: FetchInit,\n  cacheOptions: FetchCacheOptions | undefined,\n) => Promise<Response>;\n\nconst COUNTRY_VAR_RE = /\\$country\\s*:/;\nconst LANGUAGE_VAR_RE = /\\$language\\s*:/;\nconst REQUEST_CACHE_KEY_HEADERS = new Set([\n  \"content-type\",\n  \"user-agent\",\n  SDK_VARIANT_HEADER.toLowerCase(),\n  SDK_VARIANT_SOURCE_HEADER.toLowerCase(),\n  SDK_VERSION_HEADER.toLowerCase(),\n  HYDROGEN_VERSION_HEADER.toLowerCase(),\n  STOREFRONT_ACCESS_TOKEN_HEADER.toLowerCase(),\n  STOREFRONT_PRIVATE_TOKEN_HEADER.toLowerCase(),\n]);\nconst REQUEST_IDENTITY_HEADERS = new Set([\n  \"cookie\",\n  REQUEST_GROUP_ID_HEADER.toLowerCase(),\n  STOREFRONT_BUYER_IP_HEADER.toLowerCase(),\n  SHOPIFY_UNIQUE_TOKEN_HEADER.toLowerCase(),\n  SHOPIFY_VISIT_TOKEN_HEADER.toLowerCase(),\n  SHOPIFY_STOREFRONT_Y_HEADER.toLowerCase(),\n  SHOPIFY_STOREFRONT_S_HEADER.toLowerCase(),\n]);\nconst CACHE_ENABLED_GRAPHQL_CLIENTS = new WeakSet<StorefrontClient[\"graphql\"]>();\nconst SHOULD_CACHE_RESULT = Symbol();\n\ntype ShouldCacheResult = (body: object) => boolean;\n\nclass StorefrontCacheConfigError extends Error {}\n\nexport function withStorefrontClientCache<TOptions extends object>(\n  client: Pick<StorefrontClient, \"graphql\">,\n  options: TOptions,\n  strategy: CachingStrategy,\n  shouldCacheResult?: ShouldCacheResult,\n): TOptions {\n  if (!CACHE_ENABLED_GRAPHQL_CLIENTS.has(client.graphql)) return options;\n\n  return { ...options, cache: strategy, [SHOULD_CACHE_RESULT]: shouldCacheResult };\n}\n\n/**\n * Creates a type-safe Storefront API client.\n *\n * Pick a `type` based on where your code runs and whether buyer context is available:\n *\n * |                 | public                         | private                       | private_no_buyer_context |\n * |-----------------|--------------------------------|-------------------------------|--------------------------|\n * | Runs in         | Browser or mobile              | Server (SSR)                  | Server (background)      |\n * | Token           | Public access token, or none   | Private access token          | Private access token     |\n * | Buyer context   | Browser request context        | You forward trusted `buyerIp` | None                     |\n * | Best for        | Client-side fetches            | SSR with buyer context        | Webhooks, background jobs |\n *\n * Pass `requestContext` so the client's SFAPI requests carry request-scoped\n * headers, follow the incoming request's abort signal, and read the resolved\n * `i18n` used for Storefront API variable injection and localized routes.\n *\n * Token-based access is required for some Storefront API fields, including\n * product tags, metaobjects, metafields, menus, and customers. Use a private\n * client only in trusted server code where the token cannot leak to browsers.\n *\n * @see {@link https://shopify.dev/docs/api/storefront#authentication | Storefront API authentication}\n */\nexport function createStorefrontClient<\n  const Type extends ClientType,\n  const RequestContext extends ShopifyRequestContext,\n  const CacheConfig extends CacheInstance | undefined = undefined,\n>(\n  args: CreateStorefrontClientArgs<RequestContext, Type, CacheConfig>,\n): StorefrontClient<\n  // Tuple-wrapped to stay non-distributive so an explicit\n  // `CacheInstance | undefined` type argument yields one client type, not a\n  // union. Note a *value* of that type still unlocks cache options: optional\n  // property inference strips `undefined` before it reaches CacheConfig, so\n  // definiteness is undecidable here — the runtime guard rejects cache\n  // options when no cache instance was actually configured.\n  [CacheConfig] extends [CacheInstance] ? { cache?: CachingStrategy } : {},\n  Type,\n  RequestContext\n>;\nexport function createStorefrontClient(args: CreateStorefrontClientArgs): StorefrontClient {\n  const { config, requestContext, type: clientType } = args;\n\n  if (!config.storeDomain) {\n    throw new Error(\"storeDomain is required and must be non-empty\");\n  }\n\n  const storeUrl = normalizeStoreDomain(config.storeDomain);\n  const apiVersion = config.apiVersion ?? STOREFRONT_API_VERSION;\n  const apiUrl = `${storeUrl}/api/${apiVersion}/graphql.json`;\n\n  const originFetch = config.fetch ?? globalThis.fetch;\n  if (typeof originFetch !== \"function\") {\n    throw new Error(\n      \"No fetch function available. Pass a fetch option or ensure globalThis.fetch exists.\",\n    );\n  }\n  const resolvedFetch = config.cache\n    ? createFetchWithCache({\n        cache: config.cache,\n        waitUntil: config.waitUntil,\n        fetch: originFetch as typeof globalThis.fetch,\n      })\n    : originFetch;\n\n  const timeoutInMs = config.defaultTimeoutInMs ?? DEFAULT_TIMEOUT_IN_MS;\n  if (timeoutInMs < 0 || Number.isNaN(timeoutInMs)) {\n    throw new Error(\"defaultTimeoutInMs must be a non-negative number\");\n  }\n\n  const staticHeaders: Record<string, string> = {\n    \"content-type\": \"application/json\",\n  };\n  if (config.storefrontId) {\n    staticHeaders[STOREFRONT_ID_HEADER] = config.storefrontId;\n  }\n\n  switch (clientType) {\n    case \"private\":\n    case \"private_no_buyer_context\":\n      if (typeof document !== \"undefined\") {\n        throw new Error(\n          \"private storefront tokens cannot be used in a browser context. Use a publicStorefrontToken instead.\",\n        );\n      }\n      if (!config.privateStorefrontToken) {\n        throw new Error(\"privateStorefrontToken is required\");\n      }\n      staticHeaders[STOREFRONT_PRIVATE_TOKEN_HEADER] = config.privateStorefrontToken;\n      break;\n    case \"public\":\n      if (config.publicStorefrontToken !== undefined && !config.publicStorefrontToken) {\n        throw new Error(\"publicStorefrontToken must be non-empty when provided\");\n      }\n      if (config.publicStorefrontToken) {\n        staticHeaders[STOREFRONT_ACCESS_TOKEN_HEADER] = config.publicStorefrontToken;\n      }\n      break;\n    default:\n      clientType satisfies never;\n      throw new Error(`Unsupported client type: ${clientType}`);\n  }\n\n  const i18n = requestContext.i18n;\n  const requestHeaders = new Headers(staticHeaders);\n  requestContext.applyStorefrontRequestHeaders(requestHeaders);\n\n  if (clientType === \"private\") {\n    const { buyerIp } = requestContext;\n    if (!buyerIp) {\n      throw new TypeError(\"requestContext.buyerIp is required for private Storefront API clients\");\n    }\n    requestHeaders.set(STOREFRONT_BUYER_IP_HEADER, buyerIp);\n  }\n\n  async function graphql(\n    doc: DocLike | string,\n    ...rest: [options?: Record<string, unknown>]\n  ): Promise<StorefrontGraphqlResult<DocLike>> {\n    const opts = (rest[0] ?? {}) as {\n      variables?: Record<string, unknown>;\n      signal?: AbortSignal;\n      cache?: CachingStrategy;\n      [SHOULD_CACHE_RESULT]?: ShouldCacheResult;\n    };\n\n    const queryText = typeof doc === \"string\" ? doc : (doc as unknown as string);\n    if (typeof queryText !== \"string\") {\n      throw new StorefrontApiError(\n        \"Expected gql() to return a string at runtime. Check gql.tada version compatibility.\",\n      );\n    }\n\n    if (opts.cache && !config.cache) {\n      throw new StorefrontCacheConfigError(\n        \"Storefront API cache options require a cache configured in createStorefrontClient().\",\n      );\n    }\n\n    if (opts.cache?.mode === \"private\") {\n      throw new StorefrontCacheConfigError(\n        \"Storefront API cache mode 'private' is not supported yet. Use Cache() without private mode, or cache buyer-specific work with createRunWithCache() and an explicit private key.\",\n      );\n    }\n\n    const variables = buildVariables(queryText, opts.variables, i18n);\n    const externalSignals = [requestContext.signal, opts.signal].filter(\n      (signal): signal is AbortSignal => Boolean(signal),\n    );\n\n    const earlyAbortSignal = externalSignals.find((signal) => signal.aborted);\n    if (earlyAbortSignal) {\n      throw (\n        earlyAbortSignal.reason ??\n        new DOMException(\"signal is aborted without reason\", \"AbortError\")\n      );\n    }\n\n    let requestId: string | undefined;\n    let responseHeaders: Headers;\n    let responseText: string;\n    let status: number;\n    let timeoutSignal: AbortSignal | undefined;\n\n    if (timeoutInMs > 0) {\n      timeoutSignal = AbortSignal.timeout(timeoutInMs);\n      externalSignals.push(timeoutSignal);\n    }\n\n    try {\n      const init: PlainRequestInit = {\n        method: \"POST\",\n        headers: new Headers(requestHeaders),\n        body: JSON.stringify({ query: queryText, variables }),\n        signal: externalSignals.length > 0 ? AbortSignal.any(externalSignals) : undefined,\n      };\n\n      const cacheOptions = createStorefrontCacheOptions(\n        apiUrl,\n        init,\n        queryText,\n        opts.cache,\n        opts[SHOULD_CACHE_RESULT],\n      );\n      const response = await (resolvedFetch as ResolvedStorefrontFetch)(apiUrl, init, cacheOptions);\n\n      responseHeaders = response.headers;\n      const hydrogenCacheStatus = getHydrogenCacheStatus(responseHeaders);\n      if (hydrogenCacheStatus !== \"hit\") {\n        requestContext.captureSubrequestHeaders(responseHeaders);\n      }\n\n      requestId = responseHeaders.get(\"x-request-id\") ?? undefined;\n      status = response.status;\n\n      if (!response.ok) {\n        const bodyHint = await response.text().catch(() => \"\");\n        throw new StorefrontApiError(\n          `SFAPI responded with ${status}${bodyHint ? `: ${bodyHint.slice(0, 200)}` : \"\"}`,\n          { status, requestId, queryText, variables },\n        );\n      }\n\n      responseText = await response.text();\n    } catch (error) {\n      if (error instanceof StorefrontApiError) throw error;\n      if (error instanceof StorefrontTimeoutError) throw error;\n      if (error instanceof StorefrontCacheConfigError) throw error;\n      if (\n        error instanceof DOMException &&\n        error.name === \"TimeoutError\" &&\n        timeoutSignal?.aborted\n      ) {\n        throw new StorefrontTimeoutError(timeoutInMs);\n      }\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw error;\n      }\n      throw new StorefrontApiError(\"SFAPI request failed\", { cause: error });\n    }\n\n    let json: unknown;\n    try {\n      json = JSON.parse(responseText);\n    } catch (cause) {\n      throw new StorefrontApiError(\n        `Failed to parse SFAPI response as JSON (${apiUrl}, status ${status})` +\n          (responseText ? `: ${responseText.slice(0, 200)}` : \"\"),\n        { status, requestId, cause, queryText, variables },\n      );\n    }\n\n    if (typeof json !== \"object\" || json === null || Array.isArray(json)) {\n      throw new StorefrontApiError(\n        `SFAPI returned unexpected JSON type: ${Array.isArray(json) ? \"array\" : typeof json}`,\n        { status, requestId, queryText, variables },\n      );\n    }\n\n    const body = json as { data?: unknown; errors?: GraphQLFormattedError[] };\n    // Branch to populate the two arms of the StorefrontGraphqlResult union: callers\n    // narrowing on `errors` get a non-null `data` only when no errors are present.\n    if (body.errors) {\n      return {\n        data: body.data ?? null,\n        errors: body.errors,\n        headers: responseHeaders,\n      };\n    }\n    return {\n      data: body.data,\n      headers: responseHeaders,\n    };\n  }\n\n  const client: StorefrontClient = {\n    type: clientType,\n    i18n,\n    graphql: graphql as StorefrontClient[\"graphql\"],\n    apiUrl,\n    storeUrl,\n    storefrontId: config.storefrontId,\n    requestContext,\n  };\n\n  if (config.cache) CACHE_ENABLED_GRAPHQL_CLIENTS.add(client.graphql);\n\n  return client;\n}\n\nfunction buildVariables(\n  queryText: string,\n  userVariables: Record<string, unknown> | undefined,\n  resolvedI18n: I18nConfig,\n): Record<string, unknown> {\n  const variables: Record<string, unknown> = { ...userVariables };\n\n  if (COUNTRY_VAR_RE.test(queryText)) {\n    variables.country = resolvedI18n.country;\n  }\n  if (LANGUAGE_VAR_RE.test(queryText)) {\n    variables.language = resolvedI18n.language;\n  }\n\n  return variables;\n}\n\ntype PlainRequestInit = RequestInit & { headers: Headers; body: string; method: string };\n\nfunction createStorefrontCacheOptions(\n  apiUrl: string,\n  init: PlainRequestInit,\n  queryText: string,\n  strategy: CachingStrategy | undefined,\n  shouldCacheResult: ShouldCacheResult | undefined,\n): FetchCacheOptions | undefined {\n  if (!strategy) return undefined;\n\n  // Runtime only needs a safety belt for untyped callers. False positives are\n  // acceptable because they bypass cache rather than risking mutation caching.\n  if (/\\bmutation\\b/.test(queryText)) return undefined;\n\n  return {\n    key: createStorefrontCacheKey(apiUrl, init),\n    strategy,\n    shouldCacheResponse: async ({ json }: FetchCacheResponseContext) => {\n      if (!json) return false;\n\n      const body = await json().catch(() => undefined);\n      if (typeof body !== \"object\" || body == null || Array.isArray(body) || \"errors\" in body) {\n        return false;\n      }\n\n      return shouldCacheResult?.(body) ?? true;\n    },\n  };\n}\n\nfunction createStorefrontCacheKey(apiUrl: string, init: PlainRequestInit) {\n  return [\n    \"storefront-api\",\n    apiUrl,\n    init.method,\n    init.body,\n    [...init.headers]\n      .filter(([name]) => {\n        const normalized = name.toLowerCase();\n        return (\n          REQUEST_CACHE_KEY_HEADERS.has(normalized) && !REQUEST_IDENTITY_HEADERS.has(normalized)\n        );\n      })\n      .toSorted(([left], [right]) => left.localeCompare(right))\n      .map(([name, value]) => `${name}:${value}`)\n      .join(\"\\n\"),\n  ] as const;\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import type { TadaDocumentNode } from \"gql.tada\";\n\nimport { getHydrogenCacheStatus } from \"../core/cache/cache-status\";\nimport { createFetchWithCache } from \"../core/cache/fetch-with-cache\";\nimport type { FetchCacheOptions, FetchCacheResponseContext } from \"../core/cache/fetch-with-cache\";\nimport type { CacheInstance } from \"../core/cache/run-with-cache\";\nimport type { CachingStrategy } from \"../core/cache/strategies\";\nimport { DEFAULT_TIMEOUT_IN_MS, STOREFRONT_API_VERSION } from \"../core/constants\";\nimport {\n  HYDROGEN_VERSION_HEADER,\n  REQUEST_GROUP_ID_HEADER,\n  SDK_VARIANT_HEADER,\n  SDK_VARIANT_SOURCE_HEADER,\n  SDK_VERSION_HEADER,\n  SHOPIFY_STOREFRONT_S_HEADER,\n  SHOPIFY_STOREFRONT_Y_HEADER,\n  STOREFRONT_ACCESS_TOKEN_HEADER,\n  STOREFRONT_BUYER_IP_HEADER,\n  STOREFRONT_ID_HEADER,\n  STOREFRONT_PRIVATE_TOKEN_HEADER,\n  SHOPIFY_UNIQUE_TOKEN_HEADER,\n  SHOPIFY_VISIT_TOKEN_HEADER,\n} from \"../core/headers\";\nimport type { I18nConfig, ShopifyRequestContext } from \"../core/request-context\";\nimport { normalizeStoreDomain } from \"../core/url\";\nimport type { AnyStorefrontQueryString } from \"../graphql\";\nimport { StorefrontApiError, StorefrontTimeoutError } from \"./errors\";\nimport type {\n  ClientType,\n  CreateStorefrontClientArgs,\n  GraphQLFormattedError,\n  StorefrontClient,\n  StorefrontGraphqlResult,\n} from \"./types\";\n\ntype DocLike = TadaDocumentNode<unknown, unknown> | AnyStorefrontQueryString;\ntype FetchInput = Parameters<typeof globalThis.fetch>[0];\ntype FetchInit = Parameters<typeof globalThis.fetch>[1];\ntype ResolvedStorefrontFetch = (\n  input: FetchInput,\n  init: FetchInit,\n  cacheOptions: FetchCacheOptions | undefined,\n) => Promise<Response>;\n\nconst COUNTRY_VAR_RE = /\\$country\\s*:/;\nconst LANGUAGE_VAR_RE = /\\$language\\s*:/;\nconst REQUEST_CACHE_KEY_HEADERS = new Set([\n  \"content-type\",\n  \"user-agent\",\n  SDK_VARIANT_HEADER.toLowerCase(),\n  SDK_VARIANT_SOURCE_HEADER.toLowerCase(),\n  SDK_VERSION_HEADER.toLowerCase(),\n  HYDROGEN_VERSION_HEADER.toLowerCase(),\n  STOREFRONT_ACCESS_TOKEN_HEADER.toLowerCase(),\n  STOREFRONT_PRIVATE_TOKEN_HEADER.toLowerCase(),\n]);\nconst REQUEST_IDENTITY_HEADERS = new Set([\n  \"cookie\",\n  REQUEST_GROUP_ID_HEADER.toLowerCase(),\n  STOREFRONT_BUYER_IP_HEADER.toLowerCase(),\n  SHOPIFY_UNIQUE_TOKEN_HEADER.toLowerCase(),\n  SHOPIFY_VISIT_TOKEN_HEADER.toLowerCase(),\n  SHOPIFY_STOREFRONT_Y_HEADER.toLowerCase(),\n  SHOPIFY_STOREFRONT_S_HEADER.toLowerCase(),\n]);\nconst CACHE_ENABLED_GRAPHQL_CLIENTS = new WeakSet<StorefrontClient[\"graphql\"]>();\nconst SHOULD_CACHE_RESULT = Symbol();\n\ntype ShouldCacheResult = (body: object) => boolean;\n\nclass StorefrontCacheConfigError extends Error {}\n\nexport function withStorefrontClientCache<TOptions extends object>(\n  client: Pick<StorefrontClient, \"graphql\">,\n  options: TOptions,\n  strategy: CachingStrategy,\n  shouldCacheResult?: ShouldCacheResult,\n): TOptions {\n  if (!CACHE_ENABLED_GRAPHQL_CLIENTS.has(client.graphql)) return options;\n\n  return { ...options, cache: strategy, [SHOULD_CACHE_RESULT]: shouldCacheResult };\n}\n\n/**\n * Creates a Storefront API client that runs typed queries and mutations against your store.\n *\n * Set `type` based on where your code runs and whether customer context is available:\n *\n * |                  | `public`                   | `private`                   | `private_no_buyer_context` |\n * |------------------|------------------------------|-------------------------------|------------------------------|\n * | Runs in          | Browser or mobile            | Server-side rendering         | Background server code    |\n * | Token            | Public access token, or none | Private access token          | Private access token      |\n * | Customer context | Browser request context      | You forward trusted `buyerIp` | None                      |\n * | Best for         | Client-side fetches          | SSR with customer context     | Webhooks, background jobs |\n *\n * Pass a request context from `createShopifyRequestContext`. The client forwards the incoming\n * request's cookies and `Sec-GPC` header to the Storefront API, and fills `$country`\n * and `$language` variables from the context's locale. The client reads the request headers once,\n * when you create the client. Create a client for each incoming request, and create a client at\n * module scope only with a static request context.\n *\n * Keep private clients in server code, where the token can't reach browsers. The function throws an\n * error when you create either private client type in a browser. The function throws a `TypeError`\n * when the request context of a `private` client has no `buyerIp`.\n *\n * @see [Storefront API authentication](https://shopify.dev/docs/api/storefront#authentication)\n * @publicDocs\n */\nexport function createStorefrontClient<\n  const Type extends ClientType,\n  const RequestContext extends ShopifyRequestContext,\n  const CacheConfig extends CacheInstance | undefined = undefined,\n>(\n  args: CreateStorefrontClientArgs<RequestContext, Type, CacheConfig>,\n): StorefrontClient<\n  // Tuple-wrapped to stay non-distributive so an explicit\n  // `CacheInstance | undefined` type argument yields one client type, not a\n  // union. Note a *value* of that type still unlocks cache options: optional\n  // property inference strips `undefined` before it reaches CacheConfig, so\n  // definiteness is undecidable here — the runtime guard rejects cache\n  // options when no cache instance was actually configured.\n  [CacheConfig] extends [CacheInstance] ? { cache?: CachingStrategy } : {},\n  Type,\n  RequestContext\n>;\n/**\n * @param args The client type, request context, and store configuration for the new client.\n * @returns The client, with a `graphql()` method that runs queries and mutations.\n */\nexport function createStorefrontClient(args: CreateStorefrontClientArgs): StorefrontClient {\n  const { config, requestContext, type: clientType } = args;\n\n  if (!config.storeDomain) {\n    throw new Error(\"storeDomain is required and must be non-empty\");\n  }\n\n  const storeUrl = normalizeStoreDomain(config.storeDomain);\n  const apiVersion = config.apiVersion ?? STOREFRONT_API_VERSION;\n  const apiUrl = `${storeUrl}/api/${apiVersion}/graphql.json`;\n\n  const originFetch = config.fetch ?? globalThis.fetch;\n  if (typeof originFetch !== \"function\") {\n    throw new Error(\n      \"No fetch function available. Pass a fetch option or ensure globalThis.fetch exists.\",\n    );\n  }\n  const resolvedFetch = config.cache\n    ? createFetchWithCache({\n        cache: config.cache,\n        waitUntil: config.waitUntil,\n        fetch: originFetch as typeof globalThis.fetch,\n      })\n    : originFetch;\n\n  const timeoutInMs = config.defaultTimeoutInMs ?? DEFAULT_TIMEOUT_IN_MS;\n  if (timeoutInMs < 0 || Number.isNaN(timeoutInMs)) {\n    throw new Error(\"defaultTimeoutInMs must be a non-negative number\");\n  }\n\n  const staticHeaders: Record<string, string> = {\n    \"content-type\": \"application/json\",\n  };\n  if (config.storefrontId) {\n    staticHeaders[STOREFRONT_ID_HEADER] = config.storefrontId;\n  }\n\n  switch (clientType) {\n    case \"private\":\n    case \"private_no_buyer_context\":\n      if (typeof document !== \"undefined\") {\n        throw new Error(\n          \"private storefront tokens cannot be used in a browser context. Use a publicStorefrontToken instead.\",\n        );\n      }\n      if (!config.privateStorefrontToken) {\n        throw new Error(\"privateStorefrontToken is required\");\n      }\n      staticHeaders[STOREFRONT_PRIVATE_TOKEN_HEADER] = config.privateStorefrontToken;\n      break;\n    case \"public\":\n      if (config.publicStorefrontToken !== undefined && !config.publicStorefrontToken) {\n        throw new Error(\"publicStorefrontToken must be non-empty when provided\");\n      }\n      if (config.publicStorefrontToken) {\n        staticHeaders[STOREFRONT_ACCESS_TOKEN_HEADER] = config.publicStorefrontToken;\n      }\n      break;\n    default:\n      clientType satisfies never;\n      throw new Error(`Unsupported client type: ${clientType}`);\n  }\n\n  const i18n = requestContext.i18n;\n  const requestHeaders = new Headers(staticHeaders);\n  requestContext.applyStorefrontRequestHeaders(requestHeaders);\n\n  if (clientType === \"private\") {\n    const { buyerIp } = requestContext;\n    if (!buyerIp) {\n      throw new TypeError(\"requestContext.buyerIp is required for private Storefront API clients\");\n    }\n    requestHeaders.set(STOREFRONT_BUYER_IP_HEADER, buyerIp);\n  }\n\n  async function graphql(\n    doc: DocLike | string,\n    ...rest: [options?: Record<string, unknown>]\n  ): Promise<StorefrontGraphqlResult<DocLike>> {\n    const opts = (rest[0] ?? {}) as {\n      variables?: Record<string, unknown>;\n      signal?: AbortSignal;\n      cache?: CachingStrategy;\n      [SHOULD_CACHE_RESULT]?: ShouldCacheResult;\n    };\n\n    const queryText = typeof doc === \"string\" ? doc : (doc as unknown as string);\n    if (typeof queryText !== \"string\") {\n      throw new StorefrontApiError(\n        \"Expected gql() to return a string at runtime. Check gql.tada version compatibility.\",\n      );\n    }\n\n    if (opts.cache && !config.cache) {\n      throw new StorefrontCacheConfigError(\n        \"Storefront API cache options require a cache configured in createStorefrontClient().\",\n      );\n    }\n\n    if (opts.cache?.mode === \"private\") {\n      throw new StorefrontCacheConfigError(\n        \"Storefront API cache mode 'private' is not supported yet. Use Cache() without private mode, or cache buyer-specific work with createRunWithCache() and an explicit private key.\",\n      );\n    }\n\n    const variables = buildVariables(queryText, opts.variables, i18n);\n    const externalSignals = [requestContext.signal, opts.signal].filter(\n      (signal): signal is AbortSignal => Boolean(signal),\n    );\n\n    const earlyAbortSignal = externalSignals.find((signal) => signal.aborted);\n    if (earlyAbortSignal) {\n      throw (\n        earlyAbortSignal.reason ??\n        new DOMException(\"signal is aborted without reason\", \"AbortError\")\n      );\n    }\n\n    let requestId: string | undefined;\n    let responseHeaders: Headers;\n    let responseText: string;\n    let status: number;\n    let timeoutSignal: AbortSignal | undefined;\n\n    if (timeoutInMs > 0) {\n      timeoutSignal = AbortSignal.timeout(timeoutInMs);\n      externalSignals.push(timeoutSignal);\n    }\n\n    try {\n      const init: PlainRequestInit = {\n        method: \"POST\",\n        headers: new Headers(requestHeaders),\n        body: JSON.stringify({ query: queryText, variables }),\n        signal: externalSignals.length > 0 ? AbortSignal.any(externalSignals) : undefined,\n      };\n\n      const cacheOptions = createStorefrontCacheOptions(\n        apiUrl,\n        init,\n        queryText,\n        opts.cache,\n        opts[SHOULD_CACHE_RESULT],\n        timeoutInMs > 0 ? timeoutInMs : DEFAULT_TIMEOUT_IN_MS,\n      );\n      const response = await (resolvedFetch as ResolvedStorefrontFetch)(apiUrl, init, cacheOptions);\n\n      responseHeaders = response.headers;\n      const hydrogenCacheStatus = getHydrogenCacheStatus(responseHeaders);\n      if (hydrogenCacheStatus !== \"hit\") {\n        requestContext.captureSubrequestHeaders(responseHeaders);\n      }\n\n      requestId = responseHeaders.get(\"x-request-id\") ?? undefined;\n      status = response.status;\n\n      if (!response.ok) {\n        const bodyHint = await response.text().catch(() => \"\");\n        throw new StorefrontApiError(\n          `SFAPI responded with ${status}${bodyHint ? `: ${bodyHint.slice(0, 200)}` : \"\"}`,\n          { status, requestId, queryText, variables },\n        );\n      }\n\n      responseText = await response.text();\n    } catch (error) {\n      if (error instanceof StorefrontApiError) throw error;\n      if (error instanceof StorefrontTimeoutError) throw error;\n      if (error instanceof StorefrontCacheConfigError) throw error;\n      if (\n        error instanceof DOMException &&\n        error.name === \"TimeoutError\" &&\n        timeoutSignal?.aborted\n      ) {\n        throw new StorefrontTimeoutError(timeoutInMs);\n      }\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw error;\n      }\n      throw new StorefrontApiError(\"SFAPI request failed\", { cause: error });\n    }\n\n    let json: unknown;\n    try {\n      json = JSON.parse(responseText);\n    } catch (cause) {\n      throw new StorefrontApiError(\n        `Failed to parse SFAPI response as JSON (${apiUrl}, status ${status})` +\n          (responseText ? `: ${responseText.slice(0, 200)}` : \"\"),\n        { status, requestId, cause, queryText, variables },\n      );\n    }\n\n    if (typeof json !== \"object\" || json === null || Array.isArray(json)) {\n      throw new StorefrontApiError(\n        `SFAPI returned unexpected JSON type: ${Array.isArray(json) ? \"array\" : typeof json}`,\n        { status, requestId, queryText, variables },\n      );\n    }\n\n    const body = json as { data?: unknown; errors?: GraphQLFormattedError[] };\n    // Branch to populate the two arms of the StorefrontGraphqlResult union: callers\n    // narrowing on `errors` get a non-null `data` only when no errors are present.\n    if (body.errors) {\n      return {\n        data: body.data ?? null,\n        errors: body.errors,\n        headers: responseHeaders,\n      };\n    }\n    return {\n      data: body.data,\n      headers: responseHeaders,\n    };\n  }\n\n  const client: StorefrontClient = {\n    type: clientType,\n    i18n,\n    graphql: graphql as StorefrontClient[\"graphql\"],\n    apiUrl,\n    storeUrl,\n    storefrontId: config.storefrontId,\n    requestContext,\n  };\n\n  if (config.cache) CACHE_ENABLED_GRAPHQL_CLIENTS.add(client.graphql);\n\n  return client;\n}\n\nfunction buildVariables(\n  queryText: string,\n  userVariables: Record<string, unknown> | undefined,\n  resolvedI18n: I18nConfig,\n): Record<string, unknown> {\n  const variables: Record<string, unknown> = { ...userVariables };\n\n  if (COUNTRY_VAR_RE.test(queryText)) {\n    variables.country = resolvedI18n.country;\n  }\n  if (LANGUAGE_VAR_RE.test(queryText)) {\n    variables.language = resolvedI18n.language;\n  }\n\n  return variables;\n}\n\ntype PlainRequestInit = RequestInit & { headers: Headers; body: string; method: string };\n\nfunction createStorefrontCacheOptions(\n  apiUrl: string,\n  init: PlainRequestInit,\n  queryText: string,\n  strategy: CachingStrategy | undefined,\n  shouldCacheResult: ShouldCacheResult | undefined,\n  backgroundTimeoutInMs: number,\n): FetchCacheOptions | undefined {\n  if (!strategy) return undefined;\n\n  // Runtime only needs a safety belt for untyped callers. False positives are\n  // acceptable because they bypass cache rather than risking mutation caching.\n  if (/\\bmutation\\b/.test(queryText)) return undefined;\n\n  return {\n    key: createStorefrontCacheKey(apiUrl, init),\n    strategy,\n    shouldCacheResponse: async ({ json }: FetchCacheResponseContext) => {\n      if (!json) return false;\n\n      const body = await json().catch(() => undefined);\n      if (typeof body !== \"object\" || body == null || Array.isArray(body) || \"errors\" in body) {\n        return false;\n      }\n\n      return shouldCacheResult?.(body) ?? true;\n    },\n    // A refresh outlives the request that triggered it, so request and caller\n    // aborts must not cancel it. It still needs a deadline, even when the caller\n    // disabled the client timeout to own the foreground one.\n    backgroundSignal: () => AbortSignal.timeout(backgroundTimeoutInMs),\n  };\n}\n\nfunction createStorefrontCacheKey(apiUrl: string, init: PlainRequestInit) {\n  return [\n    \"storefront-api\",\n    apiUrl,\n    init.method,\n    init.body,\n    [...init.headers]\n      .filter(([name]) => {\n        const normalized = name.toLowerCase();\n        return (\n          REQUEST_CACHE_KEY_HEADERS.has(normalized) && !REQUEST_IDENTITY_HEADERS.has(normalized)\n        );\n      })\n      .toSorted(([left], [right]) => left.localeCompare(right))\n      .map(([name, value]) => `${name}:${value}`)\n      .join(\"\\n\"),\n  ] as const;\n}\n"],"mappings":";;;;;;;;AA4CA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB;AACxB,MAAM,4BAA4B,IAAI,IAAI;CACxC;CACA;CACA,mBAAmB,aAAa;CAChC,0BAA0B,aAAa;CACvC,mBAAmB,aAAa;CAChC,wBAAwB,aAAa;CACrC,+BAA+B,aAAa;CAC5C,gCAAgC,aAAa;CAC9C,CAAC;AACF,MAAM,2BAA2B,IAAI,IAAI;CACvC;CACA,wBAAwB,aAAa;CACrC,2BAA2B,aAAa;CACxC,4BAA4B,aAAa;CACzC,2BAA2B,aAAa;CACxC,4BAA4B,aAAa;CACzC,4BAA4B,aAAa;CAC1C,CAAC;AACF,MAAM,gDAAgC,IAAI,SAAsC;AAChF,MAAM,sBAAsB,QAAQ;AAIpC,IAAM,6BAAN,cAAyC,MAAM;AAE/C,SAAgB,0BACd,QACA,SACA,UACA,mBACU;AACV,KAAI,CAAC,8BAA8B,IAAI,OAAO,QAAQ,CAAE,QAAO;AAE/D,QAAO;EAAE,GAAG;EAAS,OAAO;GAAW,sBAAsB;EAAmB;;;;;;AAiDlF,SAAgB,uBAAuB,MAAoD;CACzF,MAAM,EAAE,QAAQ,gBAAgB,MAAM,eAAe;AAErD,KAAI,CAAC,OAAO,YACV,OAAM,IAAI,MAAM,gDAAgD;CAGlE,MAAM,WAAW,qBAAqB,OAAO,YAAY;CAEzD,MAAM,SAAS,GAAG,SAAS,OADR,OAAO,wBACmB;CAE7C,MAAM,cAAc,OAAO,SAAS,WAAW;AAC/C,KAAI,OAAO,gBAAgB,WACzB,OAAM,IAAI,MACR,sFACD;CAEH,MAAM,gBAAgB,OAAO,QACzB,qBAAqB;EACnB,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,OAAO;EACR,CAAC,GACF;CAEJ,MAAM,cAAc,OAAO;AAC3B,KAAI,cAAc,KAAK,OAAO,MAAM,YAAY,CAC9C,OAAM,IAAI,MAAM,mDAAmD;CAGrE,MAAM,gBAAwC,EAC5C,gBAAgB,oBACjB;AACD,KAAI,OAAO,aACT,eAAc,wBAAwB,OAAO;AAG/C,SAAQ,YAAR;EACE,KAAK;EACL,KAAK;AACH,OAAI,OAAO,aAAa,YACtB,OAAM,IAAI,MACR,sGACD;AAEH,OAAI,CAAC,OAAO,uBACV,OAAM,IAAI,MAAM,qCAAqC;AAEvD,iBAAc,mCAAmC,OAAO;AACxD;EACF,KAAK;AACH,OAAI,OAAO,0BAA0B,UAAa,CAAC,OAAO,sBACxD,OAAM,IAAI,MAAM,wDAAwD;AAE1E,OAAI,OAAO,sBACT,eAAc,kCAAkC,OAAO;AAEzD;EACF,QAEE,OAAM,IAAI,MAAM,4BAA4B,aAAa;;CAG7D,MAAM,OAAO,eAAe;CAC5B,MAAM,iBAAiB,IAAI,QAAQ,cAAc;AACjD,gBAAe,8BAA8B,eAAe;AAE5D,KAAI,eAAe,WAAW;EAC5B,MAAM,EAAE,YAAY;AACpB,MAAI,CAAC,QACH,OAAM,IAAI,UAAU,wEAAwE;AAE9F,iBAAe,IAAI,4BAA4B,QAAQ;;CAGzD,eAAe,QACb,KACA,GAAG,MACwC;EAC3C,MAAM,OAAQ,KAAK,MAAM,EAAE;EAO3B,MAAM,YAAY,OAAO,QAAQ,WAAW,MAAO;AACnD,MAAI,OAAO,cAAc,SACvB,OAAM,IAAI,mBACR,sFACD;AAGH,MAAI,KAAK,SAAS,CAAC,OAAO,MACxB,OAAM,IAAI,2BACR,uFACD;AAGH,MAAI,KAAK,OAAO,SAAS,UACvB,OAAM,IAAI,2BACR,kLACD;EAGH,MAAM,YAAY,eAAe,WAAW,KAAK,WAAW,KAAK;EACjE,MAAM,kBAAkB,CAAC,eAAe,QAAQ,KAAK,OAAO,CAAC,QAC1D,WAAkC,QAAQ,OAAO,CACnD;EAED,MAAM,mBAAmB,gBAAgB,MAAM,WAAW,OAAO,QAAQ;AACzE,MAAI,iBACF,OACE,iBAAiB,UACjB,IAAI,aAAa,oCAAoC,aAAa;EAItE,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;AAEJ,MAAI,cAAc,GAAG;AACnB,mBAAgB,YAAY,QAAQ,YAAY;AAChD,mBAAgB,KAAK,cAAc;;AAGrC,MAAI;GACF,MAAM,OAAyB;IAC7B,QAAQ;IACR,SAAS,IAAI,QAAQ,eAAe;IACpC,MAAM,KAAK,UAAU;KAAE,OAAO;KAAW;KAAW,CAAC;IACrD,QAAQ,gBAAgB,SAAS,IAAI,YAAY,IAAI,gBAAgB,GAAG;IACzE;GAUD,MAAM,WAAW,MAAO,cAA0C,QAAQ,MARrD,6BACnB,QACA,MACA,WACA,KAAK,OACL,KAAK,sBACL,cAAc,IAAI,cAAc,sBAE0D,CAAC;AAE7F,qBAAkB,SAAS;AAE3B,OAD4B,uBAAuB,gBAC5B,KAAK,MAC1B,gBAAe,yBAAyB,gBAAgB;AAG1D,eAAY,gBAAgB,IAAI,eAAe,IAAI;AACnD,YAAS,SAAS;AAElB,OAAI,CAAC,SAAS,IAAI;IAChB,MAAM,WAAW,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AACtD,UAAM,IAAI,mBACR,wBAAwB,SAAS,WAAW,KAAK,SAAS,MAAM,GAAG,IAAI,KAAK,MAC5E;KAAE;KAAQ;KAAW;KAAW;KAAW,CAC5C;;AAGH,kBAAe,MAAM,SAAS,MAAM;WAC7B,OAAO;AACd,OAAI,iBAAiB,mBAAoB,OAAM;AAC/C,OAAI,iBAAiB,uBAAwB,OAAM;AACnD,OAAI,iBAAiB,2BAA4B,OAAM;AACvD,OACE,iBAAiB,gBACjB,MAAM,SAAS,kBACf,eAAe,QAEf,OAAM,IAAI,uBAAuB,YAAY;AAE/C,OAAI,iBAAiB,gBAAgB,MAAM,SAAS,aAClD,OAAM;AAER,SAAM,IAAI,mBAAmB,wBAAwB,EAAE,OAAO,OAAO,CAAC;;EAGxE,IAAI;AACJ,MAAI;AACF,UAAO,KAAK,MAAM,aAAa;WACxB,OAAO;AACd,SAAM,IAAI,mBACR,2CAA2C,OAAO,WAAW,OAAO,MACjE,eAAe,KAAK,aAAa,MAAM,GAAG,IAAI,KAAK,KACtD;IAAE;IAAQ;IAAW;IAAO;IAAW;IAAW,CACnD;;AAGH,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,KAAK,CAClE,OAAM,IAAI,mBACR,wCAAwC,MAAM,QAAQ,KAAK,GAAG,UAAU,OAAO,QAC/E;GAAE;GAAQ;GAAW;GAAW;GAAW,CAC5C;EAGH,MAAM,OAAO;AAGb,MAAI,KAAK,OACP,QAAO;GACL,MAAM,KAAK,QAAQ;GACnB,QAAQ,KAAK;GACb,SAAS;GACV;AAEH,SAAO;GACL,MAAM,KAAK;GACX,SAAS;GACV;;CAGH,MAAM,SAA2B;EAC/B,MAAM;EACN;EACS;EACT;EACA;EACA,cAAc,OAAO;EACrB;EACD;AAED,KAAI,OAAO,MAAO,+BAA8B,IAAI,OAAO,QAAQ;AAEnE,QAAO;;AAGT,SAAS,eACP,WACA,eACA,cACyB;CACzB,MAAM,YAAqC,EAAE,GAAG,eAAe;AAE/D,KAAI,eAAe,KAAK,UAAU,CAChC,WAAU,UAAU,aAAa;AAEnC,KAAI,gBAAgB,KAAK,UAAU,CACjC,WAAU,WAAW,aAAa;AAGpC,QAAO;;AAKT,SAAS,6BACP,QACA,MACA,WACA,UACA,mBACA,uBAC+B;AAC/B,KAAI,CAAC,SAAU,QAAO;AAItB,KAAI,eAAe,KAAK,UAAU,CAAE,QAAO;AAE3C,QAAO;EACL,KAAK,yBAAyB,QAAQ,KAAK;EAC3C;EACA,qBAAqB,OAAO,EAAE,WAAsC;AAClE,OAAI,CAAC,KAAM,QAAO;GAElB,MAAM,OAAO,MAAM,MAAM,CAAC,YAAY,OAAU;AAChD,OAAI,OAAO,SAAS,YAAY,QAAQ,QAAQ,MAAM,QAAQ,KAAK,IAAI,YAAY,KACjF,QAAO;AAGT,UAAO,oBAAoB,KAAK,IAAI;;EAKtC,wBAAwB,YAAY,QAAQ,sBAAsB;EACnE;;AAGH,SAAS,yBAAyB,QAAgB,MAAwB;AACxE,QAAO;EACL;EACA;EACA,KAAK;EACL,KAAK;EACL,CAAC,GAAG,KAAK,QAAQ,CACd,QAAQ,CAAC,UAAU;GAClB,MAAM,aAAa,KAAK,aAAa;AACrC,UACE,0BAA0B,IAAI,WAAW,IAAI,CAAC,yBAAyB,IAAI,WAAW;IAExF,CACD,UAAU,CAAC,OAAO,CAAC,WAAW,KAAK,cAAc,MAAM,CAAC,CACxD,KAAK,CAAC,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,CAC1C,KAAK,KAAK;EACd"}

package/dist/client/errors.d.mts

@@ -5,42 +5,64 @@ interface StorefrontApiErrorOptions {
   cause?: unknown;
   queryText?: string;
   variables?: Record<string, unknown>;
-  locations?: ReadonlyArray<{
-    line: number;
-    column: number;
-  }>;
-  path?: ReadonlyArray<string | number>;
-  extensions?: Record<string, unknown>;
 }
+/**
+ * Signals that a Storefront API request failed. The client throws the error for an HTTP error
+ * status, a network failure, or a response body that isn't a JSON object.
+ *
+ * GraphQL errors, including `THROTTLED`, don't throw. Read GraphQL errors from the result's
+ * `errors` field.
+ *
+ * When the request context's signal or the call's `signal` aborts before the call, the client
+ * throws the abort reason and sends no request. An `AbortError` during the request reaches your
+ * code unchanged. Other abort reasons during the request throw a `StorefrontApiError`.
+ *
+ * @publicDocs
+ */
 declare class StorefrontApiError extends Error {
+  /** The `x-request-id` header of the Storefront API response, when the response has one. Include the ID in support requests. */
   readonly requestId?: string;
+  /** The HTTP status code of the response, when the request reached the server. */
   readonly status?: number;
+  /** The GraphQL query that failed. Hydrogen sets the value only in development builds. */
   readonly queryText?: string;
+  /** The variables that the client sent with the request. Hydrogen sets the value only in development builds. */
   readonly variables?: Record<string, unknown>;
-  readonly locations?: ReadonlyArray<{
-    line: number;
-    column: number;
-  }>;
-  readonly path?: ReadonlyArray<string | number>;
-  readonly extensions?: Record<string, unknown>;
+  /** `StorefrontApiError`. `StorefrontTimeoutError` sets its own class name. */
+  name: string;
+  /** Describes the failure, such as the HTTP status that the API returned. */
+  message: string;
+  /** The stack trace, when the JavaScript runtime records one. */
+  stack?: string;
   constructor(message: string, options?: StorefrontApiErrorOptions);
+  /** Makes `Object.prototype.toString` report the error name, such as `[object StorefrontApiError]`. */
   get [Symbol.toStringTag](): string;
-  toString(): string;
+  /** Returns the error name, message, request ID, and status for logging. The output leaves out the query text, variables, cause, and stack. */
   toJSON(): {
     name: string;
     message: string;
     requestId?: string;
     status?: number;
-    locations?: ReadonlyArray<{
-      line: number;
-      column: number;
-    }>;
-    path?: ReadonlyArray<string | number>;
-    extensions?: Record<string, unknown>;
   };
 }
+/**
+ * Signals that a Storefront API request ran longer than the client's `defaultTimeoutInMs` setting.
+ * Aborts from the request context or the call's `signal` throw other errors.
+ *
+ * `StorefrontTimeoutError` extends `StorefrontApiError`. Check for `StorefrontTimeoutError` first when
+ * you handle both errors.
+ *
+ * @publicDocs
+ */
 declare class StorefrontTimeoutError extends StorefrontApiError {
+  /** The timeout that the request exceeded, in milliseconds. */
   readonly timeoutInMs: number;
+  /** Always `StorefrontTimeoutError`. */
+  name: string;
+  /** States the timeout, such as `"Storefront API request timed out after 30000ms"`. */
+  message: string;
+  /** The stack trace, when the JavaScript runtime records one. */
+  stack?: string;
   constructor(timeoutInMs: number, options?: Omit<StorefrontApiErrorOptions, "cause">);
 }
 //#endregion

package/dist/client/errors.mjs

@@ -1,34 +1,37 @@
 //#region src/client/errors.ts
+/**
+* Signals that a Storefront API request failed. The client throws the error for an HTTP error
+* status, a network failure, or a response body that isn't a JSON object.
+*
+* GraphQL errors, including `THROTTLED`, don't throw. Read GraphQL errors from the result's
+* `errors` field.
+*
+* When the request context's signal or the call's `signal` aborts before the call, the client
+* throws the abort reason and sends no request. An `AbortError` during the request reaches your
+* code unchanged. Other abort reasons during the request throw a `StorefrontApiError`.
+*
+* @publicDocs
+*/
 var StorefrontApiError = class extends Error {
+	/** The `x-request-id` header of the Storefront API response, when the response has one. Include the ID in support requests. */
 	requestId;
+	/** The HTTP status code of the response, when the request reached the server. */
 	status;
+	/** The GraphQL query that failed. Hydrogen sets the value only in development builds. */
 	queryText;
+	/** The variables that the client sent with the request. Hydrogen sets the value only in development builds. */
 	variables;
-	locations;
-	path;
-	extensions;
 	constructor(message, options) {
 		super(message, options?.cause ? { cause: options.cause } : void 0);
 		this.name = "StorefrontApiError";
 		this.requestId = options?.requestId;
 		this.status = options?.status;
-		this.locations = options?.locations;
-		this.path = options?.path;
-		this.extensions = options?.extensions;
 	}
+	/** Makes `Object.prototype.toString` report the error name, such as `[object StorefrontApiError]`. */
 	get [Symbol.toStringTag]() {
 		return this.name;
 	}
-	toString() {
-		let result = `${this.name}: ${this.message}`;
-		if (this.path) try {
-			result += ` | path: ${JSON.stringify(this.path)}`;
-		} catch {}
-		if (this.extensions) try {
-			result += ` | extensions: ${JSON.stringify(this.extensions)}`;
-		} catch {}
-		return result;
-	}
+	/** Returns the error name, message, request ID, and status for logging. The output leaves out the query text, variables, cause, and stack. */
 	toJSON() {
 		return {
 			name: this.name,
@@ -38,7 +41,17 @@ var StorefrontApiError = class extends Error {
 		};
 	}
 };
+/**
+* Signals that a Storefront API request ran longer than the client's `defaultTimeoutInMs` setting.
+* Aborts from the request context or the call's `signal` throw other errors.
+*
+* `StorefrontTimeoutError` extends `StorefrontApiError`. Check for `StorefrontTimeoutError` first when
+* you handle both errors.
+*
+* @publicDocs
+*/
 var StorefrontTimeoutError = class extends StorefrontApiError {
+	/** The timeout that the request exceeded, in milliseconds. */
 	timeoutInMs;
 	constructor(timeoutInMs, options) {
 		super(`Storefront API request timed out after ${timeoutInMs}ms`, options);