@camstack/addon-mqtt-broker 1.2.76 → 1.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.
@@ -7980,13 +7980,28 @@ var RecordingBandSchema = object({
7980
7980
  end: string().regex(HHMM),
7981
7981
  mode: RecordingBandModeSchema,
7982
7982
  triggers: RecordingBandTriggersSchema.optional(),
7983
+ /**
7984
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7985
+ *
7986
+ * It was the retroactive KEEP bound — which already-written segments survive
7987
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7988
+ * broker could serve, or the gate would delete the seconds the ring had just
7989
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7990
+ * expression of the broker's retention, in different units, in a different
7991
+ * addon, with an invariant the operator had to maintain by hand. The keep
7992
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7993
+ * left to configure here.
7994
+ *
7995
+ * The key survives in the SHAPE so a config written before that record still
7996
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7997
+ * strict, so simply deleting it would strip an operator's value in silence on
7998
+ * the next save (the failure D380 came one commit from shipping). Nothing
7999
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8000
+ */
7983
8001
  preBufferSec: number().min(0).optional(),
7984
8002
  postBufferSec: number().min(0).optional()
7985
8003
  });
7986
- ({
7987
- preBufferSec: 15,
7988
- postBufferSec: 30
7989
- }).postBufferSec * 1e3;
8004
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7990
8005
  /**
7991
8006
  * Per-device retention overrides. Every field is optional; an unset or `0`
7992
8007
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10563,12 +10578,30 @@ var BackupDestinationInfoSchema = object({
10563
10578
  lastSuccessAt: number().optional(),
10564
10579
  /** Newest-archive size from `manifests.json`, or undefined. */
10565
10580
  lastSuccessSizeBytes: number().optional(),
10566
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10581
+ /**
10582
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10583
+ * destination, comma-joined. Absent when no enabled schedule targets it
10584
+ * — a destination nothing is scheduled to write to must not advertise a
10585
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10586
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10587
+ * and reading it made a destination with a DISABLED schedule claim a
10588
+ * nightly run.
10589
+ */
10567
10590
  cron: string().optional(),
10568
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10591
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10569
10592
  nextRunAt: number().optional(),
10570
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10571
- lastRunAt: number().optional()
10593
+ /**
10594
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10595
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10596
+ * newest archive that actually landed) and `lastError`.
10597
+ */
10598
+ lastAttemptAt: number().optional(),
10599
+ /**
10600
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10601
+ * landed the archive. A destination that has never been written to has
10602
+ * neither this nor `lastAttemptAt`.
10603
+ */
10604
+ lastError: string().optional()
10572
10605
  });
10573
10606
  /**
10574
10607
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10731,8 +10764,16 @@ var BackupScheduleSchema = object({
10731
10764
  retentionCount: number().int().min(1).max(1e3),
10732
10765
  /** Optional subset of source locations to include; omitted = all. */
10733
10766
  dataSources: array(string()).readonly().optional(),
10734
- /** ms-epoch of last successful run. */
10735
- lastRunAt: number().optional(),
10767
+ /**
10768
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10769
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10770
+ * "succeeded" — a run refused by every destination stamps it too.
10771
+ */
10772
+ lastAttemptAt: number().optional(),
10773
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10774
+ lastSuccessAt: number().optional(),
10775
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10776
+ lastError: string().optional(),
10736
10777
  /** ms-epoch of next computed firing (read-only, filled on list). */
10737
10778
  nextRunAt: number().optional()
10738
10779
  });
@@ -10781,14 +10822,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10781
10822
  locationId: string(),
10782
10823
  enabled: boolean(),
10783
10824
  retentionCount: number().int().min(1).max(1e3),
