iobroker.parcelapp 0.10.4 → 0.11.1

package/README.md

@@ -8,6 +8,8 @@
 
 ioBroker adapter for the [parcel.app](https://parcelapp.net) API. Supports all carriers that parcel.app tracks.
 
+📖 **Full user documentation:** [English](docs/en/README.md) · [Deutsch](docs/de/README.md) — setup step by step, every datapoint explained, scripting and FAQ.
+
 ---
 
 ## Features
@@ -140,6 +142,18 @@ sendTo("parcelapp.0", "addDelivery", {
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 0.11.1 (2026-09-04)
+
+- Fixed: The last-changed timestamp of a package kept its old label and had no description as long as the package did not move.
+
+### 0.11.0 (2026-09-04)
+
+- Fixed: Since version 0.10.3 the Test Connection button gave no response at all, and packages added from a script never showed up — both work again.
+- Fixed: On installations that already existed, the summary datapoints and the connection state kept their old English names — an update now reaches every datapoint.
+- New: Datapoints whose name alone does not explain them now carry a short description in the object tree, in all eleven languages.
+- New: Detailed user documentation in English and German, shown in the ioBroker documentation portal.
+- Fixed: Two settings from much older versions were still listed in the instance configuration although nothing used them any more.
+
 ### 0.10.4 (2026-09-02)
 
 - Fixed: A malformed reply from parcel.app (empty body or a broken delivery entry) no longer aborts the poll with a cryptic internal message — it is reported as an API problem and retried next poll.
@@ -155,21 +169,6 @@ sendTo("parcelapp.0", "addDelivery", {
 
 - Changed: Internal cleanup. No user-facing changes.
 
-### 0.10.1 (2026-07-13) — stable
-
-- Internal refactoring. No user-facing changes.
-
-### 0.10.0 (2026-07-08)
-
-- Fixed: the admin "Test Connection" button now reports real failures — before, it always showed "Ok" even with a wrong API key.
-- Fixed: a package's last-updated timestamp no longer jumps to the restart time after an adapter restart — it only changes when tracking data actually changed.
-- Fixed: a stalled API response can no longer freeze polling until a manual restart — every request now has a hard 60-second deadline.
-- Fixed: a failed adapter start now triggers an automatic restart instead of leaving the adapter idle until restarted by hand.
-- Changed: recurring errors such as a wrong API key are logged once instead of every poll cycle, and stopping the adapter no longer leaves a red error line in the log.
-- Changed: short ioBroker database hiccups no longer flip the connection indicator — it now reflects only the parcel.app connection.
-- Changed: the fallback package name ("Package …") is localized like all other texts, and the adapter is listed under a fitting admin category (misc-data).
-- Changed: the automatic poll after adding a delivery now respects the one-minute pacing, so bulk-adds can no longer exhaust the hourly API budget.
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## Support

package/admin/i18n/de.json

@@ -44,5 +44,15 @@
   "status_6": "Zustellversuch gescheitert",
   "status_7": "Ausnahme",
   "status_8": "Registriert",
-  "packageName": "Paket %s"
+  "packageName": "Paket %s",
+  "descInfoConnection": "Wahr, solange der Adapter die parcel.app-API erreicht.",
+  "descStatusCode": "Numerischer Status von parcel.app (0-8); -1 bedeutet, dass der Wert nicht gedeutet werden konnte.",
+  "descExtraInfo": "Zusatzangabe, die der Zusteller benötigt, etwa Postleitzahl oder E-Mail-Adresse.",
+  "descDeliveryWindow": "Erwartetes Zustellfenster; ein über mehrere Tage reichendes Fenster trägt auf beiden Seiten das Datum.",
+  "descDeliveryEstimate": "Erwartete Zustellung in Worten - heute, morgen oder in einigen Tagen.",
+  "descLastEvent": "Jüngste Sendungsmeldung des Zustellers mit Datum.",
+  "descLastUpdated": "Zeitpunkt der letzten Änderung der Sendungsdaten - nicht der letzte Abruf.",
+  "descActiveCount": "Anzahl der Pakete, die noch nicht zugestellt sind.",
+  "descTodayCount": "Anzahl der Pakete, die heute erwartet werden.",
+  "descSummaryDeliveryWindow": "Gemeinsames Fenster aller heute erwarteten Pakete - frühester Beginn bis spätestes Ende."
 }

package/admin/i18n/en.json

@@ -44,5 +44,15 @@
   "status_6": "Delivery Attempt Failed",
   "status_7": "Exception",
   "status_8": "Info Received",
-  "packageName": "Package %s"
+  "packageName": "Package %s",
+  "descInfoConnection": "True while the adapter can reach the parcel.app API.",
+  "descStatusCode": "Numeric status from parcel.app (0-8); -1 means the value could not be interpreted.",
+  "descExtraInfo": "Additional detail the carrier needs, such as a postal code or e-mail address.",
+  "descDeliveryWindow": "Expected delivery time window; a window spanning several days carries the date on both sides.",
+  "descDeliveryEstimate": "Expected delivery in words - today, tomorrow or in a number of days.",
+  "descLastEvent": "Most recent tracking event reported by the carrier, with its date.",
+  "descLastUpdated": "When the tracking data last changed - not when the adapter last polled.",
+  "descActiveCount": "Number of packages that have not been delivered yet.",
+  "descTodayCount": "Number of packages expected to arrive today.",
+  "descSummaryDeliveryWindow": "Combined window of all packages expected today - earliest start to latest end."
 }

package/admin/i18n/es.json

@@ -44,5 +44,15 @@
   "status_6": "Intento de entrega fallido",
   "status_7": "Excepción",
   "status_8": "Registrado",
-  "packageName": "Paquete %s"
+  "packageName": "Paquete %s",
+  "descInfoConnection": "Verdadero mientras el adaptador pueda acceder a la API de parcel.app.",
+  "descStatusCode": "Estado numérico de parcel.app (0-8); -1 significa que el valor no se pudo interpretar.",
+  "descExtraInfo": "Dato adicional que necesita el transportista, por ejemplo un código postal o una dirección de correo.",
+  "descDeliveryWindow": "Ventana de entrega prevista; una ventana de varios días lleva la fecha a ambos lados.",
+  "descDeliveryEstimate": "Entrega prevista en palabras - hoy, mañana o dentro de unos días.",
+  "descLastEvent": "Evento de seguimiento más reciente comunicado por el transportista, con su fecha.",
+  "descLastUpdated": "Momento del último cambio de los datos de seguimiento - no de la última consulta.",
+  "descActiveCount": "Número de paquetes que aún no se han entregado.",
+  "descTodayCount": "Número de paquetes que se esperan hoy.",
+  "descSummaryDeliveryWindow": "Ventana combinada de todos los paquetes esperados hoy - del inicio más temprano al final más tardío."
 }

package/admin/i18n/fr.json

@@ -44,5 +44,15 @@
   "status_6": "Échec de la livraison",
   "status_7": "Exception",
   "status_8": "Enregistré",
-  "packageName": "Colis %s"
+  "packageName": "Colis %s",
+  "descInfoConnection": "Vrai tant que l'adaptateur parvient à joindre l'API parcel.app.",
+  "descStatusCode": "Statut numérique de parcel.app (0-8) ; -1 signifie que la valeur n'a pas pu être interprétée.",
+  "descExtraInfo": "Information complémentaire exigée par le transporteur, par exemple un code postal ou une adresse e-mail.",
+  "descDeliveryWindow": "Créneau de livraison prévu ; un créneau sur plusieurs jours porte la date de chaque côté.",
+  "descDeliveryEstimate": "Livraison prévue en toutes lettres - aujourd'hui, demain ou dans quelques jours.",
+  "descLastEvent": "Dernier événement de suivi communiqué par le transporteur, avec sa date.",
+  "descLastUpdated": "Moment du dernier changement des données de suivi - pas de la dernière interrogation.",
+  "descActiveCount": "Nombre de colis qui ne sont pas encore livrés.",
+  "descTodayCount": "Nombre de colis attendus aujourd'hui.",
+  "descSummaryDeliveryWindow": "Créneau combiné de tous les colis attendus aujourd'hui - du début le plus tôt à la fin la plus tardive."
 }

package/admin/i18n/it.json

@@ -44,5 +44,15 @@
   "status_6": "Consegna fallita",
   "status_7": "Eccezione",
   "status_8": "Registrato",
-  "packageName": "Pacco %s"
+  "packageName": "Pacco %s",
+  "descInfoConnection": "Vero finché l'adattatore riesce a raggiungere l'API di parcel.app.",
+  "descStatusCode": "Stato numerico di parcel.app (0-8); -1 significa che il valore non è stato interpretabile.",
+  "descExtraInfo": "Dato aggiuntivo richiesto dal corriere, ad esempio un codice postale o un indirizzo e-mail.",
+  "descDeliveryWindow": "Finestra di consegna prevista; una finestra su più giorni riporta la data su entrambi i lati.",
+  "descDeliveryEstimate": "Consegna prevista a parole - oggi, domani o fra alcuni giorni.",
+  "descLastEvent": "Evento di tracciamento più recente comunicato dal corriere, con la data.",
+  "descLastUpdated": "Momento dell'ultima variazione dei dati di tracciamento - non dell'ultima interrogazione.",
+  "descActiveCount": "Numero di pacchi non ancora consegnati.",
+  "descTodayCount": "Numero di pacchi attesi oggi.",
+  "descSummaryDeliveryWindow": "Finestra combinata di tutti i pacchi attesi oggi - dall'inizio più precoce alla fine più tarda."
 }

