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

package/src/kusinta/iot/climate/v1/climate_pb.js

@@ -0,0 +1,142 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/climate/v1/climate.proto (package kusinta.iot.climate.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_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/climate/v1/climate.proto.
+ */
+export const file_kusinta_iot_climate_v1_climate = /*@__PURE__*/
+  fileDesc("CiRrdXNpbnRhL2lvdC9jbGltYXRlL3YxL2NsaW1hdGUucHJvdG8SFmt1c2ludGEuaW90LmNsaW1hdGUudjEiogEKDFRhcmdldENoYW5nZRImCgJhdBgBIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoEdXNlchgCIAEoCzIfLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlVzZXJJZEgAEjMKBmRldmljZRgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkSABCBAoCYnki/wUKC1Jvb21DbGltYXRlEjIKCHNwYWNlX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIgChN0YXJnZXRfY2VudGlkZWdyZWVzGAIgASgRSACIAQESOwoNdGFyZ2V0X2NoYW5nZRgDIAEoCzIkLmt1c2ludGEuaW90LmNsaW1hdGUudjEuVGFyZ2V0Q2hhbmdlEioKHWVmZmVjdGl2ZV90YXJnZXRfY2VudGlkZWdyZWVzGAQgASgRSAGIAQESFgoOb3ZlcnJpZGVzX21vZGUYBSABKAgSNwoNbW9kZV9zcGFjZV9pZBgNIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSHQoQbWluX2NlbnRpZGVncmVlcxgGIAEoEUgCiAEBEh0KEG1heF9jZW50aWRlZ3JlZXMYByABKBFIA4gBARI1CgpzZW5zb3JfaWRzGAggAygLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSGgoSc2Vuc29yc19jb25maWd1cmVkGA4gASgIEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgJIAEoEUgEiAEBEjYKC21lYXN1cmVkX2J5GAogASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPwoJY29uZGl0aW9uGAsgASgOMiwua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5Sb29tQ2xpbWF0ZUNvbmRpdGlvbhIcChRsb2NrX2RldmljZV9jb250cm9scxgMIAEoCBIWCg5zdGF0ZV93aXRoaGVsZBgPIAEoCEIWChRfdGFyZ2V0X2NlbnRpZGVncmVlc0IgCh5fZWZmZWN0aXZlX3RhcmdldF9jZW50aWRlZ3JlZXNCEwoRX21pbl9jZW50aWRlZ3JlZXNCEwoRX21heF9jZW50aWRlZ3JlZXNCGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlcyKDAwoLQ2xpbWF0ZU1vZGUSMgoIc3BhY2VfaWQYASABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEjUKBGtpbmQYAiABKA4yJy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVNb2RlS2luZBIhChRzZXRiYWNrX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEi0KCXN0YXJ0c19hdBgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASKwoHZW5kc19hdBgFIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASLwoGc2V0X2J5GAYgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkEjIKCXdhcm1fZnJvbRgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAYgBAUIXChVfc2V0YmFja19jZW50aWRlZ3JlZXNCDAoKX3dhcm1fZnJvbSJ5Cg9Sb29tQ2xpbWF0ZUxpc3QSMgoFcm9vbXMYASADKAsyIy5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21DbGltYXRlEjIKBW1vZGVzGAIgAygLMiMua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlTW9kZSLzAgoRUm9vbUhpc3RvcnlTYW1wbGUSJgoCYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgCIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYAyABKBFIAYgBARIqCh1lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlcxgEIAEoEUgCiAEBEiAKE3ZhbHZlX29wZW5fcGVybWlsbGUYBSABKA1IA4gBARIfChJ2YWx2ZV9vcGVuX3NlY29uZHMYBiABKA1IBIgBAUIYChZfbWVhc3VyZWRfY2VudGlkZWdyZWVzQhYKFF90YXJnZXRfY2VudGlkZWdyZWVzQiAKHl9lZmZlY3RpdmVfdGFyZ2V0X2NlbnRpZGVncmVlc0IWChRfdmFsdmVfb3Blbl9wZXJtaWxsZUIVChNfdmFsdmVfb3Blbl9zZWNvbmRzIqsBCgtSb29tSGlzdG9yeRIxCgdyb29tX2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBItCglrZXB0X2Zyb20YAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjoKB3NhbXBsZXMYAyADKAsyKS5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLlJvb21IaXN0b3J5U2FtcGxlItQCChFDbGltYXRlUGVyaW9kTWVhbhItCglzdGFydHNfYXQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEisKB2VuZHNfYXQYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiIKFW1lYXN1cmVkX2NlbnRpZGVncmVlcxgDIAEoEUgAiAEBEiAKE3RhcmdldF9jZW50aWRlZ3JlZXMYBCABKBFIAYgBARIiChptZWFzdXJlZF9jb3ZlcmFnZV9wZXJtaWxsZRgFIAEoDRIgChh0YXJnZXRfY292ZXJhZ2VfcGVybWlsbGUYBiABKA0SFgoOcm9vbXNfbWVhc3VyZWQYByABKA0SDQoFcm9vbXMYCCABKA1CGAoWX21lYXN1cmVkX2NlbnRpZGVncmVlc0IWChRfdGFyZ2V0X2NlbnRpZGVncmVlcyK+AgoXQXBhcnRtZW50Q2xpbWF0ZVN1bW1hcnkSNgoMYXBhcnRtZW50X2lkGAEgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBI8CgZwZXJpb2QYAiABKA4yLC5rdXNpbnRhLmlvdC5jbGltYXRlLnYxLkNsaW1hdGVTdW1tYXJ5UGVyaW9kEkIKCXdlaWdodGluZxgDIAEoDjIvLmt1c2ludGEuaW90LmNsaW1hdGUudjEuQ2xpbWF0ZVN1bW1hcnlXZWlnaHRpbmcSLQoJa2VwdF9mcm9tGAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI6CgdwZXJpb2RzGAUgAygLMikua3VzaW50YS5pb3QuY2xpbWF0ZS52MS5DbGltYXRlUGVyaW9kTWVhbirVAgoUUm9vbUNsaW1hdGVDb25kaXRpb24SJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9VTlNQRUNJRklFRBAAEiIKHlJPT01fQ0xJTUFURV9DT05ESVRJT05fSE9MRElORxABEiQKIFJPT01fQ0xJTUFURV9DT05ESVRJT05fTk9fVEFSR0VUEAISJgoiUk9PTV9DTElNQVRFX0NPTkRJVElPTl9TRU5TT1JfTE9TVBADEiYKIlJPT01fQ0xJTUFURV9DT05ESVRJT05fV0lORE9XX09QRU4QBBIlCiFST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX0hFQVRJTkcQBRIuCipST09NX0NMSU1BVEVfQ09ORElUSU9OX0hFQVRJTkdfVU5SRUFDSEFCTEUQBhIkCiBST09NX0NMSU1BVEVfQ09ORElUSU9OX05PX1NFTlNPUhAHKm8KD0NsaW1hdGVNb2RlS2luZBIhCh1DTElNQVRFX01PREVfS0lORF9VTlNQRUNJRklFRBAAEhoKFkNMSU1BVEVfTU9ERV9LSU5EX0FXQVkQARIdChlDTElNQVRFX01PREVfS0lORF9IT0xJREFZEAIqoQEKFENsaW1hdGVTdW1tYXJ5UGVyaW9kEiYKIkNMSU1BVEVfU1VNTUFSWV9QRVJJT0RfVU5TUEVDSUZJRUQQABIeChpDTElNQVRFX1NVTU1BUllfUEVSSU9EX0RBWRABEh8KG0NMSU1BVEVfU1VNTUFSWV9QRVJJT0RfV0VFSxACEiAKHENMSU1BVEVfU1VNTUFSWV9QRVJJT0RfTU9OVEgQAypvChdDbGltYXRlU3VtbWFyeVdlaWdodGluZxIpCiVDTElNQVRFX1NVTU1BUllfV0VJR0hUSU5HX1VOU1BFQ0lGSUVEEAASKQolQ0xJTUFURV9TVU1NQVJZX1dFSUdIVElOR19ST09NU19FUVVBTBABQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_identity_v1_identity]);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.TargetChange.
+ * Use `create(TargetChangeSchema)` to create a new message.
+ */
+export const TargetChangeSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 0);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimate.
+ * Use `create(RoomClimateSchema)` to create a new message.
+ */
+export const RoomClimateSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 1);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimateMode.
+ * Use `create(ClimateModeSchema)` to create a new message.
+ */
+export const ClimateModeSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 2);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimateList.
+ * Use `create(RoomClimateListSchema)` to create a new message.
+ */
+export const RoomClimateListSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 3);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistorySample.
+ * Use `create(RoomHistorySampleSchema)` to create a new message.
+ */
+export const RoomHistorySampleSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 4);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistory.
+ * Use `create(RoomHistorySchema)` to create a new message.
+ */
+export const RoomHistorySchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 5);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimatePeriodMean.
+ * Use `create(ClimatePeriodMeanSchema)` to create a new message.
+ */
+export const ClimatePeriodMeanSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 6);
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ApartmentClimateSummary.
+ * Use `create(ApartmentClimateSummarySchema)` to create a new message.
+ */
+export const ApartmentClimateSummarySchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_climate_v1_climate, 7);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.RoomClimateCondition.
+ */
+export const RoomClimateConditionSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 0);
+
+/**
+ * What a room is doing right now, in one word. Details live in the fields of
+ * RoomClimate; this is what a list row shows.
+ *
+ * Where several hold at once the room reports the first that applies, in this order:
+ * NO_TARGET, NO_HEATING, WINDOW_OPEN, HEATING_UNREACHABLE, SENSOR_LOST, NO_SENSOR,
+ * HOLDING — the one that most changes what a person should expect of the room.
+ *
+ * @generated from enum kusinta.iot.climate.v1.RoomClimateCondition
+ */
+export const RoomClimateCondition = /*@__PURE__*/
+  tsEnum(RoomClimateConditionSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateModeKind.
+ */
+export const ClimateModeKindSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 1);
+
+/**
+ * A setback that applies to every room in a space while it is on.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateModeKind
+ */
+export const ClimateModeKind = /*@__PURE__*/
+  tsEnum(ClimateModeKindSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryPeriod.
+ */
+export const ClimateSummaryPeriodSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 2);
+
+/**
+ * The length of the periods an ApartmentClimateSummary is given in. Each period runs from
+ * the start of one local date to the start of another in the building's time zone
+ * (space.v1.Space.time_zone) — midnight, or the first moment of the date where daylight
+ * saving skips midnight — so a day is 23 or 25 hours long across a change of daylight
+ * saving time. A period is cut by the time zone in force when it opened, and kept as cut.
+ * After a change of zone, the next period runs from that cut to the first boundary of its
+ * length in the new zone — a midnight, a Monday or a first of the month — that leaves it
+ * covering at least one whole day, week or month of the new zone's calendar, so no period
+ * covers less than one whole day, week or month of its calendar, however many hours that
+ * is. While the zone is unknown — never set, or cleared — nothing is summarised, and the
+ * period open when it was cleared ends unsummarised; once it is known again, the first
+ * period begins at the first boundary of its length after that.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryPeriod
+ */
+export const ClimateSummaryPeriod = /*@__PURE__*/
+  tsEnum(ClimateSummaryPeriodSchema);
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryWeighting.
+ */
+export const ClimateSummaryWeightingSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_climate_v1_climate, 3);
+
+/**
+ * How an apartment's mean is formed from its rooms' means.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryWeighting
+ */
+export const ClimateSummaryWeighting = /*@__PURE__*/
+  tsEnum(ClimateSummaryWeightingSchema);
+

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

