@camstack/addon-export-alexa 1.2.22 → 1.2.23

package/dist/export-alexa.addon.js

@@ -19376,7 +19376,16 @@ targets: array(object({
 	/** A sleeping battery camera: the frame is deliberately stale and will
 	*  NOT refresh in the background. A surface should say so rather than
 	*  present it as current. */
-	sleeping: boolean()
+	sleeping: boolean(),
+	/** Current device state rendered over the cached frame. State images
+	*  remain authoritative even when their photographic background is
+	*  old; null means the link must carry a current camera frame. */
+	stateReason: _enum([
+		"disabled",
+		"sleeping",
+		"unreachable",
+		"waking"
+	]).nullable()
 })));
 /**
 * `sso-bridge` — internal hub-only cap that lets SSO-style auth
@@ -34340,6 +34349,9 @@ function errorEnvelope(header, type, message) {
 * route to the right cap on the right device.
 */
 var discoveryPayloadSchema = DiscoveryDirectiveSchema.shape.payload;
+/** Devices built at once in `handleDiscovery` — latency-bound tRPC reads, so
+*  six lanes hide the round-trips without stampeding a booting hub. */
+var DISCOVERY_BUILD_CONCURRENCY = 6;
 var CAP_DOORBELL = "doorbell";
 var CAP_INTERCOM = "intercom";
 var CAP_MOTION = "motion";
