@enyo-energy/energy-app-sdk 0.0.56 → 0.0.58

package/README.md

@@ -123,6 +123,8 @@ import {
 const packageDef = defineEnergyAppPackage({
     version: '1',
     packageName: 'solar-optimizer',
+    // Optional: Internal documentation for developers (not shown to users)
+    internalDescription: 'This app optimizes solar energy production using weather forecasts and AI predictions.',
     logo: './assets/logo.png',
     categories: [
         EnergyAppPackageCategory.Inverter,
@@ -142,12 +144,15 @@ const packageDef = defineEnergyAppPackage({
             description: 'Erweiterte Solarenergie-Optimierung mit KI-gesteuerten Vorhersagen und Echtzeitanpassungen.'
         }
     ],
+    // Permissions can be objects with internal comments (recommended for documentation)
     permissions: [
-        EnergyAppPermissionTypeEnum.Modbus,
-        EnergyAppPermissionTypeEnum.SendDataBusValues,
-        EnergyAppPermissionTypeEnum.SubscribeDataBus,
-        EnergyAppPermissionTypeEnum.Storage
+        { permission: EnergyAppPermissionTypeEnum.Modbus, internalComment: 'Required to read inverter registers via Modbus TCP' },
+        { permission: EnergyAppPermissionTypeEnum.SendDataBusValues, internalComment: 'Used to publish inverter power values to the data bus' },
+        { permission: EnergyAppPermissionTypeEnum.SubscribeDataBus, internalComment: 'Listens for battery state updates' },
+        { permission: EnergyAppPermissionTypeEnum.Storage, internalComment: 'Stores configuration and historical optimization data' }
     ],
+    // Note: Simple permission types are also supported for backwards compatibility:
+    // permissions: [EnergyAppPermissionTypeEnum.Modbus, EnergyAppPermissionTypeEnum.Storage]
     options: {
         restrictedInternetAccess: {
             origins: ['api.weather.com', 'solar-forecasting.com']

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

@@ -89,6 +89,16 @@ export interface EnergyAppPackageStoreEntry {
     /** Detailed description of the package functionality */
     description: string;
 }
+/**
+ * Defines a permission entry for an Energy App package.
+ * Contains the permission type and an internal comment explaining its usage.
+ */
+export interface EnergyAppPackagePermission {
+    /** The permission type required by the package */
+    permission: EnergyAppPermissionType;
+    /** Internal documentation describing what this permission is used for */
+    internalComment: string;
+}
 /**
  * Complete definition for a enyo Energy App package.
  * This interface defines all the metadata, permissions, and configuration
@@ -99,14 +109,16 @@ export interface EnergyAppPackageDefinition {
     version: '1';
     /** Unique identifier for the package */
     packageName: string;
+    /** Internal documentation describing the concept and purpose of this energy app (optional) */
+    internalDescription?: string;
     /** Optional path to the logo */
     logo?: string;
     /** Categories that this package belongs to */
     categories: EnergyAppPackageCategory[];
     /** Localized store information for different languages */
     storeEntry: EnergyAppPackageStoreEntry[];
-    /** Required permissions for this package to function */
-    permissions: EnergyAppPermissionType[];
+    /** Required permissions for this package to function. Can be simple permission types or objects with internal comments */
+    permissions: (EnergyAppPermissionType | EnergyAppPackagePermission)[];
     /** Optional configuration settings */
     options?: EnergyAppPackageOptions;
     /** The version of the enyo SDK used to build this package (automatically injected) */

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

@@ -21,4 +21,6 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["SecretManager"] = "SecretManager";
     EnergyAppPermissionTypeEnum["LocationZipCode"] = "LocationZipCode";
     EnergyAppPermissionTypeEnum["LocationCoordinates"] = "LocationCoordinates";
+    EnergyAppPermissionTypeEnum["Timeseries"] = "Timeseries";
+    EnergyAppPermissionTypeEnum["EnergyManagerInfo"] = "EnergyManagerInfo";
 })(EnergyAppPermissionTypeEnum || (exports.EnergyAppPermissionTypeEnum = EnergyAppPermissionTypeEnum = {}));

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

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -17,5 +17,7 @@ export declare enum EnergyAppPermissionTypeEnum {
     Charge = "Charge",
     SecretManager = "SecretManager",
     LocationZipCode = "LocationZipCode",
-    LocationCoordinates = "LocationCoordinates"
+    LocationCoordinates = "LocationCoordinates",
+    Timeseries = "Timeseries",
+    EnergyManagerInfo = "EnergyManagerInfo"
 }

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

@@ -15,7 +15,9 @@ import { EnergyAppNotification } from "./packages/energy-app-notification.cjs";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.cjs";
 import { EnergyAppLocation } from "./packages/energy-app-location.cjs";
 import { EnergyAppOnboarding } from "./packages/energy-app-onboarding.cjs";
+import { EnergyAppTimeseries } from "./packages/energy-app-timeseries.cjs";
 import { EnyoPackageChannel } from "./enyo-package-channel.cjs";
+import { EnergyAppEnergyManager } from "./packages/energy-app-energy-manager.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -74,4 +76,8 @@ export interface EnyoEnergyAppSdk {
     useLocation: () => EnergyAppLocation;
     /** Get the Onboarding API */
     useOnboarding: () => EnergyAppOnboarding;
+    /** Get the Timeseries API for querying historical energy data */
+    useTimeseries: () => EnergyAppTimeseries;
+    /** Get the Energy Manager API for retrieving energy manager info and capabilities */
+    useEnergyManager: () => EnergyAppEnergyManager;
 }

package/dist/cjs/implementations/appliances/identifier-strategies.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IdentifierStrategyFactory = exports.FallbackIdentifierStrategy = exports.CompositeIdentifierStrategy = exports.CustomMetadataStrategy = exports.ChargePointIdStrategy = exports.HostnameStrategy = exports.TypeStrategy = exports.SerialNumberStrategy = void 0;
+exports.IdentifierStrategyFactory = exports.AndIdentifierStrategy = exports.OrIdentifierStrategy = exports.FallbackIdentifierStrategy = exports.CompositeIdentifierStrategy = exports.CustomMetadataStrategy = exports.ChargePointIdStrategy = exports.HostnameStrategy = exports.TypeStrategy = exports.SerialNumberStrategy = void 0;
 /**
  * Strategy that uses the appliance's serial number as the identifier.
  * Useful when appliances can move between network devices.
@@ -150,6 +150,73 @@ class FallbackIdentifierStrategy {
     }
 }
 exports.FallbackIdentifierStrategy = FallbackIdentifierStrategy;
+/**
+ * Strategy that tries multiple strategies and returns the first available identifier.
+ * This is an OR operation - any strategy succeeding is sufficient.
+ */
+class OrIdentifierStrategy {
+    strategies;
+    name;
+    /**
+     * Creates a strategy that tries multiple strategies in order.
+     * @param strategies The strategies to try (OR logic)
+     */
+    constructor(strategies) {
+        this.strategies = strategies;
+        this.name = `or(${strategies.map(s => s.name).join('|')})`;
+    }
+    /**
+     * Tries strategies in order and returns the first available identifier.
+     * @param appliance The appliance to extract identifiers from
+     * @returns The first available identifier or undefined if none match
+     */
+    extract(appliance) {
+        for (const strategy of this.strategies) {
+            const value = strategy.extract(appliance);
+            if (value) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+}
+exports.OrIdentifierStrategy = OrIdentifierStrategy;
+/**
+ * Strategy that combines multiple strategies into a single composite identifier.
+ * This is an AND operation - all strategies must return a value.
+ */
+class AndIdentifierStrategy {
+    strategies;
+    separator;
+    name;
+    /**
+     * Creates a strategy that requires all sub-strategies to match.
+     * @param strategies The strategies to combine (AND logic)
+     * @param separator The separator to use between identifier parts
+     */
+    constructor(strategies, separator = ':') {
+        this.strategies = strategies;
+        this.separator = separator;
+        this.name = `and(${strategies.map(s => s.name).join('&')})`;
+    }
+    /**
+     * Extracts and combines identifiers from all strategies.
+     * @param appliance The appliance to extract identifiers from
+     * @returns The combined identifier or undefined if any part is missing
+     */
+    extract(appliance) {
+        const parts = [];
+        for (const strategy of this.strategies) {
+            const value = strategy.extract(appliance);
+            if (!value) {
+                return undefined; // All parts must be present (AND logic)
+            }
+            parts.push(value);
+        }
+        return parts.join(this.separator);
+    }
+}
+exports.AndIdentifierStrategy = AndIdentifierStrategy;
 /**
  * Factory class for creating common identifier strategies.
  */
@@ -194,5 +261,20 @@ class IdentifierStrategyFactory {
     static fallback(strategies) {
         return new FallbackIdentifierStrategy(strategies);
     }
+    /**
+     * Creates an OR strategy that returns the first available identifier.
+     * @param strategies The strategies to try
+     */
+    static or(strategies) {
+        return new OrIdentifierStrategy(strategies);
+    }
+    /**
+     * Creates an AND strategy that combines all identifiers.
+     * @param strategies The strategies to combine
+     * @param separator The separator between parts
+     */
+    static and(strategies, separator) {
+        return new AndIdentifierStrategy(strategies, separator);
+    }
 }
 exports.IdentifierStrategyFactory = IdentifierStrategyFactory;

package/dist/cjs/implementations/appliances/identifier-strategies.d.cts

@@ -119,6 +119,46 @@ export declare class FallbackIdentifierStrategy implements IdentifierStrategy {
      */
     extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
 }
+/**
+ * Strategy that tries multiple strategies and returns the first available identifier.
+ * This is an OR operation - any strategy succeeding is sufficient.
+ */
+export declare class OrIdentifierStrategy implements IdentifierStrategy {
+    private strategies;
+    name: string;
+    /**
+     * Creates a strategy that tries multiple strategies in order.
+     * @param strategies The strategies to try (OR logic)
+     */
+    constructor(strategies: IdentifierStrategy[]);
+    /**
+     * Tries strategies in order and returns the first available identifier.
+     * @param appliance The appliance to extract identifiers from
+     * @returns The first available identifier or undefined if none match
+     */
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
+}
+/**
+ * Strategy that combines multiple strategies into a single composite identifier.
+ * This is an AND operation - all strategies must return a value.
+ */
+export declare class AndIdentifierStrategy implements IdentifierStrategy {
+    private strategies;
+    private separator;
+    name: string;
+    /**
+     * Creates a strategy that requires all sub-strategies to match.
+     * @param strategies The strategies to combine (AND logic)
+     * @param separator The separator to use between identifier parts
+     */
+    constructor(strategies: IdentifierStrategy[], separator?: string);
+    /**
+     * Extracts and combines identifiers from all strategies.
+     * @param appliance The appliance to extract identifiers from
+     * @returns The combined identifier or undefined if any part is missing
+     */
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
+}
 /**
  * Factory class for creating common identifier strategies.
  */
@@ -149,4 +189,15 @@ export declare class IdentifierStrategyFactory {
      * @param strategies The strategies to try
      */
     static fallback(strategies: IdentifierStrategy[]): FallbackIdentifierStrategy;
+    /**
+     * Creates an OR strategy that returns the first available identifier.
+     * @param strategies The strategies to try
+     */
+    static or(strategies: IdentifierStrategy[]): OrIdentifierStrategy;
+    /**
+     * Creates an AND strategy that combines all identifiers.
+     * @param strategies The strategies to combine
+     * @param separator The separator between parts
+     */
+    static and(strategies: IdentifierStrategy[], separator?: string): AndIdentifierStrategy;
 }

package/dist/cjs/index.cjs

@@ -31,6 +31,9 @@ __exportStar(require("./types/enyo-location.cjs"), exports);
 __exportStar(require("./implementations/appliances/appliance-manager.cjs"), exports);
 __exportStar(require("./implementations/appliances/identifier-strategies.cjs"), exports);
 __exportStar(require("./enyo-package-channel.cjs"), exports);
+__exportStar(require("./types/enyo-timeseries.cjs"), exports);
+__exportStar(require("./types/enyo-energy-manager.cjs"), exports);
+__exportStar(require("./packages/energy-app-energy-manager.cjs"), exports);
 class EnergyApp {
     energyAppSdk;
     constructor() {
@@ -127,6 +130,23 @@ class EnergyApp {
     useLocation() {
         return this.energyAppSdk.useLocation();
     }
+    /**
+     * Gets the Timeseries API for querying historical energy data.
+     * Provides methods to retrieve aggregated timeseries data with 15-minute bucket granularity
+     * for various energy metrics including PV production, battery state, meter values, and grid power.
+     * @returns The Timeseries API instance
+     */
+    useTimeseries() {
+        return this.energyAppSdk.useTimeseries();
+    }
+    /**
+     * Gets the Energy Manager API for retrieving information about the active energy manager.
+     * Provides methods to check the current energy manager and its supported features.
+     * @returns The Energy Manager API instance
+     */
+    useEnergyManager() {
+        return this.energyAppSdk.useEnergyManager();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/index.d.cts

@@ -16,7 +16,9 @@ import { EnergyAppNotification } from "./packages/energy-app-notification.cjs";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.cjs";
 import { EnergyAppLocation } from "./packages/energy-app-location.cjs";
 import { EnergyAppOnboarding } from "./packages/energy-app-onboarding.cjs";
+import { EnergyAppTimeseries } from "./packages/energy-app-timeseries.cjs";
 import { EnyoPackageChannel } from "./enyo-package-channel.cjs";
+import { EnergyAppEnergyManager } from "./packages/energy-app-energy-manager.cjs";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -32,6 +34,9 @@ export * from './types/enyo-location.cjs';
 export * from './implementations/appliances/appliance-manager.cjs';
 export * from './implementations/appliances/identifier-strategies.cjs';
 export * from './enyo-package-channel.cjs';
+export * from './types/enyo-timeseries.cjs';
+export * from './types/enyo-energy-manager.cjs';
+export * from './packages/energy-app-energy-manager.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();
@@ -67,6 +72,19 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Location API instance
      */
     useLocation(): EnergyAppLocation;
+    /**
+     * Gets the Timeseries API for querying historical energy data.
+     * Provides methods to retrieve aggregated timeseries data with 15-minute bucket granularity
+     * for various energy metrics including PV production, battery state, meter values, and grid power.
+     * @returns The Timeseries API instance
+     */
+    useTimeseries(): EnergyAppTimeseries;
+    /**
+     * Gets the Energy Manager API for retrieving information about the active energy manager.
+     * Provides methods to check the current energy manager and its supported features.
+     * @returns The Energy Manager API instance
+     */
+    useEnergyManager(): EnergyAppEnergyManager;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

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

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

@@ -0,0 +1,24 @@
+import { EnergyManagerInfo } from "../types/enyo-energy-manager.cjs";
+/**
+ * Interface for retrieving energy manager information and capabilities.
+ * The energy manager is responsible for optimizing energy usage across appliances.
+ */
+export interface EnergyAppEnergyManager {
+    /**
+     * Gets information about the currently active energy manager.
+     * Returns null if no energy manager is configured.
+     *
+     * @returns Promise resolving to energy manager info or null if no energy manager is configured
+     *
+     * @example
+     * ```typescript
+     * const energyManager = energyApp.useEnergyManager();
+     * const info = await energyManager.getEnergyManagerInfo();
+     * if (info) {
+     *     console.log(`Energy Manager: ${info.name}`);
+     *     console.log(`Features: ${info.features.join(', ')}`);
+     * }
+     * ```
+     */
+    getEnergyManagerInfo(): Promise<EnergyManagerInfo | null>;
+}

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

@@ -2,8 +2,8 @@
  * Configuration options for establishing a Modbus connection.
  */
 export interface ModbusOptions {
-    /** Hostname or IP address of the Modbus server */
-    host: string;
+    /** Hostname or IP address of the Modbus server. If set as an array, we use the other hosts as fallbacks */
+    host: string | string[];
     /** Port number for the Modbus connection (default: 502) */
     port?: number;
     /** Connection timeout in milliseconds */

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

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

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

@@ -0,0 +1,124 @@
+import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse } 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
+ * including PV production, battery state, meter values, and grid power.
+ *
+ * All aggregated methods return data in 15-minute buckets aligned to clock time
+ * (:00, :15, :30, :45). Power values (W) represent time-weighted averages within
+ * each bucket, while energy values (Wh) represent cumulative sums.
+ *
+ * Date ranges use inclusive start and exclusive end timestamps.
+ */
+export interface EnergyAppTimeseries {
+    /**
+     * Queries raw data bus messages for a specific appliance.
+     * Supports pagination and filtering by message type.
+     *
+     * @param request - The query parameters including appliance ID, date range, and optional filters
+     * @returns Promise resolving to the matching messages with pagination metadata
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.queryDataBusMessages({
+     *     applianceId: 'inverter-001',
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z',
+     *     messageTypes: [EnyoDataBusMessageEnum.InverterValuesUpdateV1],
+     *     limit: 100
+     * });
+     * ```
+     */
+    queryDataBusMessages(request: DataBusMessageQueryRequest): Promise<DataBusMessageQueryResponse>;
+    /**
+     * Retrieves PV production timeseries data aggregated in 15-minute buckets.
+     * Returns both instantaneous power (W) and cumulative energy (Wh) values.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to PV production entries and total production
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getPvProductionTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Total production: ${response.totalPvProductionWh} Wh`);
+     * ```
+     */
+    getPvProductionTimeseries(request: PvProductionTimeseriesRequest): Promise<PvProductionTimeseriesResponse>;
+    /**
+     * Retrieves battery state of charge (SOC) timeseries data aggregated in 15-minute buckets.
+     * Returns average, minimum, and maximum SOC values for each bucket.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to battery SOC entries and overall average SOC
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getBatterySocTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z',
+     *     applianceIds: ['battery-001']
+     * });
+     * console.log(`Average SOC: ${response.averageSoC}%`);
+     * ```
+     */
+    getBatterySocTimeseries(request: BatterySocTimeseriesRequest): Promise<BatterySocTimeseriesResponse>;
+    /**
+     * Retrieves battery power timeseries data aggregated in 15-minute buckets.
+     * Positive values indicate discharge (consumption from battery),
+     * negative values indicate charge (energy into battery).
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to battery power entries with total charge and discharge amounts
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getBatteryPowerTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Total discharged: ${response.totalDischargeWh} Wh`);
+     * console.log(`Total charged: ${response.totalChargeWh} Wh`);
+     * ```
+     */
+    getBatteryPowerTimeseries(request: BatteryPowerTimeseriesRequest): Promise<BatteryPowerTimeseriesResponse>;
+    /**
+     * Retrieves meter values timeseries data aggregated in 15-minute buckets.
+     * Returns grid consumption and feed-in energy values.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to meter value entries with total consumption and feed-in
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getMeterValuesTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Grid consumption: ${response.totalGridConsumptionWh} Wh`);
+     * console.log(`Grid feed-in: ${response.totalGridFeedInWh} Wh`);
+     * ```
+     */
+    getMeterValuesTimeseries(request: MeterValuesTimeseriesRequest): Promise<MeterValuesTimeseriesResponse>;
+    /**
+     * Retrieves grid power timeseries data aggregated in 15-minute buckets.
+     * Positive values indicate import (consumption from grid),
+     * negative values indicate export (feed-in to grid).
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to grid power entries with total import and export amounts
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getGridPowerTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Total imported: ${response.totalImportWh} Wh`);
+     * console.log(`Total exported: ${response.totalExportWh} Wh`);
+     * ```
+     */
+    getGridPowerTimeseries(request: GridPowerTimeseriesRequest): Promise<GridPowerTimeseriesResponse>;
+}

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

@@ -5,6 +5,7 @@ var EnyoChargerApplianceStatusEnum;
 (function (EnyoChargerApplianceStatusEnum) {
     EnyoChargerApplianceStatusEnum["Available"] = "Available";
     EnyoChargerApplianceStatusEnum["Occupied"] = "Occupied";
+    EnyoChargerApplianceStatusEnum["Charging"] = "Charging";
     EnyoChargerApplianceStatusEnum["Suspended"] = "Suspended";
     EnyoChargerApplianceStatusEnum["Finishing"] = "Finishing";
     EnyoChargerApplianceStatusEnum["Reserved"] = "Reserved";

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

@@ -1,6 +1,7 @@
 export declare enum EnyoChargerApplianceStatusEnum {
     Available = "Available",
     Occupied = "Occupied",
+    Charging = "Charging",
     Suspended = "Suspended",
     Finishing = "Finishing",
     Reserved = "Reserved",

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

@@ -101,4 +101,8 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["StopChargeV1"] = "StopChargeV1";
     EnyoDataBusMessageEnum["AggregatedStateUpdateV1"] = "AggregatedStateUpdateV1";
     EnyoDataBusMessageEnum["EnergyTariffUpdateV1"] = "EnergyTariffUpdateV1";
+    EnyoDataBusMessageEnum["ChargeFinishedV1"] = "ChargeFinishedV1";
+    EnyoDataBusMessageEnum["ChargerStatusChangedV1"] = "ChargerStatusChangedV1";
+    EnyoDataBusMessageEnum["RequestPreviewChargingScheduleV1"] = "RequestPreviewChargingScheduleV1";
+    EnyoDataBusMessageEnum["PreviewChargingScheduleResponseV1"] = "PreviewChargingScheduleResponseV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));