@enyo-energy/energy-app-sdk 0.0.65 → 0.0.67

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

@@ -12,7 +12,8 @@ var EnergyAppPackageCategory;
     EnergyAppPackageCategory["HeatPump"] = "heat-pump";
     EnergyAppPackageCategory["BatteryStorage"] = "battery-storage";
     EnergyAppPackageCategory["ClimateControl"] = "climate-control";
-    EnergyAppPackageCategory["ElectricityTariff"] = "electricity-tariff";
+    EnergyAppPackageCategory["DynamicElectricityTariff"] = "dynamic-electricity-tariff";
+    EnergyAppPackageCategory["StaticElectricityTariff"] = "static-electricity-tariff";
 })(EnergyAppPackageCategory || (exports.EnergyAppPackageCategory = EnergyAppPackageCategory = {}));
 /**
  * Defines an Energy App package with automatic SDK version injection.

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

@@ -8,7 +8,8 @@ export declare enum EnergyAppPackageCategory {
     HeatPump = "heat-pump",
     BatteryStorage = "battery-storage",
     ClimateControl = "climate-control",
-    ElectricityTariff = "electricity-tariff"
+    DynamicElectricityTariff = "dynamic-electricity-tariff",
+    StaticElectricityTariff = "static-electricity-tariff"
 }
 /**
  * Configuration options for restricting internet access in an Energy App package.

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

@@ -21,7 +21,9 @@ export interface EnergyAppElectricityTariff {
      *
      * @returns Promise that resolves to an array of all registered tariffs with default indicators
      */
-    getAllTariffs(): Promise<EnyoElectricityTariffWithDefault[]>;
+    getAllTariffs(filter?: {
+        myTariffs?: boolean;
+    }): Promise<EnyoElectricityTariffWithDefault[]>;
     /**
      * Removes an electricity tariff by its ID.
      * If the tariff does not exist, this operation is a no-op.
@@ -40,5 +42,15 @@ export interface EnergyAppElectricityTariff {
     findTariff(filter: {
         applianceId?: string;
         tariffId?: string;
+        externalTariffId?: string;
     }): Promise<EnyoElectricityTariffWithDefault | null>;
+    /**
+     * Partially updates an existing electricity tariff.
+     * Only the provided attributes will be modified; all other fields remain unchanged.
+     *
+     * @param id - The unique identifier of the tariff to update
+     * @param attributes - A partial set of tariff fields to update (excluding `id`)
+     * @returns Promise that resolves to the full updated tariff with its default indicator
+     */
+    updateTariff(id: string, attributes: Partial<Omit<EnyoElectricityTariff, 'id'>>): Promise<EnyoElectricityTariffWithDefault>;
 }

package/dist/cjs/packages/energy-app-pv-system.d.cts

@@ -30,7 +30,7 @@ export interface EnergyAppPvSystem {
      * console.log(`Registered PV system: ${pvSystem.pvSystemId}`);
      * ```
      */
-    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id'>): Promise<EnyoPvSystem>;
+    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id' | 'createdBy'>): Promise<EnyoPvSystem>;
     /**
      * Retrieves a registered PV system by its ID.
      *
@@ -58,7 +58,7 @@ export interface EnergyAppPvSystem {
      * });
      * ```
      */
-    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id'>>): Promise<EnyoPvSystem>;
+    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id' | 'createdBy'>>): Promise<EnyoPvSystem>;
     /**
      * Removes a registered PV system by its ID.
      * If the PV system does not exist, this operation is a no-op.

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

@@ -591,14 +591,24 @@ export interface EnyoDataBusPreviewChargingScheduleResponseV1 extends EnyoDataBu
         requestId: string;
         /** Whether a preview charging schedule is available */
         available: boolean;
-        /** The preview charging schedule (only present if available=true) */
-        schedule?: PreviewChargingSchedule;
-        /** Cost comparison data (only present if requested and available) */
-        costComparison?: PreviewChargingScheduleCostComparison;
+        /** Preview charging schedule and cost comparison per charging mode. Each entry's costComparison compares against immediate charging. Only present if available=true. */
+        chargingModeResults?: PreviewChargingScheduleModeResult[];
         /** Reason why preview is not available (only present if available=false) */
         unavailableReason?: PreviewChargingScheduleUnavailableReasonEnum;
     };
 }
