feat: Allow user-agent based conditions (#1821)

* Closes #1819

src/card-controller/card-element-manager.ts

@@ -127,6 +127,10 @@ export class CardElementManager {
       this._api.getQueryStringManager().requestExecution,
     );
 
+    this._api.getConditionsManager()?.setState({
+      user_agent: navigator.userAgent,
+    });
+
     // Manually request query string execute as the card will be
     // disconnected/reconnected when dashboard 'tab' changes happen within HA.
     this._api.getQueryStringManager().requestExecution();

src/card-controller/conditions-manager.ts

@@ -19,6 +19,7 @@ import {
 import { localize } from '../localize/localize';
 import { FrigateCardError } from '../types';
 import { desparsifyArrays } from '../utils/basic';
+import { isCompanionApp } from '../utils/companion';
 import { CardConditionAPI, KeysState } from './types';
 
 interface MicrophoneConditionState {
@@ -39,6 +40,7 @@ interface ConditionState {
   microphone?: MicrophoneConditionState;
   user?: CurrentUser;
   keys?: KeysState;
+  user_agent?: string;
 }
 
 class OverrideConfigurationError extends FrigateCardError {}
@@ -353,6 +355,15 @@ export class ConditionsManager {
           (conditionObj.shift === undefined ||
             conditionObj.shift === !!state.keys[conditionObj.key].shift)
         );
+      case 'user_agent':
+        return (
+          !!state.user_agent &&
+          (!conditionObj.user_agent || conditionObj.user_agent === state.user_agent) &&
+          (conditionObj.companion === undefined ||
+            conditionObj.companion === isCompanionApp(state.user_agent)) &&
+          (conditionObj.user_agent_re === undefined ||
+            new RegExp(conditionObj.user_agent_re).test(state.user_agent))
+        );
     }
   }
 

src/card-controller/types.ts

@@ -125,6 +125,7 @@ export interface CardDownloadAPI {
 export interface CardElementAPI {
   getActionsManager(): ActionsManager;
   getCameraManager(): CameraManager;
+  getConditionsManager(): ConditionsManager;
   getConfigManager(): ConfigManager;
   getDefaultManager(): DefaultManager;
   getExpandManager(): ExpandManager;