@kusinta/iot-schema 0.2.0-beta.2 → 0.2.0-beta.21

package/src/kusinta/iot/reporting/v1/reporting_pb.js

@@ -0,0 +1,164 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/reporting/v1/reporting.proto (package kusinta.iot.reporting.v1, syntax proto3)
+/* eslint-disable */
+
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_kusinta_iot_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/reporting/v1/reporting.proto.
+ */
+export const file_kusinta_iot_reporting_v1_reporting = /*@__PURE__*/
+  fileDesc("CihrdXNpbnRhL2lvdC9yZXBvcnRpbmcvdjEvcmVwb3J0aW5nLnByb3RvEhhrdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEiPwoMU25hcHNob3RQYXJ0EhMKC3NuYXBzaG90X2lkGAEgASgJEgwKBHBhcnQYAiABKA0SDAoEbGFzdBgDIAEoCCLZAQoOUHJvYmxlbVN1YmplY3QSNgoJZGV2aWNlX2lkGAEgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWRIABI8Cgxjb25uZWN0b3JfaWQYAiABKAsyJC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5Db25uZWN0b3JJZEgAEjMKB3Jvb21faWQYAyABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkSAASEQoHZ2F0ZXdheRgEIAEoCEgAQgkKB3N1YmplY3QipAIKB1Byb2JsZW0SMwoEa2luZBgCIAEoDjIlLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5Qcm9ibGVtS2luZBI5CgdzdWJqZWN0GAMgASgLMigua3VzaW50YS5pb3QucmVwb3J0aW5nLnYxLlByb2JsZW1TdWJqZWN0EjIKCHNwYWNlX2lkGAQgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBItCglvcGVuZWRfYXQYBSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEhwKD2JhdHRlcnlfcGVyY2VudBgGIAEoDUgAiAEBEhQKDGRldmljZV9jb3VudBgHIAEoDUISChBfYmF0dGVyeV9wZXJjZW50IncKDlByb2JsZW1DbGVhcmVkEi4KCmNsZWFyZWRfYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjUKBnJlYXNvbhgCIAEoDjIlLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5DbGVhclJlYXNvbiKuAQoRUHJvYmxlbVRyYW5zaXRpb24SEgoKcHJvYmxlbV9pZBgBIAEoCRILCgNzZXEYAiABKAQSMQoEb3BlbhgDIAEoCzIhLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5Qcm9ibGVtSAASOwoHY2xlYXJlZBgEIAEoCzIoLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5Qcm9ibGVtQ2xlYXJlZEgAQggKBmNoYW5nZSLQAQoVUmVwb3J0UHJvYmxlbXNSZXF1ZXN0EhEKCXN0cmVhbV9pZBgDIAEoCRIbChNwcmV2aW91c19zdHJlYW1faWRzGAUgAygJEgsKA3NlcRgEIAEoBBJACgt0cmFuc2l0aW9ucxgBIAMoCzIrLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5Qcm9ibGVtVHJhbnNpdGlvbhI4CghzbmFwc2hvdBgCIAEoCzImLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5TbmFwc2hvdFBhcnQiZQoNVHJhbnNpdGlvbkFjaxISCgpwcm9ibGVtX2lkGAEgASgJEgsKA3NlcRgCIAEoBBIzCgZzdGF0dXMYAyABKA4yIy5rdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEuQWNrU3RhdHVzIn0KFlJlcG9ydFByb2JsZW1zUmVzcG9uc2USNQoEYWNrcxgBIAMoCzInLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5UcmFuc2l0aW9uQWNrEhMKC2FwcGxpZWRfc2VxGAMgASgEEhcKD3Jlc3luY19yZXF1aXJlZBgCIAEoCCJ4CgxTZXJ2aWNlUmVhY2gSMAoHdXNlcl9pZBgBIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBI2CgZzcGFjZXMYAyADKAsyJi5rdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEuUmVhY2hlZFNwYWNlIm0KDFJlYWNoZWRTcGFjZRIyCghzcGFjZV9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSKQoFc2luY2UYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wIoQCChlSZXBvcnRTZXJ2aWNlUmVhY2hSZXF1ZXN0EhEKCXN0cmVhbV9pZBgFIAEoCRIbChNwcmV2aW91c19zdHJlYW1faWRzGAYgAygJEgsKA3NlcRgBIAEoBBI1CgVyZWFjaBgCIAMoCzImLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5TZXJ2aWNlUmVhY2gSOQoQcmVtb3ZlZF91c2VyX2lkcxgDIAMoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBI4CghzbmFwc2hvdBgEIAEoCzImLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5TbmFwc2hvdFBhcnQiSgoaUmVwb3J0U2VydmljZVJlYWNoUmVzcG9uc2USEwoLYXBwbGllZF9zZXEYASABKAQSFwoPcmVzeW5jX3JlcXVpcmVkGAIgASgIIuIBCgtTZXJ2ZWRTcGFjZRIyCghzcGFjZV9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSNAoKc3BhY2VfdHlwZRgCIAEoDjIgLmt1c2ludGEuaW90LmNvbW1vbi52MS5TcGFjZVR5cGUSDAoEbmFtZRgDIAEoCRI5Cg9wYXJlbnRfc3BhY2VfaWQYBCABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEg0KBWZsb29yGAUgASgFEhEKCXRpbWVfem9uZRgGIAEoCSKGAgoZUmVwb3J0U2VydmVkU3BhY2VzUmVxdWVzdBIRCglzdHJlYW1faWQYBSABKAkSGwoTcHJldmlvdXNfc3RyZWFtX2lkcxgGIAMoCRILCgNzZXEYASABKAQSNQoGc3BhY2VzGAIgAygLMiUua3VzaW50YS5pb3QucmVwb3J0aW5nLnYxLlNlcnZlZFNwYWNlEjsKEXJlbW92ZWRfc3BhY2VfaWRzGAMgAygLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI4CghzbmFwc2hvdBgEIAEoCzImLmt1c2ludGEuaW90LnJlcG9ydGluZy52MS5TbmFwc2hvdFBhcnQiSgoaUmVwb3J0U2VydmVkU3BhY2VzUmVzcG9uc2USEwoLYXBwbGllZF9zZXEYASABKAQSFwoPcmVzeW5jX3JlcXVpcmVkGAIgASgIKtwCCgtQcm9ibGVtS2luZBIcChhQUk9CTEVNX0tJTkRfVU5TUEVDSUZJRUQQABIfChtQUk9CTEVNX0tJTkRfREVWSUNFX09GRkxJTkUQARIcChhQUk9CTEVNX0tJTkRfQkFUVEVSWV9MT1cQAhIrCidQUk9CTEVNX0tJTkRfQkFUVEVSWV9SRVBMQUNFTUVOVF9ORUVERUQQAxIdChlQUk9CTEVNX0tJTkRfREVWSUNFX0VSUk9SEAQSHgoaUFJPQkxFTV9LSU5EX0RFVklDRV9UQU1QRVIQBRIiCh5QUk9CTEVNX0tJTkRfQ09OTkVDVE9SX09GRkxJTkUQBhIgChxQUk9CTEVNX0tJTkRfQ09OTkVDVE9SX0VSUk9SEAcSIAocUFJPQkxFTV9LSU5EX1VORklMRURfREVWSUNFUxAIEhwKGFBST0JMRU1fS0lORF9XSU5ET1dfT1BFThAJKu8BCgtDbGVhclJlYXNvbhIcChhDTEVBUl9SRUFTT05fVU5TUEVDSUZJRUQQABIaChZDTEVBUl9SRUFTT05fUkVDT1ZFUkVEEAESFgoSQ0xFQVJfUkVBU09OX0ZJTEVEEAISHwobQ0xFQVJfUkVBU09OX0RFVklDRV9SRU1PVkVEEAMSMAosQ0xFQVJfUkVBU09OX1NVUEVSU0VERURfQllfQ09OTkVDVE9SX09GRkxJTkUQBBIjCh9DTEVBUl9SRUFTT05fTk9fTE9OR0VSX1JFUE9SVEVEEAUSFgoSQ0xFQVJfUkVBU09OX01PVkVEEAYqhwEKCUFja1N0YXR1cxIaChZBQ0tfU1RBVFVTX1VOU1BFQ0lGSUVEEAASFgoSQUNLX1NUQVRVU19BUFBMSUVEEAESGAoUQUNLX1NUQVRVU19EVVBMSUNBVEUQAhIXChNBQ0tfU1RBVFVTX1JFSkVDVEVEEAMSEwoPQUNLX1NUQVRVU19IRUxEEARCAkgBYgZwcm90bzM", [file_google_protobuf_timestamp, file_kusinta_iot_common_v1_types, file_kusinta_iot_identity_v1_identity]);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.SnapshotPart.
+ * Use `create(SnapshotPartSchema)` to create a new message.
+ */
+export const SnapshotPartSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 0);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemSubject.
+ * Use `create(ProblemSubjectSchema)` to create a new message.
+ */
+export const ProblemSubjectSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 1);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.Problem.
+ * Use `create(ProblemSchema)` to create a new message.
+ */
+export const ProblemSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 2);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemCleared.
+ * Use `create(ProblemClearedSchema)` to create a new message.
+ */
+export const ProblemClearedSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 3);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemTransition.
+ * Use `create(ProblemTransitionSchema)` to create a new message.
+ */
+export const ProblemTransitionSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 4);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportProblemsRequest.
+ * Use `create(ReportProblemsRequestSchema)` to create a new message.
+ */
+export const ReportProblemsRequestSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 5);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.TransitionAck.
+ * Use `create(TransitionAckSchema)` to create a new message.
+ */
+export const TransitionAckSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 6);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportProblemsResponse.
+ * Use `create(ReportProblemsResponseSchema)` to create a new message.
+ */
+export const ReportProblemsResponseSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 7);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ServiceReach.
+ * Use `create(ServiceReachSchema)` to create a new message.
+ */
+export const ServiceReachSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 8);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReachedSpace.
+ * Use `create(ReachedSpaceSchema)` to create a new message.
+ */
+export const ReachedSpaceSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 9);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServiceReachRequest.
+ * Use `create(ReportServiceReachRequestSchema)` to create a new message.
+ */
+export const ReportServiceReachRequestSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 10);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServiceReachResponse.
+ * Use `create(ReportServiceReachResponseSchema)` to create a new message.
+ */
+export const ReportServiceReachResponseSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 11);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ServedSpace.
+ * Use `create(ServedSpaceSchema)` to create a new message.
+ */
+export const ServedSpaceSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 12);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServedSpacesRequest.
+ * Use `create(ReportServedSpacesRequestSchema)` to create a new message.
+ */
+export const ReportServedSpacesRequestSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 13);
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServedSpacesResponse.
+ * Use `create(ReportServedSpacesResponseSchema)` to create a new message.
+ */
+export const ReportServedSpacesResponseSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_reporting_v1_reporting, 14);
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.ProblemKind.
+ */
+export const ProblemKindSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_reporting_v1_reporting, 0);
+
+/**
+ * What kind of problem is open. The device kinds mirror what service staff are given of a
+ * device (webrtc.v1.ServiceStatus: reachability, the battery flags, the ServiceFault values);
+ * a device signal added there is added here too.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.ProblemKind
+ */
+export const ProblemKind = /*@__PURE__*/
+  tsEnum(ProblemKindSchema);
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.ClearReason.
+ */
+export const ClearReasonSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_reporting_v1_reporting, 1);
+
+/**
+ * Why a problem closed.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.ClearReason
+ */
+export const ClearReason = /*@__PURE__*/
+  tsEnum(ClearReasonSchema);
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.AckStatus.
+ */
+export const AckStatusSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_reporting_v1_reporting, 2);
+
+/**
+ * What the api-server made of one transition.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.AckStatus
+ */
+export const AckStatus = /*@__PURE__*/
+  tsEnum(AckStatusSchema);
+

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

