@camstack/addon-provider-amcrest 0.2.78 → 0.2.80

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