@adventurelabs/scout-core 1.4.19 → 1.4.21

package/dist/helpers/connectivity.d.ts

@@ -9,3 +9,5 @@ export declare function server_update_connectivity(connectivity: (ConnectivityUp
 }) | (ConnectivityUpdate & {
     id: number;
 })[], client?: SupabaseClient): Promise<IWebResponseCompatible<IConnectivity[]>>;
+/** Connectivity records for an artifact (uses session when set, else device + time window). */
+export declare function server_get_connectivity_for_artifact(artifactId: number, maxElements?: number): Promise<IWebResponseCompatible<IConnectivityWithCoordinates[]>>;

package/dist/helpers/connectivity.js

@@ -96,3 +96,26 @@ export async function server_update_connectivity(connectivity, client) {
     }
     return IWebResponse.success(updatedConnectivity).to_compatible();
 }
+/** Connectivity records for an artifact (uses session when set, else device + time window). */
+export async function server_get_connectivity_for_artifact(artifactId, maxElements = 1000) {
+    const supabase = await newServerClient();
+    const { data, error } = await supabase.rpc("get_connectivity_for_artifact", {
+        artifact_id_caller: artifactId,
+        max_elements_caller: maxElements,
+    });
+    if (error) {
+        console.warn("Error fetching connectivity for artifact:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: [],
+        };
+    }
+    const sortedConnectivity = (data || []).sort((a, b) => {
+        if (!a.timestamp_start || !b.timestamp_start)
+            return 0;
+        return (new Date(a.timestamp_start).getTime() -
+            new Date(b.timestamp_start).getTime());
+    });
+    return IWebResponse.success(sortedConnectivity).to_compatible();
+}

package/dist/helpers/sessions.d.ts

@@ -11,3 +11,5 @@ export declare function server_update_session(sessions: (SessionUpdate & {
 }) | (SessionUpdate & {
     id: number;
 })[], client?: SupabaseClient): Promise<IWebResponseCompatible<ISession[]>>;
+/** Artifact IDs for a session (same device, overlapping session interval). Empty if session or timestamps missing. */
+export declare function server_get_artifact_ids_for_session(sessionId: number, client?: SupabaseClient): Promise<IWebResponseCompatible<number[]>>;

package/dist/helpers/sessions.js

@@ -119,3 +119,19 @@ export async function server_update_session(sessions, client) {
     }
     return IWebResponse.success(updatedSessions).to_compatible();
 }
+/** Artifact IDs for a session (same device, overlapping session interval). Empty if session or timestamps missing. */
+export async function server_get_artifact_ids_for_session(sessionId, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase.rpc("get_artifact_ids_for_session", {
+        session_id_caller: sessionId,
+    });
+    if (error) {
+        console.warn("Error fetching artifact IDs for session:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: [],
+        };
+    }
+    return IWebResponse.success(Array.isArray(data) ? data : []).to_compatible();
+}

package/dist/helpers/tags.d.ts

@@ -1,4 +1,4 @@
-import { IEventAndTagsPrettyLocation, ITag } from "../types/db";
+import { IEventAndTagsPrettyLocation, ITag, ITagPrettyLocation } from "../types/db";
 import { IWebResponseCompatible } from "../types/requests";
 export declare function test_event_loading(device_id: number): Promise<boolean>;
 export declare function server_create_tags(tags: ITag[]): Promise<IWebResponseCompatible<ITag[]>>;
@@ -10,3 +10,9 @@ export declare function server_get_events_and_tags_for_devices_batch(device_ids:
     [device_id: number]: IEventAndTagsPrettyLocation[];
 }>>;
 export declare function get_event_and_tags_by_event_id(event_id: number): Promise<IWebResponseCompatible<IEventAndTagsPrettyLocation>>;
