@camstack/addon-post-analysis 1.2.85 → 1.2.86

package/dist/pipeline-analytics/index.js

@@ -5715,7 +5715,7 @@ var NcAudioStillShelf = class {
 	}
 	async fetch(captureId, deviceId, atMs) {
 		try {
-			const shot = await withTimeout$2(this.deps.getSnapshot(deviceId), SNAPSHOT_TIMEOUT_MS);
+			const shot = await withTimeout$3(this.deps.getSnapshot(deviceId), SNAPSHOT_TIMEOUT_MS);
 			if (shot === null || shot.base64.length === 0) {
 				this.reportMiss(deviceId, "the camera returned no snapshot");
 				return;
@@ -5781,7 +5781,7 @@ function audioStillMedia(data, timestamp) {
 	];
 }
 /** Reject if `promise` does not settle within `ms`. */
-function withTimeout$2(promise, ms) {
+function withTimeout$3(promise, ms) {
 	return new Promise((resolve, reject) => {
 		const timer = setTimeout(() => {
 			reject(/* @__PURE__ */ new Error(`snapshot cap timed out after ${String(ms)}ms`));
@@ -30485,7 +30485,7 @@ var undecided = (candidate, reason) => ({
 	reason,
 	className: candidate.className
 });
-function withTimeout$1(promise, timeoutMs) {
+function withTimeout$2(promise, timeoutMs) {
 	return new Promise((resolve, reject) => {
 		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("confirmation-timeout")), timeoutMs);
 		promise.then((value) => {
@@ -30525,7 +30525,7 @@ async function confirmOne(candidate, config, deps, exhausted) {
 	const cropPx = Math.max(candidate.bbox.w, candidate.bbox.h);
 	if (config.minCropPx > 0 && cropPx < config.minCropPx) return undecided(candidate, "below-min-crop");
 	try {
-		return await withTimeout$1(runConfirmation(candidate, config, deps, exhausted), config.timeoutMs);
+		return await withTimeout$2(runConfirmation(candidate, config, deps, exhausted), config.timeoutMs);
 	} catch {
 		return undecided(candidate, "timeout");
 	}
@@ -34772,7 +34772,8 @@ function isMediaOwnerKind(value) {
 *   write="one row per blob written through put / putReplacing — a track's
 *     keyFrame, thumbnail, firstFrame and lastFrame (UPSERTED on a deterministic
 *     id, so one per track+kind however many captures race), its periodic
-*     snapshots, each event's crop and full frames, and the buffered face/plate
+*     snapshots, each event's crop and full frames, a motion visit's still
+*     (`kind: snapshot` on ownerKind event), and the buffered face/plate
 *     crops. A row is also REOWNED here (not rewritten) when the operator enrols a
 *     face or a plate, which is what moves it out of retention's reach."
 *   retention="no age sweep of its own — MediaStore.evictBefore was deleted (D59)
@@ -39078,11 +39079,14 @@ function tieredLabelColumnData(patch) {
 *     (MOTION_EVENT_HEARTBEAT_MS) while it stays on. The analyzer path and the
 *     onboard-firmware path share that throttle, so a camera cannot double-count.
 *     Measured at ~7,200 rows/day/camera."
-*   retention="a TERMINAL age-keyed root — no trackId, no media, nothing references
-*     it, so the track cascade can never reach it. Deleted by
+*   retention="a TERMINAL age-keyed root — no trackId. A motion row may own a
+*     still (`ownerKind: 'event'`, `kind: 'snapshot'`) captured on the off→on
+*     visit so events-mode recordings have a videoclip thumbnail. Deleted by
 *     EventStore.evictTracklessBefore on the DEVICE's one retention window
-*     (follow-recordings horizon, or trackRetentionDays, default 7). 0 days = keep
-*     forever, and this table is the reason that setting is dangerous."
+*     (follow-recordings horizon, or trackRetentionDays, default 7), which
+*     folds in MediaStore.deleteForEvents so the still leaves with the row.
+*     0 days = keep forever, and this table is the reason that setting is
+*     dangerous."
 */
 var MOTION_EVENTS_COLLECTION = "pipeline-analytics:motion-events";
 /**
@@ -39811,9 +39815,10 @@ var EventStore = class {
 	* Object events now leave exactly one way: with their track, through
 	* {@link deleteByTracks} (D61).
 	*
-	* Motion and audio carry no `trackId`, own no media and are referenced by
-	* nothing — they are terminal retention ROOTS, so an age window on them
-	* cannot contradict anybody's (`retention/retention-model.ts`).
+	* Motion and audio carry no `trackId` and are referenced by nothing — they
+	* are terminal retention ROOTS, so an age window on them cannot contradict
+	* anybody's (`retention/retention-model.ts`). A motion visit still is
+	* event-owned media of that row and is deleted here in lockstep.
 	*
 	* **ONE cutoff for both kinds** (D62). They used to take a window each
 	* (`retentionMotionDays` / `retentionAudioDays`), which is two clocks over
@@ -39830,9 +39835,17 @@ var EventStore = class {
 			...params.deviceId !== void 0 ? { where: { deviceId: params.deviceId } } : {},
 			whereBetween: { timestamp: [0, params.cutoffMs] }
 		});
+		const motion = await batch(MOTION_EVENTS_COLLECTION);
+		const audio = await batch(AUDIO_EVENTS_COLLECTION);
+		const ids = [...motion, ...audio];
+		if (ids.length > 0 && this.media !== void 0) try {
+			await this.media.deleteForEvents(ids);
+		} catch (err) {
+			this.logger.warn("EventStore.evictTracklessBefore: event media delete failed", { meta: { error: String(err) } });
+		}
 		return {
-			motion: await batch(MOTION_EVENTS_COLLECTION),
-			audio: await batch(AUDIO_EVENTS_COLLECTION)
+			motion,
+			audio
 		};
 	}
 	/**
@@ -39857,23 +39870,32 @@ var EventStore = class {
 	* The SUBSET of `eventIds` that still exist — the orphan audit's liveness
 	* probe for event-owned media.
 	*
+	* Motion and audio rows can own stills (`kind: 'snapshot'` on a motion
+	* visit); probing only the object collection would classify those stills
+	* as orphans the moment they were written.
+	*
 	* THROWS on a query failure rather than answering partially. A probe that
 	* quietly under-reports here reads as "these events are gone", and the caller
 	* deletes live crops on the strength of it.
 	*/
 	async existingEventIds(eventIds) {
 		const found = /* @__PURE__ */ new Set();
+		const collections = [
+			OBJECT_EVENTS_COLLECTION,
+			MOTION_EVENTS_COLLECTION,
+			AUDIO_EVENTS_COLLECTION
+		];
 		for (let i = 0; i < eventIds.length; i += 500) {
 			const chunk = eventIds.slice(i, i + 500);
 			if (chunk.length === 0) continue;
-			const rows = await this.store.query.query({
-				collection: OBJECT_EVENTS_COLLECTION,
+			const pages = await Promise.all(collections.map((collection) => this.store.query.query({
+				collection,
 				filter: {
 					whereIn: { id: [...chunk] },
 					limit: chunk.length
 				}
-			});
-			for (const row of rows) found.add(row.id);
+			})));
+			for (const rows of pages) for (const row of rows) found.add(row.id);
 		}
 		return found;
 	}
@@ -46731,16 +46753,16 @@ var DEFAULT_DEBOUNCE_MS = 1e4;
 /** A hanging snapshot cap must not stall the sensor state-change path. */
 var DEFAULT_SNAPSHOT_TIMEOUT_MS = 1e4;
 /** Distinguishes a snapshot-cap timeout from a fetch failure for reporting. */
-var SnapshotTimeoutError = class extends Error {
+var SnapshotTimeoutError$1 = class extends Error {
 	constructor(ms) {
 		super(`snapshot cap timed out after ${ms}ms`);
 		this.name = "SnapshotTimeoutError";
 	}
 };
 /** Reject with `SnapshotTimeoutError` if `promise` doesn't settle within `ms`. */
-function withTimeout(promise, ms) {
+function withTimeout$1(promise, ms) {
 	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError$1(ms)), ms);
 		promise.then((value) => {
 			clearTimeout(timer);
 			resolve(value);
@@ -46795,11 +46817,11 @@ var SyntheticTrackMaterializer = class {
 	*/
 	async fetchSnapshot(cameraId, timeoutMs) {
 		try {
-			const snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
+			const snap = await withTimeout$1(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
 			if (snap === null) this.deps.onError?.("getSnapshot", /* @__PURE__ */ new Error("snapshot returned null"), cameraId);
 			return snap;
 		} catch (err) {
-			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
+			this.deps.onError?.(err instanceof SnapshotTimeoutError$1 ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
 			return null;
 		}
 	}
@@ -46865,6 +46887,66 @@ var SyntheticTrackMaterializer = class {
 		return track;
 	}
 };
+var SnapshotTimeoutError = class extends Error {
+	constructor(ms) {
+		super(`snapshot cap timed out after ${ms}ms`);
+		this.name = "SnapshotTimeoutError";
+	}
+};
+function withTimeout(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
+		promise.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err instanceof Error ? err : new Error(String(err)));
+		});
+	});
+}
+var MotionEventSnapshotCapturer = class {
+	deps;
+	snapshotTimeoutMs;
+	constructor(deps) {
+		this.deps = deps;
+		this.snapshotTimeoutMs = deps.snapshotTimeoutMs ?? 2500;
+	}
+	/**
+	* Fetch a still and persist it as the motion event's snapshot. Never
+	* throws — the durable record is the motion row, already inserted by
+	* the caller.
+	*/
+	async capture(input) {
+		let snap;
+		try {
+			snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: input.deviceId }), this.snapshotTimeoutMs);
+		} catch (err) {
+			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotFetch", err, input.deviceId);
+			return;
+		}
+		if (snap === null) return;
+		const raw = Buffer.from(snap.base64, "base64");
+		let data = raw;
+		try {
+			data = await downscaleFullFrameJpeg(raw, 960, 540);
+		} catch (err) {
+			this.deps.onError?.("downscaleSnapshot", err, input.deviceId);
+		}
+		try {
+			await this.deps.media.put({
+				deviceId: input.deviceId,
+				ownerKind: "event",
+				ownerId: input.eventId,
+				kind: "snapshot",
+				timestamp: input.timestamp,
+				data
+			});
+		} catch (err) {
+			this.deps.onError?.("snapshotMedia", err, input.deviceId);
+		}
+	}
+};
 var TrackingSettingsSchema = require_dist.object({
 	/**
 	* How much of a detection's box must lie inside a zone (0-1 fraction of the
@@ -49835,6 +49917,10 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 	/** The ONE projector of non-spatial events into synthetic snapshot-carrying
 	*  tracks — linked sensor/control state changes AND audio markers. */
 	syntheticTracks = null;
+	/** Still for a motion row that has no track (events-mode recording without
+	*  a detection). Lands as event-owned `kind: 'snapshot'` so videoclip
+	*  thumbnails resolve through the existing event-media plane. */
+	motionEventSnapshots = null;
 	/** Decides which audio frames deserve a synthetic marker (D62). */
 	audioMarkers = null;
 	faceStore = null;
@@ -51028,6 +51114,17 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 			} })
 		});
 		this.syntheticTracks = syntheticTracks;
+		this.motionEventSnapshots = new MotionEventSnapshotCapturer({
+			snapshot: { getSnapshot: (i) => api.snapshot?.getSnapshot.query(i) ?? Promise.resolve(null) },
+			media: mediaStore,
+			onError: (scope, err, deviceId) => logger.warn("motion event snapshot failed", {
+				...deviceId !== void 0 ? { tags: { deviceId } } : {},
+				meta: {
+					scope,
+					error: require_dist.errMsg(err)
+				}
+			})
+		});
 		this.audioMarkers = new AudioMarkerProjector({
 			sink: syntheticTracks,
 			isMotionActive: (deviceId, atMs, quietMs) => this.isMotionActive(deviceId, atMs, quietMs),
@@ -54098,7 +54195,13 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		const last = this.lastMotionInsertByDevice.get(deviceId);
 		const heartbeatDue = !last || timestamp - last.atMs >= MOTION_EVENT_HEARTBEAT_MS;
 		const transitionedOn = detected && (last === void 0 || last.detected === false);
-		if (!detected) return;
+		if (!detected) {
+			if (last?.detected === true) this.lastMotionInsertByDevice.set(deviceId, {
+				detected: false,
+				atMs: timestamp
+			});
+			return;
+		}
 		if (!transitionedOn && !heartbeatDue) return;
 		const ev = {
 			id: (0, node_crypto.randomUUID)(),
@@ -54141,6 +54244,11 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 				timestamp: ev.timestamp
 			}
 		});
+		if (transitionedOn) await this.motionEventSnapshots?.capture({
+			deviceId,
+			eventId: ev.id,
+			timestamp: ev.timestamp
+		});
 	}
 	/**
 	* Persist firmware-driven (onboard) motion events. Mirrors
@@ -54165,7 +54273,13 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		const last = this.lastMotionInsertByDevice.get(deviceId);
 		const heartbeatDue = !last || timestamp - last.atMs >= MOTION_EVENT_HEARTBEAT_MS;
 		const transitionedOn = detected && (last === void 0 || last.detected === false);
-		if (!detected) return;
+		if (!detected) {
+			if (last?.detected === true) this.lastMotionInsertByDevice.set(deviceId, {
+				detected: false,
+				atMs: timestamp
+			});
+			return;
+		}
 		if (!transitionedOn && !heartbeatDue) return;
 		const regions = payload.regions ?? [];
 		const ev = {
@@ -54209,6 +54323,11 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 				timestamp: ev.timestamp
 			}
 		});
+		if (transitionedOn) await this.motionEventSnapshots?.capture({
+			deviceId,
+			eventId: ev.id,
+			timestamp: ev.timestamp
+		});
 	}
 	async sweepExpiredTracks() {
 		if (this.shuttingDown || !this.trackStore) return;
@@ -54277,8 +54396,9 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 	*
 	*   1. the track sweep, per device, cascading;
 	*   2. the TRACKLESS roots — motion, audio and sensor events, which carry no
-	*      trackId, own nothing and are referenced by nothing, so the cascade can
-	*      never reach them and a clock is the only thing that can.
+	*      trackId and are referenced by nothing, so the cascade can never reach
+	*      them and a clock is the only thing that can. Motion visit stills leave
+	*      with their row inside `evictTracklessBefore`.
 	*
 	* That clock used to be three more settings (`retentionMotionDays` /
 	* `retentionObjectDays` / `retentionAudioDays`). It is now the device's own

package/dist/pipeline-analytics/index.mjs

@@ -5708,7 +5708,7 @@ var NcAudioStillShelf = class {
 	}
 	async fetch(captureId, deviceId, atMs) {
 		try {
-			const shot = await withTimeout$2(this.deps.getSnapshot(deviceId), SNAPSHOT_TIMEOUT_MS);
+			const shot = await withTimeout$3(this.deps.getSnapshot(deviceId), SNAPSHOT_TIMEOUT_MS);
 			if (shot === null || shot.base64.length === 0) {
 				this.reportMiss(deviceId, "the camera returned no snapshot");
 				return;
@@ -5774,7 +5774,7 @@ function audioStillMedia(data, timestamp) {
 	];
 }
 /** Reject if `promise` does not settle within `ms`. */
-function withTimeout$2(promise, ms) {
+function withTimeout$3(promise, ms) {
 	return new Promise((resolve, reject) => {
 		const timer = setTimeout(() => {
 			reject(/* @__PURE__ */ new Error(`snapshot cap timed out after ${String(ms)}ms`));
@@ -30426,7 +30426,7 @@ var undecided = (candidate, reason) => ({
 	reason,
 	className: candidate.className
 });
-function withTimeout$1(promise, timeoutMs) {
+function withTimeout$2(promise, timeoutMs) {
 	return new Promise((resolve, reject) => {
 		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("confirmation-timeout")), timeoutMs);
 		promise.then((value) => {
@@ -30466,7 +30466,7 @@ async function confirmOne(candidate, config, deps, exhausted) {
 	const cropPx = Math.max(candidate.bbox.w, candidate.bbox.h);
 	if (config.minCropPx > 0 && cropPx < config.minCropPx) return undecided(candidate, "below-min-crop");
 	try {
-		return await withTimeout$1(runConfirmation(candidate, config, deps, exhausted), config.timeoutMs);
+		return await withTimeout$2(runConfirmation(candidate, config, deps, exhausted), config.timeoutMs);
 	} catch {
 		return undecided(candidate, "timeout");
 	}
@@ -34713,7 +34713,8 @@ function isMediaOwnerKind(value) {
 *   write="one row per blob written through put / putReplacing — a track's
 *     keyFrame, thumbnail, firstFrame and lastFrame (UPSERTED on a deterministic
 *     id, so one per track+kind however many captures race), its periodic
-*     snapshots, each event's crop and full frames, and the buffered face/plate
+*     snapshots, each event's crop and full frames, a motion visit's still
+*     (`kind: snapshot` on ownerKind event), and the buffered face/plate
 *     crops. A row is also REOWNED here (not rewritten) when the operator enrols a
 *     face or a plate, which is what moves it out of retention's reach."
 *   retention="no age sweep of its own — MediaStore.evictBefore was deleted (D59)
@@ -39019,11 +39020,14 @@ function tieredLabelColumnData(patch) {
 *     (MOTION_EVENT_HEARTBEAT_MS) while it stays on. The analyzer path and the
 *     onboard-firmware path share that throttle, so a camera cannot double-count.
 *     Measured at ~7,200 rows/day/camera."
-*   retention="a TERMINAL age-keyed root — no trackId, no media, nothing references
-*     it, so the track cascade can never reach it. Deleted by
+*   retention="a TERMINAL age-keyed root — no trackId. A motion row may own a
+*     still (`ownerKind: 'event'`, `kind: 'snapshot'`) captured on the off→on
+*     visit so events-mode recordings have a videoclip thumbnail. Deleted by
 *     EventStore.evictTracklessBefore on the DEVICE's one retention window
-*     (follow-recordings horizon, or trackRetentionDays, default 7). 0 days = keep
-*     forever, and this table is the reason that setting is dangerous."
+*     (follow-recordings horizon, or trackRetentionDays, default 7), which
+*     folds in MediaStore.deleteForEvents so the still leaves with the row.
+*     0 days = keep forever, and this table is the reason that setting is
+*     dangerous."
 */
 var MOTION_EVENTS_COLLECTION = "pipeline-analytics:motion-events";
 /**
@@ -39752,9 +39756,10 @@ var EventStore = class {
 	* Object events now leave exactly one way: with their track, through
 	* {@link deleteByTracks} (D61).
 	*
-	* Motion and audio carry no `trackId`, own no media and are referenced by
-	* nothing — they are terminal retention ROOTS, so an age window on them
-	* cannot contradict anybody's (`retention/retention-model.ts`).
+	* Motion and audio carry no `trackId` and are referenced by nothing — they
+	* are terminal retention ROOTS, so an age window on them cannot contradict
+	* anybody's (`retention/retention-model.ts`). A motion visit still is
+	* event-owned media of that row and is deleted here in lockstep.
 	*
 	* **ONE cutoff for both kinds** (D62). They used to take a window each
 	* (`retentionMotionDays` / `retentionAudioDays`), which is two clocks over
@@ -39771,9 +39776,17 @@ var EventStore = class {
 			...params.deviceId !== void 0 ? { where: { deviceId: params.deviceId } } : {},
 			whereBetween: { timestamp: [0, params.cutoffMs] }
 		});
+		const motion = await batch(MOTION_EVENTS_COLLECTION);
+		const audio = await batch(AUDIO_EVENTS_COLLECTION);
+		const ids = [...motion, ...audio];
+		if (ids.length > 0 && this.media !== void 0) try {
+			await this.media.deleteForEvents(ids);
+		} catch (err) {
+			this.logger.warn("EventStore.evictTracklessBefore: event media delete failed", { meta: { error: String(err) } });
+		}
 		return {
-			motion: await batch(MOTION_EVENTS_COLLECTION),
-			audio: await batch(AUDIO_EVENTS_COLLECTION)
+			motion,
+			audio
 		};
 	}
 	/**
@@ -39798,23 +39811,32 @@ var EventStore = class {
 	* The SUBSET of `eventIds` that still exist — the orphan audit's liveness
 	* probe for event-owned media.
 	*
+	* Motion and audio rows can own stills (`kind: 'snapshot'` on a motion
+	* visit); probing only the object collection would classify those stills
+	* as orphans the moment they were written.
+	*
 	* THROWS on a query failure rather than answering partially. A probe that
 	* quietly under-reports here reads as "these events are gone", and the caller
 	* deletes live crops on the strength of it.
 	*/
 	async existingEventIds(eventIds) {
 		const found = /* @__PURE__ */ new Set();
+		const collections = [
+			OBJECT_EVENTS_COLLECTION,
+			MOTION_EVENTS_COLLECTION,
+			AUDIO_EVENTS_COLLECTION
+		];
 		for (let i = 0; i < eventIds.length; i += 500) {
 			const chunk = eventIds.slice(i, i + 500);
 			if (chunk.length === 0) continue;
-			const rows = await this.store.query.query({
-				collection: OBJECT_EVENTS_COLLECTION,
+			const pages = await Promise.all(collections.map((collection) => this.store.query.query({
+				collection,
 				filter: {
 					whereIn: { id: [...chunk] },
 					limit: chunk.length
 				}
-			});
-			for (const row of rows) found.add(row.id);
+			})));
+			for (const rows of pages) for (const row of rows) found.add(row.id);
 		}
 		return found;
 	}
@@ -46672,16 +46694,16 @@ var DEFAULT_DEBOUNCE_MS = 1e4;
 /** A hanging snapshot cap must not stall the sensor state-change path. */
 var DEFAULT_SNAPSHOT_TIMEOUT_MS = 1e4;
 /** Distinguishes a snapshot-cap timeout from a fetch failure for reporting. */
-var SnapshotTimeoutError = class extends Error {
+var SnapshotTimeoutError$1 = class extends Error {
 	constructor(ms) {
 		super(`snapshot cap timed out after ${ms}ms`);
 		this.name = "SnapshotTimeoutError";
 	}
 };
 /** Reject with `SnapshotTimeoutError` if `promise` doesn't settle within `ms`. */
-function withTimeout(promise, ms) {
+function withTimeout$1(promise, ms) {
 	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError$1(ms)), ms);
 		promise.then((value) => {
 			clearTimeout(timer);
 			resolve(value);
@@ -46736,11 +46758,11 @@ var SyntheticTrackMaterializer = class {
 	*/
 	async fetchSnapshot(cameraId, timeoutMs) {
 		try {
-			const snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
+			const snap = await withTimeout$1(this.deps.snapshot.getSnapshot({ deviceId: cameraId }), timeoutMs);
 			if (snap === null) this.deps.onError?.("getSnapshot", /* @__PURE__ */ new Error("snapshot returned null"), cameraId);
 			return snap;
 		} catch (err) {
-			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
+			this.deps.onError?.(err instanceof SnapshotTimeoutError$1 ? "snapshotTimeout" : "snapshotMedia", err, cameraId);
 			return null;
 		}
 	}
@@ -46806,6 +46828,66 @@ var SyntheticTrackMaterializer = class {
 		return track;
 	}
 };
+var SnapshotTimeoutError = class extends Error {
+	constructor(ms) {
+		super(`snapshot cap timed out after ${ms}ms`);
+		this.name = "SnapshotTimeoutError";
+	}
+};
+function withTimeout(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(new SnapshotTimeoutError(ms)), ms);
+		promise.then((value) => {
+			clearTimeout(timer);
+			resolve(value);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err instanceof Error ? err : new Error(String(err)));
+		});
+	});
+}
+var MotionEventSnapshotCapturer = class {
+	deps;
+	snapshotTimeoutMs;
+	constructor(deps) {
+		this.deps = deps;
+		this.snapshotTimeoutMs = deps.snapshotTimeoutMs ?? 2500;
+	}
+	/**
+	* Fetch a still and persist it as the motion event's snapshot. Never
+	* throws — the durable record is the motion row, already inserted by
+	* the caller.
+	*/
+	async capture(input) {
+		let snap;
+		try {
+			snap = await withTimeout(this.deps.snapshot.getSnapshot({ deviceId: input.deviceId }), this.snapshotTimeoutMs);
+		} catch (err) {
+			this.deps.onError?.(err instanceof SnapshotTimeoutError ? "snapshotTimeout" : "snapshotFetch", err, input.deviceId);
+			return;
+		}
+		if (snap === null) return;
+		const raw = Buffer.from(snap.base64, "base64");
+		let data = raw;
+		try {
+			data = await downscaleFullFrameJpeg(raw, 960, 540);
+		} catch (err) {
+			this.deps.onError?.("downscaleSnapshot", err, input.deviceId);
+		}
+		try {
+			await this.deps.media.put({
+				deviceId: input.deviceId,
+				ownerKind: "event",
+				ownerId: input.eventId,
+				kind: "snapshot",
+				timestamp: input.timestamp,
+				data
+			});
+		} catch (err) {
+			this.deps.onError?.("snapshotMedia", err, input.deviceId);
+		}
+	}
+};
 var TrackingSettingsSchema = object({
 	/**
 	* How much of a detection's box must lie inside a zone (0-1 fraction of the
@@ -49776,6 +49858,10 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	/** The ONE projector of non-spatial events into synthetic snapshot-carrying
 	*  tracks — linked sensor/control state changes AND audio markers. */
 	syntheticTracks = null;
+	/** Still for a motion row that has no track (events-mode recording without
+	*  a detection). Lands as event-owned `kind: 'snapshot'` so videoclip
+	*  thumbnails resolve through the existing event-media plane. */
+	motionEventSnapshots = null;
 	/** Decides which audio frames deserve a synthetic marker (D62). */
 	audioMarkers = null;
 	faceStore = null;
@@ -50969,6 +51055,17 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			} })
 		});
 		this.syntheticTracks = syntheticTracks;
+		this.motionEventSnapshots = new MotionEventSnapshotCapturer({
+			snapshot: { getSnapshot: (i) => api.snapshot?.getSnapshot.query(i) ?? Promise.resolve(null) },
+			media: mediaStore,
+			onError: (scope, err, deviceId) => logger.warn("motion event snapshot failed", {
+				...deviceId !== void 0 ? { tags: { deviceId } } : {},
+				meta: {
+					scope,
+					error: errMsg(err)
+				}
+			})
+		});
 		this.audioMarkers = new AudioMarkerProjector({
 			sink: syntheticTracks,
 			isMotionActive: (deviceId, atMs, quietMs) => this.isMotionActive(deviceId, atMs, quietMs),
@@ -54039,7 +54136,13 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		const last = this.lastMotionInsertByDevice.get(deviceId);
 		const heartbeatDue = !last || timestamp - last.atMs >= MOTION_EVENT_HEARTBEAT_MS;
 		const transitionedOn = detected && (last === void 0 || last.detected === false);
-		if (!detected) return;
+		if (!detected) {
+			if (last?.detected === true) this.lastMotionInsertByDevice.set(deviceId, {
+				detected: false,
+				atMs: timestamp
+			});
+			return;
+		}
 		if (!transitionedOn && !heartbeatDue) return;
 		const ev = {
 			id: randomUUID(),
@@ -54082,6 +54185,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				timestamp: ev.timestamp
 			}
 		});
+		if (transitionedOn) await this.motionEventSnapshots?.capture({
+			deviceId,
+			eventId: ev.id,
+			timestamp: ev.timestamp
+		});
 	}
 	/**
 	* Persist firmware-driven (onboard) motion events. Mirrors
@@ -54106,7 +54214,13 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		const last = this.lastMotionInsertByDevice.get(deviceId);
 		const heartbeatDue = !last || timestamp - last.atMs >= MOTION_EVENT_HEARTBEAT_MS;
 		const transitionedOn = detected && (last === void 0 || last.detected === false);
-		if (!detected) return;
+		if (!detected) {
+			if (last?.detected === true) this.lastMotionInsertByDevice.set(deviceId, {
+				detected: false,
+				atMs: timestamp
+			});
+			return;
+		}
 		if (!transitionedOn && !heartbeatDue) return;
 		const regions = payload.regions ?? [];
 		const ev = {
@@ -54150,6 +54264,11 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				timestamp: ev.timestamp
 			}
 		});
+		if (transitionedOn) await this.motionEventSnapshots?.capture({
+			deviceId,
+			eventId: ev.id,
+			timestamp: ev.timestamp
+		});
 	}
 	async sweepExpiredTracks() {
 		if (this.shuttingDown || !this.trackStore) return;
@@ -54218,8 +54337,9 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	*
 	*   1. the track sweep, per device, cascading;
 	*   2. the TRACKLESS roots — motion, audio and sensor events, which carry no
-	*      trackId, own nothing and are referenced by nothing, so the cascade can
-	*      never reach them and a clock is the only thing that can.
+	*      trackId and are referenced by nothing, so the cascade can never reach
+	*      them and a clock is the only thing that can. Motion visit stills leave
+	*      with their row inside `evictTracklessBefore`.
 	*
 	* That clock used to be three more settings (`retentionMotionDays` /
 	* `retentionObjectDays` / `retentionAudioDays`). It is now the device's own

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.85",
+  "version": "1.2.86",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",