+/**
+ * Result for a single charging mode in a preview charging schedule response.
+ * Contains the schedule and optional cost comparison for one specific charging mode.
+ */
+export interface PreviewChargingScheduleModeResult {
+    /** The charging mode this result represents */
+    chargeMode: EnyoChargeModeEnum;
+    /** The preview charging schedule for this mode */
+    schedule: PreviewChargingSchedule;
+    /** Cost comparison of this mode vs immediate charging (only present if cost data is available) */
+    costComparison?: PreviewChargingScheduleCostComparison;
+}
 /**
  * Message for delivering PV production forecast data.
  * Contains forecasted power and energy values in 15-minute intervals.

package/dist/cjs/types/enyo-electricity-tariff.d.cts

@@ -65,6 +65,8 @@ export interface EnyoElectricityTariff {
     timeVariableTariffData?: TimeVariableTariffData;
     /** Optional dynamic pricing data*/
     dynamicTariffData?: DynamicTariffData;
+    /** Optional external tariff id for easy identification */
+    externalTariffId?: string;
 }
 /**
  * Tariff registration data extended with default indicator.

package/dist/cjs/types/enyo-energy-prices.d.cts

@@ -8,8 +8,6 @@ export interface EnyoEnergyPrices {
     type: ElectricityTariffTypeEnum;
     /** Pricing data structure */
     prices: EnyoEnergyPriceEntry[];
