@glasshome/sync-layer 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export type { GlassHomeState } from "./core/store";
 export type { AreaId, AreaView, ConnectionState, DeviceId, DeviceView, EntityDomain, EntityId, EntityView, HassEntity, } from "./core/types";
 export { extractDomain } from "./core/types";
 export { resetStore, setState, state } from "./core/store";
-export type { CallServiceRequest, CoreEventType, Domain, EntityCategory, EntityRegistryEntry, EventStateChangedData, HAEvent, RegistryEntryDisabler, RegistryEntryHider, ServiceCall, ServiceName, WsCommandType, WsResult, } from "@glasshome/ha-types";
+export type { CallServiceRequest, CoreEventType, Domain, EntityCategory, EntityRegistryEntry, EventStateChangedData, HAEvent, HassConfig, HassUnitSystem, RegistryEntryDisabler, RegistryEntryHider, ServiceCall, ServiceName, WsCommandType, WsResult, } from "@glasshome/ha-types";
 export { fetchStream, fetchStreamData } from "./camera/fetch";
 export { getStream, refreshStream } from "./camera/query";
 export { fetchEnergyPreferences } from "./energy/prefs";
@@ -42,5 +42,5 @@ export type { EntityHistoryData, EntityHistoryQueryOptions, EntityHistoryResult,
 export { fetchForecast, fetchForecastData, fetchForecasts } from "./weather/fetch";
 export { getForecast, getForecasts, refreshForecast, refreshForecasts } from "./weather/query";
 export type { EntityForecastQueryOptions, ForecastQueryOptions, ForecastResult, ForecastsResult, ForecastType, WeatherForecast, WeatherForecastData, WeatherForecasts, WeatherForecastsData, } from "./weather/types";
-export { applyDemoServiceCall, createDemoFixtures, isDemoMode, loadDemoData, unloadDemoData, } from "./demo/demo-provider";
+export { applyDemoServiceCall, createDemoFixtures, isDemoMode, loadDemoData, startDemoEnergyTicker, stopDemoEnergyTicker, unloadDemoData, } from "./demo/demo-provider";
 export declare const VERSION = "0.1.0";

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createDemoFixtures, resetStore, setState, state } from "./demo-data-D1ofmMa4.js";
+import { ENERGY_ENTITY_IDS, createDemoFixtures, demoEnergyPreferences, energyEntityValue, formatEnergyState, isEnergyEntity, isSunUp, resetStore, setState, simulateEnergy, state, sunEvents, synthesizeEnergyHistory, synthesizeEnergyStatistics } from "./demo-data-CavpxBw3.js";
 import { callService as callService$1, createConnection, createLongLivedTokenAuth, getAuth } from "home-assistant-js-websocket";
 import { produce, reconcile } from "solid-js/store";
 
@@ -524,11 +524,13 @@ async function loadDemoData() {
 	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({}));
