@glasshome/sync-layer 0.7.2 → 0.8.0

package/dist/query/helpers.d.ts

@@ -1,21 +0,0 @@
-/**
- * Query Engine Helpers
- *
- * Helper functions to make query engine usage easier and more intuitive.
- *
- * @packageDocumentation
- */
-import type { AreaId, EntityDomain, EntityView } from "../core/types";
-import type { EntitiesQueryBuilder } from "./types";
-/**
- * Create a search query builder
- */
-export declare function searchEntities(searchText: string): EntitiesQueryBuilder<EntityView>;
-/**
- * Create a query for entities in an area by domain
- */
-export declare function entitiesByAreaAndDomain(areaId: AreaId, domain: EntityDomain): EntitiesQueryBuilder<EntityView>;
-/**
- * Create a query for entities matching a predicate
- */
-export declare function entitiesWhere(predicate: (entity: EntityView) => boolean): EntitiesQueryBuilder<EntityView>;

package/dist/query/memoization.d.ts

@@ -1,18 +0,0 @@
-/**
- * Query memoization
- *
- * @packageDocumentation
- */
-import type { QueryState } from "./types";
-/**
- * Build a unique signature for a query
- */
-export declare function buildQuerySignature(query: QueryState): string;
-/**
- * Execute query (no caching -- SolidJS createMemo handles this in Plan 03)
- */
-export declare function memoizedExecute<T>(_signature: string, compute: () => T): T;
-/**
- * Check if cache should be invalidated
- */
-export declare function isCacheStale(lastCheck: number, maxAge: number): boolean;

package/dist/query/projections.d.ts

@@ -1,74 +0,0 @@
-/**
- * Projection utilities
- *
- * Functions for transforming entity views into different shapes.
- *
- * @packageDocumentation
- */
-import type { EntityId, EntityView, MapFunc } from "../core/types";
-/**
- * Project entities to IDs only
- *
- * @param entities - Array of entity views
- * @returns Array of entity IDs
- */
-export declare function projectToIds(entities: EntityView[]): EntityId[];
-/**
- * Pick specific fields from entities
- *
- * @param entities - Array of entity views
- * @param keys - Array of field names to include
- * @returns Array of objects with only specified fields
- */
-export declare function projectPick<K extends keyof EntityView>(entities: EntityView[], keys: K[]): Pick<EntityView, K>[];
-/**
- * Pluck a single field from entities
- *
- * Supports dot-notation for nested fields (e.g., "attributes.brightness")
- *
- * @param entities - Array of entity views
- * @param key - Field name or dot-path to extract
- * @returns Array of field values
- */
-export declare function projectPluck(entities: EntityView[], key: string): any[];
-/**
- * Map entities using a custom function
- *
- * @param entities - Array of entity views
- * @param mapper - Function to transform each entity
- * @returns Array of mapped values
- */
-export declare function projectMap<R>(entities: EntityView[], mapper: MapFunc<EntityView, R>): R[];
-/**
- * Get nested value from object using dot-notation
- *
- * @param obj - Object to extract value from
- * @param path - Dot-notation path (e.g., "attributes.brightness")
- * @returns Value at path or undefined
- *
- * @example
- * ```typescript
- * const entity = { attributes: { brightness: 255 } };
- * getNestedValue(entity, "attributes.brightness"); // 255
- * ```
- */
-export declare function getNestedValue(obj: any, path: string): any;
-/**
- * Set nested value in object using dot-notation
- *
- * @param obj - Object to set value in
- * @param path - Dot-notation path
- * @param value - Value to set
- *
- * @internal
- */
-export declare function setNestedValue(obj: any, path: string, value: any): void;
-/**
- * Check if a value is a primitive
- *
- * @param value - Value to check
- * @returns True if primitive
- *
- * @internal
- */
-export declare function isPrimitive(value: any): boolean;

package/dist/query/types.d.ts

