@flopay/shared 1.3.1 → 1.3.2

package/dist/index.d.cts

@@ -1312,7 +1312,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.3.1";
+declare const SDK_VERSION = "1.3.2";
 /**
  * HTTP header the SDK sends on `POST /v1/checkouts/sessions` so the backend
  * can decide whether to embed the vault capture block (the hosted PCI card
@@ -1746,24 +1746,33 @@ declare function getStateFromPostalCode(country: string, postalCode: string): st
 
 /**
  * True when `validator` has an authoritative postcode pattern for the country
- * (ISO 3166-1 alpha-2, case-insensitive). Supported countries validate the
- * postcode format; unsupported / no-postcode countries fail open.
+ * (normalized to ISO 3166-1 alpha-2 via {@link normalizeCountryToIso2}).
+ * Supported countries validate the postcode format; unsupported / no-postcode /
+ * unresolvable countries fail open. Note the 2-letter passthrough means `UK`
+ * (an unsupported `validator` locale) returns `false` here — matching the
+ * backend; use the full name `United Kingdom` for `GB` semantics.
  */
 declare function isPostalCodeSupported(country: string): boolean;
 /**
- * Validate a postcode against the country's expected format.
+ * Validate a postcode against the country's expected format. A faithful mirror
+ * of the backend's `isPostalCodeValidForCountry`, so the SDK never blocks a
+ * value the server would accept, nor opens the submit gate on one it would
+ * reject. Fail-open (returns `true`) in exactly the backend's three cases:
  *
- * - Unsupported / no-postcode country → `true` (fail open; never block).
- * - Supported country → `validator`'s `isPostalCode(zip, locale)` on the
- *   trimmed value. An empty string is not a valid postcode, so a supported
- *   country with an empty value returns `false`; callers that distinguish
- *   "required" (empty) from "malformed" (format) should check emptiness first.
+ * - `postalCode` is blank / whitespace-only;
+ * - the country can't be normalized to an ISO-2 locale;
+ * - the ISO-2 locale isn't one `validator` recognises.
+ *
+ * Otherwise returns `validator`'s `isPostalCode(zip.trim(), locale)`. Callers
+ * that distinguish "required" (empty) from "malformed" (bad format) must check
+ * emptiness themselves — an empty value fails open here, as it does server-side.
  */
 declare function isValidPostalCode(country: string, postalCode: string): boolean;
 /**
- * A curated example postcode for the country (e.g. US `12345 or 12345-6789`,
- * GB `SW1A 1AA`, CA `A1A 1A1`), or `undefined` when there is no curated example
- * (unsupported country, or a supported country not in the map).
+ * The example postcode the backend would embed in its 400 message for the
+ * country (e.g. US `12345 or 12345-6789`, GB `SW1A 1AA`, CA `A1A 1A1`), or
+ * `undefined` when there is none (unresolvable country, or a supported country
+ * absent from {@link POSTAL_CODE_EXAMPLES}).
  */
 declare function getPostalCodeExample(country: string): string | undefined;
 

package/dist/index.d.ts

@@ -1312,7 +1312,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.3.1";
+declare const SDK_VERSION = "1.3.2";
 /**
  * HTTP header the SDK sends on `POST /v1/checkouts/sessions` so the backend
  * can decide whether to embed the vault capture block (the hosted PCI card
@@ -1746,24 +1746,33 @@ declare function getStateFromPostalCode(country: string, postalCode: string): st
 
 /**
  * True when `validator` has an authoritative postcode pattern for the country
- * (ISO 3166-1 alpha-2, case-insensitive). Supported countries validate the
- * postcode format; unsupported / no-postcode countries fail open.
+ * (normalized to ISO 3166-1 alpha-2 via {@link normalizeCountryToIso2}).
+ * Supported countries validate the postcode format; unsupported / no-postcode /
+ * unresolvable countries fail open. Note the 2-letter passthrough means `UK`
+ * (an unsupported `validator` locale) returns `false` here — matching the
+ * backend; use the full name `United Kingdom` for `GB` semantics.
  */
 declare function isPostalCodeSupported(country: string): boolean;
 /**
- * Validate a postcode against the country's expected format.
+ * Validate a postcode against the country's expected format. A faithful mirror
+ * of the backend's `isPostalCodeValidForCountry`, so the SDK never blocks a
+ * value the server would accept, nor opens the submit gate on one it would
+ * reject. Fail-open (returns `true`) in exactly the backend's three cases:
  *
- * - Unsupported / no-postcode country → `true` (fail open; never block).
- * - Supported country → `validator`'s `isPostalCode(zip, locale)` on the
- *   trimmed value. An empty string is not a valid postcode, so a supported
- *   country with an empty value returns `false`; callers that distinguish
- *   "required" (empty) from "malformed" (format) should check emptiness first.
+ * - `postalCode` is blank / whitespace-only;
+ * - the country can't be normalized to an ISO-2 locale;
+ * - the ISO-2 locale isn't one `validator` recognises.
+ *
+ * Otherwise returns `validator`'s `isPostalCode(zip.trim(), locale)`. Callers
+ * that distinguish "required" (empty) from "malformed" (bad format) must check
+ * emptiness themselves — an empty value fails open here, as it does server-side.
  */
 declare function isValidPostalCode(country: string, postalCode: string): boolean;
 /**
- * A curated example postcode for the country (e.g. US `12345 or 12345-6789`,
- * GB `SW1A 1AA`, CA `A1A 1A1`), or `undefined` when there is no curated example
- * (unsupported country, or a supported country not in the map).
+ * The example postcode the backend would embed in its 400 message for the
+ * country (e.g. US `12345 or 12345-6789`, GB `SW1A 1AA`, CA `A1A 1A1`), or
+ * `undefined` when there is none (unresolvable country, or a supported country
+ * absent from {@link POSTAL_CODE_EXAMPLES}).
  */
 declare function getPostalCodeExample(country: string): string | undefined;
 

