@adventurelabs/scout-core 1.4.54 → 1.4.56

package/dist/helpers/events.d.ts

@@ -10,6 +10,7 @@ export declare function server_update_event(events: (EventUpdate & {
 }) | (EventUpdate & {
     id: number;
 })[], client?: SupabaseClient): Promise<IWebResponseCompatible<IEvent[]>>;
+export declare function server_delete_event(id: number | number[], client?: SupabaseClient): Promise<IWebResponseCompatible<boolean>>;
 /** Semantic search over events using Vertex multimodal embedding (embedding_vertex_mm_01). */
 export declare function server_match_events_by_vertex_embedding(query_embedding: number[], match_threshold: number, match_count: number, options?: {
     herd_id?: number | null;

package/dist/helpers/events.js

@@ -94,6 +94,15 @@ export async function server_update_event(events, client) {
     }
     return IWebResponse.success(updatedEvents).to_compatible();
 }
+export async function server_delete_event(id, client) {
+    const supabase = client || (await newServerClient());
+    const ids = Array.isArray(id) ? id : [id];
+    const { error } = await supabase.from("events").delete().in("id", ids);
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(true).to_compatible();
+}
 /** Semantic search over events using Vertex multimodal embedding (embedding_vertex_mm_01). */
 export async function server_match_events_by_vertex_embedding(query_embedding, match_threshold, match_count, options) {
     const supabase = options?.client ?? (await newServerClient());

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, 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>>;
+export declare function server_get_session_summaries_by_herd(herd_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number, product_numbers_caller?: string[]): 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, product_numbers_caller?: string[]): 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, product_numbers_caller?: string[]): Promise<IWebResponseCompatible<ISessionSummary>>;

package/dist/helpers/session_summaries.js

@@ -1,7 +1,7 @@
 "use server";
 import { newServerClient } from "../supabase/server";
 import { IWebResponse, } from "../types/requests";
