@mp-consulting/homebridge-lg-thinq 1.0.0

package/homebridge-ui/public/styles.css

@@ -0,0 +1,185 @@
+/* Dark mode support */
+.dark-mode {
+  background-color: #242424;
+  color: lightgrey;
+
+  .form-control,
+  .form-select {
+    background-color: #333333 !important;
+    border: none !important;
+    color: #eeeeee !important;
+  }
+
+  thead, tbody, tr {
+    border-style: hidden;
+  }
+
+  th {
+    color: #eeeeee !important;
+    font-weight: 500 !important;
+  }
+}
+
+select {
+  background-image:
+    linear-gradient(45deg, transparent 50%, gray 50%),
+    linear-gradient(135deg, gray 50%, transparent 50%),
+    linear-gradient(to right, #ccc, #ccc);
+  background-position:
+    calc(100% - 20px) calc(1em + 2px),
+    calc(100% - 15px) calc(1em + 2px),
+    calc(100% - 2.5em) 0.5em;
+  background-size:
+    5px 5px,
+    5px 5px,
+    1px 1.5em;
+  background-repeat: no-repeat;
+}
+
+/* Header */
+.lg-header {
+  text-align: center;
+  margin-bottom: 2rem;
+}
+
+.lg-header h2 {
+  color: var(--bs-primary);
+  margin-bottom: 0.5rem;
+}
+
+.lg-header p {
+  margin: 0;
+}
+
+/* Step wizard */
+.step-container {
+  margin-bottom: 2rem;
+}
+
+.step-header {
+  display: flex;
+  align-items: center;
+  margin-bottom: 1rem;
+}
+
+.step-number {
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  background-color: var(--bs-primary);
+  color: white;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-weight: bold;
+  margin-right: 0.75rem;
+}
+
+.step-title {
+  font-size: 1.25rem;
+  font-weight: 500;
+  margin: 0;
+}
+
+/* Device list */
+.device-list {
+  max-height: 400px;
+  overflow-y: auto;
+}
+
+.device-item {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0.75rem;
+  border-bottom: 1px solid var(--bs-border-color);
+}
+
+.device-item:last-child {
+  border-bottom: none;
+}
+
+.device-info {
+  flex: 1;
+}
+
+.device-name {
+  font-weight: 500;
+  margin-bottom: 0.25rem;
+}
+
+.device-id {
+  font-size: 0.85rem;
+  color: var(--bs-secondary);
+}
+
+.device-type {
+  font-size: 0.8rem;
+  color: var(--bs-secondary);
+}
+
+.device-status {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+/* Status badges */
+.status-badge {
+  padding: 0.25rem 0.5rem;
+  border-radius: 4px;
+  font-size: 0.75rem;
+  font-weight: 500;
+}
+
+.status-online {
+  background-color: var(--bs-success);
+  color: white;
+}
+
+.status-offline {
+  background-color: var(--bs-danger);
+  color: white;
+}
+
+/* Utility classes */
+.hidden {
+  display: none !important;
+}
+
+.btn-sm-icon {
+  padding: 0.25rem 0.5rem;
+  font-size: 0.875rem;
+}
+
+/* Login methods accordion */
+.login-method-card {
+  margin-bottom: 0.5rem;
+}
+
+.login-method-card .card-header {
+  padding: 0.5rem 1rem;
+}
+
+.login-method-card .btn-link {
+  text-decoration: none;
+  font-weight: 500;
+}
+
+.login-method-card .btn-link:hover {
+  text-decoration: underline;
+}
+
+/* Wiki link */
+.wiki-link {
+  display: block;
+  margin-top: 1rem;
+  padding: 1rem;
+  background-color: var(--bs-light);
+  border-radius: 0.5rem;
+  text-align: center;
+}
+
+.dark-mode .wiki-link {
+  background-color: #333333;
+}

package/homebridge-ui/server.js

@@ -0,0 +1,103 @@
+import { API } from '../dist/lib/API.js';
+import { Auth } from '../dist/lib/Auth.js';
+import { HomebridgePluginUiServer, RequestError } from '@homebridge/plugin-ui-utils';
+import { DeviceType } from '../dist/lib/constants.js';
+
+/**
+ * LG ThinQ Plugin UI Server
+ */
+class LGThinQUiServer extends HomebridgePluginUiServer {
+  constructor() {
+    super();
+
+    // Register request handlers
+    this.onRequest('/login-by-user-pass', this.handleLogin.bind(this));
+    this.onRequest('/get-all-devices', this.handleGetDevices.bind(this));
+    this.onRequest('/restart', this.handleRestart.bind(this));
+
+    // Signal ready
+    this.ready();
+  }
+
+  /**
+   * Validate required payload fields
+   */
+  validate(payload, fields) {
+    const missing = fields.filter(f => !payload[f]);
+    if (missing.length > 0) {
+      throw new RequestError(`Missing required fields: ${missing.join(', ')}`, { status: 400 });
+    }
+  }
+
+  /**
+   * Handle login request
+   */
+  async handleLogin(payload) {
+    this.validate(payload, ['username', 'password', 'country', 'language']);
+
+    try {
+      const api = new API(payload.country, payload.language);
+      const gateway = await api.gateway();
+      const auth = new Auth(gateway);
+      const session = await auth.login(payload.username, payload.password);
+
+      return {
+        success: true,
+        token: session.refreshToken,
+      };
+    } catch (err) {
+      return {
+        success: false,
+        error: err.message || 'Login failed',
+      };
+    }
+  }
+
+  /**
+   * Handle get devices request
+   */
+  async handleGetDevices(payload) {
+    this.validate(payload, ['refresh_token', 'country', 'language']);
+
+    try {
+      const api = new API(payload.country, payload.language);
+      api.setRefreshToken(payload.refresh_token);
+      await api.ready();
+
+      const deviceList = await api.getListDevices();
+
+      return {
+        success: true,
+        devices: deviceList.map(device => ({
+          id: device.deviceId,
+          name: device.alias,
+          type: DeviceType[device.deviceType] || device.deviceType,
+          online: device.online !== false,
+        })),
+      };
+    } catch (err) {
+      return {
+        success: false,
+        error: err.message || 'Failed to get devices',
+      };
+    }
+  }
+
+  /**
+   * Handle restart request
+   */
+  async handleRestart() {
+    try {
+      this.pushEvent('restart', {});
+      return { success: true };
+    } catch (err) {
+      return {
+        success: false,
+        error: err.message || 'Failed to restart',
+      };
+    }
+  }
+}
+
+// Start the server
+(() => new LGThinQUiServer())();

package/jest.config.ts

@@ -0,0 +1,39 @@
+import type { Config } from 'jest';
+import { createDefaultEsmPreset } from 'ts-jest';
+
+const presetConfig = createDefaultEsmPreset({
+  tsconfig: './tsconfig.json',
+  diagnostics: {
+    ignoreCodes: [151002],
+  },
+});
+
+export default {
+  ...presetConfig,
+  collectCoverageFrom: ['src/**'],
+  testEnvironment: 'node',
+  testPathIgnorePatterns: [
+    '/node_modules/',
+    '/dist/',
+  ],
+  moduleFileExtensions: [
+    'ts',
+    'js',
+    'json',
+  ],
+  coverageReporters: [
+    'text',
+    'lcov',
+  ],
+  moduleNameMapper: {
+    '^(..?/.+).js?$': '$1',
+  },
+  coverageThreshold: {
+    global: {
+      branches: 5,
+      functions: 10,
+      lines: 10,
+      statements: 10,
+    },
+  },
+} satisfies Config;

package/package.json

@@ -0,0 +1,83 @@
+{
+  "displayName": "Homebridge LG ThinQ",
+  "name": "@mp-consulting/homebridge-lg-thinq",
+  "version": "1.0.0",
+  "description": "A Homebridge plugin for controlling/monitoring LG ThinQ devices via LG ThinQ platform.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mp-consulting/homebridge-lg-thinq.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mp-consulting/homebridge-lg-thinq/issues"
+  },
+  "engines": {
+    "homebridge": "^1.8.0 || ^2.0.0-beta.0",
+    "node": "^20.18.0 || ^22.10.0 || ^24.0.0"
+  },
+  "main": "dist/index.js",
+  "bin": {
+    "thinq": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "rimraf ./dist && tsc",
+    "lint": "eslint . --max-warnings=0",
+    "prepublishOnly": "npm run lint && npm run build",
+    "watch": "npm run build && npm link && nodemon",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "homekit",
+    "lg",
+    "lg-thinq"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@jest/globals": "^30.2.0",
+    "@types/aws-iot-device-sdk": "^2.2.9",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^25.0.3",
+    "@types/node-forge": "^1.3.14",
+    "@types/node-persist": "^3.1.8",
+    "@types/qs": "^6.14.0",
+    "eslint": "^9.39.2",
+    "eslint-plugin-jest": "^29.9.0",
+    "homebridge": "^1.8.5",
+    "jest": "^30.2.0",
+    "nodemon": "^3.1.11",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.1"
+  },
+  "homepage": "https://github.com/mp-consulting/homebridge-lg-thinq#readme",
+  "author": "Mickael Palma",
+  "dependencies": {
+    "@homebridge/plugin-ui-utils": "^2.1.2",
+    "aws-iot-device-sdk": "^2.2.16",
+    "axios": "^1.13.2",
+    "axios-retry": "^4.5.0",
+    "commander": "^14.0.2",
+    "homebridge-config-ui-x": "^5.12.1-beta.5",
+    "homebridge-lib": "^7.2.0",
+    "luxon": "^3.7.2",
+    "node-forge": "^1.3.3",
+    "node-persist": "^4.0.4",
+    "qs": "^6.14.0"
+  },
+  "overrides": {
+    "glob": "^13.0.0",
+    "help-me": {
+      "glob": "^13.0.0"
+    },
+    "test-exclude": "^7.0.1"
+  }
+}

package/sample/README.md

@@ -0,0 +1,10 @@
+# data sample
+
+this folder contains sample device data for developing, collecting from many devices provided by users, every confidential data is replaced with dummy data.
+
+# two kind of data
+
+- `*.json`: contains device data, response from lg thinq api
+- `*-model.json`: contains device model data, downloaded by url provided from field `modelJsonUrl` in `device data`, it's device specs
+- `*-v1.json`: device data also, but it's from thinq v1 api
+- `*-v1-model.json`: device model data from thinq v1 device