@kusinta/iot-schema 0.2.0-beta.1 → 0.2.0-beta.10

package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.d.ts

@@ -43,6 +43,11 @@ export declare const HomematicDeviceIdentitySchema: GenMessage<HomematicDeviceId
  * HomeMatic thermostat parameters with no Matter equivalent, carried on the same endpoint
  * as that thermostat's Matter properties rather than instead of them.
  *
+ * "No Matter equivalent" is the entry test, and it is the one to apply before adding a
+ * field here. Valve position failed it: LEVEL is Thermostat/PIHeatingDemand, and it lived
+ * here for a while under the claim that Matter had nothing for it. It is now
+ * device.v1.ThermostatProperties.pi_heating_demand, and field 6 is burned.
+ *
  * Battery state is deliberately NOT here. LOW_BAT and OPERATING_VOLTAGE are Matter's
  * PowerSource cluster, which every battery device from every technology needs, so they
  * belong on a Power Source endpoint. See device/v1/properties.proto.
@@ -52,6 +57,9 @@ export declare const HomematicDeviceIdentitySchema: GenMessage<HomematicDeviceId
  * false means not boosting, control_mode 0 is an HmIP ControlMode value. Absent means never
  * reported; present means a reading, including zero.
  *
+ * Enum parameters cross the wire as the CCU's own index, not as a type this schema defines,
+ * so each one lists its values in its comment. The order is the CCU's; do not renumber it.
+ *
  * Add new fields at the next available number — never reuse a removed one.
  *
  * @generated from message kusinta.iot.vendor.homematic.v1.HmThermostatProps
@@ -63,13 +71,18 @@ export declare type HmThermostatProps = Message<"kusinta.iot.vendor.homematic.v1
   boostMode?: boolean | undefined;
 
   /**
-   * minutes remaining
+   * Seconds remaining, 0-2048 — the CCU counts boost in whole seconds, not minutes.
+   * Default boost is 5 min (300), maximum 30 min (1800).
    *
-   * @generated from field: optional float boost_time_period = 2;
+   * @generated from field: optional uint32 boost_time_remaining = 2;
    */
-  boostTimePeriod?: number | undefined;
+  boostTimeRemaining?: number | undefined;
 
   /**
+   * Write-only on the CCU: it accepts a ControlMode and never reports one back. Carried
+   * here for a future write path, not as a reading — a connector that emits it as a
+   * PropertyUpdate is sending a value the device never gave. 0-3.
+   *
    * @generated from field: optional uint32 control_mode = 3;
    */
   controlMode?: number | undefined;
@@ -80,28 +93,58 @@ export declare type HmThermostatProps = Message<"kusinta.iot.vendor.homematic.v1
   frostProtection?: boolean | undefined;
 
   /**
-   * @generated from field: optional float current_profile_period = 5;
-   */
-  currentProfilePeriod?: number | undefined;
-
-  /**
-   * Valve position, 0.0-1.0 — how far the radiator valve is actually open. The reading
-   * this extension exists for: it has no Matter equivalent, and it is what an automatic
-   * or learned control strategy needs.
+   * Party mode active. A boolean, whatever the old field name suggested.
    *
-   * @generated from field: optional float level = 6;
+   * @generated from field: optional bool party_mode = 5;
    */
-  level?: number | undefined;
+  partyMode?: boolean | undefined;
 
   /**
+   * CLOSED = 0, OPEN = 1
+   *
    * @generated from field: optional uint32 window_state = 7;
    */
   windowState?: number | undefined;
 
   /**
+   * Valve fault and adaption state, nine CCU-defined values. Radiator valves only — a wall
+   * thermostat drives no valve and never reports it.
+   *
    * @generated from field: optional uint32 valve_state = 8;
    */
   valveState?: number | undefined;
+
+  /**
+   * Which schedule the thermostat is following: AUTO = 0, MANU = 1, AWAY = 2, plus a
+   * fourth CCU value. NOT webrtc.v1.SetpointAdjustMode, which names which setpoint a
+   * command targets — a different enum over a different set of concepts.
+   *
+   * @generated from field: optional uint32 set_point_mode = 9;
+   */
+  setPointMode?: number | undefined;
+
+  /**
+   * The active weekly profile: 1-3 on a radiator valve, 1-6 on a wall thermostat. The
+   * upper bound is the device's, not the protocol's.
+   *
+   * @generated from field: optional uint32 active_profile = 10;
+   */
+  activeProfile?: number | undefined;
+
+  /**
+   * Whether the measured temperature is usable: NORMAL = 0, UNKNOWN = 1, OVERFLOW = 2,
+   * UNDERFLOW = 3. A reading beside ACTUAL_TEMPERATURE, not a substitute for it.
+   *
+   * @generated from field: optional uint32 actual_temperature_status = 11;
+   */
+  actualTemperatureStatus?: number | undefined;
+
+  /**
+   * Valve adaption run: writing true starts the valve's stroke calibration.
+   *
+   * @generated from field: optional bool valve_adaption = 12;
+   */
+  valveAdaption?: boolean | undefined;
 };
 
 /**
@@ -110,3 +153,109 @@ export declare type HmThermostatProps = Message<"kusinta.iot.vendor.homematic.v1
  */
 export declare const HmThermostatPropsSchema: GenMessage<HmThermostatProps>;
 
