@glasshome/sync-layer 0.4.0 → 0.6.0

package/dist/index.js

@@ -1,112 +1,8 @@
-import { ENERGY_ENTITY_IDS, createDemoFixtures, demoEnergyPreferences, energyEntityValue, formatEnergyState, isEnergyEntity, isSunUp, resetStore, setState, simulateEnergy, state, sunEvents, synthesizeEnergyHistory, synthesizeEnergyStatistics } from "./demo-data-CcG2efdQ.js";
+import { applyDemoServiceCall, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, callService, createDemoFixtures, demoEnergyPreferences, entityViewEquals, extractDomain, fetchStatisticsDuringPeriod, forceResubscribe, 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-C6JQBDVf.js";
 import { runHaBridgeWorker } from "./worker-main-DTbzEKor.js";
-import { createConnection, createLongLivedTokenAuth, getAuth } from "home-assistant-js-websocket";
-import { produce, reconcile } from "solid-js/store";
+import { createConnection, getAuth } from "home-assistant-js-websocket";
+import { produce } from "solid-js/store";
 
-//#region src/connection/adapter.ts
-/**
-* Set of debug listeners for outgoing messages.
-* Supports multiple concurrent observers (e.g., WebSocket event recorder + network monitor).
-*/
-const debugOutgoingMessageListeners = /* @__PURE__ */ new Set();
-/**
-* Set of debug listeners for incoming messages.
-* Captures subscription callbacks and sendMessagePromise responses.
-*/
-const debugIncomingMessageListeners = /* @__PURE__ */ new Set();
-/**
-* Register a listener for all outgoing WebSocket messages.
-* Returns an unsubscribe function.
-*
-* @param listener - Function called with each outgoing message object
-* @returns Unsubscribe function to remove the listener
-*/
-function addDebugOutgoingMessageListener(listener) {
-	debugOutgoingMessageListeners.add(listener);
-	return () => {
-		debugOutgoingMessageListeners.delete(listener);
-	};
-}
-/**
-* Register a listener for all incoming WebSocket messages.
-* Returns an unsubscribe function. Receives subscription updates,
-* event callbacks, and sendMessagePromise responses.
-*
-* @param listener - Function called with each incoming message object
-* @returns Unsubscribe function to remove the listener
-*/
-function addDebugIncomingMessageListener(listener) {
-	debugIncomingMessageListeners.add(listener);
-	return () => {
-		debugIncomingMessageListeners.delete(listener);
-	};
-}
-function notifyOutgoingListeners(message) {
-	if (debugOutgoingMessageListeners.size > 0) for (const listener of debugOutgoingMessageListeners) listener(message);
-}
-function notifyIncomingListeners(message) {
-	if (debugIncomingMessageListeners.size > 0) for (const listener of debugIncomingMessageListeners) listener(message);
-}
-/**
-* Wrap HA Connection to SyncLayerConnection interface
-*
-* This adapter makes the real HA Connection compatible with our unified interface,
-* allowing it to be used interchangeably with MockConnection.
-*
-* @param conn - Home Assistant WebSocket connection
-* @returns Wrapped connection implementing SyncLayerConnection
-*
-* @example
-* ```typescript
-* const haConn = await createConnection({ auth });
-* const wrappedConn = wrapHAConnection(haConn);
-* await syncLayer.connect({ connection: wrappedConn });
-* ```
-*/
-function wrapHAConnection(conn$1) {
-	return {
-		connect: async () => {
-			return Promise.resolve();
-		},
-		disconnect: () => {
-			conn$1.close();
-		},
-		get connected$() {
-			return conn$1.connected;
-		},
-		authenticate: async () => {
-			return Promise.resolve();
-		},
-		get authState() {
-			return "authenticated";
-		},
-		subscribeEvents: async (callback, eventType) => {
-			const wrappedCallback = (event) => {
-				notifyIncomingListeners(event);
-				callback(event);
-			};
-			return conn$1.subscribeEvents(wrappedCallback, eventType);
-		},
-		subscribeMessage: async (callback, message) => {
-			const wrappedCallback = (msg) => {
-				notifyIncomingListeners(msg);
-				callback(msg);
-			};
-			return conn$1.subscribeMessage(wrappedCallback, message);
-		},
-		sendMessagePromise: async (message) => {
-			notifyOutgoingListeners(message);
-			const result = await conn$1.sendMessagePromise(message);
-			notifyIncomingListeners(result);
-			return result;
-		},
-		addEventListener: (handler) => {
-			return addDebugIncomingMessageListener(handler);
-		}
-	};
-}
-
-//#endregion
 //#region src/core/reducers.ts
 /**
 * Bulk update multiple entities
@@ -352,402 +248,6 @@ async function authenticateWithOAuth(options) {
 	});
 	return auth;
 }
-/**
-* Authenticate using a long-lived token
-*
-* @param url - Home Assistant instance URL
-* @param token - Long-lived access token
-* @returns Authenticated Auth object
-*
-* @example
-* ```typescript
-* const auth = authenticateWithToken(
-*   'https://homeassistant.local:8123',
-*   'your_long_lived_token'
-* );
-* ```
-*/
-function authenticateWithToken(url, token) {
-	return createLongLivedTokenAuth(url, token);
-}
-/**
-* Check if auth object is valid
-*
-* @param auth - Auth object to check
-* @returns True if auth is valid
-*/
-async function isAuthValid(auth) {
-	try {
-		await auth.refreshAccessToken();
-		return true;
-	} catch {
-		return false;
-	}
-}
-/**
-* Refresh auth tokens
-*
-* @param auth - Auth object to refresh
-* @returns Refreshed Auth object
-*/
-async function refreshAuth(auth) {
-	await auth.refreshAccessToken();
-	return auth;
-}
-
-//#endregion
-//#region src/connection/subscription-manager.ts
-if (globalThis.__GH_SYNC_LAYER_SUB_MGR__) console.error("[@glasshome/sync-layer] DUPLICATE subscription-manager module instantiated. registerEntity() and the connection setter will hit different singletons → subscribe_entities will never be sent. Cause: relative import of subscription-manager from a separate entry point.");
-globalThis.__GH_SYNC_LAYER_SUB_MGR__ = true;
-/** Ref counts — how many consumers need each entity */
-const refCounts = /* @__PURE__ */ new Map();
-/** Current HA subscription unsub function */
-let currentEntityUnsub = null;
-/** Snapshot of entity IDs in the current HA subscription */
-let subscribedIds = /* @__PURE__ */ new Set();
-/** Connection reference for resubscribing */
-let conn = null;
-/** Pending flush timer (microtask for register, timeout for unregister) */
-let flushScheduled = false;
-/** Delayed unregister timeout */
-let unregisterTimeout = null;
-/** Callback invoked on resubscribe — set by subscriptions.ts */
-let onResubscribe = null;
-/** Delay before unregistered entities are actually removed from subscription */
-const UNREGISTER_DELAY_MS = 5e3;
-/** Guard against concurrent flush() calls */
-let flushInFlight = false;
-/**
-* Register an entity for live updates. Returns an unregister function.
-* Call from useEntity/useEntities hooks via onCleanup.
-*/
-function registerEntity(entityId) {
-	refCounts.set(entityId, (refCounts.get(entityId) ?? 0) + 1);
-	scheduleFlush();
-	return () => unregisterEntity(entityId);
-}
-/**
-* Set the connection reference used for resubscribing.
-*/
-function setManagerConnection(connection) {
-	conn = connection;
-	if (refCounts.size > 0) scheduleFlush();
-}
-/**
-* Set the resubscribe callback. Called by subscriptions.ts to wire
-* the manager into the actual WS subscription lifecycle.
-*/
-function setResubscribeHandler(handler) {
-	onResubscribe = handler;
-}
-/**
-* Force a resubscribe with the current active set.
-* Used on reconnect.
-*/
-async function forceResubscribe() {
-	await flush();
-}
-function unregisterEntity(entityId) {
-	const count = (refCounts.get(entityId) ?? 1) - 1;
-	if (count <= 0) refCounts.delete(entityId);
-	else refCounts.set(entityId, count);
-	scheduleDelayedFlush();
-}
-function scheduleFlush() {
-	if (flushScheduled) return;
-	flushScheduled = true;
-	queueMicrotask(() => {
-		flushScheduled = false;
-		flush();
-	});
-}
-function scheduleDelayedFlush() {
-	if (unregisterTimeout) return;
-	unregisterTimeout = setTimeout(() => {
-		unregisterTimeout = null;
-		flush();
-	}, UNREGISTER_DELAY_MS);
-}
-async function flush() {
-	if (!conn || !onResubscribe) return;
-	if (flushInFlight) return;
-	flushInFlight = true;
-	try {
-		const newIds = new Set(refCounts.keys());
-		if (setsEqual(newIds, subscribedIds)) return;
-		const oldUnsub = currentEntityUnsub;
-		const entityIds = [...newIds];
-		currentEntityUnsub = await onResubscribe(conn, entityIds);
-		subscribedIds = newIds;
-		if (oldUnsub) try {
-			await oldUnsub();
-		} catch {}
-	} finally {
-		flushInFlight = false;
-	}
-}
-function setsEqual(a, b) {
-	if (a.size !== b.size) return false;
-	for (const id of a) if (!b.has(id)) return false;
-	return true;
-}
-
-//#endregion
-//#region src/core/types.ts
-/**
-* Extract domain from entity ID
-*/
-function extractDomain(entityId) {
-	return entityId.split(".")[0] ?? "";
-}
-
-//#endregion
-//#region src/demo/demo-provider.ts
-let _isDemoMode = false;
-/**
-* Whether demo mode is currently active.
-*/
-function isDemoMode() {
-	return _isDemoMode;
-}
-/**
-* Load demo fixtures into the SolidJS store.
-*
-* Populates entities, entity registry, areas, and devices.
-* Sets connection state to "connected" (pretend connected).
-*/
-async function loadDemoData() {
-	const fixtures = createDemoFixtures();
-	setState("entities", reconcile(fixtures.entities));
-	setState("entityRegistry", reconcile(fixtures.entityRegistry));
-	setState("areas", reconcile(fixtures.areas));
-	setState("devices", reconcile(fixtures.devices));
-	setState("hassUrl", "https://demo.home-assistant.local");
-	setState("connectionState", "connected");
-	_isDemoMode = true;
-	startDemoEnergyTicker();
-}
-/**
-* Unload demo data and reset to disconnected state.
-*/
-function unloadDemoData() {
-	stopDemoEnergyTicker();
-	setState("entities", reconcile({}));
-	setState("entityRegistry", reconcile({}));
-	setState("areas", reconcile({}));
-	setState("devices", reconcile({}));
-	setState("hassUrl", null);
-	setState("connectionState", "disconnected");
-	_isDemoMode = false;
-}
-const ENERGY_TICK_MS = 5e3;
-let _energyTicker = null;
-/** Write the current energy sample into the store as string states (like real HA). */
-function tickEnergy() {
-	const nowMs = Date.now();
-	const sample = simulateEnergy(nowMs);
-	const sun = sunEvents(nowMs);
-	const nowIso = new Date(nowMs).toISOString();
-	setState(produce((s) => {
-		for (const entityId of ENERGY_ENTITY_IDS) {
-			const e = s.entities[entityId];
-			if (!e) continue;
-			const value = energyEntityValue(entityId, sample);
-			if (value === void 0) continue;
-			const next = formatEnergyState(entityId, value);
-			if (e.state !== next) e.last_changed = nowIso;
-			e.state = next;
-			e.last_updated = nowIso;
-		}
-		const sunEntity = s.entities["sun.sun"];
-		if (sunEntity) {
-			const nextState = isSunUp(nowMs) ? "above_horizon" : "below_horizon";
-			if (sunEntity.state !== nextState) sunEntity.last_changed = nowIso;
-			sunEntity.state = nextState;
-			sunEntity.last_updated = nowIso;
-			sunEntity.attributes.elevation = sun.elevation;
-			sunEntity.attributes.next_rising = sun.nextRising;
-			sunEntity.attributes.next_setting = sun.nextSetting;
-		}
-	}));
-}
-/**
-* Start the demo energy ticker. Updates the energy sensors and `sun.sun`
-* every 5 seconds. Idempotent: clears any prior interval first. SSR-safe.
-*/
-function startDemoEnergyTicker() {
-	stopDemoEnergyTicker();
-	if (typeof setInterval !== "function") return;
-	tickEnergy();
-	_energyTicker = setInterval(tickEnergy, ENERGY_TICK_MS);
-}
-/** Stop the demo energy ticker if running. */
-function stopDemoEnergyTicker() {
-	if (_energyTicker !== null) {
-		clearInterval(_energyTicker);
-		_energyTicker = null;
-	}
-}
-/**
-* Apply an optimistic state update for demo mode.
-*
-* When a service call is made in demo mode, this updates the entity
-* state locally (no WebSocket message sent). State resets on page refresh.
-*/
-function applyDemoServiceCall(_domain, service, _serviceData = {}, target = {}) {
-	if (!_isDemoMode) return;
-	const entityIds = Array.isArray(target.entity_id) ? target.entity_id : target.entity_id ? [target.entity_id] : [];
-	for (const entityId of entityIds) {
-		const entity$1 = state.entities[entityId];
-		if (!entity$1) continue;
-		const entityDomain = extractDomain(entityId);
-		setState(produce((s) => {
-			const e = s.entities[entityId];
-			if (!e) return;
-			const now = (/* @__PURE__ */ new Date()).toISOString();
-			e.last_changed = now;
-			e.last_updated = now;
-			if (service === "turn_on") applyTurnOn(e, entityDomain, _serviceData);
-			else if (service === "turn_off") applyTurnOff(e, entityDomain);
-			else if (service === "toggle") if (e.state === "on" || e.state === "playing" || e.state === "open") applyTurnOff(e, entityDomain);
-			else applyTurnOn(e, entityDomain, _serviceData);
-			else if (service === "lock") e.state = "locked";
-			else if (service === "unlock") e.state = "unlocked";
-			else if (service === "open_cover") {
-				e.state = "open";
-				if ("current_position" in e.attributes) e.attributes.current_position = 100;
-			} else if (service === "close_cover") {
-				e.state = "closed";
-				if ("current_position" in e.attributes) e.attributes.current_position = 0;
-			} else if (service === "set_cover_position" && _serviceData.position != null) {
-				e.attributes.current_position = _serviceData.position;
-				e.state = _serviceData.position > 0 ? "open" : "closed";
-			} else if (service === "set_temperature" && _serviceData.temperature != null) e.attributes.temperature = _serviceData.temperature;
-			else if (service === "set_hvac_mode" && _serviceData.hvac_mode != null) e.state = _serviceData.hvac_mode;
-			else if (service === "volume_set" && _serviceData.volume_level != null) e.attributes.volume_level = _serviceData.volume_level;
-		}));
-	}
-}
-function applyTurnOn(e, domain, serviceData = {}) {
-	if (domain === "light") {
-		e.state = "on";
-		e.attributes.brightness = serviceData.brightness ?? e.attributes.brightness ?? 255;
-		if (serviceData.color_temp_kelvin) e.attributes.color_temp_kelvin = serviceData.color_temp_kelvin;
-	} else if (domain === "media_player") e.state = "playing";
-	else if (domain === "cover") {
-		e.state = "open";
-		if ("current_position" in e.attributes) e.attributes.current_position = 100;
-	} else e.state = "on";
-}
-function applyTurnOff(e, domain) {
-	if (domain === "light") {
-		e.state = "off";
-		delete e.attributes.brightness;
-	} else if (domain === "media_player") e.state = "paused";
-	else if (domain === "cover") {
-		e.state = "closed";
-		if ("current_position" in e.attributes) e.attributes.current_position = 0;
-	} else e.state = "off";
-}
-
-//#endregion
-//#region src/commands/service.ts
-/**
-* Call a Home Assistant service
-*/
-async function callService(domain, service, serviceData = {}, target = {}) {
-	const connection = state.conn;
-	if (!connection) {
-		applyDemoServiceCall(domain, service, serviceData, target);
-		return;
-	}
-	try {
-		const mockConnection = connection;
-		if (mockConnection && typeof mockConnection.callService === "function") await mockConnection.callService(domain, service, serviceData, target);
-		else await connection.sendMessagePromise({
-			type: "call_service",
-			domain,
-			service,
-			service_data: serviceData,
-			target
-		});
-	} catch (error) {
-		throw new Error(`Service call failed: ${error.message || String(error)}`);
-	}
-}
-/**
-* Turn on entity or entities
-*/
-async function turnOn(entityId, serviceData = {}) {
-	const firstEntityId = Array.isArray(entityId) ? entityId[0] : entityId;
-	if (!firstEntityId) throw new Error("Entity ID is required");
-	const domain = firstEntityId.split(".")[0];
-	if (!domain) throw new Error(`Invalid entity ID: ${firstEntityId}`);
-	await callService(domain, "turn_on", serviceData, { entity_id: entityId });
-}
-/**
-* Turn off entity or entities
-*/
-async function turnOff(entityId, serviceData = {}) {
-	const firstEntityId = Array.isArray(entityId) ? entityId[0] : entityId;
-	if (!firstEntityId) throw new Error("Entity ID is required");
-	const domain = firstEntityId.split(".")[0];
-	if (!domain) throw new Error(`Invalid entity ID: ${firstEntityId}`);
-	await callService(domain, "turn_off", serviceData, { entity_id: entityId });
-}
-/**
-* Toggle entity or entities
-*/
-async function toggle(entityId, serviceData = {}) {
-	const firstEntityId = Array.isArray(entityId) ? entityId[0] : entityId;
-	if (!firstEntityId) throw new Error("Entity ID is required");
-	const domain = firstEntityId.split(".")[0];
-	if (!domain) throw new Error(`Invalid entity ID: ${firstEntityId}`);
-	await callService(domain, "toggle", serviceData, { entity_id: entityId });
-}
-/**
-* Update entity registry entry
-*/
-async function updateEntity(entityId, updates) {
-	const connection = state.conn;
-	if (!connection) throw new Error("Not connected to Home Assistant. Call initConnection() first.");
-	try {
-		const result = await connection.sendMessagePromise({
-			type: "config/entity_registry/update",
-			entity_id: entityId,
-			...updates
-		});
-		if (result && typeof result === "object" && "_mockError" in result) throw new Error(`Entity registry entry not found: ${entityId}`);
-		return result;
-	} catch (error) {
-		if (error?.message && error.message.includes("Entity registry entry not found")) throw error;
-		throw new Error(`Entity update failed: ${error.message || String(error)}`);
-	}
-}
-/**
-* Send a generic WebSocket command
-*/
-async function sendCommand(command) {
-	const connection = state.conn;
-	if (!connection) throw new Error("Not connected");
-	try {
-		return await connection.sendMessagePromise(command);
-	} catch (error) {
-		throw new Error(`Command failed: ${error.message || String(error)}`);
-	}
-}
-/**
-* Execute multiple service calls in parallel
-*/
-async function batchServiceCalls(calls) {
-	await Promise.all(calls.map((call) => callService(call.domain, call.service, call.serviceData, call.target)));
-}
-/**
-* Execute multiple entity updates in parallel
-*/
-async function batchEntityUpdates(updates) {
-	return Promise.all(updates.map((u) => updateEntity(u.entityId, u.updates)));
-}
 
 //#endregion
 //#region src/history/constants.ts
@@ -1011,35 +511,35 @@ async function subscribeEntities(connection, entityIds) {
 /**
 * Subscribe to all relevant events from Home Assistant
 */
-async function subscribeToUpdates(conn$1) {
+async function subscribeToUpdates(conn) {
 	await cleanupSubscriptions();
-	setManagerConnection(conn$1);
+	setManagerConnection(conn);
 	setResubscribeHandler(subscribeEntities);
-	const registryUpdatedSub = await conn$1.subscribeEvents((event) => {
+	const registryUpdatedSub = await conn.subscribeEvents((event) => {
 		handleRegistryUpdate(event);
 	}, "entity_registry_updated");
 	registrySubscriptions.push(() => registryUpdatedSub());
-	const deviceRegistrySub = await conn$1.subscribeEvents((event) => {
+	const deviceRegistrySub = await conn.subscribeEvents((event) => {
 		handleDeviceRegistryUpdate(event);
 	}, "device_registry_updated");
 	registrySubscriptions.push(() => deviceRegistrySub());
-	const areaRegistrySub = await conn$1.subscribeEvents((event) => {
+	const areaRegistrySub = await conn.subscribeEvents((event) => {
 		handleAreaRegistryUpdate(event);
 	}, "area_registry_updated");
 	registrySubscriptions.push(() => areaRegistrySub());
-	const floorRegistrySub = await conn$1.subscribeEvents((event) => {
+	const floorRegistrySub = await conn.subscribeEvents((event) => {
 		handleFloorRegistryUpdate(event);
 	}, "floor_registry_updated");
 	registrySubscriptions.push(() => floorRegistrySub());
-	const labelRegistrySub = await conn$1.subscribeEvents((event) => {
+	const labelRegistrySub = await conn.subscribeEvents((event) => {
 		handleLabelRegistryUpdate(event);
 	}, "label_registry_updated");
 	registrySubscriptions.push(() => labelRegistrySub());
-	const statisticsSub = await conn$1.subscribeEvents((event) => {
+	const statisticsSub = await conn.subscribeEvents((event) => {
 		handleStatisticsUpdate(event);
 	}, "recorder_5min_statistics_generated");
 	registrySubscriptions.push(() => statisticsSub());
-	const coreConfigSub = await conn$1.subscribeEvents(() => {
+	const coreConfigSub = await conn.subscribeEvents(() => {
 		handleCoreConfigUpdate();
 	}, "core_config_updated");
 	registrySubscriptions.push(() => coreConfigSub());
@@ -1053,10 +553,10 @@ async function cleanupSubscriptions() {
 	registrySubscriptions = [];
 }
 async function handleCoreConfigUpdate() {
-	const conn$1 = state.conn;
-	if (!conn$1) return;
+	const conn = privilegedConn();
+	if (!conn) return;
 	try {
-		const config = await conn$1.sendMessagePromise({ type: "get_config" });
+		const config = await conn.sendMessagePromise({ type: "get_config" });
 		if (config) setState("config", config);
 	} catch (error) {
 		console.error("Error refreshing core config:", error);
@@ -1065,10 +565,10 @@ async function handleCoreConfigUpdate() {
 async function handleRegistryUpdate(event) {
 	const { action, entity_id } = event.data;
 	if (action === "create" || action === "update") {
-		const conn$1 = state.conn;
-		if (!conn$1) return;
+		const conn = privilegedConn();
+		if (!conn) return;
 		try {
-			const entry = await conn$1.sendMessagePromise({
+			const entry = await conn.sendMessagePromise({
 				type: "config/entity_registry/get",
 				entity_id
 			});
@@ -1081,10 +581,10 @@ async function handleRegistryUpdate(event) {
 async function handleDeviceRegistryUpdate(event) {
 	const { action, device_id } = event.data;
 	if (action === "create" || action === "update") {
-		const conn$1 = state.conn;
-		if (!conn$1) return;
+		const conn = privilegedConn();
+		if (!conn) return;
 		try {
-			const devices = await conn$1.sendMessagePromise({ type: "config/device_registry/list" });
+			const devices = await conn.sendMessagePromise({ type: "config/device_registry/list" });
 			const device = devices.find((d) => d.id === device_id);
 			if (device) updateDevice(device);
 		} catch (error) {
@@ -1095,10 +595,10 @@ async function handleDeviceRegistryUpdate(event) {
 async function handleAreaRegistryUpdate(event) {
 	const { action, area_id } = event.data;
 	if (action === "create" || action === "update") {
-		const conn$1 = state.conn;
-		if (!conn$1) return;
+		const conn = privilegedConn();
+		if (!conn) return;
 		try {
-			const areas$1 = await conn$1.sendMessagePromise({ type: "config/area_registry/list" });
+			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);
 		} catch (error) {
@@ -1109,10 +609,10 @@ async function handleAreaRegistryUpdate(event) {
 async function handleFloorRegistryUpdate(event) {
 	const { action, floor_id } = event.data;
 	if (action === "create" || action === "update") {
-		const conn$1 = state.conn;
-		if (!conn$1) return;
+		const conn = privilegedConn();
+		if (!conn) return;
 		try {
-			const floors = await conn$1.sendMessagePromise({ type: "config/floor_registry/list" });
+			const floors = await conn.sendMessagePromise({ type: "config/floor_registry/list" });
 			const floor = floors.find((f) => f.floor_id === floor_id);
 			if (floor) updateFloor(floor);
 		} catch (error) {
@@ -1123,10 +623,10 @@ async function handleFloorRegistryUpdate(event) {
 async function handleLabelRegistryUpdate(event) {
 	const { action, label_id } = event.data;
 	if (action === "create" || action === "update") {
-		const conn$1 = state.conn;
-		if (!conn$1) return;
+		const conn = privilegedConn();
+		if (!conn) return;
 		try {
-			const labels = await conn$1.sendMessagePromise({ type: "config/label_registry/list" });
+			const labels = await conn.sendMessagePromise({ type: "config/label_registry/list" });
 			const label = labels.find((l) => l.label_id === label_id);
 			if (label) updateLabel(label);
 		} catch (error) {
@@ -1137,10 +637,10 @@ async function handleLabelRegistryUpdate(event) {
 async function handleStatisticsUpdate(event) {
 	const { statistic_ids } = event.data;
 	if (!statistic_ids || statistic_ids.length === 0) return;
-	const conn$1 = state.conn;
-	if (!conn$1) return;
+	const conn = privilegedConn();
+	if (!conn) return;
 	try {
-		const metadata = await conn$1.sendMessagePromise({
+		const metadata = await conn.sendMessagePromise({
 			type: "recorder/get_statistics_metadata",
 			statistic_ids
 		});
@@ -1248,8 +748,6 @@ function applyStateDiff(s, entityId, diff) {
 
 //#endregion
 //#region src/connection/manager.ts
-const HEARTBEAT_INTERVAL_MS = 3e4;
-const HEARTBEAT_TIMEOUT_MS = 15e3;
 const SUSPEND_DELAY_MS = 5 * 60 * 1e3;
 let activeConn = null;
 let heartbeatInterval = null;
@@ -1257,18 +755,6 @@ let suspendTimeout = null;
 let visiblePromiseResolve = null;
 let visibilityHandler = null;
 let pageshowHandler = null;
-function promiseTimeout(ms, promise) {
-	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => reject(new Error("Promise timeout")), ms);
-		promise.then((value) => {
-			clearTimeout(timer);
-			resolve(value);
-		}, (err) => {
-			clearTimeout(timer);
-			reject(err);
-		});
-	});
-}
 function clearSuspendTimeout() {
 	if (suspendTimeout !== null) {
 		clearTimeout(suspendTimeout);
@@ -1281,45 +767,12 @@ function resolveVisiblePromise() {
 		visiblePromiseResolve = null;
 	}
 }
-function startHeartbeat(conn$1) {
-	stopHeartbeat();
-	heartbeatInterval = setInterval(() => {
-		promiseTimeout(HEARTBEAT_TIMEOUT_MS, conn$1.ping()).catch(() => {
-			conn$1.reconnect();
-		});
-	}, HEARTBEAT_INTERVAL_MS);
-}
 function stopHeartbeat() {
 	if (heartbeatInterval !== null) {
 		clearInterval(heartbeatInterval);
 		heartbeatInterval = null;
 	}
 }
-function setupLifecycleListeners(conn$1) {
-	if (typeof document === "undefined" || typeof window === "undefined") return;
-	teardownLifecycleListeners();
-	visibilityHandler = () => {
-		if (document.visibilityState === "hidden") {
-			const pending = new Promise((resolve) => {
-				visiblePromiseResolve = resolve;
-			});
-			conn$1.suspendReconnectUntil(pending);
-			clearSuspendTimeout();
-			suspendTimeout = setTimeout(() => {
-				conn$1.suspend();
-				suspendTimeout = null;
-			}, SUSPEND_DELAY_MS);
-		} else {
-			clearSuspendTimeout();
-			resolveVisiblePromise();
-		}
-	};
-	pageshowHandler = (event) => {
-		if (event.persisted) conn$1.reconnect();
-	};
-	document.addEventListener("visibilitychange", visibilityHandler);
-	window.addEventListener("pageshow", pageshowHandler);
-}
 function teardownLifecycleListeners() {
 	if (typeof document !== "undefined" && visibilityHandler) document.removeEventListener("visibilitychange", visibilityHandler);
 	if (typeof window !== "undefined" && pageshowHandler) window.removeEventListener("pageshow", pageshowHandler);
@@ -1329,47 +782,6 @@ function teardownLifecycleListeners() {
 	resolveVisiblePromise();
 }
 /**
-* Initialize connection to Home Assistant
-*/
-async function initConnection(options) {
-	try {
-		setState(produce((s) => {
-			s.connectionState = "connecting";
-			s.connectionError = null;
-		}));
-		let auth;
-		if (typeof options.auth === "string") auth = authenticateWithToken(options.url, options.auth);
-		else if (typeof options.auth === "object" && "clientId" in options.auth) auth = await authenticateWithOAuth(options.auth);
-		else auth = options.auth;
-		const conn$1 = await createConnection({
-			auth,
-			...options.createSocket ? { createSocket: options.createSocket } : {}
-		});
-		const wrappedConn = wrapHAConnection(conn$1);
-		activeConn = conn$1;
-		setState(produce((s) => {
-			s.conn = conn$1;
-			s.hassUrl = options.url.replace(/\/$/, "");
-			s.connectionState = "connected";
-		}));
-		setupEventHandlers(conn$1, options);
-		await loadInitialData(conn$1);
-		await subscribeToUpdates(wrappedConn);
-		setupLifecycleListeners(conn$1);
-		startHeartbeat(conn$1);
-		options.onConnect?.();
-		return conn$1;
-	} catch (error) {
-		const err = error instanceof Error ? error : new Error(String(error));
-		setState(produce((s) => {
-			s.connectionState = "error";
-			s.connectionError = err;
-		}));
-		options.onError?.(err);
-		throw err;
-	}
-}
-/**
 * Disconnect from Home Assistant
 */
 function disconnect() {
@@ -1378,17 +790,11 @@ function disconnect() {
 	activeConn?.close();
 	activeConn = null;
 	setState(produce((s) => {
-		s.conn = null;
+		setPrivilegedConn(null);
 		s.connectionState = "disconnected";
 	}));
 }
 /**
-* Get current connection link
-*/
-function getConnection() {
-	return state.conn;
-}
-/**
 * Check if currently connected
 */
 function isConnected() {
@@ -1403,41 +809,16 @@ function isConnected() {
 function getConnectionState() {
 	return activeConn ? activeConn.connected : state.connectionState === "connected";
 }
-function setupEventHandlers(conn$1, options) {
-	conn$1.addEventListener("disconnected", () => {
-		setState(produce((s) => {
-			s.connectionState = "disconnected";
-		}));
-		options.onDisconnect?.();
-	});
-	conn$1.addEventListener("reconnect-error", () => {
-		setState(produce((s) => {
-			s.connectionState = "reconnecting";
-		}));
-	});
-	conn$1.addEventListener("ready", async () => {
-		const wasReconnecting = state.connectionState === "reconnecting";
-		setState(produce((s) => {
-			s.connectionState = "connected";
-			s.connectionError = null;
-		}));
-		if (wasReconnecting) {
-			await loadInitialData(conn$1);
-			await forceResubscribe();
-			options.onReconnect?.();
-		}
-	});
-}
-async function loadInitialData(conn$1) {
+async function loadInitialData(conn) {
 	try {
 		const [states, entityRegistry, deviceRegistry, areaRegistry, floorRegistry, labelRegistry, config] = await Promise.all([
-			conn$1.sendMessagePromise({ type: "get_states" }),
-			conn$1.sendMessagePromise({ type: "config/entity_registry/list" }),
-			conn$1.sendMessagePromise({ type: "config/device_registry/list" }),
-			conn$1.sendMessagePromise({ type: "config/area_registry/list" }),
-			conn$1.sendMessagePromise({ type: "config/floor_registry/list" }),
-			conn$1.sendMessagePromise({ type: "config/label_registry/list" }),
-			conn$1.sendMessagePromise({ type: "get_config" })
+			conn.sendMessagePromise({ type: "get_states" }),
+			conn.sendMessagePromise({ type: "config/entity_registry/list" }),
+			conn.sendMessagePromise({ type: "config/device_registry/list" }),
+			conn.sendMessagePromise({ type: "config/area_registry/list" }),
+			conn.sendMessagePromise({ type: "config/floor_registry/list" }),
+			conn.sendMessagePromise({ type: "config/label_registry/list" }),
+			conn.sendMessagePromise({ type: "get_config" })
 		]);
 		bulkUpdateEntities(states);
 		bulkUpdateEntityRegistry(entityRegistry);
@@ -1470,223 +851,6 @@ async function loadInitialData(conn$1) {
 	}
 }
 
-//#endregion
-//#region src/entities/views.ts
-/**
-* Get icon for an entity from registry or attributes
-*/
-function resolveIcon(entity$1, registry) {
-	if (registry?.icon) return {
-		icon: registry.icon,
-		source: "registry"
-	};
-	if (entity$1.attributes?.icon) return {
-		icon: entity$1.attributes.icon,
-		source: "attribute"
-	};
-	return null;
-}
-/**
-* Build an EntityView from runtime state and registry metadata
-*/
-function buildEntityView(entity$1, registry) {
-	const domain = extractDomain(entity$1.entity_id);
-	const attributes = entity$1.attributes ?? {};
-	const friendlyName = attributes.friendly_name ?? registry?.name ?? entity$1.entity_id;
-	const name = registry?.name ?? friendlyName;
-	const iconResolution = resolveIcon(entity$1, registry);
-	const { device_class: _dc, unit_of_measurement: _uom, friendly_name: _fn, icon: _icon,...restAttributes } = attributes;
-	let areaId = registry?.area_id ?? null;
-	if (areaId === null && registry?.device_id) {
-		const device = state.devices[registry.device_id];
-		if (device) areaId = device.area_id ?? null;
-	}
-	return {
-		id: entity$1.entity_id,
-		domain,
-		state: entity$1.state,
-		attributes: restAttributes,
-		lastChanged: new Date(entity$1.last_changed),
-		lastUpdated: new Date(entity$1.last_updated),
-		context: {
-			id: entity$1.context?.id ?? "",
-			parentId: entity$1.context?.parent_id ?? null,
-			userId: entity$1.context?.user_id ?? null
-		},
-		name,
-		friendlyName,
-		areaId,
-		deviceId: registry?.device_id ?? null,
-		platform: registry?.platform ?? "unknown",
-		uniqueId: registry?.unique_id ?? null,
-		isDisabled: registry?.disabled_by !== null && registry?.disabled_by !== void 0,
-		isHidden: registry?.hidden_by !== null && registry?.hidden_by !== void 0,
-		icon: iconResolution?.icon ?? null,
-		iconSource: iconResolution?.source ?? "default",
-		entityCategory: registry?.entity_category ?? null,
-		labels: registry?.labels ?? [],
-		aliases: registry?.aliases ?? [],
-		deviceClass: registry?.device_class ?? attributes.device_class ?? null,
-		unitOfMeasurement: registry?.unit_of_measurement ?? attributes.unit_of_measurement ?? null,
-		supportedFeatures: registry?.supported_features ?? attributes.supported_features
-	};
-}
-/**
-* Get or build an EntityView
-*/
-function getEntityView(entityId) {
-	const entity$1 = state.entities[entityId];
-	if (!entity$1) return void 0;
-	const registry = state.entityRegistry[entityId];
-	return buildEntityView(entity$1, registry);
-}
-/**
-* Get multiple entity views
-*/
-function getEntityViews(entityIds) {
-	const views = [];
-	for (const id of entityIds) {
-		const view = getEntityView(id);
-		if (view) views.push(view);
-	}
-	return views;
-}
-/**
-* Get all entity views
-*/
-function getAllEntityViews() {
-	return getEntityViews(Object.keys(state.entities));
-}
-/**
-* Shallow equality check for EntityView.
-* Compares fields that affect rendering; skips lastUpdated (heartbeat noise).
-*/
-function entityViewEquals(a, b) {
-	if (a === b) return true;
-	if (!a || !b) return false;
-	return a.id === b.id && a.state === b.state && a.lastChanged.getTime() === b.lastChanged.getTime() && a.name === b.name && a.friendlyName === b.friendlyName && a.areaId === b.areaId && a.deviceId === b.deviceId && a.icon === b.icon && a.isDisabled === b.isDisabled && a.isHidden === b.isHidden && a.attributes === b.attributes;
-}
-
-//#endregion
-//#region src/entities/area-views.ts
-/** The area an entity belongs to: its own `area_id` wins; otherwise it inherits
-*  the area of its device. Null when neither resolves. */
-function entityAreaId(entry) {
-	if (entry.area_id) return entry.area_id;
-	if (entry.device_id) return state.devices[entry.device_id]?.area_id ?? null;
-	return null;
-}
-/** One pass over the device + entity registries → membership per area.
-*  O(devices + entities) for the whole home, vs the O(areas × (devices +
-*  entities)) of resolving each area independently. */
-function computeAreaMembership() {
-	const byArea = /* @__PURE__ */ new Map();
-	const ensure = (areaId) => {
-		let m = byArea.get(areaId);
-		if (!m) {
-			m = {
-				devices: [],
-				entityIds: []
-			};
-			byArea.set(areaId, m);
-		}
-		return m;
-	};
-	for (const device of Object.values(state.devices)) if (device.area_id) ensure(device.area_id).devices.push(device);
-	for (const [entityId, entry] of Object.entries(state.entityRegistry)) {
-		const areaId = entityAreaId(entry);
-		if (areaId) ensure(areaId).entityIds.push(entityId);
-	}
-	return byArea;
-}
-/** Membership for a single area, without indexing every other area. */
-function membershipFor(areaId) {
-	const devices = [];
-	for (const device of Object.values(state.devices)) if (device.area_id === areaId) devices.push(device);
-	const entityIds = [];
-	for (const [entityId, entry] of Object.entries(state.entityRegistry)) if (entityAreaId(entry) === areaId) entityIds.push(entityId);
-	return {
-		devices,
-		entityIds
-	};
-}
-/**
-* Build a DeviceView from registry data
-*/
-function buildDeviceView(device) {
-	return {
-		id: device.id,
-		name: device.name ?? "",
-		nameByUser: device.name_by_user ?? null,
-		manufacturer: device.manufacturer ?? null,
-		model: device.model ?? null,
-		swVersion: device.sw_version ?? null,
-		areaId: device.area_id ?? null,
-		configEntries: device.config_entries ?? [],
-		connections: device.connections ?? [],
-		identifiers: device.identifiers ?? [],
-		disabledBy: device.disabled_by ?? null
-	};
-}
-/** Assemble an AreaView from pre-resolved membership. `entities` is a lazy
-*  getter: materializing live EntityViews reads entity state, so deferring it
-*  keeps callers that only need names/ids/counts off the per-state-tick
-*  recompute path. The getter stays reactive — read inside a tracking scope it
-*  tracks those entities' state and updates like any other store read. */
-function assembleAreaView(areaId, membership) {
-	const area$1 = state.areas[areaId];
-	if (!area$1) throw new Error(`Area ${areaId} not found`);
-	const devices = membership.devices.map((device) => buildDeviceView(device));
-	const entityIds = membership.entityIds;
-	return {
-		id: areaId,
-		name: area$1.name,
-		normalizedName: area$1.normalized_name ?? area$1.name.toLowerCase(),
-		aliases: Array.isArray(area$1.aliases) ? area$1.aliases : [],
-		floorId: area$1.floor_id ?? null,
-		icon: area$1.icon ?? null,
-		picture: area$1.picture ?? null,
-		labels: Array.isArray(area$1.labels) ? area$1.labels : [],
-		temperatureEntityId: area$1.temperature_entity_id ?? null,
-		humidityEntityId: area$1.humidity_entity_id ?? null,
-		createdAt: area$1.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-		modifiedAt: area$1.modified_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-		devices,
-		entityIds,
-		deviceIds: devices.map((d) => d.id),
-		get entities() {
-			return entityIds.length > 0 ? getEntityViews(entityIds) : [];
-		}
-	};
-}
-/**
-* Build an AreaView for a single area from registry data.
-*/
-function buildAreaView(areaId) {
-	return assembleAreaView(areaId, membershipFor(areaId));
-}
-/**
-* Get all area views. Membership is resolved in a single registry pass; entity
-* views stay lazy per area (see `assembleAreaView`).
-*/
-function getAreaViews() {
-	const membership = computeAreaMembership();
-	return Object.keys(state.areas).map((areaId) => assembleAreaView(areaId, membership.get(areaId) ?? {
-		devices: [],
-		entityIds: []
-	}));
-}
-/**
-* Get area view
-*/
-function getAreaView(areaId) {
-	try {
-		return buildAreaView(areaId);
-	} catch {
-		return void 0;
-	}
-}
-
 //#endregion
 //#region src/query/area-builder.ts
 var AreaQueryBuilderImpl = class AreaQueryBuilderImpl {
@@ -2192,7 +1356,7 @@ 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 (!state.conn) return null;
+	if (!privilegedConn()) return null;
 	const response = await sendCommand({
 		type: "camera/stream",
 		entity_id: entityId,
@@ -2372,9 +1536,9 @@ function hassMediaUrl(path) {
 * Get WebRTC client configuration (STUN/TURN servers) from HA
 */
 async function getWebRtcClientConfig(entityId) {
-	const conn$1 = state.conn;
-	if (!conn$1) throw new Error("No connection available");
-	return conn$1.sendMessagePromise({
+	const conn = privilegedConn();
+	if (!conn) throw new Error("No connection available");
+	return conn.sendMessagePromise({
 		type: "camera/webrtc/get_client_config",
 		entity_id: entityId
 	});
@@ -2386,8 +1550,8 @@ async function getWebRtcClientConfig(entityId) {
 * Local ICE candidates should be sent via sendWebRtcCandidate().
 */
 function startWebRtcSession(entityId, sdpOffer, onCandidate) {
-	const conn$1 = state.conn;
-	if (!conn$1) return Promise.reject(new Error("Not connected"));
+	const conn = privilegedConn();
+	if (!conn) return Promise.reject(new Error("Not connected"));
 	return new Promise((resolve, reject) => {
 		const session = {
 			sessionId: null,
@@ -2400,7 +1564,7 @@ function startWebRtcSession(entityId, sdpOffer, onCandidate) {
 				reject(new Error("WebRTC offer timed out"));
 			}
 		}, 15e3);
-		conn$1.subscribeMessage((event) => {
+		conn.subscribeMessage((event) => {
 			switch (event.type) {
 				case "session":
 					session.sessionId = event.session_id ?? null;
@@ -2440,9 +1604,9 @@ function startWebRtcSession(entityId, sdpOffer, onCandidate) {
 * Send a local ICE candidate to HA
 */
 async function sendWebRtcCandidate(entityId, sessionId, candidate) {
-	const conn$1 = state.conn;
-	if (!conn$1) throw new Error("Not connected");
-	await conn$1.sendMessagePromise({
+	const conn = privilegedConn();
+	if (!conn) throw new Error("Not connected");
+	await conn.sendMessagePromise({
 		type: "camera/webrtc/candidate",
 		entity_id: entityId,
 		session_id: sessionId,
@@ -2450,77 +1614,6 @@ async function sendWebRtcCandidate(entityId, sessionId, candidate) {
 	});
 }
 
-//#endregion
-//#region src/history/statistics.ts
-const STATISTIC_TYPES = [
-	"mean",
-	"sum",
-	"min",
-	"max",
-	"state",
-	"change"
-];
-/**
-* HA returns start/end as ISO strings or ms numbers depending on version.
-* Normalize both shapes to ms epoch numbers; unparseable values become NaN.
-*/
-function normalizeStatisticTime(value) {
-	if (typeof value === "number") return value;
-	if (typeof value === "string") return new Date(value).getTime();
-	return NaN;
-}
-function normalizeNumber(value) {
-	return typeof value === "number" ? value : void 0;
-}
-function normalizeStatisticValue(raw) {
-	const value = {
-		start: normalizeStatisticTime(raw.start),
-		end: normalizeStatisticTime(raw.end)
-	};
-	const mean = normalizeNumber(raw.mean);
-	if (mean !== void 0) value.mean = mean;
-	const sum = normalizeNumber(raw.sum);
-	if (sum !== void 0) value.sum = sum;
-	const min = normalizeNumber(raw.min);
-	if (min !== void 0) value.min = min;
-	const max = normalizeNumber(raw.max);
-	if (max !== void 0) value.max = max;
-	const stateVal = normalizeNumber(raw.state);
-	if (stateVal !== void 0) value.state = stateVal;
-	const change = normalizeNumber(raw.change);
-	if (change !== void 0) value.change = change;
-	return value;
-}
-/**
-* Fetch long-term statistics for one or more statistic ids during a period.
-*
-* Statistic ids with no data are returned as empty arrays so callers never
-* hit `undefined`.
-*/
-async function fetchStatisticsDuringPeriod(connection, statisticIds, options) {
-	const { startTime, endTime, period } = options;
-	if (isDemoMode()) {
-		const result$1 = {};
-		const statPeriod = period === "hour" || period === "day" ? period : "day";
-		const endMs = (endTime ?? /* @__PURE__ */ new Date()).getTime();
-		for (const id of statisticIds) result$1[id] = isEnergyEntity(id) ? synthesizeEnergyStatistics(id, startTime.getTime(), endMs, statPeriod) : [];
-		return result$1;
-	}
-	const params = {
-		type: "recorder/statistics_during_period",
-		start_time: startTime.toISOString(),
-		statistic_ids: statisticIds,
-		period,
-		types: STATISTIC_TYPES
-	};
-	if (endTime) params.end_time = endTime.toISOString();
-	const response = await connection.sendMessagePromise(params);
-	const result = {};
-	for (const id of statisticIds) result[id] = [];
-	if (response && typeof response === "object") for (const [id, buckets] of Object.entries(response)) result[id] = Array.isArray(buckets) ? buckets.map(normalizeStatisticValue) : [];
-	return result;
-}
-
 //#endregion
 //#region src/weather/fetch.ts
 /**
@@ -2568,8 +1661,8 @@ function buildDemoForecast(entityId, type) {
 */
 async function fetchForecast(entityId, type) {
 	if (isDemoMode()) return buildDemoForecast(entityId, type);
-	const conn$1 = state.conn;
-	if (!conn$1) throw new Error("Not connected");
+	const conn = privilegedConn();
+	if (!conn) throw new Error("Not connected");
 	return new Promise((resolve, reject) => {
 		let resolved = false;
 		let unsubscribe = null;
@@ -2579,7 +1672,7 @@ async function fetchForecast(entityId, type) {
 				unsubscribe().then(() => reject(new Error("Forecast subscription timeout"))).catch(() => reject(new Error("Forecast subscription timeout")));
 			}
 		}, 1e4);
-		conn$1.subscribeMessage((event) => {
+		conn.subscribeMessage((event) => {
 			if (resolved) return;
 			if (event && typeof event === "object" && "forecast" in event) {
 				resolved = true;
@@ -2778,47 +1871,6 @@ async function refreshForecasts(entityId, types) {
 	return getForecasts(entityId, types);
 }
 
-//#endregion
-//#region src/connection/bridged.ts
-/**
-* Wire an HA bridge (worker-backed connection) into the store. The bridge's
-* facade rides the same load/subscribe pipeline as a direct socket; only the
-* lifecycle signals differ — they arrive as worker messages instead of
-* Connection events.
-*
-* Call after bridge.connect() resolved. Returns when initial data is loaded.
-*/
-async function attachBridgeToStore(bridge, hassUrl, mediaProxyBase) {
-	setState(produce((s) => {
-		s.conn = bridge.conn;
-		s.hassUrl = hassUrl.replace(/\/$/, "");
-		s.mediaProxyBase = mediaProxyBase ?? null;
-		s.connectionState = "connected";
-		s.connectionError = null;
-	}));
-	await loadInitialData(bridge.conn);
-	await subscribeToUpdates(bridge.conn);
-}
-/** Map worker connection-state messages onto the store. */
-function applyBridgeConnState(state$1) {
-	setState(produce((s) => {
-		s.connectionState = state$1;
-		if (state$1 === "connected") s.connectionError = null;
-	}));
-}
-/** Re-sync after the worker reports a completed reconnect. */
-async function reloadAfterBridgeReconnect(bridge) {
-	await loadInitialData(bridge.conn);
-	await forceResubscribe();
-}
-/** Detach on shutdown; the caller terminates the worker itself. */
-function detachBridgeFromStore() {
-	setState(produce((s) => {
-		s.conn = null;
-		s.connectionState = "disconnected";
-	}));
-}
-
 //#endregion
 //#region src/worker/bridge-client.ts
 var BridgeNeedsAuthError = class extends Error {
@@ -2910,7 +1962,7 @@ function createHaBridge(worker, events = {}) {
 			});
 		};
 	}
-	const conn$1 = {
+	const conn = {
 		connect: () => Promise.resolve(),
 		disconnect: () => post({ k: "disconnect" }),
 		get connected$() {
@@ -2947,7 +1999,7 @@ function createHaBridge(worker, events = {}) {
 		disconnect: () => post({ k: "disconnect" }),
 		reconnect: () => post({ k: "reconnect" }),
 		clearTokens: () => post({ k: "clear_tokens" }),
-		conn: conn$1,
+		conn,
 		registerWidget(widgetId, caps) {
 			const channel = new MessageChannel();
 			post({
@@ -2983,9 +2035,77 @@ function createHaBridge(worker, events = {}) {
 	};
 }
 
+//#endregion
+//#region src/connection/bridged.ts
+/**
+* Wire an HA bridge (worker-backed connection) into the store. The bridge's
+* facade rides the same load/subscribe pipeline as a direct socket; only the
+* lifecycle signals differ — they arrive as worker messages instead of
+* Connection events.
+*
+* Call after bridge.connect() resolved. Returns when initial data is loaded.
+*/
+async function attachBridgeToStore(bridge, hassUrl, mediaProxyBase) {
+	setState(produce((s) => {
+		setPrivilegedConn(bridge.conn);
+		s.hassUrl = hassUrl.replace(/\/$/, "");
+		s.mediaProxyBase = mediaProxyBase ?? null;
+		s.connectionState = "connected";
+		s.connectionError = null;
+	}));
+	await loadInitialData(bridge.conn);
+	await subscribeToUpdates(bridge.conn);
+}
+/** Map worker connection-state messages onto the store. */
+function applyBridgeConnState(state$1) {
+	setState(produce((s) => {
+		s.connectionState = state$1;
+		if (state$1 === "connected") s.connectionError = null;
+	}));
+}
+/** Re-sync after the worker reports a completed reconnect. */
+async function reloadAfterBridgeReconnect(bridge) {
+	await loadInitialData(bridge.conn);
+	await forceResubscribe();
+}
+/** Detach on shutdown; the caller terminates the worker itself. */
+function detachBridgeFromStore() {
+	setState(produce((s) => {
+		setPrivilegedConn(null);
+		s.connectionState = "disconnected";
+	}));
+}
+
+//#endregion
+//#region src/host-api.ts
+let unclaimed = {
+	attachBridgeToStore,
+	detachBridgeFromStore,
+	applyBridgeConnState,
+	reloadAfterBridgeReconnect,
+	createHaBridge,
+	authenticateWithOAuth,
+	disconnect,
+	loadDemoData,
+	unloadDemoData
+};
+/**
+* Take the host-only surface. Returns it once; null on every later call.
+*
+* Call it exactly once, during host boot, and keep the result in a module the
+* import map does not serve. Calling it from anywhere else is what this guards
+* against, so a null return means something already claimed it — treat that as
+* a fatal misconfiguration, not a retry.
+*/
+function claimHostApi() {
+	const api = unclaimed;
+	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, addDebugIncomingMessageListener, addDebugOutgoingMessageListener, appendHistoryPoint, applyBridgeConnState, applyDemoServiceCall, area, areas, attachBridgeToStore, authenticateWithOAuth, authenticateWithToken, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, createDemoFixtures, createHaBridge, detachBridgeFromStore, disconnect, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnection, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, hassMediaUrl, historyStateToTimeline, initConnection, isAuthValid, isConnected, isDemoMode, isHistoryTracked, loadDemoData, normalizeStatisticTime, refreshAuth, refreshForecast, refreshForecasts, refreshStream, registerEntity, reloadAfterBridgeReconnect, resetStore, runHaBridgeWorker, searchEntities, sendCommand, sendWebRtcCandidate, setState, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, unloadDemoData, untrackEntityHistory, updateEntity };
+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 };