@boozilla/homebridge-shome 1.0.0

package/dist/shomeClient.d.ts

@@ -0,0 +1,30 @@
+import { Logger } from 'homebridge';
+export interface MainDevice {
+    thngId: string;
+    thngModelTypeName: string;
+    nickname: string;
+    [key: string]: unknown;
+}
+export interface SubDevice {
+    deviceId: string;
+    nickname: string;
+    [key: string]: unknown;
+}
+export declare class ShomeClient {
+    private readonly log;
+    private readonly username;
+    private readonly password;
+    private readonly deviceId;
+    private cachedAccessToken;
+    private ihdId;
+    private tokenExpiry;
+    constructor(log: Logger, username: string, password: string, deviceId: string);
+    login(): Promise<string | null>;
+    getDeviceList(): Promise<MainDevice[]>;
+    getDeviceInfo(thingId: string, type: string): Promise<SubDevice[] | null>;
+    setDevice(thingId: string, deviceId: string, type: string, controlType: string, state: string): Promise<boolean>;
+    unlockDoorlock(thingId: string): Promise<boolean>;
+    private sha512;
+    private isTokenExpired;
+    private getDateTime;
+}

package/dist/shomeClient.js

@@ -0,0 +1,163 @@
+import axios from 'axios';
+import CryptoJS from 'crypto-js';
+const BASE_URL = 'https://shome-api.samsung-ihp.com';
+const APP_REGST_ID = '6110736314d9eef6baf393f3e43a5342f9ccde6ef300d878385acd9264cf14d5';
+const CHINA_APP_REGST_ID = 'SHOME==6110736314d9eef6baf393f3e43a5342f9ccde6ef300d878385acd9264cf14d5';
+const LANGUAGE = 'KOR';
+export class ShomeClient {
+    log;
+    username;
+    password;
+    deviceId;
+    cachedAccessToken = null;
+    ihdId = null;
+    tokenExpiry = 0;
+    constructor(log, username, password, deviceId) {
+        this.log = log;
+        this.username = username;
+        this.password = password;
+        this.deviceId = deviceId;
+    }
+    async login() {
+        if (!this.isTokenExpired()) {
+            return this.cachedAccessToken;
+        }
+        try {
+            const createDate = this.getDateTime();
+            const hashedPassword = this.sha512(this.password);
+            const hashData = this.sha512(`IHRESTAPI${this.username}${hashedPassword}${this.deviceId}` +
+                `${APP_REGST_ID}${CHINA_APP_REGST_ID}${LANGUAGE}${createDate}`);
+            const response = await axios.put(`${BASE_URL}/v18/users/login`, null, {
+                params: {
+                    appRegstId: APP_REGST_ID,
+                    chinaAppRegstId: CHINA_APP_REGST_ID,
+                    createDate: createDate,
+                    hashData: hashData,
+                    language: LANGUAGE,
+                    mobileDeviceIdno: this.deviceId,
+                    password: hashedPassword,
+                    userId: this.username,
+                },
+            });
+            if (response.data && response.data.accessToken) {
+                this.cachedAccessToken = response.data.accessToken;
+                this.ihdId = response.data.ihdId;
+                // Decode token to find expiry
+                const payload = JSON.parse(Buffer.from(this.cachedAccessToken.split('.')[1], 'base64').toString());
+                this.tokenExpiry = payload.exp * 1000;
+                this.log.info('Successfully logged in to sHome API.');
+                return this.cachedAccessToken;
+            }
+            else {
+                this.log.error('Login failed: Invalid credentials or API error.');
+                return null;
+            }
+        }
+        catch (error) {
+            this.log.error(`Login error: ${error}`);
+            return null;
+        }
+    }
+    async getDeviceList() {
+        const token = await this.login();
+        if (!token || !this.ihdId) {
+            return [];
+        }
+        try {
+            const createDate = this.getDateTime();
+            const hashData = this.sha512(`IHRESTAPI${this.ihdId}${createDate}`);
+            const response = await axios.get(`${BASE_URL}/v16/settings/${this.ihdId}/devices/`, {
+                params: { createDate, hashData },
+                headers: { 'Authorization': `Bearer ${token}` },
+            });
+            return response.data.deviceList || [];
+        }
+        catch (error) {
+            this.log.error(`Error getting device list: ${error}`);
+            return [];
+        }
+    }
+    async getDeviceInfo(thingId, type) {
+        const token = await this.login();
+        if (!token) {
+            return null;
+        }
+        try {
+            const createDate = this.getDateTime();
+            const hashData = this.sha512(`IHRESTAPI${thingId}${createDate}`);
+            const typePath = type.toLowerCase().replace(/_/g, '');
+            const response = await axios.get(`${BASE_URL}/v18/settings/${typePath}/${thingId}`, {
+                params: { createDate, hashData },
+                headers: { 'Authorization': `Bearer ${token}` },
+            });
+            return response.data.deviceInfoList || null;
+        }
+        catch (error) {
+            this.log.error(`Error getting device info for ${thingId}: ${error}`);
+            return null;
+        }
+    }
+    async setDevice(thingId, deviceId, type, controlType, state) {
+        const token = await this.login();
+        if (!token) {
+            return false;
+        }
+        try {
+            const createDate = this.getDateTime();
+            const hashData = this.sha512(`IHRESTAPI${thingId}${deviceId}${state}${createDate}`);
+            const typePath = type.toLowerCase().replace(/_/g, '');
+            const controlPath = controlType.toLowerCase().replace(/_/g, '-');
+            await axios.put(`${BASE_URL}/v18/settings/${typePath}/${thingId}/${deviceId}/${controlPath}`, null, {
+                params: {
+                    createDate,
+                    [controlType === 'WINDSPEED' ? 'mode' : 'state']: state,
+                    hashData,
+                },
+                headers: { 'Authorization': `Bearer ${token}` },
+            });
+            this.log.info(`Set ${type} [${thingId}/${deviceId}] to ${state}`);
+            return true;
+        }
+        catch (error) {
+            this.log.error(`Error setting device ${thingId}: ${error}`);
+            return false;
+        }
+    }
+    async unlockDoorlock(thingId) {
+        const token = await this.login();
+        if (!token) {
+            return false;
+        }
+        try {
+            const createDate = this.getDateTime();
+            const hashData = this.sha512(`IHRESTAPI${thingId}${createDate}`);
+            await axios.put(`${BASE_URL}/v16/settings/doorlocks/${thingId}/open-mode`, null, {
+                params: {
+                    createDate,
+                    pin: '',
+                    hashData,
+                },
+                headers: { 'Authorization': `Bearer ${token}` },
+            });
+            this.log.info(`Unlocked doorlock [${thingId}]`);
+            return true;
+        }
+        catch (error) {
+            this.log.error(`Error unlocking doorlock ${thingId}: ${error}`);
+            return false;
+        }
+    }
+    sha512(input) {
+        return CryptoJS.SHA512(input).toString();
+    }
+    isTokenExpired() {
+        return !this.cachedAccessToken || Date.now() >= this.tokenExpiry;
+    }
+    getDateTime() {
+        const now = new Date();
+        const pad = (num) => num.toString().padStart(2, '0');
+        return `${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}` +
+            `${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}${pad(now.getUTCSeconds())}`;
+    }
+}
+//# sourceMappingURL=shomeClient.js.map

