node-red-contrib-alice 2.2.5 → 2.3.1

package/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git remote -v && git config --list --local 2>/dev/null)",
+      "Bash(git config:*)",
+      "Bash(ssh -T git@github.com)",
+      "Bash(git remote:*)",
+      "Bash(git push:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,54 @@
+# CLAUDE.md
+
+Этот файл содержит руководство для Claude Code (claude.ai/code) при работе с кодом в данном репозитории.
+
+## Обзор проекта
+
+Плагин для Node-RED (`node-red-contrib-alice`), интегрирующий IoT-устройства, управляемые через Node-RED, с голосовым помощником Яндекс Алиса для управления умным домом. Опубликован в npm как `node-red-contrib-alice`.
+
+## Команды сборки и разработки
+
+```bash
+npm run build          # Компиляция TypeScript (tsc) + копирование HTML из src/ в nodes/
+npm start              # Сборка и запуск Node-RED
+npm run copy-html      # Копирование src/*.html в nodes/
+```
+
+Все исходники (`.ts` + `.html`) находятся в `src/`. Папка `nodes/` — только скомпилированный вывод (JS + скопированные HTML). При `npm run build` TypeScript компилируется в JS, а HTML копируется в `nodes/`.
+
+Общие типы и интерфейсы вынесены в `src/types.ts`.
+
+## Архитектура
+
+### Паттерн нод Node-RED
+
+Каждый тип ноды состоит из пары файлов: `.ts` (логика) и `.html` (UI конфигурации):
+
+- **Сервисная нода** (`alice.ts`): Центральный узел — управляет OAuth Яндекса, MQTT-подключением к `mqtts://mqtt.cloud.yandex.net:8883`, HTTP-эндпоинтами администрирования, валидацией подписки. Выступает как источник событий для всех нод устройств.
+- **Нода устройства** (`alice-device.ts`): Группирует умения/сенсоры, управляет регистрацией устройства на шлюзе (`api.nodered-home.ru`), дебаунсит обновления состояния (1000мс).
+- **Ноды умений** (`alice-onoff`, `alice-range`, `alice-color`, `alice-mode`, `alice-togle`, `alice-video`): Двунаправленные — принимают голосовые команды от Алисы и отправляют обновления состояния на шлюз.
+- **Нода сенсора** (`alice-sensor`): Передача свойств только для чтения (температура, влажность и т.д.).
+- **Нода событий** (`alice-event`): Обнаруживает изменения состояния и запускает потоки.
+
+### Коммуникация
+
+- **MQTT**: Команды устройствам в реальном времени через Yandex IoT Cloud
+- **HTTP REST**: Конфигурация устройств и синхронизация состояния со шлюзом `api.nodered-home.ru`
+- **OAuth 2.0**: Аутентификация через Яндекс, обмен токенами через `nodered-home.ru/api/v1/getyatoken`
+
+### Структура HTML UI
+
+Каждый `.html` файл содержит два блока скриптов:
+1. `<script>` — клиентская логика (регистрация в редакторе Node-RED, REST-вызовы)
+2. `<script type="text/x-red" data-template-name="...">` — шаблон формы
+
+### Основные зависимости
+
+- `mqtt` — MQTT-клиент для Yandex IoT Cloud
+- `axios` — HTTP-клиент для вызовов API шлюза
+
+## Заметки
+
+- Опечатка `alice-togle` (вместо `toggle`) — намеренная, это зарегистрированное имя типа ноды
+- В проекте отсутствуют тесты
+- Комментарии в коде и строки UI написаны преимущественно на русском языке

package/nodes/alice-color.js

