@enyo-energy/energy-app-sdk 0.0.34

package/dist/packages/connect-interval.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Supported interval durations for scheduled tasks.
+ * Provides predefined time intervals from 1 second to 1 hour.
+ */
+export type IntervalDuration = '1s' | '10s' | '30s' | '1m' | '5m' | '1hr';
+/**
+ * Interface for managing scheduled intervals in Connect EMS packages.
+ * Provides functionality to create and manage recurring tasks.
+ */
+export interface ConnectInterval {
+    /** Create a new interval that executes the callback at the specified duration */
+    createInterval: (duration: IntervalDuration, callback: () => void) => string;
+    /** Stop an existing interval by its ID */
+    stopInterval: (intervalId: string) => void;
+}

package/dist/packages/connect-interval.js

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

package/dist/packages/connect-modbus.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration options for establishing a Modbus connection.
+ */
+export interface ModbusOptions {
+    /** Hostname or IP address of the Modbus server */
+    host: string;
+    /** Port number for the Modbus connection (default: 502) */
+    port?: number;
+    /** Connection timeout in milliseconds */
+    timeout?: number;
+    /** Modbus unit identifier for the target device */
+    unitId?: number;
+}
+/**
+ * Data structure for Modbus register operations.
+ */
+export interface ModbusRegisterData {
+    /** Register address */
+    address: number;
+    /** Register value(s) - single number or array for multiple registers */
+    value: number | number[];
+}
+/**
+ * Data structure for Modbus coil operations.
+ */
+export interface ModbusCoilData {
+    /** Coil address */
+    address: number;
+    /** Coil value(s) - single boolean or array for multiple coils */
+    value: boolean | boolean[];
+}
+/**
+ * Interface for Modbus TCP/IP communication in Connect EMS packages.
+ * Provides comprehensive Modbus client functionality for reading and writing
+ * coils, discrete inputs, holding registers, and input registers.
+ */
+export interface ConnectModbus {
+    /** Establish connection to a Modbus server */
+    connect: (options: ModbusOptions) => Promise<void>;
+    /** Close the Modbus connection */
+    disconnect: () => Promise<void>;
+    /** Check if currently connected to a Modbus server */
+    isConnected: () => boolean;
+    /** Read coil values from the specified address range */
+    readCoils: (address: number, quantity: number) => Promise<boolean[]>;
+    /** Read discrete input values from the specified address range */
+    readDiscreteInputs: (address: number, quantity: number) => Promise<boolean[]>;
+    /** Read holding register values from the specified address range */
+    readHoldingRegisters: (address: number, quantity: number) => Promise<number[]>;
+    /** Read input register values from the specified address range */
+    readInputRegisters: (address: number, quantity: number) => Promise<number[]>;
+    /** Write a single coil value to the specified address */
+    writeSingleCoil: (address: number, value: boolean) => Promise<void>;
+    /** Write a single register value to the specified address */
+    writeSingleRegister: (address: number, value: number) => Promise<void>;
+    /** Write multiple coil values starting from the specified address */
+    writeMultipleCoils: (address: number, values: boolean[]) => Promise<void>;
+    /** Write multiple register values starting from the specified address */
+    writeMultipleRegisters: (address: number, values: number[]) => Promise<void>;
+}

package/dist/packages/connect-modbus.js

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

package/dist/packages/connect-network-devices.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Represents a detected network device with its connectivity information.
+ */
+export interface NetworkDevice {
+    /** Unique identifier for the device */
+    id: string;
+    /** Network hostname of the device */
+    hostname: string;
+    /** IP address of the device */
+    ipAddress: string;
+    /** MAC address of the device (if available) */
+    macAddress?: string;
+    /** Whether the device is currently online */
+    isOnline: boolean;
+    /** Timestamp when the device was last seen */
+    lastSeen: Date;
+    /** List of open network ports on the device */
+    ports?: NetworkPort[];
+}
+/**
+ * Represents an open network port on a device.
+ */
+export interface NetworkPort {
+    /** Port number */
+    port: number;
+    /** Service name running on the port (if detected) */
+    service?: string;
+}
+/**
+ * Interface for network device discovery and management in Connect EMS packages.
+ * Provides functionality to detect and interact with devices on the local network.
+ */
+export interface ConnectNetworkDevices {
+    /** Get list of all previously detected network devices */
+    getDetectedDevices: () => Promise<NetworkDevice[]>;
+    /** Get a specific device by its unique ID */
+    getDevice: (deviceId: string) => Promise<NetworkDevice | null>;
+    /** Trigger an asynchronous search for new devices on the network */
+    searchDevices: () => Promise<NetworkDevice[]>;
+}

