@camstack/addon-provider-wyze 0.2.67 → 0.2.69

package/dist/addon.js

@@ -12976,6 +12976,24 @@ var deviceProviderCapability = {
 		})
 	}
 };
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -13074,7 +13092,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(),
@@ -18702,6 +18725,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `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.
@@ -18712,6 +18738,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -18738,6 +18779,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	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,
@@ -41667,12 +41714,12 @@ var WyzeCloud = class {
 	clearSession;
 	constructor(apiKeyOrOpts, apiId) {
 		if (typeof apiKeyOrOpts === "string") {
-			this.apiKey = apiKeyOrOpts;
-			this.keyId = apiId;
+			this.apiKey = apiKeyOrOpts.trim();
+			this.keyId = (apiId ?? "").trim();
 			this.phoneId = generatePhoneId();
 		} else {
-			this.apiKey = apiKeyOrOpts.apiKey;
-			this.keyId = apiKeyOrOpts.apiId;
+			this.apiKey = apiKeyOrOpts.apiKey.trim();
+			this.keyId = apiKeyOrOpts.apiId.trim();
 			this.loadSession = apiKeyOrOpts.loadSession;
 			this.saveSession = apiKeyOrOpts.saveSession;
 			this.clearSession = apiKeyOrOpts.clearSession;
@@ -41693,6 +41740,7 @@ var WyzeCloud = class {
 	* @throws WyzeAuthError if MFA is required
 	*/
 	async login(email, password) {
+		if (!this.apiKey || !this.keyId) throw new Error("Wyze login: missing API key or key id");
 		const payload = {
 			email: email.trim(),
 			password: hashPassword(password)
@@ -42829,6 +42877,7 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 	frameHandler;
 	closed = false;
 	messageListener = null;
+	statsTimer = null;
 	constructor(opts) {
 		super();
 		this.host = opts.host;
@@ -42849,6 +42898,14 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 	* After this, call startVideo()/startAudio() to begin streaming.
 	*/
 	async connect() {
+		try {
+			return await this.doConnect();
+		} catch (err) {
+			this.close();
+			throw err;
+		}
+	}
+	async doConnect() {
 		this.socket = dgram.createSocket("udp4");
 		await new Promise((r) => this.socket.bind(0, r));
 		const localPort = this.socket.address().port;
@@ -43468,6 +43525,10 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 			this.serverConn = null;
 		}
 		if (this.ackTicker) clearInterval(this.ackTicker);
+		if (this.statsTimer) {
+			clearInterval(this.statsTimer);
+			this.statsTimer = null;
+		}
 		if (this.messageListener && this.socket) this.socket.removeListener("message", this.messageListener);
 		this.frameHandler.close();
 		if (this.socket) {
@@ -43768,9 +43829,12 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 		let frameData = 0;
 		let keepalives = 0;
 		const startedAt = Date.now();
-		const statsTimer = setInterval(() => {
+		this.statsTimer = setInterval(() => {
 			if (this.closed) {
-				clearInterval(statsTimer);
+				if (this.statsTimer) {
+					clearInterval(this.statsTimer);
+					this.statsTimer = null;
+				}
 				return;
 			}
 			const elapsed = ((Date.now() - startedAt) / 1e3).toFixed(0);
@@ -43820,7 +43884,7 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 		b.writeUInt32LE(this.avSeq, 4);
 		this.avSeq++;
 		b.writeUInt16LE(28672, 16);
-		b.writeUInt16LE(this.seqCmd, 18);
+		b.writeUInt16LE(this.seqCmd & 65535, 18);
 		b.writeUInt32LE(1, 20);
 		b.writeUInt32LE(payload.length + 4, 24);
 		b.writeUInt32LE(this.seqCmd, 28);
@@ -43893,7 +43957,7 @@ var WyzeDTLSConn = class extends events.EventEmitter {
 		b[3] = 11;
 		b.writeUInt16LE(bs, 4);
 		b.writeUInt16LE(this.txSeq, 6);
-		this.txSeq++;
+		this.txSeq = this.txSeq + 1 & 65535;
 		b.writeUInt16LE(1031, 8);
 		b.writeUInt16LE(33, 10);
 		this.sid.copy(b, 12, 0, 2);
@@ -44475,10 +44539,17 @@ async function createWyzeRfc4571Server(opts) {
 		logger
 	});
 	logger.log?.(`[wyze-rfc4571] Connecting to ${camera.nickname} (${camera.ip})...`);
-	await conn.connect();
-	logger.log?.(`[wyze-rfc4571] Connected, starting video...`);
-	await conn.startVideo(frameSize, bitrate);
-	await conn.startAudio();
+	try {
+		await conn.connect();
+		logger.log?.(`[wyze-rfc4571] Connected, starting video...`);
+		await conn.startVideo(frameSize, bitrate);
+		await conn.startAudio();
+	} catch (e) {
+		try {
+			conn.close();
+		} catch {}
+		throw e;
+	}
 	const rebuildSdp = () => {
 		if (videoSdpPart) sdp = buildFullSdp(videoSdpPart, audioSdpPart || void 0);
 	};
@@ -44636,7 +44707,9 @@ async function createWyzeRfc4571Server(opts) {
 	return {
 		host: addr.address,
 		port: addr.port,
-		sdp,
+		get sdp() {
+			return sdp;
+		},
 		videoType,
 		connection: conn,
 		close: closeFn,

package/dist/addon.mjs

@@ -12955,6 +12955,24 @@ var deviceProviderCapability = {
 		})
 	}
 };
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -13053,7 +13071,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(),
@@ -18681,6 +18704,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `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.
@@ -18691,6 +18717,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -18717,6 +18758,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	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,
@@ -41646,12 +41693,12 @@ var WyzeCloud = class {
 	clearSession;
 	constructor(apiKeyOrOpts, apiId) {
 		if (typeof apiKeyOrOpts === "string") {
-			this.apiKey = apiKeyOrOpts;
-			this.keyId = apiId;
+			this.apiKey = apiKeyOrOpts.trim();
+			this.keyId = (apiId ?? "").trim();
 			this.phoneId = generatePhoneId();
 		} else {
-			this.apiKey = apiKeyOrOpts.apiKey;
-			this.keyId = apiKeyOrOpts.apiId;
+			this.apiKey = apiKeyOrOpts.apiKey.trim();
+			this.keyId = apiKeyOrOpts.apiId.trim();
 			this.loadSession = apiKeyOrOpts.loadSession;
 			this.saveSession = apiKeyOrOpts.saveSession;
 			this.clearSession = apiKeyOrOpts.clearSession;
@@ -41672,6 +41719,7 @@ var WyzeCloud = class {
 	* @throws WyzeAuthError if MFA is required
 	*/
 	async login(email, password) {
+		if (!this.apiKey || !this.keyId) throw new Error("Wyze login: missing API key or key id");
 		const payload = {
 			email: email.trim(),
 			password: hashPassword(password)
@@ -42808,6 +42856,7 @@ var WyzeDTLSConn = class extends EventEmitter {
 	frameHandler;
 	closed = false;
 	messageListener = null;
+	statsTimer = null;
 	constructor(opts) {
 		super();
 		this.host = opts.host;
@@ -42828,6 +42877,14 @@ var WyzeDTLSConn = class extends EventEmitter {
 	* After this, call startVideo()/startAudio() to begin streaming.
 	*/
 	async connect() {
+		try {
+			return await this.doConnect();
+		} catch (err) {
+			this.close();
+			throw err;
+		}
+	}
+	async doConnect() {
 		this.socket = dgram.createSocket("udp4");
 		await new Promise((r) => this.socket.bind(0, r));
 		const localPort = this.socket.address().port;
@@ -43447,6 +43504,10 @@ var WyzeDTLSConn = class extends EventEmitter {
 			this.serverConn = null;
 		}
 		if (this.ackTicker) clearInterval(this.ackTicker);
+		if (this.statsTimer) {
+			clearInterval(this.statsTimer);
+			this.statsTimer = null;
+		}
 		if (this.messageListener && this.socket) this.socket.removeListener("message", this.messageListener);
 		this.frameHandler.close();
 		if (this.socket) {
@@ -43747,9 +43808,12 @@ var WyzeDTLSConn = class extends EventEmitter {
 		let frameData = 0;
 		let keepalives = 0;
 		const startedAt = Date.now();
-		const statsTimer = setInterval(() => {
+		this.statsTimer = setInterval(() => {
 			if (this.closed) {
-				clearInterval(statsTimer);
+				if (this.statsTimer) {
+					clearInterval(this.statsTimer);
+					this.statsTimer = null;
+				}
 				return;
 			}
 			const elapsed = ((Date.now() - startedAt) / 1e3).toFixed(0);
@@ -43799,7 +43863,7 @@ var WyzeDTLSConn = class extends EventEmitter {
 		b.writeUInt32LE(this.avSeq, 4);
 		this.avSeq++;
 		b.writeUInt16LE(28672, 16);
-		b.writeUInt16LE(this.seqCmd, 18);
+		b.writeUInt16LE(this.seqCmd & 65535, 18);
 		b.writeUInt32LE(1, 20);
 		b.writeUInt32LE(payload.length + 4, 24);
 		b.writeUInt32LE(this.seqCmd, 28);
@@ -43872,7 +43936,7 @@ var WyzeDTLSConn = class extends EventEmitter {
 		b[3] = 11;
 		b.writeUInt16LE(bs, 4);
 		b.writeUInt16LE(this.txSeq, 6);
-		this.txSeq++;
+		this.txSeq = this.txSeq + 1 & 65535;
 		b.writeUInt16LE(1031, 8);
 		b.writeUInt16LE(33, 10);
 		this.sid.copy(b, 12, 0, 2);
@@ -44454,10 +44518,17 @@ async function createWyzeRfc4571Server(opts) {
 		logger
 	});
 	logger.log?.(`[wyze-rfc4571] Connecting to ${camera.nickname} (${camera.ip})...`);
-	await conn.connect();
-	logger.log?.(`[wyze-rfc4571] Connected, starting video...`);
-	await conn.startVideo(frameSize, bitrate);
-	await conn.startAudio();
+	try {
+		await conn.connect();
+		logger.log?.(`[wyze-rfc4571] Connected, starting video...`);
+		await conn.startVideo(frameSize, bitrate);
+		await conn.startAudio();
+	} catch (e) {
+		try {
+			conn.close();
+		} catch {}
+		throw e;
+	}
 	const rebuildSdp = () => {
 		if (videoSdpPart) sdp = buildFullSdp(videoSdpPart, audioSdpPart || void 0);
 	};
@@ -44615,7 +44686,9 @@ async function createWyzeRfc4571Server(opts) {
 	return {
 		host: addr.address,
 		port: addr.port,
-		sdp,
+		get sdp() {
+			return sdp;
+		},
 		videoType,
 		connection: conn,
 		close: closeFn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-wyze",
-  "version": "0.2.67",
+  "version": "0.2.69",
   "description": "Wyze camera device-provider addon for CamStack — wraps the @apocaliss92/wyze-bridge-js P2P/DTLS client, feeding the stream-broker via the pull-rfc4571 lazy-publish path (a structural twin of addon-provider-reolink)",
   "keywords": [
     "camstack",
@@ -74,7 +74,7 @@
     "publish": "npm publish --access public"
   },
   "devDependencies": {
-    "@apocaliss92/wyze-bridge-js": "file:./vendor/apocaliss92-wyze-bridge-js-0.1.0.tgz",
+    "@apocaliss92/wyze-bridge-js": "file:./vendor/apocaliss92-wyze-bridge-js-0.1.2.tgz",
     "@camstack/types": "*",
     "typescript": "~6.0.3",
     "vite": "^8.0.11",