@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/core/cart/actions.mjs

@@ -0,0 +1,240 @@
+import { normalizeCartId } from "./cookie.mjs";
+import { getCartAttributeFormEntries } from "./form.mjs";
+
+//#region src/core/cart/actions.ts
+var CartActionError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CartActionError";
+	}
+};
+async function parseCartRequest(request) {
+	const contentType = request.headers.get("content-type") ?? "";
+	if (contentType.includes("application/json")) return parseJsonBody(await request.json());
+	if (contentType.includes("application/x-www-form-urlencoded") || contentType.includes("multipart/form-data")) return {
+		action: parseFormData(await request.formData()),
+		cartId: null
+	};
+	throw new CartActionError(`Unsupported content-type: "${contentType}". Expected application/json or form data.`);
+}
+function parseJsonBody(body) {
+	assertObject(body);
+	const cartId = typeof body.cartId === "string" ? normalizeCartId(body.cartId) : null;
+	if ("note" in body && typeof body.note === "string") return {
+		action: {
+			intent: "note-update",
+			note: body.note
+		},
+		cartId
+	};
+	if ("discountCodes" in body && Array.isArray(body.discountCodes)) {
+		for (const code of body.discountCodes) assertString(code, "discountCodes entries");
+		return {
+			action: {
+				intent: "discount-update",
+				discountCodes: body.discountCodes
+			},
+			cartId
+		};
+	}
+	if ("attributes" in body && Array.isArray(body.attributes)) return {
+		action: {
+			intent: "attributes-update",
+			attributes: parseAttributes(body.attributes)
+		},
+		cartId
+	};
+	if (!("lines" in body) || !Array.isArray(body.lines)) throw new CartActionError("Request body must contain \"lines\", \"discountCodes\", \"attributes\", or \"note\".");
+	const lines = body.lines;
+	if (lines.length === 0) throw new CartActionError("Lines array must not be empty.");
+	return {
+		action: partitionLines(lines),
+		cartId
+	};
+}
+function partitionLines(rawLines) {
+	const adds = [];
+	const updates = [];
+	const removeIds = [];
+	for (const raw of rawLines) {
+		assertObject(raw);
+		const line = raw;
+		const hasId = "id" in line && typeof line.id === "string" && line.id !== "";
+		const hasMerchandiseId = "merchandiseId" in line && typeof line.merchandiseId === "string" && line.merchandiseId !== "";
+		assertNonNegativeInteger(line.quantity, "quantity");
+		const quantity = line.quantity;
+		if (!hasId && !hasMerchandiseId) throw new CartActionError("Each line must have either \"id\" (for update/remove) or \"merchandiseId\" (for add).");
+		if (hasId && line.id === "") throw new CartActionError("Line \"id\" must not be empty.");
+		const optionalFields = extractOptionalLineFields(line);
+		if (!hasId && hasMerchandiseId) adds.push({
+			merchandiseId: line.merchandiseId,
+			quantity,
+			...optionalFields
+		});
+		else if (hasId && quantity === 0) removeIds.push(line.id);
+		else if (hasId) updates.push({
+			id: line.id,
+			quantity,
+			...optionalFields
+		});
+	}
+	if ([
+		adds.length,
+		updates.length,
+		removeIds.length
+	].filter((n) => n > 0).length > 1) throw new CartActionError("Mixed line operations are not allowed. Separate add, update, and remove into distinct requests.");
+	if (adds.length > 0) return {
+		intent: "add",
+		lines: adds
+	};
+	if (updates.length > 0) return {
+		intent: "update",
+		lines: updates
+	};
+	return {
+		intent: "remove",
+		lineIds: removeIds
+	};
+}
+function extractOptionalLineFields(line) {
+	const result = {};
+	if ("attributes" in line && Array.isArray(line.attributes)) result.attributes = line.attributes;
+	if ("sellingPlanId" in line && typeof line.sellingPlanId === "string") result.sellingPlanId = line.sellingPlanId;
+	return result;
+}
+const LINE_INTENTS = new Set([
+	"increase",
+	"decrease",
+	"remove",
+	"set"
+]);
+const DISCOUNT_INTENTS = new Set(["discount-apply", "discount-remove"]);
+function parseFormData(form) {
+	const intent = formString(form, "intent");
+	const merchandiseId = formString(form, "merchandiseId");
+	if (!intent && merchandiseId) return parseAddIntent(form, merchandiseId);
+	if (intent === "add") {
+		if (!merchandiseId) throw new CartActionError("Intent \"add\" requires a \"merchandiseId\" field.");
+		return parseAddIntent(form, merchandiseId);
+	}
+	if (!intent) throw new CartActionError("FormData must include an \"intent\" field or a \"merchandiseId\" field.");
+	if (LINE_INTENTS.has(intent)) return parseLineIntent(intent, form);
+	if (DISCOUNT_INTENTS.has(intent)) return parseDiscountIntent(intent, form);
+	if (intent === "note-update") return parseNoteIntent(form);
+	if (intent === "attributes-update") return parseAttributesIntent(form);
+	throw new CartActionError(`Unknown intent "${intent}". Expected one of: add, increase, decrease, remove, set, discount-apply, discount-remove, attributes-update, note-update.`);
+}
+function parseLineIntent(intent, form) {
+	const lineId = formString(form, "lineId");
+	if (!lineId) throw new CartActionError(`Intent "${intent}" requires a "lineId" field.`);
+	if (intent === "remove") return {
+		intent: "remove",
+		lineIds: [lineId]
+	};
+	const quantity = formInt(form, "quantity");
+	if (quantity === null) throw new CartActionError(`Intent "${intent}" requires a "quantity" field.`);
+	if (intent === "set") {
+		if (quantity <= 0) return {
+			intent: "remove",
+			lineIds: [lineId]
+		};
+		return {
+			intent: "update",
+			lines: [{
+				id: lineId,
+				quantity
+			}]
+		};
+	}
+	if (intent === "increase") return {
+		intent: "update",
+		lines: [{
+			id: lineId,
+			quantity: quantity + 1
+		}]
+	};
+	const decremented = quantity - 1;
+	if (decremented <= 0) return {
+		intent: "remove",
+		lineIds: [lineId]
+	};
+	return {
+		intent: "update",
+		lines: [{
+			id: lineId,
+			quantity: decremented
+		}]
+	};
+}
+function parseDiscountIntent(intent, form) {
+	const code = formString(form, "discountCode");
+	if (!code) throw new CartActionError(`Intent "${intent}" requires a "discountCode" field.`);
+	return {
+		intent,
+		code
+	};
+}
+function parseAddIntent(form, merchandiseId) {
+	const quantity = formInt(form, "quantity") ?? 1;
+	const sellingPlanId = formString(form, "sellingPlanId");
+	const line = {
+		merchandiseId,
+		quantity
+	};
+	if (sellingPlanId) line.sellingPlanId = sellingPlanId;
+	return {
+		intent: "add",
+		lines: [line]
+	};
+}
+function parseNoteIntent(form) {
+	const noteValue = form.get("note");
+	if (noteValue === null) throw new CartActionError("Intent \"note-update\" requires a \"note\" field.");
+	return {
+		intent: "note-update",
+		note: String(noteValue)
+	};
+}
+function parseAttributesIntent(form) {
+	return {
+		intent: "attributes-update",
+		attributes: parseAttributes(getCartAttributeFormEntries(form))
+	};
+}
+function parseAttributes(values) {
+	return values.map((value, index) => {
+		assertObject(value);
+		assertString(value.key, `attributes[${index}].key`);
+		assertString(value.value, `attributes[${index}].value`);
+		if (!value.key) throw new CartActionError(`Expected "attributes[${index}].key" not to be empty.`);
+		return {
+			key: value.key,
+			value: value.value
+		};
+	});
+}
+function assertObject(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new CartActionError("Expected an object.");
+}
+function assertString(value, label) {
+	if (typeof value !== "string") throw new CartActionError(`Expected "${label}" to be a string.`);
+}
+function assertNonNegativeInteger(value, label) {
+	if (typeof value !== "number" || !Number.isInteger(value) || value < 0) throw new CartActionError(`Expected "${label}" to be a non-negative integer, got ${JSON.stringify(value)}.`);
+}
+function formString(form, key) {
+	const value = form.get(key);
+	if (value === null || typeof value !== "string") return null;
+	return value || null;
+}
+function formInt(form, key) {
+	const raw = form.get(key);
+	if (raw === null || typeof raw !== "string") return null;
+	const parsed = parseInt(raw, 10);
+	if (Number.isNaN(parsed)) return null;
+	return parsed;
+}
+
+//#endregion
+export { parseCartRequest };
+//# sourceMappingURL=actions.mjs.map

