@camstack/system 1.1.53 → 1.1.54

package/dist/addon-runner.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BNro5CRu.js");
-const require_manifest_python_deps = require("./manifest-python-deps-DszE7bYn.js");
+const require_dist = require("./dist-B5C4dVvO.js");
+const require_manifest_python_deps = require("./manifest-python-deps-kkvku9yU.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/addon-runner.mjs

@@ -1,5 +1,5 @@
-import { j as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-D7_69kDt.mjs";
-import { F as createUdsLoggerWithControl, I as LocalChildClient, bt as resolveAddonClass, i as createUdsAddonContext, it as setWorkerNativeCapsChangeListener, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, t as installManifestPythonDeps, tt as getWorkerNativeCapProvider, vt as installManifestNativeDeps } from "./manifest-python-deps-EM2H-jjS.mjs";
+import { j as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-DssImRC5.mjs";
+import { F as createUdsLoggerWithControl, I as LocalChildClient, bt as resolveAddonClass, i as createUdsAddonContext, it as setWorkerNativeCapsChangeListener, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, t as installManifestPythonDeps, tt as getWorkerNativeCapProvider, vt as installManifestNativeDeps } from "./manifest-python-deps-CWom-eqp.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
 import { register } from "node:module";
 import * as fs from "node:fs";

package/dist/addon-utils.d.ts

@@ -17,4 +17,5 @@
 export { downloadFile, ensureModel, isModelDownloaded, deleteModelFromDisk, collectModelFiles, getModelFilePath, } from './download/model-downloader.js';
 export { ModelDownloadService } from './download/model-download-service.js';
 export { createFileDataPlaneHandler } from './http/file-data-plane.js';
+export { parseRangeHeader, contentTypeFor, type ByteRange, } from './http/authenticated-file-server.js';
 export { CustomActionRegistry } from './kernel/custom-action-registry.js';

package/dist/addon-utils.js

@@ -5,9 +5,11 @@ const require_custom_action_registry = require("./custom-action-registry-vLYEFTt
 exports.CustomActionRegistry = require_custom_action_registry.CustomActionRegistry;
 exports.ModelDownloadService = require_model_download_service.ModelDownloadService;
 exports.collectModelFiles = require_model_download_service.collectModelFiles;
+exports.contentTypeFor = require_model_download_service.contentTypeFor;
 exports.createFileDataPlaneHandler = require_model_download_service.createFileDataPlaneHandler;
 exports.deleteModelFromDisk = require_model_download_service.deleteModelFromDisk;
 exports.downloadFile = require_model_download_service.downloadFile;
 exports.ensureModel = require_model_download_service.ensureModel;
 exports.getModelFilePath = require_model_download_service.getModelFilePath;
 exports.isModelDownloaded = require_model_download_service.isModelDownloaded;
+exports.parseRangeHeader = require_model_download_service.parseRangeHeader;

package/dist/addon-utils.mjs

@@ -1,3 +1,3 @@
-import { c as getModelFilePath, i as downloadFile, l as isModelDownloaded, n as collectModelFiles, o as ensureModel, r as deleteModelFromDisk, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
+import { c as getModelFilePath, d as contentTypeFor, i as downloadFile, l as isModelDownloaded, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
-export { CustomActionRegistry, ModelDownloadService, collectModelFiles, createFileDataPlaneHandler, deleteModelFromDisk, downloadFile, ensureModel, getModelFilePath, isModelDownloaded };
+export { CustomActionRegistry, ModelDownloadService, collectModelFiles, contentTypeFor, createFileDataPlaneHandler, deleteModelFromDisk, downloadFile, ensureModel, getModelFilePath, isModelDownloaded, parseRangeHeader };

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { f as addonPagesCapability, it as BaseAddon, kt as EventCategory, rt as errMsg } from "../../dist-D7_69kDt.mjs";
+import { f as addonPagesCapability, it as BaseAddon, kt as EventCategory, rt as errMsg } from "../../dist-DssImRC5.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { it as BaseAddon, kt as EventCategory, m as addonWidgetsCapability, rt as errMsg } from "../../dist-D7_69kDt.mjs";
+import { it as BaseAddon, kt as EventCategory, m as addonWidgetsCapability, rt as errMsg } from "../../dist-DssImRC5.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { _t as createEvent, h as alertsCapability, it as BaseAddon, kt as EventCategory, n as AlertSchema, rt as errMsg } from "../../dist-D7_69kDt.mjs";
+import { _t as createEvent, h as alertsCapability, it as BaseAddon, kt as EventCategory, n as AlertSchema, rt as errMsg } from "../../dist-DssImRC5.mjs";
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_chunk.__toESM(node_fs, 1);
 node_fs = require_chunk.__toESM(node_fs);

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { it as BaseAddon, kt as EventCategory, v as backupCapability } from "../../dist-D7_69kDt.mjs";
+import { it as BaseAddon, kt as EventCategory, v as backupCapability } from "../../dist-DssImRC5.mjs";
 import * as fs from "node:fs";
 import Kt from "node:fs";
 import * as path$1 from "node:path";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { L as logDestinationCapability, it as BaseAddon } from "../../dist-D7_69kDt.mjs";
+import { L as logDestinationCapability, it as BaseAddon } from "../../dist-DssImRC5.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BNro5CRu.js");
+const require_dist = require("../../dist-B5C4dVvO.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
@@ -1333,6 +1333,39 @@ async function applyLinkedDevicesPatch(pctx, deviceId, patch) {
 	return { success: true };
 }
 //#endregion
+//#region src/builtins/device-manager/device-store-sections.ts
+/** The device-manager's device-store-backed sections. Add an entry to extend. */
+var DEVICE_STORE_SECTIONS = [{
+	keys: [LINKED_MODE_CONFIG_KEY, LINKED_IDS_CONFIG_KEY],
+	apply: (pctx, deviceId, patch) => applyLinkedDevicesPatch(pctx, deviceId, patch)
+}];
+/**
+* Split a `writerCapName: 'device-manager'` patch into device-store slices
+* (one per matching registered section) and the leftover driver patch.
+* Generic — consults {@link DEVICE_STORE_SECTIONS}, no hardcoded key list.
+*/
+function splitDeviceStoreKeys(patch) {
+	const claimed = /* @__PURE__ */ new Set();
+	const storeGroups = [];
+	for (const section of DEVICE_STORE_SECTIONS) {
+		const slice = {};
+		for (const key of section.keys) if (key in patch) {
+			slice[key] = patch[key];
+			claimed.add(key);
+		}
+		if (Object.keys(slice).length > 0) storeGroups.push({
+			section,
+			patch: slice
+		});
+	}
+	const driverPatch = {};
+	for (const [key, value] of Object.entries(patch)) if (!claimed.has(key)) driverPatch[key] = value;
+	return {
+		storeGroups,
+		driverPatch
+	};
+}
+//#endregion
 //#region src/builtins/device-manager/device-bindings-store.ts
 /**
 * Persisted wrapper-activation + per-device binding resolution for the
@@ -2031,40 +2064,9 @@ async function dispatchDerivedFormSave(builderId, deviceId, patch, dcProvider, c
 	throw new Error(`[device-manager] device-config cap "${capName}" provider exposes neither setSettings nor setProfile`);
 }
 async function updateDeviceField(deps, input) {
-	if (input.writerCapName === "device-manager") {
-		if (input.key === "_linkedDevicesMode" || input.key === "_linkedDeviceIds") {
-			const settings = deps.ctx.settings;
-			if (!settings) throw new Error("[device-manager] linked-devices save requires the settings surface");
-			await applyLinkedDevicesPatch({ settings }, input.deviceId, { [input.key]: input.value });
-			return { success: true };
-		}
-		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
-		const found = hubRegistry ? resolveDeviceById(hubRegistry, input.deviceId) : null;
-		if (found) {
-			await found.device.applySettingsPatch({ [input.key]: input.value });
-			return { success: true };
-		}
-		const ops = deps.capabilityRegistry?.getNativeProvider("device-ops", input.deviceId);
-		if (!ops) throw new Error(`[device-manager] device "${input.deviceId}" not found (no hub-local entry, no device-ops native provider)`);
-		await ops.setConfig({
-			deviceId: input.deviceId,
-			values: { [input.key]: input.value }
-		});
-		return { success: true };
-	}
-	const registry = deps.capabilityRegistry;
-	if (!registry) throw new Error("[device-manager] updateDeviceField requires capability registry — unavailable on this node");
-	const def = registry.getDefinition(input.writerCapName);
-	if (require_dist.isDeviceConfigCap(def)) {
-		if (def.deviceConfig.ui.kind === "widget") return { success: true };
-		const dcProvider = registry.getProviderForDevice(input.writerCapName, input.deviceId);
-		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${input.writerCapName}" on device ${input.deviceId}`);
-		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, input.deviceId, { [input.key]: input.value }, dcProvider, input.writerCapName);
-		return { success: true };
-	}
-	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${input.writerCapName}" does not expose device settings`);
-	await resolveContributionProvider(registry, def, input.writerCapName, input.writerAddonId, input.deviceId).applyDeviceSettingsPatch({
-		deviceId: input.deviceId,
+	await applyGroupPatch(deps, input.deviceId, {
+		writerCapName: input.writerCapName,
+		writerAddonId: input.writerAddonId,
 		patch: { [input.key]: input.value }
 	});
 	return { success: true };
@@ -2157,17 +2159,24 @@ async function updateDeviceFieldsBatch(deps, input) {
 * registry lookup). Used by `updateDeviceFieldsBatch`. */
 async function applyGroupPatch(deps, deviceId, group) {
 	if (group.writerCapName === "device-manager") {
+		const { storeGroups, driverPatch } = splitDeviceStoreKeys(group.patch);
+		if (storeGroups.length > 0) {
+			const settings = deps.ctx.settings;
+			if (!settings) throw new Error("[device-manager] device-store save requires the settings surface");
+			for (const { section, patch } of storeGroups) await section.apply({ settings }, deviceId, patch);
+		}
+		if (Object.keys(driverPatch).length === 0) return;
 		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
 		const found = hubRegistry ? resolveDeviceById(hubRegistry, deviceId) : null;
 		if (found) {
-			await found.device.applySettingsPatch(group.patch);
+			await found.device.applySettingsPatch(driverPatch);
 			return;
 		}
 		const ops = deps.capabilityRegistry?.getNativeProvider("device-ops", deviceId);
 		if (!ops) throw new Error(`[device-manager] device "${deviceId}" not found (no hub-local entry, no device-ops native provider)`);
 		await ops.setConfig({
 			deviceId,
-			values: group.patch
+			values: driverPatch
 		});
 		return;
 	}

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,4 +1,4 @@
-import { E as evaluateLinkExpression, J as setByPath, Ot as sleep, S as deviceStatusCapability, St as isDeviceConfigCap, T as enumerateSchemaFields, U as parseStreamParamsFormPatch, V as normalizeUnit, a as DeviceStatusSchema, b as deviceManagerCapability, c as STREAM_PROFILE_META, ct as DeviceFeature, et as toExpressionValue, g as applyTransform, i as CAP_NAMES_WITH_STATUS, it as BaseAddon, k as getByPath, kt as EventCategory, lt as DeviceRole, nt as validateExpressionSource, pt as WELL_KNOWN_TAB_MAP, rt as errMsg, t as ALL_CAPABILITY_DEFINITIONS, ut as DeviceType, w as enumerateItemArrayFields, x as deviceStateCapability, y as buildStreamParamsConfigSchema } from "../../dist-D7_69kDt.mjs";
+import { E as evaluateLinkExpression, J as setByPath, Ot as sleep, S as deviceStatusCapability, St as isDeviceConfigCap, T as enumerateSchemaFields, U as parseStreamParamsFormPatch, V as normalizeUnit, a as DeviceStatusSchema, b as deviceManagerCapability, c as STREAM_PROFILE_META, ct as DeviceFeature, et as toExpressionValue, g as applyTransform, i as CAP_NAMES_WITH_STATUS, it as BaseAddon, k as getByPath, kt as EventCategory, lt as DeviceRole, nt as validateExpressionSource, pt as WELL_KNOWN_TAB_MAP, rt as errMsg, t as ALL_CAPABILITY_DEFINITIONS, ut as DeviceType, w as enumerateItemArrayFields, x as deviceStateCapability, y as buildStreamParamsConfigSchema } from "../../dist-DssImRC5.mjs";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
@@ -1328,6 +1328,39 @@ async function applyLinkedDevicesPatch(pctx, deviceId, patch) {
 	return { success: true };
 }
 //#endregion
+//#region src/builtins/device-manager/device-store-sections.ts
+/** The device-manager's device-store-backed sections. Add an entry to extend. */
+var DEVICE_STORE_SECTIONS = [{
+	keys: [LINKED_MODE_CONFIG_KEY, LINKED_IDS_CONFIG_KEY],
+	apply: (pctx, deviceId, patch) => applyLinkedDevicesPatch(pctx, deviceId, patch)
+}];
+/**
+* Split a `writerCapName: 'device-manager'` patch into device-store slices
+* (one per matching registered section) and the leftover driver patch.
+* Generic — consults {@link DEVICE_STORE_SECTIONS}, no hardcoded key list.
+*/
+function splitDeviceStoreKeys(patch) {
+	const claimed = /* @__PURE__ */ new Set();
+	const storeGroups = [];
+	for (const section of DEVICE_STORE_SECTIONS) {
+		const slice = {};
+		for (const key of section.keys) if (key in patch) {
+			slice[key] = patch[key];
+			claimed.add(key);
+		}
+		if (Object.keys(slice).length > 0) storeGroups.push({
+			section,
+			patch: slice
+		});
+	}
+	const driverPatch = {};
+	for (const [key, value] of Object.entries(patch)) if (!claimed.has(key)) driverPatch[key] = value;
+	return {
+		storeGroups,
+		driverPatch
+	};
+}
+//#endregion
 //#region src/builtins/device-manager/device-bindings-store.ts
 /**
 * Persisted wrapper-activation + per-device binding resolution for the
@@ -2026,40 +2059,9 @@ async function dispatchDerivedFormSave(builderId, deviceId, patch, dcProvider, c
 	throw new Error(`[device-manager] device-config cap "${capName}" provider exposes neither setSettings nor setProfile`);
 }
 async function updateDeviceField(deps, input) {
-	if (input.writerCapName === "device-manager") {
-		if (input.key === "_linkedDevicesMode" || input.key === "_linkedDeviceIds") {
-			const settings = deps.ctx.settings;
-			if (!settings) throw new Error("[device-manager] linked-devices save requires the settings surface");
-			await applyLinkedDevicesPatch({ settings }, input.deviceId, { [input.key]: input.value });
-			return { success: true };
-		}
-		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
-		const found = hubRegistry ? resolveDeviceById(hubRegistry, input.deviceId) : null;
-		if (found) {
-			await found.device.applySettingsPatch({ [input.key]: input.value });
-			return { success: true };
-		}
-		const ops = deps.capabilityRegistry?.getNativeProvider("device-ops", input.deviceId);
-		if (!ops) throw new Error(`[device-manager] device "${input.deviceId}" not found (no hub-local entry, no device-ops native provider)`);
-		await ops.setConfig({
-			deviceId: input.deviceId,
-			values: { [input.key]: input.value }
-		});
-		return { success: true };
-	}
-	const registry = deps.capabilityRegistry;
-	if (!registry) throw new Error("[device-manager] updateDeviceField requires capability registry — unavailable on this node");
-	const def = registry.getDefinition(input.writerCapName);
-	if (isDeviceConfigCap(def)) {
-		if (def.deviceConfig.ui.kind === "widget") return { success: true };
-		const dcProvider = registry.getProviderForDevice(input.writerCapName, input.deviceId);
-		if (!dcProvider) throw new Error(`[device-manager] no provider for device-config cap "${input.writerCapName}" on device ${input.deviceId}`);
-		await dispatchDerivedFormSave(def.deviceConfig.ui.builderId, input.deviceId, { [input.key]: input.value }, dcProvider, input.writerCapName);
-		return { success: true };
-	}
-	if (!def?.exposesDeviceSettings) throw new Error(`[device-manager] cap "${input.writerCapName}" does not expose device settings`);
-	await resolveContributionProvider(registry, def, input.writerCapName, input.writerAddonId, input.deviceId).applyDeviceSettingsPatch({
-		deviceId: input.deviceId,
+	await applyGroupPatch(deps, input.deviceId, {
+		writerCapName: input.writerCapName,
+		writerAddonId: input.writerAddonId,
 		patch: { [input.key]: input.value }
 	});
 	return { success: true };
@@ -2152,17 +2154,24 @@ async function updateDeviceFieldsBatch(deps, input) {
 * registry lookup). Used by `updateDeviceFieldsBatch`. */
 async function applyGroupPatch(deps, deviceId, group) {
 	if (group.writerCapName === "device-manager") {
+		const { storeGroups, driverPatch } = splitDeviceStoreKeys(group.patch);
+		if (storeGroups.length > 0) {
+			const settings = deps.ctx.settings;
+			if (!settings) throw new Error("[device-manager] device-store save requires the settings surface");
+			for (const { section, patch } of storeGroups) await section.apply({ settings }, deviceId, patch);
+		}
+		if (Object.keys(driverPatch).length === 0) return;
 		const hubRegistry = deps.ctx.kernel?.deviceRegistry;
 		const found = hubRegistry ? resolveDeviceById(hubRegistry, deviceId) : null;
 		if (found) {
-			await found.device.applySettingsPatch(group.patch);
+			await found.device.applySettingsPatch(driverPatch);
 			return;
 		}
 		const ops = deps.capabilityRegistry?.getNativeProvider("device-ops", deviceId);
 		if (!ops) throw new Error(`[device-manager] device "${deviceId}" not found (no hub-local entry, no device-ops native provider)`);
 		await ops.setConfig({
 			deviceId,
-			values: group.patch
+			values: driverPatch
 		});
 		return;
 	}

package/dist/builtins/device-manager/device-store-sections.d.ts

@@ -0,0 +1,26 @@
+import { ProviderContext } from './device-provider-context.js';
+/** One device-store-backed section: the keys it owns + how to persist them. */
+export interface DeviceStoreSection {
+    /** Reserved config keys this section owns (must not reach the driver). */
+    readonly keys: readonly string[];
+    /** Persist this section's slice of a save into the device-store blob. */
+    apply(pctx: Pick<ProviderContext, 'settings'>, deviceId: number, patch: Record<string, unknown>): Promise<unknown>;
+}
+/** The device-manager's device-store-backed sections. Add an entry to extend. */
+export declare const DEVICE_STORE_SECTIONS: readonly DeviceStoreSection[];
+/** Result of splitting a `device-manager`-writer patch by persistence target. */
+export interface DeviceStoreSplit {
+    /** Per-section slices that persist to the device-store blob. */
+    readonly storeGroups: ReadonlyArray<{
+        section: DeviceStoreSection;
+        patch: Record<string, unknown>;
+    }>;
+    /** The remaining keys, destined for the device driver's own config. */
+    readonly driverPatch: Record<string, unknown>;
+}
+/**
+ * Split a `writerCapName: 'device-manager'` patch into device-store slices
+ * (one per matching registered section) and the leftover driver patch.
+ * Generic — consults {@link DEVICE_STORE_SECTIONS}, no hardcoded key list.
+ */
+export declare function splitDeviceStoreKeys(patch: Record<string, unknown>): DeviceStoreSplit;

package/dist/builtins/doorbell/doorbell-settings.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure per-camera settings parsing/normalization for the virtual-doorbell
+ * builtin. Kept separate from the addon class (and the runtime trigger
+ * engine) so the persisted-shape handling — including tolerant migration of
+ * the legacy single-source blob — is unit-testable in isolation.
+ *
+ * PERSISTED SHAPE (extensible by design):
+ *   doorbellSources: Array<{ deviceId: number }>
+ *
+ * The source is an OBJECT rather than a bare id so future per-source options
+ * (a custom trigger override, an event-type match, a per-source debounce)
+ * can be added without another migration. Today only `deviceId` is stored;
+ * the reaction is DERIVED at runtime from the source device's cap (see
+ * `trigger-engine.ts`).
+ */
+/** Device-store key holding the source list. */
+export declare const KEY_SOURCES = "doorbellSources";
+/**
+ * Legacy device-store keys from the pre-simplification shape (single source
+ * device + explicit trigger + event type). Retained ONLY for tolerant
+ * migration on read and cleanup on write — never written afresh.
+ */
+export declare const LEGACY_KEY_SOURCE = "doorbellSourceDeviceId";
+export declare const LEGACY_KEY_TRIGGER = "doorbellTrigger";
+export declare const LEGACY_KEY_EVENT_TYPE = "doorbellEventType";
+/**
+ * One source device driving a camera's virtual doorbell. Intentionally an
+ * object so it can grow (custom trigger, event type) without a migration.
+ */
+export interface DoorbellSource {
+    readonly deviceId: number;
+}
+/** Coerce a persisted / form-supplied id (number or numeric string) to a
+ *  positive integer device id, or null when it is not a usable id. */
+export declare function coerceDeviceId(value: unknown): number | null;
+/**
+ * Parse the persisted doorbell sources for one camera. Tolerant of BOTH:
+ *   - the new `doorbellSources: [{deviceId}]` shape (ids may arrive as
+ *     numbers, numeric strings, or `{deviceId}` records); and
+ *   - the legacy single `doorbellSourceDeviceId` scalar, mapped onto one
+ *     source (the old trigger/eventType are dropped — the reaction is now
+ *     derived at runtime).
+ *
+ * Never throws on malformed data — unknown entries are skipped.
+ */
+export declare function parseDoorbellSources(blob: Record<string, unknown>): readonly DoorbellSource[];
+/**
+ * Normalize a settings-patch value for the `doorbellSources` multiselect
+ * (a `string[]` of device ids from the form, or an already-shaped
+ * `{deviceId}[]` / `number[]`) into the persisted extensible shape.
+ */
+export declare function normalizeDoorbellSources(value: unknown): DoorbellSource[];
+/**
+ * Produce the next device-store blob after applying a doorbell-sources
+ * patch: writes the normalized new shape and strips every legacy key so a
+ * migrated camera never carries stale single-source fields.
+ */
+export declare function applyDoorbellSourcesPatch(current: Record<string, unknown>, patchValue: unknown): Record<string, unknown>;

package/dist/builtins/doorbell/trigger-engine.d.ts

@@ -1,26 +1,35 @@
 /**
- * Pure trigger logic for the virtual-doorbell builtin — edge detection
- * over runtime-state slices, event-emitter matching, and per-camera
- * debounce. Extracted from the addon class (mirrors the
- * `snapshot-coalescing.ts` split) so the behaviour is unit-testable
- * without instantiating the addon or mocking the event bus.
+ * Pure trigger logic for the virtual-doorbell builtin — edge detection over
+ * runtime-state slices with per-camera debounce. Extracted from the addon
+ * class so the behaviour is unit-testable without instantiating the addon or
+ * mocking the event bus.
+ *
+ * REACTION MODEL (simplified — operator picks a source, the system reacts
+ * with a sensible default): a source device rings a camera's doorbell when a
+ * known binary / switch cap on it RISES to its active state (false→true) — a
+ * contact opening, a switch turning on, an alarm sensor firing. There is no
+ * per-source trigger configuration today; the shape stays extensible for a
+ * future custom-trigger override (see `doorbell-settings.ts`).
+ */
+/**
+ * Known binary / switch source caps → the boolean slice field whose
+ * false→true rise rings the doorbell. Every entry is "ring on active".
+ * Sensors whose "active" reading is not a plain boolean (presence's string
+ * state, connectivity's connected flag) are deliberately excluded — a
+ * reconnect is not a doorbell press.
  */
-/** Trigger kinds an operator can configure per camera. */
-export type DoorbellTrigger = 'contact-open' | 'contact-close' | 'switch-on' | 'event';
-export declare const DOORBELL_TRIGGERS: readonly DoorbellTrigger[];
-/** Type guard for {@link DoorbellTrigger}. */
-export declare function isDoorbellTrigger(value: unknown): value is DoorbellTrigger;
+export declare const SOURCE_CAP_ACTIVE_FIELD: Readonly<Record<string, string>>;
+/** Cap names whose presence in a device's bindings qualify it as a source. */
+export declare const SOURCE_CAPS: readonly string[];
+/** True when a cap is a recognised binary/switch doorbell source. */
+export declare function isSourceCap(capName: string): boolean;
 /**
- * One camera's virtual-doorbell wiring: which source device drives it,
- * on which trigger, and (for `trigger: 'event'`) which event type.
+ * One camera's virtual-doorbell wiring: a source device that rings it. A
+ * camera with several sources produces several assignments (one per source).
  */
 export interface DoorbellAssignment {
     readonly cameraId: number;
     readonly sourceDeviceId: number;
-    readonly trigger: DoorbellTrigger;
-    /** Only meaningful when `trigger === 'event'` — matched verbatim
-     *  against the event-emitter `onEvent` payload `eventType`. */
-    readonly eventType: string | null;
 }
 /** Debounce window guarding against sensor chatter (reed-switch bounce,
  *  duplicate HA state pushes). One ring per camera per window. */
@@ -29,10 +38,10 @@ export declare const DEFAULT_DEBOUNCE_MS = 2000;
  * Stateful (but side-effect-free towards the outside) trigger engine.
  *
  * Tracks the last observed binary value per (sourceDevice, cap) so a
- * `DeviceStateChanged` re-emission (the slice's `lastChangedAt` moves
- * while the binary value does not) never double-fires, and the FIRST
- * observation after boot only seeds the baseline — a state hydration
- * at startup must not ring anybody's doorbell.
+ * `DeviceStateChanged` re-emission (the slice's `lastChangedAt` moves while
+ * the binary value does not) never double-fires, and the FIRST observation
+ * after boot only seeds the baseline — a state hydration at startup must not
+ * ring anybody's doorbell.
  */
 export declare class DoorbellTriggerEngine {
     private assignments;
@@ -53,17 +62,10 @@ export declare class DoorbellTriggerEngine {
     hasSource(deviceId: number): boolean;
     /**
      * Feed one `DeviceStateChanged` slice. Returns the camera ids whose
-     * doorbell should ring (already debounced). Baseline-only sightings
-     * and non-transitions return an empty array.
+     * doorbell should ring (already debounced). Only a false→true rise on a
+     * recognised source cap fires; baseline-only sightings, re-emissions, and
+     * the falling edge return an empty array.
      */
     onStateSlice(deviceId: number, capName: string, slice: Record<string, unknown>): number[];
-    /**
-     * Feed one event-emitter `onEvent` firing. Returns the camera ids to
-     * ring — assignments with `trigger: 'event'`, a matching source and a
-     * verbatim `eventType` match. An assignment with no configured
-     * eventType never matches (misconfiguration must not ring on every
-     * event the device emits).
-     */
-    onEmitterEvent(deviceId: number, eventType: string): number[];
     private matchAndDebounce;
 }