@camstack/addon-provider-dreo 0.2.76 → 0.2.78

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
@@ -7987,13 +7987,28 @@ var RecordingBandSchema = object({
7987
7987
  end: string().regex(HHMM),
7988
7988
  mode: RecordingBandModeSchema,
7989
7989
  triggers: RecordingBandTriggersSchema.optional(),
7990
+ /**
7991
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7992
+ *
7993
+ * It was the retroactive KEEP bound — which already-written segments survive
7994
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7995
+ * broker could serve, or the gate would delete the seconds the ring had just
7996
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7997
+ * expression of the broker's retention, in different units, in a different
7998
+ * addon, with an invariant the operator had to maintain by hand. The keep
7999
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8000
+ * left to configure here.
8001
+ *
8002
+ * The key survives in the SHAPE so a config written before that record still
8003
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8004
+ * strict, so simply deleting it would strip an operator's value in silence on
8005
+ * the next save (the failure D380 came one commit from shipping). Nothing
8006
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8007
+ */
7990
8008
  preBufferSec: number().min(0).optional(),
7991
8009
  postBufferSec: number().min(0).optional()
7992
8010
  });
7993
- ({
7994
- preBufferSec: 15,
7995
- postBufferSec: 30
7996
- }).postBufferSec * 1e3;
8011
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7997
8012
  /**
7998
8013
  * Per-device retention overrides. Every field is optional; an unset or `0`
7999
8014
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10570,12 +10585,30 @@ var BackupDestinationInfoSchema = object({
10570
10585
  lastSuccessAt: number().optional(),
10571
10586
  /** Newest-archive size from `manifests.json`, or undefined. */
10572
10587
  lastSuccessSizeBytes: number().optional(),
10573
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10588
+ /**
10589
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10590
+ * destination, comma-joined. Absent when no enabled schedule targets it
10591
+ * — a destination nothing is scheduled to write to must not advertise a
10592
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10593
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10594
+ * and reading it made a destination with a DISABLED schedule claim a
10595
+ * nightly run.
10596
+ */
10574
10597
  cron: string().optional(),
10575
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10598
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10576
10599
  nextRunAt: number().optional(),
10577
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10578
- lastRunAt: number().optional()
10600
+ /**
10601
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10602
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10603
+ * newest archive that actually landed) and `lastError`.
10604
+ */
10605
+ lastAttemptAt: number().optional(),
10606
+ /**
10607
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10608
+ * landed the archive. A destination that has never been written to has
10609
+ * neither this nor `lastAttemptAt`.
10610
+ */
10611
+ lastError: string().optional()
10579
10612
  });
10580
10613
  /**
10581
10614
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10738,8 +10771,16 @@ var BackupScheduleSchema = object({
10738
10771
  retentionCount: number().int().min(1).max(1e3),
10739
10772
  /** Optional subset of source locations to include; omitted = all. */
10740
10773
  dataSources: array(string()).readonly().optional(),
10741
- /** ms-epoch of last successful run. */
10742
- lastRunAt: number().optional(),
10774
+ /**
10775
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10776
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10777
+ * "succeeded" — a run refused by every destination stamps it too.
10778
+ */
10779
+ lastAttemptAt: number().optional(),
10780
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10781
+ lastSuccessAt: number().optional(),
10782
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10783
+ lastError: string().optional(),
10743
10784
  /** ms-epoch of next computed firing (read-only, filled on list). */
10744
10785
  nextRunAt: number().optional()
10745
10786
  });
@@ -10788,14 +10829,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10788
10829
  locationId: string(),
10789
10830
  enabled: boolean(),
10790
10831
  retentionCount: number().int().min(1).max(1e3),
