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

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/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.164';
+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.164";
+export declare const SDK_VERSION = "0.0.165";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

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/version.d.ts

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