+/** Tags for an artifact with optional timestamp range and max items. */
+export declare function server_get_tags_for_artifact(artifactId: number, options?: {
+    start_timestamp?: string | null;
+    end_timestamp?: string | null;
+    max_elements?: number;
+}): Promise<IWebResponseCompatible<ITagPrettyLocation[]>>;

package/dist/helpers/tags.js

@@ -450,3 +450,26 @@ export async function get_event_and_tags_by_event_id(event_id) {
     }
     return IWebResponse.success(eventWithSignedUrl).to_compatible();
 }
+/** Tags for an artifact with optional timestamp range and max items. */
+export async function server_get_tags_for_artifact(artifactId, options) {
+    const supabase = await newServerClient();
+    const { data, error } = await supabase.rpc("get_tags_for_artifact", {
+        artifact_id_caller: artifactId,
+        max_elements_caller: options?.max_elements ?? 1000,
+        ...(options?.start_timestamp != null && {
+            start_timestamp_caller: options.start_timestamp,
+        }),
+        ...(options?.end_timestamp != null && {
+            end_timestamp_caller: options.end_timestamp,
+        }),
+    });
+    if (error) {
+        console.warn("Error fetching tags for artifact:", error.message);
+        return {
+            status: EnumWebResponse.ERROR,
+            msg: error.message,
+            data: [],
+        };
+    }
+    return IWebResponse.success(data ?? []).to_compatible();
+}

package/dist/hooks/useInfiniteQuery.js

