@camstack/addon-export-hap 1.2.87 → 1.2.89

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.
@@ -8617,13 +8617,28 @@ var RecordingBandSchema = object({
8617
8617
  end: string().regex(HHMM),
8618
8618
  mode: RecordingBandModeSchema,
8619
8619
  triggers: RecordingBandTriggersSchema.optional(),
8620
+ /**
8621
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8622
+ *
8623
+ * It was the retroactive KEEP bound — which already-written segments survive
8624
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8625
+ * broker could serve, or the gate would delete the seconds the ring had just
8626
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8627
+ * expression of the broker's retention, in different units, in a different
8628
+ * addon, with an invariant the operator had to maintain by hand. The keep
8629
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8630
+ * left to configure here.
8631
+ *
8632
+ * The key survives in the SHAPE so a config written before that record still
8633
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8634
+ * strict, so simply deleting it would strip an operator's value in silence on
8635
+ * the next save (the failure D380 came one commit from shipping). Nothing
8636
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8637
+ */
8620
8638
  preBufferSec: number().min(0).optional(),
8621
8639
  postBufferSec: number().min(0).optional()
8622
8640
  });
8623
- ({
8624
- preBufferSec: 15,
8625
- postBufferSec: 30
8626
- }).postBufferSec * 1e3;
8641
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8627
8642
  /**
8628
8643
  * Per-device retention overrides. Every field is optional; an unset or `0`
8629
8644
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -11254,12 +11269,30 @@ var BackupDestinationInfoSchema = object({
11254
11269
  lastSuccessAt: number().optional(),
11255
11270
  /** Newest-archive size from `manifests.json`, or undefined. */
11256
11271
  lastSuccessSizeBytes: number().optional(),
11257
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
11272
+ /**
11273
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
11274
+ * destination, comma-joined. Absent when no enabled schedule targets it
11275
+ * — a destination nothing is scheduled to write to must not advertise a
11276
+ * cadence (D384). This is never the `backup_destination_policies.cron`
11277
+ * column: that per-location cron has scheduled nothing since 2026-07-28
11278
+ * and reading it made a destination with a DISABLED schedule claim a
11279
+ * nightly run.
11280
+ */
11258
11281
  cron: string().optional(),
11259
- /** ms-epoch of next computed firing for this destination's cron, if any. */
11282
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
11260
11283
  nextRunAt: number().optional(),
11261
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
11262
- lastRunAt: number().optional()
11284
+ /**
11285
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
11286
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
11287
+ * newest archive that actually landed) and `lastError`.
11288
+ */
11289
+ lastAttemptAt: number().optional(),
11290
+ /**
11291
+ * Why the last attempt failed, verbatim. Absent when the last attempt
11292
+ * landed the archive. A destination that has never been written to has
11293
+ * neither this nor `lastAttemptAt`.
11294
+ */
11295
+ lastError: string().optional()
11263
11296
  });
11264
11297
  /**
11265
11298
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -11422,8 +11455,16 @@ var BackupScheduleSchema = object({
11422
11455
  retentionCount: number().int().min(1).max(1e3),
11423
11456
  /** Optional subset of source locations to include; omitted = all. */
11424
11457
  dataSources: array(string()).readonly().optional(),
11425
- /** ms-epoch of last successful run. */
11426
- lastRunAt: number().optional(),
11458
+ /**
11459
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11460
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11461
+ * "succeeded" — a run refused by every destination stamps it too.
11462
+ */
11463
+ lastAttemptAt: number().optional(),
11464
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11465
+ lastSuccessAt: number().optional(),
11466
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11467
+ lastError: string().optional(),
11427
11468
  /** ms-epoch of next computed firing (read-only, filled on list). */
11428
11469
  nextRunAt: number().optional()
11429
11470
  });
@@ -11472,14 +11513,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11472
11513
  locationId: string(),
11473
11514
  enabled: boolean(),
11474
11515
  retentionCount: number().int().min(1).max(1e3),