@@ -1,260 +0,0 @@
-/**
- * Query-related types
- *
- * Type definitions for the query builder system.
- *
- * @packageDocumentation
- */
-import type { AreaId, AreaView, Callback, DeviceId, EntityDomain, EntityId, EntityView, FloorId, LabelId, MapFunc, PredicateFunc, UnsubscribeFunc } from "../core/types";
-export type { UnsubscribeFunc };
-/**
- * Main query builder interface for multiple entities
- *
- * Provides a fluent API for filtering, sorting, projecting, and subscribing.
- *
- * @template T - The result type (defaults to EntityView)
- */
-export interface EntitiesQueryBuilder<T = EntityView> {
-    /**
-     * Filter by area
-     *
-     * @param areaId - Area ID to filter by
-     * @returns Query builder for chaining
-     */
-    byArea(areaId: AreaId): EntitiesQueryBuilder<T>;
-    /**
-     * Filter by domain
-     *
-     * @param domain - Domain to filter by (e.g., "light", "sensor")
-     * @returns Query builder for chaining
-     */
-    byDomain(domain: EntityDomain): EntitiesQueryBuilder<T>;
-    /**
-     * Filter by device
-     *
-     * @param deviceId - Device ID to filter by
-     * @returns Query builder for chaining
-     */
-    byDevice(deviceId: DeviceId): EntitiesQueryBuilder<T>;
-    /**
-     * Filter by floor
-     *
-     * @param floorId - Floor ID to filter by
-     * @returns Query builder for chaining
-     */
-    byFloor(floorId: FloorId): EntitiesQueryBuilder<T>;
-    /**
-     * Filter by label
-     *
-     * @param labelId - Label ID to filter by
-     * @returns Query builder for chaining
-     */
-    byLabel(labelId: LabelId): EntitiesQueryBuilder<T>;
-    /**
-     * Filter with custom predicate
-     *
-     * @param predicate - Function to test each entity
-     * @returns Query builder for chaining
-     */
-    where(predicate: PredicateFunc<EntityView>): EntitiesQueryBuilder<T>;
-    /**
-     * Search entities by text (searches id, name, friendlyName)
-     *
-     * @param searchText - Text to search for
-     * @returns Query builder for chaining
-     */
-    search(searchText: string): EntitiesQueryBuilder<T>;
-    /**
-     * Sort results
-     *
-     * @param key - Property key or dot-path (e.g., "name", "attributes.brightness")
-     * @param direction - Sort direction ("asc" or "desc")
-     * @returns Query builder for chaining
-     */
-    orderBy(key: string, direction?: "asc" | "desc"): EntitiesQueryBuilder<T>;
-    /**
-     * Project to entity IDs only
-     *
-     * @returns Query builder for entity IDs
-     */
-    ids(): EntitiesQueryBuilder<EntityId>;
-    /**
-     * Pick specific fields
-     *
-     * @param keys - Array of field names to include
-     * @returns Query builder with picked fields
-     */
-    pick<K extends keyof EntityView>(keys: K[]): EntitiesQueryBuilder<Pick<EntityView, K>>;
-    /**
-     * Extract a single field from each entity
-     *
-     * @param key - Field name to extract
-     * @returns Query builder for field values
-     */
-    pluck<K extends keyof EntityView>(key: K): EntitiesQueryBuilder<EntityView[K]>;
-    /**
-     * Map entities to new values
-     *
-     * @param mapper - Function to transform each entity
-     * @returns Query builder for mapped values
-     */
-    map<R>(mapper: MapFunc<EntityView, R>): EntitiesQueryBuilder<R>;
-    /**
-     * Limit the number of results
-     *
-     * @param limit - Maximum number of results to return
-     * @returns Query builder for chaining
-     */
-    take(limit: number): EntitiesQueryBuilder<T>;
-    /**
-     * Skip a number of results (for pagination)
-     *
-     * @param count - Number of results to skip
-     * @returns Query builder for chaining
-     */
-    skip(count: number): EntitiesQueryBuilder<T>;
-    /**
-     * Get distinct values by a key
-     *
-     * @param key - Field name or dot-path to get distinct values for
-     * @returns Query builder for distinct values
-     */
-    distinct(key: string): EntitiesQueryBuilder<T>;
-    /**
-     * Execute query and return results
-     *
-     * @returns Array of results
-     */
-    get(): T[];
-    /**
-     * Get first result
-     *
-     * @returns First result or undefined
-     */
-    first(): T | undefined;
-    /**
-     * Subscribe to query results
-     *
-     * Receives updates when entities matching the query change.
-     *
-     * @param callback - Function called with results
-     * @returns Unsubscribe function
-     */
-    subscribe(callback: Callback<T[]>): UnsubscribeFunc;
-}
-/**
- * Query builder interface for areas
- */
-export interface AreaQueryBuilder {
-    /**
-     * Filter areas by floor
-     */
-    byFloor(floorId: FloorId): AreaQueryBuilder;
-    /**
-     * Filter areas by label
-     */
-    byLabel(labelId: LabelId): AreaQueryBuilder;
-    /**
-     * Filter areas using a predicate
-     */
-    where(predicate: PredicateFunc<AreaView>): AreaQueryBuilder;
-    /**
-     * Order results by a key
-     */
-    orderBy(key: keyof AreaView | string, direction?: "asc" | "desc"): AreaQueryBuilder;
-    /**
-     * Execute query and get results
-     */
-    get(): AreaView[];
-    /**
-     * Get first result
-     */
-    first(): AreaView | undefined;
-    /**
-     * Subscribe to query results
-     */
-    subscribe(callback: Callback<AreaView[]>): UnsubscribeFunc;
-}
-/**
- * Query builder interface for a single entity
- */
-export interface EntityQueryBuilder {
-    /**
-     * Get entity view
-     *
-     * @returns Entity view or undefined
-     */
-    get(): EntityView | undefined;
-    /**
-     * Extract a single field
-     *
-     * @param key - Field name to extract
-     * @returns Field value or undefined
-     */
-    pluck<K extends keyof EntityView>(key: K): EntityView[K] | undefined;
-    /**
-     * Subscribe to entity changes
-     *
-     * @param callback - Function called with entity view
-     * @returns Unsubscribe function
-     */
-    subscribe(callback: Callback<EntityView | undefined>): UnsubscribeFunc;
-}
-/**
- * Internal query state (not exported)
- *
- * @internal
- */
-export interface QueryState {
-    /** Index-based filters (use indices for fast lookup) */
-    indexFilters: IndexFilter[];
-    /** Predicate-based filters (run on each entity) */
-    predicateFilters: PredicateFunc<EntityView>[];
-    /** Sort functions */
-    sorts: SortConfig[];
-    /** Projection configuration */
-    projection?: ProjectionConfig;
-    /** Search text (for text search functionality) */
-    searchText?: string;
-    /** Limit number of results */
-    take?: number;
-    /** Skip number of results (for pagination) */
-    skip?: number;
-    /** Distinct key for deduplication */
-    distinct?: string;
-}
-/**
- * Index filter (uses store indices for fast lookup)
- *
- * @internal
- */
-export interface IndexFilter {
-    type: "domain" | "area" | "device" | "floor" | "label";
-    value: string;
-}
-/**
- * Sort configuration
- *
- * @internal
- */
-export interface SortConfig {
-    key: string;
-    direction: "asc" | "desc";
-}
-/**
- * Projection configuration
- *
- * @internal
- */
-export type ProjectionConfig = {
-    type: "ids";
-} | {
-    type: "pick";
-    keys: string[];
-} | {
-    type: "pluck";
-    key: string;
-} | {
-    type: "map";
-    mapper: MapFunc<EntityView, any>;
-};

