iobroker.fakeroku 1.8.0 → 1.8.2

package/README.md

@@ -6,6 +6,9 @@
 
 **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)
 
+> [!IMPORTANT]
+> This adapter cannot be installed from github
+
 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
@@ -20,6 +23,8 @@ so they accept the emulated device instead of giving up on it.
 > 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.
@@ -29,7 +34,7 @@ so they accept the emulated device instead of giving up on it.
 
 ## Sentry / Error reporting
 
-**This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.** Reporting only happens if you have enabled error reporting in the ioBroker diagnostics (**System settings → Diagnostics and error reporting**). Only an anonymous installation ID is transmitted — no name, e-mail address or IP address.
+**This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.** Reporting is active by default. It stays off when the ioBroker diagnostics setting is `none` (`diag` in the system configuration), when data reporting is disabled for this instance or its host (`disableDataReporting`), and on CI systems. A report contains the error with its stack trace and technical context such as versions and platform, plus an anonymous installation ID.
 
 For details and how to disable it, see the [Sentry plugin documentation](https://github.com/ioBroker/plugin-sentry#plugin-sentry). Error reporting requires js-controller 3.0 or newer.
 
@@ -37,13 +42,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
@@ -100,6 +103,19 @@ 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.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.
+
 ### 1.8.0 (2026-09-25)
 
 - (krobipd) Fixed: Home Assistant and openHAB can set up the emulated Roku again — it now answers the active-app, media-player and TV-channel queries they send.
@@ -127,23 +143,6 @@ becomes `true` — or watch `.command` for the last button as text.
 - (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.
-
-### 1.6.0 (2026-09-07)
-
-- (krobipd) Fixed: saving a device in the admin could change its identity on the network, so a paired Harmony or Sofabaton lost it.
-- (krobipd) Fixed: with the device list open twice, editing or deleting a card could hit a different emulated Roku than the one clicked.
-- (krobipd) Fixed: releasing a key was dropped while the adapter shed a flood of commands, so the key could stay pressed for half a minute.
-- (krobipd) Fixed: an ECP port still held after a restart left that device dead until you restarted the instance; it is retried every minute now.
-- (krobipd) Fixed: stopping the instance now takes the emulated Rokus out of the remote's list instead of leaving them there for up to an hour.
-- (krobipd) Fixed: an emulated Roku whose server died is no longer offered for discovery.
-- (krobipd) Fixed: a configured port no server can bind falls back to 8060 instead of leaving the device unstarted.
-- (krobipd) Changed: the device dialog refuses a reserved or colliding name right away instead of reporting it after saving.
-- (krobipd) Changed: the adapter can now run in compact mode, sharing one process with other adapters instead of claiming its own.
-- (krobipd) Changed: more than one instance may run on the same machine again; only the ports have to differ.
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## History

package/admin/i18n/de.json

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Noch kein Befehl",
+  "commandType_keypress": "Tastendruck",
+  "commandType_keydown": "Taste gehalten",
+  "commandType_keyup": "Taste losgelassen",
+  "commandType_launch": "App-Start",
+  "commandType_install": "App-Installation",
+  "commandType_input": "Texteingabe",
+  "commandType_search": "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "No command yet",
+  "commandType_keypress": "Key press",
+  "commandType_keydown": "Key held",
+  "commandType_keyup": "Key released",
+  "commandType_launch": "App launch",
+  "commandType_install": "App install",
+  "commandType_input": "Text input",
+  "commandType_search": "Search",
   "channelKeys": "Remote keys",
   "channelKeysDesc": "One state per remote key this device offers; a key press pulses it briefly."
 }

package/admin/i18n/es.json

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Aún sin comando",
+  "commandType_keypress": "Pulsación de tecla",
+  "commandType_keydown": "Tecla mantenida",
+  "commandType_keyup": "Tecla soltada",
+  "commandType_launch": "Inicio de app",
+  "commandType_install": "Instalación de app",
+  "commandType_input": "Entrada de texto",
+  "commandType_search": "Búsqueda",
   "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Aucune commande pour l'instant",
+  "commandType_keypress": "Appui sur une touche",
+  "commandType_keydown": "Touche maintenue",
+  "commandType_keyup": "Touche relâchée",
+  "commandType_launch": "Lancement d'appli",
+  "commandType_install": "Installation d'appli",
+  "commandType_input": "Saisie de texte",
+  "commandType_search": "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Ancora nessun comando",
+  "commandType_keypress": "Pressione tasto",
+  "commandType_keydown": "Tasto tenuto premuto",
+  "commandType_keyup": "Tasto rilasciato",
+  "commandType_launch": "Avvio app",
+  "commandType_install": "Installazione app",
+  "commandType_input": "Inserimento testo",
+  "commandType_search": "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Nog geen opdracht",
+  "commandType_keypress": "Toetsdruk",
+  "commandType_keydown": "Toets vastgehouden",
+  "commandType_keyup": "Toets losgelaten",
+  "commandType_launch": "App starten",
+  "commandType_install": "App installeren",
+  "commandType_input": "Tekstinvoer",
+  "commandType_search": "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Jeszcze brak polecenia",
+  "commandType_keypress": "Naciśnięcie klawisza",
+  "commandType_keydown": "Klawisz przytrzymany",
+  "commandType_keyup": "Klawisz zwolniony",
+  "commandType_launch": "Uruchomienie aplikacji",
+  "commandType_install": "Instalacja aplikacji",
+  "commandType_input": "Wprowadzanie tekstu",
+  "commandType_search": "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

@@ -32,6 +32,14 @@
   "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.",
+  "commandType_none": "Ainda sem comando",
+  "commandType_keypress": "Toque de tecla",
+  "commandType_keydown": "Tecla mantida",
+  "commandType_keyup": "Tecla solta",
+  "commandType_launch": "Abrir aplicação",
+  "commandType_install": "Instalar aplicação",
+  "commandType_input": "Entrada de texto",
+  "commandType_search": "Pesquisa",
   "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

@@ -32,6 +32,14 @@
   "stateLastCommandDesc": "Последняя команда, полученная этим эмулированным Roku, в виде текста.",
   "stateLastCommandType": "Тип последней команды",
   "stateLastCommandTypeDesc": "Какого рода была команда: нажатие кнопки, удержание или отпускание, запуск или установка приложения, ввод текста или поиск.",
+  "commandType_none": "Команд ещё не было",
+  "commandType_keypress": "Нажатие клавиши",
+  "commandType_keydown": "Клавиша удерживается",
+  "commandType_keyup": "Клавиша отпущена",
+  "commandType_launch": "Запуск приложения",
+  "commandType_install": "Установка приложения",
+  "commandType_input": "Ввод текста",
+  "commandType_search": "Поиск",
   "channelKeys": "Кнопки пульта",
   "channelKeysDesc": "По одному состоянию на каждую кнопку пульта этого устройства; нажатие кратко переводит его в истину."
 }

