@camstack/addon-provider-rtsp 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.
package/dist/addon.js CHANGED
@@ -8007,13 +8007,28 @@ var RecordingBandSchema = object({
8007
8007
  end: string().regex(HHMM),
8008
8008
  mode: RecordingBandModeSchema,
8009
8009
  triggers: RecordingBandTriggersSchema.optional(),
8010
+ /**
8011
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8012
+ *
8013
+ * It was the retroactive KEEP bound — which already-written segments survive
8014
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8015
+ * broker could serve, or the gate would delete the seconds the ring had just
8016
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8017
+ * expression of the broker's retention, in different units, in a different
8018
+ * addon, with an invariant the operator had to maintain by hand. The keep
8019
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8020
+ * left to configure here.
8021
+ *
8022
+ * The key survives in the SHAPE so a config written before that record still
8023
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8024
+ * strict, so simply deleting it would strip an operator's value in silence on
8025
+ * the next save (the failure D380 came one commit from shipping). Nothing
8026
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8027
+ */
8010
8028
  preBufferSec: number().min(0).optional(),
8011
8029
  postBufferSec: number().min(0).optional()
8012
8030
  });
8013
- ({
8014
- preBufferSec: 15,
8015
- postBufferSec: 30
8016
- }).postBufferSec * 1e3;
8031
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8017
8032
  /**
8018
8033
  * Per-device retention overrides. Every field is optional; an unset or `0`
8019
8034
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10590,12 +10605,30 @@ var BackupDestinationInfoSchema = object({
10590
10605
  lastSuccessAt: number().optional(),
10591
10606
  /** Newest-archive size from `manifests.json`, or undefined. */
10592
10607
  lastSuccessSizeBytes: number().optional(),
10593
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10608
+ /**
10609
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10610
+ * destination, comma-joined. Absent when no enabled schedule targets it
10611
+ * — a destination nothing is scheduled to write to must not advertise a
10612
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10613
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10614
+ * and reading it made a destination with a DISABLED schedule claim a
10615
+ * nightly run.
10616
+ */
10594
10617
  cron: string().optional(),
10595
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10618
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10596
10619
  nextRunAt: number().optional(),
10597
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10598
- lastRunAt: number().optional()
10620
+ /**
10621
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10622
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10623
+ * newest archive that actually landed) and `lastError`.
10624
+ */
10625
+ lastAttemptAt: number().optional(),
10626
+ /**
10627
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10628
+ * landed the archive. A destination that has never been written to has
10629
+ * neither this nor `lastAttemptAt`.
10630
+ */
10631
+ lastError: string().optional()
10599
10632
  });
10600
10633
  /**
10601
10634
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10758,8 +10791,16 @@ var BackupScheduleSchema = object({
10758
10791
  retentionCount: number().int().min(1).max(1e3),
10759
10792
  /** Optional subset of source locations to include; omitted = all. */
10760
10793
  dataSources: array(string()).readonly().optional(),
10761
- /** ms-epoch of last successful run. */
10762
- lastRunAt: number().optional(),
10794
+ /**
10795
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10796
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10797
+ * "succeeded" — a run refused by every destination stamps it too.
10798
+ */
10799
+ lastAttemptAt: number().optional(),
10800
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10801
+ lastSuccessAt: number().optional(),
10802
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10803
+ lastError: string().optional(),
10763
10804
  /** ms-epoch of next computed firing (read-only, filled on list). */
10764
10805
  nextRunAt: number().optional()
10765
10806
  });
@@ -10808,14 +10849,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10808
10849
  locationId: string(),
10809
10850
  enabled: boolean(),
10810
10851
  retentionCount: number().int().min(1).max(1e3),
