@enyo-energy/energy-app-sdk 0.0.43 → 0.0.45

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/implementations/appliances/appliance-manager.cjs

@@ -240,28 +240,24 @@ class ApplianceManager {
     /**
      * Updates metadata for an appliance.
      * @param applianceId The ID of the appliance
-     * @param metadata The metadata to update
+     * @param attributes The attributes to update
      */
-    async updateApplianceMetadata(applianceId, metadata) {
+    async updateAppliance(applianceId, attributes) {
         try {
             const appliance = await this.energyApp.useAppliances().getById(applianceId);
             if (appliance) {
                 const updatedAppliance = {
                     ...appliance,
-                    metadata: {
-                        ...appliance.metadata,
-                        ...metadata
-                    }
+                    ...attributes
                 };
                 await this.energyApp.useAppliances().save(updatedAppliance, applianceId);
                 // Update cache
-                appliance.metadata = { ...appliance.metadata, ...metadata };
-                this.applianceCache.set(applianceId, appliance);
-                console.log(`Updated metadata for appliance ${applianceId}`);
+                this.applianceCache.set(applianceId, { id: applianceId, ...updatedAppliance });
+                console.log(`Updated appliance ${applianceId}`);
             }
         }
         catch (error) {
-            console.error(`Failed to update metadata for appliance ${applianceId}: ${error}`);
+            console.error(`Failed to update appliance ${applianceId}: ${error}`);
             throw error;
         }
     }

package/dist/cjs/implementations/appliances/appliance-manager.d.cts

@@ -132,11 +132,9 @@ export declare class ApplianceManager {
     /**
      * Updates metadata for an appliance.
      * @param applianceId The ID of the appliance
-     * @param metadata The metadata to update
+     * @param attributes The attributes to update
      */
-    updateApplianceMetadata(applianceId: string, metadata: Partial<EnyoApplianceMetadata> & {
-        connectionType: EnyoApplianceConnectionType;
-    }): Promise<void>;
+    updateAppliance(applianceId: string, attributes: Partial<EnyoAppliance>): Promise<void>;
     /**
      * Removes an appliance by its ID.
      * @param applianceId The ID of the appliance to remove

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>(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-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.43';
+exports.SDK_VERSION = '0.0.45';
 /**
  * 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.43";
+export declare const SDK_VERSION = "0.0.45";
 /**
  * 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/implementations/appliances/appliance-manager.d.ts

@@ -132,11 +132,9 @@ export declare class ApplianceManager {
     /**
      * Updates metadata for an appliance.
      * @param applianceId The ID of the appliance
-     * @param metadata The metadata to update
+     * @param attributes The attributes to update
      */
-    updateApplianceMetadata(applianceId: string, metadata: Partial<EnyoApplianceMetadata> & {
-        connectionType: EnyoApplianceConnectionType;
-    }): Promise<void>;
+    updateAppliance(applianceId: string, attributes: Partial<EnyoAppliance>): Promise<void>;
     /**
      * Removes an appliance by its ID.
      * @param applianceId The ID of the appliance to remove

package/dist/implementations/appliances/appliance-manager.js

@@ -237,28 +237,24 @@ export class ApplianceManager {
     /**
      * Updates metadata for an appliance.
      * @param applianceId The ID of the appliance
-     * @param metadata The metadata to update
+     * @param attributes The attributes to update
      */
-    async updateApplianceMetadata(applianceId, metadata) {
+    async updateAppliance(applianceId, attributes) {
         try {
             const appliance = await this.energyApp.useAppliances().getById(applianceId);
             if (appliance) {
                 const updatedAppliance = {
                     ...appliance,
-                    metadata: {
-                        ...appliance.metadata,
-                        ...metadata
-                    }
+                    ...attributes
                 };
                 await this.energyApp.useAppliances().save(updatedAppliance, applianceId);
                 // Update cache
-                appliance.metadata = { ...appliance.metadata, ...metadata };
-                this.applianceCache.set(applianceId, appliance);
-                console.log(`Updated metadata for appliance ${applianceId}`);
+                this.applianceCache.set(applianceId, { id: applianceId, ...updatedAppliance });
+                console.log(`Updated appliance ${applianceId}`);
             }
         }
         catch (error) {
-            console.error(`Failed to update metadata for appliance ${applianceId}: ${error}`);
+            console.error(`Failed to update appliance ${applianceId}: ${error}`);
             throw error;
         }
     }

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>(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-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.43";
+export declare const SDK_VERSION = "0.0.45";
 /**
  * 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.43';
+export const SDK_VERSION = '0.0.45';
 /**
  * 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.43",
+  "version": "0.0.45",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",