package/admin/i18n/uk.json

@@ -32,6 +32,14 @@
   "stateLastCommandDesc": "Найновіша команда, яку отримав цей емульований Roku, у вигляді тексту.",
   "stateLastCommandType": "Тип останньої команди",
   "stateLastCommandTypeDesc": "Якого роду була команда: натискання кнопки, утримання чи відпускання, запуск або встановлення застосунку, введення тексту чи пошук.",
+  "commandType_none": "Команд ще не було",
+  "commandType_keypress": "Натискання клавіші",
+  "commandType_keydown": "Клавіша утримується",
+  "commandType_keyup": "Клавішу відпущено",
+  "commandType_launch": "Запуск застосунку",
+  "commandType_install": "Встановлення застосунку",
+  "commandType_input": "Введення тексту",
+  "commandType_search": "Пошук",
   "channelKeys": "Кнопки пульта",
   "channelKeysDesc": "По одному стану на кожну кнопку, яку пропонує цей пристрій; натискання ненадовго переводить його в істину."
 }

package/admin/i18n/zh-cn.json

@@ -32,6 +32,14 @@
   "stateLastCommandDesc": "该模拟 Roku 最近收到的命令，以纯文本表示。",
   "stateLastCommandType": "最后一条命令的类型",
   "stateLastCommandTypeDesc": "命令的种类：按键、按住或松开按键、启动或安装应用、输入文本或搜索。",
+  "commandType_none": "尚无命令",
+  "commandType_keypress": "按键",
+  "commandType_keydown": "按住按键",
+  "commandType_keyup": "松开按键",
+  "commandType_launch": "启动应用",
+  "commandType_install": "安装应用",
+  "commandType_input": "文本输入",
+  "commandType_search": "搜索",
   "channelKeys": "遥控器按键",
   "channelKeysDesc": "该设备提供的每个遥控器按键各有一个状态；按下时会短暂置为真。"
 }

package/build/command-handler.js

@@ -0,0 +1,172 @@
+"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` / `commandType`, 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);
+    this.host.writeState(`${device.id}.commandType`, write.commandType);
+    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` / `commandType`, 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` / `commandType`, 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    this.host.writeState(`${device.id}.commandType`, write.commandType);\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"),