@camstack/types 1.2.295 → 1.2.296

package/dist/index.js

@@ -21312,19 +21312,52 @@ var NcAlarmNonBlockingEditSchema = zod.z.object({
 	nonBlocking: zod.z.boolean()
 });
 /**
-* One arm mode's non-blocking list: devices that may be open when that mode
-* arms, without the arm being refused.
+* Controllable openings: opt IN to blocking (default is do not block). Contacts
+* keep using {@link NcAlarmNonBlockingEditSchema}.
+*/
+var NcAlarmBlockingEditSchema = zod.z.object({
+	mode: AlarmArmModeSchema,
+	deviceId: zod.z.number().int().positive(),
+	/** true = on the list (blocks when open); false = off the list (default). */
+	blocking: zod.z.boolean()
+});
+/**
+* Controllable openings: opt OUT of secure-on-arm (default is secure ON —
+* close / lock / turn off when this mode arms).
 */
-var NcAlarmNonBlockingSchema = zod.z.object({
+var NcAlarmSecureOnArmEditSchema = zod.z.object({
+	mode: AlarmArmModeSchema,
+	deviceId: zod.z.number().int().positive(),
+	/** true = secure on arm (default); false = do not actuate on arm. */
+	secureOnArm: zod.z.boolean()
+});
+/**
+* One arm mode's device-id list (non-blocking, blocking, or secure-on-arm-off).
+*/
+var NcAlarmModeDeviceListSchema = zod.z.object({
 	mode: AlarmArmModeSchema,
 	deviceIds: zod.z.array(zod.z.number().int()).max(200)
 });
 /**
+* One arm mode's non-blocking list: devices that may be open when that mode
+* arms, without the arm being refused.
+*/
+var NcAlarmNonBlockingSchema = NcAlarmModeDeviceListSchema;
+/** Controllable devices that DO block when open (opt-in; default empty). */
+var NcAlarmBlockingSchema = NcAlarmModeDeviceListSchema;
+/**
+* Controllable devices that do NOT secure on arm (opt-out; default empty =
+* every controllable secures).
+*/
+var NcAlarmSecureOnArmOffSchema = NcAlarmModeDeviceListSchema;
+/**
 * The per-mode lists, at most one per mode. Two lists for one mode have no
 * meaning a reader could agree on (union? the last one?), so they are refused
 * at the boundary rather than interpreted.
 */
 var NcAlarmNonBlockingListSchema = zod.z.array(NcAlarmNonBlockingSchema).max(8).refine(uniqueModes, { message: "nonBlocking: at most one list per arm mode" });
+var NcAlarmBlockingListSchema = zod.z.array(NcAlarmBlockingSchema).max(8).refine(uniqueModes, { message: "blocking: at most one list per arm mode" });
+var NcAlarmSecureOnArmOffListSchema = zod.z.array(NcAlarmSecureOnArmOffSchema).max(8).refine(uniqueModes, { message: "secureOnArmOff: at most one list per arm mode" });
 /**
 * The three durations — global, and per mode since D697 — the panel's state
 * machine runs on, who hears about its transitions, and which openings each mode tolerates.
@@ -21367,9 +21400,23 @@ var NcAlarmSettingsSchema = zod.z.object({
 	* arm (a window left ajar for the cat under `home`, say). At most one entry
 	* per mode is meaningful. Defaulted to `[]` so a blob stored before D630
 	* parses as "every opening blocks" — the behaviour it was written under.
+	* Contacts use this list; controllable openings use {@link blocking} instead
+	* (default: do not block).
 	*/
 	nonBlocking: NcAlarmNonBlockingListSchema.default([]),
 	/**
+	* Per arm mode, controllable openings that DO refuse the arm when open.
+	* Default `[]` = none block (secure-on-arm closes them instead). Absent on a
+	* blob older than this field — read as empty.
+	*/
+	blocking: NcAlarmBlockingListSchema.default([]),
+	/**
+	* Per arm mode, controllable openings that must NOT be actuated on arm.
+	* Default `[]` = every controllable secures (close / lock / off). Absent on
+	* an older blob — read as empty (secure ON).
+	*/
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema.default([]),
+	/**
 	* Per arm mode, the delays that mode OVERRIDES (D697). A mode with no entry, or an entry
 	* without a field, uses the global value above — so `[]`, the default, is exactly the
 	* behaviour of a blob stored before this field existed. Read through `resolveModeDelays`.
@@ -21379,7 +21426,7 @@ var NcAlarmSettingsSchema = zod.z.object({
 /**
 * Every field optional — a tab edits one control at a time.
 *
-* `nonBlocking` and `modeDelays` are re-declared WITHOUT their defaults:
+* List fields and `modeDelays` are re-declared WITHOUT their defaults:
 * `.partial()` does not remove an inner `.default()`, so a patch that never
 * named the field would parse to `[]` and wipe every mode's list on an
 * unrelated edit (the same trap {@link NcRulePatchSchema} documents). Here
@@ -21387,11 +21434,15 @@ var NcAlarmSettingsSchema = zod.z.object({
 */
 var NcAlarmSettingsPatchSchema = NcAlarmSettingsSchema.extend({
 	nonBlocking: NcAlarmNonBlockingListSchema,
+	blocking: NcAlarmBlockingListSchema,
+	secureOnArmOff: NcAlarmSecureOnArmOffListSchema,
 	/** Per-mode, per-field edits — NOT the whole list (see NcAlarmModeDelaysEditSchema). */
 	modeDelays: NcAlarmModeDelaysEditListSchema,
 	/** ONE membership change; the panel applies it to the list it holds at its turn. */
-	nonBlockingEdit: NcAlarmNonBlockingEditSchema
-}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" });
+	nonBlockingEdit: NcAlarmNonBlockingEditSchema,
+	blockingEdit: NcAlarmBlockingEditSchema,
+	secureOnArmEdit: NcAlarmSecureOnArmEditSchema
+}).partial().refine((p) => p.nonBlocking === void 0 || p.nonBlockingEdit === void 0, { message: "nonBlocking and nonBlockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.blocking === void 0 || p.blockingEdit === void 0, { message: "blocking and blockingEdit are exclusive — send the whole lists or one edit" }).refine((p) => p.secureOnArmOff === void 0 || p.secureOnArmEdit === void 0, { message: "secureOnArmOff and secureOnArmEdit are exclusive — send the whole lists or one edit" });
 /**
 * What one arm mode actually arms, DERIVED from the enabled rules gated on it.
 * Never authored, never stored — see `alarm-mode-coverage.ts` for why a stored
@@ -21508,7 +21559,13 @@ var NcAlarmSensorStateSchema = zod.z.object({
 	/** Why `unknown`: the read failed, or the slice holds no word its cap defines (a placeholder included). */
 	unknownWhy: zod.z.enum(["read-failed", "unknown-word"]).nullable(),
 	/** The device manager's liveness as the centre mirrors it; null = not known. */
-	online: zod.z.boolean().nullable()
+	online: zod.z.boolean().nullable(),
+	/**
+	* True when the opening is a cover / lock / switch — the table shows the
+	* Secure-on-arm switch and uses the controllable defaults. False for contacts
+	* and for non-openings. Defaulted so an older hub answer still parses.
+	*/
+	controllable: zod.z.boolean().default(false)
 });
 var NcAlarmSensorsInputSchema = zod.z.object({ deviceIds: zod.z.array(zod.z.number().int().positive()).max(500) });
 var NcAlarmSensorsSchema = zod.z.object({
@@ -66174,9 +66231,22 @@ var ALARM_PANEL_TRIGGER_METHOD = "trigger";
 var NC_ALARM_OPENING_EVENT_KINDS = [
 	"contact",
 	"cover",
-	"lock"
+	"lock",
+	"switch"
 ];
 /**
+* Opening caps that can be ACTUATED to a secure state on arm (close / lock /
+* off). Contacts are openings but not controllable — they only block.
+*/
+var NC_ALARM_CONTROLLABLE_CAPS = [
+	"cover",
+	"lock-control",
+	"switch"
+];
+function isAlarmControllableCap(cap) {
+	return NC_ALARM_CONTROLLABLE_CAPS.includes(cap);
+}
+/**
 * A rule belongs to the alarm when its `deviceState` gate names ANY device's
 * `armed_*` word, or an ENABLED `onTrigger` sequence pulls the alarm panel's
 * trigger (D630).
@@ -66204,6 +66274,46 @@ function sensorTransitionNeverFires(rule) {
 /** The warning an editor shows for {@link sensorTransitionNeverFires}. */
 var NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING = "This rule belongs to the alarm, and an alarm rule fires only when an opening OPENS. Set to “only when it clears”, it can never fire.";
 //#endregion
+//#region src/notification/alarm-controllable.ts
+/**
+* Controllable openings on the alarm: defaults for the two switches, and the
+* actuation each cap gets when "secure on arm" fires.
+*
+* Controllable = cover / lock-control / switch. Contacts stay passive: they
+* block by default and have no secure switch.
+*/
+/** Whether this device refuses the arm when open. */
+function alarmDeviceBlocksArming(input) {
+	if (input.controllable) return input.blocking.includes(input.deviceId);
+	return !input.nonBlocking.includes(input.deviceId);
+}
+/** Whether this controllable should be closed/locked/turned off on arm. */
+function alarmDeviceSecureOnArm(input) {
+	if (!input.controllable) return false;
+	return !input.secureOnArmOff.includes(input.deviceId);
+}
+/** The one secure command for a controllable opening cap, or null for contacts. */
+function secureActuationFor(cap) {
+	if (!isAlarmControllableCap(cap)) return null;
+	switch (cap) {
+		case "cover": return {
+			cap,
+			method: "close",
+			args: {}
+		};
+		case "lock-control": return {
+			cap,
+			method: "lock",
+			args: {}
+		};
+		case "switch": return {
+			cap,
+			method: "setState",
+			args: { on: false }
+		};
+	}
+}
+//#endregion
 //#region src/notification/alarm-settings.ts
 var NC_ALARM_DELAY_FIELDS = [
 	"exitDelaySec",
@@ -66264,10 +66374,11 @@ function applyModeDelaysEdits(current, edits) {
 	return out.filter((e) => e.exitDelaySec !== void 0 || e.entryDelaySec !== void 0 || e.triggeredDurationSec !== void 0);
 }
 /**
-* Put ONE device on, or take it off, ONE mode's list. A no-op answers `changed: false`; an add
-* to a full list is REFUSED by reason (never silently dropped); an emptied list drops its entry.
+* Put ONE device on, or take it off, ONE mode's device-id list. A no-op answers
+* `changed: false`; an add to a full list is REFUSED by reason (never silently
+* dropped); an emptied list drops its entry.
 */
-function applyNonBlockingEdit(lists, edit) {
+function applyModeDeviceListEdit(lists, edit) {
 	const copy = lists.map((l) => ({
 		mode: l.mode,
 		deviceIds: [...l.deviceIds]
@@ -66275,12 +66386,12 @@ function applyNonBlockingEdit(lists, edit) {
 	const at = copy.findIndex((l) => l.mode === edit.mode);
 	const held = at >= 0 ? copy[at]?.deviceIds ?? [] : [];
 	const present = held.includes(edit.deviceId);
-	if (edit.nonBlocking === present) return {
+	if (edit.present === present) return {
 		kind: "applied",
 		lists: copy,
 		changed: false
 	};
-	if (edit.nonBlocking) {
+	if (edit.present) {
 		if (held.length >= 200) return {
 			kind: "refused",
 			reason: "list-full",
@@ -66306,6 +66417,35 @@ function applyNonBlockingEdit(lists, edit) {
 		changed: true
 	};
 }
+/**
+* Put ONE device on, or take it off, ONE mode's non-blocking list.
+*/
+function applyNonBlockingEdit(lists, edit) {
+	return applyModeDeviceListEdit(lists, {
+		mode: edit.mode,
+		deviceId: edit.deviceId,
+		present: edit.nonBlocking
+	});
+}
+/** Controllable opt-in to blocking. */
+function applyBlockingEdit(lists, edit) {
+	return applyModeDeviceListEdit(lists, {
+		mode: edit.mode,
+		deviceId: edit.deviceId,
+		present: edit.blocking
+	});
+}
+/**
+* Controllable secure-on-arm: `secureOnArm: true` removes from the opt-out list;
+* `false` adds to it.
+*/
+function applySecureOnArmEdit(lists, edit) {
+	return applyModeDeviceListEdit(lists, {
+		mode: edit.mode,
+		deviceId: edit.deviceId,
+		present: !edit.secureOnArm
+	});
+}
 function sameSet(a, b) {
 	const sa = new Set(a);
 	const sb = new Set(b);
@@ -66344,6 +66484,9 @@ function editFieldOf(edit, field) {
 		case "triggeredDurationSec": return edit.triggeredDurationSec;
 	}
 }
+function listHolds(lists, mode, deviceId) {
+	return lists?.find((l) => l.mode === mode)?.deviceIds.includes(deviceId) ?? false;
+}
 /**
 * True iff every key the patch sent is reflected in what the host returned. A host older than
 * this build strips the keys it does not know; this is how a client tells "saved" from "parsed
@@ -66358,6 +66501,8 @@ function alarmPatchLanded(patch, returned) {
 	if (patch.triggeredDurationSec !== void 0 && patch.triggeredDurationSec !== returned.triggeredDurationSec) return false;
 	if (patch.announceTargets !== void 0 && !sameSet(patch.announceTargets, returned.announceTargets)) return false;
 	if (patch.nonBlocking !== void 0 && !sameLists(patch.nonBlocking, returned.nonBlocking ?? [])) return false;
+	if (patch.blocking !== void 0 && !sameLists(patch.blocking, returned.blocking ?? [])) return false;
+	if (patch.secureOnArmOff !== void 0 && !sameLists(patch.secureOnArmOff, returned.secureOnArmOff ?? [])) return false;
 	for (const edit of patch.modeDelays ?? []) {
 		const entry = (returned.modeDelays ?? []).find((e) => e.mode === edit.mode);
 		for (const field of NC_ALARM_DELAY_FIELDS) {
@@ -66369,7 +66514,15 @@ function alarmPatchLanded(patch, returned) {
 	}
 	if (patch.nonBlockingEdit !== void 0) {
 		const e = patch.nonBlockingEdit;
-		if (((returned.nonBlocking ?? []).find((l) => l.mode === e.mode)?.deviceIds.includes(e.deviceId) ?? false) !== e.nonBlocking) return false;
+		if (listHolds(returned.nonBlocking, e.mode, e.deviceId) !== e.nonBlocking) return false;
+	}
+	if (patch.blockingEdit !== void 0) {
+		const e = patch.blockingEdit;
+		if (listHolds(returned.blocking, e.mode, e.deviceId) !== e.blocking) return false;
+	}
+	if (patch.secureOnArmEdit !== void 0) {
+		const e = patch.secureOnArmEdit;
+		if (listHolds(returned.secureOnArmOff, e.mode, e.deviceId) === e.secureOnArm) return false;
 	}
 	return true;
 }
@@ -71003,6 +71156,7 @@ exports.NATIVE_LEASE_TILE_BUDGET_KEY = NATIVE_LEASE_TILE_BUDGET_KEY;
 exports.NAVIGATION_ACTION_CATALOG = NAVIGATION_ACTION_CATALOG;
 exports.NAVIGATION_LIGHT_LEVEL_MAX = NAVIGATION_LIGHT_LEVEL_MAX;
 exports.NAVIGATION_LIGHT_LEVEL_MIN = NAVIGATION_LIGHT_LEVEL_MIN;
+exports.NC_ALARM_CONTROLLABLE_CAPS = NC_ALARM_CONTROLLABLE_CAPS;
 exports.NC_ALARM_DELAY_FIELDS = NC_ALARM_DELAY_FIELDS;
 exports.NC_ALARM_DELAY_MAX_SEC = NC_ALARM_DELAY_MAX_SEC;
 exports.NC_ALARM_NONBLOCKING_MAX = NC_ALARM_NONBLOCKING_MAX;
@@ -71099,11 +71253,17 @@ exports.NavigationMoveCommandSchema = NavigationMoveCommandSchema;
 exports.NavigationPointSchema = NavigationPointSchema;
 exports.NavigationRuntimeStateSchema = NavigationRuntimeStateSchema;
 exports.NavigationStatusSchema = NavigationStatusSchema;
+exports.NcAlarmBlockingEditSchema = NcAlarmBlockingEditSchema;
+exports.NcAlarmBlockingSchema = NcAlarmBlockingSchema;
 exports.NcAlarmConfigSchema = NcAlarmConfigSchema;
 exports.NcAlarmModeCoverageSchema = NcAlarmModeCoverageSchema;
 exports.NcAlarmModeDelaysEditSchema = NcAlarmModeDelaysEditSchema;
 exports.NcAlarmModeDelaysSchema = NcAlarmModeDelaysSchema;
+exports.NcAlarmModeDeviceListSchema = NcAlarmModeDeviceListSchema;
 exports.NcAlarmNonBlockingEditSchema = NcAlarmNonBlockingEditSchema;
+exports.NcAlarmNonBlockingSchema = NcAlarmNonBlockingSchema;
+exports.NcAlarmSecureOnArmEditSchema = NcAlarmSecureOnArmEditSchema;
+exports.NcAlarmSecureOnArmOffSchema = NcAlarmSecureOnArmOffSchema;
 exports.NcAlarmSensorReadingSchema = NcAlarmSensorReadingSchema;
 exports.NcAlarmSensorStateSchema = NcAlarmSensorStateSchema;
 exports.NcAlarmSensorsInputSchema = NcAlarmSensorsInputSchema;
@@ -71685,12 +71845,17 @@ exports.addonWidgetsSourceCapability = addonWidgetsSourceCapability;
 exports.addonsCapability = addonsCapability;
 exports.adminUiCapability = require_sleep.adminUiCapability;
 exports.airQualitySensorCapability = airQualitySensorCapability;
+exports.alarmDeviceBlocksArming = alarmDeviceBlocksArming;
+exports.alarmDeviceSecureOnArm = alarmDeviceSecureOnArm;
 exports.alarmPanelCapability = alarmPanelCapability;
 exports.alarmPatchLanded = alarmPatchLanded;
 exports.alertsCapability = alertsCapability;
 exports.ambientLightSensorCapability = ambientLightSensorCapability;
+exports.applyBlockingEdit = applyBlockingEdit;
 exports.applyModeDelaysEdits = applyModeDelaysEdits;
+exports.applyModeDeviceListEdit = applyModeDeviceListEdit;
 exports.applyNonBlockingEdit = applyNonBlockingEdit;
+exports.applySecureOnArmEdit = applySecureOnArmEdit;
 exports.asBoolean = require_sleep.asBoolean;
 exports.asJsonArray = require_sleep.asJsonArray;
 exports.asJsonObject = require_sleep.asJsonObject;
@@ -71950,6 +72115,7 @@ exports.invalidClusterStepModelEntries = invalidClusterStepModelEntries;
 exports.invertPresetFeature = invertPresetFeature;
 exports.invocationFromEncodeProfile = require_composition.invocationFromEncodeProfile;
 exports.isAgentOnlyPlacement = isAgentOnlyPlacement;
+exports.isAlarmControllableCap = isAlarmControllableCap;
 exports.isArrayOutputSchema = isArrayOutputSchema;
 exports.isAudioChunkFormat = require_sleep.isAudioChunkFormat;
 exports.isAudioClassName = isAudioClassName;
@@ -72197,6 +72363,7 @@ exports.scopesAllowDeviceCap = scopesAllowDeviceCap;
 exports.scoreRuntimes = scoreRuntimes;
 exports.scriptRunnerCapability = scriptRunnerCapability;
 exports.searchDisplayIcons = searchDisplayIcons;
+exports.secureActuationFor = secureActuationFor;
 exports.selectAssignedProfileSlots = require_sleep.selectAssignedProfileSlots;
 exports.sendTimesOfSchedule = sendTimesOfSchedule;
 exports.sensorRaisedOf = sensorRaisedOf;