@m1kad0/hannah-proto 5.0.0 → 5.1.0

package/dist/v2/device_control_menu.d.ts

@@ -1,5 +1,5 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { DeviceClass, Slot, SlotValue } from "./device_model";
+import { DeviceClass, DeviceSubtype, Slot, SlotValue } from "./device_model";
 export declare const protobufPackage = "hannah.v2";
 /**
  * A device for control menus (WebUI, Telegram), in the typed device model: the class
@@ -16,6 +16,8 @@ export interface DeviceInfo {
     /** with current values; Slot.writable says what a menu may offer */
     slots: Slot[];
     available: boolean;
+    /** TypedDevice.subtype, e.g. window or door for a contact */
+    subtype: DeviceSubtype;
 }
 export interface RoomInfo {
     /** room_id (lowercase), e.g. "wohnzimmer" */

package/dist/v2/device_control_menu.js

@@ -11,7 +11,7 @@ const wire_1 = require("@bufbuild/protobuf/wire");
 const device_model_1 = require("./device_model");
 exports.protobufPackage = "hannah.v2";
 function createBaseDeviceInfo() {
-    return { id: "", name: "", deviceClass: 0, slots: [], available: false };
+    return { id: "", name: "", deviceClass: 0, slots: [], available: false, subtype: 0 };
 }
 exports.DeviceInfo = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -30,6 +30,9 @@ exports.DeviceInfo = {
         if (message.available !== false) {
             writer.uint32(96).bool(message.available);
         }
+        if (message.subtype !== 0) {
+            writer.uint32(104).int32(message.subtype);
+        }
         return writer;
     },
     decode(input, length) {
@@ -80,6 +83,13 @@ exports.DeviceInfo = {
                         message.available = reader.bool();
                         continue;
                     }
+                    case 13: {
+                        if (tag !== 104) {
+                            break;
+                        }
+                        message.subtype = reader.int32();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -102,6 +112,7 @@ exports.DeviceInfo = {
         message.deviceClass = object.deviceClass ?? 0;
         message.slots = object.slots?.map((e) => device_model_1.Slot.fromPartial(e)) || [];
         message.available = object.available ?? false;
+        message.subtype = object.subtype ?? 0;
         return message;
     },
 };

package/dist/v2/device_model.d.ts

@@ -16,8 +16,9 @@ export declare enum DeviceClass {
      */
     DEVICE_CLASS_GENERIC_BINARY_SWITCH = 3,
     /**
-     * DEVICE_CLASS_THERMOSTAT - Thermostat/room climate. Slots: TARGET_TEMPERATURE (required), TEMPERATURE,
-     * HUMIDITY, VALVE. Comfort/eco setpoints and similar are not slots.
+     * DEVICE_CLASS_THERMOSTAT - Radiator or room thermostat. Slots: TARGET_TEMPERATURE (required), TEMPERATURE,
+     * HUMIDITY, VALVE. Comfort/eco setpoints and similar are not slots. Units with an
+     * operating mode and a fan are DEVICE_CLASS_CLIMATE.
      */
     DEVICE_CLASS_THERMOSTAT = 4,
     /** DEVICE_CLASS_COVER - Blind, shutter, awning. Slots: POSITION (required), TILT, STOP. */
@@ -34,6 +35,26 @@ export declare enum DeviceClass {
      * (GENERIC_NUMBER / GENERIC_BOOL / GENERIC_TEXT), each with label and unit.
      */
     DEVICE_CLASS_GENERIC = 8,
+    /**
+     * DEVICE_CLASS_CLIMATE - Air conditioner / room climate unit with operating mode and fan. Slots: ON (required),
+     * MODE, TARGET_TEMPERATURE, TEMPERATURE, HUMIDITY, FAN_SPEED. A radiator thermostat
+     * without mode and fan is a THERMOSTAT, not a CLIMATE.
+     */
+    DEVICE_CLASS_CLIMATE = 9,
+    UNRECOGNIZED = -1
+}
+/**
+ * A finer kind within a device class, for the cases where the class alone does not say
+ * what a user means ("the windows" versus "the doors"). Optional: the adapter sets it
+ * where it knows (function, role, type detector), otherwise UNSPECIFIED.
+ */
+export declare enum DeviceSubtype {
+    /** DEVICE_SUBTYPE_UNSPECIFIED - No statement. Hannah Core may fall back to the device name. */
+    DEVICE_SUBTYPE_UNSPECIFIED = 0,
+    /** DEVICE_SUBTYPE_WINDOW - DEVICE_CLASS_CONTACT: window contact. */
+    DEVICE_SUBTYPE_WINDOW = 1,
+    /** DEVICE_SUBTYPE_DOOR - DEVICE_CLASS_CONTACT: door contact. */
+    DEVICE_SUBTYPE_DOOR = 2,
     UNRECOGNIZED = -1
 }
 /**
@@ -66,6 +87,17 @@ export declare enum SlotKind {
     SLOT_KIND_HUMIDITY = 22,
     /** SLOT_KIND_VALVE - number, 0-100 (% open) */
     SLOT_KIND_VALVE = 23,
+    /**
+     * SLOT_KIND_MODE - Operating mode of a CLIMATE device, text, one of: "cool", "heat", "dry", "fan_only",
+     * "auto". The adapter normalizes the device's own values to this vocabulary. The modes the
+     * device really supports are listed in Slot.options.
+     */
+    SLOT_KIND_MODE = 24,
+    /**
+     * SLOT_KIND_FAN_SPEED - Fan level of a CLIMATE device, text, one of: "low", "medium", "high", "auto". Supported
+     * levels are listed in Slot.options.
+     */
+    SLOT_KIND_FAN_SPEED = 25,
     /** SLOT_KIND_POSITION - --- cover --- */
     SLOT_KIND_POSITION = 30,
     /** SLOT_KIND_TILT - number, 0-100 (%) */
@@ -124,6 +156,13 @@ export interface Slot {
      * Unset = not configured, no restriction — distinct from an explicit 0.
      */
     requiredTrustLevel?: number | undefined;
+    /**
+     * The values this slot accepts, for SLOT_KIND_MODE and SLOT_KIND_FAN_SPEED, taken from the
+     * vocabulary of the kind (e.g. a cooling-only unit lists just "cool", "dry", "fan_only").
+     * Empty = no statement, every value of the vocabulary may work. Hannah uses it to answer
+     * honestly when a device cannot do what was asked.
+     */
+    options: string[];
 }
 /** A device, as the adapter derived it from the ioBroker objects (grouping, class, slots). */
 export interface TypedDevice {
@@ -139,6 +178,8 @@ export interface TypedDevice {
     slots: Slot[];
     /** false = device currently unreachable */
     available: boolean;
+    /** finer kind within the class, UNSPECIFIED = no statement */
+    subtype: DeviceSubtype;
 }
 /**
  * All devices the adapter knows. Sent on AgentConnect and whenever the set of devices

package/dist/v2/device_model.js

@@ -5,7 +5,7 @@
 //   protoc               unknown
 // source: hannah/v2/device_model.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetSlot = exports.DeviceAvailability = exports.SlotUpdate = exports.TypedDeviceSnapshot = exports.TypedDevice = exports.Slot = exports.SlotValue = exports.SlotKind = exports.DeviceClass = exports.protobufPackage = void 0;
+exports.SetSlot = exports.DeviceAvailability = exports.SlotUpdate = exports.TypedDeviceSnapshot = exports.TypedDevice = exports.Slot = exports.SlotValue = exports.SlotKind = exports.DeviceSubtype = exports.DeviceClass = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 exports.protobufPackage = "hannah.v2";
@@ -26,8 +26,9 @@ var DeviceClass;
      */
     DeviceClass[DeviceClass["DEVICE_CLASS_GENERIC_BINARY_SWITCH"] = 3] = "DEVICE_CLASS_GENERIC_BINARY_SWITCH";
     /**
-     * DEVICE_CLASS_THERMOSTAT - Thermostat/room climate. Slots: TARGET_TEMPERATURE (required), TEMPERATURE,
-     * HUMIDITY, VALVE. Comfort/eco setpoints and similar are not slots.
+     * DEVICE_CLASS_THERMOSTAT - Radiator or room thermostat. Slots: TARGET_TEMPERATURE (required), TEMPERATURE,
+     * HUMIDITY, VALVE. Comfort/eco setpoints and similar are not slots. Units with an
+     * operating mode and a fan are DEVICE_CLASS_CLIMATE.
      */
     DeviceClass[DeviceClass["DEVICE_CLASS_THERMOSTAT"] = 4] = "DEVICE_CLASS_THERMOSTAT";
     /** DEVICE_CLASS_COVER - Blind, shutter, awning. Slots: POSITION (required), TILT, STOP. */
@@ -44,8 +45,29 @@ var DeviceClass;
      * (GENERIC_NUMBER / GENERIC_BOOL / GENERIC_TEXT), each with label and unit.
      */
     DeviceClass[DeviceClass["DEVICE_CLASS_GENERIC"] = 8] = "DEVICE_CLASS_GENERIC";
+    /**
+     * DEVICE_CLASS_CLIMATE - Air conditioner / room climate unit with operating mode and fan. Slots: ON (required),
+     * MODE, TARGET_TEMPERATURE, TEMPERATURE, HUMIDITY, FAN_SPEED. A radiator thermostat
+     * without mode and fan is a THERMOSTAT, not a CLIMATE.
+     */
+    DeviceClass[DeviceClass["DEVICE_CLASS_CLIMATE"] = 9] = "DEVICE_CLASS_CLIMATE";
     DeviceClass[DeviceClass["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
 })(DeviceClass || (exports.DeviceClass = DeviceClass = {}));
+/**
+ * A finer kind within a device class, for the cases where the class alone does not say
+ * what a user means ("the windows" versus "the doors"). Optional: the adapter sets it
+ * where it knows (function, role, type detector), otherwise UNSPECIFIED.
+ */
+var DeviceSubtype;
+(function (DeviceSubtype) {
+    /** DEVICE_SUBTYPE_UNSPECIFIED - No statement. Hannah Core may fall back to the device name. */
+    DeviceSubtype[DeviceSubtype["DEVICE_SUBTYPE_UNSPECIFIED"] = 0] = "DEVICE_SUBTYPE_UNSPECIFIED";
+    /** DEVICE_SUBTYPE_WINDOW - DEVICE_CLASS_CONTACT: window contact. */
+    DeviceSubtype[DeviceSubtype["DEVICE_SUBTYPE_WINDOW"] = 1] = "DEVICE_SUBTYPE_WINDOW";
+    /** DEVICE_SUBTYPE_DOOR - DEVICE_CLASS_CONTACT: door contact. */
+    DeviceSubtype[DeviceSubtype["DEVICE_SUBTYPE_DOOR"] = 2] = "DEVICE_SUBTYPE_DOOR";
+    DeviceSubtype[DeviceSubtype["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(DeviceSubtype || (exports.DeviceSubtype = DeviceSubtype = {}));
 /**
  * What a slot means, and therefore which scale and unit its value has. The adapter
  * normalizes every value to exactly this scale; Core relies on it.
@@ -77,6 +99,17 @@ var SlotKind;
     SlotKind[SlotKind["SLOT_KIND_HUMIDITY"] = 22] = "SLOT_KIND_HUMIDITY";
     /** SLOT_KIND_VALVE - number, 0-100 (% open) */
     SlotKind[SlotKind["SLOT_KIND_VALVE"] = 23] = "SLOT_KIND_VALVE";
+    /**
+     * SLOT_KIND_MODE - Operating mode of a CLIMATE device, text, one of: "cool", "heat", "dry", "fan_only",
+     * "auto". The adapter normalizes the device's own values to this vocabulary. The modes the
+     * device really supports are listed in Slot.options.
+     */
+    SlotKind[SlotKind["SLOT_KIND_MODE"] = 24] = "SLOT_KIND_MODE";
+    /**
+     * SLOT_KIND_FAN_SPEED - Fan level of a CLIMATE device, text, one of: "low", "medium", "high", "auto". Supported
+     * levels are listed in Slot.options.
+     */
+    SlotKind[SlotKind["SLOT_KIND_FAN_SPEED"] = 25] = "SLOT_KIND_FAN_SPEED";
     /** SLOT_KIND_POSITION - --- cover --- */
     SlotKind[SlotKind["SLOT_KIND_POSITION"] = 30] = "SLOT_KIND_POSITION";
     /** SLOT_KIND_TILT - number, 0-100 (%) */
@@ -188,7 +221,16 @@ exports.SlotValue = {
     },
 };
 function createBaseSlot() {
-    return { slotId: "", kind: 0, value: undefined, writable: false, unit: "", label: "", requiredTrustLevel: undefined };
+    return {
+        slotId: "",
+        kind: 0,
+        value: undefined,
+        writable: false,
+        unit: "",
+        label: "",
+        requiredTrustLevel: undefined,
+        options: [],
+    };
 }
 exports.Slot = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -213,6 +255,9 @@ exports.Slot = {
         if (message.requiredTrustLevel !== undefined) {
             writer.uint32(56).int32(message.requiredTrustLevel);
         }
+        for (const v of message.options) {
+            writer.uint32(66).string(v);
+        }
         return writer;
     },
     decode(input, length) {
@@ -277,6 +322,13 @@ exports.Slot = {
                         message.requiredTrustLevel = reader.int32();
                         continue;
                     }
+                    case 8: {
+                        if (tag !== 66) {
+                            break;
+                        }
+                        message.options.push(reader.string());
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -303,11 +355,12 @@ exports.Slot = {
         message.unit = object.unit ?? "";
         message.label = object.label ?? "";
         message.requiredTrustLevel = object.requiredTrustLevel ?? undefined;
+        message.options = object.options?.map((e) => e) || [];
         return message;
     },
 };
 function createBaseTypedDevice() {
-    return { deviceId: "", name: "", room: "", floor: "", deviceClass: 0, slots: [], available: false };
+    return { deviceId: "", name: "", room: "", floor: "", deviceClass: 0, slots: [], available: false, subtype: 0 };
 }
 exports.TypedDevice = {
     encode(message, writer = new wire_1.BinaryWriter()) {
@@ -332,6 +385,9 @@ exports.TypedDevice = {
         if (message.available !== false) {
             writer.uint32(56).bool(message.available);
         }
+        if (message.subtype !== 0) {
+            writer.uint32(64).int32(message.subtype);
+        }
         return writer;
     },
     decode(input, length) {
@@ -396,6 +452,13 @@ exports.TypedDevice = {
                         message.available = reader.bool();
                         continue;
                     }
+                    case 8: {
+                        if (tag !== 64) {
+                            break;
+                        }
+                        message.subtype = reader.int32();
+                        continue;
+                    }
                 }
                 if ((tag & 7) === 4 || tag === 0) {
                     break;
@@ -420,6 +483,7 @@ exports.TypedDevice = {
         message.deviceClass = object.deviceClass ?? 0;
         message.slots = object.slots?.map((e) => exports.Slot.fromPartial(e)) || [];
         message.available = object.available ?? false;
+        message.subtype = object.subtype ?? 0;
         return message;
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1kad0/hannah-proto",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "Generated TypeScript gRPC-js client stubs for the Hannah voice assistant proto schema",
   "license": "UNLICENSED",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "@grpc/grpc-js": "^1.14.4"
   },
   "devDependencies": {
-    "@grpc/grpc-js": "1.14.4",
+    "@grpc/grpc-js": "1.14.5",
     "ts-proto": "2.12.1",
     "typescript": "7.0.2"
   },