iobroker.fakeroku 1.8.1 → 1.9.0

package/README.md

@@ -6,20 +6,23 @@
 
 **Support:** [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-ff5e5b?logo=ko-fi)](https://ko-fi.com/krobipd) [![PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/krobipd)
 
-Emulates one or more **[Roku](https://www.roku.com/) devices** on your LAN so that ECP/SSDP remotes and
-controllers — a Logitech Harmony Hub, a Sofabaton X1/X2, Home Assistant's Roku integration,
-openHAB — can trigger events in ioBroker. It is the **input** counterpart to the Logitech
+> [!IMPORTANT]
+> This adapter cannot be installed from github
+
+Emulates one or more **[Roku](https://www.roku.com/) devices** on your LAN so that a Logitech Harmony Hub or
+a Sofabaton X1/X2 can trigger events in ioBroker. It is the **input** counterpart to the Logitech
 Harmony adapter: a button on the remote becomes a datapoint in ioBroker.
 
-Besides the key presses it answers the queries these controllers make before and while
-they use a Roku — device info, app list, active app, media player, TV channels, app icons —
-so they accept the emulated device instead of giving up on it.
+Besides the key presses it answers what these remotes read when they pair — device info,
+app list, app icons.
 
 > **The official Roku mobile app is not supported.** It drives Rokus over Roku's
 > proprietary, undocumented ECP-2 WebSocket channel, which this emulator does not
 > implement. Use a Harmony hub or a Sofabaton — those speak the classic ECP this
 > adapter serves.
 
+[🇺🇸 Documentation](./docs/en/README.md) · [🇩🇪 Dokumentation](./docs/de/README.md)
+
 ## Features
 
 - Emulates one or more Roku devices on the LAN — the Roku control protocol (ECP) over HTTP plus SSDP discovery on port 1900.
@@ -37,13 +40,11 @@ For details and how to disable it, see the [Sentry plugin documentation](https:/
 
 - Node.js >= 22
 - js-controller >= 7.2.2
-- admin >= 8.0.11
-
-> The adapter CANNOT be installed via GitHub: The adapter must be installed via the ioBroker repository (stable or latest).
+- admin >= 8.0.14
 
 ## Ports
 
-- **TCP 8060 (listening, one per emulated Roku, configurable)** — the Roku control protocol (ECP): the remote sends its key presses here. A Harmony or Sofabaton reads the port from the discovery announcement; Home Assistant and Homey always use 8060.
+- **TCP 8060 (listening, one per emulated Roku, configurable)** — the Roku control protocol (ECP): the remote sends its key presses here.
 - **UDP 1900 (multicast, listening and outgoing)** — SSDP discovery, so a Harmony hub or Sofabaton finds the emulated Rokus; fixed by the UPnP standard.
 
 ## Configuration
@@ -73,19 +74,18 @@ At instance level:
 
 | Datapoint | Type | Meaning |
 |---|---|---|
-| `info.connection` | boolean, read-only | `true` only while **every** configured Roku is actually listening. If one of them cannot start — usually because its port is already taken — the log names the device and the port, and the adapter retries that device every minute until it comes up. |
+| `info.connection` | boolean, read-only | `true` only while everything runs: **every** configured Roku listens, discovery answers, and the chosen address exists. Anything less shows the instance yellow; the log names the cause once, and the adapter retries a Roku or discovery that is down every minute. |
 
 For every emulated Roku (`fakeroku.0.<name>`):
 
 | Datapoint | Type | Meaning |
 |---|---|---|
 | `.command` | string, read-only | The last command as plain text (`Home`, `Lit_a`, `launch:12`, `search:news`). One datapoint for everything — no object-per-character sprawl. |
-| `.commandType` | string, read-only | `keypress` / `keydown` / `keyup` / `launch` / `install` / `input` / `search`. |
 | `.keys.<Key>` | boolean, read-only | One state per remote key the device type exposes — a *Player* has the 16 navigation/playback keys, a *TV* adds Volume\*, PowerOn/PowerOff/Power, Sleep, Channel\*, Tuner/HDMI/AV inputs — all created up front. A keypress pulses it `true` for a moment; keydown/keyup hold it. Key names are read in any case (`home` is `Home`). |
 
 Free keyboard input (`Lit_x`) and app launches show up in `.command` only — they do
 not get their own objects. An app button of a remote that sends app launches (a
-Sofabaton, Home Assistant) arrives as `launch:<id>`; a Harmony Hub did not send its app
+Sofabaton) arrives as `launch:<id>`; a Harmony Hub did not send its app
 buttons to the emulated Roku.
 
 > Note: the Roku remote sends the **same** `Play` command for play and pause, so
@@ -100,6 +100,25 @@ becomes `true` — or watch `.command` for the last button as text.
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 1.9.0 (2026-10-03)
+
+- (krobipd) Changed: the emulated Roku answers only what a Harmony or Sofabaton reads — Home Assistant and openHAB can no longer set it up.
+- (krobipd) Changed: the instance shows green only while every Roku and discovery run, and yellow otherwise.
+- (krobipd) Changed: a Roku whose server stopped while running and a discovery that failed start again within a minute instead of waiting for a restart.
+- (krobipd) Changed: with no Roku configured or none running, the instance stays up so the device manager works, and asks you to add a Roku.
+- (krobipd) Changed: a chosen address that is missing on the host no longer leaves the Rokus off — they listen on all addresses until you choose another.
+- (krobipd) Changed: requests from the ioBroker host itself or from self-assigned addresses outside the host's networks are refused.
+- (krobipd) Changed: the datapoint with the kind of the last command is gone — the last command itself still arrives as before; existing installations drop it on the next start.
+
+### 1.8.2 (2026-10-02)
+
+- (krobipd) Changed: a new instance starts switched off — check the settings, then switch it on.
+- (krobipd) Fixed: the README and the user documentation name admin 8.0.14, the version the adapter actually requires.
+- (krobipd) Fixed: the device manager answers right after a restart instead of failing until the translations are loaded.
+- (krobipd) Improved: the type of the last command shows a readable label in the language you set instead of a protocol word.
+- (krobipd) Improved: a start writes only datapoints that changed and reads the key states in one request — no needless updates for history adapters.
+- (krobipd) Improved: the README links the detailed user documentation in English and German.
+
 ### 1.8.1 (2026-09-27)
 
 - (krobipd) Improved: the note the Admin shows before an update from 0.x is short now: the apps folder is removed, app launches arrive as launch:<id> in command.
@@ -121,20 +140,6 @@ becomes `true` — or watch `.command` for the last button as text.
 
 - (krobipd) Changed: the instance restarts once after this update to clear a setting left behind by an older version; nothing else changes for you.
 
-### 1.7.0 (2026-09-16)
-
-- (krobipd) Fixed: button datapoints keep their value and their room and function assignment when the adapter starts.
-- (krobipd) Fixed: after an emulated Roku drops out, its port is free again instead of staying blocked until ioBroker restarts.
-- (krobipd) Fixed: stopping the instance no longer leaves it reported as connected.
-- (krobipd) Fixed: a key you hold right after a short press stays pressed instead of being released early.
-- (krobipd) Fixed: the device dialog now also refuses a name that would collide with an existing device in the object tree.
-- (krobipd) Improved: after the host gets a new IP address, remotes find the emulated Rokus again without restarting the instance.
-- (krobipd) Changed: the network interface setting moved to the standard settings key (bind); the instance restarts once after this update.
-
-### 1.6.1 (2026-09-07) — stable
-
-- (krobipd) Changed: installing straight from GitHub is no longer offered — the adapter is built before publishing, so it is installed from the ioBroker repository instead.
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## History

package/admin/i18n/de.json

@@ -7,7 +7,7 @@
   "deviceName": "Name",
   "devicePort": "ECP-Port",
   "portLabel": "Port",
-  "devicePortHint": "Der ECP-Port, auf dem dieser Roku antwortet. Jeder emulierte Roku braucht seinen eigenen Port. Harmony und Sofabaton lesen den Port aus der Erkennung; Home Assistant und Homey nutzen immer 8060 — gib 8060 dem Roku, den sie steuern sollen.",
+  "devicePortHint": "Der ECP-Port, auf dem dieser Roku antwortet. Jeder emulierte Roku braucht seinen eigenen Port. Harmony und Sofabaton lesen den Port aus der Erkennung.",
   "deviceTypeLabel": "Typ",
   "deviceTypePlayer": "Player (Streaming-Box)",
   "deviceTypeTv": "TV (mit Lautstärke, Ein/Aus, Kanal, Eingang)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Nur wahr, solange jeder konfigurierte emulierte Roku tatsächlich lauscht.",
   "stateLastCommand": "Letzter Befehl",
   "stateLastCommandDesc": "Der zuletzt empfangene Befehl dieses emulierten Roku als Klartext.",
-  "stateLastCommandType": "Art des letzten Befehls",
-  "stateLastCommandTypeDesc": "Um welche Art Befehl es sich handelte: Tastendruck, Taste gehalten oder losgelassen, App-Start oder -Installation, Texteingabe oder Suche.",
   "channelKeys": "Fernbedienungstasten",
   "channelKeysDesc": "Ein Datenpunkt je Taste, die dieses Gerät anbietet; ein Tastendruck setzt ihn kurz auf wahr."
 }

package/admin/i18n/en.json

@@ -7,7 +7,7 @@
   "deviceName": "Name",
   "devicePort": "ECP port",
   "portLabel": "Port",
-  "devicePortHint": "The ECP port this Roku answers on. Each emulated Roku needs its own port. Harmony and Sofabaton read the port from the discovery; Home Assistant and Homey always use 8060 — give 8060 to the Roku they should control.",
+  "devicePortHint": "The ECP port this Roku answers on. Each emulated Roku needs its own port. Harmony and Sofabaton read the port from the discovery.",
   "deviceTypeLabel": "Type",
   "deviceTypePlayer": "Player (streaming box)",
   "deviceTypeTv": "TV (adds volume, power, channel, input)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "True only while every configured emulated Roku is actually listening.",
   "stateLastCommand": "Last command",
   "stateLastCommandDesc": "The most recent command this emulated Roku received, as plain text.",
-  "stateLastCommandType": "Last command type",
-  "stateLastCommandTypeDesc": "What kind of command it was: a key press, a key held or released, an app launch or install, a text input or a search.",
   "channelKeys": "Remote keys",
   "channelKeysDesc": "One state per remote key this device offers; a key press pulses it briefly."
 }

package/admin/i18n/es.json

@@ -7,7 +7,7 @@
   "deviceName": "Nombre",
   "devicePort": "Puerto ECP",
   "portLabel": "Puerto",
-  "devicePortHint": "El puerto ECP en el que responde este Roku. Cada Roku emulado necesita su propio puerto. Harmony y Sofabaton leen el puerto del descubrimiento; Home Assistant y Homey usan siempre el 8060: asigna el 8060 al Roku que deben controlar.",
+  "devicePortHint": "El puerto ECP en el que responde este Roku. Cada Roku emulado necesita su propio puerto. Harmony y Sofabaton leen el puerto del descubrimiento.",
   "deviceTypeLabel": "Tipo",
   "deviceTypePlayer": "Reproductor (dispositivo de streaming)",
   "deviceTypeTv": "TV (con volumen, encendido, canal, entrada)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Verdadero solo mientras cada Roku emulado configurado esté realmente a la escucha.",
   "stateLastCommand": "Último comando",
   "stateLastCommandDesc": "El comando más reciente que recibió este Roku emulado, como texto simple.",
-  "stateLastCommandType": "Tipo del último comando",
-  "stateLastCommandTypeDesc": "Qué tipo de comando fue: pulsar una tecla, mantenerla o soltarla, iniciar o instalar una aplicación, introducir texto o buscar.",
   "channelKeys": "Teclas del mando",
   "channelKeysDesc": "Un estado por cada tecla que ofrece este dispositivo; una pulsación lo pone brevemente en verdadero."
 }

