@enyo-energy/energy-app-sdk 0.0.148 → 0.0.150

package/dist/cjs/implementations/appliance-command-forecast/appliance-command-forecast-validators.cjs

@@ -129,6 +129,10 @@ function validateBatterySchedule(entries, resolution) {
         if (!allowedDirections.has(entry.direction)) {
             throw new ApplianceCommandForecastValidationError(`relativeSchedule[${i}].direction is invalid: ${entry.direction}.`);
         }
+        if (entry.direction === enyo_appliance_command_forecast_js_1.BatteryCommandForecastDirectionEnum.Idle
+            && entry.powerW !== 0) {
+            throw new ApplianceCommandForecastValidationError(`relativeSchedule[${i}].powerW must be 0 when direction is '${enyo_appliance_command_forecast_js_1.BatteryCommandForecastDirectionEnum.Idle}'; got ${entry.powerW}.`);
+        }
     }
     validateFirstEntryStartsAtZero(entries[0].seconds, 'relativeSchedule');
     validateSecondsMatchResolution(entries.map((e) => e.seconds), stepSeconds, 'relativeSchedule');

package/dist/cjs/implementations/storage/storage-schedule-handler.cjs

@@ -337,8 +337,12 @@ class StorageScheduleHandler {
                 return { ok: false, error: new Error(`relativeSchedule[${i}].powerW must be a non-negative finite number`) };
             }
             if (e.direction !== enyo_data_bus_value_js_1.EnyoStorageScheduleDirectionEnum.Charge
-                && e.direction !== enyo_data_bus_value_js_1.EnyoStorageScheduleDirectionEnum.Discharge) {
-                return { ok: false, error: new Error(`relativeSchedule[${i}].direction must be 'charge' or 'discharge'`) };
+                && e.direction !== enyo_data_bus_value_js_1.EnyoStorageScheduleDirectionEnum.Discharge
+                && e.direction !== enyo_data_bus_value_js_1.EnyoStorageScheduleDirectionEnum.Idle) {
+                return { ok: false, error: new Error(`relativeSchedule[${i}].direction must be 'charge', 'discharge' or 'idle'`) };
+            }
+            if (e.direction === enyo_data_bus_value_js_1.EnyoStorageScheduleDirectionEnum.Idle && e.powerW !== 0) {
+                return { ok: false, error: new Error(`relativeSchedule[${i}].powerW must be 0 when direction is 'idle' (got ${e.powerW})`) };
             }
             previousSeconds = e.seconds;
         }

package/dist/cjs/packages/eebus/eebus-mpc-client.d.cts

@@ -51,15 +51,6 @@ export interface MpcClientOptions {
      * sluggish but functional — extend rather than disable.
      */
     descriptionReadTimeoutMs?: number;
-    /**
-     * When the internal description read fails (timeout or
-     * not-supported), fall back to extracting `scopeType` from each
-     * inbound notify (`acPowerTotal` → {@link EebusMpcReading.activePowerW},
-     * `acEnergyConsumed` → {@link EebusMpcReading.totalEnergyConsumedWh})
-     * so the client keeps emitting readings instead of going silent.
-     * Defaults to `true`.
-     */
-    fallbackToInlineScope?: boolean;
 }
 /**
  * Client for the EEBUS **Monitoring of Power Consumption (MPC)** use case.

package/dist/cjs/packages/eebus/eebus-use-case-registry.d.cts

@@ -85,13 +85,8 @@ export interface EebusUseCaseRegistry {
      * known). Without a hint the client picks the first server match the
      * SDK resolves.
      *
-     * The default options enable `fallbackToInlineScope`, so a single
-     * slow `measurementDescriptionListData` read on a flaky peer no
-     * longer silences the client — it falls back to extracting scope
-     * from inbound notifies.
-     *
      * @param ski Subject Key Identifier of the remote node
-     * @param options Optional address/timeout/fallback configuration
+     * @param options Optional address/timeout configuration
      */
     mpc: (ski: string, options?: MpcClientOptions) => EebusMpcClient;
     /**

package/dist/cjs/types/enyo-appliance-command-forecast.cjs

@@ -89,4 +89,10 @@ var BatteryCommandForecastDirectionEnum;
     BatteryCommandForecastDirectionEnum["Charge"] = "charge";
     /** Power should flow from the battery into the home / grid (discharging). */
     BatteryCommandForecastDirectionEnum["Discharge"] = "discharge";
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    BatteryCommandForecastDirectionEnum["Idle"] = "idle";
 })(BatteryCommandForecastDirectionEnum || (exports.BatteryCommandForecastDirectionEnum = BatteryCommandForecastDirectionEnum = {}));

