@vtex/faststore 0.0.7 → 0.0.10

package/dist/sdk/address/schema.js

@@ -0,0 +1,14 @@
+import { COUNTRY_FIELDS } from "./constants.js";
+//#region src/sdk/address/schema.ts
+/** The library only knows the seven country fields. Its state holds strings, never `null`. */
+function toFormValues(values) {
+	return Object.fromEntries(COUNTRY_FIELDS.map((name) => [name, values[name] ?? ""]));
+}
+/** The maximum length the library declares for a field, if it declares one. */
+function declaredMaxLength({ validation, maxLength }) {
+	return validation?.maxLength?.value ?? maxLength;
+}
+//#endregion
+export { declaredMaxLength, toFormValues };
+
+//# sourceMappingURL=schema.js.map

package/dist/sdk/address/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/sdk/address/schema.ts"],"sourcesContent":["import type { FieldDefinition, FormValues } from '@vtex/country-forms';\nimport { COUNTRY_FIELDS } from './constants.js';\nimport type { AddressValues } from './types.js';\n\n/** The library only knows the seven country fields. Its state holds strings, never `null`. */\nexport function toFormValues(values: AddressValues): FormValues {\n  return Object.fromEntries(COUNTRY_FIELDS.map((name) => [name, values[name] ?? '']));\n}\n\n/** The maximum length the library declares for a field, if it declares one. */\nexport function declaredMaxLength({ validation, maxLength }: FieldDefinition): number | undefined {\n  return validation?.maxLength?.value ?? maxLength;\n}\n"],"mappings":";;;AAKA,SAAgB,aAAa,QAAmC;CAC9D,OAAO,OAAO,YAAY,eAAe,KAAK,SAAS,CAAC,MAAM,OAAO,SAAS,EAAE,CAAC,CAAC;AACpF;;AAGA,SAAgB,kBAAkB,EAAE,YAAY,aAAkD;CAChG,OAAO,YAAY,WAAW,SAAS;AACzC"}

package/dist/sdk/address/server-fields.js

@@ -0,0 +1,25 @@
+//#region src/sdk/address/server-fields.ts
+/** The `CustomerAddressField` values the server names a refused field with, except `COUNTRY`. */
+const FIELD_NAMES = /* @__PURE__ */ new Map([
+	["RECIPIENT_NAME", "recipientName"],
+	["STREET", "street"],
+	["NUMBER", "number"],
+	["COMPLEMENT", "complement"],
+	["NEIGHBORHOOD", "neighborhood"],
+	["CITY", "city"],
+	["STATE", "state"],
+	["POSTAL_CODE", "postalCode"],
+	["REFERENCE", "reference"]
+]);
+/**
+* The form field a server `CustomerAddressUserError.field` refers to. `null` for `COUNTRY` (the
+* form never edits it), for a failure about the address as a whole, and for a name this version
+* does not know, so a caller treats all three the same way: no field to mark.
+*/
+function toAddressFieldName(field) {
+	return field === null ? null : FIELD_NAMES.get(field) ?? null;
+}
+//#endregion
+export { toAddressFieldName };
+
+//# sourceMappingURL=server-fields.js.map

package/dist/sdk/address/server-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fields.js","names":[],"sources":["../../../src/sdk/address/server-fields.ts"],"sourcesContent":["import type { AddressFieldName } from './types.js';\n\n/** The `CustomerAddressField` values the server names a refused field with, except `COUNTRY`. */\nconst FIELD_NAMES: ReadonlyMap<string, AddressFieldName> = new Map([\n  ['RECIPIENT_NAME', 'recipientName'],\n  ['STREET', 'street'],\n  ['NUMBER', 'number'],\n  ['COMPLEMENT', 'complement'],\n  ['NEIGHBORHOOD', 'neighborhood'],\n  ['CITY', 'city'],\n  ['STATE', 'state'],\n  ['POSTAL_CODE', 'postalCode'],\n  ['REFERENCE', 'reference'],\n]);\n\n/**\n * The form field a server `CustomerAddressUserError.field` refers to. `null` for `COUNTRY` (the\n * form never edits it), for a failure about the address as a whole, and for a name this version\n * does not know, so a caller treats all three the same way: no field to mark.\n */\nexport function toAddressFieldName(field: string | null): AddressFieldName | null {\n  return field === null ? null : (FIELD_NAMES.get(field) ?? null);\n}\n"],"mappings":";;AAGA,MAAM,8BAAqD,IAAI,IAAI;CACjE,CAAC,kBAAkB,eAAe;CAClC,CAAC,UAAU,QAAQ;CACnB,CAAC,UAAU,QAAQ;CACnB,CAAC,cAAc,YAAY;CAC3B,CAAC,gBAAgB,cAAc;CAC/B,CAAC,QAAQ,MAAM;CACf,CAAC,SAAS,OAAO;CACjB,CAAC,eAAe,YAAY;CAC5B,CAAC,aAAa,WAAW;AAC3B,CAAC;;;;;;AAOD,SAAgB,mBAAmB,OAA+C;CAChF,OAAO,UAAU,OAAO,OAAQ,YAAY,IAAI,KAAK,KAAK;AAC5D"}

package/dist/sdk/address/switch-country.js

@@ -0,0 +1,57 @@
+import { ACCOUNT_FIELDS, COUNTRY_FIELDS, isCountryField } from "./constants.js";
+import { validateAddress } from "./validate-address.js";
+//#region src/sdk/address/switch-country.ts
+function isBlank(value) {
+	return value === null || value === void 0 || value.trim() === "";
+}
+/** The old country's field order, then any field it does not declare, in the default order. */
+function fieldOrder({ schema }) {
+	const declared = schema.fields.flatMap(({ name }) => isCountryField(name) ? [name] : []);
+	return [...declared, ...COUNTRY_FIELDS.filter((field) => !declared.includes(field))];
+}
+/**
+* Works out what a draft keeps when the shopper changes country. `recipientName`, `reference`, and
+* `name` always stay. A country field stays when the new country declares it, its value passes the
+* new country's rules, and the field it depends on (a city on its state) stays too. Any other
+* non-empty value goes to `setAside`. To go back to the first country, pass `{ ...values, ...setAside }`
+* as the draft: those values pass its rules again, so they return.
+*/
+function switchCountry(draft, from, to) {
+	const values = {};
+	const setAside = {};
+	for (const name of ACCOUNT_FIELDS) {
+		const value = draft[name];
+		if (!isBlank(value)) values[name] = value ?? "";
+	}
+	const declared = new Map(to.schema.fields.map((field) => [field.name, field]));
+	const present = fieldOrder(from).filter((name) => !isBlank(draft[name]));
+	const carried = present.filter((name) => declared.has(name));
+	const errors = validateAddress(Object.fromEntries(carried.map((name) => [name, draft[name]])), to);
+	const fitting = new Set(carried.filter((name) => !errors[name]));
+	let dropped = true;
+	while (dropped) {
+		dropped = false;
+		for (const name of fitting) {
+			const controller = declared.get(name)?.dependsOn;
+			if (controller !== void 0 && !fitting.has(controller)) {
+				fitting.delete(name);
+				dropped = true;
+			}
+		}
+	}
+	const notCarried = [];
+	for (const name of present) if (fitting.has(name)) values[name] = draft[name] ?? "";
+	else {
+		setAside[name] = draft[name] ?? "";
+		notCarried.push(name);
+	}
+	return {
+		values,
+		setAside,
+		notCarried
+	};
+}
+//#endregion
+export { switchCountry };
+
+//# sourceMappingURL=switch-country.js.map

