@enyo-energy/energy-app-sdk 0.0.127 → 0.0.128

package/dist/cjs/packages/eebus/eebus-hvac-client.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/packages/eebus/eebus-hvac-client.d.cts

@@ -0,0 +1,61 @@
+import { EebusHvacOperationMode, EebusHvacZoneState } from '../../types/enyo-eebus-use-cases.cjs';
+/**
+ * Client for the EEBUS **Hvac** feature.
+ *
+ * The Hvac feature reports heating/cooling operation mode and per-zone state
+ * (current temperature, active mode). Pair with the
+ * {@link EebusSetpointClient} Setpoint feature to read or write target values.
+ * Zone ids align with `Identification.identificationListData`, so callers can
+ * map zone state to human-readable zone names.
+ *
+ * The client exposes both actor roles on a single interface:
+ * - **EMS role (outbound):** {@link getOperationMode}, {@link setOperationMode},
+ *   {@link getZoneStates}, {@link onZoneStateChanged}
+ * - **CS role (inbound):** {@link provideOperationMode}, {@link provideZoneStates}
+ *
+ * Consumers that only act in one role simply never call the other half — there
+ * is no `asManager` / `asAppliance` split.
+ */
+export interface EebusHvacClient {
+    /**
+     * Read the active heating/cooling operation mode from the remote node.
+     */
+    getOperationMode: () => Promise<EebusHvacOperationMode>;
+    /**
+     * Request the remote node to switch to the given operation mode. The
+     * remote may reject modes it does not advertise — verify support via
+     * `EebusIdentityService.getSupportedUseCases` before calling.
+     * @param mode The operation mode to select on the remote
+     */
+    setOperationMode: (mode: EebusHvacOperationMode) => Promise<void>;
+    /**
+     * Read per-zone Hvac state (current temperature, active mode) from the
+     * remote node.
+     * @returns The state of each zone reported by the remote.
+     */
+    getZoneStates: () => Promise<EebusHvacZoneState[]>;
+    /**
+     * Subscribe to per-zone Hvac state updates. The listener fires once per
+     * zone whenever the remote republishes its state.
+     * @param listener Callback invoked with the updated zone state
+     * @returns Listener ID that can be passed to {@link removeListener} to cancel
+     */
+    onZoneStateChanged: (listener: (state: EebusHvacZoneState) => void) => string;
+    /**
+     * Register a provider that supplies this device's current operation mode
+     * when a remote EMS reads it.
+     * @param provider Async callback returning the active operation mode
+     */
+    provideOperationMode: (provider: () => Promise<EebusHvacOperationMode>) => void;
+    /**
+     * Register a provider that supplies this device's current per-zone state
+     * when a remote EMS reads it.
+     * @param provider Async callback returning the current zone-state list
+     */
+    provideZoneStates: (provider: () => Promise<EebusHvacZoneState[]>) => void;
+    /**
+     * Remove a listener previously registered via {@link onZoneStateChanged}.
+     * @param listenerId The ID returned by the registration method
+     */
+    removeListener: (listenerId: string) => void;
+}

package/dist/cjs/packages/eebus/eebus-setpoint-client.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/packages/eebus/eebus-setpoint-client.d.cts