@@ -537,6 +539,54 @@ function unloadDemoData() {
 	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.
 *
@@ -564,10 +614,10 @@ function applyDemoServiceCall(_domain, service, _serviceData = {}, target = {})
 			else if (service === "unlock") e.state = "unlocked";
 			else if (service === "open_cover") {
 				e.state = "open";
-				e.attributes.current_position = 100;
+				if ("current_position" in e.attributes) e.attributes.current_position = 100;
 			} else if (service === "close_cover") {
 				e.state = "closed";
-				e.attributes.current_position = 0;
+				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";
@@ -585,7 +635,7 @@ function applyTurnOn(e, domain, serviceData = {}) {
 	} else if (domain === "media_player") e.state = "playing";
 	else if (domain === "cover") {
 		e.state = "open";
-		e.attributes.current_position = 100;
+		if ("current_position" in e.attributes) e.attributes.current_position = 100;
 	} else e.state = "on";
 }
 function applyTurnOff(e, domain) {
@@ -595,7 +645,7 @@ function applyTurnOff(e, domain) {
 	} else if (domain === "media_player") e.state = "paused";
 	else if (domain === "cover") {
 		e.state = "closed";
-		e.attributes.current_position = 0;
+		if ("current_position" in e.attributes) e.attributes.current_position = 0;
 	} else e.state = "off";
 }
 
@@ -734,6 +784,19 @@ function entityIdHistoryNeedsAttributes(entityId) {
 */
 async function fetchHistory(options) {
 	const { startTime, endTime, entityIds = [], includeStartTimeState = true, significantChangesOnly = true, minimalResponse = true, noAttributes: noAttributesOverride } = options;
+	if (isDemoMode()) {
+		const endMs = (endTime ?? /* @__PURE__ */ new Date()).getTime();
+		const result = {};
+		for (const id of entityIds) {
+			if (!isEnergyEntity(id)) continue;
+			result[id] = synthesizeEnergyHistory(id, startTime.getTime(), endMs).map((p) => ({
+				s: p.s,
+				a: {},
+				lu: p.lu
+			}));
+		}
+		return result;
+	}
 	const startTimeStr = startTime.toISOString();
 	const endTimeStr = endTime?.toISOString();
 	const noAttributes = noAttributesOverride ?? (entityIds.length === 0 ? false : !entityIds.some((entityId) => entityIdHistoryNeedsAttributes(entityId)));
@@ -969,6 +1032,10 @@ async function subscribeToUpdates(conn$1) {
 		handleStatisticsUpdate(event);
 	}, "recorder_5min_statistics_generated");
 	registrySubscriptions.push(() => statisticsSub());
+	const coreConfigSub = await conn$1.subscribeEvents(() => {
+		handleCoreConfigUpdate();
+	}, "core_config_updated");
+	registrySubscriptions.push(() => coreConfigSub());
 }
 /**
 * Clean up all active subscriptions
@@ -978,6 +1045,16 @@ async function cleanupSubscriptions() {
 	for (const unsub of subscriptions) await unsub();
 	registrySubscriptions = [];
 }
+async function handleCoreConfigUpdate() {
+	const conn$1 = state.conn;
+	if (!conn$1) return;
+	try {
+		const config = await conn$1.sendMessagePromise({ type: "get_config" });
+		if (config) setState("config", config);
+	} catch (error) {
+		console.error("Error refreshing core config:", error);
+	}
+}
 async function handleRegistryUpdate(event) {
 	const { action, entity_id } = event.data;
 	if (action === "create" || action === "update") {
@@ -1345,16 +1422,18 @@ function setupEventHandlers(conn$1, options) {
 }
 async function loadInitialData(conn$1) {
 	try {
-		const [states, entityRegistry, deviceRegistry, areaRegistry, floorRegistry, labelRegistry] = await Promise.all([
+		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: "config/label_registry/list" }),
+			conn$1.sendMessagePromise({ type: "get_config" })
 		]);
 		bulkUpdateEntities(states);
 		bulkUpdateEntityRegistry(entityRegistry);
+		setState("config", config);
 		setState(produce((s) => {
 			for (const device of deviceRegistry) s.devices[device.id] = device;
 			for (const areaApi of areaRegistry) {
@@ -2187,6 +2266,14 @@ function isRecord(value) {
 * configured".
 */
 async function fetchEnergyPreferences(connection) {
+	if (isDemoMode()) {
+		const prefs = demoEnergyPreferences();
+		return {
+			...prefs,
+			energy_sources: prefs.energy_sources,
+			device_consumption: prefs.device_consumption
+		};
+	}
 	let response;
 	try {
 		response = await connection.sendMessagePromise({ type: "energy/get_prefs" });
@@ -2336,6 +2423,13 @@ function normalizeStatisticValue(raw) {
 */
 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(),
@@ -2613,4 +2707,4 @@ async function refreshForecasts(entityId, types) {
 const VERSION = "0.1.0";
 
 //#endregion
-export { DOMAINS_USE_LAST_UPDATED, LINE_ATTRIBUTES_TO_KEEP, MAX_HISTORY_POINTS, 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, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnection, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, historyStateToTimeline, initConnection, isAuthValid, isConnected, isDemoMode, isHistoryTracked, loadDemoData, normalizeStatisticTime, 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, MAX_HISTORY_POINTS, 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, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnection, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, historyStateToTimeline, initConnection, isAuthValid, isConnected, isDemoMode, isHistoryTracked, loadDemoData, normalizeStatisticTime, refreshAuth, refreshForecast, refreshForecasts, refreshStream, registerEntity, resetStore, searchEntities, sendCommand, sendWebRtcCandidate, setState, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, unloadDemoData, untrackEntityHistory, updateEntity };

package/dist/solid/hooks.d.ts

@@ -10,6 +10,7 @@
  *
  * @packageDocumentation
  */
+import type { HassConfig, HassUnitSystem } from "@glasshome/ha-types";
 import type { Accessor, Resource } from "solid-js";
 import type { AreaView, CameraStreamData, ConnectionState, EntityHistoryData, EntityView, GlassHomeState, HassEntity, StatisticsQueryOptions, StatisticValue, WeatherForecastsData } from "@glasshome/sync-layer";
 import { callService, toggle, turnOff, turnOn } from "@glasshome/sync-layer";
@@ -39,6 +40,16 @@ export declare function useConnection(): {
     status: Accessor<ConnectionState>;
     isConnected: Accessor<boolean>;
 };
+/** Reactive Home Assistant core config (null until loaded). */
+export declare function useHassConfig(): Accessor<HassConfig | null>;
+/** Reactive HA unit system (length/mass/temperature/volume), or null until loaded. */
+export declare function useUnitSystem(): Accessor<HassUnitSystem | null>;
+/** Reactive temperature unit from HA config, including the degree sign. Defaults to "°C". */
+export declare function useTemperatureUnit(): Accessor<string>;
+/** Reactive UI locale (BCP 47 tag) from HA config. Defaults to "en". */
+export declare function useLocale(): Accessor<string>;
+/** Reactive currency (ISO 4217) from HA config. Defaults to "USD". */
+export declare function useCurrency(): Accessor<string>;
 /**
  * Get all service call functions.
  */

package/dist/solid/index.d.ts

@@ -6,5 +6,5 @@
  *
  * @packageDocumentation
  */
-export { useArea, useAreas, useCamera, useConnection, useEntities, useEntity, useEntityHistory, useEntityState, useEntityStatistics, useForecast, useService, useStore, useToggle, useTurnOff, useTurnOn, } from "./hooks";
+export { useArea, useAreas, useCamera, useConnection, useCurrency, useEntities, useEntity, useEntityHistory, useEntityState, useEntityStatistics, useForecast, useHassConfig, useLocale, useService, useStore, useTemperatureUnit, useToggle, useTurnOff, useTurnOn, useUnitSystem, } from "./hooks";
 export { allEntityIds, byArea, byDevice, byDomain, byFloor, byLabel, } from "./indices";

package/dist/solid/index.js

@@ -1,5 +1,5 @@
 import { createEffect, createMemo, createResource, onCleanup } from "solid-js";
-import { buildAreaView, callService, entityViewEquals, extractDomain, fetchStatisticsDuringPeriod, getEntityView, registerEntity, state, toggle, turnOff, turnOn } from "@glasshome/sync-layer";
+import { buildAreaView, callService, entityViewEquals, extractDomain, fetchStatisticsDuringPeriod, getEntityView, isDemoMode, registerEntity, state, toggle, turnOff, turnOn } from "@glasshome/sync-layer";
 
 //#region src/solid/hooks.ts
 /**
@@ -69,6 +69,26 @@ function useConnection() {
 		isConnected
 	};
 }
+/** Reactive Home Assistant core config (null until loaded). */
+function useHassConfig() {
+	return createMemo(() => state.config);
+}
+/** Reactive HA unit system (length/mass/temperature/volume), or null until loaded. */
+function useUnitSystem() {
+	return createMemo(() => state.config?.unit_system ?? null);
+}
+/** Reactive temperature unit from HA config, including the degree sign. Defaults to "°C". */
+function useTemperatureUnit() {
+	return createMemo(() => state.config?.unit_system.temperature ?? "°C");
+}
+/** Reactive UI locale (BCP 47 tag) from HA config. Defaults to "en". */
+function useLocale() {
+	return createMemo(() => state.config?.language || "en");
+}
+/** Reactive currency (ISO 4217) from HA config. Defaults to "USD". */
+function useCurrency() {
+	return createMemo(() => state.config?.currency || "USD");
+}
 /**
 * Get all service call functions.
 */
@@ -152,6 +172,13 @@ function useEntityHistory(entityId) {
 	return createMemo(() => state.history[getId()]);
 }
 /**
+* Connection stub for demo mode: the statistics fetcher's demo branch never
+* sends a message, so this only satisfies the signature.
+*/
+const DEMO_STATS_CONNECTION = { sendMessagePromise() {
+	return Promise.reject(new Error("demo mode: no connection"));
+} };
+/**
 * Get reactive long-term statistics for a statistic id.
 *
 * Fetches via `recorder/statistics_during_period` and re-fetches whenever the
@@ -167,8 +194,8 @@ function useEntityStatistics(statisticId, options) {
 	}), async ({ id, options: opts }) => {
 		if (!id) return [];
 		const conn = state.conn;
-		if (!conn) return [];
-		const result = await fetchStatisticsDuringPeriod(conn, [id], opts);
+		if (!conn && !isDemoMode()) return [];
+		const result = await fetchStatisticsDuringPeriod(conn ?? DEMO_STATS_CONNECTION, [id], opts);
 		return result[id] ?? [];
 	});
 	return data;
@@ -237,4 +264,4 @@ const byLabel = () => {
 const allEntityIds = () => Object.keys(state.entities);
 
 //#endregion
-export { allEntityIds, byArea, byDevice, byDomain, byFloor, byLabel, useArea, useAreas, useCamera, useConnection, useEntities, useEntity, useEntityHistory, useEntityState, useEntityStatistics, useForecast, useService, useStore, useToggle, useTurnOff, useTurnOn };
+export { allEntityIds, byArea, byDevice, byDomain, byFloor, byLabel, useArea, useAreas, useCamera, useConnection, useCurrency, useEntities, useEntity, useEntityHistory, useEntityState, useEntityStatistics, useForecast, useHassConfig, useLocale, useService, useStore, useTemperatureUnit, useToggle, useTurnOff, useTurnOn, useUnitSystem };

package/dist/testing/index.js

@@ -1,4 +1,4 @@
-import { createDemoFixtures, state } from "../demo-data-D1ofmMa4.js";
+import { createDemoFixtures, state } from "../demo-data-CavpxBw3.js";
 
 //#region src/testing/mock-behaviors/base.ts
 /**
@@ -601,6 +601,7 @@ var MockConnection = class {
 	messageIdCounter = 1;
 	autoReact;
 	reactionDelay;
+	configOverride;
 	serviceCalls = [];
 	sentCommands = [];
 	constructor(fixtures, latency = 0, options) {
@@ -608,6 +609,25 @@ var MockConnection = class {
 		this.latency = latency;
 		this.autoReact = options?.autoReact ?? true;
 		this.reactionDelay = options?.reactionDelay ?? 0;
+		this.configOverride = options?.config ?? {};
+	}
+	/** Replace the core config and fire core_config_updated (simulates HA Region change). */
+	setConfig(config) {
+		this.configOverride = {
+			...this.configOverride,
+			...config
+		};
+		this.emitEvent({
+			event_type: "core_config_updated",
+			data: {},
+			origin: "LOCAL",
+			time_fired: (/* @__PURE__ */ new Date(0)).toISOString(),
+			context: {
+				id: "mock",
+				parent_id: null,
+				user_id: null
+			}
+		});
 	}
 	/**
 	* Get connected state
@@ -807,7 +827,8 @@ var MockConnection = class {
 				internal_url: null,
 				currency: "USD",
 				country: null,
-				language: "en"
+				language: "en",
+				...this.configOverride
 			};
 			case "get_services": return {};
 			case "fire_event": {

package/dist/testing/mock.d.ts

@@ -5,7 +5,7 @@
  *
  * @packageDocumentation
  */
-import type { EntityRegistryEntry, HAEvent } from "@glasshome/ha-types";
+import type { EntityRegistryEntry, HassConfig, HAEvent } from "@glasshome/ha-types";
 import type { SyncLayerConnection } from "../connection/types";
 import type { HassEntity } from "../core/types";
 import type { AreaRegistryEntry, DeviceRegistryEntry, Fixtures } from "./types";
@@ -30,6 +30,7 @@ export declare class MockConnection implements SyncLayerConnection {
     private messageIdCounter;
     private autoReact;
     private reactionDelay;
+    private configOverride;
     serviceCalls: Array<{
         domain: string;
         service: string;
@@ -47,7 +48,11 @@ export declare class MockConnection implements SyncLayerConnection {
         autoReact?: boolean;
         /** Delay before emitting entity update events after service calls in ms (default: 0) */
         reactionDelay?: number;
+        /** Override fields of the get_config response (unit_system, language, currency, etc.) */
+        config?: Partial<HassConfig>;
     });
+    /** Replace the core config and fire core_config_updated (simulates HA Region change). */
+    setConfig(config: Partial<HassConfig>): void;
     /**
      * Get connected state
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/sync-layer",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "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.1",
+    "@glasshome/ha-types": "0.1.2",
     "solid-js": "^1.9.0"
   },
   "peerDependenciesMeta": {
@@ -53,7 +53,7 @@
     "home-assistant-js-websocket": "^9.6.0"
   },
   "devDependencies": {
-    "@glasshome/ha-types": "0.1.1",
+    "@glasshome/ha-types": "0.1.2",
     "@types/bun": "latest",
     "solid-js": "^1.9.0",
     "tsdown": "^0.2.0",