@@ -0,0 +1,217 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/common/v1/pairing.proto (package kusinta.iot.common.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file kusinta/iot/common/v1/pairing.proto.
+ */
+export declare const file_kusinta_iot_common_v1_pairing: GenFile;
+
+/**
+ * A pairing failure and what can be said about it, the pairing counterpart of CommandError.
+ *
+ * The message matters more here than elsewhere: DEVICE_UNUSABLE is the code a user is most
+ * likely to see and least able to act on, and naming the device that joined is the whole
+ * difference between "something went wrong" and "this hub does not support that model yet".
+ *
+ * @generated from message kusinta.iot.common.v1.PairingErrorDetail
+ */
+export declare type PairingErrorDetail = Message<"kusinta.iot.common.v1.PairingErrorDetail"> & {
+  /**
+   * @generated from field: kusinta.iot.common.v1.PairingError code = 1;
+   */
+  code: PairingError;
+
+  /**
+   * human-readable; may name the device, its model, or the fault
+   *
+   * @generated from field: string message = 2;
+   */
+  message: string;
+};
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingErrorDetail.
+ * Use `create(PairingErrorDetailSchema)` to create a new message.
+ */
+export declare const PairingErrorDetailSchema: GenMessage<PairingErrorDetail>;
+
+/**
+ * How long a hub accepts new devices, and which it will take.
+ *
+ * One message on both legs rather than the same three fields declared twice: the clamp rule
+ * and the meaning of a hint are the sort of thing that is written once and then diverges,
+ * and the two copies had already begun to.
+ *
+ * @generated from message kusinta.iot.common.v1.PairingWindow
+ */
+export declare type PairingWindow = Message<"kusinta.iot.common.v1.PairingWindow"> & {
+  /**
+   * How long to accept arrivals. Whoever forwards this clamps it, and so does whoever acts
+   * on it: a window is an interval during which anything nearby can join, so its length is a
+   * security parameter rather than purely the caller's to choose.
+   *
+   * Absent means "no preference, use the default" — distinct from a caller asking for zero.
+   *
+   * @generated from field: optional uint32 duration_seconds = 1;
+   */
+  durationSeconds?: number | undefined;
+
+  /**
+   * The identifier printed on the device being paired, where the technology has one that is
+   * legible and the person is holding it. Free-form: what is printed differs per technology,
+   * and nothing between the app and the hub interprets it.
+   *
+   * Setting it changes the mechanism, not just the accuracy. The hub is restricted to that
+   * device and the arrival is verified against this value, so an arrival is attributed on
+   * identity. Leaving it empty opens the window to anything nearby, and attribution falls
+   * back to the arrival being the only one — which is why one window may be open at a time.
+   *
+   * Verification is not optional where this is set. A restriction can silently fail to take,
+   * and an arrival attributed on a restriction that did not hold is the wrong device in
+   * someone's home.
+   *
+   * @generated from field: string device_hint = 2;
+   */
+  deviceHint: string;
+
+  /**
+   * How many arrivals this one window may attribute. Absent means one.
+   *
+   * A batch suits commissioning, where devices are paired in a row and become a building's
+   * rather than any person's. It does not suit a caller whose pairing mints personal
+   * ownership.
+   *
+   * Ignored where device_hint is set, and narrowed to one rather than refused: a hint names
+   * one device, so a window restricted to it can never produce a second arrival to attribute.
+   * The combination is meaningless rather than dangerous, and there is no honest code in
+   * PairingError for "your request contradicted itself" — refusing it would mean answering a
+   * malformed request with an entitlement decision that was never made.
+   *
+   * @generated from field: optional uint32 max_devices = 3;
+   */
+  maxDevices?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingWindow.
+ * Use `create(PairingWindowSchema)` to create a new message.
+ */
+export declare const PairingWindowSchema: GenMessage<PairingWindow>;
+
+/**
+ * Why a pairing attempt did not produce a device, in one vocabulary both the app and a
+ * connector speak.
+ *
+ * Shared rather than mirrored, for the reason CommandError's comment gives: mirrored enums
+ * leave every connector inventing its own spellings and something in the middle keeping a
+ * translation table that silently falls behind. A connector produces the subset it can
+ * observe; the gateway produces the rest and passes a connector's value through unchanged.
+ *
+ * Every value answers one question: *what should the client do now?* A code that does not
+ * change the answer does not need to exist, which is why "the device is on the hub and
+ * unusable" is one value and not two.
+ *
+ * @generated from enum kusinta.iot.common.v1.PairingError
+ */
+export enum PairingError {
+  /**
+   * Sender set no code, or sent one this client's schema does not know.
+   *
+   * This must stay the safe reading. A client decodes every value added after its build as
+   * UNSPECIFIED, so the sensible handling is "it did not work, offering a retry is
+   * reasonable" — and no value below is so dangerous that reading it this way misleads.
+   *
+   * @generated from enum value: PAIRING_ERROR_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The caller may not pair here. Permanent for this caller: stop, and say so.
+   *
+   * @generated from enum value: PAIRING_ERROR_NOT_ENTITLED = 1;
+   */
+  NOT_ENTITLED = 1,
+
+  /**
+   * A pairing window is already open, and only one may be. Retrying after it closes is the
+   * right response; retrying at once is not.
+   *
+   * The exclusivity is not incidental. Where a request names no device, the only thing
+   * attributing an arrival to a requester is that theirs was the one window open.
+   *
+   * @generated from enum value: PAIRING_ERROR_ALREADY_IN_PROGRESS = 2;
+   */
+  ALREADY_IN_PROGRESS = 2,
+
+  /**
+   * The connector could not be reached, or refused to open its window. Transient.
+   *
+   * @generated from enum value: PAIRING_ERROR_CONNECTOR_UNAVAILABLE = 3;
+   */
+  CONNECTOR_UNAVAILABLE = 3,
+
+  /**
+   * The window closed with nothing paired: no device was put into pairing mode, or it was
+   * out of range, or its batteries are flat. The ordinary outcome of a user who walked away,
+   * so the useful response is to say what to do and offer another go, not to report a fault.
+   *
+   * @generated from enum value: PAIRING_ERROR_NO_DEVICE_APPEARED = 4;
+   */
+  NO_DEVICE_APPEARED = 4,
+
+  /**
+   * A device joined the hub and cannot be presented — the connector has no model for it, or
+   * could not assemble a complete description of it.
+   *
+   * One value rather than two, because the client does the same thing either way: stop, do
+   * not retry, and tell the user there is now an unusable device on their hub. Which of the
+   * two it was belongs in PairingErrorDetail.message, where it can name the device.
+   *
+   * It stays joined deliberately. A later connector release that models it adopts it with
+   * nobody returning to the hardware, where removing it would need someone standing there.
+   *
+   * @generated from enum value: PAIRING_ERROR_DEVICE_UNUSABLE = 5;
+   */
+  DEVICE_UNUSABLE = 5,
+
+  /**
+   * A device joined that is not the one the request named. The connector checked the arrival
+   * against the identifier it was given and they did not match, so it was not attributed.
+   *
+   * @generated from enum value: PAIRING_ERROR_WRONG_DEVICE = 6;
+   */
+  WRONG_DEVICE = 6,
+
+  /**
+   * A fault on the gateway's or the connector's own side. Not the caller's doing.
+   *
+   * @generated from enum value: PAIRING_ERROR_INTERNAL = 7;
+   */
+  INTERNAL = 7,
+
+  /**
+   * The request named no connector. Pairing always targets exactly one connector,
+   * chosen from the connector enumeration; an untargeted "pair anything" is refused
+   * rather than fanned out across every hub. Permanent for the request as sent —
+   * naming a connector and asking again is the fix, retrying identically is not —
+   * which is why this is not CONNECTOR_UNAVAILABLE, whose retry is reasonable.
+   *
+   * The gateway is the enforcer: connector_id is a message field, so proto cannot
+   * mark it required, and the check lives where the fan-out used to. A client whose
+   * schema predates this reads it as UNSPECIFIED and offers a retry, which is
+   * harmless — an app built against the enumeration always names a connector anyway.
+   *
+   * @generated from enum value: PAIRING_ERROR_CONNECTOR_REQUIRED = 8;
+   */
+  CONNECTOR_REQUIRED = 8,
+}
+
+/**
+ * Describes the enum kusinta.iot.common.v1.PairingError.
+ */
+export declare const PairingErrorSchema: GenEnum<PairingError>;
+

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

@@ -0,0 +1,50 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/common/v1/pairing.proto (package kusinta.iot.common.v1, syntax proto3)
+/* eslint-disable */
+
+import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file kusinta/iot/common/v1/pairing.proto.
+ */
+export const file_kusinta_iot_common_v1_pairing = /*@__PURE__*/
+  fileDesc("CiNrdXNpbnRhL2lvdC9jb21tb24vdjEvcGFpcmluZy5wcm90bxIVa3VzaW50YS5pb3QuY29tbW9uLnYxIlgKElBhaXJpbmdFcnJvckRldGFpbBIxCgRjb2RlGAEgASgOMiMua3VzaW50YS5pb3QuY29tbW9uLnYxLlBhaXJpbmdFcnJvchIPCgdtZXNzYWdlGAIgASgJIoIBCg1QYWlyaW5nV2luZG93Eh0KEGR1cmF0aW9uX3NlY29uZHMYASABKA1IAIgBARITCgtkZXZpY2VfaGludBgCIAEoCRIYCgttYXhfZGV2aWNlcxgDIAEoDUgBiAEBQhMKEV9kdXJhdGlvbl9zZWNvbmRzQg4KDF9tYXhfZGV2aWNlcyrIAgoMUGFpcmluZ0Vycm9yEh0KGVBBSVJJTkdfRVJST1JfVU5TUEVDSUZJRUQQABIeChpQQUlSSU5HX0VSUk9SX05PVF9FTlRJVExFRBABEiUKIVBBSVJJTkdfRVJST1JfQUxSRUFEWV9JTl9QUk9HUkVTUxACEicKI1BBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1VOQVZBSUxBQkxFEAMSJAogUEFJUklOR19FUlJPUl9OT19ERVZJQ0VfQVBQRUFSRUQQBBIhCh1QQUlSSU5HX0VSUk9SX0RFVklDRV9VTlVTQUJMRRAFEh4KGlBBSVJJTkdfRVJST1JfV1JPTkdfREVWSUNFEAYSGgoWUEFJUklOR19FUlJPUl9JTlRFUk5BTBAHEiQKIFBBSVJJTkdfRVJST1JfQ09OTkVDVE9SX1JFUVVJUkVEEAhCAkgBYgZwcm90bzM");
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingErrorDetail.
+ * Use `create(PairingErrorDetailSchema)` to create a new message.
+ */
+export const PairingErrorDetailSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_common_v1_pairing, 0);
+
+/**
+ * Describes the message kusinta.iot.common.v1.PairingWindow.
+ * Use `create(PairingWindowSchema)` to create a new message.
+ */
+export const PairingWindowSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_common_v1_pairing, 1);
+
+/**
+ * Describes the enum kusinta.iot.common.v1.PairingError.
+ */
+export const PairingErrorSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_common_v1_pairing, 0);
+
+/**
+ * Why a pairing attempt did not produce a device, in one vocabulary both the app and a
+ * connector speak.
+ *
+ * Shared rather than mirrored, for the reason CommandError's comment gives: mirrored enums
+ * leave every connector inventing its own spellings and something in the middle keeping a
+ * translation table that silently falls behind. A connector produces the subset it can
+ * observe; the gateway produces the rest and passes a connector's value through unchanged.
+ *
+ * Every value answers one question: *what should the client do now?* A code that does not
+ * change the answer does not need to exist, which is why "the device is on the hub and
+ * unusable" is one value and not two.
+ *
+ * @generated from enum kusinta.iot.common.v1.PairingError
+ */
+export const PairingError = /*@__PURE__*/
+  tsEnum(PairingErrorSchema);
+

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

