@camstack/system 1.2.24 → 1.2.25

package/dist/addon-runner.js

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_manifest_python_deps = require("./manifest-python-deps-BbOZZbVt.js");
+const require_manifest_python_deps = require("./manifest-python-deps-COgal7Jy.js");
 const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/addon-runner.mjs

@@ -1,4 +1,4 @@
-import { Ct as resolveAddonClass, I as createUdsLoggerWithControl, L as LocalChildClient, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps } from "./manifest-python-deps-C9qhvMUi.mjs";
+import { Ct as resolveAddonClass, I as createUdsLoggerWithControl, L as LocalChildClient, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps } from "./manifest-python-deps-julrfvyf.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
 import { register } from "node:module";
 import * as fs from "node:fs";

package/dist/index.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
 const require_dist = require("./dist-CS0pdC8l.js");
 const require_model_download_service = require("./model-download-service-hf0ookyy.js");
-const require_manifest_python_deps = require("./manifest-python-deps-BbOZZbVt.js");
+const require_manifest_python_deps = require("./manifest-python-deps-COgal7Jy.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./builtins/sqlite-storage/filesystem-storage.addon.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./builtins/sqlite-storage/sqlite-settings.addon.js");

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
 import { B as logLevelAtMost, Dt as readinessKey, Et as parseJsonUnknown$1, F as isVoidInput, I as kebabToCamel, L as lifecycleJobSchema, M as isArrayOutputSchema, N as isCollectionArrayMethod, Ot as resolveCapMount, P as isObjectInput, Tt as parseJsonObject, V as looseSchema, W as objectInputDeclaresAddonId, _t as asString$1, c as RUNTIME_DEFAULTS, ct as DEVICE_STATUS_METHOD, ft as ReadinessRegistry, gt as asNumber, ht as asJsonObject$1, it as errMsg$1, jt as EventCategory$1, k as extractNestedAddonId, kt as scopeKey, m as addonSettingsCapability, ot as DATAPLANE_SECRET_HEADER$1, pt as ReadinessTimeoutError, q as procedureAuthKey, s as METHOD_ACCESS_MAP, st as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, vt as createEvent, xt as expandCapMethods, yt as emitDownForOwnedCaps } from "./dist-CIek6F9X.mjs";
 import { a as downloadModel, c as getModelFilePath, d as contentTypeFor, f as createAuthenticatedFileServer, h as resolveFilePath, i as downloadFile, l as isModelDownloaded, m as parseTokenizedUrl, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, s as fetchJson, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
-import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as resolveAddonClass, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as runNpm, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveNpmInvocation, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-C9qhvMUi.mjs";
+import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as resolveAddonClass, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as runNpm, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveNpmInvocation, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-julrfvyf.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-BkP504Vq.mjs";
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./builtins/sqlite-storage/filesystem-storage.addon.mjs";
 import { SqliteSettingsAddon, t as SqliteSettingsBackend } from "./builtins/sqlite-storage/sqlite-settings.addon.mjs";

package/dist/kernel/moleculer/settings-read-guard.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Read-modify-write guard for the addon settings stores.
+ *
+ * ## The data loss this prevents
+ *
+ * Every settings mutation is `read current → merge patch → write back`. The
+ * read used to answer `{}` for BOTH "this addon has no settings yet" and "the
+ * read failed", so a failed read merged the patch onto nothing and the write
+ * persisted a blob containing ONLY the patch. Everything else in it was gone.
+ *
+ * It happened on 2026-07-31. The UDS transport stalled, `settings write failed
+ * (addon-settings/root) — transport error ... UDS request timed out after
+ * 60000ms` appeared in the log, and the recording configuration for all three
+ * recording cameras came back as `{"enabled": false, "bands": []}`. Two and a
+ * half hours of footage were never written, and nothing looked broken: an
+ * emptied config is indistinguishable from an operator switching recording off.
+ *
+ * The rule this module enforces: **a read that FAILED is not an empty value.**
+ * A miss still merges onto `{}` — that is a real empty. A failure refuses the
+ * write and says so, leaving the stored blob untouched so the next successful
+ * write starts from the truth.
+ */
+/**
+ * Outcome of a settings read. `missing` and `failed` are deliberately distinct
+ * — collapsing them is the bug.
+ */
+export type SettingsRead = {
+    readonly kind: 'value';
+    readonly value: Record<string, unknown>;
+} | {
+    readonly kind: 'missing';
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+export interface ReadModifyWriteInput {
+    readonly read: () => Promise<SettingsRead>;
+    readonly write: (next: Record<string, unknown>) => Promise<void>;
+    readonly patch: Record<string, unknown>;
+    /** Called instead of writing when the read failed — always log this. */
+    readonly onRefused: (error: string) => void;
+}
+/**
+ * Merge `patch` over the current value and write it — unless the read failed,
+ * in which case write NOTHING.
+ *
+ * Returns whether the write was attempted, so a caller can surface the refusal.
+ */
+export declare function readModifyWrite(input: ReadModifyWriteInput): Promise<boolean>;

package/dist/{manifest-python-deps-BbOZZbVt.js → manifest-python-deps-COgal7Jy.js}

@@ -1188,6 +1188,27 @@ function addSettingsActions(addon, actions) {
 	}
 }
 //#endregion
+//#region src/kernel/moleculer/settings-read-guard.ts
+/**
+* Merge `patch` over the current value and write it — unless the read failed,
+* in which case write NOTHING.
+*
+* Returns whether the write was attempted, so a caller can surface the refusal.
+*/
+async function readModifyWrite(input) {
+	const current = await input.read();
+	if (current.kind === "failed") {
+		input.onRefused(current.error);
+		return false;
+	}
+	const base = current.kind === "value" ? current.value : {};
+	await input.write({
+		...base,
+		...input.patch
+	});
+	return true;
+}
+//#endregion
 //#region src/kernel/moleculer/device-cap-proxy.ts
 /**
 * Max number of accessory children spawned concurrently during a single
@@ -7171,8 +7192,18 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		bindingCache.clear();
 	});
 	const settingsApi = Reflect.get(api, "settingsStore");
-	const readBlob = async (coll, key, namespace) => {
-		if (!settingsApi) return {};
+	/**
+	* Read a settings blob, distinguishing a MISS from a FAILURE.
+	*
+	* Collapsing the two is a data-loss bug, not a style choice: every mutation
+	* is read-modify-write, so a failed read that answers "empty" makes the write
+	* persist the patch ALONE and destroy every field the patch does not mention.
+	* That is what emptied the recording configuration on 2026-07-31 when the UDS
+	* transport stalled — `{"enabled": false, "bands": []}`, two and a half hours
+	* of footage never written, and nothing that looked like a fault.
+	*/
+	const readBlobResult = async (coll, key, namespace) => {
+		if (!settingsApi) return { kind: "missing" };
 		try {
 			const v = await settingsApi.get.query(namespace !== void 0 ? {
 				namespace,
@@ -7182,11 +7213,40 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 				collection: coll,
 				key
 			});
-			return v && typeof v === "object" ? v : {};
-		} catch {
-			return {};
+			return v && typeof v === "object" ? {
+				kind: "value",
+				value: v
+			} : { kind: "missing" };
+		} catch (err) {
+			return {
+				kind: "failed",
+				error: (0, _camstack_types_addon.errMsg)(err)
+			};
 		}
 	};
+	/**
+	* Soft read for CONSUMERS: a failure reads as empty so a boot path degrades
+	* to defaults instead of throwing. Safe here precisely because the result is
+	* never written back — {@link readBlobResult} is what the write paths use.
+	*/
+	const readBlob = async (coll, key, namespace) => {
+		const r = await readBlobResult(coll, key, namespace);
+		return r.kind === "value" ? r.value : {};
+	};
+	/** Read-modify-write that REFUSES to write when the read failed. */
+	const mergeBlob = async (coll, key, patch, namespace) => {
+		await readModifyWrite({
+			read: () => readBlobResult(coll, key, namespace),
+			write: (next) => writeBlob(coll, key, next, namespace),
+			patch,
+			onRefused: (error) => {
+				scopedLogger.error(`settings merge REFUSED (${coll}/${key}) — read failed, refusing to overwrite with a partial blob`, { meta: {
+					error,
+					patchKeys: Object.keys(patch)
+				} });
+			}
+		});
+	};
 	const writeBlob = async (coll, key, value, namespace) => {
 		if (!settingsApi) return;
 		try {
@@ -7225,10 +7285,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		async writeAddonStore(patch) {
 			return serializeRmw("addon-settings", "root", async () => {
-				await writeBlob("addon-settings", "root", {
-					...await readBlob("addon-settings", "root", addonId),
-					...patch
-				}, addonId);
+				await mergeBlob("addon-settings", "root", patch, addonId);
 			});
 		},
 		async readDeviceStore(deviceId) {
@@ -7237,10 +7294,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		async writeDeviceStore(deviceId, patch) {
 			const key = String(deviceId);
 			return serializeRmw("addon-devices", key, async () => {
-				await writeBlob("addon-devices", key, {
-					...await readBlob("addon-devices", key, addonId),
-					...patch
-				}, addonId);
+				await mergeBlob("addon-devices", key, patch, addonId);
 			});
 		},
 		async clearDeviceStore(deviceId) {
@@ -7260,10 +7314,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		async setSection(section, patch) {
 			return serializeRmw("sections", section, async () => {
-				await writeBlob("sections", section, {
-					...await readBlob("sections", section),
-					...patch
-				});
+				await mergeBlob("sections", section, patch);
 			});
 		}
 	};

package/dist/{manifest-python-deps-C9qhvMUi.mjs → manifest-python-deps-julrfvyf.mjs}

@@ -1186,6 +1186,27 @@ function addSettingsActions(addon, actions) {
 	}
 }
 //#endregion
+//#region src/kernel/moleculer/settings-read-guard.ts
+/**
+* Merge `patch` over the current value and write it — unless the read failed,
+* in which case write NOTHING.
+*
+* Returns whether the write was attempted, so a caller can surface the refusal.
+*/
+async function readModifyWrite(input) {
+	const current = await input.read();
+	if (current.kind === "failed") {
+		input.onRefused(current.error);
+		return false;
+	}
+	const base = current.kind === "value" ? current.value : {};
+	await input.write({
+		...base,
+		...input.patch
+	});
+	return true;
+}
+//#endregion
 //#region src/kernel/moleculer/device-cap-proxy.ts
 /**
 * Max number of accessory children spawned concurrently during a single
@@ -7169,8 +7190,18 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		bindingCache.clear();
 	});
 	const settingsApi = Reflect.get(api, "settingsStore");
-	const readBlob = async (coll, key, namespace) => {
-		if (!settingsApi) return {};
+	/**
+	* Read a settings blob, distinguishing a MISS from a FAILURE.
+	*
+	* Collapsing the two is a data-loss bug, not a style choice: every mutation
+	* is read-modify-write, so a failed read that answers "empty" makes the write
+	* persist the patch ALONE and destroy every field the patch does not mention.
+	* That is what emptied the recording configuration on 2026-07-31 when the UDS
+	* transport stalled — `{"enabled": false, "bands": []}`, two and a half hours
+	* of footage never written, and nothing that looked like a fault.
+	*/
+	const readBlobResult = async (coll, key, namespace) => {
+		if (!settingsApi) return { kind: "missing" };
 		try {
 			const v = await settingsApi.get.query(namespace !== void 0 ? {
 				namespace,
@@ -7180,11 +7211,40 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 				collection: coll,
 				key
 			});
-			return v && typeof v === "object" ? v : {};
-		} catch {
-			return {};
+			return v && typeof v === "object" ? {
+				kind: "value",
+				value: v
+			} : { kind: "missing" };
+		} catch (err) {
+			return {
+				kind: "failed",
+				error: errMsg(err)
+			};
 		}
 	};
+	/**
+	* Soft read for CONSUMERS: a failure reads as empty so a boot path degrades
+	* to defaults instead of throwing. Safe here precisely because the result is
+	* never written back — {@link readBlobResult} is what the write paths use.
+	*/
+	const readBlob = async (coll, key, namespace) => {
+		const r = await readBlobResult(coll, key, namespace);
+		return r.kind === "value" ? r.value : {};
+	};
+	/** Read-modify-write that REFUSES to write when the read failed. */
+	const mergeBlob = async (coll, key, patch, namespace) => {
+		await readModifyWrite({
+			read: () => readBlobResult(coll, key, namespace),
+			write: (next) => writeBlob(coll, key, next, namespace),
+			patch,
+			onRefused: (error) => {
+				scopedLogger.error(`settings merge REFUSED (${coll}/${key}) — read failed, refusing to overwrite with a partial blob`, { meta: {
+					error,
+					patchKeys: Object.keys(patch)
+				} });
+			}
+		});
+	};
 	const writeBlob = async (coll, key, value, namespace) => {
 		if (!settingsApi) return;
 		try {
@@ -7223,10 +7283,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		async writeAddonStore(patch) {
 			return serializeRmw("addon-settings", "root", async () => {
-				await writeBlob("addon-settings", "root", {
-					...await readBlob("addon-settings", "root", addonId),
-					...patch
-				}, addonId);
+				await mergeBlob("addon-settings", "root", patch, addonId);
 			});
 		},
 		async readDeviceStore(deviceId) {
@@ -7235,10 +7292,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		async writeDeviceStore(deviceId, patch) {
 			const key = String(deviceId);
 			return serializeRmw("addon-devices", key, async () => {
-				await writeBlob("addon-devices", key, {
-					...await readBlob("addon-devices", key, addonId),
-					...patch
-				}, addonId);
+				await mergeBlob("addon-devices", key, patch, addonId);
 			});
 		},
 		async clearDeviceStore(deviceId) {
@@ -7258,10 +7312,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		async setSection(section, patch) {
 			return serializeRmw("sections", section, async () => {
-				await writeBlob("sections", section, {
-					...await readBlob("sections", section),
-					...patch
-				});
+				await mergeBlob("sections", section, patch);
 			});
 		}
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.24",
+  "version": "1.2.25",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",