@kusinta/iot-schema 0.2.0-beta.34 → 0.2.0-beta.36

package/src/kusinta/iot/device/v1/cluster_state_pb.d.ts

@@ -2,7 +2,7 @@
 // @generated from file kusinta/iot/device/v1/cluster_state.proto (package kusinta.iot.device.v1, syntax proto3)
 /* eslint-disable */
 
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 
 /**
@@ -272,6 +272,21 @@ export declare type ClusterState = Message<"kusinta.iot.device.v1.ClusterState">
    * @generated from field: map<uint32, uint32> attribute_steps = 7;
    */
   attributeSteps: { [key: number]: number };
+
+  /**
+   * What a write to each attribute leaves behind, and how late its reports arrive, keyed by
+   * attribute id. See AttributeBehaviour. Its step stays in attribute_steps.
+   *
+   * Per endpoint because a ClusterState belongs to one endpoint: a device with several
+   * independently switched outputs states each output's behaviour on that output's
+   * endpoint. A vendor parameter, which has no cluster, states its behaviour in
+   * Endpoint.vendor_attribute_behaviours.
+   *
+   * Stated by the producer at announcement. An absent key is "not stated".
+   *
+   * @generated from field: map<uint32, kusinta.iot.device.v1.AttributeBehaviour> attribute_behaviours = 8;
+   */
+  attributeBehaviours: { [key: number]: AttributeBehaviour };
 };
 
 /**
@@ -280,3 +295,181 @@ export declare type ClusterState = Message<"kusinta.iot.device.v1.ClusterState">
  */
 export declare const ClusterStateSchema: GenMessage<ClusterState>;
 
