@kusinta/iot-schema 0.2.0-beta.3 → 0.2.0-beta.30

package/src/kusinta/iot/space/v1/space_pb.d.ts

@@ -6,6 +6,8 @@ import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 import type { DeviceId, GatewayId, SpaceId, TenantId, UserId } from "../../identity/v1/identity_pb.js";
 import type { SpaceType } from "../../common/v1/types_pb.js";
+import type { MembershipRelation } from "../../access/v1/roles_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
 
 /**
  * Describes the file kusinta/iot/space/v1/space.proto.
@@ -51,19 +53,27 @@ export declare type Space = Message<"kusinta.iot.space.v1.Space"> & {
   parentSpaceId?: SpaceId | undefined;
 
   /**
+   * Filtered to the spaces the caller reaches, as device_ids is.
+   *
    * @generated from field: repeated kusinta.iot.identity.v1.SpaceId sub_space_ids = 7;
    */
   subSpaceIds: SpaceId[];
 
   /**
+   * Filtered to the devices the caller may see (see webrtc.v1.SpaceTree): for service, no
+   * device a resident owns.
+   *
    * @generated from field: repeated kusinta.iot.identity.v1.DeviceId device_ids = 8;
    */
   deviceIds: DeviceId[];
 
   /**
-   * only for APARTMENT
+   * Superseded by members, which can say that more than one person lives in an apartment,
+   * and how each member stands to the space. A gateway leaves it unset, so a client that
+   * still reads it sees no resident anywhere; read members instead.
    *
-   * @generated from field: kusinta.iot.identity.v1.UserId resident_user_id = 9;
+   * @generated from field: kusinta.iot.identity.v1.UserId resident_user_id = 9 [deprecated = true];
+   * @deprecated
    */
   residentUserId?: UserId | undefined;
 
@@ -76,6 +86,49 @@ export declare type Space = Message<"kusinta.iot.space.v1.Space"> & {
    * @generated from field: kusinta.iot.identity.v1.GatewayId gateway_id = 11;
    */
   gatewayId?: GatewayId | undefined;
+
+  /**
+   * An IANA time zone name, e.g. "Europe/Stockholm". Written on the building — the
+   * top-level space. When listing, a gateway fills it on every space with the effective
+   * value, inherited from the nearest ancestor that has one, so every listed space
+   * carries it. Empty means unknown, not UTC.
+   *
+   * @generated from field: string time_zone = 12;
+   */
+  timeZone: string;
+
+  /**
+   * Who is filed directly on this space, and how each stands to it. Members of a space
+   * above it are listed there, not here.
+   *
+   * Filled according to who asks, since a membership list says who lives where:
+   *
+   *   * a caller holding ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN who reaches the space
+   *     sees every member save as below, in a home they see as service too, as the
+   *     members change;
+   *   * a resident of an apartment sees every member filed on it or on its rooms — who they
+   *     live with, and anyone filed on their home as service, since being filed on a home
+   *     is an act on it its residents should see. Service reach from a building or floor
+   *     above is not listed; webrtc.v1.PrivacyDisclosure tells them what kinds of party
+   *     hold it, and who, without saying where anyone lives;
+   *   * anyone else sees none, residents of a building or floor included.
+   *
+   * Whoever it is listed to, a member who is staff (access.v1.Role, STAFF) and lives in a
+   * home has that RESIDENT membership left out for every caller who does not live in that
+   * home, a property owner and an administrator included: a staff member's residency is
+   * told only to its household. Their SERVICE memberships are listed as any member's.
+   *
+   * @generated from field: repeated kusinta.iot.space.v1.SpaceMember members = 13;
+   */
+  members: SpaceMember[];
+
+  /**
+   * Set when members are not listed to this caller, so that an empty list is not read as
+   * nobody being filed here.
+   *
+   * @generated from field: bool members_withheld = 14;
+   */
+  membersWithheld: boolean;
 };
 
 /**
@@ -84,3 +137,51 @@ export declare type Space = Message<"kusinta.iot.space.v1.Space"> & {
  */
 export declare const SpaceSchema: GenMessage<Space>;
 
+/**
+ * One membership of a space.
+ *
+ * @generated from message kusinta.iot.space.v1.SpaceMember
+ */
+export declare type SpaceMember = Message<"kusinta.iot.space.v1.SpaceMember"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.UserId user_id = 1;
+   */
+  userId?: UserId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.access.v1.MembershipRelation relation = 2;
+   */
+  relation: MembershipRelation;
+
+  /**
+   * The name the member gave, self-chosen and not verified, so the app shows it as the name
+   * they gave rather than as an identity. Given to a caller who is a resident of the
+   * apartment the member is filed on, or on one of its rooms: the people they live with,
+   * and anyone filed on their home as service, whom webrtc.v1.PrivacyDisclosure already
+   * names to them. Given also, for a member who is staff (access.v1.Role, STAFF), to a
+   * caller holding ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN, as webrtc.v1.MemberDetail.name
+   * names them. Empty for every other caller — service, residents of any other home, and a
+   * property owner or an administrator for a member who is not staff — and for a member
+   * whose name the gateway has not learnt. A caller given names reads an empty one as not
+   * known; anyone else is given none. Residents are named only to their own home.
+   *
+   * @generated from field: string name = 3;
+   */
+  name: string;
+
+  /**
+   * As webrtc.v1.MemberSpace.since: the start of the day, in the building's time zone, on
+   * which this membership began; for a resident, the current unbroken residency. Never finer
+   * than a day. Unset where the gateway holds no record of it.
+   *
+   * @generated from field: google.protobuf.Timestamp since = 4;
+   */
+  since?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.space.v1.SpaceMember.
+ * Use `create(SpaceMemberSchema)` to create a new message.
+ */
+export declare const SpaceMemberSchema: GenMessage<SpaceMember>;
+

