@enyo-energy/energy-app-sdk 0.0.166 → 0.0.168

package/dist/cjs/energy-app-appliance-type.enum.cjs

@@ -20,4 +20,5 @@ var EnergyAppApplianceTypeEnum;
     EnergyAppApplianceTypeEnum["Oven"] = "oven";
     EnergyAppApplianceTypeEnum["Freezer"] = "freezer";
     EnergyAppApplianceTypeEnum["AirConditioning"] = "air-conditioning";
+    EnergyAppApplianceTypeEnum["HeatingRod"] = "heating-rod";
 })(EnergyAppApplianceTypeEnum || (exports.EnergyAppApplianceTypeEnum = EnergyAppApplianceTypeEnum = {}));

package/dist/cjs/energy-app-appliance-type.enum.d.cts

@@ -15,5 +15,6 @@ export declare enum EnergyAppApplianceTypeEnum {
     Dryer = "dryer",
     Oven = "oven",
     Freezer = "freezer",
-    AirConditioning = "air-conditioning"
+    AirConditioning = "air-conditioning",
+    HeatingRod = "heating-rod"
 }

package/dist/cjs/energy-app-package-definition.cjs

@@ -17,6 +17,7 @@ var EnergyAppPackageCategory;
     EnergyAppPackageCategory["StaticElectricityTariff"] = "static-electricity-tariff";
     EnergyAppPackageCategory["TemperatureSensor"] = "temperature-sensor";
     EnergyAppPackageCategory["SmartPlug"] = "smart-plug";