+/**
+ * What a write to one attribute leaves behind, and how late its reports arrive. Stated per
+ * attribute, per endpoint, by the producer that knows the device.
+ *
+ * A consumer that leaves a written value in place while it is gone — a gateway steering
+ * heat — needs to know what the device does on its own. Not stated is read as the worst
+ * case: a write whose kind is not stated is held as if sticky, and a reading whose latency
+ * is not stated is never treated as real-time.
+ *
+ * A gateway MUST NOT drive a heat source, a heating circuit or a floor zone through an
+ * attribute whose write kind is not stated here: it refuses the write. This is the
+ * opposite default to attribute_ids or a connector's known_links, where not stated only
+ * means not known; for an output that heats a home, not stated means no. Rollout order: a
+ * producer that carries such outputs states their behaviour before a gateway that drives
+ * them takes the release that enforces this.
+ *
+ * @generated from message kusinta.iot.device.v1.AttributeBehaviour
+ */
+export declare type AttributeBehaviour = Message<"kusinta.iot.device.v1.AttributeBehaviour"> & {
+  /**
+   * What a write leaves behind when its writer goes quiet. Unset: not stated.
+   *
+   * @generated from oneof kusinta.iot.device.v1.AttributeBehaviour.write
+   */
+  write: {
+    /**
+     * @generated from field: kusinta.iot.device.v1.StickyWrite sticky = 1;
+     */
+    value: StickyWrite;
+    case: "sticky";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.LeasedWrite leased = 2;
+     */
+    value: LeasedWrite;
+    case: "leased";
+  } | { case: undefined; value?: undefined };
+
+  /**
+   * The value the attribute takes when the device's power returns. Stated only for an
+   * attribute whose cluster has no startup attribute of its own: where the cluster has one
+   * (OnOff's StartUpOnOff, Level Control's StartUpCurrentLevel), that attribute says it and
+   * this stays unset, so the value lives in one place. Unset: not stated.
+   *
+   * @generated from field: kusinta.iot.device.v1.AttributeValue power_on_value = 3;
+   */
+  powerOnValue?: AttributeValue | undefined;
+
+  /**
+   * How late a reported value reaches the producer. Unset: not stated, never REAL_TIME.
+   *
+   * @generated from field: kusinta.iot.device.v1.ReadLatency read_latency = 4;
+   */
+  readLatency: ReadLatency;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeBehaviour.
+ * Use `create(AttributeBehaviourSchema)` to create a new message.
+ */
+export declare const AttributeBehaviourSchema: GenMessage<AttributeBehaviour>;
+
+/**
+ * The device holds a written value until something writes it again: through the writer's
+ * absence and a lost network. A writer that may go quiet writes a value it can live with
+ * being left in place.
+ *
+ * @generated from message kusinta.iot.device.v1.StickyWrite
+ */
+export declare type StickyWrite = Message<"kusinta.iot.device.v1.StickyWrite"> & {
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.StickyWrite.
+ * Use `create(StickyWriteSchema)` to create a new message.
+ */
+export declare const StickyWriteSchema: GenMessage<StickyWrite>;
+
+/**
+ * The device itself returns the attribute to lapse_value when a write's lease runs out,
+ * whether or not anything is still talking to it. The lease is kept by the device — a
+ * timer, or a watchdog on the device's own link — never by the writer re-sending: a value
+ * that lapses only because its writer keeps renewing it is sticky to anyone who has to
+ * plan for the writer failing.
+ *
+ * @generated from message kusinta.iot.device.v1.LeasedWrite
+ */
+export declare type LeasedWrite = Message<"kusinta.iot.device.v1.LeasedWrite"> & {
+  /**
+   * The shortest and longest lease, in seconds, the device accepts. Absent: no bound on
+   * that side, never zero. A lease outside them is refused rather than clamped. Where the
+   * device fixes the length itself — a boost time set as a device parameter — the producer
+   * states that length as both bounds, so it never accepts a lease it cannot keep.
+   *
+   * @generated from field: optional uint32 min_lease_seconds = 1;
+   */
+  minLeaseSeconds?: number | undefined;
+
+  /**
+   * @generated from field: optional uint32 max_lease_seconds = 2;
+   */
+  maxLeaseSeconds?: number | undefined;
+
+  /**
+   * Whether a write that arrives before the lease runs out starts the lease again from
+   * that write. False or unset (not stated): a writer MUST NOT assume that writing the
+   * same value again extends how long it holds.
+   *
+   * @generated from field: optional bool renewal_restarts_lease = 3;
+   */
+  renewalRestartsLease?: boolean | undefined;
+
+  /**
+   * The value the attribute returns to when the lease runs out. It is the state a site
+   * falls back to whenever its writer is gone, so it is what an installer checks first and
+   * what a consumer shows as "what happens if this stops". A producer always states it; a
+   * consumer reads a lease without it as a write kind not stated.
+   *
+   * A fixed value. A device whose timer returns the output to whatever it held before the
+   * write is leased only if its producer guarantees that earlier value is the lapse value
+   * — by accepting timed writes only while the output is at its lapse value, or by
+   * writing the lapse value untimed before each one — and is otherwise stated sticky.
+   *
+   * A write of the lapse value itself needs no lease: it ends any lease running, and a
+   * lease carried on it is ignored rather than refused. That is how a writer ends a lease
+   * early.
+   *
+   * A report of the lapse value after a lease has run out is the lease ending, not a
+   * change from outside: a consumer that adopts values it did not write — a turned dial —
+   * MUST NOT adopt that one as a person's.
+   *
+   * @generated from field: kusinta.iot.device.v1.AttributeValue lapse_value = 4;
+   */
+  lapseValue?: AttributeValue | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.LeasedWrite.
+ * Use `create(LeasedWriteSchema)` to create a new message.
+ */
+export declare const LeasedWriteSchema: GenMessage<LeasedWrite>;
+
+/**
+ * How late a reported value reaches the producer after it changes at the device.
+ *
+ * @generated from enum kusinta.iot.device.v1.ReadLatency
+ */
+export enum ReadLatency {
+  /**
+   * Not stated. Never treated as REAL_TIME.
+   *
+   * @generated from enum value: READ_LATENCY_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Within a few minutes of the change, every time. A value relayed through a vendor's
+   * service is not stated REAL_TIME unless that has been measured.
+   *
+   * @generated from enum value: READ_LATENCY_REAL_TIME = 1;
+   */
+  REAL_TIME = 1,
+
+  /**
+   * Late enough that acting on it as current would be wrong: values collected by a
+   * vendor's service and handed on in batches, hourly values made available the next day.
+   * Fit for records, models and reports; not for a decision that has to be made now.
+   *
+   * @generated from enum value: READ_LATENCY_DELAYED = 2;
+   */
+  DELAYED = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.device.v1.ReadLatency.
+ */
+export declare const ReadLatencySchema: GenEnum<ReadLatency>;
+

package/src/kusinta/iot/device/v1/cluster_state_pb.js

@@ -2,13 +2,13 @@
 // @generated from file kusinta/iot/device/v1/cluster_state.proto (package kusinta.iot.device.v1, syntax proto3)
 /* eslint-disable */
 
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
 
 /**
  * Describes the file kusinta/iot/device/v1/cluster_state.proto.
  */
 export const file_kusinta_iot_device_v1_cluster_state = /*@__PURE__*/
-  fileDesc("CilrdXNpbnRhL2lvdC9kZXZpY2UvdjEvY2x1c3Rlcl9zdGF0ZS5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIgsKCU51bGxWYWx1ZSLfAgoOQXR0cmlidXRlVmFsdWUSFAoKYm9vbF92YWx1ZRgBIAEoCEgAEhMKCWludF92YWx1ZRgCIAEoEkgAEhQKCnVpbnRfdmFsdWUYAyABKARIABIWCgxkb3VibGVfdmFsdWUYBCABKAFIABIWCgxzdHJpbmdfdmFsdWUYBSABKAlIABIVCgtieXRlc192YWx1ZRgGIAEoDEgAEj8KCmxpc3RfdmFsdWUYByABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVMaXN0SAASQwoMc3RydWN0X3ZhbHVlGAggASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlU3RydWN0SAASNgoKbnVsbF92YWx1ZRgJIAEoCzIgLmt1c2ludGEuaW90LmRldmljZS52MS5OdWxsVmFsdWVIAEIHCgV2YWx1ZSJLChJBdHRyaWJ1dGVWYWx1ZUxpc3QSNQoGdmFsdWVzGAEgAygLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlIrUBChRBdHRyaWJ1dGVWYWx1ZVN0cnVjdBJHCgZmaWVsZHMYASADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVTdHJ1Y3QuRmllbGRzRW50cnkaVAoLRmllbGRzRW50cnkSCwoDa2V5GAEgASgNEjQKBXZhbHVlGAIgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlOgI4ASJcCg5BdHRyaWJ1dGVTdGF0ZRIUCgxhdHRyaWJ1dGVfaWQYASABKA0SNAoFdmFsdWUYAiABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWUi+QIKDENsdXN0ZXJTdGF0ZRISCgpjbHVzdGVyX2lkGAEgASgNEh0KEGNsdXN0ZXJfcmV2aXNpb24YAiABKA1IAIgBARIYCgtmZWF0dXJlX21hcBgDIAEoDUgBiAEBEjkKCmF0dHJpYnV0ZXMYBCADKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlU3RhdGUSHAoUYWNjZXB0ZWRfY29tbWFuZF9pZHMYBSADKA0SFQoNYXR0cmlidXRlX2lkcxgGIAMoDRJQCg9hdHRyaWJ1dGVfc3RlcHMYByADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQ2x1c3RlclN0YXRlLkF0dHJpYnV0ZVN0ZXBzRW50cnkaNQoTQXR0cmlidXRlU3RlcHNFbnRyeRILCgNrZXkYASABKA0SDQoFdmFsdWUYAiABKA06AjgBQhMKEV9jbHVzdGVyX3JldmlzaW9uQg4KDF9mZWF0dXJlX21hcEICSAFiBnByb3RvMw");
+  fileDesc("CilrdXNpbnRhL2lvdC9kZXZpY2UvdjEvY2x1c3Rlcl9zdGF0ZS5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIgsKCU51bGxWYWx1ZSLfAgoOQXR0cmlidXRlVmFsdWUSFAoKYm9vbF92YWx1ZRgBIAEoCEgAEhMKCWludF92YWx1ZRgCIAEoEkgAEhQKCnVpbnRfdmFsdWUYAyABKARIABIWCgxkb3VibGVfdmFsdWUYBCABKAFIABIWCgxzdHJpbmdfdmFsdWUYBSABKAlIABIVCgtieXRlc192YWx1ZRgGIAEoDEgAEj8KCmxpc3RfdmFsdWUYByABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVMaXN0SAASQwoMc3RydWN0X3ZhbHVlGAggASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlU3RydWN0SAASNgoKbnVsbF92YWx1ZRgJIAEoCzIgLmt1c2ludGEuaW90LmRldmljZS52MS5OdWxsVmFsdWVIAEIHCgV2YWx1ZSJLChJBdHRyaWJ1dGVWYWx1ZUxpc3QSNQoGdmFsdWVzGAEgAygLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlIrUBChRBdHRyaWJ1dGVWYWx1ZVN0cnVjdBJHCgZmaWVsZHMYASADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVTdHJ1Y3QuRmllbGRzRW50cnkaVAoLRmllbGRzRW50cnkSCwoDa2V5GAEgASgNEjQKBXZhbHVlGAIgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlOgI4ASJcCg5BdHRyaWJ1dGVTdGF0ZRIUCgxhdHRyaWJ1dGVfaWQYASABKA0SNAoFdmFsdWUYAiABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWUivAQKDENsdXN0ZXJTdGF0ZRISCgpjbHVzdGVyX2lkGAEgASgNEh0KEGNsdXN0ZXJfcmV2aXNpb24YAiABKA1IAIgBARIYCgtmZWF0dXJlX21hcBgDIAEoDUgBiAEBEjkKCmF0dHJpYnV0ZXMYBCADKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlU3RhdGUSHAoUYWNjZXB0ZWRfY29tbWFuZF9pZHMYBSADKA0SFQoNYXR0cmlidXRlX2lkcxgGIAMoDRJQCg9hdHRyaWJ1dGVfc3RlcHMYByADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQ2x1c3RlclN0YXRlLkF0dHJpYnV0ZVN0ZXBzRW50cnkSWgoUYXR0cmlidXRlX2JlaGF2aW91cnMYCCADKAsyPC5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQ2x1c3RlclN0YXRlLkF0dHJpYnV0ZUJlaGF2aW91cnNFbnRyeRo1ChNBdHRyaWJ1dGVTdGVwc0VudHJ5EgsKA2tleRgBIAEoDRINCgV2YWx1ZRgCIAEoDToCOAEaZQoYQXR0cmlidXRlQmVoYXZpb3Vyc0VudHJ5EgsKA2tleRgBIAEoDRI4CgV2YWx1ZRgCIAEoCzIpLmt1c2ludGEuaW90LmRldmljZS52MS5BdHRyaWJ1dGVCZWhhdmlvdXI6AjgBQhMKEV9jbHVzdGVyX3JldmlzaW9uQg4KDF9mZWF0dXJlX21hcCKCAgoSQXR0cmlidXRlQmVoYXZpb3VyEjQKBnN0aWNreRgBIAEoCzIiLmt1c2ludGEuaW90LmRldmljZS52MS5TdGlja3lXcml0ZUgAEjQKBmxlYXNlZBgCIAEoCzIiLmt1c2ludGEuaW90LmRldmljZS52MS5MZWFzZWRXcml0ZUgAEj0KDnBvd2VyX29uX3ZhbHVlGAMgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlEjgKDHJlYWRfbGF0ZW5jeRgEIAEoDjIiLmt1c2ludGEuaW90LmRldmljZS52MS5SZWFkTGF0ZW5jeUIHCgV3cml0ZSINCgtTdGlja3lXcml0ZSL1AQoLTGVhc2VkV3JpdGUSHgoRbWluX2xlYXNlX3NlY29uZHMYASABKA1IAIgBARIeChFtYXhfbGVhc2Vfc2Vjb25kcxgCIAEoDUgBiAEBEiMKFnJlbmV3YWxfcmVzdGFydHNfbGVhc2UYAyABKAhIAogBARI6CgtsYXBzZV92YWx1ZRgEIAEoCzIlLmt1c2ludGEuaW90LmRldmljZS52MS5BdHRyaWJ1dGVWYWx1ZUIUChJfbWluX2xlYXNlX3NlY29uZHNCFAoSX21heF9sZWFzZV9zZWNvbmRzQhkKF19yZW5ld2FsX3Jlc3RhcnRzX2xlYXNlKmEKC1JlYWRMYXRlbmN5EhwKGFJFQURfTEFURU5DWV9VTlNQRUNJRklFRBAAEhoKFlJFQURfTEFURU5DWV9SRUFMX1RJTUUQARIYChRSRUFEX0xBVEVOQ1lfREVMQVlFRBACQgJIAWIGcHJvdG8z");
 
 /**
  * Describes the message kusinta.iot.device.v1.NullValue.
@@ -52,3 +52,38 @@ export const AttributeStateSchema = /*@__PURE__*/
 export const ClusterStateSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_device_v1_cluster_state, 5);
 
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeBehaviour.
+ * Use `create(AttributeBehaviourSchema)` to create a new message.
+ */
+export const AttributeBehaviourSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 6);
+
+/**
+ * Describes the message kusinta.iot.device.v1.StickyWrite.
+ * Use `create(StickyWriteSchema)` to create a new message.
+ */
+export const StickyWriteSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 7);
+
+/**
+ * Describes the message kusinta.iot.device.v1.LeasedWrite.
+ * Use `create(LeasedWriteSchema)` to create a new message.
+ */
+export const LeasedWriteSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 8);
+
+/**
+ * Describes the enum kusinta.iot.device.v1.ReadLatency.
+ */
+export const ReadLatencySchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_device_v1_cluster_state, 0);
+
+/**
+ * How late a reported value reaches the producer after it changes at the device.
+ *
+ * @generated from enum kusinta.iot.device.v1.ReadLatency
+ */
+export const ReadLatency = /*@__PURE__*/
+  tsEnum(ReadLatencySchema);
+

