@enyo-energy/energy-app-sdk 0.0.39 → 0.0.41

package/dist/cjs/index.d.cts

@@ -13,6 +13,7 @@ import { EnergyAppAuthentication } from "./packages/energy-app-authentication.cj
 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";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -23,6 +24,7 @@ export * from './types/enyo-settings.cjs';
 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 './implementations/appliances/appliance-manager.cjs';
 export * from './implementations/appliances/identifier-strategies.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
@@ -47,6 +49,12 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
     useSettings(): EnergyAppSettings;
     useElectricityPrices(): EnergyAppElectricityPrices;
     useNotification(): EnergyAppNotification;
+    /**
+     * Gets the Secret Manager API for retrieving secrets from the developer organization.
+     * Provides methods to fetch secrets that have been configured in the developer org's secret store.
+     * @returns The Secret Manager API instance
+     */
+    useSecretManager(): EnergyAppSecretManager;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

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

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

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

@@ -0,0 +1,61 @@
+import { SecretValue } from "../types/enyo-secret-manager.cjs";
+export interface EnergyAppSecretManager {
+    /**
+     * Retrieves and decrypts a single secret from the developer organization's secret store.
+     * The secret must have been previously configured in the developer org using the enyo CLI.
+     *
+     * @param secretName - The name of the secret to retrieve (e.g., "ostrom_oauth")
+     * @param encryptionKey - The encryption key used to decrypt the secret
+     * @returns Promise that resolves to an object containing the decrypted secret's key-value pairs
+     * @throws {SecretNotFoundError} If the secret does not exist
+     * @throws {SecretRetrievalError} If there's an error retrieving or decrypting the secret
+     *
+     * @example
+     * ```typescript
+     * const secretManager = energyApp.useSecretManager();
+     * const oauthSecret = await secretManager.getSecret("oauth", encryptionKey);
+     * // Returns: { client_id: "...", client_secret: "..." }
+     * ```
+     */
+    getSecret(secretName: string, encryptionKey: string): Promise<SecretValue>;
+    /**
+     * Retrieves and decrypts multiple secrets from the developer organization's secret store in a single request.
+     * This is more efficient than making multiple individual requests.
+     * All secrets must have been previously configured using the enyo CLI.
+     *
+     * @param secretNames - Array of secret names to retrieve
+     * @param encryptionKey - The encryption key used to decrypt the secrets
+     * @returns Promise that resolves to a record mapping secret names to their decrypted values
+     * @throws {SecretNotFoundError} If any of the secrets do not exist
+     * @throws {SecretRetrievalError} If there's an error retrieving or decrypting the secrets
+     *
+     * @example
+     * ```typescript
+     * const secretManager = energyApp.useSecretManager();
+     * const encryptionKey = process.env.SECRET_ENCRYPTION_KEY;
+     * const secrets = await secretManager.getSecrets(["api_keys", "oauth_config"], encryptionKey);
+     * // Returns: {
+     * //   "api_keys": { api_key: "...", api_secret: "..." },
+     * //   "oauth_config": { client_id: "...", client_secret: "..." }
+     * // }
+     * ```
+     */
+    getSecrets(secretNames: string[], encryptionKey: string): Promise<Record<string, SecretValue>>;
+    /**
+     * Lists all available secret names that can be retrieved from the developer organization.
+     * This can be useful for discovering what secrets have been configured.
+     * Note: This returns only the names of secrets, not their values.
+     *
+     * @returns Promise that resolves to an array of available secret names
+     * @throws {SecretRetrievalError} If there's an error listing the secrets
+     *
+     * @example
+     * ```typescript
+     * const secretManager = energyApp.useSecretManager();
+     * const encryptionKey = process.env.SECRET_ENCRYPTION_KEY;
+     * const availableSecrets = await secretManager.listAvailableSecrets(encryptionKey);
+     * // Returns: ["oauth", "api_keys", "database_config"]
+     * ```
+     */
+    listAvailableSecrets(): Promise<string[]>;
+}

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

