@camstack/addon-provider-gree 0.2.75 → 0.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.
package/dist/addon.js CHANGED
@@ -7954,13 +7954,28 @@ var RecordingBandSchema = object({
7954
7954
  end: string().regex(HHMM),
7955
7955
  mode: RecordingBandModeSchema,
7956
7956
  triggers: RecordingBandTriggersSchema.optional(),
7957
+ /**
7958
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7959
+ *
7960
+ * It was the retroactive KEEP bound — which already-written segments survive
7961
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7962
+ * broker could serve, or the gate would delete the seconds the ring had just
7963
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7964
+ * expression of the broker's retention, in different units, in a different
7965
+ * addon, with an invariant the operator had to maintain by hand. The keep
7966
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7967
+ * left to configure here.
7968
+ *
7969
+ * The key survives in the SHAPE so a config written before that record still
7970
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7971
+ * strict, so simply deleting it would strip an operator's value in silence on
7972
+ * the next save (the failure D380 came one commit from shipping). Nothing
7973
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7974
+ */
7957
7975
  preBufferSec: number().min(0).optional(),
7958
7976
  postBufferSec: number().min(0).optional()
7959
7977
  });
7960
- ({
7961
- preBufferSec: 15,
7962
- postBufferSec: 30
7963
- }).postBufferSec * 1e3;
7978
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7964
7979
  /**
7965
7980
  * Per-device retention overrides. Every field is optional; an unset or `0`
7966
7981
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10537,12 +10552,30 @@ var BackupDestinationInfoSchema = object({
10537
10552
  lastSuccessAt: number().optional(),
10538
10553
  /** Newest-archive size from `manifests.json`, or undefined. */
10539
10554
  lastSuccessSizeBytes: number().optional(),
10540
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10555
+ /**
10556
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10557
+ * destination, comma-joined. Absent when no enabled schedule targets it
10558
+ * — a destination nothing is scheduled to write to must not advertise a
10559
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10560
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10561
+ * and reading it made a destination with a DISABLED schedule claim a
10562
+ * nightly run.
10563
+ */
10541
10564
  cron: string().optional(),
10542
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10565
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10543
10566
  nextRunAt: number().optional(),
10544
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10545
- lastRunAt: number().optional()
10567
+ /**
10568
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10569
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10570
+ * newest archive that actually landed) and `lastError`.
10571
+ */
10572
+ lastAttemptAt: number().optional(),
10573
+ /**
10574
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10575
+ * landed the archive. A destination that has never been written to has
10576
+ * neither this nor `lastAttemptAt`.
10577
+ */
10578
+ lastError: string().optional()
10546
10579
  });
10547
10580
  /**
10548
10581
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10705,8 +10738,16 @@ var BackupScheduleSchema = object({
10705
10738
  retentionCount: number().int().min(1).max(1e3),
10706
10739
  /** Optional subset of source locations to include; omitted = all. */
10707
10740
  dataSources: array(string()).readonly().optional(),
10708
- /** ms-epoch of last successful run. */
10709
- lastRunAt: number().optional(),
10741
+ /**
10742
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10743
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10744
+ * "succeeded" — a run refused by every destination stamps it too.
10745
+ */
10746
+ lastAttemptAt: number().optional(),
10747
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10748
+ lastSuccessAt: number().optional(),
10749
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10750
+ lastError: string().optional(),
10710
10751
  /** ms-epoch of next computed firing (read-only, filled on list). */
10711
10752
  nextRunAt: number().optional()
10712
10753
  });
@@ -10755,14 +10796,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10755
10796
  locationId: string(),
10756
10797
  enabled: boolean(),
10757
10798
  retentionCount: number().int().min(1).max(1e3),
