@cartbase/storefront 0.19.0 → 0.20.1

package/src/checkout/address-error-copy.ts

@@ -1,117 +1,117 @@
-import type { AddressErrorCopy } from "./labels"
-
-/**
- * Recognizes an address-save failure and picks the copy for it.
- *
- * THE COPY IS NOT HERE. Until 2026-09-13 this file held thirteen hardcoded
- * BULGARIAN sentences, so every merchant who installed the package showed
- * Bulgarian on the one screen where a shopper is about to pay, with no way
- * to override it. The copy now lives in the checkout label pack like all
- * other copy, which means it is English by default and translated by
- * whichever locale the store mounts.
- *
- * WHAT STAYS HERE IS THE RECOGNITION, and it stays on purpose: the codes
- * and the patterns match the API's own error text, which is English wire
- * format, not user-facing copy. Translating the matcher would break it.
- *
- * Ported from `@1click/ui/src/checkout/address-error-copy.ts` (v2.3.1) and
- * adapted to the Cartbase error envelope: `StoreApiError` carries a
- * structured `code` (POST /api/store/carts/:id, docs/storefront/carts.md),
- * so recognition is code-first and the substring patterns are the fallback
- * for network failures and any legacy wire.
- *
- * The mapping is deliberately narrow: only failures we recognize get their
- * own sentence, and everything else gets the generic one rather than
- * half-translated technical text.
- */
-
-/** Cartbase cart-update error codes, mapped to a copy key. Code-first. */
-export const ADDRESS_CODE_KEYS: Record<string, keyof AddressErrorCopy> = {
-  validation_failed: "validationFailed",
-  invalid_region: "invalidRegion",
-  region_required: "regionRequired",
-  cart_completed: "cartCompleted",
-  cart_not_found: "cartNotFound",
-}
-
-/**
- * Patterns matched in order, first match wins: most specific first,
- * generic last. Case-insensitive. Kept verbatim from the production port.
- */
-const PATTERNS: Array<{ match: RegExp; key: keyof AddressErrorCopy }> = [
-  // Email validation — confirmed (in @1click production) as the most common
-  // address-save failure shape.
-  {
-    match: /invalid[\s_]?(?:request:?\s*)?invalid[\s_]?email|invalid[\s_]?email/i,
-    key: "invalidEmail",
-  },
-  {
-    match:
-      /invalid[\s_]?postal|invalid[\s_]?post(?:code|al[\s_]?code)|postal[\s_]?code[\s_]?(?:is[\s_]?)?invalid/i,
-    key: "invalidPostalCode",
-  },
-  {
-    match: /invalid[\s_]?phone|phone[\s_]?(?:number[\s_]?)?(?:is[\s_]?)?invalid/i,
-    key: "invalidPhone",
-  },
-  {
-    match:
-      /invalid[\s_]?country|country[\s_]?(?:code[\s_]?)?(?:is[\s_]?)?invalid|no[\s_]?region|invalid[\s_]?region/i,
-    key: "invalidCountry",
-  },
-  // Cart already completed — race with order placement.
-  {
-    match:
-      /cart[\s_]?(?:is[\s_]?)?already[\s_]?completed|already[\s_]?an[\s_]?order|completed[\s_]?cart/i,
-    key: "cartCompleted",
-  },
-  {
-    match: /cart[\s_]?(?:not[\s_]?found|does[\s_]?not[\s_]?exist|expired)/i,
-    key: "cartNotFound",
-  },
-  {
-    match: /failed[\s_]?to[\s_]?fetch|network[\s_]?error|networkerror|econnreset|etimedout/i,
-    key: "network",
-  },
-  // The Next.js canned Server Components production message — surface a
-  // clean fallback instead of the English placeholder. (The Cartbase SDK
-  // throws from the browser, so this only fires for stores that proxy the
-  // save through a server action.)
-  {
-    match: /server[\s_]?components[\s_]?render|digest property is included/i,
-    key: "generic",
-  },
-]
-
-/** Which copy an error asks for, independent of language. */
-export function addressErrorKey(err: unknown): keyof AddressErrorCopy {
-  if (err && typeof err === "object") {
-    const code = (err as { code?: unknown }).code
-    if (typeof code === "string" && ADDRESS_CODE_KEYS[code]) return ADDRESS_CODE_KEYS[code]
-  }
-  const raw = extractMessage(err)
-  if (!raw) return "generic"
-  for (const { match, key } of PATTERNS) {
-    if (match.test(raw)) return key
-  }
-  return "generic"
-}
-
-/**
- * Turn any thrown or returned address-save error into the sentence a
- * shopper reads, in the store's own language.
- */
-export function translateAddressError(err: unknown, copy: AddressErrorCopy): string {
-  return copy[addressErrorKey(err)]
-}
-
-function extractMessage(err: unknown): string {
-  if (!err) return ""
-  if (typeof err === "string") return err
-  if (err instanceof Error) return err.message
-  if (typeof err === "object" && err !== null) {
-    const e = err as { message?: string; code?: string; type?: string }
-    return [e.message, e.code, e.type].filter(Boolean).join(" ")
-  }
-  return String(err)
-}
+import type { AddressErrorCopy } from "./labels"
+
+/**
+ * Recognizes an address-save failure and picks the copy for it.
+ *
+ * THE COPY IS NOT HERE. Until 2026-09-13 this file held thirteen hardcoded
+ * BULGARIAN sentences, so every merchant who installed the package showed
+ * Bulgarian on the one screen where a shopper is about to pay, with no way
+ * to override it. The copy now lives in the checkout label pack like all
+ * other copy, which means it is English by default and translated by
+ * whichever locale the store mounts.
+ *
+ * WHAT STAYS HERE IS THE RECOGNITION, and it stays on purpose: the codes
+ * and the patterns match the API's own error text, which is English wire
+ * format, not user-facing copy. Translating the matcher would break it.
+ *
+ * Ported from `@1click/ui/src/checkout/address-error-copy.ts` (v2.3.1) and
+ * adapted to the Cartbase error envelope: `StoreApiError` carries a
+ * structured `code` (POST /api/store/carts/:id, docs/storefront/carts.md),
+ * so recognition is code-first and the substring patterns are the fallback
+ * for network failures and any legacy wire.
+ *
+ * The mapping is deliberately narrow: only failures we recognize get their
+ * own sentence, and everything else gets the generic one rather than
+ * half-translated technical text.
+ */
+
+/** Cartbase cart-update error codes, mapped to a copy key. Code-first. */
+export const ADDRESS_CODE_KEYS: Record<string, keyof AddressErrorCopy> = {
+  validation_failed: "validationFailed",
+  invalid_region: "invalidRegion",
+  region_required: "regionRequired",
+  cart_completed: "cartCompleted",
+  cart_not_found: "cartNotFound",
+}
+
+/**
+ * Patterns matched in order, first match wins: most specific first,
+ * generic last. Case-insensitive. Kept verbatim from the production port.
+ */
+const PATTERNS: Array<{ match: RegExp; key: keyof AddressErrorCopy }> = [
+  // Email validation — confirmed (in @1click production) as the most common
+  // address-save failure shape.
+  {
+    match: /invalid[\s_]?(?:request:?\s*)?invalid[\s_]?email|invalid[\s_]?email/i,
+    key: "invalidEmail",
+  },
+  {
+    match:
+      /invalid[\s_]?postal|invalid[\s_]?post(?:code|al[\s_]?code)|postal[\s_]?code[\s_]?(?:is[\s_]?)?invalid/i,
+    key: "invalidPostalCode",
+  },
+  {
+    match: /invalid[\s_]?phone|phone[\s_]?(?:number[\s_]?)?(?:is[\s_]?)?invalid/i,
+    key: "invalidPhone",
+  },
+  {
+    match:
+      /invalid[\s_]?country|country[\s_]?(?:code[\s_]?)?(?:is[\s_]?)?invalid|no[\s_]?region|invalid[\s_]?region/i,
+    key: "invalidCountry",
+  },
+  // Cart already completed — race with order placement.
+  {
+    match:
+      /cart[\s_]?(?:is[\s_]?)?already[\s_]?completed|already[\s_]?an[\s_]?order|completed[\s_]?cart/i,
+    key: "cartCompleted",
+  },
+  {
+    match: /cart[\s_]?(?:not[\s_]?found|does[\s_]?not[\s_]?exist|expired)/i,
+    key: "cartNotFound",
+  },
+  {
+    match: /failed[\s_]?to[\s_]?fetch|network[\s_]?error|networkerror|econnreset|etimedout/i,
+    key: "network",
+  },
+  // The Next.js canned Server Components production message — surface a
+  // clean fallback instead of the English placeholder. (The Cartbase SDK
+  // throws from the browser, so this only fires for stores that proxy the
+  // save through a server action.)
+  {
+    match: /server[\s_]?components[\s_]?render|digest property is included/i,
+    key: "generic",
+  },
+]
+
+/** Which copy an error asks for, independent of language. */
+export function addressErrorKey(err: unknown): keyof AddressErrorCopy {
+  if (err && typeof err === "object") {
+    const code = (err as { code?: unknown }).code
+    if (typeof code === "string" && ADDRESS_CODE_KEYS[code]) return ADDRESS_CODE_KEYS[code]
+  }
+  const raw = extractMessage(err)
+  if (!raw) return "generic"
+  for (const { match, key } of PATTERNS) {
+    if (match.test(raw)) return key
+  }
+  return "generic"
+}
+
+/**
+ * Turn any thrown or returned address-save error into the sentence a
+ * shopper reads, in the store's own language.
+ */
+export function translateAddressError(err: unknown, copy: AddressErrorCopy): string {
+  return copy[addressErrorKey(err)]
+}
+
+function extractMessage(err: unknown): string {
+  if (!err) return ""
+  if (typeof err === "string") return err
+  if (err instanceof Error) return err.message
+  if (typeof err === "object" && err !== null) {
+    const e = err as { message?: string; code?: string; type?: string }
+    return [e.message, e.code, e.type].filter(Boolean).join(" ")
+  }
+  return String(err)
+}