@shopify/hydrogen 2026.10.0-preview.1 → 2026.10.0-preview.2

package/dist/cli/index.mjs

@@ -2,11 +2,317 @@
 import { createRequire } from "node:module";
 import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, 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, resolve } from "node:path";
 import { spawn } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { dirname, join, parse, resolve } from "node:path";
+import { createHash, randomUUID } from "node:crypto";
 import { parseArgs } from "node:util";
 
+//#region src/core/logging/types.ts
+const DEFAULT_LOG_LEVEL = "info";
+const LOG_LEVEL_VALUES = {
+	trace: 10,
+	debug: 20,
+	info: 30,
+	warn: 40,
+	error: 50,
+	fatal: 60,
+	silent: Number.POSITIVE_INFINITY
+};
+function isLevelEnabled(level, threshold) {
+	return LOG_LEVEL_VALUES[level] >= LOG_LEVEL_VALUES[threshold];
+}
+
+//#endregion
+//#region src/core/logging/logging.ts
+const CONSOLE_METHODS = {
+	trace: "debug",
+	debug: "debug",
+	info: "info",
+	warn: "warn",
+	error: "error",
+	fatal: "error"
+};
+function formatLogPrefix(level, scope) {
+	return `[hydrogen:${level}:${scope}]`;
+}
+function writeToConsole(level, message, context) {
+	const { scope, error, ...rest } = context ?? {};
+	const args = [scope ? `${formatLogPrefix(level, scope)} ${message}` : message];
+	if (error !== void 0) args.push(error);
+	if (Object.keys(rest).length > 0) args.push(rest);
+	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`.
+*/
+const consoleLogger = {
+	trace: (message, context) => writeToConsole("trace", message, context),
+	debug: (message, context) => writeToConsole("debug", message, context),
+	info: (message, context) => writeToConsole("info", message, context),
+	warn: (message, context) => writeToConsole("warn", message, context),
+	error: (message, context) => writeToConsole("error", message, context),
+	fatal: (message, context) => writeToConsole("fatal", message, context)
+};
+const state = {
+	logger: consoleLogger,
+	level: DEFAULT_LOG_LEVEL
+};
+function emit(scope, level, message, context) {
+	if (!isLevelEnabled(level, state.level)) return;
+	try {
+		state.logger[level](message, {
+			...context,
+			scope
+		});
+	} catch (error) {
+		reportLoggerFailure(error, {
+			level,
+			scope,
+			message,
+			context
+		});
+	}
+}
+function reportLoggerFailure(error, failedEntry) {
+	if (state.logger === consoleLogger) return;
+	const fallbackContext = {
+		scope: "logging",
+		error,
+		originalLevel: failedEntry.level,
+		originalScope: failedEntry.scope,
+		originalMessage: failedEntry.message
+	};
+	if (failedEntry.context !== void 0) fallbackContext.originalContext = failedEntry.context;
+	try {
+		consoleLogger.error("configured logger failed", fallbackContext);
+	} catch {}
+}
+/** @internal Returns the lazily-resolved scoped logger for a Hydrogen subsystem. */
+function getLogger(scope) {
+	return {
+		trace: (message, context) => emit(scope, "trace", message, context),
+		debug: (message, context) => emit(scope, "debug", message, context),
+		info: (message, context) => emit(scope, "info", message, context),
+		warn: (message, context) => emit(scope, "warn", message, context),
+		error: (message, context) => emit(scope, "error", message, context),
+		fatal: (message, context) => emit(scope, "fatal", message, context)
+	};
+}
+
+//#endregion
+//#region src/vite/mkcert.ts
+const log = getLogger("local-https");
+function confirm(message) {
+	consoleLogger.info(`☑️ ${message}`);
+}
+const MKCERT_VERSION = "v1.4.4";
+const MKCERT_RELEASE_BASE_URL = `https://github.com/FiloSottile/mkcert/releases/download/${MKCERT_VERSION}`;
+const EXECUTABLE_MODE = 493;
+const SUCCESS_EXIT_CODE$2 = 0;
+const DOWNLOAD_TIMEOUT_MS = 6e4;
+const MKCERT_BINARIES = {
+	"darwin-arm64": {
+		assetName: `mkcert-${MKCERT_VERSION}-darwin-arm64`,
+		sha256: "c8af0df44bce04359794dad8ea28d750437411d632748049d08644ffb66a60c6"
+	},
+	"darwin-x64": {
+		assetName: `mkcert-${MKCERT_VERSION}-darwin-amd64`,
+		sha256: "a32dfab51f1845d51e810db8e47dcf0e6b51ae3422426514bf5a2b8302e97d4e"
+	},
+	"linux-arm64": {
+		assetName: `mkcert-${MKCERT_VERSION}-linux-arm64`,
+		sha256: "b98f2cc69fd9147fe4d405d859c57504571adec0d3611c3eefd04107c7ac00d0"
+	},
+	"linux-x64": {
+		assetName: `mkcert-${MKCERT_VERSION}-linux-amd64`,
+		sha256: "6d31c65b03972c6dc4a14ab429f2928300518b26503f58723e532d1b0a3bbb52"
+	},
+	"win32-arm64": {
+		assetName: `mkcert-${MKCERT_VERSION}-windows-arm64.exe`,
+		sha256: "793747256c562622d40127c8080df26add2fb44c50906ce9db63b42a5280582e"
+	},
+	"win32-x64": {
+		assetName: `mkcert-${MKCERT_VERSION}-windows-amd64.exe`,
+		sha256: "d2660b50a9ed59eada480750561c96abc2ed4c9a38c6a24d93e30e0977631398"
+	}
+};
+/** @internal Exported for tests. */
+function resolveMkcertBinary(platform, arch) {
+	const binary = MKCERT_BINARIES[`${platform}-${arch}`];
+	if (!binary) return void 0;
+	return {
+		...binary,
+		url: `${MKCERT_RELEASE_BASE_URL}/${binary.assetName}`
+	};
+}
+function sha256Hex(bytes) {
+	return createHash("sha256").update(bytes).digest("hex");
+}
+/** @internal Exported for tests. */
+async function downloadVerified(options) {
+	let bytes;
+	try {
+		const response = await fetch(options.url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+		if (!response.ok) throw new Error(`mkcert download failed with status ${response.status}: ${options.url}`);
+		bytes = new Uint8Array(await response.arrayBuffer());
+	} catch (error) {
+		if (error instanceof Error && error.name === "TimeoutError") throw new Error(`mkcert download timed out after ${DOWNLOAD_TIMEOUT_MS / 1e3}s: ${options.url}`, { cause: error });
+		throw error;
+	}
+	const digest = sha256Hex(bytes);
+	if (digest !== options.sha256) throw new Error(`mkcert download did not match the pinned SHA-256 checksum; refusing to run it.\n  URL:      ${options.url}\n  Expected: ${options.sha256}\n  Received: ${digest}`);
+	await mkdir(dirname(options.destination), { recursive: true });
+	const temporaryPath = `${options.destination}.tmp-${process.pid}`;
+	try {
+		await writeFile(temporaryPath, bytes, { mode: EXECUTABLE_MODE });
+		await chmod(temporaryPath, EXECUTABLE_MODE);
+		await rename(temporaryPath, options.destination);
+	} catch (error) {
+		await rm(temporaryPath, { force: true });
+		throw error;
+	}
+}
+async function ensureMkcertBinary() {
+	const binary = resolveMkcertBinary(process.platform, process.arch);
+	if (!binary) throw new Error(`Automatic mkcert download is not available for ${process.platform}-${process.arch}. Install mkcert manually and generate the certificate.`);
+	const binaryPath = join(homedir(), ".shopify", "hydrogen", "mkcert", binary.assetName);
+	if (existsSync(binaryPath) && sha256Hex(await readFile(binaryPath)) === binary.sha256) return binaryPath;
+	log.info(`downloading mkcert ${MKCERT_VERSION}…`);
+	await downloadVerified({
+		url: binary.url,
+		sha256: binary.sha256,
+		destination: binaryPath
+	});
+	confirm(`mkcert ${MKCERT_VERSION} downloaded`);
+	return binaryPath;
+}
+function runMkcert(binaryPath, args) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(binaryPath, args, { stdio: [
+			"inherit",
+			"pipe",
+			"pipe"
+		] });
+		let output = "";
+		const collect = (chunk) => {
+			output += chunk.toString();
+		};
+		child.stdout?.on("data", collect);
+		child.stderr?.on("data", collect);
+		child.on("error", reject);
+		child.on("close", (code, signal) => {
+			if (code === SUCCESS_EXIT_CODE$2) {
+				resolve(output);
+				return;
+			}
+			const reason = signal ? `mkcert was killed by ${signal}` : `mkcert exited with code ${code}`;
+			reject(new Error(output.trim() === "" ? reason : `${reason}\n${output.trim()}`));
+		});
+	});
+}
+async function provisionCertificates(settings) {
+	const binaryPath = await ensureMkcertBinary();
+	await mkdir(dirname(settings.certPath), { recursive: true });
+	await mkdir(dirname(settings.keyPath), { recursive: true });
+	log.info("generating a trusted local certificate; mkcert may prompt for your password.");
+	confirm((await runMkcert(binaryPath, [
+		"-install",
+		"-cert-file",
+		settings.certPath,
+		"-key-file",
+		settings.keyPath,
+		settings.host
+	])).includes("The local CA is already installed") ? "The local CA is already installed in the system trust store" : "The local CA is now installed in the system trust store");
+	confirm(`Created a new certificate for "${settings.host}"`);
+	log.info("verifying certificates…");
+	const missingPaths = [settings.certPath, settings.keyPath].filter((path) => !existsSync(path));
+	if (missingPaths.length > 0) throw new Error(`mkcert did not create the expected files: ${missingPaths.join(", ")}`);
+	confirm("local https certificates ready");
+}
+async function uninstallCertificateAuthority() {
+	const binaryPath = await ensureMkcertBinary();
+	log.info("removing the local certificate authority; mkcert may prompt for your password.");
+	await runMkcert(binaryPath, ["-uninstall"]);
+	confirm("The local CA was removed from the system trust stores");
+}
+
+//#endregion
+//#region src/vite/local-https.ts
+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.
+*/
+async function provisionLocalHttps(options = {}) {
+	const settings = resolveLocalHttpsSettings({
+		enabled: true,
+		...options
+	});
+	if (!certificateFilesExist(settings)) await provisionCertificates(settings);
+	return {
+		host: settings.host,
+		certPath: settings.certPath,
+		keyPath: settings.keyPath
+	};
+}
+function resolveLocalHttpsSettings(options) {
+	const host = options.host ?? LOCAL_HTTPS_DEFAULTS.host;
+	const certificateDirectory = join(homedir(), ".shopify", "hydrogen", "certs");
+	return {
+		host,
+		port: options.port ?? LOCAL_HTTPS_DEFAULTS.port,
+		certPath: resolveCertificatePath(options.certPath ?? join(certificateDirectory, `${host}.pem`)),
+		keyPath: resolveCertificatePath(options.keyPath ?? join(certificateDirectory, `${host}-key.pem`))
+	};
+}
+function resolveCertificatePath(path) {
+	if (path instanceof URL) return fileURLToPath(path);
+	if (path === "~") return homedir();
+	if (path.startsWith("~/")) return resolve(homedir(), path.slice(2));
+	return isAbsolute(path) ? path : resolve(path);
+}
+function certificateFilesExist(settings) {
+	return existsSync(settings.certPath) && existsSync(settings.keyPath);
+}
+
+//#endregion
+//#region src/cli/certs.ts
+const REMOVE_CA_FLAG = "--remove-ca";
+async function installLocalHttpsCertificates() {
+	const { host, certPath, keyPath } = await provisionLocalHttps();
+	console.log(`Local HTTPS is ready for https://${host}`);
+	console.log(`  Certificate: ${certPath}`);
+	console.log(`  Private key: ${keyPath}`);
+}
+async function uninstallLocalHttpsCertificates(args = []) {
+	const unknownArgument = args.find((argument) => argument !== REMOVE_CA_FLAG);
+	if (unknownArgument) throw new Error(`Unknown argument: ${unknownArgument}`);
+	const removeCertificateAuthority = args.includes(REMOVE_CA_FLAG);
+	if (removeCertificateAuthority) {
+		console.warn("Warning: removing mkcert's shared local CA will make certificates created by other projects untrusted.");
+		await uninstallCertificateAuthority();
+	}
+	const hydrogenDirectory = join(homedir(), ".shopify", "hydrogen");
+	const certificateDirectory = join(hydrogenDirectory, "certs");
+	const host = LOCAL_HTTPS_DEFAULTS.host;
+	const binary = resolveMkcertBinary(process.platform, process.arch);
+	const removals = [rm(join(certificateDirectory, `${host}.pem`), { force: true }), rm(join(certificateDirectory, `${host}-key.pem`), { force: true })];
+	if (binary) removals.push(rm(join(hydrogenDirectory, "mkcert", binary.assetName), { force: true }));
+	await Promise.all(removals);
+	console.log("Hydrogen's local HTTPS certificate files were removed.");
+	if (!removeCertificateAuthority) console.log(`The shared mkcert CA remains trusted. Pass ${REMOVE_CA_FLAG} to remove it.`);
+}
+
+//#endregion
 //#region src/graphql/plugin-config.ts
 const STOREFRONT_SCHEMA_FILE_NAME = "storefront.schema.json";
 const CUSTOMER_ACCOUNT_SCHEMA_FILE_NAME = "customer-account.schema.json";
