@camstack/addon-post-analysis 1.1.30 → 1.1.32

package/dist/{dist-yPsKFcJL.mjs → dist-CyyCe4TK.mjs}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-CFZs3jI4.mjs
+//#region ../types/dist/event-category-H4AVePnn.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -148,6 +148,9 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["RecordingSegmentWritten"] = "recording.segment.written";
 	EventCategory["RecordingPolicyFallback"] = "recording.policy.fallback";
 	EventCategory["RecordingRetentionCompleted"] = "recording.retention.completed";
+	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
+	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
+	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -7248,6 +7251,24 @@ var RecordingRetentionSchema = object({
 	maxSizeGb: number().min(0).optional()
 });
 /**
+* Scrub-thumbnail fidelity preset — the single per-camera selector bundling the
+* sprite tile RESOLUTION + JPEG QUALITY the recorder packs timeline-scrub
+* previews at. Five graduated steps; absent on a config = `standard` (the
+* shipped default, matching `sheet-geometry`/`sheet-composer`).
+*
+* Existing sheets are IMMUTABLE — a changed preset applies to NEW windows only.
+* Each window's index sidecar carries its own tile dims, so a camera whose
+* preset changed over time renders every historical window at the dims it was
+* written with.
+*/
+var ScrubThumbnailPresetSchema = _enum([
+	"minimal",
+	"low",
+	"standard",
+	"high",
+	"max"
+]);
+/**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
 * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
@@ -7284,7 +7305,14 @@ var RecordingConfigSchema = object({
 	* derived into bands once via `migrateConfigToBands`.
 	*/
 	bands: array(RecordingBandSchema).optional(),
