@camstack/addon-export-google 0.1.40 → 0.1.42

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.
@@ -8144,13 +8144,28 @@ var RecordingBandSchema = object({
8144
8144
  end: string().regex(HHMM),
8145
8145
  mode: RecordingBandModeSchema,
8146
8146
  triggers: RecordingBandTriggersSchema.optional(),
8147
+ /**
8148
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8149
+ *
8150
+ * It was the retroactive KEEP bound — which already-written segments survive
8151
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8152
+ * broker could serve, or the gate would delete the seconds the ring had just
8153
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8154
+ * expression of the broker's retention, in different units, in a different
8155
+ * addon, with an invariant the operator had to maintain by hand. The keep
8156
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8157
+ * left to configure here.
8158
+ *
8159
+ * The key survives in the SHAPE so a config written before that record still
8160
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8161
+ * strict, so simply deleting it would strip an operator's value in silence on
8162
+ * the next save (the failure D380 came one commit from shipping). Nothing
8163
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8164
+ */
8147
8165
  preBufferSec: number().min(0).optional(),
8148
8166
  postBufferSec: number().min(0).optional()
8149
8167
  });
8150
- ({
8151
- preBufferSec: 15,
8152
- postBufferSec: 30
8153
- }).postBufferSec * 1e3;
8168
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8154
8169
  /**
8155
8170
  * Per-device retention overrides. Every field is optional; an unset or `0`
8156
8171
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10753,12 +10768,30 @@ var BackupDestinationInfoSchema = object({
10753
10768
  lastSuccessAt: number().optional(),
10754
10769
  /** Newest-archive size from `manifests.json`, or undefined. */
10755
10770
  lastSuccessSizeBytes: number().optional(),
10756
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10771
+ /**
10772
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10773
+ * destination, comma-joined. Absent when no enabled schedule targets it
10774
+ * — a destination nothing is scheduled to write to must not advertise a
10775
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10776
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10777
+ * and reading it made a destination with a DISABLED schedule claim a
10778
+ * nightly run.
10779
+ */
10757
10780
  cron: string().optional(),
10758
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10781
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10759
10782
  nextRunAt: number().optional(),
10760
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10761
- lastRunAt: number().optional()
10783
+ /**
10784
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10785
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10786
+ * newest archive that actually landed) and `lastError`.
10787
+ */
10788
+ lastAttemptAt: number().optional(),
10789
+ /**
10790
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10791
+ * landed the archive. A destination that has never been written to has
10792
+ * neither this nor `lastAttemptAt`.
10793
+ */
10794
+ lastError: string().optional()
10762
10795
  });
10763
10796
  /**
10764
10797
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10921,8 +10954,16 @@ var BackupScheduleSchema = object({
10921
10954
  retentionCount: number().int().min(1).max(1e3),
10922
10955
  /** Optional subset of source locations to include; omitted = all. */
10923
10956
  dataSources: array(string()).readonly().optional(),
10924
- /** ms-epoch of last successful run. */
10925
- lastRunAt: number().optional(),
10957
+ /**
10958
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10959
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10960
+ * "succeeded" — a run refused by every destination stamps it too.
10961
+ */
10962
+ lastAttemptAt: number().optional(),
10963
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10964
+ lastSuccessAt: number().optional(),
10965
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10966
+ lastError: string().optional(),
10926
10967
  /** ms-epoch of next computed firing (read-only, filled on list). */
10927
10968
  nextRunAt: number().optional()
10928
10969
  });
@@ -10971,14 +11012,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10971
11012
  locationId: string(),
10972
11013
  enabled: boolean(),
10973
11014
  retentionCount: number().int().min(1).max(1e3),