-    /** Timestamp when this tariff information was last updated */
-    lastUpdatedIso: string;
 }
 export interface EnyoEnergyPriceEntry {
     /** Start time of this 15-minute interval in ISO format */

package/dist/cjs/types/enyo-pv-system.d.cts

@@ -53,6 +53,16 @@ export interface PvSystemDcString {
     /** Source of the orientation information (user-provided or estimated) */
     orientationSource?: PvSystemOrientationSourceEnum;
 }
+/**
+ * Feed-in tariff configuration for a PV system.
+ * Defines the price for grid feed-in and behavior during negative market prices.
+ */
+export interface PvSystemFeedInTariff {
+    /** Price per kWh received for feeding electricity into the grid */
+    gridFeedInPricePerKwh: number;
+    /** Whether feed-in refund is disabled when the market price is negative */
+    noFeedInRefundOnNegativeMarketPrice: boolean;
+}
 /**
  * Registration data for a PV system.
  */
@@ -69,4 +79,6 @@ export interface EnyoPvSystem {
     appliances?: PvSystemAppliance[];
     /** Optional feature flags for this PV system */
     features?: PvSystemFeatureEnum[];
+    /** Optional feed-in tariff configuration for this PV system */
+    feedInTariff?: PvSystemFeedInTariff;
 }

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

@@ -16,6 +16,18 @@ export interface EnyoPackageConfigurationSettingSelectOption {
     /** The displayed name of the option */
     optionName: EnyoPackageConfigurationTranslatedValue[];
 }
+export interface EnyoPackageConfigurationSettingFloatOptions {
+    maxValue?: number;
+    minValue?: number;
+    step?: number;
+}
+export interface EnyoPackageConfigurationSettingIntegerOptions {
+    maxValue?: number;
+    minValue?: number;
+}
+export interface EnyoPackageConfigurationSettingTextOptions {
+    maxLength?: number;
+}
 /**
  * Represents a single configuration setting for an Energy App package.
  */
@@ -23,7 +35,7 @@ export interface EnyoPackageConfigurationSetting {
     /** internal name of the setting - must be unique */
     name: string;
     /** the type of the setting */
-    type: 'text' | 'select';
+    type: 'text' | 'select' | 'float' | 'integer' | 'checkbox';
     /** if the setting is required */
     required: boolean;
     /** The displayed name of the field */
@@ -35,11 +47,9 @@ export interface EnyoPackageConfigurationSetting {
     /** Optional appliance ID. If provided, setting is for specific appliance. If omitted, setting is for the whole package */
     applianceId?: string;
     selectOptions?: EnyoPackageConfigurationSettingSelectOption[];
-}
-/**
- * Configuration container for Energy App package settings.
- */
-export interface EnyoPackageConfiguration {
+    floatOptions?: EnyoPackageConfigurationSettingFloatOptions;
+    integerOptions?: EnyoPackageConfigurationSettingIntegerOptions;
+    textOptions?: EnyoPackageConfigurationSettingTextOptions;
 }
 /**
  * Represents a change event when a setting value is modified.

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

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

@@ -8,7 +8,8 @@ export declare enum EnergyAppPackageCategory {
     HeatPump = "heat-pump",
     BatteryStorage = "battery-storage",
     ClimateControl = "climate-control",
-    ElectricityTariff = "electricity-tariff"
+    DynamicElectricityTariff = "dynamic-electricity-tariff",
+    StaticElectricityTariff = "static-electricity-tariff"
 }
 /**
  * Configuration options for restricting internet access in an Energy App package.

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

@@ -8,7 +8,8 @@ export var EnergyAppPackageCategory;
     EnergyAppPackageCategory["HeatPump"] = "heat-pump";
     EnergyAppPackageCategory["BatteryStorage"] = "battery-storage";
     EnergyAppPackageCategory["ClimateControl"] = "climate-control";
-    EnergyAppPackageCategory["ElectricityTariff"] = "electricity-tariff";
+    EnergyAppPackageCategory["DynamicElectricityTariff"] = "dynamic-electricity-tariff";
+    EnergyAppPackageCategory["StaticElectricityTariff"] = "static-electricity-tariff";
 })(EnergyAppPackageCategory || (EnergyAppPackageCategory = {}));
 /**
  * Defines an Energy App package with automatic SDK version injection.

package/dist/packages/energy-app-electricity-tariff.d.ts

@@ -21,7 +21,9 @@ export interface EnergyAppElectricityTariff {
      *
      * @returns Promise that resolves to an array of all registered tariffs with default indicators
      */
-    getAllTariffs(): Promise<EnyoElectricityTariffWithDefault[]>;
+    getAllTariffs(filter?: {
+        myTariffs?: boolean;
+    }): Promise<EnyoElectricityTariffWithDefault[]>;
     /**
      * Removes an electricity tariff by its ID.
      * If the tariff does not exist, this operation is a no-op.
@@ -40,5 +42,15 @@ export interface EnergyAppElectricityTariff {
     findTariff(filter: {
         applianceId?: string;
         tariffId?: string;
+        externalTariffId?: string;
     }): Promise<EnyoElectricityTariffWithDefault | null>;
+    /**
+     * Partially updates an existing electricity tariff.
+     * Only the provided attributes will be modified; all other fields remain unchanged.
+     *
+     * @param id - The unique identifier of the tariff to update
+     * @param attributes - A partial set of tariff fields to update (excluding `id`)
+     * @returns Promise that resolves to the full updated tariff with its default indicator
+     */
+    updateTariff(id: string, attributes: Partial<Omit<EnyoElectricityTariff, 'id'>>): Promise<EnyoElectricityTariffWithDefault>;
 }

package/dist/packages/energy-app-pv-system.d.ts

@@ -30,7 +30,7 @@ export interface EnergyAppPvSystem {
      * console.log(`Registered PV system: ${pvSystem.pvSystemId}`);
      * ```
      */
-    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id'>): Promise<EnyoPvSystem>;
+    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id' | 'createdBy'>): Promise<EnyoPvSystem>;
     /**
      * Retrieves a registered PV system by its ID.
      *
@@ -58,7 +58,7 @@ export interface EnergyAppPvSystem {
      * });
      * ```
      */
-    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id'>>): Promise<EnyoPvSystem>;
+    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id' | 'createdBy'>>): Promise<EnyoPvSystem>;
     /**
      * Removes a registered PV system by its ID.
      * If the PV system does not exist, this operation is a no-op.

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

@@ -591,14 +591,24 @@ export interface EnyoDataBusPreviewChargingScheduleResponseV1 extends EnyoDataBu
         requestId: string;
         /** Whether a preview charging schedule is available */
         available: boolean;
-        /** The preview charging schedule (only present if available=true) */
-        schedule?: PreviewChargingSchedule;
-        /** Cost comparison data (only present if requested and available) */
-        costComparison?: PreviewChargingScheduleCostComparison;
+        /** Preview charging schedule and cost comparison per charging mode. Each entry's costComparison compares against immediate charging. Only present if available=true. */
+        chargingModeResults?: PreviewChargingScheduleModeResult[];
         /** Reason why preview is not available (only present if available=false) */
         unavailableReason?: PreviewChargingScheduleUnavailableReasonEnum;
     };
 }
