edilkamin 1.4.1 → 1.5.0

package/dist/esm/cli.js

@@ -39,9 +39,48 @@ const promptPassword = () => {
  * @param command The command to which options should be added.
  * @returns The command with options added.
  */
-const addCommonOptions = (command) => command
+const addAuthOptions = (command) => command
     .requiredOption("-u, --username <username>", "Username")
     .option("-p, --password <password>", "Password");
+/**
+ * Adds MAC address option to a command.
+ * @param command The command to which the MAC address option should be added.
+ * @returns The command with the MAC address option added.
+ */
+const addMacOption = (command) => command.requiredOption("-m, --mac <macAddress>", "MAC address of the device");
+/**
+ * Handles common authentication and API initialization logic.
+ * @param options The options passed from the CLI command.
+ * @returns An object containing the normalized MAC, JWT token, and configured API instance.
+ */
+const initializeCommand = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { username, password, mac } = options;
+    const normalizedMac = mac.replace(/:/g, "");
+    const pwd = password || (yield promptPassword());
+    const jwtToken = yield signIn(username, pwd);
+    const api = configure();
+    return { normalizedMac, jwtToken, api };
+});
+/**
+ * Executes a getter command by handling common steps (authentication, API initialization).
+ * @param options The options passed from the CLI command.
+ * @param getter A function to call on the configured API object.
+ */
+const executeGetter = (options, getter) => __awaiter(void 0, void 0, void 0, function* () {
+    const { normalizedMac, jwtToken, api } = yield initializeCommand(options);
+    const result = yield getter(api, jwtToken, normalizedMac);
+    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 = (options, setter) => __awaiter(void 0, void 0, void 0, function* () {
+    const { normalizedMac, jwtToken, api } = yield initializeCommand(options);
+    const result = yield setter(api, jwtToken, normalizedMac, options.value);
+    console.log(result);
+});
 const createProgram = () => {
     const program = new Command();
     program
@@ -49,25 +88,52 @@ const createProgram = () => {
         .description("CLI tool for interacting with the Edilkamin API")
         .version(version);
     // Command: signIn
-    addCommonOptions(program.command("signIn").description("Sign in and retrieve a JWT token")).action((options) => __awaiter(void 0, void 0, void 0, function* () {
+    addAuthOptions(program.command("signIn").description("Sign in and retrieve a JWT token")).action((options) => __awaiter(void 0, void 0, void 0, function* () {
         const { username, password } = options;
         const pwd = password || (yield promptPassword());
         const jwtToken = yield signIn(username, pwd);
         console.log("JWT Token:", jwtToken);
     }));
-    // Command: deviceInfo
-    addCommonOptions(program
-        .command("deviceInfo")
-        .description("Retrieve device info for a specific MAC address")
-        .requiredOption("-m, --mac <macAddress>", "MAC address of the device")).action((options) => __awaiter(void 0, void 0, void 0, function* () {
-        const { username, password, mac } = options;
-        const normalizedMac = mac.replace(/:/g, "");
-        const pwd = password || (yield promptPassword());
-        const jwtToken = yield signIn(username, pwd);
-        const api = configure(); // Use the default API configuration
-        const deviceInfo = yield api.deviceInfo(jwtToken, normalizedMac);
-        console.log("Device Info:", deviceInfo.data);
-    }));
+    // Generic getter commands
+    [
+        {
+            commandName: "deviceInfo",
+            description: "Retrieve device info for a specific MAC address",
+            getter: (api, jwtToken, mac) => api.deviceInfo(jwtToken, mac),
+        },
+        {
+            commandName: "getPower",
+            description: "Retrieve device power status",
+            getter: (api, jwtToken, mac) => api.getPower(jwtToken, mac),
+        },
+        {
+            commandName: "getEnvironmentTemperature",
+            description: "Retrieve environment temperature",
+            getter: (api, jwtToken, mac) => api.getEnvironmentTemperature(jwtToken, mac),
+        },
+        {
+            commandName: "getTargetTemperature",
+            description: "Retrieve target temperature",
+            getter: (api, jwtToken, mac) => api.getTargetTemperature(jwtToken, mac),
+        },
+    ].forEach(({ commandName, description, getter }) => {
+        addMacOption(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, jwtToken, mac, value) => api.setPower(jwtToken, mac, value),
+        },
+        {
+            commandName: "setTargetTemperature",
+            description: "Set the target temperature (degree celsius) for a device",
+            setter: (api, jwtToken, mac, value) => 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;
 };
 const main = () => {

package/dist/esm/index.d.ts

@@ -1,4 +1,4 @@
 export { API_URL } from "./constants";
 export { configure, signIn } from "./library";
 export { CommandsType, DeviceInfoType, StatusType, TemperaturesType, UserParametersType, } from "./types";
-export declare const deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<import("./types").DeviceInfoType, any>>, setPower: (jwtToken: string, macAddress: string, value: number) => Promise<import("axios").AxiosResponse<any, any>>, setPowerOff: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>, setPowerOn: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>;
+export declare const deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("./types").DeviceInfoType>, setPower: (jwtToken: string, macAddress: string, value: number) => Promise<import("axios").AxiosResponse<any, any>>, setPowerOff: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>, setPowerOn: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>, getPower: (jwtToken: string, macAddress: string) => Promise<boolean>, getEnvironmentTemperature: (jwtToken: string, macAddress: string) => Promise<number>, getTargetTemperature: (jwtToken: string, macAddress: string) => Promise<number>, setTargetTemperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<import("axios").AxiosResponse<any, any>>;

package/dist/esm/index.js

@@ -1,4 +1,4 @@
 import { configure } from "./library";
 export { API_URL } from "./constants";
 export { configure, signIn } from "./library";
-export const { deviceInfo, setPower, setPowerOff, setPowerOn } = configure();
+export const { deviceInfo, setPower, setPowerOff, setPowerOn, getPower, getEnvironmentTemperature, getTargetTemperature, setTargetTemperature, } = configure();

package/dist/esm/library.d.ts

@@ -17,10 +17,25 @@ declare const createAuthService: (auth: typeof amplifyAuth) => {
     signIn: (username: string, password: string) => Promise<string>;
 };
 declare const signIn: (username: string, password: string) => Promise<string>;
+/**
+ * Configures the library for API interactions.
+ * Initializes API methods with a specified base URL.
+ *
+ * @param {string} [baseURL=API_URL] - The base URL for the API.
+ * @returns {object} - An object containing methods for interacting with the API.
+ *
+ * @example
+ * const api = configure();
+ * const power = await api.getPower(jwtToken, macAddress);
+ */
 declare const configure: (baseURL?: string) => {
-    deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<DeviceInfoType, any>>;
+    deviceInfo: (jwtToken: string, macAddress: string) => Promise<DeviceInfoType>;
     setPower: (jwtToken: string, macAddress: string, value: number) => Promise<import("axios").AxiosResponse<any, any>>;
     setPowerOff: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>;
     setPowerOn: (jwtToken: string, macAddress: string) => Promise<import("axios").AxiosResponse<any, any>>;
+    getPower: (jwtToken: string, macAddress: string) => Promise<boolean>;
+    getEnvironmentTemperature: (jwtToken: string, macAddress: string) => Promise<number>;
+    getTargetTemperature: (jwtToken: string, macAddress: string) => Promise<number>;
+    setTargetTemperature: (jwtToken: string, macAddress: string, temperature: number) => Promise<import("axios").AxiosResponse<any, any>>;
 };
 export { configure, createAuthService, headers, signIn };

package/dist/esm/library.js

@@ -59,26 +59,138 @@ const createAuthService = (auth) => {
 };
 // Create the default auth service using amplifyAuth
 const { signIn } = createAuthService(amplifyAuth);
-const deviceInfo = (axiosInstance) => (jwtToken, macAddress) => axiosInstance.get(`device/${macAddress}/info`, {
-    headers: headers(jwtToken),
+const deviceInfo = (axiosInstance) => 
+/**
+ * Retrieves information about a device by its MAC address.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<DeviceInfoType>} - A promise that resolves to the device info.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const response = yield axiosInstance.get(`device/${macAddress}/info`, {
+        headers: headers(jwtToken),
+    });
+    return response.data;
 });
 const mqttCommand = (axiosInstance) => 
 // eslint-disable-next-line  @typescript-eslint/no-explicit-any
 (jwtToken, macAddress, payload) => axiosInstance.put("mqtt/command", Object.assign({ mac_address: macAddress }, payload), { headers: headers(jwtToken) });
-const setPower = (axiosInstance) => (jwtToken, macAddress, value) => mqttCommand(axiosInstance)(jwtToken, macAddress, { name: "power", value });
-const setPowerOn = (axiosInstance) => (jwtToken, macAddress) => setPower(axiosInstance)(jwtToken, macAddress, 1);
-const setPowerOff = (axiosInstance) => (jwtToken, macAddress) => setPower(axiosInstance)(jwtToken, macAddress, 0);
+const setPower = (axiosInstance) => 
+/**
+ * Sends a command to set the power state of a device.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @param {number} value - The desired power state (1 for ON, 0 for OFF).
+ * @returns {Promise<string>} - A promise that resolves to the command response.
+ */
+(jwtToken, macAddress, value) => mqttCommand(axiosInstance)(jwtToken, macAddress, { name: "power", value });
+const setPowerOn = (axiosInstance) => 
+/**
+ * Turns a device ON by setting its power state.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<string>} - A promise that resolves to the command response.
+ *
+ * @example
+ * const response = await api.setPowerOn(jwtToken, macAddress);
+ * console.log(response);
+ */
+(jwtToken, macAddress) => setPower(axiosInstance)(jwtToken, macAddress, 1);
+const setPowerOff = (axiosInstance) => 
+/**
+ * Turns a device OFF by setting its power state.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<string>} - A promise that resolves to the command response.
+ *
+ * @example
+ * const response = await api.setPowerOff(jwtToken, macAddress);
+ * console.log(response);
+ */
+(jwtToken, macAddress) => setPower(axiosInstance)(jwtToken, macAddress, 0);
+const getPower = (axiosInstance) => 
+/**
+ * Retrieves the power status of the device.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device.
+ * @returns {Promise<boolean>} - A promise that resolves to the power status.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(axiosInstance)(jwtToken, macAddress);
+    return info.status.commands.power;
+});
+const getEnvironmentTemperature = (axiosInstance) => 
+/**
+ * Retrieves the environment temperature from the device's sensors.
+ *
+ * @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 temperature value.
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(axiosInstance)(jwtToken, macAddress);
+    return info.status.temperatures.enviroment;
+});
+const getTargetTemperature = (axiosInstance) => 
+/**
+ * Retrieves the target temperature value set on the device.
+ *
+ * @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 (degree celsius).
+ */
+(jwtToken, macAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    const info = yield deviceInfo(axiosInstance)(jwtToken, macAddress);
+    return info.nvm.user_parameters.enviroment_1_temperature;
+});
+const setTargetTemperature = (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, macAddress, temperature) => mqttCommand(axiosInstance)(jwtToken, macAddress, {
+    name: "enviroment_1_temperature",
+    value: temperature,
+});
+/**
+ * Configures the library for API interactions.
+ * Initializes API methods with a specified base URL.
+ *
+ * @param {string} [baseURL=API_URL] - The base URL for the API.
+ * @returns {object} - An object containing methods for interacting with the API.
+ *
+ * @example
+ * const api = configure();
+ * const power = await api.getPower(jwtToken, macAddress);
+ */
 const configure = (baseURL = API_URL) => {
     const axiosInstance = axios.create({ baseURL });
     const deviceInfoInstance = deviceInfo(axiosInstance);
     const setPowerInstance = setPower(axiosInstance);
     const setPowerOffInstance = setPowerOff(axiosInstance);
     const setPowerOnInstance = setPowerOn(axiosInstance);
+    const getPowerInstance = getPower(axiosInstance);
+    const getEnvironmentTemperatureInstance = getEnvironmentTemperature(axiosInstance);
+    const getTargetTemperatureInstance = getTargetTemperature(axiosInstance);
+    const setTargetTemperatureInstance = setTargetTemperature(axiosInstance);
     return {
         deviceInfo: deviceInfoInstance,
         setPower: setPowerInstance,
         setPowerOff: setPowerOffInstance,
         setPowerOn: setPowerOnInstance,
+        getPower: getPowerInstance,
+        getEnvironmentTemperature: getEnvironmentTemperatureInstance,
+        getTargetTemperature: getTargetTemperatureInstance,
+        setTargetTemperature: setTargetTemperatureInstance,
     };
 };
 export { configure, createAuthService, headers, signIn };

package/dist/esm/library.test.js

@@ -14,6 +14,7 @@ import { configure, createAuthService } from "../src/library";
 import { API_URL } from "./constants";
 describe("library", () => {
     let axiosStub;
+    const expectedToken = "mockJwtToken";
     beforeEach(() => {
         axiosStub = sinon.stub(axios, "create").returns({
             get: sinon.stub(),
@@ -28,7 +29,6 @@ describe("library", () => {
         it("should sign in and return the JWT token", () => __awaiter(void 0, void 0, void 0, function* () {
             const expectedUsername = "testuser";
             const expectedPassword = "testpassword";
-            const expectedToken = "mockJwtToken";
             const signIn = sinon.stub().resolves({ isSignedIn: true });
             const signOut = sinon.stub();
             const fetchAuthSession = sinon.stub().resolves({
@@ -53,7 +53,6 @@ describe("library", () => {
         it("should throw an error if sign-in fails", () => __awaiter(void 0, void 0, void 0, function* () {
             const expectedUsername = "testuser";
             const expectedPassword = "testpassword";
-            const expectedToken = "mockJwtToken";
             const signIn = sinon.stub().resolves({ isSignedIn: false });
             const signOut = sinon.stub();
             const fetchAuthSession = sinon.stub().resolves({
@@ -75,6 +74,16 @@ describe("library", () => {
         }));
     });
     describe("configure", () => {
+        const expectedApi = [
+            "deviceInfo",
+            "setPower",
+            "setPowerOff",
+            "setPowerOn",
+            "getPower",
+            "getEnvironmentTemperature",
+            "getTargetTemperature",
+            "setTargetTemperature",
+        ];
         it("should create API methods with the correct baseURL", () => {
             const baseURL = "https://example.com/api";
             const api = configure(baseURL);
@@ -85,12 +94,7 @@ describe("library", () => {
                     },
                 ],
             ]);
-            assert.deepEqual(Object.keys(api), [
-                "deviceInfo",
-                "setPower",
-                "setPowerOff",
-                "setPowerOn",
-            ]);
+            assert.deepEqual(Object.keys(api), expectedApi);
         });
         it("should create API methods with the default baseURL", () => {
             const api = configure();
@@ -101,20 +105,28 @@ describe("library", () => {
                     },
                 ],
             ]);
-            assert.deepEqual(Object.keys(api), [
-                "deviceInfo",
-                "setPower",
-                "setPowerOff",
-                "setPowerOn",
-            ]);
+            assert.deepEqual(Object.keys(api), expectedApi);
         });
     });
     describe("API Methods", () => {
+        const mockDeviceInfo = {
+            status: {
+                commands: {
+                    power: true,
+                },
+                temperatures: {
+                    enviroment: 19,
+                },
+            },
+            nvm: {
+                user_parameters: {
+                    enviroment_1_temperature: 22,
+                },
+            },
+        };
         it("should call axios for deviceInfo", () => __awaiter(void 0, void 0, void 0, function* () {
-            const expectedDevice = { id: "123", name: "Mock Device" };
-            const expectedToken = "mockToken";
             const mockAxios = {
-                get: sinon.stub().resolves({ data: expectedDevice }),
+                get: sinon.stub().resolves({ data: mockDeviceInfo }),
             };
             axiosStub.returns(mockAxios);
             const api = configure("https://example.com/api");
@@ -125,7 +137,7 @@ describe("library", () => {
                     { headers: { Authorization: `Bearer ${expectedToken}` } },
                 ],
             ]);
-            assert.deepEqual(result.data, expectedDevice);
+            assert.deepEqual(result, mockDeviceInfo);
         }));
         // Tests for setPowerOn and setPowerOff
         [
@@ -164,5 +176,70 @@ describe("library", () => {
                 assert.equal(result.status, 200);
             }));
         });
+        const getterTests = [
+            {
+                method: "getPower",
+                call: (api, token, mac) => api.getPower(token, mac),
+                expectedResult: true,
+            },
+            {
+                method: "getEnvironmentTemperature",
+                call: (api, token, mac) => api.getEnvironmentTemperature(token, mac),
+                expectedResult: 19,
+            },
+            {
+                method: "getTargetTemperature",
+                call: (api, token, mac) => api.getTargetTemperature(token, mac),
+                expectedResult: 22,
+            },
+        ];
+        getterTests.forEach(({ method, call, expectedResult }) => {
+            it(`should call axios and return the correct value for ${method}`, () => __awaiter(void 0, void 0, void 0, function* () {
+                const mockAxios = {
+                    get: sinon.stub().resolves({ data: mockDeviceInfo }),
+                };
+                axiosStub.returns(mockAxios);
+                const api = configure("https://example.com/api");
+                const result = yield call(api, expectedToken, "mockMacAddress");
+                assert.deepEqual(mockAxios.get.args, [
+                    [
+                        "device/mockMacAddress/info",
+                        { headers: { Authorization: `Bearer ${expectedToken}` } },
+                    ],
+                ]);
+                assert.equal(result, expectedResult);
+            }));
+        });
+        // Setter tests
+        const setterTests = [
+            {
+                method: "setTargetTemperature",
+                call: (api, token, mac, value) => api.setTargetTemperature(token, mac, value),
+                payload: {
+                    name: "enviroment_1_temperature",
+                    value: 20,
+                },
+            },
+        ];
+        setterTests.forEach(({ method, call, payload }) => {
+            it(`should call axios and send the correct payload for ${method}`, () => __awaiter(void 0, void 0, void 0, function* () {
+                const mockAxios = {
+                    put: sinon.stub().resolves({ status: 200 }),
+                };
+                axiosStub.returns(mockAxios);
+                const api = configure("https://example.com/api");
+                const result = yield call(api, expectedToken, "mockMacAddress", payload.value);
+                assert.deepEqual(mockAxios.put.args, [
+                    [
+                        "mqtt/command",
+                        Object.assign({ mac_address: "mockMacAddress" }, payload),
+                        {
+                            headers: { Authorization: `Bearer ${expectedToken}` },
+                        },
+                    ],
+                ]);
+                assert.equal(result.status, 200);
+            }));
+        });
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edilkamin",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/cli.ts

@@ -32,11 +32,78 @@ const promptPassword = (): Promise<string> => {
  * @param command The command to which options should be added.
  * @returns The command with options added.
  */
-const addCommonOptions = (command: Command): Command =>
+const addAuthOptions = (command: Command): Command =>
   command
     .requiredOption("-u, --username <username>", "Username")
     .option("-p, --password <password>", "Password");
 
+/**
+ * Adds MAC address option to a command.
+ * @param command The command to which the MAC address option should be added.
+ * @returns The command with the MAC address option added.
+ */
+const addMacOption = (command: Command): Command =>
+  command.requiredOption("-m, --mac <macAddress>", "MAC address of the device");
+
+/**
+ * Handles common authentication and API initialization logic.
+ * @param options The options passed from the CLI command.
+ * @returns An object containing the normalized MAC, JWT token, and configured API instance.
+ */
+const initializeCommand = async (options: {
+  username: string;
+  password?: string;
+  mac: string;
+}): Promise<{
+  normalizedMac: string;
+  jwtToken: string;
+  api: ReturnType<typeof configure>;
+}> => {
+  const { username, password, mac } = options;
+  const normalizedMac = mac.replace(/:/g, "");
+  const pwd = password || (await promptPassword());
+  const jwtToken = await signIn(username, pwd);
+  const api = configure();
+  return { normalizedMac, jwtToken, api };
+};
+
+/**
+ * Executes a getter command by handling common steps (authentication, API initialization).
+ * @param options The options passed from the CLI command.
+ * @param getter A function to call on the configured API object.
+ */
+const executeGetter = async (
+  options: { username: string; password?: string; mac: string },
+  getter: (
+    api: ReturnType<typeof configure>,
+    jwtToken: string,
+    mac: string
+  ) => Promise<unknown>
+): Promise<void> => {
+  const { normalizedMac, jwtToken, api } = await initializeCommand(options);
+  const result = await getter(api, jwtToken, normalizedMac);
+  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 { normalizedMac, jwtToken, api } = await initializeCommand(options);
+  const result = await setter(api, jwtToken, normalizedMac, options.value);
+  console.log(result);
+};
+
 const createProgram = (): Command => {
   const program = new Command();
   program
@@ -44,7 +111,7 @@ const createProgram = (): Command => {
     .description("CLI tool for interacting with the Edilkamin API")
     .version(version);
   // Command: signIn
-  addCommonOptions(
+  addAuthOptions(
     program.command("signIn").description("Sign in and retrieve a JWT token")
   ).action(async (options) => {
     const { username, password } = options;
@@ -52,21 +119,79 @@ const createProgram = (): Command => {
     const jwtToken = await signIn(username, pwd);
     console.log("JWT Token:", jwtToken);
   });
-  // Command: deviceInfo
-  addCommonOptions(
-    program
-      .command("deviceInfo")
-      .description("Retrieve device info for a specific MAC address")
-      .requiredOption("-m, --mac <macAddress>", "MAC address of the device")
-  ).action(async (options) => {
-    const { username, password, mac } = options;
-    const normalizedMac = mac.replace(/:/g, "");
-    const pwd = password || (await promptPassword());
-    const jwtToken = await signIn(username, pwd);
-    const api = configure(); // Use the default API configuration
-    const deviceInfo = await api.deviceInfo(jwtToken, normalizedMac);
-    console.log("Device Info:", deviceInfo.data);
+  // Generic getter commands
+  [
+    {
+      commandName: "deviceInfo",
+      description: "Retrieve device info for a specific MAC address",
+      getter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string
+      ) => api.deviceInfo(jwtToken, mac),
+    },
+    {
+      commandName: "getPower",
+      description: "Retrieve device power status",
+      getter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string
+      ) => api.getPower(jwtToken, mac),
+    },
+    {
+      commandName: "getEnvironmentTemperature",
+      description: "Retrieve environment temperature",
+      getter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string
+      ) => api.getEnvironmentTemperature(jwtToken, mac),
+    },
+    {
+      commandName: "getTargetTemperature",
+      description: "Retrieve target temperature",
+      getter: (
+        api: ReturnType<typeof configure>,
+        jwtToken: string,
+        mac: string
+      ) => api.getTargetTemperature(jwtToken, mac),
+    },
+  ].forEach(({ commandName, description, getter }) => {
+    addMacOption(
+      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;
 };
 

package/src/index.ts

@@ -10,4 +10,13 @@ export {
   UserParametersType,
 } from "./types";
 
-export const { deviceInfo, setPower, setPowerOff, setPowerOn } = configure();
+export const {
+  deviceInfo,
+  setPower,
+  setPowerOff,
+  setPowerOn,
+  getPower,
+  getEnvironmentTemperature,
+  getTargetTemperature,
+  setTargetTemperature,
+} = configure();

package/src/library.test.ts

@@ -7,6 +7,7 @@ import { API_URL } from "./constants";
 
 describe("library", () => {
   let axiosStub: sinon.SinonStub;
+  const expectedToken = "mockJwtToken";
 
   beforeEach(() => {
     axiosStub = sinon.stub(axios, "create").returns({
@@ -24,7 +25,6 @@ describe("library", () => {
     it("should sign in and return the JWT token", async () => {
       const expectedUsername = "testuser";
       const expectedPassword = "testpassword";
-      const expectedToken = "mockJwtToken";
       const signIn = sinon.stub().resolves({ isSignedIn: true });
       const signOut = sinon.stub();
       const fetchAuthSession = sinon.stub().resolves({
@@ -53,7 +53,6 @@ describe("library", () => {
     it("should throw an error if sign-in fails", async () => {
       const expectedUsername = "testuser";
       const expectedPassword = "testpassword";
-      const expectedToken = "mockJwtToken";
       const signIn = sinon.stub().resolves({ isSignedIn: false });
       const signOut = sinon.stub();
       const fetchAuthSession = sinon.stub().resolves({
@@ -79,6 +78,16 @@ describe("library", () => {
   });
 
   describe("configure", () => {
+    const expectedApi = [
+      "deviceInfo",
+      "setPower",
+      "setPowerOff",
+      "setPowerOn",
+      "getPower",
+      "getEnvironmentTemperature",
+      "getTargetTemperature",
+      "setTargetTemperature",
+    ];
     it("should create API methods with the correct baseURL", () => {
       const baseURL = "https://example.com/api";
       const api = configure(baseURL);
@@ -89,12 +98,7 @@ describe("library", () => {
           },
         ],
       ]);
-      assert.deepEqual(Object.keys(api), [
-        "deviceInfo",
-        "setPower",
-        "setPowerOff",
-        "setPowerOn",
-      ]);
+      assert.deepEqual(Object.keys(api), expectedApi);
     });
     it("should create API methods with the default baseURL", () => {
       const api = configure();
@@ -105,21 +109,30 @@ describe("library", () => {
           },
         ],
       ]);
-      assert.deepEqual(Object.keys(api), [
-        "deviceInfo",
-        "setPower",
-        "setPowerOff",
-        "setPowerOn",
-      ]);
+      assert.deepEqual(Object.keys(api), expectedApi);
     });
   });
 
   describe("API Methods", () => {
+    const mockDeviceInfo = {
+      status: {
+        commands: {
+          power: true,
+        },
+        temperatures: {
+          enviroment: 19,
+        },
+      },
+      nvm: {
+        user_parameters: {
+          enviroment_1_temperature: 22,
+        },
+      },
+    };
+
     it("should call axios for deviceInfo", async () => {
-      const expectedDevice = { id: "123", name: "Mock Device" };
-      const expectedToken = "mockToken";
       const mockAxios = {
-        get: sinon.stub().resolves({ data: expectedDevice }),
+        get: sinon.stub().resolves({ data: mockDeviceInfo }),
       };
       axiosStub.returns(mockAxios);
       const api = configure("https://example.com/api");
@@ -130,7 +143,7 @@ describe("library", () => {
           { headers: { Authorization: `Bearer ${expectedToken}` } },
         ],
       ]);
-      assert.deepEqual(result.data, expectedDevice);
+      assert.deepEqual(result, mockDeviceInfo);
     });
 
     // Tests for setPowerOn and setPowerOff
@@ -173,5 +186,91 @@ describe("library", () => {
         assert.equal(result.status, 200);
       });
     });
+
+    const getterTests = [
+      {
+        method: "getPower",
+        call: (api: ReturnType<typeof configure>, token: string, mac: string) =>
+          api.getPower(token, mac),
+        expectedResult: true,
+      },
+      {
+        method: "getEnvironmentTemperature",
+        call: (api: ReturnType<typeof configure>, token: string, mac: string) =>
+          api.getEnvironmentTemperature(token, mac),
+        expectedResult: 19,
+      },
+      {
+        method: "getTargetTemperature",
+        call: (api: ReturnType<typeof configure>, token: string, mac: string) =>
+          api.getTargetTemperature(token, mac),
+        expectedResult: 22,
+      },
+    ];
+    getterTests.forEach(({ method, call, expectedResult }) => {
+      it(`should call axios and return the correct value for ${method}`, async () => {
+        const mockAxios = {
+          get: sinon.stub().resolves({ data: mockDeviceInfo }),
+        };
+        axiosStub.returns(mockAxios);
+        const api = configure("https://example.com/api");
+
+        const result = await call(api, expectedToken, "mockMacAddress");
+
+        assert.deepEqual(mockAxios.get.args, [
+          [
+            "device/mockMacAddress/info",
+            { headers: { Authorization: `Bearer ${expectedToken}` } },
+          ],
+        ]);
+        assert.equal(result, expectedResult);
+      });
+    });
+    // Setter tests
+    const setterTests = [
+      {
+        method: "setTargetTemperature",
+        call: (
+          api: ReturnType<typeof configure>,
+          token: string,
+          mac: string,
+          value: number
+        ) => api.setTargetTemperature(token, mac, value),
+        payload: {
+          name: "enviroment_1_temperature",
+          value: 20,
+        },
+      },
+    ];
+    setterTests.forEach(({ method, call, payload }) => {
+      it(`should call axios and send the correct payload for ${method}`, async () => {
+        const mockAxios = {
+          put: sinon.stub().resolves({ status: 200 }),
+        };
+        axiosStub.returns(mockAxios);
+        const api = configure("https://example.com/api");
+
+        const result = await call(
+          api,
+          expectedToken,
+          "mockMacAddress",
+          payload.value
+        );
+
+        assert.deepEqual(mockAxios.put.args, [
+          [
+            "mqtt/command",
+            {
+              mac_address: "mockMacAddress",
+              ...payload,
+            },
+            {
+              headers: { Authorization: `Bearer ${expectedToken}` },
+            },
+          ],
+        ]);
+        assert.equal(result.status, 200);
+      });
+    });
   });
 });

package/src/library.ts

@@ -61,10 +61,23 @@ const createAuthService = (auth: typeof amplifyAuth) => {
 const { signIn } = createAuthService(amplifyAuth);
 
 const deviceInfo =
-  (axiosInstance: AxiosInstance) => (jwtToken: string, macAddress: string) =>
-    axiosInstance.get<DeviceInfoType>(`device/${macAddress}/info`, {
-      headers: headers(jwtToken),
-    });
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Retrieves information about a device by its MAC address.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @returns {Promise<DeviceInfoType>} - A promise that resolves to the device info.
+   */
+  async (jwtToken: string, macAddress: string) => {
+    const response = await axiosInstance.get<DeviceInfoType>(
+      `device/${macAddress}/info`,
+      {
+        headers: headers(jwtToken),
+      }
+    );
+    return response.data;
+  };
 
 const mqttCommand =
   (axiosInstance: AxiosInstance) =>
@@ -78,27 +91,138 @@ const mqttCommand =
 
 const setPower =
   (axiosInstance: AxiosInstance) =>
+  /**
+   * Sends a command to set the power state of a device.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @param {number} value - The desired power state (1 for ON, 0 for OFF).
+   * @returns {Promise<string>} - A promise that resolves to the command response.
+   */
   (jwtToken: string, macAddress: string, value: number) =>
     mqttCommand(axiosInstance)(jwtToken, macAddress, { name: "power", value });
 
 const setPowerOn =
-  (axiosInstance: AxiosInstance) => (jwtToken: string, macAddress: string) =>
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Turns a device ON by setting its power state.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @returns {Promise<string>} - A promise that resolves to the command response.
+   *
+   * @example
+   * const response = await api.setPowerOn(jwtToken, macAddress);
+   * console.log(response);
+   */
+  (jwtToken: string, macAddress: string) =>
     setPower(axiosInstance)(jwtToken, macAddress, 1);
+
 const setPowerOff =
-  (axiosInstance: AxiosInstance) => (jwtToken: string, macAddress: string) =>
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Turns a device OFF by setting its power state.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @returns {Promise<string>} - A promise that resolves to the command response.
+   *
+   * @example
+   * const response = await api.setPowerOff(jwtToken, macAddress);
+   * console.log(response);
+   */
+  (jwtToken: string, macAddress: string) =>
     setPower(axiosInstance)(jwtToken, macAddress, 0);
 
+const getPower =
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Retrieves the power status of the device.
+   *
+   * @param {string} jwtToken - The JWT token for authentication.
+   * @param {string} macAddress - The MAC address of the device.
+   * @returns {Promise<boolean>} - A promise that resolves to the power status.
+   */
+  async (jwtToken: string, macAddress: string): Promise<boolean> => {
+    const info = await deviceInfo(axiosInstance)(jwtToken, macAddress);
+    return info.status.commands.power;
+  };
+
+const getEnvironmentTemperature =
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Retrieves the environment temperature from the device's sensors.
+   *
+   * @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 temperature value.
+   */
+  async (jwtToken: string, macAddress: string): Promise<number> => {
+    const info = await deviceInfo(axiosInstance)(jwtToken, macAddress);
+    return info.status.temperatures.enviroment;
+  };
+
+const getTargetTemperature =
+  (axiosInstance: AxiosInstance) =>
+  /**
+   * Retrieves the target temperature value set on the device.
+   *
+   * @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 (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.
+ *
+ * @param {string} [baseURL=API_URL] - The base URL for the API.
+ * @returns {object} - An object containing methods for interacting with the API.
+ *
+ * @example
+ * const api = configure();
+ * const power = await api.getPower(jwtToken, macAddress);
+ */
 const configure = (baseURL: string = API_URL) => {
   const axiosInstance = axios.create({ baseURL });
   const deviceInfoInstance = deviceInfo(axiosInstance);
   const setPowerInstance = setPower(axiosInstance);
   const setPowerOffInstance = setPowerOff(axiosInstance);
   const setPowerOnInstance = setPowerOn(axiosInstance);
+  const getPowerInstance = getPower(axiosInstance);
+  const getEnvironmentTemperatureInstance =
+    getEnvironmentTemperature(axiosInstance);
+  const getTargetTemperatureInstance = getTargetTemperature(axiosInstance);
+  const setTargetTemperatureInstance = setTargetTemperature(axiosInstance);
   return {
     deviceInfo: deviceInfoInstance,
     setPower: setPowerInstance,
     setPowerOff: setPowerOffInstance,
     setPowerOn: setPowerOnInstance,
+    getPower: getPowerInstance,
+    getEnvironmentTemperature: getEnvironmentTemperatureInstance,
+    getTargetTemperature: getTargetTemperatureInstance,
+    setTargetTemperature: setTargetTemperatureInstance,
   };
 };