+/**
+ * The maintenance channel every HomeMatic device carries — device health and radio state,
+ * not what the device measures or controls.
+ *
+ * It is device-agnostic: a radiator valve, a wall thermostat and a switch actuator all
+ * report the same core set on the same channel, which is why this is one message rather
+ * than a per-device-type one. Which of these a given device actually has is model-
+ * dependent, and stated per device in device.v1.Endpoint.vendor_attribute_names — SABOTAGE
+ * especially, where "no tamper detected" and "cannot detect tamper" must not render alike.
+ *
+ * Not a Matter endpoint of its own: the maintenance channel is channel 0 upstream, and
+ * Matter reserves endpoint 0 for the root node. A connector puts these readings on the
+ * endpoint whose Matter properties they belong beside — the Power Source endpoint, whose
+ * battery attributes are derived from this same channel's LOW_BAT and OPERATING_VOLTAGE.
+ *
+ * LOW_BAT, OPERATING_VOLTAGE and OPERATING_VOLTAGE_LEVEL are deliberately absent: they are
+ * Matter's PowerSource cluster, and PowerSourceProperties carries them. Only the derived
+ * Matter value has a home there, so the raw OPERATING_VOLTAGE_STATUS enum is kept here.
+ *
+ * Every field is `optional`, for the reason HmThermostatProps gives: ERROR_CODE 0 is "no
+ * error", a reading, and SABOTAGE false is a safety claim.
+ *
+ * @generated from message kusinta.iot.vendor.homematic.v1.HmMaintenanceProps
+ */
+export declare type HmMaintenanceProps = Message<"kusinta.iot.vendor.homematic.v1.HmMaintenanceProps"> & {
+  /**
+   * Device-defined fault code, 0-255, where 0 is no error. Present only on models that
+   * have one.
+   *
+   * @generated from field: optional uint32 error_code = 1;
+   */
+  errorCode?: number | undefined;
+
+  /**
+   * Tamper detection: true means the device reports having been removed or opened. Present
+   * only on models with the hardware for it.
+   *
+   * @generated from field: optional bool sabotage = 2;
+   */
+  sabotage?: boolean | undefined;
+
+  /**
+   * Received signal strength in dBm, -128 to 127, as this device measures it.
+   *
+   * sint32, not uint32: these are negative in normal operation, and an unsigned field would
+   * carry -72 dBm as 4294967224.
+   *
+   * @generated from field: optional sint32 rssi_device = 3;
+   */
+  rssiDevice?: number | undefined;
+
+  /**
+   * The same measurement made at the other end of the link, as reported back.
+   *
+   * @generated from field: optional sint32 rssi_peer = 4;
+   */
+  rssiPeer?: number | undefined;
+
+  /**
+   * Supply state as the CCU reports it: NORMAL = 0, UNKNOWN = 1, OVERFLOW = 2,
+   * EXTERNAL = 3. The raw enum; PowerSourceProperties.status carries the Matter
+   * PowerSourceStatusEnum value derived from it, and the two are not interchangeable.
+   *
+   * @generated from field: optional uint32 operating_voltage_status = 5;
+   */
+  operatingVoltageStatus?: number | undefined;
+
+  /**
+   * True when the gateway has lost contact with the device. Reachability as the upstream
+   * system sees it, which is not the same claim as device.v1.Device.last_seen — that is
+   * when the gateway last had evidence of the device, observed one hop further out.
+   *
+   * @generated from field: optional bool unreach = 6;
+   */
+  unreach?: boolean | undefined;
+
+  /**
+   * True while a configuration change is queued for a device that has not yet woken to
+   * take it. A battery device can sit here for its whole report interval.
+   *
+   * @generated from field: optional bool config_pending = 7;
+   */
+  configPending?: boolean | undefined;
+
+  /**
+   * True while the device has spent its share of the radio band's transmit budget and
+   * must wait before sending again. The 868 MHz band permits roughly one percent duty
+   * cycle, and it regenerates at about that rate per half minute.
+   *
+   * Worth carrying rather than leaving to the connector, because a spent budget is
+   * indistinguishable from a working device that simply has nothing to say: it stays
+   * reachable, reports no error, and silently drops what it was asked to do. Anything
+   * that writes on a schedule needs to be able to see this before it concludes a device
+   * is ignoring it.
+   *
+   * @generated from field: optional bool duty_cycle = 8;
+   */
+  dutyCycle?: boolean | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.vendor.homematic.v1.HmMaintenanceProps.
+ * Use `create(HmMaintenancePropsSchema)` to create a new message.
+ */
+export declare const HmMaintenancePropsSchema: GenMessage<HmMaintenanceProps>;
+

package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.js

@@ -9,7 +9,7 @@ import { file_kusinta_iot_vendor_v1_vendor_options } from "../../v1/vendor_optio
  * Describes the file kusinta/iot/vendor/homematic/v1/homematic.proto.
  */
 export const file_kusinta_iot_vendor_homematic_v1_homematic = /*@__PURE__*/
-  fileDesc("Ci9rdXNpbnRhL2lvdC92ZW5kb3IvaG9tZW1hdGljL3YxL2hvbWVtYXRpYy5wcm90bxIfa3VzaW50YS5pb3QudmVuZG9yLmhvbWVtYXRpYy52MSI4ChdIb21lbWF0aWNEZXZpY2VJZGVudGl0eRIPCgdhZGRyZXNzGAEgASgJEgwKBHR5cGUYAiABKAkipQQKEUhtVGhlcm1vc3RhdFByb3BzEicKCmJvb3N0X21vZGUYASABKAhCDqK1GApCT09TVF9NT0RFSACIAQESLgoRYm9vc3RfdGltZV9wZXJpb2QYAiABKAJCDqK1GApCT09TVF9USU1FSAGIAQESKwoMY29udHJvbF9tb2RlGAMgASgNQhCitRgMQ09OVFJPTF9NT0RFSAKIAQESMwoQZnJvc3RfcHJvdGVjdGlvbhgEIAEoCEIUorUYEEZST1NUX1BST1RFQ1RJT05IA4gBARIzChZjdXJyZW50X3Byb2ZpbGVfcGVyaW9kGAUgASgCQg6itRgKUEFSVFlfTU9ERUgEiAEBEh0KBWxldmVsGAYgASgCQgmitRgFTEVWRUxIBYgBARIrCgx3aW5kb3dfc3RhdGUYByABKA1CEKK1GAxXSU5ET1dfU1RBVEVIBogBARIpCgt2YWx2ZV9zdGF0ZRgIIAEoDUIPorUYC1ZBTFZFX1NUQVRFSAeIAQE6GKq1GBRob21lbWF0aWMudGhlcm1vc3RhdEINCgtfYm9vc3RfbW9kZUIUChJfYm9vc3RfdGltZV9wZXJpb2RCDwoNX2NvbnRyb2xfbW9kZUITChFfZnJvc3RfcHJvdGVjdGlvbkIZChdfY3VycmVudF9wcm9maWxlX3BlcmlvZEIICgZfbGV2ZWxCDwoNX3dpbmRvd19zdGF0ZUIOCgxfdmFsdmVfc3RhdGVCAkgBYgZwcm90bzM", [file_kusinta_iot_vendor_v1_vendor_options]);
+  fileDesc("Ci9rdXNpbnRhL2lvdC92ZW5kb3IvaG9tZW1hdGljL3YxL2hvbWVtYXRpYy5wcm90bxIfa3VzaW50YS5pb3QudmVuZG9yLmhvbWVtYXRpYy52MSI4ChdIb21lbWF0aWNEZXZpY2VJZGVudGl0eRIPCgdhZGRyZXNzGAEgASgJEgwKBHR5cGUYAiABKAki/wYKEUhtVGhlcm1vc3RhdFByb3BzEisKCmJvb3N0X21vZGUYASABKAhCEqK1GApCT09TVF9NT0RF0LUYBkgAiAEBEjUKFGJvb3N0X3RpbWVfcmVtYWluaW5nGAIgASgNQhKitRgKQk9PU1RfVElNRdC1GAVIAYgBARIvCgxjb250cm9sX21vZGUYAyABKA1CFKK1GAxDT05UUk9MX01PREXQtRgCSAKIAQESNwoQZnJvc3RfcHJvdGVjdGlvbhgEIAEoCEIYorUYEEZST1NUX1BST1RFQ1RJT07QtRgFSAOIAQESKwoKcGFydHlfbW9kZRgFIAEoCEISorUYClBBUlRZX01PREXQtRgFSASIAQESLwoMd2luZG93X3N0YXRlGAcgASgNQhSitRgMV0lORE9XX1NUQVRF0LUYB0gFiAEBEi0KC3ZhbHZlX3N0YXRlGAggASgNQhOitRgLVkFMVkVfU1RBVEXQtRgFSAaIAQESMwoOc2V0X3BvaW50X21vZGUYCSABKA1CFqK1GA5TRVRfUE9JTlRfTU9ERdC1GAdIB4gBARIzCg5hY3RpdmVfcHJvZmlsZRgKIAEoDUIWorUYDkFDVElWRV9QUk9GSUxF0LUYB0gIiAEBEkkKGWFjdHVhbF90ZW1wZXJhdHVyZV9zdGF0dXMYCyABKA1CIaK1GBlBQ1RVQUxfVEVNUEVSQVRVUkVfU1RBVFVT0LUYBUgJiAEBEjMKDnZhbHZlX2FkYXB0aW9uGAwgASgIQhaitRgOVkFMVkVfQURBUFRJT07QtRgHSAqIAQE6GKq1GBRob21lbWF0aWMudGhlcm1vc3RhdEINCgtfYm9vc3RfbW9kZUIXChVfYm9vc3RfdGltZV9yZW1haW5pbmdCDwoNX2NvbnRyb2xfbW9kZUITChFfZnJvc3RfcHJvdGVjdGlvbkINCgtfcGFydHlfbW9kZUIPCg1fd2luZG93X3N0YXRlQg4KDF92YWx2ZV9zdGF0ZUIRCg9fc2V0X3BvaW50X21vZGVCEQoPX2FjdGl2ZV9wcm9maWxlQhwKGl9hY3R1YWxfdGVtcGVyYXR1cmVfc3RhdHVzQhEKD192YWx2ZV9hZGFwdGlvbkoECAYQB1IFbGV2ZWxSFmN1cnJlbnRfcHJvZmlsZV9wZXJpb2RSEWJvb3N0X3RpbWVfcGVyaW9kIrYEChJIbU1haW50ZW5hbmNlUHJvcHMSKwoKZXJyb3JfY29kZRgBIAEoDUISorUYCkVSUk9SX0NPREXQtRgFSACIAQESJwoIc2Fib3RhZ2UYAiABKAhCEKK1GAhTQUJPVEFHRdC1GAVIAYgBARItCgtyc3NpX2RldmljZRgDIAEoEUITorUYC1JTU0lfREVWSUNF0LUYBUgCiAEBEikKCXJzc2lfcGVlchgEIAEoEUIRorUYCVJTU0lfUEVFUtC1GAVIA4gBARJHChhvcGVyYXRpbmdfdm9sdGFnZV9zdGF0dXMYBSABKA1CIKK1GBhPUEVSQVRJTkdfVk9MVEFHRV9TVEFUVVPQtRgFSASIAQESJQoHdW5yZWFjaBgGIAEoCEIPorUYB1VOUkVBQ0jQtRgFSAWIAQESMwoOY29uZmlnX3BlbmRpbmcYByABKAhCFqK1GA5DT05GSUdfUEVORElOR9C1GAVIBogBARIrCgpkdXR5X2N5Y2xlGAggASgIQhKitRgKRFVUWV9DWUNMRdC1GAVIB4gBAToZqrUYFWhvbWVtYXRpYy5tYWludGVuYW5jZUINCgtfZXJyb3JfY29kZUILCglfc2Fib3RhZ2VCDgoMX3Jzc2lfZGV2aWNlQgwKCl9yc3NpX3BlZXJCGwoZX29wZXJhdGluZ192b2x0YWdlX3N0YXR1c0IKCghfdW5yZWFjaEIRCg9fY29uZmlnX3BlbmRpbmdCDQoLX2R1dHlfY3ljbGVCAkgBYgZwcm90bzM", [file_kusinta_iot_vendor_v1_vendor_options]);
 
 /**
  * Describes the message kusinta.iot.vendor.homematic.v1.HomematicDeviceIdentity.
@@ -25,3 +25,10 @@ export const HomematicDeviceIdentitySchema = /*@__PURE__*/
 export const HmThermostatPropsSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_vendor_homematic_v1_homematic, 1);
 
