@camstack/addon-export-google 0.1.67 → 0.1.68

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -19321,13 +19321,26 @@ var TrackAudioLabelSchema = object({
19321
19321
  * - `audio` — an audio event on the camera itself that was anomalous for
19322
19322
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19323
19323
  *
19324
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19325
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19326
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19327
+ * detector.
19328
+ *
19329
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19330
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19331
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19332
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19333
+ * could not name.
19334
+ *
19324
19335
  * The spatial subsystems (tracker association, occupancy count, re-id /
19325
19336
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19326
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19327
- * check silently readmits every source added after it was written.
19337
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19338
+ * `!== 'sensor'` check silently readmits every source added after it was
19339
+ * written.
19328
19340
  */
19329
19341
  var TrackSourceSchema = _enum([
19330
19342
  "pipeline",
19343
+ "onboard",
19331
19344
  "sensor",
19332
19345
  "audio"
19333
19346
  ]);
@@ -21409,13 +21422,39 @@ var MotionSourceEnum = _enum([
21409
21422
  */
21410
21423
  var MotionSourcesSchema = array(MotionSourceEnum);
21411
21424
  /**
21412
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
21413
- * post-analysis already tags every detection with (`DetectionSource`) rather
21414
- * than a second spelling of the same two ideas — the value an operator picks
21415
- * here is the value that comes back on the track, the overlay and the debug
21416
- * row.
21425
+ * Which root detector a camera runs — EXACTLY ONE.
21426
+ *
21427
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21428
+ * with (`DetectionSource`) rather than a second spelling of the same two
21429
+ * ideas: the value an operator picks here is the value that comes back on the
21430
+ * track, the overlay and the debug row.
21431
+ *
21432
+ * ## Why one, and why it is still an array
21433
+ *
21434
+ * Two roots on one camera is a capability nobody asked for and the operator has
21435
+ * since ruled out. It was never free: both planes feed the SAME per-device
21436
+ * stationary registry, both can promote the same parked object, and the two
21437
+ * detectors disagree about the same box by construction — which is the
21438
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21439
+ *
21440
+ * The ARRAY shape survives because the stored settings and the attach payload
21441
+ * already speak it on every camera of every fleet, and a cap input that
21442
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21443
+ * in the one direction that costs an operator their cameras. So the wire stays
21444
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21445
+ * element rather than refused, and `max(1)` is what every consumer can then
21446
+ * rely on.
21447
+ *
21448
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21449
+ * a camera an operator left with no root detector — and `planDetectionSources`
21450
+ * has always said so: inventing a root for them is how a default acts without
21451
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21452
+ * suite caught it.
21453
+ *
21454
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21455
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21417
21456
  */
21418
- var DetectionSourcesSchema = array(DetectionSourceSchema);
21457
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21419
21458
  /**
21420
21459
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21421
21460
  * so cap-side consumers (the orchestrator forward, the runner addon's
@@ -19317,13 +19317,26 @@ var TrackAudioLabelSchema = object({
19317
19317
  * - `audio` — an audio event on the camera itself that was anomalous for
19318
19318
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19319
19319
  *
19320
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19321
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19322
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19323
+ * detector.
19324
+ *
19325
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19326
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19327
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19328
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19329
+ * could not name.
19330
+ *
19320
19331
  * The spatial subsystems (tracker association, occupancy count, re-id /
19321
19332
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19322
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19323
- * check silently readmits every source added after it was written.
19333
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19334
+ * `!== 'sensor'` check silently readmits every source added after it was
19335
+ * written.
19324
19336
  */
19325
19337
  var TrackSourceSchema = _enum([
19326
19338
  "pipeline",
19339
+ "onboard",
19327
19340
  "sensor",
19328
19341
  "audio"
19329
19342
  ]);
@@ -21405,13 +21418,39 @@ var MotionSourceEnum = _enum([
21405
21418
  */
21406
21419
  var MotionSourcesSchema = array(MotionSourceEnum);
21407
21420
  /**
21408
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
21409
- * post-analysis already tags every detection with (`DetectionSource`) rather
21410
- * than a second spelling of the same two ideas — the value an operator picks
21411
- * here is the value that comes back on the track, the overlay and the debug
21412
- * row.
21421
+ * Which root detector a camera runs — EXACTLY ONE.
21422
+ *
21423
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21424
+ * with (`DetectionSource`) rather than a second spelling of the same two
21425
+ * ideas: the value an operator picks here is the value that comes back on the
21426
+ * track, the overlay and the debug row.
21427
+ *
21428
+ * ## Why one, and why it is still an array
21429
+ *
21430
+ * Two roots on one camera is a capability nobody asked for and the operator has
21431
+ * since ruled out. It was never free: both planes feed the SAME per-device
21432
+ * stationary registry, both can promote the same parked object, and the two
21433
+ * detectors disagree about the same box by construction — which is the
21434
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21435
+ *
21436
+ * The ARRAY shape survives because the stored settings and the attach payload
21437
+ * already speak it on every camera of every fleet, and a cap input that
21438
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21439
+ * in the one direction that costs an operator their cameras. So the wire stays
21440
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21441
+ * element rather than refused, and `max(1)` is what every consumer can then
21442
+ * rely on.
21443
+ *
21444
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21445
+ * a camera an operator left with no root detector — and `planDetectionSources`
21446
+ * has always said so: inventing a root for them is how a default acts without
21447
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21448
+ * suite caught it.
21449
+ *
21450
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21451
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21413
21452
  */
21414
- var DetectionSourcesSchema = array(DetectionSourceSchema);
21453
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21415
21454
  /**
21416
21455
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21417
21456
  * so cap-side consumers (the orchestrator forward, the runner addon's
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-google",
3
- "version": "0.1.67",
3
+ "version": "0.1.68",
4
4
  "description": "Google Home export — hub-side smart-home fulfillment (SYNC / QUERY / EXECUTE / DISCONNECT) for the non-camera fleet, served over the hub's own OAuth account link. No Google credential is stored, sent or required.",
5
5
  "keywords": [
6
6
  "camstack",