package/dist/packages/connect-network-devices.js

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

package/dist/packages/connect-storage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Interface for persistent storage operations in Connect EMS packages.
+ * Provides key-value storage capabilities for package data persistence.
+ */
+export interface ConnectStorage {
+    /** Save an object to storage with the specified key */
+    save: (key: string, value: object) => Promise<void>;
+    /** Load an object from storage by key, returns null if not found */
+    load: (key: string) => Promise<object | null>;
+    /** Remove an object from storage by key */
+    remove: (key: string) => Promise<void>;
+    /** Returns a list of all keys stored in the storage */
+    listKeys: () => Promise<string[]>;
+}

package/dist/packages/connect-storage.js

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

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

@@ -0,0 +1,17 @@
+import { EnyoAppliance } from "../types/enyo-appliance.js";
+/**
+ * Interface for managing appliances in enyo packages.
+ * Provides CRUD operations for appliance registration and management.
+ */
+export interface EnergyAppAppliance {
+    /** Save or update an appliance in the system */
+    save: (appliance: Omit<EnyoAppliance, 'id'>, applianceId: string | undefined) => Promise<string>;
+    /** Get a list of all registered appliances of your package */
+    list: () => Promise<EnyoAppliance[]>;
+    /** Get a list of all appliances. Needs a specific permission */
+    listAll: () => Promise<EnyoAppliance[]>;
+    /** Get a specific appliance by its ID */
+    getById: (id: string) => Promise<EnyoAppliance | null>;
+    /** Remove an appliance by its ID */
+    removeById: (id: string) => Promise<void>;
+}

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

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

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

@@ -0,0 +1,52 @@
+import { EnyoAuthenticateState, EnyoAuthentication, EnyoAuthenticationResponse, EnyoOauthAuthenticationParameters, EnyoOauthAuthenticationRedirectUrlResponse } from "../types/enyo-authentication.js";
+/**
+ * Interface for requesting user authentication for appliances or the entire package.
+ * Provides methods to handle authentication requests, listen for responses, and manage authentication state.
+ */
+export interface EnergyAppAuthentication {
+    /**
+     * Requests user authentication for an appliance or the entire package.
+     * The user will receive a notification to authenticate. This operation might take time.
+     *
+     * @param authentication - The authentication configuration containing type, credentials setup, and optional appliance ID
+     * @returns Promise that resolves to the request ID for tracking the authentication process
+     */
+    requestAuthentication(authentication: EnyoAuthentication): Promise<string>;
+    /**
+     * If you use oauth with clientIdName and clientSecretName, you need to listen to this and respond with the redirect url
+     */
+    listenForOauthParameters(listener: (response: EnyoOauthAuthenticationParameters) => Promise<EnyoOauthAuthenticationRedirectUrlResponse>): string;
+    /**
+     * Adds a listener for authentication responses.
+     * The listener will be called when the user completes the authentication process.
+     *
+     * @param listener - Callback function that receives the authentication response and should return the authentication state
+     * @returns The listener ID for removing the listener later
+     */
+    listenForAuthenticationResponse(listener: (response: EnyoAuthenticationResponse) => Promise<EnyoAuthenticateState>): string;
+    /**
+     * Removes a previously registered authentication response listener.
+     *
+     * @param listenerId - The ID of the listener to remove
+     */
+    removeListener: (listenerId: string) => void;
+    /**
+     * Adds a listener for user-initiated sign-out events.
+     * The listener will be called when the user manually signs out.
+     *
+     * @param listener - Callback function called when user signs out
+     * @returns The listener ID for removing the listener later
+     */
+    listenForSignOut(listener: () => void): string;
+    /**
+     * Gets the current authentication state.
+     *
+     * @returns Promise that resolves to the current authentication state
+     */
+    getAuthenticationState(): Promise<EnyoAuthenticateState>;
+    /**
+     * Signs the user out and updates the authentication state.
+     * This will trigger any registered sign-out listeners.
+     */
+    signOut(): void;
+}

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

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

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

