@enyo-energy/energy-app-sdk 0.0.162 → 0.0.164

package/dist/cjs/energy-app-model-feature.enum.cjs

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnergyAppModelFeatureEnum = void 0;
+/**
+ * Important capabilities a specific device model can support.
+ *
+ * Declared per model inside an Energy App package's compatibility section
+ * (see {@link EnergyAppPackageCompatibilityModel}) so the enyo Store and
+ * onboarding flows can surface accurate, model-level feature information to
+ * users. Values are grouped by device category for readability.
+ */
+var EnergyAppModelFeatureEnum;
+(function (EnergyAppModelFeatureEnum) {
+    // Battery / Storage
+    /** The battery can be charged from the grid (not only from PV surplus) */
+    EnergyAppModelFeatureEnum["BatteryChargingFromGrid"] = "battery-charging-from-grid";
+    /** The maximum charge power or target state of charge can be limited */
+    EnergyAppModelFeatureEnum["BatteryChargeLimitation"] = "battery-charge-limitation";
+    /** The maximum discharge power or minimum state of charge can be limited */
+    EnergyAppModelFeatureEnum["BatteryDischargeLimitation"] = "battery-discharge-limitation";
+    // Inverter / PV
+    /** The PV feed-in power into the grid can be limited (curtailment) */
+    EnergyAppModelFeatureEnum["PvFeedInLimitation"] = "pv-feed-in-limitation";
+    /** The inverter active power output can be limited */
+    EnergyAppModelFeatureEnum["InverterPowerLimitation"] = "inverter-power-limitation";
+    // Wallbox / Charging
+    /** Charging can be started and stopped remotely */
+    EnergyAppModelFeatureEnum["ChargingStartStop"] = "charging-start-stop";
+    /** The charging power (in Ampere or Watt) can be limited */
+    EnergyAppModelFeatureEnum["ChargingPowerLimitation"] = "charging-power-limitation";
+    /** The model supports switching between single- and three-phase charging */
+    EnergyAppModelFeatureEnum["ChargingPhaseSwitching"] = "charging-phase-switching";
+    /** The model supports charging from PV surplus */
+    EnergyAppModelFeatureEnum["PvSurplusCharging"] = "pv-surplus-charging";
+    // Heat Pump
+    /** Domestic hot water heating can be forced on demand (DHW boost) */
+    EnergyAppModelFeatureEnum["HeatpumpDhwBoost"] = "heatpump-dhw-boost";
+    /** The target temperature setpoint can be controlled */
+    EnergyAppModelFeatureEnum["HeatpumpTemperatureSetpoint"] = "heatpump-temperature-setpoint";
+    /** The heat pump output power can be modulated */
+    EnergyAppModelFeatureEnum["HeatpumpPowerModulation"] = "heatpump-power-modulation";
+    /** The model supports the SG Ready interface for smart-grid signalling */
+    EnergyAppModelFeatureEnum["HeatpumpSgReady"] = "heatpump-sg-ready";
+    // Climate Control / Air Conditioning
+    /** The target temperature setpoint can be controlled */
+    EnergyAppModelFeatureEnum["ClimateTemperatureSetpoint"] = "climate-temperature-setpoint";
+    /** The operating mode (heat / cool / fan / off) can be controlled */
+    EnergyAppModelFeatureEnum["ClimateModeControl"] = "climate-mode-control";
+    // Meter
+    /** The grid power (import / export) can be read out */
+    EnergyAppModelFeatureEnum["GridPowerReadout"] = "grid-power-readout";
+    /** The accumulated energy consumption can be read out */
+    EnergyAppModelFeatureEnum["EnergyConsumptionReadout"] = "energy-consumption-readout";
+    // Smart Plug
+    /** The plug can be switched on and off */
+    EnergyAppModelFeatureEnum["SwitchOnOff"] = "switch-on-off";
+    /** The plug can measure the connected load's power */
+    EnergyAppModelFeatureEnum["PowerMeasurement"] = "power-measurement";
+})(EnergyAppModelFeatureEnum || (exports.EnergyAppModelFeatureEnum = EnergyAppModelFeatureEnum = {}));

