@enyo-energy/energy-app-sdk 0.0.105 → 0.0.106

package/dist/cjs/energy-app-appliance-type.enum.cjs

@@ -19,4 +19,5 @@ var EnergyAppApplianceTypeEnum;
     EnergyAppApplianceTypeEnum["Dryer"] = "dryer";
     EnergyAppApplianceTypeEnum["Oven"] = "oven";
     EnergyAppApplianceTypeEnum["Freezer"] = "freezer";
+    EnergyAppApplianceTypeEnum["AirConditioning"] = "air-conditioning";
 })(EnergyAppApplianceTypeEnum || (exports.EnergyAppApplianceTypeEnum = EnergyAppApplianceTypeEnum = {}));

package/dist/cjs/energy-app-appliance-type.enum.d.cts

@@ -14,5 +14,6 @@ export declare enum EnergyAppApplianceTypeEnum {
     Fridge = "fridge",
     Dryer = "dryer",
     Oven = "oven",
-    Freezer = "freezer"
+    Freezer = "freezer",
+    AirConditioning = "air-conditioning"
 }

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

@@ -17,7 +17,7 @@ class ApplianceManager {
     /**
      * Merges partial appliance data with an existing appliance, performing a shallow merge
      * on each metadata sub-object (metadata, inverter, charger, battery, heatpump, meter,
-     * temperatureSensor) so that only the provided keys are overwritten and existing keys
+     * temperatureSensor, airConditioning) so that only the provided keys are overwritten and existing keys
      * are preserved.
      * @param existing The existing appliance data
      * @param update The partial update data to merge
@@ -48,6 +48,9 @@ class ApplianceManager {
             temperatureSensor: update.temperatureSensor
                 ? { ...existing.temperatureSensor, ...update.temperatureSensor }
                 : existing.temperatureSensor,
+            airConditioning: update.airConditioning
+                ? { ...existing.airConditioning, ...update.airConditioning }
+                : existing.airConditioning,
         };
     }
     /**
@@ -123,6 +126,7 @@ class ApplianceManager {
             charger: appliance.charger,
             inverter: appliance.inverter,
             temperatureSensor: appliance.temperatureSensor,
+            airConditioning: appliance.airConditioning,
         };
         // When updating an existing appliance, merge metadata to preserve existing keys
         let applianceData = newApplianceData;

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

@@ -7,6 +7,7 @@ import type { EnyoBatteryApplianceMetadata } from "../../types/enyo-battery-appl
 import type { EnyoInverterApplianceMetadata } from "../../types/enyo-inverter-appliance.cjs";
 import type { EnyoMeterAppliance } from "../../types/enyo-meter-appliance.cjs";
 import type { EnyoTemperatureSensorApplianceMetadata } from "../../types/enyo-temperature-sensor-appliance.cjs";
+import type { EnyoAirConditioningApplianceMetadata } from "../../types/enyo-air-conditioning-appliance.cjs";
 import { IdentifierStrategy } from "./identifier-strategies.cjs";
 /**
  * Configuration for creating or updating an appliance.
@@ -29,6 +30,7 @@ export interface ApplianceConfig {
     heatpump?: EnyoHeatpumpApplianceMetadata;
     battery?: EnyoBatteryApplianceMetadata;
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
+    airConditioning?: EnyoAirConditioningApplianceMetadata;
 }
 /**
  * Configuration options for the ApplianceManager.
@@ -70,7 +72,7 @@ export declare class ApplianceManager {
     /**
      * Merges partial appliance data with an existing appliance, performing a shallow merge
      * on each metadata sub-object (metadata, inverter, charger, battery, heatpump, meter,
-     * temperatureSensor) so that only the provided keys are overwritten and existing keys
+     * temperatureSensor, airConditioning) so that only the provided keys are overwritten and existing keys
      * are preserved.
      * @param existing The existing appliance data
      * @param update The partial update data to merge
@@ -243,6 +245,8 @@ export interface PartialEnyoAppliance {
     battery?: Partial<EnyoBatteryApplianceMetadata>;
     /** Optional Metadata of the Appliance if of type TemperatureSensor */
     temperatureSensor?: Partial<EnyoTemperatureSensorApplianceMetadata>;
+    /** Optional Metadata of the Appliance if of type AirConditioning */
+    airConditioning?: Partial<EnyoAirConditioningApplianceMetadata>;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
 }

package/dist/cjs/index.cjs

@@ -56,6 +56,7 @@ __exportStar(require("./types/enyo-diagnostics.cjs"), exports);
 __exportStar(require("./packages/energy-app-diagnostics.cjs"), exports);
 __exportStar(require("./types/enyo-learning-phase.cjs"), exports);
 __exportStar(require("./packages/energy-app-learning-phase.cjs"), exports);
