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

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

@@ -0,0 +1,1219 @@
+// @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 { BackendFailureReason, SpaceType } from "../../common/v1/types_pb.js";
+import type { Role } from "../../access/v1/roles_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 changes nothing — a connector problem that comes and goes so
+ * sends nothing about the device, though it leaves its connector settling after it (see
+ * ClearReason) — 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 a SUPERSEDED_* clear 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;
+
+  /**
+   * CONNECTOR_ERROR: why the connector's backend is failing, as the connector's latest
+   * connector.v1.BackendHealthReport states it. A category, not a message: the connector's
+   * free-text detail is never reported, here or anywhere else. UNSPECIFIED for every other
+   * kind, and for a connector that stated no reason. A change of reason while the problem is
+   * open is sent as a change of the problem.
+   *
+   * @generated from field: kusinta.iot.common.v1.BackendFailureReason backend_failure = 8;
+   */
+  backendFailure: BackendFailureReason;
+};
+
+/**
+ * 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, a backend failure reason). 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>;
+
+/**
+ * One member of this gateway: a user the gateway holds a role (access.v1.Role) or a space
+ * membership for, either. Whom the api-server lets connect to the gateway, and in which
+ * capacity. A user filed somewhere with no role is a member all the same: what they may do
+ * there is the gateway's to decide, and they cannot connect to find out unless reported.
+ *
+ * roles carries a member's service roles alone: ROLE_TECHNICIAN, ROLE_PROPERTY_OWNER and
+ * ROLE_GATEWAY_ADMIN. An empty list means no service role: a resident, or someone filed with
+ * no role. The gateway MUST NOT
+ * send ROLE_RESIDENT or ROLE_UNSPECIFIED here, and the api-server keeps no role but the
+ * three, each once. An entry, in members or removed_user_ids, with no user id is malformed,
+ * and the api-server skips it.
+ *
+ * What the api-server learns of a member with no service role is that they belong to this
+ * gateway, and from when to when — never which home, nor anything else ServiceReach
+ * withholds. A member's changes are sent at once, both ways, since joining is what lets a
+ * person connect and leaving is what revokes them. Roles do not follow relations
+ * (access.v1.MembershipRelation): a relation changing alone changes nothing reported here.
+ *
+ * Who registered the gateway is the api-server's own record, not the gateway's. The
+ * administration that came with registering it is never taken away by this report — not by
+ * its absence from a snapshot, not by removed_user_ids — and ends only with a change of who
+ * is registered as the gateway's administrator at the api-server. Any other administrator is
+ * a member reported with ROLE_GATEWAY_ADMIN, whom the api-server gives what it gives the
+ * registering one, from administrator_since (see ServiceReach). Where the registering
+ * administrator is also reported so, the api-server's record governs: their administration
+ * counts from the earlier of its own start and administrator_since.
+ *
+ * A member here is a user the gateway holds a membership or a role for, and no one else. The
+ * registering administrator is reported only when the gateway holds one of those for them —
+ * a membership, or ROLE_PROPERTY_OWNER they were given — and never with the
+ * ROLE_GATEWAY_ADMIN their token carries. That the gateway recognises them otherwise
+ * (webrtc.v1.MemberDetail.registering_admin) does not make them a member of this report.
+ *
+ * @generated from message kusinta.iot.reporting.v1.GatewayMember
+ */
+export declare type GatewayMember = Message<"kusinta.iot.reporting.v1.GatewayMember"> & {
+  /**
+   * 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;
+
+  /**
+   * The member's service roles, each once; empty for a resident.
+   *
+   * @generated from field: repeated kusinta.iot.access.v1.Role roles = 2;
+   */
+  roles: Role[];
+
+  /**
+   * Set exactly when roles holds ROLE_GATEWAY_ADMIN: the quarter hour, rounded up, from
+   * which the member's administration of the gateway has been unbroken, as the gateway counts
+   * it. Given by the gateway, which saw any break, as ReachedSpace.since is. An administrator
+   * reported without it counts from the quarter hour, rounded up, at which the api-server
+   * applied the report, never earlier.
+   *
+   * @generated from field: google.protobuf.Timestamp administrator_since = 3;
+   */
+  administratorSince?: Timestamp | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.GatewayMember.
+ * Use `create(GatewayMemberSchema)` to create a new message.
+ */
+export declare const GatewayMemberSchema: GenMessage<GatewayMember>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportMembersRequest
+ */
+export declare type ReportMembersRequest = Message<"kusinta.iot.reporting.v1.ReportMembersRequest"> & {
+  /**
+   * This concern's stream; see SnapshotPart.
+   *
+   * @generated from field: string stream_id = 1;
+   */
+  streamId: string;
+
+  /**
+   * The streams this one replaced; see SnapshotPart. Empty on the gateway's first.
+   *
+   * @generated from field: repeated string previous_stream_ids = 2;
+   */
+  previousStreamIds: string[];
+
+  /**
+   * As ReportServiceReachRequest.seq, on this concern's own stream: applied in order,
+   * exactly once, so a late retry cannot restore a member since removed.
+   *
+   * @generated from field: uint64 seq = 3;
+   */
+  seq: bigint;
+
+  /**
+   * Added or changed. Each replaces what the api-server held for that member on this gateway.
+   *
+   * @generated from field: repeated kusinta.iot.reporting.v1.GatewayMember members = 4;
+   */
+  members: GatewayMember[];
+
+  /**
+   * No longer members of this gateway. A user named here and in members is removed.
+   *
+   * @generated from field: repeated kusinta.iot.identity.v1.UserId removed_user_ids = 5;
+   */
+  removedUserIds: UserId[];
+
+  /**
+   * Set when this request is part of a snapshot of every member; users absent from a whole
+   * snapshot are members no more.
+   *
+   * @generated from field: kusinta.iot.reporting.v1.SnapshotPart snapshot = 6;
+   */
+  snapshot?: SnapshotPart | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportMembersRequest.
+ * Use `create(ReportMembersRequestSchema)` to create a new message.
+ */
+export declare const ReportMembersRequestSchema: GenMessage<ReportMembersRequest>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportMembersResponse
+ */
+export declare type ReportMembersResponse = Message<"kusinta.iot.reporting.v1.ReportMembersResponse"> & {
+  /**
+   * 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.ReportMembersResponse.
+ * Use `create(ReportMembersResponseSchema)` to create a new message.
+ */
+export declare const ReportMembersResponseSchema: GenMessage<ReportMembersResponse>;
+
+/**
+ * Which invite secrets this gateway answers for, by hash alone (webrtc.v1 invite.proto
+ * gives the hash), so the api-server can route a redeem (signaling.v1.RedeemInvite) to the
+ * one gateway that can decide it. Nothing else of an invite leaves the gateway here — not
+ * its space, relation, address, creator or expiry — and the hash of a secret says nothing
+ * of the secret.
+ *
+ * A secret's hash is reported from when the secret is issued until it expires, used or not,
+ * so that a user who redeemed it can redeem again and be told what came of it
+ * (signaling.v1.RedeemOutcome). A revoke, and a resend for the old secrets, removes them at
+ * once; an expiry removes them at or soon after the moment, not necessarily to the second,
+ * and the gateway still answers INVALID for an expired secret meanwhile. Changes are sent
+ * at once.
+ *
+ * The api-server keeps the hashes of a gateway's current snapshot and changes only, drops
+ * them all with the gateway, and routes no redeem by a hash it does not hold.
+ *
+ * A gateway MUST NOT report more than 10000 hashes at once (two for each of the at most
+ * 5000 invites webrtc.v1 CreateInvite allows). The api-server MAY ignore hashes past that.
+ *
+ * @generated from message kusinta.iot.reporting.v1.ReportInviteRoutesRequest
+ */
+export declare type ReportInviteRoutesRequest = Message<"kusinta.iot.reporting.v1.ReportInviteRoutesRequest"> & {
+  /**
+   * This concern's stream; see SnapshotPart.
+   *
+   * @generated from field: string stream_id = 1;
+   */
+  streamId: string;
+
+  /**
+   * The streams this one replaced; see SnapshotPart. Empty on the gateway's first.
+   *
+   * @generated from field: repeated string previous_stream_ids = 2;
+   */
+  previousStreamIds: string[];
+
+  /**
+   * As ReportServiceReachRequest.seq, on this concern's own stream.
+   *
+   * @generated from field: uint64 seq = 3;
+   */
+  seq: bigint;
+
+  /**
+   * Secret hashes (32 bytes each) this gateway answers for from now.
+   *
+   * @generated from field: repeated bytes secret_hashes = 4;
+   */
+  secretHashes: Uint8Array[];
+
+  /**
+   * Secret hashes it no longer answers for. A hash named here and in secret_hashes is
+   * removed.
+   *
+   * @generated from field: repeated bytes removed_secret_hashes = 5;
+   */
+  removedSecretHashes: Uint8Array[];
+
+  /**
+   * Set when this request is part of a snapshot of every hash; hashes absent from a whole
+   * snapshot are routed here no more.
+   *
+   * @generated from field: kusinta.iot.reporting.v1.SnapshotPart snapshot = 6;
+   */
+  snapshot?: SnapshotPart | undefined;
+};
+
+/**
+ * Describes the message kusinta.iot.reporting.v1.ReportInviteRoutesRequest.
+ * Use `create(ReportInviteRoutesRequestSchema)` to create a new message.
+ */
+export declare const ReportInviteRoutesRequestSchema: GenMessage<ReportInviteRoutesRequest>;
+
+/**
+ * @generated from message kusinta.iot.reporting.v1.ReportInviteRoutesResponse
+ */
+export declare type ReportInviteRoutesResponse = Message<"kusinta.iot.reporting.v1.ReportInviteRoutesResponse"> & {
+  /**
+   * 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.ReportInviteRoutesResponse.
+ * Use `create(ReportInviteRoutesResponseSchema)` to create a new message.
+ */
+export declare const ReportInviteRoutesResponseSchema: GenMessage<ReportInviteRoutesResponse>;
+
+/**
+ * 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. Does not open, or open again,
+   * while its connector is settling: a connector problem open, or the settling time after
+   * one; see ClearReason. Closes CLEAR_REASON_RECOVERED only once the connector reports the
+   * device reachable again.
+   *
+   * @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. A connector problem (see ClearReason): while
+   * it is open, no DEVICE_OFFLINE opens for the devices behind that connector, and those open
+   * close as superseded by a connector problem (see ClearReason), one problem rather than one
+   * per device. Closes with CLEAR_REASON_RECOVERED when the connector reconnects, or
+   * CLEAR_REASON_NO_LONGER_REPORTED when the gateway stops tracking the connector.
+   *
+   * @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. Raised from the connector's own health
+   * reports (connector.v1.BackendHealthReport); backend_failure carries the category, never
+   * the connector's own detail. A connector problem, as CONNECTOR_OFFLINE is: while it is
+   * open, no DEVICE_OFFLINE opens for the devices behind that connector, and those open close
+   * as superseded by a connector problem (see ClearReason). Closes with
+   * CLEAR_REASON_RECOVERED when the health is no longer FAILING,
+   * CLEAR_REASON_SUPERSEDED_BY_CONNECTOR_OFFLINE when the connector's stream drops, a
+   * CONNECTOR_OFFLINE opening in the same step, or
+   * CLEAR_REASON_NO_LONGER_REPORTED when the gateway stops tracking the connector.
+   *
+   * @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.
+ *
+ * A connector problem is CONNECTOR_OFFLINE or CONNECTOR_ERROR, and at most one is open for a
+ * connector at a time: one problem rather than one per device. While one is open, no
+ * DEVICE_OFFLINE opens, or opens again, for the devices behind that connector, and the gateway
+ * closes each DEVICE_OFFLINE of a device still reported behind it with the SUPERSEDED_* reason
+ * naming the connector problem open as it closes it: at once for a device outside any home;
+ * for a device in a home at the next quarter hour, so a receiver may hold both open until
+ * then. If no connector problem is open by that quarter hour — it came and went — nothing is
+ * sent, and the DEVICE_OFFLINE stays open, closing as below.
+ *
+ * A connector is settling while a connector problem of it is open, and for a settling time
+ * after one ends, in which the connector and its devices report again; how long is the
+ * gateway's own policy, but at least 2 minutes and at most 5 minutes after the connector
+ * problem ended: time for the connector to state its health and report its devices'
+ * reachability again (see connector.v1.BackendHealthReport). A device the connector has not
+ * reported reachable by then is judged on what the gateway last heard of it. While it is
+ * settling, no DEVICE_OFFLINE opens, or opens again, for its devices; a connector whose
+ * problems keep recurring within its settling time keeps them from opening, and its connector
+ * problems are what is reported. A DEVICE_OFFLINE closes CLEAR_REASON_RECOVERED only once the
+ * connector reports the device reachable again, never for the mere absence of a report; it
+ * closes with a SUPERSEDED_* reason as said above, and on a move, a removal or leaving what the
+ * gateway reports as for any problem. Once its connector is no longer settling, the gateway
+ * judges its devices afresh: a device still unreachable that has no DEVICE_OFFLINE open — one
+ * closed as superseded or moved, one that started being reported or went unreachable meanwhile
+ * — opens one, stamped as Problem says. So a device outside a home that stays unreachable
+ * through an outage has its DEVICE_OFFLINE closed as superseded and a new one opened after it.
+ *
+ * The gateway closes a problem when it decides the clear — for a device in
+ * a home, at the quarter hour — and a clear queued or sent again keeps the reason it was
+ * given then. Times are as for any transition (see Problem): a device in a home is
+ * stamped only with quarter hours, and no time crosses a home's boundary.
+ *
+ * When the gateway stops tracking a connector — when is the gateway's own policy — the
+ * connector and the devices behind it stop being reported, and their open problems close
+ * with NO_LONGER_REPORTED. A removed device's problems always close with DEVICE_REMOVED, even
+ * when it also stops being reported; any other subject that stops being reported always
+ * closes with NO_LONGER_REPORTED. Neither takes a SUPERSEDED_* reason, even while a connector
+ * problem is open.
+ *
+ * @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,
+   * never with a SUPERSEDED_* reason (see above).
+   *
+   * @generated from enum value: CLEAR_REASON_DEVICE_REMOVED = 3;
+   */
+  DEVICE_REMOVED = 3,
+
+  /**
+   * The connector behind the device went offline. For a DEVICE_OFFLINE, and for a
+   * CONNECTOR_ERROR whose connector's stream dropped; no other problem is superseded. See
+   * above.
+   *
+   * @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, a connector the gateway has
+   * stopped tracking and the devices behind it. A device handed to a resident, or a device or
+   * room leaving with a move, is sent, and stamped, at the next quarter hour; anything else
+   * as Problem says for its subject.
+   * Never replaced by a SUPERSEDED_* reason (see above).
+   *
+   * @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 — a DEVICE_OFFLINE only while its connector is not
+   * settling (see above). A DEVICE_OFFLINE closes with a SUPERSEDED_* reason instead when a
+   * connector problem of its connector is open as the gateway closes it (see above).
+   *
+   * @generated from enum value: CLEAR_REASON_MOVED = 6;
+   */
+  MOVED = 6,
+
+  /**
+   * The backend of the connector behind the device is failing. For a DEVICE_OFFLINE only; no
+   * other problem is superseded. See above.
+   *
+   * @generated from enum value: CLEAR_REASON_SUPERSEDED_BY_CONNECTOR_ERROR = 7;
+   */
+  SUPERSEDED_BY_CONNECTOR_ERROR = 7,
+}
+
+/**
+ * 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>;
+