+/**
+ * Describes the message kusinta.iot.vendor.homematic.v1.HmMaintenanceProps.
+ * Use `create(HmMaintenancePropsSchema)` to create a new message.
+ */
+export const HmMaintenancePropsSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_vendor_homematic_v1_homematic, 2);
+

package/src/kusinta/iot/vendor/v1/vendor_options_pb.d.ts

@@ -26,6 +26,27 @@ export declare const file_kusinta_iot_vendor_v1_vendor_options: GenFile;
  */
 export declare const vendor_attribute: GenExtension<FieldOptions, string>;
 
+/**
+ * What this vendor parameter supports, as the same bitmask device/v1/matter_options.proto
+ * defines: READ = 1, WRITE = 2, REPORT = 4.
+ *
+ * One mask across both branches on purpose. Bit 4 is Matter's reportable quality and, for
+ * HomeMatic, the parameter's EVENT bit — the same fact under two names, so a consumer
+ * deciding whether to draw a control or a reading asks one question either way.
+ *
+ * Where the value comes from is the difference. The Matter side reads its mask off the
+ * specification; a vendor parameter has no spec to defer to, so this is the upstream
+ * system's own answer about its own parameter — for HomeMatic, the OPERATIONS value the
+ * CCU reports in getParamsetDescription().
+ *
+ * Not permission, and not the implemented set: see matter_attribute_capabilities for both
+ * distinctions. The vendor mirror of the implemented set is
+ * device.v1.Endpoint.vendor_attribute_names.
+ *
+ * @generated from extension: uint32 vendor_attribute_capabilities = 50010;
+ */
+export declare const vendor_attribute_capabilities: GenExtension<FieldOptions, number>;
+
 /**
  * The stable key identifying a vendor extension message, e.g. "homematic.thermostat".
  * Matches device.v1.PropertyUpdate.vendor_extension byte for byte, and is what selects

package/src/kusinta/iot/vendor/v1/vendor_options_pb.js

@@ -9,7 +9,7 @@ import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
  * Describes the file kusinta/iot/vendor/v1/vendor_options.proto.
  */
 export const file_kusinta_iot_vendor_v1_vendor_options = /*@__PURE__*/
