@kusinta/iot-schema 0.2.0-beta.3 → 0.2.0-beta.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/package.json +9 -1
  2. package/src/kusinta/iot/access/v1/acl_pb.d.ts +118 -2
  3. package/src/kusinta/iot/access/v1/acl_pb.js +20 -3
  4. package/src/kusinta/iot/access/v1/roles_pb.d.ts +119 -4
  5. package/src/kusinta/iot/access/v1/roles_pb.js +98 -5
  6. package/src/kusinta/iot/climate/v1/climate_pb.d.ts +726 -0
  7. package/src/kusinta/iot/climate/v1/climate_pb.js +142 -0
  8. package/src/kusinta/iot/common/v1/pairing_pb.d.ts +217 -0
  9. package/src/kusinta/iot/common/v1/pairing_pb.js +50 -0
  10. package/src/kusinta/iot/common/v1/types_pb.d.ts +175 -0
  11. package/src/kusinta/iot/common/v1/types_pb.js +70 -1
  12. package/src/kusinta/iot/connector/v1/connector_pb.d.ts +691 -2
  13. package/src/kusinta/iot/connector/v1/connector_pb.js +104 -13
  14. package/src/kusinta/iot/device/v1/cluster_state_pb.d.ts +44 -0
  15. package/src/kusinta/iot/device/v1/cluster_state_pb.js +1 -1
  16. package/src/kusinta/iot/device/v1/descriptor_pb.d.ts +22 -2
  17. package/src/kusinta/iot/device/v1/descriptor_pb.js +2 -1
  18. package/src/kusinta/iot/device/v1/device_event_pb.d.ts +87 -5
  19. package/src/kusinta/iot/device/v1/device_event_pb.js +1 -1
  20. package/src/kusinta/iot/device/v1/device_pb.d.ts +150 -6
  21. package/src/kusinta/iot/device/v1/device_pb.js +33 -2
  22. package/src/kusinta/iot/device/v1/matter_options_pb.d.ts +26 -0
  23. package/src/kusinta/iot/device/v1/matter_options_pb.js +31 -4
  24. package/src/kusinta/iot/device/v1/properties_pb.d.ts +14 -0
  25. package/src/kusinta/iot/device/v1/properties_pb.js +1 -1
  26. package/src/kusinta/iot/device/v1/property_update_pb.d.ts +3 -2
  27. package/src/kusinta/iot/link/v1/link_pb.d.ts +438 -0
  28. package/src/kusinta/iot/link/v1/link_pb.js +121 -0
  29. package/src/kusinta/iot/reporting/v1/reporting_pb.d.ts +1219 -0
  30. package/src/kusinta/iot/reporting/v1/reporting_pb.js +238 -0
  31. package/src/kusinta/iot/reporting/v1/reporting_service_pb.d.ts +63 -0
  32. package/src/kusinta/iot/reporting/v1/reporting_service_pb.js +24 -0
  33. package/src/kusinta/iot/signaling/v1/signaling_pb.d.ts +361 -7
  34. package/src/kusinta/iot/signaling/v1/signaling_pb.js +68 -4
  35. package/src/kusinta/iot/signaling/v1/signaling_service_pb.d.ts +24 -1
  36. package/src/kusinta/iot/signaling/v1/signaling_service_pb.js +1 -1
  37. package/src/kusinta/iot/space/v1/space_pb.d.ts +103 -2
  38. package/src/kusinta/iot/space/v1/space_pb.js +10 -1
  39. package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.d.ts +162 -13
  40. package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.js +8 -1
  41. package/src/kusinta/iot/vendor/lorawan/v1/lorawan_pb.d.ts +69 -0
  42. package/src/kusinta/iot/vendor/lorawan/v1/lorawan_pb.js +19 -0
  43. package/src/kusinta/iot/vendor/v1/vendor_options_pb.d.ts +25 -4
  44. package/src/kusinta/iot/vendor/v1/vendor_options_pb.js +28 -6
  45. package/src/kusinta/iot/webrtc/v1/app_token_pb.d.ts +45 -5
  46. package/src/kusinta/iot/webrtc/v1/app_token_pb.js +1 -1
  47. package/src/kusinta/iot/webrtc/v1/command_pb.d.ts +14 -0
  48. package/src/kusinta/iot/webrtc/v1/command_pb.js +1 -1
  49. package/src/kusinta/iot/webrtc/v1/device_state_pb.d.ts +179 -5
  50. package/src/kusinta/iot/webrtc/v1/device_state_pb.js +35 -6
  51. package/src/kusinta/iot/webrtc/v1/envelope_pb.d.ts +520 -3
  52. package/src/kusinta/iot/webrtc/v1/envelope_pb.js +65 -3
  53. package/src/kusinta/iot/webrtc/v1/invite_pb.d.ts +496 -0
  54. package/src/kusinta/iot/webrtc/v1/invite_pb.js +108 -0
  55. package/src/kusinta/iot/webrtc/v1/management_pb.d.ts +977 -12
  56. package/src/kusinta/iot/webrtc/v1/management_pb.js +132 -5
  57. package/src/kusinta/iot/webrtc/v1/members_pb.d.ts +327 -0
  58. package/src/kusinta/iot/webrtc/v1/members_pb.js +78 -0
  59. package/src/kusinta/iot/webrtc/v1/permission_push_pb.d.ts +66 -4
  60. package/src/kusinta/iot/webrtc/v1/permission_push_pb.js +10 -2
@@ -5,8 +5,16 @@
5
5
  import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
6
6
  import type { Message } from "@bufbuild/protobuf";
7
7
  import type { DeviceOwnershipType, SpaceType } from "../../common/v1/types_pb.js";
8
- import type { DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
8
+ import type { ConnectorId, DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
9
+ import type { MembershipRelation, Role } from "../../access/v1/roles_pb.js";
10
+ import type { LorawanProvisioning } from "../../vendor/lorawan/v1/lorawan_pb.js";
9
11
  import type { Space } from "../../space/v1/space_pb.js";
12
+ import type { LinkFunction, LinkMode, LinkSettings } from "../../link/v1/link_pb.js";
13
+ import type { ClimateModeKind, ClimateSummaryPeriod } from "../../climate/v1/climate_pb.js";
14
+ import type { Timestamp } from "@bufbuild/protobuf/wkt";
15
+ import type { ServiceSignal } from "../../access/v1/acl_pb.js";
16
+ import type { ApproveJoinRequest, CreateInvite, DenyJoinRequest, ListSpaceInvites, MarkInviteEmailSent, ResendInvite, RevokeInvite } from "./invite_pb.js";
17
+ import type { ListGatewayMembers, RemoveFromGateway, SetAccessUntil, SetMemberRole, SetOwnerOrganisation } from "./members_pb.js";
10
18
 
11
19
  /**
12
20
  * Describes the file kusinta/iot/webrtc/v1/management.proto.
@@ -18,6 +26,10 @@ export declare const file_kusinta_iot_webrtc_v1_management: GenFile;
18
26
  * stronger request than it looks: there is no parent whose reach could authorize
19
27
  * it, so it is reserved to the gateway's administrator.
20
28
  *
29
+ * Under an apartment only a room may be created. Creating in a home is guarded as
30
+ * UpdateSpace is, and refused whatever the caller where UpdateSpace's structure rules would
31
+ * refuse it.
32
+ *
21
33
  * @generated from message kusinta.iot.webrtc.v1.CreateSpace
22
34
  */
23
35
  export declare type CreateSpace = Message<"kusinta.iot.webrtc.v1.CreateSpace"> & {
@@ -49,6 +61,14 @@ export declare type CreateSpace = Message<"kusinta.iot.webrtc.v1.CreateSpace"> &
49
61
  * @generated from field: kusinta.iot.identity.v1.SpaceId parent_space_id = 5;
50
62
  */
51
63
  parentSpaceId?: SpaceId | undefined;
64
+
65
+ /**
66
+ * An IANA time zone name, e.g. "Europe/Stockholm". Accepted only on a building — a
67
+ * top-level space — and refused on any other. Unset leaves it unknown.
68
+ *
69
+ * @generated from field: optional string time_zone = 6;
70
+ */
71
+ timeZone?: string | undefined;
52
72
  };
53
73
 
54
74
  /**
@@ -58,9 +78,21 @@ export declare type CreateSpace = Message<"kusinta.iot.webrtc.v1.CreateSpace"> &
58
78
  export declare const CreateSpaceSchema: GenMessage<CreateSpace>;
59
79
 
60
80
  /**
61
- * Changes a space in place. Every descriptive field carries explicit presence:
62
- * absent means leave it alone, present means set it to this — including to the
63
- * empty string, which is how a description is cleared.
81
+ * Changes a space in place. Changes that would take a space into or out of a home, or move
82
+ * a home, are guarded by the gateway; a caller not allowed is refused as NOT_ENTITLED. A
83
+ * change is refused whatever the caller if it would leave anything but a room under an
84
+ * apartment, an apartment in a home, or — among what the caller can see — a device in two
85
+ * homes or a link across a home's boundary. What the caller cannot see never refuses it: a
86
+ * device a resident owns that would leave its owner's home, enter a home not theirs or sit
87
+ * in two homes is taken out of the moving space instead — staying in its owner's home,
88
+ * filed on the apartment, where it was in it — and any link it would carry across a
89
+ * boundary is removed. Changing the type of a space that has members needs
90
+ * ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN, who see them, and is refused if it would
91
+ * leave a RESIDENT membership on a room.
92
+ *
93
+ * Every descriptive field carries explicit presence: absent means leave it alone, present
94
+ * means set it to this — including to the empty string, which is how a description is
95
+ * cleared.
64
96
  *
65
97
  * @generated from message kusinta.iot.webrtc.v1.UpdateSpace
66
98
  */
@@ -111,6 +143,15 @@ export declare type UpdateSpace = Message<"kusinta.iot.webrtc.v1.UpdateSpace"> &
111
143
  value: boolean;
112
144
  case: "detach";
113
145
  } | { case: undefined; value?: undefined };
146
+
147
+ /**
148
+ * An IANA time zone name, e.g. "Europe/Stockholm". Accepted only on a building — a
149
+ * top-level space — and refused on any other. Unset leaves it unchanged; the empty
150
+ * string clears it.
151
+ *
152
+ * @generated from field: optional string time_zone = 8;
153
+ */
154
+ timeZone?: string | undefined;
114
155
  };