+__exportStar(require("./types/enyo-air-conditioning-appliance.cjs"), exports);
 class EnergyApp {
     energyAppSdk;
     constructor() {

package/dist/cjs/index.d.cts

@@ -69,6 +69,7 @@ export * from './types/enyo-diagnostics.cjs';
 export * from './packages/energy-app-diagnostics.cjs';
 export * from './types/enyo-learning-phase.cjs';
 export * from './packages/energy-app-learning-phase.cjs';
+export * from './types/enyo-air-conditioning-appliance.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();

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

@@ -1,4 +1,4 @@
-import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse, HeatpumpTemperatureTimeseriesRequest, HeatpumpTemperatureTimeseriesResponse, TemperatureSensorTimeseriesRequest, TemperatureSensorTimeseriesResponse } from "../types/enyo-timeseries.cjs";
+import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse, HeatpumpTemperatureTimeseriesRequest, HeatpumpTemperatureTimeseriesResponse, TemperatureSensorTimeseriesRequest, TemperatureSensorTimeseriesResponse, AirConditioningPowerTimeseriesRequest, AirConditioningPowerTimeseriesResponse, AirConditioningTemperatureTimeseriesRequest, AirConditioningTemperatureTimeseriesResponse } from "../types/enyo-timeseries.cjs";
 /**
  * Interface for querying historical energy data with configurable bucket granularity.
  * Provides methods to retrieve aggregated timeseries data for various energy metrics
@@ -179,4 +179,43 @@ export interface EnergyAppTimeseries {
      * ```
      */
     getTemperatureSensorTimeseries(request: TemperatureSensorTimeseriesRequest): Promise<TemperatureSensorTimeseriesResponse>;
+    /**
+     * Retrieves air conditioning power timeseries data aggregated in time buckets.
+     * Returns both instantaneous power (W) and cumulative energy (Wh) values
+     * for air conditioning appliances.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to air conditioning power entries with total consumption
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getAirConditioningPowerTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Total AC consumption: ${response.totalAirConditioningPowerWh} Wh`);
+     * ```
+     */
+    getAirConditioningPowerTimeseries(request: AirConditioningPowerTimeseriesRequest): Promise<AirConditioningPowerTimeseriesResponse>;
+    /**
+     * Retrieves air conditioning temperature timeseries data aggregated in time buckets.
+     * Returns per-room average, min, max, and delta temperature readings for each bucket.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to air conditioning temperature entries with per-room readings
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getAirConditioningTemperatureTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * response.entries.forEach(entry => {
+     *     entry.rooms?.forEach(room => {
+     *         console.log(`Room ${room.index}: ${room.averageTemperatureC} °C`);
+     *     });
+     * });
+     * ```
+     */
+    getAirConditioningTemperatureTimeseries(request: AirConditioningTemperatureTimeseriesRequest): Promise<AirConditioningTemperatureTimeseriesResponse>;
 }

package/dist/cjs/types/enyo-air-conditioning-appliance.cjs

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnyoAirConditioningApplianceModeEnum = exports.EnyoAirConditioningApplianceAvailableFeaturesEnum = void 0;
+/**
+ * Available features for an air conditioning appliance.
+ */
+var EnyoAirConditioningApplianceAvailableFeaturesEnum;
+(function (EnyoAirConditioningApplianceAvailableFeaturesEnum) {
+    /** If the air conditioning unit supports cooling */
+    EnyoAirConditioningApplianceAvailableFeaturesEnum["Cooling"] = "Cooling";
+    /** If the air conditioning unit supports heating */
+    EnyoAirConditioningApplianceAvailableFeaturesEnum["Heating"] = "Heating";
+})(EnyoAirConditioningApplianceAvailableFeaturesEnum || (exports.EnyoAirConditioningApplianceAvailableFeaturesEnum = EnyoAirConditioningApplianceAvailableFeaturesEnum = {}));
+/**
+ * Operating modes for an air conditioning appliance.
+ */
+var EnyoAirConditioningApplianceModeEnum;
+(function (EnyoAirConditioningApplianceModeEnum) {
+    /** The air conditioning unit is idle */
+    EnyoAirConditioningApplianceModeEnum["Idle"] = "Idle";
+    /** The air conditioning unit is actively cooling */
+    EnyoAirConditioningApplianceModeEnum["Cooling"] = "Cooling";
+    /** The air conditioning unit is actively heating */
+    EnyoAirConditioningApplianceModeEnum["Heating"] = "Heating";
+})(EnyoAirConditioningApplianceModeEnum || (exports.EnyoAirConditioningApplianceModeEnum = EnyoAirConditioningApplianceModeEnum = {}));

package/dist/cjs/types/enyo-air-conditioning-appliance.d.cts

