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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.1.0-beta.9",
+  "version": "0.2.0-beta.1",
   "type": "module",
   "license": "MIT",
   "files": ["src"],
@@ -14,13 +14,24 @@
     "./device":                 "./src/kusinta/iot/device/v1/device_pb.js",
     "./device/descriptor":      "./src/kusinta/iot/device/v1/descriptor_pb.js",
     "./device/properties":      "./src/kusinta/iot/device/v1/properties_pb.js",
+    "./device/matter-options":   "./src/kusinta/iot/device/v1/matter_options_pb.js",
     "./device/property-update": "./src/kusinta/iot/device/v1/property_update_pb.js",
+    "./device/cluster-state":   "./src/kusinta/iot/device/v1/cluster_state_pb.js",
+    "./device/event":           "./src/kusinta/iot/device/v1/device_event_pb.js",
+    "./vendor/options":         "./src/kusinta/iot/vendor/v1/vendor_options_pb.js",
+    "./vendor/homematic":       "./src/kusinta/iot/vendor/homematic/v1/homematic_pb.js",
     "./space":                  "./src/kusinta/iot/space/v1/space_pb.js",
     "./access":                 "./src/kusinta/iot/access/v1/acl_pb.js",
     "./access/roles":           "./src/kusinta/iot/access/v1/roles_pb.js",
     "./connector":              "./src/kusinta/iot/connector/v1/connector_pb.js",
     "./connector/service":      "./src/kusinta/iot/connector/v1/connector_service_pb.js",
-    "./webrtc":                 "./src/kusinta/iot/webrtc/v1/envelope_pb.js"
+    "./webrtc":                 "./src/kusinta/iot/webrtc/v1/envelope_pb.js",
+    "./webrtc/app-token":       "./src/kusinta/iot/webrtc/v1/app_token_pb.js",
+    "./webrtc/management":      "./src/kusinta/iot/webrtc/v1/management_pb.js",
+    "./registration":           "./src/kusinta/iot/registration/v1/registration_pb.js",
+    "./registration/service":   "./src/kusinta/iot/registration/v1/registration_service_pb.js",
+    "./signaling":              "./src/kusinta/iot/signaling/v1/signaling_pb.js",
+    "./signaling/service":      "./src/kusinta/iot/signaling/v1/signaling_service_pb.js"
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.12.0"

package/src/kusinta/iot/access/v1/acl_pb.d.ts

@@ -13,9 +13,81 @@ import type { Timestamp } from "@bufbuild/protobuf/wkt";
  */
 export declare const file_kusinta_iot_access_v1_acl: GenFile;
 
