@lovalingo/lovalingo 0.3.2 → 0.3.4

package/dist/components/AixsterProvider.js

@@ -9,6 +9,7 @@ import { processPath } from '../utils/pathNormalizer';
 import { LanguageSwitcher } from './LanguageSwitcher';
 const LOCALE_STORAGE_KEY = 'Lovalingo_locale';
 const LOADING_BG_STORAGE_PREFIX = "Lovalingo_loading_bg_color";
+const BRANDING_STORAGE_PREFIX = "Lovalingo_branding_enabled";
 const CRITICAL_CACHE_PREFIX = "Lovalingo_critical_v0_3";
 export const LovalingoProvider = ({ children, apiKey: apiKeyProp, publicAnonKey, defaultLocale, locales, apiBase = 'https://leuskvkajliuzalrlwhw.supabase.co', routing = 'query', // Default to query mode (backward compatible)
 autoPrefixLinks = true, autoApplyRules = true, switcherPosition = 'bottom-right', switcherOffsetY = 20, switcherTheme = 'dark', editMode: initialEditMode = false, editKey = 'KeyE', pathNormalization = { enabled: true }, // Enable by default
@@ -73,6 +74,10 @@ navigateRef, // For path mode routing
         apiRef.current = new LovalingoAPI(resolvedApiKey, apiBase, enhancedPathConfig);
     }, [apiBase, enhancedPathConfig, resolvedApiKey]);
     const [entitlements, setEntitlements] = useState(() => apiRef.current.getEntitlements());
+    const lastPageviewRef = useRef("");
+    const historyPatchedRef = useRef(false);
+    const originalHistoryRef = useRef(null);
+    const onNavigateRef = useRef(() => undefined);
     const retryTimeoutRef = useRef(null);
     const isNavigatingRef = useRef(false);
     const isInternalNavigationRef = useRef(false);
@@ -80,6 +85,21 @@ navigateRef, // For path mode routing
     const exclusionsCacheRef = useRef(null);
     const domRulesCacheRef = useRef(new Map());
     const loadingBgStorageKey = `${LOADING_BG_STORAGE_PREFIX}:${resolvedApiKey || "anonymous"}`;
+    const brandingStorageKey = `${BRANDING_STORAGE_PREFIX}:${resolvedApiKey || "anonymous"}`;
+    const readBrandingCache = () => {
+        try {
+            const cached = (localStorage.getItem(brandingStorageKey) || "").trim();
+            if (cached === "0")
+                return false;
+            if (cached === "1")
+                return true;
+        }
+        catch {
+            // ignore
+        }
+        return true;
+    };
+    const [brandingEnabled, setBrandingEnabled] = useState(readBrandingCache);
     const prehideStateRef = useRef({
         active: false,
         timeoutId: null,
@@ -110,6 +130,30 @@ navigateRef, // For path mode routing
             // ignore
         }
     }, [loadingBgStorageKey]);
