@digital-alchemy/hass 25.2.2 → 25.3.1

package/package.json

@@ -3,13 +3,13 @@
   "name": "@digital-alchemy/hass",
   "repository": "https://github.com/Digital-Alchemy-TS/hass",
   "homepage": "https://docs.digital-alchemy.app",
-  "version": "25.2.2",
+  "version": "25.3.1",
   "description": "Typescript APIs for Home Assistant. Includes rest & websocket bindings",
   "scripts": {
     "build": "rm -rf dist/; tsc",
     "lint": "eslint src",
     "test": "vitest",
-    "prepublishOnly": "yarn build",
+    "prepublishOnly": "tsc --project ./tsconfig.lib.json",
     "upgrade": "yarn up '@digital-alchemy/*'"
   },
   "bugs": {
@@ -52,7 +52,8 @@
   },
   "exports": {
     ".": "./dist/index.mjs",
-    "./mock-assistant": "./dist/mock_assistant/index.mjs"
+    "./mock-assistant": "./dist/mock_assistant/index.mjs",
+    "./dev-types": "./dist/dev/index.mjs"
   },
   "license": "MIT",
   "devDependencies": {
@@ -62,19 +63,19 @@
     "@digital-alchemy/type-writer": "^25.2.1",
     "@eslint/compat": "^1.2.7",
     "@eslint/eslintrc": "^3.3.0",
-    "@eslint/js": "^9.21.0",
-    "@faker-js/faker": "^9.5.0",
+    "@eslint/js": "^9.22.0",
+    "@faker-js/faker": "^9.6.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.13.5",
+    "@types/node": "^22.13.10",
     "@types/node-cron": "^3.0.11",
     "@types/semver": "^7.5.8",
-    "@types/ws": "^8.5.14",
-    "@typescript-eslint/eslint-plugin": "8.24.1",
-    "@typescript-eslint/parser": "8.24.1",
+    "@types/ws": "^8.18.0",
+    "@typescript-eslint/eslint-plugin": "8.26.1",
+    "@typescript-eslint/parser": "8.26.1",
     "dayjs": "^1.11.13",
     "dotenv": "^16.4.7",
-    "eslint": "9.21.0",
-    "eslint-config-prettier": "10.0.1",
+    "eslint": "9.22.0",
+    "eslint-config-prettier": "10.1.1",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsonc": "^2.19.1",
     "eslint-plugin-no-unsanitized": "^4.1.2",
@@ -83,23 +84,23 @@
     "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": "^56.0.1",
+    "eslint-plugin-unicorn": "^57.0.0",
     "node-cron": "^3.0.3",
-    "prettier": "^3.5.2",
+    "prettier": "^3.5.3",
     "semver": "^7.7.1",
     "tsx": "^4.19.3",
-    "typescript": "^5.7.3",
+    "typescript": "^5.8.2",
     "uuid": "^11.1.0",
-    "vitest": "^3.0.6",
+    "vitest": "^3.0.8",
     "ws": "^8.18.1"
   },
   "dependencies": {
     "@digital-alchemy/core": "^25.2.2",
     "dayjs": "^1.11.13",
     "semver": "^7.7.1",
-    "type-fest": "^4.35.0",
+    "type-fest": "^4.37.0",
     "uuid": "^11.1.0",
     "ws": "^8.18.1"
   },
-  "packageManager": "yarn@4.5.1"
+  "packageManager": "yarn@4.7.0"
 }

package/src/dev/index.mts

@@ -0,0 +1,3 @@
+export * from "./mappings.mts";
+export * from "./registry.mts";
+export * from "./services.mts";

package/src/dev/mappings.mts