@@ -0,0 +1,42 @@
+/**
+ * Available features for an air conditioning appliance.
+ */
+export declare enum EnyoAirConditioningApplianceAvailableFeaturesEnum {
+    /** If the air conditioning unit supports cooling */
+    Cooling = "Cooling",
+    /** If the air conditioning unit supports heating */
+    Heating = "Heating"
+}
+/**
+ * Operating modes for an air conditioning appliance.
+ */
+export declare enum EnyoAirConditioningApplianceModeEnum {
+    /** The air conditioning unit is idle */
+    Idle = "Idle",
+    /** The air conditioning unit is actively cooling */
+    Cooling = "Cooling",
+    /** The air conditioning unit is actively heating */
+    Heating = "Heating"
+}
+/**
+ * A room associated with an air conditioning appliance.
+ * Each room has a unique index and an optional custom name.
+ */
+export interface EnyoAirConditioningApplianceRoom {
+    /** Zero-based index identifying the room */
+    index: number;
+    /** Optional custom name for the room (e.g. "Living Room", "Bedroom") */
+    customName?: string;
+}
+/**
+ * Type-specific metadata for an air conditioning appliance.
+ * Contains available features, current operating mode, and configured rooms.
+ */
+export interface EnyoAirConditioningApplianceMetadata {
+    /** List of features supported by this air conditioning unit */
+    availableFeatures: EnyoAirConditioningApplianceAvailableFeaturesEnum[];
+    /** Current operating mode of the air conditioning unit */
+    mode?: EnyoAirConditioningApplianceModeEnum;
+    /** Rooms served by this air conditioning unit (0 to n) */
+    rooms?: EnyoAirConditioningApplianceRoom[];
+}

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

@@ -5,6 +5,7 @@ import { EnyoBatteryApplianceMetadata } from "./enyo-battery-appliance.cjs";
 import { EnyoInverterApplianceMetadata } from "./enyo-inverter-appliance.cjs";
 import { EnyoMeterAppliance } from "./enyo-meter-appliance.cjs";
 import { EnyoTemperatureSensorApplianceMetadata } from "./enyo-temperature-sensor-appliance.cjs";
+import { EnyoAirConditioningApplianceMetadata } from "./enyo-air-conditioning-appliance.cjs";
 export declare enum EnyoApplianceTypeEnum {
     Inverter = "Inverter",
     Charger = "Charger",
@@ -102,6 +103,8 @@ export interface EnyoAppliance {
     battery?: EnyoBatteryApplianceMetadata;
     /** Optional Metadata of the Appliance if of type TemperatureSensor */
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
+    /** Optional Metadata of the Appliance if of type AirConditioning */
+    airConditioning?: EnyoAirConditioningApplianceMetadata;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
 }

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

@@ -152,6 +152,10 @@ var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["ClearChargingProfilesV1"] = "ClearChargingProfilesV1";
     EnyoDataBusMessageEnum["HeatpumpOverheatingV1"] = "HeatpumpOverheatingV1";
     EnyoDataBusMessageEnum["HeatpumpAvailablePowerAnnouncementV1"] = "HeatpumpAvailablePowerAnnouncementV1";
+    EnyoDataBusMessageEnum["AirConditioningValuesUpdateV1"] = "AirConditioningValuesUpdateV1";
+    EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
+    EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
+    EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
 })(EnyoDataBusMessageEnum || (exports.EnyoDataBusMessageEnum = EnyoDataBusMessageEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

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

@@ -6,6 +6,7 @@ import { PreviewChargingSchedule, PreviewChargingScheduleCostComparison, Preview
 import { EnyoEnergyPrices } from "./enyo-energy-prices.cjs";
 import { EnyoCurrencyEnum } from "./enyo-currency.cjs";
 import { EnyoHeatpumpApplianceModeEnum } from "./enyo-heatpump-appliance.cjs";
+import { EnyoAirConditioningApplianceModeEnum } from "./enyo-air-conditioning-appliance.cjs";
 /**
  * Enum representing the reason type for why a data bus command was issued.
  * Used to attach context to commands for logging, debugging, and UI display.
@@ -189,7 +190,11 @@ export declare enum EnyoDataBusMessageEnum {
     RequestChargerLogsV1 = "RequestChargerLogsV1",
     ClearChargingProfilesV1 = "ClearChargingProfilesV1",
     HeatpumpOverheatingV1 = "HeatpumpOverheatingV1",
-    HeatpumpAvailablePowerAnnouncementV1 = "HeatpumpAvailablePowerAnnouncementV1"
+    HeatpumpAvailablePowerAnnouncementV1 = "HeatpumpAvailablePowerAnnouncementV1",
+    AirConditioningValuesUpdateV1 = "AirConditioningValuesUpdateV1",
+    AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
+    StartAirConditioningV1 = "StartAirConditioningV1",
+    StopAirConditioningV1 = "StopAirConditioningV1"
 }
 export type EnyoDataBusMessageResolution = '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 export interface EnyoDataBusMessage {
@@ -1151,3 +1156,76 @@ export interface EnyoDataBusHeatpumpAvailablePowerAnnouncementV1 extends EnyoDat
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Data bus message for reporting air conditioning power values.
+ * Contains the current operating mode and power consumption.
+ */
+export interface EnyoDataBusAirConditioningValuesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.AirConditioningValuesUpdateV1;
+    /** ID of the air conditioning appliance that delivered these values */
+    applianceId: string;
+    data: {
+        values: {
+            /** Current operating mode of the air conditioning unit */
+            operationMode: EnyoAirConditioningApplianceModeEnum;
+            /** Current power consumption in Watts */
+            powerW?: number;
+        };
+    };
+}
+/**
+ * Data bus message for reporting air conditioning temperature values.
+ * Contains per-room temperature readings from an air conditioning appliance.
+ */
+export interface EnyoDataBusAirConditioningTemperaturesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.AirConditioningTemperaturesUpdateV1;
+    /** ID of the air conditioning appliance that delivered these temperature values */
+    applianceId: string;
+    data: {
+        /** Room temperature readings, indexed per room */
+        rooms?: {
+            /** Index of the room */
+            index: number;
+            /** Target temperature in Celsius */
+            targetTemperatureC: number;
+            /** Current temperature in Celsius */
+            temperatureC: number;
+        }[];
+    };
+}
+/**
+ * Command message to start an air conditioning appliance in a specified mode.
+ * This message instructs the air conditioning unit to begin operating in
+ * either heating or cooling mode.
+ */
+export interface EnyoDataBusStartAirConditioningV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StartAirConditioningV1;
+    /** ID of the air conditioning appliance to start */
+    applianceId: string;
+    data: {
+        /** The operating mode to start the air conditioning unit in (Heating or Cooling) */
+        mode: EnyoAirConditioningApplianceModeEnum;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
+/**
+ * Command message to stop an air conditioning appliance.
+ * This message instructs the air conditioning unit to stop operating.
+ * The mode indicates which operating mode (heating or cooling) should be stopped.
+ */
+export interface EnyoDataBusStopAirConditioningV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StopAirConditioningV1;
+    /** ID of the air conditioning appliance to stop */
+    applianceId: string;
+    data: {
+        /** The operating mode to stop (Heating or Cooling) */
+        mode: EnyoAirConditioningApplianceModeEnum;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}

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

@@ -384,3 +384,60 @@ export interface TemperatureSensorTimeseriesResponse extends TimeseriesResponseB
         averageTargetTemperatureC?: number;
     }[];
 }
