✨ Set target temperature

Support setting the target temperature (degree celsius) of a device.
Also add setTargetTemperature and setPower commands to the CLI.

src/cli.ts

@@ -67,6 +67,29 @@ const executeGetter = async (
   console.log(result);
 };
 
+/**
+ * Executes a setter command by handling common steps (authentication, API initialization).
+ * @param options The options passed from the CLI command.
+ * @param setter A function to call on the configured API object.
+ */
+const executeSetter = async (
+  options: { username: string; password?: string; mac: string; value: number },
+  setter: (
+    api: ReturnType<typeof configure>,
+    jwtToken: string,
+    mac: string,
+    value: number
+  ) => Promise<unknown>
+): Promise<void> => {
+  const { username, password, mac, value } = options;
+  const normalizedMac = mac.replace(/:/g, "");
+  const pwd = password || (await promptPassword());
+  const jwtToken = await signIn(username, pwd);
+  const api = configure();
+  const result = await setter(api, jwtToken, normalizedMac, value);
+  console.log(result);
+};
+
 const createProgram = (): Command => {
   const program = new Command();
   program
@@ -125,6 +148,35 @@ const createProgram = (): Command => {
       addAuthOptions(program.command(commandName).description(description))
     ).action((options) => executeGetter(options, getter));
   });
+  // Generic setter commands
+  [
+    {
+      commandName: "setPower",
+      description: "Set the power state of the device (1 for ON, 0 for OFF)",
+      setter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string,
+        value: number
+      ) => api.setPower(jwtToken, mac, value),
+    },
+    {
+      commandName: "setTargetTemperature",
+      description: "Set the target temperature (degree celsius) for a device",
+      setter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string,
+        value: number
+      ) => api.setTargetTemperature(jwtToken, mac, value),
+    },
+  ].forEach(({ commandName, description, setter }) => {
+    addMacOption(
+      addAuthOptions(
+        program.command(commandName).description(description)
+      ).requiredOption("-v, --value <number>", "Value to set", parseFloat)
+    ).action((options) => executeSetter(options, setter));
+  });
 
   return program;
 };

src/index.ts

@@ -18,4 +18,5 @@ export const {
   getPower,
   getEnvironmentTemperature,
   getTargetTemperature,
+  setTargetTemperature,
 } = configure();

src/library.test.ts

@@ -86,6 +86,7 @@ describe("library", () => {
       "getPower",
       "getEnvironmentTemperature",
       "getTargetTemperature",
+      "setTargetTemperature",
     ];
     it("should create API methods with the correct baseURL", () => {
       const baseURL = "https://example.com/api";

src/library.ts

@@ -169,13 +169,29 @@ const getTargetTemperature =
    *
    * @param {string} jwtToken - The JWT token for authentication.
    * @param {string} macAddress - The MAC address of the device.
-   * @returns {Promise<number>} - A promise that resolves to the target temperature.
+   * @returns {Promise<number>} - A promise that resolves to the target temperature (degree celsius).
    */
   async (jwtToken: string, macAddress: string): Promise<number> => {
     const info = await deviceInfo(axiosInstance)(jwtToken, macAddress);
     return info.nvm.user_parameters.enviroment_1_temperature;
   };
 
+const setTargetTemperature =
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Sends a command to set the target temperature (degree celsius) of a device.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @param {number} temperature - The desired target temperature (degree celsius).
+   * @returns {Promise<string>} - A promise that resolves to the command response.
+   */
+  (jwtToken: string, macAddress: string, temperature: number) =>
+    mqttCommand(axiosInstance)(jwtToken, macAddress, {
+      name: "enviroment_1_temperature",
+      value: temperature,
+    });
+
 /**
  * Configures the library for API interactions.
  * Initializes API methods with a specified base URL.
@@ -197,6 +213,7 @@ const configure = (baseURL: string = API_URL) => {
   const getEnvironmentTemperatureInstance =
     getEnvironmentTemperature(axiosInstance);
   const getTargetTemperatureInstance = getTargetTemperature(axiosInstance);
+  const setTargetTemperatureInstance = setTargetTemperature(axiosInstance);
   return {
     deviceInfo: deviceInfoInstance,
     setPower: setPowerInstance,
@@ -205,6 +222,7 @@ const configure = (baseURL: string = API_URL) => {
     getPower: getPowerInstance,
     getEnvironmentTemperature: getEnvironmentTemperatureInstance,
     getTargetTemperature: getTargetTemperatureInstance,
+    setTargetTemperature: setTargetTemperatureInstance,
   };
 };