115
156
 
116
157
  /**
@@ -122,7 +163,8 @@ export declare const UpdateSpaceSchema: GenMessage<UpdateSpace>;
122
163
  /**
123
164
  * Deletes a space. Refused if the space still holds devices or sub-spaces unless
124
165
  * cascade is set, so that emptying a building is always something the caller
125
- * asked for rather than something a stale client did by accident.
166
+ * asked for rather than something a stale client did by accident. Deleting a home, or
167
+ * anything in one, is guarded as UpdateSpace is.
126
168
  *
127
169
  * @generated from message kusinta.iot.webrtc.v1.DeleteSpace
128
170
  */
@@ -145,10 +187,17 @@ export declare type DeleteSpace = Message<"kusinta.iot.webrtc.v1.DeleteSpace"> &
145
187
  export declare const DeleteSpaceSchema: GenMessage<DeleteSpace>;
146
188
 
147
189
  /**
148
- * Adds a user to a space, granting them reach of it and everything beneath it.
190
+ * Adds a user to a space, granting them reach of it and everything beneath it — except
191
+ * that a RESIDENT membership reaches no home beneath it (see access.v1.MembershipRelation).
149
192
  * The user need not be known to the gateway beforehand — identities are minted by
150
193
  * the token issuer, and this records that one of them belongs here.
151
194
  *
195
+ * Assigning a user who is already a member changes their relation to the space.
196
+ * RESIDENT is refused on a room; see access.v1.MembershipRelation.
197
+ *
198
+ * Who may change who belongs to a home is restricted by the gateway; a caller not allowed is
199
+ * refused as NOT_ENTITLED. Residents see who is filed on their home in Space.members.
200
+ *
152
201
  * @generated from message kusinta.iot.webrtc.v1.AssignUserToSpace
153
202
  */
154
203
  export declare type AssignUserToSpace = Message<"kusinta.iot.webrtc.v1.AssignUserToSpace"> & {
@@ -161,6 +210,15 @@ export declare type AssignUserToSpace = Message<"kusinta.iot.webrtc.v1.AssignUse
161
210
  * @generated from field: kusinta.iot.identity.v1.UserId user_id = 2;
162
211
  */
163
212
  userId?: UserId | undefined;
213
+
214
+ /**
215
+ * How the user stands to the space — whether they live there or are there for the
216
+ * building. Required: UNSPECIFIED is refused, never defaulted. See
217
+ * access.v1.MembershipRelation for what each lets a member see of a home.
218
+ *
219
+ * @generated from field: kusinta.iot.access.v1.MembershipRelation relation = 4;
220
+ */
221
+ relation: MembershipRelation;
164
222
  };
165
223
 
166
224
  /**
@@ -173,6 +231,8 @@ export declare const AssignUserToSpaceSchema: GenMessage<AssignUserToSpace>;
173
231
  * Removes a user's membership of a space. Losing reach also drops whatever the
174
232
  * user was streaming from it, announced by LivePermissionUpdate.
175
233
  *
234
+ * Removing someone else from a home is guarded as assigning is.
235
+ *
176
236
  * @generated from message kusinta.iot.webrtc.v1.RemoveUserFromSpace
177
237
  */
