@camstack/addon-provider-dreame 0.2.93 → 0.2.94

package/dist/addon.js

@@ -72605,7 +72605,17 @@ var EventDensityBucketSchema = object({
 	bucketStart: number(),
 	motion: number().int(),
 	object: number().int(),
-	audio: number().int()
+	audio: number().int(),
+	/**
+	* Energy-weighted mean dBFS of the audio events in this bucket — the LEVEL,
+	* as opposed to `audio`, which is their COUNT (D431).
+	*
+	* ABSENT when the bucket holds no audio event. Absence means "nothing was
+	* measured", which is not the same claim as silence, and a lane that cannot
+	* tell them apart paints a quiet hour at full scale — which is exactly what
+	* the count-on-a-level-meter did.
+	*/
+	audioDbfs: number().optional()
 });
 /**
 * One camera's row in a `getEventDensityBatch` answer.
@@ -82793,7 +82803,23 @@ var RecordingRangeSchema = object({
 });
 var RecordingAvailabilitySchema = object({
 	deviceId: number(),
-	ranges: array(RecordingRangeSchema)
+	ranges: array(RecordingRangeSchema),
+	/**
+	* Every profile this camera has footage in — not only the one `ranges`
+	* describes (D433).
+	*
+	* `ranges` answers for ONE profile by design: the timeline is a single bar,
+	* and enumerating all of them triples the directory reads for a bar that
+	* would look identical. But the answer used to say nothing about that, so a
+	* caller asking "what can I export?" read the single preferred profile as
+	* the only one that exists — on this deployment every camera records `high`
+	* AND `low`, the low tree holding 14 GB for camera 615 alone, and the export
+	* UI could not see it.
+	*
+	* Cheap: it is the same shallow directory read the profile CHOICE already
+	* makes. Ask for a specific profile's ranges with the `profile` input.
+	*/
+	profilesWithFootage: array(string())
 });
 var RecordingDaysSchema = object({
 	deviceId: number(),
@@ -82819,7 +82845,11 @@ var RecordingDaysSchema = object({
 var RecordingAvailabilityForDeviceSchema = object({
 	deviceId: number(),
 	read: _enum(["read", "unreadable"]),
-	ranges: array(RecordingRangeSchema).readonly()
+	ranges: array(RecordingRangeSchema).readonly(),
+	/** Same field, same meaning, as the singular answer (D433). A row that
+	*  dropped it would tell a grid caller the archive holds one profile.
+	*  Empty on an `'unreadable'` row: nobody looked. */
+	profilesWithFootage: array(string()).readonly()
 });
 /**
 * One camera's row in a `getDaysWithRecordingsBatch` answer. Same rule as
@@ -83109,7 +83139,14 @@ var ReadWindowBytesResultSchema = discriminatedUnion("kind", [object({
 method(object({
 	deviceId: number(),
 	fromMs: number(),
-	toMs: number()
+	toMs: number(),
+	/**
+	* Answer for THIS profile instead of the preferred one (D433). Absent
+	* keeps the timeline's behaviour — one bar, one profile, one set of
+	* reads. `profilesWithFootage` on the answer says what may be asked
+	* for.
+	*/
+	profile: string().optional()
 }), RecordingAvailabilitySchema, {
 	kind: "query",
 	auth: "protected"
@@ -98475,7 +98512,7 @@ function dreameNavigationCatalog(disabledEntryIds = DREAME_NAVIGATION_DISABLED_E
 function resolveNavigationFeatures(overrides) {
 	return {
 		...DREAME_NAVIGATION_DEFAULT_FEATURES,
-		...overrides?.features ?? {}
+		...overrides?.features
 	};
 }
 /** The disabled entry ids in force for ONE device: the addon set plus its own. */
@@ -98585,7 +98622,7 @@ var DreameNetworkLinkMonitor = class {
 				meta: {
 					reason,
 					rawBars: bars,
-					...next ?? {}
+					...next
 				}
 			});
 			this.reported = true;
@@ -144203,6 +144240,10 @@ async function startRfc4571Server(params) {
 	const firstLoss = deferred();
 	let pendingLoss = null;
 	let toreDown = false;
+	let audioFrames = 0;
+	let videoAccessUnits = 0;
+	let lastAudioAt = 0;
+	let audioStallReported = false;
 	let serving = false;
 	let lastVideoAt = 0;
 	const reportLoss = (loss) => {
@@ -144256,9 +144297,11 @@ async function startRfc4571Server(params) {
 		await stream.stop().catch(() => void 0);
 		throw err;
 	}
+	const graceStartedAt = Date.now();
 	await Promise.race([firstAudio.promise, new Promise((resolve) => {
 		setTimeout(resolve, audioGraceMs).unref?.();
 	})]);
+	const waitedMs = Date.now() - graceStartedAt;
 	if (pendingLoss !== null) {
 		await stream.stop().catch(() => void 0);
 		throw new Error(`relay lost before the server was up (${describeLoss(pendingLoss)})`);
@@ -144278,8 +144321,38 @@ async function startRfc4571Server(params) {
 		configHex: audioFacts.configHex
 	} : void 0);
 	const muxer = new Rfc4571Muxer(consoleInto(logger), VIDEO_PT, audioFacts !== null ? AUDIO_PT : void 0);
-	stream.on("videoAccessUnit", (e) => muxer.sendVideoAccessUnit("H264", e.data, e.isKeyframe, e.microseconds));
-	if (audioFacts !== null) stream.on("audioFrame", (adts) => muxer.sendAudioAdtsFrame(adts));
+	stream.on("videoAccessUnit", (e) => {
+		videoAccessUnits += 1;
+		muxer.sendVideoAccessUnit("H264", e.data, e.isKeyframe, e.microseconds);
+	});
+	if (audioFacts !== null) {
+		logger.info("rfc4571: serving audio", { meta: {
+			codec: "aac",
+			sampleRate: audioFacts.sampleRate,
+			channels: audioFacts.channels,
+			waitedMs
+		} });
+		lastAudioAt = Date.now();
+		stream.on("audioFrame", (adts) => {
+			audioFrames += 1;
+			lastAudioAt = Date.now();
+			muxer.sendAudioAdtsFrame(adts);
+		});
+	} else {
+		logger.info("rfc4571: no audio within the grace — serving video-only", { meta: {
+			waitedMs,
+			audioGraceMs
+		} });
+		let reportedLate = false;
+		stream.on("audioFrame", () => {
+			if (reportedLate) return;
+			reportedLate = true;
+			logger.warn("rfc4571: audio arrived after the grace — this session stays video-only", { meta: {
+				lateByMs: Date.now() - graceStartedAt - waitedMs,
+				audioGraceMs
+			} });
+		});
+	}
 	let liveClients = 0;
 	let idleTimer = null;
 	const server = node_net.default.createServer((socket) => {
@@ -144309,7 +144382,16 @@ async function startRfc4571Server(params) {
 	const addr = server.address();
 	if (addr === null || typeof addr === "string") throw new Error("failed to bind the RFC4571 server");
 	const stallSweep = setInterval(() => {
-		if (toreDown || Date.now() - lastVideoAt < stallTimeoutMs) return;
+		if (toreDown) return;
+		if (audioFacts !== null && !audioStallReported && Date.now() - lastAudioAt >= stallTimeoutMs) {
+			audioStallReported = true;
+			logger.warn("rfc4571: audio stopped while the video kept flowing", { meta: {
+				audioFrames,
+				videoAccessUnits,
+				silentForMs: Date.now() - lastAudioAt
+			} });
+		}
+		if (Date.now() - lastVideoAt < stallTimeoutMs) return;
 		reportLoss({
 			reason: "stalled",
 			error: null
@@ -144328,6 +144410,11 @@ async function startRfc4571Server(params) {
 		} : null,
 		close: async () => {
 			toreDown = true;
+			logger.info("rfc4571: session ended", { meta: {
+				videoAccessUnits,
+				audioFrames,
+				declaredAudio: audioFacts !== null
+			} });
 			clearInterval(stallSweep);
 			if (idleTimer !== null) clearTimeout(idleTimer);
 			try {

package/dist/addon.mjs

@@ -72602,7 +72602,17 @@ var EventDensityBucketSchema = object({
 	bucketStart: number(),
 	motion: number().int(),
 	object: number().int(),
-	audio: number().int()
+	audio: number().int(),
+	/**
+	* Energy-weighted mean dBFS of the audio events in this bucket — the LEVEL,
+	* as opposed to `audio`, which is their COUNT (D431).
+	*
+	* ABSENT when the bucket holds no audio event. Absence means "nothing was
+	* measured", which is not the same claim as silence, and a lane that cannot
+	* tell them apart paints a quiet hour at full scale — which is exactly what
+	* the count-on-a-level-meter did.
+	*/
+	audioDbfs: number().optional()
 });
 /**
 * One camera's row in a `getEventDensityBatch` answer.
@@ -82790,7 +82800,23 @@ var RecordingRangeSchema = object({
 });
 var RecordingAvailabilitySchema = object({
 	deviceId: number(),
-	ranges: array(RecordingRangeSchema)
+	ranges: array(RecordingRangeSchema),
+	/**
+	* Every profile this camera has footage in — not only the one `ranges`
+	* describes (D433).
+	*
+	* `ranges` answers for ONE profile by design: the timeline is a single bar,
+	* and enumerating all of them triples the directory reads for a bar that
+	* would look identical. But the answer used to say nothing about that, so a
+	* caller asking "what can I export?" read the single preferred profile as
+	* the only one that exists — on this deployment every camera records `high`
+	* AND `low`, the low tree holding 14 GB for camera 615 alone, and the export
+	* UI could not see it.
+	*
+	* Cheap: it is the same shallow directory read the profile CHOICE already
+	* makes. Ask for a specific profile's ranges with the `profile` input.
+	*/
+	profilesWithFootage: array(string())
 });
 var RecordingDaysSchema = object({
 	deviceId: number(),
@@ -82816,7 +82842,11 @@ var RecordingDaysSchema = object({
 var RecordingAvailabilityForDeviceSchema = object({
 	deviceId: number(),
 	read: _enum(["read", "unreadable"]),
-	ranges: array(RecordingRangeSchema).readonly()
+	ranges: array(RecordingRangeSchema).readonly(),
+	/** Same field, same meaning, as the singular answer (D433). A row that
+	*  dropped it would tell a grid caller the archive holds one profile.
+	*  Empty on an `'unreadable'` row: nobody looked. */
+	profilesWithFootage: array(string()).readonly()
 });
 /**
 * One camera's row in a `getDaysWithRecordingsBatch` answer. Same rule as
@@ -83106,7 +83136,14 @@ var ReadWindowBytesResultSchema = discriminatedUnion("kind", [object({
 method(object({
 	deviceId: number(),
 	fromMs: number(),
-	toMs: number()
+	toMs: number(),
+	/**
+	* Answer for THIS profile instead of the preferred one (D433). Absent
+	* keeps the timeline's behaviour — one bar, one profile, one set of
+	* reads. `profilesWithFootage` on the answer says what may be asked
+	* for.
+	*/
+	profile: string().optional()
 }), RecordingAvailabilitySchema, {
 	kind: "query",
 	auth: "protected"
@@ -98472,7 +98509,7 @@ function dreameNavigationCatalog(disabledEntryIds = DREAME_NAVIGATION_DISABLED_E
 function resolveNavigationFeatures(overrides) {
 	return {
 		...DREAME_NAVIGATION_DEFAULT_FEATURES,
-		...overrides?.features ?? {}
+		...overrides?.features
 	};
 }
 /** The disabled entry ids in force for ONE device: the addon set plus its own. */
@@ -98582,7 +98619,7 @@ var DreameNetworkLinkMonitor = class {
 				meta: {
 					reason,
 					rawBars: bars,
-					...next ?? {}
+					...next
 				}
 			});
 			this.reported = true;
@@ -144200,6 +144237,10 @@ async function startRfc4571Server(params) {
 	const firstLoss = deferred();
 	let pendingLoss = null;
 	let toreDown = false;
+	let audioFrames = 0;
+	let videoAccessUnits = 0;
+	let lastAudioAt = 0;
+	let audioStallReported = false;
 	let serving = false;
 	let lastVideoAt = 0;
 	const reportLoss = (loss) => {
@@ -144253,9 +144294,11 @@ async function startRfc4571Server(params) {
 		await stream.stop().catch(() => void 0);
 		throw err;
 	}
+	const graceStartedAt = Date.now();
 	await Promise.race([firstAudio.promise, new Promise((resolve) => {
 		setTimeout(resolve, audioGraceMs).unref?.();
 	})]);
+	const waitedMs = Date.now() - graceStartedAt;
 	if (pendingLoss !== null) {
 		await stream.stop().catch(() => void 0);
 		throw new Error(`relay lost before the server was up (${describeLoss(pendingLoss)})`);
@@ -144275,8 +144318,38 @@ async function startRfc4571Server(params) {
 		configHex: audioFacts.configHex
 	} : void 0);
 	const muxer = new Rfc4571Muxer(consoleInto(logger), VIDEO_PT, audioFacts !== null ? AUDIO_PT : void 0);
-	stream.on("videoAccessUnit", (e) => muxer.sendVideoAccessUnit("H264", e.data, e.isKeyframe, e.microseconds));
-	if (audioFacts !== null) stream.on("audioFrame", (adts) => muxer.sendAudioAdtsFrame(adts));
+	stream.on("videoAccessUnit", (e) => {
+		videoAccessUnits += 1;
+		muxer.sendVideoAccessUnit("H264", e.data, e.isKeyframe, e.microseconds);
+	});
+	if (audioFacts !== null) {
+		logger.info("rfc4571: serving audio", { meta: {
+			codec: "aac",
+			sampleRate: audioFacts.sampleRate,
+			channels: audioFacts.channels,
+			waitedMs
+		} });
+		lastAudioAt = Date.now();
+		stream.on("audioFrame", (adts) => {
+			audioFrames += 1;
+			lastAudioAt = Date.now();
+			muxer.sendAudioAdtsFrame(adts);
+		});
+	} else {
+		logger.info("rfc4571: no audio within the grace — serving video-only", { meta: {
+			waitedMs,
+			audioGraceMs
+		} });
+		let reportedLate = false;
+		stream.on("audioFrame", () => {
+			if (reportedLate) return;
+			reportedLate = true;
+			logger.warn("rfc4571: audio arrived after the grace — this session stays video-only", { meta: {
+				lateByMs: Date.now() - graceStartedAt - waitedMs,
+				audioGraceMs
+			} });
+		});
+	}
 	let liveClients = 0;
 	let idleTimer = null;
 	const server = net.createServer((socket) => {
@@ -144306,7 +144379,16 @@ async function startRfc4571Server(params) {
 	const addr = server.address();
 	if (addr === null || typeof addr === "string") throw new Error("failed to bind the RFC4571 server");
 	const stallSweep = setInterval(() => {
-		if (toreDown || Date.now() - lastVideoAt < stallTimeoutMs) return;
+		if (toreDown) return;
+		if (audioFacts !== null && !audioStallReported && Date.now() - lastAudioAt >= stallTimeoutMs) {
+			audioStallReported = true;
+			logger.warn("rfc4571: audio stopped while the video kept flowing", { meta: {
+				audioFrames,
+				videoAccessUnits,
+				silentForMs: Date.now() - lastAudioAt
+			} });
+		}
+		if (Date.now() - lastVideoAt < stallTimeoutMs) return;
 		reportLoss({
 			reason: "stalled",
 			error: null
@@ -144325,6 +144407,11 @@ async function startRfc4571Server(params) {
 		} : null,
 		close: async () => {
 			toreDown = true;
+			logger.info("rfc4571: session ended", { meta: {
+				videoAccessUnits,
+				audioFrames,
+				declaredAudio: audioFacts !== null
+			} });
 			clearInterval(stallSweep);
 			if (idleTimer !== null) clearTimeout(idleTimer);
 			try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-dreame",
-  "version": "0.2.93",
+  "version": "0.2.94",
   "description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
   "keywords": [
     "camstack",