@glasshome/sync-layer 0.7.1 → 0.8.0

package/dist/index.js

@@ -1,8 +1,7 @@
-import { applyDemoServiceCall, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, callService, createDemoFixtures, demoEnergyPreferences, entityViewEquals, extractDomain, fetchStatisticsDuringPeriod, forceResubscribe, forceResubscribeCalendars, getAllEntityViews, getAreaView, getAreaViews, getEntityView, getEntityViews, isDemoMode, isEnergyEntity, loadDemoData, normalizeStatisticTime, privilegedConn, registerEntity, sendCommand, setManagerConnection, setPrivilegedConn, setResubscribeHandler, setState, startDemoEnergyTicker, state, stopDemoEnergyTicker, synthesizeEnergyHistory, toggle, turnOff, turnOn, unloadDemoData, updateEntity } from "./statistics-CtRfIF6D.js";
-import { runHaBridgeWorker } from "./worker-main-C-3QM4di.js";
-import { createConnection, getAuth } from "home-assistant-js-websocket";
+import { A as extractDomain, B as state, C as startDemoEnergyTicker, D as demoEnergyPreferences, E as createDemoFixtures, F as forceResubscribeCalendars, L as privilegedConn, M as registerEntity, N as setManagerConnection, O as isEnergyEntity, P as setResubscribeHandler, R as setPrivilegedConn, S as loadDemoData, T as unloadDemoData, _ as turnOff, a as getAreaView, b as applyDemoServiceCall, c as entityViewEquals, d as getEntityViews, f as batchEntityUpdates, g as toggle, h as sendCommand, i as buildDeviceView, j as forceResubscribe, k as synthesizeEnergyHistory, l as getAllEntityViews, m as callService, n as normalizeStatisticTime, o as getAreaViews, p as batchServiceCalls, r as buildAreaView, s as buildEntityView, t as fetchStatisticsDuringPeriod, u as getEntityView, v as turnOn, w as stopDemoEnergyTicker, x as isDemoMode, y as updateEntity, z as setState } from "./statistics-DyCCTwv2.js";
+import { t as runHaBridgeWorker } from "./worker-main-D_wyGAIG.js";
+import "home-assistant-js-websocket";
 import { produce } from "solid-js/store";
-
 //#region src/core/reducers.ts
 /**
 * Bulk update multiple entities
@@ -11,9 +10,9 @@ import { produce } from "solid-js/store";
 *
 * @param entities - Array of entity states
 */