+/**
+ * A single entry in the air conditioning power timeseries.
+ * Contains power and energy values for a single time bucket.
+ */
+export interface AirConditioningPowerTimeseriesEntry extends TimeseriesEntryBase {
+    /** Time-weighted average air conditioning power consumption in Watts for this bucket */
+    airConditioningPowerW: number;
+    /** Cumulative air conditioning energy consumption in Watt-hours for this bucket */
+    airConditioningPowerWh: number;
+}
+/**
+ * Request parameters for querying air conditioning power timeseries data.
+ */
+export interface AirConditioningPowerTimeseriesRequest extends TimeseriesRequestBase {
+}
+/**
+ * Response containing air conditioning power timeseries data.
+ */
+export interface AirConditioningPowerTimeseriesResponse extends TimeseriesResponseBase {
+    /** Array of air conditioning power entries, one per time bucket */
+    entries: AirConditioningPowerTimeseriesEntry[];
+    /** Total air conditioning energy consumption in Watt-hours across all buckets */
+    totalAirConditioningPowerWh: number;
+}
+/**
+ * A single entry in the air conditioning temperature timeseries.
+ * Contains per-room temperature readings for a single time bucket.
+ */
+export interface AirConditioningTemperatureTimeseriesEntry extends TimeseriesEntryBase {
+    /** Room temperature readings, indexed per room */
+    rooms?: {
+        /** Zero-based index identifying the room */
+        index: number;
+        /** Average temperature in degrees Celsius for this bucket */
+        averageTemperatureC: number;
+        /** Minimum temperature in degrees Celsius observed in this bucket */
+        minTemperatureC: number;
+        /** Maximum temperature in degrees Celsius observed in this bucket */
+        maxTemperatureC: number;
+        /** Temperature difference (delta) in Kelvin for this bucket */
+        deltaK: number;
+        /** Average target temperature in degrees Celsius for this bucket */
+        averageTargetTemperatureC: number;
+    }[];
+}
+/**
+ * Request parameters for querying air conditioning temperature timeseries data.
+ */
+export interface AirConditioningTemperatureTimeseriesRequest extends TimeseriesRequestBase {
+}
+/**
+ * Response containing air conditioning temperature timeseries data.
+ */
+export interface AirConditioningTemperatureTimeseriesResponse extends TimeseriesResponseBase {
+    /** Array of air conditioning temperature entries, one per time bucket */
+    entries: AirConditioningTemperatureTimeseriesEntry[];
+}

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

package/dist/energy-app-appliance-type.enum.d.ts

@@ -14,5 +14,6 @@ export declare enum EnergyAppApplianceTypeEnum {
     Fridge = "fridge",
     Dryer = "dryer",
     Oven = "oven",
-    Freezer = "freezer"
+    Freezer = "freezer",
+    AirConditioning = "air-conditioning"
 }

package/dist/energy-app-appliance-type.enum.js

@@ -16,4 +16,5 @@ export var EnergyAppApplianceTypeEnum;
     EnergyAppApplianceTypeEnum["Dryer"] = "dryer";
     EnergyAppApplianceTypeEnum["Oven"] = "oven";
     EnergyAppApplianceTypeEnum["Freezer"] = "freezer";
