@camstack/types 1.2.148 → 1.2.149

package/dist/capabilities/battery.cap.d.ts

@@ -11,6 +11,7 @@ import { DeviceType } from '../device/device-type.js';
 export declare const BatteryStatusSchema: z.ZodObject<{
     percentage: z.ZodNullable<z.ZodNumber>;
     charging: z.ZodEnum<{
+        unknown: "unknown";
         none: "none";
         dc: "dc";
         solar: "solar";
@@ -65,6 +66,7 @@ export declare const batteryCapability: {
                 status: z.ZodObject<{
                     percentage: z.ZodNullable<z.ZodNumber>;
                     charging: z.ZodEnum<{
+                        unknown: "unknown";
                         none: "none";
                         dc: "dc";
                         solar: "solar";
@@ -81,6 +83,7 @@ export declare const batteryCapability: {
         readonly schema: z.ZodObject<{
             percentage: z.ZodNullable<z.ZodNumber>;
             charging: z.ZodEnum<{
+                unknown: "unknown";
                 none: "none";
                 dc: "dc";
                 solar: "solar";
@@ -93,7 +96,7 @@ export declare const batteryCapability: {
         readonly kind: "push";
         readonly empty: {
             readonly percentage: 0;
-            readonly charging: "none";
+            readonly charging: "unknown";
             readonly sleeping: false;
             readonly lastUpdated: 0;
         };
@@ -110,6 +113,7 @@ export declare const batteryCapability: {
     readonly runtimeState: z.ZodObject<{
         percentage: z.ZodNullable<z.ZodNumber>;
         charging: z.ZodEnum<{
+            unknown: "unknown";
             none: "none";
             dc: "dc";
             solar: "solar";

package/dist/capabilities/pipeline-orchestrator.cap.d.ts

@@ -1250,6 +1250,7 @@ export declare const pipelineOrchestratorCapability: {
                     "no-provider": "no-provider";
                     "source-unreachable": "source-unreachable";
                     "not-configured": "not-configured";
+                    "device-disabled": "device-disabled";
                 }>>;
                 enabled: z.ZodBoolean;
                 authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1323,6 +1324,7 @@ export declare const pipelineOrchestratorCapability: {
                     "no-provider": "no-provider";
                     "source-unreachable": "source-unreachable";
                     "not-configured": "not-configured";
+                    "device-disabled": "device-disabled";
                 }>>;
                 enabled: z.ZodBoolean;
                 authority: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/index.js

@@ -887,7 +887,8 @@ var CameraSwitchAuthoritySchema = zod.z.discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = zod.z.enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -1057,7 +1058,7 @@ function resolveState(descriptor, input) {
 			if (audio === null) return {
 				available: false,
 				enabled: true,
-				unavailableReason: "source-unreachable"
+				unavailableReason: input.deviceDisabled ? "device-disabled" : "source-unreachable"
 			};
 			if (!audio.supported) return {
 				available: false,
@@ -1079,7 +1080,7 @@ function resolveState(descriptor, input) {
 			if (mask === null) return {
 				available: false,
 				enabled: false,
-				unavailableReason: "source-unreachable"
+				unavailableReason: input.deviceDisabled ? "device-disabled" : "source-unreachable"
 			};
 			if (!mask.supported) return {
 				available: false,
@@ -25382,12 +25383,20 @@ var BatteryStatusSchema = zod.z.object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: zod.z.enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -25477,7 +25486,7 @@ onStatusChanged: { data: zod.z.object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -37010,8 +37019,17 @@ var BaseDeviceProvider = class extends require_sleep.BaseAddon {
 	async onRestoreDevices(savedDevices) {
 		const restored = /* @__PURE__ */ new Set();
 		const failures = [];
+		const liveStableIds = new Set((await this.ctx.kernel.devices.getAll()).map((device) => device.stableId));
 		const attemptRestore = async (saved) => {
 			if (restored.has(saved.id)) return;
+			if (liveStableIds.has(saved.stableId)) {
+				this.ctx.logger.debug("Restore row already live — not dialled again", { tags: {
+					deviceId: saved.id,
+					stableId: saved.stableId
+				} });
+				restored.add(saved.id);
+				return;
+			}
 			const Class = this.deviceClasses[saved.type];
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);

package/dist/index.mjs

@@ -886,7 +886,8 @@ var CameraSwitchAuthoritySchema = z.discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = z.enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -1056,7 +1057,7 @@ function resolveState(descriptor, input) {
 			if (audio === null) return {
 				available: false,
 				enabled: true,
-				unavailableReason: "source-unreachable"
+				unavailableReason: input.deviceDisabled ? "device-disabled" : "source-unreachable"
 			};
 			if (!audio.supported) return {
 				available: false,
@@ -1078,7 +1079,7 @@ function resolveState(descriptor, input) {
 			if (mask === null) return {
 				available: false,
 				enabled: false,
-				unavailableReason: "source-unreachable"
+				unavailableReason: input.deviceDisabled ? "device-disabled" : "source-unreachable"
 			};
 			if (!mask.supported) return {
 				available: false,
@@ -25381,12 +25382,20 @@ var BatteryStatusSchema = z.object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: z.enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -25476,7 +25485,7 @@ onStatusChanged: { data: z.object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -37002,8 +37011,17 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async onRestoreDevices(savedDevices) {
 		const restored = /* @__PURE__ */ new Set();
 		const failures = [];
+		const liveStableIds = new Set((await this.ctx.kernel.devices.getAll()).map((device) => device.stableId));
 		const attemptRestore = async (saved) => {
 			if (restored.has(saved.id)) return;
+			if (liveStableIds.has(saved.stableId)) {
+				this.ctx.logger.debug("Restore row already live — not dialled again", { tags: {
+					deviceId: saved.id,
+					stableId: saved.stableId
+				} });
+				restored.add(saved.id);
+				return;
+			}
 			const Class = this.deviceClasses[saved.type];
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);

package/dist/interfaces/camera-switches.d.ts

@@ -173,6 +173,7 @@ export declare const CameraSwitchUnavailableReasonSchema: z.ZodEnum<{
     "no-provider": "no-provider";
     "source-unreachable": "source-unreachable";
     "not-configured": "not-configured";
+    "device-disabled": "device-disabled";
 }>;
 export type CameraSwitchUnavailableReason = z.infer<typeof CameraSwitchUnavailableReasonSchema>;
 /**
@@ -201,6 +202,7 @@ export declare const CameraSwitchSchema: z.ZodObject<{
         "no-provider": "no-provider";
         "source-unreachable": "source-unreachable";
         "not-configured": "not-configured";
+        "device-disabled": "device-disabled";
     }>>;
     enabled: z.ZodBoolean;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -244,6 +246,7 @@ export declare const CameraSwitchGroupSchema: z.ZodObject<{
             "no-provider": "no-provider";
             "source-unreachable": "source-unreachable";
             "not-configured": "not-configured";
+            "device-disabled": "device-disabled";
         }>>;
         enabled: z.ZodBoolean;
         authority: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/interfaces/event-bus.d.ts

@@ -1095,7 +1095,8 @@ export interface EventCatalog {
         readonly status: {
             /** `null` = NOT YET KNOWN. See `BatteryStatusSchema.percentage`. */
             readonly percentage: number | null;
-            readonly charging: 'dc' | 'solar' | 'none';
+            /** `'unknown'` = the power source was never read. See `BatteryStatusSchema.charging`. */
+            readonly charging: 'dc' | 'solar' | 'none' | 'unknown';
             readonly sleeping: boolean;
             readonly lastUpdated: number;
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.148",
+  "version": "1.2.149",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",