@adventurelabs/scout-core 2.0.18 → 2.1.0

package/dist/store/api.js

@@ -1,8 +1,9 @@
 "use client";
 import { createApi, fakeBaseQuery } from "@reduxjs/toolkit/query/react";
-import { addArtifactMediaUrls, addEventMediaUrls, createSignedUrlMap, } from "../helpers/media_urls";
+import { addArtifactMediaUrls, addEventMediaUrls, addGalleryMediaUrls, createSignedUrlMap, } from "../helpers/media_urls";
 import { collectArtifactStoragePaths, withArtifactMediaUrls, } from "../helpers/artifactMedia";
 import { collectEventStoragePaths, withEventMediaUrls, } from "../helpers/eventMedia";
+import { normalizePageLimit, splitOverFetchedPage } from "../helpers/mediaRows";
 async function signedUrlMapForFeedRows(supabase, rows) {
     return createSignedUrlMap(supabase, rows.flatMap((row) => [
         ...collectEventStoragePaths([row.event_data]),
@@ -11,11 +12,65 @@ async function signedUrlMapForFeedRows(supabase, rows) {
             : []),
     ]));
 }
+/** Cursor for the row a page ends on, shared by the feed and gallery projections. */
+const cursorForRow = (row) => row
+    ? {
+        timestamp: row.sort_ts ?? "",
+        id: row.sort_id ?? 0,
+        feed_type: row.feed_type ?? "",
+    }
+    : null;
+/** Signs a gallery page, over-fetched by one on the same contract as the feed. */
+async function toGalleryResponse(supabase, rows, limit) {
+    const { rows: resultRows, hasMore } = splitOverFetchedPage(rows, limit);
+    const items = await addGalleryMediaUrls(supabase, resultRows);
+    // `last` is absent when limit is 0, which still over-fetches one row and so reports hasMore.
+    const last = resultRows[resultRows.length - 1];
+    return {
+        items,
+        nextCursor: hasMore && last
+            ? cursorForRow({
+                sort_ts: last.sort_ts,
+                sort_id: last.id,
+                feed_type: last.feed_type,
+            })
+            : null,
+        hasMore,
+    };
+}
+/** Signs a feed page; the RPCs return `limit + 1` rows, so an exactly-full page is terminal. */
+async function toFeedResponse(supabase, rows, limit) {
+    const { rows: resultRows, hasMore } = splitOverFetchedPage(rows, limit);
+    let urlMap = new Map();
+    try {
+        urlMap = await signedUrlMapForFeedRows(supabase, resultRows);
+    }
+    catch (urlError) {
+        console.warn("Failed to generate signed URLs for feed:", urlError);
+    }
+    const items = resultRows.map((row) => ({
+        ...row,
+        event_data: row.event_data
+            ? withEventMediaUrls(row.event_data, urlMap)
+            : null,
+        artifact_data: row.artifact_data
+            ? withArtifactMediaUrls(row.artifact_data, urlMap)
+            : null,
+    }));
+    return {
+        items,
+        nextCursor: hasMore
+            ? cursorForRow(resultRows[resultRows.length - 1])
+            : null,
+        hasMore,
+    };
+}
 // Custom serialize function to exclude supabase client
 const serializeQueryArgs = ({ queryArgs, endpointDefinition, endpointName, }) => {
     const { supabase, ...serializableArgs } = queryArgs;
     return JSON.stringify({ endpointName, args: serializableArgs });
 };
