Add a widget that indicates activity state for a given zone

.homeycompose/app.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/Erikvl87/nl.erikvl87.zoneactivity/issues"
   },
   "source": "https://github.com/Erikvl87/nl.erikvl87.zoneactivity",
-  "compatibility": ">=5.0.0",
+  "compatibility": ">=12.1.2",
   "sdk": 3,
   "platforms": [
     "local"

app.json

@@ -8,7 +8,7 @@
     "url": "https://github.com/Erikvl87/nl.erikvl87.zoneactivity/issues"
   },
   "source": "https://github.com/Erikvl87/nl.erikvl87.zoneactivity",
-  "compatibility": ">=5.0.0",
+  "compatibility": ">=12.1.2",
   "sdk": 3,
   "platforms": [
     "local"
@@ -628,5 +628,42 @@
         }
       ]
     }
-  ]
+  ],
+  "widgets": {
+    "zone-activity-state": {
+      "name": {
+        "en": "Zone activity state",
+        "nl": "Zone activiteit status"
+      },
+      "height": 75,
+      "settings": [
+        {
+          "id": "zone",
+          "type": "autocomplete",
+          "title": {
+            "en": "Zone"
+          }
+        }
+      ],
+      "api": {
+        "getSomething": {
+          "method": "GET",
+          "path": "/"
+        },
+        "addSomething": {
+          "method": "POST",
+          "path": "/"
+        },
+        "updateSomething": {
+          "method": "PUT",
+          "path": "/:id"
+        },
+        "deleteSomething": {
+          "method": "DELETE",
+          "path": "/:id"
+        }
+      },
+      "id": "zone-activity-state"
+    }
+  }
 }

app.ts

@@ -7,6 +7,7 @@ import ConditionCardEvaluateSensorCapabilities from './lib/ConditionCardEvaluate
 import ConditionCardZoneActiveForMinutes from './lib/ConditionCardZoneActiveForMinutes';
 import TriggerCardAnyDeviceTurnedOn from './lib/TriggerCardAnyDeviceOnOff';
 import ZonesDb from './lib/ZonesDb';
