@enyo-energy/sunspec-sdk 0.0.68 → 0.0.69

package/README.md

@@ -4,6 +4,7 @@ SunSpec Modbus client for reading data from solar inverters, batteries, meters,
 
 ## Table of Contents
 
+- [Appliance Manager Integration](#appliance-manager-integration)
 - [How Addressing Works](#how-addressing-works)
 - [Bulk Register Reading](#bulk-register-reading)
 - [Data Types](#data-types)
@@ -22,6 +23,29 @@ SunSpec Modbus client for reading data from solar inverters, batteries, meters,
 
 ---
 
+## Appliance Manager Integration
+
+`SunspecInverter`, `SunspecBattery`, and `SunspecMeter` take an `ApplianceManager` from `@enyo-energy/energy-app-sdk` and call `createOrUpdateAppliance` with the device's `networkDevice` plus the common block's `serialNumber` (which may be empty for some firmware revisions).
+
+Since `@enyo-energy/energy-app-sdk` 0.0.135 the default identifier strategy is `SerialNumberStrategy`. If a device's common block has no serial number, `createOrUpdateAppliance` throws `MissingIdentifierError` and the SDK logs the error and skips appliance creation.
+
+Consumers whose devices may not expose a serial number should configure a fallback when initializing the `ApplianceManager`, e.g.:
+
+```ts
+import { ApplianceManager, FallbackIdentifierStrategy, SerialNumberStrategy, HostnameStrategy } from '@enyo-energy/energy-app-sdk';
+
+const applianceManager = await ApplianceManager.initialize(energyApp, {
+    identifierStrategy: new FallbackIdentifierStrategy([
+        new SerialNumberStrategy(),
+        new HostnameStrategy(),
+    ]),
+});
+```
+
+This SDK does not configure the strategy itself — it is the consumer app's responsibility.
+
+---
+
 ## How Addressing Works
 
 ### Base Address Detection

package/dist/cjs/sunspec-devices.cjs

@@ -342,7 +342,12 @@ class SunspecInverter extends BaseSunspecDevice {
     async disconnect() {
         this.stopDataBusListening();
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark inverter offline on disconnect: ${error}`);
+            }
         }
         // Note: We don't disconnect the sunspecClient as it may be shared
     }
@@ -819,7 +824,12 @@ class SunspecBattery extends BaseSunspecDevice {
     async disconnect() {
         this.stopDataBusListening();
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark battery offline on disconnect: ${error}`);
+            }
         }
     }
     /**
@@ -1393,7 +1403,12 @@ class SunspecMeter extends BaseSunspecDevice {
      */
     async disconnect() {
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark meter offline on disconnect: ${error}`);
+            }
         }
         // Close just this meter's unit; other devices on the same network device stay open.
         await this.sunspecClient.disconnectUnit(this.unitId);

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

package/dist/sunspec-devices.js

@@ -338,7 +338,12 @@ export class SunspecInverter extends BaseSunspecDevice {
     async disconnect() {
         this.stopDataBusListening();
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark inverter offline on disconnect: ${error}`);
+            }
         }
         // Note: We don't disconnect the sunspecClient as it may be shared
     }
@@ -814,7 +819,12 @@ export class SunspecBattery extends BaseSunspecDevice {
     async disconnect() {
         this.stopDataBusListening();
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark battery offline on disconnect: ${error}`);
+            }
         }
     }
     /**
@@ -1387,7 +1397,12 @@ export class SunspecMeter extends BaseSunspecDevice {
      */
     async disconnect() {
         if (this.applianceId) {
-            await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            try {
+                await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
+            }
+            catch (error) {
+                console.error(`Failed to mark meter offline on disconnect: ${error}`);
+            }
         }
         // Close just this meter's unit; other devices on the same network device stay open.
         await this.sunspecClient.disconnectUnit(this.unitId);

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.68";
+export declare const SDK_VERSION = "0.0.69";
 /**
  * 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.68';
+export const SDK_VERSION = '0.0.69';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enyo-energy/sunspec-sdk",
-  "version": "0.0.68",
+  "version": "0.0.69",
   "description": "enyo Energy Sunspec SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -37,7 +37,7 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@enyo-energy/energy-app-sdk": "^0.0.132"
+    "@enyo-energy/energy-app-sdk": "^0.0.135"
   },
   "volta": {
     "node": "22.17.0"