@camstack/system 1.0.5 → 1.0.7

package/dist/kernel/moleculer/device-cap-proxy.d.ts

@@ -1,4 +1,5 @@
-import { deviceOpsCapability, AddonApi, CapabilityDefinition, DeviceManagerApi, IDevice, IEventBus, IKernelStreamProbe, IScopedLogger, InferProvider } from '@camstack/types';
+import { deviceOpsCapability } from '@camstack/types/addon';
+import { AddonApi, CapabilityDefinition, DeviceManagerApi, IDevice, IEventBus, IKernelStreamProbe, IScopedLogger, InferProvider } from '@camstack/types';
 import { ServiceBroker } from 'moleculer';
 import { DeviceRegistry } from '../device-registry.js';
 import { CapabilityRegistry } from '../capability-registry.js';

package/dist/kernel/moleculer/readiness-context.d.ts

@@ -1,5 +1,6 @@
 import { ServiceBroker } from 'moleculer';
-import { IEventBus, IScopedLogger, ReadinessRegistry } from '@camstack/types';
+import { IEventBus, IScopedLogger } from '@camstack/types';
+import { ReadinessRegistry } from '@camstack/types/addon';
 /**
  * Minimal interface for the `LocalChildClient` surface used in UDS-mode
  * readiness hydration. Declared here (rather than importing the concrete

package/dist/{manifest-python-deps-CXbKrOdk.mjs → manifest-python-deps-CoJXeb9u.mjs}

@@ -4,7 +4,6 @@ import { createServer } from "node:http";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { isAbsolute, join } from "node:path";
-import { DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, scopeKey, sleep } from "@camstack/types";
 import * as crypto$1 from "node:crypto";
 import { randomBytes, randomUUID } from "node:crypto";
 import { execFile } from "node:child_process";
@@ -12,6 +11,7 @@ import { promisify } from "node:util";
 import * as os from "node:os";
 import { tmpdir } from "node:os";
 import { unlink } from "node:fs/promises";
+import { DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, scopeKey, sleep } from "@camstack/types/addon";
 import { TRPCClientError, createTRPCClient } from "@trpc/client";
 import { connect, createServer as createServer$1 } from "node:net";
 //#region src/kernel/addon-class-resolver.ts
@@ -381,43 +381,6 @@ var CapabilityHandle = class {
 	}
 };
 //#endregion
-//#region src/kernel/custom-action-registry.ts
-/**
-* CustomActionRegistry — per-process registry of addon custom actions.
-*
-* Populated at boot from each addon's `AddonInitResult.customActions` +
-* `handleCustomAction` handler. Rejects actions declared with scope other
-* than 'system' (today only 'system' is runtime-supported; the descriptor
-* allows future scopes for forward compat).
-*/
-var CustomActionRegistry = class {
-	byAddon = /* @__PURE__ */ new Map();
-	registerAddon(addonId, catalog, handler) {
-		const actions = /* @__PURE__ */ new Map();
-		for (const [name, spec] of Object.entries(catalog)) {
-			const scope = spec.scope ?? { kind: "system" };
-			if (scope.kind !== "system") throw new Error(`custom action '${addonId}.${name}' declared scope '${scope.kind}' — not yet implemented`);
-			actions.set(name, {
-				spec,
-				handler: (input) => handler(name, input)
-			});
-		}
-		this.byAddon.set(addonId, actions);
-	}
-	unregisterAddon(addonId) {
-		this.byAddon.delete(addonId);
-	}
-	resolve(addonId, action) {
-		return this.byAddon.get(addonId)?.get(action) ?? null;
-	}
-	listActions(addonId) {
-		return [...this.byAddon.get(addonId)?.keys() ?? []];
-	}
-	listAddons() {
-		return [...this.byAddon.keys()];
-	}
-};
-//#endregion
 //#region src/kernel/device-registry.ts
 var DeviceRegistry = class {
 	/** Primary map: every registered device keyed by its progressive
@@ -6566,4 +6529,4 @@ async function installManifestPythonDeps(declaration, addonDir, deps, logger) {
 	await deps.installPythonRequirements(reqAbs);
 }
 //#endregion
-export { setWorkerNativeCapsChangeListener as $, createUdsLoggerWithControl as A, createLocalTransport as B, ipcParentLink as C, createUdsEventBus as D, createUdsEventBridge as E, CapRouteError as F, FrameDecoder as G, UdsLocalTransportServer as H, classifyCapRoute as I, buildUdsNativeCapProxy as J, encodeFrame as K, LocalChildClient as L, AGENT_CAP_FWD_SERVICE as M, CapRouteResolver as N, udsChildLogToWorkerEntry as O, callWithServiceDiscovery as P, mountNativeCapService as Q, LocalChildRegistry as R, ipcChildLink as S, createParentUnownedCallHandler as T, SocketChannel as U, UdsLocalTransportClient as V, localEndpointPath as W, getWorkerNativeCapProvider as X, createBrokerDeviceManagerApi as Y, getWorkerNativeCapSnapshot as Z, __resetCapUsageRegistryForTests as _, getWorkerDeviceRegistry as a, capBareAction as at, brokerTransportLink as b, setHubConnected as c, deserializeTypedArrays as ct, registerEventBusService as d, CustomActionRegistry as dt, createAddonService as et, AddonDepsManager as f, CapabilityHandle as ft, CapUsageRegistry as g, createHwAccelService as h, resolveAddonClass as ht, createUdsAddonContext as i, capActionSuffix as it, AGENT_CAP_FWD_ACTION as j, createUdsLogger as k, EVENT_TOPIC_PREFIX as l, serializeTypedArrays as lt, resolveHwAccel as m, installManifestNativeDeps as mt, adaptBrokerToCluster as n, NATIVE_PROVIDER_SERVICE_INFIX as nt, getOrInitReadinessRegistry as o, capServiceName as ot, createKernelHwAccel as p, CapabilityUnavailableError as pt, buildNativeCapProxy as q, createAddonContext as r, capActionName as rt, getOrInitReadinessRegistryForClient as s, parseCapAction as st, installManifestPythonDeps as t, validateProviderRegistrations as tt, getBrokerEventBus as u, DeviceRegistry as ut, getCapUsageRegistry as v, localProviderLink as w, buildLinkChain as x, brokerCallForCap as y, UDS_NO_ROUTE_PREFIX as z };
+export { setWorkerNativeCapsChangeListener as $, createUdsLoggerWithControl as A, createLocalTransport as B, ipcParentLink as C, createUdsEventBus as D, createUdsEventBridge as E, CapRouteError as F, FrameDecoder as G, UdsLocalTransportServer as H, classifyCapRoute as I, buildUdsNativeCapProxy as J, encodeFrame as K, LocalChildClient as L, AGENT_CAP_FWD_SERVICE as M, CapRouteResolver as N, udsChildLogToWorkerEntry as O, callWithServiceDiscovery as P, mountNativeCapService as Q, LocalChildRegistry as R, ipcChildLink as S, createParentUnownedCallHandler as T, SocketChannel as U, UdsLocalTransportClient as V, localEndpointPath as W, getWorkerNativeCapProvider as X, createBrokerDeviceManagerApi as Y, getWorkerNativeCapSnapshot as Z, __resetCapUsageRegistryForTests as _, getWorkerDeviceRegistry as a, capBareAction as at, brokerTransportLink as b, setHubConnected as c, deserializeTypedArrays as ct, registerEventBusService as d, CapabilityHandle as dt, createAddonService as et, AddonDepsManager as f, CapabilityUnavailableError as ft, CapUsageRegistry as g, createHwAccelService as h, createUdsAddonContext as i, capActionSuffix as it, AGENT_CAP_FWD_ACTION as j, createUdsLogger as k, EVENT_TOPIC_PREFIX as l, serializeTypedArrays as lt, resolveHwAccel as m, resolveAddonClass as mt, adaptBrokerToCluster as n, NATIVE_PROVIDER_SERVICE_INFIX as nt, getOrInitReadinessRegistry as o, capServiceName as ot, createKernelHwAccel as p, installManifestNativeDeps as pt, buildNativeCapProxy as q, createAddonContext as r, capActionName as rt, getOrInitReadinessRegistryForClient as s, parseCapAction as st, installManifestPythonDeps as t, validateProviderRegistrations as tt, getBrokerEventBus as u, DeviceRegistry as ut, getCapUsageRegistry as v, localProviderLink as w, buildLinkChain as x, brokerCallForCap as y, UDS_NO_ROUTE_PREFIX as z };

package/dist/{manifest-python-deps-B4BmMoGT.js → manifest-python-deps-eBDj5HEY.js}

@@ -5,7 +5,6 @@ let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
-let _camstack_types = require("@camstack/types");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let node_child_process = require("node:child_process");
@@ -13,6 +12,7 @@ let node_util = require("node:util");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs_promises = require("node:fs/promises");
+let _camstack_types_addon = require("@camstack/types/addon");
 let _trpc_client = require("@trpc/client");
 let node_net = require("node:net");
 //#region src/kernel/addon-class-resolver.ts
@@ -103,7 +103,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 		} catch (err) {
 			logger.warn("Failed to write native deps marker", { meta: {
 				markerFile,
-				error: (0, _camstack_types.errMsg)(err)
+				error: (0, _camstack_types_addon.errMsg)(err)
 			} });
 		}
 		return;
@@ -130,7 +130,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 			timeout: 3e5
 		});
 	} catch (err) {
-		throw new Error(`npm install of native deps failed for ${addonDir}: ${(0, _camstack_types.errMsg)(err)}`, { cause: err });
+		throw new Error(`npm install of native deps failed for ${addonDir}: ${(0, _camstack_types_addon.errMsg)(err)}`, { cause: err });
 	}
 	await rebuildNativeDeps(addonDir, pending.map(([name]) => name), logger);
 	try {
@@ -138,7 +138,7 @@ async function installManifestNativeDeps(addonDir, pkgRaw, logger, registry) {
 	} catch (err) {
 		logger.warn("Failed to write native deps marker", { meta: {
 			markerFile,
-			error: (0, _camstack_types.errMsg)(err)
+			error: (0, _camstack_types_addon.errMsg)(err)
 		} });
 	}
 }
@@ -175,7 +175,7 @@ function copyPrebuiltNativeDep(name, addonDir, logger) {
 			logger.warn("Prebuilt native dep copy failed — will try npm install", { meta: {
 				name,
 				source,
-				error: (0, _camstack_types.errMsg)(err)
+				error: (0, _camstack_types_addon.errMsg)(err)
 			} });
 		}
 	}
@@ -208,13 +208,13 @@ function candidateHoistedDirs(name, addonDir) {
 }
 /** Read & validate `camstack.nativeDependencies`. Returns null when absent. */
 function readNativeDeps(pkgRaw) {
-	const camstack = (0, _camstack_types.asJsonObject)(pkgRaw["camstack"]);
+	const camstack = (0, _camstack_types_addon.asJsonObject)(pkgRaw["camstack"]);
 	if (!camstack) return null;
-	const native = (0, _camstack_types.asJsonObject)(camstack["nativeDependencies"]);
+	const native = (0, _camstack_types_addon.asJsonObject)(camstack["nativeDependencies"]);
 	if (!native) return null;
 	const out = {};
 	for (const [k, v] of Object.entries(native)) {
-		const range = (0, _camstack_types.asString)(v);
+		const range = (0, _camstack_types_addon.asString)(v);
 		if (range) out[k] = range;
 	}
 	return Object.keys(out).length > 0 ? out : null;
@@ -281,7 +281,7 @@ async function rebuildNativeDeps(addonDir, packageNames, logger) {
 		} catch (err) {
 			logger.warn("Electron rebuild failed (continuing — prebuilt binary may be present)", { meta: {
 				addonDir,
-				error: (0, _camstack_types.errMsg)(err)
+				error: (0, _camstack_types_addon.errMsg)(err)
 			} });
 		}
 		return;
@@ -299,7 +299,7 @@ async function rebuildNativeDeps(addonDir, packageNames, logger) {
 	} catch (err) {
 		logger.warn("npm rebuild failed (continuing — prebuilt binary may be present)", { meta: {
 			addonDir,
-			error: (0, _camstack_types.errMsg)(err)
+			error: (0, _camstack_types_addon.errMsg)(err)
 		} });
 	}
 }
@@ -382,43 +382,6 @@ var CapabilityHandle = class {
 	}
 };
 //#endregion
