@enyo-energy/energy-app-sdk 0.0.61 → 0.0.63

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

@@ -10,7 +10,7 @@ import { EnergyAppVehicle } from "./packages/energy-app-vehicle.cjs";
 import { EnergyAppChargingCard } from "./packages/energy-app-charging-card.cjs";
 import { EnergyAppAuthentication } from "./packages/energy-app-authentication.cjs";
 import { EnergyAppSettings } from "./packages/energy-app-settings.cjs";
-import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.cjs";
+import { EnergyAppEnergyPrices } from "./packages/energy-app-energy-prices.cjs";
 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";
@@ -22,6 +22,7 @@ import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-ta
 import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.cjs";
 import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.cjs";
 import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.cjs";
+import { EnergyAppSequenceGenerator } from "./packages/energy-app-sequence-generator.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -71,7 +72,7 @@ export interface EnyoEnergyAppSdk {
     /** Get the Settings API */
     useSettings: () => EnergyAppSettings;
     /** Get the Electricity Prices API */
-    useElectricityPrices: () => EnergyAppElectricityPrices;
+    useElectricityPrices: () => EnergyAppEnergyPrices;
     /** Get the Notification API */
     useNotification: () => EnergyAppNotification;
     /** Get the Secret Manager API */
@@ -92,4 +93,6 @@ export interface EnyoEnergyAppSdk {
     usePvForecasting: () => EnergyAppPvForecasting;
     /** Get the PV System API for managing PV system registrations and configurations */
     usePvSystem: () => EnergyAppPvSystem;
+    /** Get the Sequence Generator API for generating unique sequential numbers per named sequence */
+    useSequenceGenerator: () => EnergyAppSequenceGenerator;
 }

package/dist/cjs/index.cjs

@@ -23,8 +23,7 @@ __exportStar(require("./implementations/ocpp/ocpp201.cjs"), exports);
 __exportStar(require("./implementations/ocpp/ocpp-common.cjs"), exports);
 __exportStar(require("./types/enyo-authentication.cjs"), exports);
 __exportStar(require("./types/enyo-settings.cjs"), exports);
-__exportStar(require("./types/enyo-energy-tariff.cjs"), exports);
-__exportStar(require("./types/enyo-electricity-prices.cjs"), exports);
+__exportStar(require("./types/enyo-energy-prices.cjs"), exports);
 __exportStar(require("./types/enyo-notification.cjs"), exports);
 __exportStar(require("./types/enyo-secret-manager.cjs"), exports);
 __exportStar(require("./types/enyo-location.cjs"), exports);
@@ -43,6 +42,7 @@ __exportStar(require("./packages/energy-app-pv-forecasting.cjs"), exports);
 __exportStar(require("./types/enyo-pv-system.cjs"), exports);
 __exportStar(require("./packages/energy-app-pv-system.cjs"), exports);
 __exportStar(require("./implementations/data-bus/data-bus-command-handler.cjs"), exports);
