@autobusal/providers 1.15.0 → 1.17.0

package/CHANGELOG.md

@@ -7,6 +7,31 @@ adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 > Note: 1.8.0 through 1.11.0 were published without changelog entries. The
 > gap is left as-is rather than reconstructed after the fact.
 
+## [1.17.0] - 2026-08-02
+
+### Changed
+
+- **`FeatureData` gains `slug` and drops `name_sq`.** Amenity names are
+  resolved server-side from obtapi's `lang/{locale}/features.php` now, so
+  `name` already arrives in the request's language - for the SPA and the
+  partner API alike, from one resolution point. `slug` is the stable
+  machine-readable key: `id` is ours alone and `name` moves with the
+  language, so it is the only thing safe to map against.
+
+## [1.16.0] - 2026-08-02
+
+### Changed
+
+- **SEO overrides are per language.** `LabelSettings.seo` and the location
+  types carry a `{locale: {title, description}}` map. The label's homepage
+  override is sent WHOLE and picked client-side, unlike the country/city
+  ones which resolve server-side - not an inconsistency but a bootstrap fact:
+  `/api/settings/get` is the one request that runs before i18n exists, so the
+  server cannot know which language to answer in. Resolving it there put
+  English copy on the Italian homepage.
+- **`seo_keywords` is gone** everywhere. Google has ignored the meta keywords
+  tag since 2009; the field could only ever cost somebody an afternoon.
+
 ## [1.15.0] - 2026-08-02
 
 ### Changed

package/package.json

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

package/types/locations.ts

@@ -30,9 +30,14 @@ export interface CountryData {
   // Optional hand-written override for the public country page's title/
   // description/keywords - see LocationCountry.tsx for the fallback-to-
   // template logic when these are unset.
-  seo_title?: string
-  seo_description?: string
-  seo_keywords?: string
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // Resolved to the request's language server-side on the PUBLIC read,
+  // so these stay flat there; `seo` is the raw per-locale map the admin
+  // form reads and writes. `seo_keywords` is gone - Google has ignored
+  // the meta keywords tag since 2009.
+  seo_title?: string | null
+  seo_description?: string | null
+  seo?: Record<string, { title?: string, description?: string }>
 }
 
 export interface CityStats {
@@ -74,9 +79,14 @@ export interface CityData {
   // Optional hand-written override for the public city page's title/
   // description/keywords - see LocationCity.tsx for the fallback-to-
   // template logic when these are unset.
-  seo_title?: string
-  seo_description?: string
-  seo_keywords?: string
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // Resolved to the request's language server-side on the PUBLIC read,
+  // so these stay flat there; `seo` is the raw per-locale map the admin
+  // form reads and writes. `seo_keywords` is gone - Google has ignored
+  // the meta keywords tag since 2009.
+  seo_title?: string | null
+  seo_description?: string | null
+  seo?: Record<string, { title?: string, description?: string }>
 }
 
 export interface StopData {

package/types/routes.ts

@@ -70,9 +70,21 @@ export interface TripData {
 
 export interface FeatureData {
   id: number
+
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // Already in the request's language - resolved server-side from
+  // lang/{locale}/features.php, so the SPA and the partner API get the same
+  // answer without either translating anything itself.
   name: string
+
+  // The stable key the translation hangs off. Exposed because it is the only
+  // machine-readable identifier that does not change with the language -
+  // `id` is ours alone and `name` moves.
+  slug?: string
+
+  // Admin-facing label and the fallback shown until a slug is translated.
   name_en?: string
-  name_sq?: string
+
   image_url: string
   image?: string[]
 }

package/types/settings.ts

@@ -37,14 +37,18 @@ export interface SettingsData {
   }
 
   // Edited: Ferjolt Ozuni - Date: 2026-07-31
-  // Optional admin-managed override for the homepage's title/description/
-  // keywords (Labels\AdminController::seo()) - StaticHome.tsx prefers these
-  // over its i18n translation-template values when set.
-  seo?: {
-    title?: string
-    description?: string
-    keywords?: string
-  }
+  // Optional admin-managed override for the homepage's title/description
+  // (Labels\AdminController::seo()) - StaticHome.tsx prefers these over its
+  // i18n translation-template values when set.
+  //
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // The WHOLE per-language map, picked client-side by StaticHome - unlike
+  // the country/city overrides, which resolve server-side. This one request
+  // runs before i18n exists (Setup initialises i18n from the settings it is
+  // waiting on), so the server cannot know which language to answer in.
+  // A language with no entry has no override and keeps its own template.
+  // `keywords` is gone: Google has ignored the meta keywords tag since 2009.
+  seo?: Record<string, { title?: string, description?: string }>
 
   preferences: {
     company: string
@@ -226,11 +230,11 @@ export interface LabelSettings {
   // Edited: Ferjolt Ozuni - Date: 2026-07-31
   // Admin-managed homepage SEO override (public seo? above is populated
   // from this) - see Labels\AdminController::seo().
-  seo?: {
-    title?: string
-    description?: string
-    keywords?: string
-  }
+  //
+  // Edited: Ferjolt Ozuni - Date: 2026-08-02
+  // Keyed by locale. A language with no entry has no override at all, which
+  // is what returns that language's homepage to its own template.
+  seo?: Record<string, { title?: string, description?: string }>
 
   // Edited: Ferjolt Ozuni - Date: 2026-08-01
   // Admin-managed Google Tag Manager container. The PUBLIC settings payload