@camstack/addon-provider-unifi 0.2.83 → 0.2.84

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
@@ -18746,11 +18746,30 @@ var SensorEventSchema = object({
18746
18746
  value: record(string(), unknown()).nullable(),
18747
18747
  timestamp: number()
18748
18748
  });
18749
+ /**
18750
+ * One stored sighting on a track's trajectory.
18751
+ *
18752
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18753
+ * arrival order, and the two detector passes interleave, so a consumer must not
18754
+ * assume the two are the same on a row written by an older build.
18755
+ */
18749
18756
  var TrackPositionSchema = object({
18750
18757
  x: number(),
18751
18758
  y: number(),
18752
18759
  timestamp: number(),
18753
- bbox: BoundingBoxSchema
18760
+ bbox: BoundingBoxSchema,
18761
+ /**
18762
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18763
+ * pass on the analysis raster, `recovery` is the native-resolution
18764
+ * small-subject second pass (D377/D378). Both write into one array, and until
18765
+ * this field existed the only way to tell them apart was that full-frame boxes
18766
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18767
+ * Absent on rows written before D399.
18768
+ */
18769
+ source: _enum(["frame", "recovery"]).optional(),
18770
+ /** Detection score of this box, so a position can be weighed and not only
18771
+ * plotted. Absent on rows written before D399. */
18772
+ score: number().optional()
18754
18773
  });
18755
18774
  var TrackSnapshotSchema = object({
18756
18775
  timestamp: number(),
@@ -19150,14 +19169,25 @@ var TrackSchema = object({
19150
19169
  */
19151
19170
  hasRider: boolean().optional(),
19152
19171
  /**
19153
- * WHY this track ended without a NATIVE best-shot tile
19154
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19172
+ * WHY this track ended without a NATIVE best-shot FRAME
19173
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19174
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19155
19175
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19156
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19157
- * the late-keyFrame upgrade when a native tile lands after all. The
19158
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19176
+ * `derive-returned-null tile=standin`,
19177
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19178
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19179
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19159
19180
  * tile is a face/plate stand-in, a raster crop, or an icon.
19160
19181
  *
19182
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19183
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19184
+ * while its key frame missed carried no reason at all — three of the four
19185
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19186
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19187
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19188
+ * lastFrame copy source`), so its absence is now on this line whatever the
19189
+ * tile ended up being.
19190
+ *
19161
19191
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19162
19192
  * that predates the field, and every track whose tile landed native all
19163
19193
  * omit it. Render nothing when absent.
package/dist/addon.mjs CHANGED
@@ -18745,11 +18745,30 @@ var SensorEventSchema = object({
18745
18745
  value: record(string(), unknown()).nullable(),
18746
18746
  timestamp: number()
18747
18747
  });
18748
+ /**
18749
+ * One stored sighting on a track's trajectory.
18750
+ *
18751
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
18752
+ * arrival order, and the two detector passes interleave, so a consumer must not
18753
+ * assume the two are the same on a row written by an older build.
18754
+ */
18748
18755
  var TrackPositionSchema = object({
18749
18756
  x: number(),
18750
18757
  y: number(),
18751
18758
  timestamp: number(),
18752
- bbox: BoundingBoxSchema
18759
+ bbox: BoundingBoxSchema,
18760
+ /**
18761
+ * Which detector pass measured this box (D399): `frame` is the full-frame
18762
+ * pass on the analysis raster, `recovery` is the native-resolution
18763
+ * small-subject second pass (D377/D378). Both write into one array, and until
18764
+ * this field existed the only way to tell them apart was that full-frame boxes
18765
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
18766
+ * Absent on rows written before D399.
18767
+ */
18768
+ source: _enum(["frame", "recovery"]).optional(),
18769
+ /** Detection score of this box, so a position can be weighed and not only
18770
+ * plotted. Absent on rows written before D399. */
18771
+ score: number().optional()
18753
18772
  });
18754
18773
  var TrackSnapshotSchema = object({
18755
18774
  timestamp: number(),
@@ -19149,14 +19168,25 @@ var TrackSchema = object({
19149
19168
  */
19150
19169
  hasRider: boolean().optional(),
19151
19170
  /**
19152
- * WHY this track ended without a NATIVE best-shot tile
19153
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19171
+ * WHY this track ended without a NATIVE best-shot FRAME
19172
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19173
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19154
19174
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19155
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19156
- * the late-keyFrame upgrade when a native tile lands after all. The
19157
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19175
+ * `derive-returned-null tile=standin`,
19176
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19177
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19178
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19158
19179
  * tile is a face/plate stand-in, a raster crop, or an icon.
19159
19180
  *
19181
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19182
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19183
+ * while its key frame missed carried no reason at all — three of the four
19184
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19185
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19186
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19187
+ * lastFrame copy source`), so its absence is now on this line whatever the
19188
+ * tile ended up being.
19189
+ *
19160
19190
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19161
19191
  * that predates the field, and every track whose tile landed native all
19162
19192
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-unifi",
3
- "version": "0.2.83",
3
+ "version": "0.2.84",
4
4
  "description": "UniFi Network controller device-provider addon for CamStack — local-controller infra switches/APs (as containers) + network-client presence. NO cameras/Protect.",
5
5
  "keywords": [
6
6
  "camstack",