feat: Implement basic general folder support (#2051)

- Related: #1748

tests/config/schema/folders.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest';
+import { transformPathURLToPathArray } from '../../../src/config/schema/folders';
+import { NonEmptyTuple } from 'type-fest';
+
+describe('transformURLToMediaSourceRoot', () => {
+  const prefixes: NonEmptyTuple<string>[] = [
+    ['http://card.camera/' as const],
+    ['/' as const],
+    ['' as const],
+  ];
+
+  describe('should return the media source root when given a root URL', () => {
+    it.each(prefixes)('with prefix %s', (urlPrefix: string) => {
+      const url = `${urlPrefix}media-browser/browser`;
+      const result = transformPathURLToPathArray(url);
+      expect(result).toEqual([{ id: 'media-source://' }]);
+    });
+  });
+
+  describe('should return the media source root when given a valid URL', () => {
+    it.each(prefixes)('with prefix %s', (urlPrefix: string) => {
+      const url = `${urlPrefix}media-browser/browser/app%2Cmedia-source%3A%2F%2Fcamera`;
+      const result = transformPathURLToPathArray(url);
+      expect(result).toEqual([
+        { id: 'media-source://' },
+        { id: 'media-source://camera' },
+      ]);
+    });
+  });
+
+  describe('should return the decoded frigate URL', () => {
+    it.each(prefixes)('with prefix %s', (urlPrefix: string) => {
+      const url =
+        `${urlPrefix}media-browser/browser/app%2Cmedia-source%3A%2F%2F` +
+        'frigate/image%2Cmedia-source%3A%2F%2Ffrigate%2Ffrigate%2F' +
+        'event-search%2Fsnapshots%2F%2F%2F%2F%2F%2F/image%2C' +
+        'media-source%3A%2F%2Ffrigate%2Ffrigate%2Fevent-search' +
+        '%2Fsnapshots%2F.this_month%2F1746082800%2F%2F%2F%2F';
+      const result = transformPathURLToPathArray(url);
+      expect(result).toEqual([
+        { id: 'media-source://' },
+        { id: 'media-source://frigate' },
+        { id: 'media-source://frigate/frigate/event-search/snapshots//////' },
+        {
+          id: 'media-source://frigate/frigate/event-search/snapshots/.this_month/1746082800////',
+        },
+      ]);
+    });
+  });
+
+  describe('should return the root for unknown URLs', () => {
+    it.each(prefixes)('with prefix %s', (urlPrefix: string) => {
+      const url = `${urlPrefix}something-completely-different`;
+      const result = transformPathURLToPathArray(url);
+      expect(result).toEqual([{ id: 'media-source://' }]);
+    });
+  });
+
+  describe('should throw error for non-media source path component', () => {
+    it.each(prefixes)('with prefix %s', (urlPrefix: string) => {
+      const url = `${urlPrefix}media-browser/browser,does-not-start-with-media-source`;
+      expect(() => transformPathURLToPathArray(url)).toThrowError(
+        /Could not parse valid media source URL/,
+      );
+    });
+  });
+});

tests/config/types.test.ts

@@ -132,7 +132,6 @@ describe('config defaults', () => {
             mode: 'right',
           },
           thumbnails: {
-            mode: 'right',
             show_details: false,
             show_download_control: true,
             show_favorite_control: true,
@@ -215,6 +214,10 @@ describe('config defaults', () => {
             enabled: false,
             priority: 50,
           },
+          folders: {
+            enabled: true,
+            priority: 50,
+          },
           fullscreen: {
             enabled: true,
             priority: 50,