package/dist/cjs/energy-app-model-feature.enum.d.cts

@@ -0,0 +1,48 @@
+/**
+ * Important capabilities a specific device model can support.
+ *
+ * Declared per model inside an Energy App package's compatibility section
+ * (see {@link EnergyAppPackageCompatibilityModel}) so the enyo Store and
+ * onboarding flows can surface accurate, model-level feature information to
+ * users. Values are grouped by device category for readability.
+ */
+export declare enum EnergyAppModelFeatureEnum {
+    /** The battery can be charged from the grid (not only from PV surplus) */
+    BatteryChargingFromGrid = "battery-charging-from-grid",
+    /** The maximum charge power or target state of charge can be limited */
+    BatteryChargeLimitation = "battery-charge-limitation",
+    /** The maximum discharge power or minimum state of charge can be limited */
+    BatteryDischargeLimitation = "battery-discharge-limitation",
+    /** The PV feed-in power into the grid can be limited (curtailment) */
+    PvFeedInLimitation = "pv-feed-in-limitation",
+    /** The inverter active power output can be limited */
+    InverterPowerLimitation = "inverter-power-limitation",
+    /** Charging can be started and stopped remotely */
+    ChargingStartStop = "charging-start-stop",
+    /** The charging power (in Ampere or Watt) can be limited */
+    ChargingPowerLimitation = "charging-power-limitation",
+    /** The model supports switching between single- and three-phase charging */
+    ChargingPhaseSwitching = "charging-phase-switching",
+    /** The model supports charging from PV surplus */
+    PvSurplusCharging = "pv-surplus-charging",
+    /** Domestic hot water heating can be forced on demand (DHW boost) */
+    HeatpumpDhwBoost = "heatpump-dhw-boost",
+    /** The target temperature setpoint can be controlled */
+    HeatpumpTemperatureSetpoint = "heatpump-temperature-setpoint",
+    /** The heat pump output power can be modulated */
+    HeatpumpPowerModulation = "heatpump-power-modulation",
+    /** The model supports the SG Ready interface for smart-grid signalling */
+    HeatpumpSgReady = "heatpump-sg-ready",
+    /** The target temperature setpoint can be controlled */
+    ClimateTemperatureSetpoint = "climate-temperature-setpoint",
+    /** The operating mode (heat / cool / fan / off) can be controlled */
+    ClimateModeControl = "climate-mode-control",
+    /** The grid power (import / export) can be read out */
+    GridPowerReadout = "grid-power-readout",
+    /** The accumulated energy consumption can be read out */
+    EnergyConsumptionReadout = "energy-consumption-readout",
+    /** The plug can be switched on and off */
+    SwitchOnOff = "switch-on-off",
+    /** The plug can measure the connected load's power */
+    PowerMeasurement = "power-measurement"
+}

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

@@ -1,4 +1,5 @@
 import { EnergyAppPermissionType } from "./energy-app-permission.type.cjs";
