@digital-alchemy/hass 25.10.25 → 25.10.26

package/src/dev/mappings.mts

@@ -28,6 +28,10 @@ declare module "../user.mts" {
     select_example_unique_id: "select.example";
     text_example_unique_id: "text.example";
     time_example_unique_id: "time.example";
+    light_test_light_unique_id: "light.test_light";
+    todo_test_todo_unique_id: "todo.test_todo";
+    climate_test_climate_unique_id: "climate.test_climate";
+    unsupported_test_unique_id: "unsupported.test";
   }
 
   export interface HassZoneMapping {
@@ -36,25 +40,43 @@ declare module "../user.mts" {
 
   export interface HassDomainMapping {
     automation: "automation.example";
-    binary_sensor: "binary_sensor.hass_e2e_online" | "binary_sensor.toggles";
+    binary_sensor:
+      | "binary_sensor.bedroom_window"
+      | "binary_sensor.garage_door"
+      | "binary_sensor.hass_e2e_online"
+      | "binary_sensor.toggles";
     button: "button.example";
     calendar: "calendar.united_states_tx";
+    climate: "climate.hallway_thermostat" | "climate.test_room" | "climate.test_climate";
     date: "date.example";
     datetime: "datetime.example";
-    light: "light.bedroom_ceiling_fan";
+    light:
+      | "light.bedroom_ceiling_fan"
+      | "light.bedroom_light"
+      | "light.kitchen_lamp"
+      | "light.test_light";
     lock: "lock.example";
     number: "number.example";
     person: "person.digital_alchemy";
     scene: "scene.games_room_auto";
     select: "select.example";
     sensor:
+      | "sensor.bedroom_disabled_temp"
+      | "sensor.floor_test_disabled"
+      | "sensor.kitchen_disabled_temp"
+      | "sensor.label_test_disabled"
+      | "sensor.living_room_disabled_temp"
+      | "sensor.living_room_temperature"
       | "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";
+      | "sensor.sun_next_setting"
+      | "sensor.sun_solar_azimuth"
+      | "sensor.sun_solar_elevation"
+      | "sensor.sun_solar_rising";
     sun: "sun.sun";
     switch:
       | "switch.bedroom_lamp"
@@ -63,8 +85,9 @@ declare module "../user.mts" {
       | "switch.porch_light";
     text: "text.example";
     time: "time.example";
-    todo: "todo.shopping_list";
+    todo: "todo.shopping_list" | "todo.test_todo";
     tts: "tts.google_en_com";
+    unsupported: "unsupported.test";
     zone: "zone.home";
   }
 
@@ -90,7 +113,11 @@ declare module "../user.mts" {
       | "switch.bedroom_lamp"
       | "switch.kitchen_cabinets"
       | "switch.living_room_mood_lights"
-      | "switch.porch_light";
+      | "switch.porch_light"
+      | "light.test_light"
+      | "todo.test_todo"
+      | "climate.test_climate"
+      | "unsupported.test";
     _holiday: "calendar.united_states_tx";
   }
 
@@ -113,7 +140,7 @@ declare module "../user.mts" {
     _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";
+    _bedroom: "switch.bedroom_lamp" | "light.bedroom_ceiling_fan" | "light.bedroom_light";
   }
 
   export interface HassLabelMapping {
@@ -124,7 +151,11 @@ declare module "../user.mts" {
       | "switch.bedroom_lamp"
       | "switch.kitchen_cabinets"
       | "switch.living_room_mood_lights"
-      | "switch.porch_light";
+      | "switch.porch_light"
+      | "light.test_light"
+      | "todo.test_todo"
+      | "climate.test_climate"
+      | "unsupported.test";
     _test: never;
   }
 

package/src/dev/registry.mts

@@ -393,5 +393,237 @@ declare module "../user.mts" {
       entity_id: "zone.home";
       state: "0";
     };
+    "binary_sensor.bedroom_window": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "4dd1cf7e93e94f3fbaf419501f9a3d59";
+        friendly_name: "Bedroom Window Sensor";
+      };
+      context: {
+        id: "01HWXTSCSBRKJ9T2KV1JNER5KQ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "binary_sensor.bedroom_window";
+      state: "on";
+    };
+    "binary_sensor.garage_door": {
+      attributes: {
+        device_class: "door";
+        friendly_name: "Garage Door Sensor";
+      };
+      context: {
+        id: "05FGHIJKLMNO4PQR5STUV6789WX";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "binary_sensor.garage_door";
+      state: "off";
+    };
+    "climate.hallway_thermostat": {
+      attributes: {
+        current_temperature: 22;
+        target_temperature: 20;
+        hvac_mode: "cool";
+        friendly_name: "Hallway Thermostat";
+        supported_features: 1;
+      };
+      context: {
+        id: "04MNOPQRSTUV8WX9YZABCDE123";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "climate.hallway_thermostat";
+      state: "cool";
+    };
+    "climate.test_room": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "4dd1cf7e93e94f3fbaf419501f9a3d59";
+        friendly_name: "Test Room Climate";
+      };
+      context: {
+        id: "01HWXTSCSBRKJ9T2KV1JNER5KQ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "climate.test_room";
+      state: "cooling";
+    };
+    "light.bedroom_light": {
+      attributes: {
+        brightness: 255;
+        friendly_name: "Bedroom Light";
+        supported_features: 41;
+      };
+      context: {
+        id: "03UVWXYZABCDE123FGHI456JKL7";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "light.bedroom_light";
+      state: "on";
+    };
+    "light.kitchen_lamp": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "4dd1cf7e93e94f3fbaf419501f9a3d59";
+        friendly_name: "Kitchen Lamp";
+      };
+      context: {
+        id: "01HWXTSCSBRKJ9T2KV1JNER5KQ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "light.kitchen_lamp";
+      state: "off";
+    };
+    "sensor.bedroom_disabled_temp": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "disabled_test_3";
+        friendly_name: "Bedroom Disabled Temp";
+      };
+      context: {
+        id: "ctx3";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.bedroom_disabled_temp";
+      state: "unknown";
+    };
+    "sensor.floor_test_disabled": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "disabled_test_4";
+        friendly_name: "Floor Test Disabled";
+      };
+      context: {
+        id: "ctx4";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.floor_test_disabled";
+      state: "unknown";
+    };
+    "sensor.kitchen_disabled_temp": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "disabled_test_2";
+        friendly_name: "Kitchen Disabled Temp";
+      };
+      context: {
+        id: "ctx2";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.kitchen_disabled_temp";
+      state: "unknown";
+    };
+    "sensor.label_test_disabled": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "disabled_test_5";
+        friendly_name: "Label Test Disabled";
+      };
+      context: {
+        id: "ctx5";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.label_test_disabled";
+      state: "unknown";
+    };
+    "sensor.living_room_disabled_temp": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "disabled_test_1";
+        friendly_name: "Living Room Disabled Temp";
+      };
+      context: {
+        id: "ctx1";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.living_room_disabled_temp";
+      state: "unknown";
+    };
+    "sensor.living_room_temperature": {
+      attributes: {
+        id: "digital_alchemy";
+        user_id: "4dd1cf7e93e94f3fbaf419501f9a3d59";
+        friendly_name: "Living Room Temperature";
+      };
+      context: {
+        id: "01HWXTSCSBRKJ9T2KV1JNER5KQ";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.living_room_temperature";
+      state: "unavailable";
+    };
+    "sensor.sun_solar_azimuth": {
+      attributes: {
+        device_class: "angle";
+        friendly_name: "Sun Solar azimuth";
+        unit_of_measurement: "°";
+      };
+      context: {
+        id: "01HWXTS8W2MMADKGWE4A5BMH51";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_solar_azimuth";
+      state: "0.35";
+    };
+    "sensor.sun_solar_elevation": {
+      attributes: {
+        device_class: "angle";
+        friendly_name: "Sun Solar elevation";
+        unit_of_measurement: "°";
+      };
+      context: {
+        id: "01HWXTS8W1J2TDGMN7KKNWP8DV";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_solar_elevation";
+      state: "-21.86";
+    };
+    "sensor.sun_solar_rising": {
+      attributes: {
+        device_class: "timestamp";
+        friendly_name: "Sun Solar rising";
+      };
+      context: {
+        id: "01HWXTS8W2MMADKGWE4A5BMH51";
+        parent_id: null;
+        user_id: null;
+      };
+      entity_id: "sensor.sun_solar_rising";
+      state: "2024-05-03T04:05:17+00:00";
+    };
+    "light.test_light": {
+      attributes: { supported_features: 44 };
+      entity_id: "light.test_light";
+      state: "on";
+    };
+    "todo.test_todo": {
+      attributes: {
+        supported_features: 15;
+      };
+      entity_id: "todo.test_todo";
+      state: "0";
+    };
+    "climate.test_climate": {
+      attributes: { supported_features: 1 };
+      entity_id: "climate.test_climate";
+      state: "cool";
+    };
+    "unsupported.test": {
+      attributes: { supported_features: 1 };
+      entity_id: "unsupported.test";
+      state: "on";
+    };
   }
 }

package/src/hass.module.mts

@@ -12,6 +12,7 @@ import {
   FetchInternals,
   Floor,
   HassDiagnosticsService,
+  HassFeatureService,
   IDByExtension,
   Label,
   ReferenceService,
@@ -189,6 +190,11 @@ export const LIB_HASS = CreateLibrary({
      */
     events: EventsService,
 
+    /**
+     * feature flag checking for entities
+     */
+    feature: HassFeatureService,
+
     /**
      * rest api commands
      */

package/src/helpers/fetch/service-list.mts

@@ -198,8 +198,9 @@ export interface ServiceListFilter {
   supported_features?: number[];
   supported_color_modes?: LiteralUnion<`${ColorMode}`, string>[];
 }
-
-export interface ServiceListFieldDescription {
+export interface ServiceListFieldDescription<
+  TYPE extends keyof ServiceListSelector = keyof ServiceListSelector,
+> {
   fields?: Record<string, ServiceListFieldDescription>;
   target?: ServiceListServiceTarget;
   response?: ResponseOptional;
@@ -210,12 +211,19 @@ export interface ServiceListFieldDescription {
   filter?: ServiceListFilter;
   name?: string;
   required?: boolean;
-  selector?: ServiceListSelector;
+  /**
+   * The `selector` field is a discriminated union that ensures only one key of `ServiceListSelector`
+   * can be present at a time. This mapped type enforces mutual exclusivity at the type level,
+   * so that only a single selector type is allowed for each field description.
+   */
+  selector?: {
+    [K in TYPE]: { [P in K]: ServiceListSelector[P] } & { [P in Exclude<TYPE, K>]?: never };
+  }[TYPE];
 }
 
 export interface ServiceListServiceTarget {
-  entity?: EntityFilterSelector[];
-  device?: DeviceFilterSelector[];
+  entity?: EntityFilterSelector | EntityFilterSelector[];
+  device?: DeviceFilterSelector | DeviceFilterSelector[];
 }
 
 export interface ServiceListField {

package/src/helpers/index.mts

@@ -9,5 +9,6 @@ export * from "./id-by.mts";
 export * from "./interfaces.mts";
 export * from "./notify.mts";
 export * from "./registry.mts";
+export * from "./supported-features.mts";
 export * from "./utility.mts";
 export * from "./websocket.mts";