@kusinta/iot-schema 0.2.0-beta.4 → 0.2.0-beta.40

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 (67) hide show
  1. package/package.json +12 -1
  2. package/src/kusinta/iot/access/v1/acl_pb.d.ts +119 -2
  3. package/src/kusinta/iot/access/v1/acl_pb.js +20 -3
  4. package/src/kusinta/iot/access/v1/roles_pb.d.ts +131 -4
  5. package/src/kusinta/iot/access/v1/roles_pb.js +110 -5
  6. package/src/kusinta/iot/accountlink/v1/account_link_pb.d.ts +583 -0
  7. package/src/kusinta/iot/accountlink/v1/account_link_pb.js +160 -0
  8. package/src/kusinta/iot/climate/v1/climate_pb.d.ts +1041 -0
  9. package/src/kusinta/iot/climate/v1/climate_pb.js +206 -0
  10. package/src/kusinta/iot/commissioning/v1/commissioning_pb.d.ts +1128 -0
  11. package/src/kusinta/iot/commissioning/v1/commissioning_pb.js +246 -0
  12. package/src/kusinta/iot/common/v1/pairing_pb.d.ts +217 -0
  13. package/src/kusinta/iot/common/v1/pairing_pb.js +50 -0
  14. package/src/kusinta/iot/common/v1/types_pb.d.ts +175 -0
  15. package/src/kusinta/iot/common/v1/types_pb.js +70 -1
  16. package/src/kusinta/iot/connector/v1/connector_pb.d.ts +691 -2
  17. package/src/kusinta/iot/connector/v1/connector_pb.js +104 -13
  18. package/src/kusinta/iot/device/v1/cluster_state_pb.d.ts +213 -1
  19. package/src/kusinta/iot/device/v1/cluster_state_pb.js +37 -2
  20. package/src/kusinta/iot/device/v1/descriptor_pb.d.ts +22 -2
  21. package/src/kusinta/iot/device/v1/descriptor_pb.js +2 -1
  22. package/src/kusinta/iot/device/v1/device_event_pb.d.ts +87 -5
  23. package/src/kusinta/iot/device/v1/device_event_pb.js +1 -1
  24. package/src/kusinta/iot/device/v1/device_pb.d.ts +164 -11
  25. package/src/kusinta/iot/device/v1/device_pb.js +33 -2
  26. package/src/kusinta/iot/device/v1/properties_pb.d.ts +26 -5
  27. package/src/kusinta/iot/device/v1/properties_pb.js +1 -1
  28. package/src/kusinta/iot/device/v1/property_update_pb.d.ts +28 -2
  29. package/src/kusinta/iot/device/v1/property_update_pb.js +2 -1
  30. package/src/kusinta/iot/heating/v1/heating_pb.d.ts +619 -0
  31. package/src/kusinta/iot/heating/v1/heating_pb.js +118 -0
  32. package/src/kusinta/iot/link/v1/link_pb.d.ts +438 -0
  33. package/src/kusinta/iot/link/v1/link_pb.js +121 -0
  34. package/src/kusinta/iot/registration/v1/registration_pb.d.ts +18 -0
  35. package/src/kusinta/iot/registration/v1/registration_pb.js +1 -1
  36. package/src/kusinta/iot/reporting/v1/reporting_pb.d.ts +1225 -0
  37. package/src/kusinta/iot/reporting/v1/reporting_pb.js +238 -0
  38. package/src/kusinta/iot/reporting/v1/reporting_service_pb.d.ts +63 -0
  39. package/src/kusinta/iot/reporting/v1/reporting_service_pb.js +24 -0
  40. package/src/kusinta/iot/signaling/v1/signaling_pb.d.ts +920 -7
  41. package/src/kusinta/iot/signaling/v1/signaling_pb.js +163 -4
  42. package/src/kusinta/iot/signaling/v1/signaling_service_pb.d.ts +24 -1
  43. package/src/kusinta/iot/signaling/v1/signaling_service_pb.js +1 -1
  44. package/src/kusinta/iot/space/v1/space_pb.d.ts +107 -2
  45. package/src/kusinta/iot/space/v1/space_pb.js +10 -1
  46. package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.d.ts +19 -3
  47. package/src/kusinta/iot/vendor/homematic/v1/homematic_pb.js +1 -1
  48. package/src/kusinta/iot/vendor/lorawan/v1/lorawan_pb.d.ts +69 -0
  49. package/src/kusinta/iot/vendor/lorawan/v1/lorawan_pb.js +19 -0
  50. package/src/kusinta/iot/vendor/v1/vendor_options_pb.d.ts +4 -4
  51. package/src/kusinta/iot/vendor/v1/vendor_options_pb.js +4 -4
  52. package/src/kusinta/iot/webrtc/v1/app_token_pb.d.ts +48 -5
  53. package/src/kusinta/iot/webrtc/v1/app_token_pb.js +1 -1
  54. package/src/kusinta/iot/webrtc/v1/command_pb.d.ts +56 -0
  55. package/src/kusinta/iot/webrtc/v1/command_pb.js +1 -1
  56. package/src/kusinta/iot/webrtc/v1/device_state_pb.d.ts +179 -5
  57. package/src/kusinta/iot/webrtc/v1/device_state_pb.js +35 -6
  58. package/src/kusinta/iot/webrtc/v1/envelope_pb.d.ts +607 -3
  59. package/src/kusinta/iot/webrtc/v1/envelope_pb.js +68 -3
  60. package/src/kusinta/iot/webrtc/v1/invite_pb.d.ts +498 -0
  61. package/src/kusinta/iot/webrtc/v1/invite_pb.js +108 -0
  62. package/src/kusinta/iot/webrtc/v1/management_pb.d.ts +1687 -75
  63. package/src/kusinta/iot/webrtc/v1/management_pb.js +261 -5
  64. package/src/kusinta/iot/webrtc/v1/members_pb.d.ts +536 -0
  65. package/src/kusinta/iot/webrtc/v1/members_pb.js +113 -0
  66. package/src/kusinta/iot/webrtc/v1/permission_push_pb.d.ts +66 -4
  67. package/src/kusinta/iot/webrtc/v1/permission_push_pb.js +10 -2
