@camstack/types 1.2.255 → 1.2.257

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BAgDk7I9.js");
+const require_sleep = require("./sleep-DtomDrRW.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_canonical_hash = require("./canonical-hash-CSE4ioRi.js");
 const require_enums = require("./enums.js");
@@ -17196,6 +17196,9 @@ var NcSystemEventKindSchema = zod.z.enum([
 	"device-battery-normal",
 	"device-consumable-low",
 	"device-consumable-normal",
+	"device-tank-low",
+	"device-tank-full",
+	"device-tank-normal",
 	"stream-online",
 	"stream-offline",
 	"node-online",
@@ -17276,6 +17279,31 @@ var NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS = [
 	"device-consumable-normal"
 ];
 /**
+* The two kinds a RULE's consumable threshold speaks about (D642). Named once:
+* the filter scoping (`systemEventFilterApplies`), the hub's threshold census
+* and both editors read it.
+*/
+var NC_CONSUMABLE_SYSTEM_EVENT_KINDS = ["device-consumable-low", "device-consumable-normal"];
+/** A vacuum's tank alerts (D642) — raised on the provider's own verdict. */
+var NC_TANK_SYSTEM_EVENT_KINDS = [
+	"device-tank-low",
+	"device-tank-full",
+	"device-tank-normal"
+];
+/**
+* The consumable threshold a rule that does not state one judges at (D642).
+* The operator's number ("default 15 %, configurable on the rule"), and the
+* value the cluster-wide setting it replaces shipped with.
+*/
+var NC_CONSUMABLE_LOW_PERCENT_DEFAULT = 15;
+/**
+* The highest consumable threshold a rule may state (D642 review M1): 100 minus
+* the band's 5-point recovery hysteresis (`consumable-band.ts`). Above it the
+* recovery point passes 100 % and an episode could never clear, even for a
+* part just replaced. A spec in the notification centre pins the sum.
+*/
+var NC_CONSUMABLE_LOW_PERCENT_MAX = 95;
+/**
 * One coherent system-event condition. `kinds` is the required opt-in safety
 * gate; the remaining lists are optional narrowing filters relevant to the
 * selected kinds.
@@ -17309,8 +17337,27 @@ var NcSystemEventConditionSchema = zod.z.object({
 	*/
 	excludeDeviceIds: zod.z.array(zod.z.number().int()).min(1).optional(),
 	nodeIds: zod.z.array(zod.z.string().min(1)).min(1).optional(),
-	packageNames: zod.z.array(zod.z.string().min(1)).min(1).optional()
-});
+	packageNames: zod.z.array(zod.z.string().min(1)).min(1).optional(),
+	/**
+	* At or below this remaining-life %, a consumable is LOW for THIS rule
+	* (D642). Absent = {@link NC_CONSUMABLE_LOW_PERCENT_DEFAULT}; at most
+	* {@link NC_CONSUMABLE_LOW_PERCENT_MAX}, so every episode can recover. Scoped to the
+	* consumable kinds (`systemEventFilterApplies`) and to the device-events
+	* family; ignored on every other kind.
+	*
+	* It is a property of the RULE because the operator decided so: a rule at
+	* 25 must be told about a filter at 20 %, a rule at 10 must not. The hub
+	* keeps one episode per (threshold, device, item) — its own hysteresis, its
+	* own reminder — and a rule hears only the episode judged at ITS threshold,
+	* exactly as an occupancy rule hears only the edge of its own count. A
+	* provider's own `replace` verdict is low at every threshold.
+	*/
+	consumableLowPercent: zod.z.number().int().min(1).max(95).optional()
+});
+/** The consumable threshold a system-event condition judges at (D642). */
+function consumableLowPercentOf(condition) {
+	return condition.consumableLowPercent ?? 15;
+}
 /**
 * `maxPerTrack` for `immediate` rules is FIXED at 1 (D-3): a single track
 * fires an immediate rule at most once, enforced durably by the outbox
@@ -17495,6 +17542,16 @@ var NcCrossingSchema = zod.z.enum([
 	"exit",
 	"any"
 ]);
+/**
+* Which edge of a BOOLEAN sensor fires a device-event rule (D640).
+*  - `raised`  — the sensor went high: water detected, smoke, open, tampered.
+*  - `cleared` — it went back: dry, clear, closed.
+*  - absent    — both edges, which is what every rule authored before this did.
+*
+* There is no third member for "both": absence already says it, and a value
+* that means the same as absence is a second way to write one rule.
+*/
+var NcSensorTransitionSchema = zod.z.enum(["raised", "cleared"]);
 /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
 var NcZoneConditionSchema = zod.z.object({
 	ids: zod.z.array(zod.z.string().min(1)).min(1),
@@ -17684,6 +17741,20 @@ var NcConditionsSchema = zod.z.object({
 	scene: NcSceneConditionSchema.optional(),
 	/** Device scope — absent = all devices. */
 	devices: zod.z.array(zod.z.number()).optional(),
+	/**
+	* Device EXCLUSION (D641) — "every device except these". Judged on the SAME
+	* subject ids {@link devices} is judged on (the camera, the sensor that
+	* fired, a linked set's sensor and row cameras), so a sensor fanned out per
+	* linked camera is excluded exactly where an include would have tested it.
+	* `min(1)`: an empty exclusion excludes nothing and is written as absent.
+	*
+	* Not for `system-event` rules — those carry their own
+	* `systemEvent.excludeDeviceIds` (D636), and the hub refuses this key there.
+	* Editors present the two lists as ONE field (All | Only these | All except
+	* these); the engine evaluates each independently, so a legacy rule
+	* carrying both still means "these, minus those".
+	*/
+	devicesExclude: zod.z.array(zod.z.number()).min(1).optional(),
 	/** Detector class names (any overlap with the record's class set). */
 	classes: zod.z.array(zod.z.string().min(1)).optional(),
 	/** Veto classes — any overlap fails the rule. */
@@ -17817,6 +17888,16 @@ var NcConditionsSchema = zod.z.object({
 	*/
 	sensorKinds: zod.z.array(zod.z.string().min(1)).optional(),
 	/**
+	* DEVICE-EVENT only (D640). Fire on one edge of a boolean sensor —
+	* {@link NcSensorTransitionSchema}. Which field of the slice means "raised"
+	* is `@camstack/types` → `notification/sensor-raised.ts`. A reading the
+	* engine cannot place (a kind with no raise, an unreadable slice) PASSES:
+	* the condition fails open towards notifying, never towards silence. Editors
+	* offer it only when every chosen {@link sensorKinds} member has a raise
+	* (`sensorTransitionOffered`), and the hub refuses it on any other delivery.
+	*/
+	sensorTransition: NcSensorTransitionSchema.optional(),
+	/**
 	* PACKAGE-EVENT only. Which package phase fires the rule — `delivered`
 	* (a parked parcel appeared), `picked-up` (it departed), or `both`. Fails
 	* when the subject's phase does not match (a subject always carries a phase
@@ -18449,6 +18530,7 @@ var NcConditionDescriptorSchema = zod.z.object({
 	/** Editor widget the UI renders — never hardcode per-condition forms. */
 	valueType: zod.z.enum([
 		"deviceIdList",
+		"deviceIdExcludeList",
 		"stringList",
 		"number01",
 		"number",
@@ -18459,6 +18541,7 @@ var NcConditionDescriptorSchema = zod.z.object({
 		"plateMatcher",
 		"packagePhase",
 		"crossingSelect",
+		"sensorTransition",
 		"polygonDraw",
 		"occupancy",
 		"audio",
@@ -18592,6 +18675,18 @@ var NC_CONDITION_CATALOG = [
 				value: "device-consumable-normal",
 				label: "Consumable replaced"
 			},
+			{
+				value: "device-tank-low",
+				label: "Tank low (water, detergent)"
+			},
+			{
+				value: "device-tank-full",
+				label: "Tank full (dirty water, dust)"
+			},
+			{
+				value: "device-tank-normal",
+				label: "Tank back to normal"
+			},
 			{
 				value: "export-completed",
 				label: "Export completed"
@@ -18657,6 +18752,21 @@ var NC_CONDITION_CATALOG = [
 		phase: "P1",
 		description: "Restrict the rule to these devices; absent = all devices. A sensor event matches either the SENSOR that fired or the camera it is attributed to, so a rule may name either one."
 	},
+	{
+		id: "devicesExclude",
+		group: "scope",
+		label: "Excluded devices",
+		valueType: "deviceIdExcludeList",
+		operator: "notIn",
+		appliesTo: [
+			"immediate",
+			"track-end",
+			"device-event",
+			"package-event"
+		],
+		phase: "P1",
+		description: "Every device except these. Judged on the same device ids as Devices: a sensor event is excluded by the SENSOR that fired or by the camera it is attributed to."
+	},
 	{
 		id: "classes",
 		group: "class",
@@ -18913,6 +19023,33 @@ var NC_CONDITION_CATALOG = [
 		phase: "P1",
 		description: "Raw device event-type tokens (e.g. doorbell press / press_long) from the event-emitter slice; absent on doorbell-pulse / passive sensors."
 	},
+	{
+		id: "sensorTransition",
+		group: "device",
+		label: "Notify when",
+		valueType: "sensorTransition",
+		options: [
+			{
+				value: "",
+				label: "It triggers and when it clears",
+				hint: "Every change: water detected, and back to dry."
+			},
+			{
+				value: "raised",
+				label: "Only when it triggers",
+				hint: "Water detected, smoke, a contact opening — never the return to normal."
+			},
+			{
+				value: "cleared",
+				label: "Only when it clears",
+				hint: "Back to dry, smoke gone, a contact closing — never the alert itself."
+			}
+		],
+		operator: "in",
+		appliesTo: ["device-event"],
+		phase: "P2",
+		description: "Fire on one edge of a boolean sensor. Offered only when every chosen sensor kind raises and clears; a reading that cannot be placed still notifies."
+	},
 	{
 		id: "packagePhase",
 		group: "package",
@@ -19099,6 +19236,39 @@ var NcHistoryFilterSchema = zod.z.object({
 	limit: zod.z.number().int().min(1).max(500).default(100)
 });
 /**
+* The newest delivery row of ONE rule — the "Last run" of a rules table.
+*
+* A projection of the same outbox rows `getHistory` returns, so it records
+* DELIVERIES only: a throttled or unmatched evaluation never produced a row
+* and is not a run here. When one fire reached several targets (several rows
+* at the same `lastAt`), `status` is the least successful of them
+* (`dead` > `pending` > `sent`): "the last run delivered" must be true for
+* every target it names.
+*/
+var NcRuleLastRunSchema = zod.z.object({
+	ruleId: zod.z.string(),
+	/** Fire time of the newest row (`createdAt`, epoch ms). */
+	lastAt: zod.z.number(),
+	status: NcHistoryStatusSchema,
+	/** The camera/device of that row (a digest row files under its first camera). */
+	deviceId: zod.z.number()
+});
+/**
+* Every rule's last run, in one answer.
+*
+* A rule ABSENT from `runs` produced no delivery inside `horizonMs` — how far
+* back this answer looked, in ms before the hub's now. It is the outbox prune
+* window (7 days by default, operator-configurable), NARROWED when the read hit
+* its row bound: the answer never claims a window it did not read. `null` means
+* the operator keeps the outbox forever AND the read reached its end, so absent
+* means "never on record". A UI derives its "not in the last N days" from this
+* value, never from a constant — and only when the call ANSWERED (D315).
+*/
+var NcRuleLastRunsSchema = zod.z.object({
+	runs: zod.z.array(NcRuleLastRunSchema),
+	horizonMs: zod.z.number().nonnegative().nullable()
+});
+/**
 * What a snooze covers. Broader scopes win when several overlap, so one window
 * leaves ONE digest rather than a rule snooze and a whole-feed snooze both
 * summarising the same silence.
@@ -19285,6 +19455,14 @@ var NcAlarmModeCoverageSchema = zod.z.object({
 	/** Ids named by the covering rules. A SUBSET when `allDevices` is true. */
 	deviceIds: zod.z.array(zod.z.number().int()),
 	/**
+	* D641: the ids NOT covered although `allDevices` is true — every unscoped
+	* covering rule EXCLUDES them (`conditions.devicesExclude`) and no named rule
+	* covers them. Always `[]` when `allDevices` is false. Excluded by the rules,
+	* which is not the same as skipped by a switch: never in `skippedDevices`.
+	* Defaulted so an answer computed before this field parses as "none".
+	*/
+	allDevicesExcept: zod.z.array(zod.z.number().int()).default([]),
+	/**
 	* Devices this mode NAMES but cannot actually arm, each with the switch that
 	* excludes it.
 	*
@@ -19526,6 +19704,15 @@ var notificationRulesCapability = {
 		*/
 		getHistory: require_sleep.method(zod.z.object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), zod.z.object({ entries: zod.z.array(NcHistoryEntrySchema) }), { auth: "admin" }),
 		/**
+		* The newest delivery of every rule, in ONE bounded read of the outbox —
+		* the "Last run" column. Never a `getHistory` per rule. A rule with no
+		* delivery inside `horizonMs` is absent from `runs`; see
+		* {@link NcRuleLastRunsSchema} for what absent means. A store that cannot
+		* answer FAILS the call rather than answering "nothing ran". Admin-only,
+		* like `getHistory`, of which it is a projection.
+		*/
+		getRuleLastRuns: require_sleep.method(zod.z.object({}), NcRuleLastRunsSchema, { auth: "admin" }),
+		/**
 		* Mint a fresh, externally-reachable URL for one artefact a history row
 		* named in {@link NcHistoryEntrySchema.shape.artifactIds} — the SAME
 		* signed-link mechanism the dispatcher uses to attach media to an
@@ -31646,12 +31833,20 @@ reset: require_sleep.method(zod.z.object({
 	},
 	runtimeState: ConsumablesStatusSchema.extend({ lastFetchedAt: zod.z.number() }),
 	/**
-	* Runtime-state durability: **session** — the authority is the appliance; the provider re-reads the whole item array on connect.
+	* Runtime-state durability: **restored** — nothing else holds the value
+	* (D642). A consumable can often be read only in a device's wake window (the
+	* Dreame mower's CMS counters answer only while it charges), so a restart
+	* that wiped the slice left the panel empty and the alerts blind until the
+	* next wake — 2026-09-26, mower 503 idle with `items: []`. A restored item is
+	* the previous observation, not a claim about now; the provider overwrites it
+	* the moment it reads the device again.
 	*
 	* See `RuntimeStateDurability`. Enforced by
 	* `scripts/check-runtime-state-durability.ts`.
 	*/
-	durability: "session"
+	durability: "restored",
+	/** Clocks, not content: a re-read that changed no item costs no commit. */
+	volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
 };
 //#endregion
 //#region src/capabilities/contact.cap.ts
@@ -52863,6 +53058,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationRules.getRuleLastRuns": {
+		capName: "notification-rules",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"notificationRules.getTemplateCatalog": {
 		capName: "notification-rules",
 		capScope: "system",
@@ -58905,7 +59106,7 @@ function getCapsByProviderKind(kind) {
 //#region src/generated/runtime-state-durability.ts
 /**
 * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
-* `runtimeState`. 69 caps: 36 `restored`, 33 `session`.
+* `runtimeState`. 69 caps: 37 `restored`, 32 `session`.
 *
 * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
 * with `durability: 'session'` has one and has decided not to keep it.
@@ -58964,8 +59165,8 @@ var RUNTIME_STATE_POLICY = {
 		volatileFields: ["lastChangedAt"]
 	},
 	"consumables": {
-		durability: "session",
-		volatileFields: []
+		durability: "restored",
+		volatileFields: ["lastChangedAt", "lastFetchedAt"]
 	},
 	"contact": {
 		durability: "restored",
@@ -59216,6 +59417,7 @@ var RESTORED_CAP_NAMES = [
 	"binary",
 	"carbon-monoxide",
 	"connectivity",
+	"consumables",
 	"contact",
 	"cover",
 	"day-night",
@@ -60731,12 +60933,55 @@ function prepareNotification(caps, n) {
 }
 //#endregion
 //#region src/notification/system-event-filters.ts
-/** Every filter, for the callers that must cover all four (guards, tests). */
+/**
+* WHICH narrowing filter speaks about WHICH system-event kind — one predicate,
+* consumed by the rule ENGINE and by every rule EDITOR.
+*
+* ── The failure this file exists for ───────────────────────────────────────
+* `NcSystemEventConditionSchema` carries four optional narrowing lists
+* (`deviceIds`, `deviceTypes`, `nodeIds`, `packageNames`) beside a required
+* `kinds` gate. They are not four filters over one vocabulary: each belongs to
+* a FAMILY of kinds and is meaningless outside it. A node going away has no
+* device type; a completed export has no package; `stream-offline` deliberately
+* carries no device type at all (a stream belongs to a camera by construction).
+*
+* The engine applied all four to every kind, so a filter from one family failed
+* a kind from another family CLOSED. The operator's live rule "Eventi di
+* sistema" selected eleven kinds and set `deviceTypes: ['camera']` — the only
+* way to say "only my cameras" about the two liveness kinds — and NINE of the
+* eleven silently stopped being deliverable. Four days of history contained
+* `device-online` and `device-offline` and nothing else, across a window in
+* which agents were restarted and addons were updated.
+*
+* Both editors already computed this scoping, to decide which filter boxes to
+* render; the cap's own docblock already promised it ("Narrow a `device-*` kind
+* to these device TYPES"). Only the engine disagreed, and it disagreed in the
+* destructive direction. So the rule is stated ONCE, here, and the engine and
+* the editors are readers of it rather than three independent authors.
+*
+* ── The direction ─────────────────────────────────────────────────────────
+* Out of family ⇒ the filter is IGNORED, never fail-closed. An editor that
+* hides a box has already told the operator this filter does not speak about
+* these kinds, so honouring it as an exclusion contradicts the only
+* explanation the operator was ever given. Inside its family the filter still
+* narrows, and still fails CLOSED on a subject that cannot produce the identity
+* it tests (a device the mirror cannot name is not evidence of a camera).
+*/
+/**
+* Every filter, for the callers that must cover all of them (guards, tests).
+*
+* `consumableLowPercent` (D642) is not a list but it is a filter in exactly
+* this sense: it belongs to a family of kinds (the consumable pair) and the
+* engine consults it only there. It differs in one way the readers must know —
+* its ABSENCE is not "no narrowing" but the default threshold, because a
+* consumable episode is always judged at SOME threshold.
+*/
 var NC_SYSTEM_EVENT_FILTER_KEYS = [
 	"deviceIds",
 	"deviceTypes",
 	"nodeIds",
-	"packageNames"
+	"packageNames",
+	"consumableLowPercent"
 ];
 /**
 * Does `filter` say anything about `kind`?
@@ -60750,6 +60995,7 @@ function systemEventFilterApplies(kind, filter) {
 		case "deviceTypes": return kind.startsWith("device-") || kind === "detection-blind";
 		case "nodeIds": return kind.startsWith("node-") || kind === "addon-crash-loop" || kind === "addon-update-available" || kind === "addon-updated" || kind === "server-update-available" || kind === "wrapper-update-available" || kind === "server-updated";
 		case "packageNames": return kind.endsWith("update-available") || kind === "addon-updated" || kind === "server-updated";
+		case "consumableLowPercent": return NC_CONSUMABLE_SYSTEM_EVENT_KINDS.includes(kind);
 	}
 }
 /**
@@ -60798,6 +61044,9 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"device-battery-normal": "device-events",
 	"device-consumable-low": "device-events",
 	"device-consumable-normal": "device-events",
+	"device-tank-low": "device-events",
+	"device-tank-full": "device-events",
+	"device-tank-normal": "device-events",
 	"stream-online": "device-events",
 	"stream-offline": "device-events",
 	"detection-blind": "device-events",
@@ -60830,7 +61079,7 @@ var NC_SYSTEM_EVENT_FAMILY = {
 var FAMILY_BY_NAME = new Map(Object.entries(NC_SYSTEM_EVENT_FAMILY));
 var NC_SYSTEM_EVENT_CONDITION_FILTER_KEYS = [...NC_SYSTEM_EVENT_FILTER_KEYS, "excludeDeviceIds"];
 /**
-* The filters a family may carry. The four base filters are the union of
+* The filters a family may carry. The base filters are the union of
 * `systemEventFilterApplies` over the family's kinds (the spec pins that
 * equality). `excludeDeviceIds` is a device-events filter only: an alarm is
 * narrowed to the camera that triggered it and excludes nothing.
@@ -60839,7 +61088,8 @@ var NC_SYSTEM_EVENT_FAMILY_FILTERS = {
 	"device-events": [
 		"deviceIds",
 		"excludeDeviceIds",
-		"deviceTypes"
+		"deviceTypes",
+		"consumableLowPercent"
 	],
 	system: ["nodeIds", "packageNames"],
 	alarm: ["deviceIds"]
@@ -60874,6 +61124,16 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 		label: "Consumables",
 		kinds: ["device-consumable-low", "device-consumable-normal"]
 	},
+	{
+		id: "tanks",
+		family: "device-events",
+		label: "Tanks",
+		kinds: [
+			"device-tank-low",
+			"device-tank-full",
+			"device-tank-normal"
+		]
+	},
 	{
 		id: "detection-blind",
 		family: "device-events",
@@ -61016,6 +61276,7 @@ function systemFamilyOfKind(kind) {
 */
 var NO_SENSOR_KIND = "An occupancy edge is not a sensor event: it carries no sensor kind, so this condition can never match one.";
 var NO_EVENT_TOKEN = "An occupancy edge carries no device event-type token — that comes from an event-emitter slice, which a count crossing has none of.";
+var NO_SENSOR_EDGE = "An occupancy edge is a count crossing, not a sensor reading: it has no raise or clear, so this choice could never narrow it.";
 var OCCUPANCY_SOURCE = "An occupancy edge is always produced by the pipeline, so any other source can never match and “pipeline” narrows nothing.";
 var AUDIO_SOURCE = "A confirmed sound window is always stamped as an audio subject, so any other source can never match.";
 var SOUND_NOT_A_PICTURE = "A sound rule fires on what the camera HEARD. Its subject carries no detection, so this condition can never match one — name the sounds in the Sound condition instead.";
@@ -61047,6 +61308,7 @@ var NC_RULE_KIND_SPECS = [
 		excluded: {
 			sensorKinds: NO_SENSOR_KIND,
 			eventTypeTokens: NO_EVENT_TOKEN,
+			sensorTransition: NO_SENSOR_EDGE,
 			source: OCCUPANCY_SOURCE
 		},
 		editable: true,
@@ -61500,11 +61762,121 @@ function isScheduleActive(schedule, atMs) {
 	return schedule.invert === true ? !inside : inside;
 }
 //#endregion
+//#region src/notification/alarm-membership.ts
+var ARMED_WORD_PREFIX = "armed_";
+var ALARM_PANEL_CAP = "alarm-panel";
+var ALARM_PANEL_TRIGGER_METHOD = "trigger";
+/**
+* The sensor-event kinds that are OPENINGS to the alarm — the keys of the
+* engine's opening table (`alarm-openings.ts`, which is checked against this
+* list with `satisfies`). Only these carry an opening edge the alarm refuses.
+*/
+var NC_ALARM_OPENING_EVENT_KINDS = [
+	"contact",
+	"cover",
+	"lock"
+];
+/**
+* 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).
+*/
+function ruleBelongsToAlarm(rule) {
+	if ((rule.conditions.deviceState?.states ?? []).some((s) => s.trim().toLowerCase().startsWith(ARMED_WORD_PREFIX))) return true;
+	return (rule.onTrigger ?? []).some((sequence) => sequence.enabled && sequence.actions.some((step) => step.kind === "cap" && step.cap === ALARM_PANEL_CAP && step.method === ALARM_PANEL_TRIGGER_METHOD));
+}
+function isOpeningKind(kind) {
+	const k = kind.trim().toLowerCase();
+	return NC_ALARM_OPENING_EVENT_KINDS.some((opening) => opening === k);
+}
+/**
+* An alarm rule over openings only, asking for the CLEAR: the alarm edge
+* refuses every closing, and the chosen edge refuses every opening, so nothing
+* is left (D640 × D630). Not refused on save — alarm membership is derived and
+* can change with an action edit — but every editor must SAY it.
+*/
+function sensorTransitionNeverFires(rule) {
+	const kinds = rule.conditions.sensorKinds ?? [];
+	if (rule.conditions.sensorTransition !== "cleared" || kinds.length === 0) return false;
+	if (!kinds.every(isOpeningKind)) return false;
+	return ruleBelongsToAlarm(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/sensor-raised.ts
+/**
+* WHICH WAY A BOOLEAN SENSOR MOVED — read off the one slice a sensor event
+* persists (D640 "a sensor rule fires on the raise, the clear, or both").
+*
+* A device-event rule over a flood sensor notified on BOTH edges: water
+* detected, and back to dry. `NcConditions.sensorTransition` lets the rule
+* name one edge; this file answers, for one `SensorEvent`, which edge it is.
+*
+* NOT A SECOND TABLE. The "which boolean of this cap counts as HIGH" question
+* already has one answer, `SOURCE_CAP_ACTIVE_FIELD`
+* (`catalogs/sensor-active-state.ts`, the doorbell's and the recorder's edge
+* table), and a sensor event names its kind, not its cap. So the table here is
+* DERIVED: event kind → cap (`EVENT_KIND_BY_CAP`) → that cap's active field.
+* Only kinds whose taxonomy category is `sensor` take part — a switch has an
+* `on` boolean too, but "it triggers / it clears" is not a sentence about a
+* light, and offering it there would be a knob with a misleading label.
+* `presence` is a WORD (`home` / `not_home` / a zone), not a boolean, and is
+* absent from the source table, so it is absent here.
+*
+* `undefined` = never guessed: a kind with no raise (a doorbell press, a
+* button, a cover), or a slice whose field is missing or not a boolean. The
+* engine then does NOT filter — a flood alert must not go silent because one
+* read came back unreadable (the same stance as the alarm's `sensorEdgeOf`).
+*
+* Pure, RN-safe: the viewer imports the support rule from here.
+*/
+/** Event kind → the boolean field of its cap slice that means "raised". */
+var NC_SENSOR_RAISED_FIELD_BY_KIND = Object.freeze(Object.fromEntries(Object.entries(EVENT_KIND_BY_CAP).flatMap(([capName, descriptor]) => {
+	const field = SOURCE_CAP_ACTIVE_FIELD[capName];
+	if (field === void 0 || descriptor.category !== "sensor") return [];
+	return [[descriptor.kind, field]];
+})));
+/** The sensor kinds `sensorTransition` means something for. */
+var NC_SENSOR_TRANSITION_KINDS = Object.freeze(Object.keys(NC_SENSOR_RAISED_FIELD_BY_KIND));
+function normaliseKind(kind) {
+	return kind.trim().toLowerCase();
+}
+/**
+* true = the sensor is raised (water, smoke, open, tampered…), false = it
+* cleared, undefined = this kind has no raise or the slice cannot say.
+*/
+function sensorRaisedOf(kind, value) {
+	if (value === null) return void 0;
+	const field = NC_SENSOR_RAISED_FIELD_BY_KIND[normaliseKind(kind)];
+	if (field === void 0) return void 0;
+	const raw = Object.entries(value).find(([key]) => key === field)?.[1];
+	return typeof raw === "boolean" ? raw : void 0;
+}
+/**
+* THE SUPPORT RULE, shared by both editors: "Notify when" is offered only when
+* the rule names at least one sensor kind and EVERY kind it names has a raise.
+* A mixed rule (flood + doorbell) would hear "only when it clears" as "never
+* for the doorbell" in the operator's head while the engine lets the doorbell
+* through — so the choice is not offered, and an editor prunes it on save.
+*/
+function sensorTransitionOffered(sensorKinds) {
+	if (sensorKinds === void 0 || sensorKinds.length === 0) return false;
+	return sensorKinds.every((kind) => NC_SENSOR_TRANSITION_KINDS.includes(normaliseKind(kind)));
+}
+/** What an editor tells the operator when it is about to prune the choice. */
+var NC_SENSOR_TRANSITION_UNSUPPORTED_REASON = "Only a sensor that raises and clears (water, smoke, gas, CO, vibration, tamper, motion, contact) can fire on one edge. Pick only such sensor kinds, or the rule fires on every change.";
+//#endregion
 //#region src/notification/template-vars.ts
 var RULE_BODY_ONLY = ["body"];
 var RULE_TEXT = ["title", "body"];
 var BATTERY = ["device-battery-low", "device-battery-normal"];
 var CONSUMABLE = ["device-consumable-low", "device-consumable-normal"];
+var TANK = [
+	"device-tank-low",
+	"device-tank-full",
+	"device-tank-normal"
+];
 var UPDATES = [
 	"addon-update-available",
 	"server-update-available",
@@ -61530,6 +61902,7 @@ var DEVICE_EVENTS = [
 	"device-enabled",
 	...BATTERY,
 	...CONSUMABLE,
+	...TANK,
 	"stream-online",
 	"stream-offline",
 	"detection-blind",
@@ -61827,6 +62200,17 @@ var NC_TEMPLATE_VARS = [
 		kinds: ["system"],
 		systemEventKinds: [...CONSUMABLE]
 	},
+	{
+		name: "tank",
+		label: "Tank",
+		description: "Which tank: clean water, dirty water, detergent or dust bin.",
+		example: "clean water",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...TANK]
+	},
 	{
 		name: "profile",
 		label: "Stream profile",
@@ -62219,6 +62603,38 @@ var NC_TEMPLATE_VARS = [
 		fields: [...RULE_TEXT]
 	}
 ];
+/**
+* System-event kinds the SERVED catalog holds back (D642): the kinds the hub
+* produces before the installed viewers can parse them.
+*
+* The viewer parses `getTemplateCatalog` WHOLE, with its own strict
+* `NcSystemEventKindSchema` on every descriptor's `systemEventKinds`, so one
+* kind it does not know — in `{{deviceName}}`, which every device event names —
+* empties every {{var}} picker on every phone (the same trap
+* `NcTemplateVarKindSchema` froze the rule kinds for). The in-process catalog
+* keeps them: the producer parity and the preview render read it.
+*
+* SELF-EXPIRING: `scripts/check-nc-mirrors-in-sync.ts` reads this list as the
+* viewer's allowance and fails the day the viewer mirrors one of these kinds —
+* delete it from here then, and the served catalog names it again.
+*/
+var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
+	"device-tank-low",
+	"device-tank-full",
+	"device-tank-normal"
+];
+/**
+* The catalog as `getTemplateCatalog` SERVES it: every descriptor, with the
+* held-back kinds removed from its `systemEventKinds`. A descriptor that named
+* only held-back kinds is served with an empty list — offered to no system
+* rule an installed viewer can author, which is exactly true.
+*/
+function servedTemplateVars() {
+	return NC_TEMPLATE_VARS.map((d) => d.systemEventKinds === void 0 ? d : {
+		...d,
+		systemEventKinds: d.systemEventKinds.filter((kind) => !NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS.includes(kind))
+	});
+}
 /** The caption fields see a fixed, smaller vocabulary (`timelapsePreviewText`,
 *  `summaryCaptionText`). Declared here rather than as `fields` on every
 *  descriptor so the whole rule stays in one line of code. */
@@ -65910,6 +66326,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_OPENING_EVENT_KINDS = NC_ALARM_OPENING_EVENT_KINDS;
 exports.NC_ALARM_SYSTEM_EVENT_KINDS = NC_ALARM_SYSTEM_EVENT_KINDS;
 exports.NC_AUDIO_CONFIRM_HITS_DEFAULT = NC_AUDIO_CONFIRM_HITS_DEFAULT;
 exports.NC_AUDIO_CONFIRM_HITS_MAX = NC_AUDIO_CONFIRM_HITS_MAX;
@@ -65937,6 +66354,9 @@ exports.NC_CONFIRM_DEFAULT_MAX_IMAGE_PX = NC_CONFIRM_DEFAULT_MAX_IMAGE_PX;
 exports.NC_CONFIRM_DEFAULT_TIMEOUT_MS = NC_CONFIRM_DEFAULT_TIMEOUT_MS;
 exports.NC_CONFIRM_MAX_TIMEOUT_MS = NC_CONFIRM_MAX_TIMEOUT_MS;
 exports.NC_CONFIRM_MIN_TIMEOUT_MS = NC_CONFIRM_MIN_TIMEOUT_MS;
+exports.NC_CONSUMABLE_LOW_PERCENT_DEFAULT = NC_CONSUMABLE_LOW_PERCENT_DEFAULT;
+exports.NC_CONSUMABLE_LOW_PERCENT_MAX = NC_CONSUMABLE_LOW_PERCENT_MAX;
+exports.NC_CONSUMABLE_SYSTEM_EVENT_KINDS = NC_CONSUMABLE_SYSTEM_EVENT_KINDS;
 exports.NC_DEFAULT_SNOOZE_MINUTES = NC_DEFAULT_SNOOZE_MINUTES;
 exports.NC_HISTORY_LIMIT_DEFAULT = NC_HISTORY_LIMIT_DEFAULT;
 exports.NC_HISTORY_LIMIT_MAX = NC_HISTORY_LIMIT_MAX;
@@ -65946,6 +66366,10 @@ exports.NC_RULE_CLEARABLE_KEYS = NC_RULE_CLEARABLE_KEYS;
 exports.NC_RULE_EDITOR_SECTION_ORDER = NC_RULE_EDITOR_SECTION_ORDER;
 exports.NC_RULE_KIND_SPECS = NC_RULE_KIND_SPECS;
 exports.NC_RULE_SECTIONS = NC_RULE_SECTIONS;
+exports.NC_SENSOR_RAISED_FIELD_BY_KIND = NC_SENSOR_RAISED_FIELD_BY_KIND;
+exports.NC_SENSOR_TRANSITION_KINDS = NC_SENSOR_TRANSITION_KINDS;
+exports.NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING = NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING;
+exports.NC_SENSOR_TRANSITION_UNSUPPORTED_REASON = NC_SENSOR_TRANSITION_UNSUPPORTED_REASON;
 exports.NC_SERVER_PACKAGE_NAME = NC_SERVER_PACKAGE_NAME;
 exports.NC_SNOOZE_MAX_MINUTES = NC_SNOOZE_MAX_MINUTES;
 exports.NC_SYSTEM_DELIVERY = NC_SYSTEM_DELIVERY;
@@ -65956,7 +66380,9 @@ exports.NC_SYSTEM_EVENT_FAMILY_FILTERS = NC_SYSTEM_EVENT_FAMILY_FILTERS;
 exports.NC_SYSTEM_EVENT_FILTER_KEYS = NC_SYSTEM_EVENT_FILTER_KEYS;
 exports.NC_SYSTEM_EVENT_KIND_GROUP_SPECS = NC_SYSTEM_EVENT_KIND_GROUP_SPECS;
 exports.NC_SYSTEM_RULE_KINDS = NC_SYSTEM_RULE_KINDS;
+exports.NC_TANK_SYSTEM_EVENT_KINDS = NC_TANK_SYSTEM_EVENT_KINDS;
 exports.NC_TAXONOMY = NC_TAXONOMY;
+exports.NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS;
 exports.NC_TEMPLATE_VARS = NC_TEMPLATE_VARS;
 exports.NC_UPDATE_EVENT_PACKAGE_NAMES = NC_UPDATE_EVENT_PACKAGE_NAMES;
 exports.NETWORK_LINK_TYPES = NETWORK_LINK_TYPES;
@@ -66015,6 +66441,8 @@ exports.NcRuleActionsSchema = NcRuleActionsSchema;
 exports.NcRuleClearableKeySchema = NcRuleClearableKeySchema;
 exports.NcRuleInputSchema = NcRuleInputSchema;
 exports.NcRuleKindSchema = NcRuleKindSchema;
+exports.NcRuleLastRunSchema = NcRuleLastRunSchema;
+exports.NcRuleLastRunsSchema = NcRuleLastRunsSchema;
 exports.NcRuleNotificationButtonSchema = NcRuleNotificationButtonSchema;
 exports.NcRulePatchSchema = NcRulePatchSchema;
 exports.NcRuleSchema = NcRuleSchema;
@@ -66023,6 +66451,7 @@ exports.NcRuleUpdateInputSchema = NcRuleUpdateInputSchema;
 exports.NcSceneConditionSchema = NcSceneConditionSchema;
 exports.NcScheduleSchema = NcScheduleSchema;
 exports.NcScheduleWindowSchema = NcScheduleWindowSchema;
+exports.NcSensorTransitionSchema = NcSensorTransitionSchema;
 exports.NcSnoozeInputSchema = NcSnoozeInputSchema;
 exports.NcSnoozeSchema = NcSnoozeSchema;
 exports.NcSnoozeScopeSchema = NcSnoozeScopeSchema;
@@ -66602,6 +67031,7 @@ exports.conditionExclusionReason = conditionExclusionReason;
 exports.conditionVisibleForKind = conditionVisibleForKind;
 exports.connectionTestCapability = connectionTestCapability;
 exports.connectivityCapability = connectivityCapability;
+exports.consumableLowPercentOf = consumableLowPercentOf;
 exports.consumablesCapability = consumablesCapability;
 exports.contactCapability = contactCapability;
 exports.controlCapability = controlCapability;
@@ -66926,6 +67356,7 @@ exports.resolveStreamMaps = require_canonical_hash.resolveStreamMaps;
 exports.resolveVariantModelId = resolveVariantModelId;
 exports.resolveViewableDeviceIds = resolveViewableDeviceIds;
 exports.roleSpec = roleSpec;
+exports.ruleBelongsToAlarm = ruleBelongsToAlarm;
 exports.ruleEditorSectionsForKind = ruleEditorSectionsForKind;
 exports.ruleKindOf = ruleKindOf;
 exports.ruleKindSpec = ruleKindSpec;
@@ -66946,6 +67377,10 @@ exports.scoreRuntimes = scoreRuntimes;
 exports.scriptRunnerCapability = scriptRunnerCapability;
 exports.searchDisplayIcons = searchDisplayIcons;
 exports.selectAssignedProfileSlots = require_sleep.selectAssignedProfileSlots;
+exports.sensorRaisedOf = sensorRaisedOf;
+exports.sensorTransitionNeverFires = sensorTransitionNeverFires;
+exports.sensorTransitionOffered = sensorTransitionOffered;
+exports.servedTemplateVars = servedTemplateVars;
 exports.serverManagementCapability = serverManagementCapability;
 exports.setByPath = setByPath;
 exports.settingsStoreCapability = settingsStoreCapability;