+/**
+ * AttributeRef names one attribute on one endpoint. It is the schema's single way to say
+ * "this attribute of this device" — used to grant it, to bound it, to read it and to write
+ * it, so a consumer writes one matcher rather than several that must agree.
+ *
+ * Addressed exactly as device.v1.PropertyUpdate is, and for the same reasons:
+ *
+ *   * cluster_id and attribute_id are NUMERIC and are what resolution matches. Attribute
+ *     names repeat across clusters — MeasuredValue is Temperature (0x0402), Relative
+ *     Humidity (0x0405) and Pressure (0x0403) — and a numeric pair is what the
+ *     (matter_cluster_id)/(matter_attribute_id) annotations carry, so nothing has to be
+ *     parsed or looked up to compare them.
+ *   * attribute_name is advisory: the attribute's own spelling, for logs and rendering. It
+ *     is NOT matched on the Matter branch. On the vendor branch it is the only address
+ *     there is, and there it is authoritative.
+ *   * endpoint_id matters because a device presents several endpoints, often of the same
+ *     device type: all four channels of a 4-channel actuator are OnOff on cluster 0x0006,
+ *     so a reference without one cannot tell channel 1 from channel 3.
+ *
+ * What an ABSENT endpoint_id means is decided by the field holding this message, not here,
+ * and the current holders mean opposite things on purpose — see
+ * DeviceAcl.allowed_attribute_refs and PropertyConstraint.attribute. It is optional on the
+ * wire so that "not stated" is representable and rejectable, rather than a bare uint32
+ * decoding an omission to endpoint 0, which is the Matter root node.
+ *
+ * @generated from message kusinta.iot.access.v1.AttributeRef
+ */
+export declare type AttributeRef = Message<"kusinta.iot.access.v1.AttributeRef"> & {
+  /**
+   * Advisory on the Matter branch, authoritative on the vendor branch. See above.
+   *
+   * @generated from field: string attribute_name = 1;
+   */
+  attributeName: string;
+
+  /**
+   * Matter branch. Both required there, both unset on the vendor branch.
+   *
+   * @generated from field: uint32 cluster_id = 2;
+   */
+  clusterId: number;
+
+  /**
+   * @generated from field: uint32 attribute_id = 4;
+   */
+  attributeId: number;
+
+  /**
+   * @generated from field: optional uint32 endpoint_id = 3;
+   */
+  endpointId?: number | undefined;
+
+  /**
+   * Set to name a vendor parameter instead of a Matter attribute, by its
+   * (vendor_extension) key. Then attribute_name addresses it and cluster_id/attribute_id
+   * play no part — a vendor parameter has no Matter cluster and no numeric ID in any
+   * specification.
+   *
+   * Without this a vendor parameter could be reported but never granted, bounded or
+   * written: a valve position would be all-or-nothing for permissions, which would undo
+   * most of the point of making vendor extensions reachable at all.
+   *
+   * @generated from field: optional string vendor_extension = 5;
+   */
+  vendorExtension?: string | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.access.v1.AttributeRef.
+ * Use `create(AttributeRefSchema)` to create a new message.
+ */
+export declare const AttributeRefSchema: GenMessage<AttributeRef>;
+
 /**
  * PropertyConstraint bounds a single Matter cluster attribute.
- * attribute_name uses PascalCase Matter attribute naming (e.g. "MaxHeatSetpointLimit").
  * MaxHeatSetpointLimit and MinHeatSetpointLimit are actual Matter Thermostat cluster
  * attributes (0x0016, 0x0015) — the gateway writes them directly via the connector.
  *
@@ -23,9 +95,14 @@ export declare const file_kusinta_iot_access_v1_acl: GenFile;
  */
 export declare type PropertyConstraint = Message<"kusinta.iot.access.v1.PropertyConstraint"> & {
   /**
-   * @generated from field: string attribute_name = 1;
+   * An absent AttributeRef.endpoint_id here means EVERY endpoint of the device — the
+   * opposite of what it means on a grant, deliberately. A constraint is a restriction, so
+   * omission broadens what is restricted; a grant is permission, so omission there would
+   * broaden access and is invalid instead. Both defaults fail safe.
+   *
+   * @generated from field: kusinta.iot.access.v1.AttributeRef attribute = 8;
    */
-  attributeName: string;
+  attribute?: AttributeRef | undefined;
 
   /**
    * @generated from oneof kusinta.iot.access.v1.PropertyConstraint.constraint
@@ -55,11 +132,6 @@ export declare type PropertyConstraint = Message<"kusinta.iot.access.v1.Property
     value: number;
     case: "uintMin";
   } | { case: undefined; value?: undefined };
-
-  /**
-   * @generated from field: string cluster_id_hex = 6;
-   */
-  clusterIdHex: string;
 };
 
 /**
@@ -88,16 +160,33 @@ export declare type DeviceAcl = Message<"kusinta.iot.access.v1.DeviceAcl"> & {
   role: Role;
 
   /**
+   * What this user may do to this device. EMPTY GRANTS NOTHING — an ACL with no actions
+   * permits no operation at all.
+   *
+   * Deliberately the opposite default to allowed_attribute_refs below, which is empty for
+   * "every attribute". The two are not the same kind of list: this one IS the grant, so an
+   * empty grant is empty, while that one is a FILTER narrowing the grant, so an empty
+   * filter narrows nothing. Reading either as the other fails open.
+   *
+   * PERMISSION_ACTION_UNSPECIFIED in this list is invalid and MUST be rejected; it is not
+   * a wildcard. See roles.proto for what each action authorizes.
+   *
    * @generated from field: repeated kusinta.iot.access.v1.PermissionAction allowed_actions = 4;
    */
   allowedActions: PermissionAction[];
 
   /**
-   * empty = all attributes allowed
+   * Narrows allowed_actions to particular attributes. Empty = every attribute on every
+   * endpoint, unchanged in meaning from the field it replaces — an empty filter narrows
+   * nothing. It does NOT grant anything on its own: with allowed_actions empty, this
+   * being empty still permits no operation.
+   *
+   * A ref present with no endpoint_id is INVALID and MUST be rejected, not read as a grant
+   * over every endpoint: omission must never be what widens access.
    *
-   * @generated from field: repeated string allowed_attributes = 5;
+   * @generated from field: repeated kusinta.iot.access.v1.AttributeRef allowed_attribute_refs = 7;
    */
-  allowedAttributes: string[];
+  allowedAttributeRefs: AttributeRef[];
 
   /**
    * @generated from field: repeated kusinta.iot.access.v1.PropertyConstraint property_constraints = 6;

package/src/kusinta/iot/access/v1/acl_pb.js

@@ -11,26 +11,33 @@ import { file_kusinta_iot_access_v1_roles } from "./roles_pb.js";
  * Describes the file kusinta/iot/access/v1/acl.proto.
  */
 export const file_kusinta_iot_access_v1_acl = /*@__PURE__*/
-  fileDesc("Ch9rdXNpbnRhL2lvdC9hY2Nlc3MvdjEvYWNsLnByb3RvEhVrdXNpbnRhLmlvdC5hY2Nlc3MudjEioAEKElByb3BlcnR5Q29uc3RyYWludBIWCg5hdHRyaWJ1dGVfbmFtZRgBIAEoCRIRCgdpbnRfbWF4GAIgASgRSAASEQoHaW50X21pbhgDIAEoEUgAEhIKCHVpbnRfbWF4GAQgASgNSAASEgoIdWludF9taW4YBSABKA1IABIWCg5jbHVzdGVyX2lkX2hleBgGIAEoCUIMCgpjb25zdHJhaW50IsUCCglEZXZpY2VBY2wSNAoJZGV2aWNlX2lkGAEgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSMAoHdXNlcl9pZBgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBIpCgRyb2xlGAMgASgOMhsua3VzaW50YS5pb3QuYWNjZXNzLnYxLlJvbGUSQAoPYWxsb3dlZF9hY3Rpb25zGAQgAygOMicua3VzaW50YS5pb3QuYWNjZXNzLnYxLlBlcm1pc3Npb25BY3Rpb24SGgoSYWxsb3dlZF9hdHRyaWJ1dGVzGAUgAygJEkcKFHByb3BlcnR5X2NvbnN0cmFpbnRzGAYgAygLMikua3VzaW50YS5pb3QuYWNjZXNzLnYxLlByb3BlcnR5Q29uc3RyYWludCLlAQoURWZmZWN0aXZlUGVybWlzc2lvbnMSMAoHdXNlcl9pZBgBIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBI2CgpnYXRld2F5X2lkGAIgASgLMiIua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuR2F0ZXdheUlkEjUKC2RldmljZV9hY2xzGAMgAygLMiAua3VzaW50YS5pb3QuYWNjZXNzLnYxLkRldmljZUFjbBIsCgh2YWxpZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_access_v1_roles]);
+  fileDesc("Ch9rdXNpbnRhL2lvdC9hY2Nlc3MvdjEvYWNsLnByb3RvEhVrdXNpbnRhLmlvdC5hY2Nlc3MudjEirgEKDEF0dHJpYnV0ZVJlZhIWCg5hdHRyaWJ1dGVfbmFtZRgBIAEoCRISCgpjbHVzdGVyX2lkGAIgASgNEhQKDGF0dHJpYnV0ZV9pZBgEIAEoDRIYCgtlbmRwb2ludF9pZBgDIAEoDUgAiAEBEh0KEHZlbmRvcl9leHRlbnNpb24YBSABKAlIAYgBAUIOCgxfZW5kcG9pbnRfaWRCEwoRX3ZlbmRvcl9leHRlbnNpb24i5wEKElByb3BlcnR5Q29uc3RyYWludBI2CglhdHRyaWJ1dGUYCCABKAsyIy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuQXR0cmlidXRlUmVmEhEKB2ludF9tYXgYAiABKBFIABIRCgdpbnRfbWluGAMgASgRSAASEgoIdWludF9tYXgYBCABKA1IABISCgh1aW50X21pbhgFIAEoDUgAQgwKCmNvbnN0cmFpbnRKBAgBEAJKBAgGEAdKBAgHEAhSDmF0dHJpYnV0ZV9uYW1lUg5jbHVzdGVyX2lkX2hleFILZW5kcG9pbnRfaWQiiAMKCURldmljZUFjbBI0CglkZXZpY2VfaWQYASABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIwCgd1c2VyX2lkGAIgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEikKBHJvbGUYAyABKA4yGy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuUm9sZRJACg9hbGxvd2VkX2FjdGlvbnMYBCADKA4yJy5rdXNpbnRhLmlvdC5hY2Nlc3MudjEuUGVybWlzc2lvbkFjdGlvbhJDChZhbGxvd2VkX2F0dHJpYnV0ZV9yZWZzGAcgAygLMiMua3VzaW50YS5pb3QuYWNjZXNzLnYxLkF0dHJpYnV0ZVJlZhJHChRwcm9wZXJ0eV9jb25zdHJhaW50cxgGIAMoCzIpLmt1c2ludGEuaW90LmFjY2Vzcy52MS5Qcm9wZXJ0eUNvbnN0cmFpbnRKBAgFEAZSEmFsbG93ZWRfYXR0cmlidXRlcyLlAQoURWZmZWN0aXZlUGVybWlzc2lvbnMSMAoHdXNlcl9pZBgBIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBI2CgpnYXRld2F5X2lkGAIgASgLMiIua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuR2F0ZXdheUlkEjUKC2RldmljZV9hY2xzGAMgAygLMiAua3VzaW50YS5pb3QuYWNjZXNzLnYxLkRldmljZUFjbBIsCgh2YWxpZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_access_v1_roles]);
+
+/**
+ * Describes the message kusinta.iot.access.v1.AttributeRef.
+ * Use `create(AttributeRefSchema)` to create a new message.
+ */
+export const AttributeRefSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_access_v1_acl, 0);
 
 /**
  * Describes the message kusinta.iot.access.v1.PropertyConstraint.
  * Use `create(PropertyConstraintSchema)` to create a new message.
  */
 export const PropertyConstraintSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_access_v1_acl, 0);
+  messageDesc(file_kusinta_iot_access_v1_acl, 1);
 
 /**
  * Describes the message kusinta.iot.access.v1.DeviceAcl.
  * Use `create(DeviceAclSchema)` to create a new message.
  */
 export const DeviceAclSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_access_v1_acl, 1);
