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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kusinta/iot-schema",
-  "version": "0.2.0-beta.21",
+  "version": "0.2.0-beta.22",
   "type": "module",
   "license": "MIT",
   "files": ["src"],

package/src/kusinta/iot/access/v1/acl_pb.d.ts

@@ -332,9 +332,7 @@ export declare type DeviceAcl = Message<"kusinta.iot.access.v1.DeviceAcl"> & {
 export declare const DeviceAclSchema: GenMessage<DeviceAcl>;
 
 /**
- * Every DeviceAcl in force for one user on one gateway, at valid_at — except that what the
- * user newly sees of a home as service appears only from the next quarter hour (see
- * webrtc.v1.LivePermissionUpdate).
+ * Every DeviceAcl in force for one user on one gateway, at valid_at.
  *
  * ADVISORY WHEN SENT TO AN APP. The gateway is the sole authority and enforces every
  * read, write, invoke and subscription against its own copy, whether or not the app has
@@ -439,8 +437,8 @@ export enum ServiceSignal {
    * bridged_by naming a device the recipient may not see, such as a bridge a resident owns,
    * is unset. Always disclosed together with FIRMWARE, whose
    * version it carries. Not when it was claimed: the only times service is given of a
-   * device are the quarter hours of its webrtc.v1.ServiceStatus, and the moment it is taken
-   * away from them.
+   * device are the quarter hours of its webrtc.v1.ServiceStatus, and the moments it appears
+   * to them, changes and is taken away from them, which they see as they happen.
    *
    * @generated from enum value: SERVICE_SIGNAL_FILING = 6;
    */
@@ -456,8 +454,8 @@ export enum ServiceSignal {
 
   /**
    * Which of the building's devices are linked to which, for what, and whether device to
-   * device or through the gateway — not how a link is set or what it is doing, and no
-   * sooner than the quarter hour after it was made; its removal, at once.
+   * device or through the gateway — not how a link is set or what it is doing. A link shows
+   * as it is made and as it is removed, and changes for service at no other time.
    *
    * @generated from enum value: SERVICE_SIGNAL_LINKS = 8;
    */

package/src/kusinta/iot/access/v1/roles_pb.d.ts

@@ -199,8 +199,8 @@ export declare const PermissionActionSchema: GenEnum<PermissionAction>;
  *     RoomClimate.state_withheld marking what is not shown, and its links with
  *     DeviceLink.details_withheld; modes on a home are not sent to them at all. Service
  *     that reaches the apartment itself also gets its climate summary over the disclosed
- *     period. What they newly see of the home reaches them at quarter hours; what they
- *     lose, at once.
+ *     period. What they newly see of the home reaches them as it happens; what they lose,
+ *     at once.
  *   * Not at all — RESIDENT on a building or floor above it. Living in a building is not
  *     living in every apartment in it.
  *
@@ -226,7 +226,7 @@ export declare const PermissionActionSchema: GenEnum<PermissionAction>;
  * to nobody else. An owner who stops living in the home it is filed in gives it up: it is
  * released, with no owner, and stays filed in the home alone, as one of the building's own
  * devices there. A device given up so, or released, then appears to service as any device
- * newly in the home does, at a quarter hour; that much a release shows.
+ * newly in the home does, as it happens; that much a release shows.
  *
  * Who may change a home's members, move its spaces or file devices into and out of it is
  * restricted by the gateway, and a refused caller gets NOT_ENTITLED. This keeps a home's

package/src/kusinta/iot/access/v1/roles_pb.js

@@ -103,8 +103,8 @@ export const MembershipRelationSchema = /*@__PURE__*/
  *     RoomClimate.state_withheld marking what is not shown, and its links with
  *     DeviceLink.details_withheld; modes on a home are not sent to them at all. Service
  *     that reaches the apartment itself also gets its climate summary over the disclosed
- *     period. What they newly see of the home reaches them at quarter hours; what they
- *     lose, at once.
+ *     period. What they newly see of the home reaches them as it happens; what they lose,
+ *     at once.
  *   * Not at all — RESIDENT on a building or floor above it. Living in a building is not
  *     living in every apartment in it.
  *
@@ -130,7 +130,7 @@ export const MembershipRelationSchema = /*@__PURE__*/
  * to nobody else. An owner who stops living in the home it is filed in gives it up: it is
  * released, with no owner, and stays filed in the home alone, as one of the building's own
  * devices there. A device given up so, or released, then appears to service as any device
- * newly in the home does, at a quarter hour; that much a release shows.
+ * newly in the home does, as it happens; that much a release shows.
  *
  * Who may change a home's members, move its spaces or file devices into and out of it is
  * restricted by the gateway, and a refused caller gets NOT_ENTITLED. This keeps a home's

package/src/kusinta/iot/space/v1/space_pb.d.ts

@@ -103,8 +103,7 @@ export declare type Space = Message<"kusinta.iot.space.v1.Space"> & {
    * Filled according to who asks, since a membership list says who lives where:
    *
    *   * a caller holding ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN who reaches the space
-   *     sees every member — for a home they see as service, as it stood at the last
-   *     quarter hour, so that a move in or out is not timed by polling;
+   *     sees every member, in a home they see as service too, as the members change;
    *   * a resident of an apartment sees every member filed on it or on its rooms — who they
    *     live with, and anyone filed on their home as service, since being filed on a home
    *     is an act on it its residents should see. Service reach from a building or floor

package/src/kusinta/iot/webrtc/v1/device_state_pb.d.ts

@@ -17,8 +17,8 @@ export declare const file_kusinta_iot_webrtc_v1_device_state: GenFile;
 
 /**
  * Full device state sent to the app on initial WebRTC connection. Devices the recipient sees
- * as service are as they stood at the last quarter hour, less any since taken away, each
- * with its ServiceStatus.
+ * as service are as they are now, by description only, each with its ServiceStatus once
+ * one has been evaluated for them (see service_statuses).
  *
  * @generated from message kusinta.iot.webrtc.v1.DeviceStateSnapshot
  */
@@ -82,9 +82,9 @@ export declare type ServiceStatus = Message<"kusinta.iot.webrtc.v1.ServiceStatus
    * device, nor, for a resident, than their current residency — each start taken at the
    * first quarter hour at or after it. When that start moves because the recipient becomes
    * a resident, the app drops the status it held and is sent one again from the new start at
-   * the next quarter hour. These quarter hours, and the moment a device is
-   * taken away, are the only times service is given of a device in a home (see
-   * access.v1.MembershipRelation). Pushed and in a
+   * the next quarter hour. These quarter hours, and the moments a device appears to service,
+   * changes and is taken away, which they see as they happen, are the only times service is
+   * given of a device in a home (see access.v1.MembershipRelation). Pushed and in a
    * snapshot alike, so an unchanged status carries the same as_of however it arrived.
    *
    * @generated from field: google.protobuf.Timestamp as_of = 2;
@@ -207,8 +207,8 @@ export declare const PropertyReportSchema: GenMessage<PropertyReport>;
  * Carries the full Device, descriptor plus current typed properties, so the app can
  * render it without a follow-up read — the same payload DeviceStateSnapshot gives
  * per device. To a recipient who sees it as service, the Device carries its description
- * only, as in a snapshot, and is sent at the next quarter hour (see
- * access.v1.DeviceAcl.relation).
+ * only, as in a snapshot, and is sent as it appears; its ServiceStatus follows from the
+ * next quarter hour (see access.v1.DeviceAcl.relation).
  *
  * Apply as an upsert keyed on descriptor.device_id, never as an insert: a device can
  * be in the snapshot and then announced, or announced twice across a connector

package/src/kusinta/iot/webrtc/v1/envelope_pb.d.ts

@@ -485,8 +485,7 @@ export declare const PairingStartedSchema: GenMessage<PairingStarted>;
  * One message per request, not per device: a batch window attributes several, and a client
  * given one message each has nothing telling it the window is over and no defined moment to
  * stop waiting. The devices are listed here; each also arrives as an ordinary DeviceAdded
- * as it appears — for a device the caller sees as service, at the next quarter hour — so a
- * client may show them as they come and use this to finish.
+ * as it appears, so a client may show them as they come and use this to finish.
  *
  * An error and a non-empty device list are not exclusive. A batch of five that attributed
  * three and then expired reports both — three devices and NO_DEVICE_APPEARED — because
@@ -540,11 +539,10 @@ export declare const PairingFinishedSchema: GenMessage<PairingFinished>;
  *
  * Sent only for links the recipient is entitled to see. An unfiltered one would say
  * which devices exist and how they are arranged, to somebody entitled to neither. A link
- * with an end in a home is not pushed to a recipient who sees it as service when it is made
- * or changes — when its residents make one is theirs to know; service reads a home's links
- * by ListDeviceLinks, where a new one appears from the next quarter hour. Its removal is
- * pushed to them at once, with details_withheld, as every loss is — to those whose view
- * held it at a quarter hour since it was made, and to nobody else.
+ * with an end in a home reaches a recipient who sees it as service with details_withheld,
+ * and is pushed to them only when it appears and when it is removed — never for anything
+ * else, its state and settings included, which are not theirs to see. Its removal is pushed
+ * to them at once, as every loss is — to those who were shown it, and to nobody else.
  *
  * @generated from message kusinta.iot.webrtc.v1.LinkChanged
  */
@@ -679,9 +677,9 @@ export declare const ConnectorsAnnouncedSchema: GenMessage<ConnectorsAnnounced>;
  * held at, its condition. Apply as an upsert keyed on room.space_id. Sent only for rooms
  * the recipient may see, and whenever any field the recipient is sent moves — a knob
  * turned by hand shows up here without the app asking. To a recipient who sees the room
- * as service, what is new is sent at the next quarter hour and what is lost at once. A
- * recipient who is sent the room with state_withheld is therefore not sent it when only
- * withheld fields move.
+ * as service, what is new is sent as it happens and what is lost at once. A recipient who
+ * is sent the room with state_withheld is therefore not sent it when only withheld fields
+ * move.
  *
  * @generated from message kusinta.iot.webrtc.v1.RoomClimateChanged
  */

package/src/kusinta/iot/webrtc/v1/management_pb.d.ts

@@ -86,8 +86,7 @@ export declare const CreateSpaceSchema: GenMessage<CreateSpace>;
  * filed on the apartment, where it was in it — and any link it would carry across a
  * boundary is removed. Changing the type of a space that has members needs
  * ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN, who see them, and is refused if it would
- * leave a RESIDENT membership on a room — which can tell them of a membership change since
- * the last quarter hour; that much this refusal discloses.
+ * leave a RESIDENT membership on a room.
  *
  * Every descriptive field carries explicit presence: absent means leave it alone, present
  * means set it to this — including to the empty string, which is how a description is
@@ -478,8 +477,8 @@ export declare const ListSpacesSchema: GenMessage<ListSpaces>;
  * device_ids on each Space are filtered to what the caller may see. An
  * unfiltered tree would list every device on the gateway by id, which is the
  * enumeration channel the snapshot filter exists to close. To a caller who sees a home as
- * service, what is new in it is listed from the next quarter hour and what is gone at once
- * — except its members, which change only at quarter hours (see Space.members).
+ * service, what is new in it is listed as it happens and what is gone at once, its members
+ * included where they are shown (see Space.members).
  *
  * @generated from message kusinta.iot.webrtc.v1.SpaceTree
  */
@@ -652,7 +651,7 @@ export declare const UpdateDeviceLinkSchema: GenMessage<UpdateDeviceLink>;
  *
  * A link with an end in a home reaches a caller who sees it as service with
  * DeviceLink.details_withheld set, and what that withholds unset — a new link
- * from the next quarter hour, a removed one at once — and not at all when either end is a
+ * as it is made, a removed one at once — and not at all when either end is a
  * device a resident owns.
  *
  * @generated from message kusinta.iot.webrtc.v1.ListDeviceLinks
@@ -814,11 +813,11 @@ export declare const ConfigureRoomClimateSchema: GenMessage<ConfigureRoomClimate
  *
  * In a home, only its residents may switch one on or off: whether a home stands empty is
  * theirs to say. A caller who reaches it as service is refused as NOT_ENTITLED — except
- * that, while the home had no resident at the last quarter hour, ROLE_PROPERTY_OWNER or
- * ROLE_GATEWAY_ADMIN may switch off a mode that was on then and whose setter is not a
- * resident now, so that no mode outlives everyone who could end it. Any other switch-off
- * from them — no mode on, or one that is a resident's — is accepted and does nothing, so
- * the answer tells them nothing of whether a mode was on or whether anyone has moved in.
+ * that, while the home has no resident, ROLE_PROPERTY_OWNER or ROLE_GATEWAY_ADMIN may
+ * switch off a mode that is on and whose setter is not a resident, so that no mode
+ * outlives everyone who could end it. Any other switch-off from them — no mode on, or one
+ * that is a resident's — is accepted and does nothing, so the answer tells them nothing of
+ * whether a mode was on or whether anyone has moved in.
  *
  * @generated from message kusinta.iot.webrtc.v1.SetClimateMode
  */
@@ -862,8 +861,8 @@ export declare const SetClimateModeSchema: GenMessage<SetClimateMode>;
  * one the caller can reach; naming a space narrows it to that space and those below.
  *
  * A caller who reaches a room inside an apartment as service gets it with
- * RoomClimate.state_withheld set — what is new from the next quarter hour, what is gone at
- * once — and gets no ClimateMode set on that apartment or its rooms.
+ * RoomClimate.state_withheld set — what is new as it happens, what is gone at once — and
+ * gets no ClimateMode set on that apartment or its rooms.
  *
  * @generated from message kusinta.iot.webrtc.v1.ListRoomClimates
  */
@@ -945,8 +944,7 @@ export declare type PrivacyDisclosure = Message<"kusinta.iot.webrtc.v1.PrivacyDi
    * role the gateway has not yet learnt, counts as ROLE_UNSPECIFIED. The gateway's
    * administrator is always listed. So the list reads the same whether or not anyone lives
    * in the home, and never understates who has reach or what they see. Devices a resident
-   * owns are not shown to service at all. To a caller who sees the space as service, it is
-   * answered as it stood at the last quarter hour.
+   * owns are not shown to service at all.
    *
    * @generated from field: repeated kusinta.iot.webrtc.v1.ServiceParty service_parties = 5;
    */

package/src/kusinta/iot/webrtc/v1/permission_push_pb.d.ts

@@ -13,24 +13,21 @@ import type { DeviceId, SpaceId } from "../../identity/v1/identity_pb.js";
 export declare const file_kusinta_iot_webrtc_v1_permission_push: GenFile;
 
 /**
- * Pushed to the app whenever the user's effective permissions change. A change that takes
- * away what the user may see or do takes effect and is sent at once. What a user newly sees
- * of a home as service — a device filed into it, a home newly reached — is judged at
- * quarter hours instead: here and in a snapshot it is as it stood at the last one, even
- * when the push is for another change, and it is sent at the next quarter hour with
- * change_reason empty and new_permissions.valid_at that quarter hour, so that no push
- * tells when, or why, a home changed. A resident who becomes service loses the resident
- * view at once — the home's devices are listed in removed_devices, so the app drops what it
- * holds of them — and gains the service view at the next quarter hour, when they come back
- * in added_devices as service and their stretch of seeing the home as service begins. A
- * member who becomes a resident gains the resident view at once: the home's devices come
- * again in added_devices, each with a DeviceAdded carrying its full Device, and the app
- * drops the ServiceStatus it held of them until their next one. A quarter-hour
- * push that brings a home newly seen as service lists it in reset_spaces, so the app reads
- * its rooms and links then.
+ * Pushed to the app whenever the user's effective permissions change, as they change. A
+ * change that takes away what the user may see or do takes effect and is sent at once; what
+ * a user newly sees of a home as service — a device filed into it, a home newly reached —
+ * is sent as it happens too, with new_permissions.valid_at the moment it took effect. A
+ * resident who becomes service loses the resident view at once — the home's devices are
+ * listed in removed_devices, so the app drops what it holds of them — and gains the service
+ * view at once, in a push that follows, where they come back in added_devices as service
+ * and their stretch of seeing the home as service begins. A member who becomes a resident
+ * gains the resident view at once: the home's devices come again in added_devices, each
+ * with a DeviceAdded carrying its full Device, and the app drops the ServiceStatus it held
+ * of them until their next one. A push that brings a home newly seen as service lists it in
+ * reset_spaces, so the app reads its rooms and links then.
  * change_reason values: "DEVICE_ASSIGNED", "DEVICE_UNASSIGNED", "RESIDENT_CHANGED",
  * "CONSTRAINT_UPDATED"; empty whenever the change concerns a home the user sees, or saw, as
- * service — held or not — so that no push says why a home changed.
+ * service, so that no push says why a home changed.
  *
  * @generated from message kusinta.iot.webrtc.v1.LivePermissionUpdate
  */
@@ -68,8 +65,8 @@ export declare type LivePermissionUpdate = Message<"kusinta.iot.webrtc.v1.LivePe
    * space, or newly see it as service. The app drops everything it holds of each and of the
    * spaces beneath it, and reads them again (ListSpaces, ListRoomClimates, ListDeviceLinks)
    * if it may.
-   * A loss, or a wider view as a resident, is sent at once; a home newly seen as service, at
-   * the quarter hour it is seen from.
+   * Each is sent as the change happens: a loss, a wider view as a resident and a home newly
+   * seen as service alike.
    *
    * @generated from field: repeated kusinta.iot.identity.v1.SpaceId reset_spaces = 5;
    */