Merge branch 'main' into main

Author: Koosha-Owji

CHANGELOG.md

@@ -4,12 +4,18 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [5.9.0](https://github.com/kinde-oss/kinde-auth-react/compare/5.8.0...5.9.0)
+
+- feat: make browser tab focus refresh optional [`#190`](https://github.com/kinde-oss/kinde-auth-react/pull/190)
+
 #### [5.8.0](https://github.com/kinde-oss/kinde-auth-react/compare/5.7.2...5.8.0)
 
+> 9 October 2025
+
 - feat: add store subscription [`#187`](https://github.com/kinde-oss/kinde-auth-react/pull/187)
+- chore: release v5.8.0 [`3b8cad1`](https://github.com/kinde-oss/kinde-auth-react/commit/3b8cad14a892714683ff5b7d5b52eec966e53dd2)
 - chore: lock file maintainance [`aec0c5f`](https://github.com/kinde-oss/kinde-auth-react/commit/aec0c5ff40ebc43511d5e005bf48960278dfbd77)
 - Update CODEOWNERS [`8ee1063`](https://github.com/kinde-oss/kinde-auth-react/commit/8ee1063a8e818c27f72677811e80a3553bded367)
-- Update CODEOWNERS [`caf105f`](https://github.com/kinde-oss/kinde-auth-react/commit/caf105fe3a6c56f919373064cce4e0e344bdd989)
 
 #### [5.7.2](https://github.com/kinde-oss/kinde-auth-react/compare/5.7.1...5.7.2)
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinde-oss/kinde-auth-react",
-  "version": "5.8.0",
+  "version": "5.9.0",
   "description": "Kinde React SDK for authentication",
   "module": "./dist/index.mjs",
   "main": "./dist/index.cjs",

src/state/KindeProvider.tsx

@@ -122,6 +122,7 @@ type KindeProviderProps = {
    * ⚠️ Must be memoized or defined outside component to prevent effect re-runs.
    */
   activityTimeout?: ActivityTimeoutConfig;
+  refreshOnFocus?: boolean
 };
 
 const defaultCallbacks: KindeCallbacks = {
@@ -158,6 +159,7 @@ export const KindeProvider = ({
   popupOptions = {},
   store = storeState.memoryStorage,
   activityTimeout,
+  refreshOnFocus = false,
 }: KindeProviderProps) => {
   const mergedCallbacks = { ...defaultCallbacks, ...callbacks };
 
@@ -605,32 +607,35 @@ export const KindeProvider = ({
   );
 
   const handleFocus = useCallback(() => {
-    if (document.visibilityState === "visible" && state.isAuthenticated) {
+    if (document.visibilityState === "visible" && state.isAuthenticated && refreshOnFocus) {
       refreshToken({ domain, clientId, onRefresh }).catch((error) => {
         console.error("Error refreshing token:", error);
       });
     }
-  }, [state.isAuthenticated, domain, clientId, onRefresh]);
+  }, [state.isAuthenticated, domain, clientId, onRefresh, refreshOnFocus]);
 
   useEffect(() => {
     // remove any existing event listener before adding a new one
+
     document.removeEventListener("visibilitychange", handleFocus);
+    if (refreshOnFocus) {
     document.addEventListener("visibilitychange", handleFocus);
-    return () => {
-      document.removeEventListener("visibilitychange", handleFocus);
-    };
-  }, [handleFocus]);
+      return () => {
+        document.removeEventListener("visibilitychange", handleFocus);
+      };
+    }
+  }, [handleFocus, refreshOnFocus]);
 
   const init = useCallback(async () => {
     if (initRef.current) return;
     try {
       try {
+        initRef.current = true;
         await checkAuth({ domain, clientId });
       } catch (err) {
         console.warn("checkAuth failed:", err);
         setState((v: ProviderState) => ({ ...v, isLoading: false }));
       }
-      initRef.current = true;
       const params = new URLSearchParams(window.location.search);
 
       if (params.has("error")) {