@@ -0,0 +1,47 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/reporting/v1/reporting_service.proto (package kusinta.iot.reporting.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { ReportProblemsRequestSchema, ReportProblemsResponseSchema, ReportServedSpacesRequestSchema, ReportServedSpacesResponseSchema, ReportServiceReachRequestSchema, ReportServiceReachResponseSchema } from "./reporting_pb.js";
+
+/**
+ * Describes the file kusinta/iot/reporting/v1/reporting_service.proto.
+ */
+export declare const file_kusinta_iot_reporting_v1_reporting_service: GenFile;
+
+/**
+ * The building-server gateway's reports to the api-server, over the gateway's client
+ * certificate: which gateway is reporting comes from the certificate. Three unary calls, one
+ * per concern, each with its own stream of reports, so a slow call for one never holds back
+ * another.
+ *
+ * @generated from service kusinta.iot.reporting.v1.GatewayReportingService
+ */
+export declare const GatewayReportingService: GenService<{
+  /**
+   * @generated from rpc kusinta.iot.reporting.v1.GatewayReportingService.ReportProblems
+   */
+  reportProblems: {
+    methodKind: "unary";
+    input: typeof ReportProblemsRequestSchema;
+    output: typeof ReportProblemsResponseSchema;
+  },
+  /**
+   * @generated from rpc kusinta.iot.reporting.v1.GatewayReportingService.ReportServiceReach
+   */
+  reportServiceReach: {
+    methodKind: "unary";
+    input: typeof ReportServiceReachRequestSchema;
+    output: typeof ReportServiceReachResponseSchema;
+  },
+  /**
+   * @generated from rpc kusinta.iot.reporting.v1.GatewayReportingService.ReportServedSpaces
+   */
+  reportServedSpaces: {
+    methodKind: "unary";
+    input: typeof ReportServedSpacesRequestSchema;
+    output: typeof ReportServedSpacesResponseSchema;
+  },
+}>;
+

package/src/kusinta/iot/reporting/v1/reporting_service_pb.js

@@ -0,0 +1,24 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/reporting/v1/reporting_service.proto (package kusinta.iot.reporting.v1, syntax proto3)
+/* eslint-disable */
+
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_kusinta_iot_reporting_v1_reporting } from "./reporting_pb.js";
+
+/**
+ * Describes the file kusinta/iot/reporting/v1/reporting_service.proto.
+ */
+export const file_kusinta_iot_reporting_v1_reporting_service = /*@__PURE__*/
+  fileDesc("CjBrdXNpbnRhL2lvdC9yZXBvcnRpbmcvdjEvcmVwb3J0aW5nX3NlcnZpY2UucHJvdG8SGGt1c2ludGEuaW90LnJlcG9ydGluZy52MTKQAwoXR2F0ZXdheVJlcG9ydGluZ1NlcnZpY2UScwoOUmVwb3J0UHJvYmxlbXMSLy5rdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEuUmVwb3J0UHJvYmxlbXNSZXF1ZXN0GjAua3VzaW50YS5pb3QucmVwb3J0aW5nLnYxLlJlcG9ydFByb2JsZW1zUmVzcG9uc2USfwoSUmVwb3J0U2VydmljZVJlYWNoEjMua3VzaW50YS5pb3QucmVwb3J0aW5nLnYxLlJlcG9ydFNlcnZpY2VSZWFjaFJlcXVlc3QaNC5rdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEuUmVwb3J0U2VydmljZVJlYWNoUmVzcG9uc2USfwoSUmVwb3J0U2VydmVkU3BhY2VzEjMua3VzaW50YS5pb3QucmVwb3J0aW5nLnYxLlJlcG9ydFNlcnZlZFNwYWNlc1JlcXVlc3QaNC5rdXNpbnRhLmlvdC5yZXBvcnRpbmcudjEuUmVwb3J0U2VydmVkU3BhY2VzUmVzcG9uc2VCAkgBYgZwcm90bzM", [file_kusinta_iot_reporting_v1_reporting]);
+
+/**
+ * The building-server gateway's reports to the api-server, over the gateway's client
+ * certificate: which gateway is reporting comes from the certificate. Three unary calls, one
+ * per concern, each with its own stream of reports, so a slow call for one never holds back
+ * another.
+ *
+ * @generated from service kusinta.iot.reporting.v1.GatewayReportingService
+ */
+export const GatewayReportingService = /*@__PURE__*/
+  serviceDesc(file_kusinta_iot_reporting_v1_reporting_service, 0);
+

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

