@camstack/addon-decoder-nodeav 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/index.js 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
@@ -10571,12 +10586,30 @@ var BackupDestinationInfoSchema = object({
10571
10586
  lastSuccessAt: number().optional(),
10572
10587
  /** Newest-archive size from `manifests.json`, or undefined. */
10573
10588
  lastSuccessSizeBytes: number().optional(),
10574
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10589
+ /**
10590
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10591
+ * destination, comma-joined. Absent when no enabled schedule targets it
10592
+ * — a destination nothing is scheduled to write to must not advertise a
10593
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10594
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10595
+ * and reading it made a destination with a DISABLED schedule claim a
10596
+ * nightly run.
10597
+ */
10575
10598
  cron: string().optional(),
10576
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10599
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10577
10600
  nextRunAt: number().optional(),
10578
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10579
- lastRunAt: number().optional()
10601
+ /**
10602
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10603
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10604
+ * newest archive that actually landed) and `lastError`.
10605
+ */
10606
+ lastAttemptAt: number().optional(),
10607
+ /**
10608
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10609
+ * landed the archive. A destination that has never been written to has
10610
+ * neither this nor `lastAttemptAt`.
10611
+ */
10612
+ lastError: string().optional()
10580
10613
  });
10581
10614
  /**
10582
10615
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10739,8 +10772,16 @@ var BackupScheduleSchema = object({
10739
10772
  retentionCount: number().int().min(1).max(1e3),
10740
10773
  /** Optional subset of source locations to include; omitted = all. */
10741
10774
  dataSources: array(string()).readonly().optional(),
10742
- /** ms-epoch of last successful run. */
10743
- lastRunAt: number().optional(),
10775
+ /**
10776
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10777
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10778
+ * "succeeded" — a run refused by every destination stamps it too.
10779
+ */
10780
+ lastAttemptAt: number().optional(),
10781
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10782
+ lastSuccessAt: number().optional(),
10783
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10784
+ lastError: string().optional(),
10744
10785
  /** ms-epoch of next computed firing (read-only, filled on list). */
10745
10786
  nextRunAt: number().optional()
10746
10787
  });
@@ -10789,14 +10830,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10789
10830
  locationId: string(),
10790
10831
  enabled: boolean(),
10791
10832
  retentionCount: number().int().min(1).max(1e3),
10792
- label: string().optional(),
10793
- /**
10794
- * Per-destination cron expression. Empty string clears the
10795
- * schedule (manual-only). Validated server-side via croner;
10796
- * malformed expressions reject the upsert with an actionable
10797
- * message.
10798
- */
10799
- cron: string().optional()
10833
+ label: string().optional()
10800
10834
  }), _void(), {
10801
10835
  kind: "mutation",
10802
10836
  auth: "admin"
package/dist/index.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
@@ -10567,12 +10582,30 @@ var BackupDestinationInfoSchema = object({
10567
10582
  lastSuccessAt: number().optional(),
10568
10583
  /** Newest-archive size from `manifests.json`, or undefined. */
10569
10584
  lastSuccessSizeBytes: number().optional(),
10570
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10585
+ /**
10586
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10587
+ * destination, comma-joined. Absent when no enabled schedule targets it
10588
+ * — a destination nothing is scheduled to write to must not advertise a
10589
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10590
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10591
+ * and reading it made a destination with a DISABLED schedule claim a
10592
+ * nightly run.
10593
+ */
10571
10594
  cron: string().optional(),
10572
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10595
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10573
10596
  nextRunAt: number().optional(),
10574
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10575
- lastRunAt: number().optional()
10597
+ /**
10598
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10599
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10600
+ * newest archive that actually landed) and `lastError`.
10601
+ */
10602
+ lastAttemptAt: number().optional(),
10603
+ /**
10604
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10605
+ * landed the archive. A destination that has never been written to has
10606
+ * neither this nor `lastAttemptAt`.
10607
+ */
10608
+ lastError: string().optional()
10576
10609
  });
10577
10610
  /**
10578
10611
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10735,8 +10768,16 @@ var BackupScheduleSchema = object({
10735
10768
  retentionCount: number().int().min(1).max(1e3),
10736
10769
  /** Optional subset of source locations to include; omitted = all. */
10737
10770
  dataSources: array(string()).readonly().optional(),
10738
- /** ms-epoch of last successful run. */
10739
- lastRunAt: number().optional(),
10771
+ /**
10772
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10773
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10774
+ * "succeeded" — a run refused by every destination stamps it too.
10775
+ */
10776
+ lastAttemptAt: number().optional(),
10777
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10778
+ lastSuccessAt: number().optional(),
10779
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10780
+ lastError: string().optional(),
10740
10781
  /** ms-epoch of next computed firing (read-only, filled on list). */
10741
10782
  nextRunAt: number().optional()
10742
10783
  });
@@ -10785,14 +10826,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10785
10826
  locationId: string(),
10786
10827
  enabled: boolean(),
10787
10828
  retentionCount: number().int().min(1).max(1e3),
10788
- label: string().optional(),
10789
- /**
10790
- * Per-destination cron expression. Empty string clears the
10791
- * schedule (manual-only). Validated server-side via croner;
10792
- * malformed expressions reject the upsert with an actionable
10793
- * message.
10794
- */
10795
- cron: string().optional()
10829
+ label: string().optional()
10796
10830
  }), _void(), {
10797
10831
  kind: "mutation",
10798
10832
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-decoder-nodeav",
3
- "version": "1.2.76",
3
+ "version": "1.2.78",
4
4
  "description": "Standalone in-process node-av decoder addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",