@@ -0,0 +1,121 @@
+declare module "../user.mts" {
+  export interface HassUniqueIdMapping {
+    "5622d76001a335e3ea893c4d60d31b3d-next_dawn": "sensor.sun_next_dawn";
+    "5622d76001a335e3ea893c4d60d31b3d-next_dusk": "sensor.sun_next_dusk";
+    "5622d76001a335e3ea893c4d60d31b3d-next_midnight": "sensor.sun_next_midnight";
+    "5622d76001a335e3ea893c4d60d31b3d-next_noon": "sensor.sun_next_noon";
+    "5622d76001a335e3ea893c4d60d31b3d-next_rising": "sensor.sun_next_rising";
+    "5622d76001a335e3ea893c4d60d31b3d-next_setting": "sensor.sun_next_setting";
+    "5622d76001a335e3ea893c4d60d31b3d-solar_elevation": "sensor.sun_solar_elevation";
+    "6d8acf36200c5ff8d2d9bb1b1f1dbe00c7eb5b7540103fd90c9a035f82967431": "button.start_white_noise";
+    "5622d76001a335e3ea893c4d60d31b3d-solar_azimuth": "sensor.sun_solar_azimuth";
+    "5622d76001a335e3ea893c4d60d31b3d-solar_rising": "sensor.sun_solar_rising";
+    digital_alchemy: "person.digital_alchemy";
+    "6acd101923c0460fc31bad82c4efa140": "todo.shopping_list";
+    "4a7fc2592d3a98e0eed8cbc73e839c1c": "tts.google_en_com";
+    hass_e2e_is_online: "binary_sensor.hass_e2e_online";
+    e1806fdc93296bbd5ab42967003cd38729ff9ba6cfeefc3e15a03ad01ac894fe: "sensor.magic";
+    a6e8373221727e197144ba689d7606d4be6f609f2fd0fd8e17516548780465ab: "binary_sensor.toggles";
+    "413eb6d69bbec134a07a6d32effd3c3763955e611f43256600cca40725276816": "switch.bedroom_lamp";
+    "06d5a22e681ee9c668f8563bd3108853fb053c43342131782afe989090c4ced9": "switch.kitchen_cabinets";
+    "27b4fc99f35bbdd1a07173caff5b52f86e3bc342db96f48427e47980b0fb6b49": "switch.living_room_mood_lights";
+    "8eb8c1f8c760e97cfa49a0a29cd6891313a1e9a45dd046a556a9f317778cf50a": "switch.porch_light";
+    "05ecbbc6111791b6baacbbb60397db14": "calendar.united_states_tx";
+  }
+
+  export interface HassZoneMapping {
+    test: true;
+  }
+
+  export interface HassDomainMapping {
+    automation: "automation.example";
+    binary_sensor: "binary_sensor.hass_e2e_online" | "binary_sensor.toggles";
+    button: "button.example";
+    calendar: "calendar.united_states_tx";
+    light: "light.bedroom_ceiling_fan";
+    person: "person.digital_alchemy";
+    scene: "scene.games_room_auto";
+    sensor:
+      | "sensor.magic"
+      | "sensor.sun_next_dawn"
+      | "sensor.sun_next_dusk"
+      | "sensor.sun_next_midnight"
+      | "sensor.sun_next_noon"
+      | "sensor.sun_next_rising"
+      | "sensor.sun_next_setting";
+    sun: "sun.sun";
+    switch:
+      | "switch.bedroom_lamp"
+      | "switch.kitchen_cabinets"
+      | "switch.living_room_mood_lights"
+      | "switch.porch_light";
+    todo: "todo.shopping_list";
+    tts: "tts.google_en_com";
+    zone: "zone.home";
+  }
+
+  export interface HassPlatformMapping {
+    _sun:
+      | "sensor.sun_next_dawn"
+      | "sensor.sun_next_dusk"
+      | "sensor.sun_next_midnight"
+      | "sensor.sun_next_noon"
+      | "sensor.sun_next_rising"
+      | "sensor.sun_next_setting"
+      | "sensor.sun_solar_elevation"
+      | "sensor.sun_solar_azimuth"
+      | "sensor.sun_solar_rising";
+    _person: "person.digital_alchemy";
+    _shopping_list: "todo.shopping_list";
+    _google_translate: "tts.google_en_com";
+    _synapse:
+      | "binary_sensor.hass_e2e_online"
+      | "sensor.magic"
+      | "button.example"
+      | "binary_sensor.toggles"
+      | "switch.bedroom_lamp"
+      | "switch.kitchen_cabinets"
+      | "switch.living_room_mood_lights"
+      | "switch.porch_light";
+    _holiday: "calendar.united_states_tx";
+  }
+
+  export interface HassDeviceMapping {
+    _308e39cf50a9fc6c30b4110724ed1f2e:
+      | "sensor.sun_next_dawn"
+      | "sensor.sun_next_dusk"
+      | "sensor.sun_next_midnight"
+      | "sensor.sun_next_noon"
+      | "sensor.sun_next_rising"
+      | "sensor.sun_next_setting"
+      | "button.example"
+      | "sensor.sun_solar_elevation"
+      | "sensor.sun_solar_azimuth"
+      | "sensor.sun_solar_rising";
+    _e58841e47cf86097b310316e55d6bb12: "calendar.united_states_tx";
+  }
+
+  export interface HassAreaMapping {
+    _test: "switch.living_room_mood_lights";
+    _living_room: "switch.living_room_mood_lights";
+    _kitchen: "switch.kitchen_cabinets";
+    _bedroom: "switch.bedroom_lamp" | "light.bedroom_ceiling_fan";
+  }
+
+  export interface HassLabelMapping {
+    _synapse:
+      | "binary_sensor.hass_e2e_online"
+      | "sensor.magic"
+      | "binary_sensor.toggles"
+      | "switch.bedroom_lamp"
+      | "switch.kitchen_cabinets"
+      | "switch.living_room_mood_lights"
+      | "switch.porch_light";
+    _test: never;
+  }
+
+  export interface HassFloorMapping {
+    _downstairs: "switch.kitchen_cabinets" | "switch.living_room_mood_lights";
+    _upstairs: "switch.bedroom_lamp";
+  }
+}

