@kusinta/iot-schema 0.2.0-beta.2 → 0.2.0-beta.21

package/src/kusinta/iot/reporting/v1/reporting_pb.d.ts

@@ -0,0 +1,891 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=js+dts,import_extension=js"
+// @generated from file kusinta/iot/reporting/v1/reporting.proto (package kusinta.iot.reporting.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+import type { ConnectorId, DeviceId, SpaceId, UserId } from "../../identity/v1/identity_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { SpaceType } from "../../common/v1/types_pb.js";
+
+/**
+ * Describes the file kusinta/iot/reporting/v1/reporting.proto.
+ */
+export declare const file_kusinta_iot_reporting_v1_reporting: GenFile;
+
+/**
+ * One part of a full set: a concern's whole current state, sent on every new stream as above.
+ * A large set may span several requests, each carrying the same snapshot_id.
+ *
+ * The api-server applies a snapshot only once it holds every part of it: parts 0 to the one
+ * marked last, all with one snapshot_id, on one stream. Then, and only then, it drops what
+ * the snapshot does not name — closing open problems that are absent, forgetting reach and
+ * spaces that are absent. A snapshot belongs to its stream: a part with another snapshot_id,
+ * or any request on a newer stream, discards a snapshot in progress. A snapshot not
+ * completed is never applied, and the next stream sends its own.
+ *
+ * While a snapshot of a concern is in progress, the gateway sends that concern nothing but
+ * the snapshot's parts; whatever it queued meanwhile follows the last part. A change sent
+ * between parts could be missing from a snapshot built before it, and completing the snapshot
+ * would then undo it. A request without a snapshot part that arrives while one is in progress
+ * is not applied: the answer's applied_seq does not cover it.
+ *
+ * A part other than the last is held, not applied, but its seq counts as applied: the gateway
+ * sends the next. The snapshot applies with its last part.
+ *
+ * @generated from message kusinta.iot.reporting.v1.SnapshotPart
+ */
+export declare type SnapshotPart = Message<"kusinta.iot.reporting.v1.SnapshotPart"> & {
+  /**
+   * Minted by the gateway, opaque, unique per snapshot.
+   *
+   * @generated from field: string snapshot_id = 1;
+   */
+  snapshotId: string;
+
+  /**
+   * This part's place in the snapshot, from 0.
+   *
+   * @generated from field: uint32 part = 2;
+   */
+  part: number;
+
+  /**
+   * Set on the final part. The snapshot has part + 1 parts.
+   *
+   * @generated from field: bool last = 3;
+   */
+  last: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.SnapshotPart.
+ * Use `create(SnapshotPartSchema)` to create a new message.
+ */
+export declare const SnapshotPartSchema: GenMessage<SnapshotPart>;
+
+/**
+ * The thing a problem is about.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ProblemSubject
+ */
+export declare type ProblemSubject = Message<"kusinta.iot.reporting.v1.ProblemSubject"> & {
+  /**
+   * @generated from oneof kusinta.iot.reporting.v1.ProblemSubject.subject
+   */
+  subject: {
+    /**
+     * DEVICE_OFFLINE, BATTERY_*, DEVICE_ERROR, DEVICE_TAMPER.
+     *
+     * @generated from field: kusinta.iot.identity.v1.DeviceId device_id = 1;
+     */
+    value: DeviceId;
+    case: "deviceId";
+  } | {
+    /**
+     * CONNECTOR_OFFLINE, CONNECTOR_ERROR.
+     *
+     * @generated from field: kusinta.iot.identity.v1.ConnectorId connector_id = 2;
+     */
+    value: ConnectorId;
+    case: "connectorId";
+  } | {
+    /**
+     * WINDOW_OPEN: the room.
+     *
+     * @generated from field: kusinta.iot.identity.v1.SpaceId room_id = 3;
+     */
+    value: SpaceId;
+    case: "roomId";
+  } | {
+    /**
+     * UNFILED_DEVICES: the gateway itself.
+     *
+     * @generated from field: bool gateway = 4;
+     */
+    value: boolean;
+    case: "gateway";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemSubject.
+ * Use `create(ProblemSubjectSchema)` to create a new message.
+ */
+export declare const ProblemSubjectSchema: GenMessage<ProblemSubject>;
+
+/**
+ * A problem as it stands while open.
+ *
+ * For a device in a home (an apartment, or a room in one), a problem carries only what a
+ * ServiceStatus would give service staff of it, at the same precision:
+ *   * opened_at is the quarter hour the gateway's evaluated status changed, never the time
+ *     of a device report;
+ *   * battery_percent is rounded up to a multiple of ten, as ServiceStatus.battery_percent is;
+ *   * the only device faults reported are DEVICE_ERROR and DEVICE_TAMPER.
+ * A device a resident owns raises no problem at all: it is theirs, and building staff are not
+ * told of it.
+ *
+ * When a transition for a device in a home is sent matters as much as what it carries: the
+ * gateway evaluates such a device's problems only at quarter hours, so a condition that comes
+ * and goes between two of them — a connector outage included — changes nothing, and it sends a
+ * transition only at that evaluation, as ServiceStatus changes are pushed,
+ * never on the device report that prompted it. That holds for every transition of such a
+ * device, a clear for its removal or for its connector going offline included: each is sent,
+ * and stamped, at the next quarter hour.
+ *
+ * @generated from message kusinta.iot.reporting.v1.Problem
+ */
+export declare type Problem = Message<"kusinta.iot.reporting.v1.Problem"> & {
+  /**
+   * @generated from field: kusinta.iot.reporting.v1.ProblemKind kind = 2;
+   */
+  kind: ProblemKind;
+
+  /**
+   * @generated from field: kusinta.iot.reporting.v1.ProblemSubject subject = 3;
+   */
+  subject?: ProblemSubject | undefined;
+
+  /**
+   * The space a device subject is filed in. A device filed in several spaces, any of them in a
+   * home (an apartment or a room in one), counts as in a home, as access.v1 has it, and reports
+   * the deepest space it is filed in within any home, the lowest id between equals. Otherwise
+   * the deepest it is filed in, the lowest id between equals. Unset for any other subject (a
+   * room is its own place) and for a device filed nowhere.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 4;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * When the problem opened. For a device in a home, the quarter hour; see above.
+   *
+   * A problem's space is space_id for a device subject and room_id for a room subject; a
+   * connector or the gateway has none.
+   *
+   * Of any problem with a space, the api-server shows a member only what falls within their
+   * unbroken reach to that space, from the since the gateway gives for it (see ReachedSpace),
+   * or for the administrator from when their administration began (see ServiceReach):
+   * a problem that closed at or before then is not shown to them at all, and an opened_at
+   * before then shows as then. Applied whether or not the space is in a home now, since a
+   * space may have been one while the problem was open. The gateway likewise never shows
+   * service staff a status from before they could see the device. A problem whose space the
+   * api-server does not hold is shown only to the gateway's administrator (see ServiceReach),
+   * its times as of when that administration began.
+   *
+   * @generated from field: google.protobuf.Timestamp opened_at = 5;
+   */
+  openedAt?: Timestamp | undefined;
+
+  /**
+   * BATTERY_*: remaining charge, rounded up to a multiple of ten. Absent when the device
+   * reports none.
+   *
+   * @generated from field: optional uint32 battery_percent = 6;
+   */
+  batteryPercent?: number | undefined;
+
+  /**
+   * UNFILED_DEVICES: how many devices are filed nowhere.
+   *
+   * @generated from field: uint32 device_count = 7;
+   */
+  deviceCount: number;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.Problem.
+ * Use `create(ProblemSchema)` to create a new message.
+ */
+export declare const ProblemSchema: GenMessage<Problem>;
+
+/**
+ * A problem closing.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ProblemCleared
+ */
+export declare type ProblemCleared = Message<"kusinta.iot.reporting.v1.ProblemCleared"> & {
+  /**
+   * When it closed. For a device in a home, the quarter hour the evaluated status changed,
+   * as for opened_at; never the time of a device report.
+   *
+   * @generated from field: google.protobuf.Timestamp cleared_at = 1;
+   */
+  clearedAt?: Timestamp | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.reporting.v1.ClearReason reason = 2;
+   */
+  reason: ClearReason;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemCleared.
+ * Use `create(ProblemClearedSchema)` to create a new message.
+ */
+export declare const ProblemClearedSchema: GenMessage<ProblemCleared>;
+
+/**
+ * One change to one problem.
+ *
+ * (problem_id, seq) is the idempotency key. seq counts the transitions of one problem from 1:
+ * its opening is 1, and each later change one more. Outside a snapshot, the api-server
+ * applies a transition only if its seq is above the highest it holds for that problem; any
+ * other — a repeat, or a retry overtaken by a later change — is acknowledged as a duplicate
+ * and not applied, so a late update cannot reopen a problem since cleared. Seqs of one
+ * problem need not arrive without gaps: each transition carries the problem's whole state.
+ *
+ * A snapshot is authoritative: each problem it names takes the snapshot's state and seq,
+ * whatever the api-server held. A transition in it acknowledged REJECTED does not count as
+ * naming its problem. A problem it does not name, the api-server closes as of the snapshot,
+ * with no reason given (CLEAR_REASON_UNSPECIFIED), at the quarter hour the snapshot completed,
+ * rounded down whatever the subject (the api-server may not yet know where it is), and never
+ * earlier than the problem's opened_at. Its highest seq stays as held, so only a later
+ * transition of it applies.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ProblemTransition
+ */
+export declare type ProblemTransition = Message<"kusinta.iot.reporting.v1.ProblemTransition"> & {
+  /**
+   * Minted by the gateway for one open period of one (subject, kind), stable across gateway
+   * restarts. A problem that clears and opens again is a new problem with a new id.
+   *
+   * A UUIDv4: opaque, and never time-ordered. An id that sorted by time (a ULID, a UUIDv7)
+   * would carry the moment a problem opened, which the quarter-hour rule withholds.
+   *
+   * @generated from field: string problem_id = 1;
+   */
+  problemId: string;
+
+  /**
+   * @generated from field: uint64 seq = 2;
+   */
+  seq: bigint;
+
+  /**
+   * @generated from oneof kusinta.iot.reporting.v1.ProblemTransition.change
+   */
+  change: {
+    /**
+     * The problem opened, or something it carries changed while open (a battery level, a
+     * device count, the space it is filed in). Carries the whole problem, not a delta: the
+     * same problem_id, the next seq and the original opened_at.
+     *
+     * @generated from field: kusinta.iot.reporting.v1.Problem open = 3;
+     */
+    value: Problem;
+    case: "open";
+  } | {
+    /**
+     * @generated from field: kusinta.iot.reporting.v1.ProblemCleared cleared = 4;
+     */
+    value: ProblemCleared;
+    case: "cleared";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ProblemTransition.
+ * Use `create(ProblemTransitionSchema)` to create a new message.
+ */
+export declare const ProblemTransitionSchema: GenMessage<ProblemTransition>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportProblemsRequest
+ */
+export declare type ReportProblemsRequest = Message<"kusinta.iot.reporting.v1.ReportProblemsRequest"> & {
+  /**
+   * This concern's stream and the request's place on it; see SnapshotPart.
+   *
+   * @generated from field: string stream_id = 3;
+   */
+  streamId: string;
+
+  /**
+   * The streams this one replaced; see SnapshotPart. Empty on the gateway's first.
+   *
+   * @generated from field: repeated string previous_stream_ids = 5;
+   */
+  previousStreamIds: string[];
+
+  /**
+   * @generated from field: uint64 seq = 4;
+   */
+  seq: bigint;
+
+  /**
+   * Applied in order.
+   *
+   * @generated from field: repeated kusinta.iot.reporting.v1.ProblemTransition transitions = 1;
+   */
+  transitions: ProblemTransition[];
+
+  /**
+   * Set when this request is part of a snapshot of every open problem. Its transitions are
+   * then each problem's latest open state, and the api-server, once it holds the whole
+   * snapshot, closes every open problem the snapshot does not name.
+   *
+   * @generated from field: kusinta.iot.reporting.v1.SnapshotPart snapshot = 2;
+   */
+  snapshot?: SnapshotPart | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportProblemsRequest.
+ * Use `create(ReportProblemsRequestSchema)` to create a new message.
+ */
+export declare const ReportProblemsRequestSchema: GenMessage<ReportProblemsRequest>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.TransitionAck
+ */
+export declare type TransitionAck = Message<"kusinta.iot.reporting.v1.TransitionAck"> & {
+  /**
+   * @generated from field: string problem_id = 1;
+   */
+  problemId: string;
+
+  /**
+   * @generated from field: uint64 seq = 2;
+   */
+  seq: bigint;
+
+  /**
+   * @generated from field: kusinta.iot.reporting.v1.AckStatus status = 3;
+   */
+  status: AckStatus;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.TransitionAck.
+ * Use `create(TransitionAckSchema)` to create a new message.
+ */
+export declare const TransitionAckSchema: GenMessage<TransitionAck>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportProblemsResponse
+ */
+export declare type ReportProblemsResponse = Message<"kusinta.iot.reporting.v1.ReportProblemsResponse"> & {
+  /**
+   * One per transition of a request the api-server took in order, named by its key.
+   *
+   * @generated from field: repeated kusinta.iot.reporting.v1.TransitionAck acks = 1;
+   */
+  acks: TransitionAck[];
+
+  /**
+   * As ReportServiceReachResponse.applied_seq: whether the request was taken at all. A request
+   * above it was not, carries no acks, and is sent again.
+   *
+   * @generated from field: uint64 applied_seq = 3;
+   */
+  appliedSeq: bigint;
+
+  /**
+   * The gateway must connect afresh; see SnapshotPart.
+   *
+   * @generated from field: bool resync_required = 2;
+   */
+  resyncRequired: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportProblemsResponse.
+ * Use `create(ReportProblemsResponseSchema)` to create a new message.
+ */
+export declare const ReportProblemsResponseSchema: GenMessage<ReportProblemsResponse>;
+
+/**
+ * Which spaces one member of service staff reaches on this gateway: whom the api-server may
+ * show a problem to, by where the problem is.
+ *
+ * Sent for every member who stands to some space as service (access.v1.MembershipRelation),
+ * from their memberships alone. Never for a resident: where people live stays on the gateway.
+ * A member's own home is not left out of their reach, since a gap would show where they live.
+ * A user who is no longer service anywhere on the gateway is named in removed_user_ids.
+ *
+ * The administration of the gateway is not reported here; the administrator's own service
+ * memberships, if any, are, like anyone's. The api-server records who administers a gateway
+ * itself, and from when, and gives the administrator every space the gateway serves
+ * from that moment, applying a change of administrator at once. A problem with no space the
+ * api-server holds — a device filed nowhere, a space not yet held or since removed — is shown
+ * only to the administrator. A problem about a connector or the gateway itself concerns no
+ * one's home, and is shown to the administrator and every member with any reach.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ServiceReach
+ */
+export declare type ServiceReach = Message<"kusinta.iot.reporting.v1.ServiceReach"> & {
+  /**
+   * As the token issuer mints it: the sub of the member's token.
+   *
+   * @generated from field: kusinta.iot.identity.v1.UserId user_id = 1;
+   */
+  userId?: UserId | undefined;
+
+  /**
+   * Every space the member reaches, the spaces beneath a reached space included. Replaces
+   * whatever the api-server held for this member on this gateway, so one member's reach is
+   * never split across requests or snapshot parts.
+   *
+   * @generated from field: repeated kusinta.iot.reporting.v1.ReachedSpace spaces = 3;
+   */
+  spaces: ReachedSpace[];
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ServiceReach.
+ * Use `create(ServiceReachSchema)` to create a new message.
+ */
+export declare const ServiceReachSchema: GenMessage<ServiceReach>;
+
+/**
+ * One space a member reaches, and since when.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ReachedSpace
+ */
+export declare type ReachedSpace = Message<"kusinta.iot.reporting.v1.ReachedSpace"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * The quarter hour, rounded up, from which the member's reach to this space has been
+   * unbroken, as the gateway counts it. Given by the gateway, which saw any break, rather than
+   * inferred by the api-server from when reports arrived: a snapshot replaces what was queued,
+   * and would hide a break the gateway saw while offline.
+   *
+   * @generated from field: google.protobuf.Timestamp since = 2;
+   */
+  since?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReachedSpace.
+ * Use `create(ReachedSpaceSchema)` to create a new message.
+ */
+export declare const ReachedSpaceSchema: GenMessage<ReachedSpace>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportServiceReachRequest
+ */
+export declare type ReportServiceReachRequest = Message<"kusinta.iot.reporting.v1.ReportServiceReachRequest"> & {
+  /**
+   * This concern's stream; see SnapshotPart.
+   *
+   * @generated from field: string stream_id = 5;
+   */
+  streamId: string;
+
+  /**
+   * The streams this one replaced; see SnapshotPart. Empty on the gateway's first.
+   *
+   * @generated from field: repeated string previous_stream_ids = 6;
+   */
+  previousStreamIds: string[];
+
+  /**
+   * The request's place on stream_id; see SnapshotPart. Applied in order, exactly once, so a
+   * late retry cannot restore reach since taken away.
+   *
+   * @generated from field: uint64 seq = 1;
+   */
+  seq: bigint;
+
+  /**
+   * @generated from field: repeated kusinta.iot.reporting.v1.ServiceReach reach = 2;
+   */
+  reach: ServiceReach[];
+
+  /**
+   * Members who reach nothing on this gateway as service any more. A member named here and in
+   * reach is removed.
+   *
+   * @generated from field: repeated kusinta.iot.identity.v1.UserId removed_user_ids = 3;
+   */
+  removedUserIds: UserId[];
+
+  /**
+   * Set when this request is part of a snapshot of every member's reach; members absent from
+   * a whole snapshot reach nothing.
+   *
+   * @generated from field: kusinta.iot.reporting.v1.SnapshotPart snapshot = 4;
+   */
+  snapshot?: SnapshotPart | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServiceReachRequest.
+ * Use `create(ReportServiceReachRequestSchema)` to create a new message.
+ */
+export declare const ReportServiceReachRequestSchema: GenMessage<ReportServiceReachRequest>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportServiceReachResponse
+ */
+export declare type ReportServiceReachResponse = Message<"kusinta.iot.reporting.v1.ReportServiceReachResponse"> & {
+  /**
+   * The seq the api-server has applied up to on the request's stream, a held snapshot part
+   * counting as applied. The gateway does not send any request up to it again; one above it
+   * was not applied, and is sent again.
+   *
+   * @generated from field: uint64 applied_seq = 1;
+   */
+  appliedSeq: bigint;
+
+  /**
+   * The gateway must connect afresh; see SnapshotPart.
+   *
+   * @generated from field: bool resync_required = 2;
+   */
+  resyncRequired: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServiceReachResponse.
+ * Use `create(ReportServiceReachResponseSchema)` to create a new message.
+ */
+export declare const ReportServiceReachResponseSchema: GenMessage<ReportServiceReachResponse>;
+
+/**
+ * A space this gateway serves, enough for the api-server to say which spaces an offline
+ * gateway affects and to name where a problem is. The fields of space.v1.Space it needs and
+ * no more: who is filed on a space, and which devices are in it, stay on the gateway.
+ *
+ * name is the space's name as filed. Building staff see it in the app already, but the name
+ * of a home may carry personal data ("Apt 101 – Andersson"), so it is stored by the api-server
+ * as personal data: something an operator's data protection assessment covers.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ServedSpace
+ */
+export declare type ServedSpace = Message<"kusinta.iot.reporting.v1.ServedSpace"> & {
+  /**
+   * @generated from field: kusinta.iot.identity.v1.SpaceId space_id = 1;
+   */
+  spaceId?: SpaceId | undefined;
+
+  /**
+   * @generated from field: kusinta.iot.common.v1.SpaceType space_type = 2;
+   */
+  spaceType: SpaceType;
+
+  /**
+   * @generated from field: string name = 3;
+   */
+  name: string;
+
+  /**
+   * Unset for a top-level space.
+   *
+   * @generated from field: kusinta.iot.identity.v1.SpaceId parent_space_id = 4;
+   */
+  parentSpaceId?: SpaceId | undefined;
+
+  /**
+   * As Space.floor: meaningful for a floor.
+   *
+   * @generated from field: int32 floor = 5;
+   */
+  floor: number;
+
+  /**
+   * The building's IANA time zone, as Space.time_zone: set on the building, so a time the
+   * api-server holds can be shown on the building's clock without a session to the gateway.
+   *
+   * @generated from field: string time_zone = 6;
+   */
+  timeZone: string;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ServedSpace.
+ * Use `create(ServedSpaceSchema)` to create a new message.
+ */
+export declare const ServedSpaceSchema: GenMessage<ServedSpace>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportServedSpacesRequest
+ */
+export declare type ReportServedSpacesRequest = Message<"kusinta.iot.reporting.v1.ReportServedSpacesRequest"> & {
+  /**
+   * This concern's stream; see SnapshotPart.
+   *
+   * @generated from field: string stream_id = 5;
+   */
+  streamId: string;
+
+  /**
+   * The streams this one replaced; see SnapshotPart. Empty on the gateway's first.
+   *
+   * @generated from field: repeated string previous_stream_ids = 6;
+   */
+  previousStreamIds: string[];
+
+  /**
+   * As ReportServiceReachRequest.seq, on this concern's own stream.
+   *
+   * @generated from field: uint64 seq = 1;
+   */
+  seq: bigint;
+
+  /**
+   * Added or changed. Each replaces what the api-server held for that space.
+   *
+   * @generated from field: repeated kusinta.iot.reporting.v1.ServedSpace spaces = 2;
+   */
+  spaces: ServedSpace[];
+
+  /**
+   * No longer served: deleted, or moved off this gateway. A space named here and in spaces is
+   * removed.
+   *
+   * @generated from field: repeated kusinta.iot.identity.v1.SpaceId removed_space_ids = 3;
+   */
+  removedSpaceIds: SpaceId[];
+
+  /**
+   * Set when this request is part of a snapshot of every served space; spaces absent from a
+   * whole snapshot are no longer served.
+   *
+   * @generated from field: kusinta.iot.reporting.v1.SnapshotPart snapshot = 4;
+   */
+  snapshot?: SnapshotPart | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServedSpacesRequest.
+ * Use `create(ReportServedSpacesRequestSchema)` to create a new message.
+ */
+export declare const ReportServedSpacesRequestSchema: GenMessage<ReportServedSpacesRequest>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportServedSpacesResponse
+ */
+export declare type ReportServedSpacesResponse = Message<"kusinta.iot.reporting.v1.ReportServedSpacesResponse"> & {
+  /**
+   * As ReportServiceReachResponse.applied_seq.
+   *
+   * @generated from field: uint64 applied_seq = 1;
+   */
+  appliedSeq: bigint;
+
+  /**
+   * As ReportServiceReachResponse.resync_required.
+   *
+   * @generated from field: bool resync_required = 2;
+   */
+  resyncRequired: boolean;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportServedSpacesResponse.
+ * Use `create(ReportServedSpacesResponseSchema)` to create a new message.
+ */
+export declare const ReportServedSpacesResponseSchema: GenMessage<ReportServedSpacesResponse>;
+
+/**
+ * What kind of problem is open. The device kinds mirror what service staff are given of a
+ * device (webrtc.v1.ServiceStatus: reachability, the battery flags, the ServiceFault values);
+ * a device signal added there is added here too.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.ProblemKind
+ */
+export enum ProblemKind {
+  /**
+   * @generated from enum value: PROBLEM_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The device cannot be heard, as its connector judges it.
+   *
+   * @generated from enum value: PROBLEM_KIND_DEVICE_OFFLINE = 1;
+   */
+  DEVICE_OFFLINE = 1,
+
+  /**
+   * The device reports its battery low or critical.
+   *
+   * @generated from enum value: PROBLEM_KIND_BATTERY_LOW = 2;
+   */
+  BATTERY_LOW = 2,
+
+  /**
+   * The device reports that its battery must be replaced.
+   *
+   * @generated from enum value: PROBLEM_KIND_BATTERY_REPLACEMENT_NEEDED = 3;
+   */
+  BATTERY_REPLACEMENT_NEEDED = 3,
+
+  /**
+   * The device reports an error in its own operation.
+   *
+   * @generated from enum value: PROBLEM_KIND_DEVICE_ERROR = 4;
+   */
+  DEVICE_ERROR = 4,
+
+  /**
+   * The device reports being tampered with: a casing opened, a mount removed.
+   *
+   * @generated from enum value: PROBLEM_KIND_DEVICE_TAMPER = 5;
+   */
+  DEVICE_TAMPER = 5,
+
+  /**
+   * A connector's stream to the gateway is down. While it is open, the gateway raises no
+   * DEVICE_OFFLINE for the devices behind that connector and clears any it had raised, with
+   * CLEAR_REASON_SUPERSEDED_BY_CONNECTOR_OFFLINE: one problem rather than one per device. For
+   * a device in a home that clear, like any, waits for the quarter hour (see Problem).
+   *
+   * @generated from enum value: PROBLEM_KIND_CONNECTOR_OFFLINE = 6;
+   */
+  CONNECTOR_OFFLINE = 6,
+
+  /**
+   * A connector is connected, but the backend it drives is failing: a central it cannot
+   * reach, a network server answering with errors.
+   *
+   * @generated from enum value: PROBLEM_KIND_CONNECTOR_ERROR = 7;
+   */
+  CONNECTOR_ERROR = 7,
+
+  /**
+   * Company-owned devices are paired with the gateway but filed in no space. A device a
+   * resident owns is never counted. The count changes only at quarter-hour evaluations, and
+   * opened_at and cleared_at are quarter hours, as for a device in a home, so the problem
+   * cannot time what a resident does with a device.
+   *
+   * @generated from enum value: PROBLEM_KIND_UNFILED_DEVICES = 8;
+   */
+  UNFILED_DEVICES = 8,
+
+  /**
+   * A window is open in a room whose heating it pauses. Raised only for a room in no home: in
+   * a common area, or under a floor or building directly. Whether a window in a home is open
+   * is the residents' alone, and the gateway never reports it: a room that leaves a home with
+   * its window open raises this at the quarter hour it leaves, stamped with that quarter hour,
+   * never with when the window opened.
+   *
+   * @generated from enum value: PROBLEM_KIND_WINDOW_OPEN = 9;
+   */
+  WINDOW_OPEN = 9,
+}
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.ProblemKind.
+ */
+export declare const ProblemKindSchema: GenEnum<ProblemKind>;
+
+/**
+ * Why a problem closed.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.ClearReason
+ */
+export enum ClearReason {
+  /**
+   * @generated from enum value: CLEAR_REASON_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The condition ended: the device was heard, its battery recovered or was replaced, the
+   * connector came back, the window closed.
+   *
+   * @generated from enum value: CLEAR_REASON_RECOVERED = 1;
+   */
+  RECOVERED = 1,
+
+  /**
+   * The unfiled devices were filed.
+   *
+   * @generated from enum value: CLEAR_REASON_FILED = 2;
+   */
+  FILED = 2,
+
+  /**
+   * The device was removed from the gateway. Every problem open on it closes with this.
+   *
+   * @generated from enum value: CLEAR_REASON_DEVICE_REMOVED = 3;
+   */
+  DEVICE_REMOVED = 3,
+
+  /**
+   * The connector behind the device went offline; see PROBLEM_KIND_CONNECTOR_OFFLINE.
+   *
+   * @generated from enum value: CLEAR_REASON_SUPERSEDED_BY_CONNECTOR_OFFLINE = 4;
+   */
+  SUPERSEDED_BY_CONNECTOR_OFFLINE = 4,
+
+  /**
+   * The problem's subject left what the gateway reports, though the condition may hold: a
+   * device now owned by a resident, a room moved into a home. Sent, and stamped, at the next
+   * quarter hour.
+   *
+   * @generated from enum value: CLEAR_REASON_NO_LONGER_REPORTED = 5;
+   */
+  NO_LONGER_REPORTED = 5,
+
+  /**
+   * The subject moved into or out of a home. A problem that still holds opens again as a new
+   * one at the same quarter hour.
+   *
+   * @generated from enum value: CLEAR_REASON_MOVED = 6;
+   */
+  MOVED = 6,
+}
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.ClearReason.
+ */
+export declare const ClearReasonSchema: GenEnum<ClearReason>;
+
+/**
+ * What the api-server made of one transition.
+ *
+ * @generated from enum kusinta.iot.reporting.v1.AckStatus
+ */
+export enum AckStatus {
+  /**
+   * @generated from enum value: ACK_STATUS_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Applied now.
+   *
+   * @generated from enum value: ACK_STATUS_APPLIED = 1;
+   */
+  APPLIED = 1,
+
+  /**
+   * Already held, or overtaken by a later transition of the same problem; not applied.
+   *
+   * @generated from enum value: ACK_STATUS_DUPLICATE = 2;
+   */
+  DUPLICATE = 2,
+
+  /**
+   * Not applied, and never will be: malformed, or for something this gateway may not report.
+   * The gateway does not send it again. Never because of what the api-server holds of spaces —
+   * one it does not hold, one since removed, one it still files elsewhere: the three concerns
+   * are not ordered against each other, so a problem may run ahead of or behind its space, and
+   * is kept (see ServiceReach for who sees it).
+   *
+   * @generated from enum value: ACK_STATUS_REJECTED = 3;
+   */
+  REJECTED = 3,
+
+  /**
+   * Part of a snapshot not yet complete: received, to be applied with the last part.
+   *
+   * @generated from enum value: ACK_STATUS_HELD = 4;
+   */
+  HELD = 4,
+}
+
+/**
+ * Describes the enum kusinta.iot.reporting.v1.AckStatus.
+ */
+export declare const AckStatusSchema: GenEnum<AckStatus>;
+