@vtex/faststore 0.0.7 → 0.0.10

package/dist/sdk/address/iso-countries.js

@@ -0,0 +1,262 @@
+//#region src/sdk/address/iso-countries.ts
+/**
+* ISO 3166-1 alpha-3 to alpha-2, for the 249 officially assigned codes. An address stores the
+* alpha-3 code and `Intl.DisplayNames` accepts only alpha-2, so a name needs this bridge. The table
+* is the full standard rather than the countries `@vtex/country-forms` covers, because an address
+* written by another channel can carry any country.
+*/
+const ALPHA2_BY_ALPHA3 = {
+	ABW: "AW",
+	AFG: "AF",
+	AGO: "AO",
+	AIA: "AI",
+	ALA: "AX",
+	ALB: "AL",
+	AND: "AD",
+	ARE: "AE",
+	ARG: "AR",
+	ARM: "AM",
+	ASM: "AS",
+	ATA: "AQ",
+	ATF: "TF",
+	ATG: "AG",
+	AUS: "AU",
+	AUT: "AT",
+	AZE: "AZ",
+	BDI: "BI",
+	BEL: "BE",
+	BEN: "BJ",
+	BES: "BQ",
+	BFA: "BF",
+	BGD: "BD",
+	BGR: "BG",
+	BHR: "BH",
+	BHS: "BS",
+	BIH: "BA",
+	BLM: "BL",
+	BLR: "BY",
+	BLZ: "BZ",
+	BMU: "BM",
+	BOL: "BO",
+	BRA: "BR",
+	BRB: "BB",
+	BRN: "BN",
+	BTN: "BT",
+	BVT: "BV",
+	BWA: "BW",
+	CAF: "CF",
+	CAN: "CA",
+	CCK: "CC",
+	CHE: "CH",
+	CHL: "CL",
+	CHN: "CN",
+	CIV: "CI",
+	CMR: "CM",
+	COD: "CD",
+	COG: "CG",
+	COK: "CK",
+	COL: "CO",
+	COM: "KM",
+	CPV: "CV",
+	CRI: "CR",
+	CUB: "CU",
+	CUW: "CW",
+	CXR: "CX",
+	CYM: "KY",
+	CYP: "CY",
+	CZE: "CZ",
+	DEU: "DE",
+	DJI: "DJ",
+	DMA: "DM",
+	DNK: "DK",
+	DOM: "DO",
+	DZA: "DZ",
+	ECU: "EC",
+	EGY: "EG",
+	ERI: "ER",
+	ESH: "EH",
+	ESP: "ES",
+	EST: "EE",
+	ETH: "ET",
+	FIN: "FI",
+	FJI: "FJ",
+	FLK: "FK",
+	FRA: "FR",
+	FRO: "FO",
+	FSM: "FM",
+	GAB: "GA",
+	GBR: "GB",
+	GEO: "GE",
+	GGY: "GG",
+	GHA: "GH",
+	GIB: "GI",
+	GIN: "GN",
+	GLP: "GP",
+	GMB: "GM",
+	GNB: "GW",
+	GNQ: "GQ",
+	GRC: "GR",
+	GRD: "GD",
+	GRL: "GL",
+	GTM: "GT",
+	GUF: "GF",
+	GUM: "GU",
+	GUY: "GY",
+	HKG: "HK",
+	HMD: "HM",
+	HND: "HN",
+	HRV: "HR",
+	HTI: "HT",
+	HUN: "HU",
+	IDN: "ID",
+	IMN: "IM",
+	IND: "IN",
+	IOT: "IO",
+	IRL: "IE",
+	IRN: "IR",
+	IRQ: "IQ",
+	ISL: "IS",
+	ISR: "IL",
+	ITA: "IT",
+	JAM: "JM",
+	JEY: "JE",
+	JOR: "JO",
+	JPN: "JP",
+	KAZ: "KZ",
+	KEN: "KE",
+	KGZ: "KG",
+	KHM: "KH",
+	KIR: "KI",
+	KNA: "KN",
+	KOR: "KR",
+	KWT: "KW",
+	LAO: "LA",
+	LBN: "LB",
+	LBR: "LR",
+	LBY: "LY",
+	LCA: "LC",
+	LIE: "LI",
+	LKA: "LK",
+	LSO: "LS",
+	LTU: "LT",
+	LUX: "LU",
+	LVA: "LV",
+	MAC: "MO",
+	MAF: "MF",
+	MAR: "MA",
+	MCO: "MC",
+	MDA: "MD",
+	MDG: "MG",
+	MDV: "MV",
+	MEX: "MX",
+	MHL: "MH",
+	MKD: "MK",
+	MLI: "ML",
+	MLT: "MT",
+	MMR: "MM",
+	MNE: "ME",
+	MNG: "MN",
+	MNP: "MP",
+	MOZ: "MZ",
+	MRT: "MR",
+	MSR: "MS",
+	MTQ: "MQ",
+	MUS: "MU",
+	MWI: "MW",
+	MYS: "MY",
+	MYT: "YT",
+	NAM: "NA",
+	NCL: "NC",
+	NER: "NE",
+	NFK: "NF",
+	NGA: "NG",
+	NIC: "NI",
+	NIU: "NU",
+	NLD: "NL",
+	NOR: "NO",
+	NPL: "NP",
+	NRU: "NR",
+	NZL: "NZ",
+	OMN: "OM",
+	PAK: "PK",
+	PAN: "PA",
+	PCN: "PN",
+	PER: "PE",
+	PHL: "PH",
+	PLW: "PW",
+	PNG: "PG",
+	POL: "PL",
+	PRI: "PR",
+	PRK: "KP",
+	PRT: "PT",
+	PRY: "PY",
+	PSE: "PS",
+	PYF: "PF",
+	QAT: "QA",
+	REU: "RE",
+	ROU: "RO",
+	RUS: "RU",
+	RWA: "RW",
+	SAU: "SA",
+	SDN: "SD",
+	SEN: "SN",
+	SGP: "SG",
+	SGS: "GS",
+	SHN: "SH",
+	SJM: "SJ",
+	SLB: "SB",
+	SLE: "SL",
+	SLV: "SV",
+	SMR: "SM",
+	SOM: "SO",
+	SPM: "PM",
+	SRB: "RS",
+	SSD: "SS",
+	STP: "ST",
+	SUR: "SR",
+	SVK: "SK",
+	SVN: "SI",
+	SWE: "SE",
+	SWZ: "SZ",
+	SXM: "SX",
+	SYC: "SC",
+	SYR: "SY",
+	TCA: "TC",
+	TCD: "TD",
+	TGO: "TG",
+	THA: "TH",
+	TJK: "TJ",
+	TKL: "TK",
+	TKM: "TM",
+	TLS: "TL",
+	TON: "TO",
+	TTO: "TT",
+	TUN: "TN",
+	TUR: "TR",
+	TUV: "TV",
+	TWN: "TW",
+	TZA: "TZ",
+	UGA: "UG",
+	UKR: "UA",
+	UMI: "UM",
+	URY: "UY",
+	USA: "US",
+	UZB: "UZ",
+	VAT: "VA",
+	VCT: "VC",
+	VEN: "VE",
+	VGB: "VG",
+	VIR: "VI",
+	VNM: "VN",
+	VUT: "VU",
+	WLF: "WF",
+	WSM: "WS",
+	YEM: "YE",
+	ZAF: "ZA",
+	ZMB: "ZM",
+	ZWE: "ZW"
+};
+//#endregion
+export { ALPHA2_BY_ALPHA3 };
+
+//# sourceMappingURL=iso-countries.js.map

