@vtex/faststore 0.0.7 → 0.0.8

package/dist/sdk/address/layouts.js

@@ -0,0 +1,56 @@
+import { isCountryField } from "./constants.js";
+//#region src/sdk/address/layouts.ts
+/**
+* A line is written as it prints, with each field in braces: `{city}, {state} {postalCode}`. The
+* text before a field is its separator. Only the first field of a line has none.
+*/
+function parseLine(line) {
+	const parts = [];
+	let cursor = 0;
+	for (const match of line.matchAll(/\{(\w+)\}/g)) {
+		const field = match[1] ?? "";
+		const separator = line.slice(cursor, match.index);
+		cursor = match.index + match[0].length;
+		if (!isCountryField(field)) throw new Error(`Unknown address field "${field}" in layout line "${line}"`);
+		parts.push(separator === "" ? { field } : {
+			field,
+			separator
+		});
+	}
+	return parts;
+}
+function layout(...lines) {
+	return lines.map(parseLine);
+}
+const NORTH_AMERICA = layout("{number} {street}", "{complement}", "{neighborhood}", "{city}, {state} {postalCode}");
+const ISLES = layout("{number} {street}", "{complement}", "{neighborhood}", "{city}", "{state}", "{postalCode}");
+function withStateLine(street, locality) {
+	return layout(street, "{complement}", "{neighborhood}", locality, "{state}");
+}
+/** Used for every country the library does not cover. */
+const DEFAULT_LAYOUT = layout("{street}, {number}", "{complement}", "{neighborhood}", "{city}, {state} {postalCode}");
+/**
+* How each covered country prints an address. The library's field order is the form's, not the
+* mail's, so it cannot stand in for this. Every layout places each of the seven fields once.
+*/
+const ADDRESS_LAYOUTS = {
+	BRA: layout("{street}, {number} - {complement}", "{neighborhood}", "{city} - {state}", "{postalCode}"),
+	USA: NORTH_AMERICA,
+	CAN: NORTH_AMERICA,
+	GBR: ISLES,
+	IRL: ISLES,
+	FRA: withStateLine("{number} {street}", "{postalCode} {city}"),
+	ITA: layout("{street}, {number}", "{complement}", "{neighborhood}", "{postalCode} {city} {state}"),
+	DEU: withStateLine("{street} {number}", "{postalCode} {city}"),
+	ARG: withStateLine("{street} {number}", "{postalCode} {city}"),
+	ESP: withStateLine("{street}, {number}", "{postalCode} {city}"),
+	MEX: layout("{street} {number}", "{complement}", "{neighborhood}", "{postalCode} {city}, {state}"),
+	COL: layout("{street} {number}", "{complement}", "{neighborhood}", "{city}, {state}", "{postalCode}"),
+	CHL: layout("{street} {number}", "{complement}", "{neighborhood}, {city}", "{state}", "{postalCode}"),
+	PER: layout("{street} {number}", "{complement}", "{neighborhood}, {city}", "{state} {postalCode}"),
+	ECU: layout("{street} {number}", "{complement}", "{neighborhood}", "{city} {postalCode}", "{state}")
+};
+//#endregion
+export { ADDRESS_LAYOUTS, DEFAULT_LAYOUT };
+
+//# sourceMappingURL=layouts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layouts.js","names":[],"sources":["../../../src/sdk/address/layouts.ts"],"sourcesContent":["import { isCountryField } from './constants.js';\nimport type { AddressDisplayLine, AddressDisplayPart } from './types.js';\n\n/**\n * A line is written as it prints, with each field in braces: `{city}, {state} {postalCode}`. The\n * text before a field is its separator. Only the first field of a line has none.\n */\nfunction parseLine(line: string): AddressDisplayLine {\n  const parts: AddressDisplayPart[] = [];\n  let cursor = 0;\n  for (const match of line.matchAll(/\\{(\\w+)\\}/g)) {\n    const field = match[1] ?? '';\n    const separator = line.slice(cursor, match.index);\n    cursor = match.index + match[0].length;\n    if (!isCountryField(field)) {\n      throw new Error(`Unknown address field \"${field}\" in layout line \"${line}\"`);\n    }\n    parts.push(separator === '' ? { field } : { field, separator });\n  }\n  return parts;\n}\n\nfunction layout(...lines: string[]): readonly AddressDisplayLine[] {\n  return lines.map(parseLine);\n}\n\nconst NORTH_AMERICA = layout('{number} {street}', '{complement}', '{neighborhood}', '{city}, {state} {postalCode}');\n\nconst ISLES = layout('{number} {street}', '{complement}', '{neighborhood}', '{city}', '{state}', '{postalCode}');\n\nfunction withStateLine(street: string, locality: string): readonly AddressDisplayLine[] {\n  return layout(street, '{complement}', '{neighborhood}', locality, '{state}');\n}\n\n/** Used for every country the library does not cover. */\nexport const DEFAULT_LAYOUT = layout(\n  '{street}, {number}',\n  '{complement}',\n  '{neighborhood}',\n  '{city}, {state} {postalCode}',\n);\n\n/**\n * How each covered country prints an address. The library's field order is the form's, not the\n * mail's, so it cannot stand in for this. Every layout places each of the seven fields once.\n */\nexport const ADDRESS_LAYOUTS: Readonly<Record<string, readonly AddressDisplayLine[]>> = {\n  BRA: layout('{street}, {number} - {complement}', '{neighborhood}', '{city} - {state}', '{postalCode}'),\n  USA: NORTH_AMERICA,\n  CAN: NORTH_AMERICA,\n  GBR: ISLES,\n  IRL: ISLES,\n  FRA: withStateLine('{number} {street}', '{postalCode} {city}'),\n  ITA: layout('{street}, {number}', '{complement}', '{neighborhood}', '{postalCode} {city} {state}'),\n  DEU: withStateLine('{street} {number}', '{postalCode} {city}'),\n  ARG: withStateLine('{street} {number}', '{postalCode} {city}'),\n  ESP: withStateLine('{street}, {number}', '{postalCode} {city}'),\n  MEX: layout('{street} {number}', '{complement}', '{neighborhood}', '{postalCode} {city}, {state}'),\n  COL: layout('{street} {number}', '{complement}', '{neighborhood}', '{city}, {state}', '{postalCode}'),\n  CHL: layout('{street} {number}', '{complement}', '{neighborhood}, {city}', '{state}', '{postalCode}'),\n  PER: layout('{street} {number}', '{complement}', '{neighborhood}, {city}', '{state} {postalCode}'),\n  ECU: layout('{street} {number}', '{complement}', '{neighborhood}', '{city} {postalCode}', '{state}'),\n};\n"],"mappings":";;;;;;AAOA,SAAS,UAAU,MAAkC;CACnD,MAAM,QAA8B,CAAC;CACrC,IAAI,SAAS;CACb,KAAK,MAAM,SAAS,KAAK,SAAS,YAAY,GAAG;EAC/C,MAAM,QAAQ,MAAM,MAAM;EAC1B,MAAM,YAAY,KAAK,MAAM,QAAQ,MAAM,KAAK;EAChD,SAAS,MAAM,QAAQ,MAAM,EAAE,CAAC;EAChC,IAAI,CAAC,eAAe,KAAK,GACvB,MAAM,IAAI,MAAM,0BAA0B,MAAM,oBAAoB,KAAK,EAAE;EAE7E,MAAM,KAAK,cAAc,KAAK,EAAE,MAAM,IAAI;GAAE;GAAO;EAAU,CAAC;CAChE;CACA,OAAO;AACT;AAEA,SAAS,OAAO,GAAG,OAAgD;CACjE,OAAO,MAAM,IAAI,SAAS;AAC5B;AAEA,MAAM,gBAAgB,OAAO,qBAAqB,gBAAgB,kBAAkB,8BAA8B;AAElH,MAAM,QAAQ,OAAO,qBAAqB,gBAAgB,kBAAkB,UAAU,WAAW,cAAc;AAE/G,SAAS,cAAc,QAAgB,UAAiD;CACtF,OAAO,OAAO,QAAQ,gBAAgB,kBAAkB,UAAU,SAAS;AAC7E;;AAGA,MAAa,iBAAiB,OAC5B,sBACA,gBACA,kBACA,8BACF;;;;;AAMA,MAAa,kBAA2E;CACtF,KAAK,OAAO,qCAAqC,kBAAkB,oBAAoB,cAAc;CACrG,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK,cAAc,qBAAqB,qBAAqB;CAC7D,KAAK,OAAO,sBAAsB,gBAAgB,kBAAkB,6BAA6B;CACjG,KAAK,cAAc,qBAAqB,qBAAqB;CAC7D,KAAK,cAAc,qBAAqB,qBAAqB;CAC7D,KAAK,cAAc,sBAAsB,qBAAqB;CAC9D,KAAK,OAAO,qBAAqB,gBAAgB,kBAAkB,8BAA8B;CACjG,KAAK,OAAO,qBAAqB,gBAAgB,kBAAkB,mBAAmB,cAAc;CACpG,KAAK,OAAO,qBAAqB,gBAAgB,0BAA0B,WAAW,cAAc;CACpG,KAAK,OAAO,qBAAqB,gBAAgB,0BAA0B,sBAAsB;CACjG,KAAK,OAAO,qBAAqB,gBAAgB,kBAAkB,uBAAuB,SAAS;AACrG"}