package/dist/cjs/types/enyo-appliance-command-forecast.d.cts

@@ -178,7 +178,13 @@ export declare enum BatteryCommandForecastDirectionEnum {
     /** Power should flow from PV / home / grid into the battery (charging). */
     Charge = "charge",
     /** Power should flow from the battery into the home / grid (discharging). */
-    Discharge = "discharge"
+    Discharge = "discharge",
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    Idle = "idle"
 }
 /**
  * One entry of a battery's relative direction / power schedule.
@@ -198,9 +204,12 @@ export interface BatteryCommandForecastScheduleEntry {
     direction: BatteryCommandForecastDirectionEnum;
     /**
      * Target power in Watts. Always non-negative — direction is carried
-     * by {@link direction}, never by sign. A `powerW` of `0` means "hold
-     * at zero in the named direction" (effectively idle until the next
-     * entry).
+     * by {@link direction}, never by sign. A `powerW` of `0` together
+     * with a `Charge` or `Discharge` direction means "hold at zero in
+     * the named direction" (effectively idle until the next entry);
+     * prefer the explicit
+     * {@link BatteryCommandForecastDirectionEnum.Idle} direction for
+     * unambiguous idle slots, in which case `powerW` must also be `0`.
      */
     powerW: number;
 }

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

@@ -194,6 +194,10 @@ var EnyoStorageScheduleModeEnum;
  * to keep schedule entries unambiguous on the wire: `powerW` is always
  * non-negative, and consumers never have to disambiguate `0` from
  * "direction-of-zero" or interpret sign conventions per integration.
