iobroker.homewizard 0.1.0

package/build/lib/homewizard-client.js

@@ -0,0 +1,193 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var homewizard_client_exports = {};
+__export(homewizard_client_exports, {
+  HomeWizardApiError: () => HomeWizardApiError,
+  HomeWizardClient: () => HomeWizardClient
+});
+module.exports = __toCommonJS(homewizard_client_exports);
+var https = __toESM(require("node:https"));
+class HomeWizardClient {
+  ip;
+  token;
+  /**
+   * @param ip Device IP address
+   * @param token Bearer token (empty string for pairing requests)
+   */
+  constructor(ip, token = "") {
+    this.ip = ip;
+    this.token = token;
+  }
+  /** Get device info (GET /api) */
+  async getDeviceInfo() {
+    return this.request("GET", "/api");
+  }
+  /** Request pairing token (POST /api/user) — 403 until button pressed */
+  async requestPairing() {
+    return this.request("POST", "/api/user", {
+      name: "local/iobroker"
+    });
+  }
+  /** Get current measurement (REST fallback) */
+  async getMeasurement() {
+    return this.request("GET", "/api/measurement");
+  }
+  /** Get system info */
+  async getSystem() {
+    return this.request("GET", "/api/system");
+  }
+  /**
+   * Update system settings
+   *
+   * @param settings System settings to update
+   */
+  async setSystem(settings) {
+    return this.request("PUT", "/api/system", settings);
+  }
+  /** Reboot device */
+  async reboot() {
+    await this.request("PUT", "/api/system/reboot");
+  }
+  /** Identify device (blink LED) */
+  async identify() {
+    await this.request("PUT", "/api/system/identify");
+  }
+  /** Get battery control status */
+  async getBatteries() {
+    return this.request("GET", "/api/batteries");
+  }
+  /**
+   * Set battery control
+   *
+   * @param settings Battery control settings to update
+   */
+  async setBatteries(settings) {
+    return this.request("PUT", "/api/batteries", settings);
+  }
+  /**
+   * @param method HTTP method
+   * @param path API path
+   * @param body Optional request body
+   */
+  request(method, path, body) {
+    return new Promise((resolve, reject) => {
+      const bodyStr = body ? JSON.stringify(body) : void 0;
+      const headers = {
+        "X-Api-Version": "2"
+      };
+      if (this.token) {
+        headers.Authorization = `Bearer ${this.token}`;
+      }
+      if (bodyStr) {
+        headers["Content-Type"] = "application/json";
+        headers["Content-Length"] = Buffer.byteLength(bodyStr).toString();
+      }
+      const req = https.request(
+        {
+          hostname: this.ip,
+          port: 443,
+          path,
+          method,
+          headers,
+          rejectUnauthorized: false,
+          // HomeWizard uses self-signed certs
+          timeout: 1e4
+        },
+        (res) => {
+          const chunks = [];
+          res.on("data", (chunk) => chunks.push(chunk));
+          res.on("end", () => {
+            var _a;
+            const data = Buffer.concat(chunks).toString();
+            if (!res.statusCode || res.statusCode >= 400) {
+              const error = new HomeWizardApiError(
+                (_a = res.statusCode) != null ? _a : 0,
+                data,
+                `${method} ${path}`
+              );
+              reject(error);
+              return;
+            }
+            if (!data) {
+              resolve(void 0);
+              return;
+            }
+            try {
+              resolve(JSON.parse(data));
+            } catch {
+              reject(
+                new Error(
+                  `Invalid JSON from ${method} ${path}: ${data.substring(0, 200)}`
+                )
+              );
+            }
+          });
+        }
+      );
+      req.on("error", reject);
+      req.on("timeout", () => {
+        req.destroy(new Error(`Timeout: ${method} ${path}`));
+      });
+      if (bodyStr) {
+        req.write(bodyStr);
+      }
+      req.end();
+    });
+  }
+}
+class HomeWizardApiError extends Error {
+  statusCode;
+  errorCode;
+  /**
+   * @param statusCode HTTP status code
+   * @param body Response body
+   * @param context Request context for error message
+   */
+  constructor(statusCode, body, context) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    let errorCode = "unknown";
+    let description = body;
+    try {
+      const parsed = JSON.parse(body);
+      errorCode = (_c = (_b = (_a = parsed.error) == null ? void 0 : _a.code) != null ? _b : parsed.error) != null ? _c : "unknown";
+      description = (_g = (_f = (_d = parsed.error) == null ? void 0 : _d.description) != null ? _f : (_e = parsed.error) == null ? void 0 : _e.code) != null ? _g : body;
+    } catch {
+    }
+    super(`${context}: HTTP ${statusCode} \u2014 ${description}`);
+    this.name = "HomeWizardApiError";
+    this.statusCode = statusCode;
+    this.errorCode = errorCode;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HomeWizardApiError,
+  HomeWizardClient
+});
+//# sourceMappingURL=homewizard-client.js.map

