@whop/elements-react-native 0.1.0

package/src/core/address/country-name.ts

@@ -0,0 +1,36 @@
+import { COUNTRY_NAMES_EN } from './country-names.generated';
+
+/**
+ * Hermes ships no `Intl.DisplayNames`, and constructing it there throws
+ * "undefined cannot be used as a constructor" — so it is probed once rather than assumed.
+ *
+ * Where it exists the buyer gets names in their own locale; where it does not, the generated
+ * English table is the floor. The ISO code itself is the last resort, and only for a country the
+ * table does not carry.
+ */
+function displayNamesFor(locale: string): Intl.DisplayNames | null {
+	try {
+		const ctor = (Intl as { DisplayNames?: new (l: string[], o: { type: string }) => Intl.DisplayNames })
+			.DisplayNames;
+		if (typeof ctor !== 'function') return null;
+		return new ctor([locale], { type: 'region' });
+	} catch {
+		return null;
+	}
+}
+
+const cache = new Map<string, Intl.DisplayNames | null>();
+
+export function countryName(code: string, locale: string): string {
+	if (!cache.has(locale)) cache.set(locale, displayNamesFor(locale));
+	const display = cache.get(locale) ?? null;
+	if (display) {
+		try {
+			const name = display.of(code);
+			if (name && name !== code) return name;
+		} catch {
+			// a runtime that constructs but cannot resolve falls through to the table
+		}
+	}
+	return COUNTRY_NAMES_EN[code] ?? code;
+}

package/src/core/address/country-names.generated.ts

