@enyo-energy/energy-app-sdk 0.0.57 → 0.0.59

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

@@ -50,8 +50,6 @@ export interface EnergyAppPackageOptionsDeviceDetectionHttp {
     matchingValues: string[];
 }
 export interface EnergyAppPackageOptionsDeviceDetectionOcpp {
-    /** ocpp message name, for example BootNotification */
-    message: string;
     /** field name in the boot notification */
     field: string;
     /** matching values, for example the vendor names or model names */
@@ -89,6 +87,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 +107,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,7 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["SecretManager"] = "SecretManager";
     EnergyAppPermissionTypeEnum["LocationZipCode"] = "LocationZipCode";
     EnergyAppPermissionTypeEnum["LocationCoordinates"] = "LocationCoordinates";
+    EnergyAppPermissionTypeEnum["Timeseries"] = "Timeseries";
+    EnergyAppPermissionTypeEnum["EnergyManagerInfo"] = "EnergyManagerInfo";
+    EnergyAppPermissionTypeEnum["ElectricityTariff"] = "ElectricityTariff";
 })(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' | 'ElectricityTariff';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -17,5 +17,8 @@ export declare enum EnergyAppPermissionTypeEnum {
     Charge = "Charge",
     SecretManager = "SecretManager",
     LocationZipCode = "LocationZipCode",
-    LocationCoordinates = "LocationCoordinates"
+    LocationCoordinates = "LocationCoordinates",
+    Timeseries = "Timeseries",
+    EnergyManagerInfo = "EnergyManagerInfo",
+    ElectricityTariff = "ElectricityTariff"
 }

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

@@ -15,7 +15,10 @@ 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";
+import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-tariff.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -74,4 +77,10 @@ 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;
+    /** Get the Electricity Tariff API for managing electricity tariffs */
+    useElectricityTariff: () => EnergyAppElectricityTariff;
 }

