@camstack/addon-provider-rademacher 0.2.102 → 0.2.103

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
@@ -20423,13 +20423,26 @@ var TrackAudioLabelSchema = object({
20423
20423
  * - `audio` — an audio event on the camera itself that was anomalous for
20424
20424
  * THAT camera, loud, and heard while nothing visual was happening (D62).
20425
20425
  *
20426
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
20427
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
20428
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
20429
+ * detector.
20430
+ *
20431
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
20432
+ * a persisted onboard track failed `safeParse` on read and came back with NO
20433
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
20434
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
20435
+ * could not name.
20436
+ *
20426
20437
  * The spatial subsystems (tracker association, occupancy count, re-id /
20427
20438
  * embedding, resurrection) MUST skip every synthetic source. Test for that
20428
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
20429
- * check silently readmits every source added after it was written.
20439
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
20440
+ * `!== 'sensor'` check silently readmits every source added after it was
20441
+ * written.
20430
20442
  */
20431
20443
  var TrackSourceSchema = _enum([
20432
20444
  "pipeline",
20445
+ "onboard",
20433
20446
  "sensor",
20434
20447
  "audio"
20435
20448
  ]);
@@ -22511,13 +22524,39 @@ var MotionSourceEnum = _enum([
22511
22524
  */
22512
22525
  var MotionSourcesSchema = array(MotionSourceEnum);
22513
22526
  /**
22514
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
22515
- * post-analysis already tags every detection with (`DetectionSource`) rather
22516
- * than a second spelling of the same two ideas — the value an operator picks
22517
- * here is the value that comes back on the track, the overlay and the debug
22518
- * row.
22527
+ * Which root detector a camera runs — EXACTLY ONE.
22528
+ *
22529
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
22530
+ * with (`DetectionSource`) rather than a second spelling of the same two
22531
+ * ideas: the value an operator picks here is the value that comes back on the
22532
+ * track, the overlay and the debug row.
22533
+ *
22534
+ * ## Why one, and why it is still an array
22535
+ *
22536
+ * Two roots on one camera is a capability nobody asked for and the operator has
22537
+ * since ruled out. It was never free: both planes feed the SAME per-device
22538
+ * stationary registry, both can promote the same parked object, and the two
22539
+ * detectors disagree about the same box by construction — which is the
22540
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
22541
+ *
22542
+ * The ARRAY shape survives because the stored settings and the attach payload
22543
+ * already speak it on every camera of every fleet, and a cap input that
22544
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
22545
+ * in the one direction that costs an operator their cameras. So the wire stays
22546
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
22547
+ * element rather than refused, and `max(1)` is what every consumer can then
22548
+ * rely on.
22549
+ *
22550
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
22551
+ * a camera an operator left with no root detector — and `planDetectionSources`
22552
+ * has always said so: inventing a root for them is how a default acts without
22553
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
22554
+ * suite caught it.
22555
+ *
22556
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
22557
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
22519
22558
  */
22520
- var DetectionSourcesSchema = array(DetectionSourceSchema);
22559
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
22521
22560
  /**
22522
22561
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
22523
22562
  * so cap-side consumers (the orchestrator forward, the runner addon's
package/dist/addon.mjs CHANGED
@@ -20422,13 +20422,26 @@ var TrackAudioLabelSchema = object({
20422
20422
  * - `audio` — an audio event on the camera itself that was anomalous for
20423
20423
  * THAT camera, loud, and heard while nothing visual was happening (D62).
20424
20424
  *
20425
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
20426
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
20427
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
20428
+ * detector.
20429
+ *
20430
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
20431
+ * a persisted onboard track failed `safeParse` on read and came back with NO
20432
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
20433
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
20434
+ * could not name.
20435
+ *
20425
20436
  * The spatial subsystems (tracker association, occupancy count, re-id /
20426
20437
  * embedding, resurrection) MUST skip every synthetic source. Test for that
20427
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
20428
- * check silently readmits every source added after it was written.
20438
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
20439
+ * `!== 'sensor'` check silently readmits every source added after it was
20440
+ * written.
20429
20441
  */
20430
20442
  var TrackSourceSchema = _enum([
20431
20443
  "pipeline",
20444
+ "onboard",
20432
20445
  "sensor",
20433
20446
  "audio"
20434
20447
  ]);
@@ -22510,13 +22523,39 @@ var MotionSourceEnum = _enum([
22510
22523
  */
22511
22524
  var MotionSourcesSchema = array(MotionSourceEnum);
22512
22525
  /**
22513
- * Which root detectors a camera runs. Deliberately the SAME vocabulary
22514
- * post-analysis already tags every detection with (`DetectionSource`) rather
22515
- * than a second spelling of the same two ideas — the value an operator picks
22516
- * here is the value that comes back on the track, the overlay and the debug
22517
- * row.
22526
+ * Which root detector a camera runs — EXACTLY ONE.
22527
+ *
22528
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
22529
+ * with (`DetectionSource`) rather than a second spelling of the same two
22530
+ * ideas: the value an operator picks here is the value that comes back on the
22531
+ * track, the overlay and the debug row.
22532
+ *
22533
+ * ## Why one, and why it is still an array
22534
+ *
22535
+ * Two roots on one camera is a capability nobody asked for and the operator has
22536
+ * since ruled out. It was never free: both planes feed the SAME per-device
22537
+ * stationary registry, both can promote the same parked object, and the two
22538
+ * detectors disagree about the same box by construction — which is the
22539
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
22540
+ *
22541
+ * The ARRAY shape survives because the stored settings and the attach payload
22542
+ * already speak it on every camera of every fleet, and a cap input that
22543
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
22544
+ * in the one direction that costs an operator their cameras. So the wire stays
22545
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
22546
+ * element rather than refused, and `max(1)` is what every consumer can then
22547
+ * rely on.
22548
+ *
22549
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
22550
+ * a camera an operator left with no root detector — and `planDetectionSources`
22551
+ * has always said so: inventing a root for them is how a default acts without
22552
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
22553
+ * suite caught it.
22554
+ *
22555
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
22556
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
22518
22557
  */
22519
- var DetectionSourcesSchema = array(DetectionSourceSchema);
22558
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
22520
22559
  /**
22521
22560
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
22522
22561
  * 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-rademacher",
3
- "version": "0.2.102",
3
+ "version": "0.2.103",
4
4
  "description": "Rademacher HomePilot device-provider addon for CamStack — wraps the @apocaliss92/noderademacher local-hub client (roller shutters over the cover cap)",
5
5
  "keywords": [
6
6
  "camstack",