@kusinta/iot-schema 0.2.0-beta.6 → 0.2.0-beta.61

package/src/kusinta/iot/heating/v1/heating_pb.js

@@ -0,0 +1,119 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/heating/v1/heating.proto (package kusinta.iot.heating.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_access_v1_acl } from "../../access/v1/acl_pb.js";
+import { file_kusinta_iot_device_v1_cluster_state } from "../../device/v1/cluster_state_pb.js";
+import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/heating/v1/heating.proto.
+ */
+export const file_kusinta_iot_heating_v1_heating = /*@__PURE__*/
+  fileDesc("CiRrdXNpbnRhL2lvdC9oZWF0aW5nL3YxL2hlYXRpbmcucHJvdG8SFmt1c2ludGEuaW90LmhlYXRpbmcudjEifwoPRGV2aWNlQXR0cmlidXRlEjQKCWRldmljZV9pZBgBIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEjYKCWF0dHJpYnV0ZRgCIAEoCzIjLmt1c2ludGEuaW90LmFjY2Vzcy52MS5BdHRyaWJ1dGVSZWYihgEKDkNvbnRhY3RCaW5kaW5nEjcKBm91dHB1dBgBIAEoCzInLmt1c2ludGEuaW90LmhlYXRpbmcudjEuRGV2aWNlQXR0cmlidXRlEjsKDGNsb3NlZF92YWx1ZRgCIAEoCzIlLmt1c2ludGEuaW90LmRldmljZS52MS5BdHRyaWJ1dGVWYWx1ZSLsAgoMSGVhdGluZ1BsYW50EhAKCHBsYW50X2lkGAEgASgJEjIKCHNwYWNlX2lkGAIgASgLMiAua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuU3BhY2VJZBIMCgRuYW1lGAMgASgJEjYKBnNvdXJjZRgEIAEoDjImLmt1c2ludGEuaW90LmhlYXRpbmcudjEuSGVhdFNvdXJjZUtpbmQSPQoScmVhZGluZ3NfZGV2aWNlX2lkGAUgASgLMiEua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuRGV2aWNlSWQSPAoJaGVhdF9wdW1wGAYgASgLMicua3VzaW50YS5pb3QuaGVhdGluZy52MS5IZWF0UHVtcENvbnRyb2xIABI2CgVtZXRlchgHIAEoCzInLmt1c2ludGEuaW90LmhlYXRpbmcudjEuRGV2aWNlQXR0cmlidXRlEhAKCHJldmlzaW9uGAggASgEQgkKB2NvbnRyb2wi1gEKD0hlYXRQdW1wQ29udHJvbBI+Cg5zZ19yZWFkeV9ibG9jaxgBIAEoCzImLmt1c2ludGEuaW90LmhlYXRpbmcudjEuQ29udGFjdEJpbmRpbmcSPgoOc2dfcmVhZHlfYm9vc3QYAiABKAsyJi5rdXNpbnRhLmlvdC5oZWF0aW5nLnYxLkNvbnRhY3RCaW5kaW5nEkMKE2FkZF9vbl9oZWF0ZXJfYmxvY2sYAyABKAsyJi5rdXNpbnRhLmlvdC5oZWF0aW5nLnYxLkNvbnRhY3RCaW5kaW5nItoBCg5IZWF0aW5nQ2lyY3VpdBISCgpjaXJjdWl0X2lkGAEgASgJEhAKCHBsYW50X2lkGAIgASgJEgwKBG5hbWUYAyABKAkSOwoIcmFkaWF0b3IYBCABKAsyJy5rdXNpbnRhLmlvdC5oZWF0aW5nLnYxLlJhZGlhdG9yQ2lyY3VpdEgAEjUKBWZsb29yGAUgASgLMiQua3VzaW50YS5pb3QuaGVhdGluZy52MS5GbG9vckNpcmN1aXRIABIQCghyZXZpc2lvbhgGIAEoBEIOCgxkaXN0cmlidXRpb24iEQoPUmFkaWF0b3JDaXJjdWl0IuQBCgxGbG9vckNpcmN1aXQSFAoMbWl4aW5nX3ZhbHZlGAEgASgIEiQKF3N1cHBseV9jYXBfY2VudGlkZWdyZWVzGAIgASgRSACIAQESPQoMc3VwcGx5X3Byb2JlGAMgASgLMicua3VzaW50YS5pb3QuaGVhdGluZy52MS5EZXZpY2VBdHRyaWJ1dGUSPQoMcmV0dXJuX3Byb2JlGAQgASgLMicua3VzaW50YS5pb3QuaGVhdGluZy52MS5EZXZpY2VBdHRyaWJ1dGVCGgoYX3N1cHBseV9jYXBfY2VudGlkZWdyZWVzIusCCglGbG9vclpvbmUSDwoHem9uZV9pZBgBIAEoCRISCgpjaXJjdWl0X2lkGAIgASgJEgwKBG5hbWUYAyABKAkSNgoGb3V0cHV0GAQgASgLMiYua3VzaW50YS5pb3QuaGVhdGluZy52MS5Db250YWN0QmluZGluZxI0CgVyb29tcxgFIAMoCzIlLmt1c2ludGEuaW90LmhlYXRpbmcudjEuRmxvb3Jab25lUm9vbRI5Cg9jb250cm9sX3Jvb21faWQYBiABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEhAKCHJldmlzaW9uGAcgASgEEjYKEnVuY29udHJvbGxlZF9zaW5jZRgIIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASOAoPdW5jb250cm9sbGVkX2J5GAkgASgLMh8ua3VzaW50YS5pb3QuaWRlbnRpdHkudjEuVXNlcklkIl8KDUZsb29yWm9uZVJvb20SMQoHcm9vbV9pZBgBIAEoCzIgLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLlNwYWNlSWQSGwoTYXJlYV9zaGFyZV9wZXJtaWxsZRgCIAEoDSKdAgoLQ29tZm9ydExvYWQSFwoPY29tZm9ydF9sb2FkX2lkGAEgASgJEjEKB3Jvb21faWQYAiABKAsyIC5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5TcGFjZUlkEgwKBG5hbWUYAyABKAkSNgoGb3V0cHV0GAQgASgLMiYua3VzaW50YS5pb3QuaGVhdGluZy52MS5Db250YWN0QmluZGluZxI2Cgd3aW5kb3dzGAUgAygLMiUua3VzaW50YS5pb3QuaGVhdGluZy52MS5Db21mb3J0V2luZG93EhAKCHJldmlzaW9uGAYgASgEEhgKEHdpbmRvd3NfcmV2aXNpb24YByABKAQSGAoQd2luZG93c193aXRoaGVsZBgIIAEoCCJLCg1Db21mb3J0V2luZG93EhAKCHdlZWtkYXlzGAEgASgNEhQKDHN0YXJ0X21pbnV0ZRgCIAEoDRISCgplbmRfbWludXRlGAMgASgNIvMBCg1IZWF0aW5nTGF5b3V0EjQKBnBsYW50cxgBIAMoCzIkLmt1c2ludGEuaW90LmhlYXRpbmcudjEuSGVhdGluZ1BsYW50EjgKCGNpcmN1aXRzGAIgAygLMiYua3VzaW50YS5pb3QuaGVhdGluZy52MS5IZWF0aW5nQ2lyY3VpdBI2CgtmbG9vcl96b25lcxgDIAMoCzIhLmt1c2ludGEuaW90LmhlYXRpbmcudjEuRmxvb3Jab25lEjoKDWNvbWZvcnRfbG9hZHMYBCADKAsyIy5rdXNpbnRhLmlvdC5oZWF0aW5nLnYxLkNvbWZvcnRMb2FkIoECCg1IZWF0aW5nUmVjb3JkEjUKBXBsYW50GAEgASgLMiQua3VzaW50YS5pb3QuaGVhdGluZy52MS5IZWF0aW5nUGxhbnRIABI5CgdjaXJjdWl0GAIgASgLMiYua3VzaW50YS5pb3QuaGVhdGluZy52MS5IZWF0aW5nQ2lyY3VpdEgAEjcKCmZsb29yX3pvbmUYAyABKAsyIS5rdXNpbnRhLmlvdC5oZWF0aW5nLnYxLkZsb29yWm9uZUgAEjsKDGNvbWZvcnRfbG9hZBgEIAEoCzIjLmt1c2ludGEuaW90LmhlYXRpbmcudjEuQ29tZm9ydExvYWRIAEIICgZyZWNvcmQqpQIKDkhlYXRTb3VyY2VLaW5kEiAKHEhFQVRfU09VUkNFX0tJTkRfVU5TUEVDSUZJRUQQABIqCiZIRUFUX1NPVVJDRV9LSU5EX0VYSEFVU1RfQUlSX0hFQVRfUFVNUBABEiwKKEhFQVRfU09VUkNFX0tJTkRfR1JPVU5EX1NPVVJDRV9IRUFUX1BVTVAQAhIoCiRIRUFUX1NPVVJDRV9LSU5EX0FJUl9XQVRFUl9IRUFUX1BVTVAQAxIlCiFIRUFUX1NPVVJDRV9LSU5EX0RJU1RSSUNUX0hFQVRJTkcQBBIkCiBIRUFUX1NPVVJDRV9LSU5EX0VMRUNUUklDX0JPSUxFUhAFEiAKHEhFQVRfU09VUkNFX0tJTkRfRlVFTF9CT0lMRVIQBkICSAFiBnByb3RvMw", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_device_v1_cluster_state, file_kusinta_iot_identity_v1_identity]);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.DeviceAttribute.
+ * Use `create(DeviceAttributeSchema)` to create a new message.
+ */
+export const DeviceAttributeSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 0);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.ContactBinding.
+ * Use `create(ContactBindingSchema)` to create a new message.
+ */
+export const ContactBindingSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 1);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.HeatingPlant.
+ * Use `create(HeatingPlantSchema)` to create a new message.
+ */
+export const HeatingPlantSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 2);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.HeatPumpControl.
+ * Use `create(HeatPumpControlSchema)` to create a new message.
+ */
+export const HeatPumpControlSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 3);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.HeatingCircuit.
+ * Use `create(HeatingCircuitSchema)` to create a new message.
+ */
+export const HeatingCircuitSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 4);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.RadiatorCircuit.
+ * Use `create(RadiatorCircuitSchema)` to create a new message.
+ */
+export const RadiatorCircuitSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 5);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.FloorCircuit.
+ * Use `create(FloorCircuitSchema)` to create a new message.
+ */
+export const FloorCircuitSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 6);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.FloorZone.
+ * Use `create(FloorZoneSchema)` to create a new message.
+ */
+export const FloorZoneSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 7);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.FloorZoneRoom.
+ * Use `create(FloorZoneRoomSchema)` to create a new message.
+ */
+export const FloorZoneRoomSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 8);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.ComfortLoad.
+ * Use `create(ComfortLoadSchema)` to create a new message.
+ */
+export const ComfortLoadSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 9);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.ComfortWindow.
+ * Use `create(ComfortWindowSchema)` to create a new message.
+ */
+export const ComfortWindowSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 10);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.HeatingLayout.
+ * Use `create(HeatingLayoutSchema)` to create a new message.
+ */
+export const HeatingLayoutSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 11);
+
+/**
+ * Describes the message kusinta.iot.heating.v1.HeatingRecord.
+ * Use `create(HeatingRecordSchema)` to create a new message.
+ */
+export const HeatingRecordSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_heating_v1_heating, 12);
+
+/**
+ * Describes the enum kusinta.iot.heating.v1.HeatSourceKind.
+ */
+export const HeatSourceKindSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_heating_v1_heating, 0);
+
+/**
+ * @generated from enum kusinta.iot.heating.v1.HeatSourceKind
+ */
+export const HeatSourceKind = /*@__PURE__*/
+  tsEnum(HeatSourceKindSchema);
+

