@glasshome/sync-layer 0.1.10 → 0.1.12

package/dist/connection/manager.d.ts

@@ -36,6 +36,13 @@ export declare function getConnection(): Connection | null;
  * Check if currently connected
  */
 export declare function isConnected(): boolean;
+/**
+ * Get the underlying socket's connected flag.
+ *
+ * Exposed so apps can render a connection indicator in the UI. Distinct from
+ * `isConnected()` which reflects the manager's internal lifecycle state.
+ */
+export declare function getConnectionState(): boolean;
 /**
  * Refresh all data
  */

package/dist/core/types.d.ts

@@ -175,8 +175,13 @@ export interface EntityView {
     domain: EntityDomain;
     /** Current state value */
     state: string;
-    /** Entity attributes */
-    attributes: Record<string, any>;
+    /**
+     * Entity attributes from Home Assistant, excluding keys that are
+     * surfaced as canonical resolved fields elsewhere on EntityView
+     * (`deviceClass`, `unitOfMeasurement`, `friendlyName`, `icon`).
+     * Use those fields instead of reaching into `attributes`.
+     */
+    attributes: Omit<Record<string, any>, "device_class" | "unit_of_measurement" | "friendly_name" | "icon">;
     lastChanged: Date;
     lastUpdated: Date;
     /** Event context */

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  */
 export { addDebugIncomingMessageListener, addDebugOutgoingMessageListener, } from "./connection/adapter";
 export type { ConnectionOptions } from "./connection/manager";
-export { disconnect, getConnection, initConnection, isConnected } from "./connection/manager";
+export { disconnect, getConnection, getConnectionState, initConnection, isConnected, } from "./connection/manager";
 export { registerEntity } from "./connection/subscription-manager";
 export type { SyncLayerConnection } from "./connection/types";
 export type { OAuthOptions } from "./connection/auth";

package/dist/index.js

@@ -1154,6 +1154,85 @@ 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 heartbeatInterval = null;
+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);
+		suspendTimeout = null;
+	}
+}
+function resolveVisiblePromise() {
+	if (visiblePromiseResolve) {
+		visiblePromiseResolve();
+		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);
+	visibilityHandler = null;
+	pageshowHandler = null;
+	clearSuspendTimeout();
+	resolveVisiblePromise();
+}
 /**
 * Initialize connection to Home Assistant
 */
@@ -1180,6 +1259,8 @@ async function initConnection(options) {
 		setupEventHandlers(conn$1, options);
 		await loadInitialData(conn$1);
 		await subscribeToUpdates(wrappedConn);
+		setupLifecycleListeners(conn$1);
+		startHeartbeat(conn$1);
 		options.onConnect?.();
 		return conn$1;
 	} catch (error) {
@@ -1197,6 +1278,8 @@ async function initConnection(options) {
 */
 function disconnect() {
 	const conn$1 = state.conn;
+	stopHeartbeat();
+	teardownLifecycleListeners();
 	if (conn$1) conn$1.close();
 	setState(produce((s) => {
 		s.conn = null;
@@ -1215,6 +1298,16 @@ function getConnection() {
 function isConnected() {
 	return state.connectionState === "connected";
 }
+/**
+* Get the underlying socket's connected flag.
+*
+* Exposed so apps can render a connection indicator in the UI. Distinct from
+* `isConnected()` which reflects the manager's internal lifecycle state.
+*/
+function getConnectionState() {
+	const conn$1 = state.conn;
+	return conn$1 ? conn$1.connected : false;
+}
 function setupEventHandlers(conn$1, options) {
 	conn$1.addEventListener("disconnected", () => {
 		setState(produce((s) => {
@@ -1304,6 +1397,7 @@ function buildEntityView(entity$1, registry) {
 	const friendlyName = entity$1.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 } = entity$1.attributes;
 	let areaId = registry?.area_id ?? null;
 	if (areaId === null && registry?.device_id) {
 		const device = state.devices[registry.device_id];
@@ -1313,7 +1407,7 @@ function buildEntityView(entity$1, registry) {
 		id: entity$1.entity_id,
 		domain,
 		state: entity$1.state,
-		attributes: entity$1.attributes,
+		attributes: restAttributes,
 		lastChanged: new Date(entity$1.last_changed),
 		lastUpdated: new Date(entity$1.last_updated),
 		context: {
@@ -2416,4 +2510,4 @@ async function refreshForecasts(entityId, types) {
 const VERSION = "0.1.0";
 
 //#endregion
-export { DOMAINS_USE_LAST_UPDATED, LINE_ATTRIBUTES_TO_KEEP, NEED_ATTRIBUTE_DOMAINS, VERSION, addDebugIncomingMessageListener, addDebugOutgoingMessageListener, appendHistoryPoint, applyDemoServiceCall, area, areas, authenticateWithOAuth, authenticateWithToken, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, createDemoFixtures, disconnect, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnection, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, historyStateToTimeline, initConnection, isAuthValid, isConnected, isDemoMode, isHistoryTracked, loadDemoData, refreshAuth, refreshForecast, refreshForecasts, refreshStream, registerEntity, resetStore, searchEntities, sendCommand, sendWebRtcCandidate, setState, startWebRtcSession, state, toggle, trackEntityHistory, turnOff, turnOn, unloadDemoData, untrackEntityHistory, updateEntity };
+export { DOMAINS_USE_LAST_UPDATED, LINE_ATTRIBUTES_TO_KEEP, NEED_ATTRIBUTE_DOMAINS, VERSION, addDebugIncomingMessageListener, addDebugOutgoingMessageListener, appendHistoryPoint, applyDemoServiceCall, area, areas, authenticateWithOAuth, authenticateWithToken, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, createDemoFixtures, disconnect, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnection, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, historyStateToTimeline, initConnection, isAuthValid, isConnected, isDemoMode, isHistoryTracked, loadDemoData, refreshAuth, refreshForecast, refreshForecasts, refreshStream, registerEntity, resetStore, searchEntities, sendCommand, sendWebRtcCandidate, setState, startWebRtcSession, state, toggle, trackEntityHistory, turnOff, turnOn, unloadDemoData, untrackEntityHistory, updateEntity };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/sync-layer",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Type-safe, reactive state synchronization layer for Home Assistant",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "@glasshome/ha-types": "0.1.0",
+    "@glasshome/ha-types": "0.1.1",
     "solid-js": "^1.9.0"
   },
   "peerDependenciesMeta": {
@@ -53,7 +53,7 @@
     "home-assistant-js-websocket": "^9.6.0"
   },
   "devDependencies": {
-    "@glasshome/ha-types": "0.1.0",
+    "@glasshome/ha-types": "0.1.1",
     "@types/bun": "latest",
     "solid-js": "^1.9.0",
     "tsdown": "^0.2.0",