@enyo-energy/energy-app-sdk 0.0.74 → 0.0.76

package/dist/cjs/index.cjs

@@ -42,6 +42,7 @@ __exportStar(require("./packages/energy-app-pv-forecasting.cjs"), exports);
 __exportStar(require("./types/enyo-pv-system.cjs"), exports);
 __exportStar(require("./packages/energy-app-pv-system.cjs"), exports);
 __exportStar(require("./implementations/data-bus/data-bus-command-handler.cjs"), exports);
+__exportStar(require("./types/enyo-currency.cjs"), exports);
 __exportStar(require("./packages/energy-app-sequence-generator.cjs"), exports);
 __exportStar(require("./packages/energy-app-energy-prices.cjs"), exports);
 __exportStar(require("./packages/energy-app-modbus-rtu.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -51,6 +51,7 @@ export * from './packages/energy-app-pv-forecasting.cjs';
 export * from './types/enyo-pv-system.cjs';
 export * from './packages/energy-app-pv-system.cjs';
 export * from './implementations/data-bus/data-bus-command-handler.cjs';
+export * from './types/enyo-currency.cjs';
 export * from './packages/energy-app-sequence-generator.cjs';
 export * from './packages/energy-app-energy-prices.cjs';
 export * from './packages/energy-app-modbus-rtu.cjs';

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

@@ -1,4 +1,4 @@
-import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse } from "../types/enyo-timeseries.cjs";
+import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse, HeatpumpTemperatureTimeseriesRequest, HeatpumpTemperatureTimeseriesResponse, TemperatureSensorTimeseriesRequest, TemperatureSensorTimeseriesResponse } from "../types/enyo-timeseries.cjs";
 /**
  * Interface for querying historical energy data with 15-minute bucket granularity.
  * Provides methods to retrieve aggregated timeseries data for various energy metrics
@@ -138,4 +138,42 @@ export interface EnergyAppTimeseries {
      * ```
      */
     getHomeConsumptionTimeseries(request: HomeConsumptionTimeseriesRequest): Promise<HomeConsumptionTimeseriesResponse>;
+    /**
+     * Retrieves heatpump temperature timeseries data aggregated in 15-minute buckets.
+     * Returns average temperatures for outdoor, flow, buffer tank, DHW tanks, and heating circuits.
+     * All temperature fields are optional since not all heatpumps report all temperature types.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to heatpump temperature entries with response-level averages
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getHeatpumpTemperatureTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Average outdoor temp: ${response.averageOutdoorTemperatureC} °C`);
+     * ```
+     */
+    getHeatpumpTemperatureTimeseries(request: HeatpumpTemperatureTimeseriesRequest): Promise<HeatpumpTemperatureTimeseriesResponse>;
+    /**
+     * Retrieves temperature sensor timeseries data aggregated in 15-minute buckets.
+     * Returns per-sensor average temperature readings for each bucket, along with
+     * per-sensor averages across the full queried period.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to temperature sensor entries with per-sensor period averages
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getTemperatureSensorTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * response.sensors.forEach(s => {
+     *     console.log(`Sensor ${s.sensorId}: ${s.averageTemperatureC} °C`);
+     * });
+     * ```
+     */
+    getTemperatureSensorTimeseries(request: TemperatureSensorTimeseriesRequest): Promise<TemperatureSensorTimeseriesResponse>;
 }

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

