@camstack/addon-matter-broker 0.2.61 → 0.2.63

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
@@ -13007,6 +13007,24 @@ var deviceProviderCapability = {
13007
13007
  })
13008
13008
  }
13009
13009
  };
13010
+ /**
13011
+ * Device Manager capability — hub-side singleton that unifies device persistence,
13012
+ * live registry access, and all management operations into a single tRPC surface.
13013
+ *
13014
+ * Replaces:
13015
+ * - `device-persistence` capability (persistence methods absorbed here)
13016
+ * - `device-management.router.ts` (deleted in Phase 2)
13017
+ * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
13018
+ *
13019
+ * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
13020
+ * fork into separate processes but never run on remote cluster agents. Therefore:
13021
+ * - No nodeId routing needed — this is a pure hub singleton.
13022
+ * - The hub's DeviceRegistry is the single source of truth for all live devices.
13023
+ * - No shadow registry or cross-node aggregation required.
13024
+ *
13025
+ * Forked workers register devices back to the hub via `ctx.devices`
13026
+ * (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
13027
+ */
13010
13028
  /** One child-placement directive on a container's `childLayout`. Structurally
13011
13029
  * identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
13012
13030
  * shape for the same field. The child is identified by its re-sync-stable
@@ -18733,6 +18751,9 @@ var RetrainStatusSchema = _enum([
18733
18751
  *
18734
18752
  * `debug` does NOT pin; it is attention, not durability.
18735
18753
  *
18754
+ * `debugNote` is the operator's own words about WHAT should be checked on this
18755
+ * track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
18756
+ *
18736
18757
  * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
18737
18758
  * A favourited track is skipped by retention the same way `staging` is, but
18738
18759
  * it does not enter `none|staging|trained` and has no staging budget.
@@ -18743,6 +18764,21 @@ var TrackFlagFields = {
18743
18764
  markForTrain: boolean().optional(),
18744
18765
  /** Operator marked this track for diagnostic attention. */
18745
18766
  debug: boolean().optional(),
18767
+ /**
18768
+ * What the operator wants CHECKED on this track, in their own words.
18769
+ *
18770
+ * The flag alone says "look at this" and nothing about what for; a debug set
18771
+ * reviewed hours later is a list of tracks with no question attached. Bound
18772
+ * to `debug` on the WRITE side — the body clears it when `debug` goes off,
18773
+ * and refuses it on a track whose debug is off — so a note can never outlive
18774
+ * the attention it belongs to.
18775
+ *
18776
+ * `''` is a real value ("marked, nothing to add"); the ABSENT key means
18777
+ * "leave whatever is stored alone", which is what lets a surface turn debug
18778
+ * on without a note (a cancelled prompt) and what lets it edit the note
18779
+ * without touching the flag.
18780
+ */
18781
+ debugNote: string$2().max(500).optional(),
18746
18782
  /** Operator favourited this track. Pins it against pruning. */
18747
18783
  favourited: boolean().optional()
18748
18784
  };
@@ -18769,6 +18805,12 @@ var TrackFlagsSchema = object({
18769
18805
  trackId: string$2(),
18770
18806
  markForTrain: boolean(),
18771
18807
  debug: boolean(),
18808
+ /** The note as it STANDS after the write — never absent here (a track with no
18809
+ * note reports `''`), for the same reason the booleans are required: a
18810
+ * surface that has just written must be able to render the note it now owns
18811
+ * without a re-fetch, and an absent key would read as "unchanged" on a
18812
+ * screen that has no previous value to keep. */
18813
+ debugNote: string$2(),
18772
18814
  favourited: boolean(),
18773
18815
  /** The lifecycle state the boolean was derived from. Required here (unlike on
18774
18816
  * a track row) because this shape is only ever produced by the write body,
package/dist/addon.mjs CHANGED
@@ -13005,6 +13005,24 @@ var deviceProviderCapability = {
13005
13005
  })
13006
13006
  }
13007
13007
  };
13008
+ /**
13009
+ * Device Manager capability — hub-side singleton that unifies device persistence,
13010
+ * live registry access, and all management operations into a single tRPC surface.
13011
+ *
13012
+ * Replaces:
13013
+ * - `device-persistence` capability (persistence methods absorbed here)
13014
+ * - `device-management.router.ts` (deleted in Phase 2)
13015
+ * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
13016
+ *
13017
+ * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
13018
+ * fork into separate processes but never run on remote cluster agents. Therefore:
13019
+ * - No nodeId routing needed — this is a pure hub singleton.
13020
+ * - The hub's DeviceRegistry is the single source of truth for all live devices.
13021
+ * - No shadow registry or cross-node aggregation required.
13022
+ *
13023
+ * Forked workers register devices back to the hub via `ctx.devices`
13024
+ * (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
13025
+ */
13008
13026
  /** One child-placement directive on a container's `childLayout`. Structurally
13009
13027
  * identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
13010
13028
  * shape for the same field. The child is identified by its re-sync-stable
@@ -18731,6 +18749,9 @@ var RetrainStatusSchema = _enum([
18731
18749
  *
18732
18750
  * `debug` does NOT pin; it is attention, not durability.
18733
18751
  *
18752
+ * `debugNote` is the operator's own words about WHAT should be checked on this
18753
+ * track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
18754
+ *
18734
18755
  * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
18735
18756
  * A favourited track is skipped by retention the same way `staging` is, but
18736
18757
  * it does not enter `none|staging|trained` and has no staging budget.
@@ -18741,6 +18762,21 @@ var TrackFlagFields = {
18741
18762
  markForTrain: boolean().optional(),
18742
18763
  /** Operator marked this track for diagnostic attention. */
18743
18764
  debug: boolean().optional(),
18765
+ /**
18766
+ * What the operator wants CHECKED on this track, in their own words.
18767
+ *
18768
+ * The flag alone says "look at this" and nothing about what for; a debug set
18769
+ * reviewed hours later is a list of tracks with no question attached. Bound
18770
+ * to `debug` on the WRITE side — the body clears it when `debug` goes off,
18771
+ * and refuses it on a track whose debug is off — so a note can never outlive
18772
+ * the attention it belongs to.
18773
+ *
18774
+ * `''` is a real value ("marked, nothing to add"); the ABSENT key means
18775
+ * "leave whatever is stored alone", which is what lets a surface turn debug
18776
+ * on without a note (a cancelled prompt) and what lets it edit the note
18777
+ * without touching the flag.
18778
+ */
18779
+ debugNote: string$2().max(500).optional(),
18744
18780
  /** Operator favourited this track. Pins it against pruning. */
18745
18781
  favourited: boolean().optional()
18746
18782
  };
@@ -18767,6 +18803,12 @@ var TrackFlagsSchema = object({
18767
18803
  trackId: string$2(),
18768
18804
  markForTrain: boolean(),
18769
18805
  debug: boolean(),
18806
+ /** The note as it STANDS after the write — never absent here (a track with no
18807
+ * note reports `''`), for the same reason the booleans are required: a
18808
+ * surface that has just written must be able to render the note it now owns
18809
+ * without a re-fetch, and an absent key would read as "unchanged" on a
18810
+ * screen that has no previous value to keep. */
18811
+ debugNote: string$2(),
18770
18812
  favourited: boolean(),
18771
18813
  /** The lifecycle state the boolean was derived from. Required here (unlike on
18772
18814
  * a track row) because this shape is only ever produced by the write body,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-matter-broker",
3
- "version": "0.2.61",
3
+ "version": "0.2.63",
4
4
  "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
5
5
  "keywords": [
6
6
  "camstack",