@@ -299,13 +605,24 @@ async function setupHydrogen(options = {}) {
 //#region src/cli/index.ts
 const CLI_ARGUMENTS_INDEX = 2;
 const FAILURE_EXIT_CODE = 1;
-const COMMANDS = [{
-	path: ["setup"],
-	run: async (_args) => setupHydrogen()
-}, {
-	path: ["gql", "check"],
-	run: async (args) => checkGraphQL({ args })
-}];
+const COMMANDS = [
+	{
+		path: ["certs", "install"],
+		run: async (_args) => installLocalHttpsCertificates()
+	},
+	{
+		path: ["certs", "uninstall"],
+		run: async (args) => uninstallLocalHttpsCertificates(args)
+	},
+	{
+		path: ["setup"],
+		run: async (_args) => setupHydrogen()
+	},
+	{
+		path: ["gql", "check"],
+		run: async (args) => checkGraphQL({ args })
+	}
+];
 function commandMatches(path, args) {
 	return path.every((segment, index) => args[index] === segment);
 }

package/dist/client/client.mjs

@@ -1,8 +1,8 @@
-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 { 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
@@ -27,7 +27,17 @@ const REQUEST_IDENTITY_HEADERS = new Set([
 	SHOPIFY_STOREFRONT_Y_HEADER.toLowerCase(),
 	SHOPIFY_STOREFRONT_S_HEADER.toLowerCase()
 ]);
+const CACHE_ENABLED_GRAPHQL_CLIENTS = /* @__PURE__ */ new WeakSet();
+const SHOULD_CACHE_RESULT = Symbol();
 var StorefrontCacheConfigError = class extends Error {};
+function withStorefrontClientCache(client, options, strategy, shouldCacheResult) {
+	if (!CACHE_ENABLED_GRAPHQL_CLIENTS.has(client.graphql)) return options;
+	return {
+		...options,
+		cache: strategy,
+		[SHOULD_CACHE_RESULT]: shouldCacheResult
+	};
+}
 function createStorefrontClient(args) {
 	const { config, requestContext, type: clientType } = args;
 	if (!config.storeDomain) throw new Error("storeDomain is required and must be non-empty");
@@ -94,7 +104,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));
+			const response = await resolvedFetch(apiUrl, init, createStorefrontCacheOptions(apiUrl, init, queryText, opts.cache, opts[SHOULD_CACHE_RESULT]));
 			responseHeaders = response.headers;
 			if (getHydrogenCacheStatus(responseHeaders) !== "hit") requestContext.captureSubrequestHeaders(responseHeaders);
 			requestId = responseHeaders.get("x-request-id") ?? void 0;
@@ -146,7 +156,7 @@ function createStorefrontClient(args) {
 			headers: responseHeaders
 		};
 	}
