@camstack/types 1.2.77 → 1.2.79

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

@@ -139,6 +139,12 @@ export declare const snapshotCapability: {
             width: z.ZodNullable<z.ZodNumber>;
             neverCaptured: z.ZodBoolean;
             sleeping: z.ZodBoolean;
+            stateReason: z.ZodNullable<z.ZodEnum<{
+                sleeping: "sleeping";
+                unreachable: "unreachable";
+                disabled: "disabled";
+                waking: "waking";
+            }>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind> & {
             readonly systemOnly: true;
         };

package/dist/generated/method-device-selectors.d.ts

@@ -6,20 +6,23 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 331 methods carry a device reference, of which
+ * Coverage: 332 methods carry a device reference, of which
  * 124 are on SYSTEM-scope caps.
  *
- * Only TOP-LEVEL input fields appear here; a nested device id is not
- * extractable by the middleware and is failed by the classification guard
- * instead of passing unenforced.
+ * Top-level fields, number arrays, and one-level arrays of objects carrying
+ * a numeric device field (targets[].deviceId) are all mapped; the matcher
+ * resolves every form and requires EVERY referenced device to be covered.
  */
-/** How a device reference is carried: one number, or an array of numbers. */
-export type DeviceRefForm = 'single' | 'array';
+/** How a device reference is carried: one number, an array of numbers, or an
+ *  array of objects each carrying a numeric device field. */
+export type DeviceRefForm = 'single' | 'array' | 'object-array';
 export interface DeviceRefField {
     readonly name: string;
     readonly form: DeviceRefForm;
     /** When true the field may be absent or null — enforcement skips it. */
     readonly optional: boolean;
+    /** For object-array: the device-id field inside each element. */
+    readonly itemField?: string;
 }
 export declare const METHOD_DEVICE_SELECTORS: Readonly<Record<string, readonly DeviceRefField[]>>;
 /** Cap-method paths that carry a device reference AND live on a system-scope

package/dist/index.js

@@ -19097,7 +19097,16 @@ targets: zod.z.array(zod.z.object({
 			/** A sleeping battery camera: the frame is deliberately stale and will
 			*  NOT refresh in the background. A surface should say so rather than
 			*  present it as current. */
-			sleeping: zod.z.boolean()
+			sleeping: zod.z.boolean(),
+			/** Current device state rendered over the cached frame. State images
+			*  remain authoritative even when their photographic background is
+			*  old; null means the link must carry a current camera frame. */
+			stateReason: zod.z.enum([
+				"disabled",
+				"sleeping",
+				"unreachable",
+				"waking"
+			]).nullable()
 		})))
 	},
 	status: {
@@ -41250,6 +41259,12 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getSnapshotLinks": [{
+		name: "targets",
+		form: "object-array",
+		optional: false,
+		itemField: "deviceId"
+	}],
 	"snapshot.getSnapshotOverview": [{
 		name: "deviceIds",
 		form: "array",

package/dist/index.mjs

@@ -19096,7 +19096,16 @@ targets: z.array(z.object({
 			/** A sleeping battery camera: the frame is deliberately stale and will
 			*  NOT refresh in the background. A surface should say so rather than
 			*  present it as current. */
-			sleeping: z.boolean()
+			sleeping: z.boolean(),
+			/** Current device state rendered over the cached frame. State images
+			*  remain authoritative even when their photographic background is
+			*  old; null means the link must carry a current camera frame. */
+			stateReason: z.enum([
+				"disabled",
+				"sleeping",
+				"unreachable",
+				"waking"
+			]).nullable()
 		})))
 	},
 	status: {
@@ -41249,6 +41258,12 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"snapshot.getSnapshotLinks": [{
+		name: "targets",
+		form: "object-array",
+		optional: false,
+		itemField: "deviceId"
+	}],
 	"snapshot.getSnapshotOverview": [{
 		name: "deviceIds",
 		form: "array",

package/package.json

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