@enyo-energy/energy-app-sdk 0.0.163 → 0.0.165

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/implementations/appliances/appliance-manager.cjs

@@ -96,6 +96,13 @@ class ApplianceManager {
      * Note: the merge is one level deep. Nested objects inside a metadata sub-object
      * are replaced, not merged.
      *
+     * Update contract: an omitted optional field leaves the stored value unchanged.
+     * For the {@link MERGEABLE_METADATA_KEYS} this is enforced by the per-key merge
+     * below; for the other optional top-level fields (`availableFeatures`,
+     * `cloudPackageId`) the caller-facing {@link createOrUpdateAppliance} drops the
+     * key when the value is `undefined` so this spread cannot overwrite it. To clear
+     * or replace such a field, pass an explicit value (e.g. an empty array `[]`).
+     *
      * @param existing The existing appliance data
      * @param update The partial update data to merge
      * @returns The merged appliance data (without `id`)
@@ -200,8 +207,14 @@ class ApplianceManager {
             inverter: appliance.inverter,
             temperatureSensor: appliance.temperatureSensor,
             airConditioning: appliance.airConditioning,
-            cloudPackageId: appliance.cloudPackageId,
-            availableFeatures: appliance.availableFeatures
+            // Conditionally spread the two optional top-level fields that are NOT
+            // covered by MERGEABLE_METADATA_KEYS. If they were always materialized
+            // as explicit keys, an omitted (undefined) value would clobber the
+            // stored value during mergeApplianceData's `{...existing, ...update}`
+            // spread on an update. `!== undefined` keeps an explicit `[]` (clear)
+            // while dropping omitted fields so the existing value is preserved.
+            ...(appliance.cloudPackageId !== undefined && { cloudPackageId: appliance.cloudPackageId }),
+            ...(appliance.availableFeatures !== undefined && { availableFeatures: appliance.availableFeatures }),
         };
         let applianceData = newApplianceData;
         if (existingApplianceId) {

package/dist/cjs/implementations/appliances/appliance-manager.d.cts

@@ -129,6 +129,13 @@ export declare class ApplianceManager {
      * Note: the merge is one level deep. Nested objects inside a metadata sub-object
      * are replaced, not merged.
      *
+     * Update contract: an omitted optional field leaves the stored value unchanged.
+     * For the {@link MERGEABLE_METADATA_KEYS} this is enforced by the per-key merge
+     * below; for the other optional top-level fields (`availableFeatures`,
+     * `cloudPackageId`) the caller-facing {@link createOrUpdateAppliance} drops the
+     * key when the value is `undefined` so this spread cannot overwrite it. To clear
+     * or replace such a field, pass an explicit value (e.g. an empty array `[]`).
+     *
      * @param existing The existing appliance data
      * @param update The partial update data to merge
      * @returns The merged appliance data (without `id`)

package/dist/cjs/index.cjs

@@ -102,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

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

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/implementations/appliances/appliance-manager.d.ts

@@ -129,6 +129,13 @@ export declare class ApplianceManager {
      * Note: the merge is one level deep. Nested objects inside a metadata sub-object
      * are replaced, not merged.
      *
+     * Update contract: an omitted optional field leaves the stored value unchanged.
+     * For the {@link MERGEABLE_METADATA_KEYS} this is enforced by the per-key merge
+     * below; for the other optional top-level fields (`availableFeatures`,
+     * `cloudPackageId`) the caller-facing {@link createOrUpdateAppliance} drops the
+     * key when the value is `undefined` so this spread cannot overwrite it. To clear
+     * or replace such a field, pass an explicit value (e.g. an empty array `[]`).
+     *
      * @param existing The existing appliance data
      * @param update The partial update data to merge
      * @returns The merged appliance data (without `id`)

package/dist/implementations/appliances/appliance-manager.js

@@ -90,6 +90,13 @@ export class ApplianceManager {
      * Note: the merge is one level deep. Nested objects inside a metadata sub-object
      * are replaced, not merged.
      *
+     * Update contract: an omitted optional field leaves the stored value unchanged.
+     * For the {@link MERGEABLE_METADATA_KEYS} this is enforced by the per-key merge
+     * below; for the other optional top-level fields (`availableFeatures`,
+     * `cloudPackageId`) the caller-facing {@link createOrUpdateAppliance} drops the
+     * key when the value is `undefined` so this spread cannot overwrite it. To clear
+     * or replace such a field, pass an explicit value (e.g. an empty array `[]`).
+     *
      * @param existing The existing appliance data
      * @param update The partial update data to merge
      * @returns The merged appliance data (without `id`)
@@ -194,8 +201,14 @@ export class ApplianceManager {
             inverter: appliance.inverter,
             temperatureSensor: appliance.temperatureSensor,
             airConditioning: appliance.airConditioning,
-            cloudPackageId: appliance.cloudPackageId,
-            availableFeatures: appliance.availableFeatures
+            // Conditionally spread the two optional top-level fields that are NOT
+            // covered by MERGEABLE_METADATA_KEYS. If they were always materialized
+            // as explicit keys, an omitted (undefined) value would clobber the
+            // stored value during mergeApplianceData's `{...existing, ...update}`
+            // spread on an update. `!== undefined` keeps an explicit `[]` (clear)
+            // while dropping omitted fields so the existing value is preserved.
+            ...(appliance.cloudPackageId !== undefined && { cloudPackageId: appliance.cloudPackageId }),
+            ...(appliance.availableFeatures !== undefined && { availableFeatures: appliance.availableFeatures }),
         };
         let applianceData = newApplianceData;
         if (existingApplianceId) {

package/dist/index.d.ts

@@ -86,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

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