+ *
+ * `Idle` is the explicit "no energy flow" marker — use it to insert
+ * idle slots between charge / discharge periods. An entry with
+ * `direction = Idle` must carry `powerW = 0`.
  */
 var EnyoStorageScheduleDirectionEnum;
 (function (EnyoStorageScheduleDirectionEnum) {
@@ -201,6 +205,12 @@ var EnyoStorageScheduleDirectionEnum;
     EnyoStorageScheduleDirectionEnum["Charge"] = "charge";
     /** Power should flow from the battery into the grid / home (discharging). */
     EnyoStorageScheduleDirectionEnum["Discharge"] = "discharge";
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    EnyoStorageScheduleDirectionEnum["Idle"] = "idle";
 })(EnyoStorageScheduleDirectionEnum || (exports.EnyoStorageScheduleDirectionEnum = EnyoStorageScheduleDirectionEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

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

@@ -1055,12 +1055,22 @@ export declare enum EnyoStorageScheduleModeEnum {
  * to keep schedule entries unambiguous on the wire: `powerW` is always
  * non-negative, and consumers never have to disambiguate `0` from
  * "direction-of-zero" or interpret sign conventions per integration.
+ *
+ * `Idle` is the explicit "no energy flow" marker — use it to insert
+ * idle slots between charge / discharge periods. An entry with
+ * `direction = Idle` must carry `powerW = 0`.
  */
 export declare enum EnyoStorageScheduleDirectionEnum {
     /** Power should flow from the grid into the battery (charging). */
     Charge = "charge",
     /** Power should flow from the battery into the grid / home (discharging). */
-    Discharge = "discharge"
+    Discharge = "discharge",
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    Idle = "idle"
 }
 /**
  * A single setpoint within a storage relative schedule. The setpoint
@@ -1079,15 +1089,19 @@ export interface EnyoStorageScheduleEntry {
     seconds: number;
     /**
      * Direction of energy flow for this setpoint
-     * ({@link EnyoStorageScheduleDirectionEnum.Charge} or
-     * {@link EnyoStorageScheduleDirectionEnum.Discharge}).
+     * ({@link EnyoStorageScheduleDirectionEnum.Charge},
+     * {@link EnyoStorageScheduleDirectionEnum.Discharge}, or
+     * {@link EnyoStorageScheduleDirectionEnum.Idle}).
      */
     direction: EnyoStorageScheduleDirectionEnum;
     /**
      * Target power for this setpoint in Watts. Always non-negative —
      * direction is carried by {@link direction}, never by sign. A
-     * `powerW` of `0` means "hold at zero in the named direction"
-     * (effectively idle until the next entry).
+     * `powerW` of `0` together with a `Charge` or `Discharge` direction
+     * means "hold at zero in the named direction" (effectively idle
+     * until the next entry); prefer the explicit
+     * {@link EnyoStorageScheduleDirectionEnum.Idle} direction for
+     * unambiguous idle slots, in which case `powerW` must also be `0`.
      */
     powerW: number;
 }

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

package/dist/implementations/appliance-command-forecast/appliance-command-forecast-validators.js

@@ -118,6 +118,10 @@ export function validateBatterySchedule(entries, resolution) {
         if (!allowedDirections.has(entry.direction)) {
             throw new ApplianceCommandForecastValidationError(`relativeSchedule[${i}].direction is invalid: ${entry.direction}.`);
         }
+        if (entry.direction === BatteryCommandForecastDirectionEnum.Idle
+            && entry.powerW !== 0) {
+            throw new ApplianceCommandForecastValidationError(`relativeSchedule[${i}].powerW must be 0 when direction is '${BatteryCommandForecastDirectionEnum.Idle}'; got ${entry.powerW}.`);
+        }
     }
     validateFirstEntryStartsAtZero(entries[0].seconds, 'relativeSchedule');
     validateSecondsMatchResolution(entries.map((e) => e.seconds), stepSeconds, 'relativeSchedule');

package/dist/implementations/storage/storage-schedule-handler.js

@@ -334,8 +334,12 @@ export class StorageScheduleHandler {
                 return { ok: false, error: new Error(`relativeSchedule[${i}].powerW must be a non-negative finite number`) };
             }
             if (e.direction !== EnyoStorageScheduleDirectionEnum.Charge
-                && e.direction !== EnyoStorageScheduleDirectionEnum.Discharge) {
-                return { ok: false, error: new Error(`relativeSchedule[${i}].direction must be 'charge' or 'discharge'`) };
+                && e.direction !== EnyoStorageScheduleDirectionEnum.Discharge
+                && e.direction !== EnyoStorageScheduleDirectionEnum.Idle) {
+                return { ok: false, error: new Error(`relativeSchedule[${i}].direction must be 'charge', 'discharge' or 'idle'`) };
+            }
+            if (e.direction === EnyoStorageScheduleDirectionEnum.Idle && e.powerW !== 0) {
+                return { ok: false, error: new Error(`relativeSchedule[${i}].powerW must be 0 when direction is 'idle' (got ${e.powerW})`) };
             }
             previousSeconds = e.seconds;
         }

package/dist/packages/eebus/eebus-mpc-client.d.ts

@@ -51,15 +51,6 @@ export interface MpcClientOptions {
      * sluggish but functional — extend rather than disable.
      */
     descriptionReadTimeoutMs?: number;
-    /**
-     * When the internal description read fails (timeout or
-     * not-supported), fall back to extracting `scopeType` from each
-     * inbound notify (`acPowerTotal` → {@link EebusMpcReading.activePowerW},
-     * `acEnergyConsumed` → {@link EebusMpcReading.totalEnergyConsumedWh})
-     * so the client keeps emitting readings instead of going silent.
-     * Defaults to `true`.
-     */
-    fallbackToInlineScope?: boolean;
 }
 /**
  * Client for the EEBUS **Monitoring of Power Consumption (MPC)** use case.

package/dist/packages/eebus/eebus-use-case-registry.d.ts

@@ -85,13 +85,8 @@ export interface EebusUseCaseRegistry {
      * known). Without a hint the client picks the first server match the
      * SDK resolves.
      *
-     * The default options enable `fallbackToInlineScope`, so a single
-     * slow `measurementDescriptionListData` read on a flaky peer no
-     * longer silences the client — it falls back to extracting scope
-     * from inbound notifies.
-     *
      * @param ski Subject Key Identifier of the remote node
-     * @param options Optional address/timeout/fallback configuration
+     * @param options Optional address/timeout configuration
      */
     mpc: (ski: string, options?: MpcClientOptions) => EebusMpcClient;
     /**

package/dist/types/enyo-appliance-command-forecast.d.ts

@@ -178,7 +178,13 @@ export declare enum BatteryCommandForecastDirectionEnum {
     /** Power should flow from PV / home / grid into the battery (charging). */
     Charge = "charge",
     /** Power should flow from the battery into the home / grid (discharging). */
-    Discharge = "discharge"
+    Discharge = "discharge",
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    Idle = "idle"
 }
 /**
  * One entry of a battery's relative direction / power schedule.
@@ -198,9 +204,12 @@ export interface BatteryCommandForecastScheduleEntry {
     direction: BatteryCommandForecastDirectionEnum;
     /**
      * Target power in Watts. Always non-negative — direction is carried
-     * by {@link direction}, never by sign. A `powerW` of `0` means "hold
-     * at zero in the named direction" (effectively idle until the next
-     * entry).
+     * by {@link direction}, never by sign. A `powerW` of `0` together
+     * with a `Charge` or `Discharge` direction means "hold at zero in
+     * the named direction" (effectively idle until the next entry);
+     * prefer the explicit
+     * {@link BatteryCommandForecastDirectionEnum.Idle} direction for
+     * unambiguous idle slots, in which case `powerW` must also be `0`.
      */
     powerW: number;
 }

