@kusinta/iot-schema 0.2.0-beta.11 → 0.2.0-beta.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.2.0-beta.11",
+  "version": "0.2.0-beta.13",
   "type": "module",
   "license": "MIT",
   "files": ["src"],

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

@@ -192,6 +192,22 @@ export enum PairingError {
    * @generated from enum value: PAIRING_ERROR_INTERNAL = 7;
    */
   INTERNAL = 7,
+
+  /**
+   * The request named no connector. Pairing always targets exactly one connector,
+   * chosen from the connector enumeration; an untargeted "pair anything" is refused
+   * rather than fanned out across every hub. Permanent for the request as sent —
+   * naming a connector and asking again is the fix, retrying identically is not —
+   * which is why this is not CONNECTOR_UNAVAILABLE, whose retry is reasonable.
+   *
+   * The gateway is the enforcer: connector_id is a message field, so proto cannot
+   * mark it required, and the check lives where the fan-out used to. A client whose
+   * schema predates this reads it as UNSPECIFIED and offers a retry, which is
+   * harmless — an app built against the enumeration always names a connector anyway.
+   *
+   * @generated from enum value: PAIRING_ERROR_CONNECTOR_REQUIRED = 8;
+   */
+  CONNECTOR_REQUIRED = 8,
 }
 
 /**

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

@@ -8,7 +8,7 @@ import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/code
  * Describes the file kusinta/iot/common/v1/pairing.proto.
  */
 export const file_kusinta_iot_common_v1_pairing = /*@__PURE__*/