+const validEntityId = (id) => Number.isSafeInteger(id) && id > 0;
 // Create the API slice
 export const scoutApi = createApi({
     reducerPath: "scoutApi",
@@ -400,15 +455,19 @@ export const scoutApi = createApi({
         getFeedInfiniteByHerd: builder.query({
             serializeQueryArgs,
             async queryFn({ herdId, limit = 20, cursor, rangeStart, rangeEnd, supabase, }) {
+                const pageLimit = normalizePageLimit(limit);
                 try {
-                    if (!herdId) {
+                    if (!validEntityId(herdId)) {
                         return {
-                            error: { status: "CUSTOM_ERROR", error: "Herd ID is required" },
+                            error: {
+                                status: "CUSTOM_ERROR",
+                                error: "Herd ID must be a positive safe integer",
+                            },
                         };
                     }
                     const { data, error } = await supabase.rpc("get_feed_infinite_by_herd", {
                         herd_id_caller: herdId,
-                        limit_caller: limit + 1,
+                        limit_caller: pageLimit + 1,
                         cursor_timestamp: cursor?.timestamp ?? null,
                         cursor_id: cursor?.id ?? null,
                         cursor_feed_type: cursor?.feed_type ?? null,
@@ -420,60 +479,35 @@ export const scoutApi = createApi({
                             error: { status: "SUPABASE_ERROR", error: error.message },
                         };
                     }
-                    const rows = data || [];
-                    // Full page (rows.length >= limit) means there might be more; only signal hasMore when we have a nextCursor
-                    const hasMore = rows.length >= limit;
-                    const resultRows = hasMore ? rows.slice(0, limit) : rows;
-                    let urlMap = new Map();
-                    try {
-                        urlMap = await signedUrlMapForFeedRows(supabase, resultRows);
-                    }
-                    catch (urlError) {
-                        console.warn("Failed to generate signed URLs for feed:", urlError);
-                    }
-                    const items = resultRows.map((row) => ({
-                        ...row,
-                        event_data: row.event_data
-                            ? withEventMediaUrls(row.event_data, urlMap)
-                            : null,
-                        artifact_data: row.artifact_data
-                            ? withArtifactMediaUrls(row.artifact_data, urlMap)
-                            : null,
-                    }));
-                    const last = resultRows[resultRows.length - 1];
-                    const nextCursor = resultRows.length > 0
-                        ? {
-                            timestamp: last.sort_ts ?? "",
-                            id: last.sort_id ?? 0,
-                            feed_type: last.feed_type ?? "",
-                        }
-                        : null;
                     return {
-                        data: {
-                            items,
-                            nextCursor,
-                            hasMore: nextCursor != null && hasMore,
-                        },
+                        data: await toFeedResponse(supabase, data || [], pageLimit),
                     };
                 }
                 catch (err) {
                     return { error: { status: "FETCH_ERROR", error: String(err) } };
                 }
             },
-            providesTags: () => [{ type: "Event", id: "LIST" }, { type: "Artifact", id: "LIST" }],
+            providesTags: () => [
+                { type: "Event", id: "LIST" },
+                { type: "Artifact", id: "LIST" },
+            ],
         }),
         getFeedInfiniteByDevice: builder.query({
             serializeQueryArgs,
             async queryFn({ deviceId, limit = 20, cursor, rangeStart, rangeEnd, supabase, }) {
+                const pageLimit = normalizePageLimit(limit);
                 try {
-                    if (!deviceId) {
+                    if (!validEntityId(deviceId)) {
                         return {
-                            error: { status: "CUSTOM_ERROR", error: "Device ID is required" },
+                            error: {
+                                status: "CUSTOM_ERROR",
+                                error: "Device ID must be a positive safe integer",
+                            },
                         };
                     }
                     const { data, error } = await supabase.rpc("get_feed_infinite_by_device", {
                         device_id_caller: deviceId,
-                        limit_caller: limit + 1,
+                        limit_caller: pageLimit + 1,
                         cursor_timestamp: cursor?.timestamp ?? null,
                         cursor_id: cursor?.id ?? null,
                         cursor_feed_type: cursor?.feed_type ?? null,
@@ -485,47 +519,101 @@ export const scoutApi = createApi({
                             error: { status: "SUPABASE_ERROR", error: error.message },
                         };
                     }
-                    const rows = data || [];
-                    // Full page (rows.length >= limit) means there might be more; only signal hasMore when we have a nextCursor
-                    const hasMore = rows.length >= limit;
-                    const resultRows = hasMore ? rows.slice(0, limit) : rows;
-                    let urlMap = new Map();
-                    try {
-                        urlMap = await signedUrlMapForFeedRows(supabase, resultRows);
+                    return {
+                        data: await toFeedResponse(supabase, data || [], pageLimit),
+                    };
+                }
+                catch (err) {
+                    return { error: { status: "FETCH_ERROR", error: String(err) } };
+                }
+            },
+            providesTags: () => [
+                { type: "Event", id: "LIST" },
+                { type: "Artifact", id: "LIST" },
+            ],
+        }),
+        // =====================================================
+        // GALLERY INFINITE QUERIES (lean merged events + artifacts)
+        // =====================================================
+        getGalleryInfiniteByHerd: builder.query({
+            serializeQueryArgs,
+            async queryFn({ herdId, limit = 20, cursor, rangeStart, rangeEnd, supabase, }) {
+                const pageLimit = normalizePageLimit(limit);
+                try {
+                    if (!validEntityId(herdId)) {
+                        return {
+                            error: {
+                                status: "CUSTOM_ERROR",
+                                error: "Herd ID must be a positive safe integer",
+                            },
+                        };
+                    }
+                    const { data, error } = await supabase.rpc("get_gallery_infinite_by_herd", {
+                        herd_id_caller: herdId,
+                        limit_caller: pageLimit + 1,
+                        cursor_timestamp: cursor?.timestamp ?? null,
+                        cursor_id: cursor?.id ?? null,
+                        cursor_feed_type: cursor?.feed_type ?? null,
+                        range_start: rangeStart ?? null,
+                        range_end: rangeEnd ?? null,
+                    });
+                    if (error) {
+                        return {
+                            error: { status: "SUPABASE_ERROR", error: error.message },
+                        };
                     }
-                    catch (urlError) {
-                        console.warn("Failed to generate signed URLs for feed:", urlError);
-                    }
-                    const items = resultRows.map((row) => ({
-                        ...row,
-                        event_data: row.event_data
-                            ? withEventMediaUrls(row.event_data, urlMap)
-                            : null,
-                        artifact_data: row.artifact_data
-                            ? withArtifactMediaUrls(row.artifact_data, urlMap)
-                            : null,
-                    }));
-                    const last = resultRows[resultRows.length - 1];
-                    const nextCursor = resultRows.length > 0
-                        ? {
-                            timestamp: last.sort_ts ?? "",
-                            id: last.sort_id ?? 0,
-                            feed_type: last.feed_type ?? "",
-                        }
-                        : null;
                     return {
-                        data: {
-                            items,
-                            nextCursor,
-                            hasMore: nextCursor != null && hasMore,
-                        },
+                        data: await toGalleryResponse(supabase, data || [], pageLimit),
+                    };
+                }
+                catch (err) {
+                    return { error: { status: "FETCH_ERROR", error: String(err) } };
+                }
+            },
+            providesTags: () => [
+                { type: "Event", id: "LIST" },
+                { type: "Artifact", id: "LIST" },
+            ],
+        }),
+        getGalleryInfiniteByDevice: builder.query({
+            serializeQueryArgs,
+            async queryFn({ deviceId, limit = 20, cursor, rangeStart, rangeEnd, supabase, }) {
+                const pageLimit = normalizePageLimit(limit);
+                try {
+                    if (!validEntityId(deviceId)) {
+                        return {
+                            error: {
+                                status: "CUSTOM_ERROR",
+                                error: "Device ID must be a positive safe integer",
+                            },
+                        };
+                    }
+                    const { data, error } = await supabase.rpc("get_gallery_infinite_by_device", {
+                        device_id_caller: deviceId,
+                        limit_caller: pageLimit + 1,
+                        cursor_timestamp: cursor?.timestamp ?? null,
+                        cursor_id: cursor?.id ?? null,
+                        cursor_feed_type: cursor?.feed_type ?? null,
+                        range_start: rangeStart ?? null,
+                        range_end: rangeEnd ?? null,
+                    });
+                    if (error) {
+                        return {
+                            error: { status: "SUPABASE_ERROR", error: error.message },
+                        };
+                    }
+                    return {
+                        data: await toGalleryResponse(supabase, data || [], pageLimit),
                     };
                 }
                 catch (err) {
                     return { error: { status: "FETCH_ERROR", error: String(err) } };
                 }
             },
-            providesTags: () => [{ type: "Event", id: "LIST" }, { type: "Artifact", id: "LIST" }],
+            providesTags: () => [
+                { type: "Event", id: "LIST" },
+                { type: "Artifact", id: "LIST" },
+            ],
         }),
         // =====================================================
         // ANALYSIS JOBS / TASKS INFINITE (platform superadmin RLS)
@@ -634,4 +722,4 @@ export const scoutApi = createApi({
     }),
 });
 // Export hooks for usage in functional components
-export const { useGetSessionsInfiniteByHerdQuery, useGetSessionsInfiniteByDeviceQuery, useGetEventsInfiniteByHerdQuery, useGetEventsInfiniteByDeviceQuery, useGetArtifactsInfiniteByHerdQuery, useGetArtifactsInfiniteByDeviceQuery, useGetFeedInfiniteByHerdQuery, useGetFeedInfiniteByDeviceQuery, useGetAnalysisJobsInfiniteQuery, useGetAnalysisTasksInfiniteQuery, } = scoutApi;
+export const { useGetSessionsInfiniteByHerdQuery, useGetSessionsInfiniteByDeviceQuery, useGetEventsInfiniteByHerdQuery, useGetEventsInfiniteByDeviceQuery, useGetArtifactsInfiniteByHerdQuery, useGetArtifactsInfiniteByDeviceQuery, useGetFeedInfiniteByHerdQuery, useGetFeedInfiniteByDeviceQuery, useGetGalleryInfiniteByHerdQuery, useGetGalleryInfiniteByDeviceQuery, useGetAnalysisJobsInfiniteQuery, useGetAnalysisTasksInfiniteQuery, } = scoutApi;

package/dist/store/configureStore.d.ts

@@ -21,6 +21,8 @@ export declare const configureScoutStore: () => import("@reduxjs/toolkit").Enhan
         }, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").ArtifactsInfiniteResponse, "scoutApi", unknown>;
         getFeedInfiniteByHerd: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").FeedInfiniteByHerdQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").FeedInfiniteResponse, "scoutApi", unknown>;
         getFeedInfiniteByDevice: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").FeedInfiniteByDeviceQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").FeedInfiniteResponse, "scoutApi", unknown>;
+        getGalleryInfiniteByHerd: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").GalleryInfiniteByHerdQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").GalleryInfiniteResponse, "scoutApi", unknown>;
+        getGalleryInfiniteByDevice: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").GalleryInfiniteByDeviceQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").GalleryInfiniteResponse, "scoutApi", unknown>;
         getAnalysisJobsInfinite: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").AnalysisJobsInfiniteQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").AnalysisJobsInfiniteResponse, "scoutApi", unknown>;
         getAnalysisTasksInfinite: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").AnalysisTasksInfiniteQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").AnalysisTasksInfiniteResponse, "scoutApi", unknown>;
     }, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", "scoutApi">;
@@ -48,6 +50,8 @@ export declare const configureScoutStore: () => import("@reduxjs/toolkit").Enhan
             }, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").ArtifactsInfiniteResponse, "scoutApi", unknown>;
             getFeedInfiniteByHerd: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").FeedInfiniteByHerdQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").FeedInfiniteResponse, "scoutApi", unknown>;
             getFeedInfiniteByDevice: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").FeedInfiniteByDeviceQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").FeedInfiniteResponse, "scoutApi", unknown>;