package/admin/i18n/nl.json

@@ -44,5 +44,15 @@
   "status_6": "Bezorgpoging mislukt",
   "status_7": "Uitzondering",
   "status_8": "Geregistreerd",
-  "packageName": "Pakket %s"
+  "packageName": "Pakket %s",
+  "descInfoConnection": "Waar zolang de adapter de parcel.app-API kan bereiken.",
+  "descStatusCode": "Numerieke status van parcel.app (0-8); -1 betekent dat de waarde niet kon worden geduid.",
+  "descExtraInfo": "Aanvullend gegeven dat de vervoerder nodig heeft, zoals postcode of e-mailadres.",
+  "descDeliveryWindow": "Verwacht bezorgvenster; een venster over meerdere dagen toont aan beide kanten de datum.",
+  "descDeliveryEstimate": "Verwachte bezorging in woorden - vandaag, morgen of over een aantal dagen.",
+  "descLastEvent": "Meest recente zendingsmelding van de vervoerder, met datum.",
+  "descLastUpdated": "Moment waarop de zendinggegevens voor het laatst zijn gewijzigd - niet de laatste opvraging.",
+  "descActiveCount": "Aantal pakketten dat nog niet is bezorgd.",
+  "descTodayCount": "Aantal pakketten dat vandaag wordt verwacht.",
+  "descSummaryDeliveryWindow": "Gecombineerd venster van alle vandaag verwachte pakketten - vroegste start tot laatste einde."
 }