package/dist/sdk/address/switch-country.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-country.js","names":[],"sources":["../../../src/sdk/address/switch-country.ts"],"sourcesContent":["import { ACCOUNT_FIELDS, COUNTRY_FIELDS, isCountryField } from './constants.js';\nimport type { AddressFieldName, AddressValues, CountryFieldName, CountryRules, CountrySwitch } from './types.js';\nimport { validateAddress } from './validate-address.js';\n\nfunction isBlank(value: string | null | undefined): boolean {\n  return value === null || value === undefined || value.trim() === '';\n}\n\n/** The old country's field order, then any field it does not declare, in the default order. */\nfunction fieldOrder({ schema }: CountryRules): readonly CountryFieldName[] {\n  const declared = schema.fields.flatMap(({ name }) => (isCountryField(name) ? [name] : []));\n  return [...declared, ...COUNTRY_FIELDS.filter((field) => !declared.includes(field))];\n}\n\n/**\n * Works out what a draft keeps when the shopper changes country. `recipientName`, `reference`, and\n * `name` always stay. A country field stays when the new country declares it, its value passes the\n * new country's rules, and the field it depends on (a city on its state) stays too. Any other\n * non-empty value goes to `setAside`. To go back to the first country, pass `{ ...values, ...setAside }`\n * as the draft: those values pass its rules again, so they return.\n */\nexport function switchCountry(draft: AddressValues, from: CountryRules, to: CountryRules): CountrySwitch {\n  const values: Partial<Record<AddressFieldName, string>> = {};\n  const setAside: Partial<Record<AddressFieldName, string>> = {};\n\n  for (const name of ACCOUNT_FIELDS) {\n    const value = draft[name];\n    if (!isBlank(value)) {\n      values[name] = value ?? '';\n    }\n  }\n\n  const declared = new Map(to.schema.fields.map((field) => [field.name, field]));\n  const present = fieldOrder(from).filter((name) => !isBlank(draft[name]));\n  const carried = present.filter((name) => declared.has(name));\n  const errors = validateAddress(Object.fromEntries(carried.map((name) => [name, draft[name]])), to);\n\n  const fitting = new Set<string>(carried.filter((name) => !errors[name]));\n  let dropped = true;\n  while (dropped) {\n    dropped = false;\n    for (const name of fitting) {\n      const controller = declared.get(name)?.dependsOn;\n      if (controller !== undefined && !fitting.has(controller)) {\n        fitting.delete(name);\n        dropped = true;\n      }\n    }\n  }\n\n  const notCarried: AddressFieldName[] = [];\n  for (const name of present) {\n    if (fitting.has(name)) {\n      values[name] = draft[name] ?? '';\n    } else {\n      setAside[name] = draft[name] ?? '';\n      notCarried.push(name);\n    }\n  }\n\n  return { values, setAside, notCarried };\n}\n"],"mappings":";;;AAIA,SAAS,QAAQ,OAA2C;CAC1D,OAAO,UAAU,QAAQ,UAAU,KAAA,KAAa,MAAM,KAAK,MAAM;AACnE;;AAGA,SAAS,WAAW,EAAE,UAAqD;CACzE,MAAM,WAAW,OAAO,OAAO,SAAS,EAAE,WAAY,eAAe,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CAAE;CACzF,OAAO,CAAC,GAAG,UAAU,GAAG,eAAe,QAAQ,UAAU,CAAC,SAAS,SAAS,KAAK,CAAC,CAAC;AACrF;;;;;;;;AASA,SAAgB,cAAc,OAAsB,MAAoB,IAAiC;CACvG,MAAM,SAAoD,CAAC;CAC3D,MAAM,WAAsD,CAAC;CAE7D,KAAK,MAAM,QAAQ,gBAAgB;EACjC,MAAM,QAAQ,MAAM;EACpB,IAAI,CAAC,QAAQ,KAAK,GAChB,OAAO,QAAQ,SAAS;CAE5B;CAEA,MAAM,WAAW,IAAI,IAAI,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CAC7E,MAAM,UAAU,WAAW,IAAI,CAAC,CAAC,QAAQ,SAAS,CAAC,QAAQ,MAAM,KAAK,CAAC;CACvE,MAAM,UAAU,QAAQ,QAAQ,SAAS,SAAS,IAAI,IAAI,CAAC;CAC3D,MAAM,SAAS,gBAAgB,OAAO,YAAY,QAAQ,KAAK,SAAS,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,EAAE;CAEjG,MAAM,UAAU,IAAI,IAAY,QAAQ,QAAQ,SAAS,CAAC,OAAO,KAAK,CAAC;CACvE,IAAI,UAAU;CACd,OAAO,SAAS;EACd,UAAU;EACV,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,aAAa,SAAS,IAAI,IAAI,CAAC,EAAE;GACvC,IAAI,eAAe,KAAA,KAAa,CAAC,QAAQ,IAAI,UAAU,GAAG;IACxD,QAAQ,OAAO,IAAI;IACnB,UAAU;GACZ;EACF;CACF;CAEA,MAAM,aAAiC,CAAC;CACxC,KAAK,MAAM,QAAQ,SACjB,IAAI,QAAQ,IAAI,IAAI,GAClB,OAAO,QAAQ,MAAM,SAAS;MACzB;EACL,SAAS,QAAQ,MAAM,SAAS;EAChC,WAAW,KAAK,IAAI;CACtB;CAGF,OAAO;EAAE;EAAQ;EAAU;CAAW;AACxC"}

package/dist/sdk/address/types.d.ts

