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`.

tests/card-controller/view/item-manager.test.ts

@@ -226,7 +226,7 @@ describe('ViewItemManager', () => {
         vi.mocked(api.getHASSManager().getHASS).mockReturnValue(createHASS());
 
         const manager = new ViewItemManager(api);
-        const item = new ViewFolder(createFolder());
+        const item = new ViewFolder(createFolder(), []);
 
         vi.mocked(api.getFoldersManager().getDownloadPath).mockResolvedValue({
           sign: false,
@@ -242,7 +242,7 @@ describe('ViewItemManager', () => {
         vi.mocked(api.getHASSManager().getHASS).mockReturnValue(createHASS());
 
         const manager = new ViewItemManager(api);
-        const item = new ViewFolder(createFolder(), { title: 'title' });
+        const item = new ViewFolder(createFolder(), [], { title: 'title' });
 
         vi.mocked(api.getFoldersManager().getDownloadPath).mockResolvedValue({
           sign: false,
@@ -284,4 +284,34 @@ describe('ViewItemManager', () => {
       expect(api.getFoldersManager().favorite).toBeCalledWith(item, true);
     });
   });
+
+  describe('reviewMedia', () => {
+    it('should review camera media', async () => {
+      const api = createCardAPI();
+
+      const manager = new ViewItemManager(api);
+      const item = new TestViewMedia({
+        cameraID: 'camera.office',
+        mediaType: 'review' as ViewMediaType,
+      });
+
+      await manager.reviewMedia(item, true);
+
+      expect(api.getCameraManager().reviewMedia).toBeCalledWith(item, true);
+    });
+
+    it('should not review non-review media', async () => {
+      const api = createCardAPI();
+
+      const manager = new ViewItemManager(api);
+      const item = new TestViewMedia({
+        cameraID: 'camera.office',
+        mediaType: ViewMediaType.Clip,
+      });
+
+      await manager.reviewMedia(item, true);
+
+      expect(api.getCameraManager().reviewMedia).not.toBeCalled();
+    });
+  });
 });