package/dist/core/cart/actions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.mjs","names":[],"sources":["../../../src/core/cart/actions.ts"],"sourcesContent":["import { normalizeCartId } from \"./cookie\";\nimport { getCartAttributeFormEntries } from \"./form\";\n\nexport type CartAttributeInput = { key: string; value: string };\n\nexport type CartLineAddInput = {\n  merchandiseId: string;\n  quantity: number;\n  attributes?: CartAttributeInput[];\n  sellingPlanId?: string;\n};\n\nexport type CartLineUpdateInput = {\n  id: string;\n  quantity: number;\n  attributes?: CartAttributeInput[];\n  sellingPlanId?: string;\n};\n\nexport type CartAction =\n  | { intent: \"add\"; lines: CartLineAddInput[] }\n  | { intent: \"update\"; lines: CartLineUpdateInput[] }\n  | { intent: \"remove\"; lineIds: string[] }\n  | { intent: \"discount-update\"; discountCodes: string[] }\n  | { intent: \"discount-apply\"; code: string }\n  | { intent: \"discount-remove\"; code: string }\n  | { intent: \"attributes-update\"; attributes: CartAttributeInput[] }\n  | { intent: \"note-update\"; note: string };\n\ntype ParsedCartRequest = {\n  action: CartAction;\n  cartId: string | null;\n};\n\nclass CartActionError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CartActionError\";\n  }\n}\n\nexport async function parseCartRequest(request: Request): Promise<ParsedCartRequest> {\n  const contentType = request.headers.get(\"content-type\") ?? \"\";\n\n  if (contentType.includes(\"application/json\")) {\n    return parseJsonBody(await request.json());\n  }\n\n  if (\n    contentType.includes(\"application/x-www-form-urlencoded\") ||\n    contentType.includes(\"multipart/form-data\")\n  ) {\n    return { action: parseFormData(await request.formData()), cartId: null };\n  }\n\n  throw new CartActionError(\n    `Unsupported content-type: \"${contentType}\". Expected application/json or form data.`,\n  );\n}\n\n// --- JSON parsing ---\n\nfunction parseJsonBody(body: unknown): ParsedCartRequest {\n  assertObject(body);\n  const cartId = typeof body.cartId === \"string\" ? normalizeCartId(body.cartId) : null;\n\n  if (\"note\" in body && typeof body.note === \"string\") {\n    return { action: { intent: \"note-update\", note: body.note }, cartId };\n  }\n\n  if (\"discountCodes\" in body && Array.isArray(body.discountCodes)) {\n    for (const code of body.discountCodes) {\n      assertString(code, \"discountCodes entries\");\n    }\n    return {\n      action: { intent: \"discount-update\", discountCodes: body.discountCodes as string[] },\n      cartId,\n    };\n  }\n\n  if (\"attributes\" in body && Array.isArray(body.attributes)) {\n    return {\n      action: { intent: \"attributes-update\", attributes: parseAttributes(body.attributes) },\n      cartId,\n    };\n  }\n\n  if (!(\"lines\" in body) || !Array.isArray(body.lines)) {\n    throw new CartActionError(\n      'Request body must contain \"lines\", \"discountCodes\", \"attributes\", or \"note\".',\n    );\n  }\n\n  const lines = body.lines as unknown[];\n  if (lines.length === 0) {\n    throw new CartActionError(\"Lines array must not be empty.\");\n  }\n\n  return { action: partitionLines(lines), cartId };\n}\n\nfunction partitionLines(rawLines: unknown[]): CartAction {\n  const adds: CartLineAddInput[] = [];\n  const updates: CartLineUpdateInput[] = [];\n  const removeIds: string[] = [];\n\n  for (const raw of rawLines) {\n    assertObject(raw);\n    const line = raw as Record<string, unknown>;\n    const hasId = \"id\" in line && typeof line.id === \"string\" && line.id !== \"\";\n    const hasMerchandiseId =\n      \"merchandiseId\" in line &&\n      typeof line.merchandiseId === \"string\" &&\n      line.merchandiseId !== \"\";\n\n    assertNonNegativeInteger(line.quantity, \"quantity\");\n    const quantity = line.quantity as number;\n\n    if (!hasId && !hasMerchandiseId) {\n      throw new CartActionError(\n        'Each line must have either \"id\" (for update/remove) or \"merchandiseId\" (for add).',\n      );\n    }\n\n    if (hasId && (line.id as string) === \"\") {\n      throw new CartActionError('Line \"id\" must not be empty.');\n    }\n\n    const optionalFields = extractOptionalLineFields(line);\n\n    if (!hasId && hasMerchandiseId) {\n      adds.push({\n        merchandiseId: line.merchandiseId as string,\n        quantity,\n        ...optionalFields,\n      });\n    } else if (hasId && quantity === 0) {\n      removeIds.push(line.id as string);\n    } else if (hasId) {\n      updates.push({\n        id: line.id as string,\n        quantity,\n        ...optionalFields,\n      });\n    }\n  }\n\n  const populatedBuckets = [adds.length, updates.length, removeIds.length].filter(\n    (n) => n > 0,\n  ).length;\n\n  if (populatedBuckets > 1) {\n    throw new CartActionError(\n      \"Mixed line operations are not allowed. Separate add, update, and remove into distinct requests.\",\n    );\n  }\n\n  if (adds.length > 0) return { intent: \"add\", lines: adds };\n  if (updates.length > 0) return { intent: \"update\", lines: updates };\n  return { intent: \"remove\", lineIds: removeIds };\n}\n\nfunction extractOptionalLineFields(\n  line: Record<string, unknown>,\n): Pick<CartLineAddInput, \"attributes\" | \"sellingPlanId\"> {\n  const result: Pick<CartLineAddInput, \"attributes\" | \"sellingPlanId\"> = {};\n\n  if (\"attributes\" in line && Array.isArray(line.attributes)) {\n    result.attributes = line.attributes as CartAttributeInput[];\n  }\n\n  if (\"sellingPlanId\" in line && typeof line.sellingPlanId === \"string\") {\n    result.sellingPlanId = line.sellingPlanId;\n  }\n\n  return result;\n}\n\n// --- FormData parsing ---\n//\n// HTML forms can't express the same structures as JSON. Key compromises:\n//\n//   Add line:       single item per submission (forms can't batch multiple adds)\n//   Update qty:     server does the math — form sends current qty, server increments/decrements\n//   Remove line:    explicit intent field (can't express \"quantity=0 means remove\" implicitly)\n//   Discount bulk:  no FormData equivalent — forms handle one code at a time\n//   Cart attributes: attributes.<key> fields preserve each key/value relationship\n//   Selling plan:   add only — no way to change selling plan on existing line via form\n//\n// Design decisions:\n//   - `intent` field disambiguates operations (forms need explicit routing; JSON infers from structure)\n//   - Field names match where possible: merchandiseId, quantity, lineId, discountCode, note\n//   - Form submissions get 303 redirect to referer; JSON gets JSON response\n//   - `increase`/`decrease` intents exist because forms can't atomically read-modify-write quantity\n\nconst LINE_INTENTS = new Set([\"increase\", \"decrease\", \"remove\", \"set\"]);\nconst DISCOUNT_INTENTS = new Set([\"discount-apply\", \"discount-remove\"]);\n\nfunction parseFormData(form: FormData): CartAction {\n  const intent = formString(form, \"intent\");\n  const merchandiseId = formString(form, \"merchandiseId\");\n\n  if (!intent && merchandiseId) {\n    return parseAddIntent(form, merchandiseId);\n  }\n\n  if (intent === \"add\") {\n    if (!merchandiseId) {\n      throw new CartActionError('Intent \"add\" requires a \"merchandiseId\" field.');\n    }\n    return parseAddIntent(form, merchandiseId);\n  }\n\n  if (!intent) {\n    throw new CartActionError(\n      'FormData must include an \"intent\" field or a \"merchandiseId\" field.',\n    );\n  }\n\n  if (LINE_INTENTS.has(intent)) {\n    return parseLineIntent(intent, form);\n  }\n\n  if (DISCOUNT_INTENTS.has(intent)) {\n    return parseDiscountIntent(intent as \"discount-apply\" | \"discount-remove\", form);\n  }\n\n  if (intent === \"note-update\") {\n    return parseNoteIntent(form);\n  }\n\n  if (intent === \"attributes-update\") {\n    return parseAttributesIntent(form);\n  }\n\n  throw new CartActionError(\n    `Unknown intent \"${intent}\". Expected one of: add, increase, decrease, remove, set, discount-apply, discount-remove, attributes-update, note-update.`,\n  );\n}\n\nfunction parseLineIntent(intent: string, form: FormData): CartAction {\n  const lineId = formString(form, \"lineId\");\n  if (!lineId) {\n    throw new CartActionError(`Intent \"${intent}\" requires a \"lineId\" field.`);\n  }\n\n  if (intent === \"remove\") {\n    return { intent: \"remove\", lineIds: [lineId] };\n  }\n\n  const quantity = formInt(form, \"quantity\");\n  if (quantity === null) {\n    throw new CartActionError(`Intent \"${intent}\" requires a \"quantity\" field.`);\n  }\n\n  if (intent === \"set\") {\n    if (quantity <= 0) {\n      return { intent: \"remove\", lineIds: [lineId] };\n    }\n    return { intent: \"update\", lines: [{ id: lineId, quantity }] };\n  }\n\n  if (intent === \"increase\") {\n    return { intent: \"update\", lines: [{ id: lineId, quantity: quantity + 1 }] };\n  }\n\n  const decremented = quantity - 1;\n  if (decremented <= 0) {\n    return { intent: \"remove\", lineIds: [lineId] };\n  }\n  return { intent: \"update\", lines: [{ id: lineId, quantity: decremented }] };\n}\n\nfunction parseDiscountIntent(\n  intent: \"discount-apply\" | \"discount-remove\",\n  form: FormData,\n): CartAction {\n  const code = formString(form, \"discountCode\");\n  if (!code) {\n    throw new CartActionError(`Intent \"${intent}\" requires a \"discountCode\" field.`);\n  }\n  return { intent, code };\n}\n\nfunction parseAddIntent(form: FormData, merchandiseId: string): CartAction {\n  const quantity = formInt(form, \"quantity\") ?? 1;\n  const sellingPlanId = formString(form, \"sellingPlanId\");\n\n  const line: CartLineAddInput = { merchandiseId, quantity };\n  if (sellingPlanId) line.sellingPlanId = sellingPlanId;\n\n  return { intent: \"add\", lines: [line] };\n}\n\nfunction parseNoteIntent(form: FormData): CartAction {\n  const noteValue = form.get(\"note\");\n  if (noteValue === null) {\n    throw new CartActionError('Intent \"note-update\" requires a \"note\" field.');\n  }\n  return { intent: \"note-update\", note: String(noteValue) };\n}\n\nfunction parseAttributesIntent(form: FormData): CartAction {\n  return {\n    intent: \"attributes-update\",\n    attributes: parseAttributes(getCartAttributeFormEntries(form)),\n  };\n}\n\nfunction parseAttributes(values: unknown[]): CartAttributeInput[] {\n  return values.map((value, index) => {\n    assertObject(value);\n    assertString(value.key, `attributes[${index}].key`);\n    assertString(value.value, `attributes[${index}].value`);\n    if (!value.key) {\n      throw new CartActionError(`Expected \"attributes[${index}].key\" not to be empty.`);\n    }\n    return { key: value.key, value: value.value };\n  });\n}\n\n// --- Assertion helpers ---\n\nfunction assertObject(value: unknown): asserts value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new CartActionError(\"Expected an object.\");\n  }\n}\n\nfunction assertString(value: unknown, label: string): asserts value is string {\n  if (typeof value !== \"string\") {\n    throw new CartActionError(`Expected \"${label}\" to be a string.`);\n  }\n}\n\nfunction assertNonNegativeInteger(value: unknown, label: string): asserts value is number {\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value < 0) {\n    throw new CartActionError(\n      `Expected \"${label}\" to be a non-negative integer, got ${JSON.stringify(value)}.`,\n    );\n  }\n}\n\n// --- FormData field helpers ---\n\nfunction formString(form: FormData, key: string): string | null {\n  const value = form.get(key);\n  if (value === null || typeof value !== \"string\") return null;\n  return value || null;\n}\n\nfunction formInt(form: FormData, key: string): number | null {\n  const raw = form.get(key);\n  if (raw === null || typeof raw !== \"string\") return null;\n  const parsed = parseInt(raw, 10);\n  if (Number.isNaN(parsed)) return null;\n  return parsed;\n}\n"],"mappings":"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"}