10791
- label: string().optional(),
10792
- /**
10793
- * Per-destination cron expression. Empty string clears the
10794
- * schedule (manual-only). Validated server-side via croner;
10795
- * malformed expressions reject the upsert with an actionable
10796
- * message.
10797
- */
10798
- cron: string().optional()
10832
+ label: string().optional()
10799
10833
  }), _void(), {
10800
10834
  kind: "mutation",
10801
10835
  auth: "admin"
package/dist/addon.mjs CHANGED
@@ -7988,13 +7988,28 @@ var RecordingBandSchema = object({
7988
7988
  end: string().regex(HHMM),
7989
7989
  mode: RecordingBandModeSchema,
7990
7990
  triggers: RecordingBandTriggersSchema.optional(),
7991
+ /**
7992
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7993
+ *
7994
+ * It was the retroactive KEEP bound — which already-written segments survive
7995
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7996
+ * broker could serve, or the gate would delete the seconds the ring had just
7997
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7998
+ * expression of the broker's retention, in different units, in a different
7999
+ * addon, with an invariant the operator had to maintain by hand. The keep
8000
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8001
+ * left to configure here.
8002
+ *
8003
+ * The key survives in the SHAPE so a config written before that record still
8004
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8005
+ * strict, so simply deleting it would strip an operator's value in silence on
8006
+ * the next save (the failure D380 came one commit from shipping). Nothing
8007
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8008
+ */
7991
8009
  preBufferSec: number().min(0).optional(),
7992
8010
  postBufferSec: number().min(0).optional()
7993
8011
  });
7994
- ({
7995
- preBufferSec: 15,
7996
- postBufferSec: 30
7997
- }).postBufferSec * 1e3;
8012
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7998
8013
  /**
7999
8014
  * Per-device retention overrides. Every field is optional; an unset or `0`
8000
8015
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10571,12 +10586,30 @@ var BackupDestinationInfoSchema = object({
10571
10586
  lastSuccessAt: number().optional(),
10572
10587
  /** Newest-archive size from `manifests.json`, or undefined. */
10573
10588
  lastSuccessSizeBytes: number().optional(),
10574
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10589
+ /**
10590
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10591
+ * destination, comma-joined. Absent when no enabled schedule targets it
10592
+ * — a destination nothing is scheduled to write to must not advertise a
10593
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10594
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10595
+ * and reading it made a destination with a DISABLED schedule claim a
10596
+ * nightly run.
10597
+ */
10575
10598
  cron: string().optional(),
10576
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10599
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10577
10600
  nextRunAt: number().optional(),
10578
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10579
- lastRunAt: number().optional()
10601
+ /**
10602
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10603
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10604
+ * newest archive that actually landed) and `lastError`.
10605
+ */
10606
+ lastAttemptAt: number().optional(),
10607
+ /**
10608
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10609
+ * landed the archive. A destination that has never been written to has
10610
+ * neither this nor `lastAttemptAt`.
10611
+ */
10612
+ lastError: string().optional()
10580
10613
  });
10581
10614
  /**
10582
10615
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10739,8 +10772,16 @@ var BackupScheduleSchema = object({
10739
10772
  retentionCount: number().int().min(1).max(1e3),
10740
10773
  /** Optional subset of source locations to include; omitted = all. */
10741
10774
  dataSources: array(string()).readonly().optional(),
10742
- /** ms-epoch of last successful run. */
10743
- lastRunAt: number().optional(),
10775
+ /**
10776
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10777
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10778
+ * "succeeded" — a run refused by every destination stamps it too.
10779
+ */
10780
+ lastAttemptAt: number().optional(),
10781
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10782
+ lastSuccessAt: number().optional(),
10783
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10784
+ lastError: string().optional(),
10744
10785
  /** ms-epoch of next computed firing (read-only, filled on list). */
10745
10786
  nextRunAt: number().optional()
10746
10787
  });
@@ -10789,14 +10830,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10789
10830
  locationId: string(),
10790
10831
  enabled: boolean(),
10791
10832
  retentionCount: number().int().min(1).max(1e3),
10792
- label: string().optional(),
10793
- /**
10794
- * Per-destination cron expression. Empty string clears the
10795
- * schedule (manual-only). Validated server-side via croner;
10796
- * malformed expressions reject the upsert with an actionable
10797
- * message.
10798
- */
10799
- cron: string().optional()
10833
+ label: string().optional()
10800
10834
  }), _void(), {
10801
10835
  kind: "mutation",
10802
10836
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-dreo",
3
- "version": "0.2.76",
3
+ "version": "0.2.78",
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",