@autobusal/providers 1.14.0 → 1.15.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ 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.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.15.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"