@glasshome/sync-layer 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,336 @@
+/**
+ * Core type definitions for @glasshome/sync-layer
+ *
+ * This file defines types that are:
+ * 1. **Used from ha-types**: WebSocket commands, events, registry entries
+ * 2. **Runtime data structures**: Entity states, device/area/floor/label registries
+ *    (These should eventually be moved to ha-types but are defined here for now
+ *    as ha-types currently only has WebSocket command types)
+ * 3. **Sync-layer specific**: EntityView, views
+ *
+ * @packageDocumentation
+ */
+import type { AreaEntry, DeviceEntry, EntityCategory, EntityRegistryEntry } from "@glasshome/ha-types";
+/**
+ * Unique entity identifier (e.g., "light.living_room")
+ */
+export type EntityId = string;
+/**
+ * Domain extracted from entity_id (e.g., "light")
+ */
+export type EntityDomain = string;
+/**
+ * Unique device identifier (UUID)
+ */
+export type DeviceId = string;
+/**
+ * Unique area identifier
+ */
+export type AreaId = string;
+/**
+ * Floor identifier
+ */
+export type FloorId = string;
+/**
+ * Label identifier
+ */
+export type LabelId = string;
+/**
+ * Runtime entity state from Home Assistant
+ *
+ * This represents the live state of an entity as received
+ * from the WebSocket API's `get_states` command or `subscribe_entities` subscription.
+ */
+export interface HassEntity {
+    /** Unique entity identifier */
+    entity_id: EntityId;
+    /** Current state value (e.g., "on", "off", "23.5") */
+    state: string;
+    /** Entity attributes (brightness, temperature, etc.) */
+    attributes: Record<string, any>;
+    /** ISO 8601 timestamp of last state change */
+    last_changed: string;
+    /** ISO 8601 timestamp of last update */
+    last_updated: string;
+    /** Event context */
+    context: {
+        /** Context ID */
+        id: string;
+        /** Parent context ID */
+        parent_id: string | null;
+        /** User ID that triggered the change */
+        user_id: string | null;
+    };
+}
+/**
+ * Device registry entry
+ *
+ * @alias DeviceEntry
+ */
+export type DeviceRegistryEntry = DeviceEntry;
+/**
+ * Area registry entry
+ *
+ * @alias AreaEntry
+ * @note AreaEntry uses 'id' field, not 'area_id'
+ */
+export type AreaRegistryEntry = AreaEntry;
+/**
+ * Floor registry entry
+ *
+ * Response structure from `config/floor_registry/list`
+ */
+export interface FloorRegistryEntry {
+    /** Unique floor identifier */
+    floor_id: FloorId;
+    /** Floor name */
+    name: string;
+    /** Floor level (integer, 0 = ground floor) */
+    level: number;
+    /** Floor icon */
+    icon: string | null;
+    /** Floor aliases */
+    aliases: string[];
+    /** Created timestamp */
+    created_at: string;
+    /** Modified timestamp */
+    modified_at: string;
+}
+/**
+ * Label registry entry
+ *
+ * Response structure from `config/label_registry/list`
+ */
+export interface LabelRegistryEntry {
+    /** Unique label identifier */
+    label_id: LabelId;
+    /** Label name */
+    name: string;
+    /** Label color (hex) */
+    color: string | null;
+    /** Label icon */
+    icon: string | null;
+    /** Label description */
+    description: string | null;
+    /** Created timestamp */
+    created_at: string;
+    /** Modified timestamp */
+    modified_at: string;
+}
+/**
+ * Statistics metadata
+ *
+ * Response structure from `recorder/get_statistics_metadata`
+ */
+export interface StatisticMetadata {
+    /** Statistic ID */
+    statistic_id: string;
+    /** Data source */
+    source: string;
+    /** Unit of measurement */
+    unit_of_measurement: string | null;
+    /** Whether statistic has mean values */
+    has_mean: boolean;
+    /** Whether statistic has sum values */
+    has_sum: boolean;
+    /** Display name */
+    name: string | null;
+}
+/**
+ * Statistics data point
+ *
+ * Response structure from `recorder/statistics_during_period`
+ */
+export interface StatisticData {
+    /** Statistic ID */
+    statistic_id: string;
+    /** Period start (ISO 8601) */
+    start: string;
+    /** Period end (ISO 8601) */
+    end: string;
+    /** Mean value */
+    mean?: number;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Last reset timestamp */
+    last_reset?: string;
+    /** State value */
+    state?: number;
+    /** Sum value */
+    sum?: number;
+}
+/**
+ * Unified entity view combining runtime state and registry metadata
+ *
+ * This is the primary interface for working with entities in the sync-layer.
+ * It combines live state data with registry metadata to provide a complete
+ * view of an entity.
+ */
+export interface EntityView {
+    /** Unique entity identifier */
+    id: EntityId;
+    /** Entity domain (e.g., "light", "sensor") */
+    domain: EntityDomain;
+    /** Current state value */
+    state: string;
+    /** Entity attributes */
+    attributes: Record<string, any>;
+    /** Last state change timestamp */
+    lastChanged: Date;
+    /** Last update timestamp */
+    lastUpdated: Date;
+    /** Event context */
+    context: {
+        id: string;
+        parentId: string | null;
+        userId: string | null;
+    };
+    /** Entity name (from registry or friendly_name) */
+    name: string;
+    /** Friendly display name */
+    friendlyName: string;
+    /** Area ID where entity is located */
+    areaId: AreaId | null;
+    /** Device ID this entity belongs to */
+    deviceId: DeviceId | null;
+    /** Platform/integration that provides this entity */
+    platform: string;
+    /** Unique ID from integration */
+    uniqueId: string | null;
+    /** Whether entity is disabled */
+    isDisabled: boolean;
+    /** Whether entity is hidden */
+    isHidden: boolean;
+    /** Resolved icon (registry icon, attribute icon, or domain default) */
+    icon: string | null;
+    /** Icon source (registry, attribute, or default) */
+    iconSource: "registry" | "attribute" | "default";
+    /** Entity category (config, diagnostic, or null) */
+    entityCategory: EntityCategory | null;
+    /** Labels applied to this entity */
+    labels: LabelId[];
+    /** Entity aliases */
+    aliases: string[];
+    /** Device class (e.g., "temperature", "humidity") */
+    deviceClass?: string | null;
+    /** Unit of measurement */
+    unitOfMeasurement?: string | null;
+    /** Supported features bitmask */
+    supportedFeatures?: number;
+}
+/**
+ * Device view combining registry data with computed properties
+ */
+export interface DeviceView {
+    /** Unique device identifier */
+    id: DeviceId;
+    /** Device name */
+    name: string;
+    /** User-friendly name */
+    nameByUser: string | null;
+    /** Manufacturer */
+    manufacturer: string | null;
+    /** Model */
+    model: string | null;
+    /** Software version */
+    swVersion: string | null;
+    /** Area ID where device is located */
+    areaId: AreaId | null;
+    /** Configuration entry IDs */
+    configEntries: string[];
+    /** Device connections */
+    connections: Array<[string, string]>;
+    /** Device identifiers */
+    identifiers: Array<[string, string]>;
+    /** Whether device is disabled */
+    disabledBy: string | null;
+}
+/**
+ * Area view combining registry data with computed entities and devices
+ */
+export interface AreaView {
+    /** Unique area identifier */
+    id: AreaId;
+    /** Area name */
+    name: string;
+    /** Normalized area name (for searching) */
+    normalizedName: string;
+    /** Area aliases */
+    aliases: string[];
+    /** Floor ID this area belongs to */
+    floorId: FloorId | null;
+    /** Area icon */
+    icon: string | null;
+    /** Area picture */
+    picture: string | null;
+    /** Labels applied to this area */
+    labels: LabelId[];
+    /** Temperature entity ID for this area */
+    temperatureEntityId: EntityId | null;
+    /** Humidity entity ID for this area */
+    humidityEntityId: EntityId | null;
+    /** Created timestamp */
+    createdAt: string;
+    /** Last modified timestamp */
+    modifiedAt: string;
+    /** Entities in this area (direct + via devices) - uses query engine */
+    entities: EntityView[];
+    /** Devices in this area */
+    devices: DeviceView[];
+    /** Entity IDs for fast lookups */
+    entityIds: EntityId[];
+    /** Device IDs for fast lookups */
+    deviceIds: DeviceId[];
+}
+/**
+ * WebSocket connection state
+ */
+export type ConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+/**
+ * Unsubscribe function returned by subscriptions
+ */
+export type UnsubscribeFunc = () => void;
+/**
+ * Generic callback type
+ */
+export type Callback<T> = (data: T) => void;
+/**
+ * Predicate function for filtering
+ */
+export type PredicateFunc<T> = (item: T) => boolean;
+/**
+ * Comparison function for sorting
+ */
+export type CompareFunc<T> = (a: T, b: T) => number;
+/**
+ * Mapping function for transformations
+ */
+export type MapFunc<T, R> = (item: T) => R;
+/**
+ * Registry update event data
+ */
+export interface RegistryUpdateEvent {
+    action: "create" | "update" | "remove";
+    entity_id: EntityId;
+    entity?: EntityRegistryEntry;
+}
+/**
+ * Statistics update event data
+ */
+export interface StatisticsUpdateEvent {
+    statistic_ids: string[];
+}
+/**
+ * Check if a value is a valid EntityId
+ */
+export declare function isEntityId(value: unknown): value is EntityId;
+/**
+ * Extract domain from entity ID
+ */
+export declare function extractDomain(entityId: EntityId): EntityDomain;
+/**
+ * Check if entity is in a specific domain
+ */
+export declare function isDomain(entityId: EntityId, domain: EntityDomain): boolean;

