@glasshome/sync-layer 0.7.1 → 0.8.0

package/dist/core/reducers.d.ts

@@ -1,99 +0,0 @@
-/**
- * State update reducers
- *
- * These functions handle state updates in response to events from
- * Home Assistant. They use SolidJS store's produce() for safe mutations.
- *
- * NOTE: All index maintenance code has been stripped.
- * Indices are derived reactively in Plan 03.
- *
- * @packageDocumentation
- */
-import type { EntityRegistryEntry } from "@glasshome/ha-types";
-import type { AreaRegistryEntry, DeviceRegistryEntry, EntityId, FloorRegistryEntry, HassEntity, LabelRegistryEntry, StatisticData, StatisticMetadata } from "./types";
-/**
- * Bulk update multiple entities
- *
- * Used during initial load or bulk sync operations.
- *
- * @param entities - Array of entity states
- */
-export declare function bulkUpdateEntities(entities: HassEntity[]): void;
-/**
- * Update entity registry entry
- *
- * @param entry - Entity registry entry
- */
-export declare function updateEntityRegistry(entry: EntityRegistryEntry): void;
-/**
- * Remove entity registry entry
- *
- * @param entityId - Entity ID to remove
- */
-export declare function removeEntityRegistry(entityId: EntityId): void;
-/**
- * Bulk update entity registry
- *
- * @param entries - Array of registry entries
- */
-export declare function bulkUpdateEntityRegistry(entries: EntityRegistryEntry[]): void;
-/**
- * Update device registry entry
- *
- * @param device - Device registry entry
- */
-export declare function updateDevice(device: DeviceRegistryEntry): void;
-/**
- * Remove device registry entry
- *
- * @param deviceId - Device ID to remove
- */
-export declare function removeDevice(deviceId: string): void;
-/**
- * Update area registry entry
- *
- * @param area - Area registry entry
- */
-export declare function updateArea(area: AreaRegistryEntry): void;
-/**
- * Remove area registry entry
- *
- * @param areaId - Area ID to remove
- */
-export declare function removeArea(areaId: string): void;
-/**
- * Update floor registry entry
- *
- * @param floor - Floor registry entry
- */
-export declare function updateFloor(floor: FloorRegistryEntry): void;
-/**
- * Remove floor registry entry
- *
- * @param floorId - Floor ID to remove
- */
-export declare function removeFloor(floorId: string): void;
-/**
- * Update label registry entry
- *
- * @param label - Label registry entry
- */
-export declare function updateLabel(label: LabelRegistryEntry): void;
-/**
- * Remove label registry entry
- *
- * @param labelId - Label ID to remove
- */
-export declare function removeLabel(labelId: string): void;
-/**
- * Update statistics metadata
- *
- * @param metadata - Statistics metadata
- */
-export declare function updateStatisticsMetadata(metadata: StatisticMetadata[]): void;
-/**
- * Update statistics data
- *
- * @param data - Statistics data points
- */
-export declare function updateStatisticsData(data: StatisticData[]): void;

package/dist/core/store.d.ts