package/dist/sdk/address/messages.js

@@ -0,0 +1,97 @@
+//#region src/sdk/address/messages.ts
+const POSTAL_CODE_PLACEHOLDER_PREFIX = "country-forms.address.postalCode.placeholder.";
+const POSTAL_CODE_ERROR_PREFIX = "country-forms.validation.postalCode.";
+/** The library's label key for a field, mapped by meaning: `state.label.COL` and `department.label` agree. */
+const LABEL_IDS = {
+	"country-forms.address.postalCode.label": "fs/address.field.postal-code",
+	"country-forms.address.postalCode.label.GBR": "fs/address.field.postcode",
+	"country-forms.address.street.label": "fs/address.field.street",
+	"country-forms.address.number.label": "fs/address.field.number",
+	"country-forms.address.complement.label": "fs/address.field.complement",
+	"country-forms.address.neighborhood.label": "fs/address.field.neighborhood",
+	"country-forms.address.neighborhood.label.CHL": "fs/address.field.commune",
+	"country-forms.address.neighborhood.label.PER": "fs/address.field.district",
+	"country-forms.address.city.label": "fs/address.field.city",
+	"country-forms.address.city.label.ECU": "fs/address.field.city",
+	"country-forms.address.city.label.GBR": "fs/address.field.town",
+	"country-forms.address.city.label.COL": "fs/address.field.municipality",
+	"country-forms.address.city.label.PER": "fs/address.field.province",
+	"country-forms.address.state.label": "fs/address.field.state",
+	"country-forms.address.state.label.CHL": "fs/address.field.region",
+	"country-forms.address.state.label.COL": "fs/address.field.department",
+	"country-forms.address.state.label.PER": "fs/address.field.department",
+	"country-forms.address.state.label.ECU": "fs/address.field.province",
+	"country-forms.address.state.label.ITA": "fs/address.field.province",
+	"country-forms.address.state.label.GBR": "fs/address.field.county",
+	"country-forms.address.state.label.IRL": "fs/address.field.county",
+	"country-forms.address.department.label": "fs/address.field.department"
+};
+/** The label of a field whose library key this module does not know. */
+const FIELD_LABEL_IDS = {
+	postalCode: "fs/address.field.postal-code",
+	street: "fs/address.field.street",
+	number: "fs/address.field.number",
+	complement: "fs/address.field.complement",
+	neighborhood: "fs/address.field.neighborhood",
+	state: "fs/address.field.state",
+	city: "fs/address.field.city"
+};
+const STREET_PLACEHOLDER_KEY = "country-forms.address.street.placeholder";
+/** Examples in the stored, masked form. The library's own placeholders, one per country. */
+const POSTAL_CODE_EXAMPLES = {
+	ARG: "C1425ABC",
+	BRA: "01310-100",
+	CAN: "K1A 0A9",
+	CHL: "8320000",
+	COL: "110111",
+	DEU: "10115",
+	ECU: "170150",
+	ESP: "28001",
+	FRA: "75001",
+	GBR: "SW1A 1AA",
+	IRL: "D02 AF30",
+	ITA: "00118",
+	MEX: "06600",
+	PER: "15074",
+	USA: "10001-1234"
+};
+function resolveLabelId(key, field, country) {
+	if (country === "BRA" && field === "postalCode") return "fs/address.field.cep";
+	return LABEL_IDS[key] ?? FIELD_LABEL_IDS[field];
+}
+function resolvePlaceholder(key, country) {
+	if (key === "country-forms.address.street.placeholder") return {
+		id: "fs/address.placeholder.street",
+		values: {}
+	};
+	const example = POSTAL_CODE_EXAMPLES[country];
+	if (key?.startsWith(POSTAL_CODE_PLACEHOLDER_PREFIX) && example !== void 0) return {
+		id: "fs/address.placeholder.postal-code",
+		values: { example }
+	};
+}
+function error(code, messageId, values) {
+	return values === void 0 ? {
+		code,
+		messageId
+	} : {
+		code,
+		messageId,
+		values
+	};
+}
+/**
+* Turns the message key the library returned for a field into an error. A key this module does not
+* know is `invalid`, so a newer library never produces an error the form cannot word.
+*/
+function resolveLibraryError(key, { country, maxLength }) {
+	if (key === "country-forms.validation.required") return error("required", "fs/address.error.required");
+	if (key === "country-forms.validation.maxLength" && maxLength !== void 0) return error("tooLong", "fs/address.error.too-long", { maxLength });
+	const example = POSTAL_CODE_EXAMPLES[country];
+	if (key.startsWith(POSTAL_CODE_ERROR_PREFIX) && example !== void 0) return error("invalid", country === "BRA" ? "fs/address.error.cep" : "fs/address.error.postal-code", { example });
+	return error("invalid", "fs/address.error.invalid");
+}
+//#endregion
+export { LABEL_IDS, POSTAL_CODE_EXAMPLES, STREET_PLACEHOLDER_KEY, resolveLabelId, resolveLibraryError, resolvePlaceholder };
+
+//# sourceMappingURL=messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","names":[],"sources":["../../../src/sdk/address/messages.ts"],"sourcesContent":["import type { MessageId } from '../i18n/client.js';\nimport type { AddressErrorCode, AddressFieldError, CountryFieldName } from './types.js';\n\nconst POSTAL_CODE_PLACEHOLDER_PREFIX = 'country-forms.address.postalCode.placeholder.';\nconst POSTAL_CODE_ERROR_PREFIX = 'country-forms.validation.postalCode.';\n\n/** The library's label key for a field, mapped by meaning: `state.label.COL` and `department.label` agree. */\nexport const LABEL_IDS: Readonly<Record<string, MessageId>> = {\n  'country-forms.address.postalCode.label': 'fs/address.field.postal-code',\n  'country-forms.address.postalCode.label.GBR': 'fs/address.field.postcode',\n  'country-forms.address.street.label': 'fs/address.field.street',\n  'country-forms.address.number.label': 'fs/address.field.number',\n  'country-forms.address.complement.label': 'fs/address.field.complement',\n  'country-forms.address.neighborhood.label': 'fs/address.field.neighborhood',\n  'country-forms.address.neighborhood.label.CHL': 'fs/address.field.commune',\n  'country-forms.address.neighborhood.label.PER': 'fs/address.field.district',\n  'country-forms.address.city.label': 'fs/address.field.city',\n  'country-forms.address.city.label.ECU': 'fs/address.field.city',\n  'country-forms.address.city.label.GBR': 'fs/address.field.town',\n  'country-forms.address.city.label.COL': 'fs/address.field.municipality',\n  'country-forms.address.city.label.PER': 'fs/address.field.province',\n  'country-forms.address.state.label': 'fs/address.field.state',\n  'country-forms.address.state.label.CHL': 'fs/address.field.region',\n  'country-forms.address.state.label.COL': 'fs/address.field.department',\n  'country-forms.address.state.label.PER': 'fs/address.field.department',\n  'country-forms.address.state.label.ECU': 'fs/address.field.province',\n  'country-forms.address.state.label.ITA': 'fs/address.field.province',\n  'country-forms.address.state.label.GBR': 'fs/address.field.county',\n  'country-forms.address.state.label.IRL': 'fs/address.field.county',\n  'country-forms.address.department.label': 'fs/address.field.department',\n};\n\n/** The label of a field whose library key this module does not know. */\nconst FIELD_LABEL_IDS: Readonly<Record<CountryFieldName, MessageId>> = {\n  postalCode: 'fs/address.field.postal-code',\n  street: 'fs/address.field.street',\n  number: 'fs/address.field.number',\n  complement: 'fs/address.field.complement',\n  neighborhood: 'fs/address.field.neighborhood',\n  state: 'fs/address.field.state',\n  city: 'fs/address.field.city',\n};\n\nexport const STREET_PLACEHOLDER_KEY = 'country-forms.address.street.placeholder';\n\n/** Examples in the stored, masked form. The library's own placeholders, one per country. */\nexport const POSTAL_CODE_EXAMPLES: Readonly<Record<string, string>> = {\n  ARG: 'C1425ABC',\n  BRA: '01310-100',\n  CAN: 'K1A 0A9',\n  CHL: '8320000',\n  COL: '110111',\n  DEU: '10115',\n  ECU: '170150',\n  ESP: '28001',\n  FRA: '75001',\n  GBR: 'SW1A 1AA',\n  IRL: 'D02 AF30',\n  ITA: '00118',\n  MEX: '06600',\n  PER: '15074',\n  USA: '10001-1234',\n};\n\nexport function resolveLabelId(key: string, field: CountryFieldName, country: string): MessageId {\n  if (country === 'BRA' && field === 'postalCode') {\n    return 'fs/address.field.cep';\n  }\n  return LABEL_IDS[key] ?? FIELD_LABEL_IDS[field];\n}\n\nexport function resolvePlaceholder(\n  key: string | undefined,\n  country: string,\n): Readonly<{ id: MessageId; values: Readonly<Record<string, string>> }> | undefined {\n  if (key === STREET_PLACEHOLDER_KEY) {\n    return { id: 'fs/address.placeholder.street', values: {} };\n  }\n  const example = POSTAL_CODE_EXAMPLES[country];\n  if (key?.startsWith(POSTAL_CODE_PLACEHOLDER_PREFIX) && example !== undefined) {\n    return { id: 'fs/address.placeholder.postal-code', values: { example } };\n  }\n  return undefined;\n}\n\nfunction error(code: AddressErrorCode, messageId: MessageId, values?: Record<string, string | number>) {\n  return values === undefined ? { code, messageId } : { code, messageId, values };\n}\n\n/**\n * Turns the message key the library returned for a field into an error. A key this module does not\n * know is `invalid`, so a newer library never produces an error the form cannot word.\n */\nexport function resolveLibraryError(\n  key: string,\n  { country, maxLength }: Readonly<{ country: string; maxLength?: number }>,\n): AddressFieldError {\n  if (key === 'country-forms.validation.required') {\n    return error('required', 'fs/address.error.required');\n  }\n  if (key === 'country-forms.validation.maxLength' && maxLength !== undefined) {\n    return error('tooLong', 'fs/address.error.too-long', { maxLength });\n  }\n  const example = POSTAL_CODE_EXAMPLES[country];\n  if (key.startsWith(POSTAL_CODE_ERROR_PREFIX) && example !== undefined) {\n    return error('invalid', country === 'BRA' ? 'fs/address.error.cep' : 'fs/address.error.postal-code', { example });\n  }\n  return error('invalid', 'fs/address.error.invalid');\n}\n"],"mappings":";AAGA,MAAM,iCAAiC;AACvC,MAAM,2BAA2B;;AAGjC,MAAa,YAAiD;CAC5D,0CAA0C;CAC1C,8CAA8C;CAC9C,sCAAsC;CACtC,sCAAsC;CACtC,0CAA0C;CAC1C,4CAA4C;CAC5C,gDAAgD;CAChD,gDAAgD;CAChD,oCAAoC;CACpC,wCAAwC;CACxC,wCAAwC;CACxC,wCAAwC;CACxC,wCAAwC;CACxC,qCAAqC;CACrC,yCAAyC;CACzC,yCAAyC;CACzC,yCAAyC;CACzC,yCAAyC;CACzC,yCAAyC;CACzC,yCAAyC;CACzC,yCAAyC;CACzC,0CAA0C;AAC5C;;AAGA,MAAM,kBAAiE;CACrE,YAAY;CACZ,QAAQ;CACR,QAAQ;CACR,YAAY;CACZ,cAAc;CACd,OAAO;CACP,MAAM;AACR;AAEA,MAAa,yBAAyB;;AAGtC,MAAa,uBAAyD;CACpE,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP;AAEA,SAAgB,eAAe,KAAa,OAAyB,SAA4B;CAC/F,IAAI,YAAY,SAAS,UAAU,cACjC,OAAO;CAET,OAAO,UAAU,QAAQ,gBAAgB;AAC3C;AAEA,SAAgB,mBACd,KACA,SACmF;CACnF,IAAI,QAAA,4CACF,OAAO;EAAE,IAAI;EAAiC,QAAQ,CAAC;CAAE;CAE3D,MAAM,UAAU,qBAAqB;CACrC,IAAI,KAAK,WAAW,8BAA8B,KAAK,YAAY,KAAA,GACjE,OAAO;EAAE,IAAI;EAAsC,QAAQ,EAAE,QAAQ;CAAE;AAG3E;AAEA,SAAS,MAAM,MAAwB,WAAsB,QAA0C;CACrG,OAAO,WAAW,KAAA,IAAY;EAAE;EAAM;CAAU,IAAI;EAAE;EAAM;EAAW;CAAO;AAChF;;;;;AAMA,SAAgB,oBACd,KACA,EAAE,SAAS,aACQ;CACnB,IAAI,QAAQ,qCACV,OAAO,MAAM,YAAY,2BAA2B;CAEtD,IAAI,QAAQ,wCAAwC,cAAc,KAAA,GAChE,OAAO,MAAM,WAAW,6BAA6B,EAAE,UAAU,CAAC;CAEpE,MAAM,UAAU,qBAAqB;CACrC,IAAI,IAAI,WAAW,wBAAwB,KAAK,YAAY,KAAA,GAC1D,OAAO,MAAM,WAAW,YAAY,QAAQ,yBAAyB,gCAAgC,EAAE,QAAQ,CAAC;CAElH,OAAO,MAAM,WAAW,0BAA0B;AACpD"}

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

