@camstack/addon-provider-amcrest 0.2.85 → 0.2.86

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