@glasshome/sync-layer 0.9.0 → 0.9.1

package/README.md

@@ -15,23 +15,10 @@ bun add @glasshome/sync-layer @glasshome/ha-types
 ## Quick Start
 
 ```typescript
-import {
-  initConnection,
-  getConnection,
-  state,
-  entity,
-  entities,
-  callService,
-} from "@glasshome/sync-layer";
-
-// Connect to Home Assistant
-await initConnection({
-  hassUrl: "http://homeassistant.local:8123",
-  token: "YOUR_LONG_LIVED_ACCESS_TOKEN",
-});
+import { entity, entities, callService } from "@glasshome/sync-layer";
 
-// Access reactive state
-console.log(state.connectionState); // "connected"
+// The host app (GlassHome Dash) owns the Home Assistant connection: it runs the
+// worker-backed bridge through claimHostApi(). Widgets only read and call.
 
 // Query a single entity
 const light = entity("light.living_room").get();

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<{
@@ -1201,7 +1173,7 @@ declare function stopDemoEnergyTicker(): void;
  * 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?: {
+declare function applyDemoServiceCall(_domain: string, service: string, serviceData?: Record<string, any>, target?: {
   entity_id?: string | string[];
 }): void;
 //#endregion