@camstack/addon-smtp-nodemailer 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.
@@ -7972,13 +7972,28 @@ var RecordingBandSchema = object({
7972
7972
  end: string().regex(HHMM),
7973
7973
  mode: RecordingBandModeSchema,
7974
7974
  triggers: RecordingBandTriggersSchema.optional(),
7975
+ /**
7976
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7977
+ *
7978
+ * It was the retroactive KEEP bound — which already-written segments survive
7979
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7980
+ * broker could serve, or the gate would delete the seconds the ring had just
7981
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7982
+ * expression of the broker's retention, in different units, in a different
7983
+ * addon, with an invariant the operator had to maintain by hand. The keep
7984
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7985
+ * left to configure here.
7986
+ *
7987
+ * The key survives in the SHAPE so a config written before that record still
7988
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7989
+ * strict, so simply deleting it would strip an operator's value in silence on
7990
+ * the next save (the failure D380 came one commit from shipping). Nothing
7991
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7992
+ */
7975
7993
  preBufferSec: number().min(0).optional(),
7976
7994
  postBufferSec: number().min(0).optional()
7977
7995
  });
7978
- ({
7979
- preBufferSec: 15,
7980
- postBufferSec: 30
7981
- }).postBufferSec * 1e3;
7996
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7982
7997
  /**
7983
7998
  * Per-device retention overrides. Every field is optional; an unset or `0`
7984
7999
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10555,12 +10570,30 @@ var BackupDestinationInfoSchema = object({
10555
10570
  lastSuccessAt: number().optional(),
10556
10571
  /** Newest-archive size from `manifests.json`, or undefined. */
10557
10572
  lastSuccessSizeBytes: number().optional(),
10558
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10573
+ /**
10574
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10575
+ * destination, comma-joined. Absent when no enabled schedule targets it
10576
+ * — a destination nothing is scheduled to write to must not advertise a
10577
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10578
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10579
+ * and reading it made a destination with a DISABLED schedule claim a
10580
+ * nightly run.
10581
+ */
10559
10582
  cron: string().optional(),
10560
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10583
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10561
10584
  nextRunAt: number().optional(),
10562
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10563
- lastRunAt: number().optional()
10585
+ /**
10586
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10587
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10588
+ * newest archive that actually landed) and `lastError`.
10589
+ */
10590
+ lastAttemptAt: number().optional(),
10591
+ /**
10592
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10593
+ * landed the archive. A destination that has never been written to has
10594
+ * neither this nor `lastAttemptAt`.
10595
+ */
10596
+ lastError: string().optional()
10564
10597
  });
10565
10598
  /**
10566
10599
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10723,8 +10756,16 @@ var BackupScheduleSchema = object({
10723
10756
  retentionCount: number().int().min(1).max(1e3),
10724
10757
  /** Optional subset of source locations to include; omitted = all. */
10725
10758
  dataSources: array(string()).readonly().optional(),
10726
- /** ms-epoch of last successful run. */
10727
- lastRunAt: number().optional(),
10759
+ /**
10760
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10761
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10762
+ * "succeeded" — a run refused by every destination stamps it too.
10763
+ */
10764
+ lastAttemptAt: number().optional(),
10765
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10766
+ lastSuccessAt: number().optional(),
10767
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10768
+ lastError: string().optional(),
10728
10769
  /** ms-epoch of next computed firing (read-only, filled on list). */
10729
10770
  nextRunAt: number().optional()
10730
10771
  });
@@ -10773,14 +10814,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10773
10814
  locationId: string(),
10774
10815
  enabled: boolean(),
10775
10816
  retentionCount: number().int().min(1).max(1e3),
