@camstack/addon-export-alexa 1.2.82 → 1.2.84

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.
@@ -8119,13 +8119,28 @@ var RecordingBandSchema = object({
8119
8119
  end: string().regex(HHMM),
8120
8120
  mode: RecordingBandModeSchema,
8121
8121
  triggers: RecordingBandTriggersSchema.optional(),
8122
+ /**
8123
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8124
+ *
8125
+ * It was the retroactive KEEP bound — which already-written segments survive
8126
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8127
+ * broker could serve, or the gate would delete the seconds the ring had just
8128
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8129
+ * expression of the broker's retention, in different units, in a different
8130
+ * addon, with an invariant the operator had to maintain by hand. The keep
8131
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8132
+ * left to configure here.
8133
+ *
8134
+ * The key survives in the SHAPE so a config written before that record still
8135
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8136
+ * strict, so simply deleting it would strip an operator's value in silence on
8137
+ * the next save (the failure D380 came one commit from shipping). Nothing
8138
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8139
+ */
8122
8140
  preBufferSec: number().min(0).optional(),
8123
8141
  postBufferSec: number().min(0).optional()
8124
8142
  });
8125
- ({
8126
- preBufferSec: 15,
8127
- postBufferSec: 30
8128
- }).postBufferSec * 1e3;
8143
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8129
8144
  /**
8130
8145
  * Per-device retention overrides. Every field is optional; an unset or `0`
8131
8146
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10782,12 +10797,30 @@ var BackupDestinationInfoSchema = object({
10782
10797
  lastSuccessAt: number().optional(),
10783
10798
  /** Newest-archive size from `manifests.json`, or undefined. */
10784
10799
  lastSuccessSizeBytes: number().optional(),
10785
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10800
+ /**
10801
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10802
+ * destination, comma-joined. Absent when no enabled schedule targets it
10803
+ * — a destination nothing is scheduled to write to must not advertise a
10804
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10805
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10806
+ * and reading it made a destination with a DISABLED schedule claim a
10807
+ * nightly run.
10808
+ */
10786
10809
  cron: string().optional(),
10787
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10810
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10788
10811
  nextRunAt: number().optional(),
10789
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10790
- lastRunAt: number().optional()
10812
+ /**
10813
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10814
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10815
+ * newest archive that actually landed) and `lastError`.
10816
+ */
10817
+ lastAttemptAt: number().optional(),
10818
+ /**
10819
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10820
+ * landed the archive. A destination that has never been written to has
10821
+ * neither this nor `lastAttemptAt`.
10822
+ */
10823
+ lastError: string().optional()
10791
10824
  });
10792
10825
  /**
10793
10826
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10950,8 +10983,16 @@ var BackupScheduleSchema = object({
10950
10983
  retentionCount: number().int().min(1).max(1e3),
10951
10984
  /** Optional subset of source locations to include; omitted = all. */
10952
10985
  dataSources: array(string()).readonly().optional(),
10953
- /** ms-epoch of last successful run. */
10954
- lastRunAt: number().optional(),
10986
+ /**
10987
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10988
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10989
+ * "succeeded" — a run refused by every destination stamps it too.
10990
+ */
10991
+ lastAttemptAt: number().optional(),
10992
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10993
+ lastSuccessAt: number().optional(),
10994
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10995
+ lastError: string().optional(),
10955
10996
  /** ms-epoch of next computed firing (read-only, filled on list). */
10956
10997
  nextRunAt: number().optional()
10957
10998
  });
@@ -11000,14 +11041,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11000
11041
  locationId: string(),
11001
11042
  enabled: boolean(),
11002
11043
  retentionCount: number().int().min(1).max(1e3),
