@enyo-energy/energy-app-sdk 0.0.185 → 0.0.186

package/README.md

@@ -167,6 +167,7 @@ The SDK exposes several layered building blocks. Pick the one that matches the k
 | Retrieve secrets from the developer org secret store | [`useSecretManager()`](#usesecretmanager-energyappsecretmanager) |
 | Submit energy-manager diagnostics | [`useDiagnostics()`](#usediagnostics-energyappdiagnostics) |
 | Register a weather / PV / dynamic-price forecast provider | [`useWeatherForecasting()`](#useweatherforecasting-energyappweatherforecasting) / [`usePvForecasting()`](#usepvforecasting-energyapppvforecasting) / [`useDynamicPriceForecast()`](#usedynamicpriceforecast-energyappdynamicpriceforecast) |
+| Read EPEX SPOT wholesale prices (incl. negative-price windows) | [`useEpexSpotPrices()`](#useepexspotprices-energyappepexspotprice) |
 | Manage electricity tariffs (default tariff, price per kWh) | [`useElectricityTariff()`](#useelectricitytariff-energyappelectricitytariff) |
 | Register a PV system (kWp, DC strings, orientation) | [`usePvSystem()`](#usepvsystem-energyapppvsystem) |
 | Discover capabilities of the active energy manager | [`useEnergyManager()`](#useenergymanager-energyappenergymanager) |
@@ -353,6 +354,7 @@ Energy Apps use a granular permissions system to control access to system resour
 - **`DynamicPriceForecastRegister`** / **`DynamicPriceForecastUse`**: Publish / consume dynamic-price forecasts
 - **`PvSystemRegister`** / **`PvSystemUse`**: Register / read PV system configuration
 - **`Savings`**: Publish and read back day-scoped savings reports
+- **`EpexSpotPrices`**: Read EPEX SPOT day-ahead wholesale market prices
 
 #### Site & Identity Permissions
 
@@ -1139,6 +1141,42 @@ dpf.onForecastPublished((forecast) => console.log('new forecast', forecast.forec
 
 Publishers need `DynamicPriceForecastRegister`; consumers need `DynamicPriceForecastUse`.
 
+#### `useEpexSpotPrices(): EnergyAppEpexSpotPrice`
+
+Read the EPEX SPOT day-ahead wholesale prices the host caches for this device, so an energy manager can decide when to charge, when to run a flexible load, and when to stop exporting PV.
+
+These are **raw market prices** — no grid fees, levies, taxes or supplier margin — and they go **negative** when supply outruns demand. For what the customer is billed use [`useElectricityPrices()`](#useelectricityprices-energyappenergyprices); for forecasts published by other apps use [`useDynamicPriceForecast()`](#usedynamicpriceforecast-energyappdynamicpriceforecast).
+
+```typescript
+const epex = energyApp.useEpexSpotPrices();
+
+const now = await epex.getCurrentSpotPrice();
+if (now && now.pricePerKwh < 0) {
+    // feeding in costs money right now
+}
+
+const tomorrow = await epex.getSpotPrices({
+    fromIso: '2026-08-13T00:00:00Z',
+    untilIso: '2026-08-14T00:00:00Z'
+});
+
+// Pre-grouped runs of sub-zero periods — the shape curtailment logic wants.
+const windows = await epex.getNegativePriceWindows();
+
+// Tomorrow's auction clears around 14:00 CET; re-plan when it lands.
+epex.onSpotPricesUpdated(prices => scheduler.replan(prices.entries));
+```
+
+Notes worth respecting:
+
+- **Read `resolution`, don't assume it.** EPEX SPOT day-ahead moved to 15-minute periods in 2025, but older data is still hourly.
+- **The series may be shorter than you asked for.** Before the day-ahead auction clears (14:00 CET/CEST), only today exists — check the last entry's `endTimestampIso`.
+- **`retrievedAtIso` tells you how stale the cache is** after the device has been offline.
+- Prices come both as `pricePerMwh` (the exchange's own unit) and `pricePerKwh` (the SDK's convention).
+- Inverter appliances carry a `blockFeedInOnNegativePrices` flag in their metadata (`EnyoInverterApplianceMetadata`). It is configuration, not state: whoever controls the inverter is responsible for curtailing export to 0 W while the price is negative and lifting the curtailment afterwards.
+
+Requires the `EpexSpotPrices` permission.
+
 #### `usePvSystem(): EnergyAppPvSystem`
 
 Register a PV system's structural configuration (kWp, DC string orientations, associated appliances) so other apps can reason about expected production.

package/dist/cjs/energy-app-permission.type.cjs

@@ -51,5 +51,6 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["ProvidedFiles"] = "ProvidedFiles";
     EnergyAppPermissionTypeEnum["Automation"] = "Automation";
     EnergyAppPermissionTypeEnum["Savings"] = "Savings";
+    EnergyAppPermissionTypeEnum["EpexSpotPrices"] = "EpexSpotPrices";
     EnergyAppPermissionTypeEnum["FirmwareRegistry"] = "FirmwareRegistry";
 })(EnergyAppPermissionTypeEnum || (exports.EnergyAppPermissionTypeEnum = EnergyAppPermissionTypeEnum = {}));

package/dist/cjs/energy-app-permission.type.d.cts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'AllNetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'DynamicPriceForecastRegister' | 'DynamicPriceForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'BatteryStorageState' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess' | 'Udp' | 'ProvidedFiles' | 'Automation' | 'Savings' | 'FirmwareRegistry';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'AllNetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'DynamicPriceForecastRegister' | 'DynamicPriceForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'BatteryStorageState' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess' | 'Udp' | 'ProvidedFiles' | 'Automation' | 'Savings' | 'EpexSpotPrices' | 'FirmwareRegistry';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -48,5 +48,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     ProvidedFiles = "ProvidedFiles",
     Automation = "Automation",
     Savings = "Savings",
+    EpexSpotPrices = "EpexSpotPrices",
     FirmwareRegistry = "FirmwareRegistry"
 }

package/dist/cjs/energy-app.cjs

@@ -397,6 +397,22 @@ class EnergyApp {
     useDeviceTest() {
         return this.energyAppSdk.useDeviceTest();
     }
+    /**
+     * Gets the EPEX SPOT Price API for reading the cleared day-ahead
+     * wholesale electricity prices that apply to this device.
+     *
+     * These are raw market prices — excluding grid fees, levies, taxes and
+     * supplier margin, and negative when supply outruns demand — intended for
+     * energy-manager decisions such as when to charge, when to run a flexible
+     * load, and when to curtail PV feed-in. For customer-billed pricing use
+     * {@link useElectricityPrices} instead.
+     * @returns The EPEX SPOT Price API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *         permission is not granted.
+     */
+    useEpexSpotPrices() {
+        return this.energyAppSdk.useEpexSpotPrices();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -42,6 +42,7 @@ import { EnergyAppFirmwareRegistry } from "./packages/energy-app-firmware-regist
 import { EnergyAppAutomation } from "./packages/energy-app-automation.cjs";
 import { EnergyAppSavings } from "./packages/energy-app-savings.cjs";
 import { EnergyAppDeviceTest } from "./packages/energy-app-device-test.cjs";
+import { EnergyAppEpexSpotPrice } from "./packages/energy-app-epex-spot-price.cjs";
 import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
@@ -323,6 +324,20 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Device Test API instance
      */
     useDeviceTest(): EnergyAppDeviceTest;
+    /**
+     * Gets the EPEX SPOT Price API for reading the cleared day-ahead
+     * wholesale electricity prices that apply to this device.
+     *
+     * These are raw market prices — excluding grid fees, levies, taxes and
+     * supplier margin, and negative when supply outruns demand — intended for
+     * energy-manager decisions such as when to charge, when to run a flexible
+     * load, and when to curtail PV feed-in. For customer-billed pricing use
+     * {@link useElectricityPrices} instead.
+     * @returns The EPEX SPOT Price API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *         permission is not granted.
+     */
+    useEpexSpotPrices(): EnergyAppEpexSpotPrice;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/enyo-energy-app-sdk.d.cts

@@ -41,6 +41,7 @@ import { EnergyAppFirmwareRegistry } from "./packages/energy-app-firmware-regist
 import { EnergyAppAutomation } from "./packages/energy-app-automation.cjs";
 import { EnergyAppSavings } from "./packages/energy-app-savings.cjs";
 import { EnergyAppDeviceTest } from "./packages/energy-app-device-test.cjs";
+import { EnergyAppEpexSpotPrice } from "./packages/energy-app-epex-spot-price.cjs";
 import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
@@ -154,4 +155,6 @@ export interface EnyoEnergyAppSdk {
     useSavings: () => EnergyAppSavings;
     /** Get the Device Test API for answering the host's requests to test detected network devices and report whether appliances were found or created */
     useDeviceTest: () => EnergyAppDeviceTest;
+    /** Get the EPEX SPOT Price API for reading the cleared day-ahead wholesale electricity prices that apply to this device */
+    useEpexSpotPrices: () => EnergyAppEpexSpotPrice;
 }

package/dist/cjs/index.cjs

@@ -128,6 +128,8 @@ __exportStar(require("./packages/energy-app-device-test.cjs"), exports);
 __exportStar(require("./implementations/device-test/device-test-validators.cjs"), exports);
 __exportStar(require("./types/enyo-savings.cjs"), exports);
 __exportStar(require("./packages/energy-app-savings.cjs"), exports);
+__exportStar(require("./types/enyo-epex-spot-price.cjs"), exports);
+__exportStar(require("./packages/energy-app-epex-spot-price.cjs"), exports);
 __exportStar(require("./types/enyo-automation.cjs"), exports);
 __exportStar(require("./packages/energy-app-automation.cjs"), exports);
 __exportStar(require("./implementations/automation/automation-validators.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -112,6 +112,8 @@ export * from './packages/energy-app-device-test.cjs';
 export * from './implementations/device-test/device-test-validators.cjs';
 export * from './types/enyo-savings.cjs';
 export * from './packages/energy-app-savings.cjs';
+export * from './types/enyo-epex-spot-price.cjs';
+export * from './packages/energy-app-epex-spot-price.cjs';
 export * from './types/enyo-automation.cjs';
 export * from './packages/energy-app-automation.cjs';
 export * from './implementations/automation/automation-validators.cjs';

package/dist/cjs/packages/energy-app-epex-spot-price.cjs

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

package/dist/cjs/packages/energy-app-epex-spot-price.d.cts

@@ -0,0 +1,123 @@
+import { EnyoEpexNegativePriceWindow, EnyoEpexSpotPriceEntry, EnyoEpexSpotPriceFilter, EnyoEpexSpotPrices } from "../types/enyo-epex-spot-price.cjs";
+/**
+ * Interface for reading EPEX SPOT day-ahead electricity prices.
+ *
+ * The host fetches the cleared prices that apply to this device and caches
+ * them locally, so every app on the device shares one source of truth instead
+ * of each one calling a price API itself. An energy manager can use the series
+ * to decide when to charge a battery, when to run a flexible load, and — via
+ * {@link EnyoInverterApplianceMetadata.blockFeedInOnNegativePrices} — when to
+ * stop exporting PV to the grid.
+ *
+ * What this API returns is **market data, not customer pricing**: the raw
+ * exchange result, excluding grid fees, levies, taxes and supplier margin, and
+ * negative whenever supply outruns demand. For what the customer is actually
+ * billed, use {@link EnergyAppEnergyPrices}; for forward-looking price
+ * forecasts published by other apps, use
+ * {@link EnergyAppDynamicPriceForecast}.
+ *
+ * Prices for the following day become known once the auction clears (14:00
+ * CET/CEST) — before that, only the current day is available, so an app must
+ * always tolerate a series that ends earlier than it would like.
+ *
+ * Access to this API requires the `EpexSpotPrices` permission
+ * ({@link EnergyAppPermissionType}); {@link EnergyApp.useEpexSpotPrices} throws
+ * when it has not been granted.
+ *
+ * @example
+ * ```typescript
+ * const epex = energyApp.useEpexSpotPrices();
+ *
+ * const now = await epex.getCurrentSpotPrice();
+ * if (now && now.pricePerKwh < 0) {
+ *     // exporting costs money right now
+ * }
+ *
+ * // Re-plan whenever tomorrow's auction result arrives.
+ * epex.onSpotPricesUpdated(prices => scheduler.replan(prices.entries));
+ * ```
+ */
+export interface EnergyAppEpexSpotPrice {
+    /**
+     * Retrieves the cached EPEX SPOT price series for a time range.
+     *
+     * Returns `null` when the host holds no prices at all (for example on a
+     * device that has never been online). A series that is merely shorter than
+     * the requested range is returned as-is with the entries that are known —
+     * check the last entry's `endTimestampIso` before planning against it.
+     *
+     * @param filter - Optional time range. Defaults to the current delivery
+     *   period through the end of the known series.
+     * @returns Promise resolving to the price series, or `null` if none is available.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     *
+     * @example
+     * ```typescript
+     * const prices = await epex.getSpotPrices({
+     *     fromIso: '2026-08-12T00:00:00Z',
+     *     untilIso: '2026-08-13T00:00:00Z'
+     * });
+     * const cheapest = prices?.entries
+     *     .reduce((min, e) => e.pricePerKwh < min.pricePerKwh ? e : min);
+     * ```
+     */
+    getSpotPrices(filter?: EnyoEpexSpotPriceFilter): Promise<EnyoEpexSpotPrices | null>;
+    /**
+     * Retrieves the price of the delivery period that contains "now".
+     *
+     * Convenience wrapper around {@link getSpotPrices} for control loops that
+     * only need the price they are currently exposed to.
+     *
+     * @returns Promise resolving to the current entry, or `null` when the
+     *   current period is not covered by the cached series.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     */
+    getCurrentSpotPrice(): Promise<EnyoEpexSpotPriceEntry | null>;
+    /**
+     * Retrieves the contiguous runs of delivery periods priced below zero
+     * within the requested range.
+     *
+     * This is the same information as {@link getSpotPrices}, pre-grouped for
+     * the decisions that care about it: curtailing PV feed-in, and pulling
+     * consumption into hours the market is paying for. Windows are returned in
+     * chronological order; an empty array means no negative prices are known
+     * for the range.
+     *
+     * @param filter - Optional time range; same defaults as {@link getSpotPrices}.
+     * @returns Promise resolving to the negative-price windows in the range.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     *
+     * @example
+     * ```typescript
+     * const windows = await epex.getNegativePriceWindows();
+     * for (const w of windows) {
+     *     console.log(`negative from ${w.startIso} for ${w.durationMinutes} min`);
+     * }
+     * ```
+     */
+    getNegativePriceWindows(filter?: EnyoEpexSpotPriceFilter): Promise<EnyoEpexNegativePriceWindow[]>;
+    /**
+     * Registers a listener invoked whenever the host has refreshed the cached
+     * series — most importantly when the day-ahead auction for the next day
+     * clears, which is the moment a scheduler can plan a full 24 hours ahead.
+     *
+     * The listener receives the complete refreshed series, not just the
+     * changed entries.
+     *
+     * @param listener - Callback invoked with the newly cached price series.
+     * @returns A unique listener id for {@link offSpotPricesUpdated}.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     */
+    onSpotPricesUpdated(listener: (prices: EnyoEpexSpotPrices) => void | Promise<void>): string;
+    /**
+     * Removes a previously registered price-update listener. Unknown listener
+     * ids are ignored.
+     *
+     * @param listenerId - The id returned from {@link onSpotPricesUpdated}.
+     */
+    offSpotPricesUpdated(listenerId: string): void;
+}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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.EnyoHeatingRodStateEnum = 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.
@@ -100,6 +100,22 @@ var EnyoInverterStateEnum;
     EnyoInverterStateEnum["Fault"] = "fault";
     EnyoInverterStateEnum["Standby"] = "standby";
 })(EnyoInverterStateEnum || (exports.EnyoInverterStateEnum = EnyoInverterStateEnum = {}));
+/**
+ * Operating state of a heating rod as reported on the data bus via
+ * {@link EnyoDataBusHeatingRodValuesV1}.
+ *
+ * This is the *observed* state of the element, not the configured mode: the
+ * appliance metadata's {@link EnyoHeatingRodApplianceModeEnum} describes how the
+ * heating rod is set up, while this enum says whether it is drawing power right
+ * now.
+ */
+var EnyoHeatingRodStateEnum;
+(function (EnyoHeatingRodStateEnum) {
+    /** The heating element is not energized and consumes (close to) no power */
+    EnyoHeatingRodStateEnum["Idle"] = "idle";
+    /** The heating element is energized and heating */
+    EnyoHeatingRodStateEnum["Running"] = "running";
+})(EnyoHeatingRodStateEnum || (exports.EnyoHeatingRodStateEnum = EnyoHeatingRodStateEnum = {}));
 var EnyoStringStateEnum;
 (function (EnyoStringStateEnum) {
     EnyoStringStateEnum["Off"] = "off";
@@ -180,6 +196,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["ApplianceFlexibilityAnnouncementV1"] = "ApplianceFlexibilityAnnouncementV1";
     EnyoDataBusMessageEnum["ApplianceStateUpdateV1"] = "ApplianceStateUpdateV1";
     EnyoDataBusMessageEnum["HeatpumpValuesUpdateV1"] = "HeatpumpValuesUpdateV1";
+    EnyoDataBusMessageEnum["HeatingRodValuesUpdateV1"] = "HeatingRodValuesUpdateV1";
     EnyoDataBusMessageEnum["ChargingStartedV1"] = "ChargingStartedV1";
     EnyoDataBusMessageEnum["ChargingMeterValuesUpdateV1"] = "ChargingMeterValuesUpdateV1";
     EnyoDataBusMessageEnum["ChargingStoppedV1"] = "ChargingStoppedV1";

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

@@ -153,6 +153,21 @@ export declare enum EnyoInverterStateEnum {
     Fault = "fault",
     Standby = "standby"
 }
+/**
+ * Operating state of a heating rod as reported on the data bus via
+ * {@link EnyoDataBusHeatingRodValuesV1}.
+ *
+ * This is the *observed* state of the element, not the configured mode: the
+ * appliance metadata's {@link EnyoHeatingRodApplianceModeEnum} describes how the
+ * heating rod is set up, while this enum says whether it is drawing power right
+ * now.
+ */
+export declare enum EnyoHeatingRodStateEnum {
+    /** The heating element is not energized and consumes (close to) no power */
+    Idle = "idle",
+    /** The heating element is energized and heating */
+    Running = "running"
+}
 export declare enum EnyoStringStateEnum {
     Off = "off",
     Sleeping = "sleeping",
@@ -235,6 +250,7 @@ export declare enum EnyoDataBusMessageEnum {
     ApplianceFlexibilityAnnouncementV1 = "ApplianceFlexibilityAnnouncementV1",
     ApplianceStateUpdateV1 = "ApplianceStateUpdateV1",
     HeatpumpValuesUpdateV1 = "HeatpumpValuesUpdateV1",
+    HeatingRodValuesUpdateV1 = "HeatingRodValuesUpdateV1",
     ChargingStartedV1 = "ChargingStartedV1",
     ChargingMeterValuesUpdateV1 = "ChargingMeterValuesUpdateV1",
     ChargingStoppedV1 = "ChargingStoppedV1",
@@ -418,6 +434,34 @@ export interface EnyoDataBusHeatpumpValuesV1 extends EnyoDataBusMessage {
         gridOperatorLimit?: EnyoGridOperatorLimit;
     };
 }
+/**
+ * Live values of a heating rod (immersion / electric resistive heating
+ * element), published by the integration that owns the appliance.
+ *
+ * Send this whenever the power draw or the operating state changes, so an
+ * energy manager can account for the load and decide how much power to
+ * announce back via {@link EnyoDataBusSetHeatingRodAvailablePowerV2}.
+ */
+export interface EnyoDataBusHeatingRodValuesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HeatingRodValuesUpdateV1;
+    /** ID of the appliance that delivered these values */
+    applianceId: string;
+    data: {
+        /**
+         * Current electrical power consumption of the heating rod in Watt.
+         * Always positive (a heating rod only consumes). Omit when the
+         * integration cannot measure it — do not send `0` as a stand-in for
+         * "unknown", since a consumer cannot tell that apart from "off".
+         */
+        powerW?: number;
+        /**
+         * Current operating state of the heating element. Omit when the
+         * integration cannot determine it.
+         */
+        state?: EnyoHeatingRodStateEnum;
+    };
+}
 export interface EnyoDataBusBatteryValuesUpdateV1 extends EnyoDataBusMessage {
     type: 'message';
     message: EnyoDataBusMessageEnum.BatteryValuesUpdateV1;

package/dist/cjs/types/enyo-epex-spot-price.cjs

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

package/dist/cjs/types/enyo-epex-spot-price.d.cts

@@ -0,0 +1,77 @@
+import { EnyoCurrencyEnum } from "./enyo-currency.cjs";
+import { ForecastResolutionEnum } from "./enyo-forecasting.cjs";
+/**
+ * A single cleared market price for one delivery period.
+ *
+ * Prices are the raw exchange result: they exclude grid fees, levies, taxes
+ * and any supplier margin, and they **can be negative** when generation
+ * exceeds demand.
+ */
+export interface EnyoEpexSpotPriceEntry {
+    /** Start of the delivery period in ISO format (inclusive) */
+    timestampIso: string;
+    /** End of the delivery period in ISO format (exclusive) */
+    endTimestampIso: string;
+    /**
+     * Cleared price per megawatt hour, in the series' currency. This is the
+     * unit the exchange publishes (e.g. `-14.2` for EUR -14.20/MWh).
+     */
+    pricePerMwh: number;
+    /**
+     * The same price expressed per kilowatt hour (`pricePerMwh / 1000`), for
+     * consistency with the rest of the SDK, which prices energy per kWh.
+     */
+    pricePerKwh: number;
+}
+/**
+ * A contiguous run of delivery periods whose spot price is below zero.
+ *
+ * Convenience shape for the common decision "should PV feed-in be curtailed /
+ * should a flexible load be pulled forward?" — see
+ * {@link EnyoInverterApplianceMetadata.blockFeedInOnNegativePrices}.
+ */
+export interface EnyoEpexNegativePriceWindow {
+    /** Start of the window in ISO format (inclusive) */
+    startIso: string;
+    /** End of the window in ISO format (exclusive) */
+    endIso: string;
+    /** Length of the window in minutes */
+    durationMinutes: number;
+    /** Most negative price per kWh observed inside the window */
+    minPricePerKwh: number;
+    /** Arithmetic mean price per kWh across the window's delivery periods */
+    averagePricePerKwh: number;
+}
+/**
+ * The EPEX SPOT day-ahead price series that applies to this device.
+ */
+export interface EnyoEpexSpotPrices {
+    /** Currency of every price in {@link entries} */
+    currency: EnyoCurrencyEnum;
+    /**
+     * Length of one delivery period. EPEX SPOT day-ahead moved to 15-minute
+     * periods in 2025, but older data is still hourly — read this instead of
+     * assuming a resolution.
+     */
+    resolution: ForecastResolutionEnum;
+    /**
+     * When the host last fetched this series from the exchange, in ISO format.
+     * Useful to detect stale data when the device was offline.
+     */
+    retrievedAtIso: string;
+    /** Price entries sorted ascending by `timestampIso`, without gaps */
+    entries: EnyoEpexSpotPriceEntry[];
+}
+/**
+ * Restricts a price query to a time range.
+ *
+ * Both fields are optional: with an empty filter the host returns the full
+ * currently known window — typically today plus tomorrow, once the day-ahead
+ * auction has cleared.
+ */
+export interface EnyoEpexSpotPriceFilter {
+    /** Start of the requested range in ISO format (inclusive). Defaults to the start of the current delivery period. */
+    fromIso?: string;
+    /** End of the requested range in ISO format (exclusive). Defaults to the end of the known series. */
+    untilIso?: string;
+}

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

@@ -27,4 +27,19 @@ export interface EnyoInverterApplianceMetadata {
     yearBuilt?: number;
     /** Groups of PV modules attached to this inverter, each with its own orientation */
     moduleGroups?: EnyoInverterModuleGroup[];
+    /**
+     * Whether grid feed-in of this inverter should be blocked while the
+     * electricity price is negative.
+     *
+     * This is a user/installer configuration flag, not a live state: it
+     * expresses the intent that during negative market prices (see
+     * {@link EnergyAppEpexSpotPrice}) the inverter's export to the grid should
+     * be curtailed to 0 W, because feeding in costs money instead of earning
+     * it. Whoever controls the inverter — typically the energy manager sending
+     * `SetInverterFeedInLimitV1` — is responsible for honoring the flag and for
+     * lifting the curtailment once prices turn positive again.
+     *
+     * `undefined` means "not configured" and should be treated as `false`.
+     */
+    blockFeedInOnNegativePrices?: boolean;
 }

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

package/dist/energy-app-permission.type.d.ts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'AllNetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'DynamicPriceForecastRegister' | 'DynamicPriceForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'BatteryStorageState' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess' | 'Udp' | 'ProvidedFiles' | 'Automation' | 'Savings' | 'FirmwareRegistry';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'AllNetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'DynamicPriceForecastRegister' | 'DynamicPriceForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'BatteryStorageState' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess' | 'Udp' | 'ProvidedFiles' | 'Automation' | 'Savings' | 'EpexSpotPrices' | 'FirmwareRegistry';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -48,5 +48,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     ProvidedFiles = "ProvidedFiles",
     Automation = "Automation",
     Savings = "Savings",
+    EpexSpotPrices = "EpexSpotPrices",
     FirmwareRegistry = "FirmwareRegistry"
 }

package/dist/energy-app-permission.type.js

@@ -48,5 +48,6 @@ export var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["ProvidedFiles"] = "ProvidedFiles";
     EnergyAppPermissionTypeEnum["Automation"] = "Automation";
     EnergyAppPermissionTypeEnum["Savings"] = "Savings";
+    EnergyAppPermissionTypeEnum["EpexSpotPrices"] = "EpexSpotPrices";
     EnergyAppPermissionTypeEnum["FirmwareRegistry"] = "FirmwareRegistry";
 })(EnergyAppPermissionTypeEnum || (EnergyAppPermissionTypeEnum = {}));

package/dist/energy-app.d.ts

@@ -42,6 +42,7 @@ import { EnergyAppFirmwareRegistry } from "./packages/energy-app-firmware-regist
 import { EnergyAppAutomation } from "./packages/energy-app-automation.js";
 import { EnergyAppSavings } from "./packages/energy-app-savings.js";
 import { EnergyAppDeviceTest } from "./packages/energy-app-device-test.js";
+import { EnergyAppEpexSpotPrice } from "./packages/energy-app-epex-spot-price.js";
 import { UseFetchOptions } from "./types/enyo-fetch.js";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
@@ -323,6 +324,20 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Device Test API instance
      */
     useDeviceTest(): EnergyAppDeviceTest;
+    /**
+     * Gets the EPEX SPOT Price API for reading the cleared day-ahead
+     * wholesale electricity prices that apply to this device.
+     *
+     * These are raw market prices — excluding grid fees, levies, taxes and
+     * supplier margin, and negative when supply outruns demand — intended for
+     * energy-manager decisions such as when to charge, when to run a flexible
+     * load, and when to curtail PV feed-in. For customer-billed pricing use
+     * {@link useElectricityPrices} instead.
+     * @returns The EPEX SPOT Price API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *         permission is not granted.
+     */
+    useEpexSpotPrices(): EnergyAppEpexSpotPrice;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/energy-app.js

@@ -394,6 +394,22 @@ export class EnergyApp {
     useDeviceTest() {
         return this.energyAppSdk.useDeviceTest();
     }
+    /**
+     * Gets the EPEX SPOT Price API for reading the cleared day-ahead
+     * wholesale electricity prices that apply to this device.
+     *
+     * These are raw market prices — excluding grid fees, levies, taxes and
+     * supplier margin, and negative when supply outruns demand — intended for
+     * energy-manager decisions such as when to charge, when to run a flexible
+     * load, and when to curtail PV feed-in. For customer-billed pricing use
+     * {@link useElectricityPrices} instead.
+     * @returns The EPEX SPOT Price API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *         permission is not granted.
+     */
+    useEpexSpotPrices() {
+        return this.energyAppSdk.useEpexSpotPrices();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/enyo-energy-app-sdk.d.ts

@@ -41,6 +41,7 @@ import { EnergyAppFirmwareRegistry } from "./packages/energy-app-firmware-regist
 import { EnergyAppAutomation } from "./packages/energy-app-automation.js";
 import { EnergyAppSavings } from "./packages/energy-app-savings.js";
 import { EnergyAppDeviceTest } from "./packages/energy-app-device-test.js";
+import { EnergyAppEpexSpotPrice } from "./packages/energy-app-epex-spot-price.js";
 import { UseFetchOptions } from "./types/enyo-fetch.js";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
@@ -154,4 +155,6 @@ export interface EnyoEnergyAppSdk {
     useSavings: () => EnergyAppSavings;
     /** Get the Device Test API for answering the host's requests to test detected network devices and report whether appliances were found or created */
     useDeviceTest: () => EnergyAppDeviceTest;
+    /** Get the EPEX SPOT Price API for reading the cleared day-ahead wholesale electricity prices that apply to this device */
+    useEpexSpotPrices: () => EnergyAppEpexSpotPrice;
 }

package/dist/index.d.ts

@@ -112,6 +112,8 @@ export * from './packages/energy-app-device-test.js';
 export * from './implementations/device-test/device-test-validators.js';
 export * from './types/enyo-savings.js';
 export * from './packages/energy-app-savings.js';
+export * from './types/enyo-epex-spot-price.js';
+export * from './packages/energy-app-epex-spot-price.js';
 export * from './types/enyo-automation.js';
 export * from './packages/energy-app-automation.js';
 export * from './implementations/automation/automation-validators.js';

package/dist/index.js

@@ -112,6 +112,8 @@ export * from './packages/energy-app-device-test.js';
 export * from './implementations/device-test/device-test-validators.js';
 export * from './types/enyo-savings.js';
 export * from './packages/energy-app-savings.js';
+export * from './types/enyo-epex-spot-price.js';
+export * from './packages/energy-app-epex-spot-price.js';
 export * from './types/enyo-automation.js';
 export * from './packages/energy-app-automation.js';
 export * from './implementations/automation/automation-validators.js';

package/dist/packages/energy-app-epex-spot-price.d.ts

@@ -0,0 +1,123 @@
+import { EnyoEpexNegativePriceWindow, EnyoEpexSpotPriceEntry, EnyoEpexSpotPriceFilter, EnyoEpexSpotPrices } from "../types/enyo-epex-spot-price.js";
+/**
+ * Interface for reading EPEX SPOT day-ahead electricity prices.
+ *
+ * The host fetches the cleared prices that apply to this device and caches
+ * them locally, so every app on the device shares one source of truth instead
+ * of each one calling a price API itself. An energy manager can use the series
+ * to decide when to charge a battery, when to run a flexible load, and — via
+ * {@link EnyoInverterApplianceMetadata.blockFeedInOnNegativePrices} — when to
+ * stop exporting PV to the grid.
+ *
+ * What this API returns is **market data, not customer pricing**: the raw
+ * exchange result, excluding grid fees, levies, taxes and supplier margin, and
+ * negative whenever supply outruns demand. For what the customer is actually
+ * billed, use {@link EnergyAppEnergyPrices}; for forward-looking price
+ * forecasts published by other apps, use
+ * {@link EnergyAppDynamicPriceForecast}.
+ *
+ * Prices for the following day become known once the auction clears (14:00
+ * CET/CEST) — before that, only the current day is available, so an app must
+ * always tolerate a series that ends earlier than it would like.
+ *
+ * Access to this API requires the `EpexSpotPrices` permission
+ * ({@link EnergyAppPermissionType}); {@link EnergyApp.useEpexSpotPrices} throws
+ * when it has not been granted.
+ *
+ * @example
+ * ```typescript
+ * const epex = energyApp.useEpexSpotPrices();
+ *
+ * const now = await epex.getCurrentSpotPrice();
+ * if (now && now.pricePerKwh < 0) {
+ *     // exporting costs money right now
+ * }
+ *
+ * // Re-plan whenever tomorrow's auction result arrives.
+ * epex.onSpotPricesUpdated(prices => scheduler.replan(prices.entries));
+ * ```
+ */
+export interface EnergyAppEpexSpotPrice {
+    /**
+     * Retrieves the cached EPEX SPOT price series for a time range.
+     *
+     * Returns `null` when the host holds no prices at all (for example on a
+     * device that has never been online). A series that is merely shorter than
+     * the requested range is returned as-is with the entries that are known —
+     * check the last entry's `endTimestampIso` before planning against it.
+     *
+     * @param filter - Optional time range. Defaults to the current delivery
+     *   period through the end of the known series.
+     * @returns Promise resolving to the price series, or `null` if none is available.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     *
+     * @example
+     * ```typescript
+     * const prices = await epex.getSpotPrices({
+     *     fromIso: '2026-08-12T00:00:00Z',
+     *     untilIso: '2026-08-13T00:00:00Z'
+     * });
+     * const cheapest = prices?.entries
+     *     .reduce((min, e) => e.pricePerKwh < min.pricePerKwh ? e : min);
+     * ```
+     */
+    getSpotPrices(filter?: EnyoEpexSpotPriceFilter): Promise<EnyoEpexSpotPrices | null>;
+    /**
+     * Retrieves the price of the delivery period that contains "now".
+     *
+     * Convenience wrapper around {@link getSpotPrices} for control loops that
+     * only need the price they are currently exposed to.
+     *
+     * @returns Promise resolving to the current entry, or `null` when the
+     *   current period is not covered by the cached series.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     */
+    getCurrentSpotPrice(): Promise<EnyoEpexSpotPriceEntry | null>;
+    /**
+     * Retrieves the contiguous runs of delivery periods priced below zero
+     * within the requested range.
+     *
+     * This is the same information as {@link getSpotPrices}, pre-grouped for
+     * the decisions that care about it: curtailing PV feed-in, and pulling
+     * consumption into hours the market is paying for. Windows are returned in
+     * chronological order; an empty array means no negative prices are known
+     * for the range.
+     *
+     * @param filter - Optional time range; same defaults as {@link getSpotPrices}.
+     * @returns Promise resolving to the negative-price windows in the range.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     *
+     * @example
+     * ```typescript
+     * const windows = await epex.getNegativePriceWindows();
+     * for (const w of windows) {
+     *     console.log(`negative from ${w.startIso} for ${w.durationMinutes} min`);
+     * }
+     * ```
+     */
+    getNegativePriceWindows(filter?: EnyoEpexSpotPriceFilter): Promise<EnyoEpexNegativePriceWindow[]>;
+    /**
+     * Registers a listener invoked whenever the host has refreshed the cached
+     * series — most importantly when the day-ahead auction for the next day
+     * clears, which is the moment a scheduler can plan a full 24 hours ahead.
+     *
+     * The listener receives the complete refreshed series, not just the
+     * changed entries.
+     *
+     * @param listener - Callback invoked with the newly cached price series.
+     * @returns A unique listener id for {@link offSpotPricesUpdated}.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `EpexSpotPrices`
+     *   permission is not granted.
+     */
+    onSpotPricesUpdated(listener: (prices: EnyoEpexSpotPrices) => void | Promise<void>): string;
+    /**
+     * Removes a previously registered price-update listener. Unknown listener
+     * ids are ignored.
+     *
+     * @param listenerId - The id returned from {@link onSpotPricesUpdated}.
+     */
+    offSpotPricesUpdated(listenerId: string): void;
+}

package/dist/packages/energy-app-epex-spot-price.js

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

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

@@ -153,6 +153,21 @@ export declare enum EnyoInverterStateEnum {
     Fault = "fault",
     Standby = "standby"
 }
+/**
+ * Operating state of a heating rod as reported on the data bus via
+ * {@link EnyoDataBusHeatingRodValuesV1}.
+ *
+ * This is the *observed* state of the element, not the configured mode: the
+ * appliance metadata's {@link EnyoHeatingRodApplianceModeEnum} describes how the
+ * heating rod is set up, while this enum says whether it is drawing power right
+ * now.
+ */
+export declare enum EnyoHeatingRodStateEnum {
+    /** The heating element is not energized and consumes (close to) no power */
+    Idle = "idle",
+    /** The heating element is energized and heating */
+    Running = "running"
+}
 export declare enum EnyoStringStateEnum {
     Off = "off",
     Sleeping = "sleeping",
@@ -235,6 +250,7 @@ export declare enum EnyoDataBusMessageEnum {
     ApplianceFlexibilityAnnouncementV1 = "ApplianceFlexibilityAnnouncementV1",
     ApplianceStateUpdateV1 = "ApplianceStateUpdateV1",
     HeatpumpValuesUpdateV1 = "HeatpumpValuesUpdateV1",
+    HeatingRodValuesUpdateV1 = "HeatingRodValuesUpdateV1",
     ChargingStartedV1 = "ChargingStartedV1",
     ChargingMeterValuesUpdateV1 = "ChargingMeterValuesUpdateV1",
     ChargingStoppedV1 = "ChargingStoppedV1",
@@ -418,6 +434,34 @@ export interface EnyoDataBusHeatpumpValuesV1 extends EnyoDataBusMessage {
         gridOperatorLimit?: EnyoGridOperatorLimit;
     };
 }
+/**
+ * Live values of a heating rod (immersion / electric resistive heating
+ * element), published by the integration that owns the appliance.
+ *
+ * Send this whenever the power draw or the operating state changes, so an
+ * energy manager can account for the load and decide how much power to
+ * announce back via {@link EnyoDataBusSetHeatingRodAvailablePowerV2}.
+ */
+export interface EnyoDataBusHeatingRodValuesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HeatingRodValuesUpdateV1;
+    /** ID of the appliance that delivered these values */
+    applianceId: string;
+    data: {
+        /**
+         * Current electrical power consumption of the heating rod in Watt.
+         * Always positive (a heating rod only consumes). Omit when the
+         * integration cannot measure it — do not send `0` as a stand-in for
+         * "unknown", since a consumer cannot tell that apart from "off".
+         */
+        powerW?: number;
+        /**
+         * Current operating state of the heating element. Omit when the
+         * integration cannot determine it.
+         */
+        state?: EnyoHeatingRodStateEnum;
+    };
+}
 export interface EnyoDataBusBatteryValuesUpdateV1 extends EnyoDataBusMessage {
     type: 'message';
     message: EnyoDataBusMessageEnum.BatteryValuesUpdateV1;

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

@@ -97,6 +97,22 @@ export var EnyoInverterStateEnum;
     EnyoInverterStateEnum["Fault"] = "fault";
     EnyoInverterStateEnum["Standby"] = "standby";
 })(EnyoInverterStateEnum || (EnyoInverterStateEnum = {}));
+/**
+ * Operating state of a heating rod as reported on the data bus via
+ * {@link EnyoDataBusHeatingRodValuesV1}.
+ *
+ * This is the *observed* state of the element, not the configured mode: the
+ * appliance metadata's {@link EnyoHeatingRodApplianceModeEnum} describes how the
+ * heating rod is set up, while this enum says whether it is drawing power right
+ * now.
+ */
+export var EnyoHeatingRodStateEnum;
+(function (EnyoHeatingRodStateEnum) {
+    /** The heating element is not energized and consumes (close to) no power */
+    EnyoHeatingRodStateEnum["Idle"] = "idle";
+    /** The heating element is energized and heating */
+    EnyoHeatingRodStateEnum["Running"] = "running";
+})(EnyoHeatingRodStateEnum || (EnyoHeatingRodStateEnum = {}));
 export var EnyoStringStateEnum;
 (function (EnyoStringStateEnum) {
     EnyoStringStateEnum["Off"] = "off";
@@ -177,6 +193,7 @@ export var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["ApplianceFlexibilityAnnouncementV1"] = "ApplianceFlexibilityAnnouncementV1";
     EnyoDataBusMessageEnum["ApplianceStateUpdateV1"] = "ApplianceStateUpdateV1";
     EnyoDataBusMessageEnum["HeatpumpValuesUpdateV1"] = "HeatpumpValuesUpdateV1";
+    EnyoDataBusMessageEnum["HeatingRodValuesUpdateV1"] = "HeatingRodValuesUpdateV1";
     EnyoDataBusMessageEnum["ChargingStartedV1"] = "ChargingStartedV1";
     EnyoDataBusMessageEnum["ChargingMeterValuesUpdateV1"] = "ChargingMeterValuesUpdateV1";
     EnyoDataBusMessageEnum["ChargingStoppedV1"] = "ChargingStoppedV1";

package/dist/types/enyo-epex-spot-price.d.ts

@@ -0,0 +1,77 @@
+import { EnyoCurrencyEnum } from "./enyo-currency.js";
+import { ForecastResolutionEnum } from "./enyo-forecasting.js";
+/**
+ * A single cleared market price for one delivery period.
+ *
+ * Prices are the raw exchange result: they exclude grid fees, levies, taxes
+ * and any supplier margin, and they **can be negative** when generation
+ * exceeds demand.
+ */
+export interface EnyoEpexSpotPriceEntry {
+    /** Start of the delivery period in ISO format (inclusive) */
+    timestampIso: string;
+    /** End of the delivery period in ISO format (exclusive) */
+    endTimestampIso: string;
+    /**
+     * Cleared price per megawatt hour, in the series' currency. This is the
+     * unit the exchange publishes (e.g. `-14.2` for EUR -14.20/MWh).
+     */
+    pricePerMwh: number;
+    /**
+     * The same price expressed per kilowatt hour (`pricePerMwh / 1000`), for
+     * consistency with the rest of the SDK, which prices energy per kWh.
+     */
+    pricePerKwh: number;
+}
+/**
+ * A contiguous run of delivery periods whose spot price is below zero.
+ *
+ * Convenience shape for the common decision "should PV feed-in be curtailed /
+ * should a flexible load be pulled forward?" — see
+ * {@link EnyoInverterApplianceMetadata.blockFeedInOnNegativePrices}.
+ */
+export interface EnyoEpexNegativePriceWindow {
+    /** Start of the window in ISO format (inclusive) */
+    startIso: string;
+    /** End of the window in ISO format (exclusive) */
+    endIso: string;
+    /** Length of the window in minutes */
+    durationMinutes: number;
+    /** Most negative price per kWh observed inside the window */
+    minPricePerKwh: number;
+    /** Arithmetic mean price per kWh across the window's delivery periods */
+    averagePricePerKwh: number;
+}
+/**
+ * The EPEX SPOT day-ahead price series that applies to this device.
+ */
+export interface EnyoEpexSpotPrices {
+    /** Currency of every price in {@link entries} */
+    currency: EnyoCurrencyEnum;
+    /**
+     * Length of one delivery period. EPEX SPOT day-ahead moved to 15-minute
+     * periods in 2025, but older data is still hourly — read this instead of
+     * assuming a resolution.
+     */
+    resolution: ForecastResolutionEnum;
+    /**
+     * When the host last fetched this series from the exchange, in ISO format.
+     * Useful to detect stale data when the device was offline.
+     */
+    retrievedAtIso: string;
+    /** Price entries sorted ascending by `timestampIso`, without gaps */
+    entries: EnyoEpexSpotPriceEntry[];
+}
+/**
+ * Restricts a price query to a time range.
+ *
+ * Both fields are optional: with an empty filter the host returns the full
+ * currently known window — typically today plus tomorrow, once the day-ahead
+ * auction has cleared.
+ */
+export interface EnyoEpexSpotPriceFilter {
+    /** Start of the requested range in ISO format (inclusive). Defaults to the start of the current delivery period. */
+    fromIso?: string;
+    /** End of the requested range in ISO format (exclusive). Defaults to the end of the known series. */
+    untilIso?: string;
+}

package/dist/types/enyo-epex-spot-price.js

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

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

@@ -27,4 +27,19 @@ export interface EnyoInverterApplianceMetadata {
     yearBuilt?: number;
     /** Groups of PV modules attached to this inverter, each with its own orientation */
     moduleGroups?: EnyoInverterModuleGroup[];
+    /**
+     * Whether grid feed-in of this inverter should be blocked while the
+     * electricity price is negative.
+     *
+     * This is a user/installer configuration flag, not a live state: it
+     * expresses the intent that during negative market prices (see
+     * {@link EnergyAppEpexSpotPrice}) the inverter's export to the grid should
+     * be curtailed to 0 W, because feeding in costs money instead of earning
+     * it. Whoever controls the inverter — typically the energy manager sending
+     * `SetInverterFeedInLimitV1` — is responsible for honoring the flag and for
+     * lifting the curtailment once prices turn positive again.
+     *
+     * `undefined` means "not configured" and should be treated as `false`.
+     */
+    blockFeedInOnNegativePrices?: boolean;
 }

package/dist/version.d.ts

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