+import { EnergyAppModelFeatureEnum } from "./energy-app-model-feature.enum.cjs";
 export type EnergyAppPackageLanguage = 'de' | 'en';
 export declare enum EnergyAppPackageCategory {
     Inverter = "inverter",
@@ -161,6 +162,13 @@ export interface EnergyAppPackageCompatibilityModel {
     minimumFirmwareVersion?: string;
     /** Optional internal note explaining model-specific caveats or limitations */
     internalComment?: string;
+    /**
+     * Important capabilities this specific model supports (e.g. charging the
+     * battery from grid, limiting the charge, or forcing a heat pump DHW boost).
+     * Lets the enyo Store and onboarding flows surface accurate, model-level
+     * feature information.
+     */
+    features: EnergyAppModelFeatureEnum[];
 }
 /**
  * A vendor and the list of its models supported by an Energy App package.

package/dist/cjs/energy-app.cjs

@@ -60,8 +60,14 @@ class EnergyApp {
             await callback();
         });
     }
-    useFetch() {
-        return this.energyAppSdk.useFetch();
+    /**
+     * Returns a `fetch` implementation provided by the runtime.
+     * @param options - Optional configuration (e.g. {@link TlsClientOptions} for mutual TLS).
+     *   When `options.tls` is set the runtime binds a TLS-configured dispatcher to the fetch.
+     * @returns A `fetch` function that still passes through the runtime allow-list.
+     */
+    useFetch(options) {
+        return this.energyAppSdk.useFetch(options);
     }
     useInterval() {
         return this.energyAppSdk.useInterval();

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

@@ -37,6 +37,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.cjs";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.cjs";
 import { EnergyAppBattery } from "./packages/energy-app-battery.cjs";
+import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
  * to the runtime-provided `energyAppSdkInstance` global.
@@ -68,7 +69,13 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
     updateEnergyAppState(state: EnergyAppStateEnum): void;
     register(callback: (packageName: string, version: number, channel: EnyoPackageChannel, deviceId: string) => void | Promise<void>): void;
     onShutdown(callback: () => void | Promise<void>): void;
-    useFetch(): typeof fetch;
+    /**
+     * Returns a `fetch` implementation provided by the runtime.
+     * @param options - Optional configuration (e.g. {@link TlsClientOptions} for mutual TLS).
+     *   When `options.tls` is set the runtime binds a TLS-configured dispatcher to the fetch.
+     * @returns A `fetch` function that still passes through the runtime allow-list.
+     */
+    useFetch(options?: UseFetchOptions): typeof fetch;
     useInterval(): EnergyAppInterval;
     useModbus(): EnergyAppModbus;
     useNetworkDevices(): EnergyAppNetworkDevice;

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

@@ -36,6 +36,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.cjs";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.cjs";
 import { EnergyAppBattery } from "./packages/energy-app-battery.cjs";
+import { UseFetchOptions } from "./types/enyo-fetch.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -60,8 +61,8 @@ export interface EnyoEnergyAppSdk {
     isSystemOnline: () => boolean;
     /** Register a listener that gets called when the network status changes */
     onNetworkStatusChanged: (listener: (online: boolean) => void | Promise<void>) => string;
-    /** Get the fetch API for HTTP requests */
-    useFetch: () => typeof fetch;
+    /** Get the fetch API for HTTP requests, optionally configured with TLS options */
+    useFetch: (options?: UseFetchOptions) => typeof fetch;
     /** Get the interval management API */
     useInterval: () => EnergyAppInterval;
     /** Get the Modbus communication API */

package/dist/cjs/index.cjs

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./energy-app.cjs"), exports);
 __exportStar(require("./energy-app-appliance-type.enum.cjs"), exports);
 __exportStar(require("./energy-app-package-definition.cjs"), exports);
+__exportStar(require("./energy-app-model-feature.enum.cjs"), exports);
 __exportStar(require("./version.cjs"), exports);
 __exportStar(require("./implementations/ocpp/ocpp16.cjs"), exports);
 __exportStar(require("./implementations/ocpp/ocpp201.cjs"), exports);
@@ -101,3 +102,4 @@ __exportStar(require("./implementations/appliance-command-forecast/appliance-com
 __exportStar(require("./implementations/energy-manager-diagnostics/energy-manager-diagnostics-validators.cjs"), exports);
 __exportStar(require("./types/enyo-battery-state.cjs"), exports);
 __exportStar(require("./packages/energy-app-battery.cjs"), exports);
+__exportStar(require("./types/enyo-fetch.cjs"), exports);

package/dist/cjs/index.d.cts

@@ -1,6 +1,7 @@
 export * from './energy-app.cjs';
 export * from './energy-app-appliance-type.enum.cjs';
 export * from './energy-app-package-definition.cjs';
+export * from './energy-app-model-feature.enum.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
 export * from './implementations/ocpp/ocpp201.cjs';
@@ -85,3 +86,4 @@ export * from './implementations/appliance-command-forecast/appliance-command-fo
 export * from './implementations/energy-manager-diagnostics/energy-manager-diagnostics-validators.cjs';
 export * from './types/enyo-battery-state.cjs';
 export * from './packages/energy-app-battery.cjs';
+export * from './types/enyo-fetch.cjs';

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * TLS material for an outbound HTTPS connection made through {@link UseFetchOptions}.
+ *
+ * All certificate/key fields accept PEM as a UTF-8 string or a {@link Buffer}. When passed
+ * to `useFetch`, the runtime uses these values to build a TLS-configured dispatcher for the
+ * underlying fetch (e.g. for mutual TLS, custom trust anchors, or self-signed servers).
+ */
+export interface TlsClientOptions {
+    /** Client cert chain (PEM) presented during the TLS handshake (mutual TLS). */
+    cert?: string | Buffer;
+    /** Private key (PEM) for the client cert. */
+    key?: string | Buffer;
+    /** Trusted CA cert(s) (PEM) to validate the server. */
+    ca?: string | Buffer | Array<string | Buffer>;
+    /** When false, accept self-signed/untrusted server certs. Default true. */
+    rejectUnauthorized?: boolean;
+    /** Optional SNI / expected server hostname override. */
+    servername?: string;
+}
+/**
+ * Options accepted by `useFetch` to customize the returned `fetch` implementation.
+ *
+ * The returned fetch still passes through the runtime's origin allow-list; these options only
+ * add behavior (currently: TLS configuration) on top of that.
+ */
+export interface UseFetchOptions {
+    /** TLS / mutual-TLS configuration for outbound HTTPS requests. */
+    tls?: TlsClientOptions;
+}

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

package/dist/energy-app-model-feature.enum.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Important capabilities a specific device model can support.
+ *
+ * Declared per model inside an Energy App package's compatibility section
+ * (see {@link EnergyAppPackageCompatibilityModel}) so the enyo Store and
+ * onboarding flows can surface accurate, model-level feature information to
+ * users. Values are grouped by device category for readability.
+ */
+export declare enum EnergyAppModelFeatureEnum {
+    /** The battery can be charged from the grid (not only from PV surplus) */
+    BatteryChargingFromGrid = "battery-charging-from-grid",
+    /** The maximum charge power or target state of charge can be limited */
+    BatteryChargeLimitation = "battery-charge-limitation",
+    /** The maximum discharge power or minimum state of charge can be limited */
+    BatteryDischargeLimitation = "battery-discharge-limitation",
+    /** The PV feed-in power into the grid can be limited (curtailment) */
+    PvFeedInLimitation = "pv-feed-in-limitation",
+    /** The inverter active power output can be limited */
+    InverterPowerLimitation = "inverter-power-limitation",
+    /** Charging can be started and stopped remotely */
+    ChargingStartStop = "charging-start-stop",
+    /** The charging power (in Ampere or Watt) can be limited */
+    ChargingPowerLimitation = "charging-power-limitation",
+    /** The model supports switching between single- and three-phase charging */
+    ChargingPhaseSwitching = "charging-phase-switching",
+    /** The model supports charging from PV surplus */
+    PvSurplusCharging = "pv-surplus-charging",
+    /** Domestic hot water heating can be forced on demand (DHW boost) */
+    HeatpumpDhwBoost = "heatpump-dhw-boost",
+    /** The target temperature setpoint can be controlled */
+    HeatpumpTemperatureSetpoint = "heatpump-temperature-setpoint",
+    /** The heat pump output power can be modulated */
+    HeatpumpPowerModulation = "heatpump-power-modulation",
+    /** The model supports the SG Ready interface for smart-grid signalling */
+    HeatpumpSgReady = "heatpump-sg-ready",
+    /** The target temperature setpoint can be controlled */
+    ClimateTemperatureSetpoint = "climate-temperature-setpoint",
+    /** The operating mode (heat / cool / fan / off) can be controlled */
+    ClimateModeControl = "climate-mode-control",
+    /** The grid power (import / export) can be read out */
+    GridPowerReadout = "grid-power-readout",
+    /** The accumulated energy consumption can be read out */
+    EnergyConsumptionReadout = "energy-consumption-readout",
+    /** The plug can be switched on and off */
+    SwitchOnOff = "switch-on-off",
+    /** The plug can measure the connected load's power */
+    PowerMeasurement = "power-measurement"
+}

package/dist/energy-app-model-feature.enum.js

@@ -0,0 +1,56 @@
+/**
+ * Important capabilities a specific device model can support.
+ *
+ * Declared per model inside an Energy App package's compatibility section
+ * (see {@link EnergyAppPackageCompatibilityModel}) so the enyo Store and
+ * onboarding flows can surface accurate, model-level feature information to
+ * users. Values are grouped by device category for readability.
+ */
+export var EnergyAppModelFeatureEnum;
+(function (EnergyAppModelFeatureEnum) {
+    // Battery / Storage
+    /** The battery can be charged from the grid (not only from PV surplus) */
+    EnergyAppModelFeatureEnum["BatteryChargingFromGrid"] = "battery-charging-from-grid";
+    /** The maximum charge power or target state of charge can be limited */
+    EnergyAppModelFeatureEnum["BatteryChargeLimitation"] = "battery-charge-limitation";
+    /** The maximum discharge power or minimum state of charge can be limited */
+    EnergyAppModelFeatureEnum["BatteryDischargeLimitation"] = "battery-discharge-limitation";
+    // Inverter / PV
+    /** The PV feed-in power into the grid can be limited (curtailment) */
+    EnergyAppModelFeatureEnum["PvFeedInLimitation"] = "pv-feed-in-limitation";
+    /** The inverter active power output can be limited */
+    EnergyAppModelFeatureEnum["InverterPowerLimitation"] = "inverter-power-limitation";
+    // Wallbox / Charging
+    /** Charging can be started and stopped remotely */
+    EnergyAppModelFeatureEnum["ChargingStartStop"] = "charging-start-stop";
+    /** The charging power (in Ampere or Watt) can be limited */
+    EnergyAppModelFeatureEnum["ChargingPowerLimitation"] = "charging-power-limitation";
+    /** The model supports switching between single- and three-phase charging */
+    EnergyAppModelFeatureEnum["ChargingPhaseSwitching"] = "charging-phase-switching";
+    /** The model supports charging from PV surplus */
+    EnergyAppModelFeatureEnum["PvSurplusCharging"] = "pv-surplus-charging";
+    // Heat Pump
+    /** Domestic hot water heating can be forced on demand (DHW boost) */
+    EnergyAppModelFeatureEnum["HeatpumpDhwBoost"] = "heatpump-dhw-boost";
+    /** The target temperature setpoint can be controlled */
+    EnergyAppModelFeatureEnum["HeatpumpTemperatureSetpoint"] = "heatpump-temperature-setpoint";
+    /** The heat pump output power can be modulated */
+    EnergyAppModelFeatureEnum["HeatpumpPowerModulation"] = "heatpump-power-modulation";
+    /** The model supports the SG Ready interface for smart-grid signalling */
+    EnergyAppModelFeatureEnum["HeatpumpSgReady"] = "heatpump-sg-ready";
+    // Climate Control / Air Conditioning
+    /** The target temperature setpoint can be controlled */
+    EnergyAppModelFeatureEnum["ClimateTemperatureSetpoint"] = "climate-temperature-setpoint";
+    /** The operating mode (heat / cool / fan / off) can be controlled */
+    EnergyAppModelFeatureEnum["ClimateModeControl"] = "climate-mode-control";
+    // Meter
+    /** The grid power (import / export) can be read out */
+    EnergyAppModelFeatureEnum["GridPowerReadout"] = "grid-power-readout";
+    /** The accumulated energy consumption can be read out */
+    EnergyAppModelFeatureEnum["EnergyConsumptionReadout"] = "energy-consumption-readout";
+    // Smart Plug
+    /** The plug can be switched on and off */
+    EnergyAppModelFeatureEnum["SwitchOnOff"] = "switch-on-off";
+    /** The plug can measure the connected load's power */
+    EnergyAppModelFeatureEnum["PowerMeasurement"] = "power-measurement";
+})(EnergyAppModelFeatureEnum || (EnergyAppModelFeatureEnum = {}));

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

@@ -1,4 +1,5 @@
 import { EnergyAppPermissionType } from "./energy-app-permission.type.js";
+import { EnergyAppModelFeatureEnum } from "./energy-app-model-feature.enum.js";
 export type EnergyAppPackageLanguage = 'de' | 'en';
 export declare enum EnergyAppPackageCategory {
     Inverter = "inverter",
@@ -161,6 +162,13 @@ export interface EnergyAppPackageCompatibilityModel {
     minimumFirmwareVersion?: string;
     /** Optional internal note explaining model-specific caveats or limitations */
     internalComment?: string;
+    /**
+     * Important capabilities this specific model supports (e.g. charging the
+     * battery from grid, limiting the charge, or forcing a heat pump DHW boost).
+     * Lets the enyo Store and onboarding flows surface accurate, model-level
+     * feature information.
+     */
+    features: EnergyAppModelFeatureEnum[];
 }
 /**
  * A vendor and the list of its models supported by an Energy App package.

package/dist/energy-app.d.ts

@@ -37,6 +37,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.js";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.js";
 import { EnergyAppBattery } from "./packages/energy-app-battery.js";
+import { UseFetchOptions } from "./types/enyo-fetch.js";
 /**
  * Concrete implementation of {@link EnyoEnergyAppSdk} that delegates every call
  * to the runtime-provided `energyAppSdkInstance` global.
@@ -68,7 +69,13 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
     updateEnergyAppState(state: EnergyAppStateEnum): void;
     register(callback: (packageName: string, version: number, channel: EnyoPackageChannel, deviceId: string) => void | Promise<void>): void;
     onShutdown(callback: () => void | Promise<void>): void;
-    useFetch(): typeof fetch;
+    /**
+     * Returns a `fetch` implementation provided by the runtime.
+     * @param options - Optional configuration (e.g. {@link TlsClientOptions} for mutual TLS).
+     *   When `options.tls` is set the runtime binds a TLS-configured dispatcher to the fetch.
+     * @returns A `fetch` function that still passes through the runtime allow-list.
+     */
+    useFetch(options?: UseFetchOptions): typeof fetch;
     useInterval(): EnergyAppInterval;
     useModbus(): EnergyAppModbus;
     useNetworkDevices(): EnergyAppNetworkDevice;

package/dist/energy-app.js

@@ -57,8 +57,14 @@ export class EnergyApp {
             await callback();
         });
     }
-    useFetch() {
-        return this.energyAppSdk.useFetch();
+    /**
+     * Returns a `fetch` implementation provided by the runtime.
+     * @param options - Optional configuration (e.g. {@link TlsClientOptions} for mutual TLS).
+     *   When `options.tls` is set the runtime binds a TLS-configured dispatcher to the fetch.
+     * @returns A `fetch` function that still passes through the runtime allow-list.
+     */
+    useFetch(options) {
+        return this.energyAppSdk.useFetch(options);
     }
     useInterval() {
         return this.energyAppSdk.useInterval();

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

@@ -36,6 +36,7 @@ import { EnergyAppGridConnectionPoint } from "./packages/energy-app-grid-connect
 import { EnergyAppConfigurationManager } from "./packages/energy-app-configuration-manager.js";
 import { EnergyAppApplianceEnergyManagerForecast } from "./packages/energy-app-appliance-energy-manager-forecast.js";
 import { EnergyAppBattery } from "./packages/energy-app-battery.js";
+import { UseFetchOptions } from "./types/enyo-fetch.js";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -60,8 +61,8 @@ export interface EnyoEnergyAppSdk {
     isSystemOnline: () => boolean;
     /** Register a listener that gets called when the network status changes */
     onNetworkStatusChanged: (listener: (online: boolean) => void | Promise<void>) => string;
-    /** Get the fetch API for HTTP requests */
-    useFetch: () => typeof fetch;
+    /** Get the fetch API for HTTP requests, optionally configured with TLS options */
+    useFetch: (options?: UseFetchOptions) => typeof fetch;
     /** Get the interval management API */
     useInterval: () => EnergyAppInterval;
     /** Get the Modbus communication API */

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './energy-app.js';
 export * from './energy-app-appliance-type.enum.js';
 export * from './energy-app-package-definition.js';
+export * from './energy-app-model-feature.enum.js';
 export * from './version.js';
 export * from './implementations/ocpp/ocpp16.js';
 export * from './implementations/ocpp/ocpp201.js';
@@ -85,3 +86,4 @@ export * from './implementations/appliance-command-forecast/appliance-command-fo
 export * from './implementations/energy-manager-diagnostics/energy-manager-diagnostics-validators.js';
 export * from './types/enyo-battery-state.js';
 export * from './packages/energy-app-battery.js';
+export * from './types/enyo-fetch.js';

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './energy-app.js';
 export * from './energy-app-appliance-type.enum.js';
 export * from './energy-app-package-definition.js';
+export * from './energy-app-model-feature.enum.js';
 export * from './version.js';
 export * from './implementations/ocpp/ocpp16.js';
 export * from './implementations/ocpp/ocpp201.js';
@@ -85,3 +86,4 @@ export * from './implementations/appliance-command-forecast/appliance-command-fo
 export * from './implementations/energy-manager-diagnostics/energy-manager-diagnostics-validators.js';
 export * from './types/enyo-battery-state.js';
 export * from './packages/energy-app-battery.js';
+export * from './types/enyo-fetch.js';

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

@@ -0,0 +1,29 @@
+/**
+ * TLS material for an outbound HTTPS connection made through {@link UseFetchOptions}.
+ *
+ * All certificate/key fields accept PEM as a UTF-8 string or a {@link Buffer}. When passed
+ * to `useFetch`, the runtime uses these values to build a TLS-configured dispatcher for the
+ * underlying fetch (e.g. for mutual TLS, custom trust anchors, or self-signed servers).
+ */
+export interface TlsClientOptions {
+    /** Client cert chain (PEM) presented during the TLS handshake (mutual TLS). */
+    cert?: string | Buffer;
+    /** Private key (PEM) for the client cert. */
+    key?: string | Buffer;
+    /** Trusted CA cert(s) (PEM) to validate the server. */
+    ca?: string | Buffer | Array<string | Buffer>;
+    /** When false, accept self-signed/untrusted server certs. Default true. */
+    rejectUnauthorized?: boolean;
+    /** Optional SNI / expected server hostname override. */
+    servername?: string;
+}
+/**
+ * Options accepted by `useFetch` to customize the returned `fetch` implementation.
+ *
+ * The returned fetch still passes through the runtime's origin allow-list; these options only
+ * add behavior (currently: TLS configuration) on top of that.
+ */
+export interface UseFetchOptions {
+    /** TLS / mutual-TLS configuration for outbound HTTPS requests. */
+    tls?: TlsClientOptions;
+}

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