@camstack/system 1.2.107 → 1.2.109

package/dist/index.mjs

@@ -2144,13 +2144,9 @@ function readInfo(raw) {
 	return {};
 }
 var integrationCounter = 0;
-var deviceCounter = 0;
 function nextIntegrationId() {
 	return `int_${String(++integrationCounter).padStart(4, "0")}`;
 }
-function nextDeviceId() {
-	return `dev_${String(++deviceCounter).padStart(4, "0")}`;
-}
 var INTEGRATIONS_COLUMNS = [
 	{
 		name: "id",
@@ -2217,95 +2213,6 @@ var INTEGRATION_SETTINGS_COLUMNS = [
 		defaultValue: "string"
 	}
 ];
-var DEVICES_COLUMNS = [
-	{
-		name: "id",
-		type: "TEXT",
-		primaryKey: true
-	},
-	{
-		name: "integration_id",
-		type: "TEXT",
-		notNull: true
-	},
-	{
-		name: "stable_id",
-		type: "TEXT",
-		notNull: true,
-		unique: true
-	},
-	{
-		name: "type",
-		type: "TEXT",
-		notNull: true,
-		defaultValue: "camera"
-	},
-	{
-		name: "name",
-		type: "TEXT",
-		notNull: true
-	},
-	{
-		name: "enabled",
-		type: "INTEGER",
-		notNull: true,
-		defaultValue: 1
-	},
-	{
-		name: "info",
-		type: "JSON",
-		notNull: true,
-		defaultValue: "{}"
-	},
-	{
-		name: "created_at",
-		type: "INTEGER",
-		notNull: true
-	},
-	{
-		name: "updated_at",
-		type: "INTEGER",
-		notNull: true
-	}
-];
-var DEVICES_INDEXES = [
-	{
-		name: "idx_devices_integration",
-		columns: ["integration_id"]
-	},
-	{
-		name: "idx_devices_stable",
-		columns: ["stable_id"],
-		unique: true
-	},
-	{
-		name: "idx_devices_type",
-		columns: ["type"]
-	}
-];
-var DEVICE_SETTINGS_COLUMNS = [
-	{
-		name: "device_id",
-		type: "TEXT",
-		notNull: true
-	},
-	{
-		name: "key",
-		type: "TEXT",
-		notNull: true
-	},
-	{
-		name: "value",
-		type: "TEXT",
-		notNull: true
-	},
-	{
-		name: "value_type",
-		type: "TEXT",
-		notNull: true,
-		defaultValue: "string"
-	}
-];
 /**
 * @durable class=config owner=integration-registry
 *   write="`createIntegration` — an operator adds a provider, or an addon declares
@@ -2324,29 +2231,19 @@ var INTEGRATIONS = "integrations";
 */
 var INTEGRATION_SETTINGS = "integration_settings";
 /**
-* `stable_id` carries a UNIQUE column constraint AND a UNIQUE index
-* (`idx_devices_stable`): that pair is what stops a provider re-announcing the
-* same physical camera from creating a second device row. An insert that
-* collides throws rather than duplicating.
+* The persisted INTEGRATIONS — one row per provider instance an operator (or a
+* declaring addon) added, plus that instance's settings.
 *
-* @durable class=config owner=integration-registry
-*   write="`createDevice` — a provider adopts a device under a stable id;
-*     `updateDevice` rewrites name/enabled/info"
-*   retention="`deleteDevice`, or the cascade in `deleteIntegration`. Nothing ages
-*     out. The `dev_NNNN` counter resumes from the highest surviving row at boot,
-*     so wiping the table restarts numbering and re-adopted cameras come back
-*     under DIFFERENT ids than every stored track and rule refers to."
-*/
-var DEVICES = "devices";
-/**
-* @durable class=config owner=integration-registry
-*   write="`setDeviceSetting` — one row per (device_id, key), deleted and
-*     re-inserted on every write; per-camera operator intent lands here"
-*   retention="cascade only — `deleteDevice` and `deleteIntegration` remove a
-*     device's rows. No sweep; losing the table silently reverts every camera to
-*     its defaults."
+* It had a device half once: `devices` + `device_settings_kv`, `dev_NNNN` ids,
+* `createDevice` / `listCameras` / `setDeviceSetting`. It was removed on
+* 2026-08-19 with both tables ([D183](../../../../../docs/decisions/adr-0183-code-that-is-deleted-takes-its-tables-with-it.md)):
+* measured on the reference hub it held 0 rows against 974 live devices, no
+* production caller ever reached it, and its id-space could not be reconciled
+* with the numeric ids every track, rule and binding in the system uses. The
+* fleet is `device-manager:devices`. Do not add a device method here — the
+* device authority is the device-manager, and a second one that agrees with
+* nothing is how this half came to exist.
 */
-var DEVICE_SETTINGS = "device_settings_kv";
 var IntegrationRegistry = class IntegrationRegistry {
 	store;
 	constructor(backend) {
@@ -2362,15 +2259,6 @@ var IntegrationRegistry = class IntegrationRegistry {
 			collection: INTEGRATION_SETTINGS,
 			columns: INTEGRATION_SETTINGS_COLUMNS
 		});
-		await this.store.declareCollection({
-			collection: DEVICES,
-			columns: DEVICES_COLUMNS,
-			indexes: DEVICES_INDEXES
-		});
-		await this.store.declareCollection({
-			collection: DEVICE_SETTINGS,
-			columns: DEVICE_SETTINGS_COLUMNS
-		});
 		const ints = await this.store.query({
 			collection: INTEGRATIONS,
 			filter: {
@@ -2385,20 +2273,6 @@ var IntegrationRegistry = class IntegrationRegistry {
 			const num = parseInt(ints[0].id.replace("int_", ""), 10);
 			if (!isNaN(num)) integrationCounter = num;
 		}
-		const devs = await this.store.query({
-			collection: DEVICES,
-			filter: {
-				orderBy: {
-					field: "id",
-					direction: "desc"
-				},
-				limit: 1
-			}
-		});
-		if (devs[0]) {
-			const num = parseInt(devs[0].id.replace("dev_", ""), 10);
-			if (!isNaN(num)) deviceCounter = num;
-		}
 	}
 	async createIntegration(input) {
 		const id = nextIntegrationId();
@@ -2482,15 +2356,6 @@ var IntegrationRegistry = class IntegrationRegistry {
 	async deleteIntegration(id) {
 		const integration = await this.getIntegration(id);
 		if (integration !== null && IntegrationRegistry.isFixed(integration)) throw new Error(`integration "${id}" is fixed — it belongs to the addon that declared it and cannot be deleted`);
-		const devices = await this.listDevices(id);
-		for (const d of devices) await this.store.deleteWhere({
-			collection: DEVICE_SETTINGS,
-			filter: { where: { device_id: d.id } }
-		});
-		await this.store.deleteWhere({
-			collection: DEVICES,
-			filter: { where: { integration_id: id } }
-		});
 		await this.store.deleteWhere({
 			collection: INTEGRATION_SETTINGS,
 			filter: { where: { integration_id: id } }
@@ -2535,139 +2400,6 @@ var IntegrationRegistry = class IntegrationRegistry {
 	async setIntegrationSettings(integrationId, settings) {
 		for (const [key, value] of Object.entries(settings)) await this.setIntegrationSetting(integrationId, key, value);
 	}
-	async createDevice(input) {
-		const id = nextDeviceId();
-		const now = Math.floor(Date.now() / 1e3);
-		await this.store.insert({
-			collection: DEVICES,
-			record: {
-				id,
-				data: {
-					integration_id: input.integrationId,
-					stable_id: input.stableId,
-					type: input.type,
-					name: input.name,
-					enabled: input.enabled !== false ? 1 : 0,
-					info: input.info ?? {},
-					created_at: now,
-					updated_at: now
-				}
-			}
-		});
-		if (input.settings) await this.setDeviceSettings(id, input.settings);
-		return {
-			id,
-			integrationId: input.integrationId,
-			stableId: input.stableId,
-			type: input.type,
-			name: input.name,
-			enabled: input.enabled !== false,
-			info: input.info ?? {},
-			createdAt: now,
-			updatedAt: now
-		};
-	}
-	async getDevice(id) {
-		const rows = await this.store.query({
-			collection: DEVICES,
-			filter: {
-				where: { id },
-				limit: 1
-			}
-		});
-		return rows[0] ? this.mapDevice(rows[0].data) : null;
-	}
-	async getDeviceByStableId(stableId) {
-		const rows = await this.store.query({
-			collection: DEVICES,
-			filter: {
-				where: { stable_id: stableId },
-				limit: 1
-			}
-		});
-		return rows[0] ? this.mapDevice(rows[0].data) : null;
-	}
-	async listDevices(integrationId) {
-		return (await this.store.query({
-			collection: DEVICES,
-			filter: {
-				...integrationId ? { where: { integration_id: integrationId } } : {},
-				orderBy: {
-					field: "created_at",
-					direction: "asc"
-				}
-			}
-		})).map((r) => this.mapDevice(r.data));
-	}
-	async listCameras() {
-		return (await this.store.query({
-			collection: DEVICES,
-			filter: {
-				where: { type: "camera" },
-				orderBy: {
-					field: "created_at",
-					direction: "asc"
-				}
-			}
-		})).map((r) => this.mapDevice(r.data));
-	}
-	async updateDevice(id, updates) {
-		const updateRow = { updated_at: Math.floor(Date.now() / 1e3) };
-		if (updates.name !== void 0) updateRow["name"] = updates.name;
-		if (updates.enabled !== void 0) updateRow["enabled"] = updates.enabled ? 1 : 0;
-		if (updates.info !== void 0) updateRow["info"] = updates.info;
-		await this.store.updateWhere({
-			collection: DEVICES,
-			filter: { where: { id } },
-			data: updateRow
-		});
-		return this.getDevice(id);
-	}
-	async deleteDevice(id) {
-		await this.store.deleteWhere({
-			collection: DEVICE_SETTINGS,
-			filter: { where: { device_id: id } }
-		});
-		await this.store.deleteWhere({
-			collection: DEVICES,
-			filter: { where: { id } }
-		});
-		return true;
-	}
-	async getDeviceSettings(deviceId) {
-		const result = {};
-		const rows = await this.store.query({
-			collection: DEVICE_SETTINGS,
-			filter: { where: { device_id: deviceId } }
-		});
-		for (const row of rows) result[String(row.data["key"])] = deserializeSetting(row.data["value"], String(row.data["value_type"]));
-		return result;
-	}
-	async setDeviceSetting(deviceId, key, value) {
-		const s = serializeSetting(value);
-		await this.store.deleteWhere({
-			collection: DEVICE_SETTINGS,
-			filter: { where: {
-				device_id: deviceId,
-				key
-			} }
-		});
-		await this.store.insert({
-			collection: DEVICE_SETTINGS,
-			record: {
-				id: `${deviceId}:${key}`,
-				data: {
-					device_id: deviceId,
-					key,
-					value: s.value,
-					value_type: s.valueType
-				}
-			}
-		});
-	}
-	async setDeviceSettings(deviceId, settings) {
-		for (const [key, value] of Object.entries(settings)) await this.setDeviceSetting(deviceId, key, value);
-	}
 	mapIntegration(row) {
 		return {
 			id: String(row["id"]),
@@ -2679,19 +2411,6 @@ var IntegrationRegistry = class IntegrationRegistry {
 			updatedAt: Number(row["updated_at"])
 		};
 	}
-	mapDevice(row) {
-		return {
-			id: String(row["id"]),
-			integrationId: String(row["integration_id"]),
-			stableId: String(row["stable_id"]),
-			type: String(row["type"]),
-			name: String(row["name"]),
-			enabled: row["enabled"] === 1,
-			info: readInfo(row["info"]),
-			createdAt: Number(row["created_at"]),
-			updatedAt: Number(row["updated_at"])
-		};
-	}
 };
 //#endregion
 //#region src/kernel/deps/ensure-native-prebuilds.ts

package/dist/retired-settings-keys-Bsjf7HQ-.mjs

@@ -0,0 +1,278 @@
+import { kt as asJsonObject } from "./dist-_oC_QkQA.mjs";
+//#region src/builtins/sqlite-storage/retired-settings-keys.ts
+/**
+* Is THIS node the one whose settings store is the cluster's authority?
+*
+* Mirrors `resolveNodeRole` (server/backend `node-role.ts`) — unset or `'hub'`
+* means hub, which is the launcher's own default. It is duplicated rather than
+* imported because `@camstack/system` is a dependency OF the backend, not the
+* other way round; the parse is four lines and the env var is the contract.
+*
+* Anything else answers `false`. Skipping where the purge should have run is a
+* missed cleanup the next hub boot fixes; running where it should not have is a
+* write to a store this node does not own. Only one of those is recoverable.
+*/
+function settingsStoreIsAuthoritativeHere(env) {
+	const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
+	return raw === "" || raw === "hub";
+}
+/**
+* The dead keys, per row.
+*
+* `detection-pipeline` / `addon-settings` / `root` — every key in this row is
+* dead; the row itself is kept because the addon writes live keys into it
+* (`pipelineTemplates`, `videoPipelineSteps`).
+*
+*  - `pipelineSteps` / `pipelineEngine`: the persisted GLOBAL step + engine
+*    seed. Removed with `getGlobalSteps` becoming pure — dispatch builds steps
+*    from the orchestrator's `agentSettings` plus per-camera overrides, and
+*    never consulted the seed. See `addon-pipeline/src/detection-pipeline/provider.ts`.
+*  - `engineRuntime` / `engineBackend` / `engineDevice` / `probedBestEngine`:
+*    the per-node engine CASCADE, removed with the operator-facing engine
+*    election. Each node now runs a device-array of inference pools balanced
+*    per session, and the node-default pool derives live from the node's own
+*    hardware (`resolveAutoEngine`). See
+*    `addon-pipeline/src/detection-pipeline/engine-store-keys.ts`.
+*/
+var RETIRED_SETTINGS_KEYS = [{
+	namespace: "detection-pipeline",
+	collection: "addon-settings",
+	row: "root",
+	keys: ["pipelineSteps", "pipelineEngine"],
+	perNodeKeys: [
+		"engineRuntime",
+		"engineBackend",
+		"engineDevice",
+		"probedBestEngine"
+	],
+	reason: "global step/engine seed and the per-node engine cascade — both removed; the live per-camera dispatch path never read either"
+}];
+/**
+* The device-manager's three fleet blobs, replaced by one row per device in
+* `device-manager:devices` (`device-row-store.ts`).
+*
+* 625 KB of the `addon-settings` table's 627 KB, re-read and re-parsed on every
+* projection and rewritten in full on every rename. `deviceIndex` is listed
+* here like the other two even though it was never migrated: `addonId` and
+* `stableId` are columns of every row, so an addon's device list is a query,
+* and the one bit that was not derivable — "has `registerDevice` run?" — is the
+* `registered` column.
+*/
+var RETIRED_SETTINGS_ROWS = [
+	{
+		collection: "addon-settings",
+		row: "device-manager.deviceMeta",
+		owner: "device-manager",
+		evidence: { collection: "device-manager:devices" },
+		reason: "the fleet is one row per device in `device-manager:devices` since the flatten; this blob was 467 KB read and JSON.parsed on hub-main per projection"
+	},
+	{
+		collection: "addon-settings",
+		row: "device-manager.deviceMetadata",
+		owner: "device-manager",
+		evidence: { collection: "device-manager:devices" },
+		reason: "hardware-identity metadata is the `metadata` column of the device row; the separate blob existed only because a blob write is whole-value"
+	},
+	{
+		collection: "addon-settings",
+		row: "device-manager.deviceIndex",
+		owner: "device-manager",
+		evidence: { collection: "device-manager:devices" },
+		reason: "derivable: `addonId`/`stableId` are indexed columns, and index membership is the `registered` column"
+	}
+];
+/**
+* Adapt the settings backend to {@link RetiredKeyStore}.
+*
+* `get` answering a non-object (missing row) is a MISS, not a fault: it maps to
+* `null` and the purge skips the row. A backend throw propagates, which is what
+* routes it to the "read failed, row left untouched" branch.
+*/
+function retiredKeyStoreOf(backend) {
+	return {
+		async read(spec) {
+			return asJsonObject(await backend.get({
+				namespace: spec.namespace,
+				collection: spec.collection,
+				key: spec.row
+			}));
+		},
+		async write(spec, value) {
+			await backend.set({
+				namespace: spec.namespace,
+				collection: spec.collection,
+				key: spec.row,
+				value
+			});
+		}
+	};
+}
+/**
+* Nested `<mapKey>.<retiredKey>` paths that `spec` retires inside a map-shaped
+* row. Pure. Values that are not plain objects are skipped, never rewritten.
+*/
+function planNestedRetiredKeyPurge(blob, spec) {
+	const nestedKeys = spec.mapValueKeys ?? [];
+	if (nestedKeys.length === 0) return [];
+	const found = [];
+	for (const [mapKey, value] of Object.entries(blob)) {
+		const inner = asJsonObject(value);
+		if (inner === null) continue;
+		for (const retired of nestedKeys) if (retired in inner) found.push(`${mapKey}.${retired}`);
+	}
+	return found;
+}
+/** Keys of `blob` that `spec` retires. Pure. */
+function planRetiredKeyPurge(blob, spec) {
+	const exact = new Set(spec.keys);
+	const found = [];
+	for (const key of Object.keys(blob)) {
+		if (exact.has(key)) {
+			found.push(key);
+			continue;
+		}
+		for (const perNode of spec.perNodeKeys) if (key === perNode || key.startsWith(`${perNode}@`)) {
+			found.push(key);
+			break;
+		}
+	}
+	return found;
+}
+/**
+* Delete every retired key present in the declared rows — on the hub.
+*
+* Off the authoritative node this is a no-op that touches nothing and says
+* nothing (see the module header). Returns one entry per row that actually
+* changed — empty when the store is already clean, which is the steady state
+* after the first boot that ran it.
+*/
+async function purgeRetiredSettingsKeys(store, logger, specs = RETIRED_SETTINGS_KEYS, env = process.env) {
+	if (!settingsStoreIsAuthoritativeHere(env)) return [];
+	const results = [];
+	for (const spec of specs) {
+		let blob;
+		try {
+			blob = await store.read(spec);
+		} catch (err) {
+			logger.warn("retired settings keys — read failed, row left untouched", { meta: {
+				addon: spec.namespace,
+				collection: spec.collection,
+				row: spec.row,
+				error: err instanceof Error ? err.message : String(err)
+			} });
+			continue;
+		}
+		if (blob === null) continue;
+		const doomed = planRetiredKeyPurge(blob, spec);
+		const doomedNested = planNestedRetiredKeyPurge(blob, spec);
+		if (doomed.length === 0 && doomedNested.length === 0) continue;
+		const doomedSet = new Set(doomed);
+		const nestedByMapKey = /* @__PURE__ */ new Map();
+		for (const path of doomedNested) {
+			const cut = path.indexOf(".");
+			const mapKey = path.slice(0, cut);
+			const inner = path.slice(cut + 1);
+			const bucket = nestedByMapKey.get(mapKey) ?? /* @__PURE__ */ new Set();
+			bucket.add(inner);
+			nestedByMapKey.set(mapKey, bucket);
+		}
+		const next = Object.fromEntries(Object.entries(blob).filter(([key]) => !doomedSet.has(key)).map(([key, value]) => {
+			const retired = nestedByMapKey.get(key);
+			if (retired === void 0) return [key, value];
+			const inner = asJsonObject(value);
+			if (inner === null) return [key, value];
+			return [key, Object.fromEntries(Object.entries(inner).filter(([k]) => !retired.has(k)))];
+		}));
+		await store.write(spec, next);
+		const result = {
+			addon: spec.namespace,
+			collection: spec.collection,
+			row: spec.row,
+			keys: doomed,
+			nested: doomedNested
+		};
+		results.push(result);
+		logger.info(`purged ${doomed.length + doomedNested.length} retired settings keys`, { meta: {
+			...result,
+			reason: spec.reason
+		} });
+	}
+	return results;
+}
+/**
+* Delete every retired ROW whose successor is populated — on the hub.
+*
+* Off the authoritative node this is a no-op that touches nothing and says
+* nothing, same gate as {@link purgeRetiredSettingsKeys}.
+*
+* **The evidence check is the whole safety of this function.** A retired row is
+* the only copy of its data until the migration has written the successor
+* collection, and the migration is an OFFLINE step an operator runs — it is not
+* part of boot. So a hub that boots the new code before being migrated must
+* find its blobs intact, not deleted: the purge SKIPS, loudly, and the next
+* boot after the migration cleans up. An evidence read that FAILS is treated
+* exactly like an empty one — a fault is never permission to delete.
+*/
+async function purgeRetiredSettingsRows(store, logger, specs = RETIRED_SETTINGS_ROWS, env = process.env) {
+	if (!settingsStoreIsAuthoritativeHere(env)) return [];
+	const results = [];
+	/** Evidence counts, memoised per collection — the specs share successors. */
+	const evidence = /* @__PURE__ */ new Map();
+	for (const spec of specs) {
+		let present;
+		try {
+			present = await store.hasRow(spec);
+		} catch (err) {
+			logger.warn("retired settings row — read failed, row left untouched", { meta: {
+				addon: spec.owner,
+				collection: spec.collection,
+				row: spec.row,
+				error: errText(err)
+			} });
+			continue;
+		}
+		if (!present) continue;
+		const successor = spec.evidence.collection;
+		let count = evidence.get(successor);
+		if (count === void 0) {
+			try {
+				count = await store.countRows(successor);
+			} catch (err) {
+				logger.warn("retired settings row — successor unreadable, row left untouched", { meta: {
+					addon: spec.owner,
+					row: spec.row,
+					successor,
+					error: errText(err)
+				} });
+				count = 0;
+			}
+			evidence.set(successor, count);
+		}
+		if (count === 0) {
+			logger.warn("retired settings row kept — its successor is empty, migration has not run", { meta: {
+				addon: spec.owner,
+				collection: spec.collection,
+				row: spec.row,
+				successor
+			} });
+			continue;
+		}
+		await store.deleteRow(spec);
+		const result = {
+			owner: spec.owner,
+			collection: spec.collection,
+			row: spec.row
+		};
+		results.push(result);
+		logger.info("purged a retired settings row", { meta: {
+			...result,
+			reason: spec.reason
+		} });
+	}
+	return results;
+}
+function errText(err) {
+	return err instanceof Error ? err.message : String(err);
+}
+//#endregion
+export { purgeRetiredSettingsRows as n, retiredKeyStoreOf as r, purgeRetiredSettingsKeys as t };