@lovalingo/lovalingo 0.3.3 → 0.4.0

package/README.md

@@ -31,6 +31,16 @@ npm install @lovalingo/lovalingo react-router-dom
 
 Pricing and onboarding: https://lovalingo.com
 
+## API endpoint (recommended default)
+
+By default the runtime uses `https://cdn.lovalingo.com` (Cloudflare edge) for `bootstrap/bundle/dom-rules`.
+
+You can override it (advanced):
+
+```tsx
+<LovalingoProvider apiBase="https://<your-supabase-project>.supabase.co" ... />
+```
+
 ## React Router
 
 ### Query mode (default)

package/dist/components/AixsterProvider.js

@@ -11,7 +11,7 @@ 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)
+export const LovalingoProvider = ({ children, apiKey: apiKeyProp, publicAnonKey, defaultLocale, locales, apiBase = 'https://cdn.lovalingo.com', 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
 mode = 'dom', // Default to legacy DOM mode for backward compatibility
 sitemap = true, // Default: true - Auto-inject sitemap link tag
@@ -74,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);
@@ -138,6 +142,18 @@ navigateRef, // For path mode routing
         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;
@@ -674,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);
@@ -695,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 () => {
@@ -770,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
@@ -788,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()) {

package/package.json

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