package/src/kusinta/iot/device/v1/device_pb.d.ts

@@ -6,7 +6,7 @@ import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2"
 import type { Message } from "@bufbuild/protobuf";
 import type { ColorTemperatureLightProperties, ContactSensorProperties, DimmableLightProperties, DoorLockProperties, EnergySensorProperties, HumiditySensorProperties, OccupancySensorProperties, OnOffLightProperties, PowerSourceProperties, PressureSensorProperties, TemperatureSensorProperties, ThermostatProperties, WindowCoveringProperties } from "./properties_pb.js";
 import type { HmMaintenanceProps, HmThermostatProps } from "../../vendor/homematic/v1/homematic_pb.js";
-import type { ClusterState } from "./cluster_state_pb.js";
+import type { AttributeBehaviour, ClusterState } from "./cluster_state_pb.js";
 import type { DeviceDescriptor } from "./descriptor_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 
@@ -230,6 +230,18 @@ export declare type Endpoint = Message<"kusinta.iot.device.v1.Endpoint"> & {
    * @generated from field: repeated string vendor_attribute_names = 17;
    */
   vendorAttributeNames: string[];
+
+  /**
+   * What a write to each vendor parameter leaves behind, and how late its reports arrive,
+   * keyed by the parameter's vendor name as vendor_attribute_names spells it. The vendor
+   * mirror of ClusterState.attribute_behaviours, with the same rules: an absent key is
+   * "not stated", and not stated is read as the worst case. For a parameter reached through
+   * a vendor's service, the name is the vendor's stable parameter id where it has one,
+   * never a display name that is translated or renamed between firmware versions.
+   *
+   * @generated from field: map<string, kusinta.iot.device.v1.AttributeBehaviour> vendor_attribute_behaviours = 18;
+   */
+  vendorAttributeBehaviours: { [key: string]: AttributeBehaviour };
 };
 
 /**
@@ -261,12 +273,37 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
   descriptor?: DeviceDescriptor | undefined;
 
   /**
-   * 15-19 are free; 20+ is the timestamp band.
+   * 17-19 are free; 20+ is the timestamp band.
    *
    * @generated from field: repeated kusinta.iot.device.v1.Endpoint endpoints = 14;
    */
   endpoints: Endpoint[];
 
