@kusinta/iot-schema 0.1.0-beta.7 → 0.2.0-beta.1

package/src/kusinta/iot/connector/v1/connector_service_pb.d.ts

@@ -1,9 +1,9 @@
-// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts"
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
 // @generated from file kusinta/iot/connector/v1/connector_service.proto (package kusinta.iot.connector.v1, syntax proto3)
 /* eslint-disable */
 
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { ConnectRequestSchema, ConnectResponseSchema } from "./connector_pb";
+import type { SessionRequestSchema, SessionResponseSchema } from "./connector_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector_service.proto.
@@ -18,12 +18,12 @@ export declare const file_kusinta_iot_connector_v1_connector_service: GenFile;
  */
 export declare const ConnectorGatewayService: GenService<{
   /**
-   * @generated from rpc kusinta.iot.connector.v1.ConnectorGatewayService.Connect
+   * @generated from rpc kusinta.iot.connector.v1.ConnectorGatewayService.Session
    */
-  connect: {
+  session: {
     methodKind: "bidi_streaming";
-    input: typeof ConnectRequestSchema;
-    output: typeof ConnectResponseSchema;
+    input: typeof SessionRequestSchema;
+    output: typeof SessionResponseSchema;
   },
 }>;
 

package/src/kusinta/iot/connector/v1/connector_service_pb.js

@@ -1,15 +1,15 @@
-// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts"
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
 // @generated from file kusinta/iot/connector/v1/connector_service.proto (package kusinta.iot.connector.v1, syntax proto3)
 /* eslint-disable */
 
 import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
-import { file_kusinta_iot_connector_v1_connector } from "./connector_pb";
+import { file_kusinta_iot_connector_v1_connector } from "./connector_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector_service.proto.
  */
 export const file_kusinta_iot_connector_v1_connector_service = /*@__PURE__*/
-  fileDesc("CjBrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LmNvbm5lY3Rvci52MTJ9ChdDb25uZWN0b3JHYXRld2F5U2VydmljZRJiCgdDb25uZWN0Eigua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RSZXF1ZXN0Gikua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RSZXNwb25zZSgBMAFCAkgBYgZwcm90bzM", [file_kusinta_iot_connector_v1_connector]);
+  fileDesc("CjBrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LmNvbm5lY3Rvci52MTJ9ChdDb25uZWN0b3JHYXRld2F5U2VydmljZRJiCgdTZXNzaW9uEigua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlNlc3Npb25SZXF1ZXN0Gikua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLlNlc3Npb25SZXNwb25zZSgBMAFCAkgBYgZwcm90bzM", [file_kusinta_iot_connector_v1_connector]);
 
 /**
  * ConnectorGatewayService: connector dials the gateway on startup.

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

@@ -0,0 +1,238 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @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 { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file kusinta/iot/device/v1/cluster_state.proto.
+ */
+export declare const file_kusinta_iot_device_v1_cluster_state: GenFile;
+
+/**
+ * Matter null. Distinct from a field being absent: Matter types many attributes as
+ * nullable, where null is a reported value meaning "not currently known" — a thermostat
+ * that cannot read its local temperature reports null, which is not the same as never
+ * having reported at all.
+ *
+ * @generated from message kusinta.iot.device.v1.NullValue
+ */
+export declare type NullValue = Message<"kusinta.iot.device.v1.NullValue"> & {
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.NullValue.
+ * Use `create(NullValueSchema)` to create a new message.
+ */
+export declare const NullValueSchema: GenMessage<NullValue>;
+
+/**
+ * A Matter attribute value of any shape, including the ones a scalar cannot carry.
+ *
+ * Self-describing rather than Matter's own TLV as opaque bytes: an app that cannot decode
+ * a value cannot show it, and TLV would make the generic path useful only to the gateway.
+ * The cost is a recursive message; the benefit is that an attribute this schema has never
+ * heard of is still renderable.
+ *
+ * Widths are deliberately wider than most attributes need — sint64 covers every signed
+ * Matter integer type and uint64 every unsigned one, so a generic carrier never has to
+ * know an attribute's declared width to carry its value.
+ *
+ * @generated from message kusinta.iot.device.v1.AttributeValue
+ */
+export declare type AttributeValue = Message<"kusinta.iot.device.v1.AttributeValue"> & {
+  /**
+   * @generated from oneof kusinta.iot.device.v1.AttributeValue.value
+   */
+  value: {
+    /**
+     * @generated from field: bool bool_value = 1;
+     */
+    value: boolean;
+    case: "boolValue";
+  } | {
+    /**
+     * @generated from field: sint64 int_value = 2;
+     */
+    value: bigint;
+    case: "intValue";
+  } | {
+    /**
+     * @generated from field: uint64 uint_value = 3;
+     */
+    value: bigint;
+    case: "uintValue";
+  } | {
+    /**
+     * @generated from field: double double_value = 4;
+     */
+    value: number;
+    case: "doubleValue";
+  } | {
+    /**
+     * @generated from field: string string_value = 5;
+     */
+    value: string;
+    case: "stringValue";
+  } | {
+    /**
+     * @generated from field: bytes bytes_value = 6;
+     */
+    value: Uint8Array;
+    case: "bytesValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.AttributeValueList list_value = 7;
+     */
+    value: AttributeValueList;
+    case: "listValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.AttributeValueStruct struct_value = 8;
+     */
+    value: AttributeValueStruct;
+    case: "structValue";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.NullValue null_value = 9;
+     */
+    value: NullValue;
+    case: "nullValue";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValue.
+ * Use `create(AttributeValueSchema)` to create a new message.
+ */
+export declare const AttributeValueSchema: GenMessage<AttributeValue>;
+
+/**
+ * @generated from message kusinta.iot.device.v1.AttributeValueList
+ */
+export declare type AttributeValueList = Message<"kusinta.iot.device.v1.AttributeValueList"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.device.v1.AttributeValue values = 1;
+   */
+  values: AttributeValue[];
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueList.
+ * Use `create(AttributeValueListSchema)` to create a new message.
+ */
+export declare const AttributeValueListSchema: GenMessage<AttributeValueList>;
+
+/**
+ * Matter struct fields are addressed by numeric context tag, not by name, so the map is
+ * keyed by tag. A consumer that knows the struct's definition reads the tags it wants; one
+ * that does not can still carry and re-emit the whole thing.
+ *
+ * @generated from message kusinta.iot.device.v1.AttributeValueStruct
+ */
+export declare type AttributeValueStruct = Message<"kusinta.iot.device.v1.AttributeValueStruct"> & {
+  /**
+   * @generated from field: map<uint32, kusinta.iot.device.v1.AttributeValue> fields = 1;
+   */
+  fields: { [key: number]: AttributeValue };
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueStruct.
+ * Use `create(AttributeValueStructSchema)` to create a new message.
+ */
+export declare const AttributeValueStructSchema: GenMessage<AttributeValueStruct>;
+
+/**
+ * @generated from message kusinta.iot.device.v1.AttributeState
+ */
+export declare type AttributeState = Message<"kusinta.iot.device.v1.AttributeState"> & {
+  /**
+   * @generated from field: uint32 attribute_id = 1;
+   */
+  attributeId: number;
+
+  /**
+   * @generated from field: kusinta.iot.device.v1.AttributeValue value = 2;
+   */
+  value?: AttributeValue | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeState.
+ * Use `create(AttributeStateSchema)` to create a new message.
+ */
+export declare const AttributeStateSchema: GenMessage<AttributeState>;
+
+/**
+ * One cluster hosted by an endpoint: what it is, what it supports, and any attribute value
+ * that has no typed home.
+ *
+ * An entry exists for EVERY cluster the endpoint hosts, including clusters this schema
+ * models with a typed properties message. That is not a contradiction of the
+ * one-value-one-place rule below — cluster_revision, feature_map and
+ * accepted_command_ids describe the cluster itself and have nowhere else to live.
+ *
+ * attributes is where the rule applies: it holds ONLY the attribute values that no typed
+ * field covers. An attribute the schema models is carried in its typed field and MUST NOT
+ * be repeated here — a value that exists in two places is a value that can disagree with
+ * itself.
+ *
+ * This is what lets an endpoint report something useful when its device type is not
+ * modelled, or when it carries a cluster beyond its device type's set, which the Matter
+ * specification explicitly permits.
+ *
+ * @generated from message kusinta.iot.device.v1.ClusterState
+ */
+export declare type ClusterState = Message<"kusinta.iot.device.v1.ClusterState"> & {
+  /**
+   * @generated from field: uint32 cluster_id = 1;
+   */
+  clusterId: number;
+
+  /**
+   * Matter's ClusterRevision. Which revision of the cluster definition the device
+   * implements.
+   *
+   * @generated from field: optional uint32 cluster_revision = 2;
+   */
+  clusterRevision?: number | undefined;
+
+  /**
+   * Matter's FeatureMap: a bitmap of the optional features this cluster supports on this
+   * endpoint.
+   *
+   * Worth carrying even for fully-modelled clusters, because it resolves an ambiguity the
+   * presence rule cannot. properties.proto says an absent field means "never reported" —
+   * but without a FeatureMap, absent is also what an attribute the device does not
+   * implement looks like. With it, a consumer can tell "not supported" from "not yet
+   * seen".
+   *
+   * @generated from field: optional uint32 feature_map = 3;
+   */
+  featureMap?: number | undefined;
+
+  /**
+   * Attribute values with no typed field. See the message comment.
+   *
+   * @generated from field: repeated kusinta.iot.device.v1.AttributeState attributes = 4;
+   */
+  attributes: AttributeState[];
+
+  /**
+   * Matter's AcceptedCommandList: which commands this cluster accepts on this endpoint.
+   * Without it a consumer must infer a device's capabilities from its device type and
+   * discover the truth by sending a command and watching it fail.
+   *
+   * @generated from field: repeated uint32 accepted_command_ids = 5;
+   */
+  acceptedCommandIds: number[];
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.ClusterState.
+ * Use `create(ClusterStateSchema)` to create a new message.
+ */
+export declare const ClusterStateSchema: GenMessage<ClusterState>;
+

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

@@ -0,0 +1,54 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @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";
+
+/**
+ * Describes the file kusinta/iot/device/v1/cluster_state.proto.
+ */
+export const file_kusinta_iot_device_v1_cluster_state = /*@__PURE__*/
+  fileDesc("CilrdXNpbnRhL2lvdC9kZXZpY2UvdjEvY2x1c3Rlcl9zdGF0ZS5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIgsKCU51bGxWYWx1ZSLfAgoOQXR0cmlidXRlVmFsdWUSFAoKYm9vbF92YWx1ZRgBIAEoCEgAEhMKCWludF92YWx1ZRgCIAEoEkgAEhQKCnVpbnRfdmFsdWUYAyABKARIABIWCgxkb3VibGVfdmFsdWUYBCABKAFIABIWCgxzdHJpbmdfdmFsdWUYBSABKAlIABIVCgtieXRlc192YWx1ZRgGIAEoDEgAEj8KCmxpc3RfdmFsdWUYByABKAsyKS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVMaXN0SAASQwoMc3RydWN0X3ZhbHVlGAggASgLMisua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlU3RydWN0SAASNgoKbnVsbF92YWx1ZRgJIAEoCzIgLmt1c2ludGEuaW90LmRldmljZS52MS5OdWxsVmFsdWVIAEIHCgV2YWx1ZSJLChJBdHRyaWJ1dGVWYWx1ZUxpc3QSNQoGdmFsdWVzGAEgAygLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlIrUBChRBdHRyaWJ1dGVWYWx1ZVN0cnVjdBJHCgZmaWVsZHMYASADKAsyNy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVTdHJ1Y3QuRmllbGRzRW50cnkaVAoLRmllbGRzRW50cnkSCwoDa2V5GAEgASgNEjQKBXZhbHVlGAIgASgLMiUua3VzaW50YS5pb3QuZGV2aWNlLnYxLkF0dHJpYnV0ZVZhbHVlOgI4ASJcCg5BdHRyaWJ1dGVTdGF0ZRIUCgxhdHRyaWJ1dGVfaWQYASABKA0SNAoFdmFsdWUYAiABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWUi2QEKDENsdXN0ZXJTdGF0ZRISCgpjbHVzdGVyX2lkGAEgASgNEh0KEGNsdXN0ZXJfcmV2aXNpb24YAiABKA1IAIgBARIYCgtmZWF0dXJlX21hcBgDIAEoDUgBiAEBEjkKCmF0dHJpYnV0ZXMYBCADKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlU3RhdGUSHAoUYWNjZXB0ZWRfY29tbWFuZF9pZHMYBSADKA1CEwoRX2NsdXN0ZXJfcmV2aXNpb25CDgoMX2ZlYXR1cmVfbWFwQgJIAWIGcHJvdG8z");
+
+/**
+ * Describes the message kusinta.iot.device.v1.NullValue.
+ * Use `create(NullValueSchema)` to create a new message.
+ */
+export const NullValueSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 0);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValue.
+ * Use `create(AttributeValueSchema)` to create a new message.
+ */
+export const AttributeValueSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 1);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueList.
+ * Use `create(AttributeValueListSchema)` to create a new message.
+ */
+export const AttributeValueListSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 2);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeValueStruct.
+ * Use `create(AttributeValueStructSchema)` to create a new message.
+ */
+export const AttributeValueStructSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 3);
+
+/**
+ * Describes the message kusinta.iot.device.v1.AttributeState.
+ * Use `create(AttributeStateSchema)` to create a new message.
+ */
+export const AttributeStateSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 4);
+
+/**
+ * Describes the message kusinta.iot.device.v1.ClusterState.
+ * Use `create(ClusterStateSchema)` to create a new message.
+ */
+export const ClusterStateSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_cluster_state, 5);
+

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

@@ -1,12 +1,13 @@
-// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts"
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
 // @generated from file kusinta/iot/device/v1/descriptor.proto (package kusinta.iot.device.v1, syntax proto3)
 /* eslint-disable */
 
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
-import type { ConnectorId, DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb";
-import type { DeviceLifecycleState, DeviceOwnershipType } from "../../common/v1/types_pb";
+import type { ConnectorId, DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
+import type { DeviceLifecycleState, DeviceOwnershipType } from "../../common/v1/types_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { HomematicDeviceIdentity } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
  * Describes the file kusinta/iot/device/v1/descriptor.proto.
@@ -14,7 +15,10 @@ import type { Timestamp } from "@bufbuild/protobuf/wkt";
 export declare const file_kusinta_iot_device_v1_descriptor: GenFile;
 
 /**
- * DeviceDescriptor holds identity and Matter BasicInformation cluster fields.
+ * DeviceDescriptor holds identity and Matter BasicInformation cluster fields — what the
+ * device IS, not what it reports. The device types it presents are one per endpoint, in
+ * Device.endpoints.
+ *
  * Fields 1-19 are stable Matter-aligned fields. Fields 20+ are ownership/lifecycle.
  *
  * @generated from message kusinta.iot.device.v1.DeviceDescriptor
@@ -25,13 +29,6 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    */
   deviceId?: DeviceId | undefined;
 
-  /**
-   * Matter 1.5.1 device type ID (e.g. 0x0301 = Thermostat, 0x0302 = TemperatureSensor)
-   *
-   * @generated from field: uint32 matter_device_type_id = 2;
-   */
-  matterDeviceTypeId: number;
-
   /**
    * Matter BasicInformation cluster attributes
    *
@@ -105,6 +102,38 @@ export declare type DeviceDescriptor = Message<"kusinta.iot.device.v1.DeviceDesc
    * @generated from field: google.protobuf.Timestamp claimed_at = 16;
    */
   claimedAt?: Timestamp | undefined;
+
+  /**
+   * Who the device is in its vendor's own terms — an address and a model string that
+   * identify the PHYSICAL device, not one of its endpoints. It belongs here rather than
+   * beside the per-endpoint vendor readings, which would duplicate it onto every
+   * endpoint with no rule saying whether a producer should.
+   *
+   * Absent for a device with no vendor extension, which is most of them.
+   * Set when this device sits behind a Matter bridge, naming the bridge's own Device.
+   *
+   * A bridge is one Matter node exposing many devices, and each gets its own DeviceId here
+   * rather than becoming an endpoint of the bridge: a user perceives twelve bridged bulbs
+   * as twelve things, and one row that cannot be placed in twelve rooms is not usable.
+   *
+   * So a Device is a Matter node OR one device behind one — the equivalence is deliberately
+   * not exact, and this field is how a consumer tells which. Absent means the device is
+   * reached directly.
+   *
+   * @generated from field: optional kusinta.iot.identity.v1.DeviceId bridged_by = 19;
+   */
+  bridgedBy?: DeviceId | undefined;
+
+  /**
+   * @generated from oneof kusinta.iot.device.v1.DeviceDescriptor.vendor_identity
+   */
+  vendorIdentity: {
+    /**
+     * @generated from field: kusinta.iot.vendor.homematic.v1.HomematicDeviceIdentity homematic = 18;
+     */
+    value: HomematicDeviceIdentity;
+    case: "homematic";
+  } | { case: undefined; value?: undefined };
 };
 
 /**

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

@@ -1,17 +1,18 @@
-// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts"
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
 // @generated from file kusinta/iot/device/v1/descriptor.proto (package kusinta.iot.device.v1, syntax proto3)
 /* eslint-disable */
 
 import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
-import { file_kusinta_iot_common_v1_types } from "../../common/v1/types_pb";
-import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb";
+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";
+import { file_kusinta_iot_vendor_homematic_v1_homematic } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
  * Describes the file kusinta/iot/device/v1/descriptor.proto.
  */
 export const file_kusinta_iot_device_v1_descriptor = /*@__PURE__*/
-  fileDesc("CiZrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGVzY3JpcHRvci5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIv0EChBEZXZpY2VEZXNjcmlwdG9yEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEh0KFW1hdHRlcl9kZXZpY2VfdHlwZV9pZBgCIAEoDRITCgt2ZW5kb3JfbmFtZRgDIAEoCRIUCgxwcm9kdWN0X25hbWUYBCABKAkSFQoNc2VyaWFsX251bWJlchgFIAEoCRISCgpub2RlX2xhYmVsGAYgASgJEhEKCXZlbmRvcl9pZBgHIAEoDRISCgpwcm9kdWN0X2lkGAggASgNEh8KF2hhcmR3YXJlX3ZlcnNpb25fc3RyaW5nGAkgASgJEh8KF3NvZnR3YXJlX3ZlcnNpb25fc3RyaW5nGAogASgJEjoKDGNvbm5lY3Rvcl9pZBgLIAEoCzIkLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkNvbm5lY3RvcklkEjIKCHNwYWNlX2lkGAwgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI9Cglvd25lcnNoaXAYDSABKA4yKi5rdXNpbnRhLmlvdC5jb21tb24udjEuRGV2aWNlT3duZXJzaGlwVHlwZRI+CglsaWZlY3ljbGUYDiABKA4yKy5rdXNpbnRhLmlvdC5jb21tb24udjEuRGV2aWNlTGlmZWN5Y2xlU3RhdGUSNgoNb3duZXJfdXNlcl9pZBgPIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBIuCgpjbGFpbWVkX2F0GBAgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CiZrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGVzY3JpcHRvci5wcm90bxIVa3VzaW50YS5pb3QuZGV2aWNlLnYxIrkGChBEZXZpY2VEZXNjcmlwdG9yEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhMKC3ZlbmRvcl9uYW1lGAMgASgJEhQKDHByb2R1Y3RfbmFtZRgEIAEoCRIVCg1zZXJpYWxfbnVtYmVyGAUgASgJEhIKCm5vZGVfbGFiZWwYBiABKAkSEQoJdmVuZG9yX2lkGAcgASgNEhIKCnByb2R1Y3RfaWQYCCABKA0SHwoXaGFyZHdhcmVfdmVyc2lvbl9zdHJpbmcYCSABKAkSHwoXc29mdHdhcmVfdmVyc2lvbl9zdHJpbmcYCiABKAkSOgoMY29ubmVjdG9yX2lkGAsgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSMgoIc3BhY2VfaWQYDCABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEj0KCW93bmVyc2hpcBgNIAEoDjIqLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VPd25lcnNoaXBUeXBlEj4KCWxpZmVjeWNsZRgOIAEoDjIrLmt1c2ludGEuaW90LmNvbW1vbi52MS5EZXZpY2VMaWZlY3ljbGVTdGF0ZRI2Cg1vd25lcl91c2VyX2lkGA8gASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEi4KCmNsYWltZWRfYXQYECABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKCmJyaWRnZWRfYnkYEyABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZEgBiAEBEk0KCWhvbWVtYXRpYxgSIAEoCzI4Lmt1c2ludGEuaW90LnZlbmRvci5ob21lbWF0aWMudjEuSG9tZW1hdGljRGV2aWNlSWRlbnRpdHlIAEIRCg92ZW5kb3JfaWRlbnRpdHlCDQoLX2JyaWRnZWRfYnlKBAgCEANKBAgREBJSFW1hdHRlcl9kZXZpY2VfdHlwZV9pZFIJZW5kcG9pbnRzQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_vendor_homematic_v1_homematic]);
 
 /**
  * Describes the message kusinta.iot.device.v1.DeviceDescriptor.

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

@@ -0,0 +1,162 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/device_event.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { DeviceId } from "../../identity/v1/identity_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { AttributeValue } from "./cluster_state_pb.js";
+
+/**
+ * Describes the file kusinta/iot/device/v1/device_event.proto.
+ */
+export declare const file_kusinta_iot_device_v1_device_event: GenFile;
+
+/**
+ * Something that HAPPENED on a device, as opposed to what a device currently IS.
+ *
+ * PropertyUpdate answers "what is the lock's state now" — latest wins, order does not
+ * matter, a missed one is corrected by the next. DeviceEvent answers "what happened to the
+ * lock" — each is a distinct occurrence, order matters, and a missed one is gone unless it
+ * is fetched by its number. Matter models both for the same reason, and neither substitutes
+ * for the other: a lock's LockState attribute cannot say who unlocked it, with what
+ * credential, at what time, and an event log cannot cheaply answer what the state is now.
+ *
+ * This is the audit surface. In a building with several residents sharing a device, "the
+ * door is unlocked" and "this credential unlocked the door at 14:02" are different
+ * questions with different consumers.
+ *
+ * Events do NOT feed Device.endpoints. A consumer must not merge an event into a properties
+ * field or a ClusterState — an event's data is its own payload, not an attribute value, and
+ * the attribute it relates to reports separately. The resolution rule in
+ * property_update.proto has nothing to do with events.
+ *
+ * @generated from message kusinta.iot.device.v1.DeviceEvent
+ */
+export declare type DeviceEvent = Message<"kusinta.iot.device.v1.DeviceEvent"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId device_id = 1;
+   */
+  deviceId?: DeviceId | undefined;
+
+  /**
+   * Which endpoint emitted it, and which cluster defines it. Required, as for an update.
+   *
+   * @generated from field: optional uint32 endpoint_id = 2;
+   */
+  endpointId?: number | undefined;
+
+  /**
+   * @generated from field: uint32 cluster_id = 3;
+   */
+  clusterId: number;
+
+  /**
+   * The Matter event ID within that cluster.
+   *
+   * @generated from field: uint32 event_id = 4;
+   */
+  eventId: number;
+
+  /**
+   * Matter's EventNumber: monotonically increasing per node, and the reason an event log
+   * can be resumed rather than merely replayed. A consumer that sees a gap knows it missed
+   * something and can say so — the one guarantee a PropertyUpdate stream cannot give.
+   *
+   * Monotonic within one device. Do NOT compare across devices; they are unrelated
+   * sequences.
+   *
+   * @generated from field: uint64 event_number = 5;
+   */
+  eventNumber: bigint;
+
+  /**
+   * When the device says it happened, which is not when the gateway saw it. On a
+   * battery-powered device that wakes on a cycle, the two can differ by minutes.
+   *
+   * @generated from field: google.protobuf.Timestamp timestamp = 6;
+   */
+  timestamp?: Timestamp | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.device.v1.EventPriority priority = 7;
+   */
+  priority: EventPriority;
+
+  /**
+   * The event's own payload. Matter events carry a struct, so this is normally
+   * AttributeValue.struct_value keyed by context tag; a scalar-payload event uses a scalar
+   * case directly.
+   *
+   * @generated from field: kusinta.iot.device.v1.AttributeValue data = 8;
+   */
+  data?: AttributeValue | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.DeviceEvent.
+ * Use `create(DeviceEventSchema)` to create a new message.
+ */
+export declare const DeviceEventSchema: GenMessage<DeviceEvent>;
+
+/**
+ * @generated from message kusinta.iot.device.v1.DeviceEventBatch
+ */
+export declare type DeviceEventBatch = Message<"kusinta.iot.device.v1.DeviceEventBatch"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.device.v1.DeviceEvent events = 1;
+   */
+  events: DeviceEvent[];
+
+  /**
+   * When the gateway received these, as distinct from each event's own timestamp, which is
+   * when the device says it happened. The two differ by however long a sleeping device took
+   * to wake, and for an audit trail both matter: one is what occurred, the other is when
+   * anyone could have known.
+   *
+   * @generated from field: google.protobuf.Timestamp received_at = 2;
+   */
+  receivedAt?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.device.v1.DeviceEventBatch.
+ * Use `create(DeviceEventBatchSchema)` to create a new message.
+ */
+export declare const DeviceEventBatchSchema: GenMessage<DeviceEventBatch>;
+
+/**
+ * Matter's event priority. Governs retention and delivery urgency, not severity in a
+ * logging sense: CRITICAL events are retained and delivered with the most effort, DEBUG
+ * with the least.
+ *
+ * @generated from enum kusinta.iot.device.v1.EventPriority
+ */
+export enum EventPriority {
+  /**
+   * @generated from enum value: EVENT_PRIORITY_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: EVENT_PRIORITY_DEBUG = 1;
+   */
+  DEBUG = 1,
+
+  /**
+   * @generated from enum value: EVENT_PRIORITY_INFO = 2;
+   */
+  INFO = 2,
+
+  /**
+   * @generated from enum value: EVENT_PRIORITY_CRITICAL = 3;
+   */
+  CRITICAL = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.device.v1.EventPriority.
+ */
+export declare const EventPrioritySchema: GenEnum<EventPriority>;
+

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

@@ -0,0 +1,45 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/device_event.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_kusinta_iot_device_v1_cluster_state } from "./cluster_state_pb.js";
+import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/device/v1/device_event.proto.
+ */
+export const file_kusinta_iot_device_v1_device_event = /*@__PURE__*/
+  fileDesc("CihrdXNpbnRhL2lvdC9kZXZpY2UvdjEvZGV2aWNlX2V2ZW50LnByb3RvEhVrdXNpbnRhLmlvdC5kZXZpY2UudjEixQIKC0RldmljZUV2ZW50EjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEhgKC2VuZHBvaW50X2lkGAIgASgNSACIAQESEgoKY2x1c3Rlcl9pZBgDIAEoDRIQCghldmVudF9pZBgEIAEoDRIUCgxldmVudF9udW1iZXIYBSABKAQSLQoJdGltZXN0YW1wGAYgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI2Cghwcmlvcml0eRgHIAEoDjIkLmt1c2ludGEuaW90LmRldmljZS52MS5FdmVudFByaW9yaXR5EjMKBGRhdGEYCCABKAsyJS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuQXR0cmlidXRlVmFsdWVCDgoMX2VuZHBvaW50X2lkIncKEERldmljZUV2ZW50QmF0Y2gSMgoGZXZlbnRzGAEgAygLMiIua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUV2ZW50Ei8KC3JlY2VpdmVkX2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCp/Cg1FdmVudFByaW9yaXR5Eh4KGkVWRU5UX1BSSU9SSVRZX1VOU1BFQ0lGSUVEEAASGAoURVZFTlRfUFJJT1JJVFlfREVCVUcQARIXChNFVkVOVF9QUklPUklUWV9JTkZPEAISGwoXRVZFTlRfUFJJT1JJVFlfQ1JJVElDQUwQA0ICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_identity_v1_identity]);
+
+/**
+ * Describes the message kusinta.iot.device.v1.DeviceEvent.
+ * Use `create(DeviceEventSchema)` to create a new message.
+ */
+export const DeviceEventSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_device_event, 0);
+
+/**
+ * Describes the message kusinta.iot.device.v1.DeviceEventBatch.
+ * Use `create(DeviceEventBatchSchema)` to create a new message.
+ */
+export const DeviceEventBatchSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_device_v1_device_event, 1);
+
+/**
+ * Describes the enum kusinta.iot.device.v1.EventPriority.
+ */
+export const EventPrioritySchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_device_v1_device_event, 0);
+
+/**
+ * Matter's event priority. Governs retention and delivery urgency, not severity in a
+ * logging sense: CRITICAL events are retained and delivered with the most effort, DEBUG
+ * with the least.
+ *
+ * @generated from enum kusinta.iot.device.v1.EventPriority
+ */
+export const EventPriority = /*@__PURE__*/
+  tsEnum(EventPrioritySchema);
+