@glasshome/sync-layer 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { A as HassEntity, C as DeviceRegistryEntry, D as EntityView, E as EntityId, F as StatisticData, I as StatisticMetadata, L as UnsubscribeFunc, M as LabelRegistryEntry, N as MapFunc, O as FloorId, P as PredicateFunc, R as extractDomain, S as DeviceId, T as EntityDomain, _ as AreaId, a as toggle, b as Callback, c as updateEntity, d as EntityUpdateFields, f as ServiceCallContext, g as CalendarWindowOptions, h as CalendarEventsData, i as sendCommand, j as LabelId, k as FloorRegistryEntry, l as CommandOptions, m as CalendarEvent, n as batchServiceCalls, o as turnOff, p as ServiceTarget, r as callService, s as turnOn, t as batchEntityUpdates, u as CommandResult, v as AreaRegistryEntry, w as DeviceView, x as ConnectionState, y as AreaView } from "./service-C8H42I-Q.js";
+import { A as HassEntity, C as DeviceRegistryEntry, D as EntityView, E as EntityId, F as StatisticData, I as StatisticMetadata, L as UnsubscribeFunc, M as LabelRegistryEntry, N as MapFunc, O as FloorId, P as PredicateFunc, R as extractDomain, S as DeviceId, T as EntityDomain, _ as AreaId, a as toggle, b as Callback, c as updateEntity, d as EntityUpdateFields, f as ServiceCallContext, g as CalendarWindowOptions, h as CalendarEventsData, i as sendCommand, j as LabelId, k as FloorRegistryEntry, l as CommandOptions, m as CalendarEvent, n as batchServiceCalls, o as turnOff, p as ServiceTarget, r as callService, s as turnOn, t as batchEntityUpdates, u as CommandResult, v as AreaRegistryEntry, w as DeviceView, x as ConnectionState, y as AreaView } from "./service-B1gegd-N.js";
 import { WorkerScope, runHaBridgeWorker } from "./worker/worker-main.js";
-import { Auth, ConnectionOptions as ConnectionOptions$1 } from "home-assistant-js-websocket";
 import { Store } from "solid-js/store";
+import { Auth, ConnectionOptions as ConnectionOptions$1 } from "home-assistant-js-websocket";
 import { CapabilityGrant } from "@glasshome/widget-contract";
 import { CallServiceRequest, CoreEventType, Domain, EntityCategory, EntityRegistryEntry, EntityRegistryEntry as EntityRegistryEntry$1, EventStateChangedData, HAEvent, HAEvent as HAEvent$1, HassConfig, HassUnitSystem, RegistryEntryDisabler, RegistryEntryHider, ServiceCall, ServiceName, WsCommandType, WsResult } from "@glasshome/ha-types";
 //#region src/camera/types.d.ts
