@adventurelabs/scout-core 1.0.119 → 1.0.121

package/dist/constants/db.d.ts

@@ -1 +1,2 @@
 export declare const BUCKET_NAME_SCOUT = "scout";
+export declare const SIGNED_URL_EXPIRATION_SECONDS: number;

package/dist/constants/db.js

@@ -1 +1,3 @@
 export const BUCKET_NAME_SCOUT = "scout";
+// Signed URL expiration time in seconds (12 hours = 43200 seconds)
+export const SIGNED_URL_EXPIRATION_SECONDS = 12 * 60 * 60;

package/dist/helpers/artifacts.d.ts

@@ -0,0 +1,9 @@
+import { IArtifactWithMediaUrl } from "../types/db";
+import { IWebResponseCompatible } from "../types/requests";
+import { SupabaseClient } from "@supabase/supabase-js";
+export declare function server_get_artifacts_by_herd(herd_id: number, limit?: number, offset?: number, client?: SupabaseClient): Promise<IWebResponseCompatible<IArtifactWithMediaUrl[]>>;
+export declare function server_get_artifacts_by_device_id(device_id: number, limit?: number, offset?: number, client?: SupabaseClient): Promise<IWebResponseCompatible<IArtifactWithMediaUrl[]>>;
+export declare function server_get_total_artifacts_by_herd(herd_id: number): Promise<IWebResponseCompatible<number>>;
+export declare function server_get_artifacts_by_device_ids_batch(device_ids: number[], limit_per_device?: number, client?: SupabaseClient): Promise<{
+    [device_id: number]: IArtifactWithMediaUrl[];
+}>;

package/dist/helpers/artifacts.js

