@enyo-energy/energy-app-sdk 0.0.180 → 0.0.181

package/dist/cjs/index.cjs

@@ -77,6 +77,10 @@ __exportStar(require("./types/enyo-configuration-manager.cjs"), exports);
 __exportStar(require("./packages/energy-app-configuration-manager.cjs"), exports);
 __exportStar(require("./types/enyo-air-conditioning-appliance.cjs"), exports);
 __exportStar(require("./types/enyo-heating-rod-appliance.cjs"), exports);
+__exportStar(require("./types/enyo-charger-appliance.cjs"), exports);
+__exportStar(require("./types/enyo-battery-appliance.cjs"), exports);
+__exportStar(require("./types/enyo-heatpump-appliance.cjs"), exports);
+__exportStar(require("./types/enyo-inverter-appliance.cjs"), exports);
 __exportStar(require("./types/enyo-onboarding.cjs"), exports);
 __exportStar(require("./packages/energy-app-onboarding.cjs"), exports);
 __exportStar(require("./types/enyo-retry-manager.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -61,6 +61,10 @@ export * from './types/enyo-configuration-manager.cjs';
 export * from './packages/energy-app-configuration-manager.cjs';
 export * from './types/enyo-air-conditioning-appliance.cjs';
 export * from './types/enyo-heating-rod-appliance.cjs';
+export * from './types/enyo-charger-appliance.cjs';
+export * from './types/enyo-battery-appliance.cjs';
+export * from './types/enyo-heatpump-appliance.cjs';
+export * from './types/enyo-inverter-appliance.cjs';
 export * from './types/enyo-onboarding.cjs';
 export * from './packages/energy-app-onboarding.cjs';
 export * from './types/enyo-retry-manager.cjs';

package/dist/cjs/integrations/heatpump-integration-energy-app.cjs

@@ -49,6 +49,7 @@ class HeatpumpIntegrationEnergyApp extends integration_energy_app_js_1.Integrati
     registerHandlers() {
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.HeatpumpOverheatingV1, (msg) => this.handleHeatpumpOverheating(msg));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.HeatpumpAvailablePowerAnnouncementV1, (msg) => this.handleHeatpumpAvailablePowerAnnouncement(msg));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetHeatpumpAvailablePowerV2, (msg) => this.handleSetHeatpumpAvailablePower(msg));
     }
     /**
      * Publishes a `HeatpumpValuesUpdateV1` message reporting the heatpump's

package/dist/cjs/integrations/heatpump-integration-energy-app.d.cts

@@ -1,7 +1,7 @@
 import { IntegrationEnergyApp } from "./integration-energy-app.cjs";
 import { IntegrationCommandResponse, IntegrationEnergyAppOptions } from "./integration-types.cjs";
 import { EnyoApplianceTypeEnum } from "../types/enyo-appliance.cjs";
-import { EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusHeatpumpAvailablePowerAnnouncementV1, EnyoDataBusHeatpumpOverheatingV1, EnyoDataBusHeatpumpTemperaturesV1, EnyoDataBusHeatpumpValuesV1 } from "../types/enyo-data-bus-value.cjs";
+import { EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusHeatpumpAvailablePowerAnnouncementV1, EnyoDataBusHeatpumpOverheatingV1, EnyoDataBusHeatpumpTemperaturesV1, EnyoDataBusHeatpumpValuesV1, EnyoDataBusSetHeatpumpAvailablePowerV2 } from "../types/enyo-data-bus-value.cjs";
 /**
  * Abstract base class for heatpump integrations.
  *
@@ -62,8 +62,25 @@ export declare abstract class HeatpumpIntegrationEnergyApp extends IntegrationEn
      * @returns `Accepted` when the heatpump will adjust to the announced
      *   power, `Rejected` if it cannot, `NotSupported` if the integration does
      *   not support power announcements.
+     * @deprecated Implement {@link handleSetHeatpumpAvailablePower} instead. This
+     *   handler remains for the deprecated
+     *   {@link EnyoDataBusHeatpumpAvailablePowerAnnouncementV1} during the
+     *   transition window.
      */
     protected abstract handleHeatpumpAvailablePowerAnnouncement(message: EnyoDataBusHeatpumpAvailablePowerAnnouncementV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `SetHeatpumpAvailablePowerV2` command. Implementers use the
+     * announced power (`message.data.powerW`) to scale the heatpump's
+     * consumption to fit the available envelope, optionally taking the
+     * `purpose` (e.g. DHW boost, pre-heating) and `powerSources` (PV / battery /
+     * grid) context into account.
+     *
+     * @param message - The V2 available-power command.
+     * @returns `Accepted` when the heatpump will adjust to the announced
+     *   power, `Rejected` if it cannot, `NotSupported` if the integration does
+     *   not support power announcements.
+     */
+    protected abstract handleSetHeatpumpAvailablePower(message: EnyoDataBusSetHeatpumpAvailablePowerV2): Promise<IntegrationCommandResponse>;
     /**
      * @inheritDoc
      */

package/dist/cjs/integrations/storage-integration-energy-app.cjs

@@ -11,6 +11,8 @@ const enyo_data_bus_value_js_1 = require("../types/enyo-data-bus-value.cjs");
  *  - `SetStorageScheduleV1` — full storage control plan (mode + relative
  *    schedule of direction/power setpoints). Replaces the legacy
  *    start/stop/limit message family.
+ *  - `SetStorageControlV2` — single-setpoint control (mode + direction/power),
+ *    the immediate-control counterpart to the schedule message.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 class StorageIntegrationEnergyApp extends integration_energy_app_js_1.IntegrationEnergyApp {
@@ -25,6 +27,7 @@ class StorageIntegrationEnergyApp extends integration_energy_app_js_1.Integratio
     }
     registerHandlers() {
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageScheduleV1, (m) => this.handleSetStorageSchedule(m));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageControlV2, (m) => this.handleSetStorageControl(m));
     }
     /**
      * Publishes a `BatteryValuesUpdateV1` message with the battery's current

package/dist/cjs/integrations/storage-integration-energy-app.d.cts

@@ -1,7 +1,7 @@
 import { IntegrationEnergyApp } from "./integration-energy-app.cjs";
 import { IntegrationCommandResponse, IntegrationEnergyAppOptions } from "./integration-types.cjs";
 import { EnyoApplianceTypeEnum } from "../types/enyo-appliance.cjs";
-import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageScheduleV1 } from "../types/enyo-data-bus-value.cjs";
+import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageControlV2, EnyoDataBusSetStorageScheduleV1 } from "../types/enyo-data-bus-value.cjs";
 /**
  * Abstract base class for battery / storage integrations.
  *
@@ -9,6 +9,8 @@ import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitatio
  *  - `SetStorageScheduleV1` — full storage control plan (mode + relative
  *    schedule of direction/power setpoints). Replaces the legacy
  *    start/stop/limit message family.
+ *  - `SetStorageControlV2` — single-setpoint control (mode + direction/power),
+ *    the immediate-control counterpart to the schedule message.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 export declare abstract class StorageIntegrationEnergyApp extends IntegrationEnergyApp {
@@ -31,6 +33,22 @@ export declare abstract class StorageIntegrationEnergyApp extends IntegrationEne
      * `seconds` is reached.
      */
     protected abstract handleSetStorageSchedule(message: EnyoDataBusSetStorageScheduleV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `SetStorageControlV2` command — apply a single-setpoint control
+     * plan to the battery appliance.
+     *
+     * When `data.mode` is `'auto'` the integration should release the appliance
+     * back to its own logic. When `data.mode` is `'controlled'` the integration
+     * should apply `data.control`: an explicit `direction` (`'charge'`,
+     * `'discharge'`, or `'hold'`) with a non-negative `powerW` setpoint
+     * (`0` for `'hold'`), held until a new command arrives.
+     *
+     * @param message - The V2 storage control command.
+     * @returns `Accepted` when the battery will apply the setpoint, `Rejected`
+     *   if it cannot, `NotSupported` if the integration does not support direct
+     *   control.
+     */
+    protected abstract handleSetStorageControl(message: EnyoDataBusSetStorageControlV2): Promise<IntegrationCommandResponse>;
     /**
      * @inheritDoc
      */

package/dist/cjs/integrations/wallbox-integration-energy-app.cjs

@@ -38,6 +38,7 @@ class WallboxIntegrationEnergyApp extends integration_energy_app_js_1.Integratio
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.PauseChargingV1, (m) => this.handlePauseCharging(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.ResumeChargingV1, (m) => this.handleResumeCharging(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.ChangeChargingPowerV1, (m) => this.handleChangeChargingPower(m));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetChargerAvailablePowerV2, (m) => this.handleSetChargerAvailablePower(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetChargingScheduleV1, (m) => this.handleSetChargingSchedule(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.ResetChargerV1, (m) => this.handleResetCharger(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.RebootChargerV1, (m) => this.handleRebootCharger(m));

package/dist/cjs/integrations/wallbox-integration-energy-app.d.cts

@@ -1,7 +1,7 @@
 import { IntegrationEnergyApp } from "./integration-energy-app.cjs";
 import { IntegrationCommandResponse, IntegrationEnergyAppOptions } from "./integration-types.cjs";
 import { EnyoApplianceTypeEnum } from "../types/enyo-appliance.cjs";
-import { EnyoDataBusChangeChargingPowerV1, EnyoDataBusChargerStatusChangedV1, EnyoDataBusChargingMeterValuesV1, EnyoDataBusChargingStartedV1, EnyoDataBusChargingStoppedV1, EnyoDataBusClearChargingProfilesV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusMessage, EnyoDataBusPauseChargingV1, EnyoDataBusRebootChargerV1, EnyoDataBusRequestChargerLogsV1, EnyoDataBusResetChargerV1, EnyoDataBusResumeChargingV1, EnyoDataBusSetChargingScheduleV1, EnyoDataBusStartChargeV1, EnyoDataBusStopChargeV1 } from "../types/enyo-data-bus-value.cjs";
+import { EnyoDataBusChangeChargingPowerV1, EnyoDataBusChargerStatusChangedV1, EnyoDataBusChargingMeterValuesV1, EnyoDataBusChargingStartedV1, EnyoDataBusChargingStoppedV1, EnyoDataBusClearChargingProfilesV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusMessage, EnyoDataBusPauseChargingV1, EnyoDataBusRebootChargerV1, EnyoDataBusRequestChargerLogsV1, EnyoDataBusResetChargerV1, EnyoDataBusResumeChargingV1, EnyoDataBusSetChargerAvailablePowerV2, EnyoDataBusSetChargingScheduleV1, EnyoDataBusStartChargeV1, EnyoDataBusStopChargeV1 } from "../types/enyo-data-bus-value.cjs";
 /**
  * Abstract base class for wallbox / charger integrations.
  *
@@ -52,8 +52,23 @@ export declare abstract class WallboxIntegrationEnergyApp extends IntegrationEne
     /**
      * Handles a `ChangeChargingPowerV1` command — adjust the cap on the
      * current session.
+     *
+     * @deprecated Implement {@link handleSetChargerAvailablePower} instead; the
+     *   V2 command carries the envelope in Watts. This handler remains for the
+     *   deprecated {@link EnyoDataBusChangeChargingPowerV1} during the
+     *   transition window.
      */
     protected abstract handleChangeChargingPower(message: EnyoDataBusChangeChargingPowerV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `SetChargerAvailablePowerV2` command — apply the announced
+     * available/max active-power envelope (in Watts) to the charger. The
+     * charger must not draw more than `message.data.powerW`.
+     *
+     * @param message - The available-power command.
+     * @returns `Accepted` when the charger will honor the envelope, `Rejected`
+     *   if it cannot, `NotSupported` if power limitation is not supported.
+     */
+    protected abstract handleSetChargerAvailablePower(message: EnyoDataBusSetChargerAvailablePowerV2): Promise<IntegrationCommandResponse>;
     /**
      * Handles a `SetChargingScheduleV1` command — install (or update) an OCPP
      * charging profile / schedule on the charger.

package/dist/cjs/types/enyo-air-conditioning-appliance.d.cts

@@ -52,4 +52,12 @@ export interface EnyoAirConditioningApplianceMetadata {
     optimizationMode?: EnyoAirConditioningOptimizationModeEnum;
     /** Rooms served by this air conditioning unit (0 to n) */
     rooms?: EnyoAirConditioningApplianceRoom[];
+    /**
+     * Whether the energy manager is allowed to actively control (steer) this
+     * air conditioning unit. When `false`, the unit is treated as
+     * read-only/monitor-only and the EMS must not issue control commands to it.
+     * When omitted, consumers should fall back to their configured default
+     * behaviour.
+     */
+    controlAllowed?: boolean;
 }

package/dist/cjs/types/enyo-appliance.d.cts

@@ -173,6 +173,7 @@ export interface EnyoApplianceMetadata {
     firmwareVersion?: string;
     hostname?: string;
     ipAddress?: string;
+    /** Connection state */
     state?: EnyoApplianceStateEnum;
     /** Health status of the appliance (e.g. healthy or faulted) */
     status?: EnyoApplianceStatusEnum;

package/dist/cjs/types/enyo-battery-appliance.d.cts

@@ -48,4 +48,21 @@ export interface EnyoBatteryApplianceMetadata {
     /** Currently active discharge power limit in Watts (if any) */
     activeDischargeLimitW?: number;
     features?: EnyoBatteryFeature[];
+    /**
+     * Whether the energy manager is allowed to actively control (steer) this
+     * battery. When `false`, the battery is treated as read-only/monitor-only
+     * and the EMS must not issue control commands to it. When omitted,
+     * consumers should fall back to their configured default behaviour.
+     */
+    controlAllowed?: boolean;
+    /**
+     * Minimum state of charge the battery should be kept at, as a percentage
+     * (0–100). The EMS should not discharge the battery below this value.
+     */
+    minSoC?: number;
+    /**
+     * Maximum state of charge the battery should be charged to, as a percentage
+     * (0–100). The EMS should not charge the battery above this value.
+     */
+    maxSoC?: number;
 }

package/dist/cjs/types/enyo-charger-appliance.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnyoChargerApplianceAvailableFeaturesEnum = exports.EnyoChargerApplianceAuthorizationModeEnum = exports.EnyoChargerApplianceStatusEnum = void 0;
+exports.EnyoChargerApplianceAvailableFeaturesEnum = exports.EnyoChargerApplianceSuspendedReasonEnum = exports.EnyoChargerApplianceAuthorizationModeEnum = exports.EnyoChargerApplianceStatusEnum = void 0;
 var EnyoChargerApplianceStatusEnum;
 (function (EnyoChargerApplianceStatusEnum) {
     EnyoChargerApplianceStatusEnum["Available"] = "Available";
@@ -17,6 +17,26 @@ var EnyoChargerApplianceAuthorizationModeEnum;
     EnyoChargerApplianceAuthorizationModeEnum["AuthorizationRequired"] = "AuthorizationRequired";
     EnyoChargerApplianceAuthorizationModeEnum["NoAuthorization"] = "NoAuthorization";
 })(EnyoChargerApplianceAuthorizationModeEnum || (exports.EnyoChargerApplianceAuthorizationModeEnum = EnyoChargerApplianceAuthorizationModeEnum = {}));
+/**
+ * When a charger reports the {@link EnyoChargerApplianceStatusEnum.Suspended}
+ * status, this indicates which side of the charging session caused the
+ * suspension. Mirrors the OCPP distinction between the `SuspendedEVSE` and
+ * `SuspendedEV` status notifications:
+ *
+ * - `Evse` — the charging station (EVSE) is not delivering energy to the EV
+ *   (e.g. the EMS/backend paused it, load management, or the station is
+ *   waiting). The vehicle is ready but the station is holding.
+ * - `Ev` — the electric vehicle is not taking energy (e.g. the vehicle's
+ *   battery is full or the EV itself paused charging). The station is ready
+ *   but the vehicle is holding.
+ */
+var EnyoChargerApplianceSuspendedReasonEnum;
+(function (EnyoChargerApplianceSuspendedReasonEnum) {
+    /** Charging suspended by the charging station / EVSE (OCPP `SuspendedEVSE`) */
+    EnyoChargerApplianceSuspendedReasonEnum["Evse"] = "evse";
+    /** Charging suspended by the electric vehicle (OCPP `SuspendedEV`) */
+    EnyoChargerApplianceSuspendedReasonEnum["Ev"] = "ev";
+})(EnyoChargerApplianceSuspendedReasonEnum || (exports.EnyoChargerApplianceSuspendedReasonEnum = EnyoChargerApplianceSuspendedReasonEnum = {}));
 var EnyoChargerApplianceAvailableFeaturesEnum;
 (function (EnyoChargerApplianceAvailableFeaturesEnum) {
     /** If the charger can limit the power in Ampere or Watt*/

package/dist/cjs/types/enyo-charger-appliance.d.cts

@@ -1,3 +1,4 @@
+import { EnyoChargeModeEnum } from "./enyo-data-bus-value.cjs";
 export declare enum EnyoChargerApplianceStatusEnum {
     Available = "Available",
     Occupied = "Occupied",
@@ -12,6 +13,25 @@ export declare enum EnyoChargerApplianceAuthorizationModeEnum {
     AuthorizationRequired = "AuthorizationRequired",
     NoAuthorization = "NoAuthorization"
 }
+/**
+ * When a charger reports the {@link EnyoChargerApplianceStatusEnum.Suspended}
+ * status, this indicates which side of the charging session caused the
+ * suspension. Mirrors the OCPP distinction between the `SuspendedEVSE` and
+ * `SuspendedEV` status notifications:
+ *
+ * - `Evse` — the charging station (EVSE) is not delivering energy to the EV
+ *   (e.g. the EMS/backend paused it, load management, or the station is
+ *   waiting). The vehicle is ready but the station is holding.
+ * - `Ev` — the electric vehicle is not taking energy (e.g. the vehicle's
+ *   battery is full or the EV itself paused charging). The station is ready
+ *   but the vehicle is holding.
+ */
+export declare enum EnyoChargerApplianceSuspendedReasonEnum {
+    /** Charging suspended by the charging station / EVSE (OCPP `SuspendedEVSE`) */
+    Evse = "evse",
+    /** Charging suspended by the electric vehicle (OCPP `SuspendedEV`) */
+    Ev = "ev"
+}
 /**
  * Represents a single OCPP configuration entry from the charger.
  */
@@ -73,6 +93,15 @@ export type EnyoChargerAppliancePhase = 1 | 3;
 export interface EnyoChargerApplianceMetadata {
     availableFeatures: EnyoChargerApplianceAvailableFeaturesEnum[];
     status: EnyoChargerApplianceStatusEnum;
+    /**
+     * Detailed cause of a suspended charging session. Only meaningful while the
+     * charger's {@link EnyoChargerApplianceMetadata.status} is
+     * {@link EnyoChargerApplianceStatusEnum.Suspended}; distinguishes an
+     * EVSE-side suspension (OCPP `SuspendedEVSE`) from an EV-side suspension
+     * (OCPP `SuspendedEV`). Omit when the charger is not suspended or the cause
+     * is unknown.
+     */
+    suspendedReason?: EnyoChargerApplianceSuspendedReasonEnum;
     /** ISO Timestamp of the last heartbeat */
     lastHeartbeatAtIso?: string;
     ocpp?: EnyoChargerApplianceOcppMetadata;
@@ -97,4 +126,24 @@ export interface EnyoChargerApplianceMetadata {
      *   `ThreeToOnePhaseSwitch` feature)
      */
     availablePhases?: EnyoChargerAppliancePhase[];
+    /**
+     * Whether the energy manager is allowed to actively control (steer) this
+     * charger. When `false`, the charger is treated as read-only/monitor-only
+     * and the EMS must not issue control commands to it. When omitted,
+     * consumers should fall back to their configured default behaviour.
+     */
+    controlAllowed?: boolean;
+    /**
+     * Default charge mode to apply for charging sessions on this charger when
+     * no explicit mode is selected by the user. References the shared
+     * {@link EnyoChargeModeEnum} (e.g. immediate, cost-optimized, price-limit).
+     */
+    defaultChargeMode?: EnyoChargeModeEnum;
+    /**
+     * Whether home/site batteries should be blocked from discharging while this
+     * charger is actively charging. When `true`, the EMS should prevent battery
+     * discharge during a charging session so the vehicle is charged from PV or
+     * grid rather than from stored battery energy.
+     */
+    blockBatteriesOnCharging?: boolean;
 }

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnyoChargingProfileTypeEnum = exports.EnyoCommandAcknowledgeAnswerEnum = exports.EnyoStorageScheduleDirectionEnum = exports.EnyoStorageScheduleModeEnum = exports.EnyoDataBusMessageEnum = exports.EnyoChargeInitiatorEnum = exports.EnyoChargeModeEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoStringStateEnum = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = exports.EnyoGridOperatorLimitTypeEnum = exports.EnyoDataBusCommandReasonCategoryEnum = exports.EnyoDataBusCommandReasonTypeEnum = void 0;
+exports.EnyoPowerSourceEnum = exports.EnyoHeatpumpControlPurposeEnum = exports.EnyoChargingProfileTypeEnum = exports.EnyoCommandAcknowledgeAnswerEnum = exports.EnyoStorageControlDirectionEnum = exports.EnyoStorageControlModeEnum = exports.EnyoStorageScheduleDirectionEnum = exports.EnyoStorageScheduleModeEnum = exports.EnyoDataBusMessageEnum = exports.EnyoChargeInitiatorEnum = exports.EnyoChargeModeEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoStringStateEnum = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = exports.EnyoGridOperatorLimitTypeEnum = exports.EnyoDataBusCommandReasonCategoryEnum = exports.EnyoDataBusCommandReasonTypeEnum = void 0;
 /**
  * Enum representing the reason type for why a data bus command was issued.
  * Used to attach context to commands for logging, debugging, and UI display.
@@ -186,6 +186,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["StartChargingFailedV1"] = "StartChargingFailedV1";
     EnyoDataBusMessageEnum["PauseChargingV1"] = "PauseChargingV1";
     EnyoDataBusMessageEnum["ResumeChargingV1"] = "ResumeChargingV1";
+    /** @deprecated Use {@link EnyoDataBusMessageEnum.SetChargerAvailablePowerV2} instead, which carries an available/max power envelope in Watts. */
     EnyoDataBusMessageEnum["ChangeChargingPowerV1"] = "ChangeChargingPowerV1";
     EnyoDataBusMessageEnum["ChangeChargeModeV1"] = "ChangeChargeModeV1";
     EnyoDataBusMessageEnum["SetChargingScheduleV1"] = "SetChargingScheduleV1";
@@ -231,7 +232,9 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["RequestChargerLogsV1"] = "RequestChargerLogsV1";
     EnyoDataBusMessageEnum["ClearChargingProfilesV1"] = "ClearChargingProfilesV1";
     EnyoDataBusMessageEnum["HeatpumpOverheatingV1"] = "HeatpumpOverheatingV1";
+    /** @deprecated Use {@link EnyoDataBusMessageEnum.SetHeatpumpAvailablePowerV2} instead, which adds purpose and power-source context. */
     EnyoDataBusMessageEnum["HeatpumpAvailablePowerAnnouncementV1"] = "HeatpumpAvailablePowerAnnouncementV1";
+    /** @deprecated Use {@link EnyoDataBusMessageEnum.SetHeatingRodAvailablePowerV2} instead. */
     EnyoDataBusMessageEnum["HeatingRodAvailablePowerAnnouncementV1"] = "HeatingRodAvailablePowerAnnouncementV1";
     EnyoDataBusMessageEnum["AirConditioningValuesUpdateV1"] = "AirConditioningValuesUpdateV1";
     EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
@@ -239,6 +242,14 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
     EnyoDataBusMessageEnum["ChangeAirConditioningOptimizationModeV1"] = "ChangeAirConditioningOptimizationModeV1";
     EnyoDataBusMessageEnum["VehicleSocUpdateV1"] = "VehicleSocUpdateV1";
+    /** V2 control command: announce the available/max power (W) envelope to a charger. Supersedes {@link EnyoDataBusMessageEnum.ChangeChargingPowerV1}. */
+    EnyoDataBusMessageEnum["SetChargerAvailablePowerV2"] = "SetChargerAvailablePowerV2";
+    /** V2 control command: announce the available/max power (W) envelope to a heatpump, with purpose and power-source context. Supersedes {@link EnyoDataBusMessageEnum.HeatpumpAvailablePowerAnnouncementV1}. */
+    EnyoDataBusMessageEnum["SetHeatpumpAvailablePowerV2"] = "SetHeatpumpAvailablePowerV2";
+    /** V2 control command: announce the available/max power (W) envelope to a heating rod. Supersedes {@link EnyoDataBusMessageEnum.HeatingRodAvailablePowerAnnouncementV1}. */
+    EnyoDataBusMessageEnum["SetHeatingRodAvailablePowerV2"] = "SetHeatingRodAvailablePowerV2";
+    /** V2 control command: prescribe a single-setpoint control (mode + direction + power) to a battery/storage appliance. */
+    EnyoDataBusMessageEnum["SetStorageControlV2"] = "SetStorageControlV2";
     EnyoDataBusMessageEnum["EnergyAppStartedV1"] = "EnergyAppStartedV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));
 /**
@@ -282,6 +293,39 @@ var EnyoStorageScheduleDirectionEnum;
      */
     EnyoStorageScheduleDirectionEnum["Idle"] = "idle";
 })(EnyoStorageScheduleDirectionEnum || (exports.EnyoStorageScheduleDirectionEnum = EnyoStorageScheduleDirectionEnum = {}));
+/**
+ * Control mode carried by {@link EnyoDataBusSetStorageControlV2}.
+ *
+ * - `Controlled` — the energy manager prescribes an explicit direction and
+ *   power setpoint (see {@link EnyoDataBusSetStorageControlV2.data.control}).
+ * - `Auto` — control is handed back to the battery's own logic; no setpoint is
+ *   prescribed.
+ */
+var EnyoStorageControlModeEnum;
+(function (EnyoStorageControlModeEnum) {
+    /** The EMS prescribes direction + power via the `control` field. */
+    EnyoStorageControlModeEnum["Controlled"] = "controlled";
+    /** Hand control back to the battery's own logic. */
+    EnyoStorageControlModeEnum["Auto"] = "auto";
+})(EnyoStorageControlModeEnum || (exports.EnyoStorageControlModeEnum = EnyoStorageControlModeEnum = {}));
+/**
+ * Direction of energy flow for a {@link EnyoDataBusSetStorageControlV2} setpoint.
+ *
+ * Direction is encoded explicitly (rather than via a signed `powerW`) so the
+ * setpoint is unambiguous on the wire: `powerW` is always non-negative.
+ */
+var EnyoStorageControlDirectionEnum;
+(function (EnyoStorageControlDirectionEnum) {
+    /** Power should flow into the battery (charging). */
+    EnyoStorageControlDirectionEnum["Charge"] = "charge";
+    /** Power should flow out of the battery (discharging). */
+    EnyoStorageControlDirectionEnum["Discharge"] = "discharge";
+    /**
+     * The battery should hold its current state-of-charge (no energy flow).
+     * The accompanying `powerW` must be `0`.
+     */
+    EnyoStorageControlDirectionEnum["Hold"] = "hold";
+})(EnyoStorageControlDirectionEnum || (exports.EnyoStorageControlDirectionEnum = EnyoStorageControlDirectionEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.
  */
@@ -307,3 +351,35 @@ var EnyoChargingProfileTypeEnum;
     /** Charging profile for a specific transaction */
     EnyoChargingProfileTypeEnum["TxProfile"] = "TxProfile";
 })(EnyoChargingProfileTypeEnum || (exports.EnyoChargingProfileTypeEnum = EnyoChargingProfileTypeEnum = {}));
+/**
+ * The intended purpose a heatpump should apply an announced available-power
+ * envelope to. Lets the appliance decide how to spend the granted power (e.g.
+ * boost domestic hot water vs. pre-heat the building).
+ */
+var EnyoHeatpumpControlPurposeEnum;
+(function (EnyoHeatpumpControlPurposeEnum) {
+    /** Use the power for normal space (room) heating */
+    EnyoHeatpumpControlPurposeEnum["RoomHeating"] = "room-heating";
+    /** Use the power to boost the domestic hot water tank */
+    EnyoHeatpumpControlPurposeEnum["DomesticHotWaterBoost"] = "domestic-hot-water-boost";
+    /** Use the power to pre-heat ahead of an anticipated demand or price rise */
+    EnyoHeatpumpControlPurposeEnum["PreHeating"] = "pre-heating";
+    /** Use the power to charge a heating buffer tank */
+    EnyoHeatpumpControlPurposeEnum["BufferTankCharge"] = "buffer-tank-charge";
+    /** Use the power for space cooling (reversible heatpumps) */
+    EnyoHeatpumpControlPurposeEnum["Cooling"] = "cooling";
+})(EnyoHeatpumpControlPurposeEnum || (exports.EnyoHeatpumpControlPurposeEnum = EnyoHeatpumpControlPurposeEnum = {}));
+/**
+ * Where an announced available-power envelope is expected to originate from.
+ * Used to give appliances (and analytics) insight into whether the granted
+ * power is PV surplus, battery discharge, or grid import.
+ */
+var EnyoPowerSourceEnum;
+(function (EnyoPowerSourceEnum) {
+    /** Power originates from PV production surplus */
+    EnyoPowerSourceEnum["Pv"] = "pv";
+    /** Power originates from battery discharge */
+    EnyoPowerSourceEnum["Battery"] = "battery";
+    /** Power originates from grid import */
+    EnyoPowerSourceEnum["Grid"] = "grid";
+})(EnyoPowerSourceEnum || (exports.EnyoPowerSourceEnum = EnyoPowerSourceEnum = {}));