@enyo-energy/energy-app-sdk 0.0.129 → 0.0.131

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

@@ -10,7 +10,10 @@ const enyo_data_bus_value_js_1 = require("../types/enyo-data-bus-value.cjs");
  * Subscribes to:
  *  - `StartStorageGridChargeV1` — start charging the battery from the grid.
  *  - `StopStorageGridChargeV1` — stop grid charging.
+ *  - `StartStorageGridDischargeV1` — start discharging the battery into the grid.
+ *  - `StopStorageGridDischargeV1` — stop grid discharging.
  *  - `SetStorageDischargeLimitV1` — set the maximum discharge power.
+ *  - `SetStorageChargeLimitV1` — set the maximum charge power.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 class StorageIntegrationEnergyApp extends integration_energy_app_js_1.IntegrationEnergyApp {
@@ -26,7 +29,10 @@ class StorageIntegrationEnergyApp extends integration_energy_app_js_1.Integratio
     registerHandlers() {
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StartStorageGridChargeV1, (m) => this.handleStartStorageGridCharge(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StopStorageGridChargeV1, (m) => this.handleStopStorageGridCharge(m));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StartStorageGridDischargeV1, (m) => this.handleStartStorageGridDischarge(m));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.StopStorageGridDischargeV1, (m) => this.handleStopStorageGridDischarge(m));
         this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageDischargeLimitV1, (m) => this.handleSetStorageDischargeLimit(m));
