@camstack/addon-provider-dreo 0.2.103 → 0.2.104

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.
package/dist/addon.js CHANGED
@@ -19491,13 +19491,26 @@ var TrackAudioLabelSchema = object({
19491
19491
  * - `audio` — an audio event on the camera itself that was anomalous for
19492
19492
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19493
19493
  *
19494
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19495
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19496
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19497
+ * detector.
19498
+ *
19499
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19500
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19501
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19502
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19503
+ * could not name.
19504
+ *
19494
19505
  * The spatial subsystems (tracker association, occupancy count, re-id /
19495
19506
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19496
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19497
- * check silently readmits every source added after it was written.
19507
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19508
+ * `!== 'sensor'` check silently readmits every source added after it was
19509
+ * written.
19498
19510
  */
19499
19511
  var TrackSourceSchema = _enum([
19500
19512
  "pipeline",
19513
+ "onboard",
19501
19514
  "sensor",
19502
19515
  "audio"
19503
19516
  ]);
@@ -21579,13 +21592,39 @@ var MotionSourceEnum = _enum([
21579
21592
  */
21580
21593
  var MotionSourcesSchema = array(MotionSourceEnum);
21581
21594
  /**
21582
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
21583
- * post-analysis already tags every detection with (`DetectionSource`) rather
21584
- * than a second spelling of the same two ideas — the value an operator picks
21585
- * here is the value that comes back on the track, the overlay and the debug
21586
- * row.
21595
+ * Which root detector a camera runs — EXACTLY ONE.
21596
+ *
21597
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21598
+ * with (`DetectionSource`) rather than a second spelling of the same two
21599
+ * ideas: the value an operator picks here is the value that comes back on the
21600
+ * track, the overlay and the debug row.
21601
+ *
21602
+ * ## Why one, and why it is still an array
21603
+ *
21604
+ * Two roots on one camera is a capability nobody asked for and the operator has
21605
+ * since ruled out. It was never free: both planes feed the SAME per-device
21606
+ * stationary registry, both can promote the same parked object, and the two
21607
+ * detectors disagree about the same box by construction — which is the
21608
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21609
+ *
21610
+ * The ARRAY shape survives because the stored settings and the attach payload
21611
+ * already speak it on every camera of every fleet, and a cap input that
21612
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21613
+ * in the one direction that costs an operator their cameras. So the wire stays
21614
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21615
+ * element rather than refused, and `max(1)` is what every consumer can then
21616
+ * rely on.
21617
+ *
21618
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21619
+ * a camera an operator left with no root detector — and `planDetectionSources`
21620
+ * has always said so: inventing a root for them is how a default acts without
21621
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21622
+ * suite caught it.
21623
+ *
21624
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21625
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21587
21626
  */
21588
- var DetectionSourcesSchema = array(DetectionSourceSchema);
21627
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21589
21628
  /**
21590
21629
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21591
21630
  * so cap-side consumers (the orchestrator forward, the runner addon's
package/dist/addon.mjs CHANGED
@@ -19492,13 +19492,26 @@ var TrackAudioLabelSchema = object({
19492
19492
  * - `audio` — an audio event on the camera itself that was anomalous for
19493
19493
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19494
19494
  *
19495
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19496
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19497
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19498
+ * detector.
19499
+ *
19500
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19501
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19502
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19503
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19504
+ * could not name.
19505
+ *
19495
19506
  * The spatial subsystems (tracker association, occupancy count, re-id /
19496
19507
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19497
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19498
- * check silently readmits every source added after it was written.
19508
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19509
+ * `!== 'sensor'` check silently readmits every source added after it was
19510
+ * written.
19499
19511
  */
19500
19512
  var TrackSourceSchema = _enum([
19501
19513
  "pipeline",
19514
+ "onboard",
19502
19515
  "sensor",
19503
19516
  "audio"
19504
19517
  ]);
@@ -21580,13 +21593,39 @@ var MotionSourceEnum = _enum([
21580
21593
  */
21581
21594
  var MotionSourcesSchema = array(MotionSourceEnum);
21582
21595
  /**
21583
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
21584
- * post-analysis already tags every detection with (`DetectionSource`) rather
21585
- * than a second spelling of the same two ideas — the value an operator picks
21586
- * here is the value that comes back on the track, the overlay and the debug
21587
- * row.
21596
+ * Which root detector a camera runs — EXACTLY ONE.
21597
+ *
21598
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21599
+ * with (`DetectionSource`) rather than a second spelling of the same two
21600
+ * ideas: the value an operator picks here is the value that comes back on the
21601
+ * track, the overlay and the debug row.
21602
+ *
21603
+ * ## Why one, and why it is still an array
21604
+ *
21605
+ * Two roots on one camera is a capability nobody asked for and the operator has
21606
+ * since ruled out. It was never free: both planes feed the SAME per-device
21607
+ * stationary registry, both can promote the same parked object, and the two
21608
+ * detectors disagree about the same box by construction — which is the
21609
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21610
+ *
21611
+ * The ARRAY shape survives because the stored settings and the attach payload
21612
+ * already speak it on every camera of every fleet, and a cap input that
21613
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21614
+ * in the one direction that costs an operator their cameras. So the wire stays
21615
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21616
+ * element rather than refused, and `max(1)` is what every consumer can then
21617
+ * rely on.
21618
+ *
21619
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21620
+ * a camera an operator left with no root detector — and `planDetectionSources`
21621
+ * has always said so: inventing a root for them is how a default acts without
21622
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21623
+ * suite caught it.
21624
+ *
21625
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21626
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21588
21627
  */
21589
- var DetectionSourcesSchema = array(DetectionSourceSchema);
21628
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21590
21629
  /**
21591
21630
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21592
21631
  * 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-provider-dreo",
3
- "version": "0.2.103",
3
+ "version": "0.2.104",
4
4
  "description": "Dreo smart-device (fan / air-circulator / purifier / heater / humidifier) device-provider addon for CamStack — wraps the @apocaliss92/nodedreo Dreo cloud client (REST + WebSocket)",
5
5
  "keywords": [
6
6
  "camstack",