@@ -0,0 +1,26 @@
+import { MessageId } from "../i18n/locales.js";
+import "../i18n/client.js";
+import { FormSchema } from "@vtex/country-forms";
+//#region src/sdk/address/types.d.ts
+/** The seven fields `@vtex/country-forms` address schemas declare, spelled as on `CustomerAddress`. */
+export type CountryFieldName = 'postalCode' | 'street' | 'number' | 'complement' | 'neighborhood' | 'state' | 'city';
+/** Fields no country declares; the account's own rules cover them. `name` is the shopper's label. */
+export type AccountFieldName = 'recipientName' | 'reference' | 'name';
+export type AddressFieldName = CountryFieldName | AccountFieldName;
+export type AddressErrorCode = 'required' | 'invalid' | 'tooLong';
+export type AddressFieldError = Readonly<{
+  code: AddressErrorCode;
+  messageId: MessageId;
+  /** The values the message interpolates, such as `{ maxLength: 750 }` or `{ example: '01310-100' }`. */
+  values?: Readonly<Record<string, string | number>>;
+}>;
+export type CountryRules = Readonly<{
+  /** ISO 3166-1 alpha-3, upper case. */
+  country: string;
+  /** In the library's list of address countries. `false` means the library's fallback form. */
+  covered: boolean;
+  /** Read only by this module. */
+  schema: FormSchema;
+}>;
+//#endregion
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/address/use-address-actions.d.ts

@@ -0,0 +1,29 @@
+import "../../core/dist/index.js";
+import { AddressCreatePayload, AddressRemovePayload, AddressUpdatePayload, CustomerAddressUserError } from "./operations.js";
+//#region src/sdk/address/use-address-actions.d.ts
+/**
+ * The `address` action namespace: the one sanctioned client write surface for the shopper's saved
+ * addresses (docs/storefront-core/adr-0010-actions-own-the-write-side.md,
+ * docs/features/my-account-address-book/rfc.md § Address actions).
+ *
+ * Every method is async and pessimistic: the cache changes only after the server answers. Each
+ * resolves to the payload's `userErrors` (empty on success), with their `field`, so the caller can
+ * mark the field. None rejects for an expected outcome. ADR-0010 has handlers surface `userErrors`
+ * through the `notifications` action; that action does not exist yet, so the caller presents them.
+ */
+export type AddressActions = Readonly<{
+  /** Save a new address. Appends it to the cached address book on success. Never rejects. */
+  create: (payload: AddressCreatePayload) => Promise<readonly CustomerAddressUserError[]>;
+  /**
+   * Change a saved address. Omit a field to keep it; an empty string erases it. Subscribers update
+   * through the normalized cache. Never rejects.
+   */
+  update: (payload: AddressUpdatePayload) => Promise<readonly CustomerAddressUserError[]>;
+  /**
+   * Remove a saved address. The list changes only once the server confirms. A `NOT_FOUND` answer
+   * means the server no longer has it, so it leaves the cache too. Never rejects.
+   */
+  remove: (payload: AddressRemovePayload) => Promise<readonly CustomerAddressUserError[]>;
+}>;
+//#endregion
+//# sourceMappingURL=use-address-actions.d.ts.map

package/dist/sdk/address/use-address-actions.js