@@ -4,12 +4,21 @@
4
4
 
5
5
  import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
6
6
  import type { Message } from "@bufbuild/protobuf";
7
- import type { DeviceId } from "../../identity/v1/identity_pb.js";
7
+ import type { ConnectorId, DeviceId, SpaceId } from "../../identity/v1/identity_pb.js";
8
8
  import type { AttributeRef } from "../../access/v1/acl_pb.js";
9
9
  import type { Space } from "../../space/v1/space_pb.js";
10
- import type { ManagementAck, ManagementRequest, SpaceTree } from "./management_pb.js";
10
+ import type { ManagementAck, ManagementRequest, PrivacyDisclosure, SpaceTree } from "./management_pb.js";
11
+ import type { DeviceLink, DeviceLinkList } from "../../link/v1/link_pb.js";
12
+ import type { ApartmentClimateSummary, ClimateMode, RoomClimate, RoomClimateList, RoomHistory } from "../../climate/v1/climate_pb.js";
13
+ import type { IssuedInvite, SpaceInvites } from "./invite_pb.js";
14
+ import type { GatewayMembers, PromotionRequests } from "./members_pb.js";
15
+ import type { HeatingLayout, HeatingRecord } from "../../heating/v1/heating_pb.js";
16
+ import type { AccountLinkNonce, AccountLinks } from "../../accountlink/v1/account_link_pb.js";
17
+ import type { CommissioningProfile, CommissioningRecord, CommissioningTest, HomeSetups } from "../../commissioning/v1/commissioning_pb.js";
18
+ import type { PairingErrorDetail, PairingWindow } from "../../common/v1/pairing_pb.js";
19
+ import type { BackendHealth, ConnectorKind, DeviceOwnershipType } from "../../common/v1/types_pb.js";
11
20
  import type { Timestamp } from "@bufbuild/protobuf/wkt";
12
- import type { DeviceAdded, DeviceRemoved, DeviceStateSnapshot, PropertyReport } from "./device_state_pb.js";
21
+ import type { DeviceAdded, DeviceRemoved, DeviceStateSnapshot, PropertyReport, ServiceStatusChanged } from "./device_state_pb.js";
13
22
  import type { LivePermissionUpdate } from "./permission_push_pb.js";
14
23
  import type { AttributeWriteRequest, CommandResult, DeviceCommand } from "./command_pb.js";
15
24
  import type { DeviceEventBatch } from "../../device/v1/device_event_pb.js";
@@ -316,6 +325,136 @@ export declare type ManagementResult = Message<"kusinta.iot.webrtc.v1.Management
316
325
  */
317
326
  value: ManagementAck;
318
327
  case: "ack";
