@adventurelabs/scout-core 2.0.10 → 2.0.12

package/README.md

@@ -44,6 +44,9 @@ remain available when expired; pass `false` as the fourth argument to
 not synthesize a Supabase `User` when no validated user is available.
 Use `createScoutBrowserClient()` when the application needs the same configured
 client outside the provider.
+Provider descendants should call `useScoutRefreshActions()` for
+`handleRefresh` and `clearCache` instead of creating another
+`useScoutRefresh()` instance.
 Create Redux state explicitly with `configureScoutStore()` and keep that
 instance stable in the application provider.
 

package/dist/hooks/index.d.ts

@@ -1,4 +1,4 @@
-export { useScoutRefresh, type UseScoutRefreshOptions, } from "./useScoutRefresh";
+export { useScoutRefresh, type ScoutRefreshRequest, type UseScoutRefreshOptions, } from "./useScoutRefresh";
 export { useScoutRealtimeBroadcast, type ScoutRealtimeBroadcastOptions, type ScoutRealtimeAuthErrorMode, } from "./useScoutRealtimeBroadcast";
 export { useScoutRealtimeConnectivity } from "./useScoutRealtimeConnectivity";
 export { useScoutRealtimeDevices } from "./useScoutRealtimeDevices";

package/dist/hooks/useScoutRefresh.js

@@ -62,6 +62,7 @@ export function useScoutRefresh(options = {}, identityOptions = {}) {
     const refreshIdRef = useRef(0);
     const refreshInProgressIdRef = useRef(null);
     const activeUserIdRef = useRef(null);
+    const signedOutRef = useRef(false);
     const validatedUserIdRef = useRef(null);
     const providedValidatedUserIdRef = useRef(validatedUserId);
     providedValidatedUserIdRef.current = validatedUserId;
@@ -334,6 +335,7 @@ export function useScoutRefresh(options = {}, identityOptions = {}) {
     useEffect(() => {
         return subscribeToSupabaseAuth(supabase, (event, session) => {
             if (event === "SIGNED_OUT") {
+                signedOutRef.current = true;
                 const previousUserId = activeUserIdRef.current ?? scoutCache.getScopeUserId();
                 refreshIdRef.current++;
                 activeUserIdRef.current = null;
@@ -347,14 +349,22 @@ export function useScoutRefresh(options = {}, identityOptions = {}) {
             }
             const nextUserId = session?.user?.id;
             if (event === "SIGNED_IN" && nextUserId) {
+                const wasSignedOut = signedOutRef.current;
+                signedOutRef.current = false;
                 validatedUserIdRef.current = nextUserId;
                 notifyUserValidated(nextUserId);
-                if (nextUserId === activeUserIdRef.current) {
+                const knownUserId = activeUserIdRef.current;
+                activeUserIdRef.current = nextUserId;
+                if (knownUserId === nextUserId) {
+                    return;
+                }
+                if (knownUserId === null && !wasSignedOut) {
                     return;
                 }
                 refreshIdRef.current++;
-                activeUserIdRef.current = nextUserId;
-                resetClientState();
+                if (knownUserId !== null) {
+                    resetClientState();
+                }
                 void handleRefresh({ force: true });
             }
         });

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -1,4 +1,4 @@
-import { type UseScoutRefreshOptions } from "../hooks/useScoutRefresh";
+import { type ScoutRefreshRequest, type UseScoutRefreshOptions } from "../hooks/useScoutRefresh";
 import { type ReactNode } from "react";
 import { SupabaseClient } from "@supabase/supabase-js";
 import { Database } from "../types/supabase";
@@ -25,7 +25,12 @@ export interface PubsubTokenMintState {
     error: string | null;
     refreshMint: () => Promise<void>;
 }
+export interface ScoutRefreshActions {
+    handleRefresh: (request?: ScoutRefreshRequest) => Promise<void>;
+    clearCache: () => Promise<void>;
+}
 export declare function useSupabase(): SupabaseClient<Database>;
+export declare function useScoutRefreshActions(): ScoutRefreshActions;
 export declare function useClientAbilitiesMint(): ClientAbilitiesMintState;
 export declare function useOptionalClientAbilitiesMint(): ClientAbilitiesMintState | null;
 export declare function usePubsubTokenMint(): PubsubTokenMintState;

package/dist/providers/ScoutRefreshProvider.js

@@ -37,6 +37,10 @@ function useScoutRefreshContext() {
 export function useSupabase() {
     return useScoutRefreshContext().supabase;
 }
+export function useScoutRefreshActions() {
+    const { handleRefresh, clearCache } = useScoutRefreshContext();
+    return useMemo(() => ({ handleRefresh, clearCache }), [handleRefresh, clearCache]);
+}
 export function useClientAbilitiesMint() {
     return useScoutRefreshContext().abilities;
 }
@@ -282,7 +286,12 @@ function useJwtMintLifecycle({ enabled, supabase, identity, cacheKey, ttlSec, re
                         authUserIdRef.current !== userId) {
                         return;
                     }
-                    updateMint(cached.data);
+                    if (cached.data && !cached.isStale) {
+                        updateMint(cached.data);
+                    }
+                    else if (!mintRef.current) {
+                        updateMint(cached.data);
+                    }
                 }
                 catch (cacheError) {
                     console.warn(`[ScoutRefreshProvider] ${cacheKey} cache load failed:`, cacheError);
@@ -481,9 +490,15 @@ export function ScoutRefreshProvider({ children, abilityParams, supabase: supaba
     }
     const abilitiesConfig = useMemo(() => resolveAbilityParams(abilityParams), [abilityParams]);
     const { identity, renderChildren } = useScoutIdentity(supabase, refreshOptions.offlineUserId);
-    useScoutRefresh({ ...refreshOptions, supabase }, identity);
+    const { handleRefresh, clearCache } = useScoutRefresh({ ...refreshOptions, supabase }, identity);
     const abilities = useClientAbilitiesMintLifecycle(supabase, abilitiesConfig, identity);
     const pubsub = usePubsubTokenMintLifecycle(supabase, abilitiesConfig, identity);
-    const value = useMemo(() => ({ supabase, abilities, pubsub }), [supabase, abilities, pubsub]);
+    const value = useMemo(() => ({
+        supabase,
+        abilities,
+        pubsub,
+        handleRefresh,
+        clearCache,
+    }), [supabase, abilities, pubsub, handleRefresh, clearCache]);
     return (_jsx(ScoutRefreshContext.Provider, { value: value, children: renderChildren ? children : null }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "exports": {
     "./client": {