-  fileDesc("CiNrdXNpbnRhL2lvdC9jb21tb24vdjEvcGFpcmluZy5wcm90bxIVa3VzaW50YS5pb3QuY29tbW9uLnYxIlgKElBhaXJpbmdFcnJvckRldGFpbBIxCgRjb2RlGAEgASgOMiMua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvchIPCgdtZXNzYWdlGAIgASgJIoIBCg1QYWlyaW5nV2luZG93Eh0KEGR1cmF0aW9uX3NlY29uZHMYASABKA1IAIgBARITCgtkZXZpY2VfaGludBgCIAEoCRIYCgttYXhfZGV2aWNlcxgDIAEoDUgBiAEBQhMKEV9kdXJhdGlvbl9zZWNvbmRzQg4KDF9tYXhfZGV2aWNlcyqiAgoMUGFpcmluZ0Vycm9yEh0KGVBBSVJJTkdfRVJST1JfVU5TUEVDSUZJRUQQABIeChpQQUlSSU5HX0VSUk9SX05PVF9FTlRJVExFRBABEiUKIVBBSVJJTkdfRVJST1JfQUxSRUFEWV9JTl9QUk9HUkVTUxACEicKI1BBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1VOQVZBSUxBQkxFEAMSJAogUEFJUklOR19FUlJPUl9OT19ERVZJQ0VfQVBQRUFSRUQQBBIhCh1QQUlSSU5HX0VSUk9SX0RFVklDRV9VTlVTQUJMRRAFEh4KGlBBSVJJTkdfRVJST1JfV1JPTkdfREVWSUNFEAYSGgoWUEFJUklOR19FUlJPUl9JTlRFUk5BTBAHQgJIAWIGcHJvdG8z");
+  fileDesc("CiNrdXNpbnRhL2lvdC9jb21tb24vdjEvcGFpcmluZy5wcm90bxIVa3VzaW50YS5pb3QuY29tbW9uLnYxIlgKElBhaXJpbmdFcnJvckRldGFpbBIxCgRjb2RlGAEgASgOMiMua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvchIPCgdtZXNzYWdlGAIgASgJIoIBCg1QYWlyaW5nV2luZG93Eh0KEGR1cmF0aW9uX3NlY29uZHMYASABKA1IAIgBARITCgtkZXZpY2VfaGludBgCIAEoCRIYCgttYXhfZGV2aWNlcxgDIAEoDUgBiAEBQhMKEV9kdXJhdGlvbl9zZWNvbmRzQg4KDF9tYXhfZGV2aWNlcyrIAgoMUGFpcmluZ0Vycm9yEh0KGVBBSVJJTkdfRVJST1JfVU5TUEVDSUZJRUQQABIeChpQQUlSSU5HX0VSUk9SX05PVF9FTlRJVExFRBABEiUKIVBBSVJJTkdfRVJST1JfQUxSRUFEWV9JTl9QUk9HUkVTUxACEicKI1BBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1VOQVZBSUxBQkxFEAMSJAogUEFJUklOR19FUlJPUl9OT19ERVZJQ0VfQVBQRUFSRUQQBBIhCh1QQUlSSU5HX0VSUk9SX0RFVklDRV9VTlVTQUJMRRAFEh4KGlBBSVJJTkdfRVJST1JfV1JPTkdfREVWSUNFEAYSGgoWUEFJUklOR19FUlJPUl9JTlRFUk5BTBAHEiQKIFBBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1JFUVVJUkVEEAhCAkgBYgZwcm90bzM");
 
 /**
  * Describes the message kusinta.iot.common.v1.PairingErrorDetail.

package/src/kusinta/iot/signaling/v1/signaling_pb.d.ts

@@ -244,6 +244,10 @@ export declare type UserConnectRequest = Message<"kusinta.iot.signaling.v1.UserC
   sessionId: string;
 
   /**
+   * A payload added here, the handshake aside, belongs in UserSendRequest too:
+   * the half-duplex form of this leg carries the same upstream messages, and
+   * nothing fails if one of them is only added to one of the two.
+   *
    * @generated from oneof kusinta.iot.signaling.v1.UserConnectRequest.payload
    */
   payload: {
@@ -318,3 +322,118 @@ export declare type UserConnectResponse = Message<"kusinta.iot.signaling.v1.User
  */
 export declare const UserConnectResponseSchema: GenMessage<UserConnectResponse>;
 
+/**
+ * The app leg of the protocol exists twice. UserConnect is one bidi stream, and
+ * is what a client uses when its transport can stream a request body. A client
+ * whose transport cannot — a browser, whose fetch API has no full-duplex request
+ * stream — uses UserListen and UserSend instead. Both forms carry the same
+ * messages and are served by the same relay: once a session is live, how it was
+ * opened is not observable.
+ *
+ * Opens the downstream half of a half-duplex app session, and carries the
+ * handshake that is the first frame of the bidi form. Field numbers are those of
+ * the equivalent UserConnectRequest, so the two cannot be confused on the wire.
+ *
+ * @generated from message kusinta.iot.signaling.v1.UserListenRequest
+ */
+export declare type UserListenRequest = Message<"kusinta.iot.signaling.v1.UserListenRequest"> & {
+  /**
+   * @generated from field: kusinta.iot.signaling.v1.UserHandshake handshake = 1;
+   */
+  handshake?: UserHandshake | undefined;
+
+  /**
+   * This client's session: opaque, minted by the client, stable across
+   * reconnects, never a credential, and required. See the contract above.
+   *
+   * @generated from field: string session_id = 4;
+   */
+  sessionId: string;
+};
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserListenRequest.
+ * Use `create(UserListenRequestSchema)` to create a new message.
+ */
+export declare const UserListenRequestSchema: GenMessage<UserListenRequest>;
+
+/**
+ * One message of the downstream half. Wraps the response the bidi form delivers
+ * directly, rather than restating its payloads: a response message is not shared
+ * between two rpcs, and a second copy of the oneof would be free to drift from
+ * the first.
+ *
+ * @generated from message kusinta.iot.signaling.v1.UserListenResponse
+ */
+export declare type UserListenResponse = Message<"kusinta.iot.signaling.v1.UserListenResponse"> & {
+  /**
+   * @generated from field: kusinta.iot.signaling.v1.UserConnectResponse response = 1;
+   */
+  response?: UserConnectResponse | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserListenResponse.
+ * Use `create(UserListenResponseSchema)` to create a new message.
+ */
+export declare const UserListenResponseSchema: GenMessage<UserListenResponse>;
+
+/**
+ * One upstream message of a half-duplex app session, delivered by its own call.
+ *
+ * The session must already be open, which is what makes ordering the caller's
+ * job: the handshake is acknowledged on the UserListen stream, and a UserSend
+ * issued before that acknowledgement names a session the relay does not hold
+ * yet. It is refused, not queued. Two sends racing each other can also arrive
+ * out of order, so a caller that must preserve order — an offer before the
+ * candidates that belong to it — issues them one at a time.
+ *
+ * @generated from message kusinta.iot.signaling.v1.UserSendRequest
+ */
+export declare type UserSendRequest = Message<"kusinta.iot.signaling.v1.UserSendRequest"> & {
+  /**
+   * The session to deliver into. See the contract above.
+   *
+   * @generated from field: string session_id = 4;
+   */
+  sessionId: string;
+
+  /**
+   * @generated from oneof kusinta.iot.signaling.v1.UserSendRequest.payload
+   */
+  payload: {
+    /**
+     * @generated from field: kusinta.iot.signaling.v1.SdpOffer offer = 2;
+     */
+    value: SdpOffer;
+    case: "offer";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.signaling.v1.IceCandidate ice_candidate = 3;
+     */
+    value: IceCandidate;
+    case: "iceCandidate";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserSendRequest.
+ * Use `create(UserSendRequestSchema)` to create a new message.
+ */
+export declare const UserSendRequestSchema: GenMessage<UserSendRequest>;
+
+/**
+ * Empty. Delivery is acknowledged by the call succeeding; a message that could
+ * not be routed fails the call instead.
+ *
+ * @generated from message kusinta.iot.signaling.v1.UserSendResponse
+ */
+export declare type UserSendResponse = Message<"kusinta.iot.signaling.v1.UserSendResponse"> & {
+};
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserSendResponse.
+ * Use `create(UserSendResponseSchema)` to create a new message.
+ */
+export declare const UserSendResponseSchema: GenMessage<UserSendResponse>;
+

package/src/kusinta/iot/signaling/v1/signaling_pb.js

@@ -9,7 +9,7 @@ import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identit
  * Describes the file kusinta/iot/signaling/v1/signaling.proto.
  */
 export const file_kusinta_iot_signaling_v1_signaling = /*@__PURE__*/
-  fileDesc("CihrdXNpbnRhL2lvdC9zaWduYWxpbmcvdjEvc2lnbmFsaW5nLnByb3RvEhhrdXNpbnRhLmlvdC5zaWduYWxpbmcudjEiFwoIU2RwT2ZmZXISCwoDc2RwGAEgASgJIhgKCVNkcEFuc3dlchILCgNzZHAYASABKAkiSwoMSWNlQ2FuZGlkYXRlEhEKCWNhbmRpZGF0ZRgBIAEoCRIPCgdzZHBfbWlkGAIgASgJEhcKD3NkcF9tbGluZV9pbmRleBgDIAEoBSILCglIZWFydEJlYXQiTgoNVXNlckhhbmRzaGFrZRI9ChF0YXJnZXRfZ2F0ZXdheV9pZBgBIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCI0ChBVc2VySGFuZHNoYWtlQWNrEhAKCGFjY2VwdGVkGAEgASgIEg4KBnJlYXNvbhgCIAEoCSKhAgoVR2F0ZXdheUNvbm5lY3RSZXF1ZXN0EjcKDnRhcmdldF91c2VyX2lkGAEgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEhIKCnNlc3Npb25faWQYBSABKAkSNQoGYW5zd2VyGAIgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcEFuc3dlckgAEj8KDWljZV9jYW5kaWRhdGUYAyABKAsyJi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuSWNlQ2FuZGlkYXRlSAASOAoJaGVhcnRiZWF0GAQgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkhlYXJ0QmVhdEgAQgkKB3BheWxvYWQi5AEKFkdhdGV3YXlDb25uZWN0UmVzcG9uc2USNQoMZnJvbV91c2VyX2lkGAEgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEhIKCnNlc3Npb25faWQYBCABKAkSMwoFb2ZmZXIYAiABKAsyIi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwT2ZmZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAQgkKB3BheWxvYWQi5wEKElVzZXJDb25uZWN0UmVxdWVzdBISCgpzZXNzaW9uX2lkGAQgASgJEjwKCWhhbmRzaGFrZRgBIAEoCzInLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VySGFuZHNoYWtlSAASMwoFb2ZmZXIYAiABKAsyIi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwT2ZmZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAQgkKB3BheWxvYWQi8QEKE1VzZXJDb25uZWN0UmVzcG9uc2USEgoKc2Vzc2lvbl9pZBgEIAEoCRJDCg1oYW5kc2hha2VfYWNrGAEgASgLMioua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJIYW5kc2hha2VBY2tIABI1CgZhbnN3ZXIYAiABKAsyIy5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwQW5zd2VySAASPwoNaWNlX2NhbmRpZGF0ZRgDIAEoCzImLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5JY2VDYW5kaWRhdGVIAEIJCgdwYXlsb2FkQgJIAWIGcHJvdG8z", [file_kusinta_iot_identity_v1_identity]);
+  fileDesc("CihrdXNpbnRhL2lvdC9zaWduYWxpbmcvdjEvc2lnbmFsaW5nLnByb3RvEhhrdXNpbnRhLmlvdC5zaWduYWxpbmcudjEiFwoIU2RwT2ZmZXISCwoDc2RwGAEgASgJIhgKCVNkcEFuc3dlchILCgNzZHAYASABKAkiSwoMSWNlQ2FuZGlkYXRlEhEKCWNhbmRpZGF0ZRgBIAEoCRIPCgdzZHBfbWlkGAIgASgJEhcKD3NkcF9tbGluZV9pbmRleBgDIAEoBSILCglIZWFydEJlYXQiTgoNVXNlckhhbmRzaGFrZRI9ChF0YXJnZXRfZ2F0ZXdheV9pZBgBIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCI0ChBVc2VySGFuZHNoYWtlQWNrEhAKCGFjY2VwdGVkGAEgASgIEg4KBnJlYXNvbhgCIAEoCSKhAgoVR2F0ZXdheUNvbm5lY3RSZXF1ZXN0EjcKDnRhcmdldF91c2VyX2lkGAEgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEhIKCnNlc3Npb25faWQYBSABKAkSNQoGYW5zd2VyGAIgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcEFuc3dlckgAEj8KDWljZV9jYW5kaWRhdGUYAyABKAsyJi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuSWNlQ2FuZGlkYXRlSAASOAoJaGVhcnRiZWF0GAQgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkhlYXJ0QmVhdEgAQgkKB3BheWxvYWQi5AEKFkdhdGV3YXlDb25uZWN0UmVzcG9uc2USNQoMZnJvbV91c2VyX2lkGAEgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEhIKCnNlc3Npb25faWQYBCABKAkSMwoFb2ZmZXIYAiABKAsyIi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwT2ZmZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAQgkKB3BheWxvYWQi5wEKElVzZXJDb25uZWN0UmVxdWVzdBISCgpzZXNzaW9uX2lkGAQgASgJEjwKCWhhbmRzaGFrZRgBIAEoCzInLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VySGFuZHNoYWtlSAASMwoFb2ZmZXIYAiABKAsyIi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwT2ZmZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAQgkKB3BheWxvYWQi8QEKE1VzZXJDb25uZWN0UmVzcG9uc2USEgoKc2Vzc2lvbl9pZBgEIAEoCRJDCg1oYW5kc2hha2VfYWNrGAEgASgLMioua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJIYW5kc2hha2VBY2tIABI1CgZhbnN3ZXIYAiABKAsyIy5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwQW5zd2VySAASPwoNaWNlX2NhbmRpZGF0ZRgDIAEoCzImLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5JY2VDYW5kaWRhdGVIAEIJCgdwYXlsb2FkIm8KEVVzZXJMaXN0ZW5SZXF1ZXN0EjoKCWhhbmRzaGFrZRgBIAEoCzInLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VySGFuZHNoYWtlEhIKCnNlc3Npb25faWQYBCABKAlKBAgCEANKBAgDEAQiVQoSVXNlckxpc3RlblJlc3BvbnNlEj8KCHJlc3BvbnNlGAEgASgLMi0ua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJDb25uZWN0UmVzcG9uc2UitwEKD1VzZXJTZW5kUmVxdWVzdBISCgpzZXNzaW9uX2lkGAQgASgJEjMKBW9mZmVyGAIgASgLMiIua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcE9mZmVySAASPwoNaWNlX2NhbmRpZGF0ZRgDIAEoCzImLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5JY2VDYW5kaWRhdGVIAEIJCgdwYXlsb2FkSgQIARACUgloYW5kc2hha2UiEgoQVXNlclNlbmRSZXNwb25zZUICSAFiBnByb3RvMw", [file_kusinta_iot_identity_v1_identity]);
 
 /**
  * Describes the message kusinta.iot.signaling.v1.SdpOffer.
@@ -81,3 +81,31 @@ export const UserConnectRequestSchema = /*@__PURE__*/
 export const UserConnectResponseSchema = /*@__PURE__*/
   messageDesc(file_kusinta_iot_signaling_v1_signaling, 9);
 
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserListenRequest.
+ * Use `create(UserListenRequestSchema)` to create a new message.
+ */
+export const UserListenRequestSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_signaling_v1_signaling, 10);
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserListenResponse.
+ * Use `create(UserListenResponseSchema)` to create a new message.
+ */
+export const UserListenResponseSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_signaling_v1_signaling, 11);
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserSendRequest.
+ * Use `create(UserSendRequestSchema)` to create a new message.
+ */
+export const UserSendRequestSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_signaling_v1_signaling, 12);
+
+/**
+ * Describes the message kusinta.iot.signaling.v1.UserSendResponse.
+ * Use `create(UserSendResponseSchema)` to create a new message.
+ */
+export const UserSendResponseSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_signaling_v1_signaling, 13);
+

