@enyo-energy/sunspec-sdk 0.0.77 → 0.0.79

package/dist/cjs/sunspec-devices.cjs

@@ -181,6 +181,7 @@ class BaseSunspecDevice {
                 if (this.applianceId) {
                     await this.applianceManager.updateApplianceState(this.applianceId, enyo_appliance_js_1.EnyoApplianceConnectionType.Connector, enyo_appliance_js_1.EnyoApplianceStateEnum.Connected);
                 }
+                await this.onConnectionRestored();
                 const postStats = this.sunspecClient.getConnectionStats();
                 console.log(`${this.constructor.name} ${this.applianceId}: Reconnection successful after ${attempt} attempt(s) (opens=${postStats.opens}, closes=${postStats.closes}, openUnits=${postStats.openUnits})`);
                 return true;
@@ -202,6 +203,14 @@ class BaseSunspecDevice {
     async onConnectionFailure(_consecutiveFailures) {
         // Default: no-op. SunspecInverter overrides to publish a faulted status.
     }
+    /**
+     * Hook for subclasses to react to a successful reconnect. Called once
+     * after the appliance state has been updated to Connected.
+     */
+    async onConnectionRestored() {
+        // Default: no-op. SunspecInverter overrides to publish a healthy status
+        // when recovering from a previously emitted connection-lost fault.
+    }
     /**
      * Detect a silent read failure: the SDK's per-model readers swallow modbus errors and
      * return null/[] rather than throwing, so a readData() cycle can complete "successfully"
@@ -368,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);
@@ -562,6 +580,15 @@ 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;
@@ -610,6 +637,20 @@ class SunspecInverter extends BaseSunspecDevice {
         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)
+            return;
+        if (this.errorState.lastStatus !== 'connection_lost')
+            return;
+        const message = this.buildStatusMessage(enyo_appliance_js_1.EnyoApplianceStatusEnum.Healthy, [], new Date());
+        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
      * Model 121 settings (WMax) and Model 123 controls (WMaxLim_Ena, WMaxLimPct).

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

@@ -69,6 +69,11 @@ export declare abstract class BaseSunspecDevice {
      * per failed attempt with the running consecutive-failure count.
      */
     protected onConnectionFailure(_consecutiveFailures: number): Promise<void>;
+    /**
+     * Hook for subclasses to react to a successful reconnect. Called once
+     * after the appliance state has been updated to Connected.
+     */
+    protected onConnectionRestored(): Promise<void>;
     /**
      * Detect a silent read failure: the SDK's per-model readers swallow modbus errors and
      * return null/[] rather than throwing, so a readData() cycle can complete "successfully"
@@ -143,8 +148,10 @@ 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>;
     /**
      * Compute the currently active feed-in / production limit in Watts from the
      * Model 121 settings (WMax) and Model 123 controls (WMaxLim_Ena, WMaxLimPct).

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

package/dist/sunspec-devices.d.ts

@@ -69,6 +69,11 @@ export declare abstract class BaseSunspecDevice {
      * per failed attempt with the running consecutive-failure count.
      */
     protected onConnectionFailure(_consecutiveFailures: number): Promise<void>;
+    /**
+     * Hook for subclasses to react to a successful reconnect. Called once
+     * after the appliance state has been updated to Connected.
+     */
+    protected onConnectionRestored(): Promise<void>;
     /**
      * Detect a silent read failure: the SDK's per-model readers swallow modbus errors and
      * return null/[] rather than throwing, so a readData() cycle can complete "successfully"
@@ -143,8 +148,10 @@ 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>;
     /**
      * Compute the currently active feed-in / production limit in Watts from the
      * Model 121 settings (WMax) and Model 123 controls (WMaxLim_Ena, WMaxLimPct).

package/dist/sunspec-devices.js

@@ -175,6 +175,7 @@ export class BaseSunspecDevice {
                 if (this.applianceId) {
                     await this.applianceManager.updateApplianceState(this.applianceId, EnyoApplianceConnectionType.Connector, EnyoApplianceStateEnum.Connected);
                 }
+                await this.onConnectionRestored();
                 const postStats = this.sunspecClient.getConnectionStats();
                 console.log(`${this.constructor.name} ${this.applianceId}: Reconnection successful after ${attempt} attempt(s) (opens=${postStats.opens}, closes=${postStats.closes}, openUnits=${postStats.openUnits})`);
                 return true;
@@ -196,6 +197,14 @@ export class BaseSunspecDevice {
     async onConnectionFailure(_consecutiveFailures) {
         // Default: no-op. SunspecInverter overrides to publish a faulted status.
     }
+    /**
+     * Hook for subclasses to react to a successful reconnect. Called once
+     * after the appliance state has been updated to Connected.
+     */
+    async onConnectionRestored() {
+        // Default: no-op. SunspecInverter overrides to publish a healthy status
+        // when recovering from a previously emitted connection-lost fault.
+    }
     /**
      * Detect a silent read failure: the SDK's per-model readers swallow modbus errors and
      * return null/[] rather than throwing, so a readData() cycle can complete "successfully"
@@ -361,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);
@@ -555,6 +573,15 @@ 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;
@@ -603,6 +630,20 @@ export class SunspecInverter extends BaseSunspecDevice {
         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)
+            return;
+        if (this.errorState.lastStatus !== 'connection_lost')
+            return;
+        const message = this.buildStatusMessage(EnyoApplianceStatusEnum.Healthy, [], new Date());
+        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
      * Model 121 settings (WMax) and Model 123 controls (WMaxLim_Ena, WMaxLimPct).

package/dist/version.d.ts

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