package/dist/shomeClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shomeClient.js","sourceRoot":"","sources":["../src/shomeClient.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,35 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  {
+    ignores: ['dist/**'],
+  },
+  {
+    rules: {
+      'quotes': ['error', 'single'],
+      'indent': ['error', 2, { 'SwitchCase': 0 }],
+      'linebreak-style': ['error', 'unix'],
+      'semi': ['error', 'always'],
+      'comma-dangle': ['error', 'always-multiline'],
+      'dot-notation': 'error',
+      'eqeqeq': ['error', 'smart'],
+      'curly': ['error', 'all'],
+      'brace-style': ['error'],
+      'prefer-arrow-callback': 'warn',
+      'max-len': ['warn', 160],
+      'object-curly-spacing': ['error', 'always'],
+      'no-use-before-define': 'off',
+      '@typescript-eslint/no-use-before-define': ['error', { 'classes': false, 'enums': false }],
+      '@typescript-eslint/no-unused-vars': ['error', { 'caughtErrors': 'none' }],
+    },
+  },
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+    },
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+);

package/nodemon.json

@@ -0,0 +1,12 @@
+{
+  "watch": [
+    "src"
+  ],
+  "ext": "ts",
+  "ignore": [],
+  "exec": "tsc && homebridge -U ./test/hbConfig -D",
+  "signal": "SIGTERM",
+  "env": {
+    "NODE_OPTIONS": "--trace-warnings"
+  }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@boozilla/homebridge-shome",
+  "displayName": "sHome Plugin",
+  "version": "1.0.0",
+  "private": false,
+  "description": "A Homebridge plugin for Samsung Smart Home",
+  "author": "boozilla",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boozilla/homebridge-shome.git"
+  },
+  "bugs": {
+    "url": "https://github.com/boozilla/homebridge-shome/issues"
+  },
+  "homepage": "https://github.com/boozilla/homebridge-shome#readme",
+  "scripts": {
+    "lint": "eslint . --max-warnings=0",
+    "watch": "npm run build && npm link && nodemon",
+    "build": "rimraf ./dist && tsc",
+    "prepublishOnly": "npm run lint && npm run build"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "shome",
+    "samsung"
+  ],
+  "engines": {
+    "node": "^18.15.0 || ^20.7.0 || ^22",
+    "homebridge": "^1.8.0 || ^2.0.0-beta.0"
+  },
+  "dependencies": {
+    "axios": "^1.7.2",
+    "crypto-js": "^4.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.36.0",
+    "@types/crypto-js": "^4.2.2",
+    "@types/node": "^20.12.12",
+    "eslint": "^9.36.0",
+    "homebridge": "^2.0.0-beta.30",
+    "nodemon": "^3.1.10",
+    "rimraf": "^5.0.7",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.5",
+    "typescript-eslint": "^8.44.0"
+  }
+}