328
+ } | {
329
+ /**
330
+ * list_device_links
331
+ *
332
+ * @generated from field: kusinta.iot.link.v1.DeviceLinkList links = 6;
333
+ */
334
+ value: DeviceLinkList;
335
+ case: "links";
336
+ } | {
337
+ /**
338
+ * list_room_climates
339
+ *
340
+ * @generated from field: kusinta.iot.climate.v1.RoomClimateList room_climates = 7;
341
+ */
342
+ value: RoomClimateList;
343
+ case: "roomClimates";
344
+ } | {
345
+ /**
346
+ * get_room_history
347
+ *
348
+ * @generated from field: kusinta.iot.climate.v1.RoomHistory room_history = 8;
349
+ */
350
+ value: RoomHistory;
351
+ case: "roomHistory";
352
+ } | {
353
+ /**
354
+ * get_privacy_disclosure
355
+ *
356
+ * @generated from field: kusinta.iot.webrtc.v1.PrivacyDisclosure privacy_disclosure = 9;
357
+ */
358
+ value: PrivacyDisclosure;
359
+ case: "privacyDisclosure";
360
+ } | {
361
+ /**
362
+ * get_apartment_climate_summary
363
+ *
364
+ * @generated from field: kusinta.iot.climate.v1.ApartmentClimateSummary apartment_climate_summary = 10;
365
+ */
366
+ value: ApartmentClimateSummary;
367
+ case: "apartmentClimateSummary";
368
+ } | {
369
+ /**
370
+ * create_invite, resend_invite
371
+ *
372
+ * @generated from field: kusinta.iot.webrtc.v1.IssuedInvite issued_invite = 11;
373
+ */
374
+ value: IssuedInvite;
375
+ case: "issuedInvite";
376
+ } | {
377
+ /**
378
+ * list_space_invites
379
+ *
380
+ * @generated from field: kusinta.iot.webrtc.v1.SpaceInvites space_invites = 12;
381
+ */
382
+ value: SpaceInvites;
383
+ case: "spaceInvites";
384
+ } | {
385
+ /**
386
+ * list_gateway_members
387
+ *
388
+ * @generated from field: kusinta.iot.webrtc.v1.GatewayMembers gateway_members = 13;
389
+ */
390
+ value: GatewayMembers;
391
+ case: "gatewayMembers";
392
+ } | {
393
+ /**
394
+ * list_promotion_requests
395
+ *
396
+ * @generated from field: kusinta.iot.webrtc.v1.PromotionRequests promotion_requests = 14;
397
+ */
398
+ value: PromotionRequests;
399
+ case: "promotionRequests";
400
+ } | {
401
+ /**
402
+ * list_heating
403
+ *
404
+ * @generated from field: kusinta.iot.heating.v1.HeatingLayout heating_layout = 15;
405
+ */
406
+ value: HeatingLayout;
407
+ case: "heatingLayout";
408
+ } | {
409
+ /**
410
+ * put_heating_plant, put_heating_circuit, put_floor_zone, put_comfort_load,
411
+ * set_comfort_windows
412
+ *
413
+ * @generated from field: kusinta.iot.heating.v1.HeatingRecord heating_record = 16;
414
+ */
415
+ value: HeatingRecord;
416
+ case: "heatingRecord";
417
+ } | {
418
+ /**
419
+ * request_account_link_nonce
420
+ *
421
+ * @generated from field: kusinta.iot.accountlink.v1.AccountLinkNonce account_link_nonce = 17;
422
+ */
423
+ value: AccountLinkNonce;
424
+ case: "accountLinkNonce";
425
+ } | {
426
+ /**
427
+ * list_account_links
428
+ *
429
+ * @generated from field: kusinta.iot.accountlink.v1.AccountLinks account_links = 18;
430
+ */
431
+ value: AccountLinks;
432
+ case: "accountLinks";
433
+ } | {
434
+ /**
435
+ * list_commissioning
436
+ *
437
+ * @generated from field: kusinta.iot.commissioning.v1.CommissioningProfile commissioning_profile = 19;
438
+ */
439
+ value: CommissioningProfile;
440
+ case: "commissioningProfile";
441
+ } | {
442
+ /**
443
+ * put_commissioning_fact, put_house_template, run_commissioning_test,
444
+ * conclude_commissioning_test
445
+ *
446
+ * @generated from field: kusinta.iot.commissioning.v1.CommissioningRecord commissioning_record = 20;
447
+ */
448
+ value: CommissioningRecord;
449
+ case: "commissioningRecord";
450
+ } | {
451
+ /**
452
+ * list_home_setups
453
+ *
454
+ * @generated from field: kusinta.iot.commissioning.v1.HomeSetups home_setups = 21;
455
+ */
456
+ value: HomeSetups;
457
+ case: "homeSetups";
319
458
  } | { case: undefined; value?: undefined };
320
459
  };
321
460
 
@@ -325,9 +464,383 @@ export declare type ManagementResult = Message<"kusinta.iot.webrtc.v1.Management
325
464
  */
326
465
  export declare const ManagementResultSchema: GenMessage<ManagementResult>;