+    EnergyAppApplianceTypeEnum["AirConditioning"] = "air-conditioning";
 })(EnergyAppApplianceTypeEnum || (EnergyAppApplianceTypeEnum = {}));

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

@@ -7,6 +7,7 @@ import type { EnyoBatteryApplianceMetadata } from "../../types/enyo-battery-appl
 import type { EnyoInverterApplianceMetadata } from "../../types/enyo-inverter-appliance.js";
 import type { EnyoMeterAppliance } from "../../types/enyo-meter-appliance.js";
 import type { EnyoTemperatureSensorApplianceMetadata } from "../../types/enyo-temperature-sensor-appliance.js";
+import type { EnyoAirConditioningApplianceMetadata } from "../../types/enyo-air-conditioning-appliance.js";
 import { IdentifierStrategy } from "./identifier-strategies.js";
 /**
  * Configuration for creating or updating an appliance.
@@ -29,6 +30,7 @@ export interface ApplianceConfig {
     heatpump?: EnyoHeatpumpApplianceMetadata;
     battery?: EnyoBatteryApplianceMetadata;
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
+    airConditioning?: EnyoAirConditioningApplianceMetadata;
 }
 /**
  * Configuration options for the ApplianceManager.
@@ -70,7 +72,7 @@ export declare class ApplianceManager {
     /**
      * Merges partial appliance data with an existing appliance, performing a shallow merge
      * on each metadata sub-object (metadata, inverter, charger, battery, heatpump, meter,
-     * temperatureSensor) so that only the provided keys are overwritten and existing keys
+     * temperatureSensor, airConditioning) so that only the provided keys are overwritten and existing keys
      * are preserved.
      * @param existing The existing appliance data
      * @param update The partial update data to merge
@@ -243,6 +245,8 @@ export interface PartialEnyoAppliance {
     battery?: Partial<EnyoBatteryApplianceMetadata>;
     /** Optional Metadata of the Appliance if of type TemperatureSensor */
     temperatureSensor?: Partial<EnyoTemperatureSensorApplianceMetadata>;
+    /** Optional Metadata of the Appliance if of type AirConditioning */
+    airConditioning?: Partial<EnyoAirConditioningApplianceMetadata>;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
 }

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

@@ -14,7 +14,7 @@ export class ApplianceManager {
     /**
      * Merges partial appliance data with an existing appliance, performing a shallow merge
      * on each metadata sub-object (metadata, inverter, charger, battery, heatpump, meter,
-     * temperatureSensor) so that only the provided keys are overwritten and existing keys
+     * temperatureSensor, airConditioning) so that only the provided keys are overwritten and existing keys
      * are preserved.
      * @param existing The existing appliance data
      * @param update The partial update data to merge
@@ -45,6 +45,9 @@ export class ApplianceManager {
             temperatureSensor: update.temperatureSensor
                 ? { ...existing.temperatureSensor, ...update.temperatureSensor }
                 : existing.temperatureSensor,
+            airConditioning: update.airConditioning
+                ? { ...existing.airConditioning, ...update.airConditioning }
+                : existing.airConditioning,
         };
     }
     /**
@@ -120,6 +123,7 @@ export class ApplianceManager {
             charger: appliance.charger,
             inverter: appliance.inverter,
             temperatureSensor: appliance.temperatureSensor,
+            airConditioning: appliance.airConditioning,
         };
         // When updating an existing appliance, merge metadata to preserve existing keys
         let applianceData = newApplianceData;

package/dist/index.d.ts

@@ -69,6 +69,7 @@ export * from './types/enyo-diagnostics.js';
 export * from './packages/energy-app-diagnostics.js';
 export * from './types/enyo-learning-phase.js';
 export * from './packages/energy-app-learning-phase.js';
+export * from './types/enyo-air-conditioning-appliance.js';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();

package/dist/index.js

@@ -39,6 +39,7 @@ export * from './types/enyo-diagnostics.js';
 export * from './packages/energy-app-diagnostics.js';
 export * from './types/enyo-learning-phase.js';
 export * from './packages/energy-app-learning-phase.js';
+export * from './types/enyo-air-conditioning-appliance.js';
 export class EnergyApp {
     energyAppSdk;
     constructor() {

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

@@ -1,4 +1,4 @@
-import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse, HeatpumpTemperatureTimeseriesRequest, HeatpumpTemperatureTimeseriesResponse, TemperatureSensorTimeseriesRequest, TemperatureSensorTimeseriesResponse } from "../types/enyo-timeseries.js";
+import { DataBusMessageQueryRequest, DataBusMessageQueryResponse, PvProductionTimeseriesRequest, PvProductionTimeseriesResponse, BatterySocTimeseriesRequest, BatterySocTimeseriesResponse, BatteryPowerTimeseriesRequest, BatteryPowerTimeseriesResponse, MeterValuesTimeseriesRequest, MeterValuesTimeseriesResponse, GridPowerTimeseriesRequest, GridPowerTimeseriesResponse, HomeConsumptionTimeseriesRequest, HomeConsumptionTimeseriesResponse, HeatpumpTemperatureTimeseriesRequest, HeatpumpTemperatureTimeseriesResponse, TemperatureSensorTimeseriesRequest, TemperatureSensorTimeseriesResponse, AirConditioningPowerTimeseriesRequest, AirConditioningPowerTimeseriesResponse, AirConditioningTemperatureTimeseriesRequest, AirConditioningTemperatureTimeseriesResponse } from "../types/enyo-timeseries.js";
 /**
  * Interface for querying historical energy data with configurable bucket granularity.
  * Provides methods to retrieve aggregated timeseries data for various energy metrics
@@ -179,4 +179,43 @@ export interface EnergyAppTimeseries {
      * ```
      */
     getTemperatureSensorTimeseries(request: TemperatureSensorTimeseriesRequest): Promise<TemperatureSensorTimeseriesResponse>;
+    /**
+     * Retrieves air conditioning power timeseries data aggregated in time buckets.
+     * Returns both instantaneous power (W) and cumulative energy (Wh) values
+     * for air conditioning appliances.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to air conditioning power entries with total consumption
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getAirConditioningPowerTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * console.log(`Total AC consumption: ${response.totalAirConditioningPowerWh} Wh`);
+     * ```
+     */
+    getAirConditioningPowerTimeseries(request: AirConditioningPowerTimeseriesRequest): Promise<AirConditioningPowerTimeseriesResponse>;
+    /**
+     * Retrieves air conditioning temperature timeseries data aggregated in time buckets.
+     * Returns per-room average, min, max, and delta temperature readings for each bucket.
+     *
+     * @param request - The query parameters including date range and optional appliance filter
+     * @returns Promise resolving to air conditioning temperature entries with per-room readings
+     *
+     * @example
+     * ```typescript
+     * const response = await timeseries.getAirConditioningTemperatureTimeseries({
+     *     startDateIso: '2024-01-01T00:00:00Z',
+     *     endDateIso: '2024-01-02T00:00:00Z'
+     * });
+     * response.entries.forEach(entry => {
+     *     entry.rooms?.forEach(room => {
+     *         console.log(`Room ${room.index}: ${room.averageTemperatureC} °C`);
+     *     });
+     * });
+     * ```
+     */
+    getAirConditioningTemperatureTimeseries(request: AirConditioningTemperatureTimeseriesRequest): Promise<AirConditioningTemperatureTimeseriesResponse>;
 }