package/src/accessories/doorlockAccessory.ts

@@ -0,0 +1,62 @@
+import { CharacteristicValue, PlatformAccessory, Service } from 'homebridge';
+import { ShomePlatform } from '../platform.js';
+
+export class DoorlockAccessory {
+  private service: Service;
+
+  constructor(
+    private readonly platform: ShomePlatform,
+    private readonly accessory: PlatformAccessory,
+  ) {
+    const device = this.accessory.context.device;
+    this.accessory.getService(this.platform.Service.AccessoryInformation)!
+      .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Samsung')
+      .setCharacteristic(this.platform.Characteristic.Model, 'Doorlock')
+      .setCharacteristic(this.platform.Characteristic.SerialNumber, device.thngId);
+
+    this.service = this.accessory.getService(this.platform.Service.LockMechanism) ||
+      this.accessory.addService(this.platform.Service.LockMechanism);
+
+    this.service.setCharacteristic(this.platform.Characteristic.Name, device.nickname);
+
+    this.service.getCharacteristic(this.platform.Characteristic.LockCurrentState)
+      .onGet(this.getCurrentState.bind(this));
+
+    this.service.getCharacteristic(this.platform.Characteristic.LockTargetState)
+      .onGet(this.getCurrentState.bind(this))
+      .onSet(this.setTargetState.bind(this));
+  }
+
+  async getCurrentState(): Promise<CharacteristicValue> {
+    const device = this.accessory.context.device;
+    if (device.status === 0 || device.status === false) {
+      return this.platform.Characteristic.LockCurrentState.UNSECURED;
+    } else {
+      return this.platform.Characteristic.LockCurrentState.SECURED;
+    }
+  }
+
+  async setTargetState(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+
+    if (value === this.platform.Characteristic.LockTargetState.UNSECURED) {
+      this.platform.log.info(`Unlocking ${device.nickname}...`);
+      const success = await this.platform.shomeClient.unlockDoorlock(device.thngId);
+
+      if (success) {
+        this.platform.log.info(`${device.nickname} unlocked successfully.`);
+        this.service.updateCharacteristic(this.platform.Characteristic.LockCurrentState, this.platform.Characteristic.LockCurrentState.UNSECURED);
+      } else {
+        this.platform.log.error(`Failed to unlock ${device.nickname}.`);
+        setTimeout(() => {
+          this.service.updateCharacteristic(this.platform.Characteristic.LockTargetState, this.platform.Characteristic.LockTargetState.SECURED);
+        }, 1000);
+      }
+    } else {
+      this.platform.log.info(`Locking ${device.nickname} via the app is not supported.`);
+      setTimeout(() => {
+        this.service.updateCharacteristic(this.platform.Characteristic.LockTargetState, this.platform.Characteristic.LockTargetState.SECURED);
+      }, 1000);
+    }
+  }
+}

