@enyo-energy/energy-app-sdk 0.0.117 → 0.0.119

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

@@ -41,5 +41,6 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["EebusControl"] = "EebusControl";
     EnergyAppPermissionTypeEnum["Mqtt"] = "Mqtt";
     EnergyAppPermissionTypeEnum["Bluetooth"] = "Bluetooth";
+    EnergyAppPermissionTypeEnum["Wifi"] = "Wifi";
     EnergyAppPermissionTypeEnum["ChildProcess"] = "ChildProcess";
 })(EnergyAppPermissionTypeEnum || (exports.EnergyAppPermissionTypeEnum = EnergyAppPermissionTypeEnum = {}));

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

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'ChildProcess';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -38,5 +38,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     EebusControl = "EebusControl",
     Mqtt = "Mqtt",
     Bluetooth = "Bluetooth",
+    Wifi = "Wifi",
     ChildProcess = "ChildProcess"
 }

package/dist/cjs/energy-app.cjs

@@ -237,6 +237,15 @@ class EnergyApp {
     useLearningPhase() {
         return this.energyAppSdk.useLearningPhase();
     }
+    /**
+     * Gets the WiFi API for scanning and listing known WiFi networks (SSIDs).
+     * Provides methods to discover saved/known SSIDs that are currently
+     * in range of the device's WiFi adapter.
+     * @returns The WiFi API instance
+     */
+    useWifi() {
+        return this.energyAppSdk.useWifi();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -30,6 +30,7 @@ import { EnergyAppMqtt } from "./packages/energy-app-mqtt.cjs";
 import { EnergyAppBluetooth } from "./packages/energy-app-bluetooth.cjs";
 import { EnergyAppDiagnostics } from "./packages/energy-app-diagnostics.cjs";
 import { EnergyAppLearningPhase } from "./packages/energy-app-learning-phase.cjs";
+import { EnergyAppWifi } from "./packages/energy-app-wifi.cjs";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
  * to the runtime-provided `energyAppSdkInstance` global.
@@ -176,6 +177,13 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Learning Phase API instance
      */
     useLearningPhase(): EnergyAppLearningPhase;
+    /**
+     * Gets the WiFi API for scanning and listing known WiFi networks (SSIDs).
+     * Provides methods to discover saved/known SSIDs that are currently
+     * in range of the device's WiFi adapter.
+     * @returns The WiFi API instance
+     */
+    useWifi(): EnergyAppWifi;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -29,6 +29,7 @@ import { EnergyAppMqtt } from "./packages/energy-app-mqtt.cjs";
 import { EnergyAppBluetooth } from "./packages/energy-app-bluetooth.cjs";
 import { EnergyAppDiagnostics } from "./packages/energy-app-diagnostics.cjs";
 import { EnergyAppLearningPhase } from "./packages/energy-app-learning-phase.cjs";
+import { EnergyAppWifi } from "./packages/energy-app-wifi.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -115,4 +116,6 @@ export interface EnyoEnergyAppSdk {
     useDiagnostics: () => EnergyAppDiagnostics;
     /** Get the Learning Phase API for registering and tracking learning phases */
     useLearningPhase: () => EnergyAppLearningPhase;
+    /** Get the WiFi API for scanning and listing known SSIDs */
+    useWifi: () => EnergyAppWifi;
 }

package/dist/cjs/index.cjs

@@ -57,6 +57,8 @@ __exportStar(require("./types/enyo-diagnostics.cjs"), exports);
 __exportStar(require("./packages/energy-app-diagnostics.cjs"), exports);
 __exportStar(require("./types/enyo-learning-phase.cjs"), exports);
 __exportStar(require("./packages/energy-app-learning-phase.cjs"), exports);
+__exportStar(require("./types/enyo-wifi.cjs"), exports);
+__exportStar(require("./packages/energy-app-wifi.cjs"), exports);
 __exportStar(require("./types/enyo-air-conditioning-appliance.cjs"), exports);
 __exportStar(require("./types/enyo-onboarding.cjs"), exports);
 __exportStar(require("./packages/energy-app-onboarding.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -41,6 +41,8 @@ export * from './types/enyo-diagnostics.cjs';
 export * from './packages/energy-app-diagnostics.cjs';
 export * from './types/enyo-learning-phase.cjs';
 export * from './packages/energy-app-learning-phase.cjs';
+export * from './types/enyo-wifi.cjs';
+export * from './packages/energy-app-wifi.cjs';
 export * from './types/enyo-air-conditioning-appliance.cjs';
 export * from './types/enyo-onboarding.cjs';
 export * from './packages/energy-app-onboarding.cjs';

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

@@ -1,4 +1,4 @@
-import { MqttConnectOptions, MqttExternalConnectOptions, MqttConnectionStatus, MqttSubscribeOptions, MqttPublishOptions, MqttMessage } from "../types/enyo-mqtt.cjs";
+import { MqttConnectOptions, MqttExternalConnectOptions, MqttConnectionStatus, MqttSubscribeOptions, MqttPublishOptions, MqttMessage, EnyoMqttAvailableConnectionDetails } from "../types/enyo-mqtt.cjs";
 /**
  * Interface for MQTT communication in enyo packages.
  * Provides MQTT client functionality with support for both the SDK-provided
@@ -59,6 +59,26 @@ export interface EnergyAppMqtt {
      * ```
      */
     connect: (options: MqttExternalConnectOptions) => Promise<EnergyAppMqttClient>;
+    /**
+     * Get connection details for MQTT brokers exposed to the energy app.
+     * Currently returns details for the SDK-provided local MQTT broker so callers
+     * can connect with their own MQTT client implementation when {@link connectInternal}
+     * is not suitable (e.g. bridging to another runtime, configuring a third-party
+     * library, or providing the broker address to an external process).
+     *
+     * Mirrors the OCPP `getAvailableConnectionDetails` API.
+     *
+     * @returns A map of available broker connection details, keyed by scope (e.g. `local`).
+     *
+     * @example
+     * ```typescript
+     * const details = await mqtt.getAvailableConnectionDetails();
+     * if (details.local) {
+     *     console.log(`Local broker available at ${details.local.url}`);
+     * }
+     * ```
+     */
+    getAvailableConnectionDetails: () => Promise<EnyoMqttAvailableConnectionDetails>;
 }
 /**
  * Represents an active MQTT client connection.

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

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

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

@@ -0,0 +1,38 @@
+import { EnergyAppWifiSsid } from "../types/enyo-wifi.cjs";
+/**
+ * WiFi API for enyo packages.
+ *
+ * Provides discovery of WiFi networks (SSIDs) currently visible to the
+ * device's WiFi adapter. All operations require the package to declare the
+ * `Wifi` permission.
+ *
+ * @example
+ * ```ts
+ * const wifi = energyApp.useWifi();
+ *
+ * // Discover all known SSIDs that are currently in range
+ * const knownNetworks = await wifi.getKnownSsids();
+ * for (const network of knownNetworks) {
+ *     console.log(`${network.ssid} @ ${network.rssi} dBm`);
+ * }
+ * ```
+ */
+export interface EnergyAppWifi {
+    /**
+     * Run a WiFi scan and return all known SSIDs that were discovered.
+     *
+     * "Known" means the network is currently saved on the device — i.e. the
+     * device has previously joined it and credentials are stored. Networks
+     * that are visible but not saved are not returned by this method.
+     *
+     * The scan is synchronous from the caller's perspective: the returned
+     * promise resolves once the underlying WiFi stack has finished its
+     * discovery sweep. Each call performs a fresh scan; results are not
+     * cached between calls.
+     *
+     * @returns Promise resolving with the list of known SSIDs that were
+     *          discovered during the scan. The list is empty when no known
+     *          networks are currently in range.
+     */
+    getKnownSsids(): Promise<EnergyAppWifiSsid[]>;
+}

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

@@ -45,4 +45,6 @@ var EnyoChargerApplianceAvailableFeaturesEnum;
     EnyoChargerApplianceAvailableFeaturesEnum["RebootCharger"] = "RebootCharger";
     /** If the charger supports requesting log file uploads */
     EnyoChargerApplianceAvailableFeaturesEnum["RequestLogFiles"] = "RequestLogFiles";
+    /** If the Charger supprots a pv surplus mode */
+    EnyoChargerApplianceAvailableFeaturesEnum["PvSurplusMode"] = "PvSurplusMode";
 })(EnyoChargerApplianceAvailableFeaturesEnum || (exports.EnyoChargerApplianceAvailableFeaturesEnum = EnyoChargerApplianceAvailableFeaturesEnum = {}));

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

