@autobusal/common 1.33.11 → 1.33.12

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.33.12
+
+### Added
+
+- **`DefaultLocaleGate`** - the mirror of `LocaleGate` for the UNPREFIXED public branch: a visitor whose stored language is not the brand default is redirected from `/help` to `/{lang}/help`, so the page shown always matches the address (and its canonical). Crawlers carry no localStorage and keep seeing the canonical default-language page. (Audit decision CMS-07c.)
+
 ## 1.33.11
 
 ### Fixed

package/Locale/DefaultLocaleGate.tsx

@@ -0,0 +1,48 @@
+import { Navigate, useLocation } from 'react-router-dom';
+import { useGetSettings } from '@autobusal/providers/services';
+
+interface Props {
+  children: JSX.Element
+}
+
+/**
+ * Guards the UNPREFIXED branch of the public tree - the mirror of
+ * LocaleGate's job on the /:locale branch.
+ *
+ * Claude - Date: 2026-08-22 (audit decision CMS-07c)
+ *
+ * An unprefixed URL is the default language's canonical home, but the app
+ * used to render it in whatever language localStorage last held: /help
+ * with a stored "it" produced an Italian page whose canonical claimed
+ * English - a shared "English" link showed each recipient something
+ * different. The ruling: the stored preference redirects to its own
+ * prefix, so URL and content always agree. A visitor who last browsed in
+ * Italian and types /help lands on /it/help, keeping both their language
+ * and a truthful address bar.
+ *
+ * Crawlers and the prerenderer carry no localStorage, so the canonical
+ * English page is what they keep seeing - this never runs for them.
+ *
+ * Only the PUBLIC tree mounts this. The account, auth and admin areas are
+ * deliberately not localised (see Routing.tsx), and redirecting them would
+ * 404 every one of their URLs.
+ */
+const DefaultLocaleGate = ({ children }: Props): JSX.Element => {
+  const location = useLocation();
+
+  const { data } = useGetSettings();
+
+  const available = data?.preferences?.languages?.available ?? [];
+
+  const fallback = data?.preferences?.languages?.default ?? 'en';
+
+  const stored = localStorage.getItem('language');
+
+  if (stored && stored !== fallback && available.includes(stored)) {
+    return <Navigate to={ `/${ stored }${ location.pathname }${ location.search }${ location.hash }` } replace />;
+  }
+
+  return children;
+};
+
+export default DefaultLocaleGate;

package/index.ts

@@ -35,6 +35,7 @@ import RouteFeature from './RouteFeature/RouteFeature';
 import Required from './Required/Required';
 import Road from './Road/Road';
 import LocaleGate from './Locale/LocaleGate';
+import DefaultLocaleGate from './Locale/DefaultLocaleGate';
 import SeoOverride from './SeoOverride/SeoOverride';
 import HandoffBanner from './HandoffBanner/HandoffBanner';
 import localiseRoutes from './Locale/routes';
@@ -89,6 +90,7 @@ export {
   Required,
   Road,
   LocaleGate,
+  DefaultLocaleGate,
   SeoOverride,
   HandoffBanner,
   localiseRoutes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/common",
-  "version": "1.33.11",
+  "version": "1.33.12",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"