package/src/accessories/heaterAccessory.ts

@@ -0,0 +1,94 @@
+import { CharacteristicValue, PlatformAccessory, Service } from 'homebridge';
+import { ShomePlatform } from '../platform.js';
+
+export class HeaterAccessory {
+  private service: Service;
+
+  constructor(
+    private readonly platform: ShomePlatform,
+    private readonly accessory: PlatformAccessory,
+  ) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+
+    this.accessory.getService(this.platform.Service.AccessoryInformation)!
+      .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Samsung')
+      .setCharacteristic(this.platform.Characteristic.Model, 'Heater')
+      .setCharacteristic(this.platform.Characteristic.SerialNumber, `${device.thngId}-${subDevice.deviceId}`);
+
+    this.service = this.accessory.getService(this.platform.Service.HeaterCooler) ||
+      this.accessory.addService(this.platform.Service.HeaterCooler);
+
+    this.service.setCharacteristic(this.platform.Characteristic.Name, subDevice.nickname);
+
+    this.service.getCharacteristic(this.platform.Characteristic.Active)
+      .onGet(this.getActive.bind(this))
+      .onSet(this.setActive.bind(this));
+
+    this.service.getCharacteristic(this.platform.Characteristic.CurrentHeaterCoolerState)
+      .onGet(this.getCurrentState.bind(this));
+
+    this.service.getCharacteristic(this.platform.Characteristic.TargetHeaterCoolerState)
+      // 버그 수정: validValues를 HEAT로만 설정하여 다른 모드(냉방, 자동)를 UI에서 제거
+      .setProps({
+        validValues: [this.platform.Characteristic.TargetHeaterCoolerState.HEAT],
+      })
+      .onSet(this.setTargetState.bind(this))
+      .onGet(this.getTargetState.bind(this));
+
+    this.service.getCharacteristic(this.platform.Characteristic.CurrentTemperature)
+      .onGet(this.getCurrentTemperature.bind(this));
+
+    this.service.getCharacteristic(this.platform.Characteristic.HeatingThresholdTemperature)
+      .setProps({ minValue: 5, maxValue: 40, minStep: 1 })
+      .onGet(this.getTargetTemperature.bind(this))
+      .onSet(this.setTargetTemperature.bind(this));
+  }
+
+  // ... (이하 다른 함수들은 이전과 동일)
+
+  async getActive(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.deviceStatus === 1
+      ? this.platform.Characteristic.Active.ACTIVE
+      : this.platform.Characteristic.Active.INACTIVE;
+  }
+
+  async getCurrentState(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.deviceStatus === 1
+      ? this.platform.Characteristic.CurrentHeaterCoolerState.HEATING
+      : this.platform.Characteristic.CurrentHeaterCoolerState.INACTIVE;
+  }
+
+  async getTargetState(): Promise<CharacteristicValue> {
+    return this.platform.Characteristic.TargetHeaterCoolerState.HEAT;
+  }
+
+  async getCurrentTemperature(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.currentTemp;
+  }
+
+  async getTargetTemperature(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.setTemp;
+  }
+
+  async setActive(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+    const state = value === this.platform.Characteristic.Active.ACTIVE ? 'ON' : 'OFF';
+    await this.platform.shomeClient.setDevice(device.thngId, subDevice.deviceId.toString(), 'HEATER', 'ON_OFF', state);
+  }
+
+  async setTargetState() {
+    // 이 함수는 setProps로 인해 HEAT 값만 받게 되므로 별도 처리가 불필요합니다.
+  }
+
+  async setTargetTemperature(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+    await this.platform.shomeClient.setDevice(device.thngId, subDevice.deviceId.toString(), 'HEATER', 'TEMPERATURE', value.toString());
+  }
+}

package/src/accessories/lightAccessory.ts