@@ -0,0 +1,13 @@
+import { EnyoCharge, EnyoChargeFilter } from "../types/enyo-charge.js";
+/**
+ * Interface for managing charging sessions in enyo packages.
+ * Provides operations for charge session tracking and management.
+ */
+export interface EnergyAppCharge {
+    /** Save or update a charging session in the system */
+    save: (charge: Omit<EnyoCharge, 'id'>, chargeId?: string) => Promise<void>;
+    /** Get a list of charging sessions with optional filtering */
+    list: (filter?: EnyoChargeFilter) => Promise<EnyoCharge[]>;
+    /** Get a specific charging session by its ID */
+    getById: (id: string) => Promise<EnyoCharge | null>;
+}

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

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

package/dist/packages/energy-app-charging-card.d.ts

@@ -0,0 +1,11 @@
+import { EnyoChargingCard } from "../types/enyo-charging-card.js";
+/**
+ * Interface for managing charging cards in enyo packages.
+ * Provides read-only operations for charging card information.
+ */
+export interface EnergyAppChargingCard {
+    /** Get a list of all registered charging cards */
+    list: () => Promise<EnyoChargingCard[]>;
+    /** Get a specific charging card by its ID */
+    getById: (id: string) => Promise<EnyoChargingCard | null>;
+}

package/dist/packages/energy-app-charging-card.js

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

package/dist/packages/energy-app-data-bus.d.ts

@@ -0,0 +1,12 @@
+import { EnyoDataBusMessage, EnyoDataBusMessageAnswer, EnyoDataBusMessageEnum } from "../types/enyo-data-bus-value.js";
+/**
+ * Interface for interaction with the Data Bus to send data or listen for changes
+ */
+export interface EnergyAppDataBus {
+    sendMessage: (messages: EnyoDataBusMessage[], options?: EnergyAppDataBusSendDataOptions) => void;
+    sendAnswer: (answer: EnyoDataBusMessageAnswer, options?: EnergyAppDataBusSendDataOptions) => void;
+    listenForMessages: (types: EnyoDataBusMessageEnum[], listener: (entry: EnyoDataBusMessage) => void) => string;
+    unsubscribe: (listenerId: string) => void;
+}
+export interface EnergyAppDataBusSendDataOptions {
+}

package/dist/packages/energy-app-data-bus.js

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

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

