feat: Add experimental reolink media support (#1694)

* feat: Add experimental rich reolink support.

* Formatting fix

src/camera-manager/browse-media/utils/browse-media-to-view-media.ts

@@ -0,0 +1,49 @@
+import {
+  RichBrowseMedia,
+  MEDIA_CLASS_VIDEO,
+  MEDIA_CLASS_IMAGE,
+} from '../../../utils/ha/browse-media/types';
+import { ViewMedia } from '../../../view/media';
+import { BrowseMediaViewMediaFactory } from '../media';
+import { BrowseMediaMetadata } from '../types';
+
+export const getViewMediaFromBrowseMediaArray = (
+  browseMedia: RichBrowseMedia<BrowseMediaMetadata>[],
+): ViewMedia[] | null => {
+  const lookup: Map<string, ViewMedia> = new Map();
+  for (const browseMediaItem of browseMedia) {
+    const cameraID = browseMediaItem._metadata?.cameraID;
+    if (!cameraID) {
+      continue;
+    }
+
+    const mediaType =
+      browseMediaItem.media_class === MEDIA_CLASS_VIDEO
+        ? 'clip'
+        : browseMediaItem.media_class === MEDIA_CLASS_IMAGE
+          ? 'snapshot'
+          : null;
+
+    if (!mediaType) {
+      continue;
+    }
+    const media = BrowseMediaViewMediaFactory.createEventViewMedia(
+      mediaType,
+      browseMediaItem,
+      cameraID,
+    );
+
+    const id = media.getID();
+    const existing = lookup.get(id);
+
+    // De-duplicate events with precisely the same ID (same
+    // hour/minute/second) choosing clip > snapshot.
+    if (
+      !existing ||
+      (existing.getMediaType() === 'snapshot' && media.getMediaType() === 'clip')
+    ) {
+      lookup.set(id, media);
+    }
+  }
+  return [...lookup.values()];
+};

src/camera-manager/browse-media/utils/within-dates.ts

@@ -0,0 +1,50 @@
+import { RichBrowseMedia } from '../../../utils/ha/browse-media/types';
+import { rangesOverlap } from '../../range';
+import { BrowseMediaMetadata } from '../types';
+
+/**
+ * A utility method to determine if a browse media object matches against a
+ * start and end date.
+ * @param media The browse media object (with rich metadata).
+ * @param start The optional start date.
+ * @param end The optional end date.
+ * @returns `true` if the media falls within the provided dates.
+ */
+
+export const isMediaWithinDates = (
+  media: RichBrowseMedia<BrowseMediaMetadata>,
+  start?: Date,
+  end?: Date,
+): boolean => {
+  // If there's no metadata, nothing matches.
+  if (!media._metadata) {
+    return false;
+  }
+
+  if (start && end) {
+    // Determine if:
+    // - The media starts within the query timeframe.
+    // - The media ends within the query timeframe.
+    // - The media entirely encompasses the query timeframe.
+    return rangesOverlap(
+      {
+        start: media._metadata.startDate,
+        end: media._metadata.endDate,
+      },
+      {
+        start: start,
+        end: end,
+      },
+    );
+  }
+
+  if (!start && end) {
+    return media._metadata.startDate <= end;
+  }
+  if (start && !end) {
+    return media._metadata.startDate >= start;
+  }
+
+  // If no date is specified at all, everything matches.
+  return true;
+};