package/admin/i18n/pl.json

@@ -44,5 +44,15 @@
   "status_6": "Nieudana próba doręczenia",
   "status_7": "Wyjątek",
   "status_8": "Zarejestrowane",
-  "packageName": "Paczka %s"
+  "packageName": "Paczka %s",
+  "descInfoConnection": "Prawda, dopóki adapter może połączyć się z API parcel.app.",
+  "descStatusCode": "Status liczbowy z parcel.app (0-8); -1 oznacza, że wartości nie dało się zinterpretować.",
+  "descExtraInfo": "Dodatkowa informacja wymagana przez przewoźnika, np. kod pocztowy lub adres e-mail.",
+  "descDeliveryWindow": "Przewidywane okno dostawy; okno obejmujące kilka dni zawiera datę po obu stronach.",
+  "descDeliveryEstimate": "Przewidywana dostawa słownie - dziś, jutro lub za kilka dni.",
+  "descLastEvent": "Najnowsze zdarzenie śledzenia zgłoszone przez przewoźnika, wraz z datą.",
+  "descLastUpdated": "Moment ostatniej zmiany danych śledzenia - nie ostatniego odpytania.",
+  "descActiveCount": "Liczba przesyłek, które nie zostały jeszcze doręczone.",
+  "descTodayCount": "Liczba przesyłek oczekiwanych dzisiaj.",
+  "descSummaryDeliveryWindow": "Wspólne okno wszystkich przesyłek oczekiwanych dzisiaj - od najwcześniejszego początku do najpóźniejszego końca."
 }