package/dist/core/cart/attach-quantity-input.d.mts

@@ -0,0 +1,5 @@
+//#region src/core/cart/attach-quantity-input.d.ts
+declare function attachQuantityInput(inputEl: HTMLInputElement, formEl: HTMLFormElement): () => void;
+//#endregion
+export { attachQuantityInput };
+//# sourceMappingURL=attach-quantity-input.d.mts.map

package/dist/core/cart/attach-quantity-input.mjs

@@ -0,0 +1,17 @@
+//#region src/core/cart/attach-quantity-input.ts
+const FIRST_SUBMIT_BUTTON_SELECTOR = "button:not([type=button])";
+function attachQuantityInput(inputEl, formEl) {
+	const firstSubmitButton = formEl.querySelector(FIRST_SUBMIT_BUTTON_SELECTOR);
+	if (!firstSubmitButton || firstSubmitButton.name !== "intent" || firstSubmitButton.value !== "set") throw new Error(`The first button in cart form must have a name of "intent" and value of "set". Your UI will not behave as expected.`, { cause: formEl });
+	const handleChange = (e) => {
+		if (formEl.isConnected && e.target === inputEl) formEl.requestSubmit(firstSubmitButton);
+	};
+	inputEl.addEventListener("change", handleChange);
+	return () => {
+		inputEl.removeEventListener("change", handleChange);
+	};
+}
+
+//#endregion
+export { attachQuantityInput };
+//# sourceMappingURL=attach-quantity-input.mjs.map