-//#region src/kernel/custom-action-registry.ts
-/**
-* CustomActionRegistry — per-process registry of addon custom actions.
-*
-* Populated at boot from each addon's `AddonInitResult.customActions` +
-* `handleCustomAction` handler. Rejects actions declared with scope other
-* than 'system' (today only 'system' is runtime-supported; the descriptor
-* allows future scopes for forward compat).
-*/
-var CustomActionRegistry = class {
-	byAddon = /* @__PURE__ */ new Map();
-	registerAddon(addonId, catalog, handler) {
-		const actions = /* @__PURE__ */ new Map();
-		for (const [name, spec] of Object.entries(catalog)) {
-			const scope = spec.scope ?? { kind: "system" };
-			if (scope.kind !== "system") throw new Error(`custom action '${addonId}.${name}' declared scope '${scope.kind}' — not yet implemented`);
-			actions.set(name, {
-				spec,
-				handler: (input) => handler(name, input)
-			});
-		}
-		this.byAddon.set(addonId, actions);
-	}
-	unregisterAddon(addonId) {
-		this.byAddon.delete(addonId);
-	}
-	resolve(addonId, action) {
-		return this.byAddon.get(addonId)?.get(action) ?? null;
-	}
-	listActions(addonId) {
-		return [...this.byAddon.get(addonId)?.keys() ?? []];
-	}
-	listAddons() {
-		return [...this.byAddon.keys()];
-	}
-};
-//#endregion
 //#region src/kernel/device-registry.ts
 var DeviceRegistry = class {
 	/** Primary map: every registered device keyed by its progressive
@@ -963,7 +926,7 @@ var nativeCapReadinessGeneration = typeof crypto !== "undefined" && crypto.rando
 function mountNativeCapService(broker, addonId, cap) {
 	const serviceName = capServiceName(addonId, cap.name, true);
 	if (mountedNativeCapServices.has(serviceName)) return;
-	const expandedMethods = (0, _camstack_types.expandCapMethods)(cap);
+	const expandedMethods = (0, _camstack_types_addon.expandCapMethods)(cap);
 	if (expandedMethods === void 0 || Object.keys(expandedMethods).length === 0 || typeof broker.createService !== "function") {
 		mountedNativeCapServices.add(serviceName);
 		return;
@@ -1069,7 +1032,7 @@ async function callWithServiceDiscoveryRetry(broker, actionName, input) {
 		if (!(err instanceof Error ? err.message : String(err)).includes("is not found")) throw err;
 		attempt++;
 		if (attempt === 1) broker.logger.warn(`native-cap-bridge: service not found for "${actionName}", retrying with exponential backoff…`);
-		await (0, _camstack_types.sleep)(delay);
+		await (0, _camstack_types_addon.sleep)(delay);
 		delay = Math.min(delay * 2, BACKOFF_MAX_MS);
 	}
 }
@@ -1174,7 +1137,7 @@ function createBrokerDeviceManagerApi(opts) {
 			parentDeviceId,
 			logger: (() => {
 				const base = opts.logger.child(stableId);
-				const containerDeviceId = parentDeviceId ?? (deviceMeta?.type === _camstack_types.DeviceType.Container ? id : null);
+				const containerDeviceId = parentDeviceId ?? (deviceMeta?.type === _camstack_types_addon.DeviceType.Container ? id : null);
 				return base.withTags(containerDeviceId !== null ? {
 					deviceId: id,
 					containerDeviceId
@@ -1200,7 +1163,7 @@ function createBrokerDeviceManagerApi(opts) {
 				id,
 				stableId,
 				addonId,
-				type: _camstack_types.DeviceType.Camera,
+				type: _camstack_types_addon.DeviceType.Camera,
 				name: stableId,
 				location: null,
 				disabled: false,
@@ -1208,7 +1171,7 @@ function createBrokerDeviceManagerApi(opts) {
 				metadata: null
 			},
 			fetchDevice: async (deviceId) => {
-				return (0, _camstack_types.createDeviceProxy)(api, await api.deviceManager.getBindings.query({ deviceId }));
+				return (0, _camstack_types_addon.createDeviceProxy)(api, await api.deviceManager.getBindings.query({ deviceId }));
 			},
 			get devices() {
 				return selfApi;
@@ -1266,7 +1229,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id
 					},
-					category: _camstack_types.EventCategory.DeviceBindingsChanged,
+					category: _camstack_types_addon.EventCategory.DeviceBindingsChanged,
 					data: {
 						deviceId: id,
 						capName: cap.name,
@@ -1275,7 +1238,7 @@ function createBrokerDeviceManagerApi(opts) {
 						nodeId
 					}
 				});
-				(0, _camstack_types.emitReadiness)(eventBus, {
+				(0, _camstack_types_addon.emitReadiness)(eventBus, {
 					capName: cap.name,
 					scope: {
 						type: "device",
@@ -1513,7 +1476,7 @@ function createBrokerDeviceManagerApi(opts) {
 		},
 		register: async (device) => {
 			registry.register(addonId, device);
-			buildContext(device.stableId, device.id, device.parentDeviceId).registerNativeCap(_camstack_types.deviceOpsCapability, buildDeviceOpsProvider(device));
+			buildContext(device.stableId, device.id, device.parentDeviceId).registerNativeCap(_camstack_types_addon.deviceOpsCapability, buildDeviceOpsProvider(device));
 			try {
 				await callDeviceManager(api, "registerDevice", {
 					addonId,
@@ -1650,7 +1613,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id: device.id
 					},
-					category: _camstack_types.EventCategory.DeviceReady,
+					category: _camstack_types_addon.EventCategory.DeviceReady,
 					data: { deviceId: device.id }
 				});
 			};
@@ -1789,7 +1752,7 @@ function createBrokerDeviceManagerApi(opts) {
 						type: "device",
 						id: deviceId
 					},
-					category: _camstack_types.EventCategory.DeviceBindingsChanged,
+					category: _camstack_types_addon.EventCategory.DeviceBindingsChanged,
 					data: {
 						deviceId,
 						capName,
@@ -1798,7 +1761,7 @@ function createBrokerDeviceManagerApi(opts) {
 						nodeId
 					}
 				});
-				(0, _camstack_types.emitReadiness)(eventBus, {
+				(0, _camstack_types_addon.emitReadiness)(eventBus, {
 					capName,
 					scope: {
 						type: "device",
@@ -5357,7 +5320,7 @@ function createAddonDataPlaneFacility(args) {
 	let server = null;
 	let baseUrl = "";
 	const route = (req, res) => {
-		if (req.headers[_camstack_types.DATAPLANE_SECRET_HEADER] !== secret) {
+		if (req.headers[_camstack_types_addon.DATAPLANE_SECRET_HEADER] !== secret) {
 			res.writeHead(403).end();
 			return;
 		}
@@ -5902,7 +5865,7 @@ function getOrInitReadinessRegistry(broker, eventBus, logger) {
 	const bkr = broker;
 	const existing = brokerReadinessRegistries.get(broker);
 	if (existing) return existing;
-	const registry = new _camstack_types.ReadinessRegistry({
+	const registry = new _camstack_types_addon.ReadinessRegistry({
 		eventBus,
 		sourceNodeId: bkr.nodeID,
 		logger
@@ -5969,7 +5932,7 @@ function getOrInitReadinessRegistry(broker, eventBus, logger) {
 function getOrInitReadinessRegistryForClient(client, eventBus, logger, nodeId) {
 	const existing = clientReadinessRegistries.get(nodeId);
 	if (existing) return existing;
-	const registry = new _camstack_types.ReadinessRegistry({
+	const registry = new _camstack_types_addon.ReadinessRegistry({
 		eventBus,
 		sourceNodeId: nodeId,
 		logger
@@ -6282,12 +6245,12 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	const api = (0, _trpc_client.createTRPCClient)({ links });
 	const scopedLogger = options?.createLogger?.(addonId) ?? (runtime.mode === "broker" ? createRemoteLogger(runtime.broker, addonId) : createUdsLogger(runtime.client, addonId, nodeId));
 	const scopedEventBus = runtime.mode === "broker" ? createBrokerEventBus(runtime.broker, addonId) : createUdsEventBus(runtime.client, addonId);
-	const workerDisposerChain = new _camstack_types.DisposerChain({ onError: (err, index) => {
+	const workerDisposerChain = new _camstack_types_addon.DisposerChain({ onError: (err, index) => {
 		scopedLogger.error(`Disposer #${index} threw during teardown`, { meta: { error: err instanceof Error ? err.message : String(err) } });
 	} });
 	registerWorkerDisposerChain(nodeId, addonId, workerDisposerChain);
 	const bindingCache = /* @__PURE__ */ new Map();
-	scopedEventBus.subscribe({ category: _camstack_types.EventCategory.DeviceBindingsChanged }, (e) => {
+	scopedEventBus.subscribe({ category: _camstack_types_addon.EventCategory.DeviceBindingsChanged }, (e) => {
 		const data = e.data ?? {};
 		if (typeof data.deviceId === "number") {
 			bindingCache.delete(data.deviceId);
@@ -6386,7 +6349,7 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 	const readinessRegistry = () => runtime.mode === "broker" ? getOrInitReadinessRegistry(runtime.broker, scopedEventBus, scopedLogger) : getOrInitReadinessRegistryForClient(runtime.client, scopedEventBus, scopedLogger, nodeId);
 	const capHandleCache = /* @__PURE__ */ new Map();
 	function getOrCreateHandle(capName, scope, timeoutMs) {
-		const key = `${capName}::${(0, _camstack_types.scopeKey)(scope)}`;
+		const key = `${capName}::${(0, _camstack_types_addon.scopeKey)(scope)}`;
 		const existing = capHandleCache.get(key);
 		if (existing) return existing;
 		const handle = new CapabilityHandle(capName, scope, readinessRegistry(), timeoutMs);
@@ -6482,10 +6445,10 @@ async function buildAddonContext(runtime, declaration, dataDir, options) {
 		},
 		fetchDevice: async (deviceId) => {
 			const cached = bindingCache.get(deviceId);
-			if (cached) return (0, _camstack_types.createDeviceProxy)(api, cached);
+			if (cached) return (0, _camstack_types_addon.createDeviceProxy)(api, cached);
 			const binding = await api.deviceManager.getBindings.query({ deviceId });
 			bindingCache.set(deviceId, binding);
-			return (0, _camstack_types.createDeviceProxy)(api, binding);
+			return (0, _camstack_types_addon.createDeviceProxy)(api, binding);
 		},
 		useCapability(capName, scope = { type: "global" }) {
 			return getOrCreateHandle(capName, scope, Number.POSITIVE_INFINITY);
@@ -6615,12 +6578,6 @@ Object.defineProperty(exports, "CapabilityUnavailableError", {
 		return CapabilityUnavailableError;
 	}
 });
-Object.defineProperty(exports, "CustomActionRegistry", {
-	enumerable: true,
-	get: function() {
-		return CustomActionRegistry;
-	}
-});
 Object.defineProperty(exports, "DeviceRegistry", {
 	enumerable: true,
 	get: function() {