+/**
+ * Result for a single charging mode in a preview charging schedule response.
+ * Contains the schedule and optional cost comparison for one specific charging mode.
+ */
+export interface PreviewChargingScheduleModeResult {
+    /** The charging mode this result represents */
+    chargeMode: EnyoChargeModeEnum;
+    /** The preview charging schedule for this mode */
+    schedule: PreviewChargingSchedule;
+    /** Cost comparison of this mode vs immediate charging (only present if cost data is available) */
+    costComparison?: PreviewChargingScheduleCostComparison;
+}
 /**
  * Message for delivering PV production forecast data.
  * Contains forecasted power and energy values in 15-minute intervals.

package/dist/types/enyo-electricity-tariff.d.ts

@@ -65,6 +65,8 @@ export interface EnyoElectricityTariff {
     timeVariableTariffData?: TimeVariableTariffData;
     /** Optional dynamic pricing data*/
     dynamicTariffData?: DynamicTariffData;
+    /** Optional external tariff id for easy identification */
+    externalTariffId?: string;
 }
 /**
  * Tariff registration data extended with default indicator.

package/dist/types/enyo-energy-prices.d.ts

@@ -8,8 +8,6 @@ export interface EnyoEnergyPrices {
     type: ElectricityTariffTypeEnum;
     /** Pricing data structure */
     prices: EnyoEnergyPriceEntry[];
-    /** Timestamp when this tariff information was last updated */
-    lastUpdatedIso: string;
 }
 export interface EnyoEnergyPriceEntry {
     /** Start time of this 15-minute interval in ISO format */

package/dist/types/enyo-pv-system.d.ts

@@ -53,6 +53,16 @@ export interface PvSystemDcString {
     /** Source of the orientation information (user-provided or estimated) */
     orientationSource?: PvSystemOrientationSourceEnum;
 }
+/**
+ * Feed-in tariff configuration for a PV system.
+ * Defines the price for grid feed-in and behavior during negative market prices.
+ */
+export interface PvSystemFeedInTariff {
+    /** Price per kWh received for feeding electricity into the grid */
+    gridFeedInPricePerKwh: number;
+    /** Whether feed-in refund is disabled when the market price is negative */
+    noFeedInRefundOnNegativeMarketPrice: boolean;
+}
 /**
  * Registration data for a PV system.
  */
@@ -69,4 +79,6 @@ export interface EnyoPvSystem {
     appliances?: PvSystemAppliance[];
     /** Optional feature flags for this PV system */
     features?: PvSystemFeatureEnum[];
+    /** Optional feed-in tariff configuration for this PV system */
+    feedInTariff?: PvSystemFeedInTariff;
 }

package/dist/types/enyo-settings.d.ts

@@ -16,6 +16,18 @@ export interface EnyoPackageConfigurationSettingSelectOption {
     /** The displayed name of the option */
     optionName: EnyoPackageConfigurationTranslatedValue[];
 }
+export interface EnyoPackageConfigurationSettingFloatOptions {
+    maxValue?: number;
+    minValue?: number;
+    step?: number;
+}
+export interface EnyoPackageConfigurationSettingIntegerOptions {
+    maxValue?: number;
+    minValue?: number;
+}
+export interface EnyoPackageConfigurationSettingTextOptions {
+    maxLength?: number;
+}
 /**
  * Represents a single configuration setting for an Energy App package.
  */
@@ -23,7 +35,7 @@ export interface EnyoPackageConfigurationSetting {
     /** internal name of the setting - must be unique */
     name: string;
     /** the type of the setting */
-    type: 'text' | 'select';
+    type: 'text' | 'select' | 'float' | 'integer' | 'checkbox';
     /** if the setting is required */
     required: boolean;
     /** The displayed name of the field */
@@ -35,11 +47,9 @@ export interface EnyoPackageConfigurationSetting {
     /** Optional appliance ID. If provided, setting is for specific appliance. If omitted, setting is for the whole package */
     applianceId?: string;
     selectOptions?: EnyoPackageConfigurationSettingSelectOption[];
-}
-/**
- * Configuration container for Energy App package settings.
- */
-export interface EnyoPackageConfiguration {
+    floatOptions?: EnyoPackageConfigurationSettingFloatOptions;
+    integerOptions?: EnyoPackageConfigurationSettingIntegerOptions;
+    textOptions?: EnyoPackageConfigurationSettingTextOptions;
 }
 /**
  * Represents a change event when a setting value is modified.

package/dist/version.d.ts

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