@@ -58,7 +58,9 @@ export declare enum EnyoChargerApplianceAvailableFeaturesEnum {
     /** If the charger supports being rebooted */
     RebootCharger = "RebootCharger",
     /** If the charger supports requesting log file uploads */
-    RequestLogFiles = "RequestLogFiles"
+    RequestLogFiles = "RequestLogFiles",
+    /** If the Charger supprots a pv surplus mode */
+    PvSurplusMode = "PvSurplusMode"
 }
 export interface EnyoChargerApplianceMetadata {
     availableFeatures: EnyoChargerApplianceAvailableFeaturesEnum[];

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

@@ -106,6 +106,8 @@ var EnyoChargeModeEnum;
     EnyoChargeModeEnum["CostOptimized"] = "cost-optimized";
     /** Optimize charging schedule for a maximum price limit, for example 7 ct grid or pv production */
     EnyoChargeModeEnum["PriceLimit"] = "price-limit";
+    /** Charge only from PV surplus, using excess solar production that would otherwise be fed into the grid */
+    EnyoChargeModeEnum["PvSurplus"] = "pv-surplus";
 })(EnyoChargeModeEnum || (exports.EnyoChargeModeEnum = EnyoChargeModeEnum = {}));
 var EnyoDataBusMessageEnum;
 (function (EnyoDataBusMessageEnum) {

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

@@ -122,7 +122,9 @@ export declare enum EnyoChargeModeEnum {
     /** Optimize charging schedule for lowest cost */
     CostOptimized = "cost-optimized",
     /** Optimize charging schedule for a maximum price limit, for example 7 ct grid or pv production */
-    PriceLimit = "price-limit"
+    PriceLimit = "price-limit",
+    /** Charge only from PV surplus, using excess solar production that would otherwise be fed into the grid */
+    PvSurplus = "pv-surplus"
 }
 export interface EnyoAggregatedStateApplianceValues {
     gridPowerW?: number;

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

@@ -84,6 +84,34 @@ export interface MqttPublishOptions {
     /** Whether the broker should retain this message as the last known value for the topic (default: false) */
     retain?: boolean;
 }
+/**
+ * Connection details for an MQTT broker exposed to the energy app.
+ * Returned by {@link EnergyAppMqtt.getAvailableConnectionDetails} so callers can
+ * connect to the broker using their own MQTT client implementation if needed.
+ */
+export interface EnyoMqttAvailableConnectionDetail {
+    /** Fully qualified broker URL including protocol and port (e.g. "mqtt://127.0.0.1:1883" or "mqtts://broker.local:8883") */
+    url: string;
+    /** Broker hostname or IP address (e.g. "127.0.0.1") */
+    host: string;
+    /** Broker TCP port (e.g. 1883 for plain, 8883 for TLS) */
+    port: number;
+    /** Whether the broker requires a TLS/SSL connection */
+    secure: boolean;
+    /** Username for broker authentication, if required */
+    username?: string;
+    /** Password for broker authentication, if required */
+    password?: string;
+}
+/**
+ * Map of available MQTT broker connection details by scope.
+ * Mirrors the structure of OCPP available connection details so callers can
+ * uniformly discover broker endpoints exposed by the runtime.
+ */
+export interface EnyoMqttAvailableConnectionDetails {
+    /** Connection details for the SDK-provided local MQTT broker, when available */
+    local?: EnyoMqttAvailableConnectionDetail;
+}
 /**
  * Represents an incoming MQTT message received on a subscribed topic.
  */

package/dist/cjs/types/enyo-wifi.cjs

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

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

@@ -0,0 +1,80 @@
+/**
+ * Closed set of error codes raised by the WiFi API.
+ *
+ * - `permission_denied`: package is missing the `Wifi` permission.
+ * - `adapter_unavailable`: no WiFi adapter is present or the radio is disabled.
+ * - `scan_in_progress`: a concurrent scan request was rejected.
+ * - `scan_failed`: the underlying WiFi stack reported a failure during scanning.
+ * - `timeout`: the scan exceeded its allotted time.
+ */
+export type EnergyAppWifiErrorCode = 'permission_denied' | 'adapter_unavailable' | 'scan_in_progress' | 'scan_failed' | 'timeout';
+/**
+ * Error subtype thrown by the WiFi API.
+ * Always carries a structured {@link EnergyAppWifiErrorCode}; callers
+ * should branch on `code` rather than parsing the human-readable message.
+ */
+export interface EnergyAppWifiError extends Error {
+    /** Machine-readable error code. */
+    readonly code: EnergyAppWifiErrorCode;
+}
+/**
+ * Security mode advertised by a discovered WiFi network.
+ *
+ * - `open`: no encryption; the network is unprotected.
+ * - `wep`: deprecated WEP encryption.
+ * - `wpa`: WPA-Personal (TKIP/AES).
+ * - `wpa2`: WPA2-Personal.
+ * - `wpa3`: WPA3-Personal.
+ * - `wpa2_enterprise`: WPA2-Enterprise (802.1X).
+ * - `wpa3_enterprise`: WPA3-Enterprise (802.1X).
+ * - `unknown`: the security mode could not be determined from the beacon.
+ */
+export type EnergyAppWifiSecurity = 'open' | 'wep' | 'wpa' | 'wpa2' | 'wpa3' | 'wpa2_enterprise' | 'wpa3_enterprise' | 'unknown';
+/**
+ * A WiFi network (SSID) discovered during a scan.
+ *
+ * The shape mirrors what is available in the WiFi beacon/probe response;
+ * values that are not present are omitted rather than zeroed.
+ */
+export interface EnergyAppWifiSsid {
+    /**
+     * The network name (SSID) as broadcast by the access point.
+     * Empty string for hidden networks that do not broadcast their SSID.
+     */
+    ssid: string;
+    /**
+     * BSSID of the access point in uppercase, colon-separated form
+     * (e.g. "AA:BB:CC:DD:EE:FF"). When multiple APs broadcast the same SSID
+     * (roaming), the strongest one is reported.
+     */
+    bssid?: string;
+    /** Last received signal strength indicator in dBm. */
+    rssi?: number;
+    /** Operating channel number on which the network was observed. */
+    channel?: number;
+    /** Operating frequency in MHz on which the network was observed. */
+    frequencyMhz?: number;
+    /** Security mode advertised by the access point. */
+    security?: EnergyAppWifiSecurity;
+    /**
+     * `true` when the network is currently saved/known on the device, meaning
+     * credentials are stored and the device can auto-connect.
+     */
+    known?: boolean;
+}
+/**
+ * Options controlling a single WiFi discovery run.
+ */
+export interface EnergyAppWifiScanOptions {
+    /**
+     * Wall-clock duration of the scan in milliseconds. Defaults to 5000;
+     * the host caps this value at 30000 to protect the WiFi adapter.
+     */
+    durationMs?: number;
+    /**
+     * When `true`, restrict the result to networks that are currently saved
+     * on the device (i.e. SSIDs the device has previously joined).
+     * Defaults to `false`.
+     */
+    onlyKnown?: boolean;
+}

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

package/dist/energy-app-permission.type.d.ts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'ChildProcess';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'PvSystemRegister' | 'PvSystemUse' | 'InverterControlCommands' | 'BatteryControlCommands' | 'ChargerControlCommands' | 'ModbusRtu' | 'EnergyPrices' | 'EnergyManager' | 'EebusDeviceManagement' | 'EebusDataAccess' | 'EebusControl' | 'Mqtt' | 'Bluetooth' | 'Wifi' | 'ChildProcess';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -38,5 +38,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     EebusControl = "EebusControl",
     Mqtt = "Mqtt",
     Bluetooth = "Bluetooth",
+    Wifi = "Wifi",
     ChildProcess = "ChildProcess"
 }

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

@@ -38,5 +38,6 @@ export var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["EebusControl"] = "EebusControl";
     EnergyAppPermissionTypeEnum["Mqtt"] = "Mqtt";
     EnergyAppPermissionTypeEnum["Bluetooth"] = "Bluetooth";
+    EnergyAppPermissionTypeEnum["Wifi"] = "Wifi";
     EnergyAppPermissionTypeEnum["ChildProcess"] = "ChildProcess";
 })(EnergyAppPermissionTypeEnum || (EnergyAppPermissionTypeEnum = {}));