package/src/kusinta/iot/signaling/v1/signaling_service_pb.d.ts

@@ -3,7 +3,7 @@
 /* eslint-disable */
 
 import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { GatewayConnectRequestSchema, GatewayConnectResponseSchema, UserConnectRequestSchema, UserConnectResponseSchema } from "./signaling_pb.js";
+import type { GatewayConnectRequestSchema, GatewayConnectResponseSchema, UserConnectRequestSchema, UserConnectResponseSchema, UserListenRequestSchema, UserListenResponseSchema, UserSendRequestSchema, UserSendResponseSchema } from "./signaling_pb.js";
 
 /**
  * Describes the file kusinta/iot/signaling/v1/signaling_service.proto.
@@ -30,5 +30,28 @@ export declare const GatewaySignalingService: GenService<{
     input: typeof UserConnectRequestSchema;
     output: typeof UserConnectResponseSchema;
   },
+  /**
+   * Opens the session and its downstream half, for a client whose transport
+   * cannot stream a request body and so cannot call UserConnect. The handshake
+   * travels in the request; the acknowledgement is the stream's first message.
+   *
+   * @generated from rpc kusinta.iot.signaling.v1.GatewaySignalingService.UserListen
+   */
+  userListen: {
+    methodKind: "server_streaming";
+    input: typeof UserListenRequestSchema;
+    output: typeof UserListenResponseSchema;
+  },
+  /**
+   * Delivers one upstream message into a session UserListen has already opened.
+   * A call naming a session the relay does not hold is refused, not queued.
+   *
+   * @generated from rpc kusinta.iot.signaling.v1.GatewaySignalingService.UserSend
+   */
+  userSend: {
+    methodKind: "unary";
+    input: typeof UserSendRequestSchema;
+    output: typeof UserSendResponseSchema;
+  },
 }>;
 