package/dist/solid/hooks.d.ts

@@ -1,119 +0,0 @@
-/**
- * SolidJS Hooks for Sync-Layer
- *
- * Thin createMemo wrappers over the native SolidJS store.
- * Since the store IS SolidJS (Plan 01 replaced Zustand with createStore),
- * no subscription bridge is needed -- SolidJS auto-tracks fine-grained
- * reactivity through the store proxy.
- *
- * Every hook is just `createMemo(() => state.something)`.
- *
- * @packageDocumentation
- */
-import type { HassConfig, HassUnitSystem } from "@glasshome/ha-types";
-import type { Accessor, Resource } from "solid-js";
-import type { AreaView, CameraStreamData, ConnectionState, EntityHistoryData, EntityView, GlassHomeState, HassEntity, StatisticsQueryOptions, StatisticValue, WeatherForecastsData } from "@glasshome/sync-layer";
-import { callService, toggle, turnOff, turnOn } from "../commands/service";
-import type { CalendarEventsData, CalendarWindowOptions } from "../calendar/types";
-/**
- * Get a reactive EntityView for an entity ID.
- *
- * Registers the entity for live updates via the subscription manager.
- * Only re-runs when the specific entity's data changes.
- */
-export declare function useEntity(entityId: Accessor<string> | string): Accessor<EntityView | undefined>;
-/**
- * Get reactive EntityViews for multiple entity IDs.
- *
- * Registers all entity IDs for live updates via the subscription manager.
- */
-export declare function useEntities(entityIds: Accessor<string[]>): Accessor<EntityView[]>;
-/**
- * Get raw HassEntity state (without EntityView transformation).
- *
- * Registers the entity for live updates via the subscription manager.
- */
-export declare function useEntityState(entityId: Accessor<string> | string): Accessor<HassEntity | undefined>;
-/**
- * Get reactive connection status.
- */
-export declare function useConnection(): {
-    status: Accessor<ConnectionState>;
-    isConnected: Accessor<boolean>;
-};
-/** Reactive Home Assistant core config (null until loaded). */
-export declare function useHassConfig(): Accessor<HassConfig | null>;
-/** Reactive HA unit system (length/mass/temperature/volume), or null until loaded. */
-export declare function useUnitSystem(): Accessor<HassUnitSystem | null>;
-/** Reactive temperature unit from HA config, including the degree sign. Defaults to "°C". */
-export declare function useTemperatureUnit(): Accessor<string>;
-/** Reactive UI locale (BCP 47 tag) from HA config. Defaults to "en". */
-export declare function useLocale(): Accessor<string>;
-/** Reactive currency (ISO 4217) from HA config. Defaults to "USD". */
-export declare function useCurrency(): Accessor<string>;
-/**
- * Get all service call functions.
- */
-export declare function useService(): {
-    callService: typeof callService;
-    turnOn: typeof turnOn;
-    turnOff: typeof turnOff;
-    toggle: typeof toggle;
-};
-/** Get turnOn command function */
-export declare function useTurnOn(): typeof turnOn;
-/** Get turnOff command function */
-export declare function useTurnOff(): typeof turnOff;
-/** Get toggle command function */
-export declare function useToggle(): typeof toggle;
-/**
- * Get reactive list of all area views.
- */
-export declare function useAreas(): Accessor<AreaView[]>;
-/**
- * Get a reactive AreaView for a specific area.
- *
- * Registers all entities in the area for live updates.
- */
-export declare function useArea(areaId: Accessor<string> | string): Accessor<AreaView | undefined>;
-/**
- * Get reactive entity history data.
- *
- * History data is populated into the store via subscriptions;
- * this hook simply reads it reactively.
- */
-export declare function useEntityHistory(entityId: Accessor<string> | string): Accessor<EntityHistoryData | undefined>;
-/**
- * Get reactive long-term statistics for a statistic id.
- *
- * Fetches via `recorder/statistics_during_period` and re-fetches whenever the
- * statistic id or options change. The returned Resource exposes `.loading`
- * and `.error` alongside the value accessor.
- */
-export declare function useEntityStatistics(statisticId: Accessor<string> | string, options: Accessor<StatisticsQueryOptions> | StatisticsQueryOptions): Resource<StatisticValue[]>;
-/**
- * Get reactive camera stream data.
- */
-export declare function useCamera(entityId: Accessor<string> | string): {
-    stream: Accessor<CameraStreamData | null>;
-    refresh: () => void;
-};
-/**
- * Live calendar events for one calendar entity.
- *
- * Tracks the entity on mount (opening or joining the shared
- * `calendar/event/subscribe`) and untracks on cleanup; HA pushes the initial
- * snapshot and every later change, so the accessor is reactive with no
- * polling. `undefined` until the subscription is established.
- */
-export declare function useCalendarEvents(entityId: Accessor<string> | string, options?: CalendarWindowOptions): Accessor<CalendarEventsData | undefined>;
-/**
- * Get reactive weather forecast data.
- */
-export declare function useForecast(entityId: Accessor<string> | string): Accessor<WeatherForecastsData | undefined>;
-/**
- * Escape hatch for direct store access with a selector.
- *
- * Use when no specific hook exists for your data need.
- */
-export declare function useStore<T>(selector: (s: GlassHomeState) => T): Accessor<T>;