package/admin/i18n/fr.json

@@ -7,7 +7,7 @@
   "deviceName": "Nom",
   "devicePort": "Port ECP",
   "portLabel": "Port",
-  "devicePortHint": "Le port ECP sur lequel ce Roku répond. Chaque Roku émulé a besoin de son propre port. Harmony et Sofabaton lisent le port dans la découverte ; Home Assistant et Homey utilisent toujours 8060 — attribuez 8060 au Roku qu'ils doivent piloter.",
+  "devicePortHint": "Le port ECP sur lequel ce Roku répond. Chaque Roku émulé a besoin de son propre port. Harmony et Sofabaton lisent le port dans la découverte.",
   "deviceTypeLabel": "Type",
   "deviceTypePlayer": "Player (box de streaming)",
   "deviceTypeTv": "TV (avec volume, marche/arrêt, chaîne, entrée)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Vrai uniquement tant que chaque Roku émulé configuré est réellement à l'écoute.",
   "stateLastCommand": "Dernière commande",
   "stateLastCommandDesc": "La commande la plus récente reçue par ce Roku émulé, en texte brut.",
-  "stateLastCommandType": "Type de la dernière commande",
-  "stateLastCommandTypeDesc": "De quel type de commande il s'agissait : appui sur une touche, touche maintenue ou relâchée, lancement ou installation d'une application, saisie de texte ou recherche.",
   "channelKeys": "Touches de la télécommande",
   "channelKeysDesc": "Un état par touche proposée par cet appareil ; un appui le met brièvement à vrai."
 }

