@digital-alchemy/hass 25.3.2 → 25.5.2

package/dist/testing/zone.spec.mjs

@@ -1,3 +1,4 @@
+import { subscribe } from "node:diagnostics_channel";
 import { sleep } from "@digital-alchemy/core";
 import { ZONE_REGISTRY_UPDATED } from "../helpers/index.mjs";
 import { hassTestRunner } from "../mock_assistant/index.mjs";
@@ -7,11 +8,13 @@ describe("Zone", () => {
         vi.restoreAllMocks();
     });
     const EXAMPLE_ZONE = {
-        icon: "",
-        latitude: 0,
-        longitude: 0,
-        name: "Test",
-        passive: true,
+        icon: "mdi:map-marker",
+        id: "test",
+        latitude: 37.7749,
+        longitude: -122.4194,
+        name: "Example Zone",
+        passive: false,
+        radius: 100,
     };
     describe("Lifecycle", () => {
         it("should force values to be available before ready", async () => {
@@ -55,6 +58,22 @@ describe("Zone", () => {
                     });
                 });
             });
+            it("should publish diagnostics on zone registry update", async () => {
+                expect.assertions(1);
+                hassTestRunner.configure({ hass: { EMIT_DIAGNOSTICS: true } });
+                await hassTestRunner.run(({ lifecycle, hass }) => {
+                    vi.spyOn(hass.socket, "sendMessage").mockImplementation(async () => undefined);
+                    const spy = vi.fn();
+                    subscribe(hass.diagnostics.zone.registry_update.name, spy);
+                    lifecycle.onReady(async () => {
+                        setImmediate(async () => {
+                            hass.socket.socketEvents.emit("zone_registry_updated");
+                        });
+                        await sleep(100);
+                        expect(spy).toHaveBeenCalledWith(expect.objectContaining({ ms: expect.any(Number) }), hass.diagnostics.zone.registry_update.name);
+                    });
+                });
+            });
         });
         describe("Order of operations", () => {
             it("should debounce updates properly", async () => {

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

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

package/package.json

@@ -3,12 +3,13 @@
   "name": "@digital-alchemy/hass",
   "repository": "https://github.com/Digital-Alchemy-TS/hass",
   "homepage": "https://docs.digital-alchemy.app",
-  "version": "25.3.2",
+  "version": "25.5.2",
   "description": "Typescript APIs for Home Assistant. Includes rest & websocket bindings",
   "scripts": {
     "build": "rm -rf dist/; tsc",
     "lint": "eslint src",
     "test": "vitest",
+    "test:coverage": "vitest run --coverage",
     "prepublishOnly": "tsc --project ./tsconfig.lib.json",
     "upgrade": "yarn up '@digital-alchemy/*'"
   },
@@ -57,50 +58,53 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@cspell/eslint-plugin": "^8.17.5",
-    "@digital-alchemy/core": "^25.2.2",
-    "@digital-alchemy/synapse": "^25.2.1",
-    "@digital-alchemy/type-writer": "^25.2.1",
-    "@eslint/compat": "^1.2.7",
-    "@eslint/eslintrc": "^3.3.0",
-    "@eslint/js": "^9.22.0",
-    "@faker-js/faker": "^9.6.0",
+    "@cspell/eslint-plugin": "^9.0.2",
+    "@digital-alchemy/core": "^25.5.2",
+    "@digital-alchemy/synapse": "^25.3.1",
+    "@digital-alchemy/type-writer": "^25.5.1",
+    "@eslint/compat": "^1.2.9",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.28.0",
+    "@faker-js/faker": "^9.8.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.13.10",
+    "@types/node": "^22.15.29",
     "@types/node-cron": "^3.0.11",
-    "@types/semver": "^7.5.8",
-    "@types/ws": "^8.18.0",
-    "@typescript-eslint/eslint-plugin": "8.27.0",
-    "@typescript-eslint/parser": "8.27.0",
+    "@types/semver": "^7.7.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "8.33.0",
+    "@typescript-eslint/parser": "8.33.0",
+    "@vitest/coverage-v8": "^3.1.4",
     "dayjs": "^1.11.13",
-    "dotenv": "^16.4.7",
-    "eslint": "9.23.0",
-    "eslint-config-prettier": "10.1.1",
+    "dotenv": "^16.5.0",
+    "eslint": "9.28.0",
+    "eslint-config-prettier": "10.1.5",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsonc": "^2.19.1",
+    "eslint-plugin-jsonc": "^2.20.1",
     "eslint-plugin-no-unsanitized": "^4.1.2",
-    "eslint-plugin-prettier": "^5.2.3",
+    "eslint-plugin-prettier": "^5.4.1",
     "eslint-plugin-security": "^3.0.1",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-sonarjs": "^3.0.2",
     "eslint-plugin-sort-keys-fix": "^1.1.2",
-    "eslint-plugin-unicorn": "^58.0.0",
-    "node-cron": "^3.0.3",
+    "eslint-plugin-unicorn": "^59.0.1",
+    "node-cron": "^4.1.0",
     "prettier": "^3.5.3",
-    "semver": "^7.7.1",
-    "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "semver": "^7.7.2",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
     "uuid": "^11.1.0",
-    "vitest": "^3.0.8",
-    "ws": "^8.18.1"
+    "vitest": "^3.1.4",
+    "ws": "^8.18.2"
+  },
+  "peerDependencies": {
+    "@digital-alchemy/core": "^25.5.1"
   },
   "dependencies": {
-    "@digital-alchemy/core": "^25.2.2",
     "dayjs": "^1.11.13",
-    "semver": "^7.7.1",
-    "type-fest": "^4.37.0",
+    "semver": "^7.7.2",
+    "type-fest": "^4.41.0",
     "uuid": "^11.1.0",
-    "ws": "^8.18.1"
+    "ws": "^8.18.2"
   },
-  "packageManager": "yarn@4.7.0"
+  "packageManager": "yarn@4.9.1"
 }

package/src/hass.module.mts

@@ -11,6 +11,7 @@ import {
   FetchAPI,
   FetchInternals,
   Floor,
+  HassDiagnosticsService,
   IDByExtension,
   Label,
   ReferenceService,
@@ -32,6 +33,18 @@ export const LIB_HASS = CreateLibrary({
       type: "string",
     },
 
+    /**
+     * Setting this to true will tell hass.diagnostics to create the related channels & start emitting
+     */
+    EMIT_DIAGNOSTICS: {
+      default: false,
+      description: [
+        "Enable the creation of diagnostics channels",
+        "Value read at bootstrap, cannot be set by env or at runtime",
+      ],
+      type: "boolean",
+    },
+
     /**
      * When adding new integrations, app will receive 1 update event for everything that changes.
      * This can result in a flood of updates where only a single one is needed at the very end.
@@ -58,6 +71,17 @@ export const LIB_HASS = CreateLibrary({
       type: "number",
     },
 
+    /**
+     * This is reflected in type-writer, make sure to keep your runtime & types in sync
+     *
+     * By default disabled entities are removed to help keep file bloat down
+     */
+    FILTER_DISABLED_ENTITIES_ID_BY: {
+      default: true,
+      description: "Filter events from disabled entities in id",
+      type: "boolean",
+    },
+
     /**
      * General purpose variable, adds delays to things when retrying
      *
@@ -150,6 +174,11 @@ export const LIB_HASS = CreateLibrary({
      */
     device: Device,
 
+    /**
+     *
+     */
+    diagnostics: HassDiagnosticsService,
+
     /**
      * retrieve and interact with home assistant entities
      */

package/src/helpers/fetch.mts

@@ -129,7 +129,7 @@ export type FilterValueType = string | boolean | number | Date | RegExp | Record
  */
 export enum FILTER_OPERATIONS {
   // "elemMatch" functionality in mongo
-  // eslint-disable-next-line unicorn/prevent-abbreviations
+
   elem = "elem",
   regex = "regex",
   in = "in",

package/src/helpers/utility.mts

@@ -98,3 +98,8 @@ export const PostConfigPriorities = {
   FETCH: 1,
   VALIDATE: -1,
 } as const;
+
+export const perf = () => {
+  const start = performance.now();
+  return () => performance.now() - start;
+};

package/src/services/area.service.mts

@@ -7,6 +7,7 @@ import {
   EARLY_ON_READY,
   ENTITY_REGISTRY_UPDATED,
   HassAreaService,
+  perf,
 } from "../index.mts";
 import { ANY_ENTITY, TAreaId } from "../user.mts";
 
@@ -30,10 +31,12 @@ export function Area({
       context,
       event_type: "area_registry_updated",
       async exec() {
+        const ms = perf();
         await debounce(AREA_REGISTRY_UPDATED, config.hass.EVENT_DEBOUNCE_MS);
         hass.area.current = await hass.area.list();
         logger.debug(`area registry updated`);
         event.emit(AREA_REGISTRY_UPDATED);
+        hass.diagnostics.area?.registry_update.publish({ ms: ms() });
       },
     });
   });
@@ -44,6 +47,12 @@ export function Area({
     });
   }
 
+  /**
+   * 1. emit delete message
+   * 2. hass does stuff internally
+   * 3. hass emits update message
+   * 4. promise resolves
+   */
   async function deleteArea(area_id: TAreaId) {
     return await new Promise<void>(async done => {
       event.once(AREA_REGISTRY_UPDATED, done);

package/src/services/call-proxy.service.mts

@@ -1,6 +1,11 @@
 import { TServiceParams } from "@digital-alchemy/core";
 
-import { ALL_SERVICE_DOMAINS, PICK_SERVICE, PICK_SERVICE_PARAMETERS } from "../helpers/index.mts";
+import {
+  ALL_SERVICE_DOMAINS,
+  perf,
+  PICK_SERVICE,
+  PICK_SERVICE_PARAMETERS,
+} from "../helpers/index.mts";
 import { iCallService } from "../user.mts";
 
 export function CallProxy({
@@ -49,6 +54,7 @@ export function CallProxy({
       );
       logger.trace({ name: loadServiceList, services }, `loaded domain [%s]`, value.domain);
     });
+    hass.diagnostics.call?.reload.publish({});
   }
 
   /**
@@ -69,19 +75,20 @@ export function CallProxy({
     const [domain, service] = serviceName.split(".");
     // User can just not await this call if they don't care about the "waitForChange"
 
+    const ms = perf();
     if (!return_response) {
-      return await hass.socket.sendMessage(
-        { domain, service, service_data, type: "call_service" },
-        true,
-      );
+      const payload = { domain, service, service_data, type: "call_service" };
+      const out = await hass.socket.sendMessage(payload, true);
+      hass.diagnostics.call?.fast.publish({ ms: ms(), payload });
+      return out;
     }
-    const result = (await hass.socket.sendMessage(
-      { domain, return_response, service, service_data, type: "call_service" },
-      true,
-    )) as { response: unknown };
+
+    const payload = { domain, return_response, service, service_data, type: "call_service" };
+    const result = (await hass.socket.sendMessage(payload, true)) as { response: unknown };
     if (!result?.response) {
       logger.warn({ result }, `{%s}.{%s} did not return a response`, domain, service);
     }
+    hass.diagnostics.call?.response.publish({ ms: ms(), payload, result });
     return result?.response;
   }
 

package/src/services/config.service.mts

@@ -24,6 +24,9 @@ export function Configure({
   internal,
 }: TServiceParams): HassConfigService {
   const { is } = internal.utils;
+  let checkedServices = new Map<string, boolean>();
+  let services: HassServiceDTO[];
+
   lifecycle.onPreInit(() => {
     // HASSIO_TOKEN provided by home assistant to addons
     // SUPERVISOR_TOKEN used as alias elsewhere
@@ -70,7 +73,6 @@ export function Configure({
     }
   }, PostConfigPriorities.VALIDATE);
 
-  let services: HassServiceDTO[];
   async function loadServiceList(recursion = START): Promise<void> {
     logger.debug({ name: loadServiceList }, `fetching service list`);
     services = await hass.fetch.listServices();
@@ -85,28 +87,31 @@ export function Configure({
         recursion,
         MAX_ATTEMPTS,
       );
+      hass.diagnostics.config?.load_services_failure.publish({ recursion });
       await sleep(config.hass.RETRY_INTERVAL * SECOND);
       await loadServiceList(recursion + INCREMENT);
-    } else {
-      event.emit(SERVICE_LIST_UPDATED, services);
-      checkedServices = new Map();
+      return;
     }
+    event.emit(SERVICE_LIST_UPDATED, services);
+    checkedServices = new Map();
+    hass.diagnostics.config?.service_list_updated.publish({ recursion });
+  }
+
+  function isService<DOMAIN extends ALL_SERVICE_DOMAINS>(
+    domain: DOMAIN,
+    service: string,
+  ): service is Extract<keyof iCallService[DOMAIN], string> {
+    if (checkedServices.has(service)) {
+      return checkedServices.get(service);
+    }
+    const exists = services.some(i => i.domain === domain && !is.undefined(i.services[service]));
+    checkedServices.set(service, exists);
+    return exists;
   }
-  let checkedServices = new Map<string, boolean>();
 
   return {
     getServices: () => services,
-    isService: <DOMAIN extends ALL_SERVICE_DOMAINS>(
-      domain: DOMAIN,
-      service: string,
-    ): service is Extract<keyof iCallService[DOMAIN], string> => {
-      if (checkedServices.has(service)) {
-        return checkedServices.get(service);
-      }
-      const exists = services.some(i => i.domain === domain && !is.undefined(i.services[service]));
-      checkedServices.set(service, exists);
-      return exists;
-    },
+    isService,
     loadServiceList,
   };
 }

package/src/services/device.service.mts

@@ -5,6 +5,7 @@ import {
   DeviceDetails,
   EARLY_ON_READY,
   HassDeviceService,
+  perf,
 } from "../helpers/index.mts";
 
 export function Device({
@@ -28,10 +29,12 @@ export function Device({
       context,
       event_type: "device_registry_updated",
       async exec() {
+        const ms = perf();
         await debounce(DEVICE_REGISTRY_UPDATED, config.hass.EVENT_DEBOUNCE_MS);
         hass.device.current = await hass.device.list();
         logger.debug(`device registry updated`);
         event.emit(DEVICE_REGISTRY_UPDATED);
+        hass.diagnostics.device?.registry_update.publish({ ms: ms() });
       },
     });
   });

package/src/services/diagnostics.service.mts

@@ -0,0 +1,45 @@
+import { TServiceParams } from "@digital-alchemy/core";
+import { channel } from "diagnostics_channel";
+
+function createDiagnostics<CHANNEL extends string>(context: string, channels: CHANNEL[]) {
+  return Object.fromEntries(channels.map(i => [i, channel(`hass:${context}:${i}`)])) as Record<
+    CHANNEL,
+    ReturnType<typeof channel>
+  >;
+}
+export function HassDiagnosticsService({ config, logger }: TServiceParams) {
+  if (!config.hass.EMIT_DIAGNOSTICS) {
+    logger.debug("skipping diagnostics channel creation");
+    return {};
+  }
+  logger.info("creating diagnostics channels");
+  return {
+    area: createDiagnostics("area", ["registry_update"]),
+    call: createDiagnostics("call", ["fast", "response", "reload"]),
+    config: createDiagnostics("config", ["service_list_updated", "load_services_failure"]),
+    device: createDiagnostics("device", ["registry_update"]),
+    entity: createDiagnostics("entity", [
+      "warn_ready",
+      "history_lookup",
+      "refresh_entities",
+      "entity_updated",
+      "registry_updated",
+      "entity_remove",
+      "entity_add",
+    ]),
+    fetch: createDiagnostics("fetch", ["fetch"]),
+    floor: createDiagnostics("floor", ["registry_update"]),
+    label: createDiagnostics("label", ["registry_update"]),
+    reference: createDiagnostics("reference", ["create_proxy", "get_property", "call_service"]),
+    websocket: createDiagnostics("websocket", [
+      "fire_event",
+      "message_received",
+      "missed_reply",
+      "send_message",
+      "failed_ping",
+      "send_ping",
+      "set_connection_state",
+    ]),
+    zone: createDiagnostics("zone", ["registry_update"]),
+  };
+}

package/src/services/entity.service.mts

@@ -19,6 +19,7 @@ import {
   EntityHistoryResult,
   EntityRegistryItem,
   HassEntityManager,
+  perf,
   TMasterState,
 } from "../index.mts";
 import { ALL_DOMAINS, ANY_ENTITY, PICK_ENTITY } from "../user.mts";
@@ -44,6 +45,7 @@ export function EntityManager({
   const PREVIOUS_STATE = new Map<ANY_ENTITY, ENTITY_STATE<ANY_ENTITY>>();
   let lastRefresh: Dayjs;
   function warnEarly(method: string) {
+    hass.diagnostics.entity?.warn_ready.publish({ method });
     if (!init) {
       lifecycle.onReady(() => {
         if (config.boilerplate.LOG_LEVEL !== "trace") {
@@ -76,12 +78,14 @@ export function EntityManager({
     payload: Omit<EntityHistoryDTO<ENTITES>, "type">,
   ) {
     logger.trace({ payload }, `looking up entity history`);
+    const ms = perf();
     const result = (await hass.socket.sendMessage({
       ...payload,
       end_time: dayjs(payload.end_time).toISOString(),
       start_time: dayjs(payload.start_time).toISOString(),
       type: "history/history_during_period",
     })) as Record<ANY_ENTITY, EntityHistoryItem[]>;
+    hass.diagnostics.entity?.history_lookup.publish({ ms: ms(), payload, result });
 
     const entities = Object.keys(result) as ANY_ENTITY[];
     return Object.fromEntries(
@@ -191,6 +195,7 @@ export function EntityManager({
             internal.utils.object.get(oldState, entity.entity_id),
           ),
       );
+      hass.diagnostics.entity?.refresh_entities.publish({ emitUpdates });
     });
     init = true;
   }
@@ -201,6 +206,7 @@ export function EntityManager({
     new_state: ENTITY_STATE<ENTITY>,
     old_state: ENTITY_STATE<ENTITY>,
   ) {
+    hass.diagnostics.entity?.entity_updated.publish({ entity_id, new_state, old_state });
     PREVIOUS_STATE.set(entity_id, old_state);
     if (new_state === null) {
       logger.warn(
@@ -209,8 +215,12 @@ export function EntityManager({
         entity_id,
       );
       internal.utils.object.del(MASTER_STATE, entity_id);
+      hass.diagnostics.entity?.entity_remove.publish({ entity_id });
       return;
     }
+    if (old_state === null) {
+      hass.diagnostics.entity?.entity_add.publish({ entity_id });
+    }
     internal.utils.object.set(MASTER_STATE, entity_id, new_state);
     if (!hass.socket.pauseMessages) {
       event.emit(entity_id, new_state, old_state);
@@ -293,10 +303,12 @@ export function EntityManager({
       context,
       event_type: "entity_registry_updated",
       async exec() {
+        const ms = perf();
         await debounce(ENTITY_REGISTRY_UPDATED, config.hass.EVENT_DEBOUNCE_MS);
         logger.debug("entity registry updated");
         hass.entity.registry.current = await hass.entity.registry.list();
         event.emit(ENTITY_REGISTRY_UPDATED);
+        hass.diagnostics.entity?.registry_updated.publish({ ms: ms() });
       },
     });
     hass.entity.registry.current = await hass.entity.registry.list();

package/src/services/fetch-api.service.mts

@@ -13,6 +13,7 @@ import {
   HassConfig,
   HassServiceDTO,
   HomeAssistantServerLogItem,
+  perf,
   PICK_SERVICE,
   PICK_SERVICE_PARAMETERS,
   PostConfigPriorities,
@@ -253,6 +254,15 @@ export function FetchAPI({
     });
   }
 
+  async function fetch<T, BODY extends TFetchBody = undefined>(
+    options: Partial<FetchArguments<BODY>>,
+  ) {
+    const ms = perf();
+    const out = await fetcher.exec<T, BODY>(options);
+    hass.diagnostics.fetch?.fetch.publish({ ms: ms(), options, out });
+    return out;
+  }
+
   return {
     _fetcher: fetcher,
     calendarSearch,
@@ -260,8 +270,7 @@ export function FetchAPI({
     checkConfig,
     checkCredentials,
     download,
-    fetch: async <T, BODY extends TFetchBody = undefined>(options: Partial<FetchArguments<BODY>>) =>
-      await fetcher.exec<T, BODY>(options),
+    fetch,
     fetchEntityCustomizations,
     fetchEntityHistory,
     fireEvent,

package/src/services/floor.service.mts

@@ -6,6 +6,7 @@ import {
   FloorCreate,
   FloorDetails,
   HassFloorService,
+  perf,
 } from "../helpers/index.mts";
 import { TFloorId } from "../user.mts";
 
@@ -29,10 +30,12 @@ export function Floor({
       context,
       event_type: "floor_registry_updated",
       async exec() {
+        const ms = perf();
         await debounce(FLOOR_REGISTRY_UPDATED, config.hass.EVENT_DEBOUNCE_MS);
         hass.floor.current = await hass.floor.list();
         logger.debug(`floor registry updated`);
         event.emit(FLOOR_REGISTRY_UPDATED);
+        hass.diagnostics.floor?.registry_update.publish({ ms: ms() });
       },
     });
   });