@@ -0,0 +1,247 @@
+"use client";
+import { defineActions } from "../../core/dist/actions/registry.js";
+import "../../core/dist/index.js";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { CUSTOMER_ADDRESS_BOOK_IDENTITY, CUSTOMER_ADDRESS_CREATE, CUSTOMER_ADDRESS_DELETE, CUSTOMER_ADDRESS_UPDATE } from "./operations.js";
+import { useMutation } from "@apollo/client/react";
+import { useCallback, useMemo } from "react";
+import { CombinedGraphQLErrors } from "@apollo/client/errors";
+//#region src/sdk/address/use-address-actions.ts
+const NETWORK_ERROR = {
+	code: "NETWORK_ERROR",
+	message: "Unable to complete the request. Please try again.",
+	field: null
+};
+const UNAUTHORIZED_ERROR = {
+	code: "UNAUTHORIZED",
+	message: "Your session has expired. Please sign in again.",
+	field: null
+};
+/**
+* The writes answer an expired session with a top-level `UNAUTHORIZED`, never a `userError`.
+* Collapsing it into `NETWORK_ERROR` would offer a retry that cannot succeed, so it keeps its own
+* code and the caller can send the shopper back to sign-in.
+*/
+function toUserError(error) {
+	if (CombinedGraphQLErrors.is(error) && error.errors.some(({ extensions }) => extensions?.code === "UNAUTHORIZED")) return UNAUTHORIZED_ERROR;
+	return NETWORK_ERROR;
+}
+/**
+* Takes the address out of the cached address book, then evicts its entity. Apollo hides a dangling
+* reference when it reads a list, so the evict alone would empty the visible list; the explicit edit
+* keeps the stored array free of references to an entity that is gone. With no book cached, only the
+* evict runs.
+*/
+function dropAddress(cache, id) {
+	const book = cache.readQuery({ query: CUSTOMER_ADDRESS_BOOK_IDENTITY })?.customerAddressBook;
+	if (book) cache.modify({
+		id: cache.identify(book),
+		fields: { addresses(existing, { readField }) {
+			return existing.filter((reference) => readField("id", reference) !== id);
+		} }
+	});
+	cache.evict({ id: cache.identify({
+		__typename: "CustomerAddress",
+		id
+	}) });
+}
+/** True when the server says the address is not among the shopper's own: gone, or never theirs. */
+function isNotFound(userErrors) {
+	return userErrors?.some(({ code }) => code === "NOT_FOUND") ?? false;
+}
+/**
+* The `address` namespace hook. Registered with the first-party action registry via `addressActions`
+* below; the compiler-emitted `AddressActionProvider` calls it and threads the narrowed methods into
+* each consumer's `$actions.address`.
+*/
+function useAddressActions() {
+	const [createMutation] = useMutation(CUSTOMER_ADDRESS_CREATE, { update(cache, { data }) {
+		const address = data?.customerAddressCreate.customerAddress;
+		if (!address) return;
+		const book = cache.readQuery({ query: CUSTOMER_ADDRESS_BOOK_IDENTITY })?.customerAddressBook;
+		if (!book) return;
+		cache.modify({
+			id: cache.identify(book),
+			fields: { addresses(existing, { readField, toReference }) {
+				if (existing.some((reference) => readField("id", reference) === address.id)) return existing;
+				const created = toReference(address);
+				return created ? [...existing, created] : existing;
+			} }
+		});
+	} });
+	const [updateMutation] = useMutation(CUSTOMER_ADDRESS_UPDATE, { update(cache, { data }, { variables }) {
+		if (variables && isNotFound(data?.customerAddressUpdate.userErrors)) dropAddress(cache, variables.id);
+	} });
+	const [removeMutation] = useMutation(CUSTOMER_ADDRESS_DELETE, { update(cache, { data }, { variables }) {
+		const payload = data?.customerAddressDelete;
+		if (!payload) return;
+		if (payload.userErrors.length === 0 && payload.deletedCustomerAddressId) dropAddress(cache, payload.deletedCustomerAddressId);
+		else if (variables && isNotFound(payload.userErrors)) dropAddress(cache, variables.id);
+	} });
+	const create = useCallback(async (payload) => {
+		try {
+			return (await createMutation({ variables: { input: payload } })).data?.customerAddressCreate.userErrors ?? [];
+		} catch (error) {
+			console.error("[address.create] customerAddressCreate failed", loggableErrorName(error));
+			return [toUserError(error)];
+		}
+	}, [createMutation]);
+	const update = useCallback(async ({ id, ...input }) => {
+		try {
+			return (await updateMutation({ variables: {
+				id,
+				input
+			} })).data?.customerAddressUpdate.userErrors ?? [];
+		} catch (error) {
+			console.error("[address.update] customerAddressUpdate failed", loggableErrorName(error));
+			return [toUserError(error)];
+		}
+	}, [updateMutation]);
+	const remove = useCallback(async ({ id }) => {
+		try {
+			return (await removeMutation({ variables: { id } })).data?.customerAddressDelete.userErrors ?? [];
+		} catch (error) {
+			console.error("[address.remove] customerAddressDelete failed", loggableErrorName(error));
+			return [toUserError(error)];
+		}
+	}, [removeMutation]);
+	return useMemo(() => ({
+		create,
+		update,
+		remove
+	}), [
+		create,
+		update,
+		remove
+	]);
+}
+defineActions({
+	namespace: "address",
+	description: "Mutation-backed writes against the shopper's saved addresses (create, update, remove).",
+	provider: {
+		name: "AddressActionProvider",
+		importPath: "@vtex/faststore/internal/client"
+	},
+	methods: {
+		create: {
+			description: "Save a new address and add it to the cached address book (async/pessimistic). Resolves the payload userErrors.",
+			payload: [
+				{
+					name: "country",
+					type: "string"
+				},
+				{
+					name: "recipientName",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "street",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "number",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "complement",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "neighborhood",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "city",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "state",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "postalCode",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "reference",
+					type: "string",
+					optional: true
+				}
+			]
+		},
+		update: {
+			description: "Change a saved address (async/pessimistic). Omitted fields are kept; an empty string erases. Resolves the payload userErrors.",
+			payload: [
+				{
+					name: "id",
+					type: "string"
+				},
+				{
+					name: "recipientName",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "street",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "number",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "complement",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "neighborhood",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "city",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "state",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "postalCode",
+					type: "string",
+					optional: true
+				},
+				{
+					name: "reference",
+					type: "string",
+					optional: true
+				}
+			]
+		},
+		remove: {
+			description: "Remove a saved address once the server confirms (async/pessimistic). Resolves the payload userErrors.",
+			payload: [{
+				name: "id",
+				type: "string"
+			}]
+		}
+	},
+	use: useAddressActions
+});
+//#endregion
+export { useAddressActions };
+
+//# sourceMappingURL=use-address-actions.js.map