package/admin/i18n/it.json

@@ -7,7 +7,7 @@
   "deviceName": "Nome",
   "devicePort": "Porta ECP",
   "portLabel": "Porta",
-  "devicePortHint": "La porta ECP su cui risponde questo Roku. Ogni Roku emulato ha bisogno della propria porta. Harmony e Sofabaton leggono la porta dal rilevamento; Home Assistant e Homey usano sempre la 8060 — assegna la 8060 al Roku che devono controllare.",
+  "devicePortHint": "La porta ECP su cui risponde questo Roku. Ogni Roku emulato ha bisogno della propria porta. Harmony e Sofabaton leggono la porta dal rilevamento.",
   "deviceTypeLabel": "Tipo",
   "deviceTypePlayer": "Player (box di streaming)",
   "deviceTypeTv": "TV (con volume, accensione, canale, ingresso)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Vero solo finché ogni Roku emulato configurato è effettivamente in ascolto.",
   "stateLastCommand": "Ultimo comando",
   "stateLastCommandDesc": "Il comando più recente ricevuto da questo Roku emulato, come testo semplice.",
-  "stateLastCommandType": "Tipo dell'ultimo comando",
-  "stateLastCommandTypeDesc": "Di che tipo di comando si trattava: pressione di un tasto, tasto tenuto premuto o rilasciato, avvio o installazione di un'app, immissione di testo o ricerca.",
   "channelKeys": "Tasti del telecomando",
   "channelKeysDesc": "Uno stato per ogni tasto offerto da questo dispositivo; una pressione lo porta brevemente a vero."
 }

package/admin/i18n/nl.json

@@ -7,7 +7,7 @@
   "deviceName": "Naam",
   "devicePort": "ECP-poort",
   "portLabel": "Poort",