10974
- label: string().optional(),
10975
- /**
10976
- * Per-destination cron expression. Empty string clears the
10977
- * schedule (manual-only). Validated server-side via croner;
10978
- * malformed expressions reject the upsert with an actionable
10979
- * message.
10980
- */
10981
- cron: string().optional()
11015
+ label: string().optional()
10982
11016
  }), _void(), {
10983
11017
  kind: "mutation",
10984
11018
  auth: "admin"
@@ -8140,13 +8140,28 @@ var RecordingBandSchema = object({
8140
8140
  end: string().regex(HHMM),
8141
8141
  mode: RecordingBandModeSchema,
8142
8142
  triggers: RecordingBandTriggersSchema.optional(),
8143
+ /**
8144
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8145
+ *
8146
+ * It was the retroactive KEEP bound — which already-written segments survive
8147
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8148
+ * broker could serve, or the gate would delete the seconds the ring had just
8149
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8150
+ * expression of the broker's retention, in different units, in a different
8151
+ * addon, with an invariant the operator had to maintain by hand. The keep
8152
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8153
+ * left to configure here.
8154
+ *
8155
+ * The key survives in the SHAPE so a config written before that record still
8156
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8157
+ * strict, so simply deleting it would strip an operator's value in silence on
8158
+ * the next save (the failure D380 came one commit from shipping). Nothing
8159
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8160
+ */
8143
8161
  preBufferSec: number().min(0).optional(),
8144
8162
  postBufferSec: number().min(0).optional()
8145
8163
  });
8146
- ({
8147
- preBufferSec: 15,
8148
- postBufferSec: 30
8149
- }).postBufferSec * 1e3;
8164
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8150
8165
  /**
8151
8166
  * Per-device retention overrides. Every field is optional; an unset or `0`
8152
8167
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -10749,12 +10764,30 @@ var BackupDestinationInfoSchema = object({
10749
10764
  lastSuccessAt: number().optional(),
10750
10765
  /** Newest-archive size from `manifests.json`, or undefined. */
10751
10766
  lastSuccessSizeBytes: number().optional(),
10752
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10767
+ /**
10768
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10769
+ * destination, comma-joined. Absent when no enabled schedule targets it
10770
+ * — a destination nothing is scheduled to write to must not advertise a
10771
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10772
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10773
+ * and reading it made a destination with a DISABLED schedule claim a
10774
+ * nightly run.
10775
+ */
10753
10776
  cron: string().optional(),
10754
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10777
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10755
10778
  nextRunAt: number().optional(),
10756
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10757
- lastRunAt: number().optional()
10779
+ /**
10780
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10781
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10782
+ * newest archive that actually landed) and `lastError`.
10783
+ */
10784
+ lastAttemptAt: number().optional(),
10785
+ /**
10786
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10787
+ * landed the archive. A destination that has never been written to has
10788
+ * neither this nor `lastAttemptAt`.
10789
+ */
10790
+ lastError: string().optional()
10758
10791
  });
10759
10792
  /**
10760
10793
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10917,8 +10950,16 @@ var BackupScheduleSchema = object({
10917
10950
  retentionCount: number().int().min(1).max(1e3),
10918
10951
  /** Optional subset of source locations to include; omitted = all. */
10919
10952
  dataSources: array(string()).readonly().optional(),
10920
- /** ms-epoch of last successful run. */
10921
- lastRunAt: number().optional(),
10953
+ /**
10954
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10955
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10956
+ * "succeeded" — a run refused by every destination stamps it too.
10957
+ */
10958
+ lastAttemptAt: number().optional(),
10959
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10960
+ lastSuccessAt: number().optional(),
10961
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10962
+ lastError: string().optional(),
10922
10963
  /** ms-epoch of next computed firing (read-only, filled on list). */
10923
10964
  nextRunAt: number().optional()
10924
10965
  });
@@ -10967,14 +11008,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10967
11008
  locationId: string(),
10968
11009
  enabled: boolean(),
10969
11010
  retentionCount: number().int().min(1).max(1e3),
10970
- label: string().optional(),
10971
- /**
10972
- * Per-destination cron expression. Empty string clears the
10973
- * schedule (manual-only). Validated server-side via croner;
10974
- * malformed expressions reject the upsert with an actionable
10975
- * message.
10976
- */
10977
- cron: string().optional()
11011
+ label: string().optional()
10978
11012
  }), _void(), {
10979
11013
  kind: "mutation",
10980
11014
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-google",
3
- "version": "0.1.40",
3
+ "version": "0.1.42",
4
4
  "description": "Google Home export — hub-side smart-home fulfillment (SYNC / QUERY / EXECUTE / DISCONNECT) for the non-camera fleet, served over the hub's own OAuth account link. No Google credential is stored, sent or required.",
5
5
  "keywords": [
6
6
  "camstack",