@@ -207,16 +207,27 @@ export interface EnyoDataBusInverterValuesV1 extends EnyoDataBusMessage {
     /** ID of the appliance that delivered these values */
     applianceId: string;
     data: {
+        /** Operation State of the inverter */
         state?: EnyoInverterStateEnum;
         /** Current PV Production (in Watt) */
         pvPowerW: number;
-        /** voltage of Phase L1 to N*/
+        /** voltage of Phase L1 to N in V */
         voltageL1: number;
-        /** voltage of Phase L2 to N*/
+        /** voltage of Phase L2 to N in V */
         voltageL2?: number;
-        /** voltage of Phase L3 to N*/
+        /** voltage of Phase L3 to N in V */
         voltageL3?: number;
+        /** Current of Phase L1 to N in A */
+        currentL1?: number;
+        /** Current of Phase L2 to N in A */
+        currentL2?: number;
+        /** Current of Phase L3 to N in A */
+        currentL3?: number;
+        /** DC Power in W */
+        dcPowerW?: number;
+        /** Active power Limitation of the Inverter */
         activePowerLimitationW?: number;
+        /** DC String values. Please only provide active strings */
         strings?: EnyoDataBusInverterValuesV1String[];
     };
 }

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecretRetrievalError = exports.SecretNotFoundError = void 0;
+/**
+ * Error that occurs when a secret cannot be found.
+ */
+class SecretNotFoundError extends Error {
+}
+exports.SecretNotFoundError = SecretNotFoundError;
+/**
+ * Error that occurs when secret retrieval fails.
+ */
+class SecretRetrievalError extends Error {
+}
+exports.SecretRetrievalError = SecretRetrievalError;

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

@@ -0,0 +1,33 @@
+/**
+ * Represents a secret value object containing key-value pairs.
+ * The secret is retrieved from the developer organization's secret store.
+ */
+export interface SecretValue {
+    [key: string]: string;
+}
+/**
+ * Request structure for fetching a single secret.
+ */
+export interface SecretRequest {
+    /** The name of the secret to retrieve */
+    secretName: string;
+}
+/**
+ * Response structure for secret retrieval operations.
+ */
+export interface SecretResponse {
+    /** The name of the secret */
+    secretName: string;
+    /** The secret values as key-value pairs */
+    values: SecretValue;
+}
+/**
+ * Error that occurs when a secret cannot be found.
+ */
+export declare class SecretNotFoundError extends Error {
+}
+/**
+ * Error that occurs when secret retrieval fails.
+ */
+export declare class SecretRetrievalError extends Error {
+}

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.39';
+exports.SDK_VERSION = '0.0.41';
 /**
  * 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.39";
+export declare const SDK_VERSION = "0.0.41";
 /**
  * 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';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -14,5 +14,6 @@ export declare enum EnergyAppPermissionTypeEnum {
     OcppServer = "OcppServer",
     ChargingCard = "ChargingCard",
     Vehicle = "Vehicle",
-    Charge = "Charge"
+    Charge = "Charge",
+    SecretManager = "SecretManager"
 }

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

@@ -15,4 +15,5 @@ export var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["ChargingCard"] = "ChargingCard";
     EnergyAppPermissionTypeEnum["Vehicle"] = "Vehicle";
     EnergyAppPermissionTypeEnum["Charge"] = "Charge";
+    EnergyAppPermissionTypeEnum["SecretManager"] = "SecretManager";
 })(EnergyAppPermissionTypeEnum || (EnergyAppPermissionTypeEnum = {}));

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

@@ -12,6 +12,7 @@ import { EnergyAppAuthentication } from "./packages/energy-app-authentication.js
 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";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -64,4 +65,6 @@ export interface EnyoEnergyAppSdk {
     useElectricityPrices: () => EnergyAppElectricityPrices;
     /** Get the Notification API */
     useNotification: () => EnergyAppNotification;
+    /** Get the Secret Manager API */
+    useSecretManager: () => EnergyAppSecretManager;
 }

package/dist/implementations/appliances/appliance-manager.d.ts

@@ -1,4 +1,4 @@
-import type { EnergyApp } from "../../index.js";
+import { EnergyApp } from "../../index.js";
 import type { EnyoNetworkDevice } from "../../types/enyo-network-device.js";
 import { EnyoAppliance, EnyoApplianceConnectionType, EnyoApplianceMetadata, EnyoApplianceName, EnyoApplianceStateEnum, EnyoApplianceTopology, EnyoApplianceTypeEnum } from "../../types/enyo-appliance.js";
 import type { EnyoChargerApplianceMetadata } from "../../types/enyo-charger-appliance.js";