@@ -76,10 +76,26 @@ export declare type IceCandidate = Message<"kusinta.iot.signaling.v1.IceCandidat
 export declare const IceCandidateSchema: GenMessage<IceCandidate>;
 
 /**
- * Empty keepalive. The gateway sends this periodically on the GatewayConnect
- * stream so the otherwise-idle bidi request keeps producing DATA frames, which
- * resets the inactivity timers on any proxy between the two ends and stops it
- * from tearing the stream down. Carries no routing target and is dropped on receipt.
+ * Empty keepalive, sent periodically on a stream that would otherwise fall
+ * silent. The DATA frames it produces reset the inactivity timers on any proxy
+ * between the two ends and stop it tearing the stream down. Carries no routing
+ * target and is dropped on receipt.
+ *
+ * Carried on two arms, each covering a half that falls silent while neither end
+ * has anything to say: the building-server gateway sends it upstream on
+ * GatewayConnect, and the api-server sends it downstream to the app on
+ * UserConnectResponse. The remaining halves have no arm — an app leg's upstream
+ * that goes idle is one the client can write on whenever it needs to.
+ *
+ * Never an acknowledgement. A heartbeat answers no message and must not be
+ * treated as confirming one.
+ *
+ * On GatewayConnect it also lets the api-server judge whether the gateway is
+ * present. A gateway is present while its stream is open, and never lets it
+ * carry nothing for more than 30 seconds: a heartbeat fills any longer silence.
+ * A stream that has carried nothing for 90 seconds may be taken as gone, even
+ * when the transport has not yet said so. That is the gateway's presence and
+ * nothing more: a present gateway may still have lost its devices.
  *
  * @generated from message kusinta.iot.signaling.v1.HeartBeat
  */
