@glasshome/sync-layer 0.1.0

package/dist/history/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * History Types
+ *
+ * Type definitions for entity history data.
+ * Based on Home Assistant frontend implementation.
+ *
+ * @packageDocumentation
+ */
+import type { EntityId } from "../core/types";
+/**
+ * History states record
+ * Maps entity IDs to their history state arrays
+ *
+ * Based on HA frontend: HistoryStates
+ */
+export type HistoryStates = Record<string, EntityHistoryState[]>;
+/**
+ * History stream message
+ * Used for history/stream subscription
+ *
+ * Based on HA frontend: HistoryStreamMessage
+ */
+export interface HistoryStreamMessage {
+    /** History states */
+    states: HistoryStates;
+    /** Start time of this historical chunk (Unix timestamp in seconds) */
+    start_time?: number;
+    /** End time of this historical chunk (Unix timestamp in seconds) */
+    end_time?: number;
+}
+/**
+ * Entity history state point
+ * Represents a single point in entity history from Home Assistant
+ *
+ * Based on HA frontend: EntityHistoryState
+ */
+export interface EntityHistoryState {
+    /** State value (compressed format from HA) */
+    s: string;
+    /** Attributes */
+    a: Record<string, any>;
+    /** Last changed timestamp (Unix timestamp in seconds, optional; if set, also applies to lu) */
+    lc?: number;
+    /** Last updated timestamp (Unix timestamp in seconds) */
+    lu: number;
+}
+/**
+ * Timeline state point
+ * Represents a point in the timeline with full data
+ */
+export interface TimelineState {
+    /** Timestamp (Unix timestamp in seconds) */
+    timestamp: number;
+    /** State value */
+    state: string;
+    /** Attributes */
+    attributes?: Record<string, any>;
+    /** Last changed timestamp */
+    lastChanged?: number;
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+/**
+ * History data for a single entity
+ */
+export interface EntityHistoryData {
+    /** Entity ID */
+    entityId: EntityId;
+    /** Timeline data points */
+    timeline: TimelineState[];
+    /** Compressed history states (from HA API) */
+    entityHistory: EntityHistoryState[];
+    /** Loading state */
+    loading: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Last fetched timestamp */
+    lastFetched: number | null;
+}
+/**
+ * History data for multiple entities
+ */
+export interface HistoryData {
+    /** Entity ID -> History data */
+    [entityId: EntityId]: EntityHistoryData;
+}
+/**
+ * Options for history queries
+ *
+ * Based on HA frontend fetchDateWS parameters
+ */
+export interface HistoryQueryOptions {
+    /** Start time (required) */
+    startTime: Date;
+    /** End time (optional, defaults to now) */
+    endTime?: Date;
+    /** Entity IDs to query (optional, defaults to all) */
+    entityIds?: EntityId[];
+    /** Include start time state */
+    includeStartTimeState?: boolean;
+    /** Only significant changes */
+    significantChangesOnly?: boolean;
+    /** Minimal response (defaults to true, matching HA frontend) */
+    minimalResponse?: boolean;
+    /** No attributes (if not provided, automatically determined based on entity domains) */
+    noAttributes?: boolean;
+}
+/**
+ * Single entity history query options
+ */
+export interface EntityHistoryQueryOptions {
+    /** Start time (required) */
+    startTime: Date;
+    /** End time (optional, defaults to now) */
+    endTime?: Date;
+    /** Include start time state */
+    includeStartTimeState?: boolean;
+    /** Only significant changes */
+    significantChangesOnly?: boolean;
+    /** Minimal response (no attributes) */
+    minimalResponse?: boolean;
+    /** No attributes */
+    noAttributes?: boolean;
+}
+/**
+ * History query result
+ */
+export interface HistoryResult {
+    /** History data for each entity */
+    data: HistoryData;
+    /** Loading state */
+    loading: boolean;
+    /** Error if any */
+    error: Error | null;
+}
+/**
+ * Single entity history result
+ */
+export interface EntityHistoryResult {
+    /** History data */
+    data: EntityHistoryData | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error if any */
+    error: Error | null;
+}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @glasshome/sync-layer
+ *
+ * Type-safe, reactive state synchronization layer for Home Assistant
+ * Uses SolidJS createStore for reactive state management.
+ *
+ * @packageDocumentation
+ */
+export { addDebugIncomingMessageListener, addDebugOutgoingMessageListener, } from "./connection/adapter";
+export type { ConnectionOptions } from "./connection/manager";
+export { disconnect, getConnection, initConnection, isConnected } from "./connection/manager";
+export type { SyncLayerConnection } from "./connection/types";
+export type { OAuthOptions } from "./connection/auth";
+export { authenticateWithOAuth, authenticateWithToken, isAuthValid, refreshAuth, } from "./connection/auth";
+export { area, areas } from "./query/area-builder";
+export { entities, entity } from "./query/builder";
+export { entitiesByAreaAndDomain, entitiesWhere, searchEntities, } from "./query/helpers";
+export type { AreaQueryBuilder, EntitiesQueryBuilder, EntityQueryBuilder, UnsubscribeFunc, } from "./query/types";
+export { batchEntityUpdates, batchServiceCalls, callService, sendCommand, toggle, turnOff, turnOn, updateEntity, } from "./commands/service";
+export type { CommandOptions, CommandResult, EntityUpdateFields, ServiceCallContext, ServiceTarget, } from "./commands/types";
+export type { GlassHomeState } from "./core/store";
+export type { AreaId, AreaView, DeviceId, DeviceView, EntityDomain, EntityId, EntityView, HassEntity, } from "./core/types";
+export { resetStore, setState, state } from "./core/store";
+export type { CallServiceRequest, CoreEventType, Domain, EntityCategory, EntityRegistryEntry, EventStateChangedData, HAEvent, RegistryEntryDisabler, RegistryEntryHider, ServiceCall, ServiceName, WsCommandType, WsResult, } from "@glasshome/ha-types";
+export { fetchStream, fetchStreamData } from "./camera/fetch";
+export { getStream, refreshStream } from "./camera/query";
+export type { CameraStream, CameraStreamData, CameraStreams, EntityStreamQueryOptions, StreamFormat, StreamQueryOptions, StreamResult, } from "./camera/types";
+export { getWebRtcClientConfig, sendWebRtcCandidate, startWebRtcSession, } from "./camera/webrtc";
+export { buildAreaView, buildDeviceView, getAreaView, getAreaViews, } from "./entities/area-views";
+export { buildEntityView, getAllEntityViews, getEntityView, getEntityViews, } from "./entities/views";
+export { DOMAINS_USE_LAST_UPDATED, entityIdHistoryNeedsAttributes, LINE_ATTRIBUTES_TO_KEEP, NEED_ATTRIBUTE_DOMAINS, } from "./history/constants";
+export { fetchEntityHistory, fetchHistory, historyStateToTimeline } from "./history/fetch";
+export { appendHistoryPoint, isHistoryTracked, trackEntityHistory, untrackEntityHistory, } from "./history/query";
+export type { EntityHistoryData, EntityHistoryQueryOptions, EntityHistoryResult, EntityHistoryState, HistoryData, HistoryQueryOptions, HistoryResult, HistoryStates, TimelineState, } from "./history/types";
+export { fetchForecast, fetchForecastData, fetchForecasts } from "./weather/fetch";
+export { getForecast, getForecasts, refreshForecast, refreshForecasts } from "./weather/query";
+export type { EntityForecastQueryOptions, ForecastQueryOptions, ForecastResult, ForecastsResult, ForecastType, WeatherForecast, WeatherForecastData, WeatherForecasts, WeatherForecastsData, } from "./weather/types";
+export declare const VERSION = "0.1.0";