daikin-airbase 0.1.6 → 0.3.0

package/dist/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  API: () => API,
+  Client: () => Client,
   ControlMode: () => ControlMode,
   DaikinClient: () => DaikinClient,
   FanSpeed: () => FanSpeed,
@@ -39,15 +39,26 @@ __export(index_exports, {
   Zones: () => Zones,
   basic_info: () => basic_info,
   discover: () => discover,
-  get_zone_settings: () => get_zone_settings
+  getNetwork_setting: () => getNetwork_setting,
+  get_control_info: () => get_control_info,
+  get_datetime: () => get_datetime,
+  get_dealer_info: () => get_dealer_info,
+  get_model_info: () => get_model_info,
+  get_quick_timer: () => get_quick_timer,
+  get_sensor_info: () => get_sensor_info,
+  get_wifi_setting: () => get_wifi_setting,
+  get_zone_settings: () => get_zone_settings,
+  set_control_info: () => set_control_info,
+  set_zone_setting: () => set_zone_setting
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/ParamParser.ts
-function parse(str) {
+var int = (v) => Math.round(v);
+var bool = (v) => v ? 1 : 0;
+function deserialize(data) {
   const result = {};
-  const parts = str.split(",");
-  for (const part of parts) {
+  for (const part of data) {
     const [key, value] = part.split("=");
     if (key === void 0) continue;
     const maybeNumber = Number(value);
@@ -59,10 +70,20 @@ function parse(str) {
   }
   return result;
 }
+function serialize(parameters) {
+  const queries = [];
+  for (const key in parameters) {
+    const value = parameters[key];
+    if (value === void 0) continue;
+    const encoded = encodeURIComponent(typeof value === "string" ? value : value !== null ? `${int(value)}` : "");
+    queries.push(`${key}=${encoded}`);
+  }
+  return queries;
+}
 
-// src/api/API.ts
+// src/api/Client.ts
 var import_node_http = __toESM(require("http"));
-var API = class {
+var Client = class {
   host;
   constructor(host) {
     this.host = host;
@@ -70,16 +91,8 @@ var API = class {
   async request(endpoint, parameters) {
     const body = await new Promise((resolve, reject) => {
       const url = new URL(`/skyfi${endpoint}`, `http://${this.host}/`);
-      const queries = [];
-      if (parameters) {
-        for (const key in parameters) {
-          const value = parameters[key];
-          if (value === void 0) continue;
-          const encoded = encodeURIComponent(`${value ?? ""}`);
-          queries.push(`${key}=${encoded}`);
-        }
-      }
-      const search = queries.length > 0 ? `?${queries.join("&")}` : "";
+      const serialized = parameters ? serialize(parameters) : [];
+      const search = serialized.length > 0 ? `?${serialized.join("&")}` : "";
       const req = import_node_http.default.request(
         {
           host: url.hostname,
@@ -102,7 +115,7 @@ var API = class {
       req.on("error", reject);
       req.end();
     });
-    return parse(body);
+    return deserialize(body.split(","));
   }
 };
 
@@ -125,7 +138,7 @@ function discover(timeoutMs = 3e3) {
     });
     socket.on("message", (msg, rinfo) => {
       const raw = msg.toString("utf8");
-      const info = parse(raw);
+      const info = deserialize(raw.split(","));
       const key = `${info.mac || info.id || rinfo.address}`;
       availableUnits.set(key, {
         discoveredAddress: rinfo.address,
@@ -152,15 +165,42 @@ function discover(timeoutMs = 3e3) {
   });
 }
 
-// src/api/common/basic_info.ts
-var basic_info = (http2) => http2.request("/common/basic_info");
+// src/api/aircon/get_control_info.ts
+var get_control_info = (http2) => http2.request("/aircon/get_control_info");
+
+// src/api/aircon/get_model_info.ts
+var get_model_info = (http2) => http2.request("/aircon/get_model_info");
+
+// src/api/aircon/get_quick_timer.ts
+var get_quick_timer = (http2) => http2.request("/aircon/get_quick_timer");
+
+// src/api/aircon/get_sensor_info.ts
+var get_sensor_info = (http2) => http2.request("/aircon/get_sensor_info");
 
 // src/api/aircon/get_zone_setting.ts
 var get_zone_settings = (http2) => http2.request("/aircon/get_zone_setting");
 
+// src/api/aircon/set_control_info.ts
+var set_control_info = (http2, params) => http2.request("/aircon/set_control_info", params);
+
 // src/api/aircon/set_zone_setting.ts
 var set_zone_setting = (http2, params) => http2.request("/aircon/set_zone_setting", params);
 
+// src/api/common/basic_info.ts
+var basic_info = (http2) => http2.request("/common/basic_info");
+
+// src/api/common/get_datetime.ts
+var get_datetime = (http2) => http2.request("/common/get_datetime");
+
+// src/api/common/get_dealer_info.ts
+var get_dealer_info = (http2) => http2.request("/common/get_dealer_info");
+
+// src/api/common/get_network_setting.ts
+var getNetwork_setting = (http2) => http2.request("/common/get_network_setting");
+
+// src/api/common/get_wifi_setting.ts
+var get_wifi_setting = (http2) => http2.request("/common/get_wifi_setting");
+
 // src/Zones.ts
 var Zones = class {
   zones = [];
@@ -168,69 +208,105 @@ var Zones = class {
   constructor(client) {
     this.client = client;
   }
-  /** Refreshes the cached zone state */
-  async refresh() {
+  /**
+   * Requests all the zones current state from the airbase controller.
+   * Results are cached.
+   * @returns the current state of all zones.
+   */
+  async getZones() {
     const response = await get_zone_settings(this.client.api);
-    const zoneNames = response.zone_name.split(";");
-    const zoneState = response.zone_onoff.split(";");
-    return this.zones = zoneNames.map((name, index) => ({
+    const names = response.zone_name.split(";");
+    const onoff = response.zone_onoff.split(";");
+    const temprartures = response.lztemp_c ? response.lztemp_c.split(";") : null;
+    const humidities = response.lztemp_h ? response.lztemp_h.split(";") : null;
+    return this.zones = names.map((name, index) => Object.freeze({
+      index,
       name,
-      state: zoneState[index] === "1"
+      isOn: onoff[index] === "1",
+      humidity: humidities ? +`${humidities[index]}` : void 0,
+      temperature: temprartures ? +`${temprartures[index]}` : void 0
     }));
   }
   /**
    * Gets the state of all cached zones.
    */
   getCachedZones() {
-    return [...this.zones];
+    return this.zones;
   }
   /**
-   * Gets all zones' state
+   * Gets the current state of a zone with the matching name.
+   * @param name
    */
-  async getZones() {
-    return await this.refresh();
+  async getZone(name) {
+    return await this.getZones().then(() => this.getCachedZone(name));
+  }
+  /**
+   * Gets the current state of a zone at the given controller index.
+   * @param index
+   * @throws Error if the index is out of bounds.
+   */
+  async getZoneAt(index) {
+    return await this.getZones().then(() => this.getCachedZoneAt(index));
   }
   /**
    * Gets the cached state of a zone
    * @param name
    */
   getCachedZone(name) {
-    return this.zones.find((zone) => zone.name === name)?.state;
+    return this.zones.find((zone) => zone.name === name);
   }
   /**
-   * Gets the state of a Zone
-   * @param name
+   * Gets the cached state of a zone at the given controller index.
+   * @param index
+   * @throws Error if the index is out of bounds.
    */
-  async getZone(name) {
-    const zones = await this.refresh();
-    return zones.find((zone) => zone.name === name)?.state;
+  getCachedZoneAt(index) {
+    if (index < 0 || index >= this.zones.length || this.zones[index] === void 0)
+      throw new Error(`Zone index ${index} is out of bounds`);
+    if (this.zones[index].index !== index)
+      throw new Error(`Zone at ${index} does not believe it is in the correct spot.`);
+    return this.zones[index];
   }
   /**
-   * Sets a Zone's state
-   * @param name
-   * @param state
+   * Updates a zone
+   * @param name the name of the zone to update
+   * @param info the new data to replace
    */
-  async setZone(name, state) {
-    await this.setZones([{ name, state }]);
+  async updateZone(name, info) {
+    const zones = await this.getZones();
+    const index = zones.findIndex((zone) => zone.name === name);
+    zones[index] = { ...zones[index], ...info };
+    await this.setZones(zones);
+    return zones[index];
   }
   /**
-   * Sets multiple zones' state
-   * @param changes
+   * Bulk updates all the zones
+   * @param zones the new zones. These are sorted by index and pushed into the API in that order.
+   * @returns the updated zones
    */
-  async setZones(changes) {
-    await this.refresh();
-    for (const change of changes) {
-      const existingZone = this.zones.find((z) => z.name === change.name);
-      if (existingZone) {
-        existingZone.state = change.state;
-      }
+  async setZones(zones) {
+    let names = [];
+    let onoff = [];
+    let humidity = [];
+    let temperature = [];
+    const sortedZones = zones.sort((a, b) => a.index - b.index);
+    for (const zone of sortedZones) {
+      names.push(zone.name);
+      onoff.push(`${bool(zone.isOn)}`);
+      if (zone.humidity !== void 0)
+        humidity.push(`${int(zone.humidity)}`);
+      if (zone.temperature !== void 0)
+        temperature.push(`${int(zone.temperature)}`);
     }
     const response = await set_zone_setting(this.client.api, {
-      zone_name: this.zones.map((zone) => zone.name).join(";"),
-      zone_onoff: this.zones.map((zone) => zone.state ? "1" : "0").join(";")
+      zone_name: names.join(";"),
+      zone_onoff: onoff.join(";"),
+      lztemp_h: humidity.length > 0 ? humidity.join(";") : void 0,
+      lztemp_c: temperature.length > 0 ? temperature.join(";") : void 0
     });
     if (response.ret !== "OK")
       throw new Error(`Failed to set zones: ${response.ret}`);
+    return this.zones = zones.map((zone) => Object.freeze({ ...zone }));
   }
 };
 
@@ -262,27 +338,26 @@ var RemoteType = /* @__PURE__ */ ((RemoteType3) => {
   return RemoteType3;
 })(RemoteType || {});
 
-// src/api/aircon/get_control_info.ts
-var get_control_info = (http2) => http2.request("/aircon/get_control_info");
-
-// src/api/aircon/set_control_info.ts
-var set_control_info = (http2, params) => http2.request("/aircon/set_control_info", params);
-
 // src/DaikinClient.ts
 var DaikinClient = class {
   options;
   api;
   zones;
   cachedControlInfo;
+  cachedSensorInfo;
   constructor(options) {
     this.options = options;
     if ("host" in options) {
-      this.api = new API(options.host);
+      this.api = new Client(options.host);
     } else {
-      this.api = new API(options.device.discoveredAddress);
+      this.api = new Client(options.device.discoveredAddress);
     }
     this.zones = new Zones(this);
   }
+  /**
+   * Gets the current state of the aircon.
+   * @returns the current state of the aircon.
+   */
   async getControlInfo() {
     const response = await get_control_info(this.api);
     const responseValues = Object.entries(response);
@@ -292,7 +367,7 @@ var DaikinClient = class {
       fanAuto: response.f_auto != 0,
       fanAirside: response.f_airside != 0,
       targetTemperature: response.stemp,
-      sensorTemperatures: responseValues.filter(([k, v]) => k.startsWith("dt")).map(([k, v]) => +v),
+      controlTemperature: responseValues.filter(([k, v]) => k.startsWith("dt")).map(([k, v]) => +v),
       power: response.pow != 0,
       status: Number(response.operate),
       swinging: response.f_dir != 0,
@@ -301,21 +376,40 @@ var DaikinClient = class {
       remoteControlType: Number(response.remo)
     };
   }
+  /** Gets the cached state of the aircon. */
   getCachedControlInfo() {
     return this.cachedControlInfo;
   }
+  /**
+   * Retrieves the power state of the unit.
+   */
   async getPowered() {
     return (await this.getControlInfo()).power;
   }
+  /**
+   * Sets the powered state of the unit.
+   * @param state true to turn the unit on.
+   */
   async setPowered(state) {
     return await this.setControlInfo({ power: state });
   }
+  /**
+   * Gets the current mode of the unit.
+   */
   async getMode() {
     return (await this.getControlInfo()).mode;
   }
+  /**
+   * Sets the mode of the unit.
+   * @param mode The mode to set
+   */
   async setMode(mode) {
     return await this.setControlInfo({ mode });
   }
+  /**
+   * Gets the current fan settings of the unit.
+   * @returns the current fan settings.
+   */
   async getFan() {
     const info = await this.getControlInfo();
     return {
@@ -324,26 +418,34 @@ var DaikinClient = class {
       airside: info.fanAirside
     };
   }
+  /**
+   * Sets the fan settings of the unit.
+   * @param fan the fan settings to set.
+   */
   async setFan(fan) {
     return await this.setControlInfo({ fanSpeed: fan.speed, fanAuto: fan.auto, fanAirside: fan.airside ?? false });
   }
+  /**
+   * Gets the current target temperature of the unit
+   */
   async getTargetTemperature() {
     return (await this.getControlInfo()).targetTemperature;
   }
+  /**
+   * Sets the target temperature of the unit.
+   * @param temperature the temperature to set. This is rounded to the nearest integer.
+   */
   async setTargetTemperature(temperature) {
     return await this.setControlInfo({ targetTemperature: temperature });
   }
-  async getSensorTemperatures() {
-    return (await this.getControlInfo()).sensorTemperatures;
-  }
+  /** Gets the current status of the unit. */
   async getStatus() {
     return (await this.getControlInfo()).status;
   }
+  /** Sets the control state of the unit. */
   async setControlInfo(info) {
     const latest = await this.getControlInfo();
     const update = { ...latest, ...info };
-    const int = (v) => Math.round(v);
-    const bool = (v) => v ? 1 : 0;
     const params = {
       f_airside: 0,
       f_auto: bool(update.fanAuto),
@@ -363,6 +465,32 @@ var DaikinClient = class {
       throw new Error(`Failed to update control info: ${response.ret}`);
     this.cachedControlInfo = update;
   }
+  /**
+   * Get the current reading of the temperature sensors.
+   */
+  async getSensorInfo() {
+    const response = await get_sensor_info(this.api);
+    return this.cachedSensorInfo = {
+      insideTemperature: response.htemp,
+      outsideTemperature: response.otemp === "-" ? void 0 : response.otemp
+    };
+  }
+  /** Gets the current indoor temperature reading. */
+  async getInsideTemperature() {
+    return (await this.getSensorInfo()).insideTemperature;
+  }
+  /** Gets the current outdoor temperature reading. */
+  async getOutsideTemperature() {
+    return (await this.getSensorInfo()).outsideTemperature;
+  }
+  /** Gets the cached state of the sensor info. */
+  getCachedSensorInfo() {
+    return this.cachedSensorInfo;
+  }
+  /**
+   * Gets the basic information about the aircon.
+   * @returns the basic information about the aircon.
+   */
   async getBasicInfo() {
     const response = await basic_info(this.api);
     return {
@@ -380,13 +508,14 @@ var DaikinClient = class {
       adp_kind: response.adp_kind
     };
   }
+  /** Broadcasts a request to discover devices on the network. */
   static async discover(timeoutMs = 3e3) {
     return discover(timeoutMs);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  API,
+  Client,
   ControlMode,
   DaikinClient,
   FanSpeed,
@@ -395,5 +524,15 @@ var DaikinClient = class {
   Zones,
   basic_info,
   discover,
-  get_zone_settings
+  getNetwork_setting,
+  get_control_info,
+  get_datetime,
+  get_dealer_info,
+  get_model_info,
+  get_quick_timer,
+  get_sensor_info,
+  get_wifi_setting,
+  get_zone_settings,
+  set_control_info,
+  set_zone_setting
 });