-  "devicePortHint": "De ECP-poort waarop deze Roku antwoordt. Elke geëmuleerde Roku heeft een eigen poort nodig. Harmony en Sofabaton lezen de poort uit de detectie; Home Assistant en Homey gebruiken altijd 8060 — geef 8060 aan de Roku die zij moeten bedienen.",
+  "devicePortHint": "De ECP-poort waarop deze Roku antwoordt. Elke geëmuleerde Roku heeft een eigen poort nodig. Harmony en Sofabaton lezen de poort uit de detectie.",
   "deviceTypeLabel": "Type",
   "deviceTypePlayer": "Player (streaming-box)",
   "deviceTypeTv": "TV (met volume, aan/uit, kanaal, ingang)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Alleen waar zolang elke geconfigureerde geëmuleerde Roku daadwerkelijk luistert.",
   "stateLastCommand": "Laatste opdracht",
   "stateLastCommandDesc": "De meest recente opdracht die deze geëmuleerde Roku ontving, als platte tekst.",
-  "stateLastCommandType": "Type laatste opdracht",
-  "stateLastCommandTypeDesc": "Wat voor soort opdracht het was: een toetsdruk, een toets ingedrukt of losgelaten, een app starten of installeren, tekstinvoer of zoeken.",
   "channelKeys": "Afstandsbedieningstoetsen",
   "channelKeysDesc": "Eén status per toets die dit apparaat biedt; een toetsdruk zet hem kort op waar."
 }

package/admin/i18n/pl.json

@@ -7,7 +7,7 @@
   "deviceName": "Nazwa",
   "devicePort": "Port ECP",
   "portLabel": "Port",
-  "devicePortHint": "Port ECP, na którym odpowiada ten Roku. Każdy emulowany Roku potrzebuje własnego portu. Harmony i Sofabaton odczytują port z wykrywania; Home Assistant i Homey zawsze używają 8060 — nadaj 8060 temu Roku, którym mają sterować.",
+  "devicePortHint": "Port ECP, na którym odpowiada ten Roku. Każdy emulowany Roku potrzebuje własnego portu. Harmony i Sofabaton odczytują port z wykrywania.",
   "deviceTypeLabel": "Typ",
   "deviceTypePlayer": "Player (przystawka)",
   "deviceTypeTv": "TV (z głośnością, zasilaniem, kanałem, wejściem)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Prawda tylko wtedy, gdy każdy skonfigurowany emulowany Roku faktycznie nasłuchuje.",
   "stateLastCommand": "Ostatnie polecenie",
   "stateLastCommandDesc": "Najnowsze polecenie odebrane przez ten emulowany Roku, jako zwykły tekst.",
-  "stateLastCommandType": "Typ ostatniego polecenia",
-  "stateLastCommandTypeDesc": "Jakiego rodzaju było to polecenie: naciśnięcie klawisza, przytrzymanie lub zwolnienie, uruchomienie lub instalacja aplikacji, wpisanie tekstu albo wyszukiwanie.",
   "channelKeys": "Klawisze pilota",
   "channelKeysDesc": "Jeden stan na każdy klawisz oferowany przez to urządzenie; naciśnięcie ustawia go na krótko na wartość true."
 }

package/admin/i18n/pt.json

@@ -7,7 +7,7 @@
   "deviceName": "Nome",
   "devicePort": "Porta ECP",
   "portLabel": "Porta",
-  "devicePortHint": "A porta ECP em que este Roku responde. Cada Roku emulado precisa da sua própria porta. O Harmony e o Sofabaton leem a porta na descoberta; o Home Assistant e o Homey usam sempre a 8060 — atribua a 8060 ao Roku que devem controlar.",
+  "devicePortHint": "A porta ECP em que este Roku responde. Cada Roku emulado precisa da sua própria porta. O Harmony e o Sofabaton leem a porta na descoberta.",
   "deviceTypeLabel": "Tipo",
   "deviceTypePlayer": "Player (box de streaming)",
   "deviceTypeTv": "TV (com volume, ligar/desligar, canal, entrada)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Verdadeiro apenas enquanto todos os Roku emulados configurados estiverem realmente à escuta.",
   "stateLastCommand": "Último comando",
   "stateLastCommandDesc": "O comando mais recente recebido por este Roku emulado, em texto simples.",
-  "stateLastCommandType": "Tipo do último comando",
-  "stateLastCommandTypeDesc": "Que tipo de comando foi: pressionar uma tecla, manter ou soltar, iniciar ou instalar uma aplicação, introduzir texto ou pesquisar.",
   "channelKeys": "Teclas do comando",
   "channelKeysDesc": "Um estado por cada tecla que este dispositivo oferece; uma pressão coloca-o brevemente a verdadeiro."
 }

package/admin/i18n/ru.json

@@ -7,7 +7,7 @@
   "deviceName": "Имя",
   "devicePort": "Порт ECP",
   "portLabel": "Порт",