@@ -0,0 +1,59 @@
+import { EebusSetpointValue } from '../../types/enyo-eebus-use-cases.cjs';
+/**
+ * Client for the EEBUS **Setpoint** feature.
+ *
+ * The Setpoint feature carries the target value(s) of a controllable
+ * parameter on a remote node — most commonly the per-zone target temperature
+ * on a heat pump (paired with the {@link EebusHvacClient} Hvac feature for
+ * measured values). Setpoint ids align with the zone ids reported by
+ * `Identification.identificationListData`, so callers can map setpoints to
+ * human-readable zone names.
+ *
+ * The client exposes both actor roles on a single interface:
+ * - **EMS role (outbound):** {@link getSetpoints}, {@link setSetpoint},
+ *   {@link onSetpointsChanged}
+ * - **CS role (inbound):** {@link provideSetpoints}, {@link onSetpointReceived}
+ *
+ * Consumers that only act in one role simply never call the other half — there
+ * is no `asManager` / `asAppliance` split.
+ */
+export interface EebusSetpointClient {
+    /**
+     * Read the current setpoints reported by the remote node.
+     * @returns The full list of setpoints currently published by the remote.
+     */
+    getSetpoints: () => Promise<EebusSetpointValue[]>;
+    /**
+     * Send a setpoint to the remote node. The remote applies the value to the
+     * setpoint identified by {@link EebusSetpointValue.setpointId}; existing
+     * setpoints at other ids are left unchanged.
+     * @param value The setpoint to apply
+     */
+    setSetpoint: (value: EebusSetpointValue) => Promise<void>;
+    /**
+     * Subscribe to setpoint-list updates from the remote node. The listener is
+     * invoked with the full current list whenever the remote republishes.
+     * @param listener Callback invoked with the new setpoint list
+     * @returns Listener ID that can be passed to {@link removeListener} to cancel
+     */
+    onSetpointsChanged: (listener: (values: EebusSetpointValue[]) => void) => string;
+    /**
+     * Register a provider that supplies this device's current setpoints when a
+     * remote EMS reads them.
+     * @param provider Async callback returning the current setpoint list
+     */
+    provideSetpoints: (provider: () => Promise<EebusSetpointValue[]>) => void;
+    /**
+     * Register a handler invoked when a remote EMS writes a setpoint to this
+     * device. Implementations should apply the value to the local controller.
+     * @param handler Callback invoked with the incoming setpoint
+     * @returns Listener ID that can be passed to {@link removeListener} to deregister
+     */
+    onSetpointReceived: (handler: (value: EebusSetpointValue) => Promise<void>) => string;
+    /**
+     * Remove a listener previously registered via {@link onSetpointsChanged} or
+     * {@link onSetpointReceived}.
+     * @param listenerId The ID returned by the registration method
+     */
+    removeListener: (listenerId: string) => void;
+}

package/dist/cjs/packages/eebus/eebus-use-case-registry.d.cts

@@ -1,8 +1,10 @@
+import { EebusHvacClient } from './eebus-hvac-client.cjs';
 import { EebusLpcClient } from './eebus-lpc-client.cjs';
 import { EebusLppClient } from './eebus-lpp-client.cjs';
 import { EebusMgcpClient } from './eebus-mgcp-client.cjs';
 import { EebusMpcClient } from './eebus-mpc-client.cjs';
 import { EebusOhpcfClient } from './eebus-ohpcf-client.cjs';
+import { EebusSetpointClient } from './eebus-setpoint-client.cjs';
 /**
  * Registry of typed EEBUS use-case clients, scoped per remote device (SKI).
  *
@@ -69,4 +71,18 @@ export interface EebusUseCaseRegistry {
      * @param ski Subject Key Identifier of the remote node
      */
     ohpcf: (ski: string) => EebusOhpcfClient;
+    /**
+     * Get the **Setpoint** client for a remote node. Manages target values
+     * for controllable parameters such as per-zone heat-pump temperature
+     * setpoints. Pair with {@link hvac} to read measured values.
+     * @param ski Subject Key Identifier of the remote node
+     */
+    setpoint: (ski: string) => EebusSetpointClient;
+    /**
+     * Get the **Hvac** client for a remote node. Observes heating/cooling
+     * operation mode and per-zone state on a heat-pump appliance. Pair with
+     * {@link setpoint} to write target values.
+     * @param ski Subject Key Identifier of the remote node
+     */
+    hvac: (ski: string) => EebusHvacClient;
 }

package/dist/cjs/packages/eebus/energy-app-eebus.d.cts

@@ -6,11 +6,13 @@ export { EebusDeviceManagement } from './eebus-device-management.cjs';
 export { EebusIdentityService } from './eebus-identity-service.cjs';
 export { EebusSpineLowLevel } from './eebus-spine-low-level.cjs';
 export { EebusUseCaseRegistry } from './eebus-use-case-registry.cjs';
+export { EebusHvacClient } from './eebus-hvac-client.cjs';
 export { EebusLpcClient } from './eebus-lpc-client.cjs';
 export { EebusLppClient } from './eebus-lpp-client.cjs';
 export { EebusMgcpClient } from './eebus-mgcp-client.cjs';
 export { EebusMpcClient } from './eebus-mpc-client.cjs';
 export { EebusOhpcfClient } from './eebus-ohpcf-client.cjs';