package/dist/types/enyo-appliance-command-forecast.js

@@ -86,4 +86,10 @@ export var BatteryCommandForecastDirectionEnum;
     BatteryCommandForecastDirectionEnum["Charge"] = "charge";
     /** Power should flow from the battery into the home / grid (discharging). */
     BatteryCommandForecastDirectionEnum["Discharge"] = "discharge";
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    BatteryCommandForecastDirectionEnum["Idle"] = "idle";
 })(BatteryCommandForecastDirectionEnum || (BatteryCommandForecastDirectionEnum = {}));

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

@@ -1055,12 +1055,22 @@ export declare enum EnyoStorageScheduleModeEnum {
  * to keep schedule entries unambiguous on the wire: `powerW` is always
  * non-negative, and consumers never have to disambiguate `0` from
  * "direction-of-zero" or interpret sign conventions per integration.
+ *
+ * `Idle` is the explicit "no energy flow" marker — use it to insert
+ * idle slots between charge / discharge periods. An entry with
+ * `direction = Idle` must carry `powerW = 0`.
  */
 export declare enum EnyoStorageScheduleDirectionEnum {
     /** Power should flow from the grid into the battery (charging). */
     Charge = "charge",
     /** Power should flow from the battery into the grid / home (discharging). */
-    Discharge = "discharge"
+    Discharge = "discharge",
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    Idle = "idle"
 }
 /**
  * A single setpoint within a storage relative schedule. The setpoint
@@ -1079,15 +1089,19 @@ export interface EnyoStorageScheduleEntry {
     seconds: number;
     /**
      * Direction of energy flow for this setpoint
-     * ({@link EnyoStorageScheduleDirectionEnum.Charge} or
-     * {@link EnyoStorageScheduleDirectionEnum.Discharge}).
+     * ({@link EnyoStorageScheduleDirectionEnum.Charge},
+     * {@link EnyoStorageScheduleDirectionEnum.Discharge}, or
+     * {@link EnyoStorageScheduleDirectionEnum.Idle}).
      */
     direction: EnyoStorageScheduleDirectionEnum;
     /**
      * Target power for this setpoint in Watts. Always non-negative —
      * direction is carried by {@link direction}, never by sign. A
-     * `powerW` of `0` means "hold at zero in the named direction"
-     * (effectively idle until the next entry).
+     * `powerW` of `0` together with a `Charge` or `Discharge` direction
+     * means "hold at zero in the named direction" (effectively idle
+     * until the next entry); prefer the explicit
+     * {@link EnyoStorageScheduleDirectionEnum.Idle} direction for
+     * unambiguous idle slots, in which case `powerW` must also be `0`.
      */
     powerW: number;
 }

package/dist/types/enyo-data-bus-value.js

@@ -191,6 +191,10 @@ export var EnyoStorageScheduleModeEnum;
  * to keep schedule entries unambiguous on the wire: `powerW` is always
  * non-negative, and consumers never have to disambiguate `0` from
  * "direction-of-zero" or interpret sign conventions per integration.
+ *
+ * `Idle` is the explicit "no energy flow" marker — use it to insert
+ * idle slots between charge / discharge periods. An entry with
+ * `direction = Idle` must carry `powerW = 0`.
  */
 export var EnyoStorageScheduleDirectionEnum;
 (function (EnyoStorageScheduleDirectionEnum) {
@@ -198,6 +202,12 @@ export var EnyoStorageScheduleDirectionEnum;
     EnyoStorageScheduleDirectionEnum["Charge"] = "charge";
     /** Power should flow from the battery into the grid / home (discharging). */
     EnyoStorageScheduleDirectionEnum["Discharge"] = "discharge";
+    /**
+     * No energy flow — the battery holds its current state-of-charge.
+     * Use to mark idle periods between charge / discharge entries. The
+     * entry's `powerW` must be `0`.
+     */
+    EnyoStorageScheduleDirectionEnum["Idle"] = "idle";
 })(EnyoStorageScheduleDirectionEnum || (EnyoStorageScheduleDirectionEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

package/dist/version.d.ts

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