@enyo-energy/energy-app-sdk 1.52.0 → 1.53.0

package/dist/cjs/types/enyo-charge.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnyoChargeStatus = exports.EnyoChargeVehicleAssignmentEnum = void 0;
+exports.EnyoChargeStatus = exports.EnyoChargePriceLimitSourceEnum = exports.EnyoChargeVehicleAssignmentEnum = void 0;
 /**
  * Where the vehicle on a charging session came from.
  *
@@ -22,6 +22,27 @@ var EnyoChargeVehicleAssignmentEnum;
      */
     EnyoChargeVehicleAssignmentEnum["Unknown"] = "unknown";
 })(EnyoChargeVehicleAssignmentEnum || (exports.EnyoChargeVehicleAssignmentEnum = EnyoChargeVehicleAssignmentEnum = {}));
+/**
+ * Where the price ceiling that governed a charging session was configured.
+ *
+ * A session's ceiling is resolved from the most specific place that has one,
+ * and the history needs to say which one won — "why did my car wait?" has a
+ * different fix depending on whether the limit sits on the car, the wallbox or
+ * the energy manager.
+ */
+var EnyoChargePriceLimitSourceEnum;
+(function (EnyoChargePriceLimitSourceEnum) {
+    /** The ceiling configured on the vehicle (`EnyoVehicle.priceLimitMode` and its values). */
+    EnyoChargePriceLimitSourceEnum["Vehicle"] = "vehicle";
+    /** The ceiling configured on the wallbox (charger appliance) handling the session. */
+    EnyoChargePriceLimitSourceEnum["Wallbox"] = "wallbox";
+    /**
+     * The ceiling set by the energy manager — its house-wide setting
+     * (`EnergyManagerSettingEnum.PriceLimitMode` and its values) or one the
+     * energy manager chose itself.
+     */
+    EnyoChargePriceLimitSourceEnum["EnergyManager"] = "energy-manager";
+})(EnyoChargePriceLimitSourceEnum || (exports.EnyoChargePriceLimitSourceEnum = EnyoChargePriceLimitSourceEnum = {}));
 /**
  * Status of a charging session
  */

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

@@ -19,6 +19,26 @@ export declare enum EnyoChargeVehicleAssignmentEnum {
      */
     Unknown = "unknown"
 }
+/**
+ * Where the price ceiling that governed a charging session was configured.
+ *
+ * A session's ceiling is resolved from the most specific place that has one,
+ * and the history needs to say which one won — "why did my car wait?" has a
+ * different fix depending on whether the limit sits on the car, the wallbox or
+ * the energy manager.
+ */
+export declare enum EnyoChargePriceLimitSourceEnum {
+    /** The ceiling configured on the vehicle (`EnyoVehicle.priceLimitMode` and its values). */
+    Vehicle = "vehicle",
+    /** The ceiling configured on the wallbox (charger appliance) handling the session. */
+    Wallbox = "wallbox",
+    /**
+     * The ceiling set by the energy manager — its house-wide setting
+     * (`EnergyManagerSettingEnum.PriceLimitMode` and its values) or one the
+     * energy manager chose itself.
+     */
+    EnergyManager = "energy-manager"
+}
 /**
  * Status of a charging session
  */
@@ -176,11 +196,37 @@ export interface EnyoCharge {
      * session was allowed to import in, in percent. Only meaningful while
      * {@link priceLimitMode} is {@link EnyoPriceLimitModeEnum.CheapestShare}.
      *
-     * Note this records the *setting*, not the price threshold it resolved to:
-     * that threshold moved as prices published, so it is not a property of the
-     * session.
+     * Note this records the *setting*, not the price threshold it resolved to;
+     * that threshold is {@link effectivePriceLimitCtPerKwh}.
      */
     priceLimitSharePercent?: number;
+    /**
+     * Where the ceiling described by {@link priceLimitMode} came from — the
+     * vehicle, the wallbox or the energy manager. See
+     * {@link EnyoChargePriceLimitSourceEnum}.
+     *
+     * Omitted when there was no ceiling, and on sessions recorded before the
+     * source was tracked.
+     */
+    priceLimitSource?: EnyoChargePriceLimitSourceEnum;
+    /**
+     * The price ceiling actually applied, in **cents per kWh** (`25` is
+     * 25 ct/kWh) — the absolute threshold above which the session did not
+     * import, whichever way the ceiling was expressed.
+     *
+     * Under {@link EnyoPriceLimitModeEnum.CtPerKwh} it equals
+     * {@link priceLimitCtPerKwh}. Under
+     * {@link EnyoPriceLimitModeEnum.CheapestShare} it is the threshold the
+     * share resolved to against the known prices; that threshold moves as
+     * later prices publish, so on a running session this is the latest
+     * resolution and may change with each update.
+     *
+     * Cents, like the other ceiling fields — divide by 100 before comparing it
+     * with EUR/kWh price fields such as
+     * {@link EnyoDiagnosticsActionReason.electricityPricePerKwh}. Negative
+     * values are legal. Omitted when there was no ceiling.
+     */
+    effectivePriceLimitCtPerKwh?: number;
     /**
      * How this session found its vehicle — see
      * {@link EnyoChargeVehicleAssignmentEnum}. Absent on sessions recorded

package/dist/cjs/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '1.52.0';
+exports.SDK_VERSION = '1.53.0';
 /**
  * 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 = "1.52.0";
+export declare const SDK_VERSION = "1.53.0";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

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

@@ -19,6 +19,26 @@ export declare enum EnyoChargeVehicleAssignmentEnum {
      */
     Unknown = "unknown"
 }
