@cartbase/storefront 0.20.0 → 0.21.0

package/src/checkout/geocode.ts

@@ -1,154 +1,154 @@
-/**
- * Geo + Bulgarian place-name helpers for the carrier pickers (Econt office,
- * BoxNow locker).
- *
- * Ported from `@1click/ui/src/lib/geocode.ts` (v2.3.1) verbatim — the lib
- * family of `@cartbase/storefront` does not ship a geocode module, so the
- * checkout family (its only consumer) carries it. Extra file beyond the
- * pre-declared export list → exported from the family barrel only.
- */
-
-/**
- * transliterateBgToLatin — Bulgarian Cyrillic → Latin transliteration
- * using the streamlined system (official BG government standard, used
- * on passports and road signs).
- *
- * Purpose: when a Bulgarian user types "Sofia" but the data source has
- * "София", substring matching fails. Normalize both sides through this
- * function before comparing.
- *
- * Idempotent — Latin input passes through unchanged (just lowercased).
- */
-const BG_CYRILLIC_TO_LATIN: Record<string, string> = {
-  а: "a", б: "b", в: "v", г: "g", д: "d", е: "e", ж: "zh",
-  з: "z", и: "i", й: "y", к: "k", л: "l", м: "m", н: "n",
-  о: "o", п: "p", р: "r", с: "s", т: "t", у: "u", ф: "f",
-  х: "h", ц: "ts", ч: "ch", ш: "sh", щ: "sht",
-  ъ: "a", ь: "y", ю: "yu", я: "ya",
-}
-
-export function transliterateBgToLatin(s: string): string {
-  return s
-    .toLowerCase()
-    .split("")
-    .map((c) => BG_CYRILLIC_TO_LATIN[c] ?? c)
-    .join("")
-}
-
-/**
- * normalizeForMatch — produce a canonical key for fuzzy place-name matching.
- *
- * Built on `transliterateBgToLatin` but additionally collapses common
- * Bulgarian / South Slavic Latinization variants:
- *
- *   - "София"  →  "sofiya"  →  "sofia"   (strict transliteration → common)
- *   - "Sofia"  →  "sofia"   →  "sofia"
- *   - "Sofiya" →  "sofiya"  →  "sofia"
- *   - "Sofija" →  "sofija"  →  "sofia"
- *   - "Sofiia" →  "sofiia"  →  "sofia"
- *
- * Rule: any "iy" / "ij" / "ii" before a vowel collapses to "i". This is
- * the ONE pattern that breaks substring matching for Bulgarian cities.
- * Strict transliteration emits "ya" for "я" (correct on passports), but
- * BoxNow / Econt / OpenStreetMap commonly use the more colloquial "ia"
- * spelling — so users typing "Sofia" must match data containing "София".
- *
- * Use this — not `transliterateBgToLatin` directly — wherever you compare
- * a user-entered place name against an external data source's name.
- * Reserve `transliterateBgToLatin` for outbound contexts (API queries,
- * passport-shaped output) where the strict form is required.
- */
-export function normalizeForMatch(s: string): string {
-  return transliterateBgToLatin(s)
-    .replace(/iy(?=[aeiouy])/g, "i")
-    .replace(/ij(?=[aeiouy])/g, "i")
-    .replace(/ii(?=[aeiouy])/g, "i")
-}
-
-/**
- * Shared geo helpers used by Bulgarian fulfillment selectors (Econt, BoxNow).
- *
- * Nominatim usage is rate-limited (1 req/s/IP per their ToS); for a
- * typical checkout we only call once per address change, well under the
- * limit.
- */
-
-export function distanceMeters(
-  lat1: number,
-  lon1: number,
-  lat2: number,
-  lon2: number
-): number {
-  const R = 6371000
-  const dLat = ((lat2 - lat1) * Math.PI) / 180
-  const dLon = ((lon2 - lon1) * Math.PI) / 180
-  const a =
-    Math.sin(dLat / 2) ** 2 +
-    Math.cos((lat1 * Math.PI) / 180) *
-      Math.cos((lat2 * Math.PI) / 180) *
-      Math.sin(dLon / 2) ** 2
-  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a))
-}
-
-export function formatDistance(meters: number): string {
-  if (meters < 1000) return `${Math.round(meters)} m`
-  return `${(meters / 1000).toFixed(1)} km`
-}
-
-/**
- * cleanAddress — strip Bulgarian address prefixes/suffixes (ул., бул.,
- * вх., ет., ап., etc.) to give Nominatim a better chance at a hit.
- */
-export function cleanAddress(raw: string): string {
-  return raw
-    .replace(/^(ул|ul)\.?\s*/i, "")
-    .replace(/^(бул|bul)\.?\s*/i, "")
-    .replace(/^(пл|pl)\.?\s*/i, "")
-    .replace(/^(жк|zhk|jk)\.?\s*/i, "")
-    .replace(/^(ж\.к|zh\.k)\.?\s*/i, "")
-    .replace(/^(кв|kv)\.?\s*/i, "")
-    .replace(/^(с|s)\.?\s+/i, "")
-    .replace(/^(гр|gr)\.?\s*/i, "")
-    .replace(/[„""()]/g, "")
-    .replace(
-      /\s*[,;]?\s*(вх|vh|ет|et|fl|ап|ap|apt|офис|office|стая|room|секция|корпус|каб|entr|entrance)\.?\s*.*/i,
-      ""
-    )
-    .replace(/\s*(бл|bl|block)\.?\s*(\d+)\s*.*/i, " $2")
-    .replace(/(\d+)\s*[А-Яа-яA-Za-z]$/, "$1")
-    .replace(/[,.\s]+$/, "")
-    .trim()
-}
-
-/**
- * geocodeAddress — hit OpenStreetMap Nominatim for a Bulgarian address.
- * Returns { lat, lng } or null when no hit / network error.
- */
-export async function geocodeAddress(
-  city: string,
-  address: string
-): Promise<{ lat: number; lng: number } | null> {
-  try {
-    const cleaned = cleanAddress(address)
-    const numMatch = cleaned.match(/^(.+?)\s+(\d+\S*)$/)
-    const street = numMatch ? `${numMatch[2]} ${numMatch[1]}` : cleaned
-
-    const url = new URL("https://nominatim.openstreetmap.org/search")
-    url.searchParams.set("city", city)
-    url.searchParams.set("street", street)
-    url.searchParams.set("country", "Bulgaria")
-    url.searchParams.set("format", "json")
-    url.searchParams.set("limit", "1")
-
-    const res = await fetch(url.toString(), {
-      headers: { "User-Agent": "cartbase-storefront/1.0" },
-    })
-    const data = await res.json()
-    if (data?.[0]) {
-      return { lat: parseFloat(data[0].lat), lng: parseFloat(data[0].lon) }
-    }
-    return null
-  } catch {
-    return null
-  }
-}
+/**
+ * Geo + Bulgarian place-name helpers for the carrier pickers (Econt office,
+ * BoxNow locker).
+ *
+ * Ported from `@1click/ui/src/lib/geocode.ts` (v2.3.1) verbatim — the lib
+ * family of `@cartbase/storefront` does not ship a geocode module, so the
+ * checkout family (its only consumer) carries it. Extra file beyond the
+ * pre-declared export list → exported from the family barrel only.
+ */
+
+/**
+ * transliterateBgToLatin — Bulgarian Cyrillic → Latin transliteration
+ * using the streamlined system (official BG government standard, used
+ * on passports and road signs).
+ *
+ * Purpose: when a Bulgarian user types "Sofia" but the data source has
+ * "София", substring matching fails. Normalize both sides through this
+ * function before comparing.
+ *
+ * Idempotent — Latin input passes through unchanged (just lowercased).
+ */
+const BG_CYRILLIC_TO_LATIN: Record<string, string> = {
+  а: "a", б: "b", в: "v", г: "g", д: "d", е: "e", ж: "zh",
+  з: "z", и: "i", й: "y", к: "k", л: "l", м: "m", н: "n",
+  о: "o", п: "p", р: "r", с: "s", т: "t", у: "u", ф: "f",
+  х: "h", ц: "ts", ч: "ch", ш: "sh", щ: "sht",
+  ъ: "a", ь: "y", ю: "yu", я: "ya",
+}
+
+export function transliterateBgToLatin(s: string): string {
+  return s
+    .toLowerCase()
+    .split("")
+    .map((c) => BG_CYRILLIC_TO_LATIN[c] ?? c)
+    .join("")
+}
+
+/**
+ * normalizeForMatch — produce a canonical key for fuzzy place-name matching.
+ *
+ * Built on `transliterateBgToLatin` but additionally collapses common
+ * Bulgarian / South Slavic Latinization variants:
+ *
+ *   - "София"  →  "sofiya"  →  "sofia"   (strict transliteration → common)
+ *   - "Sofia"  →  "sofia"   →  "sofia"
+ *   - "Sofiya" →  "sofiya"  →  "sofia"
+ *   - "Sofija" →  "sofija"  →  "sofia"
+ *   - "Sofiia" →  "sofiia"  →  "sofia"
+ *
+ * Rule: any "iy" / "ij" / "ii" before a vowel collapses to "i". This is
+ * the ONE pattern that breaks substring matching for Bulgarian cities.
+ * Strict transliteration emits "ya" for "я" (correct on passports), but
+ * BoxNow / Econt / OpenStreetMap commonly use the more colloquial "ia"
+ * spelling — so users typing "Sofia" must match data containing "София".
+ *
+ * Use this — not `transliterateBgToLatin` directly — wherever you compare
+ * a user-entered place name against an external data source's name.
+ * Reserve `transliterateBgToLatin` for outbound contexts (API queries,
+ * passport-shaped output) where the strict form is required.
+ */
+export function normalizeForMatch(s: string): string {
+  return transliterateBgToLatin(s)
+    .replace(/iy(?=[aeiouy])/g, "i")
+    .replace(/ij(?=[aeiouy])/g, "i")
+    .replace(/ii(?=[aeiouy])/g, "i")
+}
+
+/**
+ * Shared geo helpers used by Bulgarian fulfillment selectors (Econt, BoxNow).
+ *
+ * Nominatim usage is rate-limited (1 req/s/IP per their ToS); for a
+ * typical checkout we only call once per address change, well under the
+ * limit.
+ */
+
+export function distanceMeters(
+  lat1: number,
+  lon1: number,
+  lat2: number,
+  lon2: number
+): number {
+  const R = 6371000
+  const dLat = ((lat2 - lat1) * Math.PI) / 180
+  const dLon = ((lon2 - lon1) * Math.PI) / 180
+  const a =
+    Math.sin(dLat / 2) ** 2 +
+    Math.cos((lat1 * Math.PI) / 180) *
+      Math.cos((lat2 * Math.PI) / 180) *
+      Math.sin(dLon / 2) ** 2
+  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a))
+}
+
+export function formatDistance(meters: number): string {
+  if (meters < 1000) return `${Math.round(meters)} m`
+  return `${(meters / 1000).toFixed(1)} km`
+}
+
+/**
+ * cleanAddress — strip Bulgarian address prefixes/suffixes (ул., бул.,
+ * вх., ет., ап., etc.) to give Nominatim a better chance at a hit.
+ */
+export function cleanAddress(raw: string): string {
+  return raw
+    .replace(/^(ул|ul)\.?\s*/i, "")
+    .replace(/^(бул|bul)\.?\s*/i, "")
+    .replace(/^(пл|pl)\.?\s*/i, "")
+    .replace(/^(жк|zhk|jk)\.?\s*/i, "")
+    .replace(/^(ж\.к|zh\.k)\.?\s*/i, "")
+    .replace(/^(кв|kv)\.?\s*/i, "")
+    .replace(/^(с|s)\.?\s+/i, "")
+    .replace(/^(гр|gr)\.?\s*/i, "")
+    .replace(/[„""()]/g, "")
+    .replace(
+      /\s*[,;]?\s*(вх|vh|ет|et|fl|ап|ap|apt|офис|office|стая|room|секция|корпус|каб|entr|entrance)\.?\s*.*/i,
+      ""
+    )
+    .replace(/\s*(бл|bl|block)\.?\s*(\d+)\s*.*/i, " $2")
+    .replace(/(\d+)\s*[А-Яа-яA-Za-z]$/, "$1")
+    .replace(/[,.\s]+$/, "")
+    .trim()
+}
+
+/**
+ * geocodeAddress — hit OpenStreetMap Nominatim for a Bulgarian address.
+ * Returns { lat, lng } or null when no hit / network error.
+ */
+export async function geocodeAddress(
+  city: string,
+  address: string
+): Promise<{ lat: number; lng: number } | null> {
+  try {
+    const cleaned = cleanAddress(address)
+    const numMatch = cleaned.match(/^(.+?)\s+(\d+\S*)$/)
+    const street = numMatch ? `${numMatch[2]} ${numMatch[1]}` : cleaned
+
+    const url = new URL("https://nominatim.openstreetmap.org/search")
+    url.searchParams.set("city", city)
+    url.searchParams.set("street", street)
+    url.searchParams.set("country", "Bulgaria")
+    url.searchParams.set("format", "json")
+    url.searchParams.set("limit", "1")
+
+    const res = await fetch(url.toString(), {
+      headers: { "User-Agent": "cartbase-storefront/1.0" },
+    })
+    const data = await res.json()
+    if (data?.[0]) {
+      return { lat: parseFloat(data[0].lat), lng: parseFloat(data[0].lon) }
+    }
+    return null
+  } catch {
+    return null
+  }
+}