@enyo-energy/energy-app-sdk 0.0.116 → 0.0.118

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-onboarding.d.cts

@@ -147,6 +147,48 @@ export interface EnergyAppOnboarding {
      * ```
      */
     moveToStep(guideName: string, stepName: string): Promise<void>;
+    /**
+     * Adds a new step to an existing onboarding guide at runtime.
+     *
+     * Intended for flows where the next step cannot be known up front — for
+     * example when a step submission produces data that determines which (or
+     * how many) follow-up steps are needed. Combine with {@link moveToStep}
+     * to route the user into the freshly added step.
+     *
+     * The new step's `name` must be unique within the guide; calls that would
+     * introduce a duplicate `name` are rejected. When `options.after` is
+     * provided, the step is inserted immediately after the step with that
+     * name; if no step matches, or `options` is omitted, the step is appended
+     * at the end of the guide.
+     *
+     * @param guideName - The unique name of the guide to extend
+     * @param step - The new step to add to the guide
+     * @param options - Optional positioning; `after` inserts the new step
+     *   immediately after the step with the given `name`. Omit to append.
+     * @returns Promise that resolves once the step has been added
+     *
+     * @example
+     * ```typescript
+     * onboarding.listenForStepSubmission(async (submission) => {
+     *   if (submission.stepName === 'discover-devices') {
+     *     const devices = await scanForDevices();
+     *     for (const device of devices) {
+     *       await onboarding.addStep(submission.guideName, {
+     *         name: `configure-${device.id}`,
+     *         sections: buildSectionsFor(device),
+     *         nextButtonLabel: [{ language: 'en', value: 'Continue' }],
+     *       }, { after: 'discover-devices' });
+     *     }
+     *     await onboarding.moveToStep(submission.guideName, `configure-${devices[0].id}`);
+     *     return { state: 'success' };
+     *   }
+     *   return { state: 'success' };
+     * });
+     * ```
+     */
+    addStep(guideName: string, step: EnyoOnboardingStep, options?: {
+        after?: string;
+    }): Promise<void>;
     /**
      * Marks the onboarding as complete and clears the ConfigurationRequired state.
      * This updates the state for the specified guide.

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-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.116';
+exports.SDK_VERSION = '0.0.118';
 /**
  * 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.116";
+export declare const SDK_VERSION = "0.0.118";
 /**
  * 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-onboarding.d.ts

@@ -147,6 +147,48 @@ export interface EnergyAppOnboarding {
      * ```
      */
     moveToStep(guideName: string, stepName: string): Promise<void>;
+    /**
+     * Adds a new step to an existing onboarding guide at runtime.
+     *
+     * Intended for flows where the next step cannot be known up front — for
+     * example when a step submission produces data that determines which (or
+     * how many) follow-up steps are needed. Combine with {@link moveToStep}
+     * to route the user into the freshly added step.
+     *
+     * The new step's `name` must be unique within the guide; calls that would
+     * introduce a duplicate `name` are rejected. When `options.after` is
+     * provided, the step is inserted immediately after the step with that
+     * name; if no step matches, or `options` is omitted, the step is appended
+     * at the end of the guide.
+     *
+     * @param guideName - The unique name of the guide to extend
+     * @param step - The new step to add to the guide
+     * @param options - Optional positioning; `after` inserts the new step
+     *   immediately after the step with the given `name`. Omit to append.
+     * @returns Promise that resolves once the step has been added
+     *
+     * @example
+     * ```typescript
+     * onboarding.listenForStepSubmission(async (submission) => {
+     *   if (submission.stepName === 'discover-devices') {
+     *     const devices = await scanForDevices();
+     *     for (const device of devices) {
+     *       await onboarding.addStep(submission.guideName, {
+     *         name: `configure-${device.id}`,
+     *         sections: buildSectionsFor(device),
+     *         nextButtonLabel: [{ language: 'en', value: 'Continue' }],
+     *       }, { after: 'discover-devices' });
+     *     }
+     *     await onboarding.moveToStep(submission.guideName, `configure-${devices[0].id}`);
+     *     return { state: 'success' };
+     *   }
+     *   return { state: 'success' };
+     * });
+     * ```
+     */
+    addStep(guideName: string, step: EnyoOnboardingStep, options?: {
+        after?: string;
+    }): Promise<void>;
     /**
      * Marks the onboarding as complete and clears the ConfigurationRequired state.
      * This updates the state for the specified guide.

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-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.116";
+export declare const SDK_VERSION = "0.0.118";
 /**
  * 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.116';
+export const SDK_VERSION = '0.0.118';
 /**
  * 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.116",
+  "version": "0.0.118",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",