feat: Add folder view to view folder media (#2077)

- Closes: #2068

Note: Renames existing `folder` view to `folders` [experimental
functionality]

src/config/schema/actions/custom/folder.ts

@@ -1,10 +0,0 @@
-import { z } from 'zod';
-import { advancedCameraCardCustomActionsBaseSchema } from './base';
-
-export const folderActionConfigSchema = advancedCameraCardCustomActionsBaseSchema.extend(
-  {
-    advanced_camera_card_action: z.literal('folder'),
-    folder: z.string().optional(),
-  },
-);
-export type FolderActionConfig = z.infer<typeof folderActionConfigSchema>;

src/config/schema/actions/custom/folders-view.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { advancedCameraCardCustomActionsBaseSchema } from './base';
+
+export const foldersViewActionConfigSchema =
+  advancedCameraCardCustomActionsBaseSchema.extend({
+    advanced_camera_card_action: z.literal('folders').or(z.literal('folder')),
+    folder: z.string().optional(),
+  });
+export type FoldersViewActionConfig = z.infer<typeof foldersViewActionConfigSchema>;

src/config/schema/actions/custom/view.ts

@@ -7,14 +7,14 @@ import { advancedCameraCardCustomActionsBaseSchema } from './base';
 
 type AdvancedCameraCardUserSpecifiedViewWithoutFolder = Exclude<
   AdvancedCameraCardUserSpecifiedView,
-  'folder'
+  'folder' | 'folders'
 >;
 
 export const viewActionConfigSchema = advancedCameraCardCustomActionsBaseSchema.extend({
   advanced_camera_card_action: z.enum(
-    // The folder view is handled by the `folder` action since it accepts an
+    // The folder/folders views are handled separately as they accept an
     // optional folder ID.
-    VIEWS_USER_SPECIFIED.filter((view) => view !== 'folder') as [
+    VIEWS_USER_SPECIFIED.filter((view) => view !== 'folder' && view !== 'folders') as [
       AdvancedCameraCardUserSpecifiedViewWithoutFolder,
       ...AdvancedCameraCardUserSpecifiedViewWithoutFolder[],
     ],