+  /**
+   * The fewest seconds this device needs between two writes, to any of its attributes on
+   * any endpoint, without dropping one: a radio limited to a share of airtime, a battery
+   * device that wakes on a schedule. A device-wide budget rather than a per-attribute one,
+   * because two attributes each written at their own pace still share one radio. Stated by
+   * the producer at announcement. Absent: not stated, never zero.
+   *
+   * A lower bound, not the whole budget: devices behind one radio gateway or one hub share
+   * its airtime, and a vendor's service limits an account rather than a device, so a writer
+   * may have to space writes further apart than this says.
+   *
+   * @generated from field: optional uint32 min_write_interval_seconds = 15;
+   */
+  minWriteIntervalSeconds?: number | undefined;
+
+  /**
+   * The longest a write can take to reach the device: a device that listens only after
+   * its own report takes a write at its next one. Stated by the producer at announcement.
+   * Absent: not stated, never zero. A writer that renews a lease renews it this long, plus
+   * a margin, before the lease runs out, or the output lapses between renewals.
+   *
+   * @generated from field: optional uint32 max_write_delay_seconds = 16;
+   */
+  maxWriteDelaySeconds?: number | undefined;
+
   /**
    * When the gateway last had evidence this device itself — the
    * most recent PropertyUpdate (wheter or not the property changed) or command

package/src/kusinta/iot/device/v1/device_pb.js

@@ -14,7 +14,7 @@ import { file_kusinta_iot_vendor_v1_vendor_options } from "../../vendor/v1/vendo
  * Describes the file kusinta/iot/device/v1/device.proto.
  */
 export const file_kusinta_iot_device_v1_device = /*@__PURE__*/
