@camstack/addon-matter-broker 0.2.17 → 0.2.19

package/dist/addon.js

@@ -19482,7 +19482,31 @@ DeviceType.Camera, method(object({
 	lastCapturedAt: number().nullable(),
 	cacheAgeMs: number().nullable(),
 	etag: string$2().nullable()
-}))), systemMethod(object({ 
+}))), systemMethod(object({ deviceId: number() }), object({
+	/** The battery slice as read, or null when the device has none. */
+	battery: object({
+		sleeping: boolean(),
+		lastUpdated: number(),
+		lastContactAt: number().optional()
+	}).nullable(),
+	/** The resolved snapshot state (what the overlay decision used). */
+	state: object({
+		isBattery: boolean(),
+		reason: _enum([
+			"disabled",
+			"sleeping",
+			"unreachable",
+			"waking"
+		]).nullable()
+	}),
+	/** The cached frame behind the next paint. */
+	frame: object({
+		capturedAt: number().nullable(),
+		ageMs: number().nullable()
+	}),
+	/** A wake window is currently open (the Waking overlay's source). */
+	waking: boolean()
+})), systemMethod(object({ 
 /** The tiles a surface is actually rendering. One entry per (device,
 *  width) the caller will paint — the width is snapped to the server's
 *  ladder and becomes part of the link's SIGNED identity. */
@@ -19521,7 +19545,14 @@ targets: array(object({
 		"sleeping",
 		"unreachable",
 		"waking"
-	]).nullable()
+	]).nullable(),
+	/** A battery camera (whatever its current state). An AWAKE battery
+	*  camera is deliberately NOT recaptured on the poll cadence — every
+	*  capture is a camera hit that would keep it out of sleep — so its
+	*  cached frame legitimately ages past the currency ceiling while
+	*  nothing is streaming. A surface must keep painting it (a fresh
+	*  frame is captured at each wake), not blank to "unavailable". */
+	battery: boolean()
 })));
 /**
 * `sso-bridge` — internal hub-only cap that lets SSO-style auth
@@ -34087,6 +34118,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -36684,6 +36721,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",

package/dist/addon.mjs

@@ -19480,7 +19480,31 @@ DeviceType.Camera, method(object({
 	lastCapturedAt: number().nullable(),
 	cacheAgeMs: number().nullable(),
 	etag: string$2().nullable()
-}))), systemMethod(object({ 
+}))), systemMethod(object({ deviceId: number() }), object({
+	/** The battery slice as read, or null when the device has none. */
+	battery: object({
+		sleeping: boolean(),
+		lastUpdated: number(),
+		lastContactAt: number().optional()
+	}).nullable(),
+	/** The resolved snapshot state (what the overlay decision used). */
+	state: object({
+		isBattery: boolean(),
+		reason: _enum([
+			"disabled",
+			"sleeping",
+			"unreachable",
+			"waking"
+		]).nullable()
+	}),
+	/** The cached frame behind the next paint. */
+	frame: object({
+		capturedAt: number().nullable(),
+		ageMs: number().nullable()
+	}),
+	/** A wake window is currently open (the Waking overlay's source). */
+	waking: boolean()
+})), systemMethod(object({ 
 /** The tiles a surface is actually rendering. One entry per (device,
 *  width) the caller will paint — the width is snapped to the server's
 *  ladder and becomes part of the link's SIGNED identity. */
@@ -19519,7 +19543,14 @@ targets: array(object({
 		"sleeping",
 		"unreachable",
 		"waking"
-	]).nullable()
+	]).nullable(),
+	/** A battery camera (whatever its current state). An AWAKE battery
+	*  camera is deliberately NOT recaptured on the poll cadence — every
+	*  capture is a camera hit that would keep it out of sleep — so its
+	*  cached frame legitimately ages past the currency ceiling while
+	*  nothing is streaming. A surface must keep painting it (a fresh
+	*  frame is captured at each wake), not blank to "unavailable". */
+	battery: boolean()
 })));
 /**
 * `sso-bridge` — internal hub-only cap that lets SSO-style auth
@@ -34085,6 +34116,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -36682,6 +36719,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-matter-broker",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
   "keywords": [
     "camstack",