@camstack/addon-provider-hikvision 1.2.84 → 1.2.86

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
@@ -10810,12 +10825,30 @@ var BackupDestinationInfoSchema = object({
10810
10825
  lastSuccessAt: number().optional(),
10811
10826
  /** Newest-archive size from `manifests.json`, or undefined. */
10812
10827
  lastSuccessSizeBytes: number().optional(),
10813
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10828
+ /**
10829
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10830
+ * destination, comma-joined. Absent when no enabled schedule targets it
10831
+ * — a destination nothing is scheduled to write to must not advertise a
10832
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10833
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10834
+ * and reading it made a destination with a DISABLED schedule claim a
10835
+ * nightly run.
10836
+ */
10814
10837
  cron: string().optional(),
10815
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10838
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10816
10839
  nextRunAt: number().optional(),
10817
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10818
- lastRunAt: number().optional()
10840
+ /**
10841
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10842
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10843
+ * newest archive that actually landed) and `lastError`.
10844
+ */
10845
+ lastAttemptAt: number().optional(),
10846
+ /**
10847
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10848
+ * landed the archive. A destination that has never been written to has
10849
+ * neither this nor `lastAttemptAt`.
10850
+ */
10851
+ lastError: string().optional()
10819
10852
  });
10820
10853
  /**
10821
10854
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10978,8 +11011,16 @@ var BackupScheduleSchema = object({
10978
11011
  retentionCount: number().int().min(1).max(1e3),
10979
11012
  /** Optional subset of source locations to include; omitted = all. */
10980
11013
  dataSources: array(string()).readonly().optional(),
10981
- /** ms-epoch of last successful run. */
10982
- lastRunAt: number().optional(),
11014
+ /**
11015
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11016
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11017
+ * "succeeded" — a run refused by every destination stamps it too.
11018
+ */
11019
+ lastAttemptAt: number().optional(),
11020
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11021
+ lastSuccessAt: number().optional(),
11022
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11023
+ lastError: string().optional(),
10983
11024
  /** ms-epoch of next computed firing (read-only, filled on list). */
10984
11025
  nextRunAt: number().optional()
10985
11026
  });
@@ -11028,14 +11069,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11028
11069
  locationId: string(),
11029
11070
  enabled: boolean(),
11030
11071
  retentionCount: number().int().min(1).max(1e3),
11031
- label: string().optional(),
11032
- /**
11033
- * Per-destination cron expression. Empty string clears the
11034
- * schedule (manual-only). Validated server-side via croner;
11035
- * malformed expressions reject the upsert with an actionable
11036
- * message.
11037
- */
11038
- cron: string().optional()
11072
+ label: string().optional()
11039
11073
  }), _void(), {
11040
11074
  kind: "mutation",
11041
11075
  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
@@ -10811,12 +10826,30 @@ var BackupDestinationInfoSchema = object({
10811
10826
  lastSuccessAt: number().optional(),
10812
10827
  /** Newest-archive size from `manifests.json`, or undefined. */
10813
10828
  lastSuccessSizeBytes: number().optional(),
10814
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10829
+ /**
10830
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10831
+ * destination, comma-joined. Absent when no enabled schedule targets it
10832
+ * — a destination nothing is scheduled to write to must not advertise a
10833
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10834
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10835
+ * and reading it made a destination with a DISABLED schedule claim a
10836
+ * nightly run.
10837
+ */
10815
10838
  cron: string().optional(),
10816
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10839
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10817
10840
  nextRunAt: number().optional(),
10818
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10819
- lastRunAt: number().optional()
10841
+ /**
10842
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10843
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10844
+ * newest archive that actually landed) and `lastError`.
10845
+ */
10846
+ lastAttemptAt: number().optional(),
10847
+ /**
10848
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10849
+ * landed the archive. A destination that has never been written to has
10850
+ * neither this nor `lastAttemptAt`.
10851
+ */
10852
+ lastError: string().optional()
10820
10853
  });
10821
10854
  /**
10822
10855
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10979,8 +11012,16 @@ var BackupScheduleSchema = object({
10979
11012
  retentionCount: number().int().min(1).max(1e3),
10980
11013
  /** Optional subset of source locations to include; omitted = all. */
10981
11014
  dataSources: array(string()).readonly().optional(),
10982
- /** ms-epoch of last successful run. */
10983
- lastRunAt: number().optional(),
11015
+ /**
11016
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11017
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11018
+ * "succeeded" — a run refused by every destination stamps it too.
11019
+ */
11020
+ lastAttemptAt: number().optional(),
11021
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11022
+ lastSuccessAt: number().optional(),
11023
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11024
+ lastError: string().optional(),
10984
11025
  /** ms-epoch of next computed firing (read-only, filled on list). */
10985
11026
  nextRunAt: number().optional()
10986
11027
  });
@@ -11029,14 +11070,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11029
11070
  locationId: string(),
11030
11071
  enabled: boolean(),
11031
11072
  retentionCount: number().int().min(1).max(1e3),
11032
- label: string().optional(),
11033
- /**
11034
- * Per-destination cron expression. Empty string clears the
11035
- * schedule (manual-only). Validated server-side via croner;
11036
- * malformed expressions reject the upsert with an actionable
11037
- * message.
11038
- */
11039
- cron: string().optional()
11073
+ label: string().optional()
11040
11074
  }), _void(), {
11041
11075
  kind: "mutation",
11042
11076
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-hikvision",
3
- "version": "1.2.84",
3
+ "version": "1.2.86",
4
4
  "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
5
5
  "keywords": [
6
6
  "camstack",