+__exportStar(require("./packages/energy-app-sequence-generator.cjs"), exports);
 class EnergyApp {
     energyAppSdk;
     constructor() {
@@ -191,6 +191,14 @@ class EnergyApp {
     usePvSystem() {
         return this.energyAppSdk.usePvSystem();
     }
+    /**
+     * Gets the Sequence Generator API for generating unique sequential numbers per named sequence.
+     * Each sequence is identified by a string name and maintains its own independent counter.
+     * @returns The Sequence Generator API instance
+     */
+    useSequenceGenerator() {
+        return this.energyAppSdk.useSequenceGenerator();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/index.d.cts

@@ -11,7 +11,7 @@ import { EnergyAppChargingCard } from "./packages/energy-app-charging-card.cjs";
 import { EnergyAppCharge } from "./packages/energy-app-charge.cjs";
 import { EnergyAppAuthentication } from "./packages/energy-app-authentication.cjs";
 import { EnergyAppSettings } from "./packages/energy-app-settings.cjs";
-import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.cjs";
+import { EnergyAppEnergyPrices } from "./packages/energy-app-energy-prices.cjs";
 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";
@@ -23,6 +23,7 @@ import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-ta
 import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.cjs";
 import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.cjs";
 import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.cjs";
+import { EnergyAppSequenceGenerator } from "./packages/energy-app-sequence-generator.cjs";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -30,8 +31,7 @@ export * from './implementations/ocpp/ocpp201.cjs';
 export * from './implementations/ocpp/ocpp-common.cjs';
 export * from './types/enyo-authentication.cjs';
 export * from './types/enyo-settings.cjs';
-export * from './types/enyo-energy-tariff.cjs';
-export * from './types/enyo-electricity-prices.cjs';
+export * from './types/enyo-energy-prices.cjs';
 export * from './types/enyo-notification.cjs';
 export * from './types/enyo-secret-manager.cjs';
 export * from './types/enyo-location.cjs';
@@ -50,6 +50,7 @@ export * from './packages/energy-app-pv-forecasting.cjs';
 export * from './types/enyo-pv-system.cjs';
 export * from './packages/energy-app-pv-system.cjs';
 export * from './implementations/data-bus/data-bus-command-handler.cjs';
+export * from './packages/energy-app-sequence-generator.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();
@@ -70,7 +71,7 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
     useCharge(): EnergyAppCharge;
     useAuthentication(): EnergyAppAuthentication;
     useSettings(): EnergyAppSettings;
-    useElectricityPrices(): EnergyAppElectricityPrices;
+    useElectricityPrices(): EnergyAppEnergyPrices;
     useNotification(): EnergyAppNotification;
     useOnboarding(): EnergyAppOnboarding;
     /**
@@ -125,6 +126,12 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The PV System API instance
      */
     usePvSystem(): EnergyAppPvSystem;
+    /**
+     * Gets the Sequence Generator API for generating unique sequential numbers per named sequence.
+     * Each sequence is identified by a string name and maintains its own independent counter.
+     * @returns The Sequence Generator API instance
+     */
+    useSequenceGenerator(): EnergyAppSequenceGenerator;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -1,4 +1,4 @@
-import { ElectricityTariffRegistration, ElectricityTariffWithDefault } from "../types/enyo-electricity-tariff.cjs";
+import { EnyoElectricityTariff, EnyoElectricityTariffWithDefault } from "../types/enyo-electricity-tariff.cjs";
 /**
  * Interface for managing electricity tariffs.
  * Provides methods to register, retrieve, and remove electricity tariffs
@@ -13,7 +13,7 @@ export interface EnergyAppElectricityTariff {
      * @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>;
+    registerTariff(tariff: EnyoElectricityTariff): Promise<void>;
     /**
      * Retrieves all registered electricity tariffs.
      * Each tariff includes a defaultTariff boolean indicating whether
@@ -21,7 +21,7 @@ export interface EnergyAppElectricityTariff {
      *
      * @returns Promise that resolves to an array of all registered tariffs with default indicators
      */
-    getAllTariffs(): Promise<ElectricityTariffWithDefault[]>;
+    getAllTariffs(): Promise<EnyoElectricityTariffWithDefault[]>;
     /**
      * Removes an electricity tariff by its ID.
      * If the tariff does not exist, this operation is a no-op.
@@ -30,4 +30,15 @@ export interface EnergyAppElectricityTariff {
      * @returns Promise that resolves when the tariff has been removed
      */
     removeTariff(tariffId: string): Promise<void>;
+    /**
+     * 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<EnyoElectricityTariff | null>;
+    findTariff(filter: {
+        applianceId?: string;
+        tariffId?: string;
+    }): Promise<EnyoElectricityTariff | null>;
 }

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

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

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

@@ -0,0 +1,35 @@
+import { EnyoEnergyPriceEntry, EnyoEnergyPrices } from "../types/enyo-energy-prices.cjs";
+/**
+ * Interface for retrieving electricity price information.
+ * Provides methods to get current and forecast electricity prices,
+ * always normalized to 15-minute intervals regardless of source data resolution.
+ */
+export interface EnergyAppEnergyPrices {
+    /**
+     * Retrieves electricity prices for a specified time range.
+     * The response always contains prices in 15-minute intervals,
+     * interpolated from the original data source (constant, 15min, or 1hr intervals).
+     *
+     * @param request - The price request parameters including time range and optional appliance ID
+     * @returns Promise that resolves to electricity prices for the requested time range
+     */
+    getPrices(request: EnergyAppEnergyPricesFilter): Promise<EnyoEnergyPrices>;
+    /**
+     * Retrieves the current electricity price for the current 15-minute interval.
+     * This is a convenience method that gets the price for "now".
+     *
+     * @param applianceId - Optional appliance ID to get appliance-specific pricing
+     * @returns Promise that resolves to current price information, or null if no pricing data is available
+     */
+    getCurrentPrice(applianceId?: string): Promise<EnyoEnergyPriceEntry | null>;
+}
+export interface EnergyAppEnergyPricesFilter {
+    /** Start time for price data in ISO format */
+    fromIso: string;
+    /** End time for price data in ISO format */
+    untilIso: string;
+    /** Optional appliance ID to get appliance-specific pricing */
+    applianceId?: string;
+    /** Optional tariff ID to use for pricing. If omitted, uses the default tariff */
+    tariffId?: string;
+}

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

@@ -1,4 +1,4 @@
-import { PvSystemRegistration, PvSystemInfo } from "../types/enyo-pv-system.cjs";
+import { EnyoPvSystem } from "../types/enyo-pv-system.cjs";
 /**
  * Interface for managing PV systems.
  * Allows energy apps to register, retrieve, update, and remove PV system configurations
@@ -30,21 +30,21 @@ export interface EnergyAppPvSystem {
      * console.log(`Registered PV system: ${pvSystem.pvSystemId}`);
      * ```
      */
-    registerPvSystem(pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id'>): Promise<EnyoPvSystem>;
     /**
      * Retrieves a registered PV system by its ID.
      *
-     * @param pvSystemId - The unique identifier of the PV system
+     * @param id - The unique identifier of the PV system
      * @returns Promise that resolves to the PV system info, or null if not found
      */
-    getPvSystem(pvSystemId: string): Promise<PvSystemInfo | null>;
+    findPvSystem(id: string): Promise<EnyoPvSystem | null>;
     /**
      * Updates an existing PV system configuration.
      * Allows changing the kWp, DC string configurations, appliances, and features
      * of a registered PV system.
      *
-     * @param pvSystemId - The unique identifier of the PV system to update
-     * @param pvSystem - The updated PV system registration data
+     * @param id - The unique identifier of the PV system to update
+     * @param attributes - The updated PV system registration data
      * @returns Promise that resolves to the updated PV system info
      *
      * @example
@@ -58,13 +58,14 @@ export interface EnergyAppPvSystem {
      * });
      * ```
      */
-    updatePvSystem(pvSystemId: string, pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id'>>): Promise<EnyoPvSystem>;
     /**
      * Removes a registered PV system by its ID.
      * If the PV system does not exist, this operation is a no-op.
      *
-     * @param pvSystemId - The unique identifier of the PV system to remove
+     * @param id - The unique identifier of the PV system to remove
      * @returns Promise that resolves when the PV system has been removed
      */
-    removePvSystem(pvSystemId: string): Promise<void>;
+    removePvSystem(id: string): Promise<void>;
+    getPvSystems(): Promise<EnyoPvSystem[]>;
 }

package/dist/cjs/packages/energy-app-sequence-generator.cjs

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

package/dist/cjs/packages/energy-app-sequence-generator.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Interface for generating unique sequential numbers per named sequence.
+ * Each sequence is identified by a string name and maintains its own independent counter.
+ */
+export interface EnergyAppSequenceGenerator {
+    /**
+     * Returns the next unique number for the given sequence.
+     * Each sequence maintains its own independent counter.
+     *
+     * @param sequenceName - The name identifying the sequence
+     * @returns Promise resolving to the next unique number in the sequence
+     *
+     * @example
+     * const sequenceGenerator = energyApp.useSequenceGenerator();
+     * const id1 = await sequenceGenerator.next("invoice");  // e.g. 1
+     * const id2 = await sequenceGenerator.next("invoice");  // e.g. 2
+     * const id3 = await sequenceGenerator.next("order");    // e.g. 1 (different sequence)
+     */
+    next: (sequenceName: string) => Promise<number>;
+}

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

@@ -1,10 +1,10 @@
 import { EnyoApplianceStateEnum, EnyoApplianceTypeEnum } from "./enyo-appliance.cjs";
 import { EnyoSourceEnum } from "./enyo-source.enum.cjs";
-import { EnergyTariffInfo } from "./enyo-energy-tariff.cjs";
 import { EnyoOcppRelativeSchedule } from "./enyo-ocpp.cjs";
 import { EnyoChargerApplianceStatusEnum } from "./enyo-charger-appliance.cjs";
 import { PreviewChargingSchedule, PreviewChargingScheduleCostComparison, PreviewChargingScheduleUnavailableReasonEnum } from "./enyo-energy-manager.cjs";
 import { PvForecast } from "./enyo-pv-forecast.cjs";
+import { EnyoEnergyPrices } from "./enyo-energy-prices.cjs";
 export declare enum EnyoBatteryStateEnum {
     Off = "off",
     Empty = "empty",
@@ -507,7 +507,7 @@ export interface EnyoDataBusEnergyTariffUpdateV1 extends EnyoDataBusMessage {
     applianceId?: string;
     data: {
         /** Complete energy tariff information including pricing structure and validity */
-        tariffInfo: EnergyTariffInfo;
+        energyPrices: EnyoEnergyPrices;
     };
 }
 /**

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

@@ -9,12 +9,48 @@ export declare enum ElectricityTariffTypeEnum {
     /** Price changes dynamically based on market conditions */
     Dynamic = "dynamic"
 }
+/**
+ * Pricing data for a static (fixed-price) electricity tariff
+ */
+export interface StaticTariffData {
+    /** Price per kWh for consumption */
+    pricePerKwh: number;
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
+/**
+ * Pricing data for a dynamic electricity tariff
+ */
+export interface DynamicTariffData {
+    /** Price per kWh for grid fees */
+    gridFeePerKwh?: number;
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
+/**
+ * A single entry in a time-variable tariff schedule
+ */
+export interface TimeVariableScheduleEntry {
+    /** Relative start offset (e.g., minutes from start of day) */
+    start: number;
+    /** Price per kWh during this period */
+    pricePerKwh: number;
+}
+/**
+ * Pricing data for a time-variable electricity tariff
+ */
+export interface TimeVariableTariffData {
+    /** Schedule of time-based price entries */
+    schedule: TimeVariableScheduleEntry[];
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
 /**
  * Input data for registering or updating an electricity tariff
  */
-export interface ElectricityTariffRegistration {
+export interface EnyoElectricityTariff {
     /** Unique identifier for the tariff */
-    tariffId: string;
+    id: string;
     /** The pricing model type of this tariff */
     tariffType: ElectricityTariffTypeEnum;
     /** Human-readable name of the tariff */
@@ -23,12 +59,18 @@ export interface ElectricityTariffRegistration {
     vendorName: string;
     /** Optional ID of the primary meter appliance associated with this tariff */
     primaryMeterApplianceId?: string;
+    /** Optional static pricing data (relevant when tariffType is Static) */
+    staticTariffData?: StaticTariffData;
+    /** Optional time-variable pricing data (relevant when tariffType is TimeVariable) */
+    timeVariableTariffData?: TimeVariableTariffData;
+    /** Optional dynamic pricing data*/
+    dynamicTariffData?: DynamicTariffData;
 }
 /**
  * Tariff registration data extended with default indicator.
  * Used in list responses to indicate which tariff is the system default.
  */
-export interface ElectricityTariffWithDefault extends ElectricityTariffRegistration {
+export interface EnyoElectricityTariffWithDefault extends EnyoElectricityTariff {
     /** Indicates whether this tariff is the system default */
     defaultTariff: boolean;
 }

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

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

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

@@ -0,0 +1,22 @@
+import { ElectricityTariffTypeEnum } from "./enyo-electricity-tariff.cjs";
+/**
+ * Represents complete energy tariff information
+ */
+export interface EnyoEnergyPrices {
+    /** Unique identifier for this tariff */
+    tariffId: string;
+    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 */
+    timestampIso: string;
+    /** Price per kWh for electricity consumption during this interval */
+    consumptionPricePerKwh: number;
+    /** Optional price per kWh for grid feed-in during this interval */
+    feedInPricePerKwh?: number;
+    currency: string;
+}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PvSystemFeatureEnum = exports.PvOrientationEnum = void 0;
+exports.PvSystemFeatureEnum = exports.PvSystemCreatedBy = exports.PvSystemOrientationSourceEnum = exports.PvOrientationEnum = void 0;
 /**
  * Compass orientation for PV panel mounting direction.
  * Used to describe the azimuth orientation of DC strings.
@@ -16,6 +16,20 @@ var PvOrientationEnum;
     PvOrientationEnum["West"] = "west";
     PvOrientationEnum["NorthWest"] = "north-west";
 })(PvOrientationEnum || (exports.PvOrientationEnum = PvOrientationEnum = {}));
+/**
+ * Source of the orientation information for a DC string.
+ * Indicates whether the orientation was provided by the user or estimated automatically.
+ */
+var PvSystemOrientationSourceEnum;
+(function (PvSystemOrientationSourceEnum) {
+    PvSystemOrientationSourceEnum["UserProvided"] = "user";
+    PvSystemOrientationSourceEnum["Estimated"] = "estimated";
+})(PvSystemOrientationSourceEnum || (exports.PvSystemOrientationSourceEnum = PvSystemOrientationSourceEnum = {}));
+var PvSystemCreatedBy;
+(function (PvSystemCreatedBy) {
+    PvSystemCreatedBy["User"] = "user";
+    PvSystemCreatedBy["EnergyApp"] = "energy-app";
+})(PvSystemCreatedBy || (exports.PvSystemCreatedBy = PvSystemCreatedBy = {}));
 /**
  * Feature flags for a PV system.
  * Used to indicate special configurations or capabilities.

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

@@ -17,7 +17,14 @@ export declare enum PvOrientationEnum {
  * Source of the orientation information for a DC string.
  * Indicates whether the orientation was provided by the user or estimated automatically.
  */
-export type PvSystemOrientationSourceEnum = 'user' | 'estimated';
+export declare enum PvSystemOrientationSourceEnum {
+    UserProvided = "user",
+    Estimated = "estimated"
+}
+export declare enum PvSystemCreatedBy {
+    User = "user",
+    EnergyApp = "energy-app"
+}
 /**
  * Feature flags for a PV system.
  * Used to indicate special configurations or capabilities.
@@ -49,9 +56,13 @@ export interface PvSystemDcString {
 /**
  * Registration data for a PV system.
  */
-export interface PvSystemRegistration {
+export interface EnyoPvSystem {
+    /** Unique identifier of the registered PV system */
+    id: string;
     /** Peak power capacity of the entire PV system in kilowatts peak */
     kWp: number;
+    /** Indicates who created the PV system entry (user or energy app) */
+    createdBy: PvSystemCreatedBy;
     /** Array of DC strings describing the panel groups and their orientations */
     dcStrings: PvSystemDcString[];
     /** Optional list of appliances associated with this PV system */
@@ -59,12 +70,3 @@ export interface PvSystemRegistration {
     /** Optional feature flags for this PV system */
     features?: PvSystemFeatureEnum[];
 }
-/**
- * A registered PV system with its identifier and metadata.
- */
-export interface PvSystemInfo extends PvSystemRegistration {
-    /** Unique identifier of the registered PV system */
-    pvSystemId: string;
-    /** Timestamp when this PV system was registered in ISO format */
-    registeredAtIso: 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.61';
+exports.SDK_VERSION = '0.0.63';
 /**
  * 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.61";
+export declare const SDK_VERSION = "0.0.63";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

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

@@ -10,7 +10,7 @@ import { EnergyAppVehicle } from "./packages/energy-app-vehicle.js";
 import { EnergyAppChargingCard } from "./packages/energy-app-charging-card.js";
 import { EnergyAppAuthentication } from "./packages/energy-app-authentication.js";
 import { EnergyAppSettings } from "./packages/energy-app-settings.js";
-import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.js";
+import { EnergyAppEnergyPrices } from "./packages/energy-app-energy-prices.js";
 import { EnergyAppNotification } from "./packages/energy-app-notification.js";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.js";
 import { EnergyAppLocation } from "./packages/energy-app-location.js";
@@ -22,6 +22,7 @@ import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-ta
 import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.js";
 import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.js";
 import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.js";
+import { EnergyAppSequenceGenerator } from "./packages/energy-app-sequence-generator.js";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -71,7 +72,7 @@ export interface EnyoEnergyAppSdk {
     /** Get the Settings API */
     useSettings: () => EnergyAppSettings;
     /** Get the Electricity Prices API */
-    useElectricityPrices: () => EnergyAppElectricityPrices;
+    useElectricityPrices: () => EnergyAppEnergyPrices;
     /** Get the Notification API */
     useNotification: () => EnergyAppNotification;
     /** Get the Secret Manager API */
@@ -92,4 +93,6 @@ export interface EnyoEnergyAppSdk {
     usePvForecasting: () => EnergyAppPvForecasting;
     /** Get the PV System API for managing PV system registrations and configurations */
     usePvSystem: () => EnergyAppPvSystem;
+    /** Get the Sequence Generator API for generating unique sequential numbers per named sequence */
+    useSequenceGenerator: () => EnergyAppSequenceGenerator;
 }

package/dist/index.d.ts

@@ -11,7 +11,7 @@ import { EnergyAppChargingCard } from "./packages/energy-app-charging-card.js";
 import { EnergyAppCharge } from "./packages/energy-app-charge.js";
 import { EnergyAppAuthentication } from "./packages/energy-app-authentication.js";
 import { EnergyAppSettings } from "./packages/energy-app-settings.js";
-import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.js";
+import { EnergyAppEnergyPrices } from "./packages/energy-app-energy-prices.js";
 import { EnergyAppNotification } from "./packages/energy-app-notification.js";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.js";
 import { EnergyAppLocation } from "./packages/energy-app-location.js";
@@ -23,6 +23,7 @@ import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-ta
 import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.js";
 import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.js";
 import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.js";
+import { EnergyAppSequenceGenerator } from "./packages/energy-app-sequence-generator.js";
 export * from './energy-app-package-definition.js';
 export * from './version.js';
 export * from './implementations/ocpp/ocpp16.js';
@@ -30,8 +31,7 @@ export * from './implementations/ocpp/ocpp201.js';
 export * from './implementations/ocpp/ocpp-common.js';
 export * from './types/enyo-authentication.js';
 export * from './types/enyo-settings.js';
-export * from './types/enyo-energy-tariff.js';
-export * from './types/enyo-electricity-prices.js';
+export * from './types/enyo-energy-prices.js';
 export * from './types/enyo-notification.js';
 export * from './types/enyo-secret-manager.js';
 export * from './types/enyo-location.js';
@@ -50,6 +50,7 @@ export * from './packages/energy-app-pv-forecasting.js';
 export * from './types/enyo-pv-system.js';
 export * from './packages/energy-app-pv-system.js';
 export * from './implementations/data-bus/data-bus-command-handler.js';
+export * from './packages/energy-app-sequence-generator.js';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();
@@ -70,7 +71,7 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
     useCharge(): EnergyAppCharge;
     useAuthentication(): EnergyAppAuthentication;
     useSettings(): EnergyAppSettings;
-    useElectricityPrices(): EnergyAppElectricityPrices;
+    useElectricityPrices(): EnergyAppEnergyPrices;
     useNotification(): EnergyAppNotification;
     useOnboarding(): EnergyAppOnboarding;
     /**
@@ -125,6 +126,12 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The PV System API instance
      */
     usePvSystem(): EnergyAppPvSystem;
+    /**
+     * Gets the Sequence Generator API for generating unique sequential numbers per named sequence.
+     * Each sequence is identified by a string name and maintains its own independent counter.
+     * @returns The Sequence Generator API instance
+     */
+    useSequenceGenerator(): EnergyAppSequenceGenerator;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/index.js

@@ -6,8 +6,7 @@ export * from './implementations/ocpp/ocpp201.js';
 export * from './implementations/ocpp/ocpp-common.js';
 export * from './types/enyo-authentication.js';
 export * from './types/enyo-settings.js';
-export * from './types/enyo-energy-tariff.js';
-export * from './types/enyo-electricity-prices.js';
+export * from './types/enyo-energy-prices.js';
 export * from './types/enyo-notification.js';
 export * from './types/enyo-secret-manager.js';
 export * from './types/enyo-location.js';
@@ -26,6 +25,7 @@ export * from './packages/energy-app-pv-forecasting.js';
 export * from './types/enyo-pv-system.js';
 export * from './packages/energy-app-pv-system.js';
 export * from './implementations/data-bus/data-bus-command-handler.js';
+export * from './packages/energy-app-sequence-generator.js';
 export class EnergyApp {
     energyAppSdk;
     constructor() {
@@ -174,6 +174,14 @@ export class EnergyApp {
     usePvSystem() {
         return this.energyAppSdk.usePvSystem();
     }
+    /**
+     * Gets the Sequence Generator API for generating unique sequential numbers per named sequence.
+     * Each sequence is identified by a string name and maintains its own independent counter.
+     * @returns The Sequence Generator API instance
+     */
+    useSequenceGenerator() {
+        return this.energyAppSdk.useSequenceGenerator();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -1,4 +1,4 @@
-import { ElectricityTariffRegistration, ElectricityTariffWithDefault } from "../types/enyo-electricity-tariff.js";
+import { EnyoElectricityTariff, EnyoElectricityTariffWithDefault } from "../types/enyo-electricity-tariff.js";
 /**
  * Interface for managing electricity tariffs.
  * Provides methods to register, retrieve, and remove electricity tariffs
@@ -13,7 +13,7 @@ export interface EnergyAppElectricityTariff {
      * @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>;
+    registerTariff(tariff: EnyoElectricityTariff): Promise<void>;
     /**
      * Retrieves all registered electricity tariffs.
      * Each tariff includes a defaultTariff boolean indicating whether
@@ -21,7 +21,7 @@ export interface EnergyAppElectricityTariff {
      *
      * @returns Promise that resolves to an array of all registered tariffs with default indicators
      */
-    getAllTariffs(): Promise<ElectricityTariffWithDefault[]>;
+    getAllTariffs(): Promise<EnyoElectricityTariffWithDefault[]>;
     /**
      * Removes an electricity tariff by its ID.
      * If the tariff does not exist, this operation is a no-op.
@@ -30,4 +30,15 @@ export interface EnergyAppElectricityTariff {
      * @returns Promise that resolves when the tariff has been removed
      */
     removeTariff(tariffId: string): Promise<void>;
+    /**
+     * 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<EnyoElectricityTariff | null>;
+    findTariff(filter: {
+        applianceId?: string;
+        tariffId?: string;
+    }): Promise<EnyoElectricityTariff | null>;
 }

package/dist/packages/energy-app-energy-prices.d.ts

@@ -0,0 +1,35 @@
+import { EnyoEnergyPriceEntry, EnyoEnergyPrices } from "../types/enyo-energy-prices.js";
+/**
+ * Interface for retrieving electricity price information.
+ * Provides methods to get current and forecast electricity prices,
+ * always normalized to 15-minute intervals regardless of source data resolution.
+ */
+export interface EnergyAppEnergyPrices {
+    /**
+     * Retrieves electricity prices for a specified time range.
+     * The response always contains prices in 15-minute intervals,
+     * interpolated from the original data source (constant, 15min, or 1hr intervals).
+     *
+     * @param request - The price request parameters including time range and optional appliance ID
+     * @returns Promise that resolves to electricity prices for the requested time range
+     */
+    getPrices(request: EnergyAppEnergyPricesFilter): Promise<EnyoEnergyPrices>;
+    /**
+     * Retrieves the current electricity price for the current 15-minute interval.
+     * This is a convenience method that gets the price for "now".
+     *
+     * @param applianceId - Optional appliance ID to get appliance-specific pricing
+     * @returns Promise that resolves to current price information, or null if no pricing data is available
+     */
+    getCurrentPrice(applianceId?: string): Promise<EnyoEnergyPriceEntry | null>;
+}
+export interface EnergyAppEnergyPricesFilter {
+    /** Start time for price data in ISO format */
+    fromIso: string;
+    /** End time for price data in ISO format */
+    untilIso: string;
+    /** Optional appliance ID to get appliance-specific pricing */
+    applianceId?: string;
+    /** Optional tariff ID to use for pricing. If omitted, uses the default tariff */
+    tariffId?: string;
+}

package/dist/packages/energy-app-energy-prices.js

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

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

@@ -1,4 +1,4 @@
-import { PvSystemRegistration, PvSystemInfo } from "../types/enyo-pv-system.js";
+import { EnyoPvSystem } from "../types/enyo-pv-system.js";
 /**
  * Interface for managing PV systems.
  * Allows energy apps to register, retrieve, update, and remove PV system configurations
@@ -30,21 +30,21 @@ export interface EnergyAppPvSystem {
      * console.log(`Registered PV system: ${pvSystem.pvSystemId}`);
      * ```
      */
-    registerPvSystem(pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    registerPvSystem(pvSystem: Omit<EnyoPvSystem, 'id'>): Promise<EnyoPvSystem>;
     /**
      * Retrieves a registered PV system by its ID.
      *
-     * @param pvSystemId - The unique identifier of the PV system
+     * @param id - The unique identifier of the PV system
      * @returns Promise that resolves to the PV system info, or null if not found
      */
-    getPvSystem(pvSystemId: string): Promise<PvSystemInfo | null>;
+    findPvSystem(id: string): Promise<EnyoPvSystem | null>;
     /**
      * Updates an existing PV system configuration.
      * Allows changing the kWp, DC string configurations, appliances, and features
      * of a registered PV system.
      *
-     * @param pvSystemId - The unique identifier of the PV system to update
-     * @param pvSystem - The updated PV system registration data
+     * @param id - The unique identifier of the PV system to update
+     * @param attributes - The updated PV system registration data
      * @returns Promise that resolves to the updated PV system info
      *
      * @example
@@ -58,13 +58,14 @@ export interface EnergyAppPvSystem {
      * });
      * ```
      */
-    updatePvSystem(pvSystemId: string, pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    updatePvSystem(id: string, attributes: Partial<Omit<EnyoPvSystem, 'id'>>): Promise<EnyoPvSystem>;
     /**
      * Removes a registered PV system by its ID.
      * If the PV system does not exist, this operation is a no-op.
      *
-     * @param pvSystemId - The unique identifier of the PV system to remove
+     * @param id - The unique identifier of the PV system to remove
      * @returns Promise that resolves when the PV system has been removed
      */
-    removePvSystem(pvSystemId: string): Promise<void>;
+    removePvSystem(id: string): Promise<void>;
+    getPvSystems(): Promise<EnyoPvSystem[]>;
 }

package/dist/packages/energy-app-sequence-generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Interface for generating unique sequential numbers per named sequence.
+ * Each sequence is identified by a string name and maintains its own independent counter.
+ */
+export interface EnergyAppSequenceGenerator {
+    /**
+     * Returns the next unique number for the given sequence.
+     * Each sequence maintains its own independent counter.
+     *
+     * @param sequenceName - The name identifying the sequence
+     * @returns Promise resolving to the next unique number in the sequence
+     *
+     * @example
+     * const sequenceGenerator = energyApp.useSequenceGenerator();
+     * const id1 = await sequenceGenerator.next("invoice");  // e.g. 1
+     * const id2 = await sequenceGenerator.next("invoice");  // e.g. 2
+     * const id3 = await sequenceGenerator.next("order");    // e.g. 1 (different sequence)
+     */
+    next: (sequenceName: string) => Promise<number>;
+}

package/dist/packages/energy-app-sequence-generator.js

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

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

@@ -1,10 +1,10 @@
 import { EnyoApplianceStateEnum, EnyoApplianceTypeEnum } from "./enyo-appliance.js";
 import { EnyoSourceEnum } from "./enyo-source.enum.js";
-import { EnergyTariffInfo } from "./enyo-energy-tariff.js";
 import { EnyoOcppRelativeSchedule } from "./enyo-ocpp.js";
 import { EnyoChargerApplianceStatusEnum } from "./enyo-charger-appliance.js";
 import { PreviewChargingSchedule, PreviewChargingScheduleCostComparison, PreviewChargingScheduleUnavailableReasonEnum } from "./enyo-energy-manager.js";
 import { PvForecast } from "./enyo-pv-forecast.js";
+import { EnyoEnergyPrices } from "./enyo-energy-prices.js";
 export declare enum EnyoBatteryStateEnum {
     Off = "off",
     Empty = "empty",
@@ -507,7 +507,7 @@ export interface EnyoDataBusEnergyTariffUpdateV1 extends EnyoDataBusMessage {
     applianceId?: string;
     data: {
         /** Complete energy tariff information including pricing structure and validity */
-        tariffInfo: EnergyTariffInfo;
+        energyPrices: EnyoEnergyPrices;
     };
 }
 /**

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

@@ -9,12 +9,48 @@ export declare enum ElectricityTariffTypeEnum {
     /** Price changes dynamically based on market conditions */
     Dynamic = "dynamic"
 }
+/**
+ * Pricing data for a static (fixed-price) electricity tariff
+ */
+export interface StaticTariffData {
+    /** Price per kWh for consumption */
+    pricePerKwh: number;
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
+/**
+ * Pricing data for a dynamic electricity tariff
+ */
+export interface DynamicTariffData {
+    /** Price per kWh for grid fees */
+    gridFeePerKwh?: number;
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
+/**
+ * A single entry in a time-variable tariff schedule
+ */
+export interface TimeVariableScheduleEntry {
+    /** Relative start offset (e.g., minutes from start of day) */
+    start: number;
+    /** Price per kWh during this period */
+    pricePerKwh: number;
+}
+/**
+ * Pricing data for a time-variable electricity tariff
+ */
+export interface TimeVariableTariffData {
+    /** Schedule of time-based price entries */
+    schedule: TimeVariableScheduleEntry[];
+    /** Currency code (ISO 4217, e.g., 'EUR', 'USD') */
+    currency: string;
+}
 /**
  * Input data for registering or updating an electricity tariff
  */
-export interface ElectricityTariffRegistration {
+export interface EnyoElectricityTariff {
     /** Unique identifier for the tariff */
-    tariffId: string;
+    id: string;
     /** The pricing model type of this tariff */
     tariffType: ElectricityTariffTypeEnum;
     /** Human-readable name of the tariff */
@@ -23,12 +59,18 @@ export interface ElectricityTariffRegistration {
     vendorName: string;
     /** Optional ID of the primary meter appliance associated with this tariff */
     primaryMeterApplianceId?: string;
+    /** Optional static pricing data (relevant when tariffType is Static) */
+    staticTariffData?: StaticTariffData;
+    /** Optional time-variable pricing data (relevant when tariffType is TimeVariable) */
+    timeVariableTariffData?: TimeVariableTariffData;
+    /** Optional dynamic pricing data*/
+    dynamicTariffData?: DynamicTariffData;
 }
 /**
  * Tariff registration data extended with default indicator.
  * Used in list responses to indicate which tariff is the system default.
  */
-export interface ElectricityTariffWithDefault extends ElectricityTariffRegistration {
+export interface EnyoElectricityTariffWithDefault extends EnyoElectricityTariff {
     /** Indicates whether this tariff is the system default */
     defaultTariff: boolean;
 }

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

@@ -0,0 +1,22 @@
+import { ElectricityTariffTypeEnum } from "./enyo-electricity-tariff.js";
+/**
+ * Represents complete energy tariff information
+ */
+export interface EnyoEnergyPrices {
+    /** Unique identifier for this tariff */
+    tariffId: string;
+    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 */
+    timestampIso: string;
+    /** Price per kWh for electricity consumption during this interval */
+    consumptionPricePerKwh: number;
+    /** Optional price per kWh for grid feed-in during this interval */
+    feedInPricePerKwh?: number;
+    currency: string;
+}

package/dist/types/enyo-energy-prices.js

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

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

@@ -17,7 +17,14 @@ export declare enum PvOrientationEnum {
  * Source of the orientation information for a DC string.
  * Indicates whether the orientation was provided by the user or estimated automatically.
  */
-export type PvSystemOrientationSourceEnum = 'user' | 'estimated';
+export declare enum PvSystemOrientationSourceEnum {
+    UserProvided = "user",
+    Estimated = "estimated"
+}
+export declare enum PvSystemCreatedBy {
+    User = "user",
+    EnergyApp = "energy-app"
+}
 /**
  * Feature flags for a PV system.
  * Used to indicate special configurations or capabilities.
@@ -49,9 +56,13 @@ export interface PvSystemDcString {
 /**
  * Registration data for a PV system.
  */
-export interface PvSystemRegistration {
+export interface EnyoPvSystem {
+    /** Unique identifier of the registered PV system */
+    id: string;
     /** Peak power capacity of the entire PV system in kilowatts peak */
     kWp: number;
+    /** Indicates who created the PV system entry (user or energy app) */
+    createdBy: PvSystemCreatedBy;
     /** Array of DC strings describing the panel groups and their orientations */
     dcStrings: PvSystemDcString[];
     /** Optional list of appliances associated with this PV system */
@@ -59,12 +70,3 @@ export interface PvSystemRegistration {
     /** Optional feature flags for this PV system */
     features?: PvSystemFeatureEnum[];
 }
-/**
- * A registered PV system with its identifier and metadata.
- */
-export interface PvSystemInfo extends PvSystemRegistration {
-    /** Unique identifier of the registered PV system */
-    pvSystemId: string;
-    /** Timestamp when this PV system was registered in ISO format */
-    registeredAtIso: string;
-}

package/dist/types/enyo-pv-system.js

@@ -13,6 +13,20 @@ export var PvOrientationEnum;
     PvOrientationEnum["West"] = "west";
     PvOrientationEnum["NorthWest"] = "north-west";
 })(PvOrientationEnum || (PvOrientationEnum = {}));
+/**
+ * Source of the orientation information for a DC string.
+ * Indicates whether the orientation was provided by the user or estimated automatically.
+ */
+export var PvSystemOrientationSourceEnum;
+(function (PvSystemOrientationSourceEnum) {
+    PvSystemOrientationSourceEnum["UserProvided"] = "user";
+    PvSystemOrientationSourceEnum["Estimated"] = "estimated";
+})(PvSystemOrientationSourceEnum || (PvSystemOrientationSourceEnum = {}));
+export var PvSystemCreatedBy;
+(function (PvSystemCreatedBy) {
+    PvSystemCreatedBy["User"] = "user";
+    PvSystemCreatedBy["EnergyApp"] = "energy-app";
+})(PvSystemCreatedBy || (PvSystemCreatedBy = {}));
 /**
  * Feature flags for a PV system.
  * Used to indicate special configurations or capabilities.

package/dist/version.d.ts

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