@enyo-energy/energy-app-sdk 1.38.0 → 1.40.0

package/README.md

@@ -1290,32 +1290,150 @@ prices.onPriceChange((newPrice) => {
 
 #### `useNotification(): EnergyAppNotification`
 
-Send notifications to users:
+Send notifications to users. Every category must be registered before it is used; the host uses the category for the
+user's on/off switch and for rate limits.
 
 ```typescript
 const notifications = energyApp.useNotification();
 
-// Send info notification
-await notifications.sendNotification({
-    type: 'info',
-    title: 'Energy Optimization',
-    message: 'Your system is running optimally',
-    timestamp: Date.now()
+notifications.registerNotificationCategory({
+    category: 'connection-issue',
+    name: [
+        { language: 'en', name: 'Connection issue' },
+        { language: 'de', name: 'Verbindungsproblem' }
+    ]
 });
 
-// Send warning
-await notifications.sendNotification({
-    type: 'warning',
-    title: 'High Energy Consumption',
-    message: 'Consider reducing energy usage during peak hours'
-});
+const notificationId = notifications.sendNotification(
+    'connection-issue',
+    { applianceId, target: { type: 'appliance-settings', applianceId } },
+    [
+        { language: 'en', title: 'Inverter offline', body: 'Inverter communication lost - please check the connection.' },
+        { language: 'de', title: 'Wechselrichter offline', body: 'Keine Verbindung zum Wechselrichter - bitte Verbindung prüfen.' }
+    ]
+);
+```
+
+Categories:
+
+| Category | Use when |
+|---|---|
+| `connection-issue` | An appliance, gateway or upstream service is unreachable. |
+| `onboarding-required` | The user has to complete (or revisit) an onboarding flow. |
+| `charging-issue` | The app asked a charger to charge, but it is not charging. See [Charging issues](#charging-issues). |
+| `battery-issue` | The app commanded a battery, but it does not follow the command. See [Battery issues](#battery-issues). |
+| `authentication-required` | A sign-in that used to work was lost. See [Lost sign-in](#lost-sign-in). |
+
+Targets (`options.target`) decide where tapping the notification leads:
+
+| Target | Opens |
+|---|---|
+| `{ type: 'onboarding', onboardingName }` | A registered onboarding guide. |
+| `{ type: 'energy-app-settings' }` | The package's own settings. |
+| `{ type: 'appliance-settings', applianceId }` | The settings screen of an appliance. |
+| `{ type: 'appliance', applianceId }` | The live view of an appliance (current state, power and session). |
+| `{ type: 'authentication', applianceId? }` | The package's pending sign-in, created with `requestAuthentication()`. |
+| `{ type: 'subscription-offer', planKey }` | The offer screen for a subscription plan. |
 
-// Send critical alert
-await notifications.sendNotification({
-    type: 'error',
-    title: 'System Fault',
-    message: 'Inverter communication lost - please check connection'
+`sendNotification` throws an `EnyoNotificationSendError` with `type: 'not-registered'` if the category was not
+registered, or `type: 'rate-limit'` if the host's rate limit for the category is exceeded.
+
+##### Charging issues
+
+Only the app that decided a charger should charge knows that it should be charging, so the app sends
+`charging-issue` notifications. The host relies on these rules and does not re-check them. Send one only when
+**all** of the following hold:
+
+- The app itself asked the charger to charge: it sent a start or resume, or it is giving the charger more than 0 W.
+- The charger has stayed non-charging for at least 5 minutes after that request (status is not `Charging`, or it is
+  `Charging` but draws almost no power).
+- The charger is not `Suspended` with reason `EnyoChargerApplianceSuspendedReasonEnum.Ev`: the car is full or paused
+  charging itself, which is not a fault.
+- No grid-operator limit (§14a / `GridOperatorPowerLimitationV1`) is currently pushing the charger to 0.
+
+Send it **at most once per plug-in**: wait until the charger is `Available` again (car unplugged) before sending
+another one for that appliance. Always pass `applianceId` and the `appliance` target. The host drops more than one
+`charging-issue` per appliance per 30 minutes with a `rate-limit` error.
+
+```typescript
+const notification = energyApp.useNotification();
+
+notification.registerNotificationCategory({
+    category: 'charging-issue',
+    name: [
+        {language: 'de', name: 'Ladeprobleme'},
+        {language: 'en', name: 'Charging issues'},
+    ],
+    description: [
+        {language: 'de', name: 'Ladeprobleme', description: 'Wenn dein Auto nicht lädt, obwohl es laden sollte.'},
+        {language: 'en', name: 'Charging issues', description: 'When your car is not charging although it should.'},
+    ],
 });
+
+notification.sendNotification(
+    'charging-issue',
+    {applianceId, target: {type: 'appliance', applianceId}},
+    [
+        {language: 'de', title: 'Dein Auto lädt nicht', body: 'Die Wallbox sollte gerade laden, tut es aber nicht. Prüfe bitte Auto und Ladekabel.'},
+        {language: 'en', title: 'Your car is not charging', body: 'The wallbox should be charging right now but isn\'t. Please check the car and the charging cable.'},
+    ],
+);
+```
+
+##### Battery issues
+
+`battery-issue` follows the same idea for home batteries. Send one only when **all** of the following hold:
+
+- The app itself commanded the battery (`SetStorageControlV2` with mode `Controlled`, or one of the other storage
+  commands) and that command is still in effect. Never while the battery runs on `Auto`.
+- For at least 5 minutes the battery has not followed it, judged by `batteryPowerW` in `BatteryValuesUpdateV1`:
+  not charging on `Charge`, not discharging on `Discharge`, or moving power noticeably on `Hold`.
+- The battery is not simply at its limit: no charge command at or above `maxSoC` (or 100 %), no discharge command
+  at or below `minSoC`.
+- A discharge to the house is not just capped by low household consumption.
+- No grid-operator limit (§14a) is pushing the battery to 0, and `controlAllowed` is not `false`.
+
+Send it **at most once per issue**: wait until the battery follows a command again, or the app releases it to
+`Auto`, before sending another one. Always pass `applianceId` and the `appliance` target. The host drops more than
+one `battery-issue` per appliance per 30 minutes with a `rate-limit` error.
+
+```typescript
+notification.sendNotification(
+    'battery-issue',
+    {applianceId, target: {type: 'appliance', applianceId}},
+    [
+        {language: 'de', title: 'Dein Speicher reagiert nicht', body: 'Der Batteriespeicher folgt der Steuerung gerade nicht. Prüfe bitte, ob die externe Steuerung am Speicher aktiviert ist.'},
+        {language: 'en', title: 'Your battery is not responding', body: 'The home battery is not following the control right now. Please check that external control is enabled on the battery.'},
+    ],
+);
+```
+
+##### Lost sign-in
+
+`requestAuthentication()` already prompts the user, including for the first sign-in during onboarding.
+`authentication-required` is only for a sign-in that **used to work** and was lost. Send one only when:
+
+- The package was `Authenticated` before, the vendor now rejects the credentials or token, and a refresh failed.
+- The failure is not transient. Timeouts or a vendor outage are a `connection-issue`.
+- The user did not sign out themselves.
+
+Before sending, set the state with `setAuthenticationState()` and create a new request with
+`requestAuthentication()`, so the `authentication` target has a sign-in to open. Send it **at most once per lost
+session**, and not again until the package is `Authenticated` again. The host allows one per package (or per
+appliance, for an appliance sign-in) per 24 hours.
+
+```typescript
+await auth.setAuthenticationState({state: EnyoAuthenticationStateEnum.AuthenticationFailed});
+await auth.requestAuthentication({authenticationType: 'oauth', oauth: {}, oneTimeAuthentication: false});
+
+notification.sendNotification(
+    'authentication-required',
+    {target: {type: 'authentication'}},
+    [
+        {language: 'de', title: 'Bitte erneut anmelden', body: 'Deine Anmeldung ist abgelaufen. Melde dich erneut an, damit wir deine Geräte weiter steuern können.'},
+        {language: 'en', title: 'Please sign in again', body: 'Your sign-in has expired. Sign in again so we can keep controlling your devices.'},
+    ],
+);
 ```
 
 ### App Intelligence

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApplianceManager = exports.ApplianceManagerDisposedError = exports.DuplicateIdentifierError = exports.MissingIdentifierError = void 0;
+exports.ApplianceManager = exports.ApplianceGroupNotFoundError = exports.ApplianceManagerDisposedError = exports.DuplicateIdentifierError = exports.MissingIdentifierError = void 0;
 const index_js_1 = require("../../index.cjs");
 const enyo_appliance_js_1 = require("../../types/enyo-appliance.cjs");
 /**
@@ -49,6 +49,20 @@ class ApplianceManagerDisposedError extends Error {
     }
 }
 exports.ApplianceManagerDisposedError = ApplianceManagerDisposedError;
+/**
+ * Thrown by the {@link ApplianceManager} group helpers when no group with the
+ * given key exists in the package.
+ */
+class ApplianceGroupNotFoundError extends Error {
+    /** The group key that was looked up */
+    key;
+    constructor(key) {
+        super(`No appliance group with key "${key}" exists.`);
+        this.name = 'ApplianceGroupNotFoundError';
+        this.key = key;
+    }
+}
+exports.ApplianceGroupNotFoundError = ApplianceGroupNotFoundError;
 /** Sub-objects on EnyoAppliance that {@link ApplianceManager} shallow-merges during updates. */
 const MERGEABLE_METADATA_KEYS = [
     'metadata',
@@ -220,6 +234,7 @@ class ApplianceManager {
             ...(appliance.cloudPackageId !== undefined && { cloudPackageId: appliance.cloudPackageId }),
             ...(appliance.availableFeatures !== undefined && { availableFeatures: appliance.availableFeatures }),
             ...(appliance.compatibilityModes !== undefined && { compatibilityModes: appliance.compatibilityModes }),
+            ...(appliance.hidden !== undefined && { hidden: appliance.hidden }),
         };
         let applianceData = newApplianceData;
         if (existingApplianceId) {
@@ -741,6 +756,170 @@ class ApplianceManager {
             }
         }
     }
+    /**
+     * Creates the group with the given {@link ApplianceGroupConfig.key}, or
+     * updates it when it already exists. The group is shown in the UI as one
+     * collapsible entry with the summed values of its members.
+     *
+     * An appliance belongs to at most one group, so members currently listed
+     * in another group of the package are taken out of it first; a group left
+     * empty by that is removed.
+     *
+     * @param config The group's key, name and member appliance IDs
+     * @returns The ID of the saved group
+     * @throws {Error} when `config.applianceIds` is empty
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async createOrUpdateGroup(config) {
+        this.throwIfDisposed();
+        const applianceIds = [...new Set(config.applianceIds)];
+        if (applianceIds.length === 0) {
+            throw new Error(`Appliance group "${config.key}" needs at least one appliance; use removeGroup to drop it.`);
+        }
+        const groups = await this.loadGroups();
+        const existing = groups.find(g => g.key === config.key);
+        // Take the members out of every other group before saving, otherwise
+        // the host rejects the save for an appliance being in two groups.
+        const members = new Set(applianceIds);
+        for (const other of groups) {
+            if (other === existing || !other.applianceIds.some(id => members.has(id)))
+                continue;
+            const remaining = other.applianceIds.filter(id => !members.has(id));
+            if (remaining.length === 0) {
+                await this.deleteGroup(other.id);
+            }
+            else {
+                await this.persistGroup({ ...this.withoutId(other), applianceIds: remaining }, other.id);
+            }
+        }
+        return this.persistGroup({ key: config.key, name: config.name, applianceIds }, existing?.id);
+    }
+    /**
+     * Returns all appliance groups of the package.
+     *
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async getGroups() {
+        this.throwIfDisposed();
+        return this.loadGroups();
+    }
+    /**
+     * Returns the group with the given key, or `null` when there is none.
+     *
+     * @param key The app-defined group key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async findGroupByKey(key) {
+        this.throwIfDisposed();
+        return (await this.loadGroups()).find(g => g.key === key) ?? null;
+    }
+    /**
+     * Returns the group an appliance belongs to, or `null` when it is not
+     * grouped.
+     *
+     * @param applianceId The appliance to look up
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async findGroupOfAppliance(applianceId) {
+        this.throwIfDisposed();
+        return (await this.loadGroups()).find(g => g.applianceIds.includes(applianceId)) ?? null;
+    }
+    /**
+     * Adds an appliance to the end of an existing group, moving it out of any
+     * other group it was in. Does nothing when it is already a member.
+     *
+     * @param key The key of the group to add the appliance to
+     * @param applianceId The appliance to add
+     * @returns The ID of the group
+     * @throws {ApplianceGroupNotFoundError} when no group has the given key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async addApplianceToGroup(key, applianceId) {
+        this.throwIfDisposed();
+        const group = await this.findGroupByKey(key);
+        if (!group) {
+            throw new ApplianceGroupNotFoundError(key);
+        }
+        if (group.applianceIds.includes(applianceId)) {
+            return group.id;
+        }
+        return this.createOrUpdateGroup({
+            key,
+            name: group.name,
+            applianceIds: [...group.applianceIds, applianceId],
+        });
+    }
+    /**
+     * Takes an appliance out of its group, so the UI shows it individually
+     * again. A group left without members is removed.
+     *
+     * @param applianceId The appliance to take out of its group
+     * @returns `true` when the appliance was in a group, `false` otherwise
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async removeApplianceFromGroup(applianceId) {
+        this.throwIfDisposed();
+        const group = await this.findGroupOfAppliance(applianceId);
+        if (!group) {
+            return false;
+        }
+        const remaining = group.applianceIds.filter(id => id !== applianceId);
+        if (remaining.length === 0) {
+            await this.deleteGroup(group.id);
+        }
+        else {
+            await this.persistGroup({ ...this.withoutId(group), applianceIds: remaining }, group.id);
+        }
+        return true;
+    }
+    /**
+     * Removes the group with the given key. Its members stay and are shown
+     * individually again.
+     *
+     * @param key The key of the group to remove
+     * @returns `true` when a group was removed, `false` when none had the key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    async removeGroup(key) {
+        this.throwIfDisposed();
+        const group = await this.findGroupByKey(key);
+        if (!group) {
+            return false;
+        }
+        await this.deleteGroup(group.id);
+        return true;
+    }
+    /**
+     * Loads the package's appliance groups from storage. `protected` so
+     * subclasses (e.g. {@link InMemoryApplianceManager}) can swap the storage
+     * the group helpers run on.
+     */
+    async loadGroups() {
+        return this.energyApp.useAppliances().listGroups();
+    }
+    /**
+     * Saves an appliance group to storage.
+     *
+     * @param group The group to save
+     * @param groupId ID of the group to update, or `undefined` to create one
+     * @returns The ID of the saved group
+     */
+    async persistGroup(group, groupId) {
+        return this.energyApp.useAppliances().saveGroup(group, groupId);
+    }
+    /**
+     * Deletes an appliance group from storage.
+     *
+     * @param groupId ID of the group to delete
+     */
+    async deleteGroup(groupId) {
+        await this.energyApp.useAppliances().removeGroup(groupId);
+    }
+    /** Returns a copy of the group without its `id`, ready to be saved again. */
+    withoutId(group) {
+        const { id: _id, ...rest } = group;
+        return rest;
+    }
     /**
      * Gets the current identifier strategy.
      */

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

@@ -1,6 +1,6 @@
 import { EnergyApp } from "../../index.cjs";
 import type { EnyoNetworkDevice } from "../../types/enyo-network-device.cjs";
-import { EnyoAppliance, EnyoApplianceAvailableFeaturesEnum, EnyoApplianceConnectionType, EnyoApplianceMetadata, EnyoApplianceName, EnyoApplianceStateEnum, EnyoApplianceTopology, EnyoApplianceTypeEnum } from "../../types/enyo-appliance.cjs";
+import { EnyoAppliance, EnyoApplianceAvailableFeaturesEnum, EnyoApplianceConnectionType, EnyoApplianceGroup, EnyoApplianceMetadata, EnyoApplianceName, EnyoApplianceStateEnum, EnyoApplianceTopology, EnyoApplianceTypeEnum } from "../../types/enyo-appliance.cjs";
 import type { EnyoApplianceCreatedFilter } from "../../packages/energy-app-appliance.cjs";
 import type { EnyoChargerApplianceMetadata } from "../../types/enyo-charger-appliance.cjs";
 import type { EnyoHeatpumpApplianceDomesticHotWater, EnyoHeatpumpApplianceHeatingCircuit, EnyoHeatpumpApplianceMetadata } from "../../types/enyo-heatpump-appliance.cjs";
@@ -40,6 +40,36 @@ export declare class DuplicateIdentifierError extends Error {
 export declare class ApplianceManagerDisposedError extends Error {
     constructor();
 }
+/**
+ * Thrown by the {@link ApplianceManager} group helpers when no group with the
+ * given key exists in the package.
+ */
+export declare class ApplianceGroupNotFoundError extends Error {
+    /** The group key that was looked up */
+    readonly key: string;
+    constructor(key: string);
+}
+/**
+ * Configuration for creating or updating an appliance group via
+ * {@link ApplianceManager.createOrUpdateGroup}. See {@link EnyoApplianceGroup}
+ * for what a group is and how the UI shows it.
+ */
+export interface ApplianceGroupConfig {
+    /**
+     * Stable, app-defined key identifying the group within the package — e.g.
+     * the serial number of the gateway the members sit behind. A group with
+     * this key is updated in place; otherwise a new one is created.
+     */
+    key: string;
+    /** Name of the group shown in the UI, in the supported languages */
+    name: EnyoApplianceName[];
+    /**
+     * IDs of the member appliances (your package's own), in display order.
+     * Must not be empty — use {@link ApplianceManager.removeGroup} to drop a
+     * group. Appliances currently in another group are moved into this one.
+     */
+    applianceIds: string[];
+}
 /**
  * Configuration for creating or updating an appliance.
  */
@@ -78,6 +108,12 @@ export interface ApplianceConfig {
      * appliance is created or updated.
      */
     cloudPackageId?: string;
+    /**
+     * Whether the appliance is hidden. Forwarded to {@link EnyoAppliance.hidden}
+     * when the appliance is created or updated. Omit to keep the stored value on
+     * an update; pass `false` to unhide it.
+     */
+    hidden?: boolean;
 }
 /**
  * Configuration options for the ApplianceManager.
@@ -434,6 +470,93 @@ export declare class ApplianceManager {
      * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
      */
     setIdentifierStrategy(strategy: IdentifierStrategy, rebuildCache: boolean): Promise<void>;
+    /**
+     * Creates the group with the given {@link ApplianceGroupConfig.key}, or
+     * updates it when it already exists. The group is shown in the UI as one
+     * collapsible entry with the summed values of its members.
+     *
+     * An appliance belongs to at most one group, so members currently listed
+     * in another group of the package are taken out of it first; a group left
+     * empty by that is removed.
+     *
+     * @param config The group's key, name and member appliance IDs
+     * @returns The ID of the saved group
+     * @throws {Error} when `config.applianceIds` is empty
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    createOrUpdateGroup(config: ApplianceGroupConfig): Promise<string>;
+    /**
+     * Returns all appliance groups of the package.
+     *
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    getGroups(): Promise<EnyoApplianceGroup[]>;
+    /**
+     * Returns the group with the given key, or `null` when there is none.
+     *
+     * @param key The app-defined group key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    findGroupByKey(key: string): Promise<EnyoApplianceGroup | null>;
+    /**
+     * Returns the group an appliance belongs to, or `null` when it is not
+     * grouped.
+     *
+     * @param applianceId The appliance to look up
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    findGroupOfAppliance(applianceId: string): Promise<EnyoApplianceGroup | null>;
+    /**
+     * Adds an appliance to the end of an existing group, moving it out of any
+     * other group it was in. Does nothing when it is already a member.
+     *
+     * @param key The key of the group to add the appliance to
+     * @param applianceId The appliance to add
+     * @returns The ID of the group
+     * @throws {ApplianceGroupNotFoundError} when no group has the given key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    addApplianceToGroup(key: string, applianceId: string): Promise<string>;
+    /**
+     * Takes an appliance out of its group, so the UI shows it individually
+     * again. A group left without members is removed.
+     *
+     * @param applianceId The appliance to take out of its group
+     * @returns `true` when the appliance was in a group, `false` otherwise
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    removeApplianceFromGroup(applianceId: string): Promise<boolean>;
+    /**
+     * Removes the group with the given key. Its members stay and are shown
+     * individually again.
+     *
+     * @param key The key of the group to remove
+     * @returns `true` when a group was removed, `false` when none had the key
+     * @throws {ApplianceManagerDisposedError} when called after {@link dispose}
+     */
+    removeGroup(key: string): Promise<boolean>;
+    /**
+     * Loads the package's appliance groups from storage. `protected` so
+     * subclasses (e.g. {@link InMemoryApplianceManager}) can swap the storage
+     * the group helpers run on.
+     */
+    protected loadGroups(): Promise<EnyoApplianceGroup[]>;
+    /**
+     * Saves an appliance group to storage.
+     *
+     * @param group The group to save
+     * @param groupId ID of the group to update, or `undefined` to create one
+     * @returns The ID of the saved group
+     */
+    protected persistGroup(group: Omit<EnyoApplianceGroup, 'id'>, groupId: string | undefined): Promise<string>;
+    /**
+     * Deletes an appliance group from storage.
+     *
+     * @param groupId ID of the group to delete
+     */
+    protected deleteGroup(groupId: string): Promise<void>;
+    /** Returns a copy of the group without its `id`, ready to be saved again. */
+    private withoutId;
     /**
      * Gets the current identifier strategy.
      */
@@ -495,5 +618,6 @@ export interface PartialEnyoAppliance {
      * Optional identifier of the cloud-deployed energy app package that manages
      * this appliance. Mirrors {@link EnyoAppliance.cloudPackageId}.
      */
-    cloudPackageId?: string;
+    cloudPackageId?: string; /** Whether the appliance is hidden. Mirrors {@link EnyoAppliance.hidden}. */
+    hidden?: boolean;
 }

package/dist/cjs/implementations/appliances/in-memory-appliance-manager.cjs

@@ -13,6 +13,7 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
     memoryStore = new Map();
     nextId = 1;
     networkDevicesStore = new Map();
+    groupStore = new Map();
     /**
      * Creates a new DemoApplianceManager instance.
      * @param energyApp The EnergyApp instance (not used for persistence in demo)
@@ -75,6 +76,7 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
             ...(appliance.cloudPackageId !== undefined && { cloudPackageId: appliance.cloudPackageId }),
             ...(appliance.availableFeatures !== undefined && { availableFeatures: appliance.availableFeatures }),
             ...(appliance.compatibilityModes !== undefined && { compatibilityModes: appliance.compatibilityModes }),
+            ...(appliance.hidden !== undefined && { hidden: appliance.hidden }),
         };
         // On update, merge onto the stored appliance so type-specific metadata and
         // top-level fields that were not supplied in this call are preserved.
@@ -212,6 +214,19 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
         if (this.memoryStore.has(applianceId)) {
             this.memoryStore.delete(applianceId);
             this.networkDevicesStore.delete(applianceId);
+            // Mirror the host: a removed appliance drops out of its group,
+            // and a group left without members is removed.
+            for (const group of [...this.groupStore.values()]) {
+                if (!group.applianceIds.includes(applianceId))
+                    continue;
+                const remaining = group.applianceIds.filter(id => id !== applianceId);
+                if (remaining.length === 0) {
+                    this.groupStore.delete(group.id);
+                }
+                else {
+                    this.groupStore.set(group.id, { ...group, applianceIds: remaining });
+                }
+            }
             // Clean up cache (from parent class)
             this.clearCache();
             console.log(`[DEMO] Removed appliance ${applianceId}`);
@@ -287,12 +302,38 @@ class InMemoryApplianceManager extends appliance_manager_js_1.ApplianceManager {
             this.updateCache(appliance);
         }
     }
+    /**
+     * Loads the appliance groups from memory.
+     * @returns Copies of all stored groups
+     */
+    async loadGroups() {
+        return Array.from(this.groupStore.values(), g => structuredClone(g));
+    }
+    /**
+     * Saves an appliance group in memory.
+     * @param group The group to save
+     * @param groupId ID of the group to update, or `undefined` to create one
+     * @returns The ID of the saved group
+     */
+    async persistGroup(group, groupId) {
+        const id = groupId ?? (0, node_crypto_1.randomUUID)();
+        this.groupStore.set(id, { ...structuredClone(group), id });
+        return id;
+    }
+    /**
+     * Deletes an appliance group from memory.
+     * @param groupId ID of the group to delete
+     */
+    async deleteGroup(groupId) {
+        this.groupStore.delete(groupId);
+    }
     /**
      * Clears all data from memory (for testing purposes).
      */
     clearAllData() {
         this.memoryStore.clear();
         this.networkDevicesStore.clear();
+        this.groupStore.clear();
         this.clearCache();
         this.nextId = 1;
         console.log('[DEMO] All data cleared from memory');

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

@@ -1,5 +1,5 @@
 import type { EnergyApp } from "../../index.cjs";
-import { EnyoAppliance, EnyoApplianceConnectionType, EnyoApplianceMetadata, EnyoApplianceStateEnum, EnyoApplianceTypeEnum } from "../../types/enyo-appliance.cjs";
+import { EnyoAppliance, EnyoApplianceConnectionType, EnyoApplianceGroup, EnyoApplianceMetadata, EnyoApplianceStateEnum, EnyoApplianceTypeEnum } from "../../types/enyo-appliance.cjs";
 import { ApplianceConfig, ApplianceManager, ApplianceManagerConfig, FindResult } from "./appliance-manager.cjs";
 import { IdentifierStrategy } from "./identifier-strategies.cjs";
 /**
@@ -11,6 +11,7 @@ export declare class InMemoryApplianceManager extends ApplianceManager {
     private memoryStore;
     private nextId;
     private networkDevicesStore;
+    private groupStore;
     /**
      * Creates a new DemoApplianceManager instance.
      * @param energyApp The EnergyApp instance (not used for persistence in demo)
@@ -99,6 +100,23 @@ export declare class InMemoryApplianceManager extends ApplianceManager {
      * Refreshes the cache with all appliances from memory.
      */
     refreshCache(): Promise<void>;
+    /**
+     * Loads the appliance groups from memory.
+     * @returns Copies of all stored groups
+     */
+    protected loadGroups(): Promise<EnyoApplianceGroup[]>;
+    /**
+     * Saves an appliance group in memory.
+     * @param group The group to save
+     * @param groupId ID of the group to update, or `undefined` to create one
+     * @returns The ID of the saved group
+     */
+    protected persistGroup(group: Omit<EnyoApplianceGroup, 'id'>, groupId: string | undefined): Promise<string>;
+    /**
+     * Deletes an appliance group from memory.
+     * @param groupId ID of the group to delete
+     */
+    protected deleteGroup(groupId: string): Promise<void>;
     /**
      * Clears all data from memory (for testing purposes).
      */