@enyo-energy/sunspec-sdk 0.0.78 → 0.0.80

package/dist/cjs/sunspec-devices.cjs

@@ -377,9 +377,18 @@ class SunspecInverter extends BaseSunspecDevice {
         }
         await this.loadErrorState();
         this.startDataBusListening();
+        // Cold-start recovery: if the persisted state says we were stuck in
+        // connection_lost but connect() just succeeded (we read commonBlock,
+        // settings, controls and MPPT above), the Modbus path is provably
+        // healthy. Clear the stale fault and emit Healthy via the same hook
+        // the in-process reconnect path uses.
+        if (this.errorState.lastStatus === 'connection_lost') {
+            await this.onConnectionRestored();
+        }
     }
     async disconnect() {
         this.stopDataBusListening();
+        await this.removePersistedErrorState();
         if (this.applianceId) {
             try {
                 await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Offline);
@@ -435,10 +444,7 @@ class SunspecInverter extends BaseSunspecDevice {
                     }
                 };
                 messages.push(inverterMessage);
-                const statusMessage = await this.detectAndEmitStatusTransition(inverterData, timestamp);
-                if (statusMessage) {
-                    messages.push(statusMessage);
-                }
+                await this.detectAndEmitStatusTransition(inverterData, timestamp);
             }
             this.consecutiveReconnectFailures = 0;
             if (this.applianceId) {
@@ -571,17 +577,29 @@ class SunspecInverter extends BaseSunspecDevice {
             console.error(`Inverter ${this.applianceId}: failed to persist error state: ${error}`);
         }
     }
+    async removePersistedErrorState() {
+        const storage = this.storage ?? this.energyApp.useStorage();
+        try {
+            await storage.remove(this.storageKey());
+        }
+        catch (error) {
+            console.error(`Inverter ${this.applianceId}: failed to remove persisted error state: ${error}`);
+        }
+    }
     async detectAndEmitStatusTransition(data, timestamp) {
-        if (!this.applianceId)
-            return undefined;
+        if (!this.applianceId || !this.dataBus)
+            return;
         const { codes, codeIds } = this.decodeActiveErrors(data);
         const recoveringFromConnectionLoss = this.errorState.lastStatus === 'connection_lost';
         if (!recoveringFromConnectionLoss && !this.hasErrorSetChanged(codeIds)) {
-            return undefined;
+            return;
         }
         const newStatus = codeIds.length === 0
             ? enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy
             : enyo_appliance_js_1.EnyoApplianceStatusEnum.Faulted;
+        const message = this.buildStatusMessage(newStatus, codes, timestamp);
+        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             evt1: data.events,
             evt2: data.events2,
@@ -593,8 +611,6 @@ class SunspecInverter extends BaseSunspecDevice {
             lastStatus: newStatus === enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
-        return this.buildStatusMessage(newStatus, codes, timestamp);
     }
     async onConnectionFailure(consecutiveFailures) {
         if (!this.applianceId || !this.dataBus)
@@ -611,13 +627,13 @@ class SunspecInverter extends BaseSunspecDevice {
                 ]
             }];
         const message = this.buildStatusMessage(enyo_appliance_js_1.EnyoApplianceStatusEnum.Faulted, errorCodes, new Date());
+        console.log(`Inverter ${this.applianceId}: emitting faulted (${sunspec_interfaces_js_1.SUNSPEC_CONNECTION_LOST_CODE}) after ${consecutiveFailures} consecutive reconnect failures`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             activeCodes: [sunspec_interfaces_js_1.SUNSPEC_CONNECTION_LOST_CODE],
             lastStatus: 'connection_lost',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: emitting faulted (${sunspec_interfaces_js_1.SUNSPEC_CONNECTION_LOST_CODE}) after ${consecutiveFailures} consecutive reconnect failures`);
-        this.dataBus.sendMessage([message]);
     }
     async onConnectionRestored() {
         if (!this.applianceId || !this.dataBus)
@@ -625,13 +641,13 @@ class SunspecInverter extends BaseSunspecDevice {
         if (this.errorState.lastStatus !== 'connection_lost')
             return;
         const message = this.buildStatusMessage(enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy, [], new Date());
+        console.log(`Inverter ${this.applianceId}: emitting healthy after reconnect`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             activeCodes: [],
             lastStatus: 'healthy',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: emitting healthy after reconnect`);