package/admin/i18n/pt.json

@@ -44,5 +44,15 @@
   "status_6": "Tentativa de entrega falhou",
   "status_7": "Exceção",
   "status_8": "Registado",
-  "packageName": "Encomenda %s"
+  "packageName": "Encomenda %s",
+  "descInfoConnection": "Verdadeiro enquanto o adaptador conseguir alcançar a API do parcel.app.",
+  "descStatusCode": "Estado numérico do parcel.app (0-8); -1 significa que o valor não pôde ser interpretado.",
+  "descExtraInfo": "Detalhe adicional exigido pela transportadora, como código postal ou endereço de e-mail.",
+  "descDeliveryWindow": "Janela de entrega prevista; uma janela que abrange vários dias mostra a data de ambos os lados.",
+  "descDeliveryEstimate": "Entrega prevista por extenso - hoje, amanhã ou dentro de alguns dias.",
+  "descLastEvent": "Evento de rastreio mais recente comunicado pela transportadora, com a data.",
+  "descLastUpdated": "Momento da última alteração dos dados de rastreio - não da última consulta.",
+  "descActiveCount": "Número de encomendas que ainda não foram entregues.",
+  "descTodayCount": "Número de encomendas previstas para hoje.",
+  "descSummaryDeliveryWindow": "Janela combinada de todas as encomendas previstas para hoje - do início mais cedo ao fim mais tarde."
 }

package/admin/i18n/ru.json

@@ -44,5 +44,15 @@
   "status_6": "Неудачная доставка",
   "status_7": "Исключение",
   "status_8": "Зарегистрировано",
-  "packageName": "Посылка %s"
+  "packageName": "Посылка %s",
+  "descInfoConnection": "Истина, пока адаптер может связаться с API parcel.app.",
+  "descStatusCode": "Числовой статус от parcel.app (0-8); -1 означает, что значение не удалось распознать.",
+  "descExtraInfo": "Дополнительные данные, нужные перевозчику, например почтовый индекс или адрес электронной почты.",
+  "descDeliveryWindow": "Ожидаемое временное окно доставки; окно, охватывающее несколько дней, содержит дату с обеих сторон.",
+  "descDeliveryEstimate": "Ожидаемая доставка словами - сегодня, завтра или через несколько дней.",
+  "descLastEvent": "Последнее событие отслеживания от перевозчика с датой.",
+  "descLastUpdated": "Момент последнего изменения данных отслеживания - не время последнего опроса.",
+  "descActiveCount": "Количество посылок, которые ещё не доставлены.",
+  "descTodayCount": "Количество посылок, ожидаемых сегодня.",
+  "descSummaryDeliveryWindow": "Общее окно всех ожидаемых сегодня посылок - от самого раннего начала до самого позднего конца."
 }

package/admin/i18n/uk.json