-  fileDesc("CiprdXNpbnRhL2lvdC92ZW5kb3IvdjEvdmVuZG9yX29wdGlvbnMucHJvdG8SFWt1c2ludGEuaW90LnZlbmRvci52MTpKChB2ZW5kb3JfYXR0cmlidXRlEh0uZ29vZ2xlLnByb3RvYnVmLkZpZWxkT3B0aW9ucxjUhgMgASgJUg92ZW5kb3JBdHRyaWJ1dGU6TAoQdmVuZG9yX2V4dGVuc2lvbhIfLmdvb2dsZS5wcm90b2J1Zi5NZXNzYWdlT3B0aW9ucxjVhgMgASgJUg92ZW5kb3JFeHRlbnNpb25iBnByb3RvMw", [file_google_protobuf_descriptor]);
+  fileDesc("CiprdXNpbnRhL2lvdC92ZW5kb3IvdjEvdmVuZG9yX29wdGlvbnMucHJvdG8SFWt1c2ludGEuaW90LnZlbmRvci52MTpKChB2ZW5kb3JfYXR0cmlidXRlEh0uZ29vZ2xlLnByb3RvYnVmLkZpZWxkT3B0aW9ucxjUhgMgASgJUg92ZW5kb3JBdHRyaWJ1dGU6YwoddmVuZG9yX2F0dHJpYnV0ZV9jYXBhYmlsaXRpZXMSHS5nb29nbGUucHJvdG9idWYuRmllbGRPcHRpb25zGNqGAyABKA1SG3ZlbmRvckF0dHJpYnV0ZUNhcGFiaWxpdGllczpMChB2ZW5kb3JfZXh0ZW5zaW9uEh8uZ29vZ2xlLnByb3RvYnVmLk1lc3NhZ2VPcHRpb25zGNWGAyABKAlSD3ZlbmRvckV4dGVuc2lvbmIGcHJvdG8z", [file_google_protobuf_descriptor]);
 
 /**
  * The vendor parameter this field carries, in the vendor's own spelling — e.g.
@@ -28,6 +28,28 @@ export const file_kusinta_iot_vendor_v1_vendor_options = /*@__PURE__*/
 export const vendor_attribute = /*@__PURE__*/
   extDesc(file_kusinta_iot_vendor_v1_vendor_options, 0);
 
