@camstack/addon-export-hap 1.2.94 → 1.2.95

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.
@@ -19179,11 +19179,30 @@ var SensorEventSchema = object({
19179
19179
  value: record(string(), unknown()).nullable(),
19180
19180
  timestamp: number()
19181
19181
  });
19182
+ /**
19183
+ * One stored sighting on a track's trajectory.
19184
+ *
19185
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19186
+ * arrival order, and the two detector passes interleave, so a consumer must not
19187
+ * assume the two are the same on a row written by an older build.
19188
+ */
19182
19189
  var TrackPositionSchema = object({
19183
19190
  x: number(),
19184
19191
  y: number(),
19185
19192
  timestamp: number(),
19186
- bbox: BoundingBoxSchema
19193
+ bbox: BoundingBoxSchema,
19194
+ /**
19195
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19196
+ * pass on the analysis raster, `recovery` is the native-resolution
19197
+ * small-subject second pass (D377/D378). Both write into one array, and until
19198
+ * this field existed the only way to tell them apart was that full-frame boxes
19199
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19200
+ * Absent on rows written before D399.
19201
+ */
19202
+ source: _enum(["frame", "recovery"]).optional(),
19203
+ /** Detection score of this box, so a position can be weighed and not only
19204
+ * plotted. Absent on rows written before D399. */
19205
+ score: number().optional()
19187
19206
  });
19188
19207
  var TrackSnapshotSchema = object({
19189
19208
  timestamp: number(),
@@ -19583,14 +19602,25 @@ var TrackSchema = object({
19583
19602
  */
19584
19603
  hasRider: boolean().optional(),
19585
19604
  /**
19586
- * WHY this track ended without a NATIVE best-shot tile
19587
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19605
+ * WHY this track ended without a NATIVE best-shot FRAME
19606
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19607
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19588
19608
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19589
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19590
- * the late-keyFrame upgrade when a native tile lands after all. The
19591
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19609
+ * `derive-returned-null tile=standin`,
19610
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19611
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19612
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19592
19613
  * tile is a face/plate stand-in, a raster crop, or an icon.
19593
19614
  *
19615
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19616
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19617
+ * while its key frame missed carried no reason at all — three of the four
19618
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19619
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19620
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19621
+ * lastFrame copy source`), so its absence is now on this line whatever the
19622
+ * tile ended up being.
19623
+ *
19594
19624
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19595
19625
  * that predates the field, and every track whose tile landed native all
19596
19626
  * omit it. Render nothing when absent.
@@ -19167,11 +19167,30 @@ var SensorEventSchema = object({
19167
19167
  value: record(string(), unknown()).nullable(),
19168
19168
  timestamp: number()
19169
19169
  });
19170
+ /**
19171
+ * One stored sighting on a track's trajectory.
19172
+ *
19173
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19174
+ * arrival order, and the two detector passes interleave, so a consumer must not
19175
+ * assume the two are the same on a row written by an older build.
19176
+ */
19170
19177
  var TrackPositionSchema = object({
19171
19178
  x: number(),
19172
19179
  y: number(),
19173
19180
  timestamp: number(),
19174
- bbox: BoundingBoxSchema
19181
+ bbox: BoundingBoxSchema,
19182
+ /**
19183
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19184
+ * pass on the analysis raster, `recovery` is the native-resolution
19185
+ * small-subject second pass (D377/D378). Both write into one array, and until
19186
+ * this field existed the only way to tell them apart was that full-frame boxes
19187
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19188
+ * Absent on rows written before D399.
19189
+ */
19190
+ source: _enum(["frame", "recovery"]).optional(),
19191
+ /** Detection score of this box, so a position can be weighed and not only
19192
+ * plotted. Absent on rows written before D399. */
19193
+ score: number().optional()
19175
19194
  });
19176
19195
  var TrackSnapshotSchema = object({
19177
19196
  timestamp: number(),
@@ -19571,14 +19590,25 @@ var TrackSchema = object({
19571
19590
  */
19572
19591
  hasRider: boolean().optional(),
19573
19592
  /**
19574
- * WHY this track ended without a NATIVE best-shot tile
19575
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19593
+ * WHY this track ended without a NATIVE best-shot FRAME
19594
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19595
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19576
19596
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19577
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19578
- * the late-keyFrame upgrade when a native tile lands after all. The
19579
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19597
+ * `derive-returned-null tile=standin`,
19598
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19599
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19600
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19580
19601
  * tile is a face/plate stand-in, a raster crop, or an icon.
19581
19602
  *
19603
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19604
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19605
+ * while its key frame missed carried no reason at all — three of the four
19606
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19607
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19608
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19609
+ * lastFrame copy source`), so its absence is now on this line whatever the
19610
+ * tile ended up being.
19611
+ *
19582
19612
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19583
19613
  * that predates the field, and every track whose tile landed native all
19584
19614
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-hap",
3
- "version": "1.2.94",
3
+ "version": "1.2.95",
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",