package/dist/core/cart/attach-quantity-input.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-quantity-input.mjs","names":[],"sources":["../../../src/core/cart/attach-quantity-input.ts"],"sourcesContent":["const FIRST_SUBMIT_BUTTON_SELECTOR = \"button:not([type=button])\";\n\nexport function attachQuantityInput(\n  inputEl: HTMLInputElement,\n  formEl: HTMLFormElement,\n): () => void {\n  const firstSubmitButton = formEl.querySelector(\n    FIRST_SUBMIT_BUTTON_SELECTOR,\n  ) as HTMLButtonElement | null;\n\n  if (\n    !firstSubmitButton ||\n    firstSubmitButton.name !== \"intent\" ||\n    firstSubmitButton.value !== \"set\"\n  ) {\n    throw new Error(\n      `The first button in cart form must have a name of \"intent\" and value of \"set\". Your UI will not behave as expected.`,\n      { cause: formEl },\n    );\n  }\n\n  const handleChange = (e: Event) => {\n    if (formEl.isConnected && e.target === inputEl) {\n      formEl.requestSubmit(firstSubmitButton);\n    }\n  };\n\n  inputEl.addEventListener(\"change\", handleChange);\n\n  return () => {\n    inputEl.removeEventListener(\"change\", handleChange);\n  };\n}\n"],"mappings":";AAAA,MAAM,+BAA+B;AAErC,SAAgB,oBACd,SACA,QACY;CACZ,MAAM,oBAAoB,OAAO,cAC/B,6BACD;AAED,KACE,CAAC,qBACD,kBAAkB,SAAS,YAC3B,kBAAkB,UAAU,MAE5B,OAAM,IAAI,MACR,uHACA,EAAE,OAAO,QAAQ,CAClB;CAGH,MAAM,gBAAgB,MAAa;AACjC,MAAI,OAAO,eAAe,EAAE,WAAW,QACrC,QAAO,cAAc,kBAAkB;;AAI3C,SAAQ,iBAAiB,UAAU,aAAa;AAEhD,cAAa;AACX,UAAQ,oBAAoB,UAAU,aAAa"}

