@camstack/types 1.2.551 → 1.2.552

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/CHANGELOG.md CHANGED
@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.2.552] - 2026-11-12
11
+
12
+ ### Fixed
13
+
14
+ - An on-demand stream that stops because nobody is watching is not a stream outage.
15
+ - A battery connection error means the whole camera stayed down for the sustained outage window. A short dial failure is not stream offline.
16
+
10
17
  ## [1.2.551] - 2026-11-12
11
18
 
12
19
  ### Changed
@@ -784,22 +784,25 @@ export interface TopologyNode {
784
784
  * Why a broker's stream health flipped — the discriminator that separates an
785
785
  * OUTAGE from an intentional state change.
786
786
  *
787
- * A `stream.offline` on its own says nothing about whether anything is wrong:
788
- * the same event is fired when a camera stops sending video AND when the last
789
- * consumer left and the broker suspended its dial on purpose. A consumer that
790
- * reads only the category cannot tell them apart, and the Notification Center
791
- * shipped exactly that bug — an operator notified that a stream went down
792
- * every time nobody was watching it.
787
+ * A `stream.offline` on its own says nothing about whether anything is wrong,
788
+ * so the reason is part of the payload. The broker emits an outage only for
789
+ * the reasons a consumer may notify on. An on-demand stream that stops
790
+ * because its session went idle is not offline: the broker emits no
791
+ * `stream.offline` and no matching `stream.online`. It remembers `suspended`
792
+ * only so the rebuild is not announced as `recovered`. `suspended` on a
793
+ * `stream.online` is still how an announced outage is closed when the last
794
+ * consumer leaves.
793
795
  *
794
796
  * - `stale-timeout` — no video packet for the broker's stale window
795
- * (120 s). The ONLY outage. This is what a notification may act on.
796
- * - `recovered` — packets resumed after a `stale-timeout`. The
797
- * matching end of an outage.
798
- * - `first-packet` — a broker's first ever packet. A stream coming up, not
799
- * a recovery: there was no outage before it.
800
- * - `suspended` — the lazy-dial idle suspend (no demand). Deliberate.
801
- * - `resumed` — demand returned and the dial came back. The matching
802
- * end of a `suspended`, and equally deliberate.
797
+ * (120 s) while the stream was demanded. An outage.
798
+ * - `recovered` — packets resumed after an outage. The matching end.
799
+ * - `first-packet` — a broker's first ever packet, and it was never idle.
800
+ * A stream coming up, not a recovery: there was no outage before it.
801
+ * - `suspended` — remembered for an idle teardown (not emitted as
802
+ * offline). Also the reason on the `stream.online` that closes an outage
803
+ * whose last consumer left.
804
+ * - `resumed` — the matching end of a `suspended`. The broker no
805
+ * longer emits it; a rebuild after idle is silence.
803
806
  * - `broker-destroyed` — the stream was unpublished/released. Deliberate.
804
807
  *
805
808
  * A BATTERY camera sleeping is none of these: a sleep or a plain wake emits no
@@ -808,8 +811,11 @@ export interface TopologyNode {
808
811
  *
809
812
  * - `wake-timeout` — a wake was DEMANDED (live viewer, recording,
810
813
  * explicit force) and no stream arrived inside its bound.
811
- * - `connection-error` — the camera is reported awake and its stream is
812
- * gone.
814
+ * - `connection-error` — the camera is reported awake and no source of it
815
+ * is delivering. The broker holds this until the sustained window (the
816
+ * same 120 s as `stale-timeout`) has elapsed with the whole camera still
817
+ * down. A dial that recovers inside the window, or a source that fails
818
+ * while another source of the camera delivers, emits nothing.
813
819
  * - `battery-unreachable` — nothing heard from the camera past its battery
814
820
  * refresh window (`BATTERY_UNREACHABLE_AFTER_MS`, D847).
815
821
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/types",
3
- "version": "1.2.551",
3
+ "version": "1.2.552",
4
4
  "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
5
5
  "keywords": [
6
6
  "camstack",