@adventurelabs/scout-core 2.0.15 → 2.0.17

package/dist/client/index.d.ts

@@ -3,6 +3,7 @@ export * from "../types";
 export * from "../helpers/artifactMedia";
 export * from "../helpers/bounding_boxes";
 export * from "../helpers/email";
+export * from "../helpers/eventMedia";
 export * from "../helpers/eventUtils";
 export { default as get_gps_center } from "../helpers/gps";
 export * from "../helpers/herd_modules_equal";

package/dist/client/index.js

@@ -6,6 +6,7 @@ export * from "../types";
 export * from "../helpers/artifactMedia";
 export * from "../helpers/bounding_boxes";
 export * from "../helpers/email";
+export * from "../helpers/eventMedia";
 export * from "../helpers/eventUtils";
 export { default as get_gps_center } from "../helpers/gps";
 export * from "../helpers/herd_modules_equal";

package/dist/helpers/artifactMedia.js

@@ -1,4 +1,4 @@
-import { isNonEmptyStorageFilePath } from "./storagePath";
+import { isNonEmptyStorageFilePath, signedUrlForPath } from "./storagePath";
 /** Collect unique non-empty storage paths used for artifact media signing. */
 export function collectArtifactStoragePaths(artifacts) {
     const seen = new Set();
@@ -17,9 +17,6 @@ export function collectArtifactStoragePaths(artifacts) {
     }
     return paths;
 }
