@adventurelabs/scout-core/dist/hooks/useScoutRealtimeDevices.js

Core utilities and helpers for Adventure Labs Scout applications

"use client";
import { useSelector } from "react-redux";
import { useEffect, useRef, useCallback, useState } from "react";
import { EnumRealtimeOperation } from "../types/realtime";
export function useScoutRealtimeDevices(scoutSupabase) {
    const channels = useRef([]);
    const [latestDeviceUpdate, setLatestDeviceUpdate] = useState(null);
    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
    // Device broadcast handler - just pass data, don't mutate state
    const handleDeviceBroadcast = useCallback((payload) => {
        console.log("[Devices] Broadcast received:", payload.payload.operation);
        const data = payload.payload;
        const deviceData = data.record || data.old_record;
        if (!deviceData)
            return;
        let operation;
        switch (data.operation) {
            case "INSERT":
                operation = EnumRealtimeOperation.INSERT;
                console.log("[Devices] New device received:", data.record);
                break;
            case "UPDATE":
                operation = EnumRealtimeOperation.UPDATE;
                console.log("[Devices] Device updated:", data.record);
                break;
            case "DELETE":
                operation = EnumRealtimeOperation.DELETE;
                console.log("[Devices] Device deleted:", data.old_record);
                break;
            default:
                return;
        }
        const realtimeData = {
            data: deviceData,
            operation,
        };
        console.log(`[scout-core realtime] DEVICE ${data.operation} received:`, JSON.stringify(realtimeData));
        setLatestDeviceUpdate(realtimeData);
    }, []);
    // Clear latest update
    const clearLatestUpdate = useCallback(() => {
        setLatestDeviceUpdate(null);
    }, []);
    const cleanupChannels = () => {
        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
        channels.current = [];
    };
    const createDevicesChannel = (herdId) => {
        return scoutSupabase
            .channel(`${herdId}-devices`, { config: { private: true } })
            .on("broadcast", { event: "*" }, handleDeviceBroadcast)
            .subscribe((status) => {
            if (status === "SUBSCRIBED") {
                console.log(`[Devices] ✅ Connected to herd ${herdId}`);
            }
            else if (status === "CHANNEL_ERROR") {
                console.warn(`[Devices] 🟡 Failed to connect to herd ${herdId}`);
            }
        });
    };
    useEffect(() => {
        cleanupChannels();
        // Clear previous update when switching herds
        clearLatestUpdate();
        // Create devices channel for active herd
        if (activeHerdId) {
            const channel = createDevicesChannel(activeHerdId);
            channels.current.push(channel);
        }
        return cleanupChannels;
    }, [activeHerdId, clearLatestUpdate]);
    return [latestDeviceUpdate, clearLatestUpdate];
}