+            getGalleryInfiniteByHerd: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").GalleryInfiniteByHerdQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").GalleryInfiniteResponse, "scoutApi", unknown>;
+            getGalleryInfiniteByDevice: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").GalleryInfiniteByDeviceQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").GalleryInfiniteResponse, "scoutApi", unknown>;
             getAnalysisJobsInfinite: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").AnalysisJobsInfiniteQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").AnalysisJobsInfiniteResponse, "scoutApi", unknown>;
             getAnalysisTasksInfinite: import("@reduxjs/toolkit/query").QueryDefinition<import("./api").AnalysisTasksInfiniteQueryArgs, import("@reduxjs/toolkit/query").BaseQueryFn<any, unknown, unknown, {}, {}>, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", import("./api").AnalysisTasksInfiniteResponse, "scoutApi", unknown>;
         }, "Session" | "Event" | "Artifact" | "AnalysisJob" | "AnalysisTask", "scoutApi">;

package/dist/store/hooks.d.ts

@@ -1,5 +1,5 @@
 import { LoadingPerformance } from "./scout";
-import { ISessionSummary } from "../types/db";
+import { IDevice, IPart, IProduct, IProductCatalog, ISessionSummary } from "../types/db";
 export declare const useAppDispatch: import("react-redux").UseDispatch<import("redux").Dispatch<import("redux").UnknownAction>>;
 export declare const useHerdModulesLoadingState: () => any;
 export declare const useIsHerdModulesLoading: () => boolean;