-  "devicePortHint": "Порт ECP, на котором отвечает этот Roku. Каждому эмулированному Roku нужен свой порт. Harmony и Sofabaton берут порт из обнаружения; Home Assistant и Homey всегда используют 8060 — назначьте 8060 тому Roku, которым они должны управлять.",
+  "devicePortHint": "Порт ECP, на котором отвечает этот Roku. Каждому эмулированному Roku нужен свой порт. Harmony и Sofabaton берут порт из обнаружения.",
   "deviceTypeLabel": "Тип",
   "deviceTypePlayer": "Проигрыватель (приставка)",
   "deviceTypeTv": "ТВ (с громкостью, питанием, каналом, входом)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Истина только пока каждый настроенный эмулированный Roku действительно слушает.",
   "stateLastCommand": "Последняя команда",
   "stateLastCommandDesc": "Последняя команда, полученная этим эмулированным Roku, в виде текста.",
-  "stateLastCommandType": "Тип последней команды",
-  "stateLastCommandTypeDesc": "Какого рода была команда: нажатие кнопки, удержание или отпускание, запуск или установка приложения, ввод текста или поиск.",
   "channelKeys": "Кнопки пульта",
   "channelKeysDesc": "По одному состоянию на каждую кнопку пульта этого устройства; нажатие кратко переводит его в истину."
 }

package/admin/i18n/uk.json

@@ -7,7 +7,7 @@
   "deviceName": "Назва",
   "devicePort": "Порт ECP",
   "portLabel": "Порт",
-  "devicePortHint": "Порт ECP, на якому відповідає цей Roku. Кожному емульованому Roku потрібен власний порт. Harmony і Sofabaton беруть порт із виявлення; Home Assistant і Homey завжди використовують 8060 — призначте 8060 тому Roku, яким вони мають керувати.",
+  "devicePortHint": "Порт ECP, на якому відповідає цей Roku. Кожному емульованому Roku потрібен власний порт. Harmony і Sofabaton беруть порт із виявлення.",
   "deviceTypeLabel": "Тип",
   "deviceTypePlayer": "Програвач (приставка)",
   "deviceTypeTv": "ТБ (з гучністю, живленням, каналом, входом)",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "Істина лише поки кожен налаштований емульований Roku справді слухає.",
   "stateLastCommand": "Остання команда",
   "stateLastCommandDesc": "Найновіша команда, яку отримав цей емульований Roku, у вигляді тексту.",
-  "stateLastCommandType": "Тип останньої команди",
-  "stateLastCommandTypeDesc": "Якого роду була команда: натискання кнопки, утримання чи відпускання, запуск або встановлення застосунку, введення тексту чи пошук.",
   "channelKeys": "Кнопки пульта",
   "channelKeysDesc": "По одному стану на кожну кнопку, яку пропонує цей пристрій; натискання ненадовго переводить його в істину."
 }

package/admin/i18n/zh-cn.json

@@ -7,7 +7,7 @@
   "deviceName": "名称",
   "devicePort": "ECP 端口",
   "portLabel": "端口",
-  "devicePortHint": "此 Roku 响应的 ECP 端口。每个模拟 Roku 都需要自己的端口。Harmony 和 Sofabaton 从发现信息中读取端口；Home Assistant 和 Homey 始终使用 8060——请把 8060 分配给它们要控制的 Roku。",
+  "devicePortHint": "此 Roku 响应的 ECP 端口。每个模拟 Roku 都需要自己的端口。Harmony 和 Sofabaton 从发现信息中读取端口。",
   "deviceTypeLabel": "类型",
   "deviceTypePlayer": "播放器（流媒体盒子）",
   "deviceTypeTv": "电视（带音量、电源、频道、输入）",
@@ -30,8 +30,6 @@
   "connectionStatusDesc": "仅当每个已配置的模拟 Roku 都在监听时才为真。",
   "stateLastCommand": "最后一条命令",
   "stateLastCommandDesc": "该模拟 Roku 最近收到的命令，以纯文本表示。",
-  "stateLastCommandType": "最后一条命令的类型",
-  "stateLastCommandTypeDesc": "命令的种类：按键、按住或松开按键、启动或安装应用、输入文本或搜索。",
   "channelKeys": "遥控器按键",
   "channelKeysDesc": "该设备提供的每个遥控器按键各有一个状态；按下时会短暂置为真。"
 }

package/build/command-handler.js