-export async function server_get_session_summaries_by_herd(herd_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
+export async function server_get_session_summaries_by_herd(herd_id, client, min_duration_minutes_caller, min_distance_meters_caller, product_numbers_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: undefined,
@@ -10,6 +10,7 @@ export async function server_get_session_summaries_by_herd(herd_id, client, min_
         herd_id_caller: herd_id,
         min_duration_minutes_caller,
         min_distance_meters_caller,
+        product_numbers_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -19,7 +20,7 @@ export async function server_get_session_summaries_by_herd(herd_id, client, min_
     }
     return IWebResponse.success(data).to_compatible();
 }
-export async function server_get_session_summaries_by_device(device_id, client, min_duration_minutes_caller, min_distance_meters_caller) {
+export async function server_get_session_summaries_by_device(device_id, client, min_duration_minutes_caller, min_distance_meters_caller, product_numbers_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: undefined,
@@ -28,6 +29,7 @@ export async function server_get_session_summaries_by_device(device_id, client,
         herd_id_caller: undefined,
         min_duration_minutes_caller,
         min_distance_meters_caller,
+        product_numbers_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -37,7 +39,7 @@ 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, min_duration_minutes_caller, min_distance_meters_caller) {
+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, product_numbers_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_summaries", {
         start_date_caller: start_date || undefined,
@@ -46,6 +48,7 @@ export async function server_get_session_summaries_with_filters(herd_id, device_
         herd_id_caller: herd_id || undefined,
         min_duration_minutes_caller,
         min_distance_meters_caller,
+        product_numbers_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, 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_session_usage_over_time_by_herd(herd_id: number, client?: SupabaseClient, min_duration_minutes_caller?: number, min_distance_meters_caller?: number, product_numbers_caller?: string[]): 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, product_numbers_caller?: string[]): 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,7 +21,7 @@ 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, min_duration_minutes_caller, min_distance_meters_caller) {
+export async function server_get_session_usage_over_time_by_herd(herd_id, client, min_duration_minutes_caller, min_distance_meters_caller, product_numbers_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_usage_over_time", {
         start_date_caller: undefined,
@@ -30,6 +30,7 @@ export async function server_get_session_usage_over_time_by_herd(herd_id, client
         herd_id_caller: herd_id,
         min_duration_minutes_caller,
         min_distance_meters_caller,
+        product_numbers_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();
@@ -40,7 +41,7 @@ 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, min_duration_minutes_caller, min_distance_meters_caller) {
+export async function server_get_session_usage_over_time_by_device(device_id, client, min_duration_minutes_caller, min_distance_meters_caller, product_numbers_caller) {
     const supabase = client || (await newServerClient());
     const { data, error } = await supabase.rpc("get_session_usage_over_time", {
         start_date_caller: undefined,
@@ -49,6 +50,7 @@ export async function server_get_session_usage_over_time_by_device(device_id, cl
         herd_id_caller: undefined,
         min_duration_minutes_caller,
         min_distance_meters_caller,
+        product_numbers_caller,
     });
     if (error) {
         return IWebResponse.error(error.message).to_compatible();

package/dist/hooks/useScoutBrowserClient.d.ts

@@ -0,0 +1,11 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+/**
+ * Creates one browser Supabase client (reads NEXT_PUBLIC_* env each call).
+ * Prefer {@link useScoutBrowserClient} in components so creation runs once via lazy state init.
+ */
+export declare function createScoutBrowserClient(): SupabaseClient<Database>;
+/**
+ * One browser Supabase client per component instance, created on first render (lazy state initializer).
+ */
+export declare function useScoutBrowserClient(): SupabaseClient<Database>;

package/dist/hooks/useScoutBrowserClient.js

@@ -0,0 +1,17 @@
+"use client";
+import { useState } from "react";
+import { createBrowserClient } from "@supabase/ssr";
+/**
+ * Creates one browser Supabase client (reads NEXT_PUBLIC_* env each call).
+ * Prefer {@link useScoutBrowserClient} in components so creation runs once via lazy state init.
+ */
+export function createScoutBrowserClient() {
+    return createBrowserClient(process.env.NEXT_PUBLIC_SUPABASE_URL || "", process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || "");
+}
+/**
+ * One browser Supabase client per component instance, created on first render (lazy state initializer).
+ */
+export function useScoutBrowserClient() {
+    const [client] = useState(createScoutBrowserClient);
+    return client;
+}

package/dist/hooks/useScoutRefresh.d.ts

@@ -1,4 +1,7 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
 export interface UseScoutRefreshOptions {
+    supabase?: SupabaseClient<Database>;
     autoRefresh?: boolean;
     onRefreshComplete?: () => void;
     cacheFirst?: boolean;
@@ -14,6 +17,7 @@ export interface UseScoutRefreshOptions {
  * @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: 15s)
+ * @param options.supabase - Optional shared browser client; when omitted, the hook creates its own via `createBrowserClient`
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh

package/dist/hooks/useScoutRefresh.js

@@ -16,6 +16,7 @@ import { createBrowserClient } from "@supabase/ssr";
  * @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: 15s)
+ * @param options.supabase - Optional shared browser client; when omitted, the hook creates its own via `createBrowserClient`
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh
@@ -32,18 +33,19 @@ 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)
+    const { supabase: supabaseOption, autoRefresh = true, onRefreshComplete, cacheFirst = true, cacheTtlMs = 24 * 60 * 60 * 1000, // 24 hours default (1 day)
     onlineRefetchMinIntervalMs = 15 * 1000, // 15 seconds
      } = options;
     const dispatch = useAppDispatch();
     const store = useStore();
     const refreshInProgressRef = useRef(false);
     const lastQueryAtRef = useRef(0);
-    // Create Supabase client directly to avoid circular dependency
-    // Assumes Next.js environment variables (NEXT_PUBLIC_*)
     const supabase = useMemo(() => {
+        if (supabaseOption) {
+            return supabaseOption;
+        }
         return createBrowserClient(process.env.NEXT_PUBLIC_SUPABASE_URL || "", process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY || "");
-    }, []);
+    }, [supabaseOption]);
     // Refs to store timing measurements
     const timingRefs = useRef({
         startTime: 0,

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -2463,6 +2463,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 herd_id_caller?: number;
                 min_distance_meters_caller?: number;
                 min_duration_minutes_caller?: number;
+                product_numbers_caller?: string[];
                 start_date_caller?: string;
             };
             Returns: import("../types/supabase").Json;
@@ -2474,6 +2475,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 herd_id_caller?: number;
                 min_distance_meters_caller?: number;
                 min_duration_minutes_caller?: number;
+                product_numbers_caller?: string[];
                 start_date_caller?: string;
             };
             Returns: import("../types/supabase").Json;

package/dist/providers/ScoutRefreshProvider.js

@@ -32,7 +32,7 @@ export function ScoutRefreshProvider({ children, ...refreshOptions }) {
         console.log("[ScoutRefreshProvider] Creating Supabase client");
         return createBrowserClient(urlRef.current, anonKeyRef.current);
     }, []); // Empty dependency array ensures this only runs once
-    useScoutRefresh(refreshOptions);
+    useScoutRefresh({ ...refreshOptions, supabase: supabaseClient });
     // // Log connection status changes for debugging
     // if (connectionStatus.lastError) {
     //   console.warn(

package/dist/types/db.d.ts

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

package/dist/types/supabase.d.ts

@@ -2548,6 +2548,7 @@ export type Database = {
                     herd_id_caller?: number;
                     min_distance_meters_caller?: number;
                     min_duration_minutes_caller?: number;
+                    product_numbers_caller?: string[];
                     start_date_caller?: string;
                 };
                 Returns: Json;
@@ -2559,6 +2560,7 @@ export type Database = {
                     herd_id_caller?: number;
                     min_distance_meters_caller?: number;
                     min_duration_minutes_caller?: number;
+                    product_numbers_caller?: string[];
                     start_date_caller?: string;
                 };
                 Returns: Json;

package/package.json

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