+        this.registerCommandHandler(enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.SetStorageChargeLimitV1, (m) => this.handleSetStorageChargeLimit(m));
     }
     /**
      * Publishes a `BatteryValuesUpdateV1` message with the battery's current

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

@@ -1,14 +1,17 @@
 import { IntegrationEnergyApp } from "./integration-energy-app.cjs";
 import { IntegrationCommandResponse, IntegrationEnergyAppOptions } from "./integration-types.cjs";
 import { EnyoApplianceTypeEnum } from "../types/enyo-appliance.cjs";
-import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageDischargeLimitV1, EnyoDataBusStartStorageGridChargeV1, EnyoDataBusStopStorageGridChargeV1 } from "../types/enyo-data-bus-value.cjs";
+import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageChargeLimitV1, EnyoDataBusSetStorageDischargeLimitV1, EnyoDataBusStartStorageGridChargeV1, EnyoDataBusStartStorageGridDischargeV1, EnyoDataBusStopStorageGridChargeV1, EnyoDataBusStopStorageGridDischargeV1 } from "../types/enyo-data-bus-value.cjs";
 /**
  * Abstract base class for battery / storage integrations.
  *
  * Subscribes to:
  *  - `StartStorageGridChargeV1` — start charging the battery from the grid.
  *  - `StopStorageGridChargeV1` — stop grid charging.
+ *  - `StartStorageGridDischargeV1` — start discharging the battery into the grid.
+ *  - `StopStorageGridDischargeV1` — stop grid discharging.
  *  - `SetStorageDischargeLimitV1` — set the maximum discharge power.
+ *  - `SetStorageChargeLimitV1` — set the maximum charge power.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 export declare abstract class StorageIntegrationEnergyApp extends IntegrationEnergyApp {
@@ -27,11 +30,25 @@ export declare abstract class StorageIntegrationEnergyApp extends IntegrationEne
      * Handles a `StopStorageGridChargeV1` command — end an active grid charge.
      */
     protected abstract handleStopStorageGridCharge(message: EnyoDataBusStopStorageGridChargeV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `StartStorageGridDischargeV1` command — start discharging the
+     * battery into the grid up to `data.powerLimitW`.
+     */
+    protected abstract handleStartStorageGridDischarge(message: EnyoDataBusStartStorageGridDischargeV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `StopStorageGridDischargeV1` command — end an active grid discharge.
+     */
+    protected abstract handleStopStorageGridDischarge(message: EnyoDataBusStopStorageGridDischargeV1): Promise<IntegrationCommandResponse>;
     /**
      * Handles a `SetStorageDischargeLimitV1` command — set the maximum
      * discharge power in watts.
      */
     protected abstract handleSetStorageDischargeLimit(message: EnyoDataBusSetStorageDischargeLimitV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `SetStorageChargeLimitV1` command — set the maximum
+     * charge power in watts.
+     */
+    protected abstract handleSetStorageChargeLimit(message: EnyoDataBusSetStorageChargeLimitV1): Promise<IntegrationCommandResponse>;
     /**
      * @inheritDoc
      */

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

@@ -11,9 +11,14 @@ var EnyoBatteryStorageMode;
 })(EnyoBatteryStorageMode || (exports.EnyoBatteryStorageMode = EnyoBatteryStorageMode = {}));
 var EnyoBatteryFeature;
 (function (EnyoBatteryFeature) {
+    /** If the battery supports being charged from the grid */
     EnyoBatteryFeature["GridCharging"] = "grid-charging";
+    /** If the battery supports discharging into the grid */
+    EnyoBatteryFeature["GridDischarging"] = "grid-discharging";
     /** If the battery supports discharge power limitation */
     EnyoBatteryFeature["DischargeLimitation"] = "discharge-limitation";
+    /** If the battery supports charge power limitation */
+    EnyoBatteryFeature["ChargeLimitation"] = "charge-limitation";
     /** If the battery is connected between DC strings and the inverter */
     EnyoBatteryFeature["BetweenDcStringAndInverter"] = "between-dc-string-and-inverter";
 })(EnyoBatteryFeature || (exports.EnyoBatteryFeature = EnyoBatteryFeature = {}));

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

@@ -6,9 +6,14 @@ export declare enum EnyoBatteryStorageMode {
     Unknown = "unknown"
 }
 export declare enum EnyoBatteryFeature {
+    /** If the battery supports being charged from the grid */
     GridCharging = "grid-charging",
+    /** If the battery supports discharging into the grid */
+    GridDischarging = "grid-discharging",
     /** If the battery supports discharge power limitation */
     DischargeLimitation = "discharge-limitation",
+    /** If the battery supports charge power limitation */
+    ChargeLimitation = "charge-limitation",
     /** If the battery is connected between DC strings and the inverter */
     BetweenDcStringAndInverter = "between-dc-string-and-inverter"
 }

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

@@ -139,7 +139,10 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["HeatpumpDhwTemperatureForecastV1"] = "HeatpumpDhwTemperatureForecastV1";
     EnyoDataBusMessageEnum["StartStorageGridChargeV1"] = "StartStorageGridChargeV1";
     EnyoDataBusMessageEnum["StopStorageGridChargeV1"] = "StopStorageGridChargeV1";
+    EnyoDataBusMessageEnum["StartStorageGridDischargeV1"] = "StartStorageGridDischargeV1";
+    EnyoDataBusMessageEnum["StopStorageGridDischargeV1"] = "StopStorageGridDischargeV1";
     EnyoDataBusMessageEnum["SetStorageDischargeLimitV1"] = "SetStorageDischargeLimitV1";
+    EnyoDataBusMessageEnum["SetStorageChargeLimitV1"] = "SetStorageChargeLimitV1";
     EnyoDataBusMessageEnum["SetInverterFeedInLimitV1"] = "SetInverterFeedInLimitV1";
     EnyoDataBusMessageEnum["CommandAcknowledgeV1"] = "CommandAcknowledgeV1";
     EnyoDataBusMessageEnum["TemperatureSensorValuesUpdateV1"] = "TemperatureSensorValuesUpdateV1";
@@ -158,6 +161,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
     EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
     EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
+    EnyoDataBusMessageEnum["VehicleSocUpdateV1"] = "VehicleSocUpdateV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

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

@@ -179,7 +179,10 @@ export declare enum EnyoDataBusMessageEnum {
     HeatpumpDhwTemperatureForecastV1 = "HeatpumpDhwTemperatureForecastV1",
     StartStorageGridChargeV1 = "StartStorageGridChargeV1",
     StopStorageGridChargeV1 = "StopStorageGridChargeV1",
+    StartStorageGridDischargeV1 = "StartStorageGridDischargeV1",
+    StopStorageGridDischargeV1 = "StopStorageGridDischargeV1",
     SetStorageDischargeLimitV1 = "SetStorageDischargeLimitV1",
+    SetStorageChargeLimitV1 = "SetStorageChargeLimitV1",
     SetInverterFeedInLimitV1 = "SetInverterFeedInLimitV1",
     CommandAcknowledgeV1 = "CommandAcknowledgeV1",
     TemperatureSensorValuesUpdateV1 = "TemperatureSensorValuesUpdateV1",
@@ -197,7 +200,8 @@ export declare enum EnyoDataBusMessageEnum {
     AirConditioningValuesUpdateV1 = "AirConditioningValuesUpdateV1",
     AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
     StartAirConditioningV1 = "StartAirConditioningV1",
-    StopAirConditioningV1 = "StopAirConditioningV1"
+    StopAirConditioningV1 = "StopAirConditioningV1",
+    VehicleSocUpdateV1 = "VehicleSocUpdateV1"
 }
 export type EnyoDataBusMessageResolution = '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 /**
@@ -921,6 +925,36 @@ export interface EnyoDataBusStopStorageGridChargeV1 extends EnyoDataBusMessage {
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Command message to start discharging a storage/battery into the grid.
+ * Instructs the battery system to begin feeding power into the grid up to the specified limit.
+ */
+export interface EnyoDataBusStartStorageGridDischargeV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StartStorageGridDischargeV1;
+    /** ID of the battery/storage appliance to discharge */
+    applianceId: string;
+    data: {
+        /** Maximum power in watts for storage-to-grid discharging */
+        powerLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
+/**
+ * Command message to stop discharging a storage/battery into the grid.
+ * Instructs the battery system to end storage-to-grid discharging.
+ */
+export interface EnyoDataBusStopStorageGridDischargeV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StopStorageGridDischargeV1;
+    /** ID of the battery/storage appliance to stop discharging */
+    applianceId: string;
+    data: {
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
 /**
  * Command message to limit the discharge rate of a storage/battery.
  * Sets the maximum discharge power as a percentage of the battery's maximum discharge capacity.
@@ -937,6 +971,22 @@ export interface EnyoDataBusSetStorageDischargeLimitV1 extends EnyoDataBusMessag
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Command message to limit the charge rate of a storage/battery.
+ * Sets the maximum charge power in watts that the battery is allowed to draw while charging.
+ */
+export interface EnyoDataBusSetStorageChargeLimitV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.SetStorageChargeLimitV1;
+    /** ID of the battery/storage appliance to limit */
+    applianceId: string;
+    data: {
+        /** Charge limit in W to limit the battery's charge power */
+        chargeLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
 /**
  * Command message to set or reset the inverter's grid feed-in power limit.
  * When a limit is set, the inverter will not feed more than the specified power into the grid.
@@ -1326,3 +1376,20 @@ export interface EnyoDataBusStopAirConditioningV1 extends EnyoDataBusMessage {
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Informational message reporting the current state of charge of an electric vehicle.
+ * Published whenever an updated SoC reading becomes available — typically while the
+ * vehicle is plugged in or when the vehicle reports its SoC via a connected service.
+ */
+export interface EnyoDataBusVehicleSocUpdateV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.VehicleSocUpdateV1;
+    data: {
+        /** ID of the vehicle the SoC reading belongs to */
+        vehicleId: string;
+        /** Current state of charge of the vehicle's traction battery in percent (0-100) */
+        socPercent: number;
+        /** Total usable capacity of the vehicle's traction battery in kWh, if known */
+        batterySizeKwh?: number;
+    };
+}

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

@@ -17,6 +17,8 @@ var EnyoHeatpumpApplianceAvailableFeaturesEnum;
     EnyoHeatpumpApplianceAvailableFeaturesEnum["AvailablePowerAnnouncement"] = "AvailablePowerAnnouncement";
     /** If the heatpump reports power values (e.g. electrical power consumption in watts) */
     EnyoHeatpumpApplianceAvailableFeaturesEnum["Power"] = "Power";
+    /** If the heatpump is ready for calibration (i.e. has all prerequisites in place to start a calibration run) */
+    EnyoHeatpumpApplianceAvailableFeaturesEnum["ReadyForCalibration"] = "ReadyForCalibration";
 })(EnyoHeatpumpApplianceAvailableFeaturesEnum || (exports.EnyoHeatpumpApplianceAvailableFeaturesEnum = EnyoHeatpumpApplianceAvailableFeaturesEnum = {}));
 var EnyoHeatpumpApplianceModeEnum;
 (function (EnyoHeatpumpApplianceModeEnum) {

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

@@ -12,7 +12,9 @@ export declare enum EnyoHeatpumpApplianceAvailableFeaturesEnum {
     /** If the heatpump supports available power announcements */
     AvailablePowerAnnouncement = "AvailablePowerAnnouncement",
     /** If the heatpump reports power values (e.g. electrical power consumption in watts) */
-    Power = "Power"
+    Power = "Power",
+    /** If the heatpump is ready for calibration (i.e. has all prerequisites in place to start a calibration run) */
+    ReadyForCalibration = "ReadyForCalibration"
 }
 export declare enum EnyoHeatpumpApplianceModeEnum {
     Idle = "Idle",

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

@@ -9,4 +9,5 @@ export interface EnyoVehicle {
     licensePlate?: string;
     batterySizeKwh?: number;
     pinnedChargingCardId?: string;
+    socPercent?: number;
 }

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.129';
+exports.SDK_VERSION = '0.0.131';
 /**
  * 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.129";
+export declare const SDK_VERSION = "0.0.131";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/integrations/storage-integration-energy-app.d.ts

@@ -1,14 +1,17 @@
 import { IntegrationEnergyApp } from "./integration-energy-app.js";
 import { IntegrationCommandResponse, IntegrationEnergyAppOptions } from "./integration-types.js";
 import { EnyoApplianceTypeEnum } from "../types/enyo-appliance.js";
-import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageDischargeLimitV1, EnyoDataBusStartStorageGridChargeV1, EnyoDataBusStopStorageGridChargeV1 } from "../types/enyo-data-bus-value.js";
+import { EnyoDataBusBatteryValuesUpdateV1, EnyoDataBusGridOperatorPowerLimitationV1, EnyoDataBusSetStorageChargeLimitV1, EnyoDataBusSetStorageDischargeLimitV1, EnyoDataBusStartStorageGridChargeV1, EnyoDataBusStartStorageGridDischargeV1, EnyoDataBusStopStorageGridChargeV1, EnyoDataBusStopStorageGridDischargeV1 } from "../types/enyo-data-bus-value.js";
 /**
  * Abstract base class for battery / storage integrations.
  *
  * Subscribes to:
  *  - `StartStorageGridChargeV1` — start charging the battery from the grid.
  *  - `StopStorageGridChargeV1` — stop grid charging.
+ *  - `StartStorageGridDischargeV1` — start discharging the battery into the grid.
+ *  - `StopStorageGridDischargeV1` — stop grid discharging.
  *  - `SetStorageDischargeLimitV1` — set the maximum discharge power.
+ *  - `SetStorageChargeLimitV1` — set the maximum charge power.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 export declare abstract class StorageIntegrationEnergyApp extends IntegrationEnergyApp {
@@ -27,11 +30,25 @@ export declare abstract class StorageIntegrationEnergyApp extends IntegrationEne
      * Handles a `StopStorageGridChargeV1` command — end an active grid charge.
      */
     protected abstract handleStopStorageGridCharge(message: EnyoDataBusStopStorageGridChargeV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `StartStorageGridDischargeV1` command — start discharging the
+     * battery into the grid up to `data.powerLimitW`.
+     */
+    protected abstract handleStartStorageGridDischarge(message: EnyoDataBusStartStorageGridDischargeV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `StopStorageGridDischargeV1` command — end an active grid discharge.
+     */
+    protected abstract handleStopStorageGridDischarge(message: EnyoDataBusStopStorageGridDischargeV1): Promise<IntegrationCommandResponse>;
     /**
      * Handles a `SetStorageDischargeLimitV1` command — set the maximum
      * discharge power in watts.
      */
     protected abstract handleSetStorageDischargeLimit(message: EnyoDataBusSetStorageDischargeLimitV1): Promise<IntegrationCommandResponse>;
+    /**
+     * Handles a `SetStorageChargeLimitV1` command — set the maximum
+     * charge power in watts.
+     */
+    protected abstract handleSetStorageChargeLimit(message: EnyoDataBusSetStorageChargeLimitV1): Promise<IntegrationCommandResponse>;
     /**
      * @inheritDoc
      */

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

@@ -7,7 +7,10 @@ import { EnyoDataBusMessageEnum } from "../types/enyo-data-bus-value.js";
  * Subscribes to:
  *  - `StartStorageGridChargeV1` — start charging the battery from the grid.
  *  - `StopStorageGridChargeV1` — stop grid charging.
+ *  - `StartStorageGridDischargeV1` — start discharging the battery into the grid.
+ *  - `StopStorageGridDischargeV1` — stop grid discharging.
  *  - `SetStorageDischargeLimitV1` — set the maximum discharge power.
+ *  - `SetStorageChargeLimitV1` — set the maximum charge power.
  *  - `GridOperatorPowerLimitationV1` — §14a EnWG broadcast (handled in base).
  */
 export class StorageIntegrationEnergyApp extends IntegrationEnergyApp {
@@ -23,7 +26,10 @@ export class StorageIntegrationEnergyApp extends IntegrationEnergyApp {
     registerHandlers() {
         this.registerCommandHandler(EnyoDataBusMessageEnum.StartStorageGridChargeV1, (m) => this.handleStartStorageGridCharge(m));
         this.registerCommandHandler(EnyoDataBusMessageEnum.StopStorageGridChargeV1, (m) => this.handleStopStorageGridCharge(m));
+        this.registerCommandHandler(EnyoDataBusMessageEnum.StartStorageGridDischargeV1, (m) => this.handleStartStorageGridDischarge(m));
+        this.registerCommandHandler(EnyoDataBusMessageEnum.StopStorageGridDischargeV1, (m) => this.handleStopStorageGridDischarge(m));
         this.registerCommandHandler(EnyoDataBusMessageEnum.SetStorageDischargeLimitV1, (m) => this.handleSetStorageDischargeLimit(m));
+        this.registerCommandHandler(EnyoDataBusMessageEnum.SetStorageChargeLimitV1, (m) => this.handleSetStorageChargeLimit(m));
     }
     /**
      * Publishes a `BatteryValuesUpdateV1` message with the battery's current

package/dist/types/enyo-battery-appliance.d.ts

@@ -6,9 +6,14 @@ export declare enum EnyoBatteryStorageMode {
     Unknown = "unknown"
 }
 export declare enum EnyoBatteryFeature {
+    /** If the battery supports being charged from the grid */
     GridCharging = "grid-charging",
+    /** If the battery supports discharging into the grid */
+    GridDischarging = "grid-discharging",
     /** If the battery supports discharge power limitation */
     DischargeLimitation = "discharge-limitation",
+    /** If the battery supports charge power limitation */
+    ChargeLimitation = "charge-limitation",
     /** If the battery is connected between DC strings and the inverter */
     BetweenDcStringAndInverter = "between-dc-string-and-inverter"
 }

package/dist/types/enyo-battery-appliance.js

@@ -8,9 +8,14 @@ export var EnyoBatteryStorageMode;
 })(EnyoBatteryStorageMode || (EnyoBatteryStorageMode = {}));
 export var EnyoBatteryFeature;
 (function (EnyoBatteryFeature) {
+    /** If the battery supports being charged from the grid */
     EnyoBatteryFeature["GridCharging"] = "grid-charging";
+    /** If the battery supports discharging into the grid */
+    EnyoBatteryFeature["GridDischarging"] = "grid-discharging";
     /** If the battery supports discharge power limitation */
     EnyoBatteryFeature["DischargeLimitation"] = "discharge-limitation";
+    /** If the battery supports charge power limitation */
+    EnyoBatteryFeature["ChargeLimitation"] = "charge-limitation";
     /** If the battery is connected between DC strings and the inverter */
     EnyoBatteryFeature["BetweenDcStringAndInverter"] = "between-dc-string-and-inverter";
 })(EnyoBatteryFeature || (EnyoBatteryFeature = {}));

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

@@ -179,7 +179,10 @@ export declare enum EnyoDataBusMessageEnum {
     HeatpumpDhwTemperatureForecastV1 = "HeatpumpDhwTemperatureForecastV1",
     StartStorageGridChargeV1 = "StartStorageGridChargeV1",
     StopStorageGridChargeV1 = "StopStorageGridChargeV1",
+    StartStorageGridDischargeV1 = "StartStorageGridDischargeV1",
+    StopStorageGridDischargeV1 = "StopStorageGridDischargeV1",
     SetStorageDischargeLimitV1 = "SetStorageDischargeLimitV1",
+    SetStorageChargeLimitV1 = "SetStorageChargeLimitV1",
     SetInverterFeedInLimitV1 = "SetInverterFeedInLimitV1",
     CommandAcknowledgeV1 = "CommandAcknowledgeV1",
     TemperatureSensorValuesUpdateV1 = "TemperatureSensorValuesUpdateV1",
@@ -197,7 +200,8 @@ export declare enum EnyoDataBusMessageEnum {
     AirConditioningValuesUpdateV1 = "AirConditioningValuesUpdateV1",
     AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
     StartAirConditioningV1 = "StartAirConditioningV1",
-    StopAirConditioningV1 = "StopAirConditioningV1"
+    StopAirConditioningV1 = "StopAirConditioningV1",
+    VehicleSocUpdateV1 = "VehicleSocUpdateV1"
 }
 export type EnyoDataBusMessageResolution = '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 /**
@@ -921,6 +925,36 @@ export interface EnyoDataBusStopStorageGridChargeV1 extends EnyoDataBusMessage {
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Command message to start discharging a storage/battery into the grid.
+ * Instructs the battery system to begin feeding power into the grid up to the specified limit.
+ */
+export interface EnyoDataBusStartStorageGridDischargeV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StartStorageGridDischargeV1;
+    /** ID of the battery/storage appliance to discharge */
+    applianceId: string;
+    data: {
+        /** Maximum power in watts for storage-to-grid discharging */
+        powerLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
+/**
+ * Command message to stop discharging a storage/battery into the grid.
+ * Instructs the battery system to end storage-to-grid discharging.
+ */
+export interface EnyoDataBusStopStorageGridDischargeV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StopStorageGridDischargeV1;
+    /** ID of the battery/storage appliance to stop discharging */
+    applianceId: string;
+    data: {
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
 /**
  * Command message to limit the discharge rate of a storage/battery.
  * Sets the maximum discharge power as a percentage of the battery's maximum discharge capacity.
@@ -937,6 +971,22 @@ export interface EnyoDataBusSetStorageDischargeLimitV1 extends EnyoDataBusMessag
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Command message to limit the charge rate of a storage/battery.
+ * Sets the maximum charge power in watts that the battery is allowed to draw while charging.
+ */
+export interface EnyoDataBusSetStorageChargeLimitV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.SetStorageChargeLimitV1;
+    /** ID of the battery/storage appliance to limit */
+    applianceId: string;
+    data: {
+        /** Charge limit in W to limit the battery's charge power */
+        chargeLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
 /**
  * Command message to set or reset the inverter's grid feed-in power limit.
  * When a limit is set, the inverter will not feed more than the specified power into the grid.
@@ -1326,3 +1376,20 @@ export interface EnyoDataBusStopAirConditioningV1 extends EnyoDataBusMessage {
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Informational message reporting the current state of charge of an electric vehicle.
+ * Published whenever an updated SoC reading becomes available — typically while the
+ * vehicle is plugged in or when the vehicle reports its SoC via a connected service.
+ */
+export interface EnyoDataBusVehicleSocUpdateV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.VehicleSocUpdateV1;
+    data: {
+        /** ID of the vehicle the SoC reading belongs to */
+        vehicleId: string;
+        /** Current state of charge of the vehicle's traction battery in percent (0-100) */
+        socPercent: number;
+        /** Total usable capacity of the vehicle's traction battery in kWh, if known */
+        batterySizeKwh?: number;
+    };
+}

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

@@ -136,7 +136,10 @@ export var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["HeatpumpDhwTemperatureForecastV1"] = "HeatpumpDhwTemperatureForecastV1";
     EnyoDataBusMessageEnum["StartStorageGridChargeV1"] = "StartStorageGridChargeV1";
     EnyoDataBusMessageEnum["StopStorageGridChargeV1"] = "StopStorageGridChargeV1";
+    EnyoDataBusMessageEnum["StartStorageGridDischargeV1"] = "StartStorageGridDischargeV1";
+    EnyoDataBusMessageEnum["StopStorageGridDischargeV1"] = "StopStorageGridDischargeV1";
     EnyoDataBusMessageEnum["SetStorageDischargeLimitV1"] = "SetStorageDischargeLimitV1";
+    EnyoDataBusMessageEnum["SetStorageChargeLimitV1"] = "SetStorageChargeLimitV1";
     EnyoDataBusMessageEnum["SetInverterFeedInLimitV1"] = "SetInverterFeedInLimitV1";
     EnyoDataBusMessageEnum["CommandAcknowledgeV1"] = "CommandAcknowledgeV1";
     EnyoDataBusMessageEnum["TemperatureSensorValuesUpdateV1"] = "TemperatureSensorValuesUpdateV1";
@@ -155,6 +158,7 @@ export var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
     EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
     EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
+    EnyoDataBusMessageEnum["VehicleSocUpdateV1"] = "VehicleSocUpdateV1";
 })(EnyoDataBusMessageEnum || (EnyoDataBusMessageEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

package/dist/types/enyo-heatpump-appliance.d.ts

@@ -12,7 +12,9 @@ export declare enum EnyoHeatpumpApplianceAvailableFeaturesEnum {
     /** If the heatpump supports available power announcements */
     AvailablePowerAnnouncement = "AvailablePowerAnnouncement",
     /** If the heatpump reports power values (e.g. electrical power consumption in watts) */
-    Power = "Power"
+    Power = "Power",
+    /** If the heatpump is ready for calibration (i.e. has all prerequisites in place to start a calibration run) */
+    ReadyForCalibration = "ReadyForCalibration"
 }
 export declare enum EnyoHeatpumpApplianceModeEnum {
     Idle = "Idle",

package/dist/types/enyo-heatpump-appliance.js

@@ -14,6 +14,8 @@ export var EnyoHeatpumpApplianceAvailableFeaturesEnum;
     EnyoHeatpumpApplianceAvailableFeaturesEnum["AvailablePowerAnnouncement"] = "AvailablePowerAnnouncement";
     /** If the heatpump reports power values (e.g. electrical power consumption in watts) */
     EnyoHeatpumpApplianceAvailableFeaturesEnum["Power"] = "Power";
+    /** If the heatpump is ready for calibration (i.e. has all prerequisites in place to start a calibration run) */
+    EnyoHeatpumpApplianceAvailableFeaturesEnum["ReadyForCalibration"] = "ReadyForCalibration";
 })(EnyoHeatpumpApplianceAvailableFeaturesEnum || (EnyoHeatpumpApplianceAvailableFeaturesEnum = {}));
 export var EnyoHeatpumpApplianceModeEnum;
 (function (EnyoHeatpumpApplianceModeEnum) {

package/dist/types/enyo-vehicle.d.ts

@@ -9,4 +9,5 @@ export interface EnyoVehicle {
     licensePlate?: string;
     batterySizeKwh?: number;
     pinnedChargingCardId?: string;
+    socPercent?: number;
 }

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.129";
+export declare const SDK_VERSION = "0.0.131";
 /**
  * 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.129';
+export const SDK_VERSION = '0.0.131';
 /**
  * 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.129",
+  "version": "0.0.131",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",