327
466
 
467
+ /**
468
+ * Asks the gateway to put a connector into pairing mode, so a device joined during the
469
+ * window becomes the caller's rather than belonging to nobody.
470
+ *
471
+ * A payload case of its own rather than a ManagementRequest. Those are gated on a target —
472
+ * a space, a device — and that is the justification for keeping them behind one wrapper.
473
+ * A connector is not a target the caller must reach the way a space is, so this is
474
+ * authorized against the caller's role and nothing else — but it must still name the
475
+ * connector to open (see connector_id), never every connector at once.
476
+ *
477
+ * Answered twice, and the two answers say different things at different times.
478
+ * PairingStarted reports whether the window opened; PairingFinished reports what came of
479
+ * it, seconds or minutes later, once someone has pressed a button on hardware that may be
480
+ * asleep or out of range.
481
+ *
482
+ * @generated from message kusinta.iot.webrtc.v1.StartPairing
483
+ */
484
+ export declare type StartPairing = Message<"kusinta.iot.webrtc.v1.StartPairing"> & {
485
+ /**
486
+ * Which connector to open. Required: pairing always targets exactly one connector,
487
+ * picked from the connector enumeration (see ConnectorsAnnounced and
488
+ * ConnectorInfo.supports_pairing). An untargeted request is refused with
489
+ * PairingError.CONNECTOR_REQUIRED, never fanned out across every hub — so that no
490
+ * client can open every radio at once, and so a device is paired onto the specific hub
491
+ * that will broker its links. The field is a message, so proto cannot mark it required;
492
+ * the gateway enforces it.
493
+ *
494
+ * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
495
+ */
496
+ connectorId?: ConnectorId | undefined;
497
+
498
+ /**
499
+ * How long, which device, how many. See PairingWindow.
500
+ *
501
+ * @generated from field: kusinta.iot.common.v1.PairingWindow window = 2;
502
+ */
503
+ window?: PairingWindow | undefined;
504
+
505
+ /**
506
+ * Where to file the device once it arrives. Into a home only as PlaceDeviceInSpace
507
+ * allows.
508
+ *
509
+ * Optional, and the two cases differ. A caller pairing a device of their own must name a
510
+ * space they reach, so it is theirs and placed on arrival rather than sitting unfiled and
511
+ * invisible to them. A caller commissioning for a building may leave it unset: a building
512
+ * is commissioned before its spaces are recorded, and an unfiled device is visible to the
513
+ * administrator, who is the person doing the pairing.
514
+ *
515
+ * @generated from field: kusinta.iot.identity.v1.SpaceId initial_space_id = 3;
516
+ */
517
+ initialSpaceId?: SpaceId | undefined;
518
+
519
+ /**
520
+ * What the device should become. Unset lets the gateway decide from the caller's role,
521
+ * which is the reading that scales: someone commissioning fifty devices for a building
522
+ * should not come to own fifty devices because a field defaulted.
523
+ *
524
+ * The gateway refuses an ownership the caller may not confer, and never mints ownership
525
+ * for a third party — handing a device to someone else is a transfer, a separate operation
526
+ * with its own authority.
527
+ *
528
+ * @generated from field: kusinta.iot.common.v1.DeviceOwnershipType ownership = 4;
529
+ */
530
+ ownership: DeviceOwnershipType;
531
+ };
532
+
533
+ /**
534
+ * Describes the message kusinta.iot.webrtc.v1.StartPairing.
535
+ * Use `create(StartPairingSchema)` to create a new message.
536
+ */
537
+ export declare const StartPairingSchema: GenMessage<StartPairing>;
538
+
539
+ /**
540
+ * Whether the pairing window opened, gateway → app. The first of two answers to a
541
+ * StartPairing.
542
+ *
543
+ * @generated from message kusinta.iot.webrtc.v1.PairingStarted
544
+ */
545
+ export declare type PairingStarted = Message<"kusinta.iot.webrtc.v1.PairingStarted"> & {
546
+ /**
547
+ * AppMessage.message_id of the StartPairing
548
+ *
549
+ * @generated from field: string in_reply_to = 1;
550
+ */
551
+ inReplyTo: string;
552
+
553
+ /**
554
+ * When the window closes. Present when it opened, and this is the value to count down
555
+ * from — not the duration that was asked for, which both the gateway and the connector
556
+ * clamp. A countdown run on the request rather than on this one disagrees with the hub.
557
+ *
558
+ * @generated from field: google.protobuf.Timestamp expires_at = 2;
559
+ */
560
+ expiresAt?: Timestamp | undefined;
561
+
562
+ /**
563
+ * Why it did not open. Present instead of expires_at.
564
+ *
565
+ * @generated from field: kusinta.iot.common.v1.PairingErrorDetail error = 3;
566
+ */
567
+ error?: PairingErrorDetail | undefined;
568
+ };
569
+
570
+ /**
571
+ * Describes the message kusinta.iot.webrtc.v1.PairingStarted.
572
+ * Use `create(PairingStartedSchema)` to create a new message.
573
+ */
574
+ export declare const PairingStartedSchema: GenMessage<PairingStarted>;
575
+
576
+ /**
577
+ * What the pairing window produced, gateway → app. The second and last answer, sent once
578
+ * when the window closes.
579
+ *
580
+ * One message per request, not per device: a batch window attributes several, and a client
581
+ * given one message each has nothing telling it the window is over and no defined moment to
582
+ * stop waiting. The devices are listed here; each also arrives as an ordinary DeviceAdded
583
+ * as it appears, so a client may show them as they come and use this to finish.
584
+ *
585
+ * An error and a non-empty device list are not exclusive. A batch of five that attributed
586
+ * three and then expired reports both — three devices and NO_DEVICE_APPEARED — because
587
+ * "some worked" and "the window ran out" are both true and a user needs to be told both.
588
+ *
589
+ * @generated from message kusinta.iot.webrtc.v1.PairingFinished
590
+ */
591
+ export declare type PairingFinished = Message<"kusinta.iot.webrtc.v1.PairingFinished"> & {
592
+ /**
593
+ * AppMessage.message_id of the StartPairing
594
+ *
595
+ * @generated from field: string in_reply_to = 1;
596
+ */
597
+ inReplyTo: string;
598
+
599
+ /**
600
+ * @generated from field: repeated kusinta.iot.identity.v1.DeviceId device_ids = 2;
601
+ */
602
+ deviceIds: DeviceId[];
603
+
604
+ /**
605
+ * Why the window produced fewer devices than asked for, absent when it produced them all.
606
+ * Note this is not always a failure of the request: a window that simply expired unused
607
+ * ends here too, and is the ordinary result of a user changing their mind.
608
+ *
609
+ * @generated from field: kusinta.iot.common.v1.PairingErrorDetail error = 3;
610
+ */
611
+ error?: PairingErrorDetail | undefined;
612
+ };
613
+
614
+ /**
615
+ * Describes the message kusinta.iot.webrtc.v1.PairingFinished.
616
+ * Use `create(PairingFinishedSchema)` to create a new message.
617
+ */
618
+ export declare const PairingFinishedSchema: GenMessage<PairingFinished>;
619
+
328
620
  /**
329
621
  * GatewayMessage: gateway → app
622
+ * A link between two devices has changed, gateway to app.
623
+ *
624
+ * Sent without being asked for, like device_added, and for the same reason: a link's
625
+ * state is not settled when it is made. A hub accepting a link is not the two devices
626
+ * honouring it, and a link that was carrying stops when its sender goes quiet — so the
627
+ * interesting transitions all happen long after the request that created it was
628
+ * answered. Without this an app can only learn by listing every link again and
629
+ * diffing, which means a room that has quietly stopped following its wall thermostat
630
+ * looks correct until somebody reloads.
330
631
  *
632
+ * Apply as an upsert keyed on link.link_id, never as an insert: the same link is sent
633
+ * again whenever its state moves.
634
+ *
635
+ * Sent only for links the recipient is entitled to see. An unfiltered one would say
636
+ * which devices exist and how they are arranged, to somebody entitled to neither. A link
637
+ * with an end in a home reaches a recipient who sees it as service with details_withheld,
638
+ * and is pushed to them only when it appears and when it is removed — never for anything
639
+ * else, its state and settings included, which are not theirs to see. Its removal is pushed
640
+ * to them at once, as every loss is — to those who were shown it, and to nobody else.
641
+ *
642
+ * @generated from message kusinta.iot.webrtc.v1.LinkChanged
643
+ */
644
+ export declare type LinkChanged = Message<"kusinta.iot.webrtc.v1.LinkChanged"> & {
645
+ /**
646
+ * @generated from field: kusinta.iot.link.v1.DeviceLink link = 1;
647
+ */
648
+ link?: DeviceLink | undefined;
649
+
650
+ /**
651
+ * The link is gone, rather than merely not carrying. Distinct from a BROKEN state
652
+ * because the two need opposite responses: a removal is finished business, while a
653
+ * link that has stopped carrying is a fault worth showing somebody. Announcing a
654
+ * deletion as BROKEN would leave every removed link looking like something to go
655
+ * and repair.
656
+ *
657
+ * `link` still carries the whole link when this is set, so the app can name what
658
+ * went rather than only its id — as much of it as the recipient was shown, so with
659
+ * details_withheld to one who saw it as service. To such a recipient it means the link is
660
+ * gone from their view, which need not mean it is gone.
661
+ *
662
+ * @generated from field: bool removed = 2;
663
+ */
664
+ removed: boolean;
665
+ };
666
+
667
+ /**
668
+ * Describes the message kusinta.iot.webrtc.v1.LinkChanged.
669
+ * Use `create(LinkChangedSchema)` to create a new message.
670
+ */
671
+ export declare const LinkChangedSchema: GenMessage<LinkChanged>;
672
+
673
+ /**
674
+ * One connected connector, described for the app, gateway → app.
675
+ *
676
+ * Deliberately not connector.v1.ConnectorInfo: that carries transport and endpoint,
677
+ * which are the gateway↔connector wiring and no business of the app. This is the
678
+ * app-facing projection — who the connector is and what it can do — and nothing
679
+ * about how the gateway reaches it.
680
+ *
681
+ * @generated from message kusinta.iot.webrtc.v1.ConnectorDescriptor
682
+ */
683
+ export declare type ConnectorDescriptor = Message<"kusinta.iot.webrtc.v1.ConnectorDescriptor"> & {
684
+ /**
685
+ * The routing key. Stable and unique; what StartPairing.connector_id and
686
+ * ProvisionDevice.connector_id name.
687
+ *
688
+ * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 1;
689
+ */
690
+ connectorId?: ConnectorId | undefined;
691
+
692
+ /**
693
+ * User-facing label, free-form, never matched on.
694
+ *
695
+ * @generated from field: string display_name = 2;
696
+ */
697
+ displayName: string;
698
+
699
+ /**
700
+ * @generated from field: repeated uint32 supported_device_type_ids = 3;
701
+ */
702
+ supportedDeviceTypeIds: number[];
703
+
704
+ /**
705
+ * The capabilities the app branches on. Copied from the connector's handshake;
706
+ * see ConnectorInfo for what each means. The app decides pairing-vs-provisioning
707
+ * and whether to offer hard links from these, never from kind.
708
+ *
709
+ * @generated from field: bool supports_pairing = 4;
710
+ */
711
+ supportsPairing: boolean;
712
+
713
+ /**
714
+ * @generated from field: bool supports_provisioning = 5;
715
+ */
716
+ supportsProvisioning: boolean;
717
+
718
+ /**
719
+ * @generated from field: bool brokers_links = 6;
720
+ */
721
+ brokersLinks: boolean;
722
+
723
+ /**
724
+ * Presentation only — an icon or an "unknown hub" fallback; see
725
+ * common.v1.ConnectorKind. Unset renders as a generic hub.
726
+ *
727
+ * @generated from field: kusinta.iot.common.v1.ConnectorKind kind = 7;
728
+ */
729
+ kind: ConnectorKind;
730
+
731
+ /**
732
+ * Installer or operator detail, free-form, for a person.
733
+ *
734
+ * @generated from field: string description = 8;
735
+ */
736
+ description: string;
737
+
738
+ /**
739
+ * Whether the backend the connector drives is working, as the connector last reported it
740
+ * (see connector.v1.BackendHealthReport): state and category only — the connector's own
741
+ * detail stays in the gateway's logs. Unset when the connector has stated nothing, which
742
+ * reads as OK. FAILING is what opens a reporting.v1.PROBLEM_KIND_CONNECTOR_ERROR, and
743
+ * while it holds the app may offer ReconnectConnector.
744
+ *
745
+ * @generated from field: kusinta.iot.common.v1.BackendHealth backend_health = 9;
746
+ */
747
+ backendHealth?: BackendHealth | undefined;
748
+
749
+ /**
750
+ * The connector can re-initialise its backend on request: ReconnectConnector is
751
+ * refused for any connector without it. Copied from the handshake, as the other
752
+ * capabilities are.
753
+ *
754
+ * @generated from field: bool supports_backend_reinitialize = 10;
755
+ */
756
+ supportsBackendReinitialize: boolean;
757
+ };
758
+
759
+ /**
760
+ * Describes the message kusinta.iot.webrtc.v1.ConnectorDescriptor.
761
+ * Use `create(ConnectorDescriptorSchema)` to create a new message.
762
+ */
763
+ export declare const ConnectorDescriptorSchema: GenMessage<ConnectorDescriptor>;
764
+
765
+ /**
766
+ * The connectors the gateway currently holds, gateway → app: those connected now. A
767
+ * connector whose stream drops leaves the list, and its backend health with it; it is
768
+ * listed again when it reconnects. The app offers ReconnectConnector only for a listed
769
+ * connector.
770
+ *
771
+ * A push, not a ManagementResult arm: a new result-oneof member is a compile error
772
+ * in a consumer whose match on the result is exhaustive, whereas a new push case is
773
+ * absorbed by that switch's default. Sent on connect and whenever the set changes —
774
+ * a connector arriving, leaving, revising its capabilities, or its backend health
775
+ * changing — and replaces the app's whole picture each time rather than being a delta,
776
+ * so a client that missed one re-syncs from the next.
777
+ *
778
+ * @generated from message kusinta.iot.webrtc.v1.ConnectorsAnnounced
779
+ */
780
+ export declare type ConnectorsAnnounced = Message<"kusinta.iot.webrtc.v1.ConnectorsAnnounced"> & {
781
+ /**
782
+ * @generated from field: repeated kusinta.iot.webrtc.v1.ConnectorDescriptor connectors = 1;
783
+ */
784
+ connectors: ConnectorDescriptor[];
785
+ };
786
+
787
+ /**
788
+ * Describes the message kusinta.iot.webrtc.v1.ConnectorsAnnounced.
789
+ * Use `create(ConnectorsAnnouncedSchema)` to create a new message.
790
+ */
791
+ export declare const ConnectorsAnnouncedSchema: GenMessage<ConnectorsAnnounced>;
792
+
793
+ /**
794
+ * A room's climate changed, gateway → app: its target, what set it, what it is being
795
+ * held at, its condition. Apply as an upsert keyed on room.space_id. Sent only for rooms
796
+ * the recipient may see, and whenever any field the recipient is sent moves — a knob
797
+ * turned by hand shows up here without the app asking. To a recipient who sees the room
798
+ * as service, what is new is sent as it happens and what is lost at once. A recipient who
799
+ * is sent the room with state_withheld is therefore not sent it when only withheld fields
800
+ * move.
801
+ *
802
+ * @generated from message kusinta.iot.webrtc.v1.RoomClimateChanged
803
+ */
804
+ export declare type RoomClimateChanged = Message<"kusinta.iot.webrtc.v1.RoomClimateChanged"> & {
805
+ /**
806
+ * @generated from field: kusinta.iot.climate.v1.RoomClimate room = 1;
807
+ */
808
+ room?: RoomClimate | undefined;
809
+ };
810
+
811
+ /**
812
+ * Describes the message kusinta.iot.webrtc.v1.RoomClimateChanged.
813
+ * Use `create(RoomClimateChangedSchema)` to create a new message.
814
+ */
815
+ export declare const RoomClimateChangedSchema: GenMessage<RoomClimateChanged>;
816
+
817
+ /**
818
+ * A mode on a space was switched on, changed or ended, gateway → app. `ended` rather than
819
+ * kind UNSPECIFIED, so an app can still name the mode that finished. A mode on an
820
+ * apartment or a room in one is sent to its residents only — whether a home stands empty
821
+ * is theirs to know; one on any other space, to whoever reaches it.
822
+ *
823
+ * @generated from message kusinta.iot.webrtc.v1.ClimateModeChanged
824
+ */
825
+ export declare type ClimateModeChanged = Message<"kusinta.iot.webrtc.v1.ClimateModeChanged"> & {
826
+ /**
827
+ * @generated from field: kusinta.iot.climate.v1.ClimateMode mode = 1;
828
+ */
829
+ mode?: ClimateMode | undefined;
830
+
831
+ /**
832
+ * @generated from field: bool ended = 2;
833
+ */
834
+ ended: boolean;
835
+ };
836
+
837
+ /**
838
+ * Describes the message kusinta.iot.webrtc.v1.ClimateModeChanged.
839
+ * Use `create(ClimateModeChangedSchema)` to create a new message.
840
+ */
841
+ export declare const ClimateModeChangedSchema: GenMessage<ClimateModeChanged>;
842
+
843
+ /**
331
844
  * @generated from message kusinta.iot.webrtc.v1.GatewayMessage
332
845
  */
