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

package/src/kusinta/iot/climate/v1/climate_pb.d.ts

@@ -0,0 +1,726 @@
+// @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 type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
+
+/**
+ * Describes the file kusinta/iot/climate/v1/climate.proto.
+ */
+export declare const file_kusinta_iot_climate_v1_climate: GenFile;
+
+/**
+ * Who or what last set a room's target, and when.
+ *
+ * Shown beside the target, because under "last change wins" a target that moved on its
+ * own looks like a fault unless the reader can see that somebody turned a radiator by
+ * hand ten minutes ago.
+ *
+ * @generated from message kusinta.iot.climate.v1.TargetChange
+ */
+export declare type TargetChange = Message<"kusinta.iot.climate.v1.TargetChange"> & {
+  /**
+   * @generated from field: google.protobuf.Timestamp at = 1;
+   */
+  at?: Timestamp | undefined;
+
+  /**
+   * @generated from oneof kusinta.iot.climate.v1.TargetChange.by
+   */
+  by: {
+    /**
+     * Set in the app, by this user.
+     *
+     * @generated from field: kusinta.iot.identity.v1.UserId user = 2;
+     */
+    value: UserId;
+    case: "user";
+  } | {
+    /**
+     * Turned by hand at this device: a valve's knob or a wall thermostat's dial, as the
+     * device reported it (Matter Thermostat SetpointChangeSource = Manual). A change the
+     * device made on its own — window-open, frost protection, its own schedule — is never
+     * adopted and never appears here.
+     *
+     * @generated from field: kusinta.iot.identity.v1.DeviceId device = 3;
+     */
+    value: DeviceId;
+    case: "device";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.TargetChange.
+ * Use `create(TargetChangeSchema)` to create a new message.
+ */
+export declare const TargetChangeSchema: GenMessage<TargetChange>;
+
+/**
+ * The climate of one room.
+ *
+ * Apply as an upsert keyed on space_id: the same room is sent again whenever any of it
+ * that the recipient is sent moves (see state_withheld).
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomClimate
+ */
+export declare type RoomClimate = Message<"kusinta.iot.climate.v1.RoomClimate"> & {
+  /**
+   * A Space of SPACE_TYPE_ROOM.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * The temperature the room is to be held at, in centidegrees. Unset: nobody has set
+   * one. Always within [min_centidegrees, max_centidegrees] where those are set.
+   *
+   * @generated from field: optional sint32 target_centidegrees = 2;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * Who or what set target_centidegrees. Unset while the target is, and 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: kusinta.iot.climate.v1.TargetChange target_change = 3;
+   */
+  targetChange?: TargetChange | undefined;
+
+  /**
+   * What the valves are actually being held at, in centidegrees. Equal to the target
+   * unless a ClimateMode on an enclosing space sets the room back — and then the room's
+   * own target again if somebody changed this room during the mode (see
+   * overrides_mode). Unset while nothing is being held.
+   *
+   * @generated from field: optional sint32 effective_target_centidegrees = 4;
+   */
+  effectiveTargetCentidegrees?: number | undefined;
+
+  /**
+   * Set when somebody changed this room while a ClimateMode was on: the room keeps its
+   * own target until the mode ends, while the rest of the apartment stays set back.
+   *
+   * @generated from field: bool overrides_mode = 5;
+   */
+  overridesMode: boolean;
+
+  /**
+   * The space whose ClimateMode applies to this room, if one does — set back or,
+   * with overrides_mode, overridden. Unset when no mode applies.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId mode_space_id = 13;
+   */
+  modeSpaceId?: SpaceId | undefined;
+
+  /**
+   * The owner's limits, in centidegrees. The gateway writes them to every device in the
+   * room (Matter Min/MaxHeatSetpointLimit), so a knob stops at them physically, and
+   * clamps every target — from the app, a knob or a mode — to them. The minimum is also
+   * the floor under a mode's setback.
+   *
+   * @generated from field: optional sint32 min_centidegrees = 6;
+   */
+  minCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: optional sint32 max_centidegrees = 7;
+   */
+  maxCentidegrees?: number | undefined;
+
+  /**
+   * The sensors the room measures with, in order: the first is used, each later one
+   * takes over while those before it are quiet. Only devices filed in this room.
+   *
+   * In a home, sensors its residents own come first, in the order they were filed, and then
+   * the building's; outside homes a room measures with the building's sensors only. The
+   * building's are by default every building temperature sensor filed in the room, in the
+   * order it was filed, so a sensor filed later joins at the end without anyone configuring
+   * anything; an owner can set their order explicitly (see sensors_configured). Empty: the
+   * room has no temperature sensor, and its valves regulate on their own probes
+   * (NO_SENSOR).
+   *
+   * @generated from field: repeated kusinta.iot.identity.v1.DeviceId sensor_ids = 8;
+   */
+  sensorIds: DeviceId[];
+
+  /**
+   * Whether the building's part of sensor_ids is an order an owner chose, rather than the
+   * default of filing order. A building sensor filed into a room with a chosen order is
+   * not added to it; a resident's own always is. A sensor that becomes the building's in a
+   * room — released by its owner — counts as filed there at that moment.
+   *
+   * @generated from field: bool sensors_configured = 14;
+   */
+  sensorsConfigured: boolean;
+
+  /**
+   * The reading steering the room now, in centidegrees, and which sensor it came from.
+   * measured_by unset while the valves are on their own probes.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 9;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.identity.v1.DeviceId measured_by = 10;
+   */
+  measuredBy?: DeviceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.RoomClimateCondition condition = 11;
+   */
+  condition: RoomClimateCondition;
+
+  /**
+   * Whether the controls on this room's devices are locked. While unlocked, a change made
+   * by hand at a device becomes the room's target. Locked, the gateway sets the devices'
+   * own lock (Matter Thermostat User Interface Configuration KeypadLockout), so the
+   * refusal happens at the device rather than being undone later.
+   *
+   * Stated as the lock rather than as a permission so that the proto3 default — false,
+   * unlocked — is the intended default: a room nobody has configured takes changes at its
+   * devices, as a room in an apartment should until its residents decide otherwise; when a
+   * home loses its last resident, its rooms' locks are cleared. Elsewhere locking is the
+   * owner's choice.
+   *
+   * @generated from field: bool lock_device_controls = 12;
+   */
+  lockDeviceControls: boolean;
+
+  /**
+   * Set when the recipient reaches this room only as service (see
+   * access.v1.MembershipRelation): the room is in someone's home, and what describes the
+   * people in it is WITHHELD — target_centidegrees, target_change,
+   * effective_target_centidegrees, overrides_mode, mode_space_id, measured_centidegrees,
+   * measured_by, condition and lock_device_controls are all left unset, and sensor_ids
+   * leaves out sensors a resident owns.
+   *
+   * Unset because withheld, not because unknown: an app must not render them as NO_TARGET or
+   * a lost sensor. A withheld room is sent again only when something that IS sent changes,
+   * so that the timing of an update does not give away what was withheld. Its limits and
+   * the sensors service may see are still sent, since setting a room up is service work.
+   * Its climate over time is available to service only as an ApartmentClimateSummary.
+   *
+   * @generated from field: bool state_withheld = 15;
+   */
+  stateWithheld: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimate.
+ * Use `create(RoomClimateSchema)` to create a new message.
+ */
+export declare const RoomClimateSchema: GenMessage<RoomClimate>;
+
+/**
+ * A mode on a home ends when whoever switched it on stops being one of its residents: a new
+ * tenant does not inherit the previous one's holiday. A mode on a room ends when the room
+ * joins a home, whose rooms follow the apartment's mode alone. Any other mode — one switched on by
+ * someone who is not one of its residents now: who never lived there, or a member still
+ * recorded with no relation — ends when the
+ * home gains a resident: when anyone other than its setter, not already its resident, is
+ * assigned RESIDENT on the apartment, a member recorded with no relation included, or the
+ * space becomes an apartment with RESIDENT members on it other than its setter. A mode's
+ * setter recorded with no relation being assigned RESIDENT ends none of their own modes;
+ * being assigned SERVICE or removed ends them.
+ *
+ * A mode set on an apartment — or, for rooms that are not in one, on their floor or
+ * common area. While it is on it sets back every room below that space, except that a
+ * room inside an apartment follows only its apartment's mode: a mode on a floor does not
+ * reach into the flats on it. Where more than one mode could apply, the nearest enclosing
+ * space's wins. A room somebody changes during the mode keeps its own target
+ * (RoomClimate.overrides_mode) until the mode ends.
+ *
+ * @generated from message kusinta.iot.climate.v1.ClimateMode
+ */
+export declare type ClimateMode = Message<"kusinta.iot.climate.v1.ClimateMode"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateModeKind kind = 2;
+   */
+  kind: ClimateModeKind;
+
+  /**
+   * The temperature every room is set back to, in centidegrees. Required while a mode is
+   * on — a mode with nothing to set back to is refused, not defaulted. Clamped by each
+   * room's min_centidegrees, which is the frost floor.
+   *
+   * @generated from field: optional sint32 setback_centidegrees = 3;
+   */
+  setbackCentidegrees?: number | undefined;
+
+  /**
+   * HOLIDAY: when the setback begins and when the rooms are to be back at their own
+   * targets — warm by then, not starting to heat (see warm_from). AWAY: starts_at is when it
+   * was switched on; ends_at is unset. starts_at is unset when it dates from before the
+   * recipient's current residency in the home, or from a home they did not live in at the
+   * time; an ends_at ahead is always sent.
+   *
+   * @generated from field: google.protobuf.Timestamp starts_at = 4;
+   */
+  startsAt?: Timestamp | undefined;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp ends_at = 5;
+   */
+  endsAt?: Timestamp | undefined;
+
+  /**
+   * Who switched it on. 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: kusinta.iot.identity.v1.UserId set_by = 6;
+   */
+  setBy?: UserId | undefined;
+
+  /**
+   * Read-only: filled by the gateway, ignored if sent to it. The moment the setback ends
+   * ahead of ends_at, so that the rooms are warm by ends_at. Absent when there is no
+   * lead — an AWAY mode, or one the gateway has not computed.
+   *
+   * @generated from field: optional google.protobuf.Timestamp warm_from = 7;
+   */
+  warmFrom?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimateMode.
+ * Use `create(ClimateModeSchema)` to create a new message.
+ */
+export declare const ClimateModeSchema: GenMessage<ClimateMode>;
+
+/**
+ * Every room climate and mode a caller may see, in reply to a listing.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomClimateList
+ */
+export declare type RoomClimateList = Message<"kusinta.iot.climate.v1.RoomClimateList"> & {
+  /**
+   * @generated from field: repeated kusinta.iot.climate.v1.RoomClimate rooms = 1;
+   */
+  rooms: RoomClimate[];
+
+  /**
+   * @generated from field: repeated kusinta.iot.climate.v1.ClimateMode modes = 2;
+   */
+  modes: ClimateMode[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomClimateList.
+ * Use `create(RoomClimateListSchema)` to create a new message.
+ */
+export declare const RoomClimateListSchema: GenMessage<RoomClimateList>;
+
+/**
+ * One fixed 15-minute bucket of a room's history. Every reading is optional: absent
+ * means nothing was known for that bucket, never zero.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomHistorySample
+ */
+export declare type RoomHistorySample = Message<"kusinta.iot.climate.v1.RoomHistorySample"> & {
+  /**
+   * The start of the bucket. Buckets are fixed 15-minute intervals aligned to UTC
+   * quarter hours (:00, :15, :30, :45).
+   *
+   * @generated from field: google.protobuf.Timestamp at = 1;
+   */
+  at?: Timestamp | undefined;
+
+  /**
+   * The mean of the room's measured temperature over the bucket, in centidegrees.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 2;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * RoomClimate.target_centidegrees and .effective_target_centidegrees as they were in
+   * force at the bucket's start, in centidegrees.
+   *
+   * @generated from field: optional sint32 target_centidegrees = 3;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * @generated from field: optional sint32 effective_target_centidegrees = 4;
+   */
+  effectiveTargetCentidegrees?: number | undefined;
+
+  /**
+   * The mean opening over the bucket across the room's valves that report one, in
+   * thousandths of fully open. Absent if none of them does.
+   *
+   * @generated from field: optional uint32 valve_open_permille = 5;
+   */
+  valveOpenPermille?: number | undefined;
+
+  /**
+   * The seconds within the bucket during which any of the room's valves was open.
+   *
+   * @generated from field: optional uint32 valve_open_seconds = 6;
+   */
+  valveOpenSeconds?: number | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistorySample.
+ * Use `create(RoomHistorySampleSchema)` to create a new message.
+ */
+export declare const RoomHistorySampleSchema: GenMessage<RoomHistorySample>;
+
+/**
+ * A room's history, in reply to GetRoomHistory.
+ *
+ * @generated from message kusinta.iot.climate.v1.RoomHistory
+ */
+export declare type RoomHistory = Message<"kusinta.iot.climate.v1.RoomHistory"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 1;
+   */
+  roomId?: SpaceId | undefined;
+
+  /**
+   * The earliest moment the gateway still holds for this room. The request's from_time
+   * and to_time are clamped to [kept_from, now], so nothing before kept_from is ever
+   * returned. For a room in the recipient's own home it is no earlier than the start of
+   * their current residency, nor than when the room last joined their home; for any other
+   * room, no earlier than when it last left a home.
+   *
+   * @generated from field: google.protobuf.Timestamp kept_from = 2;
+   */
+  keptFrom?: Timestamp | undefined;
+
+  /**
+   * The buckets within the clamped range, in order of `at`.
+   *
+   * @generated from field: repeated kusinta.iot.climate.v1.RoomHistorySample samples = 3;
+   */
+  samples: RoomHistorySample[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.RoomHistory.
+ * Use `create(RoomHistorySchema)` to create a new message.
+ */
+export declare const RoomHistorySchema: GenMessage<RoomHistory>;
+
+/**
+ * An apartment's climate over one period.
+ *
+ * Each room's mean is taken over the quarter hours of the period in which it was in this
+ * apartment and had a value; coverage likewise counts only the quarter hours it was here,
+ * and the apartment's mean is formed from the rooms' means as the summary's weighting says.
+ * Every mean is optional: absent means nothing was known, never zero.
+ *
+ * @generated from message kusinta.iot.climate.v1.ClimatePeriodMean
+ */
+export declare type ClimatePeriodMean = Message<"kusinta.iot.climate.v1.ClimatePeriodMean"> & {
+  /**
+   * The period, half-open: starts_at <= t < ends_at.
+   *
+   * @generated from field: google.protobuf.Timestamp starts_at = 1;
+   */
+  startsAt?: Timestamp | undefined;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp ends_at = 2;
+   */
+  endsAt?: Timestamp | undefined;
+
+  /**
+   * The mean measured temperature, in centidegrees, taken from the building's own sensors
+   * only: in each room, the first of its building sensors that was heard. A reading from a
+   * sensor a resident owns never enters it.
+   *
+   * @generated from field: optional sint32 measured_centidegrees = 3;
+   */
+  measuredCentidegrees?: number | undefined;
+
+  /**
+   * The mean target, in centidegrees: RoomClimate.target_centidegrees — the temperature
+   * somebody asked for, not the effective target a mode set it back to, so that a
+   * setback is not reported as what the residents chose. The measured mean still falls
+   * while a home is set back; how much that reveals is governed by how long a period
+   * service may ask for (webrtc.v1.PrivacyDisclosure.climate_summary_period).
+   *
+   * @generated from field: optional sint32 target_centidegrees = 4;
+   */
+  targetCentidegrees?: number | undefined;
+
+  /**
+   * How much of the period the means rest on, in thousandths: the quarter hours with a
+   * value, summed over the apartment's rooms, divided by the quarter hours each room was in
+   * the apartment during the period, summed likewise. A room with no sensor, or one that
+   * went quiet, lowers it — a mean with low coverage describes part of the apartment, or
+   * part of the period.
+   *
+   * @generated from field: uint32 measured_coverage_permille = 5;
+   */
+  measuredCoveragePermille: number;
+
+  /**
+   * @generated from field: uint32 target_coverage_permille = 6;
+   */
+  targetCoveragePermille: number;
+
+  /**
+   * The rooms that contributed a measured value, of the rooms the apartment had at any time
+   * in the period.
+   *
+   * @generated from field: uint32 rooms_measured = 7;
+   */
+  roomsMeasured: number;
+
+  /**
+   * @generated from field: uint32 rooms = 8;
+   */
+  rooms: number;
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ClimatePeriodMean.
+ * Use `create(ClimatePeriodMeanSchema)` to create a new message.
+ */
+export declare const ClimatePeriodMeanSchema: GenMessage<ClimatePeriodMean>;
+
+/**
+ * An apartment's climate as means over whole periods, in reply to
+ * webrtc.v1.GetApartmentClimateSummary. What a party who does not live there may know of
+ * how warm it is kept — see webrtc.v1.PrivacyDisclosure.
+ *
+ * Only CLOSED periods are given. The period running now is never included, so that a
+ * summary cannot be polled into a live reading.
+ *
+ * @generated from message kusinta.iot.climate.v1.ApartmentClimateSummary
+ */
+export declare type ApartmentClimateSummary = Message<"kusinta.iot.climate.v1.ApartmentClimateSummary"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId apartment_id = 1;
+   */
+  apartmentId?: SpaceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateSummaryPeriod period = 2;
+   */
+  period: ClimateSummaryPeriod;
+
+  /**
+   * @generated from field: kusinta.iot.climate.v1.ClimateSummaryWeighting weighting = 3;
+   */
+  weighting: ClimateSummaryWeighting;
+
+  /**
+   * The start of the earliest period the gateway still holds that the recipient may be
+   * given: for a resident of this apartment, no earlier than their current residency; for
+   * anyone else, of the length disclosed now, and no earlier than the first such period
+   * after it was last changed (see webrtc.v1.PrivacyDisclosure.climate_summary_period).
+   *
+   * @generated from field: google.protobuf.Timestamp kept_from = 4;
+   */
+  keptFrom?: Timestamp | undefined;
+
+  /**
+   * The periods within the requested range, in order of starts_at.
+   *
+   * @generated from field: repeated kusinta.iot.climate.v1.ClimatePeriodMean periods = 5;
+   */
+  periods: ClimatePeriodMean[];
+};
+
+/**
+ * Describes the message kusinta.iot.climate.v1.ApartmentClimateSummary.
+ * Use `create(ApartmentClimateSummarySchema)` to create a new message.
+ */
+export declare const ApartmentClimateSummarySchema: GenMessage<ApartmentClimateSummary>;
+
+/**
+ * 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 enum RoomClimateCondition {
+  /**
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Being held at its effective target from a sensor's reading.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_HOLDING = 1;
+   */
+  HOLDING = 1,
+
+  /**
+   * Nobody has set a target yet. Not a fault: a room that was just created.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_TARGET = 2;
+   */
+  NO_TARGET = 2,
+
+  /**
+   * Every sensor the room uses has gone quiet. The valves regulate on their own probes
+   * towards the target meanwhile — worse comfort, never a frozen reading.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_SENSOR_LOST = 3;
+   */
+  SENSOR_LOST = 3,
+
+  /**
+   * A window in the room is open, so heating is paused.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_WINDOW_OPEN = 4;
+   */
+  WINDOW_OPEN = 4,
+
+  /**
+   * The room has a target but nothing in it can heat.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_HEATING = 5;
+   */
+  NO_HEATING = 5,
+
+  /**
+   * Every heating device in the room has gone quiet, so nothing is being held however
+   * the target is set.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_HEATING_UNREACHABLE = 6;
+   */
+  HEATING_UNREACHABLE = 6,
+
+  /**
+   * The room has no temperature sensor, so its valves regulate on their own probes
+   * towards the target. Not a fault; a room can be set up that way.
+   *
+   * @generated from enum value: ROOM_CLIMATE_CONDITION_NO_SENSOR = 7;
+   */
+  NO_SENSOR = 7,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.RoomClimateCondition.
+ */
+export declare const RoomClimateConditionSchema: GenEnum<RoomClimateCondition>;
+
+/**
+ * A setback that applies to every room in a space while it is on.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateModeKind
+ */
+export enum ClimateModeKind {
+  /**
+   * No mode: every room at its own target.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Every room to the setback until the mode is switched off.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_AWAY = 1;
+   */
+  AWAY = 1,
+
+  /**
+   * Every room to the setback between starts_at and ends_at, then back to normal on its
+   * own — timed so the rooms are warm again at ends_at, not starting to heat then.
+   *
+   * @generated from enum value: CLIMATE_MODE_KIND_HOLIDAY = 2;
+   */
+  HOLIDAY = 2,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateModeKind.
+ */
+export declare const ClimateModeKindSchema: GenEnum<ClimateModeKind>;
+
+/**
+ * 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 enum ClimateSummaryPeriod {
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_DAY = 1;
+   */
+  DAY = 1,
+
+  /**
+   * ISO weeks, Monday to Monday.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_WEEK = 2;
+   */
+  WEEK = 2,
+
+  /**
+   * Calendar months.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_PERIOD_MONTH = 3;
+   */
+  MONTH = 3,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryPeriod.
+ */
+export declare const ClimateSummaryPeriodSchema: GenEnum<ClimateSummaryPeriod>;
+
+/**
+ * How an apartment's mean is formed from its rooms' means.
+ *
+ * @generated from enum kusinta.iot.climate.v1.ClimateSummaryWeighting
+ */
+export enum ClimateSummaryWeighting {
+  /**
+   * @generated from enum value: CLIMATE_SUMMARY_WEIGHTING_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Each room counts once, whatever its size: a bathroom weighs as much as a living room.
+   *
+   * @generated from enum value: CLIMATE_SUMMARY_WEIGHTING_ROOMS_EQUAL = 1;
+   */
+  ROOMS_EQUAL = 1,
+}
+
+/**
+ * Describes the enum kusinta.iot.climate.v1.ClimateSummaryWeighting.
+ */
+export declare const ClimateSummaryWeightingSchema: GenEnum<ClimateSummaryWeighting>;
+