@@ -1,100 +0,0 @@
-/** Central reactive state store for sync-layer using SolidJS createStore. */
-import type { SetStoreFunction, Store } from "solid-js/store";
-import type { CalendarEventsData } from "../calendar/types";
-import type { CameraStreamData } from "../camera/types";
-import type { EntityHistoryData } from "../history/types";
-import type { WeatherForecastsData } from "../weather/types";
-import type { AreaId, AreaRegistryEntry, ConnectionState, DeviceId, DeviceRegistryEntry, EntityId, FloorId, FloorRegistryEntry, HassEntity, LabelId, LabelRegistryEntry, StatisticData, StatisticMetadata } from "./types";
-/**
- * Complete state shape for the sync-layer store
- *
- * All updates use SolidJS store's produce() for mutations
- * or reconcile() for bulk replacements.
- *
- * NOTE: No EntityIndices field -- indices are derived reactively in Plan 03.
- * NOTE: No _activeSubscriptions -- managed externally.
- */
-/**
- * The structural surface every conn consumer actually uses. Satisfied by a
- * real home-assistant-js-websocket Connection, the bridge facade (traffic
- * tunneled through the HA worker), and mock connections.
- */
-export interface HaLink {
-    sendMessagePromise<T>(message: unknown): Promise<T>;
-    subscribeMessage<T>(callback: (message: T) => void, message: unknown): Promise<() => Promise<void>>;
-    subscribeEvents(callback: (event: unknown) => void, eventType?: string): Promise<() => void | Promise<void>>;
-}
-export interface GlassHomeState {
-    /** Current connection state */
-    connectionState: ConnectionState;
-    /** Connection error (if any) */
-    connectionError: Error | null;
-    /** Home Assistant base URL */
-    hassUrl: string | null;
-    /** Same-origin prefix for the HA media proxy (e.g. "/ha-proxy/media"), or null
-     *  to resolve media directly against hassUrl. Set by the host at connect. */
-    mediaProxyBase: string | null;
-    /** Home Assistant core config (unit system, locale, currency); null until loaded */
-    config: import("@glasshome/ha-types").HassConfig | null;
-    /** Live entity state (keyed by entity_id) */
-    entities: Record<EntityId, HassEntity>;
-    /** Entity registry entries (keyed by entity_id) */
-    entityRegistry: Record<EntityId, import("@glasshome/ha-types").EntityRegistryEntry>;
-    /** Device registry entries (keyed by device ID) */
-    devices: Record<DeviceId, DeviceRegistryEntry>;
-    /** Area registry entries (keyed by area ID) */
-    areas: Record<AreaId, AreaRegistryEntry>;
-    /** Floor registry entries (keyed by floor ID) */
-    floors: Record<FloorId, FloorRegistryEntry>;
-    /** Label registry entries (keyed by label ID) */
-    labels: Record<LabelId, LabelRegistryEntry>;
-    /** Statistics data (keyed by statistic_id) */
-    statistics: Record<string, StatisticData[]>;
-    /** Statistics metadata (keyed by statistic_id) */
-    statisticsMetadata: Record<string, StatisticMetadata>;
-    /** Entity history data (keyed by entity ID) */
-    history: Record<EntityId, EntityHistoryData>;
-    /** Weather forecasts data (keyed by entity ID) */
-    forecasts: Record<EntityId, WeatherForecastsData>;
-    /** Live calendar events (keyed by entity ID), maintained by calendar/track */
-    calendars: Record<EntityId, CalendarEventsData>;
-    /** Camera stream data (keyed by entity ID) */
-    streams: Record<EntityId, CameraStreamData>;
-}
-/**
- * Module-level SolidJS createStore singleton
- *
- * `state` is a read-only reactive proxy.
- * `setState` is used for mutations via produce() or direct path setting.
- *
- * @example
- * ```typescript
- * import { state, setState } from '@glasshome/sync-layer/core/store';
- *
- * // Read state (auto-tracked in SolidJS reactive contexts)
- * const entities = state.entities;
- *
- * // Mutate via produce
- * setState(produce((s) => {
- *   s.entities['light.living_room'] = newEntity;
- * }));
- *
- * // Bulk replace
- * setState("entities", reconcile(newEntities));
- * ```
- */
-declare global {
-    var __GH_SYNC_LAYER_STORE__: boolean | undefined;
-}
-export declare const state: Store<GlassHomeState>;
-export declare const setState: SetStoreFunction<GlassHomeState>;
-/**
- * Reset store to initial state
- */
-export declare function resetStore(): void;
-/**
- * Factory for testing isolation
- *
- * Creates a new, independent store instance for test isolation.
- */
-export declare function createStoreInstance(): [GlassHomeState, SetStoreFunction<GlassHomeState>];

package/dist/core/types.d.ts

@@ -1,339 +0,0 @@
-/**
- * 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 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 */
-    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

@@ -1,24 +0,0 @@
-/**
- * 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 6 areas: living_room, bedroom, kitchen, entry, utility, garage.
- */
-export declare function createDemoFixtures(): DemoFixtures;

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

@@ -1,40 +0,0 @@
-/**
- * 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;
-/**
- * Start the demo energy ticker. Updates the energy sensors and `sun.sun`
- * every 5 seconds. Idempotent: clears any prior interval first. SSR-safe.
- */
-export declare function startDemoEnergyTicker(): void;
-/** Stop the demo energy ticker if running. */
-export declare function stopDemoEnergyTicker(): 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";