@autobusal/providers 1.37.11 → 1.37.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.37.11",
+  "version": "1.37.12",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"

package/types/locations.ts

@@ -17,12 +17,28 @@ export interface CountryStats {
 
 export interface CountryData {
   id: number
+
+  /**
+   * The name in the caller's language, already resolved server-side.
+   *
+   * Edited: Claude - Date: 2026-08-21
+   * Comes from ICU/CLDR keyed by `iso2`, so all 15 locales are answered
+   * without anybody storing anything - `translations` below is only for the
+   * handful CLDR cannot serve (England, Scotland and Wales are not ISO
+   * countries) or where a brand overrules it.
+   */
   name: string
-  name_en?: string
-  name_sq?: string
+
+  /** Hand-written overrides only, and almost always empty. ADMIN READS ONLY. */
+  translations?: Record<string, string>
+
   slug?: string
   cities?: CityData[]
   iso_code: string
+
+  /** ISO 3166-1 alpha-2 - what the CLDR name lookup is keyed by */
+  iso2?: string | null
+
   available?: number
   stats?: CountryStats
 
@@ -64,9 +80,36 @@ export interface CityDestination {
 
 export interface CityData {
   id: number
+
+  /**
+   * The name in the caller's language, already resolved server-side.
+   *
+   * Edited: Claude - Date: 2026-08-21
+   * This used to be an SQL alias for `name_en`/`name_sq`, the only two
+   * columns the table had, so 13 of the 15 UI locales silently read English.
+   * It is now resolved from a per-locale map with the English column as the
+   * fallback - the field is the same, the answer is right in every language.
+   * The ADMIN endpoints deliberately still answer with English here: it is
+   * the canonical value their form edits.
+   */
   name: string
-  name_en?: string
-  name_sq?: string
+
+  /**
+   * {locale: name} for the other 14 languages. ADMIN READS ONLY - the public
+   * endpoints resolve `name` and omit this.
+   */
+  translations?: Record<string, string>
+
+  /**
+   * Every name this place is known by, in any language or script, for
+   * MATCHING what a visitor types - never for display. Served only by
+   * /api/cities/browse, the one list the search box filters against.
+   */
+  aliases?: string[]
+
+  /** e.g. "Q17151" - what the admin picker stores so the backfill can re-run */
+  wikidata_id?: string | null
+
   location: string[]
   slug: string
   douane?: number