@@ -10,4 +10,7 @@ export declare const useHerdModulesLoadingDuration: () => any;
 export declare const useLoadingPerformance: () => LoadingPerformance;
 export declare const useSessionSummariesByHerd: (herdId: number) => ISessionSummary | null;
 export declare const useHasSessionSummaries: (herdId: number) => boolean;
+export declare const useProductCatalog: () => IProductCatalog;
+export declare const useProductForPart: (part: Pick<IPart, "product_number"> | null | undefined) => IProduct | null;
+export declare const useProductsForDevice: (device: Pick<IDevice, "parts"> | null | undefined) => IProduct[];
 export declare const useHerdModulesLoadingTimeAgo: () => string | null;

package/dist/store/hooks.js

@@ -1,6 +1,8 @@
 "use client";
+import { useMemo } from "react";
 import { useDispatch, useSelector } from "react-redux";
 import { EnumHerdModulesLoadingState } from "../types/herd_module";
+import { EMPTY_PRODUCT_CATALOG, get_product_for_part, get_products_for_device, } from "../helpers/product_catalog";
 // Simple wrapper for useDispatch to maintain compatibility
 export const useAppDispatch = useDispatch;
 // Selector hook for herd modules loading state
@@ -50,6 +52,20 @@ export const useHasSessionSummaries = (herdId) => {
         return !!herdModule?.session_summaries;
     });
 };
