@glasshome/sync-layer 0.1.0

package/dist/demo-data-D8JXWRpw.js

@@ -0,0 +1,419 @@
+//#region src/demo/demo-data.ts
+const now = (/* @__PURE__ */ new Date()).toISOString();
+let contextCounter = 0;
+function ctx() {
+	return {
+		id: `demo-${++contextCounter}`,
+		parent_id: null,
+		user_id: null
+	};
+}
+function makeEntity(entity_id, state, attributes = {}) {
+	return {
+		entity_id,
+		state,
+		attributes: {
+			friendly_name: friendlyName(entity_id),
+			...attributes
+		},
+		last_changed: now,
+		last_updated: now,
+		context: ctx()
+	};
+}
+function friendlyName(entityId) {
+	const objectId = entityId.split(".")[1] ?? entityId;
+	return objectId.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function makeRegistryEntry(entity_id, overrides = {}) {
+	const domain = entity_id.split(".")[0] ?? "";
+	return {
+		aliases: [],
+		area_id: null,
+		capabilities: null,
+		categories: {},
+		config_entry_id: "demo_config",
+		config_subentry_id: null,
+		created_at: now,
+		device_class: null,
+		device_id: null,
+		disabled_by: null,
+		entity_category: null,
+		entity_id,
+		has_entity_name: false,
+		hidden_by: null,
+		icon: null,
+		id: `reg-${entity_id.replace(".", "-")}`,
+		labels: [],
+		modified_at: now,
+		name: null,
+		options: {},
+		original_device_class: null,
+		original_icon: null,
+		original_name: null,
+		platform: domain === "weather" ? "met" : "demo",
+		previous_unique_id: null,
+		suggested_object_id: null,
+		supported_features: 0,
+		translation_key: null,
+		unique_id: `demo_${entity_id.replace(".", "_")}`,
+		unit_of_measurement: null,
+		...overrides
+	};
+}
+function makeDevice(id, name, areaId, manufacturer = "Demo", model = "Virtual") {
+	return {
+		id,
+		name,
+		name_by_user: null,
+		manufacturer,
+		model,
+		model_id: null,
+		sw_version: "1.0.0",
+		hw_version: null,
+		area_id: areaId,
+		config_entries: ["demo_config"],
+		config_entries_subentries: {},
+		configuration_url: null,
+		connections: [],
+		created_at: now,
+		disabled_by: null,
+		entry_type: null,
+		identifiers: [["demo", id]],
+		labels: [],
+		modified_at: now,
+		primary_config_entry: "demo_config",
+		serial_number: null,
+		via_device_id: null
+	};
+}
+function makeArea(id, name, floorId = "ground_floor") {
+	return {
+		id,
+		name,
+		normalized_name: name.toLowerCase().replace(/\s+/g, "_"),
+		created_at: now,
+		modified_at: now,
+		aliases: [],
+		floor_id: floorId,
+		humidity_entity_id: null,
+		icon: null,
+		labels: [],
+		picture: null,
+		temperature_entity_id: null
+	};
+}
+/**
+* Create ~30 curated apartment entity fixtures.
+*
+* Entities span lights, sensors, binary sensors, climate, covers,
+* locks, switches, media player, weather, camera, scenes, and buttons
+* across 4 areas: living_room, bedroom, kitchen, entry.
+*/
+function createDemoFixtures() {
+	contextCounter = 0;
+	const areas = {
+		living_room: makeArea("living_room", "Living Room"),
+		bedroom: makeArea("bedroom", "Bedroom"),
+		kitchen: makeArea("kitchen", "Kitchen"),
+		entry: makeArea("entry", "Entry")
+	};
+	areas.living_room.temperature_entity_id = "sensor.temperature_living";
+	areas.living_room.humidity_entity_id = "sensor.humidity_living";
+	const devices = {
+		living_room_lights: makeDevice("living_room_lights", "Living Room Lights", "living_room", "Philips", "Hue"),
+		kitchen_lights: makeDevice("kitchen_lights", "Kitchen Lights", "kitchen", "IKEA", "Tradfri"),
+		bedroom_lights: makeDevice("bedroom_lights", "Bedroom Lights", "bedroom", "Philips", "Hue"),
+		hallway_lights: makeDevice("hallway_lights", "Hallway Lights", "entry", "IKEA", "Tradfri"),
+		bathroom_lights: makeDevice("bathroom_lights", "Bathroom Lights", null),
+		thermostat_lr: makeDevice("thermostat_lr", "Living Room Thermostat", "living_room", "Nest", "Learning Thermostat"),
+		thermostat_br: makeDevice("thermostat_br", "Bedroom AC", "bedroom", "Daikin", "Split AC"),
+		blinds_lr: makeDevice("blinds_lr", "Living Room Blinds", "living_room", "Somfy", "Roller Shade"),
+		curtains_br: makeDevice("curtains_br", "Bedroom Curtains", "bedroom", "IKEA", "Fyrtur"),
+		lock_front: makeDevice("lock_front", "Front Door Lock", "entry", "Yale", "Assure Lock 2"),
+		lock_back: makeDevice("lock_back", "Back Door Lock", "entry", "August", "Smart Lock Pro"),
+		speaker_lr: makeDevice("speaker_lr", "Living Room Speaker", "living_room", "Sonos", "One"),
+		camera_front: makeDevice("camera_front", "Front Door Camera", "entry", "Ring", "Video Doorbell"),
+		door_sensor: makeDevice("door_sensor", "Front Door Sensor", "entry", "Aqara", "Door Sensor"),
+		motion_sensor: makeDevice("motion_sensor", "Hallway Motion Sensor", "entry", "Aqara", "Motion Sensor")
+	};
+	const entities = {};
+	const entityRegistry = {};
+	function add(e, regOverrides = {}) {
+		entities[e.entity_id] = e;
+		entityRegistry[e.entity_id] = makeRegistryEntry(e.entity_id, regOverrides);
+	}
+	add(makeEntity("light.living_room_main", "on", {
+		brightness: 179,
+		color_temp_kelvin: 3e3,
+		color_mode: "color_temp",
+		supported_color_modes: ["color_temp", "xy"]
+	}), {
+		device_id: "living_room_lights",
+		area_id: "living_room",
+		supported_features: 44
+	});
+	add(makeEntity("light.kitchen_counter", "off", { supported_color_modes: ["brightness"] }), {
+		device_id: "kitchen_lights",
+		area_id: "kitchen",
+		supported_features: 1
+	});
+	add(makeEntity("light.bedroom_ceiling", "on", {
+		brightness: 77,
+		color_temp_kelvin: 2700,
+		color_mode: "color_temp",
+		supported_color_modes: ["color_temp"]
+	}), {
+		device_id: "bedroom_lights",
+		area_id: "bedroom",
+		supported_features: 44
+	});
+	add(makeEntity("light.bathroom", "off", { supported_color_modes: ["brightness"] }), { device_id: "bathroom_lights" });
+	add(makeEntity("light.hallway", "on", {
+		brightness: 128,
+		color_mode: "brightness",
+		supported_color_modes: ["brightness"]
+	}), {
+		device_id: "hallway_lights",
+		area_id: "entry",
+		supported_features: 1
+	});
+	add(makeEntity("sensor.temperature_living", "22.5", {
+		unit_of_measurement: "°C",
+		device_class: "temperature",
+		state_class: "measurement"
+	}), {
+		area_id: "living_room",
+		device_class: "temperature",
+		unit_of_measurement: "°C"
+	});
+	add(makeEntity("sensor.humidity_living", "45", {
+		unit_of_measurement: "%",
+		device_class: "humidity",
+		state_class: "measurement"
+	}), {
+		area_id: "living_room",
+		device_class: "humidity",
+		unit_of_measurement: "%"
+	});
+	add(makeEntity("sensor.temperature_outdoor", "-2", {
+		unit_of_measurement: "°C",
+		device_class: "temperature",
+		state_class: "measurement"
+	}), {
+		device_class: "temperature",
+		unit_of_measurement: "°C"
+	});
+	add(makeEntity("sensor.power_consumption", "1.2", {
+		unit_of_measurement: "kW",
+		device_class: "power",
+		state_class: "measurement"
+	}), {
+		device_class: "power",
+		unit_of_measurement: "kW"
+	});
+	add(makeEntity("sensor.battery_door_sensor", "87", {
+		unit_of_measurement: "%",
+		device_class: "battery",
+		state_class: "measurement"
+	}), {
+		device_id: "door_sensor",
+		area_id: "entry",
+		device_class: "battery",
+		unit_of_measurement: "%"
+	});
+	add(makeEntity("binary_sensor.front_door", "off", { device_class: "door" }), {
+		device_id: "door_sensor",
+		area_id: "entry",
+		device_class: "door"
+	});
+	add(makeEntity("binary_sensor.motion_hallway", "off", { device_class: "motion" }), {
+		device_id: "motion_sensor",
+		area_id: "entry",
+		device_class: "motion"
+	});
+	add(makeEntity("binary_sensor.window_bedroom", "off", { device_class: "window" }), {
+		area_id: "bedroom",
+		device_class: "window"
+	});
+	add(makeEntity("climate.living_room_thermostat", "heat", {
+		temperature: 22,
+		current_temperature: 21.8,
+		hvac_modes: [
+			"off",
+			"heat",
+			"cool",
+			"auto"
+		],
+		hvac_action: "heating",
+		min_temp: 7,
+		max_temp: 35
+	}), {
+		device_id: "thermostat_lr",
+		area_id: "living_room",
+		supported_features: 385
+	});
+	add(makeEntity("climate.bedroom_ac", "off", {
+		temperature: 20,
+		current_temperature: 22.1,
+		hvac_modes: [
+			"off",
+			"cool",
+			"heat",
+			"dry",
+			"fan_only"
+		],
+		hvac_action: "idle",
+		min_temp: 16,
+		max_temp: 30
+	}), {
+		device_id: "thermostat_br",
+		area_id: "bedroom",
+		supported_features: 385
+	});
+	add(makeEntity("cover.living_room_blinds", "open", {
+		current_position: 80,
+		device_class: "shade"
+	}), {
+		device_id: "blinds_lr",
+		area_id: "living_room",
+		device_class: "shade",
+		supported_features: 15
+	});
+	add(makeEntity("cover.bedroom_curtains", "closed", {
+		current_position: 0,
+		device_class: "curtain"
+	}), {
+		device_id: "curtains_br",
+		area_id: "bedroom",
+		device_class: "curtain",
+		supported_features: 15
+	});
+	add(makeEntity("lock.front_door_lock", "locked", {}), {
+		device_id: "lock_front",
+		area_id: "entry",
+		supported_features: 1
+	});
+	add(makeEntity("lock.back_door_lock", "locked", {}), {
+		device_id: "lock_back",
+		area_id: "entry",
+		supported_features: 1
+	});
+	add(makeEntity("switch.coffee_machine", "off", { device_class: "outlet" }), {
+		area_id: "kitchen",
+		device_class: "outlet"
+	});
+	add(makeEntity("switch.fan_living_room", "on", { device_class: "switch" }), {
+		area_id: "living_room",
+		device_class: "switch"
+	});
+	add(makeEntity("media_player.living_room_speaker", "playing", {
+		media_title: "Lo-fi Beats",
+		media_artist: "Chill Station",
+		media_content_type: "music",
+		volume_level: .4,
+		is_volume_muted: false,
+		supported_features: 152461
+	}), {
+		device_id: "speaker_lr",
+		area_id: "living_room",
+		supported_features: 152461
+	});
+	add(makeEntity("weather.home_forecast", "partlycloudy", {
+		temperature: 3,
+		temperature_unit: "°C",
+		humidity: 72,
+		pressure: 1013,
+		pressure_unit: "hPa",
+		wind_speed: 12,
+		wind_speed_unit: "km/h",
+		wind_bearing: 220,
+		forecast: [
+			{
+				datetime: "2026-03-07T00:00:00Z",
+				condition: "cloudy",
+				temperature: 4,
+				templow: -1
+			},
+			{
+				datetime: "2026-03-08T00:00:00Z",
+				condition: "sunny",
+				temperature: 7,
+				templow: 1
+			},
+			{
+				datetime: "2026-03-09T00:00:00Z",
+				condition: "rainy",
+				temperature: 5,
+				templow: 2
+			},
+			{
+				datetime: "2026-03-10T00:00:00Z",
+				condition: "partlycloudy",
+				temperature: 6,
+				templow: 0
+			},
+			{
+				datetime: "2026-03-11T00:00:00Z",
+				condition: "snowy",
+				temperature: 1,
+				templow: -3
+			}
+		]
+	}), { platform: "met" });
+	add(makeEntity("camera.front_door_camera", "streaming", {
+		entity_picture: "/api/camera_proxy/camera.front_door_camera",
+		frontend_stream_type: "hls"
+	}), {
+		device_id: "camera_front",
+		area_id: "entry",
+		supported_features: 2
+	});
+	add(makeEntity("scene.movie_night", "scening", { entity_id: [
+		"light.living_room_main",
+		"cover.living_room_blinds",
+		"media_player.living_room_speaker"
+	] }), { area_id: "living_room" });
+	add(makeEntity("scene.good_morning", "scening", { entity_id: [
+		"light.bedroom_ceiling",
+		"cover.bedroom_curtains",
+		"switch.coffee_machine"
+	] }), {});
+	add(makeEntity("button.restart_home_assistant", "unknown", { device_class: "restart" }), {
+		entity_category: "config",
+		device_class: "restart"
+	});
+	add(makeEntity("button.update_firmware", "unknown", { device_class: "update" }), {
+		entity_category: "config",
+		device_class: "update"
+	});
+	add(makeEntity("sensor.door_lock_battery", "92", {
+		unit_of_measurement: "%",
+		device_class: "battery",
+		state_class: "measurement"
+	}), {
+		device_id: "lock_front",
+		area_id: "entry",
+		device_class: "battery",
+		unit_of_measurement: "%"
+	});
+	add(makeEntity("sensor.motion_sensor_battery", "65", {
+		unit_of_measurement: "%",
+		device_class: "battery",
+		state_class: "measurement"
+	}), {
+		device_id: "motion_sensor",
+		area_id: "entry",
+		device_class: "battery",
+		unit_of_measurement: "%"
+	});
+	return {
+		entities,
+		entityRegistry,
+		areas,
+		devices
+	};
+}
+
+//#endregion
+export { createDemoFixtures };

package/dist/entities/area-views.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Area View Builder
+ *
+ * Constructs unified AreaView objects by combining registry data
+ * with computed entities and devices using the query engine.
+ *
+ * @packageDocumentation
+ */
+import type { AreaId, AreaView, DeviceRegistryEntry, DeviceView } from "../core/types";
+/**
+ * Build a DeviceView from registry data
+ */
+export declare function buildDeviceView(device: DeviceRegistryEntry): DeviceView;
+/**
+ * Build an AreaView from registry data using query engine
+ */
+export declare function buildAreaView(areaId: AreaId): AreaView;
+/**
+ * Get all area views
+ */
+export declare function getAreaViews(): AreaView[];
+/**
+ * Get area view
+ */
+export declare function getAreaView(areaId: AreaId): AreaView | undefined;

package/dist/entities/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Entity Index Queries
+ *
+ * Provides utilities for querying entities by various criteria.
+ * In the SolidJS port, indices are NOT stored in state -- they are
+ * computed on the fly here (and will be derived reactively in Plan 03).
+ *
+ * @packageDocumentation
+ */
+import type { AreaId, DeviceId, EntityDomain, EntityId, FloorId, LabelId } from "../core/types";
+/**
+ * Get all entity IDs
+ */
+export declare function getAllEntityIds(): EntityId[];
+/**
+ * Get entities by domain
+ */
+export declare function getEntitiesByDomain(domain: EntityDomain): EntityId[];
+/**
+ * Get entities via devices in area
+ *
+ * Only includes entities that inherit area from device (entity.area_id is null).
+ */
+export declare function getEntitiesViaDevices(areaId: AreaId): EntityId[];
+/**
+ * Get entities by area
+ *
+ * Returns entities with direct area_id assignments and entities that inherit their area from devices.
+ */
+export declare function getEntitiesByArea(areaId: AreaId): EntityId[];
+/**
+ * Get entities by device
+ */
+export declare function getEntitiesByDevice(deviceId: DeviceId): EntityId[];
+/**
+ * Get entities by floor
+ */
+export declare function getEntitiesByFloor(floorId: FloorId): EntityId[];
+/**
+ * Get entities by label
+ */
+export declare function getEntitiesByLabel(labelId: LabelId): EntityId[];
+/**
+ * Get domain statistics
+ */
+export declare function getDomainStats(): Record<EntityDomain, number>;
+/**
+ * Get area statistics
+ */
+export declare function getAreaStats(): Record<AreaId, number>;
+/**
+ * Get total entity count
+ */
+export declare function getEntityCount(): number;

package/dist/entities/views.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Entity View Builder
+ *
+ * Constructs unified EntityView objects by combining runtime state
+ * with registry metadata.
+ *
+ * @packageDocumentation
+ */
+import type { EntityRegistryEntry } from "@glasshome/ha-types";
+import type { EntityId, EntityView, HassEntity } from "../core/types";
+/**
+ * Build an EntityView from runtime state and registry metadata
+ */
+export declare function buildEntityView(entity: HassEntity, registry: EntityRegistryEntry | undefined): EntityView;
+/**
+ * Get or build an EntityView
+ */
+export declare function getEntityView(entityId: EntityId): EntityView | undefined;
+/**
+ * Get multiple entity views
+ */
+export declare function getEntityViews(entityIds: EntityId[]): EntityView[];
+/**
+ * Get all entity views
+ */
+export declare function getAllEntityViews(): EntityView[];
+/**
+ * Rebuild entity view
+ */
+export declare function rebuildEntityView(entityId: EntityId): EntityView | undefined;

package/dist/history/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * History Constants
+ *
+ * Constants and utilities for history fetching and processing.
+ * Based on Home Assistant frontend implementation.
+ *
+ * @packageDocumentation
+ */
+import type { EntityId } from "../core/types";
+export declare const DOMAINS_USE_LAST_UPDATED: readonly ["climate", "humidifier", "water_heater"];
+export declare const NEED_ATTRIBUTE_DOMAINS: readonly ["climate", "humidifier", "input_datetime", "water_heater", "person", "device_tracker"];
+export declare const LINE_ATTRIBUTES_TO_KEEP: readonly ["temperature", "current_temperature", "target_temp_low", "target_temp_high", "hvac_action", "humidity", "mode", "action", "current_humidity"];
+/**
+ * Check if an entity needs attributes in history response
+ */
+export declare function entityIdHistoryNeedsAttributes(entityId: EntityId): boolean;

package/dist/history/fetch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * History Fetching
+ *
+ * @packageDocumentation
+ */
+import type { EntityId } from "../core/types";
+import type { EntityHistoryData, EntityHistoryQueryOptions, EntityHistoryState, HistoryQueryOptions, TimelineState } from "./types";
+/**
+ * Fetch history for entities during a time period
+ */
+export declare function fetchHistory(options: HistoryQueryOptions): Promise<Record<EntityId, EntityHistoryState[]>>;
+/**
+ * Fetch history for a single entity
+ */
+export declare function fetchEntityHistory(entityId: EntityId, options: EntityHistoryQueryOptions): Promise<EntityHistoryData>;
+/**
+ * Convert compressed history state to timeline state
+ */
+export declare function historyStateToTimeline(s: EntityHistoryState): TimelineState;

package/dist/history/query.d.ts

@@ -0,0 +1,13 @@
+import type { EntityId } from "../core/types";
+import type { EntityHistoryData, EntityHistoryQueryOptions } from "./types";
+/** Check if an entity has active history tracking. */
+export declare function isHistoryTracked(entityId: EntityId): boolean;
+/** Start tracking history for an entity. Fetches initial backfill. */
+export declare function trackEntityHistory(entityId: EntityId, options: EntityHistoryQueryOptions): Promise<EntityHistoryData>;
+/** Stop tracking history for an entity and clear its data. */
+export declare function untrackEntityHistory(entityId: EntityId): void;
+/**
+ * Append a state change to an entity's history.
+ * Called by the entity subscription handler when a tracked entity changes.
+ */
+export declare function appendHistoryPoint(entityId: EntityId, stateValue: string, attributes: Record<string, unknown>, lastUpdated: number, lastChanged?: number): void;