@@ -418,6 +418,7 @@ export const useInfiniteFeedByHerd = (herdId, options) => {
     const [pages, setPages] = useState([]);
     const [currentCursor, setCurrentCursor] = useState(null);
     const prevHerdIdRef = useRef();
+    const lastAddedCursorRef = useRef(undefined);
     const currentQuery = useGetFeedInfiniteByHerdQuery({
         herdId,
         limit: options.limit || 20,
@@ -431,22 +432,29 @@ export const useInfiniteFeedByHerd = (herdId, options) => {
             herdId) {
             setPages([]);
             setCurrentCursor(null);
+            lastAddedCursorRef.current = undefined;
         }
         prevHerdIdRef.current = herdId;
     }, [herdId, options.enabled]);
     useEffect(() => {
-        if (currentQuery.data && !currentQuery.isLoading) {
-            setPages((prev) => {
-                const existingPage = prev.find((p) => feedCursorEq(p.cursor, currentCursor));
-                if (!existingPage) {
-                    return [
-                        ...prev,
-                        { cursor: currentCursor, data: currentQuery.data.items },
-                    ];
-                }
-                return prev;
-            });
-        }
+        if (!currentQuery.data || currentQuery.isLoading)
+            return;
+        if (feedCursorEq(lastAddedCursorRef.current ?? null, currentCursor))
+            return;
+        setPages((prev) => {
+            const existingPage = prev.find((p) => feedCursorEq(p.cursor, currentCursor));
+            if (!existingPage) {
+                const items = Array.isArray(currentQuery.data?.items)
+                    ? currentQuery.data.items
+                    : [];
+                lastAddedCursorRef.current = currentCursor;
+                return [
+                    ...prev,
+                    { cursor: currentCursor, data: items },
+                ];
+            }
+            return prev;
+        });
     }, [currentQuery.data, currentQuery.isLoading, currentCursor]);
     const loadMore = useCallback(() => {
         if (currentQuery.data?.hasMore &&
@@ -458,9 +466,19 @@ export const useInfiniteFeedByHerd = (herdId, options) => {
     const refetch = useCallback(() => {
         setPages([]);
         setCurrentCursor(null);
+        lastAddedCursorRef.current = undefined;
         currentQuery.refetch();
     }, [currentQuery]);
-    const allItems = useMemo(() => pages.flatMap((p) => p.data), [pages]);
+    const allItems = useMemo(() => {
+        const seen = new Set();
+        return pages.flatMap((p) => p.data).filter((item) => {
+            const key = `${item.sort_ts ?? ''}_${item.sort_id ?? ''}_${item.feed_type ?? ''}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }, [pages]);
     return {
         items: allItems,
         isLoading: currentQuery.isLoading && pages.length === 0,
@@ -475,6 +493,7 @@ export const useInfiniteFeedByDevice = (deviceId, options) => {
     const [pages, setPages] = useState([]);
     const [currentCursor, setCurrentCursor] = useState(null);
     const prevDeviceIdRef = useRef();
+    const lastAddedCursorRef = useRef(undefined);
     const currentQuery = useGetFeedInfiniteByDeviceQuery({
         deviceId,
         limit: options.limit || 20,
@@ -488,22 +507,29 @@ export const useInfiniteFeedByDevice = (deviceId, options) => {
             deviceId) {
             setPages([]);
             setCurrentCursor(null);
+            lastAddedCursorRef.current = undefined;
         }
         prevDeviceIdRef.current = deviceId;
     }, [deviceId, options.enabled]);
     useEffect(() => {
-        if (currentQuery.data && !currentQuery.isLoading) {
-            setPages((prev) => {
-                const existingPage = prev.find((p) => feedCursorEq(p.cursor, currentCursor));
-                if (!existingPage) {
-                    return [
-                        ...prev,
-                        { cursor: currentCursor, data: currentQuery.data.items },
-                    ];
-                }
-                return prev;
-            });
-        }
+        if (!currentQuery.data || currentQuery.isLoading)
+            return;
+        if (feedCursorEq(lastAddedCursorRef.current ?? null, currentCursor))
+            return;
+        setPages((prev) => {
+            const existingPage = prev.find((p) => feedCursorEq(p.cursor, currentCursor));
+            if (!existingPage) {
+                const items = Array.isArray(currentQuery.data?.items)
+                    ? currentQuery.data.items
+                    : [];
+                lastAddedCursorRef.current = currentCursor;
+                return [
+                    ...prev,
+                    { cursor: currentCursor, data: items },
+                ];
+            }
+            return prev;
+        });
     }, [currentQuery.data, currentQuery.isLoading, currentCursor]);
     const loadMore = useCallback(() => {
         if (currentQuery.data?.hasMore &&
@@ -515,9 +541,19 @@ export const useInfiniteFeedByDevice = (deviceId, options) => {
     const refetch = useCallback(() => {
         setPages([]);
         setCurrentCursor(null);
+        lastAddedCursorRef.current = undefined;
         currentQuery.refetch();
     }, [currentQuery]);
-    const allItems = useMemo(() => pages.flatMap((p) => p.data), [pages]);
+    const allItems = useMemo(() => {
+        const seen = new Set();
+        return pages.flatMap((p) => p.data).filter((item) => {
+            const key = `${item.sort_ts ?? ''}_${item.sort_id ?? ''}_${item.feed_type ?? ''}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }, [pages]);
     return {
         items: allItems,
         isLoading: currentQuery.isLoading && pages.length === 0,

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -58,6 +58,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -72,6 +73,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id?: number;
                 modality?: string | null;
                 session_id?: number | null;
+                tagged_at?: string | null;
                 timestamp_observation?: string | null;
                 timestamp_observation_end?: string;
                 updated_at?: string | null;
@@ -86,6 +88,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id?: number;
                 modality?: string | null;
                 session_id?: number | null;
+                tagged_at?: string | null;
                 timestamp_observation?: string | null;
                 timestamp_observation_end?: string;
                 updated_at?: string | null;
@@ -1341,6 +1344,12 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 status: string;
             }[];
         };
+        get_artifact_ids_for_session: {
+            Args: {
+                session_id_caller: number;
+            };
+            Returns: number[];
+        };
         get_artifacts_for_device: {
             Args: {
                 device_id_caller: number;
@@ -1357,6 +1366,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1383,6 +1393,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1410,6 +1421,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1437,6 +1449,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1465,6 +1478,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1493,6 +1507,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1521,6 +1536,7 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 id: number;
                 modality: string | null;
                 session_id: number | null;
+                tagged_at: string | null;
                 timestamp_observation: string | null;
                 timestamp_observation_end: string;
                 updated_at: string | null;
@@ -1532,6 +1548,19 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 isSetofReturn: true;
             };
         };
+        get_connectivity_for_artifact: {
+            Args: {
+                artifact_id_caller: number;
+                max_elements_caller?: number;
+            };
+            Returns: Database["public"]["CompositeTypes"]["connectivity_with_coordinates"][];
+            SetofOptions: {
+                from: "*";
+                to: "connectivity_with_coordinates";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
         get_connectivity_with_coordinates: {
             Args: {
                 session_id_caller: number;
@@ -1864,6 +1893,21 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 isSetofReturn: true;
             };
         };
+        get_tags_for_artifact: {
+            Args: {
+                artifact_id_caller: number;
+                end_timestamp_caller?: string;
+                max_elements_caller?: number;
+                start_timestamp_caller?: string;
+            };
+            Returns: Database["public"]["CompositeTypes"]["tags_pretty_location"][];
+            SetofOptions: {
+                from: "*";
+                to: "tags_pretty_location";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
         get_total_artifacts_for_herd: {
             Args: {
                 herd_id_caller: number;

package/dist/types/supabase.d.ts

@@ -57,6 +57,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -71,6 +72,7 @@ export type Database = {
                     id?: number;
                     modality?: string | null;
                     session_id?: number | null;
+                    tagged_at?: string | null;
                     timestamp_observation?: string | null;
                     timestamp_observation_end?: string;
                     updated_at?: string | null;
@@ -85,6 +87,7 @@ export type Database = {
                     id?: number;
                     modality?: string | null;
                     session_id?: number | null;
+                    tagged_at?: string | null;
                     timestamp_observation?: string | null;
                     timestamp_observation_end?: string;
                     updated_at?: string | null;
@@ -1408,6 +1411,12 @@ export type Database = {
                     status: string;
                 }[];
             };
+            get_artifact_ids_for_session: {
+                Args: {
+                    session_id_caller: number;
+                };
+                Returns: number[];
+            };
             get_artifacts_for_device: {
                 Args: {
                     device_id_caller: number;
@@ -1424,6 +1433,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1450,6 +1460,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1477,6 +1488,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1504,6 +1516,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1532,6 +1545,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1560,6 +1574,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1588,6 +1603,7 @@ export type Database = {
                     id: number;
                     modality: string | null;
                     session_id: number | null;
+                    tagged_at: string | null;
                     timestamp_observation: string | null;
                     timestamp_observation_end: string;
                     updated_at: string | null;
@@ -1599,6 +1615,19 @@ export type Database = {
                     isSetofReturn: true;
                 };
             };
+            get_connectivity_for_artifact: {
+                Args: {
+                    artifact_id_caller: number;
+                    max_elements_caller?: number;
+                };
+                Returns: Database["public"]["CompositeTypes"]["connectivity_with_coordinates"][];
+                SetofOptions: {
+                    from: "*";
+                    to: "connectivity_with_coordinates";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             get_connectivity_with_coordinates: {
                 Args: {
                     session_id_caller: number;
@@ -1931,6 +1960,21 @@ export type Database = {
                     isSetofReturn: true;
                 };
             };
+            get_tags_for_artifact: {
+                Args: {
+                    artifact_id_caller: number;
+                    end_timestamp_caller?: string;
+                    max_elements_caller?: number;
+                    start_timestamp_caller?: string;
+                };
+                Returns: Database["public"]["CompositeTypes"]["tags_pretty_location"][];
+                SetofOptions: {
+                    from: "*";
+                    to: "tags_pretty_location";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             get_total_artifacts_for_herd: {
                 Args: {
                     herd_id_caller: number;

package/package.json

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