@@ -36,6 +36,37 @@ export declare type ErrorDetail = Message<"kusinta.iot.common.v1.ErrorDetail"> &
  */
 export declare const ErrorDetailSchema: GenMessage<ErrorDetail>;
 
+/**
+ * A connector's backend health, as both legs carry it: connector to gateway inside
+ * connector.v1.BackendHealthReport, and gateway to app on webrtc.v1.ConnectorDescriptor.
+ *
+ * Deliberately state and category only. A connector's free-text detail travels beside this,
+ * on the connector leg alone, and is for the gateway's logs: it may name hosts, addresses or
+ * accounts, and it never reaches the app or the cloud. Carrying only this type on the app
+ * leg is what keeps it there.
+ *
+ * @generated from message kusinta.iot.common.v1.BackendHealth
+ */
+export declare type BackendHealth = Message<"kusinta.iot.common.v1.BackendHealth"> & {
+  /**
+   * @generated from field: kusinta.iot.common.v1.BackendHealthState state = 1;
+   */
+  state: BackendHealthState;
+
+  /**
+   * Why, when state is FAILING. UNSPECIFIED otherwise, and ignored when state is not FAILING.
+   *
+   * @generated from field: kusinta.iot.common.v1.BackendFailureReason reason = 2;
+   */
+  reason: BackendFailureReason;
+};
+
+/**
+ * Describes the message kusinta.iot.common.v1.BackendHealth.
+ * Use `create(BackendHealthSchema)` to create a new message.
+ */
+export declare const BackendHealthSchema: GenMessage<BackendHealth>;
+
 /**
  * @generated from enum kusinta.iot.common.v1.SpaceType
  */
