@enyo-energy/sunspec-sdk 0.0.85 → 0.0.86

package/dist/cjs/sunspec-modbus-client.cjs

@@ -365,6 +365,20 @@ class SunspecModbusClient {
             throw new Error(`Modbus instance for unit ${unitId} not initialized — call connect(host, port, ${unitId}) first`);
         return inst;
     }
+    /**
+     * Expose this client's open Modbus connection for a unit so a co-located driver can
+     * share the SAME TCP socket instead of opening a second one. This matters for devices
+     * behind single-connection bridges (e.g. the Solax ESP32 Pocket WiFi dongle, which
+     * resets the link when a second Modbus-TCP client connects): the driver reads its own
+     * function codes (e.g. FC04 input registers) over this socket.
+     *
+     * Throws if the unit isn't open. The connection's lifecycle stays owned by this client —
+     * borrowers MUST NOT call disconnect() on the returned instance; release it via
+     * disconnectUnit(unitId) / releaseSunspecClient() as usual.
+     */
+    getModbusInstance(unitId) {
+        return this.getInstance(unitId);
+    }
     /**
      * Get the fault-tolerant reader for a unit, throwing if it isn't open.
      */

package/dist/cjs/sunspec-modbus-client.d.cts

@@ -18,6 +18,7 @@
  */
 import { type SunspecInverterControls, type SunspecInverterData, type SunspecInverterSettings, type SunspecMeterData, type SunspecModel, type SunspecMPPTData, type SunspecBatteryData, type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode } from "./sunspec-interfaces.cjs";
 import { EnergyAppModbusDataType, IConnectionHealth } from "@enyo-energy/energy-app-sdk/dist/implementations/modbus/interfaces.js";
+import { EnergyAppModbusInstance } from "@enyo-energy/energy-app-sdk/dist/packages/energy-app-modbus.js";
 import { EnergyApp } from "@enyo-energy/energy-app-sdk";
 /**
  * Get (or create) the singleton SunspecModbusClient for this network device.
@@ -121,6 +122,18 @@ export declare class SunspecModbusClient {
      * Get the EnergyAppModbusInstance for a unit, throwing if it isn't open.
      */
     private getInstance;
+    /**
+     * Expose this client's open Modbus connection for a unit so a co-located driver can
+     * share the SAME TCP socket instead of opening a second one. This matters for devices
+     * behind single-connection bridges (e.g. the Solax ESP32 Pocket WiFi dongle, which
+     * resets the link when a second Modbus-TCP client connects): the driver reads its own
+     * function codes (e.g. FC04 input registers) over this socket.
+     *
+     * Throws if the unit isn't open. The connection's lifecycle stays owned by this client —
+     * borrowers MUST NOT call disconnect() on the returned instance; release it via
+     * disconnectUnit(unitId) / releaseSunspecClient() as usual.
+     */
+    getModbusInstance(unitId: number): EnergyAppModbusInstance;
     /**
      * Get the fault-tolerant reader for a unit, throwing if it isn't open.
      */

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

package/dist/sunspec-modbus-client.d.ts

@@ -18,6 +18,7 @@
  */
 import { type SunspecInverterControls, type SunspecInverterData, type SunspecInverterSettings, type SunspecMeterData, type SunspecModel, type SunspecMPPTData, type SunspecBatteryData, type SunspecBatteryBaseData, type SunspecBatteryControls, SunspecStorageMode } from "./sunspec-interfaces.js";
 import { EnergyAppModbusDataType, IConnectionHealth } from "@enyo-energy/energy-app-sdk/dist/implementations/modbus/interfaces.js";
+import { EnergyAppModbusInstance } from "@enyo-energy/energy-app-sdk/dist/packages/energy-app-modbus.js";
 import { EnergyApp } from "@enyo-energy/energy-app-sdk";
 /**
  * Get (or create) the singleton SunspecModbusClient for this network device.
@@ -121,6 +122,18 @@ export declare class SunspecModbusClient {
      * Get the EnergyAppModbusInstance for a unit, throwing if it isn't open.
      */
     private getInstance;
+    /**
+     * Expose this client's open Modbus connection for a unit so a co-located driver can
+     * share the SAME TCP socket instead of opening a second one. This matters for devices
+     * behind single-connection bridges (e.g. the Solax ESP32 Pocket WiFi dongle, which
+     * resets the link when a second Modbus-TCP client connects): the driver reads its own
+     * function codes (e.g. FC04 input registers) over this socket.
+     *
+     * Throws if the unit isn't open. The connection's lifecycle stays owned by this client —
+     * borrowers MUST NOT call disconnect() on the returned instance; release it via
+     * disconnectUnit(unitId) / releaseSunspecClient() as usual.
+     */
+    getModbusInstance(unitId: number): EnergyAppModbusInstance;
     /**
      * Get the fault-tolerant reader for a unit, throwing if it isn't open.
      */

package/dist/sunspec-modbus-client.js

@@ -360,6 +360,20 @@ export class SunspecModbusClient {
             throw new Error(`Modbus instance for unit ${unitId} not initialized — call connect(host, port, ${unitId}) first`);
         return inst;
     }
+    /**
+     * Expose this client's open Modbus connection for a unit so a co-located driver can
+     * share the SAME TCP socket instead of opening a second one. This matters for devices
+     * behind single-connection bridges (e.g. the Solax ESP32 Pocket WiFi dongle, which
+     * resets the link when a second Modbus-TCP client connects): the driver reads its own
+     * function codes (e.g. FC04 input registers) over this socket.
+     *
+     * Throws if the unit isn't open. The connection's lifecycle stays owned by this client —
+     * borrowers MUST NOT call disconnect() on the returned instance; release it via
+     * disconnectUnit(unitId) / releaseSunspecClient() as usual.
+     */
+    getModbusInstance(unitId) {
+        return this.getInstance(unitId);
+    }
     /**
      * Get the fault-tolerant reader for a unit, throwing if it isn't open.
      */

package/dist/version.d.ts

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