@camstack/types 1.2.271 → 1.2.272

package/dist/capabilities/zone-analytics.cap.d.ts

@@ -122,8 +122,8 @@ export type CameraOccupancySnapshot = z.infer<typeof CameraOccupancySnapshotSche
 export declare const CameraOccupancySnapshotForDeviceSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
     read: z.ZodEnum<{
-        read: "read";
         unreadable: "unreadable";
+        read: "read";
     }>;
     snapshot: z.ZodNullable<z.ZodObject<{
         ts: z.ZodNumber;
@@ -310,8 +310,8 @@ export declare const zoneAnalyticsCapability: {
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             deviceId: z.ZodNumber;
             read: z.ZodEnum<{
-                read: "read";
                 unreadable: "unreadable";
+                read: "read";
             }>;
             snapshot: z.ZodNullable<z.ZodObject<{
                 ts: z.ZodNumber;

package/dist/composition/composition-report.d.ts

@@ -171,8 +171,8 @@ export declare function compositionFieldKey(plan: Pick<CompositionFieldPlan, 'ca
  * `replace`s named fields of one it has natively.
  */
 export declare const CompositionFeatureModeSchema: z.ZodEnum<{
-    new: "new";
     replace: "replace";
+    new: "new";
     add: "add";
 }>;
 export type CompositionFeatureMode = z.infer<typeof CompositionFeatureModeSchema>;
@@ -180,8 +180,8 @@ export declare const CompositionFeaturePlanSchema: z.ZodObject<{
     featureIndex: z.ZodNumber;
     cap: z.ZodString;
     mode: z.ZodEnum<{
-        new: "new";
         replace: "replace";
+        new: "new";
         add: "add";
     }>;
 }, z.core.$strip>;
@@ -285,8 +285,8 @@ export declare const CompositionValidationSchema: z.ZodObject<{
         featureIndex: z.ZodNumber;
         cap: z.ZodString;
         mode: z.ZodEnum<{
-            new: "new";
             replace: "replace";
+            new: "new";
             add: "add";
         }>;
     }, z.core.$strip>>;

package/dist/index.d.ts

@@ -243,6 +243,7 @@ export { NC_SERVER_PACKAGE_NAME, NC_UPDATE_EVENT_PACKAGE_NAMES, type NcInstalled
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { CLUSTER_MODEL_SCOPED_STEPS, CLUSTER_MODEL_SECTION_ID, CLUSTER_STEP_SETTING_FIELDS, type ClusterModelScopedStep, type ClusterStepModels, type ClusterStepSettingField, type ClusterStepSettings, clusterModelSettingKey, clusterStepSettingFieldsFor, clusterStepSettingKey, DEFAULT_CLUSTER_STEP_MODELS, DEFAULT_CLUSTER_STEP_SETTINGS, DEFAULT_MIN_LANDMARK_FACE_SIZE_PX, type HydratedClusterSection, type HydratedClusterView, interpretStoredClusterModel, type InvalidClusterStepModelEntry, invalidClusterStepModelEntries, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, pickInvalidClusterStepModels, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, type StoredClusterModelInterpretation, } from './pipeline/cluster-model-scope.js';
+export { CAMERA_SENSORS_NOT_LOADED, CAMERA_SENSORS_SETTINGS_KEY, CAMERA_TRIGGER, type CameraSensorAttachment, CameraSensorAttachmentSchema, type CameraSensorRef, CameraSensorRefSchema, cameraSensorRefKey, type CameraSensorsConfig, CameraSensorsConfigSchema, type CameraSensorsMode, CameraSensorsModeSchema, type CameraSensorsNotForwarded, CameraSensorsNotForwardedSchema, type CameraSensorsStatus, CameraSensorsStatusSchema, MAX_CAMERA_SENSORS, type MotionTriggeredBy, type MotionTriggeredByReading, MotionTriggeredBySchema, readMotionTriggeredBy, } from './pipeline/camera-sensors.js';
 export { type FormatRunnableModel, stepModelRunsOnFormat, } from './pipeline/step-format-runnable.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_HOLD_FIELD, NATIVE_LEASE_HOLD_KEY, NATIVE_LEASE_SCENE_BUDGET_FIELD, NATIVE_LEASE_SCENE_BUDGET_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TILE_BUDGET_FIELD, NATIVE_LEASE_TILE_BUDGET_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';

package/dist/index.js

@@ -20524,6 +20524,123 @@ var oauthIntegrationCapability = {
 getDescriptor: require_sleep.method(zod.z.void(), OauthIntegrationDescriptorSchema, { auth: "admin" }) }
 };
 //#endregion
+//#region src/pipeline/camera-sensors.ts
+/**
+* What started a camera's onboard motion (D672). `camera` is the camera's own
+* firmware; `sensor` is a device the operator ATTACHED to it. Absent on the
+* wire means the camera: only the camera-sensors bridge ever says `sensor`.
+*/
+var MotionTriggeredBySchema = zod.z.discriminatedUnion("kind", [zod.z.object({ kind: zod.z.literal("camera") }), zod.z.object({
+	kind: zod.z.literal("sensor"),
+	deviceId: zod.z.number().int().positive()
+})]);
+var CAMERA_TRIGGER = Object.freeze({ kind: "camera" });
+function readMotionTriggeredBy(value) {
+	if (value === void 0) return {
+		triggeredBy: CAMERA_TRIGGER,
+		malformed: false
+	};
+	const parsed = MotionTriggeredBySchema.safeParse(value);
+	return parsed.success ? {
+		triggeredBy: parsed.data,
+		malformed: false
+	} : {
+		triggeredBy: CAMERA_TRIGGER,
+		malformed: true
+	};
+}
+/** The orchestrator device-store key, beside `motionSources`. */
+var CAMERA_SENSORS_SETTINGS_KEY = "cameraSensors";
+/** More than this is a configuration error, not a camera. */
+var MAX_CAMERA_SENSORS = 8;
+var CameraSensorRefSchema = zod.z.object({
+	addonId: zod.z.string().min(1),
+	stableId: zod.z.string().min(1)
+});
+function cameraSensorRefKey(ref) {
+	return `${ref.addonId}/${ref.stableId}`;
+}
+/** CS-1 accepts exactly one mode; CS-2 (D673) widens it to confirm / replace. */
+var CameraSensorsModeSchema = zod.z.enum(["in-addition"]);
+var CameraSensorsConfigSchema = zod.z.object({
+	mode: CameraSensorsModeSchema,
+	sensors: zod.z.array(CameraSensorRefSchema).min(1).max(8)
+}).superRefine((value, ctx) => {
+	const seen = /* @__PURE__ */ new Set();
+	value.sensors.forEach((ref, index) => {
+		const key = cameraSensorRefKey(ref);
+		if (seen.has(key)) ctx.addIssue({
+			code: "custom",
+			path: ["sensors", index],
+			message: `duplicate camera sensor ${key}`
+		});
+		seen.add(key);
+	});
+});
+var RefFields = {
+	addonId: zod.z.string(),
+	stableId: zod.z.string()
+};
+var CameraSensorAttachmentSchema = zod.z.discriminatedUnion("state", [
+	zod.z.object({
+		...RefFields,
+		state: zod.z.literal("ready"),
+		deviceId: zod.z.number(),
+		name: zod.z.string(),
+		caps: zod.z.array(zod.z.string()).readonly()
+	}),
+	zod.z.object({
+		...RefFields,
+		state: zod.z.literal("offline"),
+		deviceId: zod.z.number(),
+		name: zod.z.string(),
+		reason: zod.z.enum(["offline", "disabled"])
+	}),
+	zod.z.object({
+		...RefFields,
+		state: zod.z.literal("missing"),
+		reason: zod.z.string()
+	}),
+	zod.z.object({
+		...RefFields,
+		state: zod.z.literal("unsupported"),
+		deviceId: zod.z.number(),
+		name: zod.z.string(),
+		reason: zod.z.string()
+	}),
+	zod.z.object({
+		...RefFields,
+		state: zod.z.literal("unreadable"),
+		reason: zod.z.string()
+	})
+]);
+/**
+* Why a configured camera forwards NOTHING from its sensors, however ready they
+* are (D672): it does not list `onboard` in `motionSources` (attaching a sensor
+* does not add it), or it has no active detection config at all (the bridge
+* reads the active config). Absent = forwarded, or an older node that does not
+* say.
+*/
+var CameraSensorsNotForwardedSchema = zod.z.enum(["onboard-not-listed", "no-active-detection"]);
+var CameraSensorsStatusSchema = zod.z.discriminatedUnion("state", [
+	zod.z.object({ state: zod.z.literal("not-configured") }),
+	zod.z.object({
+		state: zod.z.literal("unreadable"),
+		reason: zod.z.string()
+	}),
+	zod.z.object({
+		state: zod.z.literal("configured"),
+		mode: CameraSensorsModeSchema,
+		sensors: zod.z.array(CameraSensorAttachmentSchema).readonly(),
+		notForwarded: CameraSensorsNotForwardedSchema.optional()
+	})
+]);
+/** What a camera reads before its first settings read ANSWERED (D315). */
+var CAMERA_SENSORS_NOT_LOADED = Object.freeze({
+	state: "unreadable",
+	reason: "camera sensor mappings not loaded"
+});
+//#endregion
 //#region src/pipeline/cluster-model-scope.ts
 /**
 * A model choice has a SCOPE, and a scope change has a workflow.
@@ -21446,6 +21563,12 @@ var MotionEventSchema = zod.z.object({
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: zod.z.string().optional(),
 	/**
+	* The FIRST trigger of an `onboard` episode, written once at open (D672).
+	* Absent = not recorded (a row written before D672, or an analyzer /
+	* device-activity episode) — never read as "the camera" (D393).
+	*/
+	triggeredBy: MotionTriggeredBySchema.optional(),
+	/**
 	* One row per motion EPISODE, not one per push (D475). `null` while the
 	* episode is still open — a further rising edge extends it in place rather
 	* than inserting a new row. Set once, at close, to `lastOnAt - startedAt`
@@ -24725,6 +24848,28 @@ var MotionSourceEnum = zod.z.enum([
 */
 var MotionSourcesSchema = zod.z.array(MotionSourceEnum);
 /**
+* The operator-facing name of each MOTION source (D672: `onboard` = the
+* camera's sensors — its own motion plus any sensor attached to it). The wire
+* value stays `onboard`; only the label changed. `detectionSources: 'onboard'`
+* ("Camera onboard AI") and the notification source filter keep their labels.
+*/
+var MOTION_SOURCE_LABELS = {
+	analyzer: "Frame-diff Analyzer (motion addon)",
+	onboard: "Camera sensors",
+	"device-activity": "Device activity (the device says it is working)"
+};
+/** A value this build does not know (a newer node's) is shown as itself. */
+function motionSourceLabel(value) {
+	const parsed = MotionSourceEnum.safeParse(value);
+	return parsed.success ? MOTION_SOURCE_LABELS[parsed.data] : value;
+}
+/** The order the motion-source picker offers them in (not the enum's order). */
+var MOTION_SOURCE_PICKER_ORDER = [
+	"analyzer",
+	"onboard",
+	"device-activity"
+];
+/**
 * Which root detector a camera runs — EXACTLY ONE.
 *
 * Deliberately the SAME vocabulary post-analysis already tags every detection
@@ -25092,20 +25237,14 @@ var RunnerCameraDeviceUIFields = [
 		type: "multiselect",
 		label: "Motion Sources",
 		default: ["analyzer"],
-		options: [
-			{
-				value: "analyzer",
-				label: "Frame-diff Analyzer (motion addon)"
-			},
-			{
-				value: "onboard",
-				label: "Camera Onboard Sensor"
-			},
-			{
-				value: "device-activity",
-				label: "Device activity (the device says it is working)"
-			}
-		]
+		options: MOTION_SOURCE_PICKER_ORDER.map((value) => value === "onboard" ? {
+			value,
+			label: MOTION_SOURCE_LABELS[value],
+			description: "The camera's own motion, plus any sensor attached to it"
+		} : {
+			value,
+			label: MOTION_SOURCE_LABELS[value]
+		})
 	},
 	{
 		key: "detectionSources",
@@ -26070,6 +26209,11 @@ var CameraStatusSchema = zod.z.object({
 	*/
 	switchedOff: zod.z.array(CameraSwitchIdSchema).readonly(),
 	/**
+	* The camera's attached sensors (D672). Optional only for a status composed
+	* by an orchestrator older than D672; this orchestrator always sets it.
+	*/
+	cameraSensors: CameraSensorsStatusSchema.optional(),
+	/**
 	* Stages of the bounded fan-out that were CUT SHORT — a timeout or a
 	* rejection — and whose block is therefore `null` because we could not
 	* READ it, not because there is nothing there.
@@ -35950,7 +36094,9 @@ var MotionOnMotionChangedDataSchema = zod.z.object({
 	detected: zod.z.boolean(),
 	timestamp: zod.z.number(),
 	source: MotionSourceEnum,
-	regions: zod.z.array(MotionRegionSchema).readonly().optional()
+	regions: zod.z.array(MotionRegionSchema).readonly().optional(),
+	/** Who started it (D672). Absent = the camera itself. Only `onboard` carries `sensor`. */
+	triggeredBy: MotionTriggeredBySchema.optional()
 });
 var motionCapability = {
 	name: "motion",
@@ -68364,8 +68510,11 @@ exports.BrokerSubscribeResultSchema = SubscribeResultSchema;
 exports.BrokerTestConnectionResultSchema = TestConnectionResultSchema;
 exports.BrokerUnsubscribeInputSchema = UnsubscribeInputSchema;
 exports.BulkRecordSchema = BulkRecordSchema;
+exports.CAMERA_SENSORS_NOT_LOADED = CAMERA_SENSORS_NOT_LOADED;
+exports.CAMERA_SENSORS_SETTINGS_KEY = CAMERA_SENSORS_SETTINGS_KEY;
 exports.CAMERA_SWITCH_CATALOG = CAMERA_SWITCH_CATALOG;
 exports.CAMERA_SWITCH_ORDER = CAMERA_SWITCH_ORDER;
+exports.CAMERA_TRIGGER = CAMERA_TRIGGER;
 exports.CAM_PROFILE_ORDER = require_sleep.CAM_PROFILE_ORDER;
 exports.CAPABILITY_NAMES = CAPABILITY_NAMES;
 exports.CAPABILITY_ROUTER_KEYS = CAPABILITY_ROUTER_KEYS;
@@ -68425,6 +68574,12 @@ exports.CameraMotionStatusSchema = CameraMotionStatusSchema;
 exports.CameraOccupancySnapshotForDeviceSchema = CameraOccupancySnapshotForDeviceSchema;
 exports.CameraRecordingModeSchema = CameraRecordingModeSchema;
 exports.CameraRecordingStatusSchema = CameraRecordingStatusSchema;
+exports.CameraSensorAttachmentSchema = CameraSensorAttachmentSchema;
+exports.CameraSensorRefSchema = CameraSensorRefSchema;
+exports.CameraSensorsConfigSchema = CameraSensorsConfigSchema;
+exports.CameraSensorsModeSchema = CameraSensorsModeSchema;
+exports.CameraSensorsNotForwardedSchema = CameraSensorsNotForwardedSchema;
+exports.CameraSensorsStatusSchema = CameraSensorsStatusSchema;
 exports.CameraSourceStatusSchema = CameraSourceStatusSchema;
 exports.CameraSourceStreamSchema = CameraSourceStreamSchema;
 exports.CameraStatusDegradationReasonSchema = CameraStatusDegradationReasonSchema;
@@ -68870,6 +69025,7 @@ exports.MACRO_LABELS = MACRO_LABELS;
 exports.MAX_ARCHIVED_DEBUG_NOTES = MAX_ARCHIVED_DEBUG_NOTES;
 exports.MAX_BIRTH_DECISION_RECORDS = MAX_BIRTH_DECISION_RECORDS;
 exports.MAX_BIRTH_LATENCY_PROXY_MS = MAX_BIRTH_LATENCY_PROXY_MS;
+exports.MAX_CAMERA_SENSORS = MAX_CAMERA_SENSORS;
 exports.MAX_CLIP_EVENT_IDS = MAX_CLIP_EVENT_IDS;
 exports.MAX_CLIP_LABELS = MAX_CLIP_LABELS;
 exports.MAX_COMPOSITION_CODE_LENGTH = require_composition.MAX_COMPOSITION_CODE_LENGTH;
@@ -68896,6 +69052,7 @@ exports.MODEL_FORMATS = MODEL_FORMATS;
 exports.MODEL_HOSTING = MODEL_HOSTING;
 exports.MODEL_PROVIDER_IDS = MODEL_PROVIDER_IDS;
 exports.MOTION_CLOSE_AFTER_MS = MOTION_CLOSE_AFTER_MS;
+exports.MOTION_SOURCE_LABELS = MOTION_SOURCE_LABELS;
 exports.MOTION_TRIGGER_FEATURE = MOTION_TRIGGER_FEATURE;
 exports.ManagedModelCatalogEntrySchema = ManagedModelCatalogEntrySchema;
 exports.ManagedModelExtraFileSchema = ManagedModelExtraFileSchema;
@@ -68946,6 +69103,7 @@ exports.MotionSourcesSchema = MotionSourcesSchema;
 exports.MotionStatusSchema = MotionStatusSchema;
 exports.MotionTriggerRuntimeStateSchema = MotionTriggerRuntimeStateSchema;
 exports.MotionTriggerStatusSchema = MotionTriggerStatusSchema;
+exports.MotionTriggeredBySchema = MotionTriggeredBySchema;
 exports.MotionZoneOptionsSchema = MotionZoneOptionsSchema;
 exports.MotionZonePatchSchema = MotionZonePatchSchema;
 exports.MotionZoneRegionSchema = MotionZoneRegionSchema;
@@ -69659,6 +69817,7 @@ exports.buttonCapability = buttonCapability;
 exports.cameraCredentialsCapability = cameraCredentialsCapability;
 exports.cameraGridLayoutCapability = cameraGridLayoutCapability;
 exports.cameraPipelineConfigCapability = cameraPipelineConfigCapability;
+exports.cameraSensorRefKey = cameraSensorRefKey;
 exports.cameraStreamsCapability = cameraStreamsCapability;
 exports.canConvertUnit = canConvertUnit;
 exports.canonicalEgressPlan = canonicalEgressPlan;
@@ -69948,6 +70107,7 @@ exports.modelDistributorCapability = modelDistributorCapability;
 exports.modelFormatForRuntime = modelFormatForRuntime;
 exports.motionCapability = motionCapability;
 exports.motionDetectionCapability = motionDetectionCapability;
+exports.motionSourceLabel = motionSourceLabel;
 exports.motionTriggerCapability = motionTriggerCapability;
 exports.motionZonesCapability = motionZonesCapability;
 exports.mqttBrokerCapability = mqttBrokerCapability;
@@ -70028,6 +70188,7 @@ exports.readClusterStepModels = readClusterStepModels;
 exports.readClusterStepSettings = readClusterStepSettings;
 exports.readDetailCropConvention = readDetailCropConvention;
 exports.readDeviceStateFrom = readDeviceStateFrom;
+exports.readMotionTriggeredBy = readMotionTriggeredBy;
 exports.readNativeLeaseOverride = readNativeLeaseOverride;
 exports.readNodePin = require_sleep.readNodePin;
 exports.readTimelapseGeneratedAt = readTimelapseGeneratedAt;