@glasshome/sync-layer 0.1.13 → 0.1.15

package/dist/energy/prefs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Energy Preferences Fetching
+ *
+ * Reads HA's energy dashboard config via `energy/get_prefs`.
+ *
+ * @packageDocumentation
+ */
+import type { SyncLayerConnection } from "../connection/types";
+/**
+ * An energy source entry. Only the fields the widgets read are typed; the
+ * rest is passthrough. HA emits one of several shapes keyed by `type`:
+ * - grid: `flow_from[].stat_energy_from`, `flow_to[].stat_energy_to`
+ * - solar: `stat_energy_from`
+ * - battery: `stat_energy_from`, `stat_energy_to`
+ */
+export interface EnergySource {
+    type: "grid" | "solar" | "battery" | "gas" | "water" | string;
+    stat_energy_from?: string;
+    stat_energy_to?: string;
+    flow_from?: Array<{
+        stat_energy_from: string;
+        [key: string]: unknown;
+    }>;
+    flow_to?: Array<{
+        stat_energy_to: string;
+        [key: string]: unknown;
+    }>;
+    [key: string]: unknown;
+}
+/** A device tracked on the energy dashboard. */
+export interface EnergyDeviceConsumption {
+    stat_consumption: string;
+    name?: string;
+    [key: string]: unknown;
+}
+/**
+ * HA energy dashboard preferences.
+ *
+ * Based on HA frontend: EnergyPreferences.
+ */
+export interface EnergyPreferences {
+    energy_sources: EnergySource[];
+    device_consumption: EnergyDeviceConsumption[];
+    [key: string]: unknown;
+}
+/** Connection surface used by energy prefs fetching. */
+type EnergyConnection = Pick<SyncLayerConnection, "sendMessagePromise">;
+/**
+ * Fetch the HA energy dashboard preferences.
+ *
+ * Returns `null` when no energy dashboard is configured (HA raises an error
+ * for `energy/get_prefs` in that case); callers treat `null` as "not
+ * configured".
+ */
+export declare function fetchEnergyPreferences(connection: EnergyConnection): Promise<EnergyPreferences | null>;
+export {};

package/dist/history/query.d.ts

@@ -7,6 +7,8 @@ export interface HistoryPoint {
     lastUpdated: number;
     lastChanged?: number;
 }
+/** Hard cap on retained points per entity timeline. */
+export declare const MAX_HISTORY_POINTS = 5760;
 /** Check if an entity has active history tracking. */
 export declare function isHistoryTracked(entityId: EntityId): boolean;
 /** Start tracking history for an entity. Fetches initial backfill. */

package/dist/history/statistics.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Long-term Statistics Fetching
+ *
+ * Reads HA's recorder long-term statistics via `recorder/statistics_during_period`.
+ *
+ * @packageDocumentation
+ */
+import type { SyncLayerConnection } from "../connection/types";
+/**
+ * A single statistics bucket for one statistic id.
+ *
+ * HA 2023.6+ omits columns that were not requested and may omit null
+ * columns, so every value field is optional. `start`/`end` are normalized
+ * to ms epoch numbers regardless of the version's wire format.
+ */
+export interface StatisticValue {
+    /** Bucket start (ms epoch) */
+    start: number;
+    /** Bucket end (ms epoch) */
+    end: number;
+    mean?: number;
+    sum?: number;
+    min?: number;
+    max?: number;
+    state?: number;
+    change?: number;
+}
+/** Aggregation period for statistics buckets. */
+export type StatisticsPeriod = "5minute" | "hour" | "day" | "week" | "month";
+/**
+ * Options for {@link fetchStatisticsDuringPeriod}.
+ */
+export interface StatisticsQueryOptions {
+    /** Start time (required) */
+    startTime: Date;
+    /** End time (optional, defaults to now on the HA side) */
+    endTime?: Date;
+    /** Aggregation period */
+    period: StatisticsPeriod;
+}
+/** Connection surface used by statistics fetching. */
+type StatisticsConnection = Pick<SyncLayerConnection, "sendMessagePromise">;
+/**
+ * HA returns start/end as ISO strings or ms numbers depending on version.
+ * Normalize both shapes to ms epoch numbers; unparseable values become NaN.
+ */
+export declare function normalizeStatisticTime(value: unknown): number;
+/**
+ * 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`.
+ */
+export declare function fetchStatisticsDuringPeriod(connection: StatisticsConnection, statisticIds: string[], options: StatisticsQueryOptions): Promise<Record<string, StatisticValue[]>>;
+export {};

package/dist/index.d.ts

@@ -23,20 +23,24 @@ 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";
+export type { EnergyDeviceConsumption, EnergyPreferences, EnergySource, } from "./energy/prefs";
 export type { CameraStream, CameraStreamData, CameraStreams, EntityStreamQueryOptions, StreamFormat, StreamQueryOptions, StreamResult, } from "./camera/types";
 export { getWebRtcClientConfig, sendWebRtcCandidate, startWebRtcSession, } from "./camera/webrtc";
 export { buildAreaView, buildDeviceView, getAreaView, getAreaViews, } from "./entities/area-views";
 export { buildEntityView, entityViewEquals, getAllEntityViews, getEntityView, getEntityViews, } from "./entities/views";
 export { DOMAINS_USE_LAST_UPDATED, entityIdHistoryNeedsAttributes, LINE_ATTRIBUTES_TO_KEEP, NEED_ATTRIBUTE_DOMAINS, } from "./history/constants";
 export { fetchEntityHistory, fetchHistory, historyStateToTimeline } from "./history/fetch";
