@enyo-energy/energy-app-sdk 0.0.154 → 0.0.156

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

@@ -170,6 +170,7 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
     EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
     EnyoDataBusMessageEnum["VehicleSocUpdateV1"] = "VehicleSocUpdateV1";
+    EnyoDataBusMessageEnum["EnergyAppStartedV1"] = "EnergyAppStartedV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));
 /**
  * Storage control mode carried by {@link EnyoDataBusSetStorageScheduleV1}.

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

@@ -194,7 +194,8 @@ export declare enum EnyoDataBusMessageEnum {
     AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
     StartAirConditioningV1 = "StartAirConditioningV1",
     StopAirConditioningV1 = "StopAirConditioningV1",
-    VehicleSocUpdateV1 = "VehicleSocUpdateV1"
+    VehicleSocUpdateV1 = "VehicleSocUpdateV1",
+    EnergyAppStartedV1 = "EnergyAppStartedV1"
 }
 export type EnyoDataBusMessageResolution = '1s' | '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 /**
@@ -389,6 +390,44 @@ export interface EnyoDataBusApplianceStateUpdateV1 extends EnyoDataBusMessage {
         errorCodes?: EnyoApplianceErrorCode[];
     };
 }
+/**
+ * Message emitted when an energy app package finishes startup and is now
+ * actively driving its appliances. Carries the running package's identity
+ * plus the full set of appliance ids it has registered against, so
+ * consumers can correlate subsequent activity to this package instance
+ * and learn which appliances are now under its influence.
+ *
+ * Broadcast (no `target`) — anyone observing the data bus may listen.
+ * The base {@link EnyoDataBusMessage.applianceId} field is intentionally
+ * left unset; this message scopes to *all* affected appliances via
+ * `data.applianceIds` rather than a single one.
+ */
+export interface EnyoDataBusEnergyAppStartedV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.EnergyAppStartedV1;
+    data: {
+        /**
+         * Cloud-deployment id of the started package. Matches
+         * {@link EnyoDataBusMessageTarget.cloudPackageId} so consumers
+         * can address replies back at this package instance.
+         */
+        cloudPackageId: string;
+        /**
+         * Package slug from the started package's
+         * {@link EnergyAppPackageDefinition.packageName}. Stable across
+         * deployments of the same package, suitable for grouping
+         * activity by package implementation rather than by instance.
+         */
+        packageName: string;
+        /**
+         * Ids of every appliance this package has registered against —
+         * the appliances whose lifecycle is now influenced by the
+         * running app. Empty array is legal (the package started but
+         * has not yet resolved any appliances).
+         */
+        applianceIds: string[];
+    };
+}
 export interface EnyoDataBusChargingStartedV1 extends EnyoDataBusMessage {
     type: 'message';
     message: EnyoDataBusMessageEnum.ChargingStartedV1;

package/dist/cjs/types/enyo-eebus-use-cases.d.cts

@@ -727,12 +727,21 @@ export interface EebusCevcAck {
  * OPEV use case. OPEV is an *obligation*: the EVSE MUST respect the
  * limit (it is grid-safety driven, not optimisation driven).
  *
- * Phase count is determined by the EVSE — single-phase wallboxes report
- * length 1, three-phase wallboxes length 3.
+ * Single-phase EVSEs populate only `a`; three-phase EVSEs populate `a`,
+ * `b`, and `c`. Phases the EVSE does not carry are left absent rather
+ * than implied by array length.
  */
 export interface EebusOpevLimit {
-    /** Per-phase current limits in Amperes (length 1 or 3). */
-    perPhaseA: number[];
+    /**
+     * Per-phase current limits in Amperes, keyed by phase label. Each
+     * phase is independently optional — omit phases the EVSE does not
+     * carry.
+     */
+    currentLimitByPhase: {
+        a?: number;
+        b?: number;
+        c?: number;
+    };
     /** Whether the limit is currently active. */
     isActive: boolean;
     /**
@@ -760,8 +769,16 @@ export interface EebusOpevAck {
  * (obligation vs recommendation), as with LPC vs LPP.
  */
 export interface EebusOscevLimit {
-    /** Per-phase recommended current limits in Amperes (length 1 or 3). */
-    perPhaseA: number[];
+    /**
+     * Per-phase recommended current limits in Amperes, keyed by phase
+     * label. Each phase is independently optional — omit phases the EVSE
+     * does not carry.
+     */
+    currentLimitByPhase: {
+        a?: number;
+        b?: number;
+        c?: number;
+    };
     /** Whether the recommendation is currently active. */
     isActive: boolean;
     /** Duration in seconds; omit or `0` for indefinite. */

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

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

@@ -194,7 +194,8 @@ export declare enum EnyoDataBusMessageEnum {
     AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
     StartAirConditioningV1 = "StartAirConditioningV1",
     StopAirConditioningV1 = "StopAirConditioningV1",
-    VehicleSocUpdateV1 = "VehicleSocUpdateV1"
+    VehicleSocUpdateV1 = "VehicleSocUpdateV1",
+    EnergyAppStartedV1 = "EnergyAppStartedV1"
 }
 export type EnyoDataBusMessageResolution = '1s' | '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 /**
@@ -389,6 +390,44 @@ export interface EnyoDataBusApplianceStateUpdateV1 extends EnyoDataBusMessage {
         errorCodes?: EnyoApplianceErrorCode[];
     };
 }
+/**
+ * Message emitted when an energy app package finishes startup and is now
+ * actively driving its appliances. Carries the running package's identity
+ * plus the full set of appliance ids it has registered against, so
+ * consumers can correlate subsequent activity to this package instance
+ * and learn which appliances are now under its influence.
+ *
+ * Broadcast (no `target`) — anyone observing the data bus may listen.
+ * The base {@link EnyoDataBusMessage.applianceId} field is intentionally
+ * left unset; this message scopes to *all* affected appliances via
+ * `data.applianceIds` rather than a single one.
+ */
+export interface EnyoDataBusEnergyAppStartedV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.EnergyAppStartedV1;
+    data: {
+        /**
+         * Cloud-deployment id of the started package. Matches
+         * {@link EnyoDataBusMessageTarget.cloudPackageId} so consumers
+         * can address replies back at this package instance.
+         */
+        cloudPackageId: string;
+        /**
+         * Package slug from the started package's
+         * {@link EnergyAppPackageDefinition.packageName}. Stable across
+         * deployments of the same package, suitable for grouping
+         * activity by package implementation rather than by instance.
+         */
+        packageName: string;
+        /**
+         * Ids of every appliance this package has registered against —
+         * the appliances whose lifecycle is now influenced by the
+         * running app. Empty array is legal (the package started but
+         * has not yet resolved any appliances).
+         */
+        applianceIds: string[];
+    };
+}
 export interface EnyoDataBusChargingStartedV1 extends EnyoDataBusMessage {
     type: 'message';
     message: EnyoDataBusMessageEnum.ChargingStartedV1;

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

@@ -167,6 +167,7 @@ export var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
     EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
     EnyoDataBusMessageEnum["VehicleSocUpdateV1"] = "VehicleSocUpdateV1";
+    EnyoDataBusMessageEnum["EnergyAppStartedV1"] = "EnergyAppStartedV1";
 })(EnyoDataBusMessageEnum || (EnyoDataBusMessageEnum = {}));
 /**
  * Storage control mode carried by {@link EnyoDataBusSetStorageScheduleV1}.

package/dist/types/enyo-eebus-use-cases.d.ts

@@ -727,12 +727,21 @@ export interface EebusCevcAck {
  * OPEV use case. OPEV is an *obligation*: the EVSE MUST respect the
  * limit (it is grid-safety driven, not optimisation driven).
  *
- * Phase count is determined by the EVSE — single-phase wallboxes report
- * length 1, three-phase wallboxes length 3.
+ * Single-phase EVSEs populate only `a`; three-phase EVSEs populate `a`,
+ * `b`, and `c`. Phases the EVSE does not carry are left absent rather
+ * than implied by array length.
  */
 export interface EebusOpevLimit {
-    /** Per-phase current limits in Amperes (length 1 or 3). */
-    perPhaseA: number[];
+    /**
+     * Per-phase current limits in Amperes, keyed by phase label. Each
+     * phase is independently optional — omit phases the EVSE does not
+     * carry.
+     */
+    currentLimitByPhase: {
+        a?: number;
+        b?: number;
+        c?: number;
+    };
     /** Whether the limit is currently active. */
     isActive: boolean;
     /**
@@ -760,8 +769,16 @@ export interface EebusOpevAck {
  * (obligation vs recommendation), as with LPC vs LPP.
  */
 export interface EebusOscevLimit {
-    /** Per-phase recommended current limits in Amperes (length 1 or 3). */
-    perPhaseA: number[];
+    /**
+     * Per-phase recommended current limits in Amperes, keyed by phase
+     * label. Each phase is independently optional — omit phases the EVSE
+     * does not carry.
+     */
+    currentLimitByPhase: {
+        a?: number;
+        b?: number;
+        c?: number;
+    };
     /** Whether the recommendation is currently active. */
     isActive: boolean;
     /** Duration in seconds; omit or `0` for indefinite. */

package/dist/version.d.ts

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