@camstack/addon-provider-dreo 0.2.63 → 0.2.64

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
@@ -12980,6 +12980,24 @@ var deviceProviderCapability = {
12980
12980
  })
12981
12981
  }
12982
12982
  };
12983
+ /**
12984
+ * Device Manager capability — hub-side singleton that unifies device persistence,
12985
+ * live registry access, and all management operations into a single tRPC surface.
12986
+ *
12987
+ * Replaces:
12988
+ * - `device-persistence` capability (persistence methods absorbed here)
12989
+ * - `device-management.router.ts` (deleted in Phase 2)
12990
+ * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
12991
+ *
12992
+ * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
12993
+ * fork into separate processes but never run on remote cluster agents. Therefore:
12994
+ * - No nodeId routing needed — this is a pure hub singleton.
12995
+ * - The hub's DeviceRegistry is the single source of truth for all live devices.
12996
+ * - No shadow registry or cross-node aggregation required.
12997
+ *
12998
+ * Forked workers register devices back to the hub via `ctx.devices`
12999
+ * (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
13000
+ */
12983
13001
  /** One child-placement directive on a container's `childLayout`. Structurally
12984
13002
  * identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
12985
13003
  * shape for the same field. The child is identified by its re-sync-stable
@@ -18706,6 +18724,9 @@ var RetrainStatusSchema = _enum([
18706
18724
  *
18707
18725
  * `debug` does NOT pin; it is attention, not durability.
18708
18726
  *
18727
+ * `debugNote` is the operator's own words about WHAT should be checked on this
18728
+ * track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
18729
+ *
18709
18730
  * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
18710
18731
  * A favourited track is skipped by retention the same way `staging` is, but
18711
18732
  * it does not enter `none|staging|trained` and has no staging budget.
@@ -18716,6 +18737,21 @@ var TrackFlagFields = {
18716
18737
  markForTrain: boolean().optional(),
18717
18738
  /** Operator marked this track for diagnostic attention. */
18718
18739
  debug: boolean().optional(),
18740
+ /**
18741
+ * What the operator wants CHECKED on this track, in their own words.
18742
+ *
18743
+ * The flag alone says "look at this" and nothing about what for; a debug set
18744
+ * reviewed hours later is a list of tracks with no question attached. Bound
18745
+ * to `debug` on the WRITE side — the body clears it when `debug` goes off,
18746
+ * and refuses it on a track whose debug is off — so a note can never outlive
18747
+ * the attention it belongs to.
18748
+ *
18749
+ * `''` is a real value ("marked, nothing to add"); the ABSENT key means
18750
+ * "leave whatever is stored alone", which is what lets a surface turn debug
18751
+ * on without a note (a cancelled prompt) and what lets it edit the note
18752
+ * without touching the flag.
18753
+ */
18754
+ debugNote: string().max(500).optional(),
18719
18755
  /** Operator favourited this track. Pins it against pruning. */
18720
18756
  favourited: boolean().optional()
18721
18757
  };
@@ -18742,6 +18778,12 @@ var TrackFlagsSchema = object({
18742
18778
  trackId: string(),
18743
18779
  markForTrain: boolean(),
18744
18780
  debug: boolean(),
18781
+ /** The note as it STANDS after the write — never absent here (a track with no
18782
+ * note reports `''`), for the same reason the booleans are required: a
18783
+ * surface that has just written must be able to render the note it now owns
18784
+ * without a re-fetch, and an absent key would read as "unchanged" on a
18785
+ * screen that has no previous value to keep. */
18786
+ debugNote: string(),
18745
18787
  favourited: boolean(),
18746
18788
  /** The lifecycle state the boolean was derived from. Required here (unlike on
18747
18789
  * a track row) because this shape is only ever produced by the write body,
package/dist/addon.mjs CHANGED
@@ -12981,6 +12981,24 @@ var deviceProviderCapability = {
12981
12981
  })
12982
12982
  }
12983
12983
  };
12984
+ /**
12985
+ * Device Manager capability — hub-side singleton that unifies device persistence,
12986
+ * live registry access, and all management operations into a single tRPC surface.
12987
+ *
12988
+ * Replaces:
12989
+ * - `device-persistence` capability (persistence methods absorbed here)
12990
+ * - `device-management.router.ts` (deleted in Phase 2)
12991
+ * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
12992
+ *
12993
+ * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
12994
+ * fork into separate processes but never run on remote cluster agents. Therefore:
12995
+ * - No nodeId routing needed — this is a pure hub singleton.
12996
+ * - The hub's DeviceRegistry is the single source of truth for all live devices.
12997
+ * - No shadow registry or cross-node aggregation required.
12998
+ *
12999
+ * Forked workers register devices back to the hub via `ctx.devices`
13000
+ * (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
13001
+ */
12984
13002
  /** One child-placement directive on a container's `childLayout`. Structurally
12985
13003
  * identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
12986
13004
  * shape for the same field. The child is identified by its re-sync-stable
@@ -18707,6 +18725,9 @@ var RetrainStatusSchema = _enum([
18707
18725
  *
18708
18726
  * `debug` does NOT pin; it is attention, not durability.
18709
18727
  *
18728
+ * `debugNote` is the operator's own words about WHAT should be checked on this
18729
+ * track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
18730
+ *
18710
18731
  * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
18711
18732
  * A favourited track is skipped by retention the same way `staging` is, but
18712
18733
  * it does not enter `none|staging|trained` and has no staging budget.
@@ -18717,6 +18738,21 @@ var TrackFlagFields = {
18717
18738
  markForTrain: boolean().optional(),
18718
18739
  /** Operator marked this track for diagnostic attention. */
18719
18740
  debug: boolean().optional(),
18741
+ /**
18742
+ * What the operator wants CHECKED on this track, in their own words.
18743
+ *
18744
+ * The flag alone says "look at this" and nothing about what for; a debug set
18745
+ * reviewed hours later is a list of tracks with no question attached. Bound
18746
+ * to `debug` on the WRITE side — the body clears it when `debug` goes off,
18747
+ * and refuses it on a track whose debug is off — so a note can never outlive
18748
+ * the attention it belongs to.
18749
+ *
18750
+ * `''` is a real value ("marked, nothing to add"); the ABSENT key means
18751
+ * "leave whatever is stored alone", which is what lets a surface turn debug
18752
+ * on without a note (a cancelled prompt) and what lets it edit the note
18753
+ * without touching the flag.
18754
+ */
18755
+ debugNote: string().max(500).optional(),
18720
18756
  /** Operator favourited this track. Pins it against pruning. */
18721
18757
  favourited: boolean().optional()
18722
18758
  };
@@ -18743,6 +18779,12 @@ var TrackFlagsSchema = object({
18743
18779
  trackId: string(),
18744
18780
  markForTrain: boolean(),
18745
18781
  debug: boolean(),
18782
+ /** The note as it STANDS after the write — never absent here (a track with no
18783
+ * note reports `''`), for the same reason the booleans are required: a
18784
+ * surface that has just written must be able to render the note it now owns
18785
+ * without a re-fetch, and an absent key would read as "unchanged" on a
18786
+ * screen that has no previous value to keep. */
18787
+ debugNote: string(),
18746
18788
  favourited: boolean(),
18747
18789
  /** The lifecycle state the boolean was derived from. Required here (unlike on
18748
18790
  * 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-provider-dreo",
3
- "version": "0.2.63",
3
+ "version": "0.2.64",
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",