package/dist/sdk/address/use-address-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-address-actions.js","names":[],"sources":["../../../src/sdk/address/use-address-actions.ts"],"sourcesContent":["'use client';\n\nimport type { ApolloCache, Reference } from '@apollo/client';\nimport { CombinedGraphQLErrors } from '@apollo/client/errors';\nimport { useMutation } from '@apollo/client/react';\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport {\n  type AddressCreatePayload,\n  type AddressRemovePayload,\n  type AddressUpdatePayload,\n  CUSTOMER_ADDRESS_BOOK_IDENTITY,\n  CUSTOMER_ADDRESS_CREATE,\n  CUSTOMER_ADDRESS_DELETE,\n  CUSTOMER_ADDRESS_UPDATE,\n  type CustomerAddressUserError,\n} from './operations.js';\n\nexport type {\n  AddressCreatePayload,\n  AddressRemovePayload,\n  AddressUpdatePayload,\n  CustomerAddressUserError,\n} from './operations.js';\n\n/**\n * The `address` action namespace: the one sanctioned client write surface for the shopper's saved\n * addresses (docs/storefront-core/adr-0010-actions-own-the-write-side.md,\n * docs/features/my-account-address-book/rfc.md § Address actions).\n *\n * Every method is async and pessimistic: the cache changes only after the server answers. Each\n * resolves to the payload's `userErrors` (empty on success), with their `field`, so the caller can\n * mark the field. None rejects for an expected outcome. ADR-0010 has handlers surface `userErrors`\n * through the `notifications` action; that action does not exist yet, so the caller presents them.\n */\nexport type AddressActions = Readonly<{\n  /** Save a new address. Appends it to the cached address book on success. Never rejects. */\n  create: (payload: AddressCreatePayload) => Promise<readonly CustomerAddressUserError[]>;\n  /**\n   * Change a saved address. Omit a field to keep it; an empty string erases it. Subscribers update\n   * through the normalized cache. Never rejects.\n   */\n  update: (payload: AddressUpdatePayload) => Promise<readonly CustomerAddressUserError[]>;\n  /**\n   * Remove a saved address. The list changes only once the server confirms. A `NOT_FOUND` answer\n   * means the server no longer has it, so it leaves the cache too. Never rejects.\n   */\n  remove: (payload: AddressRemovePayload) => Promise<readonly CustomerAddressUserError[]>;\n}>;\n\nconst NETWORK_ERROR: CustomerAddressUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to complete the request. Please try again.',\n  field: null,\n};\n\nconst UNAUTHORIZED_ERROR: CustomerAddressUserError = {\n  code: 'UNAUTHORIZED',\n  message: 'Your session has expired. Please sign in again.',\n  field: null,\n};\n\n/**\n * The writes answer an expired session with a top-level `UNAUTHORIZED`, never a `userError`.\n * Collapsing it into `NETWORK_ERROR` would offer a retry that cannot succeed, so it keeps its own\n * code and the caller can send the shopper back to sign-in.\n */\nfunction toUserError(error: unknown): CustomerAddressUserError {\n  if (CombinedGraphQLErrors.is(error) && error.errors.some(({ extensions }) => extensions?.code === 'UNAUTHORIZED')) {\n    return UNAUTHORIZED_ERROR;\n  }\n  return NETWORK_ERROR;\n}\n\n/**\n * Takes the address out of the cached address book, then evicts its entity. Apollo hides a dangling\n * reference when it reads a list, so the evict alone would empty the visible list; the explicit edit\n * keeps the stored array free of references to an entity that is gone. With no book cached, only the\n * evict runs.\n */\nfunction dropAddress(cache: ApolloCache, id: string): void {\n  const book = cache.readQuery({ query: CUSTOMER_ADDRESS_BOOK_IDENTITY })?.customerAddressBook;\n  if (book) {\n    cache.modify({\n      id: cache.identify(book),\n      fields: {\n        addresses(existing: readonly Reference[], { readField }) {\n          return existing.filter((reference) => readField('id', reference) !== id);\n        },\n      },\n    });\n  }\n  cache.evict({ id: cache.identify({ __typename: 'CustomerAddress', id }) });\n}\n\n/** True when the server says the address is not among the shopper's own: gone, or never theirs. */\nfunction isNotFound(userErrors: readonly CustomerAddressUserError[] | undefined): boolean {\n  return userErrors?.some(({ code }) => code === 'NOT_FOUND') ?? false;\n}\n\n/**\n * The `address` namespace hook. Registered with the first-party action registry via `addressActions`\n * below; the compiler-emitted `AddressActionProvider` calls it and threads the narrowed methods into\n * each consumer's `$actions.address`.\n */\nexport function useAddressActions(): AddressActions {\n  const [createMutation] = useMutation(CUSTOMER_ADDRESS_CREATE, {\n    update(cache, { data }) {\n      const address = data?.customerAddressCreate.customerAddress;\n      if (!address) return;\n      // Read from the cache only: no mounted list means nothing to append to, and the entity the\n      // payload just normalized is all this write leaves behind.\n      const book = cache.readQuery({ query: CUSTOMER_ADDRESS_BOOK_IDENTITY })?.customerAddressBook;\n      if (!book) return;\n      cache.modify({\n        id: cache.identify(book),\n        fields: {\n          addresses(existing: readonly Reference[], { readField, toReference }) {\n            if (existing.some((reference) => readField('id', reference) === address.id)) {\n              return existing;\n            }\n            const created = toReference(address);\n            return created ? [...existing, created] : existing;\n          },\n        },\n      });\n    },\n  });\n\n  const [updateMutation] = useMutation(CUSTOMER_ADDRESS_UPDATE, {\n    update(cache, { data }, { variables }) {\n      if (variables && isNotFound(data?.customerAddressUpdate.userErrors)) dropAddress(cache, variables.id);\n    },\n  });\n\n  const [removeMutation] = useMutation(CUSTOMER_ADDRESS_DELETE, {\n    update(cache, { data }, { variables }) {\n      const payload = data?.customerAddressDelete;\n      if (!payload) return;\n      if (payload.userErrors.length === 0 && payload.deletedCustomerAddressId) {\n        dropAddress(cache, payload.deletedCustomerAddressId);\n      } else if (variables && isNotFound(payload.userErrors)) {\n        dropAddress(cache, variables.id);\n      }\n    },\n  });\n\n  const create = useCallback<AddressActions['create']>(\n    async (payload) => {\n      try {\n        const result = await createMutation({ variables: { input: payload } });\n        return result.data?.customerAddressCreate.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name: the message can echo a submitted address value (PII).\n        console.error('[address.create] customerAddressCreate failed', loggableErrorName(error));\n        return [toUserError(error)];\n      }\n    },\n    [createMutation],\n  );\n\n  const update = useCallback<AddressActions['update']>(\n    async ({ id, ...input }) => {\n      try {\n        // Forwarded unmapped: an empty string is an explicit erase and must survive to the wire.\n        const result = await updateMutation({ variables: { id, input } });\n        return result.data?.customerAddressUpdate.userErrors ?? [];\n      } catch (error) {\n        console.error('[address.update] customerAddressUpdate failed', loggableErrorName(error));\n        return [toUserError(error)];\n      }\n    },\n    [updateMutation],\n  );\n\n  const remove = useCallback<AddressActions['remove']>(\n    async ({ id }) => {\n      try {\n        const result = await removeMutation({ variables: { id } });\n        return result.data?.customerAddressDelete.userErrors ?? [];\n      } catch (error) {\n        console.error('[address.remove] customerAddressDelete failed', loggableErrorName(error));\n        return [toUserError(error)];\n      }\n    },\n    [removeMutation],\n  );\n\n  return useMemo(() => ({ create, update, remove }), [create, update, remove]);\n}\n\n/**\n * Declares the `address` action namespace: the single source of truth for its method/payload\n * metadata, runtime provider, and `use` hook. The native catalog builder\n * (`scripts/build-catalog.mjs`) statically reads this call to emit `actions.json`; at runtime\n * `AddressActionProvider` calls `useAddressActions` directly.\n */\nexport const addressActions = defineActions({\n  namespace: 'address',\n  description: \"Mutation-backed writes against the shopper's saved addresses (create, update, remove).\",\n  provider: { name: 'AddressActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    create: {\n      description:\n        'Save a new address and add it to the cached address book (async/pessimistic). Resolves the payload userErrors.',\n      payload: [\n        { name: 'country', type: 'string' },\n        { name: 'recipientName', type: 'string', optional: true },\n        { name: 'street', type: 'string', optional: true },\n        { name: 'number', type: 'string', optional: true },\n        { name: 'complement', type: 'string', optional: true },\n        { name: 'neighborhood', type: 'string', optional: true },\n        { name: 'city', type: 'string', optional: true },\n        { name: 'state', type: 'string', optional: true },\n        { name: 'postalCode', type: 'string', optional: true },\n        { name: 'reference', type: 'string', optional: true },\n      ],\n    },\n    update: {\n      description:\n        'Change a saved address (async/pessimistic). Omitted fields are kept; an empty string erases. Resolves the payload userErrors.',\n      payload: [\n        { name: 'id', type: 'string' },\n        { name: 'recipientName', type: 'string', optional: true },\n        { name: 'street', type: 'string', optional: true },\n        { name: 'number', type: 'string', optional: true },\n        { name: 'complement', type: 'string', optional: true },\n        { name: 'neighborhood', type: 'string', optional: true },\n        { name: 'city', type: 'string', optional: true },\n        { name: 'state', type: 'string', optional: true },\n        { name: 'postalCode', type: 'string', optional: true },\n        { name: 'reference', type: 'string', optional: true },\n      ],\n    },\n    remove: {\n      description:\n        'Remove a saved address once the server confirms (async/pessimistic). Resolves the payload userErrors.',\n      payload: [{ name: 'id', type: 'string' }],\n    },\n  },\n  use: useAddressActions,\n});\n"],"mappings":"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"}

package/dist/sdk/address/use-address-by-postal-code.js

@@ -0,0 +1,57 @@
+"use client";
+import { withRequestTimeout } from "../shipping/request-timeout.js";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { ADDRESS_BY_POSTAL_CODE } from "./postal-code-lookup-operations.js";
+import { getApolloContext } from "@apollo/client/react";
+import { useCallback, useContext } from "react";
+//#region src/sdk/address/use-address-by-postal-code.ts
+const FAILED = { status: "failed" };
+/**
+* Postal-code lookup SDK hook (specs/sfs-3430-address-by-postal-code.md).
+*
+* Returns a callback that runs the `AddressByPostalCode` query once per call and never rejects. It
+* reads the client from `getApolloContext()` (a non-throwing read, like `useShippingSimulation`), and
+* skips the cache: a lookup is a shopper's postal code, so it is neither read from nor written to the
+* normalized cache. The hook does not check `hasPostalCodeLookup(country)`; the caller decides
+* whether a country is worth a request, and when to ask and which reply is stale.
+*
+* A failure logs the error's name, as the address actions do, and never the country, the postal
+* code, or a message.
+*/
+function useAddressByPostalCode() {
+	const { client } = useContext(getApolloContext());
+	return useCallback(async ({ country, postalCode }) => {
+		try {
+			if (!client) throw new Error("No Apollo client is available.");
+			const result = await withRequestTimeout((signal) => client.query({
+				query: ADDRESS_BY_POSTAL_CODE,
+				variables: {
+					country,
+					postalCode
+				},
+				fetchPolicy: "no-cache",
+				context: { fetchOptions: { signal } }
+			}));
+			if (result.error) throw result.error;
+			if (!result.data) throw new Error("The lookup returned no data.");
+			const address = result.data.addressByPostalCode;
+			if (!address) return { status: "notFound" };
+			return {
+				status: "found",
+				address: {
+					city: address.city ?? null,
+					state: address.state ?? null,
+					street: address.street ?? null,
+					neighborhood: address.neighborhood ?? null
+				}
+			};
+		} catch (error) {
+			console.error("[address.postalCodeLookup] addressByPostalCode failed", loggableErrorName(error));
+			return FAILED;
+		}
+	}, [client]);
+}
+//#endregion
+export { useAddressByPostalCode };
+
+//# sourceMappingURL=use-address-by-postal-code.js.map

package/dist/sdk/address/use-address-by-postal-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-address-by-postal-code.js","names":[],"sources":["../../../src/sdk/address/use-address-by-postal-code.ts"],"sourcesContent":["'use client';\n\nimport { getApolloContext } from '@apollo/client/react';\nimport { useCallback, useContext } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { withRequestTimeout } from '../shipping/request-timeout.js';\nimport { ADDRESS_BY_POSTAL_CODE } from './postal-code-lookup-operations.js';\n\n/**\n * The fields the platform resolves for a postal code. Each is `null` where the platform left it\n * blank, and the state is as the platform codes it, so it may not match a select's option values.\n */\nexport type PostalCodeLookupFields = Readonly<{\n  city: string | null;\n  state: string | null;\n  street: string | null;\n  neighborhood: string | null;\n}>;\n\n/**\n * The three things a lookup can come to. `notFound` is a code the platform does not know; `failed`\n * is a lookup that could not run (no client, a GraphQL error, a transport error, a timeout). The two\n * never look alike, so a caller can show an outage differently from a typo.\n */\nexport type PostalCodeLookupResult =\n  | Readonly<{ status: 'found'; address: PostalCodeLookupFields }>\n  | Readonly<{ status: 'notFound' }>\n  | Readonly<{ status: 'failed' }>;\n\nconst FAILED: PostalCodeLookupResult = { status: 'failed' };\n\n/**\n * Postal-code lookup SDK hook (specs/sfs-3430-address-by-postal-code.md).\n *\n * Returns a callback that runs the `AddressByPostalCode` query once per call and never rejects. It\n * reads the client from `getApolloContext()` (a non-throwing read, like `useShippingSimulation`), and\n * skips the cache: a lookup is a shopper's postal code, so it is neither read from nor written to the\n * normalized cache. The hook does not check `hasPostalCodeLookup(country)`; the caller decides\n * whether a country is worth a request, and when to ask and which reply is stale.\n *\n * A failure logs the error's name, as the address actions do, and never the country, the postal\n * code, or a message.\n */\nexport function useAddressByPostalCode(): (input: {\n  country: string;\n  postalCode: string;\n}) => Promise<PostalCodeLookupResult> {\n  const { client } = useContext(getApolloContext());\n\n  return useCallback(\n    async ({ country, postalCode }): Promise<PostalCodeLookupResult> => {\n      try {\n        if (!client) {\n          throw new Error('No Apollo client is available.');\n        }\n        const result = await withRequestTimeout((signal) =>\n          client.query({\n            query: ADDRESS_BY_POSTAL_CODE,\n            variables: { country, postalCode },\n            fetchPolicy: 'no-cache',\n            context: { fetchOptions: { signal } },\n          }),\n        );\n\n        if (result.error) {\n          throw result.error;\n        }\n        if (!result.data) {\n          throw new Error('The lookup returned no data.');\n        }\n\n        const address = result.data.addressByPostalCode;\n        if (!address) {\n          return { status: 'notFound' };\n        }\n        return {\n          status: 'found',\n          address: {\n            city: address.city ?? null,\n            state: address.state ?? null,\n            street: address.street ?? null,\n            neighborhood: address.neighborhood ?? null,\n          },\n        };\n      } catch (error) {\n        console.error('[address.postalCodeLookup] addressByPostalCode failed', loggableErrorName(error));\n        return FAILED;\n      }\n    },\n    [client],\n  );\n}\n"],"mappings":";;;;;;;AA6BA,MAAM,SAAiC,EAAE,QAAQ,SAAS;;;;;;;;;;;;;AAc1D,SAAgB,yBAGsB;CACpC,MAAM,EAAE,WAAW,WAAW,iBAAiB,CAAC;CAEhD,OAAO,YACL,OAAO,EAAE,SAAS,iBAAkD;EAClE,IAAI;GACF,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,gCAAgC;GAElD,MAAM,SAAS,MAAM,oBAAoB,WACvC,OAAO,MAAM;IACX,OAAO;IACP,WAAW;KAAE;KAAS;IAAW;IACjC,aAAa;IACb,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE;GACtC,CAAC,CACH;GAEA,IAAI,OAAO,OACT,MAAM,OAAO;GAEf,IAAI,CAAC,OAAO,MACV,MAAM,IAAI,MAAM,8BAA8B;GAGhD,MAAM,UAAU,OAAO,KAAK;GAC5B,IAAI,CAAC,SACH,OAAO,EAAE,QAAQ,WAAW;GAE9B,OAAO;IACL,QAAQ;IACR,SAAS;KACP,MAAM,QAAQ,QAAQ;KACtB,OAAO,QAAQ,SAAS;KACxB,QAAQ,QAAQ,UAAU;KAC1B,cAAc,QAAQ,gBAAgB;IACxC;GACF;EACF,SAAS,OAAO;GACd,QAAQ,MAAM,yDAAyD,kBAAkB,KAAK,CAAC;GAC/F,OAAO;EACT;CACF,GACA,CAAC,MAAM,CACT;AACF"}

package/dist/sdk/address/validate-address.js

@@ -0,0 +1,62 @@
+import { ACCOUNT_MAX_LENGTH } from "./constants.js";
+import { resolveLibraryError } from "./messages.js";
+import { declaredMaxLength, toFormValues } from "./schema.js";
+import { createFormState, getVisibleFields, resolveFieldOptions, validate } from "@vtex/country-forms";
+//#region src/sdk/address/validate-address.ts
+const REQUIRED = {
+	code: "required",
+	messageId: "fs/address.error.required"
+};
+const INVALID = {
+	code: "invalid",
+	messageId: "fs/address.error.invalid"
+};
+function isAddressField(name) {
+	return Object.hasOwn(ACCOUNT_MAX_LENGTH, name);
+}
+function isOutsideOptions(field, values, fields) {
+	const value = values[field.name] ?? "";
+	if (field.type !== "select" || value === "") return false;
+	const controller = fields.find(({ name }) => name === field.dependsOn);
+	if (controller && ((values[controller.name] ?? "") === "" || isOutsideOptions(controller, values, fields))) return false;
+	return !(resolveFieldOptions(field, values) ?? []).some((option) => option.value === value);
+}
+/**
+* Checks a draft or a stored address against its country's rules and the account's own rules, and
+* returns at most one error per field. A field's first error wins, in this order: the library's,
+* a select value outside its options, then the account's maximum length.
+*
+* The account's rules cover what the library does not: `recipientName` must not be blank,
+* `reference` and the address name may be empty, every free-text field has a maximum length, and a
+* select's value must be one of the options the library resolves. Keys outside the ten address
+* fields are ignored, so a merged record can carry `geoCoordinate` as it is.
+*/
+function validateAddress(values, rules) {
+	const text = toFormValues(values);
+	const fields = getVisibleFields(rules.schema, text);
+	const errors = {};
+	const declared = new Map(rules.schema.fields.map((field) => [field.name, field]));
+	const libraryErrors = validate(createFormState(rules.schema, text), rules.schema);
+	for (const [name, key] of Object.entries(libraryErrors)) {
+		const field = declared.get(name);
+		if (isAddressField(name) && field) errors[name] = resolveLibraryError(key, {
+			country: rules.country,
+			maxLength: declaredMaxLength(field)
+		});
+	}
+	for (const field of fields) if (isAddressField(field.name) && !errors[field.name] && isOutsideOptions(field, text, fields)) errors[field.name] = INVALID;
+	if ((values.recipientName ?? "").trim() === "" && !errors.recipientName) errors.recipientName = REQUIRED;
+	for (const name of Object.keys(ACCOUNT_MAX_LENGTH).filter(isAddressField)) {
+		const maxLength = ACCOUNT_MAX_LENGTH[name];
+		if (!errors[name] && (values[name] ?? "").length > maxLength) errors[name] = {
+			code: "tooLong",
+			messageId: "fs/address.error.too-long",
+			values: { maxLength }
+		};
+	}
+	return errors;
+}
+//#endregion
+export { validateAddress };
+
+//# sourceMappingURL=validate-address.js.map

package/dist/sdk/address/validate-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-address.js","names":[],"sources":["../../../src/sdk/address/validate-address.ts"],"sourcesContent":["import {\n  createFormState,\n  type FieldDefinition,\n  type FormValues,\n  getVisibleFields,\n  resolveFieldOptions,\n  validate,\n} from '@vtex/country-forms';\nimport { ACCOUNT_MAX_LENGTH } from './constants.js';\nimport { resolveLibraryError } from './messages.js';\nimport { declaredMaxLength, toFormValues } from './schema.js';\nimport type { AddressErrors, AddressFieldError, AddressFieldName, AddressValues, CountryRules } from './types.js';\n\nconst REQUIRED: AddressFieldError = { code: 'required', messageId: 'fs/address.error.required' };\nconst INVALID: AddressFieldError = { code: 'invalid', messageId: 'fs/address.error.invalid' };\n\nfunction isAddressField(name: string): name is AddressFieldName {\n  return Object.hasOwn(ACCOUNT_MAX_LENGTH, name);\n}\n\nfunction isOutsideOptions(field: FieldDefinition, values: FormValues, fields: readonly FieldDefinition[]): boolean {\n  const value = values[field.name] ?? '';\n  if (field.type !== 'select' || value === '') {\n    return false;\n  }\n\n  // A dependent list exists only for a valid controller; the controller carries its own error.\n  const controller = fields.find(({ name }) => name === field.dependsOn);\n  if (controller && ((values[controller.name] ?? '') === '' || isOutsideOptions(controller, values, fields))) {\n    return false;\n  }\n\n  return !(resolveFieldOptions(field, values) ?? []).some((option) => option.value === value);\n}\n\n/**\n * Checks a draft or a stored address against its country's rules and the account's own rules, and\n * returns at most one error per field. A field's first error wins, in this order: the library's,\n * a select value outside its options, then the account's maximum length.\n *\n * The account's rules cover what the library does not: `recipientName` must not be blank,\n * `reference` and the address name may be empty, every free-text field has a maximum length, and a\n * select's value must be one of the options the library resolves. Keys outside the ten address\n * fields are ignored, so a merged record can carry `geoCoordinate` as it is.\n */\nexport function validateAddress(values: AddressValues, rules: CountryRules): AddressErrors {\n  const text = toFormValues(values);\n  const fields = getVisibleFields(rules.schema, text);\n  const errors: Partial<Record<AddressFieldName, AddressFieldError>> = {};\n\n  const declared = new Map(rules.schema.fields.map((field) => [field.name, field]));\n  const libraryErrors = validate(createFormState(rules.schema, text), rules.schema);\n  for (const [name, key] of Object.entries(libraryErrors)) {\n    const field = declared.get(name);\n    if (isAddressField(name) && field) {\n      errors[name] = resolveLibraryError(key, { country: rules.country, maxLength: declaredMaxLength(field) });\n    }\n  }\n\n  for (const field of fields) {\n    if (isAddressField(field.name) && !errors[field.name] && isOutsideOptions(field, text, fields)) {\n      errors[field.name] = INVALID;\n    }\n  }\n\n  if ((values.recipientName ?? '').trim() === '' && !errors.recipientName) {\n    errors.recipientName = REQUIRED;\n  }\n\n  for (const name of Object.keys(ACCOUNT_MAX_LENGTH).filter(isAddressField)) {\n    const maxLength = ACCOUNT_MAX_LENGTH[name];\n    if (!errors[name] && (values[name] ?? '').length > maxLength) {\n      errors[name] = { code: 'tooLong', messageId: 'fs/address.error.too-long', values: { maxLength } };\n    }\n  }\n\n  return errors;\n}\n"],"mappings":";;;;;AAaA,MAAM,WAA8B;CAAE,MAAM;CAAY,WAAW;AAA4B;AAC/F,MAAM,UAA6B;CAAE,MAAM;CAAW,WAAW;AAA2B;AAE5F,SAAS,eAAe,MAAwC;CAC9D,OAAO,OAAO,OAAO,oBAAoB,IAAI;AAC/C;AAEA,SAAS,iBAAiB,OAAwB,QAAoB,QAA6C;CACjH,MAAM,QAAQ,OAAO,MAAM,SAAS;CACpC,IAAI,MAAM,SAAS,YAAY,UAAU,IACvC,OAAO;CAIT,MAAM,aAAa,OAAO,MAAM,EAAE,WAAW,SAAS,MAAM,SAAS;CACrE,IAAI,gBAAgB,OAAO,WAAW,SAAS,QAAQ,MAAM,iBAAiB,YAAY,QAAQ,MAAM,IACtG,OAAO;CAGT,OAAO,EAAE,oBAAoB,OAAO,MAAM,KAAK,CAAC,EAAA,CAAG,MAAM,WAAW,OAAO,UAAU,KAAK;AAC5F;;;;;;;;;;;AAYA,SAAgB,gBAAgB,QAAuB,OAAoC;CACzF,MAAM,OAAO,aAAa,MAAM;CAChC,MAAM,SAAS,iBAAiB,MAAM,QAAQ,IAAI;CAClD,MAAM,SAA+D,CAAC;CAEtE,MAAM,WAAW,IAAI,IAAI,MAAM,OAAO,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CAChF,MAAM,gBAAgB,SAAS,gBAAgB,MAAM,QAAQ,IAAI,GAAG,MAAM,MAAM;CAChF,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,aAAa,GAAG;EACvD,MAAM,QAAQ,SAAS,IAAI,IAAI;EAC/B,IAAI,eAAe,IAAI,KAAK,OAC1B,OAAO,QAAQ,oBAAoB,KAAK;GAAE,SAAS,MAAM;GAAS,WAAW,kBAAkB,KAAK;EAAE,CAAC;CAE3G;CAEA,KAAK,MAAM,SAAS,QAClB,IAAI,eAAe,MAAM,IAAI,KAAK,CAAC,OAAO,MAAM,SAAS,iBAAiB,OAAO,MAAM,MAAM,GAC3F,OAAO,MAAM,QAAQ;CAIzB,KAAK,OAAO,iBAAiB,GAAA,CAAI,KAAK,MAAM,MAAM,CAAC,OAAO,eACxD,OAAO,gBAAgB;CAGzB,KAAK,MAAM,QAAQ,OAAO,KAAK,kBAAkB,CAAC,CAAC,OAAO,cAAc,GAAG;EACzE,MAAM,YAAY,mBAAmB;EACrC,IAAI,CAAC,OAAO,UAAU,OAAO,SAAS,GAAA,CAAI,SAAS,WACjD,OAAO,QAAQ;GAAE,MAAM;GAAW,WAAW;GAA6B,QAAQ,EAAE,UAAU;EAAE;CAEpG;CAEA,OAAO;AACT"}

package/dist/sdk/cache/storefront-cache.js

@@ -4,11 +4,37 @@ import { InMemoryCache } from "@apollo/client";
 /**
 * Per-entity normalization and field-merge rules for the Storefront cache.
 *
-* Empty in T1. Domain entries (Product, Cart, OrderForm, …) arrive with the
-* particles that need them — see docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache,
-* "Out of Scope".
+* The cart and the order share three types whose ids neither can scope
+* (docs/features/order-placed/rfc.md, 3.4): a totalizer's id is its category
+* ("Items"), which the cart's totalizer line selects by; an address's id is the
+* saved address itself, masked on the order and not on the cart; and a
+* customization's id is the assembly ("Engraving"), which two lines of one cart
+* already share. Normalized, one record would overwrite the other, so each is
+* stored inside the record that holds it, and replaced on every write: safe
+* while every fragment selects the same subfields of each.
+*
+* The lists that hold them are the server's whole answer, so each write
+* replaces the list (`merge: false`). Apollo does the same by default, but warns
+* that data may be lost whenever such a list shrinks, as when a discount line
+* leaves the cart's totalizers; a merge by id would keep that stale line.
+*
+* Other domain entries arrive with the particles that need them — see
+* docs/storefront-core/reference-free-particle-model.md § Typed documents and the shared cache.
 */
-const typePolicies = {};
+const replaceList = { merge: false };
+const typePolicies = {
+	CartTotalizer: { keyFields: false },
+	Address: { keyFields: false },
+	CartItemCustomization: { keyFields: false },
+	Cart: { fields: { totalizers: replaceList } },
+	CartItem: { fields: { customizations: replaceList } },
+	CartItemComposition: { fields: { customizations: replaceList } },
+	Shipping: { fields: { savedAddresses: replaceList } },
+	Order: { fields: { totals: replaceList } },
+	SellerOrder: { fields: { totals: replaceList } },
+	OrderItem: { fields: { customizations: replaceList } },
+	CardNetwork: { keyFields: false }
+};
 /**
 * The single source of truth for InMemoryCache configuration. Both the
 * server-side `createClient` and the client-side `StorefrontProvider`