@vincentt-xr/harness 1.2.0 → 1.4.0

package/dist/shared/events.d.ts

@@ -129,6 +129,20 @@ export interface RelayQuery {
      * debugging rather than for "whose phone".
      */
     viewer?: string;
+    /**
+     * Ask the relay to also report how many connections are attached RIGHT NOW.
+     *
+     * An OPTIONAL BOOLEAN and not a `kind` value: `kind` is a `DiagEventKind`
+     * event-type FILTER shared with `DiagEvent.kind`, so a "presence" member there
+     * would invent a meaningless event type. It is also not an `op` discriminator,
+     * which would imply a mode the type never had and need a default — a version
+     * branch by another name.
+     *
+     * An unknown field is IGNORED by a relay that predates this, so an old relay
+     * answers a valid envelope with no counts and the caller reads none. That is
+     * the whole of the version negotiation: there is none.
+     */
+    presence?: boolean;
 }
 export interface RelayResult {
     events: DiagEvent[];
@@ -171,6 +185,31 @@ export interface RelayResult {
      * set rather than remembering one.
      */
     viewers: string[];
+    /**
+     * How many connections are attached RIGHT NOW. Present only when the query
+     * asked for presence, and only from a relay that understands the field.
+     *
+     * ⚠ THIS IS NOT `viewers.length`, AND THE TWO SIT IN THE SAME OBJECT.
+     * `viewers`/`testers` are EVER-SEEN sets that are never pruned by design, so
+     * they answer "who has ever connected to this run". A caller that falls back
+     * to them when this field is absent prints a phone that closed its tab twenty
+     * minutes ago as still watching. ABSENT MEANS UNKNOWN, and the only correct
+     * response to unknown is to say nothing.
+     *
+     * The source is the relay's live socket set, so a socket that closes leaves
+     * it. Counts CONNECTIONS, not devices or people: one tab opens several under
+     * HTTP/1.1, which is why every surface that prints this says "connections".
+     */
+    liveConnections?: number;
+    /**
+     * Distinct resolved testers among the currently-open connections. Present
+     * under the same condition as `liveConnections`.
+     *
+     * A connection whose key missed the grammar resolves to no tester, so it
+     * counts toward `liveConnections` and not toward this — correct, because it
+     * is a real attached connection of an unknown tab.
+     */
+    liveTesters?: number;
 }
 /** A freehand stroke over the frame, in normalized [0,1] frame coordinates. */
 export interface AnnotationStroke {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincentt-xr/harness",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Vincentt AR dev-loop harness - in-app diagnostics provider + wire contract",
   "license": "UNLICENSED",
   "type": "module",