edilkamin 1.6.1 → 1.6.2

package/README.md

@@ -61,6 +61,36 @@ Or with `npx` once the library is installed:
 npx edilkamin deviceInfo --mac $MAC --username $USERNAME --password $PASSWORD
 ```
 
+## API Versions
+
+This library supports both the new and legacy Edilkamin API endpoints.
+
+### CLI Usage
+
+```sh
+# New API (default)
+yarn cli deviceInfo --mac $MAC --username $USERNAME --password $PASSWORD
+
+# Legacy API
+yarn cli deviceInfo --mac $MAC --username $USERNAME --password $PASSWORD --legacy
+```
+
+### Library Usage
+
+```js
+import { configure, signIn, OLD_API_URL, NEW_API_URL } from "edilkamin";
+
+// New API (default)
+const token = await signIn(username, password);
+const api = configure();
+
+// Legacy API
+const legacyToken = await signIn(username, password, true);
+const legacyApi = configure(OLD_API_URL);
+```
+
+> **Note**: The legacy API uses AWS API Gateway and may be deprecated in the future.
+
 ## Motivations
 
 - providing an open source web alternative

package/dist/esm/buffer-utils.d.ts

@@ -0,0 +1,25 @@
+import { BufferEncodedType } from "./types";
+/**
+ * Type guard to check if a value is a serialized Node.js Buffer.
+ * Node.js Buffers serialize to JSON as: {type: "Buffer", data: [...]}
+ *
+ * @param value - The value to check
+ * @returns True if the value is a Buffer-encoded object
+ */
+declare const isBuffer: (value: unknown) => value is BufferEncodedType;
+/**
+ * Decompresses a Buffer-encoded gzip object and parses the resulting JSON.
+ *
+ * @param bufferObj - A serialized Buffer object containing gzip data
+ * @returns The decompressed and parsed JSON data, or the original object on failure
+ */
+declare const decompressBuffer: (bufferObj: BufferEncodedType) => unknown;
+/**
+ * Recursively processes an API response to decompress any Buffer-encoded fields.
+ * Handles nested objects and arrays, preserving structure while decompressing.
+ *
+ * @param data - The API response data to process
+ * @returns The processed data with all Buffer fields decompressed
+ */
+declare const processResponse: <T>(data: T) => T;
+export { decompressBuffer, isBuffer, processResponse };

package/dist/esm/buffer-utils.js

@@ -0,0 +1,70 @@
+import pako from "pako";
+/**
+ * Type guard to check if a value is a serialized Node.js Buffer.
+ * Node.js Buffers serialize to JSON as: {type: "Buffer", data: [...]}
+ *
+ * @param value - The value to check
+ * @returns True if the value is a Buffer-encoded object
+ */
+const isBuffer = (value) => {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        value.type === "Buffer" &&
+        "data" in value &&
+        Array.isArray(value.data));
+};
+/**
+ * Decompresses a Buffer-encoded gzip object and parses the resulting JSON.
+ *
+ * @param bufferObj - A serialized Buffer object containing gzip data
+ * @returns The decompressed and parsed JSON data, or the original object on failure
+ */
+const decompressBuffer = (bufferObj) => {
+    try {
+        // Convert data array to Uint8Array for pako
+        const compressed = new Uint8Array(bufferObj.data);
+        // Decompress with gzip
+        const decompressed = pako.ungzip(compressed, { to: "string" });
+        // Parse JSON
+        return JSON.parse(decompressed);
+    }
+    catch (error) {
+        // Log warning but return original to maintain backward compatibility
+        console.warn("Failed to decompress buffer:", error);
+        return bufferObj;
+    }
+};
+/**
+ * Recursively processes an API response to decompress any Buffer-encoded fields.
+ * Handles nested objects and arrays, preserving structure while decompressing.
+ *
+ * @param data - The API response data to process
+ * @returns The processed data with all Buffer fields decompressed
+ */
+const processResponse = (data) => {
+    if (data === null || data === undefined) {
+        return data;
+    }
+    // Check if this is a Buffer object
+    if (isBuffer(data)) {
+        const decompressed = decompressBuffer(data);
+        // Recursively process the decompressed result (may contain nested buffers)
+        return processResponse(decompressed);
+    }
+    // Recursively process arrays
+    if (Array.isArray(data)) {
+        return data.map((item) => processResponse(item));
+    }
+    // Recursively process objects
+    if (typeof data === "object") {
+        const processed = {};
+        for (const [key, value] of Object.entries(data)) {
+            processed[key] = processResponse(value);
+        }
+        return processed;
+    }
+    // Primitive value, return as-is
+    return data;
+};
+export { decompressBuffer, isBuffer, processResponse };

package/dist/esm/buffer-utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/buffer-utils.test.js

@@ -0,0 +1,181 @@
+import { strict as assert } from "assert";
+import pako from "pako";
+import sinon from "sinon";
+import { decompressBuffer, isBuffer, processResponse } from "./buffer-utils";
+/**
+ * Helper to create a gzip-compressed Buffer object for testing.
+ */
+const createGzippedBuffer = (data) => {
+    const json = JSON.stringify(data);
+    const compressed = pako.gzip(json);
+    return {
+        type: "Buffer",
+        data: Array.from(compressed),
+    };
+};
+describe("buffer-utils", () => {
+    afterEach(() => {
+        sinon.restore();
+    });
+    describe("isBuffer", () => {
+        it("should detect valid Buffer objects", () => {
+            const buffer = { type: "Buffer", data: [31, 139, 8, 0] };
+            assert.ok(isBuffer(buffer));
+        });
+        it("should detect empty Buffer objects", () => {
+            const buffer = { type: "Buffer", data: [] };
+            assert.ok(isBuffer(buffer));
+        });
+        it("should reject non-Buffer objects with wrong type", () => {
+            assert.ok(!isBuffer({ type: "NotBuffer", data: [] }));
+        });
+        it("should reject objects without type field", () => {
+            assert.ok(!isBuffer({ data: [1, 2, 3] }));
+        });
+        it("should reject objects without data field", () => {
+            assert.ok(!isBuffer({ type: "Buffer" }));
+        });
+        it("should reject objects with non-array data", () => {
+            assert.ok(!isBuffer({ type: "Buffer", data: "not an array" }));
+        });
+        it("should reject null", () => {
+            assert.ok(!isBuffer(null));
+        });
+        it("should reject undefined", () => {
+            assert.ok(!isBuffer(undefined));
+        });
+        it("should reject primitives", () => {
+            assert.ok(!isBuffer("string"));
+            assert.ok(!isBuffer(123));
+            assert.ok(!isBuffer(true));
+        });
+    });
+    describe("decompressBuffer", () => {
+        it("should decompress gzipped JSON buffer", () => {
+            const originalData = { test: "value", nested: { key: 123 } };
+            const bufferObj = createGzippedBuffer(originalData);
+            const result = decompressBuffer(bufferObj);
+            assert.deepEqual(result, originalData);
+        });
+        it("should handle gzipped arrays", () => {
+            const originalData = [1, 2, 3, "test"];
+            const bufferObj = createGzippedBuffer(originalData);
+            const result = decompressBuffer(bufferObj);
+            assert.deepEqual(result, originalData);
+        });
+        it("should handle gzipped strings", () => {
+            const originalData = "test string";
+            const bufferObj = createGzippedBuffer(originalData);
+            const result = decompressBuffer(bufferObj);
+            assert.equal(result, originalData);
+        });
+        it("should return original value if decompression fails", () => {
+            const consoleWarnStub = sinon.stub(console, "warn");
+            const invalidBuffer = { type: "Buffer", data: [1, 2, 3] };
+            const result = decompressBuffer(invalidBuffer);
+            assert.deepEqual(result, invalidBuffer);
+            assert.ok(consoleWarnStub.calledOnce);
+        });
+        it("should return original value if JSON parsing fails", () => {
+            const consoleWarnStub = sinon.stub(console, "warn");
+            // Create valid gzip but invalid JSON
+            const invalidJson = "not valid json {";
+            const compressed = pako.gzip(invalidJson);
+            const bufferObj = {
+                type: "Buffer",
+                data: Array.from(compressed),
+            };
+            const result = decompressBuffer(bufferObj);
+            assert.deepEqual(result, bufferObj);
+            assert.ok(consoleWarnStub.calledOnce);
+        });
+    });
+    describe("processResponse", () => {
+        it("should pass through null", () => {
+            assert.equal(processResponse(null), null);
+        });
+        it("should pass through undefined", () => {
+            assert.equal(processResponse(undefined), undefined);
+        });
+        it("should pass through primitives", () => {
+            assert.equal(processResponse("string"), "string");
+            assert.equal(processResponse(123), 123);
+            assert.equal(processResponse(true), true);
+        });
+        it("should pass through plain objects", () => {
+            const obj = { key: "value", nested: { num: 42 } };
+            assert.deepEqual(processResponse(obj), obj);
+        });
+        it("should pass through plain arrays", () => {
+            const arr = [1, "two", { three: 3 }];
+            assert.deepEqual(processResponse(arr), arr);
+        });
+        it("should decompress Buffer at root level", () => {
+            const originalData = { decompressed: true };
+            const buffer = createGzippedBuffer(originalData);
+            const result = processResponse(buffer);
+            assert.deepEqual(result, originalData);
+        });
+        it("should decompress nested Buffer fields", () => {
+            const statusData = { commands: { power: true } };
+            const response = {
+                plain: "data",
+                status: createGzippedBuffer(statusData),
+            };
+            const result = processResponse(response);
+            assert.equal(result.plain, "data");
+            assert.deepEqual(result.status, statusData);
+        });
+        it("should recursively decompress deeply nested Buffers", () => {
+            const innerData = { value: 42 };
+            const middleData = { inner: createGzippedBuffer(innerData) };
+            const response = {
+                outer: createGzippedBuffer(middleData),
+            };
+            const result = processResponse(response);
+            assert.deepEqual(result, { outer: { inner: { value: 42 } } });
+        });
+        it("should handle arrays containing Buffers", () => {
+            const itemData = { id: 1 };
+            const response = {
+                items: [createGzippedBuffer(itemData), { id: 2 }],
+            };
+            const result = processResponse(response);
+            assert.deepEqual(result.items, [{ id: 1 }, { id: 2 }]);
+        });
+        it("should handle mixed compressed and uncompressed fields", () => {
+            const compressedStatus = { commands: { power: true } };
+            const response = {
+                status: createGzippedBuffer(compressedStatus),
+                nvm: { user_parameters: { temperature: 22 } },
+                plain_field: "unchanged",
+            };
+            const result = processResponse(response);
+            assert.deepEqual(result.status, compressedStatus);
+            assert.deepEqual(result.nvm, { user_parameters: { temperature: 22 } });
+            assert.equal(result.plain_field, "unchanged");
+        });
+        it("should handle real-world DeviceInfo structure with compressed status", () => {
+            const statusData = {
+                commands: { power: true },
+                temperatures: { board: 25, enviroment: 20 },
+            };
+            const nvmData = {
+                user_parameters: {
+                    enviroment_1_temperature: 22,
+                    enviroment_2_temperature: 0,
+                    enviroment_3_temperature: 0,
+                    is_auto: false,
+                    is_sound_active: true,
+                },
+            };
+            const response = {
+                status: createGzippedBuffer(statusData),
+                nvm: createGzippedBuffer(nvmData),
+            };
+            const result = processResponse(response);
+            assert.deepEqual(result.status, statusData);
+            assert.deepEqual(result.nvm, nvmData);
+        });
+    });
+});

package/dist/esm/cli.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { Command } from "commander";
 import readline from "readline";
 import { version } from "../package.json";
+import { NEW_API_URL, OLD_API_URL } from "./constants";
 import { configure, signIn } from "./library";
 const promptPassword = () => {
     const rl = readline.createInterface({
@@ -48,17 +49,24 @@ const addAuthOptions = (command) => command
  * @returns The command with the MAC address option added.
  */
 const addMacOption = (command) => command.requiredOption("-m, --mac <macAddress>", "MAC address of the device");
+/**
+ * Adds legacy API option to a command.
+ * @param command The command to which the legacy option should be added.
+ * @returns The command with the legacy option added.
+ */
+const addLegacyOption = (command) => command.option("--legacy", "Use legacy API endpoint (old AWS Gateway)");
 /**
  * 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 { username, password, mac, legacy = false } = options;
     const normalizedMac = mac.replace(/:/g, "");
     const pwd = password || (yield promptPassword());
-    const jwtToken = yield signIn(username, pwd);
-    const api = configure();
+    const jwtToken = yield signIn(username, pwd, legacy);
+    const apiUrl = legacy ? OLD_API_URL : NEW_API_URL;
+    const api = configure(apiUrl);
     return { normalizedMac, jwtToken, api };
 });
 /**
@@ -117,7 +125,7 @@ const createProgram = () => {
             getter: (api, jwtToken, mac) => api.getTargetTemperature(jwtToken, mac),
         },
     ].forEach(({ commandName, description, getter }) => {
-        addMacOption(addAuthOptions(program.command(commandName).description(description))).action((options) => executeGetter(options, getter));
+        addLegacyOption(addMacOption(addAuthOptions(program.command(commandName).description(description)))).action((options) => executeGetter(options, getter));
     });
     // Generic setter commands
     [
@@ -132,8 +140,42 @@ const createProgram = () => {
             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));
+        addLegacyOption(addMacOption(addAuthOptions(program.command(commandName).description(description)).requiredOption("-v, --value <number>", "Value to set", parseFloat))).action((options) => executeSetter(options, setter));
     });
+    // Command: register
+    addLegacyOption(addAuthOptions(program
+        .command("register")
+        .description("Register a device with your account")))
+        .requiredOption("-m, --mac <macAddress>", "MAC address of the device")
+        .requiredOption("-s, --serial <serialNumber>", "Device serial number")
+        .requiredOption("-n, --name <deviceName>", "Device name")
+        .requiredOption("-r, --room <deviceRoom>", "Room name")
+        .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, serial, name, room, legacy = false, } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const pwd = password || (yield promptPassword());
+        const jwtToken = yield signIn(username, pwd, legacy);
+        const apiUrl = legacy ? OLD_API_URL : NEW_API_URL;
+        const api = configure(apiUrl);
+        const result = yield api.registerDevice(jwtToken, normalizedMac, serial, name, room);
+        console.log("Device registered successfully:");
+        console.log(JSON.stringify(result, null, 2));
+    }));
+    // Command: editDevice
+    addLegacyOption(addMacOption(addAuthOptions(program.command("editDevice").description("Update device name and room"))))
+        .requiredOption("-n, --name <deviceName>", "Device name")
+        .requiredOption("-r, --room <deviceRoom>", "Room name")
+        .action((options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { username, password, mac, name, room, legacy = false } = options;
+        const normalizedMac = mac.replace(/:/g, "");
+        const pwd = password || (yield promptPassword());
+        const jwtToken = yield signIn(username, pwd, legacy);
+        const apiUrl = legacy ? OLD_API_URL : NEW_API_URL;
+        const api = configure(apiUrl);
+        const result = yield api.editDevice(jwtToken, normalizedMac, name, room);
+        console.log("Device updated successfully:");
+        console.log(JSON.stringify(result, null, 2));
+    }));
     return program;
 };
 const main = () => {

package/dist/esm/constants.d.ts

@@ -1,2 +1,4 @@
+declare const OLD_API_URL = "https://fxtj7xkgc6.execute-api.eu-central-1.amazonaws.com/prod/";
+declare const NEW_API_URL = "https://the-mind-api.edilkamin.com/";
 declare const API_URL = "https://the-mind-api.edilkamin.com/";
-export { API_URL };
+export { API_URL, NEW_API_URL, OLD_API_URL };

package/dist/esm/constants.js

@@ -1,2 +1,4 @@
-const API_URL = "https://the-mind-api.edilkamin.com/";
-export { API_URL };
+const OLD_API_URL = "https://fxtj7xkgc6.execute-api.eu-central-1.amazonaws.com/prod/";
+const NEW_API_URL = "https://the-mind-api.edilkamin.com/";
+const API_URL = NEW_API_URL;
+export { API_URL, NEW_API_URL, OLD_API_URL };

package/dist/esm/index.d.ts

@@ -1,4 +1,6 @@
-export { API_URL } from "./constants";
+export { decompressBuffer, isBuffer, processResponse } from "./buffer-utils";
+export { API_URL, NEW_API_URL, OLD_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("./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, {}>>;
+export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
+export { BufferEncodedType, CommandsType, DeviceAssociationBody, DeviceAssociationResponse, DeviceInfoRawType, DeviceInfoType, EditDeviceAssociationBody, StatusType, TemperaturesType, UserParametersType, } from "./types";
+export declare const deviceInfo: (jwtToken: string, macAddress: string) => Promise<import("./types").DeviceInfoType>, registerDevice: (jwtToken: string, macAddress: string, serialNumber: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, editDevice: (jwtToken: string, macAddress: string, deviceName?: string, deviceRoom?: string) => Promise<import("./types").DeviceAssociationResponse>, 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,6 @@
 import { configure } from "./library";
-export { API_URL } from "./constants";
+export { decompressBuffer, isBuffer, processResponse } from "./buffer-utils";
+export { API_URL, NEW_API_URL, OLD_API_URL } from "./constants";
 export { configure, signIn } from "./library";
-export const { deviceInfo, setPower, setPowerOff, setPowerOn, getPower, getEnvironmentTemperature, getTargetTemperature, setTargetTemperature, } = configure();
+export { serialNumberDisplay, serialNumberFromHex, serialNumberToHex, } from "./serial-utils";
+export const { deviceInfo, registerDevice, editDevice, setPower, setPowerOff, setPowerOn, getPower, getEnvironmentTemperature, getTargetTemperature, setTargetTemperature, } = configure();

package/dist/esm/library.d.ts

@@ -1,5 +1,5 @@
 import * as amplifyAuth from "aws-amplify/auth";
-import { DeviceInfoType } from "./types";
+import { DeviceAssociationResponse, DeviceInfoType } from "./types";
 /**
  * Generates headers with a JWT token for authenticated requests.
  * @param {string} jwtToken - The JWT token for authorization.
@@ -14,9 +14,9 @@ declare const headers: (jwtToken: string) => {
  * @returns {object} - An object containing authentication-related methods.
  */
 declare const createAuthService: (auth: typeof amplifyAuth) => {
-    signIn: (username: string, password: string) => Promise<string>;
+    signIn: (username: string, password: string, legacy?: boolean) => Promise<string>;
 };
-declare const signIn: (username: string, password: string) => Promise<string>;
+declare const signIn: (username: string, password: string, legacy?: boolean) => Promise<string>;
 /**
  * Configures the library for API interactions.
  * Initializes API methods with a specified base URL.
@@ -30,6 +30,8 @@ declare const signIn: (username: string, password: string) => Promise<string>;
  */
 declare const configure: (baseURL?: string) => {
     deviceInfo: (jwtToken: string, macAddress: string) => Promise<DeviceInfoType>;
+    registerDevice: (jwtToken: string, macAddress: string, serialNumber: string, deviceName?: string, deviceRoom?: string) => Promise<DeviceAssociationResponse>;
+    editDevice: (jwtToken: string, macAddress: string, deviceName?: string, deviceRoom?: string) => Promise<DeviceAssociationResponse>;
     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, {}>>;

package/dist/esm/library.js

@@ -11,6 +11,7 @@ import { strict as assert } from "assert";
 import { Amplify } from "aws-amplify";
 import * as amplifyAuth from "aws-amplify/auth";
 import axios from "axios";
+import { processResponse } from "./buffer-utils";
 import { API_URL } from "./constants";
 const amplifyconfiguration = {
     aws_project_region: "eu-central-1",
@@ -23,15 +24,16 @@ const amplifyconfiguration = {
  * @returns {object} - The headers object with the Authorization field.
  */
 const headers = (jwtToken) => ({ Authorization: `Bearer ${jwtToken}` });
+let amplifyConfigured = false;
 /**
  * Configures Amplify if not already configured.
- * Ensures the configuration is only applied once.
+ * Uses a local flag to avoid calling getConfig() which prints a warning.
  */
 const configureAmplify = () => {
-    const currentConfig = Amplify.getConfig();
-    if (Object.keys(currentConfig).length !== 0)
+    if (amplifyConfigured)
         return;
     Amplify.configure(amplifyconfiguration);
+    amplifyConfigured = true;
 };
 /**
  * Creates an authentication service with sign-in functionality.
@@ -43,16 +45,21 @@ const createAuthService = (auth) => {
      * Signs in a user with the provided credentials.
      * @param {string} username - The username of the user.
      * @param {string} password - The password of the user.
+     * @param {boolean} [legacy=false] - If true, returns accessToken for legacy API.
      * @returns {Promise<string>} - The JWT token of the signed-in user.
      * @throws {Error} - If sign-in fails or no tokens are retrieved.
      */
-    const signIn = (username, password) => __awaiter(void 0, void 0, void 0, function* () {
+    const signIn = (username_1, password_1, ...args_1) => __awaiter(void 0, [username_1, password_1, ...args_1], void 0, function* (username, password, legacy = false) {
         configureAmplify();
         yield auth.signOut(); // Ensure the user is signed out first
         const { isSignedIn } = yield auth.signIn({ username, password });
         assert.ok(isSignedIn, "Sign-in failed");
         const { tokens } = yield auth.fetchAuthSession();
         assert.ok(tokens, "No tokens found");
+        if (legacy) {
+            assert.ok(tokens.accessToken, "No access token found");
+            return tokens.accessToken.toString();
+        }
         assert.ok(tokens.idToken, "No ID token found");
         return tokens.idToken.toString();
     });
@@ -63,6 +70,7 @@ const { signIn } = createAuthService(amplifyAuth);
 const deviceInfo = (axiosInstance) => 
 /**
  * Retrieves information about a device by its MAC address.
+ * Automatically decompresses any gzip-compressed Buffer fields in the response.
  *
  * @param {string} jwtToken - The JWT token for authentication.
  * @param {string} macAddress - The MAC address of the device.
@@ -72,7 +80,8 @@ const deviceInfo = (axiosInstance) =>
     const response = yield axiosInstance.get(`device/${macAddress}/info`, {
         headers: headers(jwtToken),
     });
-    return response.data;
+    // Process response to decompress any gzipped Buffer fields
+    return processResponse(response.data);
 });
 const mqttCommand = (axiosInstance) => 
 // eslint-disable-next-line  @typescript-eslint/no-explicit-any
@@ -162,6 +171,47 @@ const setTargetTemperature = (axiosInstance) =>
     name: "enviroment_1_temperature",
     value: temperature,
 });
+const registerDevice = (axiosInstance) => 
+/**
+ * Registers a device with the user's account.
+ * This must be called before other device operations will work on the new API.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device (colons optional).
+ * @param {string} serialNumber - The device serial number.
+ * @param {string} deviceName - User-friendly name for the device (default: empty string).
+ * @param {string} deviceRoom - Room name for the device (default: empty string).
+ * @returns {Promise<DeviceAssociationResponse>} - A promise that resolves to the registration response.
+ */
+(jwtToken_1, macAddress_1, serialNumber_1, ...args_1) => __awaiter(void 0, [jwtToken_1, macAddress_1, serialNumber_1, ...args_1], void 0, function* (jwtToken, macAddress, serialNumber, deviceName = "", deviceRoom = "") {
+    const body = {
+        macAddress: macAddress.replace(/:/g, ""),
+        deviceName,
+        deviceRoom,
+        serialNumber,
+    };
+    const response = yield axiosInstance.post("device", body, { headers: headers(jwtToken) });
+    return response.data;
+});
+const editDevice = (axiosInstance) => 
+/**
+ * Updates a device's name and room.
+ *
+ * @param {string} jwtToken - The JWT token for authentication.
+ * @param {string} macAddress - The MAC address of the device (colons optional).
+ * @param {string} deviceName - New name for the device (default: empty string).
+ * @param {string} deviceRoom - New room for the device (default: empty string).
+ * @returns {Promise<DeviceAssociationResponse>} - A promise that resolves to the update response.
+ */
+(jwtToken_1, macAddress_1, ...args_1) => __awaiter(void 0, [jwtToken_1, macAddress_1, ...args_1], void 0, function* (jwtToken, macAddress, deviceName = "", deviceRoom = "") {
+    const normalizedMac = macAddress.replace(/:/g, "");
+    const body = {
+        deviceName,
+        deviceRoom,
+    };
+    const response = yield axiosInstance.put(`device/${normalizedMac}`, body, { headers: headers(jwtToken) });
+    return response.data;
+});
 /**
  * Configures the library for API interactions.
  * Initializes API methods with a specified base URL.
@@ -176,6 +226,8 @@ const setTargetTemperature = (axiosInstance) =>
 const configure = (baseURL = API_URL) => {
     const axiosInstance = axios.create({ baseURL });
     const deviceInfoInstance = deviceInfo(axiosInstance);
+    const registerDeviceInstance = registerDevice(axiosInstance);
+    const editDeviceInstance = editDevice(axiosInstance);
     const setPowerInstance = setPower(axiosInstance);
     const setPowerOffInstance = setPowerOff(axiosInstance);
     const setPowerOnInstance = setPowerOn(axiosInstance);
@@ -185,6 +237,8 @@ const configure = (baseURL = API_URL) => {
     const setTargetTemperatureInstance = setTargetTemperature(axiosInstance);
     return {
         deviceInfo: deviceInfoInstance,
+        registerDevice: registerDeviceInstance,
+        editDevice: editDeviceInstance,
         setPower: setPowerInstance,
         setPowerOff: setPowerOffInstance,
         setPowerOn: setPowerOnInstance,