@@ -0,0 +1,59 @@
+import { ElectricityPriceRequest, ElectricityPriceResponse, ElectricityPriceUpdate } from "../types/enyo-electricity-prices.js";
+import { EnergyTariffInfo } from "../types/enyo-energy-tariff.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 EnergyAppElectricityPrices {
+    /**
+     * 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: ElectricityPriceRequest): Promise<ElectricityPriceResponse>;
+    /**
+     * Retrieves the current active tariff information.
+     * This includes tariff metadata, provider information, and pricing structure details.
+     *
+     * @param applianceId - Optional appliance ID to get appliance-specific tariff. If omitted, returns system-wide tariff
+     * @returns Promise that resolves to current tariff information, or null if no tariff is configured
+     */
+    getCurrentTariff(applianceId?: string): Promise<EnergyTariffInfo | null>;
+    /**
+     * Registers a listener for real-time electricity price updates.
+     * The listener will be called when tariffs change, prices are updated, or new forecasts become available.
+     *
+     * @param listener - Callback function that will be called when price updates occur
+     * @returns Listener ID that can be used to remove the listener later
+     */
+    listenForPriceUpdates(listener: (update: ElectricityPriceUpdate) => void): string;
+    /**
+     * Removes a previously registered price update listener.
+     *
+     * @param listenerId - The ID of the listener to remove
+     */
+    removeListener(listenerId: string): void;
+    /**
+     * 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<ElectricityPriceEntry | null>;
+}
+/**
+ * Represents a single electricity price entry for convenience methods
+ */
+export interface ElectricityPriceEntry {
+    /** 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;
+}

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Supported interval durations for scheduled tasks.
+ * Provides predefined time intervals from 1 second to 1 hour.
+ */
+export type IntervalDuration = '10s' | '30s' | '1m' | '5m' | '1hr';
+/**
+ * Interface for managing scheduled intervals in enyo packages.
+ * Provides functionality to create and manage recurring tasks.
+ */
+export interface EnergyAppInterval {
+    /** Create a new interval that executes the callback at the specified duration */
+    createInterval: (duration: IntervalDuration, callback: (clockId: string) => void) => string;
+    /** Stop an existing interval by its ID */
+    stopInterval: (intervalId: string) => void;
+}

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * Configuration options for establishing a Modbus connection.
+ */
+export interface ModbusOptions {
+    /** Hostname or IP address of the Modbus server */
+    host: string;
+    /** Port number for the Modbus connection (default: 502) */
+    port?: number;
+    /** Connection timeout in milliseconds */
+    timeout?: number;
+    /** Modbus unit identifier for the target device */
+    unitId?: number;
+}
+/**
+ * Interface for Modbus TCP/IP communication in enyo packages.
+ * Provides comprehensive Modbus client functionality for reading and writing
+ * coils, discrete inputs, holding registers, and input registers.
+ */
+export interface EnergyAppModbus {
+    /** Establish connection to a Modbus server */
+    connect: (options: ModbusOptions) => Promise<EnergyAppModbusInstance>;
+}
+export interface EnergyAppModbusInstance {
+    /** Close the Modbus connection */
+    disconnect: () => Promise<void>;
+    /** Check if currently connected to a Modbus server */
+    isConnected: () => boolean;
+    /** Read coil values from the specified address range */
+    readCoils: (address: number, quantity: number) => Promise<boolean[]>;
+    /** Read discrete input values from the specified address range */
+    readDiscreteInputs: (address: number, quantity: number) => Promise<boolean[]>;
+    /** Read holding register values from the specified address range */
+    readHoldingRegisters: (address: number, quantity: number) => Promise<Buffer>;
+    /** Read input register values from the specified address range */
+    readInputRegisters: (address: number, quantity: number) => Promise<Buffer>;
+    /** Write a single coil value to the specified address */
+    writeSingleCoil: (address: number, value: boolean) => Promise<void>;
+    /** Write a single register value to the specified address */
+    writeSingleRegister: (address: number, value: number) => Promise<void>;
+    /** Write multiple coil values starting from the specified address */
+    writeMultipleCoils: (address: number, values: boolean[]) => Promise<void>;
+    /** Write multiple register values starting from the specified address */
+    writeMultipleRegisters: (address: number, values: number[]) => Promise<void>;
+    /** Read holding register string value */
+    readRegisterStringValue: (address: number, quantity: number) => Promise<string>;
+}

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

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

package/dist/packages/energy-app-network-device.d.ts

@@ -0,0 +1,25 @@
+import { EnyoNetworkDevice, EnyoNetworkDeviceAccessStatus } from "../types/enyo-network-device.js";
+/**
+ * Interface for network device discovery and management in enyo packages.
+ * Provides functionality to detect and interact with devices on the local network.
+ */
+export interface EnergyAppNetworkDevice {
+    /** Get list of all previously detected network devices */
+    getDevices: (filter?: {
+        accessStatus?: EnyoNetworkDeviceAccessStatus;
+    }) => Promise<EnyoNetworkDevice[]>;
+    /** Get a specific device by its unique ID */
+    getDevice: (deviceId: string) => Promise<EnyoNetworkDevice | null>;
+    /** Trigger an asynchronous search for new devices on the network */
+    searchDevices: () => Promise<EnyoNetworkDevice[]>;
+    /** Trigger an async request to the user to accept or reject a network device access request. Ports are optional */
+    requestDeviceAccess: (deviceId: string, ports?: number[]) => Promise<{
+        status: EnyoNetworkDeviceAccessStatus;
+    }>;
+    /** listen for device access changes. Returns a listener id */
+    listenForDeviceAccessChange: (listener: (deviceId: string, status: EnyoNetworkDeviceAccessStatus) => void) => string;
+    /** listen for detected devices, based on the device definition in the energy app package definition */
+    listenForDetectedDevice: (listener: (detectedDevices: EnyoNetworkDevice[]) => void) => string;
+    /** Removes the listener */
+    removeListener: (listenerId: string) => void;
+}

package/dist/packages/energy-app-network-device.js

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

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

@@ -0,0 +1,50 @@
+import { EnyoNotification, EnyoNotificationOptions, EnyoNotificationTranslation, EnyoNotificationType } from "../types/enyo-notification.js";
+/**
+ * Interface for managing user notifications within Energy App packages.
+ * Provides methods to show, retrieve, and manage notifications with multi-language support.
+ */
+export interface EnergyAppNotification {
+    /**
+     * Shows a notification to the user with multi-language support.
+     * The notification will be displayed according to the specified type and options.
+     *
+     * @param type - The type of notification (info, warning, error, success) determining visual style
+     * @param options - Configuration options including permanence, expiration, priority, and appliance association
+     * @param translations - Array of translated notification messages for different supported languages
+     * @returns Unique notification ID that can be used for tracking and removal
+     *
+     * @example
+     * ```typescript
+     * const notificationId = showNotification('warning',
+     *   { permanent: true, priority: 'high' },
+     *   [
+     *     { language: 'en', notification: 'Battery level is low' },
+     *     { language: 'de', notification: 'Batteriestand ist niedrig' }
+     *   ]
+     * );
+     * ```
+     */
+    showNotification(type: EnyoNotificationType, options: EnyoNotificationOptions, translations: EnyoNotificationTranslation[]): string;
+    /**
+     * Retrieves all currently active notifications.
+     * Returns notifications in chronological order (newest first) unless sorted by priority.
+     *
+     * @param applianceId - Optional appliance ID to filter notifications for a specific appliance
+     * @returns Array of all current notifications with complete metadata
+     */
+    getNotifications(applianceId?: string): EnyoNotification[];
+    /**
+     * Removes a specific notification from the active notification list.
+     * If the notification doesn't exist, this method completes silently.
+     *
+     * @param notificationId - The unique ID of the notification to remove
+     */
+    removeNotification(notificationId: string): void;
+    /**
+     * Removes all active notifications.
+     * This is a convenience method for clearing the entire notification queue.
+     *
+     * @param applianceId - Optional appliance ID to clear only notifications for a specific appliance
+     */
+    clearAllNotifications(applianceId?: string): void;
+}

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

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

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

@@ -0,0 +1,52 @@
+export interface EnyoOcppAvailableConnectionDetail {
+    url: string;
+    path: string;
+    host: string;
+    secure: boolean;
+    port: number;
+}
+export interface EnyoOcppAvailableConnectionDetails {
+    cloud?: EnyoOcppAvailableConnectionDetail;
+    local?: EnyoOcppAvailableConnectionDetail;
+}
+export type EnyoOCPPVersion = '1.6' | '2.0.1';
+export interface EnyoOcppChargePointConnection {
+    chargePointId: string;
+    remoteAddress?: string;
+    protocolVersion: EnyoOCPPVersion;
+}
+export interface EnergyAppOcppMessageContext {
+    chargePointId: string;
+    messageId: string;
+    version: EnyoOCPPVersion;
+    timestamp: Date;
+}
+export declare enum EnyoOcppErrorCode {
+    NotImplemented = "NotImplemented",
+    NotSupported = "NotSupported",
+    InternalError = "InternalError",
+    ProtocolError = "ProtocolError",
+    SecurityError = "SecurityError",
+    FormationViolation = "FormationViolation",
+    PropertyConstraintViolation = "PropertyConstraintViolation",
+    OccurenceConstraintViolation = "OccurenceConstraintViolation",
+    TypeConstraintViolation = "TypeConstraintViolation",
+    GenericError = "GenericError"
+}
+export interface EnergyAppOcppMessageHandler<TRequest = any, TResponse = any> {
+    (request: TRequest, context: EnergyAppOcppMessageContext): Promise<TResponse>;
+}
+/**
+ * Interface for OCPP functionality in enyo packages.
+ */
+export interface EnergyAppOcpp {
+    getAvailableConnectionDetails: () => Promise<EnyoOcppAvailableConnectionDetails>;
+    listenForChargePointConnected: (listener: (connection: EnyoOcppChargePointConnection) => void) => string;
+    listenForChargePointDisconnected: (listener: (chargePointId: string) => void) => string;
+    registerHandler: <TRequest, TResponse>(action: string, handler: EnergyAppOcppMessageHandler<TRequest, TResponse>, version?: EnyoOCPPVersion) => string;
+    sendCall: <TRequest, TResponse>(chargePointId: string, message: string, payload: TRequest, messageId?: string) => Promise<TResponse>;
+    getConnectedChargePoints: () => EnyoOcppChargePointConnection[];
+    getChargePoint: (chargePointId: string) => EnyoOcppChargePointConnection | undefined;
+    disconnectChargePoint: (chargePointId: string, reason?: string) => void;
+    unsubscribe: (id: string) => void;
+}

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

@@ -0,0 +1,13 @@
+export var EnyoOcppErrorCode;
+(function (EnyoOcppErrorCode) {
+    EnyoOcppErrorCode["NotImplemented"] = "NotImplemented";
+    EnyoOcppErrorCode["NotSupported"] = "NotSupported";
+    EnyoOcppErrorCode["InternalError"] = "InternalError";
+    EnyoOcppErrorCode["ProtocolError"] = "ProtocolError";
+    EnyoOcppErrorCode["SecurityError"] = "SecurityError";
+    EnyoOcppErrorCode["FormationViolation"] = "FormationViolation";
+    EnyoOcppErrorCode["PropertyConstraintViolation"] = "PropertyConstraintViolation";
+    EnyoOcppErrorCode["OccurenceConstraintViolation"] = "OccurenceConstraintViolation";
+    EnyoOcppErrorCode["TypeConstraintViolation"] = "TypeConstraintViolation";
+    EnyoOcppErrorCode["GenericError"] = "GenericError";
+})(EnyoOcppErrorCode || (EnyoOcppErrorCode = {}));

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

@@ -0,0 +1,47 @@
+import { EnyoPackageConfigurationSetting, EnyoSettingsChangeListener, EnyoSettingConfigWithValue } from "../types/enyo-settings.js";
+/**
+ * Interface for managing Energy App settings configuration for appliances or the entire package.
+ * Provides methods to add, remove, and modify settings, as well as listen for changes.
+ * Each setting must have a unique name across the entire configuration.
+ */
+export interface EnergyAppSettings {
+    /**
+     * Adds a new setting configuration to the Energy App.
+     * The setting can be configured for a specific appliance or for the entire package.
+     *
+     * @param config - The setting configuration to add, including optional appliance ID and current value
+     * @returns Promise that resolves when the setting is successfully added
+     */
+    addSettingConfig(config: EnyoPackageConfigurationSetting): Promise<void>;
+    /**
+     * Removes a setting configuration from the Energy App.
+     * This will remove the setting regardless of whether it's for an appliance or the package.
+     *
+     * @param settingName - The unique name of the setting to remove
+     * @returns Promise that resolves when the setting is successfully removed
+     */
+    removeSettingConfig(settingName: string): Promise<void>;
+    /**
+     * Updates the value of an existing setting.
+     * The setting is identified by its unique name across all appliances and package settings.
+     *
+     * @param settingName - The unique name of the setting to update
+     * @param value - The new value for the setting
+     * @returns Promise that resolves when the setting value is successfully updated
+     */
+    updateSetting(settingName: string, value: string): Promise<void>;
+    /**
+     * Registers a listener that will be called when any setting value changes.
+     * The listener will be notified of changes to both appliance-specific and package-wide settings.
+     *
+     * @param listener - The callback function to be called on setting changes
+     */
+    listenForSettingsChanges(listener: EnyoSettingsChangeListener): void;
+    /**
+     * Retrieves all currently configured settings with their unique identifiers and current values.
+     * This includes settings for both specific appliances and the entire package.
+     *
+     * @returns Promise that resolves to an array of all settings with their IDs and current values
+     */
+    getSettingsConfig(): Promise<EnyoSettingConfigWithValue[]>;
+}

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Interface for persistent storage operations in enyo packages.
+ * Provides key-value storage capabilities for package data persistence.
+ */
+export interface EnergyAppStorage {
+    /** Save an object to storage with the specified key */
+    save: (key: string, value: object) => Promise<void>;
+    /** Load an object from storage by key, returns null if not found */
+    load: <T>(key: string) => Promise<T | null>;
+    /** Remove an object from storage by key */
+    remove: (key: string) => Promise<void>;
+    /** Returns a list of all keys stored in the storage */
+    listKeys: () => Promise<string[]>;
+}

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

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

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

@@ -0,0 +1,11 @@
+import { EnyoVehicle } from "../types/enyo-vehicle.js";
+/**
+ * Interface for managing vehicles in enyo packages.
+ * Provides read-only operations for vehicle information.
+ */
+export interface EnergyAppVehicle {
+    /** Get a list of all registered vehicles */
+    list: () => Promise<EnyoVehicle[]>;
+    /** Get a specific vehicle by its ID */
+    getById: (id: string) => Promise<EnyoVehicle | null>;
+}

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

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