333
846
  export declare type GatewayMessage = Message<"kusinta.iot.webrtc.v1.GatewayMessage"> & {
@@ -421,6 +934,74 @@ export declare type GatewayMessage = Message<"kusinta.iot.webrtc.v1.GatewayMessa
421
934
  */
422
935
  value: DeviceEventBatch;
423
936
  case: "deviceEvents";
937
+ } | {
938
+ /**
939
+ * @generated from field: kusinta.iot.webrtc.v1.PairingStarted pairing_started = 17;
940
+ */
941
+ value: PairingStarted;
942
+ case: "pairingStarted";
943
+ } | {
944
+ /**
945
+ * @generated from field: kusinta.iot.webrtc.v1.PairingFinished pairing_finished = 18;
946
+ */
947
+ value: PairingFinished;
948
+ case: "pairingFinished";
949
+ } | {
950
+ /**
951
+ * @generated from field: kusinta.iot.webrtc.v1.LinkChanged link_changed = 19;
952
+ */
953
+ value: LinkChanged;
954
+ case: "linkChanged";
955
+ } | {
956
+ /**
957
+ * @generated from field: kusinta.iot.webrtc.v1.ConnectorsAnnounced connectors_announced = 20;
958
+ */
959
+ value: ConnectorsAnnounced;
960
+ case: "connectorsAnnounced";
961
+ } | {
962
+ /**
963
+ * @generated from field: kusinta.iot.webrtc.v1.RoomClimateChanged room_climate_changed = 21;
964
+ */
965
+ value: RoomClimateChanged;
966
+ case: "roomClimateChanged";
967
+ } | {
968
+ /**
969
+ * @generated from field: kusinta.iot.webrtc.v1.ClimateModeChanged climate_mode_changed = 22;
970
+ */
971
+ value: ClimateModeChanged;
972
+ case: "climateModeChanged";
973
+ } | {
974
+ /**
975
+ * @generated from field: kusinta.iot.webrtc.v1.ServiceStatusChanged service_status_changed = 23;
976
+ */
977
+ value: ServiceStatusChanged;
978
+ case: "serviceStatusChanged";
979
+ } | {
980
+ /**
981
+ * A space's pending invites and join requests changed; see SpaceInvites.
982
+ *
983
+ * @generated from field: kusinta.iot.webrtc.v1.SpaceInvites space_invites = 24;
984
+ */
985
+ value: SpaceInvites;
986
+ case: "spaceInvites";
987
+ } | {
988
+ /**
989
+ * The promotion requests the session's user made or was asked to accept changed; see
990
+ * PromotionRequests.
991
+ *
992
+ * @generated from field: kusinta.iot.webrtc.v1.PromotionRequests promotion_requests = 25;
993
+ */
994
+ value: PromotionRequests;
995
+ case: "promotionRequests";
996
+ } | {
997
+ /**
998
+ * A commissioning test changed state: to every session whose user is given it
999
+ * (commissioning.v1), save its start to the session that started it.
1000
+ *
1001
+ * @generated from field: kusinta.iot.commissioning.v1.CommissioningTest commissioning_test = 26;
1002
+ */
1003
+ value: CommissioningTest;
1004
+ case: "commissioningTest";
424
1005
  } | { case: undefined; value?: undefined };
