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

package/dist/dev/mappings.d.mts

@@ -86,5 +86,33 @@ declare module "../user.mts" {
         _downstairs: "switch.kitchen_cabinets" | "switch.living_room_mood_lights";
         _upstairs: "switch.bedroom_lamp";
     }
+    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";
+    }
 }
 export {};

package/dist/hass.module.d.mts

@@ -1,4 +1,4 @@
-import { AddonService, Area, Backup, CallProxy, Configure, Device, EntityManager, EventsService, FetchAPI, FetchInternals, Floor, HassDiagnosticsService, HassFeatureService, IDByExtension, Label, ReferenceService, Registry, WebsocketAPI, Zone } from "./services/index.mts";
+import { AddonService, Area, Backup, CallProxy, Configure, Device, EntityManager, EventsService, FetchAPI, FetchInternals, Floor, FrontendService, HassDiagnosticsService, HassFeatureService, IDByExtension, Label, ReferenceService, Registry, WebsocketAPI, Zone } from "./services/index.mts";
 export declare const LIB_HASS: import("@digital-alchemy/core").LibraryDefinition<{
     addon: typeof AddonService;
     /**
@@ -45,6 +45,10 @@ export declare const LIB_HASS: import("@digital-alchemy/core").LibraryDefinition
      * floors, like groups of areas
      */
     floor: typeof Floor;
+    /**
+     * frontend interactions
+     */
+    frontend: typeof FrontendService;
     /**
      * search for entity ids in a type safe way
      */

package/dist/hass.module.mjs

@@ -1,5 +1,5 @@
 import { CreateLibrary } from "@digital-alchemy/core";
-import { AddonService, Area, Backup, CallProxy, Configure, Device, EntityManager, EventsService, FetchAPI, FetchInternals, Floor, HassDiagnosticsService, HassFeatureService, IDByExtension, Label, ReferenceService, Registry, WebsocketAPI, Zone, } from "./services/index.mjs";
+import { AddonService, Area, Backup, CallProxy, Configure, Device, EntityManager, EventsService, FetchAPI, FetchInternals, Floor, FrontendService, HassDiagnosticsService, HassFeatureService, IDByExtension, Label, ReferenceService, Registry, WebsocketAPI, Zone, } from "./services/index.mjs";
 export const LIB_HASS = CreateLibrary({
     configuration: {
         /**
@@ -160,6 +160,10 @@ export const LIB_HASS = CreateLibrary({
          * floors, like groups of areas
          */
         floor: Floor,
+        /**
+         * frontend interactions
+         */
+        frontend: FrontendService,
         /**
          * search for entity ids in a type safe way
          */

package/dist/hass.module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hass.module.mjs","sourceRoot":"","sources":["../src/hass.module.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hass.module.mjs","sourceRoot":"","sources":["../src/hass.module.mts"],"names":[],"mappings":"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"}

package/dist/helpers/frontend.d.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/dist/helpers/frontend.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frontend.mjs.map

package/dist/helpers/frontend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.mjs","sourceRoot":"","sources":["../../src/helpers/frontend.mts"],"names":[],"mappings":""}

package/dist/helpers/index.d.mts

@@ -7,6 +7,7 @@ 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";

package/dist/helpers/index.mjs

@@ -7,6 +7,7 @@ export * from "./entity-state.mjs";
 export * from "./features.mjs";
 export * from "./fetch.mjs";
 export * from "./fetch/index.mjs";
+export * from "./frontend.mjs";
 export * from "./id-by.mjs";
 export * from "./interfaces.mjs";
 export * from "./languages.mjs";

package/dist/helpers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/helpers/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/helpers/index.mts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/helpers/interfaces.d.mts

@@ -2,8 +2,8 @@ import type { RemoveCallback, TBlackHole } from "@digital-alchemy/core";
 import type EventEmitter from "events";
 import type { EmptyObject } from "type-fest";
 import type WS from "ws";
-import type { AddonDetails } from "../index.mts";
-import type { ALL_DOMAINS, ANY_ENTITY, HassUniqueIdMapping, iCallService, PICK_ENTITY, PICK_FROM_AREA, PICK_FROM_DEVICE, PICK_FROM_FLOOR, PICK_FROM_LABEL, PICK_FROM_PLATFORM, TAreaId, TDeviceId, TFloorId, TLabelId, TPlatformId, TRawDomains, TRawEntityIds, TUniqueId } from "../user.mts";
+import type { AddonDetails, ThemeDefinition } from "../index.mts";
+import type { ALL_DOMAINS, ANY_ENTITY, HassThemeMapping, HassUniqueIdMapping, iCallService, PICK_ENTITY, PICK_FROM_AREA, PICK_FROM_DEVICE, PICK_FROM_FLOOR, PICK_FROM_LABEL, PICK_FROM_PLATFORM, TAreaId, TDeviceId, TFloorId, TLabelId, TPlatformId, TRawDomains, TRawEntityIds, TUniqueId } from "../user.mts";
 import type { BackupResponse, HomeAssistantBackup } from "./backup.mts";
 import type { DeviceDetails } from "./device.mts";
 import type { ByIdProxy } from "./entity-state.mts";
@@ -14,6 +14,9 @@ import type { EntityHistoryDTO, EntityHistoryResult, OnHassEventOptions, SocketS
 export type HassAddonService = {
     list: () => Promise<AddonDetails[]>;
 };
+export type HassFrontendService = {
+    getThemes: () => Promise<Record<keyof HassThemeMapping, ThemeDefinition>>;
+};
 export type HassAreaService = {
     apply: (area: TAreaId, entities: ANY_ENTITY[]) => Promise<{
         updated: ANY_ENTITY[];

package/dist/helpers/interfaces.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.mjs","sourceRoot":"","sources":["../../src/helpers/interfaces.mts"],"names":[],"mappings":"AAwMA,wDAAwD;AACxD,MAAM,CAAN,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAClC,6EAAW,CAAA;IACX,mFAAc,CAAA;IACd,iFAAa,CAAA;IACb,6EAAW,CAAA;IACX,6EAAW,CAAA;AACb,CAAC,EANW,wBAAwB,KAAxB,wBAAwB,QAMnC"}
+{"version":3,"file":"interfaces.mjs","sourceRoot":"","sources":["../../src/helpers/interfaces.mts"],"names":[],"mappings":"AA6MA,wDAAwD;AACxD,MAAM,CAAN,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAClC,6EAAW,CAAA;IACX,mFAAc,CAAA;IACd,iFAAa,CAAA;IACb,6EAAW,CAAA;IACX,6EAAW,CAAA;AACb,CAAC,EANW,wBAAwB,KAAxB,wBAAwB,QAMnC"}

package/dist/mock_assistant/mock-assistant.module.d.mts

@@ -52,6 +52,7 @@ export declare const createTestRunner: () => import("@digital-alchemy/core").iTe
     feature: typeof import("../index.mts").HassFeatureService;
     fetch: typeof import("../index.mts").FetchAPI;
     floor: typeof import("../index.mts").Floor;
+    frontend: typeof import("../index.mts").FrontendService;
     idBy: typeof import("../index.mts").IDByExtension;
     internals: typeof import("../index.mts").FetchInternals;
     label: typeof import("../index.mts").Label;
@@ -129,6 +130,7 @@ export declare const hassTestRunner: import("@digital-alchemy/core").iTestRunner
     feature: typeof import("../index.mts").HassFeatureService;
     fetch: typeof import("../index.mts").FetchAPI;
     floor: typeof import("../index.mts").Floor;
+    frontend: typeof import("../index.mts").FrontendService;
     idBy: typeof import("../index.mts").IDByExtension;
     internals: typeof import("../index.mts").FetchInternals;
     label: typeof import("../index.mts").Label;

package/dist/services/addon.service.mjs

@@ -1,11 +1,12 @@
 export function AddonService({ hass, logger }) {
     async function list() {
         logger.trace({ name: "list" }, "fetching addon list");
-        return await hass.socket.sendMessage({
+        const { addons } = await hass.socket.sendMessage({
             endpoint: "/addons",
             method: "get",
             type: "supervisor/api",
         });
+        return addons;
     }
     return {
         list,

package/dist/services/addon.service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"addon.service.mjs","sourceRoot":"","sources":["../../src/services/addon.service.mts"],"names":[],"mappings":"AAIA,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAkB;IAC3D,KAAK,UAAU,IAAI;QACjB,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;QACtD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAiB;YACnD,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"addon.service.mjs","sourceRoot":"","sources":["../../src/services/addon.service.mts"],"names":[],"mappings":"AAIA,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAkB;IAC3D,KAAK,UAAU,IAAI;QACjB,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAA6B;YAC3E,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/services/frontend.service.d.mts

@@ -0,0 +1,3 @@
+import type { TServiceParams } from "@digital-alchemy/core";
+import type { HassFrontendService } from "../index.mts";
+export declare function FrontendService({ hass, logger }: TServiceParams): HassFrontendService;

package/dist/services/frontend.service.mjs

@@ -0,0 +1,13 @@
+export function FrontendService({ hass, logger }) {
+    async function getThemes() {
+        logger.trace({ name: "getThemes" }, "fetching themes");
+        const result = await hass.socket.sendMessage({
+            type: "frontend/get_themes",
+        });
+        return result.themes;
+    }
+    return {
+        getThemes,
+    };
+}
+//# sourceMappingURL=frontend.service.mjs.map

package/dist/services/frontend.service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.service.mjs","sourceRoot":"","sources":["../../src/services/frontend.service.mts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAkB;IAC9D,KAAK,UAAU,SAAS;QACtB,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAEzC;YACD,IAAI,EAAE,qBAAqB;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO;QACL,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/services/index.d.mts

@@ -10,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/dist/services/index.mjs

@@ -10,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,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,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.mjs

@@ -30,7 +30,9 @@ describe("Addon Service", () => {
                 },
             ];
             await hassTestRunner.run(({ lifecycle, hass }) => {
-                const spy = vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => mockAddons);
+                const spy = vi
+                    .spyOn(hass.socket, "sendMessage")
+                    .mockImplementation(async () => ({ addons: mockAddons }));
                 lifecycle.onReady(async () => {
                     const result = await hass.addon.list();
                     expect(spy).toHaveBeenCalledWith({
@@ -45,7 +47,7 @@ describe("Addon Service", () => {
         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 () => []);
+                vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => ({ addons: [] }));
                 lifecycle.onReady(async () => {
                     const result = await hass.addon.list();
                     expect(result).toEqual([]);

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

@@ -1 +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,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC;gBAE5F,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,EAAE,CAAC,CAAC;gBAExE,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"}
+{"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.27-beta.0",
+  "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

@@ -12,6 +12,7 @@ import {
   FetchAPI,
   FetchInternals,
   Floor,
+  FrontendService,
   HassDiagnosticsService,
   HassFeatureService,
   IDByExtension,
@@ -208,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/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

@@ -7,6 +7,7 @@ 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";

package/src/helpers/interfaces.mts

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

package/src/services/addon.service.mts

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

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

@@ -10,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

@@ -34,7 +34,9 @@ describe("Addon Service", () => {
       ];
 
       await hassTestRunner.run(({ lifecycle, hass }) => {
-        const spy = vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => mockAddons);
+        const spy = vi
+          .spyOn(hass.socket, "sendMessage")
+          .mockImplementation(async () => ({ addons: mockAddons }));
 
         lifecycle.onReady(async () => {
           const result = await hass.addon.list();
@@ -51,7 +53,7 @@ describe("Addon Service", () => {
     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 () => []);
+        vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => ({ addons: [] }));
 
         lifecycle.onReady(async () => {
           const result = await hass.addon.list();

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>;