package/dist/types/enyo-air-conditioning-appliance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Available features for an air conditioning appliance.
+ */
+export declare enum EnyoAirConditioningApplianceAvailableFeaturesEnum {
+    /** If the air conditioning unit supports cooling */
+    Cooling = "Cooling",
+    /** If the air conditioning unit supports heating */
+    Heating = "Heating"
+}
+/**
+ * Operating modes for an air conditioning appliance.
+ */
+export declare enum EnyoAirConditioningApplianceModeEnum {
+    /** The air conditioning unit is idle */
+    Idle = "Idle",
+    /** The air conditioning unit is actively cooling */
+    Cooling = "Cooling",
+    /** The air conditioning unit is actively heating */
+    Heating = "Heating"
+}
+/**
+ * A room associated with an air conditioning appliance.
+ * Each room has a unique index and an optional custom name.
+ */
+export interface EnyoAirConditioningApplianceRoom {
+    /** Zero-based index identifying the room */
+    index: number;
+    /** Optional custom name for the room (e.g. "Living Room", "Bedroom") */
+    customName?: string;
+}
+/**
+ * Type-specific metadata for an air conditioning appliance.
+ * Contains available features, current operating mode, and configured rooms.
+ */
+export interface EnyoAirConditioningApplianceMetadata {
+    /** List of features supported by this air conditioning unit */
+    availableFeatures: EnyoAirConditioningApplianceAvailableFeaturesEnum[];
+    /** Current operating mode of the air conditioning unit */
+    mode?: EnyoAirConditioningApplianceModeEnum;
+    /** Rooms served by this air conditioning unit (0 to n) */
+    rooms?: EnyoAirConditioningApplianceRoom[];
+}

package/dist/types/enyo-air-conditioning-appliance.js

@@ -0,0 +1,22 @@
+/**
+ * Available features for an air conditioning appliance.
+ */
+export var EnyoAirConditioningApplianceAvailableFeaturesEnum;
+(function (EnyoAirConditioningApplianceAvailableFeaturesEnum) {
+    /** If the air conditioning unit supports cooling */
+    EnyoAirConditioningApplianceAvailableFeaturesEnum["Cooling"] = "Cooling";
+    /** If the air conditioning unit supports heating */
+    EnyoAirConditioningApplianceAvailableFeaturesEnum["Heating"] = "Heating";
+})(EnyoAirConditioningApplianceAvailableFeaturesEnum || (EnyoAirConditioningApplianceAvailableFeaturesEnum = {}));
+/**
+ * Operating modes for an air conditioning appliance.
+ */
+export var EnyoAirConditioningApplianceModeEnum;
+(function (EnyoAirConditioningApplianceModeEnum) {
+    /** The air conditioning unit is idle */
+    EnyoAirConditioningApplianceModeEnum["Idle"] = "Idle";
+    /** The air conditioning unit is actively cooling */
+    EnyoAirConditioningApplianceModeEnum["Cooling"] = "Cooling";
+    /** The air conditioning unit is actively heating */
+    EnyoAirConditioningApplianceModeEnum["Heating"] = "Heating";
+})(EnyoAirConditioningApplianceModeEnum || (EnyoAirConditioningApplianceModeEnum = {}));

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

