@camstack/addon-provider-onvif 1.2.75 → 1.2.77

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
@@ -7950,13 +7950,28 @@ var RecordingBandSchema = object({
7950
7950
  end: string().regex(HHMM),
7951
7951
  mode: RecordingBandModeSchema,
7952
7952
  triggers: RecordingBandTriggersSchema.optional(),
7953
+ /**
7954
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7955
+ *
7956
+ * It was the retroactive KEEP bound — which already-written segments survive
7957
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7958
+ * broker could serve, or the gate would delete the seconds the ring had just
7959
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7960
+ * expression of the broker's retention, in different units, in a different
7961
+ * addon, with an invariant the operator had to maintain by hand. The keep
7962
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7963
+ * left to configure here.
7964
+ *
7965
+ * The key survives in the SHAPE so a config written before that record still
7966
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7967
+ * strict, so simply deleting it would strip an operator's value in silence on
7968
+ * the next save (the failure D380 came one commit from shipping). Nothing
7969
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7970
+ */
7953
7971
  preBufferSec: number().min(0).optional(),
7954
7972
  postBufferSec: number().min(0).optional()
7955
7973
  });
7956
- ({
7957
- preBufferSec: 15,
7958
- postBufferSec: 30
7959
- }).postBufferSec * 1e3;
7974
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7960
7975
  /**
7961
7976
  * Per-device retention overrides. Every field is optional; an unset or `0`
7962
7977
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10533,12 +10548,30 @@ var BackupDestinationInfoSchema = object({
10533
10548
  lastSuccessAt: number().optional(),
10534
10549
  /** Newest-archive size from `manifests.json`, or undefined. */
10535
10550
  lastSuccessSizeBytes: number().optional(),
10536
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10551
+ /**
10552
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10553
+ * destination, comma-joined. Absent when no enabled schedule targets it
10554
+ * — a destination nothing is scheduled to write to must not advertise a
10555
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10556
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10557
+ * and reading it made a destination with a DISABLED schedule claim a
10558
+ * nightly run.
10559
+ */
10537
10560
  cron: string().optional(),
10538
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10561
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10539
10562
  nextRunAt: number().optional(),
10540
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10541
- lastRunAt: number().optional()
10563
+ /**
10564
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10565
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10566
+ * newest archive that actually landed) and `lastError`.
10567
+ */
10568
+ lastAttemptAt: number().optional(),
10569
+ /**
10570
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10571
+ * landed the archive. A destination that has never been written to has
10572
+ * neither this nor `lastAttemptAt`.
10573
+ */
10574
+ lastError: string().optional()
10542
10575
  });
10543
10576
  /**
10544
10577
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10701,8 +10734,16 @@ var BackupScheduleSchema = object({
10701
10734
  retentionCount: number().int().min(1).max(1e3),
10702
10735
  /** Optional subset of source locations to include; omitted = all. */
10703
10736
  dataSources: array(string()).readonly().optional(),
10704
- /** ms-epoch of last successful run. */
10705
- lastRunAt: number().optional(),
10737
+ /**
10738
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10739
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10740
+ * "succeeded" — a run refused by every destination stamps it too.
10741
+ */
10742
+ lastAttemptAt: number().optional(),
10743
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10744
+ lastSuccessAt: number().optional(),
10745
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10746
+ lastError: string().optional(),
10706
10747
  /** ms-epoch of next computed firing (read-only, filled on list). */
10707
10748
  nextRunAt: number().optional()
10708
10749
  });
@@ -10751,14 +10792,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10751
10792
  locationId: string(),
10752
10793
  enabled: boolean(),
10753
10794
  retentionCount: number().int().min(1).max(1e3),