+/**
+ * Where the price ceiling that governed a charging session was configured.
+ *
+ * A session's ceiling is resolved from the most specific place that has one,
+ * and the history needs to say which one won — "why did my car wait?" has a
+ * different fix depending on whether the limit sits on the car, the wallbox or
+ * the energy manager.
+ */
+export declare enum EnyoChargePriceLimitSourceEnum {
+    /** The ceiling configured on the vehicle (`EnyoVehicle.priceLimitMode` and its values). */
+    Vehicle = "vehicle",
+    /** The ceiling configured on the wallbox (charger appliance) handling the session. */
+    Wallbox = "wallbox",
+    /**
+     * The ceiling set by the energy manager — its house-wide setting
+     * (`EnergyManagerSettingEnum.PriceLimitMode` and its values) or one the
+     * energy manager chose itself.
+     */
+    EnergyManager = "energy-manager"
+}
 /**
  * Status of a charging session
  */
@@ -176,11 +196,37 @@ export interface EnyoCharge {
      * session was allowed to import in, in percent. Only meaningful while
      * {@link priceLimitMode} is {@link EnyoPriceLimitModeEnum.CheapestShare}.
      *
-     * Note this records the *setting*, not the price threshold it resolved to:
-     * that threshold moved as prices published, so it is not a property of the
-     * session.
+     * Note this records the *setting*, not the price threshold it resolved to;
+     * that threshold is {@link effectivePriceLimitCtPerKwh}.
      */
     priceLimitSharePercent?: number;
+    /**
+     * Where the ceiling described by {@link priceLimitMode} came from — the
+     * vehicle, the wallbox or the energy manager. See
+     * {@link EnyoChargePriceLimitSourceEnum}.
+     *
+     * Omitted when there was no ceiling, and on sessions recorded before the
+     * source was tracked.
+     */
+    priceLimitSource?: EnyoChargePriceLimitSourceEnum;
+    /**
+     * The price ceiling actually applied, in **cents per kWh** (`25` is
+     * 25 ct/kWh) — the absolute threshold above which the session did not
+     * import, whichever way the ceiling was expressed.
+     *
+     * Under {@link EnyoPriceLimitModeEnum.CtPerKwh} it equals
+     * {@link priceLimitCtPerKwh}. Under
+     * {@link EnyoPriceLimitModeEnum.CheapestShare} it is the threshold the
+     * share resolved to against the known prices; that threshold moves as
+     * later prices publish, so on a running session this is the latest
+     * resolution and may change with each update.
+     *
+     * Cents, like the other ceiling fields — divide by 100 before comparing it
+     * with EUR/kWh price fields such as
+     * {@link EnyoDiagnosticsActionReason.electricityPricePerKwh}. Negative
+     * values are legal. Omitted when there was no ceiling.
+     */
+    effectivePriceLimitCtPerKwh?: number;
     /**
      * How this session found its vehicle — see
      * {@link EnyoChargeVehicleAssignmentEnum}. Absent on sessions recorded

package/dist/types/enyo-charge.js

@@ -19,6 +19,27 @@ export var EnyoChargeVehicleAssignmentEnum;
      */
     EnyoChargeVehicleAssignmentEnum["Unknown"] = "unknown";
 })(EnyoChargeVehicleAssignmentEnum || (EnyoChargeVehicleAssignmentEnum = {}));
+/**
+ * Where the price ceiling that governed a charging session was configured.
+ *
+ * A session's ceiling is resolved from the most specific place that has one,
+ * and the history needs to say which one won — "why did my car wait?" has a
+ * different fix depending on whether the limit sits on the car, the wallbox or
+ * the energy manager.
+ */
+export var EnyoChargePriceLimitSourceEnum;
+(function (EnyoChargePriceLimitSourceEnum) {
+    /** The ceiling configured on the vehicle (`EnyoVehicle.priceLimitMode` and its values). */
+    EnyoChargePriceLimitSourceEnum["Vehicle"] = "vehicle";
+    /** The ceiling configured on the wallbox (charger appliance) handling the session. */
+    EnyoChargePriceLimitSourceEnum["Wallbox"] = "wallbox";
+    /**
+     * The ceiling set by the energy manager — its house-wide setting
+     * (`EnergyManagerSettingEnum.PriceLimitMode` and its values) or one the
+     * energy manager chose itself.
+     */
+    EnyoChargePriceLimitSourceEnum["EnergyManager"] = "energy-manager";
+})(EnyoChargePriceLimitSourceEnum || (EnyoChargePriceLimitSourceEnum = {}));
 /**
  * Status of a charging session
  */

package/dist/version.d.ts

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