-export { appendHistoryPoint, bulkAppendHistoryPoints, isHistoryTracked, trackEntityHistory, untrackEntityHistory, } from "./history/query";
+export { appendHistoryPoint, bulkAppendHistoryPoints, isHistoryTracked, MAX_HISTORY_POINTS, trackEntityHistory, untrackEntityHistory, } from "./history/query";
 export type { HistoryPoint } from "./history/query";
+export { fetchStatisticsDuringPeriod, normalizeStatisticTime, } from "./history/statistics";
+export type { StatisticsPeriod, StatisticsQueryOptions, StatisticValue, } from "./history/statistics";
 export type { EntityHistoryData, EntityHistoryQueryOptions, EntityHistoryResult, EntityHistoryState, HistoryData, HistoryQueryOptions, HistoryResult, HistoryStates, TimelineState, } from "./history/types";
 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-C_sa1VWX.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.
 *
@@ -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)));
@@ -807,6 +870,8 @@ function historyStateToTimeline(s) {
 
 //#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();
 /** Check if an entity has active history tracking. */
@@ -860,6 +925,7 @@ function appendHistoryPoint(entityId, stateValue, attributes, lastUpdated, lastC
 function bulkAppendHistoryPoints(points) {
 	if (points.length === 0) return;
 	setState(produce((s) => {
+		const touched = /* @__PURE__ */ new Set();
 		for (const { entityId, stateValue, attributes, lastUpdated, lastChanged } of points) {
 			const history = s.history[entityId];
 			if (!history) continue;
@@ -876,6 +942,13 @@ function bulkAppendHistoryPoints(points) {
 				lastChanged,
 				lastUpdated
 			});
+			touched.add(entityId);
+		}
+		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);
 		}
 	}));
 }
@@ -959,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
@@ -968,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") {
@@ -1335,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) {
@@ -2164,6 +2253,43 @@ async function refreshStream(entityId, format = "hls") {
 	return getStream(entityId, { format });
 }
 
+//#endregion
+//#region src/energy/prefs.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* Fetch the HA energy dashboard preferences.
+*
+* Returns `null` when no energy dashboard is configured (HA raises an error
+* for `energy/get_prefs` in that case); callers treat `null` as "not
+* 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" });
+	} catch {
+		return null;
+	}
+	if (!isRecord(response)) return null;
+	const sources = Array.isArray(response.energy_sources) ? response.energy_sources.filter(isRecord) : [];
+	const devices = Array.isArray(response.device_consumption) ? response.device_consumption.filter(isRecord) : [];
+	return {
+		...response,
+		energy_sources: sources,
+		device_consumption: devices
+	};
+}
+
 //#endregion
 //#region src/camera/webrtc.ts
 /**
@@ -2248,6 +2374,77 @@ 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
 /**
@@ -2510,4 +2707,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, 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 };
+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,8 +10,9 @@
  *
  * @packageDocumentation
  */
-import type { Accessor } from "solid-js";
-import type { AreaView, CameraStreamData, ConnectionState, EntityHistoryData, EntityView, GlassHomeState, HassEntity, WeatherForecastsData } from "@glasshome/sync-layer";
+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";
 /**
  * Get a reactive EntityView for an entity ID.
@@ -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.
  */
@@ -71,6 +82,14 @@ export declare function useArea(areaId: Accessor<string> | string): Accessor<Are
  * this hook simply reads it reactively.
  */
 export declare function useEntityHistory(entityId: Accessor<string> | string): Accessor<EntityHistoryData | undefined>;
+/**
+ * Get reactive long-term statistics for a statistic id.
+ *
+ * Fetches via `recorder/statistics_during_period` and re-fetches whenever the
+ * statistic id or options change. The returned Resource exposes `.loading`
+ * and `.error` alongside the value accessor.
+ */
+export declare function useEntityStatistics(statisticId: Accessor<string> | string, options: Accessor<StatisticsQueryOptions> | StatisticsQueryOptions): Resource<StatisticValue[]>;
 /**
  * Get reactive camera stream data.
  */

package/dist/solid/index.d.ts

@@ -6,5 +6,5 @@
  *
  * @packageDocumentation
  */
-export { useArea, useAreas, useCamera, useConnection, useEntities, useEntity, useEntityHistory, useEntityState, 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, onCleanup } from "solid-js";
-import { buildAreaView, callService, entityViewEquals, extractDomain, getEntityView, registerEntity, state, toggle, turnOff, turnOn } from "@glasshome/sync-layer";
+import { createEffect, createMemo, createResource, onCleanup } from "solid-js";
+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,35 @@ 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
+* statistic id or options change. The returned Resource exposes `.loading`
+* and `.error` alongside the value accessor.
+*/
+function useEntityStatistics(statisticId, options) {
+	const getId = typeof statisticId === "function" ? statisticId : () => statisticId;
+	const getOptions = typeof options === "function" ? options : () => options;
+	const [data] = createResource(() => ({
+		id: getId(),
+		options: getOptions()
+	}), async ({ id, options: opts }) => {
+		if (!id) return [];
+		const conn = state.conn;
+		if (!conn && !isDemoMode()) return [];
+		const result = await fetchStatisticsDuringPeriod(conn ?? DEMO_STATS_CONNECTION, [id], opts);
+		return result[id] ?? [];
+	});
+	return data;
+}
+/**
 * Get reactive camera stream data.
 */
 function useCamera(entityId) {
@@ -215,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, 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-C_sa1VWX.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
      */