package/build/lib/homewizard-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/homewizard-client.ts"],
+  "sourcesContent": ["import * as https from \"node:https\";\nimport type {\n  BatteryControl,\n  DeviceInfo,\n  Measurement,\n  PairingResponse,\n  SystemInfo,\n} from \"./types\";\n\n/** HTTPS client for HomeWizard API v2 */\nexport class HomeWizardClient {\n  private readonly ip: string;\n  private readonly token: string;\n\n  /**\n   * @param ip Device IP address\n   * @param token Bearer token (empty string for pairing requests)\n   */\n  constructor(ip: string, token: string = \"\") {\n    this.ip = ip;\n    this.token = token;\n  }\n\n  /** Get device info (GET /api) */\n  async getDeviceInfo(): Promise<DeviceInfo> {\n    return this.request<DeviceInfo>(\"GET\", \"/api\");\n  }\n\n  /** Request pairing token (POST /api/user) \u2014 403 until button pressed */\n  async requestPairing(): Promise<PairingResponse> {\n    return this.request<PairingResponse>(\"POST\", \"/api/user\", {\n      name: \"local/iobroker\",\n    });\n  }\n\n  /** Get current measurement (REST fallback) */\n  async getMeasurement(): Promise<Measurement> {\n    return this.request<Measurement>(\"GET\", \"/api/measurement\");\n  }\n\n  /** Get system info */\n  async getSystem(): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"GET\", \"/api/system\");\n  }\n\n  /**\n   * Update system settings\n   *\n   * @param settings System settings to update\n   */\n  async setSystem(settings: Partial<SystemInfo>): Promise<SystemInfo> {\n    return this.request<SystemInfo>(\"PUT\", \"/api/system\", settings);\n  }\n\n  /** Reboot device */\n  async reboot(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/reboot\");\n  }\n\n  /** Identify device (blink LED) */\n  async identify(): Promise<void> {\n    await this.request(\"PUT\", \"/api/system/identify\");\n  }\n\n  /** Get battery control status */\n  async getBatteries(): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"GET\", \"/api/batteries\");\n  }\n\n  /**\n   * Set battery control\n   *\n   * @param settings Battery control settings to update\n   */\n  async setBatteries(\n    settings: Partial<BatteryControl>,\n  ): Promise<BatteryControl> {\n    return this.request<BatteryControl>(\"PUT\", \"/api/batteries\", settings);\n  }\n\n  /**\n   * @param method HTTP method\n   * @param path API path\n   * @param body Optional request body\n   */\n  private request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const bodyStr = body ? JSON.stringify(body) : undefined;\n      const headers: Record<string, string> = {\n        \"X-Api-Version\": \"2\",\n      };\n\n      if (this.token) {\n        headers.Authorization = `Bearer ${this.token}`;\n      }\n      if (bodyStr) {\n        headers[\"Content-Type\"] = \"application/json\";\n        headers[\"Content-Length\"] = Buffer.byteLength(bodyStr).toString();\n      }\n\n      const req = https.request(\n        {\n          hostname: this.ip,\n          port: 443,\n          path,\n          method,\n          headers,\n          rejectUnauthorized: false, // HomeWizard uses self-signed certs\n          timeout: 10_000,\n        },\n        (res) => {\n          const chunks: Buffer[] = [];\n          res.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n          res.on(\"end\", () => {\n            const data = Buffer.concat(chunks).toString();\n            if (!res.statusCode || res.statusCode >= 400) {\n              const error = new HomeWizardApiError(\n                res.statusCode ?? 0,\n                data,\n                `${method} ${path}`,\n              );\n              reject(error);\n              return;\n            }\n            if (!data) {\n              resolve(undefined as T);\n              return;\n            }\n            try {\n              resolve(JSON.parse(data) as T);\n            } catch {\n              reject(\n                new Error(\n                  `Invalid JSON from ${method} ${path}: ${data.substring(0, 200)}`,\n                ),\n              );\n            }\n          });\n        },\n      );\n\n      req.on(\"error\", reject);\n      req.on(\"timeout\", () => {\n        req.destroy(new Error(`Timeout: ${method} ${path}`));\n      });\n\n      if (bodyStr) {\n        req.write(bodyStr);\n      }\n      req.end();\n    });\n  }\n}\n\n/** API error with status code and parsed error body */\nexport class HomeWizardApiError extends Error {\n  readonly statusCode: number;\n  readonly errorCode: string;\n\n  /**\n   * @param statusCode HTTP status code\n   * @param body Response body\n   * @param context Request context for error message\n   */\n  constructor(statusCode: number, body: string, context: string) {\n    let errorCode = \"unknown\";\n    let description = body;\n    try {\n      const parsed = JSON.parse(body);\n      errorCode = parsed.error?.code ?? parsed.error ?? \"unknown\";\n      description = parsed.error?.description ?? parsed.error?.code ?? body;\n    } catch {\n      // body is not JSON\n    }\n    super(`${context}: HTTP ${statusCode} \u2014 ${description}`);\n    this.name = \"HomeWizardApiError\";\n    this.statusCode = statusCode;\n    this.errorCode = errorCode;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}