@adventurelabs/scout-core 1.4.51 → 1.4.53

package/dist/helpers/session_summaries.d.ts

@@ -1,6 +1,6 @@
 import { ISessionSummary } from "../types/db";
 import { IWebResponseCompatible } from "../types/requests";
 import { SupabaseClient } from "@supabase/supabase-js";
-export declare function server_get_session_summaries_by_herd(herd_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionSummary>>;
-export declare function server_get_session_summaries_by_device(device_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionSummary>>;
-export declare function server_get_session_summaries_with_filters(herd_id?: number, device_id?: number, start_date?: string, end_date?: string, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionSummary>>;
+export declare function server_get_session_summaries_by_herd(herd_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number): Promise<IWebResponseCompatible<ISessionSummary>>;
+export declare function server_get_session_summaries_by_device(device_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number): Promise<IWebResponseCompatible<ISessionSummary>>;
+export declare function server_get_session_summaries_with_filters(herd_id?: number, device_id?: number, start_date?: string, end_date?: string, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number): Promise<IWebResponseCompatible<ISessionSummary>>;

package/dist/helpers/session_summaries.js

@@ -1,13 +1,15 @@
 "use server";
 import { newServerClient } from "../supabase/server";
 import { IWebResponse, } from "../types/requests";
-export async function server_get_session_summaries_by_herd(herd_id, client) {
+export async function server_get_session_summaries_by_herd(herd_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: undefined,
         end_date_caller: undefined,
         device_id_caller: undefined,
         herd_id_caller: herd_id,
+        min_duration_minutes_caller,
+        min_distance_meters_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -17,13 +19,15 @@ export async function server_get_session_summaries_by_herd(herd_id, client) {
     }
     return IWebResponse.success(data).to_compatible();
 }
-export async function server_get_session_summaries_by_device(device_id, client) {
+export async function server_get_session_summaries_by_device(device_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: undefined,
         end_date_caller: undefined,
         device_id_caller: device_id,
         herd_id_caller: undefined,
+        min_duration_minutes_caller,
+        min_distance_meters_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -33,13 +37,15 @@ export async function server_get_session_summaries_by_device(device_id, client)
     }
     return IWebResponse.success(data).to_compatible();
 }
-export async function server_get_session_summaries_with_filters(herd_id, device_id, start_date, end_date, client) {
+export async function server_get_session_summaries_with_filters(herd_id, device_id, start_date, end_date, client, min_duration_minutes_caller, min_distance_meters_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: start_date || undefined,
         end_date_caller: end_date || undefined,
         device_id_caller: device_id || undefined,
         herd_id_caller: herd_id || undefined,
+        min_duration_minutes_caller,
+        min_distance_meters_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();

package/dist/helpers/sessions.d.ts

@@ -2,8 +2,8 @@ import { ISessionWithCoordinates, ISessionUsageOverTime, IEventAndTagsPrettyLoca
 import { IWebResponseCompatible } from "../types/requests";
 import { SupabaseClient } from "@supabase/supabase-js";
 export declare function server_get_session_by_id(sessionId: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionWithCoordinates | null>>;
-export declare function server_get_session_usage_over_time_by_herd(herd_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
-export declare function server_get_session_usage_over_time_by_device(device_id: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
+export declare function server_get_session_usage_over_time_by_herd(herd_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
+export declare function server_get_session_usage_over_time_by_device(device_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number): Promise<IWebResponseCompatible<ISessionUsageOverTime>>;
 export declare function server_get_events_and_tags_by_session_id(sessionId: number, limit?: number, offset?: number): Promise<IWebResponseCompatible<IEventAndTagsPrettyLocation[]>>;
 export declare function server_insert_session(sessions: SessionInsert | SessionInsert[], client?: SupabaseClient): Promise<IWebResponseCompatible<ISession[]>>;
 export declare function server_update_session(sessions: (SessionUpdate & {

package/dist/helpers/sessions.js

@@ -21,13 +21,15 @@ export async function server_get_session_by_id(sessionId, client) {
     return IWebResponse.success(session).to_compatible();
 }
 // Get session usage over time by herd
-export async function server_get_session_usage_over_time_by_herd(herd_id, client) {
+export async function server_get_session_usage_over_time_by_herd(herd_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_usage_over_time", {
         start_date_caller: undefined,
         end_date_caller: undefined,
         device_id_caller: undefined,
         herd_id_caller: herd_id,
+        min_duration_minutes_caller,
+        min_distance_meters_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -38,13 +40,15 @@ export async function server_get_session_usage_over_time_by_herd(herd_id, client
     return IWebResponse.success(data).to_compatible();
 }
 // Get session usage over time by device
-export async function server_get_session_usage_over_time_by_device(device_id, client) {
+export async function server_get_session_usage_over_time_by_device(device_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_usage_over_time", {
         start_date_caller: undefined,
         end_date_caller: undefined,
         device_id_caller: device_id,
         herd_id_caller: undefined,
+        min_duration_minutes_caller,
+        min_distance_meters_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();

package/dist/hooks/useScoutRefresh.d.ts

@@ -13,7 +13,7 @@ export interface UseScoutRefreshOptions {
  * @param options.onRefreshComplete - Callback function called when refresh completes
  * @param options.cacheFirst - Whether to load from cache first, then refresh (default: true)
  * @param options.cacheTtlMs - Cache time-to-live in milliseconds (default: 24 hours)
- * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 60s)
+ * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 15s)
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh

package/dist/hooks/useScoutRefresh.js

@@ -15,7 +15,7 @@ import { createBrowserClient } from "@supabase/ssr";
  * @param options.onRefreshComplete - Callback function called when refresh completes
  * @param options.cacheFirst - Whether to load from cache first, then refresh (default: true)
  * @param options.cacheTtlMs - Cache time-to-live in milliseconds (default: 24 hours)
- * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 60s)
+ * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 15s)
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh
@@ -33,7 +33,7 @@ import { createBrowserClient } from "@supabase/ssr";
  */
 export function useScoutRefresh(options = {}) {
     const { autoRefresh = true, onRefreshComplete, cacheFirst = true, cacheTtlMs = 24 * 60 * 60 * 1000, // 24 hours default (1 day)
-    onlineRefetchMinIntervalMs = 60 * 1000, // 1 minute
+    onlineRefetchMinIntervalMs = 15 * 1000, // 15 seconds
      } = options;
     const dispatch = useAppDispatch();
     const store = useStore();
@@ -83,6 +83,49 @@ export function useScoutRefresh(options = {}) {
         const startTime = Date.now();
         timingRefs.current.startTime = startTime;
         const isOffline = typeof navigator === "undefined" || !navigator.onLine;
+        const fetchUserWithOneRetry = async () => {
+            const startTotal = Date.now();
+            let lastError;
+            for (let attempt = 0; attempt < 2; attempt++) {
+                try {
+                    const { data } = await supabase.auth.getUser();
+                    if (!data.user) {
+                        throw new Error("Invalid user response");
+                    }
+                    const totalMs = Date.now() - startTotal;
+                    timingRefs.current.userApiDuration = totalMs;
+                    dispatch(setUserApiDuration(totalMs));
+                    dispatch(setUser(data.user));
+                    return data.user;
+                }
+                catch (e) {
+                    lastError = e;
+                }
+            }
+            throw lastError;
+        };
+        const fetchUserWithOneRetryBackground = async () => {
+            const startTotal = Date.now();
+            for (let attempt = 0; attempt < 2; attempt++) {
+                try {
+                    const { data } = await supabase.auth.getUser();
+                    if (data.user) {
+                        const totalMs = Date.now() - startTotal;
+                        timingRefs.current.userApiDuration = totalMs;
+                        dispatch(setUserApiDuration(totalMs));
+                        dispatch(setUser(data.user));
+                        return data.user;
+                    }
+                }
+                catch {
+                    // retry once
+                }
+            }
+            const totalMs = Date.now() - startTotal;
+            timingRefs.current.userApiDuration = totalMs;
+            dispatch(setUserApiDuration(totalMs));
+            return null;
+        };
         try {
             dispatch(setStatus(EnumScoutStateStatus.LOADING));
             dispatch(setHerdModulesLoadingState(EnumHerdModulesLoadingState.LOADING));
@@ -117,17 +160,7 @@ export function useScoutRefresh(options = {}) {
                                 // Background fetch fresh data without blocking
                                 (async () => {
                                     try {
-                                        const userPromise = (async () => {
-                                            const start = Date.now();
-                                            const { data } = await supabase.auth.getUser();
-                                            const duration = Date.now() - start;
-                                            timingRefs.current.userApiDuration = duration;
-                                            dispatch(setUserApiDuration(duration));
-                                            if (data.user) {
-                                                dispatch(setUser(data.user));
-                                            }
-                                            return data.user ?? null;
-                                        })();
+                                        const userPromise = fetchUserWithOneRetryBackground();
                                         let backgroundHerdModulesResult;
                                         try {
                                             const start = Date.now();
@@ -228,18 +261,7 @@ export function useScoutRefresh(options = {}) {
             }
             // Step 2: Load fresh data from API (user resolves independently; Redux gets user as soon as getUser returns)
             const parallelStartTime = Date.now();
-            const userPromise = (async () => {
-                const start = Date.now();
-                const { data } = await supabase.auth.getUser();
-                const duration = Date.now() - start;
-                timingRefs.current.userApiDuration = duration;
-                dispatch(setUserApiDuration(duration));
-                if (!data.user) {
-                    throw new Error("Invalid user response");
-                }
-                dispatch(setUser(data.user));
-                return data.user;
-            })();
+            const userPromise = fetchUserWithOneRetry();
             let herdModulesResult;
             try {
                 herdModulesResult = await (async () => {

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -2461,6 +2461,8 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 device_id_caller?: number;
                 end_date_caller?: string;
                 herd_id_caller?: number;
+                min_distance_meters_caller?: number;
+                min_duration_minutes_caller?: number;
                 start_date_caller?: string;
             };
             Returns: import("../types/supabase").Json;
@@ -2470,6 +2472,8 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 device_id_caller?: number;
                 end_date_caller?: string;
                 herd_id_caller?: number;
+                min_distance_meters_caller?: number;
+                min_duration_minutes_caller?: number;
                 start_date_caller?: string;
             };
             Returns: import("../types/supabase").Json;

package/dist/types/db.d.ts

@@ -62,6 +62,8 @@ export interface ISessionSummary {
         end_date: string | null;
         device_id: number | null;
         herd_id: number | null;
+        min_duration_minutes: number | null;
+        min_distance_meters: number | null;
     };
 }
 export type ISessionUsageOverTime = Database["public"]["Functions"]["get_session_usage_over_time"]["Returns"];

package/dist/types/supabase.d.ts

@@ -2546,6 +2546,8 @@ export type Database = {
                     device_id_caller?: number;
                     end_date_caller?: string;
                     herd_id_caller?: number;
+                    min_distance_meters_caller?: number;
+                    min_duration_minutes_caller?: number;
                     start_date_caller?: string;
                 };
                 Returns: Json;
@@ -2555,6 +2557,8 @@ export type Database = {
                     device_id_caller?: number;
                     end_date_caller?: string;
                     herd_id_caller?: number;
+                    min_distance_meters_caller?: number;
+                    min_duration_minutes_caller?: number;
                     start_date_caller?: string;
                 };
                 Returns: Json;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "1.4.51",
+  "version": "1.4.53",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",