@@ -0,0 +1,246 @@
+// GENERATED by scripts/gen-country-names.mjs from Node's ICU. Run `pnpm country-names`.
+//
+// Hermes ships no Intl.DisplayNames, so this is the country selector's name source there.
+
+export const COUNTRY_NAMES_EN: Record<string, string> = {
+	AD: "Andorra",
+	AE: "United Arab Emirates",
+	AF: "Afghanistan",
+	AG: "Antigua & Barbuda",
+	AI: "Anguilla",
+	AL: "Albania",
+	AM: "Armenia",
+	AN: "Curaçao",
+	AO: "Angola",
+	AQ: "Antarctica",
+	AR: "Argentina",
+	AS: "American Samoa",
+	AT: "Austria",
+	AU: "Australia",
+	AW: "Aruba",
+	AZ: "Azerbaijan",
+	BA: "Bosnia & Herzegovina",
+	BB: "Barbados",
+	BD: "Bangladesh",
+	BE: "Belgium",
+	BF: "Burkina Faso",
+	BG: "Bulgaria",
+	BH: "Bahrain",
+	BI: "Burundi",
+	BJ: "Benin",
+	BL: "St. Barthélemy",
+	BM: "Bermuda",
+	BN: "Brunei",
+	BO: "Bolivia",
+	BR: "Brazil",
+	BS: "Bahamas",
+	BT: "Bhutan",
+	BW: "Botswana",
+	BY: "Belarus",
+	BZ: "Belize",
+	CA: "Canada",
+	CC: "Cocos (Keeling) Islands",
+	CD: "Congo - Kinshasa",
+	CF: "Central African Republic",
+	CG: "Congo - Brazzaville",
+	CH: "Switzerland",
+	CI: "Côte d’Ivoire",
+	CK: "Cook Islands",
+	CL: "Chile",
+	CM: "Cameroon",
+	CN: "China",
+	CO: "Colombia",
+	CR: "Costa Rica",
+	CU: "Cuba",
+	CV: "Cape Verde",
+	CW: "Curaçao",
+	CX: "Christmas Island",
+	CY: "Cyprus",
+	CZ: "Czechia",
+	DE: "Germany",
+	DJ: "Djibouti",
+	DK: "Denmark",
+	DM: "Dominica",
+	DO: "Dominican Republic",
+	DZ: "Algeria",
+	EC: "Ecuador",
+	EE: "Estonia",
+	EG: "Egypt",
+	EH: "Western Sahara",
+	ES: "Spain",
+	ET: "Ethiopia",
+	FI: "Finland",
+	FJ: "Fiji",
+	FK: "Falkland Islands",
+	FM: "Micronesia",
+	FO: "Faroe Islands",
+	FR: "France",
+	GA: "Gabon",
+	GB: "United Kingdom",
+	GD: "Grenada",
+	GE: "Georgia",
+	GF: "French Guiana",
+	GG: "Guernsey",
+	GH: "Ghana",
+	GI: "Gibraltar",
+	GL: "Greenland",
+	GM: "Gambia",
+	GN: "Guinea",
+	GP: "Guadeloupe",
+	GQ: "Equatorial Guinea",
+	GR: "Greece",
+	GT: "Guatemala",
+	GU: "Guam",
+	GW: "Guinea-Bissau",
+	GY: "Guyana",
+	HK: "Hong Kong SAR China",
+	HN: "Honduras",
+	HR: "Croatia",
+	HT: "Haiti",
+	HU: "Hungary",
+	ID: "Indonesia",
+	IE: "Ireland",
+	IL: "Israel",
+	IM: "Isle of Man",
+	IN: "India",
+	IO: "British Indian Ocean Territory",
+	IQ: "Iraq",
+	IS: "Iceland",
+	IT: "Italy",
+	JE: "Jersey",
+	JM: "Jamaica",
+	JO: "Jordan",
+	JP: "Japan",
+	KE: "Kenya",
+	KG: "Kyrgyzstan",
+	KH: "Cambodia",
+	KI: "Kiribati",
+	KM: "Comoros",
+	KN: "St. Kitts & Nevis",
+	KR: "South Korea",
+	KW: "Kuwait",
+	KY: "Cayman Islands",
+	KZ: "Kazakhstan",
+	LA: "Laos",
+	LB: "Lebanon",
+	LC: "St. Lucia",
+	LI: "Liechtenstein",
+	LK: "Sri Lanka",
+	LR: "Liberia",
+	LS: "Lesotho",
+	LT: "Lithuania",
+	LU: "Luxembourg",
+	LV: "Latvia",
+	LY: "Libya",
+	MA: "Morocco",
+	MC: "Monaco",
+	MD: "Moldova",
+	ME: "Montenegro",
+	MF: "St. Martin",
+	MG: "Madagascar",
+	MH: "Marshall Islands",
+	MK: "North Macedonia",
+	ML: "Mali",
+	MM: "Myanmar (Burma)",
+	MN: "Mongolia",
+	MO: "Macao SAR China",
+	MP: "Northern Mariana Islands",
+	MQ: "Martinique",
+	MR: "Mauritania",
+	MS: "Montserrat",
+	MT: "Malta",
+	MU: "Mauritius",
+	MV: "Maldives",
+	MW: "Malawi",
+	MX: "Mexico",
+	MY: "Malaysia",
+	MZ: "Mozambique",
+	NA: "Namibia",
+	NC: "New Caledonia",
+	NE: "Niger",
+	NG: "Nigeria",
+	NI: "Nicaragua",
+	NL: "Netherlands",
+	NO: "Norway",
+	NP: "Nepal",
+	NR: "Nauru",
+	NU: "Niue",
+	NZ: "New Zealand",
+	OM: "Oman",
+	PA: "Panama",
+	PE: "Peru",
+	PF: "French Polynesia",
+	PG: "Papua New Guinea",
+	PH: "Philippines",
+	PK: "Pakistan",
+	PL: "Poland",
+	PM: "St. Pierre & Miquelon",
+	PN: "Pitcairn Islands",
+	PR: "Puerto Rico",
+	PS: "Palestinian Territories",
+	PT: "Portugal",
+	PW: "Palau",
+	PY: "Paraguay",
+	QA: "Qatar",
+	RE: "Réunion",
+	RO: "Romania",
+	RS: "Serbia",
+	RU: "Russia",
+	RW: "Rwanda",
+	SA: "Saudi Arabia",
+	SB: "Solomon Islands",
+	SC: "Seychelles",
+	SD: "Sudan",
+	SE: "Sweden",
+	SG: "Singapore",
+	SH: "St. Helena",
+	SI: "Slovenia",
+	SJ: "Svalbard & Jan Mayen",
+	SK: "Slovakia",
+	SL: "Sierra Leone",
+	SM: "San Marino",
+	SN: "Senegal",
+	SO: "Somalia",
+	SR: "Suriname",
+	SS: "South Sudan",
+	ST: "São Tomé & Príncipe",
+	SV: "El Salvador",
+	SX: "Sint Maarten",
+	SZ: "Eswatini",
+	TC: "Turks & Caicos Islands",
+	TD: "Chad",
+	TG: "Togo",
+	TH: "Thailand",
+	TJ: "Tajikistan",
+	TK: "Tokelau",
+	TL: "Timor-Leste",
+	TM: "Turkmenistan",
+	TN: "Tunisia",
+	TO: "Tonga",
+	TR: "Türkiye",
+	TT: "Trinidad & Tobago",
+	TV: "Tuvalu",
+	TW: "Taiwan",
+	TZ: "Tanzania",
+	UA: "Ukraine",
+	UG: "Uganda",
+	UM: "U.S. Outlying Islands",
+	US: "United States",
+	UY: "Uruguay",
+	UZ: "Uzbekistan",
+	VA: "Vatican City",
+	VC: "St. Vincent & Grenadines",
+	VE: "Venezuela",
+	VG: "British Virgin Islands",
+	VI: "U.S. Virgin Islands",
+	VN: "Vietnam",
+	VU: "Vanuatu",
+	WF: "Wallis & Futuna",
+	WS: "Samoa",
+	XK: "Kosovo",
+	YE: "Yemen",
+	YT: "Mayotte",
+	ZA: "South Africa",
+	ZM: "Zambia",
+	ZW: "Zimbabwe",
+};