@@ -1,235 +1,212 @@
-module.exports = function(RED) {
-
-  // ************** Color  *******************
-  function AliceColor(config){
-    RED.nodes.createNode(this,config);
-    this.device = RED.nodes.getNode(config.device);
-    this.device.setMaxListeners(this.device.getMaxListeners() + 1); // увеличиваем лимит для event
-    this.name = config.name;
-    this.ctype = 'devices.capabilities.color_setting';
-    this.instance = 'color_model';
-    this.color_support = config.color_support;
-    this.scheme = config.scheme;
-    this.temperature_k = config.temperature_k;
-    this.temperature_min = parseInt(config.temperature_min);
-    this.temperature_max = parseInt(config.temperature_max);
-    this.color_scene = config.color_scene || [];
-    this.needConvert = false;
-    this.response = config.response;
-    this.initState = false;
-    this.value;
-
-    if (this.scheme == "rgb_normal"){
-      this.scheme = "rgb";
-      this.needConvert = true;
-    };
-    if (config.response === undefined){
-        this.response = true;
-    };
-    if (config.color_support === undefined){
-      this.color_support = true
-    };
-
-    this.init = ()=>{
-      var value = 0;
-      if (this.scheme=="hsv"){
-        value = {
-          h:0,
-          s:0,
-          v:0
-        };
-      };
-      let capab = {
-        type: this.ctype,
-        retrievable: true,
-        reportable: true,
-        parameters: {
-          // instance: this.scheme,//this.instance,
-          // color_model: this.scheme
+"use strict";
+module.exports = (RED) => {
+    function AliceColor(config) {
+        RED.nodes.createNode(this, config);
+        const device = RED.nodes.getNode(config.device);
+        device.setMaxListeners(device.getMaxListeners() + 1);
+        const ctype = 'devices.capabilities.color_setting';
+        let scheme = config.scheme;
+        const temperature_k = config.temperature_k;
+        const temperature_min = parseInt(config.temperature_min);
+        const temperature_max = parseInt(config.temperature_max);
+        const color_scene = config.color_scene || [];
+        let needConvert = false;
+        let response = config.response;
+        let color_support = config.color_support;
+        let lastValue;
+        if (scheme == "rgb_normal") {
+            scheme = "rgb";
+            needConvert = true;
         }
-      };
-      if (!this.color_support && !this.temperature_k && this.color_scene.length<1){
-          this.error("Error on create capability: " + "At least one parameter must be enabled");
-          this.status({fill:"red",shape:"dot",text:"error"});
-          return;
-      };
-      if (this.color_scene.length>0){
-        let scenes = [];
-        this.color_scene.forEach(s=>{
-          scenes.push({id:s});
-        });
-        capab.parameters.color_scene = {
-          scenes:scenes
-        };
-        // capab.state.instance = 'scene';
-        // capab.state.value = this.color_scene[0];
-      };
-      if (this.color_support){
-        capab.parameters.color_model = this.scheme;
-        // capab.state.instance = this.scheme;
-        // if (this.scheme=="hsv"){
-        //   capab.state.value = {h:0,s:0,v:0};
-        // }else{
-        //   capab.state.value = 0;
-        // }
-      };
-      if (this.temperature_k){
-        capab.parameters.temperature_k = {
-          min: this.temperature_min,
-          max: this.temperature_max
+        if (config.response === undefined) {
+            response = true;
+        }
+        if (config.color_support === undefined) {
+            color_support = true;
+        }
+        const init = () => {
+            const parameters = {};
+            const capab = {
+                type: ctype,
+                retrievable: true,
+                reportable: true,
+                parameters: parameters
+            };
+            if (!color_support && !temperature_k && color_scene.length < 1) {
+                this.error("Error on create capability: At least one parameter must be enabled");
+                this.status({ fill: "red", shape: "dot", text: "error" });
+                return;
+            }
+            if (color_scene.length > 0) {
+                const scenes = color_scene.map(s => ({ id: s }));
+                parameters.color_scene = { scenes: scenes };
+            }
+            if (color_support) {
+                parameters.color_model = scheme;
+            }
+            if (temperature_k) {
+                parameters.temperature_k = {
+                    min: temperature_min,
+                    max: temperature_max
+                };
+            }
+            device.setCapability(this.id, capab)
+                .then(() => {
+                this.status({ fill: "green", shape: "dot", text: "online" });
+            })
+                .catch(err => {
+                this.error("Error on create capability: " + err.message);
+                this.status({ fill: "red", shape: "dot", text: "error" });
+            });
         };
-        // capab.state.instance = 'temperature_k';
-        // capab.state.value = this.temperature_min;
-      };
-
-      this.device.setCapability(this.id,capab)
-        .then(res=>{
-          this.initState = true;
-          // this.value = JSON.stringify(capab.state.value);
-          this.status({fill:"green",shape:"dot",text:"online"});
-        })
-        .catch(err=>{
-          this.error("Error on create capability: " + err.message);
-          this.status({fill:"red",shape:"dot",text:"error"});
+        if (device.initState)
+            init();
+        device.on("online", () => {
+            init();
         });
-    };
-
-    // Проверяем сам девайс уже инициирован 
-    if (this.device.initState) this.init();
-
-    this.device.on("online",()=>{
-      this.init();
-    });
-
-    this.device.on("offline",()=>{
-      this.status({fill:"red",shape:"dot",text:"offline"});
-    });
-
-    this.device.on(this.id,(val,newstate)=>{
-// отправляем данные на выход
-      let outmsgs=[null,null,null];
-      switch (newstate.instance) {
-        case 'rgb':
-          let value = val;
-          value = {
-            r: val >> 16,
-            g: val >> 8 & 0xFF,
-            b: val & 0xFF
-          };
-          outmsgs[0]={ payload: value };
-          break;
-        case 'hsv':
-          outmsgs[0]={ payload: val };
-          break;
-        case 'temperature_k':
-          outmsgs[1]={ payload: val };
-          break;
-        case 'scene':
-          outmsgs[2]={ payload: val };
-          break;
-      }
-      this.send(outmsgs);
-// возвращаем подтверждение в базу
-      let state= {
-        type:this.ctype,
-        state:{
-          instance:  newstate.instance,
-          value: val
-        }
-      };
-      if (this.response){
-        this.device.updateCapabState(this.id,state)
-        .then (res=>{
-          this.value = JSON.stringify(val);
-          this.status({fill:"green",shape:"dot",text:"online"});
-        })
-        .catch(err=>{
-          this.error("Error on update capability state: " + err.message);
-          this.status({fill:"red",shape:"dot",text:"Error"});
-        })
-      };
-    })
-
-    this.on('input', (msg, send, done)=>{
-      let value = msg.payload;
-      let state = {};
-      switch (typeof value) {
-        case 'object':
-          if ((value.r>-1 && value.g>-1 && value.b>-1) || (value.h>-1 && value.s>-1 && value.v>-1)){
-            if (this.scheme == 'rgb'){
-              value = value.r << 16 | value.g << 8 | value.b;
+        device.on("offline", () => {
+            this.status({ fill: "red", shape: "dot", text: "offline" });
+        });
+        device.on(this.id, (val, newstate) => {
+            const outmsgs = [null, null, null];
+            switch (newstate.instance) {
+                case 'rgb': {
+                    const value = {
+                        r: val >> 16,
+                        g: val >> 8 & 0xFF,
+                        b: val & 0xFF
+                    };
+                    outmsgs[0] = { payload: value };
+                    break;
+                }
+                case 'hsv':
+                    outmsgs[0] = { payload: val };
+                    break;
+                case 'temperature_k':
+                    outmsgs[1] = { payload: val };
+                    break;
+                case 'scene':
+                    outmsgs[2] = { payload: val };
+                    break;
+            }
+            this.send(outmsgs);
+            const state = {
+                type: ctype,
+                state: {
+                    instance: newstate.instance,
+                    value: val
+                }
+            };
+            if (response) {
+                device.updateCapabState(this.id, state)
+                    .then(() => {
+                    lastValue = JSON.stringify(val);
+                    this.status({ fill: "green", shape: "dot", text: "online" });
+                })
+                    .catch(err => {
+                    this.error("Error on update capability state: " + err.message);
+                    this.status({ fill: "red", shape: "dot", text: "Error" });
+                });
+            }
+        });
+        this.on('input', (msg, _send, done) => {
+            let value = msg.payload;
+            const state = {};
+            switch (typeof value) {
+                case 'object': {
+                    const obj = value;
+                    if (('r' in obj && 'g' in obj && 'b' in obj) || ('h' in obj && 's' in obj && 'v' in obj)) {
+                        if (scheme == 'rgb' && 'r' in obj) {
+                            value = obj.r << 16 | obj.g << 8 | obj.b;
+                        }
+                        state.value = value;
+                        state.instance = scheme;
+                    }
+                    else {
+                        this.error("Wrong type! For Color, msg.payload must be RGB or HSV Object.");
+                        if (done) {
+                            done();
+                        }
+                        return;
+                    }
+                    break;
+                }
+                case 'number': {
+                    value = Math.round(value);
+                    if (value >= temperature_min && value <= temperature_max) {
+                        state.value = value;
+                        state.instance = 'temperature_k';
+                    }
+                    else {
+                        this.error("Wrong type! For Temperature_k, msg.payload must be >=MIN and <=MAX.");
+                        if (done) {
+                            done();
+                        }
+                        return;
+                    }
+                    break;
+                }
+                case 'string':
+                    if (color_scene.includes(value)) {
+                        state.value = value;
+                        state.instance = 'scene';
+                    }
+                    else {
+                        this.error("Wrong type! For the Scene, the msg.payload must be set in the settings");
+                        if (done) {
+                            done();
+                        }
+                        return;
+                    }
+                    break;
+                default:
+                    this.error("Wrong type! Unsupported msg.payload type");
+                    if (done) {
+                        done();
+                    }
+                    return;
+            }
+            if (JSON.stringify(value) === lastValue) {
+                this.debug("Value not changed. Cancel update");
+                if (done) {
+                    done();
+                }
+                return;
+            }
+            const upState = {
+                type: ctype,
+                state: state
             };
-            state.value = value;
-            state.instance = this.scheme
-          }else{
-            this.error("Wrong type! For Color, msg.payload must be RGB or HSV Object.");
-            if (done) {done();}
-            return;
-          }
-          break;
-        case 'number':
-          value = Math.round(value);
-          if (value>=this.temperature_min && value<=this.temperature_max){
-            state.value = value;
-            state.instance = 'temperature_k';
-          }else{
-            this.error("Wrong type! For Temperature_k, msg.payload must be >=MIN and <=MAX.");
-            if (done) {done();}
-            return;
-          }
-          break;
-        case 'string':
-          if (this.color_scene.includes(value)){
-            state.value = value;
-            state.instance = 'scene';
-          }else{
-            this.error("Wrong type! For the Scene, the msg.payload must be set in the settings");
-            if (done) {done();}
-            return;
-          }
-          break;
-        default:
-          this.error("Wrong type! Unsupported msg.payload type");
-          if (done) {done();}
-          return;
-      }
-      
-      if (JSON.stringify(value) === this.value){
-        this.debug("Value not changed. Cancel update");
-        if (done) {done();}
-        return;
-      };
-      let upState= {
-        type:this.ctype,
-        state:state
-      };
-      this.device.updateCapabState(this.id,upState)
-      .then(ref=>{
-        this.value = JSON.stringify(value);
-        this.status({fill:"green",shape:"dot",text:JSON.stringify(msg.payload)});
-        if (done) {done();}
-      })
-      .catch(err=>{
-        this.error("Error on update capability state: " + err.message);
-        this.status({fill:"red",shape:"dot",text:"Error"});
-        if (done) {done();}
-      })
-    });
-
-    this.on('close', function(removed, done) {
-      if (removed) {
-        this.device.delCapability(this.id)
-        .then(res=>{
-          done()
-        })
-        .catch(err=>{
-          this.error("Error on delete capability: " + err.message);
-          done();
-        })
-      }else{
-        done();
-      }
-    });
-  }  
-  RED.nodes.registerType("Color",AliceColor);
-};
+            device.updateCapabState(this.id, upState)
+                .then(() => {
+                lastValue = JSON.stringify(value);
+                this.status({ fill: "green", shape: "dot", text: JSON.stringify(msg.payload) });
+                if (done) {
+                    done();
+                }
+            })
+                .catch(err => {
+                this.error("Error on update capability state: " + err.message);
+                this.status({ fill: "red", shape: "dot", text: "Error" });
+                if (done) {
+                    done();
+                }
+            });
+        });
+        this.on('close', (removed, done) => {
+            if (removed) {
+                device.delCapability(this.id)
+                    .then(() => { done(); })
+                    .catch(err => {
+                    this.error("Error on delete capability: " + err.message);
+                    done();
+                });
+            }
+            else {
+                done();
+            }
+        });
+    }
+    RED.nodes.registerType("Color", AliceColor);
+};
+//# sourceMappingURL=alice-color.js.map