@@ -0,0 +1,171 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var command_handler_exports = {};
+__export(command_handler_exports, {
+  CommandHandler: () => CommandHandler,
+  HOLD_MAX_MS: () => HOLD_MAX_MS,
+  KEY_PULSE_MS: () => KEY_PULSE_MS,
+  MAX_COMMANDS_PER_SECOND: () => MAX_COMMANDS_PER_SECOND,
+  RATE_WARN_INTERVAL_MS: () => RATE_WARN_INTERVAL_MS
+});
+module.exports = __toCommonJS(command_handler_exports);
+var import_state_model = require("./ecp/state-model");
+var import_log_throttle = require("./lib/log-throttle");
+var import_rate_gate = require("./lib/rate-gate");
+const KEY_PULSE_MS = 50;
+const HOLD_MAX_MS = 3e4;
+const MAX_COMMANDS_PER_SECOND = 25;
+const RATE_WARN_INTERVAL_MS = 6e4;
+class CommandHandler {
+  /**
+   * @param host the adapter's writer, timers and log
+   */
+  constructor(host) {
+    this.host = host;
+  }
+  host;
+  pulseTimers = /* @__PURE__ */ new Set();
+  /** Per held key id, its watchdog timer — so a keydown without a keyup cannot pin it true forever. */
+  holdTimers = /* @__PURE__ */ new Map();
+  gates = /* @__PURE__ */ new Map();
+  rateWarnings = new import_log_throttle.LogThrottle(RATE_WARN_INTERVAL_MS);
+  /**
+   * Apply a received ECP command to the device's states: record it in `command`, and pulse or hold
+   * the standard key if the device carries it. The server logs only what this accepted, so the rate gate covers the
+   * log as well as the states database.
+   *
+   * @param device the emulated Roku the command is for
+   * @param cmd the parsed ECP command
+   * @returns true if the command was applied, false if the rate gate dropped it
+   */
+  apply(device, cmd) {
+    var _a;
+    const write = (0, import_state_model.commandToStateWrite)(cmd);
+    const releaseOf = ((_a = write.holdKey) == null ? void 0 : _a.value) === false ? `${device.id}.keys.${write.holdKey.key}` : null;
+    const isRelease = releaseOf !== null && this.holdTimers.has(releaseOf);
+    if (!isRelease && !this.admit(device)) {
+      return false;
+    }
+    this.host.writeState(`${device.id}.command`, write.command);
+    if (write.pulseKey && device.keys.has(write.pulseKey)) {
+      this.pulse(`${device.id}.keys.${write.pulseKey}`);
+    } else if (write.holdKey && device.keys.has(write.holdKey.key)) {
+      this.hold(`${device.id}.keys.${write.holdKey.key}`, write.holdKey.value);
+    }
+    return true;
+  }
+  /** Disarm every timer — the adapter is going down. */
+  dispose() {
+    for (const timer of this.pulseTimers) {
+      this.host.clearTimeout(timer);
+    }
+    this.pulseTimers.clear();
+    for (const timer of this.holdTimers.values()) {
+      this.host.clearTimeout(timer);
+    }
+    this.holdTimers.clear();
+    this.gates.clear();
+  }
+  /**
+   * A keypress: true now, false {@link KEY_PULSE_MS} later. A keypress on a HELD key ends the hold, or its watchdog
+   * would later write a release for a key the pulse already released.
+   *
+   * @param id the full key state id
+   */
+  pulse(id) {
+    this.clearHoldTimer(id);
+    this.host.writeState(id, true);
+    const timer = this.host.setTimeout(() => {
+      if (timer) {
+        this.pulseTimers.delete(timer);
+      }
+      if (!this.holdTimers.has(id)) {
+        this.host.writeState(id, false);
+      }
+    }, KEY_PULSE_MS);
+    if (timer) {
+      this.pulseTimers.add(timer);
+    }
+  }
+  /**
+   * A keydown holds the key true until its keyup; a watchdog releases it after {@link HOLD_MAX_MS} when the keyup is
+   * lost. A repeated keydown re-arms it.
+   *
+   * @param id the full key state id
+   * @param down true for keydown, false for keyup
+   */
+  hold(id, down) {
+    this.host.writeState(id, down);
+    this.clearHoldTimer(id);
+    if (down) {
+      const timer = this.host.setTimeout(() => {
+        this.holdTimers.delete(id);
+        this.host.writeState(id, false);
+      }, HOLD_MAX_MS);
+      if (timer) {
+        this.holdTimers.set(id, timer);
+      }
+    }
+  }
+  /**
+   * Disarm the hold watchdog of one key, if it has one.
+   *
+   * @param id the full key state id
+   */
+  clearHoldTimer(id) {
+    const timer = this.holdTimers.get(id);
+    if (timer) {
+      this.host.clearTimeout(timer);
+      this.holdTimers.delete(id);
+    }
+  }
+  /**
+   * The rate gate: {@link MAX_COMMANDS_PER_SECOND} per device, the excess dropped and reported once per
+   * {@link RATE_WARN_INTERVAL_MS}. Every accepted command costs three writes plus one when the pulse ends.
+   *
+   * @param device the emulated Roku
+   * @returns true if the command may be applied
+   */
+  admit(device) {
+    const now = Date.now();
+    let gate = this.gates.get(device.id);
+    if (!gate) {
+      gate = new import_rate_gate.RateGate(MAX_COMMANDS_PER_SECOND, now);
+      this.gates.set(device.id, gate);
+    }
+    if (gate.allow(now)) {
+      return true;
+    }
+    if (this.rateWarnings.due(device.id, now)) {
+      this.host.warn(
+        `Emulated Roku "${device.name}" receives more than ${MAX_COMMANDS_PER_SECOND} commands per second \u2014 dropping the excess (a misbehaving controller?)`
+      );
+    }
+    return false;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CommandHandler,
+  HOLD_MAX_MS,
+  KEY_PULSE_MS,
+  MAX_COMMANDS_PER_SECOND,
+  RATE_WARN_INTERVAL_MS
+});
+//# sourceMappingURL=command-handler.js.map

