@camstack/addon-provider-reolink 1.2.40 → 1.2.42

package/dist/addon.js

@@ -26,7 +26,7 @@ let fs_promises = require("fs/promises");
 fs_promises = require_chunk.__toESM(fs_promises, 1);
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
-//#region ../types/dist/event-category-Bxo5yJjt.mjs
+//#region ../types/dist/event-category-C0lyLd5U.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -43,9 +43,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemRestartCompleted"] = "system.restart-completed";
 	/**
 	* A newer addon or server-root package version was found by the
-	* authoritative registry check. Emitted once per
-	* `(target, packageName, currentVersion, latestVersion)` transition; repeated
-	* polling of the same result is deduplicated by the checker.
+	* authoritative registry check. Emitted once when any observed
+	* `latestVersion` changes (or a package/node first appears behind);
+	* the payload carries the full currently-available list. Repeated
+	* polling of the same latests is silent.
 	*/
 	EventCategory["UpdateAvailable"] = "update.available";
 	/**
@@ -7587,6 +7588,10 @@ var RecordingBandSchema = object({
 	preBufferSec: number().min(0).optional(),
 	postBufferSec: number().min(0).optional()
 });
+({
+	preBufferSec: 10,
+	postBufferSec: 30
+}).postBufferSec * 1e3;
 /**
 * Per-device retention overrides. Every field is optional; an unset or `0`
 * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -14773,6 +14778,9 @@ var NcSystemEventKindSchema = _enum([
 	"alarm-disarmed",
 	"alarm-arming",
 	"alarm-arm-refused",
+	"addon-updated",
+	"server-updated",
+	"export-completed",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -16666,13 +16674,19 @@ var RetrainStatusSchema = _enum([
 * "never marked" from "already trained" must read `retrainStatus`.
 *
 * `debug` does NOT pin; it is attention, not durability.
+*
+* `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
+* A favourited track is skipped by retention the same way `staging` is, but
+* it does not enter `none|staging|trained` and has no staging budget.
 */
 var TrackFlagFields = {
 	/** Operator marked this track as training material — i.e. `retrainStatus` is
 	*  `'staging'`. */
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
-	debug: boolean().optional()
+	debug: boolean().optional(),
+	/** Operator favourited this track. Pins it against pruning. */
+	favourited: boolean().optional()
 };
 /**
 * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -16697,6 +16711,7 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
 	*  which always knows it — and a surface that has just written needs to render
@@ -20493,8 +20508,28 @@ var ClipSchema = object({
 		startMs: number(),
 		endMs: number()
 	}),
-	/** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
-	thumbnail: string().optional()
+	/**
+	* Lazy thumbnail URL, never inlined.
+	*
+	* Recording-derived clips (events-mode keep-window, and the prepared
+	* continuous event+fragment visit) MUST use the snapshot of the **main
+	* event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
+	* of the event that owns `kind` (object > motion > audio). Do not extract
+	* a keyframe from the recorded segments. Other providers (onboard, HKSV)
+	* mint their own stills.
+	*/
+	thumbnail: string().optional(),
+	/** Analytics event ids that overlap this visit. Empty on footage-only clips.
+	*  The default provider's visit grain puts many motion heartbeats on one clip
+	*  instead of minting one clip per marker. */
+	eventIds: array(string()).optional(),
+	/** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
+	*  than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
+	*  bar keeps showing them via `recording.getAvailability`. */
+	holes: array(object({
+		startMs: number(),
+		endMs: number()
+	})).optional()
 });
 var ClipPlaybackSchema = object({
 	/** HLS master URL through the hub data-plane (Range + token in path). */
@@ -26867,7 +26902,9 @@ var ExportOptionsSchema = object({
 	includeAudio: boolean(),
 	maxLifeMs: number().int().positive(),
 	deleteAfterDownload: boolean(),
-	title: string().max(200).optional()
+	title: string().max(200).optional(),
+	/** Notification-output target ids to ping when this export becomes ready. */
+	notifyTargetIds: array(string().min(1)).max(20).optional()
 }).superRefine((v, ctx) => {
 	if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
 		code: ZodIssueCode$16.custom,
@@ -26926,10 +26963,18 @@ var ExportBytesSchema = object({
 });
 method(object({
 	deviceId: number(),
-	profile: string(),
+	/** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
+	profile: string().optional(),
+	profiles: array(string()).min(1).optional(),
 	fromMs: number(),
 	toMs: number(),
 	options: ExportOptionsSchema
+}).superRefine((v, ctx) => {
+	if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
+		code: ZodIssueCode$16.custom,
+		message: "pass profiles[] (min 1) or legacy profile",
+		path: ["profiles"]
+	});
 }), ExportRecordSchema, {
 	kind: "mutation",
 	auth: "protected"
@@ -30084,15 +30129,6 @@ var BaseDeviceProvider = class extends BaseAddon {
 			labels: ["probe not implemented"]
 		};
 	}
-	/**
-	* Top-level devices restored at once in {@link onRestoreDevices}.
-	*
-	* Four covers the fleets this ships to without turning a boot into a burst a
-	* camera NVR answers with a refusal. A provider whose upstream is a single
-	* session with a serial command channel (a Baichuan hub, an NVR that
-	* serialises ISAPI) should lower it; nothing needs to raise it.
-	*/
-	restoreConcurrency = 4;
 	async restoreDevices(savedDevices) {
 		await this.onRestoreDevices(savedDevices);
 		if (savedDevices.length > 0) this.ctx.logger.info(`Restored ${savedDevices.length} ${this.providerName} device(s)`);
@@ -30147,14 +30183,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 				});
 			}
 		};
-		let nextTopLevel = 0;
-		await Promise.all(Array.from({ length: Math.min(Math.max(1, this.restoreConcurrency), topLevel.length) }, async () => {
-			for (;;) {
-				const saved = topLevel[nextTopLevel++];
-				if (saved === void 0) return;
-				await restoreOne(saved);
-			}
-		}));
+		await Promise.all(topLevel.map((saved) => restoreOne(saved)));
 		const childRows = savedDevices.filter((s) => s.parentDeviceId !== null);
 		for (const saved of childRows) {
 			const Class = this.deviceClasses[saved.type];
@@ -236782,6 +236811,26 @@ function computeHealthCheckBackoffMs(consecutive) {
 	return 15 * 6e4;
 }
 //#endregion
+//#region src/simple-event-dispatch-trace.ts
+/**
+* Gate for hub-side simpleEvent traces.
+*
+* Hub-child events arrive on the parent's Baichuan socket. Logging them on
+* the child logger only is invisible when the operator filters Logs to the
+* Hub; logging every channel unconditionally floods the Hub (battery ticks).
+* Trace when the target camera — or the hub itself — is under debug.
+*/
+function shouldTraceSimpleEventDispatch(input) {
+	return wantsEventTrace(input.hubDebugGeneral, input.hubSocketFlags) || wantsEventTrace(input.childDebugGeneral, input.childSocketFlags);
+}
+function wantsEventTrace(debugGeneral, socketFlags) {
+	return debugGeneral || socketFlags.includes("traceEvents");
+}
+/** Narrow a persisted `debugSocketLogs` blob to string flags. */
+function asDebugSocketFlags(value) {
+	return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+//#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
 /**
@@ -237324,8 +237373,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 				const cgi = info.entries[0];
 				child.applyHubBatteryInfo({
 					batteryPercent: info.batteryLevel,
-					...typeof cgi?.["chargeStatus"] === "string" ? { chargeStatus: cgi["chargeStatus"] } : {},
-					...typeof cgi?.["adapterStatus"] === "string" ? { adapterStatus: cgi["adapterStatus"] } : {}
+					...mapHubChargeStatus(cgi?.["chargeStatus"]) !== void 0 ? { chargeStatus: mapHubChargeStatus(cgi?.["chargeStatus"]) } : {},
+					...mapHubAdapterStatus(cgi?.["adapterStatus"]) !== void 0 ? { adapterStatus: mapHubAdapterStatus(cgi?.["adapterStatus"]) } : {}
 				});
 			}
 		} catch (err) {
@@ -237550,6 +237599,18 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 		}
 		this.ctx.devices.getAll().then((all) => all.find((d) => d.id === deviceId)).then((child) => {
 			if (!(child instanceof ReolinkCamera)) return;
+			if (shouldTraceSimpleEventDispatch({
+				hubDebugGeneral: this.config.get("debugGeneral") === true,
+				hubSocketFlags: asDebugSocketFlags(this.config.get("debugSocketLogs")),
+				childDebugGeneral: child.config.get("debugGeneral") === true,
+				childSocketFlags: asDebugSocketFlags(child.config.get("debugSocketLogs"))
+			})) this.ctx.logger.info("Reolink Hub: simpleEvent dispatch", { meta: {
+				type: ev?.type ?? "unknown",
+				channel,
+				timestamp: ev?.timestamp,
+				deviceId: child.id,
+				name: child.name
+			} });
 			child.handleSimpleEvent(ev);
 		}).catch((err) => {
 			this.ctx.logger.debug("Hub simpleEvent dispatch failed", { meta: {
@@ -237687,6 +237748,27 @@ function discoveredStatusFor(d) {
 	if (typeof d.state === "string" && d.state.length > 0) return "online";
 	return "unknown";
 }
+/**
+* The hub CGI reports charge state as NUMERIC codes (measured live on the
+* Home Hub, 2026-08-16: a full, plugged Argus 3E reads chargeStatus 2 /
+* adapterStatus 1) while `mapBatteryInfo` speaks the standalone Baichuan
+* string vocabulary ('charging' / 'chargeComplete' / 'solarPanel'). Translate
+* at the hub boundary so the shared mapper stays untouched.
+*   chargeStatus: 0 none · 1 charging · 2 charge complete
+*   adapterStatus: 0 none · 1 DC adapter · 2 solar panel
+*/
+function mapHubChargeStatus(value) {
+	if (typeof value === "string") return value;
+	if (value === 0) return "none";
+	if (value === 1) return "charging";
+	if (value === 2) return "chargeComplete";
+}
+function mapHubAdapterStatus(value) {
+	if (typeof value === "string") return value;
+	if (value === 0) return "none";
+	if (value === 1) return "dc";
+	if (value === 2) return "solarPanel";
+}
 //#endregion
 //#region src/creation-schema.ts
 /**

package/dist/addon.mjs

@@ -21,7 +21,7 @@ import netImpl from "net";
 import { fileURLToPath } from "url";
 import { mkdir } from "fs/promises";
 import os from "node:os";
-//#region ../types/dist/event-category-Bxo5yJjt.mjs
+//#region ../types/dist/event-category-C0lyLd5U.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -38,9 +38,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemRestartCompleted"] = "system.restart-completed";
 	/**
 	* A newer addon or server-root package version was found by the
-	* authoritative registry check. Emitted once per
-	* `(target, packageName, currentVersion, latestVersion)` transition; repeated
-	* polling of the same result is deduplicated by the checker.
+	* authoritative registry check. Emitted once when any observed
+	* `latestVersion` changes (or a package/node first appears behind);
+	* the payload carries the full currently-available list. Repeated
+	* polling of the same latests is silent.
 	*/
 	EventCategory["UpdateAvailable"] = "update.available";
 	/**
@@ -7582,6 +7583,10 @@ var RecordingBandSchema = object({
 	preBufferSec: number().min(0).optional(),
 	postBufferSec: number().min(0).optional()
 });
+({
+	preBufferSec: 10,
+	postBufferSec: 30
+}).postBufferSec * 1e3;
 /**
 * Per-device retention overrides. Every field is optional; an unset or `0`
 * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -14768,6 +14773,9 @@ var NcSystemEventKindSchema = _enum([
 	"alarm-disarmed",
 	"alarm-arming",
 	"alarm-arm-refused",
+	"addon-updated",
+	"server-updated",
+	"export-completed",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -16661,13 +16669,19 @@ var RetrainStatusSchema = _enum([
 * "never marked" from "already trained" must read `retrainStatus`.
 *
 * `debug` does NOT pin; it is attention, not durability.
+*
+* `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
+* A favourited track is skipped by retention the same way `staging` is, but
+* it does not enter `none|staging|trained` and has no staging budget.
 */
 var TrackFlagFields = {
 	/** Operator marked this track as training material — i.e. `retrainStatus` is
 	*  `'staging'`. */
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
-	debug: boolean().optional()
+	debug: boolean().optional(),
+	/** Operator favourited this track. Pins it against pruning. */
+	favourited: boolean().optional()
 };
 /**
 * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -16692,6 +16706,7 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
 	*  which always knows it — and a surface that has just written needs to render
@@ -20488,8 +20503,28 @@ var ClipSchema = object({
 		startMs: number(),
 		endMs: number()
 	}),
-	/** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
-	thumbnail: string().optional()
+	/**
+	* Lazy thumbnail URL, never inlined.
+	*
+	* Recording-derived clips (events-mode keep-window, and the prepared
+	* continuous event+fragment visit) MUST use the snapshot of the **main
+	* event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
+	* of the event that owns `kind` (object > motion > audio). Do not extract
+	* a keyframe from the recorded segments. Other providers (onboard, HKSV)
+	* mint their own stills.
+	*/
+	thumbnail: string().optional(),
+	/** Analytics event ids that overlap this visit. Empty on footage-only clips.
+	*  The default provider's visit grain puts many motion heartbeats on one clip
+	*  instead of minting one clip per marker. */
+	eventIds: array(string()).optional(),
+	/** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
+	*  than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
+	*  bar keeps showing them via `recording.getAvailability`. */
+	holes: array(object({
+		startMs: number(),
+		endMs: number()
+	})).optional()
 });
 var ClipPlaybackSchema = object({
 	/** HLS master URL through the hub data-plane (Range + token in path). */
@@ -26862,7 +26897,9 @@ var ExportOptionsSchema = object({
 	includeAudio: boolean(),
 	maxLifeMs: number().int().positive(),
 	deleteAfterDownload: boolean(),
-	title: string().max(200).optional()
+	title: string().max(200).optional(),
+	/** Notification-output target ids to ping when this export becomes ready. */
+	notifyTargetIds: array(string().min(1)).max(20).optional()
 }).superRefine((v, ctx) => {
 	if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
 		code: ZodIssueCode$16.custom,
@@ -26921,10 +26958,18 @@ var ExportBytesSchema = object({
 });
 method(object({
 	deviceId: number(),
-	profile: string(),
+	/** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
+	profile: string().optional(),
+	profiles: array(string()).min(1).optional(),
 	fromMs: number(),
 	toMs: number(),
 	options: ExportOptionsSchema
+}).superRefine((v, ctx) => {
+	if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
+		code: ZodIssueCode$16.custom,
+		message: "pass profiles[] (min 1) or legacy profile",
+		path: ["profiles"]
+	});
 }), ExportRecordSchema, {
 	kind: "mutation",
 	auth: "protected"
@@ -30079,15 +30124,6 @@ var BaseDeviceProvider = class extends BaseAddon {
 			labels: ["probe not implemented"]
 		};
 	}
-	/**
-	* Top-level devices restored at once in {@link onRestoreDevices}.
-	*
-	* Four covers the fleets this ships to without turning a boot into a burst a
-	* camera NVR answers with a refusal. A provider whose upstream is a single
-	* session with a serial command channel (a Baichuan hub, an NVR that
-	* serialises ISAPI) should lower it; nothing needs to raise it.
-	*/
-	restoreConcurrency = 4;
 	async restoreDevices(savedDevices) {
 		await this.onRestoreDevices(savedDevices);
 		if (savedDevices.length > 0) this.ctx.logger.info(`Restored ${savedDevices.length} ${this.providerName} device(s)`);
@@ -30142,14 +30178,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 				});
 			}
 		};
-		let nextTopLevel = 0;
-		await Promise.all(Array.from({ length: Math.min(Math.max(1, this.restoreConcurrency), topLevel.length) }, async () => {
-			for (;;) {
-				const saved = topLevel[nextTopLevel++];
-				if (saved === void 0) return;
-				await restoreOne(saved);
-			}
-		}));
+		await Promise.all(topLevel.map((saved) => restoreOne(saved)));
 		const childRows = savedDevices.filter((s) => s.parentDeviceId !== null);
 		for (const saved of childRows) {
 			const Class = this.deviceClasses[saved.type];
@@ -236762,6 +236791,26 @@ function computeHealthCheckBackoffMs(consecutive) {
 	return 15 * 6e4;
 }
 //#endregion
+//#region src/simple-event-dispatch-trace.ts
+/**
+* Gate for hub-side simpleEvent traces.
+*
+* Hub-child events arrive on the parent's Baichuan socket. Logging them on
+* the child logger only is invisible when the operator filters Logs to the
+* Hub; logging every channel unconditionally floods the Hub (battery ticks).
+* Trace when the target camera — or the hub itself — is under debug.
+*/
+function shouldTraceSimpleEventDispatch(input) {
+	return wantsEventTrace(input.hubDebugGeneral, input.hubSocketFlags) || wantsEventTrace(input.childDebugGeneral, input.childSocketFlags);
+}
+function wantsEventTrace(debugGeneral, socketFlags) {
+	return debugGeneral || socketFlags.includes("traceEvents");
+}
+/** Narrow a persisted `debugSocketLogs` blob to string flags. */
+function asDebugSocketFlags(value) {
+	return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+//#endregion
 //#region src/reolink-hub.ts
 var HUB_DISCOVERY_REFRESH_TIMEOUT_MS = 8e3;
 /**
@@ -237304,8 +237353,8 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 				const cgi = info.entries[0];
 				child.applyHubBatteryInfo({
 					batteryPercent: info.batteryLevel,
-					...typeof cgi?.["chargeStatus"] === "string" ? { chargeStatus: cgi["chargeStatus"] } : {},
-					...typeof cgi?.["adapterStatus"] === "string" ? { adapterStatus: cgi["adapterStatus"] } : {}
+					...mapHubChargeStatus(cgi?.["chargeStatus"]) !== void 0 ? { chargeStatus: mapHubChargeStatus(cgi?.["chargeStatus"]) } : {},
+					...mapHubAdapterStatus(cgi?.["adapterStatus"]) !== void 0 ? { adapterStatus: mapHubAdapterStatus(cgi?.["adapterStatus"]) } : {}
 				});
 			}
 		} catch (err) {
@@ -237530,6 +237579,18 @@ var ReolinkHub = class ReolinkHub extends BaseDevice {
 		}
 		this.ctx.devices.getAll().then((all) => all.find((d) => d.id === deviceId)).then((child) => {
 			if (!(child instanceof ReolinkCamera)) return;
+			if (shouldTraceSimpleEventDispatch({
+				hubDebugGeneral: this.config.get("debugGeneral") === true,
+				hubSocketFlags: asDebugSocketFlags(this.config.get("debugSocketLogs")),
+				childDebugGeneral: child.config.get("debugGeneral") === true,
+				childSocketFlags: asDebugSocketFlags(child.config.get("debugSocketLogs"))
+			})) this.ctx.logger.info("Reolink Hub: simpleEvent dispatch", { meta: {
+				type: ev?.type ?? "unknown",
+				channel,
+				timestamp: ev?.timestamp,
+				deviceId: child.id,
+				name: child.name
+			} });
 			child.handleSimpleEvent(ev);
 		}).catch((err) => {
 			this.ctx.logger.debug("Hub simpleEvent dispatch failed", { meta: {
@@ -237667,6 +237728,27 @@ function discoveredStatusFor(d) {
 	if (typeof d.state === "string" && d.state.length > 0) return "online";
 	return "unknown";
 }
+/**
+* The hub CGI reports charge state as NUMERIC codes (measured live on the
+* Home Hub, 2026-08-16: a full, plugged Argus 3E reads chargeStatus 2 /
+* adapterStatus 1) while `mapBatteryInfo` speaks the standalone Baichuan
+* string vocabulary ('charging' / 'chargeComplete' / 'solarPanel'). Translate
+* at the hub boundary so the shared mapper stays untouched.
+*   chargeStatus: 0 none · 1 charging · 2 charge complete
+*   adapterStatus: 0 none · 1 DC adapter · 2 solar panel
+*/
+function mapHubChargeStatus(value) {
+	if (typeof value === "string") return value;
+	if (value === 0) return "none";
+	if (value === 1) return "charging";
+	if (value === 2) return "chargeComplete";
+}
+function mapHubAdapterStatus(value) {
+	if (typeof value === "string") return value;
+	if (value === 0) return "none";
+	if (value === 1) return "dc";
+	if (value === 2) return "solarPanel";
+}
 //#endregion
 //#region src/creation-schema.ts
 /**

package/package.json

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