@adventurelabs/scout-core 1.4.1 → 1.4.2

package/dist/hooks/index.d.ts

@@ -7,5 +7,6 @@ export { useScoutRealtimeTags } from "./useScoutRealtimeTags";
 export { useScoutRealtimeSessions } from "./useScoutRealtimeSessions";
 export { useScoutRealtimePlans } from "./useScoutRealtimePlans";
 export { useScoutRealtimePins } from "./useScoutRealtimePins";
+export { useScoutRealtimeParts } from "./useScoutRealtimeParts";
 export { useInfiniteSessionsByHerd, useInfiniteSessionsByDevice, useInfiniteEventsByHerd, useInfiniteEventsByDevice, useInfiniteArtifactsByHerd, useInfiniteArtifactsByDevice, useIntersectionObserver, } from "./useInfiniteQuery";
 export { useLoadingPerformance, useSessionSummariesByHerd, useHasSessionSummaries, } from "../store/hooks";

package/dist/hooks/index.js

@@ -7,6 +7,7 @@ export { useScoutRealtimeTags } from "./useScoutRealtimeTags";
 export { useScoutRealtimeSessions } from "./useScoutRealtimeSessions";
 export { useScoutRealtimePlans } from "./useScoutRealtimePlans";
 export { useScoutRealtimePins } from "./useScoutRealtimePins";
+export { useScoutRealtimeParts } from "./useScoutRealtimeParts";
 // RTK Query infinite scroll hooks
 export { useInfiniteSessionsByHerd, useInfiniteSessionsByDevice, useInfiniteEventsByHerd, useInfiniteEventsByDevice, useInfiniteArtifactsByHerd, useInfiniteArtifactsByDevice, useIntersectionObserver, } from "./useInfiniteQuery";
 // Session summaries and performance hooks

package/dist/hooks/useScoutRealtimeParts.d.ts

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

package/dist/hooks/useScoutRealtimeParts.js

@@ -0,0 +1,113 @@
+"use client";
+import { useAppDispatch } from "../store/hooks";
+import { useSelector } from "react-redux";
+import { useEffect, useRef, useCallback, useState } from "react";
+import { EnumRealtimeOperation } from "../types/realtime";
+export function useScoutRealtimeParts(scoutSupabase) {
+    const channels = useRef([]);
+    const dispatch = useAppDispatch();
+    const [latestPartUpdate, setLatestPartUpdate] = useState(null);
+    const activeHerdId = useSelector((state) => state.scout.active_herd_id);
+    const herdModules = useSelector((state) => state.scout.herd_modules);
+    // Part broadcast handler
+    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;
+        // Find the target herd module and device
+        const herdModule = herdModules.find((hm) => hm.herd.id.toString() === activeHerdId);
+        if (!herdModule) {
+            console.warn("[Parts] No herd module found for active herd");
+            return;
+        }
+        const targetDevice = herdModule.devices.find((device) => device.id === partData.device_id);
+        if (!targetDevice) {
+            console.warn(`[Parts] No device found with ID: ${partData.device_id}`);
+            return;
+        }
+        // Ensure device has parts array
+        if (!targetDevice.parts) {
+            targetDevice.parts = [];
+        }
+        switch (data.operation) {
+            case "INSERT":
+                operation = EnumRealtimeOperation.INSERT;
+                if (data.record) {
+                    console.log("[Parts] New part received:", data.record);
+                    // Add part to device's parts array if not already present
+                    const existingPartIndex = targetDevice.parts.findIndex((p) => p.id === data.record.id);
+                    if (existingPartIndex === -1) {
+                        targetDevice.parts.push(data.record);
+                    }
+                }
+                break;
+            case "UPDATE":
+                operation = EnumRealtimeOperation.UPDATE;
+                if (data.record) {
+                    console.log("[Parts] Part updated:", data.record);
+                    // Update existing part in device's parts array
+                    const partIndex = targetDevice.parts.findIndex((p) => p.id === data.record.id);
+                    if (partIndex !== -1) {
+                        targetDevice.parts[partIndex] = data.record;
+                    }
+                    else {
+                        // Part not found, add it
+                        targetDevice.parts.push(data.record);
+                    }
+                }
+                break;
+            case "DELETE":
+                operation = EnumRealtimeOperation.DELETE;
+                if (data.old_record) {
+                    console.log("[Parts] Part deleted:", data.old_record);
+                    // Remove part from device's parts array
+                    targetDevice.parts = targetDevice.parts.filter((p) => p.id !== data.old_record.id);
+                }
+                break;
+            default:
+                return;
+        }
+        const realtimeData = {
+            data: partData,
+            operation,
+        };
+        console.log(`[scout-core realtime] PART ${data.operation} received:`, JSON.stringify(realtimeData));
+        setLatestPartUpdate(realtimeData);
+    }, [dispatch, activeHerdId, herdModules]);
+    // 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];
+}

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export * from "./hooks/useScoutRealtimeVersionsSoftware";
 export * from "./hooks/useScoutRealtimeEvents";
 export * from "./hooks/useScoutRealtimeTags";
 export * from "./hooks/useScoutRealtimeSessions";
+export * from "./hooks/useScoutRealtimeParts";
 export * from "./hooks/useScoutRealtimePlans";
 export * from "./hooks/useScoutRealtimePins";
 export * from "./hooks/useScoutRefresh";

package/dist/index.js

@@ -49,6 +49,7 @@ export * from "./hooks/useScoutRealtimeVersionsSoftware";
 export * from "./hooks/useScoutRealtimeEvents";
 export * from "./hooks/useScoutRealtimeTags";
 export * from "./hooks/useScoutRealtimeSessions";
+export * from "./hooks/useScoutRealtimeParts";
 export * from "./hooks/useScoutRealtimePlans";
 export * from "./hooks/useScoutRealtimePins";
 export * from "./hooks/useScoutRefresh";

package/package.json

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