@autobusal/providers 1.14.0 → 1.16.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ 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.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
+
+- **The URL decides the language.** `getLanguage()` now reads a locale prefix
+  off the path before falling back to the stored preference and then the
+  brand default, and takes the brand's `available` list so an unrecognised
+  first segment (`/city/tirana`) is never mistaken for a language. This is
+  the point of localised URLs: a link has to decide what its recipient sees,
+  so someone whose last visit was in Albanian still gets Italian from a
+  shared `/it/...` link. Unprefixed URLs are unaffected.
+
 ## [1.14.0] - 2026-08-02
 
 ### Changed

package/Setup/Setup.tsx

@@ -15,7 +15,7 @@ const Setup = ({ type, children }: Props): JSX.Element => {
   useGetMenu();
   useUserBootstrap();
 
-  languages(type, data.preferences.languages.default);
+  languages(type, data.preferences.languages.default, data.preferences.languages.available);
 
   // Edited: Ferjolt Ozuni - Date: 2026-08-01
   // The brand's GTM container, from labels_settings via the admin GUI.

package/Setup/languages.ts

@@ -2,9 +2,34 @@ import i18next from 'i18next';
 import Backend from 'i18next-http-backend';
 import { initReactI18next } from 'react-i18next';
 
-export const getLanguage = (defaultLanguage: string): string => (
-  localStorage.getItem('language') ?? defaultLanguage
-);
+/**
+ * The language to start in.
+ *
+ * Edited: Ferjolt Ozuni - Date: 2026-08-02
+ * A locale-prefixed URL now wins over the stored preference. That ordering
+ * is the whole point of localised URLs: a link has to decide what its
+ * recipient sees, so somebody whose last visit was in Albanian must still
+ * get Italian when they open a shared /it/... link. The stored preference
+ * still covers every unprefixed URL - the homepage a returning visitor
+ * types in, and the whole account area, which is not localised.
+ *
+ * `available` is passed in rather than read from anywhere global so this
+ * stays a pure function of its inputs, and so an unrecognised first segment
+ * (/city/tirana) is never mistaken for a language.
+ */
+export const getLanguage = (defaultLanguage: string, available: string[] = []): string => {
+  const [ , first ] = window.location.pathname.split('/');
+
+  if (first && available.includes(first)) {
+    return first;
+  }
+
+  const stored = localStorage.getItem('language');
+
+  return (stored && (available.length === 0 || available.includes(stored)))
+    ? stored
+    : defaultLanguage;
+};
 
 // Cache-busting query param for the language files. `Cache-Control: no-cache`
 // on the obtapi side only asks caches to revalidate before reuse - in
@@ -18,7 +43,7 @@ export const getLanguage = (defaultLanguage: string): string => (
 // consumer that hasn't set VITE_BUILD_ID yet (no worse than before).
 const buildId = import.meta.env.VITE_BUILD_ID ?? 'dev';
 
-const languages = (type: string, defaultLanguage: string): void => {
+const languages = (type: string, defaultLanguage: string, available: string[] = []): void => {
   if (i18next.isInitialized) {
     return;
   }
@@ -30,7 +55,7 @@ const languages = (type: string, defaultLanguage: string): void => {
       interpolation: {
         escapeValue: false
       },
-      lng: getLanguage(defaultLanguage),
+      lng: getLanguage(defaultLanguage, available),
       fallbackLng: defaultLanguage,
       debug: import.meta.env.DEV,
       backend: {
@@ -45,7 +70,7 @@ const languages = (type: string, defaultLanguage: string): void => {
   // immediately (don't wait for the async backend fetch) and keep it in sync
   // on every future change, whether triggered by ChangeLanguage or anything
   // else that calls i18next.changeLanguage().
-  document.documentElement.lang = getLanguage(defaultLanguage);
+  document.documentElement.lang = getLanguage(defaultLanguage, available);
   i18next.on('languageChanged', (lng) => {
     document.documentElement.lang = lng;
   });

package/package.json

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