package/dist/index.mjs

@@ -79,7 +79,7 @@ var PAYMENT_METHOD_LOGOS = {
 };
 
 // src/constants.ts
-var SDK_VERSION = "1.3.1";
+var SDK_VERSION = "1.3.2";
 var FLO_SDK_VERSION_HEADER = "x-flo-sdk-version";
 var BILLING_API_URL_STAGING = "https://api.stage.flopay.com";
 var BILLING_API_URL_PRODUCTION = "https://api.flopay.com";
@@ -1868,53 +1868,93 @@ if (typeof isPostalCode !== "function") {
 var SUPPORTED_LOCALES = new Set(
   mod.locales.map((code) => code.toUpperCase())
 );
-var LOCALE_ALIASES = {
-  UK: "GB"
+var COUNTRY_ALIASES = {
+  AUSTRALIA: "AU",
+  BRAZIL: "BR",
+  CANADA: "CA",
+  CH: "CH",
+  DENMARK: "DK",
+  DE: "DE",
+  DEUTSCHLAND: "DE",
+  FRANCE: "FR",
+  GB: "GB",
+  GERMANY: "DE",
+  GREATBRITAIN: "GB",
+  GREAT_BRITAIN: "GB",
+  INDIA: "IN",
+  IRELAND: "IE",
+  ITALY: "IT",
+  JAPAN: "JP",
+  MEXICO: "MX",
+  NETHERLANDS: "NL",
+  NEWZEALAND: "NZ",
+  NORWAY: "NO",
+  POLAND: "PL",
+  PORTUGAL: "PT",
+  SINGAPORE: "SG",
+  SOUTHAFRICA: "ZA",
+  SPAIN: "ES",
+  SWEDEN: "SE",
+  SWITZERLAND: "CH",
+  UK: "GB",
+  UNITEDKINGDOM: "GB",
+  UNITEDSTATES: "US",
+  US: "US",
+  USA: "US",
+  "UNITED STATES": "US",
+  "UNITED KINGDOM": "GB",
+  "GREAT BRITAIN": "GB",
+  ENGLAND: "GB"
 };
-function normalizeCountry(country) {
-  const upper = country.trim().toUpperCase();
-  return LOCALE_ALIASES[upper] ?? upper;
+function normalizeCountryToIso2(country) {
+  const upper = (country ?? "").trim().toUpperCase();
+  if (!upper) return null;
+  if (upper.length === 2) return upper;
+  return COUNTRY_ALIASES[upper] ?? null;
 }
 var POSTAL_CODE_EXAMPLES = {
-  US: "12345 or 12345-6789",
-  GB: "SW1A 1AA",
-  CA: "A1A 1A1",
   AU: "2000",
-  NZ: "6011",
-  IE: "D02 AF30",
+  BR: "01000-000",
+  CA: "A1A 1A1",
+  CH: "8001",
   DE: "10115",
-  FR: "75008",
-  NL: "1011 AB",
+  DK: "1050",
   ES: "28001",
-  IT: "00100",
+  FR: "75008",
+  GB: "SW1A 1AA",
+  IE: "D02 X285",
   IN: "110001",
+  IT: "00118",
   JP: "100-0001",
-  BR: "01310-100",
-  MX: "01000",
-  SE: "114 55",
-  CH: "8001",
+  MX: "06500",
+  NL: "1012 JS",
+  NO: "0150",
+  NZ: "6011",
   PL: "00-001",
-  PT: "1000-001",
-  SG: "570150",
-  ZA: "0001",
-  NO: "0001",
-  DK: "1050",
-  FI: "00100",
-  AT: "1010",
-  BE: "1000",
-  CZ: "100 00"
+  PT: "1100-148",
+  SE: "111 22",
+  SG: "018989",
+  US: "12345 or 12345-6789",
+  ZA: "8001"
 };
 function isPostalCodeSupported(country) {
-  if (!country) return false;
-  return SUPPORTED_LOCALES.has(normalizeCountry(country));
+  const iso2 = normalizeCountryToIso2(country);
+  return iso2 !== null && SUPPORTED_LOCALES.has(iso2);
 }
 function isValidPostalCode(country, postalCode) {
-  if (!isPostalCodeSupported(country)) return true;
-  return isPostalCode(postalCode.trim(), normalizeCountry(country));
+  const trimmed = (postalCode ?? "").trim();
+  if (!trimmed) return true;
+  const iso2 = normalizeCountryToIso2(country);
+  if (iso2 === null || !SUPPORTED_LOCALES.has(iso2)) return true;
+  try {
+    return isPostalCode(trimmed, iso2);
+  } catch {
+    return true;
+  }
 }
 function getPostalCodeExample(country) {
-  if (!country) return void 0;
-  return POSTAL_CODE_EXAMPLES[normalizeCountry(country)];
+  const iso2 = normalizeCountryToIso2(country);
+  return iso2 ? POSTAL_CODE_EXAMPLES[iso2] : void 0;
 }
 
 // src/checkout-payload.ts