@enyo-energy/energy-app-sdk 0.0.42 → 0.0.44

package/dist/cjs/energy-app-permission.type.cjs

@@ -19,4 +19,6 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["Vehicle"] = "Vehicle";
     EnergyAppPermissionTypeEnum["Charge"] = "Charge";
     EnergyAppPermissionTypeEnum["SecretManager"] = "SecretManager";
+    EnergyAppPermissionTypeEnum["LocationZipCode"] = "LocationZipCode";
+    EnergyAppPermissionTypeEnum["LocationCoordinates"] = "LocationCoordinates";
 })(EnergyAppPermissionTypeEnum || (exports.EnergyAppPermissionTypeEnum = EnergyAppPermissionTypeEnum = {}));

package/dist/cjs/energy-app-permission.type.d.cts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -15,5 +15,7 @@ export declare enum EnergyAppPermissionTypeEnum {
     ChargingCard = "ChargingCard",
     Vehicle = "Vehicle",
     Charge = "Charge",
-    SecretManager = "SecretManager"
+    SecretManager = "SecretManager",
+    LocationZipCode = "LocationZipCode",
+    LocationCoordinates = "LocationCoordinates"
 }

package/dist/cjs/enyo-energy-app-sdk.d.cts

@@ -13,6 +13,7 @@ import { EnergyAppSettings } from "./packages/energy-app-settings.cjs";
 import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.cjs";
 import { EnergyAppNotification } from "./packages/energy-app-notification.cjs";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.cjs";
+import { EnergyAppLocation } from "./packages/energy-app-location.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -67,4 +68,6 @@ export interface EnyoEnergyAppSdk {
     useNotification: () => EnergyAppNotification;
     /** Get the Secret Manager API */
     useSecretManager: () => EnergyAppSecretManager;
+    /** Get the Location API */
+    useLocation: () => EnergyAppLocation;
 }

package/dist/cjs/index.cjs

@@ -27,6 +27,7 @@ __exportStar(require("./types/enyo-energy-tariff.cjs"), exports);
 __exportStar(require("./types/enyo-electricity-prices.cjs"), exports);
 __exportStar(require("./types/enyo-notification.cjs"), exports);
 __exportStar(require("./types/enyo-secret-manager.cjs"), exports);
