@kusinta/iot-schema 0.1.0-beta.2 → 0.1.0-beta.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kusinta AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @kusinta/iot-schema
+
+Generated protobuf types for the Kusinta building automation platform, built with [protobuf-es](https://github.com/bufbuild/protobuf-es).
+
+## Install
+
+```bash
+npm install @kusinta/iot-schema
+```
+
+Requires `@bufbuild/protobuf` as a peer dependency (installed automatically).
+
+## Requirements
+
+- Node.js 18+ (ESM — `"type": "module"`)
+- `@bufbuild/protobuf` ^2.x (installed automatically as a peer dependency)
+
+Works in raw Node.js ESM projects without a bundler.
+
+## Usage
+
+```javascript
+import { create, toBinary, fromBinary } from '@bufbuild/protobuf'
+import { DeviceSchema } from '@kusinta/iot-schema/device'
+import { SpaceSchema } from '@kusinta/iot-schema/space'
+
+const device = create(DeviceSchema, { ... })
+const bytes = toBinary(DeviceSchema, device)
+const decoded = fromBinary(DeviceSchema, bytes)
+```
+
+## Available imports
+
+| Import | Contents |
+|---|---|
+| `@kusinta/iot-schema/common` | Shared enums and types |
+| `@kusinta/iot-schema/identity` | Strongly-typed ID wrappers |
+| `@kusinta/iot-schema/device` | Device, DeviceDescriptor |
+| `@kusinta/iot-schema/device/descriptor` | DeviceDescriptor |
+| `@kusinta/iot-schema/device/properties` | Per-device-type property messages |
+| `@kusinta/iot-schema/device/property-update` | PropertyUpdate |
+| `@kusinta/iot-schema/space` | Space (building hierarchy) |
+| `@kusinta/iot-schema/access` | DeviceAcl, EffectivePermissions |
+| `@kusinta/iot-schema/access/roles` | Roles, PermissionAction |
+| `@kusinta/iot-schema/connector` | Connector ↔ gateway messages |
+| `@kusinta/iot-schema/connector/service` | gRPC service definition |
+| `@kusinta/iot-schema/webrtc` | WebRTC envelope messages |
+
+Source: [github.com/Martwall/kusinta-iot-schema](https://github.com/Martwall/kusinta-iot-schema)

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.20",
   "type": "module",
+  "license": "MIT",
   "files": ["src"],
   "scripts": {
     "test": "vitest run",
@@ -13,13 +14,19 @@
     "./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",
     "./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",
+    "./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

@@ -1,11 +1,11 @@
-// @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/access/v1/acl.proto (package kusinta.iot.access.v1, syntax proto3)
 /* eslint-disable */
 
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
-import type { DeviceId, GatewayId, UserId } from "../../identity/v1/identity_pb";
-import type { PermissionAction, Role } from "./roles_pb";
+import type { DeviceId, GatewayId, UserId } from "../../identity/v1/identity_pb.js";
+import type { PermissionAction, Role } from "./roles_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 
 /**

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

@@ -1,11 +1,11 @@
-// @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/access/v1/acl.proto (package kusinta.iot.access.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_identity_v1_identity } from "../../identity/v1/identity_pb";
-import { file_kusinta_iot_access_v1_roles } from "./roles_pb";
+import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+import { file_kusinta_iot_access_v1_roles } from "./roles_pb.js";
 
 /**
  * Describes the file kusinta/iot/access/v1/acl.proto.

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

@@ -1,4 +1,4 @@
-// @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/access/v1/roles.proto (package kusinta.iot.access.v1, syntax proto3)
 /* eslint-disable */
 

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

@@ -1,4 +1,4 @@
-// @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/access/v1/roles.proto (package kusinta.iot.access.v1, syntax proto3)
 /* eslint-disable */
 

package/src/kusinta/iot/common/v1/types_pb.d.ts

@@ -1,4 +1,4 @@
-// @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/common/v1/types.proto (package kusinta.iot.common.v1, syntax proto3)
 /* eslint-disable */
 

package/src/kusinta/iot/common/v1/types_pb.js

@@ -1,4 +1,4 @@
-// @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/common/v1/types.proto (package kusinta.iot.common.v1, syntax proto3)
 /* eslint-disable */
 

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

@@ -1,14 +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.proto (package kusinta.iot.connector.v1, syntax proto3)
 /* eslint-disable */
 
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
-import type { ConnectorId, DeviceId, GatewayId } from "../../identity/v1/identity_pb";
-import type { ConnectorTransport } from "../../common/v1/types_pb";
-import type { DeviceDescriptor } from "../../device/v1/descriptor_pb";
+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 { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { PropertyUpdateBatch } from "../../device/v1/property_update_pb";
+import type { PropertyUpdateBatch } from "../../device/v1/property_update_pb.js";
+import type { DeviceCommand } from "../../webrtc/v1/command_pb.js";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector.proto.
@@ -215,9 +216,9 @@ export declare type GatewayError = Message<"kusinta.iot.connector.v1.GatewayErro
 export declare const GatewayErrorSchema: GenMessage<GatewayError>;
 
 /**
- * @generated from message kusinta.iot.connector.v1.CommandResult
+ * @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;
    */
@@ -240,15 +241,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;
    */
@@ -260,7 +261,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: {
     /**
@@ -288,9 +289,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";
   } | {
     /**
@@ -302,15 +303,15 @@ export declare type ConnectRequest = Message<"kusinta.iot.connector.v1.ConnectRe
 };
 
 /**
- * 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;
    */
@@ -322,7 +323,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: {
     /**
@@ -348,12 +349,18 @@ export declare type ConnectResponse = Message<"kusinta.iot.connector.v1.ConnectR
      */
     value: GatewayError;
     case: "error";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.webrtc.v1.DeviceCommand execute_command = 8;
+     */
+    value: DeviceCommand;
+    case: "executeCommand";
   } | { 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

@@ -1,19 +1,20 @@
-// @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.proto (package kusinta.iot.connector.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_device_v1_descriptor } from "../../device/v1/descriptor_pb";
-import { file_kusinta_iot_device_v1_property_update } from "../../device/v1/property_update_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_device_v1_descriptor } from "../../device/v1/descriptor_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";
 
 /**
  * Describes the file kusinta/iot/connector/v1/connector.proto.
  */
 export const file_kusinta_iot_connector_v1_connector = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIosBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEj4KDWtub3duX2RldmljZXMYAiADKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJoCgxIYW5kc2hha2VBY2sSEAoIYWNjZXB0ZWQYASABKAgSDgoGcmVhc29uGAIgASgJEjYKCmdhdGV3YXlfaWQYAyABKAsyIi5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5HYXRld2F5SWQiUQoSRGV2aWNlQW5ub3VuY2VtZW50EjsKCmRlc2NyaXB0b3IYASABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKY29tbWFuZF9pZBgDIAEoCSKdAQoNQ29tbWFuZFJlc3VsdBISCgpjb21tYW5kX2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAi8AMKDkNvbm5lY3RSZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASQQoOY29tbWFuZF9yZXN1bHQYByABKAsyJy5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIAEIJCgdwYXlsb2FkItsCCg9Db25uZWN0UmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/Cg1oYW5kc2hha2VfYWNrGAMgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkhhbmRzaGFrZUFja0gAEj4KCXN1YnNjcmliZRgFIAEoCzIpLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5TdWJzY3JpYmVEZXZpY2VIABJCCgt1bnN1YnNjcmliZRgGIAEoCzIrLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5VbnN1YnNjcmliZURldmljZUgAEjcKBWVycm9yGAcgASgLMiYua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkdhdGV3YXlFcnJvckgAQgkKB3BheWxvYWRCAkgBYgZwcm90bzM", [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]);
+  fileDesc("CihrdXNpbnRhL2lvdC9jb25uZWN0b3IvdjEvY29ubmVjdG9yLnByb3RvEhhrdXNpbnRhLmlvdC5jb25uZWN0b3IudjEi5QEKDUNvbm5lY3RvckluZm8SOgoMY29ubmVjdG9yX2lkGAEgASgLMiQua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuQ29ubmVjdG9ySWQSFAoMZGlzcGxheV9uYW1lGAIgASgJEg8KB3ZlcnNpb24YAyABKAkSPAoJdHJhbnNwb3J0GAQgASgOMikua3VzaW50YS5pb3QuY29tbW9uLnYxLkNvbm5lY3RvclRyYW5zcG9ydBIQCghlbmRwb2ludBgFIAEoCRIhChlzdXBwb3J0ZWRfZGV2aWNlX3R5cGVfaWRzGAYgAygNIosBChJDb25uZWN0b3JIYW5kc2hha2USNQoEaW5mbxgBIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5Db25uZWN0b3JJbmZvEj4KDWtub3duX2RldmljZXMYAiADKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJoCgxIYW5kc2hha2VBY2sSEAoIYWNjZXB0ZWQYASABKAgSDgoGcmVhc29uGAIgASgJEjYKCmdhdGV3YXlfaWQYAyABKAsyIi5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5HYXRld2F5SWQiUQoSRGV2aWNlQW5ub3VuY2VtZW50EjsKCmRlc2NyaXB0b3IYASABKAsyJy5rdXNpbnRhLmlvdC5kZXZpY2UudjEuRGV2aWNlRGVzY3JpcHRvciJVCg1EZXZpY2VSZW1vdmFsEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEg4KBnJlYXNvbhgCIAEoCSILCglIZWFydEJlYXQiRwoPU3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkkKEVVuc3Vic2NyaWJlRGV2aWNlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkIkEKDEdhdGV3YXlFcnJvchIMCgRjb2RlGAEgASgJEg8KB21lc3NhZ2UYAiABKAkSEgoKY29tbWFuZF9pZBgDIAEoCSKmAQoWQ29ubmVjdG9yQ29tbWFuZFJlc3VsdBISCgpjb21tYW5kX2lkGAEgASgJEg8KB3N1Y2Nlc3MYAiABKAgSNQoFZXJyb3IYAyABKAsyJi5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuR2F0ZXdheUVycm9yEjAKDGNvbXBsZXRlZF9hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAi+QMKDlNlc3Npb25SZXF1ZXN0EhIKCm1lc3NhZ2VfaWQYASABKAkSKwoHc2VudF9hdBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASQQoJaGFuZHNoYWtlGAMgASgLMiwua3VzaW50YS5pb3QuY29ubmVjdG9yLnYxLkNvbm5lY3RvckhhbmRzaGFrZUgAEkUKD3Byb3BlcnR5X3VwZGF0ZRgEIAEoCzIqLmt1c2ludGEuaW90LmRldmljZS52MS5Qcm9wZXJ0eVVwZGF0ZUJhdGNoSAASSAoQZGV2aWNlX2Fubm91bmNlZBgFIAEoCzIsLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VBbm5vdW5jZW1lbnRIABJBCg5kZXZpY2VfcmVtb3ZlZBgGIAEoCzInLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5EZXZpY2VSZW1vdmFsSAASSgoOY29tbWFuZF9yZXN1bHQYByABKAsyMC5rdXNpbnRhLmlvdC5jb25uZWN0b3IudjEuQ29ubmVjdG9yQ29tbWFuZFJlc3VsdEgAEjgKCWhlYXJ0YmVhdBgIIAEoCzIjLmt1c2ludGEuaW90LmNvbm5lY3Rvci52MS5IZWFydEJlYXRIAEIJCgdwYXlsb2FkIqIDCg9TZXNzaW9uUmVzcG9uc2USEgoKbWVzc2FnZV9pZBgBIAEoCRIrCgdzZW50X2F0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI/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]);
 
 /**
  * Describes the message kusinta.iot.connector.v1.ConnectorInfo.
@@ -79,23 +80,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

@@ -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/descriptor_pb.d.ts

@@ -1,11 +1,11 @@
-// @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";
 
 /**

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

@@ -1,11 +1,11 @@
-// @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";
 
 /**
  * Describes the file kusinta/iot/device/v1/descriptor.proto.

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

@@ -1,12 +1,12 @@
-// @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/device.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 { DeviceDescriptor } from "./descriptor_pb";
-import type { ColorTemperatureLightProperties, ContactSensorProperties, DimmableLightProperties, DoorLockProperties, EnergySensorProperties, HumiditySensorProperties, OccupancySensorProperties, OnOffLightProperties, PressureSensorProperties, TemperatureSensorProperties, ThermostatProperties, WindowCoveringProperties } from "./properties_pb";
-import type { HomematicVendorExtension } from "../../vendor/homematic/v1/homematic_pb";
+import type { DeviceDescriptor } from "./descriptor_pb.js";
+import type { ColorTemperatureLightProperties, ContactSensorProperties, DimmableLightProperties, DoorLockProperties, EnergySensorProperties, HumiditySensorProperties, OccupancySensorProperties, OnOffLightProperties, PressureSensorProperties, TemperatureSensorProperties, ThermostatProperties, WindowCoveringProperties } from "./properties_pb.js";
+import type { HomematicVendorExtension } from "../../vendor/homematic/v1/homematic_pb.js";
 import type { Timestamp } from "@bufbuild/protobuf/wkt";
 
 /**
@@ -19,6 +19,24 @@ export declare const file_kusinta_iot_device_v1_device: GenFile;
  * Field number convention: 1 = descriptor, 2-49 = standard Matter device types,
  * 50-99 = vendor extensions, 20+ = timestamps.
  *
+ * Selecting the properties case
+ *
+ * Each non-vendor case's message type declares the Matter device type it models in
+ * (matter_device_type), so the mapping from DeviceDescriptor.matter_device_type_id to a
+ * case is read from the descriptor rather than hard-coded. See matter_options.proto, and
+ * property_update.proto for the full resolution rule.
+ *
+ * matter_device_type_id stays a bare uint32: a connector must be able to report a device
+ * type this schema does not model. Such a device is legitimate — it exists, it belongs in
+ * a device list, it simply carries no typed properties. A consumer that cannot match the
+ * device type leaves the properties oneof unset and keeps the Device; it MUST NOT drop the
+ * device or substitute a nearby case. An unset oneof therefore means either "not modelled"
+ * or "modelled but nothing reported yet", which are indistinguishable here on purpose;
+ * distinguish them by re-resolving matter_device_type_id if you need to.
+ *
+ * Adding a case: annotate the new *Properties message with its (matter_device_type). A case
+ * without one resolves for nobody.
+ *
  * @generated from message kusinta.iot.device.v1.Device
  */
 export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
@@ -113,11 +131,25 @@ export declare type Device = Message<"kusinta.iot.device.v1.Device"> & {
   } | { case: undefined; value?: undefined };
 
   /**
+   * When the gateway last had evidence this device exists and is reachable — the
+   * most recent PropertyUpdate, announcement, or command result concerning it.
+   * Gateway-observed, not connector-reported: no message on either leg carries a
+   * per-device liveness timestamp, so this is as precise as the device's own report
+   * interval. A device that reports every 15 minutes looks stale for 15 minutes.
+   *
+   * Survives a connector reconnect. Losing the route to a device is not evidence the
+   * device is gone, so last_seen keeps its value; only fresh evidence advances it.
+   *
+   * Advisory, for showing staleness in a UI. It is not a removal signal — that is
+   * webrtc.v1.DeviceRemoved, sent only when a connector reports the device gone.
+   *
    * @generated from field: google.protobuf.Timestamp last_seen = 20;
    */
   lastSeen?: Timestamp | undefined;
 
   /**
+   * When any field of this Device last changed value.
+   *
    * @generated from field: google.protobuf.Timestamp last_updated = 21;
    */
   lastUpdated?: Timestamp | undefined;

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

@@ -1,12 +1,12 @@
-// @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/device.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_device_v1_descriptor } from "./descriptor_pb";
-import { file_kusinta_iot_device_v1_properties } from "./properties_pb";
-import { file_kusinta_iot_vendor_homematic_v1_homematic } from "../../vendor/homematic/v1/homematic_pb";
+import { file_kusinta_iot_device_v1_descriptor } from "./descriptor_pb.js";
+import { file_kusinta_iot_device_v1_properties } from "./properties_pb.js";
+import { file_kusinta_iot_vendor_homematic_v1_homematic } from "../../vendor/homematic/v1/homematic_pb.js";
 
 /**
  * Describes the file kusinta/iot/device/v1/device.proto.

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

@@ -0,0 +1,46 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/matter_options.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenExtension, GenFile } from "@bufbuild/protobuf/codegenv2";
+import type { FieldOptions, MessageOptions } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file kusinta/iot/device/v1/matter_options.proto.
+ */
+export declare const file_kusinta_iot_device_v1_matter_options: GenFile;
+
+/**
+ * The Matter cluster this attribute belongs to, e.g. 0x0201 for Thermostat.
+ *
+ * Required alongside matter_attribute because a properties message may span
+ * clusters: DimmableLightProperties.on_off is On/Off (0x0006) while its
+ * current_level is Level Control (0x0008). Matches PropertyUpdate.cluster_id_hex
+ * parsed as a hex integer.
+ *
+ * @generated from extension: uint32 matter_cluster_id = 50001;
+ */
+export declare const matter_cluster_id: GenExtension<FieldOptions, number>;
+
+/**
+ * The Matter attribute name in the spec's own PascalCase, e.g.
+ * "PIROccupiedToUnoccupiedDelay". This is the authoritative spelling; the proto
+ * field name is not derived from it and must not be assumed to be. Matches
+ * PropertyUpdate.attribute_name byte for byte.
+ *
+ * @generated from extension: string matter_attribute = 50002;
+ */
+export declare const matter_attribute: GenExtension<FieldOptions, string>;
+
+/**
+ * The Matter device type IDs this properties message models, e.g. 0x0301 for
+ * Thermostat. Repeated because one shape of properties can serve several device
+ * types; empty on vendor extension messages, which have no Matter device type.
+ *
+ * A device type appears on at most one properties message, so the mapping from
+ * DeviceDescriptor.matter_device_type_id to a Device.properties case is a function.
+ *
+ * @generated from extension: repeated uint32 matter_device_type = 50003;
+ */
+export declare const matter_device_type: GenExtension<MessageOptions, number[]>;
+

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

@@ -0,0 +1,50 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/device/v1/matter_options.proto (package kusinta.iot.device.v1, syntax proto3)
+/* eslint-disable */
+
+import { extDesc, fileDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file kusinta/iot/device/v1/matter_options.proto.
+ */
+export const file_kusinta_iot_device_v1_matter_options = /*@__PURE__*/
+  fileDesc("CiprdXNpbnRhL2lvdC9kZXZpY2UvdjEvbWF0dGVyX29wdGlvbnMucHJvdG8SFWt1c2ludGEuaW90LmRldmljZS52MTpLChFtYXR0ZXJfY2x1c3Rlcl9pZBIdLmdvb2dsZS5wcm90b2J1Zi5GaWVsZE9wdGlvbnMY0YYDIAEoDVIPbWF0dGVyQ2x1c3RlcklkOkoKEG1hdHRlcl9hdHRyaWJ1dGUSHS5nb29nbGUucHJvdG9idWYuRmllbGRPcHRpb25zGNKGAyABKAlSD21hdHRlckF0dHJpYnV0ZTpPChJtYXR0ZXJfZGV2aWNlX3R5cGUSHy5nb29nbGUucHJvdG9idWYuTWVzc2FnZU9wdGlvbnMY04YDIAMoDVIQbWF0dGVyRGV2aWNlVHlwZUICSAFiBnByb3RvMw", [file_google_protobuf_descriptor]);
+
+/**
+ * The Matter cluster this attribute belongs to, e.g. 0x0201 for Thermostat.
+ *
+ * Required alongside matter_attribute because a properties message may span
+ * clusters: DimmableLightProperties.on_off is On/Off (0x0006) while its
+ * current_level is Level Control (0x0008). Matches PropertyUpdate.cluster_id_hex
+ * parsed as a hex integer.
+ *
+ * @generated from extension: uint32 matter_cluster_id = 50001;
+ */
+export const matter_cluster_id = /*@__PURE__*/
+  extDesc(file_kusinta_iot_device_v1_matter_options, 0);
+
+/**
+ * The Matter attribute name in the spec's own PascalCase, e.g.
+ * "PIROccupiedToUnoccupiedDelay". This is the authoritative spelling; the proto
+ * field name is not derived from it and must not be assumed to be. Matches
+ * PropertyUpdate.attribute_name byte for byte.
+ *
+ * @generated from extension: string matter_attribute = 50002;
+ */
+export const matter_attribute = /*@__PURE__*/
+  extDesc(file_kusinta_iot_device_v1_matter_options, 1);
+
+/**
+ * The Matter device type IDs this properties message models, e.g. 0x0301 for
+ * Thermostat. Repeated because one shape of properties can serve several device
+ * types; empty on vendor extension messages, which have no Matter device type.
+ *
+ * A device type appears on at most one properties message, so the mapping from
+ * DeviceDescriptor.matter_device_type_id to a Device.properties case is a function.
+ *
+ * @generated from extension: repeated uint32 matter_device_type = 50003;
+ */
+export const matter_device_type = /*@__PURE__*/
+  extDesc(file_kusinta_iot_device_v1_matter_options, 2);
+