package/dist/energy-app.d.ts

@@ -30,6 +30,7 @@ import { EnergyAppMqtt } from "./packages/energy-app-mqtt.js";
 import { EnergyAppBluetooth } from "./packages/energy-app-bluetooth.js";
 import { EnergyAppDiagnostics } from "./packages/energy-app-diagnostics.js";
 import { EnergyAppLearningPhase } from "./packages/energy-app-learning-phase.js";
+import { EnergyAppWifi } from "./packages/energy-app-wifi.js";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
  * to the runtime-provided `energyAppSdkInstance` global.
@@ -176,6 +177,13 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Learning Phase API instance
      */
     useLearningPhase(): EnergyAppLearningPhase;
+    /**
+     * Gets the WiFi API for scanning and listing known WiFi networks (SSIDs).
+     * Provides methods to discover saved/known SSIDs that are currently
+     * in range of the device's WiFi adapter.
+     * @returns The WiFi API instance
+     */
+    useWifi(): EnergyAppWifi;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/energy-app.js

@@ -234,6 +234,15 @@ export class EnergyApp {
     useLearningPhase() {
         return this.energyAppSdk.useLearningPhase();
     }
+    /**
+     * Gets the WiFi API for scanning and listing known WiFi networks (SSIDs).
+     * Provides methods to discover saved/known SSIDs that are currently
+     * in range of the device's WiFi adapter.
+     * @returns The WiFi API instance
+     */
+    useWifi() {
+        return this.energyAppSdk.useWifi();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -29,6 +29,7 @@ import { EnergyAppMqtt } from "./packages/energy-app-mqtt.js";
 import { EnergyAppBluetooth } from "./packages/energy-app-bluetooth.js";
 import { EnergyAppDiagnostics } from "./packages/energy-app-diagnostics.js";
 import { EnergyAppLearningPhase } from "./packages/energy-app-learning-phase.js";
+import { EnergyAppWifi } from "./packages/energy-app-wifi.js";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -115,4 +116,6 @@ export interface EnyoEnergyAppSdk {
     useDiagnostics: () => EnergyAppDiagnostics;
     /** Get the Learning Phase API for registering and tracking learning phases */
     useLearningPhase: () => EnergyAppLearningPhase;
+    /** Get the WiFi API for scanning and listing known SSIDs */
+    useWifi: () => EnergyAppWifi;
 }

package/dist/index.d.ts

@@ -41,6 +41,8 @@ export * from './types/enyo-diagnostics.js';
 export * from './packages/energy-app-diagnostics.js';
 export * from './types/enyo-learning-phase.js';
 export * from './packages/energy-app-learning-phase.js';
+export * from './types/enyo-wifi.js';
+export * from './packages/energy-app-wifi.js';
 export * from './types/enyo-air-conditioning-appliance.js';
 export * from './types/enyo-onboarding.js';
 export * from './packages/energy-app-onboarding.js';

package/dist/index.js

@@ -41,6 +41,8 @@ export * from './types/enyo-diagnostics.js';
 export * from './packages/energy-app-diagnostics.js';
 export * from './types/enyo-learning-phase.js';
 export * from './packages/energy-app-learning-phase.js';
+export * from './types/enyo-wifi.js';
+export * from './packages/energy-app-wifi.js';
 export * from './types/enyo-air-conditioning-appliance.js';
 export * from './types/enyo-onboarding.js';
 export * from './packages/energy-app-onboarding.js';

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

@@ -1,4 +1,4 @@
-import { MqttConnectOptions, MqttExternalConnectOptions, MqttConnectionStatus, MqttSubscribeOptions, MqttPublishOptions, MqttMessage } from "../types/enyo-mqtt.js";
+import { MqttConnectOptions, MqttExternalConnectOptions, MqttConnectionStatus, MqttSubscribeOptions, MqttPublishOptions, MqttMessage, EnyoMqttAvailableConnectionDetails } from "../types/enyo-mqtt.js";
 /**
  * Interface for MQTT communication in enyo packages.
  * Provides MQTT client functionality with support for both the SDK-provided
@@ -59,6 +59,26 @@ export interface EnergyAppMqtt {
      * ```
      */
     connect: (options: MqttExternalConnectOptions) => Promise<EnergyAppMqttClient>;
+    /**
+     * Get connection details for MQTT brokers exposed to the energy app.
+     * Currently returns details for the SDK-provided local MQTT broker so callers
+     * can connect with their own MQTT client implementation when {@link connectInternal}
+     * is not suitable (e.g. bridging to another runtime, configuring a third-party
+     * library, or providing the broker address to an external process).
+     *
+     * Mirrors the OCPP `getAvailableConnectionDetails` API.
+     *
+     * @returns A map of available broker connection details, keyed by scope (e.g. `local`).
+     *
+     * @example
+     * ```typescript
+     * const details = await mqtt.getAvailableConnectionDetails();
+     * if (details.local) {
+     *     console.log(`Local broker available at ${details.local.url}`);
+     * }
+     * ```
+     */
+    getAvailableConnectionDetails: () => Promise<EnyoMqttAvailableConnectionDetails>;
 }
 /**
  * Represents an active MQTT client connection.

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

@@ -0,0 +1,38 @@
+import { EnergyAppWifiSsid } from "../types/enyo-wifi.js";
+/**
+ * WiFi API for enyo packages.
+ *
+ * Provides discovery of WiFi networks (SSIDs) currently visible to the
+ * device's WiFi adapter. All operations require the package to declare the
+ * `Wifi` permission.
+ *
+ * @example
+ * ```ts
+ * const wifi = energyApp.useWifi();
+ *
+ * // Discover all known SSIDs that are currently in range
+ * const knownNetworks = await wifi.getKnownSsids();
+ * for (const network of knownNetworks) {
+ *     console.log(`${network.ssid} @ ${network.rssi} dBm`);
+ * }
+ * ```
+ */
+export interface EnergyAppWifi {
+    /**
+     * Run a WiFi scan and return all known SSIDs that were discovered.
+     *
+     * "Known" means the network is currently saved on the device — i.e. the
+     * device has previously joined it and credentials are stored. Networks
+     * that are visible but not saved are not returned by this method.
+     *
+     * The scan is synchronous from the caller's perspective: the returned
+     * promise resolves once the underlying WiFi stack has finished its
+     * discovery sweep. Each call performs a fresh scan; results are not
+     * cached between calls.
+     *
+     * @returns Promise resolving with the list of known SSIDs that were
+     *          discovered during the scan. The list is empty when no known
+     *          networks are currently in range.
+     */
+    getKnownSsids(): Promise<EnergyAppWifiSsid[]>;
+}

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

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

package/dist/types/enyo-charger-appliance.d.ts

@@ -58,7 +58,9 @@ export declare enum EnyoChargerApplianceAvailableFeaturesEnum {
     /** If the charger supports being rebooted */
     RebootCharger = "RebootCharger",
     /** If the charger supports requesting log file uploads */
-    RequestLogFiles = "RequestLogFiles"
+    RequestLogFiles = "RequestLogFiles",
+    /** If the Charger supprots a pv surplus mode */
+    PvSurplusMode = "PvSurplusMode"
 }
 export interface EnyoChargerApplianceMetadata {
     availableFeatures: EnyoChargerApplianceAvailableFeaturesEnum[];

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

@@ -42,4 +42,6 @@ export var EnyoChargerApplianceAvailableFeaturesEnum;
     EnyoChargerApplianceAvailableFeaturesEnum["RebootCharger"] = "RebootCharger";
     /** If the charger supports requesting log file uploads */
     EnyoChargerApplianceAvailableFeaturesEnum["RequestLogFiles"] = "RequestLogFiles";
+    /** If the Charger supprots a pv surplus mode */
+    EnyoChargerApplianceAvailableFeaturesEnum["PvSurplusMode"] = "PvSurplusMode";
 })(EnyoChargerApplianceAvailableFeaturesEnum || (EnyoChargerApplianceAvailableFeaturesEnum = {}));

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