package/src/kusinta/iot/space/v1/space_pb.js

@@ -3,6 +3,8 @@
 /* eslint-disable */
 
 import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_kusinta_iot_access_v1_roles } from "../../access/v1/roles_pb.js";
 import { file_kusinta_iot_common_v1_types } from "../../common/v1/types_pb.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
 
@@ -10,7 +12,7 @@ import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identit
  * Describes the file kusinta/iot/space/v1/space.proto.
  */
 export const file_kusinta_iot_space_v1_space = /*@__PURE__*/
-  fileDesc("CiBrdXNpbnRhL2lvdC9zcGFjZS92MS9zcGFjZS5wcm90bxIUa3VzaW50YS5pb3Quc3BhY2UudjEi9wMKBVNwYWNlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI0CgpzcGFjZV90eXBlGAIgASgOMiAua3VzaW50YS5pb3QuY29tbW9uLnYxLlNwYWNlVHlwZRIMCgRuYW1lGAMgASgJEhMKC2Rlc2NyaXB0aW9uGAQgASgJEg0KBWZsb29yGAUgASgFEjkKD3BhcmVudF9zcGFjZV9pZBgGIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNwoNc3ViX3NwYWNlX2lkcxgHIAMoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNQoKZGV2aWNlX2lkcxgIIAMoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEjkKEHJlc2lkZW50X3VzZXJfaWQYCSABKAsyHy5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5Vc2VySWQSNAoJdGVuYW50X2lkGAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVGVuYW50SWQSNgoKZ2F0ZXdheV9pZBgLIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZEICSAFiBnByb3RvMw", [file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CiBrdXNpbnRhL2lvdC9zcGFjZS92MS9zcGFjZS5wcm90bxIUa3VzaW50YS5pb3Quc3BhY2UudjEi3AQKBVNwYWNlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI0CgpzcGFjZV90eXBlGAIgASgOMiAua3VzaW50YS5pb3QuY29tbW9uLnYxLlNwYWNlVHlwZRIMCgRuYW1lGAMgASgJEhMKC2Rlc2NyaXB0aW9uGAQgASgJEg0KBWZsb29yGAUgASgFEjkKD3BhcmVudF9zcGFjZV9pZBgGIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNwoNc3ViX3NwYWNlX2lkcxgHIAMoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNQoKZGV2aWNlX2lkcxgIIAMoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEj0KEHJlc2lkZW50X3VzZXJfaWQYCSABKAsyHy5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5Vc2VySWRCAhgBEjQKCXRlbmFudF9pZBgKIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlRlbmFudElkEjYKCmdhdGV3YXlfaWQYCyABKAsyIi5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5HYXRld2F5SWQSEQoJdGltZV96b25lGAwgASgJEjIKB21lbWJlcnMYDSADKAsyIS5rdXNpbnRhLmlvdC5zcGFjZS52MS5TcGFjZU1lbWJlchIYChBtZW1iZXJzX3dpdGhoZWxkGA4gASgIIrUBCgtTcGFjZU1lbWJlchIwCgd1c2VyX2lkGAEgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEjsKCHJlbGF0aW9uGAIgASgOMikua3VzaW50YS5pb3QuYWNjZXNzLnYxLk1lbWJlcnNoaXBSZWxhdGlvbhIMCgRuYW1lGAMgASgJEikKBXNpbmNlGAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_roles, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.space.v1.Space.
@@ -19,3 +21,10 @@ export const file_kusinta_iot_space_v1_space = /*@__PURE__*/
 export const SpaceSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_space_v1_space, 0);
 
+/**
+ * Describes the message kusinta.iot.space.v1.SpaceMember.
+ * Use `create(SpaceMemberSchema)` to create a new message.
+ */
+export const SpaceMemberSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_space_v1_space, 1);
+

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/lorawan/v1/lorawan_pb.d.ts

