@adventurelabs/scout-core 1.4.94 → 1.4.96

package/dist/helpers/sessions.d.ts

@@ -2,6 +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>>;
+/** Existing sessions within tolerance of start/end timestamps. */
+export declare function server_match_sessions(deviceId: number, timestampStart: string, timestampEnd: string, toleranceSec: number, client?: SupabaseClient): Promise<IWebResponseCompatible<ISession[]>>;
 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[]>>;

package/dist/helpers/sessions.js

@@ -21,6 +21,20 @@ export async function server_get_session_by_id(sessionId, client) {
     const session = data && data.length > 0 ? data[0] : null;
     return IWebResponse.success(session).to_compatible();
 }
+/** Existing sessions within tolerance of start/end timestamps. */
+export async function server_match_sessions(deviceId, timestampStart, timestampEnd, toleranceSec, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase.rpc("match_sessions", {
+        device_id_caller: deviceId,
+        timestamp_start_caller: timestampStart,
+        timestamp_end_caller: timestampEnd,
+        tolerance_sec_caller: toleranceSec,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data || []).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, product_numbers_caller) {
     const supabase = client || (await newServerClient());

package/dist/hooks/index.d.ts

@@ -1,4 +1,5 @@
 export { useScoutRefresh, type UseScoutRefreshOptions, } from "./useScoutRefresh";
+export { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export { useScoutRealtimeConnectivity } from "./useScoutRealtimeConnectivity";
 export { useScoutRealtimeDevices } from "./useScoutRealtimeDevices";
 export { useScoutRealtimeVersionsSoftware } from "./useScoutRealtimeVersionsSoftware";
@@ -10,5 +11,9 @@ export { useScoutRealtimePins } from "./useScoutRealtimePins";
 export { useScoutRealtimeParts } from "./useScoutRealtimeParts";
 export { useScoutRealtimeAnalysisJobs } from "./useScoutRealtimeAnalysisJobs";
 export { useScoutRealtimeAnalysisTasks } from "./useScoutRealtimeAnalysisTasks";
+export { useScoutRealtimeDocuments, type DocumentRealtimeChannel, } from "./useScoutRealtimeDocuments";
+export { useScoutRealtimeMaintenanceRequests } from "./useScoutRealtimeMaintenanceRequests";
+export { useScoutRealtimeContacts } from "./useScoutRealtimeContacts";
+export { useScoutRealtimeSessionIncidents } from "./useScoutRealtimeSessionIncidents";
 export { useInfiniteSessionsByHerd, useInfiniteSessionsByDevice, useInfiniteEventsByHerd, useInfiniteEventsByDevice, useInfiniteArtifactsByHerd, useInfiniteArtifactsByDevice, useInfiniteFeedByHerd, useInfiniteFeedByDevice, useInfiniteAnalysisJobs, useInfiniteAnalysisTasks, useIntersectionObserver, type UseInfiniteScrollOptions, type UseAnalysisJobsInfiniteOptions, type UseAnalysisTasksInfiniteOptions, } from "./useInfiniteQuery";
 export { useLoadingPerformance, useSessionSummariesByHerd, useHasSessionSummaries, } from "../store/hooks";

package/dist/hooks/index.js

@@ -1,4 +1,5 @@
 export { useScoutRefresh, } from "./useScoutRefresh";
+export { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export { useScoutRealtimeConnectivity } from "./useScoutRealtimeConnectivity";
 export { useScoutRealtimeDevices } from "./useScoutRealtimeDevices";
 export { useScoutRealtimeVersionsSoftware } from "./useScoutRealtimeVersionsSoftware";
@@ -10,6 +11,10 @@ export { useScoutRealtimePins } from "./useScoutRealtimePins";
 export { useScoutRealtimeParts } from "./useScoutRealtimeParts";
 export { useScoutRealtimeAnalysisJobs } from "./useScoutRealtimeAnalysisJobs";
 export { useScoutRealtimeAnalysisTasks } from "./useScoutRealtimeAnalysisTasks";
+export { useScoutRealtimeDocuments, } from "./useScoutRealtimeDocuments";
+export { useScoutRealtimeMaintenanceRequests } from "./useScoutRealtimeMaintenanceRequests";
+export { useScoutRealtimeContacts } from "./useScoutRealtimeContacts";
+export { useScoutRealtimeSessionIncidents } from "./useScoutRealtimeSessionIncidents";
 // RTK Query infinite scroll hooks
 export { useInfiniteSessionsByHerd, useInfiniteSessionsByDevice, useInfiniteEventsByHerd, useInfiniteEventsByDevice, useInfiniteArtifactsByHerd, useInfiniteArtifactsByDevice, useInfiniteFeedByHerd, useInfiniteFeedByDevice, useInfiniteAnalysisJobs, useInfiniteAnalysisTasks, useIntersectionObserver, } from "./useInfiniteQuery";
 // Session summaries and performance hooks

package/dist/hooks/useScoutRealtimeAnalysisJobs.js

@@ -1,61 +1,7 @@
 "use client";
-import { useEffect, useRef, useCallback, useState } from "react";
-import { EnumRealtimeOperation } from "../types/realtime";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export function useScoutRealtimeAnalysisJobs(scoutSupabase) {
-    const channels = useRef([]);
-    const [latestJobUpdate, setLatestJobUpdate] = useState(null);
-    const handleAnalysisJobBroadcast = useCallback((payload) => {
-        const { payload: data } = payload;
-        const jobData = data.record || data.old_record;
-        if (!jobData) {
-            return;
-        }
-        let operation;
-        switch (data.operation) {
-            case "INSERT":
-                operation = EnumRealtimeOperation.INSERT;
-                break;
-            case "UPDATE":
-                operation = EnumRealtimeOperation.UPDATE;
-                break;
-            case "DELETE":
-                operation = EnumRealtimeOperation.DELETE;
-                break;
-            default:
-                return;
-        }
-        console.log(`[scout-core realtime] ANALYSIS_JOB ${data.operation} received for job ${jobData.id}:`, JSON.stringify(jobData));
-        const realtimeData = {
-            data: jobData,
-            operation,
-        };
-        setLatestJobUpdate(realtimeData);
-    }, []);
-    const clearLatestUpdate = useCallback(() => {
-        setLatestJobUpdate(null);
-    }, []);
-    useEffect(() => {
-        if (!scoutSupabase)
-            return;
-        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
-        channels.current = [];
-        clearLatestUpdate();
-        const channel = scoutSupabase
-            .channel("analysis_jobs_changes", { config: { private: true } })
-            .on("broadcast", { event: "*" }, handleAnalysisJobBroadcast)
-            .subscribe((status) => {
-            if (status === "SUBSCRIBED") {
-                console.log("[ANALYSIS_JOBS] ✅ Connected to analysis jobs broadcasts");
-            }
-            else if (status === "CHANNEL_ERROR") {
-                console.warn("[ANALYSIS_JOBS] 🟡 Failed to connect to analysis jobs broadcasts");
-            }
-        });
-        channels.current.push(channel);
-        return () => {
-            channels.current.forEach((ch) => scoutSupabase.removeChannel(ch));
-            channels.current = [];
-        };
-    }, [scoutSupabase, handleAnalysisJobBroadcast, clearLatestUpdate]);
-    return [latestJobUpdate, clearLatestUpdate];
+    return useScoutRealtimeBroadcast(scoutSupabase, [
+        "analysis_jobs_changes",
+    ]);
 }

package/dist/hooks/useScoutRealtimeAnalysisTasks.js

@@ -1,61 +1,7 @@
 "use client";
-import { useEffect, useRef, useCallback, useState } from "react";
-import { EnumRealtimeOperation } from "../types/realtime";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export function useScoutRealtimeAnalysisTasks(scoutSupabase) {
-    const channels = useRef([]);
-    const [latestTaskUpdate, setLatestTaskUpdate] = useState(null);
-    const handleAnalysisTaskBroadcast = useCallback((payload) => {
-        const { payload: data } = payload;
-        const taskData = data.record || data.old_record;
-        if (!taskData) {
-            return;
-        }
-        let operation;
-        switch (data.operation) {
-            case "INSERT":
-                operation = EnumRealtimeOperation.INSERT;
-                break;
-            case "UPDATE":
-                operation = EnumRealtimeOperation.UPDATE;
-                break;
-            case "DELETE":
-                operation = EnumRealtimeOperation.DELETE;
-                break;
-            default:
-                return;
-        }
-        console.log(`[scout-core realtime] ANALYSIS_TASK ${data.operation} received for task ${taskData.id} (job ${taskData.job_id}):`, JSON.stringify(taskData));
-        const realtimeData = {
-            data: taskData,
-            operation,
-        };
-        setLatestTaskUpdate(realtimeData);
-    }, []);
-    const clearLatestUpdate = useCallback(() => {
-        setLatestTaskUpdate(null);
-    }, []);
-    useEffect(() => {
-        if (!scoutSupabase)
-            return;
-        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
-        channels.current = [];
-        clearLatestUpdate();
-        const channel = scoutSupabase
-            .channel("analysis_tasks_changes", { config: { private: true } })
-            .on("broadcast", { event: "*" }, handleAnalysisTaskBroadcast)
-            .subscribe((status) => {
-            if (status === "SUBSCRIBED") {
-                console.log("[ANALYSIS_TASKS] ✅ Connected to analysis tasks broadcasts");
-            }
-            else if (status === "CHANNEL_ERROR") {
-                console.warn("[ANALYSIS_TASKS] 🟡 Failed to connect to analysis tasks broadcasts");
-            }
-        });
-        channels.current.push(channel);
-        return () => {
-            channels.current.forEach((ch) => scoutSupabase.removeChannel(ch));
-            channels.current = [];
-        };
-    }, [scoutSupabase, handleAnalysisTaskBroadcast, clearLatestUpdate]);
-    return [latestTaskUpdate, clearLatestUpdate];
+    return useScoutRealtimeBroadcast(scoutSupabase, [
+        "analysis_tasks_changes",
+    ]);
 }

package/dist/hooks/useScoutRealtimeBroadcast.d.ts

@@ -0,0 +1,8 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { RealtimeData } from "../types/realtime";
+/**
+ * Subscribes to private realtime topics and reports the most recent row change across them.
+ * Changing the topic set resubscribes and clears the pending change.
+ */
+export declare function useScoutRealtimeBroadcast<T>(scoutSupabase: SupabaseClient<Database>, topics: string[]): [RealtimeData<T> | null, () => void];

package/dist/hooks/useScoutRealtimeBroadcast.js

@@ -0,0 +1,44 @@
+"use client";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { EnumRealtimeOperation } from "../types/realtime";
+const OPERATIONS = {
+    INSERT: EnumRealtimeOperation.INSERT,
+    UPDATE: EnumRealtimeOperation.UPDATE,
+    DELETE: EnumRealtimeOperation.DELETE,
+};
+/**
+ * Subscribes to private realtime topics and reports the most recent row change across them.
+ * Changing the topic set resubscribes and clears the pending change.
+ */
+export function useScoutRealtimeBroadcast(scoutSupabase, topics) {
+    const [latestUpdate, setLatestUpdate] = useState(null);
+    // Key the subscription on the topic set rather than the array identity, so callers can build
+    // their topics inline.
+    const topicsKey = topics.join("|");
+    const subscribedTopics = useMemo(() => topicsKey.split("|").filter(Boolean), [topicsKey]);
+    const clearLatestUpdate = useCallback(() => setLatestUpdate(null), []);
+    useEffect(() => {
+        setLatestUpdate(null);
+        if (!scoutSupabase || subscribedTopics.length === 0)
+            return;
+        const channels = subscribedTopics.map((topic) => scoutSupabase
+            .channel(topic, { config: { private: true } })
+            .on("broadcast", { event: "*" }, (message) => {
+            const change = message.payload;
+            const operation = OPERATIONS[change.operation];
+            const row = change.record ?? change.old_record;
+            if (operation === undefined || !row)
+                return;
+            setLatestUpdate({ data: row, operation });
+        })
+            .subscribe((status) => {
+            if (status === "CHANNEL_ERROR") {
+                console.warn(`[scout-core realtime] 🟡 ${topic} unavailable`);
+            }
+        }));
+        return () => {
+            channels.forEach((channel) => scoutSupabase.removeChannel(channel));
+        };
+    }, [scoutSupabase, subscribedTopics]);
+    return [latestUpdate, clearLatestUpdate];
+}

package/dist/hooks/useScoutRealtimeContacts.d.ts

@@ -0,0 +1,5 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { IContact } from "../types/db";
+import { RealtimeData } from "../types/realtime";
+export declare function useScoutRealtimeContacts(scoutSupabase: SupabaseClient<Database>): [RealtimeData<IContact> | null, () => void];

package/dist/hooks/useScoutRealtimeContacts.js

@@ -0,0 +1,7 @@
+"use client";
+import { useSelector } from "react-redux";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
+export function useScoutRealtimeContacts(scoutSupabase) {
+    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
+    return useScoutRealtimeBroadcast(scoutSupabase, activeHerdId ? [`${activeHerdId}-contacts`] : []);
+}

package/dist/hooks/useScoutRealtimeDocuments.d.ts

@@ -0,0 +1,7 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { IDocument } from "../types/db";
+import { RealtimeData } from "../types/realtime";
+/** One channel per document owner class, each gated on that class's read ability. */
+export type DocumentRealtimeChannel = "herd" | "device" | "user" | "own" | "product";
+export declare function useScoutRealtimeDocuments(scoutSupabase: SupabaseClient<Database>, channels?: DocumentRealtimeChannel[]): [RealtimeData<IDocument> | null, () => void];

package/dist/hooks/useScoutRealtimeDocuments.js

@@ -0,0 +1,22 @@
+"use client";
+import { useSelector } from "react-redux";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
+const ALL_DOCUMENT_CHANNELS = [
+    "herd",
+    "device",
+    "user",
+    "own",
+    "product",
+];
+export function useScoutRealtimeDocuments(scoutSupabase, channels = ALL_DOCUMENT_CHANNELS) {
+    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
+    const userId = useSelector((state) => state.scout.user?.id ?? null);
+    const topics = channels.flatMap((channel) => {
+        if (channel === "product")
+            return ["product_documents_changes"];
+        if (channel === "own")
+            return userId ? [`user_${userId}-documents`] : [];
+        return activeHerdId ? [`${activeHerdId}-${channel}_documents`] : [];
+    });
+    return useScoutRealtimeBroadcast(scoutSupabase, topics);
+}

package/dist/hooks/useScoutRealtimeMaintenanceRequests.d.ts

@@ -0,0 +1,5 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { IMaintenanceRequest } from "../types/db";
+import { RealtimeData } from "../types/realtime";
+export declare function useScoutRealtimeMaintenanceRequests(scoutSupabase: SupabaseClient<Database>): [RealtimeData<IMaintenanceRequest> | null, () => void];

package/dist/hooks/useScoutRealtimeMaintenanceRequests.js

@@ -0,0 +1,7 @@
+"use client";
+import { useSelector } from "react-redux";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
+export function useScoutRealtimeMaintenanceRequests(scoutSupabase) {
+    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
+    return useScoutRealtimeBroadcast(scoutSupabase, activeHerdId ? [`${activeHerdId}-maintenance_requests`] : []);
+}

package/dist/hooks/useScoutRealtimeParts.js

@@ -1,73 +1,7 @@
 "use client";
 import { useSelector } from "react-redux";
-import { useEffect, useRef, useCallback, useState } from "react";
-import { EnumRealtimeOperation } from "../types/realtime";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export function useScoutRealtimeParts(scoutSupabase) {
-    const channels = useRef([]);
-    const [latestPartUpdate, setLatestPartUpdate] = useState(null);
     const activeHerdId = useSelector((state) => state.scout.active_herd_id);
-    // Part broadcast handler - just pass data, don't mutate state
-    const handlePartBroadcast = useCallback((payload) => {
-        console.log("[Parts] Broadcast received:", payload.payload.operation);
-        const data = payload.payload;
-        const partData = data.record || data.old_record;
-        if (!partData)
-            return;
-        let operation;
-        switch (data.operation) {
-            case "INSERT":
-                operation = EnumRealtimeOperation.INSERT;
-                console.log("[Parts] New part received:", data.record);
-                break;
-            case "UPDATE":
-                operation = EnumRealtimeOperation.UPDATE;
-                console.log("[Parts] Part updated:", data.record);
-                break;
-            case "DELETE":
-                operation = EnumRealtimeOperation.DELETE;
-                console.log("[Parts] Part deleted:", data.old_record);
-                break;
-            default:
-                return;
-        }
-        const realtimeData = {
-            data: partData,
-            operation,
-        };
-        console.log(`[scout-core realtime] PART ${data.operation} received:`, JSON.stringify(realtimeData));
-        setLatestPartUpdate(realtimeData);
-    }, []);
-    // Clear latest update
-    const clearLatestUpdate = useCallback(() => {
-        setLatestPartUpdate(null);
-    }, []);
-    const cleanupChannels = () => {
-        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
-        channels.current = [];
-    };
-    const createPartsChannel = (herdId) => {
-        return scoutSupabase
-            .channel(`${herdId}-parts`, { config: { private: true } })
-            .on("broadcast", { event: "*" }, handlePartBroadcast)
-            .subscribe((status) => {
-            if (status === "SUBSCRIBED") {
-                console.log(`[Parts] ✅ Connected to herd ${herdId}`);
-            }
-            else if (status === "CHANNEL_ERROR") {
-                console.warn(`[Parts] 🟡 Failed to connect to herd ${herdId}`);
-            }
-        });
-    };
-    useEffect(() => {
-        cleanupChannels();
-        // Clear previous update when switching herds
-        clearLatestUpdate();
-        // Create parts channel for active herd
-        if (activeHerdId) {
-            const channel = createPartsChannel(activeHerdId);
-            channels.current.push(channel);
-        }
-        return cleanupChannels;
-    }, [activeHerdId, clearLatestUpdate]);
-    return [latestPartUpdate, clearLatestUpdate];
+    return useScoutRealtimeBroadcast(scoutSupabase, activeHerdId ? [`${activeHerdId}-parts`] : []);
 }

package/dist/hooks/useScoutRealtimePlans.js

@@ -1,66 +1,7 @@
 "use client";
 import { useSelector } from "react-redux";
-import { useEffect, useRef, useCallback, useState } from "react";
-import { EnumRealtimeOperation } from "../types/realtime";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export function useScoutRealtimePlans(scoutSupabase) {
-    const channels = useRef([]);
-    const [latestPlanUpdate, setLatestPlanUpdate] = useState(null);
     const activeHerdId = useSelector((state) => state.scout.active_herd_id);
-    const handlePlanBroadcast = useCallback((message) => {
-        const { payload: data } = message;
-        if (data.table !== "plans" || data.schema !== "public") {
-            return;
-        }
-        const planData = data.record ?? data.old_record;
-        if (!planData)
-            return;
-        let operation;
-        switch (data.operation) {
-            case "INSERT":
-                operation = EnumRealtimeOperation.INSERT;
-                break;
-            case "UPDATE":
-                operation = EnumRealtimeOperation.UPDATE;
-                break;
-            case "DELETE":
-                operation = EnumRealtimeOperation.DELETE;
-                break;
-            default:
-                return;
-        }
-        const realtimeData = {
-            data: planData,
-            operation,
-        };
-        setLatestPlanUpdate(realtimeData);
-    }, []);
-    const clearLatestUpdate = useCallback(() => {
-        setLatestPlanUpdate(null);
-    }, []);
-    useEffect(() => {
-        if (!scoutSupabase)
-            return;
-        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
-        channels.current = [];
-        clearLatestUpdate();
-        if (activeHerdId) {
-            const channel = scoutSupabase
-                .channel(`${activeHerdId}-plans`, { config: { private: true } })
-                .on("broadcast", { event: "*" }, handlePlanBroadcast)
-                .subscribe((status) => {
-                if (status === "SUBSCRIBED") {
-                    console.log(`[Plans] ✅ Connected to herd ${activeHerdId}`);
-                }
-                else if (status === "CHANNEL_ERROR") {
-                    console.warn(`[Plans] 🟡 Failed to connect to herd ${activeHerdId}`);
-                }
-            });
-            channels.current.push(channel);
-        }
-        return () => {
-            channels.current.forEach((ch) => scoutSupabase.removeChannel(ch));
-            channels.current = [];
-        };
-    }, [scoutSupabase, activeHerdId, handlePlanBroadcast, clearLatestUpdate]);
-    return [latestPlanUpdate, clearLatestUpdate];
+    return useScoutRealtimeBroadcast(scoutSupabase, activeHerdId ? [`${activeHerdId}-plans`] : []);
 }

package/dist/hooks/useScoutRealtimeSessionIncidents.d.ts

@@ -0,0 +1,5 @@
+import { SupabaseClient } from "@supabase/supabase-js";
+import { Database } from "../types/supabase";
+import { ISessionIncident } from "../types/db";
+import { RealtimeData } from "../types/realtime";
+export declare function useScoutRealtimeSessionIncidents(scoutSupabase: SupabaseClient<Database>): [RealtimeData<ISessionIncident> | null, () => void];

package/dist/hooks/useScoutRealtimeSessionIncidents.js

@@ -0,0 +1,7 @@
+"use client";
+import { useSelector } from "react-redux";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
+export function useScoutRealtimeSessionIncidents(scoutSupabase) {
+    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
+    return useScoutRealtimeBroadcast(scoutSupabase, activeHerdId ? [`${activeHerdId}-session_incidents`] : []);
+}

package/dist/hooks/useScoutRealtimeVersionsSoftware.js

@@ -1,66 +1,7 @@
 "use client";
-import { useEffect, useRef, useCallback, useState } from "react";
-import { EnumRealtimeOperation } from "../types/realtime";
+import { useScoutRealtimeBroadcast } from "./useScoutRealtimeBroadcast";
 export function useScoutRealtimeVersionsSoftware(scoutSupabase) {
-    const channels = useRef([]);
-    const [latestVersionUpdate, setLatestVersionUpdate] = useState(null);
-    // Handle versions software broadcasts
-    const handleVersionsSoftwareBroadcast = useCallback((payload) => {
-        const { event, payload: data } = payload;
-        const versionData = data.record || data.old_record;
-        if (!versionData) {
-            return;
-        }
-        let operation;
-        switch (data.operation) {
-            case "INSERT":
-                operation = EnumRealtimeOperation.INSERT;
-                break;
-            case "UPDATE":
-                operation = EnumRealtimeOperation.UPDATE;
-                break;
-            case "DELETE":
-                operation = EnumRealtimeOperation.DELETE;
-                break;
-            default:
-                return;
-        }
-        console.log(`[scout-core realtime] VERSIONS_SOFTWARE ${data.operation} received for version ${versionData.system}@${versionData.version}:`, JSON.stringify(versionData));
-        const realtimeData = {
-            data: versionData,
-            operation,
-        };
-        setLatestVersionUpdate(realtimeData);
-    }, []);
-    // Clear latest update
-    const clearLatestUpdate = useCallback(() => {
-        setLatestVersionUpdate(null);
-    }, []);
-    useEffect(() => {
-        if (!scoutSupabase)
-            return;
-        // Clean up existing channels
-        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
-        channels.current = [];
-        // Clear previous update when setting up
-        clearLatestUpdate();
-        // Create versions_software channel
-        const channel = scoutSupabase
-            .channel("versions_software_changes", { config: { private: true } })
-            .on("broadcast", { event: "*" }, handleVersionsSoftwareBroadcast)
-            .subscribe((status) => {
-            if (status === "SUBSCRIBED") {
-                console.log("[VERSIONS_SOFTWARE] ✅ Connected to software versions broadcasts");
-            }
-            else if (status === "CHANNEL_ERROR") {
-                console.warn("[VERSIONS_SOFTWARE] 🟡 Failed to connect to software versions broadcasts");
-            }
-        });
-        channels.current.push(channel);
-        return () => {
-            channels.current.forEach((ch) => scoutSupabase.removeChannel(ch));
-            channels.current = [];
-        };
-    }, [scoutSupabase, handleVersionsSoftwareBroadcast, clearLatestUpdate]);
-    return [latestVersionUpdate, clearLatestUpdate];
+    return useScoutRealtimeBroadcast(scoutSupabase, [
+        "versions_software_changes",
+    ]);
 }

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from "./types/supabase";
 export * from "./types/bounding_boxes";
 export * from "./types/events";
 export * from "./types/connectivity";
+export * from "./types/realtime";
 export * from "./types/pubsub_token";
 export * from "./types/client_abilities_token";
 export * from "./types/jwt_mint";
@@ -73,6 +74,7 @@ export * from "./helpers/session_incidents";
 export * from "./helpers/contacts";
 export * from "./helpers/lifecycle";
 export * from "./helpers/storagePath";
+export * from "./hooks/useScoutRealtimeBroadcast";
 export * from "./hooks/useScoutRealtimeConnectivity";
 export * from "./hooks/useScoutRealtimeDevices";
 export * from "./hooks/useScoutRealtimeVersionsSoftware";
@@ -84,6 +86,10 @@ export * from "./hooks/useScoutRealtimePlans";
 export * from "./hooks/useScoutRealtimePins";
 export * from "./hooks/useScoutRealtimeAnalysisJobs";
 export * from "./hooks/useScoutRealtimeAnalysisTasks";
+export * from "./hooks/useScoutRealtimeDocuments";
+export * from "./hooks/useScoutRealtimeMaintenanceRequests";
+export * from "./hooks/useScoutRealtimeContacts";
+export * from "./hooks/useScoutRealtimeSessionIncidents";
 export * from "./hooks/useScoutRefresh";
 export * from "./hooks/useInfiniteQuery";
 export * from "./providers";

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./types/supabase";
 export * from "./types/bounding_boxes";
 export * from "./types/events";
 export * from "./types/connectivity";
+export * from "./types/realtime";
 export * from "./types/pubsub_token";
 export * from "./types/client_abilities_token";
 export * from "./types/jwt_mint";
@@ -77,6 +78,7 @@ export * from "./helpers/contacts";
 export * from "./helpers/lifecycle";
 export * from "./helpers/storagePath";
 // Hooks
+export * from "./hooks/useScoutRealtimeBroadcast";
 export * from "./hooks/useScoutRealtimeConnectivity";
 export * from "./hooks/useScoutRealtimeDevices";
 export * from "./hooks/useScoutRealtimeVersionsSoftware";
@@ -88,6 +90,10 @@ export * from "./hooks/useScoutRealtimePlans";
 export * from "./hooks/useScoutRealtimePins";
 export * from "./hooks/useScoutRealtimeAnalysisJobs";
 export * from "./hooks/useScoutRealtimeAnalysisTasks";
+export * from "./hooks/useScoutRealtimeDocuments";
+export * from "./hooks/useScoutRealtimeMaintenanceRequests";
+export * from "./hooks/useScoutRealtimeContacts";
+export * from "./hooks/useScoutRealtimeSessionIncidents";
 export * from "./hooks/useScoutRefresh";
 export * from "./hooks/useInfiniteQuery";
 // Providers

package/dist/types/supabase.d.ts

@@ -490,11 +490,13 @@ export type Database = {
                     heading: number;
                     id: number;
                     inserted_at: string;
+                    link_type: Database["public"]["Enums"]["link_type"];
                     location: unknown;
                     mode: string | null;
-                    noise: number;
+                    noise: number | null;
+                    quality_normalized: number | null;
                     session_id: number | null;
-                    signal: number;
+                    signal: number | null;
                     timestamp_start: string;
                 };
                 Insert: {
@@ -512,11 +514,13 @@ export type Database = {
                     heading: number;
                     id?: number;
                     inserted_at?: string;
+                    link_type?: Database["public"]["Enums"]["link_type"];
                     location: unknown;
                     mode?: string | null;
-                    noise: number;
+                    noise?: number | null;
+                    quality_normalized?: number | null;
                     session_id?: number | null;
-                    signal: number;
+                    signal?: number | null;
                     timestamp_start: string;
                 };
                 Update: {
@@ -534,11 +538,13 @@ export type Database = {
                     heading?: number;
                     id?: number;
                     inserted_at?: string;
+                    link_type?: Database["public"]["Enums"]["link_type"];
                     location?: unknown;
                     mode?: string | null;
-                    noise?: number;
+                    noise?: number | null;
+                    quality_normalized?: number | null;
                     session_id?: number | null;
-                    signal?: number;
+                    signal?: number | null;
                     timestamp_start?: string;
                 };
                 Relationships: [
@@ -4552,6 +4558,47 @@ export type Database = {
                     isSetofReturn: true;
                 };
             };
+            match_sessions: {
+                Args: {
+                    device_id_caller: number;
+                    timestamp_end_caller: string;
+                    timestamp_start_caller: string;
+                    tolerance_sec_caller: number;
+                };
+                Returns: {
+                    altitude_average: number;
+                    altitude_max: number;
+                    altitude_min: number;
+                    battery_id: number | null;
+                    device_id: number;
+                    distance_max_from_start: number;
+                    distance_total: number;
+                    end_approver: string | null;
+                    end_reason: Database["public"]["Enums"]["session_end_reason"] | null;
+                    id: number;
+                    inserted_at: string;
+                    lifecycle: Database["public"]["Enums"]["entity_lifecycle"];
+                    lifecycle_changed_at: string;
+                    lifecycle_changed_by: string | null;
+                    lifecycle_reason: string | null;
+                    locations: unknown;
+                    post_approver: string | null;
+                    software_version: string;
+                    start_approver: string | null;
+                    status: Database["public"]["Enums"]["session_status"];
+                    timestamp_end: string | null;
+                    timestamp_start: string;
+                    velocity_average: number;
+                    velocity_max: number;
+                    velocity_min: number;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "sessions";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             migrate_conservaition_users_to_sentala: {
                 Args: {
                     preview?: boolean;
@@ -4761,6 +4808,7 @@ export type Database = {
             entity_lifecycle: "active" | "retired" | "deleted";
             health_item: "healthy" | "repairable" | "unrepairable";
             herd_invitation_status: "pending" | "accepted" | "revoked" | "expired";
+            link_type: "wifi" | "ocusync" | "lte" | "satellite" | "mesh" | "lora" | "unknown";
             media_type: "image" | "video" | "audio" | "text";
             plan_type: "mission" | "fence" | "rally" | "markov";
             review_status: "pending" | "annotating" | "in_review" | "completed" | "rejected";
@@ -4793,6 +4841,8 @@ export type Database = {
                 associated_station: string | null;
                 mode: string | null;
                 battery_volts: number | null;
+                link_type: Database["public"]["Enums"]["link_type"] | null;
+                quality_normalized: number | null;
             };
             device_heartbeat_analysis: {
                 device_id: number | null;
@@ -5090,6 +5140,7 @@ export declare const Constants: {
             readonly entity_lifecycle: readonly ["active", "retired", "deleted"];
             readonly health_item: readonly ["healthy", "repairable", "unrepairable"];
             readonly herd_invitation_status: readonly ["pending", "accepted", "revoked", "expired"];
+            readonly link_type: readonly ["wifi", "ocusync", "lte", "satellite", "mesh", "lora", "unknown"];
             readonly media_type: readonly ["image", "video", "audio", "text"];
             readonly plan_type: readonly ["mission", "fence", "rally", "markov"];
             readonly review_status: readonly ["pending", "annotating", "in_review", "completed", "rejected"];

package/dist/types/supabase.js

@@ -31,6 +31,15 @@ export const Constants = {
             entity_lifecycle: ["active", "retired", "deleted"],
             health_item: ["healthy", "repairable", "unrepairable"],
             herd_invitation_status: ["pending", "accepted", "revoked", "expired"],
+            link_type: [
+                "wifi",
+                "ocusync",
+                "lte",
+                "satellite",
+                "mesh",
+                "lora",
+                "unknown",
+            ],
             media_type: ["image", "video", "audio", "text"],
             plan_type: ["mission", "fence", "rally", "markov"],
             review_status: [

package/package.json

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