-	return {
+	const client = {
 		type: clientType,
 		i18n,
 		graphql,
@@ -155,6 +165,8 @@ function createStorefrontClient(args) {
 		storefrontId: config.storefrontId,
 		requestContext
 	};
+	if (config.cache) CACHE_ENABLED_GRAPHQL_CLIENTS.add(client.graphql);
+	return client;
 }
 function buildVariables(queryText, userVariables, resolvedI18n) {
 	const variables = { ...userVariables };
@@ -162,7 +174,7 @@ function buildVariables(queryText, userVariables, resolvedI18n) {
 	if (LANGUAGE_VAR_RE.test(queryText)) variables.language = resolvedI18n.language;
 	return variables;
 }
-function createStorefrontCacheOptions(apiUrl, init, queryText, strategy) {
+function createStorefrontCacheOptions(apiUrl, init, queryText, strategy, shouldCacheResult) {
 	if (!strategy) return void 0;
 	if (/\bmutation\b/.test(queryText)) return void 0;
 	return {
@@ -171,7 +183,8 @@ function createStorefrontCacheOptions(apiUrl, init, queryText, strategy) {
 		shouldCacheResponse: async ({ json }) => {
 			if (!json) return false;
 			const body = await json().catch(() => void 0);
-			return typeof body === "object" && body != null && !Array.isArray(body) && !("errors" in body);
+			if (typeof body !== "object" || body == null || Array.isArray(body) || "errors" in body) return false;
+			return shouldCacheResult?.(body) ?? true;
 		}
 	};
 }
@@ -189,5 +202,5 @@ function createStorefrontCacheKey(apiUrl, init) {
 }
 
 //#endregion
-export { createStorefrontClient };
+export { createStorefrontClient, withStorefrontClientCache };
 //# sourceMappingURL=client.mjs.map

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]);\n\nclass StorefrontCacheConfigError extends Error {}\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    };\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(apiUrl, init, queryText, opts.cache);\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  return {\n    type: clientType,\n    i18n,\n    graphql: graphql as StorefrontClient[\"graphql\"],\n    apiUrl,\n    storeUrl,\n    storefrontId: config.storefrontId,\n    requestContext,\n  };\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): 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      return (\n        typeof body === \"object\" && body != null && !Array.isArray(body) && !(\"errors\" in body)\n      );\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 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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"}

package/dist/core/cart/cart.d.mts

@@ -13,6 +13,11 @@ type CartStore = {
   getState(): CartState;
   subscribe(listener: (state: CartState) => void): () => void;
   fetch(): Promise<void>;
+  /**
+   * Reconciles the cart after an out-of-band mutation: revalidates the current
+   * cart, or loads one when none is present yet (e.g. just created server-side).
+   */
+  refresh(): void;
   reset(): void;
   handleFormSubmit(event: SubmitEvent, eventDetail?: Record<string, unknown>): Promise<void>;
 };

package/dist/core/cart/cart.mjs

@@ -973,6 +973,9 @@ function markOverlappingTransactionForRevalidation(store, transaction) {
 	if (store.transactions.length === 0 && !store.revalidation.active && store.activeMutationTransports.size === 0) return;
 	transaction.requiresRevalidation = true;
 	for (const pending of store.transactions) pending.requiresRevalidation = true;
+	requestCartRevalidation(store);
+}
+function requestCartRevalidation(store) {
 	store.revalidation.requested = true;
 	store.revalidation.visible = true;
 	store.revalidation.active?.controller.abort();
@@ -1418,6 +1421,7 @@ function createCartStore(options = {}) {
 		getState: () => store.observable.state,
 		subscribe: (listener) => store.observable.subscribe(listener),
 		fetch: () => loadCartInStore(store),
+		refresh: () => refreshCartInStore(store),
 		reset: () => resetCartStore(store),
 		handleFormSubmit: (event, eventDetail) => handleFormSubmitInStore(store, handlers, event, eventDetail)
 	};
@@ -1579,8 +1583,8 @@ async function fetchCart(cartId, callerSignal) {
 	if (!getCart) throw new Error("Standard Actions not available. Ensure the Shopify script tag is loaded before calling fetchCart.");
 	return { cart: (await getCart(cartId ? { cartId } : void 0, { signal })).cart };
 }
-function fetchCartData(cartId) {
-	return fetchCart(cartId).then(({ cart }) => cart ? {
+function fetchCartData(cartId, signal) {
+	return fetchCart(cartId, signal).then(({ cart }) => cart ? {
 		...cart,
 		checkoutUrl: cart.checkoutUrl ?? null,
 		note: extractNoteFromCart(cart),
@@ -1611,35 +1615,51 @@ function fetchCartRevalidationData(cartId, signal) {
 	return fetchCart(cartId, signal).then(({ cart }) => cart ? cartResponseFromStandardEvent(cart) : null);
 }
 function isCurrentCartRevalidationRequest(store, request) {
-	return store.revalidation.active === request && store.generation === request.generation && store.mutationRevision === request.mutationRevision && store.transactions.length === 0 && store.settled.data.id === request.cartId;
-}
-function isCurrentCartRevalidation(store, request, cart) {
-	return isCurrentCartRevalidationRequest(store, request) && cart.id === request.cartId;
+	return !request.controller.signal.aborted && store.revalidation.active === request && store.generation === request.generation && store.mutationRevision === request.mutationRevision && store.transactions.length === 0 && store.settled.data.id === request.cartId;
 }
-function revalidateCartWhenIdle(store) {
-	if (!store.revalidation.requested || store.revalidation.active || store.transactions.length > 0 || store.activeMutationTransports.size > 0) return;
-	const cartId = store.settled.data.id;
-	if (!cartId) {
-		store.revalidation.requested = false;
+function applyCartRevalidation(store, request, cart) {
+	if (!isCurrentCartRevalidationRequest(store, request)) return;
+	if (request.cartId === null) {
+		if (cart) {
+			hydrateCartInStore(store, cart);
+			return;
+		}
 		store.revalidation.visible = false;
 		publishVisibleState(store);
 		return;
 	}
+	if (!cart) throw new Error(CART_REVALIDATION_ERROR_MESSAGE);
+	if (cart.id !== request.cartId) {
+		hydrateCartInStore(store, cart);
+		return;
+	}
+	store.settled = {
+		...store.settled,
+		data: mergeAuthoritativeCartData(store.settled.data, cart)
+	};
+	store.revalidation.visible = false;
+	publishVisibleState(store);
+}
+function refreshCartInStore(store) {
+	const activeCartLoad = store.activeCartLoad;
+	if (activeCartLoad) {
+		const runAfterLoad = () => refreshCartInStore(store);
+		activeCartLoad.promise.then(runAfterLoad, runAfterLoad);
+		return;
+	}
+	requestCartRevalidation(store);
+	publishVisibleState(store);
+	revalidateCartWhenIdle(store);
+}
+function revalidateCartWhenIdle(store) {
+	if (!store.revalidation.requested || store.revalidation.active || store.transactions.length > 0 || store.activeMutationTransports.size > 0) return;
 	store.revalidation.requested = false;
 	clearProjectedErrors(store, [REVALIDATION_ERROR_KEY]);
 	publishVisibleState(store);
+	const cartId = store.settled.data.id;
 	const controller = new AbortController();
 	let request;
-	const promise = fetchCartRevalidationData(cartId, controller.signal).then((cart) => {
-		if (!cart) throw new Error(CART_REVALIDATION_ERROR_MESSAGE);
-		if (!isCurrentCartRevalidation(store, request, cart)) return;
-		store.settled = {
-			...store.settled,
-			data: mergeAuthoritativeCartData(store.settled.data, cart)
-		};
-		store.revalidation.visible = false;
-		publishVisibleState(store);
-	}).catch((error) => {
+	const promise = (cartId ? fetchCartRevalidationData(cartId, controller.signal) : fetchCartData(null, controller.signal)).then((cart) => applyCartRevalidation(store, request, cart)).catch((error) => {
 		if (isAbortError(error) || !isCurrentCartRevalidationRequest(store, request)) return;
 		store.revalidation.visible = false;
 		addProjectedError(store, [REVALIDATION_ERROR_KEY], (state, timestampMs) => writeNetworkError(state, new Error(CART_REVALIDATION_ERROR_MESSAGE), timestampMs));