@@ -161,3 +192,147 @@ export enum ConnectorTransport {
  */
 export declare const ConnectorTransportSchema: GenEnum<ConnectorTransport>;
 
+/**
+ * What technology a connector speaks, for an interface to pick an icon or an
+ * explanatory phrase. Presentation only, and never a behaviour gate: what a
+ * connector can do is stated by the capability booleans on ConnectorInfo
+ * (supports_pairing, supports_provisioning, brokers_links), and branching on the
+ * kind instead would hardcode vendor knowledge and force a client change for every
+ * new technology. A proto3 open enum: a reader given a value its schema predates
+ * keeps UNSPECIFIED's fallback rather than failing, which is exactly why the kind
+ * may never decide anything that matters.
+ *
+ * @generated from enum kusinta.iot.common.v1.ConnectorKind
+ */
+export enum ConnectorKind {
+  /**
+   * @generated from enum value: CONNECTOR_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: CONNECTOR_KIND_HOMEMATIC_IP = 1;
+   */
+  HOMEMATIC_IP = 1,
+
+  /**
+   * @generated from enum value: CONNECTOR_KIND_LORAWAN = 2;
+   */
+  LORAWAN = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.common.v1.ConnectorKind.
+ */
+export declare const ConnectorKindSchema: GenEnum<ConnectorKind>;
+
+/**
+ * Whether the backend a connector drives is working: the radio central, the network server,
+ * whatever the connector talks to on the far side from the gateway. Distinct from whether
+ * the connector itself is connected — that is the gateway↔connector stream, and a connector
+ * whose stream is down states nothing at all.
+ *
+ * Open, like every proto3 enum: a reader given a value its schema predates holds the number.
+ * Every reader treats anything but FAILING as healthy, so a state added later must be one an
+ * older reader may safely take for OK. A new way of failing is a new BackendFailureReason
+ * under FAILING, never a new state.
+ *
+ * @generated from enum kusinta.iot.common.v1.BackendHealthState
+ */
+export enum BackendHealthState {
+  /**
+   * No statement. Read as OK: a connector that predates backend health, or one whose backend
+   * is still in doubt as it handshakes (see connector.v1.BackendHealthReport), has said
+   * nothing is wrong.
+   *
+   * @generated from enum value: BACKEND_HEALTH_STATE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The backend is reachable and answering.
+   *
+   * @generated from enum value: BACKEND_HEALTH_STATE_OK = 1;
+   */
+  OK = 1,
+
+  /**
+   * The backend is failing, and not for a single dropped call: it has been in doubt for 60
+   * seconds within the last 120 (see connector.v1.BackendHealthReport), or the connector's own
+   * retries are used up, or a requested re-initialisation
+   * left it failing (see connector.v1.BackendHealthReport). The connector stays connected to
+   * the gateway.
+   *
+   * @generated from enum value: BACKEND_HEALTH_STATE_FAILING = 2;
+   */
+  FAILING = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.common.v1.BackendHealthState.
+ */
+export declare const BackendHealthStateSchema: GenEnum<BackendHealthState>;
+
+/**
+ * Why a backend is failing, or why a re-initialisation could not be attempted. Coarse on
+ * purpose: each value answers "what should someone do now?", and the specifics belong in a
+ * connector's log-only detail, never here.
+ *
+ * Shared rather than mirrored, for the reason PairingError gives: the connector produces it
+ * and the gateway passes it through unchanged.
+ *
+ * @generated from enum kusinta.iot.common.v1.BackendFailureReason
+ */
+export enum BackendFailureReason {
+  /**
+   * Not stated, or a value this reader's schema does not know. Read as BACKEND_ERROR.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The backend cannot be reached: no route, connection refused, no answer. Often a power or
+   * network fault at the backend's side; a re-initialisation may help once that is fixed.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_UNREACHABLE = 1;
+   */
+  UNREACHABLE = 1,
+
+  /**
+   * The backend answered and refused the connector's credentials. Retrying the same
+   * credentials will not help; someone must change them.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_AUTH_FAILED = 2;
+   */
+  AUTH_FAILED = 2,
+
+  /**
+   * The backend is reached and authenticated, but answers with errors or not as the connector
+   * expects: a fault on the backend's side, or a version the connector does not understand.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_BACKEND_ERROR = 3;
+   */
+  BACKEND_ERROR = 3,
+
+  /**
+   * The connector lacks what it needs to reach the backend at all: an address, credentials.
+   * Needs an installer, not a retry.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_MISCONFIGURED = 4;
+   */
+  MISCONFIGURED = 4,
+
+  /**
+   * A fault in the connector itself, not in the backend.
+   *
+   * @generated from enum value: BACKEND_FAILURE_REASON_INTERNAL = 5;
+   */
+  INTERNAL = 5,
+}
+
+/**
+ * Describes the enum kusinta.iot.common.v1.BackendFailureReason.
+ */
+export declare const BackendFailureReasonSchema: GenEnum<BackendFailureReason>;
+