Add download control to thumbnails.

src/utils/download.ts

@@ -0,0 +1,49 @@
+import { CameraManager } from '../camera-manager/manager';
+import { localize } from '../localize/localize';
+import { ExtendedHomeAssistant, FrigateCardError } from '../types';
+import { ViewMedia } from '../view/media';
+import { errorToConsole } from './basic';
+import { homeAssistantSignPath } from './ha';
+
+export const downloadMedia = async (
+  hass: ExtendedHomeAssistant,
+  cameraManager: CameraManager,
+  media: ViewMedia,
+): Promise<void> => {
+  const path = cameraManager.getMediaDownloadPath(media);
+  if (!path) {
+    throw new FrigateCardError(localize('error.download_no_media'));
+  }
+
+  let response: string | null | undefined;
+  try {
+    response = await homeAssistantSignPath(hass, path);
+  } catch (e) {
+    errorToConsole(e as Error);
+  }
+
+  if (!response) {
+    throw new FrigateCardError(localize('error.download_sign_failed'));
+  }
+
+  if (
+    navigator.userAgent.startsWith('Home Assistant/') ||
+    navigator.userAgent.startsWith('HomeAssistant/')
+  ) {
+    // Home Assistant companion apps cannot download files without opening a
+    // new browser window.
+    //
+    // User-agents are specified here:
+    //  - Android: https://github.com/home-assistant/android/blob/master/app/src/main/java/io/homeassistant/companion/android/webview/WebViewActivity.kt#L107
+    //  - iOS: https://github.com/home-assistant/iOS/blob/master/Sources/Shared/API/HAAPI.swift#L75
+    window.open(response, '_blank');
+  } else {
+    // Use the HTML5 download attribute to prevent a new window from
+    // temporarily opening.
+    const link = document.createElement('a');
+    link.setAttribute('download', '');
+    link.href = response;
+    link.click();
+    link.remove();
+  }
+};