@@ -124,6 +140,23 @@ export declare type UserHandshakeAck = Message<"kusinta.iot.signaling.v1.UserHan
    * @generated from field: string reason = 2;
    */
   reason: string;
+
+  /**
+   * How often the api-server will send a HeartBeat on this stream, in
+   * milliseconds.
+   *
+   * Advisory, and a client must not refuse a stream over it: a client that has
+   * seen no traffic at all for a small multiple of this may take the stream for
+   * gone and reattach with the same session_id, which is the difference between
+   * a renegotiation that stalls and one that reconnects. The server is free to
+   * answer with a different value on the next session.
+   *
+   * Zero means the server is not heartbeating this stream, and a client must
+   * then not infer anything from silence.
+   *
+   * @generated from field: uint32 heartbeat_interval_ms = 3;
+   */
+  heartbeatIntervalMs: number;
 };
 
 /**
@@ -244,6 +277,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: {
@@ -276,6 +313,10 @@ export declare const UserConnectRequestSchema: GenMessage<UserConnectRequest>;
 /**
  * Messages sent by the api-server to the app.
  *
+ * One oneof serves both forms of the leg: UserListenResponse wraps this message
+ * rather than restating its payloads, so an arm added here reaches the bidi and
+ * half-duplex forms alike.
+ *
  * @generated from message kusinta.iot.signaling.v1.UserConnectResponse
  */
 export declare type UserConnectResponse = Message<"kusinta.iot.signaling.v1.UserConnectResponse"> & {
@@ -283,6 +324,7 @@ export declare type UserConnectResponse = Message<"kusinta.iot.signaling.v1.User
    * Echoes the session_id of the stream this message is delivered on, so a
    * client can assert the relay routed to the session it thinks it is. See the
    * contract above.
+   * Ignored on a heartbeat, which carries no routing target at all.
    *
    * @generated from field: string session_id = 4;
    */
@@ -309,6 +351,22 @@ export declare type UserConnectResponse = Message<"kusinta.iot.signaling.v1.User
      */
     value: IceCandidate;
     case: "iceCandidate";
+  } | {
+    /**
+     * Keeps a silent stream alive. UserListen is downstream-only — the client
+     * opens it with a handshake and then writes nothing — so between the
+     * acknowledgement and an answer there is no traffic in either direction, and
+     * an idle negotiation can outlast a proxy's patience. Upstream cannot help:
+     * the client has nothing to send, and it is traffic *to* the client that
+     * resets a client-side idle timer.
+     *
+     * A client that does not know this arm sees an unset payload rather than an
+     * error, which is what the oneof buys.
+     *
+     * @generated from field: kusinta.iot.signaling.v1.HeartBeat heartbeat = 5;
+     */
+    value: HeartBeat;
+    case: "heartbeat";
   } | { case: undefined; value?: undefined };
 };
 
