@camstack/addon-provider-reolink 1.2.215 → 1.2.216

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.216] - 2026-10-31
+
+### Changed
+
+- The NVR / Home Hub can be added as a Gateway device (reboot, web interface link) next to its channel cameras.
+
 ## [1.2.215] - 2026-10-31
 
 ### Changed

package/dist/addon.js

@@ -203955,6 +203955,14 @@ var ReolinkHubSession = class {
 	get isOnline() {
 		return this.#online;
 	}
+	/** The integration's display name. */
+	get name() {
+		return this.#deps.name;
+	}
+	/** Restart the hub itself (not a camera behind it). */
+	async reboot() {
+		await (await this.getApi()).reboot();
+	}
 	/** The last channel list, for the adoption surface. */
 	channelSnapshot() {
 		return this.#snapshot;
@@ -204413,6 +204421,28 @@ function toDiscoveredChild(channel, adoptedDeviceId) {
 		adoptedDeviceId
 	};
 }
+var GATEWAY_SUFFIX = ":gateway";
+/** The `childNativeId` of the hub box itself, one per integration. */
+function hubGatewayNativeId(integrationId) {
+	return `${integrationId}${GATEWAY_SUFFIX}`;
+}
+/**
+* The hub (NVR / Home Hub) as an adoption candidate: a {@link DeviceType.Gateway} that is a
+* sibling of its channel cameras, never their parent. Only what the library really exposes:
+* `reboot` (Baichuan `Reboot`) and the unit's web page.
+*/
+function toDiscoveredGateway(input) {
+	return {
+		childNativeId: hubGatewayNativeId(input.integrationId),
+		name: input.name,
+		type: DeviceType.Gateway,
+		status: input.online ? "online" : "offline",
+		metadata: { manufacturer: "Reolink" },
+		alreadyAdopted: input.adoptedDeviceId !== null,
+		adoptedDeviceId: input.adoptedDeviceId,
+		capabilities: [rebootCapability.name, deviceAdminLinkCapability.name]
+	};
+}
 /**
 * The per-integration registry the cameras reach their session through (the shape of
 * `veluxGateways` / `enpalConnections`). It also holds the children, so a child that activates
@@ -217687,7 +217717,13 @@ function buildReolinkAdoptionProvider(deps) {
 		const session = getSession(integrationId);
 		if (session === null) return [];
 		const adopted = await listAdopted();
-		return session.channelSnapshot().channels.map((channel) => toDiscoveredChild(channel, findAdoptedForChannel(adopted, integrationId, channel)));
+		const gateways = await deps.listAdoptedGateways();
+		return [toDiscoveredGateway({
+			integrationId,
+			name: session.name,
+			online: session.isOnline,
+			adoptedDeviceId: gateways.find((g) => g.integrationId === integrationId)?.id ?? null
+		}), ...session.channelSnapshot().channels.map((channel) => toDiscoveredChild(channel, findAdoptedForChannel(adopted, integrationId, channel)))];
 	}
 	async function status(integrationId) {
 		const all = await candidates(integrationId);
@@ -217748,6 +217784,19 @@ function buildReolinkAdoptionProvider(deps) {
 			const adopted = [];
 			let failures = 0;
 			for (const childNativeId of childNativeIds) try {
+				if (childNativeId === hubGatewayNativeId(integrationId)) {
+					const known = (await deps.listAdoptedGateways()).find((g) => g.integrationId === integrationId);
+					const { deviceId } = known !== void 0 ? { deviceId: known.id } : await deps.adoptGateway({
+						integrationId,
+						name: perCandidate?.[childNativeId]?.name ?? session.name
+					});
+					adopted.push({
+						childNativeId,
+						parentDeviceId: deviceId,
+						accessoryDeviceIds: []
+					});
+					continue;
+				}
 				const channel = session.channelSnapshot().channels.find((c) => c.childNativeId === childNativeId);
 				if (channel === void 0) {
 					logger.warn("reolink adopt: the hub lists no such channel — skipping", { meta: {
@@ -217794,7 +217843,7 @@ function buildReolinkAdoptionProvider(deps) {
 		},
 		resync: async ({ camDeviceId }) => {
 			const cfg = await deps.findDeviceConfig(camDeviceId);
-			if (cfg === null || typeof cfg["integrationId"] !== "string") throw new Error(`reolink resync: device ${camDeviceId} is not an NVR-adopted camera`);
+			if (cfg === null || typeof cfg["integrationId"] !== "string") throw new Error(`reolink resync: device ${camDeviceId} is not an NVR-adopted device`);
 			return {
 				changed: false,
 				rebuiltChildren: 0
@@ -218032,6 +218081,86 @@ async function retireMigratedHubs(retirements, ports) {
 	return retired;
 }
 //#endregion
+//#region src/reolink-gateway-device.ts
+var reolinkGatewayDeviceSchema = object({
+	integrationId: string().min(1).describe("Integration (hub session) the device belongs to"),
+	/** The adoption candidate id (`<integration>:gateway`). */
+	nativeId: string().min(1)
+});
+/**
+* The physical NVR / Home Hub, as a {@link DeviceType.Gateway}. Its connection and password
+* live on the INTEGRATION; this device is the box's presence in the device list, and carries
+* the actions the library really supports through existing caps:
+*
+* - `reboot` (Baichuan `Reboot`, no channel), advertised as {@link DeviceFeature.Rebootable};
+* - `device-admin-link`, the unit's own web page.
+*
+* Cameras are NOT children of it: they are adopted as their own top-level devices of the
+* same integration. The addon flips `online` when the hub socket changes.
+*/
+var ReolinkGatewayDevice = class extends BaseDevice {
+	features = [DeviceFeature.Rebootable];
+	integrationId;
+	constructor(ctx) {
+		const cfg = reolinkGatewayDeviceSchema.parse(ctx.persistedConfig ?? {});
+		super(ctx, reolinkGatewayDeviceSchema, { type: DeviceType.Gateway });
+		this.integrationId = cfg.integrationId;
+		this.online = reolinkHubSessions.get(this.integrationId)?.isOnline === true;
+		this.registerRebootCap();
+		this.registerAdminLinkCap();
+		this.updateSourceInfo({
+			id: cfg.nativeId,
+			system: "reolink"
+		});
+	}
+	registerRebootCap() {
+		this.ctx.registerNativeCap(rebootCapability, { reboot: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`ReolinkGatewayDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			const session = reolinkHubSessions.get(this.integrationId);
+			if (session === null) {
+				this.ctx.logger.warn("Reolink hub reboot refused: no live session", { tags: { deviceId: this.id } });
+				throw new Error("The hub session is down, so it cannot be told to reboot.");
+			}
+			await session.reboot();
+			this.ctx.logger.info("Reolink hub reboot requested", { tags: { deviceId: this.id } });
+			return { success: true };
+		} });
+	}
+	/**
+	* The hub's web interface, on the hub host. The password is NOT placed in the URL; the page
+	* asks for it.
+	*/
+	registerAdminLinkCap() {
+		this.ctx.registerNativeCap(deviceAdminLinkCapability, { getAdminLink: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`ReolinkGatewayDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			const host = reolinkHubSessions.get(this.integrationId)?.relayEndpoint().host;
+			if (host === void 0) {
+				this.ctx.logger.debug("reolink admin link unavailable: integration not running", { tags: { deviceId: this.id } });
+				return null;
+			}
+			const built = buildDeviceAdminUrl({
+				host,
+				port: null,
+				scheme: "https",
+				path: "/"
+			});
+			if (!built.ok) {
+				this.ctx.logger.debug("reolink admin link unavailable", {
+					tags: { deviceId: this.id },
+					meta: { reason: built.reason }
+				});
+				return null;
+			}
+			return {
+				url: built.url,
+				label: "Reolink web interface",
+				target: "integration",
+				host
+			};
+		} });
+	}
+};
+//#endregion
 //#region src/addon.ts
 /**
 * Adapt a camstack scoped logger to the lib's `Logger` shape (just
@@ -218195,7 +218324,10 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 	secretStatePaths = ["emailPushAuthPassword"];
 	addonId = REOLINK_ADDON_ID;
 	providerName = "Reolink";
-	deviceClasses = { [DeviceType.Camera]: ReolinkCamera };
+	deviceClasses = {
+		[DeviceType.Camera]: ReolinkCamera,
+		[DeviceType.Gateway]: ReolinkGatewayDevice
+	};
 	/**
 	* Short-lived cache that bridges `testCreationField` and
 	* `onCreateDevice` — Slice 15 socket reuse. Both code paths key off
@@ -218410,6 +218542,15 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 		this.ctx.eventBus.subscribe({ category: EventCategory.IntegrationDisabled }, handler);
 		this.ctx.eventBus.subscribe({ category: EventCategory.IntegrationDeleted }, handler);
 	}
+	/** The hub box follows its integration's socket. */
+	markGatewaysOnline(integrationId, online) {
+		const reg = this.ctx.kernel.deviceRegistry;
+		if (!reg) return;
+		for (const d of reg.getAllForAddon(this.addonId)) {
+			if (!(d instanceof ReolinkGatewayDevice) || d.integrationId !== integrationId) continue;
+			if (d.online !== online) d.markOnline(online);
+		}
+	}
 	buildAdoptionProvider() {
 		return buildReolinkAdoptionProvider({
 			getSession: (integrationId) => this.hubManager?.get(integrationId) ?? null,
@@ -218455,6 +218596,29 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 					accessoryDeviceIds: children.map((c) => c.id)
 				};
 			},
+			listAdoptedGateways: async () => {
+				const reg = this.ctx.kernel.deviceRegistry;
+				if (!reg) return [];
+				const out = [];
+				for (const d of reg.getAllForAddon(this.addonId)) if (d instanceof ReolinkGatewayDevice) out.push({
+					id: d.id,
+					integrationId: d.integrationId
+				});
+				return out;
+			},
+			adoptGateway: async ({ integrationId, name }) => {
+				const devices = this.ctx.kernel.devices;
+				if (!devices) throw new Error("reolink adopt: kernel.devices unavailable");
+				const nativeId = hubGatewayNativeId(integrationId);
+				return { deviceId: (await devices.create(`${integrationId}-${nativeId}`, ReolinkGatewayDevice, {
+					integrationId,
+					nativeId
+				}, null, {
+					type: DeviceType.Gateway,
+					name,
+					integrationId
+				})).id };
+			},
 			removeDevice: async (id) => {
 				await this.ctx.kernel.devices?.remove(id);
 			},
@@ -218660,7 +218824,10 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 		this.listReolinkCameras();
 		this.hubManager = createReolinkHubManager({
 			logger: this.ctx.logger,
-			onConnectionChange: (integrationId, online) => this.ctx.logger.info(`Reolink NVR socket ${online ? "up" : "down"}`, { meta: { integrationId } })
+			onConnectionChange: (integrationId, online) => {
+				this.ctx.logger.info(`Reolink NVR socket ${online ? "up" : "down"}`, { meta: { integrationId } });
+				this.markGatewaysOnline(integrationId, online);
+			}
 		}, reolinkHubSessions);
 		await this.reconcileIntegrations();
 		this.subscribeIntegrationLifecycle();

package/dist/addon.mjs

@@ -203947,6 +203947,14 @@ var ReolinkHubSession = class {
 	get isOnline() {
 		return this.#online;
 	}
+	/** The integration's display name. */
+	get name() {
+		return this.#deps.name;
+	}
+	/** Restart the hub itself (not a camera behind it). */
+	async reboot() {
+		await (await this.getApi()).reboot();
+	}
 	/** The last channel list, for the adoption surface. */
 	channelSnapshot() {
 		return this.#snapshot;
@@ -204405,6 +204413,28 @@ function toDiscoveredChild(channel, adoptedDeviceId) {
 		adoptedDeviceId
 	};
 }
+var GATEWAY_SUFFIX = ":gateway";
+/** The `childNativeId` of the hub box itself, one per integration. */
+function hubGatewayNativeId(integrationId) {
+	return `${integrationId}${GATEWAY_SUFFIX}`;
+}
+/**
+* The hub (NVR / Home Hub) as an adoption candidate: a {@link DeviceType.Gateway} that is a
+* sibling of its channel cameras, never their parent. Only what the library really exposes:
+* `reboot` (Baichuan `Reboot`) and the unit's web page.
+*/
+function toDiscoveredGateway(input) {
+	return {
+		childNativeId: hubGatewayNativeId(input.integrationId),
+		name: input.name,
+		type: DeviceType.Gateway,
+		status: input.online ? "online" : "offline",
+		metadata: { manufacturer: "Reolink" },
+		alreadyAdopted: input.adoptedDeviceId !== null,
+		adoptedDeviceId: input.adoptedDeviceId,
+		capabilities: [rebootCapability.name, deviceAdminLinkCapability.name]
+	};
+}
 /**
 * The per-integration registry the cameras reach their session through (the shape of
 * `veluxGateways` / `enpalConnections`). It also holds the children, so a child that activates
@@ -217679,7 +217709,13 @@ function buildReolinkAdoptionProvider(deps) {
 		const session = getSession(integrationId);
 		if (session === null) return [];
 		const adopted = await listAdopted();
-		return session.channelSnapshot().channels.map((channel) => toDiscoveredChild(channel, findAdoptedForChannel(adopted, integrationId, channel)));
+		const gateways = await deps.listAdoptedGateways();
+		return [toDiscoveredGateway({
+			integrationId,
+			name: session.name,
+			online: session.isOnline,
+			adoptedDeviceId: gateways.find((g) => g.integrationId === integrationId)?.id ?? null
+		}), ...session.channelSnapshot().channels.map((channel) => toDiscoveredChild(channel, findAdoptedForChannel(adopted, integrationId, channel)))];
 	}
 	async function status(integrationId) {
 		const all = await candidates(integrationId);
@@ -217740,6 +217776,19 @@ function buildReolinkAdoptionProvider(deps) {
 			const adopted = [];
 			let failures = 0;
 			for (const childNativeId of childNativeIds) try {
+				if (childNativeId === hubGatewayNativeId(integrationId)) {
+					const known = (await deps.listAdoptedGateways()).find((g) => g.integrationId === integrationId);
+					const { deviceId } = known !== void 0 ? { deviceId: known.id } : await deps.adoptGateway({
+						integrationId,
+						name: perCandidate?.[childNativeId]?.name ?? session.name
+					});
+					adopted.push({
+						childNativeId,
+						parentDeviceId: deviceId,
+						accessoryDeviceIds: []
+					});
+					continue;
+				}
 				const channel = session.channelSnapshot().channels.find((c) => c.childNativeId === childNativeId);
 				if (channel === void 0) {
 					logger.warn("reolink adopt: the hub lists no such channel — skipping", { meta: {
@@ -217786,7 +217835,7 @@ function buildReolinkAdoptionProvider(deps) {
 		},
 		resync: async ({ camDeviceId }) => {
 			const cfg = await deps.findDeviceConfig(camDeviceId);
-			if (cfg === null || typeof cfg["integrationId"] !== "string") throw new Error(`reolink resync: device ${camDeviceId} is not an NVR-adopted camera`);
+			if (cfg === null || typeof cfg["integrationId"] !== "string") throw new Error(`reolink resync: device ${camDeviceId} is not an NVR-adopted device`);
 			return {
 				changed: false,
 				rebuiltChildren: 0
@@ -218024,6 +218073,86 @@ async function retireMigratedHubs(retirements, ports) {
 	return retired;
 }
 //#endregion
+//#region src/reolink-gateway-device.ts
+var reolinkGatewayDeviceSchema = object({
+	integrationId: string().min(1).describe("Integration (hub session) the device belongs to"),
+	/** The adoption candidate id (`<integration>:gateway`). */
+	nativeId: string().min(1)
+});
+/**
+* The physical NVR / Home Hub, as a {@link DeviceType.Gateway}. Its connection and password
+* live on the INTEGRATION; this device is the box's presence in the device list, and carries
+* the actions the library really supports through existing caps:
+*
+* - `reboot` (Baichuan `Reboot`, no channel), advertised as {@link DeviceFeature.Rebootable};
+* - `device-admin-link`, the unit's own web page.
+*
+* Cameras are NOT children of it: they are adopted as their own top-level devices of the
+* same integration. The addon flips `online` when the hub socket changes.
+*/
+var ReolinkGatewayDevice = class extends BaseDevice {
+	features = [DeviceFeature.Rebootable];
+	integrationId;
+	constructor(ctx) {
+		const cfg = reolinkGatewayDeviceSchema.parse(ctx.persistedConfig ?? {});
+		super(ctx, reolinkGatewayDeviceSchema, { type: DeviceType.Gateway });
+		this.integrationId = cfg.integrationId;
+		this.online = reolinkHubSessions.get(this.integrationId)?.isOnline === true;
+		this.registerRebootCap();
+		this.registerAdminLinkCap();
+		this.updateSourceInfo({
+			id: cfg.nativeId,
+			system: "reolink"
+		});
+	}
+	registerRebootCap() {
+		this.ctx.registerNativeCap(rebootCapability, { reboot: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`ReolinkGatewayDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			const session = reolinkHubSessions.get(this.integrationId);
+			if (session === null) {
+				this.ctx.logger.warn("Reolink hub reboot refused: no live session", { tags: { deviceId: this.id } });
+				throw new Error("The hub session is down, so it cannot be told to reboot.");
+			}
+			await session.reboot();
+			this.ctx.logger.info("Reolink hub reboot requested", { tags: { deviceId: this.id } });
+			return { success: true };
+		} });
+	}
+	/**
+	* The hub's web interface, on the hub host. The password is NOT placed in the URL; the page
+	* asks for it.
+	*/
+	registerAdminLinkCap() {
+		this.ctx.registerNativeCap(deviceAdminLinkCapability, { getAdminLink: async ({ deviceId }) => {
+			if (deviceId !== this.id) throw new Error(`ReolinkGatewayDevice: deviceId mismatch, expected ${this.id}, got ${deviceId}`);
+			const host = reolinkHubSessions.get(this.integrationId)?.relayEndpoint().host;
+			if (host === void 0) {
+				this.ctx.logger.debug("reolink admin link unavailable: integration not running", { tags: { deviceId: this.id } });
+				return null;
+			}
+			const built = buildDeviceAdminUrl({
+				host,
+				port: null,
+				scheme: "https",
+				path: "/"
+			});
+			if (!built.ok) {
+				this.ctx.logger.debug("reolink admin link unavailable", {
+					tags: { deviceId: this.id },
+					meta: { reason: built.reason }
+				});
+				return null;
+			}
+			return {
+				url: built.url,
+				label: "Reolink web interface",
+				target: "integration",
+				host
+			};
+		} });
+	}
+};
+//#endregion
 //#region src/addon.ts
 /**
 * Adapt a camstack scoped logger to the lib's `Logger` shape (just
@@ -218187,7 +218316,10 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 	secretStatePaths = ["emailPushAuthPassword"];
 	addonId = REOLINK_ADDON_ID;
 	providerName = "Reolink";
-	deviceClasses = { [DeviceType.Camera]: ReolinkCamera };
+	deviceClasses = {
+		[DeviceType.Camera]: ReolinkCamera,
+		[DeviceType.Gateway]: ReolinkGatewayDevice
+	};
 	/**
 	* Short-lived cache that bridges `testCreationField` and
 	* `onCreateDevice` — Slice 15 socket reuse. Both code paths key off
@@ -218402,6 +218534,15 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 		this.ctx.eventBus.subscribe({ category: EventCategory.IntegrationDisabled }, handler);
 		this.ctx.eventBus.subscribe({ category: EventCategory.IntegrationDeleted }, handler);
 	}
+	/** The hub box follows its integration's socket. */
+	markGatewaysOnline(integrationId, online) {
+		const reg = this.ctx.kernel.deviceRegistry;
+		if (!reg) return;
+		for (const d of reg.getAllForAddon(this.addonId)) {
+			if (!(d instanceof ReolinkGatewayDevice) || d.integrationId !== integrationId) continue;
+			if (d.online !== online) d.markOnline(online);
+		}
+	}
 	buildAdoptionProvider() {
 		return buildReolinkAdoptionProvider({
 			getSession: (integrationId) => this.hubManager?.get(integrationId) ?? null,
@@ -218447,6 +218588,29 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 					accessoryDeviceIds: children.map((c) => c.id)
 				};
 			},
+			listAdoptedGateways: async () => {
+				const reg = this.ctx.kernel.deviceRegistry;
+				if (!reg) return [];
+				const out = [];
+				for (const d of reg.getAllForAddon(this.addonId)) if (d instanceof ReolinkGatewayDevice) out.push({
+					id: d.id,
+					integrationId: d.integrationId
+				});
+				return out;
+			},
+			adoptGateway: async ({ integrationId, name }) => {
+				const devices = this.ctx.kernel.devices;
+				if (!devices) throw new Error("reolink adopt: kernel.devices unavailable");
+				const nativeId = hubGatewayNativeId(integrationId);
+				return { deviceId: (await devices.create(`${integrationId}-${nativeId}`, ReolinkGatewayDevice, {
+					integrationId,
+					nativeId
+				}, null, {
+					type: DeviceType.Gateway,
+					name,
+					integrationId
+				})).id };
+			},
 			removeDevice: async (id) => {
 				await this.ctx.kernel.devices?.remove(id);
 			},
@@ -218652,7 +218816,10 @@ var ReolinkProviderAddon = class extends BaseDeviceProvider {
 		this.listReolinkCameras();
 		this.hubManager = createReolinkHubManager({
 			logger: this.ctx.logger,
-			onConnectionChange: (integrationId, online) => this.ctx.logger.info(`Reolink NVR socket ${online ? "up" : "down"}`, { meta: { integrationId } })
+			onConnectionChange: (integrationId, online) => {
+				this.ctx.logger.info(`Reolink NVR socket ${online ? "up" : "down"}`, { meta: { integrationId } });
+				this.markGatewaysOnline(integrationId, online);
+			}
 		}, reolinkHubSessions);
 		await this.reconcileIntegrations();
 		this.subscribeIntegrationLifecycle();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-reolink",
-  "version": "1.2.215",
+  "version": "1.2.216",
   "description": "Reolink camera device provider addon for CamStack — native Baichuan protocol",
   "keywords": [
     "camstack",