@glasshome/sync-layer 0.1.14 → 0.1.16

package/dist/core/store.d.ts

@@ -23,6 +23,8 @@ export interface GlassHomeState {
     connectionError: Error | null;
     /** Home Assistant base URL */
     hassUrl: 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) */

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

@@ -19,6 +19,6 @@ export interface DemoFixtures {
  *
  * Entities span lights, sensors, binary sensors, climate, covers,
  * locks, switches, media player, weather, camera, scenes, and buttons
- * across 4 areas: living_room, bedroom, kitchen, entry.
+ * across 6 areas: living_room, bedroom, kitchen, entry, utility, garage.
  */
 export declare function createDemoFixtures(): DemoFixtures;

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

@@ -21,6 +21,13 @@ 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.
  *

package/dist/demo/energy-sim.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Demo Energy Simulation
+ *
+ * A pure, deterministic model of a solar home: solar production, household
+ * load with appliance events, a battery that charges on surplus and covers
+ * deficits, and grid import/export as the residual.
+ *
+ * `simulateEnergy(timestampMs)` is the single source of truth. Live ticks,
+ * day history, and long-term statistics are all derived from it, so every
+ * widget agrees with every other widget. There is no hidden mutable state:
+ * the only module-level data is a memoization cache of a pure computation
+ * (battery SOC integrated from local midnight).
+ *
+ * @packageDocumentation
+ */
+/** Every instantaneous value of the home energy system, in watts (SOC in %). */
+export interface EnergySample {
+    solarW: number;
+    homeW: number;
+    batteryChargeW: number;
+    batteryDischargeW: number;
+    batterySocPct: number;
+    gridImportW: number;
+    gridExportW: number;
+    fridgeW: number;
+    dishwasherW: number;
+    washerW: number;
+    ovenW: number;
+    evChargerW: number;
+    alwaysOnW: number;
+}
+interface LocalTime {
+    /** Local hour as a fraction (e.g. 13.5 = 13:30). */
+    hourFrac: number;
+    /** Minutes since local midnight. */
+    minuteOfDay: number;
+    /** 0 = Sunday .. 6 = Saturday. */
+    dayOfWeek: number;
+    /** Integer day-of-year-ish key (days since epoch in local time). */
+    dayKey: number;
+}
+/** Coarse solar elevation in degrees for sun.sun attributes. */
+export declare function sunElevation(lt: LocalTime): number;
+/**
+ * Compute every instantaneous energy value at a timestamp.
+ *
+ * Deterministic: equal timestamps always yield deep-equal samples. Obeys the
+ * conservation invariant
+ * `solar + gridImport + batteryDischarge === home + gridExport + batteryCharge`
+ * to within rounding.
+ */
+export declare function simulateEnergy(timestampMs: number): EnergySample;
+/** Whether the sun is above the horizon at a timestamp. */
+export declare function isSunUp(timestampMs: number): boolean;
+/** Next sunrise/sunset ISO strings relative to a timestamp. */
+export declare function sunEvents(timestampMs: number): {
+    nextRising: string;
+    nextSetting: string;
+    elevation: number;
+};
+/** The energy sensor entity ids the simulation drives. */
+export declare const ENERGY_ENTITY_IDS: readonly ["sensor.solar_power", "sensor.grid_import_power", "sensor.grid_export_power", "sensor.battery_charge_power", "sensor.battery_discharge_power", "sensor.battery_soc", "sensor.home_power", "sensor.fridge_power", "sensor.dishwasher_power", "sensor.washing_machine_power", "sensor.oven_power", "sensor.ev_charger_power", "sensor.always_on_power"];
+export type EnergyEntityId = (typeof ENERGY_ENTITY_IDS)[number];
+/** Map an energy entity id to its numeric value from a sample (W, or % for SOC). */
+export declare function energyEntityValue(entityId: string, sample: EnergySample): number | undefined;
+/** Whether an entity id is one of the simulated energy sensors. */
+export declare function isEnergyEntity(entityId: string): boolean;
+/** Round to 1 decimal for display-friendly state strings (whole % for SOC). */
+export declare function formatEnergyState(entityId: string, value: number): string;
+/** A synthesized history point: ms-epoch last-updated + string state. */
+export interface DemoHistoryPoint {
+    /** Unix seconds (HA history wire format). */
+    lu: number;
+    /** State value as string. */
+    s: string;
+}
+/**
+ * Synthesize history points for one energy entity by sampling the model across
+ * the window at a fixed cadence (default 1-minute). Returns HA-compressed
+ * `{ lu, s }` points with `lu` in Unix seconds.
+ */
+export declare function synthesizeEnergyHistory(entityId: string, startMs: number, endMs: number, stepMs?: number): DemoHistoryPoint[];
+/** One synthesized statistics bucket (ms-epoch start/end). */
+export interface DemoStatisticBucket {
+    start: number;
+    end: number;
+    mean: number;
+    min: number;
+    max: number;
+    /** Energy in Wh accumulated over the bucket (W-h integration). */
+    sum: number;
+}
+/**
+ * Synthesize statistics buckets for one energy entity across a window.
+ *
+ * `mean`/`min`/`max` come from 5-minute power samples in the bucket; `sum` is
+ * the energy in Wh (mean W times bucket hours). `sum` is cumulative across the
+ * window, matching HA's monotonically increasing meter semantics.
+ */
+export declare function synthesizeEnergyStatistics(entityId: string, startMs: number, endMs: number, period: "hour" | "day"): DemoStatisticBucket[];
+/** The demo energy dashboard preferences wiring the simulated sensors. */
+export declare function demoEnergyPreferences(): {
+    energy_sources: Array<Record<string, unknown>>;
+    device_consumption: Array<Record<string, unknown>>;
+};
+export {};