package/src/kusinta/iot/signaling/v1/signaling_service_pb.js

@@ -9,7 +9,7 @@ import { file_kusinta_iot_signaling_v1_signaling } from "./signaling_pb.js";
  * Describes the file kusinta/iot/signaling/v1/signaling_service.proto.
  */
 export const file_kusinta_iot_signaling_v1_signaling_service = /*@__PURE__*/
-  fileDesc("CjBrdXNpbnRhL2lvdC9zaWduYWxpbmcvdjEvc2lnbmFsaW5nX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LnNpZ25hbGluZy52MTKCAgoXR2F0ZXdheVNpZ25hbGluZ1NlcnZpY2USdwoOR2F0ZXdheUNvbm5lY3QSLy5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuR2F0ZXdheUNvbm5lY3RSZXF1ZXN0GjAua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkdhdGV3YXlDb25uZWN0UmVzcG9uc2UoATABEm4KC1VzZXJDb25uZWN0Eiwua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJDb25uZWN0UmVxdWVzdBotLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VyQ29ubmVjdFJlc3BvbnNlKAEwAUICSAFiBnByb3RvMw", [file_kusinta_iot_signaling_v1_signaling]);
+  fileDesc("CjBrdXNpbnRhL2lvdC9zaWduYWxpbmcvdjEvc2lnbmFsaW5nX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LnNpZ25hbGluZy52MTLQAwoXR2F0ZXdheVNpZ25hbGluZ1NlcnZpY2USdwoOR2F0ZXdheUNvbm5lY3QSLy5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuR2F0ZXdheUNvbm5lY3RSZXF1ZXN0GjAua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkdhdGV3YXlDb25uZWN0UmVzcG9uc2UoATABEm4KC1VzZXJDb25uZWN0Eiwua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJDb25uZWN0UmVxdWVzdBotLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VyQ29ubmVjdFJlc3BvbnNlKAEwARJpCgpVc2VyTGlzdGVuEisua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJMaXN0ZW5SZXF1ZXN0Giwua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJMaXN0ZW5SZXNwb25zZTABEmEKCFVzZXJTZW5kEikua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJTZW5kUmVxdWVzdBoqLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VyU2VuZFJlc3BvbnNlQgJIAWIGcHJvdG8z", [file_kusinta_iot_signaling_v1_signaling]);
 
 /**
  * @generated from service kusinta.iot.signaling.v1.GatewaySignalingService

package/src/kusinta/iot/webrtc/v1/envelope_pb.d.ts

@@ -342,8 +342,9 @@ export declare const ManagementResultSchema: GenMessage<ManagementResult>;
  *
  * A payload case of its own rather than a ManagementRequest. Those are gated on a target —
  * a space, a device — and that is the justification for keeping them behind one wrapper.
- * This one names no target: connector_id is optional, and unset means every connector, so
- * it is authorized against the caller's role and nothing else.
+ * A connector is not a target the caller must reach the way a space is, so this is
+ * authorized against the caller's role and nothing else — but it must still name the
+ * connector to open (see connector_id), never every connector at once.
  *
  * Answered twice, and the two answers say different things at different times.
  * PairingStarted reports whether the window opened; PairingFinished reports what came of
@@ -354,13 +355,13 @@ export declare const ManagementResultSchema: GenMessage<ManagementResult>;
  */
 export declare type StartPairing = Message<"kusinta.iot.webrtc.v1.StartPairing"> & {
   /**
-   * Which connector to open. Unset means every connector the gateway holds, which is the
-   * sensible default: a device picks its hub by radio range, and asking a user to choose is
-   * asking them to guess at something they cannot observe.
-   *
-   * Name one where the answer is not a guess — a device that will be linked to devices on a
-   * particular hub has to join that hub, because links are held by the hub that brokered
-   * them.
+   * Which connector to open. Required: pairing always targets exactly one connector,
+   * picked from the connector enumeration (see ConnectorsAnnounced and
+   * ConnectorInfo.supports_pairing). An untargeted request is refused with
+   * PairingError.CONNECTOR_REQUIRED, never fanned out across every hub — so that no
+   * client can open every radio at once, and so a device is paired onto the specific hub
+   * that will broker its links. The field is a message, so proto cannot mark it required;
+   * the gateway enforces it.
    *
    * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
    */