@@ -22,13 +22,11 @@ export interface ApplianceConfig {
     /** Topology information */
     topology?: EnyoApplianceTopology;
     /** Type-specific metadata based on appliance type */
-    typeMetadata?: {
-        meter?: EnyoMeterAppliance;
-        inverter?: EnyoInverterApplianceMetadata;
-        charger?: EnyoChargerApplianceMetadata;
-        heatpump?: EnyoHeatpumpApplianceMetadata;
-        battery?: EnyoBatteryApplianceMetadata;
-    };
+    meter?: EnyoMeterAppliance;
+    inverter?: EnyoInverterApplianceMetadata;
+    charger?: EnyoChargerApplianceMetadata;
+    heatpump?: EnyoHeatpumpApplianceMetadata;
+    battery?: EnyoBatteryApplianceMetadata;
 }
 /**
  * Configuration options for the ApplianceManager.
@@ -64,26 +62,33 @@ export declare class ApplianceManager {
     private energyApp;
     private applianceCache;
     private identifierToApplianceId;
-    private config;
+    protected config: Required<ApplianceManagerConfig>;
     /**
      * Creates a new ApplianceManager instance.
      * @param energyApp The EnergyApp instance to use for API calls
      * @param config Configuration options for the manager
      */
     constructor(energyApp: EnergyApp, config?: ApplianceManagerConfig);
+    /**
+     * initializes a new ApplianceManager instance with async initialization.
+     * This factory method handles cache initialization if configured.
+     * @param energyApp The EnergyApp instance to use for API calls
+     * @param config Configuration options for the manager
+     * @returns Promise that resolves to an initialized ApplianceManager instance
+     */
+    static initialize(energyApp: EnergyApp, config?: ApplianceManagerConfig): Promise<ApplianceManager>;
     /**
      * Creates or updates an appliance with the given configuration.
-     * @param config The appliance configuration
-     * @param existingApplianceId Optional ID of an existing appliance to update
+     * Automatically detects if an appliance already exists based on the identifier strategy.
+     * @param appliance The appliance configuration
      * @returns The ID of the created or updated appliance
      */
-    createOrUpdateAppliance(config: ApplianceConfig, existingApplianceId?: string): Promise<string>;
+    createOrUpdateAppliance(appliance: ApplianceConfig): Promise<string>;
     /**
      * Updates the internal cache with an appliance.
      * @param appliance The appliance to cache
-     * @param networkDevice Optional network device for identifier extraction
      */
-    protected updateCache(appliance: EnyoAppliance, networkDevice?: EnyoNetworkDevice): void;
+    protected updateCache(appliance: EnyoAppliance): void;
     /**
      * Clears the internal cache.
      */

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

@@ -1,5 +1,5 @@
+import { SerialNumberStrategy } from "../../index.js";
 import { EnyoApplianceConnectionType, EnyoApplianceStateEnum } from "../../types/enyo-appliance.js";
-import { NetworkDeviceIdStrategy } from "./identifier-strategies.js";
 /**
  * Manages appliances in the energy system with configurable identification strategies.
  * Provides comprehensive CRUD operations and state management for energy appliances.
@@ -17,62 +17,90 @@ export class ApplianceManager {
     constructor(energyApp, config) {
         this.energyApp = energyApp;
         this.config = {
-            identifierStrategy: config?.identifierStrategy ?? new NetworkDeviceIdStrategy(),
+            identifierStrategy: config?.identifierStrategy ?? new SerialNumberStrategy(),
             autoUpdateMetadata: config?.autoUpdateMetadata ?? true,
             enableLogging: config?.enableLogging ?? true,
             defaultConnectionType: config?.defaultConnectionType ?? EnyoApplianceConnectionType.Connector,
-            defaultVendorName: config?.defaultVendorName ?? ''
+            defaultVendorName: config?.defaultVendorName ?? '',
         };
     }
+    /**
+     * initializes a new ApplianceManager instance with async initialization.
+     * This factory method handles cache initialization if configured.
+     * @param energyApp The EnergyApp instance to use for API calls
+     * @param config Configuration options for the manager
+     * @returns Promise that resolves to an initialized ApplianceManager instance
+     */
+    static async initialize(energyApp, config) {
+        const manager = new ApplianceManager(energyApp, config);
+        await manager.refreshCache();
+        return manager;
+    }
     /**
      * Creates or updates an appliance with the given configuration.
-     * @param config The appliance configuration
-     * @param existingApplianceId Optional ID of an existing appliance to update
+     * Automatically detects if an appliance already exists based on the identifier strategy.
+     * @param appliance The appliance configuration
      * @returns The ID of the created or updated appliance
      */