package/build/command-handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/command-handler.ts"],
+  "sourcesContent": ["import type { CommandEvent } from \"./ecp/ecp-command\";\nimport { commandToStateWrite } from \"./ecp/state-model\";\nimport { LogThrottle } from \"./lib/log-throttle\";\nimport { RateGate } from \"./lib/rate-gate\";\n\n/** How long a keypress pulses its keys.<Key> state true before falling back to false. */\nexport const KEY_PULSE_MS = 50;\n/** Safety cap for a held key: a keydown with no matching keyup resets after this. */\nexport const HOLD_MAX_MS = 30_000;\n/** Commands accepted per second and emulated Roku; the excess is dropped (see lib/rate-gate.ts). */\nexport const MAX_COMMANDS_PER_SECOND = 25;\n/** How often at most the dropped-commands warning repeats per device. */\nexport const RATE_WARN_INTERVAL_MS = 60_000;\n\n/** The emulated Roku a command is for. */\nexport interface CommandTarget {\n  /** The id-safe device path segment. */\n  readonly id: string;\n  /** The configured device name, for the warning the user reads. */\n  readonly name: string;\n  /** The key names this device's type carries \u2014 only those have a state to write. */\n  readonly keys: ReadonlySet<string>;\n}\n\n/** What the handler needs from the adapter: writing, the managed timers and the log. */\nexport interface CommandHost {\n  /** Fire-and-forget state write (relative id). */\n  writeState(id: string, val: string | boolean): void;\n  /**\n   * The adapter's managed timeout \u2014 undefined while the adapter shuts down. A property, not a method signature: the\n   * repochecker reads a timer method signature as a plain timer call (S5005).\n   */\n  setTimeout: (callback: () => void, ms: number) => ioBroker.Timeout | undefined;\n  /** The adapter's managed clearTimeout. */\n  clearTimeout: (timer: ioBroker.Timeout) => void;\n  /** A warning the user should see. */\n  warn(message: string): void;\n}\n\n/**\n * Turns the ECP commands of every emulated Roku into state writes: `command`, a pulse for a keypress,\n * a hold with a watchdog for keydown/keyup \u2014 behind a rate gate per device, the write-flood protection for the states\n * database. Owns its timers and releases them in {@link dispose}.\n */\nexport class CommandHandler {\n  private readonly pulseTimers = new Set<ioBroker.Timeout>();\n  /** Per held key id, its watchdog timer \u2014 so a keydown without a keyup cannot pin it true forever. */\n  private readonly holdTimers = new Map<string, ioBroker.Timeout>();\n  private readonly gates = new Map<string, RateGate>();\n  private readonly rateWarnings = new LogThrottle(RATE_WARN_INTERVAL_MS);\n\n  /**\n   * @param host the adapter's writer, timers and log\n   */\n  public constructor(private readonly host: CommandHost) {}\n\n  /**\n   * Apply a received ECP command to the device's states: record it in `command`, and pulse or hold\n   * the standard key if the device carries it. The server logs only what this accepted, so the rate gate covers the\n   * log as well as the states database.\n   *\n   * @param device the emulated Roku the command is for\n   * @param cmd the parsed ECP command\n   * @returns true if the command was applied, false if the rate gate dropped it\n   */\n  public apply(device: CommandTarget, cmd: CommandEvent): boolean {\n    const write = commandToStateWrite(cmd);\n    // The release of a key that is actually HELD never passes the rate gate: a dropped keyup would leave the key true\n    // until the watchdog, so the flood protection would falsify the tree. Asked by the held state, not by the request,\n    // so a flood of keyups for a key nobody holds still meets the gate.\n    const releaseOf = write.holdKey?.value === false ? `${device.id}.keys.${write.holdKey.key}` : null;\n    const isRelease = releaseOf !== null && this.holdTimers.has(releaseOf);\n    if (!isRelease && !this.admit(device)) {\n      return false;\n    }\n    this.host.writeState(`${device.id}.command`, write.command);\n    // A key only this device's type lacks lands in `command` alone \u2014 there is no state to write.\n    if (write.pulseKey && device.keys.has(write.pulseKey)) {\n      this.pulse(`${device.id}.keys.${write.pulseKey}`);\n    } else if (write.holdKey && device.keys.has(write.holdKey.key)) {\n      this.hold(`${device.id}.keys.${write.holdKey.key}`, write.holdKey.value);\n    }\n    return true;\n  }\n\n  /** Disarm every timer \u2014 the adapter is going down. */\n  public dispose(): void {\n    for (const timer of this.pulseTimers) {\n      this.host.clearTimeout(timer);\n    }\n    this.pulseTimers.clear();\n    for (const timer of this.holdTimers.values()) {\n      this.host.clearTimeout(timer);\n    }\n    this.holdTimers.clear();\n    this.gates.clear();\n  }\n\n  /**\n   * A keypress: true now, false {@link KEY_PULSE_MS} later. A keypress on a HELD key ends the hold, or its watchdog\n   * would later write a release for a key the pulse already released.\n   *\n   * @param id the full key state id\n   */\n  private pulse(id: string): void {\n    this.clearHoldTimer(id);\n    this.host.writeState(id, true);\n    const timer = this.host.setTimeout(() => {\n      if (timer) {\n        this.pulseTimers.delete(timer);\n      }\n      // A keydown inside the pulse window owns the key now \u2014 its keyup writes the release.\n      if (!this.holdTimers.has(id)) {\n        this.host.writeState(id, false);\n      }\n    }, KEY_PULSE_MS);\n    if (timer) {\n      this.pulseTimers.add(timer);\n    }\n  }\n\n  /**\n   * A keydown holds the key true until its keyup; a watchdog releases it after {@link HOLD_MAX_MS} when the keyup is\n   * lost. A repeated keydown re-arms it.\n   *\n   * @param id the full key state id\n   * @param down true for keydown, false for keyup\n   */\n  private hold(id: string, down: boolean): void {\n    this.host.writeState(id, down);\n    this.clearHoldTimer(id);\n    if (down) {\n      const timer = this.host.setTimeout(() => {\n        this.holdTimers.delete(id);\n        this.host.writeState(id, false);\n      }, HOLD_MAX_MS);\n      if (timer) {\n        this.holdTimers.set(id, timer);\n      }\n    }\n  }\n\n  /**\n   * Disarm the hold watchdog of one key, if it has one.\n   *\n   * @param id the full key state id\n   */\n  private clearHoldTimer(id: string): void {\n    const timer = this.holdTimers.get(id);\n    if (timer) {\n      this.host.clearTimeout(timer);\n      this.holdTimers.delete(id);\n    }\n  }\n\n  /**\n   * The rate gate: {@link MAX_COMMANDS_PER_SECOND} per device, the excess dropped and reported once per\n   * {@link RATE_WARN_INTERVAL_MS}. Every accepted command costs three writes plus one when the pulse ends.\n   *\n   * @param device the emulated Roku\n   * @returns true if the command may be applied\n   */\n  private admit(device: CommandTarget): boolean {\n    const now = Date.now();\n    let gate = this.gates.get(device.id);\n    if (!gate) {\n      gate = new RateGate(MAX_COMMANDS_PER_SECOND, now);\n      this.gates.set(device.id, gate);\n    }\n    if (gate.allow(now)) {\n      return true;\n    }\n    if (this.rateWarnings.due(device.id, now)) {\n      this.host.warn(\n        `Emulated Roku \"${device.name}\" receives more than ${MAX_COMMANDS_PER_SECOND} commands per second \u2014 dropping the excess (a misbehaving controller?)`,\n      );\n    }\n    return false;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/device-management.js

@@ -29,7 +29,7 @@ var import_device_config = require("./lib/device-config");
 var import_device_identity = require("./lib/device-identity");
 var import_i18n = require("./lib/i18n");
 var import_pure_helpers = require("./lib/pure-helpers");
-const ID_EXPRESSION = "(data.name||'').trim().replace(/[^A-Za-z0-9\\-_]/g,'_')";
+const ID_EXPRESSION = `(data.name||'').trim().replace(/${import_pure_helpers.UNSAFE_ID_CHAR.source}/g,'_')`;
 function buildDeviceForm(usedNames, usedPorts, usedIds) {
   const nameList = JSON.stringify(usedNames.map((n) => n.trim().toLowerCase()));
   const portList = JSON.stringify([...usedPorts]);
@@ -98,7 +98,7 @@ function cleanDevice(raw) {
 }
 class FakerokuDeviceManagement extends import_dm_utils.DeviceManagement {
   get objId() {
-    return `system.adapter.${this.adapter.namespace}`;
+    return (0, import_constants.instanceObjectId)(this.adapter.namespace);
   }
   /**
    * Read the device list from the live config object, through the shared normaliser — against
@@ -185,8 +185,7 @@ class FakerokuDeviceManagement extends import_dm_utils.DeviceManagement {
    * the runtime gives when two names map to one object id.
    *
    * The name needs no fallback: a row without a usable one never becomes a DeviceRow
-   * (lib/device-config.ts drops it), so `Roku <n>` was a branch nothing could reach —
-   * the mutation run of 1.6.0 found it by having no test that could fail on its removal.
+   * (lib/device-config.ts drops it).
    *
    * @param device the stored device
    * @returns the card descriptor
@@ -226,8 +225,8 @@ class FakerokuDeviceManagement extends import_dm_utils.DeviceManagement {
     };
   }
   /**
-   * Manual add: pre-select a free port, show the form, and append the device with
-   * a stable derived uuid.
+   * Manual add: pre-select a free port, show the form, and append the device with its own
+   * random identity and a fixed object id.
    *
    * @param context the action context
    * @returns a directive to reload the manager
@@ -236,7 +235,7 @@ class FakerokuDeviceManagement extends import_dm_utils.DeviceManagement {
     const devices = await this.readDevices();
     const usedNames = devices.map((d) => d.name);
     const usedPorts = devices.map((d) => d.port);
-    const usedIds = devices.map(import_device_config.deviceObjectId);
+    const usedIds = devices.map((d) => d.objectId);
     const form = buildDeviceForm(usedNames, usedPorts, usedIds);
     const data = await context.showForm(form.schema, {
       title: (0, import_i18n.t)("dmAdd"),