@@ -0,0 +1,54 @@
+import { TypedDocumentNode } from "@apollo/client";
+//#region src/sdk/address/operations.d.ts
+/**
+ * The saved-address write documents and the cache-only lookup of the address book.
+ *
+ * Authored with the hand `gql` tag and excluded from the codegen `documents` glob (see
+ * `codegen.ts`), like the identity and region writes: the `gql` tag alone is still plucked by
+ * `graphql-codegen`, which would emit duplicates of these hand-written types in `sdk/generated/`.
+ *
+ * The create and update payloads select every field the list item reads, `__typename` and `id`
+ * included, so the response merges into the normalized cache and every subscriber of the entity
+ * re-renders with no refetch. A create still needs the list edit the action performs: a new entity
+ * is in no list until something appends it.
+ *
+ * Failures follow ADR-00007's two paths: a refused address arrives as payload `userErrors`, and
+ * transport or top-level GraphQL failures are infrastructure, which the handlers map to one
+ * client-synthesized code.
+ */
+/**
+ * A refused write or a client-synthesized failure. `code` is the server's `CustomerAddressErrorCode`
+ * (`NOT_FOUND`, `MISSING_REQUIRED_FIELD`, `INVALID_VALUE`, `UNSUPPORTED_COUNTRY`) or one of the two
+ * the client adds, `NETWORK_ERROR` and `UNAUTHORIZED`. `field` is a `CustomerAddressField` such as
+ * `POSTAL_CODE`, and null when the failure is about the address as a whole.
+ */
+export type CustomerAddressUserError = Readonly<{
+  code: string;
+  message: string;
+  field: string | null;
+}>;
+/** The fields an address carries besides its country. */
+export type CustomerAddressFields = Readonly<{
+  recipientName?: string;
+  street?: string;
+  number?: string;
+  complement?: string;
+  neighborhood?: string;
+  city?: string;
+  state?: string;
+  postalCode?: string;
+  reference?: string;
+}>;
+/** Mirrors `CustomerAddressCreateInput`. An omitted or empty field is not written. */
+export type AddressCreatePayload = CustomerAddressFields & Readonly<{
+  country: string;
+}>;
+/** Mirrors `CustomerAddressUpdateInput` plus the id. Omit a field to keep it; `''` erases it. */
+export type AddressUpdatePayload = CustomerAddressFields & Readonly<{
+  id: string;
+}>;
+export type AddressRemovePayload = Readonly<{
+  id: string;
+}>;
+//#endregion
+//# sourceMappingURL=operations.d.ts.map