@@ -318,3 +376,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("CihrdXNpbnRhL2lvdC9zaWduYWxpbmcvdjEvc2lnbmFsaW5nLnByb3RvEhhrdXNpbnRhLmlvdC5zaWduYWxpbmcudjEiFwoIU2RwT2ZmZXISCwoDc2RwGAEgASgJIhgKCVNkcEFuc3dlchILCgNzZHAYASABKAkiSwoMSWNlQ2FuZGlkYXRlEhEKCWNhbmRpZGF0ZRgBIAEoCRIPCgdzZHBfbWlkGAIgASgJEhcKD3NkcF9tbGluZV9pbmRleBgDIAEoBSILCglIZWFydEJlYXQiTgoNVXNlckhhbmRzaGFrZRI9ChF0YXJnZXRfZ2F0ZXdheV9pZBgBIAEoCzIiLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkdhdGV3YXlJZCJTChBVc2VySGFuZHNoYWtlQWNrEhAKCGFjY2VwdGVkGAEgASgIEg4KBnJlYXNvbhgCIAEoCRIdChVoZWFydGJlYXRfaW50ZXJ2YWxfbXMYAyABKA0ioQIKFUdhdGV3YXlDb25uZWN0UmVxdWVzdBI3Cg50YXJnZXRfdXNlcl9pZBgBIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBISCgpzZXNzaW9uX2lkGAUgASgJEjUKBmFuc3dlchgCIAEoCzIjLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5TZHBBbnN3ZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAEjgKCWhlYXJ0YmVhdBgEIAEoCzIjLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5IZWFydEJlYXRIAEIJCgdwYXlsb2FkIuQBChZHYXRld2F5Q29ubmVjdFJlc3BvbnNlEjUKDGZyb21fdXNlcl9pZBgBIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZBISCgpzZXNzaW9uX2lkGAQgASgJEjMKBW9mZmVyGAIgASgLMiIua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcE9mZmVySAASPwoNaWNlX2NhbmRpZGF0ZRgDIAEoCzImLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5JY2VDYW5kaWRhdGVIAEIJCgdwYXlsb2FkIucBChJVc2VyQ29ubmVjdFJlcXVlc3QSEgoKc2Vzc2lvbl9pZBgEIAEoCRI8CgloYW5kc2hha2UYASABKAsyJy5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuVXNlckhhbmRzaGFrZUgAEjMKBW9mZmVyGAIgASgLMiIua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcE9mZmVySAASPwoNaWNlX2NhbmRpZGF0ZRgDIAEoCzImLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5JY2VDYW5kaWRhdGVIAEIJCgdwYXlsb2FkIqsCChNVc2VyQ29ubmVjdFJlc3BvbnNlEhIKCnNlc3Npb25faWQYBCABKAkSQwoNaGFuZHNoYWtlX2FjaxgBIAEoCzIqLmt1c2ludGEuaW90LnNpZ25hbGluZy52MS5Vc2VySGFuZHNoYWtlQWNrSAASNQoGYW5zd2VyGAIgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlNkcEFuc3dlckgAEj8KDWljZV9jYW5kaWRhdGUYAyABKAsyJi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuSWNlQ2FuZGlkYXRlSAASOAoJaGVhcnRiZWF0GAUgASgLMiMua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkhlYXJ0QmVhdEgAQgkKB3BheWxvYWQibwoRVXNlckxpc3RlblJlcXVlc3QSOgoJaGFuZHNoYWtlGAEgASgLMicua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLlVzZXJIYW5kc2hha2USEgoKc2Vzc2lvbl9pZBgEIAEoCUoECAIQA0oECAMQBCJVChJVc2VyTGlzdGVuUmVzcG9uc2USPwoIcmVzcG9uc2UYASABKAsyLS5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuVXNlckNvbm5lY3RSZXNwb25zZSK3AQoPVXNlclNlbmRSZXF1ZXN0EhIKCnNlc3Npb25faWQYBCABKAkSMwoFb2ZmZXIYAiABKAsyIi5rdXNpbnRhLmlvdC5zaWduYWxpbmcudjEuU2RwT2ZmZXJIABI/Cg1pY2VfY2FuZGlkYXRlGAMgASgLMiYua3VzaW50YS5pb3Quc2lnbmFsaW5nLnYxLkljZUNhbmRpZGF0ZUgAQgkKB3BheWxvYWRKBAgBEAJSCWhhbmRzaGFrZSISChBVc2VyU2VuZFJlc3BvbnNlQgJIAWIGcHJvdG8z", [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