10758
- label: string().optional(),
10759
- /**
10760
- * Per-destination cron expression. Empty string clears the
10761
- * schedule (manual-only). Validated server-side via croner;
10762
- * malformed expressions reject the upsert with an actionable
10763
- * message.
10764
- */
10765
- cron: string().optional()
10799
+ label: string().optional()
10766
10800
  }), _void(), {
10767
10801
  kind: "mutation",
10768
10802
  auth: "admin"
package/dist/addon.mjs CHANGED
@@ -7953,13 +7953,28 @@ var RecordingBandSchema = object({
7953
7953
  end: string().regex(HHMM),
7954
7954
  mode: RecordingBandModeSchema,
7955
7955
  triggers: RecordingBandTriggersSchema.optional(),
7956
+ /**
7957
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
7958
+ *
7959
+ * It was the retroactive KEEP bound — which already-written segments survive
7960
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
7961
+ * broker could serve, or the gate would delete the seconds the ring had just
7962
+ * handed the writer. That "at least as wide as" is the tell: it was a second
7963
+ * expression of the broker's retention, in different units, in a different
7964
+ * addon, with an invariant the operator had to maintain by hand. The keep
7965
+ * bound is now derived from the one prebuffer ceiling and there is nothing
7966
+ * left to configure here.
7967
+ *
7968
+ * The key survives in the SHAPE so a config written before that record still
7969
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
7970
+ * strict, so simply deleting it would strip an operator's value in silence on
7971
+ * the next save (the failure D380 came one commit from shipping). Nothing
7972
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
7973
+ */
7956
7974
  preBufferSec: number().min(0).optional(),
7957
7975
  postBufferSec: number().min(0).optional()
7958
7976
  });
7959
- ({
7960
- preBufferSec: 15,
7961
- postBufferSec: 30
7962
- }).postBufferSec * 1e3;
7977
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
7963
7978
  /**
7964
7979
  * Per-device retention overrides. Every field is optional; an unset or `0`
7965
7980
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10536,12 +10551,30 @@ var BackupDestinationInfoSchema = object({
10536
10551
  lastSuccessAt: number().optional(),
10537
10552
  /** Newest-archive size from `manifests.json`, or undefined. */
10538
10553
  lastSuccessSizeBytes: number().optional(),
10539
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10554
+ /**
10555
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10556
+ * destination, comma-joined. Absent when no enabled schedule targets it
10557
+ * — a destination nothing is scheduled to write to must not advertise a
10558
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10559
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10560
+ * and reading it made a destination with a DISABLED schedule claim a
10561
+ * nightly run.
10562
+ */
10540
10563
  cron: string().optional(),
10541
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10564
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10542
10565
  nextRunAt: number().optional(),
10543
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10544
- lastRunAt: number().optional()
10566
+ /**
10567
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10568
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10569
+ * newest archive that actually landed) and `lastError`.
10570
+ */
10571
+ lastAttemptAt: number().optional(),
10572
+ /**
10573
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10574
+ * landed the archive. A destination that has never been written to has
10575
+ * neither this nor `lastAttemptAt`.
10576
+ */
10577
+ lastError: string().optional()
10545
10578
  });
10546
10579
  /**
10547
10580
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10704,8 +10737,16 @@ var BackupScheduleSchema = object({
10704
10737
  retentionCount: number().int().min(1).max(1e3),
10705
10738
  /** Optional subset of source locations to include; omitted = all. */
10706
10739
  dataSources: array(string()).readonly().optional(),
10707
- /** ms-epoch of last successful run. */
10708
- lastRunAt: number().optional(),
10740
+ /**
10741
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10742
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10743
+ * "succeeded" — a run refused by every destination stamps it too.
10744
+ */
10745
+ lastAttemptAt: number().optional(),
10746
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10747
+ lastSuccessAt: number().optional(),
10748
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10749
+ lastError: string().optional(),
10709
10750
  /** ms-epoch of next computed firing (read-only, filled on list). */
10710
10751
  nextRunAt: number().optional()
10711
10752
  });
@@ -10754,14 +10795,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10754
10795
  locationId: string(),
10755
10796
  enabled: boolean(),
10756
10797
  retentionCount: number().int().min(1).max(1e3),
10757
- label: string().optional(),
10758
- /**
10759
- * Per-destination cron expression. Empty string clears the
10760
- * schedule (manual-only). Validated server-side via croner;
10761
- * malformed expressions reject the upsert with an actionable
10762
- * message.
10763
- */
10764
- cron: string().optional()
10798
+ label: string().optional()
10765
10799
  }), _void(), {
10766
10800
  kind: "mutation",
10767
10801
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-gree",
3
- "version": "0.2.75",
3
+ "version": "0.2.77",
4
4
  "description": "Gree air-conditioner device-provider addon for CamStack — wraps the @apocaliss92/nodegree local-UDP client (LAN discovery + AES control), exposing climate-control and fan-control",
5
5
  "keywords": [
6
6
  "camstack",