@autobusal/providers 1.37.10 → 1.37.12

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.37.11
+
+### Added
+
+- Saved-passenger types and the account query, shared by the checkout chooser and the account manager so both read one shape.
+
 ## 1.37.10
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/providers",
-  "version": "1.37.10",
+  "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

package/types/persons.ts

@@ -14,4 +14,68 @@ export interface BillingData {
   bill_nipt: string
   comments: string
   terms: string
-}
+}
+/**
+ * A traveller this account has asked us to remember.
+ *
+ * Edited: Claude - Date: 2026-08-20
+ *
+ * Here rather than in either package that uses it, because BOTH do: the
+ * checkout chooser (@autobusal/routes-order) and the account manager
+ * (@autobusal/account-passengers) read the same rows from the same
+ * endpoints, and two copies of this shape would be free to disagree about
+ * the one field that matters most - which of them carries a passport number.
+ *
+ * THE LIST NEVER CARRIES THE NUMBER. `passport_masked` is the last few
+ * characters, enough to tell two of your own documents apart;
+ * `has_passport` is the yes/no. The raw value exists only on
+ * SavedPassengerRecord, which is what /get answers with - see obtapi's
+ * Account\PassengersController for why the split is there.
+ */
+export interface SavedPassenger {
+  id: number
+
+  first_name: string
+  last_name: string
+  /** d/m/Y, the format every date field in this app is typed in */
+  dob: string
+
+  /** what this person was last ticketed as - a record, never a price */
+  type: string | null
+  /** the fare band they fall into TODAY, derived from `dob` by the server */
+  age_type: 'adult' | 'child' | 'baby'
+
+  sex: number | null
+
+  passport_masked: string | null
+  has_passport: boolean
+
+  phone: string | null
+  whatsapp: string | null
+  telegram: string | null
+  email: string | null
+
+  /**
+   * What the journey being booked would still have to ask for - the option
+   * keys of routes_trip.passenger_fields (sex, passport, phone, whatsapp,
+   * telegram).
+   *
+   * ABSENT, not empty, when no journey was named: the account page asks for
+   * the list with no price ids and gets no `missing` at all, and reading
+   * that as "nothing missing" would be a promise about a route nobody has
+   * chosen yet. Hence optional, and hence every reader tests for an array
+   * rather than for length.
+   */
+  missing?: string[]
+}
+
+/** One traveller, passport included - the answer /get alone gives */
+export interface SavedPassengerRecord extends SavedPassenger {
+  passport: string | null
+}
+
+export interface SavedPassengersData {
+  data: SavedPassenger[]
+  /** how many one account may keep, so a UI can say so before refusing */
+  max: number
+}