package/src/core/address/engine.ts

@@ -0,0 +1,349 @@
+// ported from frontend/apps/web/src/elements/address-form/engine.ts — keep in sync when the web
+// element changes. One React Native delta: loadCountryCatalog imports the dataset statically.
+
+import COUNTRY_CATALOG from './country-data';
+
+/**
+ * The Chromium libaddressinput format engine, ported AS DATA from the developer-platform
+ * address-form fork (parse-remote-country-data). Three deliberate fixes over the fork:
+ *  - `zipRegex` is ENFORCED (validateAddressForm) — it was parsed-but-dead there;
+ *  - per-country `upper` flags apply at EMIT (emitAddress), never scattered through the UI;
+ *  - ISO2 is the ONE country boundary — uppercased once at the edge (normalizeCountry), and the
+ *    subdivision iso codes read the dataset's real `sub_isoids` key (the fork read a
+ *    `sub_iso_codes` field that never existed in the data).
+ */
+
+export interface RemoteCountryData {
+  /** Field order + availability: %-prefixed tokens (%N %O %A %C %S %Z %D %X, %n = newline)
+   *  mixed with literal text the postal service prints ("SE-", "SINGAPORE"). */
+  fmt?: string;
+  /** Latin variant of fmt for countries whose native script is non-latin. */
+  lfmt?: string;
+  /** Required-field flag characters (e.g. "ACSZ"). */
+  require?: string;
+  /** Fields the postal service expects uppercased (e.g. "CS"). */
+  upper?: string;
+  /** Country-level postal-code regex (unanchored in the dataset). */
+  zip?: string;
+  /** Example postal codes, comma-separated. */
+  zipex?: string;
+  zip_name_type?: string;
+  state_name_type?: string;
+  /** Subdivision keys / display names / latin names / iso codes, '~'-separated. */
+  sub_keys?: string;
+  sub_names?: string;
+  sub_lnames?: string;
+  sub_isoids?: string;
+}
+
+type FormatFieldType =
+  | 'name'
+  | 'organization'
+  | 'line1'
+  | 'city'
+  | 'state'
+  | 'postal_code'
+  | 'dependent_locality'
+  | 'sorting_code';
+
+export interface StateOption {
+  key: string;
+  name: string;
+  iso?: string;
+}
+
+export interface FormatField {
+  type: FormatFieldType;
+  required: boolean;
+  upper: boolean;
+  postalPlaceholder?: string;
+}
+
+export interface CountryFormat {
+  country: string;
+  fields: FormatField[];
+  zipRegex?: string;
+  stateOptions: StateOption[];
+  stateLabel: StateLabelKind;
+  postalLabel: PostalLabelKind;
+}
+
+const FIELD_TYPE_BY_TOKEN: Partial<Record<string, FormatFieldType>> = {
+  N: 'name',
+  O: 'organization',
+  A: 'line1',
+  C: 'city',
+  S: 'state',
+  Z: 'postal_code',
+  D: 'dependent_locality',
+  X: 'sorting_code',
+};
+
+const STATE_LABELS = [
+  'province',
+  'state',
+  'county',
+  'area',
+  'emirate',
+  'island',
+  'parish',
+  'prefecture',
+  'oblast',
+  'department',
+  'do_si',
+] as const;
+export type StateLabelKind = (typeof STATE_LABELS)[number];
+
+const POSTAL_LABELS = ['postal', 'zip', 'pin', 'eircode'] as const;
+export type PostalLabelKind = (typeof POSTAL_LABELS)[number];
+
+// Dataset gaps the fork patched: missing subdivisions, and a postal format AR does not use.
+const COUNTRY_DATA_OVERRIDES: Record<string, RemoteCountryData | undefined> = {
+  AR: {
+    zip: '\\d{4}|[A-HJ-NP-Z]\\d{4}([A-Z]{3})?',
+  },
+  HN: {
+    sub_keys:
+      'Atlántida~Choluteca~Colón~Comayagua~Copán~Cortés~El Paraíso~Francisco Morazán~Gracias a Dios~Intibucá~Islas de la Bahía~La Paz~Lempira~Ocotepeque~Olancho~Santa Bárbara~Valle~Yoro',
+    sub_names:
+      'Atlántida~Choluteca~Colón~Comayagua~Copán~Cortés~El Paraíso~Francisco Morazán~Gracias a Dios~Intibucá~Islas de la Bahía~La Paz~Lempira~Ocotepeque~Olancho~Santa Bárbara~Valle~Yoro',
+  },
+  CR: {
+    sub_keys: 'Alajuela~Cartago~Guanacaste~Heredia~Limón~Puntarenas~San José',
+    sub_names: 'Alajuela~Cartago~Guanacaste~Heredia~Limón~Puntarenas~San José',
+  },
+  // English names ordered to the dataset's KEPT sub_isoids (AN~BU~…~QR~…~TK~TO~XO) — the
+  // override replaces keys/names only, so its order must match the iso column it rides with.
+  UZ: {
+    sub_keys:
+      'Andijan Region~Bukhara Region~Fergana Region~Jizzakh Region~Namangan Region~Navoiy Region~Qashqadaryo Region~Karakalpakstan~Samarqand Region~Sirdaryo Region~Surxondaryo Region~Tashkent~Tashkent Region~Xorazm Region',
+    sub_names:
+      'Andijan Region~Bukhara Region~Fergana Region~Jizzakh Region~Namangan Region~Navoiy Region~Qashqadaryo Region~Karakalpakstan~Samarqand Region~Sirdaryo Region~Surxondaryo Region~Tashkent~Tashkent Region~Xorazm Region',
+  },
+};
+
+export function normalizeCountry(code: string | undefined): string | undefined {
+  const upper = code?.trim().toUpperCase();
+  return upper && /^[A-Z]{2}$/.test(upper) ? upper : undefined;
+}
+
+function parseStateOptions(data: RemoteCountryData): StateOption[] {
+  const keys = data.sub_keys?.split('~') ?? [];
+  const names = data.sub_names?.split('~') ?? [];
+  const latinNames = data.sub_lnames?.split('~') ?? [];
+  const isoCodes = data.sub_isoids?.split('~') ?? [];
+  const options: StateOption[] = [];
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    if (!key) continue;
+    options.push({
+      key,
+      name: [names[i] || key, latinNames[i]].filter(Boolean).join(' — '),
+      iso: isoCodes[i] || undefined,
+    });
+  }
+  return options;
+}
+
+export function parseCountryFormat(countryCode: string, rawData: RemoteCountryData | undefined): CountryFormat {
+  const country = normalizeCountry(countryCode) ?? 'ZZ';
+  const data = { ...rawData, ...COUNTRY_DATA_OVERRIDES[country] };
+  const format = data.lfmt ?? data.fmt;
+  const stateLabel =
+    data.state_name_type && (STATE_LABELS as readonly string[]).includes(data.state_name_type)
+      ? (data.state_name_type as StateLabelKind)
+      : 'province';
+  const postalLabel =
+    data.zip_name_type && (POSTAL_LABELS as readonly string[]).includes(data.zip_name_type)
+      ? (data.zip_name_type as PostalLabelKind)
+      : 'postal';
+
+  if (!format) {
+    return {
+      country,
+      fields: [
+        { type: 'line1', required: true, upper: false },
+        { type: 'postal_code', required: false, upper: false },
+        { type: 'city', required: false, upper: false },
+      ],
+      zipRegex: data.zip,
+      stateOptions: [],
+      stateLabel,
+      postalLabel,
+    };
+  }
+
+  const fields: FormatField[] = [];
+  for (let i = 0; i < format.length; i++) {
+    // Only %-prefixed chars are field tokens; bare letters are literal print text ("SE-",
+    // "SINGAPORE") — reading them as tokens minted spurious state fields for SE/SG/GG.
+    if (format[i] !== '%') continue;
+    i += 1;
+    const token = format[i] ?? '';
+    const fieldType = FIELD_TYPE_BY_TOKEN[token];
+    if (!fieldType || fields.some((field) => field.type === fieldType)) continue;
+    fields.push({
+      type: fieldType,
+      required: data.require?.includes(token) ?? false,
+      upper: data.upper?.includes(token) ?? false,
+      postalPlaceholder: fieldType === 'postal_code' ? data.zipex?.split(',')[0] : undefined,
+    });
+  }
+  return {
+    country,
+    fields,
+    zipRegex: data.zip,
+    stateOptions: fields.some((field) => field.type === 'state') ? parseStateOptions(data) : [],
+    stateLabel,
+    postalLabel,
+  };
+}
+
+/**
+ * Statically imported, unlike the web element's lazy chunk.
+ *
+ * Metro produces one bundle with no async chunks, so a dynamic `import()` fails at runtime with
+ * "Could not load bundle". Nothing is saved by deferring it either: the data ships in the bundle
+ * either way.
+ */
+export function loadCountryCatalog(): Promise<Record<string, RemoteCountryData>> {
+  return Promise.resolve(COUNTRY_CATALOG);
+}
+
+export function postalCodeMatches(zipRegex: string | undefined, value: string): boolean {
+  if (!zipRegex || !value) return true;
+  try {
+    return new RegExp(`^(?:${zipRegex})$`, 'i').test(value);
+  } catch {
+    return true;
+  }
+}
+
+export interface EmittedAddress {
+  name?: string;
+  first_name?: string;
+  last_name?: string;
+  organization?: string;
+  organization_type?: 'business' | 'individual';
+  line1?: string;
+  line2?: string;
+  city?: string;
+  state?: string;
+  postal_code?: string;
+  country: string;
+}
+
+type UppercasableKey = 'name' | 'organization' | 'line1' | 'city' | 'state' | 'postal_code';
+
+const UPPER_KEY_BY_FIELD: Partial<Record<FormatFieldType, UppercasableKey>> = {
+  name: 'name',
+  organization: 'organization',
+  line1: 'line1',
+  city: 'city',
+  state: 'state',
+  postal_code: 'postal_code',
+};
+
+/** The ONE emit boundary: trims, applies the country's upper flags, uppercases ISO2, and maps
+ *  internal values onto the frozen contract keys (postal_code naming matches ctok
+ *  billing_details 1:1). Empty values are dropped except the always-present country. */
+export function emitAddress(
+  format: CountryFormat,
+  values: {
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    organization?: string;
+    organization_type?: 'business' | 'individual' | '';
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+  },
+): EmittedAddress {
+  const out: EmittedAddress = { country: format.country };
+  const put = (key: Exclude<keyof EmittedAddress, 'country' | 'organization_type'>, raw: string | undefined) => {
+    const value = raw?.trim();
+    if (value) out[key] = value;
+  };
+  put('name', values.name);
+  put('first_name', values.first_name);
+  put('last_name', values.last_name);
+  put('organization', values.organization);
+  put('line1', values.line1);
+  put('line2', values.line2);
+  put('city', values.city);
+  put('state', values.state);
+  put('postal_code', values.postal_code);
+  if (out.organization && (values.organization_type === 'business' || values.organization_type === 'individual')) {
+    out.organization_type = values.organization_type;
+  }
+  for (const field of format.fields) {
+    const key = field.upper ? UPPER_KEY_BY_FIELD[field.type] : undefined;
+    const value = key ? out[key] : undefined;
+    if (key && value) out[key] = value.toUpperCase();
+  }
+  if (format.fields.some((field) => field.type === 'name' && field.upper)) {
+    if (out.first_name) out.first_name = out.first_name.toUpperCase();
+    if (out.last_name) out.last_name = out.last_name.toUpperCase();
+  }
+  return out;
+}
+
+/** Single-country currencies → the country, for the detect-country fallback chain
+ *  (defaultValues > IP country > this > US). Multi-country currencies (eur, xof, …) stay out. */
+const CURRENCY_COUNTRY: Record<string, string> = {
+  usd: 'US',
+  gbp: 'GB',
+  cad: 'CA',
+  aud: 'AU',
+  nzd: 'NZ',
+  jpy: 'JP',
+  brl: 'BR',
+  mxn: 'MX',
+  inr: 'IN',
+  pln: 'PL',
+  chf: 'CH',
+  sek: 'SE',
+  nok: 'NO',
+  dkk: 'DK',
+  czk: 'CZ',
+  huf: 'HU',
+  ron: 'RO',
+  bgn: 'BG',
+  try: 'TR',
+  uah: 'UA',
+  ils: 'IL',
+  aed: 'AE',
+  sar: 'SA',
+  qar: 'QA',
+  kwd: 'KW',
+  zar: 'ZA',
+  ngn: 'NG',
+  kes: 'KE',
+  egp: 'EG',
+  mad: 'MA',
+  sgd: 'SG',
+  hkd: 'HK',
+  twd: 'TW',
+  krw: 'KR',
+  thb: 'TH',
+  php: 'PH',
+  idr: 'ID',
+  myr: 'MY',
+  vnd: 'VN',
+  pkr: 'PK',
+  bdt: 'BD',
+  lkr: 'LK',
+  clp: 'CL',
+  cop: 'CO',
+  pen: 'PE',
+  ars: 'AR',
+  uyu: 'UY',
+  isk: 'IS',
+};
+
+export function currencyCountry(currency: string | undefined): string | undefined {
+  return currency ? CURRENCY_COUNTRY[currency.toLowerCase()] : undefined;
+}