10784
- label: string().optional(),
10785
- /**
10786
- * Per-destination cron expression. Empty string clears the
10787
- * schedule (manual-only). Validated server-side via croner;
10788
- * malformed expressions reject the upsert with an actionable
10789
- * message.
10790
- */
10791
- cron: string().optional()
10825
+ label: string().optional()
10792
10826
  }), _void(), {
10793
10827
  kind: "mutation",
10794
10828
  auth: "admin"
@@ -7975,13 +7975,28 @@ var RecordingBandSchema = object({
7975
7975
  end: string().regex(HHMM),
7976
7976
  mode: RecordingBandModeSchema,
7977
7977
  triggers: RecordingBandTriggersSchema.optional(),
7978
+ /**
7979
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7980
+ *
7981
+ * It was the retroactive KEEP bound — which already-written segments survive
7982
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7983
+ * broker could serve, or the gate would delete the seconds the ring had just
7984
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7985
+ * expression of the broker's retention, in different units, in a different
7986
+ * addon, with an invariant the operator had to maintain by hand. The keep
7987
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7988
+ * left to configure here.
7989
+ *
7990
+ * The key survives in the SHAPE so a config written before that record still
7991
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7992
+ * strict, so simply deleting it would strip an operator's value in silence on
7993
+ * the next save (the failure D380 came one commit from shipping). Nothing
7994
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7995
+ */
7978
7996
  preBufferSec: number().min(0).optional(),
7979
7997
  postBufferSec: number().min(0).optional()
7980
7998
  });
7981
- ({
7982
- preBufferSec: 15,
7983
- postBufferSec: 30
7984
- }).postBufferSec * 1e3;
7999
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7985
8000
  /**
7986
8001
  * Per-device retention overrides. Every field is optional; an unset or `0`
7987
8002
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10558,12 +10573,30 @@ var BackupDestinationInfoSchema = object({
10558
10573
  lastSuccessAt: number().optional(),
10559
10574
  /** Newest-archive size from `manifests.json`, or undefined. */
10560
10575
  lastSuccessSizeBytes: number().optional(),
10561
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10576
+ /**
10577
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10578
+ * destination, comma-joined. Absent when no enabled schedule targets it
10579
+ * — a destination nothing is scheduled to write to must not advertise a
10580
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10581
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10582
+ * and reading it made a destination with a DISABLED schedule claim a
10583
+ * nightly run.
10584
+ */
10562
10585
  cron: string().optional(),
10563
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10586
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10564
10587
  nextRunAt: number().optional(),
10565
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10566
- lastRunAt: number().optional()
10588
+ /**
10589
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10590
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10591
+ * newest archive that actually landed) and `lastError`.
10592
+ */
10593
+ lastAttemptAt: number().optional(),
10594
+ /**
10595
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10596
+ * landed the archive. A destination that has never been written to has
10597
+ * neither this nor `lastAttemptAt`.
10598
+ */
10599
+ lastError: string().optional()
10567
10600
  });
10568
10601
  /**
10569
10602
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10726,8 +10759,16 @@ var BackupScheduleSchema = object({
10726
10759
  retentionCount: number().int().min(1).max(1e3),
10727
10760
  /** Optional subset of source locations to include; omitted = all. */
10728
10761
  dataSources: array(string()).readonly().optional(),
10729
- /** ms-epoch of last successful run. */
10730
- lastRunAt: number().optional(),
10762
+ /**
10763
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10764
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10765
+ * "succeeded" — a run refused by every destination stamps it too.
10766
+ */
10767
+ lastAttemptAt: number().optional(),
10768
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10769
+ lastSuccessAt: number().optional(),
10770
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10771
+ lastError: string().optional(),
10731
10772
  /** ms-epoch of next computed firing (read-only, filled on list). */
10732
10773
  nextRunAt: number().optional()
10733
10774
  });
@@ -10776,14 +10817,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10776
10817
  locationId: string(),
10777
10818
  enabled: boolean(),
10778
10819
  retentionCount: number().int().min(1).max(1e3),
10779
- label: string().optional(),
10780
- /**
10781
- * Per-destination cron expression. Empty string clears the
10782
- * schedule (manual-only). Validated server-side via croner;
10783
- * malformed expressions reject the upsert with an actionable
10784
- * message.
10785
- */
10786
- cron: string().optional()
10820
+ label: string().optional()
10787
10821
  }), _void(), {
10788
10822
  kind: "mutation",
10789
10823
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-mqtt-broker",
3
- "version": "1.2.76",
3
+ "version": "1.2.78",
4
4
  "description": "MQTT broker registry addon for CamStack — manages external broker entries + an optional embedded aedes broker. Consumers spin up their own `mqtt.js` clients via the `mqtt-broker` cap.",
5
5
  "keywords": [
6
6
  "camstack",