@@ -63,6 +63,20 @@ export interface EnyoCharge {
     meterValues?: ChargeMeterValue[];
     /** Number of phases used for charging */
     numberOfPhases: number;
+    /** Active charging schedule entries, if smart charging is in use */
+    schedule?: EnyoChargeScheduleEntry[];
+}
+/**
+ * Represents a single entry in a charging schedule.
+ * Defines a time-bound current limit for smart charging.
+ */
+export interface EnyoChargeScheduleEntry {
+    /** Start time in seconds relative to the charge session start */
+    relativeStartSeconds: number;
+    /** Absolute start time as an ISO 8601 timestamp */
+    absoluteStartIso: string;
+    /** Current limit in Ampere for this schedule period */
+    limitAmpere: number;
 }
 export interface EnyoChargeFilter {
     /** Filter by specific appliance ID */

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

@@ -12,9 +12,25 @@ export declare enum EnyoChargerApplianceAuthorizationModeEnum {
     AuthorizationRequired = "AuthorizationRequired",
     NoAuthorization = "NoAuthorization"
 }
+/**
+ * Represents a single OCPP configuration entry from the charger.
+ */
+export interface EnyoChargerApplianceOcppConfigurationEntry {
+    /** Configuration key name */
+    key: string;
+    /** Configuration value */
+    value: string;
+    /** Whether this configuration entry is read-only */
+    readonly: boolean;
+}
+/**
+ * OCPP-specific metadata for a charger appliance.
+ */
 export interface EnyoChargerApplianceOcppMetadata {
     chargePointId: string;
     ocppVersion: '1.6' | '2.0.1';
+    /** OCPP configuration entries retrieved from the charger */
+    configuration?: EnyoChargerApplianceOcppConfigurationEntry[];
 }
 export declare enum EnyoChargerApplianceAvailableFeaturesEnum {
     /** If the charger can limit the power in Ampere or Watt*/
@@ -47,4 +63,6 @@ export interface EnyoChargerApplianceMetadata {
     authorizationMode: EnyoChargerApplianceAuthorizationModeEnum;
     /** If cableType is Socket, the cable can be locked for theft protection */
     cableLocked?: boolean;
+    /** Current charging power limit in kilowatts */
+    currentChargingLimitKw?: number;
 }

package/dist/cjs/types/enyo-currency.cjs

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnyoCurrencyEnum = void 0;
+/**
+ * Supported currency codes following ISO 4217.
+ */
+var EnyoCurrencyEnum;
+(function (EnyoCurrencyEnum) {
+    /** Euro */
+    EnyoCurrencyEnum["EUR"] = "EUR";
+})(EnyoCurrencyEnum || (exports.EnyoCurrencyEnum = EnyoCurrencyEnum = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Supported currency codes following ISO 4217.
+ */
+export declare enum EnyoCurrencyEnum {
+    /** Euro */
+    EUR = "EUR"
+}

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

@@ -1,6 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnyoCommandAcknowledgeAnswerEnum = exports.EnyoDataBusMessageEnum = exports.EnyoChargeModeEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoStringStateEnum = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = void 0;
+exports.EnyoCommandAcknowledgeAnswerEnum = exports.EnyoDataBusMessageEnum = exports.EnyoChargeModeEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoStringStateEnum = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = 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.
+ */
+var EnyoDataBusCommandReasonTypeEnum;
+(function (EnyoDataBusCommandReasonTypeEnum) {
+    /** Command issued because the electricity price is below a configured threshold */
+    EnyoDataBusCommandReasonTypeEnum["ElectricityPriceBelowThreshold"] = "electricity-price-below-threshold";
+    /** Command issued because the electricity price is above a configured threshold */
+    EnyoDataBusCommandReasonTypeEnum["ElectricityPriceAboveThreshold"] = "electricity-price-above-threshold";
+    /** Command issued because PV surplus is available */
+    EnyoDataBusCommandReasonTypeEnum["PvSurplusAvailable"] = "pv-surplus-available";
+    /** Command issued because PV surplus is unavailable */
+    EnyoDataBusCommandReasonTypeEnum["PvSurplusUnavailable"] = "pv-surplus-unavailable";
+    /** Command issued because battery capacity is available */
+    EnyoDataBusCommandReasonTypeEnum["BatteryCapacityAvailable"] = "battery-capacity-available";
+    /** Command issued because battery capacity is unavailable */
+    EnyoDataBusCommandReasonTypeEnum["BatteryCapacityUnavailable"] = "battery-capacity-unavailable";
+    /** Command issued because a grid operator power limitation is active */
+    EnyoDataBusCommandReasonTypeEnum["GridOperatorPowerLimitationActive"] = "grid-operator-power-limitation-active";
+    /** Command issued because a grid operator power limitation is inactive */
+    EnyoDataBusCommandReasonTypeEnum["GridOperatorPowerLimitationInactive"] = "grid-operator-power-limitation-inactive";
+})(EnyoDataBusCommandReasonTypeEnum || (exports.EnyoDataBusCommandReasonTypeEnum = EnyoDataBusCommandReasonTypeEnum = {}));
 var EnyoBatteryStateEnum;
 (function (EnyoBatteryStateEnum) {
     EnyoBatteryStateEnum["Off"] = "off";
@@ -108,6 +131,11 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["RequestPreviewChargingScheduleV1"] = "RequestPreviewChargingScheduleV1";
     EnyoDataBusMessageEnum["PreviewChargingScheduleResponseV1"] = "PreviewChargingScheduleResponseV1";
     EnyoDataBusMessageEnum["PvForecastV1"] = "PvForecastV1";
+    EnyoDataBusMessageEnum["BatteryForecastV1"] = "BatteryForecastV1";
+    EnyoDataBusMessageEnum["HomeConsumptionForecastV1"] = "HomeConsumptionForecastV1";
+    EnyoDataBusMessageEnum["EvChargingForecastV1"] = "EvChargingForecastV1";
+    EnyoDataBusMessageEnum["HeatpumpConsumptionForecastV1"] = "HeatpumpConsumptionForecastV1";
+    EnyoDataBusMessageEnum["HeatpumpDhwTemperatureForecastV1"] = "HeatpumpDhwTemperatureForecastV1";
     EnyoDataBusMessageEnum["StartStorageGridChargeV1"] = "StartStorageGridChargeV1";
     EnyoDataBusMessageEnum["StopStorageGridChargeV1"] = "StopStorageGridChargeV1";
     EnyoDataBusMessageEnum["SetStorageDischargeLimitV1"] = "SetStorageDischargeLimitV1";
@@ -115,6 +143,9 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["CommandAcknowledgeV1"] = "CommandAcknowledgeV1";
     EnyoDataBusMessageEnum["TemperatureSensorValuesUpdateV1"] = "TemperatureSensorValuesUpdateV1";
     EnyoDataBusMessageEnum["HeatpumpTemperaturesUpdateV1"] = "HeatpumpTemperaturesUpdateV1";
+    EnyoDataBusMessageEnum["MaxChargingPowerChangedV1"] = "MaxChargingPowerChangedV1";
+    EnyoDataBusMessageEnum["MaxDischargePowerChangedV1"] = "MaxDischargePowerChangedV1";
+    EnyoDataBusMessageEnum["GridOperatorPowerLimitationV1"] = "GridOperatorPowerLimitationV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

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

@@ -3,8 +3,48 @@ import { EnyoSourceEnum } from "./enyo-source.enum.cjs";
 import { EnyoOcppRelativeSchedule } from "./enyo-ocpp.cjs";
 import { EnyoChargerApplianceStatusEnum } from "./enyo-charger-appliance.cjs";
 import { PreviewChargingSchedule, PreviewChargingScheduleCostComparison, PreviewChargingScheduleUnavailableReasonEnum } from "./enyo-energy-manager.cjs";
-import { PvForecast } from "./enyo-pv-forecast.cjs";
 import { EnyoEnergyPrices } from "./enyo-energy-prices.cjs";
+import { EnyoCurrencyEnum } from "./enyo-currency.cjs";
+/**
+ * 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.
+ */
+export declare enum EnyoDataBusCommandReasonTypeEnum {
+    /** Command issued because the electricity price is below a configured threshold */
+    ElectricityPriceBelowThreshold = "electricity-price-below-threshold",
+    /** Command issued because the electricity price is above a configured threshold */
+    ElectricityPriceAboveThreshold = "electricity-price-above-threshold",
+    /** Command issued because PV surplus is available */
+    PvSurplusAvailable = "pv-surplus-available",
+    /** Command issued because PV surplus is unavailable */
+    PvSurplusUnavailable = "pv-surplus-unavailable",
+    /** Command issued because battery capacity is available */
+    BatteryCapacityAvailable = "battery-capacity-available",
+    /** Command issued because battery capacity is unavailable */
+    BatteryCapacityUnavailable = "battery-capacity-unavailable",
+    /** Command issued because a grid operator power limitation is active */
+    GridOperatorPowerLimitationActive = "grid-operator-power-limitation-active",
+    /** Command issued because a grid operator power limitation is inactive */
+    GridOperatorPowerLimitationInactive = "grid-operator-power-limitation-inactive"
+}
+/**
+ * Interface describing the reason why a data bus command was issued.
+ * Provides context for commands such as pricing information, capacity, or power values.
+ */
+export interface EnyoDataBusCommandReason {
+    /** The reason type indicating why this command was issued */
+    type: EnyoDataBusCommandReasonTypeEnum;
+    /** Electricity price per kWh that triggered this command */
+    electricityPricePerKwh?: number;
+    /** Currency of the electricity price */
+    currency?: EnyoCurrencyEnum;
+    /** Relevant capacity in kWh */
+    capacityKwh?: number;
+    /** Relevant power in Watts */
+    powerW?: number;
+    /** Relevant energy in Watt hours */
+    powerWh?: number;
+}
 export declare enum EnyoBatteryStateEnum {
     Off = "off",
     Empty = "empty",
@@ -128,13 +168,21 @@ export declare enum EnyoDataBusMessageEnum {
     RequestPreviewChargingScheduleV1 = "RequestPreviewChargingScheduleV1",
     PreviewChargingScheduleResponseV1 = "PreviewChargingScheduleResponseV1",
     PvForecastV1 = "PvForecastV1",
+    BatteryForecastV1 = "BatteryForecastV1",
+    HomeConsumptionForecastV1 = "HomeConsumptionForecastV1",
+    EvChargingForecastV1 = "EvChargingForecastV1",
+    HeatpumpConsumptionForecastV1 = "HeatpumpConsumptionForecastV1",
+    HeatpumpDhwTemperatureForecastV1 = "HeatpumpDhwTemperatureForecastV1",
     StartStorageGridChargeV1 = "StartStorageGridChargeV1",
     StopStorageGridChargeV1 = "StopStorageGridChargeV1",
     SetStorageDischargeLimitV1 = "SetStorageDischargeLimitV1",
     SetInverterFeedInLimitV1 = "SetInverterFeedInLimitV1",
     CommandAcknowledgeV1 = "CommandAcknowledgeV1",
     TemperatureSensorValuesUpdateV1 = "TemperatureSensorValuesUpdateV1",
-    HeatpumpTemperaturesUpdateV1 = "HeatpumpTemperaturesUpdateV1"
+    HeatpumpTemperaturesUpdateV1 = "HeatpumpTemperaturesUpdateV1",
+    MaxChargingPowerChangedV1 = "MaxChargingPowerChangedV1",
+    MaxDischargePowerChangedV1 = "MaxDischargePowerChangedV1",
+    GridOperatorPowerLimitationV1 = "GridOperatorPowerLimitationV1"
 }
 export type EnyoDataBusMessageResolution = '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 export interface EnyoDataBusMessage {
@@ -179,7 +227,7 @@ export interface EnyoDataBusHeatpumpValuesV1 extends EnyoDataBusMessage {
     /** ID of the appliance that delivered these values */
     applianceId: string;
     data: {
-        values?: {
+        values: {
             /** Power consumption for heating in Wh (meter value)*/
             powerConsumptionHeatingWh?: number;
             /** Power consumption for domestic hot water in Wh (meter value)*/
@@ -383,7 +431,6 @@ export interface EnyoDataBusAggregatedStateValuesV1 extends EnyoDataBusMessage {
         /** Total heat generation for domestic hot water from all appliances (in Watt hours) */
         totalHeatGenerationDomesticHotWaterWh?: number;
         autarkyPercentage?: number;
-        resolution: '1min' | '15min';
         /** Array of all appliances with their individual values and current state */
         appliances: Array<{
             /** ID of the appliance */
@@ -404,6 +451,8 @@ export interface EnyoDataBusPauseChargingV1 extends EnyoDataBusMessage {
     message: EnyoDataBusMessageEnum.PauseChargingV1;
     data: {
         applianceId: string;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 export interface EnyoDataBusResumeChargingV1 extends EnyoDataBusMessage {
@@ -412,6 +461,8 @@ export interface EnyoDataBusResumeChargingV1 extends EnyoDataBusMessage {
     data: {
         applianceId: string;
         maxChargingPowerKw: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 export interface EnyoDataBusChangeChargingPowerV1 extends EnyoDataBusMessage {
@@ -420,6 +471,8 @@ export interface EnyoDataBusChangeChargingPowerV1 extends EnyoDataBusMessage {
     applianceId: string;
     data: {
         maxChargingPowerKw: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 export interface EnyoDataBusSetChargingScheduleV1 extends EnyoDataBusMessage {
@@ -428,6 +481,8 @@ export interface EnyoDataBusSetChargingScheduleV1 extends EnyoDataBusMessage {
     applianceId: string;
     data: {
         relativeSchedule: EnyoOcppRelativeSchedule[];
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -451,6 +506,8 @@ export interface EnyoDataBusStartChargeV1 extends EnyoDataBusMessage {
         chargeMode: EnyoChargeModeEnum;
         /** ISO timestamp for target completion time (optional) */
         completeChargeAtIso?: string;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -464,6 +521,8 @@ export interface EnyoDataBusStopChargeV1 extends EnyoDataBusMessage {
     data: {
         /** OCPP transaction identifier of the session to stop */
         transactionId: string;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -579,18 +638,172 @@ export interface PreviewChargingScheduleModeResult {
     /** Cost comparison of this mode vs immediate charging (only present if cost data is available) */
     costComparison?: PreviewChargingScheduleCostComparison;
 }
+/**
+ * Available resolution options for forecast data points.
+ */
+export type EnyoForecastResolution = '10s' | '1m' | '5m' | '15m' | '1h';
+/**
+ * A single data point in a PV forecast, containing power and energy values.
+ */
+export interface EnyoPvForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted PV power in Watts */
+    powerW: number;
+    /** Forecasted PV energy in Watt hours for this interval */
+    powerWh: number;
+}
+/**
+ * A single data point in a battery forecast, containing capacity and state of charge values.
+ */
+export interface EnyoBatteryForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted battery capacity in Watt hours */
+    capacityWh: number;
+    /** Forecasted battery state of charge in percent (0-100) */
+    socPercent: number;
+}
+/**
+ * A single data point in a home consumption forecast, containing power and energy values.
+ */
+export interface EnyoHomeConsumptionForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted home consumption power in Watts */
+    powerW: number;
+    /** Forecasted home consumption energy in Watt hours for this interval */
+    powerWh: number;
+}
+/**
+ * A single data point in an EV charging forecast, containing power and energy values.
+ */
+export interface EnyoEvChargingForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted EV charging power in Watts */
+    powerW: number;
+    /** Forecasted EV charging energy in Watt hours for this interval */
+    powerWh: number;
+}
+/**
+ * A single data point in a heatpump consumption forecast, containing power and energy values.
+ */
+export interface EnyoHeatpumpConsumptionForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted heatpump consumption power in Watts */
+    powerW: number;
+    /** Forecasted heatpump consumption energy in Watt hours for this interval */
+    powerWh: number;
+}
+/**
+ * A single data point in a heatpump DHW temperature forecast.
+ */
+export interface EnyoHeatpumpDhwTemperatureForecastDataPoint {
+    /** ISO 8601 timestamp for this forecast data point */
+    timestampIso: string;
+    /** Forecasted domestic hot water temperature in Celsius */
+    temperatureC: number;
+}
 /**
  * Message for delivering PV production forecast data.
- * Contains forecasted power and energy values in 15-minute intervals.
+ * Contains forecasted power and energy values at the specified resolution.
+ * Can be sent for a specific PV appliance or as a total across all PV systems.
  */
 export interface EnyoDataBusPvForecastV1 extends EnyoDataBusMessage {
     type: 'message';
     message: EnyoDataBusMessageEnum.PvForecastV1;
-    /** Optional ID of the specific PV appliance this forecast applies to */
+    /** Optional ID of the specific PV appliance. Omit for total forecast. */
     applianceId?: string;
     data: {
-        /** The PV forecast data including time range and 15-minute buckets */
-        forecast: PvForecast;
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoPvForecastDataPoint[];
+    };
+}
+/**
+ * Message for delivering battery forecast data.
+ * Contains forecasted capacity and state of charge values at the specified resolution.
+ * Can be sent for a specific battery appliance or as a total across all batteries.
+ */
+export interface EnyoDataBusBatteryForecastV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.BatteryForecastV1;
+    /** Optional ID of the specific battery appliance. Omit for total forecast. */
+    applianceId?: string;
+    data: {
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoBatteryForecastDataPoint[];
+    };
+}
+/**
+ * Message for delivering home consumption forecast data.
+ * Contains forecasted power and energy values at the specified resolution.
+ * Always represents the total home consumption (no per-appliance breakdown).
+ */
+export interface EnyoDataBusHomeConsumptionForecastV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HomeConsumptionForecastV1;
+    data: {
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoHomeConsumptionForecastDataPoint[];
+    };
+}
+/**
+ * Message for delivering EV charging forecast data.
+ * Contains forecasted power and energy values at the specified resolution.
+ * Can be sent for a specific charger appliance or as a total across all chargers.
+ */
+export interface EnyoDataBusEvChargingForecastV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.EvChargingForecastV1;
+    /** Optional ID of the specific charger appliance. Omit for total forecast. */
+    applianceId?: string;
+    data: {
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoEvChargingForecastDataPoint[];
+    };
+}
+/**
+ * Message for delivering heatpump consumption forecast data.
+ * Contains forecasted power and energy values at the specified resolution.
+ * Always sent for a specific heatpump appliance.
+ */
+export interface EnyoDataBusHeatpumpConsumptionForecastV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HeatpumpConsumptionForecastV1;
+    /** ID of the heatpump appliance this forecast applies to */
+    applianceId: string;
+    data: {
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoHeatpumpConsumptionForecastDataPoint[];
+    };
+}
+/**
+ * Message for delivering heatpump domestic hot water temperature forecast data.
+ * Contains forecasted temperature values at the specified resolution.
+ * Always sent for a specific heatpump appliance.
+ */
+export interface EnyoDataBusHeatpumpDhwTemperatureForecastV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HeatpumpDhwTemperatureForecastV1;
+    /** ID of the heatpump appliance this forecast applies to */
+    applianceId: string;
+    data: {
+        /** Resolution of the forecast data points */
+        resolution: EnyoForecastResolution;
+        /** Array of forecast data points */
+        entries: EnyoHeatpumpDhwTemperatureForecastDataPoint[];
     };
 }
 /**
@@ -605,6 +818,8 @@ export interface EnyoDataBusStartStorageGridChargeV1 extends EnyoDataBusMessage
     data: {
         /** Maximum power in watts for grid-to-storage charging */
         powerLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -616,7 +831,10 @@ export interface EnyoDataBusStopStorageGridChargeV1 extends EnyoDataBusMessage {
     message: EnyoDataBusMessageEnum.StopStorageGridChargeV1;
     /** ID of the battery/storage appliance to stop charging */
     applianceId: string;
-    data: {};
+    data: {
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
 }
 /**
  * Command message to limit the discharge rate of a storage/battery.
@@ -630,6 +848,8 @@ export interface EnyoDataBusSetStorageDischargeLimitV1 extends EnyoDataBusMessag
     data: {
         /** Discharge limit in W to limit the battery's discharge power */
         dischargeLimitW: number;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -645,6 +865,8 @@ export interface EnyoDataBusSetInverterFeedInLimitV1 extends EnyoDataBusMessage
     data: {
         /** Feed-in limit in watts, or null to reset to default (no limit) */
         feedInLimitW: number | null;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
     };
 }
 /**
@@ -743,3 +965,48 @@ export interface EnyoDataBusHeatpumpTemperaturesV1 extends EnyoDataBusMessage {
         };
     };
 }
+/**
+ * Informational message sent by an appliance when its maximum charging power has changed.
+ * This allows the energy manager to adjust its optimization based on current appliance capabilities.
+ */
+export interface EnyoDataBusMaxChargingPowerChangedV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.MaxChargingPowerChangedV1;
+    /** ID of the appliance reporting the change */
+    applianceId: string;
+    data: {
+        /** Maximum charging power in kilowatts */
+        maxChargingPowerKw: number;
+    };
+}
+/**
+ * Informational message sent by an appliance when its maximum discharge power has changed.
+ * This allows the energy manager to adjust its optimization based on current appliance capabilities.
+ */
+export interface EnyoDataBusMaxDischargePowerChangedV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.MaxDischargePowerChangedV1;
+    /** ID of the appliance reporting the change */
+    applianceId: string;
+    data: {
+        /** Maximum discharge power in kilowatts */
+        maxDischargePowerKw: number;
+    };
+}
+/**
+ * Command message for grid operator power limitations directed at the energy manager.
+ * Communicates whether a power limitation is active, the power limit, and when it ends.
+ * The energy manager should adjust its optimization strategy accordingly.
+ */
+export interface EnyoDataBusGridOperatorPowerLimitationV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.GridOperatorPowerLimitationV1;
+    data: {
+        /** Whether the grid operator power limitation is currently active */
+        active: boolean;
+        /** The power limitation in watts */
+        powerLimitationW: number;
+        /** ISO 8601 timestamp when the limitation ends */
+        endTimestampIso: string;
+    };
+}