+__exportStar(require("./types/enyo-location.cjs"), exports);
 __exportStar(require("./implementations/appliances/appliance-manager.cjs"), exports);
 __exportStar(require("./implementations/appliances/identifier-strategies.cjs"), exports);
 class EnergyApp {
@@ -114,6 +115,14 @@ class EnergyApp {
     useSecretManager() {
         return this.energyAppSdk.useSecretManager();
     }
+    /**
+     * Gets the Location API for retrieving device location information.
+     * Provides methods to fetch location with varying levels of detail based on permissions.
+     * @returns The Location API instance
+     */
+    useLocation() {
+        return this.energyAppSdk.useLocation();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/index.d.cts

@@ -14,6 +14,7 @@ import { EnergyAppSettings } from "./packages/energy-app-settings.cjs";
 import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.cjs";
 import { EnergyAppNotification } from "./packages/energy-app-notification.cjs";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.cjs";
+import { EnergyAppLocation } from "./packages/energy-app-location.cjs";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -25,6 +26,7 @@ export * from './types/enyo-energy-tariff.cjs';
 export * from './types/enyo-electricity-prices.cjs';
 export * from './types/enyo-notification.cjs';
 export * from './types/enyo-secret-manager.cjs';
+export * from './types/enyo-location.cjs';
 export * from './implementations/appliances/appliance-manager.cjs';
 export * from './implementations/appliances/identifier-strategies.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
@@ -55,6 +57,12 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Secret Manager API instance
      */
     useSecretManager(): EnergyAppSecretManager;
+    /**
+     * Gets the Location API for retrieving device location information.
+     * Provides methods to fetch location with varying levels of detail based on permissions.
+     * @returns The Location API instance
+     */
+    useLocation(): EnergyAppLocation;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/packages/energy-app-location.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,43 @@
+import { EnyoLocation, EnyoZipCodeLocation } from "../types/enyo-location.cjs";
+/**
+ * Interface for managing location information in energy apps.
+ * Provides methods to retrieve the device's location with varying levels of detail
+ * based on granted permissions.
+ */
+export interface EnergyAppLocation {
+    /**
+     * Gets the location with only the zip code.
+     * Requires the 'LocationZipCode' permission to be granted.
+     *
+     * @returns Promise that resolves to the location with zip code only, or null if not set
+     * @throws {PermissionNotGranted} If the LocationZipCode permission is not granted
+     *
+     * @example
+     * ```typescript
+     * const location = energyApp.useLocation();
+     * const zipLocation = await location.getLocationByZipCode();
+     * if (zipLocation) {
+     *     console.log(`Zip Code: ${zipLocation.zipCode}`);
+     * }
+     * ```
+     */
+    getLocationByZipCode(): Promise<EnyoZipCodeLocation | null>;
+    /**
+     * Gets the location with both zip code and geographic coordinates.
+     * Requires both 'LocationZipCode' and 'LocationCoordinates' permissions to be granted.
+     *
+     * @returns Promise that resolves to the location with zip code and coordinates, or null if not set
+     * @throws {PermissionNotGranted} If either LocationZipCode or LocationCoordinates permission is not granted
+     *
+     * @example
+     * ```typescript
+     * const location = energyApp.useLocation();
+     * const fullLocation = await location.getLocationWithCoordinates();
+     * if (fullLocation && fullLocation.coordinates) {
+     *     console.log(`Location: ${fullLocation.zipCode}`);
+     *     console.log(`Coordinates: ${fullLocation.coordinates.latitude}, ${fullLocation.coordinates.longitude}`);
+     * }
+     * ```
+     */
+    getLocationWithCoordinates(): Promise<EnyoLocation | null>;
+}

package/dist/cjs/packages/energy-app-secret-manager.d.cts

@@ -58,4 +58,26 @@ export interface EnergyAppSecretManager {
      * ```
      */
     listAvailableSecrets(): Promise<string[]>;
+    /**
+     * Saves a new secret to the secret store.
+     * The secret will be encrypted using the provided encryption key.
+     *
+     * @param secretName - The name for the new secret
+     * @param encryptionKey - The encryption key to use for encrypting the secret
+     * @param secret - The secret data to save as key-value pairs
+     * @returns Promise that resolves when the secret is successfully saved
+     * @throws {SecretNameConflictException} If a secret with this name already exists and is not an installed package secret
+     * @throws {SecretRetrievalError} If there's an error saving the secret
+     *
+     * @example
+     * ```typescript
+     * const secretManager = energyApp.useSecretManager();
+     * const encryptionKey = process.env.SECRET_ENCRYPTION_KEY;
+     * await secretManager.saveSecret("new_api_keys", encryptionKey, {
+     *     api_key: "abc123",
+     *     api_secret: "xyz789"
+     * });
+     * ```
+     */
+    saveSecret<T extends Record<string, string>>(secretName: string, encryptionKey: string, secret: T): Promise<void>;
 }

package/dist/cjs/types/enyo-battery-appliance.cjs

@@ -1,2 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnyoBatteryFeature = exports.EnyoBatteryStorageMode = void 0;
+var EnyoBatteryStorageMode;
+(function (EnyoBatteryStorageMode) {
+    EnyoBatteryStorageMode["CHARGE"] = "charge";
+    EnyoBatteryStorageMode["DISCHARGE"] = "discharge";
+    EnyoBatteryStorageMode["HOLDING"] = "holding";
+    EnyoBatteryStorageMode["AUTO"] = "auto";
+    EnyoBatteryStorageMode["Unknown"] = "unknown";
+})(EnyoBatteryStorageMode || (exports.EnyoBatteryStorageMode = EnyoBatteryStorageMode = {}));
+var EnyoBatteryFeature;
+(function (EnyoBatteryFeature) {
+    EnyoBatteryFeature["GridCharging"] = "grid-charging";
+})(EnyoBatteryFeature || (exports.EnyoBatteryFeature = EnyoBatteryFeature = {}));

package/dist/cjs/types/enyo-battery-appliance.d.cts

@@ -1,6 +1,19 @@
+export declare enum EnyoBatteryStorageMode {
+    CHARGE = "charge",
+    DISCHARGE = "discharge",
+    HOLDING = "holding",
+    AUTO = "auto",
+    Unknown = "unknown"
+}
+export declare enum EnyoBatteryFeature {
+    GridCharging = "grid-charging"
+}
 export interface EnyoBatteryApplianceMetadata {
     connectedToApplianceId?: string;
     maxDischargePowerW?: number;
     maxChargingPowerW?: number;
     maxCapacityWh?: number;
+    storageMode?: EnyoBatteryStorageMode;
+    gridChargingEnabled?: boolean;
+    features?: EnyoBatteryFeature[];
 }

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnyoDataBusMessageEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = void 0;
+exports.EnyoDataBusMessageEnum = exports.EnyoChargingStopReason = exports.EnyoChargingMeterValueContext = exports.EnyoStringStateEnum = exports.EnyoInverterStateEnum = exports.EnyoBatteryStateEnum = void 0;
 var EnyoBatteryStateEnum;
 (function (EnyoBatteryStateEnum) {
     EnyoBatteryStateEnum["Off"] = "off";
@@ -22,6 +22,18 @@ var EnyoInverterStateEnum;
     EnyoInverterStateEnum["Fault"] = "fault";
     EnyoInverterStateEnum["Standby"] = "standby";
 })(EnyoInverterStateEnum || (exports.EnyoInverterStateEnum = EnyoInverterStateEnum = {}));
+var EnyoStringStateEnum;
+(function (EnyoStringStateEnum) {
+    EnyoStringStateEnum["Off"] = "off";
+    EnyoStringStateEnum["Sleeping"] = "sleeping";
+    EnyoStringStateEnum["Starting"] = "starting";
+    EnyoStringStateEnum["Mppt"] = "mppt";
+    EnyoStringStateEnum["Throttled"] = "throttled";
+    EnyoStringStateEnum["ShuttingDown"] = "shutting-down";
+    EnyoStringStateEnum["Fault"] = "fault";
+    EnyoStringStateEnum["Standby"] = "standby";
+    EnyoStringStateEnum["Test"] = " Test";
+})(EnyoStringStateEnum || (exports.EnyoStringStateEnum = EnyoStringStateEnum = {}));
 /**
  * Charging meter value context defining when the measurement was taken
  */

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

@@ -20,6 +20,17 @@ export declare enum EnyoInverterStateEnum {
     Fault = "fault",
     Standby = "standby"
 }
+export declare enum EnyoStringStateEnum {
+    Off = "off",
+    Sleeping = "sleeping",
+    Starting = "starting",
+    Mppt = "mppt",
+    Throttled = "throttled",
+    ShuttingDown = "shutting-down",
+    Fault = "fault",
+    Standby = "standby",
+    Test = " Test"
+}
 /**
  * Charging meter value context defining when the measurement was taken
  */
@@ -198,8 +209,11 @@ export interface EnyoDataBusBatteryValuesUpdateV1 extends EnyoDataBusMessage {
 }
 export interface EnyoDataBusInverterValuesV1String {
     index: number;
+    name?: string;
     voltage?: number;
     powerW?: number;
+    current?: number;
+    state?: EnyoStringStateEnum;
 }
 export interface EnyoDataBusInverterValuesV1 extends EnyoDataBusMessage {
     type: 'message';

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,20 @@
+/**
+ * Represents geographic coordinates with latitude and longitude.
+ */
+export interface Coordinates {
+    /** Latitude in decimal degrees */
+    latitude: number;
+    /** Longitude in decimal degrees */
+    longitude: number;
+}
+/**
+ * Represents a location with zip code and optional coordinates.
+ */
+export interface EnyoZipCodeLocation {
+    /** The zip/postal code of the location */
+    zipCode: string;
+}
+export interface EnyoLocation {
+    zipCode: string;
+    coordinates: Coordinates;
+}

package/dist/cjs/types/enyo-secret-manager.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SecretRetrievalError = exports.SecretNotFoundError = void 0;
+exports.SecretNameConflictException = exports.SecretRetrievalError = exports.SecretNotFoundError = void 0;
 /**
  * Error that occurs when a secret cannot be found.
  */
@@ -13,3 +13,13 @@ exports.SecretNotFoundError = SecretNotFoundError;
 class SecretRetrievalError extends Error {
 }
 exports.SecretRetrievalError = SecretRetrievalError;
+/**
+ * Error that occurs when attempting to save a secret with a name that already exists.
+ */
+class SecretNameConflictException extends Error {
+    constructor(secretName) {
+        super(`Secret with name "${secretName}" already exists and is not an installed package secret`);
+        this.name = 'SecretNameConflictException';
+    }
+}
+exports.SecretNameConflictException = SecretNameConflictException;

package/dist/cjs/types/enyo-secret-manager.d.cts

@@ -31,3 +31,9 @@ export declare class SecretNotFoundError extends Error {
  */
 export declare class SecretRetrievalError extends Error {
 }
+/**
+ * Error that occurs when attempting to save a secret with a name that already exists.
+ */
+export declare class SecretNameConflictException extends Error {
+    constructor(secretName: string);
+}

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

package/dist/energy-app-permission.type.d.ts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -15,5 +15,7 @@ export declare enum EnergyAppPermissionTypeEnum {
     ChargingCard = "ChargingCard",
     Vehicle = "Vehicle",
     Charge = "Charge",
-    SecretManager = "SecretManager"
+    SecretManager = "SecretManager",
+    LocationZipCode = "LocationZipCode",
+    LocationCoordinates = "LocationCoordinates"
 }

package/dist/energy-app-permission.type.js

@@ -16,4 +16,6 @@ export var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["Vehicle"] = "Vehicle";
     EnergyAppPermissionTypeEnum["Charge"] = "Charge";
     EnergyAppPermissionTypeEnum["SecretManager"] = "SecretManager";
+    EnergyAppPermissionTypeEnum["LocationZipCode"] = "LocationZipCode";
+    EnergyAppPermissionTypeEnum["LocationCoordinates"] = "LocationCoordinates";
 })(EnergyAppPermissionTypeEnum || (EnergyAppPermissionTypeEnum = {}));

package/dist/enyo-energy-app-sdk.d.ts

@@ -13,6 +13,7 @@ import { EnergyAppSettings } from "./packages/energy-app-settings.js";
 import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.js";
 import { EnergyAppNotification } from "./packages/energy-app-notification.js";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.js";
+import { EnergyAppLocation } from "./packages/energy-app-location.js";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -67,4 +68,6 @@ export interface EnyoEnergyAppSdk {
     useNotification: () => EnergyAppNotification;
     /** Get the Secret Manager API */
     useSecretManager: () => EnergyAppSecretManager;
+    /** Get the Location API */
+    useLocation: () => EnergyAppLocation;
 }

package/dist/index.d.ts

@@ -14,6 +14,7 @@ import { EnergyAppSettings } from "./packages/energy-app-settings.js";
 import { EnergyAppElectricityPrices } from "./packages/energy-app-electricity-prices.js";
 import { EnergyAppNotification } from "./packages/energy-app-notification.js";
 import { EnergyAppSecretManager } from "./packages/energy-app-secret-manager.js";
+import { EnergyAppLocation } from "./packages/energy-app-location.js";
 export * from './energy-app-package-definition.js';
 export * from './version.js';
 export * from './implementations/ocpp/ocpp16.js';
@@ -25,6 +26,7 @@ export * from './types/enyo-energy-tariff.js';
 export * from './types/enyo-electricity-prices.js';
 export * from './types/enyo-notification.js';
 export * from './types/enyo-secret-manager.js';
+export * from './types/enyo-location.js';
 export * from './implementations/appliances/appliance-manager.js';
 export * from './implementations/appliances/identifier-strategies.js';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
@@ -55,6 +57,12 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Secret Manager API instance
      */
     useSecretManager(): EnergyAppSecretManager;
+    /**
+     * Gets the Location API for retrieving device location information.
+     * Provides methods to fetch location with varying levels of detail based on permissions.
+     * @returns The Location API instance
+     */
+    useLocation(): EnergyAppLocation;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/index.js

@@ -10,6 +10,7 @@ export * from './types/enyo-energy-tariff.js';
 export * from './types/enyo-electricity-prices.js';
 export * from './types/enyo-notification.js';
 export * from './types/enyo-secret-manager.js';
+export * from './types/enyo-location.js';
 export * from './implementations/appliances/appliance-manager.js';
 export * from './implementations/appliances/identifier-strategies.js';
 export class EnergyApp {
@@ -97,6 +98,14 @@ export class EnergyApp {
     useSecretManager() {
         return this.energyAppSdk.useSecretManager();
     }
+    /**
+     * Gets the Location API for retrieving device location information.
+     * Provides methods to fetch location with varying levels of detail based on permissions.
+     * @returns The Location API instance
+     */
+    useLocation() {
+        return this.energyAppSdk.useLocation();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

@@ -0,0 +1,43 @@
+import { EnyoLocation, EnyoZipCodeLocation } from "../types/enyo-location.js";
+/**
+ * Interface for managing location information in energy apps.
+ * Provides methods to retrieve the device's location with varying levels of detail
+ * based on granted permissions.
+ */
+export interface EnergyAppLocation {
+    /**
+     * Gets the location with only the zip code.
+     * Requires the 'LocationZipCode' permission to be granted.
+     *
+     * @returns Promise that resolves to the location with zip code only, or null if not set
+     * @throws {PermissionNotGranted} If the LocationZipCode permission is not granted
+     *
+     * @example
+     * ```typescript
+     * const location = energyApp.useLocation();
+     * const zipLocation = await location.getLocationByZipCode();
+     * if (zipLocation) {
+     *     console.log(`Zip Code: ${zipLocation.zipCode}`);
+     * }
+     * ```
+     */
+    getLocationByZipCode(): Promise<EnyoZipCodeLocation | null>;
+    /**
+     * Gets the location with both zip code and geographic coordinates.
+     * Requires both 'LocationZipCode' and 'LocationCoordinates' permissions to be granted.
+     *
+     * @returns Promise that resolves to the location with zip code and coordinates, or null if not set
+     * @throws {PermissionNotGranted} If either LocationZipCode or LocationCoordinates permission is not granted
+     *
+     * @example
+     * ```typescript
+     * const location = energyApp.useLocation();
+     * const fullLocation = await location.getLocationWithCoordinates();
+     * if (fullLocation && fullLocation.coordinates) {
+     *     console.log(`Location: ${fullLocation.zipCode}`);
+     *     console.log(`Coordinates: ${fullLocation.coordinates.latitude}, ${fullLocation.coordinates.longitude}`);
+     * }
+     * ```
+     */
+    getLocationWithCoordinates(): Promise<EnyoLocation | null>;
+}

package/dist/packages/energy-app-location.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/energy-app-secret-manager.d.ts

@@ -58,4 +58,26 @@ export interface EnergyAppSecretManager {
      * ```
      */
     listAvailableSecrets(): Promise<string[]>;
+    /**
+     * Saves a new secret to the secret store.
+     * The secret will be encrypted using the provided encryption key.
+     *
+     * @param secretName - The name for the new secret
+     * @param encryptionKey - The encryption key to use for encrypting the secret
+     * @param secret - The secret data to save as key-value pairs
+     * @returns Promise that resolves when the secret is successfully saved
+     * @throws {SecretNameConflictException} If a secret with this name already exists and is not an installed package secret
+     * @throws {SecretRetrievalError} If there's an error saving the secret
+     *
+     * @example
+     * ```typescript
+     * const secretManager = energyApp.useSecretManager();
+     * const encryptionKey = process.env.SECRET_ENCRYPTION_KEY;
+     * await secretManager.saveSecret("new_api_keys", encryptionKey, {
+     *     api_key: "abc123",
+     *     api_secret: "xyz789"
+     * });
+     * ```
+     */
+    saveSecret<T extends Record<string, string>>(secretName: string, encryptionKey: string, secret: T): Promise<void>;
 }

package/dist/types/enyo-battery-appliance.d.ts

@@ -1,6 +1,19 @@
+export declare enum EnyoBatteryStorageMode {
+    CHARGE = "charge",
+    DISCHARGE = "discharge",
+    HOLDING = "holding",
+    AUTO = "auto",
+    Unknown = "unknown"
+}
+export declare enum EnyoBatteryFeature {
+    GridCharging = "grid-charging"
+}
 export interface EnyoBatteryApplianceMetadata {
     connectedToApplianceId?: string;
     maxDischargePowerW?: number;
     maxChargingPowerW?: number;
     maxCapacityWh?: number;
+    storageMode?: EnyoBatteryStorageMode;
+    gridChargingEnabled?: boolean;
+    features?: EnyoBatteryFeature[];
 }

package/dist/types/enyo-battery-appliance.js

@@ -1 +1,12 @@
-export {};
+export var EnyoBatteryStorageMode;
+(function (EnyoBatteryStorageMode) {
+    EnyoBatteryStorageMode["CHARGE"] = "charge";
+    EnyoBatteryStorageMode["DISCHARGE"] = "discharge";
+    EnyoBatteryStorageMode["HOLDING"] = "holding";
+    EnyoBatteryStorageMode["AUTO"] = "auto";
+    EnyoBatteryStorageMode["Unknown"] = "unknown";
+})(EnyoBatteryStorageMode || (EnyoBatteryStorageMode = {}));
+export var EnyoBatteryFeature;
+(function (EnyoBatteryFeature) {
+    EnyoBatteryFeature["GridCharging"] = "grid-charging";
+})(EnyoBatteryFeature || (EnyoBatteryFeature = {}));

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

@@ -20,6 +20,17 @@ export declare enum EnyoInverterStateEnum {
     Fault = "fault",
     Standby = "standby"
 }
+export declare enum EnyoStringStateEnum {
+    Off = "off",
+    Sleeping = "sleeping",
+    Starting = "starting",
+    Mppt = "mppt",
+    Throttled = "throttled",
+    ShuttingDown = "shutting-down",
+    Fault = "fault",
+    Standby = "standby",
+    Test = " Test"
+}
 /**
  * Charging meter value context defining when the measurement was taken
  */
@@ -198,8 +209,11 @@ export interface EnyoDataBusBatteryValuesUpdateV1 extends EnyoDataBusMessage {
 }
 export interface EnyoDataBusInverterValuesV1String {
     index: number;
+    name?: string;
     voltage?: number;
     powerW?: number;
+    current?: number;
+    state?: EnyoStringStateEnum;
 }
 export interface EnyoDataBusInverterValuesV1 extends EnyoDataBusMessage {
     type: 'message';

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

@@ -19,6 +19,18 @@ export var EnyoInverterStateEnum;
     EnyoInverterStateEnum["Fault"] = "fault";
     EnyoInverterStateEnum["Standby"] = "standby";
 })(EnyoInverterStateEnum || (EnyoInverterStateEnum = {}));
+export var EnyoStringStateEnum;
+(function (EnyoStringStateEnum) {
+    EnyoStringStateEnum["Off"] = "off";
+    EnyoStringStateEnum["Sleeping"] = "sleeping";
+    EnyoStringStateEnum["Starting"] = "starting";
+    EnyoStringStateEnum["Mppt"] = "mppt";
+    EnyoStringStateEnum["Throttled"] = "throttled";
+    EnyoStringStateEnum["ShuttingDown"] = "shutting-down";
+    EnyoStringStateEnum["Fault"] = "fault";
+    EnyoStringStateEnum["Standby"] = "standby";
+    EnyoStringStateEnum["Test"] = " Test";
+})(EnyoStringStateEnum || (EnyoStringStateEnum = {}));
 /**
  * Charging meter value context defining when the measurement was taken
  */

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

@@ -0,0 +1,20 @@
+/**
+ * Represents geographic coordinates with latitude and longitude.
+ */
+export interface Coordinates {
+    /** Latitude in decimal degrees */
+    latitude: number;
+    /** Longitude in decimal degrees */
+    longitude: number;
+}
+/**
+ * Represents a location with zip code and optional coordinates.
+ */
+export interface EnyoZipCodeLocation {
+    /** The zip/postal code of the location */
+    zipCode: string;
+}
+export interface EnyoLocation {
+    zipCode: string;
+    coordinates: Coordinates;
+}

package/dist/types/enyo-location.js

@@ -0,0 +1 @@
+export {};

package/dist/types/enyo-secret-manager.d.ts

@@ -31,3 +31,9 @@ export declare class SecretNotFoundError extends Error {
  */
 export declare class SecretRetrievalError extends Error {
 }
+/**
+ * Error that occurs when attempting to save a secret with a name that already exists.
+ */
+export declare class SecretNameConflictException extends Error {
+    constructor(secretName: string);
+}

package/dist/types/enyo-secret-manager.js

@@ -8,3 +8,12 @@ export class SecretNotFoundError extends Error {
  */
 export class SecretRetrievalError extends Error {
 }
+/**
+ * Error that occurs when attempting to save a secret with a name that already exists.
+ */
+export class SecretNameConflictException extends Error {
+    constructor(secretName) {
+        super(`Secret with name "${secretName}" already exists and is not an installed package secret`);
+        this.name = 'SecretNameConflictException';
+    }
+}

package/dist/version.d.ts

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