@camstack/addon-post-analysis 1.2.608 → 1.2.609

package/dist/pipeline-analytics/index.js

@@ -22347,6 +22347,41 @@ function audioDbfsByBucket(events, since, bucketMs) {
 	}
 	return out;
 }
+/**
+* PEAK dBFS per bucket index from device-history points (D431 follow-up).
+*
+* The bar answers "was it loud here", so a bucket reports the loudest window
+* in it. A raw point has `max === value`; a rollup row's `max` is the loudest
+* point it covers, which a mean would flatten. A bucket with no point is
+* absent — never zero. A rollup row also credits a held value across a quiet
+* gap, so its max can echo an earlier measured peak.
+*/
+function audioPeakByBucket(points, since, bucketMs) {
+	const out = /* @__PURE__ */ new Map();
+	if (bucketMs <= 0) return out;
+	for (const p of points) {
+		if (!Number.isFinite(p.max)) continue;
+		const idx = Math.floor((p.t - since) / bucketMs);
+		if (idx < 0) continue;
+		const prev = out.get(idx);
+		if (prev === void 0 || p.max > prev) out.set(idx, p.max);
+	}
+	return out;
+}
+//#endregion
+//#region src/pipeline-analytics/store/analytics-history-keys.ts
+/** Declared addon series keys (D850). */
+var ANALYTICS_HISTORY_BUCKET_SERIES = {
+	motion: "addon:pipeline-analytics/motion",
+	"audio-dbfs": "addon:pipeline-analytics/audio-dbfs",
+	occupancy: "addon:pipeline-analytics/occupancy"
+};
+var ANALYTICS_AUDIO_LEVEL_KEY = "addon:pipeline-analytics/audio-level";
+/** Map the public cap enum to the device-history key (read path). */
+function historyKeyForLtsSeries(series) {
+	if (series === "battery") return "cap:battery.percentage";
+	return ANALYTICS_HISTORY_BUCKET_SERIES[series];
+}
 //#endregion
 //#region src/pipeline-analytics/store/event-store.ts
 /**
@@ -22719,6 +22754,24 @@ function eventRowId(logger, operation, deviceId, key) {
 	});
 	return null;
 }
+var RAW_RETENTION_MS = 7 * 864e5;
+var FIVE_MIN_RETENTION_MS = 14 * 864e5;
+var FIVE_MIN_MS = 3e5;
+var HOUR_MS$2 = 36e5;
+/** The producer writes one raw point per window of this length. */
+var AUDIO_LEVEL_POINT_MS = 1e4;
+var HISTORY_MAX_POINTS = 5e3;
+/**
+* Pick the device-history tier for a density window: raw while the buckets are
+* finer than the 5m rollup, the window is inside raw retention and its points
+* fit one query; the 5m rollup while inside its retention; else 1h.
+*/
+function audioLevelResolution(q, now) {
+	const rawFits = Math.ceil((q.until - q.since) / AUDIO_LEVEL_POINT_MS) <= HISTORY_MAX_POINTS;
+	if (q.bucketMs < FIVE_MIN_MS && rawFits && q.since >= now - RAW_RETENTION_MS) return "raw";
+	if (q.bucketMs < HOUR_MS$2 && q.since >= now - FIVE_MIN_RETENTION_MS) return "5m";
+	return "1h";
+}
 var EventStore = class EventStore {
 	store;
 	logger;
@@ -22726,6 +22779,10 @@ var EventStore = class EventStore {
 	audioLedger;
 	media;
 	onMotionSample;
+	audioLevelHistory;
+	nowFn;
+	/** Cameras whose history read already failed once (log once per camera, D315). */
+	levelFallbackLogged = /* @__PURE__ */ new Set();
 	constructor(deps) {
 		this.store = deps.store;
 		this.logger = deps.logger;
@@ -22734,6 +22791,8 @@ var EventStore = class EventStore {
 		this.audioLedger = deps.audioLedger ?? wireAudioEventLedger(wiring);
 		this.media = deps.media;
 		this.onMotionSample = deps.onMotionSample;
+		this.audioLevelHistory = deps.audioLevelHistory;
+		this.nowFn = deps.now ?? (() => Date.now());
 	}
 	static async declareTracklessEventCollections(store) {
 		await store.declareCollection.mutate({
@@ -23462,8 +23521,8 @@ var EventStore = class EventStore {
 			const m = motionMap.get(i) ?? 0;
 			const o = objectMap.get(i) ?? 0;
 			const a = audioMap.get(i) ?? 0;
-			if (m + o + a === 0) continue;
 			const dbfs = audioDbfsMap.get(i);
+			if (m + o + a === 0 && dbfs === void 0) continue;
 			out.push({
 				bucketStart: q.since + i * q.bucketMs,
 				motion: m,
@@ -23484,6 +23543,28 @@ var EventStore = class EventStore {
 	* missing bar is the honest rendering of "not measured" (D431).
 	*/
 	async audioDbfsPerBucket(q) {
+		const history = this.audioLevelHistory;
+		if (history !== void 0) try {
+			const resolution = audioLevelResolution(q, this.nowFn());
+			const points = (await history({
+				deviceId: q.deviceId,
+				key: ANALYTICS_AUDIO_LEVEL_KEY,
+				scope: "",
+				from: q.since,
+				to: q.until,
+				resolution,
+				maxPoints: HISTORY_MAX_POINTS
+			})).series.flatMap((s) => s.points);
+			if (points.length > 0) return audioPeakByBucket(points, q.since, q.bucketMs);
+		} catch (err) {
+			if (!this.levelFallbackLogged.has(q.deviceId)) {
+				this.levelFallbackLogged.add(q.deviceId);
+				this.logger.warn("density: audio level history unreadable — falling back to audio events", {
+					tags: { deviceId: q.deviceId },
+					meta: { error: String(err) }
+				});
+			}
+		}
 		try {
 			return audioDbfsByBucket((await this.queryAudio({
 				deviceId: q.deviceId,
@@ -111555,20 +111636,6 @@ var MigrationMarkerStore = class MigrationMarkerStore {
 	};
 };
 //#endregion
-//#region src/pipeline-analytics/store/analytics-history-keys.ts
-/** Declared addon series keys (D850). */
-var ANALYTICS_HISTORY_BUCKET_SERIES = {
-	motion: "addon:pipeline-analytics/motion",
-	"audio-dbfs": "addon:pipeline-analytics/audio-dbfs",
-	occupancy: "addon:pipeline-analytics/occupancy"
-};
-var ANALYTICS_AUDIO_LEVEL_KEY = "addon:pipeline-analytics/audio-level";
-/** Map the public cap enum to the device-history key (read path). */
-function historyKeyForLtsSeries(series) {
-	if (series === "battery") return "cap:battery.percentage";
-	return ANALYTICS_HISTORY_BUCKET_SERIES[series];
-}
-//#endregion
 //#region src/pipeline-analytics/store/analytics-history-producer.ts
 var BUCKET_SERIES_META = [
 	{
@@ -111590,6 +111657,10 @@ var AUDIO_LEVEL_SERIES = {
 	displayName: "Audio level (dBFS)",
 	unit: "dBFS"
 };
+/** One audio level point per window; equals device-history's 1 point / 10 s record bound. */
+var AUDIO_LEVEL_WINDOW_MS = 1e4;
+/** Stored for a measured-silent window (−∞ dBFS cannot be a history value). */
+var AUDIO_LEVEL_SILENT_DBFS = -120;
 function refusalCounts(result) {
 	const counts = {};
 	for (const r of result.refused) counts[r.reason] = (counts[r.reason] ?? 0) + r.count;
@@ -111601,6 +111672,7 @@ var AnalyticsHistoryProducer = class {
 	logger;
 	nowFn;
 	declared = false;
+	levelWindows = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deviceHistory = deps.deviceHistory;
 		this.logger = deps.logger;
@@ -111633,6 +111705,43 @@ var AnalyticsHistoryProducer = class {
 			deviceId
 		}, scope ?? "", value, at ?? this.nowFn());
 	}
+	/**
+	* Feed EVERY analysed audio sample. One point per window of
+	* {@link AUDIO_LEVEL_WINDOW_MS} is written, stamped at the window's first
+	* sample, carrying the window's PEAK dBFS: a 2 s spike inside a stable window
+	* is not averaged away, and stable audio still yields a point each window
+	* (continuity over dedup — the level bar draws a continuous line).
+	*
+	* Measured silence (−∞) is stored at {@link AUDIO_LEVEL_SILENT_DBFS}: it is a
+	* measurement, not an absence (D431); NaN carries no claim and is dropped.
+	* A window closes on the first sample past its end, so no timer is needed and
+	* points are always at least a window apart (the history's 1 point / 10 s
+	* bound).
+	*/
+	observeAudioLevel(deviceId, dbfs, at) {
+		if (Number.isNaN(dbfs)) return;
+		const value = Number.isFinite(dbfs) ? dbfs : AUDIO_LEVEL_SILENT_DBFS;
+		const win = this.levelWindows.get(deviceId);
+		if (win === void 0) {
+			this.levelWindows.set(deviceId, {
+				start: at,
+				peak: value
+			});
+			return;
+		}
+		if (at - win.start < AUDIO_LEVEL_WINDOW_MS) {
+			if (value > win.peak) this.levelWindows.set(deviceId, {
+				start: win.start,
+				peak: value
+			});
+			return;
+		}
+		this.levelWindows.set(deviceId, {
+			start: at,
+			peak: value
+		});
+		this.recordAudioLevel(deviceId, win.peak, win.start);
+	}
 	recordAudioLevel(deviceId, dbfs, at) {
 		const record = this.deviceHistory.record;
 		if (record === void 0) return;
@@ -116595,6 +116704,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		const eventStore = new EventStore({
 			store: api.settingsStore,
 			logger: logger.child("EventStore"),
+			audioLevelHistory: (input) => api.deviceHistory.query.query(input),
 			motionLedger: wireMotionEventLedger(eventLedgerWiring),
 			audioLedger: wireAudioEventLedger(eventLedgerWiring),
 			onMotionSample: (deviceId, regionCount, at) => lts.note("motion", deviceId, regionCount, at),
@@ -122070,6 +122180,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				score: topClassification.score
 			} : {}
 		}, this.audioMarkerConfig(settings));
+		if (level !== void 0) this.lts?.observeAudioLevel(deviceId, level.dbfs, timestamp);
 		this.notificationCenter?.observeAudio(deviceId, ncAudioSampleFromFrame(frame, timestamp, settings));
 		const route = classifyAudioFrame(topClassification ? {
 			className: topClassification.macroClass,
@@ -122145,8 +122256,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		});
 		this.levelStateByDevice.set(deviceId, res.nextState);
 		if (!res.emit) return;
-		const dbfs = level?.dbfs ?? Number.NEGATIVE_INFINITY;
-		this.lts?.recordAudioLevel(deviceId, dbfs, timestamp);
 	}
 	/**
 	* Persist motion-analysis bus events into the EPISODE tracker (D475): a

package/dist/pipeline-analytics/index.mjs

@@ -22339,6 +22339,41 @@ function audioDbfsByBucket(events, since, bucketMs) {
 	}
 	return out;
 }
+/**
+* PEAK dBFS per bucket index from device-history points (D431 follow-up).
+*
+* The bar answers "was it loud here", so a bucket reports the loudest window
+* in it. A raw point has `max === value`; a rollup row's `max` is the loudest
+* point it covers, which a mean would flatten. A bucket with no point is
+* absent — never zero. A rollup row also credits a held value across a quiet
+* gap, so its max can echo an earlier measured peak.
+*/
+function audioPeakByBucket(points, since, bucketMs) {
+	const out = /* @__PURE__ */ new Map();
+	if (bucketMs <= 0) return out;
+	for (const p of points) {
+		if (!Number.isFinite(p.max)) continue;
+		const idx = Math.floor((p.t - since) / bucketMs);
+		if (idx < 0) continue;
+		const prev = out.get(idx);
+		if (prev === void 0 || p.max > prev) out.set(idx, p.max);
+	}
+	return out;
+}
+//#endregion
+//#region src/pipeline-analytics/store/analytics-history-keys.ts
+/** Declared addon series keys (D850). */
+var ANALYTICS_HISTORY_BUCKET_SERIES = {
+	motion: "addon:pipeline-analytics/motion",
+	"audio-dbfs": "addon:pipeline-analytics/audio-dbfs",
+	occupancy: "addon:pipeline-analytics/occupancy"
+};
+var ANALYTICS_AUDIO_LEVEL_KEY = "addon:pipeline-analytics/audio-level";
+/** Map the public cap enum to the device-history key (read path). */
+function historyKeyForLtsSeries(series) {
+	if (series === "battery") return "cap:battery.percentage";
+	return ANALYTICS_HISTORY_BUCKET_SERIES[series];
+}
 //#endregion
 //#region src/pipeline-analytics/store/event-store.ts
 /**
@@ -22711,6 +22746,24 @@ function eventRowId(logger, operation, deviceId, key) {
 	});
 	return null;
 }
+var RAW_RETENTION_MS = 7 * 864e5;
+var FIVE_MIN_RETENTION_MS = 14 * 864e5;
+var FIVE_MIN_MS = 3e5;
+var HOUR_MS$2 = 36e5;
+/** The producer writes one raw point per window of this length. */
+var AUDIO_LEVEL_POINT_MS = 1e4;
+var HISTORY_MAX_POINTS = 5e3;
+/**
+* Pick the device-history tier for a density window: raw while the buckets are
+* finer than the 5m rollup, the window is inside raw retention and its points
+* fit one query; the 5m rollup while inside its retention; else 1h.
+*/
+function audioLevelResolution(q, now) {
+	const rawFits = Math.ceil((q.until - q.since) / AUDIO_LEVEL_POINT_MS) <= HISTORY_MAX_POINTS;
+	if (q.bucketMs < FIVE_MIN_MS && rawFits && q.since >= now - RAW_RETENTION_MS) return "raw";
+	if (q.bucketMs < HOUR_MS$2 && q.since >= now - FIVE_MIN_RETENTION_MS) return "5m";
+	return "1h";
+}
 var EventStore = class EventStore {
 	store;
 	logger;
@@ -22718,6 +22771,10 @@ var EventStore = class EventStore {
 	audioLedger;
 	media;
 	onMotionSample;
+	audioLevelHistory;
+	nowFn;
+	/** Cameras whose history read already failed once (log once per camera, D315). */
+	levelFallbackLogged = /* @__PURE__ */ new Set();
 	constructor(deps) {
 		this.store = deps.store;
 		this.logger = deps.logger;
@@ -22726,6 +22783,8 @@ var EventStore = class EventStore {
 		this.audioLedger = deps.audioLedger ?? wireAudioEventLedger(wiring);
 		this.media = deps.media;
 		this.onMotionSample = deps.onMotionSample;
+		this.audioLevelHistory = deps.audioLevelHistory;
+		this.nowFn = deps.now ?? (() => Date.now());
 	}
 	static async declareTracklessEventCollections(store) {
 		await store.declareCollection.mutate({
@@ -23454,8 +23513,8 @@ var EventStore = class EventStore {
 			const m = motionMap.get(i) ?? 0;
 			const o = objectMap.get(i) ?? 0;
 			const a = audioMap.get(i) ?? 0;
-			if (m + o + a === 0) continue;
 			const dbfs = audioDbfsMap.get(i);
+			if (m + o + a === 0 && dbfs === void 0) continue;
 			out.push({
 				bucketStart: q.since + i * q.bucketMs,
 				motion: m,
@@ -23476,6 +23535,28 @@ var EventStore = class EventStore {
 	* missing bar is the honest rendering of "not measured" (D431).
 	*/
 	async audioDbfsPerBucket(q) {
+		const history = this.audioLevelHistory;
+		if (history !== void 0) try {
+			const resolution = audioLevelResolution(q, this.nowFn());
+			const points = (await history({
+				deviceId: q.deviceId,
+				key: ANALYTICS_AUDIO_LEVEL_KEY,
+				scope: "",
+				from: q.since,
+				to: q.until,
+				resolution,
+				maxPoints: HISTORY_MAX_POINTS
+			})).series.flatMap((s) => s.points);
+			if (points.length > 0) return audioPeakByBucket(points, q.since, q.bucketMs);
+		} catch (err) {
+			if (!this.levelFallbackLogged.has(q.deviceId)) {
+				this.levelFallbackLogged.add(q.deviceId);
+				this.logger.warn("density: audio level history unreadable — falling back to audio events", {
+					tags: { deviceId: q.deviceId },
+					meta: { error: String(err) }
+				});
+			}
+		}
 		try {
 			return audioDbfsByBucket((await this.queryAudio({
 				deviceId: q.deviceId,
@@ -111460,20 +111541,6 @@ var MigrationMarkerStore = class MigrationMarkerStore {
 	};
 };
 //#endregion
-//#region src/pipeline-analytics/store/analytics-history-keys.ts
-/** Declared addon series keys (D850). */
-var ANALYTICS_HISTORY_BUCKET_SERIES = {
-	motion: "addon:pipeline-analytics/motion",
-	"audio-dbfs": "addon:pipeline-analytics/audio-dbfs",
-	occupancy: "addon:pipeline-analytics/occupancy"
-};
-var ANALYTICS_AUDIO_LEVEL_KEY = "addon:pipeline-analytics/audio-level";
-/** Map the public cap enum to the device-history key (read path). */
-function historyKeyForLtsSeries(series) {
-	if (series === "battery") return "cap:battery.percentage";
-	return ANALYTICS_HISTORY_BUCKET_SERIES[series];
-}
-//#endregion
 //#region src/pipeline-analytics/store/analytics-history-producer.ts
 var BUCKET_SERIES_META = [
 	{
@@ -111495,6 +111562,10 @@ var AUDIO_LEVEL_SERIES = {
 	displayName: "Audio level (dBFS)",
 	unit: "dBFS"
 };
+/** One audio level point per window; equals device-history's 1 point / 10 s record bound. */
+var AUDIO_LEVEL_WINDOW_MS = 1e4;
+/** Stored for a measured-silent window (−∞ dBFS cannot be a history value). */
+var AUDIO_LEVEL_SILENT_DBFS = -120;
 function refusalCounts(result) {
 	const counts = {};
 	for (const r of result.refused) counts[r.reason] = (counts[r.reason] ?? 0) + r.count;
@@ -111506,6 +111577,7 @@ var AnalyticsHistoryProducer = class {
 	logger;
 	nowFn;
 	declared = false;
+	levelWindows = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deviceHistory = deps.deviceHistory;
 		this.logger = deps.logger;
@@ -111538,6 +111610,43 @@ var AnalyticsHistoryProducer = class {
 			deviceId
 		}, scope ?? "", value, at ?? this.nowFn());
 	}
+	/**
+	* Feed EVERY analysed audio sample. One point per window of
+	* {@link AUDIO_LEVEL_WINDOW_MS} is written, stamped at the window's first
+	* sample, carrying the window's PEAK dBFS: a 2 s spike inside a stable window
+	* is not averaged away, and stable audio still yields a point each window
+	* (continuity over dedup — the level bar draws a continuous line).
+	*
+	* Measured silence (−∞) is stored at {@link AUDIO_LEVEL_SILENT_DBFS}: it is a
+	* measurement, not an absence (D431); NaN carries no claim and is dropped.
+	* A window closes on the first sample past its end, so no timer is needed and
+	* points are always at least a window apart (the history's 1 point / 10 s
+	* bound).
+	*/
+	observeAudioLevel(deviceId, dbfs, at) {
+		if (Number.isNaN(dbfs)) return;
+		const value = Number.isFinite(dbfs) ? dbfs : AUDIO_LEVEL_SILENT_DBFS;
+		const win = this.levelWindows.get(deviceId);
+		if (win === void 0) {
+			this.levelWindows.set(deviceId, {
+				start: at,
+				peak: value
+			});
+			return;
+		}
+		if (at - win.start < AUDIO_LEVEL_WINDOW_MS) {
+			if (value > win.peak) this.levelWindows.set(deviceId, {
+				start: win.start,
+				peak: value
+			});
+			return;
+		}
+		this.levelWindows.set(deviceId, {
+			start: at,
+			peak: value
+		});
+		this.recordAudioLevel(deviceId, win.peak, win.start);
+	}
 	recordAudioLevel(deviceId, dbfs, at) {
 		const record = this.deviceHistory.record;
 		if (record === void 0) return;
@@ -116500,6 +116609,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		const eventStore = new EventStore({
 			store: api.settingsStore,
 			logger: logger.child("EventStore"),
+			audioLevelHistory: (input) => api.deviceHistory.query.query(input),
 			motionLedger: wireMotionEventLedger(eventLedgerWiring),
 			audioLedger: wireAudioEventLedger(eventLedgerWiring),
 			onMotionSample: (deviceId, regionCount, at) => lts.note("motion", deviceId, regionCount, at),
@@ -121975,6 +122085,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				score: topClassification.score
 			} : {}
 		}, this.audioMarkerConfig(settings));
+		if (level !== void 0) this.lts?.observeAudioLevel(deviceId, level.dbfs, timestamp);
 		this.notificationCenter?.observeAudio(deviceId, ncAudioSampleFromFrame(frame, timestamp, settings));
 		const route = classifyAudioFrame(topClassification ? {
 			className: topClassification.macroClass,
@@ -122050,8 +122161,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		});
 		this.levelStateByDevice.set(deviceId, res.nextState);
 		if (!res.emit) return;
-		const dbfs = level?.dbfs ?? Number.NEGATIVE_INFINITY;
-		this.lts?.recordAudioLevel(deviceId, dbfs, timestamp);
 	}
 	/**
 	* Persist motion-analysis bus events into the EPISODE tracker (D475): a

package/package.json

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