@camstack/addon-static-turn 1.2.17 → 1.2.19

package/dist/static-turn.addon.js

@@ -19044,7 +19044,31 @@ DeviceType.Camera, method(object({
 	lastCapturedAt: number().nullable(),
 	cacheAgeMs: number().nullable(),
 	etag: string().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. */
@@ -19083,7 +19107,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
@@ -30282,6 +30313,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -32879,6 +32916,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getDebugState": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"snapshot.getSnapshot": [{
 		name: "deviceId",
 		form: "single",

package/dist/static-turn.addon.mjs

@@ -19043,7 +19043,31 @@ DeviceType.Camera, method(object({
 	lastCapturedAt: number().nullable(),
 	cacheAgeMs: number().nullable(),
 	etag: string().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. */
@@ -19082,7 +19106,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
@@ -30281,6 +30312,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"snapshot.getDebugState": {
+		capName: "snapshot",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"snapshot.getSnapshot": {
 		capName: "snapshot",
 		capScope: "device",
@@ -32878,6 +32915,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-static-turn",
-  "version": "1.2.17",
+  "version": "1.2.19",
   "description": "Static / self-hosted (coturn) TURN provider for CamStack",
   "keywords": [
     "camstack",