-    async createOrUpdateAppliance(config, existingApplianceId) {
+    async createOrUpdateAppliance(appliance) {
+        // Refresh cache to ensure we have latest appliances
+        await this.refreshCache();
+        // Try to find existing appliance using identifier strategy
+        let existingApplianceId;
+        const identifier = this.config.identifierStrategy.extract(appliance);
+        if (identifier) {
+            const existing = await this.findByIdentifier(identifier);
+            if (existing.length > 0) {
+                existingApplianceId = existing[0].id;
+                if (this.config.enableLogging) {
+                    console.log(`Found existing appliance with ID ${existingApplianceId} for identifier ${identifier}`);
+                }
+            }
+        }
         // Build network device IDs list
-        const networkDeviceIds = config.networkDevices?.map(d => d.id) ?? [];
+        const networkDeviceIds = appliance.networkDevices?.map(d => d.id) ?? [];
         // Merge metadata with defaults
         const metadata = {
             connectionType: this.config.defaultConnectionType,
             state: EnyoApplianceStateEnum.Connected,
-            ...config.metadata
+            ...appliance.metadata
         };
         if (this.config.defaultVendorName && !metadata.vendorName) {
             metadata.vendorName = this.config.defaultVendorName;
         }
         // Build appliance data
         const applianceData = {
-            name: config.name,
-            type: config.type,
+            name: appliance.name,
+            type: appliance.type,
             networkDeviceIds,
             metadata,
-            ...(config.topology && { topology: config.topology })
+            ...(appliance.topology && { topology: appliance.topology }),
+            meter: appliance.meter,
+            heatpump: appliance.heatpump,
+            battery: appliance.battery,
+            charger: appliance.charger,
+            inverter: appliance.inverter,
         };
-        // Add type-specific metadata
-        if (config.typeMetadata) {
-            Object.assign(applianceData, config.typeMetadata);
-        }
         // Save appliance
         const applianceId = await this.energyApp.useAppliances().save(applianceData, existingApplianceId);
         // Update cache
         const savedAppliance = await this.energyApp.useAppliances().getById(applianceId);
         if (savedAppliance) {
-            this.updateCache(savedAppliance, config.networkDevices?.[0]);
+            this.updateCache(savedAppliance);
+        }
+        if (this.config.enableLogging) {
+            console.log(`${existingApplianceId ? 'Updated' : 'Created'} appliance ${applianceId} of type ${appliance.type}`);
         }
-        console.log(`${existingApplianceId ? 'Updated' : 'Created'} appliance ${applianceId} of type ${config.type}`);
         return applianceId;
     }
     /**
      * Updates the internal cache with an appliance.
      * @param appliance The appliance to cache
-     * @param networkDevice Optional network device for identifier extraction
      */
-    updateCache(appliance, networkDevice) {
+    updateCache(appliance) {
         this.applianceCache.set(appliance.id, appliance);
         // Extract identifier
-        const identifier = this.config.identifierStrategy.extract(appliance, networkDevice);
+        const identifier = this.config.identifierStrategy.extract(appliance);
         if (identifier) {
             if (!this.identifierToApplianceId.has(identifier)) {
                 this.identifierToApplianceId.set(identifier, new Set());
@@ -96,7 +124,7 @@ export class ApplianceManager {
         for (const appliance of appliances) {
             // Try to get network devices if available
             const networkDevices = await this.getNetworkDevicesForAppliance(appliance);
-            this.updateCache(appliance, networkDevices[0]);
+            this.updateCache(appliance);
         }
     }
     /**
@@ -140,10 +168,10 @@ export class ApplianceManager {
         const matches = [];
         for (const appliance of allAppliances) {
             const networkDevices = await this.getNetworkDevicesForAppliance(appliance);
-            const extractedId = this.config.identifierStrategy.extract(appliance, networkDevices[0]);
+            const extractedId = this.config.identifierStrategy.extract(appliance);
             if (extractedId === identifier) {
                 matches.push(appliance);
-                this.updateCache(appliance, networkDevices[0]);
+                this.updateCache(appliance);
             }
         }
         return matches;
@@ -159,7 +187,7 @@ export class ApplianceManager {
         for (const strategy of strategies) {
             for (const appliance of allAppliances) {
                 const networkDevices = await this.getNetworkDevicesForAppliance(appliance);
-                const identifier = strategy.extract(appliance, networkDevices[0]);
+                const identifier = strategy.extract(appliance);
                 if (identifier === searchValue) {
                     return {
                         appliance,

package/dist/implementations/appliances/identifier-strategies.d.ts

@@ -1,5 +1,5 @@
 import type { EnyoAppliance } from "../../types/enyo-appliance.js";
-import type { EnyoNetworkDevice } from "../../types/enyo-network-device.js";
+import { ApplianceConfig } from "./appliance-manager.js";
 /**
  * Strategy interface for extracting unique identifiers from appliances.
  * Allows flexible identification of appliances based on different criteria.
@@ -8,29 +8,14 @@ export interface IdentifierStrategy {
     /**
      * Extract the unique identifier from an appliance or its associated data.
      * @param appliance The appliance to extract the identifier from
-     * @param networkDevice Optional network device associated with the appliance
      * @returns The extracted identifier string, or undefined if not available
      */
-    extract(appliance: Partial<EnyoAppliance>, networkDevice?: EnyoNetworkDevice): string | undefined;
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
     /**
      * Name of the strategy for logging and debugging purposes.
      */
     name: string;
 }
-/**
- * Strategy that uses the network device ID as the identifier.
- * This is the default strategy for most appliances.
- */
-export declare class NetworkDeviceIdStrategy implements IdentifierStrategy {
-    name: string;
-    /**
-     * Extracts the network device ID.
-     * @param appliance The appliance (not used in this strategy)
-     * @param networkDevice The network device to get the ID from
-     * @returns The network device ID or undefined
-     */
-    extract(appliance: Partial<EnyoAppliance>, networkDevice?: EnyoNetworkDevice): string | undefined;
-}
 /**
  * Strategy that uses the appliance's serial number as the identifier.
  * Useful when appliances can move between network devices.
@@ -42,7 +27,7 @@ export declare class SerialNumberStrategy implements IdentifierStrategy {
      * @param appliance The appliance to extract the serial number from
      * @returns The serial number or undefined
      */
-    extract(appliance: Partial<EnyoAppliance>): string | undefined;
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
 }
 /**
  * Strategy that uses a custom metadata field as the identifier.
@@ -61,7 +46,7 @@ export declare class CustomMetadataStrategy implements IdentifierStrategy {
      * @param appliance The appliance to extract the field from
      * @returns The field value or undefined
      */
-    extract(appliance: Partial<EnyoAppliance>): string | undefined;
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
 }
 /**
  * Strategy that combines multiple identifiers to create a composite key.
@@ -80,10 +65,9 @@ export declare class CompositeIdentifierStrategy implements IdentifierStrategy {
     /**
      * Extracts and combines identifiers from multiple strategies.
      * @param appliance The appliance to extract identifiers from
-     * @param networkDevice The network device if available
      * @returns The combined identifier or undefined if any part is missing
      */
-    extract(appliance: Partial<EnyoAppliance>, networkDevice?: EnyoNetworkDevice): string | undefined;
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
 }
 /**
  * Strategy that tries multiple strategies in order and uses the first available identifier.
@@ -100,19 +84,14 @@ export declare class FallbackIdentifierStrategy implements IdentifierStrategy {
     /**
      * Tries strategies in order and returns the first available identifier.
      * @param appliance The appliance to extract identifiers from
-     * @param networkDevice The network device if available
      * @returns The first available identifier or undefined
      */
-    extract(appliance: Partial<EnyoAppliance>, networkDevice?: EnyoNetworkDevice): string | undefined;
+    extract(appliance: EnyoAppliance | ApplianceConfig): string | undefined;
 }
 /**
  * Factory class for creating common identifier strategies.
  */
 export declare class IdentifierStrategyFactory {
-    /**
-     * Creates the default network device ID strategy.
-     */
-    static networkDeviceId(): NetworkDeviceIdStrategy;
     /**
      * Creates a serial number strategy.
      */
@@ -133,8 +112,4 @@ export declare class IdentifierStrategyFactory {
      * @param strategies The strategies to try
      */
     static fallback(strategies: IdentifierStrategy[]): FallbackIdentifierStrategy;
-    /**
-     * Creates a strategy that prefers serial number but falls back to network device ID.
-     */
-    static serialNumberOrDeviceId(): FallbackIdentifierStrategy;
 }

package/dist/implementations/appliances/identifier-strategies.js

@@ -1,19 +1,3 @@
-/**
- * Strategy that uses the network device ID as the identifier.
- * This is the default strategy for most appliances.
- */
-export class NetworkDeviceIdStrategy {
-    name = 'networkDeviceId';
-    /**
-     * Extracts the network device ID.
-     * @param appliance The appliance (not used in this strategy)
-     * @param networkDevice The network device to get the ID from
-     * @returns The network device ID or undefined
-     */
-    extract(appliance, networkDevice) {
-        return networkDevice?.id;
-    }
-}
 /**
  * Strategy that uses the appliance's serial number as the identifier.
  * Useful when appliances can move between network devices.
@@ -75,13 +59,12 @@ export class CompositeIdentifierStrategy {
     /**
      * Extracts and combines identifiers from multiple strategies.
      * @param appliance The appliance to extract identifiers from
-     * @param networkDevice The network device if available
      * @returns The combined identifier or undefined if any part is missing
      */
-    extract(appliance, networkDevice) {
+    extract(appliance) {
         const parts = [];
         for (const strategy of this.strategies) {
-            const value = strategy.extract(appliance, networkDevice);
+            const value = strategy.extract(appliance);
             if (!value) {
                 return undefined; // All parts must be present
             }
@@ -108,12 +91,11 @@ export class FallbackIdentifierStrategy {
     /**
      * Tries strategies in order and returns the first available identifier.
      * @param appliance The appliance to extract identifiers from
-     * @param networkDevice The network device if available
      * @returns The first available identifier or undefined
      */
-    extract(appliance, networkDevice) {
+    extract(appliance) {
         for (const strategy of this.strategies) {
-            const value = strategy.extract(appliance, networkDevice);
+            const value = strategy.extract(appliance);
             if (value) {
                 return value;
             }
@@ -125,12 +107,6 @@ export class FallbackIdentifierStrategy {
  * Factory class for creating common identifier strategies.
  */
 export class IdentifierStrategyFactory {
-    /**
-     * Creates the default network device ID strategy.
-     */
-    static networkDeviceId() {
-        return new NetworkDeviceIdStrategy();
-    }
     /**
      * Creates a serial number strategy.
      */
@@ -159,13 +135,4 @@ export class IdentifierStrategyFactory {
     static fallback(strategies) {
         return new FallbackIdentifierStrategy(strategies);
     }
-    /**
-     * Creates a strategy that prefers serial number but falls back to network device ID.
-     */
-    static serialNumberOrDeviceId() {
-        return new FallbackIdentifierStrategy([
-            new SerialNumberStrategy(),
-            new NetworkDeviceIdStrategy()
-        ]);
-    }
 }

package/dist/implementations/appliances/in-memory-appliance-manager.d.ts

@@ -20,11 +20,10 @@ export declare class InMemoryApplianceManager extends ApplianceManager {
     constructor(energyApp: EnergyApp, config?: ApplianceManagerConfig);
     /**
      * Creates or updates an appliance in memory.
-     * @param config The appliance configuration
-     * @param existingApplianceId Optional ID of an existing appliance to update
+     * @param appliance The appliance configuration
      * @returns The ID of the created or updated appliance
      */
-    createOrUpdateAppliance(config: ApplianceConfig, existingApplianceId?: string): Promise<string>;
+    createOrUpdateAppliance(appliance: ApplianceConfig): Promise<string>;
     /**
      * Gets an appliance by ID from memory.
      * @param applianceId The ID of the appliance