11475
- label: string().optional(),
11476
- /**
11477
- * Per-destination cron expression. Empty string clears the
11478
- * schedule (manual-only). Validated server-side via croner;
11479
- * malformed expressions reject the upsert with an actionable
11480
- * message.
11481
- */
11482
- cron: string().optional()
11516
+ label: string().optional()
11483
11517
  }), _void(), {
11484
11518
  kind: "mutation",
11485
11519
  auth: "admin"
@@ -8605,13 +8605,28 @@ var RecordingBandSchema = object({
8605
8605
  end: string().regex(HHMM),
8606
8606
  mode: RecordingBandModeSchema,
8607
8607
  triggers: RecordingBandTriggersSchema.optional(),
8608
+ /**
8609
+ * RETIRED (D381). A band no longer carries a pre-buffer of its own.
8610
+ *
8611
+ * It was the retroactive KEEP bound — which already-written segments survive
8612
+ * a trigger — and it had to be at least as wide as the widest pre-roll the
8613
+ * broker could serve, or the gate would delete the seconds the ring had just
8614
+ * handed the writer. That "at least as wide as" is the tell: it was a second
8615
+ * expression of the broker's retention, in different units, in a different
8616
+ * addon, with an invariant the operator had to maintain by hand. The keep
8617
+ * bound is now derived from the one prebuffer ceiling and there is nothing
8618
+ * left to configure here.
8619
+ *
8620
+ * The key survives in the SHAPE so a config written before that record still
8621
+ * parses and can be migrated deliberately — `RecordingBandSchema` is not
8622
+ * strict, so simply deleting it would strip an operator's value in silence on
8623
+ * the next save (the failure D380 came one commit from shipping). Nothing
8624
+ * reads it: {@link stripRetiredBandPreBufferSec} removes it on load.
8625
+ */
8608
8626
  preBufferSec: number().min(0).optional(),
8609
8627
  postBufferSec: number().min(0).optional()
8610
8628
  });
8611
- ({
8612
- preBufferSec: 15,
8613
- postBufferSec: 30
8614
- }).postBufferSec * 1e3;
8629
+ ({ postBufferSec: 30 }).postBufferSec * 1e3;
8615
8630
  /**
8616
8631
  * Per-device retention overrides. Every field is optional; an unset or `0`
8617
8632
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -11242,12 +11257,30 @@ var BackupDestinationInfoSchema = object({
11242
11257
  lastSuccessAt: number().optional(),
11243
11258
  /** Newest-archive size from `manifests.json`, or undefined. */
11244
11259
  lastSuccessSizeBytes: number().optional(),
11245
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
11260
+ /**
11261
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
11262
+ * destination, comma-joined. Absent when no enabled schedule targets it
11263
+ * — a destination nothing is scheduled to write to must not advertise a
11264
+ * cadence (D384). This is never the `backup_destination_policies.cron`
11265
+ * column: that per-location cron has scheduled nothing since 2026-07-28
11266
+ * and reading it made a destination with a DISABLED schedule claim a
11267
+ * nightly run.
11268
+ */
11246
11269
  cron: string().optional(),
11247
- /** ms-epoch of next computed firing for this destination's cron, if any. */
11270
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
11248
11271
  nextRunAt: number().optional(),
11249
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
11250
- lastRunAt: number().optional()
11272
+ /**
11273
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
11274
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
11275
+ * newest archive that actually landed) and `lastError`.
11276
+ */
11277
+ lastAttemptAt: number().optional(),
11278
+ /**
11279
+ * Why the last attempt failed, verbatim. Absent when the last attempt
11280
+ * landed the archive. A destination that has never been written to has
11281
+ * neither this nor `lastAttemptAt`.
11282
+ */
11283
+ lastError: string().optional()
11251
11284
  });
11252
11285
  /**
11253
11286
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -11410,8 +11443,16 @@ var BackupScheduleSchema = object({
11410
11443
  retentionCount: number().int().min(1).max(1e3),
11411
11444
  /** Optional subset of source locations to include; omitted = all. */
11412
11445
  dataSources: array(string()).readonly().optional(),
11413
- /** ms-epoch of last successful run. */
11414
- lastRunAt: number().optional(),
11446
+ /**
11447
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11448
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11449
+ * "succeeded" — a run refused by every destination stamps it too.
11450
+ */
11451
+ lastAttemptAt: number().optional(),
11452
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11453
+ lastSuccessAt: number().optional(),
11454
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11455
+ lastError: string().optional(),
11415
11456
  /** ms-epoch of next computed firing (read-only, filled on list). */
11416
11457
  nextRunAt: number().optional()
11417
11458
  });
@@ -11460,14 +11501,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11460
11501
  locationId: string(),
11461
11502
  enabled: boolean(),
11462
11503
  retentionCount: number().int().min(1).max(1e3),
11463
- label: string().optional(),
11464
- /**
11465
- * Per-destination cron expression. Empty string clears the
11466
- * schedule (manual-only). Validated server-side via croner;
11467
- * malformed expressions reject the upsert with an actionable
11468
- * message.
11469
- */
11470
- cron: string().optional()
11504
+ label: string().optional()
11471
11505
  }), _void(), {
11472
11506
  kind: "mutation",
11473
11507
  auth: "admin"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-hap",
3
- "version": "1.2.87",
3
+ "version": "1.2.89",
4
4
  "description": "HomeKit (HAP) exporter for CamStack devices. Publishes each exposed device as its own HomeKit accessory: cameras and doorbells with SRTP streaming, HomeKit Secure Video, motion, two-way audio, PTZ and battery; switches, lights, locks and sensors through a capability→service table.",
5
5
  "keywords": [
6
6
  "camstack",