@enyo-energy/energy-app-sdk 0.0.171 → 0.0.173

package/dist/cjs/packages/energy-app-modbus-rtu.d.cts

@@ -12,6 +12,21 @@ export interface ModbusRtuOptions {
     parity?: 'none' | 'even' | 'odd';
     /** Connection timeout in milliseconds */
     timeout?: number;
+    /**
+     * When `true`, requests are not run in parallel on this connection: consecutive requests
+     * ({@link EnergyAppModbusRtuInstance.readRegisters} / {@link EnergyAppModbusRtuInstance.writeRegisters})
+     * are serialized through an internal operation chain and run sequentially in call order, so a
+     * chain of messages cannot be interleaved with requests from concurrent callers. This is
+     * especially relevant on RTU, where the serial line is half-duplex and shared across every
+     * slave ID on the bus. Defaults to `false` (requests may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive requests. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. A short inter-message gap is often
+     * required by slower RTU slaves to avoid dropped frames. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * Request parameters for reading Modbus RTU registers.

package/dist/cjs/packages/energy-app-modbus.d.cts

@@ -33,6 +33,20 @@ export interface ModbusOptions {
      * used when {@link useTls} is true.
      */
     rejectUnauthorized?: boolean;
+    /**
+     * When `true`, requests are not run in parallel on this connection: consecutive Modbus
+     * requests (reads and writes) are serialized through an internal operation chain and run
+     * sequentially in call order, so a chain of messages cannot be interleaved with requests from
+     * concurrent callers. Use this when a sequence of register operations must be applied
+     * atomically relative to each other. Defaults to `false` (requests may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive requests. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. Useful for devices that need a short
+     * recovery gap between messages. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * Interface for Modbus TCP/IP communication in enyo packages.

package/dist/cjs/packages/energy-app-udp.d.cts

@@ -40,6 +40,20 @@ export interface UdpBindOptions {
      * callers should leave this `undefined`.
      */
     multicastInterface?: string;
+    /**
+     * When `true`, sends are not run in parallel on this socket: consecutive
+     * {@link EnergyAppUdpSocket.send} calls are serialized through an internal operation chain and
+     * run sequentially in call order, so a chain of datagrams cannot be interleaved with sends
+     * from concurrent callers. Use this when a request/response exchange requires a strict send
+     * ordering. Defaults to `false` (sends may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive sends. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. Useful for peers that need a short
+     * gap between datagrams. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * A single inbound datagram delivered to a handler registered with

package/dist/cjs/types/enyo-data-bus-value.d.cts

@@ -266,7 +266,9 @@ export type EnyoDataBusMessageResolution = '1s' | '10s' | '30s' | '1m' | '15m' |
 /**
  * Optional addressing information for a {@link EnyoDataBusMessage}. When omitted
  * the message is broadcast to all subscribers; when set, the message is only
- * delivered to packages that match the specified target.
+ * delivered to packages that match the specified target. Broadcasting of an
+ * untargeted message can additionally be suppressed by setting
+ * {@link EnyoDataBusMessage.broadcast} to `false`.
  *
  * Exactly one of {@link cloudPackageId} or {@link categories} should be provided.
  * When both are set, consumers should treat them as an AND (the receiving package
@@ -303,6 +305,15 @@ export interface EnyoDataBusMessage {
      * {@link EnyoDataBusMessageTarget} for matching semantics.
      */
     target?: EnyoDataBusMessageTarget;
+    /**
+     * Whether this message may be broadcast to all subscribers on the bus.
+     * Defaults to `true` when omitted (the message is eligible for broadcast).
+     * Set to `false` to prevent the message from fanning out to all subscribers —
+     * for example when it should only reach the recipients named by {@link target}.
+     * This flag is independent of {@link target}: `target` narrows delivery, while
+     * `broadcast` controls whether an untargeted message reaches every subscriber.
+     */
+    broadcast?: boolean;
     data: object;
 }
 export interface EnyoDataBusMessageAnswer extends EnyoDataBusMessage {

package/dist/cjs/types/enyo-onboarding.d.cts

@@ -259,6 +259,16 @@ export interface EnyoOnboardingStepResponse {
     state: 'success' | 'error';
     /** Optional translated error message if state is 'error' */
     errorMessage?: EnyoOnboardingTranslatedContent[];
+    /**
+     * When true on a successful step response, instructs the host to route the user to the
+     * pending authentication request after this step completes. Typically set on the final step
+     * of a guide so the user is sent to authenticate (e.g. sign in to a cloud service) once
+     * onboarding finishes. The authentication request itself must have been created separately
+     * via `EnergyAppAuthentication.requestAuthentication`, and its result is handled through
+     * `listenForAuthenticationResponse`. This is fire-and-forget — the guide completes regardless
+     * of the authentication outcome. Ignored when `state` is 'error'.
+     */
+    goToAuthentication?: boolean;
 }
 /**
  * Callback function type for handling step submissions.

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

package/dist/packages/energy-app-modbus-rtu.d.ts

@@ -12,6 +12,21 @@ export interface ModbusRtuOptions {
     parity?: 'none' | 'even' | 'odd';
     /** Connection timeout in milliseconds */
     timeout?: number;
+    /**
+     * When `true`, requests are not run in parallel on this connection: consecutive requests
+     * ({@link EnergyAppModbusRtuInstance.readRegisters} / {@link EnergyAppModbusRtuInstance.writeRegisters})
+     * are serialized through an internal operation chain and run sequentially in call order, so a
+     * chain of messages cannot be interleaved with requests from concurrent callers. This is
+     * especially relevant on RTU, where the serial line is half-duplex and shared across every
+     * slave ID on the bus. Defaults to `false` (requests may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive requests. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. A short inter-message gap is often
+     * required by slower RTU slaves to avoid dropped frames. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * Request parameters for reading Modbus RTU registers.

package/dist/packages/energy-app-modbus.d.ts

@@ -33,6 +33,20 @@ export interface ModbusOptions {
      * used when {@link useTls} is true.
      */
     rejectUnauthorized?: boolean;
+    /**
+     * When `true`, requests are not run in parallel on this connection: consecutive Modbus
+     * requests (reads and writes) are serialized through an internal operation chain and run
+     * sequentially in call order, so a chain of messages cannot be interleaved with requests from
+     * concurrent callers. Use this when a sequence of register operations must be applied
+     * atomically relative to each other. Defaults to `false` (requests may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive requests. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. Useful for devices that need a short
+     * recovery gap between messages. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * Interface for Modbus TCP/IP communication in enyo packages.

package/dist/packages/energy-app-udp.d.ts

@@ -40,6 +40,20 @@ export interface UdpBindOptions {
      * callers should leave this `undefined`.
      */
     multicastInterface?: string;
+    /**
+     * When `true`, sends are not run in parallel on this socket: consecutive
+     * {@link EnergyAppUdpSocket.send} calls are serialized through an internal operation chain and
+     * run sequentially in call order, so a chain of datagrams cannot be interleaved with sends
+     * from concurrent callers. Use this when a request/response exchange requires a strict send
+     * ordering. Defaults to `false` (sends may execute concurrently).
+     */
+    noParallelRequests?: boolean;
+    /**
+     * Optional delay, in milliseconds, to wait between two consecutive sends. Only applies when
+     * {@link noParallelRequests} is `true`; ignored otherwise. Useful for peers that need a short
+     * gap between datagrams. Defaults to `0` (no delay).
+     */
+    waitBetweenMessagesMs?: number;
 }
 /**
  * A single inbound datagram delivered to a handler registered with

package/dist/types/enyo-data-bus-value.d.ts

@@ -266,7 +266,9 @@ export type EnyoDataBusMessageResolution = '1s' | '10s' | '30s' | '1m' | '15m' |
 /**
  * Optional addressing information for a {@link EnyoDataBusMessage}. When omitted
  * the message is broadcast to all subscribers; when set, the message is only
- * delivered to packages that match the specified target.
+ * delivered to packages that match the specified target. Broadcasting of an
+ * untargeted message can additionally be suppressed by setting
+ * {@link EnyoDataBusMessage.broadcast} to `false`.
  *
  * Exactly one of {@link cloudPackageId} or {@link categories} should be provided.
  * When both are set, consumers should treat them as an AND (the receiving package
@@ -303,6 +305,15 @@ export interface EnyoDataBusMessage {
      * {@link EnyoDataBusMessageTarget} for matching semantics.
      */
     target?: EnyoDataBusMessageTarget;
