@adventurelabs/scout-core/dist/hooks/useScoutRealtimeEvents.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 useScoutRealtimeEvents(scoutSupabase) {
    const channels = useRef([]);
    const [latestEventUpdate, setLatestEventUpdate] = useState(null);
    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
    // Event broadcast handler - just pass data, don't mutate state
    const handleEventBroadcast = useCallback((payload) => {
        console.log("[Events] Broadcast received:", payload.payload.operation);
        const data = payload.payload;
        const eventData = data.record || data.old_record;
        if (!eventData)
            return;
        let operation;
        switch (data.operation) {
            case "INSERT":
                operation = EnumRealtimeOperation.INSERT;
                console.log("[Events] New event received:", data.record);
                break;
            case "UPDATE":
                operation = EnumRealtimeOperation.UPDATE;
                console.log("[Events] Event updated:", data.record);
                break;
            case "DELETE":
                operation = EnumRealtimeOperation.DELETE;
                console.log("[Events] Event deleted:", data.old_record);
                break;
            default:
                return;
        }
        const realtimeData = {
            data: eventData,
            operation,
        };
        console.log(`[scout-core realtime] EVENT ${data.operation} received:`, JSON.stringify(realtimeData));
        setLatestEventUpdate(realtimeData);
    }, []);
    // Clear latest update
    const clearLatestUpdate = useCallback(() => {
        setLatestEventUpdate(null);
    }, []);
    const cleanupChannels = () => {
        channels.current.forEach((channel) => scoutSupabase.removeChannel(channel));
        channels.current = [];
    };
    const createEventsChannel = (herdId) => {
        return scoutSupabase
            .channel(`${herdId}-events`, { config: { private: true } })
            .on("broadcast", { event: "*" }, handleEventBroadcast)
            .subscribe((status) => {
            if (status === "SUBSCRIBED") {
                console.log(`[Events] ✅ Connected to herd ${herdId}`);
            }
            else if (status === "CHANNEL_ERROR") {
                console.warn(`[Events] 🟡 Failed to connect to herd ${herdId}`);
            }
        });
    };
    useEffect(() => {
        cleanupChannels();
        // Clear previous update when switching herds
        clearLatestUpdate();
        // Create events channel for active herd
        if (activeHerdId) {
            const channel = createEventsChannel(activeHerdId);
            channels.current.push(channel);
        }
        return cleanupChannels;
    }, [activeHerdId, clearLatestUpdate]);
    return [latestEventUpdate, clearLatestUpdate];
}