package/dist/solid/indices.d.ts

@@ -1,15 +0,0 @@
-/** Reactive derived entity indices. Each call reads from the SolidJS store directly,
- * so consumers wrap in createMemo within their own reactive root for memoization. */
-import type { Accessor } from "solid-js";
-/** Entity IDs grouped by domain (e.g., "light" -> ["light.living_room", ...]) */
-export declare const byDomain: Accessor<Record<string, string[]>>;
-/** Entity IDs grouped by area (via entity registry area_id) */
-export declare const byArea: Accessor<Record<string, string[]>>;
-/** Entity IDs grouped by device (via entity registry device_id) */
-export declare const byDevice: Accessor<Record<string, string[]>>;
-/** Entity IDs grouped by floor (device -> area -> floor chain) */
-export declare const byFloor: Accessor<Record<string, string[]>>;
-/** Entity IDs grouped by label */
-export declare const byLabel: Accessor<Record<string, string[]>>;
-/** All entity IDs currently in the store */
-export declare const allEntityIds: Accessor<string[]>;

package/dist/weather/fetch.d.ts

@@ -1,19 +0,0 @@
-/**
- * Weather Forecast Fetching
- *
- * @packageDocumentation
- */
-import type { EntityId } from "../core/types";
-import type { ForecastType, WeatherForecast, WeatherForecastData, WeatherForecastsData } from "./types";
-/**
- * Fetch forecast for a single entity and type
- */
-export declare function fetchForecast(entityId: EntityId, type: ForecastType): Promise<WeatherForecast[]>;
-/**
- * Fetch forecasts for a single entity and multiple types
- */
-export declare function fetchForecasts(entityId: EntityId, types: ForecastType[]): Promise<WeatherForecastsData>;
-/**
- * Fetch forecast data with error handling
- */
-export declare function fetchForecastData(entityId: EntityId, type: ForecastType): Promise<WeatherForecastData>;

