@camstack/addon-terminal 0.1.69 → 0.1.71

package/dist/addon.js

@@ -7644,7 +7644,8 @@ var CameraSwitchAuthoritySchema = discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = _enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -13061,7 +13062,12 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
-var LinkedDevicesModeSchema = _enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = _enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = object({
 	deviceId: number(),
@@ -23737,12 +23743,20 @@ var BatteryStatusSchema = object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: _enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -23832,7 +23846,7 @@ onStatusChanged: { data: object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -47511,6 +47525,29 @@ var TerminalInstanceReconcileCoordinator = class {
 		return this.running;
 	}
 };
+/**
+* Instances bound to a node the cluster no longer lists at all.
+*
+* An OFFLINE node is still in the topology; a FORGOTTEN one
+* (`clusterNodes.forgetNode`) is not. An instance bound to a forgotten node
+* warned every minute ("terminal profiles unavailable … node hub-test is
+* offline", 2026-09-05) and could never come back, so it is removed — but
+* only when two consecutive reads agree (D49): a topology answer that lost a
+* node once must not destroy an operator's configuration on its own.
+*/
+function instancesOnForgottenNodes(instances, knownNodeIds, absentBefore) {
+	const absentNow = /* @__PURE__ */ new Set();
+	const remove = [];
+	for (const instance of instances) {
+		if (knownNodeIds.has(instance.nodeId)) continue;
+		absentNow.add(instance.id);
+		if (absentBefore.has(instance.id)) remove.push(instance);
+	}
+	return {
+		remove,
+		absentNow
+	};
+}
 //#endregion
 //#region src/profiles.ts
 /**
@@ -48039,6 +48076,8 @@ var TerminalAddon = class extends BaseAddon {
 	/** Prevent repeat writes when a legacy device stays live after migration. */
 	migratedTerminalCameraConfigIds = /* @__PURE__ */ new Set();
 	terminalCameraTombstones = /* @__PURE__ */ new Set();
+	/** Instance ids whose node was absent from the last topology read (D49 streak). */
+	instancesOnAbsentNodes = /* @__PURE__ */ new Set();
 	instanceMutationQueue = new TerminalInstanceMutationQueue();
 	terminalReconcileCoordinator = new TerminalInstanceReconcileCoordinator(this.instanceMutationQueue);
 	glancesPythonPath = "";
@@ -48219,6 +48258,16 @@ var TerminalAddon = class extends BaseAddon {
 		const nodes = topology.filter((node) => typeof node.id === "string" && node.id.length > 0);
 		const nodeIds = new Set(nodes.map((node) => node.id));
 		for (const cachedNodeId of this.cameraProfilesByNode.keys()) if (!nodeIds.has(cachedNodeId)) this.cameraProfilesByNode.delete(cachedNodeId);
+		const forgotten = instancesOnForgottenNodes(this.terminalInstances(), nodeIds, this.instancesOnAbsentNodes);
+		this.instancesOnAbsentNodes = forgotten.absentNow;
+		for (const instance of forgotten.remove) {
+			this.ctx.logger.info("terminal instance removed — its node is no longer in the cluster", { meta: {
+				instanceId: instance.id,
+				nodeId: instance.nodeId,
+				name: instance.name
+			} });
+			await this.instanceMutationQueue.run(() => this.deleteTerminalInstanceUnlocked(instance.id));
+		}
 		const unavailableNodeIds = /* @__PURE__ */ new Set();
 		await Promise.all(nodes.map(async (node) => {
 			try {

package/dist/addon.mjs

@@ -7621,7 +7621,8 @@ var CameraSwitchAuthoritySchema = discriminatedUnion("kind", [
 var CameraSwitchUnavailableReasonSchema = _enum([
 	"no-provider",
 	"source-unreachable",
-	"not-configured"
+	"not-configured",
+	"device-disabled"
 ]);
 /**
 * One switch, resolved for one camera.
@@ -13038,7 +13039,12 @@ var ConfigEntrySchema = object({
 	value: unknown(),
 	description: string().optional()
 });
-var LinkedDevicesModeSchema = _enum(["auto", "manual"]);
+/**
+* Only `manual` since D356: the operator picks, nothing links itself. The
+* field survives on the wire because a viewer already OTA'd parses it —
+* drop it once no shipped client reads `mode`.
+*/
+var LinkedDevicesModeSchema = _enum(["manual"]);
 /** One resolved linked device — the compact projection consumers need. */
 var LinkedDeviceSchema = object({
 	deviceId: number(),
@@ -23714,12 +23720,20 @@ var BatteryStatusSchema = object({
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
 	* common on other battery cams). `'none'` means running on battery
-	* alone.
+	* alone — a NEGATIVE the firmware actually reported.
+	*
+	* `'unknown'` is the absence of an answer: the provider has not read the
+	* power fields yet, or the firmware reported neither. Before it existed,
+	* two unreadable fields produced `'none'`, and a camera nobody had reached
+	* was drawn "on battery alone" — the same D315 defect `percentage` closed
+	* by going nullable. Consumers SKIP it (no charger state published, no
+	* glyph, no HomeKit ChargingState) rather than coerce it either way.
 	*/
 	charging: _enum([
 		"dc",
 		"solar",
-		"none"
+		"none",
+		"unknown"
 	]),
 	/**
 	* True when the camera firmware has gone into low-power mode. Battery
@@ -23809,7 +23823,7 @@ onStatusChanged: { data: object({
 		kind: "push",
 		empty: {
 			percentage: 0,
-			charging: "none",
+			charging: "unknown",
 			sleeping: false,
 			lastUpdated: 0
 		}
@@ -47488,6 +47502,29 @@ var TerminalInstanceReconcileCoordinator = class {
 		return this.running;
 	}
 };
+/**
+* Instances bound to a node the cluster no longer lists at all.
+*
+* An OFFLINE node is still in the topology; a FORGOTTEN one
+* (`clusterNodes.forgetNode`) is not. An instance bound to a forgotten node
+* warned every minute ("terminal profiles unavailable … node hub-test is
+* offline", 2026-09-05) and could never come back, so it is removed — but
+* only when two consecutive reads agree (D49): a topology answer that lost a
+* node once must not destroy an operator's configuration on its own.
+*/
+function instancesOnForgottenNodes(instances, knownNodeIds, absentBefore) {
+	const absentNow = /* @__PURE__ */ new Set();
+	const remove = [];
+	for (const instance of instances) {
+		if (knownNodeIds.has(instance.nodeId)) continue;
+		absentNow.add(instance.id);
+		if (absentBefore.has(instance.id)) remove.push(instance);
+	}
+	return {
+		remove,
+		absentNow
+	};
+}
 //#endregion
 //#region src/profiles.ts
 /**
@@ -48016,6 +48053,8 @@ var TerminalAddon = class extends BaseAddon {
 	/** Prevent repeat writes when a legacy device stays live after migration. */
 	migratedTerminalCameraConfigIds = /* @__PURE__ */ new Set();
 	terminalCameraTombstones = /* @__PURE__ */ new Set();
+	/** Instance ids whose node was absent from the last topology read (D49 streak). */
+	instancesOnAbsentNodes = /* @__PURE__ */ new Set();
 	instanceMutationQueue = new TerminalInstanceMutationQueue();
 	terminalReconcileCoordinator = new TerminalInstanceReconcileCoordinator(this.instanceMutationQueue);
 	glancesPythonPath = "";
@@ -48196,6 +48235,16 @@ var TerminalAddon = class extends BaseAddon {
 		const nodes = topology.filter((node) => typeof node.id === "string" && node.id.length > 0);
 		const nodeIds = new Set(nodes.map((node) => node.id));
 		for (const cachedNodeId of this.cameraProfilesByNode.keys()) if (!nodeIds.has(cachedNodeId)) this.cameraProfilesByNode.delete(cachedNodeId);
+		const forgotten = instancesOnForgottenNodes(this.terminalInstances(), nodeIds, this.instancesOnAbsentNodes);
+		this.instancesOnAbsentNodes = forgotten.absentNow;
+		for (const instance of forgotten.remove) {
+			this.ctx.logger.info("terminal instance removed — its node is no longer in the cluster", { meta: {
+				instanceId: instance.id,
+				nodeId: instance.nodeId,
+				name: instance.name
+			} });
+			await this.instanceMutationQueue.run(() => this.deleteTerminalInstanceUnlocked(instance.id));
+		}
 		const unavailableNodeIds = /* @__PURE__ */ new Set();
 		await Promise.all(nodes.map(async (node) => {
 			try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-terminal",
-  "version": "0.1.69",
+  "version": "0.1.71",
   "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
   "keywords": [
     "camstack",