178
238
  export declare type RemoveUserFromSpace = Message<"kusinta.iot.webrtc.v1.RemoveUserFromSpace"> & {
@@ -197,6 +257,12 @@ export declare const RemoveUserFromSpaceSchema: GenMessage<RemoveUserFromSpace>;
197
257
  * Files a device into a space. A device may sit in several spaces at once; this
198
258
  * is additive, and filing a device where it already sits is a no-op.
199
259
  *
260
+ * Into a home go only the building's own devices and devices its residents own, and a
261
+ * device belongs to one home at most; filing into, out of or beside a home is guarded by
262
+ * the gateway. A caller not allowed is refused as NOT_ENTITLED, and filing that would leave
263
+ * a link the caller can see across a home's boundary is refused whatever the caller; one
264
+ * they cannot see is removed instead.
265
+ *
200
266
  * @generated from message kusinta.iot.webrtc.v1.PlaceDeviceInSpace
201
267
  */
202
268
  export declare type PlaceDeviceInSpace = Message<"kusinta.iot.webrtc.v1.PlaceDeviceInSpace"> & {
@@ -221,6 +287,9 @@ export declare const PlaceDeviceInSpaceSchema: GenMessage<PlaceDeviceInSpace>;
221
287
  * Takes a device out of one space, leaving any others intact. A device in no
222
288
  * space and with no owner is unfiled, and visible only to the administrator.
223
289
  *
290
+ * Taking a device out of a home is guarded as PlaceDeviceInSpace is, and removes its links
291
+ * to devices still in the home.
292
+ *
224
293
  * @generated from message kusinta.iot.webrtc.v1.RemoveDeviceFromSpace
225
294
  */
226
295
  export declare type RemoveDeviceFromSpace = Message<"kusinta.iot.webrtc.v1.RemoveDeviceFromSpace"> & {
@@ -244,7 +313,12 @@ export declare const RemoveDeviceFromSpaceSchema: GenMessage<RemoveDeviceFromSpa
244
313
  /**
245
314
  * Takes ownership of a device. Ownership is reach in its own right: an owner may
246
315
  * see and control their device whatever their gateway-wide role permits, and may
247
- * file it into spaces they belong to.
316
+ * file it into spaces they belong to, and the rooms of a home they live in — though into a
317
+ * home only if they live there (see PlaceDeviceInSpace).
318
+ *
319
+ * Only a RESIDENT claim makes the caller the owner. A COMPANY claim records that the
320
+ * building owns the device, names no person, and grants the caller no reach. Claims of a
321
+ * device in a home, or of one already claimed, are restricted by the gateway.
248
322
  *
249
323
  * @generated from message kusinta.iot.webrtc.v1.ClaimDevice
250
324
  */
@@ -265,8 +339,18 @@ export declare type ClaimDevice = Message<"kusinta.iot.webrtc.v1.ClaimDevice"> &
265
339
  initialSpaceId?: SpaceId | undefined;
266
340
 
267
341
  /**
268
- * Evidence the claimant is standing at the device: the serial printed on it,
269
- * matched against DeviceDescriptor.serial_number. Required precisely when the
342
+ * Evidence the claimant is standing at the device: the identifier printed on it,
343
+ * matched against DeviceDescriptor.serial_number.
344
+ *
345
+ * The match is by SUFFIX, because what a connector announces is not always the whole
346
+ * of what is printed and the announced value is commonly the tail of the printed one.
347
+ * Both sides are normalised first — lowercased, with whitespace and ASCII hyphens
348
+ * removed, since a label prints the value in groups and a scan does not — and the proof
349
+ * is accepted when what remains ends with the announced serial. Spelled out because two
350
+ * gateways normalising differently would accept different proofs for the same device.
351
+ *
352
+ * A serial shorter than eight characters cannot be proved at all: under a suffix rule a
353
+ * short one is proved by almost anything ending with it. Required precisely when the
270
354
  * caller cannot already reach the device, which is the ordinary case for a
271
355
  * resident claiming something they just bought — an unfiled device is invisible
272
356
  * to them, so possession is the only thing left that can distinguish them from
@@ -286,8 +370,9 @@ export declare type ClaimDevice = Message<"kusinta.iot.webrtc.v1.ClaimDevice"> &
286
370
  export declare const ClaimDeviceSchema: GenMessage<ClaimDevice>;
287
371
 
288
372
  /**
289
- * Gives up ownership. The device keeps whatever space filing it has; if it has
290
- * none it becomes unfiled.
373
+ * Gives up ownership. The device keeps whatever space filing it has, except that a device in
374
+ * a home stays filed in the home alone, as one of the building's own devices there — as
375
+ * when its owner moves out; if it has none it becomes unfiled.
291
376
  *
292
377
  * @generated from message kusinta.iot.webrtc.v1.ReleaseDevice
293
378
  */
@@ -304,6 +389,66 @@ export declare type ReleaseDevice = Message<"kusinta.iot.webrtc.v1.ReleaseDevice
304
389
  */
305
390
  export declare const ReleaseDeviceSchema: GenMessage<ReleaseDevice>;
306
391
 
392
+ /**
393
+ * Registers a device with the system that will admit it, so that it can join
394
+ * later. For a technology where a device is enrolled as a record rather than
395
+ * adopted during a window — see common.v1.PairingWindow for the other case, where
396
+ * something joins a hub during a window and the arrival is attributed to the
397
+ * caller. A LoRaWAN device has no window: it is written into a network server and
398
+ * joins whenever it is next powered, which may be minutes, days, or never.
399
+ *
400
+ * Answered with the ordinary ManagementAck. A provision writes a record and returns
401
+ * nothing to show; the device itself is announced by device_added if and when it
402
+ * joins, the same path every other device takes — which is why this adds no
403
+ * ManagementResult arm. A new result arm is a compile error in a consumer that
404
+ * matches the result exhaustively; a new request arm is not.
405
+ *
406
+ * Registering and owning stay two operations. ClaimDevice records the caller and
407
+ * carries possession_proof, so a device that has not joined yet is still claimable
408
+ * by whoever holds it — and because the connector derives the device id and the
409
+ * serial from the identifier here, that claim can be made before the join.
410
+ *
411
+ * Provisioning the same identifier twice is an upsert: it replaces the credentials
412
+ * rather than being refused as a conflict, so correcting a mistyped key does not
413
+ * require removing the device first. Removing a record is a distinct act from
414
+ * giving up ownership (ReleaseDevice) and is left to a later operation.
415
+ *
416
+ * @generated from message kusinta.iot.webrtc.v1.ProvisionDevice
417
+ */
418
+ export declare type ProvisionDevice = Message<"kusinta.iot.webrtc.v1.ProvisionDevice"> & {
419
+ /**
420
+ * Required, unlike a pairing window's connector target. A registration is written
421
+ * to one specific registry; there is no sensible "open them all and see what
422
+ * joins". The app names it from the connector enumeration, targeting a connector
423
+ * that declares ConnectorInfo.supports_provisioning.
424
+ *
425
+ * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
426
+ */
427
+ connectorId?: ConnectorId | undefined;
428
+
429
+ /**
430
+ * What the registry needs to admit the device, which differs entirely by
431
+ * technology — a oneof per technology rather than a flat set of fields, for the
432
+ * reason LinkSettings gives: the second technology to arrive must not turn this
433
+ * into a bag of unrelated optionals named after the first.
434
+ *
435
+ * @generated from oneof kusinta.iot.webrtc.v1.ProvisionDevice.credentials
436
+ */
437
+ credentials: {
438
+ /**
439
+ * @generated from field: kusinta.iot.vendor.lorawan.v1.LorawanProvisioning lorawan = 2;
440
+ */
441
+ value: LorawanProvisioning;
442
+ case: "lorawan";
443
+ } | { case: undefined; value?: undefined };
444
+ };
445
+
446
+ /**
447
+ * Describes the message kusinta.iot.webrtc.v1.ProvisionDevice.
448
+ * Use `create(ProvisionDeviceSchema)` to create a new message.
449
+ */
450
+ export declare const ProvisionDeviceSchema: GenMessage<ProvisionDevice>;
451
+
307
452
  /**
308
453
  * Asks for the spaces the caller can reach. Unset root_space_id means all of
309
454
  * them, which for most users is one apartment and for an administrator is the
@@ -333,7 +478,9 @@ export declare const ListSpacesSchema: GenMessage<ListSpaces>;
333
478
  *
334
479
  * device_ids on each Space are filtered to what the caller may see. An
335
480
  * unfiltered tree would list every device on the gateway by id, which is the
336
- * enumeration channel the snapshot filter exists to close.
481
+ * enumeration channel the snapshot filter exists to close. To a caller who sees a home as
482
+ * service, what is new in it is listed as it happens and what is gone at once, its members
483
+ * included where they are shown (see Space.members).
337
484
  *
338
485
  * @generated from message kusinta.iot.webrtc.v1.SpaceTree
339
486
  */
@@ -373,7 +520,671 @@ export declare const ManagementAckSchema: GenMessage<ManagementAck>;
373
520
  * message kind, so these can never be gated by a table keyed on the envelope case
374
521
  * the way device messages are. Keeping them behind one case means one place that
375
522
  * must authorize, and one refusal path that must not leak whether a target exists.
523
+ * Links one device to another, so the sender leads the receiver. The gateway
524
+ * resolves which underlying connections that needs and asks the connector for
525
+ * them; a caller names two devices and what the link is for.
526
+ *
527
+ * Authorized against both ends, and not symmetrically. Leading a device is a
528
+ * standing grant of control over it, so the receiver requires ownership or a
529
+ * servicing role. The sender's requirement depends on the mode: a gateway-kept
530
+ * link only reads what the caller can already see, while a device-to-device one
531
+ * writes configuration to the sender and spends its battery, which is a change
532
+ * to someone else's hardware.
533
+ *
534
+ * In a home it is the other way round: links between its devices are its residents' to
535
+ * make, change and remove, and a caller who reaches it as service is refused as
536
+ * NOT_ENTITLED. A link between a device in a home and one outside it is refused to anyone.
537
+ * The same holds for UpdateDeviceLink and RemoveDeviceLink.
538
+ *
539
+ * @generated from message kusinta.iot.webrtc.v1.CreateDeviceLink
540
+ */
541
+ export declare type CreateDeviceLink = Message<"kusinta.iot.webrtc.v1.CreateDeviceLink"> & {
542
+ /**
543
+ * @generated from field: kusinta.iot.identity.v1.DeviceId sender = 1;
544
+ */
545
+ sender?: DeviceId | undefined;
546
+
547
+ /**
548
+ * @generated from field: kusinta.iot.identity.v1.DeviceId receiver = 2;
549
+ */
550
+ receiver?: DeviceId | undefined;
551
+
552
+ /**
553
+ * @generated from field: kusinta.iot.link.v1.LinkFunction function = 3;
554
+ */
555
+ function: LinkFunction;
556
+
557
+ /**
558
+ * Unset lets the gateway choose, which prefers a device-to-device link where
559
+ * one can be brokered: it survives a gateway outage and runs at the devices'
560
+ * own rate. Name one to override that.
561
+ *
562
+ * @generated from field: kusinta.iot.link.v1.LinkMode mode = 4;
563
+ */
564
+ mode: LinkMode;
565
+
566
+ /**
567
+ * How a gateway-kept link is to behave, set as it is made. Carried here as
568
+ * well as on UpdateDeviceLink so that a link does not have to exist in a
569
+ * configured-by-nobody state first — a soft climate link created without a
570
+ * target is one that holds the room at nothing until a second request
571
+ * arrives, and every reader would have to handle that transient forever.
572
+ *
573
+ * Unset is still allowed and still means unconfigured, since a hard link has
574
+ * nothing to configure and a caller may genuinely not know the target yet.
575
+ *
576
+ * @generated from field: kusinta.iot.link.v1.LinkSettings settings = 5;
577
+ */
578
+ settings?: LinkSettings | undefined;
579
+ };
580
+
581
+ /**
582
+ * Describes the message kusinta.iot.webrtc.v1.CreateDeviceLink.
583
+ * Use `create(CreateDeviceLinkSchema)` to create a new message.
584
+ */
585
+ export declare const CreateDeviceLinkSchema: GenMessage<CreateDeviceLink>;
586
+
587
+ /**
588
+ * Removes a link. Note that on at least one vendor, removing a link disturbs the
589
+ * receiver's own settings and the connector must repair them, so this is not the
590
+ * no-op it appears to be.
591
+ *
592
+ * @generated from message kusinta.iot.webrtc.v1.RemoveDeviceLink
593
+ */
594
+ export declare type RemoveDeviceLink = Message<"kusinta.iot.webrtc.v1.RemoveDeviceLink"> & {
595
+ /**
596
+ * @generated from field: string link_id = 1;
597
+ */
598
+ linkId: string;
599
+ };
600
+
601
+ /**
602
+ * Describes the message kusinta.iot.webrtc.v1.RemoveDeviceLink.
603
+ * Use `create(RemoveDeviceLinkSchema)` to create a new message.
604
+ */
605
+ export declare const RemoveDeviceLinkSchema: GenMessage<RemoveDeviceLink>;
606
+
607
+ /**
608
+ * Changes how a gateway-kept link behaves — for a climate lead, the temperature
609
+ * it is to hold.
610
+ *
611
+ * Refused on a link that has nothing to configure — see LinkSettings — rather
612
+ * than accepted as a no-op, so that a caller who has mistaken which link they
613
+ * are holding is told.
614
+ *
615
+ * Authorized against both ends, as creating and removing the link are: deciding
616
+ * what temperature a room is held at is directing a device, not adjusting one,
617
+ * so it takes ownership of the ends or a servicing role, not the permission to
618
+ * turn a thermostat up. In a home it is its residents' instead (see CreateDeviceLink).
619
+ *
620
+ * @generated from message kusinta.iot.webrtc.v1.UpdateDeviceLink
621
+ */
622
+ export declare type UpdateDeviceLink = Message<"kusinta.iot.webrtc.v1.UpdateDeviceLink"> & {
623
+ /**
624
+ * @generated from field: string link_id = 1;
625
+ */
626
+ linkId: string;
627
+
628
+ /**
629
+ * Replaces the link's settings rather than patching them: the settings of one
630
+ * function are few and are set together, so there is no half-update worth
631
+ * expressing. This is why it does not follow UpdateSpace's per-field optional
632
+ * shape, which exists for a message whose fields genuinely move alone.
633
+ *
634
+ * Unset is refused rather than being given a meaning. It would have to mean
635
+ * either "leave everything alone", making the request a no-op, or "clear the
636
+ * settings", which is the one thing that reads like an accident — and the
637
+ * wire cannot tell those two callers apart.
638
+ *
639
+ * @generated from field: kusinta.iot.link.v1.LinkSettings settings = 2;
640
+ */
641
+ settings?: LinkSettings | undefined;
642
+ };
643
+
644
+ /**
645
+ * Describes the message kusinta.iot.webrtc.v1.UpdateDeviceLink.
646
+ * Use `create(UpdateDeviceLinkSchema)` to create a new message.
647
+ */
648
+ export declare const UpdateDeviceLinkSchema: GenMessage<UpdateDeviceLink>;
649
+
650
+ /**
651
+ * Lists links. Unset device_id lists every link among devices the caller can
652
+ * reach; naming one narrows it to that device's own, in either direction.
653
+ *
654
+ * A link with an end in a home reaches a caller who sees it as service with
655
+ * DeviceLink.details_withheld set, and what that withholds unset — a new link
656
+ * as it is made, a removed one at once — and not at all when either end is a
657
+ * device a resident owns.
658
+ *
659
+ * @generated from message kusinta.iot.webrtc.v1.ListDeviceLinks
660
+ */
661
+ export declare type ListDeviceLinks = Message<"kusinta.iot.webrtc.v1.ListDeviceLinks"> & {
662
+ /**
663
+ * @generated from field: kusinta.iot.identity.v1.DeviceId device_id = 1;
664
+ */
665
+ deviceId?: DeviceId | undefined;
666
+ };
667
+
668
+ /**
669
+ * Describes the message kusinta.iot.webrtc.v1.ListDeviceLinks.
670
+ * Use `create(ListDeviceLinksSchema)` to create a new message.
671
+ */
672
+ export declare const ListDeviceLinksSchema: GenMessage<ListDeviceLinks>;
673
+
674
+ /**
675
+ * Sets the temperature a room is to be held at.
676
+ *
677
+ * Authorized as adjusting, not directing: WRITE on the room is enough. It is the same act
678
+ * as turning a radiator's knob; setting up what the room obeys is ConfigureRoomClimate,
679
+ * and stays with owners, except the lock in a home.
680
+ *
681
+ * In a home, only its residents may set it; a caller who reaches the room as service is
682
+ * refused as NOT_ENTITLED.
683
+ *
684
+ * Clamped to the room's limits rather than refused outside them, and the clamped value is
685
+ * what the room's RoomClimate then reports.
686
+ *
687
+ * @generated from message kusinta.iot.webrtc.v1.SetRoomTarget
688
+ */
689
+ export declare type SetRoomTarget = Message<"kusinta.iot.webrtc.v1.SetRoomTarget"> & {
690
+ /**
691
+ * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 1;
692
+ */
693
+ roomId?: SpaceId | undefined;
694
+
695
+ /**
696
+ * Unset clears the target: the room goes back to having none (NO_TARGET) and its
697
+ * devices to their own behaviour. With presence, so that a request that forgot the
698
+ * field is not read as 0 °C and clamped to the room's minimum.
699
+ *
700
+ * @generated from field: optional sint32 target_centidegrees = 2;
701
+ */
702
+ targetCentidegrees?: number | undefined;
703
+ };
704
+
705
+ /**
706
+ * Describes the message kusinta.iot.webrtc.v1.SetRoomTarget.
707
+ * Use `create(SetRoomTargetSchema)` to create a new message.
708
+ */
709
+ export declare const SetRoomTargetSchema: GenMessage<SetRoomTarget>;
710
+
711
+ /**
712
+ * The sensors a room measures with, in order of preference. A message of its own so that
713
+ * "leave the sensors alone" (unset) differs from "set" on the wire. It orders the
714
+ * building's sensors only (see climate.v1.RoomClimate.sensor_ids); set but empty returns
715
+ * them to the default, every building temperature sensor filed in the room in filing
716
+ * order.
717
+ *
718
+ * @generated from message kusinta.iot.webrtc.v1.RoomSensors
719
+ */
720
+ export declare type RoomSensors = Message<"kusinta.iot.webrtc.v1.RoomSensors"> & {
721
+ /**
722
+ * @generated from field: repeated kusinta.iot.identity.v1.DeviceId sensor_ids = 1;
723
+ */
724
+ sensorIds: DeviceId[];
725
+ };
726
+
727
+ /**
728
+ * Describes the message kusinta.iot.webrtc.v1.RoomSensors.
729
+ * Use `create(RoomSensorsSchema)` to create a new message.
730
+ */
731
+ export declare const RoomSensorsSchema: GenMessage<RoomSensors>;
732
+
733
+ /**
734
+ * A room's limits. A message of its own so that "leave the limits alone" (unset) differs
735
+ * from "set" — and, set, an unset bound inside it removes that bound, which a bare
736
+ * optional on the request could not say.
737
+ *
738
+ * @generated from message kusinta.iot.webrtc.v1.RoomLimits
739
+ */
740
+ export declare type RoomLimits = Message<"kusinta.iot.webrtc.v1.RoomLimits"> & {
741
+ /**
742
+ * @generated from field: optional sint32 min_centidegrees = 1;
743
+ */
744
+ minCentidegrees?: number | undefined;
745
+
746
+ /**
747
+ * @generated from field: optional sint32 max_centidegrees = 2;
748
+ */
749
+ maxCentidegrees?: number | undefined;
750
+ };
751
+
752
+ /**
753
+ * Describes the message kusinta.iot.webrtc.v1.RoomLimits.
754
+ * Use `create(RoomLimitsSchema)` to create a new message.
755
+ */
756
+ export declare const RoomLimitsSchema: GenMessage<RoomLimits>;
757
+
758
+ /**
759
+ * Configures what a room obeys: its limits, its sensors, and whether a change made by
760
+ * hand at one of its devices counts. Authorized as directing — owners and filing roles —
761
+ * because this decides what everybody in the room can do.
762
+ *
763
+ * One exception: in a home, lock_device_controls is its residents' alone. They may send
764
+ * this request with nothing else set. Outside homes the lock is the owner's, as the rest
765
+ * is. A request that sets anything its caller may not — the lock in a home for service;
766
+ * anything but the lock in a home, or the lock outside one, for a caller with neither
767
+ * ROLE_PROPERTY_OWNER nor a filing role — is refused whole as NOT_ENTITLED, so nothing of
768
+ * it applies. sensors orders only the building's own
769
+ * sensors (see RoomClimate.sensor_ids).
770
+ *
771
+ * Each field moves alone, as on UpdateSpace: unset leaves it as it is.
772
+ *
773
+ * @generated from message kusinta.iot.webrtc.v1.ConfigureRoomClimate
774
+ */
775
+ export declare type ConfigureRoomClimate = Message<"kusinta.iot.webrtc.v1.ConfigureRoomClimate"> & {
776
+ /**
777
+ * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 1;
778
+ */
779
+ roomId?: SpaceId | undefined;
780
+
781
+ /**
782
+ * Replaces both bounds; see RoomLimits.
783
+ *
784
+ * @generated from field: kusinta.iot.webrtc.v1.RoomLimits limits = 2;
785
+ */
786
+ limits?: RoomLimits | undefined;
787
+
788
+ /**
789
+ * Only the building's sensors filed in this room; any other — including a sensor a
790
+ * resident owns — is refused, the same way whether or not it exists.
791
+ *
792
+ * @generated from field: kusinta.iot.webrtc.v1.RoomSensors sensors = 3;
793
+ */
794
+ sensors?: RoomSensors | undefined;
795
+
796
+ /**
797
+ * @generated from field: optional bool lock_device_controls = 4;
798
+ */
799
+ lockDeviceControls?: boolean | undefined;
800
+ };
801
+
802
+ /**
803
+ * Describes the message kusinta.iot.webrtc.v1.ConfigureRoomClimate.
804
+ * Use `create(ConfigureRoomClimateSchema)` to create a new message.
805
+ */
806
+ export declare const ConfigureRoomClimateSchema: GenMessage<ConfigureRoomClimate>;
807
+
808
+ /**
809
+ * Switches a mode on a space on, or off with kind UNSPECIFIED. WRITE on the space.
810
+ * Switching one on needs setback_centidegrees; a mode with nothing to set back to is
811
+ * refused. Switching one on is refused on a room inside an apartment, whose rooms follow
812
+ * the apartment's mode alone; such a room carries none (see climate.v1.ClimateMode), and
813
+ * switching one off there is accepted and does nothing — for those who may switch modes in
814
+ * that home at all, which is checked first: anyone else is refused as NOT_ENTITLED.
815
+ *
816
+ * In a home, only its residents may switch one on or off: whether a home stands empty is
817
+ * theirs to say. A caller who reaches it as service is refused as NOT_ENTITLED — except
818
+ * that, while the home has no resident, ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN may
819
+ * switch off a mode that is on and whose setter is not a resident, so that no mode
820
+ * outlives everyone who could end it. Any other switch-off from them — no mode on, or one
821
+ * that is a resident's — is accepted and does nothing, so the answer tells them nothing of
822
+ * whether a mode was on or whether anyone has moved in.
823
+ *
824
+ * @generated from message kusinta.iot.webrtc.v1.SetClimateMode
825
+ */
826
+ export declare type SetClimateMode = Message<"kusinta.iot.webrtc.v1.SetClimateMode"> & {
827
+ /**
828
+ * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
829
+ */
830
+ spaceId?: SpaceId | undefined;
831
+
832
+ /**
833
+ * @generated from field: kusinta.iot.climate.v1.ClimateModeKind kind = 2;
834
+ */
835
+ kind: ClimateModeKind;
836
+
837
+ /**
838
+ * @generated from field: optional sint32 setback_centidegrees = 3;
839
+ */
840
+ setbackCentidegrees?: number | undefined;
841
+
842
+ /**
843
+ * HOLIDAY only; both required there. Refused on AWAY.
844
+ *
845
+ * @generated from field: google.protobuf.Timestamp starts_at = 4;
846
+ */
847
+ startsAt?: Timestamp | undefined;
848
+
849
+ /**
850
+ * @generated from field: google.protobuf.Timestamp ends_at = 5;
851
+ */
852
+ endsAt?: Timestamp | undefined;
853
+ };
854
+
855
+ /**
856
+ * Describes the message kusinta.iot.webrtc.v1.SetClimateMode.
857
+ * Use `create(SetClimateModeSchema)` to create a new message.
858
+ */
859
+ export declare const SetClimateModeSchema: GenMessage<SetClimateMode>;
860
+
861
+ /**
862
+ * Lists the room climates and modes a caller may see. Unset root_space_id lists every
863
+ * one the caller can reach; naming a space narrows it to that space and those below.
864
+ *
865
+ * A caller who reaches a room inside an apartment as service gets it with
866
+ * RoomClimate.state_withheld set — what is new as it happens, what is gone at once — and
867
+ * gets no ClimateMode set on that apartment or its rooms.
376
868
  *
869
+ * @generated from message kusinta.iot.webrtc.v1.ListRoomClimates
870
+ */
871
+ export declare type ListRoomClimates = Message<"kusinta.iot.webrtc.v1.ListRoomClimates"> & {
872
+ /**
873
+ * @generated from field: kusinta.iot.identity.v1.SpaceId root_space_id = 1;
874
+ */
875
+ rootSpaceId?: SpaceId | undefined;
876
+ };
877
+
878
+ /**
879
+ * Describes the message kusinta.iot.webrtc.v1.ListRoomClimates.
880
+ * Use `create(ListRoomClimatesSchema)` to create a new message.
881
+ */
882
+ export declare const ListRoomClimatesSchema: GenMessage<ListRoomClimates>;
883
+
884
+ /**
885
+ * Reads a room's history, answered with a climate.v1.RoomHistory of fixed 15-minute
886
+ * buckets aligned to UTC quarter hours (:00, :15, :30, :45). Needs READ on the room.
887
+ *
888
+ * The range is half-open: a bucket is returned when from_time <= at < to_time, so
889
+ * back-to-back windows neither repeat nor skip a bucket. Unset to_time means now;
890
+ * unset from_time means RoomHistory.kept_from. Both are clamped to [kept_from, now].
891
+ *
892
+ * A room in a home is readable by its residents only, and only from the start of their
893
+ * current residency (see access.v1.MembershipRelation). A caller who reaches it as service is
894
+ * refused as NOT_ENTITLED; one who reaches the apartment itself has
895
+ * GetApartmentClimateSummary instead.
896
+ *
897
+ * @generated from message kusinta.iot.webrtc.v1.GetRoomHistory
898
+ */
899
+ export declare type GetRoomHistory = Message<"kusinta.iot.webrtc.v1.GetRoomHistory"> & {
900
+ /**
901
+ * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 1;
902
+ */
903
+ roomId?: SpaceId | undefined;
904
+
905
+ /**
906
+ * @generated from field: google.protobuf.Timestamp from_time = 2;
907
+ */
908
+ fromTime?: Timestamp | undefined;
909
+
910
+ /**
911
+ * @generated from field: google.protobuf.Timestamp to_time = 3;
912
+ */
913
+ toTime?: Timestamp | undefined;
914
+ };
915
+
916
+ /**
917
+ * Describes the message kusinta.iot.webrtc.v1.GetRoomHistory.
918
+ * Use `create(GetRoomHistorySchema)` to create a new message.
919
+ */
920
+ export declare const GetRoomHistorySchema: GenMessage<GetRoomHistory>;
921
+
922
+ /**
923
+ * What the parties who do not live in a private space learn of it — the answer to a
924
+ * resident asking who can see what in their home, in reply to GetPrivacyDisclosure.
925
+ *
926
+ * It states the policy, the kinds of party it applies to now and the people counted under
927
+ * each (ServiceParty.names): a resident learns which technicians can see the battery of
928
+ * their radiator valve. The names say who has reach, never where anyone lives.
929
+ *
930
+ * @generated from message kusinta.iot.webrtc.v1.PrivacyDisclosure
931
+ */
932
+ export declare type PrivacyDisclosure = Message<"kusinta.iot.webrtc.v1.PrivacyDisclosure"> & {
933
+ /**
934
+ * An apartment, or a room in one.
935
+ *
936
+ * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
937
+ */
938
+ spaceId?: SpaceId | undefined;
939
+
940
+ /**
941
+ * The kinds of party who see this space, or any part of it, as service now — or would
942
+ * through another membership, were they not its residents — each role once, with what
943
+ * that role brings here. Each party is listed under every role it holds other than
944
+ * ROLE_RESIDENT, and sees what its entries say together; one with no other role, or whose
945
+ * role the gateway has not yet learnt, counts as ROLE_UNSPECIFIED. ROLE_GATEWAY_ADMIN is
946
+ * always listed, and ROLE_PROPERTY_OWNER whenever anyone holds it, wherever they are
947
+ * filed: both may file themselves on the home. So the list reads the same whether or not
948
+ * anyone lives in the home, and never understates who has reach or what they see. Devices a resident
949
+ * owns are not shown to service at all.
950
+ *
951
+ * @generated from field: repeated kusinta.iot.webrtc.v1.ServiceParty service_parties = 5;
952
+ */
953
+ serviceParties: ServiceParty[];
954
+
955
+ /**
956
+ * How finely the space's climate is summarised for service, as means over periods of
957
+ * this length (climate.v1.ApartmentClimateSummary). UNSPECIFIED: no summary is given.
958
+ * The gateway's own setting, WEEK unless it is configured otherwise; no operation in this
959
+ * contract changes it. A change applies to periods that open after it: service is given
960
+ * no period that opened before the last change.
961
+ *
962
+ * @generated from field: kusinta.iot.climate.v1.ClimateSummaryPeriod climate_summary_period = 4;
963
+ */
964
+ climateSummaryPeriod: ClimateSummaryPeriod;
965
+
966
+ /**
967
+ * The name of the organisation that owns the property, when one is recorded
968
+ * (SetOwnerOrganisation). Its organisation number is not given here.
969
+ *
970
+ * @generated from field: string owner_organisation_name = 6;
971
+ */
972
+ ownerOrganisationName: string;
973
+
974
+ /**
975
+ * Set when ServiceParty.names are not given to this caller, so that empty lists are not
976
+ * read as nobody being named. Names are given to the home's own residents and to a
977
+ * caller holding ROLE_GATEWAY_ADMIN or ROLE_PROPERTY_OWNER, and withheld from anyone
978
+ * else: a technician who reaches the home learns the kinds of party, not who they are.
979
+ *
980
+ * @generated from field: bool names_withheld = 7;
981
+ */
982
+ namesWithheld: boolean;
983
+ };
984
+
985
+ /**
986
+ * Describes the message kusinta.iot.webrtc.v1.PrivacyDisclosure.
987
+ * Use `create(PrivacyDisclosureSchema)` to create a new message.
988
+ */
989
+ export declare const PrivacyDisclosureSchema: GenMessage<PrivacyDisclosure>;
990
+
991
+ /**
992
+ * One kind of party with service reach of a home, and what it sees there. Every service
993
+ * party sees the same kinds of thing of the part of the home it reaches — a whole
994
+ * ServiceStatus, nothing withheld from it — so signals differ between parties only in
995
+ * RESIDENTS. How much of the home that part is, a room or all of it, the disclosure does
996
+ * not say.
997
+ *
998
+ * @generated from message kusinta.iot.webrtc.v1.ServiceParty
999
+ */
1000
+ export declare type ServiceParty = Message<"kusinta.iot.webrtc.v1.ServiceParty"> & {
1001
+ /**
1002
+ * @generated from field: kusinta.iot.access.v1.Role role = 1;
1003
+ */
1004
+ role: Role;
1005
+
1006
+ /**
1007
+ * @generated from field: repeated kusinta.iot.access.v1.ServiceSignal signals = 2;
1008
+ */
1009
+ signals: ServiceSignal[];
1010
+
1011
+ /**
1012
+ * Each person counted under this role, by the name they gave their account
1013
+ * (AppTokenClaims.name), once each: everyone holding ROLE_GATEWAY_ADMIN or
1014
+ * ROLE_PROPERTY_OWNER, the registering administrator included once the gateway has seen
1015
+ * their token, and everyone else counted here by a SERVICE membership. A person counted
1016
+ * under several roles is named under each. An empty string stands for a person whose name
1017
+ * the gateway has not learnt, so the list is as long as the number of people. Self-chosen,
1018
+ * so the app shows it as the name they gave rather than as a verified identity. Empty for
1019
+ * every party when PrivacyDisclosure.names_withheld is set.
1020
+ *
1021
+ * @generated from field: repeated string names = 3;
1022
+ */
1023
+ names: string[];
1024
+ };
1025
+
1026
+ /**
1027
+ * Describes the message kusinta.iot.webrtc.v1.ServiceParty.
1028
+ * Use `create(ServicePartySchema)` to create a new message.
1029
+ */
1030
+ export declare const ServicePartySchema: GenMessage<ServiceParty>;
1031
+
1032
+ /**
1033
+ * Asks what the parties who do not live in a space learn of it, answered with a
1034
+ * PrivacyDisclosure. For an apartment or a room in one, and refused on any other
1035
+ * space. Needs READ on the space.
1036
+ *
1037
+ * @generated from message kusinta.iot.webrtc.v1.GetPrivacyDisclosure
1038
+ */
1039
+ export declare type GetPrivacyDisclosure = Message<"kusinta.iot.webrtc.v1.GetPrivacyDisclosure"> & {
1040
+ /**
1041
+ * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
1042
+ */
1043
+ spaceId?: SpaceId | undefined;
1044
+ };
1045
+
1046
+ /**
1047
+ * Describes the message kusinta.iot.webrtc.v1.GetPrivacyDisclosure.
1048
+ * Use `create(GetPrivacyDisclosureSchema)` to create a new message.
1049
+ */
1050
+ export declare const GetPrivacyDisclosureSchema: GenMessage<GetPrivacyDisclosure>;
1051
+
1052
+ /**
1053
+ * Reads an apartment's climate as means over whole periods, answered with a
1054
+ * climate.v1.ApartmentClimateSummary. Needs READ on the apartment itself. Refused on a
1055
+ * space that is not an apartment, and while the building's time zone (Space.time_zone) is
1056
+ * unknown, since periods are cut at its midnights.
1057
+ *
1058
+ * The range is half-open over the periods' starts: a period is returned when from_time <=
1059
+ * starts_at < to_time. Unset from_time means kept_from; unset to_time means now. Both are
1060
+ * clamped to [kept_from, the start of the period running now — or now, if none is] (see
1061
+ * ApartmentClimateSummary).
1062
+ *
1063
+ * @generated from message kusinta.iot.webrtc.v1.GetApartmentClimateSummary
1064
+ */
1065
+ export declare type GetApartmentClimateSummary = Message<"kusinta.iot.webrtc.v1.GetApartmentClimateSummary"> & {
1066
+ /**
1067
+ * @generated from field: kusinta.iot.identity.v1.SpaceId apartment_id = 1;
1068
+ */
1069
+ apartmentId?: SpaceId | undefined;
1070
+
1071
+ /**
1072
+ * Unset asks for the period the apartment's privacy disclosure names
1073
+ * (PrivacyDisclosure.climate_summary_period), or weeks when it names none. Anyone but the
1074
+ * apartment's residents may ask for that period only, and is refused as NOT_ENTITLED for
1075
+ * any other or when it names none. Its residents may ask for any, and are given only
1076
+ * periods that began in their current residency.
1077
+ *
1078
+ * @generated from field: kusinta.iot.climate.v1.ClimateSummaryPeriod period = 2;
1079
+ */
1080
+ period: ClimateSummaryPeriod;
1081
+
1082
+ /**
1083
+ * @generated from field: google.protobuf.Timestamp from_time = 3;
1084
+ */
1085
+ fromTime?: Timestamp | undefined;
1086
+
1087
+ /**
1088
+ * @generated from field: google.protobuf.Timestamp to_time = 4;
1089
+ */
1090
+ toTime?: Timestamp | undefined;
1091
+ };
1092
+
1093
+ /**
1094
+ * Describes the message kusinta.iot.webrtc.v1.GetApartmentClimateSummary.
1095
+ * Use `create(GetApartmentClimateSummarySchema)` to create a new message.
1096
+ */
1097
+ export declare const GetApartmentClimateSummarySchema: GenMessage<GetApartmentClimateSummary>;
1098
+
1099
+ /**
1100
+ * Asks the gateway to have a connector re-initialise its backend connection: reconnect to
1101
+ * its radio central or network server. Meant to be offered while a
1102
+ * reporting.v1.PROBLEM_KIND_CONNECTOR_ERROR is open for the connector — its
1103
+ * ConnectorDescriptor.backend_health is FAILING — and only for a connector listed in
1104
+ * ConnectorsAnnounced. A request for a connector that is not listed is refused, as
1105
+ * CONNECTOR_OFFLINE or UNKNOWN_CONNECTOR below. For a listed one it is accepted whatever its
1106
+ * health, since re-initialising a healthy backend is harmless.
1107
+ *
1108
+ * Authorized against the caller's role alone, as StartPairing is: a connector is not a
1109
+ * target the caller reaches the way a space is. ROLE_TECHNICIAN and ROLE_GATEWAY_ADMIN may
1110
+ * ask; anyone else is refused as NOT_ENTITLED, before the connector is looked up, so the
1111
+ * refusal says nothing of which connectors exist.
1112
+ *
1113
+ * The gateway forwards it as connector.v1.ReinitializeBackend and answers once the
1114
+ * connector has: with ManagementAck when the attempt was made. That says the attempt
1115
+ * finished, not that it worked. Whether it worked is the connector's backend health, and
1116
+ * when that changed the gateway pushes it in ConnectorsAnnounced before the ack. One
1117
+ * request at a time per connector.
1118
+ *
1119
+ * So a failure found only by attempting — credentials the backend rejects, a backend that
1120
+ * does not answer — is not a refusal. It arrives as a ManagementAck, with the backend
1121
+ * health it left (FAILING, e.g. with AUTH_FAILED, UNREACHABLE or BACKEND_ERROR) already
1122
+ * pushed: after the ack, the app reads ConnectorDescriptor.backend_health for the outcome,
1123
+ * and a FAILING health there means the reconnect did not help. The app handles any reason
1124
+ * there, one its schema does not know included. No push precedes the ack when the attempt
1125
+ * left health as it was; the descriptor the app holds is then still the outcome.
1126
+ *
1127
+ * A refusal is a GatewayError whose metadata "reason" says which, as CommandError.metadata
1128
+ * describes, and whose "detail" is a sentence the app may show. The app branches on
1129
+ * "reason" for this operation; the code is only the fallback for a reason it does not know,
1130
+ * since GatewayErrorCode is too coarse to say what to do here. The role refusal above is
1131
+ * the code NOT_ENTITLED alone, with no "reason"; the reasons are for a caller who may ask:
1132
+ * "UNKNOWN_CONNECTOR" UNAVAILABLE. The gateway does not track a connector by that id:
1133
+ * it never had one, or has stopped tracking it. Not a client bug:
1134
+ * the list the app holds may be stale.
1135
+ * "CONNECTOR_OFFLINE" UNAVAILABLE. A connector the gateway tracks, whose stream to the
1136
+ * gateway is down now, before or while the request was
1137
+ * outstanding; that is CONNECTOR_OFFLINE, and a reconnect of its
1138
+ * backend cannot help it.
1139
+ * "NOT_SUPPORTED" FAILED_PRECONDITION. The connector does not declare
1140
+ * ConnectorDescriptor.supports_backend_reinitialize, or declared it
1141
+ * and answered that it has nothing to re-initialise. Not a client
1142
+ * bug, and not worth retrying as is.
1143
+ * "ALREADY_IN_PROGRESS" UNAVAILABLE. A reconnect of this connector is outstanding, from
1144
+ * this caller or another. It ends within 60 seconds of being
1145
+ * asked, answered or timed out; retry after that. Only the caller
1146
+ * who asked is answered, but a change of health it causes reaches
1147
+ * every session in ConnectorsAnnounced.
1148
+ * "TIMED_OUT" UNAVAILABLE. The connector did not answer within the gateway's
1149
+ * deadline. The attempt may still finish, and its outcome still
1150
+ * arrives as backend health.
1151
+ * "REINITIALIZE_FAILED" The connector could not attempt it at all
1152
+ * (connector.v1.REINITIALIZE_OUTCOME_FAILED, or an outcome the
1153
+ * gateway's schema does not know, read as FAILED). The code
1154
+ * depends on the reason: FAILED_PRECONDITION when it is
1155
+ * MISCONFIGURED, which needs a person to correct the connector's
1156
+ * configuration before asking again can help; UNAVAILABLE for
1157
+ * any other — INTERNAL, UNSPECIFIED, a value the gateway does not
1158
+ * know — since a retry may work. Rejected credentials are never
1159
+ * this: they are found by attempting, and come back as an ack
1160
+ * (see above). metadata "backend_failure" is always set: the
1161
+ * common.v1.BackendFailureReason by its enum name, e.g.
1162
+ * "BACKEND_FAILURE_REASON_MISCONFIGURED". A reason that is
1163
+ * UNSPECIFIED, or a value the gateway's schema does not know, is
1164
+ * sent as "BACKEND_FAILURE_REASON_BACKEND_ERROR", as
1165
+ * BackendFailureReason has it; an app reading a name its own
1166
+ * schema does not know treats it as BACKEND_ERROR too.
1167
+ * The connector's own detail is never in a refusal; GatewayError.message is the gateway's.
1168
+ *
1169
+ * @generated from message kusinta.iot.webrtc.v1.ReconnectConnector
1170
+ */
1171
+ export declare type ReconnectConnector = Message<"kusinta.iot.webrtc.v1.ReconnectConnector"> & {
1172
+ /**
1173
+ * As ConnectorDescriptor.connector_id, and the id a CONNECTOR_ERROR problem's subject
1174
+ * names (reporting.v1.ProblemSubject.connector_id).
1175
+ *
1176
+ * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
1177
+ */
1178
+ connectorId?: ConnectorId | undefined;
1179
+ };
1180
+
1181
+ /**
1182
+ * Describes the message kusinta.iot.webrtc.v1.ReconnectConnector.
1183
+ * Use `create(ReconnectConnectorSchema)` to create a new message.
1184
+ */
1185
+ export declare const ReconnectConnectorSchema: GenMessage<ReconnectConnector>;
1186
+
1187
+ /**
377
1188
  * @generated from message kusinta.iot.webrtc.v1.ManagementRequest
378
1189
  */
379
1190
  export declare type ManagementRequest = Message<"kusinta.iot.webrtc.v1.ManagementRequest"> & {
@@ -440,6 +1251,160 @@ export declare type ManagementRequest = Message<"kusinta.iot.webrtc.v1.Managemen
440
1251
  */
441
1252
  value: ListSpaces;
442
1253
  case: "listSpaces";
1254
+ } | {
1255
+ /**
1256
+ * @generated from field: kusinta.iot.webrtc.v1.CreateDeviceLink create_device_link = 11;
1257
+ */
1258
+ value: CreateDeviceLink;
1259
+ case: "createDeviceLink";
1260
+ } | {
1261
+ /**
1262
+ * @generated from field: kusinta.iot.webrtc.v1.RemoveDeviceLink remove_device_link = 12;
1263
+ */
1264
+ value: RemoveDeviceLink;
1265
+ case: "removeDeviceLink";
1266
+ } | {
1267
+ /**
1268
+ * @generated from field: kusinta.iot.webrtc.v1.ListDeviceLinks list_device_links = 13;
1269
+ */
1270
+ value: ListDeviceLinks;
1271
+ case: "listDeviceLinks";
1272
+ } | {
1273
+ /**
1274
+ * @generated from field: kusinta.iot.webrtc.v1.UpdateDeviceLink update_device_link = 14;
1275
+ */
1276
+ value: UpdateDeviceLink;
1277
+ case: "updateDeviceLink";
1278
+ } | {
1279
+ /**
1280
+ * @generated from field: kusinta.iot.webrtc.v1.ProvisionDevice provision_device = 15;
1281
+ */
1282
+ value: ProvisionDevice;
1283
+ case: "provisionDevice";
1284
+ } | {
1285
+ /**
1286
+ * @generated from field: kusinta.iot.webrtc.v1.SetRoomTarget set_room_target = 16;
1287
+ */
1288
+ value: SetRoomTarget;
1289
+ case: "setRoomTarget";
1290
+ } | {
1291
+ /**
1292
+ * @generated from field: kusinta.iot.webrtc.v1.ConfigureRoomClimate configure_room_climate = 17;
1293
+ */
1294
+ value: ConfigureRoomClimate;
1295
+ case: "configureRoomClimate";
1296
+ } | {
1297
+ /**
1298
+ * @generated from field: kusinta.iot.webrtc.v1.SetClimateMode set_climate_mode = 18;
1299
+ */
1300
+ value: SetClimateMode;
1301
+ case: "setClimateMode";
1302
+ } | {
1303
+ /**
1304
+ * @generated from field: kusinta.iot.webrtc.v1.ListRoomClimates list_room_climates = 19;
1305
+ */
1306
+ value: ListRoomClimates;
1307
+ case: "listRoomClimates";
1308
+ } | {
1309
+ /**
1310
+ * @generated from field: kusinta.iot.webrtc.v1.GetRoomHistory get_room_history = 20;
1311
+ */
1312
+ value: GetRoomHistory;
1313
+ case: "getRoomHistory";
1314
+ } | {
1315
+ /**
1316
+ * @generated from field: kusinta.iot.webrtc.v1.GetPrivacyDisclosure get_privacy_disclosure = 21;
1317
+ */
1318
+ value: GetPrivacyDisclosure;
1319
+ case: "getPrivacyDisclosure";
1320
+ } | {
1321
+ /**
1322
+ * @generated from field: kusinta.iot.webrtc.v1.GetApartmentClimateSummary get_apartment_climate_summary = 22;
1323
+ */
1324
+ value: GetApartmentClimateSummary;
1325
+ case: "getApartmentClimateSummary";
1326
+ } | {
1327
+ /**
1328
+ * @generated from field: kusinta.iot.webrtc.v1.ReconnectConnector reconnect_connector = 23;
1329
+ */
1330
+ value: ReconnectConnector;
1331
+ case: "reconnectConnector";
1332
+ } | {
1333
+ /**
1334
+ * Invites; see invite.proto.
1335
+ *
1336
+ * @generated from field: kusinta.iot.webrtc.v1.CreateInvite create_invite = 24;
1337
+ */
1338
+ value: CreateInvite;
1339
+ case: "createInvite";
1340
+ } | {
1341
+ /**
1342
+ * @generated from field: kusinta.iot.webrtc.v1.ResendInvite resend_invite = 25;
1343
+ */
1344
+ value: ResendInvite;
1345
+ case: "resendInvite";
1346
+ } | {
1347
+ /**
1348
+ * @generated from field: kusinta.iot.webrtc.v1.RevokeInvite revoke_invite = 26;
1349
+ */
1350
+ value: RevokeInvite;
1351
+ case: "revokeInvite";
1352
+ } | {
1353
+ /**
1354
+ * @generated from field: kusinta.iot.webrtc.v1.MarkInviteEmailSent mark_invite_email_sent = 27;
1355
+ */
1356
+ value: MarkInviteEmailSent;
1357
+ case: "markInviteEmailSent";
1358
+ } | {
1359
+ /**
1360
+ * @generated from field: kusinta.iot.webrtc.v1.ListSpaceInvites list_space_invites = 28;
1361
+ */
1362
+ value: ListSpaceInvites;
1363
+ case: "listSpaceInvites";
1364
+ } | {
1365
+ /**
1366
+ * @generated from field: kusinta.iot.webrtc.v1.ApproveJoinRequest approve_join_request = 29;
1367
+ */
1368
+ value: ApproveJoinRequest;
1369
+ case: "approveJoinRequest";
1370
+ } | {
1371
+ /**
1372
+ * @generated from field: kusinta.iot.webrtc.v1.DenyJoinRequest deny_join_request = 30;
1373
+ */
1374
+ value: DenyJoinRequest;
1375
+ case: "denyJoinRequest";
1376
+ } | {
1377
+ /**
1378
+ * Members; see members.proto.
1379
+ *
1380
+ * @generated from field: kusinta.iot.webrtc.v1.ListGatewayMembers list_gateway_members = 31;
1381
+ */
1382
+ value: ListGatewayMembers;
1383
+ case: "listGatewayMembers";
1384
+ } | {
1385
+ /**
1386
+ * @generated from field: kusinta.iot.webrtc.v1.SetMemberRole set_member_role = 32;
1387
+ */
1388
+ value: SetMemberRole;
1389
+ case: "setMemberRole";
1390
+ } | {
1391
+ /**
1392
+ * @generated from field: kusinta.iot.webrtc.v1.RemoveFromGateway remove_from_gateway = 33;
1393
+ */
1394
+ value: RemoveFromGateway;
1395
+ case: "removeFromGateway";
1396
+ } | {
1397
+ /**
1398
+ * @generated from field: kusinta.iot.webrtc.v1.SetAccessUntil set_access_until = 34;
1399
+ */
1400
+ value: SetAccessUntil;
1401
+ case: "setAccessUntil";
1402
+ } | {
1403
+ /**
1404
+ * @generated from field: kusinta.iot.webrtc.v1.SetOwnerOrganisation set_owner_organisation = 35;
1405
+ */
1406
+ value: SetOwnerOrganisation;
1407
+ case: "setOwnerOrganisation";
443
1408
  } | { case: undefined; value?: undefined };
444
1409
  };
445
1410