@camstack/types 1.2.395 → 1.2.397

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-Re8daN0Y.js");
-const require_event_category = require("./event-category-eSqkye-K.js");
+const require_sleep = require("./sleep-Bo7fq491.js");
+const require_event_category = require("./event-category-kpu1bZMs.js");
 const require_composition = require("./composition-eoYYVfOp.js");
 const require_node_color = require("./node-color.js");
 const require_err_msg = require("./err-msg-BhVbr0NX.js");
@@ -43460,6 +43460,8 @@ var NcSystemEventKindSchema = zod.z.enum([
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
+	"rule-broken",
+	"rule-repaired",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -45167,6 +45169,14 @@ var NC_CONDITION_CATALOG = [
 				value: "alert-critical-resolved",
 				label: "Critical alert resolved"
 			},
+			{
+				value: "rule-broken",
+				label: "Notification rule broken"
+			},
+			{
+				value: "rule-repaired",
+				label: "Notification rule repaired"
+			},
 			{
 				value: "alarm-arm-refused",
 				label: "Alarm arm refused"
@@ -95479,6 +95489,8 @@ var NC_SYSTEM_EVENT_FAMILY = {
 	"alert-critical": "system",
 	"alert-error": "system",
 	"alert-critical-resolved": "system",
+	"rule-broken": "system",
+	"rule-repaired": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -95631,6 +95643,12 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"alert-critical-resolved"
 		]
 	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Notification rules",
+		kinds: ["rule-broken", "rule-repaired"]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -98050,6 +98068,47 @@ var NC_TEMPLATE_VARS = [
 		kinds: ["system"],
 		systemEventKinds: ["recording-degraded", ...ALERT_EPISODE]
 	},
+	{
+		name: "ruleName",
+		label: "Rule name",
+		example: "Robot",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["rule-broken", "rule-repaired"]
+	},
+	{
+		name: "ruleId",
+		label: "Rule id",
+		example: "3db3e226-9b82-4681-a200-de13b260aa48",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["rule-broken", "rule-repaired"]
+	},
+	{
+		name: "brokenReason",
+		label: "Why the rule is broken",
+		description: "unparseable, device-deleted or target-deleted",
+		example: "device-deleted",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["rule-broken"]
+	},
+	{
+		name: "offendingIds",
+		label: "Deleted devices or destinations",
+		example: "4483",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["rule-broken"]
+	},
 	{
 		name: "locationName",
 		label: "Storage location",
@@ -98505,7 +98564,9 @@ var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
 	"node-updating",
 	"alert-critical",
 	"alert-error",
-	"alert-critical-resolved"
+	"alert-critical-resolved",
+	"rule-broken",
+	"rule-repaired"
 ];
 /**
 * The catalog as `getTemplateCatalog` SERVES it: every descriptor, with the
@@ -98611,6 +98672,182 @@ function isKnownTemplateVar(name, ctx) {
 	return templateVarsFor(ctx).some((d) => d.dynamic !== void 0 ? name.startsWith(d.dynamic.prefix) && name.length > d.dynamic.prefix.length : d.name === name);
 }
 //#endregion
+//#region src/notification/system-event-classes.ts
+var NC_SYSTEM_EVENT_CLASS_SPECS = [
+	{
+		id: "device-connectivity",
+		family: "device-events",
+		label: "Device connectivity (offline / back online)",
+		bad: ["device-offline"],
+		recovery: ["device-online"],
+		snapshotLabel: "Devices offline now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "device-switch",
+		family: "device-events",
+		label: "Device switched off / back on",
+		bad: ["device-disabled"],
+		recovery: ["device-enabled"],
+		snapshotLabel: "Devices switched off now",
+		snapshotSection: "device-state"
+	},
+	{
+		id: "stream-connectivity",
+		family: "device-events",
+		label: "Stream connectivity (offline / back online)",
+		bad: ["stream-offline"],
+		recovery: ["stream-online"],
+		snapshotLabel: "Streams offline now",
+		snapshotSection: "streams"
+	},
+	{
+		id: "battery",
+		family: "device-events",
+		label: "Battery (low / back to normal)",
+		bad: ["device-battery-low"],
+		recovery: ["device-battery-normal"],
+		snapshotLabel: "Batteries low now",
+		snapshotSection: "battery"
+	},
+	{
+		id: "consumables",
+		family: "device-events",
+		label: "Consumables (low / replaced)",
+		bad: ["device-consumable-low"],
+		recovery: ["device-consumable-normal"],
+		snapshotLabel: "Consumables low now",
+		snapshotSection: "consumables"
+	},
+	{
+		id: "tanks",
+		family: "device-events",
+		label: "Tanks (low or full / back to normal)",
+		bad: ["device-tank-low", "device-tank-full"],
+		recovery: ["device-tank-normal"],
+		snapshotLabel: "Tanks low or full now",
+		snapshotSection: "tanks"
+	},
+	{
+		id: "recording-health",
+		family: "device-events",
+		label: "Recording health (stalled or degraded / recording again)",
+		bad: ["recording-stalled", "recording-degraded"],
+		recovery: ["recording-healthy"],
+		snapshotLabel: "Recordings stalled now",
+		snapshotSection: null
+	},
+	{
+		id: "node-connectivity",
+		family: "system",
+		label: "Node connectivity (offline / back online)",
+		bad: ["node-offline"],
+		recovery: ["node-online"],
+		snapshotLabel: "Nodes offline now",
+		snapshotSection: "nodes"
+	},
+	{
+		id: "storage-space",
+		family: "system",
+		label: "Storage space (low or critical / ok again)",
+		bad: ["storage-location-low", "storage-location-critical"],
+		recovery: ["storage-location-ok"],
+		snapshotLabel: "Storage locations low now",
+		snapshotSection: null
+	},
+	{
+		id: "critical-alerts",
+		family: "system",
+		label: "Critical alerts (raised / resolved)",
+		bad: ["alert-critical"],
+		recovery: ["alert-critical-resolved"],
+		snapshotLabel: "Critical alerts open now",
+		snapshotSection: null
+	},
+	{
+		id: "rule-health",
+		family: "system",
+		label: "Rule health (broken / repaired)",
+		bad: ["rule-broken"],
+		recovery: ["rule-repaired"],
+		snapshotLabel: "Notification rules broken now",
+		snapshotSection: null
+	}
+];
+var CLASS_BY_KIND = new Map(NC_SYSTEM_EVENT_CLASS_SPECS.flatMap((spec) => [...spec.bad, ...spec.recovery].map((kind) => [kind, spec])));
+/** Every edge of a class: what an instant rule selecting it listens to. */
+function systemEventClassKinds(spec) {
+	return [...spec.bad, ...spec.recovery];
+}
+/** The class a kind belongs to, or `undefined` for a one-edge kind. */
+function systemEventClassOf(kind) {
+	return CLASS_BY_KIND.get(kind);
+}
+/** Is this kind a RECOVERY edge of some class? */
+function isSystemEventRecoveryKind(kind) {
+	return systemEventClassOf(kind)?.recovery.some((k) => k === kind) ?? false;
+}
+/** The classes of ONE family, for that family's editor. */
+function systemEventClassesFor(family) {
+	return NC_SYSTEM_EVENT_CLASS_SPECS.filter((spec) => spec.family === family);
+}
+/**
+* A kind list with the OTHER front of every class it touches: a bad edge
+* brings the class's recovery, a recovery brings the class's bad edges. A
+* sibling bad edge is never added by a bad edge — a rule on
+* `storage-location-critical` does not start hearing `storage-location-low`.
+* Input order is kept, each added edge right after the kind that brought it.
+* Kinds of no class (and legacy names) pass through.
+*/
+function expandSystemEventClasses(kinds) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	const push = (kind) => {
+		if (seen.has(kind)) return;
+		seen.add(kind);
+		out.push(kind);
+	};
+	const listed = new Set(kinds);
+	for (const kind of kinds) {
+		push(kind);
+		const spec = systemEventClassOf(kind);
+		if (spec === void 0) continue;
+		const hasBad = spec.bad.some((k) => listed.has(k));
+		if (spec.bad.some((k) => k === kind)) for (const edge of spec.recovery) push(edge);
+		else if (!hasBad) for (const edge of spec.bad) push(edge);
+	}
+	return out;
+}
+/** Does this rule speak per EVENT (not a scheduled summary)? */
+function isInstantSystemRule(rule) {
+	if (rule.delivery !== "system-event") return false;
+	return rule.systemEventDelivery?.mode !== "summary";
+}
+/**
+* An INSTANT system rule with each class it touches completed with both edges;
+* the rule itself (same object) when there is nothing to add, a summary rule,
+* or a rule spanning families (`mixed` stays read-only, D637). A copy, never a
+* mutation.
+*/
+function withSystemEventClasses(rule) {
+	const condition = rule.conditions.systemEvent;
+	if (condition === void 0 || !isInstantSystemRule(rule)) return rule;
+	const families = new Set(condition.kinds.map((kind) => NC_SYSTEM_EVENT_FAMILY[kind]));
+	if (families.size !== 1 || families.has(null)) return rule;
+	const kinds = expandSystemEventClasses(condition.kinds);
+	if (kinds.length === condition.kinds.length) return rule;
+	return {
+		...rule,
+		conditions: {
+			...rule.conditions,
+			systemEvent: {
+				...condition,
+				kinds
+			}
+		}
+	};
+}
+//#endregion
 //#region src/notification/system-event-summary.ts
 /** The families a rule may summarise. The alarm is not one of them. */
 var NC_SYSTEM_EVENT_SUMMARY_FAMILIES = ["device-events", "system"];
@@ -104846,6 +105083,7 @@ exports.NC_SENSOR_TRANSITION_UNSUPPORTED_REASON = NC_SENSOR_TRANSITION_UNSUPPORT
 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;
+exports.NC_SYSTEM_EVENT_CLASS_SPECS = NC_SYSTEM_EVENT_CLASS_SPECS;
 exports.NC_SYSTEM_EVENT_CONDITION_FILTER_KEYS = NC_SYSTEM_EVENT_CONDITION_FILTER_KEYS;
 exports.NC_SYSTEM_EVENT_FAMILIES = NC_SYSTEM_EVENT_FAMILIES;
 exports.NC_SYSTEM_EVENT_FAMILY = NC_SYSTEM_EVENT_FAMILY;
@@ -106017,6 +106255,7 @@ exports.evictionPolicyOfLocation = evictionPolicyOfLocation;
 exports.expandAudioChunkToF32le = require_sleep.expandAudioChunkToF32le;
 exports.expandCapMethods = require_sleep.expandCapMethods;
 exports.expandContainer = expandContainer;
+exports.expandSystemEventClasses = expandSystemEventClasses;
 exports.exportSubjectOf = exportSubjectOf;
 exports.exposeBlockDevices = exposeBlockDevices;
 exports.expressionContainsBuiltinCall = expressionContainsBuiltinCall;
@@ -106158,6 +106397,7 @@ exports.isStatefulBuiltin = require_composition.isStatefulBuiltin;
 exports.isStorageLocationMode = isStorageLocationMode;
 exports.isSystemDelivery = isSystemDelivery;
 exports.isSystemEventFamily = isSystemEventFamily;
+exports.isSystemEventRecoveryKind = isSystemEventRecoveryKind;
 exports.isSystemEventSummaryRule = isSystemEventSummaryRule;
 exports.isSystemRuleKind = isSystemRuleKind;
 exports.isVectorIndexDimConflict = isVectorIndexDimConflict;
@@ -106525,6 +106765,9 @@ exports.switchedOffIds = switchedOffIds;
 exports.syncActiveAlarmProfileSettings = syncActiveAlarmProfileSettings;
 exports.synthesizeSourceInfo = synthesizeSourceInfo;
 exports.systemCapability = systemCapability;
+exports.systemEventClassKinds = systemEventClassKinds;
+exports.systemEventClassOf = systemEventClassOf;
+exports.systemEventClassesFor = systemEventClassesFor;
 exports.systemEventDeliveryProblems = systemEventDeliveryProblems;
 exports.systemEventFamilyOf = systemEventFamilyOf;
 exports.systemEventFamilyProblems = systemEventFamilyProblems;
@@ -106602,6 +106845,7 @@ exports.wiringProbeKindSchema = wiringProbeKindSchema;
 exports.wiringProbeResultSchema = wiringProbeResultSchema;
 exports.withFieldFrom = withFieldFrom;
 exports.withLocationMode = withLocationMode;
+exports.withSystemEventClasses = withSystemEventClasses;
 exports.withoutCallerStamp = require_sleep.withoutCallerStamp;
 exports.withoutField = withoutField;
 exports.writeModelBoundSetting = writeModelBoundSetting;