-        this.dataBus.sendMessage([message]);
     }
     /**
      * Compute the currently active feed-in / production limit in Watts from the

package/dist/cjs/sunspec-devices.d.cts

@@ -148,6 +148,7 @@ export declare class SunspecInverter extends BaseSunspecDevice {
     private storageKey;
     private loadErrorState;
     private persistErrorState;
+    private removePersistedErrorState;
     private detectAndEmitStatusTransition;
     protected onConnectionFailure(consecutiveFailures: number): Promise<void>;
     protected onConnectionRestored(): Promise<void>;

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

package/dist/sunspec-devices.d.ts

@@ -148,6 +148,7 @@ export declare class SunspecInverter extends BaseSunspecDevice {
     private storageKey;
     private loadErrorState;
     private persistErrorState;
+    private removePersistedErrorState;
     private detectAndEmitStatusTransition;
     protected onConnectionFailure(consecutiveFailures: number): Promise<void>;
     protected onConnectionRestored(): Promise<void>;

package/dist/sunspec-devices.js

@@ -370,9 +370,18 @@ export class SunspecInverter extends BaseSunspecDevice {
         }
         await this.loadErrorState();
         this.startDataBusListening();
+        // Cold-start recovery: if the persisted state says we were stuck in
+        // connection_lost but connect() just succeeded (we read commonBlock,
+        // settings, controls and MPPT above), the Modbus path is provably
+        // healthy. Clear the stale fault and emit Healthy via the same hook
+        // the in-process reconnect path uses.
+        if (this.errorState.lastStatus === 'connection_lost') {
+            await this.onConnectionRestored();
+        }
     }
     async disconnect() {
         this.stopDataBusListening();
+        await this.removePersistedErrorState();
         if (this.applianceId) {
             try {
                 await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Offline);
@@ -428,10 +437,7 @@ export class SunspecInverter extends BaseSunspecDevice {
                     }
                 };
                 messages.push(inverterMessage);
-                const statusMessage = await this.detectAndEmitStatusTransition(inverterData, timestamp);
-                if (statusMessage) {
-                    messages.push(statusMessage);
-                }
+                await this.detectAndEmitStatusTransition(inverterData, timestamp);
             }
             this.consecutiveReconnectFailures = 0;
             if (this.applianceId) {
@@ -564,17 +570,29 @@ export class SunspecInverter extends BaseSunspecDevice {
             console.error(`Inverter ${this.applianceId}: failed to persist error state: ${error}`);
         }
     }
+    async removePersistedErrorState() {
+        const storage = this.storage ?? this.energyApp.useStorage();
+        try {
+            await storage.remove(this.storageKey());
+        }
+        catch (error) {
+            console.error(`Inverter ${this.applianceId}: failed to remove persisted error state: ${error}`);
+        }
+    }
     async detectAndEmitStatusTransition(data, timestamp) {
-        if (!this.applianceId)
-            return undefined;
+        if (!this.applianceId || !this.dataBus)
+            return;
         const { codes, codeIds } = this.decodeActiveErrors(data);
         const recoveringFromConnectionLoss = this.errorState.lastStatus === 'connection_lost';
         if (!recoveringFromConnectionLoss && !this.hasErrorSetChanged(codeIds)) {
-            return undefined;
+            return;
         }
         const newStatus = codeIds.length === 0
             ? EnyoApplianceStatusEnum.Healthy
             : EnyoApplianceStatusEnum.Faulted;
+        const message = this.buildStatusMessage(newStatus, codes, timestamp);
+        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             evt1: data.events,
             evt2: data.events2,
@@ -586,8 +604,6 @@ export class SunspecInverter extends BaseSunspecDevice {
             lastStatus: newStatus === EnyoApplianceStatusEnum.Healthy ? 'healthy' : 'faulted',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: status transition -> ${newStatus} (codes=[${codeIds.join(', ')}])`);
-        return this.buildStatusMessage(newStatus, codes, timestamp);
     }
     async onConnectionFailure(consecutiveFailures) {
         if (!this.applianceId || !this.dataBus)
@@ -604,13 +620,13 @@ export class SunspecInverter extends BaseSunspecDevice {
                 ]
             }];
         const message = this.buildStatusMessage(EnyoApplianceStatusEnum.Faulted, errorCodes, new Date());
+        console.log(`Inverter ${this.applianceId}: emitting faulted (${SUNSPEC_CONNECTION_LOST_CODE}) after ${consecutiveFailures} consecutive reconnect failures`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             activeCodes: [SUNSPEC_CONNECTION_LOST_CODE],
             lastStatus: 'connection_lost',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: emitting faulted (${SUNSPEC_CONNECTION_LOST_CODE}) after ${consecutiveFailures} consecutive reconnect failures`);
-        this.dataBus.sendMessage([message]);
     }
     async onConnectionRestored() {
         if (!this.applianceId || !this.dataBus)
@@ -618,13 +634,13 @@ export class SunspecInverter extends BaseSunspecDevice {
         if (this.errorState.lastStatus !== 'connection_lost')
             return;
         const message = this.buildStatusMessage(EnyoApplianceStatusEnum.Healthy, [], new Date());
+        console.log(`Inverter ${this.applianceId}: emitting healthy after reconnect`);
+        this.dataBus.sendMessage([message]);
         this.errorState = {
             activeCodes: [],
             lastStatus: 'healthy',
         };
         await this.persistErrorState();
-        console.log(`Inverter ${this.applianceId}: emitting healthy after reconnect`);
-        this.dataBus.sendMessage([message]);
     }
     /**
      * Compute the currently active feed-in / production limit in Watts from the

package/dist/version.d.ts

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