+export { EebusSetpointClient } from './eebus-setpoint-client.cjs';
 /**
  * Interface for EEbus (SHIP/SPINE) device communication in enyo packages.
  *
@@ -18,7 +20,7 @@ export { EebusOhpcfClient } from './eebus-ohpcf-client.cjs';
  *
  * - {@link devices} — SHIP-level device lifecycle: discovery, pairing, connection
  * - {@link identity} — NID: observable per-node identity, diagnosis state, use-case discovery
- * - {@link useCases} — typed use-case clients: LPC, LPP, MGCP, MPC, OHPCF
+ * - {@link useCases} — typed use-case clients: LPC, LPP, MGCP, MPC, OHPCF, Setpoint, Hvac
  * - {@link spine} — low-level SPINE escape hatch for features not yet wrapped
  *
  * Dual roles (Energy Management System vs Controllable System) are modelled at

package/dist/cjs/types/enyo-data-bus-value.d.cts

@@ -1027,6 +1027,12 @@ export interface EnyoDataBusHeatpumpTemperaturesV1 extends EnyoDataBusMessage {
         domesticHotWater?: {
             /** Index of the domestic hot water tank */
             index: number;
+            /**
+             * Human-readable zone name (e.g. the `description` from SPINE
+             * `Identification.identificationListData` for this zone index).
+             * Omit when no identification is available.
+             */
+            name?: string;
             /** Target temperature in Celsius */
             targetTemperatureC: number;
             /** Current temperature in Celsius */