package/dist/core/cart/buyer-identity-sync.d.mts

@@ -0,0 +1,23 @@
+import { StorefrontClient } from "../../client/types.mjs";
+//#region src/core/cart/buyer-identity-sync.d.ts
+declare const cartBuyerIdentitySync: unique symbol;
+type CartBuyerIdentitySyncContext = {
+  request: Request;
+  storefrontClient: StorefrontClient;
+};
+/**
+ * Capability attached by `createCartServerHandlers({customerSession})` and
+ * consumed by `createCustomerAccountServerHandlers({cartServerHandlers})` to
+ * keep the browser cart's buyer identity in step with the customer session.
+ */
+type CartBuyerIdentitySync = {
+  /** Attaches (token) or detaches (null) the customer on the request's cart cookie. */updateBuyerIdentity(context: CartBuyerIdentitySyncContext, customerAccessToken: string | null): Promise<void>; /** Set-Cookie value that expires the cart cookie, for fail-safe logout cleanup. */
+  readonly expiredCartCookie: string;
+};
+/** Cart server handlers capable of buyer identity sync. */
+type CartBuyerIdentitySyncSource = {
+  readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;
+};
+//#endregion
+export { CartBuyerIdentitySync, CartBuyerIdentitySyncSource, cartBuyerIdentitySync };
+//# sourceMappingURL=buyer-identity-sync.d.mts.map