425
1006
  };
426
1007
 
@@ -497,6 +1078,12 @@ export declare type AppMessage = Message<"kusinta.iot.webrtc.v1.AppMessage"> & {
497
1078
  */
498
1079
  value: AttributeWriteRequest;
499
1080
  case: "attributeWrite";
1081
+ } | {
1082
+ /**
1083
+ * @generated from field: kusinta.iot.webrtc.v1.StartPairing start_pairing = 11;
1084
+ */
1085
+ value: StartPairing;
1086
+ case: "startPairing";
500
1087
  } | { case: undefined; value?: undefined };
501
1088
  };
502
1089
 
@@ -570,6 +1157,23 @@ export enum GatewayErrorCode {
570
1157
  * @generated from enum value: GATEWAY_ERROR_CODE_SESSION_LIMIT_REACHED = 5;
571
1158
  */
572
1159
  SESSION_LIMIT_REACHED = 5,
1160
+
1161
+ /**
1162
+ * The request was well formed and the caller may make it, but it will not succeed without
1163
+ * a change on the receiving side — a capability the target lacks, configuration only a
1164
+ * person can fix. Do not retry as is. Distinct from INVALID_REQUEST, which is the app's
1165
+ * bug, and from UNAVAILABLE, which clears on its own. GatewayError.metadata says which
1166
+ * precondition failed where the operation documents one. Sent only in answer to a request
1167
+ * whose operation documents it, never as a session-level error that refuses or ends a
1168
+ * session.
1169
+ *
1170
+ * Rollout note: a client whose schema predates this value decodes it as UNSPECIFIED,
1171
+ * which is retryable by design, so it may offer a retry that fails the same way again.
1172
+ * Harmless, but client handling should ship before or with the gateway that emits it.
1173
+ *
1174
+ * @generated from enum value: GATEWAY_ERROR_CODE_FAILED_PRECONDITION = 6;
1175
+ */
1176
+ FAILED_PRECONDITION = 6,
573
1177
  }
574
1178
 
575
1179
  /**