package/dist/cjs/implementations/ocpp/ocpp16.cjs

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChargePointStatus = exports.RegistrationStatus = exports.OCPP16Action = void 0;
 var OCPP16Action;
 (function (OCPP16Action) {
-    OCPP16Action["Authorize"] = "Authorize";
+    /** The authorization is handled by the core and you will get an info if authorized */
+    OCPP16Action["AuthorizationInfo"] = "AuthorizationInfo";
     OCPP16Action["BootNotification"] = "BootNotification";
     OCPP16Action["CancelReservation"] = "CancelReservation";
     OCPP16Action["ChangeAvailability"] = "ChangeAvailability";

package/dist/cjs/implementations/ocpp/ocpp16.d.cts

@@ -1,5 +1,6 @@
 export declare enum OCPP16Action {
-    Authorize = "Authorize",
+    /** The authorization is handled by the core and you will get an info if authorized */
+    AuthorizationInfo = "AuthorizationInfo",
     BootNotification = "BootNotification",
     CancelReservation = "CancelReservation",
     ChangeAvailability = "ChangeAvailability",
@@ -78,12 +79,10 @@ export interface OCPP16StatusNotificationResponse {
 export interface OCPP16AuthorizeRequest {
     idTag: string;
 }
-export interface OCPP16AuthorizeResponse {
-    idTagInfo: {
-        status: 'Accepted' | 'Blocked' | 'Expired' | 'Invalid' | 'ConcurrentTx';
-        expiryDate?: string;
-        parentIdTag?: string;
-    };
+export interface OCPP16AuthorizationInfoResponse {
+    idTag: string;
+    chargingCardId?: string;
+    vehicleId?: string;
 }
 export interface OCPP16StartTransactionRequest {
     connectorId: number;

package/dist/cjs/implementations/ocpp/ocpp201.cjs

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectorStatusEnumType = exports.RegistrationStatusEnumType = exports.OCPP201Action = void 0;
 var OCPP201Action;
 (function (OCPP201Action) {
-    OCPP201Action["Authorize"] = "Authorize";
+    /** The authorization is handled by the core and you will get an info if authorized */
+    OCPP201Action["AuthorizationInfo"] = "AuthorizationInfo";
     OCPP201Action["BootNotification"] = "BootNotification";
     OCPP201Action["CancelReservation"] = "CancelReservation";
     OCPP201Action["CertificateSigned"] = "CertificateSigned";

package/dist/cjs/implementations/ocpp/ocpp201.d.cts

@@ -1,5 +1,6 @@
 export declare enum OCPP201Action {
-    Authorize = "Authorize",
+    /** The authorization is handled by the core and you will get an info if authorized */
+    AuthorizationInfo = "AuthorizationInfo",
     BootNotification = "BootNotification",
     CancelReservation = "CancelReservation",
     CertificateSigned = "CertificateSigned",
@@ -112,7 +113,9 @@ export interface OCPP201StatusNotificationRequest {
 }
 export interface OCPP201StatusNotificationResponse {
 }
-export interface OCPP201AuthorizeRequest {
+export interface OCPP201AuthorizationInfoRequest {
+    chargingCardId?: string;
+    vehicleId?: string;
     idToken: {
         idToken: string;
         type: 'Central' | 'eMAID' | 'ISO14443' | 'ISO15693' | 'KeyCode' | 'Local' | 'MacAddress' | 'NoAuthorization';
@@ -121,13 +124,6 @@ export interface OCPP201AuthorizeRequest {
             type: string;
         }>;
     };
-    certificate?: string;
-    iso15118CertificateHashData?: Array<{
-        hashAlgorithm: 'SHA256' | 'SHA384' | 'SHA512';
-        issuerNameHash: string;
-        issuerKeyHash: string;
-        serialNumber: string;
-    }>;
 }
 export interface OCPP201AuthorizeResponse {
     idTokenInfo: {

package/dist/cjs/index.cjs

@@ -31,6 +31,12 @@ __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);
+__exportStar(require("./types/enyo-electricity-tariff.cjs"), exports);
+__exportStar(require("./packages/energy-app-electricity-tariff.cjs"), exports);
+__exportStar(require("./types/enyo-pv-forecast.cjs"), exports);
 class EnergyApp {
     energyAppSdk;
     constructor() {
@@ -127,6 +133,32 @@ 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 Electricity Tariff API for managing electricity tariffs.
+     * Provides methods to register, retrieve, and remove electricity tariffs
+     * used for energy pricing and consumption calculations.
+     * @returns The Electricity Tariff API instance
+     */
+    useElectricityTariff() {
+        return this.energyAppSdk.useElectricityTariff();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/index.d.cts

@@ -16,7 +16,10 @@ 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";
+import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-tariff.cjs";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -32,6 +35,12 @@ 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 * from './types/enyo-electricity-tariff.cjs';
+export * from './packages/energy-app-electricity-tariff.cjs';
+export * from './types/enyo-pv-forecast.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();
@@ -67,6 +76,26 @@ 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 Electricity Tariff API for managing electricity tariffs.
+     * Provides methods to register, retrieve, and remove electricity tariffs
+     * used for energy pricing and consumption calculations.
+     * @returns The Electricity Tariff API instance
+     */
+    useElectricityTariff(): EnergyAppElectricityTariff;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/packages/energy-app-electricity-prices.d.cts

@@ -45,6 +45,21 @@ export interface EnergyAppElectricityPrices {
      * @returns Promise that resolves to current price information, or null if no pricing data is available
      */
     getCurrentPrice(applianceId?: string): Promise<ElectricityPriceEntry | null>;
+    /**
+     * Retrieves the system default tariff information.
+     * Returns the full tariff including pricing data.
+     *
+     * @returns Promise that resolves to the default tariff info, or null if none is configured
+     */
+    getDefaultTariff(): Promise<EnergyTariffInfo | null>;
+    /**
+     * Retrieves tariff information by tariff ID.
+     * Returns the full tariff including pricing data.
+     *
+     * @param tariffId - The unique identifier of the tariff
+     * @returns Promise that resolves to the tariff info, or null if not found
+     */
+    getTariffById(tariffId: string): Promise<EnergyTariffInfo | null>;
 }
 /**
  * Represents a single electricity price entry for convenience methods

package/dist/cjs/packages/energy-app-electricity-tariff.cjs

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

package/dist/cjs/packages/energy-app-electricity-tariff.d.cts

@@ -0,0 +1,33 @@
+import { ElectricityTariffRegistration, ElectricityTariffWithDefault } from "../types/enyo-electricity-tariff.cjs";
+/**
+ * Interface for managing electricity tariffs.
+ * Provides methods to register, retrieve, and remove electricity tariffs
+ * used for energy pricing and consumption calculations.
+ */
+export interface EnergyAppElectricityTariff {
+    /**
+     * Registers a new electricity tariff or updates an existing one.
+     * Uses upsert logic based on tariffId - if a tariff with the same ID exists,
+     * it will be updated; otherwise, a new tariff will be created.
+     *
+     * @param tariff - The tariff registration data including ID, type, name, and vendor
+     * @returns Promise that resolves when the tariff has been registered
+     */
+    registerTariff(tariff: ElectricityTariffRegistration): Promise<void>;
+    /**
+     * Retrieves all registered electricity tariffs.
+     * Each tariff includes a defaultTariff boolean indicating whether
+     * it is the system default tariff.
+     *
+     * @returns Promise that resolves to an array of all registered tariffs with default indicators
+     */
+    getAllTariffs(): Promise<ElectricityTariffWithDefault[]>;
+    /**
+     * Removes an electricity tariff by its ID.
+     * If the tariff does not exist, this operation is a no-op.
+     *
+     * @param tariffId - The unique identifier of the tariff to remove
+     * @returns Promise that resolves when the tariff has been removed
+     */
+    removeTariff(tariffId: string): Promise<void>;
+}

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-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

@@ -103,4 +103,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["EnergyTariffUpdateV1"] = "EnergyTariffUpdateV1";
     EnyoDataBusMessageEnum["ChargeFinishedV1"] = "ChargeFinishedV1";
     EnyoDataBusMessageEnum["ChargerStatusChangedV1"] = "ChargerStatusChangedV1";
+    EnyoDataBusMessageEnum["RequestPreviewChargingScheduleV1"] = "RequestPreviewChargingScheduleV1";
+    EnyoDataBusMessageEnum["PreviewChargingScheduleResponseV1"] = "PreviewChargingScheduleResponseV1";
+    EnyoDataBusMessageEnum["PvForecastV1"] = "PvForecastV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));