@camstack/system 1.2.123 → 1.2.125

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-B3_4YiDK.js");
+const require_manifest_python_deps = require("./manifest-python-deps-BTkFwAk_.js");
 const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
@@ -10,229 +10,6 @@ let node_v8 = require("node:v8");
 node_v8 = require_chunk.__toESM(node_v8);
 let _camstack_types_addon = require("@camstack/types/addon");
 let node_url = require("node:url");
-//#region src/kernel/moleculer/worker-device-restore.ts
-/**
-* Worker-side device restore helper.
-*
-* Shared by `process-runner` (single-addon subprocess) and
-* `group-runner` (group subprocess). Calls the worker addon's
-* `restoreDevices(SavedDevice[])` with devices read from the hub's
-* `device-manager` capability. Blocks on the `system.ready-state`
-* readiness of the hub's `device-manager` via
-* `ReadinessRegistry.awaitReady`, then issues the calls ONCE.
-*
-* Lives in its own module so it can be imported without triggering
-* the runner entry-point side effects (each runner is also an
-* executable that calls `main()` at import time).
-*/
-async function runWorkerDeviceRestoreWithRetry(addon, context, addonId, sourceNodeId) {
-	const log = context.logger;
-	log?.debug?.(`[worker-restore] entry: addon="${addonId}" sourceNodeId="${sourceNodeId}"`);
-	const restoreFn = addon.restoreDevices;
-	if (typeof restoreFn !== "function") {
-		log?.warn?.(`[worker-restore] "${addonId}": no restoreDevices function — skipping`);
-		return;
-	}
-	const api = context.api;
-	if (!api) {
-		log?.warn?.(`[worker-restore] "${addonId}": context.api missing — skipping`);
-		return;
-	}
-	const bus = context.eventBus;
-	if (!bus) {
-		log?.warn?.(`[worker-restore] "${addonId}": context.eventBus missing — skipping`);
-		return;
-	}
-	const shared = context.kernel?.readinessRegistry ?? null;
-	const registry = shared ?? new _camstack_types_addon.ReadinessRegistry({
-		eventBus: bus,
-		sourceNodeId,
-		logger: context.logger
-	});
-	log?.debug?.(`[worker-restore] "${addonId}": awaiting device-manager readiness on hub...`);
-	try {
-		await registry.awaitReady("device-manager", {
-			type: "node",
-			nodeId: "hub"
-		}, { timeoutMs: 6e4 });
-		log?.debug?.(`[worker-restore] "${addonId}": device-manager READY`);
-	} catch (err) {
-		if (err instanceof _camstack_types_addon.ReadinessTimeoutError) {
-			context.logger?.warn?.(`[worker-restore] device-manager not ready within ${err.waitedMs}ms — skipping for "${addonId}"`);
-			return;
-		}
-		throw err;
-	} finally {
-		if (!shared && registry instanceof _camstack_types_addon.ReadinessRegistry) registry.close();
-	}
-	try {
-		const deviceManager = Reflect.get(api, "deviceManager");
-		log?.debug?.(`[worker-restore] "${addonId}": calling listPersistedByAddon...`);
-		const rowsResult = await deviceManager.listPersistedByAddon.query({ addonId });
-		log?.debug?.(`[worker-restore] "${addonId}": got ${Array.isArray(rowsResult) ? rowsResult.length : 0} row(s)`);
-		const rows = Array.isArray(rowsResult) ? rowsResult : [];
-		if (rows.length === 0) {
-			context.logger?.info?.(`[worker-restore] no persisted devices to restore for addon "${addonId}"`);
-			return;
-		}
-		const savedDevices = await Promise.all(rows.map(async (row) => {
-			const config = await deviceManager.loadConfig.query({ deviceId: row.id });
-			return {
-				id: row.id,
-				stableId: row.stableId,
-				type: row.type,
-				name: row.name,
-				parentDeviceId: row.parentDeviceId,
-				config: config ?? {}
-			};
-		}));
-		await restoreFn.call(addon, savedDevices);
-		log?.info?.(`[worker-restore] "${addonId}": restored ${savedDevices.length} device(s)`);
-	} catch (err) {
-		log?.warn?.(`[worker-restore] "${addonId}": restoreDevices threw: ${(0, _camstack_types_addon.errMsg)(err)}`);
-	}
-}
-//#endregion
-//#region src/kernel/moleculer/register-framework-resolver.ts
-/**
-* Register the ESM resolver hook so this runner's addon imports of the
-* host-provided packages (@camstack/system, @camstack/shm-ring, …) resolve from
-* `frameworkDir/node_modules` instead of failing to walk up from the addon's
-* isolated `/data/addons/<addon>` folder. No-op in dev (frameworkDir unset),
-* where workspace symlinks already resolve the framework.
-*/
-function registerFrameworkResolver(frameworkDir) {
-	if (!frameworkDir) return;
-	(0, node_module.register)((0, node_url.pathToFileURL)(node_path.join(__dirname, "framework-resolver-hook.mjs")), {
-		parentURL: (0, node_url.pathToFileURL)(`${__dirname}/`).href,
-		data: { frameworkDir }
-	});
-}
-/**
-* Start warning if `initialize()` has not returned within `firstMs`.
-*
-* The caller MUST `clear()` in a `finally`, so a throwing initialize (which the
-* runner turns into `process.exit(1)`) does not keep the timer alive.
-*/
-function startInitWatchdog(options) {
-	const now = options.now ?? Date.now;
-	const firstMs = options.firstMs ?? 6e4;
-	const repeatMs = options.repeatMs ?? 3e5;
-	const startedAt = now();
-	let timer;
-	let cleared = false;
-	const schedule = (ms) => {
-		timer = setTimeout(fire, ms);
-		timer.unref?.();
-	};
-	function fire() {
-		if (cleared) return;
-		const elapsedMs = now() - startedAt;
-		options.warn(`addon "${options.addonId}" initialize() has not returned after ${Math.round(elapsedMs / 1e3)}s — its capability manifest is NOT published, so every caller of ${options.declaredCapabilities.length > 0 ? options.declaredCapabilities.join(", ") : "(none declared)"} sees "no provider registered"`, {
-			addonId: options.addonId,
-			elapsedMs,
-			unpublishedCapabilities: [...options.declaredCapabilities]
-		});
-		schedule(repeatMs);
-	}
-	schedule(firstMs);
-	return { clear() {
-		cleared = true;
-		if (timer !== void 0) {
-			clearTimeout(timer);
-			timer = void 0;
-		}
-	} };
-}
-//#endregion
-//#region src/kernel/moleculer/child-cap-dispatch.ts
-/** Type guard narrowing a dynamically-read provider member to a callable method. */
-function isCapMethod(value) {
-	return typeof value === "function";
-}
-/**
-* Extract a string `addonId` out of arbitrary method args — the fallback
-* provider-selection hint for calls that arrive WITHOUT the out-of-band
-* `CapCallMessage.addonId` (e.g. a sibling child's unowned collection call
-* forwarded by the parent, where the raw input still carries `addonId`).
-*/
-function extractArgsAddonId(args) {
-	if (args === null || typeof args !== "object") return void 0;
-	const raw = Reflect.get(args, "addonId");
-	return typeof raw === "string" ? raw : void 0;
-}
-/**
-* Creates a unified dispatcher that routes a {@link CapCallInput} to either a
-* device-scoped or singleton provider, then invokes the requested method.
-*
-* Pure module — no Moleculer, no broker, no addon-runner dependency.
-*/
-function createChildCapDispatch(deps) {
-	return async (call) => {
-		const { capName, method, args, deviceId } = call;
-		const addonId = call.addonId ?? extractArgsAddonId(args);
-		let provider;
-		if (deviceId !== void 0) {
-			provider = deps.getDeviceProvider(capName, deviceId) ?? deps.getSingletonProvider(capName, addonId);
-			if (provider == null) throw new Error(`child-cap-dispatch: no provider for '${capName}' (device '${String(deviceId)}' or singleton)`);
-		} else {
-			provider = deps.getSingletonProvider(capName, addonId);
-			if (provider == null) throw new Error(`child-cap-dispatch: no singleton provider for '${capName}'`);
-		}
-		const fn = Reflect.get(provider, method);
-		if (!isCapMethod(fn)) {
-			if (deps.isCollectionListMethod(capName, method)) return [];
-			throw new Error(`child-cap-dispatch: method '${method}' not found on provider '${capName}'`);
-		}
-		return await fn.call(provider, args);
-	};
-}
-//#endregion
-//#region src/kernel/moleculer/child-cap-descriptors.ts
-/**
-* Builds the {@link ChildCapDescriptor} array that the UDS child transport
-* sends to the parent on registration.
-*
-* - Singleton caps come from the runner UNION manifest (all caps registered by
-*   every addon in this runner). One descriptor per unique (addonId, capName)
-*   pair, mode `'singleton'` and no `deviceId`. The `addonId` stamp lets the
-*   parent's manifest builder register each hosted addon's caps under the
-*   REAL addon id — a GROUPED runner (`execution.group`) hosts several addons,
-*   and deduplicating by capName alone would collapse two co-located providers
-*   of the same collection cap (e.g. `network-access` from cloudflare-tunnel
-*   AND tailscale-ingress) into one descriptor registered under a synthetic
-*   `addonId = childId` (the group name) — the "@camstack/addon-net-access"
-*   admin-UI bug.
-* - Device-scoped caps come from the native-cap snapshot — one descriptor per
-*   (capName, deviceId) pair, mode `'collection'`, stamped with the owning
-*   addon's id.
-*
-* Pure module — extracted from `addon-runner.ts` (whose `main()` runs at
-* import time) so it is unit-testable.
-*/
-function buildChildCapDescriptors(manifest, nativeCapSnapshot) {
-	const descriptors = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const entry of manifest) for (const capName of entry.capabilities) {
-		const key = `${entry.addonId}::${capName}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			descriptors.push({
-				capName,
-				mode: "singleton",
-				addonId: entry.addonId
-			});
-		}
-	}
-	for (const { capName, addonId, deviceIds } of nativeCapSnapshot) for (const deviceId of deviceIds) descriptors.push({
-		capName,
-		mode: "collection",
-		deviceId,
-		addonId
-	});
-	return descriptors;
-}
-//#endregion
 //#region src/kernel/moleculer/child-addon-call-dispatch.ts
 function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -324,6 +101,229 @@ function createChildAddonCallDispatch(deps) {
 	};
 }
 //#endregion
+//#region src/kernel/moleculer/child-cap-descriptors.ts
+/**
+* Builds the {@link ChildCapDescriptor} array that the UDS child transport
+* sends to the parent on registration.
+*
+* - Singleton caps come from the runner UNION manifest (all caps registered by
+*   every addon in this runner). One descriptor per unique (addonId, capName)
+*   pair, mode `'singleton'` and no `deviceId`. The `addonId` stamp lets the
+*   parent's manifest builder register each hosted addon's caps under the
+*   REAL addon id — a GROUPED runner (`execution.group`) hosts several addons,
+*   and deduplicating by capName alone would collapse two co-located providers
+*   of the same collection cap (e.g. `network-access` from cloudflare-tunnel
+*   AND tailscale-ingress) into one descriptor registered under a synthetic
+*   `addonId = childId` (the group name) — the "@camstack/addon-net-access"
+*   admin-UI bug.
+* - Device-scoped caps come from the native-cap snapshot — one descriptor per
+*   (capName, deviceId) pair, mode `'collection'`, stamped with the owning
+*   addon's id.
+*
+* Pure module — extracted from `addon-runner.ts` (whose `main()` runs at
+* import time) so it is unit-testable.
+*/
+function buildChildCapDescriptors(manifest, nativeCapSnapshot) {
+	const descriptors = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of manifest) for (const capName of entry.capabilities) {
+		const key = `${entry.addonId}::${capName}`;
+		if (!seen.has(key)) {
+			seen.add(key);
+			descriptors.push({
+				capName,
+				mode: "singleton",
+				addonId: entry.addonId
+			});
+		}
+	}
+	for (const { capName, addonId, deviceIds } of nativeCapSnapshot) for (const deviceId of deviceIds) descriptors.push({
+		capName,
+		mode: "collection",
+		deviceId,
+		addonId
+	});
+	return descriptors;
+}
+//#endregion
+//#region src/kernel/moleculer/child-cap-dispatch.ts
+/** Type guard narrowing a dynamically-read provider member to a callable method. */
+function isCapMethod(value) {
+	return typeof value === "function";
+}
+/**
+* Extract a string `addonId` out of arbitrary method args — the fallback
+* provider-selection hint for calls that arrive WITHOUT the out-of-band
+* `CapCallMessage.addonId` (e.g. a sibling child's unowned collection call
+* forwarded by the parent, where the raw input still carries `addonId`).
+*/
+function extractArgsAddonId(args) {
+	if (args === null || typeof args !== "object") return void 0;
+	const raw = Reflect.get(args, "addonId");
+	return typeof raw === "string" ? raw : void 0;
+}
+/**
+* Creates a unified dispatcher that routes a {@link CapCallInput} to either a
+* device-scoped or singleton provider, then invokes the requested method.
+*
+* Pure module — no Moleculer, no broker, no addon-runner dependency.
+*/
+function createChildCapDispatch(deps) {
+	return async (call) => {
+		const { capName, method, args, deviceId } = call;
+		const addonId = call.addonId ?? extractArgsAddonId(args);
+		let provider;
+		if (deviceId !== void 0) {
+			provider = deps.getDeviceProvider(capName, deviceId) ?? deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no provider for '${capName}' (device '${String(deviceId)}' or singleton)`);
+		} else {
+			provider = deps.getSingletonProvider(capName, addonId);
+			if (provider == null) throw new Error(`child-cap-dispatch: no singleton provider for '${capName}'`);
+		}
+		const fn = Reflect.get(provider, method);
+		if (!isCapMethod(fn)) {
+			if (deps.isCollectionListMethod(capName, method)) return [];
+			throw new Error(`child-cap-dispatch: method '${method}' not found on provider '${capName}'`);
+		}
+		return await fn.call(provider, args);
+	};
+}
+/**
+* Start warning if `initialize()` has not returned within `firstMs`.
+*
+* The caller MUST `clear()` in a `finally`, so a throwing initialize (which the
+* runner turns into `process.exit(1)`) does not keep the timer alive.
+*/
+function startInitWatchdog(options) {
+	const now = options.now ?? Date.now;
+	const firstMs = options.firstMs ?? 6e4;
+	const repeatMs = options.repeatMs ?? 3e5;
+	const startedAt = now();
+	let timer;
+	let cleared = false;
+	const schedule = (ms) => {
+		timer = setTimeout(fire, ms);
+		timer.unref?.();
+	};
+	function fire() {
+		if (cleared) return;
+		const elapsedMs = now() - startedAt;
+		options.warn(`addon "${options.addonId}" initialize() has not returned after ${Math.round(elapsedMs / 1e3)}s — its capability manifest is NOT published, so every caller of ${options.declaredCapabilities.length > 0 ? options.declaredCapabilities.join(", ") : "(none declared)"} sees "no provider registered"`, {
+			addonId: options.addonId,
+			elapsedMs,
+			unpublishedCapabilities: [...options.declaredCapabilities]
+		});
+		schedule(repeatMs);
+	}
+	schedule(firstMs);
+	return { clear() {
+		cleared = true;
+		if (timer !== void 0) {
+			clearTimeout(timer);
+			timer = void 0;
+		}
+	} };
+}
+//#endregion
+//#region src/kernel/moleculer/register-framework-resolver.ts
+/**
+* Register the ESM resolver hook so this runner's addon imports of the
+* host-provided packages (@camstack/system, @camstack/shm-ring, …) resolve from
+* `frameworkDir/node_modules` instead of failing to walk up from the addon's
+* isolated `/data/addons/<addon>` folder. No-op in dev (frameworkDir unset),
+* where workspace symlinks already resolve the framework.
+*/
+function registerFrameworkResolver(frameworkDir) {
+	if (!frameworkDir) return;
+	(0, node_module.register)((0, node_url.pathToFileURL)(node_path.join(__dirname, "framework-resolver-hook.mjs")), {
+		parentURL: (0, node_url.pathToFileURL)(`${__dirname}/`).href,
+		data: { frameworkDir }
+	});
+}
+//#endregion
+//#region src/kernel/moleculer/worker-device-restore.ts
+/**
+* Worker-side device restore helper.
+*
+* Shared by `process-runner` (single-addon subprocess) and
+* `group-runner` (group subprocess). Calls the worker addon's
+* `restoreDevices(SavedDevice[])` with devices read from the hub's
+* `device-manager` capability. Blocks on the `system.ready-state`
+* readiness of the hub's `device-manager` via
+* `ReadinessRegistry.awaitReady`, then issues the calls ONCE.
+*
+* Lives in its own module so it can be imported without triggering
+* the runner entry-point side effects (each runner is also an
+* executable that calls `main()` at import time).
+*/
+async function runWorkerDeviceRestoreWithRetry(addon, context, addonId, sourceNodeId) {
+	const log = context.logger;
+	log?.debug?.(`[worker-restore] entry: addon="${addonId}" sourceNodeId="${sourceNodeId}"`);
+	const restoreFn = addon.restoreDevices;
+	if (typeof restoreFn !== "function") {
+		log?.warn?.(`[worker-restore] "${addonId}": no restoreDevices function — skipping`);
+		return;
+	}
+	const api = context.api;
+	if (!api) {
+		log?.warn?.(`[worker-restore] "${addonId}": context.api missing — skipping`);
+		return;
+	}
+	const bus = context.eventBus;
+	if (!bus) {
+		log?.warn?.(`[worker-restore] "${addonId}": context.eventBus missing — skipping`);
+		return;
+	}
+	const shared = context.kernel?.readinessRegistry ?? null;
+	const registry = shared ?? new _camstack_types_addon.ReadinessRegistry({
+		eventBus: bus,
+		sourceNodeId,
+		logger: context.logger
+	});
+	log?.debug?.(`[worker-restore] "${addonId}": awaiting device-manager readiness on hub...`);
+	try {
+		await registry.awaitReady("device-manager", {
+			type: "node",
+			nodeId: "hub"
+		}, { timeoutMs: 6e4 });
+		log?.debug?.(`[worker-restore] "${addonId}": device-manager READY`);
+	} catch (err) {
+		if (err instanceof _camstack_types_addon.ReadinessTimeoutError) {
+			context.logger?.warn?.(`[worker-restore] device-manager not ready within ${err.waitedMs}ms — skipping for "${addonId}"`);
+			return;
+		}
+		throw err;
+	} finally {
+		if (!shared && registry instanceof _camstack_types_addon.ReadinessRegistry) registry.close();
+	}
+	try {
+		const deviceManager = Reflect.get(api, "deviceManager");
+		log?.debug?.(`[worker-restore] "${addonId}": calling listPersistedByAddon...`);
+		const rowsResult = await deviceManager.listPersistedByAddon.query({ addonId });
+		log?.debug?.(`[worker-restore] "${addonId}": got ${Array.isArray(rowsResult) ? rowsResult.length : 0} row(s)`);
+		const rows = Array.isArray(rowsResult) ? rowsResult : [];
+		if (rows.length === 0) {
+			context.logger?.info?.(`[worker-restore] no persisted devices to restore for addon "${addonId}"`);
+			return;
+		}
+		const savedDevices = await Promise.all(rows.map(async (row) => {
+			const config = await deviceManager.loadConfig.query({ deviceId: row.id });
+			return {
+				id: row.id,
+				stableId: row.stableId,
+				type: row.type,
+				name: row.name,
+				parentDeviceId: row.parentDeviceId,
+				config: config ?? {}
+			};
+		}));
+		await restoreFn.call(addon, savedDevices);
+		log?.info?.(`[worker-restore] "${addonId}": restored ${savedDevices.length} device(s)`);
+	} catch (err) {
+		log?.warn?.(`[worker-restore] "${addonId}": restoreDevices threw: ${(0, _camstack_types_addon.errMsg)(err)}`);
+	}
+}
+//#endregion
 //#region src/kernel/moleculer/addon-runner.ts
 /**
 * Addon Runner — THE unified entry point for spawned subprocesses.