+    /**
+     * Whether this message may be broadcast to all subscribers on the bus.
+     * Defaults to `true` when omitted (the message is eligible for broadcast).
+     * Set to `false` to prevent the message from fanning out to all subscribers —
+     * for example when it should only reach the recipients named by {@link target}.
+     * This flag is independent of {@link target}: `target` narrows delivery, while
+     * `broadcast` controls whether an untargeted message reaches every subscriber.
+     */
+    broadcast?: boolean;
     data: object;
 }
 export interface EnyoDataBusMessageAnswer extends EnyoDataBusMessage {

package/dist/types/enyo-onboarding.d.ts

@@ -259,6 +259,16 @@ export interface EnyoOnboardingStepResponse {
     state: 'success' | 'error';
     /** Optional translated error message if state is 'error' */
     errorMessage?: EnyoOnboardingTranslatedContent[];
+    /**
+     * When true on a successful step response, instructs the host to route the user to the
+     * pending authentication request after this step completes. Typically set on the final step
+     * of a guide so the user is sent to authenticate (e.g. sign in to a cloud service) once
+     * onboarding finishes. The authentication request itself must have been created separately
+     * via `EnergyAppAuthentication.requestAuthentication`, and its result is handled through
+     * `listenForAuthenticationResponse`. This is fire-and-forget — the guide completes regardless
+     * of the authentication outcome. Ignored when `state` is 'error'.
+     */
+    goToAuthentication?: boolean;
 }
 /**
  * Callback function type for handling step submissions.

package/dist/version.d.ts

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