@@ -5,6 +5,7 @@ import { EnyoBatteryApplianceMetadata } from "./enyo-battery-appliance.js";
 import { EnyoInverterApplianceMetadata } from "./enyo-inverter-appliance.js";
 import { EnyoMeterAppliance } from "./enyo-meter-appliance.js";
 import { EnyoTemperatureSensorApplianceMetadata } from "./enyo-temperature-sensor-appliance.js";
+import { EnyoAirConditioningApplianceMetadata } from "./enyo-air-conditioning-appliance.js";
 export declare enum EnyoApplianceTypeEnum {
     Inverter = "Inverter",
     Charger = "Charger",
@@ -102,6 +103,8 @@ export interface EnyoAppliance {
     battery?: EnyoBatteryApplianceMetadata;
     /** Optional Metadata of the Appliance if of type TemperatureSensor */
     temperatureSensor?: EnyoTemperatureSensorApplianceMetadata;
+    /** Optional Metadata of the Appliance if of type AirConditioning */
+    airConditioning?: EnyoAirConditioningApplianceMetadata;
     /** Optional custom name for the appliance, defined by the user */
     customName?: string;
 }

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

@@ -6,6 +6,7 @@ import { PreviewChargingSchedule, PreviewChargingScheduleCostComparison, Preview
 import { EnyoEnergyPrices } from "./enyo-energy-prices.js";
 import { EnyoCurrencyEnum } from "./enyo-currency.js";
 import { EnyoHeatpumpApplianceModeEnum } from "./enyo-heatpump-appliance.js";
+import { EnyoAirConditioningApplianceModeEnum } from "./enyo-air-conditioning-appliance.js";
 /**
  * Enum representing the reason type for why a data bus command was issued.
  * Used to attach context to commands for logging, debugging, and UI display.
@@ -189,7 +190,11 @@ export declare enum EnyoDataBusMessageEnum {
     RequestChargerLogsV1 = "RequestChargerLogsV1",
     ClearChargingProfilesV1 = "ClearChargingProfilesV1",
     HeatpumpOverheatingV1 = "HeatpumpOverheatingV1",
-    HeatpumpAvailablePowerAnnouncementV1 = "HeatpumpAvailablePowerAnnouncementV1"
+    HeatpumpAvailablePowerAnnouncementV1 = "HeatpumpAvailablePowerAnnouncementV1",
+    AirConditioningValuesUpdateV1 = "AirConditioningValuesUpdateV1",
+    AirConditioningTemperaturesUpdateV1 = "AirConditioningTemperaturesUpdateV1",
+    StartAirConditioningV1 = "StartAirConditioningV1",
+    StopAirConditioningV1 = "StopAirConditioningV1"
 }
 export type EnyoDataBusMessageResolution = '10s' | '30s' | '1m' | '15m' | '1h' | '1d' | 'dynamic';
 export interface EnyoDataBusMessage {
@@ -1151,3 +1156,76 @@ export interface EnyoDataBusHeatpumpAvailablePowerAnnouncementV1 extends EnyoDat
         reason?: EnyoDataBusCommandReason;
     };
 }
+/**
+ * Data bus message for reporting air conditioning power values.
+ * Contains the current operating mode and power consumption.
+ */
+export interface EnyoDataBusAirConditioningValuesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.AirConditioningValuesUpdateV1;
+    /** ID of the air conditioning appliance that delivered these values */
+    applianceId: string;
+    data: {
+        values: {
+            /** Current operating mode of the air conditioning unit */
+            operationMode: EnyoAirConditioningApplianceModeEnum;
+            /** Current power consumption in Watts */
+            powerW?: number;
+        };
+    };
+}
+/**
+ * Data bus message for reporting air conditioning temperature values.
+ * Contains per-room temperature readings from an air conditioning appliance.
+ */
+export interface EnyoDataBusAirConditioningTemperaturesV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.AirConditioningTemperaturesUpdateV1;
+    /** ID of the air conditioning appliance that delivered these temperature values */
+    applianceId: string;
+    data: {
+        /** Room temperature readings, indexed per room */
+        rooms?: {
+            /** Index of the room */
+            index: number;
+            /** Target temperature in Celsius */
+            targetTemperatureC: number;
+            /** Current temperature in Celsius */
+            temperatureC: number;
+        }[];
+    };
+}
+/**
+ * Command message to start an air conditioning appliance in a specified mode.
+ * This message instructs the air conditioning unit to begin operating in
+ * either heating or cooling mode.
+ */
+export interface EnyoDataBusStartAirConditioningV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StartAirConditioningV1;
+    /** ID of the air conditioning appliance to start */
+    applianceId: string;
+    data: {
+        /** The operating mode to start the air conditioning unit in (Heating or Cooling) */
+        mode: EnyoAirConditioningApplianceModeEnum;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}
+/**
+ * Command message to stop an air conditioning appliance.
+ * This message instructs the air conditioning unit to stop operating.
+ * The mode indicates which operating mode (heating or cooling) should be stopped.
+ */
+export interface EnyoDataBusStopAirConditioningV1 extends EnyoDataBusMessage {
+    type: 'message';
+    message: EnyoDataBusMessageEnum.StopAirConditioningV1;
+    /** ID of the air conditioning appliance to stop */
+    applianceId: string;
+    data: {
+        /** The operating mode to stop (Heating or Cooling) */
+        mode: EnyoAirConditioningApplianceModeEnum;
+        /** Optional reason why this command was issued */
+        reason?: EnyoDataBusCommandReason;
+    };
+}

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