@@ -44,5 +44,15 @@
   "status_6": "Невдала спроба доставки",
   "status_7": "Виняток",
   "status_8": "Зареєстровано",
-  "packageName": "Посилка %s"
+  "packageName": "Посилка %s",
+  "descInfoConnection": "Істина, доки адаптер може дістатися до API parcel.app.",
+  "descStatusCode": "Числовий статус від parcel.app (0-8); -1 означає, що значення не вдалося розпізнати.",
+  "descExtraInfo": "Додаткові дані, потрібні перевізникові, наприклад поштовий індекс або адреса електронної пошти.",
+  "descDeliveryWindow": "Очікуване вікно доставки; вікно, що охоплює кілька днів, містить дату з обох боків.",
+  "descDeliveryEstimate": "Очікувана доставка словами - сьогодні, завтра або за кілька днів.",
+  "descLastEvent": "Найновіша подія відстеження від перевізника, разом із датою.",
+  "descLastUpdated": "Момент останньої зміни даних відстеження - не останнього опитування.",
+  "descActiveCount": "Кількість посилок, які ще не доставлено.",
+  "descTodayCount": "Кількість посилок, що очікуються сьогодні.",
+  "descSummaryDeliveryWindow": "Спільне вікно всіх очікуваних сьогодні посилок - від найранішого початку до найпізнішого кінця."
 }

package/admin/i18n/zh-cn.json

@@ -44,5 +44,15 @@
   "status_6": "派送失败",
   "status_7": "异常",
   "status_8": "已登记",
-  "packageName": "包裹 %s"
+  "packageName": "包裹 %s",
+  "descInfoConnection": "适配器能够连接 parcel.app API 时为真。",
+  "descStatusCode": "来自 parcel.app 的数字状态（0-8）；-1 表示该值无法识别。",
+  "descExtraInfo": "承运商所需的附加信息，例如邮政编码或电子邮件地址。",
+  "descDeliveryWindow": "预计派送时间段；跨越多天的时间段会在两侧显示日期。",
+  "descDeliveryEstimate": "以文字表示的预计派送时间——今天、明天或若干天后。",
+  "descLastEvent": "承运商报告的最新跟踪事件及其日期。",
+  "descLastUpdated": "跟踪数据最后一次发生变化的时间——不是最后一次轮询的时间。",
+  "descActiveCount": "尚未派送的包裹数量。",
+  "descTodayCount": "预计今天送达的包裹数量。",
+  "descSummaryDeliveryWindow": "今天预计送达的所有包裹的合并时间段——最早开始到最晚结束。"
 }

package/build/lib/state-manager.js