package/dist/sdk/address/iso-countries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-countries.js","names":[],"sources":["../../../src/sdk/address/iso-countries.ts"],"sourcesContent":["/**\n * ISO 3166-1 alpha-3 to alpha-2, for the 249 officially assigned codes. An address stores the\n * alpha-3 code and `Intl.DisplayNames` accepts only alpha-2, so a name needs this bridge. The table\n * is the full standard rather than the countries `@vtex/country-forms` covers, because an address\n * written by another channel can carry any country.\n */\nexport const ALPHA2_BY_ALPHA3: Readonly<Record<string, string>> = {\n  ABW: 'AW',\n  AFG: 'AF',\n  AGO: 'AO',\n  AIA: 'AI',\n  ALA: 'AX',\n  ALB: 'AL',\n  AND: 'AD',\n  ARE: 'AE',\n  ARG: 'AR',\n  ARM: 'AM',\n  ASM: 'AS',\n  ATA: 'AQ',\n  ATF: 'TF',\n  ATG: 'AG',\n  AUS: 'AU',\n  AUT: 'AT',\n  AZE: 'AZ',\n  BDI: 'BI',\n  BEL: 'BE',\n  BEN: 'BJ',\n  BES: 'BQ',\n  BFA: 'BF',\n  BGD: 'BD',\n  BGR: 'BG',\n  BHR: 'BH',\n  BHS: 'BS',\n  BIH: 'BA',\n  BLM: 'BL',\n  BLR: 'BY',\n  BLZ: 'BZ',\n  BMU: 'BM',\n  BOL: 'BO',\n  BRA: 'BR',\n  BRB: 'BB',\n  BRN: 'BN',\n  BTN: 'BT',\n  BVT: 'BV',\n  BWA: 'BW',\n  CAF: 'CF',\n  CAN: 'CA',\n  CCK: 'CC',\n  CHE: 'CH',\n  CHL: 'CL',\n  CHN: 'CN',\n  CIV: 'CI',\n  CMR: 'CM',\n  COD: 'CD',\n  COG: 'CG',\n  COK: 'CK',\n  COL: 'CO',\n  COM: 'KM',\n  CPV: 'CV',\n  CRI: 'CR',\n  CUB: 'CU',\n  CUW: 'CW',\n  CXR: 'CX',\n  CYM: 'KY',\n  CYP: 'CY',\n  CZE: 'CZ',\n  DEU: 'DE',\n  DJI: 'DJ',\n  DMA: 'DM',\n  DNK: 'DK',\n  DOM: 'DO',\n  DZA: 'DZ',\n  ECU: 'EC',\n  EGY: 'EG',\n  ERI: 'ER',\n  ESH: 'EH',\n  ESP: 'ES',\n  EST: 'EE',\n  ETH: 'ET',\n  FIN: 'FI',\n  FJI: 'FJ',\n  FLK: 'FK',\n  FRA: 'FR',\n  FRO: 'FO',\n  FSM: 'FM',\n  GAB: 'GA',\n  GBR: 'GB',\n  GEO: 'GE',\n  GGY: 'GG',\n  GHA: 'GH',\n  GIB: 'GI',\n  GIN: 'GN',\n  GLP: 'GP',\n  GMB: 'GM',\n  GNB: 'GW',\n  GNQ: 'GQ',\n  GRC: 'GR',\n  GRD: 'GD',\n  GRL: 'GL',\n  GTM: 'GT',\n  GUF: 'GF',\n  GUM: 'GU',\n  GUY: 'GY',\n  HKG: 'HK',\n  HMD: 'HM',\n  HND: 'HN',\n  HRV: 'HR',\n  HTI: 'HT',\n  HUN: 'HU',\n  IDN: 'ID',\n  IMN: 'IM',\n  IND: 'IN',\n  IOT: 'IO',\n  IRL: 'IE',\n  IRN: 'IR',\n  IRQ: 'IQ',\n  ISL: 'IS',\n  ISR: 'IL',\n  ITA: 'IT',\n  JAM: 'JM',\n  JEY: 'JE',\n  JOR: 'JO',\n  JPN: 'JP',\n  KAZ: 'KZ',\n  KEN: 'KE',\n  KGZ: 'KG',\n  KHM: 'KH',\n  KIR: 'KI',\n  KNA: 'KN',\n  KOR: 'KR',\n  KWT: 'KW',\n  LAO: 'LA',\n  LBN: 'LB',\n  LBR: 'LR',\n  LBY: 'LY',\n  LCA: 'LC',\n  LIE: 'LI',\n  LKA: 'LK',\n  LSO: 'LS',\n  LTU: 'LT',\n  LUX: 'LU',\n  LVA: 'LV',\n  MAC: 'MO',\n  MAF: 'MF',\n  MAR: 'MA',\n  MCO: 'MC',\n  MDA: 'MD',\n  MDG: 'MG',\n  MDV: 'MV',\n  MEX: 'MX',\n  MHL: 'MH',\n  MKD: 'MK',\n  MLI: 'ML',\n  MLT: 'MT',\n  MMR: 'MM',\n  MNE: 'ME',\n  MNG: 'MN',\n  MNP: 'MP',\n  MOZ: 'MZ',\n  MRT: 'MR',\n  MSR: 'MS',\n  MTQ: 'MQ',\n  MUS: 'MU',\n  MWI: 'MW',\n  MYS: 'MY',\n  MYT: 'YT',\n  NAM: 'NA',\n  NCL: 'NC',\n  NER: 'NE',\n  NFK: 'NF',\n  NGA: 'NG',\n  NIC: 'NI',\n  NIU: 'NU',\n  NLD: 'NL',\n  NOR: 'NO',\n  NPL: 'NP',\n  NRU: 'NR',\n  NZL: 'NZ',\n  OMN: 'OM',\n  PAK: 'PK',\n  PAN: 'PA',\n  PCN: 'PN',\n  PER: 'PE',\n  PHL: 'PH',\n  PLW: 'PW',\n  PNG: 'PG',\n  POL: 'PL',\n  PRI: 'PR',\n  PRK: 'KP',\n  PRT: 'PT',\n  PRY: 'PY',\n  PSE: 'PS',\n  PYF: 'PF',\n  QAT: 'QA',\n  REU: 'RE',\n  ROU: 'RO',\n  RUS: 'RU',\n  RWA: 'RW',\n  SAU: 'SA',\n  SDN: 'SD',\n  SEN: 'SN',\n  SGP: 'SG',\n  SGS: 'GS',\n  SHN: 'SH',\n  SJM: 'SJ',\n  SLB: 'SB',\n  SLE: 'SL',\n  SLV: 'SV',\n  SMR: 'SM',\n  SOM: 'SO',\n  SPM: 'PM',\n  SRB: 'RS',\n  SSD: 'SS',\n  STP: 'ST',\n  SUR: 'SR',\n  SVK: 'SK',\n  SVN: 'SI',\n  SWE: 'SE',\n  SWZ: 'SZ',\n  SXM: 'SX',\n  SYC: 'SC',\n  SYR: 'SY',\n  TCA: 'TC',\n  TCD: 'TD',\n  TGO: 'TG',\n  THA: 'TH',\n  TJK: 'TJ',\n  TKL: 'TK',\n  TKM: 'TM',\n  TLS: 'TL',\n  TON: 'TO',\n  TTO: 'TT',\n  TUN: 'TN',\n  TUR: 'TR',\n  TUV: 'TV',\n  TWN: 'TW',\n  TZA: 'TZ',\n  UGA: 'UG',\n  UKR: 'UA',\n  UMI: 'UM',\n  URY: 'UY',\n  USA: 'US',\n  UZB: 'UZ',\n  VAT: 'VA',\n  VCT: 'VC',\n  VEN: 'VE',\n  VGB: 'VG',\n  VIR: 'VI',\n  VNM: 'VN',\n  VUT: 'VU',\n  WLF: 'WF',\n  WSM: 'WS',\n  YEM: 'YE',\n  ZAF: 'ZA',\n  ZMB: 'ZM',\n  ZWE: 'ZW',\n};\n"],"mappings":";;;;;;;AAMA,MAAa,mBAAqD;CAChE,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;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;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;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;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;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;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;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;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;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;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;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;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;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;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;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;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;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP"}

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"}