+    const setCachedBrandingEnabled = useCallback((enabled) => {
+        try {
+            localStorage.setItem(brandingStorageKey, enabled === false ? "0" : "1");
+        }
+        catch {
+            // ignore
+        }
+    }, [brandingStorageKey]);
+    useEffect(() => {
+        setBrandingEnabled(readBrandingCache());
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [brandingStorageKey]);
+    useEffect(() => {
+        lastPageviewRef.current = "";
+    }, [resolvedApiKey]);
+    const trackPageviewOnce = useCallback((path) => {
+        const next = (path || "").toString();
+        if (!next)
+            return;
+        if (lastPageviewRef.current === next)
+            return;
+        lastPageviewRef.current = next;
+        apiRef.current.trackPageview(next);
+    }, []);
     const enablePrehide = useCallback((bgColor) => {
         if (typeof document === "undefined")
             return;
@@ -306,11 +350,19 @@ navigateRef, // For path mode routing
                 setEntitlements(bootstrap.entitlements);
             if (bootstrap?.loading_bg_color)
                 setCachedLoadingBgColor(bootstrap.loading_bg_color);
+            if (bootstrap?.entitlements?.brandingRequired) {
+                setBrandingEnabled(true);
+                setCachedBrandingEnabled(true);
+            }
+            else if (typeof bootstrap?.branding_enabled === "boolean") {
+                setBrandingEnabled(bootstrap.branding_enabled);
+                setCachedBrandingEnabled(bootstrap.branding_enabled);
+            }
         })();
         return () => {
             cancelled = true;
         };
-    }, [defaultLocale, entitlements, locale, setCachedLoadingBgColor]);
+    }, [defaultLocale, entitlements, locale, setCachedBrandingEnabled, setCachedLoadingBgColor]);
     const applySeoBundle = useCallback((bundle, hreflangEnabled) => {
         try {
             const head = document.head;
@@ -535,6 +587,14 @@ navigateRef, // For path mode routing
                 setCachedLoadingBgColor(bootstrap.loading_bg_color);
                 enablePrehide(bootstrap.loading_bg_color);
             }
+            if ((bootstrap?.entitlements || nextEntitlements)?.brandingRequired) {
+                setBrandingEnabled(true);
+                setCachedBrandingEnabled(true);
+            }
+            else if (typeof bootstrap?.branding_enabled === "boolean") {
+                setBrandingEnabled(bootstrap.branding_enabled);
+                setCachedBrandingEnabled(bootstrap.branding_enabled);
+            }
             const exclusions = Array.isArray(bootstrap?.exclusions)
                 ? bootstrap.exclusions
                     .map((row) => {
@@ -630,18 +690,9 @@ navigateRef, // For path mode routing
         toTranslations,
         writeCriticalCache,
     ]);
-    // SPA router hook-in: track History API navigations (React Router/Next/etc) without app changes.
     useEffect(() => {
-        const historyObj = window.history;
-        const originalPushState = historyObj.pushState.bind(historyObj);
-        const originalReplaceState = historyObj.replaceState.bind(historyObj);
-        const onNavigate = () => {
-            try {
-                apiRef.current.trackPageview(window.location.pathname + window.location.search);
-            }
-            catch {
-                // ignore
-            }
+        onNavigateRef.current = () => {
+            trackPageviewOnce(window.location.pathname + window.location.search);
             const nextLocale = detectLocale();
             if (nextLocale !== locale) {
                 setLocaleState(nextLocale);
@@ -651,25 +702,50 @@ navigateRef, // For path mode routing
                 applyActiveTranslations(document.body);
             }
         };
+    }, [defaultLocale, detectLocale, loadData, locale, mode, trackPageviewOnce]);
+    // SPA router hook-in: patch History API once (prevents stacked wrappers → request storms).
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        if (historyPatchedRef.current)
+            return;
+        historyPatchedRef.current = true;
+        const historyObj = window.history;
+        const originalPushState = historyObj.pushState.bind(historyObj);
+        const originalReplaceState = historyObj.replaceState.bind(historyObj);
+        originalHistoryRef.current = { pushState: originalPushState, replaceState: originalReplaceState };
+        const safeOnNavigate = () => {
+            try {
+                onNavigateRef.current();
+            }
+            catch {
+                // ignore
+            }
+        };
         historyObj.pushState = ((...args) => {
             const ret = originalPushState(...args);
-            onNavigate();
+            safeOnNavigate();
             return ret;
         });
         historyObj.replaceState = ((...args) => {
             const ret = originalReplaceState(...args);
-            onNavigate();
+            safeOnNavigate();
             return ret;
         });
-        window.addEventListener("popstate", onNavigate);
-        window.addEventListener("hashchange", onNavigate);
+        window.addEventListener("popstate", safeOnNavigate);
+        window.addEventListener("hashchange", safeOnNavigate);
         return () => {
-            historyObj.pushState = originalPushState;
-            historyObj.replaceState = originalReplaceState;
-            window.removeEventListener("popstate", onNavigate);
-            window.removeEventListener("hashchange", onNavigate);
+            const originals = originalHistoryRef.current;
+            if (originals) {
+                historyObj.pushState = originals.pushState;
+                historyObj.replaceState = originals.replaceState;
+            }
+            window.removeEventListener("popstate", safeOnNavigate);
+            window.removeEventListener("hashchange", safeOnNavigate);
+            originalHistoryRef.current = null;
+            historyPatchedRef.current = false;
         };
-    }, [defaultLocale, detectLocale, loadData, locale, mode]);
+    }, []);
     // Change locale
     const setLocale = useCallback((newLocale) => {
         void (async () => {
@@ -726,7 +802,7 @@ navigateRef, // For path mode routing
     useEffect(() => {
         const initialLocale = detectLocale();
         // Track initial page (fallback discovery for pages not present in the routes feed).
-        apiRef.current.trackPageview(window.location.pathname + window.location.search);
+        trackPageviewOnce(window.location.pathname + window.location.search);
         // Always prefetch artifacts for the initial locale (pipeline-produced translations + rules).
         loadData(initialLocale);
         // Set up keyboard shortcut for edit mode
@@ -744,7 +820,7 @@ navigateRef, // For path mode routing
                 clearTimeout(retryTimeoutRef.current);
             }
         };
-    }, [detectLocale, loadData, editKey]);
+    }, [detectLocale, loadData, editKey, trackPageviewOnce]);
     // Auto-inject sitemap link tag
     useEffect(() => {
         if (sitemap && resolvedApiKey && isSeoActive()) {
@@ -1032,7 +1108,9 @@ navigateRef, // For path mode routing
     };
     return (React.createElement(LovalingoContext.Provider, { value: contextValue },
         children,
-        React.createElement(LanguageSwitcher, { locales: allLocales, currentLocale: locale, onLocaleChange: setLocale, position: switcherPosition, offsetY: switcherOffsetY, theme: switcherTheme, branding: entitlements?.brandingRequired
-                ? { required: true, href: "https://lovalingo.com" }
-                : undefined })));
+        React.createElement(LanguageSwitcher, { locales: allLocales, currentLocale: locale, onLocaleChange: setLocale, position: switcherPosition, offsetY: switcherOffsetY, theme: switcherTheme, branding: {
+                required: Boolean(entitlements?.brandingRequired),
+                enabled: brandingEnabled,
+                href: "https://lovalingo.com",
+            } })));
 };