10776
- label: string().optional(),
10777
- /**
10778
- * Per-destination cron expression. Empty string clears the
10779
- * schedule (manual-only). Validated server-side via croner;
10780
- * malformed expressions reject the upsert with an actionable
10781
- * message.
10782
- */
10783
- cron: string().optional()
10817
+ label: string().optional()
10784
10818
  }), _void(), {
10785
10819
  kind: "mutation",
10786
10820
  auth: "admin"
@@ -7970,13 +7970,28 @@ var RecordingBandSchema = object({
7970
7970
  end: string().regex(HHMM),
7971
7971
  mode: RecordingBandModeSchema,
7972
7972
  triggers: RecordingBandTriggersSchema.optional(),
7973
+ /**
7974
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7975
+ *
7976
+ * It was the retroactive KEEP bound — which already-written segments survive
7977
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7978
+ * broker could serve, or the gate would delete the seconds the ring had just
7979
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7980
+ * expression of the broker's retention, in different units, in a different
7981
+ * addon, with an invariant the operator had to maintain by hand. The keep
7982
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7983
+ * left to configure here.
7984
+ *
7985
+ * The key survives in the SHAPE so a config written before that record still
7986
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7987
+ * strict, so simply deleting it would strip an operator's value in silence on
7988
+ * the next save (the failure D380 came one commit from shipping). Nothing
7989
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7990
+ */
7973
7991
  preBufferSec: number().min(0).optional(),
7974
7992
  postBufferSec: number().min(0).optional()
7975
7993
  });
7976
- ({
7977
- preBufferSec: 15,
7978
- postBufferSec: 30
7979
- }).postBufferSec * 1e3;
7994
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7980
7995
  /**
7981
7996
  * Per-device retention overrides. Every field is optional; an unset or `0`
7982
7997
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10553,12 +10568,30 @@ var BackupDestinationInfoSchema = object({
10553
10568
  lastSuccessAt: number().optional(),
10554
10569
  /** Newest-archive size from `manifests.json`, or undefined. */
10555
10570
  lastSuccessSizeBytes: number().optional(),
10556
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10571
+ /**
10572
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10573
+ * destination, comma-joined. Absent when no enabled schedule targets it
10574
+ * — a destination nothing is scheduled to write to must not advertise a
10575
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10576
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10577
+ * and reading it made a destination with a DISABLED schedule claim a
10578
+ * nightly run.
10579
+ */
10557
10580
  cron: string().optional(),
10558
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10581
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10559
10582
  nextRunAt: number().optional(),
10560
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10561
- lastRunAt: number().optional()
10583
+ /**
10584
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10585
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10586
+ * newest archive that actually landed) and `lastError`.
10587
+ */
10588
+ lastAttemptAt: number().optional(),
10589
+ /**
10590
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10591
+ * landed the archive. A destination that has never been written to has
10592
+ * neither this nor `lastAttemptAt`.
10593
+ */
10594
+ lastError: string().optional()
10562
10595
  });
10563
10596
  /**
10564
10597
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10721,8 +10754,16 @@ var BackupScheduleSchema = object({
10721
10754
  retentionCount: number().int().min(1).max(1e3),
10722
10755
  /** Optional subset of source locations to include; omitted = all. */
10723
10756
  dataSources: array(string()).readonly().optional(),
10724
- /** ms-epoch of last successful run. */
10725
- lastRunAt: number().optional(),
10757
+ /**
10758
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10759
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10760
+ * "succeeded" — a run refused by every destination stamps it too.
10761
+ */
10762
+ lastAttemptAt: number().optional(),
10763
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10764
+ lastSuccessAt: number().optional(),
10765
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10766
+ lastError: string().optional(),
10726
10767
  /** ms-epoch of next computed firing (read-only, filled on list). */
10727
10768
  nextRunAt: number().optional()
10728
10769
  });
@@ -10771,14 +10812,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10771
10812
  locationId: string(),
10772
10813
  enabled: boolean(),
10773
10814
  retentionCount: number().int().min(1).max(1e3),
10774
- label: string().optional(),
10775
- /**
10776
- * Per-destination cron expression. Empty string clears the
10777
- * schedule (manual-only). Validated server-side via croner;
10778
- * malformed expressions reject the upsert with an actionable
10779
- * message.
10780
- */
10781
- cron: string().optional()
10815
+ label: string().optional()
10782
10816
  }), _void(), {
10783
10817
  kind: "mutation",
10784
10818
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-smtp-nodemailer",
3
- "version": "1.2.75",
3
+ "version": "1.2.77",
4
4
  "description": "SMTP email provider addon for CamStack — wraps `nodemailer` and registers a `smtp-provider` cap collection entry. Used by magic-link login + notifier addons.",
5
5
  "keywords": [
6
6
  "camstack",