+    EnergyAppPackageCategory["HeatingRod"] = "heating-rod";
     EnergyAppPackageCategory["Other"] = "other";
 })(EnergyAppPackageCategory || (exports.EnergyAppPackageCategory = EnergyAppPackageCategory = {}));
 /**

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

@@ -14,6 +14,7 @@ export declare enum EnergyAppPackageCategory {
     StaticElectricityTariff = "static-electricity-tariff",
     TemperatureSensor = "temperature-sensor",
     SmartPlug = "smart-plug",
+    HeatingRod = "heating-rod",
     Other = "other"
 }
 /**

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

@@ -48,4 +48,5 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["Wifi"] = "Wifi";
     EnergyAppPermissionTypeEnum["ChildProcess"] = "ChildProcess";
     EnergyAppPermissionTypeEnum["Udp"] = "Udp";
+    EnergyAppPermissionTypeEnum["ProvidedFiles"] = "ProvidedFiles";
 })(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';
+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';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -44,5 +44,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     Bluetooth = "Bluetooth",
     Wifi = "Wifi",
     ChildProcess = "ChildProcess",
-    Udp = "Udp"
+    Udp = "Udp",
+    ProvidedFiles = "ProvidedFiles"
 }

package/dist/cjs/energy-app.cjs

@@ -323,6 +323,19 @@ class EnergyApp {
     useBatteries() {
         return this.energyAppSdk.useBatteries();
     }
+    /**
+     * Gets the File API for providing user-facing files.
+     * Files are registered with a translated display name and optional
+     * translated explanation; their content (base64 + MIME type + concrete
+     * file name) is produced on demand by the registered handler when the user
+     * chooses to store the file.
+     * @returns The File API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `ProvidedFiles`
+     *         permission is not granted.
+     */
+    useFiles() {
+        return this.energyAppSdk.useFiles();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -37,6 +37,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.cjs";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.cjs";
 import { EnergyAppBattery } from "./packages/energy-app-battery.cjs";
+import { EnergyAppFile } from "./packages/energy-app-file.cjs";
 import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
@@ -256,6 +257,17 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Battery API instance
      */
     useBatteries(): EnergyAppBattery;
+    /**
+     * Gets the File API for providing user-facing files.
+     * Files are registered with a translated display name and optional
+     * translated explanation; their content (base64 + MIME type + concrete
+     * file name) is produced on demand by the registered handler when the user
+     * chooses to store the file.
+     * @returns The File API instance
+     * @throws {EnergyAppPermissionNotGrantedError} If the `ProvidedFiles`
+     *         permission is not granted.
+     */
+    useFiles(): EnergyAppFile;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -36,6 +36,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.cjs";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.cjs";
 import { EnergyAppBattery } from "./packages/energy-app-battery.cjs";
+import { EnergyAppFile } from "./packages/energy-app-file.cjs";
 import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
@@ -137,4 +138,6 @@ export interface EnyoEnergyAppSdk {
     useApplianceEnergyManagerForecast: () => EnergyAppApplianceEnergyManagerForecast;
     /** Get the Battery API for retrieving the current runtime state of each battery storage (SoC, stored kWh, average price per kWh, optional solar share) */
     useBatteries: () => EnergyAppBattery;
+    /** Get the File API for providing user-facing files whose translated names/explanations are shown by the host and whose content is produced on demand when the user stores them */
+    useFiles: () => EnergyAppFile;
 }

package/dist/cjs/implementations/appliances/appliance-manager.cjs

@@ -59,6 +59,7 @@ const MERGEABLE_METADATA_KEYS = [
     'meter',
     'temperatureSensor',
     'airConditioning',
+    'heatingRod',
 ];
 /**
  * Manages appliances in the energy system with configurable identification strategies.
@@ -207,6 +208,7 @@ class ApplianceManager {
             inverter: appliance.inverter,
             temperatureSensor: appliance.temperatureSensor,
             airConditioning: appliance.airConditioning,
+            heatingRod: appliance.heatingRod,
             // Conditionally spread the two optional top-level fields that are NOT
             // covered by MERGEABLE_METADATA_KEYS. If they were always materialized
             // as explicit keys, an omitted (undefined) value would clobber the

package/dist/cjs/implementations/appliances/appliance-manager.d.cts

@@ -8,6 +8,7 @@ import type { EnyoInverterApplianceMetadata } from "../../types/enyo-inverter-ap
 import type { EnyoMeterAppliance } from "../../types/enyo-meter-appliance.cjs";
 import type { EnyoTemperatureSensorApplianceMetadata } from "../../types/enyo-temperature-sensor-appliance.cjs";
 import type { EnyoAirConditioningApplianceMetadata } from "../../types/enyo-air-conditioning-appliance.cjs";
+import type { EnyoHeatingRodApplianceMetadata } from "../../types/enyo-heating-rod-appliance.cjs";
 import { IdentifierStrategy } from "./identifier-strategies.cjs";
 /**
  * Thrown when {@link ApplianceManager.createOrUpdateAppliance} is called with
@@ -59,6 +60,7 @@ export interface ApplianceConfig {
     battery?: EnyoBatteryApplianceMetadata;
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
     airConditioning?: EnyoAirConditioningApplianceMetadata;
+    heatingRod?: EnyoHeatingRodApplianceMetadata;
     availableFeatures?: EnyoApplianceAvailableFeaturesEnum[];
     /**
      * Optional identifier of the cloud-deployed energy app package that manages
@@ -140,7 +142,7 @@ export declare class ApplianceManager {
      * @param update The partial update data to merge
      * @returns The merged appliance data (without `id`)
      */
-    private mergeApplianceData;
+    protected mergeApplianceData(existing: EnyoAppliance, update: Partial<Omit<PartialEnyoAppliance, 'id'>>): Omit<EnyoAppliance, 'id'>;
     /**
      * Creates a new ApplianceManager instance.
      *
@@ -418,6 +420,8 @@ export interface PartialEnyoAppliance {
     temperatureSensor?: Partial<EnyoTemperatureSensorApplianceMetadata>;
     /** Optional Metadata of the Appliance if of type AirConditioning */
     airConditioning?: Partial<EnyoAirConditioningApplianceMetadata>;
+    /** Optional Metadata of the Appliance if of type HeatingRod */
+    heatingRod?: Partial<EnyoHeatingRodApplianceMetadata>;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
     /**

package/dist/cjs/implementations/appliances/in-memory-appliance-manager.cjs

@@ -52,10 +52,12 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
                 enyo_appliance_js_1.EnyoApplianceStateEnum.Connected,
             ...appliance.metadata
         };
-        // Build appliance data
-        const applianceId = existingAppliance?.id || (0, node_crypto_1.randomUUID)();
-        const applianceData = {
-            id: applianceId,
+        // Build the incoming appliance data covering every ApplianceConfig field.
+        // The two optional top-level fields that are NOT shallow-merged by
+        // mergeApplianceData (`cloudPackageId`, `availableFeatures`) are only
+        // materialized when provided so an omitted value cannot clobber the stored
+        // one during an update; pass an explicit value (e.g. `[]`) to clear them.
+        const newApplianceData = {
             name: appliance.name,
             type: appliance.type,
             networkDeviceIds,
@@ -66,7 +68,18 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
             battery: appliance.battery,
             charger: appliance.charger,
             inverter: appliance.inverter,
+            temperatureSensor: appliance.temperatureSensor,
+            airConditioning: appliance.airConditioning,
+            heatingRod: appliance.heatingRod,
+            ...(appliance.cloudPackageId !== undefined && { cloudPackageId: appliance.cloudPackageId }),
+            ...(appliance.availableFeatures !== undefined && { availableFeatures: appliance.availableFeatures }),
         };
+        // On update, merge onto the stored appliance so type-specific metadata and
+        // top-level fields that were not supplied in this call are preserved.
+        const applianceId = existingAppliance?.id || (0, node_crypto_1.randomUUID)();
+        const applianceData = existingAppliance
+            ? { ...this.mergeApplianceData(existingAppliance, newApplianceData), id: applianceId }
+            : { id: applianceId, ...newApplianceData };
         // Save to memory store
         this.memoryStore.set(applianceId, applianceData);
         // Store network devices if provided

package/dist/cjs/index.cjs

@@ -74,6 +74,7 @@ __exportStar(require("./packages/energy-app-grid-connection-point.cjs"), exports
 __exportStar(require("./types/enyo-configuration-manager.cjs"), exports);
 __exportStar(require("./packages/energy-app-configuration-manager.cjs"), exports);
 __exportStar(require("./types/enyo-air-conditioning-appliance.cjs"), exports);
+__exportStar(require("./types/enyo-heating-rod-appliance.cjs"), exports);
 __exportStar(require("./types/enyo-onboarding.cjs"), exports);
 __exportStar(require("./packages/energy-app-onboarding.cjs"), exports);
 __exportStar(require("./types/enyo-retry-manager.cjs"), exports);
@@ -103,3 +104,5 @@ __exportStar(require("./implementations/energy-manager-diagnostics/energy-manage
 __exportStar(require("./types/enyo-battery-state.cjs"), exports);
 __exportStar(require("./packages/energy-app-battery.cjs"), exports);
 __exportStar(require("./types/enyo-fetch.cjs"), exports);
+__exportStar(require("./types/enyo-file.cjs"), exports);
+__exportStar(require("./packages/energy-app-file.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -58,6 +58,7 @@ export * from './packages/energy-app-grid-connection-point.cjs';
 export * from './types/enyo-configuration-manager.cjs';
 export * from './packages/energy-app-configuration-manager.cjs';
 export * from './types/enyo-air-conditioning-appliance.cjs';
+export * from './types/enyo-heating-rod-appliance.cjs';
 export * from './types/enyo-onboarding.cjs';
 export * from './packages/energy-app-onboarding.cjs';
 export * from './types/enyo-retry-manager.cjs';
@@ -87,3 +88,5 @@ export * from './implementations/energy-manager-diagnostics/energy-manager-diagn
 export * from './types/enyo-battery-state.cjs';
 export * from './packages/energy-app-battery.cjs';
 export * from './types/enyo-fetch.cjs';
+export * from './types/enyo-file.cjs';
+export * from './packages/energy-app-file.cjs';

package/dist/cjs/packages/energy-app-file.cjs

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

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

@@ -0,0 +1,90 @@
+import { EnyoFileRegistration, EnyoFileContentHandler, EnyoFileInfo } from "../types/enyo-file.cjs";
+/**
+ * Interface for providing files to the user from within an Energy App package.
+ *
+ * A package registers files it can produce; the host renders each file's
+ * translated name (and optional explanation) in its UI. The file's bytes are
+ * NOT supplied at registration time — instead the package registers an
+ * {@link EnyoFileContentHandler} that the host invokes lazily when the user
+ * chooses to store/save the file. This allows large or expensive payloads
+ * (reports, CSV/PDF exports, diagnostic bundles) to be generated on demand.
+ *
+ * Registration uses upsert semantics keyed by `fileId`: re-registering the same
+ * `fileId` replaces both the translations and the content handler.
+ *
+ * Access to this API requires the `ProvidedFiles` permission
+ * ({@link EnergyAppPermissionType}); {@link EnergyApp.useFiles} throws when it
+ * has not been granted.
+ */
+export interface EnergyAppFile {
+    /**
+     * Registers a provided file with the host, or updates an existing one.
+     *
+     * Uses upsert logic based on `registration.fileId`: if a file with the same
+     * ID is already registered it is replaced (both its translations and its
+     * content handler); otherwise a new entry is created. The `handler` is
+     * stored by the host and invoked later — once per store action — when the
+     * user decides to save the file.
+     *
+     * @param registration - Descriptive metadata for the file: its `fileId`,
+     *   translated `name`, optional translated `explanation`, and optional
+     *   `applianceId` scoping.
+     * @param handler - Callback invoked lazily by the host when the user stores
+     *   the file; resolves to the file's base64 content, MIME type and concrete
+     *   file name.
+     * @returns Promise that resolves once the file has been registered with the
+     *   host.
+     * @throws {EnergyAppPermissionNotGrantedError} If the `ProvidedFiles`
+     *   permission is not granted.
+     *
+     * @example
+     * ```typescript
+     * await file.registerFile(
+     *     {
+     *         fileId: 'monthly-charging-report',
+     *         name: [
+     *             { language: 'en', value: 'Monthly charging report' },
+     *             { language: 'de', value: 'Monatlicher Ladebericht' }
+     *         ],
+     *         explanation: [
+     *             { language: 'en', value: 'A PDF summary of this month\'s charging sessions.' },
+     *             { language: 'de', value: 'Eine PDF-Zusammenfassung der Ladevorgänge dieses Monats.' }
+     *         ]
+     *     },
+     *     async () => ({
+     *         base64: await buildReportPdfBase64(),
+     *         mimeType: 'application/pdf',
+     *         fileName: 'charging-report-2026-07.pdf'
+     *     })
+     * );
+     * ```
+     */
+    registerFile(registration: EnyoFileRegistration, handler: EnyoFileContentHandler): Promise<void>;
+    /**
+     * Removes a previously registered provided file by its ID.
+     *
+     * After deregistration the host no longer shows the file and will not invoke
+     * its content handler. If no file with the given ID is registered this
+     * operation is a no-op.
+     *
+     * @param fileId - The identifier the file was registered under.
+     * @returns Promise that resolves once the file has been removed.
+     */
+    deregisterFile(fileId: string): Promise<void>;
+    /**
+     * Retrieves all files currently registered by this package.
+     *
+     * Returns descriptive metadata only (ids, translated names and
+     * explanations, optional appliance scoping); the file content is never
+     * included and is always produced on demand via the registered handler.
+     *
+     * @returns Promise resolving to an array of registered file descriptors.
+     *
+     * @example
+     * ```typescript
+     * const files = await file.listFiles();
+     * files.forEach(f => console.log(f.fileId));
+     * ```
+     */
+    listFiles(): Promise<EnyoFileInfo[]>;
+}

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

@@ -10,6 +10,7 @@ var EnyoApplianceTypeEnum;
     EnyoApplianceTypeEnum["Heatpump"] = "Heatpump";
     EnyoApplianceTypeEnum["AirConditioning"] = "AirConditioning";
     EnyoApplianceTypeEnum["TemperatureSensor"] = "TemperatureSensor";
+    EnyoApplianceTypeEnum["HeatingRod"] = "HeatingRod";
 })(EnyoApplianceTypeEnum || (exports.EnyoApplianceTypeEnum = EnyoApplianceTypeEnum = {}));
 var EnyoApplianceStateEnum;
 (function (EnyoApplianceStateEnum) {

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

@@ -6,6 +6,7 @@ import { EnyoInverterApplianceMetadata } from "./enyo-inverter-appliance.cjs";
 import { EnyoMeterAppliance } from "./enyo-meter-appliance.cjs";
 import { EnyoTemperatureSensorApplianceMetadata } from "./enyo-temperature-sensor-appliance.cjs";
 import { EnyoAirConditioningApplianceMetadata } from "./enyo-air-conditioning-appliance.cjs";
+import { EnyoHeatingRodApplianceMetadata } from "./enyo-heating-rod-appliance.cjs";
 export declare enum EnyoApplianceTypeEnum {
     Inverter = "Inverter",
     Charger = "Charger",
@@ -13,7 +14,8 @@ export declare enum EnyoApplianceTypeEnum {
     Meter = "Meter",
     Heatpump = "Heatpump",
     AirConditioning = "AirConditioning",
-    TemperatureSensor = "TemperatureSensor"
+    TemperatureSensor = "TemperatureSensor",
+    HeatingRod = "HeatingRod"
 }
 export interface EnyoApplianceName {
     language: EnergyAppPackageLanguage;
@@ -247,6 +249,8 @@ export interface EnyoAppliance {
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
     /** Optional Metadata of the Appliance if of type AirConditioning */
     airConditioning?: EnyoAirConditioningApplianceMetadata;
+    /** Optional Metadata of the Appliance if of type HeatingRod */
+    heatingRod?: EnyoHeatingRodApplianceMetadata;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
     /**

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

@@ -219,6 +219,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["ClearChargingProfilesV1"] = "ClearChargingProfilesV1";
     EnyoDataBusMessageEnum["HeatpumpOverheatingV1"] = "HeatpumpOverheatingV1";
     EnyoDataBusMessageEnum["HeatpumpAvailablePowerAnnouncementV1"] = "HeatpumpAvailablePowerAnnouncementV1";
+    EnyoDataBusMessageEnum["HeatingRodAvailablePowerAnnouncementV1"] = "HeatingRodAvailablePowerAnnouncementV1";
     EnyoDataBusMessageEnum["AirConditioningValuesUpdateV1"] = "AirConditioningValuesUpdateV1";
     EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
     EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";

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

@@ -251,6 +251,7 @@ export declare enum EnyoDataBusMessageEnum {
     ClearChargingProfilesV1 = "ClearChargingProfilesV1",
     HeatpumpOverheatingV1 = "HeatpumpOverheatingV1",
     HeatpumpAvailablePowerAnnouncementV1 = "HeatpumpAvailablePowerAnnouncementV1",
+    HeatingRodAvailablePowerAnnouncementV1 = "HeatingRodAvailablePowerAnnouncementV1",
     AirConditioningValuesUpdateV1 = "AirConditioningValuesUpdateV1",
     AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
     StartAirConditioningV1 = "StartAirConditioningV1",
@@ -341,6 +342,8 @@ export interface EnyoDataBusHeatpumpValuesV1 extends EnyoDataBusMessage {
             operationMode: EnyoHeatpumpApplianceModeEnum;
             /** current power consumption in W */
             powerW?: number;
+            /** Cumulative energy meter reading of the heatpump in Wh (meter value)*/
+            meterValueWh?: number;
             /** Power consumption for heating in Wh (meter value)*/
             powerConsumptionHeatingWh?: number;
             /** Power consumption for domestic hot water in Wh (meter value)*/
@@ -1594,6 +1597,22 @@ export interface EnyoDataBusHeatpumpAvailablePowerAnnouncementV1 extends EnyoDat
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Data bus message announcing available power for a heating rod appliance.
+ * Used to inform the heating rod about how much power is available for consumption.
+ */
+export interface EnyoDataBusHeatingRodAvailablePowerAnnouncementV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.HeatingRodAvailablePowerAnnouncementV1;
+    /** ID of the heating rod appliance */
+    applianceId: string;
+    data: {
+        /** Available power for the heating rod to use (in Watt) */
+        powerW: number;
+        /** Optional reason why this announcement was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
 /**
  * Data bus message for reporting air conditioning power values.
  * Contains the current operating mode and power consumption.

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

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

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

@@ -0,0 +1,108 @@
+import { EnergyAppPackageLanguage } from "../energy-app-package-definition.cjs";
+/**
+ * A translated, human-readable string used when presenting a provided file to
+ * the user (e.g. its display name or explanation).
+ *
+ * Mirrors the translation shape used elsewhere in the SDK (see
+ * {@link EnyoPackageConfigurationTranslatedValue}): the host picks the entry
+ * whose {@link language} matches the active UI language, falling back to another
+ * available language when no exact match exists.
+ */
+export interface EnyoFileTranslation {
+    /** Language code this translation applies to. */
+    language: EnergyAppPackageLanguage;
+    /** The displayed text in the given language. */
+    value: string;
+}
+/**
+ * The concrete, on-demand content of a provided file.
+ *
+ * Produced by an {@link EnyoFileContentHandler} at the moment the user chooses
+ * to store the file. The payload is transferred as a base64-encoded string so
+ * that arbitrary binary content (PDF, ZIP, images, ...) can cross the app/host
+ * boundary safely.
+ */
+export interface EnyoFileContent {
+    /**
+     * File payload, base64-encoded. For text formats this is the base64 of the
+     * UTF-8 bytes; for binary formats the base64 of the raw bytes. Must NOT
+     * include a `data:` URI prefix.
+     */
+    base64: string;
+    /**
+     * IANA MIME type describing the payload, e.g. `application/pdf`,
+     * `text/csv`, `application/zip`. Used by the host to choose which
+     * application opens the file and to set download headers.
+     */
+    mimeType: string;
+    /**
+     * Concrete file name including extension used when the file is written to
+     * disk, e.g. `charging-report-2026-07.pdf`. This is the technical on-disk
+     * file name and is distinct from the translated display name shown in the
+     * UI (see {@link EnyoFileRegistration.name}).
+     */
+    fileName: string;
+}
+/**
+ * Handler invoked by the host when the user chooses to store/save a previously
+ * registered provided file.
+ *
+ * The handler is called lazily — content is produced on demand rather than at
+ * registration time — which lets the app generate large or expensive payloads
+ * (reports, exports, log bundles) only when actually requested. The returned
+ * promise must resolve to the file's {@link EnyoFileContent}; rejecting it
+ * signals to the host that the content could not be produced and that the store
+ * action should fail gracefully.
+ *
+ * @returns A promise resolving to the file's base64 content, MIME type and
+ *   concrete file name.
+ */
+export type EnyoFileContentHandler = () => Promise<EnyoFileContent>;
+/**
+ * Registration payload describing a file the app offers to the user.
+ *
+ * The translated {@link name} (and optional {@link explanation}) are stored by
+ * the host and shown in the UI without the app needing to ship per-host UI
+ * strings. The actual bytes are supplied later by the
+ * {@link EnyoFileContentHandler} passed alongside this registration to
+ * {@link EnergyAppFile.registerFile}.
+ */
+export interface EnyoFileRegistration {
+    /**
+     * Stable, app-chosen identifier for this file. Used for upsert semantics on
+     * {@link EnergyAppFile.registerFile} and as the key for
+     * {@link EnergyAppFile.deregisterFile}. Must be unique within the package.
+     */
+    fileId: string;
+    /** Translated display name shown to the user in the host UI. */
+    name: EnyoFileTranslation[];
+    /**
+     * Optional translated explanation giving the user more context about what
+     * the file contains and why they might want to store it.
+     */
+    explanation?: EnyoFileTranslation[];
+    /**
+     * Optional appliance ID scoping this file to a specific appliance. When
+     * set, the host may surface the file on that appliance's screen; when
+     * omitted the file is treated as package-level.
+     */
+    applianceId?: string;
+}
+/**
+ * Read-only view of a currently registered provided file, as returned by
+ * {@link EnergyAppFile.listFiles}.
+ *
+ * Contains only the descriptive metadata registered by the app — never the file
+ * content itself, which is always produced on demand via the registered
+ * {@link EnyoFileContentHandler}.
+ */
+export interface EnyoFileInfo {
+    /** Identifier the file was registered under. */
+    fileId: string;
+    /** Translated display name shown to the user. */
+    name: EnyoFileTranslation[];
+    /** Optional translated explanation shown alongside the name. */
+    explanation?: EnyoFileTranslation[];
+    /** Optional appliance ID this file is scoped to, if any. */
+    applianceId?: string;
+}

package/dist/cjs/types/enyo-heating-rod-appliance.cjs

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnyoHeatingRodApplianceModeEnum = exports.EnyoHeatingRodApplianceAvailableFeaturesEnum = void 0;
+/**
+ * Available features for a heating rod (immersion / electric resistive heating
+ * element) appliance.
+ */
+var EnyoHeatingRodApplianceAvailableFeaturesEnum;
+(function (EnyoHeatingRodApplianceAvailableFeaturesEnum) {
+    /** If the heating rod reports electrical power values (e.g. consumption in watts) */
+    EnyoHeatingRodApplianceAvailableFeaturesEnum["Power"] = "Power";
+    /** If the heating rod supports available power announcements */
+    EnyoHeatingRodApplianceAvailableFeaturesEnum["AvailablePowerAnnouncement"] = "AvailablePowerAnnouncement";
+})(EnyoHeatingRodApplianceAvailableFeaturesEnum || (exports.EnyoHeatingRodApplianceAvailableFeaturesEnum = EnyoHeatingRodApplianceAvailableFeaturesEnum = {}));
+/**
+ * Operating modes for a heating rod appliance.
+ */
+var EnyoHeatingRodApplianceModeEnum;
+(function (EnyoHeatingRodApplianceModeEnum) {
+    /** The heating rod is idle (not consuming power) */
+    EnyoHeatingRodApplianceModeEnum["Idle"] = "Idle";
+    /** The heating rod is actively heating */
+    EnyoHeatingRodApplianceModeEnum["Heating"] = "Heating";
+})(EnyoHeatingRodApplianceModeEnum || (exports.EnyoHeatingRodApplianceModeEnum = EnyoHeatingRodApplianceModeEnum = {}));

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

@@ -0,0 +1,37 @@
+/**
+ * Available features for a heating rod (immersion / electric resistive heating
+ * element) appliance.
+ */
+export declare enum EnyoHeatingRodApplianceAvailableFeaturesEnum {
+    /** If the heating rod reports electrical power values (e.g. consumption in watts) */
+    Power = "Power",
+    /** If the heating rod supports available power announcements */
+    AvailablePowerAnnouncement = "AvailablePowerAnnouncement"
+}
+/**
+ * Operating modes for a heating rod appliance.
+ */
+export declare enum EnyoHeatingRodApplianceModeEnum {
+    /** The heating rod is idle (not consuming power) */
+    Idle = "Idle",
+    /** The heating rod is actively heating */
+    Heating = "Heating"
+}
+/**
+ * Type-specific metadata for a heating rod appliance.
+ * Contains available features, current operating mode, rated power, and an
+ * optional reference to the heat pump the heating rod is associated with.
+ */
+export interface EnyoHeatingRodApplianceMetadata {
+    /** List of features supported by this heating rod */
+    availableFeatures: EnyoHeatingRodApplianceAvailableFeaturesEnum[];
+    /** Current operating mode of the heating rod */
+    mode?: EnyoHeatingRodApplianceModeEnum;
+    /** Rated electrical power of the heating rod in watts */
+    ratedPowerW?: number;
+    /**
+     * Optional identifier of the heat pump appliance this heating rod is
+     * associated with. References the `id` of an EnyoAppliance of type Heatpump.
+     */
+    heatpumpApplianceId?: string;
+}

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

package/dist/energy-app-appliance-type.enum.d.ts

@@ -15,5 +15,6 @@ export declare enum EnergyAppApplianceTypeEnum {
     Dryer = "dryer",
     Oven = "oven",
     Freezer = "freezer",
-    AirConditioning = "air-conditioning"
+    AirConditioning = "air-conditioning",
+    HeatingRod = "heating-rod"
 }

package/dist/energy-app-appliance-type.enum.js

@@ -17,4 +17,5 @@ export var EnergyAppApplianceTypeEnum;
     EnergyAppApplianceTypeEnum["Oven"] = "oven";
     EnergyAppApplianceTypeEnum["Freezer"] = "freezer";
     EnergyAppApplianceTypeEnum["AirConditioning"] = "air-conditioning";
+    EnergyAppApplianceTypeEnum["HeatingRod"] = "heating-rod";
 })(EnergyAppApplianceTypeEnum || (EnergyAppApplianceTypeEnum = {}));

package/dist/energy-app-package-definition.d.ts

@@ -14,6 +14,7 @@ export declare enum EnergyAppPackageCategory {
     StaticElectricityTariff = "static-electricity-tariff",
     TemperatureSensor = "temperature-sensor",
     SmartPlug = "smart-plug",
+    HeatingRod = "heating-rod",
     Other = "other"
 }
 /**