@camstack/addon-provider-dreame 0.2.93 → 0.2.95

package/dist/addon.js

@@ -69160,6 +69160,7 @@ var NcSystemEventKindSchema = _enum([
 	"addon-crash-loop",
 	"addon-update-available",
 	"server-update-available",
+	"wrapper-update-available",
 	"alarm-triggered",
 	"alarm-armed",
 	"alarm-disarmed",
@@ -72605,7 +72606,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.
@@ -74706,6 +74717,53 @@ var ImageContractSchema = object({
 	/** One operator-grade sentence: this node runs image X; the contract says Y. */
 	message: string()
 });
+/**
+* The shell verdict (see {@link WrapperKindSchema}) with the proofs that
+* produced it.
+*
+* There is deliberately NO `canSelfUpdate` and no apply action: a wrapper
+* update is an ANNOUNCEMENT. The notification body carries the exact command
+* for a `docker` shell and says the app restarts into the new build for
+* `electron`, and that sentence is chosen from `kind` alone — a boolean
+* nothing reads is the defect this repo keeps paying for.
+*/
+var WrapperIdentitySchema = object({
+	kind: _enum([
+		"docker",
+		"electron",
+		"native",
+		"contradictory",
+		"unknown"
+	]),
+	/** Every probe that ran, in a stable order. Never empty. */
+	evidence: array(object({
+		/** Which probe this row reports. */
+		fact: _enum([
+			"dockerenv-file",
+			"proc-1-cgroup",
+			"platform",
+			"electron-app-version-env"
+		]),
+		/**
+		* `observed` — this process read it itself. `declared` — the shell told the
+		* process and nothing here can check it. Only the Electron app version is
+		* ever `declared`, and only because a child cannot see its parent.
+		*/
+		mode: _enum(["observed", "declared"]),
+		/** Did the probe support the fact it names? A `false` row is still evidence. */
+		holds: boolean(),
+		/** What was actually read, verbatim enough for an operator to argue with. */
+		detail: string()
+	})),
+	/**
+	* The version of the SHELL, when the shell has one it can state: the
+	* Electron app version it declared, or the baked seed closure that
+	* fingerprints a container / app bundle. `null` for `contradictory` and
+	* `unknown` — which version belongs to the shell is precisely what is not
+	* known there.
+	*/
+	currentVersion: string().nullable()
+});
 var ServerRollbackInfoSchema = object({
 	/** The version that failed (or was manually rolled back). */
 	fromVersion: string(),
@@ -74747,7 +74805,13 @@ var ServerPackageStatusSchema = object({
 	* Seed-vs-contract verdict (see {@link ImageContractSchema}). Optional for
 	* version skew: an older provider's payload simply omits it.
 	*/
-	imageContract: ImageContractSchema.optional()
+	imageContract: ImageContractSchema.optional(),
+	/**
+	* What this node runs INSIDE (see {@link WrapperIdentitySchema}). Optional
+	* for version skew: an older provider's payload simply omits it, and an
+	* absent wrapper is unknown — never `native`.
+	*/
+	wrapper: WrapperIdentitySchema.optional()
 });
 var ServerUpdateCheckResultSchema = object({
 	packageName: string(),
@@ -82793,7 +82857,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 +82899,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 +83193,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 +98566,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 +98676,7 @@ var DreameNetworkLinkMonitor = class {
 				meta: {
 					reason,
 					rawBars: bars,
-					...next ?? {}
+					...next
 				}
 			});
 			this.reported = true;
@@ -144203,6 +144294,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 +144351,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 +144375,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 +144436,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 +144464,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

@@ -69157,6 +69157,7 @@ var NcSystemEventKindSchema = _enum([
 	"addon-crash-loop",
 	"addon-update-available",
 	"server-update-available",
+	"wrapper-update-available",
 	"alarm-triggered",
 	"alarm-armed",
 	"alarm-disarmed",
@@ -72602,7 +72603,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.
@@ -74703,6 +74714,53 @@ var ImageContractSchema = object({
 	/** One operator-grade sentence: this node runs image X; the contract says Y. */
 	message: string()
 });
+/**
+* The shell verdict (see {@link WrapperKindSchema}) with the proofs that
+* produced it.
+*
+* There is deliberately NO `canSelfUpdate` and no apply action: a wrapper
+* update is an ANNOUNCEMENT. The notification body carries the exact command
+* for a `docker` shell and says the app restarts into the new build for
+* `electron`, and that sentence is chosen from `kind` alone — a boolean
+* nothing reads is the defect this repo keeps paying for.
+*/
+var WrapperIdentitySchema = object({
+	kind: _enum([
+		"docker",
+		"electron",
+		"native",
+		"contradictory",
+		"unknown"
+	]),
+	/** Every probe that ran, in a stable order. Never empty. */
+	evidence: array(object({
+		/** Which probe this row reports. */
+		fact: _enum([
+			"dockerenv-file",
+			"proc-1-cgroup",
+			"platform",
+			"electron-app-version-env"
+		]),
+		/**
+		* `observed` — this process read it itself. `declared` — the shell told the
+		* process and nothing here can check it. Only the Electron app version is
+		* ever `declared`, and only because a child cannot see its parent.
+		*/
+		mode: _enum(["observed", "declared"]),
+		/** Did the probe support the fact it names? A `false` row is still evidence. */
+		holds: boolean(),
+		/** What was actually read, verbatim enough for an operator to argue with. */
+		detail: string()
+	})),
+	/**
+	* The version of the SHELL, when the shell has one it can state: the
+	* Electron app version it declared, or the baked seed closure that
+	* fingerprints a container / app bundle. `null` for `contradictory` and
+	* `unknown` — which version belongs to the shell is precisely what is not
+	* known there.
+	*/
+	currentVersion: string().nullable()
+});
 var ServerRollbackInfoSchema = object({
 	/** The version that failed (or was manually rolled back). */
 	fromVersion: string(),
@@ -74744,7 +74802,13 @@ var ServerPackageStatusSchema = object({
 	* Seed-vs-contract verdict (see {@link ImageContractSchema}). Optional for
 	* version skew: an older provider's payload simply omits it.
 	*/
-	imageContract: ImageContractSchema.optional()
+	imageContract: ImageContractSchema.optional(),
+	/**
+	* What this node runs INSIDE (see {@link WrapperIdentitySchema}). Optional
+	* for version skew: an older provider's payload simply omits it, and an
+	* absent wrapper is unknown — never `native`.
+	*/
+	wrapper: WrapperIdentitySchema.optional()
 });
 var ServerUpdateCheckResultSchema = object({
 	packageName: string(),
@@ -82790,7 +82854,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 +82896,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 +83190,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 +98563,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 +98673,7 @@ var DreameNetworkLinkMonitor = class {
 				meta: {
 					reason,
 					rawBars: bars,
-					...next ?? {}
+					...next
 				}
 			});
 			this.reported = true;
@@ -144200,6 +144291,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 +144348,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 +144372,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 +144433,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 +144461,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.95",
   "description": "Dreame robot-vacuum / lawn-mower device-provider addon for CamStack — wraps the @apocaliss92/nodedreame Dreamehome cloud client",
   "keywords": [
     "camstack",