+/**
+ * What this vendor parameter supports, as the same bitmask device/v1/matter_options.proto
+ * defines: READ = 1, WRITE = 2, REPORT = 4.
+ *
+ * One mask across both branches on purpose. Bit 4 is Matter's reportable quality and, for
+ * HomeMatic, the parameter's EVENT bit — the same fact under two names, so a consumer
+ * deciding whether to draw a control or a reading asks one question either way.
+ *
+ * Where the value comes from is the difference. The Matter side reads its mask off the
+ * specification; a vendor parameter has no spec to defer to, so this is the upstream
+ * system's own answer about its own parameter — for HomeMatic, the OPERATIONS value the
+ * CCU reports in getParamsetDescription().
+ *
+ * Not permission, and not the implemented set: see matter_attribute_capabilities for both
+ * distinctions. The vendor mirror of the implemented set is
+ * device.v1.Endpoint.vendor_attribute_names.
+ *
+ * @generated from extension: uint32 vendor_attribute_capabilities = 50010;
+ */
+export const vendor_attribute_capabilities = /*@__PURE__*/
+  extDesc(file_kusinta_iot_vendor_v1_vendor_options, 1);
+
 /**
  * The stable key identifying a vendor extension message, e.g. "homematic.thermostat".
  * Matches device.v1.PropertyUpdate.vendor_extension byte for byte, and is what selects
@@ -49,5 +71,5 @@ export const vendor_attribute = /*@__PURE__*/
  * @generated from extension: string vendor_extension = 50005;
  */
 export const vendor_extension = /*@__PURE__*/
-  extDesc(file_kusinta_iot_vendor_v1_vendor_options, 1);
+  extDesc(file_kusinta_iot_vendor_v1_vendor_options, 2);
 

package/src/kusinta/iot/webrtc/v1/command_pb.d.ts

@@ -4,6 +4,7 @@
 
 import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
+import type { SetpointAdjustMode } from "./setpoint_mode_pb.js";
 import type { DeviceId } from "../../identity/v1/identity_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 import type { AttributeRef } from "../../access/v1/acl_pb.js";