package/src/dev/registry.mts

@@ -0,0 +1,330 @@
+/* eslint-disable @cspell/spellchecker */
+/* eslint-disable @typescript-eslint/no-magic-numbers */
+declare module "../user.mts" {
+  export interface HassEntitySetupMapping {
+    "button.example": {
+      state: string;
+      entity_id: "button.example";
+      attributes: { friendly_name: "Example button" };
+    };
+    "binary_sensor.hass_e2e_online": {
+      attributes: {
+        friendly_name: "hass_e2e online";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSBGW129NV7WY8MMG1E";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "binary_sensor.hass_e2e_online";
+
+      state: "unavailable";
+    };
+    "binary_sensor.toggles": {
+      attributes: {
+        friendly_name: "toggles";
+        icon: "mdi:toggle-switch-variant-off";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSB43FF1R6FX0QEE4Z6";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "binary_sensor.toggles";
+      state: "unavailable";
+    };
+    "calendar.united_states_tx": {
+      attributes: {
+        all_day: true;
+        description: "";
+        end_time: "2024-05-28 00:00:00";
+        friendly_name: "United States, TX";
+        location: "United States, TX";
+        message: "Memorial Day";
+        start_time: "2024-05-27 00:00:00";
+      };
+      context: {
+        id: "01HWXTYEEFBB7QQC1CSM6PAR36";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "calendar.united_states_tx";
+      state: "off";
+    };
+    "light.bedroom_ceiling_fan": {
+      attributes: {
+        brightness: null;
+        color_mode: null;
+        color_temp: null;
+        color_temp_kelvin: null;
+        friendly_name: "Bedroom Ceiling Fan";
+        hs_color: null;
+        icon: "mdi:lightbulb-group";
+        max_color_temp_kelvin: 6535;
+        max_mireds: 500;
+        min_color_temp_kelvin: 2000;
+        min_mireds: 153;
+        rgb_color: null;
+        supported_color_modes: ["color_temp", "xy"];
+        supported_features: 40;
+        xy_color: null;
+      };
+      context: {
+        id: "01HX722Y1JFS6KN2MDERK0VJ2D";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "light.bedroom_ceiling_fan";
+      state: "off";
+    };
+    "person.digital_alchemy": {
+      attributes: {
+        device_trackers: [];
+        editable: true;
+        friendly_name: "digital-alchemy";
+        id: "digital_alchemy";
+        user_id: "4dd1cf7e93e94f3fbaf419501f9a3d59";
+      };
+      context: {
+        id: "01HWXTSCSBRKJ9T2KV1JNER5KQ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "person.digital_alchemy";
+      state: "unknown";
+    };
+    "scene.games_room_auto": {
+      attributes: {
+        "Managed By": "home_automation";
+        friendly_name: "bedroom off";
+      };
+      context: {
+        id: "01HWXW289S8HP5MSGNNTNB2CBG";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "scene.games_room_auto";
+      state: "unknown";
+    };
+    "sensor.magic": {
+      attributes: {
+        friendly_name: "magic";
+        icon: "mdi:satellite-uplink";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSBW34BP3R20RJ09CVZ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.magic";
+      state: string;
+    };
+    "sensor.sun_next_dawn": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next dawn";
+      };
+      context: {
+        id: "01HWXTS8W1SRTPT5K1XM0G491X";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_dawn";
+
+      state: "2024-05-03T03:24:45+00:00";
+    };
+    "sensor.sun_next_dusk": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next dusk";
+      };
+      context: {
+        id: "01HWXTS8W1S95P1MVHDGHSQEB2";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_dusk";
+      state: "2024-05-03T19:51:10+00:00";
+    };
+    "sensor.sun_next_midnight": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next midnight";
+      };
+      context: {
+        id: "01HWXTS8W1YQCPA3WZ69Y9JSPD";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_midnight";
+      state: "2024-05-03T23:37:12+00:00";
+    };
+    "sensor.sun_next_noon": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next noon";
+      };
+      context: {
+        id: "01HWXTS8W28MVV48CQ31JB2WKC";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_noon";
+      state: "2024-05-03T11:37:19+00:00";
+    };
+    "sensor.sun_next_rising": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next rising";
+      };
+      context: {
+        id: "01HWXTS8W2MMADKGWE4A5BMH51";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_rising";
+      state: "2024-05-03T04:05:17+00:00";
+    };
+    "sensor.sun_next_setting": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Next setting";
+      };
+      context: {
+        id: "01HWXTS8W24KWTHR2B6V32NCXG";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_next_setting";
+      state: "2024-05-03T19:10:21+00:00";
+    };
+    "sun.sun": {
+      attributes: {
+        azimuth: 0.35;
+        elevation: -21.86;
+        friendly_name: "Sun";
+        next_dawn: "2024-05-03T03:24:45.747945+00:00";
+        next_dusk: "2024-05-03T19:51:10.358970+00:00";
+        next_midnight: "2024-05-03T23:37:12+00:00";
+        next_noon: "2024-05-03T11:37:19+00:00";
+        next_rising: "2024-05-03T04:05:17.926549+00:00";
+        next_setting: "2024-05-03T19:10:21.280558+00:00";
+        rising: true;
+      };
+      context: {
+        id: "01HWXTS8W1J2TDGMN7KKNWP8DV";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sun.sun";
+      state: "below_horizon";
+    };
+    "switch.bedroom_lamp": {
+      attributes: {
+        friendly_name: "bedroom_lamp";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSB7BK003CH3AYYVXCB";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "switch.bedroom_lamp";
+      state: "unavailable";
+    };
+    "switch.kitchen_cabinets": {
+      attributes: {
+        friendly_name: "kitchen_cabinets";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSBM9Y3SRQTFJ5CVK6H";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "switch.kitchen_cabinets";
+      state: "unavailable";
+    };
+    "switch.living_room_mood_lights": {
+      attributes: {
+        friendly_name: "living_room_mood_lights";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSBS5B586JJ7VFH10SX";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "switch.living_room_mood_lights";
+
+      state: "unavailable";
+    };
+    "switch.porch_light": {
+      attributes: {
+        friendly_name: "porch_light";
+        restored: true;
+        supported_features: 0;
+      };
+      context: {
+        id: "01HWXTSCSBFTSZR1M5XAK7XSR8";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "switch.porch_light";
+      state: string;
+    };
+    "todo.shopping_list": {
+      attributes: {
+        friendly_name: "Shopping List";
+        supported_features: 15;
+      };
+      context: {
+        id: "01HWXTS8X3D417XC4YJTG8QJWB";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "todo.shopping_list";
+      state: "0";
+    };
+    "tts.google_en_com": {
+      attributes: {
+        friendly_name: "Google en com";
+      };
+      context: {
+        id: "01HWXTS8XMPQ236CDJ6X7C6E60";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "tts.google_en_com";
+      state: "unknown";
+    };
+    "zone.home": {
+      attributes: {
+        editable: true;
+        friendly_name: "Home";
+        icon: "mdi:home";
+        latitude: 52.373_133_9;
+        longitude: 4.890_314_7;
+        passive: false;
+        persons: [];
+        radius: 100;
+      };
+      context: {
+        id: "01HWXTS8GMB4ZW20P8MGMX0QSN";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "zone.home";
+      state: "0";
+    };
+  }
+}