package/src/kusinta/iot/link/v1/link_pb.d.ts

@@ -0,0 +1,438 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/link/v1/link.proto (package kusinta.iot.link.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { DeviceId } from "../../identity/v1/identity_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { AttributeRef } from "../../access/v1/acl_pb.js";
+
+/**
+ * Describes the file kusinta/iot/link/v1/link.proto.
+ */
+export declare const file_kusinta_iot_link_v1_link: GenFile;
+
+/**
+ * What a gateway-kept link of a given function needs told to it.
+ *
+ * Only a soft link has settings at all — see LINK_MODE_HARD for why there is
+ * nothing in a device-to-device link for anyone to tune. And what a soft link
+ * needs differs entirely by function: a climate lead needs a target
+ * temperature, while forwarding a window's open state needs nothing whatsoever.
+ * Hence a oneof per function rather than a flat set of fields: the second
+ * function to arrive must not turn this into a bag of unrelated optionals named
+ * after the first.
+ *
+ * A function with no arm here has nothing to configure, and an attempt to
+ * configure it should be refused rather than accepted as a no-op.
+ *
+ * @generated from message kusinta.iot.link.v1.LinkSettings
+ */
+export declare type LinkSettings = Message<"kusinta.iot.link.v1.LinkSettings"> & {
+  /**
+   * @generated from oneof kusinta.iot.link.v1.LinkSettings.per_function
+   */
+  perFunction: {
+    /**
+     * @generated from field: kusinta.iot.link.v1.ClimateLeadSettings climate_lead = 1;
+     */
+    value: ClimateLeadSettings;
+    case: "climateLead";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.link.v1.LinkSettings.
+ * Use `create(LinkSettingsSchema)` to create a new message.
+ */
+export declare const LinkSettingsSchema: GenMessage<LinkSettings>;
+
+/**
+ * Settings for a gateway-kept LINK_FUNCTION_CLIMATE_LEAD.
+ *
+ * @generated from message kusinta.iot.link.v1.ClimateLeadSettings
+ */
+export declare type ClimateLeadSettings = Message<"kusinta.iot.link.v1.ClimateLeadSettings"> & {
+  /**
+   * The temperature this link is to hold, in centidegrees — the unit and
+   * encoding device/v1/properties.proto declares for every temperature in this
+   * schema, so nothing converts between the target and the readings it is
+   * compared against.
+   *
+   * Deliberately not the receiver's own setpoint attribute. A gateway steering
+   * a radiator valve it cannot feed a measurement to has only that setpoint to
+   * act through, so the setpoint becomes an actuator position which moves on
+   * its own and settles wherever the target needs it to. It stops being a
+   * statement of what anybody asked for, which is why the request is kept here.
+   *
+   * Per link, and a sender may lead several receivers — a room with more than
+   * one radiator is the ordinary case, and each of its links carries this
+   * number separately. An interface offering "the temperature in here" is
+   * therefore setting several links at once and is responsible for keeping them
+   * equal; nothing on this wire enforces it. A single target per room is
+   * climate.v1.RoomClimate: a person sets the room's target there, and the
+   * gateway keeps the links it uses underneath in step. New interfaces set
+   * rooms, not this.
+   *
+   * One target, not one per heating and cooling mode: this addresses a valve
+   * that only heats. A device that can do both would need the setpoint's mode
+   * named alongside, the way webrtc/v1/setpoint_mode.proto names it for a
+   * command, and that is a new arm rather than a reinterpretation of this one.
+   *
+   * Explicit presence, per the rule properties.proto sets out: a settings
+   * message present with this never set must not be indistinguishable from a
+   * request to hold the room at 0.00 °C.
+   *
+   * @generated from field: optional sint32 target_setpoint = 1;
+   */
+  targetSetpoint?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.link.v1.ClimateLeadSettings.
+ * Use `create(ClimateLeadSettingsSchema)` to create a new message.
+ */
+export declare const ClimateLeadSettingsSchema: GenMessage<ClimateLeadSettings>;
+
+/**
+ * One device leading another.
+ *
+ * @generated from message kusinta.iot.link.v1.DeviceLink
+ */
+export declare type DeviceLink = Message<"kusinta.iot.link.v1.DeviceLink"> & {
+  /**
+   * Opaque, and must not encode when the link was made — a UUIDv4 is the expected form — since
+   * that time is withheld from some recipients (see created_at).
+   *
+   * @generated from field: string link_id = 1;
+   */
+  linkId: string;
+
+  /**
+   * Which device leads. This is the control surface for the pair: for a climate
+   * link, the setpoint that governs both is written here.
+   *
+   * @generated from field: kusinta.iot.identity.v1.DeviceId sender = 2;
+   */
+  sender?: DeviceId | undefined;
+
+  /**
+   * Which device follows. One sender may lead several receivers — a room with
+   * more than one radiator is the ordinary case — and each is its own link.
+   * Several senders leading one receiver is not modelled: combining two
+   * measurements needs a policy, and no policy is defined.
+   *
+   * @generated from field: kusinta.iot.identity.v1.DeviceId receiver = 3;
+   */
+  receiver?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkFunction function = 4;
+   */
+  function: LinkFunction;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkMode mode = 5;
+   */
+  mode: LinkMode;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkState state = 6;
+   */
+  state: LinkState;
+
+  /**
+   * Unset when it is withheld from the recipient: from service in a home, and from anyone
+   * when it dates from before their current residency in the home, or from a home they did
+   * not live in at the time (see access.v1.MembershipRelation).
+   *
+   * @generated from field: google.protobuf.Timestamp created_at = 7;
+   */
+  createdAt?: Timestamp | undefined;
+
+  /**
+   * Why the link is not carrying, when state says it is not. Free text for a
+   * person, never parsed.
+   *
+   * @generated from field: string state_detail = 8;
+   */
+  stateDetail: string;
+
+  /**
+   * How this link is configured, where its mode and function give it anything
+   * to configure. Unset on every hard link, and on a soft one nobody has set up
+   * yet — which is a link that exists and is not doing anything, not an error.
+   *
+   * Carried on the link rather than left to be asked for separately, because an
+   * interface showing a soft climate link has to show the room's target next to
+   * it, and the receiver's own setpoint is not that number.
+   *
+   * @generated from field: kusinta.iot.link.v1.LinkSettings settings = 9;
+   */
+  settings?: LinkSettings | undefined;
+
+  /**
+   * Set when the recipient sees this link as service, because an end is in a home (see
+   * access.v1.MembershipRelation): state, state_detail, settings and created_at are
+   * WITHHELD and left unset, not unconfigured. An app must not render it as a link doing
+   * nothing.
+   *
+   * @generated from field: bool details_withheld = 10;
+   */
+  detailsWithheld: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.link.v1.DeviceLink.
+ * Use `create(DeviceLinkSchema)` to create a new message.
+ */
+export declare const DeviceLinkSchema: GenMessage<DeviceLink>;
+
+/**
+ * What a device can be linked as, declared by the connector that models it.
+ *
+ * Without this an interface cannot offer a sensible choice: it has no way to know
+ * which of two devices may lead, whether a hub can broker them, or which
+ * attribute carries the quantity in question. Matching is mechanical — the same
+ * function, opposite directions, and a mode both ends support.
+ *
+ * Declared per device rather than per endpoint. Endpoint would be more precise,
+ * but the channels a link actually attaches to frequently carry no readings and
+ * so are not announced as endpoints at all; a per-endpoint declaration would have
+ * nowhere honest to live. The reserved range on DeviceLink is where that would go
+ * if a vendor ever needs it.
+ *
+ * @generated from message kusinta.iot.link.v1.LinkCapability
+ */
+export declare type LinkCapability = Message<"kusinta.iot.link.v1.LinkCapability"> & {
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkFunction function = 1;
+   */
+  function: LinkFunction;
+
+  /**
+   * @generated from field: kusinta.iot.link.v1.LinkDirection direction = 2;
+   */
+  direction: LinkDirection;
+
+  /**
+   * Modes this device supports for this function. A hard link additionally
+   * requires the other end to be on the same hub, which this cannot state alone.
+   *
+   * @generated from field: repeated kusinta.iot.link.v1.LinkMode supported_modes = 3;
+   */
+  supportedModes: LinkMode[];
+
+  /**
+   * This device's own attribute for this function — the one it reads as a
+   * sender, or the one it is driven through as a receiver. Present because the
+   * two ends of a link need not speak the same cluster.
+   *
+   * @generated from field: kusinta.iot.access.v1.AttributeRef attribute = 4;
+   */
+  attribute?: AttributeRef | undefined;
+
+  /**
+   * Human-readable, from the connector, in whatever locale it was given. For
+   * display beside a choice; never matched on.
+   *
+   * @generated from field: string label = 5;
+   */
+  label: string;
+};
+
+/**
+ * Describes the message kusinta.iot.link.v1.LinkCapability.
+ * Use `create(LinkCapabilitySchema)` to create a new message.
+ */
+export declare const LinkCapabilitySchema: GenMessage<LinkCapability>;
+
+/**
+ * Every link a caller was shown, in reply to a listing.
+ *
+ * @generated from message kusinta.iot.link.v1.DeviceLinkList
+ */
+export declare type DeviceLinkList = Message<"kusinta.iot.link.v1.DeviceLinkList"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.link.v1.DeviceLink links = 1;
+   */
+  links: DeviceLink[];
+};
+
+/**
+ * Describes the message kusinta.iot.link.v1.DeviceLinkList.
+ * Use `create(DeviceLinkListSchema)` to create a new message.
+ */
+export declare const DeviceLinkListSchema: GenMessage<DeviceLinkList>;
+
+/**
+ * What a link makes the sender do to the receiver.
+ *
+ * A function, not a cluster id, because the two ends do not necessarily speak the
+ * same cluster: a wall thermostat reports its temperature as Thermostat
+ * LocalTemperature while a bare sensor reports the same quantity as Temperature
+ * Measurement MeasuredValue. Each end states its own attribute in its
+ * LinkCapability; the function is what says the two belong together.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkFunction
+ */
+export enum LinkFunction {
+  /**
+   * @generated from enum value: LINK_FUNCTION_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The sender leads the receiver's climate control.
+   *
+   * Stronger than feeding a measurement, and the difference matters to anything
+   * building a UI. Both the sender's measured temperature and its setpoint reach
+   * the receiver, and the transfer is one way: the receiver reports the sender's
+   * temperature as its own, and a setpoint written to the receiver is accepted
+   * and then reverted to the sender's. So the sender is the control surface for
+   * the pair, and a setpoint control offered on a linked receiver is one that
+   * appears to work and silently undoes itself.
+   *
+   * @generated from enum value: LINK_FUNCTION_CLIMATE_LEAD = 1;
+   */
+  CLIMATE_LEAD = 1,
+
+  /**
+   * The sender's open/closed state reaches the receiver, which acts on it —
+   * typically a contact telling a valve to stop heating an open room.
+   *
+   * Not implied by CLIMATE_LEAD: a device that leads a room's climate does not
+   * necessarily forward its own window state, and on at least one vendor it does
+   * not. Where both are wanted, both are linked.
+   *
+   * @generated from enum value: LINK_FUNCTION_WINDOW_STATE = 2;
+   */
+  WINDOW_STATE = 2,
+
+  /**
+   * The sender is an input the receiver acts on — a button or remote.
+   *
+   * @generated from enum value: LINK_FUNCTION_REMOTE_CONTROL = 3;
+   */
+  REMOTE_CONTROL = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkFunction.
+ */
+export declare const LinkFunctionSchema: GenEnum<LinkFunction>;
+
+/**
+ * Which end of a link a device can be.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkDirection
+ */
+export enum LinkDirection {
+  /**
+   * @generated from enum value: LINK_DIRECTION_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * can lead
+   *
+   * @generated from enum value: LINK_DIRECTION_SOURCE = 1;
+   */
+  SOURCE = 1,
+
+  /**
+   * can follow
+   *
+   * @generated from enum value: LINK_DIRECTION_TARGET = 2;
+   */
+  TARGET = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkDirection.
+ */
+export declare const LinkDirectionSchema: GenEnum<LinkDirection>;
+
+/**
+ * How a link is carried.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkMode
+ */
+export enum LinkMode {
+  /**
+   * @generated from enum value: LINK_MODE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Device to device, brokered by the hub and then carried without it. Survives
+   * a gateway outage. Requires both devices on the same hub, and the hub's own
+   * support for the function.
+   *
+   * @generated from enum value: LINK_MODE_HARD = 1;
+   */
+  HARD = 1,
+
+  /**
+   * Kept by the gateway, which reads one device and writes the other. Works
+   * across vendors and across hubs, and is the only option where no hub can
+   * broker the pair — at the cost of not surviving a gateway outage.
+   *
+   * @generated from enum value: LINK_MODE_SOFT = 2;
+   */
+  SOFT = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkMode.
+ */
+export declare const LinkModeSchema: GenEnum<LinkMode>;
+
+/**
+ * Whether a link is doing anything.
+ *
+ * There is deliberately no "created but not yet in effect" state. On current
+ * device firmware a link takes effect immediately, and on firmware old enough not
+ * to, it never takes effect at all without physical intervention — which is a
+ * refusal at creation time, not a state to wait in.
+ *
+ * Nor should ACTIVE be inferred from the hub reporting a link exists. A hub can
+ * report a link as present, unpending and healthy while the devices ignore it
+ * entirely; only behaviour distinguishes the two.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkState
+ */
+export enum LinkState {
+  /**
+   * @generated from enum value: LINK_STATE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * carrying
+   *
+   * @generated from enum value: LINK_STATE_ACTIVE = 1;
+   */
+  ACTIVE = 1,
+
+  /**
+   * the sender is unreachable, gone, or the set is incomplete
+   *
+   * @generated from enum value: LINK_STATE_BROKEN = 2;
+   */
+  BROKEN = 2,
+
+  /**
+   * the hub and our records disagree, or the hub cannot say
+   *
+   * @generated from enum value: LINK_STATE_UNKNOWN = 3;
+   */
+  UNKNOWN = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkState.
+ */
+export declare const LinkStateSchema: GenEnum<LinkState>;
+

package/src/kusinta/iot/link/v1/link_pb.js

@@ -0,0 +1,121 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/link/v1/link.proto (package kusinta.iot.link.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_access_v1_acl } from "../../access/v1/acl_pb.js";
+import { file_kusinta_iot_identity_v1_identity } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/link/v1/link.proto.
+ */
+export const file_kusinta_iot_link_v1_link = /*@__PURE__*/
+  fileDesc("Ch5rdXNpbnRhL2lvdC9saW5rL3YxL2xpbmsucHJvdG8SE2t1c2ludGEuaW90LmxpbmsudjEiYAoMTGlua1NldHRpbmdzEkAKDGNsaW1hdGVfbGVhZBgBIAEoCzIoLmt1c2ludGEuaW90LmxpbmsudjEuQ2xpbWF0ZUxlYWRTZXR0aW5nc0gAQg4KDHBlcl9mdW5jdGlvbiJHChNDbGltYXRlTGVhZFNldHRpbmdzEhwKD3RhcmdldF9zZXRwb2ludBgBIAEoEUgAiAEBQhIKEF90YXJnZXRfc2V0cG9pbnQisQMKCkRldmljZUxpbmsSDwoHbGlua19pZBgBIAEoCRIxCgZzZW5kZXIYAiABKAsyIS5rdXNpbnRhLmlvdC5pZGVudGl0eS52MS5EZXZpY2VJZBIzCghyZWNlaXZlchgDIAEoCzIhLmt1c2ludGEuaW90LmlkZW50aXR5LnYxLkRldmljZUlkEjMKCGZ1bmN0aW9uGAQgASgOMiEua3VzaW50YS5pb3QubGluay52MS5MaW5rRnVuY3Rpb24SKwoEbW9kZRgFIAEoDjIdLmt1c2ludGEuaW90LmxpbmsudjEuTGlua01vZGUSLQoFc3RhdGUYBiABKA4yHi5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTdGF0ZRIuCgpjcmVhdGVkX2F0GAcgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIUCgxzdGF0ZV9kZXRhaWwYCCABKAkSMwoIc2V0dGluZ3MYCSABKAsyIS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtTZXR0aW5ncxIYChBkZXRhaWxzX3dpdGhoZWxkGAogASgISgQIFBAeIvsBCg5MaW5rQ2FwYWJpbGl0eRIzCghmdW5jdGlvbhgBIAEoDjIhLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0Z1bmN0aW9uEjUKCWRpcmVjdGlvbhgCIAEoDjIiLmt1c2ludGEuaW90LmxpbmsudjEuTGlua0RpcmVjdGlvbhI2Cg9zdXBwb3J0ZWRfbW9kZXMYAyADKA4yHS5rdXNpbnRhLmlvdC5saW5rLnYxLkxpbmtNb2RlEjYKCWF0dHJpYnV0ZRgEIAEoCzIjLmt1c2ludGEuaW90LmFjY2Vzcy52MS5BdHRyaWJ1dGVSZWYSDQoFbGFiZWwYBSABKAkiQAoORGV2aWNlTGlua0xpc3QSLgoFbGlua3MYASADKAsyHy5rdXNpbnRhLmlvdC5saW5rLnYxLkRldmljZUxpbmsqjwEKDExpbmtGdW5jdGlvbhIdChlMSU5LX0ZVTkNUSU9OX1VOU1BFQ0lGSUVEEAASHgoaTElOS19GVU5DVElPTl9DTElNQVRFX0xFQUQQARIeChpMSU5LX0ZVTkNUSU9OX1dJTkRPV19TVEFURRACEiAKHExJTktfRlVOQ1RJT05fUkVNT1RFX0NPTlRST0wQAyplCg1MaW5rRGlyZWN0aW9uEh4KGkxJTktfRElSRUNUSU9OX1VOU1BFQ0lGSUVEEAASGQoVTElOS19ESVJFQ1RJT05fU09VUkNFEAESGQoVTElOS19ESVJFQ1RJT05fVEFSR0VUEAIqTQoITGlua01vZGUSGQoVTElOS19NT0RFX1VOU1BFQ0lGSUVEEAASEgoOTElOS19NT0RFX0hBUkQQARISCg5MSU5LX01PREVfU09GVBACKm0KCUxpbmtTdGF0ZRIaChZMSU5LX1NUQVRFX1VOU1BFQ0lGSUVEEAASFQoRTElOS19TVEFURV9BQ1RJVkUQARIVChFMSU5LX1NUQVRFX0JST0tFThACEhYKEkxJTktfU1RBVEVfVU5LTk9XThADQgJIAWIGcHJvdG8z", [file_google_protobuf_timestamp, file_kusinta_iot_access_v1_acl, file_kusinta_iot_identity_v1_identity]);
+
+/**
+ * Describes the message kusinta.iot.link.v1.LinkSettings.
+ * Use `create(LinkSettingsSchema)` to create a new message.
+ */
+export const LinkSettingsSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_link_v1_link, 0);
+
+/**
+ * Describes the message kusinta.iot.link.v1.ClimateLeadSettings.
+ * Use `create(ClimateLeadSettingsSchema)` to create a new message.
+ */
+export const ClimateLeadSettingsSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_link_v1_link, 1);
+
+/**
+ * Describes the message kusinta.iot.link.v1.DeviceLink.
+ * Use `create(DeviceLinkSchema)` to create a new message.
+ */
+export const DeviceLinkSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_link_v1_link, 2);
+
+/**
+ * Describes the message kusinta.iot.link.v1.LinkCapability.
+ * Use `create(LinkCapabilitySchema)` to create a new message.
+ */
+export const LinkCapabilitySchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_link_v1_link, 3);
+
+/**
+ * Describes the message kusinta.iot.link.v1.DeviceLinkList.
+ * Use `create(DeviceLinkListSchema)` to create a new message.
+ */
+export const DeviceLinkListSchema = /*@__PURE__*/
+  messageDesc(file_kusinta_iot_link_v1_link, 4);
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkFunction.
+ */
+export const LinkFunctionSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_link_v1_link, 0);
+
+/**
+ * What a link makes the sender do to the receiver.
+ *
+ * A function, not a cluster id, because the two ends do not necessarily speak the
+ * same cluster: a wall thermostat reports its temperature as Thermostat
+ * LocalTemperature while a bare sensor reports the same quantity as Temperature
+ * Measurement MeasuredValue. Each end states its own attribute in its
+ * LinkCapability; the function is what says the two belong together.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkFunction
+ */
+export const LinkFunction = /*@__PURE__*/
+  tsEnum(LinkFunctionSchema);
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkDirection.
+ */
+export const LinkDirectionSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_link_v1_link, 1);
+
+/**
+ * Which end of a link a device can be.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkDirection
+ */
+export const LinkDirection = /*@__PURE__*/
+  tsEnum(LinkDirectionSchema);
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkMode.
+ */
+export const LinkModeSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_link_v1_link, 2);
+
+/**
+ * How a link is carried.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkMode
+ */
+export const LinkMode = /*@__PURE__*/
+  tsEnum(LinkModeSchema);
+
+/**
+ * Describes the enum kusinta.iot.link.v1.LinkState.
+ */
+export const LinkStateSchema = /*@__PURE__*/
+  enumDesc(file_kusinta_iot_link_v1_link, 3);
+
+/**
+ * Whether a link is doing anything.
+ *
+ * There is deliberately no "created but not yet in effect" state. On current
+ * device firmware a link takes effect immediately, and on firmware old enough not
+ * to, it never takes effect at all without physical intervention — which is a
+ * refusal at creation time, not a state to wait in.
+ *
+ * Nor should ACTIVE be inferred from the hub reporting a link exists. A hub can
+ * report a link as present, unpending and healthy while the devices ignore it
+ * entirely; only behaviour distinguishes the two.
+ *
+ * @generated from enum kusinta.iot.link.v1.LinkState
+ */
+export const LinkState = /*@__PURE__*/
+  tsEnum(LinkStateSchema);
+