@camstack/types 1.2.147 → 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/device-manager.cap.d.ts

@@ -107,8 +107,12 @@ export declare const ConfigEntrySchema: z.ZodObject<{
     value: z.ZodUnknown;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Only `manual` since D356: the operator picks, nothing links itself. The
+ * field survives on the wire because a viewer already OTA'd parses it —
+ * drop it once no shipped client reads `mode`.
+ */
 export declare const LinkedDevicesModeSchema: z.ZodEnum<{
-    auto: "auto";
     manual: "manual";
 }>;
 export type LinkedDevicesMode = z.infer<typeof LinkedDevicesModeSchema>;
@@ -127,7 +131,6 @@ export type LinkedDevice = z.infer<typeof LinkedDeviceSchema>;
 export declare const LinkedDevicesForDeviceSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
     mode: z.ZodEnum<{
-        auto: "auto";
         manual: "manual";
     }>;
     devices: z.ZodArray<z.ZodObject<{
@@ -926,7 +929,6 @@ export declare const deviceManagerCapability: {
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodObject<{
             mode: z.ZodEnum<{
-                auto: "auto";
                 manual: "manual";
             }>;
             devices: z.ZodArray<z.ZodObject<{
@@ -958,7 +960,6 @@ export declare const deviceManagerCapability: {
         }, z.core.$strip>, z.ZodArray<z.ZodObject<{
             deviceId: z.ZodNumber;
             mode: z.ZodEnum<{
-                auto: "auto";
                 manual: "manual";
             }>;
             devices: z.ZodArray<z.ZodObject<{

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,
@@ -10350,7 +10351,12 @@ var ConfigEntrySchema = zod.z.object({
 	value: zod.z.unknown(),
 	description: zod.z.string().optional()
 });
-var LinkedDevicesModeSchema = zod.z.enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = zod.z.enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = zod.z.object({
 	deviceId: zod.z.number(),
@@ -25377,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
@@ -25472,7 +25486,7 @@ onStatusChanged: { data: zod.z.object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -37005,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,
@@ -10349,7 +10350,12 @@ var ConfigEntrySchema = z.object({
 	value: z.unknown(),
 	description: z.string().optional()
 });
-var LinkedDevicesModeSchema = z.enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = z.enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = z.object({
 	deviceId: z.number(),
@@ -25376,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
@@ -25471,7 +25485,7 @@ onStatusChanged: { data: z.object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -36997,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/config-ui.d.ts

@@ -392,6 +392,9 @@ export interface DeviceSelectFilter {
     readonly types?: readonly string[];
     /** Always drop this device id from the options (e.g. the host device). */
     readonly excludeDeviceId?: number;
+    /** Always drop devices of these `DeviceType`s — a container is never a
+     *  legitimate pick, its children are. Applied before every positive clause. */
+    readonly excludeTypes?: readonly string[];
 }
 /**
  * Pick a SINGLE device from the live device catalogue. Options are the
@@ -411,6 +414,14 @@ export interface ConfigDeviceMultiSelectField extends ConfigFieldBase {
     type: 'device-multiselect';
     deviceFilter?: DeviceSelectFilter;
     maxItems?: number;
+    /**
+     * Devices sharing this location are listed FIRST, under a "Suggested"
+     * heading, and the location / type facet chips are shown — the shape the
+     * linked-devices picker needs (D356): a catalogue of hundreds narrowed by
+     * where and what before the free-text search, and the room's own devices
+     * offered without being linked on anybody's behalf. `null` = no suggestion.
+     */
+    suggestLocation?: string | null;
 }
 export interface ConfigPasswordField extends ConfigFieldBase {
     type: 'password';

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.147",
+  "version": "1.2.149",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",