package/dist/demo/demo-data.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Demo Mode Fixtures
+ *
+ * ~30 curated apartment entities for showcasing the dashboard without
+ * a real Home Assistant instance. Covers all widget-relevant domains.
+ *
+ * @packageDocumentation
+ */
+import type { EntityRegistryEntry } from "@glasshome/ha-types";
+import type { AreaRegistryEntry, DeviceRegistryEntry, HassEntity } from "../core/types";
+export interface DemoFixtures {
+    entities: Record<string, HassEntity>;
+    entityRegistry: Record<string, EntityRegistryEntry>;
+    areas: Record<string, AreaRegistryEntry>;
+    devices: Record<string, DeviceRegistryEntry>;
+}
+/**
+ * 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.
+ */
+export declare function createDemoFixtures(): DemoFixtures;

package/dist/demo/demo-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Demo Mode Provider
+ *
+ * Loads demo fixtures into the SolidJS store and provides
+ * optimistic local state updates for service calls (toggle, turnOn, turnOff).
+ *
+ * @packageDocumentation
+ */
+/**
+ * Whether demo mode is currently active.
+ */
+export declare function isDemoMode(): boolean;
+/**
+ * Load demo fixtures into the SolidJS store.
+ *
+ * Populates entities, entity registry, areas, and devices.
+ * Sets connection state to "connected" (pretend connected).
+ */
+export declare function loadDemoData(): Promise<void>;
+/**
+ * Unload demo data and reset to disconnected state.
+ */
+export declare function unloadDemoData(): void;
+/**
+ * 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.
+ */
+export declare function applyDemoServiceCall(domain: string, service: string, _serviceData?: Record<string, any>, target?: {
+    entity_id?: string | string[];
+}): void;
+export { createDemoFixtures } from "./demo-data";

package/dist/demo/demo-provider.js

@@ -0,0 +1,103 @@
+import { setState, state } from "../store-B1sbyexX.js";
+import { extractDomain } from "../types-Csog0nqk.js";
+import { createDemoFixtures } from "../demo-data-D8JXWRpw.js";
+import { produce, reconcile } from "solid-js/store";
+
+//#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("connectionState", "connected");
+	_isDemoMode = true;
+}
+/**
+* Unload demo data and reset to disconnected state.
+*/
+function unloadDemoData() {
+	setState("entities", reconcile({}));
+	setState("entityRegistry", reconcile({}));
+	setState("areas", reconcile({}));
+	setState("devices", reconcile({}));
+	setState("connectionState", "disconnected");
+	_isDemoMode = false;
+}
+/**
+* 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 = state.entities[entityId];
+		if (!entity) 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";
+				e.attributes.current_position = 100;
+			} else if (service === "close_cover") {
+				e.state = "closed";
+				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";
+		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";
+		e.attributes.current_position = 0;
+	} else e.state = "off";
+}
+
+//#endregion
+export { applyDemoServiceCall, createDemoFixtures, isDemoMode, loadDemoData, unloadDemoData };