@@ -31,7 +31,7 @@ const DELETE_BATCH_SIZE = 25;
 class StateManager {
   adapter;
   /**
-   * Cache of state IDs that have already passed `setObjectNotExistsAsync`.
+   * Cache of state IDs whose object has already been written this process.
    * Skips repeat DB lookups on the hot path — each poll touches ~11 states
    * per delivery, and most deliveries see no schema change between polls.
    * On `cleanupDeliveries`, IDs of removed packages are dropped so a re-add
@@ -236,19 +236,40 @@ class StateManager {
     const lastEvent = this.formatLastEvent(delivery);
     const lastLocation = this.extractLastLocation(delivery);
     const stateDefs = [
-      [`${devicePath}.carrier`, (0, import_i18n.tName)("carrier"), "string", "text", carrierName],
-      [`${devicePath}.status`, (0, import_i18n.tName)("status"), "string", "text", statusText],
-      [`${devicePath}.statusCode`, (0, import_i18n.tName)("statusCode"), "number", "value", statusCode],
-      [`${devicePath}.description`, (0, import_i18n.tName)("description"), "string", "text", description],
-      [`${devicePath}.trackingNumber`, (0, import_i18n.tName)("trackingNumber"), "string", "text", trackingNumber],
-      [`${devicePath}.extraInfo`, (0, import_i18n.tName)("extraInfo"), "string", "text", extraInfo],
-      [`${devicePath}.deliveryWindow`, (0, import_i18n.tName)("deliveryWindow"), "string", "text", deliveryWindow],
-      [`${devicePath}.deliveryEstimate`, (0, import_i18n.tName)("deliveryEstimate"), "string", "text", deliveryEstimate],
-      [`${devicePath}.lastEvent`, (0, import_i18n.tName)("lastEvent"), "string", "text", lastEvent],
-      [`${devicePath}.lastLocation`, (0, import_i18n.tName)("lastLocation"), "string", "text", lastLocation]
+      [`${devicePath}.carrier`, (0, import_i18n.tName)("carrier"), "string", "text", carrierName, void 0],
+      [`${devicePath}.status`, (0, import_i18n.tName)("status"), "string", "text", statusText, void 0],
+      [`${devicePath}.statusCode`, (0, import_i18n.tName)("statusCode"), "number", "value", statusCode, (0, import_i18n.tName)("descStatusCode")],
+      [`${devicePath}.description`, (0, import_i18n.tName)("description"), "string", "text", description, void 0],
+      [`${devicePath}.trackingNumber`, (0, import_i18n.tName)("trackingNumber"), "string", "text", trackingNumber, void 0],
+      [`${devicePath}.extraInfo`, (0, import_i18n.tName)("extraInfo"), "string", "text", extraInfo, (0, import_i18n.tName)("descExtraInfo")],
+      [
+        `${devicePath}.deliveryWindow`,
+        (0, import_i18n.tName)("deliveryWindow"),
+        "string",
+        "text",
+        deliveryWindow,
+        (0, import_i18n.tName)("descDeliveryWindow")
+      ],
+      [
+        `${devicePath}.deliveryEstimate`,
+        (0, import_i18n.tName)("deliveryEstimate"),
+        "string",
+        "text",
+        deliveryEstimate,
+        (0, import_i18n.tName)("descDeliveryEstimate")
+      ],
+      [`${devicePath}.lastEvent`, (0, import_i18n.tName)("lastEvent"), "string", "text", lastEvent, (0, import_i18n.tName)("descLastEvent")],
+      [`${devicePath}.lastLocation`, (0, import_i18n.tName)("lastLocation"), "string", "text", lastLocation, void 0]
     ];
     const changed = await Promise.all(
-      stateDefs.map(([id, name, type, role, val]) => this.createAndSet(id, name, type, role, val))
+      stateDefs.map(([id, name, type, role, val, desc]) => this.createAndSet(id, name, type, role, val, desc))
+    );
+    await this.ensureStateObject(
+      `${devicePath}.lastUpdated`,
+      (0, import_i18n.tName)("lastUpdated"),
+      "string",
+      "date",
+      (0, import_i18n.tName)("descLastUpdated")
     );
     if (changed.some(Boolean)) {
       await this.createAndSet(
@@ -272,14 +293,29 @@ class StateManager {
       `updateSummary: ${activeDeliveries.length} active, ${todayDeliveries.length} expected today`
     );
     await Promise.all([
-      this.createAndSet("summary.activeCount", (0, import_i18n.tName)("activeCount"), "number", "value", activeDeliveries.length),
-      this.createAndSet("summary.todayCount", (0, import_i18n.tName)("todayCount"), "number", "value", todayDeliveries.length),
+      this.createAndSet(
+        "summary.activeCount",
+        (0, import_i18n.tName)("activeCount"),
+        "number",
+        "value",
+        activeDeliveries.length,
+        (0, import_i18n.tName)("descActiveCount")
+      ),
+      this.createAndSet(
+        "summary.todayCount",
+        (0, import_i18n.tName)("todayCount"),
+        "number",
+        "value",
+        todayDeliveries.length,
+        (0, import_i18n.tName)("descTodayCount")
+      ),
       this.createAndSet(
         "summary.deliveryWindow",
         (0, import_i18n.tName)("summaryDeliveryWindow"),
         "string",
         "text",
-        this.calculateCombinedWindow(todayDeliveries)
+        this.calculateCombinedWindow(todayDeliveries),
+        (0, import_i18n.tName)("descSummaryDeliveryWindow")
       )
     ]);
   }
@@ -579,28 +615,64 @@ class StateManager {
     return StateManager.formatWindow(minStart, maxEnd);
   }
   /**
-   * Create/extend a read-only state and set its value. Skips the
-   * `setObjectNotExistsAsync` round-trip once the ID is in the cache —
-   * states are static after first creation; only the value changes per poll.
+   * Create/refresh a read-only state and set its value. Runs the object write
+   * once per ID per process (the cache skips the repeat round-trip on the hot
+   * path); only the value changes per poll.
+   *
+   * v0.11.0: `extendObject` instead of `setObjectNotExistsAsync`. The old call
+   * only ever touched an object that did not exist yet, so a changed name,
+   * description, role or type reached FRESH installs only — an existing tree
+   * kept the text it was created with, while manifest, linter, type check and
+   * the name gate all stayed green. Measured on a live install: the three
+   * permanent `summary.*` states still carried their plain-English pre-i18n
+   * names, while the per-package states looked correct only because packages
+   * are deleted and recreated. `extendObject` merges, so a user-set `custom`
+   * (history/logging) survives — the name deliberately does NOT: the adapter
+   * owns the names of its own states.
    *
    * @param id State ID relative to adapter namespace
    * @param name Display name (translation object or plain string)
    * @param type Value type
    * @param role ioBroker role
    * @param val Value to set
+   * @param desc Short explanation, or undefined where there is nothing to explain
    * @returns true when the broker actually wrote the value (it differed or the
    *   state was new) — the DB-backed "did anything change" signal driving
    *   `lastUpdated` (v0.10.0, M5)
    */
-  async createAndSet(id, name, type, role, val) {
-    if (!this.createdIds.has(id)) {
-      await this.adapter.setObjectNotExistsAsync(id, {
-        type: "state",
-        common: { name, type, role, read: true, write: false },
-        native: {}
-      });
-      this.createdIds.add(id);
+  /**
+   * Write a state's OBJECT once per process — name, description, type and role.
+   *
+   * Split out of {@link createAndSet} in v0.11.1 because `lastUpdated` writes its VALUE only
+   * when the tracking data actually changed. With the object write welded to the value write,
+   * its object was refreshed only on that same condition — so on a quiet installation, where no
+   * package moves for days, the datapoint kept the `common` it was created with forever. Measured
+   * on a live install right after the v0.11.0 upgrade: all four `lastUpdated` states still
+   * carried no description while their 24 siblings already had one. Same class as
+   * `reference_abgeleiteter_wert_nur_bei_aenderung` — a write path behind a condition looks alive
+   * because the condition is usually true, and an outdated name in the tree is what gives it away.
+   *
+   * The object write is unconditional now; only the VALUE keeps its condition.
+   *
+   * @param id State ID relative to adapter namespace
+   * @param name Display name (translation object or plain string)
+   * @param type Value type
+   * @param role ioBroker role
+   * @param desc Short explanation, or undefined where there is nothing to explain
+   */
+  async ensureStateObject(id, name, type, role, desc) {
+    if (this.createdIds.has(id)) {
+      return;
     }
+    const common = { name, type, role, read: true, write: false };
+    if (desc !== void 0) {
+      common.desc = desc;
+    }
+    await this.adapter.extendObject(id, { type: "state", common, native: {} });
+    this.createdIds.add(id);
+  }
+  async createAndSet(id, name, type, role, val, desc) {
+    await this.ensureStateObject(id, name, type, role, desc);
     const result = await this.adapter.setStateChangedAsync(id, { val, ack: true });
     return typeof result === "object" && result !== null && result.notChanged === false;
   }