package/dist/components/LanguageSwitcher.d.ts

@@ -8,6 +8,7 @@ interface LanguageSwitcherProps {
     theme?: 'dark' | 'light';
     branding?: {
         required?: boolean;
+        enabled?: boolean;
         label?: string;
         href?: string;
     };

package/dist/components/LanguageSwitcher.js

@@ -205,7 +205,7 @@ export const LanguageSwitcher = ({ locales, currentLocale, onLocaleChange, posit
                         e.currentTarget.style.filter = 'brightness(1)';
                         e.currentTarget.style.transform = 'scale(1)';
                     }, "aria-label": `Switch to ${locale.toUpperCase()}`, title: locale.toUpperCase(), tabIndex: isOpen ? 0 : -1 }, LANGUAGE_FLAGS[locale] || '🏳️')))),
-                branding?.required && (React.createElement("div", { style: badgeRowStyles, "aria-label": "Lovalingo branding" },
+                (branding?.required || branding?.enabled) && (React.createElement("div", { style: badgeRowStyles, "aria-label": "Lovalingo branding" },
                     React.createElement("a", { href: branding.href || 'https://lovalingo.com', target: "_blank", rel: "noreferrer", style: badgeLinkStyles, tabIndex: isOpen ? 0 : -1, "aria-label": "Localized by Lovalingo", title: "Localized by Lovalingo" },
                         React.createElement("span", { style: {
                                 width: '16px',

package/dist/utils/api.d.ts

@@ -26,6 +26,7 @@ export type BootstrapResponse = {
     normalized_path?: string;
     routing_strategy?: string;
     loading_bg_color?: string | null;
+    branding_enabled?: boolean;
     seoEnabled?: boolean;
     entitlements?: ProjectEntitlements;
     alternates?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovalingo/lovalingo",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "React translation runtime with i18n routing, deterministic bundles + DOM rules, and zero-flash rendering.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",