10754
- label: string().optional(),
10755
- /**
10756
- * Per-destination cron expression. Empty string clears the
10757
- * schedule (manual-only). Validated server-side via croner;
10758
- * malformed expressions reject the upsert with an actionable
10759
- * message.
10760
- */
10761
- cron: string().optional()
10795
+ label: string().optional()
10762
10796
  }), _void(), {
10763
10797
  kind: "mutation",
10764
10798
  auth: "admin"
package/dist/addon.mjs CHANGED
@@ -7951,13 +7951,28 @@ var RecordingBandSchema = object({
7951
7951
  end: string().regex(HHMM),
7952
7952
  mode: RecordingBandModeSchema,
7953
7953
  triggers: RecordingBandTriggersSchema.optional(),
7954
+ /**
7955
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7956
+ *
7957
+ * It was the retroactive KEEP bound — which already-written segments survive
7958
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7959
+ * broker could serve, or the gate would delete the seconds the ring had just
7960
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7961
+ * expression of the broker's retention, in different units, in a different
7962
+ * addon, with an invariant the operator had to maintain by hand. The keep
7963
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7964
+ * left to configure here.
7965
+ *
7966
+ * The key survives in the SHAPE so a config written before that record still
7967
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7968
+ * strict, so simply deleting it would strip an operator's value in silence on
7969
+ * the next save (the failure D380 came one commit from shipping). Nothing
7970
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7971
+ */
7954
7972
  preBufferSec: number().min(0).optional(),
7955
7973
  postBufferSec: number().min(0).optional()
7956
7974
  });
7957
- ({
7958
- preBufferSec: 15,
7959
- postBufferSec: 30
7960
- }).postBufferSec * 1e3;
7975
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7961
7976
  /**
7962
7977
  * Per-device retention overrides. Every field is optional; an unset or `0`
7963
7978
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10534,12 +10549,30 @@ var BackupDestinationInfoSchema = object({
10534
10549
  lastSuccessAt: number().optional(),
10535
10550
  /** Newest-archive size from `manifests.json`, or undefined. */
10536
10551
  lastSuccessSizeBytes: number().optional(),
10537
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10552
+ /**
10553
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10554
+ * destination, comma-joined. Absent when no enabled schedule targets it
10555
+ * — a destination nothing is scheduled to write to must not advertise a
10556
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10557
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10558
+ * and reading it made a destination with a DISABLED schedule claim a
10559
+ * nightly run.
10560
+ */
10538
10561
  cron: string().optional(),
10539
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10562
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10540
10563
  nextRunAt: number().optional(),
10541
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10542
- lastRunAt: number().optional()
10564
+ /**
10565
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10566
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10567
+ * newest archive that actually landed) and `lastError`.
10568
+ */
10569
+ lastAttemptAt: number().optional(),
10570
+ /**
10571
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10572
+ * landed the archive. A destination that has never been written to has
10573
+ * neither this nor `lastAttemptAt`.
10574
+ */
10575
+ lastError: string().optional()
10543
10576
  });
10544
10577
  /**
10545
10578
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10702,8 +10735,16 @@ var BackupScheduleSchema = object({
10702
10735
  retentionCount: number().int().min(1).max(1e3),
10703
10736
  /** Optional subset of source locations to include; omitted = all. */
10704
10737
  dataSources: array(string()).readonly().optional(),
10705
- /** ms-epoch of last successful run. */
10706
- lastRunAt: number().optional(),
10738
+ /**
10739
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10740
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10741
+ * "succeeded" — a run refused by every destination stamps it too.
10742
+ */
10743
+ lastAttemptAt: number().optional(),
10744
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10745
+ lastSuccessAt: number().optional(),
10746
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10747
+ lastError: string().optional(),
10707
10748
  /** ms-epoch of next computed firing (read-only, filled on list). */
10708
10749
  nextRunAt: number().optional()
10709
10750
  });
@@ -10752,14 +10793,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10752
10793
  locationId: string(),
10753
10794
  enabled: boolean(),
10754
10795
  retentionCount: number().int().min(1).max(1e3),
10755
- label: string().optional(),
10756
- /**
10757
- * Per-destination cron expression. Empty string clears the
10758
- * schedule (manual-only). Validated server-side via croner;
10759
- * malformed expressions reject the upsert with an actionable
10760
- * message.
10761
- */
10762
- cron: string().optional()
10796
+ label: string().optional()
10763
10797
  }), _void(), {
10764
10798
  kind: "mutation",
10765
10799
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-onvif",
3
- "version": "1.2.75",
3
+ "version": "1.2.77",
4
4
  "description": "ONVIF camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",