@@ -0,0 +1,121 @@
+"use server";
+import { newServerClient } from "../supabase/server";
+import { IWebResponse, } from "../types/requests";
+import { generateSignedUrlsBatch } from "./storage";
+export async function server_get_artifacts_by_herd(herd_id, limit = 50, offset = 0, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase.rpc("get_artifacts_for_herd", {
+        herd_id_caller: herd_id,
+        limit_caller: limit,
+        offset_caller: offset,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("No artifacts found for herd").to_compatible();
+    }
+    // Generate signed URLs for artifacts
+    const uniqueFilePaths = Array.from(new Set(data
+        .map((artifact) => artifact.file_path)
+        .filter((path) => !!path)));
+    if (uniqueFilePaths.length === 0) {
+        return IWebResponse.success(data).to_compatible();
+    }
+    const signedUrls = await generateSignedUrlsBatch(uniqueFilePaths, undefined, client);
+    const urlMap = new Map();
+    uniqueFilePaths.forEach((path, index) => {
+        urlMap.set(path, signedUrls[index]);
+    });
+    const artifactsWithUrls = data.map((artifact) => ({
+        ...artifact,
+        media_url: artifact.file_path
+            ? urlMap.get(artifact.file_path) || null
+            : null,
+    }));
+    return IWebResponse.success(artifactsWithUrls).to_compatible();
+}
+export async function server_get_artifacts_by_device_id(device_id, limit = 50, offset = 0, client) {
+    const supabase = client || (await newServerClient());
+    const { data, error } = await supabase.rpc("get_artifacts_for_device", {
+        device_id_caller: device_id,
+        limit_caller: limit,
+        offset_caller: offset,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    if (!data) {
+        return IWebResponse.error("No artifacts found for device").to_compatible();
+    }
+    // Generate signed URLs for artifacts
+    const uniqueFilePaths = Array.from(new Set(data
+        .map((artifact) => artifact.file_path)
+        .filter((path) => !!path)));
+    if (uniqueFilePaths.length === 0) {
+        return IWebResponse.success(data).to_compatible();
+    }
+    const signedUrls = await generateSignedUrlsBatch(uniqueFilePaths, undefined, client);
+    const urlMap = new Map();
+    uniqueFilePaths.forEach((path, index) => {
+        urlMap.set(path, signedUrls[index]);
+    });
+    const artifactsWithUrls = data.map((artifact) => ({
+        ...artifact,
+        media_url: artifact.file_path
+            ? urlMap.get(artifact.file_path) || null
+            : null,
+    }));
+    return IWebResponse.success(artifactsWithUrls).to_compatible();
+}
+export async function server_get_total_artifacts_by_herd(herd_id) {
+    const supabase = await newServerClient();
+    const { data, error } = await supabase.rpc("get_total_artifacts_for_herd", {
+        herd_id_caller: herd_id,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data || 0).to_compatible();
+}
+export async function server_get_artifacts_by_device_ids_batch(device_ids, limit_per_device = 10, client) {
+    const supabase = client || (await newServerClient());
+    if (device_ids.length === 0) {
+        return {};
+    }
+    const { data, error } = await supabase.rpc("get_artifacts_for_devices_batch", {
+        device_ids: device_ids,
+        limit_per_device: limit_per_device,
+    });
+    if (error || !data) {
+        console.warn("Error fetching artifacts batch:", error?.message);
+        return {};
+    }
+    // Generate signed URLs for artifacts
+    const uniqueFilePaths = Array.from(new Set(data
+        .map((artifact) => artifact.file_path)
+        .filter((path) => !!path)));
+    let artifactsWithUrls = data;
+    if (uniqueFilePaths.length > 0) {
+        const signedUrls = await generateSignedUrlsBatch(uniqueFilePaths, undefined, client);
+        const urlMap = new Map();
+        uniqueFilePaths.forEach((path, index) => {
+            urlMap.set(path, signedUrls[index]);
+        });
+        artifactsWithUrls = data.map((artifact) => ({
+            ...artifact,
+            media_url: artifact.file_path
+                ? urlMap.get(artifact.file_path) || null
+                : null,
+        }));
+    }
+    // Group artifacts by device_id
+    const artifactsByDevice = {};
+    artifactsWithUrls.forEach((artifact) => {
+        if (!artifactsByDevice[artifact.device_id]) {
+            artifactsByDevice[artifact.device_id] = [];
+        }
+        artifactsByDevice[artifact.device_id].push(artifact);
+    });
+    return artifactsByDevice;
+}

package/dist/helpers/index.d.ts

@@ -21,3 +21,4 @@ export * from "./cache";
 export * from "./operators";
 export * from "./components";
 export * from "./versions_software";
+export * from "./artifacts";

package/dist/helpers/index.js

@@ -21,3 +21,4 @@ export * from "./cache";
 export * from "./operators";
 export * from "./components";
 export * from "./versions_software";
+export * from "./artifacts";

package/dist/helpers/storage.d.ts

@@ -3,18 +3,9 @@ import { Database } from "../types/supabase";
 /**
  * Generates a signed URL for a file in Supabase storage
  * @param filePath - The path to the file in storage (e.g., "events/123/image.jpg")
- * @param expiresIn - Number of seconds until the URL expires (default: 3600 = 1 hour)
+ * @param expiresIn - Number of seconds until the URL expires (default: 12 hours)
  * @param supabaseClient - Optional Supabase client (will create new one if not provided)
  * @returns Promise<string | null> - The signed URL or null if error
  */
 export declare function generateSignedUrl(filePath: string, expiresIn?: number, supabaseClient?: SupabaseClient<Database>): Promise<string | null>;
-export declare function generateSignedUrlsBatch(filePaths: string[], expiresIn?: number, supabaseClient?: SupabaseClient<Database>): Promise<Map<string, string | null>>;
-export declare function addSignedUrlsToEventsBatch(events: any[], supabaseClient?: SupabaseClient<Database>): Promise<any[]>;
-export declare function addSignedUrlsToEvents(events: any[], supabaseClient?: SupabaseClient<Database>): Promise<any[]>;
-/**
- * Generates a signed URL for a single event and sets it as media_url
- * @param event - Event object that may have file_path
- * @param supabaseClient - Optional Supabase client (will create new one if not provided)
- * @returns Promise<Object> - Event with signed URL set as media_url
- */
-export declare function addSignedUrlToEvent(event: any, supabaseClient?: SupabaseClient<Database>): Promise<any>;
+export declare function generateSignedUrlsBatch(filePaths: string[], expiresIn?: number, supabaseClient?: SupabaseClient<Database>): Promise<(string | null)[]>;

package/dist/helpers/storage.js

@@ -1,14 +1,14 @@
 "use server";
 import { newServerClient } from "../supabase/server";
-import { BUCKET_NAME_SCOUT } from "../constants/db";
+import { BUCKET_NAME_SCOUT, SIGNED_URL_EXPIRATION_SECONDS, } from "../constants/db";
 /**
  * Generates a signed URL for a file in Supabase storage
  * @param filePath - The path to the file in storage (e.g., "events/123/image.jpg")
- * @param expiresIn - Number of seconds until the URL expires (default: 3600 = 1 hour)
+ * @param expiresIn - Number of seconds until the URL expires (default: 12 hours)
  * @param supabaseClient - Optional Supabase client (will create new one if not provided)
  * @returns Promise<string | null> - The signed URL or null if error
  */
-export async function generateSignedUrl(filePath, expiresIn = 3600, supabaseClient) {
+export async function generateSignedUrl(filePath, expiresIn = SIGNED_URL_EXPIRATION_SECONDS, supabaseClient) {
     try {
         const supabase = supabaseClient || (await newServerClient());
         const { data, error } = await supabase.storage
@@ -25,10 +25,9 @@ export async function generateSignedUrl(filePath, expiresIn = 3600, supabaseClie
         return null;
     }
 }
-export async function generateSignedUrlsBatch(filePaths, expiresIn = 3600, supabaseClient) {
+export async function generateSignedUrlsBatch(filePaths, expiresIn = SIGNED_URL_EXPIRATION_SECONDS, supabaseClient) {
     try {
         const supabase = supabaseClient || (await newServerClient());
-        const urlMap = new Map();
         const signedUrlPromises = filePaths.map(async (filePath) => {
             try {
                 const { data, error } = await supabase.storage
@@ -36,63 +35,20 @@ export async function generateSignedUrlsBatch(filePaths, expiresIn = 3600, supab
                     .createSignedUrl(filePath, expiresIn);
                 if (error) {
                     console.error(`Error generating signed URL for ${filePath}:`, error.message);
-                    return { filePath, signedUrl: null };
+                    return null;
                 }
-                return { filePath, signedUrl: data.signedUrl };
+                return data.signedUrl;
             }
             catch (error) {
-                console.error(`Error in generateSignedUrl for ${filePath}:`, error);
-                return { filePath, signedUrl: null };
+                console.error(`Exception generating signed URL for ${filePath}:`, error);
+                return null;
             }
         });
         const results = await Promise.all(signedUrlPromises);
-        results.forEach(({ filePath, signedUrl }) => {
-            urlMap.set(filePath, signedUrl);
-        });
-        return urlMap;
+        return results;
     }
     catch (error) {
         console.error("Error in generateSignedUrlsBatch:", error);
-        return new Map();
-    }
-}
-export async function addSignedUrlsToEventsBatch(events, supabaseClient) {
-    const filePaths = events
-        .map((event) => event.file_path)
-        .filter((path) => path)
-        .filter((path, index, array) => array.indexOf(path) === index);
-    if (filePaths.length === 0) {
-        return events;
-    }
-    const urlMap = await generateSignedUrlsBatch(filePaths, 3600, supabaseClient);
-    return events.map((event) => {
-        if (event.file_path && urlMap.has(event.file_path)) {
-            const signedUrl = urlMap.get(event.file_path);
-            return {
-                ...event,
-                media_url: signedUrl || event.media_url,
-            };
-        }
-        return event;
-    });
-}
-export async function addSignedUrlsToEvents(events, supabaseClient) {
-    return addSignedUrlsToEventsBatch(events, supabaseClient);
-}
-/**
- * Generates a signed URL for a single event and sets it as media_url
- * @param event - Event object that may have file_path
- * @param supabaseClient - Optional Supabase client (will create new one if not provided)
- * @returns Promise<Object> - Event with signed URL set as media_url
- */
-export async function addSignedUrlToEvent(event, supabaseClient) {
-    // If event has a file_path, generate a signed URL and set it as media_url
-    if (event.file_path) {
-        const signedUrl = await generateSignedUrl(event.file_path, 3600, supabaseClient);
-        return {
-            ...event,
-            media_url: signedUrl || event.media_url, // Fall back to existing media_url if signed URL fails
-        };
+        return new Array(filePaths.length).fill(null);
     }
-    return event;
 }

package/dist/helpers/tags.js

@@ -2,7 +2,7 @@
 // add tag to db
 import { newServerClient } from "../supabase/server";
 import { EnumWebResponse, IWebResponse, } from "../types/requests";
-import { addSignedUrlsToEvents, addSignedUrlToEvent } from "./storage";
+import { generateSignedUrlsBatch, generateSignedUrl } from "./storage";
 // Helper functions to extract coordinates from location field
 function extractLatitude(location) {
     try {
@@ -169,8 +169,22 @@ export async function server_get_more_events_with_tags_by_herd(herd_id, offset,
         event.tags = event.tags.filter((tag) => tag !== null);
         return event;
     });
-    // Add signed URLs to events using the same client
-    const eventsWithSignedUrls = await addSignedUrlsToEvents(filtered_data, supabase);
+    // Generate signed URLs for events
+    const filePaths = filtered_data
+        .map((event) => event.file_path)
+        .filter((path) => !!path);
+    let eventsWithSignedUrls = filtered_data;
+    if (filePaths.length > 0) {
+        const signedUrls = await generateSignedUrlsBatch(filePaths, undefined, supabase);
+        const urlMap = new Map();
+        filePaths.forEach((path, index) => {
+            urlMap.set(path, signedUrls[index]);
+        });
+        eventsWithSignedUrls = filtered_data.map((event) => ({
+            ...event,
+            media_url: event.file_path ? urlMap.get(event.file_path) || null : null,
+        }));
+    }
     return IWebResponse.success(eventsWithSignedUrls).to_compatible();
 }
 export async function server_get_events_and_tags_for_device(device_id, limit = 3) {
@@ -188,8 +202,23 @@ export async function server_get_events_and_tags_for_device(device_id, limit = 3
             data: [],
         };
     }
-    // Add signed URLs to events using the same client
-    const eventsWithSignedUrls = await addSignedUrlsToEvents(data || [], supabase);
+    // Generate signed URLs for events
+    const eventData = data || [];
+    const filePaths = eventData
+        .map((event) => event.file_path)
+        .filter((path) => !!path);
+    let eventsWithSignedUrls = eventData;
+    if (filePaths.length > 0) {
+        const signedUrls = await generateSignedUrlsBatch(filePaths, undefined, supabase);
+        const urlMap = new Map();
+        filePaths.forEach((path, index) => {
+            urlMap.set(path, signedUrls[index]);
+        });
+        eventsWithSignedUrls = eventData.map((event) => ({
+            ...event,
+            media_url: event.file_path ? urlMap.get(event.file_path) || null : null,
+        }));
+    }
     return IWebResponse.success(eventsWithSignedUrls).to_compatible();
 }
 export async function server_get_events_and_tags_for_devices_batch(device_ids, limit = 1) {
@@ -256,9 +285,31 @@ export async function server_get_events_and_tags_for_devices_batch(device_ids, l
     });
     // Add signed URLs to all events
     const result = {};
+    // Get all file paths for batch URL generation
+    const allFilePaths = [];
+    for (const device_id in eventsByDevice) {
+        const events = eventsByDevice[device_id];
+        events.forEach((event) => {
+            if (event.file_path && !allFilePaths.includes(event.file_path)) {
+                allFilePaths.push(event.file_path);
+            }
+        });
+    }
+    // Generate all signed URLs at once
+    const signedUrls = allFilePaths.length > 0
+        ? await generateSignedUrlsBatch(allFilePaths, undefined, supabase)
+        : [];
+    const urlMap = new Map();
+    allFilePaths.forEach((path, index) => {
+        urlMap.set(path, signedUrls[index]);
+    });
+    // Apply signed URLs to events
     for (const device_id in eventsByDevice) {
         const events = eventsByDevice[device_id];
-        const eventsWithSignedUrls = await addSignedUrlsToEvents(events, supabase);
+        const eventsWithSignedUrls = events.map((event) => ({
+            ...event,
+            media_url: event.file_path ? urlMap.get(event.file_path) || null : null,
+        }));
         result[parseInt(device_id)] = eventsWithSignedUrls;
     }
     return IWebResponse.success(result).to_compatible();
@@ -369,7 +420,14 @@ export async function get_event_and_tags_by_event_id(event_id) {
         earthranger_url: data[0].earthranger_url,
         file_path: data[0].file_path,
     };
-    // Add signed URL to event using the same client
-    const eventWithSignedUrl = await addSignedUrlToEvent(transformedData, supabase);
+    // Generate signed URL for event
+    let eventWithSignedUrl = transformedData;
+    if (transformedData.file_path) {
+        const signedUrl = await generateSignedUrl(transformedData.file_path, undefined, supabase);
+        eventWithSignedUrl = {
+            ...transformedData,
+            media_url: signedUrl,
+        };
+    }
     return IWebResponse.success(eventWithSignedUrl).to_compatible();
 }

package/dist/index.d.ts

@@ -36,6 +36,8 @@ export * from "./helpers/cache";
 export * from "./helpers/heartbeats";
 export * from "./helpers/providers";
 export * from "./helpers/operators";
+export * from "./helpers/versions_software";
+export * from "./helpers/components";
 export * from "./hooks/useScoutRealtimeConnectivity";
 export * from "./hooks/useScoutRealtimeDevices";
 export * from "./hooks/useScoutRefresh";

package/dist/index.js

@@ -39,6 +39,8 @@ export * from "./helpers/cache";
 export * from "./helpers/heartbeats";
 export * from "./helpers/providers";
 export * from "./helpers/operators";
+export * from "./helpers/versions_software";
+export * from "./helpers/components";
 // Hooks
 export * from "./hooks/useScoutRealtimeConnectivity";
 export * from "./hooks/useScoutRealtimeDevices";

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -1037,6 +1037,74 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 status: string;
             }[];
         };
+        get_artifacts_for_device: {
+            Args: {
+                device_id_caller: number;
+                limit_caller?: number;
+                offset_caller?: number;
+            };
+            Returns: {
+                created_at: string;
+                device_id: number;
+                file_path: string;
+                id: number;
+                modality: string | null;
+                session_id: number | null;
+                timestamp_observation: string | null;
+                updated_at: string | null;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "artifacts";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
+        get_artifacts_for_devices_batch: {
+            Args: {
+                device_ids: number[];
+                limit_per_device?: number;
+            };
+            Returns: {
+                created_at: string;
+                device_id: number;
+                file_path: string;
+                id: number;
+                modality: string | null;
+                session_id: number | null;
+                timestamp_observation: string | null;
+                updated_at: string | null;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "artifacts";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
+        get_artifacts_for_herd: {
+            Args: {
+                herd_id_caller: number;
+                limit_caller?: number;
+                offset_caller?: number;
+            };
+            Returns: {
+                created_at: string;
+                device_id: number;
+                file_path: string;
+                id: number;
+                modality: string | null;
+                session_id: number | null;
+                timestamp_observation: string | null;
+                updated_at: string | null;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "artifacts";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
         get_connectivity_with_coordinates: {
             Args: {
                 session_id_caller: number;
@@ -1212,6 +1280,12 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
                 isSetofReturn: true;
             };
         };
+        get_total_artifacts_for_herd: {
+            Args: {
+                herd_id_caller: number;
+            };
+            Returns: number;
+        };
         get_total_events_for_herd_with_session_filter: {
             Args: {
                 exclude_session_events: boolean;

package/dist/store/scout.d.ts

@@ -88,6 +88,14 @@ export declare const scoutSlice: import("@reduxjs/toolkit").Slice<ScoutState, {
         payload: any;
         type: string;
     }) => void;
+    replaceArtifactsForHerdModule: (state: import("immer").WritableDraft<ScoutState>, action: {
+        payload: any;
+        type: string;
+    }) => void;
+    appendArtifactsToHerdModule: (state: import("immer").WritableDraft<ScoutState>, action: {
+        payload: any;
+        type: string;
+    }) => void;
     appendPlansToHerdModule: (state: import("immer").WritableDraft<ScoutState>, action: {
         payload: any;
         type: string;
@@ -165,6 +173,6 @@ export declare const scoutSlice: import("@reduxjs/toolkit").Slice<ScoutState, {
         type: string;
     }) => void;
 }, "scout", "scout", import("@reduxjs/toolkit").SliceSelectors<ScoutState>>;
-export declare const setHerdModules: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModules">, setStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setStatus">, setHerdModulesLoadingState: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadingState">, setHerdModulesLoadedInMs: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadedInMs">, setHerdModulesApiServerProcessingDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesApiServerProcessingDuration">, setHerdModulesApiTotalRequestDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesApiTotalRequestDuration">, setUserApiDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUserApiDuration">, setDataProcessingDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataProcessingDuration">, setCacheLoadDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setCacheLoadDuration">, setActiveHerdId: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdId">, setActiveDeviceId: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveDeviceId">, setDataSource: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataSource">, setDataSourceInfo: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataSourceInfo">, appendEventsToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendEventsToHerdModule">, replaceEventsForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/replaceEventsForHerdModule">, updateEventValuesForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateEventValuesForHerdModule">, updatePageIndexForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updatePageIndexForHerdModule">, appendPlansToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendPlansToHerdModule">, setUser: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUser">, addTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addTag">, deleteTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteTag">, updateTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateTag">, addNewDeviceToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addNewDeviceToHerdModule">, updateDeviceForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateDeviceForHerdModule">, addDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addDevice">, deleteDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteDevice">, updateDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateDevice">, addPlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addPlan">, deletePlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deletePlan">, updatePlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updatePlan">, addSessionToStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addSessionToStore">, deleteSessionFromStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteSessionFromStore">, updateSessionInStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateSessionInStore">, setActiveHerdGpsTrackersConnectivity: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdGpsTrackersConnectivity">;
+export declare const setHerdModules: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModules">, setStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setStatus">, setHerdModulesLoadingState: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadingState">, setHerdModulesLoadedInMs: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadedInMs">, setHerdModulesApiServerProcessingDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesApiServerProcessingDuration">, setHerdModulesApiTotalRequestDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesApiTotalRequestDuration">, setUserApiDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUserApiDuration">, setDataProcessingDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataProcessingDuration">, setCacheLoadDuration: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setCacheLoadDuration">, setActiveHerdId: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdId">, setActiveDeviceId: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveDeviceId">, setDataSource: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataSource">, setDataSourceInfo: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setDataSourceInfo">, appendEventsToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendEventsToHerdModule">, replaceEventsForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/replaceEventsForHerdModule">, appendArtifactsToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendArtifactsToHerdModule">, replaceArtifactsForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/replaceArtifactsForHerdModule">, updateEventValuesForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateEventValuesForHerdModule">, updatePageIndexForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updatePageIndexForHerdModule">, appendPlansToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendPlansToHerdModule">, setUser: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUser">, addTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addTag">, deleteTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteTag">, updateTag: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateTag">, addNewDeviceToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addNewDeviceToHerdModule">, updateDeviceForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateDeviceForHerdModule">, addDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addDevice">, deleteDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteDevice">, updateDevice: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateDevice">, addPlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addPlan">, deletePlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deletePlan">, updatePlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updatePlan">, addSessionToStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/addSessionToStore">, deleteSessionFromStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/deleteSessionFromStore">, updateSessionInStore: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateSessionInStore">, setActiveHerdGpsTrackersConnectivity: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdGpsTrackersConnectivity">;
 declare const _default: import("redux").Reducer<ScoutState>;
 export default _default;

package/dist/store/scout.js

@@ -85,6 +85,20 @@ export const scoutSlice = createSlice({
                 herd_module.events = [...herd_module.events, ...events];
             }
         },
+        replaceArtifactsForHerdModule: (state, action) => {
+            const { herd_id, artifacts } = action.payload;
+            const herd_module = state.herd_modules.find((hm) => hm.herd.id.toString() === herd_id);
+            if (herd_module) {
+                herd_module.artifacts = artifacts;
+            }
+        },
+        appendArtifactsToHerdModule: (state, action) => {
+            const { herd_id, artifacts } = action.payload;
+            const herd_module = state.herd_modules.find((hm) => hm.herd.id.toString() === herd_id);
+            if (herd_module) {
+                herd_module.artifacts = [...herd_module.artifacts, ...artifacts];
+            }
+        },
         appendPlansToHerdModule: (state, action) => {
             const { herd_id, plan } = action.payload;
             const herd_module = state.herd_modules.find((hm) => hm.herd.id.toString() === herd_id);
@@ -273,5 +287,5 @@ export const scoutSlice = createSlice({
     },
 });
 // Action creators are generated for each case reducer function
-export const { setHerdModules, setStatus, setHerdModulesLoadingState, setHerdModulesLoadedInMs, setHerdModulesApiServerProcessingDuration, setHerdModulesApiTotalRequestDuration, setUserApiDuration, setDataProcessingDuration, setCacheLoadDuration, setActiveHerdId, setActiveDeviceId, setDataSource, setDataSourceInfo, appendEventsToHerdModule, replaceEventsForHerdModule, updateEventValuesForHerdModule, updatePageIndexForHerdModule, appendPlansToHerdModule, setUser, addTag, deleteTag, updateTag, addNewDeviceToHerdModule, updateDeviceForHerdModule, addDevice, deleteDevice, updateDevice, addPlan, deletePlan, updatePlan, addSessionToStore, deleteSessionFromStore, updateSessionInStore, setActiveHerdGpsTrackersConnectivity, } = scoutSlice.actions;
+export const { setHerdModules, setStatus, setHerdModulesLoadingState, setHerdModulesLoadedInMs, setHerdModulesApiServerProcessingDuration, setHerdModulesApiTotalRequestDuration, setUserApiDuration, setDataProcessingDuration, setCacheLoadDuration, setActiveHerdId, setActiveDeviceId, setDataSource, setDataSourceInfo, appendEventsToHerdModule, replaceEventsForHerdModule, appendArtifactsToHerdModule, replaceArtifactsForHerdModule, updateEventValuesForHerdModule, updatePageIndexForHerdModule, appendPlansToHerdModule, setUser, addTag, deleteTag, updateTag, addNewDeviceToHerdModule, updateDeviceForHerdModule, addDevice, deleteDevice, updateDevice, addPlan, deletePlan, updatePlan, addSessionToStore, deleteSessionFromStore, updateSessionInStore, setActiveHerdGpsTrackersConnectivity, } = scoutSlice.actions;
 export default scoutSlice.reducer;

package/dist/types/db.d.ts

@@ -26,8 +26,13 @@ export type IOperator = Database["public"]["Tables"]["operators"]["Row"];
 export type IProvider = Database["public"]["Tables"]["providers"]["Row"];
 export type IComponent = Database["public"]["Tables"]["components"]["Row"];
 export type IVersionsSoftware = Database["public"]["Tables"]["versions_software"]["Row"];
+export type IArtifact = Database["public"]["Tables"]["artifacts"]["Row"];
+export type IArtifactWithMediaUrl = IArtifact & {
+    media_url?: string | null;
+};
 export type ComponentInsert = Database["public"]["Tables"]["components"]["Insert"];
 export type VersionsSoftwareInsert = Database["public"]["Tables"]["versions_software"]["Insert"];
+export type ArtifactInsert = Database["public"]["Tables"]["artifacts"]["Insert"];
 export type IEventWithTags = Database["public"]["CompositeTypes"]["event_with_tags"] & {
     earthranger_url: string | null;
     file_path: string | null;

package/dist/types/herd_module.d.ts

@@ -1,5 +1,5 @@
 import { SupabaseClient } from "@supabase/supabase-js";
-import { IDevice, IEventWithTags, IHerd, IPlan, ILayer, IProvider, IUserAndRole, IZoneWithActions, ISessionWithCoordinates } from "../types/db";
+import { IDevice, IEventWithTags, IHerd, IPlan, ILayer, IProvider, IUserAndRole, IZoneWithActions, ISessionWithCoordinates, IArtifactWithMediaUrl } from "../types/db";
 import { EnumWebResponse } from "./requests";
 export declare enum EnumHerdModulesLoadingState {
     NOT_LOADING = "NOT_LOADING",
@@ -13,16 +13,18 @@ export declare class HerdModule {
     events: IEventWithTags[];
     zones: IZoneWithActions[];
     sessions: ISessionWithCoordinates[];
+    artifacts: IArtifactWithMediaUrl[];
     timestamp_last_refreshed: number;
     user_roles: IUserAndRole[] | null;
     events_page_index: number;
     total_events: number;
     total_events_with_filters: number;
+    total_artifacts: number;
     labels: string[];
     plans: IPlan[];
     layers: ILayer[];
     providers: IProvider[];
-    constructor(herd: IHerd, devices: IDevice[], events: IEventWithTags[], timestamp_last_refreshed: number, user_roles?: IUserAndRole[] | null, events_page_index?: number, total_events?: number, total_events_with_filters?: number, labels?: string[], plans?: IPlan[], zones?: IZoneWithActions[], sessions?: ISessionWithCoordinates[], layers?: ILayer[], providers?: IProvider[]);
+    constructor(herd: IHerd, devices: IDevice[], events: IEventWithTags[], timestamp_last_refreshed: number, user_roles?: IUserAndRole[] | null, events_page_index?: number, total_events?: number, total_events_with_filters?: number, labels?: string[], plans?: IPlan[], zones?: IZoneWithActions[], sessions?: ISessionWithCoordinates[], layers?: ILayer[], providers?: IProvider[], artifacts?: IArtifactWithMediaUrl[], total_artifacts?: number);
     to_serializable(): IHerdModule;
     static from_herd(herd: IHerd, client: SupabaseClient): Promise<HerdModule>;
 }
@@ -41,6 +43,8 @@ export interface IHerdModule {
     sessions: ISessionWithCoordinates[];
     layers: ILayer[];
     providers: IProvider[];
+    artifacts: IArtifactWithMediaUrl[];
+    total_artifacts: number;
 }
 export interface IHerdModulesResponse {
     data: IHerdModule[];

package/dist/types/herd_module.js

@@ -10,6 +10,7 @@ import { EnumWebResponse } from "./requests";
 import { server_get_more_zones_and_actions_for_herd } from "../helpers/zones";
 import { server_list_api_keys_batch } from "../api_keys/actions";
 import { server_get_sessions_by_herd_id } from "../helpers/sessions";
+import { server_get_artifacts_by_herd, server_get_total_artifacts_by_herd, } from "../helpers/artifacts";
 export var EnumHerdModulesLoadingState;
 (function (EnumHerdModulesLoadingState) {
     EnumHerdModulesLoadingState["NOT_LOADING"] = "NOT_LOADING";
@@ -18,11 +19,12 @@ export var EnumHerdModulesLoadingState;
     EnumHerdModulesLoadingState["UNSUCCESSFULLY_LOADED"] = "UNSUCCESSFULLY_LOADED";
 })(EnumHerdModulesLoadingState || (EnumHerdModulesLoadingState = {}));
 export class HerdModule {
-    constructor(herd, devices, events, timestamp_last_refreshed, user_roles = null, events_page_index = 0, total_events = 0, total_events_with_filters = 0, labels = [], plans = [], zones = [], sessions = [], layers = [], providers = []) {
+    constructor(herd, devices, events, timestamp_last_refreshed, user_roles = null, events_page_index = 0, total_events = 0, total_events_with_filters = 0, labels = [], plans = [], zones = [], sessions = [], layers = [], providers = [], artifacts = [], total_artifacts = 0) {
         this.user_roles = null;
         this.events_page_index = 0;
         this.total_events = 0;
         this.total_events_with_filters = 0;
+        this.total_artifacts = 0;
         this.labels = [];
         this.plans = [];
         this.layers = [];
@@ -41,6 +43,8 @@ export class HerdModule {
         this.sessions = sessions;
         this.layers = layers;
         this.providers = providers;
+        this.artifacts = artifacts;
+        this.total_artifacts = total_artifacts;
     }
     to_serializable() {
         return {
@@ -58,6 +62,8 @@ export class HerdModule {
             sessions: this.sessions,
             layers: this.layers,
             providers: this.providers,
+            artifacts: this.artifacts,
+            total_artifacts: this.total_artifacts,
         };
     }
     static async from_herd(herd, client) {
@@ -97,6 +103,14 @@ export class HerdModule {
                     console.warn(`[HerdModule] Failed to get providers:`, error);
                     return { status: EnumWebResponse.ERROR, data: null };
                 }),
+                server_get_artifacts_by_herd(herd.id, 50, 0).catch((error) => {
+                    console.warn(`[HerdModule] Failed to get artifacts:`, error);
+                    return { status: EnumWebResponse.ERROR, data: null };
+                }),
+                server_get_total_artifacts_by_herd(herd.id).catch((error) => {
+                    console.warn(`[HerdModule] Failed to get total artifacts count:`, error);
+                    return { status: EnumWebResponse.ERROR, data: null };
+                }),
             ]);
             // Load devices
             const devicesPromise = get_devices_by_herd(herd.id, client);
@@ -129,7 +143,7 @@ export class HerdModule {
                 }
             }
             // Extract herd-level data with safe fallbacks
-            const [res_zones, res_user_roles, total_event_count, res_plans, res_sessions, res_layers, res_providers,] = herdLevelResults;
+            const [res_zones, res_user_roles, total_event_count, res_plans, res_sessions, res_layers, res_providers, res_artifacts, total_artifact_count,] = herdLevelResults;
             const zones = res_zones.status === "fulfilled" && res_zones.value?.data
                 ? res_zones.value.data
                 : [];
@@ -152,19 +166,26 @@ export class HerdModule {
             const providers = res_providers.status === "fulfilled" && res_providers.value?.data
                 ? res_providers.value.data
                 : [];
+            const artifacts = res_artifacts.status === "fulfilled" && res_artifacts.value?.data
+                ? res_artifacts.value.data
+                : [];
+            const total_artifacts = total_artifact_count.status === "fulfilled" &&
+                total_artifact_count.value?.data
+                ? total_artifact_count.value.data
+                : 0;
             // TODO: store in DB and retrieve on load?
             const newLabels = LABELS;
             const endTime = Date.now();
             const loadTime = endTime - startTime;
             console.log(`[HerdModule] Loaded herd ${herd.slug} in ${loadTime}ms (${new_devices.length} devices)`);
-            return new HerdModule(herd, new_devices, [], Date.now(), user_roles, 0, total_events, total_events, newLabels, plans, zones, sessions, layers, providers);
+            return new HerdModule(herd, new_devices, [], Date.now(), user_roles, 0, total_events, total_events, newLabels, plans, zones, sessions, layers, providers, artifacts, total_artifacts);
         }
         catch (error) {
             const endTime = Date.now();
             const loadTime = endTime - startTime;
             console.error(`[HerdModule] Critical error in HerdModule.from_herd (${loadTime}ms):`, error);
             // Return a minimal but valid HerdModule instance to prevent complete failure
-            return new HerdModule(herd, [], [], Date.now(), null, 0, 0, 0, [], [], [], [], [], []);
+            return new HerdModule(herd, [], [], Date.now(), null, 0, 0, 0, [], [], [], [], [], [], [], 0);
         }
     }
 }

package/dist/types/supabase.d.ts

@@ -1091,6 +1091,74 @@ export type Database = {
                     status: string;
                 }[];
             };
+            get_artifacts_for_device: {
+                Args: {
+                    device_id_caller: number;
+                    limit_caller?: number;
+                    offset_caller?: number;
+                };
+                Returns: {
+                    created_at: string;
+                    device_id: number;
+                    file_path: string;
+                    id: number;
+                    modality: string | null;
+                    session_id: number | null;
+                    timestamp_observation: string | null;
+                    updated_at: string | null;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "artifacts";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
+            get_artifacts_for_devices_batch: {
+                Args: {
+                    device_ids: number[];
+                    limit_per_device?: number;
+                };
+                Returns: {
+                    created_at: string;
+                    device_id: number;
+                    file_path: string;
+                    id: number;
+                    modality: string | null;
+                    session_id: number | null;
+                    timestamp_observation: string | null;
+                    updated_at: string | null;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "artifacts";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
+            get_artifacts_for_herd: {
+                Args: {
+                    herd_id_caller: number;
+                    limit_caller?: number;
+                    offset_caller?: number;
+                };
+                Returns: {
+                    created_at: string;
+                    device_id: number;
+                    file_path: string;
+                    id: number;
+                    modality: string | null;
+                    session_id: number | null;
+                    timestamp_observation: string | null;
+                    updated_at: string | null;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "artifacts";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             get_connectivity_with_coordinates: {
                 Args: {
                     session_id_caller: number;
@@ -1266,6 +1334,12 @@ export type Database = {
                     isSetofReturn: true;
                 };
             };
+            get_total_artifacts_for_herd: {
+                Args: {
+                    herd_id_caller: number;
+                };
+                Returns: number;
+            };
             get_total_events_for_herd_with_session_filter: {
                 Args: {
                     exclude_session_events: boolean;

package/package.json

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