@@ -440,7 +440,7 @@ interface OAuthOptions {
 //#endregion
 //#region src/connection/manager.d.ts
 /**
- * Options for initializing a connection
+ * @deprecated Nothing reads these options since the worker bridge became the only connection. Removed in 2.0.0.
  */
 interface ConnectionOptions {
   url: string;
@@ -460,32 +460,13 @@ declare function disconnect(): void;
  */
 declare function isConnected(): boolean;
 /**
- * Get the underlying socket's connected flag.
- *
- * Exposed so apps can render a connection indicator in the UI. Distinct from
- * `isConnected()` which reflects the manager's internal lifecycle state.
+ * Get the connection's connected flag, for a connection indicator in the UI.
  */
 declare function getConnectionState(): boolean;
 //#endregion
 //#region src/connection/types.d.ts
 /**
- * Unified connection interface for Home Assistant connections
- *
- * This interface is implemented by both:
- * - MockConnection (for testing)
- * - Wrapped HA Connection (for production)
- *
- * @example
- * ```typescript
- * // In tests
- * const mockConn: SyncLayerConnection = new MockConnection(fixtures);
- * await syncLayer.connect({ connection: mockConn });
- *
- * // In production
- * const haConn = await createConnection({ auth });
- * const wrappedConn: SyncLayerConnection = wrapHAConnection(haConn);
- * await syncLayer.connect({ connection: wrappedConn });
- * ```
+ * Connection interface the store talks to; implemented by the worker bridge.
  */
 interface SyncLayerConnection {
   /**
@@ -571,7 +552,7 @@ interface SyncLayerConnection {
    * await unsubscribe();
    * ```
    */
-  subscribeMessage<T>(callback: (message: T) => void, message: any): Promise<() => Promise<void>>;
+  subscribeMessage<T>(callback: (message: T) => void, message: unknown): Promise<() => Promise<void>>;
   /**
    * Send a message and wait for response
    *
@@ -588,7 +569,7 @@ interface SyncLayerConnection {
    * });
    * ```
    */
-  sendMessagePromise<T>(message: any): Promise<T>;
+  sendMessagePromise<T>(message: unknown): Promise<T>;
   /**
    * Add event listener for WebSocket messages
    *
@@ -621,25 +602,6 @@ declare global {
  */
 declare function registerEntity(entityId: EntityId): () => void;
 //#endregion
-//#region src/query/area-builder.d.ts
-interface AreaQueryBuilder$1 {
-  byFloor(floorId: FloorId): AreaQueryBuilder$1;
-  byLabel(labelId: LabelId): AreaQueryBuilder$1;
-  where(predicate: PredicateFunc<AreaView>): AreaQueryBuilder$1;
-  orderBy(key: keyof AreaView | string, direction?: "asc" | "desc"): AreaQueryBuilder$1;
-  get(): AreaView[];
-  first(): AreaView | undefined;
-  subscribe(callback: Callback<AreaView[]>): UnsubscribeFunc;
-}
-/**
- * Create a query builder for areas
- */
-declare function areas(): AreaQueryBuilder$1;
-/**
- * Create a query for a single area
- */
-declare function area(areaId: AreaId): AreaView | undefined;
-//#endregion
 //#region src/query/types.d.ts
 /**
  * Main query builder interface for multiple entities
@@ -795,7 +757,7 @@ interface AreaQueryBuilder {
   /**
    * Order results by a key
    */
-  orderBy(key: keyof AreaView | string, direction?: "asc" | "desc"): AreaQueryBuilder;
+  orderBy(key: keyof AreaView | (string & {}), direction?: "asc" | "desc"): AreaQueryBuilder;
   /**
    * Execute query and get results
    */
@@ -835,6 +797,16 @@ interface EntityQueryBuilder {
   subscribe(callback: Callback<EntityView | undefined>): UnsubscribeFunc;
 }
 //#endregion
+//#region src/query/area-builder.d.ts
+/**
+ * Create a query builder for areas
+ */
+declare function areas(): AreaQueryBuilder;
+/**
+ * Create a query for a single area
+ */
+declare function area(areaId: AreaId): AreaView | undefined;
+//#endregion
 //#region src/query/builder.d.ts
 /**
  * Create a query builder for multiple entities
@@ -889,7 +861,7 @@ declare function refreshStream(entityId: EntityId, format?: StreamFormat): Promi
  * - battery: `stat_energy_from`, `stat_energy_to`
  */
 interface EnergySource {
-  type: "grid" | "solar" | "battery" | "gas" | "water" | string;
+  type: "grid" | "solar" | "battery" | "gas" | "water" | (string & {});
   stat_energy_from?: string;
   stat_energy_to?: string;
   flow_from?: Array<{
@@ -1041,7 +1013,7 @@ declare function fetchEntityHistory(entityId: EntityId, options: EntityHistoryQu
  */
 declare function historyStateToTimeline(s: EntityHistoryState): TimelineState;
 //#endregion
-//#region src/history/query.d.ts
+//#region src/history/points.d.ts
 interface HistoryPoint {
   entityId: EntityId;
   stateValue: string;
@@ -1051,12 +1023,6 @@ interface HistoryPoint {
 }
 /** Hard cap on retained points per entity timeline. */
 declare const MAX_HISTORY_POINTS = 5760;
-/** Check if an entity has active history tracking. */
-declare function isHistoryTracked(entityId: EntityId): boolean;
-/** Start tracking history for an entity. Fetches initial backfill. */
-declare function trackEntityHistory(entityId: EntityId, options: EntityHistoryQueryOptions): Promise<EntityHistoryData>;
-/** Release one tracker. The entity's data is cleared only when the last one goes. */
-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.
@@ -1068,6 +1034,14 @@ declare function appendHistoryPoint(entityId: EntityId, stateValue: string, attr
  */
 declare function bulkAppendHistoryPoints(points: HistoryPoint[]): void;
 //#endregion
+//#region src/history/query.d.ts
+/** Check if an entity has active history tracking. */
+declare function isHistoryTracked(entityId: EntityId): boolean;
+/** Start tracking history for an entity. Fetches initial backfill. */
+declare function trackEntityHistory(entityId: EntityId, options: EntityHistoryQueryOptions): Promise<EntityHistoryData>;
+/** Release one tracker. The entity's data is cleared only when the last one goes. */
+declare function untrackEntityHistory(entityId: EntityId): void;
+//#endregion
 //#region src/history/statistics.d.ts
 /**
  * A single statistics bucket for one statistic id.
@@ -1148,62 +1122,38 @@ declare function refreshForecast(entityId: EntityId, type: ForecastType): Promis
  */
 declare function refreshForecasts(entityId: EntityId, types: ForecastType[]): Promise<WeatherForecastsData>;
 //#endregion
-//#region src/demo/demo-data.d.ts
+//#region src/demo/demo-provider.d.ts
+type DemoClockOption = "live" | {
+  pinned: string;
+  seed: number;
+  timeZone?: string;
+};
+interface DemoHouseOptions {
+  clock: DemoClockOption;
+  search?: string;
+}
 interface DemoFixtures {
   entities: Record<string, HassEntity>;
   entityRegistry: Record<string, EntityRegistryEntry$1>;
   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.
- */
-declare function createDemoFixtures(): DemoFixtures;
-//#endregion
-//#region src/demo/demo-provider.d.ts
-/**
- * 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.
- */
 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).
- */
-declare function loadDemoData(): Promise<void>;
-/**
- * Unload demo data and reset to disconnected state.
- */
+declare function loadDemoHouse(opts: DemoHouseOptions): Promise<void>;
 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.
- */
+declare function resetDemo(): Promise<void>;
+/** @deprecated since 0.10.0, use loadDemoHouse({ clock: "live" }) */
+declare function loadDemoData(): Promise<void>;
+/** @deprecated since 0.10.0, the demo ticker starts with loadDemoHouse */
 declare function startDemoEnergyTicker(): void;
-/** Stop the demo energy ticker if running. */
+/** @deprecated since 0.10.0, the demo ticker stops with unloadDemoData */
 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.
- */
-declare function applyDemoServiceCall(_domain: string, service: string, _serviceData?: Record<string, any>, target?: {
+/** @deprecated since 0.10.0, service calls reach the demo through callService */
+declare function applyDemoServiceCall(domain: string, service: string, serviceData?: Record<string, unknown>, target?: {
   entity_id?: string | string[];
 }): void;
+/** @deprecated since 0.10.0, use loadDemoHouse */
+declare function createDemoFixtures(): DemoFixtures;
 //#endregion
 //#region src/worker/protocol.d.ts
 type ConnState = "connected" | "disconnected" | "reconnecting";
@@ -1280,6 +1230,8 @@ interface HostApi {
   createHaBridge: typeof createHaBridge;
   disconnect: typeof disconnect;
   loadDemoData: typeof loadDemoData;
+  loadDemoHouse: typeof loadDemoHouse;
+  resetDemo: typeof resetDemo;
   unloadDemoData: typeof unloadDemoData;
 }
 /**
@@ -1295,4 +1247,4 @@ declare function claimHostApi(): HostApi | null;
 //#region src/index.d.ts
 declare const VERSION = "0.2.1";
 //#endregion
-export { type AreaId, type AreaQueryBuilder, type AreaView, type BridgeConnectOptions, type BridgeEvents, BridgeInvalidAuthError, type CalendarEvent, type CalendarEventsData, type CalendarWindowOptions, type CallServiceRequest, type CameraStream, type CameraStreamData, type CameraStreams, type CommandOptions, type CommandResult, type ConnState, type ConnectionOptions, type ConnectionState, type CoreEventType, DOMAINS_USE_LAST_UPDATED, type DeviceId, type DeviceView, type Domain, type EnergyDeviceConsumption, type EnergyPreferences, type EnergySource, type EntitiesQueryBuilder, type EntityCategory, type EntityDomain, type EntityForecastQueryOptions, type EntityHistoryData, type EntityHistoryQueryOptions, type EntityHistoryResult, type EntityHistoryState, type EntityId, type EntityQueryBuilder, type EntityRegistryEntry, type EntityStreamQueryOptions, type EntityUpdateFields, type EntityView, type EventStateChangedData, type ForecastQueryOptions, type ForecastResult, type ForecastType, type ForecastsResult, type GlassHomeState, type HAEvent, type HaBridge, type HassConfig, type HassEntity, type HassUnitSystem, type HistoryData, type HistoryPoint, type HistoryQueryOptions, type HistoryResult, type HistoryStates, type HostApi, LINE_ATTRIBUTES_TO_KEEP, MAX_HISTORY_POINTS, NEED_ATTRIBUTE_DOMAINS, type RegistryEntryDisabler, type RegistryEntryHider, type ServiceCall, type ServiceCallContext, type ServiceName, type ServiceTarget, type StatisticValue, type StatisticsPeriod, type StatisticsQueryOptions, type StreamFormat, type StreamQueryOptions, type StreamResult, type SyncLayerConnection, type TimelineState, type UnsubscribeFunc, VERSION, type WeatherForecast, type WeatherForecastData, type WeatherForecasts, type WeatherForecastsData, type WorkerScope, type WsCommandType, type WsResult, appendHistoryPoint, applyDemoServiceCall, area, areas, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, claimHostApi, createDemoFixtures, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, hassMediaUrl, historyStateToTimeline, isConnected, isDemoMode, isHistoryTracked, normalizeStatisticTime, refreshForecast, refreshForecasts, refreshStream, registerEntity, runHaBridgeWorker, searchEntities, sendCommand, sendWebRtcCandidate, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, untrackEntityHistory, updateEntity };
+export { type AreaId, type AreaQueryBuilder, type AreaView, type BridgeConnectOptions, type BridgeEvents, BridgeInvalidAuthError, type CalendarEvent, type CalendarEventsData, type CalendarWindowOptions, type CallServiceRequest, type CameraStream, type CameraStreamData, type CameraStreams, type CommandOptions, type CommandResult, type ConnState, type ConnectionOptions, type ConnectionState, type CoreEventType, DOMAINS_USE_LAST_UPDATED, type DemoClockOption, type DemoHouseOptions, type DeviceId, type DeviceView, type Domain, type EnergyDeviceConsumption, type EnergyPreferences, type EnergySource, type EntitiesQueryBuilder, type EntityCategory, type EntityDomain, type EntityForecastQueryOptions, type EntityHistoryData, type EntityHistoryQueryOptions, type EntityHistoryResult, type EntityHistoryState, type EntityId, type EntityQueryBuilder, type EntityRegistryEntry, type EntityStreamQueryOptions, type EntityUpdateFields, type EntityView, type EventStateChangedData, type ForecastQueryOptions, type ForecastResult, type ForecastType, type ForecastsResult, type GlassHomeState, type HAEvent, type HaBridge, type HassConfig, type HassEntity, type HassUnitSystem, type HistoryData, type HistoryPoint, type HistoryQueryOptions, type HistoryResult, type HistoryStates, type HostApi, LINE_ATTRIBUTES_TO_KEEP, MAX_HISTORY_POINTS, NEED_ATTRIBUTE_DOMAINS, type RegistryEntryDisabler, type RegistryEntryHider, type ServiceCall, type ServiceCallContext, type ServiceName, type ServiceTarget, type StatisticValue, type StatisticsPeriod, type StatisticsQueryOptions, type StreamFormat, type StreamQueryOptions, type StreamResult, type SyncLayerConnection, type TimelineState, type UnsubscribeFunc, VERSION, type WeatherForecast, type WeatherForecastData, type WeatherForecasts, type WeatherForecastsData, type WorkerScope, type WsCommandType, type WsResult, appendHistoryPoint, applyDemoServiceCall, area, areas, batchEntityUpdates, batchServiceCalls, buildAreaView, buildDeviceView, buildEntityView, bulkAppendHistoryPoints, callService, claimHostApi, createDemoFixtures, entities, entitiesByAreaAndDomain, entitiesWhere, entity, entityIdHistoryNeedsAttributes, entityViewEquals, extractDomain, fetchEnergyPreferences, fetchEntityHistory, fetchForecast, fetchForecastData, fetchForecasts, fetchHistory, fetchStatisticsDuringPeriod, fetchStream, fetchStreamData, getAllEntityViews, getAreaView, getAreaViews, getConnectionState, getEntityView, getEntityViews, getForecast, getForecasts, getStream, getWebRtcClientConfig, hassMediaUrl, historyStateToTimeline, isConnected, isDemoMode, isHistoryTracked, normalizeStatisticTime, refreshForecast, refreshForecasts, refreshStream, registerEntity, runHaBridgeWorker, searchEntities, sendCommand, sendWebRtcCandidate, startDemoEnergyTicker, startWebRtcSession, state, stopDemoEnergyTicker, toggle, trackEntityHistory, turnOff, turnOn, untrackEntityHistory, updateEntity };