@jakobgoerke/ac-infinity-client 0.2.1 → 0.3.1

package/README.md

@@ -1 +1,259 @@
-# ac-infinity-client
+# ac-infinity-client
+
+[![npm](https://img.shields.io/npm/v/@jakobgoerke/ac-infinity-client)](https://www.npmjs.com/package/@jakobgoerke/ac-infinity-client)
+[![build & test](https://github.com/jakobgoerke/ac-infinity-client/actions/workflows/build.yml/badge.svg)](https://github.com/jakobgoerke/ac-infinity-client/actions/workflows/build.yml)
+[![license](https://img.shields.io/npm/l/@jakobgoerke/ac-infinity-client)](LICENSE)
+
+A typed Node.js client for the [AC Infinity](https://acinfinity.com) cloud API, the same backend the AC Infinity app uses. Use it to read your
+UIS controllers, their ports and sensors, and to change device and mode settings from your own code.
+
+- **Typed**: responses are validated with [zod](https://zod.dev) and turned into readable objects (`levelWhileOn` instead of `onSpead`).
+- **Decoded values**: temperatures, humidity, VPD and sensor readings come back in real units, not vendor-scaled integers.
+- **Partial updates**: send only the fields you want to change. The client fetches the current settings and merges your changes in.
+- **Device detection**: ports without an assigned device type are identified by the ID resistor in the plug.
+
+> [!NOTE]
+> This is an unofficial project and is not affiliated with AC Infinity. The API is undocumented and may change without notice.
+
+## Installation
+
+```sh
+npm install @jakobgoerke/ac-infinity-client
+# or
+yarn add @jakobgoerke/ac-infinity-client
+```
+
+Requires Node.js 24 or newer.
+
+## Quick start
+
+```ts
+import { AcInfinityClient, DeviceMode } from '@jakobgoerke/ac-infinity-client';
+
+// build() creates the client and logs in
+const client = await AcInfinityClient.build({
+  email: 'you@example.com',
+  password: 'your-password',
+});
+
+const [controller] = await client.getControllers();
+console.log(`${controller.name}: ${controller.deviceInfo.temperature} °C, ${controller.deviceInfo.humidity} %`);
+
+for (const port of controller.deviceInfo.ports) {
+  console.log(`Port ${port.port} (${port.deviceName}) is at level ${port.currentLevel}`);
+}
+
+// turn the fan on port 1 on at level 6
+await client.setDeviceModeSettings({
+  controllerId: controller.id,
+  port: 1,
+  settings: { mode: DeviceMode.ON, levelWhileOn: 6 },
+});
+```
+
+## Usage
+
+### Authentication
+
+`AcInfinityClient.build()` creates a client and logs in right away. If you want to log in later, create the client with `new` and call
+`authenticate()` yourself:
+
+```ts
+const client = new AcInfinityClient({ email, password });
+const user = await client.authenticate(); // { id, username, email }
+```
+
+If the credentials are rejected, an `AuthenticationError` is thrown.
+
+> [!WARNING]
+> The user `id` returned by `authenticate()` is also the API token: it is sent with every request, and anyone who has it can control your
+> devices. Treat it like your password and keep it out of logs, issues and screenshots. The vendor API is served over plain HTTP, so the
+> token travels unencrypted.
+
+### Controllers
+
+```ts
+const controllers = await client.getControllers();        // controllers on your account
+const shared = await client.getSharedControllers();       // controllers others shared with you
+const controller = await client.getController({ controllerId: controllers[0].id });
+```
+
+A controller looks like this (abridged):
+
+```ts
+{
+  id: '1234567890123456789',
+  name: 'Grow Tent',
+  type: ControllerDeviceType.UIS_CONTROLLER_69_PRO,
+  totalPorts: 4,
+  online: true,
+  firmwareVersion: '3.2.25',
+  deviceInfo: {
+    temperature: 24.5,   // °C
+    temperatureF: 76.1,  // °F, null if not reported
+    humidity: 58.3,      // %
+    vpd: 1.28,           // kPa
+    ports: [
+      {
+        port: 1,
+        deviceName: 'Exhaust Fan',
+        deviceType: DeviceType.FAN,
+        currentMode: DeviceMode.AUTO,
+        currentLevel: 4,
+        online: true,
+        remainingTime: null, // seconds until the next timer / cycle / schedule switch
+      },
+    ],
+    sensors: [
+      { port: 1, type: SensorType.CO2, value: 812 }, // value is null when the sensor has no reading
+    ],
+  },
+}
+```
+
+### Ports
+
+Settings are addressed by `controllerId` and `port`. Port `0` is the controller itself, ports `1` to `n` are the devices plugged into it.
+
+### Mode settings
+
+Mode settings control what a device does: its mode, its levels, and the triggers for timer, cycle, schedule, auto and VPD modes.
+
+```ts
+const modes = await client.getDeviceModeSettings({ controllerId, port: 1 });
+
+modes.mode;                          // DeviceMode.AUTO
+modes.levelWhileOn;                  // 0–10
+modes.auto.highTemperature;          // { enabled: true, celsius: 28, fahrenheit: 82 }
+modes.vpd.target;                    // { enabled: false, value: 1.2 } (kPa)
+modes.schedule;                      // { start: 480, end: 1200 } (minutes after midnight)
+```
+
+Only the fields you pass to `setDeviceModeSettings()` are changed:
+
+```ts
+// run the fan in auto mode when it gets hotter than 28 °C or more humid than 65 %
+await client.setDeviceModeSettings({
+  controllerId,
+  port: 1,
+  settings: {
+    mode: DeviceMode.AUTO,
+    levelWhileOn: 8,
+    levelWhileOff: 1,
+    auto: {
+      highTemperature: { enabled: true, celsius: 28 },
+      highHumidity: { enabled: true, value: 65 },
+    },
+  },
+});
+
+// switch the light on at 08:00 and off at 20:00
+await client.setDeviceModeSettings({
+  controllerId,
+  port: 2,
+  settings: {
+    mode: DeviceMode.SCHEDULE,
+    schedule: { start: 8 * 60, end: 20 * 60 },
+  },
+});
+
+// 15 minutes on, 45 minutes off
+await client.setDeviceModeSettings({
+  controllerId,
+  port: 3,
+  settings: {
+    mode: DeviceMode.CYCLE,
+    cycle: { on: 15 * 60, off: 45 * 60 },
+  },
+});
+```
+
+| Setting                                              | Unit / range                                                   |
+| ---------------------------------------------------- | -------------------------------------------------------------- |
+| `levelWhileOn`, `levelWhileOff`                      | 0–10                                                           |
+| `timer.toOn`, `timer.toOff`, `cycle.on`, `cycle.off` | seconds                                                        |
+| `schedule.start`, `schedule.end`                     | minutes after midnight (0–1439), `null` to clear               |
+| temperature triggers                                 | `celsius` (0–90) **or** `fahrenheit` (32–194), the other is computed |
+| humidity triggers                                    | percent (0–100)                                                |
+| VPD triggers                                         | kPa (0–9.9)                                                    |
+
+### Device settings
+
+Device settings are the general settings of a port or the controller: name, temperature unit, display brightness, backlight and sensor
+calibration.
+
+```ts
+const settings = await client.getDeviceSettings({ controllerId, port: 0 });
+
+settings.name;             // 'Grow Tent'
+settings.temperatureUnit;  // TemperatureUnit.CELSIUS
+settings.calibration;      // { temperatureC, temperatureF, humidity, leafTemperatureC, leafTemperatureF }
+
+await client.setDeviceSettings({
+  controllerId,
+  port: 0,
+  settings: {
+    name: 'Grow Tent',
+    temperatureUnit: TemperatureUnit.CELSIUS,
+    backlight: true,
+    calibration: { temperatureC: -1, humidity: 2 },
+  },
+});
+```
+
+As with temperature triggers, give the temperature calibration in either `temperatureC` or `temperatureF`. The other value is computed for you.
+
+### Errors
+
+| Error                 | When                                                                                     |
+| --------------------- | ---------------------------------------------------------------------------------------- |
+| `AuthenticationError` | The login was rejected.                                                                  |
+| `ApiError`            | The API answered with a non-200 code. The error carries the vendor's `code` and `msg`.   |
+| `ZodError`            | A response didn't match the expected shape, or the changes you passed are out of range. |
+
+```ts
+import { ApiError } from '@jakobgoerke/ac-infinity-client';
+
+try {
+  await client.getController({ controllerId: 'unknown' });
+} catch (error) {
+  if (error instanceof ApiError) {
+    console.error(error.code, error.msg);
+  }
+}
+```
+
+## API reference
+
+| Method                                                   | Returns                       |
+| -------------------------------------------------------- | ----------------------------- |
+| `AcInfinityClient.build({ email, password })`            | `Promise<AcInfinityClient>`   |
+| `authenticate()`                                         | `Promise<User>`               |
+| `getControllers()`                                       | `Promise<Controller[]>`       |
+| `getSharedControllers()`                                 | `Promise<Controller[]>`       |
+| `getController({ controllerId })`                        | `Promise<Controller>`         |
+| `getDeviceSettings({ controllerId, port })`              | `Promise<DeviceSettings>`     |
+| `setDeviceSettings({ controllerId, port, settings })`    | `Promise<void>`               |
+| `getDeviceModeSettings({ controllerId, port })`          | `Promise<DeviceModeSettings>` |
+| `setDeviceModeSettings({ controllerId, port, settings })`| `Promise<void>`               |
+
+The package also exports the enums `ControllerDeviceType`, `DeviceType`, `DeviceMode`, `SensorType` and `TemperatureUnit`, and the types
+`Controller`, `ControllerDeviceInfo`, `ControllerPort`, `ControllerSensor`, `DeviceSettings`, `DeviceSettingsChanges`, `DeviceModeSettings`,
+`DeviceModeSettingsChanges` and `User`.
+
+## Development
+
+```sh
+corepack enable
+yarn install
+yarn test       # run the tests
+yarn coverage   # run the tests with coverage
+yarn lint       # check formatting and lint rules with Biome
+yarn build      # compile to ./build
+```
+
+New versions are published to npm by CI when a tag is pushed.
+
+## License
+
+[GPL-3.0-or-later](LICENSE)

package/build/src/AcInfinityClient.d.ts

@@ -1,25 +1,35 @@
-import type { Controller, DeviceModeSettings, DeviceSettings, User } from './types';
+import type { Controller, DeviceModeSettings, DeviceModeSettingsChanges, DeviceSettings, DeviceSettingsChanges, User } from './types';
 export declare enum Url {
     AUTH = "/user/appUserLogin",
     GET_CONTROLLERS = "/user/devInfoListAll",
+    GET_SHARED_CONTROLLERS = "/user/shareDevList",
+    GET_CONTROLLER = "/dev/getDeviceInfo",
     GET_DEVICE_SETTINGS = "/dev/getDevSetting",
+    SET_DEVICE_SETTINGS = "/dev/updateAdvSetting",
     GET_DEVICE_MODE_SETTINGS = "/dev/getdevModeSettingList",
     SET_DEVICE_MODE_SETTINGS = "/dev/addDevMode"
 }
 export interface Response<T> {
     code: number;
+    msg?: string;
     data: T;
 }
 export interface AuthParams {
     email: string;
     password: string;
 }
-interface GetDeviceParams {
+export interface ControllerParams {
     controllerId: string;
+}
+export interface GetDeviceParams extends ControllerParams {
+    /** 0 addresses the controller itself, 1..n the devices plugged into its ports */
     port: number;
 }
-interface SetDeviceModeSettingsParams extends GetDeviceParams {
-    settings: Pick<Partial<DeviceModeSettings>, 'levelWhileOn'>;
+export interface SetDeviceModeSettingsParams extends GetDeviceParams {
+    settings: DeviceModeSettingsChanges;
+}
+export interface SetDeviceSettingsParams extends GetDeviceParams {
+    settings: DeviceSettingsChanges;
 }
 declare class AcInfinityClient {
     constructor(args: AuthParams);
@@ -28,13 +38,17 @@ declare class AcInfinityClient {
     private email;
     private password;
     authenticate(): Promise<User>;
-    private ensureSuccess;
+    private request;
     getControllers(): Promise<Controller[]>;
+    getSharedControllers(): Promise<Controller[]>;
+    getController({ controllerId }: ControllerParams): Promise<Controller>;
     getDeviceSettings({ controllerId, port }: GetDeviceParams): Promise<DeviceSettings>;
+    setDeviceSettings({ controllerId, port, settings }: SetDeviceSettingsParams): Promise<void>;
+    private getDeviceName;
     getDeviceModeSettings({ controllerId, port }: GetDeviceParams): Promise<DeviceModeSettings>;
     setDeviceModeSettings({ controllerId, port, settings }: SetDeviceModeSettingsParams): Promise<void>;
     static build(args: AuthParams): Promise<AcInfinityClient>;
 }
+export type { Controller, DeviceModeSettings, DeviceModeSettingsChanges, DeviceSettings, DeviceSettingsChanges, User };
 export { AcInfinityClient };
-export type { Controller, DeviceModeSettings, DeviceSettings, User };
 //# sourceMappingURL=AcInfinityClient.d.ts.map

package/build/src/AcInfinityClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcInfinityClient.d.ts","sourceRoot":"","sources":["../../src/AcInfinityClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAA2B,cAAc,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG7G,oBAAY,GAAG;IACb,IAAI,uBAAuB;IAC3B,eAAe,yBAAyB;IACxC,mBAAmB,uBAAuB;IAC1C,wBAAwB,+BAA+B;IACvD,wBAAwB,oBAAoB;CAC7C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAOD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,2BAA4B,SAAQ,eAAe;IAC3D,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,cAAc,CAAC,CAAC;CAC7D;AAED,cAAM,gBAAgB;gBACR,IAAI,EAAE,UAAU;IAiB5B,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IAEZ,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB1C,OAAO,CAAC,aAAa;IAMR,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQvC,iBAAiB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IASnF,qBAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS3F,qBAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;WAanG,KAAK,CAAC,IAAI,EAAE,UAAU;CAKpC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"AcInfinityClient.d.ts","sourceRoot":"","sources":["../../src/AcInfinityClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAUtI,oBAAY,GAAG;IACb,IAAI,uBAAuB;IAC3B,eAAe,yBAAyB;IACxC,sBAAsB,uBAAuB;IAC7C,cAAc,uBAAuB;IACrC,mBAAmB,uBAAuB;IAC1C,mBAAmB,0BAA0B;IAC7C,wBAAwB,+BAA+B;IACvD,wBAAwB,oBAAoB;CAC7C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,2BAA4B,SAAQ,eAAe;IAClE,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAqBD,cAAM,gBAAgB;gBACR,IAAI,EAAE,UAAU;IAiB5B,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IAEZ,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAiB5B,OAAO;IAUR,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQvC,oBAAoB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAQ7C,aAAa,CAAC,EAAE,YAAY,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAQtE,iBAAiB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IASnF,iBAAiB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;YAe1F,aAAa;IAMd,qBAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS3F,qBAAqB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;WAYnG,KAAK,CAAC,IAAI,EAAE,UAAU;CAKpC;AAED,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/build/src/AcInfinityClient.js

@@ -11,10 +11,26 @@ var Url;
 (function (Url) {
     Url["AUTH"] = "/user/appUserLogin";
     Url["GET_CONTROLLERS"] = "/user/devInfoListAll";
+    Url["GET_SHARED_CONTROLLERS"] = "/user/shareDevList";
+    Url["GET_CONTROLLER"] = "/dev/getDeviceInfo";
     Url["GET_DEVICE_SETTINGS"] = "/dev/getDevSetting";
+    Url["SET_DEVICE_SETTINGS"] = "/dev/updateAdvSetting";
     Url["GET_DEVICE_MODE_SETTINGS"] = "/dev/getdevModeSettingList";
     Url["SET_DEVICE_MODE_SETTINGS"] = "/dev/addDevMode";
 })(Url || (exports.Url = Url = {}));
+// fahrenheit values below freezing are raised to 32 before sending mode settings
+const FAHRENHEIT_FIELDS = ['devHtf', 'devLtf', 'targetTempF', 'waterTempHighValueF', 'waterTempLowValueF', 'waterTempTargetValueF'];
+// only send flat values: nested objects and empty fields are left out
+const toFormPayload = (values) => Object.fromEntries(Object.entries(values).filter(([, value]) => value !== null && value !== undefined && typeof value !== 'object'));
+const clampFahrenheit = (payload) => {
+    for (const field of FAHRENHEIT_FIELDS) {
+        const value = payload[field];
+        if (typeof value === 'number' && value < 32) {
+            payload[field] = 32;
+        }
+    }
+    return payload;
+};
 class AcInfinityClient {
     constructor(args) {
         const { email, password } = args;
@@ -46,40 +62,68 @@ class AcInfinityClient {
         this.api.defaults.headers.common.token = user.id;
         return user;
     }
-    ensureSuccess(response) {
-        if (response.code !== 200) {
-            throw new Error(`API request failed [code="${response.code}", msg="${response.msg}"]`);
+    async request(url, params) {
+        const response = await this.api.post(url, params);
+        if (response.data.code !== 200) {
+            throw new errors_1.ApiError(response.data.code, response.data.msg);
         }
+        return response.data.data;
     }
     async getControllers() {
-        const response = await this.api.post(Url.GET_CONTROLLERS, {
+        const controllers = await this.request(Url.GET_CONTROLLERS, {
             userId: this.token,
         });
-        return response.data.data.map((device) => types_1.ControllerSchema.parse(device));
+        return controllers.map((device) => types_1.ControllerSchema.parse(device));
+    }
+    async getSharedControllers() {
+        const controllers = await this.request(Url.GET_SHARED_CONTROLLERS, {
+            userId: this.token,
+        });
+        return controllers.map((device) => types_1.ControllerSchema.parse(device));
+    }
+    async getController({ controllerId }) {
+        const controller = await this.request(Url.GET_CONTROLLER, {
+            devId: controllerId,
+        });
+        return types_1.ControllerSchema.parse(controller);
     }
     async getDeviceSettings({ controllerId, port }) {
-        const response = await this.api.post(Url.GET_DEVICE_SETTINGS, {
+        const settings = await this.request(Url.GET_DEVICE_SETTINGS, {
+            devId: controllerId,
+            port,
+        });
+        return types_1.DeviceSettingsSchema.parse(settings);
+    }
+    async setDeviceSettings({ controllerId, port, settings }) {
+        const vendorChanges = (0, types_1.encodeDeviceSettings)(settings);
+        const currentSettings = await this.request(Url.GET_DEVICE_SETTINGS, {
             devId: controllerId,
             port,
         });
-        return types_1.DeviceSettingsSchema.parse(response.data.data);
+        // the name is required, but often not stored in the settings themselves
+        const devName = vendorChanges.devName ?? currentSettings.devName ?? (await this.getDeviceName({ controllerId, port }));
+        const payload = toFormPayload({ ...currentSettings, ...vendorChanges, devName });
+        await this.request(Url.SET_DEVICE_SETTINGS, payload);
+    }
+    async getDeviceName({ controllerId, port }) {
+        const controller = await this.getController({ controllerId });
+        return port === 0 ? controller.name : controller.deviceInfo.ports.find((p) => p.port === port)?.deviceName;
     }
     async getDeviceModeSettings({ controllerId, port }) {
-        const response = await this.api.post(Url.GET_DEVICE_MODE_SETTINGS, {
+        const settings = await this.request(Url.GET_DEVICE_MODE_SETTINGS, {
             devId: controllerId,
             port,
         });
-        return types_1.DeviceModeSettingsSchema.parse(response.data.data);
+        return types_1.DeviceModeSettingsSchema.parse(settings);
     }
     async setDeviceModeSettings({ controllerId, port, settings }) {
-        const rawCurrentSettings = await this.api.post(Url.GET_DEVICE_MODE_SETTINGS, {
+        const vendorChanges = (0, types_1.encodeDeviceModeSettings)(settings);
+        const currentSettings = await this.request(Url.GET_DEVICE_MODE_SETTINGS, {
             devId: controllerId,
             port,
         });
-        const vendorChanges = (0, types_1.encodeDeviceModeSettings)(settings);
-        const payload = { ...rawCurrentSettings.data.data, ...vendorChanges };
-        const response = await this.api.post(Url.SET_DEVICE_MODE_SETTINGS, payload);
-        this.ensureSuccess(response.data);
+        const payload = clampFahrenheit(toFormPayload({ ...currentSettings, ...vendorChanges, onlyUpdateSpeed: 0 }));
+        await this.request(Url.SET_DEVICE_MODE_SETTINGS, payload);
     }
     static async build(args) {
         const instance = new AcInfinityClient(args);

package/build/src/errors/index.d.ts

@@ -1,5 +1,10 @@
 declare class AuthenticationError extends Error {
     constructor(message?: string);
 }
-export { AuthenticationError };
+declare class ApiError extends Error {
+    readonly code: number;
+    readonly msg?: string | undefined;
+    constructor(code: number, msg?: string | undefined);
+}
+export { ApiError, AuthenticationError };
 //# sourceMappingURL=index.d.ts.map

package/build/src/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAM,mBAAoB,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM;CAQ7B;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAM,mBAAoB,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM;CAQ7B;AAED,cAAM,QAAS,SAAQ,KAAK;aAER,IAAI,EAAE,MAAM;aACZ,GAAG,CAAC,EAAE,MAAM;gBADZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,YAAA;CAS/B;AAED,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC"}

package/build/src/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthenticationError = void 0;
+exports.AuthenticationError = exports.ApiError = void 0;
 class AuthenticationError extends Error {
     constructor(message) {
         super(message);
@@ -10,3 +10,16 @@ class AuthenticationError extends Error {
     }
 }
 exports.AuthenticationError = AuthenticationError;
+class ApiError extends Error {
+    code;
+    msg;
+    constructor(code, msg) {
+        super(`API request failed [code="${code}", msg="${msg}"]`);
+        this.code = code;
+        this.msg = msg;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+        Object.setPrototypeOf(this, ApiError.prototype);
+    }
+}
+exports.ApiError = ApiError;

package/build/src/index.d.ts

@@ -1,2 +1,5 @@
 export * from './AcInfinityClient';
+export * from './errors';
+export type { ControllerDeviceInfo, ControllerPort, ControllerSensor } from './types';
+export { ControllerDeviceType, DeviceMode, DeviceType, SensorType, TemperatureUnit } from './types';
 //# sourceMappingURL=index.d.ts.map

package/build/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/build/src/index.js

@@ -14,4 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemperatureUnit = exports.SensorType = exports.DeviceType = exports.DeviceMode = exports.ControllerDeviceType = void 0;
 __exportStar(require("./AcInfinityClient"), exports);
+__exportStar(require("./errors"), exports);
+var types_1 = require("./types");
+Object.defineProperty(exports, "ControllerDeviceType", { enumerable: true, get: function () { return types_1.ControllerDeviceType; } });
+Object.defineProperty(exports, "DeviceMode", { enumerable: true, get: function () { return types_1.DeviceMode; } });
+Object.defineProperty(exports, "DeviceType", { enumerable: true, get: function () { return types_1.DeviceType; } });
+Object.defineProperty(exports, "SensorType", { enumerable: true, get: function () { return types_1.SensorType; } });
+Object.defineProperty(exports, "TemperatureUnit", { enumerable: true, get: function () { return types_1.TemperatureUnit; } });