import { HomeAssistant } from 'custom-card-helpers'; import { z } from 'zod'; import { localize } from '../localize/localize'; import { CameraConfig, ExtendedHomeAssistant, FrigateCardError } from '../types'; import { homeAssistantHTTPRequest, homeAssistantWSRequest } from './ha'; export const FRIGATE_ICON_SVG_PATH = 'm 4.8759466,22.743573 c 0.0866,0.69274 0.811811,1.16359 0.37885,1.27183 ' + '-0.43297,0.10824 -2.32718,-3.43665 -2.7601492,-4.95202 -0.4329602,-1.51538 ' + '-0.6764993,-3.22017 -0.5682593,-4.19434 0.1082301,-0.97417 5.7097085,-2.48955 ' + '5.7097085,-2.89545 0,-0.4059 -1.81304,-0.0271 -1.89422,-0.35178 -0.0812,-0.32472 ' + '1.36925,-0.12989 1.75892,-0.64945 0.60885,-0.81181 1.3800713,-0.6765 1.8671505,' + '-1.1094696 0.4870902,-0.4329599 1.0824089,-2.0836399 1.1906589,-2.7871996 0.108241,' + '-0.70357 -1.0824084,-1.51538 -1.4071389,-2.05658 -0.3247195,-0.54121 0.7035702,' + '-0.92005 3.1931099,-1.94834 2.48954,-1.02829 10.39114,-3.30134994 10.49938,' + '-3.03074994 0.10824,0.27061 -2.59779,1.40713994 -4.492,2.11069994 -1.89422,0.70357 ' + '-4.97909,2.05658 -4.97909,2.43542 0,0.37885 0.16236,0.67651 0.0541,1.54244 -0.10824,' + '0.86593 -0.12123,1.2702597 -0.32472,1.8400997 -0.1353,0.37884 -0.2706,1.27183 ' + '0,2.0836295 0.21648,0.64945 0.92005,1.13653 1.24477,1.24478 0.2706,0.018 1.01746,' + '0.0433 1.8401,0 1.02829,-0.0541 2.48954,0.0541 2.48954,0.32472 0,0.2706 -2.21894,' + '0.10824 -2.21894,0.48708 0,0.37885 2.27306,-0.0541 2.21894,0.32473 -0.0541,0.37884 ' + '-1.89422,0.21648 -2.86839,0.21648 -0.77933,0 -1.93031,-0.0361 -2.43542,-0.21648 ' + 'l -0.10824,0.37884 c -0.18038,0 -0.55744,0.10824 -0.94711,0.10824 -0.48708,0 ' + '-0.51414,0.16236 -1.40713,0.16236 -0.892989,0 -0.622391,-0.0541 -1.4341894,-0.10824 ' + '-0.81181,-0.0541 -3.842561,2.27306 -4.383761,3.03075 -0.54121,0.75768 ' + '-0.21649,2.59778 -0.21649,3.43665 0,0.75379 -0.10824,2.43542 0,3.30135 z'; const recordingSummaryHourSchema = z.object({ hour: z.preprocess((arg) => Number(arg), z.number().min(0).max(23)), duration: z.number().min(0), events: z.number().min(0), }); const recordingSummarySchema = z .object({ day: z.preprocess((arg) => { // Must provide the hour:minute:second on parsing or Javascript will // assume UTC midnight. return typeof arg === 'string' ? new Date(`${arg}T00:00:00`) : arg; }, z.date()), events: z.number(), hours: recordingSummaryHourSchema.array(), }) .array(); export type RecordingSummary = z.infer; const recordingSegmentSchema = z.object({ start_time: z.number(), end_time: z.number(), id: z.string(), }); const recordingSegmentsSchema = recordingSegmentSchema.array(); export type RecordingSegments = z.infer; const retainResultSchema = z.object({ success: z.boolean(), message: z.string(), }); export type RetainResult = z.infer; /** * Get the recordings summary. May throw. * @param hass The Home Assistant object. * @param client_id The Frigate client_id. * @param camera_name The Frigate camera name. * @returns A RecordingSummary object. */ export const getRecordingsSummary = async ( hass: ExtendedHomeAssistant, client_id: string, camera_name: string, ): Promise => { return await homeAssistantHTTPRequest( hass, recordingSummarySchema, `/api/frigate/${client_id}/${camera_name}/recordings/summary`, ); }; /** * Get the recording segments. May throw. * @param hass The Home Assistant object. * @param client_id The Frigate client_id. * @param camera_name The Frigate camera name. * @param before The segment low watermark. * @param after The segment high watermark. * @returns A RecordingSegments object. */ export const getRecordingSegments = async ( hass: ExtendedHomeAssistant, client_id: string, camera_name: string, before: Date, after: Date, ): Promise => { return await homeAssistantHTTPRequest( hass, recordingSegmentsSchema, `/api/frigate/${client_id}/${camera_name}/recordings`, new URLSearchParams({ before: String(before.getTime() / 1000), after: String(after.getTime() / 1000), }), ); }; /** * Request that Frigate retain an event. May throw. * @param hass The HomeAssistant object. * @param client_id The Frigate client_id. * @param eventID The event ID to retain. * @param retain `true` to retain or `false` to unretain. */ export async function retainEvent( hass: HomeAssistant, client_id: string, eventID: string, retain: boolean, ): Promise { const retainRequest = { type: 'frigate/event/retain', instance_id: client_id, event_id: eventID, retain: retain, }; const response = await homeAssistantWSRequest( hass, retainResultSchema, retainRequest, ); if (!response.success) { throw new FrigateCardError(localize('error.failed_retain'), { request: retainRequest, response: response, }); } } /** * Get an id that unique identifies a particular camera (not zone, object, etc) * within a particular Frigate instance. ID will not (necessarily) be unique * within the card. * @param cameraConfig The camera config. */ export const getUniqueFrigateCameraID = (config: CameraConfig): string => { return [config.frigate.client_id, config.frigate.camera_name].join('/'); }; /** * Get an id that unique identifies a source of Frigate events. ID will not * (necessarily) be unique within the card. * @param cameraConfig The camera config. */ export const getUniqueFrigateCameraEventsID = (config: CameraConfig): string => { return [ config.frigate.client_id, config.frigate.camera_name, config.frigate.label, config.frigate.zone, ].join('/'); };