-function signedUrlForPath(path, urlMap) {
-    return isNonEmptyStorageFilePath(path) ? urlMap.get(path) ?? null : null;
-}
 /** Attach signed URLs for original, thumbnail, and proxy storage paths. */
 export function withArtifactMediaUrls(artifact, urlMap) {
     return {

package/dist/helpers/eventMedia.d.ts

@@ -0,0 +1,12 @@
+import { ISignedMediaUrls } from "../types/db";
+/** Events arrive as table rows and as the event_and_tags composite, so match on shape. */
+export type IEventMediaPaths = {
+    file_path?: string | null;
+    thumbnail_file_path?: string | null;
+    proxy_file_path?: string | null;
+    media_url?: string | null;
+};
+/** Collect unique non-empty storage paths used for event media signing. */
+export declare function collectEventStoragePaths(events: Iterable<IEventMediaPaths | null | undefined>): string[];
+/** Attach signed URLs for original, thumbnail, and proxy storage paths. */
+export declare function withEventMediaUrls<T extends IEventMediaPaths>(event: T, urlMap: Map<string, string | null | undefined>): T & ISignedMediaUrls;

package/dist/helpers/eventMedia.js

@@ -0,0 +1,29 @@
+import { isNonEmptyStorageFilePath, signedUrlForPath } from "./storagePath";
+/** Collect unique non-empty storage paths used for event media signing. */
+export function collectEventStoragePaths(events) {
+    const seen = new Set();
+    const paths = [];
+    for (const event of events) {
+        for (const path of [
+            event?.file_path,
+            event?.thumbnail_file_path,
+            event?.proxy_file_path,
+        ]) {
+            if (isNonEmptyStorageFilePath(path) && !seen.has(path)) {
+                seen.add(path);
+                paths.push(path);
+            }
+        }
+    }
+    return paths;
+}
+/** Attach signed URLs for original, thumbnail, and proxy storage paths. */
+export function withEventMediaUrls(event, urlMap) {
+    return {
+        ...event,
+        // Events predating file_path carry an absolute media_url with nothing to sign.
+        media_url: signedUrlForPath(event.file_path, urlMap) ?? event.media_url ?? null,
+        thumbnail_url: signedUrlForPath(event.thumbnail_file_path, urlMap),
+        proxy_url: signedUrlForPath(event.proxy_file_path, urlMap),
+    };
+}

package/dist/helpers/lifecycle_server.d.ts

@@ -103,12 +103,16 @@ export declare function server_update_event_lifecycle(event_id: number, lifecycl
     origin_roll: number | null;
     processing_blocked_at: string | null;
     processing_blocked_reason: string | null;
+    proxy_file_path: string | null;
+    proxy_generated_at: string | null;
     segmented_at: string | null;
     sensor_pitch: number | null;
     sensor_roll: number | null;
     sensor_yaw: number | null;
     session_id: number | null;
     tagged_at: string | null;
+    thumbnail_file_path: string | null;
+    thumbnail_generated_at: string | null;
     timestamp_observation: string;
     tracked_at: string | null;
 } | null>>;

package/dist/helpers/media_urls.d.ts

@@ -1,13 +1,7 @@
 import type { SupabaseClient } from "@supabase/supabase-js";
-import type { IArtifact, IArtifactWithMediaUrl } from "../types/db";
+import type { IArtifact, IArtifactWithMediaUrl, ISignedMediaUrls } from "../types/db";
 import type { Database } from "../types/supabase";
-type EventWithStoragePath = {
-    file_path?: string | null;
-    media_url?: string | null;
-};
+import { type IEventMediaPaths } from "./eventMedia";
 export declare function createSignedUrlMap(client: SupabaseClient<Database>, paths: Iterable<string | null | undefined>): Promise<Map<string, string | null>>;
-export declare function addEventMediaUrls<T extends EventWithStoragePath>(client: SupabaseClient<Database>, events: T[]): Promise<Array<T & {
-    media_url: string | null;
-}>>;
+export declare function addEventMediaUrls<T extends IEventMediaPaths>(client: SupabaseClient<Database>, events: T[]): Promise<Array<T & ISignedMediaUrls>>;
 export declare function addArtifactMediaUrls(client: SupabaseClient<Database>, artifacts: IArtifact[]): Promise<IArtifactWithMediaUrl[]>;
-export {};

package/dist/helpers/media_urls.js

@@ -1,4 +1,5 @@
 import { collectArtifactStoragePaths, withArtifactMediaUrls, } from "./artifactMedia";
+import { collectEventStoragePaths, withEventMediaUrls, } from "./eventMedia";
 import { generateSignedUrlsBatchWithClient } from "./storage_internal";
 import { isNonEmptyStorageFilePath } from "./storagePath";
 export async function createSignedUrlMap(client, paths) {
@@ -7,13 +8,8 @@ export async function createSignedUrlMap(client, paths) {
     return new Map(uniquePaths.map((path, index) => [path, urls[index]]));
 }
 export async function addEventMediaUrls(client, events) {
-    const urlMap = await createSignedUrlMap(client, events.map((event) => event.file_path));
-    return events.map((event) => ({
-        ...event,
-        media_url: isNonEmptyStorageFilePath(event.file_path)
-            ? urlMap.get(event.file_path) ?? event.media_url ?? null
-            : event.media_url ?? null,
-    }));
+    const urlMap = await createSignedUrlMap(client, collectEventStoragePaths(events));
+    return events.map((event) => withEventMediaUrls(event, urlMap));
 }
 export async function addArtifactMediaUrls(client, artifacts) {
     const urlMap = await createSignedUrlMap(client, collectArtifactStoragePaths(artifacts));

package/dist/helpers/storagePath.d.ts

@@ -1,5 +1,7 @@
 /** True when we can sign storage: non-null and not blank after trim. */
 export declare function isNonEmptyStorageFilePath(path: string | null | undefined): path is string;
+/** Signed URL for a storage path, or null when the path is blank or went unsigned. */
+export declare function signedUrlForPath(path: string | null | undefined, urlMap: Map<string, string | null | undefined>): string | null;
 /** Assumes DB `file_path` is always `bucket/object/...` */
 export declare function parseStorageFilePath(filePath: string): {
     bucket: string;

package/dist/helpers/storagePath.js

@@ -2,6 +2,10 @@
 export function isNonEmptyStorageFilePath(path) {
     return path != null && path.trim() !== "";
 }
+/** Signed URL for a storage path, or null when the path is blank or went unsigned. */
+export function signedUrlForPath(path, urlMap) {
+    return isNonEmptyStorageFilePath(path) ? urlMap.get(path) ?? null : null;
+}
 /** Assumes DB `file_path` is always `bucket/object/...` */
 export function parseStorageFilePath(filePath) {
     const cleaned = filePath.trim().replace(/^\/+|\/+$/g, "");

package/dist/helpers/tags.queries.js

@@ -340,6 +340,10 @@ export async function get_event_and_tags_by_event_id_query(client, event_id) {
         embedded_at: data[0].embedded_at ?? null,
         segmented_at: data[0].segmented_at ?? null,
         tagged_at: data[0].tagged_at ?? null,
+        thumbnail_file_path: data[0].thumbnail_file_path ?? null,
+        thumbnail_generated_at: data[0].thumbnail_generated_at ?? null,
+        proxy_file_path: data[0].proxy_file_path ?? null,
+        proxy_generated_at: data[0].proxy_generated_at ?? null,
     };
     const [eventWithUrl] = await addEventMediaUrls(client, [transformedData]);
     return IWebResponse.success(eventWithUrl).to_compatible();

package/dist/hooks/useInfiniteQuery.d.ts

@@ -18,10 +18,11 @@ export interface InfiniteRefetchOptions {
 }
 export interface InfiniteScrollData<T> {
     items: T[];
-    /** True only for the initial load, when no pages are held yet. */
+    /** True while a request is in flight and no pages are held: initial load, or a reset. */
     isLoading: boolean;
     /** True while a `refetch` is in flight, including a preserve-pages refresh. */
     isRefreshing: boolean;
+    /** True while a later page is being fetched, with earlier pages already shown. */
     isLoadingMore: boolean;
     hasMore: boolean;
     loadMore: () => void;

package/dist/hooks/useInfiniteQuery.js

@@ -51,26 +51,26 @@ function sameCursor(left, right) {
 }
 const rowId = (row) => row.id;
 const feedRowKey = (row) => `${row.sort_ts ?? ""}_${row.sort_id ?? ""}_${row.feed_type ?? ""}`;
-/**
- * Holds the cursor of the page the live query should request.
- *
- * State is tagged with `key`, and state carrying a stale key reads as null, so a new entity
- * is never requested with the previous entity's cursor.
- */
-function useCursor(key) {
-    const [stored, setStored] = useState(() => ({ key, cursor: null }));
-    const setCursor = useCallback((cursor) => setStored({ key, cursor }), [key]);
-    return {
-        key,
-        cursor: stored.key === key ? stored.cursor : null,
-        setCursor,
-    };
-}
-const noPages = (key) => ({
+const emptyPaging = (key) => ({
     key,
+    cursor: null,
     pages: [],
     refreshQueue: null,
 });
+/**
+ * Holds the paging state for `key`, read by the query args and by the engine.
+ *
+ * State carrying a stale key reads as empty, so a new entity starts from its first page in
+ * the same render rather than waiting for an effect to clear the previous one.
+ */
+function usePaging(key) {
+    const [stored, setStored] = useState(() => emptyPaging(key));
+    // Memoized so the empty fallback keeps a stable identity: `items` is derived from
+    // `state.pages`, and a fresh array each render would churn consumer dependencies.
+    const state = useMemo(() => (stored.key === key ? stored : emptyPaging(key)), [key, stored]);
+    const update = useCallback((change) => setStored((previous) => change(previous.key === key ? previous : emptyPaging(key))), [key]);
+    return { cursor: state.cursor, state, update };
+}
 function upsertPage(state, page, rowKey) {
     const index = state.pages.findIndex((loaded) => sameCursor(loaded.cursor, page.cursor));
     if (index === -1) {
@@ -97,27 +97,33 @@ const dropRefreshedCursor = (state) => {
 /**
  * Accumulates cursor-paginated responses into a list.
  *
- * A single query subscription serves every page: the cursor handle decides which page is
- * being requested, and each response is upserted into `pages` under that cursor. A
+ * A single query subscription serves every page: the paging state's cursor decides which
+ * page is being requested, and each response is upserted into `pages` under that cursor. A
  * preserve-pages refresh walks the cursor back through the loaded pages one at a time,
- * replacing each in place. Pages are tagged with the handle's key, so changing entity or
- * filters empties the list and abandons any refresh in the same render.
+ * replacing each in place. Changing entity or filters changes the paging key, which empties
+ * the list and abandons any refresh in the same render.
  */
-function useInfinitePages({ key, cursor, setCursor }, query, mapping) {
-    const [stored, setStored] = useState(() => noPages(key));
+function useInfinitePages({ cursor, state, update }, query, mapping) {
     const latest = useRef({ query, mapping });
     latest.current = { query, mapping };
-    const state = stored.key === key ? stored : noPages(key);
-    const update = useCallback((change) => {
-        setStored((previous) => change(previous.key === key ? previous : noPages(key)));
-    }, [key]);
-    const { data, isLoading } = query;
-    const page = useMemo(() => (data === undefined ? undefined : latest.current.mapping.toPage(data)), [data]);
+    const setCursor = useCallback((next) => update((previous) => sameCursor(previous.cursor, next)
+        ? previous
+        : { ...previous, cursor: next }), [update]);
+    /**
+     * Re-requests the page the query currently points at. RTK's `refetch` throws
+     * synchronously when the query is skipped, so callers see a rejection instead of a fault
+     * at the call site.
+     */
+    const requestPage = useCallback(async () => latest.current.query.refetch().unwrap(), []);
+    const { currentData, isFetching } = query;
+    const page = useMemo(() => currentData === undefined
+        ? undefined
+        : latest.current.mapping.toPage(currentData), [currentData]);
     useEffect(() => {
-        if (!page || isLoading)
+        if (!page)
             return;
         update((previous) => upsertPage(previous, { ...page, cursor }, latest.current.mapping.rowKey));
-    }, [cursor, isLoading, page, update]);
+    }, [cursor, page, update]);
     useEffect(() => {
         const queue = state.refreshQueue;
         if (!queue)
@@ -128,29 +134,31 @@ function useInfinitePages({ key, cursor, setCursor }, query, mapping) {
             return;
         }
         let cancelled = false;
-        void latest.current.query
-            .refetch()
-            .unwrap()
-            .then((response) => {
-            if (cancelled)
-                return;
-            const { mapping } = latest.current;
-            const refreshed = mapping.toPage(response);
-            update((previous) => 
-            // Only apply while this cursor is still the one being refreshed.
-            previous.refreshQueue &&
-                sameCursor(previous.refreshQueue[0], refreshing)
-                ? dropRefreshedCursor(upsertPage(previous, { ...refreshed, cursor: refreshing }, mapping.rowKey))
-                : previous);
-        })
-            .catch(() => {
-            if (!cancelled)
-                update(dropRefreshedCursor);
-        });
+        // A refresh that cannot run drops its cursor and moves on, so a rejection never leaves
+        // the queue stuck.
+        void (async () => {
+            try {
+                const response = await requestPage();
+                if (cancelled)
+                    return;
+                const { mapping } = latest.current;
+                const refreshed = mapping.toPage(response);
+                update((previous) => 
+                // Only apply while this cursor is still the one being refreshed.
+                previous.refreshQueue &&
+                    sameCursor(previous.refreshQueue[0], refreshing)
+                    ? dropRefreshedCursor(upsertPage(previous, { ...refreshed, cursor: refreshing }, mapping.rowKey))
+                    : previous);
+            }
+            catch {
+                if (!cancelled)
+                    update(dropRefreshedCursor);
+            }
+        })();
         return () => {
             cancelled = true;
         };
-    }, [cursor, setCursor, state.refreshQueue, update]);
+    }, [cursor, requestPage, setCursor, state.refreshQueue, update]);
     /** Both modes queue the cursors to re-request, so a refetch always reaches the network. */
     const refetch = useCallback((options) => {
         update((previous) => options?.preservePages && previous.pages.length > 0
@@ -158,17 +166,32 @@ function useInfinitePages({ key, cursor, setCursor }, query, mapping) {
                 ...previous,
                 refreshQueue: previous.pages.map((loaded) => loaded.cursor),
             }
-            : { ...noPages(key), refreshQueue: [null] });
-    }, [key, update]);
+            : { ...emptyPaging(previous.key), refreshQueue: [null] });
+    }, [update]);
     const lastPage = state.pages[state.pages.length - 1];
     const nextCursor = lastPage?.nextCursor ?? null;
     const hasMore = Boolean(lastPage?.hasMore) && nextCursor !== null;
     const isRefreshing = state.refreshQueue !== null;
     const loadMore = useCallback(() => {
-        if (!hasMore || nextCursor === null || isLoading || isRefreshing)
+        if (!hasMore || nextCursor === null || isFetching || isRefreshing)
+            return;
+        // The cursor already resting on `nextCursor` means that page's request failed, since a
+        // loaded page would have moved `nextCursor` on. Re-setting it would be a no-op, so the
+        // failed request is retried instead of leaving the list unable to advance.
+        if (sameCursor(cursor, nextCursor)) {
+            void requestPage().catch(() => { });
             return;
+        }
         setCursor(nextCursor);
-    }, [hasMore, isLoading, isRefreshing, nextCursor, setCursor]);
+    }, [
+        cursor,
+        hasMore,
+        isFetching,
+        isRefreshing,
+        nextCursor,
+        requestPage,
+        setCursor,
+    ]);
     const items = useMemo(() => {
         const seen = new Set();
         return state.pages
@@ -185,9 +208,9 @@ function useInfinitePages({ key, cursor, setCursor }, query, mapping) {
     }, [state.pages]);
     return {
         items,
-        isLoading: isLoading && state.pages.length === 0,
+        isLoading: state.pages.length === 0 && (isFetching || isRefreshing),
         isRefreshing,
-        isLoadingMore: isLoading && state.pages.length > 0,
+        isLoadingMore: isFetching && state.pages.length > 0 && !isRefreshing,
         hasMore,
         loadMore,
         refetch,
@@ -261,7 +284,7 @@ const analysisTasksPage = (response) => ({
 // =====================================================
 export const useInfiniteSessionsByHerd = (herdId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`herd:${herdId}|${filtersKey}`);
+    const paging = usePaging(`herd:${herdId}|${filtersKey}`);
     const query = useGetSessionsInfiniteByHerdQuery({ herdId, cursor: paging.cursor, ...flightArgs(options) }, { skip: !options.enabled || !herdId });
     return useInfinitePages(paging, query, {
         toPage: sessionsPage,
@@ -270,7 +293,7 @@ export const useInfiniteSessionsByHerd = (herdId, options) => {
 };
 export const useInfiniteSessionsByDevice = (deviceId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`device:${deviceId}|${filtersKey}`);
+    const paging = usePaging(`device:${deviceId}|${filtersKey}`);
     const query = useGetSessionsInfiniteByDeviceQuery({ deviceId, cursor: paging.cursor, ...flightArgs(options) }, { skip: !options.enabled || !deviceId });
     return useInfinitePages(paging, query, {
         toPage: sessionsPage,
@@ -282,7 +305,7 @@ export const useInfiniteSessionsByDevice = (deviceId, options) => {
 // =====================================================
 export const useInfiniteEventsByHerd = (herdId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`herd:${herdId}|${filtersKey}`);
+    const paging = usePaging(`herd:${herdId}|${filtersKey}`);
     const query = useGetEventsInfiniteByHerdQuery({ herdId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !herdId });
     return useInfinitePages(paging, query, {
         toPage: eventsPage,
@@ -291,7 +314,7 @@ export const useInfiniteEventsByHerd = (herdId, options) => {
 };
 export const useInfiniteEventsByDevice = (deviceId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`device:${deviceId}|${filtersKey}`);
+    const paging = usePaging(`device:${deviceId}|${filtersKey}`);
     const query = useGetEventsInfiniteByDeviceQuery({ deviceId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !deviceId });
     return useInfinitePages(paging, query, {
         toPage: eventsPage,
@@ -303,7 +326,7 @@ export const useInfiniteEventsByDevice = (deviceId, options) => {
 // =====================================================
 export const useInfiniteArtifactsByHerd = (herdId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`herd:${herdId}|${filtersKey}`);
+    const paging = usePaging(`herd:${herdId}|${filtersKey}`);
     const query = useGetArtifactsInfiniteByHerdQuery({ herdId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !herdId });
     return useInfinitePages(paging, query, {
         toPage: artifactsPage,
@@ -312,7 +335,7 @@ export const useInfiniteArtifactsByHerd = (herdId, options) => {
 };
 export const useInfiniteArtifactsByDevice = (deviceId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`device:${deviceId}|${filtersKey}`);
+    const paging = usePaging(`device:${deviceId}|${filtersKey}`);
     const query = useGetArtifactsInfiniteByDeviceQuery({ deviceId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !deviceId });
     return useInfinitePages(paging, query, {
         toPage: artifactsPage,
@@ -324,7 +347,7 @@ export const useInfiniteArtifactsByDevice = (deviceId, options) => {
 // =====================================================
 export const useInfiniteFeedByHerd = (herdId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`herd:${herdId}|${filtersKey}`);
+    const paging = usePaging(`herd:${herdId}|${filtersKey}`);
     const query = useGetFeedInfiniteByHerdQuery({ herdId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !herdId });
     return useInfinitePages(paging, query, {
         toPage: feedPage,
@@ -333,7 +356,7 @@ export const useInfiniteFeedByHerd = (herdId, options) => {
 };
 export const useInfiniteFeedByDevice = (deviceId, options) => {
     const filtersKey = useFiltersKey(options);
-    const paging = useCursor(`device:${deviceId}|${filtersKey}`);
+    const paging = usePaging(`device:${deviceId}|${filtersKey}`);
     const query = useGetFeedInfiniteByDeviceQuery({ deviceId, cursor: paging.cursor, ...rangeArgs(options) }, { skip: !options.enabled || !deviceId });
     return useInfinitePages(paging, query, {
         toPage: feedPage,
@@ -342,7 +365,7 @@ export const useInfiniteFeedByDevice = (deviceId, options) => {
 };
 export const useInfiniteAnalysisJobs = (options) => {
     const status = options.status ?? null;
-    const paging = useCursor(`status:${status}`);
+    const paging = usePaging(`status:${status}`);
     const query = useGetAnalysisJobsInfiniteQuery({
         cursor: paging.cursor,
         status,
@@ -357,7 +380,7 @@ export const useInfiniteAnalysisJobs = (options) => {
 export const useInfiniteAnalysisTasks = (options) => {
     const status = options.status ?? null;
     const jobId = options.job_id ?? null;
-    const paging = useCursor(`job:${jobId}|status:${status}`);
+    const paging = usePaging(`job:${jobId}|status:${status}`);
     const query = useGetAnalysisTasksInfiniteQuery({
         cursor: paging.cursor,
         status,

package/dist/server/index.d.ts

@@ -4,6 +4,7 @@ export * from "../types";
 export * from "../helpers/artifactMedia";
 export * from "../helpers/bounding_boxes";
 export * from "../helpers/email";
+export * from "../helpers/eventMedia";
 export * from "../helpers/eventUtils";
 export { default as get_gps_center } from "../helpers/gps";
 export * from "../helpers/herd_modules_equal";

package/dist/server/index.js

@@ -6,6 +6,7 @@ export * from "../types";
 export * from "../helpers/artifactMedia";
 export * from "../helpers/bounding_boxes";
 export * from "../helpers/email";
+export * from "../helpers/eventMedia";
 export * from "../helpers/eventUtils";
 export { default as get_gps_center } from "../helpers/gps";
 export * from "../helpers/herd_modules_equal";

package/dist/store/api.d.ts

@@ -151,7 +151,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -260,7 +260,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -367,7 +367,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -476,7 +476,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -583,7 +583,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -692,7 +692,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -799,7 +799,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -908,7 +908,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1015,7 +1015,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -1124,7 +1124,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1231,7 +1231,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -1340,7 +1340,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1445,7 +1445,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -1538,7 +1538,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1629,7 +1629,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -1722,7 +1722,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1813,7 +1813,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -1906,7 +1906,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;
@@ -1997,7 +1997,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
     isFetching: false;
     isSuccess: false;
     isError: false;
-}, "data" | "isLoading" | "isFetching"> & {
+}, "data" | "isFetching" | "isLoading"> & {
     isLoading: true;
     isFetching: boolean;
     data: undefined;
@@ -2090,7 +2090,7 @@ export declare const useGetSessionsInfiniteByHerdQuery: <R extends Record<string
         isFetching: false;
         isSuccess: false;
         isError: false;
-    }, "data" | "isLoading" | "isFetching"> & {
+    }, "data" | "isFetching" | "isLoading"> & {
         isLoading: true;
         isFetching: boolean;
         data: undefined;

package/dist/store/api.js

@@ -2,10 +2,10 @@
 import { createApi, fakeBaseQuery } from "@reduxjs/toolkit/query/react";
 import { addArtifactMediaUrls, addEventMediaUrls, createSignedUrlMap, } from "../helpers/media_urls";
 import { collectArtifactStoragePaths, withArtifactMediaUrls, } from "../helpers/artifactMedia";
-import { isNonEmptyStorageFilePath } from "../helpers/storagePath";
+import { collectEventStoragePaths, withEventMediaUrls, } from "../helpers/eventMedia";
 async function signedUrlMapForFeedRows(supabase, rows) {
     return createSignedUrlMap(supabase, rows.flatMap((row) => [
-        row.event_data?.file_path,
+        ...collectEventStoragePaths([row.event_data]),
         ...(row.artifact_data
             ? collectArtifactStoragePaths([row.artifact_data])
             : []),
@@ -434,12 +434,7 @@ export const scoutApi = createApi({
                     const items = resultRows.map((row) => ({
                         ...row,
                         event_data: row.event_data
-                            ? {
-                                ...row.event_data,
-                                media_url: isNonEmptyStorageFilePath(row.event_data.file_path)
-                                    ? urlMap.get(row.event_data.file_path) ?? null
-                                    : null,
-                            }
+                            ? withEventMediaUrls(row.event_data, urlMap)
                             : null,
                         artifact_data: row.artifact_data
                             ? withArtifactMediaUrls(row.artifact_data, urlMap)
@@ -504,12 +499,7 @@ export const scoutApi = createApi({
                     const items = resultRows.map((row) => ({
                         ...row,
                         event_data: row.event_data
-                            ? {
-                                ...row.event_data,
-                                media_url: isNonEmptyStorageFilePath(row.event_data.file_path)
-                                    ? urlMap.get(row.event_data.file_path) ?? null
-                                    : null,
-                            }
+                            ? withEventMediaUrls(row.event_data, urlMap)
                             : null,
                         artifact_data: row.artifact_data
                             ? withArtifactMediaUrls(row.artifact_data, urlMap)

package/dist/types/db.d.ts

@@ -217,14 +217,13 @@ export type BatteryCycleCountUpdate = Database["public"]["Tables"]["battery_cycl
 export type IMinimalSubjectForArtifact = Database["public"]["Functions"]["get_minimal_subjects_for_artifact"]["Returns"][number];
 export type IAnalysisJob = Database["public"]["Tables"]["analysis_jobs"]["Row"];
 export type IAnalysisTask = Database["public"]["Tables"]["analysis_tasks"]["Row"];
-export type IArtifactWithMediaUrl = IArtifact & {
+export type ISignedMediaUrls = {
     media_url?: string | null;
     thumbnail_url?: string | null;
     proxy_url?: string | null;
 };
-export type IEventWithMediaUrl = IEvent & {
-    media_url?: string | null;
-};
+export type IArtifactWithMediaUrl = IArtifact & ISignedMediaUrls;
+export type IEventWithMediaUrl = IEvent & ISignedMediaUrls;
 export type IVersionsSoftwareWithBuildUrl = IVersionsSoftware & {
     build_artifact_url?: string | null;
 };
@@ -368,9 +367,7 @@ export type IFeedItem = {
     feed_type: string | null;
     sort_ts: string | null;
     sort_id: number | null;
-    event_data: (IEventAndTagsPrettyLocation & {
-        media_url?: string | null;
-    }) | null;
+    event_data: (IEventAndTagsPrettyLocation & ISignedMediaUrls) | null;
     artifact_data: IArtifactWithMediaUrl | null;
 };
 export type ISessionWithCoordinates = Database["public"]["CompositeTypes"]["session_with_coordinates"];

package/dist/types/supabase.d.ts

@@ -1504,12 +1504,16 @@ export type Database = {
                     origin_roll: number | null;
                     processing_blocked_at: string | null;
                     processing_blocked_reason: string | null;
+                    proxy_file_path: string | null;
+                    proxy_generated_at: string | null;
                     segmented_at: string | null;
                     sensor_pitch: number | null;
                     sensor_roll: number | null;
                     sensor_yaw: number | null;
                     session_id: number | null;
                     tagged_at: string | null;
+                    thumbnail_file_path: string | null;
+                    thumbnail_generated_at: string | null;
                     timestamp_observation: string;
                     tracked_at: string | null;
                 };
@@ -1538,12 +1542,16 @@ export type Database = {
                     origin_roll?: number | null;
                     processing_blocked_at?: string | null;
                     processing_blocked_reason?: string | null;
+                    proxy_file_path?: string | null;
+                    proxy_generated_at?: string | null;
                     segmented_at?: string | null;
                     sensor_pitch?: number | null;
                     sensor_roll?: number | null;
                     sensor_yaw?: number | null;
                     session_id?: number | null;
                     tagged_at?: string | null;
+                    thumbnail_file_path?: string | null;
+                    thumbnail_generated_at?: string | null;
                     timestamp_observation?: string;
                     tracked_at?: string | null;
                 };
@@ -1572,12 +1580,16 @@ export type Database = {
                     origin_roll?: number | null;
                     processing_blocked_at?: string | null;
                     processing_blocked_reason?: string | null;
+                    proxy_file_path?: string | null;
+                    proxy_generated_at?: string | null;
                     segmented_at?: string | null;
                     sensor_pitch?: number | null;
                     sensor_roll?: number | null;
                     sensor_yaw?: number | null;
                     session_id?: number | null;
                     tagged_at?: string | null;
+                    thumbnail_file_path?: string | null;
+                    thumbnail_generated_at?: string | null;
                     timestamp_observation?: string;
                     tracked_at?: string | null;
                 };
@@ -7015,6 +7027,10 @@ export type Database = {
                 embedded_at: string | null;
                 segmented_at: string | null;
                 tagged_at: string | null;
+                thumbnail_file_path: string | null;
+                thumbnail_generated_at: string | null;
+                proxy_file_path: string | null;
+                proxy_generated_at: string | null;
             };
             event_plus_tags: {
                 id: number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "2.0.15",
+  "version": "2.0.17",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "exports": {
     "./client": {