✨ #698 homeassistant widget (#1658)

src/tools/server/sdk/homeassistant/HomeAssistant.ts

@@ -0,0 +1,41 @@
+import Consola from 'consola';
+import { appendPath } from '~/tools/shared/strings';
+import { entityStateSchema } from './models/EntityState';
+
+export class HomeAssistant {
+  public readonly basePath: URL;
+  private readonly token: string;
+
+  constructor(url: URL, token: string) {
+    if (!url.pathname.endsWith('/')) {
+      url.pathname += "/";
+    }
+    url.pathname += 'api';
+    this.basePath = url;
+    this.token = token;
+  }
+
+  async getEntityState(entityId: string) {
+    try {
+      const response = await fetch(appendPath(this.basePath, `/states/${entityId}`), {
+        headers: {
+          'Authorization': `Bearer ${this.token}`
+        }
+      });
+      const body = await response.json();
+      if (!response.ok) {
+        return {
+          success: false as const,
+          error: body
+        };
+      }
+      return entityStateSchema.safeParseAsync(body);
+    } catch (err) {
+      Consola.error(`Failed to fetch from '${this.basePath}': ${err}`);
+      return {
+        success: false as const,
+        error: err
+      };
+    }
+  }
+}

src/tools/server/sdk/homeassistant/models/EntityState.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+
+
+export const entityStateSchema = z.object({
+  attributes: z.record(z.union([z.string(), z.number(), z.boolean()])),
+  entity_id: z.string(),
+  last_changed: z.string().pipe(z.coerce.date()),
+  last_updated: z.string().pipe(z.coerce.date()),
+  state: z.string(),
+});
+
+export type EntityState = z.infer<typeof entityStateSchema>;