@camstack/types 1.1.50 → 1.1.51

package/dist/index.js

@@ -2772,6 +2772,143 @@ function getAudioMacroClassIds() {
 	return AUDIO_MACRO_LABELS.map((l) => l.id);
 }
 //#endregion
+//#region src/catalogs/event-taxonomy.ts
+/**
+* Unified event-kind taxonomy — THE single source of truth for
+* `kind → { parentKind, category, level, color, iconId, labelKey, label,
+* icon }`.
+*
+* This dictionary folds together what used to be scattered across four
+* copies:
+*   - `capabilities/sensor-event-kinds.ts` (sensor cap colors)
+*   - `addon-post-analysis/.../services/event-kinds.ts`
+*     (MOTION/PERSON/VEHICLE… _COLOR constants)
+*   - `ui-library/composites/detection-colors.ts` (CLASS_COLORS)
+*   - `addon-post-analysis/shared/frame/box-drawer.ts` (DEFAULT_COLOR)
+*   - the COCO / audio class maps (macro ↔ sub relationships)
+*
+* The DATA (serializable — color/iconId/labelKey/parentKind) lives here in
+* `@camstack/types`. The UI-side mapping `iconId → lucide component` and
+* `labelKey → t()` lives in `@camstack/ui-library`. UIs never hardcode a
+* color or an icon: they read this dictionary (server descriptors carry the
+* fields inline; the client resolves color/icon/label from `iconId`/`kind`).
+*
+* Two levels only (v1 YAGNI): macro → sub. `person` is a leaf macro.
+*/
+var TAXONOMY_COLORS = {
+	motion: "#f59e0b",
+	audio: "#06b6d4",
+	person: "#22c55e",
+	vehicle: "#3b82f6",
+	animal: "#f97316",
+	package: "#a855f7",
+	sensor: "#8b5cf6",
+	control: "#10b981",
+	genericDetection: "#64748b"
+};
+/** Global default color when a kind is unknown (matches legacy box-drawer). */
+var DEFAULT_EVENT_COLOR = "#22ff55";
+var DETECTION_SUB_COLORS = {
+	car: "#f59e0b",
+	truck: "#d97706",
+	bus: "#b45309",
+	motorcycle: "#eab308",
+	bicycle: "#ca8a04",
+	airplane: "#60a5fa",
+	boat: "#2563eb",
+	train: "#1d4ed8",
+	bird: "#14b8a6",
+	dog: "#84cc16",
+	cat: "#f97316",
+	horse: "#a16207",
+	sheep: "#a3a3a3",
+	cow: "#78716c",
+	elephant: "#6b7280",
+	bear: "#7c2d12",
+	zebra: "#404040",
+	giraffe: "#d4a373"
+};
+function titleCase(id) {
+	return id.split(/[-_ ]/).filter((p) => p.length > 0).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ");
+}
+var entries = /* @__PURE__ */ new Map();
+function macro(kind, category, color, iconId, label) {
+	entries.set(kind, {
+		kind,
+		parentKind: null,
+		level: "macro",
+		category,
+		color,
+		iconId,
+		labelKey: `eventKind.${kind}`,
+		label
+	});
+}
+function sub(kind, parentKind, category, color, iconId, label) {
+	entries.set(kind, {
+		kind,
+		parentKind,
+		level: "sub",
+		category,
+		color,
+		iconId,
+		labelKey: `eventKind.${kind}`,
+		label
+	});
+}
+macro("motion", "motion", TAXONOMY_COLORS.motion, "motion", "Motion");
+macro("audio", "audio", TAXONOMY_COLORS.audio, "audio", "Audio");
+macro("person", "detection", TAXONOMY_COLORS.person, "person", "Person");
+macro("vehicle", "detection", TAXONOMY_COLORS.vehicle, "vehicle", "Vehicle");
+macro("animal", "detection", TAXONOMY_COLORS.animal, "animal", "Animal");
+macro("package", "package", TAXONOMY_COLORS.package, "package", "Package");
+macro("sensor", "sensor", TAXONOMY_COLORS.sensor, "sensor", "Sensor");
+macro("control", "control", TAXONOMY_COLORS.control, "control", "Control");
+for (const [cocoClass, macroClass] of Object.entries(COCO_TO_MACRO.mapping)) {
+	if (macroClass !== "vehicle" && macroClass !== "animal") continue;
+	if (entries.has(cocoClass)) continue;
+	sub(cocoClass, macroClass, "detection", DETECTION_SUB_COLORS[cocoClass] ?? TAXONOMY_COLORS.genericDetection, cocoClass, titleCase(cocoClass));
+}
+sub("package-delivered", "package", "package", TAXONOMY_COLORS.package, "package", "Package delivered");
+sub("package-picked-up", "package", "package", TAXONOMY_COLORS.package, "package", "Package picked up");
+sub("contact", "sensor", "sensor", "#f59e0b", "door", "Contact");
+sub("motion-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "pir", "Motion sensor");
+sub("smoke", "sensor", "sensor", "#ef4444", "smoke", "Smoke");
+sub("flood", "sensor", "sensor", "#3b82f6", "water", "Water leak");
+sub("gas", "sensor", "sensor", "#ef4444", "gas", "Gas");
+sub("carbon-monoxide", "sensor", "sensor", "#dc2626", "smoke", "Carbon monoxide");
+sub("vibration", "sensor", "sensor", "#eab308", "vibration", "Vibration");
+sub("tamper", "sensor", "sensor", "#f97316", "tamper", "Tamper");
+sub("presence", "sensor", "sensor", "#22c55e", "presence", "Presence");
+sub("enum-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "generic", "Sensor state");
+sub("device-event", "sensor", "sensor", "#10b981", "button", "Device event");
+sub("lock", "control", "control", "#0ea5e9", "lock", "Lock");
+sub("switch", "control", "control", TAXONOMY_COLORS.control, "switch", "Switch");
+sub("siren", "control", "control", "#dc2626", "siren", "Siren");
+sub("button", "control", "control", "#10b981", "button", "Button");
+sub("doorbell", "control", "control", "#a855f7", "doorbell", "Doorbell");
+for (const l of AUDIO_MACRO_LABELS) {
+	const kind = `audio-${l.id}`;
+	if (entries.has(kind)) continue;
+	sub(kind, "audio", "audio", TAXONOMY_COLORS.audio, kind, l.name);
+}
+/** The complete taxonomy dictionary, keyed by kind. */
+var EVENT_TAXONOMY = Object.freeze(Object.fromEntries(entries));
+/** Taxonomy entry for a kind, or undefined when unknown. */
+function getTaxonomyEntry(kind) {
+	return EVENT_TAXONOMY[kind];
+}
+/** Color for a kind — dictionary value, else the global default. */
+function colorForKind(kind) {
+	return EVENT_TAXONOMY[kind]?.color ?? "#22ff55";
+}
+/** The sub kinds whose `parentKind` is `macro` (empty for a leaf macro). */
+function subKindsOf(macro) {
+	const out = [];
+	for (const e of Object.values(EVENT_TAXONOMY)) if (e.parentKind === macro) out.push(e);
+	return out;
+}
+//#endregion
 //#region src/types/device-type.ts
 var DEVICE_TYPE_INFO = { ["camera"]: {
 	type: "camera",
@@ -18421,17 +18558,30 @@ var EventKindCategorySchema = zod.z.enum([
 	"audio",
 	"detection",
 	"sensor",
+	"control",
 	"custom",
 	"package"
 ]);
+/** Taxonomy level — macro (timeline lane) vs sub (events-page leaf). */
+var EventKindLevelSchema = zod.z.enum(["macro", "sub"]);
 var EventKindDescriptorSchema = zod.z.object({
-	/** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+	/** Stable kind id (e.g. 'motion', 'vehicle', 'car', 'lock'). */
 	kind: zod.z.string(),
+	/** i18n key resolved on the UI side; `label` is the English fallback. */
+	labelKey: zod.z.string(),
+	/** English fallback label (kept for clients that don't translate). */
 	label: zod.z.string(),
 	/** Hex color for timeline/legend rendering. */
 	color: zod.z.string(),
+	/** Dictionary id → lucide component on the UI side. */
+	iconId: zod.z.string(),
+	/** Legacy closed-vocab glyph — fallback for `iconId`. */
 	icon: EventKindIconSchema,
 	category: EventKindCategorySchema,
+	/** Macro parent for this kind ('car' → 'vehicle'); null for a macro. */
+	parentKind: zod.z.string().nullable(),
+	/** Derived from `parentKind`, explicit for the client tree. */
+	level: EventKindLevelSchema,
 	/** Which cap + device contributes this kind. For built-ins the camera
 	*  itself; for sensor kinds the LINKED source device. */
 	source: zod.z.object({
@@ -18504,11 +18654,21 @@ var TrackAudioLabelSchema = zod.z.object({
 	firstAt: zod.z.number(),
 	lastAt: zod.z.number()
 });
+/**
+* How a track was produced. `pipeline` (default / absent) = the spatial
+* detection+tracking pipeline. `sensor` = a SYNTHETIC track projected from a
+* linked sensor/control state change (no positions; carries a snapshot). The
+* spatial subsystems (tracker association, occupancy count, re-id/embedding,
+* resurrection) MUST skip `sensor` tracks — they have no bbox trajectory.
+*/
+var TrackSourceSchema = zod.z.enum(["pipeline", "sensor"]);
 var TrackSchema = zod.z.object({
 	trackId: zod.z.string(),
 	deviceId: zod.z.number(),
 	className: zod.z.string(),
 	label: zod.z.string().optional(),
+	/** Track provenance. Absent ⇒ `pipeline` (legacy rows). */
+	source: TrackSourceSchema.optional(),
 	firstSeen: zod.z.number(),
 	lastSeen: zod.z.number(),
 	/** Frame-rate position history (subject to maxPositionHistory cap). */
@@ -19039,53 +19199,107 @@ var pipelineAnalyticsCapability = {
 //#endregion
 //#region src/capabilities/sensor-event-kinds.ts
 /**
-* Sensor cap name → static event-kind descriptor. A linked device
-* contributes one entry per bound cap present in this map.
+* Cap → event-kind mapping for the SENSOR / CONTROL cap families — the table
+* `pipeline-analytics.listEventKinds` uses to turn a linked device's bound
+* caps into per-camera event-kind descriptors.
+*
+* The descriptor DATA (color / iconId / labelKey / parentKind / category)
+* is NOT duplicated here — every entry is derived from the single
+* `EVENT_TAXONOMY` dictionary (`catalogs/event-taxonomy.ts`). This file owns
+* ONLY the cap-name → taxonomy-kind mapping. Adding a new eventful sensor /
+* control cap means adding one line here (and a taxonomy entry); the anti-
+* drift guard `scripts/check-event-kind-coverage.ts` fails the build if an
+* eventful cap is missing.
 */
-var EVENT_KIND_BY_CAP = {
-	contact: {
-		kind: "contact",
-		label: "Contact",
-		color: "#f59e0b",
-		icon: "door",
-		category: "sensor"
-	},
-	flood: {
-		kind: "flood",
-		label: "Water leak",
-		color: "#3b82f6",
-		icon: "water",
-		category: "sensor"
-	},
-	gas: {
-		kind: "gas",
-		label: "Gas",
-		color: "#ef4444",
-		icon: "smoke",
-		category: "sensor"
-	},
-	"carbon-monoxide": {
-		kind: "carbon-monoxide",
-		label: "Carbon monoxide",
-		color: "#dc2626",
-		icon: "smoke",
-		category: "sensor"
-	},
-	"enum-sensor": {
-		kind: "enum-sensor",
-		label: "Sensor state",
-		color: "#8b5cf6",
-		icon: "generic",
-		category: "sensor"
-	},
-	"event-emitter": {
-		kind: "device-event",
-		label: "Device event",
-		color: "#10b981",
-		icon: "button",
-		category: "sensor"
-	}
+/** Map a taxonomy `iconId` onto the legacy closed `EventKindIcon` enum. */
+var LEGACY_ICON = {
+	motion: "motion",
+	audio: "audio",
+	person: "person",
+	vehicle: "vehicle",
+	animal: "animal",
+	package: "package",
+	door: "door",
+	pir: "pir",
+	smoke: "smoke",
+	water: "water",
+	button: "button",
+	generic: "generic",
+	gas: "smoke",
+	vibration: "generic",
+	tamper: "generic",
+	presence: "person",
+	lock: "generic",
+	siren: "generic",
+	switch: "generic",
+	doorbell: "button"
 };
+function legacyIcon(iconId) {
+	return LEGACY_ICON[iconId] ?? "generic";
+}
+/**
+* Cap name → taxonomy kind id. Covers EVERY eventful sensor / control cap.
+* The anti-drift guard cross-checks this against the eventful caps declared
+* in `packages/types/src/capabilities/*.cap.ts`.
+*/
+var CAP_TO_KIND = {
+	contact: "contact",
+	motion: "motion-sensor",
+	smoke: "smoke",
+	flood: "flood",
+	gas: "gas",
+	"carbon-monoxide": "carbon-monoxide",
+	vibration: "vibration",
+	tamper: "tamper",
+	presence: "presence",
+	"enum-sensor": "enum-sensor",
+	"event-emitter": "device-event",
+	"lock-control": "lock",
+	switch: "switch",
+	button: "button",
+	doorbell: "doorbell"
+};
+function buildDescriptor(capName, kind) {
+	const t = EVENT_TAXONOMY[kind];
+	if (t === void 0) throw new Error(`EVENT_KIND_BY_CAP: cap '${capName}' maps to unknown taxonomy kind '${kind}'`);
+	return {
+		...t,
+		icon: legacyIcon(t.iconId)
+	};
+}
+/**
+* Sensor / control cap name → static event-kind descriptor. A linked device
+* contributes one entry per bound cap present in this map.
+*/
+var EVENT_KIND_BY_CAP = Object.freeze(Object.fromEntries(Object.entries(CAP_TO_KIND).map(([capName, kind]) => [capName, buildDescriptor(capName, kind)])));
+/** The cap names covered by the taxonomy (for the anti-drift guard). */
+var EVENTFUL_CAP_NAMES = Object.keys(CAP_TO_KIND);
+/**
+* Build a full `EventKindDescriptor` for a taxonomy `kind`, stamping the
+* per-device `source`. Returns null when `kind` is not in the taxonomy.
+* This is THE bridge from the serializable taxonomy dictionary to the cap
+* wire shape — every event-kind descriptor the server emits goes through it,
+* so color/iconId/labelKey are never re-declared at a call site.
+*/
+function buildEventKindDescriptor(kind, source) {
+	const t = EVENT_TAXONOMY[kind];
+	if (t === void 0) return null;
+	return {
+		kind: t.kind,
+		labelKey: t.labelKey,
+		label: t.label,
+		color: t.color,
+		iconId: t.iconId,
+		icon: legacyIcon(t.iconId),
+		category: t.category,
+		parentKind: t.parentKind,
+		level: t.level,
+		source: {
+			capName: source.capName,
+			deviceId: source.deviceId
+		}
+	};
+}
 //#endregion
 //#region src/capabilities/pipeline-orchestrator.cap.ts
 var CameraPipelineConfigSchema = zod.z.object({
@@ -31292,6 +31506,7 @@ exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;
 exports.DEFAULT_ADDON_PLACEMENT = DEFAULT_ADDON_PLACEMENT;
 exports.DEFAULT_AUDIO_ANALYZER_CONFIG = DEFAULT_AUDIO_ANALYZER_CONFIG;
 exports.DEFAULT_DECODER_HWACCEL_CONFIG = DEFAULT_DECODER_HWACCEL_CONFIG;
+exports.DEFAULT_EVENT_COLOR = DEFAULT_EVENT_COLOR;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
 exports.DEFAULT_RETENTION = DEFAULT_RETENTION;
 exports.DEFAULT_SCRUB_THUMBNAIL_PRESET = DEFAULT_SCRUB_THUMBNAIL_PRESET;
@@ -31331,8 +31546,10 @@ exports.DiscoveredTargetSchema = DiscoveredTargetSchema;
 exports.DisposerChain = require_sleep.DisposerChain;
 exports.DoorbellPressEventSchema = DoorbellPressEventSchema;
 exports.DoorbellStatusSchema = DoorbellStatusSchema;
+exports.EVENTFUL_CAP_NAMES = EVENTFUL_CAP_NAMES;
 exports.EVENT_KIND_BY_CAP = EVENT_KIND_BY_CAP;
 exports.EVENT_PAD_MS = EVENT_PAD_MS;
+exports.EVENT_TAXONOMY = EVENT_TAXONOMY;
 exports.EXPRESSION_BUILTINS = EXPRESSION_BUILTINS;
 exports.EXPRESSION_BUILTIN_NAMES = EXPRESSION_BUILTIN_NAMES;
 exports.EXPRESSION_COMPILE_CACHE_CAPACITY = EXPRESSION_COMPILE_CACHE_CAPACITY;
@@ -31677,6 +31894,7 @@ exports.SubscribeFramesResultSchema = require_sleep.SubscribeFramesResultSchema;
 exports.SwitchStatusSchema = SwitchStatusSchema;
 exports.SystemMetricsSchema = SystemMetricsSchema;
 exports.SystemMirror = SystemMirror;
+exports.TAXONOMY_COLORS = TAXONOMY_COLORS;
 exports.TIMEZONES = TIMEZONES;
 exports.TamperStatusSchema = TamperStatusSchema;
 exports.TankStatusSchema = TankStatusSchema;
@@ -31770,6 +31988,7 @@ exports.bindAddonActions = bindAddonActions;
 exports.brightnessCapability = brightnessCapability;
 exports.brokerCapability = brokerCapability;
 exports.buildAddonRouteProvider = buildAddonRouteProvider;
+exports.buildEventKindDescriptor = buildEventKindDescriptor;
 exports.buildModelVariantGroups = buildModelVariantGroups;
 exports.buildStreamParamsConfigSchema = buildStreamParamsConfigSchema;
 exports.buttonCapability = buttonCapability;
@@ -31785,6 +32004,7 @@ exports.climateControlCapability = climateControlCapability;
 exports.collectHydratedFieldEntries = require_sleep.collectHydratedFieldEntries;
 exports.collectHydratedFieldValues = require_sleep.collectHydratedFieldValues;
 exports.colorCapability = colorCapability;
+exports.colorForKind = colorForKind;
 exports.compileExpression = compileExpression;
 exports.compileExpressionSafe = compileExpressionSafe;
 exports.connectivityCapability = connectivityCapability;
@@ -31853,6 +32073,7 @@ exports.gasCapability = gasCapability;
 exports.getAudioMacroClassIds = getAudioMacroClassIds;
 exports.getByPath = getByPath;
 exports.getCapsByProviderKind = getCapsByProviderKind;
+exports.getTaxonomyEntry = getTaxonomyEntry;
 exports.hfModelUrl = hfModelUrl;
 exports.htmlToText = htmlToText;
 exports.humidifierCapability = humidifierCapability;
@@ -31988,6 +32209,7 @@ exports.streamCatalogCapability = streamCatalogCapability;
 exports.streamParamsCapability = streamParamsCapability;
 exports.streamPixels = streamPixels;
 exports.streamQualityLabel = streamQualityLabel;
+exports.subKindsOf = subKindsOf;
 exports.supportedRuntimes = supportedRuntimes;
 exports.switchCapability = switchCapability;
 exports.synthesizeSourceInfo = synthesizeSourceInfo;