package/dist/sdk/address/operations.js

@@ -0,0 +1,83 @@
+import { gql } from "../graphql-tag.js";
+//#region src/sdk/address/operations.ts
+const CUSTOMER_ADDRESS_CREATE = gql`
+  mutation CustomerAddressCreate($input: CustomerAddressCreateInput!) {
+    customerAddressCreate(input: $input) {
+      __typename
+      customerAddress {
+        __typename
+        id
+        country
+        recipientName
+        street
+        number
+        complement
+        neighborhood
+        city
+        state
+        postalCode
+        reference
+      }
+      userErrors {
+        code
+        message
+        field
+      }
+    }
+  }
+`;
+const CUSTOMER_ADDRESS_UPDATE = gql`
+  mutation CustomerAddressUpdate($id: ID!, $input: CustomerAddressUpdateInput!) {
+    customerAddressUpdate(id: $id, input: $input) {
+      __typename
+      customerAddress {
+        __typename
+        id
+        country
+        recipientName
+        street
+        number
+        complement
+        neighborhood
+        city
+        state
+        postalCode
+        reference
+      }
+      userErrors {
+        code
+        message
+        field
+      }
+    }
+  }
+`;
+const CUSTOMER_ADDRESS_DELETE = gql`
+  mutation CustomerAddressDelete($id: ID!) {
+    customerAddressDelete(id: $id) {
+      __typename
+      deletedCustomerAddressId
+      userErrors {
+        code
+        message
+        field
+      }
+    }
+  }
+`;
+/**
+* Read from the cache only (`cache.readQuery`), never sent: it names the cached address book so a
+* create can append to its list. `null` when no list is mounted.
+*/
+const CUSTOMER_ADDRESS_BOOK_IDENTITY = gql`
+  query CustomerAddressBookIdentity {
+    customerAddressBook {
+      __typename
+      id
+    }
+  }
+`;
+//#endregion
+export { CUSTOMER_ADDRESS_BOOK_IDENTITY, CUSTOMER_ADDRESS_CREATE, CUSTOMER_ADDRESS_DELETE, CUSTOMER_ADDRESS_UPDATE };
+
+//# sourceMappingURL=operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","names":[],"sources":["../../../src/sdk/address/operations.ts"],"sourcesContent":["import type { TypedDocumentNode } from '@apollo/client';\nimport { gql } from '../graphql-tag.js';\n\n/**\n * The saved-address write documents and the cache-only lookup of the address book.\n *\n * Authored with the hand `gql` tag and excluded from the codegen `documents` glob (see\n * `codegen.ts`), like the identity and region writes: the `gql` tag alone is still plucked by\n * `graphql-codegen`, which would emit duplicates of these hand-written types in `sdk/generated/`.\n *\n * The create and update payloads select every field the list item reads, `__typename` and `id`\n * included, so the response merges into the normalized cache and every subscriber of the entity\n * re-renders with no refetch. A create still needs the list edit the action performs: a new entity\n * is in no list until something appends it.\n *\n * Failures follow ADR-00007's two paths: a refused address arrives as payload `userErrors`, and\n * transport or top-level GraphQL failures are infrastructure, which the handlers map to one\n * client-synthesized code.\n */\n\n/**\n * A refused write or a client-synthesized failure. `code` is the server's `CustomerAddressErrorCode`\n * (`NOT_FOUND`, `MISSING_REQUIRED_FIELD`, `INVALID_VALUE`, `UNSUPPORTED_COUNTRY`) or one of the two\n * the client adds, `NETWORK_ERROR` and `UNAUTHORIZED`. `field` is a `CustomerAddressField` such as\n * `POSTAL_CODE`, and null when the failure is about the address as a whole.\n */\nexport type CustomerAddressUserError = Readonly<{\n  code: string;\n  message: string;\n  field: string | null;\n}>;\n\n/** The fields an address carries besides its country. */\nexport type CustomerAddressFields = Readonly<{\n  recipientName?: string;\n  street?: string;\n  number?: string;\n  complement?: string;\n  neighborhood?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  reference?: string;\n}>;\n\n/** Mirrors `CustomerAddressCreateInput`. An omitted or empty field is not written. */\nexport type AddressCreatePayload = CustomerAddressFields & Readonly<{ country: string }>;\n\n/** Mirrors `CustomerAddressUpdateInput` plus the id. Omit a field to keep it; `''` erases it. */\nexport type AddressUpdatePayload = CustomerAddressFields & Readonly<{ id: string }>;\n\nexport type AddressRemovePayload = Readonly<{ id: string }>;\n\n/** The `CustomerAddress` slice the create and update payloads select. */\nexport type CustomerAddressEntity = Readonly<{\n  __typename?: 'CustomerAddress';\n  id: string;\n  country: string | null;\n  recipientName: string | null;\n  street: string | null;\n  number: string | null;\n  complement: string | null;\n  neighborhood: string | null;\n  city: string | null;\n  state: string | null;\n  postalCode: string | null;\n  reference: string | null;\n}>;\n\ntype CustomerAddressWriteData<Key extends string> = {\n  [K in Key]: Readonly<{\n    __typename?: string;\n    customerAddress: CustomerAddressEntity | null;\n    userErrors: readonly CustomerAddressUserError[];\n  }>;\n};\n\nexport type CustomerAddressDeleteData = {\n  customerAddressDelete: Readonly<{\n    __typename?: 'CustomerAddressDeletePayload';\n    deletedCustomerAddressId: string | null;\n    userErrors: readonly CustomerAddressUserError[];\n  }>;\n};\n\nexport type CustomerAddressBookIdentityData = {\n  customerAddressBook: Readonly<{ __typename: 'CustomerAddressBook'; id: string }> | null;\n};\n\nexport const CUSTOMER_ADDRESS_CREATE: TypedDocumentNode<\n  CustomerAddressWriteData<'customerAddressCreate'>,\n  { input: AddressCreatePayload }\n> = gql`\n  mutation CustomerAddressCreate($input: CustomerAddressCreateInput!) {\n    customerAddressCreate(input: $input) {\n      __typename\n      customerAddress {\n        __typename\n        id\n        country\n        recipientName\n        street\n        number\n        complement\n        neighborhood\n        city\n        state\n        postalCode\n        reference\n      }\n      userErrors {\n        code\n        message\n        field\n      }\n    }\n  }\n`;\n\nexport const CUSTOMER_ADDRESS_UPDATE: TypedDocumentNode<\n  CustomerAddressWriteData<'customerAddressUpdate'>,\n  { id: string; input: CustomerAddressFields }\n> = gql`\n  mutation CustomerAddressUpdate($id: ID!, $input: CustomerAddressUpdateInput!) {\n    customerAddressUpdate(id: $id, input: $input) {\n      __typename\n      customerAddress {\n        __typename\n        id\n        country\n        recipientName\n        street\n        number\n        complement\n        neighborhood\n        city\n        state\n        postalCode\n        reference\n      }\n      userErrors {\n        code\n        message\n        field\n      }\n    }\n  }\n`;\n\nexport const CUSTOMER_ADDRESS_DELETE: TypedDocumentNode<CustomerAddressDeleteData, { id: string }> = gql`\n  mutation CustomerAddressDelete($id: ID!) {\n    customerAddressDelete(id: $id) {\n      __typename\n      deletedCustomerAddressId\n      userErrors {\n        code\n        message\n        field\n      }\n    }\n  }\n`;\n\n/**\n * Read from the cache only (`cache.readQuery`), never sent: it names the cached address book so a\n * create can append to its list. `null` when no list is mounted.\n */\nexport const CUSTOMER_ADDRESS_BOOK_IDENTITY: TypedDocumentNode<CustomerAddressBookIdentityData, never> = gql`\n  query CustomerAddressBookIdentity {\n    customerAddressBook {\n      __typename\n      id\n    }\n  }\n`;\n"],"mappings":";;AAyFA,MAAa,0BAGT,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BP,MAAa,0BAGT,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BP,MAAa,0BAAwF,GAAG;;;;;;;;;;;;;;;;;AAkBxG,MAAa,iCAA4F,GAAG"}