-	retention: RecordingRetentionSchema.optional()
+	retention: RecordingRetentionSchema.optional(),
+	/**
+	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
+	* timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
+	* windows only — existing sheets are immutable, and each window's index
+	* carries its own tile dims so mixed-preset history renders correctly.
+	*/
+	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
 });
 /**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
@@ -9919,7 +9947,7 @@ object({
 	deviceId: number(),
 	timestamp: number()
 });
-DeviceType.Button;
+DeviceType.Button, DeviceType.Camera;
 /**
 * Enum-state sensor — a string value picked from a finite option set.
 * Drives HA `sensor` entries with `state_class: enum` (HVAC action
@@ -14344,6 +14372,14 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
+var DeviceLinkModeSchema = _enum(["auto", "manual"]);
+/** One resolved linked device — the compact projection consumers need. */
+var LinkedDeviceSchema = object({
+	deviceId: number(),
+	name: string(),
+	location: string().nullable(),
+	features: array(string())
+});
 var SavedDeviceRowSchema = object({
 	/** Numeric id reserved at allocateDeviceId time. */
 	id: number(),
@@ -14565,7 +14601,10 @@ method(object({
 }), _void(), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ addonId: string() }), array(SavedDeviceRowSchema)), method(object({ addonId: string().optional() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
+}), method(object({ addonId: string() }), array(SavedDeviceRowSchema)), method(object({ addonId: string().optional() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), DeviceInfoSchema.nullable()), method(object({ parentDeviceId: number() }), array(DeviceInfoSchema)), method(object({ deviceId: number() }), object({
+	mode: DeviceLinkModeSchema,
+	devices: array(LinkedDeviceSchema)
+})), method(object({ deviceId: number() }), array(StreamSourceEntrySchema$1)), method(object({ deviceId: number() }), array(ConfigEntrySchema)), method(object({ deviceId: number() }), ConfigUISchemaOutput), method(object({
 	deviceId: number(),
 	values: record(string(), unknown())
 }), object({ success: literal(true) }), {
@@ -15844,6 +15883,61 @@ var EventKindSchema = _enum([
 	"object",
 	"audio"
 ]);
+/**
+* Spatial filter for `listTracks` — the rect + polygon variants of the shared
+* MaskShape vocabulary (see `mask-shape.ts`). Coordinates are NORMALIZED 0..1
+* of the camera frame (top-left origin), matching the drawing-plane editor.
+*/
+var TrackZoneFilterSchema = discriminatedUnion("kind", [MaskRectShapeSchema, MaskPolygonShapeSchema]);
+/** Closed icon vocabulary so clients render a known glyph per kind. */
+var EventKindIconSchema = _enum([
+	"motion",
+	"audio",
+	"person",
+	"vehicle",
+	"animal",
+	"door",
+	"pir",
+	"smoke",
+	"water",
+	"button",
+	"generic"
+]);
+var EventKindCategorySchema = _enum([
+	"motion",
+	"audio",
+	"detection",
+	"sensor",
+	"custom"
+]);
+var EventKindDescriptorSchema = object({
+	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+	kind: string(),
+	label: string(),
+	/** Hex color for timeline/legend rendering. */
+	color: string(),
+	icon: EventKindIconSchema,
+	category: EventKindCategorySchema,
+	/** Which cap + device contributes this kind. For built-ins the camera
+	*  itself; for sensor kinds the LINKED source device. */
+	source: object({
+		capName: string(),
+		deviceId: number()
+	})
+});
+var SensorEventSchema = object({
+	id: string(),
+	/** The CAMERA the event is attributed to (a sensor linked to N cameras
+	*  yields N rows, one per camera). */
+	deviceId: number(),
+	/** The linked sensor device whose state changed. */
+	sourceDeviceId: number(),
+	/** Event kind id — matches an `EventKindDescriptor.kind`. */
+	kind: string(),
+	/** Snapshot of the sensor cap's runtime-state slice at the change. */
+	value: record(string(), unknown()).nullable(),
+	timestamp: number()
+});
 var TrackPositionSchema = object({
 	x: number(),
 	y: number(),
@@ -15857,6 +15951,30 @@ var TrackSnapshotSchema = object({
 	mediaKey: string()
 });
 /**
+* Normalized 0..1 trajectory envelope (min/max over every position bbox,
+* divided by the track's detection-frame dims), computed at persist time.
+* Absent when the frame dims were unknown when the track was persisted
+* (legacy rows / dims-less sources) and on active (in-RAM) tracks.
+*/
+var TrackEnvelopeSchema = object({
+	minX: number(),
+	minY: number(),
+	maxX: number(),
+	maxY: number()
+});
+/**
+* Row projection for track list queries. `full` (default) returns the
+* complete Track including the frame-rate `positions[]` history and the
+* `snapshots[]` references — megabytes across a page of tracks. `slim`
+* keeps every scalar the list surfaces actually render (ids, class(es),
+* label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
+* zonesVisited, bestEventId, envelope) and returns `positions` /
+* `snapshots` as EMPTY arrays — detail views re-fetch the full row via
+* `getTrack`. Mirrors the event-store `projection` convention
+* (`getObjectEvents` et al.).
+*/
+var TrackProjectionSchema = _enum(["full", "slim"]);
+/**
 * One audio-classification label heard on the track's camera while the
 * track was alive, aggregated per label. An "episode" is one persisted
 * audio event (the confident-classification path: score ≥ the device's
@@ -15907,7 +16025,11 @@ var TrackSchema = object({
 	/** Audio-classification labels heard on the camera during the track's
 	*  life (score ≥ device `classificationMinScore`), aggregated per label.
 	*  Absent on legacy rows / tracks with no confident audio. */
-	audioLabels: array(TrackAudioLabelSchema).readonly().optional()
+	audioLabels: array(TrackAudioLabelSchema).readonly().optional(),
+	/** Normalized 0..1 trajectory envelope (see {@link TrackEnvelopeSchema}).
+	*  Populated from the persisted envelope columns on historical reads;
+	*  absent on legacy rows, dims-less tracks and active (in-RAM) tracks. */
+	envelope: TrackEnvelopeSchema.optional()
 });
 var BaseEventFields = {
 	id: string(),
@@ -16017,11 +16139,13 @@ var MediaFileSchema = object({
 	sizeBytes: number(),
 	timestamp: number()
 });
+var DEFAULT_EVENT_QUERY_LIMIT = 1e3;
+var MAX_EVENT_QUERY_LIMIT = 5e3;
 var DeviceEventQueryInput = object({
 	deviceId: number(),
 	since: number().optional(),
 	until: number().optional(),
-	limit: number().int().min(1).max(5e3).default(1e3),
+	limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT),
 	/** `slim` drops heavy JSON fields (regions/bbox/zones) and carries an
 	*  optional `mediaUrl` (populated by B5). `full` (default) keeps today's
 	*  exact behaviour. Callers may omit this field — the store defaults to
@@ -16029,6 +16153,27 @@ var DeviceEventQueryInput = object({
 	projection: _enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: string().optional() });
+var RecentTracksQueryInput = object({
+	/** Devices to merge. An empty array yields `{ tracks: [], nextCursor: null }`. */
+	deviceIds: array(number()),
+	/** Window lower bound on `lastSeen` (inclusive). */
+	since: number().optional(),
+	/** Window upper bound on `lastSeen` (inclusive). */
+	until: number().optional(),
+	/** Page size. Default 200, max 1000. */
+	limit: number().int().min(1).max(1e3).default(200),
+	/** Opaque continuation cursor from a previous page's `nextCursor`.
+	*  Encodes the (lastSeen, trackId) sort position — treat as opaque. */
+	cursor: string().optional(),
+	/** See {@link TrackProjectionSchema}. Default `full`. */
+	projection: TrackProjectionSchema.optional()
+});
+var RecentTracksPageSchema = object({
+	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
+	tracks: array(TrackSchema).readonly(),
+	/** Cursor for the next page, or null when this page is the last. */
+	nextCursor: string().nullable()
+});
 var KeyEventQueryInput = object({
 	deviceId: number(),
 	/** Window lower bound (track firstSeen ≥ since). */
@@ -16125,8 +16270,27 @@ var pipelineAnalyticsCapability = {
 			deviceId: number(),
 			since: number().optional(),
 			until: number().optional(),
-			limit: number().optional()
+			limit: number().optional(),
+			/** Spatial filter — only tracks whose trajectory intersects the zone
+			*  (normalized 0..1 rect or polygon). SQL-prefiltered on the persisted
+			*  envelope columns, then precisely tested per position. Tracks with
+			*  an unknown envelope (no frame dims at persist time) always match. */
+			zone: TrackZoneFilterSchema.optional(),
+			/** See {@link TrackProjectionSchema}. Default `full` (backward
+			*  compatible — omitting the field keeps today's exact behaviour). */
+			projection: TrackProjectionSchema.optional()
 		}), array(TrackSchema).readonly()),
+		/**
+		* Batched cluster-wide track listing — ONE call for the events page /
+		* reel first paint instead of a per-camera `listTracks` fan-out. Merges
+		* the persisted completed tracks of every requested device, sorted by
+		* `lastSeen` DESC with a stable (lastSeen, trackId) cursor. Per-device
+		* indexed pages (`idx_tracks_device_lastSeen`) are k-way merged
+		* provider-side; `projection: 'slim'` drops the heavy `positions[]` /
+		* `snapshots[]` JSON (returned as empty arrays). Active in-RAM tracks
+		* are not included (same contract as `listTracks`).
+		*/
+		listRecentTracks: method(RecentTracksQueryInput, RecentTracksPageSchema),
 		clearTracks: method(object({ deviceId: number() }), _void(), {
 			kind: "mutation",
 			auth: "admin"
@@ -16135,6 +16299,26 @@ var pipelineAnalyticsCapability = {
 		getObjectEvents: method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()),
 		getAudioEvents: method(DeviceEventQueryInput, array(AudioEventSchema).readonly()),
 		/**
+		* Every event kind the device can produce: built-ins (motion + audio),
+		* detection classes actually observed for the device (from the track
+		* history), and sensor kinds contributed by LINKED devices (resolved via
+		* `device-manager.getLinkedDevices`, mapped through `EVENT_KIND_BY_CAP`).
+		*/
+		listEventKinds: method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()),
+		/**
+		* Sensor-event history for a camera: state changes of LINKED sensor
+		* devices, attributed to the camera at ingest time (one row per linked
+		* camera). Mirrors `getAudioEvents` query semantics; `kinds` narrows to
+		* a kind subset.
+		*/
+		getSensorEvents: method(object({
+			deviceId: number(),
+			since: number().optional(),
+			until: number().optional(),
+			kinds: array(string()).optional(),
+			limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
+		}), array(SensorEventSchema).readonly()),
+		/**
 		* Importance-ranked highlights for a device+window. Queries completed
 		* tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
 		* the persisted score), filters by minImportance/classFilter, orders by
@@ -16279,6 +16463,54 @@ var pipelineAnalyticsCapability = {
 		}) }
 	}
 };
+/**
+* Sensor cap name → static event-kind descriptor. A linked device
+* contributes one entry per bound cap present in this map.
+*/
+var EVENT_KIND_BY_CAP = {
+	contact: {
+		kind: "contact",
+		label: "Contact",
+		color: "#f59e0b",
+		icon: "door",
+		category: "sensor"
+	},
+	flood: {
+		kind: "flood",
+		label: "Water leak",
+		color: "#3b82f6",
+		icon: "water",
+		category: "sensor"
+	},
+	gas: {
+		kind: "gas",
+		label: "Gas",
+		color: "#ef4444",
+		icon: "smoke",
+		category: "sensor"
+	},
+	"carbon-monoxide": {
+		kind: "carbon-monoxide",
+		label: "Carbon monoxide",
+		color: "#dc2626",
+		icon: "smoke",
+		category: "sensor"
+	},
+	"enum-sensor": {
+		kind: "enum-sensor",
+		label: "Sensor state",
+		color: "#8b5cf6",
+		icon: "generic",
+		category: "sensor"
+	},
+	"event-emitter": {
+		kind: "device-event",
+		label: "Device event",
+		color: "#10b981",
+		icon: "button",
+		category: "sensor"
+	}
+};
 var CameraPipelineConfigSchema = object({
 	engine: PipelineEngineChoiceSchema.optional(),
 	steps: array(PipelineStepInputSchema).readonly(),
@@ -19488,7 +19720,12 @@ var RecordingStorageUsageSchema = object({
 /**
 * Result of locating footage at a wall-clock instant for one device/profile.
 * `segment` carries the covering segment's window; `gap` reports the forward
-* nearest covered edge (`null` past the end of footage / when none exists).
+* nearest covered edge (`null` past the end of footage / when none exists)
+* and the backward covered edge `prevEndMs` (exclusive end of the nearest
+* footage behind the epoch; `null` when none — optional so older providers
+* that omit it stay valid). `prevEndMs` lets a backward frame-step hop the
+* small inter-segment cracks (durMs under-covers the span to the next
+* startMs by ~11-17 ms) instead of no-opping at a segment head.
 */
 var LocateSegmentResultSchema = discriminatedUnion("kind", [object({
 	kind: literal("segment"),
@@ -19497,7 +19734,8 @@ var LocateSegmentResultSchema = discriminatedUnion("kind", [object({
 	bytes: number()
 }), object({
 	kind: literal("gap"),
-	nearestEdgeMs: number().nullable()
+	nearestEdgeMs: number().nullable(),
+	prevEndMs: number().nullable().optional()
 })]);
 /** Raw bytes of one finalized footage segment (read off disk on the recording node). */
 var ReadSegmentBytesResultSchema = object({ data: _instanceof(Uint8Array) });
@@ -21066,6 +21304,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceManager.getLinkedDevices": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.getRoleDisplayDefaults": {
 		capName: "device-manager",
 		capScope: "system",
@@ -22620,6 +22864,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSensorEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -22632,6 +22882,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listEventKinds": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
+	"pipelineAnalytics.listRecentTracks": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -24619,4 +24881,4 @@ object({
 	schemaVersion: literal(1)
 });
 //#endregion
-export { EventCategory as S, hydrateSchema as _, embeddingEncoderCapability as a, object as b, nodePin as c, videoclipsCapability as d, zoneAnalyticsCapability as f, createEvent as g, DeviceType as h, cosineSimilarity as i, pipelineAnalyticsCapability as l, BaseAddon as m, addonWidgetsSourceCapability as n, faceGalleryCapability as o, errMsg as p, audioMetricsCapability as r, hfModelUrl as s, EVENT_PAD_MS as t, plateGalleryCapability as u, boolean as v, string as x, number as y };
+export { EventCategory as C, string as S, createEvent as _, cosineSimilarity as a, number as b, hfModelUrl as c, plateGalleryCapability as d, videoclipsCapability as f, DeviceType as g, BaseAddon as h, audioMetricsCapability as i, nodePin as l, errMsg as m, EVENT_PAD_MS as n, embeddingEncoderCapability as o, zoneAnalyticsCapability as p, addonWidgetsSourceCapability as r, faceGalleryCapability as s, EVENT_KIND_BY_CAP as t, pipelineAnalyticsCapability as u, hydrateSchema as v, object as x, boolean as y };