package/dist/core/cart/buyer-identity-sync.mjs

@@ -0,0 +1,9 @@
+//#region src/core/cart/buyer-identity-sync.ts
+const cartBuyerIdentitySync = Symbol("hydrogen.cartBuyerIdentitySync");
+function getCartBuyerIdentitySync(source) {
+	return source[cartBuyerIdentitySync];
+}
+
+//#endregion
+export { cartBuyerIdentitySync, getCartBuyerIdentitySync };
+//# sourceMappingURL=buyer-identity-sync.mjs.map

package/dist/core/cart/buyer-identity-sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer-identity-sync.mjs","names":[],"sources":["../../../src/core/cart/buyer-identity-sync.ts"],"sourcesContent":["import type { StorefrontClient } from \"../../client\";\n\n// Deliberately a tiny standalone module: customer-account handlers import it at\n// runtime, so it must not pull the cart handler graph into their bundle.\nexport const cartBuyerIdentitySync: unique symbol = Symbol(\"hydrogen.cartBuyerIdentitySync\");\n\nexport type CartBuyerIdentitySyncContext = {\n  request: Request;\n  storefrontClient: StorefrontClient;\n};\n\n/**\n * Capability attached by `createCartServerHandlers({customerSession})` and\n * consumed by `createCustomerAccountServerHandlers({cartServerHandlers})` to\n * keep the browser cart's buyer identity in step with the customer session.\n */\nexport type CartBuyerIdentitySync = {\n  /** Attaches (token) or detaches (null) the customer on the request's cart cookie. */\n  updateBuyerIdentity(\n    context: CartBuyerIdentitySyncContext,\n    customerAccessToken: string | null,\n  ): Promise<void>;\n  /** Set-Cookie value that expires the cart cookie, for fail-safe logout cleanup. */\n  readonly expiredCartCookie: string;\n};\n\n/** Cart server handlers capable of buyer identity sync. */\nexport type CartBuyerIdentitySyncSource = {\n  readonly [cartBuyerIdentitySync]: CartBuyerIdentitySync;\n};\n\n// Accepts a partial source because JavaScript callers can pass cart handlers\n// created without customerSession; the caller turns undefined into an error.\nexport function getCartBuyerIdentitySync(\n  source: Partial<CartBuyerIdentitySyncSource>,\n): CartBuyerIdentitySync | undefined {\n  return source[cartBuyerIdentitySync];\n}\n"],"mappings":";AAIA,MAAa,wBAAuC,OAAO,iCAAiC;AA6B5F,SAAgB,yBACd,QACmC;AACnC,QAAO,OAAO"}

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