package/dist/sdk/address/postal-code-lookup-operations.js

@@ -0,0 +1,23 @@
+import { graphql } from "../generated/gql.js";
+//#region src/sdk/address/postal-code-lookup-operations.ts
+/**
+* Postal-code lookup GraphQL operation (specs/sfs-3430-address-by-postal-code.md).
+*
+* Authored via the codegen `graphql()` factory so codegen scans this document and generates
+* `AddressByPostalCodeQuery` and its variables. The selection set is the four fields the platform
+* resolves for a code; `useAddressByPostalCode` maps the result onto the lookup's three outcomes.
+*/
+const ADDRESS_BY_POSTAL_CODE = graphql(`
+  query AddressByPostalCode($country: String!, $postalCode: String!) {
+    addressByPostalCode(country: $country, postalCode: $postalCode) {
+      city
+      state
+      street
+      neighborhood
+    }
+  }
+`);
+//#endregion
+export { ADDRESS_BY_POSTAL_CODE };
+
+//# sourceMappingURL=postal-code-lookup-operations.js.map

package/dist/sdk/address/postal-code-lookup-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postal-code-lookup-operations.js","names":[],"sources":["../../../src/sdk/address/postal-code-lookup-operations.ts"],"sourcesContent":["import type { TypedDocumentNode } from '@apollo/client';\nimport { graphql } from '../generated/gql.js';\nimport type { AddressByPostalCodeQuery, AddressByPostalCodeQueryVariables } from '../generated/graphql.js';\n\n/**\n * Postal-code lookup GraphQL operation (specs/sfs-3430-address-by-postal-code.md).\n *\n * Authored via the codegen `graphql()` factory so codegen scans this document and generates\n * `AddressByPostalCodeQuery` and its variables. The selection set is the four fields the platform\n * resolves for a code; `useAddressByPostalCode` maps the result onto the lookup's three outcomes.\n */\nexport const ADDRESS_BY_POSTAL_CODE: TypedDocumentNode<AddressByPostalCodeQuery, AddressByPostalCodeQueryVariables> =\n  graphql(`\n  query AddressByPostalCode($country: String!, $postalCode: String!) {\n    addressByPostalCode(country: $country, postalCode: $postalCode) {\n      city\n      state\n      street\n      neighborhood\n    }\n  }\n`);\n"],"mappings":";;;;;;;;;AAWA,MAAa,yBACX,QAAQ;;;;;;;;;CAST"}

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