10811
- label: string().optional(),
10812
- /**
10813
- * Per-destination cron expression. Empty string clears the
10814
- * schedule (manual-only). Validated server-side via croner;
10815
- * malformed expressions reject the upsert with an actionable
10816
- * message.
10817
- */
10818
- cron: string().optional()
10852
+ label: string().optional()
10819
10853
  }), _void(), {
10820
10854
  kind: "mutation",
10821
10855
  auth: "admin"
package/dist/addon.mjs CHANGED
@@ -7983,13 +7983,28 @@ var RecordingBandSchema = object({
7983
7983
  end: string().regex(HHMM),
7984
7984
  mode: RecordingBandModeSchema,
7985
7985
  triggers: RecordingBandTriggersSchema.optional(),
7986
+ /**
7987
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7988
+ *
7989
+ * It was the retroactive KEEP bound — which already-written segments survive
7990
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7991
+ * broker could serve, or the gate would delete the seconds the ring had just
7992
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7993
+ * expression of the broker's retention, in different units, in a different
7994
+ * addon, with an invariant the operator had to maintain by hand. The keep
7995
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7996
+ * left to configure here.
7997
+ *
7998
+ * The key survives in the SHAPE so a config written before that record still
7999
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8000
+ * strict, so simply deleting it would strip an operator's value in silence on
8001
+ * the next save (the failure D380 came one commit from shipping). Nothing
8002
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8003
+ */
7986
8004
  preBufferSec: number().min(0).optional(),
7987
8005
  postBufferSec: number().min(0).optional()
7988
8006
  });
7989
- ({
7990
- preBufferSec: 15,
7991
- postBufferSec: 30
7992
- }).postBufferSec * 1e3;
8007
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7993
8008
  /**
7994
8009
  * Per-device retention overrides. Every field is optional; an unset or `0`
7995
8010
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10566,12 +10581,30 @@ var BackupDestinationInfoSchema = object({
10566
10581
  lastSuccessAt: number().optional(),
10567
10582
  /** Newest-archive size from `manifests.json`, or undefined. */
10568
10583
  lastSuccessSizeBytes: number().optional(),
10569
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10584
+ /**
10585
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10586
+ * destination, comma-joined. Absent when no enabled schedule targets it
10587
+ * — a destination nothing is scheduled to write to must not advertise a
10588
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10589
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10590
+ * and reading it made a destination with a DISABLED schedule claim a
10591
+ * nightly run.
10592
+ */
10570
10593
  cron: string().optional(),
10571
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10594
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10572
10595
  nextRunAt: number().optional(),
10573
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10574
- lastRunAt: number().optional()
10596
+ /**
10597
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10598
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10599
+ * newest archive that actually landed) and `lastError`.
10600
+ */
10601
+ lastAttemptAt: number().optional(),
10602
+ /**
10603
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10604
+ * landed the archive. A destination that has never been written to has
10605
+ * neither this nor `lastAttemptAt`.
10606
+ */
10607
+ lastError: string().optional()
10575
10608
  });
10576
10609
  /**
10577
10610
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10734,8 +10767,16 @@ var BackupScheduleSchema = object({
10734
10767
  retentionCount: number().int().min(1).max(1e3),
10735
10768
  /** Optional subset of source locations to include; omitted = all. */
10736
10769
  dataSources: array(string()).readonly().optional(),
10737
- /** ms-epoch of last successful run. */
10738
- lastRunAt: number().optional(),
10770
+ /**
10771
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10772
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10773
+ * "succeeded" — a run refused by every destination stamps it too.
10774
+ */
10775
+ lastAttemptAt: number().optional(),
10776
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10777
+ lastSuccessAt: number().optional(),
10778
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10779
+ lastError: string().optional(),
10739
10780
  /** ms-epoch of next computed firing (read-only, filled on list). */
10740
10781
  nextRunAt: number().optional()
10741
10782
  });
@@ -10784,14 +10825,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10784
10825
  locationId: string(),
10785
10826
  enabled: boolean(),
10786
10827
  retentionCount: number().int().min(1).max(1e3),
10787
- label: string().optional(),
10788
- /**
10789
- * Per-destination cron expression. Empty string clears the
10790
- * schedule (manual-only). Validated server-side via croner;
10791
- * malformed expressions reject the upsert with an actionable
10792
- * message.
10793
- */
10794
- cron: string().optional()
10828
+ label: string().optional()
10795
10829
  }), _void(), {
10796
10830
  kind: "mutation",
10797
10831
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rtsp",
3
- "version": "1.2.76",
3
+ "version": "1.2.78",
4
4
  "description": "Generic RTSP camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",