@@ -0,0 +1,69 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/vendor/lorawan/v1/lorawan.proto (package kusinta.iot.vendor.lorawan.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file kusinta/iot/vendor/lorawan/v1/lorawan.proto.
+ */
+export declare const file_kusinta_iot_vendor_lorawan_v1_lorawan: GenFile;
+
+/**
+ * What a LoRaWAN network server needs to admit a device, carried in the `lorawan`
+ * arm of webrtc.v1.ProvisionDevice.credentials. A provisioning arm per technology,
+ * not a flat set of fields shared across them, so the next technology to be
+ * provisioned does not turn a message into a bag of optionals named after this one.
+ *
+ * These are onboarding credentials, not device readings: this message is never an
+ * Endpoint vendor extension and carries no vendor_extension option, unlike the
+ * vendor.homematic.v1 property messages.
+ *
+ * @generated from message kusinta.iot.vendor.lorawan.v1.LorawanProvisioning
+ */
+export declare type LorawanProvisioning = Message<"kusinta.iot.vendor.lorawan.v1.LorawanProvisioning"> & {
+  /**
+   * The device's globally unique identifier, sixteen hex characters as printed on
+   * the label. This is also what the device is claimed by — the connector derives
+   * the device id from it and reports it as DeviceDescriptor.serial_number — so a
+   * device can be claimed by its label before it has ever joined.
+   *
+   * @generated from field: string dev_eui = 1;
+   */
+  devEui: string;
+
+  /**
+   * The application root key: the secret every session key is derived from, thirty-
+   * two hex characters. Not an identifier, and handled unlike every other field
+   * here — carried only over the authenticated app-to-gateway leg, held in the
+   * secret store where a key is generated or kept, never logged, never persisted
+   * beyond the write that registers the device, and never echoed back in any
+   * listing.
+   *
+   * It is on the wire at all because the first supported devices leave no choice:
+   * their key is fixed in the factory and printed on the label, so a network server
+   * cannot generate one and have the device adopt it. A device that can be
+   * reprogrammed with a server-generated key would leave this empty and have the
+   * registry mint it instead.
+   *
+   * @generated from field: string app_key = 2;
+   */
+  appKey: string;
+
+  /**
+   * The join identifier (JoinEUI/AppEUI), sixteen hex characters. Optional: many
+   * deployments accept the default a device ships with, and only a network server
+   * that pins it needs the value stated here.
+   *
+   * @generated from field: optional string join_eui = 3;
+   */
+  joinEui?: string | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.vendor.lorawan.v1.LorawanProvisioning.
+ * Use `create(LorawanProvisioningSchema)` to create a new message.
+ */
+export declare const LorawanProvisioningSchema: GenMessage<LorawanProvisioning>;
+

package/src/kusinta/iot/vendor/lorawan/v1/lorawan_pb.js

@@ -0,0 +1,19 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/vendor/lorawan/v1/lorawan.proto (package kusinta.iot.vendor.lorawan.v1, syntax proto3)
+/* eslint-disable */
+
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file kusinta/iot/vendor/lorawan/v1/lorawan.proto.
+ */
+export const file_kusinta_iot_vendor_lorawan_v1_lorawan = /*@__PURE__*/
+  fileDesc("CitrdXNpbnRhL2lvdC92ZW5kb3IvbG9yYXdhbi92MS9sb3Jhd2FuLnByb3RvEh1rdXNpbnRhLmlvdC52ZW5kb3IubG9yYXdhbi52MSJbChNMb3Jhd2FuUHJvdmlzaW9uaW5nEg8KB2Rldl9ldWkYASABKAkSDwoHYXBwX2tleRgCIAEoCRIVCghqb2luX2V1aRgDIAEoCUgAiAEBQgsKCV9qb2luX2V1aUICSAFiBnByb3RvMw");
+
+/**
+ * Describes the message kusinta.iot.vendor.lorawan.v1.LorawanProvisioning.
+ * Use `create(LorawanProvisioningSchema)` to create a new message.
+ */
+export const LorawanProvisioningSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_vendor_lorawan_v1_lorawan, 0);
+

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

@@ -26,14 +26,35 @@ 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
- * the Endpoint.vendor_properties case.
+ * the Endpoint.vendor_properties case — or Endpoint.radio_link, for "kusinta.radio".
  *
- * One key per message carried in Endpoint.vendor_properties, so the vendor branch of the
- * resolution rule is the same shape as the Matter branch: pick a message by a message
- * option, then one field by a field option. Nothing nests.
+ * One key per message carried in Endpoint.vendor_properties or radio_link, so the vendor
+ * branch of the resolution rule is the same shape as the Matter branch: pick a message
+ * by a message option, then one field by a field option. Nothing nests.
  *
  * Form: "<vendor>.<what the message models>", lower_snake_case on both sides —
  * "homematic.thermostat", and a humidity one would be "homematic.humidity_sensor". The

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,14 +28,36 @@ 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
- * the Endpoint.vendor_properties case.
+ * the Endpoint.vendor_properties case — or Endpoint.radio_link, for "kusinta.radio".
  *
- * One key per message carried in Endpoint.vendor_properties, so the vendor branch of the
- * resolution rule is the same shape as the Matter branch: pick a message by a message
- * option, then one field by a field option. Nothing nests.
+ * One key per message carried in Endpoint.vendor_properties or radio_link, so the vendor
+ * branch of the resolution rule is the same shape as the Matter branch: pick a message
+ * by a message option, then one field by a field option. Nothing nests.
  *
  * Form: "<vendor>.<what the message models>", lower_snake_case on both sides —
  * "homematic.thermostat", and a humidity one would be "homematic.humidity_sensor". The
@@ -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);