@camstack/addon-pipeline 1.1.27 → 1.1.28

package/dist/{frame-ring-sink-BbzrqTWj.js → frame-ring-sink-9J0wCdLF.js}

@@ -1,30 +1,40 @@
+const require_dist = require("./dist-Biq62zt4.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
-//#region src/shared/decoder-backend.ts
-/** Settings section holding the backend selection. */
-var DECODER_BACKEND_SECTION = "decoder";
-/** Cluster-wide default when nothing is configured — the subprocess decoder. */
+//#region src/shared/decoder-backend-keys.ts
+/** Built-in default when a node has no selection — the subprocess decoder. */
 var DEFAULT_DECODER_BACKEND = "ffmpeg";
 /** Narrow an unknown settings value to a {@link DecoderBackend}, else `null`. */
 function parseDecoderBackend(value) {
 	return value === "ffmpeg" || value === "nodeav" ? value : null;
 }
-/** Type guard for a plain record (the `nodeBackends` map shape). */
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+* Normalise a raw kernel node id to the bare node id used for scoping.
+* `localNodeId` can carry a `<node>/<addon>` suffix; the decoder selection is
+* per-NODE, so strip the addon segment. Falls back to `hub`.
+*/
+function normalizeDecoderNodeId(rawNodeId) {
+	const raw = rawNodeId ?? "hub";
+	return raw.includes("/") ? raw.split("/")[0] ?? "hub" : raw;
+}
+//#endregion
+//#region src/shared/decoder-backend.ts
+/** The addon whose global settings OWN the per-node `backend` field. */
+var DECODER_OWNER_ADDON_ID = "decoder-ffmpeg";
+function isHydratedField(entry) {
+	return typeof entry === "object" && entry !== null && "key" in entry;
 }
 /**
-* Pure selection from an already-read `decoder` section — extracted so the
-* precedence (per-node override → cluster default → built-in default) is
-* unit-testable without a settings store.
+* Pure selection from an already-read hydrated settings payload: extract the
+* owner's `backend` field value (which the owner projected per-node from its
+* scoped store key) and narrow it. A missing/invalid field or a null payload
+* resolves to {@link DEFAULT_DECODER_BACKEND} — never a bare store key.
 */
-function pickDecoderBackend(section, nodeId) {
-	const overrides = section["nodeBackends"];
-	if (isRecord(overrides)) {
-		const perNode = parseDecoderBackend(overrides[nodeId]);
-		if (perNode !== null) return perNode;
+function pickDecoderBackendFromSettings(view) {
+	if (view === null) return DEFAULT_DECODER_BACKEND;
+	for (const section of view.sections) for (const entry of section.fields) {
+		if (!isHydratedField(entry) || entry.key !== "backend") continue;
+		return parseDecoderBackend(entry.value) ?? "ffmpeg";
 	}
-	const clusterWide = parseDecoderBackend(section["backend"]);
-	if (clusterWide !== null) return clusterWide;
 	return DEFAULT_DECODER_BACKEND;
 }
 /**
@@ -32,14 +42,28 @@ function pickDecoderBackend(section, nodeId) {
 * addons at the start of `onInitialize`; the addon whose backend is NOT
 * selected registers nothing.
 *
-* Fails safe: no settings access or a read error resolves to
-* {@link DEFAULT_DECODER_BACKEND} — the default backend still registers,
-* and the non-default one stands down (never both).
+* Fails safe: no api surface, a read error, or a null payload (owner not
+* answering yet) resolves to {@link DEFAULT_DECODER_BACKEND} — the default
+* backend still registers, and the non-default one stands down (never both).
 */
-async function resolveDecoderBackend(settings, nodeId, logger) {
-	if (!settings) return DEFAULT_DECODER_BACKEND;
+async function resolveDecoderBackend(api, nodeId, logger) {
+	if (!api) {
+		logger.warn("decoder-backend: no api surface — using default backend", { meta: { default: DEFAULT_DECODER_BACKEND } });
+		return DEFAULT_DECODER_BACKEND;
+	}
 	try {
-		return pickDecoderBackend(await settings.getSection(DECODER_BACKEND_SECTION), nodeId);
+		const view = await api.addonSettings.getGlobalSettings.query({
+			addonId: DECODER_OWNER_ADDON_ID,
+			nodeId: normalizeDecoderNodeId(nodeId)
+		});
+		if (view === null) {
+			logger.warn("decoder-backend: owner settings unavailable — using default backend", { meta: {
+				default: DEFAULT_DECODER_BACKEND,
+				owner: DECODER_OWNER_ADDON_ID
+			} });
+			return DEFAULT_DECODER_BACKEND;
+		}
+		return pickDecoderBackendFromSettings(view);
 	} catch (err) {
 		logger.warn("decoder-backend: settings read failed — using default backend", { meta: {
 			default: DEFAULT_DECODER_BACKEND,
@@ -49,6 +73,75 @@ async function resolveDecoderBackend(settings, nodeId, logger) {
 	}
 }
 //#endregion
+//#region src/shared/notifying-ring-buffer.ts
+/**
+* A {@link RingBuffer} that can notify a single blocked consumer the moment an
+* item commits — the server side of the `pullFrames`/`pullHandles` long-poll.
+*
+* The decoder's `onFrame`/`onFrameHandle` callback drives `push()`; a consumer
+* that finds the ring momentarily empty calls {@link waitForItem} and is woken
+* on the very next `push()` (a real commit signal) rather than spinning at
+* ~1kHz on `setTimeout(…,1)`. If nothing commits it resolves after `waitMs`,
+* and {@link cancel} (session teardown) resolves any in-flight wait promptly so
+* a blocked long-poll never waits out `waitMs` on destroy.
+*
+* Semantics are otherwise identical to `RingBuffer`: fixed capacity,
+* latest-wins overwrite when full, FIFO `drain`.
+*/
+var NotifyingRingBuffer = class {
+	ring;
+	waiters = /* @__PURE__ */ new Set();
+	constructor(capacity) {
+		this.ring = new require_dist.RingBuffer(capacity);
+	}
+	get size() {
+		return this.ring.size;
+	}
+	push(item) {
+		this.ring.push(item);
+		this.wakeAll();
+	}
+	drain(maxCount) {
+		return this.ring.drain(maxCount);
+	}
+	/**
+	* Resolve as soon as an item commits to the ring, or after `waitMs`,
+	* whichever comes first. Returns immediately when items are already present
+	* or `waitMs <= 0` (legacy immediate-return). {@link cancel} also resolves an
+	* in-flight wait.
+	*/
+	async waitForItem(waitMs) {
+		if (this.ring.size > 0 || waitMs <= 0) return;
+		await new Promise((resolve) => {
+			let settled = false;
+			const finish = () => {
+				if (settled) return;
+				settled = true;
+				this.waiters.delete(wake);
+				clearTimeout(timer);
+				resolve();
+			};
+			const wake = () => finish();
+			const timer = setTimeout(finish, waitMs);
+			if (typeof timer.unref === "function") timer.unref();
+			this.waiters.add(wake);
+		});
+	}
+	/**
+	* Cancel every in-flight {@link waitForItem} — called on session teardown so
+	* a blocked long-poll returns promptly instead of waiting out `waitMs`.
+	*/
+	cancel() {
+		this.wakeAll();
+	}
+	wakeAll() {
+		if (this.waiters.size === 0) return;
+		const pending = [...this.waiters];
+		this.waiters.clear();
+		for (const wake of pending) wake();
+	}
+};
+//#endregion
 //#region src/decoder-ffmpeg/frame-ring-sink.ts
 /**
 * `DecoderFrameRingSink` — the decoder's shared-memory write side (Phase 5 / D9).
@@ -313,12 +406,24 @@ var DecoderFrameRingSink = class {
 	}
 };
 //#endregion
+Object.defineProperty(exports, "DEFAULT_DECODER_BACKEND", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_DECODER_BACKEND;
+	}
+});
 Object.defineProperty(exports, "DecoderFrameRingSink", {
 	enumerable: true,
 	get: function() {
 		return DecoderFrameRingSink;
 	}
 });
+Object.defineProperty(exports, "NotifyingRingBuffer", {
+	enumerable: true,
+	get: function() {
+		return NotifyingRingBuffer;
+	}
+});
 Object.defineProperty(exports, "RING_BUDGET_MB", {
 	enumerable: true,
 	get: function() {

package/dist/{frame-ring-sink-B_NvPTJZ.mjs → frame-ring-sink-Cs9vby6v.mjs}

@@ -1,30 +1,40 @@
+import { p as RingBuffer } from "./dist-C6_wgXqF.mjs";
 import { FrameRingWriter, MIN_RING_SLOTS, computeSegmentSize, computeSlotByteLength, createSegment, deriveSlotCount } from "@camstack/shm-ring";
-//#region src/shared/decoder-backend.ts
-/** Settings section holding the backend selection. */
-var DECODER_BACKEND_SECTION = "decoder";
-/** Cluster-wide default when nothing is configured — the subprocess decoder. */
+//#region src/shared/decoder-backend-keys.ts
+/** Built-in default when a node has no selection — the subprocess decoder. */
 var DEFAULT_DECODER_BACKEND = "ffmpeg";
 /** Narrow an unknown settings value to a {@link DecoderBackend}, else `null`. */
 function parseDecoderBackend(value) {
 	return value === "ffmpeg" || value === "nodeav" ? value : null;
 }
-/** Type guard for a plain record (the `nodeBackends` map shape). */
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+* Normalise a raw kernel node id to the bare node id used for scoping.
+* `localNodeId` can carry a `<node>/<addon>` suffix; the decoder selection is
+* per-NODE, so strip the addon segment. Falls back to `hub`.
+*/
+function normalizeDecoderNodeId(rawNodeId) {
+	const raw = rawNodeId ?? "hub";
+	return raw.includes("/") ? raw.split("/")[0] ?? "hub" : raw;
+}
+//#endregion
+//#region src/shared/decoder-backend.ts
+/** The addon whose global settings OWN the per-node `backend` field. */
+var DECODER_OWNER_ADDON_ID = "decoder-ffmpeg";
+function isHydratedField(entry) {
+	return typeof entry === "object" && entry !== null && "key" in entry;
 }
 /**
-* Pure selection from an already-read `decoder` section — extracted so the
-* precedence (per-node override → cluster default → built-in default) is
-* unit-testable without a settings store.
+* Pure selection from an already-read hydrated settings payload: extract the
+* owner's `backend` field value (which the owner projected per-node from its
+* scoped store key) and narrow it. A missing/invalid field or a null payload
+* resolves to {@link DEFAULT_DECODER_BACKEND} — never a bare store key.
 */
-function pickDecoderBackend(section, nodeId) {
-	const overrides = section["nodeBackends"];
-	if (isRecord(overrides)) {
-		const perNode = parseDecoderBackend(overrides[nodeId]);
-		if (perNode !== null) return perNode;
+function pickDecoderBackendFromSettings(view) {
+	if (view === null) return DEFAULT_DECODER_BACKEND;
+	for (const section of view.sections) for (const entry of section.fields) {
+		if (!isHydratedField(entry) || entry.key !== "backend") continue;
+		return parseDecoderBackend(entry.value) ?? "ffmpeg";
 	}
-	const clusterWide = parseDecoderBackend(section["backend"]);
-	if (clusterWide !== null) return clusterWide;
 	return DEFAULT_DECODER_BACKEND;
 }
 /**
@@ -32,14 +42,28 @@ function pickDecoderBackend(section, nodeId) {
 * addons at the start of `onInitialize`; the addon whose backend is NOT
 * selected registers nothing.
 *
-* Fails safe: no settings access or a read error resolves to
-* {@link DEFAULT_DECODER_BACKEND} — the default backend still registers,
-* and the non-default one stands down (never both).
+* Fails safe: no api surface, a read error, or a null payload (owner not
+* answering yet) resolves to {@link DEFAULT_DECODER_BACKEND} — the default
+* backend still registers, and the non-default one stands down (never both).
 */
-async function resolveDecoderBackend(settings, nodeId, logger) {
-	if (!settings) return DEFAULT_DECODER_BACKEND;
+async function resolveDecoderBackend(api, nodeId, logger) {
+	if (!api) {
+		logger.warn("decoder-backend: no api surface — using default backend", { meta: { default: DEFAULT_DECODER_BACKEND } });
+		return DEFAULT_DECODER_BACKEND;
+	}
 	try {
-		return pickDecoderBackend(await settings.getSection(DECODER_BACKEND_SECTION), nodeId);
+		const view = await api.addonSettings.getGlobalSettings.query({
+			addonId: DECODER_OWNER_ADDON_ID,
+			nodeId: normalizeDecoderNodeId(nodeId)
+		});
+		if (view === null) {
+			logger.warn("decoder-backend: owner settings unavailable — using default backend", { meta: {
+				default: DEFAULT_DECODER_BACKEND,
+				owner: DECODER_OWNER_ADDON_ID
+			} });
+			return DEFAULT_DECODER_BACKEND;
+		}
+		return pickDecoderBackendFromSettings(view);
 	} catch (err) {
 		logger.warn("decoder-backend: settings read failed — using default backend", { meta: {
 			default: DEFAULT_DECODER_BACKEND,
@@ -49,6 +73,75 @@ async function resolveDecoderBackend(settings, nodeId, logger) {
 	}
 }
 //#endregion
+//#region src/shared/notifying-ring-buffer.ts
+/**
+* A {@link RingBuffer} that can notify a single blocked consumer the moment an
+* item commits — the server side of the `pullFrames`/`pullHandles` long-poll.
+*
+* The decoder's `onFrame`/`onFrameHandle` callback drives `push()`; a consumer
+* that finds the ring momentarily empty calls {@link waitForItem} and is woken
+* on the very next `push()` (a real commit signal) rather than spinning at
+* ~1kHz on `setTimeout(…,1)`. If nothing commits it resolves after `waitMs`,
+* and {@link cancel} (session teardown) resolves any in-flight wait promptly so
+* a blocked long-poll never waits out `waitMs` on destroy.
+*
+* Semantics are otherwise identical to `RingBuffer`: fixed capacity,
+* latest-wins overwrite when full, FIFO `drain`.
+*/
+var NotifyingRingBuffer = class {
+	ring;
+	waiters = /* @__PURE__ */ new Set();
+	constructor(capacity) {
+		this.ring = new RingBuffer(capacity);
+	}
+	get size() {
+		return this.ring.size;
+	}
+	push(item) {
+		this.ring.push(item);
+		this.wakeAll();
+	}
+	drain(maxCount) {
+		return this.ring.drain(maxCount);
+	}
+	/**
+	* Resolve as soon as an item commits to the ring, or after `waitMs`,
+	* whichever comes first. Returns immediately when items are already present
+	* or `waitMs <= 0` (legacy immediate-return). {@link cancel} also resolves an
+	* in-flight wait.
+	*/
+	async waitForItem(waitMs) {
+		if (this.ring.size > 0 || waitMs <= 0) return;
+		await new Promise((resolve) => {
+			let settled = false;
+			const finish = () => {
+				if (settled) return;
+				settled = true;
+				this.waiters.delete(wake);
+				clearTimeout(timer);
+				resolve();
+			};
+			const wake = () => finish();
+			const timer = setTimeout(finish, waitMs);
+			if (typeof timer.unref === "function") timer.unref();
+			this.waiters.add(wake);
+		});
+	}
+	/**
+	* Cancel every in-flight {@link waitForItem} — called on session teardown so
+	* a blocked long-poll returns promptly instead of waiting out `waitMs`.
+	*/
+	cancel() {
+		this.wakeAll();
+	}
+	wakeAll() {
+		if (this.waiters.size === 0) return;
+		const pending = [...this.waiters];
+		this.waiters.clear();
+		for (const wake of pending) wake();
+	}
+};
+//#endregion
 //#region src/decoder-ffmpeg/frame-ring-sink.ts
 /**
 * `DecoderFrameRingSink` — the decoder's shared-memory write side (Phase 5 / D9).
@@ -313,4 +406,4 @@ var DecoderFrameRingSink = class {
 	}
 };
 //#endregion
-export { resolveDecoderBackend as i, RING_BUDGET_MB as n, makeSegmentName as r, DecoderFrameRingSink as t };
+export { resolveDecoderBackend as a, NotifyingRingBuffer as i, RING_BUDGET_MB as n, DEFAULT_DECODER_BACKEND as o, makeSegmentName as r, DecoderFrameRingSink as t };

package/dist/motion-wasm/index.js

@@ -2,7 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-DAIlCdAx.js");
+const require_dist = require("../dist-Biq62zt4.js");
+let _camstack_shm_ring = require("@camstack/shm-ring");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region src/motion-wasm/wasm-motion-detector.ts
@@ -135,6 +136,13 @@ var DEFAULT_CONFIG = {
 };
 var MotionWasmAddon = class MotionWasmAddon extends require_dist.BaseAddon {
 	detector = null;
+	/**
+	* CB5 shm passthrough — process-local, long-lived reader cache for
+	* `analyze({ frameHandle })`. Opens each named shm segment once and reuses
+	* the mapping; lazily created on first LOCAL handle, unmapped in
+	* {@link onShutdown}. Never opened/closed per-call.
+	*/
+	frameHandleReaders = null;
 	cameras = /* @__PURE__ */ new Map();
 	deviceConfigCache = /* @__PURE__ */ new Map();
 	static DEVICE_CONFIG_TTL_MS = 6e4;
@@ -187,9 +195,51 @@ var MotionWasmAddon = class MotionWasmAddon extends require_dist.BaseAddon {
 	* motion-detection cap: analyze a frame, return regions + stats.
 	* Per-device state keyed by the numeric deviceId (stringified internally
 	* so the pipeline-step sentinel shares the same Map).
+	*
+	* CB5: pixels arrive either inline (`frame`) or as a zero-pixel shm
+	* `FrameHandle`. A LOCAL handle is read back zero-copy here; a foreign /
+	* recycled / unmappable handle yields a null read and an empty result (the
+	* runner ships `frame` as the fallback, queue-depth gated).
 	*/
-	async analyze({ deviceId, frame }) {
-		return this.analyzeInternal(String(deviceId), frame);
+	async analyze({ deviceId, frame, frameHandle }) {
+		const resolved = frame ?? (frameHandle ? this.resolveFrameHandle(frameHandle) : null);
+		if (!resolved) return this.emptyMotionResult(frameHandle);
+		return this.analyzeInternal(String(deviceId), resolved);
+	}
+	/** This node's cluster id (suffix-stripped), for local-vs-foreign gating. */
+	ownNodeId() {
+		const raw = this.ctx.kernel?.localNodeId ?? "hub";
+		return raw.includes("/") ? raw.split("/")[0] : raw;
+	}
+	/**
+	* CB5 — resolve a shm `FrameHandle` to gray pixels zero-copy. Returns null
+	* for a FOREIGN handle (segment on another node — the runner only sends
+	* local handles), a recycled ring slot, or an unmappable segment.
+	*/
+	resolveFrameHandle(handle) {
+		if (handle.nodeId !== this.ownNodeId()) return null;
+		if (!this.frameHandleReaders) this.frameHandleReaders = new _camstack_shm_ring.FrameRingReaderCache(this.ctx.logger);
+		const decoded = this.frameHandleReaders.read(handle);
+		if (!decoded) return null;
+		return {
+			data: decoded.data,
+			width: decoded.width,
+			height: decoded.height,
+			format: decoded.format,
+			timestamp: decoded.timestamp
+		};
+	}
+	/** Zeroed motion result for a missed `frameHandle` read (dropped frame). */
+	emptyMotionResult(handle) {
+		return {
+			detected: false,
+			regionCount: 0,
+			regions: [],
+			rawRegions: [],
+			frameWidth: handle?.width ?? 0,
+			frameHeight: handle?.height ?? 0,
+			analysisMs: 0
+		};
 	}
 	async analyzeInternal(cameraId, frame) {
 		if (!this.detector) return {
@@ -351,6 +401,8 @@ var MotionWasmAddon = class MotionWasmAddon extends require_dist.BaseAddon {
 		this.deviceConfigCache.clear();
 		for (const id of this.proxies.keys()) this.releaseProxy(id);
 		this.detector = null;
+		this.frameHandleReaders?.close();
+		this.frameHandleReaders = null;
 	}
 	deviceSettingsSchema() {
 		return this.schema({ sections: [{

package/dist/motion-wasm/index.mjs

@@ -1,4 +1,5 @@
-import { A as motionDetectionCapability, T as evaluateZoneRules, V as BaseAddon, W as DeviceType, Y as hydrateSchema } from "../dist-CgEP_0OL.mjs";
+import { A as motionDetectionCapability, T as evaluateZoneRules, V as BaseAddon, W as DeviceType, q as hydrateSchema } from "../dist-C6_wgXqF.mjs";
+import { FrameRingReaderCache } from "@camstack/shm-ring";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/motion-wasm/wasm-motion-detector.ts
@@ -131,6 +132,13 @@ var DEFAULT_CONFIG = {
 };
 var MotionWasmAddon = class MotionWasmAddon extends BaseAddon {
 	detector = null;
+	/**
+	* CB5 shm passthrough — process-local, long-lived reader cache for
+	* `analyze({ frameHandle })`. Opens each named shm segment once and reuses
+	* the mapping; lazily created on first LOCAL handle, unmapped in
+	* {@link onShutdown}. Never opened/closed per-call.
+	*/
+	frameHandleReaders = null;
 	cameras = /* @__PURE__ */ new Map();
 	deviceConfigCache = /* @__PURE__ */ new Map();
 	static DEVICE_CONFIG_TTL_MS = 6e4;
@@ -183,9 +191,51 @@ var MotionWasmAddon = class MotionWasmAddon extends BaseAddon {
 	* motion-detection cap: analyze a frame, return regions + stats.
 	* Per-device state keyed by the numeric deviceId (stringified internally
 	* so the pipeline-step sentinel shares the same Map).
+	*
+	* CB5: pixels arrive either inline (`frame`) or as a zero-pixel shm
+	* `FrameHandle`. A LOCAL handle is read back zero-copy here; a foreign /
+	* recycled / unmappable handle yields a null read and an empty result (the
+	* runner ships `frame` as the fallback, queue-depth gated).
 	*/
-	async analyze({ deviceId, frame }) {
-		return this.analyzeInternal(String(deviceId), frame);
+	async analyze({ deviceId, frame, frameHandle }) {
+		const resolved = frame ?? (frameHandle ? this.resolveFrameHandle(frameHandle) : null);
+		if (!resolved) return this.emptyMotionResult(frameHandle);
+		return this.analyzeInternal(String(deviceId), resolved);
+	}
+	/** This node's cluster id (suffix-stripped), for local-vs-foreign gating. */
+	ownNodeId() {
+		const raw = this.ctx.kernel?.localNodeId ?? "hub";
+		return raw.includes("/") ? raw.split("/")[0] : raw;
+	}
+	/**
+	* CB5 — resolve a shm `FrameHandle` to gray pixels zero-copy. Returns null
+	* for a FOREIGN handle (segment on another node — the runner only sends
+	* local handles), a recycled ring slot, or an unmappable segment.
+	*/
+	resolveFrameHandle(handle) {
+		if (handle.nodeId !== this.ownNodeId()) return null;
+		if (!this.frameHandleReaders) this.frameHandleReaders = new FrameRingReaderCache(this.ctx.logger);
+		const decoded = this.frameHandleReaders.read(handle);
+		if (!decoded) return null;
+		return {
+			data: decoded.data,
+			width: decoded.width,
+			height: decoded.height,
+			format: decoded.format,
+			timestamp: decoded.timestamp
+		};
+	}
+	/** Zeroed motion result for a missed `frameHandle` read (dropped frame). */
+	emptyMotionResult(handle) {
+		return {
+			detected: false,
+			regionCount: 0,
+			regions: [],
+			rawRegions: [],
+			frameWidth: handle?.width ?? 0,
+			frameHeight: handle?.height ?? 0,
+			analysisMs: 0
+		};
 	}
 	async analyzeInternal(cameraId, frame) {
 		if (!this.detector) return {
@@ -347,6 +397,8 @@ var MotionWasmAddon = class MotionWasmAddon extends BaseAddon {
 		this.deviceConfigCache.clear();
 		for (const id of this.proxies.keys()) this.releaseProxy(id);
 		this.detector = null;
+		this.frameHandleReaders?.close();
+		this.frameHandleReaders = null;
 	}
 	deviceSettingsSchema() {
 		return this.schema({ sections: [{

package/dist/node-topology-platform-BkR_k6WT.mjs

@@ -0,0 +1,15 @@
+//#region src/shared/node-topology-platform.ts
+/**
+* Pick a node's `{ platform, arch }` from the cluster topology. Returns an empty
+* object when the topology is missing or the node is absent (caller falls back).
+*/
+function pickNodePlatformArch(topology, nodeId) {
+	const entry = topology?.find((n) => n.id === nodeId);
+	if (!entry) return {};
+	return {
+		platform: entry.platform,
+		arch: entry.arch
+	};
+}
+//#endregion
+export { pickNodePlatformArch as t };

package/dist/node-topology-platform-CFZ7F4xW.js

@@ -0,0 +1,20 @@
+//#region src/shared/node-topology-platform.ts
+/**
+* Pick a node's `{ platform, arch }` from the cluster topology. Returns an empty
+* object when the topology is missing or the node is absent (caller falls back).
+*/
+function pickNodePlatformArch(topology, nodeId) {
+	const entry = topology?.find((n) => n.id === nodeId);
+	if (!entry) return {};
+	return {
+		platform: entry.platform,
+		arch: entry.arch
+	};
+}
+//#endregion
+Object.defineProperty(exports, "pickNodePlatformArch", {
+	enumerable: true,
+	get: function() {
+		return pickNodePlatformArch;
+	}
+});