+  messageDesc(file_kusinta_iot_access_v1_acl, 2);
 
 /**
  * Describes the message kusinta.iot.access.v1.EffectivePermissions.
  * Use `create(EffectivePermissionsSchema)` to create a new message.
  */
 export const EffectivePermissionsSchema = /*@__PURE__*/
-  messageDesc(file_kusinta_iot_access_v1_acl, 2);
+  messageDesc(file_kusinta_iot_access_v1_acl, 3);
 

package/src/kusinta/iot/access/v1/roles_pb.d.ts

@@ -45,30 +45,57 @@ export enum Role {
 export declare const RoleSchema: GenEnum<Role>;
 
 /**
+ * What a user may do to a device, as listed in DeviceAcl.allowed_actions. Each value
+ * names an operation that exists on the app leg, so a grant can be checked against the
+ * message that arrived.
+ *
  * @generated from enum kusinta.iot.access.v1.PermissionAction
  */
 export enum PermissionAction {
   /**
+   * Names no action. Present only because buf's ENUM_ZERO_VALUE_SUFFIX requires a zero
+   * value; it is not a wildcard and carries no permission.
+   *
+   * In allowed_actions it is INVALID and MUST be rejected — never read as "any action".
+   * Omission must never be what widens access.
+   *
    * @generated from enum value: PERMISSION_ACTION_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * Read an attribute once, on demand: webrtc.v1.PropertyReadRequest.
+   *
    * @generated from enum value: PERMISSION_ACTION_READ = 1;
    */
   READ = 1,
 
   /**
+   * Write an attribute directly.
+   *
+   * NOTE: no message on the app leg does this. AppMessage carries handshake, command,
+   * read_request, ping, subscribe, unsubscribe and management — nothing that writes an
+   * attribute, so the only thing that changes a device is a DeviceCommand, which is
+   * INVOKE. This value therefore authorizes an operation that does not yet exist. It is
+   * kept rather than reserved because a direct attribute write is a plausible addition
+   * and burning the number would gain nothing; until then, granting it grants nothing.
+   *
    * @generated from enum value: PERMISSION_ACTION_WRITE = 2;
    */
   WRITE = 2,
 
   /**
+   * Receive attribute changes as they happen: webrtc.v1.AppMessage.subscribe and the
+   * DevicePropertyEvent stream that follows. Distinct from READ — observing is a standing
+   * interest in a device, not a single question about it.
+   *
    * @generated from enum value: PERMISSION_ACTION_OBSERVE = 3;
    */
   OBSERVE = 3,
 
   /**
+   * Send a webrtc.v1.DeviceCommand. This is the action that moves hardware.
+   *
    * @generated from enum value: PERMISSION_ACTION_INVOKE = 4;
    */
   INVOKE = 4,

package/src/kusinta/iot/access/v1/roles_pb.js

@@ -29,6 +29,10 @@ export const PermissionActionSchema = /*@__PURE__*/
   enumDesc(file_kusinta_iot_access_v1_roles, 1);
 
 /**
+ * What a user may do to a device, as listed in DeviceAcl.allowed_actions. Each value
+ * names an operation that exists on the app leg, so a grant can be checked against the
+ * message that arrived.
+ *
  * @generated from enum kusinta.iot.access.v1.PermissionAction
  */
 export const PermissionAction = /*@__PURE__*/

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

@@ -6,10 +6,11 @@ import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
 import type { ConnectorId, DeviceId, GatewayId } from "../../identity/v1/identity_pb.js";
 import type { ConnectorTransport } from "../../common/v1/types_pb.js";
-import type { DeviceDescriptor } from "../../device/v1/descriptor_pb.js";
+import type { Device } from "../../device/v1/device_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 import type { PropertyUpdateBatch } from "../../device/v1/property_update_pb.js";
-import type { DeviceCommand } from "../../webrtc/v1/command_pb.js";
+import type { DeviceEventBatch } from "../../device/v1/device_event_pb.js";
+import type { AttributeWriteRequest, DeviceCommand } from "../../webrtc/v1/command_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector.proto.
@@ -69,9 +70,9 @@ export declare type ConnectorHandshake = Message<"kusinta.iot.connector.v1.Conne
   info?: ConnectorInfo | undefined;
 
   /**
-   * @generated from field: repeated kusinta.iot.device.v1.DeviceDescriptor known_devices = 2;
+   * @generated from field: repeated kusinta.iot.device.v1.Device known_devices = 2;
    */
-  knownDevices: DeviceDescriptor[];
+  knownDevices: Device[];
 };
 
 /**
@@ -107,13 +108,20 @@ export declare type HandshakeAck = Message<"kusinta.iot.connector.v1.HandshakeAc
 export declare const HandshakeAckSchema: GenMessage<HandshakeAck>;
 
 /**
+ * A device the connector has found. Carries the full Device, not just its descriptor,
+ * because a device's endpoints are what say which Matter device types it presents — and
+ * without them the gateway cannot resolve any PropertyUpdate the device goes on to send.
+ *
+ * Properties may be unset on every endpoint; that means the device exists and has
+ * reported nothing yet, which is the normal state at announcement.
+ *
  * @generated from message kusinta.iot.connector.v1.DeviceAnnouncement
  */
 export declare type DeviceAnnouncement = Message<"kusinta.iot.connector.v1.DeviceAnnouncement"> & {
   /**
-   * @generated from field: kusinta.iot.device.v1.DeviceDescriptor descriptor = 1;
+   * @generated from field: kusinta.iot.device.v1.Device device = 2;
    */
-  descriptor?: DeviceDescriptor | undefined;
+  device?: Device | undefined;
 };
 
 /**
@@ -202,11 +210,11 @@ export declare type GatewayError = Message<"kusinta.iot.connector.v1.GatewayErro
   message: string;
 
   /**
-   * non-empty if the error is in response to a command
+   * non-empty if the error answers a command or a write
    *
-   * @generated from field: string command_id = 3;
+   * @generated from field: string request_id = 3;
    */
-  commandId: string;
+  requestId: string;
 };
 
 /**
@@ -216,13 +224,20 @@ export declare type GatewayError = Message<"kusinta.iot.connector.v1.GatewayErro
 export declare const GatewayErrorSchema: GenMessage<GatewayError>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.CommandResult
+ * A connector's answer to an executed command OR attribute write. One message for both:
+ * the two operations differ in what they do to a device, not in how a connector reports
+ * having done it, and request_id says which request this answers either way.
+ *
+ * @generated from message kusinta.iot.connector.v1.ConnectorCommandResult
  */