+// Selector hook for the shared product catalog referenced by device parts
+export const useProductCatalog = () => {
+    return useSelector((state) => state.scout.product_catalog ?? EMPTY_PRODUCT_CATALOG);
+};
+// Selector hook for the product a part references
+export const useProductForPart = (part) => {
+    const catalog = useProductCatalog();
+    return useMemo(() => get_product_for_part(catalog, part), [catalog, part]);
+};
+// Selector hook for the distinct products across a device's parts
+export const useProductsForDevice = (device) => {
+    const catalog = useProductCatalog();
+    return useMemo(() => get_products_for_device(catalog, device), [catalog, device]);
+};
 // Selector hook for getting formatted loading time (e.g., "2.5s ago")
 export const useHerdModulesLoadingTimeAgo = () => {
     return useSelector((state) => {

package/dist/store/scout.d.ts

@@ -1,4 +1,4 @@
-import { IUser } from "../types/db";
+import { IProductCatalog, IUser } from "../types/db";
 import { IHerdModule, EnumHerdModulesLoadingState } from "../types/herd_module";
 import { EnumDataSource, IDataSourceInfo } from "../types/data_source";
 import { MapDeviceIdToConnectivity } from "../types/connectivity";
@@ -16,6 +16,8 @@ export interface LoadingPerformance {
 }
 export interface ScoutState {
     herd_modules: IHerdModule[];
+    /** One shared copy of every product referenced by device parts. */
+    product_catalog: IProductCatalog;
     herd_modules_content_hash: string | null;
     status: EnumScoutStateStatus;
     herd_modules_loading_state: EnumHerdModulesLoadingState;
@@ -31,5 +33,5 @@ export interface ScoutState {
 export interface RootState {
     scout: ScoutState;
 }
-export declare const resetScoutState: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"scout/resetScoutState">, setHerdModules: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModules">, setStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setStatus">, setHerdModulesLoadingState: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadingState">, setLoadingPerformance: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setLoadingPerformance">, 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">, updateSessionSummariesForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateSessionSummariesForHerdModule">, appendPlansToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendPlansToHerdModule">, setUser: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUser">, 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">, setActiveHerdGpsTrackersConnectivity: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdGpsTrackersConnectivity">;
+export declare const resetScoutState: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"scout/resetScoutState">, setHerdModules: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModules">, mergeProductCatalog: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/mergeProductCatalog">, setStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setStatus">, setHerdModulesLoadingState: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setHerdModulesLoadingState">, setLoadingPerformance: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setLoadingPerformance">, 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">, updateSessionSummariesForHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/updateSessionSummariesForHerdModule">, appendPlansToHerdModule: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/appendPlansToHerdModule">, setUser: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setUser">, 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">, setActiveHerdGpsTrackersConnectivity: import("@reduxjs/toolkit").ActionCreatorWithPayload<any, "scout/setActiveHerdGpsTrackersConnectivity">;
 export declare const scoutReducer: import("redux").Reducer<ScoutState>;

package/dist/store/scout.js

@@ -1,7 +1,9 @@
 import { createSlice, current } from "@reduxjs/toolkit";
+import { dequal } from "dequal";
 import { EnumHerdModulesLoadingState } from "../types/herd_module";
 import { EnumDataSource } from "../types/data_source";
 import { herdModulesSemanticallyEqual } from "../helpers/herd_modules_equal";
+import { EMPTY_PRODUCT_CATALOG } from "../helpers/product_catalog";
 export var EnumScoutStateStatus;
 (function (EnumScoutStateStatus) {
     EnumScoutStateStatus["LOADING"] = "LOADING";
@@ -9,6 +11,7 @@ export var EnumScoutStateStatus;
 })(EnumScoutStateStatus || (EnumScoutStateStatus = {}));
 const initialState = {
     herd_modules: [],
+    product_catalog: EMPTY_PRODUCT_CATALOG,
     herd_modules_content_hash: null,
     status: EnumScoutStateStatus.LOADING,
     herd_modules_loading_state: EnumHerdModulesLoadingState.NOT_LOADING,
@@ -41,6 +44,10 @@ const scoutSlice = createSlice({
             const contentHash = Array.isArray(payload)
                 ? null
                 : payload.contentHash ?? null;
+            const productCatalog = Array.isArray(payload)
+                ? current(state.product_catalog)
+                : payload.productCatalog ??
+                    current(state.product_catalog);
             if (state.active_herd_id &&
                 !modules.some((module) => module.herd.id?.toString() === state.active_herd_id)) {
                 state.active_herd_id = null;
@@ -52,13 +59,25 @@ const scoutSlice = createSlice({
                     return;
                 }
             }
-            else if (herdModulesSemanticallyEqual(current(state.herd_modules), modules)) {
+            else if (herdModulesSemanticallyEqual(current(state.herd_modules), modules) &&
+                dequal(current(state.product_catalog), productCatalog)) {
                 return;
             }
             state.herd_modules = modules;
+            state.product_catalog = productCatalog;
             state.herd_modules_content_hash = contentHash;
             state.lastRefreshed = Date.now();
         },
+        /**
+         * Merges products (built with `build_product_catalog`) into the shared
+         * catalog, for parts that arrive after the initial load.
+         */
+        mergeProductCatalog: (state, action) => {
+            const incoming = action.payload;
+            Object.assign(state.product_catalog.products, incoming.products);
+            Object.assign(state.product_catalog.product_id_by_number, incoming.product_id_by_number);
+            state.herd_modules_content_hash = null;
+        },
         setStatus: (state, action) => {
             state.status = action.payload;
         },
@@ -211,5 +230,5 @@ const scoutSlice = createSlice({
         },
     },
 });
-export const { resetScoutState, setHerdModules, setStatus, setHerdModulesLoadingState, setLoadingPerformance, setHerdModulesLoadedInMs, setHerdModulesApiServerProcessingDuration, setHerdModulesApiTotalRequestDuration, setUserApiDuration, setDataProcessingDuration, setCacheLoadDuration, setActiveHerdId, setActiveDeviceId, setDataSource, setDataSourceInfo, updateSessionSummariesForHerdModule, appendPlansToHerdModule, setUser, addNewDeviceToHerdModule, updateDeviceForHerdModule, addDevice, deleteDevice, updateDevice, addPlan, deletePlan, updatePlan, setActiveHerdGpsTrackersConnectivity, } = scoutSlice.actions;
+export const { resetScoutState, setHerdModules, mergeProductCatalog, setStatus, setHerdModulesLoadingState, setLoadingPerformance, setHerdModulesLoadedInMs, setHerdModulesApiServerProcessingDuration, setHerdModulesApiTotalRequestDuration, setUserApiDuration, setDataProcessingDuration, setCacheLoadDuration, setActiveHerdId, setActiveDeviceId, setDataSource, setDataSourceInfo, updateSessionSummariesForHerdModule, appendPlansToHerdModule, setUser, addNewDeviceToHerdModule, updateDeviceForHerdModule, addDevice, deleteDevice, updateDevice, addPlan, deletePlan, updatePlan, setActiveHerdGpsTrackersConnectivity, } = scoutSlice.actions;
 export const scoutReducer = scoutSlice.reducer;

package/dist/types/db.d.ts

@@ -14,7 +14,7 @@ export type IUserProfileRow = Database["public"]["Tables"]["users"]["Row"];
 export type IDeviceRow = Database["public"]["Tables"]["devices"]["Row"];
 export type IDevice = Database["public"]["CompositeTypes"]["device_pretty_location"] & {
     api_keys_scout?: IApiKeyScout[];
-    parts?: IPartWithProduct[];
+    parts?: IPart[];
 };
 export type IPin = Database["public"]["CompositeTypes"]["pins_pretty_location"];
 export type IEvent = Database["public"]["Tables"]["events"]["Row"];
@@ -198,10 +198,14 @@ export type OperatingContextContactCreateInput = Pick<OperatingContextContactIns
 export type OperatingContextContactUpdateInput = Partial<Pick<OperatingContextContactCreateInput, "contact_id">> & LifecyclePatch;
 export type HerdOperatingPermissionCreateInput = Pick<HerdOperatingPermissionInsert, "herd_id" | "operating_permission_id">;
 export type HerdOperatingPermissionUpdateInput = Partial<Pick<HerdOperatingPermissionCreateInput, "operating_permission_id">> & LifecyclePatch;
-/** A part with its resolved product (parts.product_number -> product_numbers -> products). */
-export type IPartWithProduct = IPart & {
-    product?: IProduct | null;
-};
+/**
+ * Products stored once and shared by every part that references them
+ * (parts.product_number -> product_numbers -> products).
+ */
+export interface IProductCatalog {
+    products: Record<number, IProduct>;
+    product_id_by_number: Record<string, number>;
+}
 export type IUserCredential = Database["public"]["Tables"]["user_credentials"]["Row"];
 export type IUserLastActivity = Database["public"]["Tables"]["user_last_activity"]["Row"];
 export type IHerdCredential = Database["public"]["Tables"]["herd_credentials"]["Row"];
@@ -222,6 +226,10 @@ export type ISignedMediaUrls = {
     thumbnail_url?: string | null;
     proxy_url?: string | null;
 };
+/** What a row holds, resolved from its file extension first and its stored media_type/modality second. */
+export type MediaKind = MediaType | "unknown";
+/** Availability of the media a view shows; `url_unavailable` means it exists but went unsigned. */
+export type MediaStatus = "ready" | "processing" | "blocked" | "url_unavailable";
 export type IArtifactWithMediaUrl = IArtifact & ISignedMediaUrls;
 export type IEventWithMediaUrl = IEvent & ISignedMediaUrls;
 export type IVersionsSoftwareWithBuildUrl = IVersionsSoftware & {
@@ -370,6 +378,12 @@ export type IFeedItem = {
     event_data: (IEventAndTagsPrettyLocation & ISignedMediaUrls) | null;
     artifact_data: IArtifactWithMediaUrl | null;
 };
+/** Lean merged events/artifacts row: media paths and a tag count, not `feed_item`'s arrays. */
+export type IGalleryItemRow = Database["public"]["CompositeTypes"]["gallery_item"];
+export type IGalleryItem = IGalleryItemRow & ISignedMediaUrls & {
+    media_kind: MediaKind;
+    media_status: MediaStatus;
+};
 export type ISessionWithCoordinates = Database["public"]["CompositeTypes"]["session_with_coordinates"];
 export type IConnectivityWithCoordinates = Database["public"]["CompositeTypes"]["connectivity_with_coordinates"];
 export type IEmbeddingSearchResult = Database["public"]["CompositeTypes"]["embedding_search_result"];

package/dist/types/herd_module.d.ts

@@ -1,4 +1,4 @@
-import { IDevice, IHerdPrettyLocation, IPlan, ILayer, IProvider, IUserAndRole, IZoneWithActions, ISessionSummary, ISessionUsageOverTime } from "../types/db";
+import { IDevice, IHerdPrettyLocation, IPlan, ILayer, IProductCatalog, IProvider, IUserAndRole, IZoneWithActions, ISessionSummary, ISessionUsageOverTime } from "../types/db";
 import { EnumWebResponse } from "./requests";
 export declare enum EnumHerdModulesLoadingState {
     NOT_LOADING = "NOT_LOADING",
@@ -19,8 +19,18 @@ export interface IHerdModule {
     session_summaries: ISessionSummary | null;
     session_usage: ISessionUsageOverTime | null;
 }
+/**
+ * Herd modules plus the single shared copy of every product their parts
+ * reference. Devices hold bare parts; resolve products with the
+ * `get_product_for_*` helpers instead of storing them per device.
+ */
+export interface IHerdModulesSnapshot {
+    herd_modules: IHerdModule[];
+    product_catalog: IProductCatalog;
+}
 export interface IHerdModulesResponse {
     data: IHerdModule[];
+    product_catalog: IProductCatalog;
     time_finished: number;
     server_processing_time_ms: number;
     content_hash: string;
@@ -29,6 +39,7 @@ export interface IHerdModulesResponseWithStatus {
     status: EnumWebResponse;
     msg: string;
     data: IHerdModule[] | null;
+    product_catalog: IProductCatalog;
     time_finished: number;
     time_sent: number;
     server_processing_time_ms: number;