@@ -34352,16 +34364,28 @@ var CAP_PRIVACY_MASK = "privacy-mask";
 async function handleDiscovery(header, payloadRaw, deps, callerIdentity) {
 	if (!discoveryPayloadSchema.safeParse(payloadRaw).success) return errorEnvelope(header, "INVALID_DIRECTIVE", "Discovery payload shape unexpected");
 	const exposed = await deps.listExposed();
-	const endpoints = [];
-	for (const entry of exposed) try {
-		const built = await buildEndpointsForExposedDevice(entry.deviceId, deps);
-		endpoints.push(...built);
-	} catch (err) {
-		deps.logger.warn("alexa discovery (on-demand): skipping device — build failed", {
-			tags: { deviceId: entry.deviceId },
-			meta: { error: err instanceof Error ? err.message : String(err) }
-		});
-	}
+	const built = new Array(exposed.length).fill(null);
+	const queue = exposed.map((entry, index) => ({
+		entry,
+		index
+	}));
+	const lane = async () => {
+		for (;;) {
+			const item = queue.shift();
+			if (item === void 0) return;
+			try {
+				built[item.index] = await buildEndpointsForExposedDevice(item.entry.deviceId, deps);
+			} catch (err) {
+				deps.logger.warn("alexa discovery (on-demand): skipping device — build failed", {
+					tags: { deviceId: item.entry.deviceId },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+		}
+	};
+	const lanes = Math.min(DISCOVERY_BUILD_CONCURRENCY, Math.max(1, queue.length));
+	await Promise.all(Array.from({ length: lanes }, lane));
+	const endpoints = built.flatMap((b) => b ?? []);
 	deps.logger.info("alexa discovery returned endpoints", { meta: {
 		count: endpoints.length,
 		userId: callerIdentity.userId
@@ -36726,8 +36750,30 @@ function endpointsSignature(endpoints) {
 }
 //#endregion
 //#region src/sync-engine.ts
+/**
+* Devices reconciled at once in {@link SyncEngine.reconcileAllExposed}. Each
+* lane's device build is a handful of cross-process tRPC calls — latency, not
+* CPU — so four lanes hide most of it without turning a boot-time cap
+* registration burst into a second stampede.
+*/
+var RECONCILE_ALL_CONCURRENCY = 4;
 var SyncEngine = class {
 	deps;
+	/**
+	* Serializes the `recordEndpoints` read-modify-write. The build/push half of
+	* a reconcile runs parallel across devices, but the persisted maps are
+	* whole-object snapshots: two concurrent `get → mutate → set` cycles would
+	* silently drop one device's ids/signature (last writer wins).
+	*/
+	recordChain = Promise.resolve();
+	/**
+	* One in-flight reconcile per device. At boot the 60 s full pass and the
+	* debounced bindings-change reconciles overlap, and each one rebuilt the
+	* same device serially — the live hub built camera 615's endpoint shape
+	* four times inside one boot (2026-08-15). Joining the running pass costs
+	* the duplicate nothing.
+	*/
+	reconcileFlights = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -36838,6 +36884,15 @@ var SyncEngine = class {
 	* re-push a shape Alexa already has.
 	*/
 	async reconcileDevice(deviceId) {
+		const inFlight = this.reconcileFlights.get(deviceId);
+		if (inFlight) return inFlight;
+		const flight = this.reconcileDeviceNow(deviceId).finally(() => {
+			if (this.reconcileFlights.get(deviceId) === flight) this.reconcileFlights.delete(deviceId);
+		});
+		this.reconcileFlights.set(deviceId, flight);
+		return flight;
+	}
+	async reconcileDeviceNow(deviceId) {
 		if (!this.deps.listExposed().some((e) => e.deviceId === deviceId)) return {
 			deviceId,
 			pushed: false
@@ -36878,26 +36933,42 @@ var SyncEngine = class {
 	async reconcileAllExposed() {
 		const checkedDeviceIds = [];
 		const pushedDeviceIds = [];
-		for (const { deviceId } of this.deps.listExposed()) {
-			checkedDeviceIds.push(deviceId);
-			if ((await this.reconcileDevice(deviceId)).pushed) pushedDeviceIds.push(deviceId);
-		}
+		const queue = [...this.deps.listExposed()];
+		const lane = async () => {
+			for (;;) {
+				const entry = queue.shift();
+				if (entry === void 0) return;
+				checkedDeviceIds.push(entry.deviceId);
+				if ((await this.reconcileDevice(entry.deviceId)).pushed) pushedDeviceIds.push(entry.deviceId);
+			}
+		};
+		const lanes = Math.min(RECONCILE_ALL_CONCURRENCY, Math.max(1, queue.length));
+		await Promise.all(Array.from({ length: lanes }, lane));
 		return {
 			checkedDeviceIds,
 			pushedDeviceIds
 		};
 	}
 	/** Persist the endpoint ids AND the shape signature for a device.
-	*  `signature === null` forgets both (delete / empty build). */
+	*  `signature === null` forgets both (delete / empty build).
+	*
+	*  Serialized through `recordChain`: the maps are whole-object snapshots
+	*  (`get` → spread → `set`), so parallel reconciles would otherwise race —
+	*  two devices' writes computed off the same stale snapshot, the second
+	*  `set` erasing the first's entry. */
 	async recordEndpoints(deviceId, ids, signature) {
-		const next = { ...this.deps.getExportedEndpoints() };
-		if (ids.length > 0) next[deviceId] = ids;
-		else delete next[deviceId];
-		await this.deps.setExportedEndpoints(next);
-		const nextSignatures = { ...this.deps.getExportedSignatures() };
-		if (signature !== null) nextSignatures[deviceId] = signature;
-		else delete nextSignatures[deviceId];
-		await this.deps.setExportedSignatures(nextSignatures);
+		const write = this.recordChain.then(async () => {
+			const next = { ...this.deps.getExportedEndpoints() };
+			if (ids.length > 0) next[deviceId] = ids;
+			else delete next[deviceId];
+			await this.deps.setExportedEndpoints(next);
+			const nextSignatures = { ...this.deps.getExportedSignatures() };
+			if (signature !== null) nextSignatures[deviceId] = signature;
+			else delete nextSignatures[deviceId];
+			await this.deps.setExportedSignatures(nextSignatures);
+		});
+		this.recordChain = write.then(() => void 0, () => void 0);
+		return write;
 	}
 };
 //#endregion

package/dist/export-alexa.addon.mjs

@@ -19349,7 +19349,16 @@ targets: array(object({
 	/** A sleeping battery camera: the frame is deliberately stale and will
 	*  NOT refresh in the background. A surface should say so rather than
 	*  present it as current. */
-	sleeping: boolean()
+	sleeping: boolean(),
+	/** Current device state rendered over the cached frame. State images
+	*  remain authoritative even when their photographic background is
+	*  old; null means the link must carry a current camera frame. */
+	stateReason: _enum([
+		"disabled",
+		"sleeping",
+		"unreachable",
+		"waking"
+	]).nullable()
 })));
 /**
 * `sso-bridge` — internal hub-only cap that lets SSO-style auth
@@ -34313,6 +34322,9 @@ function errorEnvelope(header, type, message) {
 * route to the right cap on the right device.
 */
 var discoveryPayloadSchema = DiscoveryDirectiveSchema.shape.payload;
+/** Devices built at once in `handleDiscovery` — latency-bound tRPC reads, so
+*  six lanes hide the round-trips without stampeding a booting hub. */
+var DISCOVERY_BUILD_CONCURRENCY = 6;
 var CAP_DOORBELL = "doorbell";
 var CAP_INTERCOM = "intercom";
 var CAP_MOTION = "motion";
@@ -34325,16 +34337,28 @@ var CAP_PRIVACY_MASK = "privacy-mask";
 async function handleDiscovery(header, payloadRaw, deps, callerIdentity) {
 	if (!discoveryPayloadSchema.safeParse(payloadRaw).success) return errorEnvelope(header, "INVALID_DIRECTIVE", "Discovery payload shape unexpected");
 	const exposed = await deps.listExposed();
-	const endpoints = [];
-	for (const entry of exposed) try {
-		const built = await buildEndpointsForExposedDevice(entry.deviceId, deps);
-		endpoints.push(...built);
-	} catch (err) {
-		deps.logger.warn("alexa discovery (on-demand): skipping device — build failed", {
-			tags: { deviceId: entry.deviceId },
-			meta: { error: err instanceof Error ? err.message : String(err) }
-		});
-	}
+	const built = new Array(exposed.length).fill(null);
+	const queue = exposed.map((entry, index) => ({
+		entry,
+		index
+	}));
+	const lane = async () => {
+		for (;;) {
+			const item = queue.shift();
+			if (item === void 0) return;
+			try {
+				built[item.index] = await buildEndpointsForExposedDevice(item.entry.deviceId, deps);
+			} catch (err) {
+				deps.logger.warn("alexa discovery (on-demand): skipping device — build failed", {
+					tags: { deviceId: item.entry.deviceId },
+					meta: { error: err instanceof Error ? err.message : String(err) }
+				});
+			}
+		}
+	};
+	const lanes = Math.min(DISCOVERY_BUILD_CONCURRENCY, Math.max(1, queue.length));
+	await Promise.all(Array.from({ length: lanes }, lane));
+	const endpoints = built.flatMap((b) => b ?? []);
 	deps.logger.info("alexa discovery returned endpoints", { meta: {
 		count: endpoints.length,
 		userId: callerIdentity.userId
@@ -36699,8 +36723,30 @@ function endpointsSignature(endpoints) {
 }
 //#endregion
 //#region src/sync-engine.ts
+/**
+* Devices reconciled at once in {@link SyncEngine.reconcileAllExposed}. Each
+* lane's device build is a handful of cross-process tRPC calls — latency, not
+* CPU — so four lanes hide most of it without turning a boot-time cap
+* registration burst into a second stampede.
+*/
+var RECONCILE_ALL_CONCURRENCY = 4;
 var SyncEngine = class {
 	deps;
+	/**
+	* Serializes the `recordEndpoints` read-modify-write. The build/push half of
+	* a reconcile runs parallel across devices, but the persisted maps are
+	* whole-object snapshots: two concurrent `get → mutate → set` cycles would
+	* silently drop one device's ids/signature (last writer wins).
+	*/
+	recordChain = Promise.resolve();
+	/**
+	* One in-flight reconcile per device. At boot the 60 s full pass and the
+	* debounced bindings-change reconciles overlap, and each one rebuilt the
+	* same device serially — the live hub built camera 615's endpoint shape
+	* four times inside one boot (2026-08-15). Joining the running pass costs
+	* the duplicate nothing.
+	*/
+	reconcileFlights = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -36811,6 +36857,15 @@ var SyncEngine = class {
 	* re-push a shape Alexa already has.
 	*/
 	async reconcileDevice(deviceId) {
+		const inFlight = this.reconcileFlights.get(deviceId);
+		if (inFlight) return inFlight;
+		const flight = this.reconcileDeviceNow(deviceId).finally(() => {
+			if (this.reconcileFlights.get(deviceId) === flight) this.reconcileFlights.delete(deviceId);
+		});
+		this.reconcileFlights.set(deviceId, flight);
+		return flight;
+	}
+	async reconcileDeviceNow(deviceId) {
 		if (!this.deps.listExposed().some((e) => e.deviceId === deviceId)) return {
 			deviceId,
 			pushed: false
@@ -36851,26 +36906,42 @@ var SyncEngine = class {
 	async reconcileAllExposed() {
 		const checkedDeviceIds = [];
 		const pushedDeviceIds = [];
-		for (const { deviceId } of this.deps.listExposed()) {
-			checkedDeviceIds.push(deviceId);
-			if ((await this.reconcileDevice(deviceId)).pushed) pushedDeviceIds.push(deviceId);
-		}
+		const queue = [...this.deps.listExposed()];
+		const lane = async () => {
+			for (;;) {
+				const entry = queue.shift();
+				if (entry === void 0) return;
+				checkedDeviceIds.push(entry.deviceId);
+				if ((await this.reconcileDevice(entry.deviceId)).pushed) pushedDeviceIds.push(entry.deviceId);
+			}
+		};
+		const lanes = Math.min(RECONCILE_ALL_CONCURRENCY, Math.max(1, queue.length));
+		await Promise.all(Array.from({ length: lanes }, lane));
 		return {
 			checkedDeviceIds,
 			pushedDeviceIds
 		};
 	}
 	/** Persist the endpoint ids AND the shape signature for a device.
-	*  `signature === null` forgets both (delete / empty build). */
+	*  `signature === null` forgets both (delete / empty build).
+	*
+	*  Serialized through `recordChain`: the maps are whole-object snapshots
+	*  (`get` → spread → `set`), so parallel reconciles would otherwise race —
+	*  two devices' writes computed off the same stale snapshot, the second
+	*  `set` erasing the first's entry. */
 	async recordEndpoints(deviceId, ids, signature) {
-		const next = { ...this.deps.getExportedEndpoints() };
-		if (ids.length > 0) next[deviceId] = ids;
-		else delete next[deviceId];
-		await this.deps.setExportedEndpoints(next);
-		const nextSignatures = { ...this.deps.getExportedSignatures() };
-		if (signature !== null) nextSignatures[deviceId] = signature;
-		else delete nextSignatures[deviceId];
-		await this.deps.setExportedSignatures(nextSignatures);
+		const write = this.recordChain.then(async () => {
+			const next = { ...this.deps.getExportedEndpoints() };
+			if (ids.length > 0) next[deviceId] = ids;
+			else delete next[deviceId];
+			await this.deps.setExportedEndpoints(next);
+			const nextSignatures = { ...this.deps.getExportedSignatures() };
+			if (signature !== null) nextSignatures[deviceId] = signature;
+			else delete nextSignatures[deviceId];
+			await this.deps.setExportedSignatures(nextSignatures);
+		});
+		this.recordChain = write.then(() => void 0, () => void 0);
+		return write;
 	}
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-export-alexa",
-  "version": "1.2.22",
+  "version": "1.2.23",
   "description": "Alexa Smart Home Skill export — hub-side OAuth provider + directive handler. The companion AWS Lambda forwards Alexa directives to this addon's /addon/export-alexa/directive endpoint.",
   "keywords": [
     "camstack",