@camstack/addon-provider-hikvision 1.2.91 → 1.2.92

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
@@ -19053,11 +19053,30 @@ var SensorEventSchema = object({
19053
19053
  value: record(string(), unknown()).nullable(),
19054
19054
  timestamp: number()
19055
19055
  });
19056
+ /**
19057
+ * One stored sighting on a track's trajectory.
19058
+ *
19059
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19060
+ * arrival order, and the two detector passes interleave, so a consumer must not
19061
+ * assume the two are the same on a row written by an older build.
19062
+ */
19056
19063
  var TrackPositionSchema = object({
19057
19064
  x: number(),
19058
19065
  y: number(),
19059
19066
  timestamp: number(),
19060
- bbox: BoundingBoxSchema
19067
+ bbox: BoundingBoxSchema,
19068
+ /**
19069
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19070
+ * pass on the analysis raster, `recovery` is the native-resolution
19071
+ * small-subject second pass (D377/D378). Both write into one array, and until
19072
+ * this field existed the only way to tell them apart was that full-frame boxes
19073
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19074
+ * Absent on rows written before D399.
19075
+ */
19076
+ source: _enum(["frame", "recovery"]).optional(),
19077
+ /** Detection score of this box, so a position can be weighed and not only
19078
+ * plotted. Absent on rows written before D399. */
19079
+ score: number().optional()
19061
19080
  });
19062
19081
  var TrackSnapshotSchema = object({
19063
19082
  timestamp: number(),
@@ -19457,14 +19476,25 @@ var TrackSchema = object({
19457
19476
  */
19458
19477
  hasRider: boolean().optional(),
19459
19478
  /**
19460
- * WHY this track ended without a NATIVE best-shot tile
19461
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19479
+ * WHY this track ended without a NATIVE best-shot FRAME
19480
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19481
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19462
19482
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19463
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19464
- * the late-keyFrame upgrade when a native tile lands after all. The
19465
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19483
+ * `derive-returned-null tile=standin`,
19484
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19485
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19486
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19466
19487
  * tile is a face/plate stand-in, a raster crop, or an icon.
19467
19488
  *
19489
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19490
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19491
+ * while its key frame missed carried no reason at all — three of the four
19492
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19493
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19494
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19495
+ * lastFrame copy source`), so its absence is now on this line whatever the
19496
+ * tile ended up being.
19497
+ *
19468
19498
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19469
19499
  * that predates the field, and every track whose tile landed native all
19470
19500
  * omit it. Render nothing when absent.
package/dist/addon.mjs CHANGED
@@ -19054,11 +19054,30 @@ var SensorEventSchema = object({
19054
19054
  value: record(string(), unknown()).nullable(),
19055
19055
  timestamp: number()
19056
19056
  });
19057
+ /**
19058
+ * One stored sighting on a track's trajectory.
19059
+ *
19060
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19061
+ * arrival order, and the two detector passes interleave, so a consumer must not
19062
+ * assume the two are the same on a row written by an older build.
19063
+ */
19057
19064
  var TrackPositionSchema = object({
19058
19065
  x: number(),
19059
19066
  y: number(),
19060
19067
  timestamp: number(),
19061
- bbox: BoundingBoxSchema
19068
+ bbox: BoundingBoxSchema,
19069
+ /**
19070
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19071
+ * pass on the analysis raster, `recovery` is the native-resolution
19072
+ * small-subject second pass (D377/D378). Both write into one array, and until
19073
+ * this field existed the only way to tell them apart was that full-frame boxes
19074
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19075
+ * Absent on rows written before D399.
19076
+ */
19077
+ source: _enum(["frame", "recovery"]).optional(),
19078
+ /** Detection score of this box, so a position can be weighed and not only
19079
+ * plotted. Absent on rows written before D399. */
19080
+ score: number().optional()
19062
19081
  });
19063
19082
  var TrackSnapshotSchema = object({
19064
19083
  timestamp: number(),
@@ -19458,14 +19477,25 @@ var TrackSchema = object({
19458
19477
  */
19459
19478
  hasRider: boolean().optional(),
19460
19479
  /**
19461
- * WHY this track ended without a NATIVE best-shot tile
19462
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19480
+ * WHY this track ended without a NATIVE best-shot FRAME
19481
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
19482
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
19463
19483
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19464
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19465
- * the late-keyFrame upgrade when a native tile lands after all. The
19466
- * operator-facing answer to "perché manca l'immagine?" on a track whose
19484
+ * `derive-returned-null tile=standin`,
19485
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
19486
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
19487
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
19467
19488
  * tile is a face/plate stand-in, a raster crop, or an icon.
19468
19489
  *
19490
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
19491
+ * the TILE ranked below native, so a track whose thumbnail landed natively
19492
+ * while its key frame missed carried no reason at all — three of the four
19493
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
19494
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
19495
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
19496
+ * lastFrame copy source`), so its absence is now on this line whatever the
19497
+ * tile ended up being.
19498
+ *
19469
19499
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
19470
19500
  * that predates the field, and every track whose tile landed native all
19471
19501
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-hikvision",
3
- "version": "1.2.91",
3
+ "version": "1.2.92",
4
4
  "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
5
5
  "keywords": [
6
6
  "camstack",