feat: Add support for Frigate reviews / detections [initial PR] (#2315)

- Add support for Frigate reviews / detections.
 - Add support for GenAI metadata.
- Significant internal refactor to more flexible "UnifiedQuery" to allow
mixing cameras with simple metadata and review metadata (e.g. a timeline
view of a Frigate camera with reviews, and a Reolink camera with simple
metadata).
 - Add support for folder media as camera media.

There are a few more PRs to commit prior to this going live, but
commiting this for now due to the scale of the change.

BREAKING CHANGE: `media_type` and `events_type` are retired under
`live`, `viewer` and `timeline` configuration sections, instead media
type is associated (once) with the camera under `media`.

src/ha/browse-media/item-factory.ts

@@ -13,8 +13,8 @@ export class BrowseMediaViewItemFactory {
     options?: ViewMediaSourceOptions,
   ): ViewItem | null {
     if (browseMedia.can_expand) {
-      return options?.folder
-        ? new BrowseMediaViewFolder(options.folder, browseMedia)
+      return options?.folder && options?.path
+        ? new BrowseMediaViewFolder(options.folder, options.path, browseMedia)
         : null;
     }
 

src/ha/browse-media/item.ts

@@ -1,5 +1,6 @@
 import { format } from 'date-fns';
 import { isEqual } from 'lodash-es';
+import { FolderPathComponent } from '../../card-controller/folders/types';
 import { FolderConfig } from '../../config/schema/folders';
 import { formatDateAndTime } from '../../utils/basic';
 import {
@@ -116,8 +117,12 @@ export class BrowseMediaEventViewMedia extends ViewMedia implements EventViewMed
 export class BrowseMediaViewFolder extends ViewFolder {
   private _browseMedia: RichBrowseMedia<BrowseMediaMetadata>;
 
-  constructor(folder: FolderConfig, browseMedia: RichBrowseMedia<BrowseMediaMetadata>) {
-    super(folder, {
+  constructor(
+    folder: FolderConfig,
+    path: readonly FolderPathComponent[],
+    browseMedia: RichBrowseMedia<BrowseMediaMetadata>,
+  ) {
+    super(folder, path, {
       id: browseMedia.media_content_id,
       icon: getIcon(browseMedia.children_media_class ?? browseMedia.media_class),
       title: browseMedia.title,

src/ha/ws-request.ts

@@ -37,11 +37,11 @@ export async function homeAssistantWSRequest<T>(
     // Some endpoints in Home Assistant pass JSON directly though, these end up
     // wrapped in a string and must be unwrapped first.
     return schema.parse(passthrough ? JSON.parse(response as string) : response);
-  } catch (e) {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  } catch (_e) {
     throw new AdvancedCameraCardError(localize('error.invalid_response'), {
       request: request,
       response: response,
-      error: e,
     });
   }
 }