@@ -149,6 +149,10 @@ export var EnyoDataBusMessageEnum;
     EnyoDataBusMessageEnum["ClearChargingProfilesV1"] = "ClearChargingProfilesV1";
     EnyoDataBusMessageEnum["HeatpumpOverheatingV1"] = "HeatpumpOverheatingV1";
     EnyoDataBusMessageEnum["HeatpumpAvailablePowerAnnouncementV1"] = "HeatpumpAvailablePowerAnnouncementV1";
+    EnyoDataBusMessageEnum["AirConditioningValuesUpdateV1"] = "AirConditioningValuesUpdateV1";
+    EnyoDataBusMessageEnum["AirConditioningTemperaturesUpdateV1"] = "AirConditioningTemperaturesUpdateV1";
+    EnyoDataBusMessageEnum["StartAirConditioningV1"] = "StartAirConditioningV1";
+    EnyoDataBusMessageEnum["StopAirConditioningV1"] = "StopAirConditioningV1";
 })(EnyoDataBusMessageEnum || (EnyoDataBusMessageEnum = {}));
 /**
  * Possible answers an appliance can give when acknowledging a command.

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

@@ -384,3 +384,60 @@ export interface TemperatureSensorTimeseriesResponse extends TimeseriesResponseB
         averageTargetTemperatureC?: number;
     }[];
 }
+/**
+ * A single entry in the air conditioning power timeseries.
+ * Contains power and energy values for a single time bucket.
+ */
+export interface AirConditioningPowerTimeseriesEntry extends TimeseriesEntryBase {
+    /** Time-weighted average air conditioning power consumption in Watts for this bucket */
+    airConditioningPowerW: number;
+    /** Cumulative air conditioning energy consumption in Watt-hours for this bucket */
+    airConditioningPowerWh: number;
+}
+/**
+ * Request parameters for querying air conditioning power timeseries data.
+ */
+export interface AirConditioningPowerTimeseriesRequest extends TimeseriesRequestBase {
+}
+/**
+ * Response containing air conditioning power timeseries data.
+ */
+export interface AirConditioningPowerTimeseriesResponse extends TimeseriesResponseBase {
+    /** Array of air conditioning power entries, one per time bucket */
+    entries: AirConditioningPowerTimeseriesEntry[];
+    /** Total air conditioning energy consumption in Watt-hours across all buckets */
+    totalAirConditioningPowerWh: number;
+}
+/**
+ * A single entry in the air conditioning temperature timeseries.
+ * Contains per-room temperature readings for a single time bucket.
+ */
+export interface AirConditioningTemperatureTimeseriesEntry extends TimeseriesEntryBase {
+    /** Room temperature readings, indexed per room */
+    rooms?: {
+        /** Zero-based index identifying the room */
+        index: number;
+        /** Average temperature in degrees Celsius for this bucket */
+        averageTemperatureC: number;
+        /** Minimum temperature in degrees Celsius observed in this bucket */
+        minTemperatureC: number;
+        /** Maximum temperature in degrees Celsius observed in this bucket */
+        maxTemperatureC: number;
+        /** Temperature difference (delta) in Kelvin for this bucket */
+        deltaK: number;
+        /** Average target temperature in degrees Celsius for this bucket */
+        averageTargetTemperatureC: number;
+    }[];
+}
+/**
+ * Request parameters for querying air conditioning temperature timeseries data.
+ */
+export interface AirConditioningTemperatureTimeseriesRequest extends TimeseriesRequestBase {
+}
+/**
+ * Response containing air conditioning temperature timeseries data.
+ */
+export interface AirConditioningTemperatureTimeseriesResponse extends TimeseriesResponseBase {
+    /** Array of air conditioning temperature entries, one per time bucket */
+    entries: AirConditioningTemperatureTimeseriesEntry[];
+}

package/dist/version.d.ts

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