@camstack/addon-provider-petkit 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
@@ -19865,11 +19865,30 @@ var SensorEventSchema = object({
19865
19865
  value: record(string(), unknown()).nullable(),
19866
19866
  timestamp: number()
19867
19867
  });
19868
+ /**
19869
+ * One stored sighting on a track's trajectory.
19870
+ *
19871
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19872
+ * arrival order, and the two detector passes interleave, so a consumer must not
19873
+ * assume the two are the same on a row written by an older build.
19874
+ */
19868
19875
  var TrackPositionSchema = object({
19869
19876
  x: number(),
19870
19877
  y: number(),
19871
19878
  timestamp: number(),
19872
- bbox: BoundingBoxSchema
19879
+ bbox: BoundingBoxSchema,
19880
+ /**
19881
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19882
+ * pass on the analysis raster, `recovery` is the native-resolution
19883
+ * small-subject second pass (D377/D378). Both write into one array, and until
19884
+ * this field existed the only way to tell them apart was that full-frame boxes
19885
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19886
+ * Absent on rows written before D399.
19887
+ */
19888
+ source: _enum(["frame", "recovery"]).optional(),
19889
+ /** Detection score of this box, so a position can be weighed and not only
19890
+ * plotted. Absent on rows written before D399. */
19891
+ score: number().optional()
19873
19892
  });
19874
19893
  var TrackSnapshotSchema = object({
19875
19894
  timestamp: number(),
@@ -20269,14 +20288,25 @@ var TrackSchema = object({
20269
20288
  */
20270
20289
  hasRider: boolean().optional(),
20271
20290
  /**
20272
- * WHY this track ended without a NATIVE best-shot tile
20273
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
20291
+ * WHY this track ended without a NATIVE best-shot FRAME
20292
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
20293
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
20274
20294
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
20275
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
20276
- * the late-keyFrame upgrade when a native tile lands after all. The
20277
- * operator-facing answer to "perché manca l'immagine?" on a track whose
20295
+ * `derive-returned-null tile=standin`,
20296
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
20297
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
20298
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
20278
20299
  * tile is a face/plate stand-in, a raster crop, or an icon.
20279
20300
  *
20301
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
20302
+ * the TILE ranked below native, so a track whose thumbnail landed natively
20303
+ * while its key frame missed carried no reason at all — three of the four
20304
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
20305
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
20306
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
20307
+ * lastFrame copy source`), so its absence is now on this line whatever the
20308
+ * tile ended up being.
20309
+ *
20280
20310
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
20281
20311
  * that predates the field, and every track whose tile landed native all
20282
20312
  * omit it. Render nothing when absent.
package/dist/addon.mjs CHANGED
@@ -19864,11 +19864,30 @@ var SensorEventSchema = object({
19864
19864
  value: record(string(), unknown()).nullable(),
19865
19865
  timestamp: number()
19866
19866
  });
19867
+ /**
19868
+ * One stored sighting on a track's trajectory.
19869
+ *
19870
+ * The array these live in is returned in TIME order (D399) — it is APPENDED in
19871
+ * arrival order, and the two detector passes interleave, so a consumer must not
19872
+ * assume the two are the same on a row written by an older build.
19873
+ */
19867
19874
  var TrackPositionSchema = object({
19868
19875
  x: number(),
19869
19876
  y: number(),
19870
19877
  timestamp: number(),
19871
- bbox: BoundingBoxSchema
19878
+ bbox: BoundingBoxSchema,
19879
+ /**
19880
+ * Which detector pass measured this box (D399): `frame` is the full-frame
19881
+ * pass on the analysis raster, `recovery` is the native-resolution
19882
+ * small-subject second pass (D377/D378). Both write into one array, and until
19883
+ * this field existed the only way to tell them apart was that full-frame boxes
19884
+ * are exact multiples of 1.2 while recovery boxes are full-precision floats.
19885
+ * Absent on rows written before D399.
19886
+ */
19887
+ source: _enum(["frame", "recovery"]).optional(),
19888
+ /** Detection score of this box, so a position can be weighed and not only
19889
+ * plotted. Absent on rows written before D399. */
19890
+ score: number().optional()
19872
19891
  });
19873
19892
  var TrackSnapshotSchema = object({
19874
19893
  timestamp: number(),
@@ -20268,14 +20287,25 @@ var TrackSchema = object({
20268
20287
  */
20269
20288
  hasRider: boolean().optional(),
20270
20289
  /**
20271
- * WHY this track ended without a NATIVE best-shot tile
20272
- * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
20290
+ * WHY this track ended without a NATIVE best-shot FRAME
20291
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md),
20292
+ * widened by [D400](../decisions/adr-0400-the-picture-is-judged-on-what-is-delivered.md)) —
20273
20293
  * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
20274
- * `derive-returned-null tile=standin`, …) written at close and CLEARED by
20275
- * the late-keyFrame upgrade when a native tile lands after all. The
20276
- * operator-facing answer to "perché manca l'immagine?" on a track whose
20294
+ * `derive-returned-null tile=standin`,
20295
+ * `native-tile tile=native no-key-frame-at-close`, …) written at close and
20296
+ * CLEARED by the late-keyFrame upgrade when a native tile lands after all.
20297
+ * The operator-facing answer to "perché manca l'immagine?" on a track whose
20277
20298
  * tile is a face/plate stand-in, a raster crop, or an icon.
20278
20299
  *
20300
+ * **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
20301
+ * the TILE ranked below native, so a track whose thumbnail landed natively
20302
+ * while its key frame missed carried no reason at all — three of the four
20303
+ * `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
20304
+ * that shape, and their "niente ultimo" had no cause anywhere on the row.
20305
+ * The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
20306
+ * lastFrame copy source`), so its absence is now on this line whatever the
20307
+ * tile ended up being.
20308
+ *
20279
20309
  * **Absent ≠ "missed silently"**: a row written before the column, a hub
20280
20310
  * that predates the field, and every track whose tile landed native all
20281
20311
  * omit it. Render nothing when absent.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-petkit",
3
- "version": "0.2.83",
3
+ "version": "0.2.84",
4
4
  "description": "PetKit smart-feeder device-provider addon for CamStack — wraps the @apocaliss92/nodepetkit PetKit cloud client",
5
5
  "keywords": [
6
6
  "camstack",