-  fileDesc("CiJrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGV2aWNlLnByb3RvEhVrdXNpbnRhLmlvdC5kZXZpY2UudjEi0woKCEVuZHBvaW50EhMKC2VuZHBvaW50X2lkGAEgASgNEh0KFW1hdHRlcl9kZXZpY2VfdHlwZV9pZBgCIAEoDRJBCgp0aGVybW9zdGF0GAMgASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLlRoZXJtb3N0YXRQcm9wZXJ0aWVzSAASUAoSdGVtcGVyYXR1cmVfc2Vuc29yGAQgASgLMjIua3VzaW50YS5pb3QuZGV2aWNlLnYxLlRlbXBlcmF0dXJlU2Vuc29yUHJvcGVydGllc0gAEkoKD2h1bWlkaXR5X3NlbnNvchgFIAEoCzIvLmt1c2ludGEuaW90LmRldmljZS52MS5IdW1pZGl0eVNlbnNvclByb3BlcnRpZXNIABJMChBvY2N1cGFuY3lfc2Vuc29yGAYgASgLMjAua3VzaW50YS5pb3QuZGV2aWNlLnYxLk9jY3VwYW5jeVNlbnNvclByb3BlcnRpZXNIABJICg5jb250YWN0X3NlbnNvchgHIAEoCzIuLmt1c2ludGEuaW90LmRldmljZS52MS5Db250YWN0U2Vuc29yUHJvcGVydGllc0gAEkoKD3dpbmRvd19jb3ZlcmluZxgIIAEoCzIvLmt1c2ludGEuaW90LmRldmljZS52MS5XaW5kb3dDb3ZlcmluZ1Byb3BlcnRpZXNIABI+Cglkb29yX2xvY2sYCSABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRG9vckxvY2tQcm9wZXJ0aWVzSAASQwoMb25fb2ZmX2xpZ2h0GAogASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLk9uT2ZmTGlnaHRQcm9wZXJ0aWVzSAASSAoOZGltbWFibGVfbGlnaHQYCyABKAsyLi5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGltbWFibGVMaWdodFByb3BlcnRpZXNIABJSChBjb2xvcl90ZW1wX2xpZ2h0GAwgASgLMjYua3VzaW50YS5pb3QuZGV2aWNlLnYxLkNvbG9yVGVtcGVyYXR1cmVMaWdodFByb3BlcnRpZXNIABJGCg1lbmVyZ3lfc2Vuc29yGA0gASgLMi0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkVuZXJneVNlbnNvclByb3BlcnRpZXNIABJKCg9wcmVzc3VyZV9zZW5zb3IYDiABKAsyLy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuUHJlc3N1cmVTZW5zb3JQcm9wZXJ0aWVzSAASRAoMcG93ZXJfc291cmNlGA8gASgLMiwua3VzaW50YS5pb3QuZGV2aWNlLnYxLlBvd2VyU291cmNlUHJvcGVydGllc0gAEksKDWhtX3RoZXJtb3N0YXQYMiABKAsyMi5rdXNpbnRhLmlvdC52ZW5kb3IuaG9tZW1hdGljLnYxLkhtVGhlcm1vc3RhdFByb3BzSAESTQoOaG1fbWFpbnRlbmFuY2UYMyABKAsyMy5rdXNpbnRhLmlvdC52ZW5kb3IuaG9tZW1hdGljLnYxLkhtTWFpbnRlbmFuY2VQcm9wc0gBEjQKCnJhZGlvX2xpbmsYNCABKAsyIC5rdXNpbnRhLmlvdC5kZXZpY2UudjEuUmFkaW9MaW5rEjUKCGNsdXN0ZXJzGBAgAygLMiMua3VzaW50YS5pb3QuZGV2aWNlLnYxLkNsdXN0ZXJTdGF0ZRIeChZ2ZW5kb3JfYXR0cmlidXRlX25hbWVzGBEgAygJQhMKEW1hdHRlcl9wcm9wZXJ0aWVzQhMKEXZlbmRvcl9wcm9wZXJ0aWVzIrADCgZEZXZpY2USOwoKZGVzY3JpcHRvchgBIAEoCzInLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2VEZXNjcmlwdG9yEjIKCWVuZHBvaW50cxgOIAMoCzIfLmt1c2ludGEuaW90LmRldmljZS52MS5FbmRwb2ludBItCglsYXN0X3NlZW4YFCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjAKDGxhc3RfdXBkYXRlZBgVIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBKBAgCEA5KBAgyEDNSCnRoZXJtb3N0YXRSEnRlbXBlcmF0dXJlX3NlbnNvclIPaHVtaWRpdHlfc2Vuc29yUhBvY2N1cGFuY3lfc2Vuc29yUg5jb250YWN0X3NlbnNvclIPd2luZG93X2NvdmVyaW5nUglkb29yX2xvY2tSDG9uX29mZl9saWdodFIOZGltbWFibGVfbGlnaHRSEGNvbG9yX3RlbXBfbGlnaHRSDWVuZXJneV9zZW5zb3JSD3ByZXNzdXJlX3NlbnNvclIJaG9tZW1hdGljIrcBCglSYWRpb0xpbmsSJQoHcXVhbGl0eRgBIAEoDUIPorUYB3F1YWxpdHnQtRgFSACIAQESJwoIcnNzaV9kYm0YAiABKBFCEKK1GAhyc3NpX2RibdC1GAVIAYgBARIjCgZzbnJfZGIYAyABKAJCDqK1GAZzbnJfZGLQtRgFSAKIAQE6Eaq1GA1rdXNpbnRhLnJhZGlvQgoKCF9xdWFsaXR5QgsKCV9yc3NpX2RibUIJCgdfc25yX2RiKnUKDFJhZGlvUXVhbGl0eRIdChlSQURJT19RVUFMSVRZX1VOU1BFQ0lGSUVEEAASFgoSUkFESU9fUVVBTElUWV9HT09EEAESFgoSUkFESU9fUVVBTElUWV9GQUlSEAISFgoSUkFESU9fUVVBTElUWV9QT09SEANCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_device_v1_descriptor, file_kusinta_iot_device_v1_properties, file_kusinta_iot_vendor_homematic_v1_homematic, file_kusinta_iot_vendor_v1_vendor_options]);
+  fileDesc("CiJrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGV2aWNlLnByb3RvEhVrdXNpbnRhLmlvdC5kZXZpY2UudjEipQwKCEVuZHBvaW50EhMKC2VuZHBvaW50X2lkGAEgASgNEh0KFW1hdHRlcl9kZXZpY2VfdHlwZV9pZBgCIAEoDRJBCgp0aGVybW9zdGF0GAMgASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLlRoZXJtb3N0YXRQcm9wZXJ0aWVzSAASUAoSdGVtcGVyYXR1cmVfc2Vuc29yGAQgASgLMjIua3VzaW50YS5pb3QuZGV2aWNlLnYxLlRlbXBlcmF0dXJlU2Vuc29yUHJvcGVydGllc0gAEkoKD2h1bWlkaXR5X3NlbnNvchgFIAEoCzIvLmt1c2ludGEuaW90LmRldmljZS52MS5IdW1pZGl0eVNlbnNvclByb3BlcnRpZXNIABJMChBvY2N1cGFuY3lfc2Vuc29yGAYgASgLMjAua3VzaW50YS5pb3QuZGV2aWNlLnYxLk9jY3VwYW5jeVNlbnNvclByb3BlcnRpZXNIABJICg5jb250YWN0X3NlbnNvchgHIAEoCzIuLmt1c2ludGEuaW90LmRldmljZS52MS5Db250YWN0U2Vuc29yUHJvcGVydGllc0gAEkoKD3dpbmRvd19jb3ZlcmluZxgIIAEoCzIvLmt1c2ludGEuaW90LmRldmljZS52MS5XaW5kb3dDb3ZlcmluZ1Byb3BlcnRpZXNIABI+Cglkb29yX2xvY2sYCSABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRG9vckxvY2tQcm9wZXJ0aWVzSAASQwoMb25fb2ZmX2xpZ2h0GAogASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLk9uT2ZmTGlnaHRQcm9wZXJ0aWVzSAASSAoOZGltbWFibGVfbGlnaHQYCyABKAsyLi5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGltbWFibGVMaWdodFByb3BlcnRpZXNIABJSChBjb2xvcl90ZW1wX2xpZ2h0GAwgASgLMjYua3VzaW50YS5pb3QuZGV2aWNlLnYxLkNvbG9yVGVtcGVyYXR1cmVMaWdodFByb3BlcnRpZXNIABJGCg1lbmVyZ3lfc2Vuc29yGA0gASgLMi0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkVuZXJneVNlbnNvclByb3BlcnRpZXNIABJKCg9wcmVzc3VyZV9zZW5zb3IYDiABKAsyLy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuUHJlc3N1cmVTZW5zb3JQcm9wZXJ0aWVzSAASRAoMcG93ZXJfc291cmNlGA8gASgLMiwua3VzaW50YS5pb3QuZGV2aWNlLnYxLlBvd2VyU291cmNlUHJvcGVydGllc0gAEksKDWhtX3RoZXJtb3N0YXQYMiABKAsyMi5rdXNpbnRhLmlvdC52ZW5kb3IuaG9tZW1hdGljLnYxLkhtVGhlcm1vc3RhdFByb3BzSAESTQoOaG1fbWFpbnRlbmFuY2UYMyABKAsyMy5rdXNpbnRhLmlvdC52ZW5kb3IuaG9tZW1hdGljLnYxLkhtTWFpbnRlbmFuY2VQcm9wc0gBEjQKCnJhZGlvX2xpbmsYNCABKAsyIC5rdXNpbnRhLmlvdC5kZXZpY2UudjEuUmFkaW9MaW5rEjUKCGNsdXN0ZXJzGBAgAygLMiMua3VzaW50YS5pb3QuZGV2aWNlLnYxLkNsdXN0ZXJTdGF0ZRIeChZ2ZW5kb3JfYXR0cmlidXRlX25hbWVzGBEgAygJEmMKG3ZlbmRvcl9hdHRyaWJ1dGVfYmVoYXZpb3VycxgSIAMoCzI+Lmt1c2ludGEuaW90LmRldmljZS52MS5FbmRwb2ludC5WZW5kb3JBdHRyaWJ1dGVCZWhhdmlvdXJzRW50cnkaawoeVmVuZG9yQXR0cmlidXRlQmVoYXZpb3Vyc0VudHJ5EgsKA2tleRgBIAEoCRI4CgV2YWx1ZRgCIAEoCzIpLmt1c2ludGEuaW90LmRldmljZS52MS5BdHRyaWJ1dGVCZWhhdmlvdXI6AjgBQhMKEW1hdHRlcl9wcm9wZXJ0aWVzQhMKEXZlbmRvcl9wcm9wZXJ0aWVzIroECgZEZXZpY2USOwoKZGVzY3JpcHRvchgBIAEoCzInLmt1c2ludGEuaW90LmRldmljZS52MS5EZXZpY2VEZXNjcmlwdG9yEjIKCWVuZHBvaW50cxgOIAMoCzIfLmt1c2ludGEuaW90LmRldmljZS52MS5FbmRwb2ludBInChptaW5fd3JpdGVfaW50ZXJ2YWxfc2Vjb25kcxgPIAEoDUgAiAEBEiQKF21heF93cml0ZV9kZWxheV9zZWNvbmRzGBAgASgNSAGIAQESLQoJbGFzdF9zZWVuGBQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIwCgxsYXN0X3VwZGF0ZWQYFSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wQh0KG19taW5fd3JpdGVfaW50ZXJ2YWxfc2Vjb25kc0IaChhfbWF4X3dyaXRlX2RlbGF5X3NlY29uZHNKBAgCEA5KBAgyEDNSCnRoZXJtb3N0YXRSEnRlbXBlcmF0dXJlX3NlbnNvclIPaHVtaWRpdHlfc2Vuc29yUhBvY2N1cGFuY3lfc2Vuc29yUg5jb250YWN0X3NlbnNvclIPd2luZG93X2NvdmVyaW5nUglkb29yX2xvY2tSDG9uX29mZl9saWdodFIOZGltbWFibGVfbGlnaHRSEGNvbG9yX3RlbXBfbGlnaHRSDWVuZXJneV9zZW5zb3JSD3ByZXNzdXJlX3NlbnNvclIJaG9tZW1hdGljIrcBCglSYWRpb0xpbmsSJQoHcXVhbGl0eRgBIAEoDUIPorUYB3F1YWxpdHnQtRgFSACIAQESJwoIcnNzaV9kYm0YAiABKBFCEKK1GAhyc3NpX2RibdC1GAVIAYgBARIjCgZzbnJfZGIYAyABKAJCDqK1GAZzbnJfZGLQtRgFSAKIAQE6Eaq1GA1rdXNpbnRhLnJhZGlvQgoKCF9xdWFsaXR5QgsKCV9yc3NpX2RibUIJCgdfc25yX2RiKnUKDFJhZGlvUXVhbGl0eRIdChlSQURJT19RVUFMSVRZX1VOU1BFQ0lGSUVEEAASFgoSUkFESU9fUVVBTElUWV9HT09EEAESFgoSUkFESU9fUVVBTElUWV9GQUlSEAISFgoSUkFESU9fUVVBTElUWV9QT09SEANCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_device_v1_descriptor, file_kusinta_iot_device_v1_properties, file_kusinta_iot_vendor_homematic_v1_homematic, file_kusinta_iot_vendor_v1_vendor_options]);
 
 /**
  * Describes the message kusinta.iot.device.v1.Endpoint.

package/src/kusinta/iot/registration/v1/registration_pb.d.ts

@@ -15,6 +15,11 @@ export declare const file_kusinta_iot_registration_v1_registration: GenFile;
  */
 export declare type RegistrationRequest = Message<"kusinta.iot.registration.v1.RegistrationRequest"> & {
   /**
+   * The one-time token an administrator of the owning organisation obtained from the
+   * api-server and handed to the gateway. Opaque to the gateway: it is signed with a key only
+   * the api-server holds, and the gateway passes it on unread. Nothing the gateway acts on is
+   * taken from it; what the registration settles comes back in RegistrationComplete.
+   *
    * @generated from field: string registration_token = 1;
    */
   registrationToken: string;
@@ -65,6 +70,19 @@ export declare type RegistrationComplete = Message<"kusinta.iot.registration.v1.
    * @generated from field: string ca_bundle_pem = 2;
    */
   caBundlePem: string;
+
+  /**
+   * The ownership epoch of the gateway's owner record (signaling.v1.GatewayStreamOpened,
+   * OWNERSHIP EPOCH), from the api-server's answer to the registration the gateway made over
+   * its own connection to it, which is what makes it trusted. Never empty. An epoch other than
+   * the one the gateway holds makes it wipe (signaling.v1.GatewayDeleted, WIPE) before it
+   * installs the certificate or admits any session. A registration again by the owning
+   * organisation, after a revoke included, answers the epoch the gateway holds and wipes
+   * nothing.
+   *
+   * @generated from field: string ownership_epoch = 3;
+   */
+  ownershipEpoch: string;
 };
 
 /**

package/src/kusinta/iot/registration/v1/registration_pb.js

@@ -8,7 +8,7 @@ import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
  * Describes the file kusinta/iot/registration/v1/registration.proto.
  */
 export const file_kusinta_iot_registration_v1_registration = /*@__PURE__*/
-  fileDesc("Ci5rdXNpbnRhL2lvdC9yZWdpc3RyYXRpb24vdjEvcmVnaXN0cmF0aW9uLnByb3RvEhtrdXNpbnRhLmlvdC5yZWdpc3RyYXRpb24udjEiVwoTUmVnaXN0cmF0aW9uUmVxdWVzdBIaChJyZWdpc3RyYXRpb25fdG9rZW4YASABKAkSEwoLZXh0ZXJuYWxfaXAYAiABKAkSDwoHY3NyX3BlbRgDIAEoCSIkChRSZWdpc3RyYXRpb25Qcm9ncmVzcxIMCgRzdGVwGAEgASgJIkYKFFJlZ2lzdHJhdGlvbkNvbXBsZXRlEhcKD2NlcnRpZmljYXRlX3BlbRgBIAEoCRIVCg1jYV9idW5kbGVfcGVtGAIgASgJIjIKEVJlZ2lzdHJhdGlvbkVycm9yEgwKBGNvZGUYASABKAkSDwoHbWVzc2FnZRgCIAEoCSLuAQoUUmVnaXN0cmF0aW9uUmVzcG9uc2USRQoIcHJvZ3Jlc3MYASABKAsyMS5rdXNpbnRhLmlvdC5yZWdpc3RyYXRpb24udjEuUmVnaXN0cmF0aW9uUHJvZ3Jlc3NIABJFCghjb21wbGV0ZRgCIAEoCzIxLmt1c2ludGEuaW90LnJlZ2lzdHJhdGlvbi52MS5SZWdpc3RyYXRpb25Db21wbGV0ZUgAEj8KBWVycm9yGAMgASgLMi4ua3VzaW50YS5pb3QucmVnaXN0cmF0aW9uLnYxLlJlZ2lzdHJhdGlvbkVycm9ySABCBwoFZXZlbnQiJQoSQ2VydFJlbmV3YWxSZXF1ZXN0Eg8KB2Nzcl9wZW0YASABKAkiRQoTQ2VydFJlbmV3YWxSZXNwb25zZRIXCg9jZXJ0aWZpY2F0ZV9wZW0YASABKAkSFQoNY2FfYnVuZGxlX3BlbRgCIAEoCUICSAFiBnByb3RvMw");
+  fileDesc("Ci5rdXNpbnRhL2lvdC9yZWdpc3RyYXRpb24vdjEvcmVnaXN0cmF0aW9uLnByb3RvEhtrdXNpbnRhLmlvdC5yZWdpc3RyYXRpb24udjEiVwoTUmVnaXN0cmF0aW9uUmVxdWVzdBIaChJyZWdpc3RyYXRpb25fdG9rZW4YASABKAkSEwoLZXh0ZXJuYWxfaXAYAiABKAkSDwoHY3NyX3BlbRgDIAEoCSIkChRSZWdpc3RyYXRpb25Qcm9ncmVzcxIMCgRzdGVwGAEgASgJIl8KFFJlZ2lzdHJhdGlvbkNvbXBsZXRlEhcKD2NlcnRpZmljYXRlX3BlbRgBIAEoCRIVCg1jYV9idW5kbGVfcGVtGAIgASgJEhcKD293bmVyc2hpcF9lcG9jaBgDIAEoCSIyChFSZWdpc3RyYXRpb25FcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAki7gEKFFJlZ2lzdHJhdGlvblJlc3BvbnNlEkUKCHByb2dyZXNzGAEgASgLMjEua3VzaW50YS5pb3QucmVnaXN0cmF0aW9uLnYxLlJlZ2lzdHJhdGlvblByb2dyZXNzSAASRQoIY29tcGxldGUYAiABKAsyMS5rdXNpbnRhLmlvdC5yZWdpc3RyYXRpb24udjEuUmVnaXN0cmF0aW9uQ29tcGxldGVIABI/CgVlcnJvchgDIAEoCzIuLmt1c2ludGEuaW90LnJlZ2lzdHJhdGlvbi52MS5SZWdpc3RyYXRpb25FcnJvckgAQgcKBWV2ZW50IiUKEkNlcnRSZW5ld2FsUmVxdWVzdBIPCgdjc3JfcGVtGAEgASgJIkUKE0NlcnRSZW5ld2FsUmVzcG9uc2USFwoPY2VydGlmaWNhdGVfcGVtGAEgASgJEhUKDWNhX2J1bmRsZV9wZW0YAiABKAlCAkgBYgZwcm90bzM");
 
 /**
  * Describes the message kusinta.iot.registration.v1.RegistrationRequest.

package/src/kusinta/iot/reporting/v1/reporting_pb.d.ts

@@ -421,8 +421,9 @@ export declare const ReportProblemsResponseSchema: GenMessage<ReportProblemsResp
  *
  * The administration of the gateway is not reported here; the administrator's own service
  * memberships, if any, are, like anyone's. The api-server records who administers a gateway
- * itself, and from when, and gives the administrator every space the gateway serves
- * from that moment, applying a change of administrator at once. A problem with no space the
+ * itself — the administrators of the organisation that owns it — and from when, and gives each
+ * administrator every space the gateway serves from that moment, applying a change of
+ * administrator, or of owning organisation, at once. A problem with no space the
  * api-server holds — a device filed nowhere, a space not yet held or since removed — is shown
  * only to the administrator. A problem about a connector or the gateway itself concerns no
  * one's home, and is shown to the administrator and every member with any reach.
@@ -717,20 +718,25 @@ export declare const ReportServedSpacesResponseSchema: GenMessage<ReportServedSp
  * person connect and leaving is what revokes them. Roles do not follow relations
  * (access.v1.MembershipRelation): a relation changing alone changes nothing reported here.
  *
- * Who registered the gateway is the api-server's own record, not the gateway's. The
- * administration that came with registering it is never taken away by this report — not by
- * its absence from a snapshot, not by removed_user_ids — and ends only with a change of who
- * is registered as the gateway's administrator at the api-server. Any other administrator is
- * a member reported with ROLE_GATEWAY_ADMIN, whom the api-server gives what it gives the
- * registering one, from administrator_since (see ServiceReach). Where the registering
- * administrator is also reported so, the api-server's record governs: their administration
- * counts from the earlier of its own start and administrator_since.
+ * Which organisation owns the gateway, and who its administrators are, is the api-server's own
+ * record, not the gateway's. The administration that comes with them is never taken away by this
+ * report — not by absence from a snapshot, not by removed_user_ids — and ends only when the
+ * person stops being an administrator of the owning organisation, or the gateway moves to
+ * another (signaling.v1.TransferOutcome). Any other administrator is a member reported with
+ * ROLE_GATEWAY_ADMIN, whom the api-server gives what it gives the organisation's, from
+ * administrator_since (see ServiceReach). Where an administrator of the organisation is also
+ * reported so, the api-server's record governs: their administration counts from the earlier of
+ * its own start and administrator_since. The api-server's own start for an organisation's
+ * administrator is never before the gateway came to that organisation, so a new owner learns
+ * nothing from before a transfer.
  *
- * A member here is a user the gateway holds a membership or a role for, and no one else. The
- * registering administrator is reported only when the gateway holds one of those for them —
- * a membership, or ROLE_PROPERTY_OWNER they were given — and never with the
- * ROLE_GATEWAY_ADMIN their token carries. That the gateway recognises them otherwise
- * (webrtc.v1.MemberDetail.registering_admin) does not make them a member of this report.
+ * A member here is a user the gateway holds a membership or a role for, and no one else. A
+ * vouched administrator (signaling.v1.VouchedAdministrators) is reported only when the gateway
+ * holds one of those for them — a membership, or ROLE_PROPERTY_OWNER they were given — and
+ * never with the ROLE_GATEWAY_ADMIN the vouched set and their token give. That the gateway
+ * lists them otherwise (webrtc.v1.MemberDetail.vouched_admin) does not make them a member of
+ * this report. After a wipe (signaling.v1.GatewayDeleted, WIPE) the gateway reports a snapshot
+ * with no members.
  *
  * @generated from message kusinta.iot.reporting.v1.GatewayMember
  */