feat: Working on async integrations.

Sources/Models/TemperatureAndHumiditySensor.swift

@@ -1,65 +1,117 @@
 import Psychrometrics
 
+/// Represents a temperature and humidity sensor that can be used to derive
+/// the dew-point temperature and enthalpy values.
+///
 public struct TemperatureAndHumiditySensor: Equatable, Identifiable {
-    /// The identifier of the sensor, same as the location.
-    public var id: Location { location }
 
-    public let altitude: Length
+  /// The identifier of the sensor, same as the location.
+  public var id: Location { location }
 
-    /// The location identifier of the sensor
-    public let location: Location
+  /// The altitude of the sensor.
+  public let altitude: Length
 
-    /// The current temperature value of the sensor.
-    @TrackedChanges
-    public var temperature: Temperature?
+  /// The current humidity value of the sensor.
+  @TrackedChanges
+  public var humidity: RelativeHumidity?
 
-    /// The current humidity value of the sensor.
-    @TrackedChanges
-    public var humidity: RelativeHumidity?
+  /// The location identifier of the sensor
+  public let location: Location
 
-    /// The psychrometric units of the sensor.
-    public let units: PsychrometricEnvironment.Units
+  /// The current temperature value of the sensor.
+  @TrackedChanges
+  public var temperature: Temperature?
+
+  /// The topics to listen for updated sensor values.
+  public let topics: Topics
+
+  /// The psychrometric units of the sensor.
+  public let units: PsychrometricEnvironment.Units
+
+  /// Create a new temperature and humidity sensor.
+  ///
+  /// - Parameters:
+  ///   - location: The location of the sensor.
+  ///   - altitude: The altitude of the sensor.
+  ///   - temperature: The current temperature value of the sensor.
+  ///   - humidity: The current relative humidity value of the sensor.
+  ///   - needsProcessed: If the sensor needs to be processed.
+  ///   - units: The unit of measure for the sensor.
+  public init(
+    location: Location,
+    altitude: Length = .feet(800.0),
+    temperature: Temperature? = nil,
+    humidity: RelativeHumidity? = nil,
+    needsProcessed: Bool = false,
+    units: PsychrometricEnvironment.Units = .imperial,
+    topics: Topics? = nil
+  ) {
+    self.altitude = altitude
+    self.location = location
+    self._temperature = TrackedChanges(wrappedValue: temperature, needsProcessed: needsProcessed)
+    self._humidity = TrackedChanges(wrappedValue: humidity, needsProcessed: needsProcessed)
+    self.units = units
+    self.topics = topics ?? .init(location: location)
+  }
+
+  /// The calculated dew-point temperature of the sensor.
+  public var dewPoint: DewPoint? {
+    guard let temperature = temperature,
+          let humidity = humidity,
+          !temperature.rawValue.isNaN,
+          !humidity.rawValue.isNaN
+    else { return nil }
+    return .init(dryBulb: temperature, humidity: humidity, units: units)
+  }
+
+  /// The calculated enthalpy of the sensor.
+  public var enthalpy: EnthalpyOf<MoistAir>? {
+    guard let temperature = temperature,
+          let humidity = humidity,
+          !temperature.rawValue.isNaN,
+          !humidity.rawValue.isNaN
+    else { return nil }
+    return .init(dryBulb: temperature, humidity: humidity, altitude: altitude, units: units)
+  }
+
+  /// Check whether any of the sensor values have changed and need processed.
+  public var needsProcessed: Bool {
+    get { $temperature.needsProcessed || $humidity.needsProcessed }
+    set {
+      $temperature.needsProcessed = newValue
+      $humidity.needsProcessed = newValue
+    }
+  }
+
+  /// Represents the different locations of a temperature and humidity sensor, which can
+  /// be used to derive the topic to both listen and publish new values to.
+  public enum Location: String, Equatable, Hashable {
+    case mixedAir = "mixed-air"
+    case postCoil = "post-coil"
+    case `return`
+    case supply
+  }
+
+  /// Represents the MQTT topics to listen for updated sensor values on.
+  public struct Topics: Equatable {
+
+    /// The temperature topic of the sensor.
+    public let temperature: String
+
+    /// The humidity topic of the sensor.
+    public let humidity: String
 
     public init(
-        location: Location,
-        altitude: Length = .feet(800.0),
-        temperature: Temperature? = nil,
-        humidity: RelativeHumidity? = nil,
-        needsProcessed: Bool = false,
-        units: PsychrometricEnvironment.Units = .imperial
+      temperature: String,
+      humidity: String
     ) {
-        self.altitude = altitude
-        self.location = location
-        self._temperature = .init(wrappedValue: temperature, needsProcessed: needsProcessed)
-        self._humidity = .init(wrappedValue: humidity, needsProcessed: needsProcessed)
-        self.units = units
+      self.temperature = temperature
+      self.humidity = humidity
     }
 
-    /// The calculated dew-point temperature of the sensor.
-    public var dewPoint: DewPoint? {
-        guard let temperature = temperature,
-              let humidity = humidity,
-              !temperature.rawValue.isNaN,
-              !humidity.rawValue.isNaN
-        else { return nil }
-        return .init(dryBulb: temperature, humidity: humidity, units: units)
-    }
-
-    /// Check whether any of the sensor values have changed and need processed.
-    public var needsProcessed: Bool {
-        get { $temperature.needsProcessed || $humidity.needsProcessed }
-        set {
-            $temperature.needsProcessed = newValue
-            $humidity.needsProcessed = newValue
-        }
-    }
-
-    /// Represents the different locations of a temperature and humidity sensor, which can
-    /// be used to derive the topic to both listen and publish new values to.
-    public enum Location: String, Equatable, Hashable {
-        case mixedAir = "mixed-air"
-        case postCoil = "post-coil"
-        case `return`
-        case supply
+    init(location: TemperatureAndHumiditySensor.Location) {
+      self.temperature = "sensors/\(location.rawValue)/temperature"
+      self.humidity = "sensors/\(location.rawValue)/temperature"
     }
+  }
 }