11003
- label: string().optional(),
11004
- /**
11005
- * Per-destination cron expression. Empty string clears the
11006
- * schedule (manual-only). Validated server-side via croner;
11007
- * malformed expressions reject the upsert with an actionable
11008
- * message.
11009
- */
11010
- cron: string().optional()
11044
+ label: string().optional()
11011
11045
  }), _void(), {
11012
11046
  kind: "mutation",
11013
11047
  auth: "admin"
@@ -8092,13 +8092,28 @@ var RecordingBandSchema = object({
8092
8092
  end: string().regex(HHMM),
8093
8093
  mode: RecordingBandModeSchema,
8094
8094
  triggers: RecordingBandTriggersSchema.optional(),
8095
+ /**
8096
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8097
+ *
8098
+ * It was the retroactive KEEP bound — which already-written segments survive
8099
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8100
+ * broker could serve, or the gate would delete the seconds the ring had just
8101
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8102
+ * expression of the broker's retention, in different units, in a different
8103
+ * addon, with an invariant the operator had to maintain by hand. The keep
8104
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8105
+ * left to configure here.
8106
+ *
8107
+ * The key survives in the SHAPE so a config written before that record still
8108
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8109
+ * strict, so simply deleting it would strip an operator's value in silence on
8110
+ * the next save (the failure D380 came one commit from shipping). Nothing
8111
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8112
+ */
8095
8113
  preBufferSec: number().min(0).optional(),
8096
8114
  postBufferSec: number().min(0).optional()
8097
8115
  });
8098
- ({
8099
- preBufferSec: 15,
8100
- postBufferSec: 30
8101
- }).postBufferSec * 1e3;
8116
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8102
8117
  /**
8103
8118
  * Per-device retention overrides. Every field is optional; an unset or `0`
8104
8119
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10755,12 +10770,30 @@ var BackupDestinationInfoSchema = object({
10755
10770
  lastSuccessAt: number().optional(),
10756
10771
  /** Newest-archive size from `manifests.json`, or undefined. */
10757
10772
  lastSuccessSizeBytes: number().optional(),
10758
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10773
+ /**
10774
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10775
+ * destination, comma-joined. Absent when no enabled schedule targets it
10776
+ * — a destination nothing is scheduled to write to must not advertise a
10777
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10778
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10779
+ * and reading it made a destination with a DISABLED schedule claim a
10780
+ * nightly run.
10781
+ */
10759
10782
  cron: string().optional(),
10760
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10783
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10761
10784
  nextRunAt: number().optional(),
10762
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10763
- lastRunAt: number().optional()
10785
+ /**
10786
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10787
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10788
+ * newest archive that actually landed) and `lastError`.
10789
+ */
10790
+ lastAttemptAt: number().optional(),
10791
+ /**
10792
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10793
+ * landed the archive. A destination that has never been written to has
10794
+ * neither this nor `lastAttemptAt`.
10795
+ */
10796
+ lastError: string().optional()
10764
10797
  });
10765
10798
  /**
10766
10799
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10923,8 +10956,16 @@ var BackupScheduleSchema = object({
10923
10956
  retentionCount: number().int().min(1).max(1e3),
10924
10957
  /** Optional subset of source locations to include; omitted = all. */
10925
10958
  dataSources: array(string()).readonly().optional(),
10926
- /** ms-epoch of last successful run. */
10927
- lastRunAt: number().optional(),
10959
+ /**
10960
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10961
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10962
+ * "succeeded" — a run refused by every destination stamps it too.
10963
+ */
10964
+ lastAttemptAt: number().optional(),
10965
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10966
+ lastSuccessAt: number().optional(),
10967
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10968
+ lastError: string().optional(),
10928
10969
  /** ms-epoch of next computed firing (read-only, filled on list). */
10929
10970
  nextRunAt: number().optional()
10930
10971
  });
@@ -10973,14 +11014,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10973
11014
  locationId: string(),
10974
11015
  enabled: boolean(),
10975
11016
  retentionCount: number().int().min(1).max(1e3),
10976
- label: string().optional(),
10977
- /**
10978
- * Per-destination cron expression. Empty string clears the
10979
- * schedule (manual-only). Validated server-side via croner;
10980
- * malformed expressions reject the upsert with an actionable
10981
- * message.
10982
- */
10983
- cron: string().optional()
11017
+ label: string().optional()
10984
11018
  }), _void(), {
10985
11019
  kind: "mutation",
10986
11020
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-alexa",
3
- "version": "1.2.82",
3
+ "version": "1.2.84",
4
4
  "description": "Alexa Smart Home Skill export — hub-side OAuth provider + directive handler. The companion AWS Lambda forwards Alexa directives to this addon's /addon/export-alexa/directive endpoint.",
5
5
  "keywords": [
6
6
  "camstack",