@@ -0,0 +1,41 @@
+import { CharacteristicValue, PlatformAccessory, Service } from 'homebridge';
+import { ShomePlatform } from '../platform.js';
+
+export class LightAccessory {
+  private service: Service;
+
+  constructor(
+    private readonly platform: ShomePlatform,
+    private readonly accessory: PlatformAccessory,
+  ) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+
+    this.accessory.getService(this.platform.Service.AccessoryInformation)!
+      .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Samsung')
+      .setCharacteristic(this.platform.Characteristic.Model, 'Smart Light')
+      .setCharacteristic(this.platform.Characteristic.SerialNumber, `${device.thngId}-${subDevice.deviceId}`);
+
+    this.service = this.accessory.getService(this.platform.Service.Lightbulb) ||
+      this.accessory.addService(this.platform.Service.Lightbulb);
+
+    this.service.setCharacteristic(this.platform.Characteristic.Name, subDevice.nickname);
+
+    this.service.getCharacteristic(this.platform.Characteristic.On)
+      .onGet(this.getOn.bind(this))
+      .onSet(this.setOn.bind(this));
+  }
+
+  async getOn(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.deviceStatus === 1;
+  }
+
+  async setOn(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+
+    const state = value ? 'ON' : 'OFF';
+    await this.platform.shomeClient.setDevice(device.thngId, subDevice.deviceId.toString(), 'LIGHT', 'ON_OFF', state);
+  }
+}

package/src/accessories/ventilatorAccessory.ts

@@ -0,0 +1,78 @@
+import { CharacteristicValue, PlatformAccessory, Service } from 'homebridge';
+import { ShomePlatform } from '../platform.js';
+
+export class VentilatorAccessory {
+  private fanService: Service;
+
+  constructor(
+    private readonly platform: ShomePlatform,
+    private readonly accessory: PlatformAccessory,
+  ) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+
+    this.accessory.getService(this.platform.Service.AccessoryInformation)!
+      .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Samsung')
+      .setCharacteristic(this.platform.Characteristic.Model, 'Ventilator')
+      .setCharacteristic(this.platform.Characteristic.SerialNumber, `${device.thngId}-${subDevice.deviceId}`);
+
+    this.fanService = this.accessory.getService(this.platform.Service.Fanv2) ||
+      this.accessory.addService(this.platform.Service.Fanv2);
+
+    this.fanService.setCharacteristic(this.platform.Characteristic.Name, subDevice.nickname);
+
+    this.fanService.getCharacteristic(this.platform.Characteristic.Active)
+      .onGet(this.getActive.bind(this))
+      .onSet(this.setActive.bind(this));
+
+    this.fanService.getCharacteristic(this.platform.Characteristic.RotationSpeed)
+      .onGet(this.getRotationSpeed.bind(this))
+      .onSet(this.setRotationSpeed.bind(this));
+  }
+
+  async getActive(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    return subDevice.deviceStatus === 1
+      ? this.platform.Characteristic.Active.ACTIVE
+      : this.platform.Characteristic.Active.INACTIVE;
+  }
+
+  async getRotationSpeed(): Promise<CharacteristicValue> {
+    const subDevice = this.accessory.context.subDevice;
+    const apiSpeed = subDevice.windSpeedMode; // 1, 2, 3
+
+    // sHome API (1:강, 2:중, 3:약) -> HomeKit % (100:강, 66:중, 33:약)
+    if (apiSpeed === 1) {
+      return 100;
+    } else if (apiSpeed === 2) {
+      return 66;
+    } else {
+      return 33;
+    }
+  }
+
+  async setActive(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+
+    const state = value === this.platform.Characteristic.Active.ACTIVE ? 'ON' : 'OFF';
+    await this.platform.shomeClient.setDevice(device.thngId, subDevice.deviceId.toString(), 'VENTILATOR', 'ON_OFF', state);
+  }
+
+  async setRotationSpeed(value: CharacteristicValue) {
+    const device = this.accessory.context.device;
+    const subDevice = this.accessory.context.subDevice;
+    const numericValue = Number(value);
+
+    // HomeKit % -> sHome API (1:강, 2:중, 3:약)
+    let apiSpeed = 3;
+    if (numericValue > 33) {
+      apiSpeed = 2;
+    }
+    if (numericValue > 66) {
+      apiSpeed = 1;
+    }
+
+    await this.platform.shomeClient.setDevice(device.thngId, subDevice.deviceId.toString(), 'VENTILATOR', 'WINDSPEED', apiSpeed.toString());
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+import { API } from 'homebridge';
+import { PLATFORM_NAME } from './settings.js';
+import { ShomePlatform } from './platform.js';
+
+export default (api: API) => {
+  api.registerPlatform(PLATFORM_NAME, ShomePlatform);
+};