@@ -28,11 +29,11 @@ export declare const file_kusinta_iot_webrtc_v1_command: GenFile;
  */
 export declare type ThermostatSetpointParams = Message<"kusinta.iot.webrtc.v1.ThermostatSetpointParams"> & {
   /**
-   * SetpointAdjustMode, see above
+   * absent = the producer stated no mode
    *
-   * @generated from field: optional uint32 mode = 1;
+   * @generated from field: optional kusinta.iot.webrtc.v1.SetpointAdjustMode mode = 1;
    */
-  mode?: number | undefined;
+  mode?: SetpointAdjustMode | undefined;
 
   /**
    * centidegrees delta
@@ -147,9 +148,16 @@ export declare const DoorLockParamsSchema: GenMessage<DoorLockParams>;
  *
  * An app MAY send any command; it does not decide whether it is allowed. The gateway
  * authorizes every DeviceCommand against the caller's access.v1.DeviceAcl for the target
- * device before forwarding it to a connector — the command must be permitted by
- * PERMISSION_ACTION_INVOKE, must target an attribute the ACL's allowed_attribute_refs
- * reaches, and must respect any PropertyConstraint bounding the value.
+ * device before forwarding it to a connector: PERMISSION_ACTION_INVOKE must be granted,
+ * and allowed_command_refs must reach this (endpoint, cluster_id, matter_command_id).
+ *
+ * NOT allowed_attribute_refs, and NOT PropertyConstraint. Both name attributes, and a
+ * command is not an attribute — the two are numbered independently within a cluster, so an
+ * attribute ref cannot name a command at all. A constraint bounds an attribute's value;
+ * this message carries command arguments, and ThermostatSetpointParams.amount is a DELTA,
+ * which cannot be compared against a bound without first resolving it to an absolute using
+ * a base the gateway may not hold. Where a setpoint must be bounded, bound the write:
+ * AttributeWriteRequest carries the absolute value a PropertyConstraint can be applied to.
  *
  * A refusal comes back as an ordinary CommandResult with success = false and an error,
  * NOT as a session-level GatewayError: one command being refused says nothing about the

package/src/kusinta/iot/webrtc/v1/command_pb.js

@@ -8,12 +8,13 @@ import { file_kusinta_iot_access_v1_acl } from "../../access/v1/acl_pb.js";
 import { file_kusinta_iot_device_v1_cluster_state } from "../../device/v1/cluster_state_pb.js";
 import { file_kusinta_iot_device_v1_matter_options } from "../../device/v1/matter_options_pb.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+import { file_kusinta_iot_webrtc_v1_setpoint_mode } from "./setpoint_mode_pb.js";
 
 /**
  * Describes the file kusinta/iot/webrtc/v1/command.proto.
  */
 export const file_kusinta_iot_webrtc_v1_command = /*@__PURE__*/
-  fileDesc("CiNrdXNpbnRhL2lvdC93ZWJydGMvdjEvY29tbWFuZC5wcm90bxIVa3VzaW50YS5pb3Qud2VicnRjLnYxIlEKGFRoZXJtb3N0YXRTZXRwb2ludFBhcmFtcxIRCgRtb2RlGAEgASgNSACIAQESDgoGYW1vdW50GAIgASgROgm4tRiBBMC1GABCBwoFX21vZGUiRgoSTGV2ZWxDb250cm9sUGFyYW1zEg0KBWxldmVsGAEgASgNEhcKD3RyYW5zaXRpb25fdGltZRgCIAEoDToIuLUYCMC1GAAiKwoLT25PZmZQYXJhbXM6BLi1GAZKBAgBEAJKBAgCEANSAm9uUgZ0b2dnbGUiQQoYV2luZG93Q292ZXJpbmdMaWZ0UGFyYW1zEhoKEmxpZnRfcGVyY2VudDEwMHRocxgBIAEoDToJuLUYggLAtRgFIjsKDkRvb3JMb2NrUGFyYW1zEhAKCHBpbl9jb2RlGAIgASgJOgW4tRiBAkoECAEQAlIKbG9ja19zdGF0ZSKSBQoNRGV2aWNlQ29tbWFuZBISCgpyZXF1ZXN0X2lkGAEgASgJEjQKCWRldmljZV9pZBgCIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhQKDGNvbW1hbmRfbmFtZRgEIAEoCRISCgpjbHVzdGVyX2lkGAwgASgNEh4KEW1hdHRlcl9jb21tYW5kX2lkGA0gASgNSAGIAQESGAoLZW5kcG9pbnRfaWQYCyABKA1IAogBARJOChN0aGVybW9zdGF0X3NldHBvaW50GAUgASgLMi8ua3VzaW50YS5pb3Qud2VicnRjLnYxLlRoZXJtb3N0YXRTZXRwb2ludFBhcmFtc0gAEkIKDWxldmVsX2NvbnRyb2wYBiABKAsyKS5rdXNpbnRhLmlvdC53ZWJydGMudjEuTGV2ZWxDb250cm9sUGFyYW1zSAASNAoGb25fb2ZmGAcgASgLMiIua3VzaW50YS5pb3Qud2VicnRjLnYxLk9uT2ZmUGFyYW1zSAASTwoUd2luZG93X2NvdmVyaW5nX2xpZnQYCCABKAsyLy5rdXNpbnRhLmlvdC53ZWJydGMudjEuV2luZG93Q292ZXJpbmdMaWZ0UGFyYW1zSAASOgoJZG9vcl9sb2NrGAkgASgLMiUua3VzaW50YS5pb3Qud2VicnRjLnYxLkRvb3JMb2NrUGFyYW1zSAASEQoHcmF3X3RsdhhjIAEoDEgAQgwKCnBhcmFtZXRlcnNCFAoSX21hdHRlcl9jb21tYW5kX2lkQg4KDF9lbmRwb2ludF9pZEoECAMQBEoECAoQC1IOY2x1c3Rlcl9pZF9oZXhSGXRoZXJtb3N0YXRfc2V0cG9pbnRfd3JpdGUiXAoMQ29tbWFuZEVycm9yEg8KB21lc3NhZ2UYAiABKAkSNQoEY29kZRgDIAEoDjInLmt1c2ludGEuaW90LndlYnJ0Yy52MS5Db21tYW5kRXJyb3JDb2RlSgQIARACIt4BCg1Db21tYW5kUmVzdWx0EhIKCnJlcXVlc3RfaWQYASABKAkSDwoHc3VjY2VzcxgCIAEoCBIyCgVlcnJvchgDIAEoCzIjLmt1c2ludGEuaW90LndlYnJ0Yy52MS5Db21tYW5kRXJyb3ISMAoMY29tcGxldGVkX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIzCgpzZXR0bGVzX2J5GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgAiAEBQg0KC19zZXR0bGVzX2J5IswBChVBdHRyaWJ1dGVXcml0ZVJlcXVlc3QSEgoKcmVxdWVzdF9pZBgBIAEoCRI0CglkZXZpY2VfaWQYAiABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCgZ0YXJnZXQYAyABKAsyIy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuQXR0cmlidXRlUmVmEjQKBXZhbHVlGAQgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlKr8CChBDb21tYW5kRXJyb3JDb2RlEiIKHkNPTU1BTkRfRVJST1JfQ09ERV9VTlNQRUNJRklFRBAAEiMKH0NPTU1BTkRfRVJST1JfQ09ERV9OT1RfRU5USVRMRUQQARIqCiZDT01NQU5EX0VSUk9SX0NPREVfQ09OU1RSQUlOVF9WSU9MQVRFRBACEiYKIkNPTU1BTkRfRVJST1JfQ09ERV9JTlZBTElEX0NPTU1BTkQQAxIiCh5DT01NQU5EX0VSUk9SX0NPREVfVU5SRUFDSEFCTEUQBBIeChpDT01NQU5EX0VSUk9SX0NPREVfVElNRU9VVBAFEikKJUNPTU1BTkRfRVJST1JfQ09ERV9SRUpFQ1RFRF9CWV9ERVZJQ0UQBhIfChtDT01NQU5EX0VSUk9SX0NPREVfSU5URVJOQUwQB0ICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_device_v1_matter_options, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CiNrdXNpbnRhL2lvdC93ZWJydGMvdjEvY29tbWFuZC5wcm90bxIVa3VzaW50YS5pb3Qud2VicnRjLnYxInwKGFRoZXJtb3N0YXRTZXRwb2ludFBhcmFtcxI8CgRtb2RlGAEgASgOMikua3VzaW50YS5pb3Qud2VicnRjLnYxLlNldHBvaW50QWRqdXN0TW9kZUgAiAEBEg4KBmFtb3VudBgCIAEoEToJuLUYgQTAtRgAQgcKBV9tb2RlIkYKEkxldmVsQ29udHJvbFBhcmFtcxINCgVsZXZlbBgBIAEoDRIXCg90cmFuc2l0aW9uX3RpbWUYAiABKA06CLi1GAjAtRgAIisKC09uT2ZmUGFyYW1zOgS4tRgGSgQIARACSgQIAhADUgJvblIGdG9nZ2xlIkEKGFdpbmRvd0NvdmVyaW5nTGlmdFBhcmFtcxIaChJsaWZ0X3BlcmNlbnQxMDB0aHMYASABKA06Cbi1GIICwLUYBSI7Cg5Eb29yTG9ja1BhcmFtcxIQCghwaW5fY29kZRgCIAEoCToFuLUYgQJKBAgBEAJSCmxvY2tfc3RhdGUikgUKDURldmljZUNvbW1hbmQSEgoKcmVxdWVzdF9pZBgBIAEoCRI0CglkZXZpY2VfaWQYAiABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIUCgxjb21tYW5kX25hbWUYBCABKAkSEgoKY2x1c3Rlcl9pZBgMIAEoDRIeChFtYXR0ZXJfY29tbWFuZF9pZBgNIAEoDUgBiAEBEhgKC2VuZHBvaW50X2lkGAsgASgNSAKIAQESTgoTdGhlcm1vc3RhdF9zZXRwb2ludBgFIAEoCzIvLmt1c2ludGEuaW90LndlYnJ0Yy52MS5UaGVybW9zdGF0U2V0cG9pbnRQYXJhbXNIABJCCg1sZXZlbF9jb250cm9sGAYgASgLMikua3VzaW50YS5pb3Qud2VicnRjLnYxLkxldmVsQ29udHJvbFBhcmFtc0gAEjQKBm9uX29mZhgHIAEoCzIiLmt1c2ludGEuaW90LndlYnJ0Yy52MS5Pbk9mZlBhcmFtc0gAEk8KFHdpbmRvd19jb3ZlcmluZ19saWZ0GAggASgLMi8ua3VzaW50YS5pb3Qud2VicnRjLnYxLldpbmRvd0NvdmVyaW5nTGlmdFBhcmFtc0gAEjoKCWRvb3JfbG9jaxgJIAEoCzIlLmt1c2ludGEuaW90LndlYnJ0Yy52MS5Eb29yTG9ja1BhcmFtc0gAEhEKB3Jhd190bHYYYyABKAxIAEIMCgpwYXJhbWV0ZXJzQhQKEl9tYXR0ZXJfY29tbWFuZF9pZEIOCgxfZW5kcG9pbnRfaWRKBAgDEARKBAgKEAtSDmNsdXN0ZXJfaWRfaGV4Uhl0aGVybW9zdGF0X3NldHBvaW50X3dyaXRlIlwKDENvbW1hbmRFcnJvchIPCgdtZXNzYWdlGAIgASgJEjUKBGNvZGUYAyABKA4yJy5rdXNpbnRhLmlvdC53ZWJydGMudjEuQ29tbWFuZEVycm9yQ29kZUoECAEQAiLeAQoNQ29tbWFuZFJlc3VsdBISCgpyZXF1ZXN0X2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSMgoFZXJyb3IYAyABKAsyIy5rdXNpbnRhLmlvdC53ZWJydGMudjEuQ29tbWFuZEVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASMwoKc2V0dGxlc19ieRgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAIgBAUINCgtfc2V0dGxlc19ieSLMAQoVQXR0cmlidXRlV3JpdGVSZXF1ZXN0EhIKCnJlcXVlc3RfaWQYASABKAkSNAoJZGV2aWNlX2lkGAIgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSMwoGdGFyZ2V0GAMgASgLMiMua3VzaW50YS5pb3QuYWNjZXNzLnYxLkF0dHJpYnV0ZVJlZhI0CgV2YWx1ZRgEIAEoCzIlLmt1c2ludGEuaW90LmRldmljZS52MS5BdHRyaWJ1dGVWYWx1ZSq/AgoQQ29tbWFuZEVycm9yQ29kZRIiCh5DT01NQU5EX0VSUk9SX0NPREVfVU5TUEVDSUZJRUQQABIjCh9DT01NQU5EX0VSUk9SX0NPREVfTk9UX0VOVElUTEVEEAESKgomQ09NTUFORF9FUlJPUl9DT0RFX0NPTlNUUkFJTlRfVklPTEFURUQQAhImCiJDT01NQU5EX0VSUk9SX0NPREVfSU5WQUxJRF9DT01NQU5EEAMSIgoeQ09NTUFORF9FUlJPUl9DT0RFX1VOUkVBQ0hBQkxFEAQSHgoaQ09NTUFORF9FUlJPUl9DT0RFX1RJTUVPVVQQBRIpCiVDT01NQU5EX0VSUk9SX0NPREVfUkVKRUNURURfQllfREVWSUNFEAYSHwobQ09NTUFORF9FUlJPUl9DT0RFX0lOVEVSTkFMEAdCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_device_v1_matter_options, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_webrtc_v1_setpoint_mode]);
 
 /**
  * Describes the message kusinta.iot.webrtc.v1.ThermostatSetpointParams.

package/src/kusinta/iot/webrtc/v1/device_state_pb.d.ts

@@ -44,11 +44,17 @@ export declare type DeviceStateSnapshot = Message<"kusinta.iot.webrtc.v1.DeviceS
 export declare const DeviceStateSnapshotSchema: GenMessage<DeviceStateSnapshot>;
 
 /**
- * Single property change event streamed to the app in real time.
+ * One attribute reading streamed to the app as it happens — Matter's Report Data Action,
+ * for a single attribute.
  *
- * @generated from message kusinta.iot.webrtc.v1.DevicePropertyEvent
+ * Was DevicePropertyEvent. Renamed because it carries a device.v1.PropertyUpdate, which is
+ * STATE, while device.v1.DeviceEvent carries a journal entry. Two messages with "Event" in
+ * the name meaning opposite things is a trap, and this one was never the event: latest
+ * wins, order does not matter, and a missed one is corrected by the next.
+ *
+ * @generated from message kusinta.iot.webrtc.v1.PropertyReport
  */
-export declare type DevicePropertyEvent = Message<"kusinta.iot.webrtc.v1.DevicePropertyEvent"> & {
+export declare type PropertyReport = Message<"kusinta.iot.webrtc.v1.PropertyReport"> & {
   /**
    * @generated from field: kusinta.iot.device.v1.PropertyUpdate update = 1;
    */
@@ -61,10 +67,10 @@ export declare type DevicePropertyEvent = Message<"kusinta.iot.webrtc.v1.DeviceP
 };
 
 /**
- * Describes the message kusinta.iot.webrtc.v1.DevicePropertyEvent.
- * Use `create(DevicePropertyEventSchema)` to create a new message.
+ * Describes the message kusinta.iot.webrtc.v1.PropertyReport.
+ * Use `create(PropertyReportSchema)` to create a new message.
  */
-export declare const DevicePropertyEventSchema: GenMessage<DevicePropertyEvent>;
+export declare const PropertyReportSchema: GenMessage<PropertyReport>;
 
 /**
  * A device appeared while the app was connected — the app leg's counterpart to

package/src/kusinta/iot/webrtc/v1/device_state_pb.js

@@ -4,16 +4,16 @@
 
 import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_kusinta_iot_access_v1_acl } from "../../access/v1/acl_pb.js";
 import { file_kusinta_iot_device_v1_device } from "../../device/v1/device_pb.js";
 import { file_kusinta_iot_device_v1_property_update } from "../../device/v1/property_update_pb.js";
-import { file_kusinta_iot_access_v1_acl } from "../../access/v1/acl_pb.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
 
 /**
  * Describes the file kusinta/iot/webrtc/v1/device_state.proto.
  */
 export const file_kusinta_iot_webrtc_v1_device_state = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC93ZWJydGMvdjEvZGV2aWNlX3N0YXRlLnByb3RvEhVrdXNpbnRhLmlvdC53ZWJydGMudjEiuwEKE0RldmljZVN0YXRlU25hcHNob3QSLgoHZGV2aWNlcxgBIAMoCzIdLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2USQAoLcGVybWlzc2lvbnMYAiABKAsyKy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuRWZmZWN0aXZlUGVybWlzc2lvbnMSMgoOc25hcHNob3R0ZWRfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIoYBChNEZXZpY2VQcm9wZXJ0eUV2ZW50EjUKBnVwZGF0ZRgBIAEoCzIlLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZRI4ChRnYXRld2F5X3Byb2Nlc3NlZF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiPAoLRGV2aWNlQWRkZWQSLQoGZGV2aWNlGAEgASgLMh0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZSJVCg1EZXZpY2VSZW1vdmVkEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCUICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_access_v1_acl, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CihrdXNpbnRhL2lvdC93ZWJydGMvdjEvZGV2aWNlX3N0YXRlLnByb3RvEhVrdXNpbnRhLmlvdC53ZWJydGMudjEiuwEKE0RldmljZVN0YXRlU25hcHNob3QSLgoHZGV2aWNlcxgBIAMoCzIdLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2USQAoLcGVybWlzc2lvbnMYAiABKAsyKy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuRWZmZWN0aXZlUGVybWlzc2lvbnMSMgoOc25hcHNob3R0ZWRfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIoEBCg5Qcm9wZXJ0eVJlcG9ydBI1CgZ1cGRhdGUYASABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuUHJvcGVydHlVcGRhdGUSOAoUZ2F0ZXdheV9wcm9jZXNzZWRfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIjwKC0RldmljZUFkZGVkEi0KBmRldmljZRgBIAEoCzIdLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2UiVQoNRGV2aWNlUmVtb3ZlZBI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIOCgZyZWFzb24YAiABKAlCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.webrtc.v1.DeviceStateSnapshot.
@@ -23,10 +23,10 @@ export const DeviceStateSnapshotSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_webrtc_v1_device_state, 0);
 
 /**
- * Describes the message kusinta.iot.webrtc.v1.DevicePropertyEvent.
- * Use `create(DevicePropertyEventSchema)` to create a new message.
+ * Describes the message kusinta.iot.webrtc.v1.PropertyReport.
+ * Use `create(PropertyReportSchema)` to create a new message.
  */
-export const DevicePropertyEventSchema = /*@__PURE__*/
+export const PropertyReportSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_webrtc_v1_device_state, 1);
 
 /**