@digital-alchemy/hass 25.10.26 → 25.10.27-beta.1

package/src/services/frontend.service.mts

@@ -0,0 +1,20 @@
+import type { TServiceParams } from "@digital-alchemy/core";
+
+import type { HassFrontendService, ThemeDefinition } from "../index.mts";
+import type { HassThemeMapping } from "../user.mts";
+
+export function FrontendService({ hass, logger }: TServiceParams): HassFrontendService {
+  async function getThemes() {
+    logger.trace({ name: "getThemes" }, "fetching themes");
+    const result = await hass.socket.sendMessage<{
+      themes: Record<keyof HassThemeMapping, ThemeDefinition>;
+    }>({
+      type: "frontend/get_themes",
+    });
+    return result.themes;
+  }
+
+  return {
+    getThemes,
+  };
+}

package/src/services/index.mts

@@ -1,3 +1,4 @@
+export * from "./addon.service.mts";
 export * from "./area.service.mts";
 export * from "./backup.service.mts";
 export * from "./call-proxy.service.mts";
@@ -9,6 +10,7 @@ export * from "./events.service.mts";
 export * from "./feature.service.mts";
 export * from "./fetch-api.service.mts";
 export * from "./floor.service.mts";
+export * from "./frontend.service.mts";
 export * from "./id-by.service.mts";
 export * from "./internal.service.mts";
 export * from "./label.service.mts";

package/src/testing/addon.spec.mts

@@ -0,0 +1,65 @@
+import type { AddonDetails } from "../helpers/index.mts";
+import { hassTestRunner } from "../mock_assistant/index.mts";
+
+describe("Addon Service", () => {
+  afterEach(async () => {
+    await hassTestRunner.teardown();
+    vi.restoreAllMocks();
+  });
+
+  describe("list", () => {
+    it("should fetch addon list via supervisor API", async () => {
+      expect.assertions(2);
+      const mockAddons: AddonDetails[] = [
+        {
+          advanced: false,
+          available: true,
+          build: false,
+          description: "A test addon",
+          detached: false,
+          homeassistant: "2024.1.0",
+          icon: true,
+          logo: false,
+          name: "Test Addon",
+          repository: "test",
+          slug: "test_addon",
+          stage: "stable",
+          state: "started",
+          system_managed: false,
+          update_available: false,
+          url: "http://test.local",
+          version: "1.0.0",
+          version_latest: "1.0.0",
+        },
+      ];
+
+      await hassTestRunner.run(({ lifecycle, hass }) => {
+        const spy = vi
+          .spyOn(hass.socket, "sendMessage")
+          .mockImplementation(async () => ({ addons: mockAddons }));
+
+        lifecycle.onReady(async () => {
+          const result = await hass.addon.list();
+          expect(spy).toHaveBeenCalledWith({
+            endpoint: "/addons",
+            method: "get",
+            type: "supervisor/api",
+          });
+          expect(result).toEqual(mockAddons);
+        });
+      });
+    });
+
+    it("should return empty array when no addons are available", async () => {
+      expect.assertions(1);
+      await hassTestRunner.run(({ lifecycle, hass }) => {
+        vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => ({ addons: [] }));
+
+        lifecycle.onReady(async () => {
+          const result = await hass.addon.list();
+          expect(result).toEqual([]);
+        });
+      });
+    });
+  });
+});

package/src/testing/frontend.spec.mts

@@ -0,0 +1,66 @@
+import type { ThemeDefinition } from "../helpers/index.mts";
+import { hassTestRunner } from "../mock_assistant/index.mts";
+
+describe("Frontend Service", () => {
+  afterEach(async () => {
+    await hassTestRunner.teardown();
+    vi.restoreAllMocks();
+  });
+
+  describe("getThemes", () => {
+    it("should fetch themes and return Record of theme names to definitions", async () => {
+      expect.assertions(2);
+      const mockThemes: Record<string, ThemeDefinition> = {
+        "LCARS Default": {
+          "accent-color": "var(--lcars-orange)",
+          "card-mod-theme": "LCARS Default",
+          "divider-color": "transparent",
+          "primary-color": "var(--lcars-ui-tertiary)",
+          "sidebar-background-color": "var(--lcars-ui-primary)",
+        },
+        "Minimal Ninja": {
+          "accent-color": "#FFAB00",
+          "card-mod-theme": "Minimal Ninja",
+          "divider-color": "rgba(145, 158, 171, 0.2)",
+          modes: {
+            dark: {
+              "card-background-color": "#1C252E",
+              "primary-text-color": "#ffffff",
+            },
+            light: {
+              "card-background-color": "#ffffff",
+              "primary-text-color": "#1C252E",
+            },
+          },
+          "primary-color": "#00A76F",
+        },
+      };
+
+      await hassTestRunner.run(({ lifecycle, hass }) => {
+        const spy = vi
+          .spyOn(hass.socket, "sendMessage")
+          .mockImplementation(async () => ({ themes: mockThemes }));
+
+        lifecycle.onReady(async () => {
+          const result = await hass.frontend.getThemes();
+          expect(spy).toHaveBeenCalledWith({
+            type: "frontend/get_themes",
+          });
+          expect(result).toEqual(mockThemes);
+        });
+      });
+    });
+
+    it("should return empty object when no themes are available", async () => {
+      expect.assertions(1);
+      await hassTestRunner.run(({ lifecycle, hass }) => {
+        vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => ({ themes: {} }));
+
+        lifecycle.onReady(async () => {
+          const result = await hass.frontend.getThemes();
+          expect(result).toEqual({});
+        });
+      });
+    });
+  });
+});

package/src/user.mts

@@ -46,6 +46,10 @@ export interface HassZoneMapping {
   // "zone": true
 }
 
+export interface HassThemeMapping {
+  // "{theme_name}": true | "light" | "dark" | "light" | "dark"
+}
+
 // #MARK: extract
 export type TAreaId = UnPrefix<keyof HassAreaMapping>;
 export type TDeviceId = UnPrefix<keyof HassDeviceMapping>;