@@ -122,7 +122,9 @@ export declare enum EnyoChargeModeEnum {
     /** Optimize charging schedule for lowest cost */
     CostOptimized = "cost-optimized",
     /** Optimize charging schedule for a maximum price limit, for example 7 ct grid or pv production */
-    PriceLimit = "price-limit"
+    PriceLimit = "price-limit",
+    /** Charge only from PV surplus, using excess solar production that would otherwise be fed into the grid */
+    PvSurplus = "pv-surplus"
 }
 export interface EnyoAggregatedStateApplianceValues {
     gridPowerW?: number;

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

@@ -103,6 +103,8 @@ export var EnyoChargeModeEnum;
     EnyoChargeModeEnum["CostOptimized"] = "cost-optimized";
     /** Optimize charging schedule for a maximum price limit, for example 7 ct grid or pv production */
     EnyoChargeModeEnum["PriceLimit"] = "price-limit";
+    /** Charge only from PV surplus, using excess solar production that would otherwise be fed into the grid */
+    EnyoChargeModeEnum["PvSurplus"] = "pv-surplus";
 })(EnyoChargeModeEnum || (EnyoChargeModeEnum = {}));
 export var EnyoDataBusMessageEnum;
 (function (EnyoDataBusMessageEnum) {

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

@@ -84,6 +84,34 @@ export interface MqttPublishOptions {
     /** Whether the broker should retain this message as the last known value for the topic (default: false) */
     retain?: boolean;
 }
+/**
+ * Connection details for an MQTT broker exposed to the energy app.
+ * Returned by {@link EnergyAppMqtt.getAvailableConnectionDetails} so callers can
+ * connect to the broker using their own MQTT client implementation if needed.
+ */
+export interface EnyoMqttAvailableConnectionDetail {
+    /** Fully qualified broker URL including protocol and port (e.g. "mqtt://127.0.0.1:1883" or "mqtts://broker.local:8883") */
+    url: string;
+    /** Broker hostname or IP address (e.g. "127.0.0.1") */
+    host: string;
+    /** Broker TCP port (e.g. 1883 for plain, 8883 for TLS) */
+    port: number;
+    /** Whether the broker requires a TLS/SSL connection */
+    secure: boolean;
+    /** Username for broker authentication, if required */
+    username?: string;
+    /** Password for broker authentication, if required */
+    password?: string;
+}
+/**
+ * Map of available MQTT broker connection details by scope.
+ * Mirrors the structure of OCPP available connection details so callers can
+ * uniformly discover broker endpoints exposed by the runtime.
+ */
+export interface EnyoMqttAvailableConnectionDetails {
+    /** Connection details for the SDK-provided local MQTT broker, when available */
+    local?: EnyoMqttAvailableConnectionDetail;
+}
 /**
  * Represents an incoming MQTT message received on a subscribed topic.
  */

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

@@ -0,0 +1,80 @@
+/**
+ * Closed set of error codes raised by the WiFi API.
+ *
+ * - `permission_denied`: package is missing the `Wifi` permission.
+ * - `adapter_unavailable`: no WiFi adapter is present or the radio is disabled.
+ * - `scan_in_progress`: a concurrent scan request was rejected.
+ * - `scan_failed`: the underlying WiFi stack reported a failure during scanning.
+ * - `timeout`: the scan exceeded its allotted time.
+ */
+export type EnergyAppWifiErrorCode = 'permission_denied' | 'adapter_unavailable' | 'scan_in_progress' | 'scan_failed' | 'timeout';
+/**
+ * Error subtype thrown by the WiFi API.
+ * Always carries a structured {@link EnergyAppWifiErrorCode}; callers
+ * should branch on `code` rather than parsing the human-readable message.
+ */
+export interface EnergyAppWifiError extends Error {
+    /** Machine-readable error code. */
+    readonly code: EnergyAppWifiErrorCode;
+}
+/**
+ * Security mode advertised by a discovered WiFi network.
+ *
+ * - `open`: no encryption; the network is unprotected.
+ * - `wep`: deprecated WEP encryption.
+ * - `wpa`: WPA-Personal (TKIP/AES).
+ * - `wpa2`: WPA2-Personal.
+ * - `wpa3`: WPA3-Personal.
+ * - `wpa2_enterprise`: WPA2-Enterprise (802.1X).
+ * - `wpa3_enterprise`: WPA3-Enterprise (802.1X).
+ * - `unknown`: the security mode could not be determined from the beacon.
+ */
+export type EnergyAppWifiSecurity = 'open' | 'wep' | 'wpa' | 'wpa2' | 'wpa3' | 'wpa2_enterprise' | 'wpa3_enterprise' | 'unknown';
+/**
+ * A WiFi network (SSID) discovered during a scan.
+ *
+ * The shape mirrors what is available in the WiFi beacon/probe response;
+ * values that are not present are omitted rather than zeroed.
+ */
+export interface EnergyAppWifiSsid {
+    /**
+     * The network name (SSID) as broadcast by the access point.
+     * Empty string for hidden networks that do not broadcast their SSID.
+     */
+    ssid: string;
+    /**
+     * BSSID of the access point in uppercase, colon-separated form
+     * (e.g. "AA:BB:CC:DD:EE:FF"). When multiple APs broadcast the same SSID
+     * (roaming), the strongest one is reported.
+     */
+    bssid?: string;
+    /** Last received signal strength indicator in dBm. */
+    rssi?: number;
+    /** Operating channel number on which the network was observed. */
+    channel?: number;
+    /** Operating frequency in MHz on which the network was observed. */
+    frequencyMhz?: number;
+    /** Security mode advertised by the access point. */
+    security?: EnergyAppWifiSecurity;
+    /**
+     * `true` when the network is currently saved/known on the device, meaning
+     * credentials are stored and the device can auto-connect.
+     */
+    known?: boolean;
+}
+/**
+ * Options controlling a single WiFi discovery run.
+ */
+export interface EnergyAppWifiScanOptions {
+    /**
+     * Wall-clock duration of the scan in milliseconds. Defaults to 5000;
+     * the host caps this value at 30000 to protect the WiFi adapter.
+     */
+    durationMs?: number;
+    /**
+     * When `true`, restrict the result to networks that are currently saved
+     * on the device (i.e. SSIDs the device has previously joined).
+     * Defaults to `false`.
+     */
+    onlyKnown?: boolean;
+}

package/dist/types/enyo-wifi.js

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

package/dist/version.d.ts

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