node-red-contrib-alice 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +48 -0
  3. package/package.json +5 -2
package/CHANGELOG.md ADDED
@@ -0,0 +1,39 @@
1
+ # Changelog
2
+
3
+ ## v3.0.0 — WebSocket вместо MQTT (миграция с Yandex IoT Core)
4
+
5
+ ### ⚠️ Зачем обновляться
6
+
7
+ Яндекс закрывает сервис **Yandex IoT Core**, через который версии 2.x получали команды Алисы:
8
+
9
+ - **1 ноября 2026** — брокер переходит в read-only: голосовые команды и управление из приложения на версиях 2.x **перестанут работать** (состояния и датчики продолжат отправляться — они идут по HTTPS);
10
+ - **1 декабря 2026** — сервис отключается полностью.
11
+
12
+ Версия 3.0.0 от IoT Core не зависит. **Обновитесь до 1 ноября 2026.**
13
+
14
+ ### Что изменилось
15
+
16
+ - **Транспорт команд**: MQTT (`mqtt.cloud.yandex.net:8883`, пароли устройств) → WebSocket (`wss://ws.nodered-home.ru/v1/ws`, авторизация тем же OAuth-токеном Яндекса, что и остальные запросы).
17
+ - **Зависимости**: `mqtt` заменён на `ws` — пакет стал легче.
18
+ - **Сеть**: исходящее подключение на стандартный порт **443** вместо 8883 — проще за файрволами и корпоративными прокси.
19
+ - **Надёжность**: keep-alive ping/pong, автоматический реконнект с экспоненциальным backoff (1–60 с) и джиттером.
20
+ - **Мультиинстансы**: до 5 одновременных подключений Node-RED под одним аккаунтом — в MQTT-версии инстансы с одним clientId вытесняли друг друга.
21
+
22
+ ### Обновление
23
+
24
+ Прямо из интерфейса Node-RED: меню → **Управление палитрой** (Manage palette) → вкладка **Ноды** → найдите `node-red-contrib-alice` → **Обновить**, затем перезапустите Node-RED.
25
+
26
+ Альтернатива через npm:
27
+
28
+ ```
29
+ cd ~/.node-red
30
+ npm install node-red-contrib-alice@latest
31
+ ```
32
+
33
+ **Переавторизация и перенастройка не требуются**: флоу, настройки нод и существующая авторизация Яндекса продолжают работать. Ноды устройств и умений не менялись — обновляется только служебная нода подключения.
34
+
35
+ ### Совместимость
36
+
37
+ - Node.js ≥ 14, Node-RED ≥ 3.0
38
+ - Формат сообщений на входах/выходах нод не изменился
39
+ - Версии 2.x продолжат работать до 1 ноября 2026, дальше — только датчики/состояния, без голосовых команд
package/README.md CHANGED
@@ -16,6 +16,30 @@ Integration of Node-RED with Yandex Smart Home. Connect any device from Node-RED
16
16
 
17
17
  ---
18
18
 
19
+ ## ⚠️ Обновитесь до версии 3.x до 1 ноября 2026
20
+
21
+ Яндекс закрывает сервис **Yandex IoT Core**, через который версии 2.x получали команды Алисы (MQTT):
22
+
23
+ - **1 ноября 2026** — брокер переходит в режим read-only: голосовые команды («Алиса, включи свет») и управление из приложения **перестанут работать** на версиях 2.x. Отправка состояний и датчиков продолжит работать (она идёт по HTTPS).
24
+ - **1 декабря 2026** — сервис отключается полностью.
25
+
26
+ Начиная с **версии 3.0.0** плагин не зависит от IoT Core: команды доставляются по WebSocket (`wss://ws.nodered-home.ru`, исходящее подключение на стандартный порт 443 вместо 8883 — проще за файрволами и прокси).
27
+
28
+ **Как обновиться** — прямо из интерфейса Node-RED: меню → **Управление палитрой** (Manage palette) → вкладка **Ноды** → найдите `node-red-contrib-alice` → кнопка **Обновить**, затем перезапустите Node-RED.
29
+
30
+ Альтернатива через npm:
31
+
32
+ ```
33
+ cd ~/.node-red
34
+ npm install node-red-contrib-alice@latest
35
+ ```
36
+
37
+ Флоу, настройки и авторизация сохраняются — переавторизация и перенастройка устройств **не требуются**.
38
+
39
+ Бонус: теперь можно подключать несколько инстансов Node-RED под одним аккаунтом (до 5 одновременных подключений) — в MQTT-версии они конфликтовали.
40
+
41
+ ---
42
+
19
43
  ## Быстрый старт
20
44
 
21
45
  1. Установите Node-RED ([инструкция](https://nodered.org/docs/getting-started/))
@@ -57,6 +81,30 @@ Integration of Node-RED with Yandex Smart Home. Connect any device from Node-RED
57
81
 
58
82
  ---
59
83
 
84
+ ## ⚠️ Update to version 3.x before November 1, 2026
85
+
86
+ Yandex is shutting down **Yandex IoT Core**, the MQTT service that versions 2.x rely on for receiving Alice commands:
87
+
88
+ - **November 1, 2026** — the broker becomes read-only: voice commands and app control **will stop working** on 2.x. Sending states and sensor data will keep working (it goes over HTTPS).
89
+ - **December 1, 2026** — the service shuts down completely.
90
+
91
+ Starting with **version 3.0.0** the plugin no longer depends on IoT Core: commands are delivered over WebSocket (`wss://ws.nodered-home.ru`, outgoing connection on standard port 443 instead of 8883 — friendlier to firewalls and proxies).
92
+
93
+ **How to update** — right from the Node-RED editor: menu → **Manage palette** → **Nodes** tab → find `node-red-contrib-alice` → click **Update**, then restart Node-RED.
94
+
95
+ Alternatively via npm:
96
+
97
+ ```
98
+ cd ~/.node-red
99
+ npm install node-red-contrib-alice@latest
100
+ ```
101
+
102
+ Flows, settings and authorization are preserved — **no re-authentication or device reconfiguration required**.
103
+
104
+ Bonus: you can now connect several Node-RED instances under one account (up to 5 simultaneous connections) — MQTT versions conflicted with each other.
105
+
106
+ ---
107
+
60
108
  ## Quick Start
61
109
 
62
110
  1. Install Node-RED ([guide](https://nodered.org/docs/getting-started/))
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "node-red-contrib-alice",
3
- "version": "3.0.0",
3
+ "version": "3.0.1",
4
4
  "description": "",
5
5
  "scripts": {
6
6
  "start": "npm run build && node-red",
@@ -54,7 +54,10 @@
54
54
  "typescript": "^5.3.3"
55
55
  },
56
56
  "nodemonConfig": {
57
- "ignoreRoot": [".git", "test"],
57
+ "ignoreRoot": [
58
+ ".git",
59
+ "test"
60
+ ],
58
61
  "restartable": "rs",
59
62
  "ignore": [
60
63
  "node_modules/**/node_modules",