-function bulkUpdateEntities(entities$1) {
+function bulkUpdateEntities(entities) {
 	setState(produce((s) => {
-		for (const entity$1 of entities$1) s.entities[entity$1.entity_id] = entity$1;
+		for (const entity of entities) s.entities[entity.entity_id] = entity;
 	}));
 }
 /**
@@ -71,9 +70,9 @@ function removeDevice(deviceId) {
 *
 * @param area - Area registry entry
 */
-function updateArea(area$1) {
+function updateArea(area) {
 	setState(produce((s) => {
-		s.areas[area$1.id] = area$1;
+		s.areas[area.id] = area;
 	}));
 }
 /**
@@ -136,121 +135,16 @@ function updateStatisticsMetadata(metadata) {
 		for (const meta of metadata) s.statisticsMetadata[meta.statistic_id] = meta;
 	}));
 }
-
 //#endregion
-//#region src/connection/auth.ts
+//#region src/history/constants.ts
 /**
-* Authenticate using OAuth flow
-*
-* This function uses `getAuth` from `home-assistant-js-websocket` which:
-* 1. Redirects the whole page to the Home Assistant authorization page
-* 2. Waits for user authorization
-* 3. On return, HA redirects back to the app URL with `?auth_callback=1&code=…`
-* 4. Exchanges the authorization code for tokens and returns an Auth object
-*
-* Note: For a complete OAuth flow, you typically need to:
-* - Set up a redirect URI endpoint in your app
-* - Handle the OAuth callback with the authorization code
-* - Use `getAuthCode` callback to provide the code
-*
-* In browser environments `getAuth` handles this automatically via a full-page
-* redirect (not a popup); native platforms supply `getAuthCode` instead.
-*
-* @param options - OAuth options
-* @returns Authenticated Auth object
+* History Constants
 *
-* @example
-* ```typescript
-* // Basic OAuth flow (browser only)
-* const auth = await authenticateWithOAuth({
-*   url: 'https://homeassistant.local:8123',
-*   clientId: 'https://homeassistant.local:8123',
-*   redirectUri: 'https://myapp.com/auth/callback',
-* });
-* ```
+* Constants and utilities for history fetching and processing.
+* Based on Home Assistant frontend implementation.
 *
-* @example
-* ```typescript
-* // OAuth with custom code handling
-* const auth = await authenticateWithOAuth({
-*   url: 'https://homeassistant.local:8123',
-*   clientId: 'https://homeassistant.local:8123',
-*   redirectUri: 'https://myapp.com/auth/callback',
-*   getAuthCode: async () => {
-*     // Wait for user to authorize and get code from callback
-*     return await waitForAuthCode();
-*   },
-* });
-* ```
+* @packageDocumentation
 */
-async function authenticateWithOAuth(options) {
-	const { url, clientId, redirectUri, authCode, getAuthCode, saveAuth, loadAuth, limitHassInstance } = options;
-	try {
-		const auth$1 = await getAuth({
-			hassUrl: url,
-			clientId: clientId ?? null,
-			redirectUrl: redirectUri,
-			authCode,
-			limitHassInstance,
-			async loadTokens() {
-				if (loadAuth) {
-					const saved = await loadAuth();
-					if (saved?.data) return saved.data;
-				}
-				return null;
-			},
-			saveTokens(tokens) {
-				if (saveAuth && tokens) {
-					const authObj = {
-						hassUrl: url,
-						clientId,
-						redirectUrl: redirectUri,
-						data: tokens,
-						async refreshAccessToken() {
-							return Promise.resolve();
-						}
-					};
-					saveAuth(authObj);
-				}
-			}
-		});
-		return auth$1;
-	} catch {}
-	let finalAuthCode = authCode;
-	if (!finalAuthCode && getAuthCode) finalAuthCode = await getAuthCode();
-	const auth = await getAuth({
-		hassUrl: url,
-		clientId: clientId ?? null,
-		redirectUrl: redirectUri,
-		authCode: finalAuthCode,
-		limitHassInstance,
-		async loadTokens() {
-			if (loadAuth) {
-				const saved = await loadAuth();
-				if (saved?.data) return saved.data;
-			}
-			return null;
-		},
-		saveTokens(tokens) {
-			if (saveAuth && tokens) {
-				const authObj = {
-					hassUrl: url,
-					clientId,
-					redirectUrl: redirectUri,
-					data: tokens,
-					async refreshAccessToken() {
-						return Promise.resolve();
-					}
-				};
-				saveAuth(authObj);
-			}
-		}
-	});
-	return auth;
-}
-
-//#endregion
-//#region src/history/constants.ts
 const DOMAINS_USE_LAST_UPDATED = [
 	"climate",
 	"humidifier",
@@ -283,10 +177,14 @@ function entityIdHistoryNeedsAttributes(entityId) {
 	if (!state.entities[entityId]) return NEED_ATTRIBUTE_DOMAINS.includes(domain);
 	return NEED_ATTRIBUTE_DOMAINS.includes(domain);
 }
-
 //#endregion
 //#region src/history/fetch.ts
 /**
+* History Fetching
+*
+* @packageDocumentation
+*/
+/**
 * Fetch history for entities during a time period
 */
 async function fetchHistory(options) {
@@ -306,19 +204,17 @@ async function fetchHistory(options) {
 	}
 	const startTimeStr = startTime.toISOString();
 	const endTimeStr = endTime?.toISOString();
-	const noAttributes = noAttributesOverride ?? (entityIds.length === 0 ? false : !entityIds.some((entityId) => entityIdHistoryNeedsAttributes(entityId)));
 	const params = {
 		type: "history/history_during_period",
 		start_time: startTimeStr,
 		minimal_response: minimalResponse,
-		no_attributes: noAttributes,
+		no_attributes: noAttributesOverride ?? (entityIds.length === 0 ? false : !entityIds.some((entityId) => entityIdHistoryNeedsAttributes(entityId))),
 		include_start_time_state: includeStartTimeState,
 		significant_changes_only: significantChangesOnly
 	};
 	if (endTimeStr) params.end_time = endTimeStr;
 	if (entityIds.length !== 0) params.entity_ids = entityIds;
-	const response = await sendCommand(params);
-	return response ?? {};
+	return await sendCommand(params) ?? {};
 }
 /**
 * Fetch history for a single entity
@@ -326,7 +222,7 @@ async function fetchHistory(options) {
 async function fetchEntityHistory(entityId, options) {
 	const { startTime, endTime, includeStartTimeState = true, significantChangesOnly = true, minimalResponse = false, noAttributes = false } = options;
 	try {
-		const historyData = await fetchHistory({
+		const entityHistory = (await fetchHistory({
 			startTime,
 			endTime,
 			entityIds: [entityId],
@@ -334,18 +230,16 @@ async function fetchEntityHistory(entityId, options) {
 			significantChangesOnly,
 			minimalResponse,
 			noAttributes
-		});
-		const entityHistory = historyData[entityId] ?? [];
-		const timeline = entityHistory.map((s) => ({
-			timestamp: s.lu,
-			state: s.s,
-			attributes: s.a,
-			lastChanged: s.lc,
-			lastUpdated: s.lu
-		}));
+		}))[entityId] ?? [];
 		return {
 			entityId,
-			timeline,
+			timeline: entityHistory.map((s) => ({
+				timestamp: s.lu,
+				state: s.s,
+				attributes: s.a,
+				lastChanged: s.lc,
+				lastUpdated: s.lu
+			})),
 			entityHistory,
 			loading: false,
 			error: null,
@@ -374,28 +268,35 @@ function historyStateToTimeline(s) {
 		lastUpdated: s.lu
 	};
 }
-
 //#endregion
 //#region src/history/query.ts
 /** Hard cap on retained points per entity timeline. */
 const MAX_HISTORY_POINTS = 5760;
-/** Set of entity IDs with active history tracking. */
-const trackedEntities = /* @__PURE__ */ new Set();
+/** Live tracker count per entity. Ref-counted because a timeline is shared: two
+*  widgets on the same entity must not let the first unmount delete the store
+*  data the second is still rendering (appendHistoryPoint would then silently
+*  drop every update and the survivor's chart would freeze). */
+const trackedEntities = /* @__PURE__ */ new Map();
 /** Check if an entity has active history tracking. */
 function isHistoryTracked(entityId) {
 	return trackedEntities.has(entityId);
 }
 /** Start tracking history for an entity. Fetches initial backfill. */
 async function trackEntityHistory(entityId, options) {
-	trackedEntities.add(entityId);
+	trackedEntities.set(entityId, (trackedEntities.get(entityId) ?? 0) + 1);
 	const historyData = await fetchEntityHistory(entityId, options);
 	setState(produce((s) => {
 		s.history[entityId] = historyData;
 	}));
 	return historyData;
 }
-/** Stop tracking history for an entity and clear its data. */
+/** Release one tracker. The entity's data is cleared only when the last one goes. */
 function untrackEntityHistory(entityId) {
+	const remaining = (trackedEntities.get(entityId) ?? 0) - 1;
+	if (remaining > 0) {
+		trackedEntities.set(entityId, remaining);
+		return;
+	}
 	trackedEntities.delete(entityId);
 	setState(produce((s) => {
 		delete s.history[entityId];
@@ -454,12 +355,11 @@ function bulkAppendHistoryPoints(points) {
 		for (const entityId of touched) {
 			const history = s.history[entityId];
 			if (!history) continue;
-			if (history.entityHistory.length > MAX_HISTORY_POINTS) history.entityHistory.splice(0, history.entityHistory.length - MAX_HISTORY_POINTS);
-			if (history.timeline.length > MAX_HISTORY_POINTS) history.timeline.splice(0, history.timeline.length - MAX_HISTORY_POINTS);
+			if (history.entityHistory.length > 5760) history.entityHistory.splice(0, history.entityHistory.length - MAX_HISTORY_POINTS);
+			if (history.timeline.length > 5760) history.timeline.splice(0, history.timeline.length - MAX_HISTORY_POINTS);
 		}
 	}));
 }
-
 //#endregion
 //#region src/connection/subscriptions.ts
 /** Registry subscription cleanup functions (entity sub managed by subscription-manager) */
@@ -471,8 +371,7 @@ function bufferMessage(message) {
 	messageBuffer.push(message);
 	if (!rafScheduled) {
 		rafScheduled = true;
-		const schedule = typeof requestAnimationFrame === "function" ? requestAnimationFrame : queueMicrotask;
-		schedule(flushMessageBuffer);
+		(typeof requestAnimationFrame === "function" ? requestAnimationFrame : queueMicrotask)(flushMessageBuffer);
 	}
 }
 function flushMessageBuffer() {
@@ -503,10 +402,9 @@ function flushMessageBuffer() {
 async function subscribeEntities(connection, entityIds) {
 	const subscribeMsg = { type: "subscribe_entities" };
 	if (entityIds.length > 0) subscribeMsg.entity_ids = entityIds;
-	const unsub = await connection.subscribeMessage((message) => {
+	return await connection.subscribeMessage((message) => {
 		bufferMessage(message);
 	}, subscribeMsg);
-	return unsub;
 }
 /**
 * Subscribe to all relevant events from Home Assistant
@@ -584,8 +482,7 @@ async function handleDeviceRegistryUpdate(event) {
 		const conn = privilegedConn();
 		if (!conn) return;
 		try {
-			const devices = await conn.sendMessagePromise({ type: "config/device_registry/list" });
-			const device = devices.find((d) => d.id === device_id);
+			const device = (await conn.sendMessagePromise({ type: "config/device_registry/list" })).find((d) => d.id === device_id);
 			if (device) updateDevice(device);
 		} catch (error) {
 			console.error("Error fetching device:", error);
@@ -598,9 +495,8 @@ async function handleAreaRegistryUpdate(event) {
 		const conn = privilegedConn();
 		if (!conn) return;
 		try {
-			const areas$1 = await conn.sendMessagePromise({ type: "config/area_registry/list" });
-			const area$1 = areas$1.find((a) => a.id === area_id);
-			if (area$1) updateArea(area$1);
+			const area = (await conn.sendMessagePromise({ type: "config/area_registry/list" })).find((a) => a.id === area_id);
+			if (area) updateArea(area);
 		} catch (error) {
 			console.error("Error fetching area:", error);
 		}
@@ -612,8 +508,7 @@ async function handleFloorRegistryUpdate(event) {
 		const conn = privilegedConn();
 		if (!conn) return;
 		try {
-			const floors = await conn.sendMessagePromise({ type: "config/floor_registry/list" });
-			const floor = floors.find((f) => f.floor_id === floor_id);
+			const floor = (await conn.sendMessagePromise({ type: "config/floor_registry/list" })).find((f) => f.floor_id === floor_id);
 			if (floor) updateFloor(floor);
 		} catch (error) {
 			console.error("Error fetching floor:", error);
@@ -626,8 +521,7 @@ async function handleLabelRegistryUpdate(event) {
 		const conn = privilegedConn();
 		if (!conn) return;
 		try {
-			const labels = await conn.sendMessagePromise({ type: "config/label_registry/list" });
-			const label = labels.find((l) => l.label_id === label_id);
+			const label = (await conn.sendMessagePromise({ type: "config/label_registry/list" })).find((l) => l.label_id === label_id);
 			if (label) updateLabel(label);
 		} catch (error) {
 			console.error("Error fetching label:", error);
@@ -652,7 +546,7 @@ async function handleStatisticsUpdate(event) {
 function timestampToIso(timestamp) {
 	if (timestamp === void 0) return (/* @__PURE__ */ new Date()).toISOString();
 	if (typeof timestamp === "string") return timestamp;
-	return new Date(timestamp * 1e3).toISOString();
+	return (/* @__PURE__ */ new Date(timestamp * 1e3)).toISOString();
 }
 function collectHistoryFromCompressed(points, entityId, compressed) {
 	if (!isHistoryTracked(entityId)) return;
@@ -745,10 +639,8 @@ function applyStateDiff(s, entityId, diff) {
 	const removals = diff["-"];
 	if (removals?.a) for (const key of removals.a) delete existing.attributes[key];
 }
-
 //#endregion
 //#region src/connection/manager.ts
-const SUSPEND_DELAY_MS = 5 * 60 * 1e3;
 let activeConn = null;
 let heartbeatInterval = null;
 let suspendTimeout = null;
@@ -826,7 +718,7 @@ async function loadInitialData(conn) {
 		setState(produce((s) => {
 			for (const device of deviceRegistry) s.devices[device.id] = device;
 			for (const areaApi of areaRegistry) {
-				const area$1 = {
+				const area = {
 					id: areaApi.area_id || areaApi.id,
 					name: areaApi.name,
 					normalized_name: areaApi.normalized_name || areaApi.name.toLowerCase().replace(/\s+/g, "_"),
@@ -837,10 +729,10 @@ async function loadInitialData(conn) {
 					labels: Array.isArray(areaApi.labels) ? areaApi.labels : [],
 					picture: areaApi.picture ?? null,
 					temperature_entity_id: areaApi.temperature_entity_id ?? null,
-					created_at: typeof areaApi.created_at === "number" ? new Date(areaApi.created_at * 1e3).toISOString() : areaApi.created_at,
-					modified_at: typeof areaApi.modified_at === "number" ? new Date(areaApi.modified_at * 1e3).toISOString() : areaApi.modified_at
+					created_at: typeof areaApi.created_at === "number" ? (/* @__PURE__ */ new Date(areaApi.created_at * 1e3)).toISOString() : areaApi.created_at,
+					modified_at: typeof areaApi.modified_at === "number" ? (/* @__PURE__ */ new Date(areaApi.modified_at * 1e3)).toISOString() : areaApi.modified_at
 				};
-				s.areas[area$1.id] = area$1;
+				s.areas[area.id] = area;
 			}
 			for (const floor of floorRegistry) s.floors[floor.floor_id] = floor;
 			for (const label of labelRegistry) s.labels[label.label_id] = label;
@@ -850,7 +742,6 @@ async function loadInitialData(conn) {
 		throw error;
 	}
 }
-
 //#endregion
 //#region src/query/area-builder.ts
 var AreaQueryBuilderImpl = class AreaQueryBuilderImpl {
@@ -889,8 +780,7 @@ var AreaQueryBuilderImpl = class AreaQueryBuilderImpl {
 		return this.execute();
 	}
 	first() {
-		const results = this.execute();
-		return results[0];
+		return this.execute()[0];
 	}
 	subscribe(callback) {
 		callback(this.get());
@@ -903,15 +793,15 @@ var AreaQueryBuilderImpl = class AreaQueryBuilderImpl {
 		});
 	}
 	execute() {
-		let areas$1 = getAreaViews();
-		for (const filter of this.queryState.filters) if (filter.type === "floor") areas$1 = areas$1.filter((area$1) => area$1.floorId === filter.value);
-		else if (filter.type === "label") areas$1 = areas$1.filter((area$1) => area$1.labels.includes(filter.value));
-		else if (filter.type === "predicate") areas$1 = areas$1.filter(filter.value);
-		if (this.queryState.sorts.length > 0) areas$1 = this.sortAreas(areas$1);
-		return areas$1;
-	}
-	sortAreas(areas$1) {
-		return [...areas$1].sort((a, b) => {
+		let areas = getAreaViews();
+		for (const filter of this.queryState.filters) if (filter.type === "floor") areas = areas.filter((area) => area.floorId === filter.value);
+		else if (filter.type === "label") areas = areas.filter((area) => area.labels.includes(filter.value));
+		else if (filter.type === "predicate") areas = areas.filter(filter.value);
+		if (this.queryState.sorts.length > 0) areas = this.sortAreas(areas);
+		return areas;
+	}
+	sortAreas(areas) {
+		return [...areas].sort((a, b) => {
 			for (const sort of this.queryState.sorts) {
 				const aValue = this.getNestedValue(a, sort.key);
 				const bValue = this.getNestedValue(b, sort.key);
@@ -943,10 +833,18 @@ function areas() {
 function area(areaId) {
 	return getAreaView(areaId);
 }
-
 //#endregion
 //#region src/entities/index.ts
 /**
+* Entity Index Queries
+*
+* Provides utilities for querying entities by various criteria.
+* In the SolidJS port, indices are NOT stored in state -- they are
+* computed on the fly here (and will be derived reactively in Plan 03).
+*
+* @packageDocumentation
+*/
+/**
 * Get all entity IDs
 */
 function getAllEntityIds() {
@@ -968,10 +866,7 @@ function getEntitiesViaDevices(areaId) {
 	const entityIds = [];
 	for (const device of devicesInArea) {
 		const deviceEntities = getEntitiesByDevice(device.id);
-		for (const entityId of deviceEntities) {
-			const registry = state.entityRegistry[entityId];
-			if (!registry?.area_id) entityIds.push(entityId);
-		}
+		for (const entityId of deviceEntities) if (!state.entityRegistry[entityId]?.area_id) entityIds.push(entityId);
 	}
 	return entityIds;
 }
@@ -984,7 +879,7 @@ function getEntitiesByArea(areaId) {
 	const directEntityIds = [];
 	for (const [entityId, entry] of Object.entries(state.entityRegistry)) if (entry.area_id === areaId) directEntityIds.push(entityId);
 	const deviceEntityIds = getEntitiesViaDevices(areaId);
-	return Array.from(new Set([...directEntityIds, ...deviceEntityIds]));
+	return Array.from(/* @__PURE__ */ new Set([...directEntityIds, ...deviceEntityIds]));
 }
 /**
 * Get entities by device
@@ -999,9 +894,9 @@ function getEntitiesByDevice(deviceId) {
 */
 function getEntitiesByFloor(floorId) {
 	const entityIds = [];
-	const areasOnFloor = Object.values(state.areas).filter((area$1) => area$1.floor_id === floorId);
-	for (const area$1 of areasOnFloor) {
-		const areaEntities = getEntitiesByArea(area$1.id);
+	const areasOnFloor = Object.values(state.areas).filter((area) => area.floor_id === floorId);
+	for (const area of areasOnFloor) {
+		const areaEntities = getEntitiesByArea(area.id);
 		entityIds.push(...areaEntities);
 	}
 	return entityIds;
@@ -1014,7 +909,6 @@ function getEntitiesByLabel(labelId) {
 	for (const [entityId, entry] of Object.entries(state.entityRegistry)) if (entry.labels?.includes(labelId)) entityIds.push(entityId);
 	return entityIds;
 }
-
 //#endregion
 //#region src/query/memoization.ts
 /**
@@ -1035,7 +929,6 @@ function buildQuerySignature(query) {
 function memoizedExecute(_signature, compute) {
 	return compute();
 }
-
 //#endregion
 //#region src/query/projections.ts
 /**
@@ -1044,8 +937,8 @@ function memoizedExecute(_signature, compute) {
 * @param entities - Array of entity views
 * @returns Array of entity IDs
 */
-function projectToIds(entities$1) {
-	return entities$1.map((e) => e.id);
+function projectToIds(entities) {
+	return entities.map((e) => e.id);
 }
 /**
 * Pick specific fields from entities
@@ -1054,10 +947,10 @@ function projectToIds(entities$1) {
 * @param keys - Array of field names to include
 * @returns Array of objects with only specified fields
 */
-function projectPick(entities$1, keys) {
-	return entities$1.map((entity$1) => {
+function projectPick(entities, keys) {
+	return entities.map((entity) => {
 		const result = {};
-		for (const key of keys) result[key] = entity$1[key];
+		for (const key of keys) result[key] = entity[key];
 		return result;
 	});
 }
@@ -1070,8 +963,8 @@ function projectPick(entities$1, keys) {
 * @param key - Field name or dot-path to extract
 * @returns Array of field values
 */
-function projectPluck(entities$1, key) {
-	return entities$1.map((entity$1) => getNestedValue(entity$1, key));
+function projectPluck(entities, key) {
+	return entities.map((entity) => getNestedValue(entity, key));
 }
 /**
 * Map entities using a custom function
@@ -1080,8 +973,8 @@ function projectPluck(entities$1, key) {
 * @param mapper - Function to transform each entity
 * @returns Array of mapped values
 */
-function projectMap(entities$1, mapper) {
-	return entities$1.map(mapper);
+function projectMap(entities, mapper) {
+	return entities.map(mapper);
 }
 /**
 * Get nested value from object using dot-notation
@@ -1100,12 +993,11 @@ function getNestedValue(obj, path) {
 	const parts = path.split(".");
 	let current = obj;
 	for (const part of parts) {
-		if (current === null || current === void 0) return void 0;
+		if (current === null || current === void 0) return;
 		current = current[part];
 	}
 	return current;
 }
-
 //#endregion
 //#region src/query/builder.ts
 var EntitiesQueryBuilderImpl = class EntitiesQueryBuilderImpl {
@@ -1196,12 +1088,10 @@ var EntitiesQueryBuilderImpl = class EntitiesQueryBuilderImpl {
 		return this.clone({ distinct: key });
 	}
 	get() {
-		const signature = buildQuerySignature(this.queryState);
-		return memoizedExecute(signature, () => this.execute());
+		return memoizedExecute(buildQuerySignature(this.queryState), () => this.execute());
 	}
 	first() {
-		const results = this.get();
-		return results[0];
+		return this.get()[0];
 	}
 	subscribe(callback) {
 		callback(this.get());
@@ -1215,14 +1105,14 @@ var EntitiesQueryBuilderImpl = class EntitiesQueryBuilderImpl {
 	}
 	execute() {
 		const entityIds = this.getEntityIdsFromIndices();
-		let entities$1 = getEntityViews(entityIds);
-		for (const filter of this.queryState.predicateFilters) entities$1 = entities$1.filter(filter);
-		if (this.queryState.sorts.length > 0) entities$1 = this.sortEntities(entities$1);
-		if (this.queryState.distinct) entities$1 = this.applyDistinct(entities$1);
-		if (this.queryState.skip !== void 0) entities$1 = entities$1.slice(this.queryState.skip);
-		if (this.queryState.take !== void 0) entities$1 = entities$1.slice(0, this.queryState.take);
-		if (this.queryState.projection) return this.applyProjection(entities$1);
-		return entities$1;
+		let entities = getEntityViews(entityIds);
+		for (const filter of this.queryState.predicateFilters) entities = entities.filter(filter);
+		if (this.queryState.sorts.length > 0) entities = this.sortEntities(entities);
+		if (this.queryState.distinct) entities = this.applyDistinct(entities);
+		if (this.queryState.skip !== void 0) entities = entities.slice(this.queryState.skip);
+		if (this.queryState.take !== void 0) entities = entities.slice(0, this.queryState.take);
+		if (this.queryState.projection) return this.applyProjection(entities);
+		return entities;
 	}
 	getEntityIdsFromIndices() {
 		if (this.queryState.indexFilters.length === 0) return getAllEntityIds();
@@ -1249,8 +1139,8 @@ var EntitiesQueryBuilderImpl = class EntitiesQueryBuilderImpl {
 		}
 		return result;
 	}
-	sortEntities(entities$1) {
-		const sorted = [...entities$1];
+	sortEntities(entities) {
+		const sorted = [...entities];
 		sorted.sort((a, b) => {
 			for (const sort of this.queryState.sorts) {
 				const aVal = getNestedValue(a, sort.key);
@@ -1270,32 +1160,33 @@ var EntitiesQueryBuilderImpl = class EntitiesQueryBuilderImpl {
 		if (typeof a === "number" && typeof b === "number") return a - b;
 		return String(a).localeCompare(String(b));
 	}
-	applyProjection(entities$1) {
-		if (!this.queryState.projection) return entities$1;
+	applyProjection(entities) {
+		if (!this.queryState.projection) return entities;
 		switch (this.queryState.projection.type) {
-			case "ids": return projectToIds(entities$1);
-			case "pick": return projectPick(entities$1, this.queryState.projection.keys);
-			case "pluck": return projectPluck(entities$1, this.queryState.projection.key);
-			case "map": return projectMap(entities$1, this.queryState.projection.mapper);
-			default: return entities$1;
+			case "ids": return projectToIds(entities);
+			case "pick": return projectPick(entities, this.queryState.projection.keys);
+			case "pluck": return projectPluck(entities, this.queryState.projection.key);
+			case "map": return projectMap(entities, this.queryState.projection.mapper);
+			default: return entities;
 		}
 	}
-	applyDistinct(entities$1) {
-		if (!this.queryState.distinct) return entities$1;
+	applyDistinct(entities) {
+		if (!this.queryState.distinct) return entities;
 		const seen = /* @__PURE__ */ new Set();
 		const result = [];
-		for (const entity$1 of entities$1) {
-			const value = getNestedValue(entity$1, this.queryState.distinct);
+		for (const entity of entities) {
+			const value = getNestedValue(entity, this.queryState.distinct);
 			const key = JSON.stringify(value);
 			if (!seen.has(key)) {
 				seen.add(key);
-				result.push(entity$1);
+				result.push(entity);
 			}
 		}
 		return result;
 	}
 };
 var EntityQueryBuilderImpl = class {
+	entityId;
 	constructor(entityId) {
 		this.entityId = entityId;
 	}
@@ -1323,7 +1214,6 @@ function entities() {
 function entity(entityId) {
 	return new EntityQueryBuilderImpl(entityId);
 }
-
 //#endregion
 //#region src/query/helpers.ts
 /**
@@ -1345,9 +1235,13 @@ function entitiesByAreaAndDomain(areaId, domain) {
 function entitiesWhere(predicate) {
 	return entities().where(predicate);
 }
-
 //#endregion
 //#region src/camera/fetch.ts
+/**
+* Camera Stream Fetching
+*
+* @packageDocumentation
+*/
 /** Public HLS test stream for demo/disconnected mode */
 const DEMO_HLS_STREAM = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8";
 /**
@@ -1357,12 +1251,11 @@ const DEMO_HLS_STREAM = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8";
 async function fetchStream(entityId, format = "hls") {
 	if (isDemoMode()) return format === "hls" ? DEMO_HLS_STREAM : null;
 	if (!privilegedConn()) return null;
-	const response = await sendCommand({
+	return (await sendCommand({
 		type: "camera/stream",
 		entity_id: entityId,
 		format
-	});
-	return response?.url ?? null;
+	}))?.url ?? null;
 }
 /**
 * Transform relative stream URL to absolute URL
@@ -1376,8 +1269,7 @@ function transformStreamUrl(streamUrl) {
 			console.warn("[fetchStreamData] No Home Assistant URL available to resolve relative stream URL");
 			return streamUrl;
 		}
-		const baseUrl = hassUrl.replace(/\/$/, "");
-		return `${baseUrl}${streamUrl}`;
+		return `${hassUrl.replace(/\/$/, "")}${streamUrl}`;
 	}
 	return streamUrl;
 }
@@ -1387,49 +1279,48 @@ function transformStreamUrl(streamUrl) {
 async function fetchStreamData(entityId, options = {}) {
 	const { format = "hls" } = options;
 	try {
-		const streamUrl = await fetchStream(entityId, format);
-		const absoluteStreamUrl = transformStreamUrl(streamUrl);
-		const stream = {
-			url: absoluteStreamUrl,
-			loading: false,
-			error: null,
-			lastFetched: Date.now(),
-			format,
-			expiresAt: null
-		};
 		return {
 			entityId,
-			stream,
+			stream: {
+				url: transformStreamUrl(await fetchStream(entityId, format)),
+				loading: false,
+				error: null,
+				lastFetched: Date.now(),
+				format,
+				expiresAt: null
+			},
 			loading: false,
 			error: null,
 			lastFetched: Date.now()
 		};
 	} catch (error) {
-		const stream = {
-			url: null,
-			loading: false,
-			error: error instanceof Error ? error : new Error(String(error)),
-			lastFetched: null,
-			format,
-			expiresAt: null
-		};
 		return {
 			entityId,
-			stream,
+			stream: {
+				url: null,
+				loading: false,
+				error: error instanceof Error ? error : new Error(String(error)),
+				lastFetched: null,
+				format,
+				expiresAt: null
+			},
 			loading: false,
 			error: error instanceof Error ? error : new Error(String(error)),
 			lastFetched: null
 		};
 	}
 }
-
 //#endregion
 //#region src/camera/query.ts
-const DEFAULT_REFRESH_INTERVAL = 4 * 60 * 1e3;
+/**
+* Camera Stream Query Builder
+*
+* @packageDocumentation
+*/
+const DEFAULT_REFRESH_INTERVAL = 24e4;
 function needsStreamRefresh(streamData, refreshInterval = DEFAULT_REFRESH_INTERVAL) {
 	if (!streamData || !streamData.lastFetched) return true;
-	const age = Date.now() - streamData.lastFetched;
-	return age >= refreshInterval;
+	return Date.now() - streamData.lastFetched >= refreshInterval;
 }
 /**
 * Get stream for a camera entity
@@ -1442,9 +1333,9 @@ async function getStream(entityId, options = {}) {
 			format,
 			autoRefresh,
 			refreshInterval
-		}).then((streamData$1) => {
+		}).then((streamData) => {
 			setState(produce((s) => {
-				s.streams[entityId] = streamData$1;
+				s.streams[entityId] = streamData;
 			}));
 		});
 		return cached;
@@ -1468,7 +1359,6 @@ async function refreshStream(entityId, format = "hls") {
 	}));
 	return getStream(entityId, { format });
 }
-
 //#endregion
 //#region src/energy/prefs.ts
 function isRecord(value) {
@@ -1505,7 +1395,6 @@ async function fetchEnergyPreferences(connection) {
 		device_consumption: devices
 	};
 }
-
 //#endregion
 //#region src/media/url.ts
 /**
@@ -1529,7 +1418,6 @@ function hassMediaUrl(path) {
 	if (base) return `${base}?path=${encodeURIComponent(path)}`;
 	return state.hassUrl ? `${state.hassUrl}${path}` : path;
 }
-
 //#endregion
 //#region src/camera/webrtc.ts
 /**
@@ -1551,7 +1439,7 @@ async function getWebRtcClientConfig(entityId) {
 */
 function startWebRtcSession(entityId, sdpOffer, onCandidate) {
 	const conn = privilegedConn();
-	if (!conn) return Promise.reject(new Error("Not connected"));
+	if (!conn) return Promise.reject(/* @__PURE__ */ new Error("Not connected"));
 	return new Promise((resolve, reject) => {
 		const session = {
 			sessionId: null,
@@ -1561,7 +1449,7 @@ function startWebRtcSession(entityId, sdpOffer, onCandidate) {
 		const timeout = setTimeout(() => {
 			if (!answered) {
 				session.unsubscribe?.();
-				reject(new Error("WebRTC offer timed out"));
+				reject(/* @__PURE__ */ new Error("WebRTC offer timed out"));
 			}
 		}, 15e3);
 		conn.subscribeMessage((event) => {
@@ -1586,7 +1474,6 @@ function startWebRtcSession(entityId, sdpOffer, onCandidate) {
 					clearTimeout(timeout);
 					session.unsubscribe?.();
 					reject(new Error(event.message || event.code || "WebRTC offer failed"));
-					break;
 			}
 		}, {
 			type: "camera/webrtc/offer",
@@ -1613,17 +1500,21 @@ async function sendWebRtcCandidate(entityId, sessionId, candidate) {
 		candidate
 	});
 }
-
 //#endregion
 //#region src/weather/fetch.ts
 /**
+* Weather Forecast Fetching
+*
+* @packageDocumentation
+*/
+/**
 * In demo mode, derive forecasts from the entity's `forecast` attribute.
 * Hourly and daily are synthesised from the same source (daily entries
 * expanded into 12 hourly steps for the chart).
 */
 function buildDemoForecast(entityId, type) {
-	const entity$1 = state.entities[entityId];
-	const raw = entity$1?.attributes?.forecast ?? [];
+	const entity = state.entities[entityId];
+	const raw = entity?.attributes?.forecast ?? [];
 	if (raw.length === 0) return [];
 	if (type === "daily" || type === "twice_daily") return raw.map((d) => {
 		const templow = d.templow;
@@ -1651,7 +1542,7 @@ function buildDemoForecast(entityId, type) {
 		out.push({
 			datetime: dt.toISOString(),
 			temperature: Math.round((mid + Math.sin(phase) * swing) * 10) / 10,
-			condition: today?.condition ?? entity$1?.state ?? "cloudy"
+			condition: today?.condition ?? entity?.state ?? "cloudy"
 		});
 	}
 	return out;
@@ -1669,7 +1560,7 @@ async function fetchForecast(entityId, type) {
 		const timeout = setTimeout(() => {
 			if (!resolved && unsubscribe) {
 				resolved = true;
-				unsubscribe().then(() => reject(new Error("Forecast subscription timeout"))).catch(() => reject(new Error("Forecast subscription timeout")));
+				unsubscribe().then(() => reject(/* @__PURE__ */ new Error("Forecast subscription timeout"))).catch(() => reject(/* @__PURE__ */ new Error("Forecast subscription timeout")));
 			}
 		}, 1e4);
 		conn.subscribeMessage((event) => {
@@ -1732,11 +1623,10 @@ async function fetchForecasts(entityId, types) {
 */
 async function fetchForecastData(entityId, type) {
 	try {
-		const forecast = await fetchForecast(entityId, type);
 		return {
 			entityId,
 			type,
-			forecast,
+			forecast: await fetchForecast(entityId, type),
 			loading: false,
 			error: null,
 			lastFetched: Date.now()
@@ -1752,10 +1642,14 @@ async function fetchForecastData(entityId, type) {
 		};
 	}
 }
-
 //#endregion
 //#region src/weather/query.ts
 /**
+* Weather Forecast Query Builder
+*
+* @packageDocumentation
+*/
+/**
 * Get forecast for a single entity and type
 */
 async function getForecast(entityId, type) {
@@ -1870,12 +1764,11 @@ async function refreshForecasts(entityId, types) {
 	}));
 	return getForecasts(entityId, types);
 }
-
 //#endregion
 //#region src/worker/bridge-client.ts
-var BridgeNeedsAuthError = class extends Error {
+var BridgeInvalidAuthError = class extends Error {
 	constructor() {
-		super("No stored Home Assistant tokens; interactive sign-in required");
+		super("Home Assistant rejected the connection; an admin needs to sign in to Home Assistant again");
 	}
 };
 function createHaBridge(worker, events = {}) {
@@ -1899,12 +1792,13 @@ function createHaBridge(worker, events = {}) {
 		switch (msg.k) {
 			case "connect_result":
 				if (msg.ok) pendingConnect?.resolve();
-				else pendingConnect?.reject(msg.needsAuth ? new BridgeNeedsAuthError() : new Error(msg.error ?? "Connect failed"));
+				else pendingConnect?.reject(msg.reason === "invalid_auth" ? new BridgeInvalidAuthError() : new Error(msg.error ?? "Connect failed"));
 				pendingConnect = null;
 				break;
 			case "conn":
 				connState = msg.state;
 				events.onConnState?.(msg.state);
+				if (msg.reason === "invalid_auth") events.onInvalidAuth?.();
 				break;
 			case "ready_after_reconnect":
 				events.onReadyAfterReconnect?.();
@@ -1917,17 +1811,14 @@ function createHaBridge(worker, events = {}) {
 				else pending.reject(new Error(msg.error ?? "Request failed"));
 				break;
 			}
-			case "event": {
+			case "event":
 				subCallbacks.get(msg.id)?.(msg.payload);
 				for (const listener of rawListeners) listener(msg.payload);
 				break;
-			}
 			case "sub_end":
 				subCallbacks.delete(msg.id);
 				break;
-			case "denial":
-				events.onDenial?.(msg);
-				break;
+			case "denial": events.onDenial?.(msg);
 		}
 	};
 	function sendMessagePromise(message) {
@@ -1962,24 +1853,6 @@ function createHaBridge(worker, events = {}) {
 			});
 		};
 	}
-	const conn = {
-		connect: () => Promise.resolve(),
-		disconnect: () => post({ k: "disconnect" }),
-		get connected$() {
-			return connState === "connected";
-		},
-		authenticate: () => Promise.resolve(),
-		get authState() {
-			return connState === "connected" ? "authenticated" : "pending";
-		},
-		subscribeEvents: (callback, eventType) => Promise.resolve(subscribe("events", callback, eventType)),
-		subscribeMessage: (callback, message) => Promise.resolve(subscribe("message", callback, void 0, message)),
-		sendMessagePromise,
-		addEventListener: (handler) => {
-			rawListeners.add(handler);
-			return () => rawListeners.delete(handler);
-		}
-	};
 	return {
 		connect(opts) {
 			return new Promise((resolve, reject) => {
@@ -1990,7 +1863,6 @@ function createHaBridge(worker, events = {}) {
 				post({
 					k: "connect",
 					url: opts.url,
-					mode: opts.mode,
 					proxyWsPath: opts.proxyWsPath,
 					proxyTicket: opts.proxyTicket
 				});
@@ -1998,8 +1870,24 @@ function createHaBridge(worker, events = {}) {
 		},
 		disconnect: () => post({ k: "disconnect" }),
 		reconnect: () => post({ k: "reconnect" }),
-		clearTokens: () => post({ k: "clear_tokens" }),
-		conn,
+		conn: {
+			connect: () => Promise.resolve(),
+			disconnect: () => post({ k: "disconnect" }),
+			get connected$() {
+				return connState === "connected";
+			},
+			authenticate: () => Promise.resolve(),
+			get authState() {
+				return connState === "connected" ? "authenticated" : "pending";
+			},
+			subscribeEvents: (callback, eventType) => Promise.resolve(subscribe("events", callback, eventType)),
+			subscribeMessage: (callback, message) => Promise.resolve(subscribe("message", callback, void 0, message)),
+			sendMessagePromise,
+			addEventListener: (handler) => {
+				rawListeners.add(handler);
+				return () => rawListeners.delete(handler);
+			}
+		},
 		registerWidget(widgetId, caps) {
 			const channel = new MessageChannel();
 			post({
@@ -2034,7 +1922,6 @@ function createHaBridge(worker, events = {}) {
 		}
 	};
 }
-
 //#endregion
 //#region src/connection/bridged.ts
 /**
@@ -2058,10 +1945,10 @@ async function attachBridgeToStore(bridge, hassUrl, mediaProxyBase) {
 	await forceResubscribeCalendars();
 }
 /** Map worker connection-state messages onto the store. */
-function applyBridgeConnState(state$1) {
+function applyBridgeConnState(state) {
 	setState(produce((s) => {
-		s.connectionState = state$1;
-		if (state$1 === "connected") s.connectionError = null;
+		s.connectionState = state;
+		if (state === "connected") s.connectionError = null;
 	}));
 }
 /** Re-sync after the worker reports a completed reconnect. */
@@ -2077,16 +1964,38 @@ function detachBridgeFromStore() {
 		s.connectionState = "disconnected";
 	}));
 }
-
 //#endregion
 //#region src/host-api.ts
+/**
+* One-shot handoff of the host-only surface.
+*
+* The problem this solves: the host import map serves this package's entry to
+* every widget bundle, so everything exported there is callable by untrusted
+* widget code. But the host needs privileged operations from the same package —
+* connect the bridge, authenticate, disconnect — and it cannot import them
+* through a private subpath, because the store must be ONE instance shared with
+* widgets. An unserved subpath gets bundled into the host and forks the store
+* (finding 45); a served one is reachable by widgets again (finding 46). A
+* subpath cannot be both, so hiding is not available.
+*
+* So the surface stays on the shared entry and is protected by ORDER instead of
+* by visibility: `claimHostApi()` yields the API to its first caller and null to
+* everyone after. The host claims it while booting; widget bundles are fetched
+* and evaluated later, by which point there is nothing left to take.
+*
+* Why these members are dangerous in a widget's hands:
+* - attachBridgeToStore / createHaBridge: install a connection, i.e. replace the
+*   host's link with one the widget controls — every subsequent service call is
+*   intercepted and every entity the dashboard renders can be fabricated.
+* - disconnect / detachBridgeFromStore: drop the household's connection.
+* - loadDemoData / unloadDemoData: overwrite live state with fixtures.
+*/
 let unclaimed = {
 	attachBridgeToStore,
 	detachBridgeFromStore,
 	applyBridgeConnState,
 	reloadAfterBridgeReconnect,
 	createHaBridge,
-	authenticateWithOAuth,
 	disconnect,
 	loadDemoData,
 	unloadDemoData
@@ -2104,10 +2013,8 @@ function claimHostApi() {
 	unclaimed = null;
 	return api;
 }
-
 //#endregion
 //#region src/index.ts
 const VERSION = "0.2.1";
-
 //#endregion
-export { BridgeNeedsAuthError, DOMAINS_USE_LAST_UPDATED, LINE_ATTRIBUTES_TO_KEEP, MAX_HISTORY_POINTS, NEED_ATTRIBUTE_DOMAINS, VERSION, appendHistoryPoint, applyDemoServiceCall, area, areas, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, claimHostApi, createDemoFixtures, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, hassMediaUrl, historyStateToTimeline, isConnected, isDemoMode, isHistoryTracked, normalizeStatisticTime, refreshForecast, refreshForecasts, refreshStream, registerEntity, runHaBridgeWorker, searchEntities, sendCommand, sendWebRtcCandidate, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, untrackEntityHistory, updateEntity };
+export { BridgeInvalidAuthError, DOMAINS_USE_LAST_UPDATED, LINE_ATTRIBUTES_TO_KEEP, MAX_HISTORY_POINTS, NEED_ATTRIBUTE_DOMAINS, VERSION, appendHistoryPoint, applyDemoServiceCall, area, areas, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, claimHostApi, createDemoFixtures, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, hassMediaUrl, historyStateToTimeline, isConnected, isDemoMode, isHistoryTracked, normalizeStatisticTime, refreshForecast, refreshForecasts, refreshStream, registerEntity, runHaBridgeWorker, searchEntities, sendCommand, sendWebRtcCandidate, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, untrackEntityHistory, updateEntity };