+import WidgetZoneActivityState from './lib/WidgetZoneActivityState';
 
 class ZoneActivity extends Homey.App {
 	/**
@@ -16,6 +17,8 @@ class ZoneActivity extends Homey.App {
 	homeyApi!: ExtendedHomeyAPIV3Local;
 	homeyLog?: Log;
 
+	private widget!: WidgetZoneActivityState;
+
 	/**
 	 * Initialize the Zone Activity app.
 	 * @returns {Promise<void>} A promise that resolves when the app has been initialized.
@@ -34,6 +37,7 @@ class ZoneActivity extends Homey.App {
 		await ConditionCardZoneActiveForMinutes.initialize(this.homey, this.homeyApi, zonesDb, this.log);
 		await ConditionCardEvaluateSensorCapabilities.initialize(this.homey, this.homeyApi, zonesDb, this.log);
 		await TriggerCardAnyDeviceTurnedOn.initialize(this.homey, this.homeyApi, zonesDb, this.log, this.error);
+		this.widget = await WidgetZoneActivityState.initialize(this.homey, this.homeyApi, zonesDb, this.log, this.error);
 	}
 }
 

lib/WidgetZoneActivityState.ts

@@ -0,0 +1,100 @@
+import { ExtendedDeviceCapability, ExtendedHomeyAPIV3Local, ExtendedZone } from "homey-api";
+import Homey from "homey/lib/Homey";
+import handleZoneAutocomplete from "../utils/handleZoneAutocomplete";
+import ZonesDb from "./ZonesDb";
+import getIconForZone from "./../utils/getIconForZone";
+
+export default class WidgetZoneActivityState {
+
+	private static instance: WidgetZoneActivityState | null = null;
+
+	widget: unknown;
+
+	syncDevicesTimeoutId: NodeJS.Timeout | undefined;
+
+	capabilityInstances: Map<string, ExtendedDeviceCapability> = new Map();
+
+	private constructor(private homey: Homey, private homeyApi: ExtendedHomeyAPIV3Local, private zonesDb: ZonesDb, private log: (...args: unknown[]) => void, private error: (...args: unknown[]) => void) {
+
+		// @ts-expect-error Ignore the error for the non-existing method / property
+		this.widget = this.homey.dashboards.getWidget('zone-activity-state');
+	}
+
+	public static async initialize(homey: Homey, homeyApi: ExtendedHomeyAPIV3Local, zonesDb: ZonesDb, log: (...args: unknown[]) => void, error: (...args: unknown[]) => void): Promise<WidgetZoneActivityState> {
+		if (WidgetZoneActivityState.instance === null) {
+			WidgetZoneActivityState.instance = new WidgetZoneActivityState(homey, homeyApi, zonesDb, log, error);
+			await WidgetZoneActivityState.instance.setup();
+		}
+		return WidgetZoneActivityState.instance;
+	}
+
+	private async setup(): Promise<void> {
+		// @ts-expect-error Ignore the error for the non-existing method / property
+		this.widget.registerSettingAutocompleteListener('zone', async (query: string) => {
+			const result = (await handleZoneAutocomplete(query, this.zonesDb))
+				// Remap icon to image for all results
+				.map((zone) => {
+					zone.image = zone.icon;
+					delete zone.icon;
+					return zone;
+				});
+
+			this.log('Zone autocomplete results:', result);
+			return result;
+		});
+
+		this.homeyApi.zones.on('zone.update', async (zone: ExtendedZone) => {
+			this.homey.api.realtime('zone-update', this.transformZone(zone));
+		});
+	}
+
+	public async isZoneActive(zoneId: string): Promise<unknown> {
+		const zone = await this.homeyApi.zones.getZone({ id: zoneId });
+		if (zone === null)
+			return null;
+
+		return this.transformZone(zone);
+	}
+
+	private transformZone(zone: ExtendedZone): unknown {
+		const lastUpdated = new Date(zone.activeLastUpdated);
+		const now = new Date();
+		let date: string;
+
+		const language = this.homey.i18n.getLanguage();
+		const timezone = this.homey.clock.getTimezone();
+
+		const timeDifference = now.getTime() - lastUpdated.getTime();
+		const minutesDifference = Math.floor(timeDifference / (1000 * 60));
+		const hoursDifference = Math.floor(timeDifference / (1000 * 60 * 60));
+
+		if (lastUpdated.toDateString() === now.toDateString()) {
+			date = lastUpdated.toLocaleTimeString(language, { timeZone: timezone });
+		} else {
+			date = lastUpdated.toLocaleString(language, { timeZone: timezone });
+		}
+
+		let subtitle: string;
+		if (zone.active) {
+			subtitle = this.homey.__('active');
+		} else if (hoursDifference >= 24) {
+			subtitle = `${this.homey.__('last_active')}: ${date}`;
+		} else if (hoursDifference > 0) {
+			subtitle = `${this.homey.__('last_active')}: ${hoursDifference} ${this.homey.__('hours_ago')}`;
+		} else {
+			subtitle = `${this.homey.__('last_active')}: ${minutesDifference} ${this.homey.__('minutes_ago')}`;
+		}
+
+		const result = {
+			id: zone.id,
+			icon: getIconForZone(zone.icon),
+			name: zone.name,
+			subtitle: subtitle,
+			active: zone.active,
+			activeLastUpdated: zone.activeLastUpdated,
+		}
+
+		return result;
+	}
+}
+

locales/en.json

@@ -1,4 +1,8 @@
 {
 	"any_type": "Any type",
-	"any_sensor": "Any sensor"
+	"any_sensor": "Any sensor",
+	"active": "Active",
+	"last_active": "Last active",
+	"hours_ago": "hours ago",
+	"minutes_ago": "minutes ago"
 }

locales/nl.json

@@ -1,4 +1,8 @@
 {
 	"any_type": "Elk type",
-	"any_sensor": "Elke sensor"
+	"any_sensor": "Elke sensor",
+	"active": "Actief",
+	"last_active": "Laatst actief",
+	"hours_ago": "uur geleden",
+	"minutes_ago": "minuten geleden"
 }

package.json

@@ -8,7 +8,7 @@
   "devDependencies": {
     "@eslint-recommended/eslint-config": "^26.1.1",
     "@tsconfig/node16": "^16.1.3",
-    "@types/homey": "npm:homey-apps-sdk-v3-types@^0.3.7",
+    "@types/homey": "npm:homey-apps-sdk-v3-types@^0.3.9",
     "@types/node": "^22.5.1",
     "@typescript-eslint/eslint-plugin": "^8.3.0",
     "@typescript-eslint/parser": "^8.3.0",

tsconfig.json

@@ -10,7 +10,8 @@
     "sourceMap": true
   },
   "include": [
-    "./**/*.ts"
+    "./**/*.ts",
+    "./widgets/zone-activity-state/api.js"
   ],
   "exclude": [
     "node_modules",

widgets/zone-activity-state/api.ts

@@ -0,0 +1,39 @@
+
+import Homey from "homey/lib/Homey";
+
+class ZoneActivityStateWidget {
+	public async getSomething({ homey, query }: ApiRequest) : Promise<string> {
+		// you can access query parameters like "/?foo=bar" through `query.foo`	
+
+		console.log('query', query);
+
+		//@ts-expect-error: Ignore the error for the non-existing method 'test'
+		const result = await homey.app.widget.isZoneActive(query.zoneId);
+
+		console.log('result', result);
+
+
+
+
+		// perform other logic like mapping result data
+		return result;
+	}
+
+	// public async addSomething({ homey, body }: ApiRequest) : Promise<string> {
+	// 	// access the post body and perform some action on it.
+	// 	return homey.app.addSomething(body);
+	// }
+
+	// // eslint-disable-next-line @typescript-eslint/no-unused-vars
+	// public async updateSomething({ homey, params, body }: ApiRequest) : Promise<string> {
+	// 	return homey.app.setSomething(body);
+	// }
+
+	// public async deleteSomething({ homey, params } : ApiRequest) : Promise<string> {
+	// 	return homey.app.deleteSomething(params.id);
+	// }
+}
+
+module.exports = new ZoneActivityStateWidget();
+
+type ApiRequest = { homey: Homey; query: string, body: unknown, params: unknown };