@@ -0,0 +1,37 @@
+import { CartData, CartState } from "./state.mjs";
+
+//#region src/core/cart/cart.d.ts
+declare const STANDARD_ACTION_TIMEOUT_IN_MS = 30000;
+declare class CartNetworkError extends Error {
+  readonly status: number;
+  constructor(status: number);
+}
+type CartStore = {
+  connect(): void;
+  destroy(): void;
+  hydrate(data: CartData): void;
+  getState(): CartState;
+  subscribe(listener: (state: CartState) => void): () => void;
+  fetch(): Promise<void>;
+  /**
+   * Reconciles the cart after an out-of-band mutation: revalidates the current
+   * cart, or loads one when none is present yet (e.g. just created server-side).
+   */
+  refresh(): void;
+  reset(): void;
+  handleFormSubmit(event: SubmitEvent, eventDetail?: Record<string, unknown>): Promise<void>;
+};
+type CartInitialData<TData extends CartData = CartData> = {
+  cart: TData | null;
+  errors?: Array<{
+    message: string;
+  }>;
+};
+type CreateCartStoreOptions<TData extends CartData = CartData> = {
+  initialData?: CartInitialData<TData> | PromiseLike<CartInitialData<TData>>;
+};
+declare function createCartStore<TData extends CartData = CartData>(options?: CreateCartStoreOptions<TData>): CartStore;
+declare function configureCartEndpoint(endpoint: string): void;
+//#endregion
+export { CartNetworkError, CartStore, CreateCartStoreOptions, STANDARD_ACTION_TIMEOUT_IN_MS, configureCartEndpoint, createCartStore };
+//# sourceMappingURL=cart.d.mts.map