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

package/dist/services/index.mjs

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

package/dist/services/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/services/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/services/index.mts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/dist/testing/addon.spec.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/testing/addon.spec.mjs

@@ -0,0 +1,59 @@
+import { hassTestRunner } from "../mock_assistant/index.mjs";
+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 = [
+                {
+                    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([]);
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=addon.spec.mjs.map

package/dist/testing/addon.spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon.spec.mjs","sourceRoot":"","sources":["../../src/testing/addon.spec.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,cAAc,CAAC,QAAQ,EAAE,CAAC;QAChC,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,UAAU,GAAmB;gBACjC;oBACE,QAAQ,EAAE,KAAK;oBACf,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,KAAK;oBACZ,WAAW,EAAE,cAAc;oBAC3B,QAAQ,EAAE,KAAK;oBACf,aAAa,EAAE,UAAU;oBACzB,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,KAAK;oBACX,IAAI,EAAE,YAAY;oBAClB,UAAU,EAAE,MAAM;oBAClB,IAAI,EAAE,YAAY;oBAClB,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,SAAS;oBAChB,cAAc,EAAE,KAAK;oBACrB,gBAAgB,EAAE,KAAK;oBACvB,GAAG,EAAE,mBAAmB;oBACxB,OAAO,EAAE,OAAO;oBAChB,cAAc,EAAE,OAAO;iBACxB;aACF,CAAC;YAEF,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC/C,MAAM,GAAG,GAAG,EAAE;qBACX,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;qBACjC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;gBAE5D,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACvC,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC;wBAC/B,QAAQ,EAAE,SAAS;wBACnB,MAAM,EAAE,KAAK;wBACb,IAAI,EAAE,gBAAgB;qBACvB,CAAC,CAAC;oBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC/C,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;gBAEtF,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/testing/frontend.spec.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/testing/frontend.spec.mjs

@@ -0,0 +1,60 @@
+import { hassTestRunner } from "../mock_assistant/index.mjs";
+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 = {
+                "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({});
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=frontend.spec.mjs.map

package/dist/testing/frontend.spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.spec.mjs","sourceRoot":"","sources":["../../src/testing/frontend.spec.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,cAAc,CAAC,QAAQ,EAAE,CAAC;QAChC,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACnF,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,UAAU,GAAoC;gBAClD,eAAe,EAAE;oBACf,cAAc,EAAE,qBAAqB;oBACrC,gBAAgB,EAAE,eAAe;oBACjC,eAAe,EAAE,aAAa;oBAC9B,eAAe,EAAE,0BAA0B;oBAC3C,0BAA0B,EAAE,yBAAyB;iBACtD;gBACD,eAAe,EAAE;oBACf,cAAc,EAAE,SAAS;oBACzB,gBAAgB,EAAE,eAAe;oBACjC,eAAe,EAAE,0BAA0B;oBAC3C,KAAK,EAAE;wBACL,IAAI,EAAE;4BACJ,uBAAuB,EAAE,SAAS;4BAClC,oBAAoB,EAAE,SAAS;yBAChC;wBACD,KAAK,EAAE;4BACL,uBAAuB,EAAE,SAAS;4BAClC,oBAAoB,EAAE,SAAS;yBAChC;qBACF;oBACD,eAAe,EAAE,SAAS;iBAC3B;aACF,CAAC;YAEF,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC/C,MAAM,GAAG,GAAG,EAAE;qBACX,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;qBACjC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;gBAE5D,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;oBAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC;wBAC/B,IAAI,EAAE,qBAAqB;qBAC5B,CAAC,CAAC;oBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC/C,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;gBAEtF,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;oBAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;oBAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/user.d.mts

@@ -19,6 +19,8 @@ export interface iCallService {
 }
 export interface HassZoneMapping {
 }
+export interface HassThemeMapping {
+}
 export type TAreaId = UnPrefix<keyof HassAreaMapping>;
 export type TDeviceId = UnPrefix<keyof HassDeviceMapping>;
 export type TFloorId = UnPrefix<keyof HassFloorMapping>;

package/package.json

@@ -3,7 +3,7 @@
   "name": "@digital-alchemy/hass",
   "repository": "https://github.com/Digital-Alchemy-TS/hass",
   "homepage": "https://docs.digital-alchemy.app",
-  "version": "25.10.26",
+  "version": "25.10.27-beta.1",
   "description": "Typescript APIs for Home Assistant. Includes rest & websocket bindings",
   "scripts": {
     "build": "rm -rf dist/; tsc",

package/src/dev/mappings.mts

@@ -163,4 +163,33 @@ declare module "../user.mts" {
     _downstairs: "switch.kitchen_cabinets" | "switch.living_room_mood_lights";
     _upstairs: "switch.bedroom_lamp";
   }
+
+  export interface HassThemeMapping {
+    "(DO NOT USE/MODIFY)=== LCARS variables": true;
+    "(DO NOT USE/MODIFY)=== Base customizations": true;
+    "(DO NOT USE/MODIFY)=== card-mod CSS": true;
+    "LCARS Default": true;
+    "LCARS Classic": true;
+    "LCARS Nemesis Blue": true;
+    "LCARS Lower Decks I": true;
+    "LCARS Lower Decks II": true;
+    "LCARS Romulus": true;
+    "LCARS Kronos": true;
+    "LCARS Cardassia": true;
+    "LCARS Zeldaar": true;
+    "LCARS Modern": true;
+    "LCARS Picard I": true;
+    "LCARS Picard II": true;
+    "LCARS Red Alert": true;
+    "LCARS TNG": true;
+    "LCARS TNGbuttons": true;
+    "LCARS Transporter": true;
+    "LCARS Navigation": true;
+    "LCARS 25C": true;
+    "LCARS 25C (Red Alert)": true;
+    "LCARS 25C (Yellow Alert)": true;
+    "LCARS 25C (Blue Alert)": true;
+    "LCARS Breen": true;
+    "Minimal Ninja": "light" | "dark";
+  }
 }

package/src/hass.module.mts

@@ -1,6 +1,7 @@
 import { CreateLibrary } from "@digital-alchemy/core";
 
 import {
+  AddonService,
   Area,
   Backup,
   CallProxy,
@@ -11,6 +12,7 @@ import {
   FetchAPI,
   FetchInternals,
   Floor,
+  FrontendService,
   HassDiagnosticsService,
   HassFeatureService,
   IDByExtension,
@@ -150,6 +152,8 @@ export const LIB_HASS = CreateLibrary({
   // no internal dependency ones first
   priorityInit: ["internals", "fetch", "socket"],
   services: {
+    addon: AddonService,
+
     /**
      * home assistant areas
      */
@@ -205,6 +209,11 @@ export const LIB_HASS = CreateLibrary({
      */
     floor: Floor,
 
+    /**
+     * frontend interactions
+     */
+    frontend: FrontendService,
+
     /**
      * search for entity ids in a type safe way
      */

package/src/helpers/addon.mts

@@ -0,0 +1,20 @@
+export interface AddonDetails {
+  name: string;
+  slug: string;
+  description: string;
+  advanced: boolean;
+  stage: string;
+  version: string;
+  version_latest: string;
+  update_available: boolean;
+  available: boolean;
+  detached: boolean;
+  homeassistant: string;
+  state: "started" | "stopped" | "error";
+  repository: string;
+  build: boolean;
+  url: string;
+  icon: boolean;
+  logo: boolean;
+  system_managed: boolean;
+}

package/src/helpers/countries.mts

@@ -0,0 +1,255 @@
+// This is duplicated from a generated file from home assistant core
+// Will only modify this list to match what HA supports
+
+export const SUPPORTED_COUNTRIES = [
+  "AD",
+  "AE",
+  "AF",
+  "AG",
+  "AI",
+  "AL",
+  "AM",
+  "AO",
+  "AQ",
+  "AR",
+  "AS",
+  "AT",
+  "AU",
+  "AW",
+  "AX",
+  "AZ",
+  "BA",
+  "BB",
+  "BD",
+  "BE",
+  "BF",
+  "BG",
+  "BH",
+  "BI",
+  "BJ",
+  "BL",
+  "BM",
+  "BN",
+  "BO",
+  "BQ",
+  "BR",
+  "BS",
+  "BT",
+  "BV",
+  "BW",
+  "BY",
+  "BZ",
+  "CA",
+  "CC",
+  "CD",
+  "CF",
+  "CG",
+  "CH",
+  "CI",
+  "CK",
+  "CL",
+  "CM",
+  "CN",
+  "CO",
+  "CR",
+  "CU",
+  "CV",
+  "CW",
+  "CX",
+  "CY",
+  "CZ",
+  "DE",
+  "DJ",
+  "DK",
+  "DM",
+  "DO",
+  "DZ",
+  "EC",
+  "EE",
+  "EG",
+  "EH",
+  "ER",
+  "ES",
+  "ET",
+  "FI",
+  "FJ",
+  "FK",
+  "FM",
+  "FO",
+  "FR",
+  "GA",
+  "GB",
+  "GD",
+  "GE",
+  "GF",
+  "GG",
+  "GH",
+  "GI",
+  "GL",
+  "GM",
+  "GN",
+  "GP",
+  "GQ",
+  "GR",
+  "GS",
+  "GT",
+  "GU",
+  "GW",
+  "GY",
+  "HK",
+  "HM",
+  "HN",
+  "HR",
+  "HT",
+  "HU",
+  "ID",
+  "IE",
+  "IL",
+  "IM",
+  "IN",
+  "IO",
+  "IQ",
+  "IR",
+  "IS",
+  "IT",
+  "JE",
+  "JM",
+  "JO",
+  "JP",
+  "KE",
+  "KG",
+  "KH",
+  "KI",
+  "KM",
+  "KN",
+  "KP",
+  "KR",
+  "KW",
+  "KY",
+  "KZ",
+  "LA",
+  "LB",
+  "LC",
+  "LI",
+  "LK",
+  "LR",
+  "LS",
+  "LT",
+  "LU",
+  "LV",
+  "LY",
+  "MA",
+  "MC",
+  "MD",
+  "ME",
+  "MF",
+  "MG",
+  "MH",
+  "MK",
+  "ML",
+  "MM",
+  "MN",
+  "MO",
+  "MP",
+  "MQ",
+  "MR",
+  "MS",
+  "MT",
+  "MU",
+  "MV",
+  "MW",
+  "MX",
+  "MY",
+  "MZ",
+  "NA",
+  "NC",
+  "NE",
+  "NF",
+  "NG",
+  "NI",
+  "NL",
+  "NO",
+  "NP",
+  "NR",
+  "NU",
+  "NZ",
+  "OM",
+  "PA",
+  "PE",
+  "PF",
+  "PG",
+  "PH",
+  "PK",
+  "PL",
+  "PM",
+  "PN",
+  "PR",
+  "PS",
+  "PT",
+  "PW",
+  "PY",
+  "QA",
+  "RE",
+  "RO",
+  "RS",
+  "RU",
+  "RW",
+  "SA",
+  "SB",
+  "SC",
+  "SD",
+  "SE",
+  "SG",
+  "SH",
+  "SI",
+  "SJ",
+  "SK",
+  "SL",
+  "SM",
+  "SN",
+  "SO",
+  "SR",
+  "SS",
+  "ST",
+  "SV",
+  "SX",
+  "SY",
+  "SZ",
+  "TC",
+  "TD",
+  "TF",
+  "TG",
+  "TH",
+  "TJ",
+  "TK",
+  "TL",
+  "TM",
+  "TN",
+  "TO",
+  "TR",
+  "TT",
+  "TV",
+  "TW",
+  "TZ",
+  "UA",
+  "UG",
+  "UM",
+  "US",
+  "UY",
+  "UZ",
+  "VA",
+  "VC",
+  "VE",
+  "VG",
+  "VI",
+  "VN",
+  "VU",
+  "WF",
+  "WS",
+  "YE",
+  "YT",
+  "ZA",
+  "ZM",
+  "ZW",
+] as const;
+export type SupportedCountries = (typeof SUPPORTED_COUNTRIES)[number];

package/src/helpers/frontend.mts

@@ -0,0 +1,19 @@
+export interface ThemeDefinition {
+  "accent-color"?: string;
+  "app-header-background-color"?: string;
+  "app-header-edit-background-color"?: string;
+  "app-header-text-color"?: string;
+  "card-mod-root-yaml"?: string;
+  "divider-color"?: string;
+  "ha-card-border-radius"?: string;
+  "ha-card-border-width"?: string;
+  "paper-listbox-background-color"?: string;
+  "primary-color"?: string;
+  "sidebar-background-color"?: string;
+  "sidebar-menu-button-background-color"?: string;
+  modes?: {
+    light?: Record<string, unknown>;
+    dark?: Record<string, unknown>;
+  };
+  [key: string]: unknown;
+}

package/src/helpers/index.mts

@@ -1,12 +1,16 @@
+export * from "./addon.mts";
 export * from "./backup.mts";
 export * from "./constants.mts";
+export * from "./countries.mts";
 export * from "./device.mts";
 export * from "./entity-state.mts";
 export * from "./features.mts";
 export * from "./fetch.mts";
 export * from "./fetch/index.mts";
+export * from "./frontend.mts";
 export * from "./id-by.mts";
 export * from "./interfaces.mts";
+export * from "./languages.mts";
 export * from "./notify.mts";
 export * from "./registry.mts";
 export * from "./supported-features.mts";

package/src/helpers/interfaces.mts

@@ -3,9 +3,11 @@ import type EventEmitter from "events";
 import type { EmptyObject } from "type-fest";
 import type WS from "ws";
 
+import type { AddonDetails, ThemeDefinition } from "../index.mts";
 import type {
   ALL_DOMAINS,
   ANY_ENTITY,
+  HassThemeMapping,
   HassUniqueIdMapping,
   iCallService,
   PICK_ENTITY,
@@ -49,6 +51,14 @@ import type {
   SocketSubscribeOptions,
 } from "./websocket.mts";
 
+export type HassAddonService = {
+  list: () => Promise<AddonDetails[]>;
+};
+
+export type HassFrontendService = {
+  getThemes: () => Promise<Record<keyof HassThemeMapping, ThemeDefinition>>;
+};
+
 export type HassAreaService = {
   apply: (
     area: TAreaId,

package/src/helpers/languages.mts

@@ -0,0 +1,67 @@
+export const SUPPORTED_LANGUAGES = [
+  "af",
+  "ar",
+  "bg",
+  "bn",
+  "bs",
+  "ca",
+  "cs",
+  "cy",
+  "da",
+  "de",
+  "el",
+  "en",
+  "en-GB",
+  "eo",
+  "es",
+  "es-419",
+  "et",
+  "eu",
+  "fa",
+  "fi",
+  "fr",
+  "fy",
+  "ga",
+  "gl",
+  "gsw",
+  "he",
+  "hi",
+  "hr",
+  "hu",
+  "hy",
+  "id",
+  "is",
+  "it",
+  "ja",
+  "ka",
+  "ko",
+  "lb",
+  "lt",
+  "lv",
+  "mk",
+  "ml",
+  "nb",
+  "nl",
+  "nn",
+  "pl",
+  "pt",
+  "pt-BR",
+  "ro",
+  "ru",
+  "sk",
+  "sl",
+  "sq",
+  "sr",
+  "sr-Latn",
+  "sv",
+  "ta",
+  "te",
+  "th",
+  "tr",
+  "uk",
+  "ur",
+  "vi",
+  "zh-Hans",
+  "zh-Hant",
+];
+export type SupportedLanguages = (typeof SUPPORTED_LANGUAGES)[number];

package/src/services/addon.service.mts

@@ -0,0 +1,19 @@
+import type { TServiceParams } from "@digital-alchemy/core";
+
+import type { AddonDetails, HassAddonService } from "../index.mts";
+
+export function AddonService({ hass, logger }: TServiceParams): HassAddonService {
+  async function list() {
+    logger.trace({ name: "list" }, "fetching addon list");
+    const { addons } = await hass.socket.sendMessage<{ addons: AddonDetails[] }>({
+      endpoint: "/addons",
+      method: "get",
+      type: "supervisor/api",
+    });
+    return addons;
+  }
+
+  return {
+    list,
+  };
+}