@vtex/faststore 0.0.7 → 0.0.10

package/dist/cli/index.js

@@ -1,18 +1,17 @@
 import { createRequire } from "node:module";
-import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, statSync, watch, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { chmodSync, closeSync, copyFileSync, cpSync, existsSync, linkSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, watch, writeFileSync, writeSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { kill, pid } from "node:process";
 import { Kind, parse, print, visit } from "graphql";
-import { pid } from "node:process";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
+import { createInterface } from "node:readline";
 import crypto from "crypto";
 //#region \0rolldown/runtime.js
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esmMin = (fn, res, err) => () => {
 	if (err) throw err[0];
@@ -42,13 +41,27 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
 var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
 //#endregion
+//#region ../../node_modules/.pnpm/@vtex+extension-cli-kit@0.1.1/node_modules/@vtex/extension-cli-kit/dist/kinds.js
+/** RFC-0001's closed set of kinds. A new kind arrives by its own RFC. */
+const kinds = [
+	"storefront",
+	"widget",
+	"instructions",
+	"workflow",
+	"agent",
+	"function"
+];
+//#endregion
+//#region ../../node_modules/.pnpm/@vtex+extension-cli-kit@0.1.1/node_modules/@vtex/extension-cli-kit/dist/provider.js
+/**
+* The kind provider contract version this kit describes. A provider declares the version it
+* implements as `contract`; the CLI checks it against the range it supports.
+*/
+const providerContractVersion = 0;
+//#endregion
 //#region ../graphql-compose/dist/subgraph-names.js
 var require_subgraph_names = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
@@ -12080,7 +12093,7 @@ var require_has_flag = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region ../../node_modules/.pnpm/supports-color@8.1.1/node_modules/supports-color/index.js
 var require_supports_color$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const os$2 = __require("os");
+	const os$1 = __require("os");
 	const tty$2 = __require("tty");
 	const hasFlag = require_has_flag();
 	const { env } = process;
@@ -12116,7 +12129,7 @@ var require_supports_color$1 = /* @__PURE__ */ __commonJSMin(((exports, module)
 		const min = forceColor || 0;
 		if (env.TERM === "dumb") return min;
 		if (process.platform === "win32") {
-			const osRelease = os$2.release().split(".");
+			const osRelease = os$1.release().split(".");
 			if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) return Number(osRelease[2]) >= 14931 ? 3 : 2;
 			return 1;
 		}
@@ -17703,12 +17716,254 @@ var require_compose = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 }));
 //#endregion
-//#region src/cli/hive-router.ts
+//#region src/cli/paths.ts
 var import_subgraph_names = require_subgraph_names();
 var import_compose = require_compose();
-/** The pinned version, overridable for a local bump trial via `VTEX_STOREFRONT_ROUTER_VERSION`. */
-function routerVersion() {
-	return process.env.VTEX_STOREFRONT_ROUTER_VERSION?.trim() || "0.0.85";
+/**
+* `path` as the filesystem spells it: symlinks followed and the on-disk case
+* restored through the nearest ancestor that exists, with the rest joined
+* back. Compared as strings, `../Ext` is a sibling of the Asset at `ext` on a
+* case-insensitive filesystem, and a symlink to the Asset is a sibling
+* anywhere; both name the Asset.
+*/
+function canonical(path) {
+	const missing = [];
+	let existing = path;
+	while (!existsSync(existing)) {
+		missing.unshift(basename(existing));
+		const parent = dirname(existing);
+		if (parent === existing) break;
+		existing = parent;
+	}
+	return join(realpathSync.native(existing), ...missing);
+}
+/** True when `path` is `root` or lies under it, as the filesystem spells both. */
+function isInside(path, root) {
+	const rel = relative(canonical(root), canonical(path));
+	return rel === "" || !isAbsolute(rel) && rel.split(sep)[0] !== "..";
+}
+//#endregion
+//#region src/cli/asset-layout.ts
+/** The layout of the Asset at `root`: its `package.json` parsed when present, absent otherwise. */
+function readAssetLayout(root) {
+	const packageJsonPath = join(root, "package.json");
+	if (!existsSync(packageJsonPath)) return { dir: root };
+	return {
+		dir: root,
+		packageJson: JSON.parse(readFileSync(packageJsonPath, "utf-8"))
+	};
+}
+/** True when `package.json#exports` has the `./catalog.json` key: the one UI signal (ADR-0007). */
+function exportsCatalog(asset) {
+	const { exports } = asset.packageJson ?? {};
+	return typeof exports === "object" && exports !== null && "./catalog.json" in exports;
+}
+/**
+* The conditions a build-time reader takes first inside a conditions object, in this order,
+* before any other key: `types` may name a `.d.ts`, and key order is the author's, not a
+* preference. Sukima's `export_target` (`store_project.rs`) reads the same way, so the provider
+* writes the catalog where the store reads it.
+*/
+const PREFERRED_CONDITIONS = [
+	"default",
+	"import",
+	"node",
+	"require"
+];
+function catalogExport(asset) {
+	const { exports } = asset.packageJson ?? {};
+	if (!exportsCatalog(asset)) return { kind: "none" };
+	const target = exportTarget(exports["./catalog.json"]);
+	if (target === void 0) return {
+		kind: "invalid",
+		reason: "names no file"
+	};
+	if (isAbsolute(target)) return {
+		kind: "invalid",
+		reason: `names "${target}", which is absolute`
+	};
+	if (target.split("/").includes("..")) return {
+		kind: "invalid",
+		reason: `names "${target}", which leaves the Asset folder`
+	};
+	if (!target.startsWith("./")) return {
+		kind: "invalid",
+		reason: `names "${target}", which does not start with "./"`
+	};
+	const file = target.slice(target.lastIndexOf("/") + 1);
+	if (file === "" || file === ".") return {
+		kind: "invalid",
+		reason: `names "${target}", which names a folder, not a file`
+	};
+	if (target.split("/").includes("")) return {
+		kind: "invalid",
+		reason: `names "${target}", which has an empty segment`
+	};
+	if (file !== "catalog.json") return {
+		kind: "invalid",
+		reason: `names "${target}", whose file is not catalog.json, the file the build writes`
+	};
+	if (!isInside(join(asset.dir, target), asset.dir)) return {
+		kind: "invalid",
+		reason: `names "${target}", which resolves outside the Asset folder through a link`
+	};
+	return {
+		kind: "target",
+		target
+	};
+}
+/** The usable subpath `exports["./catalog.json"]` names, relative to the Asset, or `undefined`. */
+function catalogExportTarget(asset) {
+	const exported = catalogExport(asset);
+	return exported.kind === "target" ? exported.target : void 0;
+}
+/**
+* The file an `exports` entry names: the string itself; inside a conditions object the preferred
+* condition that names one, else the first key that does; the first string of a fallback array.
+*/
+function exportTarget(value) {
+	if (typeof value === "string") return value;
+	if (typeof value !== "object" || value === null) return void 0;
+	const entries = Array.isArray(value) ? value : [...PREFERRED_CONDITIONS.filter((condition) => condition in value).map((condition) => value[condition]), ...Object.values(value)];
+	for (const entry of entries) {
+		const target = exportTarget(entry);
+		if (target !== void 0) return target;
+	}
+}
+/**
+* Where the Asset's catalog goes so a store finds it: the folder of the file its
+* `exports["./catalog.json"]` names (ADR-0007), or `dist/` when the Asset has no usable export,
+* which `validate` reports. `dev` builds there on every save, and `build` copies its catalog there
+* beside the copy in `outDir`.
+*/
+function catalogOutDir(asset) {
+	const target = catalogExportTarget(asset);
+	return target === void 0 ? join(asset.dir, "dist") : dirname(join(asset.dir, target));
+}
+/**
+* The declaration entry of the Asset's API Extension, absolute, or `undefined` when the Asset has
+* none. `resolveDeclarationEntry`'s convention — `package.json#main`, else `src/index.ts` — plus the
+* one UI signal: an Asset that exports `./catalog.json` is a UI Extension, so its `src/index.ts` is
+* the component barrel, never a declaration. A dual Asset names its declaration through `main`.
+*/
+function apiDeclarationEntry(asset) {
+	const { main } = asset.packageJson ?? {};
+	if (typeof main === "string") return join(asset.dir, main);
+	const conventional = join(asset.dir, "src", "index.ts");
+	return existsSync(conventional) && !exportsCatalog(asset) ? conventional : void 0;
+}
+/**
+* True when the Asset has a UI Extension: a `src/components/` directory (the layout the catalog
+* build scans for an extension) or the `./catalog.json` export. Either alone counts, so both
+* failure modes are reported: a UI side that forgot the export, and an export that promises a
+* catalog no components can build.
+*/
+function uiSide(asset) {
+	return statSync(join(asset.dir, "src", "components"), { throwIfNoEntry: false })?.isDirectory() === true || exportsCatalog(asset);
+}
+//#endregion
+//#region src/cli/bundler.ts
+/**
+* esbuild, imported on first use. It is a regular dependency of
+* `@vtex/faststore`, pinned to one minor (ADR-0026): the runner bundles with it
+* to load an extension's declaration (`validate`, `build`, `dev`) and to emit
+* `server.mjs` (`build`). The import is lazy so `dist/cli/index.js` loads where
+* esbuild's platform binary is not installed, and so the provider's members
+* that bundle nothing never pay for it.
+*/
+async function loadBundler(verb) {
+	try {
+		const mod = await import("esbuild");
+		return mod.default ?? mod;
+	} catch (error) {
+		throw new Error(`storefront ${verb}: could not load esbuild, a dependency of @vtex/faststore — reinstall the package. Cause: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+//#endregion
+//#region src/cli/catalog.ts
+/**
+* The catalog build addon, imported on first use. `@vtex/faststore-catalog` is
+* a regular dependency of `@vtex/faststore` (ADR-0026): the runner builds a
+* UI Extension's catalog with it (`validate`, `dev`, `build`). The import is
+* lazy because the addon loads its native binary at require time, and the
+* publish smoke installs with `--omit=optional`, which drops the platform
+* package: a static import would make `dist/cli/index.js` fail to load there.
+*/
+async function loadCatalogBuilder(verb) {
+	try {
+		const mod = await import("@vtex/faststore-catalog");
+		return mod.default ?? mod;
+	} catch (error) {
+		throw new Error(`storefront ${verb}: could not load @vtex/faststore-catalog, a dependency of @vtex/faststore — reinstall the package. Cause: ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+/**
+* Builds the catalog of the Asset's UI Extension at `root` into `outDir`:
+* `src/components/` scanned, keys namespaced by `package.json#name`. Always
+* `kind: 'extension'`, because the provider knows which side it is building
+* (ADR-0007): an Asset named `@vtex/faststore` fails with `PackageKindMismatch`
+* instead of building as the Core package. No fragment map yet: a component
+* that spreads a fragment fails with `UnresolvedSpread`.
+*/
+async function buildAssetCatalog(root, outDir, verb) {
+	const { buildPackageCatalog } = await loadCatalogBuilder(verb);
+	return buildPackageCatalog({
+		packageDir: root,
+		kind: "extension",
+		outDir
+	});
+}
+//#endregion
+//#region src/cli/component-docs.ts
+/**
+* Scans the UI side's `src/components/` tree for `*.md` and plans one flat
+* copy per doc, sorted by destination. The runner's port of
+* `scripts/build-docs.mjs`, which does the same for the Core package's two
+* trees.
+*
+* The shipped filename is the source basename. The catalog's `docPath` is
+* package-relative and names the `src/` file (`<stem>.md` beside the
+* component, or an explicit `docPath` relative to it), and `src/` never
+* ships, so a reader resolves `docs/<basename(docPath)>` under the output
+* folder — the convention `@vtex/faststore`'s own `dist/docs/` follows
+* (ADR-0019). That mapping only holds while basenames are unique, so a
+* collision fails the build instead of shipping whichever file was copied
+* last. A missing tree plans nothing: the UI side may be an export alone,
+* which the catalog build then rejects on its own terms.
+*/
+function planDocCopies(root) {
+	const componentsDir = join(root, "src", "components");
+	if (!existsSync(componentsDir)) return [];
+	const claimed = /* @__PURE__ */ new Map();
+	const copies = [];
+	for (const entry of readdirSync(componentsDir, {
+		withFileTypes: true,
+		recursive: true
+	})) {
+		if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+		const source = join(entry.parentPath, entry.name);
+		const previous = claimed.get(entry.name);
+		if (previous) {
+			const [a, b] = [previous, source].map((path) => relative(root, path)).sort((x, y) => x.localeCompare(y));
+			throw new Error(`storefront build: component doc basename collision: "${entry.name}" is claimed by both ${a} and ${b}. Shipped docs are flat, and the catalog maps an entry to its doc by basename — rename one of them.`);
+		}
+		claimed.set(entry.name, source);
+		copies.push({
+			source,
+			destination: entry.name
+		});
+	}
+	copies.sort((a, b) => a.destination.localeCompare(b.destination));
+	return copies;
+}
+/**
+* Copies each planned doc into `docsDir` and returns the count. The folder is
+* created even for an empty plan, so a UI side's output always has `docs/`.
+*/
+function copyDocs(copies, docsDir) {
+	mkdirSync(docsDir, { recursive: true });
+	for (const { source, destination } of copies) copyFileSync(source, join(docsDir, destination));
+	return copies.length;
 }
 /**
 * SHA-256 of each release asset, keyed `<version>/<asset>`. Every supported
@@ -17756,6 +18011,11 @@ function verifyChecksum(version, asset, contents) {
 * and marks it executable. Written through a sibling temp file and renamed, so
 * an interrupted download never leaves a truncated binary in the cache for the
 * next run to execute.
+*
+* The temp name carries the pid because two processes can miss one cache at
+* once — two `dev` sessions, or two e2e files in parallel workers. On a shared
+* name the second rename finds no file (ENOENT), and the first one's cleanup
+* deletes the second's pending write.
 */
 async function downloadRouterBinary(binaryPath, version) {
 	const asset = routerAssetName();
@@ -17770,7 +18030,7 @@ async function downloadRouterBinary(binaryPath, version) {
 	const contents = Buffer.from(await response.arrayBuffer());
 	verifyChecksum(version, asset, contents);
 	mkdirSync(dirname(binaryPath), { recursive: true });
-	const partialPath = `${binaryPath}.partial`;
+	const partialPath = `${binaryPath}.${pid}.partial`;
 	try {
 		writeFileSync(partialPath, contents);
 		chmodSync(partialPath, 493);
@@ -17780,16 +18040,15 @@ async function downloadRouterBinary(binaryPath, version) {
 	}
 }
 /**
-* Resolves the router binary in three steps: the `VTEX_STOREFRONT_ROUTER_BINARY`
-* override (used verbatim), then `cachedBinaryPath` if a previous run already
-* fetched this version, then a download of the pinned release asset. Returns
-* the path to run.
+* Resolves the router binary in three steps: `override` (the host's
+* `VTEX_STOREFRONT_ROUTER_BINARY`, used verbatim), then `cachedBinaryPath` if a
+* previous run already fetched this version, then a download of the pinned
+* release asset. Returns the path to run.
 *
 * The override is what makes air-gapped machines, CI caches and locally built
 * routers all work without a special case each.
 */
-async function ensureRouterBinary(cachedBinaryPath, version = routerVersion()) {
-	const override = process.env.VTEX_STOREFRONT_ROUTER_BINARY?.trim();
+async function ensureRouterBinary(cachedBinaryPath, version, override) {
 	if (override) {
 		if (!existsSync(override)) throw new Error(`storefront dev: VTEX_STOREFRONT_ROUTER_BINARY points at ${override}, which does not exist.`);
 		return override;
@@ -17798,19 +18057,32 @@ async function ensureRouterBinary(cachedBinaryPath, version = routerVersion()) {
 	await downloadRouterBinary(cachedBinaryPath, version);
 	return cachedBinaryPath;
 }
+/** Forwards each line of a child stream to `sink`. A null stream (no pipe) forwards nothing. */
+function forwardLines(stream, sink) {
+	if (!stream) return;
+	createInterface({ input: stream }).on("line", sink);
+}
 /**
 * Launches the Hive Router with the generated config. Resolves once the
 * process has actually spawned, and rejects on `ENOENT`/`EACCES` so the
 * caller can roll the subgraph back instead of racing an uncaught `error`.
 * The binary takes no arguments: it reads `ROUTER_CONFIG_FILE_PATH`, and the
 * listen address comes from the config's `http.host`/`http.port`.
+*
+* Output is piped, not inherited: every line reaches the host through the log
+* sink, so the runner writes nothing to its process's stdio (ADR-0026). Both
+* readers attach before `resolve`, so an unread pipe never blocks the child.
 */
-function spawnRouter(binaryPath, configPath) {
+function spawnRouter(binaryPath, configPath, { env, log }) {
 	return new Promise((resolve, reject) => {
 		const child = spawn(binaryPath, [], {
-			stdio: "inherit",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
 			env: {
-				...process.env,
+				...env,
 				ROUTER_CONFIG_FILE_PATH: configPath
 			}
 		});
@@ -17818,18 +18090,105 @@ function spawnRouter(binaryPath, configPath) {
 		child.once("spawn", () => {
 			child.removeListener("error", reject);
 			child.on("error", (error) => {
-				console.error(`storefront dev: Hive Router process error: ${error.message}`);
+				log.error(`storefront dev: Hive Router process error: ${error.message}`);
 			});
+			forwardLines(child.stdout, (line) => log.info(line));
+			forwardLines(child.stderr, (line) => log.error(line));
 			resolve(child);
 		});
 	});
 }
 /**
+* How long `startRouter` waits for the router to answer at its URL after the
+* spawn. The binary loads the supergraph and binds its port in well under a
+* second; a router still silent at the deadline is treated as down.
+*/
+const ROUTER_LISTEN_TIMEOUT_MS = 3e4;
+/** How often the readiness probe knocks on the router's URL. */
+const ROUTER_PROBE_INTERVAL_MS = 100;
+/**
+* How long one probe waits for an answer before it counts as "not yet". A server that accepts the
+* connection and never answers would otherwise hold the probe, and the pre-spawn check, forever.
+*/
+const ROUTER_PROBE_TIMEOUT_MS = 2e3;
+/** `with code 1`, or `on signal SIGKILL`. */
+function describeRouterExit({ code, signal }) {
+	return code === null ? `on signal ${signal}` : `with code ${code}`;
+}
+/**
+* True when something answers a GraphQL request at `url` within `timeoutMs`. A transport error, a
+* stalled connection included, is "not yet" for the readiness probe; before the spawn, a `true`
+* means the port is taken by a server that answers GraphQL, a router a dead session left behind,
+* say, and the new router would lose the bind.
+*/
+async function routerAnswersAt(url, timeoutMs = ROUTER_PROBE_TIMEOUT_MS) {
+	try {
+		return (await fetch(url, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({ query: "{ __typename }" }),
+			signal: AbortSignal.timeout(timeoutMs)
+		})).ok;
+	} catch {
+		return false;
+	}
+}
+/**
+* Resolves once the router answers at `url`. Rejects when the child exits
+* first or when `timeoutMs` elapses, naming the exit and the last lines the
+* router wrote to stderr (`recentStderr`) either way: a router that binds but
+* answers 5xx, over a supergraph it cannot load, say, explains itself there.
+* `spawn` alone proves nothing: a router whose port is taken spawns fine and
+* exits with `AddrInUse` a moment later, and a session that reports `ready` on
+* `spawn` hands out a URL nobody serves. The caller probes the URL once before
+* the spawn (`startRouter`), so an answer here is this child's.
+*/
+function waitForRouterListening(child, url, recentStderr, timeoutMs = ROUTER_LISTEN_TIMEOUT_MS) {
+	return new Promise((resolve, reject) => {
+		let settled = false;
+		const settle = (outcome) => {
+			if (settled) return;
+			settled = true;
+			child.removeListener("exit", onExit);
+			clearTimeout(deadline);
+			outcome();
+		};
+		const withTail = (message) => {
+			const tail = recentStderr().map((line) => `  ${line}`);
+			return tail.length > 0 ? `${message}\n${tail.join("\n")}` : message;
+		};
+		const onExit = (code, signal) => {
+			settle(() => reject(new Error(withTail(`storefront dev: the Hive Router exited ${describeRouterExit({
+				code,
+				signal
+			})} before it answered at ${url}.`))));
+		};
+		const deadline = setTimeout(() => {
+			settle(() => reject(new Error(withTail(`storefront dev: the Hive Router did not answer at ${url} within ${timeoutMs}ms.`))));
+		}, timeoutMs);
+		if (child.exitCode !== null || child.signalCode !== null) {
+			onExit(child.exitCode, child.signalCode);
+			return;
+		}
+		child.once("exit", onExit);
+		const probe = async () => {
+			while (!settled) {
+				if (await routerAnswersAt(url)) {
+					settle(resolve);
+					return;
+				}
+				await new Promise((tick) => setTimeout(tick, ROUTER_PROBE_INTERVAL_MS));
+			}
+		};
+		probe();
+	});
+}
+/**
 * Where a cached router binary lives inside a scratch dir. Keyed by version,
 * OS and arch so a copied scratch directory cannot execute the wrong target,
 * and a version bump re-downloads.
 */
-function routerBinaryFileName(version = routerVersion(), platform = process.platform, arch = process.arch) {
+function routerBinaryFileName(version, platform = process.platform, arch = process.arch) {
 	const os = ROUTER_OS[platform];
 	const cpu = ROUTER_ARCH[arch];
 	if (!os || !cpu) return `hive-router-${version}`;
@@ -17840,15 +18199,22 @@ function routerBinaryFileName(version = routerVersion(), platform = process.plat
 /**
 * The scratch directory's parent. `.vtex/` is shared with other VTEX tooling
 * (a repository root may hold tracked deploy config there), so only the
-* `storefront/` folder inside it is the runner's, and only that is gitignored.
+* `storefront/` folder inside it is the runner's, and only that is ignored.
 */
 const SCRATCH_PARENT_DIR_NAME = ".vtex";
 /** The runner's scratch folder under `.vtex/`: composed artifacts, router config and binary, bundled declarations. */
 const SCRATCH_DIR_NAME = "storefront";
-/** The extension's gitignored scratch directory, `<root>/.vtex/storefront/`, created on first use. */
+/**
+* The scratch directory, `<root>/.vtex/storefront/`, created on first use with a `.gitignore`
+* that ignores everything in it. The folder ignores itself because not every root ignores it:
+* an Account Repo root's `.gitignore` lists `.vtex/build/` and `.vtex/dev-session.json` only,
+* and `dev` writes `router.config.yaml`, with `VTEX_TOKEN` in clear, under the session root.
+*/
 function scratchDir(extensionRoot) {
 	const dir = join(extensionRoot, SCRATCH_PARENT_DIR_NAME, SCRATCH_DIR_NAME);
 	mkdirSync(dir, { recursive: true });
+	const gitignore = join(dir, ".gitignore");
+	if (!existsSync(gitignore)) writeFileSync(gitignore, "*\n", "utf-8");
 	return dir;
 }
 /** Where `loadDeclaration` writes the bundled declarations it imports. */
@@ -17857,6 +18223,12 @@ function loadDir(extensionRoot) {
 	mkdirSync(dir, { recursive: true });
 	return dir;
 }
+/** Where `validate` builds a UI Extension's scratch catalog; `dev` and `build` pass their own `outDir`. */
+function catalogDir(extensionRoot) {
+	const dir = join(scratchDir(extensionRoot), "catalog");
+	mkdirSync(dir, { recursive: true });
+	return dir;
+}
 /**
 * Where a cached Hive Router binary lives. Keyed by version, OS and arch, so
 * bumping the pin fetches the new release and a copied scratch directory cannot
@@ -17916,13 +18288,13 @@ function formatCompositionErrors(verb, errors) {
 * Callers pass a successful `composeSupergraph` result, so both files come from
 * one composition and always describe the same graph.
 */
-function writeComposedArtifacts(extensionRoot, composed, verb) {
+function writeComposedArtifacts(extensionRoot, composed, verb, log) {
 	const supergraphFile = supergraphPath(extensionRoot);
 	writeFileAtomic(supergraphFile, composed.supergraphSdl);
-	console.log(`storefront ${verb}: composed ${supergraphFile} (${Buffer.byteLength(composed.supergraphSdl)} bytes of supergraph SDL).`);
+	log.info(`storefront ${verb}: composed ${supergraphFile} (${Buffer.byteLength(composed.supergraphSdl)} bytes of supergraph SDL).`);
 	const publicSchemaFile = publicSchemaPath(extensionRoot);
 	writeFileAtomic(publicSchemaFile, composed.publicSdl);
-	console.log(`storefront ${verb}: composed ${publicSchemaFile} (${Buffer.byteLength(composed.publicSdl)} bytes of client schema SDL).`);
+	log.info(`storefront ${verb}: composed ${publicSchemaFile} (${Buffer.byteLength(composed.publicSdl)} bytes of client schema SDL).`);
 	return {
 		supergraphFile,
 		publicSchemaFile
@@ -17930,7 +18302,7 @@ function writeComposedArtifacts(extensionRoot, composed, verb) {
 }
 //#endregion
 //#region ../../apps/storefront-api-core/schema/core.federation.graphql
-var core_federation_default = "# GENERATED by src/schema/emit.ts (pnpm run schema:emit) — do not edit by hand.\n# core version: 0.0.1\nschema\n  @link(url: \"https://specs.apollo.dev/link/v1.0\")\n{\n  query: Query\n  mutation: Mutation\n}\n\nextend schema\n  @link(url: \"https://specs.apollo.dev/federation/v2.9\", import: [\"@key\"])\n\n\"\"\"\nRecords the planned removal date of a deprecated schema element. Pairs with the\nstandard built-in `@deprecated(reason)`: `@deprecated` carries the client-facing\nreason, `@deprecationDate` carries only the machine-readable deletion date. The\nreason is not duplicated here — that would drift from the built-in.\n\nThis replaces the previous redefinition of the built-in `@deprecated` (which\nadded a `deletionDate` argument). Redefining a built-in makes Federation\ncomposition (`wgc compose`) fail, so the deletion date moved to this custom\ndirective. As a non-built-in directive it is dropped during composition rather\nthan rejected. See ADR-00011 and CONTEXT.md. The `@deprecated`/`@deprecationDate`\npairing (both directions) and the future-date rule are enforced by a contract\ntest, not a lint rule.\n\"\"\"\ndirective @deprecationDate(\n  \"\"\"\n  Target removal date in ISO-8601 (YYYY-MM-DD) format. Must be in the future.\n  \"\"\"\n  deletionDate: String!\n) on FIELD_DEFINITION | ARGUMENT_DEFINITION | INPUT_FIELD_DEFINITION | ENUM_VALUE\n\n\"\"\"\nDeclares an HTTP cache policy for a type, field, or interface. Apollo Server\naggregates every hint resolved by a query and emits a single `Cache-Control`\nheader whose `max-age` is the minimum across hints and whose scope is the most\nrestrictive (PRIVATE wins over PUBLIC). Mutations and error responses ignore\nthese hints and always carry `Cache-Control: no-store`.\n\"\"\"\ndirective @cacheControl(\n  \"\"\"Longest time (in seconds) this data may live in a cache.\"\"\"\n  maxAge: Int\n\n  \"\"\"\n  Whether shared caches (CDN, proxy) may store the response. Defaults to\n  PUBLIC when another field or type sets a scope and nothing overrides it.\n  \"\"\"\n  scope: CacheControlScope\n\n  \"\"\"\n  When true, this field inherits its `maxAge` from the parent field rather\n  than contributing its own hint. Useful for wrapper/connection types.\n  \"\"\"\n  inheritMaxAge: Boolean\n) on OBJECT | FIELD_DEFINITION | INTERFACE\n\ndirective @link(url: String, as: String, for: link__Purpose, import: [link__Import]) repeatable on SCHEMA\n\ndirective @key(fields: federation__FieldSet!, resolvable: Boolean = true) repeatable on OBJECT | INTERFACE\n\ndirective @federation__requires(fields: federation__FieldSet!) on FIELD_DEFINITION\n\ndirective @federation__provides(fields: federation__FieldSet!) on FIELD_DEFINITION\n\ndirective @federation__external(reason: String) on OBJECT | FIELD_DEFINITION\n\ndirective @federation__tag(name: String!) repeatable on FIELD_DEFINITION | OBJECT | INTERFACE | UNION | ARGUMENT_DEFINITION | SCALAR | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION | SCHEMA\n\ndirective @federation__extends on OBJECT | INTERFACE\n\ndirective @federation__shareable repeatable on OBJECT | FIELD_DEFINITION\n\ndirective @federation__inaccessible on FIELD_DEFINITION | OBJECT | INTERFACE | UNION | ARGUMENT_DEFINITION | SCALAR | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION\n\ndirective @federation__override(from: String!, label: String) on FIELD_DEFINITION\n\ndirective @federation__composeDirective(name: String) repeatable on SCHEMA\n\ndirective @federation__interfaceObject on OBJECT\n\ndirective @federation__authenticated on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__requiresScopes(scopes: [[federation__Scope!]!]!) on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__policy(policies: [[federation__Policy!]!]!) on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__context(name: String!) repeatable on INTERFACE | OBJECT | UNION\n\ndirective @federation__fromContext(field: federation__ContextFieldValue) on ARGUMENT_DEFINITION\n\ndirective @federation__cost(weight: Int!) on ARGUMENT_DEFINITION | ENUM | FIELD_DEFINITION | INPUT_FIELD_DEFINITION | OBJECT | SCALAR\n\ndirective @federation__listSize(assumedSize: Int, slicingArguments: [String!], sizedFields: [String!], requireOneSlicingArgument: Boolean = true) on FIELD_DEFINITION\n\n\"\"\"Visibility scope for an HTTP cache entry.\"\"\"\nenum CacheControlScope {\n  \"\"\"\n  The response may be stored by shared caches (CDN, proxy) and reused\n  across users.\n  \"\"\"\n  PUBLIC\n\n  \"\"\"\n  The response may only be stored by single-user caches (browser, service\n  worker). Shared caches must not store it.\n  \"\"\"\n  PRIVATE\n}\n\n\"\"\"\nAn [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) encoded UTC datetime.\n\"\"\"\nscalar DateTime\n\n\"\"\"\nAn [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) encoded URI.\n\"\"\"\nscalar URI\n\n\"\"\"A string containing raw HTML markup.\"\"\"\nscalar HTML\n\n\"\"\"\nAn ISO 4217 currency amount represented as a decimal string (e.g. \"29.99\").\n\"\"\"\nscalar Decimal\n\n\"\"\"\nA [BCP 47](https://tools.ietf.org/html/bcp47) language tag (e.g. \"en-US\").\n\"\"\"\nscalar Locale\n\n\"\"\"An opaque cursor used for Relay-style pagination.\"\"\"\nscalar Cursor\n\n\"\"\"\nThe Relay `Node` interface. Every entity in the graph implements this so\nthe client can refetch any object with a single `node(id: ID!)` query.\n\"\"\"\ninterface Node {\n  \"\"\"Globally unique identifier. Base64 of `entityType:rawId`.\"\"\"\n  id: ID!\n}\n\n\"\"\"Metadata about the current page in a Relay connection.\"\"\"\ntype PageInfo {\n  \"\"\"Whether more pages exist after the current page.\"\"\"\n  hasNextPage: Boolean!\n\n  \"\"\"Whether more pages exist before the current page.\"\"\"\n  hasPreviousPage: Boolean!\n\n  \"\"\"Cursor of the first edge in the current page.\"\"\"\n  startCursor: Cursor\n\n  \"\"\"Cursor of the last edge in the current page.\"\"\"\n  endCursor: Cursor\n}\n\n\"\"\"Sort direction for orderBy arguments.\"\"\"\nenum SortDirection {\n  \"\"\"Ascending order.\"\"\"\n  ASC\n\n  \"\"\"Descending order.\"\"\"\n  DESC\n}\n\n\"\"\"Represents a monetary amount with its currency.\"\"\"\ntype Money {\n  \"\"\"Decimal amount (e.g. \"49.99\").\"\"\"\n  amount: Decimal!\n\n  \"\"\"ISO 4217 currency code (e.g. \"USD\", \"BRL\").\"\"\"\n  currencyCode: CurrencyCode!\n}\n\n\"\"\"A price range, useful for showing \"from – to\" on product cards.\"\"\"\ntype PriceRange {\n  \"\"\"Lowest price across all variants.\"\"\"\n  min: Money!\n\n  \"\"\"Highest price across all variants.\"\"\"\n  max: Money!\n}\n\n\"\"\"ISO 4217 currency codes. Extend as needed.\"\"\"\nenum CurrencyCode {\n  \"\"\"United States Dollar.\"\"\"\n  USD\n\n  \"\"\"Euro.\"\"\"\n  EUR\n\n  \"\"\"British Pound Sterling.\"\"\"\n  GBP\n\n  \"\"\"Brazilian Real.\"\"\"\n  BRL\n\n  \"\"\"Argentine Peso.\"\"\"\n  ARS\n\n  \"\"\"Chilean Peso.\"\"\"\n  CLP\n\n  \"\"\"Colombian Peso.\"\"\"\n  COP\n\n  \"\"\"Mexican Peso.\"\"\"\n  MXN\n\n  \"\"\"Peruvian Sol.\"\"\"\n  PEN\n\n  \"\"\"Japanese Yen.\"\"\"\n  JPY\n}\n\n\"\"\"An image resource associated with a product variant or other entity.\"\"\"\ntype Image {\n  \"\"\"Source URL of the image.\"\"\"\n  url: URI!\n\n  \"\"\"Alt text for accessibility.\"\"\"\n  altText: String\n}\n\n\"\"\"A video resource associated with a product.\"\"\"\ntype Video {\n  \"\"\"Playback URL.\"\"\"\n  url: URI!\n\n  \"\"\"Alt text for accessibility.\"\"\"\n  altText: String\n\n  \"\"\"Preview / poster image.\"\"\"\n  previewImage: Image\n}\n\n\"\"\"Any media attached to a product — image or video.\"\"\"\nunion Media = Image | Video\n\n\"\"\"Search engine optimization metadata for any displayable entity.\"\"\"\ntype SEO {\n  \"\"\"Page title (`<title>` tag).\"\"\"\n  title: String\n\n  \"\"\"Meta description.\"\"\"\n  description: String\n}\n\n\"\"\"Root query type for the storefront API.\"\"\"\ntype Query {\n  \"\"\"\n  Fetch any entity by its global ID.\n  Clients use this for refetching or cache normalization.\n  \"\"\"\n  node(\n    \"\"\"The globally unique ID.\"\"\"\n    id: ID!\n  ): Node\n\n  \"\"\"Fetch multiple entities by their global IDs.\"\"\"\n  nodes(\n    \"\"\"A list of globally unique IDs.\"\"\"\n    ids: [ID!]!\n  ): [Node]!\n  _entities(representations: [_Any!]!): [_Entity]!\n  _service: _Service!\n}\n\nextend type Query {\n  \"\"\"Look up a single product by global ID.\"\"\"\n  product(\n    \"\"\"Global product ID.\"\"\"\n    id: ID!\n  ): Product\n\n  \"\"\"Look up a single product by its URL slug.\"\"\"\n  productBySlug(\n    \"\"\"URL-friendly handle (e.g. \\\"nike-zoom-janoski-red\\\").\"\"\"\n    slug: String!\n  ): Product\n\n  \"\"\"Paginated, filterable list of products.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n\n  \"\"\"\n  Full-text product search with facets and filters.\n  Returns the same connection shape but is backed by the search engine\n  rather than the catalog database.\n  \"\"\"\n  productSearch(\n    \"\"\"Search query string.\"\"\"\n    query: String!\n\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductSearchResult!\n\n  \"\"\"\n  Product recommendations based on a seed product (frequently bought\n  together, similar items, etc.).\n  \"\"\"\n  productRecommendations(\n    \"\"\"URL slug of the product to base recommendations on.\"\"\"\n    slug: String!\n\n    \"\"\"The recommendation strategy to use.\"\"\"\n    intent: RecommendationIntent\n\n    \"\"\"Maximum number of recommendations.\"\"\"\n    first: Int = 10\n  ): [Product!]!\n\n  \"\"\"\n  Resolves a catalog route by ID or by path and returns its confirmed localized equivalents.\n  Null when the route does not exist or the catalog could not be reached.\n  \"\"\"\n  catalogRoute(\n    \"\"\"The route to resolve, by ID or by path.\"\"\"\n    input: CatalogRouteInput!\n  ): CatalogRoute\n\n  \"\"\"Look up a single category by global ID.\"\"\"\n  category(\n    \"\"\"Global category ID.\"\"\"\n    id: ID!\n  ): Category\n\n  \"\"\"Look up a category by its URL slug.\"\"\"\n  categoryBySlug(\n    \"\"\"URL-friendly slug.\"\"\"\n    slug: String!\n  ): Category\n\n  \"\"\"\n  The full category tree starting from root departments.\n  Accepts a `maxDepth` to limit tree traversal (default: all levels).\n  \"\"\"\n  categoryTree(\n    \"\"\"Maximum depth of the tree to return. Maps to VTEX `categoryLevels`.\"\"\"\n    maxDepth: Int\n  ): [Category!]!\n\n  \"\"\"Paginated flat list of categories.\"\"\"\n  categories(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: CategorySortingInput\n  ): CategoriesConnection!\n\n  \"\"\"Look up a single brand by global ID.\"\"\"\n  brand(\n    \"\"\"Global brand ID.\"\"\"\n    id: ID!\n  ): Brand\n\n  \"\"\"\n  All brands available in the store, derived from the search index.\n  Returns brands with their product counts.\n  \"\"\"\n  brands(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): BrandsConnection!\n\n  \"\"\"Look up a single sales channel by global ID.\"\"\"\n  salesChannel(\n    \"\"\"Global sales channel ID.\"\"\"\n    id: ID!\n  ): SalesChannel\n\n  \"\"\"\n  Autocomplete suggestions for a partial search query.\n  Returns suggested terms with estimated result counts and facet attributes.\n  \"\"\"\n  autocompleteSuggestions(\n    \"\"\"Partial search query (e.g. \\\"choc\\\").\"\"\"\n    query: String!\n  ): [AutocompleteSuggestion!]!\n\n  \"\"\"The most popular search terms in the last 14 days.\"\"\"\n  topSearches: [TrendingSearch!]!\n\n  \"\"\"\n  Spelling correction for a potentially misspelled search query.\n  Returns null if no correction is available.\n  \"\"\"\n  searchCorrection(\n    \"\"\"The potentially misspelled query.\"\"\"\n    query: String!\n  ): SearchCorrection\n}\n\nextend type Query {\n  \"\"\"\n  Resolve the active cart from the request context (x-order-form-id header,\n  then cookie). When no cart context is present, a new cart is created and\n  the x-order-form-id cookie is set on the response.\n  \"\"\"\n  cart: Cart!\n}\n\nextend type Query {\n  \"\"\"\n  Simulate available shipping options for a variant on a product detail page.\n  Returns delivery options with estimated times and prices for the given\n  postal code and item.\n  \"\"\"\n  shippingSimulation(\n    \"\"\"Simulation input: destination, SKU, quantity, and seller.\"\"\"\n    input: ShippingSimulateInput!\n  ): ShippingSimulationPayload!\n\n  \"\"\"\n  Simulate shipping options for the entire active cart. Reads the cart from the\n  x-order-form-id context and simulates all of its items against the\n  destination, returning the options common to every item with prices summed\n  across items. Never mints a cart: absent context returns a MISSING_CART_CONTEXT\n  userError.\n  \"\"\"\n  cartShippingSimulation(\n    \"\"\"Simulation input: destination only. Items come from the active cart.\"\"\"\n    input: CartShippingSimulateInput!\n  ): CartShippingSimulationPayload!\n}\n\nextend type Query {\n  \"\"\"\n  The shopper's profile for the active cart, resolved from the same order form\n  as `cart`. The entity always resolves; its fields are null when unset.\n  \"\"\"\n  clientProfile: ClientProfile!\n\n  \"\"\"\n  The shopper's preferences for the active cart, resolved from the same order\n  form as `cart`. The entity always resolves; its fields are null when unset.\n  \"\"\"\n  clientPreferences: ClientPreferences!\n}\n\nextend type Query {\n  \"\"\"\n  The cart's shipping state. Projected from the same order form as Query.cart.\n  \"\"\"\n  shipping: Shipping!\n\n  \"\"\"\n  Resolve the shopper's session state from the active order form (x-order-form-id\n  header, then cookie). Projects from the same order form fetch as `cart`.\n  \"\"\"\n  session: Session!\n}\n\nextend type Query {\n  \"\"\"\n  The cart's payment state: methods, selection, installment options, and saved cards. Projected from the same order form as Query.cart. Always resolves; lists are empty and selection fields are null when payment is unset.\n  \"\"\"\n  payment: Payment!\n}\n\nextend type Query {\n  \"\"\"\n  A settled order's payment recap, keyed on the order group\n  paymentStartTransaction / paymentGatewayCallback return. Null when the\n  order group does not resolve to a settled order — never a fabricated empty\n  projection (contrast Query.payment, which always resolves).\n  \"\"\"\n  order(\n    \"\"\"\n    The order group returned by paymentStartTransaction / paymentGatewayCallback.\n    \"\"\"\n    orderGroup: String!\n  ): Order\n}\n\nextend type Query {\n  \"\"\"Which authentication methods this account enables.\"\"\"\n  sessionAuthProviders: SessionAuthProviders!\n}\n\nextend type Query {\n  \"\"\"\n  The shopper's active region, or null when none has been set. Takes no\n  arguments by design: the postal code travels on the transport.\n  \"\"\"\n  region: Region\n}\n\nextend type Query {\n  \"\"\"\n  The signed-in shopper's own persistent profile. Takes no id — the identity\n  comes from the session. Nullable because it is permission-gated (ADR-00005).\n  Null with no error when the session names no shopper. Null with an\n  UNAUTHORIZED, UPSTREAM_ERROR, UPSTREAM_TIMEOUT or CIRCUIT_OPEN error on this\n  field's path when the read fails (ADR-00007), so the rest of the operation\n  still resolves. A profile whose fields are null when the shopper has saved\n  nothing yet.\n  \"\"\"\n  customerProfile: CustomerProfile\n}\n\n\"\"\"\nRoot mutation type. Cart and checkout operations are declared via\n`extend type Mutation` in the checkout module.\n\"\"\"\ntype Mutation {\n  \"\"\"\n  Exists only so `extend type Mutation` in feature modules is valid for schema\n  linters and subgraph composition; not intended for client use.\n  \"\"\"\n  inertMutationPlaceholder: Boolean\n\n  \"\"\"Placeholder field — removed once a real mutation is added via extend.\"\"\"\n  empty: String @deprecated(reason: \"Placeholder — will be dropped when the first real mutation is added.\") @deprecationDate(deletionDate: \"2026-12-31\")\n}\n\nextend type Mutation {\n  \"\"\"\n  Add an item to the cart. If the variant already exists in the cart, its\n  quantity is increased by the given amount.\n  \"\"\"\n  cartItemAdd(\n    \"\"\"Item details to add.\"\"\"\n    input: CartItemAddInput!\n  ): CartItemAddPayload!\n\n  \"\"\"Remove an item from the cart entirely (sets quantity to 0).\"\"\"\n  cartItemRemove(\n    \"\"\"Item to remove.\"\"\"\n    input: CartItemRemoveInput!\n  ): CartItemRemovePayload!\n\n  \"\"\"\n  Remove multiple items from the cart in a single upstream write (each line's\n  quantity is set to 0). Tolerant: variants absent from the cart are skipped.\n  \"\"\"\n  cartItemsRemove(\n    \"\"\"Items to remove.\"\"\"\n    input: CartItemsRemoveInput!\n  ): CartItemsRemovePayload!\n\n  \"\"\"Increase the quantity of an existing cart item.\"\"\"\n  cartItemQuantityIncrease(\n    \"\"\"Item and quantity details.\"\"\"\n    input: CartItemQuantityIncreaseInput!\n  ): CartItemQuantityIncreasePayload!\n\n  \"\"\"\n  Decrease the quantity of an existing cart item.\n  If the resulting quantity would be zero or less, the item is removed.\n  \"\"\"\n  cartItemQuantityDecrease(\n    \"\"\"Item and quantity details.\"\"\"\n    input: CartItemQuantityDecreaseInput!\n  ): CartItemQuantityDecreasePayload!\n\n  \"\"\"\n  Apply a coupon code to the active cart. Appends to the existing set and returns\n  the recomputed cart, or typed errors when the code is rejected.\n  \"\"\"\n  cartCouponApply(\n    \"\"\"Coupon code to apply.\"\"\"\n    input: CartCouponApplyInput!\n  ): CartCouponApplyPayload!\n\n  \"\"\"\n  Remove a coupon code from the active cart. Idempotent when the code is not applied.\n  \"\"\"\n  cartCouponRemove(\n    \"\"\"Coupon code to remove.\"\"\"\n    input: CartCouponRemoveInput!\n  ): CartCouponRemovePayload!\n\n  \"\"\"\n  Re-check the active cart against the platform and return it with each line's\n  availability refreshed. Writes nothing: the cart is re-simulated and only\n  `items.variant.availability` is corrected, so a line the platform can no longer\n  fulfil comes back flagged for the shopper to remove. Quantities are never\n  altered, and totals stay as the cart reported them until that removal\n  recomputes them. Takes no arguments: the cart is resolved from the request\n  context and is never created.\n  \"\"\"\n  cartValidate: CartValidatePayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Write the provided profile fields to the active cart's clientProfileData\n  attachment. Partial: omitted fields are untouched. Never mints a cart.\n  \"\"\"\n  clientProfileUpdate(\n    \"\"\"Profile fields to write.\"\"\"\n    input: ClientProfileUpdateInput!\n  ): ClientProfileUpdatePayload!\n\n  \"\"\"\n  Write the provided preference flags to the active cart's clientPreferencesData\n  attachment. Partial: omitted flags are untouched. Never mints a cart.\n  \"\"\"\n  clientPreferencesUpdate(\n    \"\"\"Preference flags to write.\"\"\"\n    input: ClientPreferencesUpdateInput!\n  ): ClientPreferencesUpdatePayload!\n\n  \"\"\"\n  Set the full delivery address (delivery step). Auto-selects the cheapest SLA\n  when available. Never mints a cart.\n  \"\"\"\n  shippingAddressUpdate(\n    \"\"\"Address details to write.\"\"\"\n    input: ShippingAddressUpdateInput!\n  ): ShippingAddressUpdatePayload!\n\n  \"\"\"\n  Select one shipping option for the whole cart. Fans the selection out to\n  every item. Never mints a cart.\n  \"\"\"\n  shippingOptionSelect(\n    \"\"\"The option to select.\"\"\"\n    input: ShippingOptionSelectInput!\n  ): ShippingOptionSelectPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Select a payment method, optionally identifying a new card's BIN or a saved card's account.\n  \"\"\"\n  paymentMethodSelect(\n    \"\"\"Method (and optional BIN/saved-card) to select.\"\"\"\n    input: PaymentMethodSelectInput!\n  ): PaymentMethodSelectPayload!\n\n  \"\"\"\n  Select an installment count for the currently-selected method. Recomputes the cart total.\n  \"\"\"\n  paymentInstallmentSelect(\n    \"\"\"Installment count to select.\"\"\"\n    input: PaymentInstallmentSelectInput!\n  ): PaymentInstallmentSelectPayload!\n\n  \"\"\"Set the billing address, or fall back to the delivery address.\"\"\"\n  paymentBillingAddressUpdate(\n    \"\"\"\n    Billing address details, or sameAsDelivery: true to use the delivery address.\n    \"\"\"\n    input: PaymentBillingAddressUpdateInput!\n  ): PaymentBillingAddressUpdatePayload!\n\n  \"\"\"\n  Open a VTEX transaction from the currently-selected payment. No input: every field is server-derived.\n  \"\"\"\n  paymentStartTransaction: PaymentStartTransactionPayload!\n\n  \"\"\"\n  Finalize a transaction after the direct-to-gateway payment call succeeded.\n  \"\"\"\n  paymentGatewayCallback(\n    \"\"\"The order group to finalize.\"\"\"\n    input: PaymentGatewayCallbackInput!\n  ): PaymentGatewayCallbackPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Sign in with email and password. Returns the refreshed session, or typed\n  userErrors.\n  \"\"\"\n  sessionLoginWithPassword(\n    \"\"\"The email and password to authenticate with.\"\"\"\n    input: SessionPasswordLoginInput!\n  ): SessionLoginPayload!\n\n  \"\"\"\n  Request an email access code. Returns an opaque authenticationToken to\n  round-trip into validate.\n  \"\"\"\n  sessionRequestAccessCode(\n    \"\"\"The email to send the access code to.\"\"\"\n    input: SessionRequestAccessCodeInput!\n  ): SessionRequestAccessCodePayload!\n\n  \"\"\"\n  Validate an email access code with its authenticationToken. Returns the\n  refreshed session.\n  \"\"\"\n  sessionValidateAccessCode(\n    \"\"\"The email, access code, and authenticationToken to validate.\"\"\"\n    input: SessionValidateAccessCodeInput!\n  ): SessionLoginPayload!\n\n  \"\"\"\n  Sign out. Clears auth cookies and refreshes the order form to a guest session.\n  Idempotent.\n  \"\"\"\n  sessionLogout: SessionLoginPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Set the shopper's active region from a postal code. Accepts the value as the\n  shopper typed it, including any mask; the server normalizes it and derives the\n  city.\n  \"\"\"\n  regionUpdate(\n    \"\"\"The postal code to activate, masked or bare.\"\"\"\n    postalCode: String!\n  ): RegionUpdatePayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Partially update the signed-in shopper's own profile. Upserts: succeeds whether or not a record exists.\n  \"\"\"\n  customerProfileUpdate(\n    \"\"\"The fields to write. Provide only what the shopper edited.\"\"\"\n    input: CustomerProfileUpdateInput!\n  ): CustomerProfileUpdatePayload!\n}\n\n\"\"\"\nA manufacturer or designer brand.\nMaps to VTEX Brand entity.\n\"\"\"\ntype Brand implements Node\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Human-readable brand name.\"\"\"\n  name: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Whether the brand is currently active in the storefront.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Brand logo image.\"\"\"\n  logo: Image\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated list of products belonging to this brand.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n}\n\n\"\"\"Paginated list of brands.\"\"\"\ntype BrandsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [BrandEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of brands matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype BrandEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Brand!\n}\n\n\"\"\"\nA hierarchical product classification level (department → category → subcategory).\nMaps to VTEX Category entity. The tree structure is modeled via parent/children\nreferences, allowing arbitrary depth.\n\"\"\"\ntype Category implements Node\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Display name of the category.\"\"\"\n  name: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Full materialized path, e.g. \\\"/clothing/shirts/casual\\\".\"\"\"\n  path: String!\n\n  \"\"\"Zero-indexed depth in the tree (0 = department).\"\"\"\n  level: Int!\n\n  \"\"\"Whether this category is currently active.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Parent category. Null for top-level departments.\"\"\"\n  parent: Category\n\n  \"\"\"Direct children of this category.\"\"\"\n  children: [Category!]!\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated products within this category.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n\n  \"\"\"Specification groups relevant to this category.\"\"\"\n  specificationGroups: [SpecificationGroup!]!\n}\n\n\"\"\"Paginated list of categories.\"\"\"\ntype CategoriesConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [CategoryEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of categories matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype CategoryEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Category!\n}\n\n\"\"\"\nA group of related specifications that apply to products in a category.\nMaps to VTEX Specification Group.\n\"\"\"\ntype SpecificationGroup {\n  \"\"\"Display name (e.g. \\\"Physical Attributes\\\", \\\"Technical Details\\\").\"\"\"\n  name: String!\n\n  \"\"\"Specifications in this group.\"\"\"\n  specifications: [Specification!]!\n}\n\n\"\"\"\nA product-level or variant-level specification field.\nMaps to VTEX Specification / Specification Field.\nExamples: \"Material\", \"Warranty Period\" (product-level);\n\"Color\", \"Size\" (variant-level / option axis).\n\"\"\"\ntype Specification {\n  \"\"\"Display label (e.g. \\\"Material\\\").\"\"\"\n  name: String!\n\n  \"\"\"The assigned values for this specification.\"\"\"\n  values: [String!]!\n\n  \"\"\"How this spec was captured.\"\"\"\n  fieldType: SpecificationFieldType!\n}\n\n\"\"\"A single breadcrumb entry in the product's navigation trail.\"\"\"\ntype BreadcrumbItem {\n  \"\"\"Human-readable label (e.g. \"Electronics\", \"Smartphones\").\"\"\"\n  name: String!\n\n  \"\"\"URL path for this breadcrumb level (e.g. \"/electronics/smartphones\").\"\"\"\n  url: String!\n\n  \"\"\"1-based position in the breadcrumb trail.\"\"\"\n  position: Int!\n}\n\n\"\"\"\nDiscriminates how a specification value was captured.\nMaps to VTEX FieldType numeric codes.\n\"\"\"\nenum SpecificationFieldType {\n  \"\"\"Free text.\"\"\"\n  TEXT\n\n  \"\"\"Multi-line free text.\"\"\"\n  MULTI_LINE_TEXT\n\n  \"\"\"Single-select dropdown.\"\"\"\n  COMBO\n\n  \"\"\"Single-select radio.\"\"\"\n  RADIO\n\n  \"\"\"Multi-select checkbox.\"\"\"\n  CHECKBOX\n\n  \"\"\"Rich text / HTML.\"\"\"\n  RICH_TEXT\n}\n\n\"\"\"\nA named option axis on a product that differentiates variants.\nThink \"Color\" or \"Size\". Each option has a set of possible values.\nSimilar to Shopify's ProductOption.\n\"\"\"\ntype ProductOption {\n  \"\"\"Option name (e.g. \\\"Color\\\").\"\"\"\n  name: String!\n\n  \"\"\"\n  All values available across variants (e.g. [\\\"Red\\\", \\\"Blue\\\", \\\"Green\\\"]).\n  \"\"\"\n  values: [String!]!\n}\n\n\"\"\"\nA concrete option/value pair selected on a specific variant.\nExample: { name: \"Color\", value: \"Red\" }.\n\"\"\"\ntype SelectedOption {\n  \"\"\"Option axis name.\"\"\"\n  name: String!\n\n  \"\"\"Selected value.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA purchasable unit of a product.\nMaps to VTEX SKU. In commerce, this is the concrete item a customer adds to cart —\na specific size/color/voltage combination of a product.\n\"\"\"\ntype Variant implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Variant display name (e.g. \\\"Varsity Red — Size 10\\\").\"\"\"\n  name: String!\n\n  \"\"\"Stock Keeping Unit code. Unique merchant-side identifier.\"\"\"\n  sku: String!\n\n  \"\"\"\n  PDP path segment in the active locale for this SKU, \"{linkId}-{skuId}\".\n  \"\"\"\n  routeSlug: String!\n\n  \"\"\"International Article Number (barcode). Maps to VTEX SKU EAN.\"\"\"\n  ean: String\n\n  \"\"\"Merchant reference code.\"\"\"\n  referenceId: String\n\n  \"\"\"Whether this variant is currently available for purchase.\"\"\"\n  availableForSale: Boolean!\n\n  \"\"\"Current selling price.\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before promotions. Null when there is no discount.\"\"\"\n  compareAtPrice: Money\n\n  \"\"\"All option selections that define this variant.\"\"\"\n  selectedOptions: [SelectedOption!]!\n\n  \"\"\"Variant images. First image is the primary.\"\"\"\n  images(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ImagesConnection!\n\n  \"\"\"Variant videos.\"\"\"\n  videos: [Video!]!\n\n  \"\"\"Quantity currently in stock. Null when inventory tracking is disabled.\"\"\"\n  quantityAvailable: Int\n\n  \"\"\"Unit of sale (e.g. \\\"un\\\", \\\"kg\\\", \\\"l\\\").\"\"\"\n  measurementUnit: String!\n\n  \"\"\"\n  Multiplier for the measurement unit (e.g. 1.5 means each unit is 1.5 kg).\n  \"\"\"\n  unitMultiplier: Float!\n\n  \"\"\"The parent product.\"\"\"\n  product: Product!\n\n  \"\"\"Variant-level specifications (e.g. voltage, plug type).\"\"\"\n  specifications: [Specification!]!\n\n  \"\"\"Add-on customizations available for this variant.\"\"\"\n  customizations: [Customization!]!\n\n  \"\"\"Sellers that fulfill this variant. Relevant in marketplace scenarios.\"\"\"\n  sellers: [Seller!]!\n}\n\n\"\"\"Paginated list of variants.\"\"\"\ntype VariantsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [VariantEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of variants matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype VariantEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Variant!\n}\n\n\"\"\"\nA product is a generic item in the catalog (e.g. \"Nike Zoom Janoski\").\nEach product has one or more variants (SKUs) that are the purchasable units.\nMaps to the VTEX Product entity.\n\"\"\"\ntype Product implements Node\n  @key(fields: \"slug\")\n  @cacheControl(maxAge: 60, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Product title as displayed in the storefront.\"\"\"\n  title: String!\n\n  \"\"\"URL-friendly handle / slug. Maps to VTEX `LinkId`.\"\"\"\n  slug: String!\n\n  \"\"\"\n  PDP path segment in the active locale, \"{linkId}-{skuId}\" with the representative SKU (in stock first, then lowest\n  spot price, then the first SKU). Build product URLs from this, not from `slug`.\n  \"\"\"\n  routeSlug: String!\n\n  \"\"\"Full marketing description.\"\"\"\n  description: String\n\n  \"\"\"Description rendered as HTML.\"\"\"\n  descriptionHtml: HTML\n\n  \"\"\"Vendor / manufacturer name. Shortcut for brand.name.\"\"\"\n  vendor: String\n\n  \"\"\"Whether this product is currently active on the storefront.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Whether to show the product even when out of stock.\"\"\"\n  showWhenOutOfStock: Boolean!\n\n  \"\"\"Date the product was first published.\"\"\"\n  publishedAt: DateTime\n\n  \"\"\"Release or launch date.\"\"\"\n  releaseDate: DateTime\n\n  \"\"\"Date the product was created in the system.\"\"\"\n  createdAt: DateTime!\n\n  \"\"\"Date the product was last updated.\"\"\"\n  updatedAt: DateTime!\n\n  \"\"\"Merchant reference ID. Maps to VTEX `RefId`.\"\"\"\n  referenceId: String\n\n  \"\"\"The brand this product belongs to.\"\"\"\n  brand: Brand\n\n  \"\"\"The primary (most specific) category.\"\"\"\n  category: Category\n\n  \"\"\"All ancestor categories up to the root department.\"\"\"\n  categories: [Category!]!\n\n  \"\"\"The price range across all variants.\"\"\"\n  priceRange: PriceRange!\n\n  \"\"\"The compare-at (original) price range across all variants.\"\"\"\n  compareAtPriceRange: PriceRange\n\n  \"\"\"Named option axes available on this product (e.g. Color, Size).\"\"\"\n  options: [ProductOption!]!\n\n  \"\"\"Product-level specifications (e.g. material, care instructions).\"\"\"\n  specifications: [Specification!]!\n\n  \"\"\"Specification groups with full detail.\"\"\"\n  specificationGroups: [SpecificationGroup!]!\n\n  \"\"\"All purchasable variants.\"\"\"\n  variants(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): VariantsConnection!\n\n  \"\"\"Total number of variants.\"\"\"\n  totalVariants: Int!\n\n  \"\"\"Product images aggregated from all variants.\"\"\"\n  images(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ImagesConnection!\n\n  \"\"\"All media (images + videos) for this product.\"\"\"\n  media(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 12\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): MediaConnection!\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Navigation breadcrumb trail from root category to this product.\"\"\"\n  breadcrumbs: [BreadcrumbItem!]!\n\n  \"\"\"User-generated review / rating summary.\"\"\"\n  rating: Rating\n\n  \"\"\"\n  Products related to this one (accessories, suggestions). Maps to VTEX SKU Complement.\n  \"\"\"\n  relatedProducts(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ProductsConnection!\n\n  \"\"\"Collections this product belongs to.\"\"\"\n  collections: [Collection!]!\n\n  \"\"\"\n  Sales channels where this product is available. Maps to VTEX Trade Policy.\n  \"\"\"\n  salesChannels: [SalesChannel!]!\n\n  \"\"\"Bundle components if this product is a kit. Maps to VTEX SKU Kit.\"\"\"\n  bundleItems: [BundleItem!]!\n}\n\n\"\"\"Paginated list of products.\"\"\"\ntype ProductsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [ProductEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of products matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype ProductEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Product!\n}\n\n\"\"\"Paginated list of images.\"\"\"\ntype ImagesConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [ImageEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype ImageEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Image!\n}\n\n\"\"\"Paginated list of media.\"\"\"\ntype MediaConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [MediaEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype MediaEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Media!\n}\n\n\"\"\"\nAggregate review/rating summary for a product.\nMaps to VTEX Product Review Rate.\n\"\"\"\ntype Rating {\n  \"\"\"Average score (e.g. 4.3).\"\"\"\n  average: Float!\n\n  \"\"\"Total number of reviews.\"\"\"\n  count: Int!\n}\n\n\"\"\"\nA curated group of products. Maps to VTEX Collection (Beta) entity.\nCollections can be used for seasonal promotions, editorial picks, etc.\n\"\"\"\ntype Collection implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Collection title.\"\"\"\n  title: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Editorial description.\"\"\"\n  description: String\n\n  \"\"\"Whether the collection is currently active.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Hero / banner image.\"\"\"\n  image: Image\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated products in this collection.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n}\n\n\"\"\"Paginated list of collections.\"\"\"\ntype CollectionsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [CollectionEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of collections matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype CollectionEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Collection!\n}\n\n\"\"\"\nA seller / merchant that fulfills orders for one or more variants.\nMaps to VTEX Seller entity.\n\"\"\"\ntype Seller implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Seller display name.\"\"\"\n  name: String!\n\n  \"\"\"Whether this is the default (1P) seller.\"\"\"\n  isDefault: Boolean!\n\n  \"\"\"Seller logo.\"\"\"\n  logo: Image\n\n  \"\"\"\n  The seller's commercial offer for this variant (price, availability, installments).\n  \"\"\"\n  offer: Offer\n}\n\n\"\"\"\nA seller's commercial offer for a specific variant — includes pricing,\navailability, and available payment/installment options.\n\"\"\"\ntype Offer {\n  \"\"\"Current selling price.\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before promotions.\"\"\"\n  listPrice: Money!\n\n  \"\"\"\n  Best cash/immediate-payment price (e.g. Pix discount). Equals price when there is no spot discount.\n  \"\"\"\n  spotPrice: Money!\n\n  \"\"\"Price before any cart-level or coupon discounts.\"\"\"\n  priceWithoutDiscount: Money!\n\n  \"\"\"Available quantity from this seller.\"\"\"\n  availableQuantity: Int!\n\n  \"\"\"Tax amount.\"\"\"\n  tax: Money!\n\n  \"\"\"\n  Tax as a percentage of the price (e.g. 0.18 for 18%). Null when not applicable.\n  \"\"\"\n  taxPercentage: Float\n\n  \"\"\"Loyalty / reward points value earned on this purchase.\"\"\"\n  rewardValue: Float!\n\n  \"\"\"\n  ISO 8601 timestamp after which this price is no longer guaranteed. Null when open-ended.\n  \"\"\"\n  priceValidUntil: DateTime\n\n  \"\"\"SKU IDs of free gifts included with this offer.\"\"\"\n  giftSkuIds: [String!]!\n\n  \"\"\"\n  Named discount labels applied to this offer (e.g. \\\"10% off\\\", \\\"Black Friday\\\").\n  \"\"\"\n  discountHighlights: [String!]!\n\n  \"\"\"Available installment plans grouped by payment method.\"\"\"\n  installmentPlans: [InstallmentPlan!]!\n\n  \"\"\"\n  Active promotions applicable to this offer (e.g. bundle discounts, buy-X-get-Y).\n  \"\"\"\n  promotions: [Promotion!]!\n}\n\n\"\"\"\nA group of installment options for a single payment method (e.g. \"Visa\", \"Pix\").\n\"\"\"\ntype InstallmentPlan {\n  \"\"\"Payment method name (e.g. \\\"Visa\\\", \\\"Mastercard\\\", \\\"Pix\\\").\"\"\"\n  paymentMethod: String!\n\n  \"\"\"Payment method category.\"\"\"\n  paymentType: PaymentType!\n\n  \"\"\"\n  Available installment tiers, sorted by number of installments ascending.\n  \"\"\"\n  installments: [Installment!]!\n}\n\n\"\"\"\nA single installment tier within a payment method.\nExample: 6 × R$ 61.65 at 0% interest.\n\"\"\"\ntype Installment {\n  \"\"\"Number of installments (1 = single payment).\"\"\"\n  count: Int!\n\n  \"\"\"Amount per installment.\"\"\"\n  value: Money!\n\n  \"\"\"Total amount including any interest.\"\"\"\n  totalAmount: Money!\n\n  \"\"\"Annual interest rate as a percentage (0 = interest-free).\"\"\"\n  interestRate: Float!\n\n  \"\"\"Whether this tier is interest-free.\"\"\"\n  interestFree: Boolean!\n}\n\n\"\"\"Broad category of a payment method.\"\"\"\nenum PaymentType {\n  \"\"\"Credit card (Visa, Mastercard, Amex, etc.).\"\"\"\n  CREDIT_CARD\n\n  \"\"\"Debit card.\"\"\"\n  DEBIT_CARD\n\n  \"\"\"Instant / real-time payment (Pix, etc.).\"\"\"\n  INSTANT\n\n  \"\"\"Bank slip / boleto.\"\"\"\n  BANK_SLIP\n\n  \"\"\"Digital wallet or store-specific payment.\"\"\"\n  DIGITAL_WALLET\n\n  \"\"\"Other / unknown payment type.\"\"\"\n  OTHER\n}\n\n\"\"\"\nAn active promotion or incentive applicable to an offer.\nExamples: \"Buy 3 for R$14.99\", \"9% Pix discount\".\n\"\"\"\ntype Promotion {\n  \"\"\"Human-readable promotion name / headline.\"\"\"\n  name: String!\n\n  \"\"\"Conditions that must be met for the promotion to apply.\"\"\"\n  conditions: PromotionConditions!\n\n  \"\"\"Effects applied when conditions are met.\"\"\"\n  effects: PromotionEffects!\n}\n\n\"\"\"Conditions required for a promotion to activate.\"\"\"\ntype PromotionConditions {\n  \"\"\"Minimum quantity of items required (0 = no minimum).\"\"\"\n  minimumQuantity: Int!\n\n  \"\"\"\n  Additional condition parameters (e.g. required payment method, collection membership).\n  \"\"\"\n  parameters: [PromotionParameter!]!\n}\n\n\"\"\"Effects granted when a promotion's conditions are satisfied.\"\"\"\ntype PromotionEffects {\n  \"\"\"Effect parameters describing the discount or benefit.\"\"\"\n  parameters: [PromotionParameter!]!\n}\n\n\"\"\"\nA key-value parameter describing a promotion condition or effect.\nCommon keys: \\\"PercentualDiscount\\\", \\\"MaximumUnitPriceDiscount\\\",\n\\\"PaymentMethodId\\\", \\\"CollectionsIdsList\\\".\n\"\"\"\ntype PromotionParameter {\n  \"\"\"Parameter key.\"\"\"\n  name: String!\n\n  \"\"\"Parameter value.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA trade policy / sales channel through which products are sold.\nMaps to VTEX Trade Policy / Sales Channel.\n\"\"\"\ntype SalesChannel implements Node\n  @cacheControl(maxAge: 3600, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Channel name.\"\"\"\n  name: String!\n\n  \"\"\"ISO 4217 default currency for this channel.\"\"\"\n  currencyCode: CurrencyCode!\n\n  \"\"\"BCP 47 locale for this channel.\"\"\"\n  locale: Locale\n\n  \"\"\"Whether the channel is active.\"\"\"\n  isActive: Boolean!\n}\n\n\"\"\"\nAn optional, free-form customization that can be attached to a variant.\nMaps to VTEX Attachment. Examples: gift wrapping, engraving, custom message.\n\"\"\"\ntype Customization implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Display name (e.g. \\\"Gift Message\\\").\"\"\"\n  name: String!\n\n  \"\"\"Whether this customization is required.\"\"\"\n  isRequired: Boolean!\n\n  \"\"\"Allowed keys and their constraints.\"\"\"\n  fields: [CustomizationField!]!\n}\n\n\"\"\"A single input field within a customization.\"\"\"\ntype CustomizationField {\n  \"\"\"Field key (e.g. \\\"message\\\").\"\"\"\n  key: String!\n\n  \"\"\"Maximum allowed characters.\"\"\"\n  maxLength: Int\n\n  \"\"\"Regex or enum-based validation domain.\"\"\"\n  allowedValues: [String!]\n}\n\n\"\"\"\nA component of a product bundle / kit.\nMaps to VTEX SKU Kit.\n\"\"\"\ntype BundleItem {\n  \"\"\"The variant included in the bundle.\"\"\"\n  variant: Variant!\n\n  \"\"\"Quantity of this variant in the bundle.\"\"\"\n  quantity: Int!\n}\n\n\"\"\"Filter criteria for product queries.\"\"\"\ninput ProductsFilterInput {\n  \"\"\"Full-text search term.\"\"\"\n  searchTerm: String\n\n  \"\"\"Include only products in these category IDs.\"\"\"\n  categoryIds: [ID!]\n\n  \"\"\"Include only products from these brand IDs.\"\"\"\n  brandIds: [ID!]\n\n  \"\"\"Minimum price filter.\"\"\"\n  priceMin: Decimal\n\n  \"\"\"Maximum price filter.\"\"\"\n  priceMax: Decimal\n\n  \"\"\"Include only available (in-stock) products.\"\"\"\n  availableOnly: Boolean\n\n  \"\"\"Filter by product type / taxonomy label.\"\"\"\n  productType: String\n\n  \"\"\"\n  Filter by specification values, e.g. {name: \\\"Color\\\", values: [\\\"Red\\\", \\\"Blue\\\"]}.\n  \"\"\"\n  specifications: [SpecificationFilterInput!]\n\n  \"\"\"Filter by sales channel ID.\"\"\"\n  salesChannelId: ID\n\n  \"\"\"Filter by collection ID.\"\"\"\n  collectionId: ID\n\n  \"\"\"Include only products published after this date.\"\"\"\n  publishedAfter: DateTime\n\n  \"\"\"Include only products published before this date.\"\"\"\n  publishedBefore: DateTime\n\n  \"\"\"Filter by tags / keywords.\"\"\"\n  tags: [String!]\n}\n\n\"\"\"Allows filtering products by specification name and values.\"\"\"\ninput SpecificationFilterInput {\n  \"\"\"Specification name (e.g. \\\"Color\\\").\"\"\"\n  name: String!\n\n  \"\"\"Accepted values (OR semantics within, AND across different specs).\"\"\"\n  values: [String!]!\n}\n\n\"\"\"Sorting input for product queries.\"\"\"\ninput ProductSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: ProductSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting products.\"\"\"\nenum ProductSortField {\n  \"\"\"Alphabetical by title.\"\"\"\n  TITLE\n\n  \"\"\"By price (uses min variant price).\"\"\"\n  PRICE\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n\n  \"\"\"By last update date.\"\"\"\n  UPDATED_AT\n\n  \"\"\"By release date.\"\"\"\n  RELEASE_DATE\n\n  \"\"\"By relevance / scoring.\"\"\"\n  RELEVANCE\n\n  \"\"\"By number of sales.\"\"\"\n  BEST_SELLING\n}\n\n\"\"\"Filter criteria for collection queries.\"\"\"\ninput CollectionsFilterInput {\n  \"\"\"Full-text search term.\"\"\"\n  searchTerm: String\n\n  \"\"\"Include only active collections.\"\"\"\n  activeOnly: Boolean\n}\n\n\"\"\"Sorting input for collection queries.\"\"\"\ninput CollectionSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: CollectionSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting collections.\"\"\"\nenum CollectionSortField {\n  \"\"\"Alphabetical by title.\"\"\"\n  TITLE\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n\n  \"\"\"By last update date.\"\"\"\n  UPDATED_AT\n}\n\n\"\"\"Sorting input for brand queries.\"\"\"\ninput BrandSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: BrandSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting brands.\"\"\"\nenum BrandSortField {\n  \"\"\"Alphabetical by name.\"\"\"\n  NAME\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n}\n\n\"\"\"Sorting input for category queries.\"\"\"\ninput CategorySortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: CategorySortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting categories.\"\"\"\nenum CategorySortField {\n  \"\"\"Alphabetical by name.\"\"\"\n  NAME\n\n  \"\"\"By depth level in the tree.\"\"\"\n  LEVEL\n}\n\n\"\"\"\nThe result of a full-text product search, including facets for building\nfilter UI.\n\"\"\"\ntype ProductSearchResult {\n  \"\"\"Paginated product results.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ProductsConnection!\n\n  \"\"\"Available facets/filters derived from the result set.\"\"\"\n  facets: [SearchFacet!]!\n\n  \"\"\"Corrected or suggested query if the original had a typo.\"\"\"\n  suggestedQuery: String\n\n  \"\"\"Spelling correction details for the query.\"\"\"\n  correction: SearchCorrection\n}\n\n\"\"\"Spelling correction information returned by the search engine.\"\"\"\ntype SearchCorrection {\n  \"\"\"Whether the original query was corrected.\"\"\"\n  corrected: Boolean!\n\n  \"\"\"Whether the original query was misspelled.\"\"\"\n  misspelled: Boolean!\n\n  \"\"\"The corrected query text.\"\"\"\n  text: String\n\n  \"\"\"The corrected text with `<em>` tags highlighting the changed parts.\"\"\"\n  highlighted: String\n}\n\n\"\"\"A facet returned from search, representing a filterable dimension.\"\"\"\ntype SearchFacet {\n  \"\"\"Facet name (e.g. \\\"Brand\\\", \\\"Color\\\", \\\"Price Range\\\").\"\"\"\n  name: String!\n\n  \"\"\"\n  Facet key used in filter parameters (e.g. \\\"brand\\\", \\\"category-1\\\", \\\"price\\\").\n  \"\"\"\n  key: String!\n\n  \"\"\"Type discriminator for rendering the correct UI control.\"\"\"\n  type: SearchFacetType!\n\n  \"\"\"Whether this facet should be hidden from the UI.\"\"\"\n  hidden: Boolean!\n\n  \"\"\"Total number of values in this facet.\"\"\"\n  quantity: Int!\n\n  \"\"\"Individual values within this facet.\"\"\"\n  values: [SearchFacetValue!]!\n}\n\n\"\"\"Discriminates the facet UI control type.\"\"\"\nenum SearchFacetType {\n  \"\"\"A list of discrete values (brand, color, size).\"\"\"\n  LIST\n\n  \"\"\"A numeric range (price).\"\"\"\n  RANGE\n}\n\n\"\"\"A single value within a search facet.\"\"\"\ntype SearchFacetValue {\n  \"\"\"Display label.\"\"\"\n  label: String!\n\n  \"\"\"Value to send back in the filter.\"\"\"\n  value: String!\n\n  \"\"\"Number of products matching this facet value.\"\"\"\n  count: Int!\n\n  \"\"\"Whether the user has currently selected this value.\"\"\"\n  isSelected: Boolean!\n\n  \"\"\"For RANGE facets: the lower bound.\"\"\"\n  rangeFrom: Float\n\n  \"\"\"For RANGE facets: the upper bound.\"\"\"\n  rangeTo: Float\n\n  \"\"\"Navigable href for this facet selection.\"\"\"\n  href: String\n}\n\n\"\"\"Recommendation strategy hint.\"\"\"\nenum RecommendationIntent {\n  \"\"\"Products related by purchase history.\"\"\"\n  RELATED\n\n  \"\"\"Products frequently bought together.\"\"\"\n  COMPLEMENTARY\n\n  \"\"\"Similar products (same category / specs).\"\"\"\n  SIMILAR\n}\n\n\"\"\"An autocomplete suggestion returned for a partial search query.\"\"\"\ntype AutocompleteSuggestion {\n  \"\"\"The suggested search term.\"\"\"\n  term: String!\n\n  \"\"\"Estimated number of results for this term.\"\"\"\n  count: Int!\n\n  \"\"\"\n  Suggested facet filters associated with this term (e.g. department, category).\n  \"\"\"\n  attributes: [AutocompleteAttribute!]!\n}\n\n\"\"\"A facet attribute suggested alongside an autocomplete term.\"\"\"\ntype AutocompleteAttribute {\n  \"\"\"Attribute key (e.g. \\\"category-1\\\").\"\"\"\n  key: String!\n\n  \"\"\"Attribute value (e.g. \\\"alimentos-e-bebidas\\\").\"\"\"\n  value: String!\n\n  \"\"\"Human-readable label for the key (e.g. \\\"Departamento\\\").\"\"\"\n  labelKey: String!\n\n  \"\"\"Human-readable label for the value (e.g. \\\"Alimentos e bebidas\\\").\"\"\"\n  labelValue: String!\n}\n\n\"\"\"A trending search term.\"\"\"\ntype TrendingSearch {\n  \"\"\"The search term.\"\"\"\n  term: String!\n\n  \"\"\"Number of searches in the recent period.\"\"\"\n  count: Int!\n}\n\n\"\"\"Identifies a catalog route. Set exactly one member.\"\"\"\ninput CatalogRouteInput {\n  \"\"\"\n  Relay node ID of the entity behind the route. Only Product IDs are accepted.\n  \"\"\"\n  id: ID\n\n  \"\"\"\n  Logical store route, without the binding's origin or base path\n  (e.g. \"/apparel/t-shirts\", \"/shirt-51/p\").\n  \"\"\"\n  path: String\n}\n\n\"\"\"Kind of entity a catalog route resolves to.\"\"\"\nenum CatalogRouteKind {\n  \"\"\"A product detail page.\"\"\"\n  PRODUCT\n\n  \"\"\"A category or subcategory page.\"\"\"\n  CATEGORY\n\n  \"\"\"A brand page.\"\"\"\n  BRAND\n\n  \"\"\"A collection page.\"\"\"\n  COLLECTION\n}\n\n\"\"\"\nA catalog route and its confirmed equivalents in every locale the catalog registers.\n\"\"\"\ntype CatalogRoute\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"\n  Relay node ID of the entity. Stable across locales; the route's identity.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Kind of entity behind the route.\"\"\"\n  kind: CatalogRouteKind!\n\n  \"\"\"\n  One entry per locale the catalog confirms for every segment of the route. Editorial fallback never adds an\n  entry. May include locales the store does not publish; intersect with the store's bindings.\n  \"\"\"\n  variants: [CatalogRouteVariant!]!\n}\n\n\"\"\"A route's equivalent in one locale.\"\"\"\ntype CatalogRouteVariant {\n  \"\"\"BCP 47 tag, canonicalized.\"\"\"\n  locale: String!\n\n  \"\"\"\n  Route segment(s) in that locale, lowercased, accents kept. Not percent-encoded.\n  \"\"\"\n  slug: String!\n\n  \"\"\"\n  Relative logical path (\"/{slug}\" or \"/{slug}/p\"). No origin, no base path, not percent-encoded.\n  \"\"\"\n  path: String!\n}\n\n\"\"\"\nA shopping cart representing items a customer intends to purchase.\nMaps to the VTEX orderForm entity.\n\"\"\"\ntype Cart implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Globally unique identifier (Relay Node ID).\"\"\"\n  id: ID!\n\n  \"\"\"Line items currently in the cart.\"\"\"\n  items: [CartItem!]!\n\n  \"\"\"Aggregated totals (items, shipping, discounts, etc.).\"\"\"\n  totalizers: [CartTotalizer!]!\n\n  \"\"\"Total cart value.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Server messages from cart processing (e.g. promotions applied, stock warnings).\n  \"\"\"\n  messages: [CartMessage!]!\n\n  \"\"\"\n  The coupon codes currently applied to the cart. Empty when none are applied.\n  \"\"\"\n  appliedCoupons: [AppliedCoupon!]!\n\n  \"\"\"\n  Cart-level discounts as labeled lines: one per promotion or coupon, plus a\n  residual for whatever they do not account for. Always a list (possibly empty),\n  never null.\n  \n  The itemized companion to the aggregated \"Discounts\" totalizer, which stays on\n  `totalizers` unchanged: these entries sum to it, so a summary built on them\n  cannot under-report. Distinct from the per-line `CartItem.discounts`, which is\n  featured-only and itemized per price tag rather than per promotion.\n  \"\"\"\n  discounts: [CartDiscount!]!\n\n  \"\"\"\n  Aggregate item-level catalog markdown: the sum of `(listPrice - price) * quantity`\n  across non-gift lines, clamped at zero (in cents from VTEX, exposed as Money). This\n  is the reduction from each line's list price down to the price the \"Items\" subtotal\n  is built on — the catalog \"de/por\" savings baked into the price before any\n  cart-level promotion runs.\n  \n  Distinct money from the cart-level promotions and coupons on the \"Discounts\"\n  totalizer and `discounts` (those are `price - sellingPrice`, the reduction below the\n  subtotal): item markdown sits *above* the subtotal, so it is never part of\n  `totalizers` and never summed into `total`. It is an informational savings figure and\n  is zero when no line is marked down. Gift lines are excluded — a gift's value is\n  already a promotion entry in `discounts`.\n  \"\"\"\n  itemMarkdownTotal: Money!\n\n  \"\"\"\n  Progress toward the cart's nearest free-shipping promotion. Null when no\n  eligible free-shipping promotion is identified for this cart.\n  \"\"\"\n  freeShippingProgress: FreeShippingProgress\n\n  \"\"\"\n  Non-null when the cart belongs to a different sales channel than the request's active context. The\n  cart is left exactly as it was: nothing here reprices it or removes an item. Converging it is a\n  write, and the first write that carries the active channel makes Checkout reprocess the same\n  orderForm — prices, promotions, coupons and logistics are recomputed and items not sellable in the\n  destination channel are removed by Checkout, while orderFormId, attachments and addresses survive.\n  \"\"\"\n  salesChannelMismatch: CartSalesChannelMismatch\n}\n\n\"\"\"\nThe two sales channels that disagree. Both are trade-policy identifiers.\n\"\"\"\ntype CartSalesChannelMismatch {\n  \"\"\"The channel the cart is currently on.\"\"\"\n  cartSalesChannel: String!\n\n  \"\"\"The channel the request's active context resolves to.\"\"\"\n  activeSalesChannel: String!\n}\n\n\"\"\"\nProgress toward the cart's nearest free-shipping promotion, derived from the\npromotion teasers on a checkout simulation run with the cart's destination.\nNull until the cart has a destination, and when no eligible free-shipping\npromotion is identified for this cart (none configured, none teaser-emitting,\nempty cart, or unreadable promotion data) — absence is a normal state, never\nan error.\n\"\"\"\ntype FreeShippingProgress {\n  \"\"\"\n  Minimum qualifying cart total for the promotion. Null when the cart already\n  qualifies: the promotion teaser disappears once met, so the threshold is no\n  longer reported upstream.\n  \"\"\"\n  threshold: Money\n\n  \"\"\"Amount still to add to qualify. Zero when the cart qualifies.\"\"\"\n  remaining: Money!\n\n  \"\"\"Whether the cart currently qualifies for free shipping.\"\"\"\n  qualified: Boolean!\n}\n\n\"\"\"\nOne labeled cart-level discount line, attributed to the promotion or coupon that\ngranted it. Amounts are summed from the cart's price tags and reconciled against\nthe aggregated \"Discounts\" totalizer.\n\"\"\"\ntype CartDiscount {\n  \"\"\"\n  The promotion's name, or the coupon code exactly as the shopper entered it.\n  Null when nothing upstream names this amount: always for OTHER, and for a\n  promotion the platform left unnamed. The consumer supplies the label in that\n  case; an internal promotion identifier is never exposed here.\n  \"\"\"\n  name: String\n\n  \"\"\"\n  Amount taken off by this line, as a positive monetary value. The minus sign is\n  presentational and applied by the UI. Never zero: a promotion that took nothing\n  off this cart is omitted rather than reported as an empty line.\n  \"\"\"\n  value: Money!\n\n  \"\"\"\n  Where this line came from: an automatic promotion, a coupon, or the residual.\n  \"\"\"\n  kind: CartDiscountKind!\n}\n\n\"\"\"Origin of a cart-level discount line.\"\"\"\nenum CartDiscountKind {\n  \"\"\"An automatically applied promotion.\"\"\"\n  PROMOTION\n\n  \"\"\"A promotion matched by a coupon code the shopper entered.\"\"\"\n  COUPON\n\n  \"\"\"\n  The part of the aggregate discount that no named promotion or coupon accounts\n  for — a promotion the merchant did not feature, a discount the platform never\n  itemized, or rounding. At most one entry, always last.\n  \"\"\"\n  OTHER\n}\n\n\"\"\"\nA coupon code applied to the cart, with whether its promotion conditions matched.\n\"\"\"\ntype AppliedCoupon {\n  \"\"\"The coupon code, stored verbatim as the shopper entered it.\"\"\"\n  code: String!\n\n  \"\"\"\n  True when the code is on the cart but its promotion conditions did not match\n  (no discount granted).\n  \"\"\"\n  isUnmatchedCondition: Boolean!\n}\n\n\"\"\"\nA single line item in the cart. Carries a historical snapshot of the variant\nand product at the time it was added: cart-line value objects describe what\nthe customer actually has, not what the catalog says about it today.\n\"\"\"\ntype CartItem {\n  \"\"\"\n  Cart-scoped line identifier (opaque, stable across mutations for the same line).\n  Encoded as Base64(\"CartItem:<orderFormId>:<uniqueId>\"). Not a Relay Node; this id\n  exists only to serve as a stable cache key for clients doing optimistic UI.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Variant snapshot for this line. Built from the order line itself, not from\n  a live catalog read.\n  \"\"\"\n  variant: CartVariant!\n\n  \"\"\"\n  Product snapshot for this line. Built from the order line itself, not from\n  a live catalog read.\n  \"\"\"\n  product: CartProduct!\n\n  \"\"\"Quantity of this variant in the cart.\"\"\"\n  quantity: Int!\n\n  \"\"\"Unit price (in cents from VTEX, exposed as Money).\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before discounts.\"\"\"\n  listPrice: Money!\n\n  \"\"\"Final selling price after discounts.\"\"\"\n  sellingPrice: Money!\n\n  \"\"\"Whether this line is a gift item.\"\"\"\n  gift: Boolean!\n\n  \"\"\"\n  Discounts applied to this line, one entry per featured promotion price tag that\n  carries a currency amount. Always a list (possibly empty), never null. The\n  per-line, itemized companion to the aggregated \"Discounts\" totalizer on Cart —\n  not a replacement for it.\n  \n  Percentage-configured promotions are absent: their price tag carries a rate\n  rather than an amount, so there is no monetary value to report per line. Use\n  `Cart.discounts` for a breakdown that accounts for every discount, naming what\n  it can and reporting the rest as a residual.\n  \"\"\"\n  discounts: [CartItemDiscount!]!\n\n  \"\"\"\n  Upstream line identifier (order-form uniqueId). The stable per-line address:\n  with customizations, the same variant can appear as several distinct lines,\n  so variantId is not unique per line. Stable across cart mutations.\n  \"\"\"\n  lineId: String!\n\n  \"\"\"\n  This line's own total (own unit selling price × quantity, rounding-exact),\n  excluding composition children.\n  \"\"\"\n  ownTotal: Money!\n\n  \"\"\"\n  This line's total including all nested composition children, recursively.\n  Equals ownTotal when the line has no compositions.\n  \"\"\"\n  total: Money!\n\n  \"\"\"\n  Form-based customizations applied to this line (personalization text,\n  selections, uploaded-file URLs). Empty when the line has none.\n  \"\"\"\n  customizations: [CartItemCustomization!]!\n\n  \"\"\"\n  Child products added to this line by bundle/assembly choices. Children are\n  not top-level cart lines; they ship, and are removed, with their parent.\n  \"\"\"\n  compositions: [CartItemComposition!]!\n\n  \"\"\"\n  The cart-wide delivery options this item is eligible for: the same ShippingOption\n  entities Shipping.options lists, carrying the shared-pool price, not a per-item\n  quote. Excludes pickup options; delivery channel only.\n  \"\"\"\n  shippingOptions: [ShippingOption!]!\n\n  \"\"\"\n  This item's own currently selected delivery option, or null when no selection\n  is persisted or the persisted selection is a pickup option.\n  \"\"\"\n  selectedShippingOption: ItemShippingOption\n}\n\n\"\"\"\nOne customization group applied to a cart line, keyed by the upstream\nassembly id. Entries are the shopper's submitted key/value pairs.\n\"\"\"\ntype CartItemCustomization {\n  \"\"\"Upstream assembly identifier (e.g. \"Engraving\", \"Optional features\").\"\"\"\n  id: String!\n\n  \"\"\"\n  Submitted values, one entry per input field. File uploads carry the file URL\n  as the value.\n  \"\"\"\n  entries: [CartItemCustomizationEntry!]!\n}\n\n\"\"\"A single submitted customization field.\"\"\"\ntype CartItemCustomizationEntry\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Field name as defined by the assembly (e.g. \"Text\").\"\"\"\n  name: String!\n\n  \"\"\"Submitted value, stringified. File uploads carry the file URL.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA child product nested under a cart line by a bundle/assembly choice. Slim by\ndesign: children are not independently addressable cart lines. May carry its\nown children (nested assemblies).\n\"\"\"\ntype CartItemComposition {\n  \"\"\"\n  Cart-scoped identifier for this child line (same opaque encoding as\n  CartItem.id). Cache key only; not independently mutable.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Display name as recorded on the order line.\"\"\"\n  name: String!\n\n  \"\"\"Quantity of this child in the composition.\"\"\"\n  quantity: Int!\n\n  \"\"\"Unit selling price of the child.\"\"\"\n  price: Money!\n\n  \"\"\"\n  The child's own availability. The parent's variant.availability already\n  reflects the worst state across the whole composition.\n  \"\"\"\n  availability: CartItemAvailability!\n\n  \"\"\"\n  The assembly group that added this child (upstream parentAssemblyBinding,\n  e.g. \"Material Product_Material\").\n  \"\"\"\n  assemblyId: String!\n\n  \"\"\"This child's own total, excluding its nested children.\"\"\"\n  ownTotal: Money!\n\n  \"\"\"This child's total including its nested children, recursively.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Form-based customizations applied to this child. A composition child is\n  itself an order-form line and can carry its own input assemblies. Empty\n  when it has none.\n  \"\"\"\n  customizations: [CartItemCustomization!]!\n\n  \"\"\"Nested composition children of this child. Empty when it has none.\"\"\"\n  compositions: [CartItemComposition!]!\n}\n\n\"\"\"\nA single discount applied to a cart line, broken out from that line's price tags.\nSourced from items[].priceTags filtered to featured promotions carrying a currency\namount; the aggregate discount total stays on the Cart \"Discounts\" totalizer.\n\"\"\"\ntype CartItemDiscount {\n  \"\"\"\n  Human-readable label resolved from the matched promotion (e.g. \"Black Friday\").\n  Falls back to the price tag identifier when the promotion has no name.\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Amount taken off by this discount, as a positive monetary value. The minus\n  sign is presentational and applied by the UI.\n  \"\"\"\n  value: Money!\n\n  \"\"\"\n  Always false. A price tag expressing a percentage carries a rate rather than a\n  currency amount, so it has no value this type can report and is excluded from\n  the list. Retained for compatibility; branching on it gains nothing.\n  \"\"\"\n  isPercentual: Boolean!\n}\n\n\"\"\"\nStock availability status for a cart line. Mapped from the upstream\norder-form availability strings; UNKNOWN absorbs values we haven't classified.\n\"\"\"\nenum CartItemAvailability {\n  \"\"\"In stock and shippable.\"\"\"\n  AVAILABLE\n\n  \"\"\"Known to be out of stock.\"\"\"\n  OUT_OF_STOCK\n\n  \"\"\"\n  Other known-bad states (cannot deliver, fulfillment unavailable, etc.).\n  \"\"\"\n  UNAVAILABLE\n\n  \"\"\"Upstream returned a state we don't recognize yet.\"\"\"\n  UNKNOWN\n}\n\n\"\"\"\nCart-line snapshot of a Variant. Value object: holds the line-level facts\nrecorded at add-to-cart time. Does not implement Node; refetch the live\ncatalog Variant via Query.node(variantId) when needed.\n\"\"\"\ntype CartVariant {\n  \"\"\"\n  Relay Node ID of the catalog Variant this line refers to. Use it with\n  Query.node to refetch the live Variant.\n  \"\"\"\n  variantId: ID!\n\n  \"\"\"Stock-keeping unit code as recorded on the order line.\"\"\"\n  sku: String!\n\n  \"\"\"\n  Display name as recorded on the order line (e.g. \"Classic T-Shirt - Red / M\").\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Single image captured at add-to-cart time. Null when no image URL was recorded.\n  \"\"\"\n  image: Image\n\n  \"\"\"\n  International Article Number (barcode). May be empty for items without one.\n  \"\"\"\n  ean: String\n\n  \"\"\"Merchant SKU reference code.\"\"\"\n  referenceId: String\n\n  \"\"\"Availability classification of this line.\"\"\"\n  availability: CartItemAvailability!\n\n  \"\"\"Unit of sale (e.g. \"un\", \"kg\").\"\"\"\n  measurementUnit: String!\n\n  \"\"\"Multiplier for the measurement unit.\"\"\"\n  unitMultiplier: Float!\n\n  \"\"\"Seller fulfilling this line.\"\"\"\n  seller: CartSellerRef!\n\n  \"\"\"\n  Variations selected on this cart line (e.g. Cor: Vermelho, Tamanho: M). [] when the SKU has\n  no variations, never null. Resolved server-side from catalog data (ADR-00012); use this field\n  instead of a Query.node(variantId) refetch to read a line's selected options.\n  \"\"\"\n  selectedOptions: [SelectedOption!]!\n}\n\n\"\"\"\nCart-line snapshot of a Product. Value object: holds the line-level facts\nrecorded at add-to-cart time. Does not implement Node; refetch the live\ncatalog Product via Query.node(productId) when needed.\n\"\"\"\ntype CartProduct {\n  \"\"\"\n  Relay Node ID of the catalog Product. Use it with Query.node to refetch\n  the live Product.\n  \"\"\"\n  productId: ID!\n\n  \"\"\"Product title as recorded on the order line.\"\"\"\n  title: String!\n\n  \"\"\"Product detail URL as recorded on the order line.\"\"\"\n  detailUrl: String!\n\n  \"\"\"Categories root-to-leaf as recorded on the order line.\"\"\"\n  categories: [CartCategoryRef!]!\n\n  \"\"\"\n  Brand reference as recorded on the order line. Null when the product has no brand.\n  \"\"\"\n  brand: CartBrandRef\n}\n\n\"\"\"\nLightweight reference to a Category captured on a cart line. Carries enough\nidentity to deep-link back to the live Category via Query.node.\n\"\"\"\ntype CartCategoryRef {\n  \"\"\"Relay Node ID of the catalog Category.\"\"\"\n  categoryId: ID!\n\n  \"\"\"Category name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"Lightweight reference to a Brand captured on a cart line.\"\"\"\ntype CartBrandRef {\n  \"\"\"Relay Node ID of the catalog Brand.\"\"\"\n  brandId: ID!\n\n  \"\"\"Brand name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"Lightweight reference to a Seller captured on a cart line.\"\"\"\ntype CartSellerRef {\n  \"\"\"Relay Node ID of the catalog Seller.\"\"\"\n  sellerId: ID!\n\n  \"\"\"Seller display name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"\nAn aggregated total section in the cart (e.g. Items, Shipping, Discounts).\n\"\"\"\ntype CartTotalizer {\n  \"\"\"Totalizer key (e.g. \"Items\", \"Shipping\", \"Discounts\").\"\"\"\n  id: String!\n\n  \"\"\"Human-readable label.\"\"\"\n  name: String!\n\n  \"\"\"Totalizer value.\"\"\"\n  value: Money!\n}\n\n\"\"\"\nA server message attached to the cart (promotions applied, warnings, etc.).\n\"\"\"\ntype CartMessage {\n  \"\"\"Message code identifier.\"\"\"\n  code: String\n\n  \"\"\"Human-readable message text.\"\"\"\n  text: String!\n\n  \"\"\"Message severity (e.g. \"info\", \"warning\", \"error\").\"\"\"\n  status: String!\n}\n\n\"\"\"Input for adding an item to a cart.\"\"\"\ninput CartItemAddInput {\n  \"\"\"The variant's global Node ID to add.\"\"\"\n  variantId: ID!\n\n  \"\"\"Quantity to add. Defaults to 1.\"\"\"\n  quantity: Int = 1\n\n  \"\"\"\n  The seller's global Node ID. Defaults to the first-party seller (Seller:1).\n  \"\"\"\n  seller: ID = \"U2VsbGVyOjE=\"\n}\n\n\"\"\"Input for removing an item from a cart.\"\"\"\ninput CartItemRemoveInput {\n  \"\"\"The variant's global Node ID to remove.\"\"\"\n  variantId: ID!\n}\n\n\"\"\"Input for removing multiple items from a cart in one call.\"\"\"\ninput CartItemsRemoveInput {\n  \"\"\"The variants' global Node IDs to remove. Duplicates are collapsed.\"\"\"\n  variantIds: [ID!]!\n}\n\n\"\"\"Input for increasing the quantity of a cart item.\"\"\"\ninput CartItemQuantityIncreaseInput {\n  \"\"\"The variant's global Node ID whose quantity to increase.\"\"\"\n  variantId: ID!\n\n  \"\"\"Amount to add to the current quantity. Defaults to 1.\"\"\"\n  quantityToAdd: Int = 1\n}\n\n\"\"\"Input for decreasing the quantity of a cart item.\"\"\"\ninput CartItemQuantityDecreaseInput {\n  \"\"\"The variant's global Node ID whose quantity to decrease.\"\"\"\n  variantId: ID!\n\n  \"\"\"Amount to subtract from the current quantity. Defaults to 1.\"\"\"\n  quantityToRemove: Int = 1\n}\n\n\"\"\"Input for applying a coupon code to the cart.\"\"\"\ninput CartCouponApplyInput {\n  \"\"\"The coupon code to apply, sent verbatim.\"\"\"\n  code: String!\n}\n\n\"\"\"Input for removing a coupon code from the cart.\"\"\"\ninput CartCouponRemoveInput {\n  \"\"\"The coupon code to remove from the applied set.\"\"\"\n  code: String!\n}\n\n\"\"\"Error codes for cart item add operations.\"\"\"\nenum CartItemAddErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n\n  \"\"\"The provided seller ID is not a valid Seller Node ID.\"\"\"\n  INVALID_SELLER_ID\n}\n\n\"\"\"Error codes for cart item remove operations.\"\"\"\nenum CartItemRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The specified variant was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n}\n\n\"\"\"Error codes for cart items batch remove operations.\"\"\"\nenum CartItemsRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"None of the specified variants were found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"A provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n\n  \"\"\"The input contained no variant IDs.\"\"\"\n  NO_VARIANT_IDS_PROVIDED\n\n  \"\"\"The upstream checkout API returned an unusable response.\"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"Error codes for cart item quantity increase operations.\"\"\"\nenum CartItemQuantityIncreaseErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The specified variant was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n}\n\n\"\"\"Error codes for cart item quantity decrease operations.\"\"\"\nenum CartItemQuantityDecreaseErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The specified variant was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n}\n\n\"\"\"A domain error returned from a cart item add mutation.\"\"\"\ntype CartItemAddError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemAddErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item remove mutation.\"\"\"\ntype CartItemRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart items batch remove mutation.\"\"\"\ntype CartItemsRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemsRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item quantity increase mutation.\"\"\"\ntype CartItemQuantityIncreaseError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemQuantityIncreaseErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item quantity decrease mutation.\"\"\"\ntype CartItemQuantityDecreaseError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemQuantityDecreaseErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartItemAdd mutation.\"\"\"\ntype CartItemAddPayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemAddError!]!\n}\n\n\"\"\"Payload returned by the cartItemRemove mutation.\"\"\"\ntype CartItemRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemRemoveError!]!\n}\n\n\"\"\"Payload returned by the cartItemsRemove mutation.\"\"\"\ntype CartItemsRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemsRemoveError!]!\n}\n\n\"\"\"Payload returned by the cartItemQuantityIncrease mutation.\"\"\"\ntype CartItemQuantityIncreasePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemQuantityIncreaseError!]!\n}\n\n\"\"\"Payload returned by the cartItemQuantityDecrease mutation.\"\"\"\ntype CartItemQuantityDecreasePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemQuantityDecreaseError!]!\n}\n\n\"\"\"Error codes for cart coupon apply operations.\"\"\"\nenum CartCouponApplyErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The coupon code is empty, unknown, or not accepted by this cart.\"\"\"\n  COUPON_NOT_FOUND\n\n  \"\"\"The coupon code has expired.\"\"\"\n  COUPON_EXPIRED\n}\n\n\"\"\"Error codes for cart coupon remove operations.\"\"\"\nenum CartCouponRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  A surviving coupon was rejected by the cart after the removal (unknown or not accepted).\n  \"\"\"\n  COUPON_NOT_FOUND\n\n  \"\"\"A surviving coupon has expired.\"\"\"\n  COUPON_EXPIRED\n}\n\n\"\"\"A domain error returned from a cart coupon apply mutation.\"\"\"\ntype CartCouponApplyError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartCouponApplyErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart coupon remove mutation.\"\"\"\ntype CartCouponRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartCouponRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartCouponApply mutation.\"\"\"\ntype CartCouponApplyPayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartCouponApplyError!]!\n}\n\n\"\"\"Payload returned by the cartCouponRemove mutation.\"\"\"\ntype CartCouponRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartCouponRemoveError!]!\n}\n\n\"\"\"Error codes for cart validation operations.\"\"\"\nenum CartValidateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  The upstream checkout API could not be reached or returned an unusable response.\n  \"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"A domain error returned from a cart validate mutation.\"\"\"\ntype CartValidateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartValidateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartValidate mutation.\"\"\"\ntype CartValidatePayload {\n  \"\"\"The re-checked cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartValidateError!]!\n}\n\n\"\"\"The delivery channel for a shipping option.\"\"\"\nenum DeliveryChannel {\n  \"\"\"Home delivery.\"\"\"\n  DELIVERY\n\n  \"\"\"Pickup in store or pickup point.\"\"\"\n  PICKUP\n\n  \"\"\"Unrecognised delivery channel returned by the fulfillment provider.\"\"\"\n  UNKNOWN\n}\n\n\"\"\"The unit of a shipping time estimate.\"\"\"\nenum ShippingEstimateUnit {\n  \"\"\"Calendar days (e.g. \"7d\").\"\"\"\n  DAYS\n\n  \"\"\"Business days, excluding weekends and holidays (e.g. \"5bd\").\"\"\"\n  BUSINESS_DAYS\n\n  \"\"\"Hours (e.g. \"7h\").\"\"\"\n  HOURS\n\n  \"\"\"Minutes (e.g. \"119m\").\"\"\"\n  MINUTES\n}\n\n\"\"\"\nParsed shipping time estimate (e.g. \"5bd\" → { value: 5, unit: BUSINESS_DAYS }).\n\"\"\"\ntype ShippingEstimate {\n  \"\"\"Numeric quantity of the estimate.\"\"\"\n  value: Int!\n\n  \"\"\"Time unit for the estimate.\"\"\"\n  unit: ShippingEstimateUnit!\n}\n\n\"\"\"\nOne cart item's current selection. Its price and estimate are Checkout's real values for\nthis item; option carries the shared name and channel. All values are a live snapshot:\nanother item joining or leaving the same SLA can change them.\n\"\"\"\ntype ItemShippingOption {\n  \"\"\"\n  Opaque delivery option identifier, encoded to distinguish per-item options\n  from cart-wide options so the Apollo cache never conflates them.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The cart-wide shipping option this selection belongs to.\"\"\"\n  option: ShippingOption!\n\n  \"\"\"Estimated shipping time for this item.\"\"\"\n  shippingEstimate: ShippingEstimate!\n\n  \"\"\"Shipping cost for this item. Zero when free shipping applies.\"\"\"\n  price: Money!\n\n  \"\"\"Shipping list price for this item before any promotions.\"\"\"\n  listPrice: Money!\n}\n\n\"\"\"\nA shipping option with at least one cart item currently selected on it. Its price and\nshippingEstimateList cover only those items, recomputed on every request.\n\"\"\"\ntype SelectedShippingOption {\n  \"\"\"The cart-wide shipping option these items selected.\"\"\"\n  option: ShippingOption!\n\n  \"\"\"\n  Cart items currently selected on this option (not every eligible item).\n  \"\"\"\n  items: [CartItem!]!\n\n  \"\"\"Sum of items[].selectedShippingOption.price.\"\"\"\n  price: Money!\n\n  \"\"\"Sum of items[].selectedShippingOption.listPrice.\"\"\"\n  listPrice: Money!\n\n  \"\"\"\n  items[].selectedShippingOption.shippingEstimate, one entry per item, unreduced and\n  uncompared.\n  \"\"\"\n  shippingEstimateList: [ShippingEstimate!]!\n}\n\n\"\"\"A shipping option available for a given item and destination.\"\"\"\ntype ShippingOption {\n  \"\"\"Opaque delivery option identifier.\"\"\"\n  id: ID!\n\n  \"\"\"\n  Human-readable option name (e.g. \"Standard Delivery\"). Derived from a Checkout simulation, which\n  sends no `Accept-Language` and keys its SKU cache without a locale, so this text is NOT localized:\n  it may read in the account's default culture on a non-default binding.\n  \"\"\"\n  name: String!\n\n  \"\"\"Delivery channel: home delivery or pickup.\"\"\"\n  channel: DeliveryChannel!\n\n  \"\"\"\n  Estimated shipping time, sampled from one eligible item. Delivery estimates can genuinely vary\n  per item under the same option; use shippingEstimateList for every item's own value.\n  \"\"\"\n  shippingEstimate: ShippingEstimate! @deprecated(reason: \"Sampled from one item and can misrepresent the others. Use shippingEstimateList.\") @deprecationDate(deletionDate: \"2027-03-31\")\n\n  \"\"\"\n  Every eligible item's own shippingEstimate, one entry per item, unreduced and uncompared.\n  \"\"\"\n  shippingEstimateList: [ShippingEstimate!]!\n\n  \"\"\"\n  Shipping cost for every item this option covers. Zero when free shipping applies. A live\n  estimate of the shared per-SLA pool, not a guaranteed quote.\n  \"\"\"\n  price: Money!\n\n  \"\"\"Shipping list price before any promotions, summed like price.\"\"\"\n  listPrice: Money!\n\n  \"\"\"Cart items for which this option is currently available.\"\"\"\n  items: [CartItem!]!\n}\n\n\"\"\"Error codes for shipping simulation operations.\"\"\"\nenum ShippingSimulateErrorCode {\n  \"\"\"The postal code was not found or rejected by the fulfillment provider.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n\n  \"\"\"The provided seller ID is not a valid Seller Node ID.\"\"\"\n  INVALID_SELLER_ID\n\n  \"\"\"\n  No active cart in context: the cartShippingSimulation query requires an x-order-form-id and never mints a cart.\n  \"\"\"\n  MISSING_CART_CONTEXT\n}\n\n\"\"\"A domain error returned from the shippingSimulation query.\"\"\"\ntype ShippingSimulateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingSimulateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingSimulation query.\"\"\"\ntype ShippingSimulationPayload {\n  \"\"\"\n  Available shipping options for the given item and destination.\n  Null when userErrors is non-empty.\n  \"\"\"\n  shippingOptions: [ShippingOption!]\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingSimulateError!]!\n}\n\n\"\"\"Input for simulating shipping options for a single variant on a PDP.\"\"\"\ninput ShippingSimulateInput {\n  \"\"\"Postal code of the delivery destination.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n\n  \"\"\"The variant's global Node ID to simulate shipping for.\"\"\"\n  variantId: ID!\n\n  \"\"\"Quantity of the variant. Must be at least 1.\"\"\"\n  quantity: Int!\n\n  \"\"\"The seller's global Node ID responsible for the variant.\"\"\"\n  seller: ID!\n}\n\n\"\"\"\nInput for simulating shipping for the whole active cart. Carries the\ndestination only; items are sourced from the cart in the x-order-form-id\ncontext, so there is no variant, quantity, or seller.\n\"\"\"\ninput CartShippingSimulateInput {\n  \"\"\"Postal code of the delivery destination.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n}\n\n\"\"\"Payload returned by the cartShippingSimulation query.\"\"\"\ntype CartShippingSimulationPayload {\n  \"\"\"\n  Shipping options available for every item in the cart, prices summed across\n  items. Empty when the cart is empty or no option is common to all items.\n  Null when userErrors is non-empty.\n  \"\"\"\n  shippingOptions: [ShippingOption!]\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingSimulateError!]!\n}\n\n\"\"\"\nThe shopper's profile, projected from the order form's clientProfileData.\nA sibling of Cart, not nested under it. Individual (B2C) only.\n\"\"\"\ntype ClientProfile implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Contact email as recorded on the order form. Null when no profile is set.\n  \"\"\"\n  email: String\n\n  \"\"\"Given name. Null when unset.\"\"\"\n  firstName: String\n\n  \"\"\"Family name. Null when unset.\"\"\"\n  lastName: String\n\n  \"\"\"Contact phone in the order form's stored format. Null when unset.\"\"\"\n  phone: String\n\n  \"\"\"Tax document (CPF for Individual shoppers). Null when unset.\"\"\"\n  document: String\n}\n\n\"\"\"\nThe shopper's preference opt-ins, projected from the order form's\nclientPreferencesData. A sibling of Cart, not nested under it.\n\"\"\"\ntype ClientPreferences implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Newsletter opt-in. Null when the shopper has not chosen.\"\"\"\n  optinNewsLetter: Boolean\n\n  \"\"\"Save-personal-data opt-in. Null when the shopper has not chosen.\"\"\"\n  savePersonalData: Boolean\n}\n\n\"\"\"\nPartial profile update. Provide only the fields to write; omitted fields are\nleft unchanged.\n\"\"\"\ninput ClientProfileUpdateInput {\n  \"\"\"Contact email to write. Omit to leave unchanged.\"\"\"\n  email: String\n\n  \"\"\"Given name to write. Omit to leave unchanged.\"\"\"\n  firstName: String\n\n  \"\"\"Family name to write. Omit to leave unchanged.\"\"\"\n  lastName: String\n\n  \"\"\"Contact phone to write. Omit to leave unchanged.\"\"\"\n  phone: String\n\n  \"\"\"Tax document to write. Omit to leave unchanged.\"\"\"\n  document: String\n}\n\n\"\"\"\nPartial preferences update. Provide only the flags to write; omitted flags are\nleft unchanged.\n\"\"\"\ninput ClientPreferencesUpdateInput {\n  \"\"\"Newsletter opt-in to write. Omit to leave unchanged.\"\"\"\n  optinNewsLetter: Boolean\n\n  \"\"\"Save-personal-data opt-in to write. Omit to leave unchanged.\"\"\"\n  savePersonalData: Boolean\n}\n\n\"\"\"Error codes for client profile update operations.\"\"\"\nenum ClientProfileUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The input contained no profile fields to write.\"\"\"\n  NO_PROFILE_FIELD_PROVIDED\n}\n\n\"\"\"Error codes for client preferences update operations.\"\"\"\nenum ClientPreferencesUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The input contained no preferences to write.\"\"\"\n  NO_PREFERENCE_PROVIDED\n}\n\n\"\"\"A domain error returned from a client profile update mutation.\"\"\"\ntype ClientProfileUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ClientProfileUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a client preferences update mutation.\"\"\"\ntype ClientPreferencesUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ClientPreferencesUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the clientProfileUpdate mutation.\"\"\"\ntype ClientProfileUpdatePayload {\n  \"\"\"The updated profile, or null if a context/validation error occurred.\"\"\"\n  clientProfile: ClientProfile\n\n  \"\"\"\n  The session after the write, reflecting the now-current isIdentified derived from\n  clientProfileData.email. Null alongside clientProfile on a context/validation error.\n  \"\"\"\n  session: Session\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ClientProfileUpdateError!]!\n}\n\n\"\"\"Payload returned by the clientPreferencesUpdate mutation.\"\"\"\ntype ClientPreferencesUpdatePayload {\n  \"\"\"\n  The updated preferences, or null if a context/validation error occurred.\n  \"\"\"\n  clientPreferences: ClientPreferences\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ClientPreferencesUpdateError!]!\n}\n\n\"\"\"\nThe delivery address, saved addresses, and shipping options for the cart.\nA read-only sibling of Cart, projected from the same order form fetch.\nNull fields project explicitly (never undefined), allowing partial queries.\n\"\"\"\ntype Shipping implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The delivery address on the cart. Null until the shopper provides one.\"\"\"\n  address: Address\n\n  \"\"\"The logged-in shopper's saved addresses. Empty for anonymous shoppers.\"\"\"\n  savedAddresses: [Address!]!\n\n  \"\"\"\n  Delivery-channel shipping options any cart item is eligible for at the current address, prices summed across the eligible items.\n  \"\"\"\n  options: [ShippingOption!]!\n\n  \"\"\"\n  Delivery-channel options with at least one item currently selected on them, one entry per option. Pickup selections are excluded.\n  \"\"\"\n  selectedOptions: [SelectedShippingOption!]!\n\n  \"\"\"\n  The selected option, when one selection applies to the whole cart. Null when items disagree or the persisted selection is a pickup-channel SLA.\n  \"\"\"\n  selectedOptionId: ID @deprecated(reason: \"Cannot express split shipping. Use Shipping.selectedOptions.\") @deprecationDate(deletionDate: \"2027-03-31\")\n}\n\n\"\"\"A delivery address or saved-address reference.\"\"\"\ntype Address\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Saved-address reference. Null for addresses entered in this session.\"\"\"\n  id: ID\n\n  \"\"\"Recipient name for this address.\"\"\"\n  recipientName: String\n\n  \"\"\"\n  Postal code. Required when persisting an address via the mutation inputs, but nullable here:\n  pickup/search/disposable addresses and legacy saved addresses can come back without one.\n  \"\"\"\n  postalCode: String\n\n  \"\"\"\n  ISO 3166-1 alpha-3 country code. Required when persisting an address via the mutation inputs,\n  but nullable here for the same reason as postalCode.\n  \"\"\"\n  country: String\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n}\n\n\"\"\"\nThe shopper's session and authentication state for the active order form.\nA read-only sibling of Cart, projected from the same order form fetch. Carries\nno profile data — profile fields live on ClientProfile.\n\"\"\"\ntype Session implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Whether the shopper holds an authenticated VTEX session. A guest is `false` — a normal state, never an error.\n  \"\"\"\n  loggedIn: Boolean!\n\n  \"\"\"\n  Whether the shopper may edit their identity data. Lets Controls render editable vs. identified-but-masked fields.\n  \"\"\"\n  canEditData: Boolean!\n\n  \"\"\"\n  Server-computed: whether a profile is attached to the order form (clientProfileData.email is present and non-empty). Identification is distinct from authentication.\n  \"\"\"\n  isIdentified: Boolean!\n}\n\n\"\"\"Input for updating the delivery address on the cart.\"\"\"\ninput ShippingAddressUpdateInput {\n  \"\"\"\n  Saved address reference. Present when the shopper picked (and possibly edited) a saved address.\n  \"\"\"\n  savedAddressId: ID\n\n  \"\"\"Recipient name for the delivery address.\"\"\"\n  recipientName: String!\n\n  \"\"\"Postal code for the delivery address.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n}\n\n\"\"\"Error codes for shipping address update operations.\"\"\"\nenum ShippingAddressUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The recipient name is blank.\"\"\"\n  MISSING_RECIPIENT_NAME\n\n  \"\"\"The provided saved address ID does not match any available addresses.\"\"\"\n  INVALID_SAVED_ADDRESS_ID\n\n  \"\"\"The postal code is invalid or not found.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The address is invalid.\"\"\"\n  INVALID_ADDRESS\n}\n\n\"\"\"A domain error returned from a shipping address update mutation.\"\"\"\ntype ShippingAddressUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingAddressUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingAddressUpdate mutation.\"\"\"\ntype ShippingAddressUpdatePayload {\n  \"\"\"The updated shipping state, or null if errors occurred.\"\"\"\n  shipping: Shipping\n\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingAddressUpdateError!]!\n}\n\n\"\"\"Input for selecting a shipping option for the whole cart.\"\"\"\ninput ShippingOptionSelectInput {\n  \"\"\"\n  The shipping option ID to select. Must be offered as a delivery option by at least one item in\n  the cart; items that don't offer it fall back to the Checkout API's own choice.\n  \"\"\"\n  optionId: ID!\n}\n\n\"\"\"Error codes for shipping option select operations.\"\"\"\nenum ShippingOptionSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  The option id is not offered as a delivery option by any item in the cart (unknown id or\n  pickup). Returned without calling Checkout. An option only some items offer is not an error.\n  \"\"\"\n  OPTION_UNAVAILABLE\n\n  \"\"\"No delivery address is persisted on the cart.\"\"\"\n  MISSING_SHIPPING_ADDRESS\n}\n\n\"\"\"A domain error returned from a shipping option select mutation.\"\"\"\ntype ShippingOptionSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingOptionSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingOptionSelect mutation.\"\"\"\ntype ShippingOptionSelectPayload {\n  \"\"\"The updated shipping state, or null if errors occurred.\"\"\"\n  shipping: Shipping\n\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingOptionSelectError!]!\n}\n\n\"\"\"\nThe cart's payment state: available methods with server-driven validator config,\nthe current selection, installment options, and the shopper's saved cards. A\nread-only sibling of Cart, Shipping, and Session, projected from the same order\nform fetch. Method-agnostic: projects whatever payment systems VTEX returns, not\nonly credit card. Never carries a full card number or CVV.\n\"\"\"\ntype Payment implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Payment methods available on this cart. Empty when none are configured.\n  \"\"\"\n  methods: [PaymentMethod!]!\n\n  \"\"\"\n  The currently selected method's id (PaymentMethod.id), or null when unselected.\n  \"\"\"\n  selectedMethodId: String\n\n  \"\"\"\n  Saved-card account reference for the current selection, when a saved card is selected. Null otherwise.\n  \"\"\"\n  selectedAccountId: String\n\n  \"\"\"\n  The currently selected installment tier, resolved from the selection against installmentOptions. Null when unselected or unresolved.\n  \"\"\"\n  selectedInstallment: PaymentInstallment\n\n  \"\"\"\n  Installment plans available, grouped by method (and BIN, for card methods). Serves both a new card (matched by BIN) and a saved card (matched by its stored method).\n  \"\"\"\n  installmentOptions: [PaymentInstallmentOption!]!\n\n  \"\"\"\n  The shopper's saved cards. Empty for anonymous shoppers or when none are saved.\n  \"\"\"\n  savedCards: [SavedCard!]!\n\n  \"\"\"\n  The BIN persisted on the current selection, or null when the selection carries\n  none (a non-card method, or a saved card selected without one). Echoes back what\n  paymentMethodSelect wrote, which is what a client needs in order to know whether\n  its own locally-detected BIN has actually reached the order form: installment\n  options are matched against THIS value server-side, never against a client draft.\n  Not sensitive — a BIN identifies an issuer range, never a card.\n  \"\"\"\n  selectedBin: String\n}\n\n\"\"\"\nA payment method available on the cart, with the server-driven validator config\nthat determines which card-form fields render, their masks, and whether they\nare required. A non-normalized value object (ADR-0012); read directly off\nPayment.methods.\n\"\"\"\ntype PaymentMethod {\n  \"\"\"Payment-system identifier (VTEX paymentSystem stringId).\"\"\"\n  id: String!\n\n  \"\"\"\n  Display name (e.g. \"Visa\", \"Mastercard\", \"Cash\"). Doubles as the network name for card methods.\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Payment-system group (e.g. \"creditCardPaymentGroup\", \"debitCardPaymentGroup\"). Store-configured; kept as a string, not an enum.\n  \"\"\"\n  groupName: String!\n\n  \"\"\"\n  Whether VTEX flags this payment system as requiring cardholder authentication\n  (for example 3-D Secure). Projected verbatim from the order form's payment-system\n  configuration: it describes how the store configured the system, not a guarantee\n  about any particular transaction. Null when the order form carries no value for\n  this system — which is not the same as false. Detection only: this API implements\n  no authentication challenge.\n  \"\"\"\n  requiresAuthentication: Boolean\n\n  \"\"\"\n  Validator configuration driving field presence, masks, and requiredness.\n  \"\"\"\n  validator: PaymentMethodValidator!\n}\n\n\"\"\"\nPer-method validator configuration. Server-driven so no component hardcodes\nfield presence, masks, or requiredness.\n\"\"\"\ntype PaymentMethodValidator {\n  \"\"\"\n  Mask pattern for the card number input. Null when the method carries no mask.\n  \"\"\"\n  numberMask: String\n\n  \"\"\"\n  Regex for real-time network detection against the typed BIN. Null when unset.\n  \"\"\"\n  numberRegex: String\n\n  \"\"\"\n  Mask pattern for the security-code (CVV) input. Null when unused or unmasked.\n  \"\"\"\n  cvvMask: String\n\n  \"\"\"Regex validating the security-code (CVV) input. Null when unused.\"\"\"\n  cvvRegex: String\n\n  \"\"\"Whether this method requires the security code (CVV).\"\"\"\n  cvvRequired: Boolean!\n\n  \"\"\"Whether this method requires an expiration date.\"\"\"\n  expirationRequired: Boolean!\n\n  \"\"\"Whether this method requires the cardholder name.\"\"\"\n  holderNameRequired: Boolean!\n\n  \"\"\"Whether this method requires a billing address.\"\"\"\n  billingAddressRequired: Boolean!\n\n  \"\"\"\n  Whether a cardholder document field is displayable for this method. Distinct from documentRequired.\n  \"\"\"\n  documentDisplayable: Boolean!\n\n  \"\"\"\n  Whether the displayed cardholder document is required. Distinct from documentDisplayable — a document can be shown without being mandatory.\n  \"\"\"\n  documentRequired: Boolean!\n}\n\n\"\"\"\nOne installment tier: a specific installment count at a given per-installment\nvalue and total. Keyed by count within its parent PaymentInstallmentOption — a\nnon-normalized value object (ADR-0012).\n\"\"\"\ntype PaymentInstallment {\n  \"\"\"Number of installments (1 = single payment, no interest).\"\"\"\n  count: Int!\n\n  \"\"\"Amount per installment.\"\"\"\n  value: Money!\n\n  \"\"\"Total amount across all installments, including any interest.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Interest rate in hundredths of a percent, exactly as the VTEX order form carries it (100 = 1%; 0 = interest-free).\n  \"\"\"\n  interestRate: Float!\n}\n\n\"\"\"\nInstallment tiers available for one payment method (and, for card methods, one\nBIN range). A non-normalized value object (ADR-0012): read straight off\nPayment.installmentOptions.\n\"\"\"\ntype PaymentInstallmentOption\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"The payment method this option applies to (PaymentMethod.id).\"\"\"\n  methodId: String!\n\n  \"\"\"\n  The BIN range this option applies to, when method-and-BIN-specific. Null when the option applies by method alone.\n  \"\"\"\n  bin: String\n\n  \"\"\"Base order value this option was quoted against.\"\"\"\n  baseValue: Money!\n\n  \"\"\"\n  Installment tiers, with a guaranteed `count: 1` entry prepended when VTEX\n  omits one. A tier that upstream already supplies is passed through untouched\n  (including its position and interest rate).\n  \"\"\"\n  installments: [PaymentInstallment!]!\n}\n\n\"\"\"\nOne of the shopper's saved cards. Never carries a full card number or CVV. A\nnormalized, id-bearing value object (ADR-0012): id is a stable opaque cache\nkey, not a Relay Node.\n\"\"\"\ntype SavedCard\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Opaque, stable cache key. Not a Relay Node ID; SavedCard is not registered in the cross-module Node registry.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  The saved-card account reference. Pass this back on selection; never a full card number.\n  \"\"\"\n  accountId: String!\n\n  \"\"\"\n  The saved card's payment-system id (PaymentMethod.id), for cross-referencing validator config and installment options.\n  \"\"\"\n  methodId: String!\n\n  \"\"\"Card network / issuer display name (e.g. \"Visa\").\"\"\"\n  network: String!\n\n  \"\"\"Last four digits of the card number.\"\"\"\n  lastFourDigits: String!\n\n  \"\"\"BIN of the saved card, for installment-option lookup by network.\"\"\"\n  bin: String!\n\n  \"\"\"Shopper-assigned custom label, when set.\"\"\"\n  label: String\n\n  \"\"\"\n  Whether the card is expired. Expired cards are still returned; non-selectable is a UI concern downstream.\n  \"\"\"\n  expired: Boolean!\n\n  \"\"\"\n  Whether completing payment with this card requires the shopper to enter the CVV.\n  \"\"\"\n  cvvRequired: Boolean!\n}\n\n\"\"\"\nInput for selecting a payment method, optionally identifying a new card (by\nBIN) or a saved card (by account reference). A non-card method (e.g. Cash)\nomits both `bin` and `accountId`. When `accountId` is given, `bin` may also\nbe given to match the saved card against a BIN-specific installment option;\na `bin` that does not match the saved card's own BIN is rejected with\nMISMATCHED_BIN_FOR_SAVED_CARD.\n\"\"\"\ninput PaymentMethodSelectInput {\n  \"\"\"The method to select (PaymentMethod.id).\"\"\"\n  methodId: String!\n\n  \"\"\"\n  A newly-entered card's BIN, once detected. Omit for a saved card or a non-card method.\n  \"\"\"\n  bin: String\n\n  \"\"\"\n  A saved card's account reference (SavedCard.accountId). Omit for a new card or a non-card method.\n  \"\"\"\n  accountId: String\n}\n\n\"\"\"Error codes for the paymentMethodSelect mutation.\"\"\"\nenum PaymentMethodSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided methodId does not match any entry in Payment.methods.\"\"\"\n  INVALID_METHOD_ID\n\n  \"\"\"The provided accountId does not match any entry in Payment.savedCards.\"\"\"\n  INVALID_SAVED_CARD_ACCOUNT_ID\n\n  \"\"\"The bin does not match the BIN of the saved card named by accountId.\"\"\"\n  MISMATCHED_BIN_FOR_SAVED_CARD\n\n  \"\"\"\n  The bin is not 1 to 8 numeric digits — a BIN identifies an issuer range, never a card number.\n  \"\"\"\n  INVALID_BIN_FORMAT\n\n  \"\"\"\n  Never returned. The input once allowed at most one of bin / accountId; both are\n  now accepted so a saved card can be matched to an installment option by its own\n  BIN. Retained per ADR-00010 (additive-only with a deprecation window).\n  \"\"\"\n  CONFLICTING_BIN_AND_ACCOUNT_ID @deprecated(reason: \"Never returned; bin and accountId may now be sent together.\") @deprecationDate(deletionDate: \"2027-08-06\")\n}\n\n\"\"\"A domain error returned from the paymentMethodSelect mutation.\"\"\"\ntype PaymentMethodSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentMethodSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentMethodSelect mutation.\"\"\"\ntype PaymentMethodSelectPayload {\n  \"\"\"The updated payment state, or null if errors occurred.\"\"\"\n  payment: Payment\n\n  \"\"\"\n  The current billing address, echoed for convenience. Null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentMethodSelectError!]!\n}\n\n\"\"\"\nInput for selecting an installment count for the currently-selected method.\n\"\"\"\ninput PaymentInstallmentSelectInput {\n  \"\"\"Number of installments to select (1 = single payment, no interest).\"\"\"\n  count: Int!\n}\n\n\"\"\"Error codes for the paymentInstallmentSelect mutation.\"\"\"\nenum PaymentInstallmentSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  No payment method has been selected yet (paymentMethodSelect was never called).\n  \"\"\"\n  MISSING_PAYMENT_METHOD_SELECTION\n\n  \"\"\"\n  The count does not match any tier in the resolvable installment option.\n  \"\"\"\n  INVALID_INSTALLMENT_COUNT\n}\n\n\"\"\"A domain error returned from the paymentInstallmentSelect mutation.\"\"\"\ntype PaymentInstallmentSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentInstallmentSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"\nPayload returned by the paymentInstallmentSelect mutation. Includes the\nrecomputed cart so the order total (with any interest) updates in the same\nround trip.\n\"\"\"\ntype PaymentInstallmentSelectPayload {\n  \"\"\"The updated payment state, or null if errors occurred.\"\"\"\n  payment: Payment\n\n  \"\"\"\n  The recomputed cart, or null if errors occurred. Carries the order total with any installment interest applied.\n  \"\"\"\n  cart: Cart\n\n  \"\"\"\n  The current billing address, echoed for convenience. Null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentInstallmentSelectError!]!\n}\n\n\"\"\"\nInput for setting the billing address. When sameAsDelivery is true, every\nother field is ignored and no upstream write happens (VTEX's own default:\nan absent invoiceData falls back to the delivery address).\n\"\"\"\ninput PaymentBillingAddressUpdateInput {\n  \"\"\"\n  When true, billing uses the delivery address; every field below is ignored.\n  \"\"\"\n  sameAsDelivery: Boolean!\n\n  \"\"\"Address classification for the billing address.\"\"\"\n  addressType: String\n\n  \"\"\"\n  Postal code for the billing address. Required when sameAsDelivery is false.\n  \"\"\"\n  postalCode: String\n\n  \"\"\"\n  ISO 3166-1 alpha-3 country code (e.g. \"BRA\"). Required when sameAsDelivery is false.\n  \"\"\"\n  country: String\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n\n  \"\"\"\n  A landmark reference. Sent upstream but not echoed back on billingAddress (Decision 11).\n  \"\"\"\n  reference: String\n}\n\n\"\"\"Error codes for the paymentBillingAddressUpdate mutation.\"\"\"\nenum PaymentBillingAddressUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"sameAsDelivery is false but postalCode or country was omitted.\"\"\"\n  MISSING_BILLING_ADDRESS_FIELDS\n}\n\n\"\"\"A domain error returned from the paymentBillingAddressUpdate mutation.\"\"\"\ntype PaymentBillingAddressUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentBillingAddressUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentBillingAddressUpdate mutation.\"\"\"\ntype PaymentBillingAddressUpdatePayload {\n  \"\"\"\n  The billing address just written, or null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"\n  The updated payment state, or null if errors occurred, or when same-as-delivery is in effect, where no upstream write happens.\n  \"\"\"\n  payment: Payment\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentBillingAddressUpdateError!]!\n}\n\n\"\"\"\nError codes for the paymentStartTransaction mutation. Login-required VTEX\nbusiness codes (CHK0087, CHK003, ORD062) and generic infrastructure failures\nare never in this enum — per ADR-00007 they surface as top-level GraphQL\nerrors (UNAUTHORIZED / UPSTREAM_ERROR), not userErrors.\n\"\"\"\nenum PaymentStartTransactionErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  No payment method has been selected yet (paymentMethodSelect was never called).\n  \"\"\"\n  MISSING_PAYMENT_METHOD_SELECTION\n\n  \"\"\"\n  VTEX opened the transaction but named no merchant transaction on it, so\n  neither the transaction id the send-payments POST addresses nor the merchant\n  name its body carries exists. The transaction is open upstream but cannot be\n  paid; the legacy checkout refuses the same state.\n  \"\"\"\n  INVALID_TRANSACTION_DATA\n}\n\n\"\"\"A domain error returned from the paymentStartTransaction mutation.\"\"\"\ntype PaymentStartTransactionError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentStartTransactionErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"\nPayload returned by paymentStartTransaction: everything the browser needs to\nrun the direct-to-gateway send-payments call (out of scope here) and the\nlater gatewayCallback. The transaction cookies VTEX issues are set on the\nHTTP response (Set-Cookie), not exposed as a field.\n\"\"\"\ntype PaymentStartTransactionPayload {\n  \"\"\"The opened transaction's id. Null if errors occurred.\"\"\"\n  transactionId: String\n\n  \"\"\"\n  Name of the merchant responsible for the sale, as the gateway call's payment\n  `id` and `transaction.merchantName`. Projected from the same\n  merchantTransactions entry transactionId comes from — VTEX returns one entry\n  per seller, so a multi-seller order carries more than one and only the first\n  is exposed here (see specs/payment-transaction-payload-gaps.md, Decision 1).\n  Null if errors occurred.\n  \"\"\"\n  merchantName: String\n\n  \"\"\"\n  Origin of the payment gateway this transaction must be paid at, e.g.\n  \"https://mystore.vtexpayments.com.br\" — the base the browser's\n  direct-to-gateway send-payments POST appends its own path to. Origin only:\n  VTEX's own receiver path is the split-payment endpoint, not the\n  per-transaction one. Always an https origin inside vtexpayments.com.br: an\n  upstream receiver URI that is neither is rejected in favour of the\n  account-derived origin, since this field decides where card data is sent.\n  Null if errors occurred.\n  \"\"\"\n  gatewayUrl: String\n\n  \"\"\"\n  The order group, needed for the gateway call's orderId parameter and for gatewayCallback's input.\n  \"\"\"\n  orderGroup: String\n\n  \"\"\"The shopper's user profile id, needed for the gateway call.\"\"\"\n  userProfileId: String\n\n  \"\"\"\n  The payment amount for this transaction, as a decimal (e.g. \"100.00\") for\n  display. The gateway body wants minor units — read valueInCents for that,\n  never a client-side multiplication of this amount.\n  \"\"\"\n  value: Money\n\n  \"\"\"\n  The same payment amount in the currency's minor units (e.g. 10000 for\n  \"100.00\"), exactly as VTEX returned it and as this mutation sent it upstream.\n  The unit the gateway body's `value`/`installmentValue` fields expect. Null if\n  errors occurred.\n  \"\"\"\n  valueInCents: Int\n\n  \"\"\"\n  Pre-interest base amount this transaction was opened against, in the\n  currency's minor units — the gateway body's `referenceValue`. Equals\n  valueInCents when no interest applies. Null if errors occurred.\n  \"\"\"\n  referenceValueInCents: Int\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentStartTransactionError!]!\n}\n\n\"\"\"\nInput for finalizing a transaction after the direct-to-gateway call\nsucceeded.\n\"\"\"\ninput PaymentGatewayCallbackInput {\n  \"\"\"The order group returned by paymentStartTransaction.\"\"\"\n  orderGroup: String!\n}\n\n\"\"\"\nError codes for the paymentGatewayCallback mutation. Login-required VTEX\nbusiness codes (CHK0087, CHK003, ORD062) and generic infrastructure failures\nare never in this enum — per ADR-00007 they surface as top-level GraphQL\nerrors (UNAUTHORIZED / UPSTREAM_ERROR), not userErrors.\n\"\"\"\nenum PaymentGatewayCallbackErrorCode {\n  \"\"\"\n  The transaction cookies (Vtex_CHKO_Auth, CheckoutDataAccess) were not present on this request — paymentStartTransaction was not called first, or the five-minute window lapsed.\n  \"\"\"\n  MISSING_TRANSACTION_COOKIES\n\n  \"\"\"\n  VTEX requires a redirect or out-of-band flow to complete this payment. Phase 2; not supported in v1.\n  \"\"\"\n  REDIRECT_REQUIRED\n}\n\n\"\"\"A domain error returned from the paymentGatewayCallback mutation.\"\"\"\ntype PaymentGatewayCallbackError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentGatewayCallbackErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentGatewayCallback mutation.\"\"\"\ntype PaymentGatewayCallbackPayload {\n  \"\"\"\n  The finalized order group, echoed back on success. Null if errors occurred.\n  \"\"\"\n  orderId: String\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentGatewayCallbackError!]!\n}\n\n\"\"\"\nThe installment plan a settled order was charged in. Projected from the\nplaced-order payment record, which carries the count and the settled total\nonly — never a per-installment amount and never an interest rate, unlike the\nlive order form behind `Payment.selectedInstallment`. That asymmetry is\nupstream and permanent (see specs/settle-and-project-the-placed-order.md,\nDecision 2).\n\"\"\"\ntype OrderInstallment\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Number of installments the order was charged in. 1 = single payment.\"\"\"\n  count: Int!\n\n  \"\"\"\n  Total charged across all installments, including any interest. Null when the\n  settled record carries no amount, or no currency to denominate it in.\n  \"\"\"\n  total: Money\n}\n\n\"\"\"\nA settled order's payment recap. Read-only; projected from VTEX's\nsettled-order source rather than the live order form, so it keeps resolving\nafter the order form itself stops existing. Carries no sensitive field: no\nfull card number or CVV is ever read for this projection (RFC D13).\n\"\"\"\ntype Order implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order group.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Card network / payment-system display name (e.g. \"Visa\", or a non-card\n  method's own name such as \"Boleto Bancário\"). Null when the settled order\n  carries no payment record to project one from.\n  \"\"\"\n  network: String\n\n  \"\"\"\n  Last four digits of the card used, when the payment method was a card.\n  Present for both a saved and a freshly-entered card — unlike Payment (T1),\n  where last four is a saved-card-only field. Null for a non-card method or\n  when no payment record exists to project one from.\n  \"\"\"\n  lastFourDigits: String\n\n  \"\"\"\n  Shopper-assigned custom label for the saved card used, when one was set.\n  Null for a freshly-entered (unsaved) card, a non-card method, or when no\n  payment record exists to project one from (see specs/order-read-model.md,\n  Decision 5).\n  \"\"\"\n  label: String\n\n  \"\"\"\n  The installment plan this order was charged in. Null when the settled record\n  reports none.\n  \"\"\"\n  installment: OrderInstallment\n}\n\n\"\"\"\nThe authentication methods an account enables, read before rendering a sign-in form.\n\"\"\"\ntype SessionAuthProviders {\n  \"\"\"Whether classic email and password sign-in is enabled.\"\"\"\n  passwordAuthentication: Boolean!\n\n  \"\"\"Whether email access-code (passwordless) sign-in is enabled.\"\"\"\n  accessKeyAuthentication: Boolean!\n}\n\n\"\"\"\nA typed, expected failure of a login attempt. Distinct from the top-level\nUNAUTHORIZED gate: this is a domain outcome (the request was understood, the\nbusiness rejected it), never an infrastructure failure.\n\"\"\"\ntype SessionError {\n  \"\"\"Machine-readable error code for the login-attempt failure.\"\"\"\n  code: SessionErrorCode!\n\n  \"\"\"Human-readable message describing the failure.\"\"\"\n  message: String!\n}\n\n\"\"\"The set of login-attempt failure codes a session mutation can return.\"\"\"\nenum SessionErrorCode {\n  \"\"\"Email or password was not accepted by VTEX ID.\"\"\"\n  INVALID_CREDENTIALS\n\n  \"\"\"The access code was wrong or expired.\"\"\"\n  INVALID_ACCESS_CODE\n\n  \"\"\"Too many access codes were requested for this email.\"\"\"\n  ACCESS_CODE_SEND_LIMIT\n\n  \"\"\"The user is blocked by VTEX ID.\"\"\"\n  BLOCKED\n\n  \"\"\"\n  BFF-side guard: the request lacked the auth context it needed (e.g. a missing\n  authenticationToken). Not a VTEX outcome.\n  \"\"\"\n  MISSING_AUTH_CONTEXT\n}\n\n\"\"\"\nThe login / logout result, projected from the one refreshed order form. session,\ncart, clientProfile and clientPreferences are normalized Relay Nodes (keyed on\nthe orderFormId) so Apollo merges them into the cache and the client updates\nreactively with no refetch.\n\"\"\"\ntype SessionLoginPayload {\n  \"\"\"The session after the attempt; loggedIn is true only on success.\"\"\"\n  session: Session!\n\n  \"\"\"The cart projected from the refreshed order form.\"\"\"\n  cart: Cart!\n\n  \"\"\"\n  The client profile projected from the refreshed order form; the entity always\n  resolves, its fields are null when unset.\n  \"\"\"\n  clientProfile: ClientProfile!\n\n  \"\"\"\n  The client preferences projected from the refreshed order form; the entity\n  always resolves, its fields are null when unset.\n  \"\"\"\n  clientPreferences: ClientPreferences!\n\n  \"\"\"Typed login-attempt failures. Empty on success.\"\"\"\n  userErrors: [SessionError!]!\n}\n\n\"\"\"The result of requesting an email access code.\"\"\"\ntype SessionRequestAccessCodePayload {\n  \"\"\"\n  Opaque token to hand back to sessionValidateAccessCode. Null when the request\n  failed.\n  \"\"\"\n  authenticationToken: String\n\n  \"\"\"Typed request failures. Empty on success.\"\"\"\n  userErrors: [SessionError!]!\n}\n\n\"\"\"Credentials for a classic email + password sign-in.\"\"\"\ninput SessionPasswordLoginInput {\n  \"\"\"The shopper's email address.\"\"\"\n  email: String!\n\n  \"\"\"\n  The shopper's password. Proxied to VTEX ID over TLS, never logged or persisted.\n  \"\"\"\n  password: String!\n}\n\n\"\"\"The email to send an access code to.\"\"\"\ninput SessionRequestAccessCodeInput {\n  \"\"\"The shopper's email address the access code is sent to.\"\"\"\n  email: String!\n}\n\n\"\"\"An access code plus the authenticationToken it was issued against.\"\"\"\ninput SessionValidateAccessCodeInput {\n  \"\"\"The shopper's email address.\"\"\"\n  email: String!\n\n  \"\"\"The access code the shopper received by email.\"\"\"\n  accessCode: String!\n\n  \"\"\"\n  The opaque token returned by sessionRequestAccessCode, handed back unchanged.\n  \"\"\"\n  authenticationToken: String!\n}\n\n\"\"\"\nThe shopper's active region. Both fields are nullable: a shopper who has never\nsubmitted a postal code has no region, and a submitted postal code does not\nalways resolve to a known city.\n\"\"\"\ntype Region\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization. Not a Relay Node ID: a region is\n  session-scoped shopper state, never addressable by global id.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The active postal code, formatted for display. Null when none is set.\"\"\"\n  postalCode: String\n\n  \"\"\"\n  The city the postal code resolves to. Null when the postal code is unknown to\n  the resolver, which is a normal state and not an error.\n  \"\"\"\n  city: String\n}\n\n\"\"\"\nWhy a region write was refused. Stable across locales, so a client can render\neach case in the shopper's language instead of echoing the server's message.\n\"\"\"\nenum RegionErrorCode {\n  \"\"\"The value did not normalize to a complete postal code.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The postal code is complete but falls outside the served ranges.\"\"\"\n  UNSERVED_POSTAL_CODE\n}\n\n\"\"\"\nA typed, expected failure of a region write: the request was understood and the\nbusiness rejected it. Distinct from an infrastructure failure, which surfaces as\na top-level GraphQL error.\n\"\"\"\ntype RegionError {\n  \"\"\"Which rule refused the postal code.\"\"\"\n  code: RegionErrorCode!\n\n  \"\"\"\n  Human-readable message describing why the postal code was rejected. Written in\n  English by the server; a client should key its copy on `code` instead.\n  \"\"\"\n  message: String!\n}\n\n\"\"\"The result of submitting a postal code.\"\"\"\ntype RegionUpdatePayload {\n  \"\"\"\n  The region after the write. Null when the postal code was rejected, leaving\n  any previously active region untouched.\n  \"\"\"\n  region: Region\n\n  \"\"\"Typed rejections. Empty on success.\"\"\"\n  errors: [RegionError!]!\n}\n\n\"\"\"\nA shopper's persistent, cart-independent profile. Distinct from checkout's\norder-form-scoped ClientProfile.\n\"\"\"\ntype CustomerProfile\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization. Not a Relay Node ID: the profile is\n  session-scoped shopper state, derived from the session and never addressable\n  by a global id (no id argument, no Query.node entry — IDOR-safe).\n  \"\"\"\n  id: ID!\n\n  \"\"\"Given name. Null when unset.\"\"\"\n  firstName: String\n\n  \"\"\"Family name. Null when unset.\"\"\"\n  lastName: String\n\n  \"\"\"\n  The shopper's login identifier. Read-only — excluded from the update input by construction.\n  \"\"\"\n  email: String\n\n  \"\"\"Primary contact phone. Null when unset.\"\"\"\n  homePhone: String\n\n  \"\"\"Mobile contact phone. Null when unset.\"\"\"\n  mobilePhone: String\n\n  \"\"\"National tax ID. Null when unset.\"\"\"\n  document: String\n\n  \"\"\"\n  The tax ID's type, so the control can adapt to the shopper's region. Null when unset.\n  \"\"\"\n  documentType: String\n\n  \"\"\"Date of birth. Null when unset.\"\"\"\n  birthDate: String\n\n  \"\"\"\n  Free-form gender value; the store configures the options it offers. Null when unset.\n  \"\"\"\n  gender: String\n}\n\n\"\"\"A typed, expected failure of a profile write.\"\"\"\ntype CustomerProfileError {\n  \"\"\"Machine-readable code for the write failure.\"\"\"\n  code: CustomerProfileErrorCode!\n\n  \"\"\"A safe message. Never echoes a submitted profile value.\"\"\"\n  message: String!\n}\n\n\"\"\"The set of expected, typed profile-write failure codes.\"\"\"\nenum CustomerProfileErrorCode {\n  \"\"\"\n  The account's profile schema refused one or more submitted values. It does not\n  attribute the refusal to a cause — a required field left empty and a malformed\n  value are not distinguishable until the upstream rejection body is\n  characterised, at which point a narrower code joins this one.\n  \"\"\"\n  INVALID_VALUE\n}\n\n\"\"\"\nEvery field is optional: provide only what the shopper edited. An empty string\nis an explicit erase; an omitted field is left untouched. A `null` is neither —\nit counts as not provided, so nulling an untouched field cannot wipe it.\n\"\"\"\ninput CustomerProfileUpdateInput {\n  \"\"\"Given name to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  firstName: String\n\n  \"\"\"Family name to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  lastName: String\n\n  \"\"\"\n  Primary contact phone to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  homePhone: String\n\n  \"\"\"\n  Mobile contact phone to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  mobilePhone: String\n\n  \"\"\"\n  National tax ID to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  document: String\n\n  \"\"\"Tax ID type to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  documentType: String\n\n  \"\"\"\n  Date of birth to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  birthDate: String\n\n  \"\"\"Gender value to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  gender: String\n}\n\n\"\"\"\nThe result of a profile write, carrying the merged profile and any typed\nfailures.\n\"\"\"\ntype CustomerProfileUpdatePayload {\n  \"\"\"\n  The profile after the write, so a reactive fragment re-delivers without a refetch.\n  \"\"\"\n  customerProfile: CustomerProfile!\n\n  \"\"\"Typed, expected write failures. Empty on success.\"\"\"\n  userErrors: [CustomerProfileError!]!\n}\n\nenum link__Purpose {\n  \"\"\"\n  `SECURITY` features provide metadata necessary to securely resolve fields.\n  \"\"\"\n  SECURITY\n\n  \"\"\"\n  `EXECUTION` features provide metadata necessary for operation execution.\n  \"\"\"\n  EXECUTION\n}\n\nscalar link__Import\n\nscalar federation__FieldSet\n\nscalar federation__Scope\n\nscalar federation__Policy\n\nscalar federation__ContextFieldValue\n\nscalar _Any\n\ntype _Service {\n  sdl: String\n}\n\nunion _Entity = Product\n";
+var core_federation_default = "# GENERATED by src/schema/emit.ts (pnpm run schema:emit) — do not edit by hand.\n# core version: 0.0.1\nschema\n  @link(url: \"https://specs.apollo.dev/link/v1.0\")\n{\n  query: Query\n  mutation: Mutation\n}\n\nextend schema\n  @link(url: \"https://specs.apollo.dev/federation/v2.9\", import: [\"@key\"])\n\n\"\"\"\nRecords the planned removal date of a deprecated schema element. Pairs with the\nstandard built-in `@deprecated(reason)`: `@deprecated` carries the client-facing\nreason, `@deprecationDate` carries only the machine-readable deletion date. The\nreason is not duplicated here — that would drift from the built-in.\n\nThis replaces the previous redefinition of the built-in `@deprecated` (which\nadded a `deletionDate` argument). Redefining a built-in makes Federation\ncomposition (`wgc compose`) fail, so the deletion date moved to this custom\ndirective. As a non-built-in directive it is dropped during composition rather\nthan rejected. See ADR-00011 and CONTEXT.md. The `@deprecated`/`@deprecationDate`\npairing (both directions) and the future-date rule are enforced by a contract\ntest, not a lint rule.\n\"\"\"\ndirective @deprecationDate(\n  \"\"\"\n  Target removal date in ISO-8601 (YYYY-MM-DD) format. Must be in the future.\n  \"\"\"\n  deletionDate: String!\n) on FIELD_DEFINITION | ARGUMENT_DEFINITION | INPUT_FIELD_DEFINITION | ENUM_VALUE\n\n\"\"\"\nDeclares an HTTP cache policy for a type, field, or interface. Apollo Server\naggregates every hint resolved by a query and emits a single `Cache-Control`\nheader whose `max-age` is the minimum across hints and whose scope is the most\nrestrictive (PRIVATE wins over PUBLIC). Mutations and error responses ignore\nthese hints and always carry `Cache-Control: no-store`.\n\"\"\"\ndirective @cacheControl(\n  \"\"\"Longest time (in seconds) this data may live in a cache.\"\"\"\n  maxAge: Int\n\n  \"\"\"\n  Whether shared caches (CDN, proxy) may store the response. Defaults to\n  PUBLIC when another field or type sets a scope and nothing overrides it.\n  \"\"\"\n  scope: CacheControlScope\n\n  \"\"\"\n  When true, this field inherits its `maxAge` from the parent field rather\n  than contributing its own hint. Useful for wrapper/connection types.\n  \"\"\"\n  inheritMaxAge: Boolean\n) on OBJECT | FIELD_DEFINITION | INTERFACE\n\ndirective @link(url: String, as: String, for: link__Purpose, import: [link__Import]) repeatable on SCHEMA\n\ndirective @key(fields: federation__FieldSet!, resolvable: Boolean = true) repeatable on OBJECT | INTERFACE\n\ndirective @federation__requires(fields: federation__FieldSet!) on FIELD_DEFINITION\n\ndirective @federation__provides(fields: federation__FieldSet!) on FIELD_DEFINITION\n\ndirective @federation__external(reason: String) on OBJECT | FIELD_DEFINITION\n\ndirective @federation__tag(name: String!) repeatable on FIELD_DEFINITION | OBJECT | INTERFACE | UNION | ARGUMENT_DEFINITION | SCALAR | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION | SCHEMA\n\ndirective @federation__extends on OBJECT | INTERFACE\n\ndirective @federation__shareable repeatable on OBJECT | FIELD_DEFINITION\n\ndirective @federation__inaccessible on FIELD_DEFINITION | OBJECT | INTERFACE | UNION | ARGUMENT_DEFINITION | SCALAR | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION\n\ndirective @federation__override(from: String!, label: String) on FIELD_DEFINITION\n\ndirective @federation__composeDirective(name: String) repeatable on SCHEMA\n\ndirective @federation__interfaceObject on OBJECT\n\ndirective @federation__authenticated on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__requiresScopes(scopes: [[federation__Scope!]!]!) on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__policy(policies: [[federation__Policy!]!]!) on FIELD_DEFINITION | OBJECT | INTERFACE | SCALAR | ENUM\n\ndirective @federation__context(name: String!) repeatable on INTERFACE | OBJECT | UNION\n\ndirective @federation__fromContext(field: federation__ContextFieldValue) on ARGUMENT_DEFINITION\n\ndirective @federation__cost(weight: Int!) on ARGUMENT_DEFINITION | ENUM | FIELD_DEFINITION | INPUT_FIELD_DEFINITION | OBJECT | SCALAR\n\ndirective @federation__listSize(assumedSize: Int, slicingArguments: [String!], sizedFields: [String!], requireOneSlicingArgument: Boolean = true) on FIELD_DEFINITION\n\n\"\"\"Visibility scope for an HTTP cache entry.\"\"\"\nenum CacheControlScope {\n  \"\"\"\n  The response may be stored by shared caches (CDN, proxy) and reused\n  across users.\n  \"\"\"\n  PUBLIC\n\n  \"\"\"\n  The response may only be stored by single-user caches (browser, service\n  worker). Shared caches must not store it.\n  \"\"\"\n  PRIVATE\n}\n\n\"\"\"\nAn [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339) encoded UTC datetime.\n\"\"\"\nscalar DateTime\n\n\"\"\"\nAn [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) encoded URI.\n\"\"\"\nscalar URI\n\n\"\"\"A string containing raw HTML markup.\"\"\"\nscalar HTML\n\n\"\"\"\nAn ISO 4217 currency amount represented as a decimal string (e.g. \"29.99\").\n\"\"\"\nscalar Decimal\n\n\"\"\"\nA [BCP 47](https://tools.ietf.org/html/bcp47) language tag (e.g. \"en-US\").\n\"\"\"\nscalar Locale\n\n\"\"\"An opaque cursor used for Relay-style pagination.\"\"\"\nscalar Cursor\n\n\"\"\"\nThe Relay `Node` interface. Every entity in the graph implements this so\nthe client can refetch any object with a single `node(id: ID!)` query.\n\"\"\"\ninterface Node {\n  \"\"\"Globally unique identifier. Base64 of `entityType:rawId`.\"\"\"\n  id: ID!\n}\n\n\"\"\"Metadata about the current page in a Relay connection.\"\"\"\ntype PageInfo {\n  \"\"\"Whether more pages exist after the current page.\"\"\"\n  hasNextPage: Boolean!\n\n  \"\"\"Whether more pages exist before the current page.\"\"\"\n  hasPreviousPage: Boolean!\n\n  \"\"\"Cursor of the first edge in the current page.\"\"\"\n  startCursor: Cursor\n\n  \"\"\"Cursor of the last edge in the current page.\"\"\"\n  endCursor: Cursor\n}\n\n\"\"\"Sort direction for orderBy arguments.\"\"\"\nenum SortDirection {\n  \"\"\"Ascending order.\"\"\"\n  ASC\n\n  \"\"\"Descending order.\"\"\"\n  DESC\n}\n\n\"\"\"Represents a monetary amount with its currency.\"\"\"\ntype Money {\n  \"\"\"Decimal amount (e.g. \"49.99\").\"\"\"\n  amount: Decimal!\n\n  \"\"\"ISO 4217 currency code (e.g. \"USD\", \"BRL\").\"\"\"\n  currencyCode: CurrencyCode!\n}\n\n\"\"\"A price range, useful for showing \"from – to\" on product cards.\"\"\"\ntype PriceRange {\n  \"\"\"Lowest price across all variants.\"\"\"\n  min: Money!\n\n  \"\"\"Highest price across all variants.\"\"\"\n  max: Money!\n}\n\n\"\"\"ISO 4217 currency codes. Extend as needed.\"\"\"\nenum CurrencyCode {\n  \"\"\"United States Dollar.\"\"\"\n  USD\n\n  \"\"\"Euro.\"\"\"\n  EUR\n\n  \"\"\"British Pound Sterling.\"\"\"\n  GBP\n\n  \"\"\"Brazilian Real.\"\"\"\n  BRL\n\n  \"\"\"Argentine Peso.\"\"\"\n  ARS\n\n  \"\"\"Chilean Peso.\"\"\"\n  CLP\n\n  \"\"\"Colombian Peso.\"\"\"\n  COP\n\n  \"\"\"Mexican Peso.\"\"\"\n  MXN\n\n  \"\"\"Peruvian Sol.\"\"\"\n  PEN\n\n  \"\"\"Japanese Yen.\"\"\"\n  JPY\n}\n\n\"\"\"An image resource associated with a product variant or other entity.\"\"\"\ntype Image {\n  \"\"\"Source URL of the image.\"\"\"\n  url: URI!\n\n  \"\"\"Alt text for accessibility.\"\"\"\n  altText: String\n}\n\n\"\"\"A video resource associated with a product.\"\"\"\ntype Video {\n  \"\"\"Playback URL.\"\"\"\n  url: URI!\n\n  \"\"\"Alt text for accessibility.\"\"\"\n  altText: String\n\n  \"\"\"Preview / poster image.\"\"\"\n  previewImage: Image\n}\n\n\"\"\"Any media attached to a product — image or video.\"\"\"\nunion Media = Image | Video\n\n\"\"\"Search engine optimization metadata for any displayable entity.\"\"\"\ntype SEO {\n  \"\"\"Page title (`<title>` tag).\"\"\"\n  title: String\n\n  \"\"\"Meta description.\"\"\"\n  description: String\n}\n\n\"\"\"Root query type for the storefront API.\"\"\"\ntype Query {\n  \"\"\"\n  Fetch any entity by its global ID.\n  Clients use this for refetching or cache normalization.\n  \"\"\"\n  node(\n    \"\"\"The globally unique ID.\"\"\"\n    id: ID!\n  ): Node\n\n  \"\"\"Fetch multiple entities by their global IDs.\"\"\"\n  nodes(\n    \"\"\"A list of globally unique IDs.\"\"\"\n    ids: [ID!]!\n  ): [Node]!\n  _entities(representations: [_Any!]!): [_Entity]!\n  _service: _Service!\n}\n\nextend type Query {\n  \"\"\"Look up a single product by global ID.\"\"\"\n  product(\n    \"\"\"Global product ID.\"\"\"\n    id: ID!\n  ): Product\n\n  \"\"\"Look up a single product by its URL slug.\"\"\"\n  productBySlug(\n    \"\"\"URL-friendly handle (e.g. \\\"nike-zoom-janoski-red\\\").\"\"\"\n    slug: String!\n  ): Product\n\n  \"\"\"Paginated, filterable list of products.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n\n  \"\"\"\n  Full-text product search with facets and filters.\n  Returns the same connection shape but is backed by the search engine\n  rather than the catalog database.\n  \"\"\"\n  productSearch(\n    \"\"\"Search query string.\"\"\"\n    query: String!\n\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductSearchResult!\n\n  \"\"\"\n  Product recommendations based on a seed product (frequently bought\n  together, similar items, etc.).\n  \"\"\"\n  productRecommendations(\n    \"\"\"URL slug of the product to base recommendations on.\"\"\"\n    slug: String!\n\n    \"\"\"The recommendation strategy to use.\"\"\"\n    intent: RecommendationIntent\n\n    \"\"\"Maximum number of recommendations.\"\"\"\n    first: Int = 10\n  ): [Product!]!\n\n  \"\"\"\n  Resolves a catalog route by ID or by path and returns its confirmed localized equivalents.\n  Null when the route does not exist or the catalog could not be reached.\n  \"\"\"\n  catalogRoute(\n    \"\"\"The route to resolve, by ID or by path.\"\"\"\n    input: CatalogRouteInput!\n  ): CatalogRoute\n\n  \"\"\"Look up a single category by global ID.\"\"\"\n  category(\n    \"\"\"Global category ID.\"\"\"\n    id: ID!\n  ): Category\n\n  \"\"\"Look up a category by its URL slug.\"\"\"\n  categoryBySlug(\n    \"\"\"URL-friendly slug.\"\"\"\n    slug: String!\n  ): Category\n\n  \"\"\"\n  The full category tree starting from root departments.\n  Accepts a `maxDepth` to limit tree traversal (default: all levels).\n  \"\"\"\n  categoryTree(\n    \"\"\"Maximum depth of the tree to return. Maps to VTEX `categoryLevels`.\"\"\"\n    maxDepth: Int\n  ): [Category!]!\n\n  \"\"\"Paginated flat list of categories.\"\"\"\n  categories(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: CategorySortingInput\n  ): CategoriesConnection!\n\n  \"\"\"Look up a single brand by global ID.\"\"\"\n  brand(\n    \"\"\"Global brand ID.\"\"\"\n    id: ID!\n  ): Brand\n\n  \"\"\"\n  All brands available in the store, derived from the search index.\n  Returns brands with their product counts.\n  \"\"\"\n  brands(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): BrandsConnection!\n\n  \"\"\"Look up a single sales channel by global ID.\"\"\"\n  salesChannel(\n    \"\"\"Global sales channel ID.\"\"\"\n    id: ID!\n  ): SalesChannel\n\n  \"\"\"\n  Autocomplete suggestions for a partial search query.\n  Returns suggested terms with estimated result counts and facet attributes.\n  \"\"\"\n  autocompleteSuggestions(\n    \"\"\"Partial search query (e.g. \\\"choc\\\").\"\"\"\n    query: String!\n  ): [AutocompleteSuggestion!]!\n\n  \"\"\"The most popular search terms in the last 14 days.\"\"\"\n  topSearches: [TrendingSearch!]!\n\n  \"\"\"\n  Spelling correction for a potentially misspelled search query.\n  Returns null if no correction is available.\n  \"\"\"\n  searchCorrection(\n    \"\"\"The potentially misspelled query.\"\"\"\n    query: String!\n  ): SearchCorrection\n}\n\nextend type Query {\n  \"\"\"\n  Resolve the active cart from the request context (x-order-form-id header,\n  then cookie). When no cart context is present, a new cart is created and\n  the x-order-form-id cookie is set on the response.\n  \"\"\"\n  cart: Cart!\n}\n\nextend type Query {\n  \"\"\"\n  Simulate available shipping options for a variant on a product detail page.\n  Returns delivery options with estimated times and prices for the given\n  postal code and item.\n  \"\"\"\n  shippingSimulation(\n    \"\"\"Simulation input: destination, SKU, quantity, and seller.\"\"\"\n    input: ShippingSimulateInput!\n  ): ShippingSimulationPayload!\n\n  \"\"\"\n  Simulate shipping options for the entire active cart. Reads the cart from the\n  x-order-form-id context and simulates all of its items against the\n  destination, returning the options common to every item with prices summed\n  across items. Never mints a cart: absent context returns a MISSING_CART_CONTEXT\n  userError.\n  \"\"\"\n  cartShippingSimulation(\n    \"\"\"Simulation input: destination only. Items come from the active cart.\"\"\"\n    input: CartShippingSimulateInput!\n  ): CartShippingSimulationPayload!\n}\n\nextend type Query {\n  \"\"\"\n  The shopper's profile for the active cart, resolved from the same order form\n  as `cart`. The entity always resolves; its fields are null when unset.\n  \"\"\"\n  clientProfile: ClientProfile!\n\n  \"\"\"\n  The shopper's preferences for the active cart, resolved from the same order\n  form as `cart`. The entity always resolves; its fields are null when unset.\n  \"\"\"\n  clientPreferences: ClientPreferences!\n}\n\nextend type Query {\n  \"\"\"\n  The cart's shipping state. Projected from the same order form as Query.cart.\n  \"\"\"\n  shipping: Shipping!\n\n  \"\"\"\n  Resolve the shopper's session state from the active order form (x-order-form-id\n  header, then cookie). Projects from the same order form fetch as `cart`.\n  \"\"\"\n  session: Session!\n}\n\nextend type Query {\n  \"\"\"\n  The cart's payment state: methods, selection, installment options, and saved cards. Projected from the same order form as Query.cart. Always resolves; lists are empty and selection fields are null when payment is unset.\n  \"\"\"\n  payment: Payment!\n}\n\nextend type Query {\n  \"\"\"\n  A settled order's payment recap, keyed on the order group\n  paymentStartTransaction / paymentGatewayCallback return. Null when the\n  order group does not resolve to a settled order — never a fabricated empty\n  projection (contrast Query.payment, which always resolves).\n  \"\"\"\n  order(\n    \"\"\"\n    The order group returned by paymentStartTransaction / paymentGatewayCallback.\n    \"\"\"\n    orderGroup: String!\n  ): Order\n}\n\nextend type Query {\n  \"\"\"\n  The fields a postal code resolves to. Needs no cart and no shopper. Null when\n  the platform does not know the code. A lookup that could not run is an error,\n  never null. A malformed argument is a BAD_USER_INPUT error and reaches no\n  upstream.\n  \"\"\"\n  addressByPostalCode(\n    \"\"\"\n    ISO 3166-1 alpha-3 code, such as `BRA`. Case and surrounding spaces are\n    ignored.\n    \"\"\"\n    country: String!\n\n    \"\"\"\n    The postal code, masked or not: letters, digits, spaces, and hyphens, up to\n    20 characters.\n    \"\"\"\n    postalCode: String!\n  ): PostalCodeAddress\n}\n\nextend type Query {\n  \"\"\"Which authentication methods this account enables.\"\"\"\n  sessionAuthProviders: SessionAuthProviders!\n}\n\nextend type Query {\n  \"\"\"\n  The shopper's active region, or null when none has been set. Takes no\n  arguments by design: the postal code travels on the transport.\n  \"\"\"\n  region: Region\n}\n\nextend type Query {\n  \"\"\"\n  The signed-in shopper's own persistent profile. Takes no id — the identity\n  comes from the session. Nullable because it is permission-gated (ADR-00005).\n  Null with no error when the session names no shopper. Null with an\n  UNAUTHORIZED, UPSTREAM_ERROR, UPSTREAM_TIMEOUT or CIRCUIT_OPEN error on this\n  field's path when the read fails (ADR-00007), so the rest of the operation\n  still resolves. A profile whose fields are null when the shopper has saved\n  nothing yet.\n  \"\"\"\n  customerProfile: CustomerProfile\n\n  \"\"\"\n  The signed-in shopper's saved addresses, in the order the profile returns\n  them. Takes no id: the identity comes from the session. Empty when the shopper\n  has none. Throws UNAUTHORIZED or UPSTREAM_ERROR (ADR-00007).\n  \"\"\"\n  customerAddresses: [CustomerAddress!]!\n\n  \"\"\"\n  The signed-in shopper's address book. Takes no id: the identity comes from the\n  session. Throws UNAUTHORIZED, or UPSTREAM_ERROR when `addresses` is selected\n  (ADR-00007).\n  \"\"\"\n  customerAddressBook: CustomerAddressBook!\n\n  \"\"\"\n  One of the signed-in shopper's saved addresses. Null when the id is malformed,\n  names another entity type, or is not one of this shopper's addresses; these\n  cases are indistinguishable.\n  \"\"\"\n  customerAddress(\n    \"\"\"The CustomerAddress global id, as returned by `customerAddresses`.\"\"\"\n    id: ID!\n  ): CustomerAddress\n}\n\nextend type Query {\n  \"\"\"\n  The countries the store ships to. Takes no arguments and needs no cart or\n  shopper. Null when the platform could not be read, with the reason in\n  `errors`; a consumer then knows no shipping country rather than none.\n  \"\"\"\n  shippingCountries: ShippingCountries\n}\n\nextend type Query {\n  \"\"\"\n  Read one order owned by the signed-in shopper. A missing or foreign order returns null.\n  \"\"\"\n  customerOrder(\n    \"\"\"Shopper-facing order number, or the global Node id of a CustomerOrder.\"\"\"\n    id: ID!\n  ): CustomerOrder @cacheControl(maxAge: 0, scope: PRIVATE)\n\n  \"\"\"One page of the signed-in shopper's orders.\"\"\"\n  customerOrders(\n    \"\"\"Page size. Must be 25.\"\"\"\n    first: Int!\n\n    \"\"\"Opaque resume cursor issued by this field.\"\"\"\n    after: Cursor\n\n    \"\"\"Not supported. The list is read forward from the route.\"\"\"\n    last: Int\n\n    \"\"\"Not supported. The list is read forward from the route.\"\"\"\n    before: Cursor\n\n    \"\"\"View, text, and placed-date range.\"\"\"\n    filter: CustomerOrdersFilterInput\n  ): CustomerOrdersConnection! @cacheControl(maxAge: 0, scope: PRIVATE)\n}\n\nextend type Query {\n  \"\"\"\n  The signed-in shopper's own saved cards. Takes no id — the identity comes from\n  the session. Resolves to the shopper's entity, with an empty list when no card\n  is saved. Null only when the read fails, alongside an UNAUTHORIZED,\n  UPSTREAM_ERROR, or UPSTREAM_TIMEOUT error at this path (ADR-00007), so the\n  failure does not null the rest of the operation.\n  \"\"\"\n  customerSavedCards: CustomerSavedCards\n}\n\nextend type Query {\n  \"\"\"\n  The credit-card networks the store accepts on the request's sales channel,\n  with their validation rules, for adding a saved card. Requires a signed-in\n  shopper. Null when the read fails, alongside an UNAUTHORIZED, UPSTREAM_ERROR,\n  UPSTREAM_TIMEOUT, or NO_CARD_NETWORKS error at this path (ADR-00007).\n  NO_CARD_NETWORKS means the store accepts no credit-card network on this\n  sales channel; the list is never empty.\n  \"\"\"\n  savedCardNetworks: [CardNetworkRule!]\n\n  \"\"\"\n  The signed-in shopper's saved addresses a new card can be billed to, in the\n  platform's order. Takes no id. Empty when none is saved. Null only when the\n  read fails, alongside an UNAUTHORIZED, UPSTREAM_ERROR, or UPSTREAM_TIMEOUT\n  error at this path.\n  \"\"\"\n  customerSavedCardBillingAddresses: [CardBillingAddress!]\n}\n\n\"\"\"\nRoot mutation type. Cart and checkout operations are declared via\n`extend type Mutation` in the checkout module.\n\"\"\"\ntype Mutation {\n  \"\"\"\n  Exists only so `extend type Mutation` in feature modules is valid for schema\n  linters and subgraph composition; not intended for client use.\n  \"\"\"\n  inertMutationPlaceholder: Boolean\n\n  \"\"\"Placeholder field — removed once a real mutation is added via extend.\"\"\"\n  empty: String @deprecated(reason: \"Placeholder — will be dropped when the first real mutation is added.\") @deprecationDate(deletionDate: \"2026-12-31\")\n}\n\nextend type Mutation {\n  \"\"\"\n  Add an item to the cart. If the variant already exists in the cart, its\n  quantity is increased by the given amount.\n  \"\"\"\n  cartItemAdd(\n    \"\"\"Item details to add.\"\"\"\n    input: CartItemAddInput!\n  ): CartItemAddPayload!\n\n  \"\"\"Remove a line from the cart entirely (sets quantity to 0).\"\"\"\n  cartItemRemove(\n    \"\"\"Item to remove.\"\"\"\n    input: CartItemRemoveInput!\n  ): CartItemRemovePayload!\n\n  \"\"\"\n  Remove multiple items from the cart in a single upstream write (each line's\n  quantity is set to 0). Tolerant: lines absent from the cart are skipped.\n  \"\"\"\n  cartItemsRemove(\n    \"\"\"Items to remove.\"\"\"\n    input: CartItemsRemoveInput!\n  ): CartItemsRemovePayload!\n\n  \"\"\"Increase the quantity of an existing cart item.\"\"\"\n  cartItemQuantityIncrease(\n    \"\"\"Item and quantity details.\"\"\"\n    input: CartItemQuantityIncreaseInput!\n  ): CartItemQuantityIncreasePayload!\n\n  \"\"\"\n  Decrease the quantity of an existing cart item.\n  If the resulting quantity would be zero or less, the item is removed.\n  \"\"\"\n  cartItemQuantityDecrease(\n    \"\"\"Item and quantity details.\"\"\"\n    input: CartItemQuantityDecreaseInput!\n  ): CartItemQuantityDecreasePayload!\n\n  \"\"\"\n  Apply a coupon code to the active cart. Appends to the existing set and returns\n  the recomputed cart, or typed errors when the code is rejected.\n  \"\"\"\n  cartCouponApply(\n    \"\"\"Coupon code to apply.\"\"\"\n    input: CartCouponApplyInput!\n  ): CartCouponApplyPayload!\n\n  \"\"\"\n  Remove a coupon code from the active cart. Idempotent when the code is not applied.\n  \"\"\"\n  cartCouponRemove(\n    \"\"\"Coupon code to remove.\"\"\"\n    input: CartCouponRemoveInput!\n  ): CartCouponRemovePayload!\n\n  \"\"\"\n  Re-check the active cart against the platform and return it with each line's\n  availability refreshed. Writes nothing: the cart is re-simulated and only\n  `items.variant.availability` is corrected, so a line the platform can no longer\n  fulfil comes back flagged for the shopper to remove. Quantities are never\n  altered, and totals stay as the cart reported them until that removal\n  recomputes them. Takes no arguments: the cart is resolved from the request\n  context and is never created.\n  \"\"\"\n  cartValidate: CartValidatePayload!\n\n  \"\"\"\n  Move the active cart onto the request's sales channel, then reconcile its locale. Takes no\n  arguments: the cart is resolved from the request context and is never created. An empty cart, or\n  a cart already on the active channel, does not send `sc`. Otherwise one POST to `items/update`\n  with `sc` re-sends every item's index and current quantity, so Checkout reprocesses that order\n  form and drops lines the destination cannot sell. An upstream failure is reported in `userErrors`\n  and does not throw.\n  \"\"\"\n  cartSalesChannelSync: CartSalesChannelSyncPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Write the provided profile fields to the active cart's clientProfileData\n  attachment. Partial: omitted fields are untouched. Never mints a cart.\n  \"\"\"\n  clientProfileUpdate(\n    \"\"\"Profile fields to write.\"\"\"\n    input: ClientProfileUpdateInput!\n  ): ClientProfileUpdatePayload!\n\n  \"\"\"\n  Write the provided preference flags to the active cart's clientPreferencesData\n  attachment. Partial: omitted flags are untouched. Never mints a cart.\n  \"\"\"\n  clientPreferencesUpdate(\n    \"\"\"Preference flags to write.\"\"\"\n    input: ClientPreferencesUpdateInput!\n  ): ClientPreferencesUpdatePayload!\n\n  \"\"\"\n  Set the full delivery address (delivery step). Auto-selects the cheapest SLA\n  when available. Never mints a cart.\n  \"\"\"\n  shippingAddressUpdate(\n    \"\"\"Address details to write.\"\"\"\n    input: ShippingAddressUpdateInput!\n  ): ShippingAddressUpdatePayload!\n\n  \"\"\"\n  Select one shipping option for the whole cart. Fans the selection out to\n  every item. Never mints a cart.\n  \"\"\"\n  shippingOptionSelect(\n    \"\"\"The option to select.\"\"\"\n    input: ShippingOptionSelectInput!\n  ): ShippingOptionSelectPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Select a payment method, optionally identifying a new card's BIN or a saved card's account.\n  \"\"\"\n  paymentMethodSelect(\n    \"\"\"Method (and optional BIN/saved-card) to select.\"\"\"\n    input: PaymentMethodSelectInput!\n  ): PaymentMethodSelectPayload!\n\n  \"\"\"\n  Select an installment count for the currently-selected method. Recomputes the cart total.\n  \"\"\"\n  paymentInstallmentSelect(\n    \"\"\"Installment count to select.\"\"\"\n    input: PaymentInstallmentSelectInput!\n  ): PaymentInstallmentSelectPayload!\n\n  \"\"\"Set the billing address, or fall back to the delivery address.\"\"\"\n  paymentBillingAddressUpdate(\n    \"\"\"\n    Billing address details, or sameAsDelivery: true to use the delivery address.\n    \"\"\"\n    input: PaymentBillingAddressUpdateInput!\n  ): PaymentBillingAddressUpdatePayload!\n\n  \"\"\"\n  Open a VTEX transaction from the currently-selected payment. No input: every field is server-derived.\n  \"\"\"\n  paymentStartTransaction: PaymentStartTransactionPayload!\n\n  \"\"\"\n  Finalize a transaction after the direct-to-gateway payment call succeeded.\n  \"\"\"\n  paymentGatewayCallback(\n    \"\"\"The order group to finalize.\"\"\"\n    input: PaymentGatewayCallbackInput!\n  ): PaymentGatewayCallbackPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Sign in with email and password. Returns the refreshed session, or typed\n  userErrors.\n  \"\"\"\n  sessionLoginWithPassword(\n    \"\"\"The email and password to authenticate with.\"\"\"\n    input: SessionPasswordLoginInput!\n  ): SessionLoginPayload!\n\n  \"\"\"\n  Request an email access code. Returns an opaque authenticationToken to\n  round-trip into validate.\n  \"\"\"\n  sessionRequestAccessCode(\n    \"\"\"The email to send the access code to.\"\"\"\n    input: SessionRequestAccessCodeInput!\n  ): SessionRequestAccessCodePayload!\n\n  \"\"\"\n  Validate an email access code with its authenticationToken. Returns the\n  refreshed session.\n  \"\"\"\n  sessionValidateAccessCode(\n    \"\"\"The email, access code, and authenticationToken to validate.\"\"\"\n    input: SessionValidateAccessCodeInput!\n  ): SessionLoginPayload!\n\n  \"\"\"\n  Sign out. Clears auth cookies and refreshes the order form to a guest session.\n  Idempotent.\n  \"\"\"\n  sessionLogout: SessionLoginPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Set the shopper's active region from a postal code. Accepts the value as the\n  shopper typed it, including any mask; the server normalizes it and derives the\n  city.\n  \"\"\"\n  regionUpdate(\n    \"\"\"The postal code to activate, masked or bare.\"\"\"\n    postalCode: String!\n  ): RegionUpdatePayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Partially update the signed-in shopper's own profile. Upserts: succeeds whether or not a record exists.\n  \"\"\"\n  customerProfileUpdate(\n    \"\"\"The fields to write. Provide only what the shopper edited.\"\"\"\n    input: CustomerProfileUpdateInput!\n  ): CustomerProfileUpdatePayload!\n\n  \"\"\"\n  Save a new address for the signed-in shopper. The store must ship to the country, and the\n  country's rules must accept the fields. Refusals come back as `userErrors`.\n  \"\"\"\n  customerAddressCreate(\n    \"\"\"The address to save.\"\"\"\n    input: CustomerAddressCreateInput!\n  ): CustomerAddressCreatePayload!\n\n  \"\"\"\n  Change one of the signed-in shopper's saved addresses. The merged address is validated\n  against its stored country. Refusals come back as `userErrors`.\n  \"\"\"\n  customerAddressUpdate(\n    \"\"\"The CustomerAddress global id, as returned by `customerAddresses`.\"\"\"\n    id: ID!\n\n    \"\"\"The fields to change. Provide only what the shopper edited.\"\"\"\n    input: CustomerAddressUpdateInput!\n  ): CustomerAddressUpdatePayload!\n\n  \"\"\"\n  Remove one of the signed-in shopper's saved addresses. An address that is already gone\n  counts as removed.\n  \"\"\"\n  customerAddressDelete(\n    \"\"\"The CustomerAddress global id, as returned by `customerAddresses`.\"\"\"\n    id: ID!\n  ): CustomerAddressDeletePayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Request the cancellation of one order owned by the signed-in shopper. Checkout\n  records the request and OMS applies it afterwards, so the returned order can\n  still show the previous status.\n  \"\"\"\n  customerOrderCancel(\n    \"\"\"Shopper-facing order number.\"\"\"\n    id: ID!\n\n    \"\"\"The optional reason.\"\"\"\n    input: CustomerOrderCancelInput!\n  ): CustomerOrderCancelPayload!\n}\n\nextend type Mutation {\n  \"\"\"\n  Removes one of the signed-in shopper's saved cards, by the id the\n  customerSavedCards read returned. Returns the refreshed list on success.\n  Throws UNAUTHORIZED / UPSTREAM_ERROR / UPSTREAM_TIMEOUT (ADR-00007).\n  \"\"\"\n  customerSavedCardRemove(\n    \"\"\"The card's id, as customerSavedCards returned it.\"\"\"\n    id: ID!\n  ): CustomerSavedCardRemovePayload!\n}\n\n\"\"\"\nA manufacturer or designer brand.\nMaps to VTEX Brand entity.\n\"\"\"\ntype Brand implements Node\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Human-readable brand name.\"\"\"\n  name: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Whether the brand is currently active in the storefront.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Brand logo image.\"\"\"\n  logo: Image\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated list of products belonging to this brand.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n}\n\n\"\"\"Paginated list of brands.\"\"\"\ntype BrandsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [BrandEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of brands matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype BrandEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Brand!\n}\n\n\"\"\"\nA hierarchical product classification level (department → category → subcategory).\nMaps to VTEX Category entity. The tree structure is modeled via parent/children\nreferences, allowing arbitrary depth.\n\"\"\"\ntype Category implements Node\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Display name of the category.\"\"\"\n  name: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Full materialized path, e.g. \\\"/clothing/shirts/casual\\\".\"\"\"\n  path: String!\n\n  \"\"\"Zero-indexed depth in the tree (0 = department).\"\"\"\n  level: Int!\n\n  \"\"\"Whether this category is currently active.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Parent category. Null for top-level departments.\"\"\"\n  parent: Category\n\n  \"\"\"Direct children of this category.\"\"\"\n  children: [Category!]!\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated products within this category.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n\n  \"\"\"Specification groups relevant to this category.\"\"\"\n  specificationGroups: [SpecificationGroup!]!\n}\n\n\"\"\"Paginated list of categories.\"\"\"\ntype CategoriesConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [CategoryEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of categories matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype CategoryEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Category!\n}\n\n\"\"\"\nA group of related specifications that apply to products in a category.\nMaps to VTEX Specification Group.\n\"\"\"\ntype SpecificationGroup {\n  \"\"\"Display name (e.g. \\\"Physical Attributes\\\", \\\"Technical Details\\\").\"\"\"\n  name: String!\n\n  \"\"\"Specifications in this group.\"\"\"\n  specifications: [Specification!]!\n}\n\n\"\"\"\nA product-level or variant-level specification field.\nMaps to VTEX Specification / Specification Field.\nExamples: \"Material\", \"Warranty Period\" (product-level);\n\"Color\", \"Size\" (variant-level / option axis).\n\"\"\"\ntype Specification {\n  \"\"\"Display label (e.g. \\\"Material\\\").\"\"\"\n  name: String!\n\n  \"\"\"The assigned values for this specification.\"\"\"\n  values: [String!]!\n\n  \"\"\"How this spec was captured.\"\"\"\n  fieldType: SpecificationFieldType!\n}\n\n\"\"\"A single breadcrumb entry in the product's navigation trail.\"\"\"\ntype BreadcrumbItem {\n  \"\"\"Human-readable label (e.g. \"Electronics\", \"Smartphones\").\"\"\"\n  name: String!\n\n  \"\"\"URL path for this breadcrumb level (e.g. \"/electronics/smartphones\").\"\"\"\n  url: String!\n\n  \"\"\"1-based position in the breadcrumb trail.\"\"\"\n  position: Int!\n}\n\n\"\"\"\nDiscriminates how a specification value was captured.\nMaps to VTEX FieldType numeric codes.\n\"\"\"\nenum SpecificationFieldType {\n  \"\"\"Free text.\"\"\"\n  TEXT\n\n  \"\"\"Multi-line free text.\"\"\"\n  MULTI_LINE_TEXT\n\n  \"\"\"Single-select dropdown.\"\"\"\n  COMBO\n\n  \"\"\"Single-select radio.\"\"\"\n  RADIO\n\n  \"\"\"Multi-select checkbox.\"\"\"\n  CHECKBOX\n\n  \"\"\"Rich text / HTML.\"\"\"\n  RICH_TEXT\n}\n\n\"\"\"\nA named option axis on a product that differentiates variants.\nThink \"Color\" or \"Size\". Each option has a set of possible values.\nSimilar to Shopify's ProductOption.\n\"\"\"\ntype ProductOption {\n  \"\"\"Option name (e.g. \\\"Color\\\").\"\"\"\n  name: String!\n\n  \"\"\"\n  All values available across variants (e.g. [\\\"Red\\\", \\\"Blue\\\", \\\"Green\\\"]).\n  \"\"\"\n  values: [String!]!\n}\n\n\"\"\"\nA concrete option/value pair selected on a specific variant.\nExample: { name: \"Color\", value: \"Red\" }.\n\"\"\"\ntype SelectedOption {\n  \"\"\"Option axis name.\"\"\"\n  name: String!\n\n  \"\"\"Selected value.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA purchasable unit of a product.\nMaps to VTEX SKU. In commerce, this is the concrete item a customer adds to cart —\na specific size/color/voltage combination of a product.\n\"\"\"\ntype Variant implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Variant display name (e.g. \\\"Varsity Red — Size 10\\\").\"\"\"\n  name: String!\n\n  \"\"\"Stock Keeping Unit code. Unique merchant-side identifier.\"\"\"\n  sku: String!\n\n  \"\"\"\n  PDP path segment in the active locale for this SKU, \"{linkId}-{skuId}\".\n  \"\"\"\n  routeSlug: String!\n\n  \"\"\"International Article Number (barcode). Maps to VTEX SKU EAN.\"\"\"\n  ean: String\n\n  \"\"\"Merchant reference code.\"\"\"\n  referenceId: String\n\n  \"\"\"Whether this variant is currently available for purchase.\"\"\"\n  availableForSale: Boolean!\n\n  \"\"\"Current selling price.\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before promotions. Null when there is no discount.\"\"\"\n  compareAtPrice: Money\n\n  \"\"\"All option selections that define this variant.\"\"\"\n  selectedOptions: [SelectedOption!]!\n\n  \"\"\"Variant images. First image is the primary.\"\"\"\n  images(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ImagesConnection!\n\n  \"\"\"Variant videos.\"\"\"\n  videos: [Video!]!\n\n  \"\"\"Quantity currently in stock. Null when inventory tracking is disabled.\"\"\"\n  quantityAvailable: Int\n\n  \"\"\"Unit of sale (e.g. \\\"un\\\", \\\"kg\\\", \\\"l\\\").\"\"\"\n  measurementUnit: String!\n\n  \"\"\"\n  Multiplier for the measurement unit (e.g. 1.5 means each unit is 1.5 kg).\n  \"\"\"\n  unitMultiplier: Float!\n\n  \"\"\"The parent product.\"\"\"\n  product: Product!\n\n  \"\"\"Variant-level specifications (e.g. voltage, plug type).\"\"\"\n  specifications: [Specification!]!\n\n  \"\"\"Add-on customizations available for this variant.\"\"\"\n  customizations: [Customization!]!\n\n  \"\"\"Sellers that fulfill this variant. Relevant in marketplace scenarios.\"\"\"\n  sellers: [Seller!]!\n}\n\n\"\"\"Paginated list of variants.\"\"\"\ntype VariantsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [VariantEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of variants matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype VariantEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Variant!\n}\n\n\"\"\"\nA product is a generic item in the catalog (e.g. \"Nike Zoom Janoski\").\nEach product has one or more variants (SKUs) that are the purchasable units.\nMaps to the VTEX Product entity.\n\"\"\"\ntype Product implements Node\n  @key(fields: \"slug\")\n  @cacheControl(maxAge: 60, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Product title as displayed in the storefront.\"\"\"\n  title: String!\n\n  \"\"\"URL-friendly handle / slug. Maps to VTEX `LinkId`.\"\"\"\n  slug: String!\n\n  \"\"\"\n  PDP path segment in the active locale, \"{linkId}-{skuId}\" with the representative SKU (in stock first, then lowest\n  spot price, then the first SKU). Build product URLs from this, not from `slug`.\n  \"\"\"\n  routeSlug: String!\n\n  \"\"\"Full marketing description.\"\"\"\n  description: String\n\n  \"\"\"Description rendered as HTML.\"\"\"\n  descriptionHtml: HTML\n\n  \"\"\"Vendor / manufacturer name. Shortcut for brand.name.\"\"\"\n  vendor: String\n\n  \"\"\"Whether this product is currently active on the storefront.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Whether to show the product even when out of stock.\"\"\"\n  showWhenOutOfStock: Boolean!\n\n  \"\"\"Date the product was first published.\"\"\"\n  publishedAt: DateTime\n\n  \"\"\"Release or launch date.\"\"\"\n  releaseDate: DateTime\n\n  \"\"\"Date the product was created in the system.\"\"\"\n  createdAt: DateTime!\n\n  \"\"\"Date the product was last updated.\"\"\"\n  updatedAt: DateTime!\n\n  \"\"\"Merchant reference ID. Maps to VTEX `RefId`.\"\"\"\n  referenceId: String\n\n  \"\"\"The brand this product belongs to.\"\"\"\n  brand: Brand\n\n  \"\"\"The primary (most specific) category.\"\"\"\n  category: Category\n\n  \"\"\"All ancestor categories up to the root department.\"\"\"\n  categories: [Category!]!\n\n  \"\"\"The price range across all variants.\"\"\"\n  priceRange: PriceRange!\n\n  \"\"\"The compare-at (original) price range across all variants.\"\"\"\n  compareAtPriceRange: PriceRange\n\n  \"\"\"Named option axes available on this product (e.g. Color, Size).\"\"\"\n  options: [ProductOption!]!\n\n  \"\"\"Product-level specifications (e.g. material, care instructions).\"\"\"\n  specifications: [Specification!]!\n\n  \"\"\"Specification groups with full detail.\"\"\"\n  specificationGroups: [SpecificationGroup!]!\n\n  \"\"\"All purchasable variants.\"\"\"\n  variants(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): VariantsConnection!\n\n  \"\"\"Total number of variants.\"\"\"\n  totalVariants: Int!\n\n  \"\"\"Product images aggregated from all variants.\"\"\"\n  images(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ImagesConnection!\n\n  \"\"\"All media (images + videos) for this product.\"\"\"\n  media(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 12\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): MediaConnection!\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Navigation breadcrumb trail from root category to this product.\"\"\"\n  breadcrumbs: [BreadcrumbItem!]!\n\n  \"\"\"User-generated review / rating summary.\"\"\"\n  rating: Rating\n\n  \"\"\"\n  Products related to this one (accessories, suggestions). Maps to VTEX SKU Complement.\n  \"\"\"\n  relatedProducts(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int = 10\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ProductsConnection!\n\n  \"\"\"Collections this product belongs to.\"\"\"\n  collections: [Collection!]!\n\n  \"\"\"\n  Sales channels where this product is available. Maps to VTEX Trade Policy.\n  \"\"\"\n  salesChannels: [SalesChannel!]!\n\n  \"\"\"Bundle components if this product is a kit. Maps to VTEX SKU Kit.\"\"\"\n  bundleItems: [BundleItem!]!\n}\n\n\"\"\"Paginated list of products.\"\"\"\ntype ProductsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [ProductEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of products matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype ProductEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Product!\n}\n\n\"\"\"Paginated list of images.\"\"\"\ntype ImagesConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [ImageEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype ImageEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Image!\n}\n\n\"\"\"Paginated list of media.\"\"\"\ntype MediaConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [MediaEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype MediaEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Media!\n}\n\n\"\"\"\nAggregate review/rating summary for a product.\nMaps to VTEX Product Review Rate.\n\"\"\"\ntype Rating {\n  \"\"\"Average score (e.g. 4.3).\"\"\"\n  average: Float!\n\n  \"\"\"Total number of reviews.\"\"\"\n  count: Int!\n}\n\n\"\"\"\nA curated group of products. Maps to VTEX Collection (Beta) entity.\nCollections can be used for seasonal promotions, editorial picks, etc.\n\"\"\"\ntype Collection implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Collection title.\"\"\"\n  title: String!\n\n  \"\"\"URL-friendly slug.\"\"\"\n  slug: String!\n\n  \"\"\"Editorial description.\"\"\"\n  description: String\n\n  \"\"\"Whether the collection is currently active.\"\"\"\n  isActive: Boolean!\n\n  \"\"\"Hero / banner image.\"\"\"\n  image: Image\n\n  \"\"\"SEO metadata.\"\"\"\n  seo: SEO\n\n  \"\"\"Paginated products in this collection.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n\n    \"\"\"Sorting criteria.\"\"\"\n    orderBy: ProductSortingInput\n\n    \"\"\"Filter criteria.\"\"\"\n    filter: ProductsFilterInput\n  ): ProductsConnection!\n}\n\n\"\"\"Paginated list of collections.\"\"\"\ntype CollectionsConnection {\n  \"\"\"A list of edges.\"\"\"\n  edges: [CollectionEdge!]!\n\n  \"\"\"Information to aid in pagination.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Total number of collections matching the query.\"\"\"\n  totalCount: Int!\n}\n\n\"\"\"An edge in a connection.\"\"\"\ntype CollectionEdge {\n  \"\"\"A cursor for pagination.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The item at the end of the edge.\"\"\"\n  node: Collection!\n}\n\n\"\"\"\nA seller / merchant that fulfills orders for one or more variants.\nMaps to VTEX Seller entity.\n\"\"\"\ntype Seller implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Seller display name.\"\"\"\n  name: String!\n\n  \"\"\"Whether this is the default (1P) seller.\"\"\"\n  isDefault: Boolean!\n\n  \"\"\"Seller logo.\"\"\"\n  logo: Image\n\n  \"\"\"\n  The seller's commercial offer for this variant (price, availability, installments).\n  \"\"\"\n  offer: Offer\n}\n\n\"\"\"\nA seller's commercial offer for a specific variant — includes pricing,\navailability, and available payment/installment options.\n\"\"\"\ntype Offer {\n  \"\"\"Current selling price.\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before promotions.\"\"\"\n  listPrice: Money!\n\n  \"\"\"\n  Best cash/immediate-payment price (e.g. Pix discount). Equals price when there is no spot discount.\n  \"\"\"\n  spotPrice: Money!\n\n  \"\"\"Price before any cart-level or coupon discounts.\"\"\"\n  priceWithoutDiscount: Money!\n\n  \"\"\"Available quantity from this seller.\"\"\"\n  availableQuantity: Int!\n\n  \"\"\"Tax amount.\"\"\"\n  tax: Money!\n\n  \"\"\"\n  Tax as a percentage of the price (e.g. 0.18 for 18%). Null when not applicable.\n  \"\"\"\n  taxPercentage: Float\n\n  \"\"\"Loyalty / reward points value earned on this purchase.\"\"\"\n  rewardValue: Float!\n\n  \"\"\"\n  ISO 8601 timestamp after which this price is no longer guaranteed. Null when open-ended.\n  \"\"\"\n  priceValidUntil: DateTime\n\n  \"\"\"SKU IDs of free gifts included with this offer.\"\"\"\n  giftSkuIds: [String!]!\n\n  \"\"\"\n  Named discount labels applied to this offer (e.g. \\\"10% off\\\", \\\"Black Friday\\\").\n  \"\"\"\n  discountHighlights: [String!]!\n\n  \"\"\"Available installment plans grouped by payment method.\"\"\"\n  installmentPlans: [InstallmentPlan!]!\n\n  \"\"\"\n  Active promotions applicable to this offer (e.g. bundle discounts, buy-X-get-Y).\n  \"\"\"\n  promotions: [Promotion!]!\n}\n\n\"\"\"\nA group of installment options for a single payment method (e.g. \"Visa\", \"Pix\").\n\"\"\"\ntype InstallmentPlan {\n  \"\"\"Payment method name (e.g. \\\"Visa\\\", \\\"Mastercard\\\", \\\"Pix\\\").\"\"\"\n  paymentMethod: String!\n\n  \"\"\"Payment method category.\"\"\"\n  paymentType: PaymentType!\n\n  \"\"\"\n  Available installment tiers, sorted by number of installments ascending.\n  \"\"\"\n  installments: [Installment!]!\n}\n\n\"\"\"\nA single installment tier within a payment method.\nExample: 6 × R$ 61.65 at 0% interest.\n\"\"\"\ntype Installment {\n  \"\"\"Number of installments (1 = single payment).\"\"\"\n  count: Int!\n\n  \"\"\"Amount per installment.\"\"\"\n  value: Money!\n\n  \"\"\"Total amount including any interest.\"\"\"\n  totalAmount: Money!\n\n  \"\"\"Annual interest rate as a percentage (0 = interest-free).\"\"\"\n  interestRate: Float!\n\n  \"\"\"Whether this tier is interest-free.\"\"\"\n  interestFree: Boolean!\n}\n\n\"\"\"Broad category of a payment method.\"\"\"\nenum PaymentType {\n  \"\"\"Credit card (Visa, Mastercard, Amex, etc.).\"\"\"\n  CREDIT_CARD\n\n  \"\"\"Debit card.\"\"\"\n  DEBIT_CARD\n\n  \"\"\"Instant / real-time payment (Pix, etc.).\"\"\"\n  INSTANT\n\n  \"\"\"Bank slip / boleto.\"\"\"\n  BANK_SLIP\n\n  \"\"\"Digital wallet or store-specific payment.\"\"\"\n  DIGITAL_WALLET\n\n  \"\"\"Other / unknown payment type.\"\"\"\n  OTHER\n}\n\n\"\"\"\nAn active promotion or incentive applicable to an offer.\nExamples: \"Buy 3 for R$14.99\", \"9% Pix discount\".\n\"\"\"\ntype Promotion {\n  \"\"\"Human-readable promotion name / headline.\"\"\"\n  name: String!\n\n  \"\"\"Conditions that must be met for the promotion to apply.\"\"\"\n  conditions: PromotionConditions!\n\n  \"\"\"Effects applied when conditions are met.\"\"\"\n  effects: PromotionEffects!\n}\n\n\"\"\"Conditions required for a promotion to activate.\"\"\"\ntype PromotionConditions {\n  \"\"\"Minimum quantity of items required (0 = no minimum).\"\"\"\n  minimumQuantity: Int!\n\n  \"\"\"\n  Additional condition parameters (e.g. required payment method, collection membership).\n  \"\"\"\n  parameters: [PromotionParameter!]!\n}\n\n\"\"\"Effects granted when a promotion's conditions are satisfied.\"\"\"\ntype PromotionEffects {\n  \"\"\"Effect parameters describing the discount or benefit.\"\"\"\n  parameters: [PromotionParameter!]!\n}\n\n\"\"\"\nA key-value parameter describing a promotion condition or effect.\nCommon keys: \\\"PercentualDiscount\\\", \\\"MaximumUnitPriceDiscount\\\",\n\\\"PaymentMethodId\\\", \\\"CollectionsIdsList\\\".\n\"\"\"\ntype PromotionParameter {\n  \"\"\"Parameter key.\"\"\"\n  name: String!\n\n  \"\"\"Parameter value.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA trade policy / sales channel through which products are sold.\nMaps to VTEX Trade Policy / Sales Channel.\n\"\"\"\ntype SalesChannel implements Node\n  @cacheControl(maxAge: 3600, scope: PUBLIC)\n{\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Channel name.\"\"\"\n  name: String!\n\n  \"\"\"ISO 4217 default currency for this channel.\"\"\"\n  currencyCode: CurrencyCode!\n\n  \"\"\"BCP 47 locale for this channel.\"\"\"\n  locale: Locale\n\n  \"\"\"Whether the channel is active.\"\"\"\n  isActive: Boolean!\n}\n\n\"\"\"\nAn optional, free-form customization that can be attached to a variant.\nMaps to VTEX Attachment. Examples: gift wrapping, engraving, custom message.\n\"\"\"\ntype Customization implements Node {\n  \"\"\"Globally unique identifier.\"\"\"\n  id: ID!\n\n  \"\"\"Display name (e.g. \\\"Gift Message\\\").\"\"\"\n  name: String!\n\n  \"\"\"Whether this customization is required.\"\"\"\n  isRequired: Boolean!\n\n  \"\"\"Allowed keys and their constraints.\"\"\"\n  fields: [CustomizationField!]!\n}\n\n\"\"\"A single input field within a customization.\"\"\"\ntype CustomizationField {\n  \"\"\"Field key (e.g. \\\"message\\\").\"\"\"\n  key: String!\n\n  \"\"\"Maximum allowed characters.\"\"\"\n  maxLength: Int\n\n  \"\"\"Regex or enum-based validation domain.\"\"\"\n  allowedValues: [String!]\n}\n\n\"\"\"\nA component of a product bundle / kit.\nMaps to VTEX SKU Kit.\n\"\"\"\ntype BundleItem {\n  \"\"\"The variant included in the bundle.\"\"\"\n  variant: Variant!\n\n  \"\"\"Quantity of this variant in the bundle.\"\"\"\n  quantity: Int!\n}\n\n\"\"\"Filter criteria for product queries.\"\"\"\ninput ProductsFilterInput {\n  \"\"\"Full-text search term.\"\"\"\n  searchTerm: String\n\n  \"\"\"Include only products in these category IDs.\"\"\"\n  categoryIds: [ID!]\n\n  \"\"\"Include only products from these brand IDs.\"\"\"\n  brandIds: [ID!]\n\n  \"\"\"Minimum price filter.\"\"\"\n  priceMin: Decimal\n\n  \"\"\"Maximum price filter.\"\"\"\n  priceMax: Decimal\n\n  \"\"\"Include only available (in-stock) products.\"\"\"\n  availableOnly: Boolean\n\n  \"\"\"Filter by product type / taxonomy label.\"\"\"\n  productType: String\n\n  \"\"\"\n  Filter by specification values, e.g. {name: \\\"Color\\\", values: [\\\"Red\\\", \\\"Blue\\\"]}.\n  \"\"\"\n  specifications: [SpecificationFilterInput!]\n\n  \"\"\"Filter by sales channel ID.\"\"\"\n  salesChannelId: ID\n\n  \"\"\"Filter by collection ID.\"\"\"\n  collectionId: ID\n\n  \"\"\"Include only products published after this date.\"\"\"\n  publishedAfter: DateTime\n\n  \"\"\"Include only products published before this date.\"\"\"\n  publishedBefore: DateTime\n\n  \"\"\"Filter by tags / keywords.\"\"\"\n  tags: [String!]\n}\n\n\"\"\"Allows filtering products by specification name and values.\"\"\"\ninput SpecificationFilterInput {\n  \"\"\"Specification name (e.g. \\\"Color\\\").\"\"\"\n  name: String!\n\n  \"\"\"Accepted values (OR semantics within, AND across different specs).\"\"\"\n  values: [String!]!\n}\n\n\"\"\"Sorting input for product queries.\"\"\"\ninput ProductSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: ProductSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting products.\"\"\"\nenum ProductSortField {\n  \"\"\"Alphabetical by title.\"\"\"\n  TITLE\n\n  \"\"\"By price (uses min variant price).\"\"\"\n  PRICE\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n\n  \"\"\"By last update date.\"\"\"\n  UPDATED_AT\n\n  \"\"\"By release date.\"\"\"\n  RELEASE_DATE\n\n  \"\"\"By relevance / scoring.\"\"\"\n  RELEVANCE\n\n  \"\"\"By number of sales.\"\"\"\n  BEST_SELLING\n}\n\n\"\"\"Filter criteria for collection queries.\"\"\"\ninput CollectionsFilterInput {\n  \"\"\"Full-text search term.\"\"\"\n  searchTerm: String\n\n  \"\"\"Include only active collections.\"\"\"\n  activeOnly: Boolean\n}\n\n\"\"\"Sorting input for collection queries.\"\"\"\ninput CollectionSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: CollectionSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting collections.\"\"\"\nenum CollectionSortField {\n  \"\"\"Alphabetical by title.\"\"\"\n  TITLE\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n\n  \"\"\"By last update date.\"\"\"\n  UPDATED_AT\n}\n\n\"\"\"Sorting input for brand queries.\"\"\"\ninput BrandSortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: BrandSortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting brands.\"\"\"\nenum BrandSortField {\n  \"\"\"Alphabetical by name.\"\"\"\n  NAME\n\n  \"\"\"By creation date.\"\"\"\n  CREATED_AT\n}\n\n\"\"\"Sorting input for category queries.\"\"\"\ninput CategorySortingInput {\n  \"\"\"Field to sort on.\"\"\"\n  field: CategorySortField!\n\n  \"\"\"Sort direction.\"\"\"\n  direction: SortDirection!\n}\n\n\"\"\"Fields available for sorting categories.\"\"\"\nenum CategorySortField {\n  \"\"\"Alphabetical by name.\"\"\"\n  NAME\n\n  \"\"\"By depth level in the tree.\"\"\"\n  LEVEL\n}\n\n\"\"\"\nThe result of a full-text product search, including facets for building\nfilter UI.\n\"\"\"\ntype ProductSearchResult {\n  \"\"\"Paginated product results.\"\"\"\n  products(\n    \"\"\"Returns the first N elements.\"\"\"\n    first: Int\n\n    \"\"\"Returns elements after this cursor.\"\"\"\n    after: Cursor\n\n    \"\"\"Returns the last N elements.\"\"\"\n    last: Int\n\n    \"\"\"Returns elements before this cursor.\"\"\"\n    before: Cursor\n  ): ProductsConnection!\n\n  \"\"\"Available facets/filters derived from the result set.\"\"\"\n  facets: [SearchFacet!]!\n\n  \"\"\"Corrected or suggested query if the original had a typo.\"\"\"\n  suggestedQuery: String\n\n  \"\"\"Spelling correction details for the query.\"\"\"\n  correction: SearchCorrection\n}\n\n\"\"\"Spelling correction information returned by the search engine.\"\"\"\ntype SearchCorrection {\n  \"\"\"Whether the original query was corrected.\"\"\"\n  corrected: Boolean!\n\n  \"\"\"Whether the original query was misspelled.\"\"\"\n  misspelled: Boolean!\n\n  \"\"\"The corrected query text.\"\"\"\n  text: String\n\n  \"\"\"The corrected text with `<em>` tags highlighting the changed parts.\"\"\"\n  highlighted: String\n}\n\n\"\"\"A facet returned from search, representing a filterable dimension.\"\"\"\ntype SearchFacet {\n  \"\"\"Facet name (e.g. \\\"Brand\\\", \\\"Color\\\", \\\"Price Range\\\").\"\"\"\n  name: String!\n\n  \"\"\"\n  Facet key used in filter parameters (e.g. \\\"brand\\\", \\\"category-1\\\", \\\"price\\\").\n  \"\"\"\n  key: String!\n\n  \"\"\"Type discriminator for rendering the correct UI control.\"\"\"\n  type: SearchFacetType!\n\n  \"\"\"Whether this facet should be hidden from the UI.\"\"\"\n  hidden: Boolean!\n\n  \"\"\"Total number of values in this facet.\"\"\"\n  quantity: Int!\n\n  \"\"\"Individual values within this facet.\"\"\"\n  values: [SearchFacetValue!]!\n}\n\n\"\"\"Discriminates the facet UI control type.\"\"\"\nenum SearchFacetType {\n  \"\"\"A list of discrete values (brand, color, size).\"\"\"\n  LIST\n\n  \"\"\"A numeric range (price).\"\"\"\n  RANGE\n}\n\n\"\"\"A single value within a search facet.\"\"\"\ntype SearchFacetValue {\n  \"\"\"Display label.\"\"\"\n  label: String!\n\n  \"\"\"Value to send back in the filter.\"\"\"\n  value: String!\n\n  \"\"\"Number of products matching this facet value.\"\"\"\n  count: Int!\n\n  \"\"\"Whether the user has currently selected this value.\"\"\"\n  isSelected: Boolean!\n\n  \"\"\"For RANGE facets: the lower bound.\"\"\"\n  rangeFrom: Float\n\n  \"\"\"For RANGE facets: the upper bound.\"\"\"\n  rangeTo: Float\n\n  \"\"\"Navigable href for this facet selection.\"\"\"\n  href: String\n}\n\n\"\"\"Recommendation strategy hint.\"\"\"\nenum RecommendationIntent {\n  \"\"\"Products related by purchase history.\"\"\"\n  RELATED\n\n  \"\"\"Products frequently bought together.\"\"\"\n  COMPLEMENTARY\n\n  \"\"\"Similar products (same category / specs).\"\"\"\n  SIMILAR\n}\n\n\"\"\"An autocomplete suggestion returned for a partial search query.\"\"\"\ntype AutocompleteSuggestion {\n  \"\"\"The suggested search term.\"\"\"\n  term: String!\n\n  \"\"\"Estimated number of results for this term.\"\"\"\n  count: Int!\n\n  \"\"\"\n  Suggested facet filters associated with this term (e.g. department, category).\n  \"\"\"\n  attributes: [AutocompleteAttribute!]!\n}\n\n\"\"\"A facet attribute suggested alongside an autocomplete term.\"\"\"\ntype AutocompleteAttribute {\n  \"\"\"Attribute key (e.g. \\\"category-1\\\").\"\"\"\n  key: String!\n\n  \"\"\"Attribute value (e.g. \\\"alimentos-e-bebidas\\\").\"\"\"\n  value: String!\n\n  \"\"\"Human-readable label for the key (e.g. \\\"Departamento\\\").\"\"\"\n  labelKey: String!\n\n  \"\"\"Human-readable label for the value (e.g. \\\"Alimentos e bebidas\\\").\"\"\"\n  labelValue: String!\n}\n\n\"\"\"A trending search term.\"\"\"\ntype TrendingSearch {\n  \"\"\"The search term.\"\"\"\n  term: String!\n\n  \"\"\"Number of searches in the recent period.\"\"\"\n  count: Int!\n}\n\n\"\"\"Identifies a catalog route. Set exactly one member.\"\"\"\ninput CatalogRouteInput {\n  \"\"\"\n  Relay node ID of the entity behind the route. Only Product IDs are accepted.\n  \"\"\"\n  id: ID\n\n  \"\"\"\n  Logical store route, without the binding's origin or base path\n  (e.g. \"/apparel/t-shirts\", \"/shirt-51/p\").\n  \"\"\"\n  path: String\n}\n\n\"\"\"Kind of entity a catalog route resolves to.\"\"\"\nenum CatalogRouteKind {\n  \"\"\"A product detail page.\"\"\"\n  PRODUCT\n\n  \"\"\"A category or subcategory page.\"\"\"\n  CATEGORY\n\n  \"\"\"A brand page.\"\"\"\n  BRAND\n\n  \"\"\"A collection page.\"\"\"\n  COLLECTION\n}\n\n\"\"\"\nA catalog route and its confirmed equivalents in every locale the catalog registers.\n\"\"\"\ntype CatalogRoute\n  @cacheControl(maxAge: 300, scope: PUBLIC)\n{\n  \"\"\"\n  Relay node ID of the entity. Stable across locales; the route's identity.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Kind of entity behind the route.\"\"\"\n  kind: CatalogRouteKind!\n\n  \"\"\"\n  One entry per locale the catalog confirms for every segment of the route. Editorial fallback never adds an\n  entry. May include locales the store does not publish; intersect with the store's bindings.\n  \"\"\"\n  variants: [CatalogRouteVariant!]!\n}\n\n\"\"\"A route's equivalent in one locale.\"\"\"\ntype CatalogRouteVariant {\n  \"\"\"BCP 47 tag, canonicalized.\"\"\"\n  locale: String!\n\n  \"\"\"\n  Route segment(s) in that locale, lowercased, accents kept. Not percent-encoded.\n  \"\"\"\n  slug: String!\n\n  \"\"\"\n  Relative logical path (\"/{slug}\" or \"/{slug}/p\"). No origin, no base path, not percent-encoded.\n  \"\"\"\n  path: String!\n}\n\n\"\"\"\nA shopping cart representing items a customer intends to purchase.\nMaps to the VTEX orderForm entity.\n\"\"\"\ntype Cart implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Globally unique identifier (Relay Node ID).\"\"\"\n  id: ID!\n\n  \"\"\"Line items currently in the cart.\"\"\"\n  items: [CartItem!]!\n\n  \"\"\"Aggregated totals (items, shipping, discounts, etc.).\"\"\"\n  totalizers: [CartTotalizer!]!\n\n  \"\"\"Total cart value.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Server messages from cart processing (e.g. promotions applied, stock warnings).\n  \"\"\"\n  messages: [CartMessage!]!\n\n  \"\"\"\n  The coupon codes currently applied to the cart. Empty when none are applied.\n  \"\"\"\n  appliedCoupons: [AppliedCoupon!]!\n\n  \"\"\"\n  Cart-level discounts as labeled lines: one per promotion or coupon, plus a\n  residual for whatever they do not account for. Always a list (possibly empty),\n  never null.\n  \n  The itemized companion to the aggregated \"Discounts\" totalizer, which stays on\n  `totalizers` unchanged: these entries sum to it, so a summary built on them\n  cannot under-report. Distinct from the per-line `CartItem.discounts`, which is\n  featured-only and itemized per price tag rather than per promotion.\n  \"\"\"\n  discounts: [CartDiscount!]!\n\n  \"\"\"\n  Aggregate item-level catalog markdown: the sum of `(listPrice - price) * quantity`\n  across non-gift lines, clamped at zero (in cents from VTEX, exposed as Money). This\n  is the reduction from each line's list price down to the price the \"Items\" subtotal\n  is built on — the catalog \"de/por\" savings baked into the price before any\n  cart-level promotion runs.\n  \n  Distinct money from the cart-level promotions and coupons on the \"Discounts\"\n  totalizer and `discounts` (those are `price - sellingPrice`, the reduction below the\n  subtotal): item markdown sits *above* the subtotal, so it is never part of\n  `totalizers` and never summed into `total`. It is an informational savings figure and\n  is zero when no line is marked down. Gift lines are excluded — a gift's value is\n  already a promotion entry in `discounts`.\n  \"\"\"\n  itemMarkdownTotal: Money!\n\n  \"\"\"\n  Progress toward the cart's nearest free-shipping promotion. Null when no\n  eligible free-shipping promotion is identified for this cart.\n  \"\"\"\n  freeShippingProgress: FreeShippingProgress\n\n  \"\"\"\n  Non-null when the cart belongs to a different sales channel than the request's active context. The\n  cart is left exactly as it was: nothing here reprices it or removes an item. Converging it is the\n  `cartSalesChannelSync` write, and that write makes Checkout reprocess the same orderForm — prices,\n  promotions, coupons and logistics are recomputed and items not sellable in the destination channel\n  are removed by Checkout, while orderFormId, attachments and addresses survive.\n  \"\"\"\n  salesChannelMismatch: CartSalesChannelMismatch\n}\n\n\"\"\"\nThe two sales channels that disagree. Both are trade-policy identifiers.\n\"\"\"\ntype CartSalesChannelMismatch {\n  \"\"\"The channel the cart is currently on.\"\"\"\n  cartSalesChannel: String!\n\n  \"\"\"The channel the request's active context resolves to.\"\"\"\n  activeSalesChannel: String!\n}\n\n\"\"\"\nProgress toward the cart's nearest free-shipping promotion, derived from the\npromotion teasers on a checkout simulation run with the cart's destination.\nNull until the cart has a destination, and when no eligible free-shipping\npromotion is identified for this cart (none configured, none teaser-emitting,\nempty cart, or unreadable promotion data) — absence is a normal state, never\nan error.\n\"\"\"\ntype FreeShippingProgress {\n  \"\"\"\n  Minimum qualifying cart total for the promotion. Null when the cart already\n  qualifies: the promotion teaser disappears once met, so the threshold is no\n  longer reported upstream.\n  \"\"\"\n  threshold: Money\n\n  \"\"\"Amount still to add to qualify. Zero when the cart qualifies.\"\"\"\n  remaining: Money!\n\n  \"\"\"Whether the cart currently qualifies for free shipping.\"\"\"\n  qualified: Boolean!\n}\n\n\"\"\"\nOne labeled cart-level discount line, attributed to the promotion or coupon that\ngranted it. Amounts are summed from the cart's price tags and reconciled against\nthe aggregated \"Discounts\" totalizer.\n\"\"\"\ntype CartDiscount {\n  \"\"\"\n  The promotion's name, or the coupon code exactly as the shopper entered it.\n  Null when nothing upstream names this amount: always for OTHER, and for a\n  promotion the platform left unnamed. The consumer supplies the label in that\n  case; an internal promotion identifier is never exposed here.\n  \"\"\"\n  name: String\n\n  \"\"\"\n  Amount taken off by this line, as a positive monetary value. The minus sign is\n  presentational and applied by the UI. Never zero: a promotion that took nothing\n  off this cart is omitted rather than reported as an empty line.\n  \"\"\"\n  value: Money!\n\n  \"\"\"\n  Where this line came from: an automatic promotion, a coupon, or the residual.\n  \"\"\"\n  kind: CartDiscountKind!\n}\n\n\"\"\"Origin of a cart-level discount line.\"\"\"\nenum CartDiscountKind {\n  \"\"\"An automatically applied promotion.\"\"\"\n  PROMOTION\n\n  \"\"\"A promotion matched by a coupon code the shopper entered.\"\"\"\n  COUPON\n\n  \"\"\"\n  The part of the aggregate discount that no named promotion or coupon accounts\n  for — a promotion the merchant did not feature, a discount the platform never\n  itemized, or rounding. At most one entry, always last.\n  \"\"\"\n  OTHER\n}\n\n\"\"\"\nA coupon code applied to the cart, with whether its promotion conditions matched.\n\"\"\"\ntype AppliedCoupon {\n  \"\"\"The coupon code, stored verbatim as the shopper entered it.\"\"\"\n  code: String!\n\n  \"\"\"\n  True when the code is on the cart but its promotion conditions did not match\n  (no discount granted).\n  \"\"\"\n  isUnmatchedCondition: Boolean!\n}\n\n\"\"\"\nA single line item in the cart. Carries a historical snapshot of the variant\nand product at the time it was added: cart-line value objects describe what\nthe customer actually has, not what the catalog says about it today.\n\"\"\"\ntype CartItem {\n  \"\"\"\n  Cart-scoped line identifier (opaque, stable across mutations for the same line).\n  Encoded as Base64(\"CartItem:<orderFormId>:<uniqueId>\"). Not a Relay Node; this id\n  exists only to serve as a stable cache key for clients doing optimistic UI.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Variant snapshot for this line. Built from the order line itself, not from\n  a live catalog read.\n  \"\"\"\n  variant: CartVariant!\n\n  \"\"\"\n  Product snapshot for this line. Built from the order line itself, not from\n  a live catalog read.\n  \"\"\"\n  product: CartProduct!\n\n  \"\"\"Quantity of this variant in the cart.\"\"\"\n  quantity: Int!\n\n  \"\"\"Unit price (in cents from VTEX, exposed as Money).\"\"\"\n  price: Money!\n\n  \"\"\"Original list price before discounts.\"\"\"\n  listPrice: Money!\n\n  \"\"\"Final selling price after discounts.\"\"\"\n  sellingPrice: Money!\n\n  \"\"\"Whether this line is a gift item.\"\"\"\n  gift: Boolean!\n\n  \"\"\"\n  Discounts applied to this line, one entry per featured promotion price tag that\n  carries a currency amount. Always a list (possibly empty), never null. The\n  per-line, itemized companion to the aggregated \"Discounts\" totalizer on Cart —\n  not a replacement for it.\n  \n  Percentage-configured promotions are absent: their price tag carries a rate\n  rather than an amount, so there is no monetary value to report per line. Use\n  `Cart.discounts` for a breakdown that accounts for every discount, naming what\n  it can and reporting the rest as a residual.\n  \"\"\"\n  discounts: [CartItemDiscount!]!\n\n  \"\"\"\n  Upstream line identifier (order-form uniqueId). The stable per-line address:\n  with customizations, the same variant can appear as several distinct lines,\n  so variantId is not unique per line. Stable across cart mutations.\n  \"\"\"\n  lineId: String!\n\n  \"\"\"\n  This line's own total (own unit selling price × quantity, rounding-exact),\n  excluding composition children.\n  \"\"\"\n  ownTotal: Money!\n\n  \"\"\"\n  This line's total including all nested composition children, recursively.\n  Equals ownTotal when the line has no compositions.\n  \"\"\"\n  total: Money!\n\n  \"\"\"\n  Form-based customizations applied to this line (personalization text,\n  selections, uploaded-file URLs). Empty when the line has none.\n  \"\"\"\n  customizations: [CartItemCustomization!]!\n\n  \"\"\"\n  Child products added to this line by bundle/assembly choices. Children are\n  not top-level cart lines; they ship, and are removed, with their parent.\n  \"\"\"\n  compositions: [CartItemComposition!]!\n\n  \"\"\"\n  The cart-wide delivery options this item is eligible for: the same ShippingOption\n  entities Shipping.options lists, carrying the shared-pool price, not a per-item\n  quote. Excludes pickup options; delivery channel only.\n  \"\"\"\n  shippingOptions: [ShippingOption!]!\n\n  \"\"\"\n  This item's own currently selected delivery option, or null when no selection\n  is persisted or the persisted selection is a pickup option.\n  \"\"\"\n  selectedShippingOption: ItemShippingOption\n}\n\n\"\"\"\nOne customization group applied to a cart line, keyed by the upstream\nassembly id. Entries are the shopper's submitted key/value pairs.\n\"\"\"\ntype CartItemCustomization {\n  \"\"\"Upstream assembly identifier (e.g. \"Engraving\", \"Optional features\").\"\"\"\n  id: String!\n\n  \"\"\"\n  Submitted values, one entry per input field. File uploads carry the file URL\n  as the value.\n  \"\"\"\n  entries: [CartItemCustomizationEntry!]!\n}\n\n\"\"\"A single submitted customization field.\"\"\"\ntype CartItemCustomizationEntry\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Field name as defined by the assembly (e.g. \"Text\").\"\"\"\n  name: String!\n\n  \"\"\"Submitted value, stringified. File uploads carry the file URL.\"\"\"\n  value: String!\n}\n\n\"\"\"\nA child product nested under a cart line by a bundle/assembly choice. Slim by\ndesign: children are not independently addressable cart lines. May carry its\nown children (nested assemblies).\n\"\"\"\ntype CartItemComposition {\n  \"\"\"\n  Identifier for this child line, scoped to the cart's order form or to the\n  order's group (same opaque encoding as CartItem.id). Cache key only; not\n  independently mutable.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Display name as recorded on the order line.\"\"\"\n  name: String!\n\n  \"\"\"Quantity of this child in the composition.\"\"\"\n  quantity: Int!\n\n  \"\"\"Unit selling price of the child.\"\"\"\n  price: Money!\n\n  \"\"\"\n  The child's own availability. The parent's variant.availability already\n  reflects the worst state across the whole composition.\n  \"\"\"\n  availability: CartItemAvailability!\n\n  \"\"\"\n  The assembly group that added this child (upstream parentAssemblyBinding,\n  e.g. \"Material Product_Material\").\n  \"\"\"\n  assemblyId: String!\n\n  \"\"\"This child's own total, excluding its nested children.\"\"\"\n  ownTotal: Money!\n\n  \"\"\"This child's total including its nested children, recursively.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Form-based customizations applied to this child. A composition child is\n  itself an order-form line and can carry its own input assemblies. Empty\n  when it has none.\n  \"\"\"\n  customizations: [CartItemCustomization!]!\n\n  \"\"\"Nested composition children of this child. Empty when it has none.\"\"\"\n  compositions: [CartItemComposition!]!\n}\n\n\"\"\"\nA single discount applied to a cart line, broken out from that line's price tags.\nSourced from items[].priceTags filtered to featured promotions carrying a currency\namount; the aggregate discount total stays on the Cart \"Discounts\" totalizer.\n\"\"\"\ntype CartItemDiscount {\n  \"\"\"\n  Human-readable label resolved from the matched promotion (e.g. \"Black Friday\").\n  Falls back to the price tag identifier when the promotion has no name.\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Amount taken off by this discount, as a positive monetary value. The minus\n  sign is presentational and applied by the UI.\n  \"\"\"\n  value: Money!\n\n  \"\"\"\n  Always false. A price tag expressing a percentage carries a rate rather than a\n  currency amount, so it has no value this type can report and is excluded from\n  the list. Retained for compatibility; branching on it gains nothing.\n  \"\"\"\n  isPercentual: Boolean!\n}\n\n\"\"\"\nStock availability status for a cart line. Mapped from the upstream\norder-form availability strings; UNKNOWN absorbs values we haven't classified.\n\"\"\"\nenum CartItemAvailability {\n  \"\"\"In stock and shippable.\"\"\"\n  AVAILABLE\n\n  \"\"\"Known to be out of stock.\"\"\"\n  OUT_OF_STOCK\n\n  \"\"\"\n  Other known-bad states (cannot deliver, fulfillment unavailable, etc.).\n  \"\"\"\n  UNAVAILABLE\n\n  \"\"\"Upstream returned a state we don't recognize yet.\"\"\"\n  UNKNOWN\n}\n\n\"\"\"\nCart-line snapshot of a Variant. Value object: holds the line-level facts\nrecorded at add-to-cart time. Does not implement Node; refetch the live\ncatalog Variant via Query.node(variantId) when needed.\n\"\"\"\ntype CartVariant {\n  \"\"\"\n  Relay Node ID of the catalog Variant this line refers to. Use it with\n  Query.node to refetch the live Variant.\n  \"\"\"\n  variantId: ID!\n\n  \"\"\"Stock-keeping unit code as recorded on the order line.\"\"\"\n  sku: String!\n\n  \"\"\"\n  Display name as recorded on the order line (e.g. \"Classic T-Shirt - Red / M\").\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Single image captured at add-to-cart time. Null when no image URL was recorded.\n  \"\"\"\n  image: Image\n\n  \"\"\"\n  International Article Number (barcode). May be empty for items without one.\n  \"\"\"\n  ean: String\n\n  \"\"\"Merchant SKU reference code.\"\"\"\n  referenceId: String\n\n  \"\"\"Availability classification of this line.\"\"\"\n  availability: CartItemAvailability!\n\n  \"\"\"Unit of sale (e.g. \"un\", \"kg\").\"\"\"\n  measurementUnit: String!\n\n  \"\"\"Multiplier for the measurement unit.\"\"\"\n  unitMultiplier: Float!\n\n  \"\"\"Seller fulfilling this line.\"\"\"\n  seller: CartSellerRef!\n\n  \"\"\"\n  Variations selected on this cart line (e.g. Cor: Vermelho, Tamanho: M). [] when the SKU has\n  no variations, never null. Resolved server-side from catalog data (ADR-00012); use this field\n  instead of a Query.node(variantId) refetch to read a line's selected options.\n  \"\"\"\n  selectedOptions: [SelectedOption!]!\n}\n\n\"\"\"\nCart-line snapshot of a Product. Value object: holds the line-level facts\nrecorded at add-to-cart time. Does not implement Node; refetch the live\ncatalog Product via Query.node(productId) when needed.\n\"\"\"\ntype CartProduct {\n  \"\"\"\n  Relay Node ID of the catalog Product. Use it with Query.node to refetch\n  the live Product.\n  \"\"\"\n  productId: ID!\n\n  \"\"\"Product title as recorded on the order line.\"\"\"\n  title: String!\n\n  \"\"\"Product detail URL as recorded on the order line.\"\"\"\n  detailUrl: String!\n\n  \"\"\"Categories root-to-leaf as recorded on the order line.\"\"\"\n  categories: [CartCategoryRef!]!\n\n  \"\"\"\n  Brand reference as recorded on the order line. Null when the product has no brand.\n  \"\"\"\n  brand: CartBrandRef\n}\n\n\"\"\"\nLightweight reference to a Category captured on a cart line. Carries enough\nidentity to deep-link back to the live Category via Query.node.\n\"\"\"\ntype CartCategoryRef {\n  \"\"\"Relay Node ID of the catalog Category.\"\"\"\n  categoryId: ID!\n\n  \"\"\"Category name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"Lightweight reference to a Brand captured on a cart line.\"\"\"\ntype CartBrandRef {\n  \"\"\"Relay Node ID of the catalog Brand.\"\"\"\n  brandId: ID!\n\n  \"\"\"Brand name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"Lightweight reference to a Seller captured on a cart line.\"\"\"\ntype CartSellerRef {\n  \"\"\"Relay Node ID of the catalog Seller.\"\"\"\n  sellerId: ID!\n\n  \"\"\"Seller display name as recorded on the order line.\"\"\"\n  name: String!\n}\n\n\"\"\"\nAn aggregated total section in the cart (e.g. Items, Shipping, Discounts).\n\"\"\"\ntype CartTotalizer {\n  \"\"\"Totalizer key (e.g. \"Items\", \"Shipping\", \"Discounts\").\"\"\"\n  id: String!\n\n  \"\"\"Human-readable label.\"\"\"\n  name: String!\n\n  \"\"\"Totalizer value.\"\"\"\n  value: Money!\n}\n\n\"\"\"\nA server message attached to the cart (promotions applied, warnings, etc.).\n\"\"\"\ntype CartMessage {\n  \"\"\"Message code identifier.\"\"\"\n  code: String\n\n  \"\"\"Human-readable message text.\"\"\"\n  text: String!\n\n  \"\"\"Message severity (e.g. \"info\", \"warning\", \"error\").\"\"\"\n  status: String!\n}\n\n\"\"\"Input for adding an item to a cart.\"\"\"\ninput CartItemAddInput {\n  \"\"\"The variant's global Node ID to add.\"\"\"\n  variantId: ID!\n\n  \"\"\"Quantity to add. Defaults to 1.\"\"\"\n  quantity: Int = 1\n\n  \"\"\"\n  The seller's global Node ID. Defaults to the first-party seller (Seller:1).\n  \"\"\"\n  seller: ID = \"U2VsbGVyOjE=\"\n}\n\n\"\"\"Input for removing a line from a cart.\"\"\"\ninput CartItemRemoveInput {\n  \"\"\"The line to remove: its `CartItem.lineId`.\"\"\"\n  lineId: String!\n}\n\n\"\"\"Input for removing multiple lines from a cart in one call.\"\"\"\ninput CartItemsRemoveInput {\n  \"\"\"\n  The lines to remove: their `CartItem.lineId` values. Duplicates are collapsed.\n  \"\"\"\n  lineIds: [String!]!\n}\n\n\"\"\"Input for increasing the quantity of a cart line.\"\"\"\ninput CartItemQuantityIncreaseInput {\n  \"\"\"The line whose quantity to increase: its `CartItem.lineId`.\"\"\"\n  lineId: String!\n\n  \"\"\"Amount to add to the current quantity. Defaults to 1.\"\"\"\n  quantityToAdd: Int = 1\n}\n\n\"\"\"Input for decreasing the quantity of a cart line.\"\"\"\ninput CartItemQuantityDecreaseInput {\n  \"\"\"The line whose quantity to decrease: its `CartItem.lineId`.\"\"\"\n  lineId: String!\n\n  \"\"\"Amount to subtract from the current quantity. Defaults to 1.\"\"\"\n  quantityToRemove: Int = 1\n}\n\n\"\"\"Input for applying a coupon code to the cart.\"\"\"\ninput CartCouponApplyInput {\n  \"\"\"The coupon code to apply, sent verbatim.\"\"\"\n  code: String!\n}\n\n\"\"\"Input for removing a coupon code from the cart.\"\"\"\ninput CartCouponRemoveInput {\n  \"\"\"The coupon code to remove from the applied set.\"\"\"\n  code: String!\n}\n\n\"\"\"Error codes for cart item add operations.\"\"\"\nenum CartItemAddErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n\n  \"\"\"The provided seller ID is not a valid Seller Node ID.\"\"\"\n  INVALID_SELLER_ID\n}\n\n\"\"\"Error codes for cart item remove operations.\"\"\"\nenum CartItemRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The specified line was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The upstream checkout API returned an unusable response.\"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"Error codes for cart items batch remove operations.\"\"\"\nenum CartItemsRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"None of the specified lines were found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The input contained no line IDs.\"\"\"\n  NO_LINE_IDS_PROVIDED\n\n  \"\"\"The upstream checkout API returned an unusable response.\"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"Error codes for cart item quantity increase operations.\"\"\"\nenum CartItemQuantityIncreaseErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The specified line was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The upstream checkout API returned an unusable response.\"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"Error codes for cart item quantity decrease operations.\"\"\"\nenum CartItemQuantityDecreaseErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The quantity must be a positive integer.\"\"\"\n  INVALID_QUANTITY\n\n  \"\"\"The specified line was not found in the cart.\"\"\"\n  ITEM_NOT_FOUND\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The upstream checkout API returned an unusable response.\"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"A domain error returned from a cart item add mutation.\"\"\"\ntype CartItemAddError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemAddErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item remove mutation.\"\"\"\ntype CartItemRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart items batch remove mutation.\"\"\"\ntype CartItemsRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemsRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item quantity increase mutation.\"\"\"\ntype CartItemQuantityIncreaseError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemQuantityIncreaseErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart item quantity decrease mutation.\"\"\"\ntype CartItemQuantityDecreaseError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartItemQuantityDecreaseErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartItemAdd mutation.\"\"\"\ntype CartItemAddPayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemAddError!]!\n}\n\n\"\"\"Payload returned by the cartItemRemove mutation.\"\"\"\ntype CartItemRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemRemoveError!]!\n}\n\n\"\"\"Payload returned by the cartItemsRemove mutation.\"\"\"\ntype CartItemsRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemsRemoveError!]!\n}\n\n\"\"\"Payload returned by the cartItemQuantityIncrease mutation.\"\"\"\ntype CartItemQuantityIncreasePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemQuantityIncreaseError!]!\n}\n\n\"\"\"Payload returned by the cartItemQuantityDecrease mutation.\"\"\"\ntype CartItemQuantityDecreasePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartItemQuantityDecreaseError!]!\n}\n\n\"\"\"Error codes for cart coupon apply operations.\"\"\"\nenum CartCouponApplyErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The coupon code is empty, unknown, or not accepted by this cart.\"\"\"\n  COUPON_NOT_FOUND\n\n  \"\"\"The coupon code has expired.\"\"\"\n  COUPON_EXPIRED\n\n  \"\"\"\n  The code was rejected while another coupon was applied, and the applied coupons were kept. The\n  platform does not say whether the code is unknown or cannot be combined with them.\n  \"\"\"\n  COUPON_NOT_COMBINED\n}\n\n\"\"\"Error codes for cart coupon remove operations.\"\"\"\nenum CartCouponRemoveErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  A surviving coupon was rejected by the cart after the removal (unknown or not accepted).\n  \"\"\"\n  COUPON_NOT_FOUND\n\n  \"\"\"A surviving coupon has expired.\"\"\"\n  COUPON_EXPIRED\n}\n\n\"\"\"A domain error returned from a cart coupon apply mutation.\"\"\"\ntype CartCouponApplyError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartCouponApplyErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a cart coupon remove mutation.\"\"\"\ntype CartCouponRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartCouponRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartCouponApply mutation.\"\"\"\ntype CartCouponApplyPayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartCouponApplyError!]!\n}\n\n\"\"\"Payload returned by the cartCouponRemove mutation.\"\"\"\ntype CartCouponRemovePayload {\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartCouponRemoveError!]!\n}\n\n\"\"\"Error codes for cart validation operations.\"\"\"\nenum CartValidateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  The upstream checkout API could not be reached or returned an unusable response.\n  \"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"A domain error returned from a cart validate mutation.\"\"\"\ntype CartValidateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartValidateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the cartValidate mutation.\"\"\"\ntype CartValidatePayload {\n  \"\"\"The re-checked cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartValidateError!]!\n}\n\n\"\"\"Error codes for moving a cart onto the active sales channel.\"\"\"\nenum CartSalesChannelSyncErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  The upstream checkout API could not be reached or returned an unusable response.\n  \"\"\"\n  UPSTREAM_ERROR\n}\n\n\"\"\"A domain error returned from the cartSalesChannelSync mutation.\"\"\"\ntype CartSalesChannelSyncError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CartSalesChannelSyncErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"\nPayload returned by the cartSalesChannelSync mutation.\n\nThe cart comes from the request context and is never created. An empty cart, or a cart already on\nthe active sales channel, does not send `sc`. Otherwise one POST to `items/update` with `sc`\nre-sends every item's index and current quantity, so Checkout reprocesses that order form and drops\nlines the destination cannot sell, and then the locale is reconciled. An upstream failure is\nreported in `userErrors` and does not throw.\n\"\"\"\ntype CartSalesChannelSyncPayload {\n  \"\"\"\n  The cart after the channel move and locale reconciliation, or null if errors occurred.\n  \"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [CartSalesChannelSyncError!]!\n}\n\n\"\"\"The delivery channel for a shipping option.\"\"\"\nenum DeliveryChannel {\n  \"\"\"Home delivery.\"\"\"\n  DELIVERY\n\n  \"\"\"Pickup in store or pickup point.\"\"\"\n  PICKUP\n\n  \"\"\"Unrecognised delivery channel returned by the fulfillment provider.\"\"\"\n  UNKNOWN\n}\n\n\"\"\"The unit of a shipping time estimate.\"\"\"\nenum ShippingEstimateUnit {\n  \"\"\"Calendar days (e.g. \"7d\").\"\"\"\n  DAYS\n\n  \"\"\"Business days, excluding weekends and holidays (e.g. \"5bd\").\"\"\"\n  BUSINESS_DAYS\n\n  \"\"\"Hours (e.g. \"7h\").\"\"\"\n  HOURS\n\n  \"\"\"Minutes (e.g. \"119m\").\"\"\"\n  MINUTES\n}\n\n\"\"\"\nParsed shipping time estimate (e.g. \"5bd\" → { value: 5, unit: BUSINESS_DAYS }).\n\"\"\"\ntype ShippingEstimate {\n  \"\"\"Numeric quantity of the estimate.\"\"\"\n  value: Int!\n\n  \"\"\"Time unit for the estimate.\"\"\"\n  unit: ShippingEstimateUnit!\n}\n\n\"\"\"\nOne cart item's current selection. Its price and estimate are Checkout's real values for\nthis item; option carries the shared name and channel. All values are a live snapshot:\nanother item joining or leaving the same SLA can change them.\n\"\"\"\ntype ItemShippingOption {\n  \"\"\"\n  Opaque delivery option identifier, encoded to distinguish per-item options\n  from cart-wide options so the Apollo cache never conflates them.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The cart-wide shipping option this selection belongs to.\"\"\"\n  option: ShippingOption!\n\n  \"\"\"Estimated shipping time for this item.\"\"\"\n  shippingEstimate: ShippingEstimate!\n\n  \"\"\"Shipping cost for this item. Zero when free shipping applies.\"\"\"\n  price: Money!\n\n  \"\"\"Shipping list price for this item before any promotions.\"\"\"\n  listPrice: Money!\n}\n\n\"\"\"\nA shipping option with at least one cart item currently selected on it. Its price and\nshippingEstimateList cover only those items, recomputed on every request.\n\"\"\"\ntype SelectedShippingOption {\n  \"\"\"The cart-wide shipping option these items selected.\"\"\"\n  option: ShippingOption!\n\n  \"\"\"\n  Cart items currently selected on this option (not every eligible item).\n  \"\"\"\n  items: [CartItem!]!\n\n  \"\"\"Sum of items[].selectedShippingOption.price.\"\"\"\n  price: Money!\n\n  \"\"\"Sum of items[].selectedShippingOption.listPrice.\"\"\"\n  listPrice: Money!\n\n  \"\"\"\n  items[].selectedShippingOption.shippingEstimate, one entry per item, unreduced and\n  uncompared.\n  \"\"\"\n  shippingEstimateList: [ShippingEstimate!]!\n}\n\n\"\"\"A shipping option available for a given item and destination.\"\"\"\ntype ShippingOption {\n  \"\"\"Opaque delivery option identifier.\"\"\"\n  id: ID!\n\n  \"\"\"\n  Human-readable option name (e.g. \"Standard Delivery\"). Derived from a Checkout simulation, which\n  sends no `Accept-Language` and keys its SKU cache without a locale, so this text is NOT localized:\n  it may read in the account's default culture on a non-default binding.\n  \"\"\"\n  name: String!\n\n  \"\"\"Delivery channel: home delivery or pickup.\"\"\"\n  channel: DeliveryChannel!\n\n  \"\"\"\n  Estimated shipping time, sampled from one eligible item. Delivery estimates can genuinely vary\n  per item under the same option; use shippingEstimateList for every item's own value.\n  \"\"\"\n  shippingEstimate: ShippingEstimate! @deprecated(reason: \"Sampled from one item and can misrepresent the others. Use shippingEstimateList.\") @deprecationDate(deletionDate: \"2027-03-31\")\n\n  \"\"\"\n  Every eligible item's own shippingEstimate, one entry per item, unreduced and uncompared.\n  \"\"\"\n  shippingEstimateList: [ShippingEstimate!]!\n\n  \"\"\"\n  Shipping cost for every item this option covers. Zero when free shipping applies. A live\n  estimate of the shared per-SLA pool, not a guaranteed quote.\n  \"\"\"\n  price: Money!\n\n  \"\"\"Shipping list price before any promotions, summed like price.\"\"\"\n  listPrice: Money!\n\n  \"\"\"Cart items for which this option is currently available.\"\"\"\n  items: [CartItem!]!\n}\n\n\"\"\"Error codes for shipping simulation operations.\"\"\"\nenum ShippingSimulateErrorCode {\n  \"\"\"The postal code was not found or rejected by the fulfillment provider.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The provided variant ID is not a valid Variant Node ID.\"\"\"\n  INVALID_VARIANT_ID\n\n  \"\"\"The provided seller ID is not a valid Seller Node ID.\"\"\"\n  INVALID_SELLER_ID\n\n  \"\"\"\n  No active cart in context: the cartShippingSimulation query requires an x-order-form-id and never mints a cart.\n  \"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"\n  The country is not an ISO 3166-1 alpha-3 code (three capital letters). Refused before any upstream call.\n  \"\"\"\n  INVALID_COUNTRY_CODE\n}\n\n\"\"\"A domain error returned from the shippingSimulation query.\"\"\"\ntype ShippingSimulateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingSimulateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingSimulation query.\"\"\"\ntype ShippingSimulationPayload {\n  \"\"\"\n  Available shipping options for the given item and destination.\n  Null when userErrors is non-empty.\n  \"\"\"\n  shippingOptions: [ShippingOption!]\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingSimulateError!]!\n}\n\n\"\"\"Input for simulating shipping options for a single variant on a PDP.\"\"\"\ninput ShippingSimulateInput {\n  \"\"\"Postal code of the delivery destination.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n\n  \"\"\"The variant's global Node ID to simulate shipping for.\"\"\"\n  variantId: ID!\n\n  \"\"\"Quantity of the variant. Must be at least 1.\"\"\"\n  quantity: Int!\n\n  \"\"\"The seller's global Node ID responsible for the variant.\"\"\"\n  seller: ID!\n}\n\n\"\"\"\nInput for simulating shipping for the whole active cart. Carries the\ndestination only; items are sourced from the cart in the x-order-form-id\ncontext, so there is no variant, quantity, or seller.\n\"\"\"\ninput CartShippingSimulateInput {\n  \"\"\"Postal code of the delivery destination.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n}\n\n\"\"\"Payload returned by the cartShippingSimulation query.\"\"\"\ntype CartShippingSimulationPayload {\n  \"\"\"\n  Shipping options available for every item in the cart, prices summed across\n  items. Empty when the cart is empty or no option is common to all items.\n  Null when userErrors is non-empty.\n  \"\"\"\n  shippingOptions: [ShippingOption!]\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingSimulateError!]!\n}\n\n\"\"\"\nThe shopper's profile, projected from the order form's clientProfileData.\nA sibling of Cart, not nested under it. Individual (B2C) only.\n\"\"\"\ntype ClientProfile implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Contact email as recorded on the order form. Null when no profile is set.\n  \"\"\"\n  email: String\n\n  \"\"\"Given name. Null when unset.\"\"\"\n  firstName: String\n\n  \"\"\"Family name. Null when unset.\"\"\"\n  lastName: String\n\n  \"\"\"Contact phone in the order form's stored format. Null when unset.\"\"\"\n  phone: String\n\n  \"\"\"Tax document (CPF for Individual shoppers). Null when unset.\"\"\"\n  document: String\n}\n\n\"\"\"\nThe shopper's preference opt-ins, projected from the order form's\nclientPreferencesData. A sibling of Cart, not nested under it.\n\"\"\"\ntype ClientPreferences implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"Newsletter opt-in. Null when the shopper has not chosen.\"\"\"\n  optinNewsLetter: Boolean\n\n  \"\"\"Save-personal-data opt-in. Null when the shopper has not chosen.\"\"\"\n  savePersonalData: Boolean\n}\n\n\"\"\"\nPartial profile update. Provide only the fields to write; omitted fields are\nleft unchanged.\n\"\"\"\ninput ClientProfileUpdateInput {\n  \"\"\"Contact email to write. Omit to leave unchanged.\"\"\"\n  email: String\n\n  \"\"\"Given name to write. Omit to leave unchanged.\"\"\"\n  firstName: String\n\n  \"\"\"Family name to write. Omit to leave unchanged.\"\"\"\n  lastName: String\n\n  \"\"\"Contact phone to write. Omit to leave unchanged.\"\"\"\n  phone: String\n\n  \"\"\"Tax document to write. Omit to leave unchanged.\"\"\"\n  document: String\n}\n\n\"\"\"\nPartial preferences update. Provide only the flags to write; omitted flags are\nleft unchanged.\n\"\"\"\ninput ClientPreferencesUpdateInput {\n  \"\"\"Newsletter opt-in to write. Omit to leave unchanged.\"\"\"\n  optinNewsLetter: Boolean\n\n  \"\"\"Save-personal-data opt-in to write. Omit to leave unchanged.\"\"\"\n  savePersonalData: Boolean\n}\n\n\"\"\"Error codes for client profile update operations.\"\"\"\nenum ClientProfileUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The input contained no profile fields to write.\"\"\"\n  NO_PROFILE_FIELD_PROVIDED\n}\n\n\"\"\"Error codes for client preferences update operations.\"\"\"\nenum ClientPreferencesUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The input contained no preferences to write.\"\"\"\n  NO_PREFERENCE_PROVIDED\n}\n\n\"\"\"A domain error returned from a client profile update mutation.\"\"\"\ntype ClientProfileUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ClientProfileUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"A domain error returned from a client preferences update mutation.\"\"\"\ntype ClientPreferencesUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ClientPreferencesUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the clientProfileUpdate mutation.\"\"\"\ntype ClientProfileUpdatePayload {\n  \"\"\"The updated profile, or null if a context/validation error occurred.\"\"\"\n  clientProfile: ClientProfile\n\n  \"\"\"\n  The session after the write, reflecting the now-current isIdentified derived from\n  clientProfileData.email. Null alongside clientProfile on a context/validation error.\n  \"\"\"\n  session: Session\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ClientProfileUpdateError!]!\n}\n\n\"\"\"Payload returned by the clientPreferencesUpdate mutation.\"\"\"\ntype ClientPreferencesUpdatePayload {\n  \"\"\"\n  The updated preferences, or null if a context/validation error occurred.\n  \"\"\"\n  clientPreferences: ClientPreferences\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ClientPreferencesUpdateError!]!\n}\n\n\"\"\"\nThe delivery address, saved addresses, and shipping options for the cart.\nA read-only sibling of Cart, projected from the same order form fetch.\nNull fields project explicitly (never undefined), allowing partial queries.\n\"\"\"\ntype Shipping implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The delivery address on the cart. Null until the shopper provides one.\"\"\"\n  address: Address\n\n  \"\"\"The logged-in shopper's saved addresses. Empty for anonymous shoppers.\"\"\"\n  savedAddresses: [Address!]!\n\n  \"\"\"\n  Delivery-channel shipping options any cart item is eligible for at the current address, prices summed across the eligible items.\n  \"\"\"\n  options: [ShippingOption!]!\n\n  \"\"\"\n  Delivery-channel options with at least one item currently selected on them, one entry per option. Pickup selections are excluded.\n  \"\"\"\n  selectedOptions: [SelectedShippingOption!]!\n\n  \"\"\"\n  The selected option, when one selection applies to the whole cart. Null when items disagree or the persisted selection is a pickup-channel SLA.\n  \"\"\"\n  selectedOptionId: ID @deprecated(reason: \"Cannot express split shipping. Use Shipping.selectedOptions.\") @deprecationDate(deletionDate: \"2027-03-31\")\n}\n\n\"\"\"A delivery address or saved-address reference.\"\"\"\ntype Address\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Saved-address reference. Null for addresses entered in this session.\"\"\"\n  id: ID\n\n  \"\"\"Recipient name for this address.\"\"\"\n  recipientName: String\n\n  \"\"\"\n  Postal code. Required when persisting an address via the mutation inputs, but nullable here:\n  pickup/search/disposable addresses and legacy saved addresses can come back without one.\n  \"\"\"\n  postalCode: String\n\n  \"\"\"\n  ISO 3166-1 alpha-3 country code. Required when persisting an address via the mutation inputs,\n  but nullable here for the same reason as postalCode.\n  \"\"\"\n  country: String\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n}\n\n\"\"\"\nThe shopper's session and authentication state for the active order form.\nA read-only sibling of Cart, projected from the same order form fetch. Carries\nno profile data — profile fields live on ClientProfile.\n\"\"\"\ntype Session implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Whether the shopper holds an authenticated VTEX session. A guest is `false` — a normal state, never an error.\n  \"\"\"\n  loggedIn: Boolean!\n\n  \"\"\"\n  Whether the shopper may edit their identity data. Lets Controls render editable vs. identified-but-masked fields.\n  \"\"\"\n  canEditData: Boolean!\n\n  \"\"\"\n  Server-computed: whether a profile is attached to the order form (clientProfileData.email is present and non-empty). Identification is distinct from authentication.\n  \"\"\"\n  isIdentified: Boolean!\n}\n\n\"\"\"Input for updating the delivery address on the cart.\"\"\"\ninput ShippingAddressUpdateInput {\n  \"\"\"\n  Saved address reference. Present when the shopper picked (and possibly edited) a saved address.\n  \"\"\"\n  savedAddressId: ID\n\n  \"\"\"\n  Recipient name for the delivery address. Omit it for a destination-only write: the cart keeps its current recipient name. A blank string is rejected with MISSING_RECIPIENT_NAME.\n  \"\"\"\n  recipientName: String\n\n  \"\"\"Postal code for the delivery address.\"\"\"\n  postalCode: String!\n\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  country: String!\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n}\n\n\"\"\"Error codes for shipping address update operations.\"\"\"\nenum ShippingAddressUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The recipient name is blank.\"\"\"\n  MISSING_RECIPIENT_NAME\n\n  \"\"\"The provided saved address ID does not match any available addresses.\"\"\"\n  INVALID_SAVED_ADDRESS_ID\n\n  \"\"\"The postal code is invalid or not found.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The address is invalid.\"\"\"\n  INVALID_ADDRESS\n\n  \"\"\"\n  The country is not an ISO 3166-1 alpha-3 code (three capital letters). Refused before any upstream call.\n  \"\"\"\n  INVALID_COUNTRY_CODE\n}\n\n\"\"\"A domain error returned from a shipping address update mutation.\"\"\"\ntype ShippingAddressUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingAddressUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingAddressUpdate mutation.\"\"\"\ntype ShippingAddressUpdatePayload {\n  \"\"\"The updated shipping state, or null if errors occurred.\"\"\"\n  shipping: Shipping\n\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingAddressUpdateError!]!\n}\n\n\"\"\"Input for selecting a shipping option for the whole cart.\"\"\"\ninput ShippingOptionSelectInput {\n  \"\"\"\n  The shipping option ID to select. Must be offered as a delivery option by at least one item in\n  the cart; items that don't offer it fall back to the Checkout API's own choice.\n  \"\"\"\n  optionId: ID!\n}\n\n\"\"\"Error codes for shipping option select operations.\"\"\"\nenum ShippingOptionSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  The option id is not offered as a delivery option by any item in the cart (unknown id or\n  pickup). Returned without calling Checkout. An option only some items offer is not an error.\n  \"\"\"\n  OPTION_UNAVAILABLE\n\n  \"\"\"No delivery address is persisted on the cart.\"\"\"\n  MISSING_SHIPPING_ADDRESS\n}\n\n\"\"\"A domain error returned from a shipping option select mutation.\"\"\"\ntype ShippingOptionSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: ShippingOptionSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the shippingOptionSelect mutation.\"\"\"\ntype ShippingOptionSelectPayload {\n  \"\"\"The updated shipping state, or null if errors occurred.\"\"\"\n  shipping: Shipping\n\n  \"\"\"The updated cart, or null if errors occurred.\"\"\"\n  cart: Cart\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [ShippingOptionSelectError!]!\n}\n\n\"\"\"\nThe cart's payment state: available methods with server-driven validator config,\nthe current selection, installment options, and the shopper's saved cards. A\nread-only sibling of Cart, Shipping, and Session, projected from the same order\nform fetch. Method-agnostic: projects whatever payment systems VTEX returns, not\nonly credit card. Never carries a full card number or CVV.\n\"\"\"\ntype Payment implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order form ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Payment methods available on this cart. Empty when none are configured.\n  \"\"\"\n  methods: [PaymentMethod!]!\n\n  \"\"\"\n  The currently selected method's id (PaymentMethod.id), or null when unselected.\n  \"\"\"\n  selectedMethodId: String\n\n  \"\"\"\n  Saved-card account reference for the current selection, when a saved card is selected. Null otherwise.\n  \"\"\"\n  selectedAccountId: String\n\n  \"\"\"\n  The currently selected installment tier, resolved from the selection against installmentOptions. Null when unselected or unresolved.\n  \"\"\"\n  selectedInstallment: PaymentInstallment\n\n  \"\"\"\n  Installment plans available, grouped by method (and BIN, for card methods). Serves both a new card (matched by BIN) and a saved card (matched by its stored method).\n  \"\"\"\n  installmentOptions: [PaymentInstallmentOption!]!\n\n  \"\"\"\n  The shopper's saved cards. Empty for anonymous shoppers or when none are saved.\n  \"\"\"\n  savedCards: [SavedCard!]!\n\n  \"\"\"\n  The BIN persisted on the current selection, or null when the selection carries\n  none (a non-card method, or a saved card selected without one). Echoes back what\n  paymentMethodSelect wrote, which is what a client needs in order to know whether\n  its own locally-detected BIN has actually reached the order form: installment\n  options are matched against THIS value server-side, never against a client draft.\n  Not sensitive — a BIN identifies an issuer range, never a card.\n  \"\"\"\n  selectedBin: String\n\n  \"\"\"\n  The store's country as an ISO 3166-1 alpha-3 code (e.g. \"BRA\"), read from the order form's\n  store preferences. Null when the order form carries none or the value is not three capital\n  letters. It is not limited to the countries in `countries`: a store in another country gets its\n  own code and no table entry, and the API never substitutes another country's entry.\n  \"\"\"\n  storeCountryCode: String\n\n  \"\"\"\n  The countries the payment data supports and, per country, the cardholder document types it\n  accepts. A fixed table, identical in every response and independent of the cart. Order: USA,\n  BRA, CAN, MEX. Select the entry whose countryCode equals storeCountryCode.\n  \"\"\"\n  countries: [PaymentCountry!]!\n}\n\n\"\"\"\nA country the payment data supports, with the cardholder document types it accepts. A\nnon-normalized value object read directly off Payment.countries.\n\"\"\"\ntype PaymentCountry {\n  \"\"\"ISO 3166-1 alpha-3 country code (e.g. \"BRA\").\"\"\"\n  countryCode: String!\n\n  \"\"\"\n  The document types a cardholder of this country can give. Masks and validation rules are not\n  carried: the client keys them on the document type.\n  \"\"\"\n  documents: [PaymentCountryDocument!]!\n}\n\n\"\"\"\nOne cardholder document type of a PaymentCountry, with whether it is shown and whether it is\nrequired. Values follow @vtex/country-forms 1.2.0 for an individual person.\n\"\"\"\ntype PaymentCountryDocument {\n  \"\"\"Document type id, lowercase (e.g. \"cpf\", \"ssn\", \"sin\", \"rfc\").\"\"\"\n  type: String!\n\n  \"\"\"Whether the document field should be shown for this country.\"\"\"\n  displayable: Boolean!\n\n  \"\"\"Whether the document is required for this country.\"\"\"\n  required: Boolean!\n}\n\n\"\"\"\nA payment method available on the cart, with the server-driven validator config\nthat determines which card-form fields render, their masks, and whether they\nare required. A non-normalized value object (ADR-0012); read directly off\nPayment.methods.\n\"\"\"\ntype PaymentMethod {\n  \"\"\"Payment-system identifier (VTEX paymentSystem stringId).\"\"\"\n  id: String!\n\n  \"\"\"\n  Display name (e.g. \"Visa\", \"Mastercard\", \"Cash\"). Doubles as the network name for card methods.\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  Payment-system group (e.g. \"creditCardPaymentGroup\", \"debitCardPaymentGroup\"). Store-configured; kept as a string, not an enum.\n  \"\"\"\n  groupName: String!\n\n  \"\"\"\n  Whether VTEX flags this payment system as requiring cardholder authentication\n  (for example 3-D Secure). Projected verbatim from the order form's payment-system\n  configuration: it describes how the store configured the system, not a guarantee\n  about any particular transaction. Null when the order form carries no value for\n  this system — which is not the same as false. Detection only: this API implements\n  no authentication challenge.\n  \"\"\"\n  requiresAuthentication: Boolean\n\n  \"\"\"\n  Validator configuration driving field presence, masks, and requiredness.\n  \"\"\"\n  validator: PaymentMethodValidator!\n}\n\n\"\"\"\nPer-method validator configuration. Server-driven so no component hardcodes\nfield presence, masks, or requiredness.\n\"\"\"\ntype PaymentMethodValidator {\n  \"\"\"\n  Mask pattern for the card number input. Null when the method carries no mask.\n  \"\"\"\n  numberMask: String\n\n  \"\"\"\n  Regex for real-time network detection against the typed BIN. Null when unset.\n  \"\"\"\n  numberRegex: String\n\n  \"\"\"\n  Mask pattern for the security-code (CVV) input. Null when unused or unmasked.\n  \"\"\"\n  cvvMask: String\n\n  \"\"\"Regex validating the security-code (CVV) input. Null when unused.\"\"\"\n  cvvRegex: String\n\n  \"\"\"Whether this method requires the security code (CVV).\"\"\"\n  cvvRequired: Boolean!\n\n  \"\"\"Whether this method requires an expiration date.\"\"\"\n  expirationRequired: Boolean!\n\n  \"\"\"Whether this method requires the cardholder name.\"\"\"\n  holderNameRequired: Boolean!\n\n  \"\"\"Whether this method requires a billing address.\"\"\"\n  billingAddressRequired: Boolean!\n\n  \"\"\"\n  Whether a cardholder document field is displayable for this method. Distinct from documentRequired.\n  \"\"\"\n  documentDisplayable: Boolean! @deprecated(reason: \"The document type, mask and country come from Payment.countries. Storefront clients still read this flag as the merchant's per-method gate until a per-method replacement exists.\") @deprecationDate(deletionDate: \"2027-09-30\")\n\n  \"\"\"\n  Whether the displayed cardholder document is required. Distinct from documentDisplayable — a document can be shown without being mandatory.\n  \"\"\"\n  documentRequired: Boolean! @deprecated(reason: \"The document type, mask and country come from Payment.countries. Storefront clients still read this flag as the merchant's per-method gate until a per-method replacement exists.\") @deprecationDate(deletionDate: \"2027-09-30\")\n}\n\n\"\"\"\nOne installment tier: a specific installment count at a given per-installment\nvalue and total. Keyed by count within its parent PaymentInstallmentOption — a\nnon-normalized value object (ADR-0012).\n\"\"\"\ntype PaymentInstallment {\n  \"\"\"Number of installments (1 = single payment, no interest).\"\"\"\n  count: Int!\n\n  \"\"\"Amount per installment.\"\"\"\n  value: Money!\n\n  \"\"\"Total amount across all installments, including any interest.\"\"\"\n  total: Money!\n\n  \"\"\"\n  Interest rate in hundredths of a percent, exactly as the VTEX order form carries it (100 = 1%; 0 = interest-free).\n  \"\"\"\n  interestRate: Float!\n}\n\n\"\"\"\nInstallment tiers available for one payment method (and, for card methods, one\nBIN range). A non-normalized value object (ADR-0012): read straight off\nPayment.installmentOptions.\n\"\"\"\ntype PaymentInstallmentOption\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"The payment method this option applies to (PaymentMethod.id).\"\"\"\n  methodId: String!\n\n  \"\"\"\n  The BIN range this option applies to, when method-and-BIN-specific. Null when the option applies by method alone.\n  \"\"\"\n  bin: String\n\n  \"\"\"Base order value this option was quoted against.\"\"\"\n  baseValue: Money!\n\n  \"\"\"\n  Installment tiers, with a guaranteed `count: 1` entry prepended when VTEX\n  omits one. A tier that upstream already supplies is passed through untouched\n  (including its position and interest rate).\n  \"\"\"\n  installments: [PaymentInstallment!]!\n}\n\n\"\"\"\nOne of the shopper's saved cards. Never carries a full card number or CVV. A\nnormalized, id-bearing value object (ADR-0012): id is a stable opaque cache\nkey, not a Relay Node.\n\"\"\"\ntype SavedCard\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Opaque, stable cache key. Not a Relay Node ID; SavedCard is not registered in the cross-module Node registry.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  The saved-card account reference. Pass this back on selection; never a full card number.\n  \"\"\"\n  accountId: String!\n\n  \"\"\"\n  The saved card's payment-system id (PaymentMethod.id), for cross-referencing validator config and installment options.\n  \"\"\"\n  methodId: String!\n\n  \"\"\"Card network / issuer display name (e.g. \"Visa\").\"\"\"\n  network: String!\n\n  \"\"\"Last four digits of the card number.\"\"\"\n  lastFourDigits: String!\n\n  \"\"\"BIN of the saved card, for installment-option lookup by network.\"\"\"\n  bin: String!\n\n  \"\"\"Shopper-assigned custom label, when set.\"\"\"\n  label: String\n\n  \"\"\"\n  Whether the card is expired. Expired cards are still returned; non-selectable is a UI concern downstream.\n  \"\"\"\n  expired: Boolean!\n\n  \"\"\"\n  Whether completing payment with this card requires the shopper to enter the CVV.\n  \"\"\"\n  cvvRequired: Boolean!\n}\n\n\"\"\"\nInput for selecting a payment method, optionally identifying a new card (by\nBIN) or a saved card (by account reference). A non-card method (e.g. Cash)\nomits both `bin` and `accountId`. When `accountId` is given, `bin` may also\nbe given to match the saved card against a BIN-specific installment option;\na `bin` that does not match the saved card's own BIN is rejected with\nMISMATCHED_BIN_FOR_SAVED_CARD.\n\"\"\"\ninput PaymentMethodSelectInput {\n  \"\"\"The method to select (PaymentMethod.id).\"\"\"\n  methodId: String!\n\n  \"\"\"\n  A newly-entered card's BIN, once detected. Omit for a saved card or a non-card method.\n  \"\"\"\n  bin: String\n\n  \"\"\"\n  A saved card's account reference (SavedCard.accountId). Omit for a new card or a non-card method.\n  \"\"\"\n  accountId: String\n}\n\n\"\"\"Error codes for the paymentMethodSelect mutation.\"\"\"\nenum PaymentMethodSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"The provided methodId does not match any entry in Payment.methods.\"\"\"\n  INVALID_METHOD_ID\n\n  \"\"\"The provided accountId does not match any entry in Payment.savedCards.\"\"\"\n  INVALID_SAVED_CARD_ACCOUNT_ID\n\n  \"\"\"The bin does not match the BIN of the saved card named by accountId.\"\"\"\n  MISMATCHED_BIN_FOR_SAVED_CARD\n\n  \"\"\"\n  The bin is not 1 to 8 numeric digits — a BIN identifies an issuer range, never a card number.\n  \"\"\"\n  INVALID_BIN_FORMAT\n\n  \"\"\"\n  Never returned. The input once allowed at most one of bin / accountId; both are\n  now accepted so a saved card can be matched to an installment option by its own\n  BIN. Retained per ADR-00010 (additive-only with a deprecation window).\n  \"\"\"\n  CONFLICTING_BIN_AND_ACCOUNT_ID @deprecated(reason: \"Never returned; bin and accountId may now be sent together.\") @deprecationDate(deletionDate: \"2027-08-06\")\n}\n\n\"\"\"A domain error returned from the paymentMethodSelect mutation.\"\"\"\ntype PaymentMethodSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentMethodSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentMethodSelect mutation.\"\"\"\ntype PaymentMethodSelectPayload {\n  \"\"\"The updated payment state, or null if errors occurred.\"\"\"\n  payment: Payment\n\n  \"\"\"\n  The current billing address, echoed for convenience. Null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentMethodSelectError!]!\n}\n\n\"\"\"\nInput for selecting an installment count for the currently-selected method.\n\"\"\"\ninput PaymentInstallmentSelectInput {\n  \"\"\"Number of installments to select (1 = single payment, no interest).\"\"\"\n  count: Int!\n}\n\n\"\"\"Error codes for the paymentInstallmentSelect mutation.\"\"\"\nenum PaymentInstallmentSelectErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  No payment method has been selected yet (paymentMethodSelect was never called).\n  \"\"\"\n  MISSING_PAYMENT_METHOD_SELECTION\n\n  \"\"\"\n  The count does not match any tier in the resolvable installment option.\n  \"\"\"\n  INVALID_INSTALLMENT_COUNT\n}\n\n\"\"\"A domain error returned from the paymentInstallmentSelect mutation.\"\"\"\ntype PaymentInstallmentSelectError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentInstallmentSelectErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"\nPayload returned by the paymentInstallmentSelect mutation. Includes the\nrecomputed cart so the order total (with any interest) updates in the same\nround trip.\n\"\"\"\ntype PaymentInstallmentSelectPayload {\n  \"\"\"The updated payment state, or null if errors occurred.\"\"\"\n  payment: Payment\n\n  \"\"\"\n  The recomputed cart, or null if errors occurred. Carries the order total with any installment interest applied.\n  \"\"\"\n  cart: Cart\n\n  \"\"\"\n  The current billing address, echoed for convenience. Null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentInstallmentSelectError!]!\n}\n\n\"\"\"\nInput for setting the billing address. When sameAsDelivery is true, every\nother field is ignored and no upstream write happens (VTEX's own default:\nan absent invoiceData falls back to the delivery address).\n\"\"\"\ninput PaymentBillingAddressUpdateInput {\n  \"\"\"\n  When true, billing uses the delivery address; every field below is ignored.\n  \"\"\"\n  sameAsDelivery: Boolean!\n\n  \"\"\"Address classification for the billing address.\"\"\"\n  addressType: String\n\n  \"\"\"\n  Postal code for the billing address. Required when sameAsDelivery is false.\n  \"\"\"\n  postalCode: String\n\n  \"\"\"\n  ISO 3166-1 alpha-3 country code (e.g. \"BRA\"). Required when sameAsDelivery is false.\n  \"\"\"\n  country: String\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood / district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City name.\"\"\"\n  city: String\n\n  \"\"\"State / province code.\"\"\"\n  state: String\n\n  \"\"\"\n  A landmark reference. Sent upstream but not echoed back on billingAddress (Decision 11).\n  \"\"\"\n  reference: String\n}\n\n\"\"\"Error codes for the paymentBillingAddressUpdate mutation.\"\"\"\nenum PaymentBillingAddressUpdateErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"sameAsDelivery is false but postalCode or country was omitted.\"\"\"\n  MISSING_BILLING_ADDRESS_FIELDS\n\n  \"\"\"\n  The country is not an ISO 3166-1 alpha-3 code (three capital letters). Refused before any upstream call.\n  \"\"\"\n  INVALID_COUNTRY_CODE\n}\n\n\"\"\"A domain error returned from the paymentBillingAddressUpdate mutation.\"\"\"\ntype PaymentBillingAddressUpdateError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentBillingAddressUpdateErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentBillingAddressUpdate mutation.\"\"\"\ntype PaymentBillingAddressUpdatePayload {\n  \"\"\"\n  The billing address just written, or null when same-as-delivery is in effect.\n  \"\"\"\n  billingAddress: Address\n\n  \"\"\"\n  The updated payment state, or null if errors occurred, or when same-as-delivery is in effect, where no upstream write happens.\n  \"\"\"\n  payment: Payment\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentBillingAddressUpdateError!]!\n}\n\n\"\"\"\nError codes for the paymentStartTransaction mutation. Login-required VTEX\nbusiness codes (CHK0087, CHK003, ORD062) and generic infrastructure failures\nare never in this enum — per ADR-00007 they surface as top-level GraphQL\nerrors (UNAUTHORIZED / UPSTREAM_ERROR), not userErrors.\n\"\"\"\nenum PaymentStartTransactionErrorCode {\n  \"\"\"No cart context was provided (x-order-form-id header/cookie).\"\"\"\n  MISSING_CART_CONTEXT\n\n  \"\"\"The cart was not found.\"\"\"\n  CART_NOT_FOUND\n\n  \"\"\"\n  No payment method has been selected yet (paymentMethodSelect was never called).\n  \"\"\"\n  MISSING_PAYMENT_METHOD_SELECTION\n\n  \"\"\"\n  VTEX opened the transaction but named no merchant transaction on it, so\n  neither the transaction id the send-payments POST addresses nor the merchant\n  name its body carries exists. The transaction is open upstream but cannot be\n  paid; the legacy checkout refuses the same state.\n  \"\"\"\n  INVALID_TRANSACTION_DATA\n}\n\n\"\"\"A domain error returned from the paymentStartTransaction mutation.\"\"\"\ntype PaymentStartTransactionError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentStartTransactionErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"\nPayload returned by paymentStartTransaction: everything the browser needs to\nrun the direct-to-gateway send-payments call (out of scope here) and the\nlater gatewayCallback. The transaction cookies VTEX issues are set on the\nHTTP response (Set-Cookie), not exposed as a field.\n\"\"\"\ntype PaymentStartTransactionPayload {\n  \"\"\"The opened transaction's id. Null if errors occurred.\"\"\"\n  transactionId: String\n\n  \"\"\"\n  Name of the merchant responsible for the sale, as the gateway call's payment\n  `id` and `transaction.merchantName`. Projected from the same\n  merchantTransactions entry transactionId comes from — VTEX returns one entry\n  per seller, so a multi-seller order carries more than one and only the first\n  is exposed here (see specs/payment-transaction-payload-gaps.md, Decision 1).\n  Null if errors occurred.\n  \"\"\"\n  merchantName: String\n\n  \"\"\"\n  Origin of the payment gateway this transaction must be paid at, e.g.\n  \"https://mystore.vtexvault.com\" — the base the browser's direct-to-gateway\n  send-payments POST appends its own path to. Always `https://{account}.vtexvault.com`,\n  derived from the request's account alone: no upstream field and no caller-supplied\n  value is an input, since this field decides where card data is sent. Null when the\n  account is not a single DNS label, and if errors occurred.\n  \"\"\"\n  gatewayUrl: String\n\n  \"\"\"\n  The order group, needed for the gateway call's orderId parameter and for gatewayCallback's input.\n  \"\"\"\n  orderGroup: String\n\n  \"\"\"The shopper's user profile id, needed for the gateway call.\"\"\"\n  userProfileId: String\n\n  \"\"\"\n  The payment amount for this transaction, as a decimal (e.g. \"100.00\") for\n  display. The gateway body wants minor units — read valueInCents for that,\n  never a client-side multiplication of this amount.\n  \"\"\"\n  value: Money\n\n  \"\"\"\n  The same payment amount in the currency's minor units (e.g. 10000 for\n  \"100.00\"), exactly as VTEX returned it and as this mutation sent it upstream.\n  The unit the gateway body's `value`/`installmentValue` fields expect. Null if\n  errors occurred.\n  \"\"\"\n  valueInCents: Int\n\n  \"\"\"\n  Pre-interest base amount this transaction was opened against, in the\n  currency's minor units — the gateway body's `referenceValue`. Equals\n  valueInCents when no interest applies. Null if errors occurred.\n  \"\"\"\n  referenceValueInCents: Int\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentStartTransactionError!]!\n}\n\n\"\"\"\nInput for finalizing a transaction after the direct-to-gateway call\nsucceeded.\n\"\"\"\ninput PaymentGatewayCallbackInput {\n  \"\"\"The order group returned by paymentStartTransaction.\"\"\"\n  orderGroup: String!\n\n  \"\"\"\n  The resume flag. False (the default) on the first pass; true when the shopper\n  returns from the bank's challenge page, so the callback accepts the challenge.\n  \"\"\"\n  acceptChallenges: Boolean = false\n}\n\n\"\"\"\nError codes for the paymentGatewayCallback mutation. Login-required VTEX\nbusiness codes (CHK0087, CHK003, ORD062) and generic infrastructure failures\nare never in this enum — per ADR-00007 they surface as top-level GraphQL\nerrors (UNAUTHORIZED / UPSTREAM_ERROR), not userErrors.\n\"\"\"\nenum PaymentGatewayCallbackErrorCode {\n  \"\"\"\n  The transaction cookies (Vtex_CHKO_Auth, CheckoutDataAccess) were not present on this request — paymentStartTransaction was not called first, or the five-minute window lapsed.\n  \"\"\"\n  MISSING_TRANSACTION_COOKIES\n\n  \"\"\"\n  VTEX answered 428: the payment needs a challenge step. When `redirectUrl` is set the shopper must be sent there; when it is null the challenge uses a mechanism this API does not hand over (for example a payment app).\n  \"\"\"\n  REDIRECT_REQUIRED\n}\n\n\"\"\"A domain error returned from the paymentGatewayCallback mutation.\"\"\"\ntype PaymentGatewayCallbackError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: PaymentGatewayCallbackErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Payload returned by the paymentGatewayCallback mutation.\"\"\"\ntype PaymentGatewayCallbackPayload {\n  \"\"\"\n  The finalized order group, echoed back on success. Null if errors occurred.\n  \"\"\"\n  orderId: String\n\n  \"\"\"\n  The bank's challenge page; set only when VTEX answered 428 with a usable http(s) URL.\n  \"\"\"\n  redirectUrl: String\n\n  \"\"\"Domain errors that occurred during the operation.\"\"\"\n  userErrors: [PaymentGatewayCallbackError!]!\n}\n\n\"\"\"\nThe installment plan a settled order was charged in. Projected from the\nplaced-order payment record, which carries the count and the settled total\nonly — never a per-installment amount and never an interest rate, unlike the\nlive order form behind `Payment.selectedInstallment`. That asymmetry is\nupstream and permanent (see specs/settle-and-project-the-placed-order.md,\nDecision 2).\n\"\"\"\ntype OrderInstallment\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Number of installments the order was charged in. 1 = single payment.\"\"\"\n  count: Int!\n\n  \"\"\"\n  Total charged across all installments, including any interest, in the\n  order's currency, or the request's when no seller order carries one, as the\n  order's other amounts are. Null when the settled record carries no amount.\n  \"\"\"\n  total: Money\n}\n\n\"\"\"\nA settled order's payment recap. Read-only; projected from VTEX's\nsettled-order source rather than the live order form, so it keeps resolving\nafter the order form itself stops existing. Carries no sensitive field: no\nfull card number or CVV is ever read for this projection (RFC D13).\n\"\"\"\ntype Order implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Globally unique identifier (Relay Node ID), encoded from the order group.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  The purchase's payment outcome, shared by its seller orders. The banner shows this one. UNKNOWN when\n  the seller orders disagree.\n  \"\"\"\n  status: OrderStatus!\n\n  \"\"\"\n  The distinct payments of the purchase, each counted once across its seller orders. They follow the\n  seller orders sorted by order id, and within a transaction the order the order system lists them\n  in, which this API does not change. Empty when the order carries no payment.\n  \"\"\"\n  payments: [OrderPayment!]!\n\n  \"\"\"\n  Card network / payment-system display name of the first payment (e.g. \"Visa\", or a non-card\n  method's own name such as \"Boleto Bancário\"). Kept for the payment recap; prefer payments. Null\n  when the settled order carries no payment record to project one from.\n  \"\"\"\n  network: String\n\n  \"\"\"\n  Last four digits of the card used by the first payment, when the payment method was a card.\n  Present for both a saved and a freshly-entered card — unlike Payment (T1),\n  where last four is a saved-card-only field. Kept for the payment recap; prefer payments. Null for\n  a non-card method or when no payment record exists to project one from.\n  \"\"\"\n  lastFourDigits: String\n\n  \"\"\"Always null: the order system sends no card label.\"\"\"\n  label: String @deprecated(reason: \"The order system sends no card label; always null.\") @deprecationDate(deletionDate: \"2027-03-31\")\n\n  \"\"\"\n  The installment plan of the first payment. Kept for the payment recap; prefer payments. Null when\n  the settled record reports none.\n  \"\"\"\n  installment: OrderInstallment\n\n  \"\"\"\n  Who bought, as the order recorded them at placement, not the live profile. Masked (e.g.\n  \"A*** S***\") when personalDataVisible is false. Null when the order carries no profile.\n  \"\"\"\n  customer: OrderCustomer\n\n  \"\"\"\n  Whether the order system returned the order's personal data unmasked: the customer, and the\n  addresses, invoice and payment details it masks under the same verdict. False means masked, and is\n  also the answer when the order system does not say.\n  \"\"\"\n  personalDataVisible: Boolean!\n\n  \"\"\"\n  The order group: the reference the shopper reads and support resolves. One per purchase, however\n  many sellers.\n  \"\"\"\n  reference: String!\n\n  \"\"\"\n  When the purchase was placed: the earliest creation date across its seller orders. Null when none\n  carries one.\n  \"\"\"\n  placedAt: DateTime\n\n  \"\"\"\n  What the purchase costs: the sum of its seller orders' totals. Null when a seller order has none.\n  \"\"\"\n  total: Money\n\n  \"\"\"\n  The purchase's money lines: each line summed across seller orders, keyed on (id, name).\n  \"\"\"\n  totals: [CartTotalizer!]!\n\n  \"\"\"\n  The purchase split by seller, one entry per seller order, sorted by orderId.\n  \"\"\"\n  sellerOrders: [SellerOrder!]!\n\n  \"\"\"\n  Every item of the purchase grouped by shipping method, channel and relative estimate, across\n  sellers; SmartCheckout uses the same key within each seller order.\n  \"\"\"\n  deliveries: [OrderDelivery!]!\n}\n\n\"\"\"\nItems that arrive together: the same shipping method, channel and relative estimate.\n\"\"\"\ntype OrderDelivery\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Encoded from the grouping key and its scope, the order group.\"\"\"\n  id: ID!\n\n  \"\"\"\n  The shipping method, as the shopper chose it: its name, channel and relative estimate. Its price\n  is one line's; use price. Null when the order system omits the method or its estimate is\n  unreadable.\n  \"\"\"\n  shippingOption: OrderShippingOption\n\n  \"\"\"\n  The group's dated promise: its latest line's, so it covers every item. Null when no line carries a\n  date.\n  \"\"\"\n  estimatedDate: DateTime\n\n  \"\"\"\n  What the group's shipping cost: the sum of its lines' shipping prices. A line without a readable\n  method adds zero, so with shippingOption null this zero is unknown, never free shipping.\n  \"\"\"\n  price: Money!\n\n  \"\"\"\n  What the group's shipping would have cost without discounts: the sum of its lines' list prices,\n  read as price is.\n  \"\"\"\n  listPrice: Money!\n\n  \"\"\"\n  Where the group ships: its first line's address. The address is not part of the grouping key: the\n  cart delivers to one address, so a group's lines share it. Each line's own is on\n  items.deliveryAddress. Masked under personalDataVisible.\n  \"\"\"\n  address: Address\n\n  \"\"\"\n  The pickup point's name: its first line's. Null unless the group is picked up.\n  \"\"\"\n  pickupPointName: String\n\n  \"\"\"The number of items in the group.\"\"\"\n  itemCount: Int!\n\n  \"\"\"The group's items, in the order of the seller orders.\"\"\"\n  items: [OrderItem!]!\n}\n\n\"\"\"\nThe shipping method the shopper chose, as the order recorded it. Read from the order, never from the\ncart.\n\"\"\"\ntype OrderShippingOption\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Encoded from the order group, the line's uniqueId and the SLA id.\"\"\"\n  id: ID!\n\n  \"\"\"\n  The method's name, e.g. Motoboy. The SLA id when the order system sends no name.\n  \"\"\"\n  name: String!\n\n  \"\"\"Delivery channel: home delivery or pickup.\"\"\"\n  channel: DeliveryChannel!\n\n  \"\"\"The method's relative estimate, e.g. 7 business days.\"\"\"\n  shippingEstimate: ShippingEstimate!\n\n  \"\"\"What this line's shipping cost. Zero when free shipping applies.\"\"\"\n  price: Money!\n\n  \"\"\"What this line's shipping would have cost without discounts.\"\"\"\n  listPrice: Money!\n}\n\n\"\"\"\nThe payment outcome of a settled order (PRD UQ-2), mapped from the order's Checkout workflow state.\n\"\"\"\nenum OrderStatus {\n  \"\"\"The payment was approved, or the order has moved past approval.\"\"\"\n  APPROVED\n\n  \"\"\"The payment is not decided yet, under anti-fraud review included.\"\"\"\n  PENDING\n\n  \"\"\"The payment was denied, or the order was cancelled.\"\"\"\n  DENIED\n\n  \"\"\"A state the page does not classify. It asserts no outcome.\"\"\"\n  UNKNOWN\n}\n\n\"\"\"One payment of a settled purchase. No id: it lives inside its Order.\"\"\"\ntype OrderPayment\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Card network / payment-system display name, e.g. \"Visa\". Null when the order system sends none.\n  \"\"\"\n  network: String\n\n  \"\"\"\n  Last four digits of the card, when the payment method was a card. Never the card number.\n  \"\"\"\n  lastFourDigits: String\n\n  \"\"\"\n  The installment plan of this payment. Null when the settled record reports none.\n  \"\"\"\n  installment: OrderInstallment\n\n  \"\"\"\n  What this payment charged, in full: never one instalment. Null only if the order system omits it,\n  which it does not today.\n  \"\"\"\n  value: Money\n}\n\n\"\"\"One seller's part of a purchase: its own seller, totals and items.\"\"\"\ntype SellerOrder\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Encoded from orderId.\"\"\"\n  id: ID!\n\n  \"\"\"The seller order's number, e.g. 1667094470146-01.\"\"\"\n  orderId: String!\n\n  \"\"\"\n  The seller fulfilling this order. Null only when neither sellers nor any readable item names one.\n  \"\"\"\n  seller: CartSellerRef\n\n  \"\"\"\n  What this seller order costs. Null when the order system does not send it.\n  \"\"\"\n  total: Money\n\n  \"\"\"This seller order's money lines. The cart's own totalizer type.\"\"\"\n  totals: [CartTotalizer!]!\n\n  \"\"\"\n  Every line of this seller order. Children of a composition nest under their parent.\n  \"\"\"\n  items: [OrderItem!]!\n}\n\n\"\"\"\nOne purchased line of a settled order. The fields mean what they mean on CartItem.\n\"\"\"\ntype OrderItem\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Encoded from the order group and the line's uniqueId.\"\"\"\n  id: ID!\n\n  \"\"\"\n  The SKU as the cart shows it: name, image, seller, availability and variation.\n  \"\"\"\n  variant: CartVariant!\n\n  \"\"\"\n  The product the SKU belongs to: title, detail URL, categories and brand.\n  \"\"\"\n  product: CartProduct!\n\n  \"\"\"How many units were bought.\"\"\"\n  quantity: Int!\n\n  \"\"\"The unit price at placement, before discounts.\"\"\"\n  price: Money!\n\n  \"\"\"Zero when the line had no list price.\"\"\"\n  listPrice: Money!\n\n  \"\"\"The unit price the shopper paid.\"\"\"\n  sellingPrice: Money!\n\n  \"\"\"The line's own total, as the cart computes it.\"\"\"\n  ownTotal: Money!\n\n  \"\"\"The line's own total plus its compositions'.\"\"\"\n  total: Money!\n\n  \"\"\"Whether the line is a gift.\"\"\"\n  gift: Boolean!\n\n  \"\"\"The featured promotions that discounted this line.\"\"\"\n  discounts: [CartItemDiscount!]!\n\n  \"\"\"The values the shopper entered for the line's input assemblies.\"\"\"\n  customizations: [CartItemCustomization!]!\n\n  \"\"\"The add-on services and bundle children nested under this line.\"\"\"\n  compositions: [CartItemComposition!]!\n\n  \"\"\"\n  The shipping method the shopper chose for this line. Null when the order system omits it or its\n  estimate is unreadable.\n  \"\"\"\n  selectedShippingOption: OrderShippingOption\n\n  \"\"\"\n  Where this line ships: the delivery address, or the pickup point's. Masked under\n  personalDataVisible.\n  \"\"\"\n  deliveryAddress: Address\n\n  \"\"\"\n  The pickup point's name, e.g. \"RJ - Botafogo Praia Shopping\". Null unless the line is picked up.\n  \"\"\"\n  pickupPointName: String\n\n  \"\"\"The dated promise. Null when the order system has not set one.\"\"\"\n  estimatedDeliveryDate: DateTime\n}\n\n\"\"\"\nThe customer of a settled order, as the order recorded them at placement. The same fields as\nClientProfile, which is the live order form's profile.\n\"\"\"\ntype OrderCustomer\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Email address.\"\"\"\n  email: String\n\n  \"\"\"First name.\"\"\"\n  firstName: String\n\n  \"\"\"Last name.\"\"\"\n  lastName: String\n\n  \"\"\"Phone number.\"\"\"\n  phone: String\n\n  \"\"\"Identity document number.\"\"\"\n  document: String\n}\n\n\"\"\"\nThe address fields a postal code resolves to. Each is null when the platform\nleft it blank.\n\"\"\"\ntype PostalCodeAddress\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"The city, as the platform names it.\"\"\"\n  city: String\n\n  \"\"\"The state or region, as the platform codes it (`SP`, `NY`).\"\"\"\n  state: String\n\n  \"\"\"The street. Null where the platform resolves codes to an area only.\"\"\"\n  street: String\n\n  \"\"\"The neighborhood. Null where the platform resolves none.\"\"\"\n  neighborhood: String\n}\n\n\"\"\"\nThe authentication methods an account enables, read before rendering a sign-in form.\n\"\"\"\ntype SessionAuthProviders {\n  \"\"\"Whether classic email and password sign-in is enabled.\"\"\"\n  passwordAuthentication: Boolean!\n\n  \"\"\"Whether email access-code (passwordless) sign-in is enabled.\"\"\"\n  accessKeyAuthentication: Boolean!\n}\n\n\"\"\"\nA typed, expected failure of a login attempt. Distinct from the top-level\nUNAUTHORIZED gate: this is a domain outcome (the request was understood, the\nbusiness rejected it), never an infrastructure failure.\n\"\"\"\ntype SessionError {\n  \"\"\"Machine-readable error code for the login-attempt failure.\"\"\"\n  code: SessionErrorCode!\n\n  \"\"\"Human-readable message describing the failure.\"\"\"\n  message: String!\n}\n\n\"\"\"The set of login-attempt failure codes a session mutation can return.\"\"\"\nenum SessionErrorCode {\n  \"\"\"Email or password was not accepted by VTEX ID.\"\"\"\n  INVALID_CREDENTIALS\n\n  \"\"\"The access code was wrong or expired.\"\"\"\n  INVALID_ACCESS_CODE\n\n  \"\"\"Too many access codes were requested for this email.\"\"\"\n  ACCESS_CODE_SEND_LIMIT\n\n  \"\"\"The user is blocked by VTEX ID.\"\"\"\n  BLOCKED\n\n  \"\"\"\n  BFF-side guard: the request lacked the auth context it needed (e.g. a missing\n  authenticationToken). Not a VTEX outcome.\n  \"\"\"\n  MISSING_AUTH_CONTEXT\n}\n\n\"\"\"\nThe login / logout result, projected from the one refreshed order form. session,\ncart, clientProfile and clientPreferences are normalized Relay Nodes (keyed on\nthe orderFormId) so Apollo merges them into the cache and the client updates\nreactively with no refetch.\n\"\"\"\ntype SessionLoginPayload {\n  \"\"\"The session after the attempt; loggedIn is true only on success.\"\"\"\n  session: Session!\n\n  \"\"\"The cart projected from the refreshed order form.\"\"\"\n  cart: Cart!\n\n  \"\"\"\n  The client profile projected from the refreshed order form; the entity always\n  resolves, its fields are null when unset.\n  \"\"\"\n  clientProfile: ClientProfile!\n\n  \"\"\"\n  The client preferences projected from the refreshed order form; the entity\n  always resolves, its fields are null when unset.\n  \"\"\"\n  clientPreferences: ClientPreferences!\n\n  \"\"\"Typed login-attempt failures. Empty on success.\"\"\"\n  userErrors: [SessionError!]!\n}\n\n\"\"\"The result of requesting an email access code.\"\"\"\ntype SessionRequestAccessCodePayload {\n  \"\"\"\n  Opaque token to hand back to sessionValidateAccessCode. Null when the request\n  failed.\n  \"\"\"\n  authenticationToken: String\n\n  \"\"\"Typed request failures. Empty on success.\"\"\"\n  userErrors: [SessionError!]!\n}\n\n\"\"\"Credentials for a classic email + password sign-in.\"\"\"\ninput SessionPasswordLoginInput {\n  \"\"\"The shopper's email address.\"\"\"\n  email: String!\n\n  \"\"\"\n  The shopper's password. Proxied to VTEX ID over TLS, never logged or persisted.\n  \"\"\"\n  password: String!\n}\n\n\"\"\"The email to send an access code to.\"\"\"\ninput SessionRequestAccessCodeInput {\n  \"\"\"The shopper's email address the access code is sent to.\"\"\"\n  email: String!\n}\n\n\"\"\"An access code plus the authenticationToken it was issued against.\"\"\"\ninput SessionValidateAccessCodeInput {\n  \"\"\"The shopper's email address.\"\"\"\n  email: String!\n\n  \"\"\"The access code the shopper received by email.\"\"\"\n  accessCode: String!\n\n  \"\"\"\n  The opaque token returned by sessionRequestAccessCode, handed back unchanged.\n  \"\"\"\n  authenticationToken: String!\n}\n\n\"\"\"\nThe shopper's active region. Both fields are nullable: a shopper who has never\nsubmitted a postal code has no region, and a submitted postal code does not\nalways resolve to a known city.\n\"\"\"\ntype Region\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization. Not a Relay Node ID: a region is\n  session-scoped shopper state, never addressable by global id.\n  \"\"\"\n  id: ID!\n\n  \"\"\"The active postal code, formatted for display. Null when none is set.\"\"\"\n  postalCode: String\n\n  \"\"\"\n  The city the postal code resolves to. Null when the postal code is unknown to\n  the resolver, which is a normal state and not an error.\n  \"\"\"\n  city: String\n}\n\n\"\"\"\nWhy a region write was refused. Stable across locales, so a client can render\neach case in the shopper's language instead of echoing the server's message.\n\"\"\"\nenum RegionErrorCode {\n  \"\"\"The value did not normalize to a complete postal code.\"\"\"\n  INVALID_POSTAL_CODE\n\n  \"\"\"The postal code is complete but falls outside the served ranges.\"\"\"\n  UNSERVED_POSTAL_CODE\n}\n\n\"\"\"\nA typed, expected failure of a region write: the request was understood and the\nbusiness rejected it. Distinct from an infrastructure failure, which surfaces as\na top-level GraphQL error.\n\"\"\"\ntype RegionError {\n  \"\"\"Which rule refused the postal code.\"\"\"\n  code: RegionErrorCode!\n\n  \"\"\"\n  Human-readable message describing why the postal code was rejected. Written in\n  English by the server; a client should key its copy on `code` instead.\n  \"\"\"\n  message: String!\n}\n\n\"\"\"The result of submitting a postal code.\"\"\"\ntype RegionUpdatePayload {\n  \"\"\"\n  The region after the write. Null when the postal code was rejected, leaving\n  any previously active region untouched.\n  \"\"\"\n  region: Region\n\n  \"\"\"Typed rejections. Empty on success.\"\"\"\n  errors: [RegionError!]!\n}\n\n\"\"\"\nA shopper's persistent, cart-independent profile. Distinct from checkout's\norder-form-scoped ClientProfile.\n\"\"\"\ntype CustomerProfile\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization. Not a Relay Node ID: the profile is\n  session-scoped shopper state, derived from the session and never addressable\n  by a global id (no id argument, no CustomerProfile entry in Query.node).\n  \"\"\"\n  id: ID!\n\n  \"\"\"Given name. Null when unset.\"\"\"\n  firstName: String\n\n  \"\"\"Family name. Null when unset.\"\"\"\n  lastName: String\n\n  \"\"\"\n  The shopper's login identifier. Read-only — excluded from the update input by construction.\n  \"\"\"\n  email: String\n\n  \"\"\"Primary contact phone. Null when unset.\"\"\"\n  homePhone: String\n\n  \"\"\"Mobile contact phone. Null when unset.\"\"\"\n  mobilePhone: String\n\n  \"\"\"National tax ID. Null when unset.\"\"\"\n  document: String\n\n  \"\"\"\n  The tax ID's type, so the control can adapt to the shopper's region. Null when unset.\n  \"\"\"\n  documentType: String\n\n  \"\"\"Date of birth. Null when unset.\"\"\"\n  birthDate: String\n\n  \"\"\"\n  Free-form gender value; the store configures the options it offers. Null when unset.\n  \"\"\"\n  gender: String\n}\n\n\"\"\"A typed, expected failure of a profile write.\"\"\"\ntype CustomerProfileError {\n  \"\"\"Machine-readable code for the write failure.\"\"\"\n  code: CustomerProfileErrorCode!\n\n  \"\"\"A safe message. Never echoes a submitted profile value.\"\"\"\n  message: String!\n}\n\n\"\"\"The set of expected, typed profile-write failure codes.\"\"\"\nenum CustomerProfileErrorCode {\n  \"\"\"\n  The account's profile schema refused one or more submitted values. It does not\n  attribute the refusal to a cause — a required field left empty and a malformed\n  value are not distinguishable until the upstream rejection body is\n  characterised, at which point a narrower code joins this one.\n  \"\"\"\n  INVALID_VALUE\n}\n\n\"\"\"\nEvery field is optional: provide only what the shopper edited. An empty string\nis an explicit erase; an omitted field is left untouched. A `null` is neither —\nit counts as not provided, so nulling an untouched field cannot wipe it.\n\"\"\"\ninput CustomerProfileUpdateInput {\n  \"\"\"Given name to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  firstName: String\n\n  \"\"\"Family name to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  lastName: String\n\n  \"\"\"\n  Primary contact phone to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  homePhone: String\n\n  \"\"\"\n  Mobile contact phone to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  mobilePhone: String\n\n  \"\"\"\n  National tax ID to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  document: String\n\n  \"\"\"Tax ID type to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  documentType: String\n\n  \"\"\"\n  Date of birth to write. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  birthDate: String\n\n  \"\"\"Gender value to write. Omit to leave unchanged; empty string to erase.\"\"\"\n  gender: String\n}\n\n\"\"\"\nThe result of a profile write, carrying the merged profile and any typed\nfailures.\n\"\"\"\ntype CustomerProfileUpdatePayload {\n  \"\"\"\n  The profile after the write, so a reactive fragment re-delivers without a refetch.\n  \"\"\"\n  customerProfile: CustomerProfile!\n\n  \"\"\"Typed, expected write failures. Empty on success.\"\"\"\n  userErrors: [CustomerProfileError!]!\n}\n\n\"\"\"\nAn address the shopper saved to their account. Read from the shopper's own\nprofile, never through a cart. Every field it shares with checkout's Address is\nspelled the same way.\n\"\"\"\ntype CustomerAddress implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Global id. Resolves through Query.node only inside the signed-in shopper's own\n  addresses; any other id resolves to null.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  ISO 3166-1 alpha-3 country code, as stored. Null when the stored address has\n  none, as an address another system wrote can; it is listed so the shopper can\n  still see and remove it.\n  \"\"\"\n  country: String\n\n  \"\"\"Who receives deliveries at this address. Null when unset.\"\"\"\n  recipientName: String\n\n  \"\"\"Street name. Null when unset.\"\"\"\n  street: String\n\n  \"\"\"Street number. Null when unset.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.). Null when unset.\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood or district. Null when unset.\"\"\"\n  neighborhood: String\n\n  \"\"\"City. Null when unset.\"\"\"\n  city: String\n\n  \"\"\"State or province code. Null when unset.\"\"\"\n  state: String\n\n  \"\"\"Postal code, as stored. Null when unset.\"\"\"\n  postalCode: String\n\n  \"\"\"A landmark that helps find the address. Null when unset.\"\"\"\n  reference: String\n}\n\n\"\"\"\nThe signed-in shopper's saved addresses, held in one object so a client can cache\nand subscribe to the list. It takes no argument and reads only the shopper's own\nlist. Not resolvable through Query.node.\n\"\"\"\ntype CustomerAddressBook\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization, the same for every request of the\n  shopper. Not a Relay Node ID.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Every saved address, the same list `customerAddresses` returns. Empty when the\n  shopper has none.\n  \"\"\"\n  addresses: [CustomerAddress!]!\n}\n\n\"\"\"\nA new saved address. `country` is required; every other field is optional to the\nschema, and the country's rules say which ones it needs. A field that is omitted,\n`null`, or an empty string is not written.\n\"\"\"\ninput CustomerAddressCreateInput {\n  \"\"\"\n  ISO 3166-1 alpha-3 country code. The store must ship to it. Trimmed and upper-cased.\n  \"\"\"\n  country: String!\n\n  \"\"\"Who receives deliveries at this address.\"\"\"\n  recipientName: String\n\n  \"\"\"Street name.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Additional address detail (apartment, suite, etc.).\"\"\"\n  complement: String\n\n  \"\"\"Neighborhood or district.\"\"\"\n  neighborhood: String\n\n  \"\"\"City.\"\"\"\n  city: String\n\n  \"\"\"State or province code.\"\"\"\n  state: String\n\n  \"\"\"Postal code. Stored in the country's masked form once it is valid.\"\"\"\n  postalCode: String\n\n  \"\"\"A landmark that helps find the address.\"\"\"\n  reference: String\n}\n\n\"\"\"\nChanges to a saved address. Omit a field, or send `null`, to keep it; send an empty\nstring to erase it. The country cannot change.\n\"\"\"\ninput CustomerAddressUpdateInput {\n  \"\"\"\n  Who receives deliveries at this address. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  recipientName: String\n\n  \"\"\"Street name. Omit to leave unchanged; empty string to erase.\"\"\"\n  street: String\n\n  \"\"\"Street number. Omit to leave unchanged; empty string to erase.\"\"\"\n  number: String\n\n  \"\"\"\n  Additional address detail (apartment, suite, etc.). Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  complement: String\n\n  \"\"\"\n  Neighborhood or district. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  neighborhood: String\n\n  \"\"\"City. Omit to leave unchanged; empty string to erase.\"\"\"\n  city: String\n\n  \"\"\"\n  State or province code. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  state: String\n\n  \"\"\"\n  Postal code. Omit to leave unchanged; empty string to erase. Stored in the country's masked form once it is valid.\n  \"\"\"\n  postalCode: String\n\n  \"\"\"\n  A landmark that helps find the address. Omit to leave unchanged; empty string to erase.\n  \"\"\"\n  reference: String\n}\n\n\"\"\"\nA typed, expected failure of an address write, or of the lookup that precedes it.\n\"\"\"\ntype CustomerAddressError {\n  \"\"\"Machine-readable code for the failure.\"\"\"\n  code: CustomerAddressErrorCode!\n\n  \"\"\"\n  A safe, fixed message. Never echoes a submitted value, an id, or a key.\n  \"\"\"\n  message: String!\n\n  \"\"\"\n  The field the failure is about. Null when it is about the address as a whole.\n  \"\"\"\n  field: CustomerAddressField\n}\n\n\"\"\"The set of expected, typed address-write failure codes.\"\"\"\nenum CustomerAddressErrorCode {\n  \"\"\"\n  The id is malformed, names another entity type, or is not one of the shopper's saved\n  addresses. These cases are indistinguishable.\n  \"\"\"\n  NOT_FOUND\n\n  \"\"\"The country's rules require this field and it is empty.\"\"\"\n  MISSING_REQUIRED_FIELD\n\n  \"\"\"\n  The value is not accepted: a bad format, a value outside the country's options, a value\n  that is too long, or a country that is not three letters. With no field, the profile\n  service refused the address and does not say why.\n  \"\"\"\n  INVALID_VALUE\n\n  \"\"\"The store does not ship to the country.\"\"\"\n  UNSUPPORTED_COUNTRY\n}\n\n\"\"\"The address field a failure is about.\"\"\"\nenum CustomerAddressField {\n  \"\"\"The `country` field.\"\"\"\n  COUNTRY\n\n  \"\"\"The `recipientName` field.\"\"\"\n  RECIPIENT_NAME\n\n  \"\"\"The `street` field.\"\"\"\n  STREET\n\n  \"\"\"The `number` field.\"\"\"\n  NUMBER\n\n  \"\"\"The `complement` field.\"\"\"\n  COMPLEMENT\n\n  \"\"\"The `neighborhood` field.\"\"\"\n  NEIGHBORHOOD\n\n  \"\"\"The `city` field.\"\"\"\n  CITY\n\n  \"\"\"The `state` field.\"\"\"\n  STATE\n\n  \"\"\"The `postalCode` field.\"\"\"\n  POSTAL_CODE\n\n  \"\"\"The `reference` field.\"\"\"\n  REFERENCE\n}\n\n\"\"\"The result of creating a saved address.\"\"\"\ntype CustomerAddressCreatePayload {\n  \"\"\"The address as written. Null when `userErrors` is not empty.\"\"\"\n  customerAddress: CustomerAddress\n\n  \"\"\"Typed, expected failures, one per refused field. Empty on success.\"\"\"\n  userErrors: [CustomerAddressError!]!\n}\n\n\"\"\"The result of updating a saved address.\"\"\"\ntype CustomerAddressUpdatePayload {\n  \"\"\"\n  The address as written, or as stored when the input provided no field. Null when\n  `userErrors` is not empty.\n  \"\"\"\n  customerAddress: CustomerAddress\n\n  \"\"\"Typed, expected failures, one per refused field. Empty on success.\"\"\"\n  userErrors: [CustomerAddressError!]!\n}\n\n\"\"\"The result of deleting a saved address.\"\"\"\ntype CustomerAddressDeletePayload {\n  \"\"\"\n  The id of the deleted address, to evict it from a client cache. Null when `userErrors`\n  is not empty.\n  \"\"\"\n  deletedCustomerAddressId: ID\n\n  \"\"\"Typed, expected failures. Empty on success.\"\"\"\n  userErrors: [CustomerAddressError!]!\n}\n\n\"\"\"\nThe countries the store ships to, read from the platform's freight\nconfiguration. Store-level and identical for every shopper.\n\"\"\"\ntype ShippingCountries\n  @cacheControl(maxAge: 3600, scope: PUBLIC)\n{\n  \"\"\"\n  ISO 3166-1 alpha-3 codes, upper-case, without duplicates, in the order the\n  platform lists them. Never empty: when the freight configuration declares no\n  country, this holds the sales channel's country and `source` says so.\n  \"\"\"\n  countries: [String!]!\n\n  \"\"\"\n  Where `countries` came from. A consumer that judges an address against the\n  list must not do so when this is `SALES_CHANNEL_FALLBACK`.\n  \"\"\"\n  source: ShippingCountriesSource!\n}\n\n\"\"\"The origin of a shipping-country list.\"\"\"\nenum ShippingCountriesSource {\n  \"\"\"The store's freight configuration declares these countries.\"\"\"\n  PLATFORM\n\n  \"\"\"\n  The freight configuration declares none, so the list is the sales channel's\n  country alone. It is a guess, not a declared delivery area.\n  \"\"\"\n  SALES_CHANNEL_FALLBACK\n}\n\n\"\"\"A placed order owned by the signed-in shopper.\"\"\"\ntype CustomerOrder implements Node\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Global Node id. Refetch it with `node` or `customerOrder`.\"\"\"\n  id: ID!\n\n  \"\"\"\n  Shopper-facing order number. The same value the list carries as its `id`.\n  \"\"\"\n  orderNumber: String!\n\n  \"\"\"Raw OMS status code.\"\"\"\n  status: String!\n\n  \"\"\"Whether OMS currently permits whole-order cancellation.\"\"\"\n  allowCancellation: Boolean!\n\n  \"\"\"Timestamp when the order was placed.\"\"\"\n  placedAt: DateTime\n\n  \"\"\"Grand total recorded on the order.\"\"\"\n  total: Money!\n\n  \"\"\"Itemized totals recorded on the order.\"\"\"\n  totals: [CustomerOrderTotal!]!\n\n  \"\"\"Product lines recorded on the order.\"\"\"\n  items: [CustomerOrderItem!]!\n\n  \"\"\"Product lines grouped by their selected delivery option.\"\"\"\n  deliveryOptions: [CustomerOrderDeliveryOption!]!\n\n  \"\"\"Payments recorded on active and historical transactions.\"\"\"\n  payments: [CustomerOrderPayment!]!\n\n  \"\"\"Whether every package has a recorded delivery confirmation.\"\"\"\n  isAllDelivered: Boolean\n\n  \"\"\"Earliest estimated delivery timestamp.\"\"\"\n  shippingEstimatedDateMin: DateTime\n\n  \"\"\"Latest estimated delivery timestamp.\"\"\"\n  shippingEstimatedDateMax: DateTime\n\n  \"\"\"Timestamp when the order was invoiced.\"\"\"\n  invoiceDate: DateTime\n\n  \"\"\"\n  Order delivery channel. The order-level value when OMS supplies it, otherwise\n  the channel every logistics entry agrees on. Null when those entries differ.\n  \"\"\"\n  selectedDeliveryChannel: String\n\n  \"\"\"\n  Completion resolved once for this order, with the inputs the single-order payload carries. The list also passes courierStatusFinished, which this payload does not.\n  \"\"\"\n  completion: CustomerOrderCompletion!\n\n  \"\"\"The progress stage this order is in.\"\"\"\n  progress: CustomerOrderProgress!\n}\n\n\"\"\"\nOne of the four progress stages a shopper sees. Approval is not a stage.\n\"\"\"\nenum CustomerOrderProgressStage {\n  \"\"\"The order was placed and payment has not started.\"\"\"\n  PLACED\n\n  \"\"\"Payment is pending, awaiting authorization, or denied.\"\"\"\n  PAYMENT\n\n  \"\"\"Payment was approved and the order is being prepared.\"\"\"\n  PROCESSING\n\n  \"\"\"The order was invoiced and is on its way or ready for pickup.\"\"\"\n  SHIPPING\n}\n\n\"\"\"Progress stage resolved once for one order.\"\"\"\ntype CustomerOrderProgress {\n  \"\"\"The stage the order is in. A cancelled order stays on PAYMENT.\"\"\"\n  stage: CustomerOrderProgressStage!\n\n  \"\"\"True when payment was denied or the order was cancelled.\"\"\"\n  paymentFailed: Boolean!\n\n  \"\"\"True when the order is cancelled or a cancellation was requested.\"\"\"\n  cancelled: Boolean!\n}\n\n\"\"\"One total line recorded on a placed order.\"\"\"\ntype CustomerOrderTotal {\n  \"\"\"Stable total category code.\"\"\"\n  id: String!\n\n  \"\"\"Upstream total name.\"\"\"\n  name: String!\n\n  \"\"\"Monetary value of this total line.\"\"\"\n  value: Money!\n}\n\n\"\"\"One product line recorded on a placed order.\"\"\"\ntype CustomerOrderItem {\n  \"\"\"Stable line identifier within the order.\"\"\"\n  id: ID!\n\n  \"\"\"Product name recorded at purchase time.\"\"\"\n  name: String!\n\n  \"\"\"Purchased quantity.\"\"\"\n  quantity: Int!\n\n  \"\"\"Product image recorded at purchase time.\"\"\"\n  image: Image\n\n  \"\"\"Base unit price recorded on the line.\"\"\"\n  price: Money\n\n  \"\"\"Unit list price recorded on the line.\"\"\"\n  listPrice: Money\n\n  \"\"\"Effective unit selling price recorded on the line.\"\"\"\n  sellingPrice: Money\n\n  \"\"\"\n  Line total from the recorded selling price and quantity. Null when that price is absent.\n  \"\"\"\n  total: Money\n\n  \"\"\"\n  Tax recorded on the line. Null when OMS omitted it. A recorded zero is kept.\n  \"\"\"\n  tax: Money\n\n  \"\"\"Custom values recorded on the line.\"\"\"\n  customFields: [CustomerOrderItemCustomField!]!\n}\n\n\"\"\"A custom value recorded on an order line.\"\"\"\ntype CustomerOrderItemCustomField {\n  \"\"\"Custom field name.\"\"\"\n  name: String!\n\n  \"\"\"Custom field value as recorded on the order.\"\"\"\n  value: String!\n}\n\n\"\"\"Products that share one selected delivery option.\"\"\"\ntype CustomerOrderDeliveryOption {\n  \"\"\"Selected service-level agreement name.\"\"\"\n  selectedSla: String\n\n  \"\"\"Address identifier recorded by OMS.\"\"\"\n  addressId: String\n\n  \"\"\"Delivery or pickup channel.\"\"\"\n  deliveryChannel: String\n\n  \"\"\"Estimated delivery timestamp for this option.\"\"\"\n  shippingEstimateDate: DateTime\n\n  \"\"\"Historical address recorded on the order.\"\"\"\n  address: CustomerOrderAddress\n\n  \"\"\"Product lines assigned to this option.\"\"\"\n  items: [CustomerOrderItem!]!\n}\n\n\"\"\"Historical delivery address recorded on an order.\"\"\"\ntype CustomerOrderAddress {\n  \"\"\"Recipient name.\"\"\"\n  receiverName: String\n\n  \"\"\"Postal code.\"\"\"\n  postalCode: String\n\n  \"\"\"City.\"\"\"\n  city: String\n\n  \"\"\"State or region.\"\"\"\n  state: String\n\n  \"\"\"ISO country code.\"\"\"\n  country: String\n\n  \"\"\"Street.\"\"\"\n  street: String\n\n  \"\"\"Street number.\"\"\"\n  number: String\n\n  \"\"\"Neighborhood.\"\"\"\n  neighborhood: String\n\n  \"\"\"Address complement.\"\"\"\n  complement: String\n\n  \"\"\"Address reference.\"\"\"\n  reference: String\n}\n\n\"\"\"One payment recorded on a placed order.\"\"\"\ntype CustomerOrderPayment {\n  \"\"\"Shopper-facing payment method name.\"\"\"\n  methodName: String\n\n  \"\"\"\n  Last four digits recorded on the payment. Null when OMS omitted them or sent a blank.\n  \"\"\"\n  lastDigits: String\n\n  \"\"\"Amount charged through this payment.\"\"\"\n  amount: Money!\n\n  \"\"\"Number of installments.\"\"\"\n  installments: Int\n\n  \"\"\"Gift-card redemption code when this payment used one.\"\"\"\n  redemptionCode: String\n\n  \"\"\"Bank-invoice number already recorded on the payment.\"\"\"\n  bankInvoiceNumber: String\n\n  \"\"\"Existing bank-invoice print URL.\"\"\"\n  bankInvoicePrintUrl: URI\n}\n\n\"\"\"Which slice of the shopper's orders to read.\"\"\"\nenum CustomerOrdersView {\n  \"\"\"Every order in the narrowed route result.\"\"\"\n  ALL\n\n  \"\"\"Orders the completion rule places in ongoing.\"\"\"\n  ONGOING\n\n  \"\"\"Orders the completion rule places in completed.\"\"\"\n  COMPLETED\n\n  \"\"\"Orders the completion rule places in cancelled.\"\"\"\n  CANCELLED\n}\n\n\"\"\"The view resolved for one list order.\"\"\"\nenum CustomerOrderCompletionView {\n  \"\"\"The order is still open.\"\"\"\n  ONGOING\n\n  \"\"\"The order has reached the shopper, or the shipment window has passed.\"\"\"\n  COMPLETED\n\n  \"\"\"The cancellation has finished.\"\"\"\n  CANCELLED\n}\n\n\"\"\"Label id for the catalogue. The catalogue owns the sentence.\"\"\"\nenum CustomerOrderCompletionLabel {\n  \"\"\"A finished cancellation.\"\"\"\n  CANCELLED\n\n  \"\"\"A cancellation that was requested and has not finished.\"\"\"\n  CANCELLATION_REQUESTED\n\n  \"\"\"An order that is not yet shipped.\"\"\"\n  IN_PROGRESS\n\n  \"\"\"Delivery was confirmed.\"\"\"\n  DELIVERED\n\n  \"\"\"Shipped, or completed from the estimate or the invoice period.\"\"\"\n  SHIPPED\n\n  \"\"\"Ready for the shopper to collect.\"\"\"\n  READY_FOR_PICKUP\n\n  \"\"\"Pickup collection was confirmed.\"\"\"\n  COLLECTED\n}\n\n\"\"\"View and label resolved once for one list order.\"\"\"\ntype CustomerOrderCompletion {\n  \"\"\"The view this order belongs to.\"\"\"\n  view: CustomerOrderCompletionView!\n\n  \"\"\"The catalogue label id.\"\"\"\n  label: CustomerOrderCompletionLabel!\n}\n\n\"\"\"One order on the shopper's list. The detail document is CustomerOrder.\"\"\"\ntype CustomerOrderListItem {\n  \"\"\"Shopper-facing order number. Pass this value to customerOrder.\"\"\"\n  id: ID!\n\n  \"\"\"Raw OMS status code. Empty when the list entry omits it.\"\"\"\n  status: String!\n\n  \"\"\"When the order was placed.\"\"\"\n  placedAt: DateTime\n\n  \"\"\"\n  Grand total. Null when the list entry omits the value or the currency code.\n  \"\"\"\n  total: Money\n\n  \"\"\"Sum of line quantities. Null when the list entry omits it.\"\"\"\n  itemCount: Int\n\n  \"\"\"Completion resolved once for this order.\"\"\"\n  completion: CustomerOrderCompletion!\n\n  \"\"\"Whether every package has a recorded delivery confirmation.\"\"\"\n  isAllDelivered: Boolean\n\n  \"\"\"Earliest estimated delivery timestamp.\"\"\"\n  shippingEstimatedDateMin: DateTime\n\n  \"\"\"Latest estimated delivery timestamp.\"\"\"\n  shippingEstimatedDateMax: DateTime\n\n  \"\"\"Timestamp when the order was invoiced.\"\"\"\n  invoiceDate: DateTime\n\n  \"\"\"Delivery channel when the list entry carries it.\"\"\"\n  selectedDeliveryChannel: String\n}\n\n\"\"\"An edge in the shopper's order list.\"\"\"\ntype CustomerOrderListItemEdge {\n  \"\"\"Resume cursor for the order after this one.\"\"\"\n  cursor: Cursor!\n\n  \"\"\"The list order.\"\"\"\n  node: CustomerOrderListItem!\n}\n\n\"\"\"One page of the signed-in shopper's orders.\"\"\"\ntype CustomerOrdersConnection {\n  \"\"\"Orders on this page.\"\"\"\n  edges: [CustomerOrderListItemEdge!]!\n\n  \"\"\"Cursors for the page.\"\"\"\n  pageInfo: PageInfo!\n\n  \"\"\"Route total for ALL. Classified count so far for a filtered view.\"\"\"\n  totalCount: Int!\n\n  \"\"\"True only when a filtered walk stopped at 20 upstream pages.\"\"\"\n  totalIncomplete: Boolean!\n}\n\n\"\"\"Criteria applied before the page is returned.\"\"\"\ninput CustomerOrdersFilterInput {\n  \"\"\"View to return. Defaults to every order.\"\"\"\n  view: CustomerOrdersView = ALL\n\n  \"\"\"Free-text term sent to the order route.\"\"\"\n  text: String\n\n  \"\"\"Inclusive start of the placed-date range, as an instant.\"\"\"\n  placedFrom: DateTime\n\n  \"\"\"Inclusive end of the placed-date range, as an instant.\"\"\"\n  placedTo: DateTime\n}\n\n\"\"\"What the shopper submits with a whole-order cancellation.\"\"\"\ninput CustomerOrderCancelInput {\n  \"\"\"Optional reason the merchant keeps. Trimmed; at most 500 characters.\"\"\"\n  reason: String\n}\n\n\"\"\"The set of expected, typed cancellation failure codes.\"\"\"\nenum CustomerOrderCancelErrorCode {\n  \"\"\"\n  Checkout refused the cancellation. The order is past the point where the shopper\n  can cancel it, or a cancellation was already requested.\n  \"\"\"\n  ORDER_NOT_CANCELLABLE\n\n  \"\"\"\n  No order the signed-in shopper can see has this id. A missing id and someone\n  else's id are not distinguished.\n  \"\"\"\n  NOT_FOUND\n}\n\n\"\"\"A typed, expected failure of a cancellation.\"\"\"\ntype CustomerOrderCancelError {\n  \"\"\"Machine-readable code for the failure.\"\"\"\n  code: CustomerOrderCancelErrorCode!\n\n  \"\"\"A fixed message. Never echoes the upstream response.\"\"\"\n  message: String!\n}\n\n\"\"\"The result of a cancellation request.\"\"\"\ntype CustomerOrderCancelPayload {\n  \"\"\"\n  The order re-read after checkout accepted the request. Null on a user error, and\n  null when the re-read failed after an accepted request.\n  \"\"\"\n  customerOrder: CustomerOrder\n\n  \"\"\"Typed, expected failures. Empty on success.\"\"\"\n  userErrors: [CustomerOrderCancelError!]!\n}\n\n\"\"\"\nThe signed-in shopper's saved cards, read from their persistent checkout\nprofile. Never cart-scoped.\n\"\"\"\ntype CustomerSavedCards\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  Stable identity for cache normalization. Not a Relay Node ID: derived from the\n  session, with no id argument and no Query.node entry.\n  \"\"\"\n  id: ID!\n\n  \"\"\"\n  Every card the shopper saved, in the platform's order, including expired and\n  unusable ones. Empty when none is saved.\n  \"\"\"\n  cards: [CustomerSavedCard!]!\n}\n\n\"\"\"\nOne of the shopper's saved cards, as the account sees it. Distinct from the\ncart-scoped SavedCard. Never carries a card number beyond its last four digits,\na BIN, or a security code.\n\"\"\"\ntype CustomerSavedCard\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Opaque, stable cache key. Not a Relay Node ID.\"\"\"\n  id: ID!\n\n  \"\"\"The card network the card belongs to.\"\"\"\n  network: CardNetwork!\n\n  \"\"\"\n  The card number's last four digits. Empty when the platform's record has none.\n  \"\"\"\n  lastDigits: String!\n\n  \"\"\"When the card expires. Null when the platform's record has no date.\"\"\"\n  expiry: CardExpiry\n\n  \"\"\"\n  Whether the card can still be used, derived once here so the UI never re-derives it.\n  \"\"\"\n  status: CustomerSavedCardStatus!\n}\n\n\"\"\"A card network, such as Visa or Mastercard.\"\"\"\ntype CardNetwork {\n  \"\"\"\n  The platform's payment-system id for the network. Empty when the record has none.\n  \"\"\"\n  id: String!\n\n  \"\"\"\n  Display name of the network (e.g. \"Visa\"). Falls back to the id when the record has no name.\n  \"\"\"\n  name: String!\n}\n\n\"\"\"A card's expiry month and year.\"\"\"\ntype CardExpiry {\n  \"\"\"Expiry month, from 1 to 12.\"\"\"\n  month: Int!\n\n  \"\"\"Four-digit expiry year.\"\"\"\n  year: Int!\n}\n\n\"\"\"Whether a saved card can still be used.\"\"\"\nenum CustomerSavedCardStatus {\n  \"\"\"The card has not expired and the platform reports nothing against it.\"\"\"\n  USABLE\n\n  \"\"\"\n  The card's expiry date has passed. Wins over any other platform report.\n  \"\"\"\n  EXPIRED\n\n  \"\"\"The card has not expired, but the platform reports it cannot be used.\"\"\"\n  UNUSABLE\n}\n\n\"\"\"\nA card network the store accepts on the request's sales channel, with the\nrules card entry validates a card by. Read from the store's payment systems,\nnever from a cart.\n\"\"\"\ntype CardNetworkRule\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"\n  The network. Its id is the platform's payment-system id, the same id a saved\n  card's network carries.\n  \"\"\"\n  network: CardNetwork!\n\n  \"\"\"\n  Pattern a full card number of this network matches. Null when the store sets none.\n  \"\"\"\n  numberRegex: String\n\n  \"\"\"\n  Display mask for the card number, with 9 standing for a digit. Null when the store sets none.\n  \"\"\"\n  numberMask: String\n\n  \"\"\"Pattern the security code matches. Null when the store sets none.\"\"\"\n  securityCodeRegex: String\n\n  \"\"\"Display mask for the security code. Null when the store sets none.\"\"\"\n  securityCodeMask: String\n\n  \"\"\"Whether the card asks for a security code.\"\"\"\n  securityCodeRequired: Boolean!\n\n  \"\"\"Whether the card asks for an expiry date.\"\"\"\n  expirationRequired: Boolean!\n\n  \"\"\"Whether the card asks for the holder's name.\"\"\"\n  holderNameRequired: Boolean!\n\n  \"\"\"Whether a cardholder document is required for this network.\"\"\"\n  requiresDocument: Boolean!\n\n  \"\"\"\n  Whether a cardholder document field is shown for this network. Distinct from requiresDocument.\n  \"\"\"\n  displayDocument: Boolean!\n}\n\n\"\"\"\nOne of the signed-in shopper's saved addresses a new card can be billed to.\n\"\"\"\ntype CardBillingAddress\n  @cacheControl(maxAge: 0, scope: PRIVATE)\n{\n  \"\"\"Opaque, stable cache key. Not a Relay Node ID.\"\"\"\n  id: ID!\n\n  \"\"\"\n  Name of the person the address belongs to. Null when the platform's record has none.\n  \"\"\"\n  receiverName: String\n\n  \"\"\"Street name. Null when the platform's record has none.\"\"\"\n  street: String\n\n  \"\"\"Street number. Null when the platform's record has none.\"\"\"\n  number: String\n\n  \"\"\"\n  Complement, such as an apartment. Null when the platform's record has none.\n  \"\"\"\n  complement: String\n\n  \"\"\"Neighborhood. Null when the platform's record has none.\"\"\"\n  neighborhood: String\n\n  \"\"\"City. Null when the platform's record has none.\"\"\"\n  city: String\n\n  \"\"\"State or province. Null when the platform's record has none.\"\"\"\n  state: String\n\n  \"\"\"Postal code. Null when the platform's record has none.\"\"\"\n  postalCode: String\n\n  \"\"\"\n  Country of the address, as the platform stores it (ISO 3166-1 alpha-3).\n  \"\"\"\n  country: String!\n}\n\n\"\"\"Payload returned by customerSavedCardRemove.\"\"\"\ntype CustomerSavedCardRemovePayload {\n  \"\"\"\n  The shopper's saved cards after the removal. Null when userErrors is non-empty.\n  \"\"\"\n  customerSavedCards: CustomerSavedCards\n\n  \"\"\"Domain errors that stopped the removal. Empty on success.\"\"\"\n  userErrors: [CustomerSavedCardRemoveError!]!\n}\n\n\"\"\"A domain error returned by customerSavedCardRemove.\"\"\"\ntype CustomerSavedCardRemoveError {\n  \"\"\"Machine-readable error code.\"\"\"\n  code: CustomerSavedCardRemoveErrorCode!\n\n  \"\"\"Human-readable error message.\"\"\"\n  message: String!\n}\n\n\"\"\"Why a saved card was not removed.\"\"\"\nenum CustomerSavedCardRemoveErrorCode {\n  \"\"\"The id names no saved card of the signed-in shopper.\"\"\"\n  CARD_NOT_FOUND\n\n  \"\"\"\n  The platform refused the removal, or the card is still listed after it.\n  \"\"\"\n  REMOVAL_REFUSED\n}\n\nenum link__Purpose {\n  \"\"\"\n  `SECURITY` features provide metadata necessary to securely resolve fields.\n  \"\"\"\n  SECURITY\n\n  \"\"\"\n  `EXECUTION` features provide metadata necessary for operation execution.\n  \"\"\"\n  EXECUTION\n}\n\nscalar link__Import\n\nscalar federation__FieldSet\n\nscalar federation__Scope\n\nscalar federation__Policy\n\nscalar federation__ContextFieldValue\n\nscalar _Any\n\ntype _Service {\n  sdl: String\n}\n\nunion _Entity = Product\n";
 //#endregion
 //#region src/cli/core-sdl.ts
 /**
@@ -17961,14 +18333,6 @@ function extensionName(extensionRoot, definition) {
 	return "extension";
 }
 //#endregion
-//#region src/cli/host.ts
-/** The host's esbuild, or a clear error naming the field the host forgot. */
-function requireEsbuild(host, verb) {
-	const bundler = host?.esbuild;
-	if (!bundler || typeof bundler.build !== "function") throw new Error(`storefront ${verb}: host.esbuild is required — pass \`{ esbuild }\` from the host.`);
-	return bundler;
-}
-//#endregion
 //#region src/cli/load-declaration.ts
 /**
 * Resolves the extension's declaration entry point: `src/index.ts` by
@@ -18006,7 +18370,7 @@ function isDeclaration(value) {
 */
 const CREATE_REQUIRE_BANNER = "import { createRequire as __storefrontCreateRequire } from 'node:module';\nconst require = __storefrontCreateRequire(import.meta.url);";
 /**
-* Bundles the declaration entry with the host's esbuild into
+* Bundles the declaration entry with the runner's esbuild into
 * `.vtex/storefront/load/<hash>.mjs` and returns that path. First-party
 * modules are bundled, so `from './schema'` and an `enum` both work without a
 * TypeScript loader; packages stay external and resolve from the extension's
@@ -18025,8 +18389,8 @@ const CREATE_REQUIRE_BANNER = "import { createRequire as __storefrontCreateRequi
 * first-party module lands on a new file name and is evaluated afresh, while
 * an unchanged declaration reuses the module it already has.
 */
-async function bundleDeclaration(extensionRoot, entryPath, host, verb) {
-	const bundler = requireEsbuild(host, verb);
+async function bundleDeclaration(extensionRoot, entryPath, verb) {
+	const bundler = await loadBundler(verb);
 	const root = resolve(extensionRoot);
 	let code;
 	try {
@@ -18051,19 +18415,27 @@ async function bundleDeclaration(extensionRoot, entryPath, host, verb) {
 }
 /**
 * Loads the extension's `defineSubgraph` declaration: bundles the entry with
-* the host's esbuild (see `bundleDeclaration`) and `import()`s the bundle.
+* the runner's esbuild (see `bundleDeclaration`) and `import()`s the bundle.
 * `verb` names the caller in every error, because the same failure reads
 * differently under `validate`, `build` and `dev`.
 */
-async function loadDeclaration(extensionRoot, host, verb = "dev") {
+async function loadDeclaration(extensionRoot, verb = "dev") {
 	const entryPath = resolveDeclarationEntry(extensionRoot);
 	if (!existsSync(entryPath)) throw new Error(`storefront ${verb}: declaration entry not found at ${entryPath}.`);
-	const bundle = await bundleDeclaration(extensionRoot, entryPath, host, verb);
+	const bundle = await bundleDeclaration(extensionRoot, entryPath, verb);
 	const definition = extractDeclaration(await import(pathToFileURL(bundle).href));
 	if (!definition) throw new Error(`storefront ${verb}: ${entryPath} must \`export default defineSubgraph({ ... })\`. No default export with a \`typeDefs\` property was found.`);
 	return definition;
 }
 //#endregion
+//#region src/cli/log.ts
+/** The default sink: a caller that passes nothing hears nothing. */
+const SILENT_LOG = {
+	info: () => void 0,
+	warn: () => void 0,
+	error: () => void 0
+};
+//#endregion
 //#region ../../node_modules/.pnpm/@apollo+subgraph@2.13.3_graphql@16.13.1/node_modules/@apollo/subgraph/dist/schema-helper/resolverMap.js
 var require_resolverMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
@@ -30962,7 +31334,7 @@ var require_ansi_styles = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region ../../node_modules/.pnpm/supports-color@7.2.0/node_modules/supports-color/index.js
 var require_supports_color = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const os$1 = __require("os");
+	const os = __require("os");
 	const tty = __require("tty");
 	const hasFlag = require_has_flag();
 	const { env } = process;
@@ -30991,7 +31363,7 @@ var require_supports_color = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 		const min = forceColor || 0;
 		if (env.TERM === "dumb") return min;
 		if (process.platform === "win32") {
-			const osRelease = os$1.release().split(".");
+			const osRelease = os.release().split(".");
 			if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) return Number(osRelease[2]) >= 14931 ? 3 : 2;
 			return 1;
 		}
@@ -33611,20 +33983,37 @@ function printSubgraphSdl(definition) {
 //#endregion
 //#region src/cli/typescript.ts
 /**
+* Raised when the Asset's `typescript` cannot serve the capability lint or the
+* type-check: it is not installed, or the module that loads has no compiler
+* API (`typescript@7` exports `lib/version.cjs` and no `createSourceFile`).
+* `validateExtension` turns it into `ValidationReport.typescript` instead of
+* failing the whole run (ADR-0026, TypeScript 5 through the peer).
+*/
+var TypeScriptUnavailableError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "TypeScriptUnavailableError";
+	}
+};
+/**
 * The TypeScript compiler, imported on first use. `typescript` is an optional
 * peer of `@vtex/faststore`: every TypeScript extension already has it, and
 * only the capability lint and `build`'s type-check need it, so `dist/cli`
 * loads without it and a store app installs none. A host that calls those two
 * without it installed gets the package named instead of a bare resolution
-* error.
+* error. The check is for the compiler API, not the version string, so a
+* TypeScript 5 fork or a later major that keeps the API still passes.
 */
 async function loadTypeScript(verb) {
+	let mod;
 	try {
-		const mod = await import("typescript");
-		return mod.default ?? mod;
+		mod = await import("typescript");
 	} catch (error) {
-		throw new Error(`storefront ${verb}: \`typescript\` is not installed. Add it to the extension's devDependencies. Cause: ${error instanceof Error ? error.message : String(error)}`);
+		throw new TypeScriptUnavailableError(`storefront ${verb}: \`typescript\` is not installed. Add it to the extension's devDependencies. Cause: ${error instanceof Error ? error.message : String(error)}`);
 	}
+	const ts = mod.default ?? mod;
+	if (typeof ts.createSourceFile !== "function") throw new TypeScriptUnavailableError(`storefront ${verb}: ${typeof ts.version === "string" ? `typescript@${ts.version}` : "`typescript`"} has no TypeScript 5 compiler API (\`createSourceFile\` is not a function).`);
+	return ts;
 }
 //#endregion
 //#region src/cli/capability-lint.ts
@@ -33768,7 +34157,7 @@ function formatFinding(finding) {
 * report — the shared core behind the host's `validate` verb and `build`'s
 * fail-closed gate. It:
 *
-* 1. loads the declaration through the host's esbuild (the same
+* 1. loads the declaration through the runner's esbuild (the same
 *    `loadDeclaration` `dev` uses),
 * 2. builds the subgraph (allow-list rejection and `vendor` validation surface
 *    here as a thrown error, captured into `buildError`),
@@ -33781,14 +34170,21 @@ function formatFinding(finding) {
 * composition check is `@theguild/federation-composition` in-process, the same
 * composer `dev` and the core SDL CI gate call (ADR-0004, D1).
 */
-async function validateExtension(extensionRoot, host) {
-	requireEsbuild(host, "validate");
-	const capability = await lintExtension(resolveDeclarationEntry(extensionRoot));
+async function validateExtension(extensionRoot) {
+	const entry = resolveDeclarationEntry(extensionRoot);
+	let capability = [];
+	let typescript;
+	try {
+		capability = await lintExtension(entry);
+	} catch (error) {
+		if (!(error instanceof TypeScriptUnavailableError)) throw error;
+		typescript = error;
+	}
 	let definition;
 	let buildError;
 	const composition = [];
 	try {
-		definition = await loadDeclaration(extensionRoot, host, "validate");
+		definition = await loadDeclaration(extensionRoot, "validate");
 		buildSubgraph(definition);
 	} catch (error) {
 		buildError = error instanceof Error ? error : new Error(String(error));
@@ -33797,22 +34193,24 @@ async function validateExtension(extensionRoot, host) {
 		const result = (0, import_compose.composeCheck)(coreFederationSdl(), printSubgraphSdl(definition));
 		if (!result.success) composition.push(...result.errors);
 	}
-	const ok = capability.length === 0 && composition.length === 0 && buildError === void 0;
+	const ok = typescript === void 0 && capability.length === 0 && composition.length === 0 && buildError === void 0;
 	return {
 		capability,
 		composition,
 		buildError,
+		typescript,
 		ok
 	};
 }
 /**
 * Renders a `ValidationReport`'s failures as human-readable lines, grouped by
-* category (build/allow-list, capability, composition) — every failure in one
-* pass, never short-circuited at the first. Returns an empty array for a clean
-* report so the caller prints its own success line.
+* category (typescript, build/allow-list, capability, composition) — every
+* failure in one pass, never short-circuited at the first. Returns an empty
+* array for a clean report so the caller prints its own success line.
 */
 function formatValidationReport(report) {
 	const lines = [];
+	if (report.typescript) lines.push(`  typescript: ${report.typescript.message}`);
 	if (report.buildError) lines.push(`  build: ${report.buildError.message}`);
 	for (const finding of report.capability) lines.push(`  capability: ${formatFinding(finding)}`);
 	for (const error of report.composition) lines.push(`  composition: ${error.message}`);
@@ -33845,7 +34243,7 @@ var CompileError = class extends Error {
 */
 function parseTsConfig(ts, extensionRoot) {
 	const tsconfigPath = join(extensionRoot, "tsconfig.json");
-	if (!existsSync(tsconfigPath)) throw new CompileError(`storefront build: no tsconfig.json found at ${tsconfigPath}.`);
+	if (!existsSync(tsconfigPath)) throw new CompileError("storefront build: no tsconfig.json found at the Asset root.");
 	const read = ts.readConfigFile(tsconfigPath, ts.sys.readFile);
 	if (read.error) throw new CompileError(`storefront build: could not read tsconfig.json:\n${ts.formatDiagnostic(read.error, diagnosticHost(ts))}`);
 	const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, extensionRoot);
@@ -33871,10 +34269,10 @@ function diagnosticHost(ts) {
 * `server.mjs` embeds, and a `package.json` `main` outside the `include` would
 * otherwise ship unchecked.
 */
-async function typecheck(extensionRoot) {
+async function typecheck(extensionRoot, entryPath) {
 	const ts = await loadTypeScript("build");
 	const parsed = parseTsConfig(ts, extensionRoot);
-	const rootNames = [.../* @__PURE__ */ new Set([...parsed.fileNames, resolveDeclarationEntry(extensionRoot)])];
+	const rootNames = [.../* @__PURE__ */ new Set([...parsed.fileNames, entryPath])];
 	const program = ts.createProgram({
 		rootNames,
 		options: parsed.options
@@ -33889,7 +34287,7 @@ async function typecheck(extensionRoot) {
 */
 function serverRuntimePath() {
 	const path = fileURLToPath(new URL("./server-runtime.js", import.meta.url));
-	if (!existsSync(path)) throw new Error(`storefront build: the server runtime is missing at ${path} — is @vtex/faststore built?`);
+	if (!existsSync(path)) throw new Error("storefront build: the server runtime (dist/cli/server-runtime.js) is missing beside the ./cli entry — is @vtex/faststore built?");
 	return path;
 }
 /**
@@ -33905,8 +34303,8 @@ function serverRuntimePath() {
 * bundle carries a banner of the same shape; esbuild renames that module's
 * binding, so only the import alias has to differ.
 */
-async function bundleServer(host, extensionRoot, entryPath, name, outfile) {
-	const bundler = requireEsbuild(host, "build");
+async function bundleServer(extensionRoot, entryPath, name, outfile) {
+	const bundler = await loadBundler("build");
 	const contents = [
 		`import definition from ${JSON.stringify(entryPath)};`,
 		`import { runServer } from ${JSON.stringify(serverRuntimePath())};`,
@@ -33934,31 +34332,44 @@ async function bundleServer(host, extensionRoot, entryPath, name, outfile) {
 	}
 }
 /**
-* Produces the deployable artifact for an extension: runs `validate` first as a
-* fail-closed gate (any failure emits nothing and throws `ValidationGateError`),
-* type-checks the extension, loads the declaration through the host's esbuild,
-* writes `extension.graphql` from `printSubgraphSdl` of that declaration and
-* bundles `server.mjs` into a staging dir under the `.vtex/storefront/` scratch
-* dir, and only then swaps the assembled staging dir into `dist/`. `dist/` is
-* therefore only ever absent, the previous complete artifact, or the new
-* complete artifact — a failed build never leaves partial output or keeps
-* stale files from an earlier build. Output is `server.mjs` + the SDL slice
-* only — no `router.json`, and no composed artifact (Decision 1). Throws on
-* any failure so the caller can surface it and exit non-zero.
+* What the swap would empty out of the Asset if it emptied `outDir`, or
+* `undefined` for a folder the build may own: the Asset itself (`outDir` is the
+* root or an ancestor), the scratch folder that holds the staging folder, the
+* router cache and the dev lock, or the Asset's source (`src/`, the declaration
+* entry's folder), whether `outDir` contains the folder or lies inside it.
+* Compared as the filesystem spells them (`paths.ts`). A leaf of its own
+* (`<root>/dist`, `<root>/.vtex/build/…`) and a sibling are fine.
+*/
+function heldByOutDir(outDir, root, entry) {
+	if (isInside(root, outDir)) return "contains the Asset (it is the root or an ancestor)";
+	const scratch = join(root, SCRATCH_PARENT_DIR_NAME, SCRATCH_DIR_NAME);
+	const scratchName = `the scratch folder ${SCRATCH_PARENT_DIR_NAME}/${SCRATCH_DIR_NAME}/`;
+	if (isInside(scratch, outDir)) return `contains ${scratchName}`;
+	if (isInside(outDir, scratch)) return `lies inside ${scratchName}`;
+	const source = join(root, "src");
+	if (isInside(source, outDir)) return "contains the Asset's source folder src/";
+	if (isInside(outDir, source)) return "lies inside the Asset's source folder src/";
+	if (entry !== void 0) {
+		if (isInside(entry, outDir)) return "contains the declaration entry";
+		const entryDir = dirname(entry);
+		if (!isInside(root, entryDir) && isInside(outDir, entryDir)) return "lies inside the declaration entry's folder";
+	}
+}
+/**
+* The API side's gate and compose, all before a byte of output exists: `validate`
+* fail-closed (any failure throws `ValidationGateError`), the type-check, the
+* declaration load through the runner's esbuild, the SDL slice from
+* `printSubgraphSdl` of that declaration, and its composition with the embedded
+* core SDL.
 *
-* The composed artifacts go to `.vtex/storefront/` scratch instead, so a
-* store's CI compile has a fresh client schema without a running `dev` loop.
-* They are composed from the same slice `server.mjs` serves and written only
-* after `dist/` is in place, so an emitted artifact always describes emitted
-* output.
+* esbuild is imported on first use, inside `validate`'s declaration load, so a
+* broken install surfaces here, before `outDir` or `.vtex/` is written.
 */
-async function buildExtension(extensionRoot, host) {
-	requireEsbuild(host, "build");
-	const root = resolve(extensionRoot);
-	const report = await validateExtension(root, host);
+async function prepareApiSide(root, entry) {
+	const report = await validateExtension(root);
 	if (!report.ok) throw new ValidationGateError(formatValidationReport(report));
-	await typecheck(root);
-	const definition = await loadDeclaration(root, host, "build");
+	await typecheck(root, entry);
+	const definition = await loadDeclaration(root, "build");
 	const name = extensionName(root, definition);
 	const extensionSdl = printSubgraphSdl(definition);
 	const composed = (0, import_compose.composeSupergraph)([{
@@ -33971,24 +34382,143 @@ async function buildExtension(extensionRoot, host) {
 		sdl: extensionSdl
 	}]);
 	if (!composed.success) throw new Error(formatCompositionErrors("build", composed.errors));
+	return {
+		entry,
+		name,
+		extensionSdl,
+		composed
+	};
+}
+/**
+* Replaces `outDir` with the assembled staging dir in one rename. A rename
+* across filesystems fails with `EXDEV` (an `--out` on another volume, a tmpfs
+* `/tmp`); on that code alone the staging dir is copied to a sibling of
+* `outDir`, on its volume, and that sibling is renamed into place, so a copy
+* that stops halfway (a full disk) leaves `outDir` absent instead of partial.
+* The caller's `finally` removes the staging dir. Anything else propagates.
+*/
+function swapInto(stagingDir, outDir) {
+	rmSync(outDir, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(dirname(outDir), { recursive: true });
+	try {
+		renameSync(stagingDir, outDir);
+	} catch (error) {
+		if (!(error instanceof Error && "code" in error && error.code === "EXDEV")) throw error;
+		const landing = `${outDir}.partial-${pid}`;
+		try {
+			cpSync(stagingDir, landing, { recursive: true });
+			renameSync(landing, outDir);
+		} finally {
+			rmSync(landing, {
+				recursive: true,
+				force: true
+			});
+		}
+	}
+}
+/** The UI side as `BuildResult` reports it: the addon's staging paths rebased onto `outDir`. */
+function uiBuildOutput(staged, stagingDir, outDir, docs) {
+	const emitted = (path) => join(outDir, relative(stagingDir, path));
+	return {
+		catalogPath: emitted(staged.catalogPath),
+		contentTypesPath: staged.contentTypesPath === null ? null : emitted(staged.contentTypesPath),
+		docsDir: join(outDir, "docs"),
+		catalogEntries: staged.catalogEntries,
+		docs
+	};
+}
+/**
+* Copies the catalog, and the content types when there are any, from `outDir`
+* to the folder the Asset's `exports["./catalog.json"]` names: that export is
+* how a store finds the Asset (ADR-0007), so a store builds against a built
+* Asset with no `dev` loop having run. Nothing to copy when `outDir` already
+* is that folder.
+*/
+function copyCatalogToExport(ui, exported, outDir) {
+	if (canonical(exported) === canonical(outDir)) return;
+	mkdirSync(exported, { recursive: true });
+	copyFileSync(ui.catalogPath, join(exported, "catalog.json"));
+	if (ui.contentTypesPath !== null) copyFileSync(ui.contentTypesPath, join(exported, "content-types.json"));
+}
+/**
+* Produces the deployable output for a storefront Asset, both sides into the
+* folder the caller names: `server.mjs` and the SDL slice for the API side,
+* `catalog.json` (and `content-types.json` when the addon emitted one) with
+* the component docs flat under `docs/` for the UI side (ADR-0026). `outDir`
+* is `dist` under the root unless passed; `vtex extension build` passes the
+* folder it chose, `.vtex/build/<ext>/<asset>/` by default. An `outDir` equal
+* to the root or containing it is refused before anything runs, since the swap
+* below empties it. An Asset with neither side throws: there is nothing to
+* build.
+*
+* The UI side's `catalog.json` (and `content-types.json`) also land in the
+* folder the Asset's `exports["./catalog.json"]` names, `dist/` by the
+* template: that export is how a store finds the Asset (ADR-0007), so a store
+* builds against a built Asset with no `dev` loop having run. Nothing is
+* copied when `outDir` already is that folder.
+*
+* Everything that can fail runs before a byte of output exists: the API side's
+* `validate` gate, type-check, declaration load and compose; the UI side's
+* addon load and docs plan (a basename collision throws here). Both sides then
+* write into one staging dir under the `.vtex/storefront/` scratch dir — the
+* SDL and the bundled server, the catalog built with `kind: 'extension'` (an
+* Asset named `@vtex/faststore` fails as the Core package it is not) and the
+* docs copy — and only then is the staging dir swapped into `outDir`. `outDir`
+* is therefore only ever absent, the previous complete output, or the new
+* complete output — a failed build never leaves partial output or keeps stale
+* files from an earlier build. The UI side emits no JavaScript: the store
+* compiles the components it imports. No `router.json`, and no composed
+* artifact (Decision 1). Throws on any failure so the caller can surface it
+* and exit non-zero.
+*
+* The composed artifacts go to `.vtex/storefront/` scratch instead, so a
+* store's CI compile has a fresh client schema without a running `dev` loop.
+* They are composed from the same slice `server.mjs` serves and written only
+* after `outDir` is in place, so an emitted artifact always describes emitted
+* output. A UI-only Asset composes nothing.
+*/
+async function buildExtension(extensionRoot, { log = SILENT_LOG, outDir: outDirOption } = {}) {
+	const root = resolve(extensionRoot);
+	const outDir = resolve(root, outDirOption ?? "dist");
+	const layout = readAssetLayout(root);
+	const entry = apiDeclarationEntry(layout);
+	const held = heldByOutDir(outDir, root, entry);
+	if (held !== void 0) throw new Error(`storefront build: outDir ${JSON.stringify(outDirOption ?? "dist")} ${held} — the build empties outDir.`);
+	const ui = uiSide(layout);
+	if (entry === void 0 && !ui) throw new Error("storefront build: the Asset has no API side (no package.json#main and no src/index.ts) and no UI side (no src/components/ and no exports[\"./catalog.json\"]) — nothing to build.");
+	const apiSide = entry === void 0 ? void 0 : await prepareApiSide(root, entry);
+	if (ui) await loadCatalogBuilder("build");
+	const docCopies = ui ? planDocCopies(root) : [];
 	const stagingDir = mkdtempSync(join(scratchDir(root), "build-"));
 	try {
-		writeFileSync(join(stagingDir, "extension.graphql"), extensionSdl, "utf-8");
-		await bundleServer(host, root, resolveDeclarationEntry(root), name, join(stagingDir, "server.mjs"));
-		const distDir = join(root, "dist");
-		rmSync(distDir, {
-			recursive: true,
-			force: true
-		});
-		renameSync(stagingDir, distDir);
-		const { supergraphFile, publicSchemaFile } = writeComposedArtifacts(root, composed, "build");
-		return {
-			distDir,
-			serverFile: join(distDir, "server.mjs"),
-			sdlPath: join(distDir, "extension.graphql"),
-			supergraphFile,
-			publicSchemaFile
-		};
+		if (apiSide) {
+			writeFileSync(join(stagingDir, "extension.graphql"), apiSide.extensionSdl, "utf-8");
+			await bundleServer(root, apiSide.entry, apiSide.name, join(stagingDir, "server.mjs"));
+		}
+		let uiStaged;
+		if (ui) {
+			uiStaged = await buildAssetCatalog(root, stagingDir, "build");
+			copyDocs(docCopies, join(stagingDir, "docs"));
+		}
+		swapInto(stagingDir, outDir);
+		const result = { outDir };
+		if (apiSide) {
+			const { supergraphFile, publicSchemaFile } = writeComposedArtifacts(root, apiSide.composed, "build", log);
+			result.api = {
+				serverFile: join(outDir, "server.mjs"),
+				sdlPath: join(outDir, "extension.graphql"),
+				supergraphFile,
+				publicSchemaFile
+			};
+		}
+		if (uiStaged) {
+			result.ui = uiBuildOutput(uiStaged, stagingDir, outDir, docCopies.length);
+			copyCatalogToExport(result.ui, catalogOutDir(layout), outDir);
+		}
+		return result;
 	} finally {
 		rmSync(stagingDir, {
 			recursive: true,
@@ -33998,282 +34528,10 @@ async function buildExtension(extensionRoot, host) {
 }
 //#endregion
 //#region src/cli/router-config.ts
-var import_main = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const fs = __require("fs");
-	const path = __require("path");
-	const os = __require("os");
-	const crypto$1 = __require("crypto");
-	const TIPS = [
-		"◈ encrypted .env [www.dotenvx.com]",
-		"◈ secrets for agents [www.dotenvx.com]",
-		"⌁ auth for agents [www.vestauth.com]",
-		"⌘ custom filepath { path: '/custom/path/.env' }",
-		"⌘ enable debugging { debug: true }",
-		"⌘ override existing { override: true }",
-		"⌘ suppress logs { quiet: true }",
-		"⌘ multiple files { path: ['.env.local', '.env'] }"
-	];
-	function _getRandomTip() {
-		return TIPS[Math.floor(Math.random() * TIPS.length)];
-	}
-	function parseBoolean(value) {
-		if (typeof value === "string") return ![
-			"false",
-			"0",
-			"no",
-			"off",
-			""
-		].includes(value.toLowerCase());
-		return Boolean(value);
-	}
-	function supportsAnsi() {
-		return process.stdout.isTTY;
-	}
-	function dim(text) {
-		return supportsAnsi() ? `\x1b[2m${text}\x1b[0m` : text;
-	}
-	const LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/gm;
-	function parse(src) {
-		const obj = {};
-		let lines = src.toString();
-		lines = lines.replace(/\r\n?/gm, "\n");
-		let match;
-		while ((match = LINE.exec(lines)) != null) {
-			const key = match[1];
-			let value = match[2] || "";
-			value = value.trim();
-			const maybeQuote = value[0];
-			value = value.replace(/^(['"`])([\s\S]*)\1$/gm, "$2");
-			if (maybeQuote === "\"") {
-				value = value.replace(/\\n/g, "\n");
-				value = value.replace(/\\r/g, "\r");
-			}
-			obj[key] = value;
-		}
-		return obj;
-	}
-	function _parseVault(options) {
-		options = options || {};
-		const vaultPath = _vaultPath(options);
-		options.path = vaultPath;
-		const result = DotenvModule.configDotenv(options);
-		if (!result.parsed) {
-			const err = /* @__PURE__ */ new Error(`MISSING_DATA: Cannot parse ${vaultPath} for an unknown reason`);
-			err.code = "MISSING_DATA";
-			throw err;
-		}
-		const keys = _dotenvKey(options).split(",");
-		const length = keys.length;
-		let decrypted;
-		for (let i = 0; i < length; i++) try {
-			const attrs = _instructions(result, keys[i].trim());
-			decrypted = DotenvModule.decrypt(attrs.ciphertext, attrs.key);
-			break;
-		} catch (error) {
-			if (i + 1 >= length) throw error;
-		}
-		return DotenvModule.parse(decrypted);
-	}
-	function _warn(message) {
-		console.error(`⚠ ${message}`);
-	}
-	function _debug(message) {
-		console.log(`┆ ${message}`);
-	}
-	function _log(message) {
-		console.log(`◇ ${message}`);
-	}
-	function _dotenvKey(options) {
-		if (options && options.DOTENV_KEY && options.DOTENV_KEY.length > 0) return options.DOTENV_KEY;
-		if (process.env.DOTENV_KEY && process.env.DOTENV_KEY.length > 0) return process.env.DOTENV_KEY;
-		return "";
-	}
-	function _instructions(result, dotenvKey) {
-		let uri;
-		try {
-			uri = new URL(dotenvKey);
-		} catch (error) {
-			if (error.code === "ERR_INVALID_URL") {
-				const err = /* @__PURE__ */ new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");
-				err.code = "INVALID_DOTENV_KEY";
-				throw err;
-			}
-			throw error;
-		}
-		const key = uri.password;
-		if (!key) {
-			const err = /* @__PURE__ */ new Error("INVALID_DOTENV_KEY: Missing key part");
-			err.code = "INVALID_DOTENV_KEY";
-			throw err;
-		}
-		const environment = uri.searchParams.get("environment");
-		if (!environment) {
-			const err = /* @__PURE__ */ new Error("INVALID_DOTENV_KEY: Missing environment part");
-			err.code = "INVALID_DOTENV_KEY";
-			throw err;
-		}
-		const environmentKey = `DOTENV_VAULT_${environment.toUpperCase()}`;
-		const ciphertext = result.parsed[environmentKey];
-		if (!ciphertext) {
-			const err = /* @__PURE__ */ new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${environmentKey} in your .env.vault file.`);
-			err.code = "NOT_FOUND_DOTENV_ENVIRONMENT";
-			throw err;
-		}
-		return {
-			ciphertext,
-			key
-		};
-	}
-	function _vaultPath(options) {
-		let possibleVaultPath = null;
-		if (options && options.path && options.path.length > 0) {
-			if (Array.isArray(options.path)) {
-				for (const filepath of options.path) if (fs.existsSync(filepath)) possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
-			} else possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
-		} else possibleVaultPath = path.resolve(process.cwd(), ".env.vault");
-		if (fs.existsSync(possibleVaultPath)) return possibleVaultPath;
-		return null;
-	}
-	function _resolveHome(envPath) {
-		return envPath[0] === "~" ? path.join(os.homedir(), envPath.slice(1)) : envPath;
-	}
-	function _configVault(options) {
-		const debug = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || options && options.debug);
-		const quiet = parseBoolean(process.env.DOTENV_CONFIG_QUIET || options && options.quiet);
-		if (debug || !quiet) _log("loading env from encrypted .env.vault");
-		const parsed = DotenvModule._parseVault(options);
-		let processEnv = process.env;
-		if (options && options.processEnv != null) processEnv = options.processEnv;
-		DotenvModule.populate(processEnv, parsed, options);
-		return { parsed };
-	}
-	function configDotenv(options) {
-		const dotenvPath = path.resolve(process.cwd(), ".env");
-		let encoding = "utf8";
-		let processEnv = process.env;
-		if (options && options.processEnv != null) processEnv = options.processEnv;
-		let debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || options && options.debug);
-		let quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || options && options.quiet);
-		if (options && options.encoding) encoding = options.encoding;
-		else if (debug) _debug("no encoding is specified (UTF-8 is used by default)");
-		let optionPaths = [dotenvPath];
-		if (options && options.path) {
-			if (!Array.isArray(options.path)) optionPaths = [_resolveHome(options.path)];
-			else {
-				optionPaths = [];
-				for (const filepath of options.path) optionPaths.push(_resolveHome(filepath));
-			}
-		}
-		let lastError;
-		const parsedAll = {};
-		for (const path of optionPaths) try {
-			const parsed = DotenvModule.parse(fs.readFileSync(path, { encoding }));
-			DotenvModule.populate(parsedAll, parsed, options);
-		} catch (e) {
-			if (debug) _debug(`failed to load ${path} ${e.message}`);
-			lastError = e;
-		}
-		const populated = DotenvModule.populate(processEnv, parsedAll, options);
-		debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || debug);
-		quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || quiet);
-		if (debug || !quiet) {
-			const keysCount = Object.keys(populated).length;
-			const shortPaths = [];
-			for (const filePath of optionPaths) try {
-				const relative = path.relative(process.cwd(), filePath);
-				shortPaths.push(relative);
-			} catch (e) {
-				if (debug) _debug(`failed to load ${filePath} ${e.message}`);
-				lastError = e;
-			}
-			_log(`injected env (${keysCount}) from ${shortPaths.join(",")} ${dim(`// tip: ${_getRandomTip()}`)}`);
-		}
-		if (lastError) return {
-			parsed: parsedAll,
-			error: lastError
-		};
-		else return { parsed: parsedAll };
-	}
-	function config(options) {
-		if (_dotenvKey(options).length === 0) return DotenvModule.configDotenv(options);
-		const vaultPath = _vaultPath(options);
-		if (!vaultPath) {
-			_warn(`you set DOTENV_KEY but you are missing a .env.vault file at ${vaultPath}`);
-			return DotenvModule.configDotenv(options);
-		}
-		return DotenvModule._configVault(options);
-	}
-	function decrypt(encrypted, keyStr) {
-		const key = Buffer.from(keyStr.slice(-64), "hex");
-		let ciphertext = Buffer.from(encrypted, "base64");
-		const nonce = ciphertext.subarray(0, 12);
-		const authTag = ciphertext.subarray(-16);
-		ciphertext = ciphertext.subarray(12, -16);
-		try {
-			const aesgcm = crypto$1.createDecipheriv("aes-256-gcm", key, nonce);
-			aesgcm.setAuthTag(authTag);
-			return `${aesgcm.update(ciphertext)}${aesgcm.final()}`;
-		} catch (error) {
-			const isRange = error instanceof RangeError;
-			const invalidKeyLength = error.message === "Invalid key length";
-			const decryptionFailed = error.message === "Unsupported state or unable to authenticate data";
-			if (isRange || invalidKeyLength) {
-				const err = /* @__PURE__ */ new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");
-				err.code = "INVALID_DOTENV_KEY";
-				throw err;
-			} else if (decryptionFailed) {
-				const err = /* @__PURE__ */ new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");
-				err.code = "DECRYPTION_FAILED";
-				throw err;
-			} else throw error;
-		}
-	}
-	function populate(processEnv, parsed, options = {}) {
-		const debug = Boolean(options && options.debug);
-		const override = Boolean(options && options.override);
-		const populated = {};
-		if (typeof parsed !== "object") {
-			const err = /* @__PURE__ */ new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
-			err.code = "OBJECT_REQUIRED";
-			throw err;
-		}
-		for (const key of Object.keys(parsed)) if (Object.prototype.hasOwnProperty.call(processEnv, key)) {
-			if (override === true) {
-				processEnv[key] = parsed[key];
-				populated[key] = parsed[key];
-			}
-			if (debug) {
-				if (override === true) _debug(`"${key}" is already defined and WAS overwritten`);
-				else _debug(`"${key}" is already defined and was NOT overwritten`);
-			}
-		} else {
-			processEnv[key] = parsed[key];
-			populated[key] = parsed[key];
-		}
-		return populated;
-	}
-	const DotenvModule = {
-		configDotenv,
-		_configVault,
-		_parseVault,
-		config,
-		decrypt,
-		parse,
-		populate
-	};
-	module.exports.configDotenv = DotenvModule.configDotenv;
-	module.exports._configVault = DotenvModule._configVault;
-	module.exports._parseVault = DotenvModule._parseVault;
-	module.exports.config = DotenvModule.config;
-	module.exports.decrypt = DotenvModule.decrypt;
-	module.exports.parse = DotenvModule.parse;
-	module.exports.populate = DotenvModule.populate;
-	module.exports = DotenvModule;
-})))(), 1);
 /**
 * The generated router config, as data: `propagate`-all plus a per-subgraph
-* `insert` of the canonical tenant header pair toward the extension subgraph
-* (not just `propagate` — AC 4/US-3). `authorization` is propagated at
+* `insert` of the canonical tenant header pair toward every local extension
+* subgraph (not just `propagate` — AC 4/US-3). `authorization` is propagated at
 * request time, with the `.env` `VTEX_TOKEN` as the propagation `default` so
 * inbound requests lacking one still reach core authenticated; an inbound
 * `authorization` always wins over the default.
@@ -34287,10 +34545,10 @@ var import_main = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((expor
 * `traffic_shaping.subgraphs.<core>.tls.insecure_skip_ca_verification: true` —
 * the escape hatch for pointing `STOREFRONT_CORE_URL` at an internal host whose
 * TLS cert doesn't match its name. Scoped to core only; the extension
-* subgraph is plain HTTP on localhost. This runner only runs on a
+* subgraphs are plain HTTP on localhost. This runner only runs on a
 * developer's machine, so the flag can never affect the deployed router.
 */
-function buildRouterConfig(env, extensionSubgraphName) {
+function buildRouterConfig(env, extensionSubgraphNames) {
 	const allRules = [
 		env.token ? {
 			op: "propagate",
@@ -34338,10 +34596,10 @@ function buildRouterConfig(env, extensionSubgraphName) {
 	const subgraphRules = [{
 		subgraphName: import_subgraph_names.CORE_SUBGRAPH_NAME,
 		rules: coreRules
-	}, {
-		subgraphName: extensionSubgraphName,
+	}, ...extensionSubgraphNames.map((subgraphName) => ({
+		subgraphName,
 		rules: tenantRules
-	}];
+	}))];
 	const subgraphTlsClients = env.insecureSkipTlsVerify ? [{
 		subgraphName: import_subgraph_names.CORE_SUBGRAPH_NAME,
 		insecureSkipCaVerification: true
@@ -34440,14 +34698,14 @@ const RENAMED_VARIABLES = {
 	FS_GRAPHQL_ROUTER_VERSION: "VTEX_STOREFRONT_ROUTER_VERSION",
 	FS_GRAPHQL_INSECURE_SKIP_TLS_VERIFY: "VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY"
 };
-const warnedRenames = /* @__PURE__ */ new Set();
-/** Warns once per process for each renamed variable that is still set, naming the name that is read instead. */
-function warnOnRenamedVariables(env) {
+/** One warning line per renamed variable that is still set, naming the name that is read instead. */
+function renamedVariableWarnings(env) {
+	const lines = [];
 	for (const [old, current] of Object.entries(RENAMED_VARIABLES)) {
-		if (env[old] === void 0 || warnedRenames.has(old)) continue;
-		warnedRenames.add(old);
-		console.warn(`storefront dev: ${old} is no longer read and was ignored — set ${current} instead.`);
+		if (env[old] === void 0) continue;
+		lines.push(`storefront dev: ${old} is no longer read and was ignored — set ${current} instead.`);
 	}
+	return lines;
 }
 function parsePort(value, fallback, name) {
 	if (!value) return fallback;
@@ -34461,13 +34719,12 @@ function parseBoolFlag(value) {
 	return normalized === "true" || normalized === "1";
 }
 /**
-* Reads the runner's env contract from `process.env` (populated by dotenv
-* before this runs). Throws when neither `VTEX_ACCOUNT` nor
-* `STOREFRONT_CORE_URL` is set — the runner cannot derive a core routing URL
-* without one of the two.
+* Reads the runner's env contract from the map the host passes — the runner
+* reads no `.env` and no `process.env` itself (ADR-0026). Throws when neither
+* `VTEX_ACCOUNT` nor `STOREFRONT_CORE_URL` is set — the runner cannot derive a
+* core routing URL without one of the two.
 */
-function loadRunnerEnv(env = process.env) {
-	warnOnRenamedVariables(env);
+function loadRunnerEnv(env) {
 	const account = env.VTEX_ACCOUNT?.trim() || void 0;
 	const coreUrl = env.STOREFRONT_CORE_URL?.trim() || void 0;
 	if (!account && !coreUrl) throw new Error("storefront dev: missing VTEX_ACCOUNT. Set it in .env (or set STOREFRONT_CORE_URL to override the derived core routing URL).");
@@ -34478,7 +34735,10 @@ function loadRunnerEnv(env = process.env) {
 		coreUrl,
 		subgraphPort: parsePort(env.VTEX_STOREFRONT_SUBGRAPH_PORT, DEFAULT_SUBGRAPH_PORT, "VTEX_STOREFRONT_SUBGRAPH_PORT"),
 		routerPort: parsePort(env.VTEX_STOREFRONT_ROUTER_PORT, DEFAULT_ROUTER_PORT, "VTEX_STOREFRONT_ROUTER_PORT"),
-		insecureSkipTlsVerify: parseBoolFlag(env.VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY)
+		insecureSkipTlsVerify: parseBoolFlag(env.VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY),
+		routerVersion: env.VTEX_STOREFRONT_ROUTER_VERSION?.trim() || "0.0.85",
+		routerBinary: env.VTEX_STOREFRONT_ROUTER_BINARY?.trim() || void 0,
+		variables: { ...env }
 	};
 }
 /** The deployed-core routing URL: the `STOREFRONT_CORE_URL` override, or account-derived. */
@@ -34489,18 +34749,20 @@ function resolveCoreUrl(env) {
 //#endregion
 //#region src/cli/secrets.ts
 /**
-* Declared-secret handling, shared by the two verbs that run resolvers: `dev`
-* and `serve`. Kept in its own dependency-free module because the scrub used to
-* live in `capability-lint.ts`, which imports the TypeScript compiler at module
-* load — reusing it from `serve` would have put `typescript` on the production
-* runtime path (see `docs/storefront-api-core/reference-extension-sdk.md`, "Running the artifact: serve").
+* Declared-secret handling for the two verbs that run resolvers. `dev` only
+* captures, from the environment the host passed; the scrub is `server.mjs`'s
+* alone, because the runner never touches `process.env` (ADR-0026). Kept in its
+* own dependency-free module because the scrub used to live in
+* `capability-lint.ts`, which imports the TypeScript compiler at module load —
+* reusing it from `serve` would have put `typescript` on the production runtime
+* path (see `docs/storefront-api-core/reference-extension-sdk.md`, "Running the artifact: serve").
 */
 /**
-* Captures the declared secrets' values from an environment snapshot. Reading
-* from a snapshot — not the live `process.env` — is what lets the caller scrub
-* `process.env` after boot without emptying `ctx.secrets` on a later watch
-* reload. A declared-but-unset name is simply absent from the returned map
-* (never `''`) — absent means absent (ADR-0003).
+* Captures the declared secrets' values from an environment snapshot. `dev`
+* passes its boot snapshot (`RunnerEnv.variables`) on boot and on every watch
+* reload, so `ctx.secrets` never empties mid-session; `serve` passes the map it
+* scrubs afterwards. A declared-but-unset name is simply absent from the
+* returned map (never `''`) — absent means absent (ADR-0003).
 */
 function captureSecrets(secretNames, source) {
 	const captured = {};
@@ -34511,215 +34773,175 @@ function captureSecrets(secretNames, source) {
 	return captured;
 }
 /**
-* Loud, non-blocking warning for any declared secret missing from the
+* One loud, non-blocking warning line per declared secret missing from the
 * environment. Lives here, not in `buildContext`, so the factory stays pure.
 * The server still starts; the secret is just absent from `ctx.secrets`.
 */
-function warnOnUnsetSecrets(secretNames, secrets, verb) {
-	for (const name of secretNames) if (secrets[name] === void 0) console.warn(`storefront ${verb}: ⚠ declared secret ${name} is unset in the environment. ctx.secrets.${name} will be undefined. Set it in the environment before shipping.`);
-}
-/**
-* Defense in depth: removes the declared secret names from the environment once
-* their values are captured, so no resolver can read them off `process.env` even
-* if the capability lint was bypassed.
-*/
-function scrubDeclaredSecrets(secretNames, env = process.env) {
-	for (const name of secretNames) delete env[name];
+function unsetSecretWarnings(secretNames, secrets, verb) {
+	const lines = [];
+	for (const name of secretNames) if (secrets[name] === void 0) lines.push(`storefront ${verb}: ⚠ declared secret ${name} is unset in the environment. ctx.secrets.${name} will be undefined. Set it in the environment before shipping.`);
+	return lines;
 }
 //#endregion
-//#region src/cli/dev.ts
+//#region src/cli/dev-session.ts
 /**
-* Loads the extension's gitignored `.env` on top of the current `process.env`,
-* `.env` winning on conflict. `override: true` applies that same precedence to
-* the live `process.env`, so the boot-time secret snapshot (and therefore
-* `ctx.secrets`) agrees with the runner config instead of silently keeping an
-* inherited shell value.
-*/
-function loadExtensionEnv(extensionRoot) {
-	const result = import_main.default.config({
-		path: join(extensionRoot, ".env"),
-		override: true
-	});
-	return loadRunnerEnv({
-		...process.env,
-		...result.parsed
-	});
-}
-/**
-* Loud, non-blocking capability-lint feedback at dev boot. Prints each finding
-* but never fails the loop — `dev` stays iterable mid-fix; the blocking gate is
-* `lintExtension` (and the future publish flow). See ADR-0002.
-*/
-async function warnOnCapabilityFindings(extensionRoot) {
-	const findings = await lintExtension(resolveDeclarationEntry(extensionRoot));
-	for (const finding of findings) console.warn(`storefront dev: ⚠ capability lint — ${formatFinding(finding)}. This will FAIL publish; fix before shipping.`);
-}
-/**
-* Loads the declaration, starts its subgraph server, composes the embedded core
-* SDL with the emitted extension slice, and writes the composed artifacts
-* (`supergraph.graphql` + `public.graphql`) at their fixed scratch paths.
-* Isolated as one step because watch mode re-runs exactly this on save —
-* restart the subgraph and recompose — while the router keeps running and
-* hot-swaps the rewritten supergraph. Rolls the subgraph back if compose fails,
-* so a failed boot or reload never orphans the port.
+* Loads the declaration, lints it, captures its secrets and starts its subgraph server. The
+* server starts after the load and the lint, so a throw here leaves nothing listening. The lint's
+* `TypeScriptUnavailableError` is the one caught error: the lint did not run (`capability` is
+* empty) and the subgraph still serves, the way `validateExtension` reports it.
 *
-* The server runtime (Apollo, Express) is imported here and nowhere earlier,
-* so `@vtex/faststore/cli` loads without it and only `dev` pays for it.
+* The declared secrets come from the map the caller passed, on boot and on every reload alike.
+* Nothing is scrubbed: the runner never touches `process.env`, and the capability lint's
+* `process-env` rule is the guard against a resolver that reads the developer's shell (ADR-0026).
 *
-* Composition is a function call, in process and offline: no CLI is fetched and
-* no config file is written for it. Every error is reported, so a broken schema
-* rewrites no artifact and the store keeps compiling against the last good
-* `public.graphql`.
+* The server runtime (Apollo, Express) is imported here and nowhere earlier, so
+* `@vtex/faststore/cli` loads without it and only `dev` pays for it.
 */
-async function startSubgraphAndCompose(extensionRoot, host, env, secretSource) {
-	const definition = await loadDeclaration(extensionRoot, host, "dev");
+async function startSubgraph(extensionRoot, { port, variables, log }) {
+	const definition = await loadDeclaration(extensionRoot, "dev");
 	const name = extensionName(extensionRoot, definition);
-	await warnOnCapabilityFindings(extensionRoot);
+	let capability = [];
+	let typescript;
+	try {
+		capability = await lintExtension(resolveDeclarationEntry(extensionRoot));
+	} catch (error) {
+		if (!(error instanceof TypeScriptUnavailableError)) throw error;
+		typescript = error;
+	}
 	const secretNames = definition.secrets ?? [];
-	const secrets = captureSecrets(secretNames, secretSource);
-	warnOnUnsetSecrets(secretNames, secrets, "dev");
-	scrubDeclaredSecrets(secretNames);
+	const secrets = captureSecrets(secretNames, variables);
+	for (const line of unsetSecretWarnings(secretNames, secrets, "dev")) log.warn(line);
+	const sdl = printSubgraphSdl(definition);
+	writeFileSync(join(scratchDir(extensionRoot), "extension.graphql"), sdl, "utf-8");
 	const { startSubgraphServer } = await import("./server-runtime.js");
-	const subgraph = await startSubgraphServer(definition, env.subgraphPort, {
+	const server = await startSubgraphServer(definition, port, {
 		secretNames,
 		secrets
+	}, (error) => {
+		log.error(`storefront dev: subgraph server error after startup: ${error.message}`);
 	});
-	try {
-		const scratch = scratchDir(extensionRoot);
-		const extensionSdl = printSubgraphSdl(definition);
-		writeFileSync(join(scratch, "extension.graphql"), extensionSdl, "utf-8");
-		const composed = (0, import_compose.composeSupergraph)([{
-			name: import_subgraph_names.CORE_SUBGRAPH_NAME,
-			url: resolveCoreUrl(env),
-			sdl: coreFederationSdl()
-		}, {
-			name,
-			url: subgraph.url,
-			sdl: extensionSdl
-		}]);
-		if (!composed.success) throw new Error(formatCompositionErrors("dev", composed.errors));
-		const { supergraphFile } = writeComposedArtifacts(extensionRoot, composed, "dev");
-		return {
-			subgraph,
-			name,
-			supergraphFile
-		};
-	} catch (error) {
-		await subgraph.stop();
-		throw error;
-	}
+	return {
+		root: extensionRoot,
+		name,
+		url: server.url,
+		sdl,
+		secretNames,
+		capability,
+		typescript,
+		stop: server.stop
+	};
 }
 /**
-* Orchestrates the full `runDev` loop: loads the declaration, starts
-* the subgraph server, composes it offline with the embedded core SDL, resolves
-* the pinned Hive Router binary, and launches the router against the composed
-* supergraph. Returns a handle so callers (the host, or tests) can await
-* readiness and tear the loop down. `env` defaults to the extension's `.env` +
-* `process.env`; tests inject one directly to skip file I/O.
+* Composes the embedded core SDL with every running subgraph and writes the composed artifacts
+* (`supergraph.graphql` + `public.graphql`) into the session root's scratch. Composition is a
+* function call, in process and offline. A failure throws with every error and writes nothing,
+* so the router keeps serving the last good supergraph. Zero subgraphs is a valid input: core
+* alone composes, so a session with no API Asset still gets a router to point the store at.
+*/
+function composeSession(sessionRoot, env, subgraphs, log) {
+	const composed = (0, import_compose.composeSupergraph)([{
+		name: import_subgraph_names.CORE_SUBGRAPH_NAME,
+		url: resolveCoreUrl(env),
+		sdl: coreFederationSdl()
+	}, ...subgraphs.map(({ name, url, sdl }) => ({
+		name,
+		url,
+		sdl
+	}))]);
+	if (!composed.success) throw new Error(formatCompositionErrors("dev", composed.errors));
+	return writeComposedArtifacts(sessionRoot, composed, "dev", log);
+}
+/** How many of the router's last stderr lines a boot failure quotes. */
+const ROUTER_STDERR_TAIL = 5;
+/** `variables` without `secretNames`: the environment the router child inherits. */
+function routerEnvironment(variables, secretNames) {
+	const withheld = new Set(secretNames);
+	return Object.fromEntries(Object.entries(variables).filter(([name]) => !withheld.has(name)));
+}
+/**
+* Resolves the pinned Hive Router binary into the session root's scratch, writes the router
+* config there with one header-rule entry per local subgraph, launches the router against the
+* composed supergraph and resolves once it answers at its URL, so a caller that reports `ready`
+* on return is telling the truth. A URL that already answers before the spawn (a router an
+* earlier session left behind), a router that exits first or one that stays silent past
+* `ROUTER_LISTEN_TIMEOUT_MS` is a throw, with nothing left running. `stop` SIGTERMs the child
+* and waits for it to exit.
 *
-* `watchSupergraphSeconds` writes the router config with a supergraph poll
-* interval, so a subsequently recomposed `supergraph.graphql` is hot-swapped in
-* place (watch mode uses this instead of restarting the router).
+* The router reads `ROUTER_CONFIG_FILE_PATH` and nothing else of its environment, which is the
+* host's map minus `withholdSecrets`: a resolver's secret has no business in the router's
+* process. `VTEX_TOKEN` is not a declared secret and goes to the router by design, in the config
+* as the `authorization` default. The environment is fixed at the spawn: a secret declared later
+* is withheld once the session restarts.
 */
-async function runDev(extensionRoot, host, env = loadExtensionEnv(extensionRoot), { registerSignals = true, watchSupergraphSeconds } = {}) {
-	requireEsbuild(host, "dev");
-	const secretSource = { ...process.env };
-	const { subgraph, name, supergraphFile } = await startSubgraphAndCompose(extensionRoot, host, env, secretSource);
-	let routerChild;
-	let routerConfig;
-	try {
-		const scratch = scratchDir(extensionRoot);
-		const binaryPath = await ensureRouterBinary(routerBinaryPath(extensionRoot));
-		if (env.insecureSkipTlsVerify) console.warn("storefront dev: ⚠ TLS certificate verification is DISABLED for the core subgraph (VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY). Local dev only — never rely on this in production.");
-		routerConfig = buildRouterConfig(env, name);
-		const routerConfigPath = join(scratch, "router.config.yaml");
-		const routerConfigYaml = printRouterConfigYaml({
-			...routerConfig,
-			supergraphPath: resolve(supergraphFile),
-			supergraphPollIntervalSeconds: watchSupergraphSeconds
+async function startRouter(sessionRoot, env, subgraphNames, supergraphFile, { log, watchSupergraphSeconds, onExit, withholdSecrets = [] }) {
+	const scratch = scratchDir(sessionRoot);
+	const binaryPath = await ensureRouterBinary(routerBinaryPath(sessionRoot, env.routerVersion), env.routerVersion, env.routerBinary);
+	if (env.insecureSkipTlsVerify) log.warn("storefront dev: ⚠ TLS certificate verification is DISABLED for the core subgraph (VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY). Local dev only — never rely on this in production.");
+	const routerConfig = buildRouterConfig(env, subgraphNames);
+	const routerUrl = `http://${routerConfig.host}:${routerConfig.port}/graphql`;
+	if (await routerAnswersAt(routerUrl)) throw new Error(`storefront dev: something already answers at ${routerUrl} — a router left behind by a session that died? Stop it, or set VTEX_STOREFRONT_ROUTER_PORT to a free port.`);
+	const routerConfigPath = join(scratch, "router.config.yaml");
+	const routerConfigYaml = printRouterConfigYaml({
+		...routerConfig,
+		supergraphPath: resolve(supergraphFile),
+		supergraphPollIntervalSeconds: watchSupergraphSeconds
+	});
+	writeFileSync(routerConfigPath, routerConfigYaml, "utf-8");
+	const recentStderr = [];
+	const tailingLog = {
+		...log,
+		error: (line) => {
+			recentStderr.push(line);
+			if (recentStderr.length > ROUTER_STDERR_TAIL) recentStderr.shift();
+			log.error(line);
+		}
+	};
+	const child = await spawnRouter(binaryPath, routerConfigPath, {
+		env: routerEnvironment(env.variables, withholdSecrets),
+		log: tailingLog
+	});
+	let phase = "booting";
+	child.once("exit", (code, signal) => {
+		if (phase === "up") onExit?.({
+			code,
+			signal
 		});
-		writeFileSync(routerConfigPath, routerConfigYaml, "utf-8");
-		routerChild = await spawnRouter(binaryPath, routerConfigPath);
+	});
+	try {
+		await waitForRouterListening(child, routerUrl, () => recentStderr);
 	} catch (error) {
-		await subgraph.stop();
+		await stopRouter(child);
 		throw error;
 	}
-	let currentSubgraph = subgraph;
-	let stopped = false;
-	let reloading = Promise.resolve();
-	const stop = async () => {
-		if (stopped) return;
-		stopped = true;
-		if (registerSignals) {
-			process.off("SIGINT", teardownOnSignal);
-			process.off("SIGTERM", teardownOnSignal);
-		}
-		await stopRouter(routerChild);
-		await reloading;
-		await currentSubgraph.stop();
-	};
-	function teardownOnSignal() {
-		stop().finally(() => process.exit(0));
-	}
-	if (registerSignals) {
-		process.on("SIGINT", teardownOnSignal);
-		process.on("SIGTERM", teardownOnSignal);
-	}
-	const NOOP_SUBGRAPH = {
-		url: "",
-		stop: () => Promise.resolve()
-	};
-	/**
-	* Watch-mode reload: restart the subgraph (new resolvers/schema) and
-	* recompose `supergraph.graphql` in place. The running router polls that file
-	* and hot-swaps — it is never restarted here.
-	*
-	* The old subgraph is stopped *before* the new one starts: both bind the
-	* same `subgraphPort`, so start-before-stop would `EADDRINUSE`. This leaves a
-	* brief window with no subgraph, which is fine — the router only re-reads the
-	* recomposed supergraph on its next poll anyway. On failure the old
-	* subgraph is already stopped, so teardown must not re-stop it.
-	*
-	* Reloads run one at a time: each waits for the one before it, so two calls
-	* never both stop the same subgraph and start one each.
-	*/
-	const reloadOnce = async () => {
-		if (stopped) return;
-		await currentSubgraph.stop();
-		currentSubgraph = NOOP_SUBGRAPH;
-		const next = await startSubgraphAndCompose(extensionRoot, host, env, secretSource);
-		if (stopped) {
-			await next.subgraph.stop();
-			return;
-		}
-		currentSubgraph = next.subgraph;
-	};
-	const reload = () => {
-		const run = reloading.then(reloadOnce);
-		reloading = run.catch(() => void 0);
-		return run;
-	};
+	phase = "up";
 	return {
-		routerUrl: `http://${routerConfig.host}:${routerConfig.port}/graphql`,
-		stop,
-		reload
+		routerUrl,
+		child,
+		stop: () => {
+			phase = "stopping";
+			return stopRouter(child);
+		}
 	};
 }
 /**
 * How long to wait for the router child to exit after SIGTERM before moving
 * on. On reload the router must fully release its listen port before the next
 * run re-binds it; awaiting exit avoids an `EADDRINUSE` race. Bounded so a
-* wedged child can't hang teardown forever.
+* wedged child can't hang teardown forever: one still up at the deadline is
+* SIGKILLed, so it never outlives the session holding the port.
 */
 const ROUTER_EXIT_TIMEOUT_MS = 5e3;
-/** SIGTERMs the router child and resolves once it exits (or the timeout elapses). */
+/** SIGTERMs the router child and resolves once it exits (or the timeout elapses, after a SIGKILL). */
 function stopRouter(routerChild) {
 	if ((routerChild.exitCode ?? null) !== null || (routerChild.signalCode ?? null) !== null) {
 		routerChild.kill("SIGTERM");
 		return Promise.resolve();
 	}
 	return new Promise((resolve) => {
-		const timer = setTimeout(resolve, ROUTER_EXIT_TIMEOUT_MS);
+		const timer = setTimeout(() => {
+			routerChild.kill("SIGKILL");
+			resolve();
+		}, ROUTER_EXIT_TIMEOUT_MS);
 		timer.unref?.();
 		routerChild.once("exit", () => {
 			clearTimeout(timer);
@@ -34728,10 +34950,6 @@ function stopRouter(routerChild) {
 		routerChild.kill("SIGTERM");
 	});
 }
-/** Coalesces bursts of file events (an editor save can fire several) into one reload. */
-const RELOAD_DEBOUNCE_MS = 150;
-/** How often the router polls its supergraph file for changes, in watch mode. */
-const ROUTER_WATCH_INTERVAL_SECONDS = 1;
 /**
 * Directories whose contents never mean "the developer edited the extension".
 * `.vtex/` matters most: `dev` writes the composed supergraph, the router
@@ -34759,6 +34977,121 @@ function isIgnoredWatchPath(filename) {
 	if (!filename) return false;
 	return filename.split(/[\\/]/).some((segment) => IGNORED_WATCH_DIRS.has(segment));
 }
+//#endregion
+//#region src/cli/dev.ts
+/**
+* Starts the extension's subgraph and composes it with the embedded core SDL
+* into the extension's own scratch: the single-member session, where the
+* session root is the extension root. Isolated as one step because watch mode
+* re-runs exactly this on save, while the router keeps running and hot-swaps
+* the rewritten supergraph. Rolls the subgraph back if compose fails, so a
+* failed boot or reload never orphans the port, and a broken schema rewrites
+* no artifact: the store keeps compiling against the last good `public.graphql`.
+*
+* Loud, non-blocking capability-lint feedback: each finding is a warning, never
+* a failure — `dev` stays iterable mid-fix; the blocking gate is `validate` (and
+* the future publish flow). See ADR-0002. A host without TypeScript 5 gets one
+* warning that the lint did not run, and the loop runs.
+*/
+async function startSubgraphAndCompose(extensionRoot, env, log) {
+	const subgraph = await startSubgraph(extensionRoot, {
+		port: env.subgraphPort,
+		variables: env.variables,
+		log
+	});
+	if (subgraph.typescript) log.warn(subgraph.typescript.message);
+	for (const finding of subgraph.capability) log.warn(`storefront dev: ⚠ capability lint — ${formatFinding(finding)}. This will FAIL publish; fix before shipping.`);
+	try {
+		const { supergraphFile } = composeSession(extensionRoot, env, [subgraph], log);
+		return {
+			subgraph,
+			supergraphFile
+		};
+	} catch (error) {
+		await subgraph.stop();
+		throw error;
+	}
+}
+/**
+* Orchestrates the full `runDev` loop: loads the declaration, starts
+* the subgraph server, composes it offline with the embedded core SDL, resolves
+* the pinned Hive Router binary, and launches the router against the composed
+* supergraph. Returns a handle so callers (the host, or tests) can await
+* readiness and tear the loop down. The host passes `env` (`loadRunnerEnv` over
+* the map it assembled) and owns signals and exit: `stop()` is the only
+* teardown (ADR-0026).
+*
+* `watchSupergraphSeconds` writes the router config with a supergraph poll
+* interval, so a subsequently recomposed `supergraph.graphql` is hot-swapped in
+* place (watch mode uses this instead of restarting the router).
+*/
+async function runDev(extensionRoot, env, { log = SILENT_LOG, watchSupergraphSeconds } = {}) {
+	for (const line of renamedVariableWarnings(env.variables)) log.warn(line);
+	const { subgraph, supergraphFile } = await startSubgraphAndCompose(extensionRoot, env, log);
+	let router;
+	try {
+		router = await startRouter(extensionRoot, env, [subgraph.name], supergraphFile, {
+			log,
+			watchSupergraphSeconds,
+			withholdSecrets: subgraph.secretNames,
+			onExit: (exit) => {
+				log.error(`storefront dev: the Hive Router exited ${describeRouterExit(exit)}; the loop is down — stop it and start it again.`);
+			}
+		});
+	} catch (error) {
+		await subgraph.stop();
+		throw error;
+	}
+	let currentSubgraph = subgraph;
+	let stopped = false;
+	let reloading = Promise.resolve();
+	let stopping;
+	const stop = () => {
+		stopping ??= (async () => {
+			stopped = true;
+			await router.stop();
+			await reloading;
+			await currentSubgraph.stop();
+		})();
+		return stopping;
+	};
+	const NOOP_SUBGRAPH = { stop: () => Promise.resolve() };
+	/**
+	* Watch-mode reload: restart the subgraph (new resolvers/schema) and
+	* recompose `supergraph.graphql` in place. The running router polls that file
+	* and hot-swaps — it is never restarted here.
+	*
+	* The old subgraph is stopped *before* the new one starts: both bind the
+	* same `subgraphPort`, so start-before-stop would `EADDRINUSE`. This leaves a
+	* brief window with no subgraph, which is fine — the router only re-reads the
+	* recomposed supergraph on its next poll anyway. On failure the old
+	* subgraph is already stopped, so teardown must not re-stop it.
+	*
+	* Reloads run one at a time: each waits for the one before it, so two calls
+	* never both stop the same subgraph and start one each.
+	*/
+	const reloadOnce = async () => {
+		if (stopped) return;
+		await currentSubgraph.stop();
+		currentSubgraph = NOOP_SUBGRAPH;
+		const next = await startSubgraphAndCompose(extensionRoot, env, log);
+		if (stopped) {
+			await next.subgraph.stop();
+			return;
+		}
+		currentSubgraph = next.subgraph;
+	};
+	const reload = () => {
+		const run = reloading.then(reloadOnce);
+		reloading = run.catch(() => void 0);
+		return run;
+	};
+	return {
+		routerUrl: router.routerUrl,
+		stop,
+		reload
+	};
+}
 /**
 * Runs the dev loop under a file watcher rooted at the declaration entry's
 * directory. On save it restarts the subgraph (new resolvers/schema) and
@@ -34771,13 +35104,12 @@ function isIgnoredWatchPath(filename) {
 * change callback — otherwise the run's own writes into `.vtex/storefront/`
 * would feed the loop back into itself.
 *
-* Owns a single SIGINT/SIGTERM handler set across reloads (`runDev` is started
-* with `registerSignals: false`).
+* Like `runDev`, it installs no signal handler: the host calls `stop()`.
 */
-async function runDevWatch(extensionRoot, host, env = loadExtensionEnv(extensionRoot)) {
-	const current = await runDev(extensionRoot, host, env, {
-		registerSignals: false,
-		watchSupergraphSeconds: ROUTER_WATCH_INTERVAL_SECONDS
+async function runDevWatch(extensionRoot, env, { log = SILENT_LOG } = {}) {
+	const current = await runDev(extensionRoot, env, {
+		log,
+		watchSupergraphSeconds: 1
 	});
 	const watchDir = resolveWatchRoot(extensionRoot);
 	let watcher;
@@ -34795,9 +35127,9 @@ async function runDevWatch(extensionRoot, host, env = loadExtensionEnv(extension
 			pending = false;
 			try {
 				await current.reload();
-				console.log("storefront dev: reloaded — router hot-swapped the recomposed schema in place.");
+				log.info("storefront dev: reloaded — router hot-swapped the recomposed schema in place.");
 			} catch (error) {
-				console.error(`storefront dev: reload failed:\n${error instanceof Error ? error.message : String(error)}`);
+				log.error(`storefront dev: reload failed:\n${error instanceof Error ? error.message : String(error)}`);
 			}
 		} while (pending && !stopped);
 		reloading = false;
@@ -34806,54 +35138,1018 @@ async function runDevWatch(extensionRoot, host, env = loadExtensionEnv(extension
 		if (stopped) return;
 		if (isIgnoredWatchPath(typeof filename === "string" ? filename : filename?.toString() ?? null)) return;
 		if (reloadTimer) clearTimeout(reloadTimer);
-		reloadTimer = setTimeout(reload, RELOAD_DEBOUNCE_MS);
+		reloadTimer = setTimeout(reload, 150);
 	};
-	if (existsSync(watchDir)) watcher = watch(watchDir, { recursive: true }, scheduleReload);
-	else console.warn(`storefront dev: ${watchDir} not found; watch mode is idle (no files to watch).`);
-	const stop = async () => {
-		if (stopped) return;
-		stopped = true;
-		if (reloadTimer) clearTimeout(reloadTimer);
-		watcher?.close();
-		process.off("SIGINT", teardownOnSignal);
-		process.off("SIGTERM", teardownOnSignal);
-		await current.stop();
+	if (existsSync(watchDir)) {
+		try {
+			watcher = watch(watchDir, { recursive: true }, scheduleReload);
+		} catch (error) {
+			await current.stop();
+			throw error;
+		}
+		watcher.on("error", (error) => {
+			log.error(`storefront dev: watcher error on ${watchDir}: ${error.message}`);
+		});
+	} else log.warn(`storefront dev: ${watchDir} not found; watch mode is idle (no files to watch).`);
+	let stopping;
+	const stop = () => {
+		stopping ??= (async () => {
+			stopped = true;
+			if (reloadTimer) clearTimeout(reloadTimer);
+			watcher?.close();
+			await current.stop();
+		})();
+		return stopping;
 	};
-	function teardownOnSignal() {
-		stop().finally(() => process.exit(0));
-	}
-	process.on("SIGINT", teardownOnSignal);
-	process.on("SIGTERM", teardownOnSignal);
 	return {
 		routerUrl: current.routerUrl,
 		stop
 	};
 }
 //#endregion
-//#region src/cli/templates.ts
-/** The registry semver range the scaffold pins `@vtex/faststore` to (future-correct shape, not `workspace:*`). */
-const SDK_VERSION_RANGE = "^0.0.0";
+//#region src/cli/provider-findings.ts
 /**
-* Renders the scaffold's `package.json`: a registry-pinned SDK dep, TS + vitest devDeps, and the
-* `files` allowlist that keeps the deploy payload to `dist/`. No scripts: the lifecycle verbs belong
-* to `vtex extensions`, not to each extension's manifest (ADR-00020).
+* The Finding builders `validate`, `dev` and `build` share: one code per fault, whichever verb
+* finds it, so a reload reports the same Finding the lint would. Each Finding points at the source
+* file it is about, relative to the Account Repo root, so `vtex extension` renders it as
+* `file:line:column`.
 */
-function packageJsonTemplate(name) {
-	return `${JSON.stringify({
-		name,
-		version: "0.0.0",
-		private: true,
-		description: "A Storefront API extension: adds fields to the graph via defineSubgraph.",
-		files: ["dist"],
-		scripts: { test: "vitest run" },
-		dependencies: { "@vtex/faststore": SDK_VERSION_RANGE },
-		devDependencies: {
-			graphql: "^16.13.1",
-			typescript: "^5.9.3",
-			vitest: "^4.1.0"
+/** The reference doc on `main`, one section per Finding family. */
+const REFERENCE_DOC = "https://github.com/vtex/faststore-ai-native/blob/main/docs/storefront-api-core/reference-extension-sdk.md";
+const CAPABILITY_DOCS = `${REFERENCE_DOC}#capability-boundary`;
+const CONTRACT_DOCS = `${REFERENCE_DOC}#the-core-contract`;
+const LIFECYCLE_DOCS = `${REFERENCE_DOC}#the-lifecycle-functions`;
+/** The UI side's docs on `main`: why the export is the UI signal, and what the catalog build rejects. */
+const COMPILER_DOCS = "https://github.com/vtex/faststore-ai-native/blob/main/docs/storefront-compiler";
+const CATALOG_EXPORT_DOCS = `${COMPILER_DOCS}/adr-0007-classify-a-ui-extension-by-its-catalog-export.md`;
+const CATALOG_BUILD_DOCS = `${COMPILER_DOCS}/reference-catalog-build.md#failure-discipline`;
+/** What to reach for instead, per capability rule (`reference-extension-sdk.md › Capability boundary`). */
+const CAPABILITY_ADVICE = {
+	"process-env": "read secrets through `ctx.secrets`",
+	"fs-import": "a resolver has no filesystem",
+	"child-process-import": "a resolver spawns no child process"
+};
+/**
+* `absolute` relative to the Account Repo root with `/` separators, as a Finding's `file`, or
+* `undefined` when it lies outside the root: the core rejects `..` (`isRepoFile`).
+*/
+function repoFile(root, absolute) {
+	const file = relative(root, absolute).split(sep).join("/");
+	return file === ".." || file.startsWith("../") ? void 0 : file;
+}
+/**
+* `message` with every path under the repo root made relative to it. The addon's and the runner's
+* errors name files as the machine spells them (`NoExtensionComponents { components_dir }`, a
+* TypeScript diagnostic), and a Finding's message reaches `--json` and the pipeline.
+*/
+function repoRelativeMessage(root, message) {
+	const prefix = root.endsWith(sep) ? root : `${root}${sep}`;
+	return message.split(prefix).join("");
+}
+/**
+* One `storefront-capability-<rule>` Finding on the source line the lint flagged. A file outside
+* the repo root cannot be the Finding's `file`, so it lands on the declaration entry and the
+* message names the file relative to the root (`../shared/x.ts:3:5`), never as the machine spells
+* it: the message reaches `--json` and the pipeline.
+*/
+function capabilityFinding(root, entryFile, { file, rule, line, column }) {
+	const inRepo = repoFile(root, file);
+	const where = inRepo === void 0 ? ` at ${relative(root, file).split(sep).join("/")}:${line}:${column}` : "";
+	return {
+		code: `storefront-capability-${rule}`,
+		severity: "error",
+		message: `forbidden ${rule}${where}: ${CAPABILITY_ADVICE[rule]}`,
+		path: "",
+		file: inRepo ?? entryFile,
+		range: {
+			start: {
+				line,
+				column
+			},
+			end: {
+				line,
+				column
+			}
+		},
+		docs: CAPABILITY_DOCS
+	};
+}
+/** The capability lint did not run: the Asset's `typescript` has no TypeScript 5 API. On its `package.json`. */
+function typescriptUnsupported(file, error) {
+	return {
+		code: "storefront-typescript-unsupported",
+		severity: "error",
+		message: `${error.message} Add \`typescript@^5.9.3\` to the Asset's devDependencies; the capability lint did not run.`,
+		path: "",
+		file,
+		docs: LIFECYCLE_DOCS
+	};
+}
+/** The declaration did not load or build. On the declaration entry. */
+function declarationInvalid(file, message) {
+	return {
+		code: "storefront-declaration-invalid",
+		severity: "error",
+		path: "",
+		file,
+		message,
+		docs: CONTRACT_DOCS
+	};
+}
+/** One composition error of the emitted slice against the core SDL. On the declaration entry. */
+function compositionFailed(file, message) {
+	return {
+		code: "storefront-composition-failed",
+		severity: "error",
+		path: "",
+		file,
+		message,
+		docs: CONTRACT_DOCS
+	};
+}
+/**
+* A UI side without `exports["./catalog.json"]`: Sukima sees a UI Extension through that export
+* alone (ADR-0007), so no store sees the components, and nothing else reports that. On the Asset's
+* `package.json`.
+*/
+function catalogExportMissing(file) {
+	return {
+		code: "storefront-catalog-export-missing",
+		severity: "error",
+		path: "",
+		file,
+		message: "the package has a UI side (`src/components/`) but its `package.json` has no `exports[\"./catalog.json\"]`, so no store sees its components — add `\"./catalog.json\": \"./dist/catalog.json\"`",
+		docs: CATALOG_EXPORT_DOCS
+	};
+}
+/**
+* A `./catalog.json` export that names no file inside the Asset: `reason` is `catalogExport`'s.
+* `dev` and `build` write where the export points, so the catalog goes to `dist/` meanwhile, where
+* no store reads it. On the Asset's `package.json`.
+*/
+function catalogExportInvalid(file, reason) {
+	return {
+		code: "storefront-catalog-export-invalid",
+		severity: "error",
+		path: "",
+		file,
+		message: `\`exports["./catalog.json"]\` ${reason}; the catalog is built into \`dist/\` meanwhile, where no store reads it — point the export at a file inside the Asset, \`"./dist/catalog.json"\``,
+		docs: CATALOG_EXPORT_DOCS
+	};
+}
+/** The UI side's export Findings, from what `catalogExport` read: one when the export is absent or unusable. */
+function catalogExportFindings(exported, manifestFile) {
+	if (exported.kind === "none") return [catalogExportMissing(manifestFile)];
+	if (exported.kind === "invalid") return [catalogExportInvalid(manifestFile, exported.reason)];
+	return [];
+}
+/** The catalog build threw; `message` is the addon's error, its paths made repo-relative. On the Asset's `package.json`. */
+function catalogInvalid(file, message) {
+	return {
+		code: "storefront-catalog-invalid",
+		severity: "error",
+		path: "",
+		file,
+		message,
+		docs: CATALOG_BUILD_DOCS
+	};
+}
+/**
+* The build step after `validate` passed failed: a `tsconfig.json` problem, a TypeScript
+* diagnostic, the server bundle, a component-doc basename collision, the catalog. `message` is
+* the runner's error, its paths made repo-relative. On the Asset's `package.json`.
+*/
+function buildFailed(file, message) {
+	return {
+		code: "storefront-build-failed",
+		severity: "error",
+		path: "",
+		file,
+		message,
+		docs: LIFECYCLE_DOCS
+	};
+}
+//#endregion
+//#region src/cli/provider-log.ts
+/**
+* What `dev` and `build` share to report through the contract: the runner's three log levels
+* into `ctx.log`, and the message of whatever the runner threw. Nothing here prints.
+*/
+/** The runner's three levels into the contract's one function, for the session-wide lines. */
+function contextLog(ctx) {
+	const line = (message) => ctx.log(message);
+	return {
+		info: line,
+		warn: line,
+		error: line
+	};
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+//#region src/cli/provider-kind-rules.ts
+/**
+* The two kind rules RFC-0003 §The storefront kind leaves to this provider: a Platform Extension
+* has one storefront Asset, and a store depends only on storefront Assets whose extension its
+* account installs. Pure over the Asset, `ctx.repo` and `ctx.account`: no filesystem, no runner.
+* The core's `installed:` and `store:` parsers are copied here because the core is not a
+* dependency (`src/core/repo.ts` at `e11c964`).
+*/
+const KIND_DOCS = "https://github.com/vtex/extensions-platform/blob/main/docs/rfc/0003-extensions-cli.md#the-storefront-kind";
+/** One `installed:` entry, `vendor.name@RANGE` (`installedPattern`). A range may hold spaces. */
+const INSTALLED_PATTERN = /^([^.@\s]+)\.([^@\s]+)@(.+)$/;
+/** `stores/<store>` or `stores/<store>/` → `<store>` (`storeNameOf`). */
+function storeNameOf(value) {
+	return value === void 0 ? void 0 : /^stores\/([^/.][^/]*)\/?$/.exec(value)?.[1];
+}
+/** True when `installed` lists the extension, whatever the range. An extension without `vendor` is never installed. */
+function installs(installed, extension) {
+	if (extension.vendor === void 0) return false;
+	return installed.some((entry) => {
+		const match = INSTALLED_PATTERN.exec(entry);
+		return match !== null && match[1] === extension.vendor && match[2] === extension.name;
+	});
+}
+/**
+* `storefront-one-per-extension`, the stand-in's rule verbatim: the extension's first inventory
+* Asset of kind `storefront` is its storefront, and any other one is reported on its own `kind`.
+* A staged Asset is not in the inventory, so it never counts as the first.
+*/
+function onePerExtension(asset, ctx) {
+	const first = ctx.repo.extensions.find(({ path }) => path === asset.extension.path)?.assets.find(({ kind }) => kind === "storefront");
+	if (first === void 0 || first.path === asset.path) return [];
+	return [{
+		code: "storefront-one-per-extension",
+		severity: "error",
+		message: `extension "${asset.extension.name}" has a second storefront Asset "${asset.name}": "${first.name}" (${asset.extension.path}/${first.path}) is its storefront, and an extension has one`,
+		path: "/kind",
+		file: asset.file,
+		docs: KIND_DOCS
+	}];
+}
+/**
+* `storefront-store-extension-not-installed`, one per store that depends on the Asset's package
+* while an account that names the store (`ctx.account` alone, when given) does not install the
+* extension. A store no account names is the core's concern. Presence only: the CLI has no range
+* parser yet (RFC-0003 §Installed ranges).
+*/
+function storeExtensionInstalled(asset, ctx) {
+	const packageName = asset.packageJson?.name;
+	if (typeof packageName !== "string") return [];
+	const { vendor, name } = asset.extension;
+	const findings = [];
+	for (const store of ctx.repo.stores) {
+		if (!store.dependencies.includes(packageName)) continue;
+		const missing = ctx.repo.accounts.filter((account) => storeNameOf(account.store) === store.name).filter((account) => ctx.account === void 0 || account.name === ctx.account).filter((account) => !installs(account.installed, asset.extension));
+		if (missing.length === 0) continue;
+		const accounts = missing.map((account) => `"${account.name ?? "(unnamed)"}"`).join(", ");
+		findings.push({
+			code: "storefront-store-extension-not-installed",
+			severity: "error",
+			message: `store "${store.name}" depends on \`${packageName}\`, the storefront Asset of extension "${name}", which account${missing.length === 1 ? "" : "s"} ${accounts} ${missing.length === 1 ? "does" : "do"} not install — add \`${vendor ?? "<vendor>"}.${name}@<range>\` to their \`installed:\` or drop the dependency`,
+			path: "",
+			file: `${store.path}/package.json`,
+			docs: KIND_DOCS
+		});
+	}
+	return findings;
+}
+/** The kind rules' Findings for one Asset: one-per-extension, then the store rule. */
+function kindRuleFindings(asset, ctx) {
+	return [...onePerExtension(asset, ctx), ...storeExtensionInstalled(asset, ctx)];
+}
+//#endregion
+//#region src/cli/provider-validate.ts
+/**
+* The provider's `validate`: for each storefront Asset, the two kind rules, then the runner's
+* `validateExtension` report for its API Extension, then its UI Extension's catalog build, all as
+* contract Findings (ADR-0026). Each Finding points at the source file it is about, relative to the
+* Account Repo root, so `vtex extension` renders it as `file:line:column`. Nothing here logs: a
+* Finding is the only output. Nothing catches around the runner either, except the catalog build
+* itself (its loader stays outside the `try`): any other throw is `provider-failed` on every
+* Asset, and a catch would hide a runner bug. The Finding builders live in `provider-findings.ts`,
+* shared with `dev`. The side predicates live in `asset-layout.ts`, shared with `dev` and `build`.
+*/
+/**
+* The API side of one Asset: the TypeScript Finding, the capability ones, the declaration one,
+* the composition ones. Nothing for an Asset without an API Extension.
+*/
+async function apiFindings(asset, ctx) {
+	const entry = apiDeclarationEntry(asset);
+	if (entry === void 0) return [];
+	const entryFile = repoFile(ctx.root, entry) ?? asset.file;
+	if (!existsSync(entry)) return [declarationInvalid(entryFile, `storefront validate: declaration entry not found at ${entryFile}.`)];
+	const report = await validateExtension(asset.dir);
+	const manifestFile = repoFile(ctx.root, join(asset.dir, "package.json")) ?? asset.file;
+	return [
+		...report.typescript ? [typescriptUnsupported(manifestFile, report.typescript)] : [],
+		...report.capability.map((finding) => capabilityFinding(ctx.root, entryFile, finding)),
+		...report.buildError ? [declarationInvalid(entryFile, report.buildError.message)] : [],
+		...report.composition.map((error) => compositionFailed(entryFile, error.message))
+	];
+}
+/**
+* The UI side of one Asset: the export Finding (absent, or naming no file inside the Asset), then
+* the catalog build into the Asset's scratch folder, never `dist/`. The build runs even without a
+* usable export, so a component error and the export error arrive together. Nothing for an Asset
+* without a UI Extension.
+*/
+async function uiFindings(asset, ctx) {
+	if (!uiSide(asset)) return [];
+	const manifestFile = repoFile(ctx.root, join(asset.dir, "package.json")) ?? asset.file;
+	const findings = catalogExportFindings(catalogExport(asset), manifestFile);
+	await loadCatalogBuilder("validate");
+	try {
+		await buildAssetCatalog(asset.dir, catalogDir(asset.dir), "validate");
+		return findings;
+	} catch (error) {
+		return [...findings, catalogInvalid(manifestFile, repoRelativeMessage(ctx.root, errorMessage(error)))];
+	}
+}
+/**
+* Validates each Asset in turn and returns their Findings in Asset order: per Asset, the kind
+* rules, then the API side, then the UI side. Sequential on purpose: two Assets'
+* `.vtex/storefront/` writes never interleave.
+*/
+async function validateAssets(assets, ctx) {
+	const findings = [];
+	for (const asset of assets) findings.push(...kindRuleFindings(asset, ctx), ...await apiFindings(asset, ctx), ...await uiFindings(asset, ctx));
+	return findings;
+}
+//#endregion
+//#region src/cli/provider-build.ts
+/**
+* The provider's `build`: `buildExtension` per storefront Asset, in call order, into the staging
+* folder the core hands as `outDir` (ADR-0026). The core's own `validate` pass blocks an Asset on
+* its manifests alone, so each Asset is validated here first: one with a Finding is not built,
+* and that Finding is its result. A runner throw after that is one `storefront-build-failed` on
+* the Asset's `package.json`, and the next Asset still builds. The composed-artifact lines reach
+* `ctx.log`; nothing here prints, and nothing reads `asset.env` or `ctx.env`: the build needs no
+* variable. Sequential on purpose, as `validate`: two Assets' `.vtex/storefront/` writes never
+* interleave.
+*/
+/** Builds each Asset in turn and returns their Findings in Asset order. */
+async function buildAssets(assets, ctx) {
+	const findings = [];
+	const log = contextLog(ctx);
+	for (const asset of assets) {
+		const found = await validateAssets([asset], ctx);
+		if (found.length > 0) {
+			findings.push(...found);
+			continue;
 		}
-	}, null, 2)}\n`;
+		const manifestFile = repoFile(ctx.root, join(asset.dir, "package.json")) ?? asset.file;
+		try {
+			const result = await buildExtension(asset.dir, {
+				outDir: asset.outDir,
+				log
+			});
+			const parts = [result.api && "server.mjs + extension.graphql", result.ui && "catalog.json + docs/"];
+			ctx.log(`built ${asset.target}: ${parts.filter(Boolean).join(", ")}`);
+		} catch (error) {
+			findings.push(buildFailed(manifestFile, repoRelativeMessage(ctx.root, errorMessage(error))));
+		}
+	}
+	return findings;
+}
+//#endregion
+//#region src/cli/session-lock.ts
+/** The lock file inside a session root's scratch: the pid of the `dev` that owns the folder. */
+const SESSION_LOCK_FILE = "dev.lock";
+/** How many times a lock file that is there but says nothing is read again, and how far apart, before it counts as stale. */
+const UNREADABLE_RETRIES = 3;
+const UNREADABLE_RETRY_MS = 10;
+/** How many times the whole take is attempted when the file keeps changing under it. */
+const ATTEMPTS = 5;
+/** Thrown when a live process already owns the session root's scratch. */
+var SessionLockedError = class extends Error {
+	ownerPid;
+	constructor(scratch, ownerPid) {
+		const who = ownerPid === pid ? `a second \`dev\` in this process (pid ${pid}), which still holds it: the first one was not stopped, or two SDK versions are among the selected Assets` : `another dev session (pid ${ownerPid})`;
+		super(`storefront dev: ${scratch} is in use by ${who}. Stop it first: two sessions over one root would overwrite each other's supergraph and fight for the router port (${join(scratch, SESSION_LOCK_FILE)}).`);
+		this.name = "SessionLockedError";
+		this.ownerPid = ownerPid;
+	}
+};
+function errorCode(error) {
+	return error instanceof Error && "code" in error ? String(error.code) : void 0;
+}
+/** True when a process with `candidate` is alive: signal 0 reaches it, or is refused (`EPERM`), which is alive too. */
+function alive(candidate) {
+	try {
+		kill(candidate, 0);
+		return true;
+	} catch (error) {
+		return errorCode(error) === "EPERM";
+	}
+}
+/**
+* What a lock file says: the pid it holds, nothing usable (`null`, empty or malformed), or no file
+* at all (`undefined`). A read that fails for any reason but a missing file propagates when
+* `strict`: a lock this process cannot read is not one it may reclaim. The release reads
+* non-strict, so cleanup never throws.
+*/
+function ownerOf(lockPath, strict = true) {
+	let contents;
+	try {
+		contents = readFileSync(lockPath, "utf-8");
+	} catch (error) {
+		if (errorCode(error) === "ENOENT") return void 0;
+		if (strict) throw error;
+		return null;
+	}
+	const owner = Number(contents.trim());
+	return Number.isInteger(owner) && owner > 0 ? owner : null;
+}
+/** A synchronous pause: the take is synchronous, and the wait is a few milliseconds at most. */
+function pause(ms) {
+	Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/**
+* Publishes this pid at `lockPath` in one step: written to a sibling draft, then linked into
+* place, so the file is complete the moment it exists and a reader never sees it empty. True when
+* the link took; false when a lock already exists.
+*/
+function publish(lockPath) {
+	const draft = `${lockPath}.${pid}.draft`;
+	const fd = openSync(draft, "w");
+	try {
+		writeSync(fd, `${pid}\n`);
+	} finally {
+		closeSync(fd);
+	}
+	try {
+		linkSync(draft, lockPath);
+		return true;
+	} catch (error) {
+		if (errorCode(error) === "EEXIST") return false;
+		throw error;
+	} finally {
+		rmSync(draft, { force: true });
+	}
+}
+/**
+* The lock's owner, giving a file that is there but says nothing a few more reads: `publish` writes
+* the whole file before it appears, so an empty or malformed one is a leftover of some other
+* writer, and after the retries it counts as stale (`null`). `undefined` when the file is gone. A
+* file that cannot be read at all propagates.
+*/
+function settledOwner(lockPath) {
+	for (let read = 0; read <= UNREADABLE_RETRIES; read += 1) {
+		const owner = ownerOf(lockPath);
+		if (owner !== null) return owner;
+		pause(UNREADABLE_RETRY_MS);
+	}
+	return null;
+}
+/**
+* Claims the stale lock whose content was `expected` (a dead pid, or `null` for an unreadable
+* file): renames it to a sibling only this process names, which one claimant at most can win, and
+* removes the sibling when it still holds what was read. When it holds another pid, a live session
+* published between the read and the rename: the file goes back where it was, and the take starts
+* over. True when the stale lock is gone.
+*/
+function claimStale(lockPath, expected) {
+	const claimed = `${lockPath}.${pid}.stale`;
+	try {
+		renameSync(lockPath, claimed);
+	} catch (error) {
+		if (errorCode(error) === "ENOENT") return true;
+		throw error;
+	}
+	let found;
+	try {
+		found = ownerOf(claimed);
+	} catch (error) {
+		putBack(claimed, lockPath);
+		throw error;
+	}
+	if (found === expected) {
+		rmSync(claimed, { force: true });
+		return true;
+	}
+	putBack(claimed, lockPath);
+	return false;
+}
+/** Returns a claimed lock to `lockPath`, unless a lock was published there meanwhile, and drops the claim. */
+function putBack(claimed, lockPath) {
+	try {
+		linkSync(claimed, lockPath);
+	} catch (error) {
+		if (errorCode(error) !== "EEXIST") throw error;
+	} finally {
+		rmSync(claimed, { force: true });
+	}
+}
+/**
+* Takes the session lock in `scratch`, the session root's `.vtex/storefront/`: a file holding this
+* process's pid. One `dev` composes there and runs the router on the configured port at a time: a
+* second session, in another process or a second provider instance in this one, would rewrite
+* `supergraph.graphql` with its Assets alone, which the first session's router polls and swaps in,
+* while its own router fails to bind. A live owner is a `SessionLockedError`; a dead owner's lock
+* is stale (a crashed session) and is taken over. Returns the release, which removes the file while
+* it still holds this pid.
+*
+* The file is the whole guarantee, so the take leaves no window: the pid is published complete or
+* not at all, a file that says nothing is read again before it counts as stale, and a stale file
+* is claimed by a rename only one claimant wins and verified before it is removed.
+*/
+function acquireSessionLock(scratch) {
+	const lockPath = join(scratch, SESSION_LOCK_FILE);
+	for (let attempt = 0; attempt < ATTEMPTS; attempt += 1) {
+		if (publish(lockPath)) return () => {
+			if (ownerOf(lockPath, false) === pid) rmSync(lockPath, { force: true });
+		};
+		const owner = settledOwner(lockPath);
+		if (owner === void 0) continue;
+		if (owner !== null && alive(owner)) throw new SessionLockedError(scratch, owner);
+		claimStale(lockPath, owner);
+	}
+	throw new Error(`storefront dev: could not take the session lock at ${lockPath}: it kept changing hands.`);
+}
+//#endregion
+//#region src/cli/provider-dev.ts
+/** The runner's three levels into the session's `log`, for one Asset's lines. */
+function assetLog(session, target) {
+	const line = (message) => session.log(target, message);
+	return {
+		info: line,
+		warn: line,
+		error: line
+	};
+}
+function createState(session, ctx, env) {
+	const state = {
+		ctx,
+		env,
+		log: contextLog(ctx),
+		report: {
+			log: (target, message) => {
+				if (!state.stopped) session.log(target, message);
+			},
+			status: (target, status, details) => {
+				if (!state.stopped) session.status(target, status, details);
+			},
+			findings: (target, findings) => {
+				if (!state.stopped) session.findings(target, findings);
+			}
+		},
+		stopped: false,
+		members: /* @__PURE__ */ new Map(),
+		catalogs: /* @__PURE__ */ new Map(),
+		sideFindings: {
+			api: /* @__PURE__ */ new Map(),
+			ui: /* @__PURE__ */ new Map()
+		},
+		reloadingApi: /* @__PURE__ */ new Set(),
+		routerDown: false,
+		declaredSecrets: /* @__PURE__ */ new Set()
+	};
+	return state;
+}
+/** Replaces the Asset's Findings with the union of both sides. */
+function setFindings(state, target, side, findings) {
+	state.sideFindings[side].set(target, findings);
+	state.report.findings(target, [...state.sideFindings.api.get(target) ?? [], ...state.sideFindings.ui.get(target) ?? []]);
+}
+/**
+* Adds to the API side's Findings instead of replacing them: a session compose failure arrives
+* after the load already reported the TypeScript and capability ones, and `validate` reports
+* them all together.
+*/
+function addApiFindings(state, target, findings) {
+	setFindings(state, target, "api", [...state.sideFindings.api.get(target) ?? [], ...findings]);
+}
+/** The declaration entry as a Finding's `file`, or the Asset's `asset.yaml` when it lies outside the root. */
+function entryFileOf(ctx, asset) {
+	return repoFile(ctx.root, apiDeclarationEntry(asset) ?? asset.dir) ?? asset.file;
+}
+function manifestFileOf(ctx, asset) {
+	return repoFile(ctx.root, join(asset.dir, "package.json")) ?? asset.file;
+}
+/** The API side's Findings once its subgraph is up: the TypeScript one and the capability ones. */
+function subgraphFindings(ctx, asset, entryFile, subgraph) {
+	return [...subgraph.typescript ? [typescriptUnsupported(manifestFileOf(ctx, asset), subgraph.typescript)] : [], ...subgraph.capability.map((finding) => capabilityFinding(ctx.root, entryFile, finding))];
+}
+/**
+* Starts the Asset's subgraph and gates it with the per-Asset composition check, so a composition
+* error is attributed to the Asset that caused it. Replaces the Asset's Findings. Returns the
+* running subgraph, or `undefined` after reporting `failed` with nothing listening.
+*/
+async function loadApiSide(state, asset) {
+	const { ctx, report } = state;
+	const { target } = asset;
+	const entryFile = entryFileOf(ctx, asset);
+	let subgraph;
+	try {
+		subgraph = await startSubgraph(asset.dir, {
+			port: 0,
+			variables: asset.env ?? ctx.env,
+			log: assetLog(report, target)
+		});
+	} catch (error) {
+		setFindings(state, target, "api", [declarationInvalid(entryFile, errorMessage(error))]);
+		report.status(target, "failed");
+		return;
+	}
+	for (const name of subgraph.secretNames) state.declaredSecrets.add(name);
+	const findings = subgraphFindings(ctx, asset, entryFile, subgraph);
+	const check = (0, import_compose.composeCheck)(coreFederationSdl(), subgraph.sdl, subgraph.name);
+	if (check.success) {
+		setFindings(state, target, "api", findings);
+		return subgraph;
+	}
+	await subgraph.stop();
+	setFindings(state, target, "api", [...findings, ...check.errors.map((error) => compositionFailed(entryFile, error.message))]);
+	report.status(target, "failed");
+}
+/**
+* Builds the Asset's catalog where its export points, at boot and on every save, and replaces the
+* UI side's Findings: the export one (absent, or naming no file inside the Asset), and the addon's
+* error when the build threw. The build runs even without a usable export, into `dist/`, so both
+* errors arrive together. A failed build writes nothing, so the previous `catalog.json` stays as
+* it was and the Asset drops out of `catalogs`.
+*/
+async function buildUiSide(state, asset) {
+	const { target } = asset;
+	const manifestFile = manifestFileOf(state.ctx, asset);
+	let findings = catalogExportFindings(catalogExport(asset), manifestFile);
+	try {
+		const { catalogPath } = await buildAssetCatalog(asset.dir, catalogOutDir(asset), "dev");
+		state.catalogs.set(target, catalogPath);
+	} catch (error) {
+		state.catalogs.delete(target);
+		findings = [...findings, catalogInvalid(manifestFile, repoRelativeMessage(state.ctx.root, errorMessage(error)))];
+	}
+	setFindings(state, target, "ui", findings);
+}
+/**
+* Boot: every Asset in call order, sequentially, the API side then the UI side, so two Assets'
+* `.vtex/storefront/load/` writes never interleave.
+*/
+async function bootAssets(state, assets, sides) {
+	for (const asset of assets) {
+		if (sides.api.includes(asset)) {
+			const subgraph = await loadApiSide(state, asset);
+			if (subgraph) state.members.set(asset.target, subgraph);
+		}
+		if (sides.ui.includes(asset)) await buildUiSide(state, asset);
+	}
+}
+/**
+* Stops every member and empties `members`. Each stop runs whatever the others do (Apollo rejects
+* on a drain that fails), then the first failure propagates.
+*/
+async function stopMembers(members) {
+	const stops = await Promise.allSettled([...members.values()].map((member) => member.stop()));
+	members.clear();
+	const failed = stops.find((stop) => stop.status === "rejected");
+	if (failed) throw failed.reason;
+}
+/**
+* Composes the session from every member and returns the supergraph file. A compose failure after
+* every member passed alone is a cross-Asset conflict: it goes to every member, every member
+* stops, and the session composes core alone.
+*/
+async function composeBoot(state, apiAssets) {
+	const { ctx, env, log, members, report } = state;
+	try {
+		return composeSession(ctx.root, env, [...members.values()], log).supergraphFile;
+	} catch (error) {
+		for (const asset of apiAssets) {
+			if (!members.has(asset.target)) continue;
+			addApiFindings(state, asset.target, [compositionFailed(entryFileOf(ctx, asset), errorMessage(error))]);
+			report.status(asset.target, "failed");
+		}
+		await stopMembers(members);
+		return composeSession(ctx.root, env, [], log).supergraphFile;
+	}
+}
+/**
+* The router exited on its own after boot: the one URL every Asset reported is dead, so every
+* Asset is `failed`, with the cause in the session's log, and stays so until the session
+* restarts. The subgraphs keep running for `stop()` to take down.
+*/
+function routerExited(state, assets, exit) {
+	if (state.stopped) return;
+	state.routerDown = true;
+	state.log.error(`storefront dev: the Hive Router exited ${describeRouterExit(exit)}; every Asset is failed until the session restarts.`);
+	for (const asset of assets) state.report.status(asset.target, "failed");
+}
+/**
+* Launches the router over the composed supergraph and waits for it to answer. It can still fail
+* (binary download, spawn, an exit before it listens, a port that never answers); the boot rolls
+* every subgraph back then, as for any step that throws.
+*/
+function launchRouter(state, assets, supergraphFile) {
+	const { ctx, env, log, members } = state;
+	return startRouter(ctx.root, env, [...members.values()].map((member) => member.name), supergraphFile, {
+		log,
+		watchSupergraphSeconds: 1,
+		onExit: (exit) => routerExited(state, assets, exit),
+		withholdSecrets: state.declaredSecrets
+	});
+}
+/**
+* One status from both sides: `ready` when every side the Asset has succeeded, with the router
+* URL, its subgraph for an API member and its catalog for a UI side; `failed` when any side
+* failed, or when the router is gone. A Finding alone never fails an Asset: an export-missing
+* Asset whose catalog built is `ready` with the Finding, the way a capability Finding leaves an
+* API Asset `ready`.
+*/
+function reportStatus(state, asset, routerUrl, sides) {
+	const { target } = asset;
+	const member = state.members.get(target);
+	const catalog = state.catalogs.get(target);
+	const apiDown = sides.api.includes(asset) && !member;
+	const uiDown = sides.ui.includes(asset) && catalog === void 0;
+	if (apiDown || uiDown || state.routerDown) {
+		state.report.status(target, "failed");
+		return;
+	}
+	state.report.status(target, "ready", {
+		url: routerUrl,
+		...member ? { subgraph: {
+			name: member.name,
+			url: member.url
+		} } : {},
+		...catalog ? { catalog } : {}
+	});
+}
+/** Recomposes the current members; a failure keeps the last-good supergraph and reports to `ctx.log`. */
+function recompose(state) {
+	try {
+		composeSession(state.ctx.root, state.env, [...state.members.values()], state.log);
+	} catch (error) {
+		state.log.error(errorMessage(error));
+	}
+}
+/**
+* Reloads one Asset's API side: stop its subgraph, load it again, recompose the session from the
+* current members. A fixed Asset rejoins; a broken one drops out, so the router serves an honest
+* graph instead of a dead URL. A session compose failure goes to the Asset that changed, which is
+* stopped and dropped, then one more compose without it. The target is in `reloadingApi` from the
+* old subgraph's stop to the new one's status, so a UI rebuild of a dual Asset that lands in
+* between never reports the gap as `failed`; the status reported here is the merged one.
+*/
+async function reloadApiSide(state, asset, routerUrl, sides) {
+	if (state.stopped) return;
+	const { ctx, env, log, members, report } = state;
+	const { target } = asset;
+	report.status(target, "starting");
+	state.reloadingApi.add(target);
+	try {
+		const previous = members.get(target);
+		members.delete(target);
+		try {
+			await previous?.stop();
+		} catch (error) {
+			log.error(errorMessage(error));
+		}
+		const next = await loadApiSide(state, asset);
+		if (state.stopped) {
+			await next?.stop();
+			return;
+		}
+		if (!next) {
+			recompose(state);
+			return;
+		}
+		members.set(target, next);
+		try {
+			composeSession(ctx.root, env, [...members.values()], log);
+		} catch (error) {
+			members.delete(target);
+			await next.stop();
+			addApiFindings(state, target, [compositionFailed(entryFileOf(ctx, asset), errorMessage(error))]);
+			report.status(target, "failed");
+			recompose(state);
+			return;
+		}
+		reportStatus(state, asset, routerUrl, sides);
+	} finally {
+		state.reloadingApi.delete(target);
+	}
+}
+/**
+* Rebuilds one Asset's catalog on a save: `starting`, the build, then the merged status, unless the
+* Asset's API side is mid-reload, which reports the merged status itself once its subgraph is back.
+*/
+async function rebuildUiSide(state, asset, routerUrl, sides) {
+	if (state.stopped) return;
+	state.report.status(asset.target, "starting");
+	await buildUiSide(state, asset);
+	if (state.stopped || state.reloadingApi.has(asset.target)) return;
+	reportStatus(state, asset, routerUrl, sides);
+}
+/**
+* One session-wide chain for the API side, so two Assets' reloads never compose with different
+* snapshots; a reload queued for a target that is already queued joins it, so a burst of saves is
+* one reload. One chain for the UI side: `buildPackageCatalog` is synchronous, so two rebuilds
+* never interleave. The tails are what `stop()` waits on when one is in flight.
+*/
+function createReloader(state, routerUrl, sides) {
+	let reloading = Promise.resolve();
+	const queued = /* @__PURE__ */ new Map();
+	const reloadApi = (asset) => {
+		const { target } = asset;
+		const waiting = queued.get(target);
+		if (waiting) return waiting;
+		const run = reloading.then(() => {
+			queued.delete(target);
+			return reloadApiSide(state, asset, routerUrl, sides);
+		});
+		queued.set(target, run);
+		reloading = run.catch(() => void 0);
+		return run;
+	};
+	let catalogBuilds = Promise.resolve();
+	const rebuildCatalog = (asset) => {
+		const run = catalogBuilds.then(() => rebuildUiSide(state, asset, routerUrl, sides));
+		catalogBuilds = run.catch(() => void 0);
+		return run;
+	};
+	const reload = (target) => {
+		const api = sides.api.find((candidate) => candidate.target === target);
+		const ui = sides.ui.find((candidate) => candidate.target === target);
+		if (api && ui) return Promise.all([reloadApi(api), rebuildCatalog(ui)]).then(() => void 0);
+		if (api) return reloadApi(api);
+		if (ui) return rebuildCatalog(ui);
+		return Promise.resolve();
+	};
+	return {
+		reloadSide: (asset, side) => side === "api" ? reloadApi(asset) : rebuildCatalog(asset),
+		reload,
+		settled: async () => {
+			await reloading;
+			await catalogBuilds;
+		}
+	};
+}
+/**
+* One `fs.watch` per distinct directory, each serving the `(Asset, side)` pairs rooted there: a
+* dual Asset whose declaration sits under `src/` gets one watcher for both sides, one whose `main`
+* sits elsewhere gets two, and a component save rebuilds the catalog alone.
+*/
+function subscriptionsOf(state, sides) {
+	const subscriptions = /* @__PURE__ */ new Map();
+	const subscribe = (asset, side, watchDir) => {
+		if (!existsSync(watchDir)) {
+			state.report.log(asset.target, `storefront dev: ${watchDir} not found; watch mode is idle (no files to watch).`);
+			return;
+		}
+		subscriptions.set(watchDir, [...subscriptions.get(watchDir) ?? [], {
+			asset,
+			side
+		}]);
+	};
+	for (const asset of sides.api) subscribe(asset, "api", resolveWatchRoot(asset.dir));
+	for (const asset of sides.ui) subscribe(asset, "ui", join(asset.dir, "src"));
+	return subscriptions;
+}
+/** The event's file name as a string; some platforms omit it. */
+function eventFileName(filename) {
+	return typeof filename === "string" ? filename : filename?.toString() ?? null;
+}
+/** What a catalog build writes into its folder: `catalog.json`, and the other two when not empty. */
+const CATALOG_FILES = [
+	"catalog.json",
+	"actions.json",
+	"content-types.json"
+];
+/**
+* The files the session's catalog builds write, which an export may put inside a watched folder
+* (`./src/gen/catalog.json`, or anything but `dist/` under a root `main`). Each build rewrites
+* them, so following an event on one would rebuild on every rebuild. The files, not their folder,
+* which may hold source.
+*/
+function catalogWrites(uiAssets) {
+	return new Set(uiAssets.flatMap((asset) => CATALOG_FILES.map((file) => join(catalogOutDir(asset), file))));
+}
+/**
+* The listener of one watched directory: a burst of events is one reload per `(Asset, side)` it
+* serves. `fs.watch` has no ignore option, so the session's own writes are filtered here.
+*/
+function debouncedReload(state, watchDir, subscribers, timers, reloader, ownWrites) {
+	return (_event, filename) => {
+		if (state.stopped) return;
+		const name = eventFileName(filename);
+		if (isIgnoredWatchPath(name)) return;
+		if (name !== null && ownWrites.has(join(watchDir, name))) return;
+		for (const { asset, side } of subscribers) {
+			const key = `${side}:${asset.target}`;
+			const timer = timers.get(key);
+			if (timer) clearTimeout(timer);
+			timers.set(key, setTimeout(() => {
+				timers.delete(key);
+				reloader.reloadSide(asset, side).catch((error) => {
+					state.report.log(asset.target, `storefront dev: reload failed:\n${errorMessage(error)}`);
+				});
+			}, 150));
+		}
+	};
+}
+/**
+* Watches every subscribed directory, pushing each watcher into `watchers` as it opens, so a
+* `fs.watch` throw part way through leaves the ones already open where `stop()` closes them. An
+* unhandled `error` event would throw out of the event loop, in the host's process, so each
+* watcher reports one under the Assets it serves.
+*/
+function watchAll(state, subscriptions, timers, reloader, watchers, ownWrites) {
+	for (const [watchDir, subscribers] of subscriptions) {
+		const listener = debouncedReload(state, watchDir, subscribers, timers, reloader, ownWrites);
+		const watcher = watch(watchDir, { recursive: true }, listener);
+		watcher.on("error", (error) => {
+			for (const { asset } of subscribers) state.report.log(asset.target, `storefront dev: watcher error on ${watchDir}: ${error.message}`);
+		});
+		watchers.push(watcher);
+	}
+}
+/**
+* Everything `stop()` takes down, in order: watchers, timers, the router, every subgraph, then the
+* lock. Every subgraph is stopped before the first failed stop propagates (Apollo rejects on a
+* drain that fails), and the lock goes whatever happened above: a lock left behind by a stop that
+* threw would refuse the next `dev` in this process with the wrong cause, for as long as it lives.
+*/
+async function teardown(state, watchers, timers, router, reloader, releaseLock) {
+	state.stopped = true;
+	try {
+		for (const watcher of watchers) watcher.close();
+		for (const timer of timers.values()) clearTimeout(timer);
+		await router.stop();
+		await reloader.settled();
+		await stopMembers(state.members);
+	} finally {
+		releaseLock();
+	}
+}
+async function startDevAdapter(assets, session, ctx) {
+	const { VTEX_STOREFRONT_SUBGRAPH_PORT: subgraphPort, ...sessionEnv } = ctx.env;
+	const env = loadRunnerEnv(sessionEnv);
+	for (const line of renamedVariableWarnings(ctx.env)) ctx.log(line);
+	if (subgraphPort !== void 0) ctx.log("storefront dev: VTEX_STOREFRONT_SUBGRAPH_PORT was ignored — the provider gives each Asset's subgraph its own port; only scripts/storefront-ext.mjs reads the variable.");
+	const sides = {
+		api: assets.filter((asset) => apiDeclarationEntry(asset) !== void 0),
+		ui: assets.filter(uiSide)
+	};
+	if (sides.ui.length > 0) await loadCatalogBuilder("dev");
+	const releaseLock = acquireSessionLock(scratchDir(ctx.root));
+	const state = createState(session, ctx, env);
+	let router;
+	try {
+		await bootAssets(state, assets, sides);
+		router = await launchRouter(state, assets, await composeBoot(state, sides.api));
+	} catch (error) {
+		await stopMembers(state.members).catch(() => void 0);
+		releaseLock();
+		throw error;
+	}
+	const reloader = createReloader(state, router.routerUrl, sides);
+	const watchers = [];
+	const timers = /* @__PURE__ */ new Map();
+	let stopping;
+	const stop = () => {
+		stopping ??= teardown(state, watchers, timers, router, reloader, releaseLock);
+		return stopping;
+	};
+	try {
+		watchAll(state, subscriptionsOf(state, sides), timers, reloader, watchers, catalogWrites(sides.ui));
+	} catch (error) {
+		await stop();
+		throw error;
+	}
+	for (const asset of assets) if (state.members.has(asset.target) || !sides.api.includes(asset)) reportStatus(state, asset, router.routerUrl, sides);
+	return {
+		stop,
+		reload: reloader.reload
+	};
 }
+//#endregion
+//#region src/cli/skills.ts
+/**
+* The provider's skills, written to contract version 0 (`@vtex/extension-cli-kit`): the Agent Skills
+* folders that teach a coding agent in an Account Repo to write storefront Assets. `vtex extension
+* skills`, and `add` once you agree, copy each folder to `.agents/skills/<name>/` and link
+* `.claude/skills/<name>` to it; nothing in a folder is code this package runs. `dir` is resolved
+* against the built entry, `dist/cli/index.js`, which tsdown bundles this module into, so `../../`
+* lands on the package root from source and from `dist/` alike.
+*/
+/** The one skill: `skills/storefront-asset/`, a `SKILL.md` and the references it points to. */
+const skills = [{
+	name: "storefront-asset",
+	dir: fileURLToPath(new URL("../../skills/storefront-asset/", import.meta.url))
+}];
+//#endregion
+//#region src/cli/templates.ts
+/**
+* The provider's templates, written to contract version 0 (`@vtex/extension-cli-kit`): what
+* `vtex extension add <ext>/<asset> --kind storefront` writes for a new storefront Asset. `files`
+* renders every file keyed by its path inside the Asset's folder and writes nothing; the core
+* writes `asset.yaml` and `package.json` itself and never overwrites a file. `packages` is what
+* `add` installs into the new Asset, one `pnpm add` per dependency field, and `packageJson` the
+* fields it merges into the `package.json` it bootstrapped.
+*/
 /** Renders `src/index.ts`: a real `defineSubgraph` with the resolved `vendor`, a `Product.reviews` sample, and an in-memory resolver. */
 function indexTemplate(vendor) {
 	return `import { defineSubgraph, gql } from '@vtex/faststore/graphql';
@@ -34892,7 +36188,7 @@ export default defineSubgraph({
 });
 `;
 }
-/** Renders the scaffold's `tsconfig.json`: a known-good NodeNext config `build` type-checks the extension against. */
+/** Renders the API side's `tsconfig.json`: a known-good NodeNext config `build` type-checks the declaration against. */
 function tsconfigTemplate() {
 	return `${JSON.stringify({
 		compilerOptions: {
@@ -34912,68 +36208,105 @@ function tsconfigTemplate() {
 		]
 	}, null, 2)}\n`;
 }
-/** Renders `.env.example`: the FSPG-808 env contract copied from the reviews-graphql reference. */
-function envExampleTemplate() {
-	return `# Copy to .env (gitignored) and fill in real values.
-
-# Required unless STOREFRONT_CORE_URL is set. Deployed core is resolved as
-# https://<VTEX_ACCOUNT>.myvtex.com/api/storefront-core/graphql.
-VTEX_ACCOUNT=
-
-# Defaults to "master" if unset.
-VTEX_WORKSPACE=
-
-# Optional. Forwarded as \`authorization\` toward core for inbound requests
-# that don't already carry one (e.g. querying straight from the router's
-# playground). Use a \`vtex login\` token, no "Bearer " prefix.
-VTEX_TOKEN=
+/**
+* Renders the UI side's `tsconfig.json`. The store compiles the components from source
+* (ADR-0026), so this config serves the editor and a later `typecheck` script only.
+*/
+function uiTsconfigTemplate() {
+	return `${JSON.stringify({
+		compilerOptions: {
+			target: "ES2022",
+			module: "ESNext",
+			moduleResolution: "bundler",
+			jsx: "react-jsx",
+			lib: [
+				"ES2022",
+				"DOM",
+				"DOM.Iterable"
+			],
+			strict: true,
+			skipLibCheck: true,
+			noEmit: true
+		},
+		include: ["src"]
+	}, null, 2)}\n`;
+}
+/** Renders `src/components/HeroBanner.tsx`: a `defineComponent` sample whose catalog key is `<packageName>:HeroBanner`. */
+function componentTemplate(packageName) {
+	return `import { defineComponent } from '@vtex/faststore';
+import type { ComponentPropsWithRef } from 'react';
 
-# Optional. Overrides the account-derived core routing URL (e.g. to point at
-# a locally running storefront-api-core instead of deployed core).
-# STOREFRONT_CORE_URL=
+/** Props for {@link HeroBanner}. Extends all native \`<section>\` attributes. */
+export type HeroBannerProps = ComponentPropsWithRef<'section'> & {
+  /** The headline text. */
+  title?: string;
+};
 
-# Optional. LOCAL DEV ONLY. Disables TLS certificate verification for the core
-# subgraph. Use only when STOREFRONT_CORE_URL points at an internal host whose
-# cert doesn't match its hostname; the deployed router never reads this file,
-# so it cannot weaken production. Leave unset in any shared/CI environment.
-# VTEX_STOREFRONT_INSECURE_SKIP_TLS_VERIFY=true
+export const HeroBannerDefinition = defineComponent<HeroBannerProps>({
+  name: 'HeroBanner',
+  importPath: '${packageName}',
+  component: HeroBanner,
+  editor: { label: 'Hero Banner', category: 'content' },
+  schema: {
+    title: { type: 'string', label: 'Title' },
+  },
+});
 
-# Optional port overrides (defaults: 4001 / 4060).
-# VTEX_STOREFRONT_SUBGRAPH_PORT=4001
-# VTEX_STOREFRONT_ROUTER_PORT=4060
+export function HeroBanner({ title, className, ...props }: HeroBannerProps) {
+  return (
+    <section {...props} className={className} data-fs-hero-banner="">
+      <h1>{title}</h1>
+    </section>
+  );
+}
+`;
+}
+/** Renders the UI side's `src/index.ts`: the barrel a store imports the components from. */
+function barrelTemplate() {
+	return `// The barrel a UI Extension exports its components from: not a declaration, and never bundled as one.
+export type { HeroBannerProps } from './components/HeroBanner';
+export { HeroBanner, HeroBannerDefinition } from './components/HeroBanner';
 `;
 }
-/** Renders `.gitignore`: the local artifacts a scaffold must never commit. */
+/**
+* Renders `.gitignore`: the local artifacts a scaffold must never commit. Not `.env`: an Account
+* Repo tracks `.env` and ignores `.env*.local` at its root.
+*/
 function gitignoreTemplate() {
-	return `.env\n.vtex/storefront/\ndist/\nnode_modules/\n`;
+	return `.vtex/storefront/\ndist/\nnode_modules/\n`;
 }
-/** Renders `README.md`: a short quickstart naming the lifecycle verbs and the artifact the build emits. */
-function readmeTemplate(name) {
-	return `# ${name}
+/**
+* Renders `README.md`: what the scaffold is, where its settings live, and the lifecycle verbs.
+*/
+function readmeTemplate({ packageName }, side) {
+	return `# ${packageName}
 
-A Storefront API extension. It adds \`Product.reviews\` to the graph via
-\`defineSubgraph\` (\`@vtex/faststore/graphql\`); the SDK wires
-\`buildSubgraphSchema\`, the generated \`__resolveReference\`, and the local dev loop.
+${side === "api" ? `The API side of a storefront Asset: \`src/index.ts\` adds \`Product.reviews\` to the storefront
+graph through \`defineSubgraph\` (\`@vtex/faststore/graphql\`).` : `The UI side of a storefront Asset: \`src/components/HeroBanner.tsx\` is a \`defineComponent\`
+sample, and \`src/index.ts\` is the barrel a store imports it from.`}
 
 ## Setup
 
-\`\`\`sh
-cp .env.example .env
-# then fill in VTEX_ACCOUNT (and, if needed, VTEX_WORKSPACE / VTEX_TOKEN)
-\`\`\`
+\`VTEX_ACCOUNT\`, \`VTEX_WORKSPACE\` and \`VTEX_TOKEN\` go in the Account Repo root's \`.env\`
+(\`.env.local\` for the token), which \`vtex extension dev\` reads.
 
 ## Lifecycle
 
 \`\`\`sh
-vtex extensions dev        # watch-by-default local federated loop
-vtex extensions validate   # capability lint + offline composition check
-vtex extensions build      # emit dist/ (server.mjs + extension.graphql)
-node dist/server.mjs       # run the built artifact as a standalone subgraph (production entrypoint)
-pnpm test                  # the Seam-A-style vitest check
+vtex extension dev        # the local dev loop for the selected Assets
+vtex extension validate   # the provider's checks, as Findings
+vtex extension build      # both sides into .vtex/build/<ext>/<asset>/
 \`\`\`
 
-Replace the in-memory fixture data in \`src/index.ts\` with a call to your own
-datasource.
+${side === "api" ? `## Tests
+
+\`pnpm test\` runs \`src/index.test.ts\` with \`vitest\`; \`pnpm typecheck\` runs \`tsc --noEmit\`.
+
+Replace the in-memory fixture data in \`src/index.ts\` with a call to your own datasource.` : `## Components
+
+\`vtex extension dev\` and \`vtex extension build\` write \`dist/catalog.json\`. \`package.json#exports\`
+points a store at \`src/index.ts\` and at that catalog. A store lists this package as a dependency
+and imports the components from \`src/\`.`}
 `;
 }
 /**
@@ -35019,29 +36352,108 @@ describe('${vendor} extension', () => {
 `;
 }
 /**
-* The scaffolds `@vtex/faststore/cli` ships. One today, `default`: the
-* `Product.reviews` sample every reference extension in this repository
-* started from. A `vendor` that violates the vendor grammar is rejected up
-* front, so a template never renders a declaration that would fail `validate`.
+* The two templates: `default`, the API side `add` writes without `--template`, and `ui`. The
+* storefront body is empty, so each `body` is `{}`. A `vendor` that violates the vendor grammar
+* is rejected up front, so a template never renders a declaration that would fail `validate`.
+*
+* `typescript` is pinned to the SDK's optional peer range: `validate` and `dev` load the compiler
+* from the Asset's devDependencies. `graphql` is pinned to the SDK's own range so the Asset holds
+* one copy: graphql-js rejects a schema built by another copy of itself, which is exactly what
+* the scaffolded test does. `react` is a peer because the store app renders the components.
 */
 const templates = [{
 	name: "default",
-	description: "A Storefront API extension that adds Product.reviews via defineSubgraph, with a vitest check.",
-	files({ name, vendor }) {
-		assertValidVendor(vendor);
+	summary: "The API side of a storefront Asset: adds Product.reviews to the storefront graph through defineSubgraph.",
+	body: () => ({}),
+	files(input) {
+		assertValidVendor(input.vendor);
 		return {
-			"package.json": packageJsonTemplate(name),
 			"tsconfig.json": tsconfigTemplate(),
-			".env.example": envExampleTemplate(),
 			".gitignore": gitignoreTemplate(),
-			"README.md": readmeTemplate(name),
-			"src/index.ts": indexTemplate(vendor),
-			"src/index.test.ts": testTemplate(vendor)
+			"README.md": readmeTemplate(input, "api"),
+			"src/index.ts": indexTemplate(input.vendor),
+			"src/index.test.ts": testTemplate(input.vendor)
+		};
+	},
+	packages: { devDependencies: {
+		graphql: "^16.13.1",
+		typescript: "^5.9.3",
+		vitest: "^4.1.0"
+	} },
+	packageJson: {
+		type: "module",
+		scripts: {
+			test: "vitest run",
+			typecheck: "tsc --noEmit"
+		}
+	}
+}, {
+	name: "ui",
+	summary: "The UI side of a storefront Asset: a defineComponent sample a store reads through the catalog.",
+	body: () => ({}),
+	files(input) {
+		assertValidVendor(input.vendor);
+		return {
+			"tsconfig.json": uiTsconfigTemplate(),
+			".gitignore": gitignoreTemplate(),
+			"README.md": readmeTemplate(input, "ui"),
+			"src/index.ts": barrelTemplate(),
+			"src/components/HeroBanner.tsx": componentTemplate(input.packageName)
 		};
+	},
+	packages: {
+		devDependencies: {
+			"@types/react": "^19.2.0",
+			typescript: "^5.9.3"
+		},
+		peerDependencies: { react: "^19.0.0" }
+	},
+	packageJson: {
+		type: "module",
+		exports: {
+			".": "./src/index.ts",
+			"./catalog.json": "./dist/catalog.json"
+		},
+		scripts: { typecheck: "tsc --noEmit" }
 	}
 }];
 //#endregion
+//#region src/cli/provider.ts
+/** The one `asset.yaml` apiVersion `vtex extension add` writes. */
+const ASSET_API_VERSION = "assets.vtex.com/v1alpha1";
+/** Where the storefront kind is documented: the RFC that designs this provider. */
+const PROVIDER_DOCS = "https://github.com/vtex/faststore-ai-native/blob/main/docs/storefront-core/rfc-faststore-cli.md";
+/**
+* The storefront kind body is empty: a storefront `asset.yaml` carries the envelope and nothing
+* below it. The core compiles this with Ajv 2020, so `{}` is the one valid body.
+*/
+const STOREFRONT_BODY_SCHEMA = {
+	type: "object",
+	additionalProperties: false,
+	properties: {}
+};
+/**
+* The storefront kind provider: the default export of `@vtex/faststore/cli`, written to contract
+* version 0 (`@vtex/extension-cli-kit`), which `vtex extension` loads from each storefront Asset's
+* own `@vtex/faststore` (ADR-0026). It wraps the runner's named exports.
+*
+* Like the rest of the runner, it prints nothing, reads no `process.env` and installs no signal
+* handler: `process-isolation.test.ts` walks this file with the others.
+*/
+const storefrontProvider = {
+	contract: 0,
+	kind: "storefront",
+	apiVersions: [ASSET_API_VERSION],
+	docs: PROVIDER_DOCS,
+	schema: () => STOREFRONT_BODY_SCHEMA,
+	templates,
+	skills,
+	validate: validateAssets,
+	dev: startDevAdapter,
+	build: buildAssets
+};
+//#endregion
 var CORE_SUBGRAPH_NAME = import_subgraph_names.CORE_SUBGRAPH_NAME;
-export { CORE_SUBGRAPH_NAME, CompileError, ValidationGateError, buildExtension, buildSubgraph, formatFinding, formatValidationReport, lintExtension, printSubgraphSdl, resolveDeclarationEntry, runDev, runDevWatch, templates, validateExtension };
+export { CORE_SUBGRAPH_NAME, CompileError, TypeScriptUnavailableError, ValidationGateError, buildExtension, buildSubgraph, storefrontProvider as default, formatFinding, formatValidationReport, kinds, lintExtension, loadRunnerEnv, printSubgraphSdl, providerContractVersion, resolveDeclarationEntry, runDev, runDevWatch, skills, templates, validateExtension };
 
 //# sourceMappingURL=index.js.map