@@ -1038,6 +1044,12 @@ export interface EnyoDataBusHeatpumpTemperaturesV1 extends EnyoDataBusMessage {
         heatingCircuits?: {
             /** Index of the heating circuit */
             index: number;
+            /**
+             * Human-readable zone name (e.g. the `description` from SPINE
+             * `Identification.identificationListData` for this zone index).
+             * Omit when no identification is available.
+             */
+            name?: string;
             /** Target temperature in Celsius */
             targetTemperatureC: number;
             /** Current temperature in Celsius */

package/dist/cjs/types/enyo-eebus-use-cases.d.cts

@@ -185,3 +185,57 @@ export interface EebusOhpcfFlexibility {
     /** Whether the compressor is currently running */
     isRunning: boolean;
 }
+/**
+ * A single setpoint reported or written via the EEBUS **Setpoint** feature.
+ *
+ * Setpoints carry the target value for a controllable parameter on a remote
+ * node — most commonly the per-zone target temperature on a heat pump.
+ * The {@link setpointId} matches the corresponding zone in
+ * `Identification.identificationListData`, so a caller can join setpoints to
+ * human-readable zone names.
+ */
+export interface EebusSetpointValue {
+    /**
+     * Setpoint list identifier. Matches the zone index used by
+     * `Identification.identificationListData`.
+     */
+    setpointId: number;
+    /** Target value (interpret using {@link unit}; e.g. °C for HVAC zones) */
+    value: number;
+    /**
+     * SPINE unit string for {@link value}, e.g. `'Cel'` for Celsius.
+     * Following the SPINE unit catalog.
+     */
+    unit: string;
+    /** Whether the setpoint is currently active on the remote */
+    isActive: boolean;
+}
+/**
+ * A heating/cooling operation mode advertised or selected via the EEBUS
+ * **Hvac** feature. Operation modes are vendor-defined identifiers (e.g.
+ * heating, cooling, auto, standby) accompanied by an optional description.
+ */
+export interface EebusHvacOperationMode {
+    /** SPINE operation mode identifier */
+    modeId: number;
+    /** Human-readable mode description as advertised by the remote */
+    description?: string;
+}
+/**
+ * Per-zone state reported via the EEBUS **Hvac** feature.
+ *
+ * The {@link zoneId} matches the zone index used by
+ * `Identification.identificationListData`, so a caller can join zone state to
+ * human-readable zone names.
+ */
+export interface EebusHvacZoneState {
+    /**
+     * Zone identifier. Matches the zone index used by
+     * `Identification.identificationListData`.
+     */
+    zoneId: number;
+    /** Current measured temperature in Celsius, if reported */
+    currentTemperatureC?: number;
+    /** Active operation mode for this zone, if reported */
+    operationMode?: EebusHvacOperationMode;
+}

package/dist/cjs/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.127';
+exports.SDK_VERSION = '0.0.128';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/cjs/version.d.cts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.127";
+export declare const SDK_VERSION = "0.0.128";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/packages/eebus/eebus-hvac-client.d.ts

@@ -0,0 +1,61 @@
+import { EebusHvacOperationMode, EebusHvacZoneState } from '../../types/enyo-eebus-use-cases.js';
+/**
+ * Client for the EEBUS **Hvac** feature.
+ *
+ * The Hvac feature reports heating/cooling operation mode and per-zone state
+ * (current temperature, active mode). Pair with the
+ * {@link EebusSetpointClient} Setpoint feature to read or write target values.
+ * Zone ids align with `Identification.identificationListData`, so callers can
+ * map zone state to human-readable zone names.
+ *
+ * The client exposes both actor roles on a single interface:
+ * - **EMS role (outbound):** {@link getOperationMode}, {@link setOperationMode},
+ *   {@link getZoneStates}, {@link onZoneStateChanged}
+ * - **CS role (inbound):** {@link provideOperationMode}, {@link provideZoneStates}
+ *
+ * Consumers that only act in one role simply never call the other half — there
+ * is no `asManager` / `asAppliance` split.
+ */
+export interface EebusHvacClient {
+    /**
+     * Read the active heating/cooling operation mode from the remote node.
+     */
+    getOperationMode: () => Promise<EebusHvacOperationMode>;
+    /**
+     * Request the remote node to switch to the given operation mode. The
+     * remote may reject modes it does not advertise — verify support via
+     * `EebusIdentityService.getSupportedUseCases` before calling.
+     * @param mode The operation mode to select on the remote
+     */
+    setOperationMode: (mode: EebusHvacOperationMode) => Promise<void>;
+    /**
+     * Read per-zone Hvac state (current temperature, active mode) from the
+     * remote node.
+     * @returns The state of each zone reported by the remote.
+     */
+    getZoneStates: () => Promise<EebusHvacZoneState[]>;
+    /**
+     * Subscribe to per-zone Hvac state updates. The listener fires once per
+     * zone whenever the remote republishes its state.
+     * @param listener Callback invoked with the updated zone state
+     * @returns Listener ID that can be passed to {@link removeListener} to cancel
+     */
+    onZoneStateChanged: (listener: (state: EebusHvacZoneState) => void) => string;
+    /**
+     * Register a provider that supplies this device's current operation mode
+     * when a remote EMS reads it.
+     * @param provider Async callback returning the active operation mode
+     */
+    provideOperationMode: (provider: () => Promise<EebusHvacOperationMode>) => void;
+    /**
+     * Register a provider that supplies this device's current per-zone state
+     * when a remote EMS reads it.
+     * @param provider Async callback returning the current zone-state list
+     */
+    provideZoneStates: (provider: () => Promise<EebusHvacZoneState[]>) => void;
+    /**
+     * Remove a listener previously registered via {@link onZoneStateChanged}.
+     * @param listenerId The ID returned by the registration method
+     */
+    removeListener: (listenerId: string) => void;
+}

package/dist/packages/eebus/eebus-hvac-client.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/eebus/eebus-setpoint-client.d.ts

@@ -0,0 +1,59 @@
+import { EebusSetpointValue } from '../../types/enyo-eebus-use-cases.js';
+/**
+ * Client for the EEBUS **Setpoint** feature.
+ *
+ * The Setpoint feature carries the target value(s) of a controllable
+ * parameter on a remote node — most commonly the per-zone target temperature
+ * on a heat pump (paired with the {@link EebusHvacClient} Hvac feature for
+ * measured values). Setpoint ids align with the zone ids reported by
+ * `Identification.identificationListData`, so callers can map setpoints to
+ * human-readable zone names.
+ *
+ * The client exposes both actor roles on a single interface:
+ * - **EMS role (outbound):** {@link getSetpoints}, {@link setSetpoint},
+ *   {@link onSetpointsChanged}
+ * - **CS role (inbound):** {@link provideSetpoints}, {@link onSetpointReceived}
+ *
+ * Consumers that only act in one role simply never call the other half — there
+ * is no `asManager` / `asAppliance` split.
+ */
+export interface EebusSetpointClient {
+    /**
+     * Read the current setpoints reported by the remote node.
+     * @returns The full list of setpoints currently published by the remote.
+     */
+    getSetpoints: () => Promise<EebusSetpointValue[]>;
+    /**
+     * Send a setpoint to the remote node. The remote applies the value to the
+     * setpoint identified by {@link EebusSetpointValue.setpointId}; existing
+     * setpoints at other ids are left unchanged.
+     * @param value The setpoint to apply
+     */
+    setSetpoint: (value: EebusSetpointValue) => Promise<void>;
+    /**
+     * Subscribe to setpoint-list updates from the remote node. The listener is
+     * invoked with the full current list whenever the remote republishes.
+     * @param listener Callback invoked with the new setpoint list
+     * @returns Listener ID that can be passed to {@link removeListener} to cancel
+     */
+    onSetpointsChanged: (listener: (values: EebusSetpointValue[]) => void) => string;
+    /**
+     * Register a provider that supplies this device's current setpoints when a
+     * remote EMS reads them.
+     * @param provider Async callback returning the current setpoint list
+     */
+    provideSetpoints: (provider: () => Promise<EebusSetpointValue[]>) => void;
+    /**
+     * Register a handler invoked when a remote EMS writes a setpoint to this
+     * device. Implementations should apply the value to the local controller.
+     * @param handler Callback invoked with the incoming setpoint
+     * @returns Listener ID that can be passed to {@link removeListener} to deregister
+     */
+    onSetpointReceived: (handler: (value: EebusSetpointValue) => Promise<void>) => string;
+    /**
+     * Remove a listener previously registered via {@link onSetpointsChanged} or
+     * {@link onSetpointReceived}.
+     * @param listenerId The ID returned by the registration method
+     */
+    removeListener: (listenerId: string) => void;
+}

package/dist/packages/eebus/eebus-setpoint-client.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/eebus/eebus-use-case-registry.d.ts

@@ -1,8 +1,10 @@
+import { EebusHvacClient } from './eebus-hvac-client.js';
 import { EebusLpcClient } from './eebus-lpc-client.js';
 import { EebusLppClient } from './eebus-lpp-client.js';
 import { EebusMgcpClient } from './eebus-mgcp-client.js';
 import { EebusMpcClient } from './eebus-mpc-client.js';
 import { EebusOhpcfClient } from './eebus-ohpcf-client.js';
+import { EebusSetpointClient } from './eebus-setpoint-client.js';
 /**
  * Registry of typed EEBUS use-case clients, scoped per remote device (SKI).
  *
@@ -69,4 +71,18 @@ export interface EebusUseCaseRegistry {
      * @param ski Subject Key Identifier of the remote node
      */
     ohpcf: (ski: string) => EebusOhpcfClient;
+    /**
+     * Get the **Setpoint** client for a remote node. Manages target values
+     * for controllable parameters such as per-zone heat-pump temperature
+     * setpoints. Pair with {@link hvac} to read measured values.
+     * @param ski Subject Key Identifier of the remote node
+     */
+    setpoint: (ski: string) => EebusSetpointClient;
+    /**
+     * Get the **Hvac** client for a remote node. Observes heating/cooling
+     * operation mode and per-zone state on a heat-pump appliance. Pair with
+     * {@link setpoint} to write target values.
+     * @param ski Subject Key Identifier of the remote node
+     */
+    hvac: (ski: string) => EebusHvacClient;
 }

package/dist/packages/eebus/energy-app-eebus.d.ts

@@ -6,11 +6,13 @@ export { EebusDeviceManagement } from './eebus-device-management.js';
 export { EebusIdentityService } from './eebus-identity-service.js';
 export { EebusSpineLowLevel } from './eebus-spine-low-level.js';
 export { EebusUseCaseRegistry } from './eebus-use-case-registry.js';
+export { EebusHvacClient } from './eebus-hvac-client.js';
 export { EebusLpcClient } from './eebus-lpc-client.js';
 export { EebusLppClient } from './eebus-lpp-client.js';
 export { EebusMgcpClient } from './eebus-mgcp-client.js';
 export { EebusMpcClient } from './eebus-mpc-client.js';
 export { EebusOhpcfClient } from './eebus-ohpcf-client.js';
+export { EebusSetpointClient } from './eebus-setpoint-client.js';
 /**
  * Interface for EEbus (SHIP/SPINE) device communication in enyo packages.
  *
@@ -18,7 +20,7 @@ export { EebusOhpcfClient } from './eebus-ohpcf-client.js';
  *
  * - {@link devices} — SHIP-level device lifecycle: discovery, pairing, connection
  * - {@link identity} — NID: observable per-node identity, diagnosis state, use-case discovery
- * - {@link useCases} — typed use-case clients: LPC, LPP, MGCP, MPC, OHPCF
+ * - {@link useCases} — typed use-case clients: LPC, LPP, MGCP, MPC, OHPCF, Setpoint, Hvac
  * - {@link spine} — low-level SPINE escape hatch for features not yet wrapped
  *
  * Dual roles (Energy Management System vs Controllable System) are modelled at

package/dist/types/enyo-data-bus-value.d.ts

@@ -1027,6 +1027,12 @@ export interface EnyoDataBusHeatpumpTemperaturesV1 extends EnyoDataBusMessage {
         domesticHotWater?: {
             /** Index of the domestic hot water tank */
             index: number;
+            /**
+             * Human-readable zone name (e.g. the `description` from SPINE
+             * `Identification.identificationListData` for this zone index).
+             * Omit when no identification is available.
+             */
+            name?: string;
             /** Target temperature in Celsius */
             targetTemperatureC: number;
             /** Current temperature in Celsius */
@@ -1038,6 +1044,12 @@ export interface EnyoDataBusHeatpumpTemperaturesV1 extends EnyoDataBusMessage {
         heatingCircuits?: {
             /** Index of the heating circuit */
             index: number;
+            /**
+             * Human-readable zone name (e.g. the `description` from SPINE
+             * `Identification.identificationListData` for this zone index).
+             * Omit when no identification is available.
+             */
+            name?: string;
             /** Target temperature in Celsius */
             targetTemperatureC: number;
             /** Current temperature in Celsius */

package/dist/types/enyo-eebus-use-cases.d.ts

@@ -185,3 +185,57 @@ export interface EebusOhpcfFlexibility {
     /** Whether the compressor is currently running */
     isRunning: boolean;
 }
+/**
+ * A single setpoint reported or written via the EEBUS **Setpoint** feature.
+ *
+ * Setpoints carry the target value for a controllable parameter on a remote
+ * node — most commonly the per-zone target temperature on a heat pump.
+ * The {@link setpointId} matches the corresponding zone in
+ * `Identification.identificationListData`, so a caller can join setpoints to
+ * human-readable zone names.
+ */
+export interface EebusSetpointValue {
+    /**
+     * Setpoint list identifier. Matches the zone index used by
+     * `Identification.identificationListData`.
+     */
+    setpointId: number;
+    /** Target value (interpret using {@link unit}; e.g. °C for HVAC zones) */
+    value: number;
+    /**
+     * SPINE unit string for {@link value}, e.g. `'Cel'` for Celsius.
+     * Following the SPINE unit catalog.
+     */
+    unit: string;
+    /** Whether the setpoint is currently active on the remote */
+    isActive: boolean;
+}
+/**
+ * A heating/cooling operation mode advertised or selected via the EEBUS
+ * **Hvac** feature. Operation modes are vendor-defined identifiers (e.g.
+ * heating, cooling, auto, standby) accompanied by an optional description.
+ */
+export interface EebusHvacOperationMode {
+    /** SPINE operation mode identifier */
+    modeId: number;
+    /** Human-readable mode description as advertised by the remote */
+    description?: string;
+}
+/**
+ * Per-zone state reported via the EEBUS **Hvac** feature.
+ *
+ * The {@link zoneId} matches the zone index used by
+ * `Identification.identificationListData`, so a caller can join zone state to
+ * human-readable zone names.
+ */
+export interface EebusHvacZoneState {
+    /**
+     * Zone identifier. Matches the zone index used by
+     * `Identification.identificationListData`.
+     */
+    zoneId: number;
+    /** Current measured temperature in Celsius, if reported */
+    currentTemperatureC?: number;
+    /** Active operation mode for this zone, if reported */
+    operationMode?: EebusHvacOperationMode;
+}

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.127";
+export declare const SDK_VERSION = "0.0.128";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/version.js

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export const SDK_VERSION = '0.0.127';
+export const SDK_VERSION = '0.0.128';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enyo-energy/energy-app-sdk",
-  "version": "0.0.127",
+  "version": "0.0.128",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",