@enyo-energy/energy-app-sdk 0.0.155 → 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/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.155';
+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.155";
+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/version.d.ts

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