feat: Add control/output of selected camera via an entity (#1895)

- Closes #1871

tests/card-controller/actions/actions/camera-select.test.ts

@@ -13,7 +13,7 @@ describe('should handle camera_select action', () => {
       {
         action: 'fire-dom-event',
         advanced_camera_card_action: 'camera_select',
-        camera: 'camera',
+        camera: 'camera.office',
       },
     );
 
@@ -23,13 +23,36 @@ describe('should handle camera_select action', () => {
       expect.objectContaining({
         params: {
           view: 'live',
-          camera: 'camera',
+          camera: 'camera.office',
         },
         failSafe: true,
       }),
     );
   });
 
+  it('should ignore requests to change to the current camera', async () => {
+    const api = createCardAPI();
+    vi.mocked(api.getViewManager().getView).mockReturnValue(
+      createView({
+        camera: 'camera.office',
+      }),
+    );
+    vi.mocked(api.getViewManager().isViewSupportedByCamera).mockReturnValue(true);
+
+    const action = new CameraSelectAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'camera_select',
+        camera: 'camera.office',
+      },
+    );
+
+    await action.execute(api);
+
+    expect(api.getViewManager().setViewByParametersWithNewQuery).not.toBeCalled();
+  });
+
   it('without config', async () => {
     const api = createCardAPI();
     vi.mocked(api.getConfigManager().getConfig).mockReturnValue(null);
@@ -45,7 +68,7 @@ describe('should handle camera_select action', () => {
       {
         action: 'fire-dom-event',
         advanced_camera_card_action: 'camera_select',
-        camera: 'camera',
+        camera: 'camera.office',
       },
     );
 
@@ -55,7 +78,7 @@ describe('should handle camera_select action', () => {
       expect.objectContaining({
         params: {
           view: 'timeline',
-          camera: 'camera',
+          camera: 'camera.office',
         },
         failSafe: true,
       }),
@@ -84,7 +107,7 @@ describe('should handle camera_select action', () => {
       {
         action: 'fire-dom-event',
         advanced_camera_card_action: 'camera_select',
-        camera: 'camera',
+        camera: 'camera.office',
       },
     );
 
@@ -94,7 +117,7 @@ describe('should handle camera_select action', () => {
       expect.objectContaining({
         params: {
           view: 'clips',
-          camera: 'camera',
+          camera: 'camera.office',
         },
         failSafe: true,
       }),
@@ -106,7 +129,7 @@ describe('should handle camera_select action', () => {
     vi.mocked(api.getViewManager().getView).mockReturnValue(createView());
     vi.mocked(api.getViewManager().isViewSupportedByCamera).mockReturnValue(true);
     vi.mocked(api.getTriggersManager().getMostRecentlyTriggeredCameraID).mockReturnValue(
-      'camera',
+      'camera.office',
     );
 
     const action = new CameraSelectAction(
@@ -124,7 +147,7 @@ describe('should handle camera_select action', () => {
       expect.objectContaining({
         params: {
           view: 'live',
-          camera: 'camera',
+          camera: 'camera.office',
         },
         failSafe: true,
       }),
@@ -136,7 +159,7 @@ describe('should handle camera_select action', () => {
     vi.mocked(api.getViewManager().getView).mockReturnValue(createView());
     vi.mocked(api.getViewManager().isViewSupportedByCamera).mockReturnValue(true);
     vi.mocked(api.getTriggersManager().getMostRecentlyTriggeredCameraID).mockReturnValue(
-      'camera',
+      'camera.office',
     );
 
     const action = new CameraSelectAction(

tests/card-controller/actions/actions/internal-callback.test.ts

@@ -0,0 +1,21 @@
+import { expect, it, vi } from 'vitest';
+import { InternalCallbackAction } from '../../../../src/card-controller/actions/actions/internal-callback';
+import { INTERNAL_CALLBACK_ACTION } from '../../../../src/config/types';
+import { createCardAPI } from '../../../test-utils';
+
+it('should handle internal callback action', async () => {
+  const api = createCardAPI();
+  const callback = vi.fn();
+  const action = new InternalCallbackAction(
+    {},
+    {
+      action: 'fire-dom-event',
+      advanced_camera_card_action: INTERNAL_CALLBACK_ACTION,
+      callback: callback,
+    },
+  );
+
+  await action.execute(api);
+
+  expect(callback).toBeCalledWith(api);
+});

tests/card-controller/actions/factory.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 import { CameraSelectAction } from '../../../src/card-controller/actions/actions/camera-select';
 import { CameraUIAction } from '../../../src/card-controller/actions/actions/camera-ui';
 import { DefaultAction } from '../../../src/card-controller/actions/actions/default';
@@ -7,6 +7,7 @@ import { DownloadAction } from '../../../src/card-controller/actions/actions/dow
 import { ExpandAction } from '../../../src/card-controller/actions/actions/expand';
 import { FullscreenAction } from '../../../src/card-controller/actions/actions/fullscreen';
 import { GenericAction } from '../../../src/card-controller/actions/actions/generic';
+import { InternalCallbackAction } from '../../../src/card-controller/actions/actions/internal-callback';
 import { LogAction } from '../../../src/card-controller/actions/actions/log';
 import { MediaPlayerAction } from '../../../src/card-controller/actions/actions/media-player';
 import { MenuToggleAction } from '../../../src/card-controller/actions/actions/menu-toggle';
@@ -30,7 +31,10 @@ import { SubstreamSelectAction } from '../../../src/card-controller/actions/acti
 import { UnmuteAction } from '../../../src/card-controller/actions/actions/unmute';
 import { ViewAction } from '../../../src/card-controller/actions/actions/view';
 import { ActionFactory } from '../../../src/card-controller/actions/factory';
-import { AdvancedCameraCardCustomAction } from '../../../src/config/types';
+import {
+  AdvancedCameraCardCustomAction,
+  INTERNAL_CALLBACK_ACTION,
+} from '../../../src/config/types';
 
 // @vitest-environment jsdom
 describe('ActionFactory', () => {
@@ -165,6 +169,13 @@ describe('ActionFactory', () => {
         },
         StatusBarAction,
       ],
+      [
+        {
+          advanced_camera_card_action: INTERNAL_CALLBACK_ACTION,
+          callback: vi.fn(),
+        },
+        InternalCallbackAction,
+      ],
     ])(
       'advanced_camera_card_action: $advanced_camera_card_action',
       (action: Partial<AdvancedCameraCardCustomAction>, classObject: object) => {