-export declare type CommandResult = Message<"kusinta.iot.connector.v1.CommandResult"> & {
+export declare type ConnectorCommandResult = Message<"kusinta.iot.connector.v1.ConnectorCommandResult"> & {
   /**
-   * @generated from field: string command_id = 1;
+   * Was command_id. Renamed with webrtc.v1.DeviceCommand.request_id, which it mirrors, and
+   * because it now correlates writes as well as commands.
+   *
+   * @generated from field: string request_id = 1;
    */
-  commandId: string;
+  requestId: string;
 
   /**
    * @generated from field: bool success = 2;
@@ -241,15 +256,15 @@ export declare type CommandResult = Message<"kusinta.iot.connector.v1.CommandRes
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.CommandResult.
- * Use `create(CommandResultSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.ConnectorCommandResult.
+ * Use `create(ConnectorCommandResultSchema)` to create a new message.
  */
-export declare const CommandResultSchema: GenMessage<CommandResult>;
+export declare const ConnectorCommandResultSchema: GenMessage<ConnectorCommandResult>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.ConnectRequest
+ * @generated from message kusinta.iot.connector.v1.SessionRequest
  */
-export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRequest"> & {
+export declare type SessionRequest = Message<"kusinta.iot.connector.v1.SessionRequest"> & {
   /**
    * @generated from field: string message_id = 1;
    */
@@ -261,7 +276,7 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
   sentAt?: Timestamp | undefined;
 
   /**
-   * @generated from oneof kusinta.iot.connector.v1.ConnectRequest.payload
+   * @generated from oneof kusinta.iot.connector.v1.SessionRequest.payload
    */
   payload: {
     /**
@@ -289,9 +304,9 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
     case: "deviceRemoved";
   } | {
     /**
-     * @generated from field: kusinta.iot.connector.v1.CommandResult command_result = 7;
+     * @generated from field: kusinta.iot.connector.v1.ConnectorCommandResult command_result = 7;
      */
-    value: CommandResult;
+    value: ConnectorCommandResult;
     case: "commandResult";
   } | {
     /**
@@ -299,19 +314,25 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
      */
     value: HeartBeat;
     case: "heartbeat";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.device.v1.DeviceEventBatch device_events = 9;
+     */
+    value: DeviceEventBatch;
+    case: "deviceEvents";
   } | { case: undefined; value?: undefined };
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectRequest.
- * Use `create(ConnectRequestSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionRequest.
+ * Use `create(SessionRequestSchema)` to create a new message.
  */
-export declare const ConnectRequestSchema: GenMessage<ConnectRequest>;
+export declare const SessionRequestSchema: GenMessage<SessionRequest>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.ConnectResponse
+ * @generated from message kusinta.iot.connector.v1.SessionResponse
  */
-export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectResponse"> & {
+export declare type SessionResponse = Message<"kusinta.iot.connector.v1.SessionResponse"> & {
   /**
    * @generated from field: string message_id = 1;
    */
@@ -323,7 +344,7 @@ export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectR
   sentAt?: Timestamp | undefined;
 
   /**
-   * @generated from oneof kusinta.iot.connector.v1.ConnectResponse.payload
+   * @generated from oneof kusinta.iot.connector.v1.SessionResponse.payload
    */
   payload: {
     /**
@@ -355,12 +376,21 @@ export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectR
      */
     value: DeviceCommand;
     case: "executeCommand";
+  } | {
+    /**
+     * The connector-leg half of PERMISSION_ACTION_WRITE. A sibling case rather than another
+     * meaning overloaded onto execute_command, which is the mistake this replaces.
+     *
+     * @generated from field: kusinta.iot.webrtc.v1.AttributeWriteRequest execute_attribute_write = 9;
+     */
+    value: AttributeWriteRequest;
+    case: "executeAttributeWrite";
   } | { case: undefined; value?: undefined };
 };
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectResponse.
- * Use `create(ConnectResponseSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionResponse.
+ * Use `create(SessionResponseSchema)` to create a new message.
  */
-export declare const ConnectResponseSchema: GenMessage<ConnectResponse>;
+export declare const SessionResponseSchema: GenMessage<SessionResponse>;
 

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

@@ -6,7 +6,8 @@ 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.js";
 import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
-import { file_kusinta_iot_device_v1_descriptor } from "../../device/v1/descriptor_pb.js";
+import { file_kusinta_iot_device_v1_device } from "../../device/v1/device_pb.js";
+import { file_kusinta_iot_device_v1_device_event } from "../../device/v1/device_event_pb.js";
 import { file_kusinta_iot_device_v1_property_update } from "../../device/v1/property_update_pb.js";
 import { file_kusinta_iot_webrtc_v1_command } from "../../webrtc/v1/command_pb.js";
 
@@ -14,7 +15,7 @@ import { file_kusinta_iot_webrtc_v1_command } from "../../webrtc/v1/command_pb.j
  * Describes the file kusinta/iot/connector/v1/connector.proto.
  */
 export const file_kusinta_iot_connector_v1_connector = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIosBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEj4KDWtub3duX2RldmljZXMYAiADKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJoCgxIYW5kc2hha2VBY2sSEAoIYWNjZXB0ZWQYASABKAgSDgoGcmVhc29uGAIgASgJEjYKCmdhdGV3YXlfaWQYAyABKAsyIi5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5HYXRld2F5SWQiUQoSRGV2aWNlQW5ub3VuY2VtZW50EjsKCmRlc2NyaXB0b3IYASABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKY29tbWFuZF9pZBgDIAEoCSKdAQoNQ29tbWFuZFJlc3VsdBISCgpjb21tYW5kX2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAi8AMKDkNvbm5lY3RSZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASQQoOY29tbWFuZF9yZXN1bHQYByABKAsyJy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIAEIJCgdwYXlsb2FkIqIDCg9Db25uZWN0UmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cg1oYW5kc2hha2VfYWNrGAMgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhhbmRzaGFrZUFja0gAEj4KCXN1YnNjcmliZRgFIAEoCzIpLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5TdWJzY3JpYmVEZXZpY2VIABJCCgt1bnN1YnNjcmliZRgGIAEoCzIrLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5VbnN1YnNjcmliZURldmljZUgAEjcKBWVycm9yGAcgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkdhdGV3YXlFcnJvckgAEj8KD2V4ZWN1dGVfY29tbWFuZBgIIAEoCzIkLmt1c2ludGEuaW90LndlYnJ0Yy52MS5EZXZpY2VDb21tYW5kSABCCQoHcGF5bG9hZEoECAQQBUICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_device_v1_descriptor, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_webrtc_v1_command]);
+  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIoEBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEjQKDWtub3duX2RldmljZXMYAiADKAsyHS5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlImgKDEhhbmRzaGFrZUFjaxIQCghhY2NlcHRlZBgBIAEoCBIOCgZyZWFzb24YAiABKAkSNgoKZ2F0ZXdheV9pZBgDIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCJVChJEZXZpY2VBbm5vdW5jZW1lbnQSLQoGZGV2aWNlGAIgASgLMh0ua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUoECAEQAlIKZGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKcmVxdWVzdF9pZBgDIAEoCSKmAQoWQ29ubmVjdG9yQ29tbWFuZFJlc3VsdBISCgpyZXF1ZXN0X2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiuwQKDlNlc3Npb25SZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASSgoOY29tbWFuZF9yZXN1bHQYByABKAsyMC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29ubmVjdG9yQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIABJACg1kZXZpY2VfZXZlbnRzGAkgASgLMicua3VzaW50YS5pb3QuZGV2aWNlLnYxLkRldmljZUV2ZW50QmF0Y2hIAEIJCgdwYXlsb2FkIvMDCg9TZXNzaW9uUmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cg1oYW5kc2hha2VfYWNrGAMgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhhbmRzaGFrZUFja0gAEj4KCXN1YnNjcmliZRgFIAEoCzIpLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5TdWJzY3JpYmVEZXZpY2VIABJCCgt1bnN1YnNjcmliZRgGIAEoCzIrLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5VbnN1YnNjcmliZURldmljZUgAEjcKBWVycm9yGAcgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkdhdGV3YXlFcnJvckgAEj8KD2V4ZWN1dGVfY29tbWFuZBgIIAEoCzIkLmt1c2ludGEuaW90LndlYnJ0Yy52MS5EZXZpY2VDb21tYW5kSAASTwoXZXhlY3V0ZV9hdHRyaWJ1dGVfd3JpdGUYCSABKAsyLC5rdXNpbnRhLmlvdC53ZWJydGMudjEuQXR0cmlidXRlV3JpdGVSZXF1ZXN0SABCCQoHcGF5bG9hZEoECAQQBUICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity, file_kusinta_iot_device_v1_device, file_kusinta_iot_device_v1_device_event, file_kusinta_iot_device_v1_property_update, file_kusinta_iot_webrtc_v1_command]);
 
 /**
  * Describes the message kusinta.iot.connector.v1.ConnectorInfo.
@@ -80,23 +81,23 @@ export const GatewayErrorSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 8);
 
 /**
- * Describes the message kusinta.iot.connector.v1.CommandResult.
- * Use `create(CommandResultSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.ConnectorCommandResult.
+ * Use `create(ConnectorCommandResultSchema)` to create a new message.
  */
-export const CommandResultSchema = /*@__PURE__*/
+export const ConnectorCommandResultSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 9);
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectRequest.
- * Use `create(ConnectRequestSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionRequest.
+ * Use `create(SessionRequestSchema)` to create a new message.
  */
-export const ConnectRequestSchema = /*@__PURE__*/
+export const SessionRequestSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 10);
 
 /**
- * Describes the message kusinta.iot.connector.v1.ConnectResponse.
- * Use `create(ConnectResponseSchema)` to create a new message.
+ * Describes the message kusinta.iot.connector.v1.SessionResponse.
+ * Use `create(SessionResponseSchema)` to create a new message.
  */
-export const ConnectResponseSchema = /*@__PURE__*/
+export const SessionResponseSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_connector_v1_connector, 11);
 

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

@@ -3,7 +3,7 @@
 /* eslint-disable */
 
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { ConnectRequestSchema, ConnectResponseSchema } from "./connector_pb.js";
+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

@@ -9,7 +9,7 @@ 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.