@@ -0,0 +1,11 @@
+import { POSTAL_CODE_LOOKUP_COUNTRIES } from "./constants.js";
+import "@vtex/country-forms";
+//#region src/sdk/address/postal-code.ts
+/** Whether the form offers to fill the address from the postal code for this country. */
+function hasPostalCodeLookup(country) {
+	return POSTAL_CODE_LOOKUP_COUNTRIES.includes(country.trim().toUpperCase());
+}
+//#endregion
+export { hasPostalCodeLookup };
+
+//# sourceMappingURL=postal-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postal-code.js","names":[],"sources":["../../../src/sdk/address/postal-code.ts"],"sourcesContent":["import { formatValue, resolveFieldFormatRef, resolveFieldUnformatRef, unformatValue } from '@vtex/country-forms';\nimport { POSTAL_CODE_LOOKUP_COUNTRIES } from './constants.js';\nimport type { CountryRules } from './types.js';\n\n/**\n * The stored form of a postal code: the country's masked form, such as `01001-000`, `20500-0003`, or\n * `SW1A 1AA`. The library accepts most codes with or without the mask but refuses an unmasked US\n * ZIP+4, so the masked form is the one every country accepts. A country with no mask stores the\n * trimmed value. Apply it to a value that passed `validateAddress`.\n */\nexport function normalizePostalCode(value: string, rules: CountryRules): string {\n  const trimmed = value.trim();\n  const field = rules.schema.fields.find(({ name }) => name === 'postalCode');\n  if (!field) {\n    return trimmed;\n  }\n  const values = { postalCode: trimmed };\n  return formatValue(\n    resolveFieldFormatRef(field, values),\n    unformatValue(resolveFieldUnformatRef(field, values), trimmed),\n  );\n}\n\n/** Whether the form offers to fill the address from the postal code for this country. */\nexport function hasPostalCodeLookup(country: string): boolean {\n  return POSTAL_CODE_LOOKUP_COUNTRIES.includes(country.trim().toUpperCase());\n}\n"],"mappings":";;;;AAwBA,SAAgB,oBAAoB,SAA0B;CAC5D,OAAO,6BAA6B,SAAS,QAAQ,KAAK,CAAC,CAAC,YAAY,CAAC;AAC3E"}

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