package/dist/weather/query.d.ts

@@ -1,23 +0,0 @@
-/**
- * Weather Forecast Query Builder
- *
- * @packageDocumentation
- */
-import type { EntityId } from "../core/types";
-import type { ForecastType, WeatherForecastData, WeatherForecastsData } from "./types";
-/**
- * Get forecast for a single entity and type
- */
-export declare function getForecast(entityId: EntityId, type: ForecastType): Promise<WeatherForecastData>;
-/**
- * Get forecasts for a single entity and multiple types
- */
-export declare function getForecasts(entityId: EntityId, types: ForecastType[]): Promise<WeatherForecastsData>;
-/**
- * Refresh forecast
- */
-export declare function refreshForecast(entityId: EntityId, type: ForecastType): Promise<WeatherForecastData>;
-/**
- * Refresh forecasts
- */
-export declare function refreshForecasts(entityId: EntityId, types: ForecastType[]): Promise<WeatherForecastsData>;

package/dist/weather/types.d.ts

@@ -1,126 +0,0 @@
-/**
- * Weather Types
- *
- * Type definitions for weather forecast data.
- *
- * @packageDocumentation
- */
-import type { EntityId } from "../core/types";
-/**
- * Forecast type
- * Supported forecast types from Home Assistant Weather API
- */
-export type ForecastType = "hourly" | "daily" | "twice_daily";
-/**
- * Weather forecast entry
- * Represents a single forecast point from Home Assistant
- */
-export interface WeatherForecast {
-    /** Forecast datetime (ISO 8601) */
-    datetime: string;
-    /** Temperature (in unit system) */
-    temperature?: number;
-    /** Temperature low (for daily forecasts) */
-    temp_low?: number;
-    /** Temperature high (for daily forecasts) */
-    temp_high?: number;
-    /** Humidity percentage */
-    humidity?: number;
-    /** Wind bearing (degrees) */
-    wind_bearing?: number;
-    /** Wind speed (in unit system) */
-    wind_speed?: number;
-    /** Precipitation probability (0-100) */
-    precipitation?: number;
-    /** Precipitation amount (in unit system) */
-    precipitation_probability?: number;
-    /** Condition (e.g., "sunny", "cloudy", "rainy") */
-    condition?: string;
-    /** Pressure (in unit system) */
-    pressure?: number;
-    /** Cloud coverage (0-100) */
-    cloud_coverage?: number;
-    /** UV index */
-    uv_index?: number;
-    /** Additional forecast data */
-    [key: string]: any;
-}
-/**
- * Weather forecast data for a single type
- */
-export interface WeatherForecastData {
-    /** Entity ID */
-    entityId: EntityId;
-    /** Forecast type */
-    type: ForecastType;
-    /** Forecast entries */
-    forecast: WeatherForecast[];
-    /** Loading state */
-    loading: boolean;
-    /** Error if any */
-    error: Error | null;
-    /** Last fetched timestamp */
-    lastFetched: number | null;
-}
-/**
- * Weather forecast data for multiple types
- */
-export interface WeatherForecastsData {
-    /** Entity ID */
-    entityId: EntityId;
-    /** Forecast data by type */
-    forecasts: Partial<Record<ForecastType, WeatherForecast[]>>;
-    /** Loading states by type */
-    loading: Partial<Record<ForecastType, boolean>>;
-    /** Errors by type */
-    errors: Partial<Record<ForecastType, Error | null>>;
-    /** Last fetched timestamps by type */
-    lastFetched: Partial<Record<ForecastType, number | null>>;
-}
-/**
- * Weather forecast data for multiple entities
- */
-export interface WeatherForecasts {
-    /** Entity ID -> Forecast data */
-    [entityId: EntityId]: WeatherForecastsData;
-}
-/**
- * Options for forecast queries
- */
-export interface ForecastQueryOptions {
-    /** Forecast type(s) to fetch */
-    type?: ForecastType;
-    /** Multiple forecast types to fetch */
-    types?: ForecastType[];
-}
-/**
- * Single entity forecast query options
- */
-export interface EntityForecastQueryOptions {
-    /** Forecast type(s) to fetch */
-    type?: ForecastType;
-    /** Multiple forecast types to fetch */
-    types?: ForecastType[];
-}
-/**
- * Forecast query result for a single type
- */
-export interface ForecastResult {
-    /** Forecast data */
-    data: WeatherForecastData | null;
-    /** Loading state */
-    loading: boolean;
-    /** Error if any */
-    error: Error | null;
-}
-/**
- * Forecast query result for multiple types
- */
-export interface ForecastsResult {
-    /** Forecast